critical-gate 2.0.0

package/dist/detectors/api-surface-detector.js

@@ -0,0 +1,111 @@
+const apiTaskTerms = [
+    "api",
+    "public api",
+    "export",
+    "exports",
+    "breaking",
+    "signature",
+    "changelog",
+    "release note",
+    "public surface"
+];
+const documentationPathPattern = /(^|\/)(docs?|adr|changelog|changesets?)\/|(^|\/)(CHANGELOG|README|ADR)[^/]*\.md$/i;
+const exportDeclarationPattern = /^\s*export\s+(?:async\s+)?(?:declare\s+)?(?:function|class|interface|type|enum|const|let|var)\s+([A-Za-z_$][\w$]*)/;
+const namedExportPattern = /^\s*export\s*\{([^}]+)\}/;
+const defaultExportPattern = /^\s*export\s+default\s+/;
+export const apiSurfaceDetector = {
+    name: "api-surface",
+    run: ({ task, diff }) => {
+        if (hasVisibleApiAcknowledgement(task.text, diff.files)) {
+            return [];
+        }
+        return diff.files.filter(isSourceFile).flatMap(extractSignals).map(toFinding);
+    }
+};
+function isSourceFile(file) {
+    return file.role === "source" && /\.(?:[cm]?[jt]sx?)$/.test(file.path);
+}
+function hasVisibleApiAcknowledgement(taskText, files) {
+    const normalizedTask = taskText.toLowerCase();
+    return (apiTaskTerms.some((term) => normalizedTask.includes(term)) ||
+        files.some((file) => documentationPathPattern.test(file.path)));
+}
+function extractSignals(file) {
+    return file.hunks.flatMap((hunk) => hunk.lines.flatMap((line) => {
+        if (line.kind !== "add" && line.kind !== "delete") {
+            return [];
+        }
+        const exportInfo = getExportInfo(line);
+        if (exportInfo === undefined) {
+            return [];
+        }
+        const isRemoval = line.kind === "delete";
+        return [
+            {
+                id: isRemoval ? "removed-export" : "added-export",
+                title: isRemoval ? "Public export removed" : "Public export added",
+                message: isRemoval
+                    ? "The diff removes an exported symbol without visible API acknowledgement."
+                    : "The diff adds an exported symbol without visible API acknowledgement.",
+                repair: isRemoval
+                    ? "Confirm this is an intended public API change and add changelog, release note, docs, or explicit task/PR acknowledgement."
+                    : "Confirm the new export is intended public API and document it or keep it internal.",
+                severity: isRemoval ? "high" : "medium",
+                confidence: exportInfo.kind === "named" ? 0.78 : 0.86,
+                path: file.path,
+                lineNumber: line.kind === "add" ? line.newLineNumber : line.oldLineNumber,
+                symbol: exportInfo.symbol,
+                content: line.content
+            }
+        ];
+    }));
+}
+function getExportInfo(line) {
+    const declaredExport = exportDeclarationPattern.exec(line.content);
+    if (declaredExport !== null) {
+        return {
+            kind: "declared",
+            symbol: declaredExport[1]
+        };
+    }
+    const namedExport = namedExportPattern.exec(line.content);
+    if (namedExport !== null) {
+        return {
+            kind: "named",
+            symbol: namedExport[1]?.split(",")[0]?.trim()
+        };
+    }
+    if (defaultExportPattern.test(line.content)) {
+        return {
+            kind: "default",
+            symbol: "default"
+        };
+    }
+    return undefined;
+}
+function toFinding(signal) {
+    return {
+        id: `api-surface:${signal.path}:${signal.id}:${signal.symbol ?? "unknown"}:${signal.lineNumber ?? "unknown"}`,
+        detector: "api-surface",
+        severity: signal.severity,
+        confidence: signal.confidence,
+        title: signal.title,
+        message: signal.message,
+        evidence: [
+            {
+                kind: "symbol",
+                path: signal.path,
+                startLine: signal.lineNumber,
+                endLine: signal.lineNumber,
+                symbol: signal.symbol,
+                message: signal.content.trim(),
+                data: {
+                    signal: signal.id
+                }
+            }
+        ],
+        repair: signal.repair,
+        tags: ["api"]
+    };
+}
+//# sourceMappingURL=api-surface-detector.js.map

package/dist/detectors/api-surface-detector.js.map

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

package/dist/detectors/blast-radius-detector.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const blastRadiusDetector: Detector;
+//# sourceMappingURL=blast-radius-detector.d.ts.map

package/dist/detectors/blast-radius-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast-radius-detector.d.ts","sourceRoot":"","sources":["../../src/detectors/blast-radius-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,eAAO,MAAM,mBAAmB,EAAE,QAsBjC,CAAC"}

package/dist/detectors/blast-radius-detector.js

@@ -0,0 +1,90 @@
+export const blastRadiusDetector = {
+    name: "blast-radius",
+    run: ({ diff, context }) => {
+        const graph = context?.knowledge?.getFileGraph();
+        if (graph === undefined || diff.files.length < 2) {
+            return [];
+        }
+        const clusters = clusterChangedFiles(diff.files, graph);
+        if (clusters.length < 2) {
+            return [];
+        }
+        const primaryCluster = clusters[0];
+        return clusters
+            .slice(1)
+            .filter((cluster) => cluster !== primaryCluster)
+            .map((cluster, index) => toFinding(cluster, index + 1));
+    }
+};
+function clusterChangedFiles(files, graph) {
+    const changedByPath = new Map(files.map((file) => [file.path, file]));
+    const adjacency = new Map();
+    for (const file of files) {
+        adjacency.set(file.path, new Set());
+    }
+    for (const edge of graph.edges) {
+        if (!changedByPath.has(edge.from) || !changedByPath.has(edge.to)) {
+            continue;
+        }
+        adjacency.get(edge.from)?.add(edge.to);
+        adjacency.get(edge.to)?.add(edge.from);
+    }
+    const visited = new Set();
+    const clusters = [];
+    for (const file of files) {
+        if (visited.has(file.path)) {
+            continue;
+        }
+        const paths = walkCluster(file.path, adjacency, visited).sort();
+        clusters.push({
+            paths,
+            roles: [...new Set(paths.map((path) => changedByPath.get(path)?.role ?? "unknown"))].sort()
+        });
+    }
+    return clusters.sort((left, right) => right.paths.length - left.paths.length || left.paths[0].localeCompare(right.paths[0]));
+}
+function walkCluster(path, adjacency, visited) {
+    const stack = [path];
+    const cluster = [];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current === undefined || visited.has(current)) {
+            continue;
+        }
+        visited.add(current);
+        cluster.push(current);
+        for (const next of adjacency.get(current) ?? []) {
+            if (!visited.has(next)) {
+                stack.push(next);
+            }
+        }
+    }
+    return cluster;
+}
+function toFinding(cluster, index) {
+    return {
+        id: `blast-radius:unexpected-cluster-${index}:${cluster.paths.join("|")}`,
+        detector: "blast-radius",
+        severity: getSeverity(cluster),
+        confidence: 0.74,
+        title: "Unexpected changed-file cluster",
+        message: `The diff includes a separate changed-file cluster (${cluster.paths.join(", ")}) outside the primary blast radius.`,
+        evidence: cluster.paths.map((path) => ({
+            kind: "file",
+            path,
+            message: `Cluster role(s): ${cluster.roles.join(", ")}.`,
+            data: {
+                clusterSize: cluster.paths.length,
+                roles: cluster.roles
+            }
+        })),
+        repair: "Confirm this separate cluster belongs to the current task, or split it into a separate task with explicit intent.",
+        tags: ["scope"]
+    };
+}
+function getSeverity(cluster) {
+    return cluster.roles.some((role) => role === "config" || role === "manifest" || role === "lockfile")
+        ? "medium"
+        : "low";
+}
+//# sourceMappingURL=blast-radius-detector.js.map

package/dist/detectors/blast-radius-detector.js.map

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

package/dist/detectors/config-change-detector.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const configChangeDetector: Detector;
+//# sourceMappingURL=config-change-detector.d.ts.map

package/dist/detectors/config-change-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-change-detector.d.ts","sourceRoot":"","sources":["../../src/detectors/config-change-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAwB3C,eAAO,MAAM,oBAAoB,EAAE,QAWlC,CAAC"}

package/dist/detectors/config-change-detector.js

@@ -0,0 +1,68 @@
+const configTaskTerms = [
+    "config",
+    "configuration",
+    "ci",
+    "workflow",
+    "github action",
+    "build",
+    "bundler",
+    "vite",
+    "webpack",
+    "typescript",
+    "tsconfig",
+    "eslint",
+    "prettier",
+    "docker",
+    "lint",
+    "test runner"
+];
+const documentationPathPattern = /(^|\/)(docs?|adr|changelog|changesets?)\/|(^|\/)(CHANGELOG|README|AGENTS|ADR)[^/]*\.md$/i;
+export const configChangeDetector = {
+    name: "config-change",
+    run: ({ task, diff }) => {
+        const configFiles = diff.files.filter(isConfigChange);
+        if (configFiles.length === 0 || hasVisibleConfigExplanation(task, diff.files)) {
+            return [];
+        }
+        return configFiles.map((file) => toFinding(file, task));
+    }
+};
+function isConfigChange(file) {
+    return file.role === "config" && (file.additions > 0 || file.deletions > 0);
+}
+function hasVisibleConfigExplanation(task, files) {
+    const normalizedTask = task.text.toLowerCase();
+    return (configTaskTerms.some((term) => normalizedTask.includes(term)) ||
+        files.some((file) => documentationPathPattern.test(file.path)));
+}
+function toFinding(file, task) {
+    const firstChangedLine = file.hunks
+        .flatMap((hunk) => hunk.lines)
+        .find((line) => line.kind === "add" || line.kind === "delete");
+    const lineNumber = firstChangedLine?.newLineNumber ?? firstChangedLine?.oldLineNumber;
+    return {
+        id: `config-change:${file.path}`,
+        detector: "config-change",
+        severity: "medium",
+        confidence: 0.82,
+        title: "Config changed without visible explanation",
+        message: `${file.path} changed, but the task did not mention configuration and no documentation file changed.`,
+        evidence: [
+            {
+                kind: "file",
+                path: file.path,
+                startLine: lineNumber,
+                endLine: lineNumber,
+                message: `Config file changed during task: ${task.text}`,
+                data: {
+                    additions: file.additions,
+                    deletions: file.deletions,
+                    role: file.role
+                }
+            }
+        ],
+        repair: "Confirm the config change is required. If it changes team workflow or runtime behavior, add docs, an ADR, changelog entry, or explicit task/PR explanation.",
+        tags: ["config"]
+    };
+}
+//# sourceMappingURL=config-change-detector.js.map

package/dist/detectors/config-change-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-change-detector.js","sourceRoot":"","sources":["../../src/detectors/config-change-detector.ts"],"names":[],"mappings":"AAIA,MAAM,eAAe,GAAG;IACtB,QAAQ;IACR,eAAe;IACf,IAAI;IACJ,UAAU;IACV,eAAe;IACf,OAAO;IACP,SAAS;IACT,MAAM;IACN,SAAS;IACT,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,MAAM;IACN,aAAa;CACd,CAAC;AAEF,MAAM,wBAAwB,GAC5B,0FAA0F,CAAC;AAE7F,MAAM,CAAC,MAAM,oBAAoB,GAAa;IAC5C,IAAI,EAAE,eAAe;IACrB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAEtD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC;AAEF,SAAS,cAAc,CAAC,IAAc;IACpC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAgB,EAAE,KAAiB;IACtE,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAE/C,OAAO,CACL,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAc,EAAE,IAAgB;IACjD,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK;SAChC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;SAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,gBAAgB,EAAE,aAAa,IAAI,gBAAgB,EAAE,aAAa,CAAC;IAEtF,OAAO;QACL,EAAE,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE;QAChC,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,4CAA4C;QACnD,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,yFAAyF;QAC9G,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,oCAAoC,IAAI,CAAC,IAAI,EAAE;gBACxD,IAAI,EAAE;oBACJ,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB;aACF;SACF;QACD,MAAM,EACJ,6JAA6J;QAC/J,IAAI,EAAE,CAAC,QAAQ,CAAC;KACjB,CAAC;AACJ,CAAC"}

package/dist/detectors/dependency-detector.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const dependencyDetector: Detector;
+//# sourceMappingURL=dependency-detector.d.ts.map

package/dist/detectors/dependency-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-detector.d.ts","sourceRoot":"","sources":["../../src/detectors/dependency-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA2B3C,eAAO,MAAM,kBAAkB,EAAE,QAShC,CAAC"}

package/dist/detectors/dependency-detector.js

@@ -0,0 +1,98 @@
+const dependencySections = new Set([
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies"
+]);
+const dependencyLinePattern = /^\s*"([^"]+)":\s*"([^"]+)"/;
+const sectionLinePattern = /^\s*"(dependencies|devDependencies|peerDependencies|optionalDependencies)":\s*\{/;
+export const dependencyDetector = {
+    name: "dependency-addition",
+    run: ({ task, diff }) => {
+        const addedDependencies = diff.files.flatMap(extractAddedDependencies);
+        return addedDependencies
+            .filter((dependency) => !hasVisibleJustification(task.text, dependency.name))
+            .map(toFinding);
+    }
+};
+function extractAddedDependencies(file) {
+    if (file.path !== "package.json" && !file.path.endsWith("/package.json")) {
+        return [];
+    }
+    const dependencies = [];
+    for (const hunk of file.hunks) {
+        let currentSection;
+        for (const line of hunk.lines) {
+            const section = getSection(line);
+            if (section !== undefined) {
+                currentSection = section;
+                continue;
+            }
+            if (line.kind === "context" && line.content.trim() === "}") {
+                currentSection = undefined;
+                continue;
+            }
+            if (line.kind !== "add" || currentSection === undefined) {
+                continue;
+            }
+            const dependency = dependencyLinePattern.exec(line.content);
+            if (dependency === null) {
+                continue;
+            }
+            dependencies.push({
+                name: dependency[1] ?? "",
+                version: dependency[2] ?? "",
+                section: currentSection,
+                path: file.path,
+                lineNumber: line.newLineNumber
+            });
+        }
+    }
+    return dependencies;
+}
+function getSection(line) {
+    const section = sectionLinePattern.exec(line.content)?.[1];
+    if (section === undefined || !dependencySections.has(section)) {
+        return undefined;
+    }
+    return section;
+}
+function hasVisibleJustification(taskText, dependencyName) {
+    const normalizedTask = taskText.toLowerCase();
+    const normalizedDependency = dependencyName.toLowerCase();
+    return (normalizedTask.includes(normalizedDependency) ||
+        normalizedTask.includes("add dependency") ||
+        normalizedTask.includes("new dependency") ||
+        normalizedTask.includes("install package") ||
+        normalizedTask.includes("install dependency"));
+}
+function toFinding(dependency) {
+    const isProductionDependency = dependency.section === "dependencies" || dependency.section === "optionalDependencies";
+    const severity = isProductionDependency ? "blocker" : "medium";
+    const dependencyType = isProductionDependency ? "production" : "development";
+    return {
+        id: `dependency-addition:${dependency.path}:${dependency.section}:${dependency.name}`,
+        detector: "dependency-addition",
+        severity,
+        confidence: 0.9,
+        title: `Unjustified ${dependencyType} dependency added`,
+        message: `${dependency.name}@${dependency.version} was added to ${dependency.section} without visible task justification.`,
+        evidence: [
+            {
+                kind: "manifest",
+                path: dependency.path,
+                startLine: dependency.lineNumber,
+                endLine: dependency.lineNumber,
+                message: `${dependency.name} was added to ${dependency.section}.`,
+                data: {
+                    dependency: dependency.name,
+                    version: dependency.version,
+                    section: dependency.section
+                }
+            }
+        ],
+        repair: `Remove ${dependency.name} unless it is required, or update the task/PR context with a clear justification and alternatives considered.`,
+        tags: ["dependency"]
+    };
+}
+//# sourceMappingURL=dependency-detector.js.map

package/dist/detectors/dependency-detector.js.map

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

package/dist/detectors/existing-solution-detector.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const existingSolutionDetector: Detector;
+//# sourceMappingURL=existing-solution-detector.d.ts.map

package/dist/detectors/existing-solution-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"existing-solution-detector.d.ts","sourceRoot":"","sources":["../../src/detectors/existing-solution-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,eAAO,MAAM,wBAAwB,EAAE,QAatC,CAAC"}

package/dist/detectors/existing-solution-detector.js

@@ -0,0 +1,87 @@
+import { extractSolutionEntries } from "../knowledge/index.js";
+export const existingSolutionDetector = {
+    name: "existing-solution",
+    run: ({ diff, context }) => {
+        const existingSolutions = context?.knowledge?.getSolutionIndex().solutions ?? [];
+        if (existingSolutions.length === 0) {
+            return [];
+        }
+        return diff.files
+            .filter((file) => file.status === "added" && file.role === "source")
+            .flatMap((file) => detectExistingSolutions(file, existingSolutions));
+    }
+};
+function detectExistingSolutions(file, existingSolutions) {
+    const sourceText = file.hunks
+        .flatMap((hunk) => hunk.lines.filter((line) => line.kind === "add").map((line) => line.content))
+        .join("\n");
+    const addedSolutions = extractSolutionEntries(file.path, sourceText);
+    return addedSolutions.flatMap((added) => {
+        const match = findBestMatch(added, existingSolutions);
+        return match === undefined ? [] : [toFinding(file, match)];
+    });
+}
+function findBestMatch(added, existingSolutions) {
+    return existingSolutions
+        .filter((existing) => existing.path !== added.path && existing.class === added.class)
+        .map((existing) => scoreMatch(added, existing))
+        .filter((match) => match !== undefined)
+        .sort((left, right) => right.confidence - left.confidence)[0];
+}
+function scoreMatch(added, existing) {
+    if (added.normalizedName === existing.normalizedName) {
+        return { added, existing, confidence: 0.94, reason: "exact normalized name match" };
+    }
+    if (added.normalizedName.includes(existing.normalizedName) ||
+        existing.normalizedName.includes(added.normalizedName)) {
+        return { added, existing, confidence: 0.84, reason: "similar normalized name" };
+    }
+    const domainOverlap = overlapRatio(added.domainTokens, existing.domainTokens);
+    const importOverlap = overlapRatio(added.importTokens, existing.importTokens);
+    const signatureMatches = added.arity !== undefined &&
+        added.arity === existing.arity &&
+        added.returnType === existing.returnType;
+    if (signatureMatches && domainOverlap >= 0.4) {
+        return { added, existing, confidence: 0.78, reason: "matching signature and domain tokens" };
+    }
+    if (domainOverlap >= 0.5 && importOverlap >= 0.5) {
+        return { added, existing, confidence: 0.74, reason: "similar imports and domain tokens" };
+    }
+    return undefined;
+}
+function overlapRatio(left, right) {
+    if (left.length === 0 || right.length === 0) {
+        return 0;
+    }
+    const rightSet = new Set(right);
+    const overlap = left.filter((token) => rightSet.has(token)).length;
+    return overlap / Math.max(left.length, right.length);
+}
+function toFinding(file, match) {
+    return {
+        id: `existing-solution:${file.path}:${match.added.exportedName ?? match.added.normalizedName}`,
+        detector: "existing-solution",
+        severity: "medium",
+        confidence: match.confidence,
+        title: "New solution may duplicate existing repository solution",
+        message: `${match.added.exportedName ?? match.added.normalizedName} was added in ${file.path}, but ${match.existing.exportedName ?? match.existing.normalizedName} already exists in ${match.existing.path}.`,
+        evidence: [
+            {
+                kind: "symbol",
+                path: file.path,
+                symbol: match.added.exportedName,
+                message: `Existing ${match.existing.class} candidate: ${match.existing.path}#${match.existing.exportedName ?? match.existing.normalizedName} (${match.reason}).`,
+                data: {
+                    addedClass: match.added.class,
+                    existingClass: match.existing.class,
+                    existingPath: match.existing.path,
+                    existingExport: match.existing.exportedName,
+                    reason: match.reason
+                }
+            }
+        ],
+        repair: `Reuse ${match.existing.exportedName ?? "the existing solution"} from ${match.existing.path}, or document why a separate ${match.added.class} is needed.`,
+        tags: ["utility", "convention"]
+    };
+}
+//# sourceMappingURL=existing-solution-detector.js.map

package/dist/detectors/existing-solution-detector.js.map

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

package/dist/detectors/expected-companions-detector.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "./types.js";
+export declare const expectedCompanionsDetector: Detector;
+//# sourceMappingURL=expected-companions-detector.d.ts.map

package/dist/detectors/expected-companions-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expected-companions-detector.d.ts","sourceRoot":"","sources":["../../src/detectors/expected-companions-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,0BAA0B,EAAE,QAiBxC,CAAC"}

package/dist/detectors/expected-companions-detector.js

@@ -0,0 +1,65 @@
+export const expectedCompanionsDetector = {
+    name: "expected-companions",
+    run: ({ diff, context }) => {
+        const history = context?.knowledge?.getHistoryIndex();
+        if (history === undefined) {
+            return [];
+        }
+        const changedPaths = new Set(diff.files.map((file) => file.path));
+        const historyFindings = history.companionRules
+            .filter((rule) => changedPaths.has(rule.sourcePath) && !changedPaths.has(rule.expectedPath))
+            .map((rule) => toHistoryFinding(rule));
+        const packageFinding = detectMissingLockfile(diff.files);
+        return packageFinding === undefined ? historyFindings : [...historyFindings, packageFinding];
+    }
+};
+function detectMissingLockfile(files) {
+    const changedPaths = new Set(files.map((file) => file.path));
+    const changedPackage = files.find((file) => file.path === "package.json" || file.path.endsWith("/package.json"));
+    if (changedPackage === undefined ||
+        [...changedPaths].some((path) => /(^|\/)(pnpm-lock\.yaml|package-lock\.json|yarn\.lock|bun\.lockb)$/.test(path))) {
+        return undefined;
+    }
+    return {
+        id: `expected-companions:${changedPackage.path}:lockfile`,
+        detector: "expected-companions",
+        severity: "medium",
+        confidence: 0.86,
+        title: "Expected companion lockfile missing",
+        message: `${changedPackage.path} changed without a corresponding package lockfile change.`,
+        evidence: [
+            {
+                kind: "file",
+                path: changedPackage.path,
+                message: "Package manifest changed but no lockfile changed in this diff."
+            }
+        ],
+        repair: "Update the matching lockfile, or document why the manifest-only change is intentional.",
+        tags: ["dependency"]
+    };
+}
+function toHistoryFinding(rule) {
+    return {
+        id: `expected-companions:${rule.sourcePath}:${rule.expectedPath}`,
+        detector: "expected-companions",
+        severity: "medium",
+        confidence: Math.min(0.92, 0.55 + rule.confidence * 0.35),
+        title: "Expected companion file missing",
+        message: `${rule.sourcePath} changed without historically paired companion ${rule.expectedPath}.`,
+        evidence: [
+            {
+                kind: "history",
+                path: rule.sourcePath,
+                message: `${rule.expectedPath} has historically changed with ${rule.sourcePath}.`,
+                data: {
+                    expectedPath: rule.expectedPath,
+                    support: rule.support,
+                    confidence: rule.confidence
+                }
+            }
+        ],
+        repair: `Update ${rule.expectedPath}, or document why this change does not need its usual companion.`,
+        tags: ["scope"]
+    };
+}
+//# sourceMappingURL=expected-companions-detector.js.map

package/dist/detectors/expected-companions-detector.js.map

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

package/dist/detectors/index.d.ts

@@ -0,0 +1,17 @@
+export { apiSurfaceDetector } from "./api-surface-detector.js";
+export { blastRadiusDetector } from "./blast-radius-detector.js";
+export { configChangeDetector } from "./config-change-detector.js";
+export { dependencyDetector } from "./dependency-detector.js";
+export { existingSolutionDetector } from "./existing-solution-detector.js";
+export { expectedCompanionsDetector } from "./expected-companions-detector.js";
+export { intentVerificationDetector } from "./intent-verification-detector.js";
+export { patternViolationDetector } from "./pattern-violation-detector.js";
+export { rewriteDetector } from "./rewrite-detector.js";
+export { repositoryIntelligenceDetector } from "./repository-intelligence-detector.js";
+export { runDetectors, summarizeFindings, type FindingDecisionPolicy } from "./runner.js";
+export { scanAddedLinesForSecretsAndPaths, secretPathDetector } from "./secret-path-detector.js";
+export { scopeDetector } from "./scope-detector.js";
+export { testWeakeningDetector } from "./test-weakening-detector.js";
+export { utilityReinventionDetector } from "./utility-reinvention-detector.js";
+export type { Detector, DetectorContext } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,gCAAgC,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}