@lwelliott/cortex-cli 1.0.3

package/dist/db/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/db/retry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC,CAsDnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC,CAKhG"}

package/dist/db/retry.js

@@ -0,0 +1,71 @@
+"use strict";
+// Busy retry handler with exponential backoff
+// Implements AD-0003: WAL Mode with Busy Timeout and Exponential Backoff
+// + FS-SS-003-0005 (retry on busy), FS-SS-003-0007 (error codes)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = withRetry;
+exports.withTransaction = withTransaction;
+const errors_1 = require("../utils/errors");
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 5,
+    baseMs: 50,
+    maxMs: 1000,
+    maxTotalWaitMs: 30000,
+};
+/**
+ * Execute a function with retry on SQLITE_BUSY using exponential backoff.
+ * Each retry doubles the delay, capped at maxMs.
+ * Total wait time is capped by maxTotalWaitMs per FS-SS-003-0005 VR-007.
+ *
+ * @param fn - The function to execute (typically a DB write operation)
+ * @param options - Retry configuration
+ * @throws DatabaseBusyError (ERR-LOCK-001) if all retries are exhausted
+ */
+function withRetry(fn, options) {
+    const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError;
+    const startTime = Date.now();
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return fn();
+        }
+        catch (err) {
+            // Check if this is a SQLITE_BUSY error
+            if (err instanceof Error && (err.message.includes('SQLITE_BUSY') || err.message.includes('database is locked'))) {
+                lastError = err;
+                if (attempt < opts.maxRetries) {
+                    // Check maxTotalWaitMs cap (VR-007)
+                    const elapsed = Date.now() - startTime;
+                    const delay = Math.min(opts.baseMs * Math.pow(2, attempt), opts.maxMs);
+                    if (elapsed + delay >= opts.maxTotalWaitMs) {
+                        // Would exceed total wait cap — abort
+                        throw new errors_1.LockRetryExhaustedError('database', 'unknown', attempt, elapsed);
+                    }
+                    // Synchronous delay
+                    const end = Date.now() + delay;
+                    while (Date.now() < end) {
+                        // busy-wait
+                    }
+                    continue;
+                }
+                // Retries exhausted on a busy error
+                const totalMs = Date.now() - startTime;
+                throw new errors_1.LockRetryExhaustedError('database', 'unknown', opts.maxRetries, totalMs);
+            }
+            // Not a busy error — rethrow immediately
+            throw err;
+        }
+    }
+    // Should not reach here, but safety fallback
+    throw new errors_1.DatabaseBusyError(`Database busy after ${opts.maxRetries} retries`, { maxRetries: opts.maxRetries, baseMs: opts.baseMs, originalError: lastError });
+}
+/**
+ * Execute a database operation within a transaction with retry on busy.
+ */
+function withTransaction(db, fn, options) {
+    return withRetry(() => {
+        const transaction = db.transaction(fn);
+        return transaction();
+    }, options);
+}
+//# sourceMappingURL=retry.js.map

package/dist/db/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/db/retry.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,yEAAyE;AACzE,iEAAiE;;AAgCjE,8BAsDC;AAKD,0CAKC;AA7FD,4CAA6E;AAa7E,MAAM,qBAAqB,GAA2B;IACpD,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,IAAI;IACX,cAAc,EAAE,KAAK;CACtB,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAI,EAAW,EAAE,OAAsB;IAC9D,MAAM,IAAI,GAAG,EAAE,GAAG,qBAAqB,EAAE,GAAG,OAAO,EAAE,CAAC;IACtD,IAAI,SAAkB,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,uCAAuC;YACvC,IAAI,GAAG,YAAY,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC;gBAChH,SAAS,GAAG,GAAG,CAAC;gBAEhB,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;oBAC9B,oCAAoC;oBACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;oBAEvE,IAAI,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;wBAC3C,sCAAsC;wBACtC,MAAM,IAAI,gCAAuB,CAC/B,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,CACR,CAAC;oBACJ,CAAC;oBAED,oBAAoB;oBACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;oBAC/B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;wBACxB,YAAY;oBACd,CAAC;oBACD,SAAS;gBACX,CAAC;gBACD,oCAAoC;gBACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACvC,MAAM,IAAI,gCAAuB,CAC/B,UAAU,EACV,SAAS,EACT,IAAI,CAAC,UAAU,EACf,OAAO,CACR,CAAC;YACJ,CAAC;YACD,yCAAyC;YACzC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,IAAI,0BAAiB,CACzB,uBAAuB,IAAI,CAAC,UAAU,UAAU,EAChD,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAC/E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAI,EAAqB,EAAE,EAAW,EAAE,OAAsB;IAC3F,OAAO,SAAS,CAAC,GAAG,EAAE;QACpB,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACvC,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC,EAAE,OAAO,CAAC,CAAC;AACd,CAAC"}

package/dist/db/schema.d.ts

@@ -0,0 +1,21 @@
+/** Single migration definition */
+export interface Migration {
+    version: number;
+    description: string;
+    sql: string;
+}
+/** All DDL for the initial schema (migration version 1) */
+export declare const INITIAL_SCHEMA_SQL = "\n-- \u2500\u2500\u2500 Sprints \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS sprints (\n  id          TEXT PRIMARY KEY,\n  name        TEXT NOT NULL,\n  status      TEXT NOT NULL DEFAULT 'PLANNING'\n              CHECK (status IN ('PLANNING','IN EXECUTION','CLOSING','CLOSED')),\n  goal        TEXT,\n  started_at  TEXT,\n  closed_at   TEXT,\n  created_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- \u2500\u2500\u2500 Tasks \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS tasks (\n  id          TEXT NOT NULL,\n  sprint_id   TEXT NOT NULL REFERENCES sprints(id),\n  parent_id   TEXT,\n  description TEXT NOT NULL,\n  task_type   TEXT NOT NULL DEFAULT 'Feature'\n              CHECK (task_type IN ('Feature','Bug','Chore')),\n  priority    TEXT NOT NULL DEFAULT 'P2'\n              CHECK (priority IN ('P0','P1','P2')),\n  owner       TEXT NOT NULL,\n  points      INTEGER DEFAULT 0,\n  status      TEXT NOT NULL DEFAULT 'Backlog'\n              CHECK (status IN ('Backlog','To Do','In Progress','In Review','Done','Dropped')),\n  stage       TEXT NOT NULL DEFAULT 'Planning'\n              CHECK (stage IN ('Planning','Requirement','Specification','Design','Test Plan','Implementation','Testing','Release')),\n  session_key TEXT,\n  started_at  TEXT,\n  completed_at TEXT,\n  scope_in    TEXT,\n  scope_out   TEXT,\n  decisions   TEXT,\n  dependencies TEXT,\n  acceptance  TEXT,\n  created_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY (sprint_id, id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_tasks_sprint ON tasks(sprint_id);\nCREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id);\nCREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(sprint_id, status);\nCREATE INDEX IF NOT EXISTS idx_tasks_owner  ON tasks(sprint_id, owner);\n\n-- \u2500\u2500\u2500 Graph: Entity Types \u2500\u2500\u2500\n-- builtin:3.0 (Sprint 31): entity_types table DROPPED. Doc types are the sole source of truth.\n-- Do NOT recreate this table.\n\n-- \u2500\u2500\u2500 Graph: Entities \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS entities (\n  id          TEXT PRIMARY KEY,\n  type_name   TEXT NOT NULL,\n  properties  TEXT NOT NULL DEFAULT '{}',\n  created_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type_name);\n\n-- \u2500\u2500\u2500 Graph: Relation Types \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS relation_types (\n  name        TEXT PRIMARY KEY,\n  from_types  TEXT NOT NULL DEFAULT '[]',\n  to_types    TEXT NOT NULL DEFAULT '[]',\n  cardinality TEXT DEFAULT 'many_to_many',\n  inverse_of  TEXT REFERENCES relation_types(name),\n  description TEXT\n);\n\n-- \u2500\u2500\u2500 Graph: Relations \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS relations (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  from_id     TEXT NOT NULL REFERENCES entities(id),\n  rel_type    TEXT NOT NULL REFERENCES relation_types(name),\n  to_id       TEXT NOT NULL REFERENCES entities(id),\n  properties  TEXT NOT NULL DEFAULT '{}',\n  created_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(from_id, rel_type, to_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_id, rel_type);\nCREATE INDEX IF NOT EXISTS idx_relations_to   ON relations(to_id, rel_type);\nCREATE INDEX IF NOT EXISTS idx_relations_type ON relations(rel_type);\n\n-- \u2500\u2500\u2500 Graph: Schema Version \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS graph_schema (\n  key   TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n);\n\n-- \u2500\u2500\u2500 Reviews \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS reviews (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  review_num  TEXT NOT NULL,\n  sprint_id   TEXT NOT NULL REFERENCES sprints(id),\n  asset_name  TEXT NOT NULL,\n  review_type TEXT NOT NULL\n              CHECK (review_type IN ('requirements','architecture','code','test','document')),\n  verdict     TEXT NOT NULL\n              CHECK (verdict IN ('APPROVED','NEEDS_REWORK','OPEN_QUESTION')),\n  critical_count INTEGER NOT NULL DEFAULT 0,\n  major_count    INTEGER NOT NULL DEFAULT 0,\n  minor_count    INTEGER NOT NULL DEFAULT 0,\n  suggestion_count INTEGER NOT NULL DEFAULT 0,\n  open_questions_count INTEGER NOT NULL DEFAULT 0,\n  content     TEXT NOT NULL,\n  created_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_reviews_sprint ON reviews(sprint_id);\nCREATE INDEX IF NOT EXISTS idx_reviews_verdict ON reviews(verdict);\nCREATE UNIQUE INDEX IF NOT EXISTS idx_reviews_sprint_num ON reviews(sprint_id, review_num);\n\n-- \u2500\u2500\u2500 Documents (canonical artifact registry) \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS documents (\n  id          TEXT PRIMARY KEY,\n  type        TEXT NOT NULL,\n  title       TEXT NOT NULL,\n  path        TEXT,\n  status      TEXT DEFAULT 'Draft',\n  module_id   TEXT,\n  sprint_id   TEXT REFERENCES sprints(id),\n  content_hash TEXT,\n  content_storage TEXT NOT NULL DEFAULT 'filesystem'\n              CHECK (content_storage IN ('filesystem', 'db')),\n  metadata    TEXT DEFAULT '{}',\n  created_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_documents_type ON documents(type);\nCREATE INDEX IF NOT EXISTS idx_documents_module ON documents(module_id);\nCREATE INDEX IF NOT EXISTS idx_documents_sprint ON documents(sprint_id);\n\n-- \u2500\u2500\u2500 Document Contents (DB-stored content + FTS5) \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS document_contents (\n  document_id TEXT PRIMARY KEY REFERENCES documents(id),\n  content     TEXT NOT NULL,\n  content_hash TEXT NOT NULL,\n  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS document_contents_fts USING fts5(\n  document_id,\n  content,\n  content='document_contents',\n  content_rowid='rowid'\n);\n\n-- FTS sync triggers\nCREATE TRIGGER IF NOT EXISTS document_contents_ai AFTER INSERT ON document_contents BEGIN\n  INSERT INTO document_contents_fts(rowid, document_id, content)\n    VALUES (new.rowid, new.document_id, new.content);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS document_contents_ad AFTER DELETE ON document_contents BEGIN\n  INSERT INTO document_contents_fts(document_contents_fts, rowid, document_id, content)\n    VALUES ('delete', old.rowid, old.document_id, old.content);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS document_contents_au AFTER UPDATE ON document_contents BEGIN\n  INSERT INTO document_contents_fts(document_contents_fts, rowid, document_id, content)\n    VALUES ('delete', old.rowid, old.document_id, old.content);\n  INSERT INTO document_contents_fts(rowid, document_id, content)\n    VALUES (new.rowid, new.document_id, new.content);\nEND;\n\n-- \u2500\u2500\u2500 Test Execution Reports \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS test_reports (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  sprint_id   TEXT NOT NULL REFERENCES sprints(id),\n  task_id     TEXT REFERENCES tasks(id),\n  run_number  INTEGER NOT NULL,\n  total       INTEGER NOT NULL,\n  passed      INTEGER NOT NULL,\n  failed      INTEGER NOT NULL,\n  skipped     INTEGER NOT NULL,\n  blocked     INTEGER NOT NULL DEFAULT 0,\n  result      TEXT NOT NULL CHECK (result IN ('PASS','FAIL','BLOCKED')),\n  command     TEXT,\n  duration_s  REAL,\n  report_path TEXT,\n  created_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- \u2500\u2500\u2500 Lessons \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS lessons (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  sprint_id   TEXT REFERENCES sprints(id),\n  category    TEXT NOT NULL\n              CHECK (category IN ('Process','Technical','Tool','Model')),\n  title       TEXT NOT NULL,\n  description TEXT NOT NULL,\n  severity    TEXT DEFAULT 'minor' CHECK (severity IN ('critical','major','minor','suggestion')),\n  created_at  TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- \u2500\u2500\u2500 Advisory Locks \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS locks (\n  name           TEXT PRIMARY KEY,\n  owner          TEXT NOT NULL,\n  acquired_at    TEXT NOT NULL,\n  last_heartbeat TEXT\n);\n\n-- \u2500\u2500\u2500 Migrations \u2500\u2500\u2500\nCREATE TABLE IF NOT EXISTS _migrations (\n  version     INTEGER PRIMARY KEY,\n  applied_at  TEXT NOT NULL DEFAULT (datetime('now')),\n  checksum    TEXT NOT NULL DEFAULT ''\n);\n";
+/**
+ * Sequential versioned migrations.
+ * Version 1 is the initial schema applied on fresh database creation.
+ * Future migrations add entries here with incrementing version numbers.
+ */
+export declare const MIGRATIONS: Migration[];
+/** Current latest migration version */
+export declare const LATEST_VERSION: number;
+/** List of all table names expected in the schema */
+export declare const EXPECTED_TABLES: readonly ["_migrations", "locks", "sprints", "tasks", "relation_types", "relations", "graph_schema", "reviews", "documents", "document_contents", "document_contents_fts", "test_reports", "lessons"];
+/** List of all index names expected in the schema */
+export declare const EXPECTED_INDEXES: readonly ["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.d.ts.map

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAGA,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,g1QAuN9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAijBjC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,cAAc,QAA4C,CAAC;AAExE,qDAAqD;AACrD,eAAO,MAAM,eAAe,uMAgBlB,CAAC;AAEX,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,wZAkBnB,CAAC"}