@event4u/agent-config 8.4.1 → 8.5.0

package/src/scripts/memory_lookup.ts

@@ -2,8 +2,8 @@
 /**
  * File-first memory retrieval.
  *
- * TypeScript twin of `src/scripts/memory_lookup.py` (ADR-200). The public
- * API and CLI contract mirror the Python original EXACTLY — same exported
+ * Ported from the retired Python `src/scripts/memory_lookup.py` (ADR-200). The public
+ * API and CLI contract mirror the retired Python implementation EXACTLY — same exported
  * names (snake_case kept deliberately, especially `retrieve(...)` whose
  * signature/return shape is cited by rules), same exit codes, stdout/stderr
  * split, byte-identical messages, same memory-file scan + ranking + JSON
@@ -40,7 +40,7 @@ import YAML, { parseDocument } from 'yaml';
 // timestamp into a `datetime.datetime`. The `yaml` npm parses both to JS Date
 // objects whose String()/JSON form differs, so `json.dumps(..., default=str)`
 // in the CLI would not match. This marker preserves PyYAML's str() form so
-// JSON output and as_dict() are byte-identical to the Python original.
+// JSON output and as_dict() are byte-stable — downstream consumers and checksum gates pin these bytes.
 const PYYAML_DATE_ONLY_RE = /^[0-9]{4}-[0-9]{2}-[0-9]{2}$/;
 const PYYAML_TIMESTAMP_RE =
     /^(?:[0-9]{4}-[0-9]{2}-[0-9]{2}|[0-9]{4}-[0-9]{1,2}-[0-9]{1,2}(?:[Tt]|[ \t]+)[0-9]{1,2}:[0-9]{2}:[0-9]{2}(?:\.[0-9]*)?(?:[ \t]*(?:Z|[-+][0-9]{1,2}(?::[0-9]{2})?))?)$/;
@@ -191,7 +191,7 @@ function _load_yaml(p: string): unknown {
             const raw = text.slice(node.range[0], node.range[1]);
             // Under YAML 1.1 the `yaml` lib resolves plain timestamp scalars to
             // JS Date objects. Recover PyYAML's str() form from the original
-            // source so JSON output / as_dict() match the Python original.
+            // source so JSON output / as_dict() match the retired Python implementation.
             if (node.value instanceof Date) {
                 if (PYYAML_DATE_ONLY_RE.test(raw)) {
                     (node as { value: unknown }).value = new PyTimestamp(raw);
@@ -476,10 +476,10 @@ export function _score(entry: Record<string, unknown>, keys: string[]): number {
 /**
  * Project cross-repo matches into discounted, tagged Hits.
  *
- * Lazy + guarded: the Python original imports `cross_repo_retrieve` on
+ * Lazy + guarded: the retired Python implementation imports `cross_repo_retrieve` on
  * demand and swallows any failure (script absent, no opted-in siblings) so
  * the cross-repo type degrades to zero hits rather than breaking retrieval.
- * The TypeScript twin of `cross_repo_retrieve` is unported in this phase, so
+ * The Ported from the retired Python `cross_repo_retrieve` is unported in this phase, so
  * this always degrades to zero hits — flagged as a divergence candidate.
  * Scores sit below curated/knowledge (0.85× floor, then a small per-rank
  * decrement) so cross-repo context never outranks the project's own truth.

package/src/scripts/memory_report.ts

@@ -2,7 +2,7 @@
 /**
  * One-shot memory observability report.
  *
- * TypeScript twin of `src/scripts/memory_report.py` (ADR-200, Phase 7 /
+ * Ported from the retired Python `src/scripts/memory_report.py` (ADR-200, Phase 7 /
  * dev-side memory). The public API and CLI contract mirror the Python
  * original EXACTLY — same exported names (snake_case kept deliberately),
  * same exit codes, stdout/stderr split, byte-identical messages, and

package/src/scripts/memory_signal.ts

@@ -2,7 +2,7 @@
 /**
  * Write-side helper: drop an engineering-memory signal.
  *
- * TypeScript twin of `src/scripts/memory_signal.py` (ADR-200, Phase 7 /
+ * Ported from the retired Python `src/scripts/memory_signal.py` (ADR-200, Phase 7 /
  * dev-side memory). The public API and CLI contract mirror the Python
  * original EXACTLY — same exported names (snake_case kept deliberately),
  * same exit codes, stdout/stderr split, byte-identical messages, same

package/src/scripts/memory_status.ts

@@ -2,8 +2,8 @@
 /**
  * File-backed memory status (no external backend).
  *
- * TypeScript twin of `src/scripts/memory_status.py` (ADR-200). The public
- * API and CLI contract mirror the Python original EXACTLY — same exported
+ * Ported from the retired Python `src/scripts/memory_status.py` (ADR-200). The public
+ * API and CLI contract mirror the retired Python implementation EXACTLY — same exported
  * names (snake_case kept deliberately), same exit codes, stdout/stderr
  * split, byte-identical messages and JSON shape. No behaviour changes.
  *

package/src/scripts/migrate_command_suggestions.ts

@@ -3,7 +3,7 @@
  * One-shot migration: inject the `suggestion:` frontmatter block into every
  * command under `.agent-src.uncondensed/commands/`.
  *
- * TypeScript twin of `src/scripts/migrate_command_suggestions.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/migrate_command_suggestions.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8e). Faithful twin: the legacy
  * `.agent-src.uncondensed/commands/` path is part of the original module's
  * contract and is reproduced verbatim. Public surface mirrors the Python module

package/src/scripts/migrate_frontmatter_defaults.ts

@@ -2,7 +2,7 @@
 /**
  * Migrate artefact frontmatter to omit fields equal to their schema default.
  *
- * TypeScript twin of `src/scripts/migrate_frontmatter_defaults.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/migrate_frontmatter_defaults.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8e). Public surface mirrors the Python
  * module exactly: same CLI flags (`--dry-run`, `--deltas PATH`), same exit code
  * (0), same stdout summary, and byte-identical rewritten files + dry-run delta

package/src/scripts/mine_session.ts

@@ -2,8 +2,8 @@
 /**
  * Mine a session for memory signals — the engine behind `/memory mine`.
  *
- * TypeScript twin of `src/scripts/mine_session.py` (ADR-200 — Python→TS
- * migration, Phase 8 / Wave 8g). Mirrors the Python CLI contract EXACTLY —
+ * Ported from the retired Python `src/scripts/mine_session.py` (ADR-200 — Python→TS
+ * migration, Phase 8 / Wave 8g). The CLI contract is pinned —
  * every flag, exit code (0), the stdout/stderr split, byte-identical
  * messages, byte-identical preview Markdown, and byte-identical
  * `json.dumps(..., ensure_ascii=False)` intake JSONL lines.
@@ -26,7 +26,7 @@
  *
  * Auto-resolved transcript discovery (`rglob` sorted by mtime) is
  * intrinsically non-deterministic; golden parity supplies a fixed
- * `--transcript`. No behaviour changes — latent Python quirks replicated.
+ * `--transcript`. Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  */
 import * as crypto from 'node:crypto';
 import * as fs from 'node:fs';

package/src/scripts/minimal_safe_diff_hook.ts

@@ -2,7 +2,7 @@
 /**
  * Platform-agnostic hook for the `minimal-safe-diff` rule.
  *
- * TypeScript twin of `src/scripts/minimal_safe_diff_hook.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/minimal_safe_diff_hook.py` (ADR-200 —
  * Python→TS migration, Phase 6 / hooks). Public API mirrors the Python
  * module exactly (snake_case kept deliberately — fidelity over TS idiom).
  *
@@ -39,7 +39,7 @@ import { atomic_write_json } from "./hooks/state_io.js";
 
 // NOTE: the Python docstring says `agents/runtime/state/`, but the code
 // constant is `agents/state/`. Replicated verbatim — latent docstring/code
-// divergence in the Python original (ADR-200 § replicate latent bugs).
+// divergence in the retired Python implementation (ADR-200 § replicate latent bugs).
 export const STATE_FILE = path.join("agents", "state", "minimal-safe-diff.json");
 export const SETTINGS_FILE = ".agent-settings.yml";
 export const DEFAULT_THRESHOLD = 5;

package/src/scripts/move_artefact.ts

@@ -2,10 +2,10 @@
 /**
  * Move a single artefact between packs via `git mv` (history-preserving).
  *
- * TypeScript twin of `src/scripts/move_artefact.py` (ADR-200, Phase 8 /
+ * Ported from the retired Python `src/scripts/move_artefact.py` (ADR-200, Phase 8 /
  * Wave 8b). The public surface, CLI contract, exit codes, stdout/stderr
- * split, byte-for-byte messages, and the `git mv` semantics mirror the
- * Python original EXACTLY. The frontmatter rewrite reproduces PyYAML's
+ * split, byte-for-byte messages, and the `git mv` semantics are pinned by
+ * tests. The frontmatter rewrite reproduces PyYAML's
  * `safe_dump(..., sort_keys=False, allow_unicode=True)` output through a
  * faithful port of the PyYAML emitter (scalar-style resolution, plain /
  * single-quoted / double-quoted writers with the same best-width=80

package/src/scripts/new_skill.ts

@@ -2,8 +2,8 @@
 /**
  * Interactive scaffolder for new skills under the packages/ layout.
  *
- * TypeScript twin of `src/scripts/new_skill.py` (ADR-200 — Python→TS
- * migration, Phase 8 / Wave 8b). The CLI contract is mirrored EXACTLY —
+ * Ported from the retired Python `src/scripts/new_skill.py` (ADR-200 — Python→TS
+ * migration, Phase 8 / Wave 8b). The CLI contract is pinned —
  * the `--pack` / `--type` / `--name` / `--description` / `--workspace`
  * (repeatable) / `--force` flags, exit codes (0 ok · 1 file exists · 2
  * usage / validation), the stdout/stderr split, byte-identical messages,
@@ -15,7 +15,7 @@
  *   - rule     → rules/<name>.md
  *   - command  → commands/<name>.md
  *
- * 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/onboarding_gate_hook.ts

@@ -2,7 +2,7 @@
 /**
  * Platform-agnostic hook for the `onboarding-gate` rule.
  *
- * TypeScript twin of `src/scripts/onboarding_gate_hook.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/onboarding_gate_hook.py` (ADR-200 —
  * Python→TS migration, Phase 6 / hooks). Public API mirrors the Python
  * module exactly (snake_case kept deliberately — fidelity over TS idiom).
  *
@@ -40,7 +40,7 @@ import { atomic_write_json } from "./hooks/state_io.js";
 export const SETTINGS_FILE = ".agent-settings.yml";
 // NOTE: the Python docstring says `agents/runtime/state/`, but the code
 // constant is `agents/state/`. Replicated verbatim — this is a latent
-// docstring/code divergence in the Python original (ADR-200 § replicate
+// docstring/code divergence in the retired Python implementation (ADR-200 § replicate
 // latent bugs), and `STATE_FILE` is what the test suite asserts against.
 export const STATE_DIR = path.join("agents", "state");
 export const STATE_FILE = path.join(STATE_DIR, "onboarding-gate.json");

package/src/scripts/pack_mcp_content.ts

@@ -23,7 +23,7 @@
 //
 // Governed by `docs/contracts/mcp-cloud-scope.md` §A0-cloud invariant 5.
 //
-// TS twin of pack_mcp_content.py (py2ts migration, ADR-200). Byte-identical
+// TS port of the retired Python pack_mcp_content.py (ADR-200). Byte-identical
 // twin: same five scanners, same wire shape, same compact-JSON / indent=2
 // manifest serialization, same gzip archival copy (mtime=0, level 9, with
 // Python's OS=0xFF header byte). The .py stays the deploy entrypoint until

package/src/scripts/parity/replay.ts

@@ -1,6 +1,7 @@
 /**
- * Golden-replay runner — proves a TypeScript port behaves identically to its
- * Python original.
+ * Golden-replay runner — proves a TypeScript port behaves identically to the
+ * retired Python implementation it replaced (golden transcripts were captured
+ * before the teardown).
  *
  * CLI:
  *   tsx src/scripts/parity/replay.ts \

package/src/scripts/pattern_share.ts

@@ -2,7 +2,7 @@
 /**
  * Maintainer dev script — export / import file-first patterns across projects.
  *
- * TypeScript twin of `src/scripts/pattern_share.py` (ADR-200). Mirrors the
+ * Ported from the retired Python `src/scripts/pattern_share.py` (ADR-200). Mirrors the
  * Python CLI contract EXACTLY — the `export` / `import` subcommands, their
  * positional + flag args (`--out`, `--force`), exit codes (0 / 1 / 2),
  * stdout/stderr split, the byte-identical refusal/success lines (`❌  …` /
@@ -245,7 +245,7 @@ function _isFlag(a: string): boolean {
     return a.startsWith('-') && a !== '-';
 }
 
-// argparse precedence (verified against the Python original):
+// argparse precedence (verified against the retired Python implementation):
 //   1. an optional that needs a value but is missing it → SUB-level error
 //      "argument --out: expected one argument" (during consumption).
 //   2. a missing required positional → SUB-level error

package/src/scripts/plan_physical_move.ts

@@ -2,7 +2,7 @@
 /**
  * Plan + apply the physical monorepo migration (Phase 4).
  *
- * TypeScript twin of `src/scripts/plan_physical_move.py` (ADR-200, Phase 8 /
+ * Ported from the retired Python `src/scripts/plan_physical_move.py` (ADR-200, Phase 8 /
  * Wave 8b). Mirrors the CLI contract EXACTLY — the `--apply`, `--out` flags,
  * exit codes (0 clean dry-run / 1 dry-run-with-conflicts / 2 refuse-apply /
  * 3 source-missing / 4 git-mv-failed), the stdout/stderr split, byte-identical
@@ -13,9 +13,9 @@
  * destination under `packages/core/` or `packages/pack-<id>/`, and emits
  * `dist/migration/move-plan.json`. `--apply` executes the moves via `git mv`.
  *
- * No behaviour changes — latent Python quirks replicated. (The dry-run path
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour. (The dry-run path
  * writes the plan JSON to BOTH the default location and `--out`; when they
- * coincide the file is written twice, exactly as the Python original does.)
+ * coincide the file is written twice, exactly as the retired Python implementation does.)
  */
 import { spawnSync } from 'node:child_process';
 import * as fs from 'node:fs';

package/src/scripts/prediction-pool/poisson_sim.ts

@@ -2,8 +2,8 @@
 /**
  * Poisson tournament simulator for prediction-pool-optimizer.
  *
- * TypeScript twin of `src/scripts/prediction-pool/poisson_sim.py` (ADR-200).
- * The CLI contract is mirrored EXACTLY — the positional `config` JSON file,
+ * Ported from the retired Python `src/scripts/prediction-pool/poisson_sim.py` (ADR-200).
+ * The CLI contract is pinned — the positional `config` JSON file,
  * `--runs` / `--seed`, exit codes, the stdout/stderr split, and byte-identical
  * output. No behaviour changes.
  *

package/src/scripts/prediction-pool/pool_winsim.ts

@@ -2,8 +2,8 @@
 /**
  * Field model + P(finish 1st) simulator for prediction-pool-optimizer.
  *
- * TypeScript twin of `src/scripts/prediction-pool/pool_winsim.py` (ADR-200).
- * The CLI contract is mirrored EXACTLY — the positional `config` JSON file,
+ * Ported from the retired Python `src/scripts/prediction-pool/pool_winsim.py` (ADR-200).
+ * The CLI contract is pinned — the positional `config` JSON file,
  * `--runs` / `--max-flips` / `--max-opponents` / `--top-flip` / `--seed` /
  * `--json`, exit codes, the stdout/stderr split, and byte-identical text AND
  * `--json` output. No behaviour changes.

package/src/scripts/prediction-pool/score_ev.ts

@@ -2,8 +2,8 @@
 /**
  * Exact-score EV optimiser for prediction-pool-optimizer.
  *
- * TypeScript twin of `src/scripts/prediction-pool/score_ev.py` (ADR-200,
- * Phase 8). The CLI contract is mirrored EXACTLY — the positional `matches`
+ * Ported from the retired Python `src/scripts/prediction-pool/score_ev.py` (ADR-200,
+ * Phase 8). The CLI contract is pinned — the positional `matches`
  * JSON file, `--lh` / `--la` / `--exact` / `--diff` / `--tendency` /
  * `--max-tip` / `--top` / `--json`, exit codes, the stdout/stderr split, and
  * byte-identical text AND `--json` output. No behaviour changes.

package/src/scripts/print_required_checks.ts

@@ -2,8 +2,8 @@
 /**
  * Print the expected required-check set for the current branch.
  *
- * TypeScript twin of `src/scripts/print_required_checks.py` (ADR-200,
- * Phase 8 / Wave 8g). Mirrors the Python CLI contract EXACTLY — `--branch`
+ * Ported from the retired Python `src/scripts/print_required_checks.py` (ADR-200,
+ * Phase 8 / Wave 8g). The CLI contract is pinned — `--branch`
  * / `--base` flags, PR-shape classification (release / docs-only / feature),
  * exit codes (0 ok, 1 release-shape OUT-OF-SHAPE fallback-to-feature, 2 usage),
  * stdout/stderr split, byte-identical messages. Reuses the release-shape

package/src/scripts/probe_projection_fidelity.ts

@@ -2,13 +2,13 @@
 /**
  * Phase 4.2 — Probe per-tool projection fidelity against the fixture.
  *
- * TypeScript twin of `src/scripts/probe_projection_fidelity.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/probe_projection_fidelity.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract
  * EXACTLY: flags (`--fixture`, `--report`), exit codes (0 when no fail, 1
  * when any check fails, 2 when the YAML dependency is missing — replicated
  * via a try/catch import), byte-identical stdout, and the byte-identical
  * written report (`json.dumps(report, indent=2) + "\n"`). No behaviour
- * changes — latent quirks replicated.
+ * changes — historical quirks preserved (consumers pin the exact behaviour).
  *
  * Reads tests/fixtures/projection_fidelity/fixtures.yml, walks the
  * projected trees (.augment/, .claude/, .cursor/, .clinerules/,

package/src/scripts/probe_skill_registration.ts

@@ -2,12 +2,12 @@
 /**
  * Tool-agnostic skill-registration probe.
  *
- * TypeScript twin of `src/scripts/probe_skill_registration.py` (ADR-090 —
+ * Ported from the retired Python `src/scripts/probe_skill_registration.py` (ADR-090 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract
  * EXACTLY: flags (`--tool`, `--scope`, `--format`, `--strict`, `--home`,
  * `--project`), exit codes (0 informational / 0 when strict & clean, 2
  * when strict & findings), byte-identical text + JSON stdout, and the same
- * dataclass field order. No behaviour changes — latent quirks replicated.
+ * dataclass field order. Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  *
  * Roadmap: road-to-clean-skill-distribution-channels.md § Phase C.
  * Contract: docs/contracts/skill-distribution-channels.md.

package/src/scripts/profile_staleness_hook.ts

@@ -2,7 +2,7 @@
 /**
  * Session-profile staleness notice — `session_start` hook.
  *
- * TypeScript twin of `src/scripts/profile_staleness_hook.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/profile_staleness_hook.py` (ADR-200 —
  * Python→TS migration, Phase 6 / hooks). Public API mirrors the Python
  * module exactly (snake_case kept deliberately — fidelity over TS idiom).
  *
@@ -18,7 +18,7 @@
  * notice is derived from the overlay file), emits at most one stderr line,
  * returns 0 on every path.
  *
- * NOTE (ADR-200): the Python original imports `scripts.config.session_profiles`,
+ * NOTE (ADR-200): the retired Python implementation imports `scripts.config.session_profiles`,
  * which is UNPORTED. The only entry point this hook touches is
  * `session_profiles.stale_notice(root)`, a fail-open read of the overlay file
  * (`agents/settings/.agent-settings.local.yml` → `runtime.active_packs`) plus a

package/src/scripts/profile_use.ts

@@ -2,8 +2,8 @@
 /**
  * `agent-config use --profile=<id>` — switch the active experience.
  *
- * TypeScript twin of `src/scripts/profile_use.py` (ADR-200 — Python→TS
- * migration, Phase 8 / Wave 8e). The CLI contract is mirrored EXACTLY:
+ * Ported from the retired Python `src/scripts/profile_use.py` (ADR-200 — Python→TS
+ * migration, Phase 8 / Wave 8e). The CLI contract is pinned:
  * same flags (`--profile=<id>` / `--profile <id>`), same exit codes
  * (0 success, 2 on missing/unknown profile), same byte-identical
  * stdout / stderr prose, and byte-identical surgical text edits of the

package/src/scripts/project_thin_rules.ts

@@ -2,7 +2,7 @@
 /**
  * Thin-projection of the rule layer (lean-initial-context build-out, Phase 3.1).
  *
- * TypeScript twin of `src/scripts/project_thin_rules.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/project_thin_rules.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8b). The CLI contract is mirrored
  * EXACTLY — the `--measure` / `--out` / `--json` flags, exit codes, the
  * stdout/stderr split, byte-identical messages, and byte-identical JSON
@@ -20,11 +20,11 @@
  *
  * NOTE (faithful literal): the thin-entry pointer keeps the verbatim
  * `Body: [`{rule_id}`](../../.agent-src.uncondensed/rules/{rule_id}.md)`
- * Markdown link from the Python original. The same-basename `.py` twin
+ * Markdown link from the retired Python implementation. The same-basename `.py` twin
  * carries that literal, so the ADR-051 legacy-path guard exempts this `.ts`
  * file by twin-parity.
  *
- * No behaviour changes — latent Python quirks replicated.
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.
  *
  * Usage:
  *     project_thin_rules --measure          # measure delta, no write

package/src/scripts/propose_modules_config.ts

@@ -2,8 +2,8 @@
 /**
  * Propose a `modules:` block for `.agent-project-settings.yml`.
  *
- * TypeScript twin of `src/scripts/propose_modules_config.py` (ADR-200,
- * Phase 8 / Wave 8g). Mirrors the Python CLI contract EXACTLY — `--project`
+ * Ported from the retired Python `src/scripts/propose_modules_config.py` (ADR-200,
+ * Phase 8 / Wave 8g). The CLI contract is pinned — `--project`
  * / `--json` flags, the interactive numbered-options TTY block, the
  * machine-readable JSON envelope (byte-identical to `json.dump(indent=2)`),
  * exit codes (0 always on success, 2 unreachable path), stdout/stderr split.

package/src/scripts/prototype_lint_contradictions.ts

@@ -2,7 +2,7 @@
 /**
  * Prototype contradiction linter (P1.1 of road-to-package-optimization).
  *
- * TypeScript twin of `src/scripts/prototype_lint_contradictions.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/prototype_lint_contradictions.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8g). Mirrors the Python CLI contract
  * EXACTLY — no flags, exit codes (0 clean / 1 contradictions found), the
  * stdout JSON shape (`json.dump(report, indent=2)`, insertion order, NO
@@ -17,7 +17,7 @@
  *
  * Heuristic family — two deterministic checks (routing + imperative conflict)
  * across rules, skills, commands, and contexts. No behaviour changes —
- * latent Python quirks replicated.
+ * historical quirks preserved (consumers pin the exact behaviour).
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';

package/src/scripts/prove_pack_extractable.ts

@@ -2,7 +2,7 @@
 /**
  * Prove a pack + its declared dependency closure is self-contained.
  *
- * TypeScript twin of `prove_pack_extractable.py` (Phase 8 / Wave 8g).
+ * Ported from the retired Python `prove_pack_extractable.py` (Phase 8 / Wave 8g).
  *
  * road-to-6.0.0-D Phase 1 Step 6 — the *extraction proof*. It de-risks the
  * monorepo collapse (Phase 3) by proving that a pack moved into the flat

package/src/scripts/readme_linter.ts

@@ -2,8 +2,8 @@
 /**
  * README quality linter for agent-config repositories.
  *
- * TypeScript twin of `src/scripts/readme_linter.py` (ADR-200 — Python→TS
- * migration, Phase 8 / Wave 8b). The CLI contract is mirrored EXACTLY —
+ * Ported from the retired Python `src/scripts/readme_linter.py` (ADR-200 — Python→TS
+ * migration, Phase 8 / Wave 8b). The CLI contract is pinned —
  * the positional `readme` arg, the `--root` / `--format` / `--strict`
  * flags, exit codes (0 pass · 1 warnings · 2 errors / strict-warnings ·
  * 3 README-not-found / internal error), the stdout/stderr split, and
@@ -14,7 +14,7 @@
  * Detects weak, misleading, or incomplete READMEs by cross-checking
  * against actual repository files (Taskfile.yml, package.json, etc.).
  *
- * 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';
@@ -46,7 +46,7 @@ const BUILTIN_COMMANDS = new Set<string>([
     'php artisan', 'cargo build', 'cargo test', 'go build', 'go test',
     'git clone', 'git submodule',
 ]);
-// Referenced to mirror the module-level constant in the Python original
+// Referenced to mirror the module-level constant in the retired Python implementation
 // (it is defined but unused there); keeps the symbol "live" for the linter.
 void BUILTIN_COMMANDS;
 

package/src/scripts/redact_hook_capture.ts

@@ -2,7 +2,7 @@
 /**
  * Redact captured hook payloads for the verified-platforms roadmap.
  *
- * TypeScript twin of `redact_hook_capture.py` (Phase 8 / Wave 8g).
+ * Ported from the retired Python `redact_hook_capture.py` (Phase 8 / Wave 8g).
  *
  * Reads JSON capture files written by `dispatch_hook.py` (when
  * `AGENT_HOOK_CAPTURE_DIR` is set) and produces a redacted version
@@ -299,7 +299,7 @@ export function main(argv: string[] | null = null): number {
             return 2;
         }
         // Mirror `sorted(src.glob("*.json"))` — glob matches any entry whose
-        // name ends in `.json`; no is_file() filter in the Python original.
+        // name ends in `.json`; no is_file() filter in the retired Python implementation.
         const files = fs
             .readdirSync(src)
             .filter((name) => name.endsWith('.json') && !name.endsWith('.redacted.json'))

package/src/scripts/refine_ticket_detect.ts

@@ -2,7 +2,7 @@
 /**
  * Deterministic detection helper for the refine-ticket skill.
  *
- * TypeScript twin of `refine_ticket_detect.py` (Phase 8 / Wave 8g).
+ * Ported from the retired Python `refine_ticket_detect.py` (Phase 8 / Wave 8g).
  *
  * Reads the detection-map.yml from
  * .agent-src.uncondensed/skills/refine-ticket/ (or the projected copy),

package/src/scripts/release.ts

@@ -2,8 +2,8 @@
 /**
  * End-to-end release automation for `event4u/agent-config` (TypeScript twin).
  *
- * TypeScript twin of `src/scripts/release.py` (ADR-200, py2ts migration).
- * The CLI contract mirrors the Python original EXACTLY — same flags, same
+ * Ported from the retired Python `src/scripts/release.py` (ADR-200).
+ * The CLI contract pins the historical contract exactly — same flags, same
  * exit codes, same stdout/stderr split, byte-identical emitted output, same
  * subprocess argv/cwd/env. No behaviour changes — latent quirks are
  * replicated and flagged inline, not fixed.
@@ -145,7 +145,7 @@ class ArgparseExit extends Error {
 
 /**
  * Mirror of `subprocess.CalledProcessError`. Thrown by `run()` when a command
- * fails with `check=True` and output is NOT captured — the Python original
+ * fails with `check=True` and output is NOT captured — the retired Python implementation
  * lets `CalledProcessError` propagate in that path. The CLI entry guard does
  * NOT catch this, so it surfaces (non-zero exit + traceback), matching Python.
  */
@@ -680,7 +680,7 @@ function latest_tag(): string | null {
  *
  * `test_trend_line` — optional pre-computed `Tests: N (+M …)` footer
  * (road-to-feedback-followups P3.2). Computed by the caller so tests don't
- * trigger a recursive pytest collection.
+ * trigger a recursive vitest collection.
  */
 function render_changelog_entry(
     version: string,
@@ -770,32 +770,40 @@ function _changelog_line(c: Commit): string {
 // ─── test-count trend (road-to-feedback-followups P3.2) ───────────────────────
 
 const _TEST_COUNT_LINE_RE = /^Tests:\s+(\d+)/m;
-const _PYTEST_COLLECTED_RE = /^(\d+)\s+tests?\s+collected/m;
 
 /**
- * Return the count from `pytest --collect-only -q` on the current tree.
- * Returns null when pytest isn't available or collection fails — the trend
- * line is informational, never a release blocker.
+ * Return the collected vitest test-case count on the current tree
+ * (`npx vitest list`, one line per case; ~14s wall). Returns null when
+ * collection fails — the trend line is informational, never a release
+ * blocker. (Replaced the dead `pytest --collect-only` probe on 2026-07-08,
+ * road-to-truth-and-reference-hygiene Phase 3: the Python suite was retired
+ * with ADR-200, so the old probe always degraded to null and the `Tests:`
+ * footer silently vanished from release notes.)
  */
 function _count_tests_current(): number | null {
-    // Release-time pytest-collection probe: python-test-tooling, not package
-    // runtime — there is no tsx equivalent of pytest collection. Degrades to
-    // null (informational trend line dropped) when python3/pytest is absent.
-    const res = spawnSync('python3', ['-m', 'pytest', '--collect-only', '-q'], {
+    // Recursion/cost guard: `npx vitest list` inside a vitest-driven release
+    // test would collect the whole suite from within the suite (the child
+    // inherits VITEST=… from the runner) — the exact recursion the caller
+    // comment warns about. Degrade to null there, same as any other
+    // collection failure.
+    if (process.env['VITEST'] !== undefined) {
+        return null;
+    }
+    const res = spawnSync('npx', ['vitest', 'list'], {
         cwd: REPO_ROOT,
         encoding: 'utf-8',
         stdio: ['ignore', 'pipe', 'pipe'],
-        timeout: 120_000,
+        timeout: 180_000,
     });
     if (res.error) {
-        // FileNotFoundError (ENOENT) or TimeoutExpired (ETIMEDOUT) → None.
+        // ENOENT or ETIMEDOUT → null (informational line dropped).
         return null;
     }
     if ((res.status ?? 1) !== 0) {
         return null;
     }
-    const match = _PYTEST_COLLECTED_RE.exec(res.stdout ?? '');
-    return match ? Number.parseInt(match[1] as string, 10) : null;
+    const lines = (res.stdout ?? '').split('\n').filter((l) => l.trim().length > 0);
+    return lines.length > 0 ? lines.length : null;
 }
 
 /**
@@ -1833,7 +1841,10 @@ function main(argv: readonly string[] | null = null): number {
     }
 
     const today = todayIso();
-    const test_trend_line = _render_test_trend_line(prev);
+    // Dry-run stays fast: the trend line costs a full vitest collection
+    // (~15s+), which `--dry-run exits 0 without needing …` contracts (and
+    // the release test) assume never runs. Real releases compute it.
+    const test_trend_line = args.dry_run ? null : _render_test_trend_line(prev);
     const [full, body] = render_changelog_entry(target, prev, commits, today, {
         test_trend_line,
     });
@@ -1922,8 +1933,8 @@ if (_isCliEntry() || process.argv[1] === _HERE) {
     try {
         // main() can return an int directly OR throw SystemExitError via die();
         // both flow into process.exitCode. CalledProcessError is intentionally
-        // NOT caught here, so it propagates (non-zero + traceback), matching the
-        // Python original letting subprocess.CalledProcessError raise.
+        // NOT caught here, so it propagates (non-zero + traceback) — the historical
+        // contract let subprocess errors raise.
         process.exitCode = main(process.argv.slice(2));
     } catch (e) {
         if (e instanceof SystemExitError || e instanceof ArgparseExit) {

package/src/scripts/render_benchmark_md.ts

@@ -2,7 +2,7 @@
 /**
  * Render `docs/benchmark.md` from the latest paired A/B bench reports.
  *
- * TypeScript twin of `src/scripts/render_benchmark_md.py` (ADR-200, Phase 8 /
+ * Ported from the retired Python `src/scripts/render_benchmark_md.py` (ADR-200, Phase 8 /
  * Wave 8b). Mirrors the CLI contract EXACTLY — the `--quiet` flag, exit code,
  * the stdout/stderr split, byte-identical stdout AND byte-identical rendered
  * `docs/benchmark.md`. The renderer is deterministic — it does not run any
@@ -15,7 +15,7 @@
  * If no reports exist yet, the script writes a placeholder document — never
  * errors out, so the file is always a real description of the bench state.
  *
- * No behaviour changes — latent Python quirks replicated. The only volatile
+ * Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour. The only volatile
  * value is the embedded `utc_iso()` timestamp; golden parity for this script
  * pins on structure + the deterministic placeholder/report shape, not on the
  * second-precision timestamp.