homegraph 1.5.0 → 1.5.1

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

@@ -1,93 +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
- * conventional-commit scope extraction: extracts scopes from commit messages
- * and resolves them to spec IDs on disk.
- *
- * 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/build/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 from commit history.
- *
- * 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.
- *
- * 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/build/git-scanner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-scanner.d.ts","sourceRoot":"","sources":["../../../src/spec/build/git-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAuB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQrE,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;AAmBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOnD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAiC5D;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,CA4C1E;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,UAAU,EAAE,CAiCd;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,UAAU,GACjB,cAAc,EAAE,CA6BlB"}

package/dist/spec/build/git-scanner.js

@@ -1,254 +0,0 @@
-"use strict";
-/**
- * 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
- * conventional-commit scope extraction: extracts scopes from commit messages
- * and resolves them to spec IDs on disk.
- *
- * 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/build/git-scanner
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isGitRepo = isGitRepo;
-exports.getAllCommits = getAllCommits;
-exports.getCommitInfo = getCommitInfo;
-exports.getCommitDiff = getCommitDiff;
-exports.getCommitRange = getCommitRange;
-exports.scan = scan;
-const child_process_1 = require("child_process");
-const scope_resolver_1 = require("./scope-resolver");
-const spec_extractor_1 = require("./spec-extractor");
-const errors_1 = require("../../errors");
-const git_utils_1 = require("../git-utils");
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Convert an ISO-8601 string to Unix epoch milliseconds.
- * Returns 0 for invalid or unparseable strings.
- */
-function parseISOTimestamp(isoString) {
-    const ts = new Date(isoString).getTime();
-    return isNaN(ts) ? 0 : ts;
-}
-// ---------------------------------------------------------------------------
-// isGitRepo
-// ---------------------------------------------------------------------------
-/**
- * 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.).
- */
-function isGitRepo(repoPath) {
-    try {
-        (0, child_process_1.execFileSync)('git', ['rev-parse', '--git-dir'], (0, git_utils_1.gitExecOptions)(repoPath));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ---------------------------------------------------------------------------
-// getAllCommits
-// ---------------------------------------------------------------------------
-/**
- * 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.
- */
-function getAllCommits(repoPath) {
-    let stdout;
-    try {
-        stdout = (0, child_process_1.execFileSync)('git', ['log', "--format=%H%x00%aI%x00%an%x00%s%x00"], (0, git_utils_1.gitExecOptions)(repoPath));
-    }
-    catch {
-        return [];
-    }
-    const parts = stdout.replace(/\0+$/, '').trim().split('\0');
-    const commits = [];
-    // Each commit occupies 4 NUL-separated fields: hash, timestamp, author, message
-    for (let i = 0; i + 3 < parts.length; i += 4) {
-        const hash = parts[i].trim();
-        const isoString = parts[i + 1].trim();
-        const author = parts[i + 2].trim();
-        const message = parts[i + 3].trim();
-        if (!hash)
-            continue;
-        commits.push({
-            hash,
-            message,
-            author,
-            timestamp: parseISOTimestamp(isoString),
-        });
-    }
-    return commits;
-}
-// ---------------------------------------------------------------------------
-// getCommitInfo
-// ---------------------------------------------------------------------------
-/**
- * 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.).
- */
-function getCommitInfo(repoPath, commitHash) {
-    let stdout;
-    try {
-        stdout = (0, child_process_1.execFileSync)('git', ['show', '-s', "--format=%H%n%aI%n%an%n%s", commitHash], (0, git_utils_1.gitExecOptions)(repoPath));
-    }
-    catch {
-        return null;
-    }
-    const lines = stdout.trim().split('\n');
-    if (lines.length < 4)
-        return null;
-    const hash = lines[0].trim();
-    const isoString = lines[1].trim();
-    const author = lines[2].trim();
-    const message = lines[3].trim();
-    if (!hash)
-        return null;
-    return {
-        hash,
-        message,
-        author,
-        timestamp: parseISOTimestamp(isoString),
-    };
-}
-// ---------------------------------------------------------------------------
-// getCommitDiff
-// ---------------------------------------------------------------------------
-/**
- * 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.
- */
-function getCommitDiff(repoPath, commitHash) {
-    // Step 1 — get parent hashes.
-    let parentStdout;
-    try {
-        parentStdout = (0, child_process_1.execFileSync)('git', ['log', '--pretty=%P', '-n', '1', commitHash], (0, git_utils_1.gitExecOptions)(repoPath));
-    }
-    catch {
-        return '';
-    }
-    const parents = parentStdout.trim().split(/\s+/).filter(Boolean);
-    // Step 2 & 3 — run the appropriate diff.
-    try {
-        if (parents.length > 0) {
-            const diffs = [];
-            for (const parent of parents) {
-                try {
-                    diffs.push((0, child_process_1.execFileSync)('git', ['diff', parent, commitHash], (0, git_utils_1.gitExecOptions)(repoPath)));
-                }
-                catch {
-                    // Skip diffs that fail for an individual parent
-                }
-            }
-            return diffs.join('\n');
-        }
-        // Initial commit — no parent.
-        return (0, child_process_1.execFileSync)('git', ['diff', commitHash], (0, git_utils_1.gitExecOptions)(repoPath));
-    }
-    catch {
-        return '';
-    }
-}
-// ---------------------------------------------------------------------------
-// getCommitRange
-// ---------------------------------------------------------------------------
-/**
- * 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.
- */
-function getCommitRange(repoPath, fromHash, toHash) {
-    let stdout;
-    try {
-        stdout = (0, child_process_1.execFileSync)('git', ['log', '--no-merges', '--reverse', `--format=%H%x00%aI%x00%an%x00%s%x00`, `${fromHash}..${toHash}`], (0, git_utils_1.gitExecOptions)(repoPath));
-    }
-    catch {
-        return [];
-    }
-    const parts = stdout.replace(/\0+$/, '').trim().split('\0');
-    const commits = [];
-    // Each commit occupies 4 NUL-separated fields: hash, timestamp, author, message
-    for (let i = 0; i + 3 < parts.length; i += 4) {
-        const hash = parts[i].trim();
-        const isoString = parts[i + 1].trim();
-        const author = parts[i + 2].trim();
-        const message = parts[i + 3].trim();
-        if (!hash)
-            continue;
-        commits.push({
-            hash,
-            message,
-            author,
-            timestamp: parseISOTimestamp(isoString),
-        });
-    }
-    return commits;
-}
-// ---------------------------------------------------------------------------
-// scan
-// ---------------------------------------------------------------------------
-/**
- * Main scanning function — discovers spec↔commit pairs from commit history.
- *
- * 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.
- *
- * Duplicates (identical specId + commitHash) are de-duplicated via a
- * `Map` keyed on `"${specId}|${commitHash}"`.
- */
-function scan(repoPath, specStoragePath, config) {
-    const pairs = new Map();
-    const commits = getAllCommits(repoPath);
-    for (const commit of commits) {
-        const specId = (0, scope_resolver_1.resolveScopeToSpec)(commit.message, specStoragePath, config);
-        if (!specId) {
-            (0, errors_1.logDebug)('scan: no scope match', {
-                commitHash: commit.hash.slice(0, 7),
-                message: commit.message,
-            });
-            continue;
-        }
-        const specMetadata = (0, spec_extractor_1.extractSpecMetadata)(specStoragePath, specId, config);
-        const key = `${specId}|${commit.hash}`;
-        if (!pairs.has(key)) {
-            pairs.set(key, {
-                specId,
-                commitHash: commit.hash,
-                specMetadata,
-                commitMetadata: commit,
-            });
-        }
-    }
-    return Array.from(pairs.values());
-}
-//# sourceMappingURL=git-scanner.js.map

package/dist/spec/build/git-scanner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-scanner.js","sourceRoot":"","sources":["../../../src/spec/build/git-scanner.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAsDH,8BAOC;AAeD,sCAiCC;AAYD,sCA+BC;AAiBD,sCA4CC;AAiBD,wCAqCC;AAiBD,oBAiCC;AA3TD,iDAA6C;AAE7C,qDAAsD;AACtD,qDAAqE;AACrE,yCAAwC;AACxC,4CAA8C;AAwB9C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACzC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,IAAA,0BAAc,EAAC,QAAQ,CAAC,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,QAAgB;IAC5C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,4BAAY,EACnB,KAAK,EACL,CAAC,KAAK,EAAE,qCAAqC,CAAC,EAC9C,IAAA,0BAAc,EAAC,QAAQ,CAAC,CACzB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,gFAAgF;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAErC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,OAAO;YACP,MAAM;YACN,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAgB,aAAa,CAC3B,QAAgB,EAChB,UAAkB;IAElB,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,4BAAY,EACnB,KAAK,EACL,CAAC,MAAM,EAAE,IAAI,EAAE,2BAA2B,EAAE,UAAU,CAAC,EACvD,IAAA,0BAAc,EAAC,QAAQ,CAAC,CACzB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAEjC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,OAAO;QACL,IAAI;QACJ,OAAO;QACP,MAAM;QACN,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAAC,QAAgB,EAAE,UAAkB;IAChE,8BAA8B;IAC9B,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACH,YAAY,GAAG,IAAA,4BAAY,EACzB,KAAK,EACL,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,EAC7C,IAAA,0BAAc,EAAC,QAAQ,CAAC,CACzB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEjE,yCAAyC;IACzC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CACR,IAAA,4BAAY,EACV,KAAK,EACL,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAC5B,IAAA,0BAAc,EAAC,QAAQ,CAAC,CACzB,CACF,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,gDAAgD;gBAClD,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,8BAA8B;QAC9B,OAAO,IAAA,4BAAY,EACjB,KAAK,EACL,CAAC,MAAM,EAAE,UAAU,CAAC,EACpB,IAAA,0BAAc,EAAC,QAAQ,CAAC,CACzB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,QAAgB,EAChB,MAAc;IAEd,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,4BAAY,EACnB,KAAK,EACL,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,qCAAqC,EAAE,GAAG,QAAQ,KAAK,MAAM,EAAE,CAAC,EACpG,IAAA,0BAAc,EAAC,QAAQ,CAAC,CACzB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,gFAAgF;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAErC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,OAAO;YACP,MAAM;YACN,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAgB,IAAI,CAClB,QAAgB,EAChB,eAAuB,EACvB,MAAkB;IAElB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEhD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAA,mCAAkB,EAAC,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAA,iBAAQ,EAAC,sBAAsB,EAAE;gBAC/B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,IAAA,oCAAmB,EAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1E,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACb,MAAM;gBACN,UAAU,EAAE,MAAM,CAAC,IAAI;gBACvB,YAAY;gBACZ,cAAc,EAAE,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/spec/git-utils.d.ts

@@ -1,8 +0,0 @@
-/** Shared options for all `execFileSync` Git calls across the spec module. */
-export declare function gitExecOptions(repoPath: string): {
-    cwd: string;
-    encoding: "utf8";
-    stdio: (number | import("stream") | import("child_process").IOType | "ipc" | null | undefined)[];
-    windowsHide: boolean;
-};
-//# sourceMappingURL=git-utils.d.ts.map

package/dist/spec/git-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../src/spec/git-utils.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM;;;;;EAQ9C"}

package/dist/spec/git-utils.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.gitExecOptions = gitExecOptions;
-/** Shared options for all `execFileSync` Git calls across the spec module. */
-function gitExecOptions(repoPath) {
-    const stdio = ['ignore', 'pipe', 'ignore'];
-    return {
-        cwd: repoPath,
-        encoding: 'utf8',
-        stdio,
-        windowsHide: true,
-    };
-}
-//# sourceMappingURL=git-utils.js.map

package/dist/spec/git-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/spec/git-utils.ts"],"names":[],"mappings":";;AAGA,wCAQC;AATD,8EAA8E;AAC9E,SAAgB,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,MAAe;QACzB,KAAK;QACL,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}

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

@@ -1,63 +0,0 @@
-/**
- * Commit Clusterer — multi-signal graph clustering for the `spec mine` pipeline.
- *
- * Groups commits by structural (AST symbol overlap), file-path, temporal,
- * and commit-message similarity. Pure TypeScript implementation — no native
- * dependencies required.
- *
- * Algorithm: Leiden community detection on a weighted similarity graph.
- * Replaces Louvain and connected-components (single-linkage) to avoid chaining
- * all commits into one giant cluster and to guarantee well-connected communities
- * via the refinement phase. A resolution parameter γ is auto-tuned via
- * multiplicative search so the output community count stays close to maxClusters.
- *
- * @module spec/mine/clusterer
- */
-import { CommitChange } from './scanner';
-/** A cluster of semantically-related commits. */
-export interface CommitCluster {
-    id: number;
-    commits: CommitChange[];
-    primaryFiles: string[];
-    primarySymbols: string[];
-    summary: string;
-    timeRange: {
-        start: number;
-        end: number;
-    };
-}
-/** Full clustering result including unclustered outliers and stats. */
-export interface ClusterResult {
-    clusters: CommitCluster[];
-    unclustered: CommitChange[];
-    stats: {
-        totalCommits: number;
-        clusteredCommits: number;
-        clusterCount: number;
-    };
-}
-/**
- * Cluster commits using Leiden community detection on a multi-signal
- * similarity graph, with recursive sub-splitting for large clusters.
- *
- * The pipeline:
- *   1. Build a weighted similarity graph from AST symbol, file-path,
- *      commit-message TF-IDF, ticket-reference, and temporal signals.
- *   2. Run Leiden community detection with auto-tuned resolution γ.
- *   3. Greedy-merge if still too many communities.
- *   4. Recursively split large clusters (≥ 4 commits) by running
- *      Leiden on their sub-graphs.
- *
- * Replaces the previous Louvain (no refinement) and connected-components
- * (single-linkage chaining) approaches.
- *
- * @param changes     - AST change data for each commit.
- * @param threshold   - Minimum similarity (0-1) for considering an edge.
- * @param maxClusters - Desired maximum number of top-level clusters.
- *                      The resolution parameter γ is auto-tuned to approach
- *                      this target. Recursive splitting may produce more
- *                      clusters at finer granularities.
- * @returns Clustered result with stats.
- */
-export declare function clusterCommits(changes: CommitChange[], threshold: number, maxClusters: number): ClusterResult;
-//# sourceMappingURL=clusterer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"clusterer.d.ts","sourceRoot":"","sources":["../../../src/spec/mine/clusterer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQzC,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAs1BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,aAAa,CA0Mf"}