chore: bootstrap go module, license, readme and package skeleton

README.md

@@ -0,0 +1,49 @@
+# talk
+
+> **Status: WIP** — aktive Entwicklung (talk 2.0). Binde Spezifikation:
+> [`.scratch/talk-2-0/spec.md`](.scratch/talk-2-0/spec.md) ·
+> Implementierungsplan: [`.scratch/talk-2-0/plan.md`](.scratch/talk-2-0/plan.md)
+
+**talk** macht Skripte und KI-Agenten hörbar: Ein Aufruf — `talk "Build fertig"` —
+spricht eine kurze Nachricht über eine TTS-Provider-Kette
+(ElevenLabs → OpenAI → Edge-TTS → OS-Stimme), serialisiert durch den Daemon
+`talkd`. Cross-platform (Windows/macOS/Linux, amd64/arm64), statische Binaries,
+keine Runtime-Abhängigkeiten.
+
+## Befehle
+
+| Befehl | Zweck |
+| --- | --- |
+| `talk "Text"` | Ansage — Abkürzung für `talk say`, non-blocking |
+| `talk say "Text"` | Ansage (Text als Argument oder von stdin) |
+| `talk wrap -- <Befehl>` | Befehl ausführen, Erfolg/Misserfolg + Dauer ansagen |
+| `talk mute` / `talk unmute` | Ansagen dauerhaft stummschalten / Stummschaltung aufheben |
+| `talk status` | Daemon-Status (Queue, Mute, Provider, Version) |
+| `talk cancel` | laufende und geplante Ansagen abbrechen |
+| `talk voices` | verfügbare Stimmen anzeigen |
+| `talk test` | Test-Ansage ausgeben |
+| `talk doctor` | Selbstdiagnose des Setups |
+| `talk setup` | geführte Ersteinrichtung (Wizard) |
+
+Say-Flags (gelten auch für `talk "Text"`): `--wait`, `--now`, `--priority`,
+`--voice`, `--lang`, `--provider`.
+
+**Hinweis:** Alle Befehle sind in diesem Stand Stubs und melden
+`not implemented yet` (Exit-Code ≠ 0). Die Implementierung entsteht
+Aufgabenweise gemäß Plan; `--version` und `--help` funktionieren.
+
+## Entwicklung
+
+```console
+go build ./...   # bauen
+go test ./...    # Tests
+go vet ./...     # statische Analyse
+gofmt -l .       # Formatierung prüfen (leerer Output = ok)
+```
+
+CI: `.gitea/workflows/test.yml` (Gitea Actions) läuft vet, gofmt-Check, Tests
+und Build bei jedem Push und Pull Request.
+
+## Lizenz
+
+MIT — siehe [LICENSE](LICENSE).