@esbenwiberg/corpus-default 1.1.0

package/dist/fixers/gitignore-comprehensive.js

@@ -0,0 +1,61 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { defineFixer } from "@esbenwiberg/repofit/sdk";
+const STANDARD_ENTRIES = [
+    "# dependencies",
+    "node_modules/",
+    "",
+    "# build artifacts",
+    "dist/",
+    "build/",
+    "out/",
+    "",
+    "# env",
+    ".env",
+    ".env.local",
+    ".env.*.local",
+    "",
+    "# OS junk",
+    ".DS_Store",
+    "Thumbs.db",
+    "",
+    "# editor state",
+    ".idea/",
+    ".vscode/",
+];
+export default defineFixer({
+    probeId: "gitignore.comprehensive",
+    mode: "static",
+    describe: "add standard entries to .gitignore",
+    async plan({ cwd }) {
+        const filePath = path.join(cwd, ".gitignore");
+        let existing = "";
+        try {
+            existing = await readFile(filePath, "utf8");
+        }
+        catch {
+            existing = "";
+        }
+        const existingLines = new Set(existing.split("\n").map((l) => l.trim()));
+        const missing = STANDARD_ENTRIES.filter((line) => line === "" || line.startsWith("#") || !existingLines.has(line.trim()));
+        if (existing.length === 0) {
+            return {
+                actions: [
+                    {
+                        kind: "append-lines",
+                        path: ".gitignore",
+                        lines: STANDARD_ENTRIES,
+                        createIfMissing: true,
+                    },
+                ],
+            };
+        }
+        const nonComment = missing.filter((l) => l !== "" && !l.startsWith("#"));
+        if (nonComment.length === 0)
+            return null;
+        return {
+            actions: [{ kind: "append-lines", path: ".gitignore", lines: nonComment }],
+        };
+    },
+});
+//# sourceMappingURL=gitignore-comprehensive.js.map

package/dist/fixers/gitignore-comprehensive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-comprehensive.js","sourceRoot":"","sources":["../../src/fixers/gitignore-comprehensive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,gBAAgB,GAAG;IACvB,gBAAgB;IAChB,eAAe;IACf,EAAE;IACF,mBAAmB;IACnB,OAAO;IACP,QAAQ;IACR,MAAM;IACN,EAAE;IACF,OAAO;IACP,MAAM;IACN,YAAY;IACZ,cAAc;IACd,EAAE;IACF,WAAW;IACX,WAAW;IACX,WAAW;IACX,EAAE;IACF,gBAAgB;IAChB,QAAQ;IACR,UAAU;CACX,CAAC;AAEF,eAAe,WAAW,CAAC;IACzB,OAAO,EAAE,yBAAyB;IAClC,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,oCAAoC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC9C,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CACjF,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,cAAc;wBACpB,IAAI,EAAE,YAAY;wBAClB,KAAK,EAAE,gBAAgB;wBACvB,eAAe,EAAE,IAAI;qBACtB;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;SAC3E,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export declare const meta: {
+    name: string;
+    version: string;
+};
+export declare const probes: import("@esbenwiberg/repofit/sdk").Probe[];
+export declare const dimensions: import("@esbenwiberg/repofit/sdk").DimensionRecipe[];
+export declare const fixers: import("@esbenwiberg/repofit/sdk").Fixer[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0EA,eAAO,MAAM,IAAI;;;CAGhB,CAAC;AAEF,eAAO,MAAM,MAAM,4CA2DlB,CAAC;AAEF,eAAO,MAAM,UAAU,sDAOtB,CAAC;AAEF,eAAO,MAAM,MAAM,4CAOlB,CAAC"}

package/dist/index.js

@@ -0,0 +1,153 @@
+import { createRequire } from "node:module";
+import consistencyDimension from "./dimensions/consistency.js";
+import contextDimension from "./dimensions/context.js";
+import costDimension from "./dimensions/cost.js";
+import feedbackDimension from "./dimensions/feedback.js";
+import latencyDimension from "./dimensions/latency.js";
+import safetyDimension from "./dimensions/safety.js";
+import agentGuidancePresentFixer from "./fixers/agent-guidance-present.js";
+import agentGuidancePresentLlmFixer from "./fixers/agent-guidance-present-llm.js";
+import docsReadmePresentFixer from "./fixers/docs-readme-present.js";
+import docsReadmePresentLlmFixer from "./fixers/docs-readme-present-llm.js";
+import editorconfigPresentFixer from "./fixers/editorconfig-present.js";
+import gitignoreComprehensiveFixer from "./fixers/gitignore-comprehensive.js";
+import agentGuidanceFresh from "./probes/agent-guidance-fresh.js";
+import agentGuidanceNested from "./probes/agent-guidance-nested.js";
+import agentGuidancePresent from "./probes/agent-guidance-present.js";
+import agentGuidanceQuality from "./probes/agent-guidance-quality.js";
+import agentGuidanceSubstance from "./probes/agent-guidance-substance.js";
+import archBoundariesClear from "./probes/arch-boundaries-clear.js";
+import archDocPresent from "./probes/arch-doc-present.js";
+import archDocQuality from "./probes/arch-doc-quality.js";
+import archFitnessTestsConfigured from "./probes/arch-fitness-tests-configured.js";
+import buildClean from "./probes/build-clean.js";
+import buildConfigured from "./probes/build-configured.js";
+import changelogStrategyDeclared from "./probes/changelog-strategy-declared.js";
+import ciConfigured from "./probes/ci-configured.js";
+import ciRunsBuild from "./probes/ci-runs-build.js";
+import ciRunsLint from "./probes/ci-runs-lint.js";
+import ciRunsTests from "./probes/ci-runs-tests.js";
+import ciRunsTypecheck from "./probes/ci-runs-typecheck.js";
+import commitsConventionalFollowed from "./probes/commits-conventional-followed.js";
+import deadCodeConfigured from "./probes/dead-code-configured.js";
+import depsAuditConfigured from "./probes/deps-audit-configured.js";
+import depsLockfilePresent from "./probes/deps-lockfile-present.js";
+import docsAdrPresence from "./probes/docs-adr-presence.js";
+import docsAdrQuality from "./probes/docs-adr-quality.js";
+import docsContributingPresent from "./probes/docs-contributing-present.js";
+import docsLinksResolved from "./probes/docs-links-resolved.js";
+import docsReadmeClarity from "./probes/docs-readme-clarity.js";
+import docsReadmePresent from "./probes/docs-readme-present.js";
+import docsReadmeSubstance from "./probes/docs-readme-substance.js";
+import editorconfigPresent from "./probes/editorconfig-present.js";
+import errorsActionability from "./probes/errors-actionability.js";
+import formatClean from "./probes/format-clean.js";
+import formatConfigured from "./probes/format-configured.js";
+import gitBranchProtection from "./probes/git-branch-protection.js";
+import gitignoreComprehensive from "./probes/gitignore-comprehensive.js";
+import hooksGatesLintTestBuild from "./probes/hooks-gates-lint-test-build.js";
+import hooksPrecommitPresent from "./probes/hooks-precommit-present.js";
+import latencyBuild from "./probes/latency-build.js";
+import latencyLint from "./probes/latency-lint.js";
+import latencyTestSuite from "./probes/latency-test-suite.js";
+import latencyTypecheck from "./probes/latency-typecheck.js";
+import lintClean from "./probes/lint-clean.js";
+import lintConfigured from "./probes/lint-configured.js";
+import readmeCommandsRunnable from "./probes/readme-commands-runnable.js";
+import runtimeDevLoopBootable from "./probes/runtime-dev-loop-bootable.js";
+import safetyDangerousScriptFlags from "./probes/safety-dangerous-script-flags.js";
+import secretsDotenvGitignored from "./probes/secrets-dotenv-gitignored.js";
+import secretsPrecommitScanConfigured from "./probes/secrets-precommit-scan-configured.js";
+import secretsScanClean from "./probes/secrets-scan-clean.js";
+import sizeDirectoryDepth from "./probes/size-directory-depth.js";
+import sizeLargeFiles from "./probes/size-large-files.js";
+import sizeRepoTokenEstimate from "./probes/size-repo-token-estimate.js";
+import specsPresent from "./probes/specs-present.js";
+import specsQuality from "./probes/specs-quality.js";
+import testsClean from "./probes/tests-clean.js";
+import testsCoverPublicSurface from "./probes/tests-cover-public-surface.js";
+import testsRunnerConfigured from "./probes/tests-runner-configured.js";
+import typesClean from "./probes/types-clean.js";
+import typesConfigured from "./probes/types-configured.js";
+const pkg = createRequire(import.meta.url)("../package.json");
+export const meta = {
+    name: pkg.name,
+    version: pkg.version,
+};
+export const probes = [
+    agentGuidanceFresh,
+    agentGuidanceNested,
+    agentGuidancePresent,
+    agentGuidanceQuality,
+    agentGuidanceSubstance,
+    archBoundariesClear,
+    archDocPresent,
+    archDocQuality,
+    archFitnessTestsConfigured,
+    buildClean,
+    buildConfigured,
+    changelogStrategyDeclared,
+    ciConfigured,
+    ciRunsBuild,
+    ciRunsLint,
+    ciRunsTests,
+    ciRunsTypecheck,
+    commitsConventionalFollowed,
+    deadCodeConfigured,
+    depsAuditConfigured,
+    depsLockfilePresent,
+    docsAdrPresence,
+    docsAdrQuality,
+    docsContributingPresent,
+    docsLinksResolved,
+    docsReadmeClarity,
+    docsReadmePresent,
+    docsReadmeSubstance,
+    editorconfigPresent,
+    errorsActionability,
+    formatClean,
+    formatConfigured,
+    gitBranchProtection,
+    gitignoreComprehensive,
+    hooksGatesLintTestBuild,
+    hooksPrecommitPresent,
+    latencyBuild,
+    latencyLint,
+    latencyTestSuite,
+    latencyTypecheck,
+    lintClean,
+    lintConfigured,
+    readmeCommandsRunnable,
+    runtimeDevLoopBootable,
+    safetyDangerousScriptFlags,
+    secretsDotenvGitignored,
+    secretsPrecommitScanConfigured,
+    secretsScanClean,
+    sizeDirectoryDepth,
+    sizeLargeFiles,
+    sizeRepoTokenEstimate,
+    specsPresent,
+    specsQuality,
+    testsClean,
+    testsCoverPublicSurface,
+    testsRunnerConfigured,
+    typesClean,
+    typesConfigured,
+];
+export const dimensions = [
+    contextDimension,
+    consistencyDimension,
+    costDimension,
+    feedbackDimension,
+    latencyDimension,
+    safetyDimension,
+];
+export const fixers = [
+    agentGuidancePresentFixer,
+    agentGuidancePresentLlmFixer,
+    docsReadmePresentFixer,
+    docsReadmePresentLlmFixer,
+    editorconfigPresentFixer,
+    gitignoreComprehensiveFixer,
+];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/probes/_shared/latency-bands.d.ts

@@ -0,0 +1,3 @@
+import type { Band } from "@esbenwiberg/repofit/sdk";
+export declare const LATENCY_BANDS: Band[];
+//# sourceMappingURL=latency-bands.d.ts.map

package/dist/probes/_shared/latency-bands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-bands.d.ts","sourceRoot":"","sources":["../../../src/probes/_shared/latency-bands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,IAAI,EAM/B,CAAC"}

package/dist/probes/_shared/latency-bands.js

@@ -0,0 +1,8 @@
+export const LATENCY_BANDS = [
+    { upTo: 10_000, score: 100 },
+    { upTo: 30_000, score: 80 },
+    { upTo: 120_000, score: 50 },
+    { upTo: 300_000, score: 20 },
+    { score: 0 },
+];
+//# sourceMappingURL=latency-bands.js.map

package/dist/probes/_shared/latency-bands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-bands.js","sourceRoot":"","sources":["../../../src/probes/_shared/latency-bands.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;IAC5B,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IAC3B,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;IAC5B,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;IAC5B,EAAE,KAAK,EAAE,CAAC,EAAE;CACb,CAAC"}

package/dist/probes/agent-guidance-fresh.d.ts

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

package/dist/probes/agent-guidance-fresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guidance-fresh.d.ts","sourceRoot":"","sources":["../../src/probes/agent-guidance-fresh.ts"],"names":[],"mappings":";AAgCA,wBAwLG"}

package/dist/probes/agent-guidance-fresh.js

@@ -0,0 +1,198 @@
+import { defineProbe } from "@esbenwiberg/repofit/sdk";
+const PROBE_VERSION = "1.0.0";
+const MAX_GUIDANCE_CHARS = 12_000;
+const MAX_TREE_ENTRIES = 200;
+const RUBRIC = {
+    task: "Score how FRESH the agent-guidance file is — does it still match the current state of the repo? You will see the guidance content alongside a snapshot of the repo (top-level tree, package.json scripts). Penalise stale claims; reward content that aligns with what's actually there.",
+    criteria: [
+        {
+            id: "paths-exist",
+            description: "Do the file paths and directory names mentioned in the guidance still exist in the tree snapshot? Penalise references to paths that have been removed or renamed.",
+        },
+        {
+            id: "commands-valid",
+            description: "Do the build/test/run commands referenced in the guidance match the actual scripts in package.json (or the actual tooling visible in the tree)? Penalise commands that no longer resolve.",
+        },
+        {
+            id: "architecture-matches",
+            description: "Does the architectural description (modules, packages, layering) match the current directory layout? Penalise stale claims about packages or modules that no longer exist, or omissions of major new ones.",
+        },
+        {
+            id: "no-stale-claims",
+            description: "Are there claims about features, status, deadlines, or in-progress work that look outdated relative to the current state? A '🚧 in progress' note for something that's clearly shipped, or a 'coming soon' for something that's been there for a year, costs points.",
+        },
+    ],
+};
+export default defineProbe({
+    id: "agent.guidance-fresh",
+    version: PROBE_VERSION,
+    dimensions: [
+        { id: "context", weight: 1 },
+        { id: "consistency", weight: 0.5 },
+    ],
+    tier: "reasoned",
+    evidence: ["agent_config", "files", "node_package", "size_stats", "judge"],
+    rationale: `
+    A CLAUDE.md or AGENTS.md that's well-written but out-of-date is worse than
+    no guidance at all — the agent will confidently follow stale directions
+    into dead ends. This probe asks an LLM to compare guidance content
+    against a snapshot of the actual repo (top-level tree, package.json
+    scripts) and flag references that no longer resolve: paths that have
+    moved, commands that don't exist, architecture descriptions that don't
+    match the current layout, in-progress markers for shipped features.
+  `,
+    remediation: "Sweep your CLAUDE.md / AGENTS.md against the current repo: every path mentioned should exist, every command should resolve to a real script, every architecture claim should match the layout, every status note ('in progress', 'coming soon') should still be true. Re-run this probe after the sweep — a stale guidance file silently misdirects every agent that lands.",
+    async detect(ev) {
+        const guidance = ev.agent_config.guidance;
+        if (guidance.length === 0) {
+            return { kind: "na", reason: "no agent-guidance file present" };
+        }
+        const parts = [];
+        let remaining = MAX_GUIDANCE_CHARS;
+        for (const g of guidance) {
+            if (remaining <= 0)
+                break;
+            const text = await ev.files.readText(g.path);
+            if (!text)
+                continue;
+            const slice = text.slice(0, remaining);
+            parts.push(`# ${g.path}\n\n${slice}`);
+            remaining -= slice.length;
+        }
+        if (parts.length === 0) {
+            return { kind: "na", reason: "agent-guidance files declared but unreadable" };
+        }
+        const topLevel = new Set();
+        for (const f of ev.size_stats.files) {
+            const top = f.path.split("/")[0];
+            if (top)
+                topLevel.add(top);
+        }
+        const treeEntries = Array.from(topLevel).sort().slice(0, MAX_TREE_ENTRIES);
+        const treeSection = `## Top-level entries\n${treeEntries.join("\n")}`;
+        let scriptsSection = "";
+        if (ev.node_package.present) {
+            const names = Object.keys(ev.node_package.scripts).sort();
+            scriptsSection = `\n\n## package.json scripts\n${names.join("\n")}`;
+        }
+        const repoSnapshot = `${treeSection}${scriptsSection}`;
+        const guidanceCombined = parts.join("\n\n---\n\n");
+        const input = `# REPO SNAPSHOT\n\n${repoSnapshot}\n\n---\n\n# AGENT GUIDANCE\n\n${guidanceCombined}`;
+        const result = await ev.judge.score({
+            probeId: "agent.guidance-fresh",
+            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-guidance",
+            evidence: {
+                agent_config: { guidance: [] },
+                node_package: { present: false },
+                size_stats: { files: [], totalBytes: 0, totalFiles: 0, source: "git-ls-files" },
+            },
+            expect: { reading: { kind: "na", reason: "no agent-guidance file present" }, score: null },
+        },
+        {
+            name: "fresh-guidance",
+            evidence: {
+                agent_config: { guidance: [{ path: "CLAUDE.md", bytes: 500, lines: 20 }] },
+                files: {
+                    "CLAUDE.md": "# Project\n\nMain code lives in `src/`. Run `npm test` and `npm run build`.",
+                },
+                node_package: { present: true, scripts: { test: "vitest", build: "tsc" } },
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 500,
+                    totalFiles: 2,
+                    files: [
+                        { path: "src/index.ts", bytes: 300, lines: 10, depth: 1 },
+                        { path: "CLAUDE.md", bytes: 200, lines: 10, depth: 0 },
+                    ],
+                },
+                judge: {
+                    score: 90,
+                    perCriterion: {
+                        "paths-exist": 100,
+                        "commands-valid": 100,
+                        "architecture-matches": 80,
+                        "no-stale-claims": 80,
+                    },
+                    rationale: "All references match repo state.",
+                    model: "fixture",
+                },
+            },
+            expect: {
+                reading: {
+                    kind: "judge",
+                    score: 90,
+                    perCriterion: {
+                        "paths-exist": 100,
+                        "commands-valid": 100,
+                        "architecture-matches": 80,
+                        "no-stale-claims": 80,
+                    },
+                    rationale: "All references match repo state.",
+                    model: "fixture",
+                },
+                score: 90,
+            },
+        },
+        {
+            name: "stale-guidance",
+            evidence: {
+                agent_config: { guidance: [{ path: "CLAUDE.md", bytes: 500, lines: 20 }] },
+                files: {
+                    "CLAUDE.md": "# Project\n\nCode lives in `lib/`. Run `npm run dev` for the dev server. The `experimental/` folder is 🚧 in progress.",
+                },
+                node_package: { present: true, scripts: { test: "vitest" } },
+                size_stats: {
+                    source: "git-ls-files",
+                    totalBytes: 500,
+                    totalFiles: 2,
+                    files: [
+                        { path: "src/index.ts", bytes: 300, lines: 10, depth: 1 },
+                        { path: "CLAUDE.md", bytes: 200, lines: 10, depth: 0 },
+                    ],
+                },
+                judge: {
+                    score: 25,
+                    perCriterion: {
+                        "paths-exist": 20,
+                        "commands-valid": 20,
+                        "architecture-matches": 30,
+                        "no-stale-claims": 30,
+                    },
+                    rationale: "References lib/ and experimental/ which don't exist; npm run dev not a script.",
+                    model: "fixture",
+                },
+            },
+            expect: {
+                reading: {
+                    kind: "judge",
+                    score: 25,
+                    perCriterion: {
+                        "paths-exist": 20,
+                        "commands-valid": 20,
+                        "architecture-matches": 30,
+                        "no-stale-claims": 30,
+                    },
+                    rationale: "References lib/ and experimental/ which don't exist; npm run dev not a script.",
+                    model: "fixture",
+                },
+                score: 25,
+            },
+        },
+    ],
+});
+//# sourceMappingURL=agent-guidance-fresh.js.map

package/dist/probes/agent-guidance-fresh.js.map

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

package/dist/probes/agent-guidance-nested.d.ts

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

package/dist/probes/agent-guidance-nested.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guidance-nested.d.ts","sourceRoot":"","sources":["../../src/probes/agent-guidance-nested.ts"],"names":[],"mappings":";AA8BA,wBAgKG"}