devsmind-mcp 2.3.0 → 3.0.0

package/dist/db/message-revert.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.revertMessage = revertMessage;
+exports.unrevertMessage = unrevertMessage;
+exports.revertMessageFile = revertMessageFile;
+exports.unrevertMessageFile = unrevertMessageFile;
+exports.revertMessageEdit = revertMessageEdit;
+exports.unrevertMessageEdit = unrevertMessageEdit;
+const activity_1 = require("./activity");
+const edit_1 = require("../utils/edit");
+const ast_1 = require("../utils/ast");
+/** All messages, oldest-created first — the timeline order the stack model operates over. */
+function timeline(devmindPath) {
+    return (0, activity_1.listMessages)(devmindPath).slice().sort((a, b) => a.created_at.localeCompare(b.created_at));
+}
+/**
+ * Applies one edit's `from` -> `to` text via the same exact-match, atomic-write primitive
+ * `edit_node` uses. A failure here means the file has drifted since this edit was recorded — a
+ * hand-edit, a pull, a later message's edit to the same text, anything — and is reported rather
+ * than forced. This exact-match requirement is also what makes file-level and single-edit revert
+ * safe without any separate "is this the newest" bookkeeping: an edit whose recorded text isn't
+ * uniquely present anymore simply can't be applied, whatever the reason.
+ */
+function applyEdit(edit, from, to) {
+    if (from === to)
+        return { ok: true }; // a no-op edit (e.g. before === after) has nothing to write
+    const r = (0, edit_1.replaceTextInFile)(edit.file_path, from, to, false);
+    if (!r.ok)
+        return { ok: false, error: r.error };
+    (0, ast_1.invalidateParsedFile)(edit.file_path);
+    return { ok: true };
+}
+/**
+ * Reverts one message's edits as a single atomic unit: newest edit first (later edits to the same
+ * node were built on earlier ones, so they must come off in reverse), and if any edit can't be
+ * applied, everything from this same message that DID succeed in this attempt is rolled back
+ * immediately — a message is never left half-reverted by THIS call. (It can still end up
+ * `partial` from an earlier, separate file/edit-level revert — this function skips edits already
+ * in the target state rather than re-applying them, so it composes safely with that.)
+ */
+function revertOneMessageAtomically(message) {
+    const newestFirst = message.edits.slice().reverse();
+    const applied = [];
+    for (const edit of newestFirst) {
+        if (edit.reverted)
+            continue; // already reverted via a granular action — nothing to do
+        const r = applyEdit(edit, edit.after, edit.before);
+        if (!r.ok) {
+            // Undo in LIFO order — the most recently reverted edit must come off first. `applied` was
+            // built newest-edit-first, so `applied[0]` was reverted first and must be un-reverted LAST;
+            // reversing the array puts the most recent action first, exactly as a proper undo requires.
+            for (const undo of applied.slice().reverse()) {
+                applyEdit(undo, undo.before, undo.after); // best-effort; started from a known-good state
+                undo.reverted = false;
+            }
+            return { ok: false, error: `${edit.node_id}: ${r.error}` };
+        }
+        edit.reverted = true;
+        applied.push(edit);
+    }
+    return { ok: true };
+}
+/** Symmetric to revertOneMessageAtomically: oldest edit first, same rollback-on-failure guarantee. */
+function unrevertOneMessageAtomically(message) {
+    const oldestFirst = message.edits;
+    const applied = [];
+    for (const edit of oldestFirst) {
+        if (!edit.reverted)
+            continue; // already applied — nothing to restore
+        const r = applyEdit(edit, edit.before, edit.after);
+        if (!r.ok) {
+            for (const undo of applied.slice().reverse()) {
+                applyEdit(undo, undo.after, undo.before);
+                undo.reverted = true;
+            }
+            return { ok: false, error: `${edit.node_id}: ${r.error}` };
+        }
+        edit.reverted = false;
+        applied.push(edit);
+    }
+    return { ok: true };
+}
+/**
+ * Reverts `messageId` and every message after it that isn't already fully reverted — the stack
+ * model: later messages were built on top of earlier ones, so undoing one partway through the
+ * stack undoes everything above it too, newest first. Stops at the first message that can't be
+ * fully reverted (a drifted edit) and reports which; everything reverted before that point in
+ * this call stays reverted. A `partial` message (touched by an earlier file/edit-level revert)
+ * counts as "not yet fully reverted" and is swept up here too, finishing the job on it.
+ */
+function revertMessage(devmindPath, messageId) {
+    const target = (0, activity_1.readMessage)(devmindPath, messageId);
+    if (!target)
+        return { ok: false, reverted: [], blocked_at: { message_id: messageId, reason: 'message not found' } };
+    if (target.status === 'reverted') {
+        return { ok: false, reverted: [], blocked_at: { message_id: messageId, reason: 'already reverted' } };
+    }
+    const all = timeline(devmindPath);
+    const targetIndex = all.findIndex(m => m.id === messageId);
+    // Newest-first: everything from the end of the timeline down to (and including) the target.
+    const candidates = all.slice(targetIndex).filter(m => m.status !== 'reverted').reverse();
+    const reverted = [];
+    for (const message of candidates) {
+        const result = revertOneMessageAtomically(message);
+        if (!result.ok) {
+            message.status = (0, activity_1.deriveStatus)(message.edits);
+            (0, activity_1.saveMessage)(devmindPath, message);
+            return { ok: reverted.length > 0, reverted, blocked_at: { message_id: message.id, reason: result.error } };
+        }
+        message.status = (0, activity_1.deriveStatus)(message.edits);
+        message.updated_at = new Date().toISOString();
+        (0, activity_1.saveMessage)(devmindPath, message);
+        reverted.push(message.id);
+    }
+    return { ok: true, reverted };
+}
+/**
+ * Re-applies exactly one message: the OLDEST currently-**fully**-reverted one. Un-revert restores
+ * up the stack in the order things came off it — out-of-order restoration would recreate the same
+ * "later edit built on code that isn't there yet" hazard the revert direction guards against, so
+ * it's refused rather than attempted. A `partial` message wasn't produced by that cascade — it was
+ * touched by a surgical file/edit-level revert — so it can be un-reverted independently of the
+ * fully-reverted stack's ordering.
+ */
+function unrevertMessage(devmindPath, messageId) {
+    const target = (0, activity_1.readMessage)(devmindPath, messageId);
+    if (!target)
+        return { ok: false, error: 'message not found' };
+    if (target.status === 'applied')
+        return { ok: false, error: 'message is not reverted — nothing to restore' };
+    if (target.status === 'reverted') {
+        const reverted = timeline(devmindPath).filter(m => m.status === 'reverted');
+        const oldest = reverted[0];
+        /* istanbul ignore next -- unreachable: `target.status === 'reverted'` (just checked above) means
+           `target` itself is in `timeline(devmindPath)` with status 'reverted', so `reverted` can never
+           be empty here. Kept as a real guard (not just a comment) in case that invariant ever breaks. */
+        if (!oldest)
+            return { ok: false, error: 'no reverted messages found' };
+        if (oldest.id !== messageId) {
+            return {
+                ok: false,
+                error: `un-revert must restore the oldest reverted message first: "${oldest.summary}" (${oldest.id}). Restore that one before this one.`
+            };
+        }
+    }
+    const result = unrevertOneMessageAtomically(target);
+    if (!result.ok) {
+        target.status = (0, activity_1.deriveStatus)(target.edits);
+        (0, activity_1.saveMessage)(devmindPath, target);
+        return { ok: false, error: result.error };
+    }
+    target.status = (0, activity_1.deriveStatus)(target.edits);
+    target.updated_at = new Date().toISOString();
+    (0, activity_1.saveMessage)(devmindPath, target);
+    return { ok: true, message_id: target.id };
+}
+/**
+ * Reverts just the edits ONE file picked up within ONE message, leaving the message's other
+ * files untouched. Newest-edit-first within that file, atomic (rolls back this operation's own
+ * partial progress on failure, same as the whole-message path) — never leaves this one file
+ * half-reverted, though the message as a whole is expected to end up `partial`.
+ */
+function revertMessageFile(devmindPath, messageId, filePath) {
+    const message = (0, activity_1.readMessage)(devmindPath, messageId);
+    if (!message)
+        return { ok: false, error: 'message not found' };
+    const fileEdits = message.edits.filter(e => e.file_path === filePath && !e.reverted);
+    if (!fileEdits.length)
+        return { ok: false, error: 'no applied edits for this file in this message' };
+    const newestFirst = fileEdits.slice().reverse();
+    const applied = [];
+    for (const edit of newestFirst) {
+        const r = applyEdit(edit, edit.after, edit.before);
+        if (!r.ok) {
+            for (const undo of applied.slice().reverse()) {
+                applyEdit(undo, undo.before, undo.after);
+                undo.reverted = false;
+            }
+            return { ok: false, error: `${edit.node_id}: ${r.error}` };
+        }
+        edit.reverted = true;
+        applied.push(edit);
+    }
+    message.status = (0, activity_1.deriveStatus)(message.edits);
+    message.updated_at = new Date().toISOString();
+    (0, activity_1.saveMessage)(devmindPath, message);
+    return { ok: true, edit_ids: applied.map(e => e.id) };
+}
+/** Symmetric to revertMessageFile: oldest-edit-first, same atomic rollback. */
+function unrevertMessageFile(devmindPath, messageId, filePath) {
+    const message = (0, activity_1.readMessage)(devmindPath, messageId);
+    if (!message)
+        return { ok: false, error: 'message not found' };
+    const fileEdits = message.edits.filter(e => e.file_path === filePath && e.reverted);
+    if (!fileEdits.length)
+        return { ok: false, error: 'no reverted edits for this file in this message' };
+    const applied = [];
+    for (const edit of fileEdits) {
+        const r = applyEdit(edit, edit.before, edit.after);
+        if (!r.ok) {
+            for (const undo of applied.slice().reverse()) {
+                applyEdit(undo, undo.after, undo.before);
+                undo.reverted = true;
+            }
+            return { ok: false, error: `${edit.node_id}: ${r.error}` };
+        }
+        edit.reverted = false;
+        applied.push(edit);
+    }
+    message.status = (0, activity_1.deriveStatus)(message.edits);
+    message.updated_at = new Date().toISOString();
+    (0, activity_1.saveMessage)(devmindPath, message);
+    return { ok: true, edit_ids: applied.map(e => e.id) };
+}
+/**
+ * Reverts exactly ONE edit, identified by its stable `id`, regardless of what else in the message
+ * or file is applied. Safe by construction: if a later edit (to the same node, in this message or
+ * a later one) already changed this text further, this edit's `after` string won't be found on
+ * disk anymore and the exact-match guard in applyEdit refuses rather than guessing.
+ */
+function revertMessageEdit(devmindPath, messageId, editId) {
+    const message = (0, activity_1.readMessage)(devmindPath, messageId);
+    if (!message)
+        return { ok: false, error: 'message not found' };
+    const edit = message.edits.find(e => e.id === editId);
+    if (!edit)
+        return { ok: false, error: 'edit not found in this message' };
+    if (edit.reverted)
+        return { ok: false, error: 'already reverted' };
+    const r = applyEdit(edit, edit.after, edit.before);
+    if (!r.ok)
+        return { ok: false, error: r.error };
+    edit.reverted = true;
+    message.status = (0, activity_1.deriveStatus)(message.edits);
+    message.updated_at = new Date().toISOString();
+    (0, activity_1.saveMessage)(devmindPath, message);
+    return { ok: true };
+}
+/** Symmetric to revertMessageEdit. */
+function unrevertMessageEdit(devmindPath, messageId, editId) {
+    const message = (0, activity_1.readMessage)(devmindPath, messageId);
+    if (!message)
+        return { ok: false, error: 'message not found' };
+    const edit = message.edits.find(e => e.id === editId);
+    if (!edit)
+        return { ok: false, error: 'edit not found in this message' };
+    if (!edit.reverted)
+        return { ok: false, error: 'not reverted' };
+    const r = applyEdit(edit, edit.before, edit.after);
+    if (!r.ok)
+        return { ok: false, error: r.error };
+    edit.reverted = false;
+    message.status = (0, activity_1.deriveStatus)(message.edits);
+    message.updated_at = new Date().toISOString();
+    (0, activity_1.saveMessage)(devmindPath, message);
+    return { ok: true };
+}
+//# sourceMappingURL=message-revert.js.map

package/dist/db/message-revert.js.map

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

package/dist/db/revert.d.ts

@@ -0,0 +1,31 @@
+import { DevMindDatabase } from './database';
+export interface RevertResult {
+    ok: boolean;
+    error?: string;
+    node_id?: string;
+    file_path?: string;
+    /** True when the change was still staged, so there was no recorded history to unwind. */
+    was_staged?: boolean;
+    entry_deleted?: boolean;
+    /** Set when the code was restored but the history entry could not be fully removed. */
+    note?: string;
+}
+/**
+ * Undoes the most recent recorded edit to one entity: restores the file, then erases what was
+ * written about it.
+ *
+ * Only the newest edit is reversible. An older one cannot be undone in isolation — every edit
+ * after it was made against the code it produced, so putting its "before" back would overwrite
+ * work that has nothing to do with it. Git is the tool for that, and it already does it properly.
+ *
+ * `expectedHistoryId`, when given, is the specific entry the caller intended to revert (e.g. the
+ * one a "Revert this change" button was clicked on). It must match the node's actual latest entry
+ * — if it doesn't (a newer entry was recorded since, perhaps from another session), the revert is
+ * refused rather than silently reverting that newer entry instead, which would undo the wrong
+ * change from the caller's point of view.
+ *
+ * The file is restored by swapping the recorded `after` back to the recorded `before`, which
+ * routes through the same exact-match write `edit_node` uses: if that text is no longer uniquely
+ * present, the write is refused rather than guessed at.
+ */
+export declare function revertLastEdit(db: DevMindDatabase, devmindPath: string, nodeId: string, expectedHistoryId?: string): RevertResult;

package/dist/db/revert.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.revertLastEdit = revertLastEdit;
+const staging_1 = require("./staging");
+const edit_1 = require("../utils/edit");
+const ast_1 = require("../utils/ast");
+/**
+ * Undoes the most recent recorded edit to one entity: restores the file, then erases what was
+ * written about it.
+ *
+ * Only the newest edit is reversible. An older one cannot be undone in isolation — every edit
+ * after it was made against the code it produced, so putting its "before" back would overwrite
+ * work that has nothing to do with it. Git is the tool for that, and it already does it properly.
+ *
+ * `expectedHistoryId`, when given, is the specific entry the caller intended to revert (e.g. the
+ * one a "Revert this change" button was clicked on). It must match the node's actual latest entry
+ * — if it doesn't (a newer entry was recorded since, perhaps from another session), the revert is
+ * refused rather than silently reverting that newer entry instead, which would undo the wrong
+ * change from the caller's point of view.
+ *
+ * The file is restored by swapping the recorded `after` back to the recorded `before`, which
+ * routes through the same exact-match write `edit_node` uses: if that text is no longer uniquely
+ * present, the write is refused rather than guessed at.
+ */
+function revertLastEdit(db, devmindPath, nodeId, expectedHistoryId) {
+    const node = db.getNode(nodeId);
+    const resolvedId = node ? node.id : nodeId;
+    // Staged edits are the newest thing that happened, and were never recorded — undo those first,
+    // or a revert would restore the file underneath a staged entry still waiting to be committed.
+    const staged = (0, staging_1.readStaged)(devmindPath).filter(e => e.node_id === resolvedId);
+    if (staged.length) {
+        const last = staged[staged.length - 1];
+        if (last.code_before === undefined) {
+            return { ok: false, error: `The staged change to ${resolvedId} has no recorded before-state, so it cannot be undone here. Use git to restore the file.` };
+        }
+        const restored = restoreFile(last.file_path, last.code_snapshot, last.code_before ?? '');
+        if (!restored.ok)
+            return { ok: false, error: restored.error, node_id: resolvedId, file_path: last.file_path };
+        (0, staging_1.removeLastStagedEntry)(devmindPath, resolvedId);
+        return { ok: true, node_id: resolvedId, file_path: last.file_path, was_staged: true };
+    }
+    const entry = db.getLatestHistory(resolvedId);
+    if (!entry)
+        return { ok: false, error: `No history recorded for ${resolvedId} — nothing to revert.` };
+    if (expectedHistoryId && entry.id !== expectedHistoryId) {
+        return {
+            ok: false,
+            error: `A newer change to ${resolvedId} was recorded since this one — reverting it would undo that newer change instead. Refresh and revert the newest entry, or use git.`,
+            node_id: resolvedId
+        };
+    }
+    if (!entry.edits.length) {
+        return {
+            ok: false,
+            error: `The last change to ${resolvedId} was recorded without a before-state, so there is nothing to restore it to. Entries written before edit_node tracked diffs, and entries from stage_change (non-TS/JS files), are both like this. Use git to restore the file.`
+        };
+    }
+    const last = entry.edits[entry.edits.length - 1];
+    if (!node)
+        return { ok: false, error: `${resolvedId} has history but no node in the graph — cannot locate its file.` };
+    // The recorded `after` must still be what is on disk. If it isn't, the code moved on after this
+    // edit and restoring `before` would silently discard whatever came since.
+    const live = db.getLiveCode(resolvedId);
+    if (live.source !== 'live' || live.code === undefined) {
+        return {
+            ok: false,
+            error: `Could not read ${resolvedId} from disk to confirm what is there now (the symbol may have been renamed, moved, or deleted). Revert refused — use git.`,
+            node_id: resolvedId
+        };
+    }
+    if (live.code !== last.after) {
+        return {
+            ok: false,
+            error: `${resolvedId} has changed since that edit was recorded — reverting would discard the newer change. Revert refused; use git to restore the file.`,
+            node_id: resolvedId,
+            file_path: node.file_path
+        };
+    }
+    const restored = restoreFile(node.file_path, last.after, last.before);
+    if (!restored.ok)
+        return { ok: false, error: restored.error, node_id: resolvedId, file_path: node.file_path };
+    const erased = db.eraseLastEdit(entry.id);
+    return {
+        ok: true,
+        node_id: resolvedId,
+        file_path: node.file_path,
+        entry_deleted: erased.entry_deleted,
+        note: erased.entry_deleted ? undefined : erased.reason
+    };
+}
+/**
+ * Swaps `after` back to `before` in the file.
+ *
+ * `before` is empty when the edit created the entity, so the revert deletes it — which is the
+ * correct inverse, and the one case where the two strings could not both be present.
+ */
+function restoreFile(filePath, after, before) {
+    const paths = String(filePath).split(',').map(s => s.trim()).filter(Boolean);
+    const target = paths[0];
+    if (!target)
+        return { ok: false, error: 'no file path recorded for this entity' };
+    const r = (0, edit_1.replaceTextInFile)(target, after, before, false);
+    if (!r.ok)
+        return { ok: false, error: `could not restore ${target}: ${r.error}` };
+    (0, ast_1.invalidateParsedFile)(target);
+    return { ok: true };
+}
+//# sourceMappingURL=revert.js.map

package/dist/db/revert.js.map

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

package/dist/db/schema.d.ts

@@ -4,6 +4,22 @@ export interface DbNode {
     name: string;
     file_path: string;
     signature: string | null;
+    /**
+     * A 1-3 sentence natural-language description of what this entity does — the thing a plain
+     * identifier can't carry. This is what makes `search_nodes` findable by natural language
+     * instead of only by exact identifier/path substring. Null until an agent (or `devsmind
+     * describe`) writes one; `commit_changes` refuses to create a NEW node without it.
+     */
+    description: string | null;
+    /**
+     * Other names this SAME entity is referenced by — a generated hook (`useGetAdminOrdersQuery`
+     * for an RTK `getAdminOrders` endpoint), a renamed default-export import, or an `export { x as
+     * y }` re-export. One implementation, several exported handles: this is what lets the edge
+     * resolver match a caller against ANY of them instead of only the entity's own declared name,
+     * which is the fix for edges that otherwise can't exist because the reference in the code never
+     * spells out the original name at all. Empty array, not null, when there are none.
+     */
+    aliases: string[];
     deprecated: number;
     created_at: string;
 }
@@ -11,6 +27,13 @@ export interface DbConnection {
     source_node_id: string;
     target_node_id: string;
 }
+/** One recorded edit within a history entry — what the code looked like either side of it. */
+export interface HistoryEdit {
+    at: string;
+    before: string;
+    after: string;
+    reasoning: string;
+}
 export interface DbHistory {
     id: string;
     node_id: string;
@@ -19,12 +42,21 @@ export interface DbHistory {
     updated_at: string;
     code_snapshot: string;
     reasoning: string;
+    /**
+     * Per-edit before/after trail, newest last. Lives only in the history JSON, never in SQLite —
+     * same as code_snapshot. Empty for entries written before this existed, and for `stage_change`
+     * entries, which have no before-state to record: both mean "no diff, no revert".
+     */
+    edits: HistoryEdit[];
 }
 export interface DbWorkflow {
     id: string;
     name: string;
     description: string;
-    status: 'active' | 'paused' | 'completed';
+    /** 1 = hidden from the default listing. Replaces the old `status` field: nothing ever genuinely
+     * "completes" — a feature keeps getting changed — so a completed/paused/active lifecycle was a
+     * value nobody maintained. "Archived" claims only what it can deliver: hide this from the list. */
+    archived: number;
     created_at: string;
     updated_at: string;
 }
@@ -33,8 +65,21 @@ export interface DbWorkflowStep {
     workflow_id: string;
     step_index: number;
     summary: string;
-    pending_tasks: string | null;
-    history_ids: string | null;
+    /** The commit's own `why`/`goal`/`decision`, copied at write time rather than joined from
+     * `history`. Deliberate duplication: history reasoning MUTATES after the fact (the 1-hour merge
+     * appends under a `── Update @ … ──` separator, and eraseLastEdit can drop a block), so a step
+     * that joined to it would describe a moving target — disqualifying for a record whose whole
+     * purpose is "what did we think at the time". */
+    reasoning: string | null;
+    /** JSON array of the node ids this step touched. Replaces `history_ids`, which could not
+     * identify a commit: within an hour, two commits on the same node merge into ONE history row,
+     * so a step's ids could point at rows an earlier commit created, and one row could be cited by
+     * several steps. Node ids have no such ambiguity and are directly usable with get_node_code. */
+    node_ids: string | null;
+    /** JSON array of repo-relative paths to research/spec docs behind this step. A path, never a
+     * copy: the file is already versioned and already shared, so it cannot go stale the way the old
+     * `workflow_artifacts` content duplicates did. */
+    doc_paths: string | null;
     session_id: string | null;
     created_at: string;
 }
@@ -47,4 +92,4 @@ export interface DbWorkflowArtifact {
     file_path: string;
     created_at: string;
 }
-export declare const INIT_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS nodes (\n  id          TEXT PRIMARY KEY,\n  type        TEXT NOT NULL,\n  name        TEXT NOT NULL,\n  file_path   TEXT NOT NULL,\n  signature   TEXT,\n  deprecated  INTEGER DEFAULT 0,\n  created_at  DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE TABLE IF NOT EXISTS node_connections (\n  source_node_id  TEXT,\n  target_node_id  TEXT,\n  PRIMARY KEY (source_node_id, target_node_id),\n  FOREIGN KEY (source_node_id) REFERENCES nodes (id) ON DELETE CASCADE,\n  FOREIGN KEY (target_node_id) REFERENCES nodes (id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS history (\n  id             TEXT PRIMARY KEY,\n  node_id        TEXT NOT NULL,\n  session_id     TEXT NOT NULL,\n  created_at     DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at     DATETIME DEFAULT CURRENT_TIMESTAMP,\n  code_snapshot  TEXT NOT NULL,\n  reasoning      TEXT NOT NULL,\n  FOREIGN KEY (node_id) REFERENCES nodes (id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS system_meta (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE TABLE IF NOT EXISTS workflows (\n  id           TEXT PRIMARY KEY,\n  name         TEXT NOT NULL,\n  description  TEXT NOT NULL,\n  status       TEXT NOT NULL DEFAULT 'active',\n  created_at   DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at   DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE TABLE IF NOT EXISTS workflow_steps (\n  id             TEXT PRIMARY KEY,\n  workflow_id    TEXT NOT NULL,\n  step_index     INTEGER NOT NULL,\n  summary        TEXT NOT NULL,\n  pending_tasks  TEXT,\n  history_ids    TEXT,\n  session_id     TEXT,\n  created_at     DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (workflow_id) REFERENCES workflows (id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS workflow_artifacts (\n  id            TEXT PRIMARY KEY,\n  workflow_id   TEXT NOT NULL,\n  step_id       TEXT,\n  type          TEXT NOT NULL,\n  source_name   TEXT NOT NULL,\n  file_path     TEXT NOT NULL,\n  created_at    DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (workflow_id) REFERENCES workflows (id) ON DELETE CASCADE\n);\n\n-- Index for searching nodes by name and type\nCREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes (name);\nCREATE INDEX IF NOT EXISTS idx_history_node_id ON history (node_id);\nCREATE INDEX IF NOT EXISTS idx_workflow_steps_workflow_id ON workflow_steps (workflow_id);\nCREATE INDEX IF NOT EXISTS idx_workflow_artifacts_workflow_id ON workflow_artifacts (workflow_id);\n";
+export declare const INIT_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS nodes (\n  id          TEXT PRIMARY KEY,\n  type        TEXT NOT NULL,\n  name        TEXT NOT NULL,\n  file_path   TEXT NOT NULL,\n  signature   TEXT,\n  description TEXT,\n  aliases     TEXT DEFAULT '[]',\n  deprecated  INTEGER DEFAULT 0,\n  created_at  DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE TABLE IF NOT EXISTS node_connections (\n  source_node_id  TEXT,\n  target_node_id  TEXT,\n  PRIMARY KEY (source_node_id, target_node_id),\n  FOREIGN KEY (source_node_id) REFERENCES nodes (id) ON DELETE CASCADE,\n  FOREIGN KEY (target_node_id) REFERENCES nodes (id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS history (\n  id             TEXT PRIMARY KEY,\n  node_id        TEXT NOT NULL,\n  session_id     TEXT NOT NULL,\n  created_at     DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at     DATETIME DEFAULT CURRENT_TIMESTAMP,\n  code_snapshot  TEXT NOT NULL,\n  reasoning      TEXT NOT NULL,\n  FOREIGN KEY (node_id) REFERENCES nodes (id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS system_meta (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\n-- Local, derived search index \u2014 never synced or committed, purely a cache rebuilt from\n-- nodes+history whenever search-index.ts's fingerprint check finds it stale. Same category as\n-- brain.db itself: safe to wipe and rebuild from the source of truth at any time.\nCREATE TABLE IF NOT EXISTS node_tokens (\n  node_id  TEXT NOT NULL,\n  token    TEXT NOT NULL,\n  field    TEXT NOT NULL,\n  tf       INTEGER NOT NULL DEFAULT 1,\n  PRIMARY KEY (node_id, token, field)\n);\nCREATE INDEX IF NOT EXISTS idx_node_tokens_token ON node_tokens (token);\n\n-- Semantic (dense) vectors, one per node, from the vendored ONNX embedder (src/db/embedder.ts).\n-- Unlike node_tokens, these ARE synced via git (vectors/**/*.json, mirroring graph/**/*.json) \u2014\n-- deliberately, per an explicit product decision to trade repo size for teammates skipping local\n-- inference. No foreign key to nodes(id): syncFromDisk() runs its destructive graph pass under\n-- foreign_keys=OFF, so a cascade here would silently never fire; orphans are swept explicitly\n-- instead (see syncFromDisk's vectors pass). model_id guards the git-sync hazard \u2014 vectors from\n-- a different embedding model are structurally valid but numerically meaningless, so any reader\n-- MUST check model_id before trusting a row, not just check for its presence.\nCREATE TABLE IF NOT EXISTS node_vectors (\n  node_id          TEXT PRIMARY KEY,\n  model_id         TEXT NOT NULL,\n  dim              INTEGER NOT NULL,\n  description_hash TEXT NOT NULL,\n  vector           BLOB NOT NULL\n);\n\n-- status is vestigial: still declared (NOT NULL DEFAULT makes an INSERT that omits it succeed)\n-- but no longer read or written. archived replaces it -- see DbWorkflow.\nCREATE TABLE IF NOT EXISTS workflows (\n  id           TEXT PRIMARY KEY,\n  name         TEXT NOT NULL,\n  description  TEXT NOT NULL,\n  status       TEXT NOT NULL DEFAULT 'active',\n  archived     INTEGER NOT NULL DEFAULT 0,\n  created_at   DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at   DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\n-- pending_tasks and history_ids are vestigial: never written or read by current code, and kept\n-- only so an older CLI opening the same brain.db does not hit \"no such column\". They are dropped\n-- from DbWorkflowStep, so nothing in TypeScript can reach them by accident.\nCREATE TABLE IF NOT EXISTS workflow_steps (\n  id             TEXT PRIMARY KEY,\n  workflow_id    TEXT NOT NULL,\n  step_index     INTEGER NOT NULL,\n  summary        TEXT NOT NULL,\n  reasoning      TEXT,\n  node_ids       TEXT,\n  doc_paths      TEXT,\n  pending_tasks  TEXT,\n  history_ids    TEXT,\n  session_id     TEXT,\n  created_at     DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (workflow_id) REFERENCES workflows (id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS workflow_artifacts (\n  id            TEXT PRIMARY KEY,\n  workflow_id   TEXT NOT NULL,\n  step_id       TEXT,\n  type          TEXT NOT NULL,\n  source_name   TEXT NOT NULL,\n  file_path     TEXT NOT NULL,\n  created_at    DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (workflow_id) REFERENCES workflows (id) ON DELETE CASCADE\n);\n\n-- Index for searching nodes by name and type\nCREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes (name);\n-- Matches getNodesByFilePath's own normalization (REPLACE(LOWER(file_path), '', '/')) exactly \u2014\n-- without this, that call is a full table scan, and get_node_code's file_outline now puts it on\n-- the hot path of the most-called read tool (once per call, to cross-reference outline entries\n-- against indexed nodes). Idempotent: existing brains pick this up on next open, no migration.\nCREATE INDEX IF NOT EXISTS idx_nodes_file_path ON nodes (REPLACE(LOWER(file_path), '', '/'));\n-- node_connections' PRIMARY KEY is (source_node_id, target_node_id), so its autoindex serves\n-- \"what does X use\" but NOT the reverse. Every \"who uses X\" lookup \u2014 the inbound half of getGraph's\n-- BFS, getConnections' used_by, getConnectionCounts \u2014 was therefore a full table scan, and the BFS\n-- runs one PER NODE VISITED (up to 500 in a single call). The trailing source_node_id makes this\n-- covering, so the inbound query is answered from the index alone and comes back already ordered\n-- (which is what makes getGraph's ORDER BY free rather than a sort on top of a scan).\n-- Idempotent: existing brains pick this up on next open, no migration.\nCREATE INDEX IF NOT EXISTS idx_node_connections_target ON node_connections (target_node_id, source_node_id);\nCREATE INDEX IF NOT EXISTS idx_history_node_id ON history (node_id);\nCREATE INDEX IF NOT EXISTS idx_workflow_steps_workflow_id ON workflow_steps (workflow_id);\nCREATE INDEX IF NOT EXISTS idx_workflow_artifacts_workflow_id ON workflow_artifacts (workflow_id);\n";