@mcoda/db 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## Unreleased
+- Initial public packaging for @mcoda/db.
+
+## 0.1.4
+- Initial release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 bekir dag
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @mcoda/db
+
+SQLite-backed storage layer for mcoda.
+
+## Usage
+This package is primarily an internal dependency of `mcoda`.
+
+## License
+MIT - see `LICENSE`.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./sqlite/connection.js";
+export * from "./migrations/global/GlobalMigrations.js";
+export * from "./migrations/workspace/WorkspaceMigrations.js";
+export * from "./repositories/global/GlobalRepository.js";
+export * from "./repositories/workspace/WorkspaceRepository.js";
+export type { Database } from "sqlite";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iDAAiD,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./sqlite/connection.js";
+export * from "./migrations/global/GlobalMigrations.js";
+export * from "./migrations/workspace/WorkspaceMigrations.js";
+export * from "./repositories/global/GlobalRepository.js";
+export * from "./repositories/workspace/WorkspaceRepository.js";

package/dist/migrations/global/GlobalMigrations.d.ts

@@ -0,0 +1,9 @@
+import { Database } from "sqlite";
+/**
+ * Global database migrations for ~/.mcoda/mcoda.db.
+ * Only includes tables required for the agent registry and routing defaults.
+ */
+export declare class GlobalMigrations {
+    static run(db: Database): Promise<void>;
+}
+//# sourceMappingURL=GlobalMigrations.d.ts.map

package/dist/migrations/global/GlobalMigrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalMigrations.d.ts","sourceRoot":"","sources":["../../../src/migrations/global/GlobalMigrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC;;;GAGG;AACH,qBAAa,gBAAgB;WACd,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAwU9C"}

package/dist/migrations/global/GlobalMigrations.js

@@ -0,0 +1,319 @@
+/**
+ * Global database migrations for ~/.mcoda/mcoda.db.
+ * Only includes tables required for the agent registry and routing defaults.
+ */
+export class GlobalMigrations {
+    static async run(db) {
+        const createSchema = async () => {
+            await db.exec(`
+      CREATE TABLE IF NOT EXISTS agents (
+        id TEXT PRIMARY KEY,
+        slug TEXT UNIQUE NOT NULL,
+        adapter TEXT NOT NULL,
+        default_model TEXT,
+        rating INTEGER,
+        reasoning_rating INTEGER,
+        best_usage TEXT,
+        cost_per_million REAL,
+        config_json TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_auth (
+        agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,
+        encrypted_secret TEXT NOT NULL,
+        last_verified_at TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_capabilities (
+        agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+        capability TEXT NOT NULL,
+        PRIMARY KEY (agent_id, capability)
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_prompts (
+        agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,
+        job_prompt TEXT,
+        character_prompt TEXT,
+        command_prompts_json TEXT,
+        job_path TEXT,
+        character_path TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_health (
+        agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,
+        status TEXT NOT NULL,
+        last_checked_at TEXT NOT NULL,
+        latency_ms INTEGER,
+        details_json TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS agent_models (
+        agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+        model_name TEXT NOT NULL,
+        is_default INTEGER DEFAULT 0,
+        config_json TEXT,
+        PRIMARY KEY (agent_id, model_name)
+      );
+
+      CREATE TABLE IF NOT EXISTS workspace_defaults (
+        workspace_id TEXT NOT NULL,
+        command_name TEXT NOT NULL,
+        agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+        qa_profile TEXT,
+        docdex_scope TEXT,
+        updated_at TEXT NOT NULL,
+        PRIMARY KEY (workspace_id, command_name)
+      );
+
+      CREATE TABLE IF NOT EXISTS command_runs (
+        id TEXT PRIMARY KEY,
+        command_name TEXT NOT NULL,
+        started_at TEXT NOT NULL,
+        completed_at TEXT,
+        status TEXT NOT NULL,
+        exit_code INTEGER,
+        error_summary TEXT,
+        payload_json TEXT,
+        result_json TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS token_usage (
+        id TEXT PRIMARY KEY,
+        agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,
+        command_run_id TEXT REFERENCES command_runs(id) ON DELETE SET NULL,
+        model_name TEXT,
+        tokens_prompt INTEGER,
+        tokens_completion INTEGER,
+        tokens_total INTEGER,
+        cost_estimate REAL,
+        duration_seconds REAL,
+        timestamp TEXT NOT NULL,
+        metadata_json TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_token_usage_command_run_id ON token_usage(command_run_id);
+    `);
+        };
+        await createSchema();
+        let agentsInfo = await db.all("PRAGMA table_info(agents)");
+        const hasAgentId = agentsInfo.some((col) => col.name === "id");
+        const hasAgentSlug = agentsInfo.some((col) => col.name === "slug");
+        // If the agents table is from a legacy schema (name/provider/model), reset the global DB schema.
+        if (!hasAgentId || !hasAgentSlug) {
+            await db.exec(`
+        DROP TABLE IF EXISTS agent_auth;
+        DROP TABLE IF EXISTS agent_capabilities;
+        DROP TABLE IF EXISTS agent_prompts;
+        DROP TABLE IF EXISTS agent_health;
+        DROP TABLE IF EXISTS agent_models;
+        DROP TABLE IF EXISTS workspace_defaults;
+        DROP TABLE IF EXISTS command_runs;
+        DROP TABLE IF EXISTS token_usage;
+        DROP TABLE IF EXISTS routing_rules;
+        DROP TABLE IF EXISTS agent_secrets;
+        DROP TABLE IF EXISTS releases;
+        DROP TABLE IF EXISTS schema_migrations;
+        DROP TABLE IF EXISTS agents;
+      `);
+            await createSchema();
+        }
+        agentsInfo = await db.all("PRAGMA table_info(agents)");
+        const hasAgentRating = agentsInfo.some((col) => col.name === "rating");
+        const hasAgentReasoningRating = agentsInfo.some((col) => col.name === "reasoning_rating");
+        const hasAgentBestUsage = agentsInfo.some((col) => col.name === "best_usage");
+        const hasAgentCost = agentsInfo.some((col) => col.name === "cost_per_million");
+        if (!hasAgentRating) {
+            await db.exec("ALTER TABLE agents ADD COLUMN rating INTEGER");
+        }
+        if (!hasAgentReasoningRating) {
+            await db.exec("ALTER TABLE agents ADD COLUMN reasoning_rating INTEGER");
+        }
+        if (!hasAgentBestUsage) {
+            await db.exec("ALTER TABLE agents ADD COLUMN best_usage TEXT");
+        }
+        if (!hasAgentCost) {
+            await db.exec("ALTER TABLE agents ADD COLUMN cost_per_million REAL");
+        }
+        await db.exec(`
+      UPDATE agents
+      SET
+        rating = COALESCE(
+          rating,
+          CASE
+            WHEN lower(slug) = 'codex-deputy' THEN 9.2
+            WHEN lower(slug) = 'gemini-junior' THEN 7.0
+            WHEN lower(slug) = 'gemini-deep-read' THEN 9.9
+            WHEN lower(slug) = 'codex-stabilizer' THEN 9.0
+            WHEN lower(slug) = 'gemini-consultant' THEN 7.5
+            WHEN lower(slug) = 'codex-test-lead' THEN 9.0
+            WHEN lower(slug) = 'gemini-scribe' THEN 7.0
+            WHEN lower(slug) = 'gemini-stable' THEN 9.8
+            WHEN lower(slug) = 'glm-hotfix' THEN 9.0
+            WHEN lower(slug) = 'gateway-router' THEN 10
+            WHEN lower(slug) = 'codex-architect' THEN 10
+            WHEN lower(slug) = 'glm-worker' THEN 9
+            WHEN lower(slug) = 'gemini-architect' THEN 9
+            WHEN lower(slug) = 'devstral-local' THEN 6
+            WHEN lower(slug) = 'gpt-oss-qa' THEN 9
+            WHEN lower(default_model) LIKE '%gpt-5.2-codex%' OR lower(slug) LIKE '%gpt-5.2-codex%' THEN 10
+            WHEN lower(default_model) LIKE '%gpt-5.1-codex-max%' OR lower(slug) LIKE '%gpt-5.1-codex-max%' THEN 9
+            WHEN lower(default_model) LIKE '%glm-4.7%' OR lower(slug) LIKE '%glm-4.7%' THEN 6
+            WHEN lower(default_model) LIKE '%devstral-small-2%' OR lower(slug) LIKE '%devstral-small-2%' THEN 4
+            WHEN lower(default_model) LIKE '%gpt-oss:20b%' OR lower(slug) LIKE '%gpt-oss:20b%' THEN 3
+            WHEN lower(slug) LIKE '%codex%' OR lower(default_model) LIKE '%codex%' THEN 5
+            WHEN lower(slug) LIKE '%gemini%' OR lower(default_model) LIKE '%gemini%' THEN 4
+            WHEN lower(slug) LIKE '%glm%' OR lower(default_model) LIKE '%glm%' THEN 3
+            WHEN lower(slug) LIKE '%devstral%' OR lower(default_model) LIKE '%devstral%' THEN 2
+            WHEN lower(slug) LIKE '%ollama%' OR lower(adapter) LIKE 'ollama%' THEN 2
+            WHEN lower(adapter) LIKE 'qa%' THEN 3
+            ELSE 3
+          END
+        ),
+        reasoning_rating = COALESCE(
+          reasoning_rating,
+          CASE
+            WHEN lower(slug) = 'codex-deputy' THEN 8.9
+            WHEN lower(slug) = 'gemini-junior' THEN 6.5
+            WHEN lower(slug) = 'gemini-deep-read' THEN 9.0
+            WHEN lower(slug) = 'codex-stabilizer' THEN 8.5
+            WHEN lower(slug) = 'gemini-consultant' THEN 7.0
+            WHEN lower(slug) = 'codex-test-lead' THEN 8.5
+            WHEN lower(slug) = 'gemini-scribe' THEN 6.5
+            WHEN lower(slug) = 'gemini-stable' THEN 8.8
+            WHEN lower(slug) = 'glm-hotfix' THEN 8.5
+            WHEN lower(slug) = 'gateway-router' THEN 10
+            WHEN lower(slug) = 'codex-architect' THEN 10
+            WHEN lower(slug) = 'glm-worker' THEN 9
+            WHEN lower(slug) = 'gemini-architect' THEN 8
+            WHEN lower(slug) = 'devstral-local' THEN 6
+            WHEN lower(slug) = 'gpt-oss-qa' THEN 8
+            WHEN lower(default_model) LIKE '%gpt-5.2-codex%' OR lower(slug) LIKE '%gpt-5.2-codex%' THEN 10
+            WHEN lower(default_model) LIKE '%gpt-5.1-codex-max%' OR lower(slug) LIKE '%gpt-5.1-codex-max%' THEN 9
+            WHEN lower(default_model) LIKE '%gemini-3-pro%' OR lower(slug) LIKE '%gemini-3-pro%' THEN 8
+            WHEN lower(default_model) LIKE '%glm-4.7%' OR lower(slug) LIKE '%glm-4.7%' THEN 6
+            WHEN lower(default_model) LIKE '%devstral-small-2%' OR lower(slug) LIKE '%devstral-small-2%' THEN 4
+            WHEN lower(default_model) LIKE '%gpt-oss:20b%' OR lower(slug) LIKE '%gpt-oss:20b%' THEN 3
+            WHEN lower(slug) LIKE '%codex%' OR lower(default_model) LIKE '%codex%' THEN 7
+            WHEN lower(slug) LIKE '%gemini%' OR lower(default_model) LIKE '%gemini%' THEN 6
+            WHEN lower(slug) LIKE '%glm%' OR lower(default_model) LIKE '%glm%' THEN 5
+            WHEN lower(slug) LIKE '%devstral%' OR lower(default_model) LIKE '%devstral%' THEN 4
+            WHEN lower(slug) LIKE '%ollama%' OR lower(adapter) LIKE 'ollama%' THEN 3
+            WHEN lower(adapter) LIKE 'qa%' THEN 5
+            ELSE 4
+          END
+        ),
+        best_usage = COALESCE(
+          best_usage,
+          CASE
+            WHEN lower(slug) = 'codex-deputy' THEN 'code_review_secondary'
+            WHEN lower(slug) = 'gemini-junior' THEN 'log_analysis'
+            WHEN lower(slug) = 'gemini-deep-read' THEN 'deep_research'
+            WHEN lower(slug) = 'codex-stabilizer' THEN 'legacy_maintenance'
+            WHEN lower(slug) = 'gemini-consultant' THEN 'alternative_solution_generation'
+            WHEN lower(slug) = 'codex-test-lead' THEN 'test_strategy'
+            WHEN lower(slug) = 'gemini-scribe' THEN 'doc_polish'
+            WHEN lower(slug) = 'gemini-stable' THEN 'production_verification'
+            WHEN lower(slug) = 'glm-hotfix' THEN 'rapid_prototyping'
+            WHEN lower(slug) = 'gateway-router' THEN 'orchestration'
+            WHEN lower(slug) = 'codex-architect' THEN 'architectural_design'
+            WHEN lower(slug) = 'glm-worker' THEN 'code_write'
+            WHEN lower(slug) = 'gemini-architect' THEN 'doc_generation'
+            WHEN lower(slug) = 'devstral-local' THEN 'coding_light'
+            WHEN lower(slug) = 'gpt-oss-qa' THEN 'qa_testing'
+            WHEN lower(slug) LIKE '%devstral%' OR lower(default_model) LIKE '%devstral%' THEN 'coding'
+            WHEN lower(slug) LIKE '%glm%' OR lower(default_model) LIKE '%glm%' THEN 'coding'
+            WHEN lower(slug) LIKE '%codex%' OR lower(default_model) LIKE '%codex%' THEN 'code_write'
+            WHEN lower(slug) LIKE '%gemini%' OR lower(default_model) LIKE '%gemini%' THEN 'ui_ux_docs'
+            WHEN lower(adapter) LIKE 'qa%' THEN 'qa'
+            WHEN lower(slug) LIKE '%ollama%' OR lower(adapter) LIKE 'ollama%' THEN 'coding'
+            ELSE 'general'
+          END
+        ),
+        cost_per_million = COALESCE(
+          cost_per_million,
+          CASE
+            WHEN lower(slug) = 'codex-deputy' THEN 10.0
+            WHEN lower(slug) = 'gemini-junior' THEN 2.5
+            WHEN lower(slug) = 'gemini-deep-read' THEN 18.0
+            WHEN lower(slug) = 'codex-stabilizer' THEN 10.0
+            WHEN lower(slug) = 'gemini-consultant' THEN 15.0
+            WHEN lower(slug) = 'codex-test-lead' THEN 10.0
+            WHEN lower(slug) = 'gemini-scribe' THEN 2.5
+            WHEN lower(slug) = 'gemini-stable' THEN 18.0
+            WHEN lower(slug) = 'glm-hotfix' THEN 2.2
+            WHEN lower(slug) = 'gemini-architect' THEN 3.0
+            WHEN lower(slug) = 'gateway-router' THEN 14.0
+            WHEN lower(slug) = 'codex-architect' THEN 14.0
+            WHEN lower(slug) = 'glm-worker' THEN 2.2
+            WHEN lower(slug) = 'devstral-local' THEN 0
+            WHEN lower(slug) = 'gpt-oss-qa' THEN 0
+            WHEN lower(adapter) LIKE 'ollama%' OR lower(adapter) = 'local-model' OR lower(adapter) = 'qa-cli' THEN 0
+            WHEN lower(default_model) LIKE '%gpt-5.2%' OR lower(slug) LIKE '%gpt-5.2%' THEN 14.0
+            WHEN lower(default_model) LIKE '%glm-4.7%' OR lower(slug) LIKE '%glm-4.7%' THEN 2.2
+            WHEN lower(default_model) LIKE '%gpt-5.1%' AND (lower(default_model) LIKE '%codex%' OR lower(slug) LIKE '%codex%') THEN 10.0
+            WHEN lower(default_model) LIKE '%gemini-3-pro%' OR lower(slug) LIKE '%gemini-3-pro%' THEN 18.0
+            WHEN lower(default_model) LIKE '%devstral%' OR lower(slug) LIKE '%devstral%' THEN 0
+            ELSE NULL
+          END
+        )
+      WHERE rating IS NULL OR reasoning_rating IS NULL OR best_usage IS NULL OR cost_per_million IS NULL;
+    `);
+        const workspaceDefaultsInfo = await db.all("PRAGMA table_info(workspace_defaults)");
+        const hasWorkspaceId = workspaceDefaultsInfo.some((col) => col.name === "workspace_id");
+        const hasWorkspace = workspaceDefaultsInfo.some((col) => col.name === "workspace");
+        const hasQaProfile = workspaceDefaultsInfo.some((col) => col.name === "qa_profile");
+        const hasDocdexScope = workspaceDefaultsInfo.some((col) => col.name === "docdex_scope");
+        // Migrate legacy workspace_defaults schema: workspace -> workspace_id, default_agent -> agent_id, add command_name.
+        if (!hasWorkspaceId) {
+            if (hasWorkspace) {
+                await db.exec("ALTER TABLE workspace_defaults RENAME TO workspace_defaults_legacy");
+                await db.exec(`
+          CREATE TABLE workspace_defaults (
+            workspace_id TEXT NOT NULL,
+            command_name TEXT NOT NULL,
+            agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+            qa_profile TEXT,
+            docdex_scope TEXT,
+            updated_at TEXT NOT NULL,
+            PRIMARY KEY (workspace_id, command_name)
+          );
+        `);
+                const legacyRows = await db.all("SELECT workspace, default_agent, qa_profile, docdex_scope, updated_at FROM workspace_defaults_legacy");
+                for (const row of legacyRows) {
+                    await db.run(`INSERT OR IGNORE INTO workspace_defaults (workspace_id, command_name, agent_id, qa_profile, docdex_scope, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?)`, row.workspace, "default", row.default_agent, row.qa_profile ?? null, row.docdex_scope ?? null, row.updated_at ?? new Date().toISOString());
+                }
+                await db.exec("DROP TABLE workspace_defaults_legacy");
+            }
+            else {
+                // If the table exists but has an unknown shape, reset to the expected schema.
+                await db.exec("DROP TABLE IF EXISTS workspace_defaults");
+                await db.exec(`
+          CREATE TABLE IF NOT EXISTS workspace_defaults (
+            workspace_id TEXT NOT NULL,
+            command_name TEXT NOT NULL,
+            agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+            qa_profile TEXT,
+            docdex_scope TEXT,
+            updated_at TEXT NOT NULL,
+            PRIMARY KEY (workspace_id, command_name)
+          );
+        `);
+            }
+        }
+        else {
+            if (!hasQaProfile) {
+                await db.exec("ALTER TABLE workspace_defaults ADD COLUMN qa_profile TEXT");
+            }
+            if (!hasDocdexScope) {
+                await db.exec("ALTER TABLE workspace_defaults ADD COLUMN docdex_scope TEXT");
+            }
+        }
+    }
+}

package/dist/migrations/workspace/WorkspaceMigrations.d.ts

@@ -0,0 +1,9 @@
+import { Database } from "sqlite";
+/**
+ * Workspace database migrations for the local `.mcoda/mcoda.db` file.
+ * The schema matches the planning/task model defined in the SDS.
+ */
+export declare class WorkspaceMigrations {
+    static run(db: Database): Promise<void>;
+}
+//# sourceMappingURL=WorkspaceMigrations.d.ts.map

package/dist/migrations/workspace/WorkspaceMigrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceMigrations.d.ts","sourceRoot":"","sources":["../../../src/migrations/workspace/WorkspaceMigrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC;;;GAGG;AACH,qBAAa,mBAAmB;WACjB,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAgP9C"}

package/dist/migrations/workspace/WorkspaceMigrations.js

@@ -0,0 +1,246 @@
+/**
+ * Workspace database migrations for the local `.mcoda/mcoda.db` file.
+ * The schema matches the planning/task model defined in the SDS.
+ */
+export class WorkspaceMigrations {
+    static async run(db) {
+        await db.exec(`
+      PRAGMA foreign_keys = ON;
+
+      -- Create tables idempotently to avoid wiping existing workspace data.
+      CREATE TABLE IF NOT EXISTS projects (
+        id TEXT PRIMARY KEY,
+        key TEXT NOT NULL UNIQUE,
+        name TEXT,
+        description TEXT,
+        metadata_json TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS epics (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        key TEXT NOT NULL,
+        title TEXT NOT NULL,
+        description TEXT,
+        story_points_total REAL,
+        priority INTEGER,
+        metadata_json TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        UNIQUE(project_id, key)
+      );
+
+      CREATE TABLE IF NOT EXISTS user_stories (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        epic_id TEXT NOT NULL REFERENCES epics(id) ON DELETE CASCADE,
+        key TEXT NOT NULL,
+        title TEXT NOT NULL,
+        description TEXT,
+        acceptance_criteria TEXT,
+        story_points_total REAL,
+        priority INTEGER,
+        metadata_json TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        UNIQUE(epic_id, key)
+      );
+
+      CREATE TABLE IF NOT EXISTS tasks (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        epic_id TEXT NOT NULL REFERENCES epics(id) ON DELETE CASCADE,
+        user_story_id TEXT NOT NULL REFERENCES user_stories(id) ON DELETE CASCADE,
+        key TEXT NOT NULL,
+        title TEXT NOT NULL,
+        description TEXT,
+        type TEXT,
+        status TEXT NOT NULL,
+        story_points REAL,
+        priority INTEGER,
+        assigned_agent_id TEXT,
+        assignee_human TEXT,
+        vcs_branch TEXT,
+        vcs_base_branch TEXT,
+        vcs_last_commit_sha TEXT,
+        metadata_json TEXT,
+        openapi_version_at_creation TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        UNIQUE(user_story_id, key)
+      );
+
+      CREATE TABLE IF NOT EXISTS task_dependencies (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        depends_on_task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        relation_type TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        UNIQUE(task_id, depends_on_task_id, relation_type)
+      );
+
+      CREATE TABLE IF NOT EXISTS jobs (
+        id TEXT PRIMARY KEY,
+        workspace_id TEXT NOT NULL,
+        type TEXT NOT NULL,
+        state TEXT NOT NULL,
+        command_name TEXT,
+        payload_json TEXT,
+        total_items INTEGER,
+        processed_items INTEGER,
+        last_checkpoint TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        completed_at TEXT,
+        error_summary TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS command_runs (
+        id TEXT PRIMARY KEY,
+        workspace_id TEXT NOT NULL,
+        command_name TEXT NOT NULL,
+        job_id TEXT REFERENCES jobs(id) ON DELETE SET NULL,
+        task_ids_json TEXT,
+        git_branch TEXT,
+        git_base_branch TEXT,
+        started_at TEXT NOT NULL,
+        completed_at TEXT,
+        status TEXT NOT NULL,
+        error_summary TEXT,
+        duration_seconds REAL,
+        sp_processed REAL
+      );
+
+      CREATE TABLE IF NOT EXISTS task_runs (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        command TEXT NOT NULL,
+        job_id TEXT REFERENCES jobs(id) ON DELETE SET NULL,
+        command_run_id TEXT REFERENCES command_runs(id) ON DELETE SET NULL,
+        agent_id TEXT,
+        status TEXT NOT NULL,
+        started_at TEXT NOT NULL,
+        finished_at TEXT,
+        story_points_at_run REAL,
+        sp_per_hour_effective REAL,
+        git_branch TEXT,
+        git_base_branch TEXT,
+        git_commit_sha TEXT,
+        run_context_json TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS task_locks (
+        task_id TEXT PRIMARY KEY REFERENCES tasks(id) ON DELETE CASCADE,
+        task_run_id TEXT NOT NULL REFERENCES task_runs(id) ON DELETE CASCADE,
+        job_id TEXT,
+        acquired_at TEXT NOT NULL,
+        expires_at TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_task_locks_expires_at ON task_locks(expires_at);
+
+      CREATE TABLE IF NOT EXISTS task_qa_runs (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        task_run_id TEXT REFERENCES task_runs(id) ON DELETE SET NULL,
+        job_id TEXT REFERENCES jobs(id) ON DELETE SET NULL,
+        command_run_id TEXT REFERENCES command_runs(id) ON DELETE SET NULL,
+        agent_id TEXT,
+        model_name TEXT,
+        source TEXT NOT NULL,
+        mode TEXT,
+        profile_name TEXT,
+        runner TEXT,
+        raw_outcome TEXT,
+        recommendation TEXT,
+        evidence_url TEXT,
+        artifacts_json TEXT,
+        raw_result_json TEXT,
+        started_at TEXT,
+        finished_at TEXT,
+        metadata_json TEXT,
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS task_logs (
+        id TEXT PRIMARY KEY,
+        task_run_id TEXT NOT NULL REFERENCES task_runs(id) ON DELETE CASCADE,
+        sequence INTEGER NOT NULL,
+        timestamp TEXT NOT NULL,
+        level TEXT,
+        source TEXT,
+        message TEXT,
+        details_json TEXT,
+        UNIQUE(task_run_id, sequence)
+      );
+
+      CREATE TABLE IF NOT EXISTS task_revisions (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        job_id TEXT,
+        command_run_id TEXT,
+        snapshot_before_json TEXT,
+        snapshot_after_json TEXT,
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS task_comments (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        task_run_id TEXT REFERENCES task_runs(id) ON DELETE SET NULL,
+        job_id TEXT REFERENCES jobs(id) ON DELETE SET NULL,
+        source_command TEXT NOT NULL,
+        author_type TEXT NOT NULL,
+        author_agent_id TEXT,
+        category TEXT,
+        file TEXT,
+        line INTEGER,
+        path_hint TEXT,
+        body TEXT NOT NULL,
+        metadata_json TEXT,
+        created_at TEXT NOT NULL,
+        resolved_at TEXT,
+        resolved_by TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS task_reviews (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+        job_id TEXT REFERENCES jobs(id) ON DELETE SET NULL,
+        agent_id TEXT,
+        model_name TEXT,
+        decision TEXT NOT NULL,
+        summary TEXT,
+        findings_json TEXT,
+        test_recommendations_json TEXT,
+        metadata_json TEXT,
+        created_at TEXT NOT NULL,
+        created_by TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS token_usage (
+        id TEXT PRIMARY KEY,
+        workspace_id TEXT NOT NULL,
+        agent_id TEXT,
+        model_name TEXT,
+        job_id TEXT REFERENCES jobs(id) ON DELETE SET NULL,
+        command_run_id TEXT REFERENCES command_runs(id) ON DELETE SET NULL,
+        task_run_id TEXT REFERENCES task_runs(id) ON DELETE SET NULL,
+        task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+        project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+        epic_id TEXT REFERENCES epics(id) ON DELETE SET NULL,
+        user_story_id TEXT REFERENCES user_stories(id) ON DELETE SET NULL,
+        tokens_prompt INTEGER,
+        tokens_completion INTEGER,
+        tokens_total INTEGER,
+        cost_estimate REAL,
+        duration_seconds REAL,
+        timestamp TEXT NOT NULL,
+        metadata_json TEXT
+      );
+    `);
+    }
+}