@macrulez/devtoolz 0.1.0 → 0.2.0

package/dist/commands/orphan-tests/report.js

@@ -0,0 +1,30 @@
+import { banner, cleanCelebration } from '../../format/vibes.js';
+import { formatFindingsRows } from '../../format/findings-list.js';
+export function renderOrphanTestsReport(report, options = {}) {
+    if (report.error) {
+        const lines = [];
+        if (!options.quiet && !options.plain)
+            lines.push(banner(), '');
+        lines.push(`Could not run orphan-tests: ${report.error}`);
+        return lines.join('\n');
+    }
+    const isClean = report.findings.length === 0;
+    if (options.quiet && isClean)
+        return '';
+    const lines = [];
+    if (!options.quiet && !options.plain)
+        lines.push(banner(), '');
+    lines.push(`Scanned ${report.filesScanned} file${report.filesScanned === 1 ? '' : 's'}.`, '');
+    if (isClean) {
+        lines.push(cleanCelebration(options));
+        return lines.join('\n');
+    }
+    lines.push(`${report.findings.length} orphan test${report.findings.length === 1 ? '' : 's'} found:`);
+    lines.push(...formatFindingsRows(report.findings.map((f) => ({
+        location: f.file,
+        name: 'orphan',
+        tag: `no matching source found (tried ${f.triedExtensions.join(', ')})`,
+    })), options));
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/orphan-tests/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/commands/orphan-tests/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAA;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAGlE,MAAM,UAAU,uBAAuB,CACrC,MAAyB,EACzB,UAAwB,EAAE;IAE1B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9D,KAAK,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;QACzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9D,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,YAAY,QAAQ,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;IAE7F,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CACzF,CAAA;IACD,KAAK,CAAC,IAAI,CACR,GAAG,kBAAkB,CACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI;QAChB,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,mCAAmC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACxE,CAAC,CAAC,EACH,OAAO,CACR,CACF,CAAA;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/commands/orphan-tests/run.d.ts

@@ -0,0 +1,25 @@
+import { type OrphanTestFinding } from './core.js';
+export interface OrphanTestsRunOptions {
+    paths: string[];
+    cwd: string;
+    /** which files to consider as POSSIBLE test files while walking — default: .ts,.tsx,.js,.jsx,.mjs,.cjs */
+    extensions?: string[];
+    ignoreGlobs?: string[];
+    respectGitignore?: boolean;
+    /** suffix(es) that mark a file as a test file — default: ['.test', '.spec'] */
+    testSuffixes?: string[];
+    /** extensions tried for a matching source file — default: .ts,.tsx,.js,.jsx,.mjs,.cjs,.vue */
+    sourceExtensions?: string[];
+    /** mirrored layout: source root, relative to `cwd` — must be given together with `testDir` */
+    sourceDir?: string;
+    /** mirrored layout: test root, relative to `cwd` — must be given together with `sourceDir` */
+    testDir?: string;
+}
+export interface OrphanTestsReport {
+    filesScanned: number;
+    findings: OrphanTestFinding[];
+    /** --source-dir/--test-dir given without its pair — a different kind of problem than any single finding */
+    error: string | null;
+    exitCode: number;
+}
+export declare function runOrphanTests(options: OrphanTestsRunOptions): OrphanTestsReport;

package/dist/commands/orphan-tests/run.js

@@ -0,0 +1,55 @@
+import { basename, dirname, join, relative, resolve } from 'node:path';
+import { walk } from '../../utils/walk.js';
+import { parseTestFile, hasMatchingSource, candidateSourceDirs, } from './core.js';
+const DEFAULT_TEST_SUFFIXES = ['.test', '.spec'];
+const DEFAULT_SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.vue'];
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+export function runOrphanTests(options) {
+    const cwd = resolve(options.cwd);
+    const testSuffixes = options.testSuffixes ?? DEFAULT_TEST_SUFFIXES;
+    const sourceExtensions = options.sourceExtensions ?? DEFAULT_SOURCE_EXTENSIONS;
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    if (Boolean(options.sourceDir) !== Boolean(options.testDir)) {
+        return {
+            filesScanned: 0,
+            findings: [],
+            error: '--source-dir and --test-dir must be given together',
+            exitCode: 1,
+        };
+    }
+    const mirrored = Boolean(options.sourceDir && options.testDir);
+    const walkRoots = mirrored ? [options.testDir] : options.paths;
+    const testFiles = walk(walkRoots, {
+        cwd,
+        extensions,
+        ignoreGlobs: options.ignoreGlobs ?? [],
+        ...(options.respectGitignore !== undefined
+            ? { respectGitignore: options.respectGitignore }
+            : {}),
+    });
+    const testDirAbs = mirrored ? resolve(cwd, options.testDir) : null;
+    const sourceDirAbs = mirrored ? resolve(cwd, options.sourceDir) : null;
+    const findings = [];
+    for (const absFile of testFiles) {
+        const parsed = parseTestFile(basename(absFile), testSuffixes);
+        if (!parsed)
+            continue;
+        const found = mirrored && testDirAbs && sourceDirAbs
+            ? hasMatchingSource(join(sourceDirAbs, relative(testDirAbs, dirname(absFile)), parsed.base), sourceExtensions)
+            : candidateSourceDirs(dirname(absFile)).some((dir) => hasMatchingSource(join(dir, parsed.base), sourceExtensions));
+        if (found)
+            continue;
+        findings.push({
+            file: relative(cwd, absFile).split('\\').join('/'),
+            triedExtensions: sourceExtensions,
+        });
+    }
+    findings.sort((a, b) => a.file.localeCompare(b.file));
+    return {
+        filesScanned: testFiles.length,
+        findings,
+        error: null,
+        exitCode: findings.length > 0 ? 1 : 0,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/orphan-tests/run.js.map

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

package/dist/commands/readme-check/run.js

@@ -1,15 +1,20 @@
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { checkMarkdownFile } from './core.js';
-import { loadCompilerOptions } from './tsconfig.js';
+import { loadTsconfig } from '../../utils/load-tsconfig.js';
 import { DEFAULT_LANGS } from './lang.js';
 export function runReadmeCheck(options) {
     const packageDir = resolve(options.dir);
     const targetFiles = options.files && options.files.length > 0 ? options.files : ['README.md'];
     const langs = options.langs && options.langs.length > 0 ? options.langs : DEFAULT_LANGS;
-    const loaded = loadCompilerOptions(packageDir, options.tsconfig);
+    const loaded = loadTsconfig(packageDir, options.tsconfig);
     if ('error' in loaded) {
-        return { fileResults: [], findings: [], error: loaded.error, exitCode: 1 };
+        return {
+            fileResults: [],
+            findings: [],
+            error: `${loaded.error} — nothing to typecheck README code blocks against`,
+            exitCode: 1,
+        };
     }
     const fileResults = [];
     for (const relFile of targetFiles) {

package/dist/commands/readme-check/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/readme-check/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,iBAAiB,EAAuD,MAAM,WAAW,CAAA;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAqBzC,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAC7F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAA;IAEvF,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAChE,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IAC5E,CAAC;IAED,MAAM,WAAW,GAA4B,EAAE,CAAA;IAC/C,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC5C,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,kBAAkB,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBACvF,QAAQ,EAAE,CAAC;aACZ,CAAA;QACH,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3F,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACtF,CAAC"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/readme-check/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,iBAAiB,EAAuD,MAAM,WAAW,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAqBzC,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAC7F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAA;IAEvF,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,oDAAoD;YAC1E,QAAQ,EAAE,CAAC;SACZ,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAA4B,EAAE,CAAA;IAC/C,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC5C,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,kBAAkB,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBACvF,QAAQ,EAAE,CAAC;aACZ,CAAA;QACH,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3F,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACtF,CAAC"}

package/dist/commands/scripts-check/core.d.ts

@@ -0,0 +1,18 @@
+export interface ScriptsCheckFinding {
+    kind: 'missing' | 'undocumented';
+    name: string;
+    file: string;
+    line: number;
+}
+export interface ScriptSource {
+    file: string;
+    text: string;
+}
+export declare function maskOutOfScopeCiSteps(text: string): string;
+export declare function extractMentionedScripts(text: string): {
+    name: string;
+    index: number;
+}[];
+export declare function isScriptMentioned(name: string, text: string): boolean;
+export declare function isReservedLifecycleScript(name: string, allNames: Set<string>): boolean;
+export declare function analyzeScriptsCheck(scripts: Record<string, string>, packageJsonFile: string, packageJsonText: string, sources: ScriptSource[]): ScriptsCheckFinding[];

package/dist/commands/scripts-check/core.js

@@ -0,0 +1,121 @@
+import { escapeRegExp } from '../../utils/escape-regexp.js';
+import { lineOf } from '../../utils/line-of.js';
+// npm's own no-`run`-needed aliases — the ONLY bare `npm <word>` forms
+// that unambiguously mean "run this script". Any other bare word after
+// `npm` is a real npm subcommand (`npm install`, `npm publish`, ...), not
+// a script invocation.
+const NPM_BARE_ALIASES = new Set(['test', 'start']);
+// Forms unambiguous enough to EXTRACT an arbitrary script name from —
+// each requires an explicit `run`/`run-script`, or is one of npm's own
+// bare aliases above, so there's no risk of misreading an unrelated
+// subcommand (`yarn add`, `pnpm install`) as a script name. Used for
+// direction 1 (finding a mention of a script that doesn't exist).
+const EXTRACT_PATTERNS = [
+    /\bnpm\s+run(?:-script)?\s+([\w:./@-]+)/g,
+    /\byarn\s+run\s+([\w:./@-]+)/g,
+    /\bpnpm\s+run\s+([\w:./@-]+)/g,
+    /\b(?:npm|yarn|pnpm)\s+(test|start)\b/g,
+];
+// A GitHub Actions step with its own `working-directory:` runs against a
+// DIFFERENT package.json (a `demo/` subproject, a workspace package) —
+// found for real while dogfooding against vue-virtual-scroller-kit: its
+// `e2e` job runs `npm run test:e2e` under `working-directory: demo`,
+// where that script genuinely exists in `demo/package.json`, but not in
+// the root one this command checks. No real YAML parsing here (same
+// text-scan-not-AST spirit as everything else in this command) — a step
+// boundary is approximated as everything within a few lines of a
+// `working-directory:` line, which is blanked out (same length, so line
+// numbers for anything NOT blanked stay correct) before either direction
+// gets to look at it.
+const WORKING_DIRECTORY_RE = /^\s*working-directory\s*:/;
+const STEP_SCOPE_WINDOW = 3;
+export function maskOutOfScopeCiSteps(text) {
+    const lines = text.split('\n');
+    const hasWorkingDir = lines.map((l) => WORKING_DIRECTORY_RE.test(l));
+    if (!hasWorkingDir.some(Boolean))
+        return text;
+    return lines
+        .map((line, i) => {
+        const start = Math.max(0, i - STEP_SCOPE_WINDOW);
+        const end = Math.min(lines.length - 1, i + STEP_SCOPE_WINDOW);
+        for (let j = start; j <= end; j++) {
+            if (hasWorkingDir[j])
+                return line.replace(/./g, 'x');
+        }
+        return line;
+    })
+        .join('\n');
+}
+export function extractMentionedScripts(text) {
+    const mentions = [];
+    for (const pattern of EXTRACT_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(text))) {
+            mentions.push({ name: match[1], index: match.index });
+        }
+    }
+    return mentions;
+}
+// Direction 2 (is an ALREADY-KNOWN script name mentioned anywhere) can
+// afford to also accept yarn/pnpm's own bare `<manager> <name>` form —
+// real for those two package managers, unlike plain npm — since we're
+// testing one specific known name, not extracting an arbitrary one out
+// of free text, so a stray `yarn add`/`pnpm install` can't be misread as
+// a match for a script actually named "add"/"install" (vanishingly rare
+// in practice, and a false NEGATIVE here — reported as undocumented when
+// it technically isn't — is the safe direction for a weak signal).
+export function isScriptMentioned(name, text) {
+    const n = escapeRegExp(name);
+    const pattern = NPM_BARE_ALIASES.has(name)
+        ? new RegExp(`\\b(?:npm|yarn|pnpm)(?:\\s+run(?:-script)?)?\\s+${n}\\b`)
+        : new RegExp(`\\b(?:npm\\s+run(?:-script)?|yarn(?:\\s+run)?|pnpm(?:\\s+run)?)\\s+${n}\\b`);
+    return pattern.test(text);
+}
+// npm auto-runs `pre<X>`/`post<X>` around either another declared script
+// or one of npm's own built-in lifecycle events — documenting them "for
+// a human" is pointless, npm calls them itself. `prepublishOnly`,
+// `preinstall`, `postinstall`, `prepare` are npm's own implicit events
+// (no peer script named `install`/`publishOnly` need exist for these to
+// fire), so they're a fixed exemption; any other `pre*`/`post*` is only
+// exempt when its own peer script is actually declared.
+const RESERVED_LIFECYCLE_NAMES = new Set(['prepublishOnly', 'preinstall', 'postinstall', 'prepare']);
+export function isReservedLifecycleScript(name, allNames) {
+    if (RESERVED_LIFECYCLE_NAMES.has(name))
+        return true;
+    const pre = /^pre(.+)/.exec(name);
+    if (pre && allNames.has(pre[1]))
+        return true;
+    const post = /^post(.+)/.exec(name);
+    if (post && allNames.has(post[1]))
+        return true;
+    return false;
+}
+export function analyzeScriptsCheck(scripts, packageJsonFile, packageJsonText, sources) {
+    const scriptNames = new Set(Object.keys(scripts));
+    const findings = [];
+    const reportedMissing = new Set();
+    for (const source of sources) {
+        for (const { name, index } of extractMentionedScripts(source.text)) {
+            if (scriptNames.has(name))
+                continue;
+            const key = `${source.file}:${name}`;
+            if (reportedMissing.has(key))
+                continue;
+            reportedMissing.add(key);
+            findings.push({ kind: 'missing', name, file: source.file, line: lineOf(source.text, index) });
+        }
+    }
+    for (const name of scriptNames) {
+        if (isReservedLifecycleScript(name, scriptNames))
+            continue;
+        const mentioned = sources.some((s) => isScriptMentioned(name, s.text));
+        if (mentioned)
+            continue;
+        const keyMatch = new RegExp(`"${escapeRegExp(name)}"\\s*:`).exec(packageJsonText);
+        const line = keyMatch ? lineOf(packageJsonText, keyMatch.index) : 1;
+        findings.push({ kind: 'undocumented', name, file: packageJsonFile, line });
+    }
+    return findings;
+}
+//# sourceMappingURL=core.js.map

package/dist/commands/scripts-check/core.js.map

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

package/dist/commands/scripts-check/report.d.ts

@@ -0,0 +1,3 @@
+import { type VibesOptions } from '../../format/vibes.js';
+import type { ScriptsCheckReport } from './run.js';
+export declare function renderScriptsCheckReport(report: ScriptsCheckReport, options?: VibesOptions): string;

package/dist/commands/scripts-check/report.js

@@ -0,0 +1,34 @@
+import { banner, cleanCelebration } from '../../format/vibes.js';
+import { formatFindingsRows } from '../../format/findings-list.js';
+const KIND_TAG = {
+    missing: 'mentioned here, but not in package.json scripts',
+    undocumented: 'in package.json scripts, but not mentioned anywhere checked',
+};
+export function renderScriptsCheckReport(report, options = {}) {
+    if (report.error) {
+        const lines = [];
+        if (!options.quiet && !options.plain)
+            lines.push(banner(), '');
+        lines.push(`Could not run scripts-check: ${report.error}`);
+        return lines.join('\n');
+    }
+    const isClean = report.findings.length === 0;
+    if (options.quiet && isClean)
+        return '';
+    const lines = [];
+    if (!options.quiet && !options.plain)
+        lines.push(banner(), '');
+    lines.push(`Checked ${report.sourcesScanned.length} source${report.sourcesScanned.length === 1 ? '' : 's'} against package.json's scripts.`, '');
+    if (isClean) {
+        lines.push(cleanCelebration(options));
+        return lines.join('\n');
+    }
+    lines.push(`${report.findings.length} problem${report.findings.length === 1 ? '' : 's'} found:`);
+    lines.push(...formatFindingsRows(report.findings.map((f) => ({
+        location: `${f.file}:${f.line}`,
+        name: f.name,
+        tag: KIND_TAG[f.kind] ?? f.kind,
+    })), options));
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/scripts-check/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/commands/scripts-check/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAA;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAGlE,MAAM,QAAQ,GAA2B;IACvC,OAAO,EAAE,iDAAiD;IAC1D,YAAY,EAAE,6DAA6D;CAC5E,CAAA;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA0B,EAC1B,UAAwB,EAAE;IAE1B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9D,KAAK,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;QAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9D,KAAK,CAAC,IAAI,CACR,WAAW,MAAM,CAAC,cAAc,CAAC,MAAM,UAAU,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kCAAkC,EAChI,EAAE,CACH,CAAA;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,WAAW,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAChG,KAAK,CAAC,IAAI,CACR,GAAG,kBAAkB,CACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE;QAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI;KAChC,CAAC,CAAC,EACH,OAAO,CACR,CACF,CAAA;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/commands/scripts-check/run.d.ts

@@ -0,0 +1,15 @@
+import { type ScriptsCheckFinding } from './core.js';
+export interface ScriptsCheckRunOptions {
+    /** package directory to check — package.json, --file docs, and .github/workflows are all resolved from here */
+    dir: string;
+    /** markdown/doc files to check, relative to `dir` — default: ['README.md'] */
+    files?: string[];
+}
+export interface ScriptsCheckReport {
+    findings: ScriptsCheckFinding[];
+    sourcesScanned: string[];
+    /** package.json or an explicitly-requested doc file couldn't be read at all — a different kind of problem than any single finding */
+    error: string | null;
+    exitCode: number;
+}
+export declare function runScriptsCheck(options: ScriptsCheckRunOptions): ScriptsCheckReport;

package/dist/commands/scripts-check/run.js

@@ -0,0 +1,81 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { analyzeScriptsCheck, maskOutOfScopeCiSteps, } from './core.js';
+function readWorkflowSources(packageDir) {
+    let entries;
+    try {
+        entries = readdirSync(join(packageDir, '.github', 'workflows'));
+    }
+    catch {
+        return [];
+    }
+    const sources = [];
+    for (const entry of entries) {
+        if (!/\.ya?ml$/.test(entry))
+            continue;
+        const relFile = `.github/workflows/${entry}`;
+        try {
+            const text = maskOutOfScopeCiSteps(readFileSync(join(packageDir, relFile), 'utf8'));
+            sources.push({ file: relFile, text });
+        }
+        catch {
+            // unreadable — skip rather than fail the whole command over one file
+        }
+    }
+    return sources;
+}
+export function runScriptsCheck(options) {
+    const packageDir = resolve(options.dir);
+    let packageJsonText;
+    try {
+        packageJsonText = readFileSync(join(packageDir, 'package.json'), 'utf8');
+    }
+    catch (err) {
+        return {
+            findings: [],
+            sourcesScanned: [],
+            error: `could not read package.json: ${err instanceof Error ? err.message : String(err)}`,
+            exitCode: 1,
+        };
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(packageJsonText);
+    }
+    catch (err) {
+        return {
+            findings: [],
+            sourcesScanned: [],
+            error: `could not parse package.json: ${err instanceof Error ? err.message : String(err)}`,
+            exitCode: 1,
+        };
+    }
+    const scripts = pkg.scripts ?? {};
+    const docFiles = options.files && options.files.length > 0 ? options.files : ['README.md'];
+    const sources = [];
+    for (const relFile of docFiles) {
+        let text;
+        try {
+            text = readFileSync(join(packageDir, relFile), 'utf8');
+        }
+        catch (err) {
+            return {
+                findings: [],
+                sourcesScanned: [],
+                error: `could not read ${relFile}: ${err instanceof Error ? err.message : String(err)}`,
+                exitCode: 1,
+            };
+        }
+        sources.push({ file: relFile, text });
+    }
+    sources.push(...readWorkflowSources(packageDir));
+    const findings = analyzeScriptsCheck(scripts, 'package.json', packageJsonText, sources);
+    findings.sort((a, b) => a.kind.localeCompare(b.kind) || a.name.localeCompare(b.name));
+    return {
+        findings,
+        sourcesScanned: sources.map((s) => s.file),
+        error: null,
+        exitCode: findings.length > 0 ? 1 : 0,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/scripts-check/run.js.map

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

package/dist/commands/stale-ts-ignore/check.d.ts

@@ -0,0 +1,23 @@
+import ts from 'typescript';
+export declare function normalize(fileName: string): string;
+/**
+ * One real `ts.createProgram` run over `rootNames`, with `overrides`
+ * (absolute path → replacement source text) substituted in for whichever
+ * of those files it names — every other file resolves against the real
+ * filesystem via `ts.createCompilerHost`. Returns every diagnostic
+ * grouped by file and 1-based line, which is all `run.ts` ever needs:
+ * whether SOME diagnostic landed on a specific line, not its message.
+ */
+export declare function runProjectTypecheck(rootNames: string[], options: ts.CompilerOptions, overrides?: Map<string, string>): Map<string, Set<number>>;
+/**
+ * Typechecks a single piece of source IN ISOLATION, against the real
+ * package's real types on disk (relative/self-referencing imports both
+ * resolve normally) — same virtual-single-file technique as
+ * `readme-check`'s `typecheckBlock`, reused here for `.vue` files, which
+ * a plain `ts.Program` can't include in a whole-project run at all (no
+ * SFC support without pulling in `vue-tsc`'s own machinery). This misses
+ * diagnostics that would only appear from OTHER files' real usage of
+ * this one — an accepted, documented gap, same class as `readme-check`'s
+ * own isolated-block limitation.
+ */
+export declare function checkIsolatedFile(virtualFileName: string, code: string, baseOptions: ts.CompilerOptions): Set<number>;

package/dist/commands/stale-ts-ignore/check.js

@@ -0,0 +1,104 @@
+import ts from 'typescript';
+// TypeScript normalizes every file path it hands to a `CompilerHost` to
+// forward slashes internally, even on Windows — matching against a
+// `path`-built key (backslashes on win32) would silently never hit these
+// overrides. Same gotcha `readme-check`'s own `typecheck.ts` documents.
+export function normalize(fileName) {
+    return fileName.replace(/\\/g, '/');
+}
+/**
+ * One real `ts.createProgram` run over `rootNames`, with `overrides`
+ * (absolute path → replacement source text) substituted in for whichever
+ * of those files it names — every other file resolves against the real
+ * filesystem via `ts.createCompilerHost`. Returns every diagnostic
+ * grouped by file and 1-based line, which is all `run.ts` ever needs:
+ * whether SOME diagnostic landed on a specific line, not its message.
+ */
+export function runProjectTypecheck(rootNames, options, overrides) {
+    const checkOptions = { ...options, noEmit: true, skipLibCheck: true };
+    const baseHost = ts.createCompilerHost(checkOptions);
+    const host = overrides
+        ? {
+            ...baseHost,
+            getSourceFile(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile) {
+                const override = overrides.get(normalize(fileName));
+                if (override !== undefined) {
+                    const version = typeof languageVersionOrOptions === 'object'
+                        ? languageVersionOrOptions.languageVersion
+                        : languageVersionOrOptions;
+                    return ts.createSourceFile(fileName, override, version, true);
+                }
+                return baseHost.getSourceFile(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile);
+            },
+            readFile(fileName) {
+                const override = overrides.get(normalize(fileName));
+                if (override !== undefined)
+                    return override;
+                return baseHost.readFile(fileName);
+            },
+        }
+        : baseHost;
+    const program = ts.createProgram({ rootNames, options: checkOptions, host });
+    const diagnostics = ts.getPreEmitDiagnostics(program);
+    const byFile = new Map();
+    for (const d of diagnostics) {
+        if (!d.file || d.start === undefined)
+            continue;
+        const line = d.file.getLineAndCharacterOfPosition(d.start).line + 1;
+        const key = normalize(d.file.fileName);
+        let lines = byFile.get(key);
+        if (!lines) {
+            lines = new Set();
+            byFile.set(key, lines);
+        }
+        lines.add(line);
+    }
+    return byFile;
+}
+/**
+ * Typechecks a single piece of source IN ISOLATION, against the real
+ * package's real types on disk (relative/self-referencing imports both
+ * resolve normally) — same virtual-single-file technique as
+ * `readme-check`'s `typecheckBlock`, reused here for `.vue` files, which
+ * a plain `ts.Program` can't include in a whole-project run at all (no
+ * SFC support without pulling in `vue-tsc`'s own machinery). This misses
+ * diagnostics that would only appear from OTHER files' real usage of
+ * this one — an accepted, documented gap, same class as `readme-check`'s
+ * own isolated-block limitation.
+ */
+export function checkIsolatedFile(virtualFileName, code, baseOptions) {
+    const options = { ...baseOptions, noEmit: true, skipLibCheck: true };
+    const baseHost = ts.createCompilerHost(options);
+    const virtualSourceFile = ts.createSourceFile(virtualFileName, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const host = {
+        ...baseHost,
+        getSourceFile(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile) {
+            if (fileName === virtualFileName)
+                return virtualSourceFile;
+            return baseHost.getSourceFile(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile);
+        },
+        fileExists(fileName) {
+            if (fileName === virtualFileName)
+                return true;
+            return baseHost.fileExists(fileName);
+        },
+        readFile(fileName) {
+            if (fileName === virtualFileName)
+                return code;
+            return baseHost.readFile(fileName);
+        },
+        writeFile() { },
+    };
+    const program = ts.createProgram({ rootNames: [virtualFileName], options, host });
+    const diagnostics = ts
+        .getPreEmitDiagnostics(program)
+        .filter((d) => d.file?.fileName === virtualFileName);
+    const lines = new Set();
+    for (const d of diagnostics) {
+        if (d.start === undefined || !d.file)
+            continue;
+        lines.add(d.file.getLineAndCharacterOfPosition(d.start).line + 1);
+    }
+    return lines;
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/stale-ts-ignore/check.js.map

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

package/dist/commands/stale-ts-ignore/core.d.ts

@@ -0,0 +1,11 @@
+import ts from 'typescript';
+import { type Range } from '../../utils/find-comments.js';
+export interface TsIgnoreDirective {
+    /** 1-based line the `// @ts-ignore` comment itself sits on */
+    line: number;
+    /** 1-based line it's meant to suppress a diagnostic on — line + 1, unconditionally */
+    targetLine: number;
+    range: Range;
+}
+export declare function findTsIgnoreDirectives(text: string, sf: ts.SourceFile): TsIgnoreDirective[];
+export declare function blankDirectives(text: string, directives: TsIgnoreDirective[]): string;