@unerr-ai/unerr 0.1.0 → 0.1.1

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 (553) hide show
  1. package/dist/__tests__/architecture-guard.test.js +122 -0
  2. package/dist/__tests__/arg-validator.test.js +205 -0
  3. package/dist/__tests__/ast-extractor.test.js +203 -0
  4. package/dist/__tests__/auto-bootstrap.test.js +280 -0
  5. package/dist/__tests__/background-indexer.test.js +228 -0
  6. package/dist/__tests__/blast-radius-engine.test.js +200 -0
  7. package/dist/__tests__/bridge-isolation.test.js +37 -0
  8. package/dist/__tests__/budget-enforcer.test.js +53 -0
  9. package/dist/__tests__/cfg-test-detection-perf.test.js +82 -0
  10. package/dist/__tests__/change-narrative.test.js +190 -0
  11. package/dist/__tests__/check-commit.test.js +258 -0
  12. package/dist/__tests__/checksum.test.js +34 -0
  13. package/dist/__tests__/commit-watcher.test.js +154 -0
  14. package/dist/__tests__/community-detection.test.js +179 -0
  15. package/dist/__tests__/community-tools.test.js +299 -0
  16. package/dist/__tests__/components.test.js +449 -0
  17. package/dist/__tests__/compression-log.test.js +174 -0
  18. package/dist/__tests__/compression-quality-monitor.test.js +40 -0
  19. package/dist/__tests__/config-healer.test.js +165 -0
  20. package/dist/__tests__/context-ledger.test.js +58 -0
  21. package/dist/__tests__/convention-detector.test.js +99 -0
  22. package/dist/__tests__/convention-learner.test.js +86 -0
  23. package/dist/__tests__/correction-detector.test.js +330 -0
  24. package/dist/__tests__/daemon-autostart-install.test.js +283 -0
  25. package/dist/__tests__/daemon-bridge.test.js +222 -0
  26. package/dist/__tests__/daemon-dashboard.test.js +202 -0
  27. package/dist/__tests__/daemon-registry.test.js +240 -0
  28. package/dist/__tests__/daemon-supervisor.test.js +318 -0
  29. package/dist/__tests__/daemon-version-check.test.js +275 -0
  30. package/dist/__tests__/decision-point-detector.test.js +98 -0
  31. package/dist/__tests__/deep-link.test.js +143 -0
  32. package/dist/__tests__/disallowed-tools.test.js +115 -0
  33. package/dist/__tests__/drift-tracker.test.js +582 -0
  34. package/dist/__tests__/durability-scorer.test.js +152 -0
  35. package/dist/__tests__/efficiency-tracker.test.js +65 -0
  36. package/dist/__tests__/enrich.test.js +144 -0
  37. package/dist/__tests__/entity-rewind.test.js +248 -0
  38. package/dist/__tests__/ephemeral.test.js +111 -0
  39. package/dist/__tests__/exploration-cost.test.js +93 -0
  40. package/dist/__tests__/fact-generator.test.js +197 -0
  41. package/dist/__tests__/file-l0-graph.test.js +244 -0
  42. package/dist/__tests__/file-logger.test.js +82 -0
  43. package/dist/__tests__/file-outline.test.js +141 -0
  44. package/dist/__tests__/file-read-protocol.test.js +188 -0
  45. package/dist/__tests__/format-encoder.test.js +233 -0
  46. package/dist/__tests__/git-attribution.test.js +259 -0
  47. package/dist/__tests__/graph-temporal-joiner.test.js +219 -0
  48. package/dist/__tests__/health-grade-enhanced.test.js +138 -0
  49. package/dist/__tests__/health-map-data.test.js +173 -0
  50. package/dist/__tests__/helpers/mcp-harness.js +45 -0
  51. package/dist/__tests__/helpers/mcp-harness.test.js +68 -0
  52. package/dist/__tests__/hook-dedup.test.js +112 -0
  53. package/dist/__tests__/hook-runner.test.js +253 -0
  54. package/dist/__tests__/indexer-cfg.test.js +185 -0
  55. package/dist/__tests__/indexer-cross-file.test.js +172 -0
  56. package/dist/__tests__/indexer-extraction.test.js +245 -0
  57. package/dist/__tests__/indexer-incremental.test.js +232 -0
  58. package/dist/__tests__/indexer-language-expansion.test.js +165 -0
  59. package/dist/__tests__/init-push.test.js +131 -0
  60. package/dist/__tests__/instruction-writer.test.js +179 -0
  61. package/dist/__tests__/intelligence-integration.test.js +217 -0
  62. package/dist/__tests__/intent-correlator.test.js +175 -0
  63. package/dist/__tests__/intent-detector.test.js +235 -0
  64. package/dist/__tests__/intent-encoder.test.js +167 -0
  65. package/dist/__tests__/java-build-tool-detection.test.js +174 -0
  66. package/dist/__tests__/layer3-sprint-q.test.js +160 -0
  67. package/dist/__tests__/layer3-sprint-r.test.js +91 -0
  68. package/dist/__tests__/layer3-sprint-s.test.js +183 -0
  69. package/dist/__tests__/layer3-sprint-t.test.js +201 -0
  70. package/dist/__tests__/layer3-sprint-u.test.js +174 -0
  71. package/dist/__tests__/layer4-sprint-ba2.test.js +354 -0
  72. package/dist/__tests__/layer4-sprint-ba4.test.js +84 -0
  73. package/dist/__tests__/layer4-sprint-vs.test.js +105 -0
  74. package/dist/__tests__/ledger-chains.test.js +162 -0
  75. package/dist/__tests__/lifecycle-machine.test.js +226 -0
  76. package/dist/__tests__/local-chat-provider.test.js +170 -0
  77. package/dist/__tests__/local-convention-detector.test.js +308 -0
  78. package/dist/__tests__/local-embeddings.test.js +422 -0
  79. package/dist/__tests__/local-graph.test.js +540 -0
  80. package/dist/__tests__/local-indexer.test.js +228 -0
  81. package/dist/__tests__/local-intelligence-l3.test.js +332 -0
  82. package/dist/__tests__/local-llm.test.js +253 -0
  83. package/dist/__tests__/local-mode-offline.test.js +187 -0
  84. package/dist/__tests__/local-mode-stats.test.js +273 -0
  85. package/dist/__tests__/local-mode-tui.test.js +343 -0
  86. package/dist/__tests__/local-parse.test.js +199 -0
  87. package/dist/__tests__/log-tailer.test.js +208 -0
  88. package/dist/__tests__/loop-breaker.test.js +276 -0
  89. package/dist/__tests__/loop-miner.test.js +226 -0
  90. package/dist/__tests__/mcp-config.test.js +126 -0
  91. package/dist/__tests__/mcp-content-json.test.js +10 -0
  92. package/dist/__tests__/mcp-envelope.test.js +124 -0
  93. package/dist/__tests__/metrics-store.test.js +223 -0
  94. package/dist/__tests__/native-watcher.test.js +191 -0
  95. package/dist/__tests__/navigation-hooks-agent-aware.test.js +145 -0
  96. package/dist/__tests__/negative-knowledge.test.js +116 -0
  97. package/dist/__tests__/network-boundary.test.js +190 -0
  98. package/dist/__tests__/network-firewall.test.js +112 -0
  99. package/dist/__tests__/nudge-invariants.test.js +160 -0
  100. package/dist/__tests__/nudge-v2.test.js +225 -0
  101. package/dist/__tests__/offline-rewind.test.js +251 -0
  102. package/dist/__tests__/open-threads.test.js +89 -0
  103. package/dist/__tests__/output-compressor.test.js +93 -0
  104. package/dist/__tests__/pending-violations.test.js +112 -0
  105. package/dist/__tests__/persistence-effectiveness.test.js +143 -0
  106. package/dist/__tests__/provider-factory.test.js +42 -0
  107. package/dist/__tests__/providers.test.js +24 -0
  108. package/dist/__tests__/proxy.test.js +314 -0
  109. package/dist/__tests__/query-router.test.js +1018 -0
  110. package/dist/__tests__/reasoning-quality-route.test.js +138 -0
  111. package/dist/__tests__/redactor.test.js +120 -0
  112. package/dist/__tests__/resource-monitor.test.js +57 -0
  113. package/dist/__tests__/response-envelope.test.js +100 -0
  114. package/dist/__tests__/risk-classifier.test.js +101 -0
  115. package/dist/__tests__/risk-signal-scope.test.js +75 -0
  116. package/dist/__tests__/rule-evaluator.test.js +280 -0
  117. package/dist/__tests__/scip-decoder.test.js +49 -0
  118. package/dist/__tests__/scip-downloader.test.js +201 -0
  119. package/dist/__tests__/scip-merger.test.js +103 -0
  120. package/dist/__tests__/search-index.test.js +422 -0
  121. package/dist/__tests__/semantic-enrichment.test.js +360 -0
  122. package/dist/__tests__/session-brief-builder.test.js +187 -0
  123. package/dist/__tests__/session-context.test.js +221 -0
  124. package/dist/__tests__/session-continuity.test.js +144 -0
  125. package/dist/__tests__/session-dedup.test.js +74 -0
  126. package/dist/__tests__/session-event-wiring.test.js +206 -0
  127. package/dist/__tests__/session-events.test.js +149 -0
  128. package/dist/__tests__/session-legend.test.js +20 -0
  129. package/dist/__tests__/session-persistence.test.js +131 -0
  130. package/dist/__tests__/session-resume-block.test.js +107 -0
  131. package/dist/__tests__/session-resume.test.js +97 -0
  132. package/dist/__tests__/session-summary-writer.test.js +134 -0
  133. package/dist/__tests__/shadow-ledger.test.js +203 -0
  134. package/dist/__tests__/shell-classifier.test.js +151 -0
  135. package/dist/__tests__/shell-compression-floor.test.js +189 -0
  136. package/dist/__tests__/shell-compression-v2.test.js +339 -0
  137. package/dist/__tests__/shell-compressor.test.js +35 -0
  138. package/dist/__tests__/shell-hooks.test.js +128 -0
  139. package/dist/__tests__/shell-strategies.test.js +644 -0
  140. package/dist/__tests__/shell-tee.test.js +133 -0
  141. package/dist/__tests__/signal-dedup.test.js +158 -0
  142. package/dist/__tests__/signal-reinforcer.test.js +77 -0
  143. package/dist/__tests__/signal-scorer.test.js +251 -0
  144. package/dist/__tests__/signal-show-store.test.js +108 -0
  145. package/dist/__tests__/smart-truncate.test.js +215 -0
  146. package/dist/__tests__/snapshot-v2.test.js +113 -0
  147. package/dist/__tests__/sprint-l1-local-mode.test.js +130 -0
  148. package/dist/__tests__/sprint-l10-boot.test.js +220 -0
  149. package/dist/__tests__/sprint-l9-offline-commands.test.js +189 -0
  150. package/dist/__tests__/sprint-q-persistent-context.test.js +198 -0
  151. package/dist/__tests__/sprint-s1-wiring.test.js +215 -0
  152. package/dist/__tests__/sprint-s2-wiring.test.js +256 -0
  153. package/dist/__tests__/sprint-s3-wiring.test.js +195 -0
  154. package/dist/__tests__/sprint-s4-wiring.test.js +213 -0
  155. package/dist/__tests__/sprint-s6-hooks.test.js +222 -0
  156. package/dist/__tests__/sprint-s7-persistent.test.js +263 -0
  157. package/dist/__tests__/sprint-s8-value.test.js +167 -0
  158. package/dist/__tests__/sprint-s9-behavioral.test.js +179 -0
  159. package/dist/__tests__/sprint3-intelligence.test.js +297 -0
  160. package/dist/__tests__/sprint5-mcp-server.test.js +136 -0
  161. package/dist/__tests__/startup-display.test.js +302 -0
  162. package/dist/__tests__/startup-log-file.test.js +97 -0
  163. package/dist/__tests__/stash-manager.test.js +229 -0
  164. package/dist/__tests__/state-detector.test.js +92 -0
  165. package/dist/__tests__/status-dashboard.test.js +142 -0
  166. package/dist/__tests__/temporal-facts.test.js +292 -0
  167. package/dist/__tests__/temporal-routes.test.js +142 -0
  168. package/dist/__tests__/test-detector.test.js +174 -0
  169. package/dist/__tests__/theme.test.js +72 -0
  170. package/dist/__tests__/timeline-agents.test.js +122 -0
  171. package/dist/__tests__/timeline-bootstrap.test.js +176 -0
  172. package/dist/__tests__/timeline-filters.test.js +193 -0
  173. package/dist/__tests__/timeline-markers.test.js +151 -0
  174. package/dist/__tests__/timeline-routes.test.js +156 -0
  175. package/dist/__tests__/timeline-store.test.js +171 -0
  176. package/dist/__tests__/token-counter.test.js +86 -0
  177. package/dist/__tests__/token-estimator.test.js +96 -0
  178. package/dist/__tests__/token-flow-api.test.js +239 -0
  179. package/dist/__tests__/token-flow-instrumentation.test.js +437 -0
  180. package/dist/__tests__/token-flow-persistence.test.js +356 -0
  181. package/dist/__tests__/token-flow-routes.test.js +199 -0
  182. package/dist/__tests__/token-flow.test.js +695 -0
  183. package/dist/__tests__/tool-clusters.test.js +177 -0
  184. package/dist/__tests__/transport-mux.test.js +283 -0
  185. package/dist/__tests__/turn-segmenter.test.js +166 -0
  186. package/dist/__tests__/uninstall.test.js +141 -0
  187. package/dist/__tests__/warm-start-policy.test.js +271 -0
  188. package/dist/__tests__/wire-cap-nudge.test.js +77 -0
  189. package/dist/__tests__/worker-pool.test.js +101 -0
  190. package/dist/behaviors/agent-llm-bridge.js +166 -0
  191. package/dist/behaviors/architecture-guard.js +256 -0
  192. package/dist/behaviors/auto-doc.js +247 -0
  193. package/dist/behaviors/cascade-guard.js +289 -0
  194. package/dist/behaviors/change-narrative.js +270 -0
  195. package/dist/behaviors/convention-drift.js +290 -0
  196. package/dist/behaviors/framework.js +235 -0
  197. package/dist/behaviors/guard-formatter.js +44 -0
  198. package/dist/behaviors/incomplete-work.js +270 -0
  199. package/dist/behaviors/loop-breaker.js +300 -0
  200. package/dist/behaviors/session-continuity.js +208 -0
  201. package/dist/cli.js +992 -706
  202. package/dist/commands/branches.js +97 -0
  203. package/dist/commands/check-commit.js +225 -0
  204. package/dist/commands/compress-output.js +64 -0
  205. package/dist/commands/config-verify.js +243 -0
  206. package/dist/commands/daemon.js +905 -0
  207. package/dist/commands/dashboard.js +52 -0
  208. package/dist/commands/debug.js +200 -0
  209. package/dist/commands/enrich.js +184 -0
  210. package/dist/commands/exec.js +233 -0
  211. package/dist/commands/gain.js +156 -0
  212. package/dist/commands/hook.js +88 -0
  213. package/dist/commands/index.js +88 -0
  214. package/dist/commands/init.js +74 -0
  215. package/dist/commands/install.js +505 -0
  216. package/dist/commands/learn.js +116 -0
  217. package/dist/commands/manifest.js +193 -0
  218. package/dist/commands/rewind.js +103 -0
  219. package/dist/commands/serve.js +19 -0
  220. package/dist/commands/setup-wizard.js +414 -0
  221. package/dist/commands/skills.js +64 -0
  222. package/dist/commands/stats.js +20 -0
  223. package/dist/commands/status.js +654 -0
  224. package/dist/commands/timeline.js +139 -0
  225. package/dist/commands/uninstall.js +230 -0
  226. package/dist/components/App.js +109 -0
  227. package/dist/components/Banner.js +12 -0
  228. package/dist/components/ConfirmPrompt.js +25 -0
  229. package/dist/components/DriftSummary.js +23 -0
  230. package/dist/components/GradeBadge.js +15 -0
  231. package/dist/components/HealthCard.js +18 -0
  232. package/dist/components/InkSpinner.js +22 -0
  233. package/dist/components/InputBox.js +17 -0
  234. package/dist/components/KeyValue.js +13 -0
  235. package/dist/components/MessageList.js +14 -0
  236. package/dist/components/ProgressBar.js +26 -0
  237. package/dist/components/Section.js +16 -0
  238. package/dist/components/SessionSummaryCard.js +73 -0
  239. package/dist/components/StartupDisplay.js +24 -0
  240. package/dist/components/StatusDashboard.js +57 -0
  241. package/dist/components/StatusLine.js +8 -0
  242. package/dist/components/StepLine.js +22 -0
  243. package/dist/components/Theme.js +20 -0
  244. package/dist/components/ToolProgress.js +8 -0
  245. package/dist/components/ViolationList.js +21 -0
  246. package/dist/components/render.js +13 -0
  247. package/dist/config/agent-registry.js +237 -0
  248. package/dist/config/claude-settings-hooks.js +304 -0
  249. package/dist/config/hook-installer.js +65 -0
  250. package/dist/config/instruction-writer.js +388 -0
  251. package/dist/config/mcp-config-writer.js +266 -0
  252. package/dist/config/settings.js +174 -0
  253. package/dist/config/tool-detector.js +42 -0
  254. package/dist/config/value-surfacing.js +119 -0
  255. package/dist/core/context-assembly.js +108 -0
  256. package/dist/core/conversation.js +33 -0
  257. package/dist/core/local-chat-provider.js +475 -0
  258. package/dist/core/provider-factory.js +55 -0
  259. package/dist/core/providers.js +90 -0
  260. package/dist/core/query-engine.js +174 -0
  261. package/dist/daemon/api.js +312 -0
  262. package/dist/daemon/autostart.js +119 -0
  263. package/dist/daemon/bootstrap.js +39 -0
  264. package/dist/daemon/client.js +164 -0
  265. package/dist/daemon/detect-ci.js +81 -0
  266. package/dist/daemon/platform-linux.js +146 -0
  267. package/dist/daemon/platform-macos.js +134 -0
  268. package/dist/daemon/platform-windows.js +116 -0
  269. package/dist/daemon/process-manager.js +299 -0
  270. package/dist/daemon/protocol.js +23 -0
  271. package/dist/daemon/registry.js +270 -0
  272. package/dist/daemon/settings-schema.js +72 -0
  273. package/dist/daemon/system-health.js +134 -0
  274. package/dist/daemon/version-checker.js +262 -0
  275. package/dist/daemon/warm-start.js +223 -0
  276. package/dist/entrypoints/cli.js +1043 -0
  277. package/dist/entrypoints/daemon.js +380 -0
  278. package/dist/entrypoints/repl.js +147 -0
  279. package/dist/hooks/adapters/claude-code.js +90 -0
  280. package/dist/hooks/adapters/cline.js +100 -0
  281. package/dist/hooks/adapters/cursor.js +98 -0
  282. package/dist/hooks/hook-dedup.js +79 -0
  283. package/dist/hooks/hook-runner.js +113 -0
  284. package/dist/hooks/navigation-hooks.js +175 -0
  285. package/dist/hooks/prompt-hooks.js +63 -0
  286. package/dist/hooks/shell-hooks.js +47 -0
  287. package/dist/ignore.js +111 -0
  288. package/dist/intelligence/approach-suggester.js +61 -0
  289. package/dist/intelligence/ast-extractor.js +2615 -0
  290. package/dist/intelligence/ast-worker.js +34 -0
  291. package/dist/intelligence/background-indexer.js +121 -0
  292. package/dist/intelligence/blast-radius.js +200 -0
  293. package/dist/intelligence/community-detection.js +691 -0
  294. package/dist/intelligence/community-detector.js +184 -0
  295. package/dist/intelligence/computation-scheduler.js +75 -0
  296. package/dist/intelligence/confidence-propagation.js +47 -0
  297. package/dist/intelligence/convention-detector.js +242 -0
  298. package/dist/intelligence/convention-learner.js +205 -0
  299. package/dist/intelligence/convention-matcher.js +205 -0
  300. package/dist/intelligence/cozo-schema.js +376 -0
  301. package/dist/intelligence/decision-point-detector.js +90 -0
  302. package/dist/intelligence/deep-dive-tools.js +586 -0
  303. package/dist/intelligence/durability-scorer.js +84 -0
  304. package/dist/intelligence/exploration-cost.js +204 -0
  305. package/dist/intelligence/exploration-pattern-tracker.js +61 -0
  306. package/dist/intelligence/fact-generator.js +322 -0
  307. package/dist/intelligence/facts-schema.js +90 -0
  308. package/dist/intelligence/file-intelligence.js +59 -0
  309. package/dist/intelligence/graph-holder.js +220 -0
  310. package/dist/intelligence/graph-temporal-joiner.js +238 -0
  311. package/dist/intelligence/health-grade.js +423 -0
  312. package/dist/intelligence/health-grader.js +200 -0
  313. package/dist/intelligence/health-map-data.js +259 -0
  314. package/dist/intelligence/import-symbols.js +136 -0
  315. package/dist/intelligence/incremental-indexer.js +658 -0
  316. package/dist/intelligence/indexer/centrality.js +62 -0
  317. package/dist/intelligence/indexer/cfg-context.js +95 -0
  318. package/dist/intelligence/indexer/confidence.js +34 -0
  319. package/dist/intelligence/indexer/cross-file-resolver.js +104 -0
  320. package/dist/intelligence/indexer/edge-repair.js +89 -0
  321. package/dist/intelligence/indexer/entity-key.js +17 -0
  322. package/dist/intelligence/indexer/export-map.js +132 -0
  323. package/dist/intelligence/indexer/git-cochange.js +128 -0
  324. package/dist/intelligence/indexer/graph-patch.js +147 -0
  325. package/dist/intelligence/indexer/incremental.js +78 -0
  326. package/dist/intelligence/indexer/ingest.js +160 -0
  327. package/dist/intelligence/indexer/language-detect.js +226 -0
  328. package/dist/intelligence/indexer/metadata.js +63 -0
  329. package/dist/intelligence/indexer/mutation-tracker.js +79 -0
  330. package/dist/intelligence/indexer/orchestrator.js +155 -0
  331. package/dist/intelligence/indexer/plugin-interface.js +31 -0
  332. package/dist/intelligence/indexer/plugins/csharp.js +440 -0
  333. package/dist/intelligence/indexer/plugins/go.js +335 -0
  334. package/dist/intelligence/indexer/plugins/java.js +370 -0
  335. package/dist/intelligence/indexer/plugins/python.js +358 -0
  336. package/dist/intelligence/indexer/plugins/regex-fallback.js +82 -0
  337. package/dist/intelligence/indexer/plugins/ruby.js +290 -0
  338. package/dist/intelligence/indexer/plugins/rust.js +484 -0
  339. package/dist/intelligence/indexer/plugins/tier2-generic.js +310 -0
  340. package/dist/intelligence/indexer/plugins/typescript.js +456 -0
  341. package/dist/intelligence/indexer/resource-monitor.js +93 -0
  342. package/dist/intelligence/indexer/scip/decoder.js +253 -0
  343. package/dist/intelligence/indexer/scip/detector.js +232 -0
  344. package/dist/intelligence/indexer/scip/downloader.js +427 -0
  345. package/dist/intelligence/indexer/scip/fallback.js +34 -0
  346. package/dist/intelligence/indexer/scip/merger.js +109 -0
  347. package/dist/intelligence/indexer/scip/orchestrator.js +433 -0
  348. package/dist/intelligence/indexer/scip/runner.js +98 -0
  349. package/dist/intelligence/indexer/snapshot.js +66 -0
  350. package/dist/intelligence/indexer/test-detector.js +196 -0
  351. package/dist/intelligence/indexer/watch-integration.js +61 -0
  352. package/dist/intelligence/indexer/worker.js +85 -0
  353. package/dist/intelligence/local-convention-detector.js +437 -0
  354. package/dist/intelligence/local-embeddings.js +190 -0
  355. package/dist/intelligence/local-graph.js +1946 -0
  356. package/dist/intelligence/local-indexer.js +1575 -0
  357. package/dist/intelligence/local-llm.js +163 -0
  358. package/dist/intelligence/local-rule-generator.js +154 -0
  359. package/dist/intelligence/local-snapshot.js +213 -0
  360. package/dist/intelligence/negative-knowledge.js +103 -0
  361. package/dist/intelligence/persistent-db.js +85 -0
  362. package/dist/intelligence/query-router.js +2556 -0
  363. package/dist/intelligence/risk-classifier.js +116 -0
  364. package/dist/intelligence/rule-evaluator.js +380 -0
  365. package/dist/intelligence/rule-generator.js +49 -0
  366. package/dist/intelligence/search-index.js +173 -0
  367. package/dist/intelligence/semantic/docstring-extractor.js +67 -0
  368. package/dist/intelligence/semantic/embedding-store.js +52 -0
  369. package/dist/intelligence/semantic/enrichment-orchestrator.js +48 -0
  370. package/dist/intelligence/semantic/git-message-miner.js +114 -0
  371. package/dist/intelligence/semantic/identifier-tokenizer.js +51 -0
  372. package/dist/intelligence/semantic/node2vec-embeddings.js +71 -0
  373. package/dist/intelligence/semantic/node2vec-walks.js +103 -0
  374. package/dist/intelligence/semantic/path-domain-inference.js +112 -0
  375. package/dist/intelligence/semantic/similarity-engine.js +60 -0
  376. package/dist/intelligence/semantic/tfidf-vectors.js +88 -0
  377. package/dist/intelligence/session-brief-builder.js +159 -0
  378. package/dist/intelligence/session-context.js +221 -0
  379. package/dist/intelligence/session-health-monitor.js +211 -0
  380. package/dist/intelligence/session-narrative.js +197 -0
  381. package/dist/intelligence/session-pattern-analyzer.js +218 -0
  382. package/dist/intelligence/signal-scorer.js +390 -0
  383. package/dist/intelligence/signal-show-store.js +182 -0
  384. package/dist/intelligence/smart-truncate.js +158 -0
  385. package/dist/intelligence/subgraph-cache.js +88 -0
  386. package/dist/intelligence/temporal-facts.js +494 -0
  387. package/dist/intelligence/token-estimator.js +100 -0
  388. package/dist/intelligence/tool-injector.js +87 -0
  389. package/dist/intelligence/tree-sitter-loader.js +71 -0
  390. package/dist/intelligence/worker-pool.js +116 -0
  391. package/dist/proxy/arg-validator.js +79 -0
  392. package/dist/proxy/auto-bootstrap.js +167 -0
  393. package/dist/proxy/bridge.js +147 -0
  394. package/dist/proxy/budget-enforcer.js +70 -0
  395. package/dist/proxy/compression-quality-monitor.js +160 -0
  396. package/dist/proxy/compression-stats.js +51 -0
  397. package/dist/proxy/context-rot-detector.js +137 -0
  398. package/dist/proxy/drift-detector.js +139 -0
  399. package/dist/proxy/efficiency-tracker.js +79 -0
  400. package/dist/proxy/fact-ranking.js +154 -0
  401. package/dist/proxy/format-encoder.js +266 -0
  402. package/dist/proxy/http-transport.js +90 -0
  403. package/dist/proxy/lifecycle-actor.js +55 -0
  404. package/dist/proxy/lifecycle-machine.js +187 -0
  405. package/dist/proxy/log-tailer.js +265 -0
  406. package/dist/proxy/model-pricing.js +98 -0
  407. package/dist/proxy/network-firewall.js +141 -0
  408. package/dist/proxy/nudge-state.js +93 -0
  409. package/dist/proxy/output-compressor.js +185 -0
  410. package/dist/proxy/pid-lock.js +291 -0
  411. package/dist/proxy/proxy-context.js +11 -0
  412. package/dist/proxy/proxy.js +2633 -0
  413. package/dist/proxy/response-enrichment.js +32 -0
  414. package/dist/proxy/response-envelope.js +313 -0
  415. package/dist/proxy/session-dedup.js +82 -0
  416. package/dist/proxy/session-legend.js +30 -0
  417. package/dist/proxy/session-persistence.js +210 -0
  418. package/dist/proxy/session-resume.js +94 -0
  419. package/dist/proxy/session-stats.js +513 -0
  420. package/dist/proxy/shell-classifier.js +1346 -0
  421. package/dist/proxy/shell-compression-log.js +93 -0
  422. package/dist/proxy/shell-compressor.js +390 -0
  423. package/dist/proxy/shell-graph-boost.js +202 -0
  424. package/dist/proxy/shell-monitor-map.js +18 -0
  425. package/dist/proxy/shell-stats.js +54 -0
  426. package/dist/proxy/shell-strategies/cloud.js +215 -0
  427. package/dist/proxy/shell-strategies/diff.js +159 -0
  428. package/dist/proxy/shell-strategies/error-diagnostic.js +796 -0
  429. package/dist/proxy/shell-strategies/filter-dsl.js +358 -0
  430. package/dist/proxy/shell-strategies/git-status.js +177 -0
  431. package/dist/proxy/shell-strategies/key-value.js +193 -0
  432. package/dist/proxy/shell-strategies/log-text.js +154 -0
  433. package/dist/proxy/shell-strategies/omni.js +188 -0
  434. package/dist/proxy/shell-strategies/progress.js +55 -0
  435. package/dist/proxy/shell-strategies/redact.js +76 -0
  436. package/dist/proxy/shell-strategies/structured.js +241 -0
  437. package/dist/proxy/shell-strategies/tabular.js +243 -0
  438. package/dist/proxy/shell-strategies/test-results-types.js +13 -0
  439. package/dist/proxy/shell-strategies/test-results.js +784 -0
  440. package/dist/proxy/shell-strategies/tree-paths.js +144 -0
  441. package/dist/proxy/shell-strategies/yaml.js +182 -0
  442. package/dist/proxy/shell-tee.js +111 -0
  443. package/dist/proxy/signal-dedup.js +171 -0
  444. package/dist/proxy/startup-renderer.js +158 -0
  445. package/dist/proxy/task-token-display.js +38 -0
  446. package/dist/proxy/token-counter.js +61 -0
  447. package/dist/proxy/tool-clusters.js +273 -0
  448. package/dist/proxy/tool-definitions.js +525 -0
  449. package/dist/proxy/transport-mux.js +229 -0
  450. package/dist/proxy/wire-cap.js +268 -0
  451. package/dist/schemas/api/skills.js +19 -0
  452. package/dist/schemas/common/errors.js +7 -0
  453. package/dist/schemas/common/headers.js +5 -0
  454. package/dist/schemas/entities/edge.js +25 -0
  455. package/dist/schemas/entities/entity.js +22 -0
  456. package/dist/schemas/entities/rule.js +18 -0
  457. package/dist/schemas/index.js +14 -0
  458. package/dist/server/event-bus.js +59 -0
  459. package/dist/server/http.js +156 -0
  460. package/dist/server/middleware.js +70 -0
  461. package/dist/server/routes/drift.js +97 -0
  462. package/dist/server/routes/intelligence.js +1217 -0
  463. package/dist/server/routes/reasoning-quality.js +444 -0
  464. package/dist/server/routes/session.js +86 -0
  465. package/dist/server/routes/stream.js +120 -0
  466. package/dist/server/routes/system.js +73 -0
  467. package/dist/server/routes/temporal.js +170 -0
  468. package/dist/server/routes/timeline.js +232 -0
  469. package/dist/server/routes/token-flow.js +403 -0
  470. package/dist/skills/effectiveness-tracker.js +93 -0
  471. package/dist/skills/local-pack.js +380 -0
  472. package/dist/skills/resolver.js +495 -0
  473. package/dist/state-detector.js +83 -0
  474. package/dist/timeline/intent-detector.js +263 -0
  475. package/dist/timeline/loop-miner.js +140 -0
  476. package/dist/timeline/open-threads.js +49 -0
  477. package/dist/timeline/signal-reinforcer.js +62 -0
  478. package/dist/timeline/timeline-bootstrap.js +151 -0
  479. package/dist/timeline/timeline-store.js +618 -0
  480. package/dist/tools/coding/bash.js +49 -0
  481. package/dist/tools/coding/file-edit.js +72 -0
  482. package/dist/tools/coding/file-outline.js +227 -0
  483. package/dist/tools/coding/file-read-protocol.js +425 -0
  484. package/dist/tools/coding/file-read.js +35 -0
  485. package/dist/tools/coding/file-write.js +43 -0
  486. package/dist/tools/coding/glob-tool.js +109 -0
  487. package/dist/tools/coding/grep.js +162 -0
  488. package/dist/tools/coding/index.js +27 -0
  489. package/dist/tools/intelligence/index.js +269 -0
  490. package/dist/tools/intelligence/record-fact.js +48 -0
  491. package/dist/tools/intelligence/timeline-markers.js +130 -0
  492. package/dist/tools/registry.js +47 -0
  493. package/dist/tools/types.js +8 -0
  494. package/dist/tracking/auto-snapshot-triggers.js +246 -0
  495. package/dist/tracking/branch-context.js +115 -0
  496. package/dist/tracking/branch-snapshot.js +217 -0
  497. package/dist/tracking/causal-bridge.js +317 -0
  498. package/dist/tracking/circuit-breaker.js +147 -0
  499. package/dist/tracking/commit-watcher.js +114 -0
  500. package/dist/tracking/context-ledger.js +119 -0
  501. package/dist/tracking/correction-detector.js +324 -0
  502. package/dist/tracking/drift-tracker.js +874 -0
  503. package/dist/tracking/durability-tracker.js +94 -0
  504. package/dist/tracking/entity-rewind.js +200 -0
  505. package/dist/tracking/file-hash-state.js +114 -0
  506. package/dist/tracking/git-attribution.js +132 -0
  507. package/dist/tracking/git-trailers.js +171 -0
  508. package/dist/tracking/intelligence-counter.js +46 -0
  509. package/dist/tracking/intent-correlator.js +202 -0
  510. package/dist/tracking/intent-encoder.js +52 -0
  511. package/dist/tracking/intent-token-tracker.js +159 -0
  512. package/dist/tracking/ledger-archiver.js +94 -0
  513. package/dist/tracking/ledger-chains.js +245 -0
  514. package/dist/tracking/metrics-store.js +361 -0
  515. package/dist/tracking/native-watcher.js +131 -0
  516. package/dist/tracking/offline-rewind.js +295 -0
  517. package/dist/tracking/pending-violations.js +74 -0
  518. package/dist/tracking/persistence-effectiveness.js +167 -0
  519. package/dist/tracking/prompt-durability.js +202 -0
  520. package/dist/tracking/quality-signals.js +213 -0
  521. package/dist/tracking/redactor.js +73 -0
  522. package/dist/tracking/rewind-engine.js +161 -0
  523. package/dist/tracking/session-history.js +128 -0
  524. package/dist/tracking/session-receipt.js +88 -0
  525. package/dist/tracking/session-summary-writer.js +157 -0
  526. package/dist/tracking/shadow-ledger.js +321 -0
  527. package/dist/tracking/stash-manager.js +258 -0
  528. package/dist/tracking/timeline-fork.js +213 -0
  529. package/dist/tracking/timeline.js +69 -0
  530. package/dist/tracking/token-flow.js +276 -0
  531. package/dist/tracking/turn-segmenter.js +122 -0
  532. package/dist/tracking/weekly-accumulator.js +179 -0
  533. package/dist/tracking/working-snapshots.js +188 -0
  534. package/dist/tracking/workspace-manifest.js +176 -0
  535. package/dist/transport/http.js +102 -0
  536. package/dist/ui/assets/index-BsMTQdhX.js +10 -0
  537. package/dist/ui/index.html +1 -1
  538. package/dist/utils/counterfactual.js +65 -0
  539. package/dist/utils/deep-link.js +34 -0
  540. package/dist/utils/detect.js +193 -0
  541. package/dist/utils/exec.js +73 -0
  542. package/dist/utils/file-logger.js +87 -0
  543. package/dist/utils/format-error.js +29 -0
  544. package/dist/utils/git.js +181 -0
  545. package/dist/utils/log.js +57 -0
  546. package/dist/utils/logger.js +35 -0
  547. package/dist/utils/mcp-content-json.js +8 -0
  548. package/dist/utils/session-logger.js +154 -0
  549. package/dist/utils/startup-log.js +512 -0
  550. package/dist/utils/ui.js +56 -0
  551. package/package.json +5 -3
  552. package/scripts/postinstall.mjs +299 -0
  553. package/dist/ui/assets/index-B-0HTtUR.js +0 -10
@@ -0,0 +1,273 @@
1
+ /**
2
+ * Sprint L4 Tests: Statistical Proof Engine — LocalModeStats, shutdown summary, cumulative stats.
3
+ */
4
+ import { mkdirSync, rmSync, writeFileSync, } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { join } from "node:path";
7
+ import { afterEach, beforeEach, describe, expect, it } from "vitest";
8
+ import { createLocalModeStats, createSessionStats, formatLocalModeSessionStats, loadCumulativeLocalStats, persistCumulativeLocalStats, recordBlastRadius, recordCommunityContext, recordCorrectionInjection, recordEmbedding, recordGraphQuery, recordIndexingResult, recordLatency, recordSemanticSearch, recordToolCall, recordTruncationSavings, } from "../proxy/session-stats.js";
9
+ // ── LocalModeStats Creation ─────────────────────────────────────
10
+ describe("createLocalModeStats", () => {
11
+ it("initializes all counters to zero", () => {
12
+ const lm = createLocalModeStats();
13
+ expect(lm.filesIndexed).toBe(0);
14
+ expect(lm.entitiesExtracted).toBe(0);
15
+ expect(lm.edgesComputed).toBe(0);
16
+ expect(lm.indexingTimeMs).toBe(0);
17
+ expect(lm.communitiesDetected).toBe(0);
18
+ expect(lm.embeddingsComputed).toBe(0);
19
+ expect(lm.embeddingTimeMs).toBe(0);
20
+ expect(lm.semanticSearches).toBe(0);
21
+ expect(lm.tokensSavedByTruncation).toBe(0);
22
+ expect(lm.truncatedResponses).toBe(0);
23
+ expect(lm.correctionPatternsInjected).toBe(0);
24
+ expect(lm.communityContextsInjected).toBe(0);
25
+ expect(lm.blastRadiusComputations).toBe(0);
26
+ expect(lm.firewallBlockedCount).toBe(0);
27
+ expect(lm.graphQueriesByType).toEqual({});
28
+ });
29
+ });
30
+ // ── SessionStats with Local Mode ────────────────────────────────
31
+ describe("createSessionStats with isLocalMode", () => {
32
+ it("creates localMode=null for standard mode", () => {
33
+ const stats = createSessionStats(false);
34
+ expect(stats.localMode).toBeNull();
35
+ });
36
+ it("creates localMode stats for local mode", () => {
37
+ const stats = createSessionStats(true);
38
+ expect(stats.localMode).not.toBeNull();
39
+ expect(stats.localMode?.filesIndexed).toBe(0);
40
+ });
41
+ });
42
+ // ── Recording Functions ─────────────────────────────────────────
43
+ describe("LocalModeStats recording functions", () => {
44
+ let lm;
45
+ beforeEach(() => {
46
+ lm = createLocalModeStats();
47
+ });
48
+ it("recordGraphQuery tracks per-tool counts", () => {
49
+ recordGraphQuery(lm, "get_function");
50
+ recordGraphQuery(lm, "get_function");
51
+ recordGraphQuery(lm, "search_code");
52
+ recordGraphQuery(lm, "get_callers");
53
+ expect(lm.graphQueriesByType.get_function).toBe(2);
54
+ expect(lm.graphQueriesByType.search_code).toBe(1);
55
+ expect(lm.graphQueriesByType.get_callers).toBe(1);
56
+ });
57
+ it("recordTruncationSavings accumulates token savings", () => {
58
+ recordTruncationSavings(lm, 10000, 3000); // saved 7000
59
+ recordTruncationSavings(lm, 5000, 2000); // saved 3000
60
+ recordTruncationSavings(lm, 1000, 1500); // no savings (used > full)
61
+ expect(lm.tokensSavedByTruncation).toBe(10000);
62
+ expect(lm.truncatedResponses).toBe(2);
63
+ });
64
+ it("recordIndexingResult sets all indexing fields", () => {
65
+ recordIndexingResult(lm, {
66
+ fileCount: 500,
67
+ entityCount: 2000,
68
+ edgeCount: 5000,
69
+ elapsedMs: 3200,
70
+ communityCount: 25,
71
+ });
72
+ expect(lm.filesIndexed).toBe(500);
73
+ expect(lm.entitiesExtracted).toBe(2000);
74
+ expect(lm.edgesComputed).toBe(5000);
75
+ expect(lm.indexingTimeMs).toBe(3200);
76
+ expect(lm.communitiesDetected).toBe(25);
77
+ });
78
+ it("recordBlastRadius increments counter", () => {
79
+ recordBlastRadius(lm);
80
+ recordBlastRadius(lm);
81
+ expect(lm.blastRadiusComputations).toBe(2);
82
+ });
83
+ it("recordCorrectionInjection increments counter", () => {
84
+ recordCorrectionInjection(lm);
85
+ recordCorrectionInjection(lm);
86
+ recordCorrectionInjection(lm);
87
+ expect(lm.correctionPatternsInjected).toBe(3);
88
+ });
89
+ it("recordCommunityContext increments counter", () => {
90
+ recordCommunityContext(lm);
91
+ expect(lm.communityContextsInjected).toBe(1);
92
+ });
93
+ it("recordEmbedding accumulates counts and time", () => {
94
+ recordEmbedding(lm, 100, 500);
95
+ recordEmbedding(lm, 50, 300);
96
+ expect(lm.embeddingsComputed).toBe(150);
97
+ expect(lm.embeddingTimeMs).toBe(800);
98
+ });
99
+ it("recordSemanticSearch increments counter", () => {
100
+ recordSemanticSearch(lm);
101
+ recordSemanticSearch(lm);
102
+ expect(lm.semanticSearches).toBe(2);
103
+ });
104
+ });
105
+ // ── Local Mode Shutdown Summary ─────────────────────────────────
106
+ describe("formatLocalModeSessionStats", () => {
107
+ function makeStats() {
108
+ const stats = createSessionStats(true);
109
+ // Simulate a session with activity
110
+ for (let i = 0; i < 50; i++) {
111
+ recordToolCall(stats);
112
+ recordLatency(stats.latency, 2 + Math.random() * 3);
113
+ }
114
+ stats.violationsCaught = 3;
115
+ stats.riskWarningsIssued = 1;
116
+ stats.events.chokepointWarningsIssued = 2;
117
+ const lm = stats.localMode;
118
+ recordGraphQuery(lm, "get_function");
119
+ recordGraphQuery(lm, "get_function");
120
+ recordGraphQuery(lm, "get_class");
121
+ recordGraphQuery(lm, "search_code");
122
+ recordGraphQuery(lm, "get_callers");
123
+ recordBlastRadius(lm);
124
+ recordBlastRadius(lm);
125
+ recordTruncationSavings(lm, 10000, 3000);
126
+ recordCorrectionInjection(lm);
127
+ return stats;
128
+ }
129
+ it("returns null for zero tool calls", () => {
130
+ const stats = createSessionStats(true);
131
+ expect(formatLocalModeSessionStats(stats)).toBeNull();
132
+ });
133
+ it("falls back to standard format when localMode is null", () => {
134
+ const stats = createSessionStats(false);
135
+ recordToolCall(stats);
136
+ const result = formatLocalModeSessionStats(stats);
137
+ // Should use formatSessionStats (standard mode output)
138
+ expect(result).toContain("unerr session");
139
+ });
140
+ it("renders Local Mode session summary header", () => {
141
+ const result = formatLocalModeSessionStats(makeStats());
142
+ expect(result).toContain("Local Mode Session Summary");
143
+ });
144
+ it("includes MCP tool call counts", () => {
145
+ const result = formatLocalModeSessionStats(makeStats());
146
+ expect(result).toContain("50 (all local)");
147
+ });
148
+ it("includes latency percentiles", () => {
149
+ const result = formatLocalModeSessionStats(makeStats());
150
+ expect(result).toContain("(p50)");
151
+ expect(result).toContain("(p95)");
152
+ });
153
+ it("includes graph intelligence section", () => {
154
+ const result = formatLocalModeSessionStats(makeStats());
155
+ expect(result).toContain("Graph Intelligence:");
156
+ expect(result).toContain("Entity lookups:");
157
+ expect(result).toContain("Blast radius:");
158
+ expect(result).toContain("Search queries:");
159
+ expect(result).toContain("Callers/callees:");
160
+ });
161
+ it("includes token discipline section", () => {
162
+ const result = formatLocalModeSessionStats(makeStats());
163
+ expect(result).toContain("Token Discipline:");
164
+ expect(result).toContain("Tokens saved:");
165
+ expect(result).toContain("Responses truncated:");
166
+ });
167
+ it("includes safety catches section", () => {
168
+ const result = formatLocalModeSessionStats(makeStats());
169
+ expect(result).toContain("Safety Catches:");
170
+ expect(result).toContain("Violations caught:");
171
+ expect(result).toContain("Corrections applied:");
172
+ });
173
+ it("includes network isolation section", () => {
174
+ const result = formatLocalModeSessionStats(makeStats());
175
+ expect(result).toContain("Network Isolation:");
176
+ expect(result).toContain("0 (firewall sealed)");
177
+ });
178
+ it("omits empty sections", () => {
179
+ const stats = createSessionStats(true);
180
+ recordToolCall(stats);
181
+ recordLatency(stats.latency, 2);
182
+ const result = formatLocalModeSessionStats(stats);
183
+ expect(result).not.toContain("Graph Intelligence:");
184
+ expect(result).not.toContain("Token Discipline:");
185
+ expect(result).not.toContain("Safety Catches:");
186
+ expect(result).not.toContain("Semantic Intelligence:");
187
+ // Network Isolation always shown
188
+ expect(result).toContain("Network Isolation:");
189
+ });
190
+ it("includes semantic intelligence when embeddings computed", () => {
191
+ const stats = makeStats();
192
+ recordEmbedding(stats.localMode, 100, 500);
193
+ recordSemanticSearch(stats.localMode);
194
+ const result = formatLocalModeSessionStats(stats);
195
+ expect(result).toContain("Semantic Intelligence:");
196
+ expect(result).toContain("Embeddings computed:");
197
+ expect(result).toContain("Semantic searches:");
198
+ });
199
+ });
200
+ // ── Cumulative Local Stats Persistence ──────────────────────────
201
+ describe("CumulativeLocalStats", () => {
202
+ let tmpDir;
203
+ const originalHome = process.env.HOME;
204
+ beforeEach(() => {
205
+ tmpDir = join(tmpdir(), `unerr-cumul-test-${Date.now()}`);
206
+ mkdirSync(join(tmpDir, ".unerr"), { recursive: true });
207
+ process.env.HOME = tmpDir;
208
+ });
209
+ afterEach(() => {
210
+ process.env.HOME = originalHome;
211
+ try {
212
+ rmSync(tmpDir, { recursive: true, force: true });
213
+ }
214
+ catch {
215
+ /* ignore */
216
+ }
217
+ });
218
+ it("returns empty stats when no file exists", () => {
219
+ const cls = loadCumulativeLocalStats();
220
+ expect(cls.totalSessions).toBe(0);
221
+ expect(cls.totalToolCalls).toBe(0);
222
+ expect(cls.totalTokensSaved).toBe(0);
223
+ });
224
+ it("persists and loads stats across calls", () => {
225
+ const stats = createSessionStats(true);
226
+ for (let i = 0; i < 10; i++)
227
+ recordToolCall(stats);
228
+ stats.violationsCaught = 2;
229
+ recordTruncationSavings(stats.localMode, 5000, 1000);
230
+ recordCorrectionInjection(stats.localMode);
231
+ const result = persistCumulativeLocalStats(stats);
232
+ expect(result.totalSessions).toBe(1);
233
+ expect(result.totalToolCalls).toBe(10);
234
+ expect(result.totalTokensSaved).toBe(4000);
235
+ expect(result.totalViolationsCaught).toBe(2);
236
+ expect(result.totalCorrectionsApplied).toBe(1);
237
+ // Second session accumulates
238
+ const stats2 = createSessionStats(true);
239
+ for (let i = 0; i < 5; i++)
240
+ recordToolCall(stats2);
241
+ stats2.violationsCaught = 1;
242
+ recordTruncationSavings(stats2.localMode, 3000, 1000);
243
+ const result2 = persistCumulativeLocalStats(stats2);
244
+ expect(result2.totalSessions).toBe(2);
245
+ expect(result2.totalToolCalls).toBe(15);
246
+ expect(result2.totalTokensSaved).toBe(6000);
247
+ expect(result2.totalViolationsCaught).toBe(3);
248
+ });
249
+ it("resets on new week", () => {
250
+ // Write stats with a stale week
251
+ const staleStats = {
252
+ weekStartDate: "2020-01-06",
253
+ totalSessions: 100,
254
+ totalToolCalls: 5000,
255
+ totalTokensSaved: 999999,
256
+ totalViolationsCaught: 50,
257
+ totalCorrectionsApplied: 10,
258
+ totalFilesIndexed: 200,
259
+ totalSemanticSearches: 30,
260
+ avgLatencyP50: 2.5,
261
+ };
262
+ const filePath = join(tmpDir, ".unerr", "cumulative-local-stats.json");
263
+ writeFileSync(filePath, JSON.stringify(staleStats));
264
+ const loaded = loadCumulativeLocalStats();
265
+ expect(loaded.totalSessions).toBe(0);
266
+ expect(loaded.totalToolCalls).toBe(0);
267
+ });
268
+ it("returns existing cumulative when localMode is null", () => {
269
+ const stats = createSessionStats(false); // standard mode
270
+ const result = persistCumulativeLocalStats(stats);
271
+ expect(result.totalSessions).toBe(0);
272
+ });
273
+ });
@@ -0,0 +1,343 @@
1
+ /**
2
+ * Tests for Sprint L7 — Local Mode TUI components.
3
+ *
4
+ * Covers:
5
+ * - StartupDisplay Local Mode variant (Three-Act structure)
6
+ * - SessionSummaryCard Local Mode variant (proof-of-value shutdown)
7
+ * - StartupRenderer local mode methods
8
+ * - Latency advantage injection
9
+ */
10
+ import * as fs from "node:fs";
11
+ import * as os from "node:os";
12
+ import * as path from "node:path";
13
+ import { render } from "ink-testing-library";
14
+ import React from "react";
15
+ import { afterEach, beforeEach, describe, expect, it } from "vitest";
16
+ import { SessionSummaryCard } from "../components/SessionSummaryCard.js";
17
+ import { StartupDisplay, } from "../components/StartupDisplay.js";
18
+ import { ThemeProvider } from "../components/Theme.js";
19
+ import { createLatencyTracker, createLocalModeStats, createSessionEvents, recordLatencyAdvantage, } from "../proxy/session-stats.js";
20
+ function renderWithTheme(el) {
21
+ return render(React.createElement(ThemeProvider, null, el));
22
+ }
23
+ function renderStartup(state) {
24
+ return renderWithTheme(React.createElement(StartupDisplay, { state }));
25
+ }
26
+ function makeLocalStats() {
27
+ return {
28
+ toolCallsLocal: 25,
29
+ estimatedTokensSaved: 0,
30
+ violationsCaught: 2,
31
+ riskWarningsIssued: 1,
32
+ sessionStartedAt: Date.now() - 300_000, // 5 min ago
33
+ latency: createLatencyTracker(),
34
+ events: {
35
+ ...createSessionEvents(),
36
+ conventionViolationsCaught: 2,
37
+ chokepointWarningsIssued: 1,
38
+ },
39
+ isResumedSession: false,
40
+ previousSession: null,
41
+ localMode: {
42
+ ...createLocalModeStats(),
43
+ blastRadiusComputations: 3,
44
+ communityContextsInjected: 5,
45
+ correctionPatternsInjected: 2,
46
+ tokensSavedByTruncation: 12000,
47
+ truncatedResponses: 4,
48
+ semanticSearches: 7,
49
+ cumulativeLatencySavedMs: 4850,
50
+ firewallBlockedCount: 0,
51
+ },
52
+ };
53
+ }
54
+ // ── StartupDisplay Local Mode ─────────────────────────────────────
55
+ describe("StartupDisplay Local Mode (L7.1)", () => {
56
+ it("renders locally computed health title instead of First Look", () => {
57
+ const { lastFrame } = renderStartup({
58
+ steps: [],
59
+ firstBoot: false,
60
+ ready: false,
61
+ localMode: true,
62
+ health: {
63
+ grade: "B",
64
+ totalEntities: 500,
65
+ totalEdges: 300,
66
+ totalRules: 8,
67
+ deadFunctionCount: 5,
68
+ highRiskEntities: [],
69
+ score: 78,
70
+ },
71
+ });
72
+ const frame = lastFrame() ?? "";
73
+ expect(frame).toContain("Health (locally computed)");
74
+ expect(frame).not.toContain("First Look");
75
+ });
76
+ it("shows tool count and zero cloud deps in Act 3", () => {
77
+ const { lastFrame } = renderStartup({
78
+ steps: [],
79
+ firstBoot: false,
80
+ ready: true,
81
+ localMode: true,
82
+ toolCount: 11,
83
+ });
84
+ const frame = lastFrame() ?? "";
85
+ expect(frame).toContain("11 tools ready");
86
+ expect(frame).toContain("offline-capable");
87
+ });
88
+ it("shows agent invitation with entity name in Local Mode", () => {
89
+ const { lastFrame } = renderStartup({
90
+ steps: [],
91
+ firstBoot: false,
92
+ ready: true,
93
+ localMode: true,
94
+ invitationEntity: "processPayment",
95
+ });
96
+ const frame = lastFrame() ?? "";
97
+ expect(frame).toContain("What depends on processPayment?");
98
+ });
99
+ it("shows default invitation when no entity", () => {
100
+ const { lastFrame } = renderStartup({
101
+ steps: [],
102
+ firstBoot: false,
103
+ ready: true,
104
+ localMode: true,
105
+ });
106
+ const frame = lastFrame() ?? "";
107
+ expect(frame).toContain("Show me the highest-impact functions in this codebase");
108
+ });
109
+ it("never shows deep link in Local Mode", () => {
110
+ const { lastFrame } = renderStartup({
111
+ steps: [],
112
+ firstBoot: false,
113
+ ready: true,
114
+ localMode: true,
115
+ deepLink: "https://app.unerr.dev/r/repo_123",
116
+ });
117
+ // Deep link is in state but Local Mode Act 3 doesn't render it
118
+ const frame = lastFrame() ?? "";
119
+ expect(frame).not.toContain("Health details");
120
+ expect(frame).not.toContain("Proxy ready. Serving MCP on stdio");
121
+ });
122
+ it("does not show standard Act 3 when in local mode", () => {
123
+ const { lastFrame } = renderStartup({
124
+ steps: [],
125
+ firstBoot: false,
126
+ ready: true,
127
+ localMode: true,
128
+ proxyMode: "full",
129
+ });
130
+ const frame = lastFrame() ?? "";
131
+ expect(frame).not.toContain("Proxy ready");
132
+ });
133
+ });
134
+ // ── SessionSummaryCard Local Mode ─────────────────────────────────
135
+ describe("SessionSummaryCard Local Mode (L7.2)", () => {
136
+ it("renders all-local tool calls with 100% progress bar", () => {
137
+ const stats = makeLocalStats();
138
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
139
+ const frame = lastFrame() ?? "";
140
+ expect(frame).toContain("25 (all local)");
141
+ expect(frame).toContain("Local rate");
142
+ });
143
+ it("shows caught section when violations exist", () => {
144
+ const stats = makeLocalStats();
145
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
146
+ const frame = lastFrame() ?? "";
147
+ expect(frame).toContain("Caught:");
148
+ expect(frame).toContain("2 convention violations before commit");
149
+ expect(frame).toContain("1 chokepoint modification");
150
+ });
151
+ it("shows Intelligence Applied section", () => {
152
+ const stats = makeLocalStats();
153
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
154
+ const frame = lastFrame() ?? "";
155
+ expect(frame).toContain("Intelligence Applied:");
156
+ expect(frame).toContain("3 blast radius computations");
157
+ expect(frame).toContain("5 community contexts injected");
158
+ expect(frame).toContain("2 correction patterns applied");
159
+ });
160
+ it("shows Token Discipline section", () => {
161
+ const stats = makeLocalStats();
162
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
163
+ const frame = lastFrame() ?? "";
164
+ expect(frame).toContain("Token Discipline:");
165
+ expect(frame).toContain("12.0k tokens saved via smart truncation");
166
+ expect(frame).toContain("4 responses budget-trimmed");
167
+ });
168
+ it("shows Semantic Intelligence when BYO-LLM used", () => {
169
+ const stats = makeLocalStats();
170
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
171
+ const frame = lastFrame() ?? "";
172
+ expect(frame).toContain("Semantic Intelligence:");
173
+ expect(frame).toContain("7 queries via local embeddings");
174
+ });
175
+ it("shows Network Isolation section with firewall sealed", () => {
176
+ const stats = makeLocalStats();
177
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
178
+ const frame = lastFrame() ?? "";
179
+ expect(frame).toContain("Network Isolation:");
180
+ expect(frame).toContain("Outbound: 0 calls (firewall sealed)");
181
+ expect(frame).toContain("Blocked attempts: 0 (clean)");
182
+ });
183
+ it("shows latency advantage when accumulated and latency samples exist", () => {
184
+ const stats = makeLocalStats();
185
+ // Populate latency samples so localP is non-null
186
+ for (let i = 0; i < 10; i++) {
187
+ stats.latency.localSamples[i] = 3.0;
188
+ }
189
+ stats.latency.localCursor = 10;
190
+ stats.latency.localTotalSamples = 10;
191
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
192
+ const frame = lastFrame() ?? "";
193
+ expect(frame).toContain("4.8s saved vs remote");
194
+ });
195
+ it("never shows dollar savings in Local Mode (TL-19)", () => {
196
+ const stats = makeLocalStats();
197
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
198
+ const frame = lastFrame() ?? "";
199
+ expect(frame).not.toContain("$");
200
+ expect(frame).not.toContain("Saved:");
201
+ });
202
+ it("never shows deep link in Local Mode", () => {
203
+ const stats = makeLocalStats();
204
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, {
205
+ stats,
206
+ deepLink: "https://app.unerr.dev/r/repo_123",
207
+ }));
208
+ const frame = lastFrame() ?? "";
209
+ expect(frame).not.toContain("Session →");
210
+ expect(frame).not.toContain("unerr.dev");
211
+ });
212
+ it("renders compact line for short sessions (<=10 calls)", () => {
213
+ const stats = makeLocalStats();
214
+ stats.toolCallsLocal = 5;
215
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
216
+ const frame = lastFrame() ?? "";
217
+ expect(frame).toContain("unerr local session:");
218
+ expect(frame).toContain("5 tool calls (all local)");
219
+ });
220
+ it("renders empty box for zero tool calls", () => {
221
+ const stats = makeLocalStats();
222
+ stats.toolCallsLocal = 0;
223
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, { stats }));
224
+ const frame = lastFrame() ?? "";
225
+ // Should be basically empty
226
+ expect(frame).not.toContain("Tool calls");
227
+ expect(frame).not.toContain("unerr local session");
228
+ });
229
+ it("shows cumulative This week line when >1 session", () => {
230
+ const stats = makeLocalStats();
231
+ const { lastFrame } = renderWithTheme(React.createElement(SessionSummaryCard, {
232
+ stats,
233
+ cumulativeLocal: {
234
+ weekStartDate: "2026-04-13",
235
+ totalSessions: 5,
236
+ totalToolCalls: 120,
237
+ totalTokensSaved: 45000,
238
+ totalViolationsCaught: 8,
239
+ totalCorrectionsApplied: 3,
240
+ totalFilesIndexed: 200,
241
+ totalSemanticSearches: 15,
242
+ avgLatencyP50: 2.1,
243
+ },
244
+ }));
245
+ const frame = lastFrame() ?? "";
246
+ expect(frame).toContain("This week:");
247
+ expect(frame).toContain("5 sessions");
248
+ expect(frame).toContain("45k tokens saved");
249
+ expect(frame).toContain("8 caught");
250
+ });
251
+ });
252
+ // ── Latency Advantage ─────────────────────────────────────────────
253
+ describe("Latency advantage (L7.3)", () => {
254
+ it("recordLatencyAdvantage accumulates correctly", () => {
255
+ const lm = createLocalModeStats();
256
+ recordLatencyAdvantage(lm, 195); // 5ms actual → 195ms saved
257
+ recordLatencyAdvantage(lm, 198); // 2ms actual → 198ms saved
258
+ expect(lm.cumulativeLatencySavedMs).toBe(393);
259
+ });
260
+ it("cumulativeLatencySavedMs starts at 0", () => {
261
+ const lm = createLocalModeStats();
262
+ expect(lm.cumulativeLatencySavedMs).toBe(0);
263
+ });
264
+ });
265
+ // ── StartupRenderer Local Mode ────────────────────────────────────
266
+ describe("StartupRenderer Local Mode (L7.4)", () => {
267
+ let tmpDir;
268
+ let origCwd;
269
+ beforeEach(() => {
270
+ tmpDir = path.join(os.tmpdir(), `unerr-l7-test-${Date.now()}`);
271
+ fs.mkdirSync(path.join(tmpDir, ".unerr", "state"), { recursive: true });
272
+ origCwd = process.cwd();
273
+ process.chdir(tmpDir);
274
+ });
275
+ afterEach(() => {
276
+ process.chdir(origCwd);
277
+ fs.rmSync(tmpDir, { recursive: true, force: true });
278
+ });
279
+ it("setLocalMode suppresses deep link in setHealth", async () => {
280
+ const { StartupRenderer } = await import("../proxy/startup-renderer.js");
281
+ const renderer = new StartupRenderer();
282
+ renderer.setLocalMode(true);
283
+ renderer.setHealth({
284
+ grade: "B",
285
+ totalEntities: 100,
286
+ totalEdges: 50,
287
+ totalRules: 5,
288
+ deadFunctionCount: 0,
289
+ highRiskEntities: [],
290
+ score: 80,
291
+ }, "repo_test");
292
+ // Access internal state to verify no deep link
293
+ // @ts-expect-error accessing private for test
294
+ expect(renderer.state.deepLink).toBeUndefined();
295
+ // @ts-expect-error accessing private for test
296
+ expect(renderer.state.localMode).toBe(true);
297
+ });
298
+ it("setLocalMode suppresses deep link in setReady", async () => {
299
+ const { StartupRenderer } = await import("../proxy/startup-renderer.js");
300
+ const renderer = new StartupRenderer();
301
+ renderer.setLocalMode(true);
302
+ // @ts-expect-error accessing private for test
303
+ renderer.repoId = "repo_test";
304
+ renderer.setReady("local");
305
+ // @ts-expect-error accessing private for test
306
+ expect(renderer.state.deepLink).toBeUndefined();
307
+ });
308
+ it("setToolCount sets the tool count", async () => {
309
+ const { StartupRenderer } = await import("../proxy/startup-renderer.js");
310
+ const renderer = new StartupRenderer();
311
+ renderer.setToolCount(11);
312
+ // @ts-expect-error accessing private for test
313
+ expect(renderer.state.toolCount).toBe(11);
314
+ });
315
+ it("setByoLlmStatus sets BYO-LLM fields", async () => {
316
+ const { StartupRenderer } = await import("../proxy/startup-renderer.js");
317
+ const renderer = new StartupRenderer();
318
+ renderer.setByoLlmStatus("connected", "ollama", "nomic-embed-text");
319
+ // @ts-expect-error accessing private for test
320
+ expect(renderer.state.byoLlmStatus).toBe("connected");
321
+ // @ts-expect-error accessing private for test
322
+ expect(renderer.state.byoLlmProvider).toBe("ollama");
323
+ // @ts-expect-error accessing private for test
324
+ expect(renderer.state.byoLlmModel).toBe("nomic-embed-text");
325
+ });
326
+ it("setLocalIndexStats sets indexing stats", async () => {
327
+ const { StartupRenderer } = await import("../proxy/startup-renderer.js");
328
+ const renderer = new StartupRenderer();
329
+ renderer.setLocalIndexStats({
330
+ fileCount: 100,
331
+ entityCount: 500,
332
+ edgeCount: 300,
333
+ indexingTimeMs: 1200,
334
+ communityCount: 12,
335
+ conventionCount: 8,
336
+ ruleCount: 5,
337
+ });
338
+ // @ts-expect-error accessing private for test
339
+ expect(renderer.state.localIndexStats?.fileCount).toBe(100);
340
+ // @ts-expect-error accessing private for test
341
+ expect(renderer.state.localIndexStats?.entityCount).toBe(500);
342
+ });
343
+ });