@pugi/cli 0.1.0-beta.7 → 0.1.0-beta.87

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 (402) hide show
  1. package/CHANGELOG.md +96 -0
  2. package/THIRD_PARTY_NOTICES.md +40 -0
  3. package/assets/pugi-prozr2-mascot.ansi +9 -0
  4. package/bin/run.js +33 -1
  5. package/dist/commands/deploy.js +40 -40
  6. package/dist/commands/flatten.js +191 -0
  7. package/dist/commands/jobs-watch.js +201 -0
  8. package/dist/commands/jobs.js +42 -27
  9. package/dist/commands/smoke.js +133 -0
  10. package/dist/core/agent-progress/cleanup.js +134 -0
  11. package/dist/core/agent-progress/schema.js +144 -0
  12. package/dist/core/agent-progress/writer.js +101 -0
  13. package/dist/core/agents/adaptive-router.js +330 -0
  14. package/dist/core/agents/query-decomposer.js +297 -0
  15. package/dist/core/agents/registry.js +2 -2
  16. package/dist/core/approvals/shortcut-resolver.js +98 -0
  17. package/dist/core/artifact-chain/dispatcher.js +148 -0
  18. package/dist/core/artifact-chain/exporter.js +164 -0
  19. package/dist/core/artifact-chain/state.js +243 -0
  20. package/dist/core/artifact-chain/steps.js +169 -0
  21. package/dist/core/ask-user/question.js +92 -0
  22. package/dist/core/audit/audit-trail.js +275 -0
  23. package/dist/core/auth/ensure-authenticated.js +129 -0
  24. package/dist/core/auth/env-provider.js +238 -0
  25. package/dist/core/auto-open-browser.js +4 -4
  26. package/dist/core/auto-update/channels.js +122 -0
  27. package/dist/core/auto-update/checker.js +241 -0
  28. package/dist/core/auto-update/state.js +235 -0
  29. package/dist/core/bare-mode/index.js +107 -0
  30. package/dist/core/bash/redirect.js +281 -0
  31. package/dist/core/bash-classifier.js +436 -40
  32. package/dist/core/checkpoint/resumer.js +149 -0
  33. package/dist/core/checkpoint/rewinder.js +291 -0
  34. package/dist/core/checkpoints/shadow-git.js +670 -0
  35. package/dist/core/citations/parser.js +109 -0
  36. package/dist/core/classifier/yolo-classifier.js +88 -0
  37. package/dist/core/codegraph/decision-store.js +248 -0
  38. package/dist/core/codegraph/detect-repo.js +459 -0
  39. package/dist/core/codegraph/install.js +134 -0
  40. package/dist/core/codegraph/offer-hook.js +220 -0
  41. package/dist/core/compact/auto-trigger.js +96 -0
  42. package/dist/core/compact/buffer-rewriter.js +115 -0
  43. package/dist/core/compact/summarizer.js +208 -0
  44. package/dist/core/compact/token-counter.js +108 -0
  45. package/dist/core/consensus/anvil-fanout.js +25 -25
  46. package/dist/core/consensus/diff-capture.js +121 -12
  47. package/dist/core/consensus/rubric.js +21 -21
  48. package/dist/core/context/builder.js +6 -6
  49. package/dist/core/context/compaction-events.js +8 -8
  50. package/dist/core/context/compaction.js +31 -31
  51. package/dist/core/context/index.js +15 -8
  52. package/dist/core/context/invariants.js +51 -51
  53. package/dist/core/context/markdown-loader.js +28 -10
  54. package/dist/core/context/markdown-traverse.js +255 -0
  55. package/dist/core/context/pugiignore.js +41 -41
  56. package/dist/core/context/repo-skeleton.js +37 -37
  57. package/dist/core/context/tool-eviction.js +55 -0
  58. package/dist/core/context/watcher.js +32 -32
  59. package/dist/core/context/working-set.js +23 -23
  60. package/dist/core/coordinator/agent-tools.js +77 -0
  61. package/dist/core/coordinator/agent-toolset.js +65 -0
  62. package/dist/core/coordinator/fsm.js +73 -0
  63. package/dist/core/coordinator/mode-fsm.js +70 -0
  64. package/dist/core/cost/rate-card.js +129 -0
  65. package/dist/core/cost/tracker.js +221 -0
  66. package/dist/core/credentials.js +12 -12
  67. package/dist/core/cron/scheduler.js +138 -0
  68. package/dist/core/denial-tracking/index.js +8 -0
  69. package/dist/core/denial-tracking/state.js +264 -0
  70. package/dist/core/diagnostics/probe-runner.js +93 -0
  71. package/dist/core/diagnostics/probes/api.js +46 -0
  72. package/dist/core/diagnostics/probes/auth.js +93 -0
  73. package/dist/core/diagnostics/probes/bare-mode.js +42 -0
  74. package/dist/core/diagnostics/probes/cli-version.js +127 -0
  75. package/dist/core/diagnostics/probes/config.js +72 -0
  76. package/dist/core/diagnostics/probes/denial-tracking.js +57 -0
  77. package/dist/core/diagnostics/probes/disk.js +81 -0
  78. package/dist/core/diagnostics/probes/engine-live.js +46 -0
  79. package/dist/core/diagnostics/probes/git.js +65 -0
  80. package/dist/core/diagnostics/probes/hooks.js +118 -0
  81. package/dist/core/diagnostics/probes/mcp.js +75 -0
  82. package/dist/core/diagnostics/probes/node.js +59 -0
  83. package/dist/core/diagnostics/probes/pnpm.js +36 -0
  84. package/dist/core/diagnostics/probes/pugi-md.js +89 -0
  85. package/dist/core/diagnostics/probes/sandbox.js +40 -0
  86. package/dist/core/diagnostics/probes/session.js +74 -0
  87. package/dist/core/diagnostics/probes/status-snapshot.js +488 -0
  88. package/dist/core/diagnostics/probes/workspace.js +63 -0
  89. package/dist/core/diagnostics/types.js +70 -0
  90. package/dist/core/dispatch/cache-cleanup.js +197 -0
  91. package/dist/core/dispatch/cache-handoff.js +295 -0
  92. package/dist/core/edits/apply-patch-layer-e.js +189 -0
  93. package/dist/core/edits/dispatch.js +293 -7
  94. package/dist/core/edits/format-matrix.js +26 -0
  95. package/dist/core/edits/fuzzy-ladder.js +650 -0
  96. package/dist/core/edits/index.js +3 -1
  97. package/dist/core/edits/journal.js +199 -0
  98. package/dist/core/edits/layer-a-apply.js +15 -15
  99. package/dist/core/edits/layer-a-fuzzy-apply.js +198 -0
  100. package/dist/core/edits/layer-b-apply.js +9 -9
  101. package/dist/core/edits/layer-c-apply.js +6 -6
  102. package/dist/core/edits/layer-d-ast.js +557 -14
  103. package/dist/core/edits/marker-parser.js +12 -12
  104. package/dist/core/edits/security-gate.js +27 -27
  105. package/dist/core/edits/verify-hook.js +273 -0
  106. package/dist/core/edits/worktree.js +322 -0
  107. package/dist/core/engine/anvil-client.js +140 -26
  108. package/dist/core/engine/auto-compact.js +179 -0
  109. package/dist/core/engine/budgets.js +186 -0
  110. package/dist/core/engine/context-prefix.js +155 -0
  111. package/dist/core/engine/index.js +1 -1
  112. package/dist/core/engine/intensity.js +158 -0
  113. package/dist/core/engine/intent.js +260 -0
  114. package/dist/core/engine/native-pugi.js +1295 -227
  115. package/dist/core/engine/prompts.js +134 -16
  116. package/dist/core/engine/strip-internal-fields.js +124 -0
  117. package/dist/core/engine/tool-bridge.js +1295 -59
  118. package/dist/core/evaluation/golden-dataset.js +293 -0
  119. package/dist/core/feedback/queue.js +177 -0
  120. package/dist/core/feedback/submitter.js +145 -0
  121. package/dist/core/file-cache.js +113 -1
  122. package/dist/core/flatten/flatten-repo.js +439 -0
  123. package/dist/core/format/osc8-link.js +28 -0
  124. package/dist/core/hook-chains.js +392 -0
  125. package/dist/core/hooks/citation-verify-hook.js +138 -0
  126. package/dist/core/hooks/citation-verify.js +112 -0
  127. package/dist/core/hooks/events.js +44 -0
  128. package/dist/core/hooks/index.js +15 -0
  129. package/dist/core/hooks/registry.js +213 -0
  130. package/dist/core/hooks/runner.js +236 -0
  131. package/dist/core/hooks/v2/event-emitter.js +115 -0
  132. package/dist/core/hooks/v2/executor.js +282 -0
  133. package/dist/core/hooks/v2/index.js +25 -0
  134. package/dist/core/hooks/v2/lifecycle.js +104 -0
  135. package/dist/core/hooks/v2/loader.js +216 -0
  136. package/dist/core/hooks/v2/matcher.js +125 -0
  137. package/dist/core/hooks/v2/trust.js +143 -0
  138. package/dist/core/hooks/v2/types.js +86 -0
  139. package/dist/core/image/renderer.js +71 -0
  140. package/dist/core/init/detector.js +582 -0
  141. package/dist/core/init/template-renderer.js +242 -0
  142. package/dist/core/jobs/registry.js +18 -18
  143. package/dist/core/ledger/results-tsv.js +142 -0
  144. package/dist/core/log-discipline/stdout-redirect.js +51 -0
  145. package/dist/core/lsp/cache.js +105 -0
  146. package/dist/core/lsp/client.js +776 -0
  147. package/dist/core/lsp/language-detect.js +66 -0
  148. package/dist/core/lsp/post-edit-diagnostics.js +171 -0
  149. package/dist/core/lsp/symbol-tools.js +372 -0
  150. package/dist/core/mcp/client.js +97 -28
  151. package/dist/core/mcp/http-server.js +553 -0
  152. package/dist/core/mcp/orchestrator-tools.js +662 -0
  153. package/dist/core/mcp/permission.js +190 -0
  154. package/dist/core/mcp/registry.js +39 -17
  155. package/dist/core/mcp/server-tools.js +219 -0
  156. package/dist/core/mcp/server.js +397 -0
  157. package/dist/core/mcp/trust.js +10 -10
  158. package/dist/core/memory/dual-write.js +416 -0
  159. package/dist/core/memory/passive-extract.js +130 -0
  160. package/dist/core/memory/phase1-kinds.js +20 -0
  161. package/dist/core/memory/secret-scanner.js +304 -0
  162. package/dist/core/memory-sync/queue.js +170 -0
  163. package/dist/core/metrics/extract.js +113 -0
  164. package/dist/core/modes/roo-modes.js +68 -0
  165. package/dist/core/onboarding/ensure-initialized.js +133 -0
  166. package/dist/core/onboarding/marker.js +111 -0
  167. package/dist/core/onboarding/telemetry-state.js +108 -0
  168. package/dist/core/output-style/presets.js +176 -0
  169. package/dist/core/output-style/state.js +185 -0
  170. package/dist/core/path-security.js +287 -5
  171. package/dist/core/permission.js +82 -22
  172. package/dist/core/permissions/auto-classifier.js +124 -0
  173. package/dist/core/permissions/bash-parser.js +371 -0
  174. package/dist/core/permissions/circuit-breaker.js +83 -0
  175. package/dist/core/permissions/constrained-edit.js +91 -0
  176. package/dist/core/permissions/gate.js +278 -0
  177. package/dist/core/permissions/index.js +20 -0
  178. package/dist/core/permissions/mode.js +174 -0
  179. package/dist/core/permissions/network-egress.js +137 -0
  180. package/dist/core/permissions/state.js +241 -0
  181. package/dist/core/permissions/tool-class.js +93 -0
  182. package/dist/core/plan-mode/ui-state.js +51 -0
  183. package/dist/core/plans/plan-artifact.js +721 -0
  184. package/dist/core/policy-limits/etag-store.js +122 -0
  185. package/dist/core/prd-check/parser.js +215 -0
  186. package/dist/core/prd-check/reporter.js +127 -0
  187. package/dist/core/prd-check/session-review.js +557 -0
  188. package/dist/core/prd-check/verifiers.js +223 -0
  189. package/dist/core/prompt-cache/client-cache.js +99 -0
  190. package/dist/core/prompts/assembly.js +29 -0
  191. package/dist/core/prompts/registry.js +364 -0
  192. package/dist/core/pugi-md/cc-compat-rules.js +735 -0
  193. package/dist/core/pugi-md/context-injector.js +76 -0
  194. package/dist/core/pugi-md/walk-up.js +207 -0
  195. package/dist/core/python/uv-installer.js +270 -0
  196. package/dist/core/python/uv-resolver.js +83 -0
  197. package/dist/core/rate-limit/narrator.js +146 -0
  198. package/dist/core/recipes/cli-types.js +20 -0
  199. package/dist/core/recipes/loader.js +103 -0
  200. package/dist/core/recipes/runner.js +345 -0
  201. package/dist/core/recipes/schema.js +587 -0
  202. package/dist/core/release-notes/parser.js +241 -0
  203. package/dist/core/release-notes/state.js +116 -0
  204. package/dist/core/repl/ask.js +37 -37
  205. package/dist/core/repl/cancellation.js +26 -26
  206. package/dist/core/repl/cap-warning.js +4 -4
  207. package/dist/core/repl/clipboard-read.js +11 -11
  208. package/dist/core/repl/dispatch-fsm.js +12 -12
  209. package/dist/core/repl/history-search.js +15 -15
  210. package/dist/core/repl/history.js +28 -18
  211. package/dist/core/repl/kill-ring.js +5 -5
  212. package/dist/core/repl/model-pricing.js +135 -0
  213. package/dist/core/repl/privacy-banner.js +22 -22
  214. package/dist/core/repl/session.js +2157 -214
  215. package/dist/core/repl/slash-commands.js +533 -40
  216. package/dist/core/repl/store/index.js +1 -1
  217. package/dist/core/repl/store/jsonl-log.js +22 -22
  218. package/dist/core/repl/store/lockfile.js +10 -10
  219. package/dist/core/repl/store/session-store.js +136 -107
  220. package/dist/core/repl/store/types.js +15 -15
  221. package/dist/core/repl/store/uuid-v7.js +12 -12
  222. package/dist/core/repl/workspace-context.js +43 -21
  223. package/dist/core/repo-map/build.js +125 -0
  224. package/dist/core/repo-map/cache.js +185 -0
  225. package/dist/core/repo-map/extractor.js +254 -0
  226. package/dist/core/repo-map/formatter.js +145 -0
  227. package/dist/core/repo-map/page-rank.js +105 -0
  228. package/dist/core/repo-map/scanner.js +211 -0
  229. package/dist/core/retry-budget/budget.js +284 -0
  230. package/dist/core/retry-budget/index.js +5 -0
  231. package/dist/core/retry-budget/retry-cap.js +74 -0
  232. package/dist/core/routing/lead-worker.js +43 -0
  233. package/dist/core/routing/pre-flight-estimator.js +108 -0
  234. package/dist/core/runs/run-tree.js +103 -0
  235. package/dist/core/security/injection-scanner.js +367 -0
  236. package/dist/core/security/output-filter.js +418 -0
  237. package/dist/core/session/env-file.js +105 -0
  238. package/dist/core/session/section-budgets.js +140 -0
  239. package/dist/core/session.js +92 -0
  240. package/dist/core/settings.js +286 -5
  241. package/dist/core/share/formatter.js +271 -0
  242. package/dist/core/share/redactor.js +221 -0
  243. package/dist/core/share/uploader.js +267 -0
  244. package/dist/core/skills/defaults.js +457 -0
  245. package/dist/core/skills/loader.js +22 -22
  246. package/dist/core/skills/sources.js +27 -27
  247. package/dist/core/smoke/headless-driver.js +174 -0
  248. package/dist/core/smoke/orchestrator.js +194 -0
  249. package/dist/core/smoke/runner.js +238 -0
  250. package/dist/core/smoke/scenario-parser.js +316 -0
  251. package/dist/core/statusline.js +99 -0
  252. package/dist/core/subagents/dispatcher-real.js +600 -0
  253. package/dist/core/subagents/dispatcher.js +132 -43
  254. package/dist/core/subagents/index.js +19 -6
  255. package/dist/core/subagents/isolation-matrix.js +213 -0
  256. package/dist/core/subagents/spawn.js +19 -4
  257. package/dist/core/telemetry/emitter.js +229 -0
  258. package/dist/core/telemetry/queue.js +251 -0
  259. package/dist/core/theme/context.js +91 -0
  260. package/dist/core/theme/presets.js +228 -0
  261. package/dist/core/theme/state.js +181 -0
  262. package/dist/core/todos/invariant.js +10 -0
  263. package/dist/core/todos/state.js +177 -0
  264. package/dist/core/tool-schema/compressor.js +89 -0
  265. package/dist/core/transport/version-interceptor.js +166 -0
  266. package/dist/core/trust.js +2 -2
  267. package/dist/core/tui/thinking-block.js +64 -0
  268. package/dist/core/vim/keymap.js +288 -0
  269. package/dist/core/vim/state.js +92 -0
  270. package/dist/core/watch-markers/marker-watcher.js +133 -0
  271. package/dist/core/worktree-manager/cleanup.js +123 -0
  272. package/dist/core/worktree-manager/manager.js +303 -0
  273. package/dist/index.js +28 -0
  274. package/dist/runtime/bootstrap.js +190 -0
  275. package/dist/runtime/cli.js +4162 -488
  276. package/dist/runtime/commands/agents.js +30 -30
  277. package/dist/runtime/commands/budget.js +5 -5
  278. package/dist/runtime/commands/cancel.js +231 -0
  279. package/dist/runtime/commands/chain.js +489 -0
  280. package/dist/runtime/commands/codegraph-status.js +227 -0
  281. package/dist/runtime/commands/compact.js +297 -0
  282. package/dist/runtime/commands/config.js +32 -32
  283. package/dist/runtime/commands/cost.js +199 -0
  284. package/dist/runtime/commands/delegate.js +244 -13
  285. package/dist/runtime/commands/dispatch.js +126 -0
  286. package/dist/runtime/commands/doctor.js +579 -0
  287. package/dist/runtime/commands/feedback.js +184 -0
  288. package/dist/runtime/commands/hooks.js +184 -0
  289. package/dist/runtime/commands/init.js +254 -0
  290. package/dist/runtime/commands/lsp.js +368 -0
  291. package/dist/runtime/commands/mcp.js +879 -0
  292. package/dist/runtime/commands/memory.js +582 -0
  293. package/dist/runtime/commands/model.js +237 -0
  294. package/dist/runtime/commands/onboarding.js +275 -0
  295. package/dist/runtime/commands/patch.js +128 -0
  296. package/dist/runtime/commands/permissions.js +112 -0
  297. package/dist/runtime/commands/plan.js +143 -0
  298. package/dist/runtime/commands/prd-check.js +285 -0
  299. package/dist/runtime/commands/privacy.js +17 -17
  300. package/dist/runtime/commands/recipe.js +325 -0
  301. package/dist/runtime/commands/redo-blob-store.js +92 -0
  302. package/dist/runtime/commands/redo.js +361 -0
  303. package/dist/runtime/commands/release-notes.js +229 -0
  304. package/dist/runtime/commands/repo-map.js +95 -0
  305. package/dist/runtime/commands/report.js +299 -0
  306. package/dist/runtime/commands/resume.js +118 -0
  307. package/dist/runtime/commands/review-consensus.js +68 -53
  308. package/dist/runtime/commands/rewind.js +333 -0
  309. package/dist/runtime/commands/roster.js +14 -14
  310. package/dist/runtime/commands/sessions.js +163 -0
  311. package/dist/runtime/commands/share.js +316 -0
  312. package/dist/runtime/commands/skills.js +31 -31
  313. package/dist/runtime/commands/status.js +186 -0
  314. package/dist/runtime/commands/stickers.js +82 -0
  315. package/dist/runtime/commands/style.js +194 -0
  316. package/dist/runtime/commands/theme.js +196 -0
  317. package/dist/runtime/commands/undo.js +54 -22
  318. package/dist/runtime/commands/update.js +289 -0
  319. package/dist/runtime/commands/vim.js +140 -0
  320. package/dist/runtime/commands/worktree.js +177 -0
  321. package/dist/runtime/commands/worktrees.js +155 -0
  322. package/dist/runtime/headless-repl.js +195 -0
  323. package/dist/runtime/headless.js +543 -0
  324. package/dist/runtime/load-hooks-or-exit.js +71 -0
  325. package/dist/runtime/plan-decompose.js +531 -0
  326. package/dist/runtime/update-check.js +28 -28
  327. package/dist/runtime/version.js +65 -0
  328. package/dist/skills/bundled/batch.js +617 -0
  329. package/dist/skills/bundled/index.js +45 -0
  330. package/dist/skills/bundled/loop.js +358 -0
  331. package/dist/skills/bundled/remember.js +383 -0
  332. package/dist/skills/bundled/simplify.js +289 -0
  333. package/dist/skills/bundled/skillify.js +373 -0
  334. package/dist/skills/bundled/stuck.js +558 -0
  335. package/dist/skills/bundled/verify.js +439 -0
  336. package/dist/testing/vcr.js +486 -0
  337. package/dist/tools/agent-tool.js +229 -0
  338. package/dist/tools/apply-patch.js +556 -0
  339. package/dist/tools/ask-user-question.js +222 -0
  340. package/dist/tools/ask-user.js +115 -0
  341. package/dist/tools/bash.js +623 -45
  342. package/dist/tools/brief.js +224 -0
  343. package/dist/tools/enter-worktree.js +250 -0
  344. package/dist/tools/exit-worktree.js +147 -0
  345. package/dist/tools/file-tools.js +161 -44
  346. package/dist/tools/lsp-tools.js +189 -0
  347. package/dist/tools/mcp-tool.js +260 -0
  348. package/dist/tools/multi-edit.js +361 -0
  349. package/dist/tools/powershell.js +268 -0
  350. package/dist/tools/registry.js +85 -0
  351. package/dist/tools/skill-tool.js +96 -0
  352. package/dist/tools/sleep.js +99 -0
  353. package/dist/tools/synthetic-output.js +133 -0
  354. package/dist/tools/tasks.js +208 -0
  355. package/dist/tools/todo-write.js +184 -0
  356. package/dist/tools/verify-plan-execution.js +295 -0
  357. package/dist/tools/web-fetch-injection-scanner.js +207 -0
  358. package/dist/tools/web-fetch.js +195 -10
  359. package/dist/tools/web-search.js +458 -0
  360. package/dist/tui/agent-progress-card.js +111 -0
  361. package/dist/tui/agent-tree.js +11 -1
  362. package/dist/tui/ask-modal.js +14 -14
  363. package/dist/tui/ask-user-question-prompt.js +203 -0
  364. package/dist/tui/compact-banner.js +81 -0
  365. package/dist/tui/conversation-pane.js +85 -11
  366. package/dist/tui/cost-table.js +111 -0
  367. package/dist/tui/device-flow.js +2 -2
  368. package/dist/tui/doctor-table.js +46 -0
  369. package/dist/tui/feedback-prompt.js +156 -0
  370. package/dist/tui/input-box.js +247 -32
  371. package/dist/tui/login-picker.js +3 -3
  372. package/dist/tui/markdown-render.js +6 -6
  373. package/dist/tui/onboarding-wizard.js +240 -0
  374. package/dist/tui/permissions-picker.js +86 -0
  375. package/dist/tui/render.js +35 -0
  376. package/dist/tui/repl-render.js +332 -54
  377. package/dist/tui/repl-splash-art.js +16 -16
  378. package/dist/tui/repl-splash-mascot.js +48 -24
  379. package/dist/tui/repl-splash.js +22 -22
  380. package/dist/tui/repl.js +124 -44
  381. package/dist/tui/slash-palette.js +6 -6
  382. package/dist/tui/splash.js +2 -2
  383. package/dist/tui/status-bar.js +109 -31
  384. package/dist/tui/status-table.js +7 -0
  385. package/dist/tui/stickers-art.js +136 -0
  386. package/dist/tui/style-table.js +28 -0
  387. package/dist/tui/theme-table.js +29 -0
  388. package/dist/tui/thinking-spinner.js +123 -0
  389. package/dist/tui/tool-stream-pane.js +53 -4
  390. package/dist/tui/update-banner.js +27 -2
  391. package/dist/tui/vim-input.js +267 -0
  392. package/dist/tui/welcome-banner.js +107 -0
  393. package/dist/tui/welcome-data.js +293 -0
  394. package/dist/tui/workspace-context.js +2 -2
  395. package/docs/examples/codegraph.mcp.json +10 -0
  396. package/package.json +23 -6
  397. package/test/scenarios/codegen-create-file.scenario.txt +13 -0
  398. package/test/scenarios/compact-force.scenario.txt +11 -0
  399. package/test/scenarios/identity.scenario.txt +11 -0
  400. package/test/scenarios/persona-handoff.scenario.txt +11 -0
  401. package/test/scenarios/walkback.scenario.txt +12 -0
  402. package/dist/core/engine/compaction-hook.js +0 -154
@@ -0,0 +1,124 @@
1
+ /**
2
+ * Auto-mode classifier — Phase 1 (regex allowlist + denylist).
3
+ *
4
+ * `permissionMode === 'auto'` is the the upstream tool parity mode where the
5
+ * classifier decides safe-vs-unsafe per call. Phase 1 ships without
6
+ * ML — just two curated regex lists covering the 80% of "obviously
7
+ * safe" and "obviously catastrophic" patterns. Anything that doesn't
8
+ * match either list returns `ask`, so the operator stays in the loop
9
+ * для the ambiguous middle.
10
+ *
11
+ * Phase 2 (deferred, NOT in this PR): semantic classifier consulting
12
+ * the model with a tight system prompt. The interface (`AutoVerdict`)
13
+ * is stable so we can swap implementations without touching the gate.
14
+ *
15
+ * Design notes:
16
+ *
17
+ * - Patterns are conservative: a read-only command is only
18
+ * allow-listed когда its argv shape is unambiguous (no `-exec`,
19
+ * no `--delete`, no `|` к shell). When в doubt, fall back to ask.
20
+ * - The denylist matches catastrophic patterns even в auto-mode so
21
+ * a misclick can't shred the workspace. The circuit-breaker
22
+ * (`circuit-breaker.ts`) covers the same surface для bypass-mode;
23
+ * this denylist is the auto-mode equivalent.
24
+ * - All matches operate on the FULL command string, not parsed
25
+ * argv. This is deliberately permissive on whitespace but strict
26
+ * on operator characters (`|`, `&`, `;`, `>`, backticks) — a
27
+ * pipe-into-shell или command-chain forces fallback к ask.
28
+ */
29
+ /**
30
+ * Catastrophic patterns — the auto-mode regex denylist. Each entry
31
+ * carries a human-readable reason surfaced в the deny payload so the
32
+ * operator + audit log see why the gate refused. Order matters: most-
33
+ * specific первой так "rm -rf /" reports as that, не the generic
34
+ * "rm -rf".
35
+ */
36
+ const AUTO_DENY_PATTERNS = [
37
+ { pattern: /\brm\s+(-[a-z]*r[a-z]*f|-[a-z]*f[a-z]*r)\b/i, reason: 'rm -rf (recursive force-delete)' },
38
+ { pattern: /\bgit\s+push\s+(-{1,2}force\b|\-f\b)/i, reason: 'git push --force (history rewrite)' },
39
+ { pattern: /\bgit\s+reset\s+--hard\b/i, reason: 'git reset --hard (uncommitted-work loss)' },
40
+ { pattern: /\bdd\s+if=\/(dev|)/i, reason: 'dd if=/dev/* (raw device read/write)' },
41
+ { pattern: /\bmkfs(\.|\s|$)/i, reason: 'mkfs (filesystem format)' },
42
+ { pattern: /\bchmod\s+-R\s+777\b/i, reason: 'chmod -R 777 (world-writable recursive)' },
43
+ { pattern: /\bchown\s+-R\b/i, reason: 'chown -R (recursive ownership change)' },
44
+ { pattern: /:\(\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;?\s*:/, reason: 'fork bomb signature' },
45
+ { pattern: /\bsudo\b/i, reason: 'sudo (privilege escalation)' },
46
+ { pattern: /\b(npm|pnpm|yarn)\s+publish\b/i, reason: 'package publish (irreversible npm release)' },
47
+ { pattern: /\b(curl|wget)\b[^|;&]*\|\s*(sh|bash|zsh)\b/i, reason: 'pipe-to-shell installer (curl … | sh)' },
48
+ ];
49
+ /**
50
+ * Safe-by-default patterns — auto-mode regex allowlist. Each regex
51
+ * must match the FULL command (with `^…$` anchors) so a leading
52
+ * `sudo ls` или a trailing `; rm -rf /` does NOT slip through. The
53
+ * caller passes the trimmed command string; whitespace around argv
54
+ * tokens is tolerated.
55
+ */
56
+ const AUTO_ALLOW_PATTERNS = [
57
+ { pattern: /^ls(\s+-[a-zA-Z]+)*(\s+[^|;&`>$()\\]+)?$/, reason: 'ls (directory listing)' },
58
+ { pattern: /^pwd\s*$/, reason: 'pwd (working directory)' },
59
+ { pattern: /^cat\s+[^|;&`>$()\\]+$/, reason: 'cat (file read)' },
60
+ { pattern: /^head(\s+-n?\s*\d+)?\s+[^|;&`>$()\\]+$/, reason: 'head (file preview)' },
61
+ { pattern: /^tail(\s+-n?\s*\d+)?\s+[^|;&`>$()\\]+$/, reason: 'tail (file preview)' },
62
+ { pattern: /^wc(\s+-[a-z]+)?\s+[^|;&`>$()\\]+$/, reason: 'wc (line/word count)' },
63
+ { pattern: /^du\s+-sh?\s+[^|;&`>$()\\]+$/, reason: 'du -sh (disk usage summary)' },
64
+ { pattern: /^df\s+-h\s*$/, reason: 'df -h (filesystem free space)' },
65
+ { pattern: /^git\s+status(\s+--short|\s+-s)?\s*$/, reason: 'git status' },
66
+ { pattern: /^git\s+diff(\s+[a-zA-Z0-9_./~^-]+)*\s*$/, reason: 'git diff (read-only)' },
67
+ { pattern: /^git\s+log(\s+[a-zA-Z0-9_./~^-]+)*\s*$/, reason: 'git log (read-only)' },
68
+ { pattern: /^git\s+branch(\s+-[a-z]+)?\s*$/, reason: 'git branch (read-only)' },
69
+ { pattern: /^git\s+remote\s+-v\s*$/, reason: 'git remote -v (read-only)' },
70
+ { pattern: /^pnpm\s+(typecheck|lint|test\s+--run|test\s+--watch=false)\s*$/, reason: 'pnpm read-only build check' },
71
+ { pattern: /^npm\s+(--version|-v|run\s+typecheck|run\s+lint)\s*$/, reason: 'npm read-only check' },
72
+ { pattern: /^node\s+--version\s*$/, reason: 'node --version' },
73
+ { pattern: /^pnpm\s+--version\s*$/, reason: 'pnpm --version' },
74
+ { pattern: /^which\s+[a-zA-Z0-9_-]+\s*$/, reason: 'which (command lookup)' },
75
+ { pattern: /^find\s+\.\s+-type\s+f(\s+-name\s+[^|;&`>$()\\]+)?\s*$/, reason: 'find -type f (read-only)' },
76
+ { pattern: /^(rg|ripgrep|grep)\s+(-[a-z]+\s+)*[^|;&`>$()\\]+(\s+[^|;&`>$()\\]+)?\s*$/, reason: 'grep/ripgrep (read-only search)' },
77
+ ];
78
+ /**
79
+ * Classify an auto-mode command. Order:
80
+ * 1. Catastrophic deny patterns — surface the explicit deny reason.
81
+ * 2. Safe allow patterns — surface the matched reason.
82
+ * 3. Fallback к ask.
83
+ *
84
+ * The order matters: a destructive pattern that ALSO looks like a
85
+ * read-only token (e.g. `git diff ; rm -rf .`) hits deny first because
86
+ * the allow patterns require `^…$` anchors that the chained command
87
+ * fails to satisfy. Belt + suspenders.
88
+ */
89
+ export function classifyAutoMode(command) {
90
+ const trimmed = command.trim();
91
+ if (trimmed.length === 0)
92
+ return { verdict: 'ask' };
93
+ for (const entry of AUTO_DENY_PATTERNS) {
94
+ if (entry.pattern.test(trimmed)) {
95
+ return {
96
+ verdict: 'deny',
97
+ reason: entry.reason,
98
+ pattern: entry.pattern.source,
99
+ };
100
+ }
101
+ }
102
+ for (const entry of AUTO_ALLOW_PATTERNS) {
103
+ if (entry.pattern.test(trimmed)) {
104
+ return {
105
+ verdict: 'allow',
106
+ reason: entry.reason,
107
+ pattern: entry.pattern.source,
108
+ };
109
+ }
110
+ }
111
+ return { verdict: 'ask' };
112
+ }
113
+ /**
114
+ * Diagnostic accessors — exposed для doctor surfaces + spec coverage.
115
+ * The arrays are frozen at module load so callers can iterate without
116
+ * mutating the source-of-truth.
117
+ */
118
+ export function listAutoAllowPatterns() {
119
+ return AUTO_ALLOW_PATTERNS.map((e) => ({ pattern: e.pattern.source, reason: e.reason }));
120
+ }
121
+ export function listAutoDenyPatterns() {
122
+ return AUTO_DENY_PATTERNS.map((e) => ({ pattern: e.pattern.source, reason: e.reason }));
123
+ }
124
+ //# sourceMappingURL=auto-classifier.js.map
@@ -0,0 +1,371 @@
1
+ const WRAPPER_COMMANDS = new Set(['bash', 'sh']);
2
+ const PIPELINE_SEPARATORS = new Set(['&&', '||', '|', ';']);
3
+ export function parseBashCommand(cmd) {
4
+ const rawCommand = cmd;
5
+ const command = stripWrappers(cmd).trim();
6
+ if (command.length === 0) {
7
+ throw new Error('empty bash command');
8
+ }
9
+ const stageSources = splitPipeline(command);
10
+ const envVars = {};
11
+ const redirects = [];
12
+ const pipelineStages = [];
13
+ const tokens = [];
14
+ for (const stageSource of stageSources) {
15
+ const rawTokens = tokenize(stageSource);
16
+ const stage = normalizeStage(rawTokens, envVars, redirects);
17
+ if (stage.length === 0) {
18
+ throw new Error('pipeline stage has no command');
19
+ }
20
+ pipelineStages.push(stage);
21
+ tokens.push(...stage);
22
+ }
23
+ const firstStage = pipelineStages[0];
24
+ if (firstStage === undefined) {
25
+ throw new Error('bash command has no stages');
26
+ }
27
+ const firstCommand = firstStage[0];
28
+ if (firstCommand === undefined || firstCommand.length === 0) {
29
+ throw new Error('bash command has no first command');
30
+ }
31
+ return {
32
+ rawCommand,
33
+ tokens,
34
+ firstCommand,
35
+ pipelineStages,
36
+ envVars,
37
+ redirects,
38
+ };
39
+ }
40
+ export function isAllowed(cmd, allowlist) {
41
+ let parsed;
42
+ try {
43
+ parsed = parseBashCommand(cmd);
44
+ }
45
+ catch (error) {
46
+ const message = error instanceof Error ? error.message : 'parse failed';
47
+ return { allowed: false, reason: message };
48
+ }
49
+ if (parsed.firstCommand.length === 0) {
50
+ return { allowed: false, reason: 'missing first command' };
51
+ }
52
+ const allowedCommands = new Set(allowlist);
53
+ for (const stage of parsed.pipelineStages) {
54
+ const stageCommand = stage[0];
55
+ if (stageCommand === undefined || stageCommand.length === 0) {
56
+ return {
57
+ allowed: false,
58
+ reason: 'missing command in pipeline stage',
59
+ firstCommand: parsed.firstCommand,
60
+ };
61
+ }
62
+ if (!allowedCommands.has(stageCommand)) {
63
+ return {
64
+ allowed: false,
65
+ reason: `command not allowlisted: ${stageCommand}`,
66
+ firstCommand: parsed.firstCommand,
67
+ };
68
+ }
69
+ }
70
+ return { allowed: true, firstCommand: parsed.firstCommand };
71
+ }
72
+ function stripWrappers(cmd) {
73
+ let current = cmd.trim();
74
+ for (let depth = 0; depth < 8; depth += 1) {
75
+ const tokens = tokenize(current);
76
+ const first = tokens[0];
77
+ if (first === undefined) {
78
+ return current;
79
+ }
80
+ if (WRAPPER_COMMANDS.has(first)) {
81
+ const second = tokens[1];
82
+ const third = tokens[2];
83
+ if (second === '-c' && third !== undefined) {
84
+ current = third.trim();
85
+ continue;
86
+ }
87
+ }
88
+ if (first === 'eval') {
89
+ const inner = tokens.slice(1).join(' ').trim();
90
+ if (inner.length === 0) {
91
+ throw new Error('eval wrapper has no inner command');
92
+ }
93
+ current = inner;
94
+ continue;
95
+ }
96
+ return current;
97
+ }
98
+ throw new Error('too many nested shell wrappers');
99
+ }
100
+ function splitPipeline(command) {
101
+ const stages = [];
102
+ let current = '';
103
+ let quote = 'none';
104
+ let escaped = false;
105
+ for (let i = 0; i < command.length; i += 1) {
106
+ const ch = command[i];
107
+ if (ch === undefined) {
108
+ break;
109
+ }
110
+ if (escaped) {
111
+ current += ch;
112
+ escaped = false;
113
+ continue;
114
+ }
115
+ if (quote !== 'single' && ch === '\\') {
116
+ current += ch;
117
+ escaped = true;
118
+ continue;
119
+ }
120
+ if (quote === 'none' && ch === "'") {
121
+ current += ch;
122
+ quote = 'single';
123
+ continue;
124
+ }
125
+ if (quote === 'single' && ch === "'") {
126
+ current += ch;
127
+ quote = 'none';
128
+ continue;
129
+ }
130
+ if (quote === 'none' && ch === '"') {
131
+ current += ch;
132
+ quote = 'double';
133
+ continue;
134
+ }
135
+ if (quote === 'double' && ch === '"') {
136
+ current += ch;
137
+ quote = 'none';
138
+ continue;
139
+ }
140
+ if (quote === 'none') {
141
+ const next = command[i + 1];
142
+ const pair = next === undefined ? ch : `${ch}${next}`;
143
+ if (PIPELINE_SEPARATORS.has(pair)) {
144
+ pushStage(stages, current);
145
+ current = '';
146
+ i += 1;
147
+ continue;
148
+ }
149
+ if (PIPELINE_SEPARATORS.has(ch)) {
150
+ pushStage(stages, current);
151
+ current = '';
152
+ continue;
153
+ }
154
+ }
155
+ current += ch;
156
+ }
157
+ if (escaped) {
158
+ throw new Error('dangling escape in bash command');
159
+ }
160
+ if (quote !== 'none') {
161
+ throw new Error('unterminated quote in bash command');
162
+ }
163
+ pushStage(stages, current);
164
+ return stages;
165
+ }
166
+ function pushStage(stages, stage) {
167
+ const trimmed = stage.trim();
168
+ if (trimmed.length === 0) {
169
+ throw new Error('empty pipeline stage');
170
+ }
171
+ stages.push(trimmed);
172
+ }
173
+ function tokenize(input) {
174
+ const tokens = [];
175
+ let current = '';
176
+ let quote = 'none';
177
+ let escaped = false;
178
+ for (let i = 0; i < input.length; i += 1) {
179
+ const ch = input[i];
180
+ if (ch === undefined) {
181
+ break;
182
+ }
183
+ if (escaped) {
184
+ current += ch;
185
+ escaped = false;
186
+ continue;
187
+ }
188
+ if (quote !== 'single' && ch === '\\') {
189
+ escaped = true;
190
+ continue;
191
+ }
192
+ if (quote === 'none' && isWhitespace(ch)) {
193
+ pushToken(tokens, current);
194
+ current = '';
195
+ continue;
196
+ }
197
+ if (quote === 'none' && ch === "'") {
198
+ quote = 'single';
199
+ continue;
200
+ }
201
+ if (quote === 'single' && ch === "'") {
202
+ quote = 'none';
203
+ continue;
204
+ }
205
+ if (quote === 'none' && ch === '"') {
206
+ quote = 'double';
207
+ continue;
208
+ }
209
+ if (quote === 'double' && ch === '"') {
210
+ quote = 'none';
211
+ continue;
212
+ }
213
+ if (quote === 'none' && startsRedirect(input, i)) {
214
+ pushToken(tokens, current);
215
+ current = '';
216
+ const parsed = readRedirect(input, i);
217
+ tokens.push(parsed.token);
218
+ i = parsed.nextIndex - 1;
219
+ continue;
220
+ }
221
+ current += ch;
222
+ }
223
+ if (escaped) {
224
+ throw new Error('dangling escape in bash command');
225
+ }
226
+ if (quote !== 'none') {
227
+ throw new Error('unterminated quote in bash command');
228
+ }
229
+ pushToken(tokens, current);
230
+ return tokens;
231
+ }
232
+ function pushToken(tokens, token) {
233
+ if (token.length > 0) {
234
+ tokens.push(token);
235
+ }
236
+ }
237
+ function startsRedirect(input, index) {
238
+ const ch = input[index];
239
+ if (ch === undefined) {
240
+ return false;
241
+ }
242
+ if (ch === '>' || ch === '<') {
243
+ return true;
244
+ }
245
+ if (!isDigit(ch)) {
246
+ return false;
247
+ }
248
+ let cursor = index;
249
+ while (isDigit(input[cursor] ?? '')) {
250
+ cursor += 1;
251
+ }
252
+ const next = input[cursor];
253
+ return next === '>' || next === '<';
254
+ }
255
+ function readRedirect(input, index) {
256
+ let cursor = index;
257
+ let token = '';
258
+ while (isDigit(input[cursor] ?? '')) {
259
+ const digit = input[cursor];
260
+ if (digit === undefined) {
261
+ break;
262
+ }
263
+ token += digit;
264
+ cursor += 1;
265
+ }
266
+ const first = input[cursor];
267
+ if (first !== '>' && first !== '<') {
268
+ throw new Error('invalid redirect operator');
269
+ }
270
+ token += first;
271
+ cursor += 1;
272
+ const second = input[cursor];
273
+ const third = input[cursor + 1];
274
+ if (first === '>' && second === '>') {
275
+ token += second;
276
+ cursor += 1;
277
+ }
278
+ else if (first === '<' && second === '<' && third === '<') {
279
+ token += `${second}${third}`;
280
+ cursor += 2;
281
+ }
282
+ else if (first === '<' && second === '<') {
283
+ token += second;
284
+ cursor += 1;
285
+ }
286
+ else if ((first === '>' || first === '<') && second === '&') {
287
+ token += second;
288
+ cursor += 1;
289
+ }
290
+ else if (first === '>' && second === '|') {
291
+ token += second;
292
+ cursor += 1;
293
+ }
294
+ else if (first === '<' && second === '>') {
295
+ token += second;
296
+ cursor += 1;
297
+ }
298
+ while (true) {
299
+ const ch = input[cursor];
300
+ if (ch === undefined || isWhitespace(ch) || ch === '"' || ch === "'") {
301
+ break;
302
+ }
303
+ if (ch === '>' || ch === '<') {
304
+ break;
305
+ }
306
+ token += ch;
307
+ cursor += 1;
308
+ }
309
+ return { token, nextIndex: cursor };
310
+ }
311
+ function normalizeStage(rawTokens, envVars, redirects) {
312
+ const withoutEnv = [];
313
+ let commandStarted = false;
314
+ for (const token of rawTokens) {
315
+ if (!commandStarted && isEnvAssignment(token)) {
316
+ const parsed = parseEnvAssignment(token);
317
+ envVars[parsed.name] = parsed.value;
318
+ continue;
319
+ }
320
+ commandStarted = true;
321
+ withoutEnv.push(token);
322
+ }
323
+ const stage = [];
324
+ for (let i = 0; i < withoutEnv.length; i += 1) {
325
+ const token = withoutEnv[i];
326
+ if (token === undefined) {
327
+ continue;
328
+ }
329
+ if (isRedirectToken(token)) {
330
+ if (redirectNeedsOperand(token)) {
331
+ const target = withoutEnv[i + 1];
332
+ if (target === undefined || isRedirectToken(target)) {
333
+ throw new Error('redirect missing target');
334
+ }
335
+ redirects.push(`${token} ${target}`);
336
+ i += 1;
337
+ continue;
338
+ }
339
+ redirects.push(token);
340
+ continue;
341
+ }
342
+ stage.push(token);
343
+ }
344
+ return stage;
345
+ }
346
+ function isEnvAssignment(token) {
347
+ return /^[A-Za-z_][A-Za-z0-9_]*=.*$/u.test(token);
348
+ }
349
+ function parseEnvAssignment(token) {
350
+ const index = token.indexOf('=');
351
+ if (index < 1) {
352
+ throw new Error('invalid environment assignment');
353
+ }
354
+ return {
355
+ name: token.slice(0, index),
356
+ value: token.slice(index + 1),
357
+ };
358
+ }
359
+ function isRedirectToken(token) {
360
+ return /^(?:\d*)?(?:>>?|<|<<|<<<|>\||<>|>&|<&)(?:.+)?$/u.test(token);
361
+ }
362
+ function redirectNeedsOperand(token) {
363
+ return /^(?:\d*)?(?:>>?|<|<<|<<<|>\||<>|>&|<&)$/u.test(token);
364
+ }
365
+ function isWhitespace(ch) {
366
+ return ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r';
367
+ }
368
+ function isDigit(ch) {
369
+ return ch >= '0' && ch <= '9';
370
+ }
371
+ //# sourceMappingURL=bash-parser.js.map
@@ -0,0 +1,83 @@
1
+ /**
2
+ * bypassPermissions circuit-breaker — .
3
+ *
4
+ * `bypassPermissions` is "skip ALL checks" for trusted scripted runs.
5
+ * Even so, certain commands are catastrophic enough that the gate
6
+ * MUST refuse regardless of mode. This module owns that short list.
7
+ *
8
+ * The breaker is conservative on purpose:
9
+ * - rm -rf against `/`, `~`, or workspace root (`.`)
10
+ * - fork bomb signature (`:(){:|:&};:`)
11
+ * - dd if=/ (raw block-device read or write)
12
+ *
13
+ * False positives are acceptable here — an operator who really wants
14
+ * to nuke their root filesystem can switch to `dontAsk` and re-issue;
15
+ * the breaker is the "are you sure you typed this correctly?" guard,
16
+ * not a hard policy boundary.
17
+ *
18
+ * `evaluateCircuitBreaker` is pure regex matching — no IO, no state.
19
+ * It's called by the gate before any other routing so a bypass-mode
20
+ * session that types `rm -rf /` sees the deny path first.
21
+ */
22
+ /**
23
+ * Pattern list — kept narrow on purpose. Each entry must match the
24
+ * canonical destructive shape; argv variants without the exact form
25
+ * fall through к the regular `dontAsk` / `bypassPermissions` allow
26
+ * path, which is what the operator opted into.
27
+ */
28
+ const CIRCUIT_BREAKER_PATTERNS = [
29
+ // rm -rf against absolute root, $HOME, ~, $WORKSPACE_ROOT, or `.`
30
+ // with no further token. The negative lookahead на `[/~.]\S` makes
31
+ // sure `rm -rf /tmp/foo` (specific subtree) doesn't trip — only the
32
+ // catastrophic `rm -rf /` or `rm -rf ~` or `rm -rf .` shapes do.
33
+ {
34
+ pattern: /\brm\s+(-[a-z]*r[a-z]*f|-[a-z]*f[a-z]*r)\s+(\/|~|\$HOME|\$\{HOME\}|\.)\s*$/i,
35
+ reason: 'rm -rf against /, $HOME, ~, or workspace root',
36
+ },
37
+ // Fork bomb signature. Whitespace-tolerant но shape-strict.
38
+ {
39
+ pattern: /:\s*\(\s*\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;?\s*:/,
40
+ reason: 'fork bomb (`:(){ :|:& };:`)',
41
+ },
42
+ // dd to/from raw devices. Either direction is catastrophic enough
43
+ // to warrant the breaker (read of /dev/random into a workspace file
44
+ // can fill the disk, write to /dev/sda destroys the disk).
45
+ {
46
+ pattern: /\bdd\b[^|;&]*\b(if|of)=\/dev\//i,
47
+ reason: 'dd reading/writing /dev/* (catastrophic IO)',
48
+ },
49
+ // mkfs against any disk — single regex covers ext*, xfs, btrfs, vfat.
50
+ {
51
+ pattern: /\bmkfs(\.[a-z0-9]+)?\s+\/dev\//i,
52
+ reason: 'mkfs against /dev/* (filesystem format)',
53
+ },
54
+ ];
55
+ /**
56
+ * Test the command against every circuit-breaker pattern. Returns the
57
+ * first match (most-catastrophic-first ordering is encoded в the array
58
+ * order); when no pattern matches, the breaker is `tripped: false` so
59
+ * the caller proceeds to the regular gate decision.
60
+ *
61
+ * Pure function — no IO, no module-scoped state. Safe to call from any
62
+ * surface (gate, doctor command, audit replay).
63
+ */
64
+ export function evaluateCircuitBreaker(command) {
65
+ const trimmed = command.trim();
66
+ if (trimmed.length === 0)
67
+ return { tripped: false, reason: '' };
68
+ for (const entry of CIRCUIT_BREAKER_PATTERNS) {
69
+ if (entry.pattern.test(trimmed)) {
70
+ return { tripped: true, reason: entry.reason };
71
+ }
72
+ }
73
+ return { tripped: false, reason: '' };
74
+ }
75
+ /**
76
+ * Diagnostic accessor — exposed для doctor surfaces + spec coverage so
77
+ * the test layer can iterate the full list and assert each entry trips
78
+ * on representative input.
79
+ */
80
+ export function listCircuitBreakerPatterns() {
81
+ return CIRCUIT_BREAKER_PATTERNS.map((e) => ({ pattern: e.pattern.source, reason: e.reason }));
82
+ }
83
+ //# sourceMappingURL=circuit-breaker.js.map
@@ -0,0 +1,91 @@
1
+ import * as path from 'node:path';
2
+ const REGEX_META = new Set(['.', '+', '^', '$', '(', ')', '|', '{', '}', '[', ']', '\\']);
3
+ function globToRegExp(pattern) {
4
+ let re = '';
5
+ let i = 0;
6
+ while (i < pattern.length) {
7
+ const c = pattern[i];
8
+ if (c === '*') {
9
+ if (pattern[i + 1] === '*') {
10
+ re += '.*';
11
+ i += 2;
12
+ if (pattern[i] === '/')
13
+ i += 1;
14
+ }
15
+ else {
16
+ re += '[^/]*';
17
+ i += 1;
18
+ }
19
+ }
20
+ else if (c === '?') {
21
+ re += '[^/]';
22
+ i += 1;
23
+ }
24
+ else if (REGEX_META.has(c)) {
25
+ re += '\\' + c;
26
+ i += 1;
27
+ }
28
+ else {
29
+ re += c;
30
+ i += 1;
31
+ }
32
+ }
33
+ return new RegExp('^' + re + '$');
34
+ }
35
+ function toRelPosix(absPath, repoRoot) {
36
+ const normRoot = path.resolve(repoRoot);
37
+ const normPath = path.resolve(absPath);
38
+ const rel = path.relative(normRoot, normPath);
39
+ if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
40
+ return rel.startsWith('..') || path.isAbsolute(rel) ? null : rel;
41
+ }
42
+ return rel.split(path.sep).join('/');
43
+ }
44
+ export function isPathAllowed(absPath, repoRoot, allowlist) {
45
+ const rel = toRelPosix(absPath, repoRoot);
46
+ if (rel === null)
47
+ return false;
48
+ for (const pattern of allowlist) {
49
+ if (pattern === rel)
50
+ return true;
51
+ if (globToRegExp(pattern).test(rel))
52
+ return true;
53
+ }
54
+ return false;
55
+ }
56
+ const SHELL_OP_SPLIT = /\s*(?:&&|\|\||;|\|)\s*/;
57
+ const ENV_ASSIGN = /^[A-Za-z_][A-Za-z0-9_]*=/;
58
+ export function checkBashCommand(cmd, allowlist) {
59
+ const stages = cmd
60
+ .split(SHELL_OP_SPLIT)
61
+ .map((s) => s.trim())
62
+ .filter((s) => s.length > 0);
63
+ if (stages.length === 0) {
64
+ return { allowed: false, reason: 'empty command' };
65
+ }
66
+ for (const stage of stages) {
67
+ const tokens = stage.split(/\s+/);
68
+ let i = 0;
69
+ while (i < tokens.length && ENV_ASSIGN.test(tokens[i]))
70
+ i += 1;
71
+ const head = tokens[i];
72
+ if (!head) {
73
+ return { allowed: false, reason: `empty stage in command: '${stage}'` };
74
+ }
75
+ if (!allowlist.includes(head)) {
76
+ return { allowed: false, reason: `command '${head}' not in bash_allowlist` };
77
+ }
78
+ }
79
+ return { allowed: true };
80
+ }
81
+ export function verifyTouched(touchedPaths, repoRoot, allowlist) {
82
+ const violations = [];
83
+ for (const p of touchedPaths) {
84
+ const abs = path.isAbsolute(p) ? p : path.resolve(repoRoot, p);
85
+ if (!isPathAllowed(abs, repoRoot, allowlist)) {
86
+ violations.push(p);
87
+ }
88
+ }
89
+ return { ok: violations.length === 0, violations };
90
+ }
91
+ //# sourceMappingURL=constrained-edit.js.map