homegraph 1.1.2 → 1.1.3

package/dist/spec/evolve/spec-rewriter.d.ts

@@ -0,0 +1,42 @@
+import { SqliteDatabase } from '../../db/sqlite-adapter';
+import { LLMClient } from './llm-client';
+export interface EvolveDecision {
+    action: 'UPDATE' | 'DEPRECATE' | 'UNCHANGED';
+    title?: string;
+    subtitles?: string[];
+    plan_content?: string;
+}
+/**
+ * Ask the LLM whether a commit requires updating, deprecating, or leaving
+ * a spec unchanged.
+ *
+ * @param specId            - The spec identifier (for logging / context).
+ * @param specStoragePath   - Root spec storage directory.
+ * @param specFilePath      - Absolute path to the plan.md file.
+ * @param commitMessage     - First line of the commit message.
+ * @param commitDiff        - Full unified diff of the commit.
+ * @param scheduleNextSpecs - Remaining spec IDs to be processed (for context).
+ * @param client            - Optional LLM client; if absent, returns UNCHANGED.
+ */
+export declare function evaluateSpec(specId: string, _specStoragePath: string, specFilePath: string, commitMessage: string, commitDiff: string, scheduleNextSpecs: string[], client?: LLMClient): Promise<EvolveDecision>;
+/**
+ * Apply an UPDATE decision: backup the old plan, write the new plan, version
+ * the spec in the database, and transfer relations.
+ *
+ * 10-step process (ported from spec_rewriter.py:79-178).
+ *
+ * @returns The new spec ID (same as old) and bumped version number.
+ */
+export declare function applyUpdate(db: SqliteDatabase, specStoragePath: string, oldSpecId: string, oldFilePath: string, oldVersion: number, decision: EvolveDecision, commitHash: string): {
+    newSpecId: string;
+    newVersion: number;
+};
+/**
+ * Apply a DEPRECATE decision: mark the spec as deprecated, create a
+ * deprecated target node, create the EVOLVED_FROM relation, and clean
+ * SIMILAR_TO relations.
+ *
+ * Ported from spec_rewriter.py:181-231.
+ */
+export declare function applyDeprecate(db: SqliteDatabase, oldSpecId: string): void;
+//# sourceMappingURL=spec-rewriter.d.ts.map

package/dist/spec/evolve/spec-rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-rewriter.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/spec-rewriter.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAgBzD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,cAAc,CAAC,CA2EzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,cAAc,EAClB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,MAAM,GACjB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAmF3C;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI,CAqBN"}

package/dist/spec/evolve/spec-rewriter.js

@@ -0,0 +1,254 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateSpec = evaluateSpec;
+exports.applyUpdate = applyUpdate;
+exports.applyDeprecate = applyDeprecate;
+/**
+ * Spec rewriter — evaluates a commit's impact on a design spec and applies
+ * UPDATE / DEPRECATE decisions.
+ *
+ * Replaces `commit4spec/self_evolve/spec_rewriter.py` (lines 1-231).
+ *
+ * @module spec/evolve/spec-rewriter
+ */
+const fs = __importStar(require("fs"));
+const utils_1 = require("../utils");
+const spec_node_1 = require("../db/spec-node");
+const relations_1 = require("../db/relations");
+const spec_extractor_1 = require("../mining/spec-extractor");
+const errors_1 = require("../../errors");
+// =============================================================================
+// evaluateSpec
+// =============================================================================
+/**
+ * Ask the LLM whether a commit requires updating, deprecating, or leaving
+ * a spec unchanged.
+ *
+ * @param specId            - The spec identifier (for logging / context).
+ * @param specStoragePath   - Root spec storage directory.
+ * @param specFilePath      - Absolute path to the plan.md file.
+ * @param commitMessage     - First line of the commit message.
+ * @param commitDiff        - Full unified diff of the commit.
+ * @param scheduleNextSpecs - Remaining spec IDs to be processed (for context).
+ * @param client            - Optional LLM client; if absent, returns UNCHANGED.
+ */
+async function evaluateSpec(specId, _specStoragePath, specFilePath, commitMessage, commitDiff, scheduleNextSpecs, client) {
+    // 1. Read plan content
+    const planContent = (0, utils_1.readFileContent)(specFilePath);
+    if (planContent === null) {
+        (0, errors_1.logDebug)('evaluateSpec: plan file not found, returning UNCHANGED', {
+            specId,
+            specFilePath,
+        });
+        return { action: 'UNCHANGED' };
+    }
+    // 2. Truncate commitDiff to 6000 chars
+    const truncatedDiff = (0, utils_1.truncateText)(commitDiff, 6000);
+    // 3. Build system prompt (EXACT from spec_rewriter.py:238-245)
+    const systemPrompt = `You are a technical documentation maintainer. Your task is to evaluate whether a git commit requires updating a software design specification (plan.md).
+
+Given the current plan content, the commit message, and the code diff, determine:
+1. Whether the plan needs to be updated (UPDATE), deprecated (DEPRECATE), or left unchanged (UNCHANGED).
+2. If UPDATE: provide the new title, subtitles (as an array of heading-preview strings), and full rewritten plan_content.
+3. If DEPRECATE: provide a brief explanation in the plan_content field.
+
+Response format (JSON):
+{
+  "action": "UPDATE" | "DEPRECATE" | "UNCHANGED",
+  "title": "New spec title (for UPDATE)",
+  "subtitles": ["heading1 → heading2 - preview", ...],
+  "plan_content": "Full rewritten markdown content (for UPDATE) or deprecation reason (for DEPRECATE)"
+}`;
+    // 4. Build user prompt (EXACT from spec_rewriter.py:247-280)
+    const scheduleStr = scheduleNextSpecs.length > 0 ? scheduleNextSpecs.join(', ') : 'none';
+    const userPrompt = `Current Plan Content:
+${planContent}
+
+Commit Message:
+${commitMessage}
+
+Code Diff:
+${truncatedDiff}
+
+Scheduled specs to be processed next (for context): ${scheduleStr}`;
+    // 5. Call LLM
+    if (!client) {
+        (0, errors_1.logDebug)('evaluateSpec: no LLM client, returning UNCHANGED', { specId });
+        return { action: 'UNCHANGED' };
+    }
+    const result = await client.chatJson(systemPrompt, userPrompt);
+    // 6. Validate action
+    const rawAction = result.action;
+    let action = 'UNCHANGED';
+    if (rawAction === 'UPDATE' || rawAction === 'DEPRECATE' || rawAction === 'UNCHANGED') {
+        action = rawAction;
+    }
+    else {
+        (0, errors_1.logWarn)('evaluateSpec: unknown action from LLM, defaulting to UNCHANGED', {
+            specId,
+            rawAction: String(rawAction),
+        });
+    }
+    // 7. Return EvolveDecision
+    return {
+        action,
+        title: typeof result.title === 'string' ? result.title : undefined,
+        subtitles: Array.isArray(result.subtitles)
+            ? result.subtitles.filter((s) => typeof s === 'string')
+            : undefined,
+        plan_content: typeof result.plan_content === 'string' ? result.plan_content : undefined,
+    };
+}
+// =============================================================================
+// applyUpdate
+// =============================================================================
+/**
+ * Apply an UPDATE decision: backup the old plan, write the new plan, version
+ * the spec in the database, and transfer relations.
+ *
+ * 10-step process (ported from spec_rewriter.py:79-178).
+ *
+ * @returns The new spec ID (same as old) and bumped version number.
+ */
+function applyUpdate(db, specStoragePath, oldSpecId, oldFilePath, oldVersion, decision, commitHash) {
+    // ---- Step 1: Write new plan content to temp file ----
+    // We write to a temp file first so the original is preserved until every
+    // DB operation succeeds.  If the caller's transaction rolls back, the
+    // temp file is harmless garbage — the original plan.md is untouched.
+    const tmpPath = oldFilePath + '.new';
+    (0, utils_1.writeFileContent)(tmpPath, decision.plan_content || '');
+    // ---- Step 2: Extract new metadata from the temp file ----
+    const metadata = (0, spec_extractor_1.extractSpecMetadata)(specStoragePath, oldSpecId);
+    const metadataTitle = metadata?.title;
+    const metadataSubtitles = metadata?.subtitles;
+    // ---- Step 3: Read old spec data ----
+    const oldSpec = (0, spec_node_1.findSpecById)(db, oldSpecId);
+    if (!oldSpec) {
+        (0, errors_1.logDebug)('applyUpdate: old spec not found in DB, returning early', {
+            oldSpecId,
+        });
+        // Clean up the temp file — no DB changes were made.
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { /* best-effort */ }
+        return { newSpecId: oldSpecId, newVersion: oldVersion + 1 };
+    }
+    // ---- Step 4: Insert deprecated record ----
+    const bakPath = oldFilePath + '.bak';
+    const deprecatedId = `${oldSpecId}_v${oldVersion}`;
+    (0, spec_node_1.insertSpecNode)(db, {
+        id: deprecatedId,
+        title: oldSpec.title,
+        subtitles: oldSpec.subtitles,
+        status: 'deprecated',
+        version: oldVersion,
+        filePath: bakPath,
+        timestamp: Date.now(),
+    });
+    // ---- Step 5: Transfer relations from old active to deprecated ----
+    (0, relations_1.transferSpecCommitRelations)(db, oldSpecId, deprecatedId);
+    (0, relations_1.transferSpecSpecRelations)(db, oldSpecId, deprecatedId);
+    // ---- Step 6: Delete old active spec ----
+    (0, spec_node_1.deleteSpec)(db, oldSpecId);
+    // ---- Step 7: Insert new active spec ----
+    const newVersion = oldVersion + 1;
+    (0, spec_node_1.insertSpecNode)(db, {
+        id: oldSpecId,
+        title: decision.title || metadataTitle || oldSpecId,
+        subtitles: decision.subtitles || metadataSubtitles || [],
+        status: 'active',
+        version: newVersion,
+        filePath: oldFilePath,
+        timestamp: Date.now(),
+    });
+    // ---- Step 8: Create EVOLVED_FROM relation ----
+    (0, relations_1.insertSpecSpecRelation)(db, oldSpecId, deprecatedId, 'EVOLVED_FROM');
+    // ---- Step 9: Create GENERATE relation ----
+    (0, relations_1.insertSpecCommitRelation)(db, oldSpecId, commitHash, 'GENERATE');
+    // ---- Step 10: File system finalisation ----
+    // Only now — after all DB ops succeeded — do we touch the original disk
+    // files.  rename() is atomic on the same filesystem.
+    try {
+        fs.renameSync(oldFilePath, bakPath);
+    }
+    catch {
+        (0, errors_1.logDebug)('applyUpdate: backup rename failed (file may be missing), continuing', {
+            oldFilePath,
+            bakPath,
+        });
+    }
+    try {
+        fs.renameSync(tmpPath, oldFilePath);
+    }
+    catch {
+        (0, errors_1.logDebug)('applyUpdate: temp rename failed, leaving .new in place', {
+            tmpPath,
+            oldFilePath,
+        });
+    }
+    return { newSpecId: oldSpecId, newVersion };
+}
+// =============================================================================
+// applyDeprecate
+// =============================================================================
+/**
+ * Apply a DEPRECATE decision: mark the spec as deprecated, create a
+ * deprecated target node, create the EVOLVED_FROM relation, and clean
+ * SIMILAR_TO relations.
+ *
+ * Ported from spec_rewriter.py:181-231.
+ */
+function applyDeprecate(db, oldSpecId) {
+    // 1. Mark the spec as deprecated
+    (0, spec_node_1.updateSpecStatus)(db, oldSpecId, 'deprecated');
+    // 2. Create deprecated target node
+    const deprecatedTargetId = `${oldSpecId}_deprecated`;
+    (0, spec_node_1.insertSpecNode)(db, {
+        id: deprecatedTargetId,
+        status: 'deprecated',
+        version: 1,
+        title: oldSpecId,
+        subtitles: [],
+        filePath: '', // Synthetic deprecated node — no on-disk file.
+        timestamp: Date.now(),
+    });
+    // 3. Create EVOLVED_FROM relation
+    (0, relations_1.insertSpecSpecRelation)(db, oldSpecId, deprecatedTargetId, 'EVOLVED_FROM');
+    // 4. Clean SIMILAR_TO relations
+    (0, relations_1.deleteSimilarToRelations)(db, oldSpecId);
+}
+//# sourceMappingURL=spec-rewriter.js.map

package/dist/spec/evolve/spec-rewriter.js.map

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

package/dist/spec/graph/queries.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Graph traversal queries for the Spec→Commit→CodeFragment knowledge graph.
+ *
+ * Replaces `commit4spec/graph/queries.py`. Provides spec context retrieval,
+ * stats, and search+traverse functionality.
+ */
+import { SqliteDatabase } from '../../db/sqlite-adapter';
+import { SpecContext, SpecStats } from '../types';
+/**
+ * Retrieve full context for a Spec — the spec node itself, all linked
+ * commits (with their relation types), and optionally the code fragments
+ * each commit touched.
+ *
+ * Commits are ordered by relation-type priority (GENERATE first, then
+ * SUMMARIZED_FROM, then others) and then by timestamp descending within
+ * each priority tier.
+ *
+ * @param db           Active SQLite database handle.
+ * @param specId       Spec identifier to look up.
+ * @param maxCommits   Maximum number of linked commits to return (default 5).
+ * @param includeFragments  Whether to load code fragments for each commit (default true).
+ * @returns SpecContext on success, or null when the spec is not found.
+ */
+export declare function getSpecContext(db: SqliteDatabase, specId: string, maxCommits?: number, includeFragments?: boolean): SpecContext | null;
+/**
+ * Find all spec IDs related to code fragments whose file path matches
+ * the given substring.
+ *
+ * @param db       Active SQLite database handle.
+ * @param filePath  File path substring to search for (LIKE-wrapped).
+ * @returns Array of distinct spec IDs.
+ */
+export declare function findSpecsByFragmentPath(db: SqliteDatabase, filePath: string): string[];
+/**
+ * Compute statistics about the Spec knowledge graph.
+ *
+ * @param db  Active SQLite database handle.
+ * @returns SpecStats with entity counts and relation totals.
+ */
+export declare function getSpecStats(db: SqliteDatabase): SpecStats;
+/**
+ * Full-text search for specs and return full context for each match.
+ *
+ * Combines FTS5 + LIKE fallback search with graph traversal so callers
+ * get everything in one call: spec metadata, linked commits, and
+ * optionally code fragments.
+ *
+ * Results are sorted by `_score` descending, then by spec timestamp
+ * descending as a tiebreaker.
+ *
+ * @param db                Active SQLite database handle.
+ * @param query             Search query string.
+ * @param topK              Maximum number of results to return (default 10).
+ * @param includeFragments  Whether to load code fragments per commit (default true).
+ * @returns Array of SpecContext (null results filtered out).
+ */
+export declare function searchAndGetContext(db: SqliteDatabase, query: string, topK?: number, includeFragments?: boolean): SpecContext[];
+//# sourceMappingURL=queries.d.ts.map

package/dist/spec/graph/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/spec/graph/queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAIL,WAAW,EAEX,SAAS,EACV,MAAM,UAAU,CAAC;AAoElB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAU,EACtB,gBAAgB,GAAE,OAAc,GAC/B,WAAW,GAAG,IAAI,CAyEpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAaV;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,SAAS,CAqD1D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,EACjB,gBAAgB,GAAE,OAAc,GAC/B,WAAW,EAAE,CAwBf"}

package/dist/spec/graph/queries.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * Graph traversal queries for the Spec→Commit→CodeFragment knowledge graph.
+ *
+ * Replaces `commit4spec/graph/queries.py`. Provides spec context retrieval,
+ * stats, and search+traverse functionality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSpecContext = getSpecContext;
+exports.findSpecsByFragmentPath = findSpecsByFragmentPath;
+exports.getSpecStats = getSpecStats;
+exports.searchAndGetContext = searchAndGetContext;
+const fts_1 = require("../db/fts");
+// ===========================================================================
+// Private helpers
+// ===========================================================================
+/**
+ * Parse a JSON string into a string array, returning [] on any failure.
+ */
+function _parseSubtitles(raw) {
+    try {
+        return JSON.parse(raw || '[]');
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Convert a DB row (snake_case keys) to a SpecNode (camelCase).
+ */
+function _rowToSpecNode(row) {
+    return {
+        id: row.id,
+        title: row.title,
+        subtitles: _parseSubtitles(row.subtitles),
+        status: row.status,
+        version: row.version,
+        filePath: row.file_path,
+        timestamp: row.timestamp,
+    };
+}
+// ===========================================================================
+// Public API
+// ===========================================================================
+/**
+ * Retrieve full context for a Spec — the spec node itself, all linked
+ * commits (with their relation types), and optionally the code fragments
+ * each commit touched.
+ *
+ * Commits are ordered by relation-type priority (GENERATE first, then
+ * SUMMARIZED_FROM, then others) and then by timestamp descending within
+ * each priority tier.
+ *
+ * @param db           Active SQLite database handle.
+ * @param specId       Spec identifier to look up.
+ * @param maxCommits   Maximum number of linked commits to return (default 5).
+ * @param includeFragments  Whether to load code fragments for each commit (default true).
+ * @returns SpecContext on success, or null when the spec is not found.
+ */
+function getSpecContext(db, specId, maxCommits = 5, includeFragments = true) {
+    // 1. Look up the spec by id
+    const specRow = db
+        .prepare(`SELECT id, title, subtitles, status, version, file_path, timestamp
+       FROM spec_nodes
+       WHERE id = ?`)
+        .get(specId);
+    if (!specRow)
+        return null;
+    const spec = _rowToSpecNode(specRow);
+    // 2. Query linked commits with priority ordering
+    const commitRows = db
+        .prepare(`SELECT c.hash, c.message, c.author, c.timestamp, r.relation_type
+       FROM spec_commit_relations r
+       JOIN commit_nodes c ON c.hash = r.commit_hash
+       WHERE r.spec_id = ?
+       ORDER BY
+         CASE r.relation_type
+           WHEN 'GENERATE' THEN 0
+           WHEN 'SUMMARIZED_FROM' THEN 1
+           ELSE 2
+         END,
+         c.timestamp DESC
+       LIMIT ?`)
+        .all(specId, maxCommits);
+    // 3. Build commit contexts (with optional fragments)
+    const commits = [];
+    for (const crow of commitRows) {
+        const commit = {
+            hash: crow.hash,
+            message: crow.message,
+            author: crow.author,
+            timestamp: crow.timestamp,
+        };
+        let fragments = [];
+        if (includeFragments) {
+            const fragRows = db
+                .prepare(`SELECT f.id, f.change_type, f.file_path, f.start_line,
+                  f.end_line, f.code_diff
+           FROM commit_fragment_relations r
+           JOIN code_fragment_nodes f ON f.id = r.fragment_id
+           WHERE r.commit_hash = ?
+           ORDER BY f.file_path, f.start_line`)
+                .all(crow.hash);
+            fragments = fragRows.map((fr) => ({
+                id: fr.id,
+                changeType: fr.change_type,
+                filePath: fr.file_path,
+                startLine: fr.start_line,
+                endLine: fr.end_line,
+                codeDiff: fr.code_diff,
+            }));
+        }
+        commits.push({
+            commit,
+            relationType: crow.relation_type,
+            fragments,
+        });
+    }
+    return { spec, commits };
+}
+/**
+ * Find all spec IDs related to code fragments whose file path matches
+ * the given substring.
+ *
+ * @param db       Active SQLite database handle.
+ * @param filePath  File path substring to search for (LIKE-wrapped).
+ * @returns Array of distinct spec IDs.
+ */
+function findSpecsByFragmentPath(db, filePath) {
+    const pattern = `%${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(pattern);
+    return rows.map((r) => r.spec_id);
+}
+/**
+ * Compute statistics about the Spec knowledge graph.
+ *
+ * @param db  Active SQLite database handle.
+ * @returns SpecStats with entity counts and relation totals.
+ */
+function getSpecStats(db) {
+    const specCount = db.prepare('SELECT COUNT(*) as cnt FROM spec_nodes').get().cnt;
+    const commitCount = db.prepare('SELECT COUNT(*) as cnt FROM commit_nodes').get().cnt;
+    const fragmentCount = db
+        .prepare('SELECT COUNT(*) as cnt FROM code_fragment_nodes')
+        .get().cnt;
+    const scrCount = db
+        .prepare('SELECT COUNT(*) as cnt FROM spec_commit_relations')
+        .get().cnt;
+    const cfrCount = db
+        .prepare('SELECT COUNT(*) as cnt FROM commit_fragment_relations')
+        .get().cnt;
+    const ssrCount = db
+        .prepare('SELECT COUNT(*) as cnt FROM spec_spec_relations')
+        .get().cnt;
+    const activeSpecCount = db
+        .prepare("SELECT COUNT(*) as cnt FROM spec_nodes WHERE status = 'active'")
+        .get().cnt;
+    const deprecatedSpecCount = db
+        .prepare("SELECT COUNT(*) as cnt FROM spec_nodes WHERE status = 'deprecated'")
+        .get().cnt;
+    return {
+        specCount,
+        commitCount,
+        fragmentCount,
+        relationCount: scrCount + cfrCount + ssrCount,
+        activeSpecCount,
+        deprecatedSpecCount,
+    };
+}
+/**
+ * Full-text search for specs and return full context for each match.
+ *
+ * Combines FTS5 + LIKE fallback search with graph traversal so callers
+ * get everything in one call: spec metadata, linked commits, and
+ * optionally code fragments.
+ *
+ * Results are sorted by `_score` descending, then by spec timestamp
+ * descending as a tiebreaker.
+ *
+ * @param db                Active SQLite database handle.
+ * @param query             Search query string.
+ * @param topK              Maximum number of results to return (default 10).
+ * @param includeFragments  Whether to load code fragments per commit (default true).
+ * @returns Array of SpecContext (null results filtered out).
+ */
+function searchAndGetContext(db, query, topK = 10, includeFragments = true) {
+    // 1. Search specs via FTS5 + LIKE fallback
+    const results = (0, fts_1.searchSpecs)(db, query, topK);
+    // 2. Get full context for each result
+    const scored = [];
+    for (const result of results) {
+        const context = getSpecContext(db, result.id, 5, includeFragments);
+        if (context !== null) {
+            scored.push({
+                score: result._score ?? 0,
+                timestamp: context.spec.timestamp,
+                context,
+            });
+        }
+    }
+    // 3. Sort by _score descending, then by spec timestamp descending
+    scored.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return b.timestamp - a.timestamp;
+    });
+    return scored.map((c) => c.context);
+}
+//# sourceMappingURL=queries.js.map

package/dist/spec/graph/queries.js.map

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

package/dist/spec/mining/diff-parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Unified diff parser — converts `git diff` output into structured code
+ * fragments.
+ *
+ * Replaces `commit4spec/reverse_engineer/change_analyzer.py`.  Parses
+ * unified diff output and extracts file-level change information (change
+ * type, line range, diff text).
+ *
+ * @module spec/mining/diff-parser
+ */
+export interface DiffFragment {
+    /** Path of the changed file (no `a/` / `b/` prefix). */
+    filePath: string;
+    /** Kind of change: added, modified, or deleted. */
+    changeType: 'ADD' | 'MODIFY' | 'DELETE';
+    /** First new-line number in this diff fragment (1-based). */
+    startLine: number;
+    /** Last new-line number covered by this fragment (1-based). */
+    endLine: number;
+    /** Raw unified diff text for this file. */
+    codeDiff: string;
+}
+/**
+ * Retrieve and parse the diff for a single commit.
+ *
+ * 1. Call `getCommitDiff(repoPath, commitHash)` to get raw diff text.
+ * 2. Parse the diff into structured `DiffFragment` objects.
+ * 3. Return the fragments.
+ *
+ * Returns an empty array when the diff cannot be retrieved or is empty.
+ */
+export declare function analyzeCommitDiff(repoPath: string, commitHash: string, preFetchedDiff?: string): DiffFragment[];
+//# sourceMappingURL=diff-parser.d.ts.map

package/dist/spec/mining/diff-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-parser.d.ts","sourceRoot":"","sources":["../../../src/spec/mining/diff-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,YAAY,EAAE,CAMhB"}