trimference 0.3.0

package/dist/scanner.js

@@ -0,0 +1,217 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import fg from "fast-glob";
+import { IGNORE_GLOBS, SCANNABLE_EXTENSIONS } from "./config.js";
+import { SEVERITY_WEIGHT, suggestedFirstPass } from "./impact.js";
+import { rules } from "./rules/index.js";
+import { applyInlineDisables, dedupeFindings, isTestFile } from "./rules/helpers.js";
+/** High-impact rules whose findings should be softened inside test files. */
+const HIGH_IMPACT_RULE_IDS = new Set([
+    "no-llm-cache",
+    "repeated-embeddings",
+    "image-generation-loop",
+]);
+/** Discover scannable files under a directory (or a single file). */
+export async function discoverFiles(rootPath) {
+    const stat = await fs.stat(rootPath).catch(() => null);
+    if (!stat) {
+        throw new Error(`Path does not exist: ${rootPath}`);
+    }
+    if (stat.isFile()) {
+        return isScannable(rootPath) ? [path.resolve(rootPath)] : [];
+    }
+    const extGroup = SCANNABLE_EXTENSIONS.map((e) => e.replace(/^\./, "")).join(",");
+    const pattern = `**/*.{${extGroup}}`;
+    const entries = await fg(pattern, {
+        cwd: rootPath,
+        ignore: IGNORE_GLOBS,
+        absolute: true,
+        dot: false,
+        followSymbolicLinks: false,
+    });
+    return entries.sort();
+}
+function isScannable(filePath) {
+    return SCANNABLE_EXTENSIONS.includes(path.extname(filePath).toLowerCase());
+}
+async function readSourceFile(absPath, rootPath) {
+    const content = await fs.readFile(absPath, "utf8");
+    // Prefer paths relative to the scanned root for readable reports.
+    const rel = path.relative(rootPath, absPath) || path.basename(absPath);
+    return {
+        path: normalizePath(rel),
+        content,
+        lines: content.split(/\r?\n/),
+    };
+}
+function normalizePath(p) {
+    return p.split(path.sep).join("/");
+}
+/** Run all rules against a single in-memory source file. */
+export function runRules(file, context, ignoredRules, onRuleError) {
+    const findings = [];
+    for (const rule of rules) {
+        if (ignoredRules?.has(rule.id))
+            continue;
+        try {
+            findings.push(...rule.scan(file, context));
+        }
+        catch (error) {
+            // Keep scanning, but make the failure observable to callers/reporters.
+            onRuleError?.(rule.id, error);
+        }
+    }
+    // Soften high-impact findings inside test/spec files to keep reports credible.
+    const controlled = isTestFile(file.path)
+        ? findings.map(softenIfHighImpactTest)
+        : findings;
+    // Honor inline `// trimference-disable...` directives before deduping.
+    return dedupeFindings(applyInlineDisables(file, controlled));
+}
+function softenIfHighImpactTest(finding) {
+    if (finding.severity !== "high" || !HIGH_IMPACT_RULE_IDS.has(finding.ruleId)) {
+        return finding;
+    }
+    return {
+        ...finding,
+        severity: "low",
+        impact: {
+            ...finding.impact,
+            score: Math.min(finding.impact.score, 30),
+            confidence: "low",
+        },
+    };
+}
+export function sortFindings(findings) {
+    return [...findings].sort((a, b) => {
+        const sev = SEVERITY_WEIGHT[b.severity] - SEVERITY_WEIGHT[a.severity];
+        if (sev !== 0)
+            return sev;
+        const score = b.impact.score - a.impact.score;
+        if (score !== 0)
+            return score;
+        if (a.filePath !== b.filePath)
+            return a.filePath < b.filePath ? -1 : 1;
+        return a.line - b.line;
+    });
+}
+function meetsMinSeverity(severity, min) {
+    return SEVERITY_WEIGHT[severity] >= SEVERITY_WEIGHT[min];
+}
+function buildSummary(filesScanned, findings, baselineSuppressed = 0, ruleErrors = [], durationMs = 0) {
+    const high = findings.filter((f) => f.severity === "high").length;
+    const medium = findings.filter((f) => f.severity === "medium").length;
+    const low = findings.filter((f) => f.severity === "low").length;
+    const averageImpactScore = findings.length === 0
+        ? 0
+        : Math.round(findings.reduce((sum, f) => sum + f.impact.score, 0) / findings.length);
+    const findingsByRule = {};
+    const findingsByFile = {};
+    const findingsByCategory = {};
+    for (const f of findings) {
+        findingsByRule[f.ruleId] = (findingsByRule[f.ruleId] ?? 0) + 1;
+        findingsByFile[f.filePath] = (findingsByFile[f.filePath] ?? 0) + 1;
+        findingsByCategory[f.wasteCategory] =
+            (findingsByCategory[f.wasteCategory] ?? 0) + 1;
+    }
+    const topCategory = pickTopCategory(findingsByCategory);
+    const priorityPoints = high * 3 + medium * 2 + low;
+    return {
+        filesScanned,
+        durationMs,
+        totalFindings: findings.length,
+        high,
+        medium,
+        low,
+        averageImpactScore,
+        // Compatibility field. Unlike the old average, this cannot increase when
+        // a finding is fixed. Human-facing reports use counts and confidence.
+        overallImpactScore: Math.min(100, priorityPoints * 4),
+        priorityPoints,
+        baselineSuppressed,
+        ruleErrors,
+        topFindings: findings.slice(0, 3),
+        findingsByRule,
+        findingsByFile,
+        findingsByCategory,
+        topCategory,
+        suggestedFirstPass: suggestedFirstPass(findings),
+    };
+}
+function pickTopCategory(counts) {
+    let top = null;
+    let best = -1;
+    for (const [category, count] of Object.entries(counts)) {
+        if (count > best) {
+            best = count;
+            top = category;
+        }
+    }
+    return top;
+}
+/** Scan a path and return sorted findings plus a summary. */
+export async function scan(options) {
+    const startedAt = Date.now();
+    const rootPath = path.resolve(options.path);
+    const minSeverity = options.minSeverity ?? "low";
+    const ignoredRules = new Set(options.ignoredRules ?? []);
+    const ignoredPaths = options.ignoredPaths ?? [];
+    const context = { provider: options.provider };
+    const baselineKeys = new Set(options.baselineKeys ?? []);
+    const includedPaths = options.includedPaths
+        ? new Set([...options.includedPaths].map(normalizePath))
+        : undefined;
+    const files = await discoverFiles(rootPath);
+    let allFindings = [];
+    const ruleErrors = [];
+    let scannedCount = 0;
+    for (const absPath of files) {
+        const file = await readSourceFile(absPath, rootPath);
+        if (includedPaths && !includedPaths.has(file.path))
+            continue;
+        if (isIgnoredPath(file.path, ignoredPaths))
+            continue;
+        scannedCount++;
+        allFindings.push(...runRules(file, context, ignoredRules, (ruleId, error) => {
+            ruleErrors.push({
+                ruleId,
+                filePath: file.path,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }));
+    }
+    allFindings = allFindings.filter((f) => meetsMinSeverity(f.severity, minSeverity));
+    const severityFilteredCount = allFindings.length;
+    allFindings = allFindings.filter((f) => !baselineKeys.has(findingFingerprint(f)));
+    const sorted = sortFindings(allFindings);
+    return {
+        summary: buildSummary(scannedCount, sorted, severityFilteredCount - allFindings.length, ruleErrors, Date.now() - startedAt),
+        findings: sorted,
+    };
+}
+/** Stable-enough key for accepting existing findings in a baseline file. */
+export function findingFingerprint(finding) {
+    const evidence = (finding.snippet ?? "")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, 160);
+    return [finding.ruleId, finding.filePath, evidence].join("::");
+}
+/** Match a relative path against glob patterns or backwards-compatible substrings. */
+function isIgnoredPath(relPath, ignoredPaths) {
+    if (ignoredPaths.length === 0)
+        return false;
+    return ignoredPaths.some((entry) => {
+        const pattern = entry.replace(/^\.\//, "");
+        if (!/[?*]/.test(pattern))
+            return pattern.length > 0 && relPath.includes(pattern);
+        const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+        const regex = escaped
+            .replace(/\*\*/g, "\u0000")
+            .replace(/\*/g, "[^/]*")
+            .replace(/\?/g, "[^/]")
+            .replace(/\u0000/g, ".*");
+        return new RegExp(`^(?:${regex})$`).test(relPath);
+    });
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAuBrF,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,cAAc;IACd,qBAAqB;IACrB,uBAAuB;CACxB,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAClB,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,SAAS,QAAQ,GAAG,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;QAChC,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,KAAK;QACV,mBAAmB,EAAE,KAAK;KAC3B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,OAAe,EACf,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,kEAAkE;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvE,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC;QACxB,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,QAAQ,CACtB,IAAgB,EAChB,OAAqB,EACrB,YAA0B,EAC1B,WAAsD;IAEtD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,SAAS;QACzC,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uEAAuE;YACvE,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,+EAA+E;IAC/E,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC;IACb,uEAAuE;IACvE,OAAO,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAgB;IAC9C,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7E,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE;YACN,GAAG,OAAO,CAAC,MAAM;YACjB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YACzC,UAAU,EAAE,KAAK;SAClB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAmB;IAC9C,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,GAAG,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC9C,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAkB,EAAE,GAAa;IACzD,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CACnB,YAAoB,EACpB,QAAmB,EACnB,kBAAkB,GAAG,CAAC,EACtB,aAAwC,EAAE,EAC1C,UAAU,GAAG,CAAC;IAEd,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IAEhE,MAAM,kBAAkB,GACtB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,IAAI,CAAC,KAAK,CACR,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CACvE,CAAC;IAER,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,MAAM,kBAAkB,GAA2C,EAAE,CAAC;IACtE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnE,kBAAkB,CAAC,CAAC,CAAC,aAAa,CAAC;YACjC,CAAC,kBAAkB,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC;IAExD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC;IAEnD,OAAO;QACL,YAAY;QACZ,UAAU;QACV,aAAa,EAAE,QAAQ,CAAC,MAAM;QAC9B,IAAI;QACJ,MAAM;QACN,GAAG;QACH,kBAAkB;QAClB,yEAAyE;QACzE,sEAAsE;QACtE,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,CAAC,CAAC;QACrD,cAAc;QACd,kBAAkB;QAClB,UAAU;QACV,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACjC,cAAc;QACd,cAAc;QACd,kBAAkB;QAClB,WAAW;QACX,kBAAkB,EAAE,kBAAkB,CAAC,QAAQ,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAA8C;IAE9C,IAAI,GAAG,GAAyB,IAAI,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAEpD,EAAE,CAAC;QACF,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YACjB,IAAI,GAAG,KAAK,CAAC;YACb,GAAG,GAAG,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAuB;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa;QACzC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxD,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,WAAW,GAAc,EAAE,CAAC;IAChC,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,aAAa,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7D,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;YAAE,SAAS;QACrD,YAAY,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CACd,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACzD,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACrC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAC1C,CAAC;IACF,MAAM,qBAAqB,GAAG,WAAW,CAAC,MAAM,CAAC;IACjD,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAEzC,OAAO;QACL,OAAO,EAAE,YAAY,CACnB,YAAY,EACZ,MAAM,EACN,qBAAqB,GAAG,WAAW,CAAC,MAAM,EAC1C,UAAU,EACV,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CACvB;QACD,QAAQ,EAAE,MAAM;KACjB,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;SACrC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjB,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,sFAAsF;AACtF,SAAS,aAAa,CAAC,OAAe,EAAE,YAAsB;IAC5D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO;aAClB,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;aAC1B,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;aACvB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;aACtB,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+export type Severity = "low" | "medium" | "high";
+export type Level = "low" | "medium" | "high";
+export type WasteCategory = "repeated-inference" | "token-bloat" | "model-overkill" | "redundant-embedding" | "unbounded-generation" | "background-compute-drift" | "multimodal-cost-explosion";
+/** Human-readable labels for waste categories, used in reports. */
+export declare const WASTE_CATEGORY_LABEL: Record<WasteCategory, string>;
+export type ImpactEstimate = {
+    computeWaste: Level;
+    /** @deprecated Experimental legacy field; not shown in human reports. */
+    carbonImpact: Level;
+    /** @deprecated Experimental legacy field; not shown in human reports. */
+    waterImpact: Level;
+    costImpact: Level;
+    confidence: Level;
+    /** Directional impact score from 1 to 100. Higher means more potential avoidable waste. */
+    score: number;
+    explanation: string;
+};
+export type Finding = {
+    ruleId: string;
+    title: string;
+    severity: Severity;
+    wasteCategory: WasteCategory;
+    filePath: string;
+    line: number;
+    column?: number;
+    snippet?: string;
+    message: string;
+    recommendation: string;
+    /** Concrete remediation checklist. Not an automatic code patch. */
+    fixRecipe: string[];
+    impact: ImpactEstimate;
+};
+export type SourceFile = {
+    path: string;
+    content: string;
+    lines: string[];
+};
+/** Optional context passed to rules, e.g. a configured provider fallback. */
+export type RuleContext = {
+    provider?: import("./models.js").Provider;
+};
+export type Rule = {
+    id: string;
+    title: string;
+    severity: Severity;
+    wasteCategory: WasteCategory;
+    description: string;
+    recommendation: string;
+    fixRecipe: string[];
+    scan: (file: SourceFile, context?: RuleContext) => Finding[];
+};
+export type ScanSummary = {
+    filesScanned: number;
+    durationMs: number;
+    totalFindings: number;
+    high: number;
+    medium: number;
+    low: number;
+    averageImpactScore: number;
+    /**
+     * @deprecated Retained for API compatibility. This is a monotonic heuristic
+     * priority index, not measured impact, and is not shown in human reports.
+     */
+    overallImpactScore: number;
+    /** Monotonic weighted finding total: high=3, medium=2, low=1. */
+    priorityPoints: number;
+    /** Findings hidden because they matched a supplied baseline. */
+    baselineSuppressed: number;
+    /** Rule failures encountered while scanning; empty during normal operation. */
+    ruleErrors: Array<{
+        ruleId: string;
+        filePath: string;
+        message: string;
+    }>;
+    topFindings: Finding[];
+    findingsByRule: Record<string, number>;
+    findingsByFile: Record<string, number>;
+    /** Counts keyed by WasteCategory, only for categories that appear. */
+    findingsByCategory: Partial<Record<WasteCategory, number>>;
+    /** The waste category with the most findings, or null when there are none. */
+    topCategory: WasteCategory | null;
+    /** Plain-English review-style actions derived from the top findings. */
+    suggestedFirstPass: string[];
+};
+export type ScanResult = {
+    summary: ScanSummary;
+    findings: Finding[];
+};
+export type ScanOptions = {
+    path: string;
+    minSeverity?: Severity;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,11 @@
+/** Human-readable labels for waste categories, used in reports. */
+export const WASTE_CATEGORY_LABEL = {
+    "repeated-inference": "Repeated inference",
+    "token-bloat": "Token bloat",
+    "model-overkill": "Model right-sizing",
+    "redundant-embedding": "Redundant embedding",
+    "unbounded-generation": "Unbounded generation",
+    "background-compute-drift": "Frequent background work",
+    "multimodal-cost-explosion": "Repeated image generation",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAYA,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IACjE,oBAAoB,EAAE,oBAAoB;IAC1C,aAAa,EAAE,aAAa;IAC5B,gBAAgB,EAAE,oBAAoB;IACtC,qBAAqB,EAAE,qBAAqB;IAC5C,sBAAsB,EAAE,sBAAsB;IAC9C,0BAA0B,EAAE,0BAA0B;IACtD,2BAA2B,EAAE,2BAA2B;CACzD,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "trimference",
+  "version": "0.3.0",
+  "description": "Local static analysis for LLM application efficiency safeguards.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/psamme/trimference#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/psamme/trimference.git"
+  },
+  "bugs": {
+    "url": "https://github.com/psamme/trimference/issues"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "cli",
+    "linter",
+    "static-analysis",
+    "developer-tools",
+    "llmops",
+    "cost-optimization",
+    "sarif",
+    "code-quality",
+    "github-actions",
+    "typescript"
+  ],
+  "bin": {
+    "trimference": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "action.yml",
+    "README.md",
+    "DEMO.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "BENCHMARK.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "scan:example": "tsx src/cli.ts scan --path examples/wasteful-ai-app",
+    "scan:self": "tsx src/cli.ts scan --path src --summary",
+    "verify": "npm run build && npm test && node dist/cli.js scan --path src --summary --fail-on low && node dist/cli.js scan --path examples/cleaner-ai-app --summary --fail-on low",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "fast-glob": "^3.3.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}