AudioTalk.git · README.md

revision 33a8c0144753772545462029f7685c5f71764b8c · complete file
# AudioTalk (SwiftPM Project)

This repository provides the **source of truth** for the AudioTalk project.

- `VISION.md` — Comprehensive vision statement and design philosophy.
- `spec/openapi.yaml` — OpenAPI 3.1 definition of the AudioTalk API (source of truth).
- `.gitignore` — Standard SwiftPM ignore file.

## How to use

1. Clone this repo.
2. Explore the `spec/openapi.yaml` to integrate AudioTalk into your services.
3. Use SwiftNIO or your preferred Swift server framework to implement the API.

## Philosophy

We do **not** ship a stub server here.  
AudioTalk defines contracts and vision first. Implementations may vary, but the **API contract** is canonical.

## Status & Next Steps

- See `AGENTS.md` for the updated, project‑wide engineering guide based on the Drift–Pattern–Reflection architecture.
- Legacy narrative docs have moved to: https://github.com/Fountain-Coach/AudioTalk-LegacyDocs

## Submodules
This repo nests several focused projects as Git submodules:

- `ScoreKit` — notation model, renderer, Lily interop and playback stubs
- `Engraving` — rule engine specs, coverage, and tests for engraving
- `Teatro` — preview/demo apps and rendering API bridges
- `SDLKit` — MIDI 2.0 + SDL/GPU audio backends

Initialize/update all submodules:

```
git submodule update --init --recursive
```

If you already have the directories checked out, the pointers in `.gitmodules` align them to the corresponding upstream repos.