homegraph 1.1.2 → 1.2.0

package/dist/spec/llm/prompts.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * LLM prompt templates for spec self-evolution.
+ *
+ * Extracted from logic-checker.ts and spec-rewriter.ts so evolve modules
+ * don't contain prompt strings directly.
+ *
+ * @module spec/llm/prompts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPEC_EVALUATION_SYSTEM_PROMPT = exports.LOGIC_CHECK_SYSTEM_PROMPT = void 0;
+exports.buildLogicCheckUserPrompt = buildLogicCheckUserPrompt;
+exports.buildSpecEvaluationUserPrompt = buildSpecEvaluationUserPrompt;
+// =============================================================================
+// Logic check prompt
+// =============================================================================
+exports.LOGIC_CHECK_SYSTEM_PROMPT = `You are a code review assistant. Your task is to determine whether a git commit represents a business-logic change (as opposed to purely cosmetic, formatting, comment-only, or test-only changes).
+
+A business-logic change includes:
+- Changes to algorithms, data structures, or control flow
+- Changes to business rules, validation logic, or domain behavior
+- Adding or removing functionality
+- Bug fixes that change behavior
+
+NOT business-logic changes:
+- Whitespace, formatting, or code style changes
+- Comment-only changes
+- Test-only changes (adding tests without changing production code)
+- Configuration changes that don't alter behavior
+- Package/dependency version bumps
+
+Respond with a JSON object:
+{
+  "is_logic_change": true/false,
+  "reason": "Brief explanation of why this is or is not a logic change"
+}`;
+function buildLogicCheckUserPrompt(commitMessage, truncatedDiff) {
+    return `Analyze this commit:
+
+Commit Message: ${commitMessage}
+
+Diff:
+${truncatedDiff}`;
+}
+// =============================================================================
+// Spec evaluation prompt
+// =============================================================================
+exports.SPEC_EVALUATION_SYSTEM_PROMPT = `You are a technical documentation maintainer. Your task is to evaluate whether a git commit requires updating a software design specification (plan.md).
+
+Given the current plan content, the commit message, and the code diff, determine:
+1. Whether the plan needs to be updated (UPDATE), deprecated (DEPRECATE), or left unchanged (UNCHANGED).
+2. If UPDATE: provide the new title, subtitles (as an array of heading-preview strings), and full rewritten plan_content.
+3. If DEPRECATE: provide a brief explanation in the plan_content field.
+
+Response format (JSON):
+{
+  "action": "UPDATE" | "DEPRECATE" | "UNCHANGED",
+  "title": "New spec title (for UPDATE)",
+  "subtitles": ["heading1 → heading2 - preview", ...],
+  "plan_content": "Full rewritten markdown content (for UPDATE) or deprecation reason (for DEPRECATE)"
+}`;
+function buildSpecEvaluationUserPrompt(planContent, commitMessage, truncatedDiff, scheduleNextSpecs) {
+    const scheduleStr = scheduleNextSpecs.length > 0 ? scheduleNextSpecs.join(', ') : 'none';
+    return `Current Plan Content:
+${planContent}
+
+Commit Message:
+${commitMessage}
+
+Code Diff:
+${truncatedDiff}
+
+Scheduled specs to be processed next (for context): ${scheduleStr}`;
+}
+//# sourceMappingURL=prompts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/spec/llm/prompts.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA2BH,8DAUC;AAqBD,sEAmBC;AA3ED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEnE,QAAA,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;EAmBvC,CAAC;AAEH,SAAgB,yBAAyB,CACvC,aAAqB,EACrB,aAAqB;IAErB,OAAO;;kBAES,aAAa;;;EAG7B,aAAa,EAAE,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEnE,QAAA,6BAA6B,GAAG;;;;;;;;;;;;;EAa3C,CAAC;AAEH,SAAgB,6BAA6B,CAC3C,WAAmB,EACnB,aAAqB,EACrB,aAAqB,EACrB,iBAA2B;IAE3B,MAAM,WAAW,GACf,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEvE,OAAO;EACP,WAAW;;;EAGX,aAAa;;;EAGb,aAAa;;sDAEuC,WAAW,EAAE,CAAC;AACpE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,166 @@
+"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

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

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

@@ -0,0 +1,103 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}