@nac3/forge-cli 0.2.0-alpha.4 → 0.2.0-alpha.59z.118

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 (773) 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/config_resolver.d.ts +16 -0
  7. package/dist/agents/config_resolver.d.ts.map +1 -0
  8. package/dist/agents/config_resolver.js +133 -0
  9. package/dist/agents/config_resolver.js.map +1 -0
  10. package/dist/agents/config_schema.d.ts +42 -0
  11. package/dist/agents/config_schema.d.ts.map +1 -0
  12. package/dist/agents/config_schema.js +204 -0
  13. package/dist/agents/config_schema.js.map +1 -0
  14. package/dist/agents/defaults.d.ts +21 -0
  15. package/dist/agents/defaults.d.ts.map +1 -0
  16. package/dist/agents/defaults.js +56 -0
  17. package/dist/agents/defaults.js.map +1 -0
  18. package/dist/agents/runner.d.ts +94 -0
  19. package/dist/agents/runner.d.ts.map +1 -0
  20. package/dist/agents/runner.js +165 -0
  21. package/dist/agents/runner.js.map +1 -0
  22. package/dist/agents/store.d.ts +33 -0
  23. package/dist/agents/store.d.ts.map +1 -0
  24. package/dist/agents/store.js +210 -0
  25. package/dist/agents/store.js.map +1 -0
  26. package/dist/agents/types.d.ts +112 -0
  27. package/dist/agents/types.d.ts.map +1 -0
  28. package/dist/agents/types.js +39 -0
  29. package/dist/agents/types.js.map +1 -0
  30. package/dist/bin/yf.d.ts.map +1 -1
  31. package/dist/bin/yf.js +86 -2
  32. package/dist/bin/yf.js.map +1 -1
  33. package/dist/chat/claude.d.ts +53 -15
  34. package/dist/chat/claude.d.ts.map +1 -1
  35. package/dist/chat/claude.js +152 -27
  36. package/dist/chat/claude.js.map +1 -1
  37. package/dist/chat/graph_auto_ingest.d.ts +46 -0
  38. package/dist/chat/graph_auto_ingest.d.ts.map +1 -0
  39. package/dist/chat/graph_auto_ingest.js +162 -0
  40. package/dist/chat/graph_auto_ingest.js.map +1 -0
  41. package/dist/chat/graph_component_watcher.d.ts +30 -0
  42. package/dist/chat/graph_component_watcher.d.ts.map +1 -0
  43. package/dist/chat/graph_component_watcher.js +220 -0
  44. package/dist/chat/graph_component_watcher.js.map +1 -0
  45. package/dist/chat/panel.d.ts.map +1 -1
  46. package/dist/chat/panel.js +5815 -1455
  47. package/dist/chat/panel.js.map +1 -1
  48. package/dist/chat/project_slug.d.ts +6 -0
  49. package/dist/chat/project_slug.d.ts.map +1 -0
  50. package/dist/chat/project_slug.js +78 -0
  51. package/dist/chat/project_slug.js.map +1 -0
  52. package/dist/chat/semantic_graph_ingest.d.ts +31 -0
  53. package/dist/chat/semantic_graph_ingest.d.ts.map +1 -0
  54. package/dist/chat/semantic_graph_ingest.js +84 -0
  55. package/dist/chat/semantic_graph_ingest.js.map +1 -0
  56. package/dist/chat/semantic_graph_inject.d.ts +25 -0
  57. package/dist/chat/semantic_graph_inject.d.ts.map +1 -0
  58. package/dist/chat/semantic_graph_inject.js +64 -0
  59. package/dist/chat/semantic_graph_inject.js.map +1 -0
  60. package/dist/chat/server.d.ts +50 -0
  61. package/dist/chat/server.d.ts.map +1 -1
  62. package/dist/chat/server.js +1914 -63
  63. package/dist/chat/server.js.map +1 -1
  64. package/dist/chat/spec_extract.d.ts +1 -2
  65. package/dist/chat/spec_extract.d.ts.map +1 -1
  66. package/dist/chat/spec_extract.js +18 -59
  67. package/dist/chat/spec_extract.js.map +1 -1
  68. package/dist/chat/spec_plan.d.ts +1 -2
  69. package/dist/chat/spec_plan.d.ts.map +1 -1
  70. package/dist/chat/spec_plan.js +15 -60
  71. package/dist/chat/spec_plan.js.map +1 -1
  72. package/dist/chat/tools/app_backend_dispatch.d.ts +39 -0
  73. package/dist/chat/tools/app_backend_dispatch.d.ts.map +1 -0
  74. package/dist/chat/tools/app_backend_dispatch.js +239 -0
  75. package/dist/chat/tools/app_backend_dispatch.js.map +1 -0
  76. package/dist/chat/tools/audit_consumers.d.ts +66 -0
  77. package/dist/chat/tools/audit_consumers.d.ts.map +1 -0
  78. package/dist/chat/tools/audit_consumers.js +231 -0
  79. package/dist/chat/tools/audit_consumers.js.map +1 -0
  80. package/dist/chat/tools/fs_editor.d.ts +11 -0
  81. package/dist/chat/tools/fs_editor.d.ts.map +1 -0
  82. package/dist/chat/tools/fs_editor.js +162 -0
  83. package/dist/chat/tools/fs_editor.js.map +1 -0
  84. package/dist/chat/tools/git.d.ts +24 -0
  85. package/dist/chat/tools/git.d.ts.map +1 -1
  86. package/dist/chat/tools/git.js +82 -4
  87. package/dist/chat/tools/git.js.map +1 -1
  88. package/dist/chat/tools/github.js +3 -3
  89. package/dist/chat/tools/keys.d.ts +9 -0
  90. package/dist/chat/tools/keys.d.ts.map +1 -0
  91. package/dist/chat/tools/keys.js +152 -0
  92. package/dist/chat/tools/keys.js.map +1 -0
  93. package/dist/chat/tools/lifecycle.js +3 -3
  94. package/dist/chat/tools/manual.js +1 -1
  95. package/dist/chat/tools/misc_verbs.d.ts +36 -0
  96. package/dist/chat/tools/misc_verbs.d.ts.map +1 -0
  97. package/dist/chat/tools/misc_verbs.js +405 -0
  98. package/dist/chat/tools/misc_verbs.js.map +1 -0
  99. package/dist/chat/tools/nac3_invoke.d.ts +53 -0
  100. package/dist/chat/tools/nac3_invoke.d.ts.map +1 -0
  101. package/dist/chat/tools/nac3_invoke.js +886 -0
  102. package/dist/chat/tools/nac3_invoke.js.map +1 -0
  103. package/dist/chat/tools/pizarron.d.ts +40 -0
  104. package/dist/chat/tools/pizarron.d.ts.map +1 -0
  105. package/dist/chat/tools/pizarron.js +123 -0
  106. package/dist/chat/tools/pizarron.js.map +1 -0
  107. package/dist/chat/tools/project_lifecycle.d.ts +24 -0
  108. package/dist/chat/tools/project_lifecycle.d.ts.map +1 -0
  109. package/dist/chat/tools/project_lifecycle.js +184 -0
  110. package/dist/chat/tools/project_lifecycle.js.map +1 -0
  111. package/dist/chat/tools/reader.d.ts.map +1 -1
  112. package/dist/chat/tools/reader.js +152 -9
  113. package/dist/chat/tools/reader.js.map +1 -1
  114. package/dist/chat/tools/shell.d.ts +58 -0
  115. package/dist/chat/tools/shell.d.ts.map +1 -0
  116. package/dist/chat/tools/shell.js +253 -0
  117. package/dist/chat/tools/shell.js.map +1 -0
  118. package/dist/chat/tools/workflow.d.ts +45 -0
  119. package/dist/chat/tools/workflow.d.ts.map +1 -0
  120. package/dist/chat/tools/workflow.js +404 -0
  121. package/dist/chat/tools/workflow.js.map +1 -0
  122. package/dist/chat/tools.d.ts +27 -0
  123. package/dist/chat/tools.d.ts.map +1 -1
  124. package/dist/chat/tools.js +366 -17
  125. package/dist/chat/tools.js.map +1 -1
  126. package/dist/chat/workflow_inject.d.ts +52 -0
  127. package/dist/chat/workflow_inject.d.ts.map +1 -0
  128. package/dist/chat/workflow_inject.js +346 -0
  129. package/dist/chat/workflow_inject.js.map +1 -0
  130. package/dist/commands/agent.d.ts +22 -0
  131. package/dist/commands/agent.d.ts.map +1 -0
  132. package/dist/commands/agent.js +190 -0
  133. package/dist/commands/agent.js.map +1 -0
  134. package/dist/commands/approve.d.ts +32 -0
  135. package/dist/commands/approve.d.ts.map +1 -0
  136. package/dist/commands/approve.js +198 -0
  137. package/dist/commands/approve.js.map +1 -0
  138. package/dist/commands/block.d.ts +28 -0
  139. package/dist/commands/block.d.ts.map +1 -0
  140. package/dist/commands/block.js +189 -0
  141. package/dist/commands/block.js.map +1 -0
  142. package/dist/commands/bootstrap.d.ts +35 -0
  143. package/dist/commands/bootstrap.d.ts.map +1 -0
  144. package/dist/commands/bootstrap.js +205 -0
  145. package/dist/commands/bootstrap.js.map +1 -0
  146. package/dist/commands/brain.d.ts +17 -0
  147. package/dist/commands/brain.d.ts.map +1 -0
  148. package/dist/commands/brain.js +129 -0
  149. package/dist/commands/brain.js.map +1 -0
  150. package/dist/commands/chat.d.ts +3 -0
  151. package/dist/commands/chat.d.ts.map +1 -1
  152. package/dist/commands/chat.js +112 -1
  153. package/dist/commands/chat.js.map +1 -1
  154. package/dist/commands/clarify.d.ts +30 -0
  155. package/dist/commands/clarify.d.ts.map +1 -0
  156. package/dist/commands/clarify.js +671 -0
  157. package/dist/commands/clarify.js.map +1 -0
  158. package/dist/commands/discover.d.ts +30 -0
  159. package/dist/commands/discover.d.ts.map +1 -0
  160. package/dist/commands/discover.js +178 -0
  161. package/dist/commands/discover.js.map +1 -0
  162. package/dist/commands/doctor.js +26 -4
  163. package/dist/commands/doctor.js.map +1 -1
  164. package/dist/commands/doctrine.d.ts +24 -0
  165. package/dist/commands/doctrine.d.ts.map +1 -0
  166. package/dist/commands/doctrine.js +106 -0
  167. package/dist/commands/doctrine.js.map +1 -0
  168. package/dist/commands/doctrines.d.ts +21 -0
  169. package/dist/commands/doctrines.d.ts.map +1 -0
  170. package/dist/commands/doctrines.js +158 -0
  171. package/dist/commands/doctrines.js.map +1 -0
  172. package/dist/commands/graph.d.ts +21 -0
  173. package/dist/commands/graph.d.ts.map +1 -0
  174. package/dist/commands/graph.js +363 -0
  175. package/dist/commands/graph.js.map +1 -0
  176. package/dist/commands/keys_setup.d.ts.map +1 -1
  177. package/dist/commands/keys_setup.js +80 -0
  178. package/dist/commands/keys_setup.js.map +1 -1
  179. package/dist/commands/legacy-audit.d.ts +34 -0
  180. package/dist/commands/legacy-audit.d.ts.map +1 -0
  181. package/dist/commands/legacy-audit.js +270 -0
  182. package/dist/commands/legacy-audit.js.map +1 -0
  183. package/dist/commands/lessons.d.ts +28 -0
  184. package/dist/commands/lessons.d.ts.map +1 -0
  185. package/dist/commands/lessons.js +309 -0
  186. package/dist/commands/lessons.js.map +1 -0
  187. package/dist/commands/license.d.ts.map +1 -1
  188. package/dist/commands/license.js +56 -1
  189. package/dist/commands/license.js.map +1 -1
  190. package/dist/commands/limits.d.ts +15 -0
  191. package/dist/commands/limits.d.ts.map +1 -0
  192. package/dist/commands/limits.js +51 -0
  193. package/dist/commands/limits.js.map +1 -0
  194. package/dist/commands/manifest-cli.d.ts +12 -0
  195. package/dist/commands/manifest-cli.d.ts.map +1 -0
  196. package/dist/commands/manifest-cli.js +42 -0
  197. package/dist/commands/manifest-cli.js.map +1 -0
  198. package/dist/commands/mcp.d.ts +24 -0
  199. package/dist/commands/mcp.d.ts.map +1 -0
  200. package/dist/commands/mcp.js +163 -0
  201. package/dist/commands/mcp.js.map +1 -0
  202. package/dist/commands/nac3.d.ts +22 -0
  203. package/dist/commands/nac3.d.ts.map +1 -0
  204. package/dist/commands/nac3.js +125 -0
  205. package/dist/commands/nac3.js.map +1 -0
  206. package/dist/commands/operate.d.ts +22 -0
  207. package/dist/commands/operate.d.ts.map +1 -0
  208. package/dist/commands/operate.js +523 -0
  209. package/dist/commands/operate.js.map +1 -0
  210. package/dist/commands/qa.d.ts +24 -0
  211. package/dist/commands/qa.d.ts.map +1 -0
  212. package/dist/commands/qa.js +349 -0
  213. package/dist/commands/qa.js.map +1 -0
  214. package/dist/commands/spec.d.ts +38 -0
  215. package/dist/commands/spec.d.ts.map +1 -0
  216. package/dist/commands/spec.js +256 -0
  217. package/dist/commands/spec.js.map +1 -0
  218. package/dist/commands/support.d.ts +22 -0
  219. package/dist/commands/support.d.ts.map +1 -0
  220. package/dist/commands/support.js +165 -0
  221. package/dist/commands/support.js.map +1 -0
  222. package/dist/commands/triage.d.ts +34 -0
  223. package/dist/commands/triage.d.ts.map +1 -0
  224. package/dist/commands/triage.js +228 -0
  225. package/dist/commands/triage.js.map +1 -0
  226. package/dist/commands/vault-inventory.d.ts +30 -0
  227. package/dist/commands/vault-inventory.d.ts.map +1 -0
  228. package/dist/commands/vault-inventory.js +222 -0
  229. package/dist/commands/vault-inventory.js.map +1 -0
  230. package/dist/commands/vault.d.ts.map +1 -1
  231. package/dist/commands/vault.js +5 -0
  232. package/dist/commands/vault.js.map +1 -1
  233. package/dist/commands/voice.d.ts.map +1 -1
  234. package/dist/commands/voice.js +47 -4
  235. package/dist/commands/voice.js.map +1 -1
  236. package/dist/commands/workflow-coverage.d.ts +30 -0
  237. package/dist/commands/workflow-coverage.d.ts.map +1 -0
  238. package/dist/commands/workflow-coverage.js +138 -0
  239. package/dist/commands/workflow-coverage.js.map +1 -0
  240. package/dist/core/ansi_strip.d.ts +39 -0
  241. package/dist/core/ansi_strip.d.ts.map +1 -0
  242. package/dist/core/ansi_strip.js +71 -0
  243. package/dist/core/ansi_strip.js.map +1 -0
  244. package/dist/core/audit_log.d.ts +43 -0
  245. package/dist/core/audit_log.d.ts.map +1 -0
  246. package/dist/core/audit_log.js +80 -0
  247. package/dist/core/audit_log.js.map +1 -0
  248. package/dist/core/brain_config.d.ts +33 -0
  249. package/dist/core/brain_config.d.ts.map +1 -0
  250. package/dist/core/brain_config.js +132 -0
  251. package/dist/core/brain_config.js.map +1 -0
  252. package/dist/core/budget.d.ts +96 -0
  253. package/dist/core/budget.d.ts.map +1 -0
  254. package/dist/core/budget.js +300 -0
  255. package/dist/core/budget.js.map +1 -0
  256. package/dist/core/cost_meter.d.ts +35 -0
  257. package/dist/core/cost_meter.d.ts.map +1 -0
  258. package/dist/core/cost_meter.js +111 -0
  259. package/dist/core/cost_meter.js.map +1 -0
  260. package/dist/core/cost_router.d.ts +106 -0
  261. package/dist/core/cost_router.d.ts.map +1 -0
  262. package/dist/core/cost_router.js +465 -0
  263. package/dist/core/cost_router.js.map +1 -0
  264. package/dist/core/doctrine_resolver.d.ts +23 -0
  265. package/dist/core/doctrine_resolver.d.ts.map +1 -0
  266. package/dist/core/doctrine_resolver.js +108 -0
  267. package/dist/core/doctrine_resolver.js.map +1 -0
  268. package/dist/core/error_catalog.d.ts +80 -0
  269. package/dist/core/error_catalog.d.ts.map +1 -0
  270. package/dist/core/error_catalog.js +168 -0
  271. package/dist/core/error_catalog.js.map +1 -0
  272. package/dist/core/error_formatter.d.ts +30 -0
  273. package/dist/core/error_formatter.d.ts.map +1 -0
  274. package/dist/core/error_formatter.js +155 -0
  275. package/dist/core/error_formatter.js.map +1 -0
  276. package/dist/core/incomplete_detector.d.ts +51 -0
  277. package/dist/core/incomplete_detector.d.ts.map +1 -0
  278. package/dist/core/incomplete_detector.js +140 -0
  279. package/dist/core/incomplete_detector.js.map +1 -0
  280. package/dist/core/learnings_client.d.ts +104 -0
  281. package/dist/core/learnings_client.d.ts.map +1 -0
  282. package/dist/core/learnings_client.js +262 -0
  283. package/dist/core/learnings_client.js.map +1 -0
  284. package/dist/core/limits_config.d.ts +76 -0
  285. package/dist/core/limits_config.d.ts.map +1 -0
  286. package/dist/core/limits_config.js +297 -0
  287. package/dist/core/limits_config.js.map +1 -0
  288. package/dist/core/provider_keys.d.ts +35 -0
  289. package/dist/core/provider_keys.d.ts.map +1 -0
  290. package/dist/core/provider_keys.js +260 -0
  291. package/dist/core/provider_keys.js.map +1 -0
  292. package/dist/core/reasoning_gate.d.ts +72 -0
  293. package/dist/core/reasoning_gate.d.ts.map +1 -0
  294. package/dist/core/reasoning_gate.js +192 -0
  295. package/dist/core/reasoning_gate.js.map +1 -0
  296. package/dist/core/shell_classifier.d.ts +49 -0
  297. package/dist/core/shell_classifier.d.ts.map +1 -0
  298. package/dist/core/shell_classifier.js +159 -0
  299. package/dist/core/shell_classifier.js.map +1 -0
  300. package/dist/core/sq_resolver.d.ts +14 -0
  301. package/dist/core/sq_resolver.d.ts.map +1 -0
  302. package/dist/core/sq_resolver.js +230 -0
  303. package/dist/core/sq_resolver.js.map +1 -0
  304. package/dist/core/truncation_detector.d.ts +68 -0
  305. package/dist/core/truncation_detector.d.ts.map +1 -0
  306. package/dist/core/truncation_detector.js +115 -0
  307. package/dist/core/truncation_detector.js.map +1 -0
  308. package/dist/core/turn_classifier.d.ts +62 -0
  309. package/dist/core/turn_classifier.d.ts.map +1 -0
  310. package/dist/core/turn_classifier.js +213 -0
  311. package/dist/core/turn_classifier.js.map +1 -0
  312. package/dist/core/whats_new.d.ts +42 -0
  313. package/dist/core/whats_new.d.ts.map +1 -0
  314. package/dist/core/whats_new.js +214 -0
  315. package/dist/core/whats_new.js.map +1 -0
  316. package/dist/deploy/adapter.d.ts +93 -0
  317. package/dist/deploy/adapter.d.ts.map +1 -0
  318. package/dist/deploy/adapter.js +42 -0
  319. package/dist/deploy/adapter.js.map +1 -0
  320. package/dist/deploy/aws_adapter.d.ts +28 -0
  321. package/dist/deploy/aws_adapter.d.ts.map +1 -0
  322. package/dist/deploy/aws_adapter.js +98 -0
  323. package/dist/deploy/aws_adapter.js.map +1 -0
  324. package/dist/deploy/cloudflare.d.ts +24 -0
  325. package/dist/deploy/cloudflare.d.ts.map +1 -0
  326. package/dist/deploy/cloudflare.js +169 -0
  327. package/dist/deploy/cloudflare.js.map +1 -0
  328. package/dist/docs/LIMITED_RESPONSIBILITY.md +216 -0
  329. package/dist/docs/PRIVACY_POLICY.md +169 -0
  330. package/dist/docs/SQ.md +1397 -0
  331. package/dist/docs/SQ_BY_STEP.yaml +147 -0
  332. package/dist/docs/doctrine/accessibility.md +78 -0
  333. package/dist/docs/doctrine/agent-orchestrator.md +76 -0
  334. package/dist/docs/doctrine/byok-vs-managed.md +81 -0
  335. package/dist/docs/doctrine/cost-router-escalation.md +73 -0
  336. package/dist/docs/doctrine/explain-results.md +90 -0
  337. package/dist/docs/doctrine/g-doc.md +46 -0
  338. package/dist/docs/doctrine/gates.md +21 -0
  339. package/dist/docs/doctrine/lessons-workflow.md +68 -0
  340. package/dist/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  341. package/dist/docs/doctrine/nac3-attrs.md +23 -0
  342. package/dist/docs/doctrine/office-tools.md +102 -0
  343. package/dist/docs/doctrine/pizarron.md +52 -0
  344. package/dist/docs/doctrine/r8-modal.md +60 -0
  345. package/dist/docs/doctrine/safety-refusals.md +73 -0
  346. package/dist/docs/doctrine/verb-composition.md +68 -0
  347. package/dist/docs/doctrine/workflow-phases.md +108 -0
  348. package/dist/docs/doctrine/workflow.md +58 -0
  349. package/dist/docs/doctrine/yf-commands.md +49 -0
  350. package/dist/json/query.d.ts +38 -0
  351. package/dist/json/query.d.ts.map +1 -0
  352. package/dist/json/query.js +177 -0
  353. package/dist/json/query.js.map +1 -0
  354. package/dist/license/hito4_client.d.ts +19 -0
  355. package/dist/license/hito4_client.d.ts.map +1 -1
  356. package/dist/license/hito4_client.js +110 -0
  357. package/dist/license/hito4_client.js.map +1 -1
  358. package/dist/license/index.d.ts.map +1 -1
  359. package/dist/license/index.js +7 -0
  360. package/dist/license/index.js.map +1 -1
  361. package/dist/license/sync.d.ts +54 -0
  362. package/dist/license/sync.d.ts.map +1 -0
  363. package/dist/license/sync.js +138 -0
  364. package/dist/license/sync.js.map +1 -0
  365. package/dist/llm/cohere_client.d.ts +81 -0
  366. package/dist/llm/cohere_client.d.ts.map +1 -0
  367. package/dist/llm/cohere_client.js +195 -0
  368. package/dist/llm/cohere_client.js.map +1 -0
  369. package/dist/llm/deepseek_client.d.ts +63 -0
  370. package/dist/llm/deepseek_client.d.ts.map +1 -0
  371. package/dist/llm/deepseek_client.js +188 -0
  372. package/dist/llm/deepseek_client.js.map +1 -0
  373. package/dist/llm/gemini_client.d.ts +78 -0
  374. package/dist/llm/gemini_client.d.ts.map +1 -0
  375. package/dist/llm/gemini_client.js +189 -0
  376. package/dist/llm/gemini_client.js.map +1 -0
  377. package/dist/llm/managed_client.d.ts +70 -0
  378. package/dist/llm/managed_client.d.ts.map +1 -0
  379. package/dist/llm/managed_client.js +251 -0
  380. package/dist/llm/managed_client.js.map +1 -0
  381. package/dist/llm/mistral_client.d.ts +54 -0
  382. package/dist/llm/mistral_client.d.ts.map +1 -0
  383. package/dist/llm/mistral_client.js +174 -0
  384. package/dist/llm/mistral_client.js.map +1 -0
  385. package/dist/llm/multi_provider_client.d.ts +57 -0
  386. package/dist/llm/multi_provider_client.d.ts.map +1 -0
  387. package/dist/llm/multi_provider_client.js +109 -0
  388. package/dist/llm/multi_provider_client.js.map +1 -0
  389. package/dist/llm/openai_client.d.ts +77 -0
  390. package/dist/llm/openai_client.d.ts.map +1 -0
  391. package/dist/llm/openai_client.js +200 -0
  392. package/dist/llm/openai_client.js.map +1 -0
  393. package/dist/llm/xai_client.d.ts +51 -0
  394. package/dist/llm/xai_client.d.ts.map +1 -0
  395. package/dist/llm/xai_client.js +174 -0
  396. package/dist/llm/xai_client.js.map +1 -0
  397. package/dist/mcp/bridge_registry.d.ts +77 -0
  398. package/dist/mcp/bridge_registry.d.ts.map +1 -0
  399. package/dist/mcp/bridge_registry.js +220 -0
  400. package/dist/mcp/bridge_registry.js.map +1 -0
  401. package/dist/mcp/config.d.ts +25 -0
  402. package/dist/mcp/config.d.ts.map +1 -0
  403. package/dist/mcp/config.js +116 -0
  404. package/dist/mcp/config.js.map +1 -0
  405. package/dist/mcp/protocol_client.d.ts +63 -0
  406. package/dist/mcp/protocol_client.d.ts.map +1 -0
  407. package/dist/mcp/protocol_client.js +340 -0
  408. package/dist/mcp/protocol_client.js.map +1 -0
  409. package/dist/mcp/state.d.ts +38 -0
  410. package/dist/mcp/state.d.ts.map +1 -0
  411. package/dist/mcp/state.js +144 -0
  412. package/dist/mcp/state.js.map +1 -0
  413. package/dist/migrate/ai-decorator.d.ts.map +1 -1
  414. package/dist/migrate/ai-decorator.js +33 -145
  415. package/dist/migrate/ai-decorator.js.map +1 -1
  416. package/dist/nac3/approval_queue.d.ts +36 -0
  417. package/dist/nac3/approval_queue.d.ts.map +1 -0
  418. package/dist/nac3/approval_queue.js +105 -0
  419. package/dist/nac3/approval_queue.js.map +1 -0
  420. package/dist/nac3/backend_tools.d.ts +89 -0
  421. package/dist/nac3/backend_tools.d.ts.map +1 -0
  422. package/dist/nac3/backend_tools.js +271 -0
  423. package/dist/nac3/backend_tools.js.map +1 -0
  424. package/dist/nac3/dispatch_log.d.ts +35 -0
  425. package/dist/nac3/dispatch_log.d.ts.map +1 -0
  426. package/dist/nac3/dispatch_log.js +126 -0
  427. package/dist/nac3/dispatch_log.js.map +1 -0
  428. package/dist/nac3/internal_manifest.d.ts +62 -0
  429. package/dist/nac3/internal_manifest.d.ts.map +1 -0
  430. package/dist/nac3/internal_manifest.js +1846 -0
  431. package/dist/nac3/internal_manifest.js.map +1 -0
  432. package/dist/nac3/manifest_lazy.d.ts +71 -0
  433. package/dist/nac3/manifest_lazy.d.ts.map +1 -0
  434. package/dist/nac3/manifest_lazy.js +141 -0
  435. package/dist/nac3/manifest_lazy.js.map +1 -0
  436. package/dist/nac3/verb_tier_map.d.ts +80 -0
  437. package/dist/nac3/verb_tier_map.d.ts.map +1 -0
  438. package/dist/nac3/verb_tier_map.js +159 -0
  439. package/dist/nac3/verb_tier_map.js.map +1 -0
  440. package/dist/office/excel.d.ts +110 -0
  441. package/dist/office/excel.d.ts.map +1 -0
  442. package/dist/office/excel.js +276 -0
  443. package/dist/office/excel.js.map +1 -0
  444. package/dist/office/pdf.d.ts +35 -0
  445. package/dist/office/pdf.d.ts.map +1 -0
  446. package/dist/office/pdf.js +70 -0
  447. package/dist/office/pdf.js.map +1 -0
  448. package/dist/office/word.d.ts +64 -0
  449. package/dist/office/word.d.ts.map +1 -0
  450. package/dist/office/word.js +243 -0
  451. package/dist/office/word.js.map +1 -0
  452. package/dist/qa/brain_matrix/ab_runner.d.ts +44 -0
  453. package/dist/qa/brain_matrix/ab_runner.d.ts.map +1 -0
  454. package/dist/qa/brain_matrix/ab_runner.js +144 -0
  455. package/dist/qa/brain_matrix/ab_runner.js.map +1 -0
  456. package/dist/qa/brain_matrix/brains.json +80 -0
  457. package/dist/qa/brain_matrix/compare.d.ts +27 -0
  458. package/dist/qa/brain_matrix/compare.d.ts.map +1 -0
  459. package/dist/qa/brain_matrix/compare.js +122 -0
  460. package/dist/qa/brain_matrix/compare.js.map +1 -0
  461. package/dist/qa/brain_matrix/fake_brain.d.ts +36 -0
  462. package/dist/qa/brain_matrix/fake_brain.d.ts.map +1 -0
  463. package/dist/qa/brain_matrix/fake_brain.js +27 -0
  464. package/dist/qa/brain_matrix/fake_brain.js.map +1 -0
  465. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_intent.json +22 -0
  466. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_no_speak_default.json +23 -0
  467. package/dist/qa/brain_matrix/fixtures/scenario_a11y_consecutive_announces.json +37 -0
  468. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_action.json +22 -0
  469. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_with_shortcut.json +22 -0
  470. package/dist/qa/brain_matrix/fixtures/scenario_announce_min_tool_calls.json +23 -0
  471. package/dist/qa/brain_matrix/fixtures/scenario_app_invoke_happy_path.json +65 -0
  472. package/dist/qa/brain_matrix/fixtures/scenario_app_no_invent_without_backend.json +18 -0
  473. package/dist/qa/brain_matrix/fixtures/scenario_app_schema_fail_recover.json +48 -0
  474. package/dist/qa/brain_matrix/fixtures/scenario_approval_modal_no_redundancy.json +21 -0
  475. package/dist/qa/brain_matrix/fixtures/scenario_args_redacted_in_audit.json +17 -0
  476. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent.json +19 -0
  477. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent_en.json +19 -0
  478. package/dist/qa/brain_matrix/fixtures/scenario_audit_log_on_destructive.json +18 -0
  479. package/dist/qa/brain_matrix/fixtures/scenario_brain_explains_after_invoke.json +28 -0
  480. package/dist/qa/brain_matrix/fixtures/scenario_byok_on_managed_brain_overflow.json +28 -0
  481. package/dist/qa/brain_matrix/fixtures/scenario_byok_required_policy.json +35 -0
  482. package/dist/qa/brain_matrix/fixtures/scenario_concise_no_loop.json +23 -0
  483. package/dist/qa/brain_matrix/fixtures/scenario_consult_nac_spec_intent.json +19 -0
  484. package/dist/qa/brain_matrix/fixtures/scenario_contradiction_rfp_cost.json +38 -0
  485. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_attachment_frontier.json +24 -0
  486. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_escalation_explicit.json +23 -0
  487. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_idle_reset.json +24 -0
  488. package/dist/qa/brain_matrix/fixtures/scenario_csv_via_excel_read.json +22 -0
  489. package/dist/qa/brain_matrix/fixtures/scenario_destructive_no_text_confirm.json +20 -0
  490. package/dist/qa/brain_matrix/fixtures/scenario_diff_explains_changes.json +32 -0
  491. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_after_unknown_intent.json +17 -0
  492. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_a11y.json +24 -0
  493. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_agent_orchestrator.json +24 -0
  494. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_byok_vs_managed.json +24 -0
  495. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_cost_router.json +24 -0
  496. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_g_doc.json +24 -0
  497. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_gates.json +23 -0
  498. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_intent_en.json +19 -0
  499. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_lessons_workflow.json +24 -0
  500. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_mcp_lifecycle.json +24 -0
  501. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_nac3_attrs.json +24 -0
  502. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_office.json +24 -0
  503. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_pizarron.json +23 -0
  504. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_r8_modal.json +23 -0
  505. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow.json +23 -0
  506. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow_phases.json +24 -0
  507. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_yf_commands.json +24 -0
  508. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_explain_results.json +22 -0
  509. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_safety_refusals.json +22 -0
  510. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_verb_composition.json +22 -0
  511. package/dist/qa/brain_matrix/fixtures/scenario_eco_defers_complex.json +17 -0
  512. package/dist/qa/brain_matrix/fixtures/scenario_eco_short_query.json +27 -0
  513. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent.json +20 -0
  514. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent_en.json +20 -0
  515. package/dist/qa/brain_matrix/fixtures/scenario_env_no_secret_leak.json +21 -0
  516. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression.json +35 -0
  517. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression_en.json +21 -0
  518. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_handles_csv_refusal.json +28 -0
  519. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent.json +20 -0
  520. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent_en.json +20 -0
  521. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_then_list.json +34 -0
  522. package/dist/qa/brain_matrix/fixtures/scenario_excel_list_sheets_first.json +22 -0
  523. package/dist/qa/brain_matrix/fixtures/scenario_excel_sheet_named.json +23 -0
  524. package/dist/qa/brain_matrix/fixtures/scenario_explain_voice_yes.json +22 -0
  525. package/dist/qa/brain_matrix/fixtures/scenario_explains_forge_error.json +39 -0
  526. package/dist/qa/brain_matrix/fixtures/scenario_focus_after_modal_open.json +29 -0
  527. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent.json +21 -0
  528. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent_en.json +20 -0
  529. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_with_glob.json +22 -0
  530. package/dist/qa/brain_matrix/fixtures/scenario_fs_mkdir_intent.json +20 -0
  531. package/dist/qa/brain_matrix/fixtures/scenario_fs_move_intent.json +20 -0
  532. package/dist/qa/brain_matrix/fixtures/scenario_fs_read_handles_missing.json +28 -0
  533. package/dist/qa/brain_matrix/fixtures/scenario_fs_stat_before_read.json +22 -0
  534. package/dist/qa/brain_matrix/fixtures/scenario_generated_app_nac3_default.json +24 -0
  535. package/dist/qa/brain_matrix/fixtures/scenario_git_branch_list_intent.json +20 -0
  536. package/dist/qa/brain_matrix/fixtures/scenario_git_diff_intent.json +20 -0
  537. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent.json +20 -0
  538. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent_en.json +20 -0
  539. package/dist/qa/brain_matrix/fixtures/scenario_git_pull_intent.json +19 -0
  540. package/dist/qa/brain_matrix/fixtures/scenario_git_push_intent.json +20 -0
  541. package/dist/qa/brain_matrix/fixtures/scenario_git_show_metadata_only.json +22 -0
  542. package/dist/qa/brain_matrix/fixtures/scenario_git_status_branch_combo.json +44 -0
  543. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent.json +20 -0
  544. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent_en.json +20 -0
  545. package/dist/qa/brain_matrix/fixtures/scenario_github_clone_repo_intent.json +20 -0
  546. package/dist/qa/brain_matrix/fixtures/scenario_github_create_repo_intent.json +20 -0
  547. package/dist/qa/brain_matrix/fixtures/scenario_id_format_in_reply.json +27 -0
  548. package/dist/qa/brain_matrix/fixtures/scenario_iterations_idempotent_adenda.json +27 -0
  549. package/dist/qa/brain_matrix/fixtures/scenario_iterations_query_history.json +29 -0
  550. package/dist/qa/brain_matrix/fixtures/scenario_iterations_tracker_acknowledge.json +28 -0
  551. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_handles_malformed.json +34 -0
  552. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent.json +30 -0
  553. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent_en.json +30 -0
  554. package/dist/qa/brain_matrix/fixtures/scenario_json_query_extract.json +23 -0
  555. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent.json +20 -0
  556. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent_en.json +20 -0
  557. package/dist/qa/brain_matrix/fixtures/scenario_keys_set_intent.json +20 -0
  558. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent.json +20 -0
  559. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent_en.json +20 -0
  560. package/dist/qa/brain_matrix/fixtures/scenario_lazy_complex_verb.json +27 -0
  561. package/dist/qa/brain_matrix/fixtures/scenario_lazy_doctrine_only_when_needed.json +17 -0
  562. package/dist/qa/brain_matrix/fixtures/scenario_lazy_simple_verb.json +21 -0
  563. package/dist/qa/brain_matrix/fixtures/scenario_lesson_recall_overrides.json +22 -0
  564. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_restart_app_intent.json +19 -0
  565. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent.json +19 -0
  566. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent_en.json +19 -0
  567. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent.json +20 -0
  568. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent_en.json +20 -0
  569. package/dist/qa/brain_matrix/fixtures/scenario_long_doctrine_no_truncate.json +23 -0
  570. package/dist/qa/brain_matrix/fixtures/scenario_manifest_read_intent.json +19 -0
  571. package/dist/qa/brain_matrix/fixtures/scenario_manual_open_intent.json +19 -0
  572. package/dist/qa/brain_matrix/fixtures/scenario_mcp_bridge_unreachable_graceful.json +39 -0
  573. package/dist/qa/brain_matrix/fixtures/scenario_mcp_disabled_bridge_no_verbs.json +18 -0
  574. package/dist/qa/brain_matrix/fixtures/scenario_mcp_discover_tools_intent.json +19 -0
  575. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invariant_1_no_verbs.json +19 -0
  576. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_two_hop.json +68 -0
  577. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_with_auth_loaded.json +76 -0
  578. package/dist/qa/brain_matrix/fixtures/scenario_mcp_revoked_token_graceful.json +33 -0
  579. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_intent.json +21 -0
  580. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_no_token_arg.json +27 -0
  581. package/dist/qa/brain_matrix/fixtures/scenario_mcp_show_tools_before_invoke.json +44 -0
  582. package/dist/qa/brain_matrix/fixtures/scenario_mcp_toggle_intent.json +20 -0
  583. package/dist/qa/brain_matrix/fixtures/scenario_multi_turn_clarify_then_act.json +24 -0
  584. package/dist/qa/brain_matrix/fixtures/scenario_nac3_attrs_doctrine.json +53 -0
  585. package/dist/qa/brain_matrix/fixtures/scenario_nac3_discover_schemas_intent.json +19 -0
  586. package/dist/qa/brain_matrix/fixtures/scenario_nac3_required_attr_missing.json +19 -0
  587. package/dist/qa/brain_matrix/fixtures/scenario_no_bare_ok_after_destructive.json +27 -0
  588. package/dist/qa/brain_matrix/fixtures/scenario_no_global_learnings_no_recall.json +20 -0
  589. package/dist/qa/brain_matrix/fixtures/scenario_no_id_leak_in_reply.json +24 -0
  590. package/dist/qa/brain_matrix/fixtures/scenario_no_invent_verb.json +18 -0
  591. package/dist/qa/brain_matrix/fixtures/scenario_no_loop_after_repeated_fail.json +42 -0
  592. package/dist/qa/brain_matrix/fixtures/scenario_no_password_echo.json +28 -0
  593. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_all_current.json +28 -0
  594. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent.json +20 -0
  595. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent_en.json +20 -0
  596. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_then_explain.json +35 -0
  597. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_read_intent.json +24 -0
  598. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_write_required_args.json +23 -0
  599. package/dist/qa/brain_matrix/fixtures/scenario_office_overwrite_explicit.json +23 -0
  600. package/dist/qa/brain_matrix/fixtures/scenario_office_word_write_intent.json +27 -0
  601. package/dist/qa/brain_matrix/fixtures/scenario_panel_open_settings_intent.json +19 -0
  602. package/dist/qa/brain_matrix/fixtures/scenario_panel_send_message_intent.json +19 -0
  603. package/dist/qa/brain_matrix/fixtures/scenario_pdf_read_intent.json +22 -0
  604. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_clear_tab_explicit_close.json +17 -0
  605. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_chart.json +30 -0
  606. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_long_table.json +28 -0
  607. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_read_tab_intent.json +20 -0
  608. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_render_not_inline.json +20 -0
  609. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_read_file.json +28 -0
  610. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_verb_over_shell.json +22 -0
  611. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_workflow_state.json +28 -0
  612. package/dist/qa/brain_matrix/fixtures/scenario_project_init_intent.json +20 -0
  613. package/dist/qa/brain_matrix/fixtures/scenario_project_set_root_intent.json +20 -0
  614. package/dist/qa/brain_matrix/fixtures/scenario_promote_lesson_after_correction.json +17 -0
  615. package/dist/qa/brain_matrix/fixtures/scenario_r8_destructive_shell_exec.json +21 -0
  616. package/dist/qa/brain_matrix/fixtures/scenario_read_then_parse_order.json +36 -0
  617. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_jump_intent.json +19 -0
  618. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_set_intent.json +19 -0
  619. package/dist/qa/brain_matrix/fixtures/scenario_reader_for_long_doc.json +21 -0
  620. package/dist/qa/brain_matrix/fixtures/scenario_reader_list_docs_intent.json +19 -0
  621. package/dist/qa/brain_matrix/fixtures/scenario_reader_next_block_intent.json +19 -0
  622. package/dist/qa/brain_matrix/fixtures/scenario_reader_read_section_intent.json +19 -0
  623. package/dist/qa/brain_matrix/fixtures/scenario_reader_recap_intent.json +19 -0
  624. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent.json +20 -0
  625. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent_en.json +20 -0
  626. package/dist/qa/brain_matrix/fixtures/scenario_refuses_blanket_chmod_777.json +17 -0
  627. package/dist/qa/brain_matrix/fixtures/scenario_refuses_bypass_approval_modal.json +18 -0
  628. package/dist/qa/brain_matrix/fixtures/scenario_refuses_delete_critical_en.json +18 -0
  629. package/dist/qa/brain_matrix/fixtures/scenario_refuses_disable_vault_encryption.json +18 -0
  630. package/dist/qa/brain_matrix/fixtures/scenario_refuses_drop_database.json +17 -0
  631. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main.json +17 -0
  632. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main_en.json +17 -0
  633. package/dist/qa/brain_matrix/fixtures/scenario_refuses_leak_vault_en.json +18 -0
  634. package/dist/qa/brain_matrix/fixtures/scenario_refuses_modify_node_modules.json +17 -0
  635. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks.json +17 -0
  636. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks_en.json +17 -0
  637. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_delete_critical.json +18 -0
  638. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_leak_vault.json +18 -0
  639. package/dist/qa/brain_matrix/fixtures/scenario_respects_global_learnings.json +28 -0
  640. package/dist/qa/brain_matrix/fixtures/scenario_respects_workflow_gate_g2.json +39 -0
  641. package/dist/qa/brain_matrix/fixtures/scenario_revoke_lesson_request.json +21 -0
  642. package/dist/qa/brain_matrix/fixtures/scenario_sq_rules_active.json +30 -0
  643. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent.json +20 -0
  644. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent_en.json +20 -0
  645. package/dist/qa/brain_matrix/fixtures/scenario_truncated_response_retry.json +22 -0
  646. package/dist/qa/brain_matrix/fixtures/scenario_unknown_command_clarify.json +23 -0
  647. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_compose.json +23 -0
  648. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_handles_invalid.json +27 -0
  649. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent.json +20 -0
  650. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent_en.json +20 -0
  651. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_then_inspect_query.json +28 -0
  652. package/dist/qa/brain_matrix/fixtures/scenario_url_then_stringify_order.json +34 -0
  653. package/dist/qa/brain_matrix/fixtures/scenario_user_just_greets.json +17 -0
  654. package/dist/qa/brain_matrix/fixtures/scenario_user_overrides_proceeds.json +24 -0
  655. package/dist/qa/brain_matrix/fixtures/scenario_user_revokes_in_middle.json +22 -0
  656. package/dist/qa/brain_matrix/fixtures/scenario_voice_open_pizarron.json +21 -0
  657. package/dist/qa/brain_matrix/fixtures/scenario_word_outline_extraction.json +22 -0
  658. package/dist/qa/brain_matrix/fixtures/scenario_word_overwrite_explicit.json +20 -0
  659. package/dist/qa/brain_matrix/fixtures/scenario_word_section_count.json +28 -0
  660. package/dist/qa/brain_matrix/fixtures/scenario_workflow_doctrine.json +53 -0
  661. package/dist/qa/brain_matrix/fixtures/scenario_workflow_done_specs.json +32 -0
  662. package/dist/qa/brain_matrix/fixtures/scenario_workflow_intent_capture.json +22 -0
  663. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_jump_block.json +26 -0
  664. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_v_step_15.json +41 -0
  665. package/dist/qa/brain_matrix/fixtures/scenario_workflow_run_step_intent.json +19 -0
  666. package/dist/qa/brain_matrix/fixtures/scenario_workflow_set_intent.json +20 -0
  667. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_injection.json +32 -0
  668. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_recovers_after_clarify.json +25 -0
  669. package/dist/qa/brain_matrix/fixtures/scenario_workflow_step_1_intake.json +24 -0
  670. package/dist/qa/brain_matrix/fixtures/scenario_yf_command_doctrine.json +56 -0
  671. package/dist/qa/brain_matrix/fixtures/scenario_yf_doctrine_list_intent.json +19 -0
  672. package/dist/qa/brain_matrix/fixtures/scenario_yf_qa_compare_intent.json +17 -0
  673. package/dist/qa/brain_matrix/invariants.d.ts +18 -0
  674. package/dist/qa/brain_matrix/invariants.d.ts.map +1 -0
  675. package/dist/qa/brain_matrix/invariants.js +333 -0
  676. package/dist/qa/brain_matrix/invariants.js.map +1 -0
  677. package/dist/qa/brain_matrix/report.d.ts +12 -0
  678. package/dist/qa/brain_matrix/report.d.ts.map +1 -0
  679. package/dist/qa/brain_matrix/report.js +131 -0
  680. package/dist/qa/brain_matrix/report.js.map +1 -0
  681. package/dist/qa/brain_matrix/runner.d.ts +31 -0
  682. package/dist/qa/brain_matrix/runner.d.ts.map +1 -0
  683. package/dist/qa/brain_matrix/runner.js +561 -0
  684. package/dist/qa/brain_matrix/runner.js.map +1 -0
  685. package/dist/qa/brain_matrix/types.d.ts +180 -0
  686. package/dist/qa/brain_matrix/types.d.ts.map +1 -0
  687. package/dist/qa/brain_matrix/types.js +2 -0
  688. package/dist/qa/brain_matrix/types.js.map +1 -0
  689. package/dist/qa/brain_matrix/validate_scenario.d.ts +23 -0
  690. package/dist/qa/brain_matrix/validate_scenario.d.ts.map +1 -0
  691. package/dist/qa/brain_matrix/validate_scenario.js +128 -0
  692. package/dist/qa/brain_matrix/validate_scenario.js.map +1 -0
  693. package/dist/support/github_dispatcher.d.ts +36 -0
  694. package/dist/support/github_dispatcher.d.ts.map +1 -0
  695. package/dist/support/github_dispatcher.js +292 -0
  696. package/dist/support/github_dispatcher.js.map +1 -0
  697. package/dist/support/reports.d.ts +31 -0
  698. package/dist/support/reports.d.ts.map +1 -0
  699. package/dist/support/reports.js +162 -0
  700. package/dist/support/reports.js.map +1 -0
  701. package/dist/telemetry/usage.d.ts +67 -0
  702. package/dist/telemetry/usage.d.ts.map +1 -0
  703. package/dist/telemetry/usage.js +208 -0
  704. package/dist/telemetry/usage.js.map +1 -0
  705. package/dist/version.d.ts +1 -1
  706. package/dist/version.d.ts.map +1 -1
  707. package/dist/version.js +1 -1
  708. package/dist/version.js.map +1 -1
  709. package/dist/voice/config.d.ts +12 -0
  710. package/dist/voice/config.d.ts.map +1 -1
  711. package/dist/voice/config.js +25 -2
  712. package/dist/voice/config.js.map +1 -1
  713. package/dist/voice/intents.d.ts +1 -1
  714. package/dist/voice/intents.js +0 -0
  715. package/dist/voice/providers/google.d.ts +9 -0
  716. package/dist/voice/providers/google.d.ts.map +1 -1
  717. package/dist/voice/providers/google.js +197 -28
  718. package/dist/voice/providers/google.js.map +1 -1
  719. package/dist/voice/router.d.ts +10 -0
  720. package/dist/voice/router.d.ts.map +1 -1
  721. package/dist/voice/router.js +39 -20
  722. package/dist/voice/router.js.map +1 -1
  723. package/dist/voice/types.d.ts +5 -2
  724. package/dist/voice/types.d.ts.map +1 -1
  725. package/dist/voice/types.js.map +1 -1
  726. package/dist/workflow/phase_inference.d.ts +56 -0
  727. package/dist/workflow/phase_inference.d.ts.map +1 -0
  728. package/dist/workflow/phase_inference.js +107 -0
  729. package/dist/workflow/phase_inference.js.map +1 -0
  730. package/dist/workflow/state.d.ts +238 -0
  731. package/dist/workflow/state.d.ts.map +1 -0
  732. package/dist/workflow/state.js +213 -0
  733. package/dist/workflow/state.js.map +1 -0
  734. package/docs/SQ.md +1397 -0
  735. package/docs/SQ_BY_STEP.yaml +147 -0
  736. package/docs/doctrine/accessibility.md +78 -0
  737. package/docs/doctrine/agent-orchestrator.md +76 -0
  738. package/docs/doctrine/byok-vs-managed.md +81 -0
  739. package/docs/doctrine/cost-router-escalation.md +73 -0
  740. package/docs/doctrine/explain-results.md +90 -0
  741. package/docs/doctrine/g-doc.md +46 -0
  742. package/docs/doctrine/gates.md +21 -0
  743. package/docs/doctrine/lessons-workflow.md +68 -0
  744. package/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  745. package/docs/doctrine/nac3-attrs.md +23 -0
  746. package/docs/doctrine/office-tools.md +102 -0
  747. package/docs/doctrine/pizarron.md +52 -0
  748. package/docs/doctrine/r8-modal.md +60 -0
  749. package/docs/doctrine/safety-refusals.md +73 -0
  750. package/docs/doctrine/verb-composition.md +68 -0
  751. package/docs/doctrine/workflow-phases.md +108 -0
  752. package/docs/doctrine/workflow.md +58 -0
  753. package/docs/doctrine/yf-commands.md +49 -0
  754. package/package.json +21 -15
  755. package/src/i18n/catalogs/ar.json +55 -10
  756. package/src/i18n/catalogs/de.json +55 -10
  757. package/src/i18n/catalogs/en.json +66 -1
  758. package/src/i18n/catalogs/es.json +66 -1
  759. package/src/i18n/catalogs/fr.json +55 -10
  760. package/src/i18n/catalogs/hi.json +55 -10
  761. package/src/i18n/catalogs/it.json +55 -10
  762. package/src/i18n/catalogs/ja.json +55 -10
  763. package/src/i18n/catalogs/pt.json +55 -10
  764. package/src/i18n/catalogs/zh.json +55 -10
  765. package/templates/nextjs-app/README.md +48 -0
  766. package/templates/nextjs-app/next.config.js +8 -0
  767. package/templates/nextjs-app/package.json +33 -0
  768. package/templates/nextjs-app/src/app/globals.css +43 -0
  769. package/templates/nextjs-app/src/app/layout.tsx +29 -0
  770. package/templates/nextjs-app/src/app/page.tsx +63 -0
  771. package/templates/nextjs-app/src/nac/manifest.ts +36 -0
  772. package/templates/nextjs-app/tsconfig.json +21 -0
  773. package/templates/nextjs-app/yujin.forge.json +11 -0
@@ -0,0 +1,112 @@
1
+ /**
2
+ * Shared types for the HITO 5 agent orchestrator (slice 1+).
3
+ *
4
+ * AgentDefinition: the persistent agent config the user authors.
5
+ * AgentRun: a single execution attempt, with status + telemetry.
6
+ * AgentMessage: an inter-agent bridge message (D1 storage in
7
+ * managed mode, JSON buffer in local-only mode).
8
+ *
9
+ * Per HITO 5 lock 2026-06-04: every numeric threshold this module
10
+ * touches comes from `getAgentConfig(key)` in config_resolver.ts,
11
+ * not from a literal here.
12
+ */
13
+ /** Trigger kinds an agent can subscribe to. */
14
+ export type AgentTriggerKind = 'manual' | 'cron' | 'event';
15
+ export interface AgentTrigger {
16
+ kind: AgentTriggerKind;
17
+ /** Trigger-kind-specific config. Shape depends on kind:
18
+ * manual -> {}
19
+ * cron -> { cron_expr: string }
20
+ * event -> { match: string } // e.g. "pipeline_runs:advance_stage"
21
+ */
22
+ config: Record<string, unknown>;
23
+ }
24
+ /** Status field on an AgentDefinition. */
25
+ export type AgentDefinitionStatus = 'active' | 'paused' | 'deleted' | 'auto_revoked';
26
+ export interface AgentDefinition {
27
+ /** Stable slug (kebab-case). Used as bridge address + filesystem key. */
28
+ slug: string;
29
+ /** Display name (free text). */
30
+ name: string;
31
+ /** One-liner shown in `yf agent list`. */
32
+ description: string;
33
+ /** Brain tier the agent runs on. */
34
+ brain_tier: 'eco' | 'frontier' | 'managed';
35
+ /** When/how the agent fires. */
36
+ trigger: AgentTrigger;
37
+ /** Whitelist of agent slugs THIS agent is allowed to message via
38
+ * the bridge. Receivers in `can_call` must ALSO whitelist back
39
+ * -- handshake is two-sided. */
40
+ can_call: string[];
41
+ /** Whitelist of agent slugs that may message THIS agent. */
42
+ can_be_called_by: string[];
43
+ /** NAC-3 verbs the agent is allowed to invoke. Restricts the
44
+ * manifest the brain sees during the run. Empty = inherit from
45
+ * the user's full manifest (rare; usually a narrow list). */
46
+ allowed_verbs: string[];
47
+ /** System prompt addition. Appended to the default agent system
48
+ * prompt -- NOT a replacement. */
49
+ prompt_addition: string;
50
+ /** Lifecycle state. */
51
+ status: AgentDefinitionStatus;
52
+ created_at: number;
53
+ updated_at: number;
54
+ /** When set, agent moved here from `active` -- `auto_revoked` */
55
+ revoked_reason?: string;
56
+ }
57
+ /** Outcome of an AgentRun. */
58
+ export type AgentRunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'killed_quota' | 'killed_rejections' | 'killed_user';
59
+ export interface AgentRun {
60
+ id: string;
61
+ slug: string;
62
+ trigger_kind: AgentTriggerKind;
63
+ /** Free-text reason the run started (e.g. "manual", "cron tick
64
+ * at 06:00 UTC", "event:pipeline_runs:advance_stage"). */
65
+ trigger_reason: string;
66
+ started_at: number;
67
+ ended_at?: number;
68
+ status: AgentRunStatus;
69
+ /** Telemetry. */
70
+ tokens_in: number;
71
+ tokens_out: number;
72
+ tool_calls: number;
73
+ rejected_approvals: number;
74
+ /** Last brain reply text (truncated to first 500 chars for the
75
+ * list view). Full transcript in the run's transcript file. */
76
+ last_reply_summary: string;
77
+ /** When status is a kill code, the reason in plain text. */
78
+ kill_reason?: string;
79
+ }
80
+ /** Status of a single inter-agent message. */
81
+ export type AgentMessageStatus = 'pending' | 'delivered' | 'read' | 'expired' | 'auto_revoked';
82
+ export interface AgentMessage {
83
+ id: number;
84
+ /** sha256 of `min(a,b) + "|" + max(a,b)` -- deterministic pair id
85
+ * so loop detection works regardless of direction. */
86
+ pair_id: string;
87
+ from_slug: string;
88
+ to_slug: string;
89
+ /** Free-shape payload (sender supplies). */
90
+ payload: unknown;
91
+ /** Tokens this message cost (counts against the pair quota). */
92
+ tokens_used: number;
93
+ status: AgentMessageStatus;
94
+ created_at: number;
95
+ delivered_at?: number;
96
+ read_at?: number;
97
+ /** TTL in epoch ms. Default = created_at + agent.bridge.message_ttl_seconds. */
98
+ expires_at: number;
99
+ }
100
+ /** Pair-level state tracked by the bridge for cap enforcement +
101
+ * loop detection. Stored alongside agent_messages. */
102
+ export interface AgentPairCap {
103
+ pair_id: string;
104
+ tokens_used_window: number;
105
+ window_started_at: number;
106
+ round_trips_60s: number;
107
+ last_round_trip_at: number;
108
+ status: 'open' | 'frozen' | 'auto_revoked';
109
+ }
110
+ export declare function pairIdFor(a: string, b: string): string;
111
+ export declare function isValidAgentSlug(slug: unknown): slug is string;
112
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Shared types for the HITO 5 agent orchestrator (slice 1+).
3
+ *
4
+ * AgentDefinition: the persistent agent config the user authors.
5
+ * AgentRun: a single execution attempt, with status + telemetry.
6
+ * AgentMessage: an inter-agent bridge message (D1 storage in
7
+ * managed mode, JSON buffer in local-only mode).
8
+ *
9
+ * Per HITO 5 lock 2026-06-04: every numeric threshold this module
10
+ * touches comes from `getAgentConfig(key)` in config_resolver.ts,
11
+ * not from a literal here.
12
+ */
13
+ /* Helper: deterministic pair id used by the bridge. Pure function
14
+ * so both ends derive the same id without coordination. */
15
+ export function pairIdFor(a, b) {
16
+ const lo = a < b ? a : b;
17
+ const hi = a < b ? b : a;
18
+ /* Tiny FNV-1a -- no crypto dep needed, just a stable hash for
19
+ * use as a primary key. Collision risk is irrelevant: the input
20
+ * space is "your own agent slugs", a few hundred at most. */
21
+ let h = 0x811c9dc5;
22
+ const s = lo + '|' + hi;
23
+ for (let i = 0; i < s.length; i++) {
24
+ h ^= s.charCodeAt(i);
25
+ h = Math.imul(h, 0x01000193);
26
+ }
27
+ return ('00000000' + (h >>> 0).toString(16)).slice(-8);
28
+ }
29
+ /* Slug validation -- agent slugs follow the same kebab-case rules
30
+ * as pipeline slugs in the parent CRM repo. Re-implemented here
31
+ * so the agents module has no cross-module import. */
32
+ export function isValidAgentSlug(slug) {
33
+ if (typeof slug !== 'string')
34
+ return false;
35
+ if (slug.length < 2 || slug.length > 80)
36
+ return false;
37
+ return /^[a-z][a-z0-9-]*[a-z0-9]$/.test(slug);
38
+ }
39
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgIH;2DAC2D;AAC3D,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB;;kEAE8D;IAC9D,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;sDAEsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,YAAY,IAAI,OAAO,CAsCtC"}
1
+ {"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDpC,wBAAgB,YAAY,IAAI,OAAO,CAkFtC"}
package/dist/bin/yf.js CHANGED
@@ -27,14 +27,36 @@ import { registerScenariosCommand } from '../commands/scenarios.js';
27
27
  import { registerReviewScreensCommand } from '../commands/review-screens.js';
28
28
  import { registerPublishCommand } from '../commands/publish.js';
29
29
  import { registerProjectsCommand } from '../commands/projects.js';
30
+ import { registerLessonsCommand } from '../commands/lessons.js';
31
+ import { registerDoctrinesCommand } from '../commands/doctrines.js';
30
32
  import { registerTunnelCommand } from '../commands/tunnel.js';
31
33
  import { registerDeployCommand } from '../commands/deploy.js';
32
34
  import { registerAppCommand } from '../commands/app.js';
33
35
  import { registerVoiceCommand } from '../commands/voice.js';
34
36
  import { registerKeysSetupCommand } from '../commands/keys_setup.js';
37
+ import { registerBrainCommand } from '../commands/brain.js';
38
+ import { registerLimitsCommand } from '../commands/limits.js';
39
+ import { registerQaCommand } from '../commands/qa.js';
40
+ import { registerDoctrineCommand } from '../commands/doctrine.js';
41
+ import { registerManifestCommand } from '../commands/manifest-cli.js';
35
42
  import { registerRepoCommand } from '../commands/repo.js';
36
43
  import { registerMobileCommand } from '../commands/mobile.js';
37
44
  import { registerLogCommand } from '../commands/log.js';
45
+ import { registerTriageCommand } from '../commands/triage.js';
46
+ import { registerDiscoverCommand } from '../commands/discover.js';
47
+ import { registerLegacyAuditCommand } from '../commands/legacy-audit.js';
48
+ import { registerClarifyCommand } from '../commands/clarify.js';
49
+ import { registerSpecCommand } from '../commands/spec.js';
50
+ import { registerApproveCommand } from '../commands/approve.js';
51
+ import { registerBootstrapCommand } from '../commands/bootstrap.js';
52
+ import { registerBlockCommand } from '../commands/block.js';
53
+ import { registerCoverageCommand } from '../commands/workflow-coverage.js';
54
+ import { registerOperateCommand } from '../commands/operate.js';
55
+ import { registerSupportCommand } from '../commands/support.js';
56
+ import { registerGraphCommand } from '../commands/graph.js';
57
+ import { registerMcpCommand } from '../commands/mcp.js';
58
+ import { registerNac3Command } from '../commands/nac3.js';
59
+ import { registerAgentCommand } from '../commands/agent.js';
38
60
  import { VERSION } from '../version.js';
39
61
  export function buildProgram() {
40
62
  const program = new Command();
@@ -61,6 +83,8 @@ export function buildProgram() {
61
83
  registerReviewScreensCommand(program);
62
84
  registerPublishCommand(program);
63
85
  registerProjectsCommand(program);
86
+ registerLessonsCommand(program);
87
+ registerDoctrinesCommand(program);
64
88
  registerTunnelCommand(program);
65
89
  registerDeployCommand(program);
66
90
  registerAppCommand(program);
@@ -68,9 +92,49 @@ export function buildProgram() {
68
92
  /* `yf keys setup` -- BYOK provider keys (brain + voice) + sync. */
69
93
  const keys = program.command('keys').description('BYOK provider keys (brain + voice).');
70
94
  registerKeysSetupCommand(keys);
95
+ /* `yf brain` -- alpha.51 brain tier configuration (eco / frontier
96
+ * provider+model + which workflow phase escalates). */
97
+ registerBrainCommand(program);
98
+ /* `yf limits` -- alpha.59c runtime caps (max tool rounds per
99
+ * verb family, timeouts, classifier budget). */
100
+ registerLimitsCommand(program);
101
+ /* `yf qa` -- alpha.59y.0 brain-matrix QA harness. */
102
+ registerQaCommand(program);
103
+ /* `yf doctrine` -- enumerate + preview doctrines on disk
104
+ * (z.67). */
105
+ registerDoctrineCommand(program);
106
+ /* `yf manifest` -- list NAC-3 verbs by namespace (z.67). */
107
+ registerManifestCommand(program);
71
108
  registerRepoCommand(program);
72
109
  registerMobileCommand(program);
73
110
  registerLogCommand(program);
111
+ /* PRODUCT_WORKFLOW.md commands (Phase I onwards). */
112
+ registerTriageCommand(program);
113
+ registerDiscoverCommand(program);
114
+ registerLegacyAuditCommand(program);
115
+ registerClarifyCommand(program);
116
+ registerSpecCommand(program);
117
+ registerApproveCommand(program);
118
+ registerBootstrapCommand(program);
119
+ registerBlockCommand(program);
120
+ registerCoverageCommand(program);
121
+ registerOperateCommand(program);
122
+ registerSupportCommand(program);
123
+ /* `yf graph` -- alpha.59p semantic graph CRUD + relevance
124
+ * preview. Spec: docs/SEMANTIC_GRAPH_SPEC_2026_06_02.md. */
125
+ registerGraphCommand(program);
126
+ /* `yf mcp` -- alpha.59p.3 MCP bridge feature flag (default
127
+ * OFF). Bridge runtime lands in alpha.60. Spec:
128
+ * docs/MCP_BRIDGE_PLAN.md v2. */
129
+ registerMcpCommand(program);
130
+ /* `yf nac3` -- NAC-3 v3.x backend tools CLI (task #23 slice 3).
131
+ * Inspect + validate + invoke app.* tools declared in
132
+ * yujin.forge.json:nac3_backend.tools[].
133
+ * Spec: docs/NAC3_SPEC_V3_BACKEND_TOOLS.md. */
134
+ registerNac3Command(program);
135
+ /* `yf agent` -- HITO 5 slice 1 read-only surface (list / show /
136
+ * doctor). Runner + bridge land in subsequent slices. */
137
+ registerAgentCommand(program);
74
138
  return program;
75
139
  }
76
140
  async function main() {
@@ -82,8 +146,28 @@ async function main() {
82
146
  const isDirect = import.meta.url === `file://${process.argv[1]}`
83
147
  || (process.argv[1] !== undefined && import.meta.url.endsWith('/' + process.argv[1].split(/[/\\]/).pop()));
84
148
  if (isDirect) {
85
- main().catch((err) => {
86
- console.error(err instanceof Error ? err.message : String(err));
149
+ main().catch(async (err) => {
150
+ /* alpha.59z.14 F104 -- if the error carries a forge_error
151
+ * payload (attached by deeper layers like resolveAnthropicKey
152
+ * or HTTP responses with body.forge_error), format it via the
153
+ * CLI renderer for the friendly what/why/fix triple. Falls
154
+ * back to the legacy message string when no forge_error is
155
+ * present. */
156
+ const fe = err.forge_error;
157
+ if (fe && typeof fe === 'object') {
158
+ try {
159
+ const { formatForgeErrorCli } = await import('../core/error_formatter.js');
160
+ process.stderr.write(formatForgeErrorCli(fe));
161
+ }
162
+ catch {
163
+ /* Formatter import failed (build issue?). Fall through to
164
+ * legacy message so we never lose the error. */
165
+ console.error(err instanceof Error ? err.message : String(err));
166
+ }
167
+ }
168
+ else {
169
+ console.error(err instanceof Error ? err.message : String(err));
170
+ }
87
171
  process.exit(1);
88
172
  });
89
173
  }
@@ -1 +1 @@
1
- {"version":3,"file":"yf.js","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,CAAC,8DAA8D,CAAC;SAC3E,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,6BAA6B,CAAC;SAChE,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC;SACrC,kBAAkB,CAAC,0CAA0C,CAAC,CAAC;IAElE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACtC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mEAAmE;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IACxF,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,iEAAiE;AACjE,8BAA8B;AAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;OAC3D,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAE7G,IAAI,QAAQ,EAAE,CAAC;IACb,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"yf.js","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,5 @@
1
1
  import type { ToolSpec } from './tools.js';
2
+ import { type UsageKind } from '../telemetry/usage.js';
2
3
  export declare class ConfigurationError extends Error {
3
4
  constructor(message: string);
4
5
  }
@@ -9,6 +10,25 @@ export declare class ClaudeApiError extends Error {
9
10
  export interface ChatMessage {
10
11
  role: 'user' | 'assistant';
11
12
  content: string;
13
+ /** alpha.56 -- tier the assistant turn was served by. Persisted
14
+ * in the store so the next turn's reasoning_gate can apply
15
+ * sticky-tier inertia (a follow-up to a frontier turn should
16
+ * stay in frontier unless the new message has strong eco
17
+ * signals). Optional + ignored by callers that pre-date the
18
+ * sticky path. */
19
+ brain_tier?: 'eco' | 'frontier';
20
+ /** alpha.56 -- set to true when the assistant turn invoked a
21
+ * doc-loading verb (yujin.reader.open, yujin.fs.read-file,
22
+ * yujin.fs.read-project-file, etc). The next turn's router
23
+ * treats this as a signal to stay in frontier even if the
24
+ * user message looks short / simple, because the user is
25
+ * almost certainly about to ask the model to reason over
26
+ * that doc. */
27
+ doc_loaded?: boolean;
28
+ /** alpha.56 -- hidden synthetic user message (e.g. modal
29
+ * approval continuation). Set by the panel when injecting
30
+ * follow-up turns the user did not type. Not rendered. */
31
+ hidden?: boolean;
12
32
  }
13
33
  /** One round of tool dispatch recorded for the chat panel's action
14
34
  * trace. The caller serialises these into the response so the UI
@@ -48,6 +68,15 @@ export interface ClaudeChatRequest {
48
68
  /** Maximum tool-use loop iterations. Default 5. Stops with a
49
69
  `tool_loop_exhausted` ClaudeApiError when reached. */
50
70
  maxToolRounds?: number;
71
+ /** Usage kind for telemetry. Defaults to `claude.chat`. Callers
72
+ issuing spec / clarify / triage calls pass the matching kind
73
+ so cost reports group correctly. */
74
+ usageKind?: UsageKind;
75
+ /** Free-text label for the usage event (e.g. "spec.rfp",
76
+ "clarify.functional"). Optional. */
77
+ usageLabel?: string;
78
+ /** Project root associated with this call. Optional. */
79
+ projectRoot?: string;
51
80
  }
52
81
  export interface ClaudeChatResponse {
53
82
  text: string;
@@ -57,6 +86,18 @@ export interface ClaudeChatResponse {
57
86
  /** Per-round audit of tool dispatches. Empty when no tools were
58
87
  provided or the model did not call any. */
59
88
  toolRounds: ToolRound[];
89
+ /** alpha.59z.14 F104 -- truncation detection. Populated when
90
+ * the LAST round's output_tokens landed within
91
+ * TRUNCATION_MARGIN_TOKENS of max_tokens, OR when the provider
92
+ * explicitly reported stop_reason=max_tokens|length. Callers
93
+ * should surface a ForgeError(E_RESPONSE_TRUNCATED) when this
94
+ * is true. */
95
+ truncation?: {
96
+ truncated: boolean;
97
+ reason: string;
98
+ output_tokens: number;
99
+ max_tokens: number;
100
+ };
60
101
  }
61
102
  export interface ClaudeClientOptions {
62
103
  apiKey?: string;
@@ -70,24 +111,21 @@ export interface ClaudeClientOptions {
70
111
  *
71
112
  * Priority order (first match wins):
72
113
  * 1. Explicitly injected key (test seam).
73
- * 2. Vault slot `anthropic` -- the canonical path going
74
- * forward.
75
- * 3. process.env.YUJIN_ANTHROPIC_API_KEY -- legacy env var.
76
- * 4. process.env.ANTHROPIC_API_KEY -- standard Anthropic env.
77
- * 5. ~/.yujin-forge/api-key.txt -- legacy file path.
114
+ * 2. BYOK provider_keys.json (alpha.4+ canonical: `yf keys setup`).
115
+ * 3. Vault slot `anthropic` (V0.4 path, kept).
116
+ * 4. process.env.YUJIN_ANTHROPIC_API_KEY (legacy env var).
117
+ * 5. process.env.ANTHROPIC_API_KEY (standard Anthropic env).
118
+ * 6. ~/.yujin-forge/api-key.txt (legacy file path).
78
119
  *
79
120
  * Throws ConfigurationError when nothing is found. The error
80
- * message lists all the options so the user has a single place
81
- * to read where to put the key.
121
+ * message lists the options in current-recommended order so a
122
+ * fresh user is pointed at `yf keys setup` first.
82
123
  *
83
- * The vault check is short-circuiting: if the slot exists, the
84
- * env vars and the file are ignored. This makes vault-configured
85
- * setups deterministic and unaffected by stray env vars.
86
- *
87
- * The other three paths stay as back-compat for existing users
88
- * who already configured Forge via env or file before V0.4
89
- * landed. They are NOT deprecated -- they keep working
90
- * indefinitely. The vault is just the recommended path.
124
+ * The BYOK provider_keys check is the NEW canonical path that
125
+ * lands with the post-purchase activation flow (the landing
126
+ * tells the user to run `yf keys setup` after their Polar
127
+ * subscription is live). The vault slot remains supported for
128
+ * users who configured Forge pre-BYOK.
91
129
  */
92
130
  export declare function resolveApiKey(injected?: string): Promise<string>;
93
131
  export declare class ClaudeClient {
@@ -1 +1 @@
1
- {"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/chat/claude.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;wCAEwC;AACxC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;wDACoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;uDACmD;IACnD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;yBAEqB;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB;wCACoC;IACpC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH;6DACyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd;kDAC8C;IAC9C,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCtE;AAmBD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,GAAE,mBAAwB;IAMpC,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuHhE"}
1
+ {"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/chat/claude.ts"],"names":[],"mappings":"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"}