@planu/cli 0.63.6 → 0.64.0

package/dist/engine/federation/drift-checker.js

@@ -0,0 +1,114 @@
+// engine/federation/drift-checker.ts — Check drift across federated specs (SPEC-160)
+// Works with local paths only — no network calls.
+import { existsSync, statSync, readdirSync } from 'node:fs';
+import { join, isAbsolute, resolve } from 'node:path';
+import { getProjectLinks } from './federation-store.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Find the spec.md path in a linked repo for the given specId.
+ * Returns undefined when not found.
+ * Shared with cross-repo-resolver to avoid duplicating filesystem traversal logic.
+ */
+export function findSpecPath(linkedRepo, linkedSpecId) {
+    const repoPath = isAbsolute(linkedRepo) ? linkedRepo : resolve(process.cwd(), linkedRepo);
+    const exactPath = join(repoPath, 'planu', 'specs', linkedSpecId, 'spec.md');
+    if (existsSync(exactPath)) {
+        return exactPath;
+    }
+    const specsDir = join(repoPath, 'planu', 'specs');
+    if (!existsSync(specsDir)) {
+        return undefined;
+    }
+    try {
+        const entries = readdirSync(specsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && entry.name.startsWith(linkedSpecId)) {
+                const candidate = join(specsDir, entry.name, 'spec.md');
+                if (existsSync(candidate)) {
+                    return candidate;
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore filesystem errors
+    }
+    return undefined;
+}
+/**
+ * Get the last modification time of a file as an ISO string.
+ */
+function getModifiedAt(filePath) {
+    try {
+        return statSync(filePath).mtime.toISOString();
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Single-link drift check
+// ---------------------------------------------------------------------------
+/**
+ * Check drift for a single federation link.
+ * Drift is signaled when the linked spec exists locally but its mtime is more
+ * recent than the link's lastCheckedAt timestamp (i.e., it changed after we
+ * last verified the link).
+ */
+export function checkLinkDrift(link) {
+    const specPath = findSpecPath(link.linkedRepo, link.linkedSpecId);
+    if (!specPath) {
+        return {
+            link,
+            hasDrift: false,
+            reason: `Linked spec not accessible locally — cannot check drift.`,
+        };
+    }
+    const linkedSpecModifiedAt = getModifiedAt(specPath);
+    if (!linkedSpecModifiedAt) {
+        return {
+            link,
+            hasDrift: false,
+            linkedSpecModifiedAt,
+            reason: 'Could not read modification time of linked spec.',
+        };
+    }
+    if (!link.lastCheckedAt) {
+        return {
+            link,
+            hasDrift: true,
+            linkedSpecModifiedAt,
+            reason: 'Link has never been checked — treat as potentially drifted.',
+        };
+    }
+    const hasDrift = linkedSpecModifiedAt > link.lastCheckedAt;
+    return {
+        link,
+        hasDrift,
+        linkedSpecModifiedAt,
+        reason: hasDrift
+            ? `Linked spec was modified at ${linkedSpecModifiedAt}, after last check at ${link.lastCheckedAt}.`
+            : 'No drift detected — linked spec unchanged since last check.',
+    };
+}
+// ---------------------------------------------------------------------------
+// Full project drift report
+// ---------------------------------------------------------------------------
+/**
+ * Check all federation links for a project and return a drift report.
+ */
+export async function checkProjectFederationDrift(projectId) {
+    const links = await getProjectLinks(projectId);
+    const entries = links.map(checkLinkDrift);
+    const driftedLinks = entries.filter((e) => e.hasDrift).length;
+    return {
+        projectId,
+        checkedAt: new Date().toISOString(),
+        totalLinks: entries.length,
+        driftedLinks,
+        entries,
+    };
+}
+//# sourceMappingURL=drift-checker.js.map

package/dist/engine/federation/drift-checker.js.map

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

package/dist/engine/federation/federation-store.d.ts

@@ -0,0 +1,25 @@
+import type { FederationLink, FederationLinkType } from '../../types/index.js';
+/**
+ * Create or replace a federation link between two specs across repos.
+ * Idempotent: re-linking the same (project, spec, repo, linkedSpec) updates the record.
+ */
+export declare function createFederationLink(params: {
+    projectId: string;
+    specId: string;
+    linkedRepo: string;
+    linkedSpecId: string;
+    linkType: FederationLinkType;
+}): Promise<FederationLink>;
+/**
+ * Get all federation links for a project.
+ */
+export declare function getProjectLinks(projectId: string): Promise<FederationLink[]>;
+/**
+ * Get all federation links for a specific spec within a project.
+ */
+export declare function getSpecLinks(projectId: string, specId: string): Promise<FederationLink[]>;
+/**
+ * Mark a link as checked and set its status.
+ */
+export declare function markLinkChecked(linkId: string, status: FederationLink['status']): Promise<boolean>;
+//# sourceMappingURL=federation-store.d.ts.map

package/dist/engine/federation/federation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-store.d.ts","sourceRoot":"","sources":["../../../src/engine/federation/federation-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAiB/E;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB1B;AAMD;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAElF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAE/F;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/engine/federation/federation-store.js

@@ -0,0 +1,58 @@
+// engine/federation/federation-store.ts — Business logic layer for federation (SPEC-160)
+// Generates link IDs and delegates persistence to storage/federation-store.ts.
+import { saveFederationLink, getLinksByProject, getLinksBySpec, updateLinkStatus, getAllLinks, } from '../../storage/federation-store.js';
+// ---------------------------------------------------------------------------
+// Link creation
+// ---------------------------------------------------------------------------
+function generateLinkId() {
+    return `link_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+/**
+ * Create or replace a federation link between two specs across repos.
+ * Idempotent: re-linking the same (project, spec, repo, linkedSpec) updates the record.
+ */
+export async function createFederationLink(params) {
+    // Idempotent: find an existing link with the same (projectId, specId, linkedRepo, linkedSpecId)
+    const allLinks = await getAllLinks();
+    const existing = allLinks.find((l) => l.projectId === params.projectId &&
+        l.specId === params.specId &&
+        l.linkedRepo === params.linkedRepo &&
+        l.linkedSpecId === params.linkedSpecId);
+    const link = {
+        id: existing?.id ?? generateLinkId(),
+        projectId: params.projectId,
+        specId: params.specId,
+        linkedRepo: params.linkedRepo,
+        linkedSpecId: params.linkedSpecId,
+        linkType: params.linkType,
+        createdAt: existing?.createdAt ?? new Date().toISOString(),
+        status: existing?.status ?? 'unknown',
+    };
+    await saveFederationLink(link);
+    return link;
+}
+// ---------------------------------------------------------------------------
+// Queries
+// ---------------------------------------------------------------------------
+/**
+ * Get all federation links for a project.
+ */
+export async function getProjectLinks(projectId) {
+    return getLinksByProject(projectId);
+}
+/**
+ * Get all federation links for a specific spec within a project.
+ */
+export async function getSpecLinks(projectId, specId) {
+    return getLinksBySpec(projectId, specId);
+}
+// ---------------------------------------------------------------------------
+// Status management
+// ---------------------------------------------------------------------------
+/**
+ * Mark a link as checked and set its status.
+ */
+export async function markLinkChecked(linkId, status) {
+    return updateLinkStatus(linkId, status, new Date().toISOString());
+}
+//# sourceMappingURL=federation-store.js.map

package/dist/engine/federation/federation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-store.js","sourceRoot":"","sources":["../../../src/engine/federation/federation-store.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,+EAA+E;AAG/E,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,mCAAmC,CAAC;AAE3C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,cAAc;IACrB,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAM1C;IACC,gGAAgG;IAChG,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAChC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAC1B,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;QAClC,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,CACzC,CAAC;IAEF,MAAM,IAAI,GAAmB;QAC3B,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,cAAc,EAAE;QACpC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1D,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,SAAS;KACtC,CAAC;IACF,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,MAAc;IAClE,OAAO,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,MAAgC;IAEhC,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './federation-store.js';
+export * from './cross-repo-resolver.js';
+export * from './drift-checker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/federation/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/engine/federation/index.js

@@ -0,0 +1,5 @@
+// engine/federation/index.ts — Barrel export for federation engine (SPEC-160)
+export * from './federation-store.js';
+export * from './cross-repo-resolver.js';
+export * from './drift-checker.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/federation/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/engine/github/spec-ac-analyzer.d.ts

@@ -0,0 +1,40 @@
+import type { AcCoverageStatus, SpecAcCoverageResult } from '../../types/github.js';
+/**
+ * Extract a SPEC-NNN id from a PR branch name.
+ * Returns null when the branch does not follow the SPEC-XXX convention.
+ */
+export declare function extractSpecIdFromBranch(branch: string): string | null;
+/**
+ * Locate the spec.md file for the given specId inside the planu/specs directory.
+ * Returns null when no matching directory is found.
+ */
+export declare function findSpecFile(specId: string, specsRootDir: string): Promise<string | null>;
+/**
+ * Parse acceptance criteria from a spec.md file content.
+ * Returns an empty array when no AC section is found.
+ */
+export declare function parseAcceptanceCriteria(specContent: string): string[];
+/**
+ * Build a set of keywords from a diff that can be matched against an AC text.
+ * Extracts meaningful tokens from added lines only (+lines).
+ */
+export declare function buildDiffKeywords(diff: string): Set<string>;
+/**
+ * Determine coverage status of a single AC text against the diff keywords.
+ * Heuristic: extract meaningful words from the AC text and check how many
+ * appear in the diff keywords set. Score thresholds:
+ *   >= 0.5 → covered
+ *   >= 0.2 → partial
+ *   < 0.2  → missing
+ */
+export declare function assessAcCoverage(acText: string, diffKeywords: Set<string>): AcCoverageStatus;
+/**
+ * Full analysis: given a diff and a specId, loads the AC list and returns
+ * per-criterion coverage plus an overall compliance score.
+ *
+ * @param diff       Raw unified diff text from the PR.
+ * @param specId     Spec identifier, e.g. "SPEC-155".
+ * @param specsRoot  Absolute path to the `planu/specs/` directory.
+ */
+export declare function analyzeSpecCoverage(diff: string, specId: string, specsRoot: string): Promise<SpecAcCoverageResult>;
+//# sourceMappingURL=spec-ac-analyzer.d.ts.map

package/dist/engine/github/spec-ac-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-ac-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/github/spec-ac-analyzer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAkB,MAAM,uBAAuB,CAAC;AAKpG;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgB/F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAe3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,gBAAgB,CA+C5F;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAuD/B"}

package/dist/engine/github/spec-ac-analyzer.js

@@ -0,0 +1,181 @@
+// engine/github/spec-ac-analyzer.ts — Cross-reference PR diff against spec acceptance criteria.
+// Extracts the spec ID from the PR branch, loads its ACs, and determines coverage from the diff.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { stripFrontmatter } from '../frontmatter-parser.js';
+import { extractSection, extractListItems } from '../validator/extractors.js';
+// Pattern: feat/SPEC-123-slug or fix/SPEC-123-slug
+const BRANCH_SPEC_PATTERN = /(?:feat|fix|chore|docs|refactor)\/SPEC-(\d+)/i;
+/**
+ * Extract a SPEC-NNN id from a PR branch name.
+ * Returns null when the branch does not follow the SPEC-XXX convention.
+ */
+export function extractSpecIdFromBranch(branch) {
+    const match = BRANCH_SPEC_PATTERN.exec(branch);
+    if (!match?.[1]) {
+        return null;
+    }
+    return `SPEC-${match[1]}`;
+}
+/**
+ * Locate the spec.md file for the given specId inside the planu/specs directory.
+ * Returns null when no matching directory is found.
+ */
+export async function findSpecFile(specId, specsRootDir) {
+    const { readdir } = await import('node:fs/promises');
+    let entries;
+    try {
+        entries = await readdir(specsRootDir);
+    }
+    catch {
+        return null;
+    }
+    const prefix = specId.toUpperCase() + '-';
+    const dir = entries.find((e) => e.toUpperCase().startsWith(prefix));
+    if (!dir) {
+        return null;
+    }
+    return join(specsRootDir, dir, 'spec.md');
+}
+/**
+ * Parse acceptance criteria from a spec.md file content.
+ * Returns an empty array when no AC section is found.
+ */
+export function parseAcceptanceCriteria(specContent) {
+    const body = stripFrontmatter(specContent);
+    const section = extractSection(body, 'acceptance criteria', 'criterios de aceptaci');
+    if (!section) {
+        return [];
+    }
+    return extractListItems(section);
+}
+/**
+ * Build a set of keywords from a diff that can be matched against an AC text.
+ * Extracts meaningful tokens from added lines only (+lines).
+ */
+export function buildDiffKeywords(diff) {
+    const keywords = new Set();
+    for (const line of diff.split('\n')) {
+        if (!line.startsWith('+') || line.startsWith('+++')) {
+            continue;
+        }
+        // Extract identifier-like tokens (camelCase, snake_case, kebab-case, plain words)
+        const tokens = line.slice(1).match(/[a-zA-Z][a-zA-Z0-9_-]{2,}/g);
+        if (tokens) {
+            for (const tok of tokens) {
+                keywords.add(tok.toLowerCase());
+            }
+        }
+    }
+    return keywords;
+}
+/**
+ * Determine coverage status of a single AC text against the diff keywords.
+ * Heuristic: extract meaningful words from the AC text and check how many
+ * appear in the diff keywords set. Score thresholds:
+ *   >= 0.5 → covered
+ *   >= 0.2 → partial
+ *   < 0.2  → missing
+ */
+export function assessAcCoverage(acText, diffKeywords) {
+    // Normalize: strip checkbox prefix, lowercase
+    const normalized = acText.replace(/^\[[ xX]?\]\s*/, '').toLowerCase();
+    // Extract meaningful words (>3 chars, not common stop-words)
+    const STOP_WORDS = new Set([
+        'the',
+        'and',
+        'for',
+        'with',
+        'that',
+        'this',
+        'are',
+        'have',
+        'from',
+        'not',
+        'all',
+        'any',
+        'its',
+        'can',
+        'will',
+        'when',
+        'been',
+        'than',
+        'also',
+        'into',
+        'over',
+        'after',
+        'some',
+    ]);
+    const words = (normalized.match(/[a-z][a-z0-9]{2,}/g) ?? []).filter((w) => !STOP_WORDS.has(w));
+    if (words.length === 0) {
+        return 'missing';
+    }
+    const matched = words.filter((w) => diffKeywords.has(w)).length;
+    const ratio = matched / words.length;
+    if (ratio >= 0.5) {
+        return 'covered';
+    }
+    if (ratio >= 0.2) {
+        return 'partial';
+    }
+    return 'missing';
+}
+/**
+ * Full analysis: given a diff and a specId, loads the AC list and returns
+ * per-criterion coverage plus an overall compliance score.
+ *
+ * @param diff       Raw unified diff text from the PR.
+ * @param specId     Spec identifier, e.g. "SPEC-155".
+ * @param specsRoot  Absolute path to the `planu/specs/` directory.
+ */
+export async function analyzeSpecCoverage(diff, specId, specsRoot) {
+    const specFile = await findSpecFile(specId, specsRoot);
+    if (!specFile) {
+        return {
+            specId,
+            found: false,
+            criteria: [],
+            coveredCount: 0,
+            partialCount: 0,
+            missingCount: 0,
+            complianceScore: 0,
+        };
+    }
+    let specContent;
+    try {
+        specContent = await readFile(specFile, 'utf-8');
+    }
+    catch {
+        return {
+            specId,
+            found: false,
+            criteria: [],
+            coveredCount: 0,
+            partialCount: 0,
+            missingCount: 0,
+            complianceScore: 0,
+        };
+    }
+    const acList = parseAcceptanceCriteria(specContent);
+    const diffKeywords = buildDiffKeywords(diff);
+    const criteria = acList.map((text) => {
+        const status = assessAcCoverage(text, diffKeywords);
+        return { text, status };
+    });
+    const coveredCount = criteria.filter((c) => c.status === 'covered').length;
+    const partialCount = criteria.filter((c) => c.status === 'partial').length;
+    const missingCount = criteria.filter((c) => c.status === 'missing').length;
+    const total = criteria.length;
+    // Score: covered = 1 point, partial = 0.5 points
+    const score = total > 0 ? Math.round(((coveredCount + partialCount * 0.5) / total) * 100) : 0;
+    return {
+        specId,
+        found: true,
+        criteria,
+        coveredCount,
+        partialCount,
+        missingCount,
+        complianceScore: score,
+    };
+}
+//# sourceMappingURL=spec-ac-analyzer.js.map

package/dist/engine/github/spec-ac-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-ac-analyzer.js","sourceRoot":"","sources":["../../../src/engine/github/spec-ac-analyzer.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,iGAAiG;AAEjG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9E,mDAAmD;AACnD,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,YAAoB;IACrE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACrD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,qBAAqB,EAAE,uBAAuB,CAAC,CAAC;IACrF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QACD,kFAAkF;QAClF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACjE,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,YAAyB;IACxE,8CAA8C;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEtE,6DAA6D;IAC7D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;QACzB,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IAErC,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,MAAc,EACd,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,MAAM;YACN,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,EAAE;YACZ,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM;YACN,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,EAAE;YACZ,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAqB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACrD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE9B,iDAAiD;IACjD,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,GAAG,YAAY,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9F,OAAO;QACL,MAAM;QACN,KAAK,EAAE,IAAI;QACX,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,eAAe,EAAE,KAAK;KACvB,CAAC;AACJ,CAAC"}

package/dist/engine/hooks/handlers/on-impl-change.d.ts

@@ -27,6 +27,8 @@ export declare function findRelatedSpecs(filePath: string, specs: MinimalAnalyza
  * Handle an implementation file change event.
  * Fire-and-forget — all errors are caught internally.
  * When specs array and analyzeSpec function are provided, analyzes related specs.
+ * When autoMarkDone is true (default), specs reaching 100% are automatically
+ * transitioned to 'done' status via the spec store.
  */
-export declare function handleOnImplChange(event: WatcherEvent, projectPath: string, specs?: MinimalAnalyzableSpec[], analyzeSpec?: AnalyzeSpecFn): Promise<ImplChangeAnalysisResult | undefined>;
+export declare function handleOnImplChange(event: WatcherEvent, projectPath: string, specs?: MinimalAnalyzableSpec[], analyzeSpec?: AnalyzeSpecFn, autoMarkDone?: boolean): Promise<ImplChangeAnalysisResult | undefined>;
 //# sourceMappingURL=on-impl-change.d.ts.map

package/dist/engine/hooks/handlers/on-impl-change.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"on-impl-change.d.ts","sourceRoot":"","sources":["../../../../src/engine/hooks/handlers/on-impl-change.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EAExB,aAAa,EACd,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,aAAa,EAAE,CAAC;AAiB9B;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAmB,EAC1B,WAAW,SAAK,GACf,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAmB,EAC1B,WAAW,SAAK,GACf,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,EAAE,GAC7B,qBAAqB,EAAE,CAiCzB;AAMD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,qBAAqB,EAAE,EAC/B,WAAW,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAoD/C"}
+{"version":3,"file":"on-impl-change.d.ts","sourceRoot":"","sources":["../../../../src/engine/hooks/handlers/on-impl-change.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EAExB,aAAa,EACd,MAAM,8BAA8B,CAAC;AAItC,YAAY,EAAE,aAAa,EAAE,CAAC;AAiB9B;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAmB,EAC1B,WAAW,SAAK,GACf,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAmB,EAC1B,WAAW,SAAK,GACf,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,EAAE,GAC7B,qBAAqB,EAAE,CAiCzB;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,qBAAqB,EAAE,EAC/B,WAAW,CAAC,EAAE,aAAa,EAC3B,YAAY,UAAO,GAClB,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAuD/C"}

package/dist/engine/hooks/handlers/on-impl-change.js

@@ -1,6 +1,8 @@
 // engine/hooks/handlers/on-impl-change.ts — on-impl-change hook handler (SPEC-137)
 // Triggered when source implementation files (src/**/*.ts) change.
 // Analyzes related specs, updates completion percentage, auto-reconciles if all criteria met.
+import { updateSpecStatus } from '../../../storage/spec-store.js';
+import { hashProjectPath } from '../../../storage/base-store.js';
 // ---------------------------------------------------------------------------
 // Rate limiter (per spec, 5 min cooldown)
 // ---------------------------------------------------------------------------
@@ -97,8 +99,10 @@ export function findRelatedSpecs(filePath, specs) {
  * Handle an implementation file change event.
  * Fire-and-forget — all errors are caught internally.
  * When specs array and analyzeSpec function are provided, analyzes related specs.
+ * When autoMarkDone is true (default), specs reaching 100% are automatically
+ * transitioned to 'done' status via the spec store.
  */
-export async function handleOnImplChange(event, projectPath, specs, analyzeSpec) {
+export async function handleOnImplChange(event, projectPath, specs, analyzeSpec, autoMarkDone = true) {
     try {
         if (!isSourceFile(event.path)) {
             return;
@@ -130,6 +134,9 @@ export async function handleOnImplChange(event, projectPath, specs, analyzeSpec)
             if (result.completionPct === 100) {
                 autoReconciled = true;
                 console.warn(`[hooks] Auto-reconcile triggered for ${spec.id} (100% completion)`);
+                if (autoMarkDone) {
+                    await markSpecDone(spec.id, projectPath);
+                }
             }
         }
         return {
@@ -142,4 +149,21 @@ export async function handleOnImplChange(event, projectPath, specs, analyzeSpec)
         console.warn(`[hooks] on-impl-change error for ${event.path}:`, err);
     }
 }
+// ---------------------------------------------------------------------------
+// Auto-done helper
+// ---------------------------------------------------------------------------
+/**
+ * Mark a spec as 'done' in the spec store.
+ * Errors are logged but not re-thrown so the hook pipeline continues.
+ */
+async function markSpecDone(specId, projectPath) {
+    try {
+        const projectId = hashProjectPath(projectPath);
+        await updateSpecStatus(projectId, specId, 'done');
+        console.warn(`[hooks] Auto-done: spec ${specId} marked as 'done' in project ${projectId}`);
+    }
+    catch (err) {
+        console.warn(`[hooks] Auto-done failed for ${specId}:`, err);
+    }
+}
 //# sourceMappingURL=on-impl-change.js.map

package/dist/engine/hooks/handlers/on-impl-change.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-impl-change.js","sourceRoot":"","sources":["../../../../src/engine/hooks/handlers/on-impl-change.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"on-impl-change.js","sourceRoot":"","sources":["../../../../src/engine/hooks/handlers/on-impl-change.ts"],"names":[],"mappings":"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"}

package/dist/engine/infrastructure/component-mapper.d.ts

@@ -0,0 +1,9 @@
+import type { InfraSignal, InfraComponent } from '../../types/infrastructure.js';
+/** Normalize environment string to a valid key: 'dev' | 'staging' | 'prod'. Defaults to 'dev'. */
+export declare function resolveEnvironment(environment: string): string;
+/**
+ * Convert detected signals to concrete InfraComponent instances.
+ * Deduplicates by component kind — only the first signal per kind is used.
+ */
+export declare function mapSignalsToComponents(signals: InfraSignal[], environment: string): InfraComponent[];
+//# sourceMappingURL=component-mapper.d.ts.map

package/dist/engine/infrastructure/component-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-mapper.d.ts","sourceRoot":"","sources":["../../../src/engine/infrastructure/component-mapper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAGf,MAAM,+BAA+B,CAAC;AAEvC,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AA4ID;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,cAAc,EAAE,CAsBlB"}