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

internal/api/doc.go

@@ -0,0 +1,4 @@
+// Package api implementiert die HTTP-Oberfläche des Daemons auf 127.0.0.1:
+// POST /speak, GET /status, POST /cancel, POST /mute, POST /unmute (Task 04),
+// CORS für /speak und den MCP-Endpoint (Streamable HTTP, Task 06).
+package api

internal/audio/doc.go

@@ -0,0 +1,5 @@
+// Package audio implementiert die Audio-Ausgabe von talk über das
+// Sink-Interface: Playback embedded via oto (PCM/WAV) und ein null-Sink,
+// das verwirft (CI, Server, Tests). Auswahl per Config audio.sink.
+// Implementierung folgt in Task 02.
+package audio

internal/config/doc.go

@@ -0,0 +1,7 @@
+// Package config implementiert die Config-Auflösung von talk: Defaults +
+// optionale config.toml im platform-nativen Verzeichnis (~/.config/talk,
+// ~/Library/Application Support/talk, %APPDATA%\talk) + Env-Overrides
+// (TALK_*); Env schlägt Datei. Enthält Voice-Mapping voice.<provider>.<lang>
+// und Provider-Endpunkte (Fake-bar für Tests). Implementierung folgt in
+// Task 02.
+package config

internal/langdetect/doc.go

@@ -0,0 +1,4 @@
+// Package langdetect erkennt die Sprache eines Ansage-Texts als reine
+// Funktion Detect(text) → "de" | "en" (Default "de"; Heuristik über
+// Common-Word-Listen und Umlaute/ß). Implementierung folgt in Task 02.
+package langdetect

internal/notify/doc.go

@@ -0,0 +1,4 @@
+// Package notify implementiert Best-effort-Desktop-Notifications parallel
+// zum Audio (beeep: notify-send / macOS Notification Center / Windows Toast),
+// mit Abbrechen-Button, wo das OS ihn hergibt. Implementierung folgt.
+package notify

internal/provider/doc.go

@@ -0,0 +1,6 @@
+// Package provider implementiert die TTS-Provider-Kette von talk:
+// ElevenLabs → OpenAI TTS → Edge-TTS → OS built-in (macOS say, Windows SAPI,
+// Linux espeak/speech-dispatcher), überschreibbar per Config/Flag, mit
+// Fallback bei Fehlern. Implementierung folgt in Task 02 (osbuiltin) und
+// Task 03 (Cloud-Provider, Kette).
+package provider

internal/queue/doc.go

@@ -0,0 +1,6 @@
+// Package queue implementiert die Ansage-Queue des Daemons: serialisierte
+// Abarbeitung (eine Ansage gleichzeitig), Prioritäten (high > normal > low,
+// FIFO je Level), now-Items springen vor, Rate-Limit mit prioritätsbewusstem
+// Verwerfen. Implementierung folgt in Task 04 (Queue) und Task 05
+// (Rate-Limit, Ruhezeiten).
+package queue