homegraph 1.4.1 → 1.5.1

package/dist/spec/db/schema.sql

@@ -1,117 +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,
-    PRIMARY KEY (commit_hash, fragment_id),
-    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
-);
-
-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.d.ts

@@ -6,6 +6,11 @@
  */
 import { SqliteDatabase } from '../../db/sqlite-adapter';
 import { SpecNode } from '../types';
+/**
+ * Parse a JSON-encoded subtitles array, returning [] on any failure.
+ * Shared by every query that reads `spec_nodes.subtitles`.
+ */
+export declare function parseSubtitlesJson(raw: string): string[];
 /**
  * Insert or replace a SpecNode. Also updates the standalone FTS5 index
  * with CJK-segmented text.

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,
@@ -44,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,

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"}