🔬 Activation Telemetry — Root Cause & Fix playground

Interactive walk-through of the two bugs fixed in fix/rewire-activation-telemetry. Click the tabs.

🟡 P1 · dead telemetry

🔴 P0 · build-breaker

Symptom

agent-usage.jsonl     frozen 2026-04-08
subagent-quality.jsonl frozen 2026-04-08
(same millisecond ⇒ ONE writer died)
4 sub-agents this session → 0 logged

Cause

v7.30.0 / #1206 consolidated SubagentStop
hooks into sync-subagent-stop-dispatcher
but DROPPED subagent-stop/unified-dispatcher
(the analytics writer).
• not in hooks.json  • not called anywhere
• only a stale comment claimed it ran

Fix & proof

+ registered async SubagentStop hook
VERIFIED: invoking the handler wrote
{"agent":"ork:test-generator",
 "model":"claude-opus-4-8","success":true}

Symptom

node_modules tracked in git (mode 120000)
→ /Users/.../orchestkit/node_modules
self-referential symlink → breaks every
fresh worktree + build on main

Cause

#2645 `git add -A` in a worktree staged the
node_modules SYMLINK.
.gitignore had node_modules/ (trailing slash
= matches DIRS, not a symlink FILE) → slipped
through → shipped in 8.60.0

Fix

git rm --cached node_modules
.gitignore: node_modules (no slash)
            **/node_modules