@cluesmith/codev 3.2.0 → 3.2.2

package/dist/agent-farm/db/consolidate.js

@@ -0,0 +1,406 @@
+/**
+ * One-time state.db → global.db consolidation engine (Issue #1118).
+ *
+ * The retired per-workspace `state.db` files hold architect/builders/utils/
+ * annotations rows. This engine migrates a single `state.db` into the shared
+ * `global.db`, then renames the source (never deletes it). It is the single
+ * source of truth used by two callers:
+ *
+ *   1. The automatic boot one-off (tower-server.ts) — runs once ever, gated by
+ *      a persistent `_consolidation` marker, against the *active* state.db.
+ *   2. The manual `afx db consolidate <path>` command — runs on demand against
+ *      any satellite state.db. Not marker-gated.
+ *
+ * It knows nothing about the marker. Conflict resolution is **upsert-if-newer**
+ * (latest `started_at` wins): on an empty target every row inserts; on a
+ * non-empty target a stale overlapping row is skipped. Reads are defensive
+ * (`PRAGMA`-tolerant) so source files at any historical schema version migrate.
+ */
+import Database from 'better-sqlite3';
+import { existsSync, renameSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { getConfig } from '../utils/index.js';
+// Issue #1118: shared workspace-path canonicalization (single source of truth),
+// aliased to `canonicalize` for the local callsites.
+import { normalizeWorkspacePath as canonicalize } from '../utils/workspace-path.js';
+/** The `state.db` the pre-#1118 `getDb()` would have opened for this process. */
+export function activeStateDbPath() {
+    return resolve(getConfig().stateDir, 'state.db');
+}
+/** A builder's owning workspace: the prefix before the LAST `/.builders/`, else fallback. */
+function deriveWorkspaceFromWorktree(worktree, fallback) {
+    // lastIndexOf, not indexOf — robust when the path contains an earlier
+    // `.builders` segment (a builder worktree nested under another).
+    const marker = '/.builders/';
+    const idx = worktree.lastIndexOf(marker);
+    if (idx >= 0)
+        return canonicalize(worktree.slice(0, idx));
+    return fallback;
+}
+/** `<workspace>/.agent-farm/state.db` → canonical `<workspace>`. */
+function workspaceFromStateDbPath(file) {
+    return canonicalize(dirname(dirname(file)));
+}
+function tableExists(db, name) {
+    return !!db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name = ?")
+        .get(name);
+}
+function readRows(db, table) {
+    if (!tableExists(db, table))
+        return [];
+    return db.prepare(`SELECT * FROM ${table}`).all();
+}
+function str(v, fallback = '') {
+    if (v == null)
+        return fallback;
+    return String(v);
+}
+function num(v, fallback = 0) {
+    const n = Number(v);
+    if (Number.isFinite(n))
+        return n;
+    return fallback;
+}
+const VALID_STATUS = new Set(['spawning', 'implementing', 'blocked', 'pr', 'complete']);
+const VALID_TYPE = new Set(['spec', 'task', 'protocol', 'shell', 'worktree', 'bugfix', 'pir']);
+// ---------------------------------------------------------------------------
+// Normalizers — map a source row (any historical shape) to the target shape,
+// synthesizing workspace_path and clamping legacy enum values so the global
+// CHECK constraints never reject a migrated row.
+// ---------------------------------------------------------------------------
+function normalizeArchitect(row, wsFromFile) {
+    // Pre-v11 rows lack workspace_path → derive from the file's own directory.
+    // Pre-v9 rows used integer id=1 → the singleton became 'main'.
+    let workspace_path;
+    if (row.workspace_path) {
+        workspace_path = canonicalize(str(row.workspace_path));
+    }
+    else {
+        workspace_path = wsFromFile;
+    }
+    const idRaw = row.id;
+    let id;
+    if (idRaw == null || str(idRaw) === '1') {
+        id = 'main';
+    }
+    else {
+        id = str(idRaw);
+    }
+    return {
+        workspace_path,
+        id,
+        pid: num(row.pid),
+        port: num(row.port),
+        cmd: str(row.cmd),
+        started_at: str(row.started_at),
+        terminal_id: row.terminal_id ?? null,
+        session_id: row.session_id ?? null,
+    };
+}
+function normalizeBuilder(row, wsFromFile) {
+    const worktree = str(row.worktree);
+    let workspace_path;
+    if (row.workspace_path) {
+        workspace_path = canonicalize(str(row.workspace_path));
+    }
+    else {
+        workspace_path = deriveWorkspaceFromWorktree(worktree, wsFromFile);
+    }
+    let status = str(row.status, 'spawning');
+    if (status === 'pr-ready')
+        status = 'pr'; // pre-v7 rename
+    if (!VALID_STATUS.has(status))
+        status = 'implementing';
+    let type = str(row.type, 'spec');
+    if (!VALID_TYPE.has(type))
+        type = 'spec';
+    const startedAt = str(row.started_at);
+    let issueNumber = null;
+    if (row.issue_number != null)
+        issueNumber = str(row.issue_number);
+    return {
+        workspace_path,
+        id: str(row.id),
+        name: str(row.name, str(row.id)),
+        port: num(row.port),
+        pid: num(row.pid),
+        status,
+        phase: str(row.phase),
+        worktree,
+        branch: str(row.branch),
+        type,
+        task_text: row.task_text ?? null,
+        protocol_name: row.protocol_name ?? null,
+        issue_number: issueNumber,
+        terminal_id: row.terminal_id ?? null,
+        spawned_by_architect: row.spawned_by_architect ?? null,
+        started_at: startedAt,
+        updated_at: str(row.updated_at, startedAt),
+    };
+}
+function normalizeUtil(row) {
+    return {
+        id: str(row.id),
+        name: str(row.name, str(row.id)),
+        port: num(row.port),
+        pid: num(row.pid),
+        terminal_id: row.terminal_id ?? null,
+        started_at: str(row.started_at),
+    };
+}
+function normalizeAnnotation(row) {
+    return {
+        id: str(row.id),
+        file: str(row.file),
+        port: num(row.port),
+        pid: num(row.pid),
+        parent_type: str(row.parent_type, 'util'),
+        parent_id: row.parent_id ?? null,
+        started_at: str(row.started_at),
+    };
+}
+// ---------------------------------------------------------------------------
+// Upsert-if-newer statements. The `WHERE excluded.started_at > <table>.started_at`
+// on the conflict path means a stale incoming row leaves the existing (newer)
+// row untouched.
+// ---------------------------------------------------------------------------
+function upsertArchitect(db, r) {
+    db.prepare(`
+    INSERT INTO architect (workspace_path, id, pid, port, cmd, started_at, terminal_id, session_id)
+    VALUES (@workspace_path, @id, @pid, @port, @cmd, @started_at, @terminal_id, @session_id)
+    ON CONFLICT(workspace_path, id) DO UPDATE SET
+      pid = excluded.pid, port = excluded.port, cmd = excluded.cmd,
+      started_at = excluded.started_at, terminal_id = excluded.terminal_id,
+      session_id = excluded.session_id
+    WHERE excluded.started_at > architect.started_at
+  `).run(r);
+}
+function upsertBuilder(db, r) {
+    db.prepare(`
+    INSERT INTO builders (
+      workspace_path, id, name, port, pid, status, phase, worktree, branch,
+      type, task_text, protocol_name, issue_number, terminal_id, spawned_by_architect,
+      started_at, updated_at
+    )
+    VALUES (
+      @workspace_path, @id, @name, @port, @pid, @status, @phase, @worktree, @branch,
+      @type, @task_text, @protocol_name, @issue_number, @terminal_id, @spawned_by_architect,
+      @started_at, @updated_at
+    )
+    ON CONFLICT(workspace_path, id) DO UPDATE SET
+      name = excluded.name, port = excluded.port, pid = excluded.pid,
+      status = excluded.status, phase = excluded.phase, worktree = excluded.worktree,
+      branch = excluded.branch, type = excluded.type, task_text = excluded.task_text,
+      protocol_name = excluded.protocol_name, issue_number = excluded.issue_number,
+      terminal_id = excluded.terminal_id, spawned_by_architect = excluded.spawned_by_architect,
+      started_at = excluded.started_at, updated_at = excluded.updated_at
+    WHERE excluded.started_at > builders.started_at
+  `).run(r);
+}
+function upsertUtil(db, r) {
+    db.prepare(`
+    INSERT INTO utils (id, name, port, pid, terminal_id, started_at)
+    VALUES (@id, @name, @port, @pid, @terminal_id, @started_at)
+    ON CONFLICT(id) DO UPDATE SET
+      name = excluded.name, port = excluded.port, pid = excluded.pid,
+      terminal_id = excluded.terminal_id, started_at = excluded.started_at
+    WHERE excluded.started_at > utils.started_at
+  `).run(r);
+}
+function upsertAnnotation(db, r) {
+    db.prepare(`
+    INSERT INTO annotations (id, file, port, pid, parent_type, parent_id, started_at)
+    VALUES (@id, @file, @port, @pid, @parent_type, @parent_id, @started_at)
+    ON CONFLICT(id) DO UPDATE SET
+      file = excluded.file, port = excluded.port, pid = excluded.pid,
+      parent_type = excluded.parent_type, parent_id = excluded.parent_id,
+      started_at = excluded.started_at
+    WHERE excluded.started_at > annotations.started_at
+  `).run(r);
+}
+function buildSpecs(src, wsFromFile) {
+    return [
+        {
+            table: 'architect',
+            pk: ['workspace_path', 'id'],
+            rows: readRows(src, 'architect').map((r) => normalizeArchitect(r, wsFromFile)),
+            upsert: upsertArchitect,
+        },
+        {
+            table: 'builders',
+            pk: ['workspace_path', 'id'],
+            rows: readRows(src, 'builders').map((r) => normalizeBuilder(r, wsFromFile)),
+            upsert: upsertBuilder,
+        },
+        {
+            table: 'utils',
+            pk: ['id'],
+            rows: readRows(src, 'utils').map(normalizeUtil),
+            upsert: upsertUtil,
+        },
+        {
+            table: 'annotations',
+            pk: ['id'],
+            rows: readRows(src, 'annotations').map(normalizeAnnotation),
+            upsert: upsertAnnotation,
+        },
+    ];
+}
+/** Classify one incoming row against the current global table (no writes). */
+function classify(db, spec, row) {
+    if (!tableExists(db, spec.table))
+        return 'inserted';
+    const where = spec.pk.map((c) => `${c} = ?`).join(' AND ');
+    const existing = db
+        .prepare(`SELECT started_at FROM ${spec.table} WHERE ${where}`)
+        .get(...spec.pk.map((c) => row[c]));
+    if (!existing)
+        return 'inserted';
+    if (str(row.started_at) > str(existing.started_at))
+        return 'updated';
+    return 'skipped';
+}
+/**
+ * Compute what migrating `sourcePath` into `globalDb` would do — pure read, no
+ * writes, no rename. Used by the `--dry-run-migration` preview.
+ */
+export function planMigration(globalDb, sourcePath) {
+    if (!existsSync(sourcePath)) {
+        return { sourcePath, exists: false, stats: [], get total() { return 0; } };
+    }
+    const wsFromFile = workspaceFromStateDbPath(sourcePath);
+    const src = new Database(sourcePath, { readonly: true });
+    try {
+        const specs = buildSpecs(src, wsFromFile);
+        const stats = specs.map((spec) => {
+            const s = { table: spec.table, inserted: 0, updated: 0, skipped: 0 };
+            for (const row of spec.rows)
+                s[classify(globalDb, spec, row)]++;
+            return s;
+        });
+        return {
+            sourcePath,
+            exists: true,
+            stats,
+            get total() {
+                return stats.reduce((n, s) => n + s.inserted + s.updated + s.skipped, 0);
+            },
+        };
+    }
+    finally {
+        src.close();
+    }
+}
+function renameWithSidecars(file) {
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const target = `${file}.pre-merge-${stamp}`;
+    renameSync(file, target);
+    for (const suffix of ['-wal', '-shm']) {
+        const sidecar = file + suffix;
+        if (existsSync(sidecar)) {
+            try {
+                renameSync(sidecar, target + suffix);
+            }
+            catch {
+                // Sidecar rename is best-effort; the main file is already retired.
+            }
+        }
+    }
+    return target;
+}
+/** Read a source state.db, build per-table specs, and classify each row. */
+function prepareMigration(globalDb, sourcePath) {
+    const wsFromFile = workspaceFromStateDbPath(sourcePath);
+    const src = new Database(sourcePath, { readonly: true });
+    try {
+        const specs = buildSpecs(src, wsFromFile);
+        let total = 0;
+        const stats = specs.map((spec) => {
+            const s = { table: spec.table, inserted: 0, updated: 0, skipped: 0 };
+            for (const row of spec.rows) {
+                s[classify(globalDb, spec, row)]++;
+                total++;
+            }
+            return s;
+        });
+        return { specs, stats, total };
+    }
+    finally {
+        src.close();
+    }
+}
+/** Apply all upserts for the prepared specs (caller wraps in a transaction). */
+function copyRows(globalDb, specs) {
+    for (const spec of specs) {
+        for (const row of spec.rows)
+            spec.upsert(globalDb, row);
+    }
+}
+/**
+ * Migrate `sourcePath` into `globalDb` (upsert-if-newer, one transaction), then
+ * rename the source to `*.pre-merge-<timestamp>`. Does NOT touch the
+ * `_consolidation` marker — that is the boot caller's concern. This is the
+ * manual `afx db consolidate <path>` path. Idempotent in practice: once renamed
+ * the source is gone, and re-running upsert-if-newer is a no-op.
+ */
+export function applyMigration(globalDb, sourcePath) {
+    if (!existsSync(sourcePath)) {
+        return { sourcePath, migrated: false, renamedTo: null, stats: [] };
+    }
+    const { specs, stats } = prepareMigration(globalDb, sourcePath);
+    globalDb.transaction(() => copyRows(globalDb, specs))();
+    const renamedTo = renameWithSidecars(sourcePath);
+    return { sourcePath, migrated: true, renamedTo, stats };
+}
+// ---------------------------------------------------------------------------
+// The `_consolidation` marker + the automatic boot one-off (Issue #1118).
+// The marker's mere presence means the one-time boot cutover has run; `state.db`
+// is never read again afterward.
+// ---------------------------------------------------------------------------
+function ensureMarkerTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS _consolidation (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      done_at TEXT NOT NULL DEFAULT (datetime('now')),
+      source_path TEXT,
+      rows_migrated INTEGER
+    )
+  `);
+}
+/** Whether the one-time boot consolidation has already run. */
+export function isConsolidationDone(db) {
+    ensureMarkerTable(db);
+    return !!db.prepare('SELECT 1 FROM _consolidation WHERE id = 1').get();
+}
+function writeMarker(db, sourcePath, rows) {
+    db.prepare('INSERT OR IGNORE INTO _consolidation (id, source_path, rows_migrated) VALUES (1, ?, ?)').run(sourcePath, rows);
+}
+/**
+ * The automatic boot one-off. Runs once ever (strict policy): on the first boot
+ * the marker is unset, so it migrates the *active* state.db and writes the
+ * marker — **unconditionally**, even if the active file is absent/empty, so
+ * state.db is never checked again. The row copy and marker write share one
+ * transaction (atomic); the source rename happens after commit.
+ *
+ * Returns null if the marker was already set (no-op). Satellite files missed by
+ * this one-off are recoverable via the manual `afx db consolidate <path>`.
+ */
+export function runBootConsolidation(globalDb) {
+    if (isConsolidationDone(globalDb))
+        return null;
+    const sourcePath = activeStateDbPath();
+    if (!existsSync(sourcePath)) {
+        // Strict: mark done even with nothing to migrate.
+        globalDb.transaction(() => writeMarker(globalDb, null, 0))();
+        return { sourcePath, migrated: false, renamedTo: null, stats: [] };
+    }
+    const { specs, stats, total } = prepareMigration(globalDb, sourcePath);
+    globalDb.transaction(() => {
+        copyRows(globalDb, specs);
+        writeMarker(globalDb, sourcePath, total);
+    })();
+    const renamedTo = renameWithSidecars(sourcePath);
+    return { sourcePath, migrated: true, renamedTo, stats };
+}
+//# sourceMappingURL=consolidate.js.map

package/dist/agent-farm/db/consolidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.js","sourceRoot":"","sources":["../../../src/agent-farm/db/consolidate.ts"],"names":[],"mappings":"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"}

package/dist/agent-farm/db/index.d.ts

@@ -6,8 +6,14 @@
  */
 import Database from 'better-sqlite3';
 /**
- * Get the local database instance (state.db)
- * Creates and initializes the database if it doesn't exist
+ * Get the database instance.
+ *
+ * Issue #1118: state.db is retired. getDb() now returns the single user-global
+ * global.db connection — the same instance as getGlobalDb(). Per-workspace rows
+ * (architect, builders) are disambiguated by their `workspace_path` column
+ * within the shared file, so the connection no longer depends on Tower's
+ * start-cwd. Kept as a distinct export so the many existing callsites that read
+ * dashboard state (architect/builders/utils/annotations) don't churn.
  */
 export declare function getDb(): Database.Database;
 /**
@@ -16,7 +22,9 @@ export declare function getDb(): Database.Database;
  */
 export declare function getGlobalDb(): Database.Database;
 /**
- * Close the local database connection
+ * Close the database connection.
+ * Issue #1118: getDb() aliases the global connection, so this closes the shared
+ * global.db. Kept for callsites that historically closed "the local db".
  */
 export declare function closeDb(): void;
 /**
@@ -28,7 +36,8 @@ export declare function closeGlobalDb(): void;
  */
 export declare function closeAllDbs(): void;
 /**
- * Get the path to the local database
+ * Get the path to the database.
+ * Issue #1118: the local db path is now the global db path.
  */
 export declare function getDbPath(): string;
 /**

package/dist/agent-farm/db/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA0CtC;;;GAGG;AACH,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAKzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAK/C;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AA8yBD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAyCtC;;;;;;;;;GASG;AACH,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAEzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AA8ZD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,YAAY,GACb,MAAM,YAAY,CAAC"}