homegraph 1.2.0 → 1.5.0

package/dist/spec/mine/generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Reverse Spec Generator — LLM-driven spec document generation from clusters.
+ *
+ * For each commit cluster, builds a prompt with AST-level change data and
+ * calls the LLM (via the existing `OpenAiLlmClient`) to produce a structured
+ * markdown specification. Supports custom templates via `{{placeholder}}`
+ * syntax.
+ *
+ * @module spec/mine/generator
+ */
+import { CommitCluster } from './clustering';
+import { LlmClient } from '../llm/client';
+import type { ProgressCallback } from '../ui';
+/** A single generated spec document. */
+export interface GeneratedSpec {
+    specId: string;
+    title: string;
+    content: string;
+    clusterId: number;
+    commitHashes: string[];
+}
+/** Result of the LLM generation phase. */
+export interface GenerationResult {
+    specs: GeneratedSpec[];
+    skipped: number;
+    errors: number;
+}
+/**
+ * Extract the markdown spec document from a chat() response.
+ *
+ * Headless coding agents (and occasionally chat models) wrap the document
+ * in prose ("Here is the spec:") or a ```markdown fence — writing that
+ * verbatim would pollute the spec file. Since the spec template always
+ * starts with a heading, the extraction is:
+ * 1. If a fenced block contains a markdown heading, use its content.
+ * 2. Else strip any prose before the first heading line.
+ * 3. Otherwise return the response trimmed.
+ *
+ * Provider-agnostic: applies identically to coding-agent and OpenAI paths.
+ */
+export declare function extractMarkdown(raw: string): string;
+/**
+ * Generate spec documents for a list of commit clusters.
+ *
+ * @param clusters - Clusters to generate specs for.
+ * @param client - Resolved LLM client (coding agent, configured LLM, or
+ *   a fallback composite — resolution happens in `llm/factory`).
+ * @param outputDir - Directory to write generated spec files.
+ * @param templateContent - Optional custom template string.
+ * @param onProgress - Optional progress callback (called per cluster).
+ * @returns Generation result with generated specs and stats.
+ */
+export declare function generateSpecs(clusters: CommitCluster[], client: LlmClient, outputDir: string, templateContent?: string, onProgress?: ProgressCallback): Promise<GenerationResult>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/spec/mine/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/spec/mine/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAM9C,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AA6GD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBnD;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,EACxB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAiF3B"}

package/dist/spec/mine/generator.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Reverse Spec Generator — LLM-driven spec document generation from clusters.
+ *
+ * For each commit cluster, builds a prompt with AST-level change data and
+ * calls the LLM (via the existing `OpenAiLlmClient`) to produce a structured
+ * markdown specification. Supports custom templates via `{{placeholder}}`
+ * syntax.
+ *
+ * @module spec/mine/generator
+ */
+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.extractMarkdown = extractMarkdown;
+exports.generateSpecs = generateSpecs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const prompts_1 = require("../llm/prompts");
+const spec_extractor_1 = require("../build/spec-extractor");
+const utils_1 = require("../utils");
+const errors_1 = require("../../errors");
+// ---------------------------------------------------------------------------
+// Prompt Building
+// ---------------------------------------------------------------------------
+/** Maximum characters for the cluster context summary (~12K tokens @ ~0.25 token/char). */
+const MAX_CONTEXT_CHARS = 48000;
+/** Maximum characters per commit symbol list (~1.5K tokens @ ~0.25 token/char). */
+const MAX_SYMBOL_CHARS = 6000;
+/**
+ * Build the user prompt with commit-level context from a cluster.
+ */
+function buildClusterPrompt(cluster, template) {
+    const parts = [];
+    parts.push('## Cluster Context');
+    parts.push('');
+    parts.push(`- ${cluster.commits.length} commits`);
+    parts.push(`- Primary files: ${cluster.primaryFiles.join(', ') || '(none)'}`);
+    parts.push(`- Primary symbols: ${cluster.primarySymbols.join(', ') || '(none)'}`);
+    parts.push('');
+    let totalChars = parts.join('\n').length;
+    for (const change of cluster.commits) {
+        const header = `### ${change.commitHash.slice(0, 7)} — ${change.commitMessage}`;
+        if (totalChars + header.length > MAX_CONTEXT_CHARS)
+            break;
+        const lines = [header, ''];
+        for (const fc of change.fileChanges) {
+            const fileHeader = `**${fc.filePath}** (${fc.language})${fc.isNewFile ? ' [new file]' : ''}`;
+            const symbolLines = [];
+            // Format one symbol with kind tag, signature, and visibility.
+            // `extra` is an optional suffix appended after the visibility.
+            const fmtSym = (marker, sym, extra) => {
+                const tag = `[${sym.kind}]`;
+                const sig = sym.signature ? ` ${sym.signature}` : '';
+                const vis = sym.visibility && sym.visibility !== 'public'
+                    ? ` (${sym.visibility})` : '';
+                const ext = extra ? ` ${extra}` : '';
+                return `${marker} ${tag} ${sym.name}${sig}${vis}${ext}`;
+            };
+            for (const s of fc.addedSymbols) {
+                symbolLines.push(fmtSym('+', s));
+            }
+            for (const s of fc.removedSymbols) {
+                symbolLines.push(fmtSym('-', s));
+            }
+            for (const m of fc.modifiedSymbols) {
+                const changes = [];
+                if (m.old.signature !== m.new.signature)
+                    changes.push('sig');
+                if (m.old.name !== m.new.name)
+                    changes.push('name');
+                if (m.old.visibility !== m.new.visibility)
+                    changes.push('vis');
+                const extra = changes.length > 0
+                    ? `(changed: ${changes.join(', ')})`
+                    : '(changed)';
+                symbolLines.push(fmtSym('~', m.new, extra));
+            }
+            if (symbolLines.length === 0)
+                continue;
+            const symbolStr = symbolLines.join('\n');
+            const truncated = symbolStr.length > MAX_SYMBOL_CHARS
+                ? symbolStr.slice(0, MAX_SYMBOL_CHARS) + '\n…'
+                : symbolStr;
+            const block = `${fileHeader}\n${truncated}`;
+            if (totalChars + block.length > MAX_CONTEXT_CHARS)
+                break;
+            lines.push(block);
+        }
+        const commitBlock = lines.join('\n');
+        if (totalChars + commitBlock.length > MAX_CONTEXT_CHARS)
+            break;
+        parts.push(commitBlock);
+        parts.push('');
+        totalChars += commitBlock.length + 1;
+    }
+    const context = parts.join('\n');
+    // Build the full prompt: cluster context + template
+    const prompt = [
+        'Use the following commit cluster context to fill in the template below.',
+        '',
+        context,
+        '',
+        '---',
+        '',
+        'Fill in this template:',
+        '',
+        template,
+    ].join('\n');
+    return prompt;
+}
+// ---------------------------------------------------------------------------
+// Markdown Extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the markdown spec document from a chat() response.
+ *
+ * Headless coding agents (and occasionally chat models) wrap the document
+ * in prose ("Here is the spec:") or a ```markdown fence — writing that
+ * verbatim would pollute the spec file. Since the spec template always
+ * starts with a heading, the extraction is:
+ * 1. If a fenced block contains a markdown heading, use its content.
+ * 2. Else strip any prose before the first heading line.
+ * 3. Otherwise return the response trimmed.
+ *
+ * Provider-agnostic: applies identically to coding-agent and OpenAI paths.
+ */
+function extractMarkdown(raw) {
+    const text = raw.trim();
+    if (!text)
+        return '';
+    // Fast path: already a clean markdown document. Also guards against
+    // misfiring on code fences INSIDE a document (e.g. a bash comment like
+    // "# do something" would otherwise look like a wrapped document).
+    if (/^#\s/.test(text))
+        return text;
+    // 1. Whole-document fence wrapper containing a heading
+    const fenceMatch = /```(?:markdown|md)?\s*\n([\s\S]*?)```/.exec(text);
+    if (fenceMatch && /^#\s/m.test(fenceMatch[1])) {
+        return fenceMatch[1].trim();
+    }
+    // 2. Prose preamble before the first heading
+    const headingMatch = /^#\s.*$/m.exec(text);
+    if (headingMatch) {
+        return text.slice(headingMatch.index).trim();
+    }
+    return text;
+}
+// ---------------------------------------------------------------------------
+// Spec Generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate spec documents for a list of commit clusters.
+ *
+ * @param clusters - Clusters to generate specs for.
+ * @param client - Resolved LLM client (coding agent, configured LLM, or
+ *   a fallback composite — resolution happens in `llm/factory`).
+ * @param outputDir - Directory to write generated spec files.
+ * @param templateContent - Optional custom template string.
+ * @param onProgress - Optional progress callback (called per cluster).
+ * @returns Generation result with generated specs and stats.
+ */
+async function generateSpecs(clusters, client, outputDir, templateContent, onProgress) {
+    // Use custom template if provided, otherwise use default
+    const effectiveTemplate = templateContent || prompts_1.DEFAULT_SPEC_TEMPLATE;
+    // Ensure output directory exists
+    fs.mkdirSync(outputDir, { recursive: true });
+    const specs = [];
+    let skipped = 0;
+    let errors = 0;
+    const total = clusters.length;
+    for (let ci = 0; ci < clusters.length; ci++) {
+        const cluster = clusters[ci];
+        const specId = `spec_${cluster.timeRange.end}`;
+        const msg = `${specId} (${cluster.commits.length} commits)`;
+        onProgress?.({
+            phase: 'generating',
+            current: ci + 1,
+            total,
+            message: msg,
+        });
+        (0, errors_1.logDebug)('Generating spec for cluster', {
+            specId,
+            commitCount: cluster.commits.length,
+        });
+        const userPrompt = buildClusterPrompt(cluster, effectiveTemplate);
+        let raw;
+        try {
+            raw = await client.chat(prompts_1.SPEC_GENERATION_SYSTEM_PROMPT, userPrompt);
+        }
+        catch (err) {
+            (0, errors_1.logWarn)(`LLM call failed for ${specId}`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            errors++;
+            continue;
+        }
+        if (!raw || raw.trim().length === 0) {
+            (0, errors_1.logWarn)(`LLM returned empty response for ${specId}`);
+            skipped++;
+            continue;
+        }
+        // Unwrap fences / strip prose preamble before persisting
+        const content = extractMarkdown(raw);
+        if (!content) {
+            (0, errors_1.logWarn)(`LLM response had no extractable markdown for ${specId}`);
+            skipped++;
+            continue;
+        }
+        const title = (0, spec_extractor_1.extractTitleFromMarkdown)(content, 'Untitled Spec');
+        const commitHashes = cluster.commits.map((c) => c.commitHash);
+        const spec = {
+            specId,
+            title,
+            content,
+            clusterId: cluster.id,
+            commitHashes,
+        };
+        // Write to output directory
+        const fileName = `${specId}.md`;
+        const outputPath = path.join(outputDir, fileName);
+        try {
+            (0, utils_1.writeFileContent)(outputPath, content);
+            (0, errors_1.logDebug)('Wrote spec file', { path: outputPath });
+            specs.push(spec);
+        }
+        catch (err) {
+            (0, errors_1.logWarn)(`Failed to write spec file ${outputPath}`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            errors++;
+        }
+    }
+    return { specs, skipped, errors };
+}
+//# sourceMappingURL=generator.js.map

package/dist/spec/mine/generator.js.map

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

package/dist/spec/mine/persist.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Mine Persist — writes `spec mine` results into commit4spec.db.
+ *
+ * For each generated spec, persists a SpecNode, all linked CommitNodes,
+ * per-file DiffFragments as CodeFragmentNodes, and the corresponding
+ * spec_commit / commit_fragment relations.
+ *
+ * Reuses the existing DB persistence infrastructure from `src/spec/db/`.
+ *
+ * @module spec/mine/persist
+ */
+import { SqliteDatabase } from '../../db/sqlite-adapter';
+import { GeneratedSpec } from './generator';
+import { CommitCluster } from './clustering';
+import type { ProgressCallback } from '../ui';
+export interface PersistResult {
+    specsWritten: number;
+    commitsWritten: number;
+    fragmentsWritten: number;
+    relationsWritten: number;
+}
+/**
+ * Persist `spec mine` results to the commit4spec.db knowledge graph.
+ *
+ * Idempotent — INSERT OR REPLACE / INSERT OR IGNORE semantics ensure
+ * re-running the pipeline against the same commits is safe.
+ *
+ * @param db        - Open SQLite database handle.
+ * @param repoPath  - Path to the git repository.
+ * @param specs     - Generated specs from the LLM phase.
+ * @param clusters  - Commit clusters (must align with specs by clusterId).
+ * @param outputDir - Directory where generated spec markdown files were written.
+ * @param onProgress - Optional progress callback (called per spec).
+ * @returns Counts of written nodes and relations.
+ */
+export declare function persistToGraph(db: SqliteDatabase, repoPath: string, specs: GeneratedSpec[], clusters: CommitCluster[], outputDir: string, onProgress?: ProgressCallback): PersistResult;
+//# sourceMappingURL=persist.d.ts.map

package/dist/spec/mine/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/spec/mine/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAYzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAM9C,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,aAAa,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,aAAa,CAuGf"}

package/dist/spec/mine/persist.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Mine Persist — writes `spec mine` results into commit4spec.db.
+ *
+ * For each generated spec, persists a SpecNode, all linked CommitNodes,
+ * per-file DiffFragments as CodeFragmentNodes, and the corresponding
+ * spec_commit / commit_fragment relations.
+ *
+ * Reuses the existing DB persistence infrastructure from `src/spec/db/`.
+ *
+ * @module spec/mine/persist
+ */
+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.persistToGraph = persistToGraph;
+const path = __importStar(require("path"));
+const commit_node_1 = require("../db/commit-node");
+const fragment_node_1 = require("../db/fragment-node");
+const relations_1 = require("../db/relations");
+const persist_1 = require("../db/persist");
+const schema_1 = require("../db/schema");
+const diff_parser_1 = require("../build/diff-parser");
+const spec_extractor_1 = require("../build/spec-extractor");
+const errors_1 = require("../../errors");
+// ---------------------------------------------------------------------------
+// persistToGraph
+// ---------------------------------------------------------------------------
+/**
+ * Persist `spec mine` results to the commit4spec.db knowledge graph.
+ *
+ * Idempotent — INSERT OR REPLACE / INSERT OR IGNORE semantics ensure
+ * re-running the pipeline against the same commits is safe.
+ *
+ * @param db        - Open SQLite database handle.
+ * @param repoPath  - Path to the git repository.
+ * @param specs     - Generated specs from the LLM phase.
+ * @param clusters  - Commit clusters (must align with specs by clusterId).
+ * @param outputDir - Directory where generated spec markdown files were written.
+ * @param onProgress - Optional progress callback (called per spec).
+ * @returns Counts of written nodes and relations.
+ */
+function persistToGraph(db, repoPath, specs, clusters, outputDir, onProgress) {
+    // Ensure schema exists (idempotent)
+    (0, schema_1.initSpecSchema)(db);
+    // Build a lookup map: clusterId → CommitCluster
+    const clusterMap = new Map();
+    for (const c of clusters) {
+        clusterMap.set(c.id, c);
+    }
+    // Deduplication — commits can appear in multiple clusters (low threshold)
+    const seenCommitHashes = new Set();
+    let specsWritten = 0;
+    let commitsWritten = 0;
+    let fragmentsWritten = 0;
+    let relationsWritten = 0;
+    const totalSpecs = specs.length;
+    for (let si = 0; si < specs.length; si++) {
+        const spec = specs[si];
+        onProgress?.({
+            phase: 'persisting',
+            current: si + 1,
+            total: totalSpecs,
+            message: spec.specId,
+        });
+        const cluster = clusterMap.get(spec.clusterId);
+        if (!cluster) {
+            (0, errors_1.logDebug)('persistToGraph: spec has no matching cluster', {
+                specId: spec.specId,
+                clusterId: spec.clusterId,
+            });
+            continue;
+        }
+        // ---- SpecNode ----
+        (0, persist_1.upsertSpecFromMetadata)(db, {
+            specId: spec.specId,
+            title: (0, spec_extractor_1.extractTitleFromMarkdown)(spec.content, spec.specId),
+            subtitles: (0, spec_extractor_1.extractMarkdownHeadings)(spec.content),
+            filePath: path.join(outputDir, `${spec.specId}.md`),
+        }, cluster.timeRange.end);
+        specsWritten++;
+        // ---- Commits & Fragments ----
+        // Collect all file paths referenced in this commit's FileChanges for filtering
+        // fragments to only relevant files (avoids inserting irrelevant diff hunks).
+        const relevantFiles = new Set();
+        for (const cc of cluster.commits) {
+            for (const fc of cc.fileChanges) {
+                relevantFiles.add(fc.filePath);
+            }
+        }
+        for (const cc of cluster.commits) {
+            // CommitNode — must be inserted before the relation because
+            // SQLite enforces FOREIGN KEY constraints eagerly and
+            // INSERT OR IGNORE throws on FK violations in Node's SQLite.
+            if (!seenCommitHashes.has(cc.commitHash)) {
+                seenCommitHashes.add(cc.commitHash);
+                const commitNode = {
+                    hash: cc.commitHash,
+                    message: cc.commitMessage,
+                    author: cc.author,
+                    timestamp: cc.timestamp,
+                };
+                (0, commit_node_1.insertCommitNode)(db, commitNode);
+                commitsWritten++;
+            }
+            // Spec → Commit relation
+            (0, relations_1.insertSpecCommitRelation)(db, spec.specId, cc.commitHash, 'SUMMARIZED_FROM');
+            relationsWritten++;
+            // Diff fragments — only files that appear in this commit's AST changes.
+            // Skip git diff if fragments were already persisted in a previous run.
+            const existingFragments = (0, fragment_node_1.findFragmentsByCommit)(db, cc.commitHash);
+            if (existingFragments.length > 0) {
+                for (const frag of existingFragments) {
+                    if (!relevantFiles.has(frag.filePath))
+                        continue;
+                    (0, relations_1.insertCommitFragmentRelation)(db, cc.commitHash, frag.id, 'CONTAINS');
+                    relationsWritten++;
+                }
+            }
+            else {
+                let fragments;
+                try {
+                    fragments = (0, diff_parser_1.analyzeCommitDiff)(repoPath, cc.commitHash);
+                }
+                catch (err) {
+                    (0, errors_1.logWarn)(`persistToGraph: analyzeCommitDiff failed for ${cc.commitHash.slice(0, 7)}`, {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                    continue;
+                }
+                const persisted = (0, persist_1.persistCommitFragments)(db, cc.commitHash, fragments, relevantFiles);
+                fragmentsWritten += persisted.fragmentsInserted;
+                relationsWritten += persisted.relationsCreated;
+            }
+        }
+    }
+    return { specsWritten, commitsWritten, fragmentsWritten, relationsWritten };
+}
+//# sourceMappingURL=persist.js.map

package/dist/spec/mine/persist.js.map

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

package/dist/spec/mine/pipeline.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Mine Pipeline — orchestrates the `spec mine` flow.
+ *
+ * Three-stage pipeline:
+ *   1. Scan commits (AST-level diff extraction)
+ *   2. Cluster commits (multi-signal graph clustering)
+ *   3. Generate specs (LLM-driven spec documents)
+ *
+ * Integrates with the existing meta.json anchor for incremental runs.
+ *
+ * @module spec/mine/pipeline
+ */
+import { LLMConfig, MineConfig } from '../config';
+import { SqliteDatabase } from '../../db/sqlite-adapter';
+import type { ProgressCallback } from '../ui';
+/** Result returned by the mine pipeline. */
+export interface MinePipelineResult {
+    commitsScanned: number;
+    changesFound: number;
+    clusters: number;
+    specsGenerated: number;
+    skippedClusters: number;
+    specsWritten: number;
+    commitsWritten: number;
+    fragmentsWritten: number;
+    relationsWritten: number;
+    errors: string[];
+}
+/**
+ * Run the full reverse-spec pipeline.
+ *
+ * @param repoPath - Path to the git repository.
+ * @param config - Reverse pipeline configuration.
+ * @param llmConfig - LLM configuration (may be null when a coding agent
+ *   — Claude Code / Codex — is available, or when skipLlm is true).
+ * @param db - Optional SQLite database handle for persistence.
+ * @param onProgress - Optional progress callback for real-time feedback.
+ * @returns Pipeline result with stats.
+ */
+export declare function runMinePipeline(repoPath: string, config: MineConfig, llmConfig: LLMConfig | null, db?: SqliteDatabase | null, onProgress?: ProgressCallback): Promise<MinePipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/spec/mine/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/spec/mine/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQlD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAM9C,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,EAAE,GAAE,cAAc,GAAG,IAAW,EAChC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA+M7B"}