@pugi/cli 0.1.0-beta.8 → 0.1.0-beta.88
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.
- package/CHANGELOG.md +132 -0
- package/LICENSE +1 -1
- package/THIRD_PARTY_NOTICES.md +40 -0
- package/assets/pugi-prozr2-mascot.ansi +9 -0
- package/bin/run.js +33 -1
- package/dist/commands/deploy.js +40 -40
- package/dist/commands/flatten.js +191 -0
- package/dist/commands/jobs-watch.js +201 -0
- package/dist/commands/jobs.js +42 -27
- package/dist/commands/smoke.js +133 -0
- package/dist/core/agent-progress/cleanup.js +134 -0
- package/dist/core/agent-progress/schema.js +144 -0
- package/dist/core/agent-progress/writer.js +101 -0
- package/dist/core/agents/adaptive-router.js +330 -0
- package/dist/core/agents/query-decomposer.js +297 -0
- package/dist/core/agents/registry.js +3 -3
- package/dist/core/approvals/shortcut-resolver.js +98 -0
- package/dist/core/artifact-chain/dispatcher.js +148 -0
- package/dist/core/artifact-chain/exporter.js +164 -0
- package/dist/core/artifact-chain/state.js +243 -0
- package/dist/core/artifact-chain/steps.js +169 -0
- package/dist/core/ask-user/question.js +92 -0
- package/dist/core/audit/audit-trail.js +275 -0
- package/dist/core/auth/ensure-authenticated.js +129 -0
- package/dist/core/auth/env-provider.js +238 -0
- package/dist/core/auto-open-browser.js +4 -4
- package/dist/core/auto-update/channels.js +122 -0
- package/dist/core/auto-update/checker.js +241 -0
- package/dist/core/auto-update/state.js +235 -0
- package/dist/core/bare-mode/index.js +107 -0
- package/dist/core/bash/redirect.js +281 -0
- package/dist/core/bash-classifier.js +436 -40
- package/dist/core/checkpoint/resumer.js +149 -0
- package/dist/core/checkpoint/rewinder.js +291 -0
- package/dist/core/checkpoints/shadow-git.js +670 -0
- package/dist/core/citations/parser.js +109 -0
- package/dist/core/classifier/yolo-classifier.js +88 -0
- package/dist/core/codegraph/decision-store.js +248 -0
- package/dist/core/codegraph/detect-repo.js +459 -0
- package/dist/core/codegraph/install.js +134 -0
- package/dist/core/codegraph/offer-hook.js +220 -0
- package/dist/core/compact/auto-trigger.js +96 -0
- package/dist/core/compact/buffer-rewriter.js +115 -0
- package/dist/core/compact/summarizer.js +208 -0
- package/dist/core/compact/token-counter.js +108 -0
- package/dist/core/consensus/anvil-fanout.js +25 -25
- package/dist/core/consensus/diff-capture.js +121 -12
- package/dist/core/consensus/rubric.js +21 -21
- package/dist/core/context/builder.js +6 -6
- package/dist/core/context/compaction-events.js +8 -8
- package/dist/core/context/compaction.js +31 -31
- package/dist/core/context/index.js +15 -8
- package/dist/core/context/invariants.js +51 -51
- package/dist/core/context/markdown-loader.js +28 -10
- package/dist/core/context/markdown-traverse.js +255 -0
- package/dist/core/context/pugiignore.js +41 -41
- package/dist/core/context/repo-skeleton.js +37 -37
- package/dist/core/context/tool-eviction.js +55 -0
- package/dist/core/context/watcher.js +32 -32
- package/dist/core/context/working-set.js +23 -23
- package/dist/core/coordinator/agent-tools.js +77 -0
- package/dist/core/coordinator/agent-toolset.js +65 -0
- package/dist/core/coordinator/fsm.js +73 -0
- package/dist/core/coordinator/mode-fsm.js +70 -0
- package/dist/core/cost/rate-card.js +129 -0
- package/dist/core/cost/tracker.js +221 -0
- package/dist/core/credentials.js +12 -12
- package/dist/core/cron/scheduler.js +138 -0
- package/dist/core/denial-tracking/index.js +8 -0
- package/dist/core/denial-tracking/state.js +264 -0
- package/dist/core/diagnostics/probe-runner.js +93 -0
- package/dist/core/diagnostics/probes/api.js +46 -0
- package/dist/core/diagnostics/probes/auth.js +93 -0
- package/dist/core/diagnostics/probes/bare-mode.js +42 -0
- package/dist/core/diagnostics/probes/cli-version.js +127 -0
- package/dist/core/diagnostics/probes/config.js +72 -0
- package/dist/core/diagnostics/probes/denial-tracking.js +57 -0
- package/dist/core/diagnostics/probes/disk.js +81 -0
- package/dist/core/diagnostics/probes/engine-live.js +46 -0
- package/dist/core/diagnostics/probes/git.js +65 -0
- package/dist/core/diagnostics/probes/hooks.js +118 -0
- package/dist/core/diagnostics/probes/mcp.js +75 -0
- package/dist/core/diagnostics/probes/node.js +59 -0
- package/dist/core/diagnostics/probes/pnpm.js +36 -0
- package/dist/core/diagnostics/probes/pugi-md.js +89 -0
- package/dist/core/diagnostics/probes/sandbox.js +40 -0
- package/dist/core/diagnostics/probes/session.js +74 -0
- package/dist/core/diagnostics/probes/status-snapshot.js +488 -0
- package/dist/core/diagnostics/probes/workspace.js +63 -0
- package/dist/core/diagnostics/types.js +70 -0
- package/dist/core/dispatch/cache-cleanup.js +197 -0
- package/dist/core/dispatch/cache-handoff.js +295 -0
- package/dist/core/edits/apply-patch-layer-e.js +189 -0
- package/dist/core/edits/dispatch.js +293 -7
- package/dist/core/edits/format-matrix.js +26 -0
- package/dist/core/edits/fuzzy-ladder.js +650 -0
- package/dist/core/edits/index.js +3 -1
- package/dist/core/edits/journal.js +199 -0
- package/dist/core/edits/layer-a-apply.js +15 -15
- package/dist/core/edits/layer-a-fuzzy-apply.js +198 -0
- package/dist/core/edits/layer-b-apply.js +9 -9
- package/dist/core/edits/layer-c-apply.js +6 -6
- package/dist/core/edits/layer-d-ast.js +557 -14
- package/dist/core/edits/marker-parser.js +12 -12
- package/dist/core/edits/security-gate.js +27 -27
- package/dist/core/edits/verify-hook.js +273 -0
- package/dist/core/edits/worktree.js +322 -0
- package/dist/core/engine/anvil-client.js +151 -26
- package/dist/core/engine/auto-compact.js +179 -0
- package/dist/core/engine/budgets.js +186 -0
- package/dist/core/engine/context-prefix.js +155 -0
- package/dist/core/engine/index.js +1 -1
- package/dist/core/engine/intensity.js +158 -0
- package/dist/core/engine/intent.js +260 -0
- package/dist/core/engine/native-pugi.js +1295 -227
- package/dist/core/engine/prompts.js +134 -16
- package/dist/core/engine/strip-internal-fields.js +124 -0
- package/dist/core/engine/tool-bridge.js +1295 -59
- package/dist/core/evaluation/golden-dataset.js +293 -0
- package/dist/core/feedback/queue.js +177 -0
- package/dist/core/feedback/submitter.js +145 -0
- package/dist/core/file-cache.js +113 -1
- package/dist/core/flatten/flatten-repo.js +439 -0
- package/dist/core/format/osc8-link.js +28 -0
- package/dist/core/hook-chains.js +392 -0
- package/dist/core/hooks/citation-verify-hook.js +138 -0
- package/dist/core/hooks/citation-verify.js +112 -0
- package/dist/core/hooks/events.js +44 -0
- package/dist/core/hooks/index.js +15 -0
- package/dist/core/hooks/registry.js +213 -0
- package/dist/core/hooks/runner.js +236 -0
- package/dist/core/hooks/v2/event-emitter.js +115 -0
- package/dist/core/hooks/v2/executor.js +282 -0
- package/dist/core/hooks/v2/index.js +25 -0
- package/dist/core/hooks/v2/lifecycle.js +104 -0
- package/dist/core/hooks/v2/loader.js +216 -0
- package/dist/core/hooks/v2/matcher.js +125 -0
- package/dist/core/hooks/v2/trust.js +143 -0
- package/dist/core/hooks/v2/types.js +86 -0
- package/dist/core/image/renderer.js +71 -0
- package/dist/core/init/detector.js +582 -0
- package/dist/core/init/template-renderer.js +242 -0
- package/dist/core/jobs/registry.js +18 -18
- package/dist/core/ledger/results-tsv.js +142 -0
- package/dist/core/log-discipline/stdout-redirect.js +51 -0
- package/dist/core/lsp/cache.js +105 -0
- package/dist/core/lsp/client.js +776 -0
- package/dist/core/lsp/language-detect.js +66 -0
- package/dist/core/lsp/post-edit-diagnostics.js +171 -0
- package/dist/core/lsp/symbol-tools.js +372 -0
- package/dist/core/mcp/client.js +97 -28
- package/dist/core/mcp/http-server.js +553 -0
- package/dist/core/mcp/orchestrator-tools.js +662 -0
- package/dist/core/mcp/permission.js +190 -0
- package/dist/core/mcp/registry.js +39 -17
- package/dist/core/mcp/server-tools.js +219 -0
- package/dist/core/mcp/server.js +397 -0
- package/dist/core/mcp/trust.js +10 -10
- package/dist/core/memory/dual-write.js +416 -0
- package/dist/core/memory/passive-extract.js +130 -0
- package/dist/core/memory/phase1-kinds.js +20 -0
- package/dist/core/memory/secret-scanner.js +304 -0
- package/dist/core/memory-sync/queue.js +170 -0
- package/dist/core/metrics/extract.js +113 -0
- package/dist/core/modes/roo-modes.js +68 -0
- package/dist/core/onboarding/ensure-initialized.js +133 -0
- package/dist/core/onboarding/marker.js +111 -0
- package/dist/core/onboarding/telemetry-state.js +108 -0
- package/dist/core/output-style/presets.js +176 -0
- package/dist/core/output-style/state.js +185 -0
- package/dist/core/path-security.js +287 -5
- package/dist/core/permission.js +82 -22
- package/dist/core/permissions/auto-classifier.js +124 -0
- package/dist/core/permissions/bash-parser.js +371 -0
- package/dist/core/permissions/circuit-breaker.js +83 -0
- package/dist/core/permissions/constrained-edit.js +91 -0
- package/dist/core/permissions/gate.js +278 -0
- package/dist/core/permissions/index.js +20 -0
- package/dist/core/permissions/mode.js +174 -0
- package/dist/core/permissions/network-egress.js +137 -0
- package/dist/core/permissions/state.js +241 -0
- package/dist/core/permissions/tool-class.js +93 -0
- package/dist/core/plan-mode/ui-state.js +51 -0
- package/dist/core/plans/plan-artifact.js +721 -0
- package/dist/core/policy-limits/etag-store.js +122 -0
- package/dist/core/prd-check/parser.js +215 -0
- package/dist/core/prd-check/reporter.js +127 -0
- package/dist/core/prd-check/session-review.js +557 -0
- package/dist/core/prd-check/verifiers.js +223 -0
- package/dist/core/prompt-cache/client-cache.js +99 -0
- package/dist/core/prompts/assembly.js +29 -0
- package/dist/core/prompts/registry.js +364 -0
- package/dist/core/pugi-md/cc-compat-rules.js +735 -0
- package/dist/core/pugi-md/context-injector.js +76 -0
- package/dist/core/pugi-md/walk-up.js +207 -0
- package/dist/core/python/uv-installer.js +270 -0
- package/dist/core/python/uv-resolver.js +83 -0
- package/dist/core/rate-limit/narrator.js +146 -0
- package/dist/core/recipes/cli-types.js +20 -0
- package/dist/core/recipes/loader.js +103 -0
- package/dist/core/recipes/runner.js +345 -0
- package/dist/core/recipes/schema.js +587 -0
- package/dist/core/release-notes/parser.js +241 -0
- package/dist/core/release-notes/state.js +116 -0
- package/dist/core/repl/ask.js +37 -37
- package/dist/core/repl/cancellation.js +26 -26
- package/dist/core/repl/cap-warning.js +4 -4
- package/dist/core/repl/clipboard-read.js +11 -11
- package/dist/core/repl/dispatch-fsm.js +12 -12
- package/dist/core/repl/history-search.js +15 -15
- package/dist/core/repl/history.js +28 -18
- package/dist/core/repl/kill-ring.js +5 -5
- package/dist/core/repl/model-pricing.js +135 -0
- package/dist/core/repl/privacy-banner.js +22 -22
- package/dist/core/repl/session.js +2157 -214
- package/dist/core/repl/slash-commands.js +533 -40
- package/dist/core/repl/store/index.js +1 -1
- package/dist/core/repl/store/jsonl-log.js +22 -22
- package/dist/core/repl/store/lockfile.js +10 -10
- package/dist/core/repl/store/session-store.js +136 -107
- package/dist/core/repl/store/types.js +15 -15
- package/dist/core/repl/store/uuid-v7.js +12 -12
- package/dist/core/repl/workspace-context.js +43 -21
- package/dist/core/repo-map/build.js +125 -0
- package/dist/core/repo-map/cache.js +185 -0
- package/dist/core/repo-map/extractor.js +254 -0
- package/dist/core/repo-map/formatter.js +145 -0
- package/dist/core/repo-map/page-rank.js +105 -0
- package/dist/core/repo-map/scanner.js +211 -0
- package/dist/core/retry-budget/budget.js +284 -0
- package/dist/core/retry-budget/index.js +5 -0
- package/dist/core/retry-budget/retry-cap.js +74 -0
- package/dist/core/routing/lead-worker.js +43 -0
- package/dist/core/routing/pre-flight-estimator.js +108 -0
- package/dist/core/runs/run-tree.js +103 -0
- package/dist/core/security/injection-scanner.js +367 -0
- package/dist/core/security/output-filter.js +418 -0
- package/dist/core/session/env-file.js +105 -0
- package/dist/core/session/section-budgets.js +140 -0
- package/dist/core/session.js +92 -0
- package/dist/core/settings.js +298 -5
- package/dist/core/share/formatter.js +271 -0
- package/dist/core/share/redactor.js +221 -0
- package/dist/core/share/uploader.js +267 -0
- package/dist/core/skills/defaults.js +457 -0
- package/dist/core/skills/loader.js +22 -22
- package/dist/core/skills/sources.js +27 -27
- package/dist/core/smoke/headless-driver.js +174 -0
- package/dist/core/smoke/orchestrator.js +194 -0
- package/dist/core/smoke/runner.js +238 -0
- package/dist/core/smoke/scenario-parser.js +316 -0
- package/dist/core/statusline.js +99 -0
- package/dist/core/subagents/dispatcher-real.js +600 -0
- package/dist/core/subagents/dispatcher.js +132 -43
- package/dist/core/subagents/index.js +19 -6
- package/dist/core/subagents/isolation-matrix.js +213 -0
- package/dist/core/subagents/spawn.js +19 -4
- package/dist/core/telemetry/emitter.js +229 -0
- package/dist/core/telemetry/queue.js +251 -0
- package/dist/core/theme/context.js +91 -0
- package/dist/core/theme/presets.js +228 -0
- package/dist/core/theme/state.js +181 -0
- package/dist/core/todos/invariant.js +10 -0
- package/dist/core/todos/state.js +177 -0
- package/dist/core/tool-schema/compressor.js +89 -0
- package/dist/core/transport/version-interceptor.js +166 -0
- package/dist/core/trust.js +2 -2
- package/dist/core/tui/thinking-block.js +64 -0
- package/dist/core/vim/keymap.js +288 -0
- package/dist/core/vim/state.js +92 -0
- package/dist/core/watch-markers/marker-watcher.js +133 -0
- package/dist/core/worktree-manager/cleanup.js +123 -0
- package/dist/core/worktree-manager/manager.js +303 -0
- package/dist/index.js +36 -0
- package/dist/runtime/bootstrap.js +190 -0
- package/dist/runtime/cli.js +4203 -493
- package/dist/runtime/commands/agents.js +30 -30
- package/dist/runtime/commands/budget.js +5 -5
- package/dist/runtime/commands/cancel.js +231 -0
- package/dist/runtime/commands/chain.js +489 -0
- package/dist/runtime/commands/codegraph-status.js +227 -0
- package/dist/runtime/commands/compact.js +297 -0
- package/dist/runtime/commands/config.js +73 -39
- package/dist/runtime/commands/cost.js +199 -0
- package/dist/runtime/commands/delegate.js +244 -13
- package/dist/runtime/commands/dispatch.js +126 -0
- package/dist/runtime/commands/doctor.js +579 -0
- package/dist/runtime/commands/feedback.js +184 -0
- package/dist/runtime/commands/hooks.js +184 -0
- package/dist/runtime/commands/init.js +254 -0
- package/dist/runtime/commands/lsp.js +368 -0
- package/dist/runtime/commands/mcp.js +879 -0
- package/dist/runtime/commands/memory.js +582 -0
- package/dist/runtime/commands/model.js +237 -0
- package/dist/runtime/commands/onboarding.js +275 -0
- package/dist/runtime/commands/patch.js +128 -0
- package/dist/runtime/commands/permissions.js +112 -0
- package/dist/runtime/commands/plan.js +143 -0
- package/dist/runtime/commands/prd-check.js +285 -0
- package/dist/runtime/commands/privacy.js +17 -17
- package/dist/runtime/commands/recipe.js +325 -0
- package/dist/runtime/commands/redo-blob-store.js +92 -0
- package/dist/runtime/commands/redo.js +361 -0
- package/dist/runtime/commands/release-notes.js +229 -0
- package/dist/runtime/commands/repo-map.js +95 -0
- package/dist/runtime/commands/report.js +299 -0
- package/dist/runtime/commands/resume.js +118 -0
- package/dist/runtime/commands/review-consensus.js +68 -53
- package/dist/runtime/commands/rewind.js +333 -0
- package/dist/runtime/commands/roster.js +14 -14
- package/dist/runtime/commands/sessions.js +163 -0
- package/dist/runtime/commands/share.js +316 -0
- package/dist/runtime/commands/skills.js +31 -31
- package/dist/runtime/commands/status.js +186 -0
- package/dist/runtime/commands/stickers.js +82 -0
- package/dist/runtime/commands/style.js +194 -0
- package/dist/runtime/commands/theme.js +196 -0
- package/dist/runtime/commands/undo.js +54 -22
- package/dist/runtime/commands/update.js +289 -0
- package/dist/runtime/commands/vim.js +140 -0
- package/dist/runtime/commands/worktree.js +177 -0
- package/dist/runtime/commands/worktrees.js +155 -0
- package/dist/runtime/headless-repl.js +195 -0
- package/dist/runtime/headless.js +543 -0
- package/dist/runtime/load-hooks-or-exit.js +71 -0
- package/dist/runtime/plan-decompose.js +531 -0
- package/dist/runtime/sigint-guard.js +272 -0
- package/dist/runtime/update-check.js +28 -28
- package/dist/runtime/version.js +65 -0
- package/dist/skills/bundled/batch.js +617 -0
- package/dist/skills/bundled/index.js +45 -0
- package/dist/skills/bundled/loop.js +358 -0
- package/dist/skills/bundled/remember.js +383 -0
- package/dist/skills/bundled/simplify.js +289 -0
- package/dist/skills/bundled/skillify.js +373 -0
- package/dist/skills/bundled/stuck.js +558 -0
- package/dist/skills/bundled/verify.js +439 -0
- package/dist/testing/vcr.js +486 -0
- package/dist/tools/agent-tool.js +229 -0
- package/dist/tools/apply-patch.js +556 -0
- package/dist/tools/ask-user-question.js +288 -0
- package/dist/tools/ask-user.js +115 -0
- package/dist/tools/bash.js +624 -46
- package/dist/tools/brief.js +224 -0
- package/dist/tools/enter-worktree.js +250 -0
- package/dist/tools/exit-worktree.js +147 -0
- package/dist/tools/file-tools.js +161 -44
- package/dist/tools/lsp-tools.js +189 -0
- package/dist/tools/mcp-tool.js +260 -0
- package/dist/tools/multi-edit.js +361 -0
- package/dist/tools/powershell.js +268 -0
- package/dist/tools/registry.js +85 -0
- package/dist/tools/skill-tool.js +96 -0
- package/dist/tools/sleep.js +99 -0
- package/dist/tools/synthetic-output.js +133 -0
- package/dist/tools/tasks.js +208 -0
- package/dist/tools/todo-write.js +184 -0
- package/dist/tools/verify-plan-execution.js +295 -0
- package/dist/tools/web-fetch-injection-scanner.js +207 -0
- package/dist/tools/web-fetch.js +195 -10
- package/dist/tools/web-search.js +458 -0
- package/dist/tui/agent-progress-card.js +111 -0
- package/dist/tui/agent-tree.js +11 -1
- package/dist/tui/ask-modal.js +14 -14
- package/dist/tui/ask-user-question-chips.js +257 -0
- package/dist/tui/ask-user-question-prompt.js +203 -0
- package/dist/tui/compact-banner.js +81 -0
- package/dist/tui/conversation-pane.js +85 -11
- package/dist/tui/cost-table.js +111 -0
- package/dist/tui/device-flow.js +2 -2
- package/dist/tui/doctor-table.js +46 -0
- package/dist/tui/feedback-prompt.js +156 -0
- package/dist/tui/input-box.js +247 -32
- package/dist/tui/login-picker.js +3 -3
- package/dist/tui/markdown-render.js +6 -6
- package/dist/tui/onboarding-wizard.js +240 -0
- package/dist/tui/permissions-picker.js +86 -0
- package/dist/tui/render.js +35 -0
- package/dist/tui/repl-render.js +332 -54
- package/dist/tui/repl-splash-art.js +16 -16
- package/dist/tui/repl-splash-mascot.js +48 -24
- package/dist/tui/repl-splash.js +22 -22
- package/dist/tui/repl.js +124 -44
- package/dist/tui/slash-palette.js +6 -6
- package/dist/tui/splash.js +2 -2
- package/dist/tui/status-bar.js +109 -31
- package/dist/tui/status-table.js +7 -0
- package/dist/tui/stickers-art.js +136 -0
- package/dist/tui/style-table.js +28 -0
- package/dist/tui/theme-table.js +29 -0
- package/dist/tui/thinking-spinner.js +123 -0
- package/dist/tui/tool-stream-pane.js +53 -4
- package/dist/tui/update-banner.js +27 -2
- package/dist/tui/vim-input.js +267 -0
- package/dist/tui/welcome-banner.js +107 -0
- package/dist/tui/welcome-data.js +293 -0
- package/dist/tui/workspace-context.js +2 -2
- package/docs/examples/codegraph.mcp.json +10 -0
- package/package.json +25 -7
- package/test/scenarios/codegen-create-file.scenario.txt +13 -0
- package/test/scenarios/compact-force.scenario.txt +11 -0
- package/test/scenarios/identity.scenario.txt +11 -0
- package/test/scenarios/persona-handoff.scenario.txt +11 -0
- package/test/scenarios/walkback.scenario.txt +12 -0
- 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
|
package/dist/core/credentials.js
CHANGED
|
@@ -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
|
-
//
|
|
211
|
-
//
|
|
212
|
-
//
|
|
213
|
-
//
|
|
214
|
-
//
|
|
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
|
-
*
|
|
242
|
-
*
|
|
243
|
-
*
|
|
244
|
-
*
|
|
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
|
-
*
|
|
315
|
-
*
|
|
316
|
-
*
|
|
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
|