trimference 0.3.0

package/dist/reporters/markdownReporter.d.ts

@@ -0,0 +1,4 @@
+import type { ScanResult } from "../types.js";
+/** Render a compact GitHub-friendly efficiency review. */
+export declare function renderMarkdownReport(result: ScanResult): string;
+//# sourceMappingURL=markdownReporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdownReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/markdownReporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,UAAU,EAAY,MAAM,aAAa,CAAC;AAgFjE,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAuD/D"}

package/dist/reporters/markdownReporter.js

@@ -0,0 +1,97 @@
+import { IMPACT_DISCLAIMER, operationalImpactLine } from "../impact.js";
+import { WASTE_CATEGORY_LABEL } from "../types.js";
+import { categoryBreakdown, topFixOpportunities } from "./impactTracker.js";
+const SEVERITY_TITLE = {
+    high: "High",
+    medium: "Medium",
+    low: "Low",
+};
+function escapeCell(text) {
+    return text.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function location(finding) {
+    const label = `${finding.filePath}:${finding.line}`;
+    const repositoryUrl = process.env.GITHUB_SERVER_URL && process.env.GITHUB_REPOSITORY
+        ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}`
+        : undefined;
+    const revision = process.env.GITHUB_SHA;
+    const href = repositoryUrl && revision
+        ? `${repositoryUrl}/blob/${revision}/${encodeURI(finding.filePath)}#L${finding.line}`
+        : `./${encodeURI(finding.filePath)}#L${finding.line}`;
+    return `[\`${label}\`](${href})`;
+}
+function findingsTable(findings) {
+    const rows = findings.map((finding) => {
+        const evidence = finding.snippet
+            ? `<code>${escapeHtml(escapeCell(finding.snippet))}</code>`
+            : "—";
+        return `| ${SEVERITY_TITLE[finding.severity]} | ${finding.impact.confidence} | ${WASTE_CATEGORY_LABEL[finding.wasteCategory]} | ${location(finding)} | ${evidence} |`;
+    });
+    return [
+        "| Severity | Confidence | Safeguard | Location | Evidence |",
+        "|---|---|---|---|---|",
+        ...rows,
+    ].join("\n");
+}
+function findingDetail(finding) {
+    const title = `${SEVERITY_TITLE[finding.severity]} · ${finding.title} · ${finding.filePath}:${finding.line}`;
+    const out = [
+        "<details>",
+        `<summary>${escapeHtml(title)}</summary>`,
+        "",
+        `- **Rule:** \`${finding.ruleId}\``,
+        `- **Safeguard:** ${WASTE_CATEGORY_LABEL[finding.wasteCategory]}`,
+        `- **Location:** ${location(finding)}`,
+        `- **Signal:** ${operationalImpactLine(finding.impact)}`,
+    ];
+    if (finding.snippet) {
+        out.push("", "**Evidence:**", "", `> <code>${escapeHtml(finding.snippet)}</code>`);
+    }
+    out.push("", `**Issue:** ${finding.message}`, "", `**Why review it:** ${finding.impact.explanation}`, "", `**Recommended change:** ${finding.recommendation}`, "", "**Fix recipe:**", "");
+    finding.fixRecipe.forEach((step, index) => out.push(`${index + 1}. ${step}`));
+    out.push("", "</details>");
+    return out.join("\n");
+}
+/** Render a compact GitHub-friendly efficiency review. */
+export function renderMarkdownReport(result) {
+    const { summary, findings } = result;
+    const out = ["# Trimference Efficiency Review", ""];
+    if (summary.ruleErrors.length > 0) {
+        out.push(`> ⚠️ ${summary.ruleErrors.length} rule execution error(s) occurred; this report may be incomplete.`, "");
+    }
+    if (findings.length === 0) {
+        out.push(`Scanned **${summary.filesScanned} files** in **${summary.durationMs}ms** and found **no obvious missing AI efficiency safeguards**.`);
+        if (summary.baselineSuppressed > 0) {
+            out.push("", `${summary.baselineSuppressed} accepted baseline finding(s) were hidden.`);
+        }
+        out.push("", `> ${IMPACT_DISCLAIMER}`);
+        return out.join("\n");
+    }
+    out.push(`Scanned **${summary.filesScanned} files** in **${summary.durationMs}ms** and found **${summary.totalFindings} review item(s)**.`, "", "| High | Medium | Low | Baseline hidden |", "|---:|---:|---:|---:|", `| ${summary.high} | ${summary.medium} | ${summary.low} | ${summary.baselineSuppressed} |`, "", `> ${IMPACT_DISCLAIMER}`, "", "## Safeguards to review", "", "| Area | Findings |", "|---|---:|");
+    for (const item of categoryBreakdown(result)) {
+        out.push(`| ${item.label} | ${item.count} |`);
+    }
+    const opportunities = topFixOpportunities(result);
+    if (opportunities.length > 0) {
+        out.push("", "## Top opportunities", "");
+        opportunities.forEach((item, index) => out.push(`${index + 1}. ${item.label}`));
+    }
+    if (summary.suggestedFirstPass.length > 0) {
+        out.push("", "## Suggested first pass", "");
+        summary.suggestedFirstPass.forEach((action, index) => {
+            out.push(`${index + 1}. ${action}`);
+        });
+    }
+    out.push("", "## Findings", "", findingsTable(findings), "");
+    for (const finding of findings)
+        out.push(findingDetail(finding), "");
+    return out.join("\n");
+}
+//# sourceMappingURL=markdownReporter.js.map

package/dist/reporters/markdownReporter.js.map

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

package/dist/reporters/sarifReporter.d.ts

@@ -0,0 +1,4 @@
+import type { ScanResult } from "../types.js";
+/** Render SARIF 2.1.0 for GitHub code scanning and compatible tooling. */
+export declare function renderSarifReport(result: ScanResult): string;
+//# sourceMappingURL=sarifReporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sarifReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/sarifReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AASxD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAwD5D"}

package/dist/reporters/sarifReporter.js

@@ -0,0 +1,63 @@
+import { rules } from "../rules/index.js";
+const LEVEL = {
+    high: "error",
+    medium: "warning",
+    low: "note",
+};
+/** Render SARIF 2.1.0 for GitHub code scanning and compatible tooling. */
+export function renderSarifReport(result) {
+    const usedRuleIds = new Set(result.findings.map((finding) => finding.ruleId));
+    const ruleMetadata = rules
+        .filter((rule) => usedRuleIds.has(rule.id))
+        .map((rule) => ({
+        id: rule.id,
+        name: rule.id,
+        shortDescription: { text: rule.title },
+        fullDescription: { text: rule.description },
+        help: { text: rule.recommendation },
+        defaultConfiguration: { level: LEVEL[rule.severity] },
+        properties: { category: rule.wasteCategory },
+    }));
+    const payload = {
+        version: "2.1.0",
+        $schema: "https://json.schemastore.org/sarif-2.1.0.json",
+        runs: [
+            {
+                tool: {
+                    driver: {
+                        name: "Trimference",
+                        informationUri: "https://github.com/psamme/trimference",
+                        rules: ruleMetadata,
+                    },
+                },
+                results: result.findings.map((finding) => ({
+                    ruleId: finding.ruleId,
+                    level: LEVEL[finding.severity],
+                    message: {
+                        text: `${finding.message} ${finding.recommendation}`,
+                    },
+                    locations: [
+                        {
+                            physicalLocation: {
+                                artifactLocation: { uri: finding.filePath },
+                                region: {
+                                    startLine: finding.line,
+                                    ...(finding.column ? { startColumn: finding.column } : {}),
+                                    ...(finding.snippet
+                                        ? { snippet: { text: finding.snippet } }
+                                        : {}),
+                                },
+                            },
+                        },
+                    ],
+                    properties: {
+                        confidence: finding.impact.confidence,
+                        safeguard: finding.wasteCategory,
+                    },
+                })),
+            },
+        ],
+    };
+    return JSON.stringify(payload, null, 2);
+}
+//# sourceMappingURL=sarifReporter.js.map

package/dist/reporters/sarifReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarifReporter.js","sourceRoot":"","sources":["../../src/reporters/sarifReporter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,KAAK,GAAmD;IAC5D,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,MAAM;CACZ,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,KAAK;SACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;QACtC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;QAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE;QACnC,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QACrD,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE;KAC7C,CAAC,CAAC,CAAC;IAEN,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,OAAO;QAChB,OAAO,EACL,+CAA+C;QACjD,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE;wBACN,IAAI,EAAE,aAAa;wBACnB,cAAc,EAAE,uCAAuC;wBACvD,KAAK,EAAE,YAAY;qBACpB;iBACF;gBACD,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBACzC,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAC9B,OAAO,EAAE;wBACP,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE;qBACrD;oBACD,SAAS,EAAE;wBACT;4BACE,gBAAgB,EAAE;gCAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE;gCAC3C,MAAM,EAAE;oCACN,SAAS,EAAE,OAAO,CAAC,IAAI;oCACvB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oCAC1D,GAAG,CAAC,OAAO,CAAC,OAAO;wCACjB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE;wCACxC,CAAC,CAAC,EAAE,CAAC;iCACR;6BACF;yBACF;qBACF;oBACD,UAAU,EAAE;wBACV,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;wBACrC,SAAS,EAAE,OAAO,CAAC,aAAa;qBACjC;iBACF,CAAC,CAAC;aACJ;SACF;KACF,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/reporters/terminalReporter.d.ts

@@ -0,0 +1,10 @@
+import type { ScanResult } from "../types.js";
+/** Default number of compact finding blocks shown in a terminal. */
+export declare const DEFAULT_MAX_FINDINGS = 8;
+export type TerminalReportOptions = {
+    maxFindings?: number;
+    summary?: boolean;
+};
+/** Render a compact, evidence-first terminal review. */
+export declare function renderTerminalReport(result: ScanResult, options?: TerminalReportOptions): string;
+//# sourceMappingURL=terminalReporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminalReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/terminalReporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAW,UAAU,EAAY,MAAM,aAAa,CAAC;AAGjE,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAoBF,wDAAwD;AACxD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAkER"}

package/dist/reporters/terminalReporter.js

@@ -0,0 +1,80 @@
+import pc from "picocolors";
+import { IMPACT_DISCLAIMER } from "../impact.js";
+import { WASTE_CATEGORY_LABEL } from "../types.js";
+import { categoryBreakdown, topFixOpportunities } from "./impactTracker.js";
+/** Default number of compact finding blocks shown in a terminal. */
+export const DEFAULT_MAX_FINDINGS = 8;
+function severityTag(severity, confidence) {
+    const tag = `[${severity.toUpperCase()} · ${confidence.toUpperCase()} CONFIDENCE]`;
+    if (severity === "high")
+        return pc.bold(pc.red(tag));
+    if (severity === "medium")
+        return pc.bold(pc.yellow(tag));
+    return pc.bold(pc.cyan(tag));
+}
+function renderFinding(finding) {
+    const out = [
+        `${severityTag(finding.severity, finding.impact.confidence)} ${pc.bold(finding.title)}`,
+        `${finding.filePath}:${finding.line} · ${finding.ruleId} · ${WASTE_CATEGORY_LABEL[finding.wasteCategory]}`,
+    ];
+    if (finding.snippet)
+        out.push(pc.dim(`  ${finding.snippet}`));
+    out.push(`Issue: ${finding.message}`);
+    out.push(`Fix: ${finding.recommendation}`);
+    return out.join("\n");
+}
+/** Render a compact, evidence-first terminal review. */
+export function renderTerminalReport(result, options = {}) {
+    const { summary, findings } = result;
+    const out = [pc.bold(pc.green("Trimference efficiency review")), ""];
+    out.push(`Scanned ${pc.bold(String(summary.filesScanned))} files in ${summary.durationMs}ms.`);
+    if (summary.ruleErrors.length > 0) {
+        out.push(pc.red(`${summary.ruleErrors.length} rule execution error(s); results may be incomplete.`));
+    }
+    if (findings.length === 0) {
+        out.push("No obvious AI efficiency safeguards are missing.");
+        if (summary.baselineSuppressed > 0) {
+            out.push(pc.dim(`${summary.baselineSuppressed} baseline finding(s) hidden.`));
+        }
+        out.push("", pc.dim(`Note: ${IMPACT_DISCLAIMER}`));
+        return out.join("\n");
+    }
+    out.push(`Found ${pc.bold(String(summary.totalFindings))} review item(s): ` +
+        `${pc.red(`${summary.high} high`)} · ` +
+        `${pc.yellow(`${summary.medium} medium`)} · ` +
+        `${pc.cyan(`${summary.low} low`)}`);
+    if (summary.baselineSuppressed > 0) {
+        out.push(pc.dim(`${summary.baselineSuppressed} accepted baseline finding(s) hidden.`));
+    }
+    const breakdown = categoryBreakdown(result);
+    if (breakdown.length > 0) {
+        out.push("", pc.bold("Safeguards to review:"));
+        for (const item of breakdown)
+            out.push(`- ${item.label}: ${item.count}`);
+    }
+    const opportunities = topFixOpportunities(result);
+    if (opportunities.length > 0) {
+        out.push("", pc.bold("Top opportunities:"));
+        opportunities.forEach((item, index) => out.push(`${index + 1}. ${item.label}`));
+    }
+    if (summary.suggestedFirstPass.length > 0) {
+        out.push("", pc.bold("Suggested first pass:"));
+        summary.suggestedFirstPass.forEach((action, index) => {
+            out.push(`${index + 1}. ${action}`);
+        });
+    }
+    if (!options.summary) {
+        const max = options.maxFindings ?? DEFAULT_MAX_FINDINGS;
+        const shown = max === 0 ? findings : findings.slice(0, max);
+        out.push("", pc.bold("Prioritized findings:"));
+        for (const finding of shown)
+            out.push("", renderFinding(finding));
+        const hidden = findings.length - shown.length;
+        if (hidden > 0) {
+            out.push("", pc.dim(`...plus ${hidden} more. Use --markdown, --json, or --max-findings 0 to see all.`));
+        }
+    }
+    out.push("", pc.dim(`Note: ${IMPACT_DISCLAIMER}`));
+    return out.join("\n");
+}
+//# sourceMappingURL=terminalReporter.js.map

package/dist/reporters/terminalReporter.js.map

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

package/dist/rules/agentLoopWithoutBudget.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../types.js";
+export declare const agentLoopWithoutBudgetRule: Rule;
+//# sourceMappingURL=agentLoopWithoutBudget.d.ts.map

package/dist/rules/agentLoopWithoutBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentLoopWithoutBudget.d.ts","sourceRoot":"","sources":["../../src/rules/agentLoopWithoutBudget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAc,MAAM,aAAa,CAAC;AAgF7D,eAAO,MAAM,0BAA0B,EAAE,IA4CxC,CAAC"}

package/dist/rules/agentLoopWithoutBudget.js

@@ -0,0 +1,105 @@
+import { makeImpact } from "../impact.js";
+import { createFinding, findCodeMatchesInFile, hasNearbyCode, } from "./helpers.js";
+/**
+ * Strong signals that a file drives an agent / repeated tool-execution loop.
+ * We keep this conservative: an explicit agent-execution term, or an infinite
+ * loop that clearly sits next to model/tool/agent code.
+ */
+const AGENT_EXECUTION_TERMS = [
+    /agent\.run\s*\(/i,
+    /\brunAgent\s*\(/i,
+    /\bexecuteAgent\s*\(/i,
+    /\bagentExecutor\b/i,
+    /\bagentLoop\b/i,
+    /\btoolCalls\b/i,
+];
+/** Infinite / open-ended loops that can drive runaway agent execution. */
+const INFINITE_LOOP_TERMS = [
+    /while\s*\(\s*true\s*\)/i,
+    /for\s*\(\s*;\s*;\s*\)/,
+];
+/** Terms that suggest an infinite loop is doing model/tool work (not I/O polling). */
+const AGENT_CONTEXT_TERMS = [
+    /agent/i,
+    /\btool\b/i,
+    /toolCalls/i,
+    "openai",
+    "anthropic",
+    /generateText/i,
+    /messages\.create/i,
+    /chat\.completions\.create/i,
+];
+/**
+ * Budget / stopping-condition terms. If any appear in the file we assume the
+ * loop is bounded and stay quiet.
+ */
+const BUDGET_TERMS = [
+    "maxSteps",
+    "maxIterations",
+    "maxTurns",
+    "timeout",
+    "AbortController",
+    "signal",
+    "budget",
+    "costLimit",
+    "tokenLimit",
+    "max_tokens",
+    "maxOutputTokens",
+];
+const FIX_RECIPE = [
+    "Add a maximum number of agent/tool iterations.",
+    "Add a timeout or AbortController.",
+    "Add token and cost budgets where possible.",
+    "Log when a run stops because it hit a budget.",
+];
+/** Find the first agent-loop signal in the file, or null if none. */
+function firstAgentLoopSignal(file) {
+    // (a) An explicit agent-execution term is enough on its own.
+    const executionMatches = findCodeMatchesInFile(file, AGENT_EXECUTION_TERMS);
+    // (b) An infinite loop only counts when model/tool/agent code is nearby.
+    const loopMatches = findCodeMatchesInFile(file, INFINITE_LOOP_TERMS).filter((m) => hasNearbyCode(file, m.index, AGENT_CONTEXT_TERMS, 15));
+    const candidates = [...executionMatches, ...loopMatches].sort((a, b) => a.index - b.index);
+    return candidates.length > 0 ? candidates[0].index : null;
+}
+export const agentLoopWithoutBudgetRule = {
+    id: "agent-loop-without-budget",
+    title: "Agent loop without obvious budget",
+    severity: "high",
+    wasteCategory: "repeated-inference",
+    description: "Flags files that appear to run an agent or repeated tool/model loop without an obvious step, token, time, or cost budget.",
+    recommendation: "Add explicit max steps, timeouts, token caps, and/or cost budgets to prevent runaway agent loops.",
+    fixRecipe: FIX_RECIPE,
+    scan(file) {
+        const signalIndex = firstAgentLoopSignal(file);
+        if (signalIndex === null)
+            return [];
+        // Only a budget close to the loop/call counts; an unrelated timeout in the
+        // same file should not silence the finding.
+        if (hasNearbyCode(file, signalIndex, BUDGET_TERMS, 40))
+            return [];
+        // Report once per file to avoid noise.
+        return [
+            createFinding({
+                ruleId: this.id,
+                title: this.title,
+                severity: this.severity,
+                wasteCategory: this.wasteCategory,
+                file,
+                index: signalIndex,
+                message: "This agentic flow appears to run without an obvious step, token, time, or cost budget.",
+                recommendation: this.recommendation,
+                fixRecipe: this.fixRecipe,
+                impact: makeImpact({
+                    computeWaste: "high",
+                    carbonImpact: "medium",
+                    waterImpact: "medium",
+                    costImpact: "high",
+                    confidence: "medium",
+                    score: 88,
+                    explanation: "Agent loops can multiply model/tool calls if they do not have explicit stopping budgets.",
+                }),
+            }),
+        ];
+    },
+};
+//# sourceMappingURL=agentLoopWithoutBudget.js.map

package/dist/rules/agentLoopWithoutBudget.js.map

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

package/dist/rules/expensiveModelSimpleTask.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../types.js";
+export declare const expensiveModelSimpleTaskRule: Rule;
+//# sourceMappingURL=expensiveModelSimpleTask.d.ts.map

package/dist/rules/expensiveModelSimpleTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expensiveModelSimpleTask.d.ts","sourceRoot":"","sources":["../../src/rules/expensiveModelSimpleTask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAA2B,MAAM,aAAa,CAAC;AA8E1E,eAAO,MAAM,4BAA4B,EAAE,IAgE1C,CAAC"}

package/dist/rules/expensiveModelSimpleTask.js

@@ -0,0 +1,119 @@
+import { makeImpact } from "../impact.js";
+import { detectProvider, suggestSmallerModels } from "../models.js";
+import { LLM_CALL_PATTERNS, createFinding, dedupeFindings, findCodeMatchesInFile, findMatches, getNearbyText, hasNearby, } from "./helpers.js";
+const LARGE_MODEL_PATTERNS = [
+    /gpt-4(\.1|o)?/i,
+    "opus",
+    "claude-3-opus",
+    "claude-opus",
+];
+/**
+ * Downsized siblings of large models (e.g. gpt-4o-mini) are the *right* choice
+ * for simple tasks, so we must not flag them. Because a pattern like `gpt-4o`
+ * is a prefix of `gpt-4o-mini`, we inspect the full model slug at the match.
+ */
+const DOWNSIZED_VARIANT = /-(mini|nano|small|lite|micro|flash|instant)/i;
+/** The full model slug starting at a match, e.g. "gpt-4.1" or "claude-3-opus". */
+function modelSlugAt(content, index) {
+    return content.slice(index).match(/^[\w.-]+/)?.[0] ?? "";
+}
+function isDownsizedVariant(content, index) {
+    return DOWNSIZED_VARIANT.test(modelSlugAt(content, index));
+}
+const SIMPLE_TASK_LABELS = [
+    [/classif|categor|sentiment|label|tag/i, "classification"],
+    [/extract/i, "extraction"],
+    [/rout/i, "routing"],
+    [/moderat/i, "moderation"],
+    [/boolean|yes\/no|true\/false/i, "a yes/no decision"],
+];
+/** Name the kind of simple task hinted at near a model call, if any. */
+function describeTask(nearby) {
+    for (const [re, label] of SIMPLE_TASK_LABELS) {
+        if (re.test(nearby))
+            return label;
+    }
+    return "a simple task";
+}
+const SIMPLE_TASK_TERMS = [
+    "classify",
+    "classification",
+    "sentiment",
+    "tag",
+    "label",
+    "extract",
+    "extraction",
+    "route",
+    "routing",
+    "moderate",
+    "moderation",
+    "boolean",
+    "yes/no",
+    "true/false",
+    "category",
+    "categorize",
+];
+const FIX_RECIPE = [
+    "Classify the task type: routing, tagging, extraction, moderation, or reasoning.",
+    "Use a smaller model for simple structured tasks.",
+    "Cache deterministic results.",
+    "Add evaluation examples to verify quality remains acceptable.",
+];
+export const expensiveModelSimpleTaskRule = {
+    id: "expensive-model-simple-task",
+    title: "Large model used for a simple task",
+    severity: "medium",
+    wasteCategory: "model-overkill",
+    description: "Flags top-tier model names that appear near simple classification, extraction, or routing language.",
+    recommendation: "Consider a smaller model, rules-based logic, batching, or caching for simple structured tasks.",
+    fixRecipe: FIX_RECIPE,
+    scan(file, context) {
+        const findings = [];
+        const calls = findCodeMatchesInFile(file, LLM_CALL_PATTERNS);
+        if (calls.length === 0)
+            return findings;
+        for (const match of findMatches(file.content, LARGE_MODEL_PATTERNS)) {
+            if (!calls.some((call) => Math.abs(call.line - match.line) <= 30))
+                continue;
+            // Don't flag already right-sized models like gpt-4o-mini.
+            if (isDownsizedVariant(file.content, match.index))
+                continue;
+            // Only flag when a simple-task word appears within ~30 lines.
+            if (!hasNearby(file, match.index, SIMPLE_TASK_TERMS, 30))
+                continue;
+            const model = modelSlugAt(file.content, match.index);
+            const nearby = getNearbyText(file, match.index, 30);
+            const task = describeTask(nearby);
+            // Prefer the provider detected from the model slug; fall back to config.
+            const detected = detectProvider(model);
+            const provider = detected !== "unknown" ? detected : context?.provider ?? "unknown";
+            const suggestions = suggestSmallerModels(provider);
+            const message = `Detected model: ${model}. Task appears simple: ${task}. ` +
+                (suggestions.length > 0
+                    ? `Consider a smaller model tier such as ${suggestions.join(" or ")} if quality is acceptable.`
+                    : `Consider a smaller model tier if quality is acceptable.`);
+            findings.push(createFinding({
+                ruleId: this.id,
+                title: this.title,
+                severity: this.severity,
+                wasteCategory: this.wasteCategory,
+                file,
+                index: match.index,
+                message,
+                recommendation: this.recommendation,
+                fixRecipe: this.fixRecipe,
+                impact: makeImpact({
+                    computeWaste: "medium",
+                    carbonImpact: "medium",
+                    waterImpact: "medium",
+                    costImpact: "high",
+                    confidence: "low",
+                    score: 65,
+                    explanation: "Simple tasks often do not need the most capable model tier, so downsizing can reduce cost and compute demand.",
+                }),
+            }));
+        }
+        return dedupeFindings(findings);
+    },
+};
+//# sourceMappingURL=expensiveModelSimpleTask.js.map

package/dist/rules/expensiveModelSimpleTask.js.map

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

package/dist/rules/frequentCron.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../types.js";
+export declare const frequentCronRule: Rule;
+//# sourceMappingURL=frequentCron.d.ts.map

package/dist/rules/frequentCron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequentCron.d.ts","sourceRoot":"","sources":["../../src/rules/frequentCron.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAc,MAAM,aAAa,CAAC;AA2B7D,eAAO,MAAM,gBAAgB,EAAE,IAqD9B,CAAC"}

package/dist/rules/frequentCron.js

@@ -0,0 +1,64 @@
+import { makeImpact } from "../impact.js";
+import { LLM_CALL_PATTERNS, createFinding, dedupeFindings, findCodeMatchesInFile, findMatches, } from "./helpers.js";
+/**
+ * Very frequent cron expressions and short setInterval delays.
+ * Matches whole-line-ish cron patterns and setInterval with <= 60s delays.
+ */
+const FREQUENT_PATTERNS = [
+    /\*\s+\*\s+\*\s+\*\s+\*/, // "* * * * *"
+    /\*\/[1-5]\s+\*\s+\*\s+\*\s+\*/, // "*/1..*/5 * * * *"
+    /setInterval\s*\([^,]*,\s*(1000|5000|60000)\s*\)/i,
+];
+const FIX_RECIPE = [
+    "Replace fixed polling with event-driven triggers when possible.",
+    "Add exponential backoff when no work is found.",
+    "Batch small jobs into less frequent runs.",
+    "Lower the schedule frequency if the job is not time-sensitive.",
+];
+export const frequentCronRule = {
+    id: "frequent-cron",
+    title: "Very frequent scheduled job",
+    severity: "medium",
+    wasteCategory: "background-compute-drift",
+    description: "Flags cron expressions and setInterval delays that run very frequently.",
+    recommendation: "Consider event-driven triggers, backoff, batching, or a lower frequency schedule.",
+    fixRecipe: FIX_RECIPE,
+    scan(file) {
+        const findings = [];
+        // Scheduling alone is not an AI-efficiency issue. Require an executable
+        // model/embedding/image/agent call in the same file before evaluating its
+        // frequency.
+        const aiWork = findCodeMatchesInFile(file, [
+            ...LLM_CALL_PATTERNS,
+            /embeddings\.create\s*\(/i,
+            /images\.generate\s*\(/i,
+            /agent\.run\s*\(/i,
+        ]);
+        if (aiWork.length === 0)
+            return findings;
+        for (const match of findMatches(file.content, FREQUENT_PATTERNS)) {
+            findings.push(createFinding({
+                ruleId: this.id,
+                title: this.title,
+                severity: this.severity,
+                wasteCategory: this.wasteCategory,
+                file,
+                index: match.index,
+                message: "This scheduled job may run very frequently, even when there is no useful work to do.",
+                recommendation: this.recommendation,
+                fixRecipe: this.fixRecipe,
+                impact: makeImpact({
+                    computeWaste: "medium",
+                    carbonImpact: "low",
+                    waterImpact: "low",
+                    costImpact: "medium",
+                    confidence: "high",
+                    score: 55,
+                    explanation: "Frequent background jobs can create steady avoidable compute usage over time.",
+                }),
+            }));
+        }
+        return dedupeFindings(findings);
+    },
+};
+//# sourceMappingURL=frequentCron.js.map

package/dist/rules/frequentCron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequentCron.js","sourceRoot":"","sources":["../../src/rules/frequentCron.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,iBAAiB,GAA2B;IAChD,wBAAwB,EAAE,cAAc;IACxC,+BAA+B,EAAE,qBAAqB;IACtD,kDAAkD;CACnD,CAAC;AAEF,MAAM,UAAU,GAAG;IACjB,iEAAiE;IACjE,gDAAgD;IAChD,2CAA2C;IAC3C,gEAAgE;CACjE,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE,QAAQ;IAClB,aAAa,EAAE,0BAA0B;IACzC,WAAW,EACT,yEAAyE;IAC3E,cAAc,EACZ,mFAAmF;IACrF,SAAS,EAAE,UAAU;IACrB,IAAI,CAAC,IAAgB;QACnB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,wEAAwE;QACxE,0EAA0E;QAC1E,aAAa;QACb,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE;YACzC,GAAG,iBAAiB;YACpB,0BAA0B;YAC1B,wBAAwB;YACxB,kBAAkB;SACnB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEzC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,IAAI;gBACJ,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EACL,sFAAsF;gBACxF,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,UAAU,CAAC;oBACjB,YAAY,EAAE,QAAQ;oBACtB,YAAY,EAAE,KAAK;oBACnB,WAAW,EAAE,KAAK;oBAClB,UAAU,EAAE,QAAQ;oBACpB,UAAU,EAAE,MAAM;oBAClB,KAAK,EAAE,EAAE;oBACT,WAAW,EACT,+EAA+E;iBAClF,CAAC;aACH,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;CACF,CAAC"}