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,858 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import crypto from 'node:crypto';
4
+ import { readSidecarSync, writeSidecarAtomicSync } from '../core/sidecar_store.mjs';
5
+ import { loadHorizonConfig, resolveDetectorOverride } from '../core/horizon_config.mjs';
6
+ import { getHomeDir } from '../core/paths.mjs';
7
+ import { SavedQuotaReceiptLedger, SAVINGS_EVENT_TYPES } from '../core/coach/saved_quota_ledger.mjs';
8
+ import {
9
+ evaluateDet02PreInvocationHold,
10
+ isSensitiveCredentialPath,
11
+ evaluateDet04ConsecutiveFailureBreaker,
12
+ recordToolOutcomeForDet04,
13
+ evaluateDet05PreWriteIntegrity,
14
+ evaluateDet06UnmodifiedReRead,
15
+ evaluateDet06BlindNewModule,
16
+ evaluateDet06bFlashScoutOffloader,
17
+ evaluateDet07IgnorableFileReadGuard,
18
+ evaluateDet16HybridQuotaThrottle,
19
+ evaluateDet20VisionOverageGuard,
20
+ SOURCE_CODE_EXT_RE,
21
+ BLIND_EDIT_EXEMPT_PATH_RE
22
+ } from '../core/shared/detectors.mjs';
23
+ import { archiveAndCompressDet07Output } from '../shims/agy_cli_compressor.mjs';
24
+ import {
25
+ evaluateDet08DestructiveShell,
26
+ evaluateDet09MidSessionRuleMutate,
27
+ evaluateDet18UntrustedWorkspaceSettings,
28
+ evaluateDet19GitHookBypass
29
+ } from '../core/detectors_det01_to_16.mjs';
30
+ import {
31
+ loadMicroSkillsRegistry,
32
+ evaluateMicroSkillIntercept,
33
+ recordWorkspaceShellOutcome
34
+ } from '../core/micro_skills_store.mjs';
35
+ import {
36
+ evaluateScopeBrake,
37
+ evaluateRelayBreaker,
38
+ evaluateTwoStageSightseeingIntercept
39
+ } from '../core/shared/prompt_hygiene_governor.mjs';
40
+
41
+ const SOURCE_FILE_EXT_RE = /\.(mjs|js|ts|tsx|py|go|rs)$/i;
42
+
43
+ function resolveTargetFileFromArgs(toolArgs = {}, workspacePath = process.cwd()) {
44
+ const raw = String(
45
+ toolArgs.TargetFile ??
46
+ toolArgs.Path ??
47
+ toolArgs.path ??
48
+ toolArgs.AbsolutePath ??
49
+ toolArgs.file_path ??
50
+ toolArgs.DirectoryPath ??
51
+ toolArgs.SearchPath ??
52
+ ''
53
+ ).trim();
54
+ if (!raw) return { raw: '', absPath: '', realPath: '' };
55
+ const absPath = path.isAbsolute(raw) ? path.resolve(raw) : path.resolve(workspacePath, raw);
56
+ let realPath = absPath;
57
+ try {
58
+ if (fs.existsSync(absPath)) {
59
+ realPath = fs.realpathSync(absPath);
60
+ } else {
61
+ const parent = path.dirname(absPath);
62
+ if (fs.existsSync(parent)) {
63
+ realPath = path.join(fs.realpathSync(parent), path.basename(absPath));
64
+ }
65
+ }
66
+ } catch {
67
+ realPath = absPath;
68
+ }
69
+ return { raw, absPath, realPath };
70
+ }
71
+
72
+ function sha256FileSafe(absPath) {
73
+ try {
74
+ const buf = fs.readFileSync(absPath);
75
+ const stat = fs.statSync(absPath);
76
+ return {
77
+ exists: true,
78
+ sha256: crypto.createHash('sha256').update(buf).digest('hex'),
79
+ mtimeMs: Number(stat.mtimeMs || 0),
80
+ size: Number(stat.size || buf.length || 0),
81
+ content: buf.toString('utf8')
82
+ };
83
+ } catch {
84
+ return { exists: false, sha256: '', mtimeMs: 0, content: null };
85
+ }
86
+ }
87
+
88
+ function countSiblingSourceFiles(absTargetPath) {
89
+ try {
90
+ const dir = path.dirname(absTargetPath);
91
+ if (!fs.existsSync(dir)) return 0;
92
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
93
+ return entries.filter((e) => e.isFile() && SOURCE_FILE_EXT_RE.test(e.name)).length;
94
+ } catch {
95
+ return 0;
96
+ }
97
+ }
98
+
99
+ function ensurePortfolioState(sidecar) {
100
+ sidecar.portfolio = sidecar.portfolio || {};
101
+ sidecar.portfolio.fnvRings = sidecar.portfolio.fnvRings || {};
102
+ sidecar.portfolio.readLedger = Array.isArray(sidecar.portfolio.readLedger) ? sidecar.portfolio.readLedger : [];
103
+ sidecar.portfolio.discoveryCallsCount = Number(sidecar.portfolio.discoveryCallsCount || 0);
104
+ sidecar.portfolio.consecutiveReadSearchCount = Number(sidecar.portfolio.consecutiveReadSearchCount || 0);
105
+ sidecar.portfolio.failureStreaks = sidecar.portfolio.failureStreaks || {};
106
+ sidecar.portfolio.lastAlertTurnByKey = sidecar.portfolio.lastAlertTurnByKey || {};
107
+ sidecar.portfolio.hudAlerts = Array.isArray(sidecar.portfolio.hudAlerts) ? sidecar.portfolio.hudAlerts : [];
108
+ sidecar.portfolio.lastUserPrompt = String(sidecar.portfolio.lastUserPrompt || '');
109
+ return sidecar.portfolio;
110
+ }
111
+
112
+ function pushHudAlert(portfolio, detectorId, message, turn = 0) {
113
+ if (!message) return;
114
+ portfolio.hudAlerts.push({
115
+ detectorId,
116
+ message: String(message),
117
+ turn: Number(turn || 0),
118
+ createdAt: new Date().toISOString()
119
+ });
120
+ if (portfolio.hudAlerts.length > 25) {
121
+ portfolio.hudAlerts = portfolio.hudAlerts.slice(-25);
122
+ }
123
+ }
124
+
125
+ function loadPlatformQuirksSafe(workspacePath) {
126
+ const candidates = [
127
+ path.join(workspacePath, 'src', 'config', 'platformQuirks.json'),
128
+ path.resolve(path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')), '../config/platformQuirks.json')
129
+ ];
130
+ for (const p of candidates) {
131
+ try {
132
+ if (fs.existsSync(p)) return JSON.parse(fs.readFileSync(p, 'utf8'));
133
+ } catch {}
134
+ }
135
+ return { visionOverageHttp400: { enabled: true } };
136
+ }
137
+
138
+ /**
139
+ * Strict Antigravity `PreInvocation` Evaluator (`hooks/pre_invocation.mjs`)
140
+ *
141
+ * Output contract: `{}` | `{"ephemeralMessage": "..."}` | `{"terminationBehavior": "terminate", "errorMessage": {"userMessage": "..."}}`
142
+ */
143
+ export async function runStrictPreInvocation(inputData = {}) {
144
+ // Rank 11 (DET-02): Fast-exit `{}` in < 1ms when invocationNum > 1
145
+ const invocationNum = Number(
146
+ inputData.invocationNum ?? inputData.invocation_num ?? inputData.stepInTurn ?? 1
147
+ );
148
+ if (invocationNum > 1) {
149
+ return {};
150
+ }
151
+
152
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
153
+ const sidecar = readSidecarSync(conversationId);
154
+ const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
155
+ const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
156
+ cwd: workspacePath,
157
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
158
+ });
159
+ const flightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
160
+ if (flightMode === 'OFF') return {};
161
+
162
+ const prompt = String(inputData.prompt ?? inputData.user_input ?? inputData.message ?? '');
163
+ const portfolio = ensurePortfolioState(sidecar);
164
+ portfolio.lastUserPrompt = prompt;
165
+ // Reset per-turn unedited read/search counter on a new user turn
166
+ portfolio.consecutiveReadSearchCount = 0;
167
+
168
+ // 1. Rank 11 (DET-02): Live Secrets & Raw Mega-Dumps
169
+ const det02 = evaluateDet02PreInvocationHold({
170
+ prompt,
171
+ invocationNum,
172
+ flightMode
173
+ });
174
+ if (det02.triggered) {
175
+ if (det02.hudHint) {
176
+ // Silent HUD hint in COACH (zero stdout chatter)
177
+ pushHudAlert(portfolio, 'DET-02', det02.hudHint, sidecar.sessionMeta?.turnCount || 1);
178
+ writeSidecarAtomicSync(conversationId, sidecar);
179
+ return {};
180
+ }
181
+ writeSidecarAtomicSync(conversationId, sidecar);
182
+ return det02.output;
183
+ }
184
+
185
+ // 1b. DET-15 ('formatter-bypass'): Local Formatter Bypass on Pasted Indentation / Import Sorting
186
+ const fmtOverride = resolveDetectorOverride(horizonConfig, 'formatter-bypass');
187
+ const isFormattingIntent = /\b(fix\s+(?:the\s+)?indentation|sort\s+(?:the\s+)?imports|format\s+this\s+(?:code|file|block)|convert\s+tabs\s+to\s+spaces|run\s+prettier)\b/i.test(prompt);
188
+ const pastedLineCount = (prompt.match(/\r?\n/g) || []).length;
189
+ if (fmtOverride !== 'off' && isFormattingIntent && pastedLineCount >= 40 && !/\b(add|implement|refactor|create|fix\s+bug|logic|test|calculate)\b/i.test(prompt)) {
190
+ const bypassNotice = '[DET-15 Local Formatter Bypass] Prompt requests code formatting / import sorting on a pasted code block. Run `npx prettier --write <file>` or `npx eslint --fix <file>` directly (0 LLM tokens).';
191
+ pushHudAlert(portfolio, 'DET-15', bypassNotice, sidecar.sessionMeta?.turnCount || 1);
192
+ writeSidecarAtomicSync(conversationId, sidecar);
193
+ if (fmtOverride === 'block' || (fmtOverride === 'default' && flightMode === 'AUTO_PILOT')) {
194
+ return { terminationBehavior: 'terminate', decision: 'block', detectorId: 'DET-15', userMessage: bypassNotice };
195
+ }
196
+ return { ephemeralMessage: bypassNotice, systemMessage: bypassNotice };
197
+ }
198
+
199
+ // 1c. DET-02B ('drip-feed'): Rapid <90s Conversational Drip-Feeding in Portfolio PreInvocation
200
+ const dripOverride = resolveDetectorOverride(horizonConfig, 'drip-feed');
201
+ if (dripOverride !== 'off') {
202
+ const tsMs = Number(inputData.timestampMs ?? inputData.nowMs ?? inputData.timestamp ?? Date.now());
203
+ const wCount = prompt.trim().split(/\s+/).filter(Boolean).length;
204
+ const inlineFileMatch = prompt.match(/(?:^|\s)@?([A-Za-z0-9_./\\-]+\.(?:ts|tsx|js|mjs|cjs|jsx|py|rs|go|rb|java|cs|css|scss|html|json|md))\b/);
205
+ const scopeHint = String(
206
+ inputData.targetScope ||
207
+ (inlineFileMatch ? inlineFileMatch[1] : '') ||
208
+ sidecar.fileState?.activeSetPaths?.[0] ||
209
+ sidecar.fileState?.modifiedFiles?.[0] ||
210
+ ''
211
+ );
212
+ portfolio.recentPromptEvents = (Array.isArray(portfolio.recentPromptEvents) ? portfolio.recentPromptEvents : [])
213
+ .filter((e) => tsMs - Number(e.ts || 0) <= 90000);
214
+ portfolio.recentPromptEvents.push({ ts: tsMs, wordCount: wCount, targetScope: scopeHint });
215
+ const rapidMicroCount = portfolio.recentPromptEvents.filter(
216
+ (e) => e.wordCount > 0 && e.wordCount <= 18 && Boolean(scopeHint) && e.targetScope === scopeHint
217
+ ).length;
218
+ if (rapidMicroCount >= 4) {
219
+ const dripNotice = `[DET-02B Conversational Drip-Feed Advisory] Detected ${rapidMicroCount} rapid micro-prompts in <90s. Batch requirements into a single numbered checklist prompt.`;
220
+ pushHudAlert(portfolio, 'DET-02B', dripNotice, sidecar.sessionMeta?.turnCount || 1);
221
+ writeSidecarAtomicSync(conversationId, sidecar);
222
+ if (dripOverride === 'block' || (dripOverride === 'default' && flightMode === 'AUTO_PILOT')) {
223
+ return { terminationBehavior: 'terminate', decision: 'block', detectorId: 'DET-02B', userMessage: dripNotice };
224
+ }
225
+ return { ephemeralMessage: dripNotice, systemMessage: dripNotice };
226
+ }
227
+ }
228
+
229
+ // 2. Rank 12 (DET-20 / 'vision-screenshot-coach'): Vision Overage HTTP 400 & Vision Screenshot Abuse Guard
230
+ const visionOverride = resolveDetectorOverride(horizonConfig, 'vision-screenshot-coach');
231
+ const quirks = inputData.platformQuirks || loadPlatformQuirksSafe(workspacePath);
232
+ const hasImageAttachment = Boolean(
233
+ inputData.hasImageAttachment ||
234
+ (Array.isArray(inputData.media) && inputData.media.some((m) => String(m?.mime_type || m?.mimeType || '').startsWith('image/'))) ||
235
+ (Array.isArray(inputData.attachments) && inputData.attachments.some((a) => /image|\.(png|jpg|jpeg|webp|gif)$/i.test(String(a?.mimeType || a?.type || a?.name || '')))) ||
236
+ (Array.isArray(inputData.messages) && inputData.messages.some((m) => Array.isArray(m?.content) && m.content.some((b) => b?.type === 'image' || b?.source?.type === 'base64')))
237
+ );
238
+ const aiCreditOveragesActive = Boolean(
239
+ inputData.aiCreditOveragesActive ??
240
+ sidecar.telemetry?.quota?.aiCreditOveragesActive ??
241
+ (Number(inputData.baseQuotaUsedPct ?? sidecar.telemetry?.quota?.usedPct ?? 0) >= 100 && inputData.overageEnabled !== false)
242
+ );
243
+ portfolio.consecutiveImageTurns = hasImageAttachment ? Number(portfolio.consecutiveImageTurns || 0) + 1 : 0;
244
+ const screenshotMatch = prompt.match(/(\d+)\s+screenshots?/i);
245
+ const imageCount = Number(
246
+ inputData.imageCount ??
247
+ (screenshotMatch ? Number(screenshotMatch[1]) : (hasImageAttachment ? 1 : 0))
248
+ );
249
+ const det20 = evaluateDet20VisionOverageGuard({
250
+ quirkConfig: quirks.visionOverageHttp400 || { enabled: true },
251
+ aiCreditOveragesActive,
252
+ hasImageAttachment,
253
+ consecutiveImageTurns: portfolio.consecutiveImageTurns,
254
+ promptText: prompt,
255
+ imageCount,
256
+ messages: inputData.messages || [],
257
+ contentBlocks: inputData.contentBlocks || []
258
+ });
259
+ if (det20.triggered && (det20.subType === 'VISION_OVERAGE_HTTP400' || visionOverride !== 'off')) {
260
+ pushHudAlert(portfolio, 'DET-20', det20.warningMessage, sidecar.sessionMeta?.turnCount || 1);
261
+ writeSidecarAtomicSync(conversationId, sidecar);
262
+ if (visionOverride === 'block' && det20.subType === 'VISION_SCREENSHOT_ABUSE') {
263
+ return { terminationBehavior: 'terminate', decision: 'block', detectorId: 'DET-20', userMessage: det20.warningMessage };
264
+ }
265
+ return flightMode === 'SILENT' ? {} : { ephemeralMessage: det20.ephemeralMessage, systemMessage: det20.ephemeralMessage, cumulativeVisionTaxTokens: det20.cumulativeVisionTaxTokens };
266
+ }
267
+
268
+ // 3. Prompt Hygiene Governor (v4.1 Phase 1): Relay Breaker ('relay-breaker') & Scope Brake ('vague-prompt-rubric')
269
+ const relayOverride = resolveDetectorOverride(horizonConfig, 'relay-breaker');
270
+ const relayEval = evaluateRelayBreaker({
271
+ prompt,
272
+ relayState: inputData.relayState ?? portfolio.relayState,
273
+ sourceCodeEditsInSession: Number(
274
+ inputData.sourceCodeEditsInSession ??
275
+ (sidecar.fileState?.modifiedFiles || []).filter((p) => !/\.md$/i.test(String(p || ''))).length
276
+ ),
277
+ sourceCodeEditedSinceLastRelay: Boolean(inputData.sourceCodeEditedSinceLastRelay),
278
+ priorTurnWebSearches: Number(inputData.priorTurnWebSearches ?? portfolio.priorTurnWebSearches ?? 0),
279
+ zeroEditSessionTokens: Number(
280
+ inputData.zeroEditSessionTokens ??
281
+ (((sidecar.fileState?.modifiedFiles || []).length === 0) ? (sidecar.telemetry?.totalInputTokens || 0) : 0)
282
+ ),
283
+ boundSpecPath: inputData.boundSpecPath ?? portfolio.relayState?.boundSpecPath ?? null,
284
+ overrideMode: relayOverride,
285
+ flightMode,
286
+ detectorId: 'DET-26'
287
+ });
288
+ portfolio.relayState = relayEval.relayStateSnapshot;
289
+ if (relayEval.triggered) {
290
+ pushHudAlert(portfolio, 'DET-26', relayEval.tailInjection, sidecar.sessionMeta?.turnCount || 1);
291
+ if (relayEval.decision === 'block') {
292
+ portfolio.blockedPrompts = Number(portfolio.blockedPrompts || 0) + 1;
293
+ writeSidecarAtomicSync(conversationId, sidecar);
294
+ return {
295
+ terminationBehavior: 'terminate',
296
+ decision: 'block',
297
+ detectorId: 'DET-26',
298
+ subType: relayEval.subType,
299
+ relayState: relayEval.nextState,
300
+ userMessage: relayEval.tailInjection
301
+ };
302
+ }
303
+ portfolio.steeredPrompts = Number(portfolio.steeredPrompts || 0) + 1;
304
+ writeSidecarAtomicSync(conversationId, sidecar);
305
+ return flightMode === 'SILENT'
306
+ ? {}
307
+ : {
308
+ ephemeralMessage: relayEval.tailInjection,
309
+ systemMessage: relayEval.tailInjection,
310
+ detectorId: 'DET-26',
311
+ subType: relayEval.subType,
312
+ relayState: relayEval.nextState
313
+ };
314
+ }
315
+
316
+ const scopeOverride = resolveDetectorOverride(horizonConfig, 'vague-prompt-rubric');
317
+ const scopeEval = evaluateScopeBrake({
318
+ prompt,
319
+ provenance: inputData.provenance || inputData.source || 'user',
320
+ isAutonomousTurn: Boolean(inputData.isAutonomousTurn || inputData.autonomous),
321
+ isSubagent: Boolean(inputData.isSubagent || sidecar.sessionMeta?.isSubagent),
322
+ isScheduledTask: Boolean(inputData.isScheduledTask),
323
+ isLoopIteration: Boolean(inputData.isLoopIteration),
324
+ priorTurnEditedFilesCount: Number(inputData.priorTurnEditedFilesCount ?? 0),
325
+ priorTurnSingleFileTarget: inputData.priorTurnSingleFileTarget ?? null,
326
+ priorTurnHadToolOrTestFailure: Boolean(inputData.priorTurnHadToolOrTestFailure),
327
+ priorTurnAssistantAskedQuestion: Boolean(inputData.priorTurnAssistantAskedQuestion),
328
+ activeSetPaths: sidecar.fileState?.activeSetPaths || [],
329
+ modifiedFiles: sidecar.fileState?.modifiedFiles || [],
330
+ recentlyViewedFiles: (portfolio.readLedger || []).map((e) => e.absPath).filter(Boolean),
331
+ overrideMode: scopeOverride,
332
+ flightMode,
333
+ detectorId: 'DET-26'
334
+ });
335
+ if (scopeEval.triggered) {
336
+ portfolio.unanchoredTurnFlag = true;
337
+ portfolio.candidateFiles = scopeEval.candidateFiles;
338
+ pushHudAlert(portfolio, 'DET-26', scopeEval.steerContext, sidecar.sessionMeta?.turnCount || 1);
339
+ if (scopeEval.decision === 'block') {
340
+ portfolio.blockedPrompts = Number(portfolio.blockedPrompts || 0) + 1;
341
+ writeSidecarAtomicSync(conversationId, sidecar);
342
+ return {
343
+ terminationBehavior: 'terminate',
344
+ decision: 'block',
345
+ detectorId: 'DET-26',
346
+ subType: scopeEval.subType,
347
+ userMessage: scopeEval.blockReason
348
+ };
349
+ }
350
+ portfolio.steeredPrompts = Number(portfolio.steeredPrompts || 0) + 1;
351
+ writeSidecarAtomicSync(conversationId, sidecar);
352
+ return flightMode === 'SILENT'
353
+ ? {}
354
+ : {
355
+ ephemeralMessage: scopeEval.steerContext,
356
+ systemMessage: scopeEval.steerContext,
357
+ detectorId: 'DET-26',
358
+ subType: scopeEval.subType,
359
+ candidateFiles: scopeEval.candidateFiles
360
+ };
361
+ }
362
+ portfolio.unanchoredTurnFlag = false;
363
+
364
+ writeSidecarAtomicSync(conversationId, sidecar);
365
+ return {};
366
+ }
367
+
368
+ /**
369
+ * Strict Antigravity `PreToolUse` Evaluator (`hooks/pre_tool_use.mjs`)
370
+ *
371
+ * Output contract: `{"decision": "allow" | "ask" | "deny", "reason"?: "..."}`
372
+ */
373
+ export async function runStrictPreToolUse(inputData = {}) {
374
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
375
+ const sidecar = readSidecarSync(conversationId);
376
+ const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
377
+ const homeDir = inputData.homeDir || getHomeDir();
378
+ const horizonConfig = inputData.horizonConfig || loadHorizonConfig({ cwd: workspacePath, homeDir });
379
+ const flightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
380
+ const portfolio = ensurePortfolioState(sidecar);
381
+ const currentTurn = Math.max(1, Number(inputData.turn ?? sidecar.sessionMeta?.turnCount ?? 1));
382
+
383
+ const toolName = String(inputData.tool_name || inputData.tool || inputData.toolName || '').trim();
384
+ const toolArgs = inputData.tool_input || inputData.args || inputData.parameters || inputData.Arguments || {};
385
+ const userPrompt = String(inputData.userPrompt ?? inputData.prompt ?? portfolio.lastUserPrompt ?? '');
386
+ const { raw: rawTarget, absPath, realPath } = resolveTargetFileFromArgs(toolArgs, workspacePath);
387
+
388
+ const syntheticStep = [{ toolCalls: [{ name: toolName, args: toolArgs }] }];
389
+
390
+ // Ring-0 Security Gates (active in all modes unless explicitly disabled)
391
+ // 1. Symlink-resolved .env* / *.pem / ~/.ssh/* denial (Rank 11 / DET-02)
392
+ if (rawTarget && /^(view_file|read_file|write_to_file|write_file|replace_file_content|multi_replace_file_content|edit_file|grep_search)$/i.test(toolName)) {
393
+ const cleanHomeSsh = path.join(homeDir, '.ssh').replace(/\\/g, '/').toLowerCase();
394
+ const normReal = realPath.replace(/\\/g, '/');
395
+ const inHomeSsh = normReal.toLowerCase().startsWith(`${cleanHomeSsh}/`) || normReal.toLowerCase() === cleanHomeSsh;
396
+ if (inHomeSsh || isSensitiveCredentialPath(realPath) || isSensitiveCredentialPath(absPath)) {
397
+ return {
398
+ decision: 'deny',
399
+ reason: `[DET-02] Access denied to symlink-resolved credential/key file "${path.basename(realPath)}".`
400
+ };
401
+ }
402
+ }
403
+
404
+ // Also check shell commands reading .env / .pem / .ssh
405
+ if (/^(run_command|execute_bash|bash|powershell|exec)$/i.test(toolName)) {
406
+ const cmdStr = String(toolArgs.CommandLine || toolArgs.command || toolArgs.cmd || '');
407
+ if (/\b(?:cat|type|Get-Content|gc|head|tail|more|less)\s+['"]?(?:~\/\.ssh\/|[^\s'"]*\.pem\b|[^\s'"]*\/?\.env(?:\.(?!example|sample|template)[A-Za-z0-9_.-]+)?\b)/i.test(cmdStr)) {
408
+ return {
409
+ decision: 'deny',
410
+ reason: '[DET-02] Shell credential read denied (.env / .pem / ~/.ssh/*).'
411
+ };
412
+ }
413
+ if (resolveDetectorOverride(horizonConfig, 'DET-19') !== 'off') {
414
+ const det19 = evaluateDet19GitHookBypass(syntheticStep);
415
+ if (det19) return { decision: 'deny', reason: det19.message };
416
+ }
417
+ if (resolveDetectorOverride(horizonConfig, 'DET-08') !== 'off') {
418
+ const det08Shell = evaluateDet08DestructiveShell(syntheticStep);
419
+ if (det08Shell) return { decision: 'deny', reason: det08Shell.message };
420
+ }
421
+ }
422
+
423
+ if (/^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content|run_command)$/i.test(toolName)) {
424
+ if (resolveDetectorOverride(horizonConfig, 'DET-18') !== 'off') {
425
+ const det18 = evaluateDet18UntrustedWorkspaceSettings(syntheticStep, { workspacePath, scanWorkspace: false });
426
+ if (det18) return { decision: 'deny', reason: det18.message };
427
+ }
428
+ }
429
+
430
+ if (flightMode === 'OFF') {
431
+ return { decision: 'allow' };
432
+ }
433
+
434
+ // Two-Stage Prompt Hygiene Sightseeing Interception (Scope Brake & Relay Breaker Web Search)
435
+ const scopeOverride = resolveDetectorOverride(horizonConfig, 'vague-prompt-rubric');
436
+ const relayOverride = resolveDetectorOverride(horizonConfig, 'relay-breaker');
437
+ const twoStage = evaluateTwoStageSightseeingIntercept({
438
+ toolName,
439
+ toolArgs,
440
+ unanchoredTurnFlag: Boolean(inputData.unanchoredTurnFlag ?? portfolio.unanchoredTurnFlag),
441
+ candidateFiles: Array.isArray(inputData.candidateFiles)
442
+ ? inputData.candidateFiles
443
+ : (portfolio.candidateFiles || sidecar.fileState?.modifiedFiles || sidecar.fileState?.activeSetPaths || []),
444
+ relayState: inputData.relayState ?? portfolio.relayState,
445
+ overrideMode: scopeOverride !== 'default' ? scopeOverride : relayOverride,
446
+ flightMode,
447
+ detectorId: 'DET-26'
448
+ });
449
+ if (twoStage.intercepted) {
450
+ if (twoStage.consumeFlag) {
451
+ portfolio.unanchoredTurnFlag = false;
452
+ }
453
+ portfolio.sightseeingToolsPrevented = Number(portfolio.sightseeingToolsPrevented || 0) + 1;
454
+ pushHudAlert(portfolio, 'DET-26', twoStage.reason, currentTurn);
455
+ writeSidecarAtomicSync(conversationId, sidecar);
456
+ return {
457
+ decision: twoStage.decision,
458
+ reason: twoStage.reason,
459
+ detectorId: 'DET-26',
460
+ subType: twoStage.subType
461
+ };
462
+ }
463
+
464
+ // RSI-04 ('micro-skills'): Intercept known-broken repo shell commands before execution
465
+ if (/^(run_command|execute_bash|bash|powershell|exec)$/i.test(toolName)) {
466
+ const msOverride = resolveDetectorOverride(horizonConfig, 'micro-skills');
467
+ if (msOverride !== 'off') {
468
+ const cmdStr = String(toolArgs.CommandLine || toolArgs.command || toolArgs.cmd || '');
469
+ const msRegistry = loadMicroSkillsRegistry(workspacePath);
470
+ const msIntercept = evaluateMicroSkillIntercept(msRegistry, {
471
+ command: cmdStr,
472
+ flightMode,
473
+ overrideMode: msOverride
474
+ });
475
+ if (msIntercept.triggered) {
476
+ pushHudAlert(portfolio, 'RSI-04', msIntercept.hudAlert, currentTurn);
477
+ writeSidecarAtomicSync(conversationId, sidecar);
478
+ if (msIntercept.decision === 'deny') {
479
+ return { decision: 'deny', reason: msIntercept.reason, detectorId: 'RSI-04', workingCmd: msIntercept.workingCmd };
480
+ }
481
+ return { decision: 'allow', reason: msIntercept.reason, detectorId: 'RSI-04', workingCmd: msIntercept.workingCmd };
482
+ }
483
+ }
484
+ }
485
+
486
+ // TurnZeroGate warm-cache rule fence (Core Invariant: zero mid-session mutations to AGENTS.md / GEMINI.md / .agents/rules/*.md)
487
+ if (/^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content)$/i.test(toolName)) {
488
+ const cachedTokens = Number(inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? sidecar.telemetry?.totalInputTokens ?? 0);
489
+ const det09 = evaluateDet09MidSessionRuleMutate(syntheticStep, {
490
+ cachedTokens,
491
+ cacheTtlSeconds: Number(inputData.cacheTtlSeconds ?? sidecar.telemetry?.cacheTtlSeconds ?? 300),
492
+ cacheState: inputData.cacheState
493
+ });
494
+ if (det09) {
495
+ pushHudAlert(portfolio, 'TurnZeroGate', det09.message, currentTurn);
496
+ writeSidecarAtomicSync(conversationId, sidecar);
497
+ if (flightMode === 'AUTO_PILOT' || cachedTokens > 3529) {
498
+ return { decision: 'deny', reason: det09.message };
499
+ }
500
+ }
501
+ }
502
+
503
+ // Rank 5 (DET-04): 3-Strike Consecutive Tool Failure Breaker
504
+ const det04 = evaluateDet04ConsecutiveFailureBreaker({
505
+ toolName,
506
+ toolArgs,
507
+ failureStreaks: portfolio.failureStreaks,
508
+ currentTurn,
509
+ lastAlertTurnByKey: portfolio.lastAlertTurnByKey,
510
+ cooldownTurns: 3,
511
+ flightMode
512
+ });
513
+ if (det04.triggered) {
514
+ portfolio.lastAlertTurnByKey = det04.lastAlertTurnByKey;
515
+ if (det04.hudAlert) pushHudAlert(portfolio, 'DET-04', det04.hudAlert, currentTurn);
516
+ writeSidecarAtomicSync(conversationId, sidecar);
517
+ if (det04.decision === 'deny') {
518
+ try {
519
+ const ledger = new SavedQuotaReceiptLedger({ homeDir });
520
+ ledger.recordSaving({
521
+ sessionId: String(conversationId),
522
+ eventType: SAVINGS_EVENT_TYPES.LOOP_TURN_PREVENTED,
523
+ tokensSaved: Math.max(1500, Math.round(Number(inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? 4000) * 0.15)),
524
+ dedupeKey: `det04:${conversationId}:${currentTurn}:${toolName}`,
525
+ detail: `DET-04 blocked 3-strike retry loop on ${toolName}`
526
+ });
527
+ } catch (err) {
528
+ void err;
529
+ }
530
+ return { decision: 'deny', reason: det04.reason };
531
+ }
532
+ }
533
+
534
+ // Track discovery calls for Rank 2 (DET-06 Blind New-Module Check)
535
+ if (/^(grep_search|find_by_name|list_dir|glob|grep)$/i.test(toolName)) {
536
+ portfolio.discoveryCallsCount += 1;
537
+ }
538
+
539
+ // Rank 6 (DET-06B): Lean Flash Subagent Search Offloader
540
+ const activeModel = String(inputData.activeModel || inputData.modelName || sidecar.sessionMeta?.activeModel || '');
541
+ const cachedTokens = Number(inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? 0);
542
+ const det06b = evaluateDet06bFlashScoutOffloader({
543
+ toolName,
544
+ consecutiveReadSearchCount: portfolio.consecutiveReadSearchCount,
545
+ activeModel,
546
+ cachedTokens,
547
+ isSubagent: Boolean(inputData.isSubagent || sidecar.sessionMeta?.isSubagent),
548
+ flightMode
549
+ });
550
+ portfolio.consecutiveReadSearchCount = det06b.nextCount;
551
+ if (det06b.triggered) {
552
+ pushHudAlert(portfolio, 'DET-06B', det06b.hudAlert, currentTurn);
553
+ writeSidecarAtomicSync(conversationId, sidecar);
554
+ if (det06b.decision === 'deny') {
555
+ return { decision: 'deny', reason: det06b.reason };
556
+ }
557
+ }
558
+
559
+ // Rank 2a (DET-06): Unmodified File Re-Read Check & DET-20 Cross-Subagent Duplicate Read
560
+ if (/^(view_file|read_file)$/i.test(toolName) && absPath) {
561
+ const agentId = inputData.agentId || inputData.subagentId || inputData.agent_id || sidecar.sessionMeta?.agentId || null;
562
+ if (agentId) {
563
+ portfolio.subagentReadScopes = portfolio.subagentReadScopes || {};
564
+ const normTarget = absPath.replace(/\\/g, '/').toLowerCase();
565
+ const readers = Array.isArray(portfolio.subagentReadScopes[normTarget]) ? portfolio.subagentReadScopes[normTarget] : [];
566
+ if (!readers.includes(agentId)) {
567
+ readers.push(agentId);
568
+ portfolio.subagentReadScopes[normTarget] = readers;
569
+ }
570
+ if (readers.length >= 2) {
571
+ const msg = `[DET-20] Cross-subagent duplicate read of "${path.basename(absPath)}" by active agents (${readers.join(', ')}). Coordinate via StateBaton digest to avoid cold context duplication.`;
572
+ pushHudAlert(portfolio, 'DET-20', msg, currentTurn);
573
+ writeSidecarAtomicSync(conversationId, sidecar);
574
+ }
575
+ }
576
+
577
+ // Rank 2a-2 (DET-07): Ignorable Lockfile & Minified Bundle Native Read Guard
578
+ const startLine = toolArgs.StartLine ?? toolArgs.start_line ?? toolArgs.startLine ?? null;
579
+ const endLine = toolArgs.EndLine ?? toolArgs.end_line ?? toolArgs.endLine ?? null;
580
+ const limit = toolArgs.limit ?? toolArgs.Limit ?? null;
581
+ const det07Ignorable = evaluateDet07IgnorableFileReadGuard({
582
+ toolName,
583
+ targetPath: rawTarget || absPath,
584
+ startLine,
585
+ endLine,
586
+ limit,
587
+ flightMode
588
+ });
589
+ if (det07Ignorable.triggered) {
590
+ pushHudAlert(portfolio, 'DET-07', det07Ignorable.hudAlert, currentTurn);
591
+ writeSidecarAtomicSync(conversationId, sidecar);
592
+ if (det07Ignorable.decision === 'deny') {
593
+ return { decision: 'deny', reason: det07Ignorable.reason, detectorId: 'DET-07' };
594
+ }
595
+ }
596
+
597
+ const fileInfo = sha256FileSafe(absPath);
598
+ if (fileInfo.exists) {
599
+ const det06Read = evaluateDet06UnmodifiedReRead({
600
+ absPath,
601
+ sha256: fileInfo.sha256,
602
+ mtimeMs: fileInfo.mtimeMs,
603
+ startLine,
604
+ endLine,
605
+ currentTurn,
606
+ readLedger: portfolio.readLedger,
607
+ flightMode
608
+ });
609
+ portfolio.readLedger = det06Read.updatedLedger;
610
+ if (det06Read.triggered) {
611
+ pushHudAlert(portfolio, 'DET-06', det06Read.hudAlert, currentTurn);
612
+ writeSidecarAtomicSync(conversationId, sidecar);
613
+ if (det06Read.decision === 'deny') {
614
+ try {
615
+ const ledger = new SavedQuotaReceiptLedger({ homeDir });
616
+ ledger.recordSaving({
617
+ sessionId: String(conversationId),
618
+ eventType: SAVINGS_EVENT_TYPES.LOOP_TURN_PREVENTED,
619
+ rawBytesSaved: Math.max(400, Number(fileInfo.size || 0)),
620
+ dedupeKey: `det06:${conversationId}:${currentTurn}:${path.basename(absPath)}`,
621
+ detail: `DET-06 blocked unmodified full-file re-read of ${path.basename(absPath)}`
622
+ });
623
+ } catch (err) {
624
+ void err;
625
+ }
626
+ return { decision: 'deny', reason: det06Read.reason };
627
+ }
628
+ }
629
+ }
630
+ }
631
+
632
+ // Rank 2b (DET-06 Blind New-Module & Turn-1 Blind Multi-File Edit) + Rank 1 (DET-05 Pre-Write Integrity)
633
+ if (/^(write_to_file|write_file|replace_file_content|multi_replace_file_content|edit_file)$/i.test(toolName) && absPath) {
634
+ portfolio.turn1EditedFiles = Array.isArray(portfolio.turn1EditedFiles) ? portfolio.turn1EditedFiles : [];
635
+ const normKey = absPath.replace(/\\/g, '/');
636
+ if (SOURCE_CODE_EXT_RE.test(normKey) && !BLIND_EDIT_EXEMPT_PATH_RE.test(normKey)) {
637
+ if (currentTurn <= 1 && !portfolio.turn1EditedFiles.includes(normKey)) {
638
+ portfolio.turn1EditedFiles.push(normKey);
639
+ }
640
+ }
641
+ const fileInfo = sha256FileSafe(absPath);
642
+
643
+ // Blind New-Module & Turn-1 Blind Multi-File Edit Check
644
+ const explicitOverwrite = Boolean(toolArgs.Overwrite === true || toolArgs.overwrite === true);
645
+ const isWriteTool = /^(write_to_file|write_file)$/i.test(toolName);
646
+ const shouldCheckBlind = isWriteTool || (currentTurn <= 1 && portfolio.turn1EditedFiles.length >= 2);
647
+ if (shouldCheckBlind) {
648
+ const det06Blind = evaluateDet06BlindNewModule({
649
+ targetPath: path.relative(workspacePath, absPath).replace(/\\/g, '/'),
650
+ overwrite: explicitOverwrite,
651
+ fileAlreadyExists: fileInfo.exists,
652
+ discoveryCallsCount: portfolio.discoveryCallsCount,
653
+ siblingSourceFileCount: inputData.siblingSourceFileCount ?? countSiblingSourceFiles(absPath),
654
+ userPrompt,
655
+ flightMode,
656
+ editedFilesCount: portfolio.turn1EditedFiles.length,
657
+ editedFiles: portfolio.turn1EditedFiles,
658
+ turnCount: currentTurn
659
+ });
660
+ if (det06Blind.triggered) {
661
+ pushHudAlert(portfolio, 'DET-06', det06Blind.hudAlert, currentTurn);
662
+ writeSidecarAtomicSync(conversationId, sidecar);
663
+ if (det06Blind.decision === 'ask') {
664
+ return { decision: 'ask', reason: det06Blind.reason, detectorId: 'DET-06' };
665
+ }
666
+ }
667
+ }
668
+
669
+ // Rank 1 (DET-05): Pre-Write Destructive Code-Strip, Test-Assertion & 6-Turn FNV-1a Flip-Flop Guard
670
+ const det05 = evaluateDet05PreWriteIntegrity({
671
+ toolName,
672
+ toolArgs,
673
+ filePath: path.relative(workspacePath, absPath).replace(/\\/g, '/') || absPath,
674
+ currentDiskContent: fileInfo.exists ? fileInfo.content : null,
675
+ userPrompt,
676
+ flightMode,
677
+ fnvRing: portfolio.fnvRings[normKey] || [],
678
+ turn: currentTurn
679
+ });
680
+ portfolio.fnvRings[normKey] = det05.ring;
681
+
682
+ // Invalidate unmodified re-read cache for this file once mutated
683
+ if (!det05.triggered || det05.decision !== 'deny') {
684
+ portfolio.readLedger = portfolio.readLedger.filter((e) => e.absPath !== normKey);
685
+ }
686
+
687
+ if (det05.triggered) {
688
+ pushHudAlert(portfolio, 'DET-05', det05.hudAlert, currentTurn);
689
+ writeSidecarAtomicSync(conversationId, sidecar);
690
+ if (det05.decision === 'deny') {
691
+ return { decision: 'deny', reason: det05.reason };
692
+ }
693
+ }
694
+ }
695
+
696
+ // Rank 12 (DET-16): 80% Hybrid Quota Fan-Out Throttle & 40k/12-Turn Subagent Cap
697
+ if (/^(invoke_subagent|swarm)$/i.test(toolName)) {
698
+ const action = String(toolArgs.action || 'add').toLowerCase();
699
+ if (toolName.toLowerCase() !== 'swarm' || action === 'add') {
700
+ const baseQuotaUsedPct = Number(
701
+ inputData.baseQuotaUsedPct ??
702
+ sidecar.telemetry?.quota?.usedPct ??
703
+ (sidecar.telemetry?.quota?.remaining_fraction !== undefined
704
+ ? (1 - Number(sidecar.telemetry.quota.remaining_fraction)) * 100
705
+ : 0)
706
+ );
707
+ const activeSubagentsCount = Number(
708
+ inputData.activeSubagentsCount ??
709
+ Object.values(sidecar.swarmRoster || {}).filter((w) => w && w.state !== 'terminated' && w.state !== 'killed').length
710
+ );
711
+ const requestedWorkers = Number(
712
+ toolArgs.n ?? (Array.isArray(toolArgs.tasks) ? toolArgs.tasks.length : 1)
713
+ );
714
+ const det16 = evaluateDet16HybridQuotaThrottle({
715
+ baseQuotaUsedPct,
716
+ activeSubagentsCount,
717
+ requestedWorkers,
718
+ subagentTokens: Number(inputData.subagentTokens || 0),
719
+ subagentTurns: Number(inputData.subagentTurns || 0)
720
+ });
721
+ if (det16.triggered) {
722
+ pushHudAlert(portfolio, 'DET-16', det16.reason, currentTurn);
723
+ writeSidecarAtomicSync(conversationId, sidecar);
724
+ return { decision: det16.decision, reason: det16.reason };
725
+ }
726
+ }
727
+ }
728
+
729
+ writeSidecarAtomicSync(conversationId, sidecar);
730
+ return { decision: 'allow' };
731
+ }
732
+
733
+ /**
734
+ * Strict Antigravity `PostToolUse` Recorder (`hooks/post_tool_use.mjs`)
735
+ */
736
+ export async function runStrictPostToolUse(inputData = {}) {
737
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
738
+ const sidecar = readSidecarSync(conversationId);
739
+ const portfolio = ensurePortfolioState(sidecar);
740
+ const toolName = String(inputData.tool_name || inputData.tool || inputData.toolName || '').trim();
741
+ const toolArgs = inputData.tool_input || inputData.args || inputData.parameters || {};
742
+ const resp = inputData.tool_response || inputData.result || {};
743
+
744
+ const exitCode = resp.exitCode ?? resp.exit_code ?? inputData.exitCode ?? inputData.exit_code;
745
+ const failed = Boolean(
746
+ (typeof exitCode === 'number' && exitCode !== 0) ||
747
+ inputData.isError === true ||
748
+ resp.isError === true ||
749
+ String(inputData.status || resp.status || '').toUpperCase() === 'ERROR'
750
+ );
751
+
752
+ portfolio.failureStreaks = recordToolOutcomeForDet04({
753
+ toolName,
754
+ toolArgs,
755
+ failed,
756
+ failureStreaks: portfolio.failureStreaks
757
+ });
758
+
759
+ // Track active skill execution for Rank 9 (RSI-01 Skill Fault Router)
760
+ if (/^(view_file|read_file)$/i.test(toolName)) {
761
+ const p = String(toolArgs.Path || toolArgs.TargetFile || toolArgs.path || '').replace(/\\/g, '/');
762
+ const skillMatch = p.match(/skills\/([a-zA-Z0-9_-]+)\/SKILL\.md$/i);
763
+ if (skillMatch) {
764
+ portfolio.lastExecutedSkill = skillMatch[1];
765
+ }
766
+ }
767
+
768
+ // Rank 3 (DET-07) & RSI-04 ('micro-skills'): CLI hook integration & shell recovery learning
769
+ if (/^(run_command|execute_bash|bash|powershell|exec)$/i.test(toolName)) {
770
+ const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
771
+ const cmdStr = String(toolArgs.CommandLine || toolArgs.command || toolArgs.cmd || '');
772
+ const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
773
+ cwd: workspacePath,
774
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
775
+ });
776
+ if (cmdStr && resolveDetectorOverride(horizonConfig, 'micro-skills') !== 'off') {
777
+ const currentTurn = Math.max(1, Number(inputData.turn ?? sidecar.sessionMeta?.turnCount ?? 1));
778
+ const msOutcome = recordWorkspaceShellOutcome(workspacePath, {
779
+ command: cmdStr,
780
+ exitCode: typeof exitCode === 'number' ? exitCode : (failed ? 1 : 0),
781
+ turn: currentTurn,
782
+ sessionId: String(conversationId),
783
+ confirmSessions: Number(horizonConfig.thresholds?.microSkillConfirmSessions ?? 2)
784
+ });
785
+ if (msOutcome.promotedSkill) {
786
+ portfolio.lastPromotedMicroSkill = msOutcome.promotedSkill;
787
+ }
788
+ }
789
+
790
+ const rawOut = String(resp.output ?? resp.stdout ?? inputData.stdout ?? '');
791
+ if (rawOut.length > 4096) {
792
+ const det07 = archiveAndCompressDet07Output(rawOut, {
793
+ command: cmdStr || toolName,
794
+ exitCode: typeof exitCode === 'number' ? exitCode : 0,
795
+ sessionId: conversationId,
796
+ workspaceDir: workspacePath,
797
+ ledgerDbPath: inputData.ledgerDbPath || null
798
+ });
799
+ portfolio.lastDet07Summary = {
800
+ archived: det07.archived,
801
+ bytesSaved: det07.bytesSaved,
802
+ tokensSaved: det07.tokensSaved,
803
+ archiveDbPath: det07.archiveDbPath
804
+ };
805
+ }
806
+ }
807
+
808
+ writeSidecarAtomicSync(conversationId, sidecar);
809
+ return {};
810
+ }
811
+
812
+ /**
813
+ * Trajectory Fallback Auditor for GUI Sessions where `PreToolUse` hooks may be bypassed.
814
+ */
815
+ export function auditTrajectoryPortfolioFallback(steps = [], {
816
+ userPrompt = '',
817
+ flightMode = 'COACH'
818
+ } = {}) {
819
+ const alerts = [];
820
+ const fnvRings = {};
821
+ let failureStreaks = {};
822
+
823
+ for (let i = 0; i < steps.length; i++) {
824
+ const step = steps[i] || {};
825
+ const calls = Array.isArray(step.toolCalls) ? step.toolCalls : (Array.isArray(step.tool_calls) ? step.tool_calls : []);
826
+ for (const call of calls) {
827
+ const toolName = String(call?.name || call?.tool || '');
828
+ const toolArgs = call?.args || call?.arguments || {};
829
+ const fp = String(toolArgs.TargetFile || toolArgs.Path || toolArgs.path || '');
830
+ if (/^(write_to_file|write_file|replace_file_content|multi_replace_file_content|edit_file)$/i.test(toolName)) {
831
+ const res = evaluateDet05PreWriteIntegrity({
832
+ toolName,
833
+ toolArgs,
834
+ filePath: fp,
835
+ currentDiskContent: step.previousContent ?? null,
836
+ userPrompt: step.userPrompt || userPrompt,
837
+ flightMode,
838
+ fnvRing: fnvRings[fp] || [],
839
+ turn: i + 1
840
+ });
841
+ fnvRings[fp] = res.ring;
842
+ if (res.triggered) alerts.push(res);
843
+ }
844
+
845
+ const failed = Boolean(step.status === 'ERROR' || (typeof step.exitCode === 'number' && step.exitCode !== 0));
846
+ const check04 = evaluateDet04ConsecutiveFailureBreaker({
847
+ toolName,
848
+ toolArgs,
849
+ failureStreaks,
850
+ currentTurn: i + 1,
851
+ flightMode
852
+ });
853
+ if (check04.triggered) alerts.push(check04);
854
+ failureStreaks = recordToolOutcomeForDet04({ toolName, toolArgs, failed, failureStreaks });
855
+ }
856
+ }
857
+ return { alerts, fnvRings, failureStreaks };
858
+ }