@event4u/agent-config 8.4.1 → 8.5.0

package/src/scripts/ai_council/shadow_dispatch.ts

@@ -1,7 +1,7 @@
 /**
  * Shadow-mode dispatch for low-impact solo-member decisions (step-9 P10).
  *
- * TypeScript twin of `src/scripts/ai_council/shadow_dispatch.py`
+ * Ported from the retired Python `src/scripts/ai_council/shadow_dispatch.py`
  * (ADR-200 — Python→TS migration, Phase 1).
  *
  * When `low_impact.dispatch: single` is active, a Bernoulli-sampled subset

package/src/scripts/ai_council/solo_dispatch.ts

@@ -1,7 +1,7 @@
 /**
  * Solo-member dispatch — step-9 P9 (U2).
  *
- * TypeScript twin of `src/scripts/ai_council/solo_dispatch.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/solo_dispatch.py` (ADR-200 —
  * Python→TS migration, Phase 1). Picks the first enabled, auth-valid member
  * from `routing.solo_member_fallback_chain` so low-impact decisions can
  * optionally route to a single member instead of the full council. The

package/src/scripts/analysis_freshness.ts

@@ -2,8 +2,8 @@
 /**
  * Project-analysis freshness loop — a cheap *heuristic* staleness signal.
  *
- * TypeScript twin of `src/scripts/analysis_freshness.py` (ADR-200,
- * Python→TypeScript migration). The CLI contract is mirrored EXACTLY — the
+ * Ported from the retired Python `src/scripts/analysis_freshness.py` (ADR-200,
+ * Python→TypeScript migration). The CLI contract is pinned — the
  * required mutually-exclusive group (`--stamp FILE | --stamp-all | --check FILE
  * | --check-all`), the argparse usage banner + error text (missing required
  * group → exit 2, conflicting args → exit 2, missing value → exit 2,

package/src/scripts/annotate_discovery.ts

@@ -2,7 +2,7 @@
 /**
  * R3 Phase 4 mass-annotator — discovery frontmatter helper.
  *
- * TypeScript twin of `src/scripts/annotate_discovery.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/annotate_discovery.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8g). Mirrors the Python CLI contract
  * EXACTLY — the `--pack` choice flag + positional `paths`, exit code (0),
  * the stdout/stderr split, byte-identical messages, and byte-identical
@@ -20,7 +20,7 @@
  * Idempotent: re-runs leave already-annotated files untouched.
  *
  * Mapping table (`PACK_DEFAULTS`) is the council-locked authority. No
- * behaviour changes — latent Python quirks replicated.
+ * behaviour changes — historical quirks preserved (consumers pin the exact behaviour).
  */
 import * as crypto from 'node:crypto';
 import * as fs from 'node:fs';

package/src/scripts/apply_modules_config.ts

@@ -2,8 +2,8 @@
 /**
  * Persist a `modules:` block into `.agent-project-settings.yml`.
  *
- * TypeScript twin of `src/scripts/apply_modules_config.py` (ADR-200,
- * Phase 8 / Wave 8g). Mirrors the Python CLI contract EXACTLY — `--project`
+ * Ported from the retired Python `src/scripts/apply_modules_config.py` (ADR-200,
+ * Phase 8 / Wave 8g). The CLI contract is pinned — `--project`
  * / `--input-file` / `--decline` / `--acknowledge-only` flags, JSON payload
  * shape + validation, comment-preserving line-patch (byte-identical written
  * output), exit codes (0 ok/no-op, 2 args/unreachable/malformed-JSON,

package/src/scripts/audit_adr_coverage.ts

@@ -3,8 +3,8 @@
  * Audit per-area ADR coverage against docs/contracts/ and the canonical
  * AREAS inventory. Contract: docs/contracts/adr-layout.md.
  *
- * TypeScript twin of `src/scripts/audit_adr_coverage.py` (ADR-200, Phase 8 /
- * Wave 8a). The CLI contract is mirrored EXACTLY — the mutually exclusive
+ * Ported from the retired Python `src/scripts/audit_adr_coverage.py` (ADR-200, Phase 8 /
+ * Wave 8a). The CLI contract is pinned — the mutually exclusive
  * `--check` / `--regen-area-readme AREA` group (default `--report`), exit
  * codes, the stdout/stderr split, byte-identical messages, AND byte-identical
  * generated `README.md` for `--regen-area-readme`.
@@ -15,7 +15,7 @@
  *              ADRs and dangling references.
  *   --regen-area-readme <area>  rewrite docs/adrs/<area>/README.md. Idempotent.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';

package/src/scripts/audit_auto_rules.ts

@@ -3,7 +3,7 @@
  * Audit auto-rules for the Rule-Governance pass (Phase 5.1 of
  * road-to-augment-limit-fit).
  *
- * TypeScript twin of `src/scripts/audit_auto_rules.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/audit_auto_rules.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the Python CLI
  * contract EXACTLY — no flags, exit codes (0 ok / 1 no source rules),
  * the stdout/stderr split, byte-identical stdout messages, and
@@ -12,7 +12,7 @@
  *
  * Imports the `_lib/agent_src` twin (the SAME surface the Python
  * original imports `artefact_roots` from). No behaviour changes —
- * latent Python quirks replicated.
+ * historical quirks preserved (consumers pin the exact behaviour).
  *
  * Walk every artefact root's `rules/*.md`, collect per-rule
  * frontmatter (`description`, `triggers`, `routes_to`, `tier`),

package/src/scripts/audit_cloud_compatibility.ts

@@ -2,8 +2,8 @@
 /**
  * audit_cloud_compatibility.ts — tier each artefact for cloud distribution.
  *
- * TypeScript twin of `src/scripts/audit_cloud_compatibility.py` (ADR-200,
- * Phase 8 / Wave 8a). The CLI contract is mirrored EXACTLY — the flags
+ * Ported from the retired Python `src/scripts/audit_cloud_compatibility.py` (ADR-200,
+ * Phase 8 / Wave 8a). The CLI contract is pinned — the flags
  * `--details` / `--tier` / `--cloud-action` / `--format` / `--iron-law`,
  * exit codes, the stdout/stderr split, byte-identical messages, AND
  * byte-identical JSON output (`json.dumps(indent=2)` — insertion-order keys,
@@ -14,7 +14,7 @@
  * `<!-- cloud_safe: noop|degrade -->` markers, and emits a JSON summary
  * (or `--details` rows, or the `--iron-law` bypass scan).
  *
- * No behaviour changes — latent Python quirks replicated (including the
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour. (including the
  * Counter.most_common tie-ordering and the regex-findall set dedup).
  */
 import * as fs from 'node:fs';

package/src/scripts/audit_command_surface.ts

@@ -2,7 +2,7 @@
 /**
  * Command-surface inventory + overlap detection + usage signal.
  *
- * TypeScript twin of `src/scripts/audit_command_surface.py` (ADR-200, Phase 8 /
+ * Ported from the retired Python `src/scripts/audit_command_surface.py` (ADR-200, Phase 8 /
  * Wave 8b). Mirrors the CLI contract EXACTLY — the `--root`, `--budget`,
  * `--check-new`, `--baseline`, `--quiet` flags, exit codes (0 ok / 1 budget
  * violation / 2 root-missing / 3 git error), the stdout/stderr split,
@@ -14,7 +14,7 @@
  * overlap pairs by keyword-cosine similarity, and adds a usage signal from
  * git history.
  *
- * No behaviour changes — latent Python quirks replicated (incl. git-history
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour. (incl. git-history
  * `days_since_*` values, which depend on the wall clock and the worktree's
  * git log — golden parity is run in the SAME repo so both sides observe the
  * identical history; the day arithmetic is reproduced with the same floor).

package/src/scripts/audit_initial_context.ts

@@ -2,7 +2,7 @@
 /**
  * Initial-context token audit (roadmap `road-to-lean-initial-context`).
  *
- * TypeScript twin of `src/scripts/audit_initial_context.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/audit_initial_context.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8b). The CLI contract is mirrored
  * EXACTLY — the `--json` / `--write` / `--fail-if-over-budget` flags,
  * exit codes (0 ok / advisory · 1 over-budget), the stdout/stderr split,
@@ -10,13 +10,14 @@
  * (`json.dumps(indent=2, sort_keys=True)`).
  *
  * Imports the `_lib/token_count` and `_lib/agent_src` twins (the SAME
- * surfaces the Python original imports). `thin_projection()` mirrors the
- * Python original exactly: the Python `import`s `project_thin_rules.measure`
+ * surfaces the retired Python implementation imports). `thin_projection()` preserves the
+ * historical behaviour exactly: the retired implementation imported
+ * `project_thin_rules.measure`
  * and swallows any failure to `{}`; this twin imports the `measure()` of the
  * `project_thin_rules.ts` twin and falls back to `{}` on any error in the same
  * best-effort try/catch. The default JSON stays byte-identical.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  *
  * NOTE (divergence-free by construction): the `generated` field carries a
  * UTC timestamp, so the default/`--json`/`--write` outputs are inherently
@@ -80,7 +81,7 @@ export const BUDGETS: Record<string, number | null> = {
     'rules.gpt': null,
     'skill_catalog.gpt': 12_500, // always-scanned skill descriptions (skills_core_source, 258); current ~10,999
     'command_catalog.gpt': 5_800, // always-scanned command catalog; current ~5,005
-    'mcp_schemas.gpt': 3_500, // per-connected-client MCP tool schemas; current ~2,942
+    'mcp_schemas.gpt': 4_250, // per-connected-client MCP tool schemas; current ~3,694 after the council-gated run_tests exec pilot (598a8a49f) — re-anchored current + ~15% per this cap's own policy
 };
 
 /**
@@ -324,7 +325,7 @@ export function longest_rules(top = 10): LongestRule[] {
 
 // --- thin_projection: delegate to the project_thin_rules twin ----------------
 //
-// The Python original does `from project_thin_rules import measure as _measure`
+// the retired Python implementation does `from project_thin_rules import measure as _measure`
 // inside a try/except that returns `{}` on any failure. This twin mirrors that
 // exactly: import the same-named `measure()` from the TS twin and swallow any
 // error to `{}`. The thin-entry pointer's legacy-path literal now lives ONLY

package/src/scripts/audit_likelihood.ts

@@ -3,14 +3,14 @@
  * Activation-likelihood heuristic for the Rule-Governance pass
  * (Phase 5.3 of road-to-augment-limit-fit).
  *
- * TypeScript twin of `src/scripts/audit_likelihood.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/audit_likelihood.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the Python CLI
  * contract EXACTLY — no flags, exit codes (0 ok / 1 missing audit
  * JSON), the stdout/stderr split, byte-identical stdout messages, and
  * byte-identical written artefacts (`json.dumps(..., indent=2)` for the
  * likelihood dump + the exact appended Markdown section).
  *
- * No `_lib` imports — the Python original has none; it reads the audit
+ * No `_lib` imports — the retired Python implementation has none; it reads the audit
  * JSON written by `audit_auto_rules.py` and globs a fixed corpus.
  *
  * For every auto-rule from `agents/reports/auto-rules-audit.json`:
@@ -22,7 +22,7 @@
  * 3. Score `corpus_hits = sum(1 for token in tokens if token in corpus)`.
  * 4. Flag rules with `< 2` corpus hits as "low-likelihood".
  *
- * No behaviour changes — latent Python quirks replicated, including the
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour., including the
  * `dict(sorted(...)[:8])` top-8 hit truncation and the corpus-keyword
  * heuristic.
  */
@@ -92,7 +92,7 @@ function pyLen(s: string): number {
  * Recursive glob for the four fixed patterns. Each pattern is anchored at
  * REPO_ROOT. `**` matches any depth; the trailing component is a basename or
  * `*.md` suffix. Returns SORTED absolute paths (Python `Path.glob` yields
- * unsorted; the Python original does NOT sort, but iterates corpus globs in
+ * unsorted; the retired Python implementation does NOT sort, but iterates corpus globs in
  * list order and merely counts tokens into a Counter, so token membership is
  * order-independent — we still walk deterministically).
  */
@@ -219,7 +219,7 @@ export function score(rule: Json, corpus: Map<string, number>): Score {
     // dict(sorted(hits.items(), key=lambda x: -x[1])[:8]) — top-8 by volume desc.
     // Python's sort is stable; ties keep the iteration order of `hits`. Since
     // `hits` here is sorted by token, ties resolve token-ascending — but the
-    // CPython original's `hits` dict ordering is hash-based, so ties COULD differ.
+    // retired CPython implementation's `hits` dict ordering was hash-based, so ties COULD differ.
     // This is a latent non-determinism candidate (see report). We canonicalise to
     // token-ascending tie-break, which the differential test pins.
     const topHits = stableSortByVolumeDesc(hits).slice(0, 8);

package/src/scripts/audit_mcp_tools.ts

@@ -2,8 +2,8 @@
 /**
  * MCP-tool inventory generator.
  *
- * TypeScript twin of `src/scripts/audit_mcp_tools.py` (ADR-200 — Python→TS
- * migration, Phase 8 / Wave 8b). The CLI contract is mirrored EXACTLY —
+ * Ported from the retired Python `src/scripts/audit_mcp_tools.py` (ADR-200 — Python→TS
+ * migration, Phase 8 / Wave 8b). The CLI contract is pinned —
  * the mutually-exclusive `--check` / `--write` flags, `--quiet`, exit codes
  * (0 ok / in-sync · 1 drift), the stdout/stderr split, byte-identical
  * messages, and byte-identical written file content.
@@ -14,7 +14,7 @@
  * `docs/contracts/mcp-tool-inventory.md` with every tool cited by
  * `<file>:<line>`.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';

package/src/scripts/audit_overlap.ts

@@ -3,13 +3,13 @@
  * Trigger-overlap analysis for the Rule-Governance pass (Phase 5.2 of
  * road-to-augment-limit-fit).
  *
- * TypeScript twin of `src/scripts/audit_overlap.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/audit_overlap.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract
  * EXACTLY: no flags, exit codes (0 normal, 1 when the input audit JSON
  * is missing), byte-identical stdout/stderr split, and byte-identical
  * written output (`auto-rules-overlap.json` via json.dumps(indent=2)
  * and the appended `auto-rules-audit.md` section). No behaviour changes
- * — latent bugs replicated.
+ * — historical quirks preserved (consumers pin the exact behaviour).
  *
  * Reads `agents/reports/auto-rules-audit.json` (produced by
  * `audit_auto_rules.py`) and computes:

package/src/scripts/audit_skill_descriptions.ts

@@ -2,8 +2,8 @@
 /**
  * Audit skill descriptions for triggering quality.
  *
- * TypeScript twin of `src/scripts/audit_skill_descriptions.py` (ADR-200,
- * Phase 8 Wave 8a). Mirrors the Python CLI contract EXACTLY — flags
+ * Ported from the retired Python `src/scripts/audit_skill_descriptions.py` (ADR-200,
+ * Phase 8 Wave 8a). The CLI contract is pinned — flags
  * (`--root`, `--json`, `--full`), exit codes (0 / 2), stdout/stderr split,
  * byte-identical text table AND byte-identical JSON (`json.dumps(...,
  * indent=2)`, ensure_ascii=True, field order skill/path/description/

package/src/scripts/audit_skill_overlap.ts

@@ -2,14 +2,14 @@
 /**
  * Skill-family content-overlap analysis (6.0.0-C Phase 4 Step 8).
  *
- * TypeScript twin of `src/scripts/audit_skill_overlap.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/audit_skill_overlap.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the Python CLI
  * contract EXACTLY — the `--threshold` / `--quiet` flags, exit codes
  * (0 ok / 3 no skills), the stdout/stderr split, byte-identical stdout
  * messages, and byte-identical written artefacts (`json.dumps(...,
  * indent=2)` for the JSON + the exact Markdown renderer).
  *
- * No `_lib` imports — the Python original has none; it carries its own
+ * No `_lib` imports — the retired Python implementation has none; it carries its own
  * `_skill_roots()` (which references the `.agent-src.uncondensed/skills`
  * layout literally — this twin reproduces that literal faithfully, since
  * the .py original carries it).
@@ -19,7 +19,7 @@
  * is >= OVERLAP_THRESHOLD. Same-domain (shared `packs:`) >= threshold pairs
  * are the merge candidates. THIS SCRIPT MERGES NOTHING.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -91,8 +91,8 @@ function _iterdirSorted(p: string): string[] {
  *   if not roots and legacy.is_dir(): roots = [legacy]
  *
  * `packages.glob("*\/.agent-src.uncondensed/skills")` iterates packages
- * children sorted (pathlib glob over a single level is unsorted, but the
- * Python original does NOT sort here — it relies on `collect()`'s `seen`
+ * children sorted (pathlib glob over a single level is unsorted, and the
+ * retired Python implementation did NOT sort here — it relied on `collect()`'s `seen`
  * dedup keyed on dir name. To stay deterministic we sort the package
  * children; the resulting root order only affects first-win dedup, and no
  * skill dir name collides across packages in practice.)

package/src/scripts/audit_user_type_axis.ts

@@ -2,8 +2,8 @@
 /**
  * Audit the user-type axis frontmatter coverage (step-9 Phase 4).
  *
- * TypeScript twin of `src/scripts/audit_user_type_axis.py` (ADR-200,
- * Phase 8 / Wave 8a). The CLI contract is mirrored EXACTLY — the single
+ * Ported from the retired Python `src/scripts/audit_user_type_axis.py` (ADR-200,
+ * Phase 8 / Wave 8a). The CLI contract is pinned — the single
  * `--quiet` flag, exit code (1 when orphans exist, else 0), the stdout
  * split, byte-identical stdout summary, AND byte-identical generated
  * Markdown report. Stdlib-only — no YAML dependency.
@@ -15,14 +15,14 @@
  *   2. Unused configs — every `user-types/*.yml` should be consumed by at
  *      least one skill. Unused configs are WARN-only (exit 0).
  *
- * NOTE: the Python original scans only the LEGACY `.agent-src.uncondensed/
+ * NOTE: the retired Python implementation scans only the LEGACY `.agent-src.uncondensed/
  * skills/` root (not the 6.0.0-D `src/skills/` library). This twin replicates
  * that exact root for byte-identical parity. The report path is
  * `agents/reports/user-type-axis-audit.md` (matching the Python constant,
  * which differs from the docstring's `agents/runtime/reports/` mention —
  * latent bug replicated).
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';

package/src/scripts/backfill_model_tier.ts

@@ -2,7 +2,7 @@
 /**
  * Backfill / migrate `model_tier` on every skill and command (ADR-035).
  *
- * TypeScript twin of `src/scripts/backfill_model_tier.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/backfill_model_tier.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8e). The CLI contract is mirrored
  * EXACTLY: same flag (`--dry-run`), same exit code (0), same byte-identical
  * stdout report, and byte-identical frontmatter rewrites of every skill +

package/src/scripts/bench_ab_cache_dispatch.ts

@@ -2,13 +2,13 @@
 /**
  * Cache-aware dispatch for `task bench:ab` arms.
  *
- * TypeScript twin of `src/scripts/bench_ab_cache_dispatch.py` (ADR-200
+ * Ported from the retired Python `src/scripts/bench_ab_cache_dispatch.py` (ADR-200
  * Python→TS migration, Phase 8 / Wave 8d). Mirrors the CLI contract EXACTLY:
  * positional `corpus` (`tracka` / `trackb`), the `REMAINDER` `extra` args
  * forwarded to the underlying runner, exit codes (1 corpus missing, else the
  * underlying runner's return code), and byte-identical stdout/stderr.
  *
- * The Python original shelled out via `sys.executable <runner>.py …`; this twin
+ * the retired Python implementation shelled out via `sys.executable <runner>.py …`; this twin
  * invokes the `.ts` runner twins through the repo-local `tsx` binary (those
  * runners are referenced as runtime subprocesses, not imported logic).
  *

package/src/scripts/bench_ab_clone.ts

@@ -2,8 +2,8 @@
 /**
  * Materialise the `with`, `without`, and `with-rdp` clones for the value bench.
  *
- * TypeScript twin of `src/scripts/bench_ab_clone.py` (ADR-200 py2ts
- * Phase 8 / Wave 8d). The CLI contract mirrors the Python original
+ * Ported from the retired Python `src/scripts/bench_ab_clone.py` (ADR-200 py2ts
+ * Phase 8 / Wave 8d). The CLI contract mirrors the retired Python implementation
  * EXACTLY — `--refresh`, `--variant`, `--print-shape-hash`, exit codes,
  * stdout/stderr split, byte-identical written manifest
  * (`json.dumps(indent=2)` + trailing newline) and the

package/src/scripts/bench_ab_diff.ts

@@ -2,8 +2,8 @@
 /**
  * Diff two A/B reports (one per variant) into a comparison artefact.
  *
- * TypeScript twin of `src/scripts/bench_ab_diff.py` (ADR-200 py2ts
- * Phase 8 / Wave 8d). The CLI contract mirrors the Python original
+ * Ported from the retired Python `src/scripts/bench_ab_diff.py` (ADR-200 py2ts
+ * Phase 8 / Wave 8d). The CLI contract mirrors the retired Python implementation
  * EXACTLY — positional args, `--out-dir`, exit codes, stdout/stderr
  * split, and byte-identical written JSON (`json.dumps(indent=2)` +
  * trailing newline) / Markdown artefacts. No behaviour changes; latent
@@ -44,7 +44,7 @@ type Dict = Record<string, unknown>;
  * Marker for a value that is a Python `float`. CPython's `json.dumps`
  * renders a float `2.0` as `2.0` (not `2`); JS numbers lose that
  * distinction. The `take()` / `mean()` / `round()` helpers in the
- * Python original all return floats, so the diff's numeric fields must
+ * retired Python implementation all returned floats, so the diff's numeric fields must
  * carry the `.0` to stay byte-identical.
  */
 export class PyFloat {

package/src/scripts/bench_ab_integrity.ts

@@ -2,8 +2,8 @@
 /**
  * Assert the two A/B clones differ only in the agent-config surface.
  *
- * TypeScript twin of `src/scripts/bench_ab_integrity.py` (ADR-200 py2ts
- * Phase 8 / Wave 8d). The CLI contract mirrors the Python original
+ * Ported from the retired Python `src/scripts/bench_ab_integrity.py` (ADR-200 py2ts
+ * Phase 8 / Wave 8d). The CLI contract mirrors the retired Python implementation
  * EXACTLY — `--verbose`, exit codes (0 clean / 1 missing-or-divergent /
  * 2 usage), and byte-identical stdout/stderr. No behaviour changes;
  * latent Python bugs are replicated and flagged as divergence

package/src/scripts/bench_ab_run.ts

@@ -2,13 +2,13 @@
 /**
  * Top-level orchestrator for the package-impact A/B bench.
  *
- * TypeScript twin of `src/scripts/bench_ab_run.py` (ADR-200, Phase 8 /
- * Wave 8d). The CLI contract mirrors the Python original EXACTLY — same
+ * Ported from the retired Python `src/scripts/bench_ab_run.py` (ADR-200, Phase 8 /
+ * Wave 8d). The CLI contract pins the historical contract exactly — same
  * `--variant {with,without}` / `--corpus` / `--non-interactive` /
  * `--reuse-cache` flags, same exit codes, stdout-only messages, and
  * byte-identical written report JSON (`json.dumps(indent=2) + "\n"`) and the
- * Markdown layout. No behaviour changes — latent Python quirks are
- * replicated and flagged as divergence candidates.
+ * Markdown layout. No behaviour changes — historical quirks are
+ * preserved and flagged as divergence candidates.
  *
  * NON-DETERMINISM: this script stamps reports with `utc_stamp()` (current
  * UTC) and a `duration_seconds` from a monotonic clock. Those fields are

package/src/scripts/bench_ab_task_runner.ts

@@ -2,7 +2,7 @@
 /**
  * Track B — task runner for the package-impact A/B bench.
  *
- * TypeScript twin of `src/scripts/bench_ab_task_runner.py` (ADR-200 Python→TS
+ * Ported from the retired Python `src/scripts/bench_ab_task_runner.py` (ADR-200 Python→TS
  * migration, Phase 8 / Wave 8d). Mirrors the CLI contract EXACTLY: flags
  * (`--variant`, `--mode`, `--timeout`), exit codes (0 ok / 1 corpus missing or
  * empty), byte-identical stdout/stderr, and byte-identical written JSON + md

package/src/scripts/bench_ab_tracka_run.ts

@@ -2,8 +2,8 @@
 /**
  * Track A — behavioural eval runner for the package-impact A/B bench.
  *
- * TypeScript twin of `src/scripts/bench_ab_tracka_run.py` (ADR-200, Phase 8 /
- * Wave 8d). The CLI contract mirrors the Python original EXACTLY — same
+ * Ported from the retired Python `src/scripts/bench_ab_tracka_run.py` (ADR-200, Phase 8 /
+ * Wave 8d). The CLI contract pins the historical contract exactly — same
  * `--variant {with,without,both}` flag, same exit codes, stdout/stderr split,
  * byte-identical messages, and byte-identical written report JSON
  * (`json.dumps(indent=2) + "\n"`) + Markdown. No behaviour changes — latent

package/src/scripts/bench_ab_v2_run.ts

@@ -2,7 +2,7 @@
 /**
  * bench:ab v2 — discipline-axis runner (Phases 2-4).
  *
- * TypeScript twin of `src/scripts/bench_ab_v2_run.py` (ADR-200 Python→TS
+ * Ported from the retired Python `src/scripts/bench_ab_v2_run.py` (ADR-200 Python→TS
  * migration). Mirrors the CLI contract EXACTLY: flags (`--arms`, `--seeds`,
  * `--tasks`, `--limit`, `--model`, `--budget`, `--timeout`, `--mode`), exit
  * codes (0 ok / 1 unknown arm or missing CLI), byte-identical stdout/stderr,

package/src/scripts/bench_ab_v2_stats.ts

@@ -2,7 +2,7 @@
 /**
  * bench:ab v2 — paired statistics (Phase 3).
  *
- * TypeScript twin of `src/scripts/bench_ab_v2_stats.py` (ADR-200 Python→TS
+ * Ported from the retired Python `src/scripts/bench_ab_v2_stats.py` (ADR-200 Python→TS
  * migration). Mirrors the CLI contract EXACTLY: positional `report` arg, the
  * `--json` / `--markdown PATH` flags, exit codes (0 ok / 1 no report found),
  * byte-identical stdout/stderr, byte-identical analysis JSON, and byte-identical
@@ -22,7 +22,7 @@
  *
  * Float parity: `math.erf` is ported from CPython's `m_erf` series and `math.comb`
  * from an exact BigInt computation, so every `round(p, 4)` / `round(h, 4)` output
- * is byte-identical to the Python original.
+ * is byte-stable — downstream consumers and checksum gates pin these bytes.
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';

package/src/scripts/bench_baseline_ready.ts

@@ -2,7 +2,7 @@
 /**
  * Baseline-closure check — step-4 Phase 3 Step 4.
  *
- * TypeScript twin of `src/scripts/bench_baseline_ready.py` (ADR-200 Python→TS
+ * Ported from the retired Python `src/scripts/bench_baseline_ready.py` (ADR-200 Python→TS
  * migration, Phase 8 / Wave 8d). Mirrors the CLI contract EXACTLY: flags
  * (`--corpus`, `--reports-dir`, `--baseline-file`, `--min-days`,
  * `--min-reports`, `--json`), exit codes (0 ready / 1 file error / 2 not

package/src/scripts/bench_condense_memory.ts

@@ -2,9 +2,9 @@
 /**
  * Offline bench for input-side memory condensation (Phase 2 / Step 11).
  *
- * TypeScript twin of `src/scripts/bench_condense_memory.py` (ADR-200,
- * Phase 7 / dev-side memory). The public API and CLI contract mirror the
- * Python original EXACTLY — same exit code, stdout/stderr, byte-identical
+ * Ported from the retired Python `src/scripts/bench_condense_memory.py` (ADR-200,
+ * Phase 7 / dev-side memory). The public API and CLI contract are pinned
+ * — same exit code, stdout/stderr, byte-identical
  * generated reports (`internal/bench/reports/telegraph-v2.{json,md}`,
  * matching json.dumps(indent=2) + the Markdown layout / number formats).
  * No behaviour changes — latent Python bugs are replicated and flagged as
@@ -16,7 +16,7 @@
  * (no API calls).
  *
  * The condense step is run as a subprocess against the `condense_memory`
- * twin in this repo (via the tsx runner), mirroring the Python original's
+ * twin in this repo (via the tsx runner), mirroring the retired Python implementation's
  * `subprocess.run([sys.executable, CONDENSE_SCRIPT, ...])`.
  */
 

package/src/scripts/bench_drift_check.ts

@@ -2,12 +2,12 @@
 /**
  * Drift detector for the bench corpus — step-4 Phase 3 Step 2.
  *
- * TypeScript twin of `src/scripts/bench_drift_check.py` (ADR-200, Phase 8 /
- * Wave 8d). The CLI contract mirrors the Python original EXACTLY — same
+ * Ported from the retired Python `src/scripts/bench_drift_check.py` (ADR-200, Phase 8 /
+ * Wave 8d). The CLI contract pins the historical contract exactly — same
  * flags, same exit codes (0 no-drift/warmup, 1 read error, 2 drift), same
  * stdout/stderr split, byte-identical `--json` payload
  * (`json.dumps(indent=2)` / compact warmup) and Markdown lines. No behaviour
- * changes — latent Python quirks are replicated and flagged as divergence
+ * changes — historical quirks are preserved and flagged as divergence
  * candidates.
  *
  * The drift VERDICT logic is deterministic against a fixed set of reports;

package/src/scripts/bench_per_tool.ts

@@ -2,7 +2,7 @@
 /**
  * Per-tool projection-fidelity bench — step-4 Phase 4.
  *
- * TypeScript twin of `src/scripts/bench_per_tool.py` (ADR-200 Python→TS
+ * Ported from the retired Python `src/scripts/bench_per_tool.py` (ADR-200 Python→TS
  * migration, Phase 8 / Wave 8d). Mirrors the CLI contract EXACTLY: flags
  * (`--corpus`, `--top-k`, `--threshold`, `--json`, `--write-report`), exit
  * codes (0 / 1 below-threshold / 2 corpus not found), byte-identical

package/src/scripts/bench_rtk_savings.ts

@@ -2,8 +2,8 @@
 /**
  * Measure rtk's token savings on a fixed corpus of verbose CLI invocations.
  *
- * TypeScript twin of `src/scripts/bench_rtk_savings.py` (ADR-200 py2ts
- * Phase 8 / Wave 8d). The CLI contract mirrors the Python original
+ * Ported from the retired Python `src/scripts/bench_rtk_savings.py` (ADR-200 py2ts
+ * Phase 8 / Wave 8d). The CLI contract mirrors the retired Python implementation
  * EXACTLY — `--corpus`, `--out`, `--quiet`, exit codes, stdout/stderr
  * split, the one-line headline summary, and byte-identical written
  * reports (`json.dumps(indent=2, ensure_ascii=False)` + trailing
@@ -53,7 +53,7 @@ type Dict = Record<string, unknown>;
  * Marker for a value that is a Python `float`. CPython's `json.dumps`
  * renders a float `0.0` as `0.0` (not `0`); JS numbers lose that
  * distinction. Wrapping the report's float fields keeps the written
- * JSON byte-identical with the Python original.
+ * JSON byte-identical with the retired Python implementation.
  */
 class PyFloat {
     constructor(readonly value: number) {}
@@ -366,7 +366,7 @@ export function run(corpus_path: string = DEFAULT_CORPUS, out_dir: string = DEFA
 
 /**
  * Mirror Path.relative_to(REPO_ROOT) — raises (ValueError-equivalent) when
- * the path is not under REPO_ROOT, matching the Python original's behaviour.
+ * the path is not under REPO_ROOT, matching the retired Python implementation's behaviour.
  */
 function _relativeToRepo(p: string): string {
     const resolvedRoot = path.resolve(REPO_ROOT);

package/src/scripts/bench_run.ts

@@ -2,8 +2,8 @@
 /**
  * Bench orchestrator — step-4 measurement-and-benchmark Phase 2.
  *
- * TypeScript twin of `src/scripts/bench_run.py` (ADR-200, Phase 8 /
- * Wave 8d). The CLI contract mirrors the Python original EXACTLY — same
+ * Ported from the retired Python `src/scripts/bench_run.py` (ADR-200, Phase 8 /
+ * Wave 8d). The CLI contract pins the historical contract exactly — same
  * flags, exit codes, stdout/stderr split, byte-identical headline / Markdown
  * stdout and byte-identical written report JSON
  * (`json.dumps(indent=2) + "\n"`). No behaviour changes — latent Python
@@ -23,7 +23,7 @@
  * `ai_council.clients` module (it carries no legacy source-tree literal, so
  * ADR-051 does not require porting it in this wave). The `--telegraph-dry-run`
  * path is fully self-contained; the live path degrades to the same "cannot
- * build Anthropic client" exit-2 surface the Python original produces when the
+ * build Anthropic client" exit-2 surface the retired Python implementation produces when the
  * client can't be built. Flagged as a divergence candidate.
  */
 import * as fs from 'node:fs';
@@ -390,7 +390,7 @@ function _run_telegraph(args: Args): number {
 /**
  * Live-API telegraph path. Builds the Anthropic client; on any failure prints
  * the same "cannot build Anthropic client" message and returns 2, mirroring
- * the Python original's `try/except Exception` guard. Because the
+ * the retired Python implementation's `try/except Exception` guard. Because the
  * `ai_council.clients` twin is not yet present, this currently always takes
  * the failure branch (flagged divergence — the live happy path is unreachable
  * until that module is ported).

package/src/scripts/bench_runner.ts

@@ -2,7 +2,7 @@
 /**
  * Bench runner for the eval corpora — step-4 measurement-and-benchmark Phase 1.
  *
- * TypeScript twin of `src/scripts/bench_runner.py` (ADR-200 Python→TS
+ * Ported from the retired Python `src/scripts/bench_runner.py` (ADR-200 Python→TS
  * migration, Phase 8 / Wave 8d). Mirrors the CLI contract EXACTLY: flags
  * (`--corpus`, `--top-k`, `--json`), exit codes (0 PASS / 1 FAIL / 2 corpus
  * not found), byte-identical stdout/stderr, and byte-identical JSON