@mastra/factory 0.27.0 → 0.28.0-alpha.1
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/README.md +215 -41
- package/dist/boards/board-events.d.ts +34 -0
- package/dist/boards/board-events.d.ts.map +1 -0
- package/dist/boards/board-events.js +50 -0
- package/dist/boards/board-events.js.map +1 -0
- package/dist/boards/board-writes.d.ts +86 -0
- package/dist/boards/board-writes.d.ts.map +1 -0
- package/dist/boards/board-writes.js +252 -0
- package/dist/boards/board-writes.js.map +1 -0
- package/dist/boards/define-board.d.ts +16 -5
- package/dist/boards/define-board.d.ts.map +1 -1
- package/dist/boards/define-board.js +30 -8
- package/dist/boards/define-board.js.map +1 -1
- package/dist/boards/index.js +1 -1
- package/dist/boards/intake-routing.d.ts +30 -6
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +43 -5
- package/dist/boards/intake-routing.js.map +1 -1
- package/dist/boards/legacy-plan-role.d.ts.map +1 -1
- package/dist/boards/legacy-plan-role.js +8 -4
- package/dist/boards/legacy-plan-role.js.map +1 -1
- package/dist/boards/phase-automation.d.ts.map +1 -1
- package/dist/boards/phase-automation.js +7 -2
- package/dist/boards/phase-automation.js.map +1 -1
- package/dist/boards/project-boards.d.ts +18 -7
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +79 -15
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/stored-board.d.ts +59 -1
- package/dist/boards/stored-board.d.ts.map +1 -1
- package/dist/boards/stored-board.js +219 -7
- package/dist/boards/stored-board.js.map +1 -1
- package/dist/boards/work.js +1 -1
- package/dist/dispatch-wake.d.ts +13 -0
- package/dist/dispatch-wake.d.ts.map +1 -0
- package/dist/dispatch-wake.js +30 -0
- package/dist/dispatch-wake.js.map +1 -0
- package/dist/environment/build-runner.d.ts +1 -1
- package/dist/environment/build-runner.d.ts.map +1 -1
- package/dist/environment/build-runner.js +2 -2
- package/dist/environment/build-workflow.d.ts +1 -1
- package/dist/environment/build-workflow.d.ts.map +1 -1
- package/dist/environment/build-workflow.js +1 -1
- package/dist/environment/build.js +1 -1
- package/dist/factory.d.ts +63 -9
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +237 -59
- package/dist/factory.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -9
- package/dist/integrations/base.d.ts +6 -0
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/channel-thread-announcements.d.ts +5 -0
- package/dist/integrations/channel-thread-announcements.d.ts.map +1 -1
- package/dist/integrations/channel-thread-announcements.js +24 -2
- package/dist/integrations/channel-thread-announcements.js.map +1 -1
- package/dist/integrations/github/acceptance-labels.d.ts +4 -0
- package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
- package/dist/integrations/github/acceptance-labels.js +1 -1
- package/dist/integrations/github/acceptance-labels.js.map +1 -1
- package/dist/integrations/github/default-rules.d.ts +2 -9
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +7 -6
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/integration.js +2 -2
- package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/github/issue-reconciler.js +17 -1
- package/dist/integrations/github/issue-reconciler.js.map +1 -1
- package/dist/integrations/github/review-status-comment.d.ts +61 -0
- package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
- package/dist/integrations/github/review-status-comment.js +217 -0
- package/dist/integrations/github/review-status-comment.js.map +1 -0
- package/dist/integrations/github/review-status-reporter.d.ts +42 -0
- package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
- package/dist/integrations/github/review-status-reporter.js +100 -0
- package/dist/integrations/github/review-status-reporter.js.map +1 -0
- package/dist/integrations/github/review-status.d.ts +28 -0
- package/dist/integrations/github/review-status.d.ts.map +1 -0
- package/dist/integrations/github/review-status.js +95 -0
- package/dist/integrations/github/review-status.js.map +1 -0
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +19 -21
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +13 -1
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +80 -9
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.js +1 -1
- package/dist/integrations/github/session-subscriptions.js +3 -3
- package/dist/integrations/github/webhook.js +2 -2
- package/dist/integrations/gitlab/default-rules.d.ts +24 -9
- package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +4 -4
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/integration.js +2 -2
- package/dist/integrations/gitlab/issue-reconciler.js +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.js +2 -2
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +2 -4
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +16 -0
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +71 -6
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/gitlab/session-subscriptions.js +1 -1
- package/dist/integrations/gitlab/webhook-dispatch.js +1 -1
- package/dist/integrations/incidentio/default-rules.d.ts +1 -9
- package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/default-rules.js +3 -4
- package/dist/integrations/incidentio/default-rules.js.map +1 -1
- package/dist/integrations/incidentio/integration.js +3 -3
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +1 -4
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +7 -0
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +37 -5
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/jira/default-rules.d.ts +1 -9
- package/dist/integrations/jira/default-rules.d.ts.map +1 -1
- package/dist/integrations/jira/default-rules.js +3 -4
- package/dist/integrations/jira/default-rules.js.map +1 -1
- package/dist/integrations/jira/integration.js +2 -2
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +2 -5
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +7 -0
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +37 -5
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/default-rules.d.ts +1 -9
- package/dist/integrations/linear/default-rules.d.ts.map +1 -1
- package/dist/integrations/linear/default-rules.js +3 -4
- package/dist/integrations/linear/default-rules.js.map +1 -1
- package/dist/integrations/linear/integration.js +2 -2
- package/dist/integrations/linear/routes.d.ts +21 -1
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +21 -6
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts +7 -0
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +37 -5
- package/dist/integrations/linear/rules.js.map +1 -1
- package/dist/integrations/platform/connect/routes.d.ts +7 -1
- package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
- package/dist/integrations/platform/connect/routes.js +42 -5
- package/dist/integrations/platform/connect/routes.js.map +1 -1
- package/dist/integrations/platform/connect/session-tools.d.ts +7 -0
- package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
- package/dist/integrations/platform/connect/session-tools.js +30 -0
- package/dist/integrations/platform/connect/session-tools.js.map +1 -0
- package/dist/integrations/platform/github/event-worker.js +1 -1
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +9 -8
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/gitlab/event-worker.js +1 -1
- package/dist/integrations/platform/gitlab/integration.js +2 -2
- package/dist/integrations/platform/incidentio/integration.js +5 -5
- package/dist/integrations/platform/jira/agent-tools.js +1 -1
- package/dist/integrations/platform/jira/integration.js +2 -2
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +2 -5
- package/dist/integrations/platform/jira/routes.js.map +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/linear/event-worker.js +9 -0
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
- package/dist/integrations/platform/linear/integration.js +150 -48
- package/dist/integrations/platform/linear/integration.js.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
- package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.js +6 -1
- package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
- package/dist/integrations/slack/chat-tools.d.ts +16 -0
- package/dist/integrations/slack/chat-tools.d.ts.map +1 -0
- package/dist/integrations/slack/chat-tools.js +215 -0
- package/dist/integrations/slack/chat-tools.js.map +1 -0
- package/dist/integrations/slack/connect-route.d.ts.map +1 -1
- package/dist/integrations/slack/connect-route.js +1 -1
- package/dist/integrations/slack/connect-route.js.map +1 -1
- package/dist/integrations/slack/integration.d.ts +19 -3
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +27 -8
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/run-error-card.js +1 -1
- package/dist/integrations/slack/share-file-tool.d.ts +8 -0
- package/dist/integrations/slack/share-file-tool.d.ts.map +1 -1
- package/dist/integrations/slack/share-file-tool.js +13 -4
- package/dist/integrations/slack/share-file-tool.js.map +1 -1
- package/dist/integrations/slack/slack.d.ts +12 -10
- package/dist/integrations/slack/slack.d.ts.map +1 -1
- package/dist/integrations/slack/slack.js +113 -46
- package/dist/integrations/slack/slack.js.map +1 -1
- package/dist/integrations/slack/tool-settings.d.ts +26 -0
- package/dist/integrations/slack/tool-settings.d.ts.map +1 -0
- package/dist/integrations/slack/tool-settings.js +35 -0
- package/dist/integrations/slack/tool-settings.js.map +1 -0
- package/dist/integrations/slack/voice-clips.d.ts +32 -0
- package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
- package/dist/integrations/slack/voice-clips.js +201 -0
- package/dist/integrations/slack/voice-clips.js.map +1 -0
- package/dist/integrations/workos/integration.d.ts.map +1 -1
- package/dist/integrations/workos/integration.js +1 -3
- package/dist/integrations/workos/integration.js.map +1 -1
- package/dist/mcp/events.js +1 -1
- package/dist/mcp/routes.js +2 -2
- package/dist/packages/_internals/workspace/dist/index.js +1 -1
- package/dist/routes/attention-activity.js +1 -1
- package/dist/routes/attention-providers.js +2 -2
- package/dist/routes/attention.js +2 -2
- package/dist/routes/automation-runs.d.ts.map +1 -1
- package/dist/routes/automation-runs.js +2 -5
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/boards.d.ts +8 -6
- package/dist/routes/boards.d.ts.map +1 -1
- package/dist/routes/boards.js +73 -143
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/config.d.ts.map +1 -1
- package/dist/routes/config.js +6 -11
- package/dist/routes/config.js.map +1 -1
- package/dist/routes/contracts.d.ts +162 -2
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +98 -33
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/fs.d.ts.map +1 -1
- package/dist/routes/fs.js +2 -5
- package/dist/routes/fs.js.map +1 -1
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +19 -12
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +4 -6
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +1 -4
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/oauth.d.ts.map +1 -1
- package/dist/routes/oauth.js +1 -4
- package/dist/routes/oauth.js.map +1 -1
- package/dist/routes/projects.d.ts +3 -0
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +42 -28
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/provider-credentials.d.ts.map +1 -1
- package/dist/routes/provider-credentials.js +6 -0
- package/dist/routes/provider-credentials.js.map +1 -1
- package/dist/routes/route.d.ts +2 -0
- package/dist/routes/route.d.ts.map +1 -1
- package/dist/routes/route.js +5 -1
- package/dist/routes/route.js.map +1 -1
- package/dist/routes/skills.d.ts.map +1 -1
- package/dist/routes/skills.js +2 -5
- package/dist/routes/skills.js.map +1 -1
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +3 -5
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/source-control-settings.d.ts.map +1 -1
- package/dist/routes/source-control-settings.js +3 -2
- package/dist/routes/source-control-settings.js.map +1 -1
- package/dist/routes/surface.d.ts +3 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +27 -17
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/telemetry.js +1 -1
- package/dist/routes/voice.d.ts +48 -0
- package/dist/routes/voice.d.ts.map +1 -0
- package/dist/routes/voice.js +248 -0
- package/dist/routes/voice.js.map +1 -0
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +9 -12
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/decision-applicability.js +1 -1
- package/dist/rules/dispatcher.d.ts +42 -0
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +522 -136
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +40 -1
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +59 -1
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/index.js +1 -1
- package/dist/rules/processor.d.ts +2 -0
- package/dist/rules/processor.d.ts.map +1 -1
- package/dist/rules/processor.js +5 -4
- package/dist/rules/processor.js.map +1 -1
- package/dist/rules/start-coordinator.js +2 -2
- package/dist/rules/terminal-cleanup.js.map +1 -1
- package/dist/rules/tools.js +5 -5
- package/dist/rules/transition-service.d.ts +9 -0
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +9 -7
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +54 -3
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +2 -0
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +57 -2
- package/dist/rules/validation.js.map +1 -1
- package/dist/sandbox/session-retirement.js +2 -2
- package/dist/sandbox/session-sandbox.js +1 -1
- package/dist/session/credential-policy.d.ts +2 -2
- package/dist/session/credential-policy.d.ts.map +1 -1
- package/dist/session/credential-policy.js +4 -4
- package/dist/session/credential-policy.js.map +1 -1
- package/dist/session/default-model-hydration.d.ts +2 -2
- package/dist/session/default-model-hydration.d.ts.map +1 -1
- package/dist/session/default-model-hydration.js +4 -4
- package/dist/session/default-model-hydration.js.map +1 -1
- package/dist/session/factory-session.js +3 -3
- package/dist/session/self-review-gate.js +1 -1
- package/dist/session/session-threads.d.ts +8 -0
- package/dist/session/session-threads.d.ts.map +1 -1
- package/dist/session/session-threads.js +11 -1
- package/dist/session/session-threads.js.map +1 -1
- package/dist/session/source-control-tools.js +3 -3
- package/dist/skills/catalog.js +1 -1
- package/dist/storage/domains/audit/actions.d.ts +1 -1
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +2 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/audit/domain.d.ts.map +1 -1
- package/dist/storage/domains/audit/domain.js +2 -4
- package/dist/storage/domains/audit/domain.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +32 -1
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +155 -8
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
- package/dist/storage/domains/boards/schemas.js +13 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/comments/base.js +3 -3
- package/dist/storage/domains/comments/domain.js +3 -3
- package/dist/storage/domains/comments/routes.d.ts.map +1 -1
- package/dist/storage/domains/comments/routes.js +2 -4
- package/dist/storage/domains/comments/routes.js.map +1 -1
- package/dist/storage/domains/memory-settings/base.d.ts +0 -8
- package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
- package/dist/storage/domains/memory-settings/base.js +1 -11
- package/dist/storage/domains/memory-settings/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +6 -0
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +9 -1
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/source-control/base.d.ts +20 -0
- package/dist/storage/domains/source-control/base.d.ts.map +1 -1
- package/dist/storage/domains/source-control/base.js +42 -0
- package/dist/storage/domains/source-control/base.js.map +1 -1
- package/dist/storage/domains/source-control/inmemory.d.ts +5 -1
- package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
- package/dist/storage/domains/source-control/inmemory.js +23 -0
- package/dist/storage/domains/source-control/inmemory.js.map +1 -1
- package/dist/storage/domains/voice-settings/base.d.ts +31 -0
- package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
- package/dist/storage/domains/voice-settings/base.js +81 -0
- package/dist/storage/domains/voice-settings/base.js.map +1 -0
- package/dist/storage/domains/work-items/base.d.ts +47 -7
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +251 -115
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +6 -1
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +55 -5
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/storage/domains/work-items/claimable-work.d.ts +15 -0
- package/dist/storage/domains/work-items/claimable-work.d.ts.map +1 -0
- package/dist/storage/domains/work-items/claimable-work.js +51 -0
- package/dist/storage/domains/work-items/claimable-work.js.map +1 -0
- package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
- package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.js +24 -1
- package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
- package/dist/timing.d.ts +1 -0
- package/dist/timing.d.ts.map +1 -1
- package/dist/timing.js +1 -1
- package/dist/timing.js.map +1 -1
- package/dist/tools/index.js +2 -2
- package/dist/tools/messaging-tools.js +1 -1
- package/dist/tools/read-tools.d.ts +2 -2
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +10 -9
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/scope.js +1 -1
- package/dist/tools/session-tools.d.ts +1 -1
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js +9 -9
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/sessions-state-processor.d.ts +1 -1
- package/dist/tools/sessions-state-processor.d.ts.map +1 -1
- package/dist/tools/sessions-state-processor.js +9 -2
- package/dist/tools/sessions-state-processor.js.map +1 -1
- package/dist/tools/work-item-tools.js +4 -4
- package/dist/voice/rate-limit.d.ts +13 -0
- package/dist/voice/rate-limit.d.ts.map +1 -0
- package/dist/voice/rate-limit.js +36 -0
- package/dist/voice/rate-limit.js.map +1 -0
- package/dist/voice/realtime.d.ts +13 -0
- package/dist/voice/realtime.d.ts.map +1 -0
- package/dist/voice/realtime.js +56 -0
- package/dist/voice/realtime.js.map +1 -0
- package/dist/voice/transcription.d.ts +51 -0
- package/dist/voice/transcription.d.ts.map +1 -0
- package/dist/voice/transcription.js +112 -0
- package/dist/voice/transcription.js.map +1 -0
- package/dist/work-items/create-work-item.js +2 -2
- package/dist/work-items/decision-actions.js +2 -2
- package/dist/work-items/providers/gitlab.js +1 -1
- package/dist/work-items/providers/incidentio.js +1 -1
- package/dist/work-items/providers/index.js +1 -1
- package/dist/work-items/providers/jira.js +1 -1
- package/dist/work-items/providers/linear.js +1 -1
- package/dist/work-items/split-backfill.d.ts +13 -0
- package/dist/work-items/split-backfill.d.ts.map +1 -0
- package/dist/work-items/split-backfill.js +32 -0
- package/dist/work-items/split-backfill.js.map +1 -0
- package/dist/work-items/split-migration.d.ts +39 -2
- package/dist/work-items/split-migration.d.ts.map +1 -1
- package/dist/work-items/split-migration.js +171 -63
- package/dist/work-items/split-migration.js.map +1 -1
- package/dist/workspace.d.ts +2 -0
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +12 -9
- package/dist/workspace.js.map +1 -1
- package/package.json +10 -9
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-boards.d.ts","sourceRoot":"","sources":["../../src/boards/project-boards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"project-boards.d.ts","sourceRoot":"","sources":["../../src/boards/project-boards.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,10 +1,19 @@
|
|
|
1
|
-
import { createBoardRegistry, defaultBoards } from "./registry.js";
|
|
2
1
|
import { findBoardSkillProblems } from "../skills/app-skills.js";
|
|
3
|
-
import {
|
|
2
|
+
import { codeBoardOf } from "./define-board.js";
|
|
3
|
+
import { createBoardRegistry, defaultBoards } from "./registry.js";
|
|
4
|
+
import { reviewBoard } from "./review.js";
|
|
5
|
+
import { boardDefinitionOf, compileStoredBoard, mergeCodeBehaviour } from "./stored-board.js";
|
|
4
6
|
// src/boards/project-boards.ts
|
|
5
7
|
const DEFAULT_RECHECK_MS = 1e3;
|
|
6
8
|
const PRELOAD_CONCURRENCY = 8;
|
|
7
9
|
const SNAPSHOT_ATTEMPTS = 3;
|
|
10
|
+
/**
|
|
11
|
+
* Code boards Factory stores in each project: every code board except the legacy Review board,
|
|
12
|
+
* which is being retired and is served from code.
|
|
13
|
+
*/
|
|
14
|
+
function isEditableCodeBoard(board) {
|
|
15
|
+
return codeBoardOf(board) !== reviewBoard;
|
|
16
|
+
}
|
|
8
17
|
const PROJECT_BOARD_SOURCE = Symbol("ProjectBoardSource");
|
|
9
18
|
/** Accepts either a fixed registry (tests, standalone services) or a per-project source. */
|
|
10
19
|
function toBoardSource(boards) {
|
|
@@ -24,10 +33,14 @@ function scopeKey(scope) {
|
|
|
24
33
|
return `${scope.orgId}\0${scope.factoryProjectId}`;
|
|
25
34
|
}
|
|
26
35
|
/**
|
|
27
|
-
* The per-project board cache. A project's boards are
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
36
|
+
* The per-project board cache. A project's boards are its rows: the Work and app boards Factory
|
|
37
|
+
* stored in it, in code order, then the others. A Work or app board's row runs with the code
|
|
38
|
+
* behaviour of its board and phase keys that still fits it ({@link mergeCodeBehaviour}); only the
|
|
39
|
+
* legacy Review board is served from code. The first load of each project in a process stores the
|
|
40
|
+
* boards Factory hasn't stored in it yet, each once ({@link StoredBoardsStorage.seedBoards}); a
|
|
41
|
+
* release never rewrites them. Loads recheck the project's board version at most every
|
|
42
|
+
* `recheckMs` and recompile when it changed, so stored edits on other replicas arrive within that
|
|
43
|
+
* delay.
|
|
31
44
|
*/
|
|
32
45
|
var ProjectBoardCache = class {
|
|
33
46
|
[PROJECT_BOARD_SOURCE] = true;
|
|
@@ -42,7 +55,9 @@ var ProjectBoardCache = class {
|
|
|
42
55
|
#loading = /* @__PURE__ */ new Map();
|
|
43
56
|
#generations = /* @__PURE__ */ new Map();
|
|
44
57
|
#warned = /* @__PURE__ */ new Set();
|
|
58
|
+
#seeded = /* @__PURE__ */ new Set();
|
|
45
59
|
#codeSkills;
|
|
60
|
+
#seeds;
|
|
46
61
|
constructor(options) {
|
|
47
62
|
this.codeRegistry = options.codeRegistry;
|
|
48
63
|
this.#storage = options.storage;
|
|
@@ -53,9 +68,18 @@ var ProjectBoardCache = class {
|
|
|
53
68
|
this.#warn = options.warn ?? ((message) => console.warn(`[factory] ${message}`));
|
|
54
69
|
this.#codeDetails = new Map([...this.codeRegistry.values()].map((board) => [board.id, {
|
|
55
70
|
source: defaultBoards.includes(board) ? "builtin" : "app",
|
|
56
|
-
editable:
|
|
71
|
+
editable: isEditableCodeBoard(board),
|
|
57
72
|
problems: this.#skillProblems(board)
|
|
58
73
|
}]));
|
|
74
|
+
this.#seeds = new Map([...this.codeRegistry.values()].filter(isEditableCodeBoard).map((board) => [board.id, boardDefinitionOf(board)]));
|
|
75
|
+
}
|
|
76
|
+
/** The boards Factory stores in each project once, in order. */
|
|
77
|
+
seeds() {
|
|
78
|
+
return [...this.#seeds.values()];
|
|
79
|
+
}
|
|
80
|
+
/** Factory's current definition for `key`, which reset restores; undefined when Factory has none. */
|
|
81
|
+
seedFor(key) {
|
|
82
|
+
return this.#seeds.get(key);
|
|
59
83
|
}
|
|
60
84
|
async load(scope) {
|
|
61
85
|
return (await this.describe(scope)).registry;
|
|
@@ -99,7 +123,7 @@ var ProjectBoardCache = class {
|
|
|
99
123
|
const entry = this.#entries.get(key);
|
|
100
124
|
if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;
|
|
101
125
|
}
|
|
102
|
-
/** Loads every project, a few at a time, so sync reads find them warm. */
|
|
126
|
+
/** Loads every project, a few at a time, so sync reads find them warm and each has its boards stored. */
|
|
103
127
|
async preload() {
|
|
104
128
|
const projects = await this.#projects?.listAll() ?? [];
|
|
105
129
|
let next = 0;
|
|
@@ -115,6 +139,7 @@ var ProjectBoardCache = class {
|
|
|
115
139
|
await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));
|
|
116
140
|
}
|
|
117
141
|
async #refresh(scope, key, generation) {
|
|
142
|
+
await this.#seed(scope, key);
|
|
118
143
|
const current = this.#entries.get(key);
|
|
119
144
|
const version = await this.#storage.readVersion(scope);
|
|
120
145
|
if (current && current.version === version) {
|
|
@@ -139,22 +164,61 @@ var ProjectBoardCache = class {
|
|
|
139
164
|
}
|
|
140
165
|
return snapshot;
|
|
141
166
|
}
|
|
167
|
+
/**
|
|
168
|
+
* Stores the boards Factory hasn't stored in the project yet, once per process. A failure is
|
|
169
|
+
* logged and retried on the next load; the boards it didn't store aren't served meanwhile.
|
|
170
|
+
*/
|
|
171
|
+
async #seed(scope, key) {
|
|
172
|
+
if (this.#seeded.has(key)) return;
|
|
173
|
+
try {
|
|
174
|
+
if (this.#seeds.size > 0) await this.#storage.seedBoards(scope, this.seeds());
|
|
175
|
+
this.#seeded.add(key);
|
|
176
|
+
} catch (error) {
|
|
177
|
+
this.#warnOnce(`seed:${key}`, `Boards for project ${scope.factoryProjectId} could not be stored; Factory stores them on the next load: ${error instanceof Error ? error.message : String(error)}`);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
142
180
|
#compile(scope, rows) {
|
|
143
|
-
const
|
|
181
|
+
const byKey = new Map(rows.map((row) => [row.key, row]));
|
|
144
182
|
const details = new Map(this.#codeDetails);
|
|
145
183
|
const problems = [];
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
184
|
+
const report = (row, messages) => {
|
|
185
|
+
problems.push(...messages);
|
|
186
|
+
for (const message of messages) this.#warnOnce(`row:${scopeKey(scope)}:${row.key}:${row.revision}:${message}`, `${message} (project ${scope.factoryProjectId})`);
|
|
187
|
+
};
|
|
188
|
+
const boards = [];
|
|
189
|
+
for (const code of this.codeRegistry.values()) {
|
|
190
|
+
const row = byKey.get(code.id);
|
|
191
|
+
if (!this.#seeds.has(code.id)) {
|
|
192
|
+
if (row) problems.push(`Stored board "${row.key}" is hidden by the code board with the same key.`);
|
|
193
|
+
boards.push(code);
|
|
194
|
+
continue;
|
|
195
|
+
}
|
|
196
|
+
if (!row) {
|
|
197
|
+
details.delete(code.id);
|
|
198
|
+
if (!this.#seeded.has(scopeKey(scope))) problems.push(`Board "${code.id}" isn't stored in this project yet; Factory stores it on the next load.`);
|
|
149
199
|
continue;
|
|
150
200
|
}
|
|
201
|
+
let merged;
|
|
202
|
+
try {
|
|
203
|
+
merged = mergeCodeBehaviour(row, code);
|
|
204
|
+
} catch (error) {
|
|
205
|
+
report(row, [`Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`]);
|
|
206
|
+
continue;
|
|
207
|
+
}
|
|
208
|
+
report(row, merged.problems);
|
|
209
|
+
details.set(code.id, {
|
|
210
|
+
...details.get(code.id),
|
|
211
|
+
problems: [...merged.problems, ...this.#skillProblems(merged.board)]
|
|
212
|
+
});
|
|
213
|
+
boards.push(merged.board);
|
|
214
|
+
}
|
|
215
|
+
for (const row of rows) {
|
|
216
|
+
if (this.codeRegistry.has(row.key)) continue;
|
|
151
217
|
let board;
|
|
152
218
|
try {
|
|
153
219
|
board = compileStoredBoard(row);
|
|
154
220
|
} catch (error) {
|
|
155
|
-
|
|
156
|
-
problems.push(message);
|
|
157
|
-
this.#warnOnce(`compile:${scopeKey(scope)}:${row.key}:${row.revision}`, `${message} (project ${scope.factoryProjectId})`);
|
|
221
|
+
report(row, [`Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`]);
|
|
158
222
|
continue;
|
|
159
223
|
}
|
|
160
224
|
boards.push(board);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-boards.js","names":[],"sources":["../../src/boards/project-boards.ts"],"sourcesContent":["import type { InlineSkill } from '@mastra/core/skills';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type { StoredBoardRecord, StoredBoardScope, StoredBoardsStorage } from '../storage/domains/boards/base.js';\nimport { createBoardRegistry, defaultBoards } from './registry.js';\nimport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { compileStoredBoard } from './stored-board.js';\n\nconst DEFAULT_RECHECK_MS = 1000;\nconst PRELOAD_CONCURRENCY = 8;\nconst SNAPSHOT_ATTEMPTS = 3;\n\n/** Where a board in a project's catalog came from. */\nexport type BoardSourceKind = 'builtin' | 'app' | 'stored';\n\nexport interface StoredBoardDetails {\n source: BoardSourceKind;\n /** Only boards the project stored can be edited; code boards are read-only. */\n editable: boolean;\n problems: string[];\n}\n\n/** A project's boards: the code boards plus its stored boards, and what to report about each board. */\nexport interface ProjectBoards {\n readonly registry: BoardRegistry;\n readonly details: ReadonlyMap<string, StoredBoardDetails>;\n /** Problems with stored boards that are left out of the registry. */\n readonly problems: readonly string[];\n}\n\nconst PROJECT_BOARD_SOURCE = Symbol('ProjectBoardSource');\n\n/**\n * Serves each project its boards. `load` is the async entry point that brings a project's\n * boards up to date; `forProject` is the sync read for code that already loaded the project.\n */\nexport interface ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE]: true;\n /** The code boards: built-in and app boards, served to every project as code built them. */\n readonly codeRegistry: BoardRegistry;\n load(scope: StoredBoardScope): Promise<BoardRegistry>;\n forProject(scope: StoredBoardScope): BoardRegistry;\n describe?(scope: StoredBoardScope): Promise<ProjectBoards>;\n}\n\n/** Accepts either a fixed registry (tests, standalone services) or a per-project source. */\nexport function toBoardSource(boards: BoardRegistry | ProjectBoardSource | undefined): ProjectBoardSource {\n const source = boards ?? createBoardRegistry();\n if (isBoardSource(source)) return source;\n return {\n [PROJECT_BOARD_SOURCE]: true,\n codeRegistry: source,\n load: async () => source,\n forProject: () => source,\n };\n}\n\nfunction isBoardSource(boards: BoardRegistry | ProjectBoardSource): boards is ProjectBoardSource {\n return PROJECT_BOARD_SOURCE in boards;\n}\n\ninterface CacheEntry {\n boards: ProjectBoards;\n version: string | null;\n checkedAt: number;\n}\n\nexport interface ProjectBoardCacheOptions {\n /** The code boards, built-ins included when enabled. */\n codeRegistry: BoardRegistry;\n storage: StoredBoardsStorage;\n /** Lists every project, to warm them at boot. */\n projects?: { listAll(): Promise<readonly { orgId: string; id: string }[]> };\n codeSkills?: readonly InlineSkill[];\n recheckMs?: number;\n now?: () => number;\n warn?: (message: string) => void;\n}\n\nfunction scopeKey(scope: StoredBoardScope): string {\n return `${scope.orgId}\\0${scope.factoryProjectId}`;\n}\n\n/**\n * The per-project board cache. A project's boards are the code boards, served as code built them\n * and winning on their key, followed by the boards the project stored. Loads recheck the\n * project's board version at most every `recheckMs` and recompile when it changed, so stored\n * edits on other replicas arrive within that delay. The cache never writes.\n */\nexport class ProjectBoardCache implements ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE] = true;\n readonly codeRegistry: BoardRegistry;\n readonly #codeDetails: ReadonlyMap<string, StoredBoardDetails>;\n readonly #storage: StoredBoardsStorage;\n readonly #projects: ProjectBoardCacheOptions['projects'];\n readonly #recheckMs: number;\n readonly #now: () => number;\n readonly #warn: (message: string) => void;\n readonly #entries = new Map<string, CacheEntry>();\n readonly #loading = new Map<string, Promise<ProjectBoards>>();\n readonly #generations = new Map<string, number>();\n readonly #warned = new Set<string>();\n readonly #codeSkills: readonly InlineSkill[];\n\n constructor(options: ProjectBoardCacheOptions) {\n this.codeRegistry = options.codeRegistry;\n this.#storage = options.storage;\n this.#projects = options.projects;\n this.#codeSkills = options.codeSkills ?? [];\n this.#recheckMs = options.recheckMs ?? DEFAULT_RECHECK_MS;\n this.#now = options.now ?? Date.now;\n this.#warn = options.warn ?? (message => console.warn(`[factory] ${message}`));\n this.#codeDetails = new Map(\n [...this.codeRegistry.values()].map(board => [\n board.id,\n {\n source: defaultBoards.includes(board) ? 'builtin' : 'app',\n editable: false,\n problems: this.#skillProblems(board),\n },\n ]),\n );\n }\n\n async load(scope: StoredBoardScope): Promise<BoardRegistry> {\n return (await this.describe(scope)).registry;\n }\n\n /** The project's boards with their source, whether they can be edited, and problems, brought up to date. */\n async describe(scope: StoredBoardScope): Promise<ProjectBoards> {\n const key = scopeKey(scope);\n const entry = this.#entries.get(key);\n if (entry && this.#now() - entry.checkedAt < this.#recheckMs) return entry.boards;\n const inFlight = this.#loading.get(key);\n if (inFlight) return inFlight;\n const generation = this.#generations.get(key) ?? 0;\n const loading = this.#refresh(scope, key, generation).finally(() => {\n if (this.#loading.get(key) === loading) this.#loading.delete(key);\n });\n this.#loading.set(key, loading);\n return loading;\n }\n\n /**\n * The project's loaded boards. Before the project's first load (boot preload not finished, or a\n * project created on another replica) this is the code boards alone, without the project's\n * stored boards.\n */\n forProject(scope: StoredBoardScope): BoardRegistry {\n // Storage asks about a row it is about to insert by its board and stages alone, with no\n // project to look up; the code boards answer for it.\n if (!scope.orgId || !scope.factoryProjectId) return this.codeRegistry;\n const entry = this.#entries.get(scopeKey(scope));\n if (entry) return entry.boards.registry;\n // Warm the project so the next sync read sees its stored boards.\n void this.load(scope).catch(() => {});\n this.#warnOnce(\n `cold:${scopeKey(scope)}`,\n `Boards for project ${scope.factoryProjectId} were read before they were loaded; using the code boards.`,\n true,\n );\n return this.codeRegistry;\n }\n\n /** The code skills stored runners may name. */\n get codeSkills(): readonly InlineSkill[] {\n return this.#codeSkills;\n }\n\n /** Makes the next load reread the project. The loaded boards keep serving sync reads until then. */\n invalidate(scope: StoredBoardScope): void {\n const key = scopeKey(scope);\n this.#generations.set(key, (this.#generations.get(key) ?? 0) + 1);\n this.#loading.delete(key);\n const entry = this.#entries.get(key);\n if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;\n }\n\n /** Loads every project, a few at a time, so sync reads find them warm. */\n async preload(): Promise<void> {\n const projects = (await this.#projects?.listAll()) ?? [];\n let next = 0;\n const worker = async () => {\n while (next < projects.length) {\n const project = projects[next++]!;\n // A project that fails to load here loads on first use; the others still load now.\n await this.load({ orgId: project.orgId, factoryProjectId: project.id }).catch(error =>\n this.#warn(\n `Boards for project ${project.id} did not load at startup; they load on first use: ${error instanceof Error ? error.message : String(error)}`,\n ),\n );\n }\n };\n await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));\n }\n\n async #refresh(scope: StoredBoardScope, key: string, generation: number): Promise<ProjectBoards> {\n const current = this.#entries.get(key);\n const version = await this.#storage.readVersion(scope);\n if (current && current.version === version) {\n if ((this.#generations.get(key) ?? 0) === generation) current.checkedAt = this.#now();\n return current.boards;\n }\n const snapshot = await this.#consistentSnapshot(scope);\n const boards = this.#compile(scope, snapshot.boards);\n if ((this.#generations.get(key) ?? 0) === generation) {\n this.#entries.set(key, { boards, version: snapshot.version, checkedAt: this.#now() });\n }\n return boards;\n }\n\n /** Boards and phases are read in two statements; reread when a write landed between them. */\n async #consistentSnapshot(scope: StoredBoardScope) {\n let snapshot = await this.#storage.snapshot(scope);\n for (let attempt = 1; attempt < SNAPSHOT_ATTEMPTS; attempt++) {\n if ((await this.#storage.readVersion(scope)) === snapshot.version) break;\n snapshot = await this.#storage.snapshot(scope);\n }\n return snapshot;\n }\n\n #compile(scope: StoredBoardScope, rows: readonly StoredBoardRecord[]): ProjectBoards {\n const boards: InstalledBoard[] = [...this.codeRegistry.values()];\n const details = new Map(this.#codeDetails);\n const problems: string[] = [];\n for (const row of rows) {\n if (this.codeRegistry.has(row.key)) {\n problems.push(`Stored board \"${row.key}\" is hidden by the code board with the same key.`);\n continue;\n }\n let board: InstalledBoard;\n try {\n board = compileStoredBoard(row);\n } catch (error) {\n const message = `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`;\n problems.push(message);\n this.#warnOnce(\n `compile:${scopeKey(scope)}:${row.key}:${row.revision}`,\n `${message} (project ${scope.factoryProjectId})`,\n );\n continue;\n }\n boards.push(board);\n details.set(row.key, { source: 'stored', editable: true, problems: this.#skillProblems(board) });\n }\n return {\n registry: createBoardRegistry({ boards, includeDefaultBoards: false }),\n details,\n problems,\n };\n }\n\n #skillProblems(board: InstalledBoard): string[] {\n return findBoardSkillProblems(\n createBoardRegistry({ boards: [board], includeDefaultBoards: false }),\n this.#codeSkills,\n );\n }\n\n #warnOnce(key: string, message: string, debug = false): void {\n if (this.#warned.has(key)) return;\n this.#warned.add(key);\n if (debug) {\n console.debug(`[factory] ${message}`);\n return;\n }\n this.#warn(message);\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"project-boards.js","names":[],"sources":["../../src/boards/project-boards.ts"],"sourcesContent":["import type { InlineSkill } from '@mastra/core/skills';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type {\n StoredBoardInput,\n StoredBoardRecord,\n StoredBoardScope,\n StoredBoardsStorage,\n} from '../storage/domains/boards/base.js';\nimport { codeBoardOf } from './define-board.js';\nimport { createBoardRegistry, defaultBoards } from './registry.js';\nimport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { reviewBoard } from './review.js';\nimport { boardDefinitionOf, compileStoredBoard, mergeCodeBehaviour } from './stored-board.js';\n\nconst DEFAULT_RECHECK_MS = 1000;\nconst PRELOAD_CONCURRENCY = 8;\nconst SNAPSHOT_ATTEMPTS = 3;\n\n/** Where a board in a project's catalog came from. */\nexport type BoardSourceKind = 'builtin' | 'app' | 'stored';\n\nexport interface StoredBoardDetails {\n source: BoardSourceKind;\n /**\n * Stored boards, the built-in Work board and app boards can be edited; the legacy Review board,\n * which is being retired, stays read-only.\n */\n editable: boolean;\n problems: string[];\n}\n\n/**\n * Code boards Factory stores in each project: every code board except the legacy Review board,\n * which is being retired and is served from code.\n */\nfunction isEditableCodeBoard(board: InstalledBoard): boolean {\n return codeBoardOf(board) !== reviewBoard;\n}\n\n/** A project's boards: the code boards plus its stored boards, and what to report about each board. */\nexport interface ProjectBoards {\n readonly registry: BoardRegistry;\n readonly details: ReadonlyMap<string, StoredBoardDetails>;\n /** Problems with stored boards that are left out of the registry. */\n readonly problems: readonly string[];\n}\n\nconst PROJECT_BOARD_SOURCE = Symbol('ProjectBoardSource');\n\n/**\n * Serves each project its boards. `load` is the async entry point that brings a project's\n * boards up to date; `forProject` is the sync read for code that already loaded the project.\n */\nexport interface ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE]: true;\n /** The code boards: built-in and app boards, served to every project as code built them. */\n readonly codeRegistry: BoardRegistry;\n load(scope: StoredBoardScope): Promise<BoardRegistry>;\n forProject(scope: StoredBoardScope): BoardRegistry;\n describe?(scope: StoredBoardScope): Promise<ProjectBoards>;\n}\n\n/** Accepts either a fixed registry (tests, standalone services) or a per-project source. */\nexport function toBoardSource(boards: BoardRegistry | ProjectBoardSource | undefined): ProjectBoardSource {\n const source = boards ?? createBoardRegistry();\n if (isBoardSource(source)) return source;\n return {\n [PROJECT_BOARD_SOURCE]: true,\n codeRegistry: source,\n load: async () => source,\n forProject: () => source,\n };\n}\n\nfunction isBoardSource(boards: BoardRegistry | ProjectBoardSource): boards is ProjectBoardSource {\n return PROJECT_BOARD_SOURCE in boards;\n}\n\ninterface CacheEntry {\n boards: ProjectBoards;\n version: string | null;\n checkedAt: number;\n}\n\nexport interface ProjectBoardCacheOptions {\n /** The code boards, built-ins included when enabled. */\n codeRegistry: BoardRegistry;\n storage: StoredBoardsStorage;\n /** Lists every project, to warm them at boot. */\n projects?: { listAll(): Promise<readonly { orgId: string; id: string }[]> };\n codeSkills?: readonly InlineSkill[];\n recheckMs?: number;\n now?: () => number;\n warn?: (message: string) => void;\n}\n\nfunction scopeKey(scope: StoredBoardScope): string {\n return `${scope.orgId}\\0${scope.factoryProjectId}`;\n}\n\n/**\n * The per-project board cache. A project's boards are its rows: the Work and app boards Factory\n * stored in it, in code order, then the others. A Work or app board's row runs with the code\n * behaviour of its board and phase keys that still fits it ({@link mergeCodeBehaviour}); only the\n * legacy Review board is served from code. The first load of each project in a process stores the\n * boards Factory hasn't stored in it yet, each once ({@link StoredBoardsStorage.seedBoards}); a\n * release never rewrites them. Loads recheck the project's board version at most every\n * `recheckMs` and recompile when it changed, so stored edits on other replicas arrive within that\n * delay.\n */\nexport class ProjectBoardCache implements ProjectBoardSource {\n readonly [PROJECT_BOARD_SOURCE] = true;\n readonly codeRegistry: BoardRegistry;\n readonly #codeDetails: ReadonlyMap<string, StoredBoardDetails>;\n readonly #storage: StoredBoardsStorage;\n readonly #projects: ProjectBoardCacheOptions['projects'];\n readonly #recheckMs: number;\n readonly #now: () => number;\n readonly #warn: (message: string) => void;\n readonly #entries = new Map<string, CacheEntry>();\n readonly #loading = new Map<string, Promise<ProjectBoards>>();\n readonly #generations = new Map<string, number>();\n readonly #warned = new Set<string>();\n readonly #seeded = new Set<string>();\n readonly #codeSkills: readonly InlineSkill[];\n readonly #seeds: ReadonlyMap<string, StoredBoardInput>;\n\n constructor(options: ProjectBoardCacheOptions) {\n this.codeRegistry = options.codeRegistry;\n this.#storage = options.storage;\n this.#projects = options.projects;\n this.#codeSkills = options.codeSkills ?? [];\n this.#recheckMs = options.recheckMs ?? DEFAULT_RECHECK_MS;\n this.#now = options.now ?? Date.now;\n this.#warn = options.warn ?? (message => console.warn(`[factory] ${message}`));\n this.#codeDetails = new Map(\n [...this.codeRegistry.values()].map(board => [\n board.id,\n {\n source: defaultBoards.includes(board) ? 'builtin' : 'app',\n editable: isEditableCodeBoard(board),\n problems: this.#skillProblems(board),\n },\n ]),\n );\n this.#seeds = new Map(\n [...this.codeRegistry.values()].filter(isEditableCodeBoard).map(board => [board.id, boardDefinitionOf(board)]),\n );\n }\n\n /** The boards Factory stores in each project once, in order. */\n seeds(): StoredBoardInput[] {\n return [...this.#seeds.values()];\n }\n\n /** Factory's current definition for `key`, which reset restores; undefined when Factory has none. */\n seedFor(key: string): StoredBoardInput | undefined {\n return this.#seeds.get(key);\n }\n\n async load(scope: StoredBoardScope): Promise<BoardRegistry> {\n return (await this.describe(scope)).registry;\n }\n\n /** The project's boards with their source, whether they can be edited, and problems, brought up to date. */\n async describe(scope: StoredBoardScope): Promise<ProjectBoards> {\n const key = scopeKey(scope);\n const entry = this.#entries.get(key);\n if (entry && this.#now() - entry.checkedAt < this.#recheckMs) return entry.boards;\n const inFlight = this.#loading.get(key);\n if (inFlight) return inFlight;\n const generation = this.#generations.get(key) ?? 0;\n const loading = this.#refresh(scope, key, generation).finally(() => {\n if (this.#loading.get(key) === loading) this.#loading.delete(key);\n });\n this.#loading.set(key, loading);\n return loading;\n }\n\n /**\n * The project's loaded boards. Before the project's first load (boot preload not finished, or a\n * project created on another replica) this is the code boards alone, without the project's\n * stored boards.\n */\n forProject(scope: StoredBoardScope): BoardRegistry {\n // Storage asks about a row it is about to insert by its board and stages alone, with no\n // project to look up; the code boards answer for it.\n if (!scope.orgId || !scope.factoryProjectId) return this.codeRegistry;\n const entry = this.#entries.get(scopeKey(scope));\n if (entry) return entry.boards.registry;\n // Warm the project so the next sync read sees its stored boards.\n void this.load(scope).catch(() => {});\n this.#warnOnce(\n `cold:${scopeKey(scope)}`,\n `Boards for project ${scope.factoryProjectId} were read before they were loaded; using the code boards.`,\n true,\n );\n return this.codeRegistry;\n }\n\n /** The code skills stored runners may name. */\n get codeSkills(): readonly InlineSkill[] {\n return this.#codeSkills;\n }\n\n /** Makes the next load reread the project. The loaded boards keep serving sync reads until then. */\n invalidate(scope: StoredBoardScope): void {\n const key = scopeKey(scope);\n this.#generations.set(key, (this.#generations.get(key) ?? 0) + 1);\n this.#loading.delete(key);\n const entry = this.#entries.get(key);\n if (entry) entry.checkedAt = Number.NEGATIVE_INFINITY;\n }\n\n /** Loads every project, a few at a time, so sync reads find them warm and each has its boards stored. */\n async preload(): Promise<void> {\n const projects = (await this.#projects?.listAll()) ?? [];\n let next = 0;\n const worker = async () => {\n while (next < projects.length) {\n const project = projects[next++]!;\n // A project that fails to load here loads on first use; the others still load now.\n await this.load({ orgId: project.orgId, factoryProjectId: project.id }).catch(error =>\n this.#warn(\n `Boards for project ${project.id} did not load at startup; they load on first use: ${error instanceof Error ? error.message : String(error)}`,\n ),\n );\n }\n };\n await Promise.all(Array.from({ length: Math.min(PRELOAD_CONCURRENCY, projects.length) }, worker));\n }\n\n async #refresh(scope: StoredBoardScope, key: string, generation: number): Promise<ProjectBoards> {\n await this.#seed(scope, key);\n const current = this.#entries.get(key);\n const version = await this.#storage.readVersion(scope);\n if (current && current.version === version) {\n if ((this.#generations.get(key) ?? 0) === generation) current.checkedAt = this.#now();\n return current.boards;\n }\n const snapshot = await this.#consistentSnapshot(scope);\n const boards = this.#compile(scope, snapshot.boards);\n if ((this.#generations.get(key) ?? 0) === generation) {\n this.#entries.set(key, { boards, version: snapshot.version, checkedAt: this.#now() });\n }\n return boards;\n }\n\n /** Boards and phases are read in two statements; reread when a write landed between them. */\n async #consistentSnapshot(scope: StoredBoardScope) {\n let snapshot = await this.#storage.snapshot(scope);\n for (let attempt = 1; attempt < SNAPSHOT_ATTEMPTS; attempt++) {\n if ((await this.#storage.readVersion(scope)) === snapshot.version) break;\n snapshot = await this.#storage.snapshot(scope);\n }\n return snapshot;\n }\n\n /**\n * Stores the boards Factory hasn't stored in the project yet, once per process. A failure is\n * logged and retried on the next load; the boards it didn't store aren't served meanwhile.\n */\n async #seed(scope: StoredBoardScope, key: string): Promise<void> {\n if (this.#seeded.has(key)) return;\n try {\n if (this.#seeds.size > 0) await this.#storage.seedBoards(scope, this.seeds());\n this.#seeded.add(key);\n } catch (error) {\n this.#warnOnce(\n `seed:${key}`,\n `Boards for project ${scope.factoryProjectId} could not be stored; Factory stores them on the next load: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n }\n\n #compile(scope: StoredBoardScope, rows: readonly StoredBoardRecord[]): ProjectBoards {\n const byKey = new Map(rows.map(row => [row.key, row]));\n const details = new Map(this.#codeDetails);\n const problems: string[] = [];\n const report = (row: StoredBoardRecord, messages: readonly string[]) => {\n problems.push(...messages);\n for (const message of messages) {\n this.#warnOnce(\n `row:${scopeKey(scope)}:${row.key}:${row.revision}:${message}`,\n `${message} (project ${scope.factoryProjectId})`,\n );\n }\n };\n const boards: InstalledBoard[] = [];\n // Work and app boards keep their code order, each served from its row.\n for (const code of this.codeRegistry.values()) {\n const row = byKey.get(code.id);\n if (!this.#seeds.has(code.id)) {\n if (row) problems.push(`Stored board \"${row.key}\" is hidden by the code board with the same key.`);\n boards.push(code);\n continue;\n }\n if (!row) {\n details.delete(code.id);\n // Stored once and deleted since, or not stored because storing failed.\n if (!this.#seeded.has(scopeKey(scope))) {\n problems.push(`Board \"${code.id}\" isn't stored in this project yet; Factory stores it on the next load.`);\n }\n continue;\n }\n let merged: ReturnType<typeof mergeCodeBehaviour>;\n try {\n merged = mergeCodeBehaviour(row, code);\n } catch (error) {\n report(row, [\n `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`,\n ]);\n continue;\n }\n report(row, merged.problems);\n details.set(code.id, {\n ...details.get(code.id)!,\n problems: [...merged.problems, ...this.#skillProblems(merged.board)],\n });\n boards.push(merged.board);\n }\n for (const row of rows) {\n if (this.codeRegistry.has(row.key)) continue;\n let board: InstalledBoard;\n try {\n board = compileStoredBoard(row);\n } catch (error) {\n report(row, [\n `Board '${row.key}' could not be loaded: ${error instanceof Error ? error.message : String(error)}`,\n ]);\n continue;\n }\n boards.push(board);\n details.set(row.key, { source: 'stored', editable: true, problems: this.#skillProblems(board) });\n }\n return {\n registry: createBoardRegistry({ boards, includeDefaultBoards: false }),\n details,\n problems,\n };\n }\n\n #skillProblems(board: InstalledBoard): string[] {\n return findBoardSkillProblems(\n createBoardRegistry({ boards: [board], includeDefaultBoards: false }),\n this.#codeSkills,\n );\n }\n\n #warnOnce(key: string, message: string, debug = false): void {\n if (this.#warned.has(key)) return;\n this.#warned.add(key);\n if (debug) {\n console.debug(`[factory] ${message}`);\n return;\n }\n this.#warn(message);\n }\n}\n"],"mappings":"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"}
|
|
@@ -91,11 +91,69 @@ export declare const storedBoardInputSchema: z.ZodObject<{
|
|
|
91
91
|
/**
|
|
92
92
|
* Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where
|
|
93
93
|
* cards start.
|
|
94
|
+
*
|
|
95
|
+
* With `code`, the board is a project's edit of that code board: its fields come from the stored
|
|
96
|
+
* definition and its behaviour from the code declaration, by phase key (`onEnter`, `onExit`,
|
|
97
|
+
* `outcomes`) and for the board (`tools`, `events`, `sourceClosed`, `transitionPolicy`). The board
|
|
98
|
+
* is rebuilt from the declaration, so the stored runner reaches the declared handlers. An edit code
|
|
99
|
+
* behaviour can't honour ({@link codeBehaviourConflicts}) is refused.
|
|
94
100
|
*/
|
|
95
|
-
export declare function compileStoredBoard(board: StoredBoardInput): InstalledBoard;
|
|
101
|
+
export declare function compileStoredBoard(board: StoredBoardInput, code?: InstalledBoard): InstalledBoard;
|
|
102
|
+
/** A board served from a stored row, and what of its code board's behaviour it runs without. */
|
|
103
|
+
interface MergedStoredBoard {
|
|
104
|
+
board: InstalledBoard;
|
|
105
|
+
/** One per piece of code behaviour the row can't run with; empty when it runs with all of it. */
|
|
106
|
+
problems: string[];
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike
|
|
110
|
+
* {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an
|
|
111
|
+
* edit from before a release added a phase or a code move, a row older than editable code boards)
|
|
112
|
+
* still runs as stored.
|
|
113
|
+
*
|
|
114
|
+
* - A phase's `onEnter`, `onExit` and `outcomes` attach only when the row keeps the phase in the
|
|
115
|
+
* shape they depend on: the same kind and, on phases with code handlers, the same runner context
|
|
116
|
+
* and skill, the declared exit tool and no other. Outcomes whose target the row lacks or doesn't
|
|
117
|
+
* allow are dropped.
|
|
118
|
+
* - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a
|
|
119
|
+
* person from moving a card past an unapproved exit tool. If the row lacks a code phase, the
|
|
120
|
+
* moves they make to it are refused, and that is reported.
|
|
121
|
+
* - The board's `events` and `transitionPolicy` attach only when the row has every code phase,
|
|
122
|
+
* since their handlers may move cards to any of them; `sourceClosed` when both of its phases are
|
|
123
|
+
* stored and terminal.
|
|
124
|
+
* - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.
|
|
125
|
+
* - If the board still fails to compile with that behaviour, it runs without any.
|
|
126
|
+
*
|
|
127
|
+
* The result links to `code` as its code board either way. Throws only when the row itself is
|
|
128
|
+
* invalid.
|
|
129
|
+
*/
|
|
130
|
+
export declare function mergeCodeBehaviour(row: StoredBoardInput, code: InstalledBoard): MergedStoredBoard;
|
|
131
|
+
/** What a code board's behaviour holds fixed on each of its phases; the rest of the phase is editable. */
|
|
132
|
+
interface CodePhaseBehaviour {
|
|
133
|
+
/** Code handlers run on entering or leaving it, so its runner context and skill are fixed. */
|
|
134
|
+
handlers: boolean;
|
|
135
|
+
/** The exit tool its code behaviour waits for, if any. */
|
|
136
|
+
exitToolId: string | null;
|
|
137
|
+
/** Phases code moves cards to from it; they stay in its nextPhases. */
|
|
138
|
+
requiredNextPhases: string[];
|
|
139
|
+
}
|
|
140
|
+
/** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */
|
|
141
|
+
export declare function codeBehaviourOf(code: InstalledBoard): Record<string, CodePhaseBehaviour>;
|
|
142
|
+
/**
|
|
143
|
+
* Why a stored definition of a code board's key can't run with that board's code behaviour, one
|
|
144
|
+
* reason per locked change; empty when it can. Code handlers and checks name the board's phases,
|
|
145
|
+
* its first phase, the context, skill and exit tool of phases with handlers, and the moves code
|
|
146
|
+
* makes between phases (tool and event rules, `sourceClosed`, integrations, handler prompts), so
|
|
147
|
+
* those stay as code declares them. Names, descriptions, added moves, start and approval
|
|
148
|
+
* conditions, runner instructions and new phases are free.
|
|
149
|
+
*/
|
|
150
|
+
export declare function codeBehaviourConflicts(board: StoredBoardInput, code: InstalledBoard): string[];
|
|
151
|
+
/** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */
|
|
152
|
+
export declare function sameBoardDefinition(a: StoredBoardInput, b: StoredBoardInput): boolean;
|
|
96
153
|
/**
|
|
97
154
|
* A board's storable definition, in the shape the boards API reads and writes. The initial phase
|
|
98
155
|
* comes first and every phase's resolved `nextPhases` is written out.
|
|
99
156
|
*/
|
|
100
157
|
export declare function boardDefinitionOf(board: InstalledBoard): StoredBoardInput;
|
|
158
|
+
export {};
|
|
101
159
|
//# sourceMappingURL=stored-board.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stored-board.d.ts","sourceRoot":"","sources":["../../src/boards/stored-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,mCAAmC,CAAC;AAG5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAkBpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AAUZ;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU/B,CAAC;AASL
|
|
1
|
+
{"version":3,"file":"stored-board.d.ts","sourceRoot":"","sources":["../../src/boards/stored-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,mCAAmC,CAAC;AAG5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAkBpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;kBAYxB,CAAC;AAUZ;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU/B,CAAC;AASL;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,CAoBjG;AAED,gGAAgG;AAChG,UAAU,iBAAiB;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAiGjG;AAsED,0GAA0G;AAC1G,UAAU,kBAAkB;IAC1B,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAYxF;AAMD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CA6B9F;AAsCD,4GAA4G;AAC5G,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAIrF;AAaD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAQzE"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { cardRuleGroupSchema } from "../rules/rule-group.js";
|
|
2
|
-
import { BoardDefinitionError, compileBoardDefinition } from "./define-board.js";
|
|
2
|
+
import { BoardDefinitionError, compileBoardDefinition, declarationOf } from "./define-board.js";
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
// src/boards/stored-board.ts
|
|
5
5
|
const storedRunnerSchema = z.object({
|
|
@@ -67,8 +67,142 @@ function storedNextPhases(phase, phases) {
|
|
|
67
67
|
/**
|
|
68
68
|
* Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where
|
|
69
69
|
* cards start.
|
|
70
|
+
*
|
|
71
|
+
* With `code`, the board is a project's edit of that code board: its fields come from the stored
|
|
72
|
+
* definition and its behaviour from the code declaration, by phase key (`onEnter`, `onExit`,
|
|
73
|
+
* `outcomes`) and for the board (`tools`, `events`, `sourceClosed`, `transitionPolicy`). The board
|
|
74
|
+
* is rebuilt from the declaration, so the stored runner reaches the declared handlers. An edit code
|
|
75
|
+
* behaviour can't honour ({@link codeBehaviourConflicts}) is refused.
|
|
70
76
|
*/
|
|
71
|
-
function compileStoredBoard(board) {
|
|
77
|
+
function compileStoredBoard(board, code) {
|
|
78
|
+
if (!code) return compileBoardDefinition(storedBoardConfig(board));
|
|
79
|
+
const conflicts = codeBehaviourConflicts(board, code);
|
|
80
|
+
if (conflicts.length > 0) throw new BoardDefinitionError(conflicts.join(" "));
|
|
81
|
+
const declaration = codeDeclaration(code);
|
|
82
|
+
const phases = {};
|
|
83
|
+
for (const key of Object.keys(declaration.phases)) {
|
|
84
|
+
const { outcomes, onEnter, onExit } = declaration.phases[key];
|
|
85
|
+
phases[key] = {
|
|
86
|
+
outcomes,
|
|
87
|
+
onEnter,
|
|
88
|
+
onExit
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
return compileBoardDefinition(storedBoardConfig(board, {
|
|
92
|
+
phases,
|
|
93
|
+
tools: declaration.tools,
|
|
94
|
+
events: declaration.events,
|
|
95
|
+
transitionPolicy: declaration.transitionPolicy,
|
|
96
|
+
sourceClosed: declaration.sourceClosed
|
|
97
|
+
}), code);
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike
|
|
101
|
+
* {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an
|
|
102
|
+
* edit from before a release added a phase or a code move, a row older than editable code boards)
|
|
103
|
+
* still runs as stored.
|
|
104
|
+
*
|
|
105
|
+
* - A phase's `onEnter`, `onExit` and `outcomes` attach only when the row keeps the phase in the
|
|
106
|
+
* shape they depend on: the same kind and, on phases with code handlers, the same runner context
|
|
107
|
+
* and skill, the declared exit tool and no other. Outcomes whose target the row lacks or doesn't
|
|
108
|
+
* allow are dropped.
|
|
109
|
+
* - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a
|
|
110
|
+
* person from moving a card past an unapproved exit tool. If the row lacks a code phase, the
|
|
111
|
+
* moves they make to it are refused, and that is reported.
|
|
112
|
+
* - The board's `events` and `transitionPolicy` attach only when the row has every code phase,
|
|
113
|
+
* since their handlers may move cards to any of them; `sourceClosed` when both of its phases are
|
|
114
|
+
* stored and terminal.
|
|
115
|
+
* - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.
|
|
116
|
+
* - If the board still fails to compile with that behaviour, it runs without any.
|
|
117
|
+
*
|
|
118
|
+
* The result links to `code` as its code board either way. Throws only when the row itself is
|
|
119
|
+
* invalid.
|
|
120
|
+
*/
|
|
121
|
+
function mergeCodeBehaviour(row, code) {
|
|
122
|
+
const declaration = codeDeclaration(code);
|
|
123
|
+
const stored = new Map(row.phases.map((phase) => [phase.key, phase]));
|
|
124
|
+
const problems = [];
|
|
125
|
+
const phases = {};
|
|
126
|
+
for (const [key, phase] of Object.entries(code.phases)) {
|
|
127
|
+
const declared = declaration.phases[key];
|
|
128
|
+
const outcomes = Object.entries(declared?.outcomes ?? {});
|
|
129
|
+
const edited = stored.get(key);
|
|
130
|
+
const conflicts = edited ? phaseShapeConflicts(key, phase, declared, edited) : [];
|
|
131
|
+
if (edited && edited.kind === phase.kind) {
|
|
132
|
+
const allowed = storedNextPhases(edited, row.phases);
|
|
133
|
+
const outcomeTargets = new Set(outcomes.map(([, target]) => target));
|
|
134
|
+
for (const target of phase.nextPhases) if (stored.has(target) && !allowed.includes(target) && !outcomeTargets.has(target)) problems.push(`Board "${row.key}" doesn't let phase "${key}" move cards to "${target}", so Factory's code can't make that move.`);
|
|
135
|
+
}
|
|
136
|
+
if (!hasHandlers(declared) && outcomes.length === 0) continue;
|
|
137
|
+
if (!edited) {
|
|
138
|
+
problems.push(`Phase "${key}" isn't on stored board "${row.key}", so its code behaviour doesn't run.`);
|
|
139
|
+
continue;
|
|
140
|
+
}
|
|
141
|
+
if (conflicts.length > 0) {
|
|
142
|
+
problems.push(...conflicts.map((conflict) => `Phase "${key}" runs without its code behaviour: ${conflict}`));
|
|
143
|
+
continue;
|
|
144
|
+
}
|
|
145
|
+
const allowed = storedNextPhases(edited, row.phases);
|
|
146
|
+
const kept = {};
|
|
147
|
+
for (const [outcome, target] of outcomes) if (!stored.has(target)) problems.push(`Phase "${key}" runs without its code outcome "${outcome}": phase "${target}" isn't stored.`);
|
|
148
|
+
else if (!allowed.includes(target)) problems.push(`Phase "${key}" runs without its code outcome "${outcome}": the board doesn't let it move cards to "${target}".`);
|
|
149
|
+
else kept[outcome] = target;
|
|
150
|
+
phases[key] = {
|
|
151
|
+
onEnter: declared?.onEnter,
|
|
152
|
+
onExit: declared?.onExit,
|
|
153
|
+
outcomes: Object.keys(kept).length > 0 ? kept : void 0
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
const board = { phases };
|
|
157
|
+
const missing = Object.keys(code.phases).filter((key) => !stored.has(key));
|
|
158
|
+
const unfit = missing.length > 0 ? missingPhases(missing) : void 0;
|
|
159
|
+
const tools = Object.keys(declaration.tools ?? {});
|
|
160
|
+
if (tools.length > 0) {
|
|
161
|
+
board.tools = declaration.tools;
|
|
162
|
+
if (unfit) problems.push(`Board "${row.key}" keeps its code tool rules (${tools.join(", ")}), but can't move cards where they lead: ${unfit}`);
|
|
163
|
+
}
|
|
164
|
+
const events = Object.keys(declaration.events ?? {});
|
|
165
|
+
if (events.length > 0) {
|
|
166
|
+
if (unfit) problems.push(`Board "${row.key}" runs without its code event rules (${events.join(", ")}): ${unfit}`);
|
|
167
|
+
else board.events = declaration.events;
|
|
168
|
+
}
|
|
169
|
+
if (declaration.transitionPolicy) {
|
|
170
|
+
if (unfit) problems.push(`Board "${row.key}" runs without its code transition policy: ${unfit}`);
|
|
171
|
+
else board.transitionPolicy = declaration.transitionPolicy;
|
|
172
|
+
}
|
|
173
|
+
const sourceClosed = declaration.sourceClosed;
|
|
174
|
+
if (sourceClosed) {
|
|
175
|
+
const closed = [sourceClosed.completed, sourceClosed.canceled];
|
|
176
|
+
const closedMissing = closed.filter((key) => !stored.has(key));
|
|
177
|
+
const closedOpen = closed.filter((key) => stored.has(key) && stored.get(key).kind !== "terminal");
|
|
178
|
+
if (closedMissing.length > 0) problems.push(`Board "${row.key}" doesn't move cards when their source closes: ${missingPhases(closedMissing)}`);
|
|
179
|
+
else if (closedOpen.length > 0) problems.push(`Board "${row.key}" doesn't move cards when their source closes: ${closedOpen.length === 1 ? `phase "${closedOpen[0]}" isn't terminal.` : `phases ${closedOpen.map((key) => `"${key}"`).join(", ")} aren't terminal.`}`);
|
|
180
|
+
else board.sourceClosed = sourceClosed;
|
|
181
|
+
}
|
|
182
|
+
try {
|
|
183
|
+
return {
|
|
184
|
+
board: compileBoardDefinition(storedBoardConfig(row, board), code),
|
|
185
|
+
problems
|
|
186
|
+
};
|
|
187
|
+
} catch (error) {
|
|
188
|
+
if (!(error instanceof BoardDefinitionError)) throw error;
|
|
189
|
+
return {
|
|
190
|
+
board: compileBoardDefinition(storedBoardConfig(row), code),
|
|
191
|
+
problems: [...problems, `Board "${row.key}" runs without its code behaviour: ${error.message}`]
|
|
192
|
+
};
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
function missingPhases(keys) {
|
|
196
|
+
return keys.length === 1 ? `phase "${keys[0]}" isn't stored.` : `phases ${keys.map((key) => `"${key}"`).join(", ")} aren't stored.`;
|
|
197
|
+
}
|
|
198
|
+
function codeDeclaration(code) {
|
|
199
|
+
return declarationOf(code) ?? code;
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* The board config a stored definition declares, with the given code behaviour. The board is
|
|
203
|
+
* rebuilt from the declaration's handlers, so the stored runner reaches them.
|
|
204
|
+
*/
|
|
205
|
+
function storedBoardConfig(board, behaviour) {
|
|
72
206
|
const [initial] = board.phases;
|
|
73
207
|
if (!initial) throw new BoardDefinitionError("A board must define at least one phase.");
|
|
74
208
|
const phases = {};
|
|
@@ -76,6 +210,7 @@ function compileStoredBoard(board) {
|
|
|
76
210
|
if (Object.hasOwn(phases, phase.key)) throw new BoardDefinitionError(`Board "${board.key}" declares phase "${phase.key}" more than once.`);
|
|
77
211
|
const runner = phase.runner ? withoutUndefined(phase.runner) : void 0;
|
|
78
212
|
const exitTool = phase.exitTool ? withoutUndefined(phase.exitTool) : void 0;
|
|
213
|
+
const declared = behaviour && Object.hasOwn(behaviour.phases, phase.key) ? behaviour.phases[phase.key] : void 0;
|
|
79
214
|
phases[phase.key] = withoutUndefined({
|
|
80
215
|
name: phase.name,
|
|
81
216
|
description: phase.description ?? void 0,
|
|
@@ -84,16 +219,93 @@ function compileStoredBoard(board) {
|
|
|
84
219
|
runner,
|
|
85
220
|
autoStart: phase.autoStart ? true : void 0,
|
|
86
221
|
autoStartWhen: phase.autoStartWhen ?? void 0,
|
|
87
|
-
exitTool
|
|
222
|
+
exitTool,
|
|
223
|
+
outcomes: declared?.outcomes,
|
|
224
|
+
onEnter: declared?.onEnter,
|
|
225
|
+
onExit: declared?.onExit
|
|
88
226
|
});
|
|
89
227
|
}
|
|
90
|
-
return
|
|
228
|
+
return {
|
|
91
229
|
id: board.key,
|
|
92
230
|
name: board.name,
|
|
93
231
|
...board.description != null ? { description: board.description } : {},
|
|
94
232
|
initialPhase: initial.key,
|
|
95
|
-
phases
|
|
96
|
-
|
|
233
|
+
phases,
|
|
234
|
+
...behaviour?.tools ? { tools: behaviour.tools } : {},
|
|
235
|
+
...behaviour?.events ? { events: behaviour.events } : {},
|
|
236
|
+
...behaviour?.transitionPolicy ? { transitionPolicy: behaviour.transitionPolicy } : {},
|
|
237
|
+
...behaviour?.sourceClosed ? { sourceClosed: behaviour.sourceClosed } : {}
|
|
238
|
+
};
|
|
239
|
+
}
|
|
240
|
+
/** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */
|
|
241
|
+
function codeBehaviourOf(code) {
|
|
242
|
+
const declaration = declarationOf(code) ?? code;
|
|
243
|
+
return Object.fromEntries(Object.entries(code.phases).map(([key, phase]) => [key, {
|
|
244
|
+
handlers: phase.kind === "working" && hasHandlers(declaration.phases[key]),
|
|
245
|
+
exitToolId: phase.kind === "working" ? phase.exitTool?.id ?? null : null,
|
|
246
|
+
requiredNextPhases: [...phase.nextPhases]
|
|
247
|
+
}]));
|
|
248
|
+
}
|
|
249
|
+
function hasHandlers(phase) {
|
|
250
|
+
return Object.keys(phase?.onEnter ?? {}).length > 0 || Object.keys(phase?.onExit ?? {}).length > 0;
|
|
251
|
+
}
|
|
252
|
+
/**
|
|
253
|
+
* Why a stored definition of a code board's key can't run with that board's code behaviour, one
|
|
254
|
+
* reason per locked change; empty when it can. Code handlers and checks name the board's phases,
|
|
255
|
+
* its first phase, the context, skill and exit tool of phases with handlers, and the moves code
|
|
256
|
+
* makes between phases (tool and event rules, `sourceClosed`, integrations, handler prompts), so
|
|
257
|
+
* those stay as code declares them. Names, descriptions, added moves, start and approval
|
|
258
|
+
* conditions, runner instructions and new phases are free.
|
|
259
|
+
*/
|
|
260
|
+
function codeBehaviourConflicts(board, code) {
|
|
261
|
+
const declaration = declarationOf(code) ?? code;
|
|
262
|
+
const stored = new Map(board.phases.map((phase) => [phase.key, phase]));
|
|
263
|
+
const conflicts = [];
|
|
264
|
+
if (board.phases[0]?.key !== code.initialPhase) conflicts.push(`Cards on board "${code.id}" start in "${code.initialPhase}"; keep it the first phase.`);
|
|
265
|
+
for (const [key, phase] of Object.entries(code.phases)) {
|
|
266
|
+
const edited = stored.get(key);
|
|
267
|
+
const label = `Phase "${key}"`;
|
|
268
|
+
if (!edited) {
|
|
269
|
+
conflicts.push(`${label} has code behaviour on board "${code.id}"; it can't be removed.`);
|
|
270
|
+
continue;
|
|
271
|
+
}
|
|
272
|
+
conflicts.push(...phaseShapeConflicts(key, phase, declaration.phases[key], edited));
|
|
273
|
+
if (edited.kind !== phase.kind) continue;
|
|
274
|
+
const nextPhases = storedNextPhases(edited, board.phases);
|
|
275
|
+
const outcomes = new Map(Object.entries(phase.outcomes ?? {}).map(([outcome, target]) => [target, outcome]));
|
|
276
|
+
for (const target of phase.nextPhases) {
|
|
277
|
+
if (nextPhases.includes(target)) continue;
|
|
278
|
+
const outcome = outcomes.get(target);
|
|
279
|
+
conflicts.push(outcome ? `${label} outcome "${outcome}" moves cards to "${target}"; keep it in nextPhases.` : `${label}: Factory's code moves cards from it to "${target}"; keep it in nextPhases.`);
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
return conflicts;
|
|
283
|
+
}
|
|
284
|
+
/**
|
|
285
|
+
* Why a stored phase isn't in the shape its code behaviour depends on: its kind and, on a working
|
|
286
|
+
* phase, the runner context and skill its code handlers run with and the exit tool they wait for.
|
|
287
|
+
*/
|
|
288
|
+
function phaseShapeConflicts(key, phase, declared, edited) {
|
|
289
|
+
const label = `Phase "${key}"`;
|
|
290
|
+
if (edited.kind !== phase.kind) return [`${label} must stay ${phase.kind}; its code behaviour depends on it.`];
|
|
291
|
+
if (phase.kind !== "working") return [];
|
|
292
|
+
const conflicts = [];
|
|
293
|
+
if (hasHandlers(declared)) {
|
|
294
|
+
if ((edited.runner?.context ?? "work") !== phase.runner.context) conflicts.push(`${label} runs its code handlers in the "${phase.runner.context}" context; keep runner.context.`);
|
|
295
|
+
if (edited.runner?.skill !== phase.runner.skill) conflicts.push(phase.runner.skill ? `${label} code handlers run with skill "${phase.runner.skill}"; keep runner.skill.` : `${label} code handlers choose the skill; leave runner.skill unset.`);
|
|
296
|
+
}
|
|
297
|
+
if (phase.exitTool && edited.exitTool?.id !== phase.exitTool.id) conflicts.push(`${label} code behaviour waits for exit tool "${phase.exitTool.id}"; keep exitTool.id.`);
|
|
298
|
+
else if (!phase.exitTool && edited.exitTool && hasHandlers(declared)) conflicts.push(`${label} code handlers move cards on without an exit tool; leave exitTool unset.`);
|
|
299
|
+
return conflicts;
|
|
300
|
+
}
|
|
301
|
+
/** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */
|
|
302
|
+
function sameBoardDefinition(a, b) {
|
|
303
|
+
return canonicalJson(boardDefinitionOf(compileStoredBoard(a))) === canonicalJson(boardDefinitionOf(compileStoredBoard(b)));
|
|
304
|
+
}
|
|
305
|
+
function canonicalJson(value) {
|
|
306
|
+
if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
|
|
307
|
+
if (value !== null && typeof value === "object") return `{${Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(",")}}`;
|
|
308
|
+
return JSON.stringify(value);
|
|
97
309
|
}
|
|
98
310
|
/**
|
|
99
311
|
* A board's storable definition, in the shape the boards API reads and writes. The initial phase
|
|
@@ -134,6 +346,6 @@ function storedPhase(key, phase) {
|
|
|
134
346
|
function withoutUndefined(value) {
|
|
135
347
|
return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
|
|
136
348
|
}
|
|
137
|
-
export { boardDefinitionOf, compileStoredBoard, storedBoardDefinitionSchema, storedBoardInputSchema, storedPhaseInputSchema };
|
|
349
|
+
export { boardDefinitionOf, codeBehaviourConflicts, codeBehaviourOf, compileStoredBoard, mergeCodeBehaviour, sameBoardDefinition, storedBoardDefinitionSchema, storedBoardInputSchema, storedPhaseInputSchema };
|
|
138
350
|
|
|
139
351
|
//# sourceMappingURL=stored-board.js.map
|