homegraph 1.5.1 → 1.5.3

package/dist/spec/evolve/llm-client.js

@@ -1,176 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LLMClient = void 0;
-/**
- * Provider-agnostic LLM client for spec self-evolution.
- *
- * Replaces `commit4spec/utils/llm_client.py`. Supports OpenAI-compatible chat
- * completions API with mock mode for testing. Mock responses are consumed
- * FIFO: each `setMockResponse` call adds one response, each `chat` call
- * consumes one. When the mock queue is empty, pattern-based fallback responses
- * are returned.
- *
- * @module spec/evolve/llm-client
- */
-const openai_1 = __importDefault(require("openai"));
-const errors_1 = require("../../errors");
-// =============================================================================
-// LLMClient
-// =============================================================================
-class LLMClient {
-    config;
-    mockResponses;
-    constructor(config) {
-        this.config = config;
-        this.mockResponses = [];
-    }
-    /**
-     * Append a mock response to the FIFO queue.
-     *
-     * When provider is `"mock"`, `chat()` dequeues the first response.
-     * Responses are consumed in insertion order; each call to `chat()` removes
-     * and returns the front element.
-     */
-    setMockResponse(_key, response) {
-        this.mockResponses.push(response);
-    }
-    /**
-     * Clear all mock responses.
-     */
-    clearMockResponses() {
-        this.mockResponses = [];
-    }
-    // ===========================================================================
-    // chat
-    // ===========================================================================
-    /**
-     * Send a chat completion request and return the message content string.
-     *
-     * **Mock mode** (`provider === "mock"`):
-     * 1. If mockResponses has entries, consumes the first one (FIFO).
-     * 2. Otherwise matches `userPrompt` against known patterns (case-insensitive):
-     *    - `"logic change"` or `"logic_change"` → no-op JSON.
-     *    - `"spec evolution"` or `"evolve"` → UNCHANGED JSON.
-     *    - Default → UNCHANGED JSON.
-     *
-     * **OpenAI / Anthropic mode**:
-     * Calls the OpenAI-compatible chat completions API and returns
-     * `choices[0].message.content`. On any error, returns an empty string.
-     */
-    async chat(systemPrompt, userPrompt) {
-        // --- Mock mode -------------------------------------------------------
-        if (this.config.provider === 'mock') {
-            if (this.mockResponses.length > 0) {
-                return this.mockResponses.shift();
-            }
-            const lower = userPrompt.toLowerCase();
-            if (lower.includes('logic change') || lower.includes('logic_change')) {
-                return JSON.stringify({
-                    is_logic_change: false,
-                    reason: 'Mock: no logic change detected',
-                });
-            }
-            if (lower.includes('spec evolution') || lower.includes('evolve')) {
-                return JSON.stringify({
-                    action: 'UNCHANGED',
-                    reason: 'Mock: no changes needed',
-                });
-            }
-            return JSON.stringify({
-                action: 'UNCHANGED',
-                reason: 'Mock: default no-op response',
-            });
-        }
-        // --- OpenAI / Anthropic mode -----------------------------------------
-        const baseURL = this.config.baseUrl
-            ? this.config.baseUrl
-            : this.config.provider === 'anthropic'
-                ? 'https://api.anthropic.com/v1'
-                : undefined;
-        const client = new openai_1.default({
-            apiKey: this.config.apiKey || 'sk-placeholder',
-            baseURL,
-        });
-        try {
-            const completion = await client.chat.completions.create({
-                model: this.config.model,
-                temperature: this.config.temperature,
-                max_tokens: this.config.maxTokens,
-                messages: [
-                    { role: 'system', content: systemPrompt },
-                    { role: 'user', content: userPrompt },
-                ],
-            });
-            const content = completion.choices[0]?.message?.content;
-            return content ?? '';
-        }
-        catch {
-            return '';
-        }
-    }
-    // ===========================================================================
-    // chatJson
-    // ===========================================================================
-    /**
-     * Same as `chat()`, but parses the response as JSON.
-     *
-     * Parsing strategy (tried in order):
-     * 1. Direct `JSON.parse(content)`.
-     * 2. Extract from `` ```json ... ``` `` fenced block.
-     * 3. Extract from `` ``` ... ``` `` fenced block.
-     * 4. Fallback: log a debug warning and return `{}`.
-     *
-     * Empty or null content from `chat()` also returns `{}`.
-     */
-    async chatJson(systemPrompt, userPrompt) {
-        const raw = await this.chat(systemPrompt, userPrompt);
-        if (!raw)
-            return {};
-        // 1. Direct parse
-        try {
-            const parsed = JSON.parse(raw);
-            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                return parsed;
-            }
-        }
-        catch {
-            // Fall through to fence extraction
-        }
-        // 2. ```json ... ``` fence
-        const jsonFenceMatch = /```json\s*([\s\S]*?)```/.exec(raw);
-        if (jsonFenceMatch) {
-            try {
-                const parsed = JSON.parse(jsonFenceMatch[1].trim());
-                if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                    return parsed;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        // 3. ``` ... ``` fence
-        const fenceMatch = /```\s*([\s\S]*?)```/.exec(raw);
-        if (fenceMatch) {
-            try {
-                const parsed = JSON.parse(fenceMatch[1].trim());
-                if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                    return parsed;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        // 4. Fallback
-        (0, errors_1.logDebug)('chatJson: could not parse response as JSON', {
-            raw: raw.length > 200 ? raw.slice(0, 200) + '…' : raw,
-        });
-        return {};
-    }
-}
-exports.LLMClient = LLMClient;
-//# sourceMappingURL=llm-client.js.map

package/dist/spec/evolve/llm-client.js.map

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

package/dist/spec/evolve/logic-checker.d.ts

@@ -1,12 +0,0 @@
-import { LlmClient } from '../llm/client';
-export interface LogicCheckResult {
-    isLogic: boolean;
-    reason: string;
-}
-/**
- * Determine if a commit represents a business-logic change.
- * Uses LLM to analyze the commit message and diff.
- * If no LLM client is available, returns false.
- */
-export declare function isLogicChange(commitMessage: string, commitDiff: string, client?: LlmClient): Promise<LogicCheckResult>;
-//# sourceMappingURL=logic-checker.d.ts.map

package/dist/spec/evolve/logic-checker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logic-checker.d.ts","sourceRoot":"","sources":["../../../src/spec/evolve/logic-checker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}

package/dist/spec/evolve/logic-checker.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isLogicChange = isLogicChange;
-const prompts_1 = require("../llm/prompts");
-const utils_1 = require("../utils");
-/**
- * Determine if a commit represents a business-logic change.
- * Uses LLM to analyze the commit message and diff.
- * If no LLM client is available, returns false.
- */
-async function isLogicChange(commitMessage, commitDiff, client) {
-    if (!client) {
-        return { isLogic: false, reason: 'LLM unavailable' };
-    }
-    // Truncate diff to 6000 chars for prompt budget
-    const truncatedDiff = (0, utils_1.truncateText)(commitDiff, 6000);
-    const userPrompt = (0, prompts_1.buildLogicCheckUserPrompt)(commitMessage, truncatedDiff);
-    const result = await client.chatJson(prompts_1.LOGIC_CHECK_SYSTEM_PROMPT, userPrompt);
-    return {
-        isLogic: result.is_logic_change === true,
-        reason: typeof result.reason === 'string' ? result.reason : '',
-    };
-}
-//# sourceMappingURL=logic-checker.js.map

package/dist/spec/evolve/logic-checker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logic-checker.js","sourceRoot":"","sources":["../../../src/spec/evolve/logic-checker.ts"],"names":[],"mappings":";;AAcA,sCAoBC;AAjCD,4CAAsF;AACtF,oCAAwC;AAOxC;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,aAAqB,EACrB,UAAkB,EAClB,MAAkB;IAElB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACvD,CAAC;IAED,gDAAgD;IAChD,MAAM,aAAa,GAAG,IAAA,oBAAY,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,IAAA,mCAAyB,EAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,mCAAyB,EAAE,UAAU,CAAC,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,eAAe,KAAK,IAAI;QACxC,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;KAC/D,CAAC;AACJ,CAAC"}

package/dist/spec/llm/index.d.ts

@@ -1,3 +0,0 @@
-export { LlmClient, OpenAiLlmClient } from './client';
-export { LOGIC_CHECK_SYSTEM_PROMPT, buildLogicCheckUserPrompt, SPEC_EVALUATION_SYSTEM_PROMPT, buildSpecEvaluationUserPrompt, } from './prompts';
-//# sourceMappingURL=index.d.ts.map

package/dist/spec/llm/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,WAAW,CAAC"}

package/dist/spec/llm/index.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSpecEvaluationUserPrompt = exports.SPEC_EVALUATION_SYSTEM_PROMPT = exports.buildLogicCheckUserPrompt = exports.LOGIC_CHECK_SYSTEM_PROMPT = exports.OpenAiLlmClient = void 0;
-var client_1 = require("./client");
-Object.defineProperty(exports, "OpenAiLlmClient", { enumerable: true, get: function () { return client_1.OpenAiLlmClient; } });
-var prompts_1 = require("./prompts");
-Object.defineProperty(exports, "LOGIC_CHECK_SYSTEM_PROMPT", { enumerable: true, get: function () { return prompts_1.LOGIC_CHECK_SYSTEM_PROMPT; } });
-Object.defineProperty(exports, "buildLogicCheckUserPrompt", { enumerable: true, get: function () { return prompts_1.buildLogicCheckUserPrompt; } });
-Object.defineProperty(exports, "SPEC_EVALUATION_SYSTEM_PROMPT", { enumerable: true, get: function () { return prompts_1.SPEC_EVALUATION_SYSTEM_PROMPT; } });
-Object.defineProperty(exports, "buildSpecEvaluationUserPrompt", { enumerable: true, get: function () { return prompts_1.buildSpecEvaluationUserPrompt; } });
-//# sourceMappingURL=index.js.map

package/dist/spec/llm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spec/llm/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAAlC,yGAAA,eAAe,OAAA;AACnC,qCAKmB;AAJjB,oHAAA,yBAAyB,OAAA;AACzB,oHAAA,yBAAyB,OAAA;AACzB,wHAAA,6BAA6B,OAAA;AAC7B,wHAAA,6BAA6B,OAAA"}

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

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

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

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

package/dist/spec/mining/diff-parser.js

@@ -1,166 +0,0 @@
-"use strict";
-/**
- * Unified diff parser — converts `git diff` output into structured code
- * fragments.
- *
- * Replaces `commit4spec/reverse_engineer/change_analyzer.py`.  Parses
- * unified diff output and extracts file-level change information (change
- * type, line range, diff text).
- *
- * @module spec/mining/diff-parser
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeCommitDiff = analyzeCommitDiff;
-const git_scanner_1 = require("./git-scanner");
-// ---------------------------------------------------------------------------
-// analyzeCommitDiff
-// ---------------------------------------------------------------------------
-/**
- * Retrieve and parse the diff for a single commit.
- *
- * 1. Call `getCommitDiff(repoPath, commitHash)` to get raw diff text.
- * 2. Parse the diff into structured `DiffFragment` objects.
- * 3. Return the fragments.
- *
- * Returns an empty array when the diff cannot be retrieved or is empty.
- */
-function analyzeCommitDiff(repoPath, commitHash, preFetchedDiff) {
-    const diff = preFetchedDiff ?? (0, git_scanner_1.getCommitDiff)(repoPath, commitHash);
-    if (!diff) {
-        return [];
-    }
-    return _parseDiff(diff);
-}
-// ---------------------------------------------------------------------------
-// _parseDiff
-// ---------------------------------------------------------------------------
-/**
- * State-machine parser for unified diff format.
- *
- * Walks through the diff line-by-line, tracking the current file, change
- * type, and line-number range.  Accumulates lines into a buffer and emits a
- * `DiffFragment` each time a new `diff --git` section begins (or when the
- * input is exhausted).
- */
-function _parseDiff(diff) {
-    const lines = diff.split('\n');
-    // ---- state ----
-    const fragments = [];
-    let buf = [];
-    let currentFilePath = null;
-    let currentChangeType = 'MODIFY';
-    let currentStartLine = 0;
-    let currentEndLine = 0;
-    let inHunk = false;
-    // ---- flush helper ----
-    const _flush = () => {
-        if (buf.length === 0 || currentFilePath === null) {
-            buf = [];
-            return;
-        }
-        // DELETE files have no lines in the new version — use [0, 0].
-        let startLine;
-        let endLine;
-        if (currentChangeType === 'DELETE') {
-            startLine = 0;
-            endLine = 0;
-        }
-        else {
-            // When no hunk was ever encountered, default startLine to 1.
-            startLine = currentStartLine === 0 ? 1 : currentStartLine;
-            endLine = currentEndLine;
-        }
-        fragments.push({
-            filePath: currentFilePath,
-            changeType: currentChangeType,
-            startLine,
-            endLine,
-            codeDiff: buf.join('\n'),
-        });
-        buf = [];
-    };
-    // ---- line-by-line parser ----
-    for (const line of lines) {
-        // Rule 1 — new file section: flush the previous file.
-        if (line.startsWith('diff --git ')) {
-            _flush();
-            buf = [line];
-            currentFilePath = null;
-            currentChangeType = 'MODIFY';
-            currentStartLine = 0;
-            currentEndLine = 0;
-            inHunk = false;
-            continue;
-        }
-        // Rule 2 — new file mode → change type is ADD.
-        if (line.startsWith('new file mode ')) {
-            currentChangeType = 'ADD';
-            buf.push(line);
-            continue;
-        }
-        // Rule 3 — deleted file mode → change type is DELETE.
-        if (line.startsWith('deleted file mode ')) {
-            currentChangeType = 'DELETE';
-            buf.push(line);
-            continue;
-        }
-        // Rule 4 — file path lines (--- a/path or +++ b/path).
-        if (line.startsWith('--- a/') || line.startsWith('+++ b/')) {
-            const isPlus = line.startsWith('+++ b/');
-            // Extract the path, skipping `/dev/null`.
-            let pathPart = '';
-            if (isPlus) {
-                pathPart = line.slice(6); // '+++ b/'.length
-            }
-            else {
-                pathPart = line.slice(6); // '--- a/'.length
-            }
-            if (pathPart !== '/dev/null') {
-                currentFilePath = pathPart;
-            }
-            buf.push(line);
-            continue;
-        }
-        // Rule 5 — hunk header: @@ -oldStart[,oldCount] +newStart[,newCount] @@
-        const hunkMatch = line.match(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/);
-        if (hunkMatch) {
-            const newStart = parseInt(hunkMatch[1], 10);
-            if (currentStartLine === 0) {
-                currentStartLine = newStart;
-            }
-            currentEndLine = newStart;
-            inHunk = true;
-            buf.push(line);
-            continue;
-        }
-        // Rule 6 — added lines (start with '+', but not '+++').
-        if (line.startsWith('+') && !line.startsWith('+++')) {
-            if (inHunk) {
-                currentEndLine++;
-            }
-            buf.push(line);
-            continue;
-        }
-        // Rule 7 — removed lines (start with '-', but not '---').
-        if (line.startsWith('-') && !line.startsWith('---')) {
-            buf.push(line);
-            continue;
-        }
-        // Rule 8 — context lines (start with a space).
-        if (line.startsWith(' ')) {
-            if (inHunk) {
-                currentEndLine++;
-            }
-            buf.push(line);
-            continue;
-        }
-        // Rule 9 — all other lines (e.g. `rename from` / `rename to`,
-        // `similarity index`, `Binary files differ`, `\ No newline at end of
-        // file`, blank lines between sections, etc.).
-        buf.push(line);
-    }
-    // Flush the final file.
-    _flush();
-    return fragments;
-}
-//# sourceMappingURL=diff-parser.js.map

package/dist/spec/mining/diff-parser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"diff-parser.js","sourceRoot":"","sources":["../../../src/spec/mining/diff-parser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAkCH,8CAUC;AA1CD,+CAA8C;AAmB9C,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,UAAkB,EAClB,cAAuB;IAEvB,MAAM,IAAI,GAAG,cAAc,IAAI,IAAA,2BAAa,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACnE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,kBAAkB;IAClB,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,IAAI,GAAG,GAAa,EAAE,CAAC;IACvB,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,iBAAiB,GAAgC,QAAQ,CAAC;IAC9D,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,yBAAyB;IACzB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YACjD,GAAG,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QAED,8DAA8D;QAC9D,IAAI,SAAiB,CAAC;QACtB,IAAI,OAAe,CAAC;QACpB,IAAI,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YACnC,SAAS,GAAG,CAAC,CAAC;YACd,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,SAAS,GAAG,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC1D,OAAO,GAAG,cAAc,CAAC;QAC3B,CAAC;QAED,SAAS,CAAC,IAAI,CAAC;YACb,QAAQ,EAAE,eAAe;YACzB,UAAU,EAAE,iBAAiB;YAC7B,SAAS;YACT,OAAO;YACP,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;SACzB,CAAC,CAAC;QAEH,GAAG,GAAG,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,gCAAgC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAEzB,sDAAsD;QACtD,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACnC,MAAM,EAAE,CAAC;YACT,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YACb,eAAe,GAAG,IAAI,CAAC;YACvB,iBAAiB,GAAG,QAAQ,CAAC;YAC7B,gBAAgB,GAAG,CAAC,CAAC;YACrB,cAAc,GAAG,CAAC,CAAC;YACnB,MAAM,GAAG,KAAK,CAAC;YACf,SAAS;QACX,CAAC;QAED,+CAA+C;QAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtC,iBAAiB,GAAG,KAAK,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,sDAAsD;QACtD,IAAI,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC1C,iBAAiB,GAAG,QAAQ,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,uDAAuD;QACvD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEzC,0CAA0C;YAC1C,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB;YAC9C,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB;YAC9C,CAAC;YAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,eAAe,GAAG,QAAQ,CAAC;YAC7B,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,wEAAwE;QACxE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACtE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;gBAC3B,gBAAgB,GAAG,QAAQ,CAAC;YAC9B,CAAC;YACD,cAAc,GAAG,QAAQ,CAAC;YAC1B,MAAM,GAAG,IAAI,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,wDAAwD;QACxD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,MAAM,EAAE,CAAC;gBACX,cAAc,EAAE,CAAC;YACnB,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,+CAA+C;QAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,MAAM,EAAE,CAAC;gBACX,cAAc,EAAE,CAAC;YACnB,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,8DAA8D;QAC9D,qEAAqE;QACrE,8CAA8C;QAC9C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,wBAAwB;IACxB,MAAM,EAAE,CAAC;IAET,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/spec/mining/git-scanner.d.ts

@@ -1,103 +0,0 @@
-/**
- * Git commit history scanning and spec↔commit pairing.
- *
- * Replaces `commit4spec/reverse_engineer/git_scanner.py` and
- * `commit4spec/reverse_engineer/git_utils.py`. Discovers spec↔commit pairs via
- * two strategies:
- *
- *  - **Strategy A — commit message scope:** extract conventional-commit scopes
- *    from commit messages and resolve them to spec IDs on disk.
- *  - **Strategy B — commit-info.md:** discover specs on disk, read their
- *    `commit-info.md` for linked commit hashes, and verify those commits exist.
- *
- * All Git operations use `execFileSync` with an args array (never template
- * strings) to avoid shell injection risks — matching the HomeGraph convention
- * in `src/sync/git-hooks.ts` and `src/sync/worktree.ts`.
- *
- * @module spec/mining/git-scanner
- */
-import { SpecConfig } from '../config';
-import { SpecMetadata } from './spec-extractor';
-export interface CommitInfo {
-    /** Full 40-char commit hash */
-    hash: string;
-    /** First line of commit message */
-    message: string;
-    /** Author name */
-    author: string;
-    /** Unix epoch milliseconds */
-    timestamp: number;
-}
-export interface SpecCommitPair {
-    specId: string;
-    commitHash: string;
-    specMetadata: SpecMetadata | null;
-    commitMetadata: CommitInfo | null;
-}
-/**
- * Check whether `repoPath` is a git repository.
- *
- * Runs `git rev-parse --git-dir` and returns `true` on success, `false`
- * when the command fails (not a repo, git not installed, etc.).
- */
-export declare function isGitRepo(repoPath: string): boolean;
-/**
- * Return every commit in `repoPath` as `CommitInfo` objects.
- *
- * Runs `git log --format='%H%n%aI%n%an%n%s%n---END---'` and parses the
- * output one five-line block per commit.  Commits are returned in reverse
- * chronological order (most recent first), matching Git's default.
- *
- * An empty repo yields an empty array.
- */
-export declare function getAllCommits(repoPath: string): CommitInfo[];
-/**
- * Retrieve metadata for a single commit.
- *
- * Runs `git show -s --format='%H%n%aI%n%an%n%s' <commitHash>`.  Returns
- * `null` when the command fails (hash not found, invalid repo, etc.).
- */
-export declare function getCommitInfo(repoPath: string, commitHash: string): CommitInfo | null;
-/**
- * Return the full unified diff introduced by `commitHash`.
- *
- * Strategy:
- * 1. Query the parent hash(es) via `git log --pretty=%P -n 1 <commitHash>`.
- * 2. If a parent exists, diff it against the commit: `git diff <parent> <commitHash>`.
- * 3. For an initial (root) commit with no parent, use `git diff <commitHash>`
- *    which shows all files added in that commit.
- *
- * Returns an empty string when any Git command fails.
- */
-export declare function getCommitDiff(repoPath: string, commitHash: string): string;
-/**
- * Return every commit between `fromHash` (exclusive) and `toHash`
- * (inclusive) in chronological order (oldest first).
- *
- * Runs `git log --reverse --format="..." fromHash..toHash`. Returns an empty
- * array when either hash is not found or the range is empty.
- *
- * Callers should validate that `fromHash` is an ancestor of `toHash` before
- * calling this function (use `git merge-base --is-ancestor`).  Results are
- * undefined when the two hashes are on unrelated branches.
- */
-export declare function getCommitRange(repoPath: string, fromHash: string, toHash: string): CommitInfo[];
-/**
- * Main scanning function — discovers spec↔commit pairs using two strategies.
- *
- * **Strategy A — commit message scope:**
- * Iterates every commit in the repo, extracts a conventional-commit scope from
- * its message, normalizes it, and checks whether the resulting spec ID exists
- * on disk. When a match is found the pair is recorded with full spec and
- * commit metadata.
- *
- * **Strategy B — commit-info.md:**
- * Discovers all specs on disk that were **not** already paired by Strategy A,
- * reads their metadata (which may include a commit hash from `commit-info.md`),
- * and verifies the commit exists in the repo. Verified pairs are added.
- *
- * Duplicates (identical specId + commitHash) are de-duplicated via a
- * `Map` keyed on `"${specId}|${commitHash}"`.
- */
-export declare function scan(repoPath: string, specStoragePath: string, config: SpecConfig): SpecCommitPair[];
-//# sourceMappingURL=git-scanner.d.ts.map

package/dist/spec/mining/git-scanner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-scanner.d.ts","sourceRoot":"","sources":["../../../src/spec/mining/git-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAuB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrE,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC;AA8BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOnD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAkC5D;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,UAAU,GAAG,IAAI,CA4BnB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAmC1E;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,UAAU,EAAE,CAgCd;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,UAAU,GACjB,cAAc,EAAE,CA+ElB"}