homegraph 1.4.1 → 1.5.0

package/dist/spec/db/spec-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-node.d.ts","sourceRoot":"","sources":["../../../src/spec/db/spec-node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AA2CpC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CA2B3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAErG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,QAAQ,EAAE,CAK3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAW7F"}
+{"version":3,"file":"spec-node.d.ts","sourceRoot":"","sources":["../../../src/spec/db/spec-node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAqBpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAMxD;AAkBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CA2B3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAErG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,QAAQ,EAAE,CAK3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAW7F"}

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

@@ -6,6 +6,7 @@
  * text (see `fts.ts` for the segmentation logic).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSubtitlesJson = parseSubtitlesJson;
 exports.insertSpecNode = insertSpecNode;
 exports.findSpecById = findSpecById;
 exports.updateSpecStatus = updateSpecStatus;
@@ -17,18 +18,23 @@ const fts_1 = require("./fts");
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function rowToSpec(row) {
-    let subtitles;
+/**
+ * Parse a JSON-encoded subtitles array, returning [] on any failure.
+ * Shared by every query that reads `spec_nodes.subtitles`.
+ */
+function parseSubtitlesJson(raw) {
     try {
-        subtitles = JSON.parse(row.subtitles || '[]');
+        return JSON.parse(raw || '[]');
     }
     catch {
-        subtitles = [];
+        return [];
     }
+}
+function rowToSpec(row) {
     return {
         id: row.id,
         title: row.title,
-        subtitles,
+        subtitles: parseSubtitlesJson(row.subtitles),
         status: row.status,
         version: row.version,
         filePath: row.file_path,

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

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

package/dist/spec/db/sql-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared SQL helpers for the spec db layer.
+ *
+ * @module spec/db/sql-utils
+ */
+/**
+ * Escape LIKE metacharacters (`%`, `_`) and the escape character itself so
+ * the input is matched literally in `LIKE ... ESCAPE '\'` queries.
+ */
+export declare function escapeLike(str: string): string;
+//# sourceMappingURL=sql-utils.d.ts.map

package/dist/spec/db/sql-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-utils.d.ts","sourceRoot":"","sources":["../../../src/spec/db/sql-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/dist/spec/db/sql-utils.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Shared SQL helpers for the spec db layer.
+ *
+ * @module spec/db/sql-utils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeLike = escapeLike;
+/**
+ * Escape LIKE metacharacters (`%`, `_`) and the escape character itself so
+ * the input is matched literally in `LIKE ... ESCAPE '\'` queries.
+ */
+function escapeLike(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/%/g, '\\%')
+        .replace(/_/g, '\\_');
+}
+//# sourceMappingURL=sql-utils.js.map

package/dist/spec/db/sql-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-utils.js","sourceRoot":"","sources":["../../../src/spec/db/sql-utils.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAMH,gCAKC;AATD;;;GAGG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/dist/spec/evolve/cluster-context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * cluster-context.ts — Build cluster-level context summary for LLM spec evaluation.
+ *
+ * References mine/generator.ts buildClusterPrompt for the multi-commit
+ * context aggregation pattern, but uses simpler data (diff-based instead of
+ * AST-based) since evolve works with unified diffs.
+ *
+ * The ClusterContext / CommitSummary / CommitContextInput types live in
+ * `../types` so the LLM layer can depend on them without importing from a
+ * pipeline module.
+ *
+ * @module spec/evolve/cluster-context
+ */
+import { ClusterContext, CommitSummary, CommitContextInput } from '../types';
+export type { ClusterContext, CommitSummary, CommitContextInput };
+/**
+ * Build a cluster context summary for a group of commits affecting the same spec.
+ *
+ * Steps:
+ * 1. For each affecting commit, build a CommitSummary with changed files.
+ *    The `truncatedDiff` field is left as a placeholder — the caller is
+ *    responsible for injecting actual diffs via `getCommitDiff()` + `truncateText()`.
+ * 2. Compute primaryFiles: files changed in the most commits (top TOP_PRIMARY_FILES).
+ *
+ * @param affectingCommits - Commit info for commits affecting this spec.
+ * @param maxChars         - Maximum total characters for commit summaries (default 12000).
+ * @returns ClusterContext ready for LLM prompt construction.
+ */
+export declare function buildClusterContext(affectingCommits: CommitContextInput[], maxChars?: number): ClusterContext;
+//# sourceMappingURL=cluster-context.d.ts.map

package/dist/spec/evolve/cluster-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-context.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/cluster-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE7E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAgBlE;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,QAAQ,GAAE,MAAkC,GAC3C,cAAc,CA2ChB"}

package/dist/spec/evolve/cluster-context.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * cluster-context.ts — Build cluster-level context summary for LLM spec evaluation.
+ *
+ * References mine/generator.ts buildClusterPrompt for the multi-commit
+ * context aggregation pattern, but uses simpler data (diff-based instead of
+ * AST-based) since evolve works with unified diffs.
+ *
+ * The ClusterContext / CommitSummary / CommitContextInput types live in
+ * `../types` so the LLM layer can depend on them without importing from a
+ * pipeline module.
+ *
+ * @module spec/evolve/cluster-context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClusterContext = buildClusterContext;
+// =============================================================================
+// Constants
+// =============================================================================
+/** Maximum total characters for the cluster context (~12K tokens @ ~0.25 token/char). */
+const DEFAULT_MAX_CONTEXT_CHARS = 48000;
+/** Number of top files reported in primaryFiles. */
+const TOP_PRIMARY_FILES = 10;
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Build a cluster context summary for a group of commits affecting the same spec.
+ *
+ * Steps:
+ * 1. For each affecting commit, build a CommitSummary with changed files.
+ *    The `truncatedDiff` field is left as a placeholder — the caller is
+ *    responsible for injecting actual diffs via `getCommitDiff()` + `truncateText()`.
+ * 2. Compute primaryFiles: files changed in the most commits (top TOP_PRIMARY_FILES).
+ *
+ * @param affectingCommits - Commit info for commits affecting this spec.
+ * @param maxChars         - Maximum total characters for commit summaries (default 12000).
+ * @returns ClusterContext ready for LLM prompt construction.
+ */
+function buildClusterContext(affectingCommits, maxChars = DEFAULT_MAX_CONTEXT_CHARS) {
+    // 1. Build commit summaries
+    const commitSummaries = [];
+    let usedBudget = 0;
+    // Track file frequency for primaryFiles
+    const fileFrequency = new Map();
+    for (const input of affectingCommits) {
+        const files = input.filePaths;
+        for (const f of files) {
+            fileFrequency.set(f, (fileFrequency.get(f) ?? 0) + 1);
+        }
+        // Per-commit overhead estimate: header + file list area
+        const overhead = 150; // "### abc1234 — message\n\nFiles: ...\n\n```diff\n...```\n\n"
+        const remainingForThis = maxChars - usedBudget - overhead;
+        if (remainingForThis <= 0)
+            break; // Budget exhausted
+        const summary = {
+            fullHash: input.commitHash,
+            shortHash: input.commitHash.slice(0, 7),
+            message: input.message ?? input.commitHash.slice(0, 7),
+            changedFiles: files,
+            // Placeholder — caller populates with actual diff
+            truncatedDiff: '',
+        };
+        commitSummaries.push(summary);
+        usedBudget += overhead;
+    }
+    // 2. Compute primaryFiles (top-N by frequency)
+    const primaryFiles = [...fileFrequency.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, TOP_PRIMARY_FILES)
+        .map(([file]) => file);
+    return {
+        commitCount: affectingCommits.length,
+        commitSummaries,
+        primaryFiles,
+    };
+}
+//# sourceMappingURL=cluster-context.js.map

package/dist/spec/evolve/cluster-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-context.js","sourceRoot":"","sources":["../../../src/spec/evolve/cluster-context.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAiCH,kDA8CC;AAzED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,yFAAyF;AACzF,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAExC,oDAAoD;AACpD,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CACjC,gBAAsC,EACtC,WAAmB,yBAAyB;IAE5C,4BAA4B;IAC5B,MAAM,eAAe,GAAoB,EAAE,CAAC;IAC5C,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,wCAAwC;IACxC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,wDAAwD;QACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,+DAA+D;QACrF,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;QAC1D,IAAI,gBAAgB,IAAI,CAAC;YAAE,MAAM,CAAC,mBAAmB;QAErD,MAAM,OAAO,GAAkB;YAC7B,QAAQ,EAAE,KAAK,CAAC,UAAU;YAC1B,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACvC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACtD,YAAY,EAAE,KAAK;YACnB,kDAAkD;YAClD,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,UAAU,IAAI,QAAQ,CAAC;IACzB,CAAC;IAED,+CAA+C;IAC/C,MAAM,YAAY,GAAG,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;SAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEzB,OAAO;QACL,WAAW,EAAE,gBAAgB,CAAC,MAAM;QACpC,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/spec/evolve/commit-spec-analyzer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * commit-spec-analyzer.ts — Batch analysis of incremental commits.
+ *
+ * References build pipeline's scan() Strategy A pattern: iterate commits,
+ * resolve scopes, extract metadata, parse diffs — all before any DB writes.
+ *
+ * @module spec/evolve/commit-spec-analyzer
+ */
+import { SpecConfig } from '../config';
+import { CommitInfo } from '../git';
+import { SpecMetadata } from '../build/spec-extractor';
+import { DiffFragment } from '../build/diff-parser';
+/** Result of analyzing a single commit for spec match. */
+export interface CommitSpecAnalysis {
+    /** The commit being analyzed. */
+    commit: CommitInfo;
+    /** Whether the commit's scope matched a local spec. */
+    matched: boolean;
+    /** Resolved spec ID (only when matched). */
+    specId?: string;
+    /** Extracted spec metadata (only when matched). */
+    metadata?: SpecMetadata;
+    /** Parsed diff fragments (only when matched). */
+    fragments?: DiffFragment[];
+    /** Human-readable reason for non-match. */
+    skipReason?: string;
+}
+/**
+ * Batch-analyze a list of incremental commits for spec matching.
+ *
+ * For each commit:
+ * 1. Resolve scope from commit message.
+ * 2. If scope matches a local spec file, extract metadata and parse the diff.
+ * 3. Return a CommitSpecAnalysis for every commit (matched or not).
+ *
+ * This function performs NO database writes.  All side effects are read-only:
+ * `getCommitDiff()` and `analyzeCommitDiff()` read from the git repo's
+ * object store but do not modify anything.
+ *
+ * The most expensive operations (`getCommitDiff` + `analyzeCommitDiff`) are
+ * only performed for scope-matched commits so that unmatched commits are
+ * nearly zero-cost during scan.
+ *
+ * @param repoPath        - Absolute path to the git repository.
+ * @param specStoragePath - Path to spec storage directory.
+ * @param commits         - Incremental commits to analyze (chronological order).
+ * @param config          - Resolved SpecConfig.
+ * @returns Array of CommitSpecAnalysis, one per input commit.
+ */
+export declare function analyzeIncrementalCommits(repoPath: string, specStoragePath: string, commits: CommitInfo[], config: SpecConfig): CommitSpecAnalysis[];
+//# sourceMappingURL=commit-spec-analyzer.d.ts.map

package/dist/spec/evolve/commit-spec-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-spec-analyzer.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/commit-spec-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAiB,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAqB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOvE,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,UAAU,GACjB,kBAAkB,EAAE,CAqDtB"}

package/dist/spec/evolve/commit-spec-analyzer.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * commit-spec-analyzer.ts — Batch analysis of incremental commits.
+ *
+ * References build pipeline's scan() Strategy A pattern: iterate commits,
+ * resolve scopes, extract metadata, parse diffs — all before any DB writes.
+ *
+ * @module spec/evolve/commit-spec-analyzer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeIncrementalCommits = analyzeIncrementalCommits;
+const git_1 = require("../git");
+const scan_1 = require("../build/scan");
+const diff_parser_1 = require("../build/diff-parser");
+const utils_1 = require("../utils");
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Batch-analyze a list of incremental commits for spec matching.
+ *
+ * For each commit:
+ * 1. Resolve scope from commit message.
+ * 2. If scope matches a local spec file, extract metadata and parse the diff.
+ * 3. Return a CommitSpecAnalysis for every commit (matched or not).
+ *
+ * This function performs NO database writes.  All side effects are read-only:
+ * `getCommitDiff()` and `analyzeCommitDiff()` read from the git repo's
+ * object store but do not modify anything.
+ *
+ * The most expensive operations (`getCommitDiff` + `analyzeCommitDiff`) are
+ * only performed for scope-matched commits so that unmatched commits are
+ * nearly zero-cost during scan.
+ *
+ * @param repoPath        - Absolute path to the git repository.
+ * @param specStoragePath - Path to spec storage directory.
+ * @param commits         - Incremental commits to analyze (chronological order).
+ * @param config          - Resolved SpecConfig.
+ * @returns Array of CommitSpecAnalysis, one per input commit.
+ */
+function analyzeIncrementalCommits(repoPath, specStoragePath, commits, config) {
+    const results = [];
+    // Hoist the directory read out of the per-commit loop.
+    const specIds = new Set((0, utils_1.discoverSpecs)(specStoragePath).map((e) => e.specId));
+    for (const commit of commits) {
+        // 1. Scope resolution + spec metadata
+        const { specId, metadata } = (0, scan_1.matchCommitToSpec)(commit.message, specIds, specStoragePath, config);
+        if (!specId) {
+            results.push({
+                commit,
+                matched: false,
+                skipReason: 'Commit message scope did not match any local spec',
+            });
+            continue;
+        }
+        if (!metadata) {
+            results.push({
+                commit,
+                matched: false,
+                skipReason: `Scope "${specId}" matched but no valid spec metadata found`,
+            });
+            continue;
+        }
+        // 3. Parse diff (only for matched commits — the expensive step)
+        let fragments;
+        try {
+            const diff = (0, git_1.getCommitDiff)(repoPath, commit.hash);
+            fragments = (0, diff_parser_1.analyzeCommitDiff)(repoPath, commit.hash, diff);
+        }
+        catch (err) {
+            results.push({
+                commit,
+                matched: false,
+                skipReason: `Diff analysis failed: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            continue;
+        }
+        results.push({
+            commit,
+            matched: true,
+            specId,
+            metadata,
+            fragments,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=commit-spec-analyzer.js.map

package/dist/spec/evolve/commit-spec-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-spec-analyzer.js","sourceRoot":"","sources":["../../../src/spec/evolve/commit-spec-analyzer.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAuDH,8DA0DC;AA9GD,gCAAmD;AACnD,wCAAkD;AAElD,sDAAuE;AACvE,oCAAyC;AAsBzC,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,yBAAyB,CACvC,QAAgB,EAChB,eAAuB,EACvB,OAAqB,EACrB,MAAkB;IAElB,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,uDAAuD;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAA,qBAAa,EAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,sCAAsC;QACtC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,wBAAiB,EAC5C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CACjD,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,mDAAmD;aAChE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,UAAU,MAAM,4CAA4C;aACzE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,gEAAgE;QAChE,IAAI,SAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,mBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAClD,SAAS,GAAG,IAAA,+BAAiB,EAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aACxF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,OAAO,EAAE,IAAI;YACb,MAAM;YACN,QAAQ;YACR,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/spec/evolve/commit-spec-persister.d.ts

@@ -0,0 +1,53 @@
+/**
+ * commit-spec-persister.ts — Per-commit graph persistence.
+ *
+ * Each commit is persisted in its own transaction so that a single failure
+ * does not roll back other successful commits. This aligns with the
+ * meta.json advancement rule: advance to the last commit whose phase-1
+ * persistence succeeded.
+ *
+ * @module spec/evolve/commit-spec-persister
+ */
+import { SqliteDatabase } from '../../db/sqlite-adapter';
+import { CommitSpecAnalysis } from './commit-spec-analyzer';
+export interface PersistResult {
+    /** Commit hash being persisted. */
+    commitHash: string;
+    /** Always true in a PersistResult — only matched analyses are persisted. */
+    matched: true;
+    /** The spec ID that was persisted. */
+    specId: string;
+    /** File paths from the diff fragments (for phase 2 impact location). */
+    filePaths: string[];
+    /** Statistics. */
+    stats: {
+        fragmentsInserted: number;
+        relationsCreated: number;
+    };
+}
+/**
+ * Persist the knowledge graph entries for a single scope-matched commit.
+ *
+ * All INSERTs use OR REPLACE / OR IGNORE semantics so repeated calls with
+ * the same data are idempotent.
+ *
+ * The caller is responsible for retry on failure — this function does
+ * not retry internally.
+ *
+ * Steps (inside a single DB transaction):
+ * 1. CommitNode (INSERT OR REPLACE)
+ * 2. SpecNode (INSERT OR REPLACE)
+ * 3. GENERATE relation (INSERT OR IGNORE)
+ * 4. For each diff fragment:
+ *    a. CodeFragment node (INSERT, auto-generated id)
+ *    b. CONTAINS relation (INSERT OR IGNORE)
+ *
+ * @param db       - Active SQLite database handle.
+ * @param analysis - CommitSpecAnalysis with matched=true.
+ * @returns PersistResult on success.
+ * @throws On transaction failure (caller decides whether to retry or skip).
+ */
+export declare function persistCommitSpecGraph(db: SqliteDatabase, analysis: CommitSpecAnalysis & {
+    matched: true;
+}): PersistResult;
+//# sourceMappingURL=commit-spec-persister.d.ts.map

package/dist/spec/evolve/commit-spec-persister.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-spec-persister.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/commit-spec-persister.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAY5D,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,IAAI,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB;IAClB,KAAK,EAAE;QACL,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,kBAAkB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAC/C,aAAa,CAuDf"}

package/dist/spec/evolve/commit-spec-persister.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * commit-spec-persister.ts — Per-commit graph persistence.
+ *
+ * Each commit is persisted in its own transaction so that a single failure
+ * does not roll back other successful commits. This aligns with the
+ * meta.json advancement rule: advance to the last commit whose phase-1
+ * persistence succeeded.
+ *
+ * @module spec/evolve/commit-spec-persister
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.persistCommitSpecGraph = persistCommitSpecGraph;
+const commit_node_1 = require("../db/commit-node");
+const relations_1 = require("../db/relations");
+const persist_1 = require("../db/persist");
+const errors_1 = require("../../errors");
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Persist the knowledge graph entries for a single scope-matched commit.
+ *
+ * All INSERTs use OR REPLACE / OR IGNORE semantics so repeated calls with
+ * the same data are idempotent.
+ *
+ * The caller is responsible for retry on failure — this function does
+ * not retry internally.
+ *
+ * Steps (inside a single DB transaction):
+ * 1. CommitNode (INSERT OR REPLACE)
+ * 2. SpecNode (INSERT OR REPLACE)
+ * 3. GENERATE relation (INSERT OR IGNORE)
+ * 4. For each diff fragment:
+ *    a. CodeFragment node (INSERT, auto-generated id)
+ *    b. CONTAINS relation (INSERT OR IGNORE)
+ *
+ * @param db       - Active SQLite database handle.
+ * @param analysis - CommitSpecAnalysis with matched=true.
+ * @returns PersistResult on success.
+ * @throws On transaction failure (caller decides whether to retry or skip).
+ */
+function persistCommitSpecGraph(db, analysis) {
+    const { commit } = analysis;
+    const metadata = analysis.metadata;
+    const fragments = analysis.fragments;
+    const filePaths = fragments.map((f) => f.filePath);
+    let fragmentsInserted = 0;
+    let relationsCreated = 0;
+    db.exec('BEGIN');
+    try {
+        // 1. CommitNode (idempotent — INSERT OR REPLACE)
+        (0, commit_node_1.insertCommitNode)(db, {
+            hash: commit.hash,
+            message: commit.message,
+            author: commit.author,
+            timestamp: commit.timestamp,
+        });
+        // 2. SpecNode (idempotent — INSERT OR REPLACE, last write wins for timestamp)
+        (0, persist_1.upsertSpecFromMetadata)(db, metadata, commit.timestamp);
+        // 3. GENERATE relation (idempotent — INSERT OR IGNORE)
+        (0, relations_1.insertSpecCommitRelation)(db, metadata.specId, commit.hash, 'GENERATE');
+        relationsCreated++;
+        // 4. CodeFragment nodes + CONTAINS relations
+        const persisted = (0, persist_1.persistCommitFragments)(db, commit.hash, fragments);
+        fragmentsInserted += persisted.fragmentsInserted;
+        relationsCreated += persisted.relationsCreated;
+        db.exec('COMMIT');
+        (0, errors_1.logDebug)('persistCommitSpecGraph: persisted', {
+            commitHash: commit.hash.slice(0, 7),
+            specId: metadata.specId,
+            fragments: fragmentsInserted,
+            relations: relationsCreated,
+        });
+        return {
+            commitHash: commit.hash,
+            matched: true,
+            specId: metadata.specId,
+            filePaths,
+            stats: { fragmentsInserted, relationsCreated },
+        };
+    }
+    catch (e) {
+        db.exec('ROLLBACK');
+        const msg = e instanceof Error ? e.message : String(e);
+        (0, errors_1.logWarn)('persistCommitSpecGraph: transaction failed', {
+            commitHash: commit.hash.slice(0, 7),
+            error: msg,
+        });
+        throw e; // Let the pipeline decide: skip this commit and advance or stop
+    }
+}
+//# sourceMappingURL=commit-spec-persister.js.map

package/dist/spec/evolve/commit-spec-persister.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-spec-persister.js","sourceRoot":"","sources":["../../../src/spec/evolve/commit-spec-persister.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAyDH,wDA0DC;AA/GD,mDAAqD;AACrD,+CAEyB;AACzB,2CAA+E;AAC/E,yCAAiD;AAsBjD,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,sBAAsB,CACpC,EAAkB,EAClB,QAAgD;IAEhD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAS,CAAC;IACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAU,CAAC;IACtC,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,iDAAiD;QACjD,IAAA,8BAAgB,EAAC,EAAE,EAAE;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,8EAA8E;QAC9E,IAAA,gCAAsB,EAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvD,uDAAuD;QACvD,IAAA,oCAAwB,EAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvE,gBAAgB,EAAE,CAAC;QAEnB,6CAA6C;QAC7C,MAAM,SAAS,GAAG,IAAA,gCAAsB,EAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrE,iBAAiB,IAAI,SAAS,CAAC,iBAAiB,CAAC;QACjD,gBAAgB,IAAI,SAAS,CAAC,gBAAgB,CAAC;QAE/C,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElB,IAAA,iBAAQ,EAAC,mCAAmC,EAAE;YAC5C,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACnC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,iBAAiB;YAC5B,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;YACT,KAAK,EAAE,EAAE,iBAAiB,EAAE,gBAAgB,EAAE;SAC/C,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAA,gBAAO,EAAC,4CAA4C,EAAE;YACpD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACnC,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,gEAAgE;IAC3E,CAAC;AACH,CAAC"}

package/dist/spec/evolve/impact-locator.d.ts

@@ -1,13 +1,29 @@
 import { SqliteDatabase } from '../../db/sqlite-adapter';
+export interface AffectedSpecEntry {
+    /** The affected historical spec ID. */
+    specId: string;
+    /** New commit hashes that affect this spec (file path overlap). */
+    affectingCommits: string[];
+}
 /**
- * Find specs affected by the given list of file paths.
+ * Locate historical (pre-existing) specs affected by new commits, grouped
+ * by spec → affecting commit list in one pass.
  *
- * Each file path should already be clean (no `a/` or `b/` prefix) — paths
- * sourced from `DiffFragment.filePath` via diff-parser already have prefixes
- * stripped.
+ * Two-phase query strategy:
  *
- * Queries the spec knowledge graph for specs whose code fragments match the
- * path, returns deduplicated, alphabetically sorted spec IDs.
+ * Phase A: For each file path in the new commits, find all spec IDs whose
+ *   code fragments share the same file path (reusing findSpecIdsByFragmentPath).
+ *   Exclude specIds in excludeSpecIds (phase 1 newly inserted specs).
+ *
+ * Phase B: For each candidate spec, determine which new commits' file paths
+ *   overlap with the spec's known fragment file paths.  File paths are
+ *   considered overlapping when one contains the other (substring match).
+ *
+ * @param db                Active SQLite database handle.
+ * @param commitFilePaths   Map of new commit hash → file paths (from phase 1).
+ * @param excludeSpecIds    Spec IDs to exclude (phase 1 newly inserted specs).
+ * @param onlyActive        If true (default), filter to specs with status = 'active'.
+ * @returns Sorted array of AffectedSpecEntry.
  */
-export declare function locateAffectedSpecs(db: SqliteDatabase, filePaths: string[]): string[];
+export declare function locateAffectedSpecsWithCommits(db: SqliteDatabase, commitFilePaths: Map<string, string[]>, excludeSpecIds: Set<string>, onlyActive?: boolean): AffectedSpecEntry[];
 //# sourceMappingURL=impact-locator.d.ts.map

package/dist/spec/evolve/impact-locator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"impact-locator.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/impact-locator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,EAAE,CAWV"}
+{"version":3,"file":"impact-locator.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/impact-locator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAWzD,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,cAAc,EAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACtC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,UAAU,GAAE,OAAc,GACzB,iBAAiB,EAAE,CAmDrB"}