@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.10
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 +528 -161
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +12 -6
- package/dist/auth.js.map +1 -1
- package/dist/boards/board-events.d.ts +54 -0
- package/dist/boards/board-events.d.ts.map +1 -0
- package/dist/boards/board-events.js +87 -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 +266 -0
- package/dist/boards/board-writes.js.map +1 -0
- package/dist/boards/card-facts.d.ts +3 -1
- package/dist/boards/card-facts.d.ts.map +1 -1
- package/dist/boards/card-facts.js +30 -4
- package/dist/boards/card-facts.js.map +1 -1
- package/dist/boards/default-board.d.ts +7 -0
- package/dist/boards/default-board.d.ts.map +1 -0
- package/dist/boards/default-board.js +10 -0
- package/dist/boards/default-board.js.map +1 -0
- package/dist/boards/define-board.d.ts +56 -23
- package/dist/boards/define-board.d.ts.map +1 -1
- package/dist/boards/define-board.js +89 -45
- package/dist/boards/define-board.js.map +1 -1
- package/dist/boards/index.d.ts +6 -9
- package/dist/boards/index.d.ts.map +1 -1
- package/dist/boards/index.js +6 -20
- package/dist/boards/intake-routing.d.ts +55 -11
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +109 -19
- 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 +14 -5
- package/dist/boards/legacy-plan-role.js.map +1 -1
- package/dist/boards/phase-automation.d.ts +7 -0
- package/dist/boards/phase-automation.d.ts.map +1 -1
- package/dist/boards/phase-automation.js +19 -3
- package/dist/boards/phase-automation.js.map +1 -1
- package/dist/boards/phase-runner.d.ts +18 -10
- package/dist/boards/phase-runner.d.ts.map +1 -1
- package/dist/boards/phase-runner.js +39 -34
- package/dist/boards/phase-runner.js.map +1 -1
- package/dist/boards/project-boards.d.ts +65 -8
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +217 -26
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/registry.d.ts +7 -1
- package/dist/boards/registry.d.ts.map +1 -1
- package/dist/boards/registry.js +19 -4
- package/dist/boards/registry.js.map +1 -1
- package/dist/boards/relocate.d.ts +1 -1
- package/dist/boards/relocate.d.ts.map +1 -1
- package/dist/boards/relocate.js +3 -2
- package/dist/boards/relocate.js.map +1 -1
- package/dist/boards/review.d.ts +5 -2
- package/dist/boards/review.d.ts.map +1 -1
- package/dist/boards/review.js +12 -11
- package/dist/boards/review.js.map +1 -1
- package/dist/boards/semantics.d.ts +160 -20
- package/dist/boards/semantics.d.ts.map +1 -1
- package/dist/boards/semantics.js +255 -23
- package/dist/boards/semantics.js.map +1 -1
- package/dist/boards/stored-board.d.ts +73 -1
- package/dist/boards/stored-board.d.ts.map +1 -1
- package/dist/boards/stored-board.js +157 -11
- package/dist/boards/stored-board.js.map +1 -1
- package/dist/boards/work-migrations.d.ts +43 -0
- package/dist/boards/work-migrations.d.ts.map +1 -0
- package/dist/boards/work-migrations.js +353 -0
- package/dist/boards/work-migrations.js.map +1 -0
- package/dist/boards/work-routes.d.ts +58 -0
- package/dist/boards/work-routes.d.ts.map +1 -0
- package/dist/boards/work-routes.js +270 -0
- package/dist/boards/work-routes.js.map +1 -0
- package/dist/boards/work-seeds.d.ts +9 -0
- package/dist/boards/work-seeds.d.ts.map +1 -0
- package/dist/boards/work-seeds.js +56 -0
- package/dist/boards/work-seeds.js.map +1 -0
- package/dist/boards/work.d.ts +8 -19
- package/dist/boards/work.d.ts.map +1 -1
- package/dist/boards/work.js +33 -281
- package/dist/boards/work.js.map +1 -1
- package/dist/environment/build-runner.d.ts.map +1 -1
- package/dist/environment/build-runner.js +2 -2
- package/dist/environment/build-runner.js.map +1 -1
- package/dist/environment/build-workflow.d.ts.map +1 -1
- package/dist/environment/build-workflow.js +6 -5
- package/dist/environment/build-workflow.js.map +1 -1
- package/dist/environment/build.d.ts +15 -2
- package/dist/environment/build.d.ts.map +1 -1
- package/dist/environment/build.js +32 -9
- package/dist/environment/build.js.map +1 -1
- package/dist/factory.d.ts +90 -9
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +334 -141
- package/dist/factory.js.map +1 -1
- package/dist/feed-events.d.ts +4 -4
- package/dist/feed-events.d.ts.map +1 -1
- package/dist/feed-events.js +6 -6
- package/dist/feed-events.js.map +1 -1
- package/dist/index.d.ts +10 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -4
- package/dist/integrations/base.d.ts +12 -13
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/closing-references.d.ts +15 -0
- package/dist/integrations/closing-references.d.ts.map +1 -0
- package/dist/integrations/closing-references.js +69 -0
- package/dist/integrations/closing-references.js.map +1 -0
- 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 +17 -75
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +134 -77
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/integration.d.ts.map +1 -1
- package/dist/integrations/github/integration.js +7 -3
- package/dist/integrations/github/integration.js.map +1 -1
- package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/github/issue-reconciler.js +21 -3
- package/dist/integrations/github/issue-reconciler.js.map +1 -1
- package/dist/integrations/github/provenance.js +1 -1
- package/dist/integrations/github/provenance.js.map +1 -1
- package/dist/integrations/github/pull-request-source.d.ts +8 -0
- package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
- package/dist/integrations/github/pull-request-source.js +17 -0
- package/dist/integrations/github/pull-request-source.js.map +1 -0
- package/dist/integrations/github/reconcile-worker.d.ts +5 -1
- package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
- package/dist/integrations/github/reconcile-worker.js +39 -6
- package/dist/integrations/github/reconcile-worker.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 +104 -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 +4 -3
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +11 -91
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +92 -8
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +498 -103
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.d.ts +10 -2
- package/dist/integrations/github/sandbox.d.ts.map +1 -1
- package/dist/integrations/github/sandbox.js +20 -4
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/github/session-subscriptions.js +2 -2
- package/dist/integrations/github/session-subscriptions.js.map +1 -1
- package/dist/integrations/github/token-refresh.d.ts +2 -1
- package/dist/integrations/github/token-refresh.d.ts.map +1 -1
- package/dist/integrations/github/token-refresh.js.map +1 -1
- package/dist/integrations/gitlab/agent-tools.js +1 -1
- package/dist/integrations/gitlab/default-rules.d.ts +96 -39
- package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +109 -46
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/gitlab/issue-reconciler.js +2 -1
- package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
- package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +2 -6
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +22 -1
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +188 -34
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/gitlab/session-subscriptions.js +1 -1
- package/dist/integrations/incidentio/agent-tools.js +6 -6
- package/dist/integrations/incidentio/agent-tools.js.map +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 +6 -7
- package/dist/integrations/incidentio/default-rules.js.map +1 -1
- package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/incidentio/issue-reconciler.js +2 -1
- package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
- package/dist/integrations/incidentio/routes.d.ts +2 -2
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +11 -17
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +11 -4
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +52 -16
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/issue-reconciler.js +1 -1
- package/dist/integrations/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/agent-tools.js +1 -1
- package/dist/integrations/jira/binding-scope.d.ts +5 -6
- package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
- package/dist/integrations/jira/binding-scope.js +9 -11
- package/dist/integrations/jira/binding-scope.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 +6 -7
- package/dist/integrations/jira/default-rules.js.map +1 -1
- package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/jira/issue-reconciler.js +2 -1
- package/dist/integrations/jira/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +4 -9
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +11 -4
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +52 -16
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/agent-tools.d.ts +9 -1
- package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
- package/dist/integrations/linear/agent-tools.js +81 -3
- package/dist/integrations/linear/agent-tools.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 +6 -7
- package/dist/integrations/linear/default-rules.js.map +1 -1
- package/dist/integrations/linear/integration.d.ts +4 -1
- package/dist/integrations/linear/integration.d.ts.map +1 -1
- package/dist/integrations/linear/integration.js +21 -1
- package/dist/integrations/linear/integration.js.map +1 -1
- package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/linear/issue-reconciler.js +2 -1
- package/dist/integrations/linear/issue-reconciler.js.map +1 -1
- package/dist/integrations/linear/routes.d.ts +2 -1
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +16 -21
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts +11 -4
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +50 -17
- 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 +12 -0
- package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
- package/dist/integrations/platform/connect/session-tools.js +35 -0
- package/dist/integrations/platform/connect/session-tools.js.map +1 -0
- package/dist/integrations/platform/github/event-worker.d.ts +4 -1
- package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/github/event-worker.js +39 -3
- package/dist/integrations/platform/github/event-worker.js.map +1 -1
- package/dist/integrations/platform/github/integration.d.ts +8 -0
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +132 -90
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/jira/agent-tools.js +1 -1
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +4 -9
- 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 +10 -1
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.d.ts +1 -1
- package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
- package/dist/integrations/platform/linear/integration.js +7 -8
- 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.js +1 -1
- 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 +0 -2
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +2 -5
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/reply-tool.js +1 -1
- package/dist/integrations/slack/run-error-card.js +1 -0
- package/dist/integrations/slack/run-error-card.js.map +1 -1
- package/dist/integrations/slack/share-file-tool.js +1 -1
- package/dist/integrations/slack/slack.d.ts +23 -30
- package/dist/integrations/slack/slack.d.ts.map +1 -1
- package/dist/integrations/slack/slack.js +131 -125
- package/dist/integrations/slack/slack.js.map +1 -1
- 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/links.d.ts +1 -2
- package/dist/links.d.ts.map +1 -1
- package/dist/links.js +4 -4
- package/dist/links.js.map +1 -1
- package/dist/mcp/routes.js +2 -2
- package/dist/mcp/routes.js.map +1 -1
- package/dist/packages/_internals/workspace/dist/index.js +1 -1
- package/dist/provider-display-name.d.ts.map +1 -1
- package/dist/provider-display-name.js +1 -0
- package/dist/provider-display-name.js.map +1 -1
- package/dist/routes/attention-parked.d.ts +1 -0
- package/dist/routes/attention-parked.d.ts.map +1 -1
- package/dist/routes/attention-parked.js +2 -2
- package/dist/routes/attention-parked.js.map +1 -1
- package/dist/routes/attention-providers.d.ts +0 -25
- package/dist/routes/attention-providers.d.ts.map +1 -1
- package/dist/routes/attention-providers.js +3 -151
- package/dist/routes/attention-providers.js.map +1 -1
- package/dist/routes/attention.d.ts +0 -2
- package/dist/routes/attention.d.ts.map +1 -1
- package/dist/routes/attention.js +2 -13
- package/dist/routes/attention.js.map +1 -1
- package/dist/routes/automation-runs.d.ts +5 -1
- package/dist/routes/automation-runs.d.ts.map +1 -1
- package/dist/routes/automation-runs.js +16 -4
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +15 -0
- package/dist/routes/board-snapshot.d.ts.map +1 -0
- package/dist/routes/board-snapshot.js +41 -0
- package/dist/routes/board-snapshot.js.map +1 -0
- package/dist/routes/boards.d.ts +9 -7
- package/dist/routes/boards.d.ts.map +1 -1
- package/dist/routes/boards.js +59 -145
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/config.d.ts +11 -1
- package/dist/routes/config.d.ts.map +1 -1
- package/dist/routes/config.js +122 -29
- package/dist/routes/config.js.map +1 -1
- package/dist/routes/contracts.d.ts +366 -34
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +179 -51
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/feed-events.d.ts +15 -0
- package/dist/routes/feed-events.d.ts.map +1 -0
- package/dist/routes/feed-events.js +68 -0
- package/dist/routes/feed-events.js.map +1 -0
- package/dist/routes/fs.d.ts +4 -0
- package/dist/routes/fs.d.ts.map +1 -1
- package/dist/routes/fs.js +9 -8
- package/dist/routes/fs.js.map +1 -1
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +25 -13
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts +0 -23
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +16 -314
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +2 -5
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/mastra-gateway.d.ts +19 -0
- package/dist/routes/mastra-gateway.d.ts.map +1 -0
- package/dist/routes/mastra-gateway.js +120 -0
- package/dist/routes/mastra-gateway.js.map +1 -0
- 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 +80 -61
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/provider-credentials.d.ts +6 -1
- package/dist/routes/provider-credentials.d.ts.map +1 -1
- package/dist/routes/provider-credentials.js +44 -3
- package/dist/routes/provider-credentials.js.map +1 -1
- package/dist/routes/route.d.ts +8 -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/running-packages.d.ts +13 -0
- package/dist/routes/running-packages.d.ts.map +1 -0
- package/dist/routes/running-packages.js +45 -0
- package/dist/routes/running-packages.js.map +1 -0
- package/dist/routes/sandbox-envs.d.ts +26 -0
- package/dist/routes/sandbox-envs.d.ts.map +1 -0
- package/dist/routes/sandbox-envs.js +180 -0
- package/dist/routes/sandbox-envs.js.map +1 -0
- package/dist/routes/session-access.d.ts.map +1 -1
- package/dist/routes/session-access.js +12 -3
- package/dist/routes/session-access.js.map +1 -1
- package/dist/routes/skills.d.ts.map +1 -1
- package/dist/routes/skills.js +1 -4
- 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 +1 -3
- 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 +13 -9
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +116 -43
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/tenant-credentials.d.ts.map +1 -1
- package/dist/routes/tenant-credentials.js +5 -1
- package/dist/routes/tenant-credentials.js.map +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 +0 -3
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +39 -14
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/binding-context.d.ts.map +1 -1
- package/dist/rules/binding-context.js +1 -0
- package/dist/rules/binding-context.js.map +1 -1
- package/dist/rules/decision-applicability.js +1 -1
- package/dist/rules/dispatcher.d.ts +28 -9
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +734 -143
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +71 -1
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +94 -1
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/index.d.ts +2 -4
- package/dist/rules/index.d.ts.map +1 -1
- package/dist/rules/index.js +2 -3
- package/dist/rules/phase-goal.d.ts +54 -0
- package/dist/rules/phase-goal.d.ts.map +1 -0
- package/dist/rules/phase-goal.js +70 -0
- package/dist/rules/phase-goal.js.map +1 -0
- package/dist/rules/phase-tools.d.ts +11 -0
- package/dist/rules/phase-tools.d.ts.map +1 -0
- package/dist/rules/phase-tools.js +19 -0
- package/dist/rules/phase-tools.js.map +1 -0
- package/dist/rules/processor.d.ts.map +1 -1
- package/dist/rules/processor.js +116 -15
- package/dist/rules/processor.js.map +1 -1
- package/dist/rules/review-source-tool.d.ts +4 -1
- package/dist/rules/review-source-tool.d.ts.map +1 -1
- package/dist/rules/review-source-tool.js +24 -4
- package/dist/rules/review-source-tool.js.map +1 -1
- package/dist/rules/rule-group.d.ts +1 -1
- package/dist/rules/rule-group.d.ts.map +1 -1
- package/dist/rules/rule-group.js +15 -6
- package/dist/rules/rule-group.js.map +1 -1
- package/dist/rules/start-coordinator.d.ts +5 -1
- package/dist/rules/start-coordinator.d.ts.map +1 -1
- package/dist/rules/start-coordinator.js +9 -3
- package/dist/rules/start-coordinator.js.map +1 -1
- package/dist/rules/tools.d.ts.map +1 -1
- package/dist/rules/tools.js +39 -28
- package/dist/rules/tools.js.map +1 -1
- package/dist/rules/transition-service.d.ts +10 -7
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +63 -55
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +140 -39
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +7 -41
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +89 -4
- package/dist/rules/validation.js.map +1 -1
- package/dist/run-error.d.ts +1 -1
- package/dist/run-error.d.ts.map +1 -1
- package/dist/run-error.js +38 -5
- package/dist/run-error.js.map +1 -1
- package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
- package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
- package/dist/sandbox/sandbox-env-cache.js +140 -0
- package/dist/sandbox/sandbox-env-cache.js.map +1 -0
- package/dist/sandbox/sandbox-env.d.ts +77 -0
- package/dist/sandbox/sandbox-env.d.ts.map +1 -0
- package/dist/sandbox/sandbox-env.js +130 -0
- package/dist/sandbox/sandbox-env.js.map +1 -0
- package/dist/secret-encryption.d.ts +21 -0
- package/dist/secret-encryption.d.ts.map +1 -1
- package/dist/secret-encryption.js +31 -4
- package/dist/secret-encryption.js.map +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 +3 -3
- 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/live-sessions.d.ts +11 -4
- package/dist/session/live-sessions.d.ts.map +1 -1
- package/dist/session/live-sessions.js +31 -10
- package/dist/session/live-sessions.js.map +1 -1
- package/dist/session/self-review-gate.d.ts +6 -4
- package/dist/session/self-review-gate.d.ts.map +1 -1
- package/dist/session/self-review-gate.js +9 -12
- package/dist/session/self-review-gate.js.map +1 -1
- package/dist/session/session-threads.d.ts +10 -3
- 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.d.ts +39 -13
- package/dist/session/source-control-tools.d.ts.map +1 -1
- package/dist/session/source-control-tools.js +55 -61
- package/dist/session/source-control-tools.js.map +1 -1
- package/dist/session/work-item-state-processor.d.ts +24 -0
- package/dist/session/work-item-state-processor.d.ts.map +1 -0
- package/dist/session/work-item-state-processor.js +275 -0
- package/dist/session/work-item-state-processor.js.map +1 -0
- package/dist/skills/catalog.js +1 -1
- package/dist/storage/domains/audit/actions.d.ts +3 -2
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +7 -5
- 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 +1 -3
- package/dist/storage/domains/audit/domain.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +107 -23
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +201 -65
- 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 +25 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/channel-identity/base.d.ts +0 -4
- package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
- package/dist/storage/domains/channel-identity/base.js +0 -7
- package/dist/storage/domains/channel-identity/base.js.map +1 -1
- package/dist/storage/domains/intake/base.d.ts +5 -45
- package/dist/storage/domains/intake/base.d.ts.map +1 -1
- package/dist/storage/domains/intake/base.js +11 -89
- package/dist/storage/domains/intake/base.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 +23 -9
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +24 -8
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
- package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
- package/dist/storage/domains/sandbox-envs/base.js +227 -0
- package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
- 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 +93 -24
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +413 -188
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/board-version.d.ts +6 -2
- package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
- package/dist/storage/domains/work-items/board-version.js +20 -9
- package/dist/storage/domains/work-items/board-version.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +33 -5
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +208 -25
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
- package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
- package/dist/storage/domains/work-items/legacy-review.js +109 -0
- package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
- package/dist/storage/domains/work-items/metrics.d.ts +12 -4
- package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
- package/dist/storage/domains/work-items/metrics.js +14 -32
- package/dist/storage/domains/work-items/metrics.js.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.d.ts +6 -2
- package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.js +83 -27
- 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/approval-tools.d.ts.map +1 -1
- package/dist/tools/approval-tools.js +28 -9
- package/dist/tools/approval-tools.js.map +1 -1
- package/dist/tools/index.d.ts +1 -1
- package/dist/tools/index.js +1 -1
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/messaging-tools.d.ts +3 -0
- package/dist/tools/messaging-tools.d.ts.map +1 -1
- package/dist/tools/messaging-tools.js +2 -1
- package/dist/tools/messaging-tools.js.map +1 -1
- package/dist/tools/read-tools.d.ts +10 -6
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +89 -39
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/reports.d.ts +1 -0
- package/dist/tools/reports.d.ts.map +1 -1
- package/dist/tools/reports.js +2 -1
- package/dist/tools/reports.js.map +1 -1
- package/dist/tools/run-watch.d.ts +1 -1
- package/dist/tools/run-watch.d.ts.map +1 -1
- package/dist/tools/run-watch.js +1 -0
- package/dist/tools/run-watch.js.map +1 -1
- package/dist/tools/sandbox-tools.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 +1 -1
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/sessions-state-processor.d.ts +3 -1
- package/dist/tools/sessions-state-processor.d.ts.map +1 -1
- package/dist/tools/sessions-state-processor.js +13 -4
- package/dist/tools/sessions-state-processor.js.map +1 -1
- package/dist/tools/side-sessions.d.ts +2 -0
- package/dist/tools/side-sessions.d.ts.map +1 -1
- package/dist/tools/side-sessions.js +2 -1
- package/dist/tools/side-sessions.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts +0 -3
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +10 -20
- package/dist/tools/work-item-tools.js.map +1 -1
- 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-item-branch.d.ts +13 -0
- package/dist/work-item-branch.d.ts.map +1 -1
- package/dist/work-item-branch.js +16 -1
- package/dist/work-item-branch.js.map +1 -1
- package/dist/work-items/create-work-item.d.ts +6 -0
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +28 -3
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/work-items/description-context.d.ts +5 -0
- package/dist/work-items/description-context.d.ts.map +1 -0
- package/dist/work-items/description-context.js +17 -0
- package/dist/work-items/description-context.js.map +1 -0
- package/dist/work-items/providers/base.d.ts +4 -1
- package/dist/work-items/providers/base.d.ts.map +1 -1
- package/dist/work-items/providers/base.js +6 -1
- package/dist/work-items/providers/base.js.map +1 -1
- package/dist/work-items/providers/github.d.ts.map +1 -1
- package/dist/work-items/providers/github.js +2 -1
- package/dist/work-items/providers/github.js.map +1 -1
- package/dist/work-items/providers/gitlab.d.ts.map +1 -1
- package/dist/work-items/providers/gitlab.js +2 -1
- package/dist/work-items/providers/gitlab.js.map +1 -1
- package/dist/work-items/providers/jira.d.ts.map +1 -1
- package/dist/work-items/providers/jira.js +3 -2
- package/dist/work-items/providers/jira.js.map +1 -1
- package/dist/work-items/providers/linear.d.ts.map +1 -1
- package/dist/work-items/providers/linear.js +3 -2
- package/dist/work-items/providers/linear.js.map +1 -1
- package/dist/work-items/providers/types.d.ts +6 -0
- package/dist/work-items/providers/types.d.ts.map +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 +178 -70
- package/dist/work-items/split-migration.js.map +1 -1
- package/dist/workspace.d.ts +3 -1
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +118 -34
- package/dist/workspace.js.map +1 -1
- package/factory-skills/configure-factory-rules/SKILL.md +13 -11
- package/factory-skills/factory-build/SKILL.md +64 -0
- package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
- package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
- package/factory-skills/factory-plan/SKILL.md +8 -10
- package/factory-skills/factory-rereview/SKILL.md +74 -28
- package/factory-skills/factory-review/SKILL.md +85 -29
- package/factory-skills/factory-self-review/SKILL.md +32 -13
- package/factory-skills/factory-triage/SKILL.md +36 -32
- package/package.json +12 -11
- package/dist/boards/index.js.map +0 -1
- package/dist/boards/pull-request-review.d.ts +0 -14
- package/dist/boards/pull-request-review.d.ts.map +0 -1
- package/dist/boards/pull-request-review.js +0 -81
- package/dist/boards/pull-request-review.js.map +0 -1
- package/dist/boards/work-tool-rules.d.ts +0 -8
- package/dist/boards/work-tool-rules.d.ts.map +0 -1
- package/dist/boards/work-tool-rules.js +0 -19
- package/dist/boards/work-tool-rules.js.map +0 -1
- package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
- package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
- package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
- package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
- package/dist/integrations/slack/emoji.d.ts +0 -3
- package/dist/integrations/slack/emoji.d.ts.map +0 -1
- package/dist/integrations/slack/emoji.js +0 -11
- package/dist/integrations/slack/emoji.js.map +0 -1
- package/dist/integrations/slack/feed-publisher.d.ts +0 -26
- package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
- package/dist/integrations/slack/feed-publisher.js +0 -43
- package/dist/integrations/slack/feed-publisher.js.map +0 -1
- package/dist/routes/attention-activity.d.ts +0 -23
- package/dist/routes/attention-activity.d.ts.map +0 -1
- package/dist/routes/attention-activity.js +0 -154
- package/dist/routes/attention-activity.js.map +0 -1
- package/dist/rules/resolve.d.ts +0 -15
- package/dist/rules/resolve.d.ts.map +0 -1
- package/dist/rules/resolve.js +0 -22
- package/dist/rules/resolve.js.map +0 -1
- package/dist/storage/domains/comments/activity.d.ts +0 -40
- package/dist/storage/domains/comments/activity.d.ts.map +0 -1
- package/dist/storage/domains/comments/activity.js +0 -93
- package/dist/storage/domains/comments/activity.js.map +0 -1
- package/dist/storage/domains/comments/actor.d.ts +0 -51
- package/dist/storage/domains/comments/actor.d.ts.map +0 -1
- package/dist/storage/domains/comments/actor.js +0 -37
- package/dist/storage/domains/comments/actor.js.map +0 -1
- package/dist/storage/domains/comments/base.d.ts +0 -245
- package/dist/storage/domains/comments/base.d.ts.map +0 -1
- package/dist/storage/domains/comments/base.js +0 -539
- package/dist/storage/domains/comments/base.js.map +0 -1
- package/dist/storage/domains/comments/domain.d.ts +0 -135
- package/dist/storage/domains/comments/domain.d.ts.map +0 -1
- package/dist/storage/domains/comments/domain.js +0 -284
- package/dist/storage/domains/comments/domain.js.map +0 -1
- package/dist/storage/domains/comments/feed-context.d.ts +0 -22
- package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
- package/dist/storage/domains/comments/feed-context.js +0 -88
- package/dist/storage/domains/comments/feed-context.js.map +0 -1
- package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
- package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
- package/dist/storage/domains/comments/feed-sync.js +0 -1
- package/dist/storage/domains/comments/parse.d.ts +0 -23
- package/dist/storage/domains/comments/parse.d.ts.map +0 -1
- package/dist/storage/domains/comments/parse.js +0 -89
- package/dist/storage/domains/comments/parse.js.map +0 -1
- package/dist/storage/domains/comments/routes.d.ts +0 -24
- package/dist/storage/domains/comments/routes.d.ts.map +0 -1
- package/dist/storage/domains/comments/routes.js +0 -301
- package/dist/storage/domains/comments/routes.js.map +0 -1
- package/dist/storage/domains/comments/schema.d.ts +0 -5
- package/dist/storage/domains/comments/schema.d.ts.map +0 -1
- package/dist/storage/domains/comments/schema.js +0 -178
- package/dist/storage/domains/comments/schema.js.map +0 -1
- package/dist/storage/domains/comments/wire.d.ts +0 -40
- package/dist/storage/domains/comments/wire.d.ts.map +0 -1
- package/dist/storage/domains/comments/wire.js +0 -36
- package/dist/storage/domains/comments/wire.js.map +0 -1
- package/factory-skills/factory-complete-issue/SKILL.md +0 -24
package/dist/boards/semantics.js
CHANGED
|
@@ -1,31 +1,234 @@
|
|
|
1
|
+
import { workItemBranch, workItemBranchSource } from "../work-item-branch.js";
|
|
2
|
+
import "./default-board.js";
|
|
3
|
+
import "./define-board.js";
|
|
4
|
+
import { reviewBoard } from "./review.js";
|
|
5
|
+
import { workBoard } from "./work.js";
|
|
1
6
|
// src/boards/semantics.ts
|
|
2
7
|
/**
|
|
3
8
|
* Board that owns a work item. Rows created before boards were persisted carry no `board`;
|
|
4
|
-
* they belong to
|
|
5
|
-
*
|
|
9
|
+
* they belong to the default board. (Pull requests used to default to the retired Review board;
|
|
10
|
+
* storage reads those rows as the default board, and keeps cards stored on Review there only in a
|
|
11
|
+
* project that still uses it.)
|
|
6
12
|
*/
|
|
7
13
|
function boardForWorkItem(item) {
|
|
8
|
-
return item.board ??
|
|
14
|
+
return item.board ?? "work";
|
|
9
15
|
}
|
|
16
|
+
const flows = /* @__PURE__ */ new WeakMap();
|
|
10
17
|
/**
|
|
11
|
-
*
|
|
12
|
-
*
|
|
18
|
+
* The phases a board's pull request loop runs through, read from what each phase declares
|
|
19
|
+
* rather than from its key:
|
|
20
|
+
*
|
|
21
|
+
* Only phases running in the {@link REVIEW_CONTEXT} seat count as reviews: it is the only seat
|
|
22
|
+
* that records verdicts.
|
|
23
|
+
*
|
|
24
|
+
* - `pullRequestReview`: the first phase that grants `factory_review_source`. It takes pull
|
|
25
|
+
* requests: a pull request's own card is reviewed there, an attached pull request is reviewed
|
|
26
|
+
* there, verdicts on pull requests are recorded there, and a push or review request re-enters it.
|
|
27
|
+
* - `selfReview`: the first working phase that grants `factory_record_review_verdict` without
|
|
28
|
+
* `factory_review_source`: an independent review of the builder's branch before a pull request.
|
|
29
|
+
* - `triage`: on a board with a `build` phase, the first working phase that neither builds (runs
|
|
30
|
+
* in `buildRole`) nor reviews: it sorts new cards before anyone accepts them. A board that
|
|
31
|
+
* builds nothing has no triage phase.
|
|
32
|
+
* - `build`: the last working phase, in declaration order, that is neither of those and can move
|
|
33
|
+
* into the review that follows it (`selfReview`, else `pullRequestReview`). Self-review sends
|
|
34
|
+
* requested changes back here, and its seat (`buildRole`) is woken by pull request feedback.
|
|
35
|
+
*
|
|
36
|
+
* A board without a `factory_review_source` phase has no pull request loop.
|
|
37
|
+
*/
|
|
38
|
+
function boardFlow(board) {
|
|
39
|
+
if (!board) return Object.freeze({});
|
|
40
|
+
const cached = flows.get(board);
|
|
41
|
+
if (cached) return cached;
|
|
42
|
+
const entries = Object.entries(board.phases);
|
|
43
|
+
const grants = (phase, tool) => phase.kind === "working" && phase.runner.context === "review" && (phase.tools ?? []).some((granted) => granted === tool);
|
|
44
|
+
const pullRequestReview = entries.find(([, phase]) => grants(phase, "factory_review_source"))?.[0];
|
|
45
|
+
const selfReview = entries.find(([key, phase]) => key !== pullRequestReview && grants(phase, "factory_record_review_verdict") && !grants(phase, "factory_review_source"))?.[0];
|
|
46
|
+
const handoff = selfReview ?? pullRequestReview;
|
|
47
|
+
const build = handoff ? entries.findLast(([key, phase]) => phase.kind === "working" && key !== pullRequestReview && key !== selfReview && board.allowsTransition(key, handoff))?.[0] : void 0;
|
|
48
|
+
const buildRole = build ? board.roleForPhase(build) : void 0;
|
|
49
|
+
const triage = build ? entries.find(([key, phase]) => phase.kind === "working" && key !== build && phase.runner.context !== "review" && phase.runner.context !== buildRole)?.[0] : void 0;
|
|
50
|
+
const terminals = entries.filter(([, phase]) => phase.kind === "terminal").map(([key]) => key);
|
|
51
|
+
const completed = board.sourceClosed?.completed ?? terminals[0];
|
|
52
|
+
const canceled = board.sourceClosed?.canceled ?? terminals.find((key) => key !== completed) ?? completed;
|
|
53
|
+
const ref = (phase) => Object.freeze({
|
|
54
|
+
phase,
|
|
55
|
+
title: board.phases[phase].name
|
|
56
|
+
});
|
|
57
|
+
const flow = Object.freeze({
|
|
58
|
+
initialPhase: board.initialPhase,
|
|
59
|
+
...completed ? { completed: ref(completed) } : {},
|
|
60
|
+
...canceled ? { canceled: ref(canceled) } : {},
|
|
61
|
+
...triage ? { triage } : {},
|
|
62
|
+
...pullRequestReview ? { pullRequestReview } : {},
|
|
63
|
+
...selfReview ? { selfReview } : {},
|
|
64
|
+
...build ? { build } : {},
|
|
65
|
+
...buildRole ? { buildRole } : {}
|
|
66
|
+
});
|
|
67
|
+
flows.set(board, flow);
|
|
68
|
+
return flow;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Where integrations file new items, and where one lands when no intake route takes it: the
|
|
72
|
+
* project's Work board's initial phase, else (a project an app gave only its own boards) the
|
|
73
|
+
* initial phase of its first board in catalog order. Undefined only for a project with no boards.
|
|
74
|
+
*/
|
|
75
|
+
function intakeTarget(boards) {
|
|
76
|
+
const target = boards.get("work") ?? boards.values().next().value;
|
|
77
|
+
if (!target) return void 0;
|
|
78
|
+
return Object.freeze({
|
|
79
|
+
board: target.id,
|
|
80
|
+
initialPhase: target.initialPhase
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
/** {@link intakeTarget} as a rule context field. */
|
|
84
|
+
function withIntakeTarget(boards) {
|
|
85
|
+
const intake = intakeTarget(boards);
|
|
86
|
+
return intake ? { intake } : {};
|
|
87
|
+
}
|
|
88
|
+
/** {@link boardFlow} of the board a card sits on. */
|
|
89
|
+
function cardBoardFlow(boards, item) {
|
|
90
|
+
return item ? boardFlow(boards.get(boardForWorkItem(item))) : Object.freeze({});
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Whether a card in `stage` is still waiting for someone to accept it: it rests, or it is being
|
|
94
|
+
* triaged. Approval labels hold only such cards.
|
|
95
|
+
*/
|
|
96
|
+
function awaitsAcceptance(board, stage) {
|
|
97
|
+
if (!board) return false;
|
|
98
|
+
return board.phaseKind(stage) === "resting" || stage === boardFlow(board).triage;
|
|
99
|
+
}
|
|
100
|
+
/** Whether `stage` is the phase where the board reviews pull requests. */
|
|
101
|
+
function isPullRequestReviewPhase(board, stage) {
|
|
102
|
+
const phase = boardFlow(board).pullRequestReview;
|
|
103
|
+
return phase !== void 0 && phase === stage;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Why a move breaks the shape of a card on a board with a pull request loop, or undefined when it
|
|
107
|
+
* does not: a pull request's own card is only reviewed, so it enters no other working phase, and
|
|
108
|
+
* the pull request review phase holds only cards that carry a pull request (their own, or one
|
|
109
|
+
* attached to their issue). `nextPhases` cannot say this: a resting phase may lead to both, and
|
|
110
|
+
* which one fits depends on the card.
|
|
111
|
+
*/
|
|
112
|
+
function pullRequestCardRejection(board, card, toStage) {
|
|
113
|
+
const review = boardFlow(board).pullRequestReview;
|
|
114
|
+
if (!review) return void 0;
|
|
115
|
+
const reviewName = board.phases[review]?.name ?? review;
|
|
116
|
+
if (!card.hasPullRequest && toStage === review) return `${reviewName} holds only cards with a pull request; this work item enters it once a pull request is attached to it.`;
|
|
117
|
+
if (!card.standalonePullRequest || toStage === review || !board.isWorking(toStage)) return void 0;
|
|
118
|
+
const exits = [review, ...Object.keys(board.phases).filter((key) => board.isTerminal(key))];
|
|
119
|
+
return `A pull request card is only reviewed on the ${board.name} board; it cannot enter ${toStage}. Move it to ${exits.join(", ")}.`;
|
|
120
|
+
}
|
|
121
|
+
/** `{ flow }` for spreading into an integration rule context, or `{}` for an unbound evaluation. */
|
|
122
|
+
function withBoardFlow(boards, item) {
|
|
123
|
+
return item ? { flow: cardBoardFlow(boards, item) } : {};
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* A card whose own primary source is a pull or merge request: an outside contributor's
|
|
127
|
+
* PR filed on its own card, or a PR card filed before PRs attached to their issue's card.
|
|
128
|
+
* An issue card with an attached PR is not one; see {@link hasPullRequest}.
|
|
13
129
|
*/
|
|
14
130
|
function isPullRequestCard(item) {
|
|
15
131
|
return item.source === "github-pr" || item.source === "gitlab-pr";
|
|
16
132
|
}
|
|
17
|
-
/**
|
|
18
|
-
function
|
|
19
|
-
|
|
20
|
-
|
|
133
|
+
/** Every pull or merge request source on a card, oldest first. */
|
|
134
|
+
function pullRequestSources(item) {
|
|
135
|
+
return (item.workItem?.sources ?? []).filter((source) => source.sourceType === "pull-request");
|
|
136
|
+
}
|
|
137
|
+
/** Whether a card carries a pull or merge request: its own, or one attached to its issue. */
|
|
138
|
+
function hasPullRequest(item) {
|
|
139
|
+
return item.source !== void 0 && isPullRequestCard({ source: item.source }) || pullRequestSources(item).length > 0;
|
|
140
|
+
}
|
|
141
|
+
/** A source row's external id without the type/workspace scope storage prefixes it with. */
|
|
142
|
+
function sourceExternalId(source) {
|
|
143
|
+
const prefix = `${source.sourceType}:${source.workspaceId ? `${source.workspaceId}:` : ""}`;
|
|
144
|
+
return source.externalId.startsWith(prefix) ? source.externalId.slice(prefix.length) : source.externalId;
|
|
145
|
+
}
|
|
146
|
+
/** The provider number (GitHub PR number, GitLab MR IID) a pull request source names. */
|
|
147
|
+
function pullRequestSourceNumber(source) {
|
|
148
|
+
const metadata = source.metadata ?? {};
|
|
149
|
+
const value = metadata.githubPullRequestNumber ?? metadata.gitlabMergeRequestIid ?? metadata.number;
|
|
150
|
+
return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
|
|
151
|
+
}
|
|
152
|
+
function openSource(source) {
|
|
153
|
+
const state = source.state ?? source.metadata?.state;
|
|
154
|
+
return state !== "closed" && state !== "merged" && source.metadata?.merged !== true;
|
|
21
155
|
}
|
|
22
156
|
/**
|
|
23
|
-
* The
|
|
24
|
-
* `
|
|
25
|
-
* `review` phase is the builder's self-review, which a pull request card never enters.
|
|
157
|
+
* The pull request a PR review pass on this card reviews: the one the card's
|
|
158
|
+
* `openPullRequestNumber` names, else the newest open one, else the newest one.
|
|
26
159
|
*/
|
|
27
|
-
function
|
|
28
|
-
|
|
160
|
+
function reviewedPullRequest(item) {
|
|
161
|
+
const sources = pullRequestSources(item);
|
|
162
|
+
const pointer = item.metadata?.openPullRequestNumber;
|
|
163
|
+
return (typeof pointer === "number" ? sources.find((source) => pullRequestSourceNumber(source) === pointer) : void 0) ?? sources.findLast(openSource) ?? sources.at(-1);
|
|
164
|
+
}
|
|
165
|
+
/** The newest still-open pull request on a card other than `except`, for re-pointing `openPullRequestNumber`. */
|
|
166
|
+
function newestOpenPullRequestNumber(item, except) {
|
|
167
|
+
const open = pullRequestSources(item).filter((source) => openSource(source) && pullRequestSourceNumber(source) !== except);
|
|
168
|
+
return (open.length ? pullRequestSourceNumber(open.at(-1)) : void 0) ?? null;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Whether a pull request from `headBranch` was opened by the card's own sessions: the head is
|
|
172
|
+
* one of its session branches, or the branch Factory builds the card on (stable even after its
|
|
173
|
+
* session is deleted).
|
|
174
|
+
*/
|
|
175
|
+
function cardOwnsBranch(item, headBranch) {
|
|
176
|
+
if (!headBranch) return false;
|
|
177
|
+
return workItemBranch({
|
|
178
|
+
id: item.id,
|
|
179
|
+
source: workItemBranchSource(item.externalSource),
|
|
180
|
+
metadata: item.workItem.metadata
|
|
181
|
+
}) === headBranch || Object.values(item.sessions).some((session) => session?.branch === headBranch);
|
|
182
|
+
}
|
|
183
|
+
/** The newest open pull request the card's own sessions opened, other than `except`. */
|
|
184
|
+
function newestOwnedOpenPullRequestNumber(item, except) {
|
|
185
|
+
const open = pullRequestSources(item).filter((source) => openSource(source) && pullRequestSourceNumber(source) !== except && typeof source.metadata?.headBranch === "string" && cardOwnsBranch(item, source.metadata.headBranch));
|
|
186
|
+
return (open.length ? pullRequestSourceNumber(open.at(-1)) : void 0) ?? null;
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* What a PR review on this card reviews: the card's own change request when the card is one,
|
|
190
|
+
* otherwise the attached one {@link reviewedPullRequest} picks. Undefined for a card with none.
|
|
191
|
+
*/
|
|
192
|
+
function reviewedChangeRequest(item) {
|
|
193
|
+
if (isPullRequestCard(item)) {
|
|
194
|
+
const metadata = item.workItem.metadata ?? {};
|
|
195
|
+
const gitlab = item.source === "gitlab-pr";
|
|
196
|
+
const value = (gitlab ? metadata.gitlabMergeRequestIid : metadata.githubPullRequestNumber) ?? metadata.number;
|
|
197
|
+
return {
|
|
198
|
+
provider: gitlab ? "gitlab" : "github",
|
|
199
|
+
number: typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0,
|
|
200
|
+
url: item.url ?? item.workItem.url ?? null,
|
|
201
|
+
headBranch: typeof metadata.headBranch === "string" ? metadata.headBranch : void 0,
|
|
202
|
+
standalone: true
|
|
203
|
+
};
|
|
204
|
+
}
|
|
205
|
+
const source = reviewedPullRequest(item);
|
|
206
|
+
if (!source) return void 0;
|
|
207
|
+
return {
|
|
208
|
+
provider: source.integrationId === "gitlab" ? "gitlab" : "github",
|
|
209
|
+
number: pullRequestSourceNumber(source),
|
|
210
|
+
url: source.url ?? null,
|
|
211
|
+
headBranch: typeof source.metadata?.headBranch === "string" ? source.metadata.headBranch : void 0,
|
|
212
|
+
standalone: false
|
|
213
|
+
};
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
* Whether a pass already recorded a verdict on `change`. An issue card can carry
|
|
217
|
+
* several pull requests, so a verdict stamped for another one doesn't count; a
|
|
218
|
+
* verdict with no number (a standalone card, or one stamped before verdicts named
|
|
219
|
+
* their pull request) covers the card.
|
|
220
|
+
*/
|
|
221
|
+
function hasRecordedVerdict(item, change = reviewedChangeRequest(item)) {
|
|
222
|
+
const covered = item.metadata?.reviewedPullRequestNumber;
|
|
223
|
+
const reviewedAnother = typeof covered === "number" && change?.number !== void 0 && covered !== change.number;
|
|
224
|
+
return typeof item.metadata?.reviewVerdict === "string" && !reviewedAnother;
|
|
225
|
+
}
|
|
226
|
+
/**
|
|
227
|
+
* Whether the rule's card carries a change request its board reviews: the card has one, and its
|
|
228
|
+
* board has a phase that takes pull requests ({@link boardFlow}).
|
|
229
|
+
*/
|
|
230
|
+
function reviewsPullRequest(context) {
|
|
231
|
+
return context.flow?.pullRequestReview !== void 0 && context.item !== void 0 && hasPullRequest(context.item);
|
|
29
232
|
}
|
|
30
233
|
/**
|
|
31
234
|
* What the installed board says `phase` means. Returns undefined when the board is not
|
|
@@ -81,23 +284,23 @@ function rulePhaseContext(boards, item) {
|
|
|
81
284
|
context,
|
|
82
285
|
role: context
|
|
83
286
|
},
|
|
84
|
-
nextPhases: Object.freeze([...phase?.nextPhases ?? []])
|
|
85
|
-
outcomes: Object.freeze(Object.keys(phase?.outcomes ?? {}))
|
|
287
|
+
nextPhases: Object.freeze([...phase?.nextPhases ?? []])
|
|
86
288
|
});
|
|
87
289
|
}
|
|
88
290
|
/**
|
|
89
|
-
* Whether a persisted card has finished, judged by the board it sits on: the installed
|
|
90
|
-
*
|
|
91
|
-
*
|
|
92
|
-
* released from ownership on the board's own say-so.
|
|
291
|
+
* Whether a persisted card has finished, judged by the board it sits on: the installed board's
|
|
292
|
+
* phase kind first, then, for rows whose board is not installed, the phase kinds of the default
|
|
293
|
+
* board Factory seeds or of the retired Review board. Unknown boards or phases are never terminal,
|
|
294
|
+
* so a card is only ever released from ownership on the board's own say-so.
|
|
93
295
|
*/
|
|
94
296
|
function isTerminalWorkItem(boards, item) {
|
|
95
297
|
const semantics = workItemPhaseSemantics(boards, item);
|
|
96
298
|
if (semantics) return semantics.kind === "terminal";
|
|
97
299
|
const board = boardForWorkItem(item);
|
|
98
|
-
if (board
|
|
300
|
+
if (boards.has(board)) return false;
|
|
301
|
+
const seed = board === "work" ? workBoard : board === reviewBoard.id ? reviewBoard : void 0;
|
|
99
302
|
const stage = item.stages.length === 1 ? item.stages[0] : void 0;
|
|
100
|
-
return stage
|
|
303
|
+
return stage !== void 0 && seed !== void 0 && seed.isTerminal(stage);
|
|
101
304
|
}
|
|
102
305
|
/** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */
|
|
103
306
|
function workItemPhaseSemantics(boards, item) {
|
|
@@ -106,6 +309,21 @@ function workItemPhaseSemantics(boards, item) {
|
|
|
106
309
|
return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);
|
|
107
310
|
}
|
|
108
311
|
/**
|
|
312
|
+
* Flow-metric outcomes of each board's phases: the phase the board closes completed sources into
|
|
313
|
+
* (else its first terminal phase) completes a card, other terminal phases cancel it, resting
|
|
314
|
+
* phases queue it, and anything else (working, or a phase the board no longer declares) is in
|
|
315
|
+
* flight.
|
|
316
|
+
*/
|
|
317
|
+
function boardPhaseOutcomes(boards) {
|
|
318
|
+
return (item, stage) => {
|
|
319
|
+
const board = boards.get(boardForWorkItem(item));
|
|
320
|
+
const kind = board?.phaseKind(stage);
|
|
321
|
+
if (!board || kind === void 0 || kind === "working") return "pipeline";
|
|
322
|
+
if (kind === "resting") return "queued";
|
|
323
|
+
return stage === (board.sourceClosed?.completed ?? Object.keys(board.phases).find((key) => board.isTerminal(key))) ? "completed" : "canceled";
|
|
324
|
+
};
|
|
325
|
+
}
|
|
326
|
+
/**
|
|
109
327
|
* Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed
|
|
110
328
|
* board declares, plus whether the card already sits in a terminal phase. Undefined when the
|
|
111
329
|
* board is not installed or declares no mapping, so closing the source leaves the card alone.
|
|
@@ -137,6 +355,20 @@ function rulePhaseField(boards, item) {
|
|
|
137
355
|
const phase = rulePhaseContext(boards, item);
|
|
138
356
|
return phase ? { phase } : {};
|
|
139
357
|
}
|
|
140
|
-
|
|
358
|
+
/**
|
|
359
|
+
* The change request a review session on this card may publish checks for: the card's own one,
|
|
360
|
+
* or, for an issue card in its board's pull request review phase, the pull request attached to it.
|
|
361
|
+
*/
|
|
362
|
+
function boundChangeRequestNumber(boards, item) {
|
|
363
|
+
const source = workItemBranchSource(item.externalSource);
|
|
364
|
+
if (!isPullRequestCard({ source }) && (item.stages.length !== 1 || cardBoardFlow(boards, item).pullRequestReview !== item.stages[0])) return;
|
|
365
|
+
const number = reviewedChangeRequest({
|
|
366
|
+
...item,
|
|
367
|
+
source
|
|
368
|
+
})?.number;
|
|
369
|
+
if (number !== void 0) return String(number);
|
|
370
|
+
return source === "github-pr" ? /(\d+)$/.exec(item.externalSource?.externalId ?? "")?.[1] : void 0;
|
|
371
|
+
}
|
|
372
|
+
export { awaitsAcceptance, boardEventHandlers, boardFlow, boardForWorkItem, boardPhaseOutcomes, boundChangeRequestNumber, cardBoardFlow, cardOwnsBranch, eventBoardId, hasPullRequest, hasRecordedVerdict, intakeTarget, isPullRequestCard, isPullRequestReviewPhase, isTerminalWorkItem, newestOpenPullRequestNumber, newestOwnedOpenPullRequestNumber, pullRequestCardRejection, pullRequestSourceNumber, pullRequestSources, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewedChangeRequest, reviewedPullRequest, reviewsPullRequest, rulePhaseContext, rulePhaseField, sourceExternalId, withBoardClosure, withBoardFlow, withIntakeTarget, workItemPhaseSemantics };
|
|
141
373
|
|
|
142
374
|
//# sourceMappingURL=semantics.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"semantics.js","names":[],"sources":["../../src/boards/semantics.ts"],"sourcesContent":["import type { FactoryRuleBoardClosure, FactoryRulePhaseContext } from '../rules/types.js';\nimport type { Card } from '../storage/domains/work-items/base.js';\nimport type {\n BoardEventIntegration,\n BoardEventRules,\n BoardPhaseKind,\n BoardToolResultRuleHandler,\n} from './define-board.js';\nimport type { BoardRegistry } from './registry.js';\n\nexport interface PhaseSemantics {\n readonly kind: BoardPhaseKind;\n /** Seat that carries a working phase; absent for resting and terminal phases. */\n readonly role?: string;\n}\n\n/**\n * Board that owns a work item. Rows created before boards were persisted carry no `board`;\n * they belong to Review when they track a pull request and to Work otherwise, matching the\n * legacy assignment the transition service performs on their next move.\n */\nexport function boardForWorkItem(item: Pick<Card, 'board' | 'externalSource'>): string {\n return item.board ?? (item.externalSource?.type === 'pull-request' ? 'review' : 'work');\n}\n\n/**\n * A card that tracks a pull or merge request itself, as opposed to the card whose work opened it.\n * Both can sit on Work, so rules tell them apart by source rather than by board.\n */\nexport function isPullRequestCard(item: { readonly source: string }): boolean {\n return item.source === 'github-pr' || item.source === 'gitlab-pr';\n}\n\n/** Whether the rule's card is the change request's own card, which the reviewer reviews. */\nexport function reviewsPullRequest(context: {\n readonly board?: string;\n readonly item?: { readonly source: string };\n}): boolean {\n if (context.board === 'review') return true;\n return context.board === 'work' && context.item !== undefined && isPullRequestCard(context.item);\n}\n\n/**\n * The phase a pull or merge request's own card is reviewed in: Work's `pr-review`, or Review's\n * `review` for cards filed on the Review board before pull requests moved to Work. Work's own\n * `review` phase is the builder's self-review, which a pull request card never enters.\n */\nexport function pullRequestReviewPhase(board: string | undefined): 'review' | 'pr-review' {\n return board === 'review' ? 'review' : 'pr-review';\n}\n\n/**\n * What the installed board says `phase` means. Returns undefined when the board is not\n * installed or does not declare the phase; callers must fail closed on undefined rather\n * than guess from the phase name.\n */\nexport function resolvePhaseSemantics(\n boards: BoardRegistry,\n boardId: string,\n phase: string,\n): PhaseSemantics | undefined {\n const board = boards.get(boardId);\n const kind = board?.phaseKind(phase);\n if (!board || !kind) return undefined;\n const role = board.roleForPhase(phase);\n return role === undefined ? { kind } : { kind, role };\n}\n\n/**\n * Tool-result rule the installed board declares for `toolName`. Undefined when the board is\n * not installed or declares no rule for the tool; callers must run nothing in that case.\n */\nexport function resolveBoardToolRule(\n boards: BoardRegistry,\n boardId: string,\n toolName: string,\n): BoardToolResultRuleHandler | undefined {\n return boards.get(boardId)?.tools[toolName]?.onResult;\n}\n\n/**\n * Integration event handlers the installed board declares for cards on it, or undefined when the\n * card is unbound, the board is not installed, or it declares none for this integration. Within the\n * map, `null` means the board switched that event off for its cards.\n */\nexport function boardEventHandlers<I extends BoardEventIntegration>(\n boards: Pick<BoardRegistry, 'get'>,\n boardId: string | undefined,\n integration: I,\n): BoardEventRules[I] | undefined {\n return boardId === undefined ? undefined : boards.get(boardId)?.events[integration];\n}\n\n/**\n * Board whose event handlers answer an integration evaluation: the bound card's board, except on\n * the evaluation that files a pull request's own Review card, which is about a card that does\n * not exist yet.\n */\nexport function eventBoardId(context: {\n readonly item?: unknown;\n readonly board?: string;\n readonly pullRequestIntake?: boolean;\n}): string | undefined {\n return context.item && !context.pullRequestIntake ? context.board : undefined;\n}\n\n/** What a card's single current phase means on its installed board, for integration rule contexts. */\nexport function rulePhaseContext(\n boards: Pick<BoardRegistry, 'get'>,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): FactoryRulePhaseContext | undefined {\n const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (!stage) return undefined;\n const board = boards.get(boardForWorkItem(item));\n const kind = board?.phaseKind(stage);\n if (!board || !kind) return undefined;\n const context = board.roleForPhase(stage);\n const phase = board.phases[stage];\n return Object.freeze({\n id: stage,\n kind,\n ...(context === undefined ? {} : { context, role: context }),\n nextPhases: Object.freeze([...(phase?.nextPhases ?? [])]),\n outcomes: Object.freeze(Object.keys(phase?.outcomes ?? {})),\n });\n}\n\n/**\n * Whether a persisted card has finished, judged by the board it sits on: the installed\n * board's phase kind first, then the built-in Work and Review names for rows whose board is\n * not installed. Unknown boards or phases are never terminal, so a card is only ever\n * released from ownership on the board's own say-so.\n */\nexport function isTerminalWorkItem(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): boolean {\n const semantics = workItemPhaseSemantics(boards, item);\n if (semantics) return semantics.kind === 'terminal';\n const board = boardForWorkItem(item);\n if (board !== 'work' && board !== 'review') return false;\n const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n return stage === 'done' || stage === 'canceled';\n}\n\n/** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */\nexport function workItemPhaseSemantics(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): PhaseSemantics | undefined {\n const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (!stage) return undefined;\n return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);\n}\n\n/**\n * Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed\n * board declares, plus whether the card already sits in a terminal phase. Undefined when the\n * board is not installed or declares no mapping, so closing the source leaves the card alone.\n */\nexport function resolveBoardClosure(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): FactoryRuleBoardClosure | undefined {\n const board = boards.get(boardForWorkItem(item));\n if (!board?.sourceClosed) return undefined;\n const { completed, canceled } = board.sourceClosed;\n return {\n boardTitle: board.name,\n completed: { phase: completed, title: board.phases[completed]!.name },\n canceled: { phase: canceled, title: board.phases[canceled]!.name },\n itemTerminal: item.stages.some(stage => board.isTerminal(stage)),\n };\n}\n\n/** Rule-context fragment carrying the card's `boardClosure`, empty when the board declares none. */\nexport function withBoardClosure(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): { boardClosure?: FactoryRuleBoardClosure } {\n const boardClosure = resolveBoardClosure(boards, item);\n return boardClosure ? { boardClosure } : {};\n}\n\n/** `{ phase }` for spreading into an integration rule context, or `{}` when the phase is unknown. */\nexport function rulePhaseField(\n boards: Pick<BoardRegistry, 'get'>,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): { readonly phase?: FactoryRulePhaseContext } {\n const phase = rulePhaseContext(boards, item);\n return phase ? { phase } : {};\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"semantics.js","names":[],"sources":["../../src/boards/semantics.ts"],"sourcesContent":["import type {\n FactoryRuleBoardClosure,\n FactoryRuleBoardFlow,\n FactoryRuleIntakeTarget,\n FactoryRulePhaseContext,\n} from '../rules/types.js';\nimport type { Card } from '../storage/domains/work-items/base.js';\nimport type { MetricsPhaseOutcomes } from '../storage/domains/work-items/metrics.js';\nimport type { WorkItemSourceRow } from '../storage/domains/work-items/work-item-schema.js';\nimport { workItemBranch, workItemBranchSource } from '../work-item-branch.js';\nimport { DEFAULT_BOARD_ID } from './default-board.js';\nimport { REVIEW_CONTEXT } from './define-board.js';\nimport type {\n BoardEventIntegration,\n BoardEventRules,\n BoardPhase,\n BoardPhaseKind,\n BoardToolResultRuleHandler,\n} from './define-board.js';\nimport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { reviewBoard } from './review.js';\nimport { workBoard } from './work.js';\n\nexport interface PhaseSemantics {\n readonly kind: BoardPhaseKind;\n /** Seat that carries a working phase; absent for resting and terminal phases. */\n readonly role?: string;\n}\n\n/**\n * Board that owns a work item. Rows created before boards were persisted carry no `board`;\n * they belong to the default board. (Pull requests used to default to the retired Review board;\n * storage reads those rows as the default board, and keeps cards stored on Review there only in a\n * project that still uses it.)\n */\nexport function boardForWorkItem(item: Pick<Card, 'board'>): string {\n return item.board ?? DEFAULT_BOARD_ID;\n}\n\nconst flows = new WeakMap<object, FactoryRuleBoardFlow>();\n\n/**\n * The phases a board's pull request loop runs through, read from what each phase declares\n * rather than from its key:\n *\n * Only phases running in the {@link REVIEW_CONTEXT} seat count as reviews: it is the only seat\n * that records verdicts.\n *\n * - `pullRequestReview`: the first phase that grants `factory_review_source`. It takes pull\n * requests: a pull request's own card is reviewed there, an attached pull request is reviewed\n * there, verdicts on pull requests are recorded there, and a push or review request re-enters it.\n * - `selfReview`: the first working phase that grants `factory_record_review_verdict` without\n * `factory_review_source`: an independent review of the builder's branch before a pull request.\n * - `triage`: on a board with a `build` phase, the first working phase that neither builds (runs\n * in `buildRole`) nor reviews: it sorts new cards before anyone accepts them. A board that\n * builds nothing has no triage phase.\n * - `build`: the last working phase, in declaration order, that is neither of those and can move\n * into the review that follows it (`selfReview`, else `pullRequestReview`). Self-review sends\n * requested changes back here, and its seat (`buildRole`) is woken by pull request feedback.\n *\n * A board without a `factory_review_source` phase has no pull request loop.\n */\nexport function boardFlow(board: InstalledBoard | undefined): FactoryRuleBoardFlow {\n if (!board) return Object.freeze({});\n const cached = flows.get(board);\n if (cached) return cached;\n const entries = Object.entries(board.phases) as [string, BoardPhase<string>][];\n const grants = (phase: BoardPhase<string>, tool: string) =>\n phase.kind === 'working' &&\n phase.runner.context === REVIEW_CONTEXT &&\n (phase.tools ?? []).some(granted => granted === tool);\n const pullRequestReview = entries.find(([, phase]) => grants(phase, 'factory_review_source'))?.[0];\n const selfReview = entries.find(\n ([key, phase]) =>\n key !== pullRequestReview &&\n grants(phase, 'factory_record_review_verdict') &&\n !grants(phase, 'factory_review_source'),\n )?.[0];\n const handoff = selfReview ?? pullRequestReview;\n const build = handoff\n ? entries.findLast(\n ([key, phase]) =>\n phase.kind === 'working' &&\n key !== pullRequestReview &&\n key !== selfReview &&\n board.allowsTransition(key, handoff),\n )?.[0]\n : undefined;\n const buildRole = build ? board.roleForPhase(build) : undefined;\n // Only a board that builds sorts cards first; elsewhere a working phase is just its own step.\n const triage = build\n ? entries.find(\n ([key, phase]) =>\n phase.kind === 'working' &&\n key !== build &&\n phase.runner.context !== REVIEW_CONTEXT &&\n phase.runner.context !== buildRole,\n )?.[0]\n : undefined;\n const terminals = entries.filter(([, phase]) => phase.kind === 'terminal').map(([key]) => key);\n const completed = board.sourceClosed?.completed ?? terminals[0];\n const canceled = board.sourceClosed?.canceled ?? terminals.find(key => key !== completed) ?? completed;\n const ref = (phase: string) => Object.freeze({ phase, title: board.phases[phase]!.name });\n const flow = Object.freeze({\n initialPhase: board.initialPhase,\n ...(completed ? { completed: ref(completed) } : {}),\n ...(canceled ? { canceled: ref(canceled) } : {}),\n ...(triage ? { triage } : {}),\n ...(pullRequestReview ? { pullRequestReview } : {}),\n ...(selfReview ? { selfReview } : {}),\n ...(build ? { build } : {}),\n ...(buildRole ? { buildRole } : {}),\n });\n flows.set(board, flow);\n return flow;\n}\n\n/**\n * Where integrations file new items, and where one lands when no intake route takes it: the\n * project's Work board's initial phase, else (a project an app gave only its own boards) the\n * initial phase of its first board in catalog order. Undefined only for a project with no boards.\n */\nexport function intakeTarget(boards: Pick<BoardRegistry, 'get' | 'values'>): FactoryRuleIntakeTarget | undefined {\n const target = boards.get(DEFAULT_BOARD_ID) ?? boards.values().next().value;\n if (!target) return undefined;\n return Object.freeze({ board: target.id, initialPhase: target.initialPhase });\n}\n\n/** {@link intakeTarget} as a rule context field. */\nexport function withIntakeTarget(boards: Pick<BoardRegistry, 'get' | 'values'>): { intake?: FactoryRuleIntakeTarget } {\n const intake = intakeTarget(boards);\n return intake ? { intake } : {};\n}\n\n/** {@link boardFlow} of the board a card sits on. */\nexport function cardBoardFlow(\n boards: Pick<BoardRegistry, 'get'>,\n item: Pick<Card, 'board'> | undefined,\n): FactoryRuleBoardFlow {\n return item ? boardFlow(boards.get(boardForWorkItem(item))) : Object.freeze({});\n}\n\n/**\n * Whether a card in `stage` is still waiting for someone to accept it: it rests, or it is being\n * triaged. Approval labels hold only such cards.\n */\nexport function awaitsAcceptance(board: InstalledBoard | undefined, stage: string): boolean {\n if (!board) return false;\n return board.phaseKind(stage) === 'resting' || stage === boardFlow(board).triage;\n}\n\n/** Whether `stage` is the phase where the board reviews pull requests. */\nexport function isPullRequestReviewPhase(board: InstalledBoard | undefined, stage: string | undefined): boolean {\n const phase = boardFlow(board).pullRequestReview;\n return phase !== undefined && phase === stage;\n}\n\n/**\n * Why a move breaks the shape of a card on a board with a pull request loop, or undefined when it\n * does not: a pull request's own card is only reviewed, so it enters no other working phase, and\n * the pull request review phase holds only cards that carry a pull request (their own, or one\n * attached to their issue). `nextPhases` cannot say this: a resting phase may lead to both, and\n * which one fits depends on the card.\n */\nexport function pullRequestCardRejection(\n board: InstalledBoard,\n card: { readonly standalonePullRequest: boolean; readonly hasPullRequest: boolean },\n toStage: string,\n): string | undefined {\n const review = boardFlow(board).pullRequestReview;\n if (!review) return undefined;\n const reviewName = board.phases[review]?.name ?? review;\n if (!card.hasPullRequest && toStage === review) {\n return `${reviewName} holds only cards with a pull request; this work item enters it once a pull request is attached to it.`;\n }\n if (!card.standalonePullRequest || toStage === review || !board.isWorking(toStage)) return undefined;\n const exits = [review, ...Object.keys(board.phases).filter(key => board.isTerminal(key))];\n return `A pull request card is only reviewed on the ${board.name} board; it cannot enter ${toStage}. Move it to ${exits.join(', ')}.`;\n}\n\n/** `{ flow }` for spreading into an integration rule context, or `{}` for an unbound evaluation. */\nexport function withBoardFlow(\n boards: Pick<BoardRegistry, 'get'>,\n item: Pick<Card, 'board'> | undefined,\n): { flow?: FactoryRuleBoardFlow } {\n return item ? { flow: cardBoardFlow(boards, item) } : {};\n}\n\ninterface SourcedItem {\n readonly workItem?: { readonly sources?: readonly WorkItemSourceRow[] } | null;\n}\n\n/**\n * A card whose own primary source is a pull or merge request: an outside contributor's\n * PR filed on its own card, or a PR card filed before PRs attached to their issue's card.\n * An issue card with an attached PR is not one; see {@link hasPullRequest}.\n */\nexport function isPullRequestCard(item: { readonly source: string }): boolean {\n return item.source === 'github-pr' || item.source === 'gitlab-pr';\n}\n\n/** Every pull or merge request source on a card, oldest first. */\nexport function pullRequestSources(item: SourcedItem): WorkItemSourceRow[] {\n return (item.workItem?.sources ?? []).filter(source => source.sourceType === 'pull-request');\n}\n\n/** Whether a card carries a pull or merge request: its own, or one attached to its issue. */\nexport function hasPullRequest(item: SourcedItem & { readonly source?: string }): boolean {\n return (\n (item.source !== undefined && isPullRequestCard({ source: item.source })) || pullRequestSources(item).length > 0\n );\n}\n\n/** A source row's external id without the type/workspace scope storage prefixes it with. */\nexport function sourceExternalId(source: Pick<WorkItemSourceRow, 'sourceType' | 'workspaceId' | 'externalId'>): string {\n const prefix = `${source.sourceType}:${source.workspaceId ? `${source.workspaceId}:` : ''}`;\n return source.externalId.startsWith(prefix) ? source.externalId.slice(prefix.length) : source.externalId;\n}\n\n/** The provider number (GitHub PR number, GitLab MR IID) a pull request source names. */\nexport function pullRequestSourceNumber(source: Pick<WorkItemSourceRow, 'metadata'>): number | undefined {\n const metadata = source.metadata ?? {};\n const value = metadata.githubPullRequestNumber ?? metadata.gitlabMergeRequestIid ?? metadata.number;\n return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;\n}\n\nfunction openSource(source: Pick<WorkItemSourceRow, 'state' | 'metadata'>): boolean {\n const state = source.state ?? source.metadata?.state;\n return state !== 'closed' && state !== 'merged' && source.metadata?.merged !== true;\n}\n\n/**\n * The pull request a PR review pass on this card reviews: the one the card's\n * `openPullRequestNumber` names, else the newest open one, else the newest one.\n */\nexport function reviewedPullRequest(\n item: SourcedItem & { readonly metadata?: Record<string, unknown> | null },\n): WorkItemSourceRow | undefined {\n const sources = pullRequestSources(item);\n const pointer = item.metadata?.openPullRequestNumber;\n return (\n (typeof pointer === 'number' ? sources.find(source => pullRequestSourceNumber(source) === pointer) : undefined) ??\n sources.findLast(openSource) ??\n sources.at(-1)\n );\n}\n\n/** The newest still-open pull request on a card other than `except`, for re-pointing `openPullRequestNumber`. */\nexport function newestOpenPullRequestNumber(item: SourcedItem, except?: number): number | null {\n const open = pullRequestSources(item).filter(\n source => openSource(source) && pullRequestSourceNumber(source) !== except,\n );\n return (open.length ? pullRequestSourceNumber(open.at(-1)!) : undefined) ?? null;\n}\n\ninterface SessionedItem {\n readonly sessions: Readonly<Record<string, { readonly branch?: string | null } | undefined>>;\n}\n\ntype BranchedItem = Pick<Card, 'id' | 'externalSource'> & { readonly workItem: Pick<Card['workItem'], 'metadata'> };\n\n/**\n * Whether a pull request from `headBranch` was opened by the card's own sessions: the head is\n * one of its session branches, or the branch Factory builds the card on (stable even after its\n * session is deleted).\n */\nexport function cardOwnsBranch(item: SessionedItem & BranchedItem, headBranch: string | undefined): boolean {\n if (!headBranch) return false;\n const buildBranch = workItemBranch({\n id: item.id,\n source: workItemBranchSource(item.externalSource),\n metadata: item.workItem.metadata,\n });\n return buildBranch === headBranch || Object.values(item.sessions).some(session => session?.branch === headBranch);\n}\n\n/** The newest open pull request the card's own sessions opened, other than `except`. */\nexport function newestOwnedOpenPullRequestNumber(\n item: SourcedItem & SessionedItem & BranchedItem,\n except?: number,\n): number | null {\n const open = pullRequestSources(item).filter(\n source =>\n openSource(source) &&\n pullRequestSourceNumber(source) !== except &&\n typeof source.metadata?.headBranch === 'string' &&\n cardOwnsBranch(item, source.metadata.headBranch),\n );\n return (open.length ? pullRequestSourceNumber(open.at(-1)!) : undefined) ?? null;\n}\n\n/** The pull or merge request a card's PR review covers, whichever card shape carries it. */\nexport interface ReviewedChangeRequest {\n readonly provider: 'github' | 'gitlab';\n readonly number: number | undefined;\n readonly url: string | null;\n readonly headBranch: string | undefined;\n /** The card is the change request's own card rather than an issue card it is attached to. */\n readonly standalone: boolean;\n}\n\n/**\n * What a PR review on this card reviews: the card's own change request when the card is one,\n * otherwise the attached one {@link reviewedPullRequest} picks. Undefined for a card with none.\n */\nexport function reviewedChangeRequest(item: {\n readonly source: string;\n readonly url?: string | null;\n readonly metadata?: Record<string, unknown> | null;\n readonly workItem: {\n readonly url?: string | null;\n readonly metadata?: Record<string, unknown> | null;\n readonly sources?: readonly WorkItemSourceRow[];\n };\n}): ReviewedChangeRequest | undefined {\n if (isPullRequestCard(item)) {\n const metadata = item.workItem.metadata ?? {};\n const gitlab = item.source === 'gitlab-pr';\n const value = (gitlab ? metadata.gitlabMergeRequestIid : metadata.githubPullRequestNumber) ?? metadata.number;\n return {\n provider: gitlab ? 'gitlab' : 'github',\n number: typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined,\n url: item.url ?? item.workItem.url ?? null,\n headBranch: typeof metadata.headBranch === 'string' ? metadata.headBranch : undefined,\n standalone: true,\n };\n }\n const source = reviewedPullRequest(item);\n if (!source) return undefined;\n return {\n provider: source.integrationId === 'gitlab' ? 'gitlab' : 'github',\n number: pullRequestSourceNumber(source),\n url: source.url ?? null,\n headBranch: typeof source.metadata?.headBranch === 'string' ? source.metadata.headBranch : undefined,\n standalone: false,\n };\n}\n\n/**\n * Whether a pass already recorded a verdict on `change`. An issue card can carry\n * several pull requests, so a verdict stamped for another one doesn't count; a\n * verdict with no number (a standalone card, or one stamped before verdicts named\n * their pull request) covers the card.\n */\nexport function hasRecordedVerdict(\n item: Parameters<typeof reviewedChangeRequest>[0],\n change: Pick<ReviewedChangeRequest, 'number'> | undefined = reviewedChangeRequest(item),\n): boolean {\n const covered = item.metadata?.reviewedPullRequestNumber;\n const reviewedAnother = typeof covered === 'number' && change?.number !== undefined && covered !== change.number;\n return typeof item.metadata?.reviewVerdict === 'string' && !reviewedAnother;\n}\n\n/**\n * Whether the rule's card carries a change request its board reviews: the card has one, and its\n * board has a phase that takes pull requests ({@link boardFlow}).\n */\nexport function reviewsPullRequest(context: {\n readonly flow?: Pick<FactoryRuleBoardFlow, 'pullRequestReview'>;\n readonly item?: SourcedItem & { readonly source: string };\n}): boolean {\n return context.flow?.pullRequestReview !== undefined && context.item !== undefined && hasPullRequest(context.item);\n}\n\n/**\n * What the installed board says `phase` means. Returns undefined when the board is not\n * installed or does not declare the phase; callers must fail closed on undefined rather\n * than guess from the phase name.\n */\nexport function resolvePhaseSemantics(\n boards: BoardRegistry,\n boardId: string,\n phase: string,\n): PhaseSemantics | undefined {\n const board = boards.get(boardId);\n const kind = board?.phaseKind(phase);\n if (!board || !kind) return undefined;\n const role = board.roleForPhase(phase);\n return role === undefined ? { kind } : { kind, role };\n}\n\n/**\n * Tool-result rule the installed board declares for `toolName`. Undefined when the board is\n * not installed or declares no rule for the tool; callers must run nothing in that case.\n */\nexport function resolveBoardToolRule(\n boards: BoardRegistry,\n boardId: string,\n toolName: string,\n): BoardToolResultRuleHandler | undefined {\n return boards.get(boardId)?.tools[toolName]?.onResult;\n}\n\n/**\n * Integration event handlers the installed board declares for cards on it, or undefined when the\n * card is unbound, the board is not installed, or it declares none for this integration. Within the\n * map, `null` means the board switched that event off for its cards.\n */\nexport function boardEventHandlers<I extends BoardEventIntegration>(\n boards: Pick<BoardRegistry, 'get'>,\n boardId: string | undefined,\n integration: I,\n): BoardEventRules[I] | undefined {\n return boardId === undefined ? undefined : boards.get(boardId)?.events[integration];\n}\n\n/**\n * Board whose event handlers answer an integration evaluation: the bound card's board, except on\n * the evaluation that files a pull request's own Review card, which is about a card that does\n * not exist yet.\n */\nexport function eventBoardId(context: {\n readonly item?: unknown;\n readonly board?: string;\n readonly pullRequestIntake?: boolean;\n}): string | undefined {\n return context.item && !context.pullRequestIntake ? context.board : undefined;\n}\n\n/** What a card's single current phase means on its installed board, for integration rule contexts. */\nexport function rulePhaseContext(\n boards: Pick<BoardRegistry, 'get'>,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): FactoryRulePhaseContext | undefined {\n const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (!stage) return undefined;\n const board = boards.get(boardForWorkItem(item));\n const kind = board?.phaseKind(stage);\n if (!board || !kind) return undefined;\n const context = board.roleForPhase(stage);\n const phase = board.phases[stage];\n return Object.freeze({\n id: stage,\n kind,\n ...(context === undefined ? {} : { context, role: context }),\n nextPhases: Object.freeze([...(phase?.nextPhases ?? [])]),\n });\n}\n\n/**\n * Whether a persisted card has finished, judged by the board it sits on: the installed board's\n * phase kind first, then, for rows whose board is not installed, the phase kinds of the default\n * board Factory seeds or of the retired Review board. Unknown boards or phases are never terminal,\n * so a card is only ever released from ownership on the board's own say-so.\n */\nexport function isTerminalWorkItem(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): boolean {\n const semantics = workItemPhaseSemantics(boards, item);\n if (semantics) return semantics.kind === 'terminal';\n const board = boardForWorkItem(item);\n if (boards.has(board)) return false;\n const seed = board === DEFAULT_BOARD_ID ? workBoard : board === reviewBoard.id ? reviewBoard : undefined;\n const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n return stage !== undefined && seed !== undefined && seed.isTerminal(stage);\n}\n\n/** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */\nexport function workItemPhaseSemantics(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): PhaseSemantics | undefined {\n const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n if (!stage) return undefined;\n return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);\n}\n\n/**\n * Flow-metric outcomes of each board's phases: the phase the board closes completed sources into\n * (else its first terminal phase) completes a card, other terminal phases cancel it, resting\n * phases queue it, and anything else (working, or a phase the board no longer declares) is in\n * flight.\n */\nexport function boardPhaseOutcomes(boards: Pick<BoardRegistry, 'get'>): MetricsPhaseOutcomes {\n return (item, stage) => {\n const board = boards.get(boardForWorkItem(item));\n const kind = board?.phaseKind(stage);\n if (!board || kind === undefined || kind === 'working') return 'pipeline';\n if (kind === 'resting') return 'queued';\n const completed = board.sourceClosed?.completed ?? Object.keys(board.phases).find(key => board.isTerminal(key));\n return stage === completed ? 'completed' : 'canceled';\n };\n}\n\n/**\n * Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed\n * board declares, plus whether the card already sits in a terminal phase. Undefined when the\n * board is not installed or declares no mapping, so closing the source leaves the card alone.\n */\nexport function resolveBoardClosure(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): FactoryRuleBoardClosure | undefined {\n const board = boards.get(boardForWorkItem(item));\n if (!board?.sourceClosed) return undefined;\n const { completed, canceled } = board.sourceClosed;\n return {\n boardTitle: board.name,\n completed: { phase: completed, title: board.phases[completed]!.name },\n canceled: { phase: canceled, title: board.phases[canceled]!.name },\n itemTerminal: item.stages.some(stage => board.isTerminal(stage)),\n };\n}\n\n/** Rule-context fragment carrying the card's `boardClosure`, empty when the board declares none. */\nexport function withBoardClosure(\n boards: BoardRegistry,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): { boardClosure?: FactoryRuleBoardClosure } {\n const boardClosure = resolveBoardClosure(boards, item);\n return boardClosure ? { boardClosure } : {};\n}\n\n/** `{ phase }` for spreading into an integration rule context, or `{}` when the phase is unknown. */\nexport function rulePhaseField(\n boards: Pick<BoardRegistry, 'get'>,\n item: Pick<Card, 'board' | 'externalSource' | 'stages'>,\n): { readonly phase?: FactoryRulePhaseContext } {\n const phase = rulePhaseContext(boards, item);\n return phase ? { phase } : {};\n}\n\n/**\n * The change request a review session on this card may publish checks for: the card's own one,\n * or, for an issue card in its board's pull request review phase, the pull request attached to it.\n */\nexport function boundChangeRequestNumber(boards: Pick<BoardRegistry, 'get'>, item: Card): string | undefined {\n const source = workItemBranchSource(item.externalSource);\n const own = isPullRequestCard({ source });\n if (!own && (item.stages.length !== 1 || cardBoardFlow(boards, item).pullRequestReview !== item.stages[0])) {\n return undefined;\n }\n const number = reviewedChangeRequest({ ...item, source })?.number;\n if (number !== undefined) return String(number);\n // A GitHub key ends in its number (`github-pr:34`); a GitLab key is encoded, so its digits mean nothing.\n return source === 'github-pr' ? /(\\d+)$/.exec(item.externalSource?.externalId ?? '')?.[1] : undefined;\n}\n"],"mappings":"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"}
|
|
@@ -14,6 +14,10 @@ export declare const storedPhaseInputSchema: z.ZodObject<{
|
|
|
14
14
|
skill: z.ZodOptional<z.ZodString>;
|
|
15
15
|
context: z.ZodOptional<z.ZodString>;
|
|
16
16
|
instructions: z.ZodOptional<z.ZodString>;
|
|
17
|
+
goal: z.ZodOptional<z.ZodObject<{
|
|
18
|
+
objective: z.ZodString;
|
|
19
|
+
maxRuns: z.ZodOptional<z.ZodNumber>;
|
|
20
|
+
}, z.core.$strict>>;
|
|
17
21
|
}, z.core.$strict>>>;
|
|
18
22
|
nextPhases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
|
|
19
23
|
autoStart: z.ZodOptional<z.ZodBoolean>;
|
|
@@ -23,6 +27,10 @@ export declare const storedPhaseInputSchema: z.ZodObject<{
|
|
|
23
27
|
autoApprove: z.ZodOptional<z.ZodBoolean>;
|
|
24
28
|
autoApproveWhen: z.ZodOptional<z.ZodType<import("../index.js").RuleGroup, unknown, z.core.$ZodTypeInternals<import("../index.js").RuleGroup, unknown>>>;
|
|
25
29
|
}, z.core.$strict>>>;
|
|
30
|
+
tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
|
|
31
|
+
factory_record_review_verdict: "factory_record_review_verdict";
|
|
32
|
+
factory_review_source: "factory_review_source";
|
|
33
|
+
}>>>>;
|
|
26
34
|
}, z.core.$strict>;
|
|
27
35
|
/**
|
|
28
36
|
* A board's editable fields without its key, the shape of a replace. Only the shape: the board
|
|
@@ -44,6 +52,10 @@ export declare const storedBoardDefinitionSchema: z.ZodObject<{
|
|
|
44
52
|
skill: z.ZodOptional<z.ZodString>;
|
|
45
53
|
context: z.ZodOptional<z.ZodString>;
|
|
46
54
|
instructions: z.ZodOptional<z.ZodString>;
|
|
55
|
+
goal: z.ZodOptional<z.ZodObject<{
|
|
56
|
+
objective: z.ZodString;
|
|
57
|
+
maxRuns: z.ZodOptional<z.ZodNumber>;
|
|
58
|
+
}, z.core.$strict>>;
|
|
47
59
|
}, z.core.$strict>>>;
|
|
48
60
|
nextPhases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
|
|
49
61
|
autoStart: z.ZodOptional<z.ZodBoolean>;
|
|
@@ -53,6 +65,10 @@ export declare const storedBoardDefinitionSchema: z.ZodObject<{
|
|
|
53
65
|
autoApprove: z.ZodOptional<z.ZodBoolean>;
|
|
54
66
|
autoApproveWhen: z.ZodOptional<z.ZodType<import("../index.js").RuleGroup, unknown, z.core.$ZodTypeInternals<import("../index.js").RuleGroup, unknown>>>;
|
|
55
67
|
}, z.core.$strict>>>;
|
|
68
|
+
tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
|
|
69
|
+
factory_record_review_verdict: "factory_record_review_verdict";
|
|
70
|
+
factory_review_source: "factory_review_source";
|
|
71
|
+
}>>>>;
|
|
56
72
|
}, z.core.$strict>>;
|
|
57
73
|
}, z.core.$strict>;
|
|
58
74
|
/**
|
|
@@ -76,6 +92,10 @@ export declare const storedBoardInputSchema: z.ZodObject<{
|
|
|
76
92
|
skill: z.ZodOptional<z.ZodString>;
|
|
77
93
|
context: z.ZodOptional<z.ZodString>;
|
|
78
94
|
instructions: z.ZodOptional<z.ZodString>;
|
|
95
|
+
goal: z.ZodOptional<z.ZodObject<{
|
|
96
|
+
objective: z.ZodString;
|
|
97
|
+
maxRuns: z.ZodOptional<z.ZodNumber>;
|
|
98
|
+
}, z.core.$strict>>;
|
|
79
99
|
}, z.core.$strict>>>;
|
|
80
100
|
nextPhases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
|
|
81
101
|
autoStart: z.ZodOptional<z.ZodBoolean>;
|
|
@@ -85,17 +105,69 @@ export declare const storedBoardInputSchema: z.ZodObject<{
|
|
|
85
105
|
autoApprove: z.ZodOptional<z.ZodBoolean>;
|
|
86
106
|
autoApproveWhen: z.ZodOptional<z.ZodType<import("../index.js").RuleGroup, unknown, z.core.$ZodTypeInternals<import("../index.js").RuleGroup, unknown>>>;
|
|
87
107
|
}, z.core.$strict>>>;
|
|
108
|
+
tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
|
|
109
|
+
factory_record_review_verdict: "factory_record_review_verdict";
|
|
110
|
+
factory_review_source: "factory_review_source";
|
|
111
|
+
}>>>>;
|
|
88
112
|
}, z.core.$strict>>;
|
|
89
113
|
key: z.ZodString;
|
|
90
114
|
}, z.core.$strict>;
|
|
91
115
|
/**
|
|
92
116
|
* Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where
|
|
93
117
|
* cards start.
|
|
118
|
+
*
|
|
119
|
+
* With `code`, the board is a project's edit of that code board: its phases come from the stored
|
|
120
|
+
* definition and the board-level behaviour from the code declaration (`tools`, `events`,
|
|
121
|
+
* `sourceClosed`, `transitionPolicy`). An edit that behaviour can't honour
|
|
122
|
+
* ({@link codeBehaviourConflicts}) is refused.
|
|
94
123
|
*/
|
|
95
|
-
export declare function compileStoredBoard(board: StoredBoardInput): InstalledBoard;
|
|
124
|
+
export declare function compileStoredBoard(board: StoredBoardInput, code?: InstalledBoard): InstalledBoard;
|
|
125
|
+
/** A board served from a stored row, and what of its code board's behaviour it runs without. */
|
|
126
|
+
interface MergedStoredBoard {
|
|
127
|
+
board: InstalledBoard;
|
|
128
|
+
/** One per piece of code behaviour the row can't run with; empty when it runs with all of it. */
|
|
129
|
+
problems: string[];
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike
|
|
133
|
+
* {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an
|
|
134
|
+
* edit from before a release added a phase or a code move, a row older than editable code boards)
|
|
135
|
+
* still runs as stored.
|
|
136
|
+
*
|
|
137
|
+
* - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a
|
|
138
|
+
* person from moving a card past an unapproved exit tool. If the row lacks a code phase, the
|
|
139
|
+
* moves they make to it are refused, and that is reported.
|
|
140
|
+
* - The board's `events` and `transitionPolicy` attach only when the row has every code phase,
|
|
141
|
+
* since their handlers may move cards to any of them; `sourceClosed` when both of its phases are
|
|
142
|
+
* stored and terminal.
|
|
143
|
+
* - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.
|
|
144
|
+
* - If the board still fails to compile with that behaviour, it runs without any.
|
|
145
|
+
*
|
|
146
|
+
* The result links to `code` as its code board either way. Throws only when the row itself is
|
|
147
|
+
* invalid.
|
|
148
|
+
*/
|
|
149
|
+
export declare function mergeCodeBehaviour(row: StoredBoardInput, code: InstalledBoard): MergedStoredBoard;
|
|
150
|
+
/** What a code board's behaviour holds fixed on each of its phases; the rest of the phase is editable. */
|
|
151
|
+
interface CodePhaseBehaviour {
|
|
152
|
+
/** Phases code moves cards to from it; they stay in its nextPhases. */
|
|
153
|
+
requiredNextPhases: string[];
|
|
154
|
+
}
|
|
155
|
+
/** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */
|
|
156
|
+
export declare function codeBehaviourOf(code: InstalledBoard): Record<string, CodePhaseBehaviour>;
|
|
157
|
+
/**
|
|
158
|
+
* Why a stored definition of a code board's key can't run with that board's code behaviour, one
|
|
159
|
+
* reason per locked change; empty when it can. Code (tool and event rules, `sourceClosed`,
|
|
160
|
+
* integrations) names the board's phases, its first phase, each phase's kind and the moves it
|
|
161
|
+
* makes between phases, so those stay as code declares them. Names, descriptions, runners, exit
|
|
162
|
+
* tools, phase tools, added moves, start and approval conditions and new phases are free.
|
|
163
|
+
*/
|
|
164
|
+
export declare function codeBehaviourConflicts(board: StoredBoardInput, code: InstalledBoard): string[];
|
|
165
|
+
/** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */
|
|
166
|
+
export declare function sameBoardDefinition(a: StoredBoardInput, b: StoredBoardInput): boolean;
|
|
96
167
|
/**
|
|
97
168
|
* A board's storable definition, in the shape the boards API reads and writes. The initial phase
|
|
98
169
|
* comes first and every phase's resolved `nextPhases` is written out.
|
|
99
170
|
*/
|
|
100
171
|
export declare function boardDefinitionOf(board: InstalledBoard): StoredBoardInput;
|
|
172
|
+
export {};
|
|
101
173
|
//# 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;
|
|
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;AAmBpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaxB,CAAC;AAUZ;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU/B,CAAC;AASL;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,CAcjG;AAED,gGAAgG;AAChG,UAAU,iBAAiB;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAkEjG;AAwDD,0GAA0G;AAC1G,UAAU,kBAAkB;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,CAOxF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAwB9F;AAED,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"}
|