@ngockhoale/ukit 2.7.0 → 2.7.2

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 All notable changes to UKit are documented here.
 
+## 2.7.2 - 2026-09-20
+
+OpenCode adapter removal — cycle C37 (TASK-001..004).
+
+- Removed the OpenCode adapter lane end to end: adapter registry key +
+  aliases, `templates/adapter-presets/opencode/`, host-capability matrix
+  entry, doc-benchmark `opencode.yaml` fixture + BMK-09, manifest/manifest
+  wiring, `--tools` help listing, and root `opencode.json` dogfood file.
+- Steer-not-break detection: a leftover `opencode.json` is a user file —
+  install/status/doctor now detect it via `src/core/opencodeSteer.js` and
+  print one canonical warning advising manual removal (`rm opencode.json`);
+  the file is never written, merged, pruned, or auto-deleted.
+- Legacy tolerance: stale `agent`/`agents`/`compact.agentContext.targets`
+  values naming `opencode` are normalized away with a warning instead of
+  hard-failing; `--tools=opencode` / `--adapter opencode` warn + ignore /
+  fall back with exit 0; uninstall still removes a tracked `opencode.json`
+  on explicit user request; `opencode.json` stays in gitignore advice.
+- Packaging: `package.json` description/keywords/`files` and `.npmignore`
+  no longer reference the deleted preset; `packageArtifact.test.js` asserts
+  the tarball ships zero `adapter-presets/opencode` entries.
+
+## 2.7.1 - 2026-09-20
+
+omp native-tier steering — cycle C36 (TASK-001..005).
+
+- `templates/.omp/config.yml` modelRoles now pins omp's native cost tiers
+  `smol`/`default`/`slow` (→ `unic-lite`/`unic-code`/`unic-smart`) so omp's
+  built-in tier steering resolves UKit's gateway aliases directly; `vision`
+  stays `unic-vision` (capability lane — unic-code/unic-smart cannot read
+  images on this gateway).
+- Back-compat: `lite`/`code`/`smart` kept as independent alias keys (not
+  references) resolving to the same unic-* values — a maintainer overriding
+  a cost tier must edit the matching alias too.
+- `.omp/agents/*.md` rebound from direct unic-* names to `@smol`/`@default`/
+  `@slow`/`@vision` frontmatter so agents follow the modelRoles map.
+- Migration: `mergeOmpConfig` merges `modelRoles` per key (user-pinned keys
+  preserved, newly added template keys recorded via `addedModelRoleKeys`)
+  instead of clobbering the whole map.
+- `orchestration.modelTiers.*.ompRole` added to the runtime config template
+  + `runtimeConfig.js` so each tier declares which modelRoles key it binds
+  (lite→smol, code→default, smart→slow, vision→vision).
+
 ## 2.7.0 - 2026-09-20
 
 OMP fully autonomous / unattended mode — cycle C35 (TASK-008..014).

package/README.md

@@ -1,6 +1,6 @@
 # UKit
 
-UKit installs a project-local AI workspace (`.claude/`, adapters, docs, and index helpers) so your team can work with Claude Code, OpenAI Codex, OpenCode, and omp (Oh My Pi) from the same repo setup.
+UKit installs a project-local AI workspace (`.claude/`, adapters, docs, and index helpers) so your team can work with Claude Code, OpenAI Codex, and omp (Oh My Pi) from the same repo setup.
 
 ## Install
 
@@ -39,7 +39,6 @@ Fill in the generated docs baseline (`docs/PROJECT.md`, `docs/MEMORY.md`, `docs/
 
 **Adapters**
 - `.codex/settings.json` + `.codex/settings.local.json` — Codex config
-- `opencode.json` — OpenCode project config with UKit-safe guardrails
 - `.omp/AGENTS.md` — thin `@../AGENTS.md` import so omp reads the shared instructions
 - `.omp/RULES.md` — sticky hard rules for omp sessions
 - `.omp/config.yml` — omp model roles, tool approval, and bash patterns
@@ -75,7 +74,6 @@ When long sessions approach the compact threshold, UKit compacts only safe-zone
 |------|-------------|--------|--------|
 | Claude Code | `CLAUDE.md` | `.claude/skills/` (canonical) | `.claude/settings.json` |
 | OpenAI Codex | `AGENTS.md` | `.claude/skills/` (referenced) | `.codex/settings.json`, `.codex/settings.local.json`, `.codex/README.md` |
-| OpenCode | `AGENTS.md` | `.claude/skills/` (native Claude-compatible support) | `opencode.json` |
 | omp (Oh My Pi) | `.omp/AGENTS.md` (imports `AGENTS.md`) | `.claude/skills/` (read via omp's claude provider — no symlink) | `.omp/config.yml`, `.omp/RULES.md`, `.omp/README.md` |
 
 All supported tools share the same SKILL.md ecosystem so the workspace is authored once and reused everywhere.

package/manifests/hostCapabilities.yaml

@@ -27,16 +27,6 @@ hosts:
     owner-file-injection:    { state: observed,  note: 'AGENTS.md rendered for codex; parity asserted only at artifact level' }
     settings-env:            { state: tested,    evidence: tests/integration/installPipeline.test.js }
     context-files:           { state: tested,    evidence: tests/integration/installPipeline.test.js }
-  opencode:
-    skills:                  { state: observed,  note: 'reads .claude/skills via discovery; asserted indirectly by artifact tests' }
-    subagents:               { state: unknown }
-    hooks:                   { state: unknown }
-    session-start-injection: { state: unknown }
-    stop-gate:               { state: unknown }
-    slash-commands:          { state: observed,  note: 'ukit-* helper entrypoints declared in opencode.json' }
-    owner-file-injection:    { state: observed,  note: 'AGENTS.md loaded at session start; no injection test' }
-    settings-env:            { state: tested,    evidence: tests/integration/installPipeline.test.js }
-    context-files:           { state: observed,  note: 'AGENTS.md asserted by install pipeline; no opencode-specific parse test' }
   omp:
     skills:                  { state: observed,  note: 'omp reads .claude/skills via claude discovery provider' }
     subagents:               { state: tested,    evidence: tests/consistency/ompAgentParity.test.js }

package/manifests/instructionRules.yaml

@@ -412,22 +412,6 @@ rules:
       When the same file or symbol fails debugLoopThreshold times in one
       session, route the next attempt one tier higher, capped at smart.
     marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
-  - id: HOST-OC-01
-    title: OpenCode must explicitly read the triggered SKILL.md
-    kind: critical
-    statement: >-
-      OpenCode reads AGENTS.md at session start only and does not auto-load
-      skills; the model must explicitly read the triggered SKILL.md.
-    marker_in: [templates/AGENTS.md, AGENTS.md]
-    anchor: 'read the triggered SKILL.md'
-  - id: HOST-OWN-01
-    title: Codex/OpenCode read the root owner instructions
-    kind: critical
-    statement: >-
-      When running in Codex or OpenCode, read and follow the root
-      PROJECT_IMPORTANT.md before doing project work.
-    marker_in: [templates/AGENTS.md, AGENTS.md]
-    anchor: 'read and follow the root'
   - id: DURA-01
     title: DuraOne skill activates only when installed
     kind: supporting

package/manifests/platform.full.yaml

@@ -124,8 +124,8 @@ items:
       - docs-project
       - docs-memory
     mergeStrategy: overwrite_with_backup
-    # Same set as root-claude-md: AGENTS.md is the same body with a different H1 plus one
-    # OpenCode-only section, so it interpolates the same variables. Kept in sync by
+    # Same set as root-claude-md: AGENTS.md is the same body with a different H1, so it
+    # interpolates the same variables. Kept in sync by
     # tests/consistency/contextDocsParity.test.js.
     variables:
       - project.name
@@ -1805,17 +1805,3 @@ items:
     packs:
       - core
 
-  # --- OpenCode ---
-
-  - id: multi-opencode-config
-    type: config
-    sourceTemplate: adapter-presets/opencode/opencode.template.json
-    targetPath: opencode.json
-    requires: []
-    mergeStrategy: overwrite_with_backup
-    variables:
-      - project.name
-      - runtime.packageManager
-    enabledByDefault: true
-    packs:
-      - core

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "2.7.0",
-  "description": "Install/update an index-first AI workspace for Claude Code, OpenAI Codex, OpenCode, and omp (Oh My Pi).",
+  "version": "2.7.2",
+  "description": "Install/update an index-first AI workspace for Claude Code, OpenAI Codex and omp (Oh My Pi).",
   "license": "MIT",
   "type": "module",
   "keywords": [
@@ -9,7 +9,6 @@
     "claude",
     "codex",
     "claude-code",
-    "opencode",
     "omp",
     "oh-my-pi",
     "skills",
@@ -37,8 +36,7 @@
     "templates/CLAUDE.md",
     "templates/AGENTS.md",
     "templates/.gitignore",
-    "manifests/",
-    "templates/adapter-presets/opencode/opencode.template.json"
+    "manifests/"
   ],
   "publishConfig": {
     "access": "public"

package/scripts/perf/audit-perf.mjs

@@ -3,8 +3,8 @@
  * audit-perf.mjs — TASK-233 (SPEC §2 FR-001) performance audit generator.
  *
  * Measures every SPEC §2 area from four independent sources and writes
- * `docs/AI_REPORT/perf-findings.json` (machine-readable, consumed by TASK-234,
- * TASK-235 and TASK-236) plus `docs/AI_REPORT/perf-measure.md` (raw appendix).
+ * `scripts/perf/perf-findings.json` (machine-readable, consumed by TASK-234,
+ * TASK-235 and TASK-236) plus `perf-measure.md` next to it (raw appendix).
  * Running this again with the same arguments IS the "measure it the same way
  * both times" requirement from SPEC §5 — TASK-236 re-runs it for before/after.
  *
@@ -735,7 +735,7 @@ function renderMeasureDoc(context) {
   lines.push('```bash');
   lines.push('node scripts/perf/audit-perf.mjs \\');
   lines.push(`  --telemetry-dir "${telemetry.dir || path.join(root, '.ukit', 'storage', 'cache', 'hook-latency')}" \\`);
-  lines.push(`  --out "${root}/docs/AI_REPORT/perf-findings.json"`);
+  lines.push(`  --out "${root}/scripts/perf/perf-findings.json"`);
   lines.push('node --test tests/handoff/c33/perfFindings.test.js');
   lines.push('```');
   lines.push('');
@@ -848,7 +848,7 @@ function main() {
   const options = parseArgs(process.argv.slice(2));
   const root = options.root;
   const telemetryDir = options.telemetryDir || path.join(root, '.ukit', 'storage', 'cache', 'hook-latency');
-  const outFile = options.out || path.join(root, 'docs', 'AI_REPORT', 'perf-findings.json');
+  const outFile = options.out || path.join(root, 'scripts', 'perf', 'perf-findings.json');
   const measureFile = path.join(path.dirname(outFile), 'perf-measure.md');
 
   const telemetry = loadTelemetry(telemetryDir);

package/scripts/perf/perf-findings.json

@@ -0,0 +1,420 @@
+{
+  "generatedAt": "2026-09-20T07:42:56.112Z",
+  "schema": "ukit-perf-findings/1",
+  "sources": {
+    "telemetry": {
+      "dir": "/Volumes/KHOA_EXTENAL/WORKING_PROJECT/WORKING/UKit/.ukit/storage/cache/hook-latency",
+      "rows": 34629,
+      "files": 55
+    },
+    "settings": "/Volumes/KHOA_EXTENAL/WORKING_PROJECT/WORKING/UKit/.worktrees/task-233/templates/.claude/settings.json",
+    "hooksDir": "/Volumes/KHOA_EXTENAL/WORKING_PROJECT/WORKING/UKit/.worktrees/task-233/templates/.claude/hooks",
+    "benchmarkIterations": 10,
+    "gitLogWindowDays": 14
+  },
+  "findings": [
+    {
+      "id": "chain-pretooluse-read-grep-glob",
+      "area": "hook chain — PreToolUse Read|Grep|Glob — 1 hook",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=974, p50 57ms, 2 hook rows/call; paths: 465 direct / 509 chain-runner). Hooks: sensitive-data-guard.sh (8s, 55ms)",
+      "p50ms": 57,
+      "p95ms": 76,
+      "totalMs": 53616,
+      "invocations": 974,
+      "rootCause": "3 process spawns per call (1 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-pretooluse-edit-write",
+      "area": "hook chain — PreToolUse Edit|Write — 6 hooks",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=533, p50 316ms, 6 hook rows/call; paths: 458 direct / 75 chain-runner). Hooks: protect-files.sh (8s, 38ms), stale-spec-guard.sh (11s, 36ms), pre-edit-backup.sh (8s, 36ms), skill-router.sh (20s, 90ms), handoff-model-guard.sh (8s, 37ms), context-hardcap-gate.sh (8s, 54ms)",
+      "p50ms": 316,
+      "p95ms": 433,
+      "totalMs": 179919,
+      "invocations": 533,
+      "rootCause": "18 process spawns per call (6 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-pretooluse-bash",
+      "area": "hook chain — PreToolUse Bash — 6 hooks",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=2973, p50 349ms, 6 hook rows/call; paths: 2711 direct / 262 chain-runner). Hooks: auto-allow-bash.sh (15s, 40ms), block-dangerous.sh (8s, 44ms), sensitive-data-guard.sh (8s, 55ms), handoff-model-guard.sh (8s, 37ms), context-hardcap-gate.sh (8s, 54ms), verification-guard.sh (8s, 56ms)",
+      "p50ms": 349,
+      "p95ms": 505,
+      "totalMs": 1070247,
+      "invocations": 2973,
+      "rootCause": "18 process spawns per call (6 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-posttooluse-read-grep-glob",
+      "area": "hook chain — PostToolUse Read|Grep|Glob — 1 hook",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=963, p50 64ms, 2 hook rows/call; paths: 454 direct / 509 chain-runner). Hooks: record-execution.sh (8s, 38ms)",
+      "p50ms": 64,
+      "p95ms": 149,
+      "totalMs": 69147,
+      "invocations": 963,
+      "rootCause": "3 process spawns per call (1 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-posttooluse-edit-write",
+      "area": "hook chain — PostToolUse Edit|Write — 3 hooks",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=523, p50 125ms, 3 hook rows/call; paths: 451 direct / 72 chain-runner). Hooks: post-edit-verify.sh (8s, 36ms), record-execution.sh (8s, 38ms), task-watchdog.sh (8s, 54ms)",
+      "p50ms": 125,
+      "p95ms": 221,
+      "totalMs": 72670,
+      "invocations": 523,
+      "rootCause": "9 process spawns per call (3 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-posttooluse-bash",
+      "area": "hook chain — PostToolUse Bash — 2 hooks",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=2852, p50 90ms, 2 hook rows/call; paths: 2591 direct / 261 chain-runner). Hooks: compress-output.sh (12s, 61ms), record-execution.sh (8s, 38ms)",
+      "p50ms": 90,
+      "p95ms": 145,
+      "totalMs": 279069,
+      "invocations": 2852,
+      "rootCause": "6 process spawns per call (2 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-userpromptsubmit-all",
+      "area": "hook chain — UserPromptSubmit (all tools) — 4 hooks",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=193, p50 319ms, 4 hook rows/call; paths: 157 direct / 36 chain-runner). Hooks: sensitive-data-guard.sh (8s, 55ms), skill-router.sh (20s, 90ms), vision-router.sh (12s, 54ms), context-window-guard.sh (10s, 54ms)",
+      "p50ms": 319,
+      "p95ms": 585,
+      "totalMs": 65511,
+      "invocations": 193,
+      "rootCause": "12 process spawns per call (4 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-stop-all",
+      "area": "hook chain — Stop (all tools) — 1 hook",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=113, p50 81ms, 1 hook rows/call; paths: 113 direct / 0 chain-runner). Hooks: completion-gate.sh (8s, 36ms)",
+      "p50ms": 81,
+      "p95ms": 108,
+      "totalMs": 9542,
+      "invocations": 113,
+      "rootCause": "3 process spawns per call (1 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-precompact-all",
+      "area": "hook chain — PreCompact (all tools) — 1 hook",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=2, p50 49ms, 1 hook rows/call; paths: 0 direct / 2 chain-runner). Hooks: reinject-context.sh (8s, 33ms)",
+      "p50ms": 49,
+      "p95ms": 49,
+      "totalMs": 84,
+      "invocations": 2,
+      "rootCause": "3 process spawns per call (1 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 is under the 50ms hotspot bar; consolidation is still the mechanism that removes the spawns.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-sessionstart-all",
+      "area": "hook chain — SessionStart (all tools) — 4 hooks",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured per-call hook cost for the group's matching tools (n=58, p50 96ms, 2 hook rows/call; paths: 37 direct / 21 chain-runner). Hooks: project-important.sh (8s, 35ms), auto-prune-bash.sh (12s, 1ms), reset-compact-pressure.sh (12s, 2ms), handoff-resume.sh (8s, 54ms)",
+      "p50ms": 96,
+      "p95ms": 191,
+      "totalMs": 7170,
+      "invocations": 58,
+      "rootCause": "12 process spawns per call (4 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Measured p50 exceeds the 50ms hotspot bar, so the spawn multiplier is the dominant term.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "chain-sessionend-all",
+      "area": "hook chain — SessionEnd (all tools) — 1 hook",
+      "evidence": "settings.json",
+      "evidenceDetail": "settings.json group only — no telemetry rows are attributable to this group, so no per-call cost is reported. Hooks: session-episode.sh (8s, 23ms)",
+      "p50ms": null,
+      "p95ms": null,
+      "totalMs": null,
+      "invocations": 0,
+      "rootCause": "3 process spawns per call (1 settings rows × 3: wrapper bash + node runtime + advisory telemetry node child), against a measured floor of bash 3.8ms + node 16.9ms + telemetry finish 19.5ms. Not measured on this tree.",
+      "fixTask": null,
+      "status": "deferred"
+    },
+    {
+      "id": "hook-hook-chain-runner",
+      "area": "single hook — hook-chain-runner",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 not benchmarked (script not resolvable from this root)",
+      "p50ms": 106,
+      "p95ms": 409,
+      "totalMs": 283464,
+      "invocations": 1753,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-skill-router-sh",
+      "area": "single hook — skill-router.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 89.6ms",
+      "p50ms": 55,
+      "p95ms": 130,
+      "totalMs": 50744,
+      "invocations": 770,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-vision-router-sh",
+      "area": "single hook — vision-router.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 54.4ms",
+      "p50ms": 82,
+      "p95ms": 232,
+      "totalMs": 22275,
+      "invocations": 215,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-context-window-guard-sh",
+      "area": "single hook — context-window-guard.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 54.1ms",
+      "p50ms": 55,
+      "p95ms": 90,
+      "totalMs": 12101,
+      "invocations": 215,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-auto-allow-bash-sh",
+      "area": "single hook — auto-allow-bash.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 39.7ms",
+      "p50ms": 64,
+      "p95ms": 96,
+      "totalMs": 196059,
+      "invocations": 2994,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-block-dangerous-sh",
+      "area": "single hook — block-dangerous.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 44.3ms",
+      "p50ms": 89,
+      "p95ms": 190,
+      "totalMs": 392109,
+      "invocations": 4263,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-context-hardcap-gate-sh",
+      "area": "single hook — context-hardcap-gate.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 53.9ms",
+      "p50ms": 67,
+      "p95ms": 93,
+      "totalMs": 241749,
+      "invocations": 3571,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-stale-spec-guard-sh",
+      "area": "single hook — stale-spec-guard.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 36.0ms",
+      "p50ms": 53,
+      "p95ms": 74,
+      "totalMs": 28844,
+      "invocations": 544,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-pre-edit-backup-sh",
+      "area": "single hook — pre-edit-backup.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 36.0ms",
+      "p50ms": 55,
+      "p95ms": 74,
+      "totalMs": 29992,
+      "invocations": 535,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-completion-gate-sh",
+      "area": "single hook — completion-gate.sh",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; standalone re-run p50 35.8ms",
+      "p50ms": 81,
+      "p95ms": 108,
+      "totalMs": 9659,
+      "invocations": 116,
+      "rootCause": "per-invocation cost is dominated by the 3-spawn hook row (wrapper bash 3.8ms + node 16.9ms + telemetry finish 19.5ms), plus this script's own work",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "hook-project-important-tail",
+      "area": "project-important.sh — PROJECT_IMPORTANT.md injection tail",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; bimodal across 249 invocations: p50 43ms vs p95 1551ms vs max 2068ms (paths seen: PreToolUse, SessionStart, (unattributed)) — a cheap path and an expensive path with no cache between them",
+      "p50ms": null,
+      "p95ms": 1551,
+      "totalMs": 115792,
+      "invocations": 249,
+      "rootCause": "the renderer re-reads PROJECT_IMPORTANT.md and re-runs its full work (strict UTF-8 decode, control-character validation, sensitive-value scan, envelope render) on every invocation; there is no mtime/content-keyed cache, so repeat runs pay the whole cost instead of replaying the previous result",
+      "fixTask": "TASK-235",
+      "status": "confirmed"
+    },
+    {
+      "id": "record-execution-multiplicity",
+      "area": "record-execution.sh — PostToolUse receipt writer registered in 3 matcher groups",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; measured fire count per tool call = 12 (distribution {\"1\":4341,\"3\":1,\"4\":1,\"12\":1} over 4344 calls). The \"once per matching matcher group\" repeat hypothesis is REFUTED: settings.json names the hook in 3 groups, but those matchers are mutually exclusive per tool, so it runs exactly once per call. Its real cost is breadth — highest-invocation hook measured (n=4360, p50 39ms, total 186663ms).",
+      "p50ms": 39,
+      "p95ms": 64,
+      "totalMs": 186663,
+      "invocations": 4360,
+      "rootCause": "not a duplication bug: the matchers (Read|Grep|Glob, Edit|Write, Bash) are mutually exclusive, so at most one group fires per tool. The cost is that one full 3-spawn hook row is paid on every tool call of every kind — breadth, not repeats.",
+      "fixTask": null,
+      "status": "not-a-bug"
+    },
+    {
+      "id": "index-router-cold-start",
+      "area": "index/router helpers invoked per prompt (skill-router → resolve-context / route-task / query-index)",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; UserPromptSubmit groups: n=193, p50 319ms, p95 585ms, 4 hook rows/group. Standalone cold starts: skill-router.sh 89.6ms, query-index.mjs 24.1ms, route-task.mjs not benchmarked, resolve-context.mjs not benchmarked",
+      "p50ms": 319,
+      "p95ms": 585,
+      "totalMs": 65511,
+      "invocations": 193,
+      "rootCause": "every router helper pays a fresh node cold start (no warm process is reused), and skill-router.sh additionally imports the index core in-process per invocation; the cost is process boot plus module load, not the routing decision itself",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "c29-c32-hot-path-additions",
+      "area": "recent hot-path additions — 20 files across 16 commits",
+      "evidence": "git-log",
+      "evidenceDetail": "git log --since=14 days ago --diff-filter=A -- templates/.claude/hooks templates/.claude/ukit/runtime templates/.claude/ukit/index: templates/.claude/hooks/session-episode.sh, templates/.claude/hooks/project-important.sh, templates/.claude/hooks/project-important.sh, templates/.claude/ukit/runtime/project-important.mjs, templates/.claude/ukit/runtime/sensitive-value-scanner.mjs, templates/.claude/ukit/runtime/hook-chain-budget.mjs, templates/.claude/ukit/runtime/stop-coordinator.mjs, templates/.claude/ukit/runtime/hook-payload-store.mjs, templates/.claude/ukit/runtime/hook-telemetry.mjs, templates/.claude/ukit/runtime/hook-telemetry.sh, templates/.claude/ukit/runtime/context-capacity.mjs, templates/.claude/ukit/runtime/async-lock.mjs, +8 more",
+      "p50ms": null,
+      "p95ms": null,
+      "totalMs": null,
+      "invocations": 20,
+      "rootCause": "each added hook file becomes another settings.json row on the event it joins, i.e. another 3-spawn hook row per call (SPEC §1.3 consolidation is what removes them); each added runtime module is an extra cold-start import paid per invocation. The regression is additive spawn count, not one slow file.",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "existing-chain-runner-baseline",
+      "area": "hook-chain-runner.mjs — already-consolidated omp path (TASK-234 reuse target)",
+      "evidence": "telemetry",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; a whole chain of 1 scripts runs in ONE node process at p50 106ms / p95 409ms (n=1753), while a Claude settings group of comparable size pays 3 spawns per script. Nested per-script rows: record-execution.sh p50 71ms, sensitive-data-guard.sh p50 60ms, handoff-model-guard.sh p50 41ms, context-hardcap-gate.sh p50 72ms, auto-allow-bash.sh p50 72ms, block-dangerous.sh p50 82ms",
+      "p50ms": 106,
+      "p95ms": 409,
+      "totalMs": 283464,
+      "invocations": 1753,
+      "rootCause": "no defect — this is the measured proof that one-process-per-group execution is achievable with per-script telemetry intact, so TASK-234 should re-point settings.json at this runner rather than build a new one",
+      "fixTask": "TASK-234",
+      "status": "confirmed"
+    },
+    {
+      "id": "process-floor",
+      "area": "process spawn floor (bash + node + advisory telemetry child)",
+      "evidence": "micro-benchmark",
+      "evidenceDetail": "live spawnSync over 10 iterations: bash -c true p50 3.76ms, node -e 0 p50 16.94ms, node hook-telemetry.mjs --finish p50 19.53ms",
+      "p50ms": 40.235959,
+      "p95ms": 45.548333,
+      "totalMs": null,
+      "invocations": 0,
+      "rootCause": "each settings.json hook row is a bash wrapper that boots node, then arms a second node child for advisory telemetry; this floor is paid per row, so it multiplies by the row count of the event",
+      "fixTask": "TASK-234",
+      "status": "not-a-bug"
+    },
+    {
+      "id": "hook-reinject-context-sh-unmeasured",
+      "area": "single hook — reinject-context.sh (registered in settings.json, no telemetry rows)",
+      "evidence": "unavailable",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; no row exists for this script, so no per-invocation number is reported. It still costs 3 spawns on its event and is therefore already counted inside that chain's total.",
+      "p50ms": null,
+      "p95ms": null,
+      "totalMs": null,
+      "invocations": 0,
+      "rootCause": "no measurement exists for reinject-context.sh on this tree — its cost stays unset (evidenced by absence) rather than estimated; the chain it belongs to carries the spawn floor",
+      "fixTask": null,
+      "status": "deferred"
+    },
+    {
+      "id": "hook-auto-prune-bash-sh-unmeasured",
+      "area": "single hook — auto-prune-bash.sh (registered in settings.json, no telemetry rows)",
+      "evidence": "unavailable",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; no row exists for this script, so no per-invocation number is reported. It still costs 3 spawns on its event and is therefore already counted inside that chain's total.",
+      "p50ms": null,
+      "p95ms": null,
+      "totalMs": null,
+      "invocations": 0,
+      "rootCause": "no measurement exists for auto-prune-bash.sh on this tree — its cost stays unset (evidenced by absence) rather than estimated; the chain it belongs to carries the spawn floor",
+      "fixTask": null,
+      "status": "deferred"
+    },
+    {
+      "id": "hook-reset-compact-pressure-sh-unmeasured",
+      "area": "single hook — reset-compact-pressure.sh (registered in settings.json, no telemetry rows)",
+      "evidence": "unavailable",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; no row exists for this script, so no per-invocation number is reported. It still costs 3 spawns on its event and is therefore already counted inside that chain's total.",
+      "p50ms": null,
+      "p95ms": null,
+      "totalMs": null,
+      "invocations": 0,
+      "rootCause": "no measurement exists for reset-compact-pressure.sh on this tree — its cost stays unset (evidenced by absence) rather than estimated; the chain it belongs to carries the spawn floor",
+      "fixTask": null,
+      "status": "deferred"
+    },
+    {
+      "id": "hook-session-episode-sh-unmeasured",
+      "area": "single hook — session-episode.sh (registered in settings.json, no telemetry rows)",
+      "evidence": "unavailable",
+      "evidenceDetail": ".ukit/storage/cache/hook-latency — 34629 rows across 55 session files, span 2026-09-17T10:50:18.670Z → 2026-09-20T07:42:45.514Z; no row exists for this script, so no per-invocation number is reported. It still costs 3 spawns on its event and is therefore already counted inside that chain's total.",
+      "p50ms": null,
+      "p95ms": null,
+      "totalMs": null,
+      "invocations": 0,
+      "rootCause": "no measurement exists for session-episode.sh on this tree — its cost stays unset (evidenced by absence) rather than estimated; the chain it belongs to carries the spawn floor",
+      "fixTask": null,
+      "status": "deferred"
+    }
+  ]
+}