@cohortapp/agent-sdk 2.16.0 → 2.18.4
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/.claude/settings.json +18 -0
- package/.env.example +23 -7
- package/README.md +1 -0
- package/bin/maestro.mjs +62 -0
- package/docs/guides/billing-console-keys.md +60 -0
- package/docs/guides/front-door-session.md +54 -9
- package/docs/guides/mac-mini.md +20 -25
- package/docs/guides/poller-daemon-setup.md +4 -1
- package/docs/guides/setup-wizard.md +1 -1
- package/docs/runbooks/fleet-rollout.md +156 -0
- package/docs/runbooks/mac-mini-bootstrap.md +12 -14
- package/lib/action-executor.js +19 -3
- package/lib/budget-guard.mjs +279 -3
- package/lib/channels/base-adapter.mjs +3 -1
- package/lib/channels/contract.mjs +2 -1
- package/lib/channels/inbox-item.mjs +8 -0
- package/lib/claude-bin.mjs +5 -6
- package/lib/cli/doctor-checks.mjs +141 -10
- package/lib/cli/global-setup-extras.mjs +5 -1
- package/lib/cli/inbox.mjs +100 -15
- package/lib/cli/seat-auth.mjs +463 -0
- package/lib/cli/session.mjs +80 -12
- package/lib/collective/capture.mjs +8 -6
- package/lib/collective/global-config.mjs +63 -1
- package/lib/collective/presence.mjs +142 -5
- package/lib/comms/send-gate.mjs +559 -1
- package/lib/context/budget.mjs +327 -0
- package/lib/context/history-scope.mjs +138 -0
- package/lib/diagnostics/alerts.mjs +49 -0
- package/lib/diagnostics/cadence-output-freshness.mjs +288 -0
- package/lib/engine/agents/definitions.mjs +343 -0
- package/lib/engine/agents/persist.mjs +275 -0
- package/lib/engine/agents/runtime.mjs +748 -0
- package/lib/engine/agents/usage.mjs +95 -0
- package/lib/engine/auth-status.mjs +139 -0
- package/lib/engine/budget.mjs +194 -0
- package/lib/engine/cli.mjs +1204 -0
- package/lib/engine/commands/index.mjs +269 -0
- package/lib/engine/context/budget.mjs +219 -0
- package/lib/engine/context/cache.mjs +125 -0
- package/lib/engine/context/child-env.mjs +215 -0
- package/lib/engine/context/compaction.mjs +342 -0
- package/lib/engine/context/images.mjs +90 -0
- package/lib/engine/context/instructions.mjs +327 -0
- package/lib/engine/context/lazy-instructions.mjs +169 -0
- package/lib/engine/context/manager.mjs +182 -0
- package/lib/engine/context/real-path.mjs +91 -0
- package/lib/engine/context/secret-values.mjs +163 -0
- package/lib/engine/context/settings.mjs +274 -0
- package/lib/engine/context/stream-input.mjs +159 -0
- package/lib/engine/guard.mjs +152 -0
- package/lib/engine/hooks.mjs +713 -0
- package/lib/engine/loop.mjs +560 -0
- package/lib/engine/mcp/client.mjs +254 -0
- package/lib/engine/mcp/config.mjs +301 -0
- package/lib/engine/mcp/http.mjs +201 -0
- package/lib/engine/mcp/index.mjs +146 -0
- package/lib/engine/mcp/jsonrpc.mjs +147 -0
- package/lib/engine/mcp/naming.mjs +66 -0
- package/lib/engine/mcp/resources.mjs +89 -0
- package/lib/engine/mcp/results.mjs +133 -0
- package/lib/engine/mcp/stdio.mjs +137 -0
- package/lib/engine/mcp/supervisor.mjs +116 -0
- package/lib/engine/messages.mjs +104 -0
- package/lib/engine/output/json.mjs +164 -0
- package/lib/engine/output/stream-json.mjs +266 -0
- package/lib/engine/permissions.mjs +845 -0
- package/lib/engine/process-identity.mjs +164 -0
- package/lib/engine/process-tree.mjs +551 -0
- package/lib/engine/prompt.mjs +60 -0
- package/lib/engine/session/store.mjs +299 -0
- package/lib/engine/session-runtime/args.mjs +97 -0
- package/lib/engine/session-runtime/host.mjs +143 -0
- package/lib/engine/session-runtime/inbox.mjs +122 -0
- package/lib/engine/session-runtime/notifications.mjs +129 -0
- package/lib/engine/session-runtime/registry.mjs +328 -0
- package/lib/engine/session-runtime/runner.mjs +344 -0
- package/lib/engine/session-runtime/socket.mjs +212 -0
- package/lib/engine/session-runtime/wakeup.mjs +115 -0
- package/lib/engine/skills/index.mjs +321 -0
- package/lib/engine/tools/bash-background.mjs +533 -0
- package/lib/engine/tools/bash.mjs +216 -0
- package/lib/engine/tools/edit.mjs +97 -0
- package/lib/engine/tools/glob.mjs +81 -0
- package/lib/engine/tools/grep.mjs +224 -0
- package/lib/engine/tools/index.mjs +84 -0
- package/lib/engine/tools/list-agents.mjs +32 -0
- package/lib/engine/tools/ls.mjs +127 -0
- package/lib/engine/tools/monitor.mjs +82 -0
- package/lib/engine/tools/notebook-edit.mjs +218 -0
- package/lib/engine/tools/read.mjs +103 -0
- package/lib/engine/tools/schedule-wakeup.mjs +45 -0
- package/lib/engine/tools/schema.mjs +144 -0
- package/lib/engine/tools/send-message.mjs +77 -0
- package/lib/engine/tools/session.mjs +70 -0
- package/lib/engine/tools/todo.mjs +144 -0
- package/lib/engine/tools/toolsearch.mjs +217 -0
- package/lib/engine/tools/walk.mjs +193 -0
- package/lib/engine/tools/web-switch.mjs +31 -0
- package/lib/engine/tools/webfetch-html.mjs +387 -0
- package/lib/engine/tools/webfetch-net.mjs +340 -0
- package/lib/engine/tools/webfetch.mjs +198 -0
- package/lib/engine/tools/websearch.mjs +91 -0
- package/lib/engine/tools/workflow.mjs +95 -0
- package/lib/engine/tools/write.mjs +76 -0
- package/lib/engine/tui/line-editor.mjs +137 -0
- package/lib/engine/tui/render.mjs +86 -0
- package/lib/engine/tui/tui.mjs +274 -0
- package/lib/engine/wire/anthropic-messages.mjs +263 -0
- package/lib/engine/wire/effort.mjs +36 -0
- package/lib/engine/wire/errors.mjs +496 -0
- package/lib/engine/wire/http.mjs +441 -0
- package/lib/engine/wire/index.mjs +76 -0
- package/lib/engine/wire/openai-chat.mjs +332 -0
- package/lib/engine/wire/prompt-cache.mjs +79 -0
- package/lib/engine/wire/search.mjs +140 -0
- package/lib/engine/wire/sse.mjs +114 -0
- package/lib/engine/wire/stall.mjs +349 -0
- package/lib/engine/wire/token-provider.mjs +175 -0
- package/lib/engine/wire/usage.mjs +192 -0
- package/lib/engine/workflow/host.mjs +524 -0
- package/lib/engine/workflow/journal.mjs +188 -0
- package/lib/engine/workflow/json-schema.mjs +171 -0
- package/lib/engine/workflow/meta.mjs +329 -0
- package/lib/engine/workflow/notifications.mjs +52 -0
- package/lib/engine/workflow/runtime.mjs +447 -0
- package/lib/engine/workflow/sandbox.mjs +534 -0
- package/lib/engine/workflow/worker.mjs +141 -0
- package/lib/engine/workflow/worktree.mjs +74 -0
- package/lib/execution/disposition.mjs +1 -1
- package/lib/execution/intake.mjs +10 -0
- package/lib/execution/surface-policy.mjs +15 -0
- package/lib/learning/curator.mjs +8 -6
- package/lib/learning/reflect.mjs +8 -6
- package/lib/model-router/catalog/cohort.yaml +137 -0
- package/lib/model-router/catalog.mjs +118 -1
- package/lib/model-router/economics.mjs +9 -0
- package/lib/model-router/failover.mjs +67 -16
- package/lib/model-router/llm-task.mjs +39 -3
- package/lib/model-router/resolve.mjs +95 -3
- package/lib/model-router/spawn.mjs +46 -47
- package/lib/model-router/taxonomy.mjs +126 -4
- package/lib/org/cost-sync.mjs +141 -11
- package/lib/org/inbound/broadcast.mjs +289 -0
- package/lib/org/inbound/collective.mjs +375 -0
- package/lib/org/inbound/directedness.mjs +96 -8
- package/lib/org/inbound/facts.mjs +82 -4
- package/lib/org/inbound/hydrate.mjs +555 -51
- package/lib/org/inbound/project.mjs +22 -0
- package/lib/org/inbound/surfaces.mjs +14 -0
- package/lib/org/llm-token.mjs +879 -0
- package/lib/org/mesh.mjs +61 -0
- package/lib/org/messaging.mjs +3 -1
- package/lib/org/protocol.checksum +1 -1
- package/lib/org/protocol.mjs +15 -0
- package/lib/org/quota.mjs +520 -0
- package/lib/org/tool-surface.mjs +104 -16
- package/lib/org/ui-parity.mjs +16 -1
- package/lib/org/work-ledger.mjs +37 -6
- package/lib/rate-guard.mjs +114 -1
- package/lib/resource-governor.mjs +41 -6
- package/lib/runtime/adapter.mjs +823 -0
- package/lib/runtime/child-env.mjs +191 -0
- package/lib/runtime/legacy-shell-guard.mjs +97 -0
- package/lib/runtime/seat-engine.mjs +162 -0
- package/lib/session/ask-ledger.mjs +271 -0
- package/lib/session/current-work.mjs +676 -0
- package/lib/session/feed-core.mjs +40 -3
- package/lib/session/launch-args.mjs +56 -4
- package/lib/session/status-summary.mjs +26 -9
- package/lib/session/upgrade-notice.mjs +42 -0
- package/lib/setup/claude-probe.mjs +117 -13
- package/lib/setup/enrich.mjs +13 -10
- package/lib/setup/sections/model.mjs +39 -13
- package/lib/telemetry/collect.mjs +208 -9
- package/lib/upgrade/ignored-drift.mjs +105 -0
- package/lib/voice/post-call-brief.mjs +30 -17
- package/package.json +15 -3
- package/plugins/maestro-skills/skills/board-work.md +5 -0
- package/plugins/maestro-skills/skills/inbound-triage.md +56 -15
- package/plugins/maestro-skills/skills/main-session.md +18 -7
- package/scripts/ci/check-tarball-fidelity.mjs +126 -2
- package/scripts/ci/run-tests.mjs +47 -19
- package/scripts/cohort-llm/api-key-helper.mjs +92 -0
- package/scripts/collective/hook-runner.mjs +29 -2
- package/scripts/continuous-monitor.sh +13 -0
- package/scripts/cost/track-claude-usage.mjs +15 -0
- package/scripts/daemon/agent-daemon.mjs +408 -20
- package/scripts/daemon/assurance.mjs +48 -12
- package/scripts/daemon/cadence-consumer.mjs +218 -68
- package/scripts/daemon/cadence-handlers.mjs +73 -4
- package/scripts/daemon/classifier.mjs +75 -26
- package/scripts/daemon/context-compiler.mjs +104 -59
- package/scripts/daemon/deliver.mjs +30 -1
- package/scripts/daemon/dispatcher.mjs +804 -157
- package/scripts/daemon/health.mjs +14 -1
- package/scripts/daemon/lib/session-router.mjs +310 -42
- package/scripts/daemon/maestro-daemon.mjs +11 -0
- package/scripts/daemon/prompt-builder.mjs +121 -12
- package/scripts/daemon/responder.mjs +315 -146
- package/scripts/daemon/sdk-version.mjs +98 -16
- package/scripts/eval/probe-gateway.mjs +635 -0
- package/scripts/eval/replay/extract.mjs +270 -0
- package/scripts/eval/replay/grade.mjs +260 -0
- package/scripts/eval/replay/lib/config.mjs +50 -0
- package/scripts/eval/replay/lib/effects.mjs +65 -0
- package/scripts/eval/replay/lib/fixture.mjs +188 -0
- package/scripts/eval/replay/lib/judge.mjs +72 -0
- package/scripts/eval/replay/lib/redact.mjs +136 -0
- package/scripts/eval/replay/lib/sandbox.mjs +170 -0
- package/scripts/eval/replay/lib/schema-check.mjs +63 -0
- package/scripts/eval/replay/lib/transcript.mjs +76 -0
- package/scripts/eval/replay/mcp-replay-stub.mjs +101 -0
- package/scripts/eval/replay/report.mjs +185 -0
- package/scripts/eval/replay/run.mjs +404 -0
- package/scripts/fleet/rollout.mjs +1094 -0
- package/scripts/hooks/pre-send-audit.sh +36 -245
- package/scripts/hooks/pre-write-yaml-validate.mjs +275 -0
- package/scripts/hooks/validate-state-yaml.sh +190 -0
- package/scripts/huddle/huddle-llm.mjs +361 -0
- package/scripts/huddle/huddle-server.mjs +46 -121
- package/scripts/local-triggers/autoupdate.sh +448 -78
- package/scripts/local-triggers/run-trigger.sh +13 -0
- package/scripts/maintenance/pin-integrity.mjs +364 -0
- package/scripts/poll-slack-events.sh +41 -9
- package/scripts/poller/slack-socket-mode.mjs +28 -3
- package/scripts/session/supervisor.mjs +80 -13
- package/scripts/spawn-session.sh +13 -0
- package/bin/maestro.test.mjs +0 -1574
- package/lib/action-executor.test.mjs +0 -871
- package/lib/archetype.test.mjs +0 -132
- package/lib/assurance/plan-note.test.mjs +0 -234
- package/lib/assurance/room-budget.test.mjs +0 -486
- package/lib/assurance/tier.test.mjs +0 -174
- package/lib/autonomy.test.mjs +0 -66
- package/lib/backlog.test.mjs +0 -302
- package/lib/backup/policy.test.mjs +0 -305
- package/lib/budget-escalate.test.mjs +0 -232
- package/lib/budget-guard.envelope.test.mjs +0 -476
- package/lib/budget-guard.test.mjs +0 -427
- package/lib/cadence-bus-requeue.test.mjs +0 -83
- package/lib/cadence-bus-schedule.test.mjs +0 -194
- package/lib/cadence-bus.test.mjs +0 -720
- package/lib/cadences.test.mjs +0 -230
- package/lib/capability/inventory.test.mjs +0 -232
- package/lib/capability.test.mjs +0 -78
- package/lib/channels/base-adapter.test.mjs +0 -590
- package/lib/channels/channels.test.mjs +0 -371
- package/lib/channels/contract.test.mjs +0 -162
- package/lib/channels/inbox-item.test.mjs +0 -368
- package/lib/channels/orgmail/adapter.test.mjs +0 -448
- package/lib/channels/pairing.test.mjs +0 -270
- package/lib/channels/repeat-suppressor.test.mjs +0 -134
- package/lib/channels/slack-adapter.test.mjs +0 -212
- package/lib/channels/telegram-adapter.test.mjs +0 -306
- package/lib/channels/voice/adapter.test.mjs +0 -278
- package/lib/channels/whatsapp/adapter-baileys.test.mjs +0 -359
- package/lib/channels/whatsapp/baileys-typing.test.mjs +0 -154
- package/lib/charter.test.mjs +0 -89
- package/lib/claude-bin.test.mjs +0 -131
- package/lib/cli/board.test.mjs +0 -227
- package/lib/cli/design.test.mjs +0 -270
- package/lib/cli/doctor-checks.test.mjs +0 -336
- package/lib/cli/global-setup-extras.test.mjs +0 -462
- package/lib/cli/inbox.test.mjs +0 -230
- package/lib/cli/session-ack.test.mjs +0 -63
- package/lib/cli/session.test.mjs +0 -613
- package/lib/collective/capture.test.mjs +0 -121
- package/lib/collective/cards.test.mjs +0 -114
- package/lib/collective/config.test.mjs +0 -123
- package/lib/collective/global-config.test.mjs +0 -220
- package/lib/collective/global-skills.test.mjs +0 -126
- package/lib/collective/presence.test.mjs +0 -95
- package/lib/collective/recall.test.mjs +0 -116
- package/lib/collective/vendor-skills.test.mjs +0 -306
- package/lib/comms/send-gate.test.mjs +0 -770
- package/lib/comms.test.mjs +0 -41
- package/lib/cost/ledger-row.test.mjs +0 -183
- package/lib/design/design-md.test.mjs +0 -318
- package/lib/design/fixtures/DESIGN.golden.md +0 -238
- package/lib/design/fixtures/PRODUCT.golden.md +0 -67
- package/lib/design/fixtures/foundation.json +0 -133
- package/lib/design/refresh-gate.test.mjs +0 -144
- package/lib/design/write.test.mjs +0 -241
- package/lib/diagnostics/alerts.test.mjs +0 -318
- package/lib/diagnostics/backup-freshness.test.mjs +0 -185
- package/lib/diagnostics/counters.test.mjs +0 -206
- package/lib/diagnostics/events.test.mjs +0 -290
- package/lib/diagnostics/otel.test.mjs +0 -196
- package/lib/diagnostics/trace.test.mjs +0 -251
- package/lib/env-compat.test.mjs +0 -104
- package/lib/execution/disposition.test.mjs +0 -553
- package/lib/execution/drive.test.mjs +0 -270
- package/lib/execution/effects.test.mjs +0 -344
- package/lib/execution/intake.test.mjs +0 -389
- package/lib/execution/journal.test.mjs +0 -261
- package/lib/execution/match.test.mjs +0 -235
- package/lib/execution/pipeline.test.mjs +0 -392
- package/lib/execution/route.test.mjs +0 -186
- package/lib/execution/surface-policy.test.mjs +0 -162
- package/lib/fs-atomic.test.mjs +0 -72
- package/lib/fs-ownership.test.mjs +0 -158
- package/lib/goals/admission.test.mjs +0 -164
- package/lib/goals/classify.test.mjs +0 -167
- package/lib/goals/collaborate.test.mjs +0 -336
- package/lib/goals/gaps.test.mjs +0 -284
- package/lib/goals/loop.test.mjs +0 -845
- package/lib/hooks/bus.test.mjs +0 -387
- package/lib/identity/persona.test.mjs +0 -142
- package/lib/kpi-sensors.test.mjs +0 -278
- package/lib/kpi.test.mjs +0 -244
- package/lib/learning/config.test.mjs +0 -75
- package/lib/learning/counters.test.mjs +0 -69
- package/lib/learning/curator-consolidate.test.mjs +0 -238
- package/lib/learning/curator.test.mjs +0 -106
- package/lib/learning/reflect.test.mjs +0 -0
- package/lib/learning/session-index.test.mjs +0 -125
- package/lib/learning/skill-writer.test.mjs +0 -210
- package/lib/mandate/audit.test.mjs +0 -195
- package/lib/mandate/contract.test.mjs +0 -185
- package/lib/mandate/derive.test.mjs +0 -274
- package/lib/mandate/model.test.mjs +0 -164
- package/lib/mandate/refresh.test.mjs +0 -389
- package/lib/mcp/server.test.mjs +0 -426
- package/lib/model-router/auth-profiles.test.mjs +0 -580
- package/lib/model-router/catalog.test.mjs +0 -385
- package/lib/model-router/economics.test.mjs +0 -438
- package/lib/model-router/failover.test.mjs +0 -439
- package/lib/model-router/health.test.mjs +0 -338
- package/lib/model-router/integration-coverage.test.mjs +0 -831
- package/lib/model-router/integration.test.mjs +0 -564
- package/lib/model-router/ledger.test.mjs +0 -415
- package/lib/model-router/llm-task.test.mjs +0 -392
- package/lib/model-router/org-credentials.test.mjs +0 -265
- package/lib/model-router/pricing-refresh.test.mjs +0 -286
- package/lib/model-router/reconcile.test.mjs +0 -316
- package/lib/model-router/repair.test.mjs +0 -180
- package/lib/model-router/spawn.test.mjs +0 -446
- package/lib/model-router/taxonomy.test.mjs +0 -410
- package/lib/model-router.test.mjs +0 -1207
- package/lib/org/activity.test.mjs +0 -134
- package/lib/org/approvals.test.mjs +0 -216
- package/lib/org/awareness.test.mjs +0 -159
- package/lib/org/board-mine-cache.test.mjs +0 -53
- package/lib/org/board.test.mjs +0 -187
- package/lib/org/bootstrap-context.test.mjs +0 -153
- package/lib/org/client.test.mjs +0 -1206
- package/lib/org/cohort-client.test.mjs +0 -126
- package/lib/org/cost-sync.test.mjs +0 -153
- package/lib/org/doctor.test.mjs +0 -346
- package/lib/org/engagement-ledger.test.mjs +0 -112
- package/lib/org/engagement.test.mjs +0 -739
- package/lib/org/handoff.test.mjs +0 -269
- package/lib/org/inbound/directedness.test.mjs +0 -668
- package/lib/org/inbound/facts.test.mjs +0 -471
- package/lib/org/inbound/hydrate.test.mjs +0 -453
- package/lib/org/inbound/index.test.mjs +0 -429
- package/lib/org/inbound/project.test.mjs +0 -287
- package/lib/org/integration-tools.test.mjs +0 -160
- package/lib/org/keys.test.mjs +0 -92
- package/lib/org/knowledge.test.mjs +0 -326
- package/lib/org/leases.test.mjs +0 -235
- package/lib/org/mesh-directives.test.mjs +0 -110
- package/lib/org/mesh-integration.test.mjs +0 -127
- package/lib/org/mesh.test.mjs +0 -400
- package/lib/org/messaging.test.mjs +0 -471
- package/lib/org/param-contract.test.mjs +0 -477
- package/lib/org/policy.test.mjs +0 -237
- package/lib/org/protocol.checksum.test.mjs +0 -90
- package/lib/org/protocol.test.mjs +0 -323
- package/lib/org/push.test.mjs +0 -792
- package/lib/org/registry.test.mjs +0 -100
- package/lib/org/resource-tools.test.mjs +0 -361
- package/lib/org/tool-access.test.mjs +0 -144
- package/lib/org/tool-surface-integration.test.mjs +0 -120
- package/lib/org/tool-surface.test.mjs +0 -1268
- package/lib/org/typing.test.mjs +0 -291
- package/lib/org/ui-parity.test.mjs +0 -560
- package/lib/org/verify.test.mjs +0 -194
- package/lib/org/work-ledger.test.mjs +0 -273
- package/lib/plan/adoption-e2e.test.mjs +0 -366
- package/lib/plan/budget-enforcement.test.mjs +0 -400
- package/lib/plan/compile.test.mjs +0 -382
- package/lib/plan/emit.test.mjs +0 -269
- package/lib/plan/explain.test.mjs +0 -188
- package/lib/prompts/parallelism.test.mjs +0 -177
- package/lib/rag/rag.test.mjs +0 -505
- package/lib/rate-guard.test.mjs +0 -272
- package/lib/reactive-gate.test.mjs +0 -57
- package/lib/render.test.mjs +0 -68
- package/lib/resource-governor.test.mjs +0 -488
- package/lib/scheduling/dynamic-jobs.test.mjs +0 -344
- package/lib/scheduling/jitter.test.mjs +0 -140
- package/lib/secrets/broker.test.mjs +0 -280
- package/lib/secrets/providers.test.mjs +0 -274
- package/lib/security/audit-engine.test.mjs +0 -424
- package/lib/security/coerce-args.test.mjs +0 -281
- package/lib/security/dangerous-tools.test.mjs +0 -68
- package/lib/security/external-content.test.mjs +0 -84
- package/lib/security/redact.test.mjs +0 -441
- package/lib/security/secret-equal.test.mjs +0 -55
- package/lib/session/config.test.mjs +0 -92
- package/lib/session/feed-core.test.mjs +0 -198
- package/lib/session/first-run.test.mjs +0 -121
- package/lib/session/frontdoor.test.mjs +0 -205
- package/lib/session/handoffs.test.mjs +0 -183
- package/lib/session/identity.test.mjs +0 -180
- package/lib/session/inbox-claims.test.mjs +0 -286
- package/lib/session/launch-args.test.mjs +0 -157
- package/lib/session/liveness.test.mjs +0 -100
- package/lib/session/status-summary.test.mjs +0 -118
- package/lib/session-permissions.test.mjs +0 -120
- package/lib/setup/claude-probe.test.mjs +0 -187
- package/lib/setup/completeness.test.mjs +0 -110
- package/lib/setup/context-pack.test.mjs +0 -89
- package/lib/setup/enrich.test.mjs +0 -115
- package/lib/setup/enroll-from-cohort.test.mjs +0 -300
- package/lib/setup/integration.test.mjs +0 -162
- package/lib/setup/io.test.mjs +0 -77
- package/lib/setup/runner.test.mjs +0 -132
- package/lib/setup/sections/identity.test.mjs +0 -234
- package/lib/setup/sections/inventory.test.mjs +0 -198
- package/lib/setup/sections/learning.test.mjs +0 -81
- package/lib/setup/sections/mandate.test.mjs +0 -388
- package/lib/setup/sections/messaging.test.mjs +0 -127
- package/lib/setup/sections/model.test.mjs +0 -240
- package/lib/setup/sections/org.test.mjs +0 -346
- package/lib/setup/sections/orgmail.test.mjs +0 -118
- package/lib/setup/sections/recovery.test.mjs +0 -98
- package/lib/setup/sections/subagents.test.mjs +0 -429
- package/lib/setup/sections/verify.test.mjs +0 -175
- package/lib/setup/sot.test.mjs +0 -81
- package/lib/setup/state.test.mjs +0 -115
- package/lib/singleton.test.mjs +0 -151
- package/lib/subagents/cli.test.mjs +0 -389
- package/lib/subagents/client.test.mjs +0 -309
- package/lib/subagents/gap.test.mjs +0 -234
- package/lib/subagents/lock.test.mjs +0 -248
- package/lib/subagents/manifest.test.mjs +0 -175
- package/lib/subagents/refs.test.mjs +0 -204
- package/lib/subagents/resolve.test.mjs +0 -422
- package/lib/subagents/schema.test.mjs +0 -328
- package/lib/telemetry/alerts.test.mjs +0 -109
- package/lib/telemetry/collect.test.mjs +0 -1274
- package/lib/tool-definitions-integration.test.mjs +0 -83
- package/lib/tool-definitions.test.mjs +0 -437
- package/lib/upgrade/global-refresh.test.mjs +0 -65
- package/lib/upgrade/launchd-reconcile.test.mjs +0 -272
- package/lib/upgrade/post-steps.test.mjs +0 -200
- package/lib/upgrade/verify.test.mjs +0 -164
- package/lib/util/fetch-timeout.test.mjs +0 -202
- package/lib/util/reconnect.test.mjs +0 -369
- package/lib/util/unhandled.test.mjs +0 -216
- package/lib/voice/outbound.test.mjs +0 -69
- package/lib/voice/session-rotation.test.mjs +0 -114
- package/lib/voice/stt.test.mjs +0 -226
- package/lib/voice/voice.test.mjs +0 -990
- package/scripts/cadence/enqueue-cadence-tick.test.mjs +0 -187
- package/scripts/ci/check-docs-accuracy.test.mjs +0 -409
- package/scripts/ci/check-durable-write-seam.test.mjs +0 -90
- package/scripts/ci/check-no-build-artifacts.test.mjs +0 -71
- package/scripts/ci/check-no-residual-identity.test.mjs +0 -202
- package/scripts/ci/check-skill-packs.test.mjs +0 -495
- package/scripts/ci/check-subagent-frontmatter.test.mjs +0 -124
- package/scripts/ci/check.test.mjs +0 -194
- package/scripts/ci/conformance-org-api.test.mjs +0 -425
- package/scripts/cloud-relay/voice/relay-identity.test.mjs +0 -96
- package/scripts/collective/hook-runner.test.mjs +0 -173
- package/scripts/cost/fleet-digest.test.mjs +0 -207
- package/scripts/cost/track-claude-usage-pricing.test.mjs +0 -183
- package/scripts/cost/track-claude-usage.test.mjs +0 -148
- package/scripts/daemon/agent-daemon-board-mine.test.mjs +0 -96
- package/scripts/daemon/agent-daemon-design.test.mjs +0 -238
- package/scripts/daemon/agent-daemon-frontdoor.test.mjs +0 -60
- package/scripts/daemon/agent-daemon.test.mjs +0 -995
- package/scripts/daemon/assurance-e2e.test.mjs +0 -613
- package/scripts/daemon/assurance.test.mjs +0 -1791
- package/scripts/daemon/board-mirror.test.mjs +0 -165
- package/scripts/daemon/cadence-consumer-frontdoor.test.mjs +0 -393
- package/scripts/daemon/cadence-consumer-governance.test.mjs +0 -276
- package/scripts/daemon/cadence-consumer.test.mjs +0 -776
- package/scripts/daemon/cadence-handlers.test.mjs +0 -837
- package/scripts/daemon/classifier-identity.test.mjs +0 -137
- package/scripts/daemon/classifier.test.mjs +0 -266
- package/scripts/daemon/classify-kind.test.mjs +0 -40
- package/scripts/daemon/context-compiler.test.mjs +0 -300
- package/scripts/daemon/deliver.test.mjs +0 -564
- package/scripts/daemon/dispatcher-cooldown.test.mjs +0 -122
- package/scripts/daemon/dispatcher-governance.test.mjs +0 -1013
- package/scripts/daemon/dispatcher-resume.test.mjs +0 -166
- package/scripts/daemon/execution-ladder.test.mjs +0 -470
- package/scripts/daemon/goal-steward-cadence.test.mjs +0 -312
- package/scripts/daemon/inbox-deferral-session.test.mjs +0 -49
- package/scripts/daemon/inbox-deferral.test.mjs +0 -336
- package/scripts/daemon/inbox-wake.test.mjs +0 -199
- package/scripts/daemon/integration.test.mjs +0 -149
- package/scripts/daemon/lib/self-echo.test.mjs +0 -153
- package/scripts/daemon/lib/session-router.test.mjs +0 -295
- package/scripts/daemon/prompt-builder-preamble.test.mjs +0 -210
- package/scripts/daemon/prompt-builder.test.mjs +0 -344
- package/scripts/daemon/responder-cost.test.mjs +0 -68
- package/scripts/daemon/responder-history.test.mjs +0 -185
- package/scripts/daemon/sdk-version.test.mjs +0 -31
- package/scripts/daemon/session-lock.test.mjs +0 -252
- package/scripts/daemon/session-outcomes.test.mjs +0 -533
- package/scripts/daemon/typing-registry.test.mjs +0 -102
- package/scripts/hooks/pre-send-audit.test.mjs +0 -354
- package/scripts/huddle/huddle-prompt.test.mjs +0 -176
- package/scripts/local-triggers/autoupdate.test.mjs +0 -518
- package/scripts/local-triggers/generate-plists.test.mjs +0 -456
- package/scripts/media-generation/brand-clause.test.mjs +0 -135
- package/scripts/org/send-orgmail.first-contact.test.mjs +0 -102
- package/scripts/poller/inbox-privilege-injection.test.mjs +0 -167
- package/scripts/poller/inbox-scan-poller.test.mjs +0 -295
- package/scripts/poller/lib/cloud-relay-dedup.test.mjs +0 -133
- package/scripts/poller/slack-socket-mode.test.mjs +0 -805
- package/scripts/poller-launchd/install.test.mjs +0 -243
- package/scripts/restore-from-backup.test.mjs +0 -181
- package/scripts/session/feed.test.mjs +0 -196
- package/scripts/session/supervisor-sh.test.mjs +0 -218
- package/scripts/session/supervisor.test.mjs +0 -482
- package/scripts/setup/configure-macos.test.mjs +0 -306
- package/scripts/setup/gen-subagent-manifest.test.mjs +0 -124
- package/scripts/setup/generate-agent-package-json.test.mjs +0 -143
- package/scripts/setup/generate-capability.test.mjs +0 -134
- package/scripts/setup/init-agent.test.mjs +0 -370
- package/scripts/setup/init-skill-marketplace.test.mjs +0 -193
- package/scripts/vendor/sync-skill-packs.test.mjs +0 -103
- package/scripts/watchdog/memory-watchdog.test.mjs +0 -64
|
@@ -1,185 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* backup-freshness.test.mjs — coverage for lib/diagnostics/backup-freshness.mjs.
|
|
3
|
-
*
|
|
4
|
-
* Hermetic: every case builds a tmp `.maestro/` fixture (config + marker) and
|
|
5
|
-
* injects `now`, so no real backup machinery runs. Verifies the configured /
|
|
6
|
-
* stale / ageHours verdict for the cases doctor + alerting depend on.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import { test } from "node:test";
|
|
10
|
-
import assert from "node:assert/strict";
|
|
11
|
-
import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
|
|
12
|
-
import { tmpdir } from "node:os";
|
|
13
|
-
import { join } from "node:path";
|
|
14
|
-
|
|
15
|
-
import { backupFreshness, DEFAULT_STALE_HOURS } from "./backup-freshness.mjs";
|
|
16
|
-
|
|
17
|
-
const HOUR = 3_600_000;
|
|
18
|
-
|
|
19
|
-
/** Build a tmp agent root with optional backup-config.yaml + last-backup.json. */
|
|
20
|
-
function makeAgent({ configBody, marker } = {}) {
|
|
21
|
-
const root = mkdtempSync(join(tmpdir(), "bf-test-"));
|
|
22
|
-
mkdirSync(join(root, ".maestro"), { recursive: true });
|
|
23
|
-
if (configBody !== undefined) {
|
|
24
|
-
writeFileSync(join(root, ".maestro", "backup-config.yaml"), configBody);
|
|
25
|
-
}
|
|
26
|
-
if (marker !== undefined) {
|
|
27
|
-
writeFileSync(
|
|
28
|
-
join(root, ".maestro", "last-backup.json"),
|
|
29
|
-
typeof marker === "string" ? marker : JSON.stringify(marker)
|
|
30
|
-
);
|
|
31
|
-
}
|
|
32
|
-
return root;
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
function cleanup(root) {
|
|
36
|
-
rmSync(root, { recursive: true, force: true });
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
test("unconfigured (no files) → configured:false, not stale, no age", () => {
|
|
40
|
-
const root = makeAgent();
|
|
41
|
-
try {
|
|
42
|
-
const r = backupFreshness({ agentRoot: root, now: Date.now() });
|
|
43
|
-
assert.equal(r.configured, false);
|
|
44
|
-
assert.equal(r.stale, false);
|
|
45
|
-
assert.equal(r.lastBackupAt, null);
|
|
46
|
-
assert.equal(r.ageHours, null);
|
|
47
|
-
} finally {
|
|
48
|
-
cleanup(root);
|
|
49
|
-
}
|
|
50
|
-
});
|
|
51
|
-
|
|
52
|
-
test("scaffold default (enabled: false) → configured:false", () => {
|
|
53
|
-
const root = makeAgent({ configBody: "enabled: false\nprovider: gcs\n" });
|
|
54
|
-
try {
|
|
55
|
-
const r = backupFreshness({ agentRoot: root });
|
|
56
|
-
assert.equal(r.configured, false);
|
|
57
|
-
} finally {
|
|
58
|
-
cleanup(root);
|
|
59
|
-
}
|
|
60
|
-
});
|
|
61
|
-
|
|
62
|
-
test("enabled: true with a fresh marker → configured, not stale, age computed", () => {
|
|
63
|
-
const now = Date.parse("2026-06-11T12:00:00Z");
|
|
64
|
-
const completed_at = new Date(now - 6 * HOUR).toISOString(); // 6h ago
|
|
65
|
-
const root = makeAgent({
|
|
66
|
-
configBody: "enabled: true\nprovider: gcs\nbucket: x\nprefix: y\n",
|
|
67
|
-
marker: { completed_at, provider: "gcs", size_bytes: 1234 },
|
|
68
|
-
});
|
|
69
|
-
try {
|
|
70
|
-
const r = backupFreshness({ agentRoot: root, now });
|
|
71
|
-
assert.equal(r.configured, true);
|
|
72
|
-
assert.equal(r.stale, false);
|
|
73
|
-
assert.equal(r.lastBackupAt, completed_at);
|
|
74
|
-
assert.equal(r.ageHours, 6);
|
|
75
|
-
} finally {
|
|
76
|
-
cleanup(root);
|
|
77
|
-
}
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
test("enabled with a marker older than the window → stale", () => {
|
|
81
|
-
const now = Date.parse("2026-06-11T12:00:00Z");
|
|
82
|
-
const completed_at = new Date(now - 72 * HOUR).toISOString(); // 72h ago > 48h default
|
|
83
|
-
const root = makeAgent({
|
|
84
|
-
configBody: "enabled: true\n",
|
|
85
|
-
marker: { completed_at },
|
|
86
|
-
});
|
|
87
|
-
try {
|
|
88
|
-
const r = backupFreshness({ agentRoot: root, now });
|
|
89
|
-
assert.equal(r.configured, true);
|
|
90
|
-
assert.equal(r.ageHours, 72);
|
|
91
|
-
assert.equal(r.stale, true);
|
|
92
|
-
} finally {
|
|
93
|
-
cleanup(root);
|
|
94
|
-
}
|
|
95
|
-
});
|
|
96
|
-
|
|
97
|
-
test("stale boundary: exactly at staleHours is fresh; just over is stale", () => {
|
|
98
|
-
const now = Date.parse("2026-06-11T12:00:00Z");
|
|
99
|
-
const atBoundary = new Date(now - DEFAULT_STALE_HOURS * HOUR).toISOString();
|
|
100
|
-
const overBoundary = new Date(now - (DEFAULT_STALE_HOURS * HOUR + 60_000)).toISOString();
|
|
101
|
-
const rootA = makeAgent({ configBody: "enabled: true\n", marker: { completed_at: atBoundary } });
|
|
102
|
-
const rootB = makeAgent({ configBody: "enabled: true\n", marker: { completed_at: overBoundary } });
|
|
103
|
-
try {
|
|
104
|
-
assert.equal(backupFreshness({ agentRoot: rootA, now }).stale, false, "exactly at window is fresh");
|
|
105
|
-
assert.equal(backupFreshness({ agentRoot: rootB, now }).stale, true, "just over window is stale");
|
|
106
|
-
} finally {
|
|
107
|
-
cleanup(rootA);
|
|
108
|
-
cleanup(rootB);
|
|
109
|
-
}
|
|
110
|
-
});
|
|
111
|
-
|
|
112
|
-
test("custom staleHours is honoured", () => {
|
|
113
|
-
const now = Date.parse("2026-06-11T12:00:00Z");
|
|
114
|
-
const completed_at = new Date(now - 10 * HOUR).toISOString();
|
|
115
|
-
const root = makeAgent({ configBody: "enabled: true\n", marker: { completed_at } });
|
|
116
|
-
try {
|
|
117
|
-
// 10h old: stale under an 8h window, fresh under the 48h default.
|
|
118
|
-
assert.equal(backupFreshness({ agentRoot: root, now, staleHours: 8 }).stale, true);
|
|
119
|
-
assert.equal(backupFreshness({ agentRoot: root, now }).stale, false);
|
|
120
|
-
} finally {
|
|
121
|
-
cleanup(root);
|
|
122
|
-
}
|
|
123
|
-
});
|
|
124
|
-
|
|
125
|
-
test("configured but NO marker → stale (a backup that never ran)", () => {
|
|
126
|
-
const root = makeAgent({ configBody: "enabled: true\n" });
|
|
127
|
-
try {
|
|
128
|
-
const r = backupFreshness({ agentRoot: root, now: Date.now() });
|
|
129
|
-
assert.equal(r.configured, true);
|
|
130
|
-
assert.equal(r.lastBackupAt, null);
|
|
131
|
-
assert.equal(r.ageHours, null);
|
|
132
|
-
assert.equal(r.stale, true);
|
|
133
|
-
} finally {
|
|
134
|
-
cleanup(root);
|
|
135
|
-
}
|
|
136
|
-
});
|
|
137
|
-
|
|
138
|
-
test("configured with a corrupt marker → stale, not a throw", () => {
|
|
139
|
-
const root = makeAgent({ configBody: "enabled: true\n", marker: "{not json" });
|
|
140
|
-
try {
|
|
141
|
-
const r = backupFreshness({ agentRoot: root, now: Date.now() });
|
|
142
|
-
assert.equal(r.configured, true);
|
|
143
|
-
assert.equal(r.lastBackupAt, null);
|
|
144
|
-
assert.equal(r.stale, true);
|
|
145
|
-
} finally {
|
|
146
|
-
cleanup(root);
|
|
147
|
-
}
|
|
148
|
-
});
|
|
149
|
-
|
|
150
|
-
test("future-dated marker (clock skew) is treated as fresh, not stale", () => {
|
|
151
|
-
const now = Date.parse("2026-06-11T12:00:00Z");
|
|
152
|
-
const completed_at = new Date(now + 2 * HOUR).toISOString(); // 2h in the future
|
|
153
|
-
const root = makeAgent({ configBody: "enabled: true\n", marker: { completed_at } });
|
|
154
|
-
try {
|
|
155
|
-
const r = backupFreshness({ agentRoot: root, now });
|
|
156
|
-
assert.equal(r.stale, false);
|
|
157
|
-
assert.ok(r.ageHours < 0, "negative age for a future marker");
|
|
158
|
-
} finally {
|
|
159
|
-
cleanup(root);
|
|
160
|
-
}
|
|
161
|
-
});
|
|
162
|
-
|
|
163
|
-
test("explicit configPath + markerPath overrides agentRoot", () => {
|
|
164
|
-
const now = Date.parse("2026-06-11T12:00:00Z");
|
|
165
|
-
const root = mkdtempSync(join(tmpdir(), "bf-explicit-"));
|
|
166
|
-
const cfg = join(root, "cfg.yaml");
|
|
167
|
-
const mk = join(root, "marker.json");
|
|
168
|
-
writeFileSync(cfg, "enabled: true\n");
|
|
169
|
-
writeFileSync(mk, JSON.stringify({ completed_at: new Date(now - HOUR).toISOString() }));
|
|
170
|
-
try {
|
|
171
|
-
const r = backupFreshness({ configPath: cfg, markerPath: mk, now });
|
|
172
|
-
assert.equal(r.configured, true);
|
|
173
|
-
assert.equal(r.ageHours, 1);
|
|
174
|
-
assert.equal(r.stale, false);
|
|
175
|
-
} finally {
|
|
176
|
-
cleanup(root);
|
|
177
|
-
}
|
|
178
|
-
});
|
|
179
|
-
|
|
180
|
-
test("never throws on a totally bogus cfg", () => {
|
|
181
|
-
assert.doesNotThrow(() => backupFreshness(null));
|
|
182
|
-
assert.doesNotThrow(() => backupFreshness({ agentRoot: 42, now: "x" }));
|
|
183
|
-
const r = backupFreshness({ configPath: 12345 });
|
|
184
|
-
assert.equal(typeof r.configured, "boolean");
|
|
185
|
-
});
|
|
@@ -1,206 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* lib/diagnostics/counters.test.mjs
|
|
3
|
-
*
|
|
4
|
-
* node:test coverage for the loud guard-fail-open counters:
|
|
5
|
-
* - bump increments the in-memory tally and persists a JSONL row
|
|
6
|
-
* - bump persists to the date-stamped path under the counters dir
|
|
7
|
-
* - snapshot sums today's rows per name from disk (cross-restart view)
|
|
8
|
-
* - snapshot is isolated to "today" by the injected clock
|
|
9
|
-
* - bump never throws on an un-serializable attr / bad name / failing append
|
|
10
|
-
* - snapshot never throws on a missing dir / corrupt line / unreadable file
|
|
11
|
-
* - concurrent-style appends (multiple rows) sum correctly
|
|
12
|
-
*
|
|
13
|
-
* Run: cd /Users/layla/maestro && node --test lib/diagnostics/counters.test.mjs
|
|
14
|
-
*/
|
|
15
|
-
|
|
16
|
-
import test from "node:test";
|
|
17
|
-
import assert from "node:assert/strict";
|
|
18
|
-
import { mkdtempSync, rmSync, readdirSync, readFileSync } from "node:fs";
|
|
19
|
-
import { tmpdir } from "node:os";
|
|
20
|
-
import { join } from "node:path";
|
|
21
|
-
|
|
22
|
-
import {
|
|
23
|
-
bump,
|
|
24
|
-
snapshot,
|
|
25
|
-
memSnapshot,
|
|
26
|
-
resetMem,
|
|
27
|
-
listStreams,
|
|
28
|
-
} from "./counters.mjs";
|
|
29
|
-
|
|
30
|
-
function tmpDir() {
|
|
31
|
-
return mkdtempSync(join(tmpdir(), "maestro-counters-"));
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
/** Fixed clock at 2026-06-11T12:00:00Z. */
|
|
35
|
-
const FIXED = Date.parse("2026-06-11T12:00:00.000Z");
|
|
36
|
-
const fixedNow = () => FIXED;
|
|
37
|
-
|
|
38
|
-
test("bump increments the in-memory tally and returns the new total", () => {
|
|
39
|
-
resetMem();
|
|
40
|
-
const captured = [];
|
|
41
|
-
const append = (p, row) => { captured.push({ p, row }); return true; };
|
|
42
|
-
|
|
43
|
-
const t1 = bump("rate_guard.persist_failed", { provider: "anthropic" }, { append, now: fixedNow });
|
|
44
|
-
const t2 = bump("rate_guard.persist_failed", { provider: "anthropic" }, { append, now: fixedNow });
|
|
45
|
-
assert.equal(t1, 1);
|
|
46
|
-
assert.equal(t2, 2);
|
|
47
|
-
assert.equal(memSnapshot()["rate_guard.persist_failed"], 2);
|
|
48
|
-
assert.equal(captured.length, 2);
|
|
49
|
-
assert.equal(captured[0].row.name, "rate_guard.persist_failed");
|
|
50
|
-
assert.equal(captured[0].row.by, 1);
|
|
51
|
-
assert.equal(captured[0].row.attrs.provider, "anthropic");
|
|
52
|
-
assert.equal(typeof captured[0].row.ts, "string");
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
test("bump honours an explicit increment amount", () => {
|
|
56
|
-
resetMem();
|
|
57
|
-
const append = () => true;
|
|
58
|
-
assert.equal(bump("budget.stale_ledger", {}, { append, by: 5, now: fixedNow }), 5);
|
|
59
|
-
assert.equal(bump("budget.stale_ledger", {}, { append, by: 3, now: fixedNow }), 8);
|
|
60
|
-
});
|
|
61
|
-
|
|
62
|
-
test("bump persists to a date-stamped path under the counters dir", () => {
|
|
63
|
-
resetMem();
|
|
64
|
-
const dir = tmpDir();
|
|
65
|
-
try {
|
|
66
|
-
bump("g.fail", { reason: "x" }, { dir, now: fixedNow });
|
|
67
|
-
const files = readdirSync(dir);
|
|
68
|
-
assert.deepEqual(files, ["2026-06-11.jsonl"]);
|
|
69
|
-
const raw = readFileSync(join(dir, "2026-06-11.jsonl"), "utf-8").trim();
|
|
70
|
-
const row = JSON.parse(raw);
|
|
71
|
-
assert.equal(row.name, "g.fail");
|
|
72
|
-
assert.equal(row.by, 1);
|
|
73
|
-
assert.equal(row.attrs.reason, "x");
|
|
74
|
-
} finally {
|
|
75
|
-
rmSync(dir, { recursive: true, force: true });
|
|
76
|
-
}
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
test("snapshot sums today's rows per name from disk", () => {
|
|
80
|
-
resetMem();
|
|
81
|
-
const dir = tmpDir();
|
|
82
|
-
try {
|
|
83
|
-
bump("a", {}, { dir, now: fixedNow });
|
|
84
|
-
bump("a", {}, { dir, now: fixedNow });
|
|
85
|
-
bump("b", {}, { dir, now: fixedNow, by: 4 });
|
|
86
|
-
const snap = snapshot({ dir, now: fixedNow });
|
|
87
|
-
assert.equal(snap.a, 2);
|
|
88
|
-
assert.equal(snap.b, 4);
|
|
89
|
-
} finally {
|
|
90
|
-
rmSync(dir, { recursive: true, force: true });
|
|
91
|
-
}
|
|
92
|
-
});
|
|
93
|
-
|
|
94
|
-
test("snapshot is isolated to the clock's day", () => {
|
|
95
|
-
resetMem();
|
|
96
|
-
const dir = tmpDir();
|
|
97
|
-
try {
|
|
98
|
-
const day1 = () => Date.parse("2026-06-11T01:00:00.000Z");
|
|
99
|
-
const day2 = () => Date.parse("2026-06-12T01:00:00.000Z");
|
|
100
|
-
bump("x", {}, { dir, now: day1 });
|
|
101
|
-
bump("x", {}, { dir, now: day1 });
|
|
102
|
-
bump("x", {}, { dir, now: day2 });
|
|
103
|
-
// Two distinct day files exist.
|
|
104
|
-
assert.deepEqual(readdirSync(dir).sort(), ["2026-06-11.jsonl", "2026-06-12.jsonl"]);
|
|
105
|
-
// Each day's snapshot only sees its own rows.
|
|
106
|
-
assert.equal(snapshot({ dir, now: day1 }).x, 2);
|
|
107
|
-
assert.equal(snapshot({ dir, now: day2 }).x, 1);
|
|
108
|
-
} finally {
|
|
109
|
-
rmSync(dir, { recursive: true, force: true });
|
|
110
|
-
}
|
|
111
|
-
});
|
|
112
|
-
|
|
113
|
-
test("snapshot survives across a simulated restart (reads disk, not memory)", () => {
|
|
114
|
-
resetMem();
|
|
115
|
-
const dir = tmpDir();
|
|
116
|
-
try {
|
|
117
|
-
bump("survives", {}, { dir, now: fixedNow });
|
|
118
|
-
bump("survives", {}, { dir, now: fixedNow });
|
|
119
|
-
// Simulate a process restart: the in-memory tally is gone, the disk isn't.
|
|
120
|
-
resetMem();
|
|
121
|
-
assert.deepEqual(memSnapshot(), {});
|
|
122
|
-
assert.equal(snapshot({ dir, now: fixedNow }).survives, 2);
|
|
123
|
-
} finally {
|
|
124
|
-
rmSync(dir, { recursive: true, force: true });
|
|
125
|
-
}
|
|
126
|
-
});
|
|
127
|
-
|
|
128
|
-
test("bump never throws and still moves the in-memory tally when append fails", () => {
|
|
129
|
-
resetMem();
|
|
130
|
-
const failingAppend = () => { throw new Error("disk full"); };
|
|
131
|
-
// append throwing must NOT propagate; the in-memory tally must still advance.
|
|
132
|
-
const total = bump("resilient", {}, { append: failingAppend, now: fixedNow });
|
|
133
|
-
// append threw before returning, but the in-memory bump happened first.
|
|
134
|
-
assert.equal(total, 1);
|
|
135
|
-
assert.equal(memSnapshot().resilient, 1);
|
|
136
|
-
});
|
|
137
|
-
|
|
138
|
-
test("bump tolerates an un-serializable attr and a non-string name", () => {
|
|
139
|
-
resetMem();
|
|
140
|
-
const captured = [];
|
|
141
|
-
const append = (p, row) => { captured.push(row); return true; };
|
|
142
|
-
const circular = {};
|
|
143
|
-
circular.self = circular;
|
|
144
|
-
// A circular attrs object would break naive JSON.stringify; bump must not throw.
|
|
145
|
-
assert.doesNotThrow(() => bump("circ", circular, { append, now: fixedNow }));
|
|
146
|
-
// A non-string name folds to a stable string rather than dropping the row.
|
|
147
|
-
const total = bump(12345, {}, { append, now: fixedNow });
|
|
148
|
-
assert.equal(total, 1);
|
|
149
|
-
assert.equal(captured.at(-1).name, "12345");
|
|
150
|
-
});
|
|
151
|
-
|
|
152
|
-
test("an empty/whitespace name folds to 'unknown'", () => {
|
|
153
|
-
resetMem();
|
|
154
|
-
const captured = [];
|
|
155
|
-
const append = (p, row) => { captured.push(row); return true; };
|
|
156
|
-
bump(" ", {}, { append, now: fixedNow });
|
|
157
|
-
assert.equal(captured.at(-1).name, "unknown");
|
|
158
|
-
});
|
|
159
|
-
|
|
160
|
-
test("snapshot returns {} for a missing dir and never throws", () => {
|
|
161
|
-
resetMem();
|
|
162
|
-
const dir = join(tmpDir(), "does-not-exist");
|
|
163
|
-
assert.deepEqual(snapshot({ dir, now: fixedNow }), {});
|
|
164
|
-
});
|
|
165
|
-
|
|
166
|
-
test("snapshot skips corrupt lines but sums the valid ones", () => {
|
|
167
|
-
resetMem();
|
|
168
|
-
const good = JSON.stringify({ name: "ok", by: 2 });
|
|
169
|
-
const good2 = JSON.stringify({ name: "ok", by: 3 });
|
|
170
|
-
const raw = `${good}\nnot json at all\n${good2}\n{"name":123}\n`;
|
|
171
|
-
const read = () => raw;
|
|
172
|
-
const snap = snapshot({ now: fixedNow, read });
|
|
173
|
-
assert.equal(snap.ok, 5); // 2 + 3; the garbage line and the bad-name line skip
|
|
174
|
-
});
|
|
175
|
-
|
|
176
|
-
test("snapshot treats a row with a missing/NaN by as 1", () => {
|
|
177
|
-
resetMem();
|
|
178
|
-
const raw = `${JSON.stringify({ name: "n" })}\n${JSON.stringify({ name: "n", by: "x" })}\n`;
|
|
179
|
-
const snap = snapshot({ now: fixedNow, read: () => raw });
|
|
180
|
-
assert.equal(snap.n, 2); // both default to +1
|
|
181
|
-
});
|
|
182
|
-
|
|
183
|
-
test("snapshot returns {} when the reader throws (unreadable file)", () => {
|
|
184
|
-
resetMem();
|
|
185
|
-
const read = () => { throw new Error("EACCES"); };
|
|
186
|
-
assert.deepEqual(snapshot({ now: fixedNow, read }), {});
|
|
187
|
-
});
|
|
188
|
-
|
|
189
|
-
test("listStreams enumerates the date-stamped streams in order", () => {
|
|
190
|
-
resetMem();
|
|
191
|
-
const dir = tmpDir();
|
|
192
|
-
try {
|
|
193
|
-
bump("s", {}, { dir, now: () => Date.parse("2026-06-11T00:00:00Z") });
|
|
194
|
-
bump("s", {}, { dir, now: () => Date.parse("2026-06-09T00:00:00Z") });
|
|
195
|
-
const streams = listStreams({ dir });
|
|
196
|
-
assert.equal(streams.length, 2);
|
|
197
|
-
assert.ok(streams[0].endsWith("2026-06-09.jsonl"));
|
|
198
|
-
assert.ok(streams[1].endsWith("2026-06-11.jsonl"));
|
|
199
|
-
} finally {
|
|
200
|
-
rmSync(dir, { recursive: true, force: true });
|
|
201
|
-
}
|
|
202
|
-
});
|
|
203
|
-
|
|
204
|
-
test("listStreams returns [] for a missing dir", () => {
|
|
205
|
-
assert.deepEqual(listStreams({ dir: join(tmpdir(), "nope-counters-xyz") }), []);
|
|
206
|
-
});
|
|
@@ -1,290 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* events.test.mjs — node:test coverage for the diagnostic-event spine.
|
|
3
|
-
*
|
|
4
|
-
* Hermetic: each test writes into an isolated tmpdir and injects a fixed clock,
|
|
5
|
-
* so date-stamped filenames and timestamps are deterministic. We assert the
|
|
6
|
-
* on-disk JSONL is valid, carries trace_id, and that emitEvent NEVER throws —
|
|
7
|
-
* including on an unwritable directory.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import { test } from "node:test";
|
|
11
|
-
import assert from "node:assert/strict";
|
|
12
|
-
import { promises as fsp } from "node:fs";
|
|
13
|
-
import { readFileSync, existsSync } from "node:fs";
|
|
14
|
-
import { tmpdir } from "node:os";
|
|
15
|
-
import { join } from "node:path";
|
|
16
|
-
|
|
17
|
-
import {
|
|
18
|
-
emitEvent,
|
|
19
|
-
isValidEventType,
|
|
20
|
-
EVENT_TYPES,
|
|
21
|
-
} from "./events.mjs";
|
|
22
|
-
import { mintTraceId, withTrace } from "./trace.mjs";
|
|
23
|
-
|
|
24
|
-
async function makeDir() {
|
|
25
|
-
const path = join(
|
|
26
|
-
tmpdir(),
|
|
27
|
-
`events-test-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
|
|
28
|
-
);
|
|
29
|
-
await fsp.mkdir(path, { recursive: true });
|
|
30
|
-
return path;
|
|
31
|
-
}
|
|
32
|
-
async function rm(path) {
|
|
33
|
-
try { await fsp.rm(path, { recursive: true, force: true }); } catch { /* */ }
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
const FIXED_MS = Date.UTC(2026, 5, 11, 12, 30, 0); // 2026-06-11T12:30:00Z
|
|
37
|
-
const fixedNow = () => FIXED_MS;
|
|
38
|
-
|
|
39
|
-
function readRows(logDir) {
|
|
40
|
-
const file = join(logDir, "2026-06-11.jsonl");
|
|
41
|
-
const body = readFileSync(file, "utf-8");
|
|
42
|
-
return body
|
|
43
|
-
.trim()
|
|
44
|
-
.split("\n")
|
|
45
|
-
.filter(Boolean)
|
|
46
|
-
.map((l) => JSON.parse(l)); // throws if any line is not valid JSON
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
// ---------------------------------------------------------------------------
|
|
50
|
-
// EVENT_TYPES contract
|
|
51
|
-
// ---------------------------------------------------------------------------
|
|
52
|
-
|
|
53
|
-
test("EVENT_TYPES is the closed 8-type set and is frozen", () => {
|
|
54
|
-
const values = Object.values(EVENT_TYPES).sort();
|
|
55
|
-
assert.deepEqual(values, [
|
|
56
|
-
"classified",
|
|
57
|
-
"dispatched",
|
|
58
|
-
"error",
|
|
59
|
-
"guard_fail",
|
|
60
|
-
"item_received",
|
|
61
|
-
"sent",
|
|
62
|
-
"session_closed",
|
|
63
|
-
"session_opened",
|
|
64
|
-
]);
|
|
65
|
-
assert.ok(Object.isFrozen(EVENT_TYPES));
|
|
66
|
-
});
|
|
67
|
-
|
|
68
|
-
test("isValidEventType only accepts the contract types", () => {
|
|
69
|
-
assert.equal(isValidEventType("item_received"), true);
|
|
70
|
-
assert.equal(isValidEventType("sent"), true);
|
|
71
|
-
assert.equal(isValidEventType("nope"), false);
|
|
72
|
-
assert.equal(isValidEventType(""), false);
|
|
73
|
-
assert.equal(isValidEventType(null), false);
|
|
74
|
-
assert.equal(isValidEventType(42), false);
|
|
75
|
-
});
|
|
76
|
-
|
|
77
|
-
// ---------------------------------------------------------------------------
|
|
78
|
-
// emitEvent — happy path writes valid JSONL with trace_id
|
|
79
|
-
// ---------------------------------------------------------------------------
|
|
80
|
-
|
|
81
|
-
test("emitEvent writes a valid JSONL row with the full contract shape", async () => {
|
|
82
|
-
const logDir = await makeDir();
|
|
83
|
-
try {
|
|
84
|
-
const traceId = mintTraceId();
|
|
85
|
-
const ok = emitEvent(
|
|
86
|
-
{
|
|
87
|
-
type: EVENT_TYPES.ITEM_RECEIVED,
|
|
88
|
-
trace_id: traceId,
|
|
89
|
-
span: "root",
|
|
90
|
-
attrs: { source: "slack", item_id: "C123.456" },
|
|
91
|
-
},
|
|
92
|
-
{ now: fixedNow, logDir }
|
|
93
|
-
);
|
|
94
|
-
assert.equal(ok, true);
|
|
95
|
-
|
|
96
|
-
const rows = readRows(logDir);
|
|
97
|
-
assert.equal(rows.length, 1);
|
|
98
|
-
const row = rows[0];
|
|
99
|
-
assert.equal(row.type, "item_received");
|
|
100
|
-
assert.equal(row.trace_id, traceId);
|
|
101
|
-
assert.equal(row.span, "root");
|
|
102
|
-
assert.equal(row.ts, "2026-06-11T12:30:00.000Z");
|
|
103
|
-
assert.deepEqual(row.attrs, { source: "slack", item_id: "C123.456" });
|
|
104
|
-
} finally {
|
|
105
|
-
await rm(logDir);
|
|
106
|
-
}
|
|
107
|
-
});
|
|
108
|
-
|
|
109
|
-
test("emitEvent appends successive rows to the same date stream", async () => {
|
|
110
|
-
const logDir = await makeDir();
|
|
111
|
-
try {
|
|
112
|
-
const t = mintTraceId();
|
|
113
|
-
emitEvent({ type: "item_received", trace_id: t }, { now: fixedNow, logDir });
|
|
114
|
-
emitEvent({ type: "classified", trace_id: t }, { now: fixedNow, logDir });
|
|
115
|
-
emitEvent({ type: "sent", trace_id: t }, { now: fixedNow, logDir });
|
|
116
|
-
const rows = readRows(logDir);
|
|
117
|
-
assert.equal(rows.length, 3);
|
|
118
|
-
assert.deepEqual(rows.map((r) => r.type), ["item_received", "classified", "sent"]);
|
|
119
|
-
// All correlate to one interaction.
|
|
120
|
-
assert.ok(rows.every((r) => r.trace_id === t));
|
|
121
|
-
} finally {
|
|
122
|
-
await rm(logDir);
|
|
123
|
-
}
|
|
124
|
-
});
|
|
125
|
-
|
|
126
|
-
test("emitEvent names the file by UTC date of the event", async () => {
|
|
127
|
-
const logDir = await makeDir();
|
|
128
|
-
try {
|
|
129
|
-
emitEvent({ type: "sent" }, { now: fixedNow, logDir });
|
|
130
|
-
assert.ok(existsSync(join(logDir, "2026-06-11.jsonl")));
|
|
131
|
-
} finally {
|
|
132
|
-
await rm(logDir);
|
|
133
|
-
}
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
// ---------------------------------------------------------------------------
|
|
137
|
-
// emitEvent — ambient trace context fills trace_id/span
|
|
138
|
-
// ---------------------------------------------------------------------------
|
|
139
|
-
|
|
140
|
-
test("emitEvent inherits trace_id/span from the ambient withTrace context", async () => {
|
|
141
|
-
const logDir = await makeDir();
|
|
142
|
-
try {
|
|
143
|
-
const traceId = mintTraceId();
|
|
144
|
-
withTrace({ trace_id: traceId, span: "root.classify" }, () => {
|
|
145
|
-
emitEvent({ type: "classified", attrs: { category: "action_required" } }, {
|
|
146
|
-
now: fixedNow,
|
|
147
|
-
logDir,
|
|
148
|
-
});
|
|
149
|
-
});
|
|
150
|
-
const [row] = readRows(logDir);
|
|
151
|
-
assert.equal(row.trace_id, traceId);
|
|
152
|
-
assert.equal(row.span, "root.classify");
|
|
153
|
-
} finally {
|
|
154
|
-
await rm(logDir);
|
|
155
|
-
}
|
|
156
|
-
});
|
|
157
|
-
|
|
158
|
-
test("emitEvent trace_id is null when no id supplied and no ambient context", async () => {
|
|
159
|
-
const logDir = await makeDir();
|
|
160
|
-
try {
|
|
161
|
-
emitEvent({ type: "error", attrs: { msg: "boom" } }, { now: fixedNow, logDir });
|
|
162
|
-
const [row] = readRows(logDir);
|
|
163
|
-
assert.equal(row.trace_id, null);
|
|
164
|
-
assert.equal(row.span, "root");
|
|
165
|
-
} finally {
|
|
166
|
-
await rm(logDir);
|
|
167
|
-
}
|
|
168
|
-
});
|
|
169
|
-
|
|
170
|
-
test("an explicit trace_id overrides the ambient context", async () => {
|
|
171
|
-
const logDir = await makeDir();
|
|
172
|
-
try {
|
|
173
|
-
const ambient = mintTraceId();
|
|
174
|
-
const explicit = mintTraceId();
|
|
175
|
-
withTrace(ambient, () => {
|
|
176
|
-
emitEvent({ type: "sent", trace_id: explicit }, { now: fixedNow, logDir });
|
|
177
|
-
});
|
|
178
|
-
const [row] = readRows(logDir);
|
|
179
|
-
assert.equal(row.trace_id, explicit);
|
|
180
|
-
} finally {
|
|
181
|
-
await rm(logDir);
|
|
182
|
-
}
|
|
183
|
-
});
|
|
184
|
-
|
|
185
|
-
// ---------------------------------------------------------------------------
|
|
186
|
-
// emitEvent — closed type set: unknown type is coerced to error
|
|
187
|
-
// ---------------------------------------------------------------------------
|
|
188
|
-
|
|
189
|
-
test("an unknown event type is coerced to error and preserves the original", async () => {
|
|
190
|
-
const logDir = await makeDir();
|
|
191
|
-
try {
|
|
192
|
-
emitEvent({ type: "totally_made_up", attrs: { a: 1 } }, { now: fixedNow, logDir });
|
|
193
|
-
const [row] = readRows(logDir);
|
|
194
|
-
assert.equal(row.type, "error");
|
|
195
|
-
assert.equal(row.attrs._invalid_type, "totally_made_up");
|
|
196
|
-
assert.equal(row.attrs.a, 1);
|
|
197
|
-
} finally {
|
|
198
|
-
await rm(logDir);
|
|
199
|
-
}
|
|
200
|
-
});
|
|
201
|
-
|
|
202
|
-
test("a missing type is coerced to error with _invalid_type null", async () => {
|
|
203
|
-
const logDir = await makeDir();
|
|
204
|
-
try {
|
|
205
|
-
emitEvent({ attrs: {} }, { now: fixedNow, logDir });
|
|
206
|
-
const [row] = readRows(logDir);
|
|
207
|
-
assert.equal(row.type, "error");
|
|
208
|
-
assert.equal(row.attrs._invalid_type, null);
|
|
209
|
-
} finally {
|
|
210
|
-
await rm(logDir);
|
|
211
|
-
}
|
|
212
|
-
});
|
|
213
|
-
|
|
214
|
-
// ---------------------------------------------------------------------------
|
|
215
|
-
// emitEvent — never throws; degrades to false
|
|
216
|
-
// ---------------------------------------------------------------------------
|
|
217
|
-
|
|
218
|
-
test("emitEvent never throws on a bad/unwritable dir (returns false)", async () => {
|
|
219
|
-
const logDir = await makeDir();
|
|
220
|
-
try {
|
|
221
|
-
// Make the diagnostics dir a FILE so mkdir/append fails.
|
|
222
|
-
const blocker = join(logDir, "blocked");
|
|
223
|
-
await fsp.writeFile(blocker, "x");
|
|
224
|
-
// Point logDir at a path under the file → cannot create a directory there.
|
|
225
|
-
const badDir = join(blocker, "diagnostics");
|
|
226
|
-
let ok;
|
|
227
|
-
assert.doesNotThrow(() => {
|
|
228
|
-
ok = emitEvent({ type: "sent", trace_id: "T" }, { now: fixedNow, logDir: badDir });
|
|
229
|
-
});
|
|
230
|
-
assert.equal(ok, false);
|
|
231
|
-
} finally {
|
|
232
|
-
await rm(logDir);
|
|
233
|
-
}
|
|
234
|
-
});
|
|
235
|
-
|
|
236
|
-
test("emitEvent never throws on a null/garbage event argument", () => {
|
|
237
|
-
let ok;
|
|
238
|
-
assert.doesNotThrow(() => {
|
|
239
|
-
ok = emitEvent(null, { append: () => true });
|
|
240
|
-
});
|
|
241
|
-
assert.equal(ok, true); // coerced to {} → error row, write succeeds
|
|
242
|
-
});
|
|
243
|
-
|
|
244
|
-
test("emitEvent returns false when the injected appender fails", () => {
|
|
245
|
-
const ok = emitEvent(
|
|
246
|
-
{ type: "sent", trace_id: "T" },
|
|
247
|
-
{ append: () => false }
|
|
248
|
-
);
|
|
249
|
-
assert.equal(ok, false);
|
|
250
|
-
});
|
|
251
|
-
|
|
252
|
-
test("emitEvent never throws when the appender itself throws", () => {
|
|
253
|
-
let ok;
|
|
254
|
-
assert.doesNotThrow(() => {
|
|
255
|
-
ok = emitEvent({ type: "sent" }, {
|
|
256
|
-
append: () => { throw new Error("disk gone"); },
|
|
257
|
-
});
|
|
258
|
-
});
|
|
259
|
-
assert.equal(ok, false);
|
|
260
|
-
});
|
|
261
|
-
|
|
262
|
-
test("emitEvent tolerates non-object attrs by wrapping them", async () => {
|
|
263
|
-
const logDir = await makeDir();
|
|
264
|
-
try {
|
|
265
|
-
emitEvent({ type: "sent", trace_id: "T", attrs: "just a string" }, {
|
|
266
|
-
now: fixedNow,
|
|
267
|
-
logDir,
|
|
268
|
-
});
|
|
269
|
-
const [row] = readRows(logDir);
|
|
270
|
-
assert.deepEqual(row.attrs, { value: "just a string" });
|
|
271
|
-
} finally {
|
|
272
|
-
await rm(logDir);
|
|
273
|
-
}
|
|
274
|
-
});
|
|
275
|
-
|
|
276
|
-
test("emitEvent uses the injected appender with the date-stamped path", () => {
|
|
277
|
-
const calls = [];
|
|
278
|
-
const ok = emitEvent(
|
|
279
|
-
{ type: "dispatched", trace_id: "T" },
|
|
280
|
-
{
|
|
281
|
-
now: fixedNow,
|
|
282
|
-
logDir: "/somewhere/logs/diagnostics",
|
|
283
|
-
append: (path, record) => { calls.push({ path, record }); return true; },
|
|
284
|
-
}
|
|
285
|
-
);
|
|
286
|
-
assert.equal(ok, true);
|
|
287
|
-
assert.equal(calls.length, 1);
|
|
288
|
-
assert.equal(calls[0].path, "/somewhere/logs/diagnostics/2026-06-11.jsonl");
|
|
289
|
-
assert.equal(calls[0].record.type, "dispatched");
|
|
290
|
-
});
|