@event4u/agent-config 8.4.1 → 8.5.0

package/src/scripts/_lib/json_pointers.ts

@@ -1,7 +1,7 @@
 /**
  * JSON-pointer helpers for the v2 `merged_keys[]` manifest field.
  *
- * TypeScript twin of `src/scripts/_lib/json_pointers.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/_lib/json_pointers.py` (ADR-200 —
  * Python→TS migration, Phase 2 / Wave 1). Public API mirrors the Python
  * module exactly (snake_case kept deliberately).
  *

package/src/scripts/_lib/knowledge_global.ts

@@ -2,7 +2,7 @@
 /**
  * File-first global knowledge-card layer — store path, config, origin-tier.
  *
- * TypeScript twin of `src/scripts/_lib/knowledge_global.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/knowledge_global.py` (ADR-200,
  * Python→TS migration). The public API and CLI contract mirror the Python
  * original EXACTLY — same exported snake_case names, same semantics, same
  * tier-classification, provenance footer, and config-merge behavior, same

package/src/scripts/_lib/knowledge_global_promote.ts

@@ -2,8 +2,8 @@
 /**
  * File-first usage signal + hybrid promotion for global knowledge cards.
  *
- * TypeScript twin of `src/scripts/_lib/knowledge_global_promote.py` (ADR-200).
- * The public API and CLI contract mirror the Python original EXACTLY — same
+ * Ported from the retired Python `src/scripts/_lib/knowledge_global_promote.py` (ADR-200).
+ * The public API and CLI contract mirror the retired Python implementation EXACTLY — same
  * exported snake_case names, same repo-slug / card-id derivation, same usage
  * sidecar shape (sorted-key JSON), same suggestion decision, same exit codes
  * and byte-identical stdout. No behaviour changes.

package/src/scripts/_lib/knowledge_global_redaction.ts

@@ -2,9 +2,9 @@
 /**
  * Write-time redaction + tier gate for global knowledge-card sharing.
  *
- * TypeScript twin of `src/scripts/_lib/knowledge_global_redaction.py`
+ * Ported from the retired Python `src/scripts/_lib/knowledge_global_redaction.py`
  * (ADR-200). Security-sensitive: the redaction patterns + replacements and
- * the tier gate are matched byte-for-byte against the Python original. The
+ * the tier gate are matched byte-for-byte against the retired Python implementation. The
  * public API and CLI contract mirror Python exactly — same exported
  * snake_case names, same `GateResult` shape + `summary()` text, same exit
  * codes and stdout. No behaviour changes.

package/src/scripts/_lib/link_crypto.ts

@@ -2,12 +2,12 @@
 /**
  * link_crypto — encrypt/decrypt stored third-party package links.
  *
- * TypeScript twin of `src/scripts/_lib/link_crypto.py` (ADR-200). The public
+ * Ported from the retired Python `src/scripts/_lib/link_crypto.py` (ADR-200). The public
  * API is mirrored EXACTLY — `encrypt`, `decrypt`, `is_token`, `project_key`,
  * `global_key`, `resolve_keys`, plus the CLI (`encrypt` / `decrypt` / `keygen`
- * / `keystatus`). The crypto scheme is replicated byte-for-byte against the
- * Python original so that a token produced by either runtime round-trips
- * identically under the other: PBKDF2-HMAC-SHA256 (200 000 iters, dklen 64) key
+ * / `keystatus`). The crypto scheme matches the retired Python implementation byte-for-byte
+ * so that ENC1 tokens minted before the migration still round-trip
+ * identically: PBKDF2-HMAC-SHA256 (200 000 iters, dklen 64) key
  * derivation, an HMAC-SHA256 counter-mode keystream, encrypt-then-MAC with
  * HMAC-SHA256, standard base64, constant-time tag compare. Every primitive has
  * an identical `node:crypto` counterpart, so encrypt-then-decrypt and the token

package/src/scripts/_lib/linked_projects.ts

@@ -1,7 +1,7 @@
 /**
  * Detect IDE-attached sibling projects (linked-projects scope, Option A).
  *
- * TypeScript twin of `src/scripts/_lib/linked_projects.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/linked_projects.py` (ADR-200,
  * Phase 2 Wave 1 batch C). Public API mirrors the Python module exactly —
  * same exported snake_case names, same entry dict shape (`path` /
  * `detected_via` / `large`, JSON-identical), same parsing tolerances.
@@ -33,7 +33,7 @@
  * sibling files in context and does NOT persist anything. Opt-in +
  * persistence is the caller's job.
  *
- * Note on logging: the Python original emits `logger.info(...)` diagnostics
+ * Note on logging: the retired Python implementation emits `logger.info(...)` diagnostics
  * which are silent under the default logging configuration. The TS twin
  * omits them — observable behavior (return value) is identical.
  */
@@ -261,7 +261,7 @@ function _resolve_idea_url(raw: string, root: string): string | null {
         return null;
     }
     // path.resolve handles both the absolute and the root-relative branch
-    // of the Python original; _resolve_path never throws (the Python
+    // of the retired Python implementation; _resolve_path never throws (the Python
     // OSError → None branch maps to the lexical fallback inside it).
     return _resolve_path(path.resolve(root, value));
 }
@@ -363,7 +363,7 @@ function _read_jsonc(filePath: string): unknown {
 /* ------------------------------------------------------------------ */
 /* Minimal well-formed-XML attribute scanner.                          */
 /*                                                                     */
-/* The Python original parses with xml.etree.ElementTree and treats    */
+/* the retired Python implementation parses with xml.etree.ElementTree and treats    */
 /* any ParseError as "no entries". Rather than pull in an XML          */
 /* dependency, this scanner tokenizes the document, enforces the       */
 /* well-formedness rules ET relies on for the IDE-config input domain  */

package/src/scripts/_lib/model_tier.ts

@@ -1,7 +1,7 @@
 /**
  * Shared `model_tier` → native Claude `model:` mapping (ADR-034 / ADR-035).
  *
- * TypeScript twin of `src/scripts/_lib/model_tier.py` (ADR-200 —
+ * Ported from the retired Python `src/scripts/_lib/model_tier.py` (ADR-200 —
  * Python→TS migration, Phase 2 / Wave 1). Public API mirrors the
  * Python module exactly (snake_case kept deliberately).
  *

package/src/scripts/_lib/module_detection.ts

@@ -1,7 +1,7 @@
 /**
  * Detect module root directories from a project tree.
  *
- * TypeScript twin of `src/scripts/_lib/module_detection.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/module_detection.py` (ADR-200,
  * Phase 2 Wave 1 batch C). Public API mirrors the Python module exactly —
  * same exported snake_case names, same return shapes, same confidence
  * ladder, same read-only / tolerant contract.
@@ -126,7 +126,7 @@ export function is_module_like_path(rel_path: string): boolean {
  * Fields mirror the JSON shape callers ultimately persist into
  * `modules.root_paths` (the `path` field) plus metadata used by the
  * installer to phrase the numbered-options prompt. Mirrors the frozen
- * `ModuleCandidate` dataclass of the Python original.
+ * `ModuleCandidate` dataclass of the retired Python implementation.
  */
 export interface ModuleCandidate {
     /** Repo-relative POSIX path of the module root (e.g. `app/Modules`). */

package/src/scripts/_lib/pin_resolver.ts

@@ -1,7 +1,7 @@
 /**
  * Pin-aware version resolver for the `agent-config` dispatcher.
  *
- * TypeScript twin of `src/scripts/_lib/pin_resolver.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/pin_resolver.py` (ADR-200,
  * Phase 2 / Wave 1 batch B). The dispatcher consults this module
  * **before** doing any work. If `.agent-settings.yml` carries a
  * non-empty `agent_config_version` pin and the currently running

package/src/scripts/_lib/script_output.ts

@@ -1,7 +1,7 @@
 /**
  * Verbosity-aware print router for scripts.
  *
- * TypeScript twin of `src/scripts/_lib/script_output.py` (ADR-200,
+ * Ported from the retired Python `src/scripts/_lib/script_output.py` (ADR-200,
  * Phase 2 / Wave 2b). Mirrors the Python module's public API exactly —
  * same exported snake_case names, same resolution order, same level
  * semantics, same output channels (stdout vs stderr), same module-level

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