@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

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 (1052) hide show
  1. package/README.md +16 -1
  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 +295 -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 +108 -0
  43. package/dist/agents/runner.d.ts.map +1 -0
  44. package/dist/agents/runner.js +174 -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 +101 -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 +101 -2
  64. package/dist/bin/yf.js.map +1 -1
  65. package/dist/chat/claude.d.ts +89 -1
  66. package/dist/chat/claude.d.ts.map +1 -1
  67. package/dist/chat/claude.js +170 -30
  68. package/dist/chat/claude.js.map +1 -1
  69. package/dist/chat/claude_cli.d.ts +145 -0
  70. package/dist/chat/claude_cli.d.ts.map +1 -0
  71. package/dist/chat/claude_cli.js +598 -0
  72. package/dist/chat/claude_cli.js.map +1 -0
  73. package/dist/chat/completion_hallucination_detector.d.ts +40 -0
  74. package/dist/chat/completion_hallucination_detector.d.ts.map +1 -0
  75. package/dist/chat/completion_hallucination_detector.js +96 -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 +117 -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 +9640 -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 +138 -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 +98 -2
  125. package/dist/chat/server.d.ts.map +1 -1
  126. package/dist/chat/server.js +3881 -337
  127. package/dist/chat/server.js.map +1 -1
  128. package/dist/chat/spec_extract.d.ts +1 -2
  129. package/dist/chat/spec_extract.d.ts.map +1 -1
  130. package/dist/chat/spec_extract.js +41 -56
  131. package/dist/chat/spec_extract.js.map +1 -1
  132. package/dist/chat/spec_plan.d.ts +1 -2
  133. package/dist/chat/spec_plan.d.ts.map +1 -1
  134. package/dist/chat/spec_plan.js +36 -57
  135. package/dist/chat/spec_plan.js.map +1 -1
  136. package/dist/chat/tools/app_backend_dispatch.d.ts +39 -0
  137. package/dist/chat/tools/app_backend_dispatch.d.ts.map +1 -0
  138. package/dist/chat/tools/app_backend_dispatch.js +239 -0
  139. package/dist/chat/tools/app_backend_dispatch.js.map +1 -0
  140. package/dist/chat/tools/audit_consumers.d.ts +66 -0
  141. package/dist/chat/tools/audit_consumers.d.ts.map +1 -0
  142. package/dist/chat/tools/audit_consumers.js +231 -0
  143. package/dist/chat/tools/audit_consumers.js.map +1 -0
  144. package/dist/chat/tools/fs_editor.d.ts +11 -0
  145. package/dist/chat/tools/fs_editor.d.ts.map +1 -0
  146. package/dist/chat/tools/fs_editor.js +162 -0
  147. package/dist/chat/tools/fs_editor.js.map +1 -0
  148. package/dist/chat/tools/git.d.ts +24 -0
  149. package/dist/chat/tools/git.d.ts.map +1 -1
  150. package/dist/chat/tools/git.js +78 -0
  151. package/dist/chat/tools/git.js.map +1 -1
  152. package/dist/chat/tools/graph.d.ts +43 -0
  153. package/dist/chat/tools/graph.d.ts.map +1 -0
  154. package/dist/chat/tools/graph.js +174 -0
  155. package/dist/chat/tools/graph.js.map +1 -0
  156. package/dist/chat/tools/keys.d.ts +9 -0
  157. package/dist/chat/tools/keys.d.ts.map +1 -0
  158. package/dist/chat/tools/keys.js +169 -0
  159. package/dist/chat/tools/keys.js.map +1 -0
  160. package/dist/chat/tools/misc_verbs.d.ts +36 -0
  161. package/dist/chat/tools/misc_verbs.d.ts.map +1 -0
  162. package/dist/chat/tools/misc_verbs.js +405 -0
  163. package/dist/chat/tools/misc_verbs.js.map +1 -0
  164. package/dist/chat/tools/nac3_invoke.d.ts +58 -0
  165. package/dist/chat/tools/nac3_invoke.d.ts.map +1 -0
  166. package/dist/chat/tools/nac3_invoke.js +887 -0
  167. package/dist/chat/tools/nac3_invoke.js.map +1 -0
  168. package/dist/chat/tools/pending.d.ts +69 -0
  169. package/dist/chat/tools/pending.d.ts.map +1 -0
  170. package/dist/chat/tools/pending.js +167 -0
  171. package/dist/chat/tools/pending.js.map +1 -0
  172. package/dist/chat/tools/pizarron.d.ts +40 -0
  173. package/dist/chat/tools/pizarron.d.ts.map +1 -0
  174. package/dist/chat/tools/pizarron.js +123 -0
  175. package/dist/chat/tools/pizarron.js.map +1 -0
  176. package/dist/chat/tools/project_lifecycle.d.ts +24 -0
  177. package/dist/chat/tools/project_lifecycle.d.ts.map +1 -0
  178. package/dist/chat/tools/project_lifecycle.js +212 -0
  179. package/dist/chat/tools/project_lifecycle.js.map +1 -0
  180. package/dist/chat/tools/reader.d.ts.map +1 -1
  181. package/dist/chat/tools/reader.js +144 -1
  182. package/dist/chat/tools/reader.js.map +1 -1
  183. package/dist/chat/tools/shell.d.ts +58 -0
  184. package/dist/chat/tools/shell.d.ts.map +1 -0
  185. package/dist/chat/tools/shell.js +253 -0
  186. package/dist/chat/tools/shell.js.map +1 -0
  187. package/dist/chat/tools/wiring.d.ts +28 -0
  188. package/dist/chat/tools/wiring.d.ts.map +1 -0
  189. package/dist/chat/tools/wiring.js +116 -0
  190. package/dist/chat/tools/wiring.js.map +1 -0
  191. package/dist/chat/tools/workflow.d.ts +55 -0
  192. package/dist/chat/tools/workflow.d.ts.map +1 -0
  193. package/dist/chat/tools/workflow.js +463 -0
  194. package/dist/chat/tools/workflow.js.map +1 -0
  195. package/dist/chat/tools.d.ts +42 -0
  196. package/dist/chat/tools.d.ts.map +1 -1
  197. package/dist/chat/tools.js +451 -13
  198. package/dist/chat/tools.js.map +1 -1
  199. package/dist/chat/wiring_inject.d.ts +18 -0
  200. package/dist/chat/wiring_inject.d.ts.map +1 -0
  201. package/dist/chat/wiring_inject.js +78 -0
  202. package/dist/chat/wiring_inject.js.map +1 -0
  203. package/dist/chat/workflow_inject.d.ts +52 -0
  204. package/dist/chat/workflow_inject.d.ts.map +1 -0
  205. package/dist/chat/workflow_inject.js +346 -0
  206. package/dist/chat/workflow_inject.js.map +1 -0
  207. package/dist/chat/yujin_splash.d.ts +27 -0
  208. package/dist/chat/yujin_splash.d.ts.map +1 -0
  209. package/dist/chat/yujin_splash.js +147 -0
  210. package/dist/chat/yujin_splash.js.map +1 -0
  211. package/dist/commands/agent.d.ts +33 -0
  212. package/dist/commands/agent.d.ts.map +1 -0
  213. package/dist/commands/agent.js +281 -0
  214. package/dist/commands/agent.js.map +1 -0
  215. package/dist/commands/approve.d.ts +32 -0
  216. package/dist/commands/approve.d.ts.map +1 -0
  217. package/dist/commands/approve.js +198 -0
  218. package/dist/commands/approve.js.map +1 -0
  219. package/dist/commands/block.d.ts +28 -0
  220. package/dist/commands/block.d.ts.map +1 -0
  221. package/dist/commands/block.js +189 -0
  222. package/dist/commands/block.js.map +1 -0
  223. package/dist/commands/bootstrap.d.ts +35 -0
  224. package/dist/commands/bootstrap.d.ts.map +1 -0
  225. package/dist/commands/bootstrap.js +205 -0
  226. package/dist/commands/bootstrap.js.map +1 -0
  227. package/dist/commands/brain.d.ts +17 -0
  228. package/dist/commands/brain.d.ts.map +1 -0
  229. package/dist/commands/brain.js +129 -0
  230. package/dist/commands/brain.js.map +1 -0
  231. package/dist/commands/chat.d.ts +10 -0
  232. package/dist/commands/chat.d.ts.map +1 -1
  233. package/dist/commands/chat.js +209 -17
  234. package/dist/commands/chat.js.map +1 -1
  235. package/dist/commands/clarify.d.ts +30 -0
  236. package/dist/commands/clarify.d.ts.map +1 -0
  237. package/dist/commands/clarify.js +671 -0
  238. package/dist/commands/clarify.js.map +1 -0
  239. package/dist/commands/director.d.ts +37 -0
  240. package/dist/commands/director.d.ts.map +1 -0
  241. package/dist/commands/director.js +290 -0
  242. package/dist/commands/director.js.map +1 -0
  243. package/dist/commands/discover.d.ts +30 -0
  244. package/dist/commands/discover.d.ts.map +1 -0
  245. package/dist/commands/discover.js +178 -0
  246. package/dist/commands/discover.js.map +1 -0
  247. package/dist/commands/doctor.d.ts +18 -0
  248. package/dist/commands/doctor.d.ts.map +1 -1
  249. package/dist/commands/doctor.js +120 -4
  250. package/dist/commands/doctor.js.map +1 -1
  251. package/dist/commands/doctrine.d.ts +24 -0
  252. package/dist/commands/doctrine.d.ts.map +1 -0
  253. package/dist/commands/doctrine.js +106 -0
  254. package/dist/commands/doctrine.js.map +1 -0
  255. package/dist/commands/doctrines.d.ts +21 -0
  256. package/dist/commands/doctrines.d.ts.map +1 -0
  257. package/dist/commands/doctrines.js +158 -0
  258. package/dist/commands/doctrines.js.map +1 -0
  259. package/dist/commands/graph.d.ts +29 -0
  260. package/dist/commands/graph.d.ts.map +1 -0
  261. package/dist/commands/graph.js +362 -0
  262. package/dist/commands/graph.js.map +1 -0
  263. package/dist/commands/keys_setup.d.ts +18 -0
  264. package/dist/commands/keys_setup.d.ts.map +1 -1
  265. package/dist/commands/keys_setup.js +225 -11
  266. package/dist/commands/keys_setup.js.map +1 -1
  267. package/dist/commands/legacy-audit.d.ts +34 -0
  268. package/dist/commands/legacy-audit.d.ts.map +1 -0
  269. package/dist/commands/legacy-audit.js +270 -0
  270. package/dist/commands/legacy-audit.js.map +1 -0
  271. package/dist/commands/lessons.d.ts +28 -0
  272. package/dist/commands/lessons.d.ts.map +1 -0
  273. package/dist/commands/lessons.js +309 -0
  274. package/dist/commands/lessons.js.map +1 -0
  275. package/dist/commands/license.d.ts.map +1 -1
  276. package/dist/commands/license.js +56 -1
  277. package/dist/commands/license.js.map +1 -1
  278. package/dist/commands/limits.d.ts +15 -0
  279. package/dist/commands/limits.d.ts.map +1 -0
  280. package/dist/commands/limits.js +51 -0
  281. package/dist/commands/limits.js.map +1 -0
  282. package/dist/commands/manifest-cli.d.ts +12 -0
  283. package/dist/commands/manifest-cli.d.ts.map +1 -0
  284. package/dist/commands/manifest-cli.js +42 -0
  285. package/dist/commands/manifest-cli.js.map +1 -0
  286. package/dist/commands/mcp.d.ts +24 -0
  287. package/dist/commands/mcp.d.ts.map +1 -0
  288. package/dist/commands/mcp.js +163 -0
  289. package/dist/commands/mcp.js.map +1 -0
  290. package/dist/commands/mobile.d.ts +15 -0
  291. package/dist/commands/mobile.d.ts.map +1 -1
  292. package/dist/commands/mobile.js +27 -24
  293. package/dist/commands/mobile.js.map +1 -1
  294. package/dist/commands/nac3.d.ts +22 -0
  295. package/dist/commands/nac3.d.ts.map +1 -0
  296. package/dist/commands/nac3.js +125 -0
  297. package/dist/commands/nac3.js.map +1 -0
  298. package/dist/commands/operate.d.ts +22 -0
  299. package/dist/commands/operate.d.ts.map +1 -0
  300. package/dist/commands/operate.js +523 -0
  301. package/dist/commands/operate.js.map +1 -0
  302. package/dist/commands/pending.d.ts +22 -0
  303. package/dist/commands/pending.d.ts.map +1 -0
  304. package/dist/commands/pending.js +341 -0
  305. package/dist/commands/pending.js.map +1 -0
  306. package/dist/commands/qa.d.ts +24 -0
  307. package/dist/commands/qa.d.ts.map +1 -0
  308. package/dist/commands/qa.js +349 -0
  309. package/dist/commands/qa.js.map +1 -0
  310. package/dist/commands/spec.d.ts +38 -0
  311. package/dist/commands/spec.d.ts.map +1 -0
  312. package/dist/commands/spec.js +256 -0
  313. package/dist/commands/spec.js.map +1 -0
  314. package/dist/commands/support.d.ts +22 -0
  315. package/dist/commands/support.d.ts.map +1 -0
  316. package/dist/commands/support.js +165 -0
  317. package/dist/commands/support.js.map +1 -0
  318. package/dist/commands/test_agent.d.ts +22 -0
  319. package/dist/commands/test_agent.d.ts.map +1 -0
  320. package/dist/commands/test_agent.js +100 -0
  321. package/dist/commands/test_agent.js.map +1 -0
  322. package/dist/commands/triage.d.ts +34 -0
  323. package/dist/commands/triage.d.ts.map +1 -0
  324. package/dist/commands/triage.js +228 -0
  325. package/dist/commands/triage.js.map +1 -0
  326. package/dist/commands/vault-inventory.d.ts +30 -0
  327. package/dist/commands/vault-inventory.d.ts.map +1 -0
  328. package/dist/commands/vault-inventory.js +222 -0
  329. package/dist/commands/vault-inventory.js.map +1 -0
  330. package/dist/commands/vault.d.ts.map +1 -1
  331. package/dist/commands/vault.js +5 -0
  332. package/dist/commands/vault.js.map +1 -1
  333. package/dist/commands/voice.d.ts.map +1 -1
  334. package/dist/commands/voice.js +47 -4
  335. package/dist/commands/voice.js.map +1 -1
  336. package/dist/commands/wiring.d.ts +19 -0
  337. package/dist/commands/wiring.d.ts.map +1 -0
  338. package/dist/commands/wiring.js +135 -0
  339. package/dist/commands/wiring.js.map +1 -0
  340. package/dist/commands/workflow-coverage.d.ts +30 -0
  341. package/dist/commands/workflow-coverage.d.ts.map +1 -0
  342. package/dist/commands/workflow-coverage.js +138 -0
  343. package/dist/commands/workflow-coverage.js.map +1 -0
  344. package/dist/core/ansi_strip.d.ts +39 -0
  345. package/dist/core/ansi_strip.d.ts.map +1 -0
  346. package/dist/core/ansi_strip.js +71 -0
  347. package/dist/core/ansi_strip.js.map +1 -0
  348. package/dist/core/atomic_write.d.ts +17 -0
  349. package/dist/core/atomic_write.d.ts.map +1 -0
  350. package/dist/core/atomic_write.js +51 -0
  351. package/dist/core/atomic_write.js.map +1 -0
  352. package/dist/core/audit_log.d.ts +43 -0
  353. package/dist/core/audit_log.d.ts.map +1 -0
  354. package/dist/core/audit_log.js +80 -0
  355. package/dist/core/audit_log.js.map +1 -0
  356. package/dist/core/brain_config.d.ts +50 -0
  357. package/dist/core/brain_config.d.ts.map +1 -0
  358. package/dist/core/brain_config.js +142 -0
  359. package/dist/core/brain_config.js.map +1 -0
  360. package/dist/core/budget.d.ts +96 -0
  361. package/dist/core/budget.d.ts.map +1 -0
  362. package/dist/core/budget.js +328 -0
  363. package/dist/core/budget.js.map +1 -0
  364. package/dist/core/cost_meter.d.ts +35 -0
  365. package/dist/core/cost_meter.d.ts.map +1 -0
  366. package/dist/core/cost_meter.js +111 -0
  367. package/dist/core/cost_meter.js.map +1 -0
  368. package/dist/core/cost_router.d.ts +106 -0
  369. package/dist/core/cost_router.d.ts.map +1 -0
  370. package/dist/core/cost_router.js +589 -0
  371. package/dist/core/cost_router.js.map +1 -0
  372. package/dist/core/doctrine_resolver.d.ts +23 -0
  373. package/dist/core/doctrine_resolver.d.ts.map +1 -0
  374. package/dist/core/doctrine_resolver.js +108 -0
  375. package/dist/core/doctrine_resolver.js.map +1 -0
  376. package/dist/core/error_catalog.d.ts +80 -0
  377. package/dist/core/error_catalog.d.ts.map +1 -0
  378. package/dist/core/error_catalog.js +168 -0
  379. package/dist/core/error_catalog.js.map +1 -0
  380. package/dist/core/error_formatter.d.ts +30 -0
  381. package/dist/core/error_formatter.d.ts.map +1 -0
  382. package/dist/core/error_formatter.js +155 -0
  383. package/dist/core/error_formatter.js.map +1 -0
  384. package/dist/core/incomplete_detector.d.ts +51 -0
  385. package/dist/core/incomplete_detector.d.ts.map +1 -0
  386. package/dist/core/incomplete_detector.js +140 -0
  387. package/dist/core/incomplete_detector.js.map +1 -0
  388. package/dist/core/keys_envelope.d.ts.map +1 -1
  389. package/dist/core/keys_envelope.js +14 -9
  390. package/dist/core/keys_envelope.js.map +1 -1
  391. package/dist/core/learnings_client.d.ts +104 -0
  392. package/dist/core/learnings_client.d.ts.map +1 -0
  393. package/dist/core/learnings_client.js +262 -0
  394. package/dist/core/learnings_client.js.map +1 -0
  395. package/dist/core/limits_config.d.ts +76 -0
  396. package/dist/core/limits_config.d.ts.map +1 -0
  397. package/dist/core/limits_config.js +297 -0
  398. package/dist/core/limits_config.js.map +1 -0
  399. package/dist/core/pairing.d.ts +1 -0
  400. package/dist/core/pairing.d.ts.map +1 -1
  401. package/dist/core/pairing.js +23 -12
  402. package/dist/core/pairing.js.map +1 -1
  403. package/dist/core/pilot_setup.d.ts +29 -3
  404. package/dist/core/pilot_setup.d.ts.map +1 -1
  405. package/dist/core/pilot_setup.js +130 -3
  406. package/dist/core/pilot_setup.js.map +1 -1
  407. package/dist/core/provider_keys.d.ts +35 -0
  408. package/dist/core/provider_keys.d.ts.map +1 -0
  409. package/dist/core/provider_keys.js +267 -0
  410. package/dist/core/provider_keys.js.map +1 -0
  411. package/dist/core/provider_models.d.ts +27 -0
  412. package/dist/core/provider_models.d.ts.map +1 -0
  413. package/dist/core/provider_models.js +169 -0
  414. package/dist/core/provider_models.js.map +1 -0
  415. package/dist/core/reasoning_gate.d.ts +72 -0
  416. package/dist/core/reasoning_gate.d.ts.map +1 -0
  417. package/dist/core/reasoning_gate.js +205 -0
  418. package/dist/core/reasoning_gate.js.map +1 -0
  419. package/dist/core/shell_classifier.d.ts +49 -0
  420. package/dist/core/shell_classifier.d.ts.map +1 -0
  421. package/dist/core/shell_classifier.js +159 -0
  422. package/dist/core/shell_classifier.js.map +1 -0
  423. package/dist/core/sq_resolver.d.ts +14 -0
  424. package/dist/core/sq_resolver.d.ts.map +1 -0
  425. package/dist/core/sq_resolver.js +230 -0
  426. package/dist/core/sq_resolver.js.map +1 -0
  427. package/dist/core/truncation_detector.d.ts +68 -0
  428. package/dist/core/truncation_detector.d.ts.map +1 -0
  429. package/dist/core/truncation_detector.js +115 -0
  430. package/dist/core/truncation_detector.js.map +1 -0
  431. package/dist/core/turn_classifier.d.ts +70 -0
  432. package/dist/core/turn_classifier.d.ts.map +1 -0
  433. package/dist/core/turn_classifier.js +324 -0
  434. package/dist/core/turn_classifier.js.map +1 -0
  435. package/dist/core/vad_config.d.ts +34 -0
  436. package/dist/core/vad_config.d.ts.map +1 -0
  437. package/dist/core/vad_config.js +95 -0
  438. package/dist/core/vad_config.js.map +1 -0
  439. package/dist/core/whats_new.d.ts +42 -0
  440. package/dist/core/whats_new.d.ts.map +1 -0
  441. package/dist/core/whats_new.js +214 -0
  442. package/dist/core/whats_new.js.map +1 -0
  443. package/dist/core/wizard_state.d.ts +15 -0
  444. package/dist/core/wizard_state.d.ts.map +1 -0
  445. package/dist/core/wizard_state.js +86 -0
  446. package/dist/core/wizard_state.js.map +1 -0
  447. package/dist/deploy/adapter.d.ts +93 -0
  448. package/dist/deploy/adapter.d.ts.map +1 -0
  449. package/dist/deploy/adapter.js +42 -0
  450. package/dist/deploy/adapter.js.map +1 -0
  451. package/dist/deploy/aws_adapter.d.ts +28 -0
  452. package/dist/deploy/aws_adapter.d.ts.map +1 -0
  453. package/dist/deploy/aws_adapter.js +98 -0
  454. package/dist/deploy/aws_adapter.js.map +1 -0
  455. package/dist/deploy/cloudflare.d.ts +24 -0
  456. package/dist/deploy/cloudflare.d.ts.map +1 -0
  457. package/dist/deploy/cloudflare.js +169 -0
  458. package/dist/deploy/cloudflare.js.map +1 -0
  459. package/dist/design/yujin_design_resolver.d.ts +77 -0
  460. package/dist/design/yujin_design_resolver.d.ts.map +1 -0
  461. package/dist/design/yujin_design_resolver.js +113 -0
  462. package/dist/design/yujin_design_resolver.js.map +1 -0
  463. package/dist/docs/LIMITED_RESPONSIBILITY.md +216 -0
  464. package/dist/docs/PRIVACY_POLICY.md +169 -0
  465. package/dist/docs/SQ.md +1397 -0
  466. package/dist/docs/SQ_BY_STEP.yaml +147 -0
  467. package/dist/docs/doctrine/accessibility.md +78 -0
  468. package/dist/docs/doctrine/agent-orchestrator.md +76 -0
  469. package/dist/docs/doctrine/byok-vs-managed.md +81 -0
  470. package/dist/docs/doctrine/cost-router-escalation.md +103 -0
  471. package/dist/docs/doctrine/default-design-system.md +120 -0
  472. package/dist/docs/doctrine/explain-results.md +90 -0
  473. package/dist/docs/doctrine/expo-eas-builds.md +177 -0
  474. package/dist/docs/doctrine/g-doc.md +46 -0
  475. package/dist/docs/doctrine/gates.md +21 -0
  476. package/dist/docs/doctrine/language-sovereignty.md +143 -0
  477. package/dist/docs/doctrine/lessons-workflow.md +68 -0
  478. package/dist/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  479. package/dist/docs/doctrine/nac3-attrs.md +23 -0
  480. package/dist/docs/doctrine/office-tools.md +102 -0
  481. package/dist/docs/doctrine/pizarron.md +52 -0
  482. package/dist/docs/doctrine/r8-modal.md +60 -0
  483. package/dist/docs/doctrine/safety-refusals.md +73 -0
  484. package/dist/docs/doctrine/testing-policy.md +211 -0
  485. package/dist/docs/doctrine/verb-composition.md +68 -0
  486. package/dist/docs/doctrine/verification-honesty.md +95 -0
  487. package/dist/docs/doctrine/workflow-kinds.md +52 -0
  488. package/dist/docs/doctrine/workflow-phases.md +108 -0
  489. package/dist/docs/doctrine/workflow.md +58 -0
  490. package/dist/docs/doctrine/yf-commands.md +49 -0
  491. package/dist/json/query.d.ts +38 -0
  492. package/dist/json/query.d.ts.map +1 -0
  493. package/dist/json/query.js +177 -0
  494. package/dist/json/query.js.map +1 -0
  495. package/dist/license/hito4_client.d.ts +7 -0
  496. package/dist/license/hito4_client.d.ts.map +1 -1
  497. package/dist/license/hito4_client.js +52 -2
  498. package/dist/license/hito4_client.js.map +1 -1
  499. package/dist/license/index.d.ts.map +1 -1
  500. package/dist/license/index.js +7 -0
  501. package/dist/license/index.js.map +1 -1
  502. package/dist/license/sync.d.ts +59 -0
  503. package/dist/license/sync.d.ts.map +1 -0
  504. package/dist/license/sync.js +148 -0
  505. package/dist/license/sync.js.map +1 -0
  506. package/dist/llm/cohere_client.d.ts +81 -0
  507. package/dist/llm/cohere_client.d.ts.map +1 -0
  508. package/dist/llm/cohere_client.js +195 -0
  509. package/dist/llm/cohere_client.js.map +1 -0
  510. package/dist/llm/deepseek_client.d.ts +63 -0
  511. package/dist/llm/deepseek_client.d.ts.map +1 -0
  512. package/dist/llm/deepseek_client.js +188 -0
  513. package/dist/llm/deepseek_client.js.map +1 -0
  514. package/dist/llm/gemini_client.d.ts +78 -0
  515. package/dist/llm/gemini_client.d.ts.map +1 -0
  516. package/dist/llm/gemini_client.js +189 -0
  517. package/dist/llm/gemini_client.js.map +1 -0
  518. package/dist/llm/managed_client.d.ts +70 -0
  519. package/dist/llm/managed_client.d.ts.map +1 -0
  520. package/dist/llm/managed_client.js +251 -0
  521. package/dist/llm/managed_client.js.map +1 -0
  522. package/dist/llm/mistral_client.d.ts +54 -0
  523. package/dist/llm/mistral_client.d.ts.map +1 -0
  524. package/dist/llm/mistral_client.js +174 -0
  525. package/dist/llm/mistral_client.js.map +1 -0
  526. package/dist/llm/multi_provider_client.d.ts +57 -0
  527. package/dist/llm/multi_provider_client.d.ts.map +1 -0
  528. package/dist/llm/multi_provider_client.js +109 -0
  529. package/dist/llm/multi_provider_client.js.map +1 -0
  530. package/dist/llm/openai_client.d.ts +77 -0
  531. package/dist/llm/openai_client.d.ts.map +1 -0
  532. package/dist/llm/openai_client.js +200 -0
  533. package/dist/llm/openai_client.js.map +1 -0
  534. package/dist/llm/xai_client.d.ts +51 -0
  535. package/dist/llm/xai_client.d.ts.map +1 -0
  536. package/dist/llm/xai_client.js +174 -0
  537. package/dist/llm/xai_client.js.map +1 -0
  538. package/dist/mcp/blocklist.d.ts +19 -0
  539. package/dist/mcp/blocklist.d.ts.map +1 -0
  540. package/dist/mcp/blocklist.js +118 -0
  541. package/dist/mcp/blocklist.js.map +1 -0
  542. package/dist/mcp/bridge_registry.d.ts +77 -0
  543. package/dist/mcp/bridge_registry.d.ts.map +1 -0
  544. package/dist/mcp/bridge_registry.js +220 -0
  545. package/dist/mcp/bridge_registry.js.map +1 -0
  546. package/dist/mcp/config.d.ts +25 -0
  547. package/dist/mcp/config.d.ts.map +1 -0
  548. package/dist/mcp/config.js +116 -0
  549. package/dist/mcp/config.js.map +1 -0
  550. package/dist/mcp/forge_panel_server.d.ts +46 -0
  551. package/dist/mcp/forge_panel_server.d.ts.map +1 -0
  552. package/dist/mcp/forge_panel_server.js +166 -0
  553. package/dist/mcp/forge_panel_server.js.map +1 -0
  554. package/dist/mcp/lan_scan.d.ts +36 -0
  555. package/dist/mcp/lan_scan.d.ts.map +1 -0
  556. package/dist/mcp/lan_scan.js +130 -0
  557. package/dist/mcp/lan_scan.js.map +1 -0
  558. package/dist/mcp/protocol_client.d.ts +63 -0
  559. package/dist/mcp/protocol_client.d.ts.map +1 -0
  560. package/dist/mcp/protocol_client.js +340 -0
  561. package/dist/mcp/protocol_client.js.map +1 -0
  562. package/dist/mcp/state.d.ts +38 -0
  563. package/dist/mcp/state.d.ts.map +1 -0
  564. package/dist/mcp/state.js +144 -0
  565. package/dist/mcp/state.js.map +1 -0
  566. package/dist/migrate/ai-decorator.d.ts.map +1 -1
  567. package/dist/migrate/ai-decorator.js +55 -143
  568. package/dist/migrate/ai-decorator.js.map +1 -1
  569. package/dist/nac3/approval_queue.d.ts +44 -0
  570. package/dist/nac3/approval_queue.d.ts.map +1 -0
  571. package/dist/nac3/approval_queue.js +105 -0
  572. package/dist/nac3/approval_queue.js.map +1 -0
  573. package/dist/nac3/backend_tools.d.ts +89 -0
  574. package/dist/nac3/backend_tools.d.ts.map +1 -0
  575. package/dist/nac3/backend_tools.js +271 -0
  576. package/dist/nac3/backend_tools.js.map +1 -0
  577. package/dist/nac3/dispatch_log.d.ts +35 -0
  578. package/dist/nac3/dispatch_log.d.ts.map +1 -0
  579. package/dist/nac3/dispatch_log.js +126 -0
  580. package/dist/nac3/dispatch_log.js.map +1 -0
  581. package/dist/nac3/internal_manifest.d.ts +62 -0
  582. package/dist/nac3/internal_manifest.d.ts.map +1 -0
  583. package/dist/nac3/internal_manifest.js +2461 -0
  584. package/dist/nac3/internal_manifest.js.map +1 -0
  585. package/dist/nac3/manifest_lazy.d.ts +71 -0
  586. package/dist/nac3/manifest_lazy.d.ts.map +1 -0
  587. package/dist/nac3/manifest_lazy.js +141 -0
  588. package/dist/nac3/manifest_lazy.js.map +1 -0
  589. package/dist/nac3/verb_tier_map.d.ts +80 -0
  590. package/dist/nac3/verb_tier_map.d.ts.map +1 -0
  591. package/dist/nac3/verb_tier_map.js +159 -0
  592. package/dist/nac3/verb_tier_map.js.map +1 -0
  593. package/dist/office/excel.d.ts +132 -0
  594. package/dist/office/excel.d.ts.map +1 -0
  595. package/dist/office/excel.js +358 -0
  596. package/dist/office/excel.js.map +1 -0
  597. package/dist/office/pdf.d.ts +35 -0
  598. package/dist/office/pdf.d.ts.map +1 -0
  599. package/dist/office/pdf.js +70 -0
  600. package/dist/office/pdf.js.map +1 -0
  601. package/dist/office/word.d.ts +64 -0
  602. package/dist/office/word.d.ts.map +1 -0
  603. package/dist/office/word.js +243 -0
  604. package/dist/office/word.js.map +1 -0
  605. package/dist/pending/store.d.ts +72 -0
  606. package/dist/pending/store.d.ts.map +1 -0
  607. package/dist/pending/store.js +274 -0
  608. package/dist/pending/store.js.map +1 -0
  609. package/dist/pending/types.d.ts +111 -0
  610. package/dist/pending/types.d.ts.map +1 -0
  611. package/dist/pending/types.js +60 -0
  612. package/dist/pending/types.js.map +1 -0
  613. package/dist/qa/brain_matrix/ab_runner.d.ts +44 -0
  614. package/dist/qa/brain_matrix/ab_runner.d.ts.map +1 -0
  615. package/dist/qa/brain_matrix/ab_runner.js +144 -0
  616. package/dist/qa/brain_matrix/ab_runner.js.map +1 -0
  617. package/dist/qa/brain_matrix/brains.json +80 -0
  618. package/dist/qa/brain_matrix/compare.d.ts +27 -0
  619. package/dist/qa/brain_matrix/compare.d.ts.map +1 -0
  620. package/dist/qa/brain_matrix/compare.js +122 -0
  621. package/dist/qa/brain_matrix/compare.js.map +1 -0
  622. package/dist/qa/brain_matrix/fake_brain.d.ts +36 -0
  623. package/dist/qa/brain_matrix/fake_brain.d.ts.map +1 -0
  624. package/dist/qa/brain_matrix/fake_brain.js +27 -0
  625. package/dist/qa/brain_matrix/fake_brain.js.map +1 -0
  626. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_intent.json +22 -0
  627. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_no_speak_default.json +23 -0
  628. package/dist/qa/brain_matrix/fixtures/scenario_a11y_consecutive_announces.json +37 -0
  629. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_action.json +22 -0
  630. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_open.json +22 -0
  631. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_unlabeled_button.json +26 -0
  632. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_with_shortcut.json +22 -0
  633. package/dist/qa/brain_matrix/fixtures/scenario_agent_director_consults_workflow_before_dispatch.json +42 -0
  634. package/dist/qa/brain_matrix/fixtures/scenario_analyst_extracts_then_returns.json +28 -0
  635. package/dist/qa/brain_matrix/fixtures/scenario_announce_min_tool_calls.json +23 -0
  636. package/dist/qa/brain_matrix/fixtures/scenario_app_invoke_happy_path.json +65 -0
  637. package/dist/qa/brain_matrix/fixtures/scenario_app_no_invent_without_backend.json +18 -0
  638. package/dist/qa/brain_matrix/fixtures/scenario_app_schema_fail_recover.json +48 -0
  639. package/dist/qa/brain_matrix/fixtures/scenario_approval_modal_no_redundancy.json +21 -0
  640. package/dist/qa/brain_matrix/fixtures/scenario_args_redacted_in_audit.json +17 -0
  641. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent.json +19 -0
  642. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent_en.json +19 -0
  643. package/dist/qa/brain_matrix/fixtures/scenario_audit_log_on_destructive.json +18 -0
  644. package/dist/qa/brain_matrix/fixtures/scenario_brain_explains_after_invoke.json +28 -0
  645. package/dist/qa/brain_matrix/fixtures/scenario_byok_on_managed_brain_overflow.json +28 -0
  646. package/dist/qa/brain_matrix/fixtures/scenario_byok_required_policy.json +35 -0
  647. package/dist/qa/brain_matrix/fixtures/scenario_coder_consults_nac_spec_before_writing.json +28 -0
  648. package/dist/qa/brain_matrix/fixtures/scenario_concise_no_loop.json +23 -0
  649. package/dist/qa/brain_matrix/fixtures/scenario_consult_nac_spec_intent.json +19 -0
  650. package/dist/qa/brain_matrix/fixtures/scenario_contradiction_rfp_cost.json +38 -0
  651. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_attachment_frontier.json +24 -0
  652. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_escalation_explicit.json +23 -0
  653. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_idle_reset.json +24 -0
  654. package/dist/qa/brain_matrix/fixtures/scenario_csv_via_excel_read.json +22 -0
  655. package/dist/qa/brain_matrix/fixtures/scenario_default_design_system_override_shadcn.json +45 -0
  656. package/dist/qa/brain_matrix/fixtures/scenario_default_design_system_use_card_template.json +44 -0
  657. package/dist/qa/brain_matrix/fixtures/scenario_destructive_no_text_confirm.json +20 -0
  658. package/dist/qa/brain_matrix/fixtures/scenario_diff_explains_changes.json +32 -0
  659. package/dist/qa/brain_matrix/fixtures/scenario_director_delegates_to_analyst.json +26 -0
  660. package/dist/qa/brain_matrix/fixtures/scenario_director_no_self_delegation.json +20 -0
  661. package/dist/qa/brain_matrix/fixtures/scenario_director_terminal_done_marker.json +19 -0
  662. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_after_unknown_intent.json +17 -0
  663. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_a11y.json +24 -0
  664. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_agent_orchestrator.json +24 -0
  665. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_byok_vs_managed.json +24 -0
  666. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_cost_router.json +24 -0
  667. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_default_design_system.json +50 -0
  668. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_g_doc.json +24 -0
  669. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_gates.json +23 -0
  670. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_intent_en.json +19 -0
  671. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_language_sovereignty.json +53 -0
  672. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_lessons_workflow.json +24 -0
  673. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_mcp_lifecycle.json +24 -0
  674. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_nac3_attrs.json +24 -0
  675. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_office.json +24 -0
  676. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_pizarron.json +23 -0
  677. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_r8_modal.json +23 -0
  678. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_testing_policy.json +55 -0
  679. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow.json +23 -0
  680. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow_phases.json +24 -0
  681. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_yf_commands.json +24 -0
  682. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_explain_results.json +22 -0
  683. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_safety_refusals.json +22 -0
  684. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_verb_composition.json +22 -0
  685. package/dist/qa/brain_matrix/fixtures/scenario_eco_defers_complex.json +17 -0
  686. package/dist/qa/brain_matrix/fixtures/scenario_eco_short_query.json +27 -0
  687. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent.json +20 -0
  688. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent_en.json +20 -0
  689. package/dist/qa/brain_matrix/fixtures/scenario_env_no_secret_leak.json +21 -0
  690. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression.json +35 -0
  691. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression_en.json +21 -0
  692. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_handles_csv_refusal.json +28 -0
  693. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent.json +20 -0
  694. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent_en.json +20 -0
  695. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_then_list.json +34 -0
  696. package/dist/qa/brain_matrix/fixtures/scenario_excel_list_sheets_first.json +22 -0
  697. package/dist/qa/brain_matrix/fixtures/scenario_excel_sheet_named.json +23 -0
  698. package/dist/qa/brain_matrix/fixtures/scenario_explain_voice_yes.json +22 -0
  699. package/dist/qa/brain_matrix/fixtures/scenario_explains_forge_error.json +39 -0
  700. package/dist/qa/brain_matrix/fixtures/scenario_focus_after_modal_open.json +29 -0
  701. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent.json +21 -0
  702. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent_en.json +20 -0
  703. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_with_glob.json +22 -0
  704. package/dist/qa/brain_matrix/fixtures/scenario_fs_mkdir_intent.json +20 -0
  705. package/dist/qa/brain_matrix/fixtures/scenario_fs_move_intent.json +20 -0
  706. package/dist/qa/brain_matrix/fixtures/scenario_fs_read_handles_missing.json +28 -0
  707. package/dist/qa/brain_matrix/fixtures/scenario_fs_stat_before_read.json +22 -0
  708. package/dist/qa/brain_matrix/fixtures/scenario_generated_app_nac3_default.json +24 -0
  709. package/dist/qa/brain_matrix/fixtures/scenario_git_branch_list_intent.json +20 -0
  710. package/dist/qa/brain_matrix/fixtures/scenario_git_diff_intent.json +20 -0
  711. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent.json +20 -0
  712. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent_en.json +20 -0
  713. package/dist/qa/brain_matrix/fixtures/scenario_git_pull_intent.json +19 -0
  714. package/dist/qa/brain_matrix/fixtures/scenario_git_push_intent.json +20 -0
  715. package/dist/qa/brain_matrix/fixtures/scenario_git_show_metadata_only.json +22 -0
  716. package/dist/qa/brain_matrix/fixtures/scenario_git_status_branch_combo.json +44 -0
  717. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent.json +20 -0
  718. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent_en.json +20 -0
  719. package/dist/qa/brain_matrix/fixtures/scenario_github_clone_repo_intent.json +20 -0
  720. package/dist/qa/brain_matrix/fixtures/scenario_github_create_repo_intent.json +20 -0
  721. package/dist/qa/brain_matrix/fixtures/scenario_id_format_in_reply.json +27 -0
  722. package/dist/qa/brain_matrix/fixtures/scenario_iterations_idempotent_adenda.json +27 -0
  723. package/dist/qa/brain_matrix/fixtures/scenario_iterations_query_history.json +29 -0
  724. package/dist/qa/brain_matrix/fixtures/scenario_iterations_tracker_acknowledge.json +28 -0
  725. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_handles_malformed.json +34 -0
  726. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent.json +30 -0
  727. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent_en.json +30 -0
  728. package/dist/qa/brain_matrix/fixtures/scenario_json_query_extract.json +23 -0
  729. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent.json +20 -0
  730. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent_en.json +20 -0
  731. package/dist/qa/brain_matrix/fixtures/scenario_keys_set_intent.json +20 -0
  732. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent.json +20 -0
  733. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent_en.json +20 -0
  734. package/dist/qa/brain_matrix/fixtures/scenario_language_sovereignty_not_conducive_spa_python.json +61 -0
  735. package/dist/qa/brain_matrix/fixtures/scenario_language_sovereignty_user_picks_python.json +48 -0
  736. package/dist/qa/brain_matrix/fixtures/scenario_lazy_complex_verb.json +27 -0
  737. package/dist/qa/brain_matrix/fixtures/scenario_lazy_doctrine_only_when_needed.json +17 -0
  738. package/dist/qa/brain_matrix/fixtures/scenario_lazy_simple_verb.json +21 -0
  739. package/dist/qa/brain_matrix/fixtures/scenario_lesson_recall_overrides.json +22 -0
  740. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_restart_app_intent.json +19 -0
  741. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent.json +19 -0
  742. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent_en.json +19 -0
  743. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent.json +20 -0
  744. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent_en.json +20 -0
  745. package/dist/qa/brain_matrix/fixtures/scenario_long_doctrine_no_truncate.json +23 -0
  746. package/dist/qa/brain_matrix/fixtures/scenario_manifest_read_intent.json +19 -0
  747. package/dist/qa/brain_matrix/fixtures/scenario_manual_open_intent.json +19 -0
  748. package/dist/qa/brain_matrix/fixtures/scenario_mcp_bridge_unreachable_graceful.json +39 -0
  749. package/dist/qa/brain_matrix/fixtures/scenario_mcp_disabled_bridge_no_verbs.json +18 -0
  750. package/dist/qa/brain_matrix/fixtures/scenario_mcp_discover_tools_intent.json +19 -0
  751. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invariant_1_no_verbs.json +19 -0
  752. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_destructive_pauses_for_r8.json +42 -0
  753. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_happy_path_writes_pizarron.json +76 -0
  754. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_network_timeout_graceful.json +41 -0
  755. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_two_hop.json +68 -0
  756. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_with_auth_loaded.json +76 -0
  757. package/dist/qa/brain_matrix/fixtures/scenario_mcp_revoked_token_graceful.json +33 -0
  758. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_intent.json +21 -0
  759. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_no_token_arg.json +27 -0
  760. package/dist/qa/brain_matrix/fixtures/scenario_mcp_show_tools_before_invoke.json +44 -0
  761. package/dist/qa/brain_matrix/fixtures/scenario_mcp_toggle_intent.json +20 -0
  762. package/dist/qa/brain_matrix/fixtures/scenario_multi_turn_clarify_then_act.json +24 -0
  763. package/dist/qa/brain_matrix/fixtures/scenario_nac3_attrs_doctrine.json +53 -0
  764. package/dist/qa/brain_matrix/fixtures/scenario_nac3_discover_schemas_intent.json +19 -0
  765. package/dist/qa/brain_matrix/fixtures/scenario_nac3_required_attr_missing.json +19 -0
  766. package/dist/qa/brain_matrix/fixtures/scenario_no_bare_ok_after_destructive.json +27 -0
  767. package/dist/qa/brain_matrix/fixtures/scenario_no_global_learnings_no_recall.json +20 -0
  768. package/dist/qa/brain_matrix/fixtures/scenario_no_hardcoded_color_use_token.json +47 -0
  769. package/dist/qa/brain_matrix/fixtures/scenario_no_id_leak_in_reply.json +24 -0
  770. package/dist/qa/brain_matrix/fixtures/scenario_no_invent_verb.json +18 -0
  771. package/dist/qa/brain_matrix/fixtures/scenario_no_loop_after_repeated_fail.json +42 -0
  772. package/dist/qa/brain_matrix/fixtures/scenario_no_password_echo.json +28 -0
  773. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_all_current.json +28 -0
  774. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent.json +20 -0
  775. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent_en.json +20 -0
  776. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_then_explain.json +35 -0
  777. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_read_intent.json +24 -0
  778. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_update_cell_picks_right_verb.json +26 -0
  779. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_write_required_args.json +23 -0
  780. package/dist/qa/brain_matrix/fixtures/scenario_office_overwrite_explicit.json +23 -0
  781. package/dist/qa/brain_matrix/fixtures/scenario_office_word_write_intent.json +27 -0
  782. package/dist/qa/brain_matrix/fixtures/scenario_panel_open_settings_intent.json +19 -0
  783. package/dist/qa/brain_matrix/fixtures/scenario_panel_send_message_intent.json +19 -0
  784. package/dist/qa/brain_matrix/fixtures/scenario_pdf_read_intent.json +22 -0
  785. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_clear_tab_explicit_close.json +17 -0
  786. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_chart.json +30 -0
  787. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_long_table.json +28 -0
  788. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_read_tab_intent.json +20 -0
  789. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_render_not_inline.json +20 -0
  790. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_read_file.json +28 -0
  791. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_verb_over_shell.json +22 -0
  792. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_workflow_state.json +28 -0
  793. package/dist/qa/brain_matrix/fixtures/scenario_project_init_intent.json +20 -0
  794. package/dist/qa/brain_matrix/fixtures/scenario_project_set_root_intent.json +20 -0
  795. package/dist/qa/brain_matrix/fixtures/scenario_promote_lesson_after_correction.json +17 -0
  796. package/dist/qa/brain_matrix/fixtures/scenario_r8_destructive_shell_exec.json +21 -0
  797. package/dist/qa/brain_matrix/fixtures/scenario_read_then_parse_order.json +36 -0
  798. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_jump_intent.json +19 -0
  799. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_set_intent.json +19 -0
  800. package/dist/qa/brain_matrix/fixtures/scenario_reader_for_long_doc.json +21 -0
  801. package/dist/qa/brain_matrix/fixtures/scenario_reader_list_docs_intent.json +19 -0
  802. package/dist/qa/brain_matrix/fixtures/scenario_reader_next_block_intent.json +19 -0
  803. package/dist/qa/brain_matrix/fixtures/scenario_reader_read_section_intent.json +19 -0
  804. package/dist/qa/brain_matrix/fixtures/scenario_reader_recap_intent.json +19 -0
  805. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent.json +20 -0
  806. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent_en.json +20 -0
  807. package/dist/qa/brain_matrix/fixtures/scenario_refuses_blanket_chmod_777.json +17 -0
  808. package/dist/qa/brain_matrix/fixtures/scenario_refuses_bypass_approval_modal.json +18 -0
  809. package/dist/qa/brain_matrix/fixtures/scenario_refuses_delete_critical_en.json +18 -0
  810. package/dist/qa/brain_matrix/fixtures/scenario_refuses_disable_vault_encryption.json +18 -0
  811. package/dist/qa/brain_matrix/fixtures/scenario_refuses_drop_database.json +17 -0
  812. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main.json +17 -0
  813. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main_en.json +17 -0
  814. package/dist/qa/brain_matrix/fixtures/scenario_refuses_leak_vault_en.json +18 -0
  815. package/dist/qa/brain_matrix/fixtures/scenario_refuses_modify_node_modules.json +17 -0
  816. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks.json +17 -0
  817. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks_en.json +17 -0
  818. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_delete_critical.json +18 -0
  819. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_leak_vault.json +18 -0
  820. package/dist/qa/brain_matrix/fixtures/scenario_respects_global_learnings.json +28 -0
  821. package/dist/qa/brain_matrix/fixtures/scenario_respects_workflow_gate_g2.json +39 -0
  822. package/dist/qa/brain_matrix/fixtures/scenario_revoke_lesson_request.json +21 -0
  823. package/dist/qa/brain_matrix/fixtures/scenario_scaffolder_destructive_pauses_for_approval.json +23 -0
  824. package/dist/qa/brain_matrix/fixtures/scenario_sq9b_deploy_checks_git_status.json +25 -0
  825. package/dist/qa/brain_matrix/fixtures/scenario_sq9b_install_checks_node_version.json +25 -0
  826. package/dist/qa/brain_matrix/fixtures/scenario_sq9b_publish_checks_gh_cli.json +25 -0
  827. package/dist/qa/brain_matrix/fixtures/scenario_sq_rules_active.json +30 -0
  828. package/dist/qa/brain_matrix/fixtures/scenario_sumie_icon_pick_from_catalog.json +56 -0
  829. package/dist/qa/brain_matrix/fixtures/scenario_tester_uses_shell_exec_only.json +27 -0
  830. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent.json +20 -0
  831. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent_en.json +20 -0
  832. package/dist/qa/brain_matrix/fixtures/scenario_truncated_response_retry.json +22 -0
  833. package/dist/qa/brain_matrix/fixtures/scenario_unknown_command_clarify.json +23 -0
  834. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_compose.json +23 -0
  835. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_handles_invalid.json +27 -0
  836. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent.json +20 -0
  837. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent_en.json +20 -0
  838. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_then_inspect_query.json +28 -0
  839. package/dist/qa/brain_matrix/fixtures/scenario_url_then_stringify_order.json +34 -0
  840. package/dist/qa/brain_matrix/fixtures/scenario_user_just_greets.json +17 -0
  841. package/dist/qa/brain_matrix/fixtures/scenario_user_overrides_proceeds.json +24 -0
  842. package/dist/qa/brain_matrix/fixtures/scenario_user_revokes_in_middle.json +22 -0
  843. package/dist/qa/brain_matrix/fixtures/scenario_voice_open_pizarron.json +21 -0
  844. package/dist/qa/brain_matrix/fixtures/scenario_word_outline_extraction.json +22 -0
  845. package/dist/qa/brain_matrix/fixtures/scenario_word_overwrite_explicit.json +20 -0
  846. package/dist/qa/brain_matrix/fixtures/scenario_word_section_count.json +28 -0
  847. package/dist/qa/brain_matrix/fixtures/scenario_workflow_doctrine.json +53 -0
  848. package/dist/qa/brain_matrix/fixtures/scenario_workflow_done_specs.json +32 -0
  849. package/dist/qa/brain_matrix/fixtures/scenario_workflow_intent_capture.json +22 -0
  850. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_jump_block.json +26 -0
  851. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_v_step_15.json +41 -0
  852. package/dist/qa/brain_matrix/fixtures/scenario_workflow_run_step_intent.json +19 -0
  853. package/dist/qa/brain_matrix/fixtures/scenario_workflow_set_intent.json +20 -0
  854. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_injection.json +32 -0
  855. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_recovers_after_clarify.json +25 -0
  856. package/dist/qa/brain_matrix/fixtures/scenario_workflow_step_1_intake.json +24 -0
  857. package/dist/qa/brain_matrix/fixtures/scenario_yf_command_doctrine.json +56 -0
  858. package/dist/qa/brain_matrix/fixtures/scenario_yf_doctrine_list_intent.json +19 -0
  859. package/dist/qa/brain_matrix/fixtures/scenario_yf_qa_compare_intent.json +17 -0
  860. package/dist/qa/brain_matrix/invariants.d.ts +18 -0
  861. package/dist/qa/brain_matrix/invariants.d.ts.map +1 -0
  862. package/dist/qa/brain_matrix/invariants.js +333 -0
  863. package/dist/qa/brain_matrix/invariants.js.map +1 -0
  864. package/dist/qa/brain_matrix/report.d.ts +12 -0
  865. package/dist/qa/brain_matrix/report.d.ts.map +1 -0
  866. package/dist/qa/brain_matrix/report.js +131 -0
  867. package/dist/qa/brain_matrix/report.js.map +1 -0
  868. package/dist/qa/brain_matrix/runner.d.ts +31 -0
  869. package/dist/qa/brain_matrix/runner.d.ts.map +1 -0
  870. package/dist/qa/brain_matrix/runner.js +561 -0
  871. package/dist/qa/brain_matrix/runner.js.map +1 -0
  872. package/dist/qa/brain_matrix/types.d.ts +180 -0
  873. package/dist/qa/brain_matrix/types.d.ts.map +1 -0
  874. package/dist/qa/brain_matrix/types.js +2 -0
  875. package/dist/qa/brain_matrix/types.js.map +1 -0
  876. package/dist/qa/brain_matrix/validate_scenario.d.ts +23 -0
  877. package/dist/qa/brain_matrix/validate_scenario.d.ts.map +1 -0
  878. package/dist/qa/brain_matrix/validate_scenario.js +128 -0
  879. package/dist/qa/brain_matrix/validate_scenario.js.map +1 -0
  880. package/dist/semantic_graph/ast_extract.d.ts +15 -0
  881. package/dist/semantic_graph/ast_extract.d.ts.map +1 -0
  882. package/dist/semantic_graph/ast_extract.js +162 -0
  883. package/dist/semantic_graph/ast_extract.js.map +1 -0
  884. package/dist/semantic_graph/derive.d.ts +36 -0
  885. package/dist/semantic_graph/derive.d.ts.map +1 -0
  886. package/dist/semantic_graph/derive.js +285 -0
  887. package/dist/semantic_graph/derive.js.map +1 -0
  888. package/dist/semantic_graph/llm_claim.d.ts +21 -0
  889. package/dist/semantic_graph/llm_claim.d.ts.map +1 -0
  890. package/dist/semantic_graph/llm_claim.js +164 -0
  891. package/dist/semantic_graph/llm_claim.js.map +1 -0
  892. package/dist/semantic_graph/npm_enrich.d.ts +49 -0
  893. package/dist/semantic_graph/npm_enrich.d.ts.map +1 -0
  894. package/dist/semantic_graph/npm_enrich.js +173 -0
  895. package/dist/semantic_graph/npm_enrich.js.map +1 -0
  896. package/dist/semantic_graph/render.d.ts +28 -0
  897. package/dist/semantic_graph/render.d.ts.map +1 -0
  898. package/dist/semantic_graph/render.js +70 -0
  899. package/dist/semantic_graph/render.js.map +1 -0
  900. package/dist/semantic_graph/store.d.ts +44 -0
  901. package/dist/semantic_graph/store.d.ts.map +1 -0
  902. package/dist/semantic_graph/store.js +360 -0
  903. package/dist/semantic_graph/store.js.map +1 -0
  904. package/dist/semantic_graph/types.d.ts +59 -0
  905. package/dist/semantic_graph/types.d.ts.map +1 -0
  906. package/dist/semantic_graph/types.js +17 -0
  907. package/dist/semantic_graph/types.js.map +1 -0
  908. package/dist/support/github_dispatcher.d.ts +36 -0
  909. package/dist/support/github_dispatcher.d.ts.map +1 -0
  910. package/dist/support/github_dispatcher.js +292 -0
  911. package/dist/support/github_dispatcher.js.map +1 -0
  912. package/dist/support/reports.d.ts +31 -0
  913. package/dist/support/reports.d.ts.map +1 -0
  914. package/dist/support/reports.js +162 -0
  915. package/dist/support/reports.js.map +1 -0
  916. package/dist/telemetry/usage.d.ts +67 -0
  917. package/dist/telemetry/usage.d.ts.map +1 -0
  918. package/dist/telemetry/usage.js +208 -0
  919. package/dist/telemetry/usage.js.map +1 -0
  920. package/dist/test_agent/gemini_user.d.ts +9 -0
  921. package/dist/test_agent/gemini_user.d.ts.map +1 -0
  922. package/dist/test_agent/gemini_user.js +58 -0
  923. package/dist/test_agent/gemini_user.js.map +1 -0
  924. package/dist/test_agent/profiles.d.ts +23 -0
  925. package/dist/test_agent/profiles.d.ts.map +1 -0
  926. package/dist/test_agent/profiles.js +117 -0
  927. package/dist/test_agent/profiles.js.map +1 -0
  928. package/dist/test_agent/runner.d.ts +56 -0
  929. package/dist/test_agent/runner.d.ts.map +1 -0
  930. package/dist/test_agent/runner.js +134 -0
  931. package/dist/test_agent/runner.js.map +1 -0
  932. package/dist/test_agent/target_http.d.ts +22 -0
  933. package/dist/test_agent/target_http.d.ts.map +1 -0
  934. package/dist/test_agent/target_http.js +51 -0
  935. package/dist/test_agent/target_http.js.map +1 -0
  936. package/dist/test_agent/types.d.ts +117 -0
  937. package/dist/test_agent/types.d.ts.map +1 -0
  938. package/dist/test_agent/types.js +22 -0
  939. package/dist/test_agent/types.js.map +1 -0
  940. package/dist/vault/store.d.ts.map +1 -1
  941. package/dist/vault/store.js +14 -1
  942. package/dist/vault/store.js.map +1 -1
  943. package/dist/version.d.ts +1 -1
  944. package/dist/version.d.ts.map +1 -1
  945. package/dist/version.js +1 -1
  946. package/dist/version.js.map +1 -1
  947. package/dist/voice/config.d.ts +12 -0
  948. package/dist/voice/config.d.ts.map +1 -1
  949. package/dist/voice/config.js +25 -2
  950. package/dist/voice/config.js.map +1 -1
  951. package/dist/voice/providers/google.d.ts +9 -0
  952. package/dist/voice/providers/google.d.ts.map +1 -1
  953. package/dist/voice/providers/google.js +152 -26
  954. package/dist/voice/providers/google.js.map +1 -1
  955. package/dist/voice/router.d.ts +10 -0
  956. package/dist/voice/router.d.ts.map +1 -1
  957. package/dist/voice/router.js +39 -20
  958. package/dist/voice/router.js.map +1 -1
  959. package/dist/voice/types.d.ts +5 -2
  960. package/dist/voice/types.d.ts.map +1 -1
  961. package/dist/voice/types.js.map +1 -1
  962. package/dist/wiring/discover.d.ts +14 -0
  963. package/dist/wiring/discover.d.ts.map +1 -0
  964. package/dist/wiring/discover.js +383 -0
  965. package/dist/wiring/discover.js.map +1 -0
  966. package/dist/wiring/store.d.ts +19 -0
  967. package/dist/wiring/store.d.ts.map +1 -0
  968. package/dist/wiring/store.js +182 -0
  969. package/dist/wiring/store.js.map +1 -0
  970. package/dist/wiring/types.d.ts +61 -0
  971. package/dist/wiring/types.d.ts.map +1 -0
  972. package/dist/wiring/types.js +36 -0
  973. package/dist/wiring/types.js.map +1 -0
  974. package/dist/workflow/definitions.d.ts +60 -0
  975. package/dist/workflow/definitions.d.ts.map +1 -0
  976. package/dist/workflow/definitions.js +178 -0
  977. package/dist/workflow/definitions.js.map +1 -0
  978. package/dist/workflow/definitions_client.d.ts +12 -0
  979. package/dist/workflow/definitions_client.d.ts.map +1 -0
  980. package/dist/workflow/definitions_client.js +81 -0
  981. package/dist/workflow/definitions_client.js.map +1 -0
  982. package/dist/workflow/evolution.d.ts +10 -0
  983. package/dist/workflow/evolution.d.ts.map +1 -0
  984. package/dist/workflow/evolution.js +62 -0
  985. package/dist/workflow/evolution.js.map +1 -0
  986. package/dist/workflow/graph.d.ts +59 -0
  987. package/dist/workflow/graph.d.ts.map +1 -0
  988. package/dist/workflow/graph.js +137 -0
  989. package/dist/workflow/graph.js.map +1 -0
  990. package/dist/workflow/phase_inference.d.ts +56 -0
  991. package/dist/workflow/phase_inference.d.ts.map +1 -0
  992. package/dist/workflow/phase_inference.js +107 -0
  993. package/dist/workflow/phase_inference.js.map +1 -0
  994. package/dist/workflow/select.d.ts +28 -0
  995. package/dist/workflow/select.d.ts.map +1 -0
  996. package/dist/workflow/select.js +38 -0
  997. package/dist/workflow/select.js.map +1 -0
  998. package/dist/workflow/state.d.ts +290 -0
  999. package/dist/workflow/state.d.ts.map +1 -0
  1000. package/dist/workflow/state.js +213 -0
  1001. package/dist/workflow/state.js.map +1 -0
  1002. package/dist/workflow/view.d.ts +47 -0
  1003. package/dist/workflow/view.d.ts.map +1 -0
  1004. package/dist/workflow/view.js +103 -0
  1005. package/dist/workflow/view.js.map +1 -0
  1006. package/docs/SQ.md +1397 -0
  1007. package/docs/SQ_BY_STEP.yaml +147 -0
  1008. package/docs/doctrine/accessibility.md +78 -0
  1009. package/docs/doctrine/agent-orchestrator.md +76 -0
  1010. package/docs/doctrine/byok-vs-managed.md +81 -0
  1011. package/docs/doctrine/cost-router-escalation.md +103 -0
  1012. package/docs/doctrine/default-design-system.md +120 -0
  1013. package/docs/doctrine/explain-results.md +90 -0
  1014. package/docs/doctrine/expo-eas-builds.md +177 -0
  1015. package/docs/doctrine/g-doc.md +46 -0
  1016. package/docs/doctrine/gates.md +21 -0
  1017. package/docs/doctrine/language-sovereignty.md +143 -0
  1018. package/docs/doctrine/lessons-workflow.md +68 -0
  1019. package/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  1020. package/docs/doctrine/nac3-attrs.md +23 -0
  1021. package/docs/doctrine/office-tools.md +102 -0
  1022. package/docs/doctrine/pizarron.md +52 -0
  1023. package/docs/doctrine/r8-modal.md +60 -0
  1024. package/docs/doctrine/safety-refusals.md +73 -0
  1025. package/docs/doctrine/testing-policy.md +211 -0
  1026. package/docs/doctrine/verb-composition.md +68 -0
  1027. package/docs/doctrine/verification-honesty.md +95 -0
  1028. package/docs/doctrine/workflow-kinds.md +52 -0
  1029. package/docs/doctrine/workflow-phases.md +108 -0
  1030. package/docs/doctrine/workflow.md +58 -0
  1031. package/docs/doctrine/yf-commands.md +49 -0
  1032. package/package.json +19 -3
  1033. package/src/i18n/catalogs/ar.json +134 -10
  1034. package/src/i18n/catalogs/de.json +134 -10
  1035. package/src/i18n/catalogs/en.json +134 -10
  1036. package/src/i18n/catalogs/es.json +134 -10
  1037. package/src/i18n/catalogs/fr.json +134 -10
  1038. package/src/i18n/catalogs/hi.json +134 -10
  1039. package/src/i18n/catalogs/it.json +134 -10
  1040. package/src/i18n/catalogs/ja.json +134 -10
  1041. package/src/i18n/catalogs/pt.json +134 -10
  1042. package/src/i18n/catalogs/zh.json +134 -10
  1043. package/templates/nextjs-app/README.md +48 -0
  1044. package/templates/nextjs-app/next.config.js +8 -0
  1045. package/templates/nextjs-app/package.json +33 -0
  1046. package/templates/nextjs-app/src/app/globals.css +43 -0
  1047. package/templates/nextjs-app/src/app/layout.tsx +29 -0
  1048. package/templates/nextjs-app/src/app/page.tsx +63 -0
  1049. package/templates/nextjs-app/src/nac/manifest.ts +36 -0
  1050. package/templates/nextjs-app/tsconfig.json +21 -0
  1051. package/templates/nextjs-app/yujin.forge.json +11 -0
  1052. package/templates/sumi-context.template.md +57 -0
package/dist/migrate/ai-decorator.js CHANGED
@@ -20,157 +20,69 @@
20
20
  */
21
21
  import { promises as fs } from 'node:fs';
22
22
  import path from 'node:path';
23
- import Anthropic from '@anthropic-ai/sdk';
24
- const DEFAULT_MODEL = 'claude-sonnet-4-6';
25
- /* Pricing per million tokens, mirrored from the benchmark pricing.ts. */
26
- const PRICING = {
27
- 'claude-sonnet-4-6': { in: 3.00, out: 15.00 },
28
- 'claude-haiku-4-5': { in: 0.80, out: 4.00 },
29
- 'claude-opus-4-7': { in: 15.00, out: 75.00 },
30
- 'claude-haiku-4-5-20251001': { in: 0.80, out: 4.00 },
31
- };
32
- function resolveAnthropicModelId(id) {
33
- if (id === 'claude-haiku-4-5')
34
- return 'claude-haiku-4-5-20251001';
35
- return id;
36
- }
37
- function computeCost(model, usage) {
38
- const p = PRICING[model] || PRICING['claude-sonnet-4-6'];
39
- return (usage.input * p.in + usage.output * p.out) / 1_000_000;
40
- }
41
- const SYSTEM_PROMPT_SILENT = `You are a NAC-3 (Native Agent Contract) decorator. Given an HTML page and an optional companion JS source, you produce a fully NAC-3-decorated version of the page plus a manifest JSON.
42
-
43
- NAC-3 attributes to add to interactive elements:
44
- - data-nac-id: a stable dotted identifier, e.g. "calc.action.digit_7" or "calc.action.equals".
45
- - data-nac-role: one of: action, field, option, tab, navigation, region.
46
- - data-nac-action: the verb name when role=action, e.g. "digit_7", "add", "subtract", "clear", "equals".
47
-
48
- ROOT PLUGIN ANCHOR (mandatory): the top-level container (preferably <body>) MUST receive data-nac-plugin="<plugin_slug>". This is what NAC.click_by_verb's DOM fallback uses to scope the search. Without it the runtime cannot resolve verbs.
49
-
50
- ROLE TAXONOMY (critical -- get this right):
51
- - action: anything the user CLICKS to make something happen (buttons, links that do something).
52
- - field: an element that HOLDS a VALUE the user can read or write. Examples: a calculator display, an output area, an input. NEVER classify a value-holding element as region.
53
- - region: a CONTAINER that groups other elements. A region holds children; it does not hold a value.
54
- - option: a single choice inside a select / radio group.
55
- - tab: a tab-bar entry.
56
- - navigation: nav link.
57
-
58
- VERB NAMING: prefer short imperative verbs (add, subtract, multiply, divide, clear, submit, save). Avoid redundant prefixes like "set_op_" when "add" already communicates intent.
59
-
60
- Plugin slug: choose a short snake_case identifier for the page (e.g. "calc", "invoice_app").
61
-
62
- Manifest JSON shape:
63
- {
64
- "plugin_slug": "<slug>",
65
- "version": "1.0.0",
66
- "nac_version": "1.0",
67
- "label_i18n": { "es": "<label>", "en": "<label>" },
68
- "elements": [
69
- { "id": "<dotted id>", "role": "action|field|option|tab|region", "actions": [{ "verb": "<verb>", "label_i18n": { "es":"...", "en":"..." } }] }
70
- ]
71
- }
72
-
73
- OUTPUT FORMAT -- you reply with a single JSON object, no prose, no Markdown fences:
74
- {
75
- "decorated_html": "<full decorated HTML source as a single string>",
76
- "plugin_slug": "<slug>",
77
- "manifest_json": "<the manifest object stringified>",
78
- "ambiguities": []
79
- }
80
-
81
- Rules:
82
- 1. Decorate ALL interactive elements (buttons, inputs, selects, links that do something, tabs). Skip pure layout.
83
- 2. Use semantic verbs from the JS (onclick handlers reveal intent). For "onclick=clearAll()" use verb "clear". For "onclick=digit('7')" use verb "digit_7" and id "<slug>.action.digit_7".
84
- 3. Keep IDs stable, dotted, lowercase, snake_case. Pattern: "<slug>.<role>.<thing>".
85
- 4. The manifest_json field is the JSON manifest as a STRING (escape inner quotes).
86
- 5. In SILENT mode, do not ask questions. Make your best guess. ambiguities = [].
87
- 6. Preserve all existing HTML attributes; only ADD nac-3 attributes.
88
- 7. Do not change the visible text or layout. Only decoration.
89
- 8. The <body> tag MUST have data-nac-plugin="<plugin_slug>" exactly.`;
90
- const SYSTEM_PROMPT_ASSISTED = SYSTEM_PROMPT_SILENT + `
91
-
92
- ASSISTED MODE OVERRIDE: if more than one verb / role / id is plausible, populate the "ambiguities" array with concrete questions. Each ambiguity has:
93
- {
94
- "id": "<stable handle>",
95
- "kind": "role|verb|plugin_slug|nac_id",
96
- "element_excerpt": "<the offending HTML tag, single line, max 120 chars>",
97
- "question": "<one-sentence question for the user>",
98
- "options": ["option_a", "option_b", "option_c"]
99
- }
100
- Still produce decorated_html with your best guess; the caller will re-issue if the user picks something different.`;
101
- const _client = {};
102
- function client() {
103
- if (!_client.c)
104
- _client.c = new Anthropic();
105
- return _client.c;
106
- }
107
- function extractJsonObject(text) {
108
- /* Models sometimes wrap output in markdown despite instructions.
109
- Be liberal in what we accept. */
110
- const fenced = text.match(/```(?:json)?\s*([\s\S]*?)\s*```/);
111
- if (fenced && fenced[1])
112
- return fenced[1].trim();
113
- const trimmed = text.trim();
114
- if (trimmed.startsWith('{') && trimmed.endsWith('}'))
115
- return trimmed;
116
- /* Find first '{' and last '}'. */
117
- const i = trimmed.indexOf('{');
118
- const j = trimmed.lastIndexOf('}');
119
- if (i >= 0 && j > i)
120
- return trimmed.slice(i, j + 1);
121
- return trimmed;
122
- }
23
+ /* HITO 4 -- alpha.59z.112.
24
+ *
25
+ * The bundled SYSTEM_PROMPT_SILENT/ASSISTED prompts + the direct
26
+ * Anthropic SDK code path were removed in alpha.59z.112. The
27
+ * hito4 worker is now the ONLY path. Users no longer need
28
+ * ANTHROPIC_API_KEY in their env -- the worker uses their BYOK
29
+ * brain key forwarded via HMAC headers (see callFlow). */
123
30
  export async function aiDecorate(opts) {
124
- if (!process.env.ANTHROPIC_API_KEY) {
125
- throw new Error('ANTHROPIC_API_KEY env variable missing -- set it before running --ai-silent or --ai-assisted.');
126
- }
127
- const model = opts.model || DEFAULT_MODEL;
128
- const sys = opts.mode === 'assisted' ? SYSTEM_PROMPT_ASSISTED : SYSTEM_PROMPT_SILENT;
129
- let userPrompt = '<HTML>\n' + opts.htmlSource + '\n</HTML>';
130
- if (opts.jsSource) {
131
- userPrompt += '\n\n<JS companion>\n' + opts.jsSource + '\n</JS companion>';
132
- }
133
- if (opts.pluginHint) {
134
- userPrompt += '\n\nPage hint: ' + opts.pluginHint;
135
- }
136
- userPrompt += '\n\nDecorate this page per the rules above. Output a single JSON object only.';
137
31
  const t0 = Date.now();
138
- const skipTemp = /^claude-opus-4-7/.test(model);
139
- const payload = {
140
- model: resolveAnthropicModelId(model),
141
- max_tokens: 8192,
142
- system: sys,
143
- messages: [{ role: 'user', content: userPrompt }],
144
- };
145
- if (!skipTemp)
146
- payload.temperature = 0;
147
- const resp = await client().messages.create(payload);
148
- const latency_ms = Date.now() - t0;
149
- const block = resp.content.find((b) => b.type === 'text');
150
- const raw = block?.text || '';
151
- const jsonText = extractJsonObject(raw);
152
- let parsed;
153
- try {
154
- parsed = JSON.parse(jsonText);
32
+ const { callFlow } = await import('../license/hito4_client.js');
33
+ const r = await callFlow('ai-decorate', {
34
+ html_source: opts.htmlSource,
35
+ js_source: opts.jsSource,
36
+ plugin_hint: opts.pluginHint,
37
+ mode: opts.mode,
38
+ });
39
+ if (!r.ok) {
40
+ throw new Error('ai-decorate via hito4 worker failed: HTTP ' + r.status
41
+ + ' -- ' + (typeof r.body?.error === 'string' ? r.body.error : 'no error message'));
42
+ }
43
+ /* alpha.59z.121 -- worker currently returns body.output as
44
+ * raw LLM text. Parse to object first. */
45
+ const rawOut = r.body.output ?? r.body;
46
+ let out;
47
+ if (rawOut && typeof rawOut === 'object') {
48
+ out = rawOut;
155
49
  }
156
- catch (e) {
157
- throw new Error('Claude returned non-parseable JSON. First 400 chars: ' + (jsonText || '').slice(0, 400));
50
+ else if (typeof rawOut === 'string') {
51
+ let text = rawOut.trim();
52
+ const fs = text.match(/^```(?:json)?\s*\n/i);
53
+ if (fs)
54
+ text = text.slice(fs[0].length);
55
+ const fe = text.match(/\n```\s*$/);
56
+ if (fe)
57
+ text = text.slice(0, -fe[0].length);
58
+ try {
59
+ out = JSON.parse(text);
60
+ }
61
+ catch {
62
+ throw new Error('ai-decorate: worker returned non-JSON string. First 300: ' + text.slice(0, 300));
63
+ }
158
64
  }
159
- if (!parsed || typeof parsed !== 'object') {
160
- throw new Error('Claude response did not parse to an object.');
65
+ else {
66
+ out = {};
161
67
  }
162
- const ambiguities = Array.isArray(parsed.ambiguities) ? parsed.ambiguities : [];
68
+ const decorated_html = typeof out.decorated_html === 'string' ? out.decorated_html : opts.htmlSource;
69
+ const plugin_slug = typeof out.plugin_slug === 'string' ? out.plugin_slug : 'unknown';
70
+ const manifest_json = typeof out.manifest_json === 'string'
71
+ ? out.manifest_json
72
+ : JSON.stringify({ plugin_slug, version: '1.0.0', nac_version: '1.0', elements: [] });
73
+ const ambiguities = Array.isArray(out.ambiguities) ? out.ambiguities : [];
74
+ const usage = (out.usage ?? r.body.usage);
163
75
  return {
164
- decorated_html: parsed.decorated_html || opts.htmlSource,
165
- plugin_slug: parsed.plugin_slug || 'unknown',
166
- manifest_json: parsed.manifest_json || JSON.stringify({ plugin_slug: parsed.plugin_slug || 'unknown', version: '1.0.0', nac_version: '1.0', elements: [] }),
76
+ decorated_html,
77
+ plugin_slug,
78
+ manifest_json,
167
79
  ambiguities,
168
80
  meta: {
169
- model,
170
- input_tokens: resp.usage.input_tokens || 0,
171
- output_tokens: resp.usage.output_tokens || 0,
172
- cost_usd: computeCost(model, { input: resp.usage.input_tokens || 0, output: resp.usage.output_tokens || 0 }),
173
- latency_ms,
81
+ model: typeof out.model === 'string' ? out.model : 'worker-managed',
82
+ input_tokens: typeof usage?.input_tokens === 'number' ? usage.input_tokens : 0,
83
+ output_tokens: typeof usage?.output_tokens === 'number' ? usage.output_tokens : 0,
84
+ cost_usd: typeof out.cost_usd === 'number' ? out.cost_usd : 0,
85
+ latency_ms: Date.now() - t0,
174
86
  },
175
87
  };
176
88
  }
package/dist/migrate/ai-decorator.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"ai-decorator.js","sourceRoot":"","sources":["../../src/migrate/ai-decorator.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ai-decorator.js","sourceRoot":"","sources":["../../src/migrate/ai-decorator.ts"],"names":[],"mappings":"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"}
package/dist/nac3/approval_queue.d.ts ADDED
@@ -0,0 +1,44 @@
1
+ import type { ToolContext, ToolResult } from '../chat/tools.js';
2
+ import type { Nac3Verb } from './internal_manifest.js';
3
+ export interface PendingApproval {
4
+ trace_id: string;
5
+ verb: Nac3Verb;
6
+ args: Record<string, unknown>;
7
+ ctx: ToolContext;
8
+ /** Bound at enqueue time -- captures which legacy alias to
9
+ * invoke on approve. Decoupled so the runner does not need
10
+ * the dispatcher again. */
11
+ legacy_alias: string | null;
12
+ /** Reused dispatcher reference so the executor on approve can
13
+ * re-enter runNac3Invoke / runForgeTool from the endpoint. */
14
+ legacy_run: (n: string, a: Record<string, unknown>, c: ToolContext) => Promise<ToolResult>;
15
+ created_at: number;
16
+ /** Director sprint -- when the approval was emitted by an agent
17
+ * via the nac3_invoke path inside an iterative step, the bridge
18
+ * carries the agent slug here so the eventual approve/reject
19
+ * endpoint can fire a `agent_run_paused_resolved` SSE event +
20
+ * the panel SVG can clear the amber dashed marker. Optional
21
+ * because chat-side approvals (sidebar voice / human dispatch
22
+ * directo) do NOT carry an agent slug. */
23
+ agent_slug?: string;
24
+ }
25
+ /** Push a pending approval and return the trace_id. */
26
+ export declare function enqueueApproval(p: PendingApproval): void;
27
+ /** Pop a pending row. Returns null when missing or expired. */
28
+ export declare function popPending(trace_id: string): PendingApproval | null;
29
+ /** Read without removing -- used by tests / debug. */
30
+ export declare function peekPending(trace_id: string): PendingApproval | null;
31
+ /** Force-clear (tests). */
32
+ export declare function clearAllPending(): void;
33
+ export interface ApprovalLogEntry {
34
+ ts: string;
35
+ trace_id: string;
36
+ verb_id: string;
37
+ decision: 'approve' | 'reject' | 'expired';
38
+ args_sample: Record<string, unknown>;
39
+ policy: string;
40
+ reason?: string;
41
+ }
42
+ /** Append-only audit row. Never throws. */
43
+ export declare function logApproval(entry: ApprovalLogEntry): Promise<void>;
44
+ //# sourceMappingURL=approval_queue.d.ts.map
package/dist/nac3/approval_queue.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval_queue.d.ts","sourceRoot":"","sources":["../../src/nac3/approval_queue.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,WAAW,CAAC;IACjB;;gCAE4B;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;mEAC+D;IAC/D,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;+CAM2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAGxD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASnE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQpE;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AA0BD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE"}
package/dist/nac3/approval_queue.js ADDED
@@ -0,0 +1,105 @@
1
+ /**
2
+ * In-memory approval queue for NAC3 destructive / approval-required
3
+ * verbs.
4
+ *
5
+ * The dispatcher (`runNac3Invoke`) intercepts a destructive or
6
+ * approval-required verb BEFORE executing it. The intercept:
7
+ *
8
+ * 1. Pushes a `PendingApproval` row keyed by trace_id.
9
+ * 2. Returns an envelope `{nac3_panel_approval_required: true,
10
+ * trace_id, verb, args}` so the LLM does NOT consider the
11
+ * action done. The panel intercepts the same envelope and
12
+ * opens a modal.
13
+ * 3. The user clicks Approve / Reject in the modal. The panel
14
+ * POSTs to /api/forge/nac3-approve or /nac3-reject with the
15
+ * trace_id.
16
+ * 4. The endpoint resolves the pending row. On approve, the
17
+ * action runs; on reject, it logs and stays unexecuted.
18
+ *
19
+ * Queue lifetime:
20
+ * - Pendings older than the TTL (default 5 min) are GC'd. They
21
+ * stay in the audit log but cannot be approved any more.
22
+ * - The dispatcher does not block waiting for approval -- it
23
+ * returns immediately with the envelope. Approval comes in a
24
+ * SEPARATE HTTP request from the panel.
25
+ *
26
+ * Concurrency model:
27
+ * - Local single-process. Forge chat is a 127.0.0.1 server with
28
+ * one listening tab. No race with siblings.
29
+ *
30
+ * ASCII-only.
31
+ */
32
+ import { promises as fs } from 'node:fs';
33
+ import path from 'node:path';
34
+ import os from 'node:os';
35
+ const TTL_MS = 5 * 60 * 1000;
36
+ const PENDING = new Map();
37
+ /** Push a pending approval and return the trace_id. */
38
+ export function enqueueApproval(p) {
39
+ PENDING.set(p.trace_id, p);
40
+ scheduleGc();
41
+ }
42
+ /** Pop a pending row. Returns null when missing or expired. */
43
+ export function popPending(trace_id) {
44
+ const row = PENDING.get(trace_id);
45
+ if (!row)
46
+ return null;
47
+ if (Date.now() - row.created_at > TTL_MS) {
48
+ PENDING.delete(trace_id);
49
+ return null;
50
+ }
51
+ PENDING.delete(trace_id);
52
+ return row;
53
+ }
54
+ /** Read without removing -- used by tests / debug. */
55
+ export function peekPending(trace_id) {
56
+ const row = PENDING.get(trace_id);
57
+ if (!row)
58
+ return null;
59
+ if (Date.now() - row.created_at > TTL_MS) {
60
+ PENDING.delete(trace_id);
61
+ return null;
62
+ }
63
+ return row;
64
+ }
65
+ /** Force-clear (tests). */
66
+ export function clearAllPending() {
67
+ PENDING.clear();
68
+ }
69
+ /** Periodic GC for expired entries. */
70
+ let gcTimer = null;
71
+ function scheduleGc() {
72
+ if (gcTimer)
73
+ return;
74
+ gcTimer = setTimeout(() => {
75
+ gcTimer = null;
76
+ const now = Date.now();
77
+ for (const [k, v] of PENDING.entries()) {
78
+ if (now - v.created_at > TTL_MS)
79
+ PENDING.delete(k);
80
+ }
81
+ if (PENDING.size > 0)
82
+ scheduleGc();
83
+ }, 60_000);
84
+ /* Allow the process to exit even with the GC timer pending. */
85
+ if (typeof gcTimer.unref === 'function') {
86
+ gcTimer.unref();
87
+ }
88
+ }
89
+ /** Audit log path for approval decisions. Same dir as nac3_log. */
90
+ function approvalLogPath() {
91
+ const dir = process.env.YF_CONFIG_DIR || path.join(os.homedir(), '.yujin-forge');
92
+ return path.join(dir, 'nac3_approvals.jsonl');
93
+ }
94
+ /** Append-only audit row. Never throws. */
95
+ export async function logApproval(entry) {
96
+ try {
97
+ const dir = path.dirname(approvalLogPath());
98
+ await fs.mkdir(dir, { recursive: true });
99
+ await fs.appendFile(approvalLogPath(), JSON.stringify(entry) + '\n', 'utf-8');
100
+ }
101
+ catch {
102
+ /* swallow */
103
+ }
104
+ }
105
+ //# sourceMappingURL=approval_queue.js.map
package/dist/nac3/approval_queue.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval_queue.js","sourceRoot":"","sources":["../../src/nac3/approval_queue.ts"],"names":[],"mappings":"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"}
package/dist/nac3/backend_tools.d.ts ADDED
@@ -0,0 +1,89 @@
1
+ /**
2
+ * NAC-3 v3.x backend tools (task #23 -- design in
3
+ * docs/NAC3_SPEC_V3_BACKEND_TOOLS.md).
4
+ *
5
+ * Slice 1: parse the `nac3_backend.tools[]` section from
6
+ * yujin.forge.json + expose the parsed catalogue. Dispatcher
7
+ * routing + auth header + audit log ship in slice 2.
8
+ *
9
+ * Surface principle: like the F101 MCP bridge invariants, the
10
+ * backend-tool verbs only appear in the LLM-visible stub when
11
+ * the adopter app declares them. No declaration -> identical
12
+ * prompt to v3.0.
13
+ *
14
+ * ASCII-only.
15
+ */
16
+ export type BackendAuthKind = 'none' | 'bearer' | 'header_key' | 'basic' | 'oauth2_token';
17
+ export interface BackendAuth {
18
+ kind: BackendAuthKind;
19
+ /** Vault slot holding the token (for bearer / header_key / oauth2_token). */
20
+ vault_slot?: string;
21
+ /** Vault slot for the username portion of basic auth. */
22
+ vault_slot_user?: string;
23
+ /** Vault slot for the password portion of basic auth. */
24
+ vault_slot_pass?: string;
25
+ /** Header name when kind === 'header_key'. e.g. "X-API-Key". */
26
+ header_name?: string;
27
+ }
28
+ export type BackendPolicy = 'unrestricted' | 'confirm' | 'approval-required' | 'destructive';
29
+ export type BackendSideEffect = 'none' | 'external-api' | 'filesystem' | 'network';
30
+ export interface BackendEndpoint {
31
+ method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
32
+ path: string;
33
+ }
34
+ export interface BackendToolSchema {
35
+ type: 'object';
36
+ properties: Record<string, {
37
+ type: 'string' | 'number' | 'boolean' | 'object' | 'array';
38
+ description?: string;
39
+ enum?: readonly string[];
40
+ minLength?: number;
41
+ maxLength?: number;
42
+ pattern?: string;
43
+ }>;
44
+ required: readonly string[];
45
+ }
46
+ export interface BackendTool {
47
+ /** Tool id (kebab-case or snake_case). Becomes `app.<id>` in the
48
+ * synthetic NAC-3 verb namespace. */
49
+ id: string;
50
+ /** Short user-facing label for stub + audit log. */
51
+ label: string;
52
+ /** Free-text description. */
53
+ description?: string;
54
+ /** HTTP method + path appended to base_url. */
55
+ endpoint: BackendEndpoint;
56
+ /** Policy controls R8 modal behaviour. */
57
+ policy: BackendPolicy;
58
+ /** Declared side effects (for audit + policy reasoning). */
59
+ side_effects: readonly BackendSideEffect[];
60
+ /** Args schema (validated like native nac3 verbs). */
61
+ params_schema: BackendToolSchema;
62
+ /** Optional response shape declaration -- informational only in slice 1. */
63
+ result_shape?: Record<string, unknown>;
64
+ }
65
+ export interface BackendCatalogue {
66
+ base_url: string;
67
+ auth: BackendAuth;
68
+ tools: BackendTool[];
69
+ }
70
+ export interface ParseResult {
71
+ /** When the manifest has no nac3_backend, returns null. When it
72
+ * has malformed shape, returns the parsed-best-effort + error
73
+ * diagnostics. When it parses clean, returns the catalogue. */
74
+ catalogue: BackendCatalogue | null;
75
+ errors: string[];
76
+ warnings: string[];
77
+ }
78
+ /** Parse a yujin.forge.json content + extract the nac3_backend
79
+ * catalogue. Returns null when the manifest does not declare the
80
+ * section (the v3.0 default; no behaviour change). Returns a
81
+ * catalogue + errors[] when the section is malformed. */
82
+ export declare function parseBackendCatalogue(manifest: unknown): ParseResult;
83
+ /** Read yujin.forge.json from the project root and parse its
84
+ * nac3_backend section. Returns null catalogue when the file is
85
+ * missing OR no nac3_backend declared OR malformed. */
86
+ export declare function loadBackendCatalogue(projectRoot: string): Promise<ParseResult>;
87
+ export declare function buildBackendToolStub(tool: BackendTool): string;
88
+ export declare function buildBackendToolsSection(catalogue: BackendCatalogue): string;
89
+ //# sourceMappingURL=backend_tools.d.ts.map
package/dist/nac3/backend_tools.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backend_tools.d.ts","sourceRoot":"","sources":["../../src/nac3/backend_tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,SAAS,GACT,mBAAmB,GACnB,aAAa,CAAC;AAElB,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,cAAc,GACd,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B;0CACsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,EAAE,eAAe,CAAC;IAC1B,0CAA0C;IAC1C,MAAM,EAAE,aAAa,CAAC;IACtB,4DAA4D;IAC5D,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC3C,sDAAsD;IACtD,aAAa,EAAE,iBAAiB,CAAC;IACjC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAMD,MAAM,WAAW,WAAW;IAC1B;;oEAEgE;IAChE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoHD;;;0DAG0D;AAC1D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CA+CpE;AAED;;wDAEwD;AACxD,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmBpF;AA2CD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAM9D;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAU5E"}