specforge-mcp 0.10.0 → 0.11.0

package/dist/engine/actuals/backfill.d.ts

@@ -0,0 +1,14 @@
+import type { Spec } from '../../types/spec/core.js';
+import type { BackfillReport, ConsolidatedActuals } from '../../types/index.js';
+/**
+ * Backfills actuals for specs that have no actuals yet, by deriving from git history.
+ *
+ * This function does NOT persist to spec-store — it returns the report and derived data.
+ * The caller decides whether to persist.
+ */
+export declare function backfillActualsFromGit(projectPath: string, _projectDataDir: string, specs: Spec[]): Promise<BackfillReport>;
+/**
+ * Derives actuals for a single spec and returns a ConsolidatedActuals or null.
+ */
+export declare function deriveAndConsolidateSingle(projectPath: string, spec: Spec): Promise<ConsolidatedActuals | null>;
+//# sourceMappingURL=backfill.d.ts.map

package/dist/engine/actuals/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/engine/actuals/backfill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAkB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAMhG;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAAC,cAAc,CAAC,CAkDzB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAMrC"}

package/dist/engine/actuals/backfill.js

@@ -0,0 +1,62 @@
+import { deriveActualsFromGit } from './git-analyzer.js';
+import { consolidateActuals } from './consolidator.js';
+const ELIGIBLE_STATUSES = new Set(['implementing', 'done']);
+/**
+ * Backfills actuals for specs that have no actuals yet, by deriving from git history.
+ *
+ * This function does NOT persist to spec-store — it returns the report and derived data.
+ * The caller decides whether to persist.
+ */
+export async function backfillActualsFromGit(projectPath, _projectDataDir, specs) {
+    const report = {
+        totalSpecs: specs.length,
+        populated: 0,
+        skipped: 0,
+        noGitData: 0,
+        alreadyHadActuals: 0,
+        totalDerivedHours: 0,
+        results: [],
+    };
+    for (const spec of specs) {
+        if (!ELIGIBLE_STATUSES.has(spec.status)) {
+            report.skipped++;
+            continue;
+        }
+        if (spec.actuals !== null) {
+            report.alreadyHadActuals++;
+            continue;
+        }
+        const gitDerived = await deriveActualsFromGit(projectPath, spec.id);
+        if (!gitDerived) {
+            report.noGitData++;
+            continue;
+        }
+        const hourlyRate = spec.estimation.hourlyRate;
+        const consolidated = consolidateActuals({ hourlyRate }, null, null, gitDerived);
+        /* v8 ignore start */
+        if (!consolidated) {
+            report.noGitData++;
+            continue;
+        }
+        /* v8 ignore stop */
+        report.populated++;
+        report.totalDerivedHours += gitDerived.devHours;
+        const result = {
+            specId: spec.id,
+            actuals: consolidated,
+        };
+        report.results.push(result);
+    }
+    return report;
+}
+/**
+ * Derives actuals for a single spec and returns a ConsolidatedActuals or null.
+ */
+export async function deriveAndConsolidateSingle(projectPath, spec) {
+    const gitDerived = await deriveActualsFromGit(projectPath, spec.id);
+    if (!gitDerived) {
+        return null;
+    }
+    return consolidateActuals({ hourlyRate: spec.estimation.hourlyRate }, null, null, gitDerived);
+}
+//# sourceMappingURL=backfill.js.map

package/dist/engine/actuals/backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/engine/actuals/backfill.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,eAAuB,EACvB,KAAa;IAEb,MAAM,MAAM,GAAmB;QAC7B,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,OAAO,EAAE,EAAE;KACZ,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAC9C,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhF,qBAAqB;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QACD,oBAAoB;QAEpB,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,CAAC,iBAAiB,IAAI,UAAU,CAAC,QAAQ,CAAC;QAEhD,MAAM,MAAM,GAAmB;YAC7B,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,YAAY;SACtB,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAmB,EACnB,IAAU;IAEV,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAChG,CAAC"}

package/dist/engine/actuals/consolidator.d.ts

@@ -0,0 +1,12 @@
+import type { Actuals } from '../../types/estimation.js';
+import type { ActualsWip, ConsolidatedActuals, DerivedActuals } from '../../types/index.js';
+/**
+ * Consolidates multiple actuals sources with priority:
+ *   explicit > WIP > git-derived
+ *
+ * Returns null when no actuals source has any data.
+ */
+export declare function consolidateActuals(specEstimation: {
+    hourlyRate: number;
+}, explicitActuals?: Actuals | null, wipData?: ActualsWip | null, gitDerived?: DerivedActuals | null): ConsolidatedActuals | null;
+//# sourceMappingURL=consolidator.d.ts.map

package/dist/engine/actuals/consolidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidator.d.ts","sourceRoot":"","sources":["../../../src/engine/actuals/consolidator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE5F;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EACtC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,EAChC,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,EAC3B,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI,GACjC,mBAAmB,GAAG,IAAI,CAkB5B"}

package/dist/engine/actuals/consolidator.js

@@ -0,0 +1,54 @@
+/**
+ * Consolidates multiple actuals sources with priority:
+ *   explicit > WIP > git-derived
+ *
+ * Returns null when no actuals source has any data.
+ */
+export function consolidateActuals(specEstimation, explicitActuals, wipData, gitDerived) {
+    if (explicitActuals) {
+        return {
+            ...explicitActuals,
+            source: 'explicit',
+            confidence: 'high',
+        };
+    }
+    if (wipData) {
+        return convertWipToConsolidated(wipData);
+    }
+    if (gitDerived) {
+        return convertGitDerivedToConsolidated(specEstimation, gitDerived);
+    }
+    return null;
+}
+function convertWipToConsolidated(wip) {
+    return {
+        devHours: 0,
+        reviewHours: 0,
+        tokensOpus: wip.tokensOpus,
+        tokensSonnet: wip.tokensSonnet,
+        apiCostUsd: wip.apiCostAccumulated,
+        humanCostUsd: 0,
+        totalCostUsd: wip.apiCostAccumulated,
+        completedAt: wip.lastUpdated,
+        notes: wip.notes,
+        source: 'wip',
+        confidence: 'medium',
+    };
+}
+function convertGitDerivedToConsolidated(specEstimation, gitDerived) {
+    const humanCostUsd = gitDerived.devHours * specEstimation.hourlyRate;
+    return {
+        devHours: gitDerived.devHours,
+        reviewHours: gitDerived.reviewHours,
+        tokensOpus: 0,
+        tokensSonnet: 0,
+        apiCostUsd: 0,
+        humanCostUsd,
+        totalCostUsd: humanCostUsd,
+        completedAt: gitDerived.completedAt,
+        notes: `Derived from ${gitDerived.commitCount} git commit(s), ${gitDerived.linesChanged} lines changed`,
+        source: 'git-derived',
+        confidence: 'low',
+    };
+}
+//# sourceMappingURL=consolidator.js.map

package/dist/engine/actuals/consolidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidator.js","sourceRoot":"","sources":["../../../src/engine/actuals/consolidator.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAAsC,EACtC,eAAgC,EAChC,OAA2B,EAC3B,UAAkC;IAElC,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO;YACL,GAAG,eAAe;YAClB,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,+BAA+B,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAe;IAC/C,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,CAAC,kBAAkB;QAClC,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,GAAG,CAAC,kBAAkB;QACpC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,cAAsC,EACtC,UAA0B;IAE1B,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC;IACrE,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY;QACZ,YAAY,EAAE,YAAY;QAC1B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,KAAK,EAAE,gBAAgB,UAAU,CAAC,WAAW,mBAAmB,UAAU,CAAC,YAAY,gBAAgB;QACvG,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC"}

package/dist/engine/actuals/git-analyzer.d.ts

@@ -0,0 +1,23 @@
+import type { DerivedActuals, GitCommitInfo } from '../../types/index.js';
+/**
+ * Parses git log output in the format produced by:
+ *   git log --format="%H|%aI|%s" --numstat
+ */
+export declare function parseGitLogOutput(output: string): GitCommitInfo[];
+/**
+ * Calculates estimated dev hours from commits.
+ * Sums intervals between consecutive commits, capping each at 2h
+ * (gaps > 2h are treated as overnight pauses and ignored).
+ * Minimum 1h for single-commit specs.
+ */
+export declare function calculateDevHours(commits: GitCommitInfo[]): number;
+/**
+ * Sums insertions + deletions across all commits.
+ */
+export declare function calculateLinesChanged(commits: GitCommitInfo[]): number;
+/**
+ * Derives actuals for a spec by running git log filtered by specId in commit messages.
+ * Returns null if specId is invalid or no commits are found.
+ */
+export declare function deriveActualsFromGit(projectPath: string, specId: string): Promise<DerivedActuals | null>;
+//# sourceMappingURL=git-analyzer.d.ts.map

package/dist/engine/actuals/git-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/actuals/git-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAmBjE;AAqED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CA6BlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAwChC"}

package/dist/engine/actuals/git-analyzer.js

@@ -0,0 +1,169 @@
+// SpecForge — engine/actuals/git-analyzer.ts (SPEC-061)
+// Derives actuals from git log history for a given spec.
+import { execSync } from 'node:child_process';
+const SPEC_ID_PATTERN = /^SPEC-\d+/;
+const MAX_SESSION_GAP_MS = 2 * 60 * 60 * 1000; // 2 hours
+const REVIEW_HOURS_RATIO = 0.15;
+const MINIMUM_DEV_HOURS = 1;
+/**
+ * Parses git log output in the format produced by:
+ *   git log --format="%H|%aI|%s" --numstat
+ */
+export function parseGitLogOutput(output) {
+    const commits = [];
+    const lines = output.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const result = parseNextCommit(lines, i);
+        if (result === null) {
+            i++;
+            continue;
+        }
+        const { commit, nextIndex } = result;
+        if (commit) {
+            commits.push(commit);
+        }
+        i = nextIndex;
+    }
+    return commits;
+}
+function parseNextCommit(lines, startIndex) {
+    const headerLine = lines[startIndex];
+    if (!headerLine?.trim()) {
+        return null;
+    }
+    const headerParts = headerLine.split('|');
+    if (headerParts.length < 3) {
+        return null;
+    }
+    /* v8 ignore start */
+    const hash = headerParts[0] ?? '';
+    const timestamp = headerParts[1] ?? '';
+    /* v8 ignore stop */
+    const message = headerParts.slice(2).join('|');
+    const { insertions, deletions, nextIndex } = parseNumstat(lines, startIndex + 1);
+    const commit = hash.length === 40 ? { hash, timestamp, message, insertions, deletions } : null;
+    return { commit, nextIndex };
+}
+function parseNumstat(lines, startIndex) {
+    let i = startIndex;
+    let insertions = 0;
+    let deletions = 0;
+    // Skip optional blank line separator after header
+    if (lines[i]?.trim() === '') {
+        i++;
+    }
+    // Parse numstat lines (insertions<TAB>deletions<TAB>filename)
+    while (i < lines.length) {
+        const statLine = lines[i];
+        if (!statLine?.trim()) {
+            i++;
+            break;
+        }
+        // Next header line detection: 40-char hex hash followed by |
+        if (/^[0-9a-f]{40}\|/.test(statLine)) {
+            break;
+        }
+        const statParts = statLine.split('\t');
+        /* v8 ignore start */
+        const ins = parseInt(statParts[0] ?? '0', 10);
+        const del = parseInt(statParts[1] ?? '0', 10);
+        /* v8 ignore stop */
+        if (!isNaN(ins)) {
+            insertions += ins;
+        }
+        if (!isNaN(del)) {
+            deletions += del;
+        }
+        i++;
+    }
+    return { insertions, deletions, nextIndex: i };
+}
+/**
+ * Calculates estimated dev hours from commits.
+ * Sums intervals between consecutive commits, capping each at 2h
+ * (gaps > 2h are treated as overnight pauses and ignored).
+ * Minimum 1h for single-commit specs.
+ */
+export function calculateDevHours(commits) {
+    if (commits.length === 0) {
+        return 0;
+    }
+    if (commits.length === 1) {
+        return MINIMUM_DEV_HOURS;
+    }
+    const sorted = [...commits].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    let totalMs = 0;
+    for (let i = 1; i < sorted.length; i++) {
+        const prev = sorted[i - 1];
+        const curr = sorted[i];
+        /* v8 ignore start */
+        if (!prev || !curr) {
+            continue;
+        }
+        /* v8 ignore stop */
+        const gap = new Date(curr.timestamp).getTime() - new Date(prev.timestamp).getTime();
+        if (gap > 0 && gap <= MAX_SESSION_GAP_MS) {
+            totalMs += gap;
+        }
+    }
+    const hours = totalMs / (1000 * 60 * 60);
+    return Math.max(MINIMUM_DEV_HOURS, Math.round(hours * 10) / 10);
+}
+/**
+ * Sums insertions + deletions across all commits.
+ */
+export function calculateLinesChanged(commits) {
+    return commits.reduce((acc, c) => acc + c.insertions + c.deletions, 0);
+}
+/**
+ * Derives actuals for a spec by running git log filtered by specId in commit messages.
+ * Returns null if specId is invalid or no commits are found.
+ */
+export function deriveActualsFromGit(projectPath, specId) {
+    if (!SPEC_ID_PATTERN.test(specId)) {
+        return Promise.resolve(null);
+    }
+    const gitOutput = runGitLog(projectPath, specId);
+    if (!gitOutput) {
+        return Promise.resolve(null);
+    }
+    const commits = parseGitLogOutput(gitOutput);
+    if (commits.length === 0) {
+        return Promise.resolve(null);
+    }
+    const sorted = [...commits].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    const firstCommit = sorted[0];
+    const lastCommit = sorted[sorted.length - 1];
+    /* v8 ignore start */
+    if (!firstCommit || !lastCommit) {
+        return Promise.resolve(null);
+    }
+    /* v8 ignore stop */
+    const devHours = calculateDevHours(commits);
+    const linesChanged = calculateLinesChanged(commits);
+    return Promise.resolve({
+        devHours,
+        reviewHours: Math.round(devHours * REVIEW_HOURS_RATIO * 10) / 10,
+        commitCount: commits.length,
+        linesChanged,
+        firstCommitDate: firstCommit.timestamp,
+        lastCommitDate: lastCommit.timestamp,
+        completedAt: lastCommit.timestamp,
+        source: 'git-log',
+    });
+}
+function runGitLog(projectPath, specId) {
+    try {
+        const result = execSync(`git log --format="%H|%aI|%s" --numstat --all --grep="${specId}"`, {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-analyzer.js.map

package/dist/engine/actuals/git-analyzer.js.map

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

package/dist/engine/actuals/index.d.ts

@@ -0,0 +1,5 @@
+export { parseGitLogOutput, calculateDevHours, calculateLinesChanged, deriveActualsFromGit, } from './git-analyzer.js';
+export { getWipPath, readWip, writeWip, deleteWip, updateWip } from './wip-tracker.js';
+export { consolidateActuals } from './consolidator.js';
+export { backfillActualsFromGit, deriveAndConsolidateSingle } from './backfill.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/actuals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/actuals/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/actuals/index.js

@@ -0,0 +1,7 @@
+// SpecForge — engine/actuals/index.ts (SPEC-061)
+// Barrel exports for the actuals engine module.
+export { parseGitLogOutput, calculateDevHours, calculateLinesChanged, deriveActualsFromGit, } from './git-analyzer.js';
+export { getWipPath, readWip, writeWip, deleteWip, updateWip } from './wip-tracker.js';
+export { consolidateActuals } from './consolidator.js';
+export { backfillActualsFromGit, deriveAndConsolidateSingle } from './backfill.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/actuals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/actuals/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,gDAAgD;AAEhD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/actuals/wip-tracker.d.ts

@@ -0,0 +1,25 @@
+import type { ActualsWip } from '../../types/index.js';
+/**
+ * Returns the path to the WIP JSON file for a given spec.
+ */
+export declare function getWipPath(projectDataDir: string, specId: string): string;
+/**
+ * Reads WIP actuals for a spec from disk.
+ * Returns null if the file does not exist or cannot be parsed.
+ */
+export declare function readWip(projectDataDir: string, specId: string): ActualsWip | null;
+/**
+ * Writes WIP actuals for a spec to disk.
+ * Creates the directory if it does not exist.
+ */
+export declare function writeWip(projectDataDir: string, specId: string, wip: ActualsWip): void;
+/**
+ * Deletes the WIP actuals file for a spec if it exists.
+ */
+export declare function deleteWip(projectDataDir: string, specId: string): void;
+/**
+ * Reads existing WIP, merges updates, and writes back.
+ * If no existing WIP, creates a new one with defaults merged with updates.
+ */
+export declare function updateWip(projectDataDir: string, specId: string, updates: Partial<ActualsWip>): ActualsWip;
+//# sourceMappingURL=wip-tracker.d.ts.map

package/dist/engine/actuals/wip-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wip-tracker.d.ts","sourceRoot":"","sources":["../../../src/engine/actuals/wip-tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQjF;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAKtF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOtE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAC3B,UAAU,CAsBZ"}

package/dist/engine/actuals/wip-tracker.js

@@ -0,0 +1,71 @@
+// SpecForge — engine/actuals/wip-tracker.ts (SPEC-061)
+// Simple JSON file persistence for WIP actuals during implementation.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Returns the path to the WIP JSON file for a given spec.
+ */
+export function getWipPath(projectDataDir, specId) {
+    return path.join(projectDataDir, 'actuals-wip', `${specId}.json`);
+}
+/**
+ * Reads WIP actuals for a spec from disk.
+ * Returns null if the file does not exist or cannot be parsed.
+ */
+export function readWip(projectDataDir, specId) {
+    const filePath = getWipPath(projectDataDir, specId);
+    try {
+        const content = fs.readFileSync(filePath, { encoding: 'utf-8' });
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Writes WIP actuals for a spec to disk.
+ * Creates the directory if it does not exist.
+ */
+export function writeWip(projectDataDir, specId, wip) {
+    const filePath = getWipPath(projectDataDir, specId);
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(wip, null, 2), { encoding: 'utf-8' });
+}
+/**
+ * Deletes the WIP actuals file for a spec if it exists.
+ */
+export function deleteWip(projectDataDir, specId) {
+    const filePath = getWipPath(projectDataDir, specId);
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        // File doesn't exist — nothing to do
+    }
+}
+/**
+ * Reads existing WIP, merges updates, and writes back.
+ * If no existing WIP, creates a new one with defaults merged with updates.
+ */
+export function updateWip(projectDataDir, specId, updates) {
+    const existing = readWip(projectDataDir, specId);
+    const now = new Date().toISOString();
+    const base = existing ?? {
+        specId,
+        startedAt: now,
+        tokensOpus: 0,
+        tokensSonnet: 0,
+        apiCostAccumulated: 0,
+        lastUpdated: now,
+        notes: '',
+    };
+    const merged = {
+        ...base,
+        ...updates,
+        lastUpdated: now,
+    };
+    writeWip(projectDataDir, specId, merged);
+    return merged;
+}
+//# sourceMappingURL=wip-tracker.js.map

package/dist/engine/actuals/wip-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wip-tracker.js","sourceRoot":"","sources":["../../../src/engine/actuals/wip-tracker.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,sEAAsE;AACtE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,cAAsB,EAAE,MAAc;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,cAAsB,EAAE,MAAc;IAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,cAAsB,EAAE,MAAc,EAAE,GAAe;IAC9E,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,cAAsB,EAAE,MAAc;IAC9D,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,cAAsB,EACtB,MAAc,EACd,OAA4B;IAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,IAAI,GAAe,QAAQ,IAAI;QACnC,MAAM;QACN,SAAS,EAAE,GAAG;QACd,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,kBAAkB,EAAE,CAAC;QACrB,WAAW,EAAE,GAAG;QAChB,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,MAAM,MAAM,GAAe;QACzB,GAAG,IAAI;QACP,GAAG,OAAO;QACV,WAAW,EAAE,GAAG;KACjB,CAAC;IAEF,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/doc-generator/executive-summary/data-extractors.d.ts

@@ -0,0 +1,12 @@
+import type { Spec, ProjectKnowledge, ExecutiveSummarySpecEntry, AggregatedEstimation, RiskProfile, ArchitectureSnapshot, ExecutiveSummaryData } from '../../../types/index.js';
+/** Map a Spec to an ExecutiveSummarySpecEntry. */
+export declare function extractSpecEntries(specs: Spec[]): ExecutiveSummarySpecEntry[];
+/** Sum all estimation fields across all specs. */
+export declare function aggregateEstimation(specs: Spec[]): AggregatedEstimation;
+/** Count specs by risk level; highlights = titles of high/critical specs. */
+export declare function buildRiskProfile(specs: Spec[]): RiskProfile;
+/** Extract architecture snapshot from ProjectKnowledge. */
+export declare function buildArchitectureSnapshot(knowledge: ProjectKnowledge): ArchitectureSnapshot;
+/** Orchestrate all extractors to build the full ExecutiveSummaryData. */
+export declare function buildExecutiveSummaryData(knowledge: ProjectKnowledge, specs: Spec[]): ExecutiveSummaryData;
+//# sourceMappingURL=data-extractors.d.ts.map

package/dist/engine/doc-generator/executive-summary/data-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-extractors.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/data-extractors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAEjC,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,yBAAyB,EAAE,CAsB7E;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,oBAAoB,CAuBvE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CA2B3D;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,oBAAoB,CAS3F;AAED,yEAAyE;AACzE,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,GACZ,oBAAoB,CAYtB"}

package/dist/engine/doc-generator/executive-summary/data-extractors.js

@@ -0,0 +1,96 @@
+/** Map a Spec to an ExecutiveSummarySpecEntry. */
+export function extractSpecEntries(specs) {
+    return specs.map((spec) => {
+        const entry = {
+            id: spec.id,
+            title: spec.title,
+            status: spec.status,
+            difficulty: spec.difficulty,
+            risk: spec.risk,
+            devHours: spec.estimation.devHours,
+            reviewHours: spec.estimation.reviewHours,
+            totalCostUsd: spec.estimation.totalCostUsd,
+            tags: spec.tags,
+        };
+        if (spec.actuals !== null) {
+            entry.actualDevHours = spec.actuals.devHours;
+            entry.actualTotalCostUsd = spec.actuals.totalCostUsd;
+            entry.completedAt = spec.actuals.completedAt;
+        }
+        return entry;
+    });
+}
+/** Sum all estimation fields across all specs. */
+export function aggregateEstimation(specs) {
+    let totalDevHours = 0;
+    let totalReviewHours = 0;
+    let totalHumanCostUsd = 0;
+    let totalApiCostUsd = 0;
+    let totalCostUsd = 0;
+    for (const spec of specs) {
+        totalDevHours += spec.estimation.devHours;
+        totalReviewHours += spec.estimation.reviewHours;
+        totalHumanCostUsd += spec.estimation.humanCostUsd;
+        totalApiCostUsd += spec.estimation.apiCostUsd;
+        totalCostUsd += spec.estimation.totalCostUsd;
+    }
+    return {
+        totalDevHours,
+        totalReviewHours,
+        totalHumanCostUsd,
+        totalApiCostUsd,
+        totalCostUsd,
+        specCount: specs.length,
+    };
+}
+/** Count specs by risk level; highlights = titles of high/critical specs. */
+export function buildRiskProfile(specs) {
+    let low = 0;
+    let medium = 0;
+    let high = 0;
+    let critical = 0;
+    const highlights = [];
+    for (const spec of specs) {
+        switch (spec.risk) {
+            case 'low':
+                low++;
+                break;
+            case 'medium':
+                medium++;
+                break;
+            case 'high':
+                high++;
+                highlights.push(spec.title);
+                break;
+            case 'critical':
+                critical++;
+                highlights.push(spec.title);
+                break;
+        }
+    }
+    return { low, medium, high, critical, highlights };
+}
+/** Extract architecture snapshot from ProjectKnowledge. */
+export function buildArchitectureSnapshot(knowledge) {
+    const layers = knowledge.architecture.layers.map((l) => l.name);
+    return {
+        language: knowledge.language,
+        framework: knowledge.framework ?? 'none',
+        database: knowledge.database,
+        layers,
+    };
+}
+/** Orchestrate all extractors to build the full ExecutiveSummaryData. */
+export function buildExecutiveSummaryData(knowledge, specs) {
+    const pathSegments = knowledge.projectPath.split('/');
+    const projectName = pathSegments[pathSegments.length - 1] ?? knowledge.projectPath;
+    return {
+        projectName,
+        generatedAt: new Date().toISOString(),
+        architecture: buildArchitectureSnapshot(knowledge),
+        specs: extractSpecEntries(specs),
+        estimation: aggregateEstimation(specs),
+        riskProfile: buildRiskProfile(specs),
+    };
+}
+//# sourceMappingURL=data-extractors.js.map

package/dist/engine/doc-generator/executive-summary/data-extractors.js.map

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

package/dist/engine/doc-generator/executive-summary/executive-summary-generator.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectKnowledge, Spec, GeneratedDocument } from '../../../types/index.js';
+/**
+ * Generate a self-contained HTML executive summary document.
+ * Returns a GeneratedDocument with type 'executive-summary'.
+ */
+export declare function generateExecutiveSummary(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+//# sourceMappingURL=executive-summary-generator.d.ts.map

package/dist/engine/doc-generator/executive-summary/executive-summary-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executive-summary-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/executive-summary-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAmBzF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAiCnB"}