@nac3/forge-cli 0.2.0-alpha.5 → 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 (768) 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 +1905 -54
  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 +78 -0
  87. package/dist/chat/tools/git.js.map +1 -1
  88. package/dist/chat/tools/keys.d.ts +9 -0
  89. package/dist/chat/tools/keys.d.ts.map +1 -0
  90. package/dist/chat/tools/keys.js +152 -0
  91. package/dist/chat/tools/keys.js.map +1 -0
  92. package/dist/chat/tools/misc_verbs.d.ts +36 -0
  93. package/dist/chat/tools/misc_verbs.d.ts.map +1 -0
  94. package/dist/chat/tools/misc_verbs.js +405 -0
  95. package/dist/chat/tools/misc_verbs.js.map +1 -0
  96. package/dist/chat/tools/nac3_invoke.d.ts +53 -0
  97. package/dist/chat/tools/nac3_invoke.d.ts.map +1 -0
  98. package/dist/chat/tools/nac3_invoke.js +886 -0
  99. package/dist/chat/tools/nac3_invoke.js.map +1 -0
  100. package/dist/chat/tools/pizarron.d.ts +40 -0
  101. package/dist/chat/tools/pizarron.d.ts.map +1 -0
  102. package/dist/chat/tools/pizarron.js +123 -0
  103. package/dist/chat/tools/pizarron.js.map +1 -0
  104. package/dist/chat/tools/project_lifecycle.d.ts +24 -0
  105. package/dist/chat/tools/project_lifecycle.d.ts.map +1 -0
  106. package/dist/chat/tools/project_lifecycle.js +184 -0
  107. package/dist/chat/tools/project_lifecycle.js.map +1 -0
  108. package/dist/chat/tools/reader.d.ts.map +1 -1
  109. package/dist/chat/tools/reader.js +144 -1
  110. package/dist/chat/tools/reader.js.map +1 -1
  111. package/dist/chat/tools/shell.d.ts +58 -0
  112. package/dist/chat/tools/shell.d.ts.map +1 -0
  113. package/dist/chat/tools/shell.js +253 -0
  114. package/dist/chat/tools/shell.js.map +1 -0
  115. package/dist/chat/tools/workflow.d.ts +45 -0
  116. package/dist/chat/tools/workflow.d.ts.map +1 -0
  117. package/dist/chat/tools/workflow.js +404 -0
  118. package/dist/chat/tools/workflow.js.map +1 -0
  119. package/dist/chat/tools.d.ts +27 -0
  120. package/dist/chat/tools.d.ts.map +1 -1
  121. package/dist/chat/tools.js +362 -13
  122. package/dist/chat/tools.js.map +1 -1
  123. package/dist/chat/workflow_inject.d.ts +52 -0
  124. package/dist/chat/workflow_inject.d.ts.map +1 -0
  125. package/dist/chat/workflow_inject.js +346 -0
  126. package/dist/chat/workflow_inject.js.map +1 -0
  127. package/dist/commands/agent.d.ts +22 -0
  128. package/dist/commands/agent.d.ts.map +1 -0
  129. package/dist/commands/agent.js +190 -0
  130. package/dist/commands/agent.js.map +1 -0
  131. package/dist/commands/approve.d.ts +32 -0
  132. package/dist/commands/approve.d.ts.map +1 -0
  133. package/dist/commands/approve.js +198 -0
  134. package/dist/commands/approve.js.map +1 -0
  135. package/dist/commands/block.d.ts +28 -0
  136. package/dist/commands/block.d.ts.map +1 -0
  137. package/dist/commands/block.js +189 -0
  138. package/dist/commands/block.js.map +1 -0
  139. package/dist/commands/bootstrap.d.ts +35 -0
  140. package/dist/commands/bootstrap.d.ts.map +1 -0
  141. package/dist/commands/bootstrap.js +205 -0
  142. package/dist/commands/bootstrap.js.map +1 -0
  143. package/dist/commands/brain.d.ts +17 -0
  144. package/dist/commands/brain.d.ts.map +1 -0
  145. package/dist/commands/brain.js +129 -0
  146. package/dist/commands/brain.js.map +1 -0
  147. package/dist/commands/chat.d.ts +3 -0
  148. package/dist/commands/chat.d.ts.map +1 -1
  149. package/dist/commands/chat.js +112 -1
  150. package/dist/commands/chat.js.map +1 -1
  151. package/dist/commands/clarify.d.ts +30 -0
  152. package/dist/commands/clarify.d.ts.map +1 -0
  153. package/dist/commands/clarify.js +671 -0
  154. package/dist/commands/clarify.js.map +1 -0
  155. package/dist/commands/discover.d.ts +30 -0
  156. package/dist/commands/discover.d.ts.map +1 -0
  157. package/dist/commands/discover.js +178 -0
  158. package/dist/commands/discover.js.map +1 -0
  159. package/dist/commands/doctor.js +26 -4
  160. package/dist/commands/doctor.js.map +1 -1
  161. package/dist/commands/doctrine.d.ts +24 -0
  162. package/dist/commands/doctrine.d.ts.map +1 -0
  163. package/dist/commands/doctrine.js +106 -0
  164. package/dist/commands/doctrine.js.map +1 -0
  165. package/dist/commands/doctrines.d.ts +21 -0
  166. package/dist/commands/doctrines.d.ts.map +1 -0
  167. package/dist/commands/doctrines.js +158 -0
  168. package/dist/commands/doctrines.js.map +1 -0
  169. package/dist/commands/graph.d.ts +21 -0
  170. package/dist/commands/graph.d.ts.map +1 -0
  171. package/dist/commands/graph.js +363 -0
  172. package/dist/commands/graph.js.map +1 -0
  173. package/dist/commands/keys_setup.d.ts.map +1 -1
  174. package/dist/commands/keys_setup.js +80 -0
  175. package/dist/commands/keys_setup.js.map +1 -1
  176. package/dist/commands/legacy-audit.d.ts +34 -0
  177. package/dist/commands/legacy-audit.d.ts.map +1 -0
  178. package/dist/commands/legacy-audit.js +270 -0
  179. package/dist/commands/legacy-audit.js.map +1 -0
  180. package/dist/commands/lessons.d.ts +28 -0
  181. package/dist/commands/lessons.d.ts.map +1 -0
  182. package/dist/commands/lessons.js +309 -0
  183. package/dist/commands/lessons.js.map +1 -0
  184. package/dist/commands/license.d.ts.map +1 -1
  185. package/dist/commands/license.js +56 -1
  186. package/dist/commands/license.js.map +1 -1
  187. package/dist/commands/limits.d.ts +15 -0
  188. package/dist/commands/limits.d.ts.map +1 -0
  189. package/dist/commands/limits.js +51 -0
  190. package/dist/commands/limits.js.map +1 -0
  191. package/dist/commands/manifest-cli.d.ts +12 -0
  192. package/dist/commands/manifest-cli.d.ts.map +1 -0
  193. package/dist/commands/manifest-cli.js +42 -0
  194. package/dist/commands/manifest-cli.js.map +1 -0
  195. package/dist/commands/mcp.d.ts +24 -0
  196. package/dist/commands/mcp.d.ts.map +1 -0
  197. package/dist/commands/mcp.js +163 -0
  198. package/dist/commands/mcp.js.map +1 -0
  199. package/dist/commands/nac3.d.ts +22 -0
  200. package/dist/commands/nac3.d.ts.map +1 -0
  201. package/dist/commands/nac3.js +125 -0
  202. package/dist/commands/nac3.js.map +1 -0
  203. package/dist/commands/operate.d.ts +22 -0
  204. package/dist/commands/operate.d.ts.map +1 -0
  205. package/dist/commands/operate.js +523 -0
  206. package/dist/commands/operate.js.map +1 -0
  207. package/dist/commands/qa.d.ts +24 -0
  208. package/dist/commands/qa.d.ts.map +1 -0
  209. package/dist/commands/qa.js +349 -0
  210. package/dist/commands/qa.js.map +1 -0
  211. package/dist/commands/spec.d.ts +38 -0
  212. package/dist/commands/spec.d.ts.map +1 -0
  213. package/dist/commands/spec.js +256 -0
  214. package/dist/commands/spec.js.map +1 -0
  215. package/dist/commands/support.d.ts +22 -0
  216. package/dist/commands/support.d.ts.map +1 -0
  217. package/dist/commands/support.js +165 -0
  218. package/dist/commands/support.js.map +1 -0
  219. package/dist/commands/triage.d.ts +34 -0
  220. package/dist/commands/triage.d.ts.map +1 -0
  221. package/dist/commands/triage.js +228 -0
  222. package/dist/commands/triage.js.map +1 -0
  223. package/dist/commands/vault-inventory.d.ts +30 -0
  224. package/dist/commands/vault-inventory.d.ts.map +1 -0
  225. package/dist/commands/vault-inventory.js +222 -0
  226. package/dist/commands/vault-inventory.js.map +1 -0
  227. package/dist/commands/vault.d.ts.map +1 -1
  228. package/dist/commands/vault.js +5 -0
  229. package/dist/commands/vault.js.map +1 -1
  230. package/dist/commands/voice.d.ts.map +1 -1
  231. package/dist/commands/voice.js +47 -4
  232. package/dist/commands/voice.js.map +1 -1
  233. package/dist/commands/workflow-coverage.d.ts +30 -0
  234. package/dist/commands/workflow-coverage.d.ts.map +1 -0
  235. package/dist/commands/workflow-coverage.js +138 -0
  236. package/dist/commands/workflow-coverage.js.map +1 -0
  237. package/dist/core/ansi_strip.d.ts +39 -0
  238. package/dist/core/ansi_strip.d.ts.map +1 -0
  239. package/dist/core/ansi_strip.js +71 -0
  240. package/dist/core/ansi_strip.js.map +1 -0
  241. package/dist/core/audit_log.d.ts +43 -0
  242. package/dist/core/audit_log.d.ts.map +1 -0
  243. package/dist/core/audit_log.js +80 -0
  244. package/dist/core/audit_log.js.map +1 -0
  245. package/dist/core/brain_config.d.ts +33 -0
  246. package/dist/core/brain_config.d.ts.map +1 -0
  247. package/dist/core/brain_config.js +132 -0
  248. package/dist/core/brain_config.js.map +1 -0
  249. package/dist/core/budget.d.ts +96 -0
  250. package/dist/core/budget.d.ts.map +1 -0
  251. package/dist/core/budget.js +300 -0
  252. package/dist/core/budget.js.map +1 -0
  253. package/dist/core/cost_meter.d.ts +35 -0
  254. package/dist/core/cost_meter.d.ts.map +1 -0
  255. package/dist/core/cost_meter.js +111 -0
  256. package/dist/core/cost_meter.js.map +1 -0
  257. package/dist/core/cost_router.d.ts +106 -0
  258. package/dist/core/cost_router.d.ts.map +1 -0
  259. package/dist/core/cost_router.js +465 -0
  260. package/dist/core/cost_router.js.map +1 -0
  261. package/dist/core/doctrine_resolver.d.ts +23 -0
  262. package/dist/core/doctrine_resolver.d.ts.map +1 -0
  263. package/dist/core/doctrine_resolver.js +108 -0
  264. package/dist/core/doctrine_resolver.js.map +1 -0
  265. package/dist/core/error_catalog.d.ts +80 -0
  266. package/dist/core/error_catalog.d.ts.map +1 -0
  267. package/dist/core/error_catalog.js +168 -0
  268. package/dist/core/error_catalog.js.map +1 -0
  269. package/dist/core/error_formatter.d.ts +30 -0
  270. package/dist/core/error_formatter.d.ts.map +1 -0
  271. package/dist/core/error_formatter.js +155 -0
  272. package/dist/core/error_formatter.js.map +1 -0
  273. package/dist/core/incomplete_detector.d.ts +51 -0
  274. package/dist/core/incomplete_detector.d.ts.map +1 -0
  275. package/dist/core/incomplete_detector.js +140 -0
  276. package/dist/core/incomplete_detector.js.map +1 -0
  277. package/dist/core/learnings_client.d.ts +104 -0
  278. package/dist/core/learnings_client.d.ts.map +1 -0
  279. package/dist/core/learnings_client.js +262 -0
  280. package/dist/core/learnings_client.js.map +1 -0
  281. package/dist/core/limits_config.d.ts +76 -0
  282. package/dist/core/limits_config.d.ts.map +1 -0
  283. package/dist/core/limits_config.js +297 -0
  284. package/dist/core/limits_config.js.map +1 -0
  285. package/dist/core/provider_keys.d.ts +35 -0
  286. package/dist/core/provider_keys.d.ts.map +1 -0
  287. package/dist/core/provider_keys.js +260 -0
  288. package/dist/core/provider_keys.js.map +1 -0
  289. package/dist/core/reasoning_gate.d.ts +72 -0
  290. package/dist/core/reasoning_gate.d.ts.map +1 -0
  291. package/dist/core/reasoning_gate.js +192 -0
  292. package/dist/core/reasoning_gate.js.map +1 -0
  293. package/dist/core/shell_classifier.d.ts +49 -0
  294. package/dist/core/shell_classifier.d.ts.map +1 -0
  295. package/dist/core/shell_classifier.js +159 -0
  296. package/dist/core/shell_classifier.js.map +1 -0
  297. package/dist/core/sq_resolver.d.ts +14 -0
  298. package/dist/core/sq_resolver.d.ts.map +1 -0
  299. package/dist/core/sq_resolver.js +230 -0
  300. package/dist/core/sq_resolver.js.map +1 -0
  301. package/dist/core/truncation_detector.d.ts +68 -0
  302. package/dist/core/truncation_detector.d.ts.map +1 -0
  303. package/dist/core/truncation_detector.js +115 -0
  304. package/dist/core/truncation_detector.js.map +1 -0
  305. package/dist/core/turn_classifier.d.ts +62 -0
  306. package/dist/core/turn_classifier.d.ts.map +1 -0
  307. package/dist/core/turn_classifier.js +213 -0
  308. package/dist/core/turn_classifier.js.map +1 -0
  309. package/dist/core/whats_new.d.ts +42 -0
  310. package/dist/core/whats_new.d.ts.map +1 -0
  311. package/dist/core/whats_new.js +214 -0
  312. package/dist/core/whats_new.js.map +1 -0
  313. package/dist/deploy/adapter.d.ts +93 -0
  314. package/dist/deploy/adapter.d.ts.map +1 -0
  315. package/dist/deploy/adapter.js +42 -0
  316. package/dist/deploy/adapter.js.map +1 -0
  317. package/dist/deploy/aws_adapter.d.ts +28 -0
  318. package/dist/deploy/aws_adapter.d.ts.map +1 -0
  319. package/dist/deploy/aws_adapter.js +98 -0
  320. package/dist/deploy/aws_adapter.js.map +1 -0
  321. package/dist/deploy/cloudflare.d.ts +24 -0
  322. package/dist/deploy/cloudflare.d.ts.map +1 -0
  323. package/dist/deploy/cloudflare.js +169 -0
  324. package/dist/deploy/cloudflare.js.map +1 -0
  325. package/dist/docs/LIMITED_RESPONSIBILITY.md +216 -0
  326. package/dist/docs/PRIVACY_POLICY.md +169 -0
  327. package/dist/docs/SQ.md +1397 -0
  328. package/dist/docs/SQ_BY_STEP.yaml +147 -0
  329. package/dist/docs/doctrine/accessibility.md +78 -0
  330. package/dist/docs/doctrine/agent-orchestrator.md +76 -0
  331. package/dist/docs/doctrine/byok-vs-managed.md +81 -0
  332. package/dist/docs/doctrine/cost-router-escalation.md +73 -0
  333. package/dist/docs/doctrine/explain-results.md +90 -0
  334. package/dist/docs/doctrine/g-doc.md +46 -0
  335. package/dist/docs/doctrine/gates.md +21 -0
  336. package/dist/docs/doctrine/lessons-workflow.md +68 -0
  337. package/dist/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  338. package/dist/docs/doctrine/nac3-attrs.md +23 -0
  339. package/dist/docs/doctrine/office-tools.md +102 -0
  340. package/dist/docs/doctrine/pizarron.md +52 -0
  341. package/dist/docs/doctrine/r8-modal.md +60 -0
  342. package/dist/docs/doctrine/safety-refusals.md +73 -0
  343. package/dist/docs/doctrine/verb-composition.md +68 -0
  344. package/dist/docs/doctrine/workflow-phases.md +108 -0
  345. package/dist/docs/doctrine/workflow.md +58 -0
  346. package/dist/docs/doctrine/yf-commands.md +49 -0
  347. package/dist/json/query.d.ts +38 -0
  348. package/dist/json/query.d.ts.map +1 -0
  349. package/dist/json/query.js +177 -0
  350. package/dist/json/query.js.map +1 -0
  351. package/dist/license/hito4_client.d.ts +19 -0
  352. package/dist/license/hito4_client.d.ts.map +1 -1
  353. package/dist/license/hito4_client.js +110 -0
  354. package/dist/license/hito4_client.js.map +1 -1
  355. package/dist/license/index.d.ts.map +1 -1
  356. package/dist/license/index.js +7 -0
  357. package/dist/license/index.js.map +1 -1
  358. package/dist/license/sync.d.ts +54 -0
  359. package/dist/license/sync.d.ts.map +1 -0
  360. package/dist/license/sync.js +138 -0
  361. package/dist/license/sync.js.map +1 -0
  362. package/dist/llm/cohere_client.d.ts +81 -0
  363. package/dist/llm/cohere_client.d.ts.map +1 -0
  364. package/dist/llm/cohere_client.js +195 -0
  365. package/dist/llm/cohere_client.js.map +1 -0
  366. package/dist/llm/deepseek_client.d.ts +63 -0
  367. package/dist/llm/deepseek_client.d.ts.map +1 -0
  368. package/dist/llm/deepseek_client.js +188 -0
  369. package/dist/llm/deepseek_client.js.map +1 -0
  370. package/dist/llm/gemini_client.d.ts +78 -0
  371. package/dist/llm/gemini_client.d.ts.map +1 -0
  372. package/dist/llm/gemini_client.js +189 -0
  373. package/dist/llm/gemini_client.js.map +1 -0
  374. package/dist/llm/managed_client.d.ts +70 -0
  375. package/dist/llm/managed_client.d.ts.map +1 -0
  376. package/dist/llm/managed_client.js +251 -0
  377. package/dist/llm/managed_client.js.map +1 -0
  378. package/dist/llm/mistral_client.d.ts +54 -0
  379. package/dist/llm/mistral_client.d.ts.map +1 -0
  380. package/dist/llm/mistral_client.js +174 -0
  381. package/dist/llm/mistral_client.js.map +1 -0
  382. package/dist/llm/multi_provider_client.d.ts +57 -0
  383. package/dist/llm/multi_provider_client.d.ts.map +1 -0
  384. package/dist/llm/multi_provider_client.js +109 -0
  385. package/dist/llm/multi_provider_client.js.map +1 -0
  386. package/dist/llm/openai_client.d.ts +77 -0
  387. package/dist/llm/openai_client.d.ts.map +1 -0
  388. package/dist/llm/openai_client.js +200 -0
  389. package/dist/llm/openai_client.js.map +1 -0
  390. package/dist/llm/xai_client.d.ts +51 -0
  391. package/dist/llm/xai_client.d.ts.map +1 -0
  392. package/dist/llm/xai_client.js +174 -0
  393. package/dist/llm/xai_client.js.map +1 -0
  394. package/dist/mcp/bridge_registry.d.ts +77 -0
  395. package/dist/mcp/bridge_registry.d.ts.map +1 -0
  396. package/dist/mcp/bridge_registry.js +220 -0
  397. package/dist/mcp/bridge_registry.js.map +1 -0
  398. package/dist/mcp/config.d.ts +25 -0
  399. package/dist/mcp/config.d.ts.map +1 -0
  400. package/dist/mcp/config.js +116 -0
  401. package/dist/mcp/config.js.map +1 -0
  402. package/dist/mcp/protocol_client.d.ts +63 -0
  403. package/dist/mcp/protocol_client.d.ts.map +1 -0
  404. package/dist/mcp/protocol_client.js +340 -0
  405. package/dist/mcp/protocol_client.js.map +1 -0
  406. package/dist/mcp/state.d.ts +38 -0
  407. package/dist/mcp/state.d.ts.map +1 -0
  408. package/dist/mcp/state.js +144 -0
  409. package/dist/mcp/state.js.map +1 -0
  410. package/dist/migrate/ai-decorator.d.ts.map +1 -1
  411. package/dist/migrate/ai-decorator.js +33 -145
  412. package/dist/migrate/ai-decorator.js.map +1 -1
  413. package/dist/nac3/approval_queue.d.ts +36 -0
  414. package/dist/nac3/approval_queue.d.ts.map +1 -0
  415. package/dist/nac3/approval_queue.js +105 -0
  416. package/dist/nac3/approval_queue.js.map +1 -0
  417. package/dist/nac3/backend_tools.d.ts +89 -0
  418. package/dist/nac3/backend_tools.d.ts.map +1 -0
  419. package/dist/nac3/backend_tools.js +271 -0
  420. package/dist/nac3/backend_tools.js.map +1 -0
  421. package/dist/nac3/dispatch_log.d.ts +35 -0
  422. package/dist/nac3/dispatch_log.d.ts.map +1 -0
  423. package/dist/nac3/dispatch_log.js +126 -0
  424. package/dist/nac3/dispatch_log.js.map +1 -0
  425. package/dist/nac3/internal_manifest.d.ts +62 -0
  426. package/dist/nac3/internal_manifest.d.ts.map +1 -0
  427. package/dist/nac3/internal_manifest.js +1846 -0
  428. package/dist/nac3/internal_manifest.js.map +1 -0
  429. package/dist/nac3/manifest_lazy.d.ts +71 -0
  430. package/dist/nac3/manifest_lazy.d.ts.map +1 -0
  431. package/dist/nac3/manifest_lazy.js +141 -0
  432. package/dist/nac3/manifest_lazy.js.map +1 -0
  433. package/dist/nac3/verb_tier_map.d.ts +80 -0
  434. package/dist/nac3/verb_tier_map.d.ts.map +1 -0
  435. package/dist/nac3/verb_tier_map.js +159 -0
  436. package/dist/nac3/verb_tier_map.js.map +1 -0
  437. package/dist/office/excel.d.ts +110 -0
  438. package/dist/office/excel.d.ts.map +1 -0
  439. package/dist/office/excel.js +276 -0
  440. package/dist/office/excel.js.map +1 -0
  441. package/dist/office/pdf.d.ts +35 -0
  442. package/dist/office/pdf.d.ts.map +1 -0
  443. package/dist/office/pdf.js +70 -0
  444. package/dist/office/pdf.js.map +1 -0
  445. package/dist/office/word.d.ts +64 -0
  446. package/dist/office/word.d.ts.map +1 -0
  447. package/dist/office/word.js +243 -0
  448. package/dist/office/word.js.map +1 -0
  449. package/dist/qa/brain_matrix/ab_runner.d.ts +44 -0
  450. package/dist/qa/brain_matrix/ab_runner.d.ts.map +1 -0
  451. package/dist/qa/brain_matrix/ab_runner.js +144 -0
  452. package/dist/qa/brain_matrix/ab_runner.js.map +1 -0
  453. package/dist/qa/brain_matrix/brains.json +80 -0
  454. package/dist/qa/brain_matrix/compare.d.ts +27 -0
  455. package/dist/qa/brain_matrix/compare.d.ts.map +1 -0
  456. package/dist/qa/brain_matrix/compare.js +122 -0
  457. package/dist/qa/brain_matrix/compare.js.map +1 -0
  458. package/dist/qa/brain_matrix/fake_brain.d.ts +36 -0
  459. package/dist/qa/brain_matrix/fake_brain.d.ts.map +1 -0
  460. package/dist/qa/brain_matrix/fake_brain.js +27 -0
  461. package/dist/qa/brain_matrix/fake_brain.js.map +1 -0
  462. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_intent.json +22 -0
  463. package/dist/qa/brain_matrix/fixtures/scenario_a11y_announce_no_speak_default.json +23 -0
  464. package/dist/qa/brain_matrix/fixtures/scenario_a11y_consecutive_announces.json +37 -0
  465. package/dist/qa/brain_matrix/fixtures/scenario_a11y_focus_after_action.json +22 -0
  466. package/dist/qa/brain_matrix/fixtures/scenario_a11y_label_with_shortcut.json +22 -0
  467. package/dist/qa/brain_matrix/fixtures/scenario_announce_min_tool_calls.json +23 -0
  468. package/dist/qa/brain_matrix/fixtures/scenario_app_invoke_happy_path.json +65 -0
  469. package/dist/qa/brain_matrix/fixtures/scenario_app_no_invent_without_backend.json +18 -0
  470. package/dist/qa/brain_matrix/fixtures/scenario_app_schema_fail_recover.json +48 -0
  471. package/dist/qa/brain_matrix/fixtures/scenario_approval_modal_no_redundancy.json +21 -0
  472. package/dist/qa/brain_matrix/fixtures/scenario_args_redacted_in_audit.json +17 -0
  473. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent.json +19 -0
  474. package/dist/qa/brain_matrix/fixtures/scenario_audit_consumers_intent_en.json +19 -0
  475. package/dist/qa/brain_matrix/fixtures/scenario_audit_log_on_destructive.json +18 -0
  476. package/dist/qa/brain_matrix/fixtures/scenario_brain_explains_after_invoke.json +28 -0
  477. package/dist/qa/brain_matrix/fixtures/scenario_byok_on_managed_brain_overflow.json +28 -0
  478. package/dist/qa/brain_matrix/fixtures/scenario_byok_required_policy.json +35 -0
  479. package/dist/qa/brain_matrix/fixtures/scenario_concise_no_loop.json +23 -0
  480. package/dist/qa/brain_matrix/fixtures/scenario_consult_nac_spec_intent.json +19 -0
  481. package/dist/qa/brain_matrix/fixtures/scenario_contradiction_rfp_cost.json +38 -0
  482. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_attachment_frontier.json +24 -0
  483. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_escalation_explicit.json +23 -0
  484. package/dist/qa/brain_matrix/fixtures/scenario_cost_router_idle_reset.json +24 -0
  485. package/dist/qa/brain_matrix/fixtures/scenario_csv_via_excel_read.json +22 -0
  486. package/dist/qa/brain_matrix/fixtures/scenario_destructive_no_text_confirm.json +20 -0
  487. package/dist/qa/brain_matrix/fixtures/scenario_diff_explains_changes.json +32 -0
  488. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_after_unknown_intent.json +17 -0
  489. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_a11y.json +24 -0
  490. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_agent_orchestrator.json +24 -0
  491. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_byok_vs_managed.json +24 -0
  492. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_cost_router.json +24 -0
  493. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_g_doc.json +24 -0
  494. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_gates.json +23 -0
  495. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_intent_en.json +19 -0
  496. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_lessons_workflow.json +24 -0
  497. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_mcp_lifecycle.json +24 -0
  498. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_nac3_attrs.json +24 -0
  499. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_office.json +24 -0
  500. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_pizarron.json +23 -0
  501. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_r8_modal.json +23 -0
  502. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow.json +23 -0
  503. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_workflow_phases.json +24 -0
  504. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_yf_commands.json +24 -0
  505. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_explain_results.json +22 -0
  506. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_safety_refusals.json +22 -0
  507. package/dist/qa/brain_matrix/fixtures/scenario_doctrine_verb_composition.json +22 -0
  508. package/dist/qa/brain_matrix/fixtures/scenario_eco_defers_complex.json +17 -0
  509. package/dist/qa/brain_matrix/fixtures/scenario_eco_short_query.json +27 -0
  510. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent.json +20 -0
  511. package/dist/qa/brain_matrix/fixtures/scenario_env_list_intent_en.json +20 -0
  512. package/dist/qa/brain_matrix/fixtures/scenario_env_no_secret_leak.json +21 -0
  513. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression.json +35 -0
  514. package/dist/qa/brain_matrix/fixtures/scenario_env_secret_suppression_en.json +21 -0
  515. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_handles_csv_refusal.json +28 -0
  516. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent.json +20 -0
  517. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_sheet_intent_en.json +20 -0
  518. package/dist/qa/brain_matrix/fixtures/scenario_excel_append_then_list.json +34 -0
  519. package/dist/qa/brain_matrix/fixtures/scenario_excel_list_sheets_first.json +22 -0
  520. package/dist/qa/brain_matrix/fixtures/scenario_excel_sheet_named.json +23 -0
  521. package/dist/qa/brain_matrix/fixtures/scenario_explain_voice_yes.json +22 -0
  522. package/dist/qa/brain_matrix/fixtures/scenario_explains_forge_error.json +39 -0
  523. package/dist/qa/brain_matrix/fixtures/scenario_focus_after_modal_open.json +29 -0
  524. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent.json +21 -0
  525. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_intent_en.json +20 -0
  526. package/dist/qa/brain_matrix/fixtures/scenario_fs_find_with_glob.json +22 -0
  527. package/dist/qa/brain_matrix/fixtures/scenario_fs_mkdir_intent.json +20 -0
  528. package/dist/qa/brain_matrix/fixtures/scenario_fs_move_intent.json +20 -0
  529. package/dist/qa/brain_matrix/fixtures/scenario_fs_read_handles_missing.json +28 -0
  530. package/dist/qa/brain_matrix/fixtures/scenario_fs_stat_before_read.json +22 -0
  531. package/dist/qa/brain_matrix/fixtures/scenario_generated_app_nac3_default.json +24 -0
  532. package/dist/qa/brain_matrix/fixtures/scenario_git_branch_list_intent.json +20 -0
  533. package/dist/qa/brain_matrix/fixtures/scenario_git_diff_intent.json +20 -0
  534. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent.json +20 -0
  535. package/dist/qa/brain_matrix/fixtures/scenario_git_log_intent_en.json +20 -0
  536. package/dist/qa/brain_matrix/fixtures/scenario_git_pull_intent.json +19 -0
  537. package/dist/qa/brain_matrix/fixtures/scenario_git_push_intent.json +20 -0
  538. package/dist/qa/brain_matrix/fixtures/scenario_git_show_metadata_only.json +22 -0
  539. package/dist/qa/brain_matrix/fixtures/scenario_git_status_branch_combo.json +44 -0
  540. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent.json +20 -0
  541. package/dist/qa/brain_matrix/fixtures/scenario_git_status_intent_en.json +20 -0
  542. package/dist/qa/brain_matrix/fixtures/scenario_github_clone_repo_intent.json +20 -0
  543. package/dist/qa/brain_matrix/fixtures/scenario_github_create_repo_intent.json +20 -0
  544. package/dist/qa/brain_matrix/fixtures/scenario_id_format_in_reply.json +27 -0
  545. package/dist/qa/brain_matrix/fixtures/scenario_iterations_idempotent_adenda.json +27 -0
  546. package/dist/qa/brain_matrix/fixtures/scenario_iterations_query_history.json +29 -0
  547. package/dist/qa/brain_matrix/fixtures/scenario_iterations_tracker_acknowledge.json +28 -0
  548. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_handles_malformed.json +34 -0
  549. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent.json +30 -0
  550. package/dist/qa/brain_matrix/fixtures/scenario_json_parse_intent_en.json +30 -0
  551. package/dist/qa/brain_matrix/fixtures/scenario_json_query_extract.json +23 -0
  552. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent.json +20 -0
  553. package/dist/qa/brain_matrix/fixtures/scenario_json_stringify_intent_en.json +20 -0
  554. package/dist/qa/brain_matrix/fixtures/scenario_keys_set_intent.json +20 -0
  555. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent.json +20 -0
  556. package/dist/qa/brain_matrix/fixtures/scenario_keys_status_intent_en.json +20 -0
  557. package/dist/qa/brain_matrix/fixtures/scenario_lazy_complex_verb.json +27 -0
  558. package/dist/qa/brain_matrix/fixtures/scenario_lazy_doctrine_only_when_needed.json +17 -0
  559. package/dist/qa/brain_matrix/fixtures/scenario_lazy_simple_verb.json +21 -0
  560. package/dist/qa/brain_matrix/fixtures/scenario_lesson_recall_overrides.json +22 -0
  561. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_restart_app_intent.json +19 -0
  562. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent.json +19 -0
  563. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_run_app_intent_en.json +19 -0
  564. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent.json +20 -0
  565. package/dist/qa/brain_matrix/fixtures/scenario_lifecycle_stop_app_intent_en.json +20 -0
  566. package/dist/qa/brain_matrix/fixtures/scenario_long_doctrine_no_truncate.json +23 -0
  567. package/dist/qa/brain_matrix/fixtures/scenario_manifest_read_intent.json +19 -0
  568. package/dist/qa/brain_matrix/fixtures/scenario_manual_open_intent.json +19 -0
  569. package/dist/qa/brain_matrix/fixtures/scenario_mcp_bridge_unreachable_graceful.json +39 -0
  570. package/dist/qa/brain_matrix/fixtures/scenario_mcp_disabled_bridge_no_verbs.json +18 -0
  571. package/dist/qa/brain_matrix/fixtures/scenario_mcp_discover_tools_intent.json +19 -0
  572. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invariant_1_no_verbs.json +19 -0
  573. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_two_hop.json +68 -0
  574. package/dist/qa/brain_matrix/fixtures/scenario_mcp_invoke_with_auth_loaded.json +76 -0
  575. package/dist/qa/brain_matrix/fixtures/scenario_mcp_revoked_token_graceful.json +33 -0
  576. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_intent.json +21 -0
  577. package/dist/qa/brain_matrix/fixtures/scenario_mcp_set_creds_no_token_arg.json +27 -0
  578. package/dist/qa/brain_matrix/fixtures/scenario_mcp_show_tools_before_invoke.json +44 -0
  579. package/dist/qa/brain_matrix/fixtures/scenario_mcp_toggle_intent.json +20 -0
  580. package/dist/qa/brain_matrix/fixtures/scenario_multi_turn_clarify_then_act.json +24 -0
  581. package/dist/qa/brain_matrix/fixtures/scenario_nac3_attrs_doctrine.json +53 -0
  582. package/dist/qa/brain_matrix/fixtures/scenario_nac3_discover_schemas_intent.json +19 -0
  583. package/dist/qa/brain_matrix/fixtures/scenario_nac3_required_attr_missing.json +19 -0
  584. package/dist/qa/brain_matrix/fixtures/scenario_no_bare_ok_after_destructive.json +27 -0
  585. package/dist/qa/brain_matrix/fixtures/scenario_no_global_learnings_no_recall.json +20 -0
  586. package/dist/qa/brain_matrix/fixtures/scenario_no_id_leak_in_reply.json +24 -0
  587. package/dist/qa/brain_matrix/fixtures/scenario_no_invent_verb.json +18 -0
  588. package/dist/qa/brain_matrix/fixtures/scenario_no_loop_after_repeated_fail.json +42 -0
  589. package/dist/qa/brain_matrix/fixtures/scenario_no_password_echo.json +28 -0
  590. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_all_current.json +28 -0
  591. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent.json +20 -0
  592. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_intent_en.json +20 -0
  593. package/dist/qa/brain_matrix/fixtures/scenario_npm_outdated_then_explain.json +35 -0
  594. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_read_intent.json +24 -0
  595. package/dist/qa/brain_matrix/fixtures/scenario_office_excel_write_required_args.json +23 -0
  596. package/dist/qa/brain_matrix/fixtures/scenario_office_overwrite_explicit.json +23 -0
  597. package/dist/qa/brain_matrix/fixtures/scenario_office_word_write_intent.json +27 -0
  598. package/dist/qa/brain_matrix/fixtures/scenario_panel_open_settings_intent.json +19 -0
  599. package/dist/qa/brain_matrix/fixtures/scenario_panel_send_message_intent.json +19 -0
  600. package/dist/qa/brain_matrix/fixtures/scenario_pdf_read_intent.json +22 -0
  601. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_clear_tab_explicit_close.json +17 -0
  602. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_chart.json +30 -0
  603. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_for_long_table.json +28 -0
  604. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_read_tab_intent.json +20 -0
  605. package/dist/qa/brain_matrix/fixtures/scenario_pizarron_render_not_inline.json +20 -0
  606. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_read_file.json +28 -0
  607. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_verb_over_shell.json +22 -0
  608. package/dist/qa/brain_matrix/fixtures/scenario_prefer_native_workflow_state.json +28 -0
  609. package/dist/qa/brain_matrix/fixtures/scenario_project_init_intent.json +20 -0
  610. package/dist/qa/brain_matrix/fixtures/scenario_project_set_root_intent.json +20 -0
  611. package/dist/qa/brain_matrix/fixtures/scenario_promote_lesson_after_correction.json +17 -0
  612. package/dist/qa/brain_matrix/fixtures/scenario_r8_destructive_shell_exec.json +21 -0
  613. package/dist/qa/brain_matrix/fixtures/scenario_read_then_parse_order.json +36 -0
  614. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_jump_intent.json +19 -0
  615. package/dist/qa/brain_matrix/fixtures/scenario_reader_bookmark_set_intent.json +19 -0
  616. package/dist/qa/brain_matrix/fixtures/scenario_reader_for_long_doc.json +21 -0
  617. package/dist/qa/brain_matrix/fixtures/scenario_reader_list_docs_intent.json +19 -0
  618. package/dist/qa/brain_matrix/fixtures/scenario_reader_next_block_intent.json +19 -0
  619. package/dist/qa/brain_matrix/fixtures/scenario_reader_read_section_intent.json +19 -0
  620. package/dist/qa/brain_matrix/fixtures/scenario_reader_recap_intent.json +19 -0
  621. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent.json +20 -0
  622. package/dist/qa/brain_matrix/fixtures/scenario_reader_search_intent_en.json +20 -0
  623. package/dist/qa/brain_matrix/fixtures/scenario_refuses_blanket_chmod_777.json +17 -0
  624. package/dist/qa/brain_matrix/fixtures/scenario_refuses_bypass_approval_modal.json +18 -0
  625. package/dist/qa/brain_matrix/fixtures/scenario_refuses_delete_critical_en.json +18 -0
  626. package/dist/qa/brain_matrix/fixtures/scenario_refuses_disable_vault_encryption.json +18 -0
  627. package/dist/qa/brain_matrix/fixtures/scenario_refuses_drop_database.json +17 -0
  628. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main.json +17 -0
  629. package/dist/qa/brain_matrix/fixtures/scenario_refuses_force_push_main_en.json +17 -0
  630. package/dist/qa/brain_matrix/fixtures/scenario_refuses_leak_vault_en.json +18 -0
  631. package/dist/qa/brain_matrix/fixtures/scenario_refuses_modify_node_modules.json +17 -0
  632. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks.json +17 -0
  633. package/dist/qa/brain_matrix/fixtures/scenario_refuses_skip_hooks_en.json +17 -0
  634. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_delete_critical.json +18 -0
  635. package/dist/qa/brain_matrix/fixtures/scenario_refuses_to_leak_vault.json +18 -0
  636. package/dist/qa/brain_matrix/fixtures/scenario_respects_global_learnings.json +28 -0
  637. package/dist/qa/brain_matrix/fixtures/scenario_respects_workflow_gate_g2.json +39 -0
  638. package/dist/qa/brain_matrix/fixtures/scenario_revoke_lesson_request.json +21 -0
  639. package/dist/qa/brain_matrix/fixtures/scenario_sq_rules_active.json +30 -0
  640. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent.json +20 -0
  641. package/dist/qa/brain_matrix/fixtures/scenario_text_diff_intent_en.json +20 -0
  642. package/dist/qa/brain_matrix/fixtures/scenario_truncated_response_retry.json +22 -0
  643. package/dist/qa/brain_matrix/fixtures/scenario_unknown_command_clarify.json +23 -0
  644. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_compose.json +23 -0
  645. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_handles_invalid.json +27 -0
  646. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent.json +20 -0
  647. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_intent_en.json +20 -0
  648. package/dist/qa/brain_matrix/fixtures/scenario_url_parse_then_inspect_query.json +28 -0
  649. package/dist/qa/brain_matrix/fixtures/scenario_url_then_stringify_order.json +34 -0
  650. package/dist/qa/brain_matrix/fixtures/scenario_user_just_greets.json +17 -0
  651. package/dist/qa/brain_matrix/fixtures/scenario_user_overrides_proceeds.json +24 -0
  652. package/dist/qa/brain_matrix/fixtures/scenario_user_revokes_in_middle.json +22 -0
  653. package/dist/qa/brain_matrix/fixtures/scenario_voice_open_pizarron.json +21 -0
  654. package/dist/qa/brain_matrix/fixtures/scenario_word_outline_extraction.json +22 -0
  655. package/dist/qa/brain_matrix/fixtures/scenario_word_overwrite_explicit.json +20 -0
  656. package/dist/qa/brain_matrix/fixtures/scenario_word_section_count.json +28 -0
  657. package/dist/qa/brain_matrix/fixtures/scenario_workflow_doctrine.json +53 -0
  658. package/dist/qa/brain_matrix/fixtures/scenario_workflow_done_specs.json +32 -0
  659. package/dist/qa/brain_matrix/fixtures/scenario_workflow_intent_capture.json +22 -0
  660. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_jump_block.json +26 -0
  661. package/dist/qa/brain_matrix/fixtures/scenario_workflow_phase_v_step_15.json +41 -0
  662. package/dist/qa/brain_matrix/fixtures/scenario_workflow_run_step_intent.json +19 -0
  663. package/dist/qa/brain_matrix/fixtures/scenario_workflow_set_intent.json +20 -0
  664. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_injection.json +32 -0
  665. package/dist/qa/brain_matrix/fixtures/scenario_workflow_state_recovers_after_clarify.json +25 -0
  666. package/dist/qa/brain_matrix/fixtures/scenario_workflow_step_1_intake.json +24 -0
  667. package/dist/qa/brain_matrix/fixtures/scenario_yf_command_doctrine.json +56 -0
  668. package/dist/qa/brain_matrix/fixtures/scenario_yf_doctrine_list_intent.json +19 -0
  669. package/dist/qa/brain_matrix/fixtures/scenario_yf_qa_compare_intent.json +17 -0
  670. package/dist/qa/brain_matrix/invariants.d.ts +18 -0
  671. package/dist/qa/brain_matrix/invariants.d.ts.map +1 -0
  672. package/dist/qa/brain_matrix/invariants.js +333 -0
  673. package/dist/qa/brain_matrix/invariants.js.map +1 -0
  674. package/dist/qa/brain_matrix/report.d.ts +12 -0
  675. package/dist/qa/brain_matrix/report.d.ts.map +1 -0
  676. package/dist/qa/brain_matrix/report.js +131 -0
  677. package/dist/qa/brain_matrix/report.js.map +1 -0
  678. package/dist/qa/brain_matrix/runner.d.ts +31 -0
  679. package/dist/qa/brain_matrix/runner.d.ts.map +1 -0
  680. package/dist/qa/brain_matrix/runner.js +561 -0
  681. package/dist/qa/brain_matrix/runner.js.map +1 -0
  682. package/dist/qa/brain_matrix/types.d.ts +180 -0
  683. package/dist/qa/brain_matrix/types.d.ts.map +1 -0
  684. package/dist/qa/brain_matrix/types.js +2 -0
  685. package/dist/qa/brain_matrix/types.js.map +1 -0
  686. package/dist/qa/brain_matrix/validate_scenario.d.ts +23 -0
  687. package/dist/qa/brain_matrix/validate_scenario.d.ts.map +1 -0
  688. package/dist/qa/brain_matrix/validate_scenario.js +128 -0
  689. package/dist/qa/brain_matrix/validate_scenario.js.map +1 -0
  690. package/dist/support/github_dispatcher.d.ts +36 -0
  691. package/dist/support/github_dispatcher.d.ts.map +1 -0
  692. package/dist/support/github_dispatcher.js +292 -0
  693. package/dist/support/github_dispatcher.js.map +1 -0
  694. package/dist/support/reports.d.ts +31 -0
  695. package/dist/support/reports.d.ts.map +1 -0
  696. package/dist/support/reports.js +162 -0
  697. package/dist/support/reports.js.map +1 -0
  698. package/dist/telemetry/usage.d.ts +67 -0
  699. package/dist/telemetry/usage.d.ts.map +1 -0
  700. package/dist/telemetry/usage.js +208 -0
  701. package/dist/telemetry/usage.js.map +1 -0
  702. package/dist/version.d.ts +1 -1
  703. package/dist/version.d.ts.map +1 -1
  704. package/dist/version.js +1 -1
  705. package/dist/version.js.map +1 -1
  706. package/dist/voice/config.d.ts +12 -0
  707. package/dist/voice/config.d.ts.map +1 -1
  708. package/dist/voice/config.js +25 -2
  709. package/dist/voice/config.js.map +1 -1
  710. package/dist/voice/providers/google.d.ts +9 -0
  711. package/dist/voice/providers/google.d.ts.map +1 -1
  712. package/dist/voice/providers/google.js +197 -28
  713. package/dist/voice/providers/google.js.map +1 -1
  714. package/dist/voice/router.d.ts +10 -0
  715. package/dist/voice/router.d.ts.map +1 -1
  716. package/dist/voice/router.js +39 -20
  717. package/dist/voice/router.js.map +1 -1
  718. package/dist/voice/types.d.ts +5 -2
  719. package/dist/voice/types.d.ts.map +1 -1
  720. package/dist/voice/types.js.map +1 -1
  721. package/dist/workflow/phase_inference.d.ts +56 -0
  722. package/dist/workflow/phase_inference.d.ts.map +1 -0
  723. package/dist/workflow/phase_inference.js +107 -0
  724. package/dist/workflow/phase_inference.js.map +1 -0
  725. package/dist/workflow/state.d.ts +238 -0
  726. package/dist/workflow/state.d.ts.map +1 -0
  727. package/dist/workflow/state.js +213 -0
  728. package/dist/workflow/state.js.map +1 -0
  729. package/docs/SQ.md +1397 -0
  730. package/docs/SQ_BY_STEP.yaml +147 -0
  731. package/docs/doctrine/accessibility.md +78 -0
  732. package/docs/doctrine/agent-orchestrator.md +76 -0
  733. package/docs/doctrine/byok-vs-managed.md +81 -0
  734. package/docs/doctrine/cost-router-escalation.md +73 -0
  735. package/docs/doctrine/explain-results.md +90 -0
  736. package/docs/doctrine/g-doc.md +46 -0
  737. package/docs/doctrine/gates.md +21 -0
  738. package/docs/doctrine/lessons-workflow.md +68 -0
  739. package/docs/doctrine/mcp-bridge-lifecycle.md +75 -0
  740. package/docs/doctrine/nac3-attrs.md +23 -0
  741. package/docs/doctrine/office-tools.md +102 -0
  742. package/docs/doctrine/pizarron.md +52 -0
  743. package/docs/doctrine/r8-modal.md +60 -0
  744. package/docs/doctrine/safety-refusals.md +73 -0
  745. package/docs/doctrine/verb-composition.md +68 -0
  746. package/docs/doctrine/workflow-phases.md +108 -0
  747. package/docs/doctrine/workflow.md +58 -0
  748. package/docs/doctrine/yf-commands.md +49 -0
  749. package/package.json +20 -14
  750. package/src/i18n/catalogs/ar.json +55 -10
  751. package/src/i18n/catalogs/de.json +55 -10
  752. package/src/i18n/catalogs/en.json +66 -1
  753. package/src/i18n/catalogs/es.json +66 -1
  754. package/src/i18n/catalogs/fr.json +55 -10
  755. package/src/i18n/catalogs/hi.json +55 -10
  756. package/src/i18n/catalogs/it.json +55 -10
  757. package/src/i18n/catalogs/ja.json +55 -10
  758. package/src/i18n/catalogs/pt.json +55 -10
  759. package/src/i18n/catalogs/zh.json +55 -10
  760. package/templates/nextjs-app/README.md +48 -0
  761. package/templates/nextjs-app/next.config.js +8 -0
  762. package/templates/nextjs-app/package.json +33 -0
  763. package/templates/nextjs-app/src/app/globals.css +43 -0
  764. package/templates/nextjs-app/src/app/layout.tsx +29 -0
  765. package/templates/nextjs-app/src/app/page.tsx +63 -0
  766. package/templates/nextjs-app/src/nac/manifest.ts +36 -0
  767. package/templates/nextjs-app/tsconfig.json +21 -0
  768. package/templates/nextjs-app/yujin.forge.json +11 -0
@@ -0,0 +1,72 @@
1
+ /**
2
+ * reasoning_gate.ts -- pre-LLM tier classifier (alpha.55).
3
+ *
4
+ * Cheap, deterministic features computed without an LLM call.
5
+ * Returns a tier suggestion + confidence + signal list. When
6
+ * confidence > 0.85 the cost_router uses the result directly
7
+ * and skips the Gemini turn_classifier (saves ~400 ms + tokens).
8
+ * When confidence <= 0.85 the gate's verdict is "ambiguous" and
9
+ * the router asks turn_classifier for a second opinion.
10
+ *
11
+ * Signals scanned:
12
+ * - Message length (long prompts skew toward frontier reasoning).
13
+ * - Frontier keywords (design, architecture, implement,
14
+ * refactor, code, write a function, etc -- multilingual).
15
+ * - Eco keywords (open, show, list, abrime, muestrame -- short
16
+ * NAC3-shaped commands).
17
+ * - Verb hints recognised in the manifest (e.g. references to
18
+ * pizarron/lector/voz/idioma map to eco).
19
+ * - Attachment presence (frontier bias).
20
+ * - Prior tier in the conversation history (sticky tier when
21
+ * "continua / sigue" is the explicit follow-up).
22
+ *
23
+ * All keyword lists are normalised to lowercase + accent-stripped.
24
+ * Multi-language (es / en) since the user types in both.
25
+ *
26
+ * ASCII-only.
27
+ */
28
+ import type { BrainTier } from '../nac3/verb_tier_map.js';
29
+ export interface GateInput {
30
+ /** The new user message text. */
31
+ text: string;
32
+ /** How many attachments (files, voice notes, screenshots) came
33
+ * with the turn. */
34
+ attachments?: number;
35
+ /** Up to ~3 recent turns to detect follow-ups ("sigue", "y ahora"). */
36
+ history?: Array<{
37
+ role: 'user' | 'assistant';
38
+ content: string;
39
+ }>;
40
+ /** Tier the previous turn ran on, when known. Used for sticky
41
+ * follow-ups. */
42
+ previous_tier?: 'eco' | 'frontier';
43
+ }
44
+ export interface GateDecision {
45
+ /** Recommended tier when confidence is high. */
46
+ tier: 'eco' | 'frontier';
47
+ /** Confidence 0..1. > 0.85 means the router skips classifier. */
48
+ confidence: number;
49
+ /** Whether the router should escalate to turn_classifier. */
50
+ ambiguous: boolean;
51
+ /** Human-readable signals fired. Goes to brain_routing.jsonl. */
52
+ signals: string[];
53
+ }
54
+ /**
55
+ * Score the input and decide tier + confidence.
56
+ *
57
+ * Algorithm:
58
+ * 1. If a sticky follow-up phrase + previous_tier known ->
59
+ * inherit previous tier with confidence 0.95.
60
+ * 2. Otherwise sum keyword hits. Each hit weighs 0.18 toward
61
+ * its bucket.
62
+ * 3. Long messages (>= 200 chars) add 0.20 to frontier.
63
+ * Very short (< 24 chars) add 0.10 to eco.
64
+ * 4. Each attachment adds 0.20 to frontier.
65
+ * 5. Tier = bucket with higher absolute score. Confidence =
66
+ * min(0.99, |frontier - eco| + base 0.40).
67
+ * 6. If both buckets are < 0.20 (no strong signals)
68
+ * confidence drops to 0.30 -> ambiguous.
69
+ */
70
+ export declare function classifyGate(input: GateInput): GateDecision;
71
+ export type { BrainTier };
72
+ //# sourceMappingURL=reasoning_gate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reasoning_gate.d.ts","sourceRoot":"","sources":["../../src/core/reasoning_gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb;yBACqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE;sBACkB;IAClB,aAAa,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAsDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAyG3D;AAID,YAAY,EAAE,SAAS,EAAE,CAAC"}
@@ -0,0 +1,192 @@
1
+ /**
2
+ * reasoning_gate.ts -- pre-LLM tier classifier (alpha.55).
3
+ *
4
+ * Cheap, deterministic features computed without an LLM call.
5
+ * Returns a tier suggestion + confidence + signal list. When
6
+ * confidence > 0.85 the cost_router uses the result directly
7
+ * and skips the Gemini turn_classifier (saves ~400 ms + tokens).
8
+ * When confidence <= 0.85 the gate's verdict is "ambiguous" and
9
+ * the router asks turn_classifier for a second opinion.
10
+ *
11
+ * Signals scanned:
12
+ * - Message length (long prompts skew toward frontier reasoning).
13
+ * - Frontier keywords (design, architecture, implement,
14
+ * refactor, code, write a function, etc -- multilingual).
15
+ * - Eco keywords (open, show, list, abrime, muestrame -- short
16
+ * NAC3-shaped commands).
17
+ * - Verb hints recognised in the manifest (e.g. references to
18
+ * pizarron/lector/voz/idioma map to eco).
19
+ * - Attachment presence (frontier bias).
20
+ * - Prior tier in the conversation history (sticky tier when
21
+ * "continua / sigue" is the explicit follow-up).
22
+ *
23
+ * All keyword lists are normalised to lowercase + accent-stripped.
24
+ * Multi-language (es / en) since the user types in both.
25
+ *
26
+ * ASCII-only.
27
+ */
28
+ /* Normalisation: lowercase + strip combining marks. ASCII-safe
29
+ * because the regex is plain unicode. */
30
+ function norm(s) {
31
+ return s.normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase();
32
+ }
33
+ /* Keywords that push toward frontier. Multilingual ES/EN. Each
34
+ * match adds +0.18 to frontier score, capped by signal weight
35
+ * in score(). */
36
+ const FRONTIER_KEYWORDS = [
37
+ /* design + architecture */
38
+ 'disena', 'disenar', 'diseno', 'diseno de',
39
+ 'design', 'designing', 'architect', 'architecture',
40
+ 'arquitectura', 'arquitecto',
41
+ /* implementation / code */
42
+ 'implementa', 'implementar', 'implementation',
43
+ 'refactoriza', 'refactor', 'refactoring',
44
+ 'codifica', 'codigo', 'code this', 'write a function',
45
+ 'fix this bug', 'arregla este bug', 'resuelve el problema',
46
+ /* reasoning / planning */
47
+ 'estrategia', 'strategy', 'planifica',
48
+ 'analiza la', 'analiza el', 'analyze',
49
+ /* writing tasks */
50
+ 'redacta', 'escribe un', 'write a draft', 'compose',
51
+ /* multi-step / complex */
52
+ 'paso a paso', 'step by step', 'descompon', 'breakdown',
53
+ ];
54
+ /* Keywords that push toward eco. Short NAC3-shaped commands. */
55
+ const ECO_KEYWORDS = [
56
+ /* navigation / listing */
57
+ 'abrime', 'abre ', 'abrir ', 'open ', 'show me', 'muestrame',
58
+ 'mostrame', 'listame', 'list ', 'lista ',
59
+ /* read / pizarron */
60
+ 'lee la', 'leeme la', 'leeme el', 'lee el',
61
+ 'read this tab', 'leer pestania',
62
+ /* simple ops */
63
+ 'cierra', 'close ',
64
+ 'cambia el idioma', 'cambiar idioma', 'change language',
65
+ 'activar voz', 'apaga voz', 'desactiva voz',
66
+ /* short greetings stay eco */
67
+ 'hola', 'hello', 'hi ', 'thanks', 'gracias',
68
+ /* NAC3 verbs reference */
69
+ 'pizarron', 'lector', 'reader', 'microphone',
70
+ ];
71
+ /* Phrases that mean "sigue lo anterior" -- inherit previous tier. */
72
+ const STICKY_FOLLOWUPS = [
73
+ 'sigue', 'continua', 'continuar', 'continue', 'go on',
74
+ 'y ahora', 'y despues', 'and now', 'next step',
75
+ ];
76
+ /**
77
+ * Score the input and decide tier + confidence.
78
+ *
79
+ * Algorithm:
80
+ * 1. If a sticky follow-up phrase + previous_tier known ->
81
+ * inherit previous tier with confidence 0.95.
82
+ * 2. Otherwise sum keyword hits. Each hit weighs 0.18 toward
83
+ * its bucket.
84
+ * 3. Long messages (>= 200 chars) add 0.20 to frontier.
85
+ * Very short (< 24 chars) add 0.10 to eco.
86
+ * 4. Each attachment adds 0.20 to frontier.
87
+ * 5. Tier = bucket with higher absolute score. Confidence =
88
+ * min(0.99, |frontier - eco| + base 0.40).
89
+ * 6. If both buckets are < 0.20 (no strong signals)
90
+ * confidence drops to 0.30 -> ambiguous.
91
+ */
92
+ export function classifyGate(input) {
93
+ const signals = [];
94
+ const text = typeof input.text === 'string' ? input.text : '';
95
+ const n = norm(text);
96
+ /* 1. sticky follow-up (explicit "sigue / continua" phrases) */
97
+ if (input.previous_tier) {
98
+ for (const phrase of STICKY_FOLLOWUPS) {
99
+ if (n.includes(phrase)) {
100
+ signals.push('sticky_followup[' + phrase + ']->' + input.previous_tier);
101
+ return {
102
+ tier: input.previous_tier,
103
+ confidence: 0.95,
104
+ ambiguous: false,
105
+ signals,
106
+ };
107
+ }
108
+ }
109
+ }
110
+ /* 1b. alpha.56 -- frontier inertia. The expensive case is a
111
+ * user dropping out of a frontier conversation because their
112
+ * follow-up was short ("medium, python playwright", "ok",
113
+ * "yes"). Once you are in a frontier topic you stay there
114
+ * unless the new message has a strong eco signal. We compute
115
+ * eco signals first to gate the inertia.
116
+ *
117
+ * This intentionally runs BEFORE the regular keyword scan so
118
+ * we can short-circuit without computing frontier signals --
119
+ * the eco scan is cheap. */
120
+ if (input.previous_tier === 'frontier') {
121
+ let ecoQuickScore = 0;
122
+ for (const kw of ECO_KEYWORDS) {
123
+ if (n.includes(kw)) {
124
+ ecoQuickScore += 0.25;
125
+ }
126
+ }
127
+ if (ecoQuickScore < 0.30) {
128
+ signals.push('frontier_inertia[prev=frontier, eco_score=' + ecoQuickScore.toFixed(2) + ']');
129
+ return {
130
+ tier: 'frontier',
131
+ confidence: 0.90,
132
+ ambiguous: false,
133
+ signals,
134
+ };
135
+ }
136
+ /* Otherwise fall through -- the user did signal eco intent
137
+ * even within a frontier topic (e.g. "ok abrime esa tab"
138
+ * inside a design session). */
139
+ }
140
+ let ecoScore = 0;
141
+ let frontierScore = 0;
142
+ /* 2. keyword hits */
143
+ for (const kw of ECO_KEYWORDS) {
144
+ if (n.includes(kw)) {
145
+ ecoScore += 0.25;
146
+ signals.push('eco_kw[' + kw.trim() + ']');
147
+ }
148
+ }
149
+ for (const kw of FRONTIER_KEYWORDS) {
150
+ if (n.includes(kw)) {
151
+ frontierScore += 0.25;
152
+ signals.push('frontier_kw[' + kw.trim() + ']');
153
+ }
154
+ }
155
+ /* 3. length */
156
+ if (text.length >= 200) {
157
+ frontierScore += 0.20;
158
+ signals.push('long_prompt[' + text.length + ']');
159
+ }
160
+ else if (text.length < 24 && text.length > 0) {
161
+ ecoScore += 0.10;
162
+ signals.push('short_prompt[' + text.length + ']');
163
+ }
164
+ /* 4. attachments */
165
+ const att = typeof input.attachments === 'number' && input.attachments > 0
166
+ ? input.attachments
167
+ : 0;
168
+ if (att > 0) {
169
+ frontierScore += 0.20 * att;
170
+ signals.push('attachments[' + att + ']');
171
+ }
172
+ /* 5. decide */
173
+ const ecoCapped = Math.min(ecoScore, 1.0);
174
+ const frontierCapped = Math.min(frontierScore, 1.0);
175
+ const tier = frontierCapped > ecoCapped ? 'frontier' : 'eco';
176
+ let confidence = 0.40 + Math.abs(frontierCapped - ecoCapped);
177
+ if (confidence > 0.99)
178
+ confidence = 0.99;
179
+ /* 6. weak signal -> ambiguous */
180
+ const maxScore = Math.max(ecoCapped, frontierCapped);
181
+ let ambiguous;
182
+ if (maxScore < 0.20) {
183
+ confidence = 0.30;
184
+ ambiguous = true;
185
+ signals.push('weak_signals');
186
+ }
187
+ else {
188
+ ambiguous = confidence <= 0.85;
189
+ }
190
+ return { tier, confidence, ambiguous, signals };
191
+ }
192
+ //# sourceMappingURL=reasoning_gate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reasoning_gate.js","sourceRoot":"","sources":["../../src/core/reasoning_gate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ /**
2
+ * shell_classifier.ts -- categorize a shell command into one of
3
+ * four risk buckets (alpha.59d).
4
+ *
5
+ * Buckets:
6
+ * destructive -- modifies / removes user data, force-pushes,
7
+ * etc. Always requires approval.
8
+ * elevation -- sudo / gsudo / runas / su. Always approval.
9
+ * network -- curl/wget/npm-install/etc that touches the
10
+ * network. Pablo's rule: approve always.
11
+ * safe -- ls, cd, pwd, git status, etc. Auto-approves
12
+ * (subject to Danger Zone toggle in limits).
13
+ *
14
+ * The classifier is intentionally CONSERVATIVE: when in doubt it
15
+ * escalates to a higher-risk bucket. False positives cost the
16
+ * user an extra approval prompt; false negatives could execute
17
+ * unwanted changes silently.
18
+ *
19
+ * Pattern matching is regex-based + token-aware. It does NOT
20
+ * try to parse shell grammar perfectly -- it catches the obvious
21
+ * dangerous shapes (rm -rf /, force flags, sudo prefix, network
22
+ * binaries, etc).
23
+ *
24
+ * ASCII-only.
25
+ */
26
+ export type ShellRiskBucket = 'destructive' | 'elevation' | 'network' | 'safe';
27
+ export interface ShellClassification {
28
+ bucket: ShellRiskBucket;
29
+ reasons: string[];
30
+ requires_approval: boolean;
31
+ }
32
+ export declare function classifyShellCommand(command: string): ShellClassification;
33
+ export declare const _patterns: {
34
+ DESTRUCTIVE_TOKENS: readonly {
35
+ pat: RegExp;
36
+ reason: string;
37
+ }[];
38
+ ELEVATION_TOKENS: readonly {
39
+ pat: RegExp;
40
+ reason: string;
41
+ }[];
42
+ NETWORK_TOKENS: readonly {
43
+ pat: RegExp;
44
+ reason: string;
45
+ }[];
46
+ SAFE_TOKENS: readonly RegExp[];
47
+ PIPE_TO_SHELL: RegExp;
48
+ };
49
+ //# sourceMappingURL=shell_classifier.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell_classifier.d.ts","sourceRoot":"","sources":["../../src/core/shell_classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAqFD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAqDzE;AAGD,eAAO,MAAM,SAAS;;aA1IyB,MAAM;gBAAU,MAAM;;;aAmCxB,MAAM;gBAAU,MAAM;;;aAUxB,MAAM;gBAAU,MAAM;;;;CA+FhE,CAAC"}
@@ -0,0 +1,159 @@
1
+ /**
2
+ * shell_classifier.ts -- categorize a shell command into one of
3
+ * four risk buckets (alpha.59d).
4
+ *
5
+ * Buckets:
6
+ * destructive -- modifies / removes user data, force-pushes,
7
+ * etc. Always requires approval.
8
+ * elevation -- sudo / gsudo / runas / su. Always approval.
9
+ * network -- curl/wget/npm-install/etc that touches the
10
+ * network. Pablo's rule: approve always.
11
+ * safe -- ls, cd, pwd, git status, etc. Auto-approves
12
+ * (subject to Danger Zone toggle in limits).
13
+ *
14
+ * The classifier is intentionally CONSERVATIVE: when in doubt it
15
+ * escalates to a higher-risk bucket. False positives cost the
16
+ * user an extra approval prompt; false negatives could execute
17
+ * unwanted changes silently.
18
+ *
19
+ * Pattern matching is regex-based + token-aware. It does NOT
20
+ * try to parse shell grammar perfectly -- it catches the obvious
21
+ * dangerous shapes (rm -rf /, force flags, sudo prefix, network
22
+ * binaries, etc).
23
+ *
24
+ * ASCII-only.
25
+ */
26
+ /* Tokens that mark a destructive intent regardless of shell. */
27
+ const DESTRUCTIVE_TOKENS = [
28
+ /* rm with recursive + force is the canonical "blast radius" command. */
29
+ { pat: /\brm\s+(?:-[a-zA-Z]*r[a-zA-Z]*\s|-[a-zA-Z]*f[a-zA-Z]*\s|--force\s|--recursive\s)/i, reason: 'rm -r/-f' },
30
+ /* Bare rm against a path is still destructive. */
31
+ { pat: /\brm\s+(?!--help|--version)/i, reason: 'rm' },
32
+ { pat: /\brmdir\b/i, reason: 'rmdir' },
33
+ { pat: /\bmv\s+(?!--help)/i, reason: 'mv (could overwrite)' },
34
+ { pat: /\bdd\s+if=/i, reason: 'dd' },
35
+ { pat: /\bshred\b/i, reason: 'shred' },
36
+ { pat: />\s*\/dev\/sd[a-z]/i, reason: 'redirect to raw device' },
37
+ { pat: />\s*\/etc\//i, reason: 'write to /etc' },
38
+ /* git destructive ops. */
39
+ { pat: /\bgit\s+push\s+(?:[^|;&]*\s)?--force\b/i, reason: 'git push --force' },
40
+ { pat: /\bgit\s+push\s+(?:[^|;&]*\s)?-f\b/i, reason: 'git push -f' },
41
+ { pat: /\bgit\s+reset\s+(?:[^|;&]*\s)?--hard\b/i, reason: 'git reset --hard' },
42
+ { pat: /\bgit\s+clean\s+(?:[^|;&]*-[a-zA-Z]*f)/i, reason: 'git clean -f' },
43
+ { pat: /\bgit\s+branch\s+(?:[^|;&]*\s)?-D\b/, reason: 'git branch -D' },
44
+ /* Postgres / mysql blunt instruments. */
45
+ { pat: /\bDROP\s+(TABLE|DATABASE|SCHEMA)\b/i, reason: 'DROP TABLE/DATABASE' },
46
+ { pat: /\bTRUNCATE\s+TABLE\b/i, reason: 'TRUNCATE TABLE' },
47
+ /* npm publish, cargo publish, etc -- one-way. */
48
+ { pat: /\bnpm\s+publish\b/i, reason: 'npm publish' },
49
+ { pat: /\bpnpm\s+publish\b/i, reason: 'pnpm publish' },
50
+ /* skip hooks / signing -- bypass safety. */
51
+ { pat: /--no-verify\b/, reason: '--no-verify' },
52
+ { pat: /--no-gpg-sign\b/, reason: '--no-gpg-sign' },
53
+ /* chmod / chown on system paths. */
54
+ { pat: /\bchmod\s+(?:[^|;&]*\s)?(?:777|-R\b)/i, reason: 'chmod 777 / -R' },
55
+ /* Windows blast tokens. */
56
+ { pat: /\bdel\s+\/[fsq]/i, reason: 'del /f /s /q' },
57
+ { pat: /\brmdir\s+\/[sq]/i, reason: 'rmdir /s /q' },
58
+ { pat: /\bformat\s+[a-z]:/i, reason: 'format C:' },
59
+ ];
60
+ /* Privilege elevation: sudo / runas / etc. Always approval. */
61
+ const ELEVATION_TOKENS = [
62
+ { pat: /^\s*sudo\b/, reason: 'sudo prefix' },
63
+ { pat: /\|\s*sudo\b/, reason: 'piped to sudo' },
64
+ { pat: /^\s*gsudo\b/i, reason: 'gsudo prefix' },
65
+ { pat: /^\s*runas\b/i, reason: 'runas prefix' },
66
+ { pat: /^\s*su\b/, reason: 'su prefix' },
67
+ { pat: /\bdoas\b/, reason: 'doas' },
68
+ ];
69
+ /* Network egress / installs. Per Pablo: approve always. */
70
+ const NETWORK_TOKENS = [
71
+ { pat: /\bcurl\b/i, reason: 'curl' },
72
+ { pat: /\bwget\b/i, reason: 'wget' },
73
+ { pat: /\bInvoke-WebRequest\b/i, reason: 'Invoke-WebRequest' },
74
+ { pat: /\bIwr\b/, reason: 'iwr' },
75
+ { pat: /\bnc\b\s|netcat\b/, reason: 'nc/netcat' },
76
+ /* package managers that hit the network. */
77
+ { pat: /\bnpm\s+(install|i|ci|update|upgrade|add)\b/i, reason: 'npm install' },
78
+ { pat: /\bpnpm\s+(install|add|update|i\b)/i, reason: 'pnpm install' },
79
+ { pat: /\byarn\s+(add|install|upgrade)\b/i, reason: 'yarn install' },
80
+ { pat: /\bpip\s+(install|download)\b/i, reason: 'pip install' },
81
+ { pat: /\bpip3\s+(install|download)\b/i, reason: 'pip3 install' },
82
+ { pat: /\bpoetry\s+(add|install|update)\b/i, reason: 'poetry install' },
83
+ { pat: /\bbrew\s+(install|upgrade|tap)\b/i, reason: 'brew install' },
84
+ { pat: /\bapt(-get)?\s+(install|update|upgrade)\b/i, reason: 'apt install' },
85
+ { pat: /\bcargo\s+(install|update|publish)\b/i, reason: 'cargo install' },
86
+ { pat: /\bgo\s+(get|install)\b/i, reason: 'go get/install' },
87
+ { pat: /\bgit\s+(clone|fetch|pull|push)\b/i, reason: 'git network op' },
88
+ /* docker pulls + runs from registry. */
89
+ { pat: /\bdocker\s+(pull|run|build|push)\b/i, reason: 'docker network op' },
90
+ ];
91
+ /* Tokens that mark the command as command-and-pipe-to-shell --
92
+ * the worst case (curl | bash). Always destructive + network. */
93
+ const PIPE_TO_SHELL = /\|\s*(?:bash|sh|zsh|fish|pwsh|powershell)\b/i;
94
+ /* Common safe read-only / pwd-style commands. Just a fast path
95
+ * to skip the heavier scans for trivial cases. NOT used as a
96
+ * whitelist -- the scanners still run + can over-rule. */
97
+ const SAFE_TOKENS = [
98
+ /^\s*(ls|dir|pwd|cd|echo|cat|less|more|head|tail|wc|date|whoami|hostname|uname)\b/i,
99
+ /^\s*git\s+(status|log|diff|branch\b(?!.*-D)|show|describe|stash\s+list)\b/i,
100
+ /^\s*node\s+--version\b/i,
101
+ /^\s*npm\s+(?:--version|-v|ls|list|outdated)\b/i,
102
+ /^\s*python3?\s+--version\b/i,
103
+ ];
104
+ export function classifyShellCommand(command) {
105
+ const reasons = [];
106
+ const trimmed = (command || '').trim();
107
+ if (!trimmed) {
108
+ return { bucket: 'safe', reasons: ['empty'], requires_approval: false };
109
+ }
110
+ /* Worst-case: pipe to shell. Treat as destructive. */
111
+ if (PIPE_TO_SHELL.test(trimmed)) {
112
+ return {
113
+ bucket: 'destructive',
114
+ reasons: ['pipe to shell interpreter'],
115
+ requires_approval: true,
116
+ };
117
+ }
118
+ /* Elevation takes precedence -- sudo X is dangerous regardless
119
+ * of what X does. */
120
+ for (const { pat, reason } of ELEVATION_TOKENS) {
121
+ if (pat.test(trimmed)) {
122
+ return { bucket: 'elevation', reasons: [reason], requires_approval: true };
123
+ }
124
+ }
125
+ /* Destructive sweep. */
126
+ for (const { pat, reason } of DESTRUCTIVE_TOKENS) {
127
+ if (pat.test(trimmed))
128
+ reasons.push(reason);
129
+ }
130
+ if (reasons.length > 0) {
131
+ return { bucket: 'destructive', reasons, requires_approval: true };
132
+ }
133
+ /* Network sweep. */
134
+ const netReasons = [];
135
+ for (const { pat, reason } of NETWORK_TOKENS) {
136
+ if (pat.test(trimmed))
137
+ netReasons.push(reason);
138
+ }
139
+ if (netReasons.length > 0) {
140
+ return { bucket: 'network', reasons: netReasons, requires_approval: true };
141
+ }
142
+ /* Safe fast-path. */
143
+ for (const p of SAFE_TOKENS) {
144
+ if (p.test(trimmed))
145
+ return { bucket: 'safe', reasons: ['known safe pattern'], requires_approval: false };
146
+ }
147
+ /* Unknown -> default to safe but flag for the user. The
148
+ * approval gate at the caller is what decides if approval is
149
+ * required; safe bucket means "don't force approval, but
150
+ * caller may still require it if 'always approve shell' is
151
+ * on or Danger Zone is off + the operator wants total
152
+ * control". */
153
+ return { bucket: 'safe', reasons: ['unclassified -- defaulted safe'], requires_approval: false };
154
+ }
155
+ /* Test seam. */
156
+ export const _patterns = {
157
+ DESTRUCTIVE_TOKENS, ELEVATION_TOKENS, NETWORK_TOKENS, SAFE_TOKENS, PIPE_TO_SHELL,
158
+ };
159
+ //# sourceMappingURL=shell_classifier.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell_classifier.js","sourceRoot":"","sources":["../../src/core/shell_classifier.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ /** Force-clear caches. Used by tests. */
2
+ export declare function _clearSqResolverCaches(): void;
3
+ /** Return the active SQ rule slugs for a given step, merged with
4
+ * the always-active cross-cutting set. Deduped. */
5
+ export declare function activeRulesForStep(stepDescriptor: string | number | null | undefined): Promise<string[]>;
6
+ /** Render a compact "ACTIVE SQ RULES" block for the system prompt.
7
+ * Format: `SQ <slug> <title>` one per line. Returns empty when
8
+ * no rules apply (e.g., yaml missing). */
9
+ export declare function renderActiveRulesBlock(stepDescriptor: string | number | null | undefined): Promise<string>;
10
+ /** Render the ACTIVE SQ RULES block from an explicit slug list.
11
+ * Used when the workflow state declares `active_sq_rules` directly
12
+ * (alpha.59z.5 F1 -- skip the step inference path). */
13
+ export declare function renderRulesBlockBySlugs(slugs: string[]): Promise<string>;
14
+ //# sourceMappingURL=sq_resolver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sq_resolver.d.ts","sourceRoot":"","sources":["../../src/core/sq_resolver.ts"],"names":[],"mappings":"AA2JA,yCAAyC;AACzC,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAsBD;oDACoD;AACpD,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU9G;AAED;;2CAE2C;AAC3C,wBAAsB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhH;AAED;;wDAEwD;AACxD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9E"}