homegraph 1.4.1 → 1.5.1

package/dist/spec/db/relations.d.ts

@@ -31,7 +31,7 @@ export declare function transferSpecCommitRelations(db: SqliteDatabase, fromSpec
  * Link a commit to a code fragment.
  * `INSERT OR IGNORE` — duplicates are silently skipped.
  */
-export declare function insertCommitFragmentRelation(db: SqliteDatabase, commitHash: string, fragmentId: string): void;
+export declare function insertCommitFragmentRelation(db: SqliteDatabase, commitHash: string, fragmentId: string, relationType: RelationType): void;
 /**
  * Insert a relation between two specs (SIMILAR_TO or EVOLVED_FROM).
  * `INSERT OR IGNORE` — duplicates are silently skipped.
@@ -52,4 +52,83 @@ export declare function transferSpecSpecRelations(db: SqliteDatabase, fromSpecId
  * Count total rows across all three relation tables.
  */
 export declare function countAllRelations(db: SqliteDatabase): number;
+/**
+ * Find all spec IDs related to code fragments whose file path matches
+ * the given substring (unescaped LIKE `%filePath%`).
+ */
+export declare function findSpecIdsByFragmentPath(db: SqliteDatabase, filePath: string): string[];
+/** Result container returned by findSpecsByFilePath. */
+export interface FindSpecsByFilePathResult {
+    /** Matching spec entries (capped at maxResults). */
+    results: Array<{
+        id: string;
+        title: string;
+        status: string;
+        version: number;
+        filePath: string;
+    }>;
+    /** Number of results actually returned (<= maxResults). */
+    matched_count: number;
+    /** True when more results exist beyond the cap. */
+    truncated: boolean;
+}
+/**
+ * Find specs whose code fragments reference the given file path.
+ *
+ * Traverses: filePath -> code_fragment_nodes -> commit_fragment_relations
+ * -> commit_nodes -> spec_commit_relations -> spec_nodes.
+ *
+ * Uses LIKE matching against code_fragment_nodes.file_path, so partial
+ * paths work (e.g. `src/auth.ts` matches `src/auth/login.ts` and
+ * `app/src/auth.ts`).  LIKE metacharacters (`%`, `_`, `\`) in the
+ * filePath are automatically escaped.
+ *
+ * An empty or whitespace-only filePath is rejected with an error
+ * (it would match every spec in the graph).
+ */
+export declare function findSpecsByFilePath(db: SqliteDatabase, filePath: string, maxResults?: number): FindSpecsByFilePathResult;
+/**
+ * A candidate spec for code-entity matching, with aggregate signals
+ * computed in SQL (line overlap, fragment/commit counts, path match level).
+ */
+export interface SpecCandidate {
+    id: string;
+    title: string;
+    status: string;
+    version: number;
+    filePath: string;
+    timestamp: number;
+    /** Overlapping line count between the entity range and the best fragment. */
+    overlapLines: number;
+    /** Number of distinct fragments linking this spec to the entity's file. */
+    fragmentCount: number;
+    /** Number of distinct commits linking this spec to the entity's file. */
+    commitCount: number;
+    /** 3 = exact path, 2 = suffix match, 1 = substring LIKE match. */
+    filePathMatchLevel: number;
+}
+/**
+ * Gather candidate specs whose fragments touch the given file path, with
+ * per-spec aggregate signals for downstream scoring. Only active specs are
+ * considered.
+ */
+export declare function findSpecCandidatesByFilePath(db: SqliteDatabase, params: {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    maxCandidates: number;
+}): SpecCandidate[];
+/**
+ * Find all spec IDs linked (via commits) to any of the given fragment IDs.
+ */
+export declare function findSpecIdsByFragmentIds(db: SqliteDatabase, fragmentIds: string[]): string[];
+/**
+ * Return the distinct fragment file paths associated with a spec (via its
+ * commits' fragments).
+ */
+export declare function findFragmentPathsBySpec(db: SqliteDatabase, specId: string): string[];
+/**
+ * Filter a list of spec IDs down to those with status = 'active'.
+ */
+export declare function findActiveSpecIds(db: SqliteDatabase, specIds: string[]): string[];
 //# sourceMappingURL=relations.d.ts.map

package/dist/spec/db/relations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../src/spec/db/relations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAM5D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,GACzB,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GACb,KAAK,CAAC,kBAAkB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBpF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,cAAc,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAMN;AAMD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,cAAc,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAMN;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,YAAY,GACzB,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMjF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,cAAc,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CA6BN;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAa5D"}
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../src/spec/db/relations.ts"],"names":[],"mappings":"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"}

package/dist/spec/db/relations.js

@@ -15,6 +15,13 @@ exports.insertSpecSpecRelation = insertSpecSpecRelation;
 exports.deleteSimilarToRelations = deleteSimilarToRelations;
 exports.transferSpecSpecRelations = transferSpecSpecRelations;
 exports.countAllRelations = countAllRelations;
+exports.findSpecIdsByFragmentPath = findSpecIdsByFragmentPath;
+exports.findSpecsByFilePath = findSpecsByFilePath;
+exports.findSpecCandidatesByFilePath = findSpecCandidatesByFilePath;
+exports.findSpecIdsByFragmentIds = findSpecIdsByFragmentIds;
+exports.findFragmentPathsBySpec = findFragmentPathsBySpec;
+exports.findActiveSpecIds = findActiveSpecIds;
+const sql_utils_1 = require("./sql-utils");
 // ===========================================================================
 // Spec ↔ Commit Relations
 // ===========================================================================
@@ -23,10 +30,10 @@ exports.countAllRelations = countAllRelations;
  * `INSERT OR IGNORE` — duplicates are silently skipped.
  */
 function insertSpecCommitRelation(db, specId, commitHash, relationType) {
-    db.prepare(`
-    INSERT OR IGNORE INTO spec_commit_relations
-      (spec_id, commit_hash, relation_type)
-    VALUES (@specId, @commitHash, @relationType)
+    db.prepare(`
+    INSERT OR IGNORE INTO spec_commit_relations
+      (spec_id, commit_hash, relation_type)
+    VALUES (@specId, @commitHash, @relationType)
   `).run({ specId, commitHash, relationType });
 }
 /**
@@ -34,13 +41,13 @@ function insertSpecCommitRelation(db, specId, commitHash, relationType) {
  * (oldest first — matches Commit4Spec's mining pipeline sort).
  */
 function findCommitsBySpec(db, specId) {
-    const rows = db.prepare(`
-    SELECT r.commit_hash, r.relation_type,
-           c.message, c.author, c.timestamp
-    FROM spec_commit_relations r
-    JOIN commit_nodes c ON c.hash = r.commit_hash
-    WHERE r.spec_id = ?
-    ORDER BY c.timestamp ASC
+    const rows = db.prepare(`
+    SELECT r.commit_hash, r.relation_type,
+           c.message, c.author, c.timestamp
+    FROM spec_commit_relations r
+    JOIN commit_nodes c ON c.hash = r.commit_hash
+    WHERE r.spec_id = ?
+    ORDER BY c.timestamp ASC
   `).all(specId);
     return rows.map(r => ({
         specId,
@@ -57,10 +64,10 @@ function findCommitsBySpec(db, specId) {
  * old active spec's relations move to the deprecated record.
  */
 function transferSpecCommitRelations(db, fromSpecId, toSpecId) {
-    db.prepare(`
-    UPDATE spec_commit_relations
-    SET spec_id = @toSpecId
-    WHERE spec_id = @fromSpecId
+    db.prepare(`
+    UPDATE spec_commit_relations
+    SET spec_id = @toSpecId
+    WHERE spec_id = @fromSpecId
   `).run({ fromSpecId, toSpecId });
 }
 // ===========================================================================
@@ -70,12 +77,12 @@ function transferSpecCommitRelations(db, fromSpecId, toSpecId) {
  * Link a commit to a code fragment.
  * `INSERT OR IGNORE` — duplicates are silently skipped.
  */
-function insertCommitFragmentRelation(db, commitHash, fragmentId) {
-    db.prepare(`
-    INSERT OR IGNORE INTO commit_fragment_relations
-      (commit_hash, fragment_id)
-    VALUES (@commitHash, @fragmentId)
-  `).run({ commitHash, fragmentId });
+function insertCommitFragmentRelation(db, commitHash, fragmentId, relationType) {
+    db.prepare(`
+    INSERT OR IGNORE INTO commit_fragment_relations
+      (commit_hash, fragment_id, relation_type)
+    VALUES (@commitHash, @fragmentId, @relationType)
+  `).run({ commitHash, fragmentId, relationType });
 }
 // ===========================================================================
 // Spec ↔ Spec Relations
@@ -85,10 +92,10 @@ function insertCommitFragmentRelation(db, commitHash, fragmentId) {
  * `INSERT OR IGNORE` — duplicates are silently skipped.
  */
 function insertSpecSpecRelation(db, sourceId, targetId, relationType) {
-    db.prepare(`
-    INSERT OR IGNORE INTO spec_spec_relations
-      (source_id, target_id, relation_type)
-    VALUES (@sourceId, @targetId, @relationType)
+    db.prepare(`
+    INSERT OR IGNORE INTO spec_spec_relations
+      (source_id, target_id, relation_type)
+    VALUES (@sourceId, @targetId, @relationType)
   `).run({ sourceId, targetId, relationType });
 }
 /**
@@ -96,10 +103,10 @@ function insertSpecSpecRelation(db, sourceId, targetId, relationType) {
  * Called when a spec is deprecated (similarity links become stale).
  */
 function deleteSimilarToRelations(db, specId) {
-    db.prepare(`
-    DELETE FROM spec_spec_relations
-    WHERE relation_type = 'SIMILAR_TO'
-      AND (source_id = ? OR target_id = ?)
+    db.prepare(`
+    DELETE FROM spec_spec_relations
+    WHERE relation_type = 'SIMILAR_TO'
+      AND (source_id = ? OR target_id = ?)
   `).run(specId, specId);
 }
 /**
@@ -112,27 +119,27 @@ function transferSpecSpecRelations(db, fromSpecId, toSpecId) {
     // their own explicit BEGIN/COMMIT boundaries.
     // Delete rows at `toSpecId` that would collide with the rows being
     // transferred, so the UPDATE below cannot trigger a PRIMARY KEY conflict.
-    db.prepare(`
-    DELETE FROM spec_spec_relations
-    WHERE source_id = @toSpecId
-      AND (target_id, relation_type) IN (
-        SELECT target_id, relation_type FROM spec_spec_relations
-        WHERE source_id = @fromSpecId
-      )
+    db.prepare(`
+    DELETE FROM spec_spec_relations
+    WHERE source_id = @toSpecId
+      AND (target_id, relation_type) IN (
+        SELECT target_id, relation_type FROM spec_spec_relations
+        WHERE source_id = @fromSpecId
+      )
   `).run({ fromSpecId, toSpecId });
-    db.prepare(`
-    DELETE FROM spec_spec_relations
-    WHERE target_id = @toSpecId
-      AND (source_id, relation_type) IN (
-        SELECT source_id, relation_type FROM spec_spec_relations
-        WHERE target_id = @fromSpecId
-      )
+    db.prepare(`
+    DELETE FROM spec_spec_relations
+    WHERE target_id = @toSpecId
+      AND (source_id, relation_type) IN (
+        SELECT source_id, relation_type FROM spec_spec_relations
+        WHERE target_id = @fromSpecId
+      )
   `).run({ fromSpecId, toSpecId });
-    db.prepare(`
-    UPDATE spec_spec_relations SET source_id = @toSpecId WHERE source_id = @fromSpecId
+    db.prepare(`
+    UPDATE spec_spec_relations SET source_id = @toSpecId WHERE source_id = @fromSpecId
   `).run({ fromSpecId, toSpecId });
-    db.prepare(`
-    UPDATE spec_spec_relations SET target_id = @toSpecId WHERE target_id = @fromSpecId
+    db.prepare(`
+    UPDATE spec_spec_relations SET target_id = @toSpecId WHERE target_id = @fromSpecId
   `).run({ fromSpecId, toSpecId });
 }
 // ===========================================================================
@@ -155,4 +162,168 @@ function countAllRelations(db) {
     }
     return total;
 }
+// ===========================================================================
+// Cross-table traversal primitives
+//
+// Join queries that walk Spec → Commit → CodeFragment. These are the ONLY
+// home for this SQL — higher layers (graph/queries, evolve/impact-locator)
+// compose these primitives instead of writing their own joins.
+// ===========================================================================
+/**
+ * Find all spec IDs related to code fragments whose file path matches
+ * the given substring (unescaped LIKE `%filePath%`).
+ */
+function findSpecIdsByFragmentPath(db, filePath) {
+    const rows = db
+        .prepare(`SELECT DISTINCT r.spec_id
+       FROM spec_commit_relations r
+       JOIN commit_fragment_relations cfr ON cfr.commit_hash = r.commit_hash
+       JOIN code_fragment_nodes cf ON cf.id = cfr.fragment_id
+       WHERE cf.file_path LIKE ?`)
+        .all(`%${filePath}%`);
+    return rows.map((r) => r.spec_id);
+}
+/** Default max results returned by findSpecsByFilePath. */
+const DEFAULT_MAX_SPEC_FIND_RESULTS = 100;
+/**
+ * Find specs whose code fragments reference the given file path.
+ *
+ * Traverses: filePath -> code_fragment_nodes -> commit_fragment_relations
+ * -> commit_nodes -> spec_commit_relations -> spec_nodes.
+ *
+ * Uses LIKE matching against code_fragment_nodes.file_path, so partial
+ * paths work (e.g. `src/auth.ts` matches `src/auth/login.ts` and
+ * `app/src/auth.ts`).  LIKE metacharacters (`%`, `_`, `\`) in the
+ * filePath are automatically escaped.
+ *
+ * An empty or whitespace-only filePath is rejected with an error
+ * (it would match every spec in the graph).
+ */
+function findSpecsByFilePath(db, filePath, maxResults = DEFAULT_MAX_SPEC_FIND_RESULTS) {
+    // Guard against empty input that would match every spec
+    if (!filePath || filePath.trim().length === 0) {
+        throw new Error('Empty file path is not allowed -- it would match every spec in the knowledge graph. ' +
+            'Provide a concrete file path (e.g. "src/auth.ts") or a partial path (e.g. "src/auth").');
+    }
+    const pattern = `%${(0, sql_utils_1.escapeLike)(filePath)}%`;
+    const rows = db
+        .prepare(`SELECT DISTINCT s.id, s.title, s.status, s.version, s.file_path
+       FROM spec_nodes s
+       JOIN spec_commit_relations scr ON scr.spec_id = s.id
+       JOIN commit_fragment_relations cfr ON cfr.commit_hash = scr.commit_hash
+       JOIN code_fragment_nodes cf ON cf.id = cfr.fragment_id
+       WHERE cf.file_path LIKE ? ESCAPE '\\'
+       ORDER BY s.id
+       LIMIT ?`)
+        .all(pattern, maxResults + 1);
+    const truncated = rows.length > maxResults;
+    const slice = truncated ? rows.slice(0, maxResults) : rows;
+    return {
+        results: slice.map((r) => ({
+            id: r.id,
+            title: r.title,
+            status: r.status,
+            version: r.version,
+            filePath: r.file_path,
+        })),
+        matched_count: slice.length,
+        truncated,
+    };
+}
+/**
+ * Gather candidate specs whose fragments touch the given file path, with
+ * per-spec aggregate signals for downstream scoring. Only active specs are
+ * considered.
+ */
+function findSpecCandidatesByFilePath(db, params) {
+    const pathEscaped = (0, sql_utils_1.escapeLike)(params.filePath);
+    const rows = db
+        .prepare(`
+      SELECT
+          s.id, s.title, s.status, s.version, s.file_path, s.timestamp,
+          MAX(
+            MIN(cf.end_line, @entityEnd) - MAX(cf.start_line, @entityStart) + 1,
+            0
+          ) AS overlap_lines,
+          COUNT(DISTINCT cf.id) AS fragment_count,
+          COUNT(DISTINCT scr.commit_hash) AS commit_count,
+          MAX(CASE
+            WHEN cf.file_path = @exactFilePath THEN 3
+            WHEN cf.file_path LIKE @suffixLikePattern ESCAPE '\\' THEN 2
+            ELSE 1
+          END) AS file_path_match_level
+      FROM spec_nodes s
+      JOIN spec_commit_relations scr ON scr.spec_id = s.id
+      JOIN commit_fragment_relations cfr ON cfr.commit_hash = scr.commit_hash
+      JOIN code_fragment_nodes cf ON cf.id = cfr.fragment_id
+      WHERE s.status = 'active'
+        AND cf.file_path LIKE @likePattern ESCAPE '\\'
+      GROUP BY s.id
+      ORDER BY s.timestamp DESC
+      LIMIT @maxCandidates
+    `)
+        .all({
+        entityEnd: params.endLine,
+        entityStart: params.startLine,
+        exactFilePath: params.filePath,
+        suffixLikePattern: `%${pathEscaped}`,
+        likePattern: `%${pathEscaped}%`,
+        maxCandidates: params.maxCandidates,
+    });
+    return rows.map((r) => ({
+        id: r.id,
+        title: r.title,
+        status: r.status,
+        version: r.version,
+        filePath: r.file_path,
+        timestamp: r.timestamp,
+        overlapLines: r.overlap_lines,
+        fragmentCount: r.fragment_count,
+        commitCount: r.commit_count,
+        filePathMatchLevel: r.file_path_match_level,
+    }));
+}
+/**
+ * Find all spec IDs linked (via commits) to any of the given fragment IDs.
+ */
+function findSpecIdsByFragmentIds(db, fragmentIds) {
+    if (fragmentIds.length === 0)
+        return [];
+    const placeholders = fragmentIds.map(() => '?').join(',');
+    const rows = db
+        .prepare(`
+      SELECT DISTINCT scr.spec_id
+      FROM commit_fragment_relations cfr
+      JOIN spec_commit_relations scr ON scr.commit_hash = cfr.commit_hash
+      WHERE cfr.fragment_id IN (${placeholders})
+    `)
+        .all(...fragmentIds);
+    return rows.map((r) => r.spec_id);
+}
+/**
+ * Return the distinct fragment file paths associated with a spec (via its
+ * commits' fragments).
+ */
+function findFragmentPathsBySpec(db, specId) {
+    const rows = db
+        .prepare(`SELECT DISTINCT cf.file_path
+       FROM spec_commit_relations scr
+       JOIN commit_fragment_relations cfr ON cfr.commit_hash = scr.commit_hash
+       JOIN code_fragment_nodes cf ON cf.id = cfr.fragment_id
+       WHERE scr.spec_id = ?`)
+        .all(specId);
+    return rows.map((r) => r.file_path);
+}
+/**
+ * Filter a list of spec IDs down to those with status = 'active'.
+ */
+function findActiveSpecIds(db, specIds) {
+    if (specIds.length === 0)
+        return [];
+    const placeholders = specIds.map(() => '?').join(',');
+    const rows = db
+        .prepare(`SELECT id FROM spec_nodes WHERE status = 'active' AND id IN (${placeholders})`)
+        .all(...specIds);
+    return rows.map((r) => r.id);
+}
 //# sourceMappingURL=relations.js.map

package/dist/spec/db/relations.js.map

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

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

@@ -26,6 +26,10 @@ export declare function getCurrentSpecVersion(db: SqliteDatabase): number;
 /**
  * Run pending migrations.
  *
+ * NOTE: migration DDL mirrors statements in `schema.sql` (fresh databases
+ * get everything from the .sql file; migrations only patch pre-existing
+ * databases). Keep the two in sync when adding future migrations.
+ *
  * v1 → v2: Create code_fragments_fts virtual table and populate it
  * from existing code_fragment_nodes data.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/spec/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIzD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAMvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAwC/E"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/spec/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIzD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAMvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAShE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAwC/E"}

package/dist/spec/db/schema.js

@@ -81,6 +81,10 @@ function getCurrentSpecVersion(db) {
 /**
  * Run pending migrations.
  *
+ * NOTE: migration DDL mirrors statements in `schema.sql` (fresh databases
+ * get everything from the .sql file; migrations only patch pre-existing
+ * databases). Keep the two in sync when adding future migrations.
+ *
  * v1 → v2: Create code_fragments_fts virtual table and populate it
  * from existing code_fragment_nodes data.
  */
@@ -89,12 +93,12 @@ function runSpecMigrations(db, fromVersion) {
         // Create the FTS5 virtual table — the IF NOT EXISTS in schema.sql
         // handles the case where DDL already ran, but we explicitly run it
         // here for databases that existed before this migration was added.
-        db.exec(`
-      CREATE VIRTUAL TABLE IF NOT EXISTS code_fragments_fts USING fts5(
-          id,
-          file_path,
-          code_diff
-      );
+        db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS code_fragments_fts USING fts5(
+          id,
+          file_path,
+          code_diff
+      );
     `);
         // Populate FTS from existing code_fragment_nodes data
         const count = db.prepare('SELECT COUNT(*) as cnt FROM code_fragments_fts').get().cnt;

package/dist/spec/db/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/spec/db/schema.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBH,wCAMC;AAMD,sDASC;AAQD,8CAwCC;AApFD,uCAAyB;AACzB,2CAA6B;AAE7B;;;GAGG;AACU,QAAA,2BAA2B,GAAG,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,EAAkB;IAC/C,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,EAAkB;IACtD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,0DAA0D,CAAC;aACnE,GAAG,EAA4C,CAAC;QACnD,OAAO,GAAG,EAAE,OAAO,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,EAAkB,EAAE,WAAmB;IACvE,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,EAAE,CAAC,IAAI,CAAC;;;;;;KAMP,CAAC,CAAC;QAEH,sDAAsD;QACtD,MAAM,KAAK,GACT,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,EACjE,CAAC,GAAG,CAAC;QACN,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,EAAE;iBACZ,OAAO,CAAC,0DAA0D,CAAC;iBACnE,GAAG,EAAiE,CAAC;YAExE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,4EAA4E,CAC7E,CAAC;gBACF,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,SAAsE,EAAE,EAAE;oBAC3G,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;wBAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;oBAC7C,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,EAAE,CAAC,OAAO,CACR,oLAAoL,CACrL,CAAC,GAAG,EAAE,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/spec/db/schema.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBH,wCAMC;AAMD,sDASC;AAYD,8CAwCC;AAxFD,uCAAyB;AACzB,2CAA6B;AAE7B;;;GAGG;AACU,QAAA,2BAA2B,GAAG,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,EAAkB;IAC/C,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,EAAkB;IACtD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,0DAA0D,CAAC;aACnE,GAAG,EAA4C,CAAC;QACnD,OAAO,GAAG,EAAE,OAAO,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAAC,EAAkB,EAAE,WAAmB;IACvE,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,EAAE,CAAC,IAAI,CAAC;;;;;;KAMP,CAAC,CAAC;QAEH,sDAAsD;QACtD,MAAM,KAAK,GACT,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,EACjE,CAAC,GAAG,CAAC;QACN,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,EAAE;iBACZ,OAAO,CAAC,0DAA0D,CAAC;iBACnE,GAAG,EAAiE,CAAC;YAExE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,4EAA4E,CAC7E,CAAC;gBACF,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,SAAsE,EAAE,EAAE;oBAC3G,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;wBAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;oBAC7C,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,EAAE,CAAC,OAAO,CACR,oLAAoL,CACrL,CAAC,GAAG,EAAE,CAAC;IACV,CAAC;AACH,CAAC"}