trimference 0.3.0

package/dist/config.js.map

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

package/dist/ecoLLM.d.ts

@@ -0,0 +1,33 @@
+import { type Provider } from "./models.js";
+export type EcoLLMTaskType = "classification" | "extraction" | "generation" | "reasoning" | "embedding";
+export type EcoLLMInputSize = "small" | "medium" | "large";
+export type EcoLLMInput = {
+    taskType: EcoLLMTaskType;
+    inputSize: EcoLLMInputSize;
+    latencySensitive?: boolean;
+    trimMode?: boolean;
+    /** @deprecated Use trimMode. */
+    ecoMode?: boolean;
+    provider?: Provider;
+};
+export type EcoLLMRecommendation = {
+    recommendedModelTier: "small" | "medium" | "large";
+    shouldCache: boolean;
+    maxTokenRecommendation: number;
+    notes: string[];
+    /** Example model names for the recommended tier, when a provider is given. */
+    suggestedModels?: string[];
+};
+export type TrimInferenceTaskType = EcoLLMTaskType;
+export type TrimInferenceInputSize = EcoLLMInputSize;
+export type TrimInferenceInput = EcoLLMInput;
+export type TrimInferenceRecommendation = EcoLLMRecommendation;
+/**
+ * A local, offline advisor. It makes NO network calls and holds no provider
+ * secrets — it just maps a task shape to a directional recommendation.
+ * @deprecated Use trimInference.
+ */
+export declare function ecoLLM(input: EcoLLMInput): EcoLLMRecommendation;
+/** Preferred Trimference name for the local model-tier advisor. */
+export declare function trimInference(input: TrimInferenceInput): TrimInferenceRecommendation;
+//# sourceMappingURL=ecoLLM.d.ts.map

package/dist/ecoLLM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecoLLM.d.ts","sourceRoot":"","sources":["../src/ecoLLM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,oBAAoB,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AACnD,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC7C,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAW/D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,oBAAoB,CAgH/D;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,GACxB,2BAA2B,CAE7B"}

package/dist/ecoLLM.js

@@ -0,0 +1,98 @@
+import { MODEL_MAP } from "./models.js";
+const TIER_ORDER = ["small", "medium", "large"];
+function downshift(tier) {
+    const i = TIER_ORDER.indexOf(tier);
+    return TIER_ORDER[Math.max(0, i - 1)];
+}
+/**
+ * A local, offline advisor. It makes NO network calls and holds no provider
+ * secrets — it just maps a task shape to a directional recommendation.
+ * @deprecated Use trimInference.
+ */
+export function ecoLLM(input) {
+    const { taskType, inputSize, latencySensitive = false, ecoMode = false, trimMode = ecoMode, provider = "unknown", } = input;
+    const notes = [];
+    let tier;
+    let shouldCache = false;
+    let maxTokenRecommendation;
+    switch (taskType) {
+        case "classification":
+        case "extraction": {
+            // Structured tasks rarely need a top-tier model.
+            tier = inputSize === "large" ? "medium" : "small";
+            shouldCache = true;
+            maxTokenRecommendation = 256;
+            notes.push(`${taskType} is usually well served by a small or medium model tier.`);
+            notes.push("Cache results for repeated or deterministic inputs to avoid re-running inference.");
+            break;
+        }
+        case "reasoning": {
+            // Reasoning scales with input; large input warrants the large tier.
+            tier = inputSize === "large" ? "large" : "medium";
+            shouldCache = false;
+            maxTokenRecommendation = inputSize === "large" ? 2048 : 1024;
+            notes.push("Reasoning tasks benefit from more capable tiers, especially with large inputs.");
+            notes.push("Break multi-step reasoning into cacheable sub-steps where possible.");
+            break;
+        }
+        case "generation": {
+            tier = "medium";
+            shouldCache = true;
+            maxTokenRecommendation = 1024;
+            notes.push("Set an output token cap that matches the expected response length.");
+            notes.push("Cache deterministic or templated generations.");
+            break;
+        }
+        case "embedding": {
+            tier = "small";
+            shouldCache = true;
+            maxTokenRecommendation = 0; // embeddings do not produce output tokens
+            notes.push("Embeddings should be persisted; check for an existing vector before re-embedding unchanged text.");
+            notes.push("Batch embedding requests to reduce per-call overhead.");
+            break;
+        }
+        default: {
+            // Exhaustiveness guard.
+            const _never = taskType;
+            throw new Error(`Unknown task type: ${String(_never)}`);
+        }
+    }
+    if (latencySensitive) {
+        const before = tier;
+        tier = downshift(tier);
+        if (tier !== before) {
+            notes.push("Latency-sensitive: preferring a smaller/faster tier to reduce response time.");
+        }
+        else {
+            notes.push("Latency-sensitive: consider streaming and a tight token cap.");
+        }
+    }
+    if (trimMode) {
+        const before = tier;
+        tier = downshift(tier);
+        shouldCache = true;
+        if (tier !== before) {
+            notes.push("Trim mode: chose a smaller model tier to reduce compute and cost.");
+        }
+        else {
+            notes.push("Trim mode: already at the smallest sensible tier; caching is enabled.");
+        }
+    }
+    let suggestedModels;
+    if (provider !== "unknown") {
+        suggestedModels = MODEL_MAP[provider][tier];
+        notes.push(`${provider} models at the ${tier} tier include: ${suggestedModels.join(", ")} (examples, verify quality).`);
+    }
+    return {
+        recommendedModelTier: tier,
+        shouldCache,
+        maxTokenRecommendation,
+        notes,
+        ...(suggestedModels ? { suggestedModels } : {}),
+    };
+}
+/** Preferred Trimference name for the local model-tier advisor. */
+export function trimInference(input) {
+    return ecoLLM(input);
+}
+//# sourceMappingURL=ecoLLM.js.map

package/dist/ecoLLM.js.map

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

package/dist/impact.d.ts

@@ -0,0 +1,22 @@
+import type { Finding, ImpactEstimate, Level, Severity } from "./types.js";
+/**
+ * A human-review-style "Suggested first pass": 2–4 plain-English actions
+ * derived from the highest-impact findings, deduplicated and impact-ordered.
+ * Expects findings already sorted by severity then impact score.
+ */
+export declare function suggestedFirstPass(findings: Finding[], limit?: number): string[];
+export declare const SEVERITY_WEIGHT: Record<Severity, number>;
+/** Clamp a raw score into the documented 1..100 range. */
+export declare function clampScore(score: number): number;
+/** Build an ImpactEstimate, clamping the score defensively. */
+export declare function makeImpact(estimate: ImpactEstimate): ImpactEstimate;
+/**
+ * @deprecated Carbon and water levels are not measurements and are omitted
+ * from current reports. Use operationalImpactLine instead.
+ */
+export declare function impactLine(impact: ImpactEstimate): string;
+/** Human-facing operational signal; deliberately excludes carbon/water claims. */
+export declare function operationalImpactLine(impact: ImpactEstimate): string;
+export declare function levelWeight(level: Level): number;
+export declare const IMPACT_DISCLAIMER: string;
+//# sourceMappingURL=impact.d.ts.map

package/dist/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../src/impact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAwB3E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAW3E;AAQD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAIpD,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAEnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAOzD;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAMpE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEhD;AAED,eAAO,MAAM,iBAAiB,QAE0C,CAAC"}

package/dist/impact.js

@@ -0,0 +1,80 @@
+/**
+ * Trimference produces DIRECTIONAL impact estimates, not measured emissions.
+ * These helpers keep impact wording and math in one place.
+ */
+/** Plain-English "first pass" action per rule, for the review-summary section. */
+const RULE_ACTION = {
+    "no-llm-cache": "Add caching around repeated model calls.",
+    "repeated-embeddings": "Persist embeddings instead of regenerating unchanged text.",
+    "huge-context": "Limit prompt context with summarization or retrieval.",
+    "image-generation-loop": "Cap and cache repeated image generation.",
+    "no-token-limit": "Add output token limits to model calls.",
+    "frequent-cron": "Reduce frequent background polling with backoff or event-driven triggers.",
+    "expensive-model-simple-task": "Use smaller model tiers for simple classification or extraction tasks.",
+    "sequential-llm-calls": "Combine, cache, or parallelize multi-call LLM flows.",
+    "agent-loop-without-budget": "Add step, time, and token/cost budgets to agent loops.",
+    "missing-rate-limit": "Add rate limits or quotas to public AI routes.",
+};
+/**
+ * A human-review-style "Suggested first pass": 2–4 plain-English actions
+ * derived from the highest-impact findings, deduplicated and impact-ordered.
+ * Expects findings already sorted by severity then impact score.
+ */
+export function suggestedFirstPass(findings, limit = 4) {
+    const seen = new Set();
+    const actions = [];
+    for (const f of findings) {
+        const action = RULE_ACTION[f.ruleId];
+        if (!action || seen.has(action))
+            continue;
+        seen.add(action);
+        actions.push(action);
+        if (actions.length >= limit)
+            break;
+    }
+    return actions;
+}
+const LEVEL_WEIGHT = {
+    low: 1,
+    medium: 2,
+    high: 3,
+};
+export const SEVERITY_WEIGHT = {
+    low: 1,
+    medium: 2,
+    high: 3,
+};
+/** Clamp a raw score into the documented 1..100 range. */
+export function clampScore(score) {
+    return Math.max(1, Math.min(100, Math.round(score)));
+}
+/** Build an ImpactEstimate, clamping the score defensively. */
+export function makeImpact(estimate) {
+    return { ...estimate, score: clampScore(estimate.score) };
+}
+/**
+ * @deprecated Carbon and water levels are not measurements and are omitted
+ * from current reports. Use operationalImpactLine instead.
+ */
+export function impactLine(impact) {
+    return [
+        `compute ${impact.computeWaste}`,
+        `carbon ${impact.carbonImpact}`,
+        `water ${impact.waterImpact}`,
+        `cost ${impact.costImpact}`,
+    ].join(" · ");
+}
+/** Human-facing operational signal; deliberately excludes carbon/water claims. */
+export function operationalImpactLine(impact) {
+    return [
+        `compute risk ${impact.computeWaste}`,
+        `cost risk ${impact.costImpact}`,
+        `confidence ${impact.confidence}`,
+    ].join(" · ");
+}
+export function levelWeight(level) {
+    return LEVEL_WEIGHT[level];
+}
+export const IMPACT_DISCLAIMER = "Trimference uses static heuristics. Findings are review prompts, not measured " +
+    "usage, cost, emissions, water consumption, or infrastructure energy.";
+//# sourceMappingURL=impact.js.map

package/dist/impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../src/impact.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,kFAAkF;AAClF,MAAM,WAAW,GAA2B;IAC1C,cAAc,EAAE,0CAA0C;IAC1D,qBAAqB,EAAE,4DAA4D;IACnF,cAAc,EAAE,uDAAuD;IACvE,uBAAuB,EAAE,0CAA0C;IACnE,gBAAgB,EAAE,yCAAyC;IAC3D,eAAe,EACb,2EAA2E;IAC7E,6BAA6B,EAC3B,wEAAwE;IAC1E,sBAAsB,EAAE,sDAAsD;IAC9E,2BAA2B,EACzB,wDAAwD;IAC1D,oBAAoB,EAAE,gDAAgD;CACvE,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAmB,EAAE,KAAK,GAAG,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,YAAY,GAA0B;IAC1C,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,QAAwB;IACjD,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,OAAO;QACL,WAAW,MAAM,CAAC,YAAY,EAAE;QAChC,UAAU,MAAM,CAAC,YAAY,EAAE;QAC/B,SAAS,MAAM,CAAC,WAAW,EAAE;QAC7B,QAAQ,MAAM,CAAC,UAAU,EAAE;KAC5B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO;QACL,gBAAgB,MAAM,CAAC,YAAY,EAAE;QACrC,aAAa,MAAM,CAAC,UAAU,EAAE;QAChC,cAAc,MAAM,CAAC,UAAU,EAAE;KAClC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAC5B,gFAAgF;IAChF,sEAAsE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { Finding, ImpactEstimate, Rule, ScanOptions, ScanResult, ScanSummary, Severity, Level, SourceFile, WasteCategory, } from "./types.js";
+export { WASTE_CATEGORY_LABEL } from "./types.js";
+export { scan, runRules, discoverFiles, sortFindings, findingFingerprint, } from "./scanner.js";
+export { BASELINE_VERSION, readBaseline, writeBaseline, type TrimferenceBaseline, type EcoLintBaseline, } from "./baseline.js";
+export { rules } from "./rules/index.js";
+export { trimInference, ecoLLM, type TrimInferenceInput, type TrimInferenceRecommendation, type TrimInferenceTaskType, type TrimInferenceInputSize, type EcoLLMInput, type EcoLLMRecommendation, type EcoLLMTaskType, type EcoLLMInputSize, } from "./ecoLLM.js";
+export { renderTerminalReport } from "./reporters/terminalReporter.js";
+export { renderJsonReport } from "./reporters/jsonReporter.js";
+export { renderSarifReport } from "./reporters/sarifReporter.js";
+export { renderMarkdownReport } from "./reporters/markdownReporter.js";
+export { TRIMFERENCE_COMMENT_MARKER, ECOLINT_COMMENT_MARKER, MAX_COMMENT_LENGTH, buildCommentBody, type CommentBodyOptions, } from "./prComment.js";
+export { IMPACT_DISCLAIMER, impactLine, operationalImpactLine, makeImpact, } from "./impact.js";
+export { DEFAULT_CONFIG, SCANNABLE_EXTENSIONS, CONFIG_FILENAME, LEGACY_CONFIG_FILENAME, loadConfig, type TrimferenceFileConfig, type EcoLintFileConfig, } from "./config.js";
+export { MODEL_MAP, detectProvider, classifyModelTier, suggestSmallerModels, type Provider, type ModelTier, } from "./models.js";
+export type { RuleContext } from "./types.js";
+//# 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":"AAAA,YAAY,EACV,OAAO,EACP,cAAc,EACd,IAAI,EACJ,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,KAAK,EACL,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EACL,aAAa,EACb,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { WASTE_CATEGORY_LABEL } from "./types.js";
+export { scan, runRules, discoverFiles, sortFindings, findingFingerprint, } from "./scanner.js";
+export { BASELINE_VERSION, readBaseline, writeBaseline, } from "./baseline.js";
+export { rules } from "./rules/index.js";
+export { trimInference, ecoLLM, } from "./ecoLLM.js";
+export { renderTerminalReport } from "./reporters/terminalReporter.js";
+export { renderJsonReport } from "./reporters/jsonReporter.js";
+export { renderSarifReport } from "./reporters/sarifReporter.js";
+export { renderMarkdownReport } from "./reporters/markdownReporter.js";
+export { TRIMFERENCE_COMMENT_MARKER, ECOLINT_COMMENT_MARKER, MAX_COMMENT_LENGTH, buildCommentBody, } from "./prComment.js";
+export { IMPACT_DISCLAIMER, impactLine, operationalImpactLine, makeImpact, } from "./impact.js";
+export { DEFAULT_CONFIG, SCANNABLE_EXTENSIONS, CONFIG_FILENAME, LEGACY_CONFIG_FILENAME, loadConfig, } from "./config.js";
+export { MODEL_MAP, detectProvider, classifyModelTier, suggestSmallerModels, } from "./models.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,GAGd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EACL,aAAa,EACb,MAAM,GASP,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,UAAU,GAGX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,aAAa,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A lightweight, CONFIGURABLE heuristic map of provider model tiers.
+ *
+ * These lists are intentionally illustrative, not authoritative — providers
+ * release and rename models constantly. Trimference uses this only to make
+ * suggestions more concrete ("consider gpt-4o-mini"), never to make hard claims.
+ */
+export type Provider = "openai" | "anthropic" | "google" | "mistral" | "unknown";
+export type ModelTier = "small" | "medium" | "large";
+export type ProviderModels = Record<ModelTier, string[]>;
+export declare const MODEL_MAP: Record<Exclude<Provider, "unknown">, ProviderModels>;
+/** Guess the provider from a model slug. Returns "unknown" if unclear. */
+export declare function detectProvider(model: string): Provider;
+/** Classify a model slug into a tier using the map, or null if not found. */
+export declare function classifyModelTier(model: string): ModelTier | null;
+/**
+ * Suggest smaller-tier example models for a provider. Falls back to a generic
+ * suggestion when the provider is unknown.
+ */
+export declare function suggestSmallerModels(provider: Provider): string[];
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;AAEzD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,cAAc,CAqB1E,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAStD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAGjE"}

package/dist/models.js

@@ -0,0 +1,58 @@
+export const MODEL_MAP = {
+    openai: {
+        small: ["gpt-4o-mini", "gpt-4.1-mini"],
+        medium: ["gpt-4.1", "gpt-4o"],
+        large: ["o3", "o4-mini-high"],
+    },
+    anthropic: {
+        small: ["claude-3-5-haiku", "claude-3-haiku"],
+        medium: ["claude-3-5-sonnet", "claude-sonnet"],
+        large: ["claude-opus"],
+    },
+    google: {
+        small: ["gemini-flash", "gemini-1.5-flash", "gemini-2.0-flash"],
+        medium: ["gemini-pro"],
+        large: ["gemini-ultra"],
+    },
+    mistral: {
+        small: ["ministral", "mistral-small"],
+        medium: ["mistral-medium"],
+        large: ["mistral-large"],
+    },
+};
+/** Guess the provider from a model slug. Returns "unknown" if unclear. */
+export function detectProvider(model) {
+    const m = model.toLowerCase();
+    if (/(^|[^a-z])(gpt-|o1|o3|o4|text-embedding-|dall-e|davinci)/.test(m)) {
+        return "openai";
+    }
+    if (m.includes("claude"))
+        return "anthropic";
+    if (m.includes("gemini") || m.includes("palm"))
+        return "google";
+    if (m.includes("mistral") || m.includes("ministral"))
+        return "mistral";
+    return "unknown";
+}
+/** Classify a model slug into a tier using the map, or null if not found. */
+export function classifyModelTier(model) {
+    const m = model.toLowerCase();
+    for (const provider of Object.values(MODEL_MAP)) {
+        for (const tier of ["small", "medium", "large"]) {
+            if (provider[tier].some((name) => m.includes(name.toLowerCase()))) {
+                return tier;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Suggest smaller-tier example models for a provider. Falls back to a generic
+ * suggestion when the provider is unknown.
+ */
+export function suggestSmallerModels(provider) {
+    if (provider === "unknown")
+        return [];
+    return MODEL_MAP[provider].small;
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,SAAS,GAAyD;IAC7E,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;QACtC,MAAM,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC7B,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;KAC9B;IACD,SAAS,EAAE;QACT,KAAK,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;QAC7C,MAAM,EAAE,CAAC,mBAAmB,EAAE,eAAe,CAAC;QAC9C,KAAK,EAAE,CAAC,aAAa,CAAC;KACvB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;QAC/D,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,KAAK,EAAE,CAAC,cAAc,CAAC;KACxB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC;QACrC,MAAM,EAAE,CAAC,gBAAgB,CAAC;QAC1B,KAAK,EAAE,CAAC,eAAe,CAAC;KACzB;CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,0DAA0D,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAgB,EAAE,CAAC;YAC/D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkB;IACrD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC"}

package/dist/prComment.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Helpers for posting the Trimference report as a pull-request comment.
+ *
+ * The GitHub Action embeds an inline copy of this logic inside an
+ * `actions/github-script` step (it cannot import from the published package at
+ * action runtime). This module keeps the same rules in one testable place and
+ * documents the contract the action relies on.
+ */
+/**
+ * Stable marker placed at the top of the comment body so the action can find
+ * and update its own comment instead of posting duplicates. Do not change this
+ * without a migration — existing comments are matched by this exact string.
+ */
+export declare const TRIMFERENCE_COMMENT_MARKER = "<!-- trimference-report -->";
+/** @deprecated Used only to migrate comments created before the rename. */
+export declare const ECOLINT_COMMENT_MARKER = "<!-- ecolint-ai-report -->";
+/**
+ * GitHub rejects issue/PR comments longer than 65536 characters. Leave headroom
+ * for the marker and the truncation note.
+ */
+export declare const MAX_COMMENT_LENGTH = 60000;
+export type CommentBodyOptions = {
+    /** Max length of the rendered report before truncation. Defaults to {@link MAX_COMMENT_LENGTH}. */
+    maxLength?: number;
+};
+/**
+ * Build the PR comment body from a Markdown report.
+ *
+ * - Prepends {@link TRIMFERENCE_COMMENT_MARKER} so the comment can be found/updated.
+ * - Truncates on a line boundary if the report is too long for a PR comment,
+ *   appending a note that points readers to the full report in the job summary.
+ *   The Markdown report is front-loaded (summary, impact score, category
+ *   breakdown, top fixes), so truncation keeps the most useful content.
+ */
+export declare function buildCommentBody(report: string, options?: CommentBodyOptions): string;
+//# sourceMappingURL=prComment.d.ts.map

package/dist/prComment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prComment.d.ts","sourceRoot":"","sources":["../src/prComment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,gCAAgC,CAAC;AACxE,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAkBR"}

package/dist/prComment.js

@@ -0,0 +1,45 @@
+/**
+ * Helpers for posting the Trimference report as a pull-request comment.
+ *
+ * The GitHub Action embeds an inline copy of this logic inside an
+ * `actions/github-script` step (it cannot import from the published package at
+ * action runtime). This module keeps the same rules in one testable place and
+ * documents the contract the action relies on.
+ */
+/**
+ * Stable marker placed at the top of the comment body so the action can find
+ * and update its own comment instead of posting duplicates. Do not change this
+ * without a migration — existing comments are matched by this exact string.
+ */
+export const TRIMFERENCE_COMMENT_MARKER = "<!-- trimference-report -->";
+/** @deprecated Used only to migrate comments created before the rename. */
+export const ECOLINT_COMMENT_MARKER = "<!-- ecolint-ai-report -->";
+/**
+ * GitHub rejects issue/PR comments longer than 65536 characters. Leave headroom
+ * for the marker and the truncation note.
+ */
+export const MAX_COMMENT_LENGTH = 60000;
+/**
+ * Build the PR comment body from a Markdown report.
+ *
+ * - Prepends {@link TRIMFERENCE_COMMENT_MARKER} so the comment can be found/updated.
+ * - Truncates on a line boundary if the report is too long for a PR comment,
+ *   appending a note that points readers to the full report in the job summary.
+ *   The Markdown report is front-loaded (summary, impact score, category
+ *   breakdown, top fixes), so truncation keeps the most useful content.
+ */
+export function buildCommentBody(report, options = {}) {
+    const maxLength = options.maxLength ?? MAX_COMMENT_LENGTH;
+    const trimmed = report.trimEnd();
+    if (trimmed.length <= maxLength) {
+        return `${TRIMFERENCE_COMMENT_MARKER}\n${trimmed}\n`;
+    }
+    // Cut at the last newline before the limit so we never split a Markdown line.
+    const slice = trimmed.slice(0, maxLength);
+    const lastNewline = slice.lastIndexOf("\n");
+    const body = (lastNewline > 0 ? slice.slice(0, lastNewline) : slice).trimEnd();
+    const note = "> ⚠️ This report was truncated to fit a PR comment. " +
+        "See the full Trimference report in the workflow **job summary**.";
+    return `${TRIMFERENCE_COMMENT_MARKER}\n${body}\n\n---\n\n${note}\n`;
+}
+//# sourceMappingURL=prComment.js.map

package/dist/prComment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prComment.js","sourceRoot":"","sources":["../src/prComment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AACxE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAOxC;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjC,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,GAAG,0BAA0B,KAAK,OAAO,IAAI,CAAC;IACvD,CAAC;IAED,8EAA8E;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAE/E,MAAM,IAAI,GACR,sDAAsD;QACtD,kEAAkE,CAAC;IAErE,OAAO,GAAG,0BAA0B,KAAK,IAAI,cAAc,IAAI,IAAI,CAAC;AACtE,CAAC"}

package/dist/reporters/impactTracker.d.ts

@@ -0,0 +1,21 @@
+import type { Finding, ScanResult, WasteCategory } from "../types.js";
+/** Category counts sorted high-to-low, as [label, count] pairs. */
+export declare function categoryBreakdown(result: ScanResult): Array<{
+    category: WasteCategory;
+    label: string;
+    count: number;
+}>;
+/**
+ * A short, human-readable "fix opportunity" line for a finding, e.g.
+ * "Add caching around app/api/generate/route.ts".
+ */
+export declare function fixOpportunityLabel(f: Finding): string;
+/**
+ * Top distinct fix opportunities across all findings, highest score first.
+ * Deduplicated by label so the same file+category isn't listed repeatedly.
+ */
+export declare function topFixOpportunities(result: ScanResult, limit?: number): Array<{
+    label: string;
+    score: number;
+}>;
+//# sourceMappingURL=impactTracker.d.ts.map

package/dist/reporters/impactTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactTracker.d.ts","sourceRoot":"","sources":["../../src/reporters/impactTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGtE,mEAAmE;AACnE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,GACjB,KAAK,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAkBtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,SAAI,GACR,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC"}

package/dist/reporters/impactTracker.js

@@ -0,0 +1,54 @@
+import { WASTE_CATEGORY_LABEL } from "../types.js";
+/** Category counts sorted high-to-low, as [label, count] pairs. */
+export function categoryBreakdown(result) {
+    const entries = Object.entries(result.summary.findingsByCategory);
+    return entries
+        .sort((a, b) => b[1] - a[1])
+        .map(([category, count]) => ({
+        category,
+        label: WASTE_CATEGORY_LABEL[category],
+        count,
+    }));
+}
+/**
+ * A short, human-readable "fix opportunity" line for a finding, e.g.
+ * "Add caching around app/api/generate/route.ts".
+ */
+export function fixOpportunityLabel(f) {
+    const loc = f.filePath;
+    switch (f.wasteCategory) {
+        case "repeated-inference":
+            return `Add caching / reduce repeated calls in ${loc}`;
+        case "token-bloat":
+            return `Limit prompt context in ${loc}`;
+        case "model-overkill":
+            return `Right-size the model in ${loc}`;
+        case "redundant-embedding":
+            return `Persist embeddings in ${loc}`;
+        case "unbounded-generation":
+            return `Set an output token limit in ${loc}`;
+        case "background-compute-drift":
+            return `Reduce schedule frequency in ${loc}`;
+        case "multimodal-cost-explosion":
+            return `Cap repeated image generation in ${loc}`;
+    }
+}
+/**
+ * Top distinct fix opportunities across all findings, highest score first.
+ * Deduplicated by label so the same file+category isn't listed repeatedly.
+ */
+export function topFixOpportunities(result, limit = 3) {
+    const seen = new Set();
+    const out = [];
+    for (const f of result.findings) {
+        const label = fixOpportunityLabel(f);
+        if (seen.has(label))
+            continue;
+        seen.add(label);
+        out.push({ label, score: f.impact.score });
+        if (out.length >= limit)
+            break;
+    }
+    return out;
+}
+//# sourceMappingURL=impactTracker.js.map

package/dist/reporters/impactTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactTracker.js","sourceRoot":"","sources":["../../src/reporters/impactTracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAC/B,MAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAE/D,CAAC;IACF,OAAO,OAAO;SACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,QAAQ;QACR,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC;QACrC,KAAK;KACN,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC;IACvB,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;QACxB,KAAK,oBAAoB;YACvB,OAAO,0CAA0C,GAAG,EAAE,CAAC;QACzD,KAAK,aAAa;YAChB,OAAO,2BAA2B,GAAG,EAAE,CAAC;QAC1C,KAAK,gBAAgB;YACnB,OAAO,2BAA2B,GAAG,EAAE,CAAC;QAC1C,KAAK,qBAAqB;YACxB,OAAO,yBAAyB,GAAG,EAAE,CAAC;QACxC,KAAK,sBAAsB;YACzB,OAAO,gCAAgC,GAAG,EAAE,CAAC;QAC/C,KAAK,0BAA0B;YAC7B,OAAO,gCAAgC,GAAG,EAAE,CAAC;QAC/C,KAAK,2BAA2B;YAC9B,OAAO,oCAAoC,GAAG,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkB,EAClB,KAAK,GAAG,CAAC;IAET,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAA4C,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/reporters/jsonReporter.d.ts

@@ -0,0 +1,4 @@
+import type { ScanResult } from "../types.js";
+/** Render a scan result as a stable, colorless JSON string. */
+export declare function renderJsonReport(result: ScanResult): string;
+//# sourceMappingURL=jsonReporter.d.ts.map

package/dist/reporters/jsonReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/jsonReporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA8B3D"}

package/dist/reporters/jsonReporter.js

@@ -0,0 +1,34 @@
+import { IMPACT_DISCLAIMER } from "../impact.js";
+/** Render a scan result as a stable, colorless JSON string. */
+export function renderJsonReport(result) {
+    const { summary, findings } = result;
+    const payload = {
+        schemaVersion: 2,
+        summary: {
+            filesScanned: summary.filesScanned,
+            durationMs: summary.durationMs,
+            totalFindings: summary.totalFindings,
+            high: summary.high,
+            medium: summary.medium,
+            low: summary.low,
+            priorityPoints: summary.priorityPoints,
+            baselineSuppressed: summary.baselineSuppressed,
+            ruleErrors: summary.ruleErrors,
+            findingsByCategory: summary.findingsByCategory,
+            topCategory: summary.topCategory,
+            suggestedFirstPass: summary.suggestedFirstPass,
+        },
+        disclaimer: IMPACT_DISCLAIMER,
+        findings: findings.map(({ impact, ...finding }) => ({
+            ...finding,
+            operationalImpact: {
+                computeRisk: impact.computeWaste,
+                costRisk: impact.costImpact,
+                confidence: impact.confidence,
+                explanation: impact.explanation,
+            },
+        })),
+    };
+    return JSON.stringify(payload, null, 2);
+}
+//# sourceMappingURL=jsonReporter.js.map

package/dist/reporters/jsonReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonReporter.js","sourceRoot":"","sources":["../../src/reporters/jsonReporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACrC,MAAM,OAAO,GAAG;QACd,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE;YACP,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;SAC/C;QACD,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAClD,GAAG,OAAO;YACV,iBAAiB,EAAE;gBACjB,WAAW,EAAE,MAAM,CAAC,YAAY;gBAChC,QAAQ,EAAE,MAAM,CAAC,UAAU;gBAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC;SACF,CAAC,CAAC;KACJ,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}