Files
phantomptrandClaude Opus 5.5 7199b2fae2 Remove unused repo files and stale FTX2 doc notes
Deletes tests/install-fallback-hw.mjs, the mobile audit probe and its allowlist,
scripts/requirements.txt, tests/lab/verify-pending.sh, bench/baselines/ and client/icons/
(nothing references them; the bundle icons live in client/src-tauri/icons). audit-scripts
lists fpkg-diff.py as a manual research tool and no longer counts a script naming itself as
a reference. SPEC.md no longer says zip/7z/RAR sources fall back to FTX2.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ub1mez9eaVtTF8pMEFXvA9
2026-10-10 06:24:09 -07:00

76 lines
2.7 KiB
JavaScript
Executable File

#!/usr/bin/env node
import { spawnSync } from "node:child_process";
import fs from "node:fs";
import path from "node:path";
const repoRoot = path.resolve(import.meta.dirname, "..");
const strict = process.argv.includes("--strict");
const manualEntrypoints = new Set([
"scripts/bundle-fonts.py",
"scripts/find-orphan-i18n.mjs",
// Research tool for comparing a built package against a reference one by hand.
"scripts/fpkg-diff.py",
"scripts/hw-test-loop.sh",
"scripts/i18n-fill-missing.mjs",
"scripts/i18n-prune-unused.mjs",
"scripts/release-posts.js",
"scripts/translate-i18n.py",
"tests/lab/README.md",
]);
function gitLsFiles(prefixes) {
const res = spawnSync("git", ["ls-files", ...prefixes], {
cwd: repoRoot,
encoding: "utf8",
});
if (res.status !== 0) throw new Error(res.stderr || "git ls-files failed");
return res.stdout.trim().split(/\n/).filter(Boolean);
}
function countRefs(needle, haystackFiles) {
const base = path.basename(needle);
let refs = 0;
for (const file of haystackFiles) {
// A script naming itself (usage text, a docstring) is not a reference.
if (file === "scripts/audit-scripts.mjs" || file === needle) continue;
try {
const text = fs.readFileSync(path.join(repoRoot, file), "utf8");
if (text.includes(base)) refs += 1;
} catch {
// Binary or unreadable tracked file: irrelevant for script references.
}
}
return refs;
}
const files = gitLsFiles(["scripts", "tests/lab", "bench"]);
const haystackFiles = gitLsFiles(["."]).filter((file) =>
!file.startsWith("client/node_modules/")
&& !file.startsWith("engine/target/")
&& !file.startsWith("client/src-tauri/target/")
&& !file.startsWith("client/dist/")
);
const executableLike = files.filter((f) => /\.(mjs|js|py|sh|ps1)$/i.test(f));
// A `*.test.mjs` beside a script is run by check-scripts.mjs (`node --test` over
// every such file), so it is used without being named anywhere.
const runByCheckScripts = (file) => /\.test\.mjs$/.test(file);
const rows = executableLike.map((file) => ({
file,
refs: runByCheckScripts(file) ? 1 : countRefs(file, haystackFiles),
manual: manualEntrypoints.has(file),
}));
const suspicious = rows.filter((r) => r.refs === 0 && !r.manual);
process.stdout.write("[audit-scripts] tracked script/test utilities\n");
for (const r of rows) {
const mark = r.manual ? "manual" : r.refs === 0 ? "orphan?" : "used";
process.stdout.write(`${String(r.refs).padStart(3)} ${mark.padEnd(7)} ${r.file}\n`);
}
if (suspicious.length > 0) {
process.stdout.write("\n[audit-scripts] review these unreferenced files:\n");
for (const r of suspicious) process.stdout.write(` ${r.file}\n`);
if (strict) process.exit(1);
}