@mastra/factory 0.28.0-alpha.3 → 0.28.0-alpha.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +110 -56
- package/dist/boards/board-events.d.ts +1 -1
- package/dist/boards/board-events.d.ts.map +1 -1
- package/dist/boards/card-facts.d.ts +3 -1
- package/dist/boards/card-facts.d.ts.map +1 -1
- package/dist/boards/card-facts.js +26 -4
- package/dist/boards/card-facts.js.map +1 -1
- package/dist/boards/default-board.d.ts +2 -2
- package/dist/boards/default-board.js +2 -2
- package/dist/boards/default-board.js.map +1 -1
- package/dist/boards/define-board.d.ts +1 -1
- package/dist/boards/define-board.d.ts.map +1 -1
- package/dist/boards/define-board.js.map +1 -1
- package/dist/boards/intake-routing.d.ts +3 -5
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +3 -4
- package/dist/boards/intake-routing.js.map +1 -1
- package/dist/boards/project-boards.d.ts +18 -1
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +40 -3
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/semantics.d.ts +4 -4
- package/dist/boards/semantics.d.ts.map +1 -1
- package/dist/boards/semantics.js +8 -10
- package/dist/boards/semantics.js.map +1 -1
- package/dist/boards/work-migrations.d.ts +24 -1
- package/dist/boards/work-migrations.d.ts.map +1 -1
- package/dist/boards/work-migrations.js +97 -2
- package/dist/boards/work-migrations.js.map +1 -1
- package/dist/boards/work-routes.d.ts +6 -1
- package/dist/boards/work-routes.d.ts.map +1 -1
- package/dist/boards/work-routes.js +20 -6
- package/dist/boards/work-routes.js.map +1 -1
- package/dist/factory.d.ts +23 -0
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +58 -43
- package/dist/factory.js.map +1 -1
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +3 -5
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +0 -6
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +23 -70
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +1 -3
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +4 -9
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/incidentio/agent-tools.js +5 -5
- package/dist/integrations/incidentio/agent-tools.js.map +1 -1
- package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/default-rules.js.map +1 -1
- package/dist/integrations/incidentio/routes.d.ts +2 -2
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +10 -13
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +1 -3
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +1 -3
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/jira/binding-scope.d.ts +5 -6
- package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
- package/dist/integrations/jira/binding-scope.js +9 -11
- package/dist/integrations/jira/binding-scope.js.map +1 -1
- package/dist/integrations/jira/default-rules.d.ts.map +1 -1
- package/dist/integrations/jira/default-rules.js.map +1 -1
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +3 -5
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +1 -3
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +1 -3
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/default-rules.d.ts.map +1 -1
- package/dist/integrations/linear/default-rules.js.map +1 -1
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +11 -14
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts +1 -3
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +1 -3
- package/dist/integrations/linear/rules.js.map +1 -1
- package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
- package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
- package/dist/integrations/platform/connect/session-tools.js +5 -0
- package/dist/integrations/platform/connect/session-tools.js.map +1 -1
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +3 -5
- package/dist/integrations/platform/jira/routes.js.map +1 -1
- package/dist/routes/automation-runs.d.ts +1 -1
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/contracts.d.ts +3 -10
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +11 -9
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +6 -1
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts +0 -23
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +13 -310
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +1 -1
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +0 -2
- package/dist/routes/surface.js.map +1 -1
- package/dist/rules/dispatcher.d.ts +0 -5
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +18 -22
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/rule-group.d.ts +1 -1
- package/dist/rules/rule-group.d.ts.map +1 -1
- package/dist/rules/rule-group.js +13 -5
- package/dist/rules/rule-group.js.map +1 -1
- package/dist/rules/transition-service.d.ts +2 -3
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +0 -1
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +7 -11
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js.map +1 -1
- package/dist/session/self-review-gate.d.ts +0 -2
- package/dist/session/self-review-gate.d.ts.map +1 -1
- package/dist/session/self-review-gate.js +1 -8
- package/dist/session/self-review-gate.js.map +1 -1
- package/dist/session/source-control-tools.d.ts +39 -13
- package/dist/session/source-control-tools.d.ts.map +1 -1
- package/dist/session/source-control-tools.js +54 -60
- package/dist/session/source-control-tools.js.map +1 -1
- package/dist/session/work-item-state-processor.d.ts +1 -4
- package/dist/session/work-item-state-processor.d.ts.map +1 -1
- package/dist/session/work-item-state-processor.js +5 -18
- package/dist/session/work-item-state-processor.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +30 -8
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +43 -25
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/intake/base.d.ts +5 -45
- package/dist/storage/domains/intake/base.d.ts.map +1 -1
- package/dist/storage/domains/intake/base.js +11 -89
- package/dist/storage/domains/intake/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +17 -9
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +15 -7
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts +7 -2
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +4 -0
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/work-items/providers/base.d.ts +4 -1
- package/dist/work-items/providers/base.d.ts.map +1 -1
- package/dist/work-items/providers/base.js +6 -1
- package/dist/work-items/providers/base.js.map +1 -1
- package/dist/work-items/providers/github.d.ts.map +1 -1
- package/dist/work-items/providers/github.js +2 -1
- package/dist/work-items/providers/github.js.map +1 -1
- package/dist/work-items/providers/gitlab.d.ts.map +1 -1
- package/dist/work-items/providers/gitlab.js +2 -1
- package/dist/work-items/providers/gitlab.js.map +1 -1
- package/dist/work-items/providers/jira.d.ts.map +1 -1
- package/dist/work-items/providers/jira.js +3 -2
- package/dist/work-items/providers/jira.js.map +1 -1
- package/dist/work-items/providers/linear.d.ts.map +1 -1
- package/dist/work-items/providers/linear.js +3 -2
- package/dist/work-items/providers/linear.js.map +1 -1
- package/dist/work-items/providers/types.d.ts +6 -0
- package/dist/work-items/providers/types.d.ts.map +1 -1
- package/factory-skills/configure-factory-rules/SKILL.md +2 -2
- package/factory-skills/factory-build/SKILL.md +5 -5
- package/factory-skills/factory-gitlab-rereview/SKILL.md +1 -1
- package/factory-skills/factory-gitlab-review/SKILL.md +1 -1
- package/factory-skills/factory-rereview/SKILL.md +2 -2
- package/factory-skills/factory-review/SKILL.md +2 -2
- package/package.json +6 -6
package/dist/rules/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","names":[],"sources":["../../src/rules/types.ts"],"sourcesContent":["import type { ActivityEvent, BoardEventFacts } from '../boards/board-events.js';\nimport type { ExternalWorkItemSource } from '../storage/domains/work-items/base.js';\nimport type { WorkItemRow } from '../storage/domains/work-items/work-item-schema.js';\n\nexport type WorkItemSource =\n | 'github-issue'\n | 'github-pr'\n | 'gitlab-issue'\n | 'gitlab-pr'\n | 'linear-issue'\n | 'jira-issue'\n | 'incidentio-follow-up'\n | 'manual';\n\nexport function externalSourceForWorkItem(\n source: WorkItemSource,\n sourceKey: string,\n url?: string,\n): ExternalWorkItemSource {\n const [integrationId, type] =\n source === 'github-pr'\n ? ['github', 'pull-request']\n : source === 'github-issue'\n ? ['github', 'issue']\n : source === 'gitlab-pr'\n ? ['gitlab', 'pull-request']\n : source === 'gitlab-issue'\n ? ['gitlab', 'issue']\n : source === 'linear-issue'\n ? ['linear', 'issue']\n : source === 'jira-issue'\n ? ['jira', 'issue']\n : source === 'incidentio-follow-up'\n ? ['incidentio', 'issue']\n : ['factory', 'manual'];\n return { integrationId, type, externalId: sourceKey, ...(url ? { url } : {}) };\n}\n\n/** The source label that holds an issue at rest until a maintainer decides; compared lowercased. */\nexport const NEEDS_APPROVAL_LABEL = 'status: needs approval';\n\n/** Request-changes rounds from self-review before the card parks in Intake for a person. */\nexport const SELF_REVIEW_ROUND_LIMIT = 3;\nexport const AUTO_TRIAGED_LABEL = 'status: auto-triaged';\n\n// The label only holds a card nobody accepted yet (`awaitsAcceptance`, see the boards'\n// `awaitsAcceptance`): once a person moves it into a working lane, the label is stale until the\n// source catches up (Factory removes it on that move).\nexport function needsApproval(\n item: { workItem: Pick<WorkItemRow, 'labels'>; stages?: readonly string[] },\n awaitsAcceptance: (stage: string) => boolean,\n): boolean {\n const labels = item.workItem.labels;\n if (!Array.isArray(labels)) return false;\n return (\n labels.some(label => typeof label === 'string' && label.toLowerCase() === NEEDS_APPROVAL_LABEL) &&\n (item.stages ?? []).every(awaitsAcceptance)\n );\n}\n\nexport function workItemSource(source: ExternalWorkItemSource | null): WorkItemSource {\n if (!source) return 'manual';\n if (source.integrationId === 'linear') return 'linear-issue';\n if (source.integrationId === 'gitlab') return source.type === 'pull-request' ? 'gitlab-pr' : 'gitlab-issue';\n if (source.integrationId === 'jira') return 'jira-issue';\n if (source.integrationId === 'incidentio') return 'incidentio-follow-up';\n // Only GitHub, GitLab, Linear, Jira, and incident.io have provider-specific\n // rules; anything else (a Slack thread, say) is a plain work item, not a\n // mislabeled GitHub issue.\n if (source.integrationId !== 'github') return 'manual';\n return source.type === 'pull-request' ? 'github-pr' : 'github-issue';\n}\n\n/** The card's author is inside the write-access circle, or the card is Factory's own PR. */\nexport function authorTrusted(metadata: Record<string, unknown> | null | undefined): boolean {\n return metadata?.authorTrusted === true || metadata?.factoryAuthored === true;\n}\n\n// Authored outside the write-access circle: a missing trust stamp fails closed until\n// the reconcile sweep backfills it, and Factory's own PRs pass through `factoryAuthored`.\nexport function externallyAuthored(item: { source: string; metadata: Record<string, unknown> | null }): boolean {\n if (!['github-pr', 'github-issue', 'gitlab-pr', 'gitlab-issue'].includes(item.source)) return false;\n return !authorTrusted(item.metadata);\n}\n\nexport function externallyAuthoredWorkItem(item: {\n externalSource: ExternalWorkItemSource | null;\n metadata: Record<string, unknown> | null;\n}): boolean {\n return externallyAuthored({ source: workItemSource(item.externalSource), metadata: item.metadata });\n}\n\n/** A phase key on the card's board. Boards name their own phases; Factory reads none of them by name. */\nexport type FactoryRuleStage = string;\n\nexport const FACTORY_TRIAGE_TYPES = [\n 'bug',\n 'feature request',\n 'docs',\n 'question/support',\n 'maintenance',\n 'duplicate',\n 'resolved',\n 'invalid',\n 'spam',\n 'out-of-scope',\n 'other',\n] as const;\nexport type FactoryTriageType = (typeof FACTORY_TRIAGE_TYPES)[number];\n\nexport function isFactoryTriageType(value: unknown): value is FactoryTriageType {\n return typeof value === 'string' && FACTORY_TRIAGE_TYPES.some(type => type === value);\n}\n\n/** A board id. */\nexport type FactoryRuleBoard = string;\n\nexport const FACTORY_RULE_SOURCES = [\n 'issue',\n 'pullRequest',\n 'gitlabIssue',\n 'gitlabPullRequest',\n 'linearIssue',\n 'jiraIssue',\n 'incidentioFollowUp',\n 'manual',\n] as const;\nexport type FactoryRuleSource = (typeof FACTORY_RULE_SOURCES)[number];\n\nexport const FACTORY_GITHUB_EVENTS = [\n 'issueOpened',\n 'issueEdited',\n 'issueClosed',\n 'issueReopened',\n 'issueCommentCreated',\n 'issueCommentEdited',\n 'issueCommentDeleted',\n 'pullRequestOpened',\n 'pullRequestUpdated',\n 'pullRequestCommentCreated',\n 'pullRequestReviewRequested',\n 'pullRequestReviewSubmitted',\n 'pullRequestMerged',\n 'pullRequestClosed',\n] as const;\nexport type FactoryGithubEventName = (typeof FACTORY_GITHUB_EVENTS)[number];\n\nexport const FACTORY_GITLAB_EVENTS = [\n 'issueOpened',\n 'issueUpdated',\n 'issueClosed',\n 'issueReopened',\n 'issueCommented',\n 'mergeRequestOpened',\n 'mergeRequestUpdated',\n 'mergeRequestCommented',\n 'mergeRequestMerged',\n 'mergeRequestClosed',\n] as const;\nexport type FactoryGitLabEventName = (typeof FACTORY_GITLAB_EVENTS)[number];\n\nexport const FACTORY_LINEAR_EVENTS = ['issueObserved', 'issueClosed'] as const;\nexport type FactoryLinearEventName = (typeof FACTORY_LINEAR_EVENTS)[number];\n\nexport const FACTORY_JIRA_EVENTS = ['issueObserved', 'issueClosed'] as const;\nexport type FactoryJiraEventName = (typeof FACTORY_JIRA_EVENTS)[number];\n\nexport const FACTORY_INCIDENTIO_EVENTS = ['followUpObserved', 'followUpClosed'] as const;\nexport type FactoryIncidentioEventName = (typeof FACTORY_INCIDENTIO_EVENTS)[number];\n\nexport type FactoryRuleJsonValue =\n | null\n | boolean\n | number\n | string\n | FactoryRuleJsonValue[]\n | { [key: string]: FactoryRuleJsonValue };\n\nexport interface FactoryRuleItemContext {\n workItem: WorkItemRow;\n id: string;\n source: WorkItemSource;\n sourceKey: string | null;\n parentWorkItemId: string | null;\n title: string;\n url: string | null;\n stages: readonly string[];\n /**\n * @deprecated Factory no longer records triage acceptance; this is the value stamped on older\n * cards, and `null` for every card since. A person moving the card on is the approval.\n */\n acceptedAt: Date | null;\n /** Factory-owned process state and trust stamps. */\n metadata: Record<string, unknown> | null;\n}\n\nexport type FactoryRuleActor =\n | { type: 'human'; id: string }\n | { type: 'agent'; bindingId: string; role: string }\n | { type: 'github'; login: string; trusted: boolean; factoryAuthored: boolean }\n | { type: 'gitlab'; username: string; trusted: boolean; factoryAuthored: boolean }\n | { type: 'system'; id: string };\n\nexport interface FactoryRuleIngressIdentity {\n type: 'human' | 'agent' | 'toolResult' | 'github' | 'gitlab' | 'linear' | 'jira' | 'incidentio' | 'rule';\n id: string;\n}\n\nexport interface FactoryRuleCausalEntry {\n ingressId: string;\n decisionType: FactoryCommitDecision['type'];\n}\n\n/** The phase a card sits in, as its board declares it. */\nexport interface FactoryRulePhaseContext {\n id: string;\n kind: 'resting' | 'working' | 'terminal';\n /** Session context a working phase runs in; absent for resting and terminal phases. */\n context?: string;\n /** @deprecated Use `context`. */\n role?: string;\n /** Phases the card may move to from here. */\n nextPhases: readonly string[];\n}\n\nexport interface FactoryRuleContextBase {\n tenant: { orgId: string; projectId: string };\n actor: FactoryRuleActor;\n ingress: FactoryRuleIngressIdentity;\n cause: string;\n causalChain: readonly FactoryRuleCausalEntry[];\n configVersion: string;\n}\n\nexport interface FactoryBoundRuleContext extends FactoryRuleContextBase {\n item: FactoryRuleItemContext;\n board: FactoryRuleBoard;\n itemRevision: number;\n}\n\nexport interface FactoryStageRuleContext extends FactoryBoundRuleContext {\n source: FactoryRuleSource;\n stage: FactoryRuleStage;\n fromStage: FactoryRuleStage;\n toStage: FactoryRuleStage;\n}\n\nexport interface FactoryToolResultRuleContext extends FactoryBoundRuleContext {\n toolName: string;\n threadId: string;\n assistantMessageId: string;\n toolCallId: string;\n result: {\n status: 'success' | 'error';\n value: FactoryRuleJsonValue;\n };\n}\n\nexport interface FactoryGithubRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /**\n * Board an issue's labels route it to, when the project has a matching label route and that board\n * is installed. Absent for pull requests and for issues whose labels select nothing.\n */\n intake?: FactoryRuleIntakeTarget;\n /**\n * Set on the one evaluation per pull request delivery that files the pull\n * request's own Review card. Opening a pull request concerns two cards — that\n * Review card and the Work item that authored the pull request — so the rule\n * answers for the two separately: the arrival carries this flag and is\n * committed against the authoring item when resolution found one, which is\n * what links the new card to it, while the authoring item's own evaluation\n * leaves the flag unset.\n */\n pullRequestIntake?: boolean;\n /**\n * Set on both evaluations of a pull request's first sighting when it belongs on an existing\n * card: the Work card that authored it (`authored`), or the card of the issue a trusted author's\n * pull request says it closes (`closes`). The pull request is filed on that card as one more\n * source rather than on a card of its own.\n */\n pullRequestHome?: FactoryPullRequestHome;\n event: FactoryGithubEventName;\n deliveryId: string;\n factory: { createdAt: string };\n /** `installationId` is the GitHub App installation the delivery arrived through. */\n repository: { id: number; fullName: string; installationId?: number };\n issue?: {\n number: number;\n title: string;\n url: string;\n createdAt?: string;\n updatedAt?: string;\n assignees?: string[];\n labels?: string[];\n state?: 'open' | 'closed';\n author?: string;\n /** GitHub close reason: `completed`, `not_planned`, or `duplicate`. */\n stateReason?: string;\n };\n issueChange?: { title: boolean; body: boolean };\n issueComment?: {\n id: number;\n body?: string;\n url?: string;\n author?: string;\n authorType?: string;\n createdAt?: string;\n updatedAt?: string;\n };\n pullRequest?: {\n number: number;\n title: string;\n url: string;\n createdAt?: string;\n state: 'open' | 'closed';\n draft: boolean;\n merged: boolean;\n assignees?: string[];\n requestedReviewers?: string[];\n labels?: string[];\n author?: string;\n factoryAuthored: boolean;\n headBranch: string;\n /** Lowercase head commit SHA, when the delivery carries one. */\n headSha?: string;\n baseBranch: string;\n };\n /** Present on `pullRequestReviewRequested`: who review was (re-)requested from. */\n reviewRequest?: { reviewer: string; factoryReviewer: boolean };\n /** Present when a PR comment uses Factory's exact review command. */\n reviewCommand?: { command: 'review' | 're-review'; target: string };\n /**\n * Present on `pullRequestReviewSubmitted`: the review that was just posted, or a\n * request-changes review whose body was edited to a new Factory verdict.\n */\n review?: { id: number; state: string; url: string; author?: string; body?: string };\n}\n\n/**\n * Where new items from this source land: the board a label route or the source's intake binding\n * names, else the project's default board. Absent only when none of those boards is installed.\n */\nexport interface FactoryRuleIntakeTarget {\n board: string;\n initialPhase: string;\n /** The board's pull request review phase, where a pull request asked to be reviewed lands. */\n pullRequestReview?: string;\n}\n\n/**\n * Where a source-closed rule moves the card, from the `sourceClosed` mapping its installed board\n * declares. Absent when the card's board is not installed or declares no mapping.\n */\nexport interface FactoryRuleBoardClosure {\n /** Title of the card's board, for messages. */\n boardTitle: string;\n /** Terminal phase for a source that was completed. */\n completed: FactoryRuleBoardClosurePhase;\n /** Terminal phase for a source that was canceled or not planned. */\n canceled: FactoryRuleBoardClosurePhase;\n /** Whether the card already sits in a terminal phase of its board. */\n itemTerminal: boolean;\n}\n\nexport interface FactoryRuleBoardClosurePhase {\n phase: string;\n title: string;\n}\n\n/**\n * The phases a card's board runs its pull request loop through, read from what each phase declares\n * (see `boardFlow`). Every field is absent when the board has no such phase.\n */\nexport interface FactoryRuleBoardFlow {\n /** Where a card on the board rests before work starts and goes back to when its pull request is abandoned. */\n readonly initialPhase?: string;\n /** Phase that takes pull requests: reviews them, records verdicts on them, and re-reviews pushes. */\n readonly pullRequestReview?: string;\n /** Working phase that sorts new cards before anyone accepts them: on a board that builds, the first one that neither builds nor reviews. */\n readonly triage?: string;\n /** Working phase that reviews the builder's branch before a pull request opens. */\n readonly selfReview?: string;\n /** Working phase that builds the change and opens the pull request. */\n readonly build?: string;\n /** Seat that runs {@link build}; pull request feedback wakes it. */\n readonly buildRole?: string;\n /** Terminal phase a merge finishes the card in: the board's `sourceClosed.completed`, else its first terminal phase. */\n readonly completed?: Readonly<FactoryRuleBoardClosurePhase>;\n /** Terminal phase a pull request closed unmerged ends its own card in: `sourceClosed.canceled`, else the next terminal phase. */\n readonly canceled?: Readonly<FactoryRuleBoardClosurePhase>;\n}\n\nexport interface FactoryGitLabRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n intake?: FactoryRuleIntakeTarget;\n /** Set on a merge request's first sighting when it is filed on an existing card instead of its own. */\n pullRequestHome?: FactoryPullRequestHome;\n event: FactoryGitLabEventName;\n deliveryId: string;\n factory: { createdAt: string };\n repository: { id: number; fullName: string; host: string };\n issue?: {\n number: number;\n sourceKey: string;\n title: string;\n url: string;\n createdAt?: string;\n updatedAt?: string;\n assignees?: string[];\n labels?: string[];\n labelColors?: Record<string, string>;\n state?: 'open' | 'closed';\n author?: string;\n authorTrusted: boolean;\n };\n note?: {\n id: number;\n body?: string;\n url?: string;\n author?: string;\n createdAt?: string;\n updatedAt?: string;\n };\n mergeRequest?: {\n number: number;\n sourceKey: string;\n title: string;\n url: string;\n createdAt?: string;\n state: 'open' | 'closed';\n draft: boolean;\n merged: boolean;\n assignees?: string[];\n reviewers?: string[];\n labels?: string[];\n labelColors?: Record<string, string>;\n author?: string;\n authorTrusted: boolean;\n factoryAuthored: boolean;\n headBranch: string;\n baseBranch: string;\n };\n}\n\nexport interface FactoryLinearRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Bound board for the source this issue came from, when one is configured and installed. */\n intake?: FactoryRuleIntakeTarget;\n event: FactoryLinearEventName;\n issue: {\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n creator: string | null;\n team: string | null;\n labels: readonly string[];\n createdAt: string;\n updatedAt: string;\n sourceId?: string | null;\n projectId?: string | null;\n };\n}\n\nexport interface FactoryJiraRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Bound board for the source this issue came from, when one is configured and installed. */\n intake?: FactoryRuleIntakeTarget;\n event: FactoryJiraEventName;\n issue: {\n /** Stable issue reference — the direct integration's Jira id or the Platform-encoded issue reference. */\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n author: string | null;\n project: string | null;\n site: string | null;\n labels: readonly string[];\n createdAt: string;\n updatedAt: string;\n };\n}\n\nexport interface FactoryIncidentioRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Bound board for the source this follow-up came from, when one is configured and installed. */\n intake?: FactoryRuleIntakeTarget;\n event: FactoryIncidentioEventName;\n issue: {\n /** Stable item reference — the prefixed incident.io follow-up id the intake feed serves as `id`. */\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n author: string | null;\n /** Reference of the incident this follow-up belongs to, when available. */\n incident: string | null;\n labels: readonly string[];\n createdAt: string;\n updatedAt: string;\n };\n}\n\nexport type FactoryRuleHandler<TContext> = (\n context: Readonly<TContext>,\n) => FactoryRuleDecision | void | Promise<FactoryRuleDecision | void>;\n\nexport type FactoryRuleRejectionCode =\n | 'forbidden'\n | 'invalid_transition'\n | 'missing_binding'\n | 'stale'\n | 'timeout'\n | 'rule_error'\n | 'causal_depth_exceeded'\n | 'repeated_transition'\n | 'approval_required';\n\nexport interface FactoryRuleRejectDecision {\n type: 'reject';\n code: FactoryRuleRejectionCode;\n reason: string;\n}\n\ninterface FactoryCommitDecisionBase {\n idempotencyKey: string;\n}\n\nexport interface FactoryTransitionDecision extends FactoryCommitDecisionBase {\n type: 'transition';\n board: FactoryRuleBoard;\n stage: FactoryRuleStage;\n /**\n * Delivered to the item's active session (waking it if idle) after the\n * transition commits. Skipped when the item has no active run binding, so\n * informational messages never fail the transition.\n */\n message?: { text: string; role?: string };\n /**\n * Runs the stage's entry rules even when the item is already in that stage.\n * A transition to the current stage is normally inert, because most callers\n * are correcting a board into a state it already holds. Re-entry is for the\n * opposite case: the stage's work is in flight and has been invalidated, so\n * it has to start over.\n */\n reenter?: boolean;\n /**\n * The status event this move answers. The project's intake routes on the card's board then\n * decide where the card goes instead, and this move applies only when no route on the board\n * handles the event; a route that does, even a disabled one, owns it. Factory drops the tag\n * from a decision returned by an explicit override on the integration's `rules`, so that\n * override's move always applies; a board handler's tagged move still goes to the routes.\n */\n event?: BoardEventFacts;\n}\n\n/**\n * Hands a status event on an existing card to the project's intake routes: the first enabled\n * route on the card's board whose `on` names the event and whose `when` matches moves the card.\n * Integrations add it when no rule decided anything for the delivery; nothing moves when no\n * route matches.\n */\nexport interface FactoryRouteEventDecision extends FactoryCommitDecisionBase {\n type: 'routeEvent';\n event: BoardEventFacts;\n}\n\n/**\n * Tells the card's live session that its source saw activity, such as a new\n * comment or an edit. It carries pointers only: the dispatcher writes the\n * message from these fields, so no provider text (a comment body, a title)\n * ever reaches the session through it. Without a live session it is dropped.\n */\nexport interface FactorySignalActivityDecision extends FactoryCommitDecisionBase {\n type: 'signalActivity';\n event: ActivityEvent;\n /** The source's own reference, such as `acme/app#12`. */\n reference: string;\n url: string;\n author?: string;\n authorTrusted: boolean;\n /**\n * What an idle session does with it. Defaults to `wake`; `persist` leaves it\n * in the session's notifications without starting a run, for sources whose\n * own comments Factory cannot tell apart from other people's. Activity from an\n * untrusted author always persists.\n */\n idleBehavior?: 'wake' | 'persist';\n}\n\n/** The existing card a pull or merge request is filed on; see `pullRequestHome`. */\nexport interface FactoryPullRequestHome {\n workItemId: string;\n reason: 'authored' | 'closes';\n}\n\nexport interface FactoryUpsertLinkedWorkItemDecision extends FactoryCommitDecisionBase {\n type: 'upsertLinkedWorkItem';\n board: FactoryRuleBoard;\n source: WorkItemSource;\n sourceKey: string;\n title: string;\n url: string | null;\n stage: FactoryRuleStage;\n /**\n * File the card at `stage` as its first entry and run none of the board's\n * phase rules for it — no arrival, no destination entry. The card is filed\n * (or, if it already exists, moved) and left parked for a person; nothing is\n * started for it. For external records that arrive already past the board's\n * first step: a GitHub issue whose triage is already recorded, for instance.\n *\n * Placement is the whole decision. An existing card it reaches is moved to\n * that stage through the same relocation the label routes use, and its\n * metadata is left alone.\n */\n skipRules?: boolean;\n /**\n * File the pull or merge request on this existing card, the one that authored it, as one more\n * source instead of on a card of its own. Applies only when no card holds the record yet and\n * the card is still open on Work; otherwise the record is filed as usual.\n */\n attachTo?: { workItemId: string };\n /**\n * The card of the issue this pull or merge request closes. When no card holds the record yet,\n * the project's intake routes can test that card and join the record to it (see\n * `IntakeRouteTarget.joinClosedIssue`); otherwise it is filed as usual.\n */\n closesIssue?: { workItemId: string };\n metadata?: Record<string, FactoryRuleJsonValue>;\n}\n\ninterface FactoryInvokeSkillDecisionBase extends FactoryCommitDecisionBase {\n type: 'invokeSkill';\n role: string;\n arguments?: string;\n precedingMessage?: string;\n cancelInFlight?: boolean;\n /**\n * Start this run even when the card was moved by the agent already running in\n * this role's session. The prompt is queued onto that agent's run, so a phase\n * that shares its context with the one before it still gets its own work.\n * Without it, an agent's own move into a phase of its role starts nothing.\n */\n startsAfterOwnMove?: boolean;\n /**\n * Pursue the run's work as a goal: the session's thread holds `objective` until the card\n * leaves the phase, and the agent's goal judge keeps the run going until it is met.\n */\n goal?: { objective: string; maxRuns?: number };\n}\n\n/**\n * Starting an agent run. Most runs activate a skill, because the skill carries\n * the handoff contract later rules match on. A run whose completion is already\n * signalled some other way — Building finishes by opening a pull request, which\n * arrives as its own event — needs no contract, so it can carry a plain prompt\n * instead of an otherwise empty skill.\n */\nexport type FactoryInvokeSkillDecision = FactoryInvokeSkillDecisionBase &\n (\n | {\n skillName: string;\n prompt?: never;\n /**\n * Same-stage re-entry: the skill is already active in the card's live session,\n * so deliver a compact continuation that references it by name and carries only\n * the fresh arguments, instead of re-pasting the whole skill document. Only valid\n * for named-skill decisions — a plain prompt run has no active skill to resume.\n */\n resume?: boolean;\n }\n | { prompt: string; skillName?: never; resume?: never }\n );\n\nexport interface FactorySendMessageDecision extends FactoryCommitDecisionBase {\n type: 'sendMessage';\n /** Omitted: the card's live session, whichever seat holds it. Required with `prepareBinding`. */\n role?: string;\n message: string;\n priority?: 'medium' | 'high' | 'urgent';\n idleBehavior?: 'persist' | 'wake';\n prepareBinding?: boolean;\n}\n\nexport interface FactoryNotifyDecision extends FactoryCommitDecisionBase {\n type: 'notify';\n title: string;\n body?: string;\n level?: 'info' | 'warning' | 'error';\n}\n\n/**\n * Dismisses Factory change requests an approval has superseded on a GitHub\n * pull request. Only reviews carrying Factory's `Verdict: request changes`\n * marker from an identity other than the approving one are dismissed.\n */\nexport interface FactoryDismissStaleReviewsDecision extends FactoryCommitDecisionBase {\n type: 'dismissStaleReviews';\n installationId: number;\n repository: string;\n pullRequestNumber: number;\n approvingReviewId: string;\n approvingAuthor: string;\n}\n\nexport type FactoryCommitDecision =\n | FactoryTransitionDecision\n | FactoryRouteEventDecision\n | FactorySignalActivityDecision\n | FactoryDismissStaleReviewsDecision\n | FactoryUpsertLinkedWorkItemDecision\n | FactoryInvokeSkillDecision\n | FactorySendMessageDecision\n | FactoryNotifyDecision;\n\nexport type FactoryRuleDecision = FactoryRuleRejectDecision | FactoryCommitDecision;\n\nexport interface FactoryTransitionResultAccepted {\n status: 'accepted';\n transitionId: string;\n itemId: string;\n revision: number;\n stage: FactoryRuleStage;\n decisions: FactoryCommitDecision[];\n}\n\nexport interface FactoryTransitionResultRejected {\n status: 'rejected';\n transitionId: string;\n itemId: string;\n code: FactoryRuleRejectionCode;\n reason: string;\n}\n\nexport type FactoryTransitionResult = FactoryTransitionResultAccepted | FactoryTransitionResultRejected;\n\nexport function factoryRuleSourceForWorkItem(source: WorkItemSource): FactoryRuleSource {\n switch (source) {\n case 'github-issue':\n return 'issue';\n case 'github-pr':\n return 'pullRequest';\n case 'gitlab-issue':\n return 'gitlabIssue';\n case 'gitlab-pr':\n return 'gitlabPullRequest';\n case 'linear-issue':\n return 'linearIssue';\n case 'jira-issue':\n return 'jiraIssue';\n case 'incidentio-follow-up':\n return 'incidentioFollowUp';\n case 'manual':\n return 'manual';\n }\n}\n"],"mappings":";AAcA,SAAgB,0BACd,QACA,WACA,KACwB;CACxB,MAAM,CAAC,eAAe,QACpB,WAAW,cACP,CAAC,UAAU,cAAc,IACzB,WAAW,iBACT,CAAC,UAAU,OAAO,IAClB,WAAW,cACT,CAAC,UAAU,cAAc,IACzB,WAAW,iBACT,CAAC,UAAU,OAAO,IAClB,WAAW,iBACT,CAAC,UAAU,OAAO,IAClB,WAAW,eACT,CAAC,QAAQ,OAAO,IAChB,WAAW,yBACT,CAAC,cAAc,OAAO,IACtB,CAAC,WAAW,QAAQ;CACtC,OAAO;EAAE;EAAe;EAAM,YAAY;EAAW,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;CAAG;AAC/E;;AAGA,MAAa,uBAAuB;;AAGpC,MAAa,0BAA0B;AACvC,MAAa,qBAAqB;AAKlC,SAAgB,cACd,MACA,kBACS;CACT,MAAM,SAAS,KAAK,SAAS;CAC7B,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO;CACnC,OACE,OAAO,MAAK,UAAS,OAAO,UAAU,YAAY,MAAM,YAAY,MAAA,wBAA0B,MAC7F,KAAK,UAAU,CAAC,EAAA,CAAG,MAAM,gBAAgB;AAE9C;AAEA,SAAgB,eAAe,QAAuD;CACpF,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,kBAAkB,UAAU,OAAO;CAC9C,IAAI,OAAO,kBAAkB,UAAU,OAAO,OAAO,SAAS,iBAAiB,cAAc;CAC7F,IAAI,OAAO,kBAAkB,QAAQ,OAAO;CAC5C,IAAI,OAAO,kBAAkB,cAAc,OAAO;CAIlD,IAAI,OAAO,kBAAkB,UAAU,OAAO;CAC9C,OAAO,OAAO,SAAS,iBAAiB,cAAc;AACxD;;AAGA,SAAgB,cAAc,UAA+D;CAC3F,OAAO,UAAU,kBAAkB,QAAQ,UAAU,oBAAoB;AAC3E;AAIA,SAAgB,mBAAmB,MAA6E;CAC9G,IAAI,CAAC;EAAC;EAAa;EAAgB;EAAa;CAAc,CAAC,CAAC,SAAS,KAAK,MAAM,GAAG,OAAO;CAC9F,OAAO,CAAC,cAAc,KAAK,QAAQ;AACrC;AAEA,SAAgB,2BAA2B,MAG/B;CACV,OAAO,mBAAmB;EAAE,QAAQ,eAAe,KAAK,cAAc;EAAG,UAAU,KAAK;CAAS,CAAC;AACpG;AAKA,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,SAAgB,oBAAoB,OAA4C;CAC9E,OAAO,OAAO,UAAU,YAAY,qBAAqB,MAAK,SAAQ,SAAS,KAAK;AACtF;AAKA,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB,CAAC,iBAAiB,aAAa;AAGpE,MAAa,sBAAsB,CAAC,iBAAiB,aAAa;AAGlE,MAAa,4BAA4B,CAAC,oBAAoB,gBAAgB;AAynB9E,SAAgB,6BAA6B,QAA2C;CACtF,QAAQ,QAAR;EACE,KAAK,gBACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,cACH,OAAO;EACT,KAAK,wBACH,OAAO;EACT,KAAK,UACH,OAAO;CACX;AACF"}
|
|
1
|
+
{"version":3,"file":"types.js","names":[],"sources":["../../src/rules/types.ts"],"sourcesContent":["import type { ActivityEvent, BoardEventFacts } from '../boards/board-events.js';\nimport type { ExternalWorkItemSource } from '../storage/domains/work-items/base.js';\nimport type { WorkItemRow } from '../storage/domains/work-items/work-item-schema.js';\n\nexport type WorkItemSource =\n | 'github-issue'\n | 'github-pr'\n | 'gitlab-issue'\n | 'gitlab-pr'\n | 'linear-issue'\n | 'jira-issue'\n | 'incidentio-follow-up'\n | 'manual';\n\nexport function externalSourceForWorkItem(\n source: WorkItemSource,\n sourceKey: string,\n url?: string,\n): ExternalWorkItemSource {\n const [integrationId, type] =\n source === 'github-pr'\n ? ['github', 'pull-request']\n : source === 'github-issue'\n ? ['github', 'issue']\n : source === 'gitlab-pr'\n ? ['gitlab', 'pull-request']\n : source === 'gitlab-issue'\n ? ['gitlab', 'issue']\n : source === 'linear-issue'\n ? ['linear', 'issue']\n : source === 'jira-issue'\n ? ['jira', 'issue']\n : source === 'incidentio-follow-up'\n ? ['incidentio', 'issue']\n : ['factory', 'manual'];\n return { integrationId, type, externalId: sourceKey, ...(url ? { url } : {}) };\n}\n\n/** The source label that holds an issue at rest until a maintainer decides; compared lowercased. */\nexport const NEEDS_APPROVAL_LABEL = 'status: needs approval';\n\n/** Request-changes rounds from self-review before the card parks in Intake for a person. */\nexport const SELF_REVIEW_ROUND_LIMIT = 3;\nexport const AUTO_TRIAGED_LABEL = 'status: auto-triaged';\n\n// The label only holds a card nobody accepted yet (`awaitsAcceptance`, see the boards'\n// `awaitsAcceptance`): once a person moves it into a working lane, the label is stale until the\n// source catches up (Factory removes it on that move).\nexport function needsApproval(\n item: { workItem: Pick<WorkItemRow, 'labels'>; stages?: readonly string[] },\n awaitsAcceptance: (stage: string) => boolean,\n): boolean {\n const labels = item.workItem.labels;\n if (!Array.isArray(labels)) return false;\n return (\n labels.some(label => typeof label === 'string' && label.toLowerCase() === NEEDS_APPROVAL_LABEL) &&\n (item.stages ?? []).every(awaitsAcceptance)\n );\n}\n\nexport function workItemSource(source: ExternalWorkItemSource | null): WorkItemSource {\n if (!source) return 'manual';\n if (source.integrationId === 'linear') return 'linear-issue';\n if (source.integrationId === 'gitlab') return source.type === 'pull-request' ? 'gitlab-pr' : 'gitlab-issue';\n if (source.integrationId === 'jira') return 'jira-issue';\n if (source.integrationId === 'incidentio') return 'incidentio-follow-up';\n // Only GitHub, GitLab, Linear, Jira, and incident.io have provider-specific\n // rules; anything else (a Slack thread, say) is a plain work item, not a\n // mislabeled GitHub issue.\n if (source.integrationId !== 'github') return 'manual';\n return source.type === 'pull-request' ? 'github-pr' : 'github-issue';\n}\n\n/** The card's author is inside the write-access circle, or the card is Factory's own PR. */\nexport function authorTrusted(metadata: Record<string, unknown> | null | undefined): boolean {\n return metadata?.authorTrusted === true || metadata?.factoryAuthored === true;\n}\n\n// Authored outside the write-access circle: a missing trust stamp fails closed until\n// the reconcile sweep backfills it, and Factory's own PRs pass through `factoryAuthored`.\nexport function externallyAuthored(item: { source: string; metadata: Record<string, unknown> | null }): boolean {\n if (!['github-pr', 'github-issue', 'gitlab-pr', 'gitlab-issue'].includes(item.source)) return false;\n return !authorTrusted(item.metadata);\n}\n\nexport function externallyAuthoredWorkItem(item: {\n externalSource: ExternalWorkItemSource | null;\n metadata: Record<string, unknown> | null;\n}): boolean {\n return externallyAuthored({ source: workItemSource(item.externalSource), metadata: item.metadata });\n}\n\n/** A phase key on the card's board. Boards name their own phases; Factory reads none of them by name. */\nexport type FactoryRuleStage = string;\n\nexport const FACTORY_TRIAGE_TYPES = [\n 'bug',\n 'feature request',\n 'docs',\n 'question/support',\n 'maintenance',\n 'duplicate',\n 'resolved',\n 'invalid',\n 'spam',\n 'out-of-scope',\n 'other',\n] as const;\nexport type FactoryTriageType = (typeof FACTORY_TRIAGE_TYPES)[number];\n\nexport function isFactoryTriageType(value: unknown): value is FactoryTriageType {\n return typeof value === 'string' && FACTORY_TRIAGE_TYPES.some(type => type === value);\n}\n\n/** A board id. */\nexport type FactoryRuleBoard = string;\n\nexport const FACTORY_RULE_SOURCES = [\n 'issue',\n 'pullRequest',\n 'gitlabIssue',\n 'gitlabPullRequest',\n 'linearIssue',\n 'jiraIssue',\n 'incidentioFollowUp',\n 'manual',\n] as const;\nexport type FactoryRuleSource = (typeof FACTORY_RULE_SOURCES)[number];\n\nexport const FACTORY_GITHUB_EVENTS = [\n 'issueOpened',\n 'issueEdited',\n 'issueClosed',\n 'issueReopened',\n 'issueCommentCreated',\n 'issueCommentEdited',\n 'issueCommentDeleted',\n 'pullRequestOpened',\n 'pullRequestUpdated',\n 'pullRequestCommentCreated',\n 'pullRequestReviewRequested',\n 'pullRequestReviewSubmitted',\n 'pullRequestMerged',\n 'pullRequestClosed',\n] as const;\nexport type FactoryGithubEventName = (typeof FACTORY_GITHUB_EVENTS)[number];\n\nexport const FACTORY_GITLAB_EVENTS = [\n 'issueOpened',\n 'issueUpdated',\n 'issueClosed',\n 'issueReopened',\n 'issueCommented',\n 'mergeRequestOpened',\n 'mergeRequestUpdated',\n 'mergeRequestCommented',\n 'mergeRequestMerged',\n 'mergeRequestClosed',\n] as const;\nexport type FactoryGitLabEventName = (typeof FACTORY_GITLAB_EVENTS)[number];\n\nexport const FACTORY_LINEAR_EVENTS = ['issueObserved', 'issueClosed'] as const;\nexport type FactoryLinearEventName = (typeof FACTORY_LINEAR_EVENTS)[number];\n\nexport const FACTORY_JIRA_EVENTS = ['issueObserved', 'issueClosed'] as const;\nexport type FactoryJiraEventName = (typeof FACTORY_JIRA_EVENTS)[number];\n\nexport const FACTORY_INCIDENTIO_EVENTS = ['followUpObserved', 'followUpClosed'] as const;\nexport type FactoryIncidentioEventName = (typeof FACTORY_INCIDENTIO_EVENTS)[number];\n\nexport type FactoryRuleJsonValue =\n | null\n | boolean\n | number\n | string\n | FactoryRuleJsonValue[]\n | { [key: string]: FactoryRuleJsonValue };\n\nexport interface FactoryRuleItemContext {\n workItem: WorkItemRow;\n id: string;\n source: WorkItemSource;\n sourceKey: string | null;\n parentWorkItemId: string | null;\n title: string;\n url: string | null;\n stages: readonly string[];\n /**\n * @deprecated Factory no longer records triage acceptance; this is the value stamped on older\n * cards, and `null` for every card since. A person moving the card on is the approval.\n */\n acceptedAt: Date | null;\n /** Factory-owned process state and trust stamps. */\n metadata: Record<string, unknown> | null;\n}\n\nexport type FactoryRuleActor =\n | { type: 'human'; id: string }\n | { type: 'agent'; bindingId: string; role: string }\n | { type: 'github'; login: string; trusted: boolean; factoryAuthored: boolean }\n | { type: 'gitlab'; username: string; trusted: boolean; factoryAuthored: boolean }\n | { type: 'system'; id: string };\n\nexport interface FactoryRuleIngressIdentity {\n type: 'human' | 'agent' | 'toolResult' | 'github' | 'gitlab' | 'linear' | 'jira' | 'incidentio' | 'rule';\n id: string;\n}\n\nexport interface FactoryRuleCausalEntry {\n ingressId: string;\n decisionType: FactoryCommitDecision['type'];\n}\n\n/** The phase a card sits in, as its board declares it. */\nexport interface FactoryRulePhaseContext {\n id: string;\n kind: 'resting' | 'working' | 'terminal';\n /** Session context a working phase runs in; absent for resting and terminal phases. */\n context?: string;\n /** @deprecated Use `context`. */\n role?: string;\n /** Phases the card may move to from here. */\n nextPhases: readonly string[];\n}\n\nexport interface FactoryRuleContextBase {\n tenant: { orgId: string; projectId: string };\n actor: FactoryRuleActor;\n ingress: FactoryRuleIngressIdentity;\n cause: string;\n causalChain: readonly FactoryRuleCausalEntry[];\n configVersion: string;\n}\n\nexport interface FactoryBoundRuleContext extends FactoryRuleContextBase {\n item: FactoryRuleItemContext;\n board: FactoryRuleBoard;\n itemRevision: number;\n}\n\nexport interface FactoryStageRuleContext extends FactoryBoundRuleContext {\n source: FactoryRuleSource;\n stage: FactoryRuleStage;\n fromStage: FactoryRuleStage;\n toStage: FactoryRuleStage;\n}\n\nexport interface FactoryToolResultRuleContext extends FactoryBoundRuleContext {\n toolName: string;\n threadId: string;\n assistantMessageId: string;\n toolCallId: string;\n result: {\n status: 'success' | 'error';\n value: FactoryRuleJsonValue;\n };\n}\n\nexport interface FactoryGithubRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Where a new card is filed before the project's intake routes place it. */\n intake?: FactoryRuleIntakeTarget;\n /**\n * Set on the one evaluation per pull request delivery that files the pull\n * request's own Review card. Opening a pull request concerns two cards — that\n * Review card and the Work item that authored the pull request — so the rule\n * answers for the two separately: the arrival carries this flag and is\n * committed against the authoring item when resolution found one, which is\n * what links the new card to it, while the authoring item's own evaluation\n * leaves the flag unset.\n */\n pullRequestIntake?: boolean;\n /**\n * Set on both evaluations of a pull request's first sighting when it belongs on an existing\n * card: the Work card that authored it (`authored`), or the card of the issue a trusted author's\n * pull request says it closes (`closes`). The pull request is filed on that card as one more\n * source rather than on a card of its own.\n */\n pullRequestHome?: FactoryPullRequestHome;\n event: FactoryGithubEventName;\n deliveryId: string;\n factory: { createdAt: string };\n /** `installationId` is the GitHub App installation the delivery arrived through. */\n repository: { id: number; fullName: string; installationId?: number };\n issue?: {\n number: number;\n title: string;\n url: string;\n createdAt?: string;\n updatedAt?: string;\n assignees?: string[];\n labels?: string[];\n state?: 'open' | 'closed';\n author?: string;\n /** GitHub close reason: `completed`, `not_planned`, or `duplicate`. */\n stateReason?: string;\n };\n issueChange?: { title: boolean; body: boolean };\n issueComment?: {\n id: number;\n body?: string;\n url?: string;\n author?: string;\n authorType?: string;\n createdAt?: string;\n updatedAt?: string;\n };\n pullRequest?: {\n number: number;\n title: string;\n url: string;\n createdAt?: string;\n state: 'open' | 'closed';\n draft: boolean;\n merged: boolean;\n assignees?: string[];\n requestedReviewers?: string[];\n labels?: string[];\n author?: string;\n factoryAuthored: boolean;\n headBranch: string;\n /** Lowercase head commit SHA, when the delivery carries one. */\n headSha?: string;\n baseBranch: string;\n };\n /** Present on `pullRequestReviewRequested`: who review was (re-)requested from. */\n reviewRequest?: { reviewer: string; factoryReviewer: boolean };\n /** Present when a PR comment uses Factory's exact review command. */\n reviewCommand?: { command: 'review' | 're-review'; target: string };\n /**\n * Present on `pullRequestReviewSubmitted`: the review that was just posted, or a\n * request-changes review whose body was edited to a new Factory verdict.\n */\n review?: { id: number; state: string; url: string; author?: string; body?: string };\n}\n\n/**\n * Where an integration files a new card: the default board's initial phase. The project's intake\n * routes then decide where the card goes; the board and phase a rule names don't. Absent when the\n * default board is not installed.\n */\nexport interface FactoryRuleIntakeTarget {\n board: string;\n initialPhase: string;\n}\n\n/**\n * Where a source-closed rule moves the card, from the `sourceClosed` mapping its installed board\n * declares. Absent when the card's board is not installed or declares no mapping.\n */\nexport interface FactoryRuleBoardClosure {\n /** Title of the card's board, for messages. */\n boardTitle: string;\n /** Terminal phase for a source that was completed. */\n completed: FactoryRuleBoardClosurePhase;\n /** Terminal phase for a source that was canceled or not planned. */\n canceled: FactoryRuleBoardClosurePhase;\n /** Whether the card already sits in a terminal phase of its board. */\n itemTerminal: boolean;\n}\n\nexport interface FactoryRuleBoardClosurePhase {\n phase: string;\n title: string;\n}\n\n/**\n * The phases a card's board runs its pull request loop through, read from what each phase declares\n * (see `boardFlow`). Every field is absent when the board has no such phase.\n */\nexport interface FactoryRuleBoardFlow {\n /** Where a card on the board rests before work starts and goes back to when its pull request is abandoned. */\n readonly initialPhase?: string;\n /** Phase that takes pull requests: reviews them, records verdicts on them, and re-reviews pushes. */\n readonly pullRequestReview?: string;\n /** Working phase that sorts new cards before anyone accepts them: on a board that builds, the first one that neither builds nor reviews. */\n readonly triage?: string;\n /** Working phase that reviews the builder's branch before a pull request opens. */\n readonly selfReview?: string;\n /** Working phase that builds the change and opens the pull request. */\n readonly build?: string;\n /** Seat that runs {@link build}; pull request feedback wakes it. */\n readonly buildRole?: string;\n /** Terminal phase a merge finishes the card in: the board's `sourceClosed.completed`, else its first terminal phase. */\n readonly completed?: Readonly<FactoryRuleBoardClosurePhase>;\n /** Terminal phase a pull request closed unmerged ends its own card in: `sourceClosed.canceled`, else the next terminal phase. */\n readonly canceled?: Readonly<FactoryRuleBoardClosurePhase>;\n}\n\nexport interface FactoryGitLabRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n intake?: FactoryRuleIntakeTarget;\n /** Set on a merge request's first sighting when it is filed on an existing card instead of its own. */\n pullRequestHome?: FactoryPullRequestHome;\n event: FactoryGitLabEventName;\n deliveryId: string;\n factory: { createdAt: string };\n repository: { id: number; fullName: string; host: string };\n issue?: {\n number: number;\n sourceKey: string;\n title: string;\n url: string;\n createdAt?: string;\n updatedAt?: string;\n assignees?: string[];\n labels?: string[];\n labelColors?: Record<string, string>;\n state?: 'open' | 'closed';\n author?: string;\n authorTrusted: boolean;\n };\n note?: {\n id: number;\n body?: string;\n url?: string;\n author?: string;\n createdAt?: string;\n updatedAt?: string;\n };\n mergeRequest?: {\n number: number;\n sourceKey: string;\n title: string;\n url: string;\n createdAt?: string;\n state: 'open' | 'closed';\n draft: boolean;\n merged: boolean;\n assignees?: string[];\n reviewers?: string[];\n labels?: string[];\n labelColors?: Record<string, string>;\n author?: string;\n authorTrusted: boolean;\n factoryAuthored: boolean;\n headBranch: string;\n baseBranch: string;\n };\n}\n\nexport interface FactoryLinearRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Where a new card is filed before the project's intake routes place it. */\n intake?: FactoryRuleIntakeTarget;\n event: FactoryLinearEventName;\n issue: {\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n creator: string | null;\n team: string | null;\n labels: readonly string[];\n createdAt: string;\n updatedAt: string;\n sourceId?: string | null;\n projectId?: string | null;\n };\n}\n\nexport interface FactoryJiraRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Where a new card is filed before the project's intake routes place it. */\n intake?: FactoryRuleIntakeTarget;\n event: FactoryJiraEventName;\n issue: {\n /** Stable issue reference — the direct integration's Jira id or the Platform-encoded issue reference. */\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n author: string | null;\n project: string | null;\n site: string | null;\n labels: readonly string[];\n createdAt: string;\n updatedAt: string;\n };\n}\n\nexport interface FactoryIncidentioRuleContext extends FactoryRuleContextBase {\n /** The status change this delivery reports, named the same for every provider; absent for other events. */\n boardEvent?: BoardEventFacts;\n item?: FactoryRuleItemContext;\n board?: FactoryRuleBoard;\n itemRevision?: number;\n /** Where the card's board sends it when its tracked source closes. */\n boardClosure?: FactoryRuleBoardClosure;\n /** The phases the card's board runs its pull request loop through; absent without a card. */\n flow?: FactoryRuleBoardFlow;\n /** What the card's current phase means on its board; absent without a card or when the board does not declare the phase. */\n phase?: FactoryRulePhaseContext;\n /** Where a new card is filed before the project's intake routes place it. */\n intake?: FactoryRuleIntakeTarget;\n event: FactoryIncidentioEventName;\n issue: {\n /** Stable item reference — the prefixed incident.io follow-up id the intake feed serves as `id`. */\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n author: string | null;\n /** Reference of the incident this follow-up belongs to, when available. */\n incident: string | null;\n labels: readonly string[];\n createdAt: string;\n updatedAt: string;\n };\n}\n\nexport type FactoryRuleHandler<TContext> = (\n context: Readonly<TContext>,\n) => FactoryRuleDecision | void | Promise<FactoryRuleDecision | void>;\n\nexport type FactoryRuleRejectionCode =\n | 'forbidden'\n | 'invalid_transition'\n | 'missing_binding'\n | 'stale'\n | 'timeout'\n | 'rule_error'\n | 'causal_depth_exceeded'\n | 'repeated_transition'\n | 'approval_required';\n\nexport interface FactoryRuleRejectDecision {\n type: 'reject';\n code: FactoryRuleRejectionCode;\n reason: string;\n}\n\ninterface FactoryCommitDecisionBase {\n idempotencyKey: string;\n}\n\nexport interface FactoryTransitionDecision extends FactoryCommitDecisionBase {\n type: 'transition';\n board: FactoryRuleBoard;\n stage: FactoryRuleStage;\n /**\n * Delivered to the item's active session (waking it if idle) after the\n * transition commits. Skipped when the item has no active run binding, so\n * informational messages never fail the transition.\n */\n message?: { text: string; role?: string };\n /**\n * Runs the stage's entry rules even when the item is already in that stage.\n * A transition to the current stage is normally inert, because most callers\n * are correcting a board into a state it already holds. Re-entry is for the\n * opposite case: the stage's work is in flight and has been invalidated, so\n * it has to start over.\n */\n reenter?: boolean;\n /**\n * The status event this move answers. The project's intake routes on the card's board then\n * decide where the card goes instead, and this move applies only when no route on the board\n * handles the event; a route that does, even a disabled one, owns it. Factory drops the tag\n * from a decision returned by an explicit override on the integration's `rules`, so that\n * override's move always applies; a board handler's tagged move still goes to the routes.\n */\n event?: BoardEventFacts;\n}\n\n/**\n * Hands a status event on an existing card to the project's intake routes: the first enabled\n * route on the card's board whose `on` names the event and whose `when` matches moves the card.\n * Integrations add it when no rule decided anything for the delivery; nothing moves when no\n * route matches.\n */\nexport interface FactoryRouteEventDecision extends FactoryCommitDecisionBase {\n type: 'routeEvent';\n event: BoardEventFacts;\n}\n\n/**\n * Tells the card's live session that its source saw activity, such as a new\n * comment or an edit. It carries pointers only: the dispatcher writes the\n * message from these fields, so no provider text (a comment body, a title)\n * ever reaches the session through it. Without a live session it is dropped.\n */\nexport interface FactorySignalActivityDecision extends FactoryCommitDecisionBase {\n type: 'signalActivity';\n event: ActivityEvent;\n /** The source's own reference, such as `acme/app#12`. */\n reference: string;\n url: string;\n author?: string;\n authorTrusted: boolean;\n /**\n * What an idle session does with it. Defaults to `wake`; `persist` leaves it\n * in the session's notifications without starting a run, for sources whose\n * own comments Factory cannot tell apart from other people's. Activity from an\n * untrusted author always persists.\n */\n idleBehavior?: 'wake' | 'persist';\n}\n\n/** The existing card a pull or merge request is filed on; see `pullRequestHome`. */\nexport interface FactoryPullRequestHome {\n workItemId: string;\n reason: 'authored' | 'closes';\n}\n\nexport interface FactoryUpsertLinkedWorkItemDecision extends FactoryCommitDecisionBase {\n type: 'upsertLinkedWorkItem';\n board: FactoryRuleBoard;\n source: WorkItemSource;\n sourceKey: string;\n title: string;\n url: string | null;\n stage: FactoryRuleStage;\n /**\n * File the card at `stage` as its first entry and run none of the board's\n * phase rules for it — no arrival, no destination entry. The card is filed\n * (or, if it already exists, moved) and left parked for a person; nothing is\n * started for it. For external records that arrive already past the board's\n * first step: a GitHub issue whose triage is already recorded, for instance.\n *\n * Placement is the whole decision. An existing card it reaches is moved to\n * that stage through the same relocation the label routes use, and its\n * metadata is left alone.\n */\n skipRules?: boolean;\n /**\n * File the pull or merge request on this existing card, the one that authored it, as one more\n * source instead of on a card of its own. Applies only when no card holds the record yet and\n * the card is still open on Work; otherwise the record is filed as usual.\n */\n attachTo?: { workItemId: string };\n /**\n * The card of the issue this pull or merge request closes. When no card holds the record yet,\n * the project's intake routes can test that card and join the record to it (see\n * `IntakeRouteTarget.joinClosedIssue`); otherwise it is filed as usual.\n */\n closesIssue?: { workItemId: string };\n metadata?: Record<string, FactoryRuleJsonValue>;\n}\n\ninterface FactoryInvokeSkillDecisionBase extends FactoryCommitDecisionBase {\n type: 'invokeSkill';\n role: string;\n arguments?: string;\n precedingMessage?: string;\n cancelInFlight?: boolean;\n /**\n * Start this run even when the card was moved by the agent already running in\n * this role's session. The prompt is queued onto that agent's run, so a phase\n * that shares its context with the one before it still gets its own work.\n * Without it, an agent's own move into a phase of its role starts nothing.\n */\n startsAfterOwnMove?: boolean;\n /**\n * Pursue the run's work as a goal: the session's thread holds `objective` until the card\n * leaves the phase, and the agent's goal judge keeps the run going until it is met.\n */\n goal?: { objective: string; maxRuns?: number };\n}\n\n/**\n * Starting an agent run. Most runs activate a skill, because the skill carries\n * the handoff contract later rules match on. A run whose completion is already\n * signalled some other way — Building finishes by opening a pull request, which\n * arrives as its own event — needs no contract, so it can carry a plain prompt\n * instead of an otherwise empty skill.\n */\nexport type FactoryInvokeSkillDecision = FactoryInvokeSkillDecisionBase &\n (\n | {\n skillName: string;\n prompt?: never;\n /**\n * Same-stage re-entry: the skill is already active in the card's live session,\n * so deliver a compact continuation that references it by name and carries only\n * the fresh arguments, instead of re-pasting the whole skill document. Only valid\n * for named-skill decisions — a plain prompt run has no active skill to resume.\n */\n resume?: boolean;\n }\n | { prompt: string; skillName?: never; resume?: never }\n );\n\nexport interface FactorySendMessageDecision extends FactoryCommitDecisionBase {\n type: 'sendMessage';\n /** Omitted: the card's live session, whichever seat holds it. Required with `prepareBinding`. */\n role?: string;\n message: string;\n priority?: 'medium' | 'high' | 'urgent';\n idleBehavior?: 'persist' | 'wake';\n prepareBinding?: boolean;\n}\n\nexport interface FactoryNotifyDecision extends FactoryCommitDecisionBase {\n type: 'notify';\n title: string;\n body?: string;\n level?: 'info' | 'warning' | 'error';\n}\n\n/**\n * Dismisses Factory change requests an approval has superseded on a GitHub\n * pull request. Only reviews carrying Factory's `Verdict: request changes`\n * marker from an identity other than the approving one are dismissed.\n */\nexport interface FactoryDismissStaleReviewsDecision extends FactoryCommitDecisionBase {\n type: 'dismissStaleReviews';\n installationId: number;\n repository: string;\n pullRequestNumber: number;\n approvingReviewId: string;\n approvingAuthor: string;\n}\n\nexport type FactoryCommitDecision =\n | FactoryTransitionDecision\n | FactoryRouteEventDecision\n | FactorySignalActivityDecision\n | FactoryDismissStaleReviewsDecision\n | FactoryUpsertLinkedWorkItemDecision\n | FactoryInvokeSkillDecision\n | FactorySendMessageDecision\n | FactoryNotifyDecision;\n\nexport type FactoryRuleDecision = FactoryRuleRejectDecision | FactoryCommitDecision;\n\nexport interface FactoryTransitionResultAccepted {\n status: 'accepted';\n transitionId: string;\n itemId: string;\n revision: number;\n stage: FactoryRuleStage;\n decisions: FactoryCommitDecision[];\n}\n\nexport interface FactoryTransitionResultRejected {\n status: 'rejected';\n transitionId: string;\n itemId: string;\n code: FactoryRuleRejectionCode;\n reason: string;\n}\n\nexport type FactoryTransitionResult = FactoryTransitionResultAccepted | FactoryTransitionResultRejected;\n\nexport function factoryRuleSourceForWorkItem(source: WorkItemSource): FactoryRuleSource {\n switch (source) {\n case 'github-issue':\n return 'issue';\n case 'github-pr':\n return 'pullRequest';\n case 'gitlab-issue':\n return 'gitlabIssue';\n case 'gitlab-pr':\n return 'gitlabPullRequest';\n case 'linear-issue':\n return 'linearIssue';\n case 'jira-issue':\n return 'jiraIssue';\n case 'incidentio-follow-up':\n return 'incidentioFollowUp';\n case 'manual':\n return 'manual';\n }\n}\n"],"mappings":";AAcA,SAAgB,0BACd,QACA,WACA,KACwB;CACxB,MAAM,CAAC,eAAe,QACpB,WAAW,cACP,CAAC,UAAU,cAAc,IACzB,WAAW,iBACT,CAAC,UAAU,OAAO,IAClB,WAAW,cACT,CAAC,UAAU,cAAc,IACzB,WAAW,iBACT,CAAC,UAAU,OAAO,IAClB,WAAW,iBACT,CAAC,UAAU,OAAO,IAClB,WAAW,eACT,CAAC,QAAQ,OAAO,IAChB,WAAW,yBACT,CAAC,cAAc,OAAO,IACtB,CAAC,WAAW,QAAQ;CACtC,OAAO;EAAE;EAAe;EAAM,YAAY;EAAW,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;CAAG;AAC/E;;AAGA,MAAa,uBAAuB;;AAGpC,MAAa,0BAA0B;AACvC,MAAa,qBAAqB;AAKlC,SAAgB,cACd,MACA,kBACS;CACT,MAAM,SAAS,KAAK,SAAS;CAC7B,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO;CACnC,OACE,OAAO,MAAK,UAAS,OAAO,UAAU,YAAY,MAAM,YAAY,MAAA,wBAA0B,MAC7F,KAAK,UAAU,CAAC,EAAA,CAAG,MAAM,gBAAgB;AAE9C;AAEA,SAAgB,eAAe,QAAuD;CACpF,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,kBAAkB,UAAU,OAAO;CAC9C,IAAI,OAAO,kBAAkB,UAAU,OAAO,OAAO,SAAS,iBAAiB,cAAc;CAC7F,IAAI,OAAO,kBAAkB,QAAQ,OAAO;CAC5C,IAAI,OAAO,kBAAkB,cAAc,OAAO;CAIlD,IAAI,OAAO,kBAAkB,UAAU,OAAO;CAC9C,OAAO,OAAO,SAAS,iBAAiB,cAAc;AACxD;;AAGA,SAAgB,cAAc,UAA+D;CAC3F,OAAO,UAAU,kBAAkB,QAAQ,UAAU,oBAAoB;AAC3E;AAIA,SAAgB,mBAAmB,MAA6E;CAC9G,IAAI,CAAC;EAAC;EAAa;EAAgB;EAAa;CAAc,CAAC,CAAC,SAAS,KAAK,MAAM,GAAG,OAAO;CAC9F,OAAO,CAAC,cAAc,KAAK,QAAQ;AACrC;AAEA,SAAgB,2BAA2B,MAG/B;CACV,OAAO,mBAAmB;EAAE,QAAQ,eAAe,KAAK,cAAc;EAAG,UAAU,KAAK;CAAS,CAAC;AACpG;AAKA,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,SAAgB,oBAAoB,OAA4C;CAC9E,OAAO,OAAO,UAAU,YAAY,qBAAqB,MAAK,SAAQ,SAAS,KAAK;AACtF;AAKA,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB,CAAC,iBAAiB,aAAa;AAGpE,MAAa,sBAAsB,CAAC,iBAAiB,aAAa;AAGlE,MAAa,4BAA4B,CAAC,oBAAoB,gBAAgB;AAqnB9E,SAAgB,6BAA6B,QAA2C;CACtF,QAAQ,QAAR;EACE,KAAK,gBACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,cACH,OAAO;EACT,KAAK,wBACH,OAAO;EACT,KAAK,UACH,OAAO;CACX;AACF"}
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import type { RequestContext } from '@mastra/core/request-context';
|
|
2
2
|
import type { ProjectBoardSource } from '../boards/project-boards.js';
|
|
3
3
|
import type { BoardRegistry } from '../boards/registry.js';
|
|
4
|
-
import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
|
|
5
4
|
import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
6
5
|
/**
|
|
7
6
|
* The head self-review approved for the session's card, which a change request must open at.
|
|
@@ -11,7 +10,6 @@ import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
|
11
10
|
export declare function selfReviewApprovedHead(options: {
|
|
12
11
|
requestContext: RequestContext | undefined;
|
|
13
12
|
workItems: WorkItemsStorage;
|
|
14
|
-
projects: FactoryProjectsStorage;
|
|
15
13
|
boards: BoardRegistry | ProjectBoardSource;
|
|
16
14
|
}): Promise<string | null | undefined>;
|
|
17
15
|
//# sourceMappingURL=self-review-gate.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"self-review-gate.d.ts","sourceRoot":"","sources":["../../src/session/self-review-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"self-review-gate.d.ts","sourceRoot":"","sources":["../../src/session/self-review-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;CAC5C,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAerC"}
|
|
@@ -9,7 +9,7 @@ import { workItemSource } from "../rules/types.js";
|
|
|
9
9
|
* `null` blocks it until self-review approves.
|
|
10
10
|
*/
|
|
11
11
|
async function selfReviewApprovedHead(options) {
|
|
12
|
-
const { requestContext, workItems
|
|
12
|
+
const { requestContext, workItems } = options;
|
|
13
13
|
const resolution = await resolveFactorySessionAddress({
|
|
14
14
|
requestContext,
|
|
15
15
|
storage: workItems
|
|
@@ -26,13 +26,6 @@ async function selfReviewApprovedHead(options) {
|
|
|
26
26
|
if (cardBoardFlow(boards, item).selfReview === void 0) return void 0;
|
|
27
27
|
if (isPullRequestCard({ source: workItemSource(item.externalSource) })) return void 0;
|
|
28
28
|
if (typeof item.metadata?.openPullRequestNumber === "number") return void 0;
|
|
29
|
-
if (item.metadata?.selfReviewVerdict === void 0) {
|
|
30
|
-
await projects.ensureReady();
|
|
31
|
-
if (!(await projects.get({
|
|
32
|
-
orgId: binding.orgId,
|
|
33
|
-
id: binding.factoryProjectId
|
|
34
|
-
}))?.selfReviewEnabled) return void 0;
|
|
35
|
-
}
|
|
36
29
|
const sha = item.metadata?.selfReviewedHeadSha;
|
|
37
30
|
return item.metadata?.selfReviewVerdict === "approve" && typeof sha === "string" ? sha : null;
|
|
38
31
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"self-review-gate.js","names":[],"sources":["../../src/session/self-review-gate.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\n\nimport { toBoardSource } from '../boards/project-boards.js';\nimport type { ProjectBoardSource } from '../boards/project-boards.js';\nimport type { BoardRegistry } from '../boards/registry.js';\nimport { cardBoardFlow, isPullRequestCard } from '../boards/semantics.js';\nimport { resolveFactorySessionAddress } from '../rules/binding-context.js';\nimport { workItemSource } from '../rules/types.js';\nimport type {
|
|
1
|
+
{"version":3,"file":"self-review-gate.js","names":[],"sources":["../../src/session/self-review-gate.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\n\nimport { toBoardSource } from '../boards/project-boards.js';\nimport type { ProjectBoardSource } from '../boards/project-boards.js';\nimport type { BoardRegistry } from '../boards/registry.js';\nimport { cardBoardFlow, isPullRequestCard } from '../boards/semantics.js';\nimport { resolveFactorySessionAddress } from '../rules/binding-context.js';\nimport { workItemSource } from '../rules/types.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\n/**\n * The head self-review approved for the session's card, which a change request must open at.\n * `undefined` leaves the change request ungated (the card's board has no self-review phase);\n * `null` blocks it until self-review approves.\n */\nexport async function selfReviewApprovedHead(options: {\n requestContext: RequestContext | undefined;\n workItems: WorkItemsStorage;\n boards: BoardRegistry | ProjectBoardSource;\n}): Promise<string | null | undefined> {\n const { requestContext, workItems } = options;\n const resolution = await resolveFactorySessionAddress({ requestContext, storage: workItems });\n if (!resolution) return undefined;\n const binding = resolution.binding ?? (await workItems.findActiveRunBinding(resolution.address));\n if (!binding) return undefined;\n const item = await workItems.get({ orgId: binding.orgId, id: binding.workItemId });\n if (!item) return undefined;\n const boards = await toBoardSource(options.boards).load(binding);\n if (cardBoardFlow(boards, item).selfReview === undefined) return undefined;\n // A pull request's own card is reviewed, never self-reviewed.\n if (isPullRequestCard({ source: workItemSource(item.externalSource) })) return undefined;\n if (typeof item.metadata?.openPullRequestNumber === 'number') return undefined;\n const sha = item.metadata?.selfReviewedHeadSha;\n return item.metadata?.selfReviewVerdict === 'approve' && typeof sha === 'string' ? sha : null;\n}\n"],"mappings":";;;;;;;;;;AAeA,eAAsB,uBAAuB,SAIN;CACrC,MAAM,EAAE,gBAAgB,cAAc;CACtC,MAAM,aAAa,MAAM,6BAA6B;EAAE;EAAgB,SAAS;CAAU,CAAC;CAC5F,IAAI,CAAC,YAAY,OAAO,KAAA;CACxB,MAAM,UAAU,WAAW,WAAY,MAAM,UAAU,qBAAqB,WAAW,OAAO;CAC9F,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,MAAM,OAAO,MAAM,UAAU,IAAI;EAAE,OAAO,QAAQ;EAAO,IAAI,QAAQ;CAAW,CAAC;CACjF,IAAI,CAAC,MAAM,OAAO,KAAA;CAClB,MAAM,SAAS,MAAM,cAAc,QAAQ,MAAM,CAAC,CAAC,KAAK,OAAO;CAC/D,IAAI,cAAc,QAAQ,IAAI,CAAC,CAAC,eAAe,KAAA,GAAW,OAAO,KAAA;CAEjE,IAAI,kBAAkB,EAAE,QAAQ,eAAe,KAAK,cAAc,EAAE,CAAC,GAAG,OAAO,KAAA;CAC/E,IAAI,OAAO,KAAK,UAAU,0BAA0B,UAAU,OAAO,KAAA;CACrE,MAAM,MAAM,KAAK,UAAU;CAC3B,OAAO,KAAK,UAAU,sBAAsB,aAAa,OAAO,QAAQ,WAAW,MAAM;AAC3F"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { RequestContext } from '@mastra/core/request-context';
|
|
2
|
-
import type { VersionControl } from '../capabilities/version-control.js';
|
|
2
|
+
import type { CommitCheck, CommitCheckStatus, VersionControl } from '../capabilities/version-control.js';
|
|
3
3
|
import type { IntegrationTools } from '../integrations/base.js';
|
|
4
4
|
import type { AuditAgentEmitter } from '../storage/domains/audit/domain.js';
|
|
5
5
|
import type { SourceControlStorageHandle } from '../storage/domains/source-control/base.js';
|
|
@@ -16,28 +16,54 @@ export declare function verdictEventMismatch(event: ReviewEvent, body: string |
|
|
|
16
16
|
* disagree, or `undefined` when absent.
|
|
17
17
|
*/
|
|
18
18
|
export declare function reviewedHeadFromBody(body: string | undefined): string | null | undefined;
|
|
19
|
-
|
|
20
|
-
export declare const FACTORY_TEST_CHECK_NAME = "Factory Review / tests";
|
|
21
|
-
export declare function createSourceControlTools({ requestContext, providers, audit, testChecksEnabled, selfReviewApprovedHead, boundChangeRequestId, }: {
|
|
19
|
+
export declare function createSourceControlTools({ requestContext, providers, audit, selfReviewApprovedHead, }: {
|
|
22
20
|
requestContext: RequestContext;
|
|
23
21
|
providers: readonly SourceControlToolProvider[];
|
|
24
22
|
audit: AuditAgentEmitter;
|
|
25
|
-
/** Per-project switch for `source_control_publish_test_check`. The host decides the default; Factory projects default to off. */
|
|
26
|
-
testChecksEnabled?: (input: {
|
|
27
|
-
orgId: string;
|
|
28
|
-
factoryProjectId: string;
|
|
29
|
-
}) => Promise<boolean>;
|
|
30
23
|
/**
|
|
31
24
|
* Self-review gate for opening a change request. `undefined` means the session
|
|
32
25
|
* is not gated (no Work item, or its change request predates Self-review);
|
|
33
26
|
* `null` means Self-review has not approved; a SHA is the approved head.
|
|
34
27
|
*/
|
|
35
28
|
selfReviewApprovedHead?: () => Promise<string | null | undefined>;
|
|
29
|
+
}): Promise<IntegrationTools>;
|
|
30
|
+
/** The change request a Review run reviews, as `MastraFactory.reviewedChangeRequest()` returns it to an app tool. */
|
|
31
|
+
export interface ReviewedChangeRequest {
|
|
32
|
+
/** Source-control integration id, such as `github` or `gitlab`. */
|
|
33
|
+
provider: string;
|
|
34
|
+
/** Repository slug, such as `acme/app`. */
|
|
35
|
+
repository: string;
|
|
36
|
+
/** The pull request or merge request number. */
|
|
37
|
+
changeRequestId: string;
|
|
38
|
+
/** The change request's head when it was read. */
|
|
39
|
+
headSha: string;
|
|
40
|
+
headBranch: string;
|
|
36
41
|
/**
|
|
37
|
-
*
|
|
38
|
-
*
|
|
42
|
+
* Publish a commit check on `headSha`. Refused, with nothing published, when
|
|
43
|
+
* the change request is no longer open, `headSha` is not its current head, or
|
|
44
|
+
* the provider cannot publish commit checks.
|
|
39
45
|
*/
|
|
40
|
-
|
|
41
|
-
}
|
|
46
|
+
publishCommitCheck(input: PublishReviewedCommitCheckInput): Promise<CommitCheck>;
|
|
47
|
+
}
|
|
48
|
+
export interface PublishReviewedCommitCheckInput {
|
|
49
|
+
/** Full commit SHA you tested. */
|
|
50
|
+
headSha: string;
|
|
51
|
+
/** Publishing again with the same name updates the check. */
|
|
52
|
+
name: string;
|
|
53
|
+
status: CommitCheckStatus;
|
|
54
|
+
title: string;
|
|
55
|
+
summary: string;
|
|
56
|
+
details?: string;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* The change request the session's Review run is bound to, read from its
|
|
60
|
+
* provider. `undefined` when the session is not a Review run bound to a
|
|
61
|
+
* change request.
|
|
62
|
+
*/
|
|
63
|
+
export declare function resolveReviewedChangeRequest({ requestContext, providers, boundChangeRequestId, }: {
|
|
64
|
+
requestContext: RequestContext;
|
|
65
|
+
providers: readonly SourceControlToolProvider[];
|
|
66
|
+
boundChangeRequestId: () => Promise<string | undefined>;
|
|
67
|
+
}): Promise<ReviewedChangeRequest | undefined>;
|
|
42
68
|
export {};
|
|
43
69
|
//# sourceMappingURL=source-control-tools.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-control-tools.d.ts","sourceRoot":"","sources":["../../src/session/source-control-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;
|
|
1
|
+
{"version":3,"file":"source-control-tools.d.ts","sourceRoot":"","sources":["../../src/session/source-control-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAIV,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AAUnD,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,0BAA0B,CAAC;IACpC,cAAc,EAAE,cAAc,CAAC;CAChC;AAcD,KAAK,WAAW,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE7D,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrG;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CASxF;AAuJD,wBAAsB,wBAAwB,CAAC,EAC7C,cAAc,EACd,SAAS,EACT,KAAK,EACL,sBAAsB,GACvB,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,KAAK,EAAE,iBAAiB,CAAC;IACzB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4d5B;AAED,qHAAqH;AACrH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,+BAA+B;IAC9C,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,EACjD,cAAc,EACd,SAAS,EACT,oBAAoB,GACrB,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,oBAAoB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACzD,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAmD7C"}
|
|
@@ -144,11 +144,9 @@ async function emitAgentAudit(audit, requestContext, input) {
|
|
|
144
144
|
});
|
|
145
145
|
}
|
|
146
146
|
}
|
|
147
|
-
/** Fixed server-side so an agent cannot publish under, and impersonate, another required check. */
|
|
148
|
-
const FACTORY_TEST_CHECK_NAME = "Factory Review / tests";
|
|
149
147
|
const repositorySchema = z.object({ repository: z.string().trim().min(1).optional() });
|
|
150
148
|
const changeRequestSchema = repositorySchema.extend({ changeRequestId: z.union([z.string().trim().min(1), z.number().int().positive()]) });
|
|
151
|
-
async function createSourceControlTools({ requestContext, providers, audit,
|
|
149
|
+
async function createSourceControlTools({ requestContext, providers, audit, selfReviewApprovedHead }) {
|
|
152
150
|
if (!requestContext || typeof requestContext.get !== "function") return {};
|
|
153
151
|
const controller = requestContext.get("controller");
|
|
154
152
|
const identity = authIdentity(requestContext);
|
|
@@ -557,62 +555,6 @@ async function createSourceControlTools({ requestContext, providers, audit, test
|
|
|
557
555
|
});
|
|
558
556
|
}
|
|
559
557
|
}),
|
|
560
|
-
source_control_publish_test_check: createTool({
|
|
561
|
-
id: "source_control_publish_test_check",
|
|
562
|
-
description: `Publish the Factory review test result as a "${FACTORY_TEST_CHECK_NAME}" commit check on the change request's current head. Publish "in-progress" before running the test plan and a final status after. Refused when headSha is not the current head. ${repositoryArgument}`,
|
|
563
|
-
inputSchema: changeRequestSchema.extend({
|
|
564
|
-
headSha: z.string().trim().regex(/^([0-9a-f]{40}|[0-9a-f]{64})$/i, "headSha must be a full 40- or 64-character commit SHA."),
|
|
565
|
-
status: z.enum([
|
|
566
|
-
"in-progress",
|
|
567
|
-
"success",
|
|
568
|
-
"failure",
|
|
569
|
-
"neutral",
|
|
570
|
-
"cancelled",
|
|
571
|
-
"skipped"
|
|
572
|
-
]),
|
|
573
|
-
title: z.string().trim().min(1),
|
|
574
|
-
summary: z.string().trim().min(1),
|
|
575
|
-
details: z.string().optional()
|
|
576
|
-
}),
|
|
577
|
-
execute: async (input) => {
|
|
578
|
-
const target = await targetFor(input);
|
|
579
|
-
if (testChecksEnabled) {
|
|
580
|
-
const connection = await target.provider.storage.connections.get({
|
|
581
|
-
orgId: target.orgId,
|
|
582
|
-
id: target.projectRepository.connectionId
|
|
583
|
-
});
|
|
584
|
-
if (connection?.factoryProjectId && !await testChecksEnabled({
|
|
585
|
-
orgId: target.orgId,
|
|
586
|
-
factoryProjectId: connection.factoryProjectId
|
|
587
|
-
})) throw new Error("Test check publishing is turned off for this Factory project; nothing was published. Report the test results in the test report comment instead.");
|
|
588
|
-
}
|
|
589
|
-
const publishCommitCheck = target.provider.versionControl.publishCommitCheck;
|
|
590
|
-
if (!publishCommitCheck) throw new Error(`${target.provider.id} does not support publishing commit checks; nothing was published.`);
|
|
591
|
-
const bound = boundChangeRequestId ? await boundChangeRequestId() : void 0;
|
|
592
|
-
if (bound === void 0) throw new Error("Only a Review session bound to this change request can publish test checks; nothing was published.");
|
|
593
|
-
if (bound !== changeRequestId(input.changeRequestId)) throw new Error(`This session reviews change request ${bound}, not ${input.changeRequestId}; nothing was published.`);
|
|
594
|
-
const ref = await reference(target);
|
|
595
|
-
const pullRequest = await target.provider.versionControl.getPullRequest({
|
|
596
|
-
...ref,
|
|
597
|
-
pullRequestId: changeRequestId(input.changeRequestId)
|
|
598
|
-
});
|
|
599
|
-
if (!pullRequest || pullRequest.state !== "open") throw new Error(`Change request ${input.changeRequestId} is not open; nothing was published.`);
|
|
600
|
-
const headSha = input.headSha.toLowerCase();
|
|
601
|
-
if (pullRequest.headSha.toLowerCase() !== headSha) throw new Error(`headSha ${headSha} is not the current change-request head ${pullRequest.headSha}. Nothing was published. Re-run the test plan on the current head.`);
|
|
602
|
-
return publishCommitCheck({
|
|
603
|
-
connection: ref.connection,
|
|
604
|
-
sourceId: ref.sourceId,
|
|
605
|
-
actingUserId: ref.actingUserId,
|
|
606
|
-
headSha,
|
|
607
|
-
ref: pullRequest.headBranch,
|
|
608
|
-
name: FACTORY_TEST_CHECK_NAME,
|
|
609
|
-
status: input.status,
|
|
610
|
-
title: input.title,
|
|
611
|
-
summary: input.summary,
|
|
612
|
-
...input.details !== void 0 ? { details: input.details } : {}
|
|
613
|
-
});
|
|
614
|
-
}
|
|
615
|
-
}),
|
|
616
558
|
source_control_request_reviewers: createTool({
|
|
617
559
|
id: "source_control_request_reviewers",
|
|
618
560
|
description: `Request individual or team reviewers on a pull request or merge request. Provider limitations are returned explicitly. ${repositoryArgument}`,
|
|
@@ -655,6 +597,58 @@ async function createSourceControlTools({ requestContext, providers, audit, test
|
|
|
655
597
|
})
|
|
656
598
|
};
|
|
657
599
|
}
|
|
658
|
-
|
|
600
|
+
/**
|
|
601
|
+
* The change request the session's Review run is bound to, read from its
|
|
602
|
+
* provider. `undefined` when the session is not a Review run bound to a
|
|
603
|
+
* change request.
|
|
604
|
+
*/
|
|
605
|
+
async function resolveReviewedChangeRequest({ requestContext, providers, boundChangeRequestId }) {
|
|
606
|
+
const changeRequestId = await boundChangeRequestId();
|
|
607
|
+
if (changeRequestId === void 0) return void 0;
|
|
608
|
+
const target = await resolveSessionTarget(requestContext, providers);
|
|
609
|
+
const ref = {
|
|
610
|
+
...await target.provider.versionControl.getRepositoryTarget({
|
|
611
|
+
orgId: target.orgId,
|
|
612
|
+
repositoryId: target.repository.id
|
|
613
|
+
}),
|
|
614
|
+
actingUserId: target.userId
|
|
615
|
+
};
|
|
616
|
+
const read = async () => {
|
|
617
|
+
const pullRequest = await target.provider.versionControl.getPullRequest({
|
|
618
|
+
...ref,
|
|
619
|
+
pullRequestId: changeRequestId
|
|
620
|
+
});
|
|
621
|
+
if (!pullRequest || pullRequest.state !== "open") throw new Error(`Change request ${changeRequestId} is not open; nothing was published.`);
|
|
622
|
+
return pullRequest;
|
|
623
|
+
};
|
|
624
|
+
const opened = await read();
|
|
625
|
+
return {
|
|
626
|
+
provider: target.provider.id,
|
|
627
|
+
repository: target.repository.slug,
|
|
628
|
+
changeRequestId,
|
|
629
|
+
headSha: opened.headSha.toLowerCase(),
|
|
630
|
+
headBranch: opened.headBranch,
|
|
631
|
+
publishCommitCheck: async (input) => {
|
|
632
|
+
const publish = target.provider.versionControl.publishCommitCheck;
|
|
633
|
+
if (!publish) throw new Error(`${target.provider.id} does not support publishing commit checks; nothing was published.`);
|
|
634
|
+
const current = await read();
|
|
635
|
+
const headSha = input.headSha.toLowerCase();
|
|
636
|
+
if (current.headSha.toLowerCase() !== headSha) throw new Error(`headSha ${headSha} is not the current change-request head ${current.headSha}. Nothing was published.`);
|
|
637
|
+
return publish({
|
|
638
|
+
connection: ref.connection,
|
|
639
|
+
sourceId: ref.sourceId,
|
|
640
|
+
actingUserId: ref.actingUserId,
|
|
641
|
+
headSha,
|
|
642
|
+
ref: current.headBranch,
|
|
643
|
+
name: input.name,
|
|
644
|
+
status: input.status,
|
|
645
|
+
title: input.title,
|
|
646
|
+
summary: input.summary,
|
|
647
|
+
...input.details !== void 0 ? { details: input.details } : {}
|
|
648
|
+
});
|
|
649
|
+
}
|
|
650
|
+
};
|
|
651
|
+
}
|
|
652
|
+
export { createSourceControlTools, resolveReviewedChangeRequest, reviewedHeadFromBody, verdictEventMismatch };
|
|
659
653
|
|
|
660
654
|
//# sourceMappingURL=source-control-tools.js.map
|