ctxtop 0.0.0-stage → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/.antigravity-plugin/plugin.json +36 -0
  2. package/.claude-plugin/plugin.json +18 -0
  3. package/CHECKSUMS.sha256 +149 -0
  4. package/LICENSE +27 -0
  5. package/README.md +330 -3
  6. package/SECURITY.md +22 -0
  7. package/agents/ah-flash-scout.md +25 -0
  8. package/assets/advanced_view_loaded_420px.png +0 -0
  9. package/assets/hero-demo.svg +188 -0
  10. package/assets/logo.svg +19 -0
  11. package/assets/simple_view_lean_420px.png +0 -0
  12. package/assets/simple_view_loaded_420px.png +0 -0
  13. package/assets/social-preview.svg +72 -0
  14. package/assets/zone_c_step3_shield_full.png +0 -0
  15. package/bin/ah-statusline.mjs +145 -0
  16. package/bin/cli.mjs +3 -0
  17. package/bin/ctxtop.mjs +1474 -0
  18. package/commands/cost-radar.md +11 -0
  19. package/commands/evolve.md +10 -0
  20. package/commands/handoff.md +10 -0
  21. package/commands/horizon.md +10 -0
  22. package/commands/inspect.md +10 -0
  23. package/commands/precheck.md +10 -0
  24. package/config/default_flightcheck.json +114 -0
  25. package/config/modelCatalog.json +620 -0
  26. package/config/platformQuirks.json +19 -0
  27. package/hooks/handlers/compact-lifecycle.mjs +262 -0
  28. package/hooks/handlers/hookIo.mjs +255 -0
  29. package/hooks/handlers/hookIpcClient.mjs +83 -0
  30. package/hooks/handlers/post-tool-use.mjs +265 -0
  31. package/hooks/handlers/pre-model-switch.mjs +249 -0
  32. package/hooks/handlers/pre-tool-use.mjs +365 -0
  33. package/hooks/handlers/stop-gate.mjs +240 -0
  34. package/hooks/handlers/user-prompt-submit.mjs +143 -0
  35. package/hooks/hooks.json +81 -0
  36. package/hooks/post_invocation.mjs +13 -0
  37. package/hooks/post_tool_use.mjs +17 -0
  38. package/hooks/pre_invocation.mjs +14 -0
  39. package/hooks/pre_tool_use.mjs +97 -0
  40. package/hooks/register.js +687 -0
  41. package/hooks/session_start.mjs +14 -0
  42. package/hooks/stop.mjs +13 -0
  43. package/hooks.json +56 -0
  44. package/package.json +103 -4
  45. package/packages/antigravity/package.json +14 -0
  46. package/packages/antigravity/src/index.mjs +1 -0
  47. package/packages/claude-code/package.json +14 -0
  48. package/packages/claude-code/src/index.mjs +2 -0
  49. package/packages/core/package.json +14 -0
  50. package/packages/core/src/index.mjs +1 -0
  51. package/packages/engine-node/package.json +14 -0
  52. package/packages/engine-node/src/index.mjs +1 -0
  53. package/packages/mcp/package.json +17 -0
  54. package/packages/mcp/src/server.mjs +396 -0
  55. package/packages/pro/LICENSE-COMMERCIAL.md +19 -0
  56. package/packages/pro/README-SIGNING.md +30 -0
  57. package/packages/pro/package.json +16 -0
  58. package/packages/pro/src/index.mjs +3 -0
  59. package/packages/pro/src/team_finops_pack.mjs +241 -0
  60. package/packages/pro/workers/polar_webhook_worker.mjs +215 -0
  61. package/plugin.json +36 -0
  62. package/rules/AGENTS.md +10 -0
  63. package/sidecars/horizon-daemon/ipcServer.mjs +24 -0
  64. package/sidecars/horizon-daemon/server.mjs +2002 -0
  65. package/sidecars/horizon-daemon/sidecar.json +19 -0
  66. package/skills/cost-radar/SKILL.md +21 -0
  67. package/skills/evolve/SKILL.md +21 -0
  68. package/skills/handoff/SKILL.md +42 -0
  69. package/skills/horizon/SKILL.md +17 -0
  70. package/skills/inspect/SKILL.md +18 -0
  71. package/skills/precheck/SKILL.md +44 -0
  72. package/src/adapters/antigravity/index.mjs +79 -0
  73. package/src/adapters/claude-code/index.mjs +155 -0
  74. package/src/cli/cost_radar.mjs +70 -0
  75. package/src/cli/doctor.mjs +351 -0
  76. package/src/cli/horizon_hud.mjs +686 -0
  77. package/src/cli/init.mjs +425 -0
  78. package/src/cli/postmortem.mjs +515 -0
  79. package/src/coach/cacheGravityRouter.mjs +12 -0
  80. package/src/config/modelCatalog.json +620 -0
  81. package/src/config/platformQuirks.json +19 -0
  82. package/src/core/action_queue.mjs +264 -0
  83. package/src/core/ag_bridge.mjs +346 -0
  84. package/src/core/atomic_io.mjs +124 -0
  85. package/src/core/baseline.mjs +607 -0
  86. package/src/core/blindspot_sensors.mjs +399 -0
  87. package/src/core/classifier.mjs +1757 -0
  88. package/src/core/coach/circuit_breakers.mjs +650 -0
  89. package/src/core/coach/contradiction_auditor.mjs +239 -0
  90. package/src/core/coach/effort_advisor.mjs +143 -0
  91. package/src/core/coach/handoff_hydrator.mjs +483 -0
  92. package/src/core/coach/progressive_checkpointer.mjs +551 -0
  93. package/src/core/coach/prompt_decomposer_coach.mjs +141 -0
  94. package/src/core/coach/reflector_queue.mjs +505 -0
  95. package/src/core/coach/saved_quota_ledger.mjs +615 -0
  96. package/src/core/coach/subagent_ipi_sanitizer.mjs +200 -0
  97. package/src/core/coach/subagent_phantom_auditor.mjs +261 -0
  98. package/src/core/coach/task_quota_router.mjs +955 -0
  99. package/src/core/coach/turn_zero_gate.mjs +574 -0
  100. package/src/core/compaction_coach.mjs +1126 -0
  101. package/src/core/config.mjs +214 -0
  102. package/src/core/constants.mjs +1800 -0
  103. package/src/core/detectors_det01_to_16.mjs +1474 -0
  104. package/src/core/episodic_memory.mjs +135 -0
  105. package/src/core/fts5_output_compressor.mjs +359 -0
  106. package/src/core/git_ledger.mjs +189 -0
  107. package/src/core/handoff_audit.mjs +558 -0
  108. package/src/core/history.mjs +221 -0
  109. package/src/core/hook_diagnostics.mjs +158 -0
  110. package/src/core/horizon_classifier.mjs +326 -0
  111. package/src/core/horizon_config.mjs +802 -0
  112. package/src/core/host_watchdog.mjs +200 -0
  113. package/src/core/layer5_hygiene.mjs +966 -0
  114. package/src/core/log_resolver.mjs +231 -0
  115. package/src/core/mcp_auditor.mjs +138 -0
  116. package/src/core/micro_skills_store.mjs +91 -0
  117. package/src/core/offenders.mjs +161 -0
  118. package/src/core/parser.mjs +1996 -0
  119. package/src/core/path_canonicalizer.mjs +73 -0
  120. package/src/core/paths.mjs +310 -0
  121. package/src/core/prefix_cache_shield.mjs +386 -0
  122. package/src/core/pro_license.mjs +385 -0
  123. package/src/core/prompt_rubric.mjs +518 -0
  124. package/src/core/pruner.mjs +433 -0
  125. package/src/core/quota.mjs +1860 -0
  126. package/src/core/rsi_instinct_engine.mjs +1197 -0
  127. package/src/core/sanitizer.mjs +121 -0
  128. package/src/core/session_forensics.mjs +303 -0
  129. package/src/core/session_timeline.mjs +358 -0
  130. package/src/core/settings.mjs +99 -0
  131. package/src/core/shared/detectors.mjs +1342 -0
  132. package/src/core/shared/fnv1a64.mjs +85 -0
  133. package/src/core/shared/handoff_schema.mjs +123 -0
  134. package/src/core/shared/index.mjs +5 -0
  135. package/src/core/shared/ipi_sanitizer.mjs +165 -0
  136. package/src/core/shared/micro_skills.mjs +1 -0
  137. package/src/core/shared/plugin_validator.mjs +202 -0
  138. package/src/core/shared/prompt_hygiene_governor.mjs +1 -0
  139. package/src/core/sidecar_store.mjs +302 -0
  140. package/src/core/sprint_metrics.mjs +366 -0
  141. package/src/core/sqlite_client.mjs +283 -0
  142. package/src/core/storage_doctor.mjs +358 -0
  143. package/src/core/subagents.mjs +609 -0
  144. package/src/core/swarm_topology.mjs +360 -0
  145. package/src/core/task_quota_router.mjs +1656 -0
  146. package/src/core/telemetry/cache_ttl_watchdog.mjs +284 -0
  147. package/src/core/telemetry/scope_lock_registry.mjs +578 -0
  148. package/src/core/telemetry/shadow_file_detector.mjs +291 -0
  149. package/src/core/telemetry/trajectory_watcher.mjs +259 -0
  150. package/src/core/timeline_svg.mjs +236 -0
  151. package/src/core/tool_surgeon.mjs +305 -0
  152. package/src/core/trajectory_stitcher.mjs +645 -0
  153. package/src/core/u_shaped_optimizer.mjs +789 -0
  154. package/src/core/wal_hygiene.mjs +233 -0
  155. package/src/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  156. package/src/core-isomorphic/catalog/index.mjs +1 -0
  157. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +720 -0
  158. package/src/core-isomorphic/coach/microSkills.mjs +1 -0
  159. package/src/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  160. package/src/core-isomorphic/coach/repoCalibration.mjs +254 -0
  161. package/src/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  162. package/src/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  163. package/src/core-isomorphic/coach/ttlWatchdog.mjs +457 -0
  164. package/src/core-isomorphic/config/anthropicModelCatalog.json +203 -0
  165. package/src/core-isomorphic/config/catalogLoader.mjs +768 -0
  166. package/src/core-isomorphic/config/horizonConfig.mjs +1009 -0
  167. package/src/core-isomorphic/control/callTree.mjs +338 -0
  168. package/src/core-isomorphic/control/coachLatches.mjs +126 -0
  169. package/src/core-isomorphic/control/controlStateMachine.mjs +205 -0
  170. package/src/core-isomorphic/control/index.mjs +49 -0
  171. package/src/core-isomorphic/control/swarmWorktree.mjs +109 -0
  172. package/src/core-isomorphic/control/toolSuspension.mjs +197 -0
  173. package/src/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  174. package/src/core-isomorphic/diagnostics/index.mjs +9 -0
  175. package/src/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  176. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +622 -0
  177. package/src/core-isomorphic/economics/billingBlocks.mjs +251 -0
  178. package/src/core-isomorphic/economics/cacheGravity.mjs +351 -0
  179. package/src/core-isomorphic/economics/cliffBreaker.mjs +170 -0
  180. package/src/core-isomorphic/economics/driftLatency.mjs +319 -0
  181. package/src/core-isomorphic/economics/dualTtl.mjs +198 -0
  182. package/src/core-isomorphic/economics/index.mjs +47 -0
  183. package/src/core-isomorphic/economics/retentionRadar.mjs +348 -0
  184. package/src/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  185. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +1035 -0
  186. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +480 -0
  187. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +603 -0
  188. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +301 -0
  189. package/src/core-isomorphic/index.js +26 -0
  190. package/src/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  191. package/src/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  192. package/src/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  193. package/src/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  194. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +1132 -0
  195. package/src/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  196. package/src/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  197. package/src/core-isomorphic/ui/horizonGrid.mjs +475 -0
  198. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +1181 -0
  199. package/src/core-isomorphic/ui/modViews.mjs +1478 -0
  200. package/src/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  201. package/src/core-isomorphic/ustf/index.mjs +7 -0
  202. package/src/core-isomorphic/ustf/normalizer.mjs +512 -0
  203. package/src/core-isomorphic/ustf/schema.mjs +186 -0
  204. package/src/core-isomorphic/utils/runtime.mjs +962 -0
  205. package/src/demo/synthetic_states.mjs +661 -0
  206. package/src/diagnostics/bugReportGenerator.mjs +253 -0
  207. package/src/diagnostics/doctorEngine.mjs +203 -0
  208. package/src/engine-node/db/index.mjs +58 -0
  209. package/src/engine-node/db/jsonl_fallback.mjs +184 -0
  210. package/src/engine-node/db/probe.mjs +110 -0
  211. package/src/engine-node/db/sqlite_wrapper.mjs +122 -0
  212. package/src/engine-node/index.mjs +9 -0
  213. package/src/engine-node/ipc/client.mjs +447 -0
  214. package/src/engine-node/ipc/index.mjs +22 -0
  215. package/src/engine-node/ipc/protocol.mjs +177 -0
  216. package/src/engine-node/ipc/server.mjs +445 -0
  217. package/src/engine-node/offloader/index.mjs +6 -0
  218. package/src/engine-node/offloader/tool_offloader.mjs +241 -0
  219. package/src/engine-node/sensors/blindspots.mjs +369 -0
  220. package/src/engine-node/sensors/git_merge_tree.mjs +223 -0
  221. package/src/engine-node/sensors/index.mjs +7 -0
  222. package/src/hooks/portfolio_runtime.mjs +858 -0
  223. package/src/hooks/post_invocation.mjs +419 -0
  224. package/src/hooks/pre_invocation.mjs +1015 -0
  225. package/src/hooks/session_start.mjs +161 -0
  226. package/src/shims/agy_cli_compressor.mjs +705 -0
  227. package/src/shims/agy_git_guard.mjs +749 -0
  228. package/src/shims/ah_log_query.mjs +39 -0
  229. package/src/ui/costRadarSvg.mjs +6 -0
  230. package/src/ui/horizonGrid.mjs +1 -0
  231. package/src/ui/horizonPanelHtml.mjs +1 -0
  232. package/src/ui/horizon_panel.css +167 -0
  233. package/src/ui/horizon_panel.js +212 -0
  234. package/src/ui/modViews.mjs +1 -0
  235. package/src/utils/nodeIo.mjs +59 -0
  236. package/src/utils/runtime.mjs +1 -0
  237. package/src/webview/advanced_view.html +1808 -0
  238. package/src/webview/horizon_panel.html +11389 -0
  239. package/src/webview/registry.mjs +80 -0
  240. package/src/webview/simple_view.html +1370 -0
@@ -0,0 +1,419 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import {
4
+ readSidecarSync,
5
+ writeSidecarAtomicSync,
6
+ readToolUsageSync,
7
+ writeToolUsageAtomicSync
8
+ } from '../core/sidecar_store.mjs';
9
+ import { getHomeDir, getBrainStores } from '../core/paths.mjs';
10
+ import { parseTranscriptIncremental } from '../core/parser.mjs';
11
+ import { isCompactionCheckpointStep, evaluateSmartFileReReads } from '../core/layer5_hygiene.mjs';
12
+ import { canonicalizePath } from '../core/path_canonicalizer.mjs';
13
+ import { resolveModelCeiling, normalizeModelKey } from '../core/constants.mjs';
14
+ import { SwarmIdleTtlTracker, computeSwarmRosterTtlBadges } from '../core/subagents.mjs';
15
+ import { loadHorizonConfig } from '../core/horizon_config.mjs';
16
+ import { recordHookDiagnostic } from '../core/hook_diagnostics.mjs';
17
+ import { evaluateBetweenTurnEffortAdvisor } from '../core/coach/effort_advisor.mjs';
18
+
19
+ export async function readStdinSafe({ maxTimeoutMs = 1000, settleMs = 50 } = {}) {
20
+ if (process.stdin.isTTY || process.stdin.readableEnded) return {};
21
+ return new Promise((resolve) => {
22
+ let raw = '';
23
+ let settled = false;
24
+ let settleTimer = null;
25
+
26
+ const finish = (val) => {
27
+ if (settled) return;
28
+ settled = true;
29
+ clearTimeout(maxTimer);
30
+ if (settleTimer) clearTimeout(settleTimer);
31
+ try {
32
+ process.stdin.pause();
33
+ } catch (err) {
34
+ recordHookDiagnostic('post_invocation', 'stdin.pause', err, { persist: false });
35
+ }
36
+ resolve(val);
37
+ };
38
+
39
+ const tryParse = () => {
40
+ try {
41
+ return raw ? JSON.parse(raw) : {};
42
+ } catch (err) {
43
+ recordHookDiagnostic('post_invocation', 'stdin.parse', err);
44
+ return {};
45
+ }
46
+ };
47
+
48
+ const maxTimer = setTimeout(() => finish(tryParse()), maxTimeoutMs);
49
+
50
+ process.stdin.setEncoding('utf8');
51
+ process.stdin.on('data', chunk => {
52
+ raw += chunk;
53
+ if (settleTimer) clearTimeout(settleTimer);
54
+ if (raw.trim().endsWith('}')) {
55
+ settleTimer = setTimeout(() => {
56
+ try {
57
+ finish(JSON.parse(raw));
58
+ } catch (err) {
59
+ recordHookDiagnostic('post_invocation', 'stdin.settleParse', err, { persist: false });
60
+ }
61
+ }, settleMs);
62
+ }
63
+ });
64
+ process.stdin.on('end', () => finish(tryParse()));
65
+ process.stdin.on('error', (err) => {
66
+ recordHookDiagnostic('post_invocation', 'stdin.error', err);
67
+ finish({});
68
+ });
69
+ });
70
+ }
71
+
72
+ function resolveExactSessionDir(conversationId, inputData = {}) {
73
+ if (inputData.sessionDir && fs.existsSync(inputData.sessionDir)) {
74
+ return inputData.sessionDir;
75
+ }
76
+ if (!conversationId || conversationId === 'default_session') return null;
77
+ const homeDir = inputData.homeDir || getHomeDir();
78
+ for (const store of getBrainStores(homeDir)) {
79
+ const candidate = path.join(store.path, String(conversationId));
80
+ if (fs.existsSync(candidate)) return candidate;
81
+ }
82
+ return null;
83
+ }
84
+
85
+ function syncTranscriptTelemetryToSidecar(sidecar, sessionDir, inputData = {}) {
86
+ const parsed = parseTranscriptIncremental(sessionDir, inputData.cacheDir || null);
87
+ const rawSteps = Array.isArray(parsed?.steps) ? parsed.steps : [];
88
+ if (rawSteps.length === 0) return;
89
+
90
+ let lastCheckpointIdx = -1;
91
+ for (let i = rawSteps.length - 1; i >= 0; i--) {
92
+ if (rawSteps[i] && isCompactionCheckpointStep(rawSteps[i])) {
93
+ lastCheckpointIdx = i;
94
+ break;
95
+ }
96
+ }
97
+ const activeSteps = lastCheckpointIdx >= 0 ? rawSteps.slice(lastCheckpointIdx) : rawSteps;
98
+ const smartReReads = evaluateSmartFileReReads(activeSteps);
99
+
100
+ let totalTokens = 0;
101
+ let wasteTokens = 0;
102
+ const activeSet = new Set(sidecar.fileState?.activeSetPaths || []);
103
+ const staleSet = new Set(sidecar.fileState?.staleDupPaths || []);
104
+
105
+ for (let idx = 0; idx < activeSteps.length; idx++) {
106
+ const step = activeSteps[idx] || {};
107
+ const estFromLength = Number(step.untruncatedLength) > 0 ? Math.round(Number(step.untruncatedLength) / 4) : 0;
108
+ const stepPromptEnvelope = Number(step.totalPromptTokens || 0) ||
109
+ (Number(step.inputTokens || 0) + Number(step.cacheReadTokens || 0) + Number(step.cacheCreationTokens || 0));
110
+ let tok = stepPromptEnvelope > 0 && Number(step.outputTokens || 0) > 0
111
+ ? Math.max(Number(step.outputTokens || 0), estFromLength)
112
+ : (Number(step.outputTokens || 0) || estFromLength || 0);
113
+ if (step.stepIndex === 0 && stepPromptEnvelope > 0) {
114
+ tok = stepPromptEnvelope;
115
+ }
116
+ totalTokens += tok;
117
+
118
+ const isError = step.status === 'ERROR' || (typeof step.exitCode === 'number' && step.exitCode !== 0);
119
+ if (isError || smartReReads.wasteTargetByStep.has(idx)) {
120
+ wasteTokens += tok;
121
+ }
122
+
123
+ for (const call of (step.toolCalls || [])) {
124
+ const rawArgs = call?.args || call?.arguments || call?.parameters || call?.Arguments || {};
125
+ const a = typeof rawArgs === 'string'
126
+ ? (() => {
127
+ try {
128
+ return JSON.parse(rawArgs);
129
+ } catch (err) {
130
+ recordHookDiagnostic('post_invocation', 'toolCallArgs.parse', err, { persist: false });
131
+ return {};
132
+ }
133
+ })()
134
+ : rawArgs;
135
+ const fp = a.Path || a.path || a.TargetFile || a.AbsolutePath;
136
+ if (fp && typeof fp === 'string') {
137
+ const canon = canonicalizePath(fp);
138
+ if (smartReReads.wasteTargetByStep.has(idx)) {
139
+ staleSet.add(canon);
140
+ } else {
141
+ activeSet.add(canon);
142
+ }
143
+ }
144
+ }
145
+ }
146
+
147
+ const stdinTotal = Number(inputData.context_window?.total_input_tokens || 0);
148
+ const effectiveTotal = Math.max(stdinTotal, totalTokens);
149
+ const activeModel = inputData.modelName || inputData.model?.id || sidecar.sessionMeta?.activeModel || 'gemini-3.8-flash';
150
+ const maxCeiling = resolveModelCeiling(activeModel, inputData.context_window);
151
+ const usedPct = maxCeiling > 0 ? Number(((effectiveTotal / maxCeiling) * 100).toFixed(1)) : 0;
152
+ const purityPct = effectiveTotal > 0
153
+ ? Number(Math.min(100, Math.max(0, (((effectiveTotal - wasteTokens) / effectiveTotal) * 100))).toFixed(1))
154
+ : 100.0;
155
+
156
+ sidecar.telemetry = sidecar.telemetry || {};
157
+ sidecar.telemetry.totalInputTokens = effectiveTotal;
158
+ sidecar.telemetry.usedPercentage = Number(inputData.context_window?.used_percentage || usedPct);
159
+ sidecar.telemetry.exceeds200kTokens = effectiveTotal > 200000;
160
+ sidecar.telemetry.signalPurityPct = purityPct;
161
+ sidecar.telemetry.amputationRisk = effectiveTotal >= 179000;
162
+
163
+ sidecar.fileState = sidecar.fileState || {};
164
+ sidecar.fileState.activeSetPaths = Array.from(activeSet).slice(-32);
165
+ sidecar.fileState.staleDupPaths = Array.from(staleSet).slice(-32);
166
+
167
+ if (parsed.filePath) {
168
+ sidecar.cursor = {
169
+ filePath: parsed.filePath,
170
+ byteOffset: Number(parsed.lastByteOffset || 0),
171
+ tier: Number(parsed.tier || 1)
172
+ };
173
+ }
174
+ }
175
+
176
+ export async function handlePostToolUse(inputData = {}) {
177
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
178
+ const sidecar = readSidecarSync(conversationId);
179
+ sidecar.sessionMeta = sidecar.sessionMeta || {};
180
+ sidecar.swarmRoster = sidecar.swarmRoster || {};
181
+
182
+ // Phase 3.2: Mid-turn model switch buffer — record pending_model_id without mutating active_model_id
183
+ const requestedMidTurnModel = inputData.requestedModel || inputData.newModel || inputData.pending_model_id || null;
184
+ if (requestedMidTurnModel) {
185
+ const normalizedNext = normalizeModelKey(requestedMidTurnModel);
186
+ if (!sidecar.sessionMeta.active_model_id) {
187
+ sidecar.sessionMeta.active_model_id = normalizeModelKey(
188
+ inputData.active_model_id || inputData.modelName || sidecar.sessionMeta.activeModel || 'gemini-3.8-flash'
189
+ );
190
+ }
191
+ if (normalizedNext !== sidecar.sessionMeta.active_model_id) {
192
+ sidecar.sessionMeta.pending_model_id = normalizedNext;
193
+ }
194
+ }
195
+
196
+ const nowMs = inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now();
197
+ const tracker = new SwarmIdleTtlTracker({
198
+ initialRoster: inputData.swarmRoster || sidecar.swarmRoster,
199
+ cacheTtlMs: inputData.cacheTtlMs ?? 300000
200
+ });
201
+
202
+ if (inputData.agent_id || inputData.agentId) {
203
+ const aid = String(inputData.agent_id || inputData.agentId).trim();
204
+ tracker.touchAgentActive(aid, {
205
+ modelId: inputData.modelId || inputData.modelName || sidecar.sessionMeta.active_model_id || 'gemini-4-carbon',
206
+ warmPrefixTokens: Number(inputData.warm_prefix_tokens ?? inputData.warmPrefixTokens ?? 0),
207
+ timestampMs: nowMs
208
+ });
209
+ }
210
+
211
+ sidecar.swarmRoster = tracker.getRosterSnapshot();
212
+ sidecar.swarmTtlBadges = computeSwarmRosterTtlBadges(sidecar.swarmRoster, {
213
+ nowMs,
214
+ cacheTtlMs: inputData.cacheTtlMs ?? 300000
215
+ });
216
+
217
+ const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
218
+ const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
219
+ cwd: workspacePath,
220
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
221
+ });
222
+ const flightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
223
+
224
+ writeSidecarAtomicSync(conversationId, sidecar);
225
+ if (flightMode === 'OFF') {
226
+ return { flightMode };
227
+ }
228
+ return {
229
+ flightMode,
230
+ active_model_id: sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || null,
231
+ pending_model_id: sidecar.sessionMeta.pending_model_id || null,
232
+ swarmTtlBadges: sidecar.swarmTtlBadges
233
+ };
234
+ }
235
+
236
+ export async function handlePostInvocation(inputData = {}) {
237
+ if (inputData.hook_event_name === 'PostToolUse' || inputData.event === 'PostToolUse') {
238
+ return handlePostToolUse(inputData);
239
+ }
240
+
241
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
242
+ const sidecar = readSidecarSync(conversationId);
243
+
244
+ sidecar.sessionMeta = sidecar.sessionMeta || {};
245
+ sidecar.sessionMeta.turnCount = (sidecar.sessionMeta.turnCount || 0) + 1;
246
+
247
+ // Phase 3.2: Promote pending_model_id -> active_model_id strictly on turn completion (PostInvocation or Stop)
248
+ const pendingModel = inputData.pending_model_id || sidecar.sessionMeta.pending_model_id || null;
249
+ if (pendingModel) {
250
+ const promoted = normalizeModelKey(pendingModel);
251
+ sidecar.sessionMeta.active_model_id = promoted;
252
+ sidecar.sessionMeta.activeModel = promoted;
253
+ sidecar.sessionMeta.pending_model_id = null;
254
+ } else if (inputData.modelName || inputData.active_model_id) {
255
+ const current = normalizeModelKey(inputData.active_model_id || inputData.modelName);
256
+ sidecar.sessionMeta.active_model_id = current;
257
+ sidecar.sessionMeta.activeModel = current;
258
+ }
259
+
260
+ // Track subagent use
261
+ const toolsInvoked = Array.isArray(inputData.toolsInvoked)
262
+ ? inputData.toolsInvoked
263
+ : (inputData.tool_calls || []).map(c => c.name || c.tool);
264
+
265
+ const usedSubagent = toolsInvoked.some(t => t === 'invoke_subagent');
266
+ sidecar.sessionMeta.lastTurnUsedSubagent = usedSubagent;
267
+
268
+ // Update tool usage ledger for MCP tools
269
+ const toolLedger = readToolUsageSync();
270
+ toolLedger.servers = toolLedger.servers || {};
271
+ let ledgerChanged = false;
272
+
273
+ for (const t of toolsInvoked) {
274
+ if (typeof t === 'string' && t.startsWith('mcp_')) {
275
+ const parts = t.split('_');
276
+ const server = parts[1];
277
+ if (server) {
278
+ if (!toolLedger.servers[server]) {
279
+ toolLedger.servers[server] = { invocationsLast15Sessions: 1, lastUsedMs: Date.now() };
280
+ } else {
281
+ toolLedger.servers[server].invocationsLast15Sessions = (toolLedger.servers[server].invocationsLast15Sessions || 0) + 1;
282
+ toolLedger.servers[server].lastUsedMs = Date.now();
283
+ }
284
+ ledgerChanged = true;
285
+ }
286
+ }
287
+ }
288
+ if (ledgerChanged) {
289
+ writeToolUsageAtomicSync(toolLedger);
290
+ }
291
+
292
+ // Track consecutive trivial on max
293
+ const effort = inputData.effort || sidecar.sessionMeta.activeEffort || 'high';
294
+ const isMaxEffort = effort === 'max';
295
+ const rawPromptTokens = inputData.promptTokens ?? inputData.tokens ?? null;
296
+ const promptTokens = rawPromptTokens !== null && rawPromptTokens !== undefined
297
+ ? Number(rawPromptTokens)
298
+ : null;
299
+ if (isMaxEffort && promptTokens !== null && Number.isFinite(promptTokens) && promptTokens > 0 && promptTokens < 15) {
300
+ sidecar.sessionMeta.consecutiveTrivialOnMax = (sidecar.sessionMeta.consecutiveTrivialOnMax || 0) + 1;
301
+ } else {
302
+ sidecar.sessionMeta.consecutiveTrivialOnMax = 0;
303
+ }
304
+
305
+ // Track error streak
306
+ const hasError = inputData.exitCode !== undefined && inputData.exitCode !== null && inputData.exitCode !== 0;
307
+ if (hasError || inputData.status === 'ERROR') {
308
+ sidecar.sessionMeta.consecutiveErrorStreak = (sidecar.sessionMeta.consecutiveErrorStreak || 0) + 1;
309
+ } else {
310
+ sidecar.sessionMeta.consecutiveErrorStreak = 0;
311
+ }
312
+
313
+ // Track test runs
314
+ const isTestRun = toolsInvoked.includes('run_command') && /(test|pytest|jest|vitest|cargo test)/i.test(inputData.command || '');
315
+ if (isTestRun && inputData.exitCode === 0) {
316
+ sidecar.sessionMeta.turnsSinceLastPassingTest = 0;
317
+ } else {
318
+ sidecar.sessionMeta.turnsSinceLastPassingTest = (sidecar.sessionMeta.turnsSinceLastPassingTest || 0) + 1;
319
+ }
320
+
321
+ // Incremental transcript sync so sidecar.telemetry.totalInputTokens updates in standalone CLI/hook mode
322
+ try {
323
+ const resolvedSessionDir = resolveExactSessionDir(conversationId, inputData);
324
+ if (resolvedSessionDir) {
325
+ syncTranscriptTelemetryToSidecar(sidecar, resolvedSessionDir, inputData);
326
+ } else if (Number(inputData.context_window?.total_input_tokens || 0) > 0) {
327
+ sidecar.telemetry = sidecar.telemetry || {};
328
+ sidecar.telemetry.totalInputTokens = Number(inputData.context_window.total_input_tokens);
329
+ }
330
+ } catch (err) {
331
+ // Fail-open: never break hook execution if transcript file is temporarily unavailable
332
+ recordHookDiagnostic('post_invocation', 'syncTranscriptTelemetryToSidecar', err, { ignoreCodes: ['ENOENT'] });
333
+ }
334
+
335
+ // Phase 4.2: Transition completing /swarm agent to idle_zero_token and compute TTL cliff badges
336
+ const nowMs = inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now();
337
+ const tracker = new SwarmIdleTtlTracker({
338
+ initialRoster: inputData.swarmRoster || sidecar.swarmRoster || {},
339
+ cacheTtlMs: inputData.cacheTtlMs ?? 300000
340
+ });
341
+ const agentId = inputData.agent_id || inputData.agentId || null;
342
+ if (agentId) {
343
+ tracker.onTurnComplete(agentId, {
344
+ modelId: sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || inputData.modelName || 'gemini-4-carbon',
345
+ warmPrefixTokens: Number(
346
+ inputData.warm_prefix_tokens ??
347
+ inputData.warmPrefixTokens ??
348
+ sidecar.telemetry?.totalInputTokens ??
349
+ 0
350
+ ),
351
+ timestampMs: nowMs,
352
+ parentSwarmLive: inputData.parentSwarmLive !== false
353
+ });
354
+ }
355
+ sidecar.swarmRoster = tracker.getRosterSnapshot();
356
+ sidecar.swarmTtlBadges = computeSwarmRosterTtlBadges(sidecar.swarmRoster, {
357
+ nowMs,
358
+ cacheTtlMs: inputData.cacheTtlMs ?? 300000
359
+ });
360
+
361
+ // Rank 7 (DET-08): Trigger between-turn EffortAdvisor from PostInvocation
362
+ try {
363
+ const cachedTok = Number(
364
+ inputData.cachedTokens ??
365
+ sidecar.telemetry?.cachedTokens ??
366
+ sidecar.telemetry?.cacheReadTokens ??
367
+ sidecar.telemetry?.totalInputTokens ??
368
+ 0
369
+ );
370
+ const recentFailures = Number(
371
+ inputData.recentTestFailures ??
372
+ (typeof inputData.exitCode === 'number' && inputData.exitCode !== 0 ? 1 : 0)
373
+ );
374
+ const det05Osc = Boolean(
375
+ inputData.det05Oscillation ||
376
+ (sidecar.portfolio?.hudAlerts || []).some((a) => a.detectorId === 'DET-05' && /FLIP_FLOP/.test(String(a.message || '')))
377
+ );
378
+ sidecar.effortAdvisor = evaluateBetweenTurnEffortAdvisor(
379
+ {
380
+ sessionId: conversationId,
381
+ turnCount: Number(sidecar.sessionMeta?.turnCount || 0),
382
+ cachedTokens: cachedTok,
383
+ activeModel: sidecar.sessionMeta?.active_model_id || sidecar.sessionMeta?.activeModel || inputData.modelName || 'gemini-4-carbon',
384
+ activeEffort: inputData.effort || sidecar.sessionMeta?.activeEffort || 'high',
385
+ isSimpleTask: inputData.isSimpleTask !== false,
386
+ recentTestFailures: recentFailures,
387
+ det05Oscillation: det05Osc,
388
+ timestampUtc: inputData.eventTimestampUtc || new Date(typeof nowMs === 'number' ? nowMs : Date.now()).toISOString()
389
+ },
390
+ inputData.effortAdvisorDbPath ? { dbPath: inputData.effortAdvisorDbPath } : (inputData.homeDir ? { homeDir: inputData.homeDir } : {})
391
+ );
392
+ } catch (err) {
393
+ recordHookDiagnostic('post_invocation', 'effortAdvisor', err, { persist: false });
394
+ }
395
+
396
+ writeSidecarAtomicSync(conversationId, sidecar);
397
+ return {
398
+ active_model_id: sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || null,
399
+ pending_model_id: sidecar.sessionMeta.pending_model_id || null,
400
+ swarmRoster: sidecar.swarmRoster,
401
+ swarmTtlBadges: sidecar.swarmTtlBadges,
402
+ effortAdvisor: sidecar.effortAdvisor || null
403
+ };
404
+ }
405
+
406
+ // Auto-run if executed directly
407
+ const isMain = process.argv[1] && (process.argv[1].endsWith('post_invocation.mjs') || process.argv[1].endsWith('post_invocation.js'));
408
+ if (isMain) {
409
+ readStdinSafe().then(input => {
410
+ return handlePostInvocation(input);
411
+ }).then(() => {
412
+ console.log('{}');
413
+ process.exit(0);
414
+ }).catch((err) => {
415
+ recordHookDiagnostic('post_invocation', 'main', err);
416
+ console.log('{}');
417
+ process.exit(0);
418
+ });
419
+ }