@nac3/forge-cli 0.2.0-alpha.9 → 1.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 (1157) hide show
  1. package/README.md +21 -2
  2. package/dist/a11y/helpers.d.ts +88 -0
  3. package/dist/a11y/helpers.d.ts.map +1 -0
  4. package/dist/a11y/helpers.js +109 -0
  5. package/dist/a11y/helpers.js.map +1 -0
  6. package/dist/agents/bridge.d.ts +69 -0
  7. package/dist/agents/bridge.d.ts.map +1 -0
  8. package/dist/agents/bridge.js +322 -0
  9. package/dist/agents/bridge.js.map +1 -0
  10. package/dist/agents/cli_real.d.ts +38 -0
  11. package/dist/agents/cli_real.d.ts.map +1 -0
  12. package/dist/agents/cli_real.js +46 -0
  13. package/dist/agents/cli_real.js.map +1 -0
  14. package/dist/agents/config_resolver.d.ts +16 -0
  15. package/dist/agents/config_resolver.d.ts.map +1 -0
  16. package/dist/agents/config_resolver.js +133 -0
  17. package/dist/agents/config_resolver.js.map +1 -0
  18. package/dist/agents/config_schema.d.ts +42 -0
  19. package/dist/agents/config_schema.d.ts.map +1 -0
  20. package/dist/agents/config_schema.js +220 -0
  21. package/dist/agents/config_schema.js.map +1 -0
  22. package/dist/agents/defaults.d.ts +21 -0
  23. package/dist/agents/defaults.d.ts.map +1 -0
  24. package/dist/agents/defaults.js +56 -0
  25. package/dist/agents/defaults.js.map +1 -0
  26. package/dist/agents/delegate.d.ts +36 -0
  27. package/dist/agents/delegate.d.ts.map +1 -0
  28. package/dist/agents/delegate.js +68 -0
  29. package/dist/agents/delegate.js.map +1 -0
  30. package/dist/agents/iterative_step.d.ts +95 -0
  31. package/dist/agents/iterative_step.d.ts.map +1 -0
  32. package/dist/agents/iterative_step.js +249 -0
  33. package/dist/agents/iterative_step.js.map +1 -0
  34. package/dist/agents/llm_step.d.ts +50 -0
  35. package/dist/agents/llm_step.d.ts.map +1 -0
  36. package/dist/agents/llm_step.js +28 -0
  37. package/dist/agents/llm_step.js.map +1 -0
  38. package/dist/agents/real_step_factory.d.ts +95 -0
  39. package/dist/agents/real_step_factory.d.ts.map +1 -0
  40. package/dist/agents/real_step_factory.js +51 -0
  41. package/dist/agents/real_step_factory.js.map +1 -0
  42. package/dist/agents/runner.d.ts +116 -0
  43. package/dist/agents/runner.d.ts.map +1 -0
  44. package/dist/agents/runner.js +221 -0
  45. package/dist/agents/runner.js.map +1 -0
  46. package/dist/agents/runtime.d.ts +115 -0
  47. package/dist/agents/runtime.d.ts.map +1 -0
  48. package/dist/agents/runtime.js +429 -0
  49. package/dist/agents/runtime.js.map +1 -0
  50. package/dist/agents/store.d.ts +33 -0
  51. package/dist/agents/store.d.ts.map +1 -0
  52. package/dist/agents/store.js +210 -0
  53. package/dist/agents/store.js.map +1 -0
  54. package/dist/agents/system_prompt.d.ts +36 -0
  55. package/dist/agents/system_prompt.d.ts.map +1 -0
  56. package/dist/agents/system_prompt.js +102 -0
  57. package/dist/agents/system_prompt.js.map +1 -0
  58. package/dist/agents/types.d.ts +123 -0
  59. package/dist/agents/types.d.ts.map +1 -0
  60. package/dist/agents/types.js +39 -0
  61. package/dist/agents/types.js.map +1 -0
  62. package/dist/bin/yf.d.ts.map +1 -1
  63. package/dist/bin/yf.js +119 -2
  64. package/dist/bin/yf.js.map +1 -1
  65. package/dist/chat/claude.d.ts +102 -1
  66. package/dist/chat/claude.d.ts.map +1 -1
  67. package/dist/chat/claude.js +215 -40
  68. package/dist/chat/claude.js.map +1 -1
  69. package/dist/chat/claude_cli.d.ts +155 -0
  70. package/dist/chat/claude_cli.d.ts.map +1 -0
  71. package/dist/chat/claude_cli.js +679 -0
  72. package/dist/chat/claude_cli.js.map +1 -0
  73. package/dist/chat/completion_hallucination_detector.d.ts +51 -0
  74. package/dist/chat/completion_hallucination_detector.d.ts.map +1 -0
  75. package/dist/chat/completion_hallucination_detector.js +131 -0
  76. package/dist/chat/completion_hallucination_detector.js.map +1 -0
  77. package/dist/chat/doctrine_digest.d.ts +31 -0
  78. package/dist/chat/doctrine_digest.d.ts.map +1 -0
  79. package/dist/chat/doctrine_digest.js +121 -0
  80. package/dist/chat/doctrine_digest.js.map +1 -0
  81. package/dist/chat/graph_auto_ingest.d.ts +46 -0
  82. package/dist/chat/graph_auto_ingest.d.ts.map +1 -0
  83. package/dist/chat/graph_auto_ingest.js +177 -0
  84. package/dist/chat/graph_auto_ingest.js.map +1 -0
  85. package/dist/chat/graph_component_watcher.d.ts +34 -0
  86. package/dist/chat/graph_component_watcher.d.ts.map +1 -0
  87. package/dist/chat/graph_component_watcher.js +225 -0
  88. package/dist/chat/graph_component_watcher.js.map +1 -0
  89. package/dist/chat/graph_snapshot.d.ts +38 -0
  90. package/dist/chat/graph_snapshot.d.ts.map +1 -0
  91. package/dist/chat/graph_snapshot.js +159 -0
  92. package/dist/chat/graph_snapshot.js.map +1 -0
  93. package/dist/chat/ingest_session.d.ts +24 -4
  94. package/dist/chat/ingest_session.d.ts.map +1 -1
  95. package/dist/chat/ingest_session.js +143 -4
  96. package/dist/chat/ingest_session.js.map +1 -1
  97. package/dist/chat/panel.d.ts.map +1 -1
  98. package/dist/chat/panel.js +10483 -1455
  99. package/dist/chat/panel.js.map +1 -1
  100. package/dist/chat/panel_queue.d.ts +43 -0
  101. package/dist/chat/panel_queue.d.ts.map +1 -0
  102. package/dist/chat/panel_queue.js +46 -0
  103. package/dist/chat/panel_queue.js.map +1 -0
  104. package/dist/chat/project_context_inject.d.ts +10 -0
  105. package/dist/chat/project_context_inject.d.ts.map +1 -0
  106. package/dist/chat/project_context_inject.js +119 -0
  107. package/dist/chat/project_context_inject.js.map +1 -0
  108. package/dist/chat/project_slug.d.ts +17 -0
  109. package/dist/chat/project_slug.d.ts.map +1 -0
  110. package/dist/chat/project_slug.js +103 -0
  111. package/dist/chat/project_slug.js.map +1 -0
  112. package/dist/chat/refusal_detector.d.ts +14 -0
  113. package/dist/chat/refusal_detector.d.ts.map +1 -0
  114. package/dist/chat/refusal_detector.js +139 -0
  115. package/dist/chat/refusal_detector.js.map +1 -0
  116. package/dist/chat/semantic_graph_ingest.d.ts +39 -0
  117. package/dist/chat/semantic_graph_ingest.d.ts.map +1 -0
  118. package/dist/chat/semantic_graph_ingest.js +90 -0
  119. package/dist/chat/semantic_graph_ingest.js.map +1 -0
  120. package/dist/chat/semantic_graph_inject.d.ts +31 -0
  121. package/dist/chat/semantic_graph_inject.d.ts.map +1 -0
  122. package/dist/chat/semantic_graph_inject.js +63 -0
  123. package/dist/chat/semantic_graph_inject.js.map +1 -0
  124. package/dist/chat/server.d.ts +99 -2
  125. package/dist/chat/server.d.ts.map +1 -1
  126. package/dist/chat/server.js +4613 -452
  127. package/dist/chat/server.js.map +1 -1
  128. package/dist/chat/session_projects.d.ts +31 -0
  129. package/dist/chat/session_projects.d.ts.map +1 -0
  130. package/dist/chat/session_projects.js +36 -0
  131. package/dist/chat/session_projects.js.map +1 -0
  132. package/dist/chat/session_store.d.ts +32 -0
  133. package/dist/chat/session_store.d.ts.map +1 -0
  134. package/dist/chat/session_store.js +58 -0
  135. package/dist/chat/session_store.js.map +1 -0
  136. package/dist/chat/spec_extract.d.ts +1 -2
  137. package/dist/chat/spec_extract.d.ts.map +1 -1
  138. package/dist/chat/spec_extract.js +41 -56
  139. package/dist/chat/spec_extract.js.map +1 -1
  140. package/dist/chat/spec_plan.d.ts +1 -2
  141. package/dist/chat/spec_plan.d.ts.map +1 -1
  142. package/dist/chat/spec_plan.js +36 -57
  143. package/dist/chat/spec_plan.js.map +1 -1
  144. package/dist/chat/tooling_section.d.ts +11 -0
  145. package/dist/chat/tooling_section.d.ts.map +1 -0
  146. package/dist/chat/tooling_section.js +70 -0
  147. package/dist/chat/tooling_section.js.map +1 -0
  148. package/dist/chat/tools/app_backend_dispatch.d.ts +39 -0
  149. package/dist/chat/tools/app_backend_dispatch.d.ts.map +1 -0
  150. package/dist/chat/tools/app_backend_dispatch.js +282 -0
  151. package/dist/chat/tools/app_backend_dispatch.js.map +1 -0
  152. package/dist/chat/tools/fs_editor.d.ts +11 -0
  153. package/dist/chat/tools/fs_editor.d.ts.map +1 -0
  154. package/dist/chat/tools/fs_editor.js +212 -0
  155. package/dist/chat/tools/fs_editor.js.map +1 -0
  156. package/dist/chat/tools/git.d.ts +24 -0
  157. package/dist/chat/tools/git.d.ts.map +1 -1
  158. package/dist/chat/tools/git.js +78 -0
  159. package/dist/chat/tools/git.js.map +1 -1
  160. package/dist/chat/tools/graph.d.ts +43 -0
  161. package/dist/chat/tools/graph.d.ts.map +1 -0
  162. package/dist/chat/tools/graph.js +174 -0
  163. package/dist/chat/tools/graph.js.map +1 -0
  164. package/dist/chat/tools/keys.d.ts +9 -0
  165. package/dist/chat/tools/keys.d.ts.map +1 -0
  166. package/dist/chat/tools/keys.js +156 -0
  167. package/dist/chat/tools/keys.js.map +1 -0
  168. package/dist/chat/tools/misc_verbs.d.ts +36 -0
  169. package/dist/chat/tools/misc_verbs.d.ts.map +1 -0
  170. package/dist/chat/tools/misc_verbs.js +405 -0
  171. package/dist/chat/tools/misc_verbs.js.map +1 -0
  172. package/dist/chat/tools/nac3_invoke.d.ts +58 -0
  173. package/dist/chat/tools/nac3_invoke.d.ts.map +1 -0
  174. package/dist/chat/tools/nac3_invoke.js +896 -0
  175. package/dist/chat/tools/nac3_invoke.js.map +1 -0
  176. package/dist/chat/tools/pending.d.ts +69 -0
  177. package/dist/chat/tools/pending.d.ts.map +1 -0
  178. package/dist/chat/tools/pending.js +167 -0
  179. package/dist/chat/tools/pending.js.map +1 -0
  180. package/dist/chat/tools/pizarron.d.ts +40 -0
  181. package/dist/chat/tools/pizarron.d.ts.map +1 -0
  182. package/dist/chat/tools/pizarron.js +123 -0
  183. package/dist/chat/tools/pizarron.js.map +1 -0
  184. package/dist/chat/tools/project_lifecycle.d.ts +24 -0
  185. package/dist/chat/tools/project_lifecycle.d.ts.map +1 -0
  186. package/dist/chat/tools/project_lifecycle.js +212 -0
  187. package/dist/chat/tools/project_lifecycle.js.map +1 -0
  188. package/dist/chat/tools/reader.d.ts.map +1 -1
  189. package/dist/chat/tools/reader.js +144 -1
  190. package/dist/chat/tools/reader.js.map +1 -1
  191. package/dist/chat/tools/shell.d.ts +64 -0
  192. package/dist/chat/tools/shell.d.ts.map +1 -0
  193. package/dist/chat/tools/shell.js +292 -0
  194. package/dist/chat/tools/shell.js.map +1 -0
  195. package/dist/chat/tools/wiring.d.ts +28 -0
  196. package/dist/chat/tools/wiring.d.ts.map +1 -0
  197. package/dist/chat/tools/wiring.js +116 -0
  198. package/dist/chat/tools/wiring.js.map +1 -0
  199. package/dist/chat/tools/workflow.d.ts +75 -0
  200. package/dist/chat/tools/workflow.d.ts.map +1 -0
  201. package/dist/chat/tools/workflow.js +561 -0
  202. package/dist/chat/tools/workflow.js.map +1 -0
  203. package/dist/chat/tools.d.ts +42 -0
  204. package/dist/chat/tools.d.ts.map +1 -1
  205. package/dist/chat/tools.js +525 -16
  206. package/dist/chat/tools.js.map +1 -1
  207. package/dist/chat/turn_control.d.ts +42 -0
  208. package/dist/chat/turn_control.d.ts.map +1 -0
  209. package/dist/chat/turn_control.js +53 -0
  210. package/dist/chat/turn_control.js.map +1 -0
  211. package/dist/chat/wiring_inject.d.ts +18 -0
  212. package/dist/chat/wiring_inject.d.ts.map +1 -0
  213. package/dist/chat/wiring_inject.js +78 -0
  214. package/dist/chat/wiring_inject.js.map +1 -0
  215. package/dist/chat/workflow_inject.d.ts +52 -0
  216. package/dist/chat/workflow_inject.d.ts.map +1 -0
  217. package/dist/chat/workflow_inject.js +346 -0
  218. package/dist/chat/workflow_inject.js.map +1 -0
  219. package/dist/chat/yujin_splash.d.ts +27 -0
  220. package/dist/chat/yujin_splash.d.ts.map +1 -0
  221. package/dist/chat/yujin_splash.js +147 -0
  222. package/dist/chat/yujin_splash.js.map +1 -0
  223. package/dist/commands/agent.d.ts +33 -0
  224. package/dist/commands/agent.d.ts.map +1 -0
  225. package/dist/commands/agent.js +281 -0
  226. package/dist/commands/agent.js.map +1 -0
  227. package/dist/commands/approve.d.ts +32 -0
  228. package/dist/commands/approve.d.ts.map +1 -0
  229. package/dist/commands/approve.js +198 -0
  230. package/dist/commands/approve.js.map +1 -0
  231. package/dist/commands/block.d.ts +28 -0
  232. package/dist/commands/block.d.ts.map +1 -0
  233. package/dist/commands/block.js +189 -0
  234. package/dist/commands/block.js.map +1 -0
  235. package/dist/commands/bootstrap.d.ts +35 -0
  236. package/dist/commands/bootstrap.d.ts.map +1 -0
  237. package/dist/commands/bootstrap.js +205 -0
  238. package/dist/commands/bootstrap.js.map +1 -0
  239. package/dist/commands/brain.d.ts +17 -0
  240. package/dist/commands/brain.d.ts.map +1 -0
  241. package/dist/commands/brain.js +129 -0
  242. package/dist/commands/brain.js.map +1 -0
  243. package/dist/commands/chat.d.ts +10 -0
  244. package/dist/commands/chat.d.ts.map +1 -1
  245. package/dist/commands/chat.js +265 -22
  246. package/dist/commands/chat.js.map +1 -1
  247. package/dist/commands/clarify.d.ts +30 -0
  248. package/dist/commands/clarify.d.ts.map +1 -0
  249. package/dist/commands/clarify.js +671 -0
  250. package/dist/commands/clarify.js.map +1 -0
  251. package/dist/commands/director.d.ts +37 -0
  252. package/dist/commands/director.d.ts.map +1 -0
  253. package/dist/commands/director.js +290 -0
  254. package/dist/commands/director.js.map +1 -0
  255. package/dist/commands/discover.d.ts +30 -0
  256. package/dist/commands/discover.d.ts.map +1 -0
  257. package/dist/commands/discover.js +178 -0
  258. package/dist/commands/discover.js.map +1 -0
  259. package/dist/commands/doctor.d.ts +18 -0
  260. package/dist/commands/doctor.d.ts.map +1 -1
  261. package/dist/commands/doctor.js +120 -4
  262. package/dist/commands/doctor.js.map +1 -1
  263. package/dist/commands/doctrine.d.ts +24 -0
  264. package/dist/commands/doctrine.d.ts.map +1 -0
  265. package/dist/commands/doctrine.js +106 -0
  266. package/dist/commands/doctrine.js.map +1 -0
  267. package/dist/commands/doctrines.d.ts +21 -0
  268. package/dist/commands/doctrines.d.ts.map +1 -0
  269. package/dist/commands/doctrines.js +158 -0
  270. package/dist/commands/doctrines.js.map +1 -0
  271. package/dist/commands/graph.d.ts +29 -0
  272. package/dist/commands/graph.d.ts.map +1 -0
  273. package/dist/commands/graph.js +362 -0
  274. package/dist/commands/graph.js.map +1 -0
  275. package/dist/commands/keys_setup.d.ts +11 -11
  276. package/dist/commands/keys_setup.d.ts.map +1 -1
  277. package/dist/commands/keys_setup.js +149 -109
  278. package/dist/commands/keys_setup.js.map +1 -1
  279. package/dist/commands/legacy-audit.d.ts +34 -0
  280. package/dist/commands/legacy-audit.d.ts.map +1 -0
  281. package/dist/commands/legacy-audit.js +270 -0
  282. package/dist/commands/legacy-audit.js.map +1 -0
  283. package/dist/commands/lessons.d.ts +28 -0
  284. package/dist/commands/lessons.d.ts.map +1 -0
  285. package/dist/commands/lessons.js +309 -0
  286. package/dist/commands/lessons.js.map +1 -0
  287. package/dist/commands/license.d.ts.map +1 -1
  288. package/dist/commands/license.js +94 -15
  289. package/dist/commands/license.js.map +1 -1
  290. package/dist/commands/limits.d.ts +15 -0
  291. package/dist/commands/limits.d.ts.map +1 -0
  292. package/dist/commands/limits.js +51 -0
  293. package/dist/commands/limits.js.map +1 -0
  294. package/dist/commands/manifest-cli.d.ts +12 -0
  295. package/dist/commands/manifest-cli.d.ts.map +1 -0
  296. package/dist/commands/manifest-cli.js +42 -0
  297. package/dist/commands/manifest-cli.js.map +1 -0
  298. package/dist/commands/mcp.d.ts +24 -0
  299. package/dist/commands/mcp.d.ts.map +1 -0
  300. package/dist/commands/mcp.js +219 -0
  301. package/dist/commands/mcp.js.map +1 -0
  302. package/dist/commands/mobile.d.ts +15 -0
  303. package/dist/commands/mobile.d.ts.map +1 -1
  304. package/dist/commands/mobile.js +50 -43
  305. package/dist/commands/mobile.js.map +1 -1
  306. package/dist/commands/nac3.d.ts +22 -0
  307. package/dist/commands/nac3.d.ts.map +1 -0
  308. package/dist/commands/nac3.js +125 -0
  309. package/dist/commands/nac3.js.map +1 -0
  310. package/dist/commands/onboard.d.ts +19 -0
  311. package/dist/commands/onboard.d.ts.map +1 -0
  312. package/dist/commands/onboard.js +126 -0
  313. package/dist/commands/onboard.js.map +1 -0
  314. package/dist/commands/operate.d.ts +22 -0
  315. package/dist/commands/operate.d.ts.map +1 -0
  316. package/dist/commands/operate.js +523 -0
  317. package/dist/commands/operate.js.map +1 -0
  318. package/dist/commands/pending.d.ts +22 -0
  319. package/dist/commands/pending.d.ts.map +1 -0
  320. package/dist/commands/pending.js +365 -0
  321. package/dist/commands/pending.js.map +1 -0
  322. package/dist/commands/projects.js +25 -1
  323. package/dist/commands/projects.js.map +1 -1
  324. package/dist/commands/qa.d.ts +24 -0
  325. package/dist/commands/qa.d.ts.map +1 -0
  326. package/dist/commands/qa.js +349 -0
  327. package/dist/commands/qa.js.map +1 -0
  328. package/dist/commands/review-screens.js +28 -1
  329. package/dist/commands/review-screens.js.map +1 -1
  330. package/dist/commands/spec.d.ts +38 -0
  331. package/dist/commands/spec.d.ts.map +1 -0
  332. package/dist/commands/spec.js +256 -0
  333. package/dist/commands/spec.js.map +1 -0
  334. package/dist/commands/support.d.ts +22 -0
  335. package/dist/commands/support.d.ts.map +1 -0
  336. package/dist/commands/support.js +165 -0
  337. package/dist/commands/support.js.map +1 -0
  338. package/dist/commands/test_agent.d.ts +22 -0
  339. package/dist/commands/test_agent.d.ts.map +1 -0
  340. package/dist/commands/test_agent.js +100 -0
  341. package/dist/commands/test_agent.js.map +1 -0
  342. package/dist/commands/triage.d.ts +34 -0
  343. package/dist/commands/triage.d.ts.map +1 -0
  344. package/dist/commands/triage.js +228 -0
  345. package/dist/commands/triage.js.map +1 -0
  346. package/dist/commands/vault-inventory.d.ts +30 -0
  347. package/dist/commands/vault-inventory.d.ts.map +1 -0
  348. package/dist/commands/vault-inventory.js +222 -0
  349. package/dist/commands/vault-inventory.js.map +1 -0
  350. package/dist/commands/vault.d.ts.map +1 -1
  351. package/dist/commands/vault.js +5 -0
  352. package/dist/commands/vault.js.map +1 -1
  353. package/dist/commands/voice.d.ts.map +1 -1
  354. package/dist/commands/voice.js +47 -4
  355. package/dist/commands/voice.js.map +1 -1
  356. package/dist/commands/wiring.d.ts +19 -0
  357. package/dist/commands/wiring.d.ts.map +1 -0
  358. package/dist/commands/wiring.js +135 -0
  359. package/dist/commands/wiring.js.map +1 -0
  360. package/dist/commands/workflow-coverage.d.ts +30 -0
  361. package/dist/commands/workflow-coverage.d.ts.map +1 -0
  362. package/dist/commands/workflow-coverage.js +138 -0
  363. package/dist/commands/workflow-coverage.js.map +1 -0
  364. package/dist/commands/workflow.d.ts +18 -0
  365. package/dist/commands/workflow.d.ts.map +1 -0
  366. package/dist/commands/workflow.js +253 -0
  367. package/dist/commands/workflow.js.map +1 -0
  368. package/dist/core/ansi_strip.d.ts +39 -0
  369. package/dist/core/ansi_strip.d.ts.map +1 -0
  370. package/dist/core/ansi_strip.js +71 -0
  371. package/dist/core/ansi_strip.js.map +1 -0
  372. package/dist/core/atomic_write.d.ts +17 -0
  373. package/dist/core/atomic_write.d.ts.map +1 -0
  374. package/dist/core/atomic_write.js +51 -0
  375. package/dist/core/atomic_write.js.map +1 -0
  376. package/dist/core/audit_log.d.ts +43 -0
  377. package/dist/core/audit_log.d.ts.map +1 -0
  378. package/dist/core/audit_log.js +80 -0
  379. package/dist/core/audit_log.js.map +1 -0
  380. package/dist/core/brain_config.d.ts +52 -0
  381. package/dist/core/brain_config.d.ts.map +1 -0
  382. package/dist/core/brain_config.js +157 -0
  383. package/dist/core/brain_config.js.map +1 -0
  384. package/dist/core/budget.d.ts +96 -0
  385. package/dist/core/budget.d.ts.map +1 -0
  386. package/dist/core/budget.js +328 -0
  387. package/dist/core/budget.js.map +1 -0
  388. package/dist/core/cf_tunnel.d.ts.map +1 -1
  389. package/dist/core/cf_tunnel.js +8 -2
  390. package/dist/core/cf_tunnel.js.map +1 -1
  391. package/dist/core/cost_meter.d.ts +35 -0
  392. package/dist/core/cost_meter.d.ts.map +1 -0
  393. package/dist/core/cost_meter.js +111 -0
  394. package/dist/core/cost_meter.js.map +1 -0
  395. package/dist/core/cost_router.d.ts +106 -0
  396. package/dist/core/cost_router.d.ts.map +1 -0
  397. package/dist/core/cost_router.js +598 -0
  398. package/dist/core/cost_router.js.map +1 -0
  399. package/dist/core/desktop_open.d.ts +16 -0
  400. package/dist/core/desktop_open.d.ts.map +1 -0
  401. package/dist/core/desktop_open.js +114 -0
  402. package/dist/core/desktop_open.js.map +1 -0
  403. package/dist/core/doctrine_resolver.d.ts +23 -0
  404. package/dist/core/doctrine_resolver.d.ts.map +1 -0
  405. package/dist/core/doctrine_resolver.js +108 -0
  406. package/dist/core/doctrine_resolver.js.map +1 -0
  407. package/dist/core/error_catalog.d.ts +80 -0
  408. package/dist/core/error_catalog.d.ts.map +1 -0
  409. package/dist/core/error_catalog.js +168 -0
  410. package/dist/core/error_catalog.js.map +1 -0
  411. package/dist/core/error_formatter.d.ts +30 -0
  412. package/dist/core/error_formatter.d.ts.map +1 -0
  413. package/dist/core/error_formatter.js +155 -0
  414. package/dist/core/error_formatter.js.map +1 -0
  415. package/dist/core/incomplete_detector.d.ts +51 -0
  416. package/dist/core/incomplete_detector.d.ts.map +1 -0
  417. package/dist/core/incomplete_detector.js +140 -0
  418. package/dist/core/incomplete_detector.js.map +1 -0
  419. package/dist/core/keys_envelope.d.ts.map +1 -1
  420. package/dist/core/keys_envelope.js +19 -10
  421. package/dist/core/keys_envelope.js.map +1 -1
  422. package/dist/core/learnings_client.d.ts +104 -0
  423. package/dist/core/learnings_client.d.ts.map +1 -0
  424. package/dist/core/learnings_client.js +262 -0
  425. package/dist/core/learnings_client.js.map +1 -0
  426. package/dist/core/limits_config.d.ts +81 -0
  427. package/dist/core/limits_config.d.ts.map +1 -0
  428. package/dist/core/limits_config.js +302 -0
  429. package/dist/core/limits_config.js.map +1 -0
  430. package/dist/core/logger.d.ts.map +1 -1
  431. package/dist/core/logger.js +3 -0
  432. package/dist/core/logger.js.map +1 -1
  433. package/dist/core/pairing.d.ts +7 -0
  434. package/dist/core/pairing.d.ts.map +1 -1
  435. package/dist/core/pairing.js +64 -14
  436. package/dist/core/pairing.js.map +1 -1
  437. package/dist/core/pilot_setup.d.ts +29 -3
  438. package/dist/core/pilot_setup.d.ts.map +1 -1
  439. package/dist/core/pilot_setup.js +130 -3
  440. package/dist/core/pilot_setup.js.map +1 -1
  441. package/dist/core/provider_keys.d.ts +35 -0
  442. package/dist/core/provider_keys.d.ts.map +1 -0
  443. package/dist/core/provider_keys.js +280 -0
  444. package/dist/core/provider_keys.js.map +1 -0
  445. package/dist/core/provider_models.d.ts +27 -0
  446. package/dist/core/provider_models.d.ts.map +1 -0
  447. package/dist/core/provider_models.js +169 -0
  448. package/dist/core/provider_models.js.map +1 -0
  449. package/dist/core/reasoning_gate.d.ts +72 -0
  450. package/dist/core/reasoning_gate.d.ts.map +1 -0
  451. package/dist/core/reasoning_gate.js +205 -0
  452. package/dist/core/reasoning_gate.js.map +1 -0
  453. package/dist/core/shell_classifier.d.ts +49 -0
  454. package/dist/core/shell_classifier.d.ts.map +1 -0
  455. package/dist/core/shell_classifier.js +159 -0
  456. package/dist/core/shell_classifier.js.map +1 -0
  457. package/dist/core/sq_resolver.d.ts +14 -0
  458. package/dist/core/sq_resolver.d.ts.map +1 -0
  459. package/dist/core/sq_resolver.js +230 -0
  460. package/dist/core/sq_resolver.js.map +1 -0
  461. package/dist/core/truncation_detector.d.ts +68 -0
  462. package/dist/core/truncation_detector.d.ts.map +1 -0
  463. package/dist/core/truncation_detector.js +115 -0
  464. package/dist/core/truncation_detector.js.map +1 -0
  465. package/dist/core/turn_classifier.d.ts +70 -0
  466. package/dist/core/turn_classifier.d.ts.map +1 -0
  467. package/dist/core/turn_classifier.js +324 -0
  468. package/dist/core/turn_classifier.js.map +1 -0
  469. package/dist/core/vad_config.d.ts +34 -0
  470. package/dist/core/vad_config.d.ts.map +1 -0
  471. package/dist/core/vad_config.js +95 -0
  472. package/dist/core/vad_config.js.map +1 -0
  473. package/dist/core/whats_new.d.ts +42 -0
  474. package/dist/core/whats_new.d.ts.map +1 -0
  475. package/dist/core/whats_new.js +214 -0
  476. package/dist/core/whats_new.js.map +1 -0
  477. package/dist/core/wizard_state.d.ts +15 -0
  478. package/dist/core/wizard_state.d.ts.map +1 -0
  479. package/dist/core/wizard_state.js +86 -0
  480. package/dist/core/wizard_state.js.map +1 -0
  481. package/dist/deploy/adapter.d.ts +93 -0
  482. package/dist/deploy/adapter.d.ts.map +1 -0
  483. package/dist/deploy/adapter.js +42 -0
  484. package/dist/deploy/adapter.js.map +1 -0
  485. package/dist/deploy/aws_adapter.d.ts +28 -0
  486. package/dist/deploy/aws_adapter.d.ts.map +1 -0
  487. package/dist/deploy/aws_adapter.js +98 -0
  488. package/dist/deploy/aws_adapter.js.map +1 -0
  489. package/dist/deploy/cloudflare.d.ts +24 -0
  490. package/dist/deploy/cloudflare.d.ts.map +1 -0
  491. package/dist/deploy/cloudflare.js +180 -0
  492. package/dist/deploy/cloudflare.js.map +1 -0
  493. package/dist/design/yujin_design_resolver.d.ts +93 -0
  494. package/dist/design/yujin_design_resolver.d.ts.map +1 -0
  495. package/dist/design/yujin_design_resolver.js +196 -0
  496. package/dist/design/yujin_design_resolver.js.map +1 -0
  497. package/dist/docs/LIMITED_RESPONSIBILITY.md +216 -0
  498. package/dist/docs/PRIVACY_POLICY.md +169 -0
  499. package/dist/docs/SQ.md +1397 -0
  500. package/dist/docs/SQ_BY_STEP.yaml +147 -0
  501. package/dist/docs/doctrine/accessibility.md +78 -0
  502. package/dist/docs/doctrine/agent-orchestrator.md +76 -0
  503. package/dist/docs/doctrine/byok-vs-managed.md +81 -0
  504. package/dist/docs/doctrine/cost-router-escalation.md +103 -0
  505. package/dist/docs/doctrine/default-design-system.md +152 -0
  506. package/dist/docs/doctrine/explain-results.md +90 -0
  507. package/dist/docs/doctrine/expo-eas-builds.md +177 -0
  508. package/dist/docs/doctrine/g-doc.md +46 -0
  509. package/dist/docs/doctrine/gates.md +21 -0
  510. package/dist/docs/doctrine/language-sovereignty.md +143 -0
  511. package/dist/docs/doctrine/lessons-workflow.md +68 -0
  512. package/dist/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  513. package/dist/docs/doctrine/nac3-attrs.md +23 -0
  514. package/dist/docs/doctrine/office-tools.md +122 -0
  515. package/dist/docs/doctrine/pizarron.md +52 -0
  516. package/dist/docs/doctrine/r8-modal.md +60 -0
  517. package/dist/docs/doctrine/safety-refusals.md +73 -0
  518. package/dist/docs/doctrine/testing-policy.md +211 -0
  519. package/dist/docs/doctrine/verb-composition.md +84 -0
  520. package/dist/docs/doctrine/verification-honesty.md +95 -0
  521. package/dist/docs/doctrine/workflow-kinds.md +69 -0
  522. package/dist/docs/doctrine/workflow-phases.md +108 -0
  523. package/dist/docs/doctrine/workflow.md +66 -0
  524. package/dist/docs/doctrine/yf-commands.md +49 -0
  525. package/dist/json/query.d.ts +38 -0
  526. package/dist/json/query.d.ts.map +1 -0
  527. package/dist/json/query.js +177 -0
  528. package/dist/json/query.js.map +1 -0
  529. package/dist/license/auto_sync.d.ts +22 -0
  530. package/dist/license/auto_sync.d.ts.map +1 -0
  531. package/dist/license/auto_sync.js +91 -0
  532. package/dist/license/auto_sync.js.map +1 -0
  533. package/dist/license/handle_key.d.ts +32 -0
  534. package/dist/license/handle_key.d.ts.map +1 -0
  535. package/dist/license/handle_key.js +56 -0
  536. package/dist/license/handle_key.js.map +1 -0
  537. package/dist/license/hito4_client.d.ts +7 -0
  538. package/dist/license/hito4_client.d.ts.map +1 -1
  539. package/dist/license/hito4_client.js +113 -25
  540. package/dist/license/hito4_client.js.map +1 -1
  541. package/dist/license/sync.d.ts +59 -0
  542. package/dist/license/sync.d.ts.map +1 -0
  543. package/dist/license/sync.js +148 -0
  544. package/dist/license/sync.js.map +1 -0
  545. package/dist/llm/cohere_client.d.ts +81 -0
  546. package/dist/llm/cohere_client.d.ts.map +1 -0
  547. package/dist/llm/cohere_client.js +195 -0
  548. package/dist/llm/cohere_client.js.map +1 -0
  549. package/dist/llm/deepseek_client.d.ts +63 -0
  550. package/dist/llm/deepseek_client.d.ts.map +1 -0
  551. package/dist/llm/deepseek_client.js +188 -0
  552. package/dist/llm/deepseek_client.js.map +1 -0
  553. package/dist/llm/gemini_client.d.ts +78 -0
  554. package/dist/llm/gemini_client.d.ts.map +1 -0
  555. package/dist/llm/gemini_client.js +192 -0
  556. package/dist/llm/gemini_client.js.map +1 -0
  557. package/dist/llm/managed_client.d.ts +70 -0
  558. package/dist/llm/managed_client.d.ts.map +1 -0
  559. package/dist/llm/managed_client.js +256 -0
  560. package/dist/llm/managed_client.js.map +1 -0
  561. package/dist/llm/mistral_client.d.ts +54 -0
  562. package/dist/llm/mistral_client.d.ts.map +1 -0
  563. package/dist/llm/mistral_client.js +174 -0
  564. package/dist/llm/mistral_client.js.map +1 -0
  565. package/dist/llm/multi_provider_client.d.ts +57 -0
  566. package/dist/llm/multi_provider_client.d.ts.map +1 -0
  567. package/dist/llm/multi_provider_client.js +109 -0
  568. package/dist/llm/multi_provider_client.js.map +1 -0
  569. package/dist/llm/openai_client.d.ts +77 -0
  570. package/dist/llm/openai_client.d.ts.map +1 -0
  571. package/dist/llm/openai_client.js +200 -0
  572. package/dist/llm/openai_client.js.map +1 -0
  573. package/dist/llm/xai_client.d.ts +51 -0
  574. package/dist/llm/xai_client.d.ts.map +1 -0
  575. package/dist/llm/xai_client.js +174 -0
  576. package/dist/llm/xai_client.js.map +1 -0
  577. package/dist/mcp/blocklist.d.ts +19 -0
  578. package/dist/mcp/blocklist.d.ts.map +1 -0
  579. package/dist/mcp/blocklist.js +118 -0
  580. package/dist/mcp/blocklist.js.map +1 -0
  581. package/dist/mcp/bridge_registry.d.ts +77 -0
  582. package/dist/mcp/bridge_registry.d.ts.map +1 -0
  583. package/dist/mcp/bridge_registry.js +220 -0
  584. package/dist/mcp/bridge_registry.js.map +1 -0
  585. package/dist/mcp/config.d.ts +25 -0
  586. package/dist/mcp/config.d.ts.map +1 -0
  587. package/dist/mcp/config.js +116 -0
  588. package/dist/mcp/config.js.map +1 -0
  589. package/dist/mcp/forge_panel_server.d.ts +46 -0
  590. package/dist/mcp/forge_panel_server.d.ts.map +1 -0
  591. package/dist/mcp/forge_panel_server.js +166 -0
  592. package/dist/mcp/forge_panel_server.js.map +1 -0
  593. package/dist/mcp/lan_scan.d.ts +36 -0
  594. package/dist/mcp/lan_scan.d.ts.map +1 -0
  595. package/dist/mcp/lan_scan.js +130 -0
  596. package/dist/mcp/lan_scan.js.map +1 -0
  597. package/dist/mcp/plan_bridges.d.ts +17 -0
  598. package/dist/mcp/plan_bridges.d.ts.map +1 -0
  599. package/dist/mcp/plan_bridges.js +119 -0
  600. package/dist/mcp/plan_bridges.js.map +1 -0
  601. package/dist/mcp/protocol_client.d.ts +63 -0
  602. package/dist/mcp/protocol_client.d.ts.map +1 -0
  603. package/dist/mcp/protocol_client.js +340 -0
  604. package/dist/mcp/protocol_client.js.map +1 -0
  605. package/dist/mcp/state.d.ts +38 -0
  606. package/dist/mcp/state.d.ts.map +1 -0
  607. package/dist/mcp/state.js +144 -0
  608. package/dist/mcp/state.js.map +1 -0
  609. package/dist/migrate/ai-apply.d.ts.map +1 -1
  610. package/dist/migrate/ai-apply.js +25 -2
  611. package/dist/migrate/ai-apply.js.map +1 -1
  612. package/dist/migrate/ai-decorator.d.ts.map +1 -1
  613. package/dist/migrate/ai-decorator.js +55 -143
  614. package/dist/migrate/ai-decorator.js.map +1 -1
  615. package/dist/nac3/approval_queue.d.ts +44 -0
  616. package/dist/nac3/approval_queue.d.ts.map +1 -0
  617. package/dist/nac3/approval_queue.js +105 -0
  618. package/dist/nac3/approval_queue.js.map +1 -0
  619. package/dist/nac3/backend_tools.d.ts +89 -0
  620. package/dist/nac3/backend_tools.d.ts.map +1 -0
  621. package/dist/nac3/backend_tools.js +271 -0
  622. package/dist/nac3/backend_tools.js.map +1 -0
  623. package/dist/nac3/dispatch_log.d.ts +35 -0
  624. package/dist/nac3/dispatch_log.d.ts.map +1 -0
  625. package/dist/nac3/dispatch_log.js +126 -0
  626. package/dist/nac3/dispatch_log.js.map +1 -0
  627. package/dist/nac3/internal_manifest.d.ts +62 -0
  628. package/dist/nac3/internal_manifest.d.ts.map +1 -0
  629. package/dist/nac3/internal_manifest.js +2651 -0
  630. package/dist/nac3/internal_manifest.js.map +1 -0
  631. package/dist/nac3/manifest_lazy.d.ts +71 -0
  632. package/dist/nac3/manifest_lazy.d.ts.map +1 -0
  633. package/dist/nac3/manifest_lazy.js +141 -0
  634. package/dist/nac3/manifest_lazy.js.map +1 -0
  635. package/dist/nac3/verb_tier_map.d.ts +80 -0
  636. package/dist/nac3/verb_tier_map.d.ts.map +1 -0
  637. package/dist/nac3/verb_tier_map.js +162 -0
  638. package/dist/nac3/verb_tier_map.js.map +1 -0
  639. package/dist/office/excel.d.ts +132 -0
  640. package/dist/office/excel.d.ts.map +1 -0
  641. package/dist/office/excel.js +358 -0
  642. package/dist/office/excel.js.map +1 -0
  643. package/dist/office/pdf.d.ts +35 -0
  644. package/dist/office/pdf.d.ts.map +1 -0
  645. package/dist/office/pdf.js +70 -0
  646. package/dist/office/pdf.js.map +1 -0
  647. package/dist/office/word.d.ts +64 -0
  648. package/dist/office/word.d.ts.map +1 -0
  649. package/dist/office/word.js +243 -0
  650. package/dist/office/word.js.map +1 -0
  651. package/dist/onboarding/concierge_client.d.ts +34 -0
  652. package/dist/onboarding/concierge_client.d.ts.map +1 -0
  653. package/dist/onboarding/concierge_client.js +80 -0
  654. package/dist/onboarding/concierge_client.js.map +1 -0
  655. package/dist/onboarding/next_step.d.ts +32 -0
  656. package/dist/onboarding/next_step.d.ts.map +1 -0
  657. package/dist/onboarding/next_step.js +60 -0
  658. package/dist/onboarding/next_step.js.map +1 -0
  659. package/dist/pending/store.d.ts +79 -0
  660. package/dist/pending/store.d.ts.map +1 -0
  661. package/dist/pending/store.js +293 -0
  662. package/dist/pending/store.js.map +1 -0
  663. package/dist/pending/types.d.ts +131 -0
  664. package/dist/pending/types.d.ts.map +1 -0
  665. package/dist/pending/types.js +60 -0
  666. package/dist/pending/types.js.map +1 -0
  667. package/dist/qa/brain_matrix/ab_runner.d.ts +44 -0
  668. package/dist/qa/brain_matrix/ab_runner.d.ts.map +1 -0
  669. package/dist/qa/brain_matrix/ab_runner.js +144 -0
  670. package/dist/qa/brain_matrix/ab_runner.js.map +1 -0
  671. package/dist/qa/brain_matrix/brains.json +80 -0
  672. package/dist/qa/brain_matrix/compare.d.ts +27 -0
  673. package/dist/qa/brain_matrix/compare.d.ts.map +1 -0
  674. package/dist/qa/brain_matrix/compare.js +122 -0
  675. package/dist/qa/brain_matrix/compare.js.map +1 -0
  676. package/dist/qa/brain_matrix/fake_brain.d.ts +36 -0
  677. package/dist/qa/brain_matrix/fake_brain.d.ts.map +1 -0
  678. package/dist/qa/brain_matrix/fake_brain.js +27 -0
  679. package/dist/qa/brain_matrix/fake_brain.js.map +1 -0
  680. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_intent.json +22 -0
  681. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_no_speak_default.json +23 -0
  682. package/dist/qa/brain_matrix/fixtures/scenario_a11y_consecutive_announces.json +37 -0
  683. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_action.json +22 -0
  684. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_open.json +22 -0
  685. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_unlabeled_button.json +26 -0
  686. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_with_shortcut.json +22 -0
  687. package/dist/qa/brain_matrix/fixtures/scenario_agent_director_consults_workflow_before_dispatch.json +42 -0
  688. package/dist/qa/brain_matrix/fixtures/scenario_analyst_extracts_then_returns.json +28 -0
  689. package/dist/qa/brain_matrix/fixtures/scenario_announce_min_tool_calls.json +23 -0
  690. package/dist/qa/brain_matrix/fixtures/scenario_app_invoke_happy_path.json +65 -0
  691. package/dist/qa/brain_matrix/fixtures/scenario_app_no_invent_without_backend.json +18 -0
  692. package/dist/qa/brain_matrix/fixtures/scenario_app_schema_fail_recover.json +48 -0
  693. package/dist/qa/brain_matrix/fixtures/scenario_approval_modal_no_redundancy.json +21 -0
  694. package/dist/qa/brain_matrix/fixtures/scenario_args_redacted_in_audit.json +17 -0
  695. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent.json +19 -0
  696. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent_en.json +19 -0
  697. package/dist/qa/brain_matrix/fixtures/scenario_audit_log_on_destructive.json +18 -0
  698. package/dist/qa/brain_matrix/fixtures/scenario_brain_explains_after_invoke.json +28 -0
  699. package/dist/qa/brain_matrix/fixtures/scenario_byok_on_managed_brain_overflow.json +28 -0
  700. package/dist/qa/brain_matrix/fixtures/scenario_byok_required_policy.json +35 -0
  701. package/dist/qa/brain_matrix/fixtures/scenario_coder_consults_nac_spec_before_writing.json +28 -0
  702. package/dist/qa/brain_matrix/fixtures/scenario_concise_no_loop.json +23 -0
  703. package/dist/qa/brain_matrix/fixtures/scenario_consult_nac_spec_intent.json +19 -0
  704. package/dist/qa/brain_matrix/fixtures/scenario_contradiction_rfp_cost.json +38 -0
  705. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_attachment_frontier.json +24 -0
  706. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_escalation_explicit.json +23 -0
  707. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_idle_reset.json +24 -0
  708. package/dist/qa/brain_matrix/fixtures/scenario_csv_via_excel_read.json +22 -0
  709. package/dist/qa/brain_matrix/fixtures/scenario_default_design_system_override_shadcn.json +45 -0
  710. package/dist/qa/brain_matrix/fixtures/scenario_default_design_system_use_card_template.json +44 -0
  711. package/dist/qa/brain_matrix/fixtures/scenario_destructive_no_text_confirm.json +20 -0
  712. package/dist/qa/brain_matrix/fixtures/scenario_diff_explains_changes.json +32 -0
  713. package/dist/qa/brain_matrix/fixtures/scenario_director_delegates_to_analyst.json +26 -0
  714. package/dist/qa/brain_matrix/fixtures/scenario_director_no_self_delegation.json +20 -0
  715. package/dist/qa/brain_matrix/fixtures/scenario_director_terminal_done_marker.json +19 -0
  716. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_after_unknown_intent.json +17 -0
  717. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_a11y.json +24 -0
  718. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_agent_orchestrator.json +24 -0
  719. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_byok_vs_managed.json +24 -0
  720. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_cost_router.json +24 -0
  721. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_default_design_system.json +50 -0
  722. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_g_doc.json +24 -0
  723. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_gates.json +23 -0
  724. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_intent_en.json +19 -0
  725. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_language_sovereignty.json +53 -0
  726. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_lessons_workflow.json +24 -0
  727. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_mcp_lifecycle.json +24 -0
  728. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_nac3_attrs.json +24 -0
  729. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_office.json +24 -0
  730. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_pizarron.json +23 -0
  731. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_r8_modal.json +23 -0
  732. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_testing_policy.json +55 -0
  733. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow.json +23 -0
  734. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow_phases.json +24 -0
  735. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_yf_commands.json +24 -0
  736. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_explain_results.json +22 -0
  737. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_safety_refusals.json +22 -0
  738. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_verb_composition.json +22 -0
  739. package/dist/qa/brain_matrix/fixtures/scenario_eco_defers_complex.json +17 -0
  740. package/dist/qa/brain_matrix/fixtures/scenario_eco_short_query.json +27 -0
  741. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent.json +20 -0
  742. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent_en.json +20 -0
  743. package/dist/qa/brain_matrix/fixtures/scenario_env_no_secret_leak.json +21 -0
  744. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression.json +35 -0
  745. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression_en.json +21 -0
  746. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_handles_csv_refusal.json +28 -0
  747. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent.json +20 -0
  748. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent_en.json +20 -0
  749. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_then_list.json +34 -0
  750. package/dist/qa/brain_matrix/fixtures/scenario_excel_list_sheets_first.json +22 -0
  751. package/dist/qa/brain_matrix/fixtures/scenario_excel_sheet_named.json +23 -0
  752. package/dist/qa/brain_matrix/fixtures/scenario_explain_voice_yes.json +22 -0
  753. package/dist/qa/brain_matrix/fixtures/scenario_explains_forge_error.json +39 -0
  754. package/dist/qa/brain_matrix/fixtures/scenario_focus_after_modal_open.json +29 -0
  755. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent.json +21 -0
  756. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent_en.json +20 -0
  757. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_with_glob.json +22 -0
  758. package/dist/qa/brain_matrix/fixtures/scenario_fs_mkdir_intent.json +20 -0
  759. package/dist/qa/brain_matrix/fixtures/scenario_fs_move_intent.json +20 -0
  760. package/dist/qa/brain_matrix/fixtures/scenario_fs_read_handles_missing.json +28 -0
  761. package/dist/qa/brain_matrix/fixtures/scenario_fs_stat_before_read.json +22 -0
  762. package/dist/qa/brain_matrix/fixtures/scenario_generated_app_nac3_default.json +24 -0
  763. package/dist/qa/brain_matrix/fixtures/scenario_git_branch_list_intent.json +20 -0
  764. package/dist/qa/brain_matrix/fixtures/scenario_git_diff_intent.json +20 -0
  765. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent.json +20 -0
  766. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent_en.json +20 -0
  767. package/dist/qa/brain_matrix/fixtures/scenario_git_pull_intent.json +19 -0
  768. package/dist/qa/brain_matrix/fixtures/scenario_git_push_intent.json +20 -0
  769. package/dist/qa/brain_matrix/fixtures/scenario_git_show_metadata_only.json +22 -0
  770. package/dist/qa/brain_matrix/fixtures/scenario_git_status_branch_combo.json +44 -0
  771. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent.json +20 -0
  772. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent_en.json +20 -0
  773. package/dist/qa/brain_matrix/fixtures/scenario_github_clone_repo_intent.json +20 -0
  774. package/dist/qa/brain_matrix/fixtures/scenario_github_create_repo_intent.json +20 -0
  775. package/dist/qa/brain_matrix/fixtures/scenario_id_format_in_reply.json +27 -0
  776. package/dist/qa/brain_matrix/fixtures/scenario_iterations_idempotent_adenda.json +27 -0
  777. package/dist/qa/brain_matrix/fixtures/scenario_iterations_query_history.json +29 -0
  778. package/dist/qa/brain_matrix/fixtures/scenario_iterations_tracker_acknowledge.json +28 -0
  779. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_handles_malformed.json +34 -0
  780. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent.json +30 -0
  781. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent_en.json +30 -0
  782. package/dist/qa/brain_matrix/fixtures/scenario_json_query_extract.json +23 -0
  783. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent.json +20 -0
  784. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent_en.json +20 -0
  785. package/dist/qa/brain_matrix/fixtures/scenario_keys_set_intent.json +20 -0
  786. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent.json +20 -0
  787. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent_en.json +20 -0
  788. package/dist/qa/brain_matrix/fixtures/scenario_language_sovereignty_not_conducive_spa_python.json +61 -0
  789. package/dist/qa/brain_matrix/fixtures/scenario_language_sovereignty_user_picks_python.json +48 -0
  790. package/dist/qa/brain_matrix/fixtures/scenario_lazy_complex_verb.json +27 -0
  791. package/dist/qa/brain_matrix/fixtures/scenario_lazy_doctrine_only_when_needed.json +17 -0
  792. package/dist/qa/brain_matrix/fixtures/scenario_lazy_simple_verb.json +21 -0
  793. package/dist/qa/brain_matrix/fixtures/scenario_lesson_recall_overrides.json +22 -0
  794. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_restart_app_intent.json +19 -0
  795. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent.json +19 -0
  796. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent_en.json +19 -0
  797. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent.json +20 -0
  798. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent_en.json +20 -0
  799. package/dist/qa/brain_matrix/fixtures/scenario_long_doctrine_no_truncate.json +23 -0
  800. package/dist/qa/brain_matrix/fixtures/scenario_manifest_read_intent.json +19 -0
  801. package/dist/qa/brain_matrix/fixtures/scenario_manual_open_intent.json +19 -0
  802. package/dist/qa/brain_matrix/fixtures/scenario_mcp_bridge_unreachable_graceful.json +39 -0
  803. package/dist/qa/brain_matrix/fixtures/scenario_mcp_disabled_bridge_no_verbs.json +18 -0
  804. package/dist/qa/brain_matrix/fixtures/scenario_mcp_discover_tools_intent.json +19 -0
  805. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invariant_1_no_verbs.json +19 -0
  806. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_destructive_pauses_for_r8.json +42 -0
  807. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_happy_path_writes_pizarron.json +76 -0
  808. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_network_timeout_graceful.json +41 -0
  809. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_two_hop.json +68 -0
  810. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_with_auth_loaded.json +76 -0
  811. package/dist/qa/brain_matrix/fixtures/scenario_mcp_revoked_token_graceful.json +33 -0
  812. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_intent.json +21 -0
  813. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_no_token_arg.json +27 -0
  814. package/dist/qa/brain_matrix/fixtures/scenario_mcp_show_tools_before_invoke.json +44 -0
  815. package/dist/qa/brain_matrix/fixtures/scenario_mcp_toggle_intent.json +20 -0
  816. package/dist/qa/brain_matrix/fixtures/scenario_multi_turn_clarify_then_act.json +24 -0
  817. package/dist/qa/brain_matrix/fixtures/scenario_nac3_attrs_doctrine.json +53 -0
  818. package/dist/qa/brain_matrix/fixtures/scenario_nac3_discover_schemas_intent.json +19 -0
  819. package/dist/qa/brain_matrix/fixtures/scenario_nac3_required_attr_missing.json +19 -0
  820. package/dist/qa/brain_matrix/fixtures/scenario_no_bare_ok_after_destructive.json +27 -0
  821. package/dist/qa/brain_matrix/fixtures/scenario_no_global_learnings_no_recall.json +20 -0
  822. package/dist/qa/brain_matrix/fixtures/scenario_no_hardcoded_color_use_token.json +47 -0
  823. package/dist/qa/brain_matrix/fixtures/scenario_no_id_leak_in_reply.json +24 -0
  824. package/dist/qa/brain_matrix/fixtures/scenario_no_invent_verb.json +18 -0
  825. package/dist/qa/brain_matrix/fixtures/scenario_no_loop_after_repeated_fail.json +42 -0
  826. package/dist/qa/brain_matrix/fixtures/scenario_no_password_echo.json +28 -0
  827. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_all_current.json +28 -0
  828. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent.json +20 -0
  829. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent_en.json +20 -0
  830. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_then_explain.json +35 -0
  831. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_read_intent.json +24 -0
  832. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_update_cell_picks_right_verb.json +26 -0
  833. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_write_required_args.json +23 -0
  834. package/dist/qa/brain_matrix/fixtures/scenario_office_overwrite_explicit.json +23 -0
  835. package/dist/qa/brain_matrix/fixtures/scenario_office_word_write_intent.json +27 -0
  836. package/dist/qa/brain_matrix/fixtures/scenario_panel_open_settings_intent.json +19 -0
  837. package/dist/qa/brain_matrix/fixtures/scenario_panel_send_message_intent.json +19 -0
  838. package/dist/qa/brain_matrix/fixtures/scenario_pdf_read_intent.json +22 -0
  839. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_clear_tab_explicit_close.json +17 -0
  840. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_chart.json +30 -0
  841. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_long_table.json +28 -0
  842. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_read_tab_intent.json +20 -0
  843. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_render_not_inline.json +20 -0
  844. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_read_file.json +28 -0
  845. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_verb_over_shell.json +22 -0
  846. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_workflow_state.json +28 -0
  847. package/dist/qa/brain_matrix/fixtures/scenario_project_init_intent.json +20 -0
  848. package/dist/qa/brain_matrix/fixtures/scenario_project_set_root_intent.json +20 -0
  849. package/dist/qa/brain_matrix/fixtures/scenario_promote_lesson_after_correction.json +17 -0
  850. package/dist/qa/brain_matrix/fixtures/scenario_r8_destructive_shell_exec.json +21 -0
  851. package/dist/qa/brain_matrix/fixtures/scenario_read_then_parse_order.json +36 -0
  852. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_jump_intent.json +19 -0
  853. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_set_intent.json +19 -0
  854. package/dist/qa/brain_matrix/fixtures/scenario_reader_for_long_doc.json +21 -0
  855. package/dist/qa/brain_matrix/fixtures/scenario_reader_list_docs_intent.json +19 -0
  856. package/dist/qa/brain_matrix/fixtures/scenario_reader_next_block_intent.json +19 -0
  857. package/dist/qa/brain_matrix/fixtures/scenario_reader_read_section_intent.json +19 -0
  858. package/dist/qa/brain_matrix/fixtures/scenario_reader_recap_intent.json +19 -0
  859. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent.json +20 -0
  860. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent_en.json +20 -0
  861. package/dist/qa/brain_matrix/fixtures/scenario_refuses_blanket_chmod_777.json +17 -0
  862. package/dist/qa/brain_matrix/fixtures/scenario_refuses_bypass_approval_modal.json +18 -0
  863. package/dist/qa/brain_matrix/fixtures/scenario_refuses_delete_critical_en.json +18 -0
  864. package/dist/qa/brain_matrix/fixtures/scenario_refuses_disable_vault_encryption.json +18 -0
  865. package/dist/qa/brain_matrix/fixtures/scenario_refuses_drop_database.json +17 -0
  866. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main.json +17 -0
  867. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main_en.json +17 -0
  868. package/dist/qa/brain_matrix/fixtures/scenario_refuses_leak_vault_en.json +18 -0
  869. package/dist/qa/brain_matrix/fixtures/scenario_refuses_modify_node_modules.json +17 -0
  870. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks.json +17 -0
  871. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks_en.json +17 -0
  872. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_delete_critical.json +18 -0
  873. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_leak_vault.json +18 -0
  874. package/dist/qa/brain_matrix/fixtures/scenario_respects_global_learnings.json +28 -0
  875. package/dist/qa/brain_matrix/fixtures/scenario_respects_workflow_gate_g2.json +39 -0
  876. package/dist/qa/brain_matrix/fixtures/scenario_revoke_lesson_request.json +21 -0
  877. package/dist/qa/brain_matrix/fixtures/scenario_scaffolder_destructive_pauses_for_approval.json +23 -0
  878. package/dist/qa/brain_matrix/fixtures/scenario_sq9b_deploy_checks_git_status.json +25 -0
  879. package/dist/qa/brain_matrix/fixtures/scenario_sq9b_install_checks_node_version.json +25 -0
  880. package/dist/qa/brain_matrix/fixtures/scenario_sq9b_publish_checks_gh_cli.json +25 -0
  881. package/dist/qa/brain_matrix/fixtures/scenario_sq_rules_active.json +30 -0
  882. package/dist/qa/brain_matrix/fixtures/scenario_sumie_icon_pick_from_catalog.json +56 -0
  883. package/dist/qa/brain_matrix/fixtures/scenario_tester_uses_shell_exec_only.json +27 -0
  884. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent.json +20 -0
  885. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent_en.json +20 -0
  886. package/dist/qa/brain_matrix/fixtures/scenario_truncated_response_retry.json +22 -0
  887. package/dist/qa/brain_matrix/fixtures/scenario_unknown_command_clarify.json +23 -0
  888. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_compose.json +23 -0
  889. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_handles_invalid.json +27 -0
  890. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent.json +20 -0
  891. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent_en.json +20 -0
  892. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_then_inspect_query.json +28 -0
  893. package/dist/qa/brain_matrix/fixtures/scenario_url_then_stringify_order.json +34 -0
  894. package/dist/qa/brain_matrix/fixtures/scenario_user_just_greets.json +17 -0
  895. package/dist/qa/brain_matrix/fixtures/scenario_user_overrides_proceeds.json +24 -0
  896. package/dist/qa/brain_matrix/fixtures/scenario_user_revokes_in_middle.json +22 -0
  897. package/dist/qa/brain_matrix/fixtures/scenario_voice_open_pizarron.json +21 -0
  898. package/dist/qa/brain_matrix/fixtures/scenario_word_outline_extraction.json +22 -0
  899. package/dist/qa/brain_matrix/fixtures/scenario_word_overwrite_explicit.json +20 -0
  900. package/dist/qa/brain_matrix/fixtures/scenario_word_section_count.json +28 -0
  901. package/dist/qa/brain_matrix/fixtures/scenario_workflow_doctrine.json +53 -0
  902. package/dist/qa/brain_matrix/fixtures/scenario_workflow_done_specs.json +32 -0
  903. package/dist/qa/brain_matrix/fixtures/scenario_workflow_intent_capture.json +22 -0
  904. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_jump_block.json +26 -0
  905. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_v_step_15.json +41 -0
  906. package/dist/qa/brain_matrix/fixtures/scenario_workflow_run_step_intent.json +19 -0
  907. package/dist/qa/brain_matrix/fixtures/scenario_workflow_set_intent.json +20 -0
  908. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_injection.json +32 -0
  909. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_recovers_after_clarify.json +25 -0
  910. package/dist/qa/brain_matrix/fixtures/scenario_workflow_step_1_intake.json +24 -0
  911. package/dist/qa/brain_matrix/fixtures/scenario_yf_command_doctrine.json +56 -0
  912. package/dist/qa/brain_matrix/fixtures/scenario_yf_doctrine_list_intent.json +19 -0
  913. package/dist/qa/brain_matrix/fixtures/scenario_yf_qa_compare_intent.json +17 -0
  914. package/dist/qa/brain_matrix/invariants.d.ts +18 -0
  915. package/dist/qa/brain_matrix/invariants.d.ts.map +1 -0
  916. package/dist/qa/brain_matrix/invariants.js +333 -0
  917. package/dist/qa/brain_matrix/invariants.js.map +1 -0
  918. package/dist/qa/brain_matrix/report.d.ts +12 -0
  919. package/dist/qa/brain_matrix/report.d.ts.map +1 -0
  920. package/dist/qa/brain_matrix/report.js +131 -0
  921. package/dist/qa/brain_matrix/report.js.map +1 -0
  922. package/dist/qa/brain_matrix/runner.d.ts +31 -0
  923. package/dist/qa/brain_matrix/runner.d.ts.map +1 -0
  924. package/dist/qa/brain_matrix/runner.js +561 -0
  925. package/dist/qa/brain_matrix/runner.js.map +1 -0
  926. package/dist/qa/brain_matrix/types.d.ts +180 -0
  927. package/dist/qa/brain_matrix/types.d.ts.map +1 -0
  928. package/dist/qa/brain_matrix/types.js +2 -0
  929. package/dist/qa/brain_matrix/types.js.map +1 -0
  930. package/dist/qa/brain_matrix/validate_scenario.d.ts +23 -0
  931. package/dist/qa/brain_matrix/validate_scenario.d.ts.map +1 -0
  932. package/dist/qa/brain_matrix/validate_scenario.js +128 -0
  933. package/dist/qa/brain_matrix/validate_scenario.js.map +1 -0
  934. package/dist/reader/parsers/epub.d.ts.map +1 -1
  935. package/dist/reader/parsers/epub.js +6 -1
  936. package/dist/reader/parsers/epub.js.map +1 -1
  937. package/dist/relay/board_snapshot.d.ts +69 -0
  938. package/dist/relay/board_snapshot.d.ts.map +1 -0
  939. package/dist/relay/board_snapshot.js +149 -0
  940. package/dist/relay/board_snapshot.js.map +1 -0
  941. package/dist/relay/command_consumer.d.ts +91 -0
  942. package/dist/relay/command_consumer.d.ts.map +1 -0
  943. package/dist/relay/command_consumer.js +129 -0
  944. package/dist/relay/command_consumer.js.map +1 -0
  945. package/dist/relay/mock_relay.d.ts +34 -0
  946. package/dist/relay/mock_relay.d.ts.map +1 -0
  947. package/dist/relay/mock_relay.js +93 -0
  948. package/dist/relay/mock_relay.js.map +1 -0
  949. package/dist/relay/relay_client.d.ts +28 -0
  950. package/dist/relay/relay_client.d.ts.map +1 -0
  951. package/dist/relay/relay_client.js +80 -0
  952. package/dist/relay/relay_client.js.map +1 -0
  953. package/dist/relay/relay_publisher.d.ts +59 -0
  954. package/dist/relay/relay_publisher.d.ts.map +1 -0
  955. package/dist/relay/relay_publisher.js +101 -0
  956. package/dist/relay/relay_publisher.js.map +1 -0
  957. package/dist/relay/types.d.ts +54 -0
  958. package/dist/relay/types.d.ts.map +1 -0
  959. package/dist/relay/types.js +8 -0
  960. package/dist/relay/types.js.map +1 -0
  961. package/dist/semantic_graph/ast_extract.d.ts +20 -0
  962. package/dist/semantic_graph/ast_extract.d.ts.map +1 -0
  963. package/dist/semantic_graph/ast_extract.js +208 -0
  964. package/dist/semantic_graph/ast_extract.js.map +1 -0
  965. package/dist/semantic_graph/derive.d.ts +48 -0
  966. package/dist/semantic_graph/derive.d.ts.map +1 -0
  967. package/dist/semantic_graph/derive.js +604 -0
  968. package/dist/semantic_graph/derive.js.map +1 -0
  969. package/dist/semantic_graph/llm_claim.d.ts +21 -0
  970. package/dist/semantic_graph/llm_claim.d.ts.map +1 -0
  971. package/dist/semantic_graph/llm_claim.js +164 -0
  972. package/dist/semantic_graph/llm_claim.js.map +1 -0
  973. package/dist/semantic_graph/npm_enrich.d.ts +49 -0
  974. package/dist/semantic_graph/npm_enrich.d.ts.map +1 -0
  975. package/dist/semantic_graph/npm_enrich.js +173 -0
  976. package/dist/semantic_graph/npm_enrich.js.map +1 -0
  977. package/dist/semantic_graph/render.d.ts +28 -0
  978. package/dist/semantic_graph/render.d.ts.map +1 -0
  979. package/dist/semantic_graph/render.js +70 -0
  980. package/dist/semantic_graph/render.js.map +1 -0
  981. package/dist/semantic_graph/store.d.ts +53 -0
  982. package/dist/semantic_graph/store.d.ts.map +1 -0
  983. package/dist/semantic_graph/store.js +382 -0
  984. package/dist/semantic_graph/store.js.map +1 -0
  985. package/dist/semantic_graph/types.d.ts +59 -0
  986. package/dist/semantic_graph/types.d.ts.map +1 -0
  987. package/dist/semantic_graph/types.js +17 -0
  988. package/dist/semantic_graph/types.js.map +1 -0
  989. package/dist/support/github_dispatcher.d.ts +36 -0
  990. package/dist/support/github_dispatcher.d.ts.map +1 -0
  991. package/dist/support/github_dispatcher.js +320 -0
  992. package/dist/support/github_dispatcher.js.map +1 -0
  993. package/dist/support/reports.d.ts +31 -0
  994. package/dist/support/reports.d.ts.map +1 -0
  995. package/dist/support/reports.js +162 -0
  996. package/dist/support/reports.js.map +1 -0
  997. package/dist/tasks/supervisor.d.ts +88 -0
  998. package/dist/tasks/supervisor.d.ts.map +1 -0
  999. package/dist/tasks/supervisor.js +308 -0
  1000. package/dist/tasks/supervisor.js.map +1 -0
  1001. package/dist/tasks/task_type.d.ts +11 -0
  1002. package/dist/tasks/task_type.d.ts.map +1 -0
  1003. package/dist/tasks/task_type.js +21 -0
  1004. package/dist/tasks/task_type.js.map +1 -0
  1005. package/dist/telemetry/usage.d.ts +67 -0
  1006. package/dist/telemetry/usage.d.ts.map +1 -0
  1007. package/dist/telemetry/usage.js +208 -0
  1008. package/dist/telemetry/usage.js.map +1 -0
  1009. package/dist/test_agent/gemini_user.d.ts +9 -0
  1010. package/dist/test_agent/gemini_user.d.ts.map +1 -0
  1011. package/dist/test_agent/gemini_user.js +58 -0
  1012. package/dist/test_agent/gemini_user.js.map +1 -0
  1013. package/dist/test_agent/profiles.d.ts +23 -0
  1014. package/dist/test_agent/profiles.d.ts.map +1 -0
  1015. package/dist/test_agent/profiles.js +117 -0
  1016. package/dist/test_agent/profiles.js.map +1 -0
  1017. package/dist/test_agent/runner.d.ts +56 -0
  1018. package/dist/test_agent/runner.d.ts.map +1 -0
  1019. package/dist/test_agent/runner.js +134 -0
  1020. package/dist/test_agent/runner.js.map +1 -0
  1021. package/dist/test_agent/target_http.d.ts +22 -0
  1022. package/dist/test_agent/target_http.d.ts.map +1 -0
  1023. package/dist/test_agent/target_http.js +51 -0
  1024. package/dist/test_agent/target_http.js.map +1 -0
  1025. package/dist/test_agent/types.d.ts +117 -0
  1026. package/dist/test_agent/types.d.ts.map +1 -0
  1027. package/dist/test_agent/types.js +22 -0
  1028. package/dist/test_agent/types.js.map +1 -0
  1029. package/dist/vault/store.d.ts.map +1 -1
  1030. package/dist/vault/store.js +20 -2
  1031. package/dist/vault/store.js.map +1 -1
  1032. package/dist/version.d.ts +3 -5
  1033. package/dist/version.d.ts.map +1 -1
  1034. package/dist/version.js +3 -5
  1035. package/dist/version.js.map +1 -1
  1036. package/dist/voice/config.d.ts +12 -0
  1037. package/dist/voice/config.d.ts.map +1 -1
  1038. package/dist/voice/config.js +25 -2
  1039. package/dist/voice/config.js.map +1 -1
  1040. package/dist/voice/providers/google.d.ts +9 -0
  1041. package/dist/voice/providers/google.d.ts.map +1 -1
  1042. package/dist/voice/providers/google.js +158 -30
  1043. package/dist/voice/providers/google.js.map +1 -1
  1044. package/dist/voice/router.d.ts +10 -0
  1045. package/dist/voice/router.d.ts.map +1 -1
  1046. package/dist/voice/router.js +39 -20
  1047. package/dist/voice/router.js.map +1 -1
  1048. package/dist/voice/types.d.ts +5 -2
  1049. package/dist/voice/types.d.ts.map +1 -1
  1050. package/dist/voice/types.js.map +1 -1
  1051. package/dist/wiring/discover.d.ts +14 -0
  1052. package/dist/wiring/discover.d.ts.map +1 -0
  1053. package/dist/wiring/discover.js +383 -0
  1054. package/dist/wiring/discover.js.map +1 -0
  1055. package/dist/wiring/store.d.ts +19 -0
  1056. package/dist/wiring/store.d.ts.map +1 -0
  1057. package/dist/wiring/store.js +182 -0
  1058. package/dist/wiring/store.js.map +1 -0
  1059. package/dist/wiring/types.d.ts +61 -0
  1060. package/dist/wiring/types.d.ts.map +1 -0
  1061. package/dist/wiring/types.js +36 -0
  1062. package/dist/wiring/types.js.map +1 -0
  1063. package/dist/workflow/config.d.ts +43 -0
  1064. package/dist/workflow/config.d.ts.map +1 -0
  1065. package/dist/workflow/config.js +199 -0
  1066. package/dist/workflow/config.js.map +1 -0
  1067. package/dist/workflow/definitions.d.ts +60 -0
  1068. package/dist/workflow/definitions.d.ts.map +1 -0
  1069. package/dist/workflow/definitions.js +178 -0
  1070. package/dist/workflow/definitions.js.map +1 -0
  1071. package/dist/workflow/definitions_client.d.ts +12 -0
  1072. package/dist/workflow/definitions_client.d.ts.map +1 -0
  1073. package/dist/workflow/definitions_client.js +81 -0
  1074. package/dist/workflow/definitions_client.js.map +1 -0
  1075. package/dist/workflow/evolution.d.ts +10 -0
  1076. package/dist/workflow/evolution.d.ts.map +1 -0
  1077. package/dist/workflow/evolution.js +62 -0
  1078. package/dist/workflow/evolution.js.map +1 -0
  1079. package/dist/workflow/graph.d.ts +59 -0
  1080. package/dist/workflow/graph.d.ts.map +1 -0
  1081. package/dist/workflow/graph.js +137 -0
  1082. package/dist/workflow/graph.js.map +1 -0
  1083. package/dist/workflow/instances.d.ts +40 -0
  1084. package/dist/workflow/instances.d.ts.map +1 -0
  1085. package/dist/workflow/instances.js +122 -0
  1086. package/dist/workflow/instances.js.map +1 -0
  1087. package/dist/workflow/multi_view.d.ts +27 -0
  1088. package/dist/workflow/multi_view.d.ts.map +1 -0
  1089. package/dist/workflow/multi_view.js +76 -0
  1090. package/dist/workflow/multi_view.js.map +1 -0
  1091. package/dist/workflow/orchestrator.d.ts +111 -0
  1092. package/dist/workflow/orchestrator.d.ts.map +1 -0
  1093. package/dist/workflow/orchestrator.js +241 -0
  1094. package/dist/workflow/orchestrator.js.map +1 -0
  1095. package/dist/workflow/phase_inference.d.ts +56 -0
  1096. package/dist/workflow/phase_inference.d.ts.map +1 -0
  1097. package/dist/workflow/phase_inference.js +107 -0
  1098. package/dist/workflow/phase_inference.js.map +1 -0
  1099. package/dist/workflow/select.d.ts +28 -0
  1100. package/dist/workflow/select.d.ts.map +1 -0
  1101. package/dist/workflow/select.js +38 -0
  1102. package/dist/workflow/select.js.map +1 -0
  1103. package/dist/workflow/state.d.ts +290 -0
  1104. package/dist/workflow/state.d.ts.map +1 -0
  1105. package/dist/workflow/state.js +213 -0
  1106. package/dist/workflow/state.js.map +1 -0
  1107. package/dist/workflow/view.d.ts +47 -0
  1108. package/dist/workflow/view.d.ts.map +1 -0
  1109. package/dist/workflow/view.js +103 -0
  1110. package/dist/workflow/view.js.map +1 -0
  1111. package/docs/SQ.md +1397 -0
  1112. package/docs/SQ_BY_STEP.yaml +147 -0
  1113. package/docs/doctrine/accessibility.md +78 -0
  1114. package/docs/doctrine/agent-orchestrator.md +76 -0
  1115. package/docs/doctrine/byok-vs-managed.md +81 -0
  1116. package/docs/doctrine/cost-router-escalation.md +103 -0
  1117. package/docs/doctrine/default-design-system.md +152 -0
  1118. package/docs/doctrine/explain-results.md +90 -0
  1119. package/docs/doctrine/expo-eas-builds.md +177 -0
  1120. package/docs/doctrine/g-doc.md +46 -0
  1121. package/docs/doctrine/gates.md +21 -0
  1122. package/docs/doctrine/language-sovereignty.md +143 -0
  1123. package/docs/doctrine/lessons-workflow.md +68 -0
  1124. package/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  1125. package/docs/doctrine/nac3-attrs.md +23 -0
  1126. package/docs/doctrine/office-tools.md +122 -0
  1127. package/docs/doctrine/pizarron.md +52 -0
  1128. package/docs/doctrine/r8-modal.md +60 -0
  1129. package/docs/doctrine/safety-refusals.md +73 -0
  1130. package/docs/doctrine/testing-policy.md +211 -0
  1131. package/docs/doctrine/verb-composition.md +84 -0
  1132. package/docs/doctrine/verification-honesty.md +95 -0
  1133. package/docs/doctrine/workflow-kinds.md +69 -0
  1134. package/docs/doctrine/workflow-phases.md +108 -0
  1135. package/docs/doctrine/workflow.md +66 -0
  1136. package/docs/doctrine/yf-commands.md +49 -0
  1137. package/package.json +20 -3
  1138. package/src/i18n/catalogs/ar.json +223 -86
  1139. package/src/i18n/catalogs/de.json +223 -86
  1140. package/src/i18n/catalogs/en.json +223 -86
  1141. package/src/i18n/catalogs/es.json +223 -86
  1142. package/src/i18n/catalogs/fr.json +223 -86
  1143. package/src/i18n/catalogs/hi.json +223 -86
  1144. package/src/i18n/catalogs/it.json +223 -86
  1145. package/src/i18n/catalogs/ja.json +223 -86
  1146. package/src/i18n/catalogs/pt.json +223 -86
  1147. package/src/i18n/catalogs/zh.json +223 -86
  1148. package/templates/nextjs-app/README.md +48 -0
  1149. package/templates/nextjs-app/next.config.js +8 -0
  1150. package/templates/nextjs-app/package.json +33 -0
  1151. package/templates/nextjs-app/src/app/globals.css +43 -0
  1152. package/templates/nextjs-app/src/app/layout.tsx +29 -0
  1153. package/templates/nextjs-app/src/app/page.tsx +63 -0
  1154. package/templates/nextjs-app/src/nac/manifest.ts +36 -0
  1155. package/templates/nextjs-app/tsconfig.json +21 -0
  1156. package/templates/nextjs-app/yujin.forge.json +11 -0
  1157. package/templates/sumi-context.template.md +57 -0
@@ -27,6 +27,7 @@ import { promises as fs } from 'node:fs';
27
27
  import path from 'node:path';
28
28
  import { configDir } from '../license/index.js';
29
29
  import { Vault } from '../vault/store.js';
30
+ import { recordUsage } from '../telemetry/usage.js';
30
31
  export class ConfigurationError extends Error {
31
32
  constructor(message) {
32
33
  super(message);
@@ -65,27 +66,17 @@ export class ClaudeApiError extends Error {
65
66
  export async function resolveApiKey(injected) {
66
67
  if (injected && injected.trim() !== '')
67
68
  return injected.trim();
68
- /* 1. BYOK provider_keys.json -- the alpha.4+ canonical path.
69
- Lives at ~/.yujin-forge/provider_keys.json and is written
70
- by `yf keys setup`. We read it as plain JSON (the file is
71
- NOT encrypted at rest -- the encryption layer is for the
72
- mobile-sync envelope, which is a separate concern). */
69
+ /* 1. BYOK provider keys -- alpha.44 C1: stored in the encrypted
70
+ Vault (AES-256-GCM). The legacy plaintext provider_keys.json
71
+ gets auto-migrated by core/provider_keys.ts on first access. */
73
72
  try {
74
- const providerKeysPath = path.join(configDir(), 'provider_keys.json');
75
- const raw = await fs.readFile(providerKeysPath, 'utf-8');
76
- const parsed = JSON.parse(raw);
77
- if (typeof parsed.anthropic_api_key === 'string'
78
- && parsed.anthropic_api_key.trim() !== '') {
79
- return parsed.anthropic_api_key.trim();
80
- }
73
+ const { getKey } = await import('../core/provider_keys.js');
74
+ const v = await getKey('anthropic_api_key');
75
+ if (v && v.trim() !== '')
76
+ return v.trim();
81
77
  }
82
- catch (err) {
83
- if (err.code !== 'ENOENT'
84
- && !(err instanceof SyntaxError)) {
85
- /* Real IO error -- log silently and fall through. We do
86
- NOT want a vault permission bug to break the env var
87
- path. */
88
- }
78
+ catch {
79
+ /* Vault unavailable -- fall through to legacy paths */
89
80
  }
90
81
  /* 2. Vault slot. Opens cheaply; the cost is dominated by
91
82
  scrypt derivation (~60ms) which is acceptable for the
@@ -121,15 +112,27 @@ export async function resolveApiKey(injected) {
121
112
  if (err.code !== 'ENOENT')
122
113
  throw err;
123
114
  }
124
- throw new ConfigurationError('no Anthropic API key found. Configure one of:\n'
125
- + ' - yf keys setup (recommended; sets up brain + voice)\n'
126
- + ' - yf vault set anthropic (encrypted vault slot)\n'
115
+ /* alpha.59z.14 F104 -- formatted error with what/why/fix triple.
116
+ * Importing the formatter lazily because resolveAnthropicKey()
117
+ * gets called from many code paths; we keep this fn synchronous
118
+ * by inlining the catalog data here. The CLI formatter wraps
119
+ * the thrown ConfigurationError instance into a ForgeError at
120
+ * the boundary (yf doctor / yf chat catch). */
121
+ const err = new ConfigurationError('no Anthropic API key found. Configure one of:\n'
122
+ + ' - yf keys set anthropic_api_key (recommended; encrypted vault slot)\n'
123
+ + ' - yf keys setup (interactive setup; brain + voice)\n'
127
124
  + ' - export ANTHROPIC_API_KEY=sk-ant-...\n'
128
125
  + ' - export YUJIN_ANTHROPIC_API_KEY=sk-ant-...\n'
129
126
  + ' - write the key to ~/.yujin-forge/api-key.txt');
127
+ /* Hydrate forge_error via the catalog so the message respects
128
+ * the active i18n session language (alpha.59z.15). */
129
+ const { renderForgeError, E_BYOK_KEY_MISSING } = await import('../core/error_catalog.js');
130
+ err.forge_error = renderForgeError(E_BYOK_KEY_MISSING, {
131
+ provider: 'anthropic', slot: 'anthropic_api_key', tier: 'frontier',
132
+ });
133
+ throw err;
130
134
  }
131
135
  const DEFAULT_MODEL = 'claude-sonnet-4-6';
132
- const DEFAULT_MAX_TOOL_ROUNDS = 5;
133
136
  export class ClaudeClient {
134
137
  apiKey;
135
138
  fetchImpl;
@@ -148,7 +151,23 @@ export class ClaudeClient {
148
151
  }
149
152
  const model = req.model ?? this.defaultModel;
150
153
  const maxTokens = req.maxTokens ?? 1024;
151
- const maxRounds = req.maxToolRounds ?? DEFAULT_MAX_TOOL_ROUNDS;
154
+ /* alpha.59c -- max_tool_rounds comes from limits_config (or
155
+ * the caller's override). Inside the loop we re-evaluate
156
+ * based on the verb family of the first tool the LLM
157
+ * invokes so reader-heavy turns get the bigger cap
158
+ * automatically. Cap only grows mid-turn, never shrinks. */
159
+ const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
160
+ const limits = await readLimitsConfig();
161
+ const callerSpecifiedCap = req.maxToolRounds !== undefined;
162
+ /* alpha.59e -- when Danger Zone auto-approve is on, the user
163
+ * has opted in to long autonomous chains. Use the higher
164
+ * autonomous cap as the BASE. Caller override still wins. */
165
+ const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
166
+ const baseCap = autonomousMode
167
+ ? limits.max_tool_rounds.autonomous
168
+ : limits.max_tool_rounds.default;
169
+ let maxRounds = req.maxToolRounds ?? baseCap;
170
+ let familyResolved = null;
152
171
  /* Seed the conversation with the caller's history. Each round
153
172
  appends turns; the loop terminates when the model's
154
173
  stop_reason is anything other than 'tool_use'. */
@@ -161,7 +180,24 @@ export class ClaudeClient {
161
180
  let totalTokensOut = 0;
162
181
  let lastText = '';
163
182
  let usedModel = model;
183
+ /* PND-065 -- early-stop ante fallos repetidos del mismo verbo.
184
+ * En la sesion Yuemail 2026-06-10 un verbo que no podia
185
+ * completarse (crear una tab del pizarron, imposible en ese
186
+ * modo) se reintento hasta agotar las 38 rondas sin avanzar.
187
+ * Si el mismo verbo devuelve is_error en STREAK_LIMIT rondas
188
+ * consecutivas, cortamos con un cierre honesto en vez de quemar
189
+ * el presupuesto entero. */
190
+ const STREAK_LIMIT = 4;
191
+ let lastFailVerb = null;
192
+ let failStreak = 0;
193
+ let interrupted = false;
164
194
  for (let round = 0; round <= maxRounds; round++) {
195
+ /* Controlled-fall interrupt: stop at the round boundary so already
196
+ * applied tool calls stay + the conversation is left consistent. */
197
+ if (req.signal?.aborted) {
198
+ interrupted = true;
199
+ break;
200
+ }
165
201
  const body = {
166
202
  model,
167
203
  max_tokens: maxTokens,
@@ -178,14 +214,28 @@ export class ClaudeClient {
178
214
  * the cache invalidates and the next turn rewrites it; the
179
215
  * TTL covers the typical multi-turn session.
180
216
  * Minimum cacheable prefix is 1024 tokens for sonnet/opus
181
- * and 2048 for haiku; our payload exceeds both. */
182
- body['system'] = [
217
+ * and 2048 for haiku; our payload exceeds both.
218
+ *
219
+ * alpha.59z.163 PND-027 -- when the caller supplies a
220
+ * `systemDynamic` suffix, emit it as a SECOND uncached block
221
+ * so the stable prefix keeps hitting the cache turn after
222
+ * turn. The dynamic suffix is typically a relevance-ranked
223
+ * graph snippet or workflow phase that changes per round;
224
+ * bundling it into the same cached block would invalidate
225
+ * the prefix every turn. Director sprint #11 burned 1.8M
226
+ * tokens re-injecting a ~9KB spec on every iteration -- the
227
+ * same shape applies to user-side BYOK multi-turn sessions. */
228
+ const systemBlocks = [
183
229
  {
184
230
  type: 'text',
185
231
  text: req.system,
186
232
  cache_control: { type: 'ephemeral' },
187
233
  },
188
234
  ];
235
+ if (req.systemDynamic && req.systemDynamic.length > 0) {
236
+ systemBlocks.push({ type: 'text', text: req.systemDynamic });
237
+ }
238
+ body['system'] = systemBlocks;
189
239
  }
190
240
  if (req.tools && req.tools.length > 0) {
191
241
  body['tools'] = req.tools.map((t) => ({
@@ -194,40 +244,119 @@ export class ClaudeClient {
194
244
  input_schema: t.input_schema,
195
245
  }));
196
246
  }
197
- const resp = await this.fetchImpl('https://api.anthropic.com/v1/messages', {
198
- method: 'POST',
199
- headers: {
200
- 'content-type': 'application/json',
201
- 'x-api-key': this.apiKey,
202
- 'anthropic-version': '2023-06-01',
203
- },
204
- body: JSON.stringify(body),
205
- });
247
+ let resp;
248
+ try {
249
+ resp = await this.fetchImpl('https://api.anthropic.com/v1/messages', {
250
+ method: 'POST',
251
+ headers: {
252
+ 'content-type': 'application/json',
253
+ 'x-api-key': this.apiKey,
254
+ 'anthropic-version': '2023-06-01',
255
+ },
256
+ body: JSON.stringify(body),
257
+ ...(req.signal ? { signal: req.signal } : {}),
258
+ });
259
+ }
260
+ catch (e) {
261
+ /* an interrupt mid-request surfaces as an AbortError -> treat as
262
+ * a controlled stop and return what completed so far. */
263
+ if (req.signal?.aborted || (e instanceof Error && e.name === 'AbortError')) {
264
+ interrupted = true;
265
+ break;
266
+ }
267
+ throw e;
268
+ }
206
269
  if (!resp.ok) {
207
270
  const detail = await safeText(resp);
208
271
  throw new ClaudeApiError('Claude API ' + resp.status + ': ' + detail.slice(0, 500), resp.status);
209
272
  }
210
273
  const data = await resp.json();
211
- totalTokensIn += data.usage?.input_tokens ?? 0;
212
- totalTokensOut += data.usage?.output_tokens ?? 0;
274
+ const roundIn = data.usage?.input_tokens ?? 0;
275
+ const roundOut = data.usage?.output_tokens ?? 0;
276
+ totalTokensIn += roundIn;
277
+ totalTokensOut += roundOut;
213
278
  usedModel = data.model ?? model;
279
+ /* Best-effort telemetry. Fire-and-forget; failures inside
280
+ recordUsage are already swallowed. */
281
+ void recordUsage({
282
+ kind: req.usageKind ?? 'claude.chat',
283
+ model: usedModel,
284
+ tokens_in: roundIn,
285
+ tokens_out: roundOut,
286
+ label: req.usageLabel,
287
+ project_root: req.projectRoot,
288
+ });
214
289
  const blocks = data.content ?? [];
215
290
  const textBlocks = blocks.filter((b) => b.type === 'text');
216
291
  const toolUses = blocks.filter((b) => b.type === 'tool_use');
217
292
  lastText = textBlocks.map((b) => b.text).join('');
218
293
  if (toolUses.length === 0 || data.stop_reason !== 'tool_use') {
219
294
  /* No tools called -- return whatever the model said. */
295
+ /* alpha.59z.14 F104 -- detect truncation: output_tokens
296
+ * within TRUNCATION_MARGIN of max_tokens OR provider says
297
+ * stop_reason=max_tokens|length. Provider-agnostic
298
+ * arithmetic-first per Pablo's design. */
299
+ const { detectTruncation } = await import('../core/truncation_detector.js');
300
+ const trunc = detectTruncation({
301
+ output_tokens: roundOut,
302
+ max_tokens: maxTokens,
303
+ stop_reason: data.stop_reason,
304
+ });
220
305
  return {
221
306
  text: lastText,
222
307
  tokensIn: totalTokensIn,
223
308
  tokensOut: totalTokensOut,
224
309
  model: usedModel,
225
310
  toolRounds,
311
+ truncation: trunc.truncated ? {
312
+ truncated: true,
313
+ reason: trunc.reason,
314
+ output_tokens: trunc.output_tokens,
315
+ max_tokens: trunc.max_tokens,
316
+ } : undefined,
226
317
  };
227
318
  }
319
+ /* alpha.59c -- detect verb family from first tool_use, raise
320
+ * cap for reader/search/writer turns. Only grows. */
321
+ if (familyResolved === null && toolUses.length > 0) {
322
+ const first = toolUses[0];
323
+ if (first) {
324
+ const firstVerb = first.input.verb_id || first.name || '';
325
+ const family = classifyVerbFamily(firstVerb);
326
+ familyResolved = family;
327
+ /* Only auto-bump the cap when the caller did NOT pin
328
+ * it. Explicit req.maxToolRounds is the caller's
329
+ * contract -- preserving it keeps tests + callers
330
+ * predictable. */
331
+ if (!callerSpecifiedCap) {
332
+ const familyCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, family);
333
+ if (familyCap > maxRounds)
334
+ maxRounds = familyCap;
335
+ }
336
+ }
337
+ }
228
338
  if (round === maxRounds) {
229
- throw new ClaudeApiError('tool_use loop exhausted (' + maxRounds + ' rounds). Last text: '
230
- + (lastText ? lastText.slice(0, 200) : '(none)'), 429);
339
+ /* alpha.59c -- graceful exhaustion. Return what we have
340
+ * with a helpful summary instead of throwing. The caller
341
+ * (server.ts handleChat) treats this like any other
342
+ * reply; the panel shows it with a "loop exhausted"
343
+ * badge. */
344
+ const firstTu = toolUses[0];
345
+ const lastVerb = firstTu
346
+ ? (firstTu.input.verb_id || firstTu.name || 'unknown')
347
+ : 'unknown';
348
+ const summary = (lastText ? lastText + '\n\n' : '') +
349
+ '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds + ') ' +
350
+ 'en esta tarea (familia=' + (familyResolved ?? 'default') + ', ultimo verbo=' + lastVerb + '). ' +
351
+ 'Decime "continua" y sigo desde aca, o sube el cap en yf limits set max_tool_rounds.' +
352
+ (familyResolved ?? 'default') + ' <N>.]';
353
+ return {
354
+ text: summary,
355
+ tokensIn: totalTokensIn,
356
+ tokensOut: totalTokensOut,
357
+ model: usedModel,
358
+ toolRounds,
359
+ };
231
360
  }
232
361
  /* Persist the assistant turn (text + tool_use blocks) so
233
362
  Anthropic sees the full history on the next round. */
@@ -235,6 +364,8 @@ export class ClaudeClient {
235
364
  /* Dispatch each tool_use, build the user follow-up with one
236
365
  tool_result per call. */
237
366
  const toolResultBlocks = [];
367
+ let roundAllErrors = toolUses.length > 0;
368
+ let roundVerb = null;
238
369
  for (const tu of toolUses) {
239
370
  const r = await req.runTool(tu.name, tu.input);
240
371
  toolRounds.push({
@@ -250,10 +381,54 @@ export class ClaudeClient {
250
381
  content: typeof r.result === 'string' ? r.result : JSON.stringify(r.result),
251
382
  ...(r.is_error ? { is_error: true } : {}),
252
383
  });
384
+ if (!r.is_error)
385
+ roundAllErrors = false;
386
+ const verbId = tu.input.verb_id || tu.name;
387
+ if (roundVerb === null)
388
+ roundVerb = verbId;
389
+ }
390
+ /* PND-065 -- contabilizar racha de fallos del mismo verbo. */
391
+ if (roundAllErrors && roundVerb !== null) {
392
+ failStreak = roundVerb === lastFailVerb ? failStreak + 1 : 1;
393
+ lastFailVerb = roundVerb;
394
+ }
395
+ else {
396
+ failStreak = 0;
397
+ lastFailVerb = null;
398
+ }
399
+ if (failStreak >= STREAK_LIMIT) {
400
+ const summary = (lastText ? lastText + '\n\n' : '') +
401
+ '[Me detuve: el verbo "' + lastFailVerb + '" fallo ' + failStreak +
402
+ ' veces seguidas y no estaba avanzando. Asi evito gastar el ' +
403
+ 'presupuesto de la tarea repitiendo lo mismo. Contame que ' +
404
+ 'querias lograr y busco otra via, o revisa el detalle del ' +
405
+ 'error en Activity.]';
406
+ return {
407
+ text: summary,
408
+ tokensIn: totalTokensIn,
409
+ tokensOut: totalTokensOut,
410
+ model: usedModel,
411
+ toolRounds,
412
+ };
253
413
  }
254
414
  messages.push({ role: 'user', content: toolResultBlocks });
255
415
  }
256
- /* Unreachable: the loop exits via return or throw. */
416
+ /* Controlled-fall interrupt: the loop broke between rounds. Return
417
+ * what completed so far, flagged, instead of throwing. */
418
+ if (interrupted) {
419
+ const partial = (lastText && lastText.trim().length > 0)
420
+ ? lastText + '\n\n[Interrumpido por el usuario.]'
421
+ : '[Turno interrumpido por el usuario. Lo que se alcanzo a hacer quedo aplicado.]';
422
+ return {
423
+ text: partial,
424
+ tokensIn: totalTokensIn,
425
+ tokensOut: totalTokensOut,
426
+ model: usedModel,
427
+ toolRounds,
428
+ interrupted: true,
429
+ };
430
+ }
431
+ /* Unreachable in normal flow: the loop exits via return or throw. */
257
432
  throw new ClaudeApiError('tool_use loop terminated unexpectedly', 500);
258
433
  }
259
434
  }
@@ -1 +1 @@
1
- {"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/chat/claude.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/chat/claude.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,155 @@
1
+ /**
2
+ * Yujin Forge -- Claude Code CLI subprocess client.
3
+ *
4
+ * Drop-in alternative to `ClaudeClient` that routes every chat turn
5
+ * through the `claude -p` binary instead of the Anthropic HTTP API.
6
+ * Billing flows against the user's Claude Code subscription
7
+ * (`apiKeySource: "none"`) instead of the Console balance.
8
+ *
9
+ * Trade-offs vs ClaudeClient (the HTTP path):
10
+ *
11
+ * * The `claude -p` subprocess owns the tool-use loop. The caller's
12
+ * `tools` + `runTool` are ignored; the subprocess uses Claude
13
+ * Code's native tool surface (Read, Edit, Write, Bash, Glob, Grep,
14
+ * Task, plus any MCP servers configured in the user's
15
+ * `~/.claude/config`). This is intentional: for build-side
16
+ * workflows (the redesign/sumi-forge target), the native tools are
17
+ * strictly more efficient than text-routed NAC3 invokes.
18
+ *
19
+ * * Each `chat()` call spawns one subprocess. Latency is dominated
20
+ * by the subprocess startup (~500 ms-1 s) on top of the LLM turn.
21
+ * The output is parsed from the JSONL stream the binary writes to
22
+ * stdout when invoked with `--output-format stream-json --verbose`.
23
+ *
24
+ * * Token + cost accounting comes from the `result` event the binary
25
+ * emits at the end of the run. Those values reflect what the user
26
+ * subscription consumed; they are reported back as `tokensIn` /
27
+ * `tokensOut` for parity with ClaudeClient, with the qualification
28
+ * that under subscription billing the marginal $ cost is zero.
29
+ *
30
+ * * Multi-turn conversation history is concatenated into a single
31
+ * prompt the subprocess sees on stdin. The subprocess does not
32
+ * receive a structured `messages[]` array; the convention is the
33
+ * same role-tagged format the Anthropic SDK uses internally
34
+ * (User: / Assistant:).
35
+ *
36
+ * * No truncation detection: the subprocess does not report stop
37
+ * reasons in a comparable way. The `truncation` field of the
38
+ * response is left undefined.
39
+ *
40
+ * ASCII-only.
41
+ */
42
+ import { type ChildProcess } from 'node:child_process';
43
+ import { type SupportedLanguage } from '../i18n/index.js';
44
+ import { type ChatLLMClient, type ClaudeChatRequest, type ClaudeChatResponse } from './claude.js';
45
+ export interface ClaudeCliClientOptions {
46
+ /** Override the `claude` binary path. Defaults to "claude" (PATH-resolved). */
47
+ binary?: string;
48
+ /** Additional directories to grant tool access to via --add-dir. */
49
+ addDirs?: string[];
50
+ /** Allow-list of tools (passed verbatim to --allowed-tools). When
51
+ * unset, all default tools are allowed (bypassPermissions is on). */
52
+ allowedTools?: string[];
53
+ /** Permission mode: 'bypassPermissions' (default, autopilot) |
54
+ * 'default' (interactive). */
55
+ permissionMode?: 'bypassPermissions' | 'default';
56
+ /** Default model: 'sonnet' | 'opus' | 'haiku' | model ID. */
57
+ model?: string;
58
+ /** Hard cap on total subprocess wall-clock. Default 30 min. */
59
+ timeoutMs?: number;
60
+ /** PND-064 slice B -- panel bridge. When set, the subprocess gets
61
+ * the forge_panel MCP server so `claude -p` can create pizarron
62
+ * tabs (the only way to reach the panel in CLI mode). The token
63
+ * + port are handed to the MCP server via its env so it can
64
+ * POST /api/forge/panel-push back to this chat server. */
65
+ panelBridge?: {
66
+ port: number;
67
+ token: string;
68
+ };
69
+ /** Test seam: injectable spawn for unit tests that need to feed
70
+ * a canned stdout JSONL stream without running the real binary. */
71
+ spawnImpl?: (cmd: string, args: string[], opts: Record<string, unknown>) => ChildProcess;
72
+ }
73
+ /** True when `m` is a Claude model `claude -p` accepts (full id or the
74
+ * opus/sonnet/haiku aliases). Non-Claude ids (gemini, gpt, ...) must NOT
75
+ * be passed to claude -p -- Plan mode always runs the Claude
76
+ * subscription. */
77
+ export declare function isClaudeCliModel(m: string): boolean;
78
+ /** Map any resolved model id/alias to the stable CLI alias `claude -p`
79
+ * accepts (opus|sonnet|haiku). A full id (claude-opus-4-8) or a
80
+ * non-Claude id (gemini-*) both resolve to a sane Claude tier so the
81
+ * subscription turn never 404s on an "unknown model". */
82
+ export declare function toCliModelAlias(m: string | undefined): string;
83
+ export declare class ClaudeCliClient implements ChatLLMClient {
84
+ private readonly opts;
85
+ /** Cache of the generated mcp-config path (written once). */
86
+ private mcpConfigPath;
87
+ /** Path of the temp system-prompt file (rewritten per turn). */
88
+ private systemPromptPath;
89
+ /** Dogfood 2026-06-10 -- write the system prompt to a temp file so
90
+ * it goes via --append-system-prompt-file instead of a CLI arg
91
+ * (Windows ~32 KB command-line limit -> spawn ENAMETOOLONG). The
92
+ * same path is reused (overwritten) each turn. */
93
+ private writeSystemPromptFile;
94
+ constructor(opts?: ClaudeCliClientOptions);
95
+ /** PND-064 slice B -- write (once) the mcp-config that points
96
+ * `claude -p` at the forge_panel MCP server, with the port +
97
+ * token in the server's env block so it can POST back to us.
98
+ * Returns null when no panel bridge is configured. */
99
+ private ensureMcpConfig;
100
+ /** Convenience for callers (and tests) that want to know what
101
+ * binary + flags will run before spawning. */
102
+ buildArgs(req: ClaudeChatRequest): string[];
103
+ chat(req: ClaudeChatRequest): Promise<ClaudeChatResponse>;
104
+ }
105
+ /** Granularidad de actividad (dogfood 2026-06-10) -- traduce un
106
+ * tool_use del subproceso claude -p a una linea humana de "que
107
+ * esta haciendo ahora", para el feed en vivo del pizarron. Best
108
+ * effort: si no reconoce la herramienta, cae al nombre. */
109
+ /** Human one-liner for a tool_use, shown live in the Coding canvas.
110
+ * i18n: the EXPERIENCE phrases ("Reading X", "Running: cmd") follow
111
+ * the app language (PND -- Pablo); the PROTOCOL identifiers (NAC3
112
+ * verb ids, mcp server.tool) stay neutral ("traduci la experiencia,
113
+ * no el protocolo"). lang defaults to the current app language. */
114
+ export declare function summarizeToolUse(name: string, input: unknown, lang?: SupportedLanguage | string): string;
115
+ /** Structured detail of a tool_use for the "codewrapper" (detailed)
116
+ * mode of the Coding tab: the file it touches, a diff for edits, the
117
+ * command/pattern for the rest. Bounded so the SSE payload stays
118
+ * small. Language-neutral (the panel renders + labels it). */
119
+ export interface ToolDetail {
120
+ kind: 'edit' | 'write' | 'bash' | 'read' | 'search' | 'task' | 'todo' | 'verb' | 'other';
121
+ path: string | null;
122
+ /** A one-line target/headline (basename, command head, pattern). */
123
+ target: string;
124
+ /** Edit/MultiEdit: the before/after to render a diff. */
125
+ diff: {
126
+ old: string;
127
+ new: string;
128
+ } | null;
129
+ /** Write: new content preview; Bash: full command; else null. */
130
+ body: string | null;
131
+ }
132
+ export declare function extractToolDetail(name: string, input: unknown): ToolDetail;
133
+ /** Console / managed / other-brain path: the server runs NAC3 verbs
134
+ * (yujin.*) instead of Claude's native tools, so the codewrapper
135
+ * detail comes from a parallel adapter that maps verbs -> the same
136
+ * ToolDetail shape. write-project-file carries full content (no
137
+ * old/new), so it surfaces as a body, not a diff. */
138
+ export declare function extractVerbDetail(verbId: string, input: unknown): ToolDetail;
139
+ /** Probe `claude -p` once with a trivial prompt. Useful as a
140
+ * pre-flight before launching a long-running orchestration: a fresh
141
+ * failure here (binary missing, not logged in, rate limit window
142
+ * exhausted) is much cheaper to detect than to discover mid-sprint.
143
+ *
144
+ * Returns the rate-limit info from the system init event so the
145
+ * caller can decide whether the 5-hour window has room for the
146
+ * upcoming workload. */
147
+ export declare function probeClaudeCli(opts?: ClaudeCliClientOptions): Promise<{
148
+ ok: boolean;
149
+ apiKeySource?: string;
150
+ model?: string;
151
+ rateLimitStatus?: string;
152
+ resetsAt?: number;
153
+ error?: string;
154
+ }>;
155
+ //# sourceMappingURL=claude_cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude_cli.d.ts","sourceRoot":"","sources":["../../src/chat/claude_cli.ts"],"names":[],"mappings":"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"}