@event4u/agent-config 8.4.0 → 8.5.0

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/prepack-check.mjs

@@ -2,11 +2,16 @@
 /**
  * prepack-check.mjs — guard the published artifact.
  *
- * Runs during `npm pack` and `npm publish`. Asserts the compiled TS
- * CLI binary exists, is executable, and carries the Node shebang
- * before the tarball is built. Otherwise a silently-broken `dist/`
- * ships and every `npx @event4u/agent-config` greets the consumer
- * with a cryptic `Cannot find module` panic.
+ * Runs during `npm pack` / `npm publish` AND as a dry-run on every PR
+ * (Static Checks workflow). Two gates:
+ *
+ *   1. Compiled-bin shape — the TS CLI binary exists, is executable, and
+ *      carries the Node shebang before the tarball is built. Otherwise a
+ *      silently-broken `dist/` ships and every `npx @event4u/agent-config`
+ *      greets the consumer with a cryptic `Cannot find module` panic.
+ *   2. Shipped-import completeness — every relative import reachable from
+ *      the shipped `src/` trees resolves to a file the `files` whitelist
+ *      actually ships (the 8.3.0 ERR_MODULE_NOT_FOUND class).
  *
  * Folded from external council pass 2026-05-18 (Phase 1.3 acceptance).
  *
@@ -56,6 +61,104 @@ if (head !== SHEBANG) {
 
 process.stderr.write(`prepack-check: ${BIN} OK\n`);
 
+// ---------------------------------------------------------------------------
+// Import-completeness guard: every relative import reachable from the
+// SHIPPED src/ trees must itself resolve to a shipped file. Catches the
+// 8.3.0 class of bug where src/scripts/_lib/claude_settings_hooks.ts
+// imported src/install/atomic.js while the `files` whitelist did not ship
+// src/install/ — the global install then crashed doctor/conformance with
+// ERR_MODULE_NOT_FOUND. Deterministic, no network, no npm pack invocation:
+// the shipped set is derived from the package.json `files` whitelist.
+// ---------------------------------------------------------------------------
+import { readdirSync } from 'node:fs';
+import { dirname, join, relative, sep } from 'node:path';
+
+const pkg = JSON.parse(readFileSync(resolve('package.json'), 'utf8'));
+const shippedPrefixes = (pkg.files ?? [])
+    .filter((f) => f.endsWith('/'))
+    .map((f) => f.replace(/\/+$/, '') + '/');
+const shippedFiles = new Set((pkg.files ?? []).filter((f) => !f.endsWith('/')));
+
+function isShipped(relPath) {
+    const posix = relPath.split(sep).join('/');
+    if (shippedFiles.has(posix)) return true;
+    return shippedPrefixes.some((p) => posix.startsWith(p));
+}
+
+function* walk(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+        return;
+    }
+    for (const e of entries) {
+        const full = join(dir, e.name);
+        if (e.isDirectory()) {
+            yield* walk(full);
+        } else if (/\.(ts|mts|mjs|js)$/.test(e.name) && !e.name.endsWith('.d.ts')) {
+            yield full;
+        }
+    }
+}
+
+const IMPORT_RE = /(?:from\s+|import\s*\(\s*|require\s*\(\s*)['"](\.\.?\/[^'"]+)['"]/g;
+
+function resolveCandidates(fromDir, spec) {
+    const base = join(fromDir, spec);
+    return [
+        base,
+        base.replace(/\.js$/, '.ts'),
+        base.replace(/\.mjs$/, '.mts'),
+        `${base}.ts`,
+        `${base}.js`,
+        join(base, 'index.ts'),
+        join(base, 'index.js'),
+    ];
+}
+
+const importErrors = [];
+const scanRoots = shippedPrefixes.filter((p) => p.startsWith('src/'));
+for (const root of scanRoots) {
+    for (const file of walk(resolve(root))) {
+        const text = readFileSync(file, 'utf8');
+        for (const m of text.matchAll(IMPORT_RE)) {
+            const spec = m[1];
+            const candidates = resolveCandidates(dirname(file), spec);
+            const hit = candidates.find((c) => {
+                try {
+                    return statSync(c).isFile();
+                } catch {
+                    return false;
+                }
+            });
+            const fileRel = relative(resolve('.'), file);
+            if (hit === undefined) {
+                importErrors.push(`${fileRel}: unresolvable relative import '${spec}'`);
+                continue;
+            }
+            const hitRel = relative(resolve('.'), hit);
+            if (!isShipped(hitRel)) {
+                importErrors.push(
+                    `${fileRel}: imports '${spec}' → ${hitRel}, which is NOT in the ` +
+                        'package.json `files` whitelist (would crash the global install ' +
+                        'with ERR_MODULE_NOT_FOUND)',
+                );
+            }
+        }
+    }
+}
+
+if (importErrors.length > 0) {
+    for (const e of importErrors) {
+        process.stderr.write(`prepack-check: ${e}\n`);
+    }
+    die(`${importErrors.length} shipped import(s) escape the files whitelist.`);
+}
+process.stderr.write(
+    `prepack-check: import-completeness OK (${scanRoots.length} shipped src tree(s) scanned)\n`,
+);
+
 // Optional: invoked with --verbose dumps the size for tarball-budget bookkeeping.
 if (argv.includes('--verbose')) {
     process.stderr.write(`prepack-check: size=${st.size} bytes\n`);

package/src/scripts/print_required_checks.ts

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

package/src/scripts/probe_projection_fidelity.ts

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

package/src/scripts/probe_skill_registration.ts

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

package/src/scripts/profile_staleness_hook.ts

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

package/src/scripts/profile_use.ts

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

package/src/scripts/project_thin_rules.ts

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

package/src/scripts/propose_modules_config.ts

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

package/src/scripts/prototype_lint_contradictions.ts

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

package/src/scripts/prove_pack_extractable.ts

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

package/src/scripts/readme_linter.ts

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

package/src/scripts/redact_hook_capture.ts

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

package/src/scripts/refine_ticket_detect.ts

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