@mastra/factory 0.29.0-alpha.4 → 0.29.0-alpha.6
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 +172 -89
- package/dist/boards/board-events.d.ts +89 -9
- package/dist/boards/board-events.d.ts.map +1 -1
- package/dist/boards/board-events.js +176 -13
- package/dist/boards/board-events.js.map +1 -1
- package/dist/boards/board-writes.d.ts.map +1 -1
- package/dist/boards/board-writes.js +14 -1
- package/dist/boards/board-writes.js.map +1 -1
- package/dist/boards/busy-card.d.ts +11 -0
- package/dist/boards/busy-card.d.ts.map +1 -0
- package/dist/boards/busy-card.js +15 -0
- package/dist/boards/busy-card.js.map +1 -0
- package/dist/boards/card-facts.d.ts.map +1 -1
- package/dist/boards/card-facts.js +18 -4
- package/dist/boards/card-facts.js.map +1 -1
- package/dist/boards/index.d.ts +2 -1
- package/dist/boards/index.d.ts.map +1 -1
- package/dist/boards/index.js +3 -2
- package/dist/boards/intake-dry-run.d.ts +109 -0
- package/dist/boards/intake-dry-run.d.ts.map +1 -0
- package/dist/boards/intake-dry-run.js +158 -0
- package/dist/boards/intake-dry-run.js.map +1 -0
- package/dist/boards/intake-lookup.d.ts +32 -0
- package/dist/boards/intake-lookup.d.ts.map +1 -0
- package/dist/boards/intake-lookup.js +12 -0
- package/dist/boards/intake-lookup.js.map +1 -0
- package/dist/boards/intake-order.d.ts +32 -0
- package/dist/boards/intake-order.d.ts.map +1 -0
- package/dist/boards/intake-order.js +60 -0
- package/dist/boards/intake-order.js.map +1 -0
- package/dist/boards/intake-routing.d.ts +246 -35
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +437 -52
- package/dist/boards/intake-routing.js.map +1 -1
- package/dist/boards/reroute.d.ts +7 -3
- package/dist/boards/reroute.d.ts.map +1 -1
- package/dist/boards/reroute.js +21 -4
- package/dist/boards/reroute.js.map +1 -1
- package/dist/boards/semantics.d.ts +8 -28
- package/dist/boards/semantics.d.ts.map +1 -1
- package/dist/boards/semantics.js +14 -40
- package/dist/boards/semantics.js.map +1 -1
- package/dist/boards/work-routes.d.ts +31 -11
- package/dist/boards/work-routes.d.ts.map +1 -1
- package/dist/boards/work-routes.js +104 -20
- package/dist/boards/work-routes.js.map +1 -1
- package/dist/factory.d.ts +37 -1
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +127 -48
- package/dist/factory.js.map +1 -1
- package/dist/integrations/base.d.ts +9 -0
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/dependabot/rules.js +1 -1
- package/dist/integrations/dependabot/rules.js.map +1 -1
- package/dist/integrations/github/default-rules.d.ts +22 -1
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +23 -5
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/intake-lookup.d.ts +16 -0
- package/dist/integrations/github/intake-lookup.d.ts.map +1 -0
- package/dist/integrations/github/intake-lookup.js +76 -0
- package/dist/integrations/github/intake-lookup.js.map +1 -0
- package/dist/integrations/github/integration.d.ts +19 -5
- package/dist/integrations/github/integration.d.ts.map +1 -1
- package/dist/integrations/github/integration.js +21 -6
- package/dist/integrations/github/integration.js.map +1 -1
- package/dist/integrations/github/issue-intake.d.ts +15 -0
- package/dist/integrations/github/issue-intake.d.ts.map +1 -0
- package/dist/integrations/github/issue-intake.js +50 -0
- package/dist/integrations/github/issue-intake.js.map +1 -0
- package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/github/issue-reconciler.js +10 -1
- package/dist/integrations/github/issue-reconciler.js.map +1 -1
- package/dist/integrations/github/review-status-reporter.js +1 -1
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +14 -2
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +14 -1
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +221 -30
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.d.ts.map +1 -1
- package/dist/integrations/github/sandbox.js +30 -4
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +19 -3
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/intake-lookup.d.ts +17 -0
- package/dist/integrations/gitlab/intake-lookup.d.ts.map +1 -0
- package/dist/integrations/gitlab/intake-lookup.js +85 -0
- package/dist/integrations/gitlab/intake-lookup.js.map +1 -0
- package/dist/integrations/gitlab/integration.d.ts +5 -0
- package/dist/integrations/gitlab/integration.d.ts.map +1 -1
- package/dist/integrations/gitlab/integration.js +21 -1
- package/dist/integrations/gitlab/integration.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +20 -0
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +108 -12
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +14 -4
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +12 -2
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +13 -2
- package/dist/integrations/linear/rules.js.map +1 -1
- package/dist/integrations/platform/connect/routes.d.ts +43 -1
- package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
- package/dist/integrations/platform/connect/routes.js +82 -7
- 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 -1
- package/dist/integrations/platform/connect/session-tools.js +28 -10
- package/dist/integrations/platform/connect/session-tools.js.map +1 -1
- package/dist/integrations/platform/github/event-worker.js +9 -1
- package/dist/integrations/platform/github/event-worker.js.map +1 -1
- package/dist/integrations/platform/github/integration.d.ts +6 -6
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +22 -3
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/vanta/integration.d.ts.map +1 -1
- package/dist/integrations/platform/vanta/integration.js +3 -3
- package/dist/integrations/platform/vanta/integration.js.map +1 -1
- package/dist/integrations/pull-request-head.d.ts +1 -1
- package/dist/integrations/pull-request-head.d.ts.map +1 -1
- package/dist/integrations/pull-request-head.js +5 -0
- package/dist/integrations/pull-request-head.js.map +1 -1
- package/dist/integrations/vanta/rules.js +1 -1
- package/dist/integrations/vanta/rules.js.map +1 -1
- package/dist/integrations/vanta/sync.d.ts +9 -0
- package/dist/integrations/vanta/sync.d.ts.map +1 -1
- package/dist/integrations/vanta/sync.js +10 -1
- package/dist/integrations/vanta/sync.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +13 -6
- package/dist/routes/board-snapshot.d.ts.map +1 -1
- package/dist/routes/board-snapshot.js +42 -20
- package/dist/routes/board-snapshot.js.map +1 -1
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/config.d.ts +17 -2
- package/dist/routes/config.d.ts.map +1 -1
- package/dist/routes/config.js +247 -77
- package/dist/routes/config.js.map +1 -1
- package/dist/routes/contracts.d.ts +1294 -7
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +603 -20
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/custom-endpoint-url.d.ts +8 -0
- package/dist/routes/custom-endpoint-url.d.ts.map +1 -0
- package/dist/routes/custom-endpoint-url.js +45 -0
- package/dist/routes/custom-endpoint-url.js.map +1 -0
- package/dist/routes/custom-provider-source.d.ts +24 -8
- package/dist/routes/custom-provider-source.d.ts.map +1 -1
- package/dist/routes/custom-provider-source.js +93 -43
- package/dist/routes/custom-provider-source.js.map +1 -1
- package/dist/routes/intake-check.d.ts +92 -0
- package/dist/routes/intake-check.d.ts.map +1 -0
- package/dist/routes/intake-check.js +322 -0
- package/dist/routes/intake-check.js.map +1 -0
- package/dist/routes/intake-routes.d.ts +10 -2
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +292 -11
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts +6 -0
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +20 -0
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/mastra-gateway.d.ts.map +1 -1
- package/dist/routes/mastra-gateway.js +3 -2
- package/dist/routes/mastra-gateway.js.map +1 -1
- package/dist/routes/project-sessions.d.ts +61 -0
- package/dist/routes/project-sessions.d.ts.map +1 -0
- package/dist/routes/project-sessions.js +135 -0
- package/dist/routes/project-sessions.js.map +1 -0
- package/dist/routes/projects.d.ts +6 -1
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +19 -3
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/provider-credentials.d.ts +10 -1
- package/dist/routes/provider-credentials.d.ts.map +1 -1
- package/dist/routes/provider-credentials.js +13 -16
- package/dist/routes/provider-credentials.js.map +1 -1
- package/dist/routes/run-queue.d.ts +6 -6
- package/dist/routes/run-queue.d.ts.map +1 -1
- package/dist/routes/run-queue.js +28 -8
- package/dist/routes/run-queue.js.map +1 -1
- package/dist/routes/session-rows.d.ts +30 -0
- package/dist/routes/session-rows.d.ts.map +1 -0
- package/dist/routes/session-rows.js +94 -0
- package/dist/routes/session-rows.js.map +1 -0
- package/dist/routes/source-control-sessions.d.ts +4 -5
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +8 -87
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/surface.d.ts +16 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +41 -30
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/tenant-credentials.d.ts.map +1 -1
- package/dist/routes/tenant-credentials.js +4 -4
- package/dist/routes/tenant-credentials.js.map +1 -1
- package/dist/routes/work-item-starters.d.ts +1 -0
- package/dist/routes/work-item-starters.d.ts.map +1 -1
- package/dist/routes/work-item-starters.js +14 -2
- package/dist/routes/work-item-starters.js.map +1 -1
- package/dist/routes/work-items.d.ts +22 -3
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +124 -48
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/binding-context.d.ts +5 -0
- package/dist/rules/binding-context.d.ts.map +1 -1
- package/dist/rules/binding-context.js +51 -5
- package/dist/rules/binding-context.js.map +1 -1
- package/dist/rules/dispatch-errors.js +1 -1
- package/dist/rules/dispatch-errors.js.map +1 -1
- package/dist/rules/dispatcher.d.ts +39 -7
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +363 -123
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +69 -1
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +151 -5
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/review-source-tool.js +1 -1
- package/dist/rules/rule-group.d.ts +18 -1
- package/dist/rules/rule-group.d.ts.map +1 -1
- package/dist/rules/rule-group.js +52 -8
- package/dist/rules/rule-group.js.map +1 -1
- package/dist/rules/run-bearing.d.ts +8 -0
- package/dist/rules/run-bearing.d.ts.map +1 -0
- package/dist/rules/run-bearing.js +11 -0
- package/dist/rules/run-bearing.js.map +1 -0
- package/dist/rules/start-coordinator.d.ts +2 -3
- package/dist/rules/start-coordinator.d.ts.map +1 -1
- package/dist/rules/start-coordinator.js +25 -38
- package/dist/rules/start-coordinator.js.map +1 -1
- package/dist/rules/tools.js +2 -1
- package/dist/rules/tools.js.map +1 -1
- package/dist/rules/transition-service.d.ts +16 -0
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +34 -10
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +18 -5
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +2 -1
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/update-fold.d.ts +32 -0
- package/dist/rules/update-fold.d.ts.map +1 -0
- package/dist/rules/update-fold.js +60 -0
- package/dist/rules/update-fold.js.map +1 -0
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +54 -6
- package/dist/rules/validation.js.map +1 -1
- package/dist/sandbox/session-retirement.d.ts +6 -0
- package/dist/sandbox/session-retirement.d.ts.map +1 -1
- package/dist/sandbox/session-retirement.js +17 -0
- package/dist/sandbox/session-retirement.js.map +1 -1
- package/dist/session/factory-session.d.ts.map +1 -1
- package/dist/session/factory-session.js +2 -1
- package/dist/session/factory-session.js.map +1 -1
- package/dist/session/live-sessions.d.ts +6 -1
- package/dist/session/live-sessions.d.ts.map +1 -1
- package/dist/session/live-sessions.js +4 -0
- package/dist/session/live-sessions.js.map +1 -1
- package/dist/session/resource-migration.d.ts.map +1 -1
- package/dist/session/resource-migration.js +2 -3
- package/dist/session/resource-migration.js.map +1 -1
- package/dist/session/run-audit.d.ts +10 -1
- package/dist/session/run-audit.d.ts.map +1 -1
- package/dist/session/run-audit.js +9 -1
- package/dist/session/run-audit.js.map +1 -1
- package/dist/session/self-review-gate.d.ts +26 -2
- package/dist/session/self-review-gate.d.ts.map +1 -1
- package/dist/session/self-review-gate.js +60 -10
- package/dist/session/self-review-gate.js.map +1 -1
- package/dist/session/session-row-query.d.ts +25 -0
- package/dist/session/session-row-query.d.ts.map +1 -0
- package/dist/session/session-row-query.js +47 -0
- package/dist/session/session-row-query.js.map +1 -0
- package/dist/session/session-row-status.d.ts +16 -0
- package/dist/session/session-row-status.d.ts.map +1 -0
- package/dist/session/session-row-status.js +14 -0
- package/dist/session/session-row-status.js.map +1 -0
- package/dist/session/session-row-view.d.ts +13 -0
- package/dist/session/session-row-view.d.ts.map +1 -0
- package/dist/session/session-row-view.js +118 -0
- package/dist/session/session-row-view.js.map +1 -0
- package/dist/session/session-rows.d.ts +60 -0
- package/dist/session/session-rows.d.ts.map +1 -0
- package/dist/session/session-rows.js +307 -0
- package/dist/session/session-rows.js.map +1 -0
- package/dist/session/session-threads.d.ts.map +1 -1
- package/dist/session/session-threads.js +1 -0
- package/dist/session/session-threads.js.map +1 -1
- package/dist/session/session-unloader.d.ts +101 -0
- package/dist/session/session-unloader.d.ts.map +1 -0
- package/dist/session/session-unloader.js +278 -0
- package/dist/session/session-unloader.js.map +1 -0
- package/dist/session/source-control-tools.d.ts +14 -7
- package/dist/session/source-control-tools.d.ts.map +1 -1
- package/dist/session/source-control-tools.js +10 -2
- package/dist/session/source-control-tools.js.map +1 -1
- package/dist/session/work-item-repository.d.ts +49 -1
- package/dist/session/work-item-repository.d.ts.map +1 -1
- package/dist/session/work-item-repository.js +118 -15
- package/dist/session/work-item-repository.js.map +1 -1
- package/dist/session/work-item-state-processor.d.ts.map +1 -1
- package/dist/session/work-item-state-processor.js +44 -8
- package/dist/session/work-item-state-processor.js.map +1 -1
- package/dist/session-list-changes.d.ts +9 -0
- package/dist/session-list-changes.d.ts.map +1 -0
- package/dist/session-list-changes.js +54 -0
- package/dist/session-list-changes.js.map +1 -0
- package/dist/storage/announced-lists.d.ts +14 -0
- package/dist/storage/announced-lists.d.ts.map +1 -0
- package/dist/storage/announced-lists.js +78 -0
- package/dist/storage/announced-lists.js.map +1 -0
- package/dist/storage/domains/audit/actions.d.ts +2 -1
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +3 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +163 -15
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +440 -48
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/boards/schemas.d.ts +6 -0
- package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
- package/dist/storage/domains/boards/schemas.js +95 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/custom-providers/base.d.ts +62 -19
- package/dist/storage/domains/custom-providers/base.d.ts.map +1 -1
- package/dist/storage/domains/custom-providers/base.js +131 -100
- package/dist/storage/domains/custom-providers/base.js.map +1 -1
- package/dist/storage/domains/intake/base.d.ts +25 -7
- package/dist/storage/domains/intake/base.d.ts.map +1 -1
- package/dist/storage/domains/intake/base.js +83 -19
- package/dist/storage/domains/intake/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +19 -10
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/source-control/base.d.ts +8 -0
- package/dist/storage/domains/source-control/base.d.ts.map +1 -1
- package/dist/storage/domains/source-control/base.js +110 -61
- package/dist/storage/domains/source-control/base.js.map +1 -1
- package/dist/storage/domains/source-control/inmemory.d.ts +4 -0
- package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
- package/dist/storage/domains/source-control/inmemory.js +8 -5
- package/dist/storage/domains/source-control/inmemory.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts +57 -18
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +168 -83
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +3 -2
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +4 -2
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/tools/audit-events-tool.d.ts +2 -2
- package/dist/tools/read-tools.d.ts +9 -5
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +61 -54
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/session-tools.d.ts +0 -13
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js +128 -341
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts +3 -0
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +99 -27
- package/dist/tools/work-item-tools.js.map +1 -1
- package/dist/work-item-branch.d.ts +4 -0
- package/dist/work-item-branch.d.ts.map +1 -1
- package/dist/work-item-branch.js +7 -1
- package/dist/work-item-branch.js.map +1 -1
- package/dist/work-items/card-context-sessions.d.ts +50 -0
- package/dist/work-items/card-context-sessions.d.ts.map +1 -0
- package/dist/work-items/card-context-sessions.js +84 -0
- package/dist/work-items/card-context-sessions.js.map +1 -0
- package/dist/work-items/card-reference.d.ts +21 -0
- package/dist/work-items/card-reference.d.ts.map +1 -0
- package/dist/work-items/card-reference.js +58 -0
- package/dist/work-items/card-reference.js.map +1 -0
- package/dist/work-items/change-requests.d.ts +87 -0
- package/dist/work-items/change-requests.d.ts.map +1 -0
- package/dist/work-items/change-requests.js +134 -0
- package/dist/work-items/change-requests.js.map +1 -0
- package/dist/work-items/create-work-item.d.ts +7 -2
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +44 -13
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/work-items/list-related-cards.d.ts.map +1 -1
- package/dist/work-items/list-related-cards.js +1 -1
- package/dist/work-items/list-related-cards.js.map +1 -1
- package/dist/work-items/providers/github.d.ts.map +1 -1
- package/dist/work-items/providers/github.js +1 -0
- package/dist/work-items/providers/github.js.map +1 -1
- package/factory-skills/factory-build/SKILL.md +1 -1
- package/factory-skills/factory-plan/SKILL.md +5 -3
- package/factory-skills/factory-self-review/SKILL.md +2 -0
- package/factory-skills/factory-triage/SKILL.md +1 -1
- package/package.json +10 -10
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"work-item-branch.js","names":[],"sources":["../src/work-item-branch.ts"],"sourcesContent":["import type { ExternalWorkItemSource } from './storage/domains/work-items/base.js';\n\n/**\n * Where a card came from, in the vocabulary branch naming reads. Server rows\n * map their `externalSource` into this with {@link workItemBranchSource}; the\n * board's own `WorkItem['source']` is already this union.\n */\nexport type WorkItemBranchSource =\n | 'github-issue'\n | 'github-pr'\n | 'gitlab-issue'\n | 'gitlab-pr'\n | 'linear-issue'\n | 'jira-issue'\n | 'incidentio-follow-up'\n | 'github-dependabot-alert'\n | 'vanta-vulnerability'\n | 'detail-finding'\n | 'slack-thread'\n | 'manual';\n\nexport interface WorkItemBranchInput {\n id: string;\n source: WorkItemBranchSource;\n metadata?: Record<string, unknown> | null;\n}\n\n/** Map a stored item's provenance onto the source vocabulary branch naming reads. */\nexport function workItemBranchSource(externalSource: ExternalWorkItemSource | null | undefined): WorkItemBranchSource {\n if (!externalSource) return 'manual';\n if (externalSource.integrationId === 'linear') return 'linear-issue';\n if (externalSource.integrationId === 'gitlab') {\n return externalSource.type === 'pull-request' ? 'gitlab-pr' : 'gitlab-issue';\n }\n if (externalSource.integrationId === 'jira') return 'jira-issue';\n if (externalSource.integrationId === 'incidentio') return 'incidentio-follow-up';\n // Only GitHub, GitLab, Linear, Jira, and incident.io carry provider identities; anything\n // else (a Slack thread, say) is a plain work item rather than a mislabeled GitHub issue.\n if (externalSource.integrationId === 'vanta') return 'vanta-vulnerability';\n if (externalSource.integrationId === 'detail') return 'detail-finding';\n if (externalSource.integrationId !== 'github') return 'manual';\n if (externalSource.type === 'dependabot-alert') return 'github-dependabot-alert';\n return externalSource.type === 'pull-request' ? 'github-pr' : 'github-issue';\n}\n\nfunction branchNumber(metadata: Record<string, unknown>, key: string): number | undefined {\n const value = metadata[key] ?? metadata.number;\n return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;\n}\n\n/** The provider number a GitHub card carries — the `#12` its runs and thread titles name it by. */\nexport function workItemNumber(item: Pick<WorkItemBranchInput, 'source' | 'metadata'>): number | undefined {\n const metadata = item.metadata ?? {};\n if (item.source === 'github-issue') return branchNumber(metadata, 'githubIssueNumber');\n if (item.source === 'github-pr') return branchNumber(metadata, 'githubPullRequestNumber');\n if (item.source === 'gitlab-issue') return branchNumber(metadata, 'gitlabIssueIid');\n if (item.source === 'gitlab-pr') return branchNumber(metadata, 'gitlabMergeRequestIid');\n return undefined;\n}\n\n/** How a card names its thread: a Linear title already opens with its identifier, a GitHub card gets its number here. */\nexport function workItemThreadTitle(\n item: Pick<WorkItemBranchInput, 'source' | 'metadata'> & { title: string },\n): string {\n const number = workItemNumber(item);\n if (number === undefined) return item.title;\n const kind = item.source === 'github-pr' ? 'PR' : item.source === 'gitlab-pr' ? 'MR' : 'Issue';\n return `${kind} #${number}: ${item.title}`;\n}\n\n/**\n * The last twelve alphanumerics of a work item id: the per-item suffix that keeps\n * provider numbers from colliding across the repositories of one factory. Issue\n * #13 exists in every repository, and a factory's sessions are unique per\n * user and branch across all of its repositories, so a branch named by the\n * number alone can only be held once per factory.\n */\nfunction itemSuffix(id: string): string {\n return id\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '')\n .slice(-12);\n}\n\n/**\n * The git branch an item's runs and sessions share, one grammar for both sides\n * of the wire: the dispatcher names autonomous run branches with it and the\n * board opens card sessions on it, so both converge on one checkout per item.\n * Provider numbers are only unique within a repository, so GitHub and GitLab\n * branches carry the item suffix as well. Cards without a provider identity\n * (manual, Slack) and cards whose metadata lost their identifier fall back to\n * the id-derived branch.\n */\nexport function workItemBranch(item: WorkItemBranchInput): string {\n const metadata = item.metadata ?? {};\n const providerNumber = workItemNumber(item);\n if (providerNumber !== undefined && (item.source === 'github-issue' || item.source === 'github-pr')) {\n const suffix = itemSuffix(item.id);\n const kind = item.source === 'github-issue' ? 'issue' : 'pr';\n return suffix ? `factory/${kind}-${providerNumber}-${suffix}` : `factory/${kind}-${providerNumber}`;\n }\n if (\n (item.source === 'linear-issue' || item.source === 'jira-issue' || item.source === 'incidentio-follow-up') &&\n typeof metadata.identifier === 'string'\n ) {\n const identifier = metadata.identifier.trim();\n if (identifier) {\n const provider = item.source === 'linear-issue' ? 'linear' : item.source === 'jira-issue' ? 'jira' : 'incidentio';\n return `factory/${provider}-${identifier.toLowerCase()}`;\n }\n }\n if (item.source === 'gitlab-pr' && providerNumber !== undefined) {\n const uniqueSuffix = itemSuffix(item.id);\n if (uniqueSuffix) return `factory/gitlab-mr-${providerNumber}-${uniqueSuffix}`;\n }\n if (item.source === 'gitlab-issue' && typeof metadata.identifier === 'string') {\n const identifier = metadata.identifier\n .trim()\n .toLowerCase()\n .replace(/[^a-z0-9._-]+/g, '-');\n const uniqueSuffix = itemSuffix(item.id);\n if (identifier && uniqueSuffix) return `factory/gitlab-${identifier.slice(0, 60)}-${uniqueSuffix}`;\n }\n return `factory/item-${item.id}`;\n}\n\n/**\n * The branch a card's pull or merge request is reviewed on. A PR's own card gets\n * the same name {@link workItemBranch} gives it; an issue card reviewing a PR\n * attached to it gets a branch apart from its builder's issue branch, so the\n * reviewer and the builder never share a checkout.\n */\nexport function pullRequestBranch(input: { id: string; provider: 'github' | 'gitlab'; number: number }): string {\n const suffix = itemSuffix(input.id);\n if (input.provider === 'gitlab') {\n return suffix ? `factory/gitlab-mr-${input.number}-${suffix}` : `factory/item-${input.id}-mr-${input.number}`;\n }\n return suffix ? `factory/pr-${input.number}-${suffix}` : `factory/pr-${input.number}`;\n}\n\n/** The pre-suffix GitHub branch, for reusing sessions opened before card names were unique. */\nexport function legacyGithubWorkItemBranch(branch: string): string | undefined {\n const match = /^(factory\\/(?:issue|pr)-[1-9]\\d*)-[a-z0-9]{1,12}$/.exec(branch);\n return match?.[1];\n}\n\n/**\n * The pull request a `factory/pr-<number>-<item suffix>` branch was named after, the\n * inverse of {@link workItemBranch}. Branches from before the suffix (`factory/pr-<number>`)\n * still parse so existing checkouts can resolve their PR.\n */\nexport function pullRequestNumberFromBranch(branch: string): number | undefined {\n const match = /^factory\\/pr-([1-9]\\d*)(?:-[a-z0-9]{1,12})?$/.exec(branch);\n const number = match ? Number(match[1]) : undefined;\n return number !== undefined && Number.isSafeInteger(number) ? number : undefined;\n}\n\n/** The GitLab MR IID encoded in Factory's collision-resistant review branch. */\nexport function mergeRequestNumberFromBranch(branch: string): number | undefined {\n const match = /^factory\\/gitlab-mr-([1-9]\\d*)-[a-z0-9]{1,12}$/.exec(branch);\n const number = match ? Number(match[1]) : undefined;\n return number !== undefined && Number.isSafeInteger(number) ? number : undefined;\n}\n\n/** Whether a provider-reported branch name is safe to show an agent or pass to git. */\nexport function isSafeBranchName(value: string): boolean {\n return (\n /^[A-Za-z0-9][A-Za-z0-9._/@+-]*$/.test(value) &&\n !value.includes('..') &&\n !value.includes('//') &&\n !value.includes('@{') &&\n !value.endsWith('.') &&\n !value.endsWith('/') &&\n !value.endsWith('.lock')\n );\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"work-item-branch.js","names":[],"sources":["../src/work-item-branch.ts"],"sourcesContent":["import type { ExternalWorkItemSource } from './storage/domains/work-items/base.js';\n\n/**\n * Where a card came from, in the vocabulary branch naming reads. Server rows\n * map their `externalSource` into this with {@link workItemBranchSource}; the\n * board's own `WorkItem['source']` is already this union.\n */\nexport type WorkItemBranchSource =\n | 'github-issue'\n | 'github-pr'\n | 'gitlab-issue'\n | 'gitlab-pr'\n | 'linear-issue'\n | 'jira-issue'\n | 'incidentio-follow-up'\n | 'github-dependabot-alert'\n | 'vanta-vulnerability'\n | 'detail-finding'\n | 'slack-thread'\n | 'manual';\n\nexport interface WorkItemBranchInput {\n id: string;\n source: WorkItemBranchSource;\n metadata?: Record<string, unknown> | null;\n}\n\n/** Map a stored item's provenance onto the source vocabulary branch naming reads. */\nexport function workItemBranchSource(externalSource: ExternalWorkItemSource | null | undefined): WorkItemBranchSource {\n if (!externalSource) return 'manual';\n if (externalSource.integrationId === 'linear') return 'linear-issue';\n if (externalSource.integrationId === 'gitlab') {\n return externalSource.type === 'pull-request' ? 'gitlab-pr' : 'gitlab-issue';\n }\n if (externalSource.integrationId === 'jira') return 'jira-issue';\n if (externalSource.integrationId === 'incidentio') return 'incidentio-follow-up';\n // Only GitHub, GitLab, Linear, Jira, and incident.io carry provider identities; anything\n // else (a Slack thread, say) is a plain work item rather than a mislabeled GitHub issue.\n if (externalSource.integrationId === 'vanta') return 'vanta-vulnerability';\n if (externalSource.integrationId === 'detail') return 'detail-finding';\n if (externalSource.integrationId !== 'github') return 'manual';\n if (externalSource.type === 'dependabot-alert') return 'github-dependabot-alert';\n return externalSource.type === 'pull-request' ? 'github-pr' : 'github-issue';\n}\n\nfunction branchNumber(metadata: Record<string, unknown>, key: string): number | undefined {\n const value = metadata[key] ?? metadata.number;\n return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;\n}\n\n/** The provider number a GitHub card carries — the `#12` its runs and thread titles name it by. */\nexport function workItemNumber(item: Pick<WorkItemBranchInput, 'source' | 'metadata'>): number | undefined {\n const metadata = item.metadata ?? {};\n if (item.source === 'github-issue') return branchNumber(metadata, 'githubIssueNumber');\n if (item.source === 'github-pr') return branchNumber(metadata, 'githubPullRequestNumber');\n if (item.source === 'gitlab-issue') return branchNumber(metadata, 'gitlabIssueIid');\n if (item.source === 'gitlab-pr') return branchNumber(metadata, 'gitlabMergeRequestIid');\n return undefined;\n}\n\n/** How a card names its thread: a Linear title already opens with its identifier, a GitHub card gets its number here. */\nexport function workItemThreadTitle(\n item: Pick<WorkItemBranchInput, 'source' | 'metadata'> & { title: string },\n): string {\n const number = workItemNumber(item);\n if (number === undefined) return item.title;\n const kind = item.source === 'github-pr' ? 'PR' : item.source === 'gitlab-pr' ? 'MR' : 'Issue';\n return `${kind} #${number}: ${item.title}`;\n}\n\n/**\n * The last twelve alphanumerics of a work item id: the per-item suffix that keeps\n * provider numbers from colliding across the repositories of one factory. Issue\n * #13 exists in every repository, and a factory's sessions are unique per\n * user and branch across all of its repositories, so a branch named by the\n * number alone can only be held once per factory.\n */\nfunction itemSuffix(id: string): string {\n return id\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '')\n .slice(-12);\n}\n\n/**\n * The git branch an item's runs and sessions share, one grammar for both sides\n * of the wire: the dispatcher names autonomous run branches with it and the\n * board opens card sessions on it, so both converge on one checkout per item.\n * Provider numbers are only unique within a repository, so GitHub and GitLab\n * branches carry the item suffix as well. Cards without a provider identity\n * (manual, Slack) and cards whose metadata lost their identifier fall back to\n * the id-derived branch.\n */\nexport function workItemBranch(item: WorkItemBranchInput): string {\n const metadata = item.metadata ?? {};\n const providerNumber = workItemNumber(item);\n if (providerNumber !== undefined && (item.source === 'github-issue' || item.source === 'github-pr')) {\n const suffix = itemSuffix(item.id);\n const kind = item.source === 'github-issue' ? 'issue' : 'pr';\n return suffix ? `factory/${kind}-${providerNumber}-${suffix}` : `factory/${kind}-${providerNumber}`;\n }\n if (\n (item.source === 'linear-issue' || item.source === 'jira-issue' || item.source === 'incidentio-follow-up') &&\n typeof metadata.identifier === 'string'\n ) {\n const identifier = metadata.identifier.trim();\n if (identifier) {\n const provider = item.source === 'linear-issue' ? 'linear' : item.source === 'jira-issue' ? 'jira' : 'incidentio';\n return `factory/${provider}-${identifier.toLowerCase()}`;\n }\n }\n if (item.source === 'gitlab-pr' && providerNumber !== undefined) {\n const uniqueSuffix = itemSuffix(item.id);\n if (uniqueSuffix) return `factory/gitlab-mr-${providerNumber}-${uniqueSuffix}`;\n }\n if (item.source === 'gitlab-issue' && typeof metadata.identifier === 'string') {\n const identifier = metadata.identifier\n .trim()\n .toLowerCase()\n .replace(/[^a-z0-9._-]+/g, '-');\n const uniqueSuffix = itemSuffix(item.id);\n if (identifier && uniqueSuffix) return `factory/gitlab-${identifier.slice(0, 60)}-${uniqueSuffix}`;\n }\n return `factory/item-${item.id}`;\n}\n\n/**\n * The branch a card's pull or merge request is reviewed on. A PR's own card gets\n * the same name {@link workItemBranch} gives it; an issue card reviewing a PR\n * attached to it gets a branch apart from its builder's issue branch, so the\n * reviewer and the builder never share a checkout.\n */\nexport function pullRequestBranch(input: { id: string; provider: 'github' | 'gitlab'; number: number }): string {\n const suffix = itemSuffix(input.id);\n if (input.provider === 'gitlab') {\n return suffix ? `factory/gitlab-mr-${input.number}-${suffix}` : `factory/item-${input.id}-mr-${input.number}`;\n }\n return suffix ? `factory/pr-${input.number}-${suffix}` : `factory/pr-${input.number}`;\n}\n\n/** The pre-suffix GitHub branch, for reusing sessions opened before card names were unique. */\nexport function legacyGithubWorkItemBranch(branch: string): string | undefined {\n const match = /^(factory\\/(?:issue|pr)-[1-9]\\d*)-[a-z0-9]{1,12}$/.exec(branch);\n return match?.[1];\n}\n\n/**\n * The pull request a `factory/pr-<number>-<item suffix>` branch was named after, the\n * inverse of {@link workItemBranch}. Branches from before the suffix (`factory/pr-<number>`)\n * still parse so existing checkouts can resolve their PR.\n */\nexport function pullRequestNumberFromBranch(branch: string): number | undefined {\n const match = /^factory\\/pr-([1-9]\\d*)(?:-[a-z0-9]{1,12})?$/.exec(branch);\n const number = match ? Number(match[1]) : undefined;\n return number !== undefined && Number.isSafeInteger(number) ? number : undefined;\n}\n\n/** The GitLab MR IID encoded in Factory's collision-resistant review branch. */\nexport function mergeRequestNumberFromBranch(branch: string): number | undefined {\n const match = /^factory\\/gitlab-mr-([1-9]\\d*)-[a-z0-9]{1,12}$/.exec(branch);\n const number = match ? Number(match[1]) : undefined;\n return number !== undefined && Number.isSafeInteger(number) ? number : undefined;\n}\n\nexport const USER_BRANCH_PREFIX = 'user/';\nexport const USER_SESSION_BRANCH_PREFIX = `${USER_BRANCH_PREFIX}session-`;\n// Slack thread sessions live on `slack/<thread>` branches (integrations/slack/slack.ts threadBranch).\nexport const SLACK_SESSION_BRANCH_PREFIX = 'slack/';\n\nexport function isPersonSessionBranch(branch: string): boolean {\n return branch.startsWith(USER_BRANCH_PREFIX) || branch.startsWith(SLACK_SESSION_BRANCH_PREFIX);\n}\n\n/** Whether a provider-reported branch name is safe to show an agent or pass to git. */\nexport function isSafeBranchName(value: string): boolean {\n return (\n /^[A-Za-z0-9][A-Za-z0-9._/@+-]*$/.test(value) &&\n !value.includes('..') &&\n !value.includes('//') &&\n !value.includes('@{') &&\n !value.endsWith('.') &&\n !value.endsWith('/') &&\n !value.endsWith('.lock')\n );\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
interface SessionRef {
|
|
2
|
+
readonly sessionId: string;
|
|
3
|
+
readonly threadId: string;
|
|
4
|
+
}
|
|
5
|
+
interface ContextCard<Ref extends SessionRef> {
|
|
6
|
+
readonly sessions: Readonly<Record<string, Ref>>;
|
|
7
|
+
readonly stageHistory: readonly {
|
|
8
|
+
readonly stage: string;
|
|
9
|
+
}[];
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* The card's single conversation. A work item keeps one threadId for its whole
|
|
13
|
+
* lifecycle — every run reuses the worktree's thread — so the card title links
|
|
14
|
+
* to exactly one thread. Items filed while session scoping was broken may
|
|
15
|
+
* still carry divergent role refs; prefer the earliest lifecycle role because
|
|
16
|
+
* JSON object key order is not a stable record of which ref was filed first.
|
|
17
|
+
*/
|
|
18
|
+
export declare function itemThreadSession<Ref extends SessionRef>(sessions: Readonly<Record<string, Ref>>): Ref | undefined;
|
|
19
|
+
export interface ContextPhase {
|
|
20
|
+
readonly id: string;
|
|
21
|
+
readonly title: string;
|
|
22
|
+
readonly name?: string;
|
|
23
|
+
readonly context?: string;
|
|
24
|
+
readonly role?: string;
|
|
25
|
+
}
|
|
26
|
+
export interface CardContextSession<Ref extends SessionRef = SessionRef> {
|
|
27
|
+
context: string;
|
|
28
|
+
label: string;
|
|
29
|
+
ref: Ref;
|
|
30
|
+
/** The card's current phase runs in this context. */
|
|
31
|
+
current: boolean;
|
|
32
|
+
}
|
|
33
|
+
/** The session context a phase runs in; `role` is its deprecated name. */
|
|
34
|
+
export declare function phaseContext(phase: Pick<ContextPhase, 'context' | 'role'>): string | undefined;
|
|
35
|
+
/** A context named after its one phase, else by its well-known name, else by its key. */
|
|
36
|
+
export declare function contextLabel(context: string, phases: readonly ContextPhase[] | undefined): string;
|
|
37
|
+
/**
|
|
38
|
+
* Every session a card holds, one per context: the context its current phase
|
|
39
|
+
* runs in first, then the contexts of its most recently visited phases, then
|
|
40
|
+
* the rest. A session filed under two keys is listed once, under the first.
|
|
41
|
+
*/
|
|
42
|
+
export declare function cardContextSessions<Ref extends SessionRef>(item: ContextCard<Ref>, phases: readonly ContextPhase[] | undefined, columnStage: string): CardContextSession<Ref>[];
|
|
43
|
+
/**
|
|
44
|
+
* The session a card opens: its current phase's context, else the context of
|
|
45
|
+
* the phase it last visited. Without a board catalog, or when no visited phase
|
|
46
|
+
* holds a session, it keeps the lifecycle order of `itemThreadSession`.
|
|
47
|
+
*/
|
|
48
|
+
export declare function cardThreadSession<Ref extends SessionRef>(item: ContextCard<Ref>, phases: readonly ContextPhase[] | undefined, columnStage: string): Ref | undefined;
|
|
49
|
+
export {};
|
|
50
|
+
//# sourceMappingURL=card-context-sessions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"card-context-sessions.d.ts","sourceRoot":"","sources":["../../src/work-items/card-context-sessions.ts"],"names":[],"mappings":"AAAA,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,WAAW,CAAC,GAAG,SAAS,UAAU;IAC1C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,SAAS,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,SAAS,CAIlH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,GAAG,CAAC;IACT,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;CAClB;AAUD,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAE9F;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,GAAG,MAAM,CAIjG;AAiCD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,SAAS,UAAU,EACxD,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EACtB,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC3C,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAc3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,SAAS,UAAU,EACtD,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EACtB,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC3C,WAAW,EAAE,MAAM,GAClB,GAAG,GAAG,SAAS,CAGjB"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
// src/work-items/card-context-sessions.ts
|
|
2
|
+
/**
|
|
3
|
+
* The card's single conversation. A work item keeps one threadId for its whole
|
|
4
|
+
* lifecycle — every run reuses the worktree's thread — so the card title links
|
|
5
|
+
* to exactly one thread. Items filed while session scoping was broken may
|
|
6
|
+
* still carry divergent role refs; prefer the earliest lifecycle role because
|
|
7
|
+
* JSON object key order is not a stable record of which ref was filed first.
|
|
8
|
+
*/
|
|
9
|
+
function itemThreadSession(sessions) {
|
|
10
|
+
return sessions.triage ?? sessions.plan ?? sessions.work ?? sessions.review ?? sessions.chat ?? Object.values(sessions)[0];
|
|
11
|
+
}
|
|
12
|
+
const CONTEXT_LABELS = {
|
|
13
|
+
triage: "Triage",
|
|
14
|
+
work: "Work",
|
|
15
|
+
review: "Review",
|
|
16
|
+
plan: "Planning",
|
|
17
|
+
chat: "Chat"
|
|
18
|
+
};
|
|
19
|
+
/** The session context a phase runs in; `role` is its deprecated name. */
|
|
20
|
+
function phaseContext(phase) {
|
|
21
|
+
return phase.context ?? phase.role;
|
|
22
|
+
}
|
|
23
|
+
/** A context named after its one phase, else by its well-known name, else by its key. */
|
|
24
|
+
function contextLabel(context, phases) {
|
|
25
|
+
const [only, ...others] = phases?.filter((phase) => phaseContext(phase) === context) ?? [];
|
|
26
|
+
if (only && others.length === 0) return only.name ?? only.title;
|
|
27
|
+
return CONTEXT_LABELS[context] ?? context.charAt(0).toUpperCase() + context.slice(1);
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* The session a card holds in a context. Cards planned before Planning moved
|
|
31
|
+
* into `work` hold their planner under the old `plan` key, which stands in for
|
|
32
|
+
* `work` until the card gets a `work` session, unless a phase runs in `plan`.
|
|
33
|
+
*/
|
|
34
|
+
function contextSession(item, phases, context) {
|
|
35
|
+
const legacyPlanner = context === "work" && !phases.some((phase) => phaseContext(phase) === "plan");
|
|
36
|
+
return item.sessions[context] ?? (legacyPlanner ? item.sessions.plan : void 0);
|
|
37
|
+
}
|
|
38
|
+
/** Contexts holding a session, by the card's current phase first, then its most recently visited phases. */
|
|
39
|
+
function visitedContexts(item, phases, columnStage) {
|
|
40
|
+
const contexts = [];
|
|
41
|
+
for (const stage of [columnStage, ...item.stageHistory.map((entry) => entry.stage).reverse()]) {
|
|
42
|
+
const phase = phases.find((candidate) => candidate.id === stage);
|
|
43
|
+
const context = phase && phaseContext(phase);
|
|
44
|
+
if (context !== void 0 && contextSession(item, phases, context) && !contexts.includes(context)) contexts.push(context);
|
|
45
|
+
}
|
|
46
|
+
return contexts;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Every session a card holds, one per context: the context its current phase
|
|
50
|
+
* runs in first, then the contexts of its most recently visited phases, then
|
|
51
|
+
* the rest. A session filed under two keys is listed once, under the first.
|
|
52
|
+
*/
|
|
53
|
+
function cardContextSessions(item, phases, columnStage) {
|
|
54
|
+
const currentPhase = phases?.find((phase) => phase.id === columnStage);
|
|
55
|
+
const currentContext = currentPhase && phaseContext(currentPhase);
|
|
56
|
+
const visited = phases ? visitedContexts(item, phases, columnStage) : [];
|
|
57
|
+
const order = [.../* @__PURE__ */ new Set([...visited, ...Object.keys(item.sessions)])];
|
|
58
|
+
const seen = /* @__PURE__ */ new Set();
|
|
59
|
+
return order.flatMap((context) => {
|
|
60
|
+
const ref = (phases && contextSession(item, phases, context)) ?? item.sessions[context];
|
|
61
|
+
if (!ref) return [];
|
|
62
|
+
const key = `${ref.sessionId}:${ref.threadId}`;
|
|
63
|
+
if (seen.has(key)) return [];
|
|
64
|
+
seen.add(key);
|
|
65
|
+
return [{
|
|
66
|
+
context,
|
|
67
|
+
label: contextLabel(context, phases),
|
|
68
|
+
ref,
|
|
69
|
+
current: context === currentContext
|
|
70
|
+
}];
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* The session a card opens: its current phase's context, else the context of
|
|
75
|
+
* the phase it last visited. Without a board catalog, or when no visited phase
|
|
76
|
+
* holds a session, it keeps the lifecycle order of `itemThreadSession`.
|
|
77
|
+
*/
|
|
78
|
+
function cardThreadSession(item, phases, columnStage) {
|
|
79
|
+
const context = phases ? visitedContexts(item, phases, columnStage)[0] : void 0;
|
|
80
|
+
return phases && context !== void 0 ? contextSession(item, phases, context) : itemThreadSession(item.sessions);
|
|
81
|
+
}
|
|
82
|
+
export { cardContextSessions, cardThreadSession, contextLabel, itemThreadSession, phaseContext };
|
|
83
|
+
|
|
84
|
+
//# sourceMappingURL=card-context-sessions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"card-context-sessions.js","names":[],"sources":["../../src/work-items/card-context-sessions.ts"],"sourcesContent":["interface SessionRef {\n readonly sessionId: string;\n readonly threadId: string;\n}\n\ninterface ContextCard<Ref extends SessionRef> {\n readonly sessions: Readonly<Record<string, Ref>>;\n readonly stageHistory: readonly { readonly stage: string }[];\n}\n\n/**\n * The card's single conversation. A work item keeps one threadId for its whole\n * lifecycle — every run reuses the worktree's thread — so the card title links\n * to exactly one thread. Items filed while session scoping was broken may\n * still carry divergent role refs; prefer the earliest lifecycle role because\n * JSON object key order is not a stable record of which ref was filed first.\n */\nexport function itemThreadSession<Ref extends SessionRef>(sessions: Readonly<Record<string, Ref>>): Ref | undefined {\n return (\n sessions.triage ?? sessions.plan ?? sessions.work ?? sessions.review ?? sessions.chat ?? Object.values(sessions)[0]\n );\n}\n\nexport interface ContextPhase {\n readonly id: string;\n readonly title: string;\n readonly name?: string;\n readonly context?: string;\n readonly role?: string;\n}\n\nexport interface CardContextSession<Ref extends SessionRef = SessionRef> {\n context: string;\n label: string;\n ref: Ref;\n /** The card's current phase runs in this context. */\n current: boolean;\n}\n\nconst CONTEXT_LABELS: Record<string, string> = {\n triage: 'Triage',\n work: 'Work',\n review: 'Review',\n plan: 'Planning',\n chat: 'Chat',\n};\n\n/** The session context a phase runs in; `role` is its deprecated name. */\nexport function phaseContext(phase: Pick<ContextPhase, 'context' | 'role'>): string | undefined {\n return phase.context ?? phase.role;\n}\n\n/** A context named after its one phase, else by its well-known name, else by its key. */\nexport function contextLabel(context: string, phases: readonly ContextPhase[] | undefined): string {\n const [only, ...others] = phases?.filter(phase => phaseContext(phase) === context) ?? [];\n if (only && others.length === 0) return only.name ?? only.title;\n return CONTEXT_LABELS[context] ?? context.charAt(0).toUpperCase() + context.slice(1);\n}\n\n/**\n * The session a card holds in a context. Cards planned before Planning moved\n * into `work` hold their planner under the old `plan` key, which stands in for\n * `work` until the card gets a `work` session, unless a phase runs in `plan`.\n */\nfunction contextSession<Ref extends SessionRef>(\n item: Pick<ContextCard<Ref>, 'sessions'>,\n phases: readonly ContextPhase[],\n context: string,\n): Ref | undefined {\n const legacyPlanner = context === 'work' && !phases.some(phase => phaseContext(phase) === 'plan');\n return item.sessions[context] ?? (legacyPlanner ? item.sessions.plan : undefined);\n}\n\n/** Contexts holding a session, by the card's current phase first, then its most recently visited phases. */\nfunction visitedContexts<Ref extends SessionRef>(\n item: ContextCard<Ref>,\n phases: readonly ContextPhase[],\n columnStage: string,\n): string[] {\n const contexts: string[] = [];\n for (const stage of [columnStage, ...item.stageHistory.map(entry => entry.stage).reverse()]) {\n const phase = phases.find(candidate => candidate.id === stage);\n const context = phase && phaseContext(phase);\n if (context !== undefined && contextSession(item, phases, context) && !contexts.includes(context)) {\n contexts.push(context);\n }\n }\n return contexts;\n}\n\n/**\n * Every session a card holds, one per context: the context its current phase\n * runs in first, then the contexts of its most recently visited phases, then\n * the rest. A session filed under two keys is listed once, under the first.\n */\nexport function cardContextSessions<Ref extends SessionRef>(\n item: ContextCard<Ref>,\n phases: readonly ContextPhase[] | undefined,\n columnStage: string,\n): CardContextSession<Ref>[] {\n const currentPhase = phases?.find(phase => phase.id === columnStage);\n const currentContext = currentPhase && phaseContext(currentPhase);\n const visited = phases ? visitedContexts(item, phases, columnStage) : [];\n const order = [...new Set([...visited, ...Object.keys(item.sessions)])];\n const seen = new Set<string>();\n return order.flatMap(context => {\n const ref = (phases && contextSession(item, phases, context)) ?? item.sessions[context];\n if (!ref) return [];\n const key = `${ref.sessionId}:${ref.threadId}`;\n if (seen.has(key)) return [];\n seen.add(key);\n return [{ context, label: contextLabel(context, phases), ref, current: context === currentContext }];\n });\n}\n\n/**\n * The session a card opens: its current phase's context, else the context of\n * the phase it last visited. Without a board catalog, or when no visited phase\n * holds a session, it keeps the lifecycle order of `itemThreadSession`.\n */\nexport function cardThreadSession<Ref extends SessionRef>(\n item: ContextCard<Ref>,\n phases: readonly ContextPhase[] | undefined,\n columnStage: string,\n): Ref | undefined {\n const context = phases ? visitedContexts(item, phases, columnStage)[0] : undefined;\n return phases && context !== undefined ? contextSession(item, phases, context) : itemThreadSession(item.sessions);\n}\n"],"mappings":";;;;;;;;AAiBA,SAAgB,kBAA0C,UAA0D;CAClH,OACE,SAAS,UAAU,SAAS,QAAQ,SAAS,QAAQ,SAAS,UAAU,SAAS,QAAQ,OAAO,OAAO,QAAQ,CAAC,CAAC;AAErH;AAkBA,MAAM,iBAAyC;CAC7C,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,MAAM;CACN,MAAM;AACR;;AAGA,SAAgB,aAAa,OAAmE;CAC9F,OAAO,MAAM,WAAW,MAAM;AAChC;;AAGA,SAAgB,aAAa,SAAiB,QAAqD;CACjG,MAAM,CAAC,MAAM,GAAG,UAAU,QAAQ,QAAO,UAAS,aAAa,KAAK,MAAM,OAAO,KAAK,CAAC;CACvF,IAAI,QAAQ,OAAO,WAAW,GAAG,OAAO,KAAK,QAAQ,KAAK;CAC1D,OAAO,eAAe,YAAY,QAAQ,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,QAAQ,MAAM,CAAC;AACrF;;;;;;AAOA,SAAS,eACP,MACA,QACA,SACiB;CACjB,MAAM,gBAAgB,YAAY,UAAU,CAAC,OAAO,MAAK,UAAS,aAAa,KAAK,MAAM,MAAM;CAChG,OAAO,KAAK,SAAS,aAAa,gBAAgB,KAAK,SAAS,OAAO,KAAA;AACzE;;AAGA,SAAS,gBACP,MACA,QACA,aACU;CACV,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,SAAS,CAAC,aAAa,GAAG,KAAK,aAAa,KAAI,UAAS,MAAM,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG;EAC3F,MAAM,QAAQ,OAAO,MAAK,cAAa,UAAU,OAAO,KAAK;EAC7D,MAAM,UAAU,SAAS,aAAa,KAAK;EAC3C,IAAI,YAAY,KAAA,KAAa,eAAe,MAAM,QAAQ,OAAO,KAAK,CAAC,SAAS,SAAS,OAAO,GAC9F,SAAS,KAAK,OAAO;CAEzB;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,oBACd,MACA,QACA,aAC2B;CAC3B,MAAM,eAAe,QAAQ,MAAK,UAAS,MAAM,OAAO,WAAW;CACnE,MAAM,iBAAiB,gBAAgB,aAAa,YAAY;CAChE,MAAM,UAAU,SAAS,gBAAgB,MAAM,QAAQ,WAAW,IAAI,CAAC;CACvE,MAAM,QAAQ,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC;CACtE,MAAM,uBAAO,IAAI,IAAY;CAC7B,OAAO,MAAM,SAAQ,YAAW;EAC9B,MAAM,OAAO,UAAU,eAAe,MAAM,QAAQ,OAAO,MAAM,KAAK,SAAS;EAC/E,IAAI,CAAC,KAAK,OAAO,CAAC;EAClB,MAAM,MAAM,GAAG,IAAI,UAAU,GAAG,IAAI;EACpC,IAAI,KAAK,IAAI,GAAG,GAAG,OAAO,CAAC;EAC3B,KAAK,IAAI,GAAG;EACZ,OAAO,CAAC;GAAE;GAAS,OAAO,aAAa,SAAS,MAAM;GAAG;GAAK,SAAS,YAAY;EAAe,CAAC;CACrG,CAAC;AACH;;;;;;AAOA,SAAgB,kBACd,MACA,QACA,aACiB;CACjB,MAAM,UAAU,SAAS,gBAAgB,MAAM,QAAQ,WAAW,CAAC,CAAC,KAAK,KAAA;CACzE,OAAO,UAAU,YAAY,KAAA,IAAY,eAAe,MAAM,QAAQ,OAAO,IAAI,kBAAkB,KAAK,QAAQ;AAClH"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { WorkItemSourceRow } from '../storage/domains/work-items/work-item-schema.js';
|
|
2
|
+
/** The source key a link or shorthand names, or null when it names no issue or pull request. */
|
|
3
|
+
export declare function sourceKeyFromReference(reference: string): string | null;
|
|
4
|
+
/** Whether `reference` is a link or shorthand a card can be found by: a source key, or any other http(s) link. */
|
|
5
|
+
export declare function isSourceReference(reference: string): boolean;
|
|
6
|
+
type SourcedCard = {
|
|
7
|
+
workItem: {
|
|
8
|
+
sources?: readonly Pick<WorkItemSourceRow, 'key' | 'url'>[];
|
|
9
|
+
};
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Whether `source` is the issue or pull request `reference` names: by source key, which ignores
|
|
13
|
+
* the rest of a link (`/files`, a comment anchor), or for other links by the link itself.
|
|
14
|
+
*/
|
|
15
|
+
export declare function sourceMatchesReference(source: Pick<WorkItemSourceRow, 'key' | 'url'>, reference: string): boolean;
|
|
16
|
+
/** The card's own issue or pull request (its first source) is the one `reference` names. */
|
|
17
|
+
export declare function isCardFor(card: SourcedCard, reference: string): boolean;
|
|
18
|
+
/** The card carries the issue or pull request `reference` names, as its own source or an attached one. */
|
|
19
|
+
export declare function cardCarries(card: SourcedCard, reference: string): boolean;
|
|
20
|
+
export {};
|
|
21
|
+
//# sourceMappingURL=card-reference.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"card-reference.d.ts","sourceRoot":"","sources":["../../src/work-items/card-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAkB3F,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYvE;AAED,kHAAkH;AAClH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAUD,KAAK,WAAW,GAAG;IAAE,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,SAAS,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,KAAK,CAAC,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjG;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIjH;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzE"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
// src/work-items/card-reference.ts
|
|
2
|
+
/**
|
|
3
|
+
* What people paste to name an issue or pull request, turned into the key its card's source
|
|
4
|
+
* stores (see the provider adapters in `./providers`): `owner/repo#12` for a GitHub issue or pull
|
|
5
|
+
* request, `group/project#3` and `group/project!7` for a GitLab issue and merge request, and the
|
|
6
|
+
* tracker identifier (`ENG-42`) for Linear, Jira and incident.io.
|
|
7
|
+
*/
|
|
8
|
+
const GITLAB_MERGE_REQUEST_URL = /^https?:\/\/[^/\s]+\/(.+?)\/-\/merge_requests\/(\d+)(?:[/?#]|$)/i;
|
|
9
|
+
const GITLAB_ISSUE_URL = /^https?:\/\/[^/\s]+\/(.+?)\/-\/(?:issues|work_items)\/(\d+)(?:[/?#]|$)/i;
|
|
10
|
+
const GITHUB_URL = /^https?:\/\/[^/\s]+\/([^/\s]+\/[^/\s]+)\/(?:issues|pull)\/(\d+)(?:[/?#]|$)/i;
|
|
11
|
+
/** Linear (`/<workspace>/issue/ENG-42/<slug>`) and Jira (`/browse/OPS-3`) issue links. */
|
|
12
|
+
const TRACKER_URL = /^https?:\/\/[^/\s]+\/(?:[^\s]*\/)?(?:issue|browse)\/([a-z][a-z0-9]*-\d+)(?:[/?#]|$)/i;
|
|
13
|
+
/** `owner/repo#12`, `group/sub/project!7`. */
|
|
14
|
+
const REPOSITORY_SHORTHAND = /^[\w.-]+(?:\/[\w.-]+)+[#!]\d+$/;
|
|
15
|
+
const TRACKER_IDENTIFIER = /^[a-z][a-z0-9]*-\d+$/i;
|
|
16
|
+
const URL = /^https?:\/\/\S+$/i;
|
|
17
|
+
/** The source key a link or shorthand names, or null when it names no issue or pull request. */
|
|
18
|
+
function sourceKeyFromReference(reference) {
|
|
19
|
+
const ref = reference.trim();
|
|
20
|
+
const mergeRequest = GITLAB_MERGE_REQUEST_URL.exec(ref);
|
|
21
|
+
if (mergeRequest) return `${mergeRequest[1]}!${mergeRequest[2]}`;
|
|
22
|
+
const gitlabIssue = GITLAB_ISSUE_URL.exec(ref);
|
|
23
|
+
if (gitlabIssue) return `${gitlabIssue[1]}#${gitlabIssue[2]}`;
|
|
24
|
+
const github = GITHUB_URL.exec(ref);
|
|
25
|
+
if (github) return `${github[1]}#${github[2]}`;
|
|
26
|
+
const tracker = TRACKER_URL.exec(ref);
|
|
27
|
+
if (tracker) return tracker[1];
|
|
28
|
+
if (REPOSITORY_SHORTHAND.test(ref) || TRACKER_IDENTIFIER.test(ref)) return ref;
|
|
29
|
+
return null;
|
|
30
|
+
}
|
|
31
|
+
/** Whether `reference` is a link or shorthand a card can be found by: a source key, or any other http(s) link. */
|
|
32
|
+
function isSourceReference(reference) {
|
|
33
|
+
return sourceKeyFromReference(reference) !== null || URL.test(reference.trim());
|
|
34
|
+
}
|
|
35
|
+
function normalizedUrl(url) {
|
|
36
|
+
return url.trim().replace(/[?#].*$/, "").replace(/\/+$/, "").toLowerCase();
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Whether `source` is the issue or pull request `reference` names: by source key, which ignores
|
|
40
|
+
* the rest of a link (`/files`, a comment anchor), or for other links by the link itself.
|
|
41
|
+
*/
|
|
42
|
+
function sourceMatchesReference(source, reference) {
|
|
43
|
+
const key = sourceKeyFromReference(reference);
|
|
44
|
+
if (key !== null) return source.key !== null && source.key.toLowerCase() === key.toLowerCase();
|
|
45
|
+
return URL.test(reference.trim()) && source.url !== null && normalizedUrl(source.url) === normalizedUrl(reference);
|
|
46
|
+
}
|
|
47
|
+
/** The card's own issue or pull request (its first source) is the one `reference` names. */
|
|
48
|
+
function isCardFor(card, reference) {
|
|
49
|
+
const own = card.workItem.sources?.[0];
|
|
50
|
+
return own !== void 0 && sourceMatchesReference(own, reference);
|
|
51
|
+
}
|
|
52
|
+
/** The card carries the issue or pull request `reference` names, as its own source or an attached one. */
|
|
53
|
+
function cardCarries(card, reference) {
|
|
54
|
+
return (card.workItem.sources ?? []).some((source) => sourceMatchesReference(source, reference));
|
|
55
|
+
}
|
|
56
|
+
export { cardCarries, isCardFor, isSourceReference, sourceKeyFromReference, sourceMatchesReference };
|
|
57
|
+
|
|
58
|
+
//# sourceMappingURL=card-reference.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"card-reference.js","names":[],"sources":["../../src/work-items/card-reference.ts"],"sourcesContent":["import type { WorkItemSourceRow } from '../storage/domains/work-items/work-item-schema.js';\n\n/**\n * What people paste to name an issue or pull request, turned into the key its card's source\n * stores (see the provider adapters in `./providers`): `owner/repo#12` for a GitHub issue or pull\n * request, `group/project#3` and `group/project!7` for a GitLab issue and merge request, and the\n * tracker identifier (`ENG-42`) for Linear, Jira and incident.io.\n */\nconst GITLAB_MERGE_REQUEST_URL = /^https?:\\/\\/[^/\\s]+\\/(.+?)\\/-\\/merge_requests\\/(\\d+)(?:[/?#]|$)/i;\nconst GITLAB_ISSUE_URL = /^https?:\\/\\/[^/\\s]+\\/(.+?)\\/-\\/(?:issues|work_items)\\/(\\d+)(?:[/?#]|$)/i;\nconst GITHUB_URL = /^https?:\\/\\/[^/\\s]+\\/([^/\\s]+\\/[^/\\s]+)\\/(?:issues|pull)\\/(\\d+)(?:[/?#]|$)/i;\n/** Linear (`/<workspace>/issue/ENG-42/<slug>`) and Jira (`/browse/OPS-3`) issue links. */\nconst TRACKER_URL = /^https?:\\/\\/[^/\\s]+\\/(?:[^\\s]*\\/)?(?:issue|browse)\\/([a-z][a-z0-9]*-\\d+)(?:[/?#]|$)/i;\n/** `owner/repo#12`, `group/sub/project!7`. */\nconst REPOSITORY_SHORTHAND = /^[\\w.-]+(?:\\/[\\w.-]+)+[#!]\\d+$/;\nconst TRACKER_IDENTIFIER = /^[a-z][a-z0-9]*-\\d+$/i;\nconst URL = /^https?:\\/\\/\\S+$/i;\n\n/** The source key a link or shorthand names, or null when it names no issue or pull request. */\nexport function sourceKeyFromReference(reference: string): string | null {\n const ref = reference.trim();\n const mergeRequest = GITLAB_MERGE_REQUEST_URL.exec(ref);\n if (mergeRequest) return `${mergeRequest[1]}!${mergeRequest[2]}`;\n const gitlabIssue = GITLAB_ISSUE_URL.exec(ref);\n if (gitlabIssue) return `${gitlabIssue[1]}#${gitlabIssue[2]}`;\n const github = GITHUB_URL.exec(ref);\n if (github) return `${github[1]}#${github[2]}`;\n const tracker = TRACKER_URL.exec(ref);\n if (tracker) return tracker[1]!;\n if (REPOSITORY_SHORTHAND.test(ref) || TRACKER_IDENTIFIER.test(ref)) return ref;\n return null;\n}\n\n/** Whether `reference` is a link or shorthand a card can be found by: a source key, or any other http(s) link. */\nexport function isSourceReference(reference: string): boolean {\n return sourceKeyFromReference(reference) !== null || URL.test(reference.trim());\n}\n\nfunction normalizedUrl(url: string): string {\n return url\n .trim()\n .replace(/[?#].*$/, '')\n .replace(/\\/+$/, '')\n .toLowerCase();\n}\n\ntype SourcedCard = { workItem: { sources?: readonly Pick<WorkItemSourceRow, 'key' | 'url'>[] } };\n\n/**\n * Whether `source` is the issue or pull request `reference` names: by source key, which ignores\n * the rest of a link (`/files`, a comment anchor), or for other links by the link itself.\n */\nexport function sourceMatchesReference(source: Pick<WorkItemSourceRow, 'key' | 'url'>, reference: string): boolean {\n const key = sourceKeyFromReference(reference);\n if (key !== null) return source.key !== null && source.key.toLowerCase() === key.toLowerCase();\n return URL.test(reference.trim()) && source.url !== null && normalizedUrl(source.url) === normalizedUrl(reference);\n}\n\n/** The card's own issue or pull request (its first source) is the one `reference` names. */\nexport function isCardFor(card: SourcedCard, reference: string): boolean {\n const own = card.workItem.sources?.[0];\n return own !== undefined && sourceMatchesReference(own, reference);\n}\n\n/** The card carries the issue or pull request `reference` names, as its own source or an attached one. */\nexport function cardCarries(card: SourcedCard, reference: string): boolean {\n return (card.workItem.sources ?? []).some(source => sourceMatchesReference(source, reference));\n}\n"],"mappings":";;;;;;;AAQA,MAAM,2BAA2B;AACjC,MAAM,mBAAmB;AACzB,MAAM,aAAa;;AAEnB,MAAM,cAAc;;AAEpB,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB;AAC3B,MAAM,MAAM;;AAGZ,SAAgB,uBAAuB,WAAkC;CACvE,MAAM,MAAM,UAAU,KAAK;CAC3B,MAAM,eAAe,yBAAyB,KAAK,GAAG;CACtD,IAAI,cAAc,OAAO,GAAG,aAAa,GAAG,GAAG,aAAa;CAC5D,MAAM,cAAc,iBAAiB,KAAK,GAAG;CAC7C,IAAI,aAAa,OAAO,GAAG,YAAY,GAAG,GAAG,YAAY;CACzD,MAAM,SAAS,WAAW,KAAK,GAAG;CAClC,IAAI,QAAQ,OAAO,GAAG,OAAO,GAAG,GAAG,OAAO;CAC1C,MAAM,UAAU,YAAY,KAAK,GAAG;CACpC,IAAI,SAAS,OAAO,QAAQ;CAC5B,IAAI,qBAAqB,KAAK,GAAG,KAAK,mBAAmB,KAAK,GAAG,GAAG,OAAO;CAC3E,OAAO;AACT;;AAGA,SAAgB,kBAAkB,WAA4B;CAC5D,OAAO,uBAAuB,SAAS,MAAM,QAAQ,IAAI,KAAK,UAAU,KAAK,CAAC;AAChF;AAEA,SAAS,cAAc,KAAqB;CAC1C,OAAO,IACJ,KAAK,CAAC,CACN,QAAQ,WAAW,EAAE,CAAC,CACtB,QAAQ,QAAQ,EAAE,CAAC,CACnB,YAAY;AACjB;;;;;AAQA,SAAgB,uBAAuB,QAAgD,WAA4B;CACjH,MAAM,MAAM,uBAAuB,SAAS;CAC5C,IAAI,QAAQ,MAAM,OAAO,OAAO,QAAQ,QAAQ,OAAO,IAAI,YAAY,MAAM,IAAI,YAAY;CAC7F,OAAO,IAAI,KAAK,UAAU,KAAK,CAAC,KAAK,OAAO,QAAQ,QAAQ,cAAc,OAAO,GAAG,MAAM,cAAc,SAAS;AACnH;;AAGA,SAAgB,UAAU,MAAmB,WAA4B;CACvE,MAAM,MAAM,KAAK,SAAS,UAAU;CACpC,OAAO,QAAQ,KAAA,KAAa,uBAAuB,KAAK,SAAS;AACnE;;AAGA,SAAgB,YAAY,MAAmB,WAA4B;CACzE,QAAQ,KAAK,SAAS,WAAW,CAAC,EAAA,CAAG,MAAK,WAAU,uBAAuB,QAAQ,SAAS,CAAC;AAC/F"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import type { WorkItemSourceRow } from '../storage/domains/work-items/work-item-schema.js';
|
|
2
|
+
export interface SourcedItem {
|
|
3
|
+
readonly workItem?: {
|
|
4
|
+
readonly sources?: readonly WorkItemSourceRow[];
|
|
5
|
+
} | null;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* A card whose own primary source is a pull or merge request: an outside contributor's
|
|
9
|
+
* PR filed on its own card, or a PR card filed before PRs attached to their issue's card.
|
|
10
|
+
* An issue card with an attached PR is not one; see `hasPullRequest`.
|
|
11
|
+
*/
|
|
12
|
+
export declare function isPullRequestCard(item: {
|
|
13
|
+
readonly source: string;
|
|
14
|
+
}): boolean;
|
|
15
|
+
/** Every pull or merge request source on a card, oldest first. */
|
|
16
|
+
export declare function pullRequestSources(item: SourcedItem): WorkItemSourceRow[];
|
|
17
|
+
/** The provider number (GitHub PR number, GitLab MR IID) a pull request source names. */
|
|
18
|
+
export declare function pullRequestSourceNumber(source: Pick<WorkItemSourceRow, 'metadata'>): number | undefined;
|
|
19
|
+
export declare function isOpenPullRequestSource(source: Pick<WorkItemSourceRow, 'state' | 'metadata'>): boolean;
|
|
20
|
+
/**
|
|
21
|
+
* Card metadata listing the attached pull requests whose author had no write access, as
|
|
22
|
+
* `<provider>:<externalId>`. Before any author's pull request could join a card only trusted
|
|
23
|
+
* ones did, so a source missing from the list is trusted.
|
|
24
|
+
*/
|
|
25
|
+
export declare const UNTRUSTED_PULL_REQUESTS_KEY = "untrustedPullRequests";
|
|
26
|
+
/** The key {@link UNTRUSTED_PULL_REQUESTS_KEY} lists a source under. */
|
|
27
|
+
export declare function pullRequestTrustKey(source: Pick<WorkItemSourceRow, 'provider' | 'externalId'>): string;
|
|
28
|
+
/** Whether a pull request attached to the card was opened by someone with write access (or by Factory). */
|
|
29
|
+
export declare function trustedPullRequestSource(item: {
|
|
30
|
+
readonly metadata?: Record<string, unknown> | null;
|
|
31
|
+
}, source: Pick<WorkItemSourceRow, 'provider' | 'externalId'>): boolean;
|
|
32
|
+
/**
|
|
33
|
+
* The card's working pull request, the one its review passes and status checks follow: the one
|
|
34
|
+
* `openPullRequestNumber` names (its session's own, or the one a person picked), unless it closed
|
|
35
|
+
* without merging; else the first trusted open one linked, else the first trusted merged one. An
|
|
36
|
+
* outsider's pull request is never picked on its own. `except` leaves one pull request out.
|
|
37
|
+
*/
|
|
38
|
+
export declare function workingPullRequest(item: SourcedItem & {
|
|
39
|
+
readonly metadata?: Record<string, unknown> | null;
|
|
40
|
+
}, except?: number): WorkItemSourceRow | undefined;
|
|
41
|
+
/**
|
|
42
|
+
* The pull request `openPullRequestNumber` names, unless it is one linked to the card that closed
|
|
43
|
+
* without merging: the card then works on its {@link workingPullRequest} instead. A pointer to a
|
|
44
|
+
* pull request the card has no source for (its session opened it) stands.
|
|
45
|
+
*/
|
|
46
|
+
export declare function pointedPullRequest(item: SourcedItem & {
|
|
47
|
+
readonly metadata?: Record<string, unknown> | null;
|
|
48
|
+
}): number | undefined;
|
|
49
|
+
/** The pull request a PR review pass on this card reviews: its {@link workingPullRequest}. */
|
|
50
|
+
export declare function reviewedPullRequest(item: SourcedItem & {
|
|
51
|
+
readonly metadata?: Record<string, unknown> | null;
|
|
52
|
+
}): WorkItemSourceRow | undefined;
|
|
53
|
+
export declare const PULL_REQUEST_STATUSES: readonly ['draft', 'open', 'closed', 'merged'];
|
|
54
|
+
export type PullRequestStatus = (typeof PULL_REQUEST_STATUSES)[number];
|
|
55
|
+
export interface CardChangeRequest {
|
|
56
|
+
url?: string;
|
|
57
|
+
provider: 'github' | 'gitlab';
|
|
58
|
+
number?: number;
|
|
59
|
+
/** Undefined while the code host has reported no state. */
|
|
60
|
+
status?: PullRequestStatus;
|
|
61
|
+
draft: boolean;
|
|
62
|
+
/** Epoch milliseconds of the code host's last report. */
|
|
63
|
+
syncedAt?: number;
|
|
64
|
+
}
|
|
65
|
+
interface ChangeRequestCard {
|
|
66
|
+
readonly source: string;
|
|
67
|
+
readonly url?: string | null;
|
|
68
|
+
readonly metadata?: Record<string, unknown> | null;
|
|
69
|
+
readonly workItem?: {
|
|
70
|
+
readonly provider?: string;
|
|
71
|
+
readonly state?: string | null;
|
|
72
|
+
readonly metadata?: Record<string, unknown> | null;
|
|
73
|
+
readonly sources?: readonly WorkItemSourceRow[];
|
|
74
|
+
} | null;
|
|
75
|
+
}
|
|
76
|
+
export declare function isSettledChangeRequest(status: PullRequestStatus | undefined): boolean;
|
|
77
|
+
export declare function changeRequestNumber(source: string, metadata: Record<string, unknown>): number | undefined;
|
|
78
|
+
/** Every pull or merge request a card carries, oldest first. */
|
|
79
|
+
export declare function cardChangeRequests(card: ChangeRequestCard): CardChangeRequest[];
|
|
80
|
+
/**
|
|
81
|
+
* The card's own pull request, else the attached one to show on it: the one `openPullRequestNumber`
|
|
82
|
+
* names, else the newest open one, else the newest one. Unlike {@link reviewedPullRequest} it shows
|
|
83
|
+
* a closed or an outsider's pull request, since showing one starts no work on it.
|
|
84
|
+
*/
|
|
85
|
+
export declare function cardChangeRequest(card: ChangeRequestCard): CardChangeRequest | undefined;
|
|
86
|
+
export {};
|
|
87
|
+
//# sourceMappingURL=change-requests.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"change-requests.d.ts","sourceRoot":"","sources":["../../src/work-items/change-requests.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
// src/work-items/change-requests.ts
|
|
2
|
+
/**
|
|
3
|
+
* A card whose own primary source is a pull or merge request: an outside contributor's
|
|
4
|
+
* PR filed on its own card, or a PR card filed before PRs attached to their issue's card.
|
|
5
|
+
* An issue card with an attached PR is not one; see `hasPullRequest`.
|
|
6
|
+
*/
|
|
7
|
+
function isPullRequestCard(item) {
|
|
8
|
+
return item.source === "github-pr" || item.source === "gitlab-pr";
|
|
9
|
+
}
|
|
10
|
+
/** Every pull or merge request source on a card, oldest first. */
|
|
11
|
+
function pullRequestSources(item) {
|
|
12
|
+
return (item.workItem?.sources ?? []).filter((source) => source.sourceType === "pull-request");
|
|
13
|
+
}
|
|
14
|
+
/** The provider number (GitHub PR number, GitLab MR IID) a pull request source names. */
|
|
15
|
+
function pullRequestSourceNumber(source) {
|
|
16
|
+
const metadata = source.metadata ?? {};
|
|
17
|
+
const value = metadata.githubPullRequestNumber ?? metadata.gitlabMergeRequestIid ?? metadata.number;
|
|
18
|
+
return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
|
|
19
|
+
}
|
|
20
|
+
function isOpenPullRequestSource(source) {
|
|
21
|
+
return !isSettledChangeRequest(reportedStatus(source.state, source.metadata ?? {}));
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Card metadata listing the attached pull requests whose author had no write access, as
|
|
25
|
+
* `<provider>:<externalId>`. Before any author's pull request could join a card only trusted
|
|
26
|
+
* ones did, so a source missing from the list is trusted.
|
|
27
|
+
*/
|
|
28
|
+
const UNTRUSTED_PULL_REQUESTS_KEY = "untrustedPullRequests";
|
|
29
|
+
/** The key {@link UNTRUSTED_PULL_REQUESTS_KEY} lists a source under. */
|
|
30
|
+
function pullRequestTrustKey(source) {
|
|
31
|
+
return `${source.provider}:${source.externalId}`;
|
|
32
|
+
}
|
|
33
|
+
/** Whether a pull request attached to the card was opened by someone with write access (or by Factory). */
|
|
34
|
+
function trustedPullRequestSource(item, source) {
|
|
35
|
+
const untrusted = item.metadata?.[UNTRUSTED_PULL_REQUESTS_KEY];
|
|
36
|
+
return !(Array.isArray(untrusted) && untrusted.includes(pullRequestTrustKey(source)));
|
|
37
|
+
}
|
|
38
|
+
function closedUnmerged(source) {
|
|
39
|
+
return !isOpenPullRequestSource(source) && (source.state ?? source.metadata?.state) !== "merged" && source.metadata?.merged !== true;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* The card's working pull request, the one its review passes and status checks follow: the one
|
|
43
|
+
* `openPullRequestNumber` names (its session's own, or the one a person picked), unless it closed
|
|
44
|
+
* without merging; else the first trusted open one linked, else the first trusted merged one. An
|
|
45
|
+
* outsider's pull request is never picked on its own. `except` leaves one pull request out.
|
|
46
|
+
*/
|
|
47
|
+
function workingPullRequest(item, except) {
|
|
48
|
+
const sources = pullRequestSources(item).filter((source) => !closedUnmerged(source) && (except === void 0 || pullRequestSourceNumber(source) !== except));
|
|
49
|
+
const pointer = item.metadata?.openPullRequestNumber;
|
|
50
|
+
return (typeof pointer === "number" ? sources.find((source) => pullRequestSourceNumber(source) === pointer) : void 0) ?? sources.find((source) => isOpenPullRequestSource(source) && trustedPullRequestSource(item, source)) ?? sources.find((source) => trustedPullRequestSource(item, source));
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* The pull request `openPullRequestNumber` names, unless it is one linked to the card that closed
|
|
54
|
+
* without merging: the card then works on its {@link workingPullRequest} instead. A pointer to a
|
|
55
|
+
* pull request the card has no source for (its session opened it) stands.
|
|
56
|
+
*/
|
|
57
|
+
function pointedPullRequest(item) {
|
|
58
|
+
const pointer = item.metadata?.openPullRequestNumber;
|
|
59
|
+
if (typeof pointer !== "number") return void 0;
|
|
60
|
+
const source = pullRequestSources(item).find((entry) => pullRequestSourceNumber(entry) === pointer);
|
|
61
|
+
return source && closedUnmerged(source) ? void 0 : pointer;
|
|
62
|
+
}
|
|
63
|
+
/** The pull request a PR review pass on this card reviews: its {@link workingPullRequest}. */
|
|
64
|
+
function reviewedPullRequest(item) {
|
|
65
|
+
return workingPullRequest(item);
|
|
66
|
+
}
|
|
67
|
+
const PULL_REQUEST_STATUSES = [
|
|
68
|
+
"draft",
|
|
69
|
+
"open",
|
|
70
|
+
"closed",
|
|
71
|
+
"merged"
|
|
72
|
+
];
|
|
73
|
+
function isSettledChangeRequest(status) {
|
|
74
|
+
return status === "merged" || status === "closed";
|
|
75
|
+
}
|
|
76
|
+
function reportedStatus(state, metadata) {
|
|
77
|
+
const reported = state ?? metadata.state;
|
|
78
|
+
if (reported === "merged" || metadata.merged === true) return "merged";
|
|
79
|
+
if (reported === "closed") return "closed";
|
|
80
|
+
if (reported === "open" || reported === "opened" || reported === "locked") return metadata.draft === true ? "draft" : "open";
|
|
81
|
+
}
|
|
82
|
+
function fromSource(source) {
|
|
83
|
+
const metadata = source.metadata ?? {};
|
|
84
|
+
const syncedAt = source.syncedAt ? new Date(source.syncedAt).getTime() : NaN;
|
|
85
|
+
return {
|
|
86
|
+
url: source.url ?? void 0,
|
|
87
|
+
provider: source.provider === "gitlab" ? "gitlab" : "github",
|
|
88
|
+
number: pullRequestSourceNumber(source),
|
|
89
|
+
status: reportedStatus(source.state, metadata),
|
|
90
|
+
draft: metadata.draft === true,
|
|
91
|
+
syncedAt: Number.isNaN(syncedAt) ? void 0 : syncedAt
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
function changeRequestNumber(source, metadata) {
|
|
95
|
+
if (source === "github-pr") {
|
|
96
|
+
const number = metadata.githubPullRequestNumber ?? metadata.number;
|
|
97
|
+
return typeof number === "number" && Number.isInteger(number) && number > 0 ? number : void 0;
|
|
98
|
+
}
|
|
99
|
+
if (source !== "gitlab-pr") return void 0;
|
|
100
|
+
const iid = metadata.gitlabMergeRequestIid;
|
|
101
|
+
return typeof iid === "number" && Number.isSafeInteger(iid) && iid > 0 ? iid : void 0;
|
|
102
|
+
}
|
|
103
|
+
/** A pull request card filed before its sources were recorded: the card's own source is the request. */
|
|
104
|
+
function fromLegacyCard(card) {
|
|
105
|
+
const metadata = (card.workItem && card.workItem.provider !== "factory" ? card.workItem?.metadata : card.metadata) ?? {};
|
|
106
|
+
return {
|
|
107
|
+
url: card.url ?? void 0,
|
|
108
|
+
provider: card.source === "gitlab-pr" ? "gitlab" : "github",
|
|
109
|
+
number: changeRequestNumber(card.source, metadata),
|
|
110
|
+
status: reportedStatus(card.workItem?.state, metadata),
|
|
111
|
+
draft: metadata.draft === true
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
/** Every pull or merge request a card carries, oldest first. */
|
|
115
|
+
function cardChangeRequests(card) {
|
|
116
|
+
const sources = pullRequestSources(card);
|
|
117
|
+
if (sources.length > 0) return sources.map(fromSource);
|
|
118
|
+
return isPullRequestCard(card) ? [fromLegacyCard(card)] : [];
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* The card's own pull request, else the attached one to show on it: the one `openPullRequestNumber`
|
|
122
|
+
* names, else the newest open one, else the newest one. Unlike {@link reviewedPullRequest} it shows
|
|
123
|
+
* a closed or an outsider's pull request, since showing one starts no work on it.
|
|
124
|
+
*/
|
|
125
|
+
function cardChangeRequest(card) {
|
|
126
|
+
if (isPullRequestCard(card)) return cardChangeRequests(card)[0];
|
|
127
|
+
const sources = pullRequestSources(card);
|
|
128
|
+
const pointer = card.metadata?.openPullRequestNumber;
|
|
129
|
+
const attached = (typeof pointer === "number" ? sources.find((source) => pullRequestSourceNumber(source) === pointer) : void 0) ?? sources.findLast(isOpenPullRequestSource) ?? sources.at(-1);
|
|
130
|
+
return attached ? fromSource(attached) : void 0;
|
|
131
|
+
}
|
|
132
|
+
export { PULL_REQUEST_STATUSES, UNTRUSTED_PULL_REQUESTS_KEY, cardChangeRequest, cardChangeRequests, changeRequestNumber, isOpenPullRequestSource, isPullRequestCard, isSettledChangeRequest, pointedPullRequest, pullRequestSourceNumber, pullRequestSources, pullRequestTrustKey, reviewedPullRequest, trustedPullRequestSource, workingPullRequest };
|
|
133
|
+
|
|
134
|
+
//# sourceMappingURL=change-requests.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"change-requests.js","names":[],"sources":["../../src/work-items/change-requests.ts"],"sourcesContent":["import type { WorkItemSourceRow } from '../storage/domains/work-items/work-item-schema.js';\n\nexport interface 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 `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/** 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\nexport function isOpenPullRequestSource(source: Pick<WorkItemSourceRow, 'state' | 'metadata'>): boolean {\n return !isSettledChangeRequest(reportedStatus(source.state, source.metadata ?? {}));\n}\n\n/**\n * Card metadata listing the attached pull requests whose author had no write access, as\n * `<provider>:<externalId>`. Before any author's pull request could join a card only trusted\n * ones did, so a source missing from the list is trusted.\n */\nexport const UNTRUSTED_PULL_REQUESTS_KEY = 'untrustedPullRequests';\n\n/** The key {@link UNTRUSTED_PULL_REQUESTS_KEY} lists a source under. */\nexport function pullRequestTrustKey(source: Pick<WorkItemSourceRow, 'provider' | 'externalId'>): string {\n return `${source.provider}:${source.externalId}`;\n}\n\n/** Whether a pull request attached to the card was opened by someone with write access (or by Factory). */\nexport function trustedPullRequestSource(\n item: { readonly metadata?: Record<string, unknown> | null },\n source: Pick<WorkItemSourceRow, 'provider' | 'externalId'>,\n): boolean {\n const untrusted = item.metadata?.[UNTRUSTED_PULL_REQUESTS_KEY];\n return !(Array.isArray(untrusted) && untrusted.includes(pullRequestTrustKey(source)));\n}\n\nfunction closedUnmerged(source: Pick<WorkItemSourceRow, 'state' | 'metadata'>): boolean {\n return (\n !isOpenPullRequestSource(source) &&\n (source.state ?? source.metadata?.state) !== 'merged' &&\n source.metadata?.merged !== true\n );\n}\n\n/**\n * The card's working pull request, the one its review passes and status checks follow: the one\n * `openPullRequestNumber` names (its session's own, or the one a person picked), unless it closed\n * without merging; else the first trusted open one linked, else the first trusted merged one. An\n * outsider's pull request is never picked on its own. `except` leaves one pull request out.\n */\nexport function workingPullRequest(\n item: SourcedItem & { readonly metadata?: Record<string, unknown> | null },\n except?: number,\n): WorkItemSourceRow | undefined {\n const sources = pullRequestSources(item).filter(\n source => !closedUnmerged(source) && (except === undefined || pullRequestSourceNumber(source) !== except),\n );\n const pointer = item.metadata?.openPullRequestNumber;\n return (\n (typeof pointer === 'number' ? sources.find(source => pullRequestSourceNumber(source) === pointer) : undefined) ??\n sources.find(source => isOpenPullRequestSource(source) && trustedPullRequestSource(item, source)) ??\n sources.find(source => trustedPullRequestSource(item, source))\n );\n}\n\n/**\n * The pull request `openPullRequestNumber` names, unless it is one linked to the card that closed\n * without merging: the card then works on its {@link workingPullRequest} instead. A pointer to a\n * pull request the card has no source for (its session opened it) stands.\n */\nexport function pointedPullRequest(\n item: SourcedItem & { readonly metadata?: Record<string, unknown> | null },\n): number | undefined {\n const pointer = item.metadata?.openPullRequestNumber;\n if (typeof pointer !== 'number') return undefined;\n const source = pullRequestSources(item).find(entry => pullRequestSourceNumber(entry) === pointer);\n return source && closedUnmerged(source) ? undefined : pointer;\n}\n\n/** The pull request a PR review pass on this card reviews: its {@link workingPullRequest}. */\nexport function reviewedPullRequest(\n item: SourcedItem & { readonly metadata?: Record<string, unknown> | null },\n): WorkItemSourceRow | undefined {\n return workingPullRequest(item);\n}\n\nexport const PULL_REQUEST_STATUSES = ['draft', 'open', 'closed', 'merged'] as const;\nexport type PullRequestStatus = (typeof PULL_REQUEST_STATUSES)[number];\n\nexport interface CardChangeRequest {\n url?: string;\n provider: 'github' | 'gitlab';\n number?: number;\n /** Undefined while the code host has reported no state. */\n status?: PullRequestStatus;\n draft: boolean;\n /** Epoch milliseconds of the code host's last report. */\n syncedAt?: number;\n}\n\ninterface ChangeRequestCard {\n readonly source: string;\n readonly url?: string | null;\n readonly metadata?: Record<string, unknown> | null;\n readonly workItem?: {\n readonly provider?: string;\n readonly state?: string | null;\n readonly metadata?: Record<string, unknown> | null;\n readonly sources?: readonly WorkItemSourceRow[];\n } | null;\n}\n\nexport function isSettledChangeRequest(status: PullRequestStatus | undefined): boolean {\n return status === 'merged' || status === 'closed';\n}\n\nfunction reportedStatus(state: unknown, metadata: Record<string, unknown>): PullRequestStatus | undefined {\n const reported = state ?? metadata.state;\n if (reported === 'merged' || metadata.merged === true) return 'merged';\n if (reported === 'closed') return 'closed';\n if (reported === 'open' || reported === 'opened' || reported === 'locked') {\n return metadata.draft === true ? 'draft' : 'open';\n }\n return undefined;\n}\n\nfunction fromSource(source: WorkItemSourceRow): CardChangeRequest {\n const metadata = source.metadata ?? {};\n const syncedAt = source.syncedAt ? new Date(source.syncedAt).getTime() : Number.NaN;\n return {\n url: source.url ?? undefined,\n provider: source.provider === 'gitlab' ? 'gitlab' : 'github',\n number: pullRequestSourceNumber(source),\n status: reportedStatus(source.state, metadata),\n draft: metadata.draft === true,\n syncedAt: Number.isNaN(syncedAt) ? undefined : syncedAt,\n };\n}\n\nexport function changeRequestNumber(source: string, metadata: Record<string, unknown>): number | undefined {\n if (source === 'github-pr') {\n const number = metadata.githubPullRequestNumber ?? metadata.number;\n return typeof number === 'number' && Number.isInteger(number) && number > 0 ? number : undefined;\n }\n if (source !== 'gitlab-pr') return undefined;\n const iid = metadata.gitlabMergeRequestIid;\n return typeof iid === 'number' && Number.isSafeInteger(iid) && iid > 0 ? iid : undefined;\n}\n\n/** A pull request card filed before its sources were recorded: the card's own source is the request. */\nfunction fromLegacyCard(card: ChangeRequestCard): CardChangeRequest {\n const sourced = card.workItem && card.workItem.provider !== 'factory';\n const metadata = (sourced ? card.workItem?.metadata : card.metadata) ?? {};\n return {\n url: card.url ?? undefined,\n provider: card.source === 'gitlab-pr' ? 'gitlab' : 'github',\n number: changeRequestNumber(card.source, metadata),\n status: reportedStatus(card.workItem?.state, metadata),\n draft: metadata.draft === true,\n };\n}\n\n/** Every pull or merge request a card carries, oldest first. */\nexport function cardChangeRequests(card: ChangeRequestCard): CardChangeRequest[] {\n const sources = pullRequestSources(card);\n if (sources.length > 0) return sources.map(fromSource);\n return isPullRequestCard(card) ? [fromLegacyCard(card)] : [];\n}\n\n/**\n * The card's own pull request, else the attached one to show on it: the one `openPullRequestNumber`\n * names, else the newest open one, else the newest one. Unlike {@link reviewedPullRequest} it shows\n * a closed or an outsider's pull request, since showing one starts no work on it.\n */\nexport function cardChangeRequest(card: ChangeRequestCard): CardChangeRequest | undefined {\n if (isPullRequestCard(card)) return cardChangeRequests(card)[0];\n const sources = pullRequestSources(card);\n const pointer = card.metadata?.openPullRequestNumber;\n const attached =\n (typeof pointer === 'number' ? sources.find(source => pullRequestSourceNumber(source) === pointer) : undefined) ??\n sources.findLast(isOpenPullRequestSource) ??\n sources.at(-1);\n return attached ? fromSource(attached) : undefined;\n}\n"],"mappings":"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"}
|
|
@@ -6,6 +6,7 @@ import type { BoardRegistry } from '../boards/index.js';
|
|
|
6
6
|
import type { IntakeRoutesReader } from '../boards/intake-routing.js';
|
|
7
7
|
import type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';
|
|
8
8
|
import type { EmitAuditInput } from '../storage/domains/audit/domain.js';
|
|
9
|
+
import type { IntakeEvaluator } from '../storage/domains/boards/base.js';
|
|
9
10
|
import type { CreateWorkItemInput, Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
10
11
|
/** Records one audit event for the caller; routes bind it to the request, tools to the session's person. */
|
|
11
12
|
export type FactoryAuditEmit = (input: EmitAuditInput) => Promise<void>;
|
|
@@ -22,7 +23,9 @@ export type CreateFactoryWorkItemResult =
|
|
|
22
23
|
item: Card;
|
|
23
24
|
} | {
|
|
24
25
|
status: 'refused';
|
|
25
|
-
code: 'invalid_board' | 'governed_transition_required' | 'factory_transitions_unavailable'
|
|
26
|
+
code: 'invalid_board' | 'governed_transition_required' | 'factory_transitions_unavailable'
|
|
27
|
+
/** No board's intake rules take the card; the person names the board. */
|
|
28
|
+
| 'intake_board_required';
|
|
26
29
|
message: string;
|
|
27
30
|
}
|
|
28
31
|
/** The first phase's entry rules (or the move to an intake route's phase) refused the card; it was removed again unless a concurrent create had already reused it. */
|
|
@@ -45,6 +48,8 @@ export interface CreateFactoryWorkItemArgs {
|
|
|
45
48
|
input: CreateWorkItemInput;
|
|
46
49
|
/** The project's intake routes; they place a card filed without a board or stages. */
|
|
47
50
|
intakeRoutes?: IntakeRoutesReader;
|
|
51
|
+
/** Forces the evaluator that places a card filed without a board; else the project's setting. */
|
|
52
|
+
intakeEvaluator?: IntakeEvaluator;
|
|
48
53
|
/** Where a browser request came from; a session's tool call carries none. */
|
|
49
54
|
origin?: Pick<FactoryTransitionRequest, 'actorProfile' | 'context'>;
|
|
50
55
|
}
|
|
@@ -53,6 +58,6 @@ export interface CreateFactoryWorkItemArgs {
|
|
|
53
58
|
* person (rolling the card back if its entry rules refuse it), then audits
|
|
54
59
|
* `factory.work_item.created`. Throws `WorkItemRelationError` for a bad parent.
|
|
55
60
|
*/
|
|
56
|
-
export declare function createFactoryWorkItem({ workItems, boards, transitionService, audit, orgId, userId, factoryProjectId, input, intakeRoutes, origin, }: CreateFactoryWorkItemArgs): Promise<CreateFactoryWorkItemResult>;
|
|
61
|
+
export declare function createFactoryWorkItem({ workItems, boards, transitionService, audit, orgId, userId, factoryProjectId, input, intakeRoutes, intakeEvaluator, origin, }: CreateFactoryWorkItemArgs): Promise<CreateFactoryWorkItemResult>;
|
|
57
62
|
export {};
|
|
58
63
|
//# sourceMappingURL=create-work-item.d.ts.map
|