@venizia/dev-configs 0.4.6 → 0.4.7-1

package/dist/checks/purity/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/checks/purity/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { buildManifest } from './manifest';\nimport type { IPurityClaim, IPurityEntry, IPurityOptions } from './manifest';\nimport { probeEntry } from './probe';\nimport type { IPurityResult } from './probe';\n\n/** The outcome of one row, as the text report and the JSON verdict both name it. */\nexport class PurityVerdicts {\n  static readonly PASS = 'pass';\n  static readonly FAIL = 'fail';\n  static readonly WAIVED = 'waived';\n  static readonly MISSING = 'missing';\n  static readonly STALE_WAIVER = 'stale-waiver';\n\n  static readonly SCHEME_SET = new Set<string>([\n    this.PASS,\n    this.FAIL,\n    this.WAIVED,\n    this.MISSING,\n    this.STALE_WAIVER,\n  ]);\n\n  static isValid(value: string): value is TPurityVerdict {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\nexport type TPurityVerdict = Extract<(typeof PurityVerdicts)[keyof typeof PurityVerdicts], string>;\n\n/** One row of the `--json` verdict: nothing machine- or time-specific, so two runs on one commit diff empty. */\nexport interface IPurityRowVerdict {\n  label: string;\n  entry: string;\n  verdict: TPurityVerdict;\n  sizeBytes?: number;\n  builtins?: string[];\n  globals?: string[];\n  guardedGlobals?: string[];\n  external?: string[];\n  buildError?: string;\n}\n\nexport interface IPurityReport {\n  rows: IPurityRowVerdict[];\n  failed: number;\n  waived: number;\n  checked: number;\n}\n\nconst formatList = (values: string[]): string => values.join(', ') || 'none';\n\n/**\n * Probes every row of the claims and returns the report. `print` receives the human report line by\n * line, in the exact shape the repository scripts printed before the engine moved here.\n */\nexport const checkPurity = async (opts: {\n  root: string;\n  claims: IPurityClaim[];\n  options?: IPurityOptions;\n  /** Only the rows of this package; a token that matches nothing is a broken gate and returns `undefined`. */\n  filter?: string;\n  /** The claims file, repository-relative, named in the hint printed for a stale waiver. */\n  claimsFile: string;\n  print: (line: string) => void;\n  /** Where the no-match message goes (stderr for the command): it is an error, not a report line. */\n  printError: (line: string) => void;\n}): Promise<IPurityReport | undefined> => {\n  const { root, claims, options, filter, claimsFile, print, printError } = opts;\n  const manifest = buildManifest({ claims, root, options });\n  const rows: IPurityEntry[] = filter ? manifest.filter((row) => row.package === filter) : manifest;\n\n  // Non-zero, not a friendly note: a mistyped `package` or a renamed directory would otherwise turn\n  // a release-blocking gate into a silent no-op that still reports success.\n  if (rows.length === 0) {\n    const known = [...new Set(manifest.map((row) => row.package))].sort().join(', ');\n    printError(\n      `[purity] No manifest entry matches \"${filter}\" | Known packages: ${known} - a filter that ` +\n        `matches nothing is a broken gate, not an empty one.`,\n    );\n    return undefined;\n  }\n\n  const labelWidth = Math.max(...rows.map((row) => row.label.length));\n  const verdicts: IPurityRowVerdict[] = [];\n  let failed = 0;\n  let waived = 0;\n\n  for (const row of rows) {\n    const entry = join(root, row.entry);\n\n    // The `exports` map is the source of these rows, so a missing file is either an unbuilt package\n    // or a manifest pointing at something the build never emits - both fatal, and neither is worth\n    // reporting as a bundler error twenty lines long.\n    if (!existsSync(entry)) {\n      failed += 1;\n      print(`  ✗ ${row.label.padEnd(labelWidth)} MISSING ${row.entry}`);\n      print(\n        `    The package's \\`exports\\` map points here and nothing is built - run \\`make ${row.package}\\``,\n      );\n      verdicts.push({ label: row.label, entry: row.entry, verdict: PurityVerdicts.MISSING });\n      continue;\n    }\n\n    const result: IPurityResult = await probeEntry({\n      entry,\n      cwd: root,\n      external: row.external,\n    });\n\n    const detail = {\n      label: row.label,\n      entry: row.entry,\n      sizeBytes: result.sizeBytes,\n      builtins: result.builtins,\n      globals: result.globals,\n      guardedGlobals: result.guardedGlobals,\n      external: result.external,\n      // The bundler's message names absolute paths; the verdict must read the same on any machine.\n      ...(result.buildError ? { buildError: result.buildError.replaceAll(root, '<root>') } : {}),\n    };\n\n    // Guarded reads are printed on the passing path too: they are safe, but a reviewer needs to\n    // see that the entry is clean by construction and not merely by the shape of one expression.\n    const guarded =\n      result.guardedGlobals.length > 0 ? ` | guarded: ${result.guardedGlobals.join(', ')}` : '';\n\n    // Same reasoning as `guarded`, printed on both paths: an entry that externalises a dependency\n    // measures less than one that does not, and that must stay visible next to the verdict.\n    const external = result.external.length > 0 ? ` | external: ${result.external.join(', ')}` : '';\n\n    // Checked before the normal verdict, because for a waived row the two outcomes swap meaning.\n    if (row.expectImpure) {\n      // A waived entry that comes back pure fails: the waiver now describes something untrue, and\n      // the reader who trusts it next will be trusting it about a different entry.\n      if (result.ok) {\n        failed += 1;\n        print(`  ✗ ${row.label.padEnd(labelWidth)} STALE WAIVER - this entry is browser-pure now`);\n        print(`    Drop it from \\`impure\\` in ${claimsFile} so the gate measures it again`);\n        verdicts.push({ ...detail, verdict: PurityVerdicts.STALE_WAIVER });\n        continue;\n      }\n\n      waived += 1;\n      print(\n        `  ~ ${row.label.padEnd(labelWidth)} waived | builtins: ${formatList(result.builtins)} | globals: ${formatList(result.globals)}${external}`,\n      );\n      verdicts.push({ ...detail, verdict: PurityVerdicts.WAIVED });\n      continue;\n    }\n\n    if (result.ok) {\n      print(\n        `  ✓ ${row.label.padEnd(labelWidth)} ${(result.sizeBytes / 1024).toFixed(1)} KB${guarded}${external}`,\n      );\n      verdicts.push({ ...detail, verdict: PurityVerdicts.PASS });\n      continue;\n    }\n\n    failed += 1;\n    print(\n      `  ✗ ${row.label.padEnd(labelWidth)} builtins: ${formatList(result.builtins)} | globals: ${formatList(result.globals)}${guarded}${external}`,\n    );\n    if (result.buildError) {\n      print(`    ${result.buildError.split('\\n')[0]}`);\n    }\n    verdicts.push({ ...detail, verdict: PurityVerdicts.FAIL });\n  }\n\n  const note = waived > 0 ? ` (${waived} waived as known-impure)` : '';\n\n  if (failed > 0) {\n    print(`\\n[purity] ${failed}/${rows.length} entries are not browser-pure${note}.`);\n  } else {\n    const checked = rows.length - waived;\n    print(`\\n[purity] ${checked}/${checked} entries are browser-pure${note}.`);\n  }\n\n  return { rows: verdicts, failed, waived, checked: rows.length - waived };\n};\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/checks/purity/run.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,yCAAiC;AACjC,yCAA4C;AAE5C,mCAAsC;AAGtC,oFAAoF;AACpF,MAAa,cAAc;aACT,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aACd,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,YAAY;KAClB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAjBH,wCAkBC;AAwBD,MAAM,UAAU,GAAG,CAAC,MAAgB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;AAE7E,MAAa,WAAW;IACtB;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAWhB;QACC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAC9E,MAAM,QAAQ,GAAG,yBAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,MAAM,IAAI,GAAmB,MAAM;YACjC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC;YAClD,CAAC,CAAC,QAAQ,CAAC;QAEb,kGAAkG;QAClG,0EAA0E;QAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjF,UAAU,CACR,uCAAuC,MAAM,uBAAuB,KAAK,mBAAmB;gBAC1F,qDAAqD,CACxD,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAEpC,gGAAgG;YAChG,+FAA+F;YAC/F,kDAAkD;YAClD,IAAI,CAAC,IAAA,oBAAU,EAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,CAAC;gBACZ,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;gBAClE,KAAK,CACH,mFAAmF,GAAG,CAAC,OAAO,IAAI,CACnG,CAAC;gBACF,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvF,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAkB,MAAM,mBAAW,CAAC,UAAU,CAAC;gBACzD,KAAK;gBACL,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,6FAA6F;gBAC7F,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3F,CAAC;YAEF,4FAA4F;YAC5F,6FAA6F;YAC7F,MAAM,OAAO,GACX,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAE5F,8FAA8F;YAC9F,wFAAwF;YACxF,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAEjF,6FAA6F;YAC7F,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBACrB,4FAA4F;gBAC5F,6EAA6E;gBAC7E,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;oBACd,MAAM,IAAI,CAAC,CAAC;oBACZ,KAAK,CACH,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,gDAAgD,CACpF,CAAC;oBACF,KAAK,CAAC,kCAAkC,UAAU,gCAAgC,CAAC,CAAC;oBACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;oBACnE,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,CAAC,CAAC;gBACZ,KAAK,CACH,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,EAAE,CAC5I,CAAC;gBACF,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7D,SAAS;YACX,CAAC;YAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,KAAK,CACH,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,GAAG,QAAQ,EAAE,CACtG,CAAC;gBACF,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3D,SAAS;YACX,CAAC;YAED,MAAM,IAAI,CAAC,CAAC;YACZ,KAAK,CACH,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,QAAQ,EAAE,CAC7I,CAAC;YACF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,KAAK,CAAC,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;QAErE,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,KAAK,CAAC,cAAc,MAAM,IAAI,IAAI,CAAC,MAAM,gCAAgC,IAAI,GAAG,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrC,KAAK,CAAC,cAAc,OAAO,IAAI,OAAO,4BAA4B,IAAI,GAAG,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3E,CAAC;CACF;AAtID,kCAsIC","sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { PurityManifest } from './manifest';\nimport type { IPurityClaim, IPurityEntry, IPurityOptions } from './manifest';\nimport { PurityProbe } from './probe';\nimport type { IPurityResult } from './probe';\n\n/** The outcome of one row, as the text report and the JSON verdict both name it. */\nexport class PurityVerdicts {\n  static readonly PASS = 'pass';\n  static readonly FAIL = 'fail';\n  static readonly WAIVED = 'waived';\n  static readonly MISSING = 'missing';\n  static readonly STALE_WAIVER = 'stale-waiver';\n\n  static readonly SCHEME_SET = new Set<string>([\n    this.PASS,\n    this.FAIL,\n    this.WAIVED,\n    this.MISSING,\n    this.STALE_WAIVER,\n  ]);\n\n  static isValid(value: string): value is TPurityVerdict {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\nexport type TPurityVerdict = Extract<(typeof PurityVerdicts)[keyof typeof PurityVerdicts], string>;\n\n/** One row of the `--json` verdict: nothing machine- or time-specific, so two runs on one commit diff empty. */\nexport interface IPurityRowVerdict {\n  label: string;\n  entry: string;\n  verdict: TPurityVerdict;\n  sizeBytes?: number;\n  builtins?: string[];\n  globals?: string[];\n  guardedGlobals?: string[];\n  external?: string[];\n  buildError?: string;\n}\n\nexport interface IPurityReport {\n  rows: IPurityRowVerdict[];\n  failed: number;\n  waived: number;\n  checked: number;\n}\n\nconst formatList = (values: string[]): string => values.join(', ') || 'none';\n\nexport class PurityCheck {\n  /**\n   * Probes every row of the claims and returns the report. `print` receives the human report line by\n   * line, in the exact shape the repository scripts printed before the engine moved here.\n   */\n  static async run(opts: {\n    root: string;\n    claims: IPurityClaim[];\n    options?: IPurityOptions;\n    /** Only the rows of this package; a token that matches nothing is a broken gate and returns `undefined`. */\n    filter?: string;\n    /** The claims file, repository-relative, named in the hint printed for a stale waiver. */\n    claimsFile: string;\n    print: (line: string) => void;\n    /** Where the no-match message goes (stderr for the command): it is an error, not a report line. */\n    printError: (line: string) => void;\n  }): Promise<IPurityReport | undefined> {\n    const { root, claims, options, filter, claimsFile, print, printError } = opts;\n    const manifest = PurityManifest.build({ claims, root, options });\n    const rows: IPurityEntry[] = filter\n      ? manifest.filter((row) => row.package === filter)\n      : manifest;\n\n    // Non-zero, not a friendly note: a mistyped `package` or a renamed directory would otherwise turn\n    // a release-blocking gate into a silent no-op that still reports success.\n    if (rows.length === 0) {\n      const known = [...new Set(manifest.map((row) => row.package))].sort().join(', ');\n      printError(\n        `[purity] No manifest entry matches \"${filter}\" | Known packages: ${known} - a filter that ` +\n          `matches nothing is a broken gate, not an empty one.`,\n      );\n      return undefined;\n    }\n\n    const labelWidth = Math.max(...rows.map((row) => row.label.length));\n    const verdicts: IPurityRowVerdict[] = [];\n    let failed = 0;\n    let waived = 0;\n\n    for (const row of rows) {\n      const entry = join(root, row.entry);\n\n      // The `exports` map is the source of these rows, so a missing file is either an unbuilt package\n      // or a manifest pointing at something the build never emits - both fatal, and neither is worth\n      // reporting as a bundler error twenty lines long.\n      if (!existsSync(entry)) {\n        failed += 1;\n        print(`  ✗ ${row.label.padEnd(labelWidth)} MISSING ${row.entry}`);\n        print(\n          `    The package's \\`exports\\` map points here and nothing is built - run \\`make ${row.package}\\``,\n        );\n        verdicts.push({ label: row.label, entry: row.entry, verdict: PurityVerdicts.MISSING });\n        continue;\n      }\n\n      const result: IPurityResult = await PurityProbe.probeEntry({\n        entry,\n        cwd: root,\n        external: row.external,\n      });\n\n      const detail = {\n        label: row.label,\n        entry: row.entry,\n        sizeBytes: result.sizeBytes,\n        builtins: result.builtins,\n        globals: result.globals,\n        guardedGlobals: result.guardedGlobals,\n        external: result.external,\n        // The bundler's message names absolute paths; the verdict must read the same on any machine.\n        ...(result.buildError ? { buildError: result.buildError.replaceAll(root, '<root>') } : {}),\n      };\n\n      // Guarded reads are printed on the passing path too: they are safe, but a reviewer needs to\n      // see that the entry is clean by construction and not merely by the shape of one expression.\n      const guarded =\n        result.guardedGlobals.length > 0 ? ` | guarded: ${result.guardedGlobals.join(', ')}` : '';\n\n      // Same reasoning as `guarded`, printed on both paths: an entry that externalises a dependency\n      // measures less than one that does not, and that must stay visible next to the verdict.\n      const external =\n        result.external.length > 0 ? ` | external: ${result.external.join(', ')}` : '';\n\n      // Checked before the normal verdict, because for a waived row the two outcomes swap meaning.\n      if (row.expectImpure) {\n        // A waived entry that comes back pure fails: the waiver now describes something untrue, and\n        // the reader who trusts it next will be trusting it about a different entry.\n        if (result.ok) {\n          failed += 1;\n          print(\n            `  ✗ ${row.label.padEnd(labelWidth)} STALE WAIVER - this entry is browser-pure now`,\n          );\n          print(`    Drop it from \\`impure\\` in ${claimsFile} so the gate measures it again`);\n          verdicts.push({ ...detail, verdict: PurityVerdicts.STALE_WAIVER });\n          continue;\n        }\n\n        waived += 1;\n        print(\n          `  ~ ${row.label.padEnd(labelWidth)} waived | builtins: ${formatList(result.builtins)} | globals: ${formatList(result.globals)}${external}`,\n        );\n        verdicts.push({ ...detail, verdict: PurityVerdicts.WAIVED });\n        continue;\n      }\n\n      if (result.ok) {\n        print(\n          `  ✓ ${row.label.padEnd(labelWidth)} ${(result.sizeBytes / 1024).toFixed(1)} KB${guarded}${external}`,\n        );\n        verdicts.push({ ...detail, verdict: PurityVerdicts.PASS });\n        continue;\n      }\n\n      failed += 1;\n      print(\n        `  ✗ ${row.label.padEnd(labelWidth)} builtins: ${formatList(result.builtins)} | globals: ${formatList(result.globals)}${guarded}${external}`,\n      );\n      if (result.buildError) {\n        print(`    ${result.buildError.split('\\n')[0]}`);\n      }\n      verdicts.push({ ...detail, verdict: PurityVerdicts.FAIL });\n    }\n\n    const note = waived > 0 ? ` (${waived} waived as known-impure)` : '';\n\n    if (failed > 0) {\n      print(`\\n[purity] ${failed}/${rows.length} entries are not browser-pure${note}.`);\n    } else {\n      const checked = rows.length - waived;\n      print(`\\n[purity] ${checked}/${checked} entries are browser-pure${note}.`);\n    }\n\n    return { rows: verdicts, failed, waived, checked: rows.length - waived };\n  }\n}\n"]}

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

@@ -28,19 +28,21 @@ export interface IControlsReport {
     checked: number;
     problems: IControlProblem[];
 }
-/**
- * The titles in a test file: the first string argument of `test`, `it`, `describe` and of the
- * second call of `test.each(rows)('title', ...)`, with their `.only`/`.skip`/`.if(...)` forms.
- * A `test.each` title is returned as written (`%s` and all): the registry patterns are regular
- * expressions, so the expansion does not matter.
- */
-export declare const listTestTitles: (opts: {
-    source: string;
-    fileName?: string;
-}) => Promise<string[]>;
-/** Checks every entry of the registry against the test files it names. */
-export declare const checkControls: (opts: {
-    root: string;
-    controls: IControlEntry[];
-}) => Promise<IControlsReport>;
+export declare class TestControlsCheck {
+    /**
+     * The titles in a test file: the first string argument of `test`, `it`, `describe` and of the
+     * second call of `test.each(rows)('title', ...)`, with their `.only`/`.skip`/`.if(...)` forms.
+     * A `test.each` title is returned as written (`%s` and all): the registry patterns are regular
+     * expressions, so the expansion does not matter.
+     */
+    static listTitles(opts: {
+        source: string;
+        fileName?: string;
+    }): Promise<string[]>;
+    /** Checks every entry of the registry against the test files it names. */
+    static run(opts: {
+        root: string;
+        controls: IControlEntry[];
+    }): Promise<IControlsReport>;
+}
 //# sourceMappingURL=test-controls.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"test-controls.d.ts","sourceRoot":"","sources":["../../src/checks/test-controls.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,OAAO,CAAC,MAAM,EAAE,CAgDnB,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GAAU,MAAM;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,KAAG,OAAO,CAAC,eAAe,CAkC1B,CAAC"}
+{"version":3,"file":"test-controls.d.ts","sourceRoot":"","sources":["../../src/checks/test-controls.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,qBAAa,iBAAiB;IAC5B;;;;;OAKG;WACU,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmDvF,0EAA0E;WAC7D,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAmC9F"}

package/dist/checks/test-controls.js

@@ -1,78 +1,80 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkControls = exports.listTestTitles = void 0;
+exports.TestControlsCheck = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-/**
- * The titles in a test file: the first string argument of `test`, `it`, `describe` and of the
- * second call of `test.each(rows)('title', ...)`, with their `.only`/`.skip`/`.if(...)` forms.
- * A `test.each` title is returned as written (`%s` and all): the registry patterns are regular
- * expressions, so the expansion does not matter.
- */
-const listTestTitles = async (opts) => {
-    const typescript = (await import('typescript')).default;
-    const file = typescript.createSourceFile(opts.fileName ?? 'file.test.ts', opts.source, typescript.ScriptTarget.Latest, true);
-    const titles = [];
-    const RUNNERS = new Set(['test', 'it', 'describe']);
-    const rootName = (expression) => {
-        if (typescript.isIdentifier(expression)) {
-            return expression.text;
-        }
-        if (typescript.isPropertyAccessExpression(expression)) {
-            return rootName(expression.expression);
-        }
-        if (typescript.isCallExpression(expression)) {
-            return rootName(expression.expression);
-        }
-        return undefined;
-    };
-    const visit = (node) => {
-        if (typescript.isCallExpression(node)) {
-            const first = node.arguments[0];
-            const root = rootName(node.expression);
-            if (root !== undefined &&
-                RUNNERS.has(root) &&
-                first &&
-                (typescript.isStringLiteral(first) || typescript.isNoSubstitutionTemplateLiteral(first))) {
-                titles.push(first.text);
+class TestControlsCheck {
+    /**
+     * The titles in a test file: the first string argument of `test`, `it`, `describe` and of the
+     * second call of `test.each(rows)('title', ...)`, with their `.only`/`.skip`/`.if(...)` forms.
+     * A `test.each` title is returned as written (`%s` and all): the registry patterns are regular
+     * expressions, so the expansion does not matter.
+     */
+    static async listTitles(opts) {
+        const result = await import('typescript');
+        const typescript = result.default;
+        const file = typescript.createSourceFile(opts.fileName ?? 'file.test.ts', opts.source, typescript.ScriptTarget.Latest, true);
+        const titles = [];
+        const RUNNERS = new Set(['test', 'it', 'describe']);
+        const rootName = (expression) => {
+            if (typescript.isIdentifier(expression)) {
+                return expression.text;
             }
-        }
-        typescript.forEachChild(node, visit);
-    };
-    visit(file);
-    return titles;
-};
-exports.listTestTitles = listTestTitles;
-/** Checks every entry of the registry against the test files it names. */
-const checkControls = async (opts) => {
-    const problems = [];
-    for (const entry of opts.controls) {
-        const path = (0, node_path_1.join)(opts.root, entry.file);
-        if (!(0, node_fs_1.existsSync)(path)) {
-            problems.push({
-                entry,
-                message: `the ${entry.kind === 'file' ? 'negative fixture' : 'test file'} ${entry.file} does not exist`,
-            });
-            continue;
-        }
-        if (entry.kind === 'file') {
-            continue;
-        }
-        const titles = await (0, exports.listTestTitles)({
-            source: (0, node_fs_1.readFileSync)(path, 'utf8'),
-            fileName: entry.file,
-        });
-        const pattern = new RegExp(entry.titlePattern ?? '');
-        const matched = titles.filter((title) => pattern.test(title)).length;
-        const min = entry.min ?? 1;
-        if (matched < min) {
-            problems.push({
-                entry,
-                message: `${matched} title(s) match /${entry.titlePattern ?? ''}/ in ${entry.file}, ${min} required | the control of gate '${entry.gate}' is gone or renamed`,
+            if (typescript.isPropertyAccessExpression(expression)) {
+                return rootName(expression.expression);
+            }
+            if (typescript.isCallExpression(expression)) {
+                return rootName(expression.expression);
+            }
+            return undefined;
+        };
+        const visit = (node) => {
+            if (typescript.isCallExpression(node)) {
+                const first = node.arguments[0];
+                const root = rootName(node.expression);
+                if (root !== undefined &&
+                    RUNNERS.has(root) &&
+                    first &&
+                    (typescript.isStringLiteral(first) || typescript.isNoSubstitutionTemplateLiteral(first))) {
+                    titles.push(first.text);
+                }
+            }
+            typescript.forEachChild(node, visit);
+        };
+        visit(file);
+        return titles;
+    }
+    /** Checks every entry of the registry against the test files it names. */
+    static async run(opts) {
+        const problems = [];
+        for (const entry of opts.controls) {
+            const path = (0, node_path_1.join)(opts.root, entry.file);
+            if (!(0, node_fs_1.existsSync)(path)) {
+                problems.push({
+                    entry,
+                    message: `the ${entry.kind === 'file' ? 'negative fixture' : 'test file'} ${entry.file} does not exist`,
+                });
+                continue;
+            }
+            if (entry.kind === 'file') {
+                continue;
+            }
+            const titles = await TestControlsCheck.listTitles({
+                source: (0, node_fs_1.readFileSync)(path, 'utf8'),
+                fileName: entry.file,
             });
+            const pattern = new RegExp(entry.titlePattern ?? '');
+            const matched = titles.filter((title) => pattern.test(title)).length;
+            const min = entry.min ?? 1;
+            if (matched < min) {
+                problems.push({
+                    entry,
+                    message: `${matched} title(s) match /${entry.titlePattern ?? ''}/ in ${entry.file}, ${min} required | the control of gate '${entry.gate}' is gone or renamed`,
+                });
+            }
         }
+        return { checked: opts.controls.length, problems };
     }
-    return { checked: opts.controls.length, problems };
-};
-exports.checkControls = checkControls;
+}
+exports.TestControlsCheck = TestControlsCheck;
 //# sourceMappingURL=test-controls.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"test-controls.js","sourceRoot":"","sources":["../../src/checks/test-controls.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type ts from 'typescript';\n\n/**\n * A positive control is a test that proves a gate can fail: a fixture that must be refused, a broken\n * subject the check must catch. Deleting one makes the gate pass for the wrong reason, so the trim-tests\n * method keeps a committed registry of them and fails when one disappears.\n */\nexport interface IControlEntry {\n  /** The gate the control belongs to; reported with a failure. */\n  gate: string;\n  /** Repository-relative path of the test file. */\n  file: string;\n  /**\n   * `test` (default): `file` is a test file and `titlePattern` is matched against its titles.\n   * `file`: `file` is a NEGATIVE FIXTURE, a file a test needs to be absent from the result (a class the\n   * scanner must ignore). It only has to exist: without it the test's \"not found\" assertion passes for the\n   * wrong reason.\n   */\n  kind?: 'test' | 'file';\n  /** A regular expression matched against the TITLES (suite and case) in that file. Not used by `file` entries. */\n  titlePattern?: string;\n  /** At least this many titles must match. Default 1. */\n  min?: number;\n}\n\nexport interface IControlProblem {\n  entry: IControlEntry;\n  message: string;\n}\n\nexport interface IControlsReport {\n  checked: number;\n  problems: IControlProblem[];\n}\n\n/**\n * The titles in a test file: the first string argument of `test`, `it`, `describe` and of the\n * second call of `test.each(rows)('title', ...)`, with their `.only`/`.skip`/`.if(...)` forms.\n * A `test.each` title is returned as written (`%s` and all): the registry patterns are regular\n * expressions, so the expansion does not matter.\n */\nexport const listTestTitles = async (opts: {\n  source: string;\n  fileName?: string;\n}): Promise<string[]> => {\n  const typescript: typeof ts = (await import('typescript')).default;\n  const file = typescript.createSourceFile(\n    opts.fileName ?? 'file.test.ts',\n    opts.source,\n    typescript.ScriptTarget.Latest,\n    true,\n  );\n  const titles: string[] = [];\n  const RUNNERS = new Set(['test', 'it', 'describe']);\n\n  const rootName = (expression: ts.Expression): string | undefined => {\n    if (typescript.isIdentifier(expression)) {\n      return expression.text;\n    }\n\n    if (typescript.isPropertyAccessExpression(expression)) {\n      return rootName(expression.expression);\n    }\n\n    if (typescript.isCallExpression(expression)) {\n      return rootName(expression.expression);\n    }\n\n    return undefined;\n  };\n\n  const visit = (node: ts.Node): void => {\n    if (typescript.isCallExpression(node)) {\n      const first = node.arguments[0];\n      const root = rootName(node.expression);\n\n      if (\n        root !== undefined &&\n        RUNNERS.has(root) &&\n        first &&\n        (typescript.isStringLiteral(first) || typescript.isNoSubstitutionTemplateLiteral(first))\n      ) {\n        titles.push(first.text);\n      }\n    }\n\n    typescript.forEachChild(node, visit);\n  };\n\n  visit(file);\n\n  return titles;\n};\n\n/** Checks every entry of the registry against the test files it names. */\nexport const checkControls = async (opts: {\n  root: string;\n  controls: IControlEntry[];\n}): Promise<IControlsReport> => {\n  const problems: IControlProblem[] = [];\n\n  for (const entry of opts.controls) {\n    const path = join(opts.root, entry.file);\n    if (!existsSync(path)) {\n      problems.push({\n        entry,\n        message: `the ${entry.kind === 'file' ? 'negative fixture' : 'test file'} ${entry.file} does not exist`,\n      });\n      continue;\n    }\n\n    if (entry.kind === 'file') {\n      continue;\n    }\n\n    const titles = await listTestTitles({\n      source: readFileSync(path, 'utf8'),\n      fileName: entry.file,\n    });\n    const pattern = new RegExp(entry.titlePattern ?? '');\n    const matched = titles.filter((title) => pattern.test(title)).length;\n    const min = entry.min ?? 1;\n\n    if (matched < min) {\n      problems.push({\n        entry,\n        message: `${matched} title(s) match /${entry.titlePattern ?? ''}/ in ${entry.file}, ${min} required | the control of gate '${entry.gate}' is gone or renamed`,\n      });\n    }\n  }\n\n  return { checked: opts.controls.length, problems };\n};\n"]}
+{"version":3,"file":"test-controls.js","sourceRoot":"","sources":["../../src/checks/test-controls.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type ts from 'typescript';\n\n/**\n * A positive control is a test that proves a gate can fail: a fixture that must be refused, a broken\n * subject the check must catch. Deleting one makes the gate pass for the wrong reason, so the trim-tests\n * method keeps a committed registry of them and fails when one disappears.\n */\nexport interface IControlEntry {\n  /** The gate the control belongs to; reported with a failure. */\n  gate: string;\n  /** Repository-relative path of the test file. */\n  file: string;\n  /**\n   * `test` (default): `file` is a test file and `titlePattern` is matched against its titles.\n   * `file`: `file` is a NEGATIVE FIXTURE, a file a test needs to be absent from the result (a class the\n   * scanner must ignore). It only has to exist: without it the test's \"not found\" assertion passes for the\n   * wrong reason.\n   */\n  kind?: 'test' | 'file';\n  /** A regular expression matched against the TITLES (suite and case) in that file. Not used by `file` entries. */\n  titlePattern?: string;\n  /** At least this many titles must match. Default 1. */\n  min?: number;\n}\n\nexport interface IControlProblem {\n  entry: IControlEntry;\n  message: string;\n}\n\nexport interface IControlsReport {\n  checked: number;\n  problems: IControlProblem[];\n}\n\nexport class TestControlsCheck {\n  /**\n   * The titles in a test file: the first string argument of `test`, `it`, `describe` and of the\n   * second call of `test.each(rows)('title', ...)`, with their `.only`/`.skip`/`.if(...)` forms.\n   * A `test.each` title is returned as written (`%s` and all): the registry patterns are regular\n   * expressions, so the expansion does not matter.\n   */\n  static async listTitles(opts: { source: string; fileName?: string }): Promise<string[]> {\n    const result = await import('typescript');\n    const typescript: typeof ts = result.default;\n    const file = typescript.createSourceFile(\n      opts.fileName ?? 'file.test.ts',\n      opts.source,\n      typescript.ScriptTarget.Latest,\n      true,\n    );\n    const titles: string[] = [];\n    const RUNNERS = new Set(['test', 'it', 'describe']);\n\n    const rootName = (expression: ts.Expression): string | undefined => {\n      if (typescript.isIdentifier(expression)) {\n        return expression.text;\n      }\n\n      if (typescript.isPropertyAccessExpression(expression)) {\n        return rootName(expression.expression);\n      }\n\n      if (typescript.isCallExpression(expression)) {\n        return rootName(expression.expression);\n      }\n\n      return undefined;\n    };\n\n    const visit = (node: ts.Node): void => {\n      if (typescript.isCallExpression(node)) {\n        const first = node.arguments[0];\n        const root = rootName(node.expression);\n\n        if (\n          root !== undefined &&\n          RUNNERS.has(root) &&\n          first &&\n          (typescript.isStringLiteral(first) || typescript.isNoSubstitutionTemplateLiteral(first))\n        ) {\n          titles.push(first.text);\n        }\n      }\n\n      typescript.forEachChild(node, visit);\n    };\n\n    visit(file);\n\n    return titles;\n  }\n\n  /** Checks every entry of the registry against the test files it names. */\n  static async run(opts: { root: string; controls: IControlEntry[] }): Promise<IControlsReport> {\n    const problems: IControlProblem[] = [];\n\n    for (const entry of opts.controls) {\n      const path = join(opts.root, entry.file);\n      if (!existsSync(path)) {\n        problems.push({\n          entry,\n          message: `the ${entry.kind === 'file' ? 'negative fixture' : 'test file'} ${entry.file} does not exist`,\n        });\n        continue;\n      }\n\n      if (entry.kind === 'file') {\n        continue;\n      }\n\n      const titles = await TestControlsCheck.listTitles({\n        source: readFileSync(path, 'utf8'),\n        fileName: entry.file,\n      });\n      const pattern = new RegExp(entry.titlePattern ?? '');\n      const matched = titles.filter((title) => pattern.test(title)).length;\n      const min = entry.min ?? 1;\n\n      if (matched < min) {\n        problems.push({\n          entry,\n          message: `${matched} title(s) match /${entry.titlePattern ?? ''}/ in ${entry.file}, ${min} required | the control of gate '${entry.gate}' is gone or renamed`,\n        });\n      }\n    }\n\n    return { checked: opts.controls.length, problems };\n  }\n}\n"]}

package/dist/checks/test-dead-code.d.ts

@@ -12,7 +12,9 @@ export interface IDeadTestCodeCandidate {
      */
     kind: 'unreferenced' | 'folder-referenced';
 }
-export declare const findDeadTestCode: (opts: {
-    root: string;
-}) => IDeadTestCodeCandidate[];
+export declare class DeadTestCodeCheck {
+    static find(opts: {
+        root: string;
+    }): IDeadTestCodeCandidate[];
+}
 //# sourceMappingURL=test-dead-code.d.ts.map

package/dist/checks/test-dead-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-dead-code.d.ts","sourceRoot":"","sources":["../../src/checks/test-dead-code.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;CAC5C;AA6BD,eAAO,MAAM,gBAAgB,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,sBAAsB,EA+B/E,CAAC"}
+{"version":3,"file":"test-dead-code.d.ts","sourceRoot":"","sources":["../../src/checks/test-dead-code.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;CAC5C;AA6BD,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,sBAAsB,EAAE;CAgC9D"}

package/dist/checks/test-dead-code.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findDeadTestCode = void 0;
+exports.DeadTestCodeCheck = void 0;
 const node_child_process_1 = require("node:child_process");
 const node_path_1 = require("node:path");
 const SUPPORT_EXTENSION = /\.(?:[cm]?[jt]sx?|json|sql|txt)$/;
@@ -25,26 +25,28 @@ const nameReferencedElsewhere = (opts) => {
     const result = git({ root: opts.root, args: ['grep', '-l', '-I', '-E', '-e', pattern] });
     return result.stdout.split('\n').some((line) => line !== '' && line !== opts.self);
 };
-const findDeadTestCode = (opts) => {
-    const tracked = git({ root: opts.root, args: ['ls-files'] }).stdout.split('\n');
-    const support = tracked.filter((file) => file.includes('/__tests__/') &&
-        SUPPORT_EXTENSION.test(file) &&
-        !TEST_FILE.test(file) &&
-        !file.endsWith('.d.ts'));
-    const candidates = [];
-    for (const file of support) {
-        const underTests = file.slice(file.indexOf('/__tests__/') + '/__tests__/'.length);
-        const stem = underTests.split('/').pop().replace(SUPPORT_EXTENSION, '');
-        const withoutExtension = underTests.replace(SUPPORT_EXTENSION, '');
-        if (nameReferencedElsewhere({ root: opts.root, stem, self: file }) ||
-            referencedElsewhere({ root: opts.root, needle: withoutExtension, self: file })) {
-            continue;
+class DeadTestCodeCheck {
+    static find(opts) {
+        const tracked = git({ root: opts.root, args: ['ls-files'] }).stdout.split('\n');
+        const support = tracked.filter((file) => file.includes('/__tests__/') &&
+            SUPPORT_EXTENSION.test(file) &&
+            !TEST_FILE.test(file) &&
+            !file.endsWith('.d.ts'));
+        const candidates = [];
+        for (const file of support) {
+            const underTests = file.slice(file.indexOf('/__tests__/') + '/__tests__/'.length);
+            const stem = underTests.split('/').pop().replace(SUPPORT_EXTENSION, '');
+            const withoutExtension = underTests.replace(SUPPORT_EXTENSION, '');
+            if (nameReferencedElsewhere({ root: opts.root, stem, self: file }) ||
+                referencedElsewhere({ root: opts.root, needle: withoutExtension, self: file })) {
+                continue;
+            }
+            const folder = (0, node_path_1.dirname)(underTests);
+            const folderReferenced = folder !== '.' && referencedElsewhere({ root: opts.root, needle: folder, self: file });
+            candidates.push({ file, kind: folderReferenced ? 'folder-referenced' : 'unreferenced' });
         }
-        const folder = (0, node_path_1.dirname)(underTests);
-        const folderReferenced = folder !== '.' && referencedElsewhere({ root: opts.root, needle: folder, self: file });
-        candidates.push({ file, kind: folderReferenced ? 'folder-referenced' : 'unreferenced' });
+        return candidates;
     }
-    return candidates;
-};
-exports.findDeadTestCode = findDeadTestCode;
+}
+exports.DeadTestCodeCheck = DeadTestCodeCheck;
 //# sourceMappingURL=test-dead-code.js.map

package/dist/checks/test-dead-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-dead-code.js","sourceRoot":"","sources":["../../src/checks/test-dead-code.ts"],"names":[],"mappings":";;;AAAA,2DAA+C;AAC/C,yCAAoC;AAiBpC,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAC7D,MAAM,SAAS,GAAG,gCAAgC,CAAC;AAEnD,MAAM,GAAG,GAAG,CAAC,IAAsC,EAAsC,EAAE;IACzF,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE;QACzC,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;KAC7B,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACrE,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,mBAAmB,GAAG,CAAC,IAAoD,EAAW,EAAE;IAC5F,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE7F,gGAAgG;AAChG,MAAM,uBAAuB,GAAG,CAAC,IAAkD,EAAW,EAAE;IAC9F,MAAM,OAAO,GAAG,UAAU,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;IACpE,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACzF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC,CAAC;AAEK,MAAM,gBAAgB,GAAG,CAAC,IAAsB,EAA4B,EAAE;IACnF,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC1B,CAAC;IACF,MAAM,UAAU,GAA6B,EAAE,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAEnE,IACE,uBAAuB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC9D,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAC9E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,UAAU,CAAC,CAAC;QACnC,MAAM,gBAAgB,GACpB,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzF,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AA/BW,QAAA,gBAAgB,oBA+B3B","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { dirname } from 'node:path';\n\n/**\n * Support files of the tests (fixtures, helpers, probes) that no other file refers to. The second\n * step of the trim-tests method. The output is CANDIDATES: a fixture can be loaded by a path built at\n * run time or by scanning a folder, so a candidate is deleted only after the package suite is green\n * without it.\n */\nexport interface IDeadTestCodeCandidate {\n  file: string;\n  /**\n   * `unreferenced`: neither its name nor its path under `__tests__` appears in another file, nor does\n   * its folder. `folder-referenced`: only its folder path does, so a scan of that folder may load it.\n   */\n  kind: 'unreferenced' | 'folder-referenced';\n}\n\nconst SUPPORT_EXTENSION = /\\.(?:[cm]?[jt]sx?|json|sql|txt)$/;\nconst TEST_FILE = /\\.(?:test|spec)\\.[cm]?[jt]sx?$/;\n\nconst git = (opts: { root: string; args: string[] }): { status: number; stdout: string } => {\n  const result = spawnSync('git', opts.args, {\n    cwd: opts.root,\n    encoding: 'utf8',\n    maxBuffer: 256 * 1024 * 1024,\n  });\n  return { status: result.status ?? 1, stdout: result.stdout ?? '' };\n};\n\n/** Files other than `self` whose text contains `needle` (a fixed string). */\nconst referencedElsewhere = (opts: { root: string; needle: string; self: string }): boolean => {\n  const result = git({ root: opts.root, args: ['grep', '-l', '-I', '-F', '-e', opts.needle] });\n  return result.stdout.split('\\n').some((line) => line !== '' && line !== opts.self);\n};\n\nconst escapeForRegex = (text: string): string => text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/** Files other than `self` that mention the name of the file as a path segment or an import. */\nconst nameReferencedElsewhere = (opts: { root: string; stem: string; self: string }): boolean => {\n  const pattern = `[/'\"\\`]${escapeForRegex(opts.stem)}(\\\\.|'|\"|\\`|$)`;\n  const result = git({ root: opts.root, args: ['grep', '-l', '-I', '-E', '-e', pattern] });\n  return result.stdout.split('\\n').some((line) => line !== '' && line !== opts.self);\n};\n\nexport const findDeadTestCode = (opts: { root: string }): IDeadTestCodeCandidate[] => {\n  const tracked = git({ root: opts.root, args: ['ls-files'] }).stdout.split('\\n');\n  const support = tracked.filter(\n    (file) =>\n      file.includes('/__tests__/') &&\n      SUPPORT_EXTENSION.test(file) &&\n      !TEST_FILE.test(file) &&\n      !file.endsWith('.d.ts'),\n  );\n  const candidates: IDeadTestCodeCandidate[] = [];\n\n  for (const file of support) {\n    const underTests = file.slice(file.indexOf('/__tests__/') + '/__tests__/'.length);\n    const stem = underTests.split('/').pop()!.replace(SUPPORT_EXTENSION, '');\n    const withoutExtension = underTests.replace(SUPPORT_EXTENSION, '');\n\n    if (\n      nameReferencedElsewhere({ root: opts.root, stem, self: file }) ||\n      referencedElsewhere({ root: opts.root, needle: withoutExtension, self: file })\n    ) {\n      continue;\n    }\n\n    const folder = dirname(underTests);\n    const folderReferenced =\n      folder !== '.' && referencedElsewhere({ root: opts.root, needle: folder, self: file });\n\n    candidates.push({ file, kind: folderReferenced ? 'folder-referenced' : 'unreferenced' });\n  }\n\n  return candidates;\n};\n"]}
+{"version":3,"file":"test-dead-code.js","sourceRoot":"","sources":["../../src/checks/test-dead-code.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { dirname } from 'node:path';\n\n/**\n * Support files of the tests (fixtures, helpers, probes) that no other file refers to. The second\n * step of the trim-tests method. The output is CANDIDATES: a fixture can be loaded by a path built at\n * run time or by scanning a folder, so a candidate is deleted only after the package suite is green\n * without it.\n */\nexport interface IDeadTestCodeCandidate {\n  file: string;\n  /**\n   * `unreferenced`: neither its name nor its path under `__tests__` appears in another file, nor does\n   * its folder. `folder-referenced`: only its folder path does, so a scan of that folder may load it.\n   */\n  kind: 'unreferenced' | 'folder-referenced';\n}\n\nconst SUPPORT_EXTENSION = /\\.(?:[cm]?[jt]sx?|json|sql|txt)$/;\nconst TEST_FILE = /\\.(?:test|spec)\\.[cm]?[jt]sx?$/;\n\nconst git = (opts: { root: string; args: string[] }): { status: number; stdout: string } => {\n  const result = spawnSync('git', opts.args, {\n    cwd: opts.root,\n    encoding: 'utf8',\n    maxBuffer: 256 * 1024 * 1024,\n  });\n  return { status: result.status ?? 1, stdout: result.stdout ?? '' };\n};\n\n/** Files other than `self` whose text contains `needle` (a fixed string). */\nconst referencedElsewhere = (opts: { root: string; needle: string; self: string }): boolean => {\n  const result = git({ root: opts.root, args: ['grep', '-l', '-I', '-F', '-e', opts.needle] });\n  return result.stdout.split('\\n').some((line) => line !== '' && line !== opts.self);\n};\n\nconst escapeForRegex = (text: string): string => text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/** Files other than `self` that mention the name of the file as a path segment or an import. */\nconst nameReferencedElsewhere = (opts: { root: string; stem: string; self: string }): boolean => {\n  const pattern = `[/'\"\\`]${escapeForRegex(opts.stem)}(\\\\.|'|\"|\\`|$)`;\n  const result = git({ root: opts.root, args: ['grep', '-l', '-I', '-E', '-e', pattern] });\n  return result.stdout.split('\\n').some((line) => line !== '' && line !== opts.self);\n};\n\nexport class DeadTestCodeCheck {\n  static find(opts: { root: string }): IDeadTestCodeCandidate[] {\n    const tracked = git({ root: opts.root, args: ['ls-files'] }).stdout.split('\\n');\n    const support = tracked.filter(\n      (file) =>\n        file.includes('/__tests__/') &&\n        SUPPORT_EXTENSION.test(file) &&\n        !TEST_FILE.test(file) &&\n        !file.endsWith('.d.ts'),\n    );\n    const candidates: IDeadTestCodeCandidate[] = [];\n\n    for (const file of support) {\n      const underTests = file.slice(file.indexOf('/__tests__/') + '/__tests__/'.length);\n      const stem = underTests.split('/').pop()!.replace(SUPPORT_EXTENSION, '');\n      const withoutExtension = underTests.replace(SUPPORT_EXTENSION, '');\n\n      if (\n        nameReferencedElsewhere({ root: opts.root, stem, self: file }) ||\n        referencedElsewhere({ root: opts.root, needle: withoutExtension, self: file })\n      ) {\n        continue;\n      }\n\n      const folder = dirname(underTests);\n      const folderReferenced =\n        folder !== '.' && referencedElsewhere({ root: opts.root, needle: folder, self: file });\n\n      candidates.push({ file, kind: folderReferenced ? 'folder-referenced' : 'unreferenced' });\n    }\n\n    return candidates;\n  }\n}\n"]}

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

@@ -48,11 +48,16 @@ export interface ILedgerResult {
     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[];
+export declare class TestMutateCheck {
+    /** Replays every line; never throws for a green survivor (that is a result), only for an unusable ledger. */
+    static replayLedger(opts: {
+        root: string;
+        ledger: ILedger;
+        scratch?: string;
+    }): ILedgerResult[];
+    /** The report lines of a replay, one per ledger line and a closing tally. */
+    static formatLedgerResults(opts: {
+        results: ILedgerResult[];
+    }): string[];
+}
 //# sourceMappingURL=test-mutate.d.ts.map

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

@@ -1 +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"}
+{"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,qBAAa,eAAe;IAC1B,6GAA6G;IAC7G,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,EAAE;IAyD/F,6EAA6E;IAC7E,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,EAAE,CAAA;KAAE,GAAG,MAAM,EAAE;CAazE"}

package/dist/checks/test-mutate.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatLedgerResults = exports.replayLedger = void 0;
+exports.TestMutateCheck = 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");
@@ -98,68 +98,71 @@ const withMutants = (opts) => {
         });
     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) {
+class TestMutateCheck {
+    /** Replays every line; never throws for a green survivor (that is a result), only for an unusable ledger. */
+    static 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 = 'a vacuous line needs a secondMutant';
+                result.problem =
+                    'the survivor stayed green under the mutant: it does not cover the behaviour';
             }
-            else if (candidateRed) {
+            else if (expectation === 'red' && !candidateRed) {
                 result.ok = false;
-                result.problem = 'the candidate went red under the mutant: it is not vacuous';
+                result.problem =
+                    'the candidate stayed green under the mutant: record it as vacuous with a second mutant, or pick a mutant it checks';
             }
-            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) {
+            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 second mutant: it is not vacuous';
+                    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);
         }
-        results.push(result);
+        return results;
     }
-    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;
+    /** The report lines of a replay, one per ledger line and a closing tally. */
+    static formatLedgerResults(opts) {
+        const { results } = opts;
+        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.TestMutateCheck = TestMutateCheck;
 //# sourceMappingURL=test-mutate.js.map