@curiousnerd/keel 0.1.0

package/dist/mcp/tools.js

@@ -0,0 +1,173 @@
+import { analyze } from "../analyze/index.js";
+import { filesByPackage, loadCapabilityBuckets } from "../analyze/shared.js";
+/** Split an identifier into lowercase word tokens: formatDate -> [format, date]. */
+function nameTokens(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[_\-]/g, " ")
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(Boolean);
+}
+const STOPWORDS = new Set([
+    "a", "an", "the", "to", "of", "for", "and", "or", "in", "on", "with", "that", "this",
+    "write", "writing", "create", "creating", "add", "adding", "new", "function", "method",
+    "make", "build", "some", "thing", "code", "want", "need",
+]);
+function intentTokens(intent) {
+    return new Set(intent
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length >= 2 && !STOPWORDS.has(t)));
+}
+/** Keywords that map a natural-language intent onto a capability bucket. */
+const BUCKET_KEYWORDS = {
+    http: ["http", "request", "fetch", "api", "endpoint", "rest", "post", "ajax", "axios"],
+    date: ["date", "time", "timestamp", "datetime", "calendar"],
+    validation: ["validate", "validation", "schema", "sanitize", "validator"],
+    logging: ["log", "logger", "logging"],
+    uuid: ["uuid", "guid", "nanoid", "ulid"],
+    state: ["state", "store", "reducer"],
+    orm: ["query", "database", "orm", "migration", "repository"],
+    test: ["test", "spec", "fixture", "mock"],
+};
+function bucketsForIntent(tokens) {
+    const out = [];
+    for (const [bucket, keywords] of Object.entries(BUCKET_KEYWORDS)) {
+        if (keywords.some((k) => tokens.has(k)))
+            out.push(bucket);
+    }
+    return out;
+}
+/** Per-bucket packages actually imported, "pkg (N files)". */
+function librariesInUse(facts, buckets) {
+    const byPkg = filesByPackage(facts);
+    const out = new Map();
+    for (const [bucket, members] of Object.entries(buckets)) {
+        const present = members
+            .map((pkg) => ({ pkg, n: byPkg.get(pkg)?.length ?? 0 }))
+            .filter((e) => e.n > 0)
+            .map((e) => `${e.pkg} (${e.n} file${e.n === 1 ? "" : "s"})`);
+        if (present.length)
+            out.set(bucket, present);
+    }
+    return out;
+}
+function dominantNaming(facts, pathPrefix) {
+    const totals = { lower: 0, camelCase: 0, PascalCase: 0, snake_case: 0, CONSTANT_CASE: 0, other: 0 };
+    for (const f of facts.files) {
+        if (pathPrefix && !f.path.startsWith(pathPrefix))
+            continue;
+        for (const k of Object.keys(totals))
+            totals[k] += f.naming[k];
+    }
+    if (totals.camelCase + totals.snake_case < 4)
+        return null; // too little signal
+    return totals.camelCase >= totals.snake_case ? "camelCase" : "snake_case";
+}
+function dominantLanguage(facts, pathPrefix) {
+    const counts = new Map();
+    for (const f of facts.files) {
+        if (pathPrefix && !f.path.startsWith(pathPrefix))
+            continue;
+        counts.set(f.language, (counts.get(f.language) ?? 0) + 1);
+    }
+    let best = null;
+    let max = 0;
+    for (const [lang, n] of counts)
+        if (n > max)
+            ((max = n), (best = lang));
+    return best;
+}
+// ---------------------------------------------------------------------------
+// Tool 1: check_before_write
+// ---------------------------------------------------------------------------
+/** Suggest existing utilities + libraries to reuse before the agent writes new code. */
+export function checkBeforeWrite(facts, intent, buckets = loadCapabilityBuckets()) {
+    const tokens = intentTokens(intent);
+    if (tokens.size === 0)
+        return `No specific intent recognized in "${intent}". Write it in the project's conventions.`;
+    // Existing named functions whose name overlaps the intent.
+    const matches = [];
+    for (const file of facts.files) {
+        for (const fn of file.functions) {
+            if (!fn.name)
+                continue;
+            const overlap = nameTokens(fn.name).filter((t) => tokens.has(t)).length;
+            if (overlap > 0)
+                matches.push({ name: fn.name, loc: `${fn.filePath}:${fn.startLine}`, score: overlap });
+        }
+    }
+    matches.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+    const top = dedupeByName(matches).slice(0, 6);
+    // Libraries already in use for any capability the intent implies.
+    const inUse = librariesInUse(facts, buckets);
+    const relevant = bucketsForIntent(tokens)
+        .map((b) => ({ bucket: b, libs: inUse.get(b) }))
+        .filter((e) => Array.isArray(e.libs));
+    const lines = [`Before writing for "${intent}":`];
+    if (top.length) {
+        lines.push("", "Existing functions you may be about to reinvent — reuse if they fit:");
+        for (const m of top)
+            lines.push(`  - ${m.name}()  @ ${m.loc}`);
+    }
+    if (relevant.length) {
+        lines.push("", "This project already uses these libraries — match them, don't add a competitor:");
+        for (const e of relevant)
+            lines.push(`  - ${e.bucket}: ${e.libs.join(", ")}`);
+    }
+    const naming = dominantNaming(facts);
+    if (top.length === 0 && relevant.length === 0) {
+        lines.push("", `Nothing existing matches — safe to write it fresh${naming ? ` (use ${naming})` : ""}.`);
+    }
+    else if (naming) {
+        lines.push("", `If you do write new code, name it in ${naming} to match this project.`);
+    }
+    return lines.join("\n");
+}
+function dedupeByName(matches) {
+    const seen = new Set();
+    return matches.filter((m) => (seen.has(m.name) ? false : (seen.add(m.name), true)));
+}
+// ---------------------------------------------------------------------------
+// Tool 2: get_conventions
+// ---------------------------------------------------------------------------
+/** Report the verified, current conventions for an area of the codebase. */
+export function getConventions(facts, path, buckets = loadCapabilityBuckets()) {
+    const prefix = path.replace(/^\.?\//, "").replace(/\/[^/]*$/, ""); // directory of the path
+    const scoped = facts.files.some((f) => f.path.startsWith(prefix)) ? prefix : undefined;
+    const language = dominantLanguage(facts, scoped);
+    const naming = dominantNaming(facts, scoped);
+    const inUse = librariesInUse(facts, buckets);
+    const lines = [`Conventions for ${path || "this repo"} (derived from the actual code):`];
+    if (language)
+        lines.push(`  - Language: ${language}`);
+    if (naming)
+        lines.push(`  - Naming: ${naming}`);
+    if (facts.pkg)
+        lines.push(`  - Package manager: ${facts.pkg.packageManager}`);
+    if (inUse.size) {
+        const libs = [...inUse.entries()].map(([b, l]) => `${b}=${l.map((s) => s.split(" ")[0]).join("/")}`);
+        lines.push(`  - Libraries in use: ${libs.join(", ")}`);
+    }
+    if (lines.length === 1)
+        lines.push("  (not enough code yet to infer conventions)");
+    else
+        lines.push("Match these when adding code here.");
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Tool 3: report_drift
+// ---------------------------------------------------------------------------
+/** Current deterministic drift + library-conflict findings (the "you're inconsistent" signals). */
+export function reportDrift(facts, claims, config) {
+    const { findings } = analyze(facts, claims, config);
+    const relevant = findings.filter((f) => f.kind === "drift" || f.kind === "conflict");
+    if (relevant.length === 0)
+        return "No drift or library conflicts detected. The code is consistent with its stated decisions.";
+    const lines = ["Current drift & library conflicts — fix these or don't add to them:"];
+    for (const f of relevant)
+        lines.push(`  - ${f.kind.toUpperCase()}: ${f.title}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAA0B,MAAM,sBAAsB,CAAC;AAErG,oFAAoF;AACpF,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACpF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ;IACtF,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CACzD,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,IAAI,GAAG,CACZ,MAAM;SACH,WAAW,EAAE;SACb,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACrD,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,eAAe,GAA6B;IAChD,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACtF,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC;IAC3D,UAAU,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC;IACzE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;IACpC,GAAG,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,CAAC;IAC5D,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC;CAC1C,CAAC;AAEF,SAAS,gBAAgB,CAAC,MAAmB;IAC3C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QACjE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8DAA8D;AAC9D,SAAS,cAAc,CAAC,KAAY,EAAE,OAA0B;IAC9D,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,OAAO;aACpB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;aACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAC/D,IAAI,OAAO,CAAC,MAAM;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,KAAY,EAAE,UAAmB;IACvD,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACpG,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAC3D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAA4B;YAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,oBAAoB;IAC/E,OAAO,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;AAC5E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAY,EAAE,UAAmB;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAC3D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,GAAoB,IAAI,CAAC;IACjC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM;QAAE,IAAI,CAAC,GAAG,GAAG;YAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,MAAc,EAAE,OAAO,GAAG,qBAAqB,EAAE;IAC9F,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,qCAAqC,MAAM,2CAA2C,CAAC;IAErH,2DAA2D;IAC3D,MAAM,OAAO,GAAwD,EAAE,CAAC;IACxE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE,CAAC,IAAI;gBAAE,SAAS;YACvB,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACxE,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9C,kEAAkE;IAClE,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC/C,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjF,MAAM,KAAK,GAAa,CAAC,uBAAuB,MAAM,IAAI,CAAC,CAAC;IAE5D,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sEAAsE,CAAC,CAAC;QACvF,KAAK,MAAM,CAAC,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,iFAAiF,CAAC,CAAC;QAClG,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oDAAoD,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1G,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,wCAAwC,MAAM,yBAAyB,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,OAA4D;IAChF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,IAAY,EAAE,OAAO,GAAG,qBAAqB,EAAE;IAC1F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB;IAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAa,CAAC,mBAAmB,IAAI,IAAI,WAAW,kCAAkC,CAAC,CAAC;IACnG,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACtD,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;;QAC9E,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,MAAc,EAAE,MAAkB;IAC1E,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACrF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,2FAA2F,CAAC;IAE9H,MAAM,KAAK,GAAG,CAAC,qEAAqE,CAAC,CAAC;IACtF,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/report/json.d.ts

@@ -0,0 +1,3 @@
+import type { Report } from "../types.js";
+/** Render a Report as stable, machine-readable JSON. */
+export declare function renderJson(report: Report): string;

package/dist/report/json.js

@@ -0,0 +1,5 @@
+/** Render a Report as stable, machine-readable JSON. */
+export function renderJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/report/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/report/json.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/report/markdown.d.ts

@@ -0,0 +1,9 @@
+import type { Report } from "../types.js";
+/**
+ * Deterministic, $0 "next steps" — derived from the score breakdown and finding
+ * counts. Used as the How-to-improve section when the LLM is off, and as a
+ * fallback when it's on.
+ */
+export declare function improvementSummary(report: Report): string;
+/** Render a full, uncapped Markdown report. */
+export declare function renderMarkdown(report: Report, improvement: string): string;

package/dist/report/markdown.js

@@ -0,0 +1,97 @@
+const KIND_SECTIONS = [
+    { kind: "drift", heading: "Drift — stated decisions & docs vs the code" },
+    { kind: "conflict", heading: "Library conflicts" },
+    { kind: "dup", heading: "Exact duplicates" },
+    { kind: "dup-near", heading: "Near duplicates" },
+];
+function scoreBadge(score) {
+    if (score >= 80)
+        return "🟢";
+    if (score >= 50)
+        return "🟡";
+    return "🔴";
+}
+/** Render the templated detail string as clean nested bullets. */
+function detailBullets(detail) {
+    if (!detail)
+        return [];
+    return detail
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .map((l) => `  - ${l}`);
+}
+function findingBlock(f) {
+    const lines = [];
+    const loc = f.location ? ` _(${f.location})_` : "";
+    lines.push(`- **${f.title}**${loc}`);
+    lines.push(...detailBullets(f.detail));
+    if (f.explanation)
+        lines.push(`  - 💡 ${f.explanation}`);
+    return lines.join("\n");
+}
+/**
+ * Deterministic, $0 "next steps" — derived from the score breakdown and finding
+ * counts. Used as the How-to-improve section when the LLM is off, and as a
+ * fallback when it's on.
+ */
+export function improvementSummary(report) {
+    const { breakdown, findings } = report;
+    const n = (k) => findings.filter((f) => f.kind === k).length;
+    const docDrift = findings.filter((f) => f.kind === "drift" && /references missing path/.test(f.title)).length;
+    const stackDrift = n("drift") - docDrift;
+    const items = [];
+    if (breakdown.duplication > 0) {
+        items.push({
+            penalty: breakdown.duplication,
+            text: `**Duplication (−${breakdown.duplication})** — ${n("dup")} exact + ${n("dup-near")} near-duplicate functions. Extract the shared logic into one utility and update the call sites; this is usually the biggest, safest win.`,
+        });
+    }
+    if (breakdown.drift > 0) {
+        const parts = [];
+        if (docDrift)
+            parts.push(`${docDrift} doc reference${docDrift === 1 ? "" : "s"} point at files that no longer exist — update or delete those links/paths`);
+        if (stackDrift)
+            parts.push(`${stackDrift} stated decision${stackDrift === 1 ? "" : "s"} contradict the code — align the docs or the code`);
+        items.push({ penalty: breakdown.drift, text: `**Drift (−${breakdown.drift})** — ${parts.join("; ")}.` });
+    }
+    if (breakdown.conflict > 0) {
+        items.push({
+            penalty: breakdown.conflict,
+            text: `**Library conflicts (−${breakdown.conflict})** — ${n("conflict")} capability area${n("conflict") === 1 ? " has" : "s have"} competing libraries. Standardize on one and migrate the rest (or suppress an intentional migration in \`.keelignore\`).`,
+        });
+    }
+    if (items.length === 0)
+        return "Nothing to fix — the score is already clean. 🎉";
+    items.sort((a, b) => b.penalty - a.penalty);
+    return ["Tackle the largest category first — each point back is one fewer inconsistency:", "", ...items.map((it) => `1. ${it.text}`)].join("\n");
+}
+/** Render a full, uncapped Markdown report. */
+export function renderMarkdown(report, improvement) {
+    const { score, breakdown, findings, stats } = report;
+    const out = [];
+    out.push(`# keel report`, "");
+    out.push(`## ${scoreBadge(score)} Coherence Score: ${score} / 100`, "");
+    out.push(`| Category | Findings | Penalty |`, `|---|---:|---:|`);
+    out.push(`| Drift (decisions & docs vs code) | ${findings.filter((f) => f.kind === "drift").length} | −${breakdown.drift} |`);
+    out.push(`| Library conflicts | ${findings.filter((f) => f.kind === "conflict").length} | −${breakdown.conflict} |`);
+    out.push(`| Duplication (exact + near) | ${findings.filter((f) => f.kind === "dup" || f.kind === "dup-near").length} | −${breakdown.duplication} |`);
+    out.push("", `\`scanned ${stats.filesScanned} files · ${stats.durationMs.toFixed(0)}ms · $${stats.costUsd.toFixed(2)}\``, "");
+    out.push(`## How to improve`, "", improvement, "");
+    out.push(`## Findings (${findings.length})`, "");
+    if (findings.length === 0) {
+        out.push("No issues found. 🎉", "");
+    }
+    for (const { kind, heading } of KIND_SECTIONS) {
+        const group = findings.filter((f) => f.kind === kind);
+        if (group.length === 0)
+            continue;
+        out.push(`### ${heading} (${group.length})`, "");
+        for (const f of group)
+            out.push(findingBlock(f));
+        out.push("");
+    }
+    out.push("---", "", "_Generated by keel · suppress a finding with `// keel-ignore`, a `.keelignore` file, or `keel.config.json`._", "");
+    return out.join("\n");
+}
+//# sourceMappingURL=markdown.js.map

package/dist/report/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/report/markdown.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAkD;IACnE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,6CAA6C,EAAE;IACzE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE;IAClD,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE;IAC5C,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE;CACjD,CAAC;AAEF,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,SAAS,aAAa,CAAC,MAA0B;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,CAAU;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,CAAc,EAAU,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAClF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9G,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAEzC,MAAM,KAAK,GAA6C,EAAE,CAAC;IAC3D,IAAI,SAAS,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,WAAW;YAC9B,IAAI,EAAE,mBAAmB,SAAS,CAAC,WAAW,SAAS,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,0IAA0I;SACnO,CAAC,CAAC;IACL,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,iBAAiB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,2EAA2E,CAAC,CAAC;QAC3J,IAAI,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,mBAAmB,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mDAAmD,CAAC,CAAC;QAC3I,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,SAAS,CAAC,KAAK,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,QAAQ;YAC3B,IAAI,EAAE,yBAAyB,SAAS,CAAC,QAAQ,SAAS,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,0HAA0H;SAC5P,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iDAAiD,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,iFAAiF,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,WAAmB;IAChE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACrD,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,qBAAqB,KAAK,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxE,GAAG,CAAC,IAAI,CAAC,mCAAmC,EAAE,iBAAiB,CAAC,CAAC;IACjE,GAAG,CAAC,IAAI,CAAC,wCAAwC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9H,GAAG,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAC;IACrH,GAAG,CAAC,IAAI,CACN,kCAAkC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,WAAW,IAAI,CAC3I,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,KAAK,CAAC,YAAY,YAAY,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE9H,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IAEnD,GAAG,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,aAAa,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,GAAG,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,8GAA8G,EAAE,EAAE,CAAC,CAAC;IACxI,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/report/text.d.ts

@@ -0,0 +1,11 @@
+import type { Finding, Report } from "../types.js";
+export declare function sortFindings(findings: Finding[]): Finding[];
+/** Default cap on findings printed in text mode; --json always shows all. */
+export declare const DEFAULT_FINDING_LIMIT = 25;
+export interface RenderOptions {
+    verbose?: boolean;
+    /** Max findings to print (the rest are summarized). 0/undefined uses the default. */
+    limit?: number;
+}
+/** Render a Report as the human-facing terminal output. */
+export declare function renderText(report: Report, opts?: RenderOptions): string;

package/dist/report/text.js

@@ -0,0 +1,76 @@
+import pc from "picocolors";
+function scoreColor(score) {
+    if (score >= 80)
+        return pc.green;
+    if (score >= 50)
+        return pc.yellow;
+    return pc.red;
+}
+const KIND_ORDER = ["drift", "conflict", "dup", "dup-near"];
+const KIND_LABEL = {
+    drift: "DRIFT",
+    conflict: "CONFLICT",
+    dup: "DUP",
+    "dup-near": "DUP~",
+};
+function marker(f) {
+    if (f.confidence === "high")
+        return pc.red("✗");
+    if (f.confidence === "medium")
+        return pc.yellow("!");
+    return pc.dim("~");
+}
+export function sortFindings(findings) {
+    return [...findings].sort((a, b) => KIND_ORDER.indexOf(a.kind) - KIND_ORDER.indexOf(b.kind) ||
+        b.penalty - a.penalty ||
+        a.title.localeCompare(b.title));
+}
+/** Default cap on findings printed in text mode; --json always shows all. */
+export const DEFAULT_FINDING_LIMIT = 25;
+/** Render a Report as the human-facing terminal output. */
+export function renderText(report, opts = {}) {
+    const { score, breakdown, findings, stats } = report;
+    const out = [];
+    const color = scoreColor(score);
+    out.push("");
+    out.push(`  ${pc.bold("Coherence Score:")} ${color(pc.bold(`${score} / 100`))}`);
+    out.push("");
+    const rows = [
+        ["Drift", breakdown.drift],
+        ["Library conflicts", breakdown.conflict],
+        ["Duplication", breakdown.duplication],
+    ];
+    for (const [label, penalty] of rows) {
+        if (penalty === 0)
+            continue;
+        out.push(`  ${pc.dim(label.padEnd(20))}${pc.red(`-${penalty}`)}`);
+    }
+    if (findings.length === 0) {
+        out.push(`  ${pc.green("No issues found.")}`);
+    }
+    else {
+        out.push("");
+        out.push(`  ${pc.bold("Findings")}`);
+        const limit = opts.limit && opts.limit > 0 ? opts.limit : DEFAULT_FINDING_LIMIT;
+        const sorted = sortFindings(findings);
+        for (const f of sorted.slice(0, limit)) {
+            out.push(`    ${marker(f)} ${pc.bold(KIND_LABEL[f.kind].padEnd(9))} ${f.title}`);
+            if (f.explanation) {
+                out.push(`              ${pc.cyan("›")} ${pc.dim(f.explanation)}`);
+            }
+            if (opts.verbose && f.detail) {
+                for (const line of f.detail.split("\n"))
+                    out.push(`              ${pc.dim(line)}`);
+            }
+        }
+        if (sorted.length > limit) {
+            out.push(`    ${pc.dim(`… and ${sorted.length - limit} more (use --json to see all, or --limit N)`)}`);
+        }
+    }
+    out.push("");
+    out.push(pc.dim(`  scanned ${stats.filesScanned} files · ${stats.durationMs.toFixed(1)}ms · ` +
+        `$${stats.costUsd.toFixed(2)}`));
+    out.push("");
+    return out.join("\n");
+}
+//# sourceMappingURL=text.js.map

package/dist/report/text.js.map

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

package/dist/suppress.d.ts

@@ -0,0 +1,22 @@
+/** Parsed `.keelignore` rules. */
+export interface Suppressions {
+    /** Capability buckets to never flag, e.g. "http". */
+    buckets: Set<string>;
+    /** Path matchers; a finding located in a matching file is dropped. */
+    paths: PathRule[];
+}
+interface PathRule {
+    raw: string;
+    test: (file: string) => boolean;
+}
+/** Lines (1-based) of a file's content that carry an inline keel-ignore marker. */
+export declare function ignoreLinesOf(content: string): number[];
+/** True if `text` (a single line) carries an inline keel-ignore marker. */
+export declare function lineHasIgnore(text: string | undefined): boolean;
+/** Load `.keelignore` from the repo root (absent file => no suppressions). */
+export declare function loadKeelignore(root: string): Suppressions;
+/** Extract the file portion of a "path:line" location string. */
+export declare function locationFile(location: string): string;
+/** True if a finding located in `file` is suppressed by a `.keelignore` path rule. */
+export declare function isPathSuppressed(supp: Suppressions, file: string): boolean;
+export {};

package/dist/suppress.js

@@ -0,0 +1,80 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** The marker keel looks for in inline comments to suppress a finding. */
+const MARKER = /keel-ignore/i;
+/** Lines (1-based) of a file's content that carry an inline keel-ignore marker. */
+export function ignoreLinesOf(content) {
+    const out = [];
+    const lines = content.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        if (MARKER.test(lines[i]))
+            out.push(i + 1);
+    }
+    return out;
+}
+/** True if `text` (a single line) carries an inline keel-ignore marker. */
+export function lineHasIgnore(text) {
+    return text !== undefined && MARKER.test(text);
+}
+const REGEX_SPECIAL = new Set([".", "+", "^", "$", "{", "}", "(", ")", "|", "[", "]", "\\"]);
+/** Compile a glob (`*` = within a path segment, `**` = across segments) to a RegExp. */
+function globToRegExp(glob) {
+    let re = "";
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === "*") {
+            if (glob[i + 1] === "*") {
+                re += ".*";
+                i += 1;
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if (REGEX_SPECIAL.has(c)) {
+            re += "\\" + c;
+        }
+        else {
+            re += c;
+        }
+    }
+    return new RegExp("^" + re + "$");
+}
+function makePathRule(raw) {
+    if (raw.includes("*")) {
+        const re = globToRegExp(raw);
+        return { raw, test: (file) => re.test(file) };
+    }
+    // No wildcard: treat as exact file or directory prefix.
+    const prefix = raw.endsWith("/") ? raw : raw + "/";
+    return { raw, test: (file) => file === raw || file.startsWith(prefix) };
+}
+/** Load `.keelignore` from the repo root (absent file => no suppressions). */
+export function loadKeelignore(root) {
+    const buckets = new Set();
+    const paths = [];
+    const path = join(root, ".keelignore");
+    if (!existsSync(path))
+        return { buckets, paths };
+    for (const line of readFileSync(path, "utf8").split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        if (trimmed.startsWith("bucket:")) {
+            buckets.add(trimmed.slice("bucket:".length).trim());
+        }
+        else {
+            paths.push(makePathRule(trimmed));
+        }
+    }
+    return { buckets, paths };
+}
+/** Extract the file portion of a "path:line" location string. */
+export function locationFile(location) {
+    return location.replace(/:\d+$/, "");
+}
+/** True if a finding located in `file` is suppressed by a `.keelignore` path rule. */
+export function isPathSuppressed(supp, file) {
+    return supp.paths.some((rule) => rule.test(file));
+}
+//# sourceMappingURL=suppress.js.map

package/dist/suppress.js.map

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