@event4u/agent-config 8.4.1 → 8.6.0

package/src/scripts/mcp_telemetry_query.ts

@@ -12,7 +12,7 @@
 // invocation. stdlib-only; reads (never writes) the DB via Node's
 // built-in `node:sqlite`, imported lazily.
 //
-// TS twin of mcp_telemetry_query.py (py2ts). Mirrors the full public
+// TS port of the retired Python mcp_telemetry_query.py (ADR-200). Mirrors the full public
 // surface: ToolRow, summarise, main.
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -51,8 +51,8 @@ class FileNotFoundLikeError extends Error {}
 // Python's stdlib sqlite3 emits nothing on stderr; node:sqlite is flagged
 // experimental on node 22 and prints an `ExperimentalWarning: SQLite …` line
 // to stderr on first import (stable / silent on node >= 23). Drop only that
-// specific warning so the twin's stderr stays byte-identical to the Python
-// original across node versions. Installed once, narrowly matched.
+// specific warning so stderr stays byte-stable across node versions (tests
+// pin the exact bytes). Installed once, narrowly matched.
 let _sqliteWarningSilenced = false;
 function _silenceSqliteExperimentalWarning(): void {
     if (_sqliteWarningSilenced) return;

package/src/scripts/mcp_telemetry_store.ts

@@ -15,7 +15,7 @@
 //
 // Phase 2 K2 (`scripts/mcp_telemetry_query.ts`) reads from this store.
 //
-// TS twin of mcp_telemetry_store.py (py2ts). Mirrors the full public
+// TS port of the retired Python mcp_telemetry_store.py (ADR-200). Mirrors the full public
 // surface: IngestReport, resolve_source, resolve_db, ingest, main.
 import * as crypto from 'node:crypto';
 import * as fs from 'node:fs';
@@ -176,8 +176,8 @@ export function resolve_db(consumer_root?: string | null): string {
 // Python's stdlib sqlite3 emits nothing on stderr; node:sqlite is flagged
 // experimental on node 22 and prints an `ExperimentalWarning: SQLite …` line
 // to stderr on first import (stable / silent on node >= 23). Drop only that
-// specific warning so the twin's stderr stays byte-identical to the Python
-// original across node versions. Installed once, narrowly matched.
+// specific warning so stderr stays byte-stable across node versions (tests
+// pin the exact bytes). Installed once, narrowly matched.
 let _sqliteWarningSilenced = false;
 function _silenceSqliteExperimentalWarning(): void {
     if (_sqliteWarningSilenced) return;

package/src/scripts/measure_augment_budget.ts

@@ -3,8 +3,8 @@
  * Measure the Augment workspace-guidelines budget (Phase 1.1 of
  * road-to-augment-limit-fit).
  *
- * TypeScript twin of `src/scripts/measure_augment_budget.py` (ADR-200,
- * Phase 8 Wave 8a). Mirrors the Python CLI contract EXACTLY — flags
+ * Ported from the retired Python `src/scripts/measure_augment_budget.py` (ADR-200,
+ * Phase 8 Wave 8a). The CLI contract is pinned — flags
  * (`--json`, `--trend-append`, `--check`), exit codes (0 / 1 / 3),
  * byte-identical stdout (text summary + `json.dumps(indent=2,
  * sort_keys=True)`), and the byte-identical JSONL trend record

package/src/scripts/measure_density.ts

@@ -2,12 +2,12 @@
 /**
  * Measure structural density across the artifact corpus.
  *
- * TypeScript twin of `src/scripts/measure_density.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/measure_density.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract
  * EXACTLY: flags (`--json`, `--snapshot`), exit code 0, byte-identical
  * stdout (report or `json.dumps(sort_keys=True, indent=2)`), and the same
  * snapshot JSONL (`json.dumps(sort_keys=True)` per line). No behaviour
- * changes — latent quirks replicated.
+ * changes — historical quirks preserved (consumers pin the exact behaviour).
  *
  * Phase 1.1 of `agents/roadmaps/road-to-structural-linter-reform.md`.
  *

package/src/scripts/measure_frugality_savings.ts

@@ -2,8 +2,8 @@
 /**
  * Phase 0 baseline harness for road-to-trim-frugality-canon.
  *
- * TypeScript twin of `src/scripts/measure_frugality_savings.py` (ADR-200,
- * Phase 8 Wave 8a). Mirrors the Python CLI contract EXACTLY — exit code 0,
+ * Ported from the retired Python `src/scripts/measure_frugality_savings.py` (ADR-200,
+ * Phase 8 Wave 8a). The CLI contract is pinned — exit code 0,
  * byte-identical stdout (`json.dumps(record, indent=2, ensure_ascii=False)`
  * + the `appended → …` line), and the byte-identical JSONL baseline row
  * (`json.dumps(record, ensure_ascii=False)`).
@@ -337,7 +337,7 @@ export function main(): number {
 
     const out = path.join(root, 'agents', 'runtime', 'frugality', 'baseline.jsonl');
     // with out.open("a") — does NOT mkdir parents; mirror that (will throw if
-    // the directory is missing, exactly like the Python original).
+    // the directory is missing, exactly like the retired Python implementation).
     fs.appendFileSync(out, pyJsonDumps(record, null) + '\n');
     process.stdout.write(pyJsonDumps(record, 2) + '\n');
     const rel = path.relative(root, out).split(path.sep).join('/');

package/src/scripts/measure_markitdown_lift.ts

@@ -2,7 +2,7 @@
 /**
  * Measure markitdown's token-saving lift on the bundled corpus.
  *
- * TypeScript twin of `src/scripts/measure_markitdown_lift.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/measure_markitdown_lift.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract EXACTLY:
  * flags (`--convert`, `--binary`), exit codes (0 baseline / 2 corpus missing /
  * 3 --convert without the binary on PATH), byte-identical stdout/stderr. No

package/src/scripts/measure_patterns.ts

@@ -2,7 +2,7 @@
 /**
  * Measure presence of the eight Phase-3.1 judge patterns across all skills.
  *
- * TypeScript twin of `src/scripts/measure_patterns.py` (ADR-200 — Python→TS
+ * Ported from the retired Python `src/scripts/measure_patterns.py` (ADR-200 — Python→TS
  * migration, Phase 8 / Wave 8c). Mirrors the CLI contract EXACTLY: flags
  * (`--json`, `--tier`, `--diff-baseline`), exit codes (0 / 3 when the skills
  * dir is missing), byte-identical stdout/stderr. No behaviour changes.

package/src/scripts/measure_projection_bytes.ts

@@ -2,7 +2,7 @@
 /**
  * Measure per-tool projection bytes.
  *
- * TypeScript twin of `src/scripts/measure_projection_bytes.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/measure_projection_bytes.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract EXACTLY:
  * flags (`--json`, `--regenerate`), exit codes (0 / 2 when `task` is missing
  * for --regenerate), byte-identical stdout/stderr. No behaviour changes.

package/src/scripts/measure_rule_budget.ts

@@ -2,7 +2,7 @@
 /**
  * Measure rule-bucket char counts (kernel + auto) for the rule-kernel roadmap.
  *
- * TypeScript twin of `src/scripts/measure_rule_budget.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/measure_rule_budget.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8a). The CLI contract is mirrored
  * EXACTLY: same flags (`--json`, `--kernel-budget-check`,
  * `--trend-append`), same exit codes, same byte-identical stdout table /

package/src/scripts/measure_skill_reduction.ts

@@ -2,7 +2,7 @@
 /**
  * Skill-count reduction measurement — step-12 Phase 3 L74 deliverable.
  *
- * TypeScript twin of `src/scripts/measure_skill_reduction.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/measure_skill_reduction.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8c). Mirrors the CLI contract EXACTLY:
  * flag (`--json`), exit codes (0 pass / 1 fail / 2 no-skills), byte-identical
  * stdout (report or `json.dumps(indent=2)`) and stderr. No behaviour changes.

package/src/scripts/memory_hash.ts

@@ -2,7 +2,7 @@
 /**
  * Content-addressed hash for a curated memory entry.
  *
- * TypeScript twin of `src/scripts/memory_hash.py` (ADR-200, Phase 7 /
+ * Ported from the retired Python `src/scripts/memory_hash.py` (ADR-200, Phase 7 /
  * dev-side memory CORE). The public API and CLI contract mirror the Python
  * original EXACTLY — same exported names (snake_case kept deliberately),
  * same canonical-JSON serialisation (sorted keys, no whitespace,

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;