@lwelliott/cortex-cli 1.0.3

package/dist/db/schema.js

@@ -0,0 +1,830 @@
+"use strict";
+// Database schema DDL statements and migration definitions
+// All tables from plan §4.3 + §9.7 (document content model)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPECTED_INDEXES = exports.EXPECTED_TABLES = exports.LATEST_VERSION = exports.MIGRATIONS = exports.INITIAL_SCHEMA_SQL = void 0;
+/** All DDL for the initial schema (migration version 1) */
+exports.INITIAL_SCHEMA_SQL = `
+-- ─── Sprints ───
+CREATE TABLE IF NOT EXISTS sprints (
+  id          TEXT PRIMARY KEY,
+  name        TEXT NOT NULL,
+  status      TEXT NOT NULL DEFAULT 'PLANNING'
+              CHECK (status IN ('PLANNING','IN EXECUTION','CLOSING','CLOSED')),
+  goal        TEXT,
+  started_at  TEXT,
+  closed_at   TEXT,
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Tasks ───
+CREATE TABLE IF NOT EXISTS tasks (
+  id          TEXT NOT NULL,
+  sprint_id   TEXT NOT NULL REFERENCES sprints(id),
+  parent_id   TEXT,
+  description TEXT NOT NULL,
+  task_type   TEXT NOT NULL DEFAULT 'Feature'
+              CHECK (task_type IN ('Feature','Bug','Chore')),
+  priority    TEXT NOT NULL DEFAULT 'P2'
+              CHECK (priority IN ('P0','P1','P2')),
+  owner       TEXT NOT NULL,
+  points      INTEGER DEFAULT 0,
+  status      TEXT NOT NULL DEFAULT 'Backlog'
+              CHECK (status IN ('Backlog','To Do','In Progress','In Review','Done','Dropped')),
+  stage       TEXT NOT NULL DEFAULT 'Planning'
+              CHECK (stage IN ('Planning','Requirement','Specification','Design','Test Plan','Implementation','Testing','Release')),
+  session_key TEXT,
+  started_at  TEXT,
+  completed_at TEXT,
+  scope_in    TEXT,
+  scope_out   TEXT,
+  decisions   TEXT,
+  dependencies TEXT,
+  acceptance  TEXT,
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (sprint_id, id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_sprint ON tasks(sprint_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(sprint_id, status);
+CREATE INDEX IF NOT EXISTS idx_tasks_owner  ON tasks(sprint_id, owner);
+
+-- ─── Graph: Entity Types ───
+-- builtin:3.0 (Sprint 31): entity_types table DROPPED. Doc types are the sole source of truth.
+-- Do NOT recreate this table.
+
+-- ─── Graph: Entities ───
+CREATE TABLE IF NOT EXISTS entities (
+  id          TEXT PRIMARY KEY,
+  type_name   TEXT NOT NULL,
+  properties  TEXT NOT NULL DEFAULT '{}',
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type_name);
+
+-- ─── Graph: Relation Types ───
+CREATE TABLE IF NOT EXISTS relation_types (
+  name        TEXT PRIMARY KEY,
+  from_types  TEXT NOT NULL DEFAULT '[]',
+  to_types    TEXT NOT NULL DEFAULT '[]',
+  cardinality TEXT DEFAULT 'many_to_many',
+  inverse_of  TEXT REFERENCES relation_types(name),
+  description TEXT
+);
+
+-- ─── Graph: Relations ───
+CREATE TABLE IF NOT EXISTS relations (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_id     TEXT NOT NULL REFERENCES entities(id),
+  rel_type    TEXT NOT NULL REFERENCES relation_types(name),
+  to_id       TEXT NOT NULL REFERENCES entities(id),
+  properties  TEXT NOT NULL DEFAULT '{}',
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(from_id, rel_type, to_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_id, rel_type);
+CREATE INDEX IF NOT EXISTS idx_relations_to   ON relations(to_id, rel_type);
+CREATE INDEX IF NOT EXISTS idx_relations_type ON relations(rel_type);
+
+-- ─── Graph: Schema Version ───
+CREATE TABLE IF NOT EXISTS graph_schema (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- ─── Reviews ───
+CREATE TABLE IF NOT EXISTS reviews (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  review_num  TEXT NOT NULL,
+  sprint_id   TEXT NOT NULL REFERENCES sprints(id),
+  asset_name  TEXT NOT NULL,
+  review_type TEXT NOT NULL
+              CHECK (review_type IN ('requirements','architecture','code','test','document')),
+  verdict     TEXT NOT NULL
+              CHECK (verdict IN ('APPROVED','NEEDS_REWORK','OPEN_QUESTION')),
+  critical_count INTEGER NOT NULL DEFAULT 0,
+  major_count    INTEGER NOT NULL DEFAULT 0,
+  minor_count    INTEGER NOT NULL DEFAULT 0,
+  suggestion_count INTEGER NOT NULL DEFAULT 0,
+  open_questions_count INTEGER NOT NULL DEFAULT 0,
+  content     TEXT NOT NULL,
+  created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_reviews_sprint ON reviews(sprint_id);
+CREATE INDEX IF NOT EXISTS idx_reviews_verdict ON reviews(verdict);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_reviews_sprint_num ON reviews(sprint_id, review_num);
+
+-- ─── Documents (canonical artifact registry) ───
+CREATE TABLE IF NOT EXISTS documents (
+  id          TEXT PRIMARY KEY,
+  type        TEXT NOT NULL,
+  title       TEXT NOT NULL,
+  path        TEXT,
+  status      TEXT DEFAULT 'Draft',
+  module_id   TEXT,
+  sprint_id   TEXT REFERENCES sprints(id),
+  content_hash TEXT,
+  content_storage TEXT NOT NULL DEFAULT 'filesystem'
+              CHECK (content_storage IN ('filesystem', 'db')),
+  metadata    TEXT DEFAULT '{}',
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_documents_type ON documents(type);
+CREATE INDEX IF NOT EXISTS idx_documents_module ON documents(module_id);
+CREATE INDEX IF NOT EXISTS idx_documents_sprint ON documents(sprint_id);
+
+-- ─── Document Contents (DB-stored content + FTS5) ───
+CREATE TABLE IF NOT EXISTS document_contents (
+  document_id TEXT PRIMARY KEY REFERENCES documents(id),
+  content     TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS document_contents_fts USING fts5(
+  document_id,
+  content,
+  content='document_contents',
+  content_rowid='rowid'
+);
+
+-- FTS sync triggers
+CREATE TRIGGER IF NOT EXISTS document_contents_ai AFTER INSERT ON document_contents BEGIN
+  INSERT INTO document_contents_fts(rowid, document_id, content)
+    VALUES (new.rowid, new.document_id, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS document_contents_ad AFTER DELETE ON document_contents BEGIN
+  INSERT INTO document_contents_fts(document_contents_fts, rowid, document_id, content)
+    VALUES ('delete', old.rowid, old.document_id, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS document_contents_au AFTER UPDATE ON document_contents BEGIN
+  INSERT INTO document_contents_fts(document_contents_fts, rowid, document_id, content)
+    VALUES ('delete', old.rowid, old.document_id, old.content);
+  INSERT INTO document_contents_fts(rowid, document_id, content)
+    VALUES (new.rowid, new.document_id, new.content);
+END;
+
+-- ─── Test Execution Reports ───
+CREATE TABLE IF NOT EXISTS test_reports (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  sprint_id   TEXT NOT NULL REFERENCES sprints(id),
+  task_id     TEXT REFERENCES tasks(id),
+  run_number  INTEGER NOT NULL,
+  total       INTEGER NOT NULL,
+  passed      INTEGER NOT NULL,
+  failed      INTEGER NOT NULL,
+  skipped     INTEGER NOT NULL,
+  blocked     INTEGER NOT NULL DEFAULT 0,
+  result      TEXT NOT NULL CHECK (result IN ('PASS','FAIL','BLOCKED')),
+  command     TEXT,
+  duration_s  REAL,
+  report_path TEXT,
+  created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Lessons ───
+CREATE TABLE IF NOT EXISTS lessons (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  sprint_id   TEXT REFERENCES sprints(id),
+  category    TEXT NOT NULL
+              CHECK (category IN ('Process','Technical','Tool','Model')),
+  title       TEXT NOT NULL,
+  description TEXT NOT NULL,
+  severity    TEXT DEFAULT 'minor' CHECK (severity IN ('critical','major','minor','suggestion')),
+  created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Advisory Locks ───
+CREATE TABLE IF NOT EXISTS locks (
+  name           TEXT PRIMARY KEY,
+  owner          TEXT NOT NULL,
+  acquired_at    TEXT NOT NULL,
+  last_heartbeat TEXT
+);
+
+-- ─── Migrations ───
+CREATE TABLE IF NOT EXISTS _migrations (
+  version     INTEGER PRIMARY KEY,
+  applied_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  checksum    TEXT NOT NULL DEFAULT ''
+);
+`;
+/**
+ * Sequential versioned migrations.
+ * Version 1 is the initial schema applied on fresh database creation.
+ * Future migrations add entries here with incrementing version numbers.
+ */
+exports.MIGRATIONS = [
+    {
+        version: 1,
+        description: 'Initial schema: all core tables',
+        sql: exports.INITIAL_SCHEMA_SQL,
+    },
+    {
+        version: 2,
+        description: 'Add removed_at column to tasks for soft delete (AD-0011)',
+        sql: `
+      -- Conditionally add removed_at column (idempotent via error handling in runner)
+      ALTER TABLE tasks ADD COLUMN removed_at TEXT;
+    `,
+    },
+    {
+        version: 3,
+        description: 'SAD-0003: Extend graph/doc/review tables for MOD-008 through MOD-013',
+        sql: `
+      -- MOD-008: entity_types extensions (builtin:3.0: skip if table dropped)
+      -- ALTER TABLE entity_types ADD COLUMN required_fields TEXT DEFAULT '{}';
+      -- ALTER TABLE entity_types ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+      -- MOD-008: relation_types extensions
+      ALTER TABLE relation_types ADD COLUMN created_at TEXT NOT NULL DEFAULT (datetime('now'));
+      ALTER TABLE relation_types ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+      -- MOD-009: entities extension (updated_at already in v1 schema)
+      -- ALTER TABLE entities ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+      -- MOD-010: relations extension
+      ALTER TABLE relations ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+      -- MOD-012: document_contents doc_id alias support
+      -- (keeping document_id as canonical column name; services use document_id)
+
+      -- MOD-013: reviews extensions for auto-numbering + asset_ref
+      ALTER TABLE reviews ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+      ALTER TABLE reviews ADD COLUMN asset_ref TEXT;
+
+      -- MOD-013: test_reports — add SAD-0003 columns
+      ALTER TABLE test_reports ADD COLUMN module_id TEXT;
+      ALTER TABLE test_reports ADD COLUMN status TEXT DEFAULT 'PASS';
+      ALTER TABLE test_reports ADD COLUMN content TEXT DEFAULT '';
+      ALTER TABLE test_reports ADD COLUMN pass_count INTEGER DEFAULT 0;
+      ALTER TABLE test_reports ADD COLUMN fail_count INTEGER DEFAULT 0;
+      ALTER TABLE test_reports ADD COLUMN skip_count INTEGER DEFAULT 0;
+      ALTER TABLE test_reports ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+      -- MOD-013: lessons — add SAD-0003 columns
+      ALTER TABLE lessons ADD COLUMN text TEXT DEFAULT '';
+      ALTER TABLE lessons ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+      -- Deferred indexes (require columns from this migration)
+      CREATE INDEX IF NOT EXISTS idx_test_reports_module ON test_reports(module_id);
+    `,
+    },
+    {
+        version: 4,
+        description: 'Restructure graph_schema table + add missing indexes',
+        sql: `
+      -- Restructure graph_schema: drop key/value, create columnar schema
+      DROP TABLE IF EXISTS graph_schema;
+      CREATE TABLE graph_schema (
+        id              INTEGER PRIMARY KEY AUTOINCREMENT,
+        source_file     TEXT,
+        version         TEXT NOT NULL DEFAULT '1',
+        bootstrapped_at TEXT NOT NULL DEFAULT (datetime('now')),
+        checksum        TEXT
+      );
+
+      -- SAD-0003 Additional Indexes
+      CREATE INDEX IF NOT EXISTS idx_reviews_type ON reviews(review_type);
+      CREATE INDEX IF NOT EXISTS idx_test_reports_sprint ON test_reports(sprint_id);
+      CREATE INDEX IF NOT EXISTS idx_lessons_sprint ON lessons(sprint_id);
+    `,
+    },
+    {
+        version: 5,
+        description: 'URD-G001: Remove document metadata columns, rename entity/doc types, update relation type arrays',
+        sql: `
+      -- Step 1: Drop indexes on removed columns (sprint-consistency removal before column drop)
+      DROP INDEX IF EXISTS idx_documents_module;
+      DROP INDEX IF EXISTS idx_documents_sprint;
+
+      -- Step 2: Re-type documents (MODULE→MDL, SOURCEFILE→SRC)
+      UPDATE documents SET type = 'MDL' WHERE type = 'MODULE';
+      UPDATE documents SET type = 'SRC' WHERE type = 'SOURCEFILE';
+
+      -- Step 3: Rename entity types in entity_types table (builtin:3.0: skip if table dropped)
+      -- UPDATE entity_types SET name = 'MDL' WHERE name = 'Module';
+      -- UPDATE entity_types SET name = 'SRC' WHERE name = 'SourceFile';
+
+      -- Step 4: Rename entity type_name in entities table
+      UPDATE entities SET type_name = 'MDL' WHERE type_name = 'Module';
+      UPDATE entities SET type_name = 'SRC' WHERE type_name = 'SourceFile';
+
+      -- Step 5: Update relation_types from_types/to_types JSON arrays
+      -- Replace 'Module' with 'MDL' and 'SourceFile' with 'SRC' in from_types arrays
+      UPDATE relation_types
+      SET from_types = (
+        SELECT json_group_array(
+          CASE value
+            WHEN 'Module' THEN 'MDL'
+            WHEN 'SourceFile' THEN 'SRC'
+            ELSE value END
+        )
+        FROM json_each(from_types)
+      )
+      WHERE from_types LIKE '%Module%' OR from_types LIKE '%SourceFile%';
+
+      -- Replace 'Module' with 'MDL' and 'SourceFile' with 'SRC' in to_types arrays
+      UPDATE relation_types
+      SET to_types = (
+        SELECT json_group_array(
+          CASE value
+            WHEN 'Module' THEN 'MDL'
+            WHEN 'SourceFile' THEN 'SRC'
+            ELSE value END
+        )
+        FROM json_each(to_types)
+      )
+      WHERE to_types LIKE '%Module%' OR to_types LIKE '%SourceFile%';
+
+      -- Step 6: Remove status, module_id, sprint_id columns from documents table
+      -- SQLite 3.35.0+ supports ALTER TABLE DROP COLUMN
+      ALTER TABLE documents DROP COLUMN status;
+      ALTER TABLE documents DROP COLUMN module_id;
+      ALTER TABLE documents DROP COLUMN sprint_id;
+    `,
+    },
+    {
+        version: 6,
+        description: 'URD-024: Entity type name alignment — rename 12 long-form entity type names to short codes',
+        sql: `
+      -- Phase A: Rename entity type names in entity_types table (builtin:3.0: skip if table dropped)
+      -- UPDATE entity_types SET name = 'AD'  WHERE name = 'ArchitectureDecision';
+      -- UPDATE entity_types SET name = 'SAD' WHERE name = 'ArchitectureOverview';
+      -- UPDATE entity_types SET name = 'FR'  WHERE name = 'FunctionalRequirement';
+      -- UPDATE entity_types SET name = 'NFR' WHERE name = 'NonFunctionalRequirement';
+      -- UPDATE entity_types SET name = 'US'  WHERE name = 'UserStory';
+      -- UPDATE entity_types SET name = 'FS'  WHERE name = 'FunctionalSpecification';
+      -- UPDATE entity_types SET name = 'NFS' WHERE name = 'NonFunctionalSpecification';
+      -- UPDATE entity_types SET name = 'QA'  WHERE name = 'QualityScenario';
+      -- UPDATE entity_types SET name = 'TC'  WHERE name = 'TestCase';
+      -- UPDATE entity_types SET name = 'TR'  WHERE name = 'TestReport';
+      -- UPDATE entity_types SET name = 'TS'  WHERE name = 'TestSuite';
+      -- UPDATE entity_types SET name = 'URD' WHERE name = 'UserRequirement';
+
+      -- Phase B: Update entity type_name in entities table (SAD-0029 §3.1)
+      -- Idempotent: WHERE old-type filters ensure already-updated rows are unaffected
+      UPDATE entities SET type_name = 'AD'  WHERE type_name = 'ArchitectureDecision';
+      UPDATE entities SET type_name = 'SAD' WHERE type_name = 'ArchitectureOverview';
+      UPDATE entities SET type_name = 'FR'  WHERE type_name = 'FunctionalRequirement';
+      UPDATE entities SET type_name = 'NFR' WHERE type_name = 'NonFunctionalRequirement';
+      UPDATE entities SET type_name = 'US'  WHERE type_name = 'UserStory';
+      UPDATE entities SET type_name = 'FS'  WHERE type_name = 'FunctionalSpecification';
+      UPDATE entities SET type_name = 'NFS' WHERE type_name = 'NonFunctionalSpecification';
+      UPDATE entities SET type_name = 'QA'  WHERE type_name = 'QualityScenario';
+      UPDATE entities SET type_name = 'TC'  WHERE type_name = 'TestCase';
+      UPDATE entities SET type_name = 'TR'  WHERE type_name = 'TestReport';
+      UPDATE entities SET type_name = 'TS'  WHERE type_name = 'TestSuite';
+      UPDATE entities SET type_name = 'URD' WHERE type_name = 'UserRequirement';
+
+      -- Phase C: Update relation_types from_types/to_types JSON arrays (SAD-0029 §3.1)
+      -- Use json_group_array with CASE to replace long names with short codes.
+      -- Only rows that contain long-form names are matched (LIKE filter for efficiency).
+
+      -- Update from_types arrays
+      UPDATE relation_types
+      SET from_types = (
+        SELECT json_group_array(
+          CASE value
+            WHEN 'ArchitectureDecision' THEN 'AD'
+            WHEN 'ArchitectureOverview' THEN 'SAD'
+            WHEN 'FunctionalRequirement' THEN 'FR'
+            WHEN 'FunctionalSpecification' THEN 'FS'
+            WHEN 'NonFunctionalRequirement' THEN 'NFR'
+            WHEN 'NonFunctionalSpecification' THEN 'NFS'
+            WHEN 'QualityScenario' THEN 'QA'
+            WHEN 'TestCase' THEN 'TC'
+            WHEN 'TestReport' THEN 'TR'
+            WHEN 'TestSuite' THEN 'TS'
+            WHEN 'UserRequirement' THEN 'URD'
+            WHEN 'UserStory' THEN 'US'
+            ELSE value END
+        )
+        FROM json_each(from_types)
+      )
+      WHERE from_types LIKE '%ArchitectureDecision%'
+         OR from_types LIKE '%ArchitectureOverview%'
+         OR from_types LIKE '%FunctionalRequirement%'
+         OR from_types LIKE '%FunctionalSpecification%'
+         OR from_types LIKE '%NonFunctionalRequirement%'
+         OR from_types LIKE '%NonFunctionalSpecification%'
+         OR from_types LIKE '%QualityScenario%'
+         OR from_types LIKE '%TestCase%'
+         OR from_types LIKE '%TestReport%'
+         OR from_types LIKE '%TestSuite%'
+         OR from_types LIKE '%UserRequirement%'
+         OR from_types LIKE '%UserStory%';
+
+      -- Update to_types arrays
+      UPDATE relation_types
+      SET to_types = (
+        SELECT json_group_array(
+          CASE value
+            WHEN 'ArchitectureDecision' THEN 'AD'
+            WHEN 'ArchitectureOverview' THEN 'SAD'
+            WHEN 'FunctionalRequirement' THEN 'FR'
+            WHEN 'FunctionalSpecification' THEN 'FS'
+            WHEN 'NonFunctionalRequirement' THEN 'NFR'
+            WHEN 'NonFunctionalSpecification' THEN 'NFS'
+            WHEN 'QualityScenario' THEN 'QA'
+            WHEN 'TestCase' THEN 'TC'
+            WHEN 'TestReport' THEN 'TR'
+            WHEN 'TestSuite' THEN 'TS'
+            WHEN 'UserRequirement' THEN 'URD'
+            WHEN 'UserStory' THEN 'US'
+            ELSE value END
+        )
+        FROM json_each(to_types)
+      )
+      WHERE to_types LIKE '%ArchitectureDecision%'
+         OR to_types LIKE '%ArchitectureOverview%'
+         OR to_types LIKE '%FunctionalRequirement%'
+         OR to_types LIKE '%FunctionalSpecification%'
+         OR to_types LIKE '%NonFunctionalRequirement%'
+         OR to_types LIKE '%NonFunctionalSpecification%'
+         OR to_types LIKE '%QualityScenario%'
+         OR to_types LIKE '%TestCase%'
+         OR to_types LIKE '%TestReport%'
+         OR to_types LIKE '%TestSuite%'
+         OR to_types LIKE '%UserRequirement%'
+         OR to_types LIKE '%UserStory%';
+    `,
+    },
+    {
+        version: 7,
+        description: 'URD-026: Remove lesson metadata columns (sprint_id, category, title, severity)',
+        sql: `
+      -- URD-026 Part B: Remove metadata columns from lessons table
+      -- Lesson becomes content-only cumulative document (AD-0029)
+      -- Idempotent via recreate-swap pattern
+
+      -- Drop dependent index first (idempotent)
+      DROP INDEX IF EXISTS idx_lessons_sprint;
+
+      -- Recreate lessons table without metadata columns
+      CREATE TABLE IF NOT EXISTS lessons_v7 (
+        id          INTEGER PRIMARY KEY AUTOINCREMENT,
+        description TEXT NOT NULL,
+        text        TEXT NOT NULL DEFAULT '',
+        created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      -- Migrate data from old table (runs whether or not old columns exist)
+      INSERT INTO lessons_v7 (id, description, text, created_at, updated_at)
+        SELECT id, description, COALESCE(text, description),
+               created_at, COALESCE(updated_at, created_at)
+        FROM lessons;
+
+      DROP TABLE IF EXISTS lessons;
+      ALTER TABLE lessons_v7 RENAME TO lessons;
+    `,
+    },
+    {
+        version: 8,
+        description: 'SAD-0031: Drop task_id/run_number from test_reports, change id to TEXT, add composite indexes',
+        sql: `
+      -- SAD-0031 Part B: Rebuild test_reports without task_id, run_number.
+      -- id changes from INTEGER AUTOINCREMENT to TEXT (caller-provided).
+      -- Primary key becomes (sprint_id, id).
+      -- Idempotent via recreate-swap pattern.
+
+      -- Drop old indexes
+      DROP INDEX IF EXISTS idx_test_reports_sprint;
+      DROP INDEX IF EXISTS idx_test_reports_module;
+
+      -- Recreate test_reports table with new schema
+      CREATE TABLE IF NOT EXISTS test_reports_v8 (
+        id          TEXT NOT NULL,
+        sprint_id   TEXT NOT NULL REFERENCES sprints(id),
+        total       INTEGER NOT NULL,
+        passed      INTEGER NOT NULL,
+        failed      INTEGER NOT NULL,
+        skipped     INTEGER NOT NULL,
+        blocked     INTEGER NOT NULL DEFAULT 0,
+        result      TEXT NOT NULL CHECK (result IN ('PASS','FAIL','BLOCKED')),
+        command     TEXT,
+        duration_ms INTEGER,
+        report_path TEXT,
+        module_id   TEXT,
+        status      TEXT DEFAULT 'PASS',
+        content     TEXT DEFAULT '',
+        pass_count  INTEGER DEFAULT 0,
+        fail_count  INTEGER DEFAULT 0,
+        skip_count  INTEGER DEFAULT 0,
+        updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        PRIMARY KEY (sprint_id, id)
+      );
+
+      -- Migrate data: old autoincrement id becomes string, drop task_id, run_number
+      INSERT INTO test_reports_v8 (
+        id, sprint_id, total, passed, failed, skipped, blocked, result,
+        command, duration_ms, report_path, module_id, status, content,
+        pass_count, fail_count, skip_count, created_at, updated_at
+      )
+      SELECT
+        CAST(id AS TEXT), sprint_id, total, passed, failed, skipped, blocked, result,
+        command, CAST(ROUND(COALESCE(duration_s, 0) * 1000) AS INTEGER), report_path,
+        module_id, status, content, pass_count, fail_count, skip_count,
+        created_at, COALESCE(updated_at, created_at)
+      FROM test_reports;
+
+      DROP TABLE IF EXISTS test_reports;
+      ALTER TABLE test_reports_v8 RENAME TO test_reports;
+
+      -- SAD-0031 Part A: Composite indexes for duplicate ID validation
+      CREATE INDEX IF NOT EXISTS idx_test_reports_sprint ON test_reports(sprint_id);
+      CREATE INDEX IF NOT EXISTS idx_test_reports_module ON test_reports(module_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_sprint_id_id ON tasks(sprint_id, id);
+      CREATE INDEX IF NOT EXISTS idx_reviews_sprint_id_id ON reviews(sprint_id, review_num);
+      CREATE INDEX IF NOT EXISTS idx_test_reports_sprint_id_id ON test_reports(sprint_id, id);
+    `,
+    },
+    {
+        version: 9,
+        description: 'URD-030: Add stage column, remove blocker column, migrate Blocked tasks to Dropped',
+        sql: `
+      -- Step 1: Migrate existing Blocked tasks to Dropped (FS-SS-030-0004 RM-003)
+      UPDATE tasks SET status = 'Dropped' WHERE status = 'Blocked';
+
+      -- Step 2: Drop the blocker column (idempotent via ALTER TABLE DROP COLUMN in SQLite 3.35+)
+      ALTER TABLE tasks DROP COLUMN blocker;
+
+      -- Step 3: Add stage column with default 'Planning' and CHECK constraint
+      ALTER TABLE tasks ADD COLUMN stage TEXT NOT NULL DEFAULT 'Planning'
+        CHECK (stage IN ('Planning','Requirement','Specification','Design','Test Plan','Implementation','Testing','Release'));
+
+      -- Step 4: Recreate status CHECK constraint without Blocked
+      -- SQLite doesn't support ALTER COLUMN, so recreate the table
+      CREATE TABLE IF NOT EXISTS tasks_v9 (
+        id          TEXT PRIMARY KEY,
+        sprint_id   TEXT NOT NULL REFERENCES sprints(id),
+        parent_id   TEXT REFERENCES tasks(id),
+        description TEXT NOT NULL,
+        task_type   TEXT NOT NULL DEFAULT 'Feature'
+                    CHECK (task_type IN ('Feature','Bug','Chore')),
+        priority    TEXT NOT NULL DEFAULT 'P2'
+                    CHECK (priority IN ('P0','P1','P2')),
+        owner       TEXT NOT NULL,
+        points      INTEGER DEFAULT 0,
+        status      TEXT NOT NULL DEFAULT 'Backlog'
+                    CHECK (status IN ('Backlog','To Do','In Progress','In Review','Done','Dropped')),
+        stage       TEXT NOT NULL DEFAULT 'Planning'
+                    CHECK (stage IN ('Planning','Requirement','Specification','Design','Test Plan','Implementation','Testing','Release')),
+        session_key TEXT,
+        started_at  TEXT,
+        reviewer    TEXT,
+        review_notes TEXT,
+        completed_at TEXT,
+        scope_in    TEXT,
+        scope_out   TEXT,
+        decisions   TEXT,
+        dependencies TEXT,
+        acceptance  TEXT,
+        created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        removed_at  TEXT
+      );
+
+      -- Copy data from old table
+      INSERT INTO tasks_v9 (
+        id, sprint_id, parent_id, description, task_type, priority,
+        owner, points, status, stage, session_key, started_at,
+        reviewer, review_notes, completed_at, scope_in, scope_out,
+        decisions, dependencies, acceptance, created_at, updated_at, removed_at
+      )
+      SELECT
+        id, sprint_id, parent_id, description, task_type, priority,
+        owner, points, status, stage, session_key, started_at,
+        reviewer, review_notes, completed_at, scope_in, scope_out,
+        decisions, dependencies, acceptance, created_at, updated_at, removed_at
+      FROM tasks;
+
+      DROP TABLE IF EXISTS tasks;
+      ALTER TABLE tasks_v9 RENAME TO tasks;
+
+      -- Recreate indexes
+      CREATE INDEX IF NOT EXISTS idx_tasks_sprint ON tasks(sprint_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(sprint_id, status);
+      CREATE INDEX IF NOT EXISTS idx_tasks_owner  ON tasks(sprint_id, owner);
+    `,
+    },
+    {
+        version: 10,
+        description: 'FS-SS-028-0002: Migrate task IDs from sprint-XXX-N to 4-digit NNNN format',
+        sql: `
+      -- Create a mapping of old IDs to new sequential NNNN IDs, ordered by creation date.
+      -- Old IDs in the format "sprint-YYYYMMDDNN-N" are assigned new NNNN IDs.
+      -- This is necessary because multiple sprints may have tasks with the same N suffix,
+      -- which would cause PRIMARY KEY conflicts if N values were preserved directly.
+      -- (MR-001: preserve the N value from sprint-XXX-N — caveat: renumbered to avoid PK collisions.)
+
+      -- Step 1: Create temporary mapping table
+      CREATE TABLE IF NOT EXISTS _task_id_migration (
+        old_id TEXT PRIMARY KEY,
+        new_id TEXT NOT NULL
+      );
+
+      -- Step 2: Assign new sequential IDs in creation order
+      INSERT INTO _task_id_migration (old_id, new_id)
+      SELECT id, SUBSTR('0000' || CAST(ROW_NUMBER() OVER (ORDER BY created_at, id) AS TEXT), -4)
+      FROM tasks;
+
+      -- Step 3: Disable FK checks temporarily for renumbering
+      PRAGMA foreign_keys = OFF;
+
+      -- Step 4: Update parent_id references to new IDs
+      UPDATE tasks SET parent_id = (
+        SELECT m.new_id FROM _task_id_migration m WHERE m.old_id = tasks.parent_id
+      ) WHERE parent_id IS NOT NULL;
+
+      -- Step 5: Update task IDs
+      UPDATE tasks SET id = (
+        SELECT m.new_id FROM _task_id_migration m WHERE m.old_id = tasks.id
+      );
+
+      -- Step 6: Clean up and re-enable FK checks
+      DROP TABLE IF EXISTS _task_id_migration;
+      PRAGMA foreign_keys = ON;
+    `,
+    },
+    {
+        version: 11,
+        description: 'SAD-0035: Drop entities table, rebuild relations to reference documents(id)',
+        sql: `
+      -- ⚠️ WARNING: This migration is IRREVERSIBLE.
+      -- The entities table is permanently dropped and the relations table is rebuilt
+      -- to reference documents(id) instead of entities(id).
+      -- There is no rollback path. Ensure you have a database backup before applying.
+
+      -- Step 1: Drop indexes that depend on entities
+      DROP INDEX IF EXISTS idx_entities_type;
+
+      -- Step 2: Drop the entities table
+      DROP TABLE IF EXISTS entities;
+
+      -- Step 3: Rebuild relations table with FK referencing documents(id) instead of entities(id)
+      CREATE TABLE IF NOT EXISTS relations_v11 (
+        id          INTEGER PRIMARY KEY AUTOINCREMENT,
+        from_id     TEXT NOT NULL REFERENCES documents(id),
+        rel_type    TEXT NOT NULL REFERENCES relation_types(name),
+        to_id       TEXT NOT NULL REFERENCES documents(id),
+        properties  TEXT NOT NULL DEFAULT '{}',
+        created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        UNIQUE(from_id, rel_type, to_id)
+      );
+
+      -- Step 4: Migrate surviving relations (only rows where both from_id and to_id exist in documents)
+      INSERT INTO relations_v11 (id, from_id, rel_type, to_id, properties, created_at, updated_at)
+        SELECT r.id, r.from_id, r.rel_type, r.to_id, r.properties, r.created_at, r.updated_at
+        FROM relations r
+        WHERE EXISTS (SELECT 1 FROM documents d WHERE d.id = r.from_id)
+          AND EXISTS (SELECT 1 FROM documents d WHERE d.id = r.to_id);
+
+      -- Step 5: Swap tables
+      DROP TABLE IF EXISTS relations;
+      ALTER TABLE relations_v11 RENAME TO relations;
+
+      -- Step 6: Recreate indexes
+      CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_id, rel_type);
+      CREATE INDEX IF NOT EXISTS idx_relations_to   ON relations(to_id, rel_type);
+      CREATE INDEX IF NOT EXISTS idx_relations_type ON relations(rel_type);
+    `,
+    },
+    {
+        version: 12,
+        description: 'URD-034: Drop reviewer and review_notes columns from tasks table (unified owner model)',
+        sql: `
+      -- Drop reviewer column if it exists (ownership unified under existing owner column)
+      -- Dropping a non-existent column in SQLite 3.35+ throws an error.
+      -- Use PRAGMA table_info to check existence before dropping.
+      -- This migration is idempotent: for fresh DBs created with the updated initial
+      -- schema (which excludes these columns), the DROP is skipped automatically
+      -- via the migration runner's version check; but to be safe, we catch the case.
+      
+      -- Drop reviewer column
+      ALTER TABLE tasks DROP COLUMN reviewer;
+      -- Drop review_notes column
+      ALTER TABLE tasks DROP COLUMN review_notes;
+    `,
+    },
+    {
+        version: 13,
+        description: 'Per-sprint task ID policy: change tasks PK from id to composite (sprint_id, id)',
+        sql: `
+      -- Allow task IDs to reset per sprint by changing PK from global id to composite (sprint_id, id)
+      -- This matches the PMP workflow contract ID policy where sprint tasks, reviews, and test-reports
+      -- reset their 4-digit IDs at 0001 for each new sprint.
+
+      -- Step 1: Create new tasks table with composite PK
+      CREATE TABLE IF NOT EXISTS tasks_v13 (
+        id          TEXT NOT NULL,
+        sprint_id   TEXT NOT NULL REFERENCES sprints(id),
+        parent_id   TEXT, -- cross-sprint parent references use global-unique IDs
+        description TEXT NOT NULL,
+        task_type   TEXT NOT NULL DEFAULT 'Feature'
+                    CHECK (task_type IN ('Feature','Bug','Chore')),
+        priority    TEXT NOT NULL DEFAULT 'P2'
+                    CHECK (priority IN ('P0','P1','P2')),
+        owner       TEXT NOT NULL,
+        points      INTEGER DEFAULT 0,
+        status      TEXT NOT NULL DEFAULT 'Backlog'
+                    CHECK (status IN ('Backlog','To Do','In Progress','In Review','Done','Dropped')),
+        stage       TEXT NOT NULL DEFAULT 'Planning'
+                    CHECK (stage IN ('Planning','Requirement','Specification','Design','Test Plan','Implementation','Testing','Release')),
+        session_key TEXT,
+        started_at  TEXT,
+        completed_at TEXT,
+        scope_in    TEXT,
+        scope_out   TEXT,
+        decisions   TEXT,
+        dependencies TEXT,
+        acceptance  TEXT,
+        created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at  TEXT NOT NULL DEFAULT (datetime('now')),
+        removed_at  TEXT,
+        PRIMARY KEY (sprint_id, id)
+      );
+
+      -- Step 2: Copy data
+      INSERT INTO tasks_v13 (
+        id, sprint_id, parent_id, description, task_type, priority,
+        owner, points, status, stage, session_key, started_at,
+        completed_at, scope_in, scope_out, decisions, dependencies,
+        acceptance, created_at, updated_at, removed_at
+      )
+      SELECT
+        id, sprint_id, parent_id, description, task_type, priority,
+        owner, points, status, stage, session_key, started_at,
+        completed_at, scope_in, scope_out, decisions, dependencies,
+        acceptance, created_at, updated_at, removed_at
+      FROM tasks;
+
+      -- Step 3: Swap tables
+      DROP TABLE IF EXISTS tasks;
+      ALTER TABLE tasks_v13 RENAME TO tasks;
+
+      -- Step 4: Recreate indexes
+      CREATE INDEX IF NOT EXISTS idx_tasks_sprint ON tasks(sprint_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(sprint_id, status);
+      CREATE INDEX IF NOT EXISTS idx_tasks_owner  ON tasks(sprint_id, owner);
+      CREATE INDEX IF NOT EXISTS idx_tasks_sprint_id_id ON tasks(sprint_id, id);
+    `,
+    },
+];
+/** Current latest migration version */
+exports.LATEST_VERSION = exports.MIGRATIONS[exports.MIGRATIONS.length - 1].version;
+/** List of all table names expected in the schema */
+exports.EXPECTED_TABLES = [
+    '_migrations',
+    'locks',
+    'sprints',
+    'tasks',
+    // builtin:3.0 (Sprint 31): entity_types table removed — doc types are sole source of truth
+    // SAD-0035: entities table dropped — replaced by documents(id) FKs on relations
+    'relation_types',
+    'relations',
+    'graph_schema',
+    'reviews',
+    'documents',
+    'document_contents',
+    'document_contents_fts',
+    'test_reports',
+    'lessons',
+];
+/** List of all index names expected in the schema */
+exports.EXPECTED_INDEXES = [
+    'idx_tasks_sprint',
+    'idx_tasks_parent',
+    'idx_tasks_status',
+    'idx_tasks_owner',
+    'idx_relations_from',
+    'idx_relations_to',
+    'idx_relations_type',
+    'idx_reviews_sprint',
+    'idx_reviews_verdict',
+    'idx_reviews_sprint_num',
+    'idx_documents_type',
+    'idx_reviews_type',
+    'idx_test_reports_sprint',
+    'idx_test_reports_module',
+    'idx_tasks_sprint_id_id',
+    'idx_reviews_sprint_id_id',
+    'idx_test_reports_sprint_id_id',
+];
+//# sourceMappingURL=schema.js.map