@event4u/agent-config 8.4.1 → 8.6.0

package/src/scripts/_lib/subagent_steering.ts

@@ -117,6 +117,12 @@ export interface OrchEntry {
     token_delta: number;
     outcome: string;
     verify_mode: string;
+    /** Routing extension (road-to-cost-aware-model-routing) — null on pre-extension lines. */
+    task_class: string | null;
+    tier_chosen: string | null;
+    tier_source: string | null;
+    escalated_from: string | null;
+    verify_result_by_tier: Record<string, string> | null;
 }
 
 /**
@@ -129,9 +135,8 @@ export interface OrchEntry {
  *
  * user_override_rate cannot be measured from telemetry alone — returns 0.
  */
-export function readOrchestrationMetrics(
-    lines: string[],
-): GuardrailMetrics {
+/** Parse orchestration entries from audit-log-v1 JSONL lines (shared by all aggregators). */
+export function parseOrchEntries(lines: string[]): OrchEntry[] {
     const entries: OrchEntry[] = [];
     for (const line of lines) {
         const trimmed = line.trim();
@@ -141,17 +146,33 @@ export function readOrchestrationMetrics(
             if (parsed['input_kind'] !== 'orchestration') continue;
             const orch = parsed['orchestration'] as Record<string, unknown> | undefined;
             if (!orch) continue;
+            const vbt = orch['verify_result_by_tier'];
             entries.push({
                 task_size_estimate: Number(orch['task_size_estimate'] ?? 0),
                 spawn_count: Number(orch['spawn_count'] ?? 0),
                 token_delta: Number(orch['token_delta'] ?? 0),
                 outcome: String(orch['outcome'] ?? ''),
                 verify_mode: String(orch['verify_mode'] ?? ''),
+                task_class: orch['task_class'] == null ? null : String(orch['task_class']),
+                tier_chosen: orch['tier_chosen'] == null ? null : String(orch['tier_chosen']),
+                tier_source: orch['tier_source'] == null ? null : String(orch['tier_source']),
+                escalated_from: orch['escalated_from'] == null ? null : String(orch['escalated_from']),
+                verify_result_by_tier:
+                    vbt != null && typeof vbt === 'object' && !Array.isArray(vbt)
+                        ? Object.fromEntries(Object.entries(vbt as Record<string, unknown>).map(([k, v]) => [k, String(v)]))
+                        : null,
             });
         } catch {
             // skip malformed lines
         }
     }
+    return entries;
+}
+
+export function readOrchestrationMetrics(
+    lines: string[],
+): GuardrailMetrics {
+    const entries = parseOrchEntries(lines);
 
     if (entries.length === 0) {
         return { token_ratio: 1, spawn_failure_rate: 0, verify_skip_rate: 0, user_override_rate: 0 };
@@ -174,3 +195,192 @@ export function readOrchestrationMetrics(
         user_override_rate: 0, // cannot measure from telemetry alone
     };
 }
+
+/**
+ * Per-tier / per-class routing aggregates (road-to-cost-aware-model-routing
+ * Phase 0). Pure aggregation over the routing telemetry fields — feeds the
+ * `/cost:report` per-tier view and the Phase-2 tripwires. Pre-extension lines
+ * (null routing fields) are ignored per aggregate.
+ */
+export interface TierRoutingMetrics {
+    /** Dispatch count per tier_chosen. */
+    dispatches_by_tier: Record<string, number>;
+    /** Dispatch count per task_class. */
+    dispatches_by_class: Record<string, number>;
+    /** Escalation count per task_class (entries with escalated_from set). */
+    escalations_by_class: Record<string, number>;
+    /** escalations_by_class / dispatches_by_class, per class present in both. */
+    escalation_rate_by_class: Record<string, number>;
+    /** Per tier: pass / (pass + fail) over verify_result_by_tier attempts. */
+    verify_pass_rate_by_tier: Record<string, number>;
+}
+
+export function readTierRoutingMetrics(lines: string[]): TierRoutingMetrics {
+    const entries = parseOrchEntries(lines);
+
+    const dispatches_by_tier: Record<string, number> = {};
+    const dispatches_by_class: Record<string, number> = {};
+    const escalations_by_class: Record<string, number> = {};
+    const verifyCounts: Record<string, { pass: number; fail: number }> = {};
+
+    for (const e of entries) {
+        if (e.tier_chosen !== null) {
+            dispatches_by_tier[e.tier_chosen] = (dispatches_by_tier[e.tier_chosen] ?? 0) + 1;
+        }
+        if (e.task_class !== null) {
+            dispatches_by_class[e.task_class] = (dispatches_by_class[e.task_class] ?? 0) + 1;
+            if (e.escalated_from !== null) {
+                escalations_by_class[e.task_class] = (escalations_by_class[e.task_class] ?? 0) + 1;
+            }
+        }
+        if (e.verify_result_by_tier !== null) {
+            for (const [tier, result] of Object.entries(e.verify_result_by_tier)) {
+                const c = (verifyCounts[tier] ??= { pass: 0, fail: 0 });
+                if (result === 'pass') c.pass += 1;
+                else if (result === 'fail') c.fail += 1;
+                // 'skipped' counts toward neither pass nor fail.
+            }
+        }
+    }
+
+    const escalation_rate_by_class: Record<string, number> = {};
+    for (const [cls, n] of Object.entries(dispatches_by_class)) {
+        escalation_rate_by_class[cls] = (escalations_by_class[cls] ?? 0) / n;
+    }
+
+    const verify_pass_rate_by_tier: Record<string, number> = {};
+    for (const [tier, c] of Object.entries(verifyCounts)) {
+        const attempts = c.pass + c.fail;
+        if (attempts > 0) verify_pass_rate_by_tier[tier] = c.pass / attempts;
+    }
+
+    return {
+        dispatches_by_tier,
+        dispatches_by_class,
+        escalations_by_class,
+        escalation_rate_by_class,
+        verify_pass_rate_by_tier,
+    };
+}
+
+/**
+ * Cost-routing tripwires (road-to-cost-aware-model-routing Phase 2) —
+ * steering policy over the routing telemetry, surfaced never auto-flipped.
+ */
+export const ROUTING_TRIPWIRES = {
+    /**
+     * Per-class escalation rate above which the class's static default tier
+     * should be promoted: cascading a class that escalates this often costs
+     * more than starting on the higher tier.
+     */
+    escalation_promotion_rate: 0.4,
+    /** Verify-pass rate drop (absolute) below the trailing baseline that counts as drift. */
+    verify_pass_drift_tolerance: 0.1,
+    /** Minimum dispatches per class before the escalation tripwire may fire (noise floor). */
+    min_class_dispatches: 5,
+} as const;
+
+/**
+ * Tripwire (i): classes whose escalation rate exceeds the promotion
+ * threshold — their static default tier is wrong; promote it, stop cascading.
+ * Classes below the dispatch noise floor never fire.
+ */
+export function escalationPromotionCandidates(m: TierRoutingMetrics): string[] {
+    const candidates: string[] = [];
+    for (const [cls, rate] of Object.entries(m.escalation_rate_by_class)) {
+        const dispatches = m.dispatches_by_class[cls] ?? 0;
+        if (dispatches < ROUTING_TRIPWIRES.min_class_dispatches) continue;
+        if (rate > ROUTING_TRIPWIRES.escalation_promotion_rate) candidates.push(cls);
+    }
+    return candidates.sort();
+}
+
+/**
+ * Tripwire (ii): tiers whose current verify-pass rate dropped below the
+ * trailing baseline by more than the tolerance — verifier or model drift.
+ * Tiers absent from either side are skipped (no baseline → no drift claim).
+ */
+export function verifyPassDrift(
+    current: Record<string, number>,
+    trailingBaseline: Record<string, number>,
+): string[] {
+    const drifting: string[] = [];
+    for (const [tier, baseline] of Object.entries(trailingBaseline)) {
+        const now = current[tier];
+        if (now === undefined) continue;
+        if (now < baseline - ROUTING_TRIPWIRES.verify_pass_drift_tolerance) drifting.push(tier);
+    }
+    return drifting.sort();
+}
+
+/**
+ * Verify-fail escalation (road-to-cost-aware-model-routing Phase 4 / M3).
+ *
+ * A verification FAILURE on a downshifted return re-dispatches the slice one
+ * tier up, consuming the existing N=3 budget — never a new budget. Confined
+ * to tier_source static|inferred; inherit slices keep same-tier retry.
+ * The trigger is the judge verdict / deterministic verify result — never the
+ * subagent's self-reported confidence.
+ */
+export type EscalationTier = 'lite' | 'medium' | 'high';
+
+export interface VerifyFailInputs {
+    /** Tier of the attempt that just failed verification. */
+    failed_tier: EscalationTier;
+    /** Provenance of the slice's tier (telemetry `tier_source`). */
+    tier_source: 'static' | 'inferred' | 'inherit';
+    /** Consecutive failed attempts on this slice INCLUDING the one that just failed. */
+    consecutive_failures: number;
+}
+
+export interface VerifyFailDecision {
+    action: 'escalate' | 'retry-same-tier' | 'slice-failed';
+    /** Tier for the next attempt; null when the slice is failed. */
+    next_tier: EscalationTier | null;
+    reason: string;
+}
+
+const TIER_ABOVE: Record<EscalationTier, EscalationTier | null> = {
+    lite: 'medium',
+    medium: 'high',
+    high: null,
+};
+
+export function escalateOnVerifyFail(inp: VerifyFailInputs): VerifyFailDecision {
+    // Outside the downshift path → existing same-tier retry semantics, budget unchanged.
+    if (inp.tier_source === 'inherit') {
+        if (budgetHalt(inp.consecutive_failures)) {
+            return { action: 'slice-failed', next_tier: null, reason: 'N=3 budget exhausted on session tier' };
+        }
+        return {
+            action: 'retry-same-tier',
+            next_tier: inp.failed_tier,
+            reason: 'inherit slice — no downshift decision, same-tier retry semantics unchanged',
+        };
+    }
+
+    // Downshifted slice: two failed attempts mark the slice failed — the third
+    // "attempt" of the N=3 budget is the orchestrator's replan at session tier.
+    if (inp.consecutive_failures >= 2) {
+        return {
+            action: 'slice-failed',
+            next_tier: null,
+            reason: 'two failed attempts on a downshifted slice — mark failed, orchestrator replans at session tier',
+        };
+    }
+
+    const above = TIER_ABOVE[inp.failed_tier];
+    if (above === null) {
+        return {
+            action: 'slice-failed',
+            next_tier: null,
+            reason: 'verify-fail on the highest tier — no tier above, mark failed and replan',
+        };
+    }
+
+    return {
+        action: 'escalate',
+        next_tier: above,
+        reason: `verify-fail on ${inp.failed_tier} → re-dispatch one tier up (${above}); consumes the N=3 budget`,
+    };
+}

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';