docs(P01): complete minimal-voice-loop phase

---ci--- phase: 1 milestone: v0.1 status: complete requirements: covered: [REQ-VOICE-01, REQ-VOICE-02, REQ-VOICE-03, REQ-VOICE-04, REQ-SCEN-01, REQ-STATE-01, REQ-LLM-01, REQ-LLM-02, REQ-DEBRIEF-01, REQ-ORCH-01, REQ-ORCH-02, REQ-SCEN-FMT-01, REQ-NFR-LAT-01, REQ-NFR-SAFE-01, REQ-NFR-COST-01] partial: [] ---/ci---
2026-08-01 13:28:42 +00:00
parent 415c8ac8a6
commit b77536aa5e
79 changed files with 8087 additions and 1 deletions
@@ -0,0 +1,46 @@
+-- Praxis v0.1 SQLite schema — learner state (D-007).
+-- Single hardcoded learner, no auth, no multi-tenant.
+
+-- The single learner row (D-007). v0.1 has one hardcoded profile.
+CREATE TABLE IF NOT EXISTS learner (
+    id           TEXT PRIMARY KEY,
+    display_name TEXT NOT NULL,
+    created_at   TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Session log: one row per voice session.
+CREATE TABLE IF NOT EXISTS sessions (
+    id                    TEXT PRIMARY KEY,
+    learner_id            TEXT NOT NULL REFERENCES learner(id),
+    scenario_id           TEXT NOT NULL,
+    started_at            TEXT NOT NULL DEFAULT (datetime('now')),
+    ended_at              TEXT,
+    branch_path_json      TEXT,          -- JSON array of branch ids taken
+    outcome               TEXT,          -- 'success' | 'failure' | NULL
+    cost_estimated_cents  INTEGER,       -- derived per-session cost (D-012)
+    debrief_text          TEXT,          -- TASK-05-05: the generated debrief
+    cost_breakdown_json   TEXT           -- TASK-04-04: token/minute/char breakdown
+);
+
+-- Turn log: one row per ASR/TTS turn within a session.
+CREATE TABLE IF NOT EXISTS turns (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id  TEXT NOT NULL REFERENCES sessions(id),
+    seq         INTEGER NOT NULL,
+    role        TEXT NOT NULL,            -- 'user' | 'assistant'
+    asr_text    TEXT,
+    tts_text    TEXT,
+    latency_ms  REAL,
+    created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(session_id, seq)
+);
+
+-- Progress: per-learner per-scenario progression (v0.1: attempts + last outcome).
+CREATE TABLE IF NOT EXISTS progress (
+    learner_id     TEXT NOT NULL REFERENCES learner(id),
+    scenario_id    TEXT NOT NULL,
+    attempts       INTEGER NOT NULL DEFAULT 0,
+    last_outcome   TEXT,
+    updated_at     TEXT NOT NULL DEFAULT (datetime('now')),
+    PRIMARY KEY (learner_id, scenario_id)
+);