homegraph 1.5.0 → 1.5.1

package/dist/spec/db/fts.js

@@ -119,10 +119,10 @@ function searchSpecsFts(db, query, limit, oversample = 3) {
     let rows;
     try {
         rows = db
-            .prepare(`SELECT s.id, s.title, s.subtitles
-         FROM specs_fts f
-         JOIN spec_nodes s ON s.id = f.id
-         WHERE specs_fts MATCH ?
+            .prepare(`SELECT s.id, s.title, s.subtitles
+         FROM specs_fts f
+         JOIN spec_nodes s ON s.id = f.id
+         WHERE specs_fts MATCH ?
          ORDER BY rank LIMIT ?`)
             .all(escaped, rawLimit);
     }
@@ -159,8 +159,8 @@ function searchSpecsLike(db, query, limit, excludeIds) {
     // Escape LIKE metacharacters so '%' and '_' are treated as literals
     const likePat = `%${(0, sql_utils_1.escapeLike)(query)}%`;
     const rows = db
-        .prepare(`SELECT id, title, subtitles FROM spec_nodes
-       WHERE title LIKE ? ESCAPE '\\' OR subtitles LIKE ? ESCAPE '\\'
+        .prepare(`SELECT id, title, subtitles FROM spec_nodes
+       WHERE title LIKE ? ESCAPE '\\' OR subtitles LIKE ? ESCAPE '\\'
        ORDER BY id LIMIT ?`)
         .all(likePat, likePat, limit * 3);
     const scored = [];
@@ -280,8 +280,8 @@ function searchCodeFragments(db, query, limit = 50) {
     let rows;
     try {
         rows = db
-            .prepare(`SELECT id FROM code_fragments_fts
-         WHERE code_fragments_fts MATCH ?
+            .prepare(`SELECT id FROM code_fragments_fts
+         WHERE code_fragments_fts MATCH ?
          ORDER BY rank LIMIT ?`)
             .all(escaped, limit);
     }

package/dist/spec/db/relations.js

@@ -30,10 +30,10 @@ const sql_utils_1 = require("./sql-utils");
  * `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 });
 }
 /**
@@ -41,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,
@@ -64,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 });
 }
 // ===========================================================================
@@ -78,10 +78,10 @@ function transferSpecCommitRelations(db, fromSpecId, toSpecId) {
  * `INSERT OR IGNORE` — duplicates are silently skipped.
  */
 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)
+    db.prepare(`
+    INSERT OR IGNORE INTO commit_fragment_relations
+      (commit_hash, fragment_id, relation_type)
+    VALUES (@commitHash, @fragmentId, @relationType)
   `).run({ commitHash, fragmentId, relationType });
 }
 // ===========================================================================
@@ -92,10 +92,10 @@ function insertCommitFragmentRelation(db, commitHash, fragmentId, relationType)
  * `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 });
 }
 /**
@@ -103,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);
 }
 /**
@@ -119,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 });
 }
 // ===========================================================================
@@ -175,10 +175,10 @@ function countAllRelations(db) {
  */
 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
+        .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);
@@ -207,13 +207,13 @@ function findSpecsByFilePath(db, filePath, maxResults = DEFAULT_MAX_SPEC_FIND_RE
     }
     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
+        .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;
@@ -238,29 +238,29 @@ function findSpecsByFilePath(db, filePath, maxResults = DEFAULT_MAX_SPEC_FIND_RE
 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
+        .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,
@@ -291,11 +291,11 @@ function findSpecIdsByFragmentIds(db, fragmentIds) {
         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})
+        .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);
@@ -306,10 +306,10 @@ function findSpecIdsByFragmentIds(db, fragmentIds) {
  */
 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
+        .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);

package/dist/spec/db/schema.js

@@ -93,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.sql

@@ -1,121 +1,121 @@
--- Commit4Spec Schema for HomeGraph
--- Version 2
---
--- Independent tables that coexist alongside HomeGraph's `nodes`/`edges`
--- core graph. These tables form a three-layer Spec→Commit→CodeFragment
--- relationship model — a higher-level semantic overlay on the code graph.
---
--- FTS5 uses a standalone virtual table (not external content) because
--- Spec text needs CJK character-level segmentation before indexing.
-
--- =============================================================================
--- Entity Tables
--- =============================================================================
-
-CREATE TABLE IF NOT EXISTS spec_nodes (
-    id TEXT PRIMARY KEY,
-    title TEXT NOT NULL,
-    subtitles TEXT NOT NULL,        -- JSON array of markdown heading + preview
-    status TEXT NOT NULL DEFAULT 'active',  -- 'active' | 'deprecated'
-    version INTEGER NOT NULL DEFAULT 1,
-    file_path TEXT NOT NULL,
-    timestamp INTEGER NOT NULL      -- Unix epoch milliseconds
-);
-
-CREATE TABLE IF NOT EXISTS commit_nodes (
-    hash TEXT PRIMARY KEY,          -- Full 40-char commit hash
-    message TEXT NOT NULL,          -- First line of commit message
-    author TEXT NOT NULL,
-    timestamp INTEGER NOT NULL      -- Unix epoch milliseconds
-);
-
-CREATE TABLE IF NOT EXISTS code_fragment_nodes (
-    id TEXT PRIMARY KEY,            -- 12-char hex UUID prefix
-    change_type TEXT NOT NULL,      -- 'ADD' | 'MODIFY' | 'DELETE'
-    file_path TEXT NOT NULL,
-    start_line INTEGER NOT NULL,
-    end_line INTEGER NOT NULL,
-    code_diff TEXT NOT NULL         -- Unified diff text
-);
-
--- =============================================================================
--- Relation Tables
--- =============================================================================
-
-CREATE TABLE IF NOT EXISTS spec_commit_relations (
-    spec_id TEXT NOT NULL,
-    commit_hash TEXT NOT NULL,
-    relation_type TEXT NOT NULL,    -- 'GENERATE' | 'SUMMARIZED_FROM'
-    PRIMARY KEY (spec_id, commit_hash, relation_type),
-    FOREIGN KEY (spec_id) REFERENCES spec_nodes(id) ON DELETE CASCADE,
-    FOREIGN KEY (commit_hash) REFERENCES commit_nodes(hash) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS commit_fragment_relations (
-    commit_hash TEXT NOT NULL,
-    fragment_id TEXT NOT NULL,
-    relation_type TEXT NOT NULL,
-    PRIMARY KEY (commit_hash, fragment_id, relation_type),
-    FOREIGN KEY (commit_hash) REFERENCES commit_nodes(hash) ON DELETE CASCADE,
-    FOREIGN KEY (fragment_id) REFERENCES code_fragment_nodes(id) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS spec_spec_relations (
-    source_id TEXT NOT NULL,
-    target_id TEXT NOT NULL,
-    relation_type TEXT NOT NULL,    -- 'SIMILAR_TO' | 'EVOLVED_FROM'
-    PRIMARY KEY (source_id, target_id, relation_type),
-    FOREIGN KEY (source_id) REFERENCES spec_nodes(id) ON DELETE CASCADE,
-    FOREIGN KEY (target_id) REFERENCES spec_nodes(id) ON DELETE CASCADE
-);
-
--- =============================================================================
--- Full-Text Search (standalone — CJK-segmented on insert)
--- =============================================================================
-
-CREATE VIRTUAL TABLE IF NOT EXISTS specs_fts USING fts5(
-    id,
-    title,
-    subtitles
-);
-
--- NOTE: `runSpecMigrations` in schema.ts mirrors some of this DDL to patch
--- pre-existing databases. Keep the two in sync when adding migrations.
-
-CREATE VIRTUAL TABLE IF NOT EXISTS code_fragments_fts USING fts5(
-    id,
-    file_path,
-    code_diff
-);
-
--- =============================================================================
--- Indexes
--- =============================================================================
-
-CREATE INDEX IF NOT EXISTS idx_spec_nodes_status ON spec_nodes(status);
-CREATE INDEX IF NOT EXISTS idx_spec_nodes_file_path ON spec_nodes(file_path);
-CREATE INDEX IF NOT EXISTS idx_commit_nodes_timestamp ON commit_nodes(timestamp);
-CREATE INDEX IF NOT EXISTS idx_code_fragment_file_path ON code_fragment_nodes(file_path);
-CREATE INDEX IF NOT EXISTS idx_code_fragment_path_lines ON code_fragment_nodes(file_path, start_line, end_line);
-CREATE INDEX IF NOT EXISTS idx_scr_spec_id ON spec_commit_relations(spec_id);
-CREATE INDEX IF NOT EXISTS idx_scr_commit_hash ON spec_commit_relations(commit_hash);
-CREATE INDEX IF NOT EXISTS idx_cfr_commit_hash ON commit_fragment_relations(commit_hash);
-CREATE INDEX IF NOT EXISTS idx_cfr_fragment_id ON commit_fragment_relations(fragment_id);
-CREATE INDEX IF NOT EXISTS idx_ssr_source ON spec_spec_relations(source_id);
-CREATE INDEX IF NOT EXISTS idx_ssr_target ON spec_spec_relations(target_id);
-
--- =============================================================================
--- Schema Version
--- =============================================================================
-
-CREATE TABLE IF NOT EXISTS spec_schema_versions (
-    version INTEGER PRIMARY KEY,
-    applied_at INTEGER NOT NULL,
-    description TEXT
-);
-
-INSERT OR IGNORE INTO spec_schema_versions (version, applied_at, description)
-VALUES (1, strftime('%s', 'now') * 1000, 'Initial Commit4Spec schema');
-
-INSERT OR IGNORE INTO spec_schema_versions (version, applied_at, description)
-VALUES (2, strftime('%s', 'now') * 1000, 'Add code_fragments_fts for content-based fragment search');
+-- Commit4Spec Schema for HomeGraph
+-- Version 2
+--
+-- Independent tables that coexist alongside HomeGraph's `nodes`/`edges`
+-- core graph. These tables form a three-layer Spec→Commit→CodeFragment
+-- relationship model — a higher-level semantic overlay on the code graph.
+--
+-- FTS5 uses a standalone virtual table (not external content) because
+-- Spec text needs CJK character-level segmentation before indexing.
+
+-- =============================================================================
+-- Entity Tables
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS spec_nodes (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    subtitles TEXT NOT NULL,        -- JSON array of markdown heading + preview
+    status TEXT NOT NULL DEFAULT 'active',  -- 'active' | 'deprecated'
+    version INTEGER NOT NULL DEFAULT 1,
+    file_path TEXT NOT NULL,
+    timestamp INTEGER NOT NULL      -- Unix epoch milliseconds
+);
+
+CREATE TABLE IF NOT EXISTS commit_nodes (
+    hash TEXT PRIMARY KEY,          -- Full 40-char commit hash
+    message TEXT NOT NULL,          -- First line of commit message
+    author TEXT NOT NULL,
+    timestamp INTEGER NOT NULL      -- Unix epoch milliseconds
+);
+
+CREATE TABLE IF NOT EXISTS code_fragment_nodes (
+    id TEXT PRIMARY KEY,            -- 12-char hex UUID prefix
+    change_type TEXT NOT NULL,      -- 'ADD' | 'MODIFY' | 'DELETE'
+    file_path TEXT NOT NULL,
+    start_line INTEGER NOT NULL,
+    end_line INTEGER NOT NULL,
+    code_diff TEXT NOT NULL         -- Unified diff text
+);
+
+-- =============================================================================
+-- Relation Tables
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS spec_commit_relations (
+    spec_id TEXT NOT NULL,
+    commit_hash TEXT NOT NULL,
+    relation_type TEXT NOT NULL,    -- 'GENERATE' | 'SUMMARIZED_FROM'
+    PRIMARY KEY (spec_id, commit_hash, relation_type),
+    FOREIGN KEY (spec_id) REFERENCES spec_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (commit_hash) REFERENCES commit_nodes(hash) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS commit_fragment_relations (
+    commit_hash TEXT NOT NULL,
+    fragment_id TEXT NOT NULL,
+    relation_type TEXT NOT NULL,
+    PRIMARY KEY (commit_hash, fragment_id, relation_type),
+    FOREIGN KEY (commit_hash) REFERENCES commit_nodes(hash) ON DELETE CASCADE,
+    FOREIGN KEY (fragment_id) REFERENCES code_fragment_nodes(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS spec_spec_relations (
+    source_id TEXT NOT NULL,
+    target_id TEXT NOT NULL,
+    relation_type TEXT NOT NULL,    -- 'SIMILAR_TO' | 'EVOLVED_FROM'
+    PRIMARY KEY (source_id, target_id, relation_type),
+    FOREIGN KEY (source_id) REFERENCES spec_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (target_id) REFERENCES spec_nodes(id) ON DELETE CASCADE
+);
+
+-- =============================================================================
+-- Full-Text Search (standalone — CJK-segmented on insert)
+-- =============================================================================
+
+CREATE VIRTUAL TABLE IF NOT EXISTS specs_fts USING fts5(
+    id,
+    title,
+    subtitles
+);
+
+-- NOTE: `runSpecMigrations` in schema.ts mirrors some of this DDL to patch
+-- pre-existing databases. Keep the two in sync when adding migrations.
+
+CREATE VIRTUAL TABLE IF NOT EXISTS code_fragments_fts USING fts5(
+    id,
+    file_path,
+    code_diff
+);
+
+-- =============================================================================
+-- Indexes
+-- =============================================================================
+
+CREATE INDEX IF NOT EXISTS idx_spec_nodes_status ON spec_nodes(status);
+CREATE INDEX IF NOT EXISTS idx_spec_nodes_file_path ON spec_nodes(file_path);
+CREATE INDEX IF NOT EXISTS idx_commit_nodes_timestamp ON commit_nodes(timestamp);
+CREATE INDEX IF NOT EXISTS idx_code_fragment_file_path ON code_fragment_nodes(file_path);
+CREATE INDEX IF NOT EXISTS idx_code_fragment_path_lines ON code_fragment_nodes(file_path, start_line, end_line);
+CREATE INDEX IF NOT EXISTS idx_scr_spec_id ON spec_commit_relations(spec_id);
+CREATE INDEX IF NOT EXISTS idx_scr_commit_hash ON spec_commit_relations(commit_hash);
+CREATE INDEX IF NOT EXISTS idx_cfr_commit_hash ON commit_fragment_relations(commit_hash);
+CREATE INDEX IF NOT EXISTS idx_cfr_fragment_id ON commit_fragment_relations(fragment_id);
+CREATE INDEX IF NOT EXISTS idx_ssr_source ON spec_spec_relations(source_id);
+CREATE INDEX IF NOT EXISTS idx_ssr_target ON spec_spec_relations(target_id);
+
+-- =============================================================================
+-- Schema Version
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS spec_schema_versions (
+    version INTEGER PRIMARY KEY,
+    applied_at INTEGER NOT NULL,
+    description TEXT
+);
+
+INSERT OR IGNORE INTO spec_schema_versions (version, applied_at, description)
+VALUES (1, strftime('%s', 'now') * 1000, 'Initial Commit4Spec schema');
+
+INSERT OR IGNORE INTO spec_schema_versions (version, applied_at, description)
+VALUES (2, strftime('%s', 'now') * 1000, 'Add code_fragments_fts for content-based fragment search');

package/dist/spec/db/spec-node.js

@@ -50,10 +50,10 @@ function rowToSpec(row) {
  */
 function insertSpecNode(db, node) {
     const subtitlesJson = JSON.stringify(node.subtitles);
-    db.prepare(`
-    INSERT OR REPLACE INTO spec_nodes
-      (id, title, subtitles, status, version, file_path, timestamp)
-    VALUES (@id, @title, @subtitles, @status, @version, @filePath, @timestamp)
+    db.prepare(`
+    INSERT OR REPLACE INTO spec_nodes
+      (id, title, subtitles, status, version, file_path, timestamp)
+    VALUES (@id, @title, @subtitles, @status, @version, @filePath, @timestamp)
   `).run({
         id: node.id,
         title: node.title,