@event4u/agent-config 8.1.0 → 8.2.0

package/dist/agent-src/commands/council/design.md

@@ -60,10 +60,10 @@ Invoke the matching `/council default` form:
 - `prompt:` → `/council default prompt:"<artefact text>"` with
   `--prompt-mode design`.
 
-`--prompt-mode` is the CLI flag (`scripts/council_cli.py`) that
+`--prompt-mode` is the CLI flag (`scripts/council_cli.ts`) that
 swaps the lens addendum after the bundler has run.
 
-The `design` mode addendum from `scripts/ai_council/prompts.py`
+The `design` mode addendum from `scripts/ai_council/prompts.ts`
 focuses council members on:
 
 - Trust-boundary and module-coupling risk.

package/dist/agent-src/commands/council/optimize.md

@@ -73,7 +73,7 @@ The chosen metric becomes the `original_ask` for the handoff preamble:
 
 Invoke the matching `/council default` form (`files:` / `prompt:`) with
 `--prompt-mode optimize`. The `optimize` mode addendum from
-`scripts/ai_council/prompts.py` requires members to:
+`scripts/ai_council/prompts.ts` requires members to:
 
 - Rank suggestions by expected impact on the chosen metric, not by
   effort or cleverness.

package/dist/agent-src/commands/council/pr.md

@@ -48,7 +48,7 @@ gh pr view <number> --json number,title,body,headRefName,baseRefName,author,url
 
 Capture: title, body, head ref, base ref. The **PR title + body** is
 the user's `original_ask` for the handoff preamble — verbatim, after
-`_strip_host_identity()` cleansing in `prompts.py`. Do **not** add the
+`_strip_host_identity()` cleansing in `prompts.ts`. Do **not** add the
 agent's framing.
 
 ### 3. Fetch the diff range locally
@@ -68,7 +68,7 @@ Invoke `/council default diff:<base>..<head>` with:
 - `original_ask` = PR title + body (capped per
   `bundler.size_guard`; warn if truncated).
 - Pass `--prompt-mode pr` so the neutrality preamble uses the `pr`
-  mode addendum from `scripts/ai_council/prompts.py` — focuses
+  mode addendum from `scripts/ai_council/prompts.ts` — focuses
   members on PR-specific risks (shipping risk, reviewer fatigue,
   scope creep) on top of the generic diff focus (correctness,
   security, tests, maintainability).

package/dist/agent-src/commands/council.md

@@ -44,7 +44,7 @@ Each wrapper resolves its lens-specific input (PR target, design artefact,
 optimization target + metric), captures a wrapper-specific `original_ask`,
 then delegates to `/council default` with `mode_override=<lens>`. The
 lens-specific neutrality addendums live in **one** place —
-[`scripts/ai_council/prompts.py:_MODE_TABLE`](../../scripts/ai_council/prompts.py) —
+[`scripts/ai_council/prompts.ts:_MODE_TABLE`](../../scripts/ai_council/prompts.ts) —
 and are selected by the `mode_override` value. Wrappers never re-implement
 cost-gate, CLI invocation, render, or the host-verdict pass; those flow
 through the master verbatim.

package/dist/agent-src/commands/feature/plan.md

@@ -155,7 +155,7 @@ If no context exists, note this for step 8 (offer to create one after planning).
 
 ### 5b. Determine scope (module vs. project-wide)
 
-Resolve module roots via `scripts/_lib/agent_settings.py::enumerate_modules()`
+Resolve module roots via `scripts/_lib/agent_settings.ts::enumerate_modules()`
 (reads `modules.root_paths` + `modules.agent_folder` from
 `.agent-project-settings.yml`). If at least one module is discovered, ask:
 

package/dist/agent-src/commands/ghostwriter/list.md

@@ -86,7 +86,7 @@ If Step 1 encountered a `fictional: true` file under
     or delete this file.
 ```
 
-This should not normally happen — `scripts/lint_ghostwriter_source.py`
+This should not normally happen — `scripts/lint_ghostwriter_source.ts`
 guards the package side (run via the package's CI), and consumer-side
 `fetch` always writes `fictional: false`.
 

package/dist/agent-src/commands/ghostwriter/write.md

@@ -144,7 +144,7 @@ Non-blocking.
 - **Do NOT commit, push, or open a PR.** The user owns the git surface.
 - **Do NOT omit the disclosure footer.** It is mandatory on every
   invocation. Any flag that would suppress it is forbidden by design
-  and rejected by the package skill linter (`scripts/lint_skills.py`).
+  and rejected by the package skill linter (`scripts/skill_linter.ts`).
 - **Do NOT write the draft to disk.** This command prints only.
 - **Do NOT blend multiple ghostwriter voices.** One style source per
   invocation in v1.

package/dist/agent-src/commands/ghostwriter.md

@@ -88,7 +88,7 @@ Cluster locked in
 |---|---|---|
 | `agents/reference/ghostwriter/<slug>.md` (consumer) | Real-person public-figure profiles | **No** — gitignored by default. `--shared` opt-in deferred to v2. |
 | `agents/reference/ghostwriter/README.md` (consumer) | Directory anchor + how-to | Yes |
-| `.agent-src.uncondensed/ghostwriter/*.md` (package) | `fictional: true` fixtures only | Yes — CI-enforced by `scripts/lint_ghostwriter_source.py` |
+| `.agent-src.uncondensed/ghostwriter/*.md` (package) | `fictional: true` fixtures only | Yes — CI-enforced by `scripts/lint_ghostwriter_source.ts` |
 
 Slug = full-name kebab-case with optional `-<discriminator>` suffix
 (`alice-walker` vs `alice-walker-novelist`). The package never

package/dist/agent-src/commands/implement-ticket.md

@@ -8,7 +8,7 @@ replaces: []
 tier: 0
 visibility: visible
 skills: [refine-ticket, feature-planning]
-description: Drive a ticket end-to-end through refine → memory → analyze → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, block-on-ambiguity, no auto-git.
+description: Drive a ticket end-to-end through refine → memory → analyze → plan → implement → test → verify → report — Option-A loop over the `work_engine` engine, block-on-ambiguity, no auto-git.
 suggestion:
   eligible: true
   trigger_description: "implement this ticket, setze ticket X um, build PROJ-123"
@@ -110,7 +110,7 @@ Run the engine with the state file on every iteration:
     [--ticket-file ticket.json --persona <name>]   # first call only
 ```
 
-The dispatcher wires `PYTHONPATH` and routes to the engine module
+The dispatcher resolves the engine module (TypeScript, run via tsx)
 internally. `./agent-config` is the only supported entry point in
 consumer repos — do not call the engine module directly.
 

package/dist/agent-src/commands/judge/on-diff.md

@@ -56,7 +56,7 @@ context. The judge must return one of:
 
 ### 5. Apply or revise
 
-- `apply` → write the diff, run targeted tests, run quality pipeline
+- `apply` → write the diff, run targeted tests; run the quality pipeline only when `quality.local_auto_run: true` (default `false` → skip, remote CI is the gate)
 - `revise` → hand the issue list back to the implementer, loop to step 4
 - `reject` → stop, report to user, do not loop
 

package/dist/agent-src/commands/judge/steps.md

@@ -66,7 +66,9 @@ On stop, report the last verified state so the user can resume.
 ### 5. Final verification
 
 After step N passes judgment, run `verify-completion-evidence` across the
-whole changeset — targeted tests + full suite + quality pipeline.
+whole changeset — targeted tests, plus full suite + quality pipeline only
+when `quality.local_auto_run: true` (default `false` → skip, remote CI is
+the gate; report "quality gates delegated to remote CI").
 Never declare the plan "done" without this gate.
 
 ### 6. Report

package/dist/agent-src/commands/memory/add.md

@@ -31,7 +31,7 @@ the first write and for every subsequent addition.
 ## Prerequisites
 
 - Consumer project has an `agents/` directory (package installed).
-- `scripts/check_memory.py` is available (shipped with the package).
+- `scripts/check_memory.ts` is available (shipped with the package).
 - User can name a concrete pattern — see the "when to reject" section.
 
 ## Steps
@@ -136,7 +136,7 @@ Read `verbosity.post_action_reports` from `.agent-settings.yml` (default
   ```
   ✅  Added <type>/<id> (confidence: <high|medium|low>)
      Path: agents/memory/<type>.yml (or agents/memory/<type>/<hash>.yml)
-     Gate: scripts/check_memory.py → PASS
+     Gate: scripts/check_memory.ts → PASS
      Next: commit and link from the relevant skill/command.
   ```
 

package/dist/agent-src/commands/memory/learn-low-impact.md

@@ -52,7 +52,7 @@ for the eight forbidden-content classes.
 ### 1. Build the preview plan
 
 Call
-`scripts/ai_council/learn_low_impact_preview.py::build_preview` with
+`scripts/ai_council/learn_low_impact_preview.ts::build_preview` with
 the project-local corpus and the package seed:
 
 ```python

package/dist/agent-src/commands/memory/load.md

@@ -81,7 +81,7 @@ for (const f of glob("agents/memory").sort()) {
 The Tier-0 slice is surfaced once per `/memory:load` invocation, even
 when the user picks a type with no critical entries — the slice spans
 types deliberately. Token cost is bounded by the soft cap of 10
-critical entries per type (warned by `scripts/check_memory.py`).
+critical entries per type (warned by `scripts/check_memory.ts`).
 
 ### 2. Warn about volume
 

package/dist/agent-src/commands/memory/mine-session.md

@@ -167,7 +167,7 @@ Confirm:
   reasoning blocks, system reminders) before pattern matching. If the
   miner under-counts, audit the adapter's redact list, not the regex.
 - Date-discipline: relative phrases (`yesterday`, `last week`) in the
-  observation field are rejected by `scripts/check_memory.py` unless
+  observation field are rejected by `scripts/check_memory.ts` unless
   re-anchored with `YYYY-MM-DD` within ±20 chars. The miner re-anchors
   automatically using the turn's `ts`; verify before commit.
 

package/dist/agent-src/commands/memory/promote.md

@@ -21,7 +21,7 @@ packs:
 Moves an entry from the provisional layer (intake JSONL) into the
 curated layer (`agents/memory/<type>.yml` or sharded). Promotion is
 gated by
-[`scripts/check_memory_proposal.py`](../../../scripts/check_memory_proposal.py),
+[`scripts/check_memory_proposal.ts`](../../../scripts/check_memory_proposal.ts),
 which enforces the **pattern-vs-one-off** discipline: either ≥ 2
 distinct paths share the root-cause signature, or the submitter
 supplies ≥ 3 concrete future decisions that will be steered by the

package/dist/agent-src/commands/memory/propose.md

@@ -19,7 +19,7 @@ packs:
 
 # /memory propose
 Drops a **signal** into `agents/memory/intake/signals-YYYY-MM.jsonl` via
-`scripts/memory_signal.py`. Signals are append-only JSONL and merge-safe.
+`scripts/memory_signal.ts`. Signals are append-only JSONL and merge-safe.
 
 Unlike [`/memory-add`](memory-add.md) — which writes a **curated**
 entry the reviewer has validated — `/propose-memory` is cheap and

package/dist/agent-src/commands/mission/upgrade.md

@@ -158,7 +158,7 @@ Per [`scope-control`](../../rules/scope-control.md), git operations are permissi
 
 ## Breaking-change catalog
 
-Knowledge source: `src/missions/upgrade/laravel-10-to-11.yaml`. Versionable, diffable, CI-tested via `lint_missions.py`. Each entry carries:
+Knowledge source: `src/missions/upgrade/laravel-10-to-11.yaml`. Versionable, diffable, CI-tested via `lint_missions.ts`. Each entry carries:
 
 - `id` — unique checkpoint key (used in `.work-state.json`)
 - `severity` — `critical` / `high` / `medium` / `low`

package/dist/agent-src/commands/module/explore.md

@@ -24,12 +24,12 @@ packs:
 ### 1. Resolve module roots
 
 Read the `modules:` block from `.agent-project-settings.yml` via the
-loader (`get_modules_config()` in `scripts/_lib/agent_settings.py`):
+loader (`get_modules_config()` in `scripts/_lib/agent_settings.ts`):
 
 - If `modules.enabled` is `true` and `modules.root_paths` is non-empty,
   use those paths verbatim. Skip the fallback table.
 - If the block is missing / disabled / empty, fall back to the
-  auto-detection table below — same shape `propose_modules_config.py`
+  auto-detection table below — same shape `propose_modules_config.ts`
   uses internally.
 
 **Auto-detection fallback table** (consulted only when `modules:` is
@@ -54,7 +54,7 @@ Stop.
 ### 2. List available modules
 
 Enumerate modules across every resolved root via `enumerate_modules()`
-(see `scripts/_lib/agent_settings.py`). Skip directories listed in
+(see `scripts/_lib/agent_settings.ts`). Skip directories listed in
 `modules.skip_dirs` (defaults: `.module-template`, `.example`) and
 hidden dirs. The "Agent Docs" column reflects the configured
 `modules.agent_folder` (default `agents/`):

package/dist/agent-src/commands/optimize/agents-dir.md

@@ -58,7 +58,7 @@ surface changes.
 
 1. **Verify project root** — look for `composer.json`, `artisan`, or `package.json`.
 2. **Create directory structure** — `agents/{roadmaps,features,contexts}/.gitkeep` + `.augment/guidelines/php/.gitkeep`. Skip dirs that already exist with content.
-3. **Module support** — resolve module roots via `scripts/_lib/agent_settings.py::enumerate_modules()`. For every discovered module, mirror the layout: `{module_root}/{Module}/{agent_folder}/{roadmaps,features,contexts}/.gitkeep` (Laravel example: `app/Modules/{Module}/agents/{roadmaps,features,contexts}/.gitkeep`). Skip when `modules.enabled: false` or no roots configured.
+3. **Module support** — resolve module roots via `scripts/_lib/agent_settings.ts::enumerate_modules()`. For every discovered module, mirror the layout: `{module_root}/{Module}/{agent_folder}/{roadmaps,features,contexts}/.gitkeep` (Laravel example: `app/Modules/{Module}/agents/{roadmaps,features,contexts}/.gitkeep`). Skip when `modules.enabled: false` or no roots configured.
 4. **Verify templates** — confirm `.augment/templates/{features,roadmaps,contexts}.md` exist; warn on missing.
 5. **Clean up old templates** — offer to delete legacy `agents/features/template.md` etc. (now in `.augment/templates/`); ask before delete.
 6. **Show summary** — table with status per directory and template; flag missing as `⚠️`.

package/dist/agent-src/commands/optimize/skills.md

@@ -129,5 +129,5 @@ If any check fails: do NOT suggest the change.
 - **No quality judgments** — the skill linter and `skill-reviewer` handle that
 - **No auto-fixes** — all changes require explicit user approval
 - **No "make it shorter"** — condensation is done by Telegraph Condensation, not here
-- **No Killer checks** — replaced by the skill linter (`scripts/skill_linter.py`)
+- **No Killer checks** — replaced by the skill linter (`scripts/skill_linter.ts`)
 - **No edits to `dist/agent-src/` or `.augment/`** — always edit `.agent-src.uncondensed/`, then sync

package/dist/agent-src/commands/optimize-project.md

@@ -62,7 +62,7 @@ audit (route to `/analyze:decision`), code-only analysis
      installed agent layer. Surface = workflows, structures, docs,
      roadmaps, decisions.
 2. Resolve module roots via
-   `scripts/_lib/agent_settings.py::enumerate_modules()` (Laravel shape:
+   `scripts/_lib/agent_settings.ts::enumerate_modules()` (Laravel shape:
    `app/Modules/*/agents/`); fallback `modules.root_paths` in
    `.agent-settings.yml`.
 3. Exclusions hard: never analyze `vendor/`, `node_modules/`, `dist/`,

package/dist/agent-src/commands/orchestrate.md

@@ -28,7 +28,7 @@ personas, skills, commands, and sub-agents pinned by the
 contract.
 
 This command is the **runtime** side of the contract. The schema and
-the linter (`scripts/lint_orchestration_dsl.py`) live on the authoring
+the linter (`scripts/lint_orchestration_dsl.ts`) live on the authoring
 side; this command reads the same shape and dispatches each step.
 
 ### 1. Resolve the pipeline file
@@ -125,6 +125,6 @@ output body.
 ## See also
 
 - Contract: [`orchestration-dsl-v1.md`](../docs/contracts/orchestration-dsl-v1.md)
-- Linter: `scripts/lint_orchestration_dsl.py`
+- Linter: `scripts/lint_orchestration_dsl.ts`
 - Subagent runtime: [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
 - Audit emission: [`audit-log-v1.md`](../docs/contracts/audit-log-v1.md)

package/dist/agent-src/commands/project-analyze.md

@@ -31,7 +31,7 @@ Gather in parallel:
 - Check for: `artisan`, `Makefile`, `Taskfile.yml`, `docker-compose.yml`
 - Check for: `phpstan.neon`, `ecs.php`, `rector.php`, `config-dev/`
 - Check for: `.github/workflows/`, `CODEOWNERS`, `.editorconfig`
-- Check for module roots (resolve via `scripts/_lib/agent_settings.py::enumerate_modules()`; Laravel shape: `app/Modules/`), multi-tenant indicators (`customer_database`)
+- Check for module roots (resolve via `scripts/_lib/agent_settings.ts::enumerate_modules()`; Laravel shape: `app/Modules/`), multi-tenant indicators (`customer_database`)
 - Read: `AGENTS.md`, `.github/copilot-instructions.md` (if exist)
 
 Display:

package/dist/agent-src/commands/project-health.md

@@ -29,7 +29,7 @@ Run in parallel:
 - `git branch --show-current` → current branch
 - `git log --oneline -3` → recent activity
 - Count files in `agents/` (docs, features, roadmaps, contexts)
-- Resolve modules via `scripts/_lib/agent_settings.py::enumerate_modules()`
+- Resolve modules via `scripts/_lib/agent_settings.ts::enumerate_modules()`
 - For every module: count files in `{module_path}/{modules.agent_folder}/` (Laravel shape: `app/Modules/*/agents/`)
 - Module list comes from `enumerate_modules()` (Laravel shape: `app/Modules/`)
 - Count test files

package/dist/agent-src/commands/roadmap/ai-council.md

@@ -187,4 +187,4 @@ It does **NOT**:
 - [`/roadmap`](../roadmap.md) — cluster orchestrator
 - [`/council default`](../council/default.md) — base flow this command wraps
 - [`ai-council`](../../skills/ai-council/SKILL.md) — neutrality, redaction, deep tier
-- [`scripts/council_cli.py`](../../../scripts/council_cli.py) — CLI entry point
+- [`scripts/council_cli.ts`](../../../scripts/council_cli.ts) — CLI entry point

package/dist/agent-src/commands/roadmap/create.md

@@ -29,7 +29,7 @@ Ask the user (in their language) where the roadmap should be created:
 > 2. In a module (`{module_root}/{Name}/{agent_folder}/roadmaps/`)
 
 If the user picks a module → resolve module roots via
-`scripts/_lib/agent_settings.py::enumerate_modules()`, list available
+`scripts/_lib/agent_settings.ts::enumerate_modules()`, list available
 modules from `modules.root_paths`, and ask which one. The target
 directory is `{module_path}/{modules.agent_folder}/roadmaps/`
 (default `agent_folder` = `agents`).
@@ -184,7 +184,7 @@ If the user picks **1**:
 
 - Run `/council roadmap:<path>` with the user's original ask captured
   in step 1 as `original_ask` (the handoff preamble carries it
-  verbatim, see `scripts/ai_council/prompts.py`).
+  verbatim, see `scripts/ai_council/prompts.ts`).
 - Append the council findings as a `## Council review (<UTC date>)`
   section at the bottom of the roadmap. Include the trace path to
   `agents/runtime/council/sessions/<timestamp>/raw-text.md` so future readers

package/dist/agent-src/commands/roadmap/process-full.md

@@ -53,7 +53,9 @@ with the **scope delta below**.
   security-sensitive, scope-out-of-roadmap, test/quality red).
 - **Phase boundary handling:** at every phase boundary, run the
   per-phase quality pipeline when `quality_cadence: per_phase` (or
-  `per_step`). On red → stop, surface, do **not** silently roll into
+  `per_step`) AND `quality.local_auto_run: true` — under the default
+  (`false` / missing) the pipeline never runs locally; remote CI is
+  the gate. On red → stop, surface, do **not** silently roll into
   the next phase. Under `mode: phase-checkpoints`, additionally emit
   the compact status + continue prompt at every boundary; under
   `autonomous`, boundaries are silent (quality pipeline aside).

package/dist/agent-src/commands/roadmap/process-phase.md

@@ -52,8 +52,10 @@ branching, halt conditions, and the archival check.
   phase. Use [`/roadmap:process-full`](process-full.md) for continuous
   execution across phases.
 - **Quality cadence at the boundary:** run the per-phase pipeline when
-  `quality_cadence: per_phase` (or `per_step`). Skip when
-  `end_of_roadmap`.
+  `quality_cadence: per_phase` (or `per_step`) AND
+  `quality.local_auto_run: true`. Skip when `end_of_roadmap` — and
+  always skip under the default (`local_auto_run` `false` / missing);
+  remote CI is the gate.
 
 ## Rules
 

package/dist/agent-src/commands/roadmap/process-step.md

@@ -45,7 +45,9 @@ with the **scope delta below**.
   [`roadmap-process-loop § 5`](../../contexts/execution/roadmap-process-loop.md#5-step-loop)
   (sub-steps 1–7). After the checkbox edit + dashboard regen, **stop**.
 - **Quality cadence:** run the per-step pipeline only when
-  `quality_cadence: per_step`. Skip otherwise.
+  `quality_cadence: per_step` AND `quality.local_auto_run: true`.
+  Skip otherwise — under the default (`false` / missing) remote CI
+  is the gate.
 - **Phase boundary:** if this single step happens to close the phase,
   do **not** advance. Report the phase as complete and stop.
 - **Roadmap boundary:** if this single step happens to close the

package/dist/agent-src/commands/security-audit-config.md

@@ -79,6 +79,6 @@ Overall: B (84/100)
 
 ## See also
 
-- [`lint_agent_security`](../../../src/scripts/lint_agent_security.py) — the self-audit (our own corpus) sibling.
+- [`lint_agent_security`](../../../src/scripts/lint_agent_security.ts) — the self-audit (our own corpus) sibling.
 - [`untrusted-input-defense`](../../rules/untrusted-input-defense.md), [`lethal-trifecta-guard`](../../rules/lethal-trifecta-guard.md) — the always-on prevention rules.
 - [`/threat-model`](../threat-model/command.md), [`judge-security-auditor`](../skills/judge-security-auditor/SKILL.md) — deep-pass dispatch.

package/dist/agent-src/commands/sync-agent-settings.md

@@ -57,9 +57,9 @@ Use when:
 
 The sync script ships in the installed package. Resolve in order:
 
-1. `./agent-config/scripts/sync_agent_settings.py` — CLI wrapper at the project root.
-2. `vendor/event4u/agent-config/scripts/sync_agent_settings.py` — Composer.
-3. `node_modules/@event4u/agent-config/scripts/sync_agent_settings.py` — npm.
+1. `./agent-config/scripts/sync_agent_settings.ts` — CLI wrapper at the project root.
+2. `vendor/event4u/agent-config/scripts/sync_agent_settings.ts` — Composer.
+3. `node_modules/@event4u/agent-config/scripts/sync_agent_settings.ts` — npm.
 
 Target is always `<project_root>/.agent-settings.yml`.
 
@@ -106,7 +106,7 @@ separate decision from reconciling structure.
 
 ## `--check` mode
 
-`sync_agent_settings.py --check` exits **2** if the file is out of
+`sync_agent_settings.ts --check` exits **2** if the file is out of
 sync, **0** otherwise — suitable for CI. Emit no diff prompt in
 check-only workflows; report the drift and let the pipeline decide.
 
@@ -128,15 +128,15 @@ check-only workflows; report the drift and let the pipeline decide.
 ## Cloud Behavior
 
 On cloud surfaces (Claude.ai Web, Skills API) this command is **fully inert** —
-there is no `.agent-settings.yml` on disk, no `scripts/sync_agent_settings.py`
+there is no `.agent-settings.yml` on disk, no `scripts/sync_agent_settings.ts`
 to call, and no template/profile preset reachable. Settings reconciliation
 is a local-agent concern.
 
 ## See also
 
-- [`scripts/sync_agent_settings.py`](../../../scripts/sync_agent_settings.py) — the helper
+- [`scripts/sync_agent_settings.ts`](../../../scripts/sync_agent_settings.ts) — the helper
 - [`config/agent-settings.template.yml`](../../../config/agent-settings.template.yml) — canonical template
 - [`config/profiles/`](../../../config/profiles/) — profile presets
 - [`layered-settings`](../docs/guidelines/agent-infra/layered-settings.md) — the merge rules this command enforces
-- [`scripts/install.py`](../../../scripts/install.py) — first-install path; this command handles the update path
+- [`scripts/install.ts`](../../../scripts/install.ts) — first-install path; this command handles the update path
 - [`/sync-gitignore`](sync-gitignore.md) — sibling command for the `.gitignore` block

package/dist/agent-src/commands/sync-gitignore/fix.md

@@ -58,9 +58,9 @@ Use when:
 
 Same resolution order as [`/sync-gitignore`](../sync-gitignore.md):
 
-1. `./agent-config/scripts/sync_gitignore.py`
-2. `vendor/event4u/agent-config/scripts/sync_gitignore.py`
-3. `node_modules/@event4u/agent-config/scripts/sync_gitignore.py`
+1. `./agent-config/scripts/sync_gitignore.ts`
+2. `vendor/event4u/agent-config/scripts/sync_gitignore.ts`
+3. `node_modules/@event4u/agent-config/scripts/sync_gitignore.ts`
 
 Target is `<project_root>/.gitignore`. If no `.gitignore` exists,
 stop — there is nothing to fix:

package/dist/agent-src/commands/sync-gitignore.md

@@ -69,10 +69,10 @@ Use when:
 
 The sync script ships in the installed package. Resolve in order:
 
-1. `./agent-config/scripts/sync_gitignore.py` — if the CLI wrapper
+1. `./agent-config/scripts/sync_gitignore.ts` — if the CLI wrapper
    directory exists at the project root.
-2. `vendor/event4u/agent-config/scripts/sync_gitignore.py` — Composer.
-3. `node_modules/@event4u/agent-config/scripts/sync_gitignore.py` — npm.
+2. `vendor/event4u/agent-config/scripts/sync_gitignore.ts` — Composer.
+3. `node_modules/@event4u/agent-config/scripts/sync_gitignore.ts` — npm.
 
 Target is always `<project_root>/.gitignore`. If no `.gitignore` exists,
 stop and tell the user — the package does not create one unilaterally:
@@ -136,6 +136,6 @@ root-level patterns (not user-added lines), prefer
 
 ## See also
 
-- [`scripts/sync_gitignore.py`](../../../scripts/sync_gitignore.py) — the helper
+- [`scripts/sync_gitignore.ts`](../../../scripts/sync_gitignore.ts) — the helper
 - [`config/gitignore-block.txt`](../../../config/gitignore-block.txt) — canonical block body
 - [`scripts/install.sh`](../../../scripts/install.sh) — installer integration (same source of truth, `--skip-gitignore` to opt out)

package/dist/agent-src/commands/work.md

@@ -8,7 +8,7 @@ replaces: []
 tier: 0
 visibility: visible
 skills: [refine-prompt, command-routing]
-description: Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, confidence-band gated, no auto-git.
+description: Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Option-A loop over the `work_engine` engine, confidence-band gated, no auto-git.
 suggestion:
   eligible: true
   trigger_description: "build this, implement this, drive this end-to-end"
@@ -80,7 +80,7 @@ Run the engine with the state file on every iteration:
     [--prompt-file prompt.txt --persona <name>]   # first call only
 ```
 
-The dispatcher wires `PYTHONPATH` and routes to the engine module
+The dispatcher resolves the engine module (TypeScript, run via tsx)
 internally. `./agent-config` is the only supported entry point in
 consumer repos — do not call the engine module directly.
 
@@ -121,7 +121,7 @@ Once the gate releases, the rest of the loop is identical to
 `review-changes` directives flow through the same dispatch table. The
 `run-tests` directive resolves the consumer's runner via the
 [`toolchain-resolver`](../contexts/execution/toolchain-resolver.md)
-(`work_engine/stack/runner.py`) — pest / phpunit / vitest / jest /
+(`work_engine/stack/runner.ts`) — pest / phpunit / vitest / jest /
 pytest / go / cargo, fast suites by default — instead of assuming a
 single stack.
 

package/dist/agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md

@@ -20,7 +20,7 @@ Make descriptions "pushy" — explicit about when to fire:
 - Name 2+ concrete triggers — domains, symptoms, file types, user phrasing.
 - End with: `... even if they don't explicitly ask for \`<skill-name>\`.`
 - Avoid hedges: `may help with`, `can be useful for`, `covers various`.
-- **Keep it ≤ 200 characters.** `scripts/skill_linter.py` warns at
+- **Keep it ≤ 200 characters.** `scripts/skill_linter.ts` warns at
   `description_too_long` above this. If the pushy tail pushes you over, cut
   adjectives, drop the second example phrasing, or collapse a list — do
   **not** drop the trigger vocabulary or the `even if ...` tail.

package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md

@@ -4,9 +4,9 @@ Lookup table for the `slash-command-routing-policy` rule. Lists the
 locked clusters and their sub-commands so the rule itself can stay at
 its current LOC while still reflecting the full surface. Source of
 truth for the cluster names is
-[`docs/contracts/command-clusters.md`](../../../../../../docs/contracts/command-clusters.md);
+[`docs/contracts/command-clusters.md`](../../../../../../../docs/contracts/command-clusters.md);
 this file mirrors that contract for runtime lookup. Linter:
-`scripts/check_cluster_patterns.py` (verifies dispatcher shape).
+`scripts/check_cluster_patterns.ts` (verifies dispatcher shape).
 
 ## Locked clusters and sub-commands
 

package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md

@@ -127,7 +127,7 @@ schema's `EngagementSchemaError` cases.
 ### The four enforcement layers
 
 1. **Schema (write gate)** — `EngagementEvent.validate()` in
-   `telemetry/engagement.py` runs `check_id_redaction` over `task_id`
+   `telemetry/engagement.ts` runs `check_id_redaction` over `task_id`
    and every `consulted` / `applied` artefact id. The CLI exits `1`
    when this fires; nothing reaches the JSONL.
 2. **Aggregator (read gate)** — `aggregator._iter_events` calls

package/dist/agent-src/contexts/contracts/command-suggestion-flow.md

@@ -50,7 +50,7 @@ agent emits the block as the first and ONLY thing this turn
 
 ## Scoring breakdown
 
-Per match, `match.py` computes:
+Per match, `match.ts` computes:
 
 | Component | Weight | Source |
 |---|---|---|
@@ -60,7 +60,7 @@ Per match, `match.py` computes:
 | Structural bonus (ticket key, file path) | +0.05, sets `has_structural_bonus=True` | runtime |
 
 Phrase length matters — longer matched evidence wins ties. The score is
-clamped to `[0.0, 1.0]`. `rank.py` then enforces the floor and the
+clamped to `[0.0, 1.0]`. `rank.ts` then enforces the floor and the
 heuristics in
 [`adr-command-suggestion.md`](adr-command-suggestion.md#anti-noise-heuristics).
 
@@ -107,7 +107,7 @@ without the rule active.
 
 ## Anti-noise heuristics — when not to fire
 
-`rank.py` returns `[]` when:
+`rank.ts` returns `[]` when:
 
 - Top score is below `confidence_floor` (default `0.6`).
 - Single match within `floor + 0.1` and no structural bonus.
@@ -118,13 +118,14 @@ Structural bonuses (ticket key, file path) override every suppressor.
 
 ## Hardening tests — what we lock down
 
-`tests/test_command_suggester.py` covers 84 cases (matcher, rank,
-cooldown, sanitiser, render, settings, directive). The 9 GT-CS goldens
-(`tests/test_command_suggester_goldens.py`) lock end-to-end shape.
+`tests/scripts/command_suggester.test.ts` covers the matcher, rank,
+cooldown, sanitiser, render, settings, and directive cases. The GT-CS
+goldens (`tests/scripts/command_suggester_goldens.test.ts`) lock
+end-to-end shape.
 Together they enforce:
 
 - **No execution without user pick** — engine has no execute path.
-- **No echo-trigger** — `sanitize.py` strips the previous block's shape.
+- **No echo-trigger** — `sanitize.ts` strips the previous block's shape.
 - **No code-block triggers** — `/commit` inside ``` ``` ``` ``` stays inert.
 - **No conversation hijack** — `enabled: false` and senior gates → silent.
 - **No multi-question stack** — only a numbered-options block, no extra ask.

package/dist/agent-src/contexts/execution/evidence-discipline.md

@@ -30,7 +30,7 @@ Three buckets:
 - **Gaps** — missing evidence the decision needs (negative facts in the making).
 
 Feeds the plan. Not a forensic log, not hard enforcement. Produce cheaply via
-`evidence_report.py` so it never gets skipped.
+`evidence_report.ts` so it never gets skipped.
 
 ## Provenance and freshness
 
@@ -43,7 +43,7 @@ Feeds the plan. Not a forensic log, not hard enforcement. Produce cheaply via
   (`.git/MERGE_HEAD`, `.git/CHERRY_PICK_HEAD`, or `.git/rebase-merge`/`rebase-apply`
   present), do **not** read an intermediate tree — stop and surface it (R4 P6,
   hole-3). *(`.git/REBASE_HEAD` excluded — lingers as stale ref after completed
-  rebase, not a live-op marker.)* `evidence_report.py git-state` is the
+  rebase, not a live-op marker.)* `evidence_report.ts git-state` is the
   deterministic check.
 - **Across sessions:** always re-read. No file hashing, no content-hash theater.