@event4u/agent-config 8.4.0 → 8.5.0

package/src/scripts/_lib/security_lint.ts

@@ -1,6 +1,6 @@
 // Shared helpers for the agent-security corpus linters (road-to-security-pillar.md P1).
 //
-// TypeScript twin of `src/scripts/_lib/security_lint.py` (ADR-200 — Python→TS
+// Ported from the retired Python `src/scripts/_lib/security_lint.py` (ADR-200 — Python→TS
 // migration). Public API mirrors the Python module exactly (snake_case kept
 // deliberately) so the two dependent linters — lint_hidden_unicode and
 // lint_instruction_smuggling — depend on one source of truth.

package/src/scripts/_lib/surface_tiers.ts

@@ -1,7 +1,7 @@
 /**
  * Surface-tier (core vs lab) resolution for the install split.
  *
- * TypeScript twin of `src/scripts/_lib/surface_tiers.py` (ADR-200 — Python→TS
+ * Ported from the retired Python `src/scripts/_lib/surface_tiers.py` (ADR-200 — Python→TS
  * migration). Public API mirrors the Python module exactly (snake_case kept
  * deliberately — fidelity over TS idiom).
  *

package/src/scripts/_lib/text_similarity.ts

@@ -9,7 +9,7 @@
  *   below WARN_THRESHOLD → no conflict, proceed to create
  *
  * Deliberately does NOT touch `memory_signal.ts` — that script is a
- * byte-faithful parity twin of its retired Python original ("no
+ * byte-faithful parity port of the retired Python implementation ("no
  * behaviour changes" is a load-bearing contract of that file). This
  * module is consumed as an ADDITIONAL, advisory check layered on top,
  * from `check_memory_similarity.ts` and later the knowledge-page

package/src/scripts/_lib/update_check.ts

@@ -1,14 +1,14 @@
 /**
  * Daily update-check banner for the `agent-config` dispatcher.
  *
- * TypeScript twin of `src/scripts/_lib/update_check.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/update_check.py` (ADR-200,
  * Phase 2 / Wave 1 batch B). Pure functions: `check_for_update()`
  * decides whether a banner should be emitted and returns the banner
  * string (or `null`). The dispatcher prints the returned string to
  * `stderr` after the subcommand finishes — never delaying the work,
  * never prompting.
  *
- * Design constraints (mirrored from the Python original):
+ * Design constraints (mirrored from the retired Python implementation):
  *
  * - Node builtins only (global `fetch` on Node >= 20).
  * - 1 s hard timeout on the registry call; network failure is silent.

package/src/scripts/_lib/user_global_paths.ts

@@ -1,7 +1,7 @@
 /**
  * Vendor-namespaced user-global path resolution.
  *
- * TypeScript twin of `src/scripts/_lib/user_global_paths.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/user_global_paths.py` (ADR-200,
  * Phase 2 / Wave 1 batch B). Mirrors the Python module's public API
  * exactly — same exported snake_case names, same semantics, same
  * path-resolution behavior. Single source of truth for "where does this

package/src/scripts/_lib/value_ladder.ts

@@ -1,7 +1,7 @@
 /**
  * Pure normaliser: raw bench reports → `value-v1` rung dicts.
  *
- * TypeScript twin of `src/scripts/_lib/value_ladder.py` (ADR-200 py2ts
+ * Ported from the retired Python `src/scripts/_lib/value_ladder.py` (ADR-200 py2ts
  * Phase 2 / Wave 2a). Phase 1 Step 2 of the readable-value-dashboard roadmap.
  *
  * This module is **pure** — no I/O, no file reads, no clock. Inputs are

package/src/scripts/_lib/value_report.ts

@@ -1,7 +1,7 @@
 /**
  * Assemble `value-v1` JSON from on-disk raw bench reports.
  *
- * TypeScript twin of `src/scripts/_lib/value_report.py` (ADR-200 py2ts
+ * Ported from the retired Python `src/scripts/_lib/value_report.py` (ADR-200 py2ts
  * Phase 2 / Wave 2a). Phase 1 Step 3 of the readable-value-dashboard roadmap.
  *
  * Reads:

package/src/scripts/_lib/zip_min.ts

@@ -1,8 +1,8 @@
 /**
  * Minimal ZIP writer/reader on Node builtins only (`node:zlib`).
  *
- * Internal helper for the TypeScript twin of
- * `src/scripts/_lib/claude_desktop_bundler.py` (ADR-200 py2ts Phase 2):
+ * Internal helper for the port of the retired Python
+ * `src/scripts/_lib/claude_desktop_bundler.py` (ADR-200):
  * the repo ships no ZIP dependency, and the ADR contract forbids adding
  * one — so the bundler twin writes the (well-specified) ZIP container
  * itself and compresses entries with `zlib.deflateRawSync`

package/src/scripts/adoption_report.ts

@@ -2,15 +2,15 @@
 /**
  * Roll up `adoption-snapshots.jsonl` into a Markdown trend report.
  *
- * TypeScript twin of `src/scripts/adoption_report.py` (ADR-200, Phase 8 /
- * Wave 8a). The CLI contract is mirrored EXACTLY — the flags `--in` /
+ * Ported from the retired Python `src/scripts/adoption_report.py` (ADR-200, Phase 8 /
+ * Wave 8a). The CLI contract is pinned — the flags `--in` /
  * `--out` / `--weeks`, exit codes (0 written · 1 IO failure on read/write),
  * the stdout/stderr split, byte-identical messages, AND byte-identical
  * generated Markdown (the report is a write target). Mirrors the shape of
  * `skill_usage_report.py`: a single file, no external deps. The report is
  * regenerated on every invocation (idempotent for a given JSONL state).
  *
- * 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/adoption_snapshot.ts

@@ -2,8 +2,8 @@
 /**
  * Pull the four public adoption signals into a single dated JSONL row.
  *
- * TypeScript twin of `src/scripts/adoption_snapshot.py` (ADR-200, Phase 8
- * Wave 8a). Mirrors the Python CLI contract EXACTLY — flags (`--out`,
+ * Ported from the retired Python `src/scripts/adoption_snapshot.py` (ADR-200, Phase 8
+ * Wave 8a). The CLI contract is pinned — flags (`--out`,
  * `--no-network`), exit codes (0 / 1 / 2), stdout/stderr split, and the
  * byte-identical JSONL row (`json.dumps(row)` default separators,
  * ensure_ascii=True, no trailing space differences).
@@ -59,7 +59,7 @@ const GH_SEARCH_URL_TEMPLATE =
 
 const TIMEOUT_S = 10;
 
-// Free-form JSON-ish value type for signal payloads. The Python original uses
+// Free-form JSON-ish value type for signal payloads. the retired Python implementation uses
 // `dict[str, Any]`; the only documented `any`-shaped surface (HTTP JSON).
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 type Json = any;

package/src/scripts/adoption_status.ts

@@ -2,13 +2,13 @@
 /**
  * One-screen adoption dashboard for the maintainer's weekly review.
  *
- * TypeScript twin of `src/scripts/adoption_status.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/adoption_status.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8a). The CLI contract is mirrored
  * EXACTLY: same flags (`--json`, `--branch`), same exit codes (0 normal,
  * 1 on registry-read IO error), same byte-identical text + JSON output,
  * same `ci_status` shell-out (now the `.ts` twin run via `tsx` — no
  * python3), same `unknown` best-effort fallbacks. No behaviour
- * changes — latent bugs replicated.
+ * changes — historical quirks preserved (consumers pin the exact behaviour).
  *
  * Prints three things in one short block:
  *

package/src/scripts/adr/regenerate_index.ts

@@ -5,11 +5,11 @@
  * non-numbered ADRs into an Unnumbered table, hard-fails on duplicate
  * numbers, filename/frontmatter mismatch, or broken supersedes links.
  *
- * TypeScript twin of `src/scripts/adr/regenerate_index.py` (ADR-200, Phase 8).
- * The CLI contract is mirrored EXACTLY — `--dir` (default `docs/adr/`),
+ * Ported from the retired Python `src/scripts/adr/regenerate_index.py` (ADR-200).
+ * The CLI contract is pinned — `--dir` (default `docs/adr/`),
  * `--check`, exit codes (0 / 1 / 2), the stdout/stderr split, byte-identical
  * messages, AND byte-identical generated `INDEX.md`. 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/ai_council/_default_prices.ts

@@ -1,10 +1,9 @@
 /**
  * Shipped baseline prices for the AI Council.
  *
- * TypeScript twin of `src/scripts/ai_council/_default_prices.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/_default_prices.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8g; ported as a prerequisite of
- * `update_prices.ts`). Values + ordering + `as_rows()` semantics mirror the
- * Python original EXACTLY.
+ * `update_prices.ts`). Values + ordering + `as_rows()` semantics are pinned by tests.
  *
  * This module is the bootstrap source for `agents/runtime/.agent-prices.md`
  * when the runtime file is missing, and the network-fallback source for

package/src/scripts/ai_council/advisors.ts

@@ -1,7 +1,7 @@
 /**
  * Thinking-style advisors — replace-mode call planning (Phase 6).
  *
- * TypeScript twin of `src/scripts/ai_council/advisors.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/advisors.py` (ADR-200 —
  * Python→TS migration, Phase 1). When the user-global
  * `~/.event4u/agent-config/settings/.ai-council.yml` (always global —
  * ADR-104) enables an advisor (e.g. `contrarian` bound to

package/src/scripts/ai_council/airgap.ts

@@ -1,7 +1,7 @@
 /**
  * Airgap detection for the AI Council installer / first-run (step-9 P11 · U1).
  *
- * TypeScript twin of `src/scripts/ai_council/airgap.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/airgap.py` (ADR-200 —
  * Python→TS migration, Phase 1; ai_council FOUNDATION wave). Public surface
  * mirrors the Python module exactly (snake_case kept deliberately):
  * `COUNCIL_PROBE_HOSTS`, `DEFAULT_TIMEOUT_S`, `AIRGAP_BANNER`,

package/src/scripts/ai_council/budget_guard.ts

@@ -1,7 +1,7 @@
 /**
  * Per-day rolling cost-budget guard for the council (D3).
  *
- * TypeScript twin of `src/scripts/ai_council/budget_guard.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/budget_guard.py` (ADR-200 —
  * Python→TS migration, Phase 1; ai_council FOUNDATION wave). Mirrors the
  * Python public surface exactly (snake_case kept deliberately):
  * `LEDGER_FILENAME`, `LEDGER_PATH`, `ROLLING_WINDOW_HOURS`, `SpendEntry`,

package/src/scripts/ai_council/bundler.ts

@@ -1,7 +1,7 @@
 /**
  * Context bundling for council consultations.
  *
- * TypeScript twin of `src/scripts/ai_council/bundler.py` (ADR-094 —
+ * Ported from the retired Python `src/scripts/ai_council/bundler.py` (ADR-094 —
  * Python→TS migration, Phase 1).
  *
  * Takes a raw artefact (free-form prompt, roadmap path, diff range, or

package/src/scripts/ai_council/cli_hints.ts

@@ -1,7 +1,7 @@
 /**
  * Per-provider CLI install hints for `mode: cli` members (step-9 P2).
  *
- * TypeScript twin of `src/scripts/ai_council/cli_hints.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/cli_hints.py` (ADR-200 —
  * Python→TS migration, Phase 1; ai_council FOUNDATION wave). Public surface
  * mirrors the Python module exactly (snake_case kept deliberately):
  * `INSTALL_HINTS`, `hint_for`, `format_install_hints`.

package/src/scripts/ai_council/clients.ts

@@ -1,5 +1,5 @@
-// External-AI clients for the council — byte-identical TypeScript twin of
-// `src/scripts/ai_council/clients.py` (py2ts migration, ADR-200).
+// External-AI clients for the council — ported from the retired Python
+// `src/scripts/ai_council/clients.py` (ADR-200).
 //
 // Mirrors the contract from `scripts/skill_trigger_eval.py`:
 // - Tokens come exclusively from `~/.event4u/agent-config/<provider>.key`
@@ -31,7 +31,7 @@
 // `cli_call_budget.max_calls_per_day.<provider>` quota with state persisted at
 // `~/.event4u/agent-config/cli-calls.json` (daily UTC reset).
 //
-// TRANSPORT SEAM (TS-only, for tests): the Python original calls
+// TRANSPORT SEAM (TS-only, for tests): the retired Python implementation calls
 // `subprocess.run` directly inside `CliClient.ask`. The twin routes that one
 // call through the protected `_runSubprocess(cmd, stdinPayload)` instance
 // method so a test subclass can stub the transport without live processes —
@@ -154,7 +154,7 @@ export class CouncilResponse {
 // Python uses `time.monotonic()`. latency_ms is non-deterministic; tests
 // normalise it. Exposed so tests can pin it if they choose.
 let _monotonicSource: () => number = () => {
-    // performance.now() is monotonic milliseconds; the Python original is
+    // performance.now() is monotonic milliseconds; the retired Python implementation is
     // seconds, but we only ever compute `int((now - t0) * 1000)`, so feeding
     // milliseconds here and dropping the *1000 keeps the same arithmetic.
     return performance.now();
@@ -967,7 +967,7 @@ export abstract class CliClient extends ExternalAIClient {
      * `subprocess.run(cmd, input=..., capture_output=True, text=True,
      * timeout=..., check=False)`. Throws `SubprocessError` for the timeout /
      * ENOENT / OSError branches so `ask()` can classify them exactly as the
-     * Python original does. Tests override this to inject canned output without
+     * historical contract requires. Tests override this to inject canned output without
      * spawning a process.
      */
     protected _runSubprocess(cmd: string[], stdinPayload: string | null): SubprocessResult {

package/src/scripts/ai_council/compile_corpus.ts

@@ -1,7 +1,7 @@
 /**
  * Compile the human-edited low-impact corpus Markdown to a YAML lockfile.
  *
- * TypeScript twin of `src/scripts/ai_council/compile_corpus.py`
+ * Ported from the retired Python `src/scripts/ai_council/compile_corpus.py`
  * (ADR-200 — Python→TS migration, Phase 1).
  *
  * Step-10 — see `agents/roadmaps/step-10-corpus-yaml-lockfile.md`.

package/src/scripts/ai_council/confidence_gate.ts

@@ -1,7 +1,7 @@
 /**
  * Confidence gate for solo-member dispatch (step-9 P13).
  *
- * TypeScript twin of `src/scripts/ai_council/confidence_gate.py`
+ * Ported from the retired Python `src/scripts/ai_council/confidence_gate.py`
  * (ADR-200 — Python→TS migration, Phase 1). Defense-in-depth on top of
  * shadow-mode SLO: when a single member's response signals uncertainty,
  * presents unresolved alternatives, or refuses, the dispatcher escalates

package/src/scripts/ai_council/config.ts

@@ -1,7 +1,7 @@
 /**
  * Council configuration loader — single source of truth.
  *
- * TypeScript twin of `src/scripts/ai_council/config.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/config.py` (ADR-200 —
  * Python→TS migration, Phase 12). Mirrors the Python module's public
  * surface and validation behaviour byte-for-byte: same exported
  * snake_case names, same defaults, same error messages, same precedence.

package/src/scripts/ai_council/consensus.ts

@@ -1,7 +1,7 @@
 /**
  * Consensus scoring for the analysis lens (Phase 4 / F3).
  *
- * TypeScript twin of `src/scripts/ai_council/consensus.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/consensus.py` (ADR-200 —
  * Python→TS migration, Phase 1). After the final deliberation round, members
  * score each other's findings. The renderer ranks findings by consensus and
  * surfaces a "Minority Views" section for sub-threshold items so they remain

package/src/scripts/ai_council/events_log.ts

@@ -1,7 +1,7 @@
 /**
  * Persistent council events log (step-8 phase 3).
  *
- * TypeScript twin of `src/scripts/ai_council/events_log.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/events_log.py` (ADR-200 —
  * Python→TS migration, Phase 1). Appends one JSON line per council event to
  * `<project_root>/agents/runtime/council/events.log`. Schema v1 carries the
  * minimum needed to answer the "why did the council skip / block this?"

package/src/scripts/ai_council/learn_low_impact_preview.ts

@@ -1,7 +1,7 @@
 /**
  * Preview builder for `/memory learn-low-impact` (step-9 Phase 7).
  *
- * TypeScript twin of `src/scripts/ai_council/learn_low_impact_preview.py`
+ * Ported from the retired Python `src/scripts/ai_council/learn_low_impact_preview.py`
  * (ADR-200 — Python→TS migration, Phase 1).
  *
  * Default invocation is `--preview`: build a structured plan describing

package/src/scripts/ai_council/low_impact_corpus.ts

@@ -1,7 +1,7 @@
 /**
  * Hardened parser for `agents/decisions/low-impact-decisions.md` (step-9 P4).
  *
- * TypeScript twin of `src/scripts/ai_council/low_impact_corpus.py`
+ * Ported from the retired Python `src/scripts/ai_council/low_impact_corpus.py`
  * (ADR-200 — Python→TS migration, Phase 1).
  *
  * Replaces the silent-skip behaviour of the inline regex in

package/src/scripts/ai_council/low_impact_intake.ts

@@ -1,7 +1,7 @@
 /**
  * Intake trigger + dedup for `agents/decisions/low-impact-decisions.md` (Phase 12).
  *
- * TypeScript twin of `src/scripts/ai_council/low_impact_intake.py`
+ * Ported from the retired Python `src/scripts/ai_council/low_impact_intake.py`
  * (ADR-200 — Python→TS migration, Phase 1). Pure-text, deterministic.
  *
  * User signals "leichte Frage" / "low-impact question" / equivalents

package/src/scripts/ai_council/modes.ts

@@ -1,7 +1,7 @@
 /**
  * Mode resolution for council members (Phase 2b).
  *
- * TypeScript twin of `src/scripts/ai_council/modes.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/modes.py` (ADR-200 —
  * Python→TS migration, Phase 1). Pure resolver — never touches the
  * filesystem or environment. Callers pass in already-loaded values from
  * `.agent-settings.yml`.

package/src/scripts/ai_council/orchestrator.ts

@@ -1,7 +1,7 @@
 // Council orchestrator — fan out one question to multiple members.
 //
-// py2ts twin of orchestrator.py (ADR-200). Byte-for-byte parity with the
-// Python original: member dispatch order, sequential cost gating, the overrun
+// Port of the retired Python orchestrator.py (ADR-200). The historical contract
+// is pinned byte-for-byte by tests: member dispatch order, sequential cost gating, the overrun
 // callback contract, multi-round debate / peer-review / consensus passes, and
 // the Markdown render assembly are all mirrored exactly.
 //
@@ -69,7 +69,7 @@ import {
 // The orchestrator formats USD / scores / strengths via Python f-string
 // specs (`:.4f`, `:.2f`, `:.1f`) which round half-to-even on the decimal
 // representation. JS `toFixed` rounds half away from zero, so the spec
-// formatting is reimplemented to stay byte-exact with the Python original.
+// formatting is reimplemented to stay byte-exact with the retired Python implementation.
 
 /**
  * Format `x` to `ndigits` decimals using round-half-to-even, matching

package/src/scripts/ai_council/pricing.ts

@@ -1,14 +1,14 @@
 /**
  * Runtime pricing layer for the AI Council.
  *
- * TypeScript twin of `src/scripts/ai_council/pricing.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/pricing.py` (ADR-200 —
  * Python→TS migration, Phase 8 / Wave 8g; ported as a prerequisite of
  * `update_prices.ts`). Mirrors the Python public surface used by the
  * caller: `PRICES_FILE`, `load_prices`, `is_stale`, `_render_markdown`,
  * plus `bootstrap_from_defaults` / `last_monday_utc` for completeness.
  *
  * Reads `agents/runtime/.agent-prices.md`, parses YAML frontmatter + the
- * Markdown table. No behaviour changes — latent Python quirks replicated,
+ * Markdown table. Historical quirks are preserved deliberately — tests and downstream consumers pin the exact behaviour.,
  * including the byte-identical `{x:>6.2f}` row formatting.
  */
 import * as fs from 'node:fs';

package/src/scripts/ai_council/probation_gate.ts

@@ -1,7 +1,7 @@
 /**
  * Probation promote-and-prune for `agents/decisions/low-impact-decisions.md`.
  *
- * TypeScript twin of `src/scripts/ai_council/probation_gate.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/probation_gate.py` (ADR-200 —
  * Python→TS migration, Phase 1; ai_council FOUNDATION wave). Public surface
  * mirrors the Python module exactly (snake_case kept deliberately):
  * `WINDOW_DAYS`, `PROMOTION_THRESHOLD`, `GateRun`, `run_gate`.
@@ -20,7 +20,7 @@
  *
  * PARITY NOTES
  * - The line regex uses U+2014 (em-dash) and U+00B7 (middle dot) literals,
- *   byte-identical to the Python `re` pattern; matched with the `u` flag so
+ *   matching the historical `re` pattern byte-for-byte; the `u` flag keeps
  *   `\s` / `\d` align with Python's defaults (no MULTILINE).
  * - `splitlines()` is mirrored by `_splitlines` (full CPython boundary set).
  * - Date math is done on tz-aware UTC epoch-millis; `d >= cutoff` matches

package/src/scripts/ai_council/project_context.ts

@@ -1,7 +1,7 @@
 /**
  * Lightweight project-context detector for the council handoff preamble.
  *
- * TypeScript twin of `src/scripts/ai_council/project_context.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/project_context.py` (ADR-200 —
  * Python→TS migration, Phase 1). Reads the bare minimum from the repo root —
  * `composer.json`, `package.json`, root `README.md` — and returns a neutral
  * `ProjectContext`. All fields are optional; missing data is `null` and the

package/src/scripts/ai_council/prompts.ts

@@ -1,7 +1,7 @@
 /**
  * Neutrality system prompts for the council.
  *
- * TypeScript twin of `src/scripts/ai_council/prompts.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/prompts.py` (ADR-200 —
  * Python→TS migration, Phase 1). Council members must NOT see the host
  * agent's reasoning, internal state, or framing language. Each prompt asks
  * for an independent critique on the artefact's own merits.

package/src/scripts/ai_council/redact_low_impact_entry.ts

@@ -1,10 +1,10 @@
 /**
  * Privacy floor for `agents/decisions/low-impact-decisions.md` (Phase 12).
  *
- * TypeScript twin of `src/scripts/ai_council/redact_low_impact_entry.py`
+ * Ported from the retired Python `src/scripts/ai_council/redact_low_impact_entry.py`
  * (ADR-200 — Python→TS migration, Phase 1). Security-sensitive: the
  * redaction regexes and refusal markers are matched byte-for-byte against
- * the Python original.
+ * the retired Python implementation.
  *
  * Non-bypassable redactor invoked on intake (write-side) AND on
  * upstream (`/learn-low-impact`, leave-the-repo side). Both gates call

package/src/scripts/ai_council/session.ts

@@ -1,7 +1,7 @@
 /**
  * Session persistence for council consultations (D2).
  *
- * TypeScript twin of `src/scripts/ai_council/session.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/ai_council/session.py` (ADR-200 —
  * Python→TS migration, Phase 1).
  *
  * Every `/council` call that completes (success or partial) writes an

package/src/scripts/ai_council/shadow_dispatch.ts

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

package/src/scripts/ai_council/solo_dispatch.ts

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

package/src/scripts/analysis_freshness.ts

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

package/src/scripts/annotate_discovery.ts

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

package/src/scripts/apply_modules_config.ts

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

package/src/scripts/audit_adr_coverage.ts

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

package/src/scripts/audit_auto_rules.ts

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

package/src/scripts/audit_cloud_compatibility.ts

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

package/src/scripts/audit_command_surface.ts

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