@esbenwiberg/corpus-default 1.1.0 → 1.2.1

package/dist/probes/agent-skills-present.js

@@ -0,0 +1,82 @@
+import { defineProbe } from "@esbenwiberg/repofit/sdk";
+const SKILL_FILE_PATTERNS = [
+    /^\.codex\/skills\/[^/]+\/SKILL\.md$/i,
+    /^\.agents\/skills\/[^/]+\/SKILL\.md$/i,
+    /^agents\/skills\/[^/]+\/SKILL\.md$/i,
+    /^\.claude\/commands\/.+\.md$/i,
+    /^\.cursor\/rules\/.+\.mdc$/i,
+    /^\.windsurf\/rules\/.+\.md$/i,
+    /^prompts\/agents\/.+\.md$/i,
+];
+export default defineProbe({
+    id: "agent.skills-present",
+    version: "1.0.0",
+    dimensions: [
+        { id: "context", weight: 1 },
+        { id: "feedback", weight: 0.3 },
+    ],
+    tier: "static",
+    evidence: ["size_stats"],
+    rationale: `
+    Repository-local skills and slash commands turn recurring agent work into
+    reusable procedures: commit workflow, new-probe authoring, release, smoke
+    testing, debugging, review. Generic guidance tells an agent what matters;
+    skills give it a repeatable path through high-friction tasks.
+  `,
+    remediation: "Add repo-local agent skills or commands for repeated workflows. Good starting points: `/commit`, `/new-probe`, `/release`, `/smoke`, `/debug-failing-ci`, and `/review`. Store them in a tool-native location such as `.codex/skills/<name>/SKILL.md`, `.claude/commands/*.md`, or `.cursor/rules/*.mdc`.",
+    async detect(ev) {
+        const samples = ev.size_stats.files
+            .map((f) => f.path)
+            .filter((p) => SKILL_FILE_PATTERNS.some((pattern) => pattern.test(p)))
+            .sort()
+            .map((path) => ({ path }));
+        return { kind: "count", value: samples.length, samples };
+    },
+    score: {
+        kind: "count",
+        direction: "positive",
+        bands: [{ upTo: 0, score: 0 }, { upTo: 1, score: 60 }, { upTo: 3, score: 80 }, { score: 100 }],
+    },
+    fixtures: [
+        {
+            name: "no-local-skills",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 100,
+                    totalFiles: 1,
+                    files: [{ path: "CLAUDE.md", bytes: 100, lines: 5, depth: 0 }],
+                },
+            },
+            expect: { reading: { kind: "count", value: 0, samples: [] }, score: 0 },
+        },
+        {
+            name: "codex-and-claude-skills",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 300,
+                    totalFiles: 3,
+                    files: [
+                        { path: ".codex/skills/new-probe/SKILL.md", bytes: 100, lines: 20, depth: 3 },
+                        { path: ".claude/commands/commit.md", bytes: 100, lines: 15, depth: 2 },
+                        { path: ".cursor/rules/testing.mdc", bytes: 100, lines: 15, depth: 2 },
+                    ],
+                },
+            },
+            expect: {
+                reading: {
+                    kind: "count",
+                    value: 3,
+                    samples: [
+                        { path: ".claude/commands/commit.md" },
+                        { path: ".codex/skills/new-probe/SKILL.md" },
+                        { path: ".cursor/rules/testing.mdc" },
+                    ],
+                },
+                score: 80,
+            },
+        },
+    ],
+});
+//# sourceMappingURL=agent-skills-present.js.map

package/dist/probes/agent-skills-present.js.map

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

package/dist/probes/agent-skills-quality.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@esbenwiberg/repofit/sdk").Probe;
+export default _default;
+//# sourceMappingURL=agent-skills-quality.d.ts.map

package/dist/probes/agent-skills-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills-quality.d.ts","sourceRoot":"","sources":["../../src/probes/agent-skills-quality.ts"],"names":[],"mappings":";AA2CA,wBAwHG"}

package/dist/probes/agent-skills-quality.js

@@ -0,0 +1,148 @@
+import { defineProbe } from "@esbenwiberg/repofit/sdk";
+const PROBE_VERSION = "1.0.0";
+const MAX_SKILLS = 5;
+const MAX_CHARS_PER_SKILL = 3_000;
+const MAX_INPUT_CHARS = 18_000;
+const SKILL_FILE_PATTERNS = [
+    /^\.codex\/skills\/[^/]+\/SKILL\.md$/i,
+    /^\.agents\/skills\/[^/]+\/SKILL\.md$/i,
+    /^agents\/skills\/[^/]+\/SKILL\.md$/i,
+    /^\.claude\/commands\/.+\.md$/i,
+    /^\.cursor\/rules\/.+\.mdc$/i,
+    /^\.windsurf\/rules\/.+\.md$/i,
+    /^prompts\/agents\/.+\.md$/i,
+];
+const RUBRIC = {
+    task: "Judge whether repository-local agent skills or slash commands would help a coding agent perform repeated workflows correctly.",
+    criteria: [
+        {
+            id: "workflow-specific",
+            description: "Does each skill target a concrete recurring workflow such as commit, new probe, release, smoke test, debugging CI, or review? Generic advice scores low.",
+        },
+        {
+            id: "actionable-steps",
+            description: "Does the skill give ordered, executable steps with commands, files, and expected validation signals?",
+        },
+        {
+            id: "repo-fit",
+            description: "Is the skill specific to this repository's structure, tools, conventions, and hazards rather than broadly reusable platitudes?",
+        },
+        {
+            id: "guardrails",
+            description: "Does the skill include safety checks, non-goals, verification, and when to stop or ask for help?",
+        },
+    ],
+};
+export default defineProbe({
+    id: "agent.skills-quality",
+    version: PROBE_VERSION,
+    dimensions: [
+        { id: "context", weight: 1 },
+        { id: "feedback", weight: 0.5 },
+    ],
+    tier: "reasoned",
+    evidence: ["files", "size_stats", "judge"],
+    rationale: `
+    Local skills can make agents dramatically better, but only when they
+    encode real workflows. A stub named /commit that says "make a good
+    commit" is not useful. This probe samples local skills and judges their
+    specificity, actionability, repo fit, and guardrails.
+  `,
+    remediation: "Turn local skills into concrete recipes: name the workflow, list exact commands and files, include validation signals, document hazards, and explain when the agent should stop. Good first skills are `/commit`, `/new-probe`, `/release`, `/smoke`, `/debug-failing-ci`, and `/review`.",
+    async detect(ev) {
+        const skillPaths = ev.size_stats.files
+            .map((f) => f.path)
+            .filter((p) => SKILL_FILE_PATTERNS.some((pattern) => pattern.test(p)))
+            .sort();
+        if (skillPaths.length === 0) {
+            return { kind: "na", reason: "no local agent skills found" };
+        }
+        const sampled = [];
+        let totalChars = 0;
+        for (const p of skillPaths) {
+            if (sampled.length >= MAX_SKILLS)
+                break;
+            const text = await ev.files.readText(p);
+            if (!text)
+                continue;
+            const slice = text.slice(0, MAX_CHARS_PER_SKILL);
+            sampled.push({ path: p, text: slice });
+            totalChars += slice.length;
+            if (totalChars >= MAX_INPUT_CHARS)
+                break;
+        }
+        if (sampled.length === 0) {
+            return { kind: "na", reason: "local agent skills declared but unreadable" };
+        }
+        const input = sampled.map((s) => `# ${s.path}\n\n${s.text}`).join("\n\n---\n\n");
+        const result = await ev.judge.score({
+            probeId: "agent.skills-quality",
+            probeVersion: PROBE_VERSION,
+            input,
+            rubric: RUBRIC,
+        });
+        return {
+            kind: "judge",
+            score: result.score,
+            perCriterion: result.perCriterion,
+            rationale: result.rationale,
+            model: result.model,
+        };
+    },
+    score: { kind: "judge" },
+    fixtures: [
+        {
+            name: "no-skills",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 100,
+                    totalFiles: 1,
+                    files: [{ path: "CLAUDE.md", bytes: 100, lines: 5, depth: 0 }],
+                },
+            },
+            expect: { reading: { kind: "na", reason: "no local agent skills found" }, score: null },
+        },
+        {
+            name: "strong-skill",
+            evidence: {
+                files: {
+                    ".codex/skills/new-probe/SKILL.md": "# New Probe\n\nUse when adding a corpus probe.\n\n1. Add `packages/corpus-default/src/probes/<id>.ts`.\n2. Add fixtures covering N/A, pass, and fail.\n3. Wire it in `src/index.ts`.\n4. Run `npm --workspace @esbenwiberg/corpus-default run typecheck` and `npm --workspace @esbenwiberg/corpus-default test`.\n5. Commit with `feat(corpus): ...`.\n",
+                },
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 400,
+                    totalFiles: 1,
+                    files: [{ path: ".codex/skills/new-probe/SKILL.md", bytes: 400, lines: 10, depth: 3 }],
+                },
+                judge: {
+                    score: 80,
+                    perCriterion: {
+                        "workflow-specific": 80,
+                        "actionable-steps": 80,
+                        "repo-fit": 80,
+                        guardrails: 80,
+                    },
+                    rationale: "Concrete repo-specific workflow with validation and commit convention.",
+                    model: "fixture",
+                },
+            },
+            expect: {
+                reading: {
+                    kind: "judge",
+                    score: 80,
+                    perCriterion: {
+                        "workflow-specific": 80,
+                        "actionable-steps": 80,
+                        "repo-fit": 80,
+                        guardrails: 80,
+                    },
+                    rationale: "Concrete repo-specific workflow with validation and commit convention.",
+                    model: "fixture",
+                },
+                score: 80,
+            },
+        },
+    ],
+});
+//# sourceMappingURL=agent-skills-quality.js.map

package/dist/probes/agent-skills-quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills-quality.js","sourceRoot":"","sources":["../../src/probes/agent-skills-quality.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,aAAa,GAAG,OAAO,CAAC;AAC9B,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAM,mBAAmB,GAAG;IAC1B,sCAAsC;IACtC,uCAAuC;IACvC,qCAAqC;IACrC,+BAA+B;IAC/B,6BAA6B;IAC7B,8BAA8B;IAC9B,4BAA4B;CAC7B,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,+HAA+H;IACrI,QAAQ,EAAE;QACR;YACE,EAAE,EAAE,mBAAmB;YACvB,WAAW,EACT,0JAA0J;SAC7J;QACD;YACE,EAAE,EAAE,kBAAkB;YACtB,WAAW,EACT,sGAAsG;SACzG;QACD;YACE,EAAE,EAAE,UAAU;YACd,WAAW,EACT,gIAAgI;SACnI;QACD;YACE,EAAE,EAAE,YAAY;YAChB,WAAW,EACT,kGAAkG;SACrG;KACF;CACO,CAAC;AAEX,eAAe,WAAW,CAAC;IACzB,EAAE,EAAE,sBAAsB;IAC1B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE;QACV,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE;QAC5B,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE;KAChC;IACD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC;IAE1C,SAAS,EAAE;;;;;GAKV;IAED,WAAW,EACT,2RAA2R;IAE7R,KAAK,CAAC,MAAM,CAAC,EAAE;QACb,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK;aACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;aACrE,IAAI,EAAE,CAAC;QAEV,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAqC,EAAE,CAAC;QACrD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;gBAAE,MAAM;YACxC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACvC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,UAAU,IAAI,eAAe;gBAAE,MAAM;QAC3C,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,4CAA4C,EAAE,CAAC;QAC9E,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;YAClC,OAAO,EAAE,sBAAsB;YAC/B,YAAY,EAAE,aAAa;YAC3B,KAAK;YACL,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;IAExB,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE;gBACR,UAAU,EAAE;oBACV,MAAM,EAAE,cAAc;oBACtB,UAAU,EAAE,GAAG;oBACf,UAAU,EAAE,CAAC;oBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;iBAC/D;aACF;YACD,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,6BAA6B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SACxF;QACD;YACE,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE;gBACR,KAAK,EAAE;oBACL,kCAAkC,EAChC,yVAAyV;iBAC5V;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,cAAc;oBACtB,UAAU,EAAE,GAAG;oBACf,UAAU,EAAE,CAAC;oBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;iBACvF;gBACD,KAAK,EAAE;oBACL,KAAK,EAAE,EAAE;oBACT,YAAY,EAAE;wBACZ,mBAAmB,EAAE,EAAE;wBACvB,kBAAkB,EAAE,EAAE;wBACtB,UAAU,EAAE,EAAE;wBACd,UAAU,EAAE,EAAE;qBACf;oBACD,SAAS,EAAE,wEAAwE;oBACnF,KAAK,EAAE,SAAS;iBACjB;aACF;YACD,MAAM,EAAE;gBACN,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE;oBACT,YAAY,EAAE;wBACZ,mBAAmB,EAAE,EAAE;wBACvB,kBAAkB,EAAE,EAAE;wBACtB,UAAU,EAAE,EAAE;wBACd,UAAU,EAAE,EAAE;qBACf;oBACD,SAAS,EAAE,wEAAwE;oBACnF,KAAK,EAAE,SAAS;iBACjB;gBACD,KAAK,EAAE,EAAE;aACV;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/probes/arch-coupling-hotspots.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@esbenwiberg/repofit/sdk").Probe;
+export default _default;
+//# sourceMappingURL=arch-coupling-hotspots.d.ts.map

package/dist/probes/arch-coupling-hotspots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-coupling-hotspots.d.ts","sourceRoot":"","sources":["../../src/probes/arch-coupling-hotspots.ts"],"names":[],"mappings":";AAeA,wBA+JG"}

package/dist/probes/arch-coupling-hotspots.js

@@ -0,0 +1,222 @@
+import { posix as path } from "node:path";
+import { defineProbe } from "@esbenwiberg/repofit/sdk";
+const SOURCE_FILE = /\.(?:ts|tsx|js|jsx|mjs|cjs)$/i;
+const TEST_FILE = /(?:\.test\.|\.spec\.|__tests__|^tests?\/|^e2e\/)/i;
+const SKIP_DIRS = /(?:^|\/)(?:node_modules|dist|build|coverage|\.next|\.nuxt|out|target|bin|obj)\//;
+const EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
+const FAN_OUT_WARN = 12;
+const FAN_IN_WARN = 20;
+const MAX_ITEMS = 30;
+const IMPORT_RE = /\bimport\s+(?:type\s+)?(?:[^"'`]*?\s+from\s+)?["'`]([^"'`]+)["'`]|\brequire\s*\(\s*["'`]([^"'`]+)["'`]\s*\)|\bimport\s*\(\s*["'`]([^"'`]+)["'`]\s*\)/g;
+export default defineProbe({
+    id: "arch.coupling-hotspots",
+    version: "1.0.0",
+    dimensions: [
+        { id: "context", weight: 0.5 },
+        { id: "cost", weight: 1 },
+        { id: "consistency", weight: 0.5 },
+    ],
+    tier: "static",
+    evidence: ["files", "size_stats"],
+    rationale: `
+    Agents pay for coupling twice: they need more context before changing a
+    hotspot, and each edit has a wider blast radius. This probe builds a
+    lightweight graph from relative JS/TS imports and flags import cycles,
+    high fan-out files, and high fan-in files.
+  `,
+    remediation: "Break import cycles, split files that import too many local modules, and stabilize high fan-in modules with clearer contracts and tests. Hotspots are not always wrong, but they deserve names, docs, and extra care.",
+    async detect(ev) {
+        const sourcePaths = ev.size_stats.files
+            .filter((f) => !f.generated)
+            .map((f) => f.path)
+            .filter((p) => SOURCE_FILE.test(p) && !TEST_FILE.test(p) && !SKIP_DIRS.test(`/${p}`))
+            .sort();
+        if (sourcePaths.length === 0) {
+            return { kind: "na", reason: "no JS/TS source files detected" };
+        }
+        const sourceSet = new Set(sourcePaths);
+        const graph = new Map();
+        for (const p of sourcePaths)
+            graph.set(p, new Set());
+        for (const p of sourcePaths) {
+            const text = await ev.files.readText(p);
+            if (!text)
+                continue;
+            for (const spec of extractImports(text)) {
+                const resolved = resolveRelativeImport(p, spec, sourceSet);
+                if (resolved)
+                    graph.get(p)?.add(resolved);
+            }
+        }
+        const items = [];
+        const cycles = findCycles(graph);
+        for (const cycle of cycles.slice(0, 10)) {
+            items.push({
+                location: { path: cycle[0] ?? "" },
+                severity: "error",
+                message: `import cycle: ${cycle.join(" -> ")}`,
+            });
+        }
+        const fanIn = new Map();
+        for (const p of sourcePaths)
+            fanIn.set(p, 0);
+        for (const deps of graph.values()) {
+            for (const dep of deps)
+                fanIn.set(dep, (fanIn.get(dep) ?? 0) + 1);
+        }
+        for (const [p, deps] of graph) {
+            if (deps.size > FAN_OUT_WARN) {
+                items.push({
+                    location: { path: p },
+                    severity: "warn",
+                    message: `high fan-out: imports ${deps.size} local modules`,
+                });
+            }
+        }
+        for (const [p, count] of fanIn) {
+            if (count > FAN_IN_WARN) {
+                items.push({
+                    location: { path: p },
+                    severity: "warn",
+                    message: `high fan-in: imported by ${count} local modules`,
+                });
+            }
+        }
+        return { kind: "inventory", items: items.slice(0, MAX_ITEMS) };
+    },
+    score: {
+        kind: "inventory",
+        severityWeights: { info: 1, warn: 3, error: 10 },
+        bands: [
+            { upTo: 0, score: 100 },
+            { upTo: 3, score: 80 },
+            { upTo: 6, score: 50 },
+            { upTo: 9, score: 20 },
+            { score: 0 },
+        ],
+    },
+    fixtures: [
+        {
+            name: "no-js-ts-source",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 100,
+                    totalFiles: 1,
+                    files: [{ path: "README.md", bytes: 100, lines: 5, depth: 0 }],
+                },
+            },
+            expect: { reading: { kind: "na", reason: "no JS/TS source files detected" }, score: null },
+        },
+        {
+            name: "simple-acyclic",
+            evidence: {
+                files: {
+                    "src/a.ts": 'import { b } from "./b";\nexport const a = b;\n',
+                    "src/b.ts": "export const b = 1;\n",
+                },
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 120,
+                    totalFiles: 2,
+                    files: [
+                        { path: "src/a.ts", bytes: 80, lines: 2, depth: 1 },
+                        { path: "src/b.ts", bytes: 40, lines: 1, depth: 1 },
+                    ],
+                },
+            },
+            expect: { reading: { kind: "inventory", items: [] }, score: 100 },
+        },
+        {
+            name: "cycle",
+            evidence: {
+                files: {
+                    "src/a.ts": 'import { b } from "./b";\nexport const a = b;\n',
+                    "src/b.ts": 'import { a } from "./a";\nexport const b = a;\n',
+                },
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 160,
+                    totalFiles: 2,
+                    files: [
+                        { path: "src/a.ts", bytes: 80, lines: 2, depth: 1 },
+                        { path: "src/b.ts", bytes: 80, lines: 2, depth: 1 },
+                    ],
+                },
+            },
+            expect: {
+                reading: {
+                    kind: "inventory",
+                    items: [
+                        {
+                            location: { path: "src/a.ts" },
+                            severity: "error",
+                            message: "import cycle: src/a.ts -> src/b.ts -> src/a.ts",
+                        },
+                    ],
+                },
+                score: 0,
+            },
+        },
+    ],
+});
+function extractImports(text) {
+    const out = [];
+    IMPORT_RE.lastIndex = 0;
+    let match = IMPORT_RE.exec(text);
+    while (match !== null) {
+        const spec = match[1] ?? match[2] ?? match[3];
+        if (spec?.startsWith("."))
+            out.push(spec);
+        match = IMPORT_RE.exec(text);
+    }
+    return out;
+}
+function resolveRelativeImport(fromPath, spec, sourceSet) {
+    const base = path.normalize(path.join(path.dirname(fromPath), spec));
+    const candidates = [base, ...EXTENSIONS.map((ext) => `${base}${ext}`)];
+    for (const ext of EXTENSIONS)
+        candidates.push(path.join(base, `index${ext}`));
+    return candidates.find((candidate) => sourceSet.has(candidate)) ?? null;
+}
+function findCycles(graph) {
+    const cycles = [];
+    const seen = new Set();
+    const visiting = new Set();
+    const visited = new Set();
+    const stack = [];
+    function visit(node) {
+        if (cycles.length >= 10)
+            return;
+        visiting.add(node);
+        stack.push(node);
+        for (const next of graph.get(node) ?? []) {
+            if (visiting.has(next)) {
+                const idx = stack.indexOf(next);
+                const cycle = [...stack.slice(idx), next];
+                const key = canonicalCycleKey(cycle);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    cycles.push(cycle);
+                }
+            }
+            else if (!visited.has(next)) {
+                visit(next);
+            }
+        }
+        stack.pop();
+        visiting.delete(node);
+        visited.add(node);
+    }
+    for (const node of graph.keys()) {
+        if (!visited.has(node))
+            visit(node);
+    }
+    return cycles;
+}
+function canonicalCycleKey(cycle) {
+    const body = cycle.slice(0, -1);
+    const rotations = body.map((_, i) => [...body.slice(i), ...body.slice(0, i)].join(" -> "));
+    return rotations.sort()[0] ?? cycle.join(" -> ");
+}
+//# sourceMappingURL=arch-coupling-hotspots.js.map

package/dist/probes/arch-coupling-hotspots.js.map

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

package/dist/probes/contracts-machine-readable.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@esbenwiberg/repofit/sdk").Probe;
+export default _default;
+//# sourceMappingURL=contracts-machine-readable.d.ts.map

package/dist/probes/contracts-machine-readable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-machine-readable.d.ts","sourceRoot":"","sources":["../../src/probes/contracts-machine-readable.ts"],"names":[],"mappings":";AAiBA,wBAmIG"}

package/dist/probes/contracts-machine-readable.js

@@ -0,0 +1,139 @@
+import { defineProbe } from "@esbenwiberg/repofit/sdk";
+const CONTRACT_PATTERNS = [
+    /(?:^|\/)(?:openapi|swagger)\.(?:ya?ml|json)$/i,
+    /(?:^|\/)[^/]+\.proto$/i,
+    /(?:^|\/)(?:schema|[^/]+)\.graphql$/i,
+    /(?:^|\/)[^/]+\.schema\.json$/i,
+    /(?:^|\/)prisma\/schema\.prisma$/i,
+    /(?:^|\/)db\/schema\.(?:ts|js)$/i,
+    /(?:^|\/)src\/schema\.(?:ts|js)$/i,
+];
+const TEST_FILE = /(?:\.test\.|\.spec\.|__tests__|^tests?\/|^e2e\/)/i;
+const GENERATION_OR_VALIDATION_SCRIPT = /\b(openapi|swagger|proto|buf|graphql|prisma|drizzle|schema|contract)\b/i;
+export default defineProbe({
+    id: "contracts.machine-readable",
+    version: "1.0.0",
+    dimensions: [
+        { id: "context", weight: 1 },
+        { id: "feedback", weight: 0.7 },
+    ],
+    tier: "static",
+    evidence: ["size_stats", "node_package"],
+    rationale: `
+    Agents do better when boundary facts live in machine-readable contracts:
+    OpenAPI, GraphQL, protobuf, JSON Schema, Prisma/DB schema, or equivalent.
+    This probe does not require every repo to expose an API; it activates when
+    contract files exist and then checks for tests or validation/generation
+    scripts that keep those contracts honest.
+  `,
+    remediation: "Keep API, message, and data-shape contracts in machine-readable files, then wire them to tests or generation/validation scripts. A contract that is not checked can drift into decorative documentation.",
+    async detect(ev) {
+        const paths = ev.size_stats.files.filter((f) => !f.generated).map((f) => f.path);
+        const contracts = paths
+            .filter((p) => CONTRACT_PATTERNS.some((pattern) => pattern.test(p)))
+            .sort();
+        if (contracts.length === 0) {
+            return { kind: "na", reason: "no machine-readable contract files detected" };
+        }
+        const testPaths = paths.filter((p) => TEST_FILE.test(p));
+        const scripts = ev.node_package.present ? Object.values(ev.node_package.scripts ?? {}) : [];
+        const hasContractScript = scripts.some((script) => GENERATION_OR_VALIDATION_SCRIPT.test(script));
+        const items = [];
+        for (const contract of contracts) {
+            const stem = contractStem(contract);
+            const hasNearbyTest = testPaths.some((p) => p.toLowerCase().includes(stem));
+            if (!hasNearbyTest) {
+                items.push({
+                    location: { path: contract },
+                    severity: "warn",
+                    message: "contract has no obvious matching test file",
+                });
+            }
+        }
+        if (!hasContractScript) {
+            items.push({
+                location: { path: "package.json#scripts" },
+                severity: "info",
+                message: "no obvious contract generation or validation script",
+            });
+        }
+        return { kind: "inventory", items };
+    },
+    score: {
+        kind: "inventory",
+        severityWeights: { info: 1, warn: 3, error: 10 },
+        bands: [{ upTo: 0, score: 100 }, { upTo: 2, score: 80 }, { upTo: 6, score: 50 }, { score: 0 }],
+    },
+    fixtures: [
+        {
+            name: "no-contracts",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 100,
+                    totalFiles: 1,
+                    files: [{ path: "src/index.ts", bytes: 100, lines: 5, depth: 1 }],
+                },
+                node_package: { present: true, scripts: {} },
+            },
+            expect: {
+                reading: { kind: "na", reason: "no machine-readable contract files detected" },
+                score: null,
+            },
+        },
+        {
+            name: "contract-tested-and-generated",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 200,
+                    totalFiles: 2,
+                    files: [
+                        { path: "openapi.yaml", bytes: 100, lines: 10, depth: 0 },
+                        { path: "test/openapi.test.ts", bytes: 100, lines: 5, depth: 1 },
+                    ],
+                },
+                node_package: { present: true, scripts: { "openapi:check": "openapi lint openapi.yaml" } },
+            },
+            expect: { reading: { kind: "inventory", items: [] }, score: 100 },
+        },
+        {
+            name: "contract-without-checks",
+            evidence: {
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 100,
+                    totalFiles: 1,
+                    files: [{ path: "schema.graphql", bytes: 100, lines: 10, depth: 0 }],
+                },
+                node_package: { present: true, scripts: { test: "vitest run" } },
+            },
+            expect: {
+                reading: {
+                    kind: "inventory",
+                    items: [
+                        {
+                            location: { path: "schema.graphql" },
+                            severity: "warn",
+                            message: "contract has no obvious matching test file",
+                        },
+                        {
+                            location: { path: "package.json#scripts" },
+                            severity: "info",
+                            message: "no obvious contract generation or validation script",
+                        },
+                    ],
+                },
+                score: 50,
+            },
+        },
+    ],
+});
+function contractStem(contract) {
+    const name = contract.split("/").pop() ?? contract;
+    return name
+        .replace(/\.(?:ya?ml|json|proto|graphql|prisma|ts|js)$/i, "")
+        .replace(/\.schema$/i, "")
+        .toLowerCase();
+}
+//# sourceMappingURL=contracts-machine-readable.js.map

package/dist/probes/contracts-machine-readable.js.map

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