@venizia/dev-configs 0.4.3 → 0.4.5

package/dist/checks/test-mutate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Replays the mutation proof of the trim-tests method. A ledger line says: "this test (the
+ * candidate) is redundant because that test (the survivor) already catches the same break". The
+ * replay applies the break (the mutant) to a file, runs the survivor and the candidate, and puts the
+ * file back. The survivor must go red. The candidate must go red too, unless the line says it is
+ * vacuous and a second mutant leaves it green as well.
+ *
+ * The mutant edits the file the test really loads: the package's own `src` for a test that imports
+ * through the `@/` alias, or the `dist` of the dependency for a test that reaches another package
+ * through its `exports`. A rebuild is never needed.
+ */
+export interface IMutant {
+    /** Repository-relative file to edit (a `src` file, or a `dist` file of a dependency). */
+    file: string;
+    /** Text that must occur exactly once in the file. */
+    find: string;
+    replace: string;
+}
+export interface ILedgerLine {
+    id: string;
+    /** Repository-relative test file that is deleted. */
+    candidate: string;
+    /** Run only the cases whose name matches (`bun test -t`). Default: the whole file. */
+    candidateName?: string;
+    /** Repository-relative test file that stays. */
+    survivor: string;
+    survivorName?: string;
+    /**
+     * The break. An array applies every edit together: a survivor in the package that owns the code
+     * loads its `src`, a candidate in another package loads that package's `dist`, so one break is two edits.
+     */
+    mutant: IMutant | IMutant[];
+    /** The source line the mutant stands for, `path:line`; recorded, not used by the replay. */
+    srcLine?: string;
+    /** `red` (default): the candidate must fail. `vacuous`: it must stay green under `mutant` AND `secondMutant`. */
+    expectCandidate?: 'red' | 'vacuous';
+    secondMutant?: IMutant | IMutant[];
+}
+export interface ILedger {
+    mutants: ILedgerLine[];
+}
+export interface ILedgerResult {
+    id: string;
+    survivorRed: boolean;
+    candidateRed: boolean;
+    /** Only for a `vacuous` line: whether the candidate also stayed green under the second mutant. */
+    candidateGreenUnderSecond?: boolean;
+    ok: boolean;
+    problem?: string;
+}
+/** Replays every line; never throws for a green survivor (that is a result), only for an unusable ledger. */
+export declare const replayLedger: (opts: {
+    root: string;
+    ledger: ILedger;
+    scratch?: string;
+}) => ILedgerResult[];
+export declare const formatLedgerResults: (results: ILedgerResult[]) => string[];
+//# sourceMappingURL=test-mutate.d.ts.map

package/dist/checks/test-mutate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mutate.d.ts","sourceRoot":"","sources":["../../src/checks/test-mutate.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC5B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,eAAe,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,kGAAkG;IAClG,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgJD,6GAA6G;AAC7G,eAAO,MAAM,YAAY,GAAI,MAAM;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,aAAa,EAuDhB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,SAAS,aAAa,EAAE,KAAG,MAAM,EAWpE,CAAC"}

package/dist/checks/test-mutate.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatLedgerResults = exports.replayLedger = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const TEST_TIMEOUT_MILLISECONDS = 300_000;
+/** The one place this tool builds an `Error`: `getError` would make dev-configs depend on inversion, which depends on dev-configs. */
+// eslint-disable-next-line venizia/no-new-error -- getError would be a dev-configs -> inversion cycle
+const replayError = (message) => new Error(message);
+const checksum = (bytes) => (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex');
+/** The nearest folder at or above the test file that holds a `package.json`: where `bun test` runs. */
+const packageDirectoryOf = (opts) => {
+    let current = (0, node_path_1.dirname)((0, node_path_1.join)(opts.root, opts.file));
+    for (;;) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(current, 'package.json'))) {
+            return current;
+        }
+        const parent = (0, node_path_1.dirname)(current);
+        if (parent === current || parent.length < opts.root.length) {
+            return opts.root;
+        }
+        current = parent;
+    }
+};
+/** Runs one test file (or the cases matching `name`) and reports whether it failed. */
+const runIsRed = (opts) => {
+    const directory = packageDirectoryOf({ root: opts.root, file: opts.file });
+    const target = (0, node_path_1.join)(opts.root, opts.file).slice(directory.length + 1);
+    const args = ['test', target, ...(opts.name ? ['-t', opts.name] : [])];
+    const result = (0, node_child_process_1.spawnSync)('bun', args, {
+        cwd: directory,
+        encoding: 'utf8',
+        timeout: TEST_TIMEOUT_MILLISECONDS,
+        killSignal: 'SIGKILL',
+        env: { ...process.env, NODE_ENV: 'test' },
+    });
+    if (result.error) {
+        throw replayError(`[test-mutate] could not run bun test ${target}: ${result.error.message}`);
+    }
+    // A name filter that matches nothing runs no case and exits 0: that would read as "green" and could
+    // hide a typo as a vacuous test, so a run that executed nothing is an unusable ledger line.
+    const output = `${result.stdout ?? ''}${result.stderr ?? ''}`;
+    const passed = Number(/^\s*(\d+) pass/m.exec(output)?.[1] ?? 0);
+    const failed = Number(/^\s*(\d+) fail/m.exec(output)?.[1] ?? 0);
+    if (passed + failed === 0) {
+        throw replayError(`[test-mutate] bun test ${target}${opts.name ? ` -t ${opts.name}` : ''} ran no case | check the file and the name`);
+    }
+    return result.status !== 0 || failed > 0;
+};
+/** Applies `mutant`, runs `action`, and puts the file back byte for byte, verified by checksum. */
+const withMutant = (opts) => {
+    const path = (0, node_path_1.join)(opts.root, opts.mutant.file);
+    const original = (0, node_fs_1.readFileSync)(path);
+    const text = original.toString('utf8');
+    const occurrences = text.split(opts.mutant.find).length - 1;
+    if (occurrences !== 1) {
+        throw replayError(`[test-mutate][${opts.id}] \`find\` occurs ${occurrences} times in ${opts.mutant.file}, it must occur exactly once`);
+    }
+    (0, node_fs_1.mkdirSync)(opts.scratch, { recursive: true });
+    const backup = (0, node_path_1.join)(opts.scratch, `test-mutate-${opts.id.replace(/[^\w.-]/g, '_')}.orig`);
+    if ((0, node_fs_1.existsSync)(backup)) {
+        throw replayError(`[test-mutate][${opts.id}] a backup from an interrupted run exists: ${backup} | restore ${opts.mutant.file} from it, then delete it`);
+    }
+    (0, node_fs_1.writeFileSync)(backup, original);
+    const expected = checksum(original);
+    let outcome;
+    try {
+        (0, node_fs_1.writeFileSync)(path, text.replace(opts.mutant.find, () => opts.mutant.replace));
+        outcome = { value: opts.action() };
+    }
+    catch (error) {
+        outcome = { error };
+    }
+    // Restored whatever the action did, and checked, before its result or error is passed on.
+    (0, node_fs_1.writeFileSync)(path, original);
+    if (checksum((0, node_fs_1.readFileSync)(path)) !== expected) {
+        throw replayError(`[test-mutate][${opts.id}] ${opts.mutant.file} was not restored | the backup is ${backup}`);
+    }
+    (0, node_fs_1.rmSync)(backup, { force: true });
+    if ('error' in outcome) {
+        throw outcome.error;
+    }
+    return outcome.value;
+};
+/** Applies every edit of `mutant`, runs `action`, and puts each file back byte for byte, verified by checksum. */
+const withMutants = (opts) => {
+    const edits = Array.isArray(opts.mutant) ? opts.mutant : [opts.mutant];
+    const apply = (index) => index === edits.length
+        ? opts.action()
+        : withMutant({
+            root: opts.root,
+            mutant: edits[index],
+            scratch: opts.scratch,
+            id: `${opts.id}-${index}`,
+            action: () => apply(index + 1),
+        });
+    return apply(0);
+};
+/** Replays every line; never throws for a green survivor (that is a result), only for an unusable ledger. */
+const replayLedger = (opts) => {
+    const root = (0, node_path_1.resolve)(opts.root);
+    const scratch = opts.scratch ?? (0, node_path_1.join)(root, '.agents/local/tmp');
+    const results = [];
+    for (const line of opts.ledger.mutants) {
+        const { survivorRed, candidateRed } = withMutants({
+            root,
+            mutant: line.mutant,
+            scratch,
+            id: line.id,
+            action: () => ({
+                survivorRed: runIsRed({ root, file: line.survivor, name: line.survivorName }),
+                candidateRed: runIsRed({ root, file: line.candidate, name: line.candidateName }),
+            }),
+        });
+        const result = { id: line.id, survivorRed, candidateRed, ok: true };
+        const expectation = line.expectCandidate ?? 'red';
+        if (!survivorRed) {
+            result.ok = false;
+            result.problem =
+                'the survivor stayed green under the mutant: it does not cover the behaviour';
+        }
+        else if (expectation === 'red' && !candidateRed) {
+            result.ok = false;
+            result.problem =
+                'the candidate stayed green under the mutant: record it as vacuous with a second mutant, or pick a mutant it checks';
+        }
+        else if (expectation === 'vacuous') {
+            if (!line.secondMutant) {
+                result.ok = false;
+                result.problem = 'a vacuous line needs a secondMutant';
+            }
+            else if (candidateRed) {
+                result.ok = false;
+                result.problem = 'the candidate went red under the mutant: it is not vacuous';
+            }
+            else {
+                const greenUnderSecond = !withMutants({
+                    root,
+                    mutant: line.secondMutant,
+                    scratch,
+                    id: `${line.id}-second`,
+                    action: () => runIsRed({ root, file: line.candidate, name: line.candidateName }),
+                });
+                result.candidateGreenUnderSecond = greenUnderSecond;
+                if (!greenUnderSecond) {
+                    result.ok = false;
+                    result.problem = 'the candidate went red under the second mutant: it is not vacuous';
+                }
+            }
+        }
+        results.push(result);
+    }
+    return results;
+};
+exports.replayLedger = replayLedger;
+const formatLedgerResults = (results) => {
+    const lines = results.map((result) => `${result.ok ? 'ok  ' : 'FAIL'} ${result.id}: survivor ${result.survivorRed ? 'red' : 'GREEN'}, candidate ${result.candidateRed ? 'red' : 'green'}${result.problem ? ` | ${result.problem}` : ''}`);
+    const failed = results.filter((result) => !result.ok).length;
+    lines.push(`\n[test-mutate] ${results.length - failed}/${results.length} ledger lines hold${failed ? `, ${failed} do not` : ''}.`);
+    return lines;
+};
+exports.formatLedgerResults = formatLedgerResults;
+//# sourceMappingURL=test-mutate.js.map

package/dist/checks/test-mutate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mutate.js","sourceRoot":"","sources":["../../src/checks/test-mutate.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { createHash } from 'node:crypto';\nimport { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\n\n/**\n * Replays the mutation proof of the trim-tests method. A ledger line says: \"this test (the\n * candidate) is redundant because that test (the survivor) already catches the same break\". The\n * replay applies the break (the mutant) to a file, runs the survivor and the candidate, and puts the\n * file back. The survivor must go red. The candidate must go red too, unless the line says it is\n * vacuous and a second mutant leaves it green as well.\n *\n * The mutant edits the file the test really loads: the package's own `src` for a test that imports\n * through the `@/` alias, or the `dist` of the dependency for a test that reaches another package\n * through its `exports`. A rebuild is never needed.\n */\nexport interface IMutant {\n  /** Repository-relative file to edit (a `src` file, or a `dist` file of a dependency). */\n  file: string;\n  /** Text that must occur exactly once in the file. */\n  find: string;\n  replace: string;\n}\n\nexport interface ILedgerLine {\n  id: string;\n  /** Repository-relative test file that is deleted. */\n  candidate: string;\n  /** Run only the cases whose name matches (`bun test -t`). Default: the whole file. */\n  candidateName?: string;\n  /** Repository-relative test file that stays. */\n  survivor: string;\n  survivorName?: string;\n  /**\n   * The break. An array applies every edit together: a survivor in the package that owns the code\n   * loads its `src`, a candidate in another package loads that package's `dist`, so one break is two edits.\n   */\n  mutant: IMutant | IMutant[];\n  /** The source line the mutant stands for, `path:line`; recorded, not used by the replay. */\n  srcLine?: string;\n  /** `red` (default): the candidate must fail. `vacuous`: it must stay green under `mutant` AND `secondMutant`. */\n  expectCandidate?: 'red' | 'vacuous';\n  secondMutant?: IMutant | IMutant[];\n}\n\nexport interface ILedger {\n  mutants: ILedgerLine[];\n}\n\nexport interface ILedgerResult {\n  id: string;\n  survivorRed: boolean;\n  candidateRed: boolean;\n  /** Only for a `vacuous` line: whether the candidate also stayed green under the second mutant. */\n  candidateGreenUnderSecond?: boolean;\n  ok: boolean;\n  problem?: string;\n}\n\nconst TEST_TIMEOUT_MILLISECONDS = 300_000;\n\n/** The one place this tool builds an `Error`: `getError` would make dev-configs depend on inversion, which depends on dev-configs. */\n// eslint-disable-next-line venizia/no-new-error -- getError would be a dev-configs -> inversion cycle\nconst replayError = (message: string): Error => new Error(message);\n\nconst checksum = (bytes: Buffer): string => createHash('sha256').update(bytes).digest('hex');\n\n/** The nearest folder at or above the test file that holds a `package.json`: where `bun test` runs. */\nconst packageDirectoryOf = (opts: { root: string; file: string }): string => {\n  let current = dirname(join(opts.root, opts.file));\n\n  for (;;) {\n    if (existsSync(join(current, 'package.json'))) {\n      return current;\n    }\n\n    const parent = dirname(current);\n    if (parent === current || parent.length < opts.root.length) {\n      return opts.root;\n    }\n\n    current = parent;\n  }\n};\n\n/** Runs one test file (or the cases matching `name`) and reports whether it failed. */\nconst runIsRed = (opts: { root: string; file: string; name?: string }): boolean => {\n  const directory = packageDirectoryOf({ root: opts.root, file: opts.file });\n  const target = join(opts.root, opts.file).slice(directory.length + 1);\n  const args = ['test', target, ...(opts.name ? ['-t', opts.name] : [])];\n  const result = spawnSync('bun', args, {\n    cwd: directory,\n    encoding: 'utf8',\n    timeout: TEST_TIMEOUT_MILLISECONDS,\n    killSignal: 'SIGKILL',\n    env: { ...process.env, NODE_ENV: 'test' },\n  });\n\n  if (result.error) {\n    throw replayError(`[test-mutate] could not run bun test ${target}: ${result.error.message}`);\n  }\n\n  // A name filter that matches nothing runs no case and exits 0: that would read as \"green\" and could\n  // hide a typo as a vacuous test, so a run that executed nothing is an unusable ledger line.\n  const output = `${result.stdout ?? ''}${result.stderr ?? ''}`;\n  const passed = Number(/^\\s*(\\d+) pass/m.exec(output)?.[1] ?? 0);\n  const failed = Number(/^\\s*(\\d+) fail/m.exec(output)?.[1] ?? 0);\n\n  if (passed + failed === 0) {\n    throw replayError(\n      `[test-mutate] bun test ${target}${opts.name ? ` -t ${opts.name}` : ''} ran no case | check the file and the name`,\n    );\n  }\n\n  return result.status !== 0 || failed > 0;\n};\n\n/** Applies `mutant`, runs `action`, and puts the file back byte for byte, verified by checksum. */\nconst withMutant = <T>(opts: {\n  root: string;\n  mutant: IMutant;\n  scratch: string;\n  id: string;\n  action: () => T;\n}): T => {\n  const path = join(opts.root, opts.mutant.file);\n  const original = readFileSync(path);\n  const text = original.toString('utf8');\n  const occurrences = text.split(opts.mutant.find).length - 1;\n\n  if (occurrences !== 1) {\n    throw replayError(\n      `[test-mutate][${opts.id}] \\`find\\` occurs ${occurrences} times in ${opts.mutant.file}, it must occur exactly once`,\n    );\n  }\n\n  mkdirSync(opts.scratch, { recursive: true });\n  const backup = join(opts.scratch, `test-mutate-${opts.id.replace(/[^\\w.-]/g, '_')}.orig`);\n  if (existsSync(backup)) {\n    throw replayError(\n      `[test-mutate][${opts.id}] a backup from an interrupted run exists: ${backup} | restore ${opts.mutant.file} from it, then delete it`,\n    );\n  }\n\n  writeFileSync(backup, original);\n  const expected = checksum(original);\n\n  let outcome: { value: T } | { error: unknown };\n\n  try {\n    writeFileSync(\n      path,\n      text.replace(opts.mutant.find, () => opts.mutant.replace),\n    );\n    outcome = { value: opts.action() };\n  } catch (error) {\n    outcome = { error };\n  }\n\n  // Restored whatever the action did, and checked, before its result or error is passed on.\n  writeFileSync(path, original);\n\n  if (checksum(readFileSync(path)) !== expected) {\n    throw replayError(\n      `[test-mutate][${opts.id}] ${opts.mutant.file} was not restored | the backup is ${backup}`,\n    );\n  }\n\n  rmSync(backup, { force: true });\n\n  if ('error' in outcome) {\n    throw outcome.error;\n  }\n\n  return outcome.value;\n};\n\n/** Applies every edit of `mutant`, runs `action`, and puts each file back byte for byte, verified by checksum. */\nconst withMutants = <T>(opts: {\n  root: string;\n  mutant: IMutant | IMutant[];\n  scratch: string;\n  id: string;\n  action: () => T;\n}): T => {\n  const edits = Array.isArray(opts.mutant) ? opts.mutant : [opts.mutant];\n\n  const apply = (index: number): T =>\n    index === edits.length\n      ? opts.action()\n      : withMutant({\n          root: opts.root,\n          mutant: edits[index],\n          scratch: opts.scratch,\n          id: `${opts.id}-${index}`,\n          action: () => apply(index + 1),\n        });\n\n  return apply(0);\n};\n\n/** Replays every line; never throws for a green survivor (that is a result), only for an unusable ledger. */\nexport const replayLedger = (opts: {\n  root: string;\n  ledger: ILedger;\n  scratch?: string;\n}): ILedgerResult[] => {\n  const root = resolve(opts.root);\n  const scratch = opts.scratch ?? join(root, '.agents/local/tmp');\n  const results: ILedgerResult[] = [];\n\n  for (const line of opts.ledger.mutants) {\n    const { survivorRed, candidateRed } = withMutants({\n      root,\n      mutant: line.mutant,\n      scratch,\n      id: line.id,\n      action: () => ({\n        survivorRed: runIsRed({ root, file: line.survivor, name: line.survivorName }),\n        candidateRed: runIsRed({ root, file: line.candidate, name: line.candidateName }),\n      }),\n    });\n    const result: ILedgerResult = { id: line.id, survivorRed, candidateRed, ok: true };\n    const expectation = line.expectCandidate ?? 'red';\n\n    if (!survivorRed) {\n      result.ok = false;\n      result.problem =\n        'the survivor stayed green under the mutant: it does not cover the behaviour';\n    } else if (expectation === 'red' && !candidateRed) {\n      result.ok = false;\n      result.problem =\n        'the candidate stayed green under the mutant: record it as vacuous with a second mutant, or pick a mutant it checks';\n    } else if (expectation === 'vacuous') {\n      if (!line.secondMutant) {\n        result.ok = false;\n        result.problem = 'a vacuous line needs a secondMutant';\n      } else if (candidateRed) {\n        result.ok = false;\n        result.problem = 'the candidate went red under the mutant: it is not vacuous';\n      } else {\n        const greenUnderSecond = !withMutants({\n          root,\n          mutant: line.secondMutant,\n          scratch,\n          id: `${line.id}-second`,\n          action: () => runIsRed({ root, file: line.candidate, name: line.candidateName }),\n        });\n        result.candidateGreenUnderSecond = greenUnderSecond;\n\n        if (!greenUnderSecond) {\n          result.ok = false;\n          result.problem = 'the candidate went red under the second mutant: it is not vacuous';\n        }\n      }\n    }\n\n    results.push(result);\n  }\n\n  return results;\n};\n\nexport const formatLedgerResults = (results: ILedgerResult[]): string[] => {\n  const lines = results.map(\n    (result) =>\n      `${result.ok ? 'ok  ' : 'FAIL'} ${result.id}: survivor ${result.survivorRed ? 'red' : 'GREEN'}, candidate ${result.candidateRed ? 'red' : 'green'}${result.problem ? ` | ${result.problem}` : ''}`,\n  );\n  const failed = results.filter((result) => !result.ok).length;\n  lines.push(\n    `\\n[test-mutate] ${results.length - failed}/${results.length} ledger lines hold${failed ? `, ${failed} do not` : ''}.`,\n  );\n\n  return lines;\n};\n"]}

package/dist/checks/test-weight.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Reads the JUnit report of `bun test --reporter=junit` and says where the test time and the test
+ * count are: per file, per package, the heaviest files, duplicates by name, files that assert nothing,
+ * and skips. The first step of the trim-tests method (`.agents/knowledge/process/trimming-tests.md`).
+ *
+ * The numbers are only as good as the run that made them: a `--parallel` run times each file under
+ * contention, so a file that takes 7 s there can take 1 s alone. Re-time a suspect file alone.
+ */
+export interface ITestWeightInput {
+    /** Names the report in the output: the package. */
+    label: string;
+    xml: string;
+}
+export interface ITestFileWeight {
+    label: string;
+    file: string;
+    milliseconds: number;
+    cases: number;
+    assertions: number;
+    skipped: number;
+    slowestCase: string;
+    slowestMilliseconds: number;
+}
+export interface ITestWeightReport {
+    files: ITestFileWeight[];
+    totalMilliseconds: number;
+    totalCases: number;
+    totalAssertions: number;
+    totalSkipped: number;
+    perLabel: Array<{
+        label: string;
+        files: number;
+        cases: number;
+        milliseconds: number;
+    }>;
+    /** Heaviest first. */
+    heaviest: ITestFileWeight[];
+    /** How many of the heaviest files hold 80% of the time. */
+    filesFor80Percent: number;
+    /** Files that take under 100 ms, and what they cost together. */
+    lightFiles: {
+        count: number;
+        milliseconds: number;
+    };
+    /** The same suite and case name in more than one file. */
+    sameNameAcrossFiles: Array<{
+        name: string;
+        files: string[];
+    }>;
+    zeroAssertionFiles: string[];
+    skippedFiles: Array<{
+        file: string;
+        skipped: number;
+    }>;
+}
+export declare const analyseJunit: (opts: {
+    reports: ITestWeightInput[];
+}) => ITestWeightReport;
+/** The report as the lines `devz check test-weight` prints. */
+export declare const formatTestWeight: (opts: {
+    report: ITestWeightReport;
+    top?: number;
+}) => string[];
+//# sourceMappingURL=test-weight.d.ts.map

package/dist/checks/test-weight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-weight.d.ts","sourceRoot":"","sources":["../../src/checks/test-weight.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,sBAAsB;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,0DAA0D;IAC1D,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC9D,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AA+BD,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,KAAG,iBAqFpE,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,GAAI,MAAM;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,EAoC1F,CAAC"}

package/dist/checks/test-weight.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTestWeight = exports.analyseJunit = void 0;
+const ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+};
+const decodeEntities = (text) => text.replace(/&(#x[0-9a-fA-F]+|#\d+|[a-z]+);/g, (whole, body) => {
+    if (body.startsWith('#x')) {
+        return String.fromCodePoint(Number.parseInt(body.slice(2), 16));
+    }
+    if (body.startsWith('#')) {
+        return String.fromCodePoint(Number.parseInt(body.slice(1), 10));
+    }
+    return ENTITIES[body] ?? whole;
+});
+/** Bun writes a file as a top-level suite whose `name` equals its `file`. */
+const FILE_SUITE = /<testsuite name="([^"]+\.(?:test|spec)\.[cm]?[jt]sx?)" file="[^"]+" tests="(\d+)" assertions="(\d+)" failures="\d+" skipped="(\d+)" time="([\d.eE+-]+)"/g;
+const CASE = /<testcase name="([^"]*)" classname="([^"]*)" time="([\d.eE+-]+)" file="([^"]+)"/g;
+const LIGHT_FILE_MILLISECONDS = 100;
+const HEAVY_SHARE = 0.8;
+const analyseJunit = (opts) => {
+    const files = [];
+    const names = new Map();
+    for (const { label, xml } of opts.reports) {
+        const start = files.length;
+        for (const match of xml.matchAll(FILE_SUITE)) {
+            files.push({
+                label,
+                file: match[1],
+                milliseconds: Number(match[5]) * 1000,
+                cases: Number(match[2]),
+                assertions: Number(match[3]),
+                skipped: Number(match[4]),
+                slowestCase: '',
+                slowestMilliseconds: 0,
+            });
+        }
+        const byFile = new Map(files.slice(start).map((entry) => [entry.file, entry]));
+        for (const match of xml.matchAll(CASE)) {
+            const caseName = decodeEntities(match[1]);
+            const suiteName = decodeEntities(match[2]);
+            const entry = byFile.get(match[4]);
+            const milliseconds = Number(match[3]) * 1000;
+            if (entry && milliseconds > entry.slowestMilliseconds) {
+                entry.slowestMilliseconds = milliseconds;
+                entry.slowestCase = caseName;
+            }
+            const key = `${suiteName} > ${caseName}`;
+            const where = names.get(key) ?? new Set();
+            where.add(`${label}/${match[4]}`);
+            names.set(key, where);
+        }
+    }
+    const heaviest = [...files].sort((left, right) => right.milliseconds - left.milliseconds);
+    const totalMilliseconds = files.reduce((sum, entry) => sum + entry.milliseconds, 0);
+    let accumulated = 0;
+    let filesFor80Percent = 0;
+    for (const entry of heaviest) {
+        accumulated += entry.milliseconds;
+        filesFor80Percent += 1;
+        if (accumulated >= totalMilliseconds * HEAVY_SHARE) {
+            break;
+        }
+    }
+    const light = files.filter((entry) => entry.milliseconds < LIGHT_FILE_MILLISECONDS);
+    const labels = [...new Set(files.map((entry) => entry.label))];
+    return {
+        files,
+        totalMilliseconds,
+        totalCases: files.reduce((sum, entry) => sum + entry.cases, 0),
+        totalAssertions: files.reduce((sum, entry) => sum + entry.assertions, 0),
+        totalSkipped: files.reduce((sum, entry) => sum + entry.skipped, 0),
+        perLabel: labels.map((label) => {
+            const own = files.filter((entry) => entry.label === label);
+            return {
+                label,
+                files: own.length,
+                cases: own.reduce((sum, entry) => sum + entry.cases, 0),
+                milliseconds: own.reduce((sum, entry) => sum + entry.milliseconds, 0),
+            };
+        }),
+        heaviest,
+        filesFor80Percent,
+        lightFiles: {
+            count: light.length,
+            milliseconds: light.reduce((sum, entry) => sum + entry.milliseconds, 0),
+        },
+        sameNameAcrossFiles: [...names.entries()]
+            .filter(([, where]) => where.size > 1)
+            .map(([name, where]) => ({ name, files: [...where].sort() })),
+        zeroAssertionFiles: files.filter((entry) => entry.assertions === 0).map((entry) => entry.file),
+        skippedFiles: files
+            .filter((entry) => entry.skipped > 0)
+            .map((entry) => ({ file: `${entry.label}/${entry.file}`, skipped: entry.skipped })),
+    };
+};
+exports.analyseJunit = analyseJunit;
+/** The report as the lines `devz check test-weight` prints. */
+const formatTestWeight = (opts) => {
+    const { report, top = 25 } = opts;
+    const seconds = (milliseconds) => (milliseconds / 1000).toFixed(1);
+    const lines = [
+        `files ${report.files.length} | cases ${report.totalCases} | assertions ${report.totalAssertions} | skipped ${report.totalSkipped} | sum of file times ${seconds(report.totalMilliseconds)} s`,
+    ];
+    for (const row of report.perLabel) {
+        lines.push(`  ${row.label.padEnd(14)} files ${String(row.files).padStart(4)} cases ${String(row.cases).padStart(5)} time ${seconds(row.milliseconds).padStart(7)} s`);
+    }
+    lines.push('', `heaviest ${top} files:`);
+    for (const entry of report.heaviest.slice(0, top)) {
+        lines.push(`${entry.milliseconds.toFixed(0).padStart(8)} ms ${String(entry.cases).padStart(5)} cases  slowest ${entry.slowestMilliseconds.toFixed(0).padStart(7)} ms  ${entry.label}/${entry.file}`);
+    }
+    lines.push('', `80% of the time is in the ${report.filesFor80Percent} heaviest files of ${report.files.length}`, `files under ${LIGHT_FILE_MILLISECONDS} ms: ${report.lightFiles.count}, together ${seconds(report.lightFiles.milliseconds)} s`, `same suite and case name in more than one file: ${report.sameNameAcrossFiles.length}`);
+    for (const duplicate of report.sameNameAcrossFiles.slice(0, 10)) {
+        lines.push(`  ${duplicate.name.slice(0, 90)} -> ${duplicate.files.join(', ')}`);
+    }
+    lines.push(`files with 0 assertions: ${report.zeroAssertionFiles.length}${report.zeroAssertionFiles.length ? ` (${report.zeroAssertionFiles.slice(0, 3).join(', ')})` : ''}`, `files with skipped cases: ${report.skippedFiles.length} (${report.skippedFiles.reduce((sum, entry) => sum + entry.skipped, 0)} cases)`);
+    return lines;
+};
+exports.formatTestWeight = formatTestWeight;
+//# sourceMappingURL=test-weight.js.map

package/dist/checks/test-weight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-weight.js","sourceRoot":"","sources":["../../src/checks/test-weight.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Reads the JUnit report of `bun test --reporter=junit` and says where the test time and the test\n * count are: per file, per package, the heaviest files, duplicates by name, files that assert nothing,\n * and skips. The first step of the trim-tests method (`.agents/knowledge/process/trimming-tests.md`).\n *\n * The numbers are only as good as the run that made them: a `--parallel` run times each file under\n * contention, so a file that takes 7 s there can take 1 s alone. Re-time a suspect file alone.\n */\nexport interface ITestWeightInput {\n  /** Names the report in the output: the package. */\n  label: string;\n  xml: string;\n}\n\nexport interface ITestFileWeight {\n  label: string;\n  file: string;\n  milliseconds: number;\n  cases: number;\n  assertions: number;\n  skipped: number;\n  slowestCase: string;\n  slowestMilliseconds: number;\n}\n\nexport interface ITestWeightReport {\n  files: ITestFileWeight[];\n  totalMilliseconds: number;\n  totalCases: number;\n  totalAssertions: number;\n  totalSkipped: number;\n  perLabel: Array<{ label: string; files: number; cases: number; milliseconds: number }>;\n  /** Heaviest first. */\n  heaviest: ITestFileWeight[];\n  /** How many of the heaviest files hold 80% of the time. */\n  filesFor80Percent: number;\n  /** Files that take under 100 ms, and what they cost together. */\n  lightFiles: { count: number; milliseconds: number };\n  /** The same suite and case name in more than one file. */\n  sameNameAcrossFiles: Array<{ name: string; files: string[] }>;\n  zeroAssertionFiles: string[];\n  skippedFiles: Array<{ file: string; skipped: number }>;\n}\n\nconst ENTITIES: Record<string, string> = {\n  amp: '&',\n  lt: '<',\n  gt: '>',\n  quot: '\"',\n  apos: \"'\",\n};\n\nconst decodeEntities = (text: string): string =>\n  text.replace(/&(#x[0-9a-fA-F]+|#\\d+|[a-z]+);/g, (whole, body: string) => {\n    if (body.startsWith('#x')) {\n      return String.fromCodePoint(Number.parseInt(body.slice(2), 16));\n    }\n\n    if (body.startsWith('#')) {\n      return String.fromCodePoint(Number.parseInt(body.slice(1), 10));\n    }\n\n    return ENTITIES[body] ?? whole;\n  });\n\n/** Bun writes a file as a top-level suite whose `name` equals its `file`. */\nconst FILE_SUITE =\n  /<testsuite name=\"([^\"]+\\.(?:test|spec)\\.[cm]?[jt]sx?)\" file=\"[^\"]+\" tests=\"(\\d+)\" assertions=\"(\\d+)\" failures=\"\\d+\" skipped=\"(\\d+)\" time=\"([\\d.eE+-]+)\"/g;\nconst CASE = /<testcase name=\"([^\"]*)\" classname=\"([^\"]*)\" time=\"([\\d.eE+-]+)\" file=\"([^\"]+)\"/g;\n\nconst LIGHT_FILE_MILLISECONDS = 100;\nconst HEAVY_SHARE = 0.8;\n\nexport const analyseJunit = (opts: { reports: ITestWeightInput[] }): ITestWeightReport => {\n  const files: ITestFileWeight[] = [];\n  const names = new Map<string, Set<string>>();\n\n  for (const { label, xml } of opts.reports) {\n    const start = files.length;\n\n    for (const match of xml.matchAll(FILE_SUITE)) {\n      files.push({\n        label,\n        file: match[1],\n        milliseconds: Number(match[5]) * 1000,\n        cases: Number(match[2]),\n        assertions: Number(match[3]),\n        skipped: Number(match[4]),\n        slowestCase: '',\n        slowestMilliseconds: 0,\n      });\n    }\n\n    const byFile = new Map(files.slice(start).map((entry) => [entry.file, entry]));\n    for (const match of xml.matchAll(CASE)) {\n      const caseName = decodeEntities(match[1]);\n      const suiteName = decodeEntities(match[2]);\n      const entry = byFile.get(match[4]);\n      const milliseconds = Number(match[3]) * 1000;\n\n      if (entry && milliseconds > entry.slowestMilliseconds) {\n        entry.slowestMilliseconds = milliseconds;\n        entry.slowestCase = caseName;\n      }\n\n      const key = `${suiteName} > ${caseName}`;\n      const where = names.get(key) ?? new Set<string>();\n      where.add(`${label}/${match[4]}`);\n      names.set(key, where);\n    }\n  }\n\n  const heaviest = [...files].sort((left, right) => right.milliseconds - left.milliseconds);\n  const totalMilliseconds = files.reduce((sum, entry) => sum + entry.milliseconds, 0);\n\n  let accumulated = 0;\n  let filesFor80Percent = 0;\n  for (const entry of heaviest) {\n    accumulated += entry.milliseconds;\n    filesFor80Percent += 1;\n\n    if (accumulated >= totalMilliseconds * HEAVY_SHARE) {\n      break;\n    }\n  }\n\n  const light = files.filter((entry) => entry.milliseconds < LIGHT_FILE_MILLISECONDS);\n  const labels = [...new Set(files.map((entry) => entry.label))];\n\n  return {\n    files,\n    totalMilliseconds,\n    totalCases: files.reduce((sum, entry) => sum + entry.cases, 0),\n    totalAssertions: files.reduce((sum, entry) => sum + entry.assertions, 0),\n    totalSkipped: files.reduce((sum, entry) => sum + entry.skipped, 0),\n    perLabel: labels.map((label) => {\n      const own = files.filter((entry) => entry.label === label);\n      return {\n        label,\n        files: own.length,\n        cases: own.reduce((sum, entry) => sum + entry.cases, 0),\n        milliseconds: own.reduce((sum, entry) => sum + entry.milliseconds, 0),\n      };\n    }),\n    heaviest,\n    filesFor80Percent,\n    lightFiles: {\n      count: light.length,\n      milliseconds: light.reduce((sum, entry) => sum + entry.milliseconds, 0),\n    },\n    sameNameAcrossFiles: [...names.entries()]\n      .filter(([, where]) => where.size > 1)\n      .map(([name, where]) => ({ name, files: [...where].sort() })),\n    zeroAssertionFiles: files.filter((entry) => entry.assertions === 0).map((entry) => entry.file),\n    skippedFiles: files\n      .filter((entry) => entry.skipped > 0)\n      .map((entry) => ({ file: `${entry.label}/${entry.file}`, skipped: entry.skipped })),\n  };\n};\n\n/** The report as the lines `devz check test-weight` prints. */\nexport const formatTestWeight = (opts: { report: ITestWeightReport; top?: number }): string[] => {\n  const { report, top = 25 } = opts;\n  const seconds = (milliseconds: number): string => (milliseconds / 1000).toFixed(1);\n  const lines: string[] = [\n    `files ${report.files.length} | cases ${report.totalCases} | assertions ${report.totalAssertions} | skipped ${report.totalSkipped} | sum of file times ${seconds(report.totalMilliseconds)} s`,\n  ];\n\n  for (const row of report.perLabel) {\n    lines.push(\n      `  ${row.label.padEnd(14)} files ${String(row.files).padStart(4)} cases ${String(row.cases).padStart(5)} time ${seconds(row.milliseconds).padStart(7)} s`,\n    );\n  }\n\n  lines.push('', `heaviest ${top} files:`);\n  for (const entry of report.heaviest.slice(0, top)) {\n    lines.push(\n      `${entry.milliseconds.toFixed(0).padStart(8)} ms ${String(entry.cases).padStart(5)} cases  slowest ${entry.slowestMilliseconds.toFixed(0).padStart(7)} ms  ${entry.label}/${entry.file}`,\n    );\n  }\n\n  lines.push(\n    '',\n    `80% of the time is in the ${report.filesFor80Percent} heaviest files of ${report.files.length}`,\n    `files under ${LIGHT_FILE_MILLISECONDS} ms: ${report.lightFiles.count}, together ${seconds(report.lightFiles.milliseconds)} s`,\n    `same suite and case name in more than one file: ${report.sameNameAcrossFiles.length}`,\n  );\n  for (const duplicate of report.sameNameAcrossFiles.slice(0, 10)) {\n    lines.push(`  ${duplicate.name.slice(0, 90)} -> ${duplicate.files.join(', ')}`);\n  }\n\n  lines.push(\n    `files with 0 assertions: ${report.zeroAssertionFiles.length}${report.zeroAssertionFiles.length ? ` (${report.zeroAssertionFiles.slice(0, 3).join(', ')})` : ''}`,\n    `files with skipped cases: ${report.skippedFiles.length} (${report.skippedFiles.reduce((sum, entry) => sum + entry.skipped, 0)} cases)`,\n  );\n\n  return lines;\n};\n"]}

package/dist/cli/check.d.ts

@@ -0,0 +1,14 @@
+/** `devz check <name>`: runs one of the shared repository gates in the current folder. */
+export declare class CheckCommand {
+    private static runTestWeight;
+    private static runTestDeadCode;
+    private static runTestMutate;
+    private static runTestControls;
+    private static runSplitReport;
+    private static runCatalog;
+    static run(opts: {
+        root: string;
+        args?: string[];
+    }): Promise<number>;
+}
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"AAwIA,0FAA0F;AAC1F,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,aAAa;IA8B5B,OAAO,CAAC,MAAM,CAAC,eAAe;IAqB9B,OAAO,CAAC,MAAM,CAAC,aAAa;mBA2BP,eAAe;IAmCpC,OAAO,CAAC,MAAM,CAAC,cAAc;mBAkBR,UAAU;WAsClB,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAiG3E"}