clud-bug 0.6.33 → 0.7.0-rc.1

package/dist/cli/usage.d.ts

@@ -0,0 +1,142 @@
+export interface ModelPricing {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+export declare const PRICING: Record<string, ModelPricing>;
+export interface TokenCounts {
+    input_tokens?: number | undefined;
+    output_tokens?: number | undefined;
+    cache_read_input_tokens?: number | undefined;
+    cache_creation_input_tokens?: number | undefined;
+}
+export interface CostParts {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+export interface ReviewCost {
+    total: number;
+    parts: CostParts;
+    model: string;
+    unknownModel: boolean;
+}
+/**
+ * Compute the USD cost of a single clud-bug review from token counts +
+ * model. All four token classes are billed independently.
+ */
+export declare function computeReviewCost(tokens: TokenCounts, model: string | null | undefined): ReviewCost;
+/**
+ * $/LOC for a single review. PR size denominator is additions + deletions
+ * — the same metric `gh pr view --json additions,deletions` returns.
+ *
+ * Returns 0 if additions + deletions === 0 (avoid div-by-zero on
+ * docs-only / empty PRs); callers can filter zero-LOC reviews out of
+ * trend lines as outliers.
+ */
+export declare function costPerLOC(cost: number, additions: number | null | undefined, deletions: number | null | undefined): number;
+/**
+ * Cache hit rate: cached_read / (cached_read + creation + input).
+ * Cached creation is the cost of WRITING new entries (paid 1.25× per
+ * Anthropic); cached read is what we get back at 10% of input price.
+ * High hit rate proves the v0.6.3 caching layer is firing on
+ * re-reviews and fix-pushes.
+ */
+export declare function cacheHitRate(tokens: TokenCounts): number;
+export interface ExtractedTokens {
+    model: string | null;
+    tokens: Required<TokenCounts> | null;
+    ok: boolean;
+}
+/**
+ * Parse the model + token counts from a clud-bug-review job log dump.
+ *
+ * PR #104 fix (token double-count): the SDK's stream-output emits a
+ * `"type": "result"` event at the end of a review with a CUMULATIVE
+ * `usage` block. It ALSO emits per-turn `"type": "assistant"` events
+ * (each with its own usage), AND the result event's usage contains an
+ * `iterations` array of per-message breakdowns. Naively summing every
+ * `"input_tokens"` occurrence in the log would triple-or-more count
+ * the same tokens.
+ *
+ * Right approach: locate the FINAL `"type": "result"` event and extract
+ * the FIRST `"usage": {`-block within it. That's the cumulative bill,
+ * the same number Anthropic charges. If no result event exists, the
+ * review didn't complete successfully — return ok:false so the caller
+ * skips this run rather than trusting partial token data.
+ */
+export declare function extractTokensFromLog(logText: unknown): ExtractedTokens;
+export interface ReviewRecord {
+    repo: string;
+    pr: number;
+    createdAt: string;
+    model: string;
+    tokens: TokenCounts;
+    additions: number;
+    deletions: number;
+    cost: number;
+    costPerLOC: number;
+    cacheRate: number;
+    unknownModel?: boolean | undefined;
+    modelObserved?: string | undefined;
+}
+export interface RollupGroupStats {
+    reviews: number;
+    cost: number;
+    loc: number;
+    costPerLOC: number;
+    cacheRate: number;
+}
+export interface RollupTotal {
+    reviews: number;
+    cost: number;
+    loc: number;
+    costPerLOC: number;
+    cacheRate: number;
+}
+export interface RollupTrend {
+    current: number;
+    previous: number | null;
+    slopePct: number | null;
+}
+export interface RollupOutlier {
+    repo: string;
+    pr: number;
+    costPerLOC: number;
+    multiple: number;
+    cost: number;
+    reason: string;
+}
+export interface UnknownModelReview {
+    repo: string;
+    pr: number;
+    modelObserved: string | undefined;
+}
+export interface Rollup {
+    total: RollupTotal;
+    perRepo: Record<string, RollupGroupStats>;
+    perModel: Record<string, RollupGroupStats>;
+    trend30d: RollupTrend;
+    outliers: RollupOutlier[];
+    unknownModelReviews: UnknownModelReview[];
+}
+/**
+ * Roll up an array of per-review records into a structured summary.
+ *
+ * Pre-conditions: callers should drop zero-LOC reviews before passing in.
+ */
+export declare function rollup(reviews: ReviewRecord[]): Rollup;
+export interface FormatRollupOptions {
+    json?: boolean | undefined;
+}
+/**
+ * Render the rollup as a human-readable table. Mirrors the sample output
+ * from the Phase 0.5 plan.
+ *
+ * Pass `{ json: true }` for the machine-readable form (the same data
+ * the rollup() function returns).
+ */
+export declare function formatRollup(rollup: Rollup, opts?: FormatRollupOptions): string;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/usage.d.ts.map

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

package/dist/cli/usage.js

@@ -0,0 +1,348 @@
+// src/cli/usage.ts — Q7-clud-bug $/LOC compute.
+//
+// Pure functions, no I/O. Driven from bin/clud-bug.js which fetches workflow
+// run JSON + PR metadata via gh CLI. Implementation of the 0.0.M.1 dashboard
+// per the Phase 0.5 plan.
+//
+// Reads:
+//   - clud-bug-review job logs (via `gh api .../jobs/<id>/logs`), which
+//     contain the SDK's `result` messages including:
+//       "model": "claude-sonnet-4-6"
+//       "input_tokens": N
+//       "output_tokens": N
+//       "cache_read_input_tokens": N
+//       "cache_creation_input_tokens": N
+//   - `gh pr view --json additions,deletions` for the LOC denominator.
+//
+// Computes:
+//   $/LOC = total_cost(tokens, model) / (additions + deletions)
+//
+// Q7-clud-bug enforcement: dashboard reports the 30-day rolling trend; the
+// next Phase 0.5 PR ships when the trend stops declining.
+// Anthropic pricing as of 2026-05 (per MTok). Cache write is 1.25× input
+// per Anthropic's published 5-min-TTL ephemeral cache rate.
+export const PRICING = {
+    'claude-sonnet-4-6': {
+        input: 3.0, output: 15.0, cacheRead: 0.30, cacheWrite: 3.75,
+    },
+    'claude-haiku-4-5-20251001': {
+        input: 0.80, output: 4.0, cacheRead: 0.08, cacheWrite: 1.0,
+    },
+    'claude-opus-4-7': {
+        input: 15.0, output: 75.0, cacheRead: 1.50, cacheWrite: 18.75,
+    },
+};
+// Fallback when the model field is missing or new. Use Sonnet pricing —
+// conservative for unknown-but-likely-Sonnet, undercounts Opus until we
+// update the table. The `unknown` flag in the result lets callers warn.
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+/**
+ * Compute the USD cost of a single clud-bug review from token counts +
+ * model. All four token classes are billed independently.
+ */
+export function computeReviewCost(tokens, model) {
+    const t = {
+        input: tokens.input_tokens || 0,
+        output: tokens.output_tokens || 0,
+        cacheRead: tokens.cache_read_input_tokens || 0,
+        cacheWrite: tokens.cache_creation_input_tokens || 0,
+    };
+    const normalized = model && PRICING[model] ? model : DEFAULT_MODEL;
+    // PRICING[normalized] is guaranteed to exist (normalized is either a
+    // known key or DEFAULT_MODEL which is defined above). Non-null assert
+    // to satisfy noUncheckedIndexedAccess.
+    const p = PRICING[normalized];
+    const parts = {
+        input: (t.input / 1e6) * p.input,
+        output: (t.output / 1e6) * p.output,
+        cacheRead: (t.cacheRead / 1e6) * p.cacheRead,
+        cacheWrite: (t.cacheWrite / 1e6) * p.cacheWrite,
+    };
+    const total = parts.input + parts.output + parts.cacheRead + parts.cacheWrite;
+    return {
+        total,
+        parts,
+        model: normalized,
+        unknownModel: !(model && PRICING[model]),
+    };
+}
+/**
+ * $/LOC for a single review. PR size denominator is additions + deletions
+ * — the same metric `gh pr view --json additions,deletions` returns.
+ *
+ * Returns 0 if additions + deletions === 0 (avoid div-by-zero on
+ * docs-only / empty PRs); callers can filter zero-LOC reviews out of
+ * trend lines as outliers.
+ */
+export function costPerLOC(cost, additions, deletions) {
+    const loc = (additions || 0) + (deletions || 0);
+    if (loc === 0)
+        return 0;
+    return cost / loc;
+}
+/**
+ * Cache hit rate: cached_read / (cached_read + creation + input).
+ * Cached creation is the cost of WRITING new entries (paid 1.25× per
+ * Anthropic); cached read is what we get back at 10% of input price.
+ * High hit rate proves the v0.6.3 caching layer is firing on
+ * re-reviews and fix-pushes.
+ */
+export function cacheHitRate(tokens) {
+    const read = tokens.cache_read_input_tokens || 0;
+    const write = tokens.cache_creation_input_tokens || 0;
+    const input = tokens.input_tokens || 0;
+    const denom = read + write + input;
+    if (denom === 0)
+        return 0;
+    return read / denom;
+}
+/**
+ * Parse the model + token counts from a clud-bug-review job log dump.
+ *
+ * PR #104 fix (token double-count): the SDK's stream-output emits a
+ * `"type": "result"` event at the end of a review with a CUMULATIVE
+ * `usage` block. It ALSO emits per-turn `"type": "assistant"` events
+ * (each with its own usage), AND the result event's usage contains an
+ * `iterations` array of per-message breakdowns. Naively summing every
+ * `"input_tokens"` occurrence in the log would triple-or-more count
+ * the same tokens.
+ *
+ * Right approach: locate the FINAL `"type": "result"` event and extract
+ * the FIRST `"usage": {`-block within it. That's the cumulative bill,
+ * the same number Anthropic charges. If no result event exists, the
+ * review didn't complete successfully — return ok:false so the caller
+ * skips this run rather than trusting partial token data.
+ */
+export function extractTokensFromLog(logText) {
+    if (typeof logText !== 'string' || logText.length === 0) {
+        return { model: null, tokens: null, ok: false };
+    }
+    // The LAST model field — final message wins (a multi-turn review
+    // uses the same model throughout). Captured before the usage parse
+    // so model is reported even when we can't find a result event.
+    const modelMatches = [...logText.matchAll(/"model"\s*:\s*"([^"]+)"/g)];
+    // matchAll yields RegExpMatchArray entries; capture group 1 is the
+    // model string. Under noUncheckedIndexedAccess every index is typed
+    // possibly-undefined — coalesce so the return type stays string|null.
+    const model = modelMatches.length > 0
+        ? (modelMatches[modelMatches.length - 1]?.[1] ?? null)
+        : null;
+    // Locate the final result event. There may be multiple over the
+    // life of a long-running session — take the LAST one.
+    const resultMarkerRe = /"type"\s*:\s*"result"/g;
+    let lastResultIdx = -1;
+    let m;
+    while ((m = resultMarkerRe.exec(logText)) !== null) {
+        lastResultIdx = m.index;
+    }
+    if (lastResultIdx < 0) {
+        // No result event — partial log or job that errored before
+        // emitting one. Don't sum the per-turn fields; the data isn't
+        // billable-equivalent.
+        return { model, tokens: null, ok: false };
+    }
+    // Within the result event, find the first `"usage": {` and extract
+    // its top-level token fields. We scope each field's regex to a window
+    // starting at the usage block so we don't pick up the `iterations`
+    // array's per-message fields (which are nested deeper but still
+    // appear within the same overall result block).
+    const fromResult = logText.slice(lastResultIdx);
+    const usageIdx = fromResult.search(/"usage"\s*:\s*\{/);
+    if (usageIdx < 0) {
+        return { model, tokens: null, ok: false };
+    }
+    // Slice up to the start of `"iterations"` (if present) so we don't
+    // double-count per-iteration breakdowns nested inside usage.
+    const fromUsage = fromResult.slice(usageIdx);
+    const iterationsIdx = fromUsage.search(/"iterations"\s*:/);
+    const usageOnly = iterationsIdx >= 0
+        ? fromUsage.slice(0, iterationsIdx)
+        : fromUsage;
+    const pluck = (re) => {
+        const match = usageOnly.match(re);
+        return match && match[1] !== undefined ? Number(match[1]) : 0;
+    };
+    const input = pluck(/"input_tokens"\s*:\s*(\d+)/);
+    const output = pluck(/"output_tokens"\s*:\s*(\d+)/);
+    const cacheRead = pluck(/"cache_read_input_tokens"\s*:\s*(\d+)/);
+    const cacheWrite = pluck(/"cache_creation_input_tokens"\s*:\s*(\d+)/);
+    const anyTokens = input + output + cacheRead + cacheWrite;
+    if (anyTokens === 0) {
+        return { model, tokens: null, ok: false };
+    }
+    return {
+        model,
+        tokens: {
+            input_tokens: input,
+            output_tokens: output,
+            cache_read_input_tokens: cacheRead,
+            cache_creation_input_tokens: cacheWrite,
+        },
+        ok: true,
+    };
+}
+/**
+ * Roll up an array of per-review records into a structured summary.
+ *
+ * Pre-conditions: callers should drop zero-LOC reviews before passing in.
+ */
+export function rollup(reviews) {
+    const valid = reviews.filter((r) => r.costPerLOC > 0);
+    const total = {
+        reviews: valid.length,
+        cost: valid.reduce((a, r) => a + r.cost, 0),
+        loc: valid.reduce((a, r) => a + (r.additions + r.deletions), 0),
+        costPerLOC: median(valid.map((r) => r.costPerLOC)),
+        cacheRate: median(valid.map((r) => r.cacheRate)),
+    };
+    const groupBy = (key) => {
+        const out = {};
+        for (const r of valid) {
+            const k = String(r[key]);
+            let bucket = out[k];
+            if (!bucket) {
+                bucket = { reviews: 0, cost: 0, loc: 0, costPerLOCs: [], cacheRates: [] };
+                out[k] = bucket;
+            }
+            bucket.reviews += 1;
+            bucket.cost += r.cost;
+            bucket.loc += r.additions + r.deletions;
+            bucket.costPerLOCs.push(r.costPerLOC);
+            bucket.cacheRates.push(r.cacheRate);
+        }
+        const finalized = {};
+        for (const k of Object.keys(out)) {
+            const bucket = out[k];
+            finalized[k] = {
+                reviews: bucket.reviews,
+                cost: bucket.cost,
+                loc: bucket.loc,
+                costPerLOC: median(bucket.costPerLOCs),
+                cacheRate: median(bucket.cacheRates),
+            };
+        }
+        return finalized;
+    };
+    const perRepo = groupBy('repo');
+    const perModel = groupBy('model');
+    // Outliers: > 2× total.costPerLOC.
+    const outliers = valid
+        .filter((r) => r.costPerLOC > total.costPerLOC * 2)
+        .map((r) => ({
+        repo: r.repo,
+        pr: r.pr,
+        costPerLOC: r.costPerLOC,
+        multiple: r.costPerLOC / total.costPerLOC,
+        cost: r.cost,
+        reason: r.cacheRate < 0.3 ? 'low cache hit' : 'unknown',
+    }));
+    // 30-day trend: median $/LOC per calendar day. Bucket by createdAt date.
+    // Slope reported as MoM % change between the most recent 30-day window's
+    // median and the previous 30-day window's median.
+    const trend30d = computeTrend(valid);
+    // PR #104 fix: surface reviews whose model wasn't in PRICING. The
+    // computeReviewCost fallback applied Sonnet rates to unknown models
+    // (~5× undercount of Opus), AND bucketed them under Sonnet in the
+    // per-model table — exactly the false-good signal Q7 must NOT produce.
+    // Caller renders this as a loud warning so the dashboard reader knows
+    // to update the PRICING table.
+    const unknownModelReviews = valid
+        .filter((r) => r.unknownModel === true)
+        .map((r) => ({ repo: r.repo, pr: r.pr, modelObserved: r.modelObserved }));
+    return { total, perRepo, perModel, trend30d, outliers, unknownModelReviews };
+}
+function median(nums) {
+    if (nums.length === 0)
+        return 0;
+    const sorted = [...nums].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    // sorted is non-empty here so sorted[mid] is defined; the `!`
+    // satisfies noUncheckedIndexedAccess and matches JS semantics.
+    return sorted.length % 2 === 0
+        ? (sorted[mid - 1] + sorted[mid]) / 2
+        : sorted[mid];
+}
+function computeTrend(reviews) {
+    // PR #104 fix: distinguish "no prior window" (previous bucket empty)
+    // from "exactly flat trend" (current === previous > 0). The original
+    // code returned slopePct=0 for both, which masked the dangerous case
+    // — a stable expensive month-over-month trend rendered as if there
+    // were no comparison data, hiding the very signal Q7 enforces.
+    // `previous: null` now means "no prior window"; renderer keys on this.
+    if (reviews.length === 0) {
+        return { current: 0, previous: null, slopePct: null };
+    }
+    const now = Date.now();
+    const day = 24 * 60 * 60 * 1000;
+    const currentWindow = reviews.filter((r) => now - new Date(r.createdAt).getTime() <= 30 * day);
+    const previousWindow = reviews.filter((r) => {
+        const age = now - new Date(r.createdAt).getTime();
+        return age > 30 * day && age <= 60 * day;
+    });
+    const current = median(currentWindow.map((r) => r.costPerLOC));
+    if (previousWindow.length === 0) {
+        return { current, previous: null, slopePct: null };
+    }
+    const previous = median(previousWindow.map((r) => r.costPerLOC));
+    // previous > 0 because every review in valid[] has costPerLOC > 0
+    // (zero-LOC reviews dropped upstream).
+    const slopePct = previous > 0 ? ((current - previous) / previous) * 100 : null;
+    return { current, previous, slopePct };
+}
+/**
+ * Render the rollup as a human-readable table. Mirrors the sample output
+ * from the Phase 0.5 plan.
+ *
+ * Pass `{ json: true }` for the machine-readable form (the same data
+ * the rollup() function returns).
+ */
+export function formatRollup(rollup, opts = {}) {
+    if (opts.json) {
+        return JSON.stringify(rollup, null, 2);
+    }
+    const lines = [];
+    const t = rollup.total;
+    const trend = rollup.trend30d;
+    // PR #104 fix: null slopePct = "no prior window" (prior 30d bucket
+    // was empty). A REAL 0% slope (flat trend) renders as "→ 0% MoM",
+    // not as "(no prior window)" — masking the latter was the bug.
+    let trendStr;
+    if (trend.slopePct === null) {
+        trendStr = '(no prior window)';
+    }
+    else {
+        const trendArrow = trend.slopePct < 0 ? '↓' : trend.slopePct > 0 ? '↑' : '→';
+        trendStr = `${trendArrow} ${trend.slopePct.toFixed(0)}% MoM`;
+    }
+    lines.push(`ok: ${t.reviews} reviews, 30-day $/LOC trend: ${trendStr}`);
+    const perRepoEntries = Object.entries(rollup.perRepo)
+        .sort((a, b) => b[1].costPerLOC - a[1].costPerLOC);
+    if (perRepoEntries.length > 0) {
+        lines.push('  per-repo $/LOC (most → least expensive):');
+        for (const [repo, stats] of perRepoEntries) {
+            const cache = `${(stats.cacheRate * 100).toFixed(0)}% cached`;
+            lines.push(`    ${repo.padEnd(28)} ${`$${stats.costPerLOC.toFixed(4)}/LOC`.padEnd(16)} · ${String(stats.reviews).padStart(2)} reviews · ${cache}`);
+        }
+    }
+    lines.push(`  org median $/LOC: $${t.costPerLOC.toFixed(4)} · org cache hit: ${(t.cacheRate * 100).toFixed(0)}%`);
+    lines.push(`  total spend: $${t.cost.toFixed(2)} across ${(t.loc).toLocaleString()} LOC`);
+    if (rollup.outliers.length > 0) {
+        lines.push(`  outliers (>2× median):`);
+        for (const o of rollup.outliers) {
+            lines.push(`    ${o.repo}#${o.pr} ($${o.costPerLOC.toFixed(4)}/LOC, ${o.multiple.toFixed(1)}× median — ${o.reason})`);
+        }
+    }
+    // PR #104 fix: loud warning when one or more reviews used a model
+    // not in PRICING (we fell back to Sonnet rates — that can undercount
+    // by ~5× if the real model was an Opus variant). Update PRICING and
+    // re-run.
+    if (rollup.unknownModelReviews && rollup.unknownModelReviews.length > 0) {
+        lines.push(`  ⚠️  ${rollup.unknownModelReviews.length} review${rollup.unknownModelReviews.length === 1 ? '' : 's'} used model${rollup.unknownModelReviews.length === 1 ? '' : 's'} not in PRICING; cost may be undercounted:`);
+        const observed = new Set(rollup.unknownModelReviews.map((u) => u.modelObserved));
+        for (const m of observed) {
+            lines.push(`    seen: "${m}" — add to lib/usage.js PRICING table`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

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

package/dist/core/audit.d.ts

@@ -0,0 +1,8 @@
+export declare function durationToGitSince(input: string | null | undefined): string | null;
+export interface AuditHeaderInput {
+    date: string;
+    scopeLabel: string;
+    files: string[];
+}
+export declare function renderAuditHeader({ date, scopeLabel, files }: AuditHeaderInput): string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/core/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"AAUA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAWlF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAqBvF"}

package/dist/core/audit.js

@@ -0,0 +1,47 @@
+// Pure audit helpers — no FS, no git, no child_process.
+//
+// Split from lib/audit.js during the v0.7.0 TS migration: durationToGitSince
+// and renderAuditHeader are pure functions safe to consume from any runtime
+// (e.g. clud-bug-app's serverless review path), so they live in src/core/.
+// The git-spawning siblings (gitLines, computeAuditFileSet) live in
+// src/cli/audit.ts.
+// Convert a duration like "7d", "2w", "1mo", "3mo", "1y" to a git --since arg.
+// Returns null if the input is empty/undefined; throws on malformed input.
+export function durationToGitSince(input) {
+    if (!input)
+        return null;
+    const m = String(input).trim().match(/^(\d+)\s*(d|w|mo|m|y)$/i);
+    if (!m) {
+        throw new Error(`Unrecognized duration "${input}". Examples: 7d, 2w, 1mo, 1y.`);
+    }
+    // Capture group 1 (\d+) is always present when m is truthy; same for group 2.
+    const n = Number(m[1]);
+    const unit = m[2].toLowerCase();
+    const map = { d: 'day', w: 'week', mo: 'month', m: 'month', y: 'year' };
+    return `${n} ${map[unit]}${n === 1 ? '' : 's'} ago`;
+}
+// Render the audit report's initial markdown body. The Action's Claude run
+// will append findings under a "## Findings" section after this header.
+export function renderAuditHeader({ date, scopeLabel, files }) {
+    const head = `# 🐛 Clud Bug audit — ${date}
+
+A scheduled walk through the habitat. Scope: ${scopeLabel}.
+Files surveyed: **${files.length}**.
+
+<details>
+<summary>File manifest (${files.length})</summary>
+
+\`\`\`
+${files.join('\n')}
+\`\`\`
+
+</details>
+
+---
+
+## Findings
+
+`;
+    return head;
+}
+//# sourceMappingURL=audit.js.map

package/dist/core/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,oEAAoE;AACpE,oBAAoB;AAEpB,+EAA+E;AAC/E,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,+BAA+B,CAAC,CAAC;IAClF,CAAC;IACD,8EAA8E;IAC9E,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAI,CAAC,CAAC,CAAC,CAAY,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,GAAG,GAA2B,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAChG,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AACtD,CAAC;AAQD,2EAA2E;AAC3E,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAoB;IAC7E,MAAM,IAAI,GAAG,yBAAyB,IAAI;;+CAEG,UAAU;oBACrC,KAAK,CAAC,MAAM;;;0BAGN,KAAK,CAAC,MAAM;;;EAGpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;CASjB,CAAC;IACA,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/detect.d.ts

@@ -0,0 +1,77 @@
+export declare const EXT_TO_LANG: {
+    readonly '.ts': "typescript";
+    readonly '.tsx': "typescript";
+    readonly '.js': "javascript";
+    readonly '.jsx': "javascript";
+    readonly '.mjs': "javascript";
+    readonly '.cjs': "javascript";
+    readonly '.py': "python";
+    readonly '.go': "go";
+    readonly '.rs': "rust";
+    readonly '.rb': "ruby";
+    readonly '.java': "java";
+    readonly '.kt': "kotlin";
+    readonly '.swift': "swift";
+    readonly '.php': "php";
+    readonly '.cs': "csharp";
+    readonly '.c': "c";
+    readonly '.h': "c";
+    readonly '.cpp': "cpp";
+    readonly '.cc': "cpp";
+    readonly '.hpp': "cpp";
+};
+export declare const DEP_TO_TERM: {
+    readonly next: "nextjs";
+    readonly react: "react";
+    readonly vue: "vue";
+    readonly svelte: "svelte";
+    readonly '@angular/core': "angular";
+    readonly 'solid-js': "solid";
+    readonly express: "express";
+    readonly fastify: "fastify";
+    readonly koa: "koa";
+    readonly hono: "hono";
+    readonly prisma: "prisma";
+    readonly '@prisma/client': "prisma";
+    readonly 'drizzle-orm': "drizzle";
+    readonly mongoose: "mongodb";
+    readonly mongodb: "mongodb";
+    readonly tailwindcss: "tailwind";
+    readonly vitest: "vitest";
+    readonly jest: "jest";
+    readonly playwright: "playwright";
+    readonly '@playwright/test': "playwright";
+    readonly typescript: "typescript";
+};
+export declare const PY_DEP_TO_TERM: {
+    readonly django: "django";
+    readonly flask: "flask";
+    readonly fastapi: "fastapi";
+    readonly click: "click";
+    readonly typer: "typer";
+    readonly pytest: "pytest";
+    readonly sqlalchemy: "sqlalchemy";
+    readonly pydantic: "pydantic";
+    readonly numpy: "numpy";
+    readonly pandas: "pandas";
+};
+export interface DetectedSignals {
+    name: string | null;
+    description: string | null;
+    languages: string[];
+    histogram: Record<string, number>;
+    searchTerms: string[];
+    primaryLanguage: string | null;
+}
+declare function fileHistogram(root: string): Promise<Record<string, number>>;
+declare function firstParagraph(readme: string | null): string | null;
+export declare function detect(root: string): Promise<DetectedSignals>;
+export interface DescriptionLineSignals {
+    name?: string | null;
+    description?: string | null;
+    primaryLanguage?: string | null;
+    searchTerms?: string[];
+}
+export declare function buildDescriptionLine(signals: DescriptionLineSignals): string;
+export { fileHistogram, firstParagraph };
+//# sourceMappingURL=detect.d.ts.map

package/dist/core/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/core/detect.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;CAamB,CAAC;AAK5C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;CAUmB,CAAC;AAE5C,eAAO,MAAM,cAAc;;;;;;;;;;;CAKgB,CAAC;AAK5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AA2HD,iBAAe,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqB1E;AAED,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAS5D;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAoCnE;AAKD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAuB5E;AASD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC"}