@event4u/agent-config 8.4.0 → 8.5.0

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

package/src/scripts/build_cloud_bundle.ts

@@ -2,7 +2,7 @@
 /**
  * build_cloud_bundle.ts — package skills as Anthropic Skills ZIP bundles.
  *
- * TypeScript twin of `src/scripts/build_cloud_bundle.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/build_cloud_bundle.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8b). The CLI contract is mirrored
  * EXACTLY — the mutually-exclusive `--skill` / `--all` / `--check` flags,
  * `--out` / `--strict-budget` / `--clean`, exit codes, the stdout/stderr
@@ -12,7 +12,7 @@
  * CONTENTS written into each ZIP are byte-identical.
  *
  * Imports the `audit_cloud_compatibility` twin (the SAME `scan` /
- * `detect_cloud_marker` surfaces the Python original imports) for tier
+ * `detect_cloud_marker` surfaces the retired Python implementation imports) for tier
  * classification.
  *
  * DIVERGENCE CANDIDATE (documented under the ADR-200 process):
@@ -25,7 +25,7 @@
  * compares decompressed entry maps (name → bytes), the manifest JSON, and the
  * console output — not the raw archive bytes.
  *
- * Note on error semantics: the Python original raises bare
+ * Note on error semantics: the retired Python implementation raises bare
  * `SystemExit("❌  …")` for budget / source / T3-H failures. A string
  * SystemExit prints the message to stderr and exits with code 1 (NOT the
  * 2/3/4/5 codes named in the docstring, which never fire). This twin

package/src/scripts/build_discovery_manifest.ts

@@ -2,8 +2,8 @@
 /**
  * Release-time discovery scanner — produces discovery-manifest.json.
  *
- * TypeScript twin of `src/scripts/build_discovery_manifest.py` (ADR-200,
- * Phase 5). The CLI contract is mirrored EXACTLY — every flag (`--write`,
+ * Ported from the retired Python `src/scripts/build_discovery_manifest.py` (ADR-200,
+ * Phase 5). The CLI contract is pinned — every flag (`--write`,
  * `--out`, `--summary`, `--deprecation-report`, `--trust-report`,
  * `--orphan-report`, `--workspaces-json`, `--packs-json`, `--strict`,
  * `--quiet`), the CI-strict env override, exit codes, the stdout/stderr
@@ -20,18 +20,17 @@
  *
  * Imports the `_lib/agent_src` twin for the artefact walk and the
  * `validate_frontmatter` twin for frontmatter parse + schema-default
- * injection (the SAME functions the Python original imports). The checksum
+ * injection (the SAME functions the retired Python implementation imports). The checksum
  * primitive `_artefact_checksum` / `_CATEGORY_SCHEMA` / `_FRONTMATTER_RE` are
  * replicated here EXACTLY and kept in agreement with the inline copy in
  * `check_artefact_checksums.ts`.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  *
  * DIVERGENCE CANDIDATE (documented under the ADR-200 process):
- * `_scanner_version()` in the Python original hashes the scanner file's OWN
- * bytes (`Path(__file__).read_bytes()`). For the TS-built manifest to remain
- * byte-identical to the Python-built one — and to keep passing the
- * Python-rebuild diff in `validate_discovery_manifest.py` — this twin hashes
+ * `_scanner_version()` in the retired Python implementation hashes the scanner file's OWN
+ * bytes (`Path(__file__).read_bytes()`). During the migration the TS-built
+ * manifest had to match the Python-built one byte-for-byte, so this port hashes
  * the SIBLING `build_discovery_manifest.py` bytes (falling back to its own
  * `.ts` bytes only when the `.py` is absent, e.g. after the same-PR deletion).
  * Until the `.py` is deleted the manifest is byte-identical; after deletion
@@ -68,7 +67,7 @@ const _HERE = fileURLToPath(import.meta.url);
 
 // --- Module-level path config (mutable to mirror Python monkeypatch seam) ----
 //
-// The Python original derives ROOT / SRC / VOCAB_DIR / DEFAULT_* as
+// the retired Python implementation derives ROOT / SRC / VOCAB_DIR / DEFAULT_* as
 // module-level constants and `tests/test_build_discovery_manifest.py`
 // reassigns `mod.ROOT`, `mod.SRC`, `mod.VOCAB_DIR`, `mod.artefact_roots`, and
 // `mod.resolve_logical` via monkeypatch. To preserve that injection surface,
@@ -314,11 +313,10 @@ function _vocab(): [VocabEntry[], VocabEntry[], Record<string, string>] {
 }
 
 function _scanner_version(): string {
-    // DIVERGENCE CANDIDATE: hash the SIBLING build_discovery_manifest.py bytes
-    // so the manifest stays byte-identical to the Python-built one (and keeps
-    // passing the Python-rebuild diff in validate_discovery_manifest.py). Fall
-    // back to this twin's own bytes once the .py is deleted (same-PR; the
-    // manifest is regenerated then anyway).
+    // Scanner version = hash of this file's own bytes (the .py-sibling branch
+    // below is inert since the teardown — no sibling exists; kept because the
+    // manifest checksum gates pin the current output and removing the branch
+    // is a behaviour-neutral cleanup for its own change).
     const pyPath = path.join(path.dirname(_HERE), 'build_discovery_manifest.py');
     const target = _isFile(pyPath) ? pyPath : _HERE;
     const h = crypto.createHash('sha256').update(fs.readFileSync(target)).digest('hex');
@@ -827,7 +825,7 @@ function _cmpStr(a: string, b: string): number {
  * 0, "" and the EMPTY array/object — distinct from JS, where `[]`/`{}` are
  * truthy. Used at the optional-field emission sites in `_build` so an empty
  * `optional_packs` / `example_roles` / `suggests` is omitted exactly as the
- * Python original omits it.
+ * retired Python implementation omitted it.
  */
 function _pyTruthy(v: Json): boolean {
     if (v === undefined || v === null || v === false || v === '' || v === 0) {

package/src/scripts/build_linear_digest.ts

@@ -2,7 +2,7 @@
 /**
  * build_linear_digest.ts — build the Linear AI rules digest.
  *
- * TypeScript twin of `src/scripts/build_linear_digest.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/build_linear_digest.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8b). The CLI contract is mirrored
  * EXACTLY — the `--max-bytes` / `--out-dir` / `--strict-missing` flags,
  * exit codes (0 ok · 2 over-budget · 3 missing rule file · 4
@@ -12,7 +12,7 @@
  * Concatenates a curated set of cloud-safe rules from `dist/agent-src/rules/`
  * into three Markdown files under `dist/linear/`.
  *
- * 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/build_mcp_registry_manifest.ts

@@ -2,8 +2,8 @@
 /**
  * Build `dist/mcp/registry-manifest.json` + the two rendered payloads.
  *
- * TypeScript twin of `src/scripts/build_mcp_registry_manifest.py` (ADR-200,
- * Phase 5). The CLI contract is mirrored EXACTLY — every flag (`--write`,
+ * Ported from the retired Python `src/scripts/build_mcp_registry_manifest.py` (ADR-200,
+ * Phase 5). The CLI contract is pinned — every flag (`--write`,
  * `--strict`, `--quiet`), exit codes (0 = ok; 2 = `--strict` drift without
  * `--write`; 1 = missing discovery prereq via SystemExit), the stdout/stderr
  * split, byte-identical messages, AND byte-identical generated output:
@@ -16,7 +16,7 @@
  * (`status`, `submitted_at`, `pr_url`, `last_verified`) is preserved from the
  * previous manifest.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  *
  * Schema: `docs/contracts/mcp-registry-manifest.schema.json`
  */