critical-gate 2.0.1 → 2.1.0

package/dist/reporters/repair-contract.js

@@ -0,0 +1,25 @@
+export function renderFindingRepairContract(finding) {
+    const contract = finding.repairContract;
+    if (contract === undefined) {
+        return finding.repair;
+    }
+    return [
+        `Repair contract for ${finding.id}`,
+        "",
+        "Instructions:",
+        ...contract.instructions.map((instruction) => `- ${instruction}`),
+        "",
+        "Allowed files:",
+        ...renderList(contract.allowedFiles),
+        "",
+        "Forbidden files:",
+        ...renderList(contract.forbiddenFiles),
+        "",
+        "Success criteria:",
+        ...contract.successCriteria.map((criterion) => `- ${criterion}`)
+    ].join("\n");
+}
+function renderList(values) {
+    return values.length === 0 ? ["- None."] : values.map((value) => `- ${value}`);
+}
+//# sourceMappingURL=repair-contract.js.map

package/dist/reporters/repair-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-contract.js","sourceRoot":"","sources":["../../src/reporters/repair-contract.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAExC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,OAAO;QACL,uBAAuB,OAAO,CAAC,EAAE,EAAE;QACnC,EAAE;QACF,eAAe;QACf,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC;QACjE,EAAE;QACF,gBAAgB;QAChB,GAAG,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpC,EAAE;QACF,kBAAkB;QAClB,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;QACtC,EAAE;QACF,mBAAmB;QACnB,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;KACjE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,MAAgB;IAClC,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/reporters/repair-reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repair-reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/repair-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAI9D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAkB7D"}
+{"version":3,"file":"repair-reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/repair-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAK9D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAkB7D"}

package/dist/reporters/repair-reporter.js

@@ -1,3 +1,4 @@
+import { renderFindingRepairContract } from "./repair-contract.js";
 const maxRepairFindings = 5;
 export function renderRepairReport(result) {
     if (result.findings.length === 0) {
@@ -35,10 +36,27 @@ function renderRepairFinding(finding, index) {
     return [
         `${index}. ${finding.severity.toUpperCase()}: ${finding.title}`,
         `${finding.message}${location}`,
-        `Repair: ${finding.repair}`,
+        ...renderReasonChain(finding),
+        "Repair Contract:",
+        indent(renderFindingRepairContract(finding)),
         ""
     ];
 }
+function indent(value) {
+    return value
+        .split("\n")
+        .map((line) => (line.length === 0 ? "" : `  ${line}`))
+        .join("\n");
+}
+function renderReasonChain(finding) {
+    if (finding.reasonChain === undefined) {
+        return [];
+    }
+    return [
+        `Why suspicious: ${finding.reasonChain.whySuspicious}`,
+        `Acceptable if: ${finding.reasonChain.acceptableIf[0] ?? "the change is explicitly justified."}`
+    ];
+}
 function severityRank(severity) {
     switch (severity) {
         case "blocker":

package/dist/reporters/repair-reporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"repair-reporter.js","sourceRoot":"","sources":["../../src/reporters/repair-reporter.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;SAClC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SACjF,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE/B,MAAM,KAAK,GAAG;QACZ,gDAAgD;QAChD,EAAE;QACF,GAAG,2BAA2B,CAAC,MAAM,CAAC;QACtC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChF,qDAAqD;KACtD,CAAC;IAEF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;AAC3C,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAkB;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACjD,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAE5E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,0BAA0B,KAAK,CAAC,KAAK,KAAK;QAC1C,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAClE,EAAE;KACH,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgB,EAAE,KAAa;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,QAAQ,GACZ,QAAQ,EAAE,IAAI,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,cAAc,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;IAExG,OAAO;QACL,GAAG,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;QAC/D,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,EAAE;QAC/B,WAAW,OAAO,CAAC,MAAM,EAAE;QAC3B,EAAE;KACH,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAA6B;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}
+{"version":3,"file":"repair-reporter.js","sourceRoot":"","sources":["../../src/reporters/repair-reporter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;SAClC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SACjF,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE/B,MAAM,KAAK,GAAG;QACZ,gDAAgD;QAChD,EAAE;QACF,GAAG,2BAA2B,CAAC,MAAM,CAAC;QACtC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChF,qDAAqD;KACtD,CAAC;IAEF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;AAC3C,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAkB;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACjD,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAE5E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,0BAA0B,KAAK,CAAC,KAAK,KAAK;QAC1C,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAClE,EAAE;KACH,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgB,EAAE,KAAa;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,QAAQ,GACZ,QAAQ,EAAE,IAAI,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,cAAc,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC;IAExG,OAAO;QACL,GAAG,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE;QAC/D,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,EAAE;QAC/B,GAAG,iBAAiB,CAAC,OAAO,CAAC;QAC7B,kBAAkB;QAClB,MAAM,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;QAC5C,EAAE;KACH,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK;SACT,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;SACrD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,mBAAmB,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE;QACtD,kBAAkB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,qCAAqC,EAAE;KACjG,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAA6B;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/reporters/reviewer-checklist.d.ts

@@ -0,0 +1,10 @@
+import type { GateResult } from "../schema/index.js";
+export interface ReviewerChecklistItem {
+    text: string;
+    source: "blocking-finding" | "observation" | "changed-role" | "score" | "intent";
+    findingId?: string;
+    evidence?: string;
+}
+export declare function buildReviewerChecklist(result: GateResult, limit?: number): ReviewerChecklistItem[];
+export declare function renderReviewerChecklist(result: GateResult, heading: string): string[];
+//# sourceMappingURL=reviewer-checklist.d.ts.map

package/dist/reporters/reviewer-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer-checklist.d.ts","sourceRoot":"","sources":["../../src/reporters/reviewer-checklist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,SAAI,GAAG,qBAAqB,EAAE,CA0C7F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBrF"}

package/dist/reporters/reviewer-checklist.js

@@ -0,0 +1,112 @@
+import { calibrateFindingConfidence } from "../detectors/confidence-calibration.js";
+export function buildReviewerChecklist(result, limit = 8) {
+    const items = [];
+    const blockingFindings = result.findings.filter(isBlockingFinding);
+    const observations = result.findings.filter((finding) => !isBlockingFinding(finding));
+    for (const finding of blockingFindings.slice(0, 4)) {
+        items.push({
+            source: "blocking-finding",
+            findingId: finding.id,
+            text: `Resolve or explicitly accept ${finding.title}.`,
+            evidence: formatPrimaryEvidence(finding)
+        });
+    }
+    for (const finding of observations.slice(0, Math.max(0, 5 - items.length))) {
+        items.push({
+            source: "observation",
+            findingId: finding.id,
+            text: `Review non-blocking ${finding.detector} signal: ${finding.title}.`,
+            evidence: formatPrimaryEvidence(finding)
+        });
+    }
+    appendRoleChecklistItems(items, result.diff.files);
+    if ((result.intentQuality?.warnings.length ?? 0) > 0) {
+        items.push({
+            source: "intent",
+            text: "Confirm the task intent is specific enough to bound the diff.",
+            evidence: result.intentQuality?.warnings[0]?.message
+        });
+    }
+    if ((result.summary.diffCoherenceScore?.score ?? 100) < 75) {
+        items.push({
+            source: "score",
+            text: "Check whether the changed files form one coherent task-shaped diff.",
+            evidence: `Diff coherence ${result.summary.diffCoherenceScore?.score ?? 0}/100`
+        });
+    }
+    return dedupeChecklist(items).slice(0, limit);
+}
+export function renderReviewerChecklist(result, heading) {
+    const items = buildReviewerChecklist(result);
+    if (items.length === 0) {
+        return [heading, "", "- [ ] No specific review prompts generated from this diff.", ""];
+    }
+    return [
+        heading,
+        "",
+        ...items.map((item) => {
+            const evidence = item.evidence === undefined ? "" : ` Evidence: ${item.evidence}.`;
+            return `- [ ] ${item.text}${evidence}`;
+        }),
+        ""
+    ];
+}
+function isBlockingFinding(finding) {
+    return calibrateFindingConfidence(finding).blockingEligible;
+}
+function appendRoleChecklistItems(items, files) {
+    const roles = new Set(files.map((file) => file.role));
+    if (roles.has("test")) {
+        items.push({
+            source: "changed-role",
+            text: "Confirm changed tests still assert behavior, not only rendering or existence.",
+            evidence: summarizeRoleFiles(files, "test")
+        });
+    }
+    if (roles.has("manifest") || roles.has("lockfile")) {
+        items.push({
+            source: "changed-role",
+            text: "Confirm dependency or lockfile changes are required by the task.",
+            evidence: summarizeRoleFiles(files, "manifest", "lockfile")
+        });
+    }
+    if (roles.has("config")) {
+        items.push({
+            source: "changed-role",
+            text: "Confirm config changes include visible operational context.",
+            evidence: summarizeRoleFiles(files, "config")
+        });
+    }
+}
+function summarizeRoleFiles(files, ...roles) {
+    return files
+        .filter((file) => roles.includes(file.role))
+        .slice(0, 3)
+        .map((file) => file.path)
+        .join(", ");
+}
+function formatPrimaryEvidence(finding) {
+    const evidence = finding.evidence[0];
+    if (evidence === undefined) {
+        return undefined;
+    }
+    if (evidence.path === undefined) {
+        return evidence.message;
+    }
+    const location = evidence.startLine === undefined ? evidence.path : `${evidence.path}:${evidence.startLine}`;
+    return `${location}: ${evidence.message}`;
+}
+function dedupeChecklist(items) {
+    const seen = new Set();
+    const deduped = [];
+    for (const item of items) {
+        const key = `${item.text}:${item.evidence ?? ""}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(item);
+    }
+    return deduped;
+}
+//# sourceMappingURL=reviewer-checklist.js.map

package/dist/reporters/reviewer-checklist.js.map

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

package/dist/repository/api-snapshot.d.ts

@@ -0,0 +1,41 @@
+import type { DiffFile } from "../schema/index.js";
+export declare const API_SURFACE_SNAPSHOT_PATH = ".critical-gate/api-surface.json";
+export declare const API_SURFACE_SNAPSHOT_SCHEMA_VERSION: "1.0";
+export interface ApiSurfaceSnapshot {
+    schemaVersion: typeof API_SURFACE_SNAPSHOT_SCHEMA_VERSION;
+    generatedAt: string;
+    entrypoints: string[];
+    exports: ApiSurfaceExport[];
+}
+export interface ApiSurfaceExport {
+    path: string;
+    name: string;
+    kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "var" | "reexport" | "default";
+    signature: string;
+    source?: string;
+}
+export interface ApiSurfaceSnapshotSummary {
+    path: string;
+    schemaVersion: string;
+    exportCount: number;
+    entrypoints: string[];
+}
+export interface ApiSnapshotReader {
+    exists?: (path: string) => boolean;
+    readFile?: (path: string) => string;
+}
+export interface BuildApiSurfaceSnapshotOptions {
+    root: string;
+    generatedAt: Date;
+    entrypoints?: string[];
+    reader?: ApiSnapshotReader;
+}
+export declare function buildApiSurfaceSnapshot({ root, generatedAt, entrypoints, reader }: BuildApiSurfaceSnapshotOptions): ApiSurfaceSnapshot;
+export declare function loadApiSurfaceSnapshot(root: string, reader?: ApiSnapshotReader): ApiSurfaceSnapshot | undefined;
+export declare function summarizeApiSurfaceSnapshot(snapshot: ApiSurfaceSnapshot | undefined): ApiSurfaceSnapshotSummary | undefined;
+export declare function extractApiSurfaceExports(path: string, sourceText: string): ApiSurfaceExport[];
+export declare function findSnapshotExport(snapshot: ApiSurfaceSnapshot, path: string, name: string): ApiSurfaceExport | undefined;
+export declare function hasApiSnapshotEvidence(files: DiffFile[]): boolean;
+export declare function getApiSnapshotOutputPath(root: string, output?: string): string;
+export declare function getApiSnapshotOutputDirectory(path: string): string;
+//# sourceMappingURL=api-snapshot.d.ts.map

package/dist/repository/api-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-snapshot.d.ts","sourceRoot":"","sources":["../../src/repository/api-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,mCAAmC,EAAG,KAAc,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,mCAAmC,CAAC;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,UAAU,GACV,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,UAAU,GACV,SAAS,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,IAAI,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAWD,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,WAAW,EACX,WAAW,EACX,MAAW,EACZ,EAAE,8BAA8B,GAAG,kBAAkB,CA+BrD;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,iBAAsB,GAC7B,kBAAkB,GAAG,SAAS,CAkBhC;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,yBAAyB,GAAG,SAAS,CAWvC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkD7F;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,SAAS,CAE9B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAEjE;AA+ID,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/repository/api-snapshot.js

@@ -0,0 +1,219 @@
+import { dirname, join } from "node:path";
+export const API_SURFACE_SNAPSHOT_PATH = ".critical-gate/api-surface.json";
+export const API_SURFACE_SNAPSHOT_SCHEMA_VERSION = "1.0";
+const packageEntrypointKeys = ["main", "module", "types", "typings", "browser"];
+const fallbackEntrypoints = ["src/index.ts", "src/index.tsx", "index.ts", "index.tsx", "index.js"];
+const declaredExportPattern = /^\s*export\s+(?:async\s+)?(?:declare\s+)?(function|class|interface|type|enum|const|let|var)\s+([A-Za-z_$][\w$]*)([^\n]*)/gm;
+const namedExportPattern = /^\s*export\s*\{([^}]+)\}(?:\s*from\s*["']([^"']+)["'])?/gm;
+const defaultExportPattern = /^\s*export\s+default\s+(?:async\s+)?(?:(function|class)\s+([A-Za-z_$][\w$]*)?|([A-Za-z_$][\w$]*))?/gm;
+export function buildApiSurfaceSnapshot({ root, generatedAt, entrypoints, reader = {} }) {
+    const resolvedEntrypoints = normalizeEntrypoints(entrypoints !== undefined && entrypoints.length > 0
+        ? entrypoints
+        : inferPublicEntrypoints(root, reader));
+    const exports = resolvedEntrypoints
+        .flatMap((entrypoint) => {
+        const absolutePath = join(root, entrypoint);
+        if (reader.exists?.(absolutePath) === false) {
+            return [];
+        }
+        const sourceText = reader.readFile?.(absolutePath);
+        if (sourceText === undefined) {
+            return [];
+        }
+        return extractApiSurfaceExports(entrypoint, sourceText);
+    })
+        .sort(compareExports);
+    return {
+        schemaVersion: API_SURFACE_SNAPSHOT_SCHEMA_VERSION,
+        generatedAt: generatedAt.toISOString(),
+        entrypoints: resolvedEntrypoints,
+        exports
+    };
+}
+export function loadApiSurfaceSnapshot(root, reader = {}) {
+    const path = join(root, API_SURFACE_SNAPSHOT_PATH);
+    if (reader.exists?.(path) !== true) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(reader.readFile?.(path) ?? "");
+        if (!isApiSurfaceSnapshot(parsed)) {
+            return undefined;
+        }
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function summarizeApiSurfaceSnapshot(snapshot) {
+    if (snapshot === undefined) {
+        return undefined;
+    }
+    return {
+        path: API_SURFACE_SNAPSHOT_PATH,
+        schemaVersion: snapshot.schemaVersion,
+        exportCount: snapshot.exports.length,
+        entrypoints: snapshot.entrypoints
+    };
+}
+export function extractApiSurfaceExports(path, sourceText) {
+    const exports = [];
+    for (const match of sourceText.matchAll(declaredExportPattern)) {
+        const kind = normalizeExportKind(match[1] ?? "const");
+        const name = match[2];
+        if (name === undefined) {
+            continue;
+        }
+        exports.push({
+            path,
+            name,
+            kind,
+            signature: normalizeSignature(match[0])
+        });
+    }
+    for (const match of sourceText.matchAll(namedExportPattern)) {
+        const exportedNames = match[1] ?? "";
+        const source = match[2];
+        for (const rawName of exportedNames.split(",")) {
+            const name = normalizeNamedExport(rawName);
+            if (name.length === 0) {
+                continue;
+            }
+            exports.push({
+                path,
+                name,
+                kind: "reexport",
+                signature: normalizeSignature(match[0]),
+                source
+            });
+        }
+    }
+    for (const match of sourceText.matchAll(defaultExportPattern)) {
+        exports.push({
+            path,
+            name: "default",
+            kind: "default",
+            signature: normalizeSignature(match[0])
+        });
+    }
+    return dedupeExports(exports).sort(compareExports);
+}
+export function findSnapshotExport(snapshot, path, name) {
+    return snapshot.exports.find((entry) => entry.path === path && entry.name === name);
+}
+export function hasApiSnapshotEvidence(files) {
+    return files.some((file) => normalizePath(file.path) === API_SURFACE_SNAPSHOT_PATH);
+}
+function inferPublicEntrypoints(root, reader) {
+    const packageJson = readPackageJson(root, reader);
+    const entrypoints = new Set();
+    if (isRecord(packageJson)) {
+        for (const key of packageEntrypointKeys) {
+            addEntrypointValue(entrypoints, packageJson[key]);
+        }
+        addEntrypointValue(entrypoints, packageJson.exports);
+    }
+    for (const fallback of fallbackEntrypoints) {
+        if (reader.exists?.(join(root, fallback)) === true) {
+            entrypoints.add(fallback);
+        }
+    }
+    return [...entrypoints];
+}
+function readPackageJson(root, reader) {
+    const path = join(root, "package.json");
+    if (reader.exists?.(path) !== true) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(reader.readFile?.(path) ?? "");
+    }
+    catch {
+        return undefined;
+    }
+}
+function addEntrypointValue(entrypoints, value) {
+    if (typeof value === "string") {
+        const normalized = normalizeEntrypoint(value);
+        if (isSourceLikeEntrypoint(normalized)) {
+            entrypoints.add(normalized);
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            addEntrypointValue(entrypoints, item);
+        }
+        return;
+    }
+    if (isRecord(value)) {
+        for (const nested of Object.values(value)) {
+            addEntrypointValue(entrypoints, nested);
+        }
+    }
+}
+function normalizeEntrypoints(entrypoints) {
+    return [...new Set(entrypoints.map(normalizeEntrypoint).filter(Boolean))].sort();
+}
+function normalizeEntrypoint(path) {
+    return normalizePath(path.replace(/^\.\//, ""));
+}
+function normalizePath(path) {
+    return path.replace(/\\/g, "/");
+}
+function isSourceLikeEntrypoint(path) {
+    const extension = path.split(".").pop();
+    if (extension === undefined) {
+        return false;
+    }
+    return ["ts", "tsx", "js", "jsx", "mts", "cts", "mjs", "cjs"].includes(extension);
+}
+function normalizeExportKind(kind) {
+    return kind === "let" ? "var" : kind;
+}
+function normalizeNamedExport(rawName) {
+    const cleaned = rawName.trim();
+    const aliasMatch = /\s+as\s+([A-Za-z_$][\w$]*)$/u.exec(cleaned);
+    return aliasMatch?.[1] ?? cleaned.replace(/\s+as\s+.*/u, "").trim();
+}
+function normalizeSignature(signature) {
+    return signature.replace(/\s+/g, " ").trim();
+}
+function dedupeExports(exports) {
+    const byKey = new Map();
+    for (const entry of exports) {
+        byKey.set(`${entry.path}:${entry.name}:${entry.signature}`, entry);
+    }
+    return [...byKey.values()];
+}
+function compareExports(left, right) {
+    return (left.path.localeCompare(right.path) ||
+        left.name.localeCompare(right.name) ||
+        left.signature.localeCompare(right.signature));
+}
+function isApiSurfaceSnapshot(value) {
+    return (isRecord(value) &&
+        value.schemaVersion === API_SURFACE_SNAPSHOT_SCHEMA_VERSION &&
+        Array.isArray(value.entrypoints) &&
+        value.entrypoints.every((entrypoint) => typeof entrypoint === "string") &&
+        Array.isArray(value.exports) &&
+        value.exports.every(isApiSurfaceExport));
+}
+function isApiSurfaceExport(value) {
+    return (isRecord(value) &&
+        typeof value.path === "string" &&
+        typeof value.name === "string" &&
+        typeof value.kind === "string" &&
+        typeof value.signature === "string");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function getApiSnapshotOutputPath(root, output) {
+    return output ?? join(root, API_SURFACE_SNAPSHOT_PATH);
+}
+export function getApiSnapshotOutputDirectory(path) {
+    return dirname(path);
+}
+//# sourceMappingURL=api-snapshot.js.map

package/dist/repository/api-snapshot.js.map

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

package/dist/repository/index.d.ts

@@ -1,3 +1,5 @@
+export { API_SURFACE_SNAPSHOT_PATH, buildApiSurfaceSnapshot, extractApiSurfaceExports, findSnapshotExport, getApiSnapshotOutputDirectory, getApiSnapshotOutputPath, hasApiSnapshotEvidence, loadApiSurfaceSnapshot, summarizeApiSurfaceSnapshot, type ApiSnapshotReader, type ApiSurfaceExport, type ApiSurfaceSnapshot, type BuildApiSurfaceSnapshotOptions } from "./api-snapshot.js";
 export { buildRepositoryProfile, parseNameOnlyLog, type BuildRepositoryProfileOptions, type HistoryCommandRunner } from "./profile.js";
+export { detectMonorepoContext, type MonorepoReader } from "./monorepo.js";
 export { buildUtilityIndex, extractExportedNames, type BuildUtilityIndexOptions, type UtilityIndexRunner } from "./utility-index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/repository/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACpC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC"}

package/dist/repository/index.js

@@ -1,3 +1,5 @@
+export { API_SURFACE_SNAPSHOT_PATH, buildApiSurfaceSnapshot, extractApiSurfaceExports, findSnapshotExport, getApiSnapshotOutputDirectory, getApiSnapshotOutputPath, hasApiSnapshotEvidence, loadApiSurfaceSnapshot, summarizeApiSurfaceSnapshot } from "./api-snapshot.js";
 export { buildRepositoryProfile, parseNameOnlyLog } from "./profile.js";
+export { detectMonorepoContext } from "./monorepo.js";
 export { buildUtilityIndex, extractExportedNames } from "./utility-index.js";
 //# sourceMappingURL=index.js.map

package/dist/repository/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAGjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EAGrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAK5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAGjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAuB,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EAGrB,MAAM,oBAAoB,CAAC"}

package/dist/repository/monorepo.d.ts

@@ -0,0 +1,7 @@
+import type { DiffFile, MonorepoContext } from "../schema/index.js";
+export interface MonorepoReader {
+    exists?: (path: string) => boolean;
+    readFile?: (path: string) => string;
+}
+export declare function detectMonorepoContext(root: string, files: DiffFile[], reader?: MonorepoReader): MonorepoContext | undefined;
+//# sourceMappingURL=monorepo.d.ts.map

package/dist/repository/monorepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo.d.ts","sourceRoot":"","sources":["../../src/repository/monorepo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAmB,MAAM,oBAAoB,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,GAAE,cAAmB,GAC1B,eAAe,GAAG,SAAS,CAmE7B"}