@pugi/cli 0.1.0-beta.8 → 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 +4151 -489
  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,70 @@
1
+ const isQuiescent = (state) => state.readTasks === 0 && !state.writeTaskActive;
2
+ export const MODE_TRANSITIONS = [
3
+ { from: 'idle', to: 'research', trigger: 'plan', guard: isQuiescent },
4
+ { from: 'research', to: 'synth', trigger: 'synthesize', guard: isQuiescent },
5
+ { from: 'synth', to: 'impl', trigger: 'execute', guard: isQuiescent },
6
+ { from: 'impl', to: 'review', trigger: 'verify', guard: isQuiescent },
7
+ { from: 'review', to: 'done', trigger: 'accept', guard: isQuiescent },
8
+ { from: 'review', to: 'impl', trigger: 'fix', guard: isQuiescent },
9
+ { from: 'idle', to: 'idle', trigger: 'reset' },
10
+ { from: 'research', to: 'idle', trigger: 'reset' },
11
+ { from: 'synth', to: 'idle', trigger: 'reset' },
12
+ { from: 'impl', to: 'idle', trigger: 'reset' },
13
+ { from: 'review', to: 'idle', trigger: 'reset' },
14
+ { from: 'done', to: 'idle', trigger: 'reset' },
15
+ ];
16
+ class CoordinatorModeFSM {
17
+ state;
18
+ constructor(initial = 'idle') {
19
+ this.state = {
20
+ mode: initial,
21
+ enteredAt: Date.now(),
22
+ readTasks: 0,
23
+ writeTaskActive: false,
24
+ };
25
+ }
26
+ current() {
27
+ return { ...this.state };
28
+ }
29
+ trigger(event) {
30
+ const transition = MODE_TRANSITIONS.find((candidate) => candidate.from === this.state.mode && candidate.trigger === event);
31
+ if (!transition) {
32
+ return {
33
+ ok: false,
34
+ reason: `No transition for event '${event}' from mode '${this.state.mode}'.`,
35
+ };
36
+ }
37
+ if (transition.guard && !transition.guard(this.current())) {
38
+ return {
39
+ ok: false,
40
+ reason: `Guard blocked event '${event}' from mode '${this.state.mode}'.`,
41
+ };
42
+ }
43
+ this.state = {
44
+ ...this.state,
45
+ mode: transition.to,
46
+ enteredAt: Date.now(),
47
+ };
48
+ return { ok: true };
49
+ }
50
+ beginRead() {
51
+ this.state.readTasks += 1;
52
+ }
53
+ endRead() {
54
+ this.state.readTasks = Math.max(0, this.state.readTasks - 1);
55
+ }
56
+ beginWrite() {
57
+ if (this.state.writeTaskActive) {
58
+ return { ok: false, reason: 'A write task is already active.' };
59
+ }
60
+ this.state.writeTaskActive = true;
61
+ return { ok: true };
62
+ }
63
+ endWrite() {
64
+ this.state.writeTaskActive = false;
65
+ }
66
+ }
67
+ export function createFSM(initial) {
68
+ return new CoordinatorModeFSM(initial);
69
+ }
70
+ //# sourceMappingURL=mode-fsm.js.map
@@ -0,0 +1,129 @@
1
+ /**
2
+ * Rate card for the `pugi cost` / `/cost` / `/usage` surface — L19 sprint.
3
+ *
4
+ * Distinct from `core/repl/model-pricing.ts` on purpose:
5
+ *
6
+ * - `model-pricing.ts` powers the TUI cost meter (per-turn flash, status
7
+ * row USD). Its ladder is keyed against the live Anvil model slugs and
8
+ * intentionally inflates an honest worst-case figure via the Sonnet
9
+ * fallback so an operator on a quiet model never gets billed by a
10
+ * surprise. It rounds to USD per 1M tokens at runtime.
11
+ *
12
+ * - `rate-card.ts` (this file) powers the persisted `/cost` table the
13
+ * operator reads to plan budget. It distinguishes open-weight models
14
+ * ($0 / $0 — infra cost only) from hosted closed models so the table
15
+ * does not double-charge an operator running a self-hosted Qwen or
16
+ * Kimi behind Pugi. The L19 spec calls these out by name.
17
+ *
18
+ * Both ladders intentionally agree on Anthropic Claude family pricing so
19
+ * the TUI flash and the persisted table cannot disagree on a Claude turn.
20
+ * If they diverge, the per-model-pricing ladder wins for live UI; the
21
+ * rate card here wins for the persisted `.pugi/cost.json` aggregate.
22
+ *
23
+ * Prices are USD per 1,000,000 tokens, sourced from the L19 spec
24
+ * which mirrors provider list-price pages as of that date.
25
+ */
26
+ /**
27
+ * Exact-match price ladder keyed by model slug. Slugs match the L19 task
28
+ * spec verbatim so a copy-paste from the sprint doc resolves without
29
+ * normalisation.
30
+ */
31
+ export const RATES_PER_MTOKEN = Object.freeze({
32
+ // Anthropic Claude family (hosted, billed).
33
+ 'claude-opus-4-7': { input: 15, output: 75 },
34
+ 'claude-opus-4-6': { input: 15, output: 75 },
35
+ 'claude-sonnet-4-6': { input: 3, output: 15 },
36
+ 'claude-sonnet-4-5': { input: 3, output: 15 },
37
+ 'claude-haiku-4-5-20251001': { input: 1, output: 5 },
38
+ 'claude-haiku-4-5': { input: 1, output: 5 },
39
+ // Open-weight models — infra cost only, never per-token billed. The
40
+ // note column surfaces the reason so a CFO reading the JSON envelope
41
+ // does not assume the row is broken.
42
+ 'qwen3-coder-480b-instruct-fp8': { input: 0, output: 0, note: 'open-weight' },
43
+ 'kimi-k2.6': { input: 0, output: 0, note: 'open-weight' },
44
+ 'deepseek-v4-pro': { input: 0, output: 0, note: 'open-weight' },
45
+ });
46
+ /**
47
+ * Family-prefix fallback — used only when an exact slug miss. Mirrors the
48
+ * approach in `model-pricing.ts` so a future model rebind (e.g.
49
+ * `claude-opus-4-8`) prices reasonably without a code edit.
50
+ */
51
+ const FAMILY_FALLBACKS = [
52
+ ['claude-opus-', { input: 15, output: 75 }],
53
+ ['claude-sonnet-', { input: 3, output: 15 }],
54
+ ['claude-haiku-', { input: 1, output: 5 }],
55
+ ['qwen', { input: 0, output: 0, note: 'open-weight' }],
56
+ ['kimi', { input: 0, output: 0, note: 'open-weight' }],
57
+ ['deepseek', { input: 0, output: 0, note: 'open-weight' }],
58
+ ];
59
+ /**
60
+ * Final fallback for unknown slugs. Pinned to Sonnet-tier — same posture
61
+ * as `model-pricing.ts`'s default, so an unrecognised hosted model bills
62
+ * "honestly conservative" rather than $0 (which would silently hide cost
63
+ * from the operator).
64
+ */
65
+ const DEFAULT_RATE = { input: 3, output: 15, note: 'unknown model — Sonnet-tier estimate' };
66
+ /**
67
+ * Look up the rate for a model slug.
68
+ *
69
+ * Resolution order:
70
+ * 1. Exact match in `RATES_PER_MTOKEN`.
71
+ * 2. Family-prefix match (first hit wins).
72
+ * 3. Default Sonnet-tier estimate.
73
+ *
74
+ * Pure, never throws. Called on every cost-tracker write so the hot path
75
+ * stays branch-cheap.
76
+ */
77
+ export function rateFor(model) {
78
+ if (!model || typeof model !== 'string')
79
+ return DEFAULT_RATE;
80
+ const exact = RATES_PER_MTOKEN[model];
81
+ if (exact)
82
+ return exact;
83
+ for (const [prefix, rate] of FAMILY_FALLBACKS) {
84
+ if (model.startsWith(prefix))
85
+ return rate;
86
+ }
87
+ return DEFAULT_RATE;
88
+ }
89
+ /**
90
+ * Compute the USD cost for a single (model, inputTokens, outputTokens)
91
+ * triple. Defensive against negative / NaN inputs — out-of-range values
92
+ * floor to zero so a buggy upstream cannot credit a negative cost.
93
+ */
94
+ export function estimateUsd(model, inputTokens, outputTokens) {
95
+ const rate = rateFor(model);
96
+ const safeIn = Number.isFinite(inputTokens) && inputTokens > 0 ? inputTokens : 0;
97
+ const safeOut = Number.isFinite(outputTokens) && outputTokens > 0 ? outputTokens : 0;
98
+ const usd = (safeIn * rate.input + safeOut * rate.output) / 1_000_000;
99
+ return Number.isFinite(usd) && usd > 0 ? usd : 0;
100
+ }
101
+ /**
102
+ * Format a USD figure for the `/cost` table.
103
+ *
104
+ * - `≥ $0.01` → two decimals (`$0.46`).
105
+ * - `< $0.01` but `> 0` → three decimals (`$0.003`) so fractions of a
106
+ * cent are honest instead of rounding to `$0.00`.
107
+ * - Exactly `0` or NaN → `$0.00`.
108
+ *
109
+ * Mirrors `formatCostUsd` from `model-pricing.ts` intentionally — both
110
+ * surfaces should print the same number in the same shape.
111
+ */
112
+ export function formatUsd(value) {
113
+ if (!Number.isFinite(value) || value <= 0)
114
+ return '$0.00';
115
+ if (value >= 0.01)
116
+ return `$${value.toFixed(2)}`;
117
+ return `$${value.toFixed(3)}`;
118
+ }
119
+ /**
120
+ * Format a token count for the `/cost` table. Uses comma-thousands so the
121
+ * table reads `14,300` instead of `14.3k` — distinct from the TUI status
122
+ * row which uses `k`/`m` shortening to save column width.
123
+ */
124
+ export function formatTokensWithCommas(value) {
125
+ if (!Number.isFinite(value) || value <= 0)
126
+ return '0';
127
+ return Math.floor(value).toLocaleString('en-US');
128
+ }
129
+ //# sourceMappingURL=rate-card.js.map
@@ -0,0 +1,221 @@
1
+ /**
2
+ * Persisted per-session cost tracker — L19 sprint .
3
+ *
4
+ * Mission: every Anvil-mediated LLM call goes through `recordCall`, which
5
+ * aggregates per-model token + USD totals and atomically persists them
6
+ * to `.pugi/cost.json` so the operator can read `/cost` across REPL
7
+ * restarts and reconcile a 14-min session that crossed a process boundary.
8
+ *
9
+ * Why a fresh module instead of bolting onto `core/repl/session.ts`?
10
+ *
11
+ * - `session.ts` accumulates in-memory state for the live TUI status
12
+ * row, which is by-design ephemeral and cleared on REPL boot. The
13
+ * operator's "what did I spend across the project?" question needs
14
+ * a durable surface that survives a process restart.
15
+ * - L19 also has to read `--all-sessions` (last 30 days). The natural
16
+ * store for that is a per-workspace history of session aggregates,
17
+ * which is easy with the JSON file pattern below and would be
18
+ * awkward stitched into the REPL reducer.
19
+ *
20
+ * On-disk shape (single JSON file, atomic tmp+rename writes):
21
+ *
22
+ * {
23
+ * "version": 1,
24
+ * "current": { sessionId, startedAt, models: { <slug>: ModelEntry } },
25
+ * "history": [
26
+ * { sessionId, startedAt, endedAt, models: { ... } }
27
+ * ]
28
+ * }
29
+ *
30
+ * History rotation: when `recordCall` is invoked with a sessionId
31
+ * different from `current.sessionId`, the existing `current` row is
32
+ * stamped with `endedAt = now()` and pushed onto `history`, then a new
33
+ * `current` row is initialised. History is capped at 90 entries (the L19
34
+ * `--all-sessions` window is 30 days; 90 gives a generous buffer for
35
+ * operators on >1 session/day cadence without unbounded growth).
36
+ *
37
+ * The tracker is workspace-scoped — every workspace has its own
38
+ * `.pugi/cost.json`. This matches the existing `.pugi/events.jsonl` /
39
+ * `.pugi/index.json` pattern and means a multi-repo operator's costs
40
+ * are billed against the repo they were incurred in.
41
+ */
42
+ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, unlinkSync } from 'node:fs';
43
+ import { dirname, resolve } from 'node:path';
44
+ import { estimateUsd } from './rate-card.js';
45
+ /** On-disk schema version. Bump if the file shape changes. */
46
+ export const COST_FILE_SCHEMA_VERSION = 1;
47
+ /** Maximum number of historical sessions persisted in `.pugi/cost.json`. */
48
+ export const COST_HISTORY_CAP = 90;
49
+ export function createCostTracker(opts) {
50
+ const filePath = resolve(opts.workspaceRoot, '.pugi/cost.json');
51
+ const now = opts.now ?? Date.now;
52
+ let state = readOrInit(filePath);
53
+ function ensureCurrent(sessionId) {
54
+ if (state.current && state.current.sessionId === sessionId) {
55
+ return state.current;
56
+ }
57
+ // Session rotation: stamp the previous current with endedAt and push
58
+ // onto history. Idempotent — calling rotate twice with the same
59
+ // session id is a no-op.
60
+ if (state.current) {
61
+ const ended = {
62
+ ...state.current,
63
+ endedAt: new Date(now()).toISOString(),
64
+ };
65
+ state.history = [ended, ...state.history].slice(0, COST_HISTORY_CAP);
66
+ }
67
+ state.current = {
68
+ sessionId,
69
+ startedAt: new Date(now()).toISOString(),
70
+ models: {},
71
+ };
72
+ return state.current;
73
+ }
74
+ function persist() {
75
+ try {
76
+ mkdirSync(dirname(filePath), { recursive: true });
77
+ }
78
+ catch {
79
+ // best-effort directory create; the write below surfaces the real
80
+ // error if the parent is genuinely unwritable
81
+ }
82
+ const tmp = `${filePath}.tmp`;
83
+ writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf8');
84
+ renameSync(tmp, filePath);
85
+ }
86
+ return {
87
+ recordCall(input) {
88
+ const sessionId = opts.sessionIdProvider();
89
+ if (!sessionId)
90
+ return;
91
+ const current = ensureCurrent(sessionId);
92
+ const slug = typeof input.model === 'string' && input.model.length > 0 ? input.model : 'unknown';
93
+ const safeIn = Number.isFinite(input.inputTokens) && input.inputTokens > 0 ? input.inputTokens : 0;
94
+ const safeOut = Number.isFinite(input.outputTokens) && input.outputTokens > 0 ? input.outputTokens : 0;
95
+ const existing = current.models[slug] ?? { input: 0, output: 0, callCount: 0 };
96
+ current.models[slug] = {
97
+ input: existing.input + safeIn,
98
+ output: existing.output + safeOut,
99
+ callCount: existing.callCount + 1,
100
+ };
101
+ persist();
102
+ },
103
+ current() {
104
+ return state.current;
105
+ },
106
+ history() {
107
+ return state.history;
108
+ },
109
+ aggregateWithin(withinDays) {
110
+ const cutoffMs = now() - withinDays * 24 * 60 * 60 * 1000;
111
+ const aggregate = {
112
+ sessionId: 'aggregate',
113
+ startedAt: new Date(cutoffMs).toISOString(),
114
+ endedAt: new Date(now()).toISOString(),
115
+ models: {},
116
+ };
117
+ const rows = [];
118
+ if (state.current)
119
+ rows.push(state.current);
120
+ for (const row of state.history) {
121
+ const stamp = Date.parse(row.startedAt);
122
+ if (Number.isFinite(stamp) && stamp >= cutoffMs)
123
+ rows.push(row);
124
+ }
125
+ for (const row of rows) {
126
+ for (const [slug, entry] of Object.entries(row.models)) {
127
+ const existing = aggregate.models[slug] ?? { input: 0, output: 0, callCount: 0 };
128
+ aggregate.models[slug] = {
129
+ input: existing.input + entry.input,
130
+ output: existing.output + entry.output,
131
+ callCount: existing.callCount + entry.callCount,
132
+ };
133
+ }
134
+ }
135
+ return aggregate;
136
+ },
137
+ resetCurrent() {
138
+ const wiped = state.current;
139
+ state.current = null;
140
+ persist();
141
+ return wiped;
142
+ },
143
+ flush() {
144
+ persist();
145
+ },
146
+ };
147
+ }
148
+ /**
149
+ * Compute the per-session USD total from a `SessionAggregate`. Pure —
150
+ * uses the rate card to bind a price to every model entry. Open-weight
151
+ * models contribute $0 (their entries always have $0/$0 rate).
152
+ */
153
+ export function totalUsd(aggregate) {
154
+ let total = 0;
155
+ for (const [slug, entry] of Object.entries(aggregate.models)) {
156
+ total += estimateUsd(slug, entry.input, entry.output);
157
+ }
158
+ return total;
159
+ }
160
+ /**
161
+ * Compute total input + output token sums across all models in an
162
+ * aggregate. Used by the CLI table footer.
163
+ */
164
+ export function totalTokens(aggregate) {
165
+ let input = 0;
166
+ let output = 0;
167
+ for (const entry of Object.values(aggregate.models)) {
168
+ input += entry.input;
169
+ output += entry.output;
170
+ }
171
+ return { input, output };
172
+ }
173
+ /**
174
+ * Read the persisted file (or initialise an empty one). Tolerates a
175
+ * corrupted file by returning a fresh empty state — losing one
176
+ * session's history is preferable to throwing from the boot path of
177
+ * every `pugi cost` invocation.
178
+ */
179
+ function readOrInit(filePath) {
180
+ if (!existsSync(filePath)) {
181
+ return { version: COST_FILE_SCHEMA_VERSION, current: null, history: [] };
182
+ }
183
+ try {
184
+ const raw = readFileSync(filePath, 'utf8');
185
+ const parsed = JSON.parse(raw);
186
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
187
+ return { version: COST_FILE_SCHEMA_VERSION, current: null, history: [] };
188
+ }
189
+ const obj = parsed;
190
+ return {
191
+ version: typeof obj.version === 'number' ? obj.version : COST_FILE_SCHEMA_VERSION,
192
+ current: isAggregate(obj.current) ? obj.current : null,
193
+ history: Array.isArray(obj.history) ? obj.history.filter(isAggregate) : [],
194
+ };
195
+ }
196
+ catch {
197
+ return { version: COST_FILE_SCHEMA_VERSION, current: null, history: [] };
198
+ }
199
+ }
200
+ function isAggregate(v) {
201
+ if (!v || typeof v !== 'object' || Array.isArray(v))
202
+ return false;
203
+ const obj = v;
204
+ if (typeof obj.sessionId !== 'string' || typeof obj.startedAt !== 'string')
205
+ return false;
206
+ if (!obj.models || typeof obj.models !== 'object')
207
+ return false;
208
+ return true;
209
+ }
210
+ /**
211
+ * Test helper — wipe the `.pugi/cost.json` file. Not exported through the
212
+ * public CostTracker surface because production code must never call
213
+ * this; an operator-facing reset goes through `resetCurrent()` which
214
+ * preserves history.
215
+ */
216
+ export function _danger_wipeCostFile_forTests(workspaceRoot) {
217
+ const filePath = resolve(workspaceRoot, '.pugi/cost.json');
218
+ if (existsSync(filePath))
219
+ unlinkSync(filePath);
220
+ }
221
+ //# sourceMappingURL=tracker.js.map
@@ -207,11 +207,11 @@ export function loadApiKey(apiUrl, home = homedir()) {
207
207
  }
208
208
  export function resolveActiveCredential(env = process.env, home = homedir()) {
209
209
  // Resolve the active apiUrl with this precedence:
210
- // 1. PUGI_API_URL env (lets CI / self-hosted users force a specific endpoint)
211
- // 2. credentials.json `activeApiUrl` (set by `pugi login` to the host the
212
- // user most recently authenticated against — covers self-hosted Anvil
213
- // without re-exporting env between commands)
214
- // 3. DEFAULT_API_URL (`https://api.pugi.io`)
210
+ // 1. PUGI_API_URL env (lets CI / self-hosted users force a specific endpoint)
211
+ // 2. credentials.json `activeApiUrl` (set by `pugi login` to the host the
212
+ // user most recently authenticated against — covers self-hosted Anvil
213
+ // without re-exporting env between commands)
214
+ // 3. DEFAULT_API_URL (`https://api.pugi.io`)
215
215
  const file = readCredentialsFile(home);
216
216
  const apiUrl = normalizeApiUrl(env.PUGI_API_URL ?? file.activeApiUrl ?? DEFAULT_API_URL);
217
217
  if (env.PUGI_API_KEY) {
@@ -238,10 +238,10 @@ export function resolveActiveCredential(env = process.env, home = homedir()) {
238
238
  * re-export PUGI_API_URL between commands.
239
239
  *
240
240
  * Match precedence:
241
- * 1. exact `label` match (case-insensitive, label is user-chosen so
242
- * we forgive casing — same convention as `gh auth switch`)
243
- * 2. exact `apiUrl` match (canonicalised) — lets `pugi accounts
244
- * switch https://api.acme.com` work without a label.
241
+ * 1. exact `label` match (case-insensitive, label is user-chosen so
242
+ * we forgive casing — same convention as `gh auth switch`)
243
+ * 2. exact `apiUrl` match (canonicalised) — lets `pugi accounts
244
+ * switch https://api.acme.com` work without a label.
245
245
  *
246
246
  * Returns the now-active record, or null when nothing matched.
247
247
  */
@@ -311,9 +311,9 @@ export function listStoredCredentials(home = homedir()) {
311
311
  /**
312
312
  * Canonicalize an apiUrl so two equivalent inputs always resolve to the
313
313
  * same record:
314
- * - lowercase scheme + host (URL spec: scheme/host are case-insensitive)
315
- * - strip trailing slashes
316
- * - preserve path/query/fragment case (those ARE case-sensitive)
314
+ * - lowercase scheme + host (URL spec: scheme/host are case-insensitive)
315
+ * - strip trailing slashes
316
+ * - preserve path/query/fragment case (those ARE case-sensitive)
317
317
  *
318
318
  * Falls back to the trimmed input when the URL is not parseable, so a
319
319
  * caller that manages to pass a non-URL string still sees a stable key
@@ -0,0 +1,138 @@
1
+ /**
2
+ * Cron scheduler primitive .
3
+ *
4
+ * Wraps `node-cron` (4.2.1, MIT, ~4M weekly downloads) — the de-facto
5
+ * Node cron scheduler. We do NOT parse cron expressions ourselves;
6
+ * node-cron handles validation, timezone math, и DST edge cases.
7
+ *
8
+ * What this module adds:
9
+ * - Named job registry (schedule/cancel/list by name)
10
+ * - Concurrency guard — a still-running job is skipped, not stacked,
11
+ * when the next tick fires (prevents overlap when an action runs
12
+ * longer than the cron period)
13
+ * - Stats per job: scheduled, lastRunAt, lastDurationMs, failures
14
+ *
15
+ * Pure-ish: state lives в the CronScheduler instance, no globals.
16
+ * Tool surface (ScheduleCronTool / CronList / CronDelete) wires this
17
+ * primitive into the engine в a separate PR.
18
+ */
19
+ import cron from 'node-cron';
20
+ export class CronScheduler {
21
+ jobs = new Map();
22
+ /**
23
+ * Register a cron job. Replaces any prior job at the same name —
24
+ * the previous one is stopped и destroyed first.
25
+ *
26
+ * Throws `RangeError` when `expression` is invalid per node-cron's
27
+ * parser. The error originates from node-cron and bubbles unchanged.
28
+ */
29
+ schedule(name, expression, action, options = {}) {
30
+ if (!name)
31
+ throw new TypeError('cron job name must be non-empty');
32
+ if (!cron.validate(expression)) {
33
+ throw new RangeError(`invalid cron expression: ${expression}`);
34
+ }
35
+ const existing = this.jobs.get(name);
36
+ if (existing) {
37
+ existing.task.stop();
38
+ }
39
+ const internal = {
40
+ task: undefined,
41
+ expression,
42
+ scheduledAt: Date.now(),
43
+ lastRunAt: null,
44
+ lastDurationMs: null,
45
+ runs: 0,
46
+ failures: 0,
47
+ running: false,
48
+ };
49
+ const wrapped = async () => {
50
+ // Concurrency guard: if previous invocation still running, skip.
51
+ // Stacking would tie up the event loop с long-running actions.
52
+ if (internal.running)
53
+ return;
54
+ internal.running = true;
55
+ const start = Date.now();
56
+ try {
57
+ await action();
58
+ internal.runs += 1;
59
+ }
60
+ catch {
61
+ internal.failures += 1;
62
+ }
63
+ finally {
64
+ internal.lastRunAt = start;
65
+ internal.lastDurationMs = Date.now() - start;
66
+ internal.running = false;
67
+ }
68
+ };
69
+ const scheduleOptions = {};
70
+ if (options.timezone !== undefined) {
71
+ scheduleOptions.timezone = options.timezone;
72
+ }
73
+ internal.task = cron.schedule(expression, wrapped, scheduleOptions);
74
+ this.jobs.set(name, internal);
75
+ if (options.runOnRegister) {
76
+ // Don't await — register is sync from the caller's perspective
77
+ void wrapped();
78
+ }
79
+ }
80
+ /** Cancel + drop a job by name. Returns true когда removed, false absent. */
81
+ cancel(name) {
82
+ const job = this.jobs.get(name);
83
+ if (!job)
84
+ return false;
85
+ job.task.stop();
86
+ this.jobs.delete(name);
87
+ return true;
88
+ }
89
+ /** Stop + drop ALL jobs. Safe to call on an empty scheduler. */
90
+ cancelAll() {
91
+ for (const job of this.jobs.values()) {
92
+ job.task.stop();
93
+ }
94
+ this.jobs.clear();
95
+ }
96
+ /** Snapshot of all registered jobs. Sorted by name for stable output. */
97
+ list() {
98
+ const out = [];
99
+ for (const [name, job] of this.jobs) {
100
+ out.push({
101
+ name,
102
+ expression: job.expression,
103
+ scheduledAt: job.scheduledAt,
104
+ lastRunAt: job.lastRunAt,
105
+ lastDurationMs: job.lastDurationMs,
106
+ runs: job.runs,
107
+ failures: job.failures,
108
+ running: job.running,
109
+ });
110
+ }
111
+ return out.sort((a, b) => a.name.localeCompare(b.name));
112
+ }
113
+ /** Lookup a single job's stats. Returns null when absent. */
114
+ stats(name) {
115
+ const job = this.jobs.get(name);
116
+ if (!job)
117
+ return null;
118
+ return {
119
+ name,
120
+ expression: job.expression,
121
+ scheduledAt: job.scheduledAt,
122
+ lastRunAt: job.lastRunAt,
123
+ lastDurationMs: job.lastDurationMs,
124
+ runs: job.runs,
125
+ failures: job.failures,
126
+ running: job.running,
127
+ };
128
+ }
129
+ }
130
+ /**
131
+ * Standalone helper для callers that only want one-off validation
132
+ * without creating a scheduler. Mirrors node-cron's `validate()` so
133
+ * callers don't need to import node-cron directly.
134
+ */
135
+ export function isValidCronExpression(expression) {
136
+ return cron.validate(expression);
137
+ }
138
+ //# sourceMappingURL=scheduler.js.map
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Public re-exports for the denial-tracking surface. Engine adapter
3
+ * code imports from here so we can move internals around (e.g. split
4
+ * the diagnostics probe into a sibling file) without churning every
5
+ * call site.
6
+ */
7
+ export { DenialTrackingState, buildDenialContext, canonicalArgHash, DENIAL_TRACKING_MAX_ENTRIES, DENIAL_REMINDER_THRESHOLD, DENIAL_ARGS_SUMMARY_BYTES, } from './state.js';
8
+ //# sourceMappingURL=index.js.map