@mastra/factory 0.21.0-alpha.7 → 0.21.0-alpha.9

package/README.md

@@ -117,7 +117,27 @@ const intakeRule = context =>
 
 **Migration:** Remove former global `rules.work` and `rules.review` configuration. Built-in customization is deferred; there is no built-in override or replacement API. Define custom-board handlers on their phases instead. Deployments that relied on automatic issue triage or review proposals on arrival should add an appropriate custom-board handler.
 
-There is no global rules object. Every rule has one owner: boards own lifecycle handlers, transition policy, phase semantics, and tool-result rules; integrations own their event handlers. The runtime only executes rules.
+There is no global rules object. Every rule has one owner: boards own lifecycle handlers, transition policy, phase semantics, tool-result rules, and how their cards react to integration events; integrations own their default event handlers. The runtime only executes rules.
+
+### Closing cards when their source closes
+
+When a tracked GitHub, GitLab, Linear, or Jira issue or incident.io follow-up is closed, the stock integration rules move its card to a terminal phase of the board the card is on. The board declares which phases with `sourceClosed`: `completed` receives sources that were completed, and `canceled` receives sources that were canceled, not planned, or closed as duplicates. GitLab reports no close reason, so its closures always use `completed`. Both entries must name terminal phases.
+
+```typescript
+const releaseBoard = defineBoard({
+  id: 'release',
+  title: 'Release',
+  initialPhase: 'queued',
+  sourceClosed: { completed: 'shipped', canceled: 'dropped' },
+  phases: {
+    queued: { title: 'Queued', kind: 'resting', outcomes: { ship: 'shipped', drop: 'dropped' } },
+    shipped: { title: 'Shipped', kind: 'terminal' },
+    dropped: { title: 'Dropped', kind: 'terminal' },
+  },
+});
+```
+
+Work declares `{ completed: 'done', canceled: 'canceled' }`. A board without `sourceClosed` leaves its cards where they are, and cards already in a terminal phase are never moved. The move is an ordinary transition, so the board must allow it from the card's current phase. Integration rule overrides receive the same targets as `context.boardClosure`.
 
 ### Board tool-result rules
 
@@ -148,6 +168,57 @@ The handler receives the bound item, actor, board, tool name, normalized result,
 
 Work declares one rule: `submit_plan`. When a `plan`-seated agent on a Planning card reports a result starting with `Plan approved.`, the card transitions to Execute. Review declares none. Resolution is fail-closed: a tool result on a card whose board is not installed, or whose board does not declare that tool, fires no rule — a custom board inherits nothing from Work even if it reuses Work's phase names.
 
+### Board event rules
+
+A board can declare how its own cards react to GitHub, GitLab, Linear, Jira, and incident.io events. Declare handlers under `events`, keyed by integration and then by event name:
+
+```ts
+import { defineBoard } from '@mastra/factory';
+
+const deliveryBoard = defineBoard({
+  id: 'delivery',
+  title: 'Delivery',
+  initialPhase: 'triage',
+  phases: {/* ... */},
+  events: {
+    github: {
+      pullRequestMerged: context => ({
+        type: 'sendMessage',
+        idempotencyKey: `${context.ingress.id}:verify-merge`,
+        role: 'work',
+        message: `Pull request #${context.pullRequest?.number} merged. Verify the work is complete.`,
+      }),
+      pullRequestCommentCreated: null,
+    },
+    linear: {
+      issueClosed: context =>
+        context.issue.stateType === 'canceled' && context.phase?.outcomes.includes('canceled')
+          ? {
+              type: 'transition',
+              idempotencyKey: `${context.ingress.id}:canceled`,
+              board: 'delivery',
+              stage: 'canceled',
+            }
+          : undefined,
+    },
+  },
+});
+```
+
+A board handler runs only for events bound to a card on that board. Events without a card yet — issue intake and filing a pull request's own Review card — always use the integration's handlers.
+
+For each event, Factory picks the handler in this order:
+
+1. A handler the deployment set explicitly in the integration's `rules` (for example `new PlatformGithubIntegration({ rules })`). Existing integration-level handlers keep working unchanged.
+2. The card's board handler. `null` switches the event off for cards on that board only; cards on other boards are unaffected.
+3. The integration default.
+
+A board handler that returns a decision replaces the default for that card. One that returns nothing lets the default run, so card-independent defaults such as dismissing stale Factory reviews still apply. The stock Work and Review behavior stays in the integration defaults and never acts on cards on other boards, so a custom board needs no board guards and no delegation to stock handlers.
+
+Every integration rule context bound to a card carries `phase`: `{ id, kind, role?, outcomes }`, describing what the card's current phase means on its board. `outcomes` lists the outcome names the phase declares. `phase` is absent when the card sits in more than one stage or its board does not declare the phase.
+
+Unknown integrations, unknown event names, and handler values other than a function or `null` are rejected by `defineBoard` with a `BoardDefinitionError`.
+
 ### Config version
 
 `configVersion` is an operator-maintained deployment label stamped onto transition audit rows, deferred decisions, reconciler audit, and the session kickoff header (`Config: …`). Nothing branches on it; it exists so an audit row can be traced back to the deployment that produced it. It defaults to `factory-config-v1` and must be a non-empty bounded string. The storage column keeps its shipped name, `rule_set_version`.

package/dist/boards/define-board.d.ts

@@ -1,4 +1,4 @@
-import type { FactoryRuleHandler, FactoryRuleSource, FactoryStageRuleContext, FactoryToolResultRuleContext } from '../rules/types.js';
+import type { FactoryGithubEventName, FactoryGithubRuleContext, FactoryGitLabEventName, FactoryGitLabRuleContext, FactoryIncidentioEventName, FactoryIncidentioRuleContext, FactoryJiraEventName, FactoryJiraRuleContext, FactoryLinearEventName, FactoryLinearRuleContext, FactoryRuleHandler, FactoryRuleSource, FactoryStageRuleContext, FactoryToolResultRuleContext } from '../rules/types.js';
 import type { BoardTransitionPolicy } from './transition-policy.js';
 type BoardPhaseHandlers = Partial<Record<FactoryRuleSource, FactoryRuleHandler<FactoryStageRuleContext>>>;
 type ReadonlyBoardPhaseHandlers = Readonly<BoardPhaseHandlers>;
@@ -8,6 +8,24 @@ export type BoardToolRule = {
     readonly onResult: BoardToolResultRuleHandler;
 };
 export type BoardToolRules = Readonly<Record<string, BoardToolRule>>;
+/**
+ * A board's handler for one integration event. `null` switches the integration default off
+ * for cards on this board only.
+ */
+type BoardEventHandlerMap<EventName extends string, Context> = Readonly<Partial<Record<EventName, FactoryRuleHandler<Context> | null>>>;
+/**
+ * How cards on this board react to integration events, keyed by integration then event.
+ * Consulted for events bound to a card on this board, after any handler the deployment set
+ * explicitly on the integration and before the integration default.
+ */
+export interface BoardEventRules {
+    readonly github?: BoardEventHandlerMap<FactoryGithubEventName, FactoryGithubRuleContext>;
+    readonly gitlab?: BoardEventHandlerMap<FactoryGitLabEventName, FactoryGitLabRuleContext>;
+    readonly linear?: BoardEventHandlerMap<FactoryLinearEventName, FactoryLinearRuleContext>;
+    readonly jira?: BoardEventHandlerMap<FactoryJiraEventName, FactoryJiraRuleContext>;
+    readonly incidentio?: BoardEventHandlerMap<FactoryIncidentioEventName, FactoryIncidentioRuleContext>;
+}
+export type BoardEventIntegration = keyof BoardEventRules;
 type ReadonlyFactoryBoardRules = Readonly<Record<string, Readonly<Partial<Record<FactoryRuleSource, Readonly<{
     onEnter?: FactoryRuleHandler<FactoryStageRuleContext>;
     onExit?: FactoryRuleHandler<FactoryStageRuleContext>;
@@ -40,6 +58,14 @@ export interface BoardTransition<PhaseId extends string> {
     readonly outcome: string | null;
     readonly to: PhaseId;
 }
+/**
+ * Terminal phases a card moves to when its tracked source (issue or follow-up) closes.
+ * `completed` is used when the source was completed, `canceled` when it was canceled or not planned.
+ */
+export type BoardSourceClosed<PhaseId extends string> = Readonly<{
+    completed: PhaseId;
+    canceled: PhaseId;
+}>;
 export interface BoardDefinition<BoardId extends string, PhaseId extends string> {
     readonly id: BoardId;
     readonly title: string;
@@ -49,7 +75,11 @@ export interface BoardDefinition<BoardId extends string, PhaseId extends string>
     readonly rules: ReadonlyFactoryBoardRules;
     /** Tool-result rules keyed by tool name; empty when the board declares none. */
     readonly tools: BoardToolRules;
+    /** Integration event handlers for cards on this board; empty when the board declares none. */
+    readonly events: BoardEventRules;
     readonly transitionPolicy?: BoardTransitionPolicy;
+    /** Where source-closed rules move a card; absent when the board opts out of auto-closing. */
+    readonly sourceClosed?: BoardSourceClosed<PhaseId>;
     allowsTransition(from: PhaseId, to: PhaseId): boolean;
     /** Declared kind of a phase, or undefined when the board has no such phase. */
     phaseKind(phase: string): BoardPhaseKind | undefined;
@@ -66,7 +96,12 @@ type BoardConfig<BoardId extends string, Phases extends Record<string, BoardPhas
     initialPhase: keyof Phases & string;
     phases: Phases;
     tools?: Record<string, BoardToolRule>;
+    events?: BoardEventRules;
     transitionPolicy?: BoardTransitionPolicy;
+    sourceClosed?: {
+        completed: keyof Phases & string;
+        canceled: keyof Phases & string;
+    };
 };
 export declare class BoardDefinitionError extends Error {
     name: string;

package/dist/boards/define-board.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-board.d.ts","sourceRoot":"","sources":["../../src/boards/define-board.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-board.d.ts","sourceRoot":"","sources":["../../src/boards/define-board.ts"],"names":[],"mappings":"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"}

package/dist/boards/define-board.js

@@ -1,5 +1,13 @@
+import { FACTORY_GITHUB_EVENTS, FACTORY_GITLAB_EVENTS, FACTORY_INCIDENTIO_EVENTS, FACTORY_JIRA_EVENTS, FACTORY_LINEAR_EVENTS } from "../rules/types.js";
 import { IDENTIFIER_RE, isBoardIdentifier } from "../rules/validation.js";
 //#region src/boards/define-board.ts
+const BOARD_EVENT_NAMES = {
+	github: FACTORY_GITHUB_EVENTS,
+	gitlab: FACTORY_GITLAB_EVENTS,
+	linear: FACTORY_LINEAR_EVENTS,
+	jira: FACTORY_JIRA_EVENTS,
+	incidentio: FACTORY_INCIDENTIO_EVENTS
+};
 var BoardDefinitionError = class extends Error {
 	name = "BoardDefinitionError";
 };
@@ -35,10 +43,45 @@ function validateToolRules(tools) {
 	}
 	return Object.freeze(frozen);
 }
+function validateSourceClosed(sourceClosed, phases) {
+	if (sourceClosed === void 0) return void 0;
+	if (!isPlainObject(sourceClosed)) throw new BoardDefinitionError("Board sourceClosed must be a plain object.");
+	const keys = Object.keys(sourceClosed);
+	if (keys.length !== 2 || !keys.includes("completed") || !keys.includes("canceled")) throw new BoardDefinitionError("Board sourceClosed must declare exactly completed and canceled.");
+	for (const key of ["completed", "canceled"]) {
+		const phase = sourceClosed[key];
+		if (typeof phase !== "string" || !Object.hasOwn(phases, phase) || phases[phase].kind !== "terminal") throw new BoardDefinitionError(`Board sourceClosed.${key} "${String(phase)}" must name a terminal phase.`);
+	}
+	return Object.freeze({
+		completed: sourceClosed.completed,
+		canceled: sourceClosed.canceled
+	});
+}
+function validateEventRules(events) {
+	if (events === void 0) return Object.freeze({});
+	if (!isPlainObject(events)) throw new BoardDefinitionError("Board events must be a plain object.");
+	const frozen = {};
+	for (const [integration, handlers] of Object.entries(events)) {
+		const known = Object.hasOwn(BOARD_EVENT_NAMES, integration) ? BOARD_EVENT_NAMES[integration] : void 0;
+		if (!known) throw new BoardDefinitionError(`Board events name unknown integration "${integration}".`);
+		if (handlers === void 0) continue;
+		if (!isPlainObject(handlers)) throw new BoardDefinitionError(`Board events for "${integration}" must be a plain object.`);
+		const entries = {};
+		for (const [event, handler] of Object.entries(handlers)) {
+			if (!known.includes(event)) throw new BoardDefinitionError(`Board events for "${integration}" name unknown event "${event}".`);
+			if (handler === void 0) continue;
+			if (handler !== null && typeof handler !== "function") throw new BoardDefinitionError(`Board event handler "${integration}.${event}" must be a function or null.`);
+			entries[event] = handler;
+		}
+		frozen[integration] = Object.freeze(entries);
+	}
+	return Object.freeze(frozen);
+}
 function defineBoard(config) {
 	validateBoardIdentifier(config.id, "Board id");
 	if (config.transitionPolicy !== void 0 && typeof config.transitionPolicy !== "function") throw new BoardDefinitionError("Board transitionPolicy must be a function.");
 	const tools = validateToolRules(config.tools);
+	const events = validateEventRules(config.events);
 	const phaseIds = new Set(Object.keys(config.phases));
 	if (phaseIds.size === 0) throw new BoardDefinitionError("A board must define at least one phase.");
 	if (!phaseIds.has(config.initialPhase)) throw new BoardDefinitionError(`Initial phase "${config.initialPhase}" is not defined.`);
@@ -47,6 +90,7 @@ function defineBoard(config) {
 		validatePhaseSemantics(phaseId, phase);
 	}
 	if (config.phases[config.initialPhase].kind !== "resting") throw new BoardDefinitionError(`Initial phase "${config.initialPhase}" must be a resting phase.`);
+	const sourceClosed = validateSourceClosed(config.sourceClosed, config.phases);
 	const transitions = Object.fromEntries(Object.entries(config.phases).map(([phaseId, phase]) => {
 		if (phase.next !== void 0 && phase.outcomes) throw new BoardDefinitionError(`Phase "${phaseId}" cannot define both next and outcomes.`);
 		const targets = phase.next !== void 0 ? [Object.freeze({
@@ -93,7 +137,9 @@ function defineBoard(config) {
 		transitions: Object.freeze(transitions),
 		rules: Object.freeze(rules),
 		tools,
+		events,
 		...config.transitionPolicy ? { transitionPolicy: config.transitionPolicy } : {},
+		...sourceClosed ? { sourceClosed } : {},
 		allowsTransition(from, to) {
 			return from === to || transitions[from]?.some((transition) => transition.to === to) === true;
 		},

package/dist/boards/define-board.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-board.js","names":[],"sources":["../../src/boards/define-board.ts"],"sourcesContent":["import type {\n  FactoryRuleHandler,\n  FactoryRuleSource,\n  FactoryStageRuleContext,\n  FactoryToolResultRuleContext,\n} from '../rules/types.js';\nimport { IDENTIFIER_RE, isBoardIdentifier, MAX_ROLE_LENGTH, MAX_TOOL_NAME_LENGTH } from '../rules/validation.js';\nimport type { BoardTransitionPolicy } from './transition-policy.js';\n\ntype BoardPhaseHandlers = Partial<Record<FactoryRuleSource, FactoryRuleHandler<FactoryStageRuleContext>>>;\ntype ReadonlyBoardPhaseHandlers = Readonly<BoardPhaseHandlers>;\n\n/** Runs when an agent seated on this board completes the named tool. */\nexport type BoardToolResultRuleHandler = FactoryRuleHandler<FactoryToolResultRuleContext>;\nexport type BoardToolRule = { readonly onResult: BoardToolResultRuleHandler };\nexport type BoardToolRules = Readonly<Record<string, BoardToolRule>>;\n\ntype ReadonlyFactoryBoardRules = Readonly<\n  Record<\n    string,\n    Readonly<\n      Partial<\n        Record<\n          FactoryRuleSource,\n          Readonly<{\n            onEnter?: FactoryRuleHandler<FactoryStageRuleContext>;\n            onExit?: FactoryRuleHandler<FactoryStageRuleContext>;\n          }>\n        >\n      >\n    >\n  >\n>;\n\n/**\n * What a phase means to the runtime.\n * - `resting`: nobody is seated; a card waits for a person or an event.\n * - `working`: an agent in `role` carries the card; a person's move in arms autonomy.\n * - `terminal`: the card is finished; sessions stop and held resources are released.\n */\nexport type BoardPhaseKind = 'resting' | 'working' | 'terminal';\n\ntype BoardPhaseBase<PhaseId extends string> = {\n  readonly title: string;\n  readonly next?: PhaseId;\n  readonly outcomes?: Readonly<Record<string, PhaseId>>;\n  readonly onEnter?: ReadonlyBoardPhaseHandlers;\n  readonly onExit?: ReadonlyBoardPhaseHandlers;\n};\n\nexport type BoardPhaseDefinition<PhaseId extends string> =\n  | (BoardPhaseBase<PhaseId> & { readonly kind: 'resting'; readonly role?: never })\n  | (BoardPhaseBase<PhaseId> & { readonly kind: 'working'; readonly role: string })\n  | (BoardPhaseBase<PhaseId> & { readonly kind: 'terminal'; readonly role?: never });\n\nexport interface BoardTransition<PhaseId extends string> {\n  readonly outcome: string | null;\n  readonly to: PhaseId;\n}\n\nexport interface BoardDefinition<BoardId extends string, PhaseId extends string> {\n  readonly id: BoardId;\n  readonly title: string;\n  readonly initialPhase: PhaseId;\n  readonly phases: Readonly<Record<PhaseId, BoardPhaseDefinition<PhaseId>>>;\n  readonly transitions: Readonly<Record<PhaseId, readonly BoardTransition<PhaseId>[]>>;\n  readonly rules: ReadonlyFactoryBoardRules;\n  /** Tool-result rules keyed by tool name; empty when the board declares none. */\n  readonly tools: BoardToolRules;\n  readonly transitionPolicy?: BoardTransitionPolicy;\n  allowsTransition(from: PhaseId, to: PhaseId): boolean;\n  /** Declared kind of a phase, or undefined when the board has no such phase. */\n  phaseKind(phase: string): BoardPhaseKind | undefined;\n  isWorking(phase: string): boolean;\n  isTerminal(phase: string): boolean;\n  /** Role seated in a working phase; undefined for resting/terminal/unknown phases. */\n  roleForPhase(phase: string): string | undefined;\n  /** First working phase, in declaration order, carried by `role`. */\n  phaseForRole(role: string): PhaseId | undefined;\n}\n\ntype BoardConfig<BoardId extends string, Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>> = {\n  id: BoardId;\n  title: string;\n  initialPhase: keyof Phases & string;\n  phases: Phases;\n  tools?: Record<string, BoardToolRule>;\n  transitionPolicy?: BoardTransitionPolicy;\n};\n\nexport class BoardDefinitionError extends Error {\n  override name = 'BoardDefinitionError';\n}\n\nconst PHASE_KINDS: ReadonlySet<string> = new Set<BoardPhaseKind>(['resting', 'working', 'terminal']);\n\nfunction validateBoardIdentifier(value: unknown, label: string): void {\n  if (!isBoardIdentifier(value)) {\n    throw new BoardDefinitionError(`${label} must be a valid board identifier.`);\n  }\n}\n\nfunction validatePhaseSemantics(phaseId: string, phase: BoardPhaseDefinition<string>): void {\n  if (!PHASE_KINDS.has(phase.kind as string)) {\n    throw new BoardDefinitionError(`Phase \"${phaseId}\" must declare kind 'resting', 'working', or 'terminal'.`);\n  }\n  if (phase.kind === 'working') {\n    const role: unknown = phase.role;\n    if (typeof role !== 'string' || role.length === 0 || role.length > MAX_ROLE_LENGTH || !IDENTIFIER_RE.test(role)) {\n      throw new BoardDefinitionError(`Working phase \"${phaseId}\" must declare a valid role.`);\n    }\n  } else if ((phase as { role?: unknown }).role !== undefined) {\n    throw new BoardDefinitionError(`Phase \"${phaseId}\" is ${phase.kind} and cannot declare a role.`);\n  }\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction validateToolRules(tools: unknown): BoardToolRules {\n  if (tools === undefined) return Object.freeze({});\n  if (!isPlainObject(tools)) throw new BoardDefinitionError('Board tools must be a plain object.');\n  const frozen: Record<string, BoardToolRule> = {};\n  for (const [toolName, leaf] of Object.entries(tools)) {\n    if (toolName.length === 0 || toolName.length > MAX_TOOL_NAME_LENGTH || !IDENTIFIER_RE.test(toolName)) {\n      throw new BoardDefinitionError(`Tool rule \"${toolName}\" has an invalid tool name.`);\n    }\n    if (!isPlainObject(leaf) || Object.keys(leaf).some(key => key !== 'onResult')) {\n      throw new BoardDefinitionError(`Tool rule \"${toolName}\" must be an object with only onResult.`);\n    }\n    if (typeof leaf.onResult !== 'function') {\n      throw new BoardDefinitionError(`Tool rule \"${toolName}\" must declare an onResult function.`);\n    }\n    frozen[toolName] = Object.freeze({ onResult: leaf.onResult as BoardToolResultRuleHandler });\n  }\n  return Object.freeze(frozen);\n}\n\nexport function defineBoard<\n  const BoardId extends string,\n  const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>,\n>(config: BoardConfig<BoardId, Phases>): BoardDefinition<BoardId, keyof Phases & string> {\n  type PhaseId = keyof Phases & string;\n  validateBoardIdentifier(config.id, 'Board id');\n  if (config.transitionPolicy !== undefined && typeof config.transitionPolicy !== 'function') {\n    throw new BoardDefinitionError('Board transitionPolicy must be a function.');\n  }\n  const tools = validateToolRules(config.tools);\n  const phaseIds = new Set(Object.keys(config.phases));\n  if (phaseIds.size === 0) throw new BoardDefinitionError('A board must define at least one phase.');\n  if (!phaseIds.has(config.initialPhase)) {\n    throw new BoardDefinitionError(`Initial phase \"${config.initialPhase}\" is not defined.`);\n  }\n  for (const [phaseId, phase] of Object.entries(config.phases)) {\n    validateBoardIdentifier(phaseId, 'Phase id');\n    validatePhaseSemantics(phaseId, phase);\n  }\n  if (config.phases[config.initialPhase]!.kind !== 'resting') {\n    throw new BoardDefinitionError(`Initial phase \"${config.initialPhase}\" must be a resting phase.`);\n  }\n\n  const transitions = Object.fromEntries(\n    Object.entries(config.phases).map(([phaseId, phase]) => {\n      if (phase.next !== undefined && phase.outcomes) {\n        throw new BoardDefinitionError(`Phase \"${phaseId}\" cannot define both next and outcomes.`);\n      }\n      const targets: BoardTransition<string>[] =\n        phase.next !== undefined\n          ? [Object.freeze({ outcome: null, to: phase.next })]\n          : Object.entries(phase.outcomes ?? {}).map(([outcome, to]) => Object.freeze({ outcome, to }));\n      for (const { to } of targets) {\n        if (!phaseIds.has(to)) {\n          throw new BoardDefinitionError(`Phase \"${phaseId}\" targets undefined phase \"${to}\".`);\n        }\n      }\n      return [phaseId, Object.freeze(targets)];\n    }),\n  ) as Record<PhaseId, readonly BoardTransition<PhaseId>[]>;\n\n  const phases = Object.freeze(\n    Object.fromEntries(\n      Object.entries(config.phases).map(([phaseId, phase]) => [\n        phaseId,\n        Object.freeze({\n          title: phase.title,\n          kind: phase.kind,\n          ...(phase.kind === 'working' ? { role: phase.role } : {}),\n          ...(phase.next !== undefined ? { next: phase.next } : {}),\n          ...(phase.outcomes ? { outcomes: Object.freeze({ ...phase.outcomes }) } : {}),\n          ...(phase.onEnter ? { onEnter: Object.freeze({ ...phase.onEnter }) } : {}),\n          ...(phase.onExit ? { onExit: Object.freeze({ ...phase.onExit }) } : {}),\n        }),\n      ]),\n    ),\n  ) as Readonly<Record<PhaseId, BoardPhaseDefinition<PhaseId>>>;\n  const rules = Object.freeze(\n    Object.fromEntries(\n      Object.entries(config.phases).flatMap(([phaseId, phase]) => {\n        const sources = new Set([...Object.keys(phase.onEnter ?? {}), ...Object.keys(phase.onExit ?? {})]);\n        if (sources.size === 0) return [];\n        return [\n          [\n            phaseId,\n            Object.freeze(\n              Object.fromEntries(\n                [...sources].map(source => [\n                  source,\n                  Object.freeze({\n                    ...(phase.onEnter?.[source as FactoryRuleSource]\n                      ? { onEnter: phase.onEnter[source as FactoryRuleSource] }\n                      : {}),\n                    ...(phase.onExit?.[source as FactoryRuleSource]\n                      ? { onExit: phase.onExit[source as FactoryRuleSource] }\n                      : {}),\n                  }),\n                ]),\n              ),\n            ),\n          ],\n        ];\n      }),\n    ),\n  ) as ReadonlyFactoryBoardRules;\n\n  const kinds = new Map<string, BoardPhaseKind>();\n  const roles = new Map<string, string>();\n  const phaseByRole = new Map<string, PhaseId>();\n  for (const [phaseId, phase] of Object.entries(phases) as [PhaseId, BoardPhaseDefinition<PhaseId>][]) {\n    kinds.set(phaseId, phase.kind);\n    if (phase.kind !== 'working') continue;\n    roles.set(phaseId, phase.role);\n    if (!phaseByRole.has(phase.role)) phaseByRole.set(phase.role, phaseId);\n  }\n\n  return Object.freeze({\n    id: config.id,\n    title: config.title,\n    initialPhase: config.initialPhase,\n    phases,\n    transitions: Object.freeze(transitions),\n    rules: Object.freeze(rules),\n    tools,\n    ...(config.transitionPolicy ? { transitionPolicy: config.transitionPolicy } : {}),\n    allowsTransition(from: PhaseId, to: PhaseId) {\n      return from === to || transitions[from]?.some(transition => transition.to === to) === true;\n    },\n    phaseKind: (phase: string) => kinds.get(phase),\n    isWorking: (phase: string) => kinds.get(phase) === 'working',\n    isTerminal: (phase: string) => kinds.get(phase) === 'terminal',\n    roleForPhase: (phase: string) => roles.get(phase),\n    phaseForRole: (role: string) => phaseByRole.get(role),\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"define-board.js","names":[],"sources":["../../src/boards/define-board.ts"],"sourcesContent":["import {\n  FACTORY_GITHUB_EVENTS,\n  FACTORY_GITLAB_EVENTS,\n  FACTORY_INCIDENTIO_EVENTS,\n  FACTORY_JIRA_EVENTS,\n  FACTORY_LINEAR_EVENTS,\n} from '../rules/types.js';\nimport type {\n  FactoryGithubEventName,\n  FactoryGithubRuleContext,\n  FactoryGitLabEventName,\n  FactoryGitLabRuleContext,\n  FactoryIncidentioEventName,\n  FactoryIncidentioRuleContext,\n  FactoryJiraEventName,\n  FactoryJiraRuleContext,\n  FactoryLinearEventName,\n  FactoryLinearRuleContext,\n  FactoryRuleHandler,\n  FactoryRuleSource,\n  FactoryStageRuleContext,\n  FactoryToolResultRuleContext,\n} from '../rules/types.js';\nimport { IDENTIFIER_RE, isBoardIdentifier, MAX_ROLE_LENGTH, MAX_TOOL_NAME_LENGTH } from '../rules/validation.js';\nimport type { BoardTransitionPolicy } from './transition-policy.js';\n\ntype BoardPhaseHandlers = Partial<Record<FactoryRuleSource, FactoryRuleHandler<FactoryStageRuleContext>>>;\ntype ReadonlyBoardPhaseHandlers = Readonly<BoardPhaseHandlers>;\n\n/** Runs when an agent seated on this board completes the named tool. */\nexport type BoardToolResultRuleHandler = FactoryRuleHandler<FactoryToolResultRuleContext>;\nexport type BoardToolRule = { readonly onResult: BoardToolResultRuleHandler };\nexport type BoardToolRules = Readonly<Record<string, BoardToolRule>>;\n\n/**\n * A board's handler for one integration event. `null` switches the integration default off\n * for cards on this board only.\n */\ntype BoardEventHandlerMap<EventName extends string, Context> = Readonly<\n  Partial<Record<EventName, FactoryRuleHandler<Context> | null>>\n>;\n\n/**\n * How cards on this board react to integration events, keyed by integration then event.\n * Consulted for events bound to a card on this board, after any handler the deployment set\n * explicitly on the integration and before the integration default.\n */\nexport interface BoardEventRules {\n  readonly github?: BoardEventHandlerMap<FactoryGithubEventName, FactoryGithubRuleContext>;\n  readonly gitlab?: BoardEventHandlerMap<FactoryGitLabEventName, FactoryGitLabRuleContext>;\n  readonly linear?: BoardEventHandlerMap<FactoryLinearEventName, FactoryLinearRuleContext>;\n  readonly jira?: BoardEventHandlerMap<FactoryJiraEventName, FactoryJiraRuleContext>;\n  readonly incidentio?: BoardEventHandlerMap<FactoryIncidentioEventName, FactoryIncidentioRuleContext>;\n}\nexport type BoardEventIntegration = keyof BoardEventRules;\n\nconst BOARD_EVENT_NAMES: Readonly<Record<BoardEventIntegration, readonly string[]>> = {\n  github: FACTORY_GITHUB_EVENTS,\n  gitlab: FACTORY_GITLAB_EVENTS,\n  linear: FACTORY_LINEAR_EVENTS,\n  jira: FACTORY_JIRA_EVENTS,\n  incidentio: FACTORY_INCIDENTIO_EVENTS,\n};\n\ntype ReadonlyFactoryBoardRules = Readonly<\n  Record<\n    string,\n    Readonly<\n      Partial<\n        Record<\n          FactoryRuleSource,\n          Readonly<{\n            onEnter?: FactoryRuleHandler<FactoryStageRuleContext>;\n            onExit?: FactoryRuleHandler<FactoryStageRuleContext>;\n          }>\n        >\n      >\n    >\n  >\n>;\n\n/**\n * What a phase means to the runtime.\n * - `resting`: nobody is seated; a card waits for a person or an event.\n * - `working`: an agent in `role` carries the card; a person's move in arms autonomy.\n * - `terminal`: the card is finished; sessions stop and held resources are released.\n */\nexport type BoardPhaseKind = 'resting' | 'working' | 'terminal';\n\ntype BoardPhaseBase<PhaseId extends string> = {\n  readonly title: string;\n  readonly next?: PhaseId;\n  readonly outcomes?: Readonly<Record<string, PhaseId>>;\n  readonly onEnter?: ReadonlyBoardPhaseHandlers;\n  readonly onExit?: ReadonlyBoardPhaseHandlers;\n};\n\nexport type BoardPhaseDefinition<PhaseId extends string> =\n  | (BoardPhaseBase<PhaseId> & { readonly kind: 'resting'; readonly role?: never })\n  | (BoardPhaseBase<PhaseId> & { readonly kind: 'working'; readonly role: string })\n  | (BoardPhaseBase<PhaseId> & { readonly kind: 'terminal'; readonly role?: never });\n\nexport interface BoardTransition<PhaseId extends string> {\n  readonly outcome: string | null;\n  readonly to: PhaseId;\n}\n\n/**\n * Terminal phases a card moves to when its tracked source (issue or follow-up) closes.\n * `completed` is used when the source was completed, `canceled` when it was canceled or not planned.\n */\nexport type BoardSourceClosed<PhaseId extends string> = Readonly<{ completed: PhaseId; canceled: PhaseId }>;\n\nexport interface BoardDefinition<BoardId extends string, PhaseId extends string> {\n  readonly id: BoardId;\n  readonly title: string;\n  readonly initialPhase: PhaseId;\n  readonly phases: Readonly<Record<PhaseId, BoardPhaseDefinition<PhaseId>>>;\n  readonly transitions: Readonly<Record<PhaseId, readonly BoardTransition<PhaseId>[]>>;\n  readonly rules: ReadonlyFactoryBoardRules;\n  /** Tool-result rules keyed by tool name; empty when the board declares none. */\n  readonly tools: BoardToolRules;\n  /** Integration event handlers for cards on this board; empty when the board declares none. */\n  readonly events: BoardEventRules;\n  readonly transitionPolicy?: BoardTransitionPolicy;\n  /** Where source-closed rules move a card; absent when the board opts out of auto-closing. */\n  readonly sourceClosed?: BoardSourceClosed<PhaseId>;\n  allowsTransition(from: PhaseId, to: PhaseId): boolean;\n  /** Declared kind of a phase, or undefined when the board has no such phase. */\n  phaseKind(phase: string): BoardPhaseKind | undefined;\n  isWorking(phase: string): boolean;\n  isTerminal(phase: string): boolean;\n  /** Role seated in a working phase; undefined for resting/terminal/unknown phases. */\n  roleForPhase(phase: string): string | undefined;\n  /** First working phase, in declaration order, carried by `role`. */\n  phaseForRole(role: string): PhaseId | undefined;\n}\n\ntype BoardConfig<BoardId extends string, Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>> = {\n  id: BoardId;\n  title: string;\n  initialPhase: keyof Phases & string;\n  phases: Phases;\n  tools?: Record<string, BoardToolRule>;\n  events?: BoardEventRules;\n  transitionPolicy?: BoardTransitionPolicy;\n  sourceClosed?: { completed: keyof Phases & string; canceled: keyof Phases & string };\n};\n\nexport class BoardDefinitionError extends Error {\n  override name = 'BoardDefinitionError';\n}\n\nconst PHASE_KINDS: ReadonlySet<string> = new Set<BoardPhaseKind>(['resting', 'working', 'terminal']);\n\nfunction validateBoardIdentifier(value: unknown, label: string): void {\n  if (!isBoardIdentifier(value)) {\n    throw new BoardDefinitionError(`${label} must be a valid board identifier.`);\n  }\n}\n\nfunction validatePhaseSemantics(phaseId: string, phase: BoardPhaseDefinition<string>): void {\n  if (!PHASE_KINDS.has(phase.kind as string)) {\n    throw new BoardDefinitionError(`Phase \"${phaseId}\" must declare kind 'resting', 'working', or 'terminal'.`);\n  }\n  if (phase.kind === 'working') {\n    const role: unknown = phase.role;\n    if (typeof role !== 'string' || role.length === 0 || role.length > MAX_ROLE_LENGTH || !IDENTIFIER_RE.test(role)) {\n      throw new BoardDefinitionError(`Working phase \"${phaseId}\" must declare a valid role.`);\n    }\n  } else if ((phase as { role?: unknown }).role !== undefined) {\n    throw new BoardDefinitionError(`Phase \"${phaseId}\" is ${phase.kind} and cannot declare a role.`);\n  }\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction validateToolRules(tools: unknown): BoardToolRules {\n  if (tools === undefined) return Object.freeze({});\n  if (!isPlainObject(tools)) throw new BoardDefinitionError('Board tools must be a plain object.');\n  const frozen: Record<string, BoardToolRule> = {};\n  for (const [toolName, leaf] of Object.entries(tools)) {\n    if (toolName.length === 0 || toolName.length > MAX_TOOL_NAME_LENGTH || !IDENTIFIER_RE.test(toolName)) {\n      throw new BoardDefinitionError(`Tool rule \"${toolName}\" has an invalid tool name.`);\n    }\n    if (!isPlainObject(leaf) || Object.keys(leaf).some(key => key !== 'onResult')) {\n      throw new BoardDefinitionError(`Tool rule \"${toolName}\" must be an object with only onResult.`);\n    }\n    if (typeof leaf.onResult !== 'function') {\n      throw new BoardDefinitionError(`Tool rule \"${toolName}\" must declare an onResult function.`);\n    }\n    frozen[toolName] = Object.freeze({ onResult: leaf.onResult as BoardToolResultRuleHandler });\n  }\n  return Object.freeze(frozen);\n}\n\nfunction validateSourceClosed(\n  sourceClosed: unknown,\n  phases: Readonly<Record<string, BoardPhaseDefinition<string>>>,\n): BoardSourceClosed<string> | undefined {\n  if (sourceClosed === undefined) return undefined;\n  if (!isPlainObject(sourceClosed)) throw new BoardDefinitionError('Board sourceClosed must be a plain object.');\n  const keys = Object.keys(sourceClosed);\n  if (keys.length !== 2 || !keys.includes('completed') || !keys.includes('canceled')) {\n    throw new BoardDefinitionError('Board sourceClosed must declare exactly completed and canceled.');\n  }\n  for (const key of ['completed', 'canceled'] as const) {\n    const phase = sourceClosed[key];\n    if (typeof phase !== 'string' || !Object.hasOwn(phases, phase) || phases[phase]!.kind !== 'terminal') {\n      throw new BoardDefinitionError(`Board sourceClosed.${key} \"${String(phase)}\" must name a terminal phase.`);\n    }\n  }\n  return Object.freeze({ completed: sourceClosed.completed as string, canceled: sourceClosed.canceled as string });\n}\n\nfunction validateEventRules(events: unknown): BoardEventRules {\n  if (events === undefined) return Object.freeze({});\n  if (!isPlainObject(events)) throw new BoardDefinitionError('Board events must be a plain object.');\n  const frozen: Record<string, Readonly<Record<string, unknown>>> = {};\n  for (const [integration, handlers] of Object.entries(events)) {\n    const known = Object.hasOwn(BOARD_EVENT_NAMES, integration)\n      ? BOARD_EVENT_NAMES[integration as BoardEventIntegration]\n      : undefined;\n    if (!known) throw new BoardDefinitionError(`Board events name unknown integration \"${integration}\".`);\n    if (handlers === undefined) continue;\n    if (!isPlainObject(handlers)) {\n      throw new BoardDefinitionError(`Board events for \"${integration}\" must be a plain object.`);\n    }\n    const entries: Record<string, unknown> = {};\n    for (const [event, handler] of Object.entries(handlers)) {\n      if (!known.includes(event)) {\n        throw new BoardDefinitionError(`Board events for \"${integration}\" name unknown event \"${event}\".`);\n      }\n      if (handler === undefined) continue;\n      if (handler !== null && typeof handler !== 'function') {\n        throw new BoardDefinitionError(`Board event handler \"${integration}.${event}\" must be a function or null.`);\n      }\n      entries[event] = handler;\n    }\n    frozen[integration] = Object.freeze(entries);\n  }\n  return Object.freeze(frozen) as BoardEventRules;\n}\n\nexport function defineBoard<\n  const BoardId extends string,\n  const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>,\n>(config: BoardConfig<BoardId, Phases>): BoardDefinition<BoardId, keyof Phases & string> {\n  type PhaseId = keyof Phases & string;\n  validateBoardIdentifier(config.id, 'Board id');\n  if (config.transitionPolicy !== undefined && typeof config.transitionPolicy !== 'function') {\n    throw new BoardDefinitionError('Board transitionPolicy must be a function.');\n  }\n  const tools = validateToolRules(config.tools);\n  const events = validateEventRules(config.events);\n  const phaseIds = new Set(Object.keys(config.phases));\n  if (phaseIds.size === 0) throw new BoardDefinitionError('A board must define at least one phase.');\n  if (!phaseIds.has(config.initialPhase)) {\n    throw new BoardDefinitionError(`Initial phase \"${config.initialPhase}\" is not defined.`);\n  }\n  for (const [phaseId, phase] of Object.entries(config.phases)) {\n    validateBoardIdentifier(phaseId, 'Phase id');\n    validatePhaseSemantics(phaseId, phase);\n  }\n  if (config.phases[config.initialPhase]!.kind !== 'resting') {\n    throw new BoardDefinitionError(`Initial phase \"${config.initialPhase}\" must be a resting phase.`);\n  }\n  const sourceClosed = validateSourceClosed(config.sourceClosed, config.phases) as\n    | BoardSourceClosed<PhaseId>\n    | undefined;\n\n  const transitions = Object.fromEntries(\n    Object.entries(config.phases).map(([phaseId, phase]) => {\n      if (phase.next !== undefined && phase.outcomes) {\n        throw new BoardDefinitionError(`Phase \"${phaseId}\" cannot define both next and outcomes.`);\n      }\n      const targets: BoardTransition<string>[] =\n        phase.next !== undefined\n          ? [Object.freeze({ outcome: null, to: phase.next })]\n          : Object.entries(phase.outcomes ?? {}).map(([outcome, to]) => Object.freeze({ outcome, to }));\n      for (const { to } of targets) {\n        if (!phaseIds.has(to)) {\n          throw new BoardDefinitionError(`Phase \"${phaseId}\" targets undefined phase \"${to}\".`);\n        }\n      }\n      return [phaseId, Object.freeze(targets)];\n    }),\n  ) as Record<PhaseId, readonly BoardTransition<PhaseId>[]>;\n\n  const phases = Object.freeze(\n    Object.fromEntries(\n      Object.entries(config.phases).map(([phaseId, phase]) => [\n        phaseId,\n        Object.freeze({\n          title: phase.title,\n          kind: phase.kind,\n          ...(phase.kind === 'working' ? { role: phase.role } : {}),\n          ...(phase.next !== undefined ? { next: phase.next } : {}),\n          ...(phase.outcomes ? { outcomes: Object.freeze({ ...phase.outcomes }) } : {}),\n          ...(phase.onEnter ? { onEnter: Object.freeze({ ...phase.onEnter }) } : {}),\n          ...(phase.onExit ? { onExit: Object.freeze({ ...phase.onExit }) } : {}),\n        }),\n      ]),\n    ),\n  ) as Readonly<Record<PhaseId, BoardPhaseDefinition<PhaseId>>>;\n  const rules = Object.freeze(\n    Object.fromEntries(\n      Object.entries(config.phases).flatMap(([phaseId, phase]) => {\n        const sources = new Set([...Object.keys(phase.onEnter ?? {}), ...Object.keys(phase.onExit ?? {})]);\n        if (sources.size === 0) return [];\n        return [\n          [\n            phaseId,\n            Object.freeze(\n              Object.fromEntries(\n                [...sources].map(source => [\n                  source,\n                  Object.freeze({\n                    ...(phase.onEnter?.[source as FactoryRuleSource]\n                      ? { onEnter: phase.onEnter[source as FactoryRuleSource] }\n                      : {}),\n                    ...(phase.onExit?.[source as FactoryRuleSource]\n                      ? { onExit: phase.onExit[source as FactoryRuleSource] }\n                      : {}),\n                  }),\n                ]),\n              ),\n            ),\n          ],\n        ];\n      }),\n    ),\n  ) as ReadonlyFactoryBoardRules;\n\n  const kinds = new Map<string, BoardPhaseKind>();\n  const roles = new Map<string, string>();\n  const phaseByRole = new Map<string, PhaseId>();\n  for (const [phaseId, phase] of Object.entries(phases) as [PhaseId, BoardPhaseDefinition<PhaseId>][]) {\n    kinds.set(phaseId, phase.kind);\n    if (phase.kind !== 'working') continue;\n    roles.set(phaseId, phase.role);\n    if (!phaseByRole.has(phase.role)) phaseByRole.set(phase.role, phaseId);\n  }\n\n  return Object.freeze({\n    id: config.id,\n    title: config.title,\n    initialPhase: config.initialPhase,\n    phases,\n    transitions: Object.freeze(transitions),\n    rules: Object.freeze(rules),\n    tools,\n    events,\n    ...(config.transitionPolicy ? { transitionPolicy: config.transitionPolicy } : {}),\n    ...(sourceClosed ? { sourceClosed } : {}),\n    allowsTransition(from: PhaseId, to: PhaseId) {\n      return from === to || transitions[from]?.some(transition => transition.to === to) === true;\n    },\n    phaseKind: (phase: string) => kinds.get(phase),\n    isWorking: (phase: string) => kinds.get(phase) === 'working',\n    isTerminal: (phase: string) => kinds.get(phase) === 'terminal',\n    roleForPhase: (phase: string) => roles.get(phase),\n    phaseForRole: (role: string) => phaseByRole.get(role),\n  });\n}\n"],"mappings":";;;AAwDA,MAAM,oBAAgF;CACpF,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,YAAY;AACd;AAuFA,IAAa,uBAAb,cAA0C,MAAM;CAC9C,OAAgB;AAClB;AAEA,MAAM,8BAAmC,IAAI,IAAoB;CAAC;CAAW;CAAW;AAAU,CAAC;AAEnG,SAAS,wBAAwB,OAAgB,OAAqB;CACpE,IAAI,CAAC,kBAAkB,KAAK,GAC1B,MAAM,IAAI,qBAAqB,GAAG,MAAM,mCAAmC;AAE/E;AAEA,SAAS,uBAAuB,SAAiB,OAA2C;CAC1F,IAAI,CAAC,YAAY,IAAI,MAAM,IAAc,GACvC,MAAM,IAAI,qBAAqB,UAAU,QAAQ,yDAAyD;CAE5G,IAAI,MAAM,SAAS,WAAW;EAC5B,MAAM,OAAgB,MAAM;EAC5B,IAAI,OAAO,SAAS,YAAY,KAAK,WAAW,KAAK,KAAK,SAAA,MAA4B,CAAC,cAAc,KAAK,IAAI,GAC5G,MAAM,IAAI,qBAAqB,kBAAkB,QAAQ,6BAA6B;CAE1F,OAAO,IAAK,MAA6B,SAAS,KAAA,GAChD,MAAM,IAAI,qBAAqB,UAAU,QAAQ,OAAO,MAAM,KAAK,4BAA4B;AAEnG;AAEA,SAAS,cAAc,OAAkD;CACvE,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG,OAAO;CAChF,MAAM,YAAY,OAAO,eAAe,KAAK;CAC7C,OAAO,cAAc,OAAO,aAAa,cAAc;AACzD;AAEA,SAAS,kBAAkB,OAAgC;CACzD,IAAI,UAAU,KAAA,GAAW,OAAO,OAAO,OAAO,CAAC,CAAC;CAChD,IAAI,CAAC,cAAc,KAAK,GAAG,MAAM,IAAI,qBAAqB,qCAAqC;CAC/F,MAAM,SAAwC,CAAC;CAC/C,KAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,KAAK,GAAG;EACpD,IAAI,SAAS,WAAW,KAAK,SAAS,SAAA,OAAiC,CAAC,cAAc,KAAK,QAAQ,GACjG,MAAM,IAAI,qBAAqB,cAAc,SAAS,4BAA4B;EAEpF,IAAI,CAAC,cAAc,IAAI,KAAK,OAAO,KAAK,IAAI,CAAC,CAAC,MAAK,QAAO,QAAQ,UAAU,GAC1E,MAAM,IAAI,qBAAqB,cAAc,SAAS,wCAAwC;EAEhG,IAAI,OAAO,KAAK,aAAa,YAC3B,MAAM,IAAI,qBAAqB,cAAc,SAAS,qCAAqC;EAE7F,OAAO,YAAY,OAAO,OAAO,EAAE,UAAU,KAAK,SAAuC,CAAC;CAC5F;CACA,OAAO,OAAO,OAAO,MAAM;AAC7B;AAEA,SAAS,qBACP,cACA,QACuC;CACvC,IAAI,iBAAiB,KAAA,GAAW,OAAO,KAAA;CACvC,IAAI,CAAC,cAAc,YAAY,GAAG,MAAM,IAAI,qBAAqB,4CAA4C;CAC7G,MAAM,OAAO,OAAO,KAAK,YAAY;CACrC,IAAI,KAAK,WAAW,KAAK,CAAC,KAAK,SAAS,WAAW,KAAK,CAAC,KAAK,SAAS,UAAU,GAC/E,MAAM,IAAI,qBAAqB,iEAAiE;CAElG,KAAK,MAAM,OAAO,CAAC,aAAa,UAAU,GAAY;EACpD,MAAM,QAAQ,aAAa;EAC3B,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,OAAO,QAAQ,KAAK,KAAK,OAAO,MAAM,CAAE,SAAS,YACxF,MAAM,IAAI,qBAAqB,sBAAsB,IAAI,IAAI,OAAO,KAAK,EAAE,8BAA8B;CAE7G;CACA,OAAO,OAAO,OAAO;EAAE,WAAW,aAAa;EAAqB,UAAU,aAAa;CAAmB,CAAC;AACjH;AAEA,SAAS,mBAAmB,QAAkC;CAC5D,IAAI,WAAW,KAAA,GAAW,OAAO,OAAO,OAAO,CAAC,CAAC;CACjD,IAAI,CAAC,cAAc,MAAM,GAAG,MAAM,IAAI,qBAAqB,sCAAsC;CACjG,MAAM,SAA4D,CAAC;CACnE,KAAK,MAAM,CAAC,aAAa,aAAa,OAAO,QAAQ,MAAM,GAAG;EAC5D,MAAM,QAAQ,OAAO,OAAO,mBAAmB,WAAW,IACtD,kBAAkB,eAClB,KAAA;EACJ,IAAI,CAAC,OAAO,MAAM,IAAI,qBAAqB,0CAA0C,YAAY,GAAG;EACpG,IAAI,aAAa,KAAA,GAAW;EAC5B,IAAI,CAAC,cAAc,QAAQ,GACzB,MAAM,IAAI,qBAAqB,qBAAqB,YAAY,0BAA0B;EAE5F,MAAM,UAAmC,CAAC;EAC1C,KAAK,MAAM,CAAC,OAAO,YAAY,OAAO,QAAQ,QAAQ,GAAG;GACvD,IAAI,CAAC,MAAM,SAAS,KAAK,GACvB,MAAM,IAAI,qBAAqB,qBAAqB,YAAY,wBAAwB,MAAM,GAAG;GAEnG,IAAI,YAAY,KAAA,GAAW;GAC3B,IAAI,YAAY,QAAQ,OAAO,YAAY,YACzC,MAAM,IAAI,qBAAqB,wBAAwB,YAAY,GAAG,MAAM,8BAA8B;GAE5G,QAAQ,SAAS;EACnB;EACA,OAAO,eAAe,OAAO,OAAO,OAAO;CAC7C;CACA,OAAO,OAAO,OAAO,MAAM;AAC7B;AAEA,SAAgB,YAGd,QAAuF;CAEvF,wBAAwB,OAAO,IAAI,UAAU;CAC7C,IAAI,OAAO,qBAAqB,KAAA,KAAa,OAAO,OAAO,qBAAqB,YAC9E,MAAM,IAAI,qBAAqB,4CAA4C;CAE7E,MAAM,QAAQ,kBAAkB,OAAO,KAAK;CAC5C,MAAM,SAAS,mBAAmB,OAAO,MAAM;CAC/C,MAAM,WAAW,IAAI,IAAI,OAAO,KAAK,OAAO,MAAM,CAAC;CACnD,IAAI,SAAS,SAAS,GAAG,MAAM,IAAI,qBAAqB,yCAAyC;CACjG,IAAI,CAAC,SAAS,IAAI,OAAO,YAAY,GACnC,MAAM,IAAI,qBAAqB,kBAAkB,OAAO,aAAa,kBAAkB;CAEzF,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,OAAO,MAAM,GAAG;EAC5D,wBAAwB,SAAS,UAAU;EAC3C,uBAAuB,SAAS,KAAK;CACvC;CACA,IAAI,OAAO,OAAO,OAAO,aAAa,CAAE,SAAS,WAC/C,MAAM,IAAI,qBAAqB,kBAAkB,OAAO,aAAa,2BAA2B;CAElG,MAAM,eAAe,qBAAqB,OAAO,cAAc,OAAO,MAAM;CAI5E,MAAM,cAAc,OAAO,YACzB,OAAO,QAAQ,OAAO,MAAM,CAAC,CAAC,KAAK,CAAC,SAAS,WAAW;EACtD,IAAI,MAAM,SAAS,KAAA,KAAa,MAAM,UACpC,MAAM,IAAI,qBAAqB,UAAU,QAAQ,wCAAwC;EAE3F,MAAM,UACJ,MAAM,SAAS,KAAA,IACX,CAAC,OAAO,OAAO;GAAE,SAAS;GAAM,IAAI,MAAM;EAAK,CAAC,CAAC,IACjD,OAAO,QAAQ,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,QAAQ,OAAO,OAAO;GAAE;GAAS;EAAG,CAAC,CAAC;EAChG,KAAK,MAAM,EAAE,QAAQ,SACnB,IAAI,CAAC,SAAS,IAAI,EAAE,GAClB,MAAM,IAAI,qBAAqB,UAAU,QAAQ,6BAA6B,GAAG,GAAG;EAGxF,OAAO,CAAC,SAAS,OAAO,OAAO,OAAO,CAAC;CACzC,CAAC,CACH;CAEA,MAAM,SAAS,OAAO,OACpB,OAAO,YACL,OAAO,QAAQ,OAAO,MAAM,CAAC,CAAC,KAAK,CAAC,SAAS,WAAW,CACtD,SACA,OAAO,OAAO;EACZ,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,GAAI,MAAM,SAAS,YAAY,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;EACvD,GAAI,MAAM,SAAS,KAAA,IAAY,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;EACvD,GAAI,MAAM,WAAW,EAAE,UAAU,OAAO,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,EAAE,IAAI,CAAC;EAC3E,GAAI,MAAM,UAAU,EAAE,SAAS,OAAO,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,EAAE,IAAI,CAAC;EACxE,GAAI,MAAM,SAAS,EAAE,QAAQ,OAAO,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,EAAE,IAAI,CAAC;CACvE,CAAC,CACH,CAAC,CACH,CACF;CACA,MAAM,QAAQ,OAAO,OACnB,OAAO,YACL,OAAO,QAAQ,OAAO,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,WAAW;EAC1D,MAAM,0BAAU,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,OAAO,KAAK,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;EACjG,IAAI,QAAQ,SAAS,GAAG,OAAO,CAAC;EAChC,OAAO,CACL,CACE,SACA,OAAO,OACL,OAAO,YACL,CAAC,GAAG,OAAO,CAAC,CAAC,KAAI,WAAU,CACzB,QACA,OAAO,OAAO;GACZ,GAAI,MAAM,UAAU,UAChB,EAAE,SAAS,MAAM,QAAQ,QAA6B,IACtD,CAAC;GACL,GAAI,MAAM,SAAS,UACf,EAAE,QAAQ,MAAM,OAAO,QAA6B,IACpD,CAAC;EACP,CAAC,CACH,CAAC,CACH,CACF,CACF,CACF;CACF,CAAC,CACH,CACF;CAEA,MAAM,wBAAQ,IAAI,IAA4B;CAC9C,MAAM,wBAAQ,IAAI,IAAoB;CACtC,MAAM,8BAAc,IAAI,IAAqB;CAC7C,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,MAAM,GAAiD;EACnG,MAAM,IAAI,SAAS,MAAM,IAAI;EAC7B,IAAI,MAAM,SAAS,WAAW;EAC9B,MAAM,IAAI,SAAS,MAAM,IAAI;EAC7B,IAAI,CAAC,YAAY,IAAI,MAAM,IAAI,GAAG,YAAY,IAAI,MAAM,MAAM,OAAO;CACvE;CAEA,OAAO,OAAO,OAAO;EACnB,IAAI,OAAO;EACX,OAAO,OAAO;EACd,cAAc,OAAO;EACrB;EACA,aAAa,OAAO,OAAO,WAAW;EACtC,OAAO,OAAO,OAAO,KAAK;EAC1B;EACA;EACA,GAAI,OAAO,mBAAmB,EAAE,kBAAkB,OAAO,iBAAiB,IAAI,CAAC;EAC/E,GAAI,eAAe,EAAE,aAAa,IAAI,CAAC;EACvC,iBAAiB,MAAe,IAAa;GAC3C,OAAO,SAAS,MAAM,YAAY,KAAK,EAAE,MAAK,eAAc,WAAW,OAAO,EAAE,MAAM;EACxF;EACA,YAAY,UAAkB,MAAM,IAAI,KAAK;EAC7C,YAAY,UAAkB,MAAM,IAAI,KAAK,MAAM;EACnD,aAAa,UAAkB,MAAM,IAAI,KAAK,MAAM;EACpD,eAAe,UAAkB,MAAM,IAAI,KAAK;EAChD,eAAe,SAAiB,YAAY,IAAI,IAAI;CACtD,CAAC;AACH"}

package/dist/boards/index.d.ts

@@ -1,6 +1,6 @@
 export { BoardDefinitionError, defineBoard } from './define-board.js';
-export type { BoardDefinition, BoardPhaseDefinition, BoardPhaseKind, BoardToolResultRuleHandler, BoardToolRule, BoardToolRules, BoardTransition, } from './define-board.js';
-export { boardForWorkItem, isTerminalWorkItem, resolveBoardToolRule, resolvePhaseSemantics, workItemPhaseSemantics, } from './semantics.js';
+export type { BoardDefinition, BoardEventIntegration, BoardEventRules, BoardPhaseDefinition, BoardPhaseKind, BoardSourceClosed, BoardToolResultRuleHandler, BoardToolRule, BoardToolRules, BoardTransition, } from './define-board.js';
+export { boardEventHandlers, boardForWorkItem, eventBoardId, isTerminalWorkItem, resolveBoardClosure, resolveBoardToolRule, rulePhaseContext, rulePhaseField, resolvePhaseSemantics, withBoardClosure, workItemPhaseSemantics, } from './semantics.js';
 export type { PhaseSemantics } from './semantics.js';
 export type { BoardTransitionPolicy, BoardTransitionPolicyContext, BoardTransitionPolicyResult, } from './transition-policy.js';
 export { createBoardRegistry, defaultBoards } from './registry.js';

package/dist/boards/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAInE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,yOAEpD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKxG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAInE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,yOAEpD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKxG"}

package/dist/boards/index.js

@@ -1,5 +1,5 @@
 import { BoardDefinitionError, defineBoard } from "./define-board.js";
-import { boardForWorkItem, isTerminalWorkItem, resolveBoardToolRule, resolvePhaseSemantics, workItemPhaseSemantics } from "./semantics.js";
+import { boardEventHandlers, boardForWorkItem, eventBoardId, isTerminalWorkItem, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, rulePhaseContext, rulePhaseField, withBoardClosure, workItemPhaseSemantics } from "./semantics.js";
 import { isReviewBoardPhase, reviewBoard } from "./review.js";
 import { isWorkBoardPhase, workBoard } from "./work.js";
 import { createBoardRegistry, defaultBoards } from "./registry.js";
@@ -16,6 +16,6 @@ function allowsBuiltInBoardTransition(board, from, to) {
 	return isReviewBoardPhase(from) && isReviewBoardPhase(to) && reviewBoard.allowsTransition(from, to);
 }
 //#endregion
-export { BoardDefinitionError, allowsBuiltInBoardTransition, boardForWorkItem, builtInBoard, createBoardRegistry, defaultBoards, defineBoard, isTerminalWorkItem, resolveBoardToolRule, resolvePhaseSemantics, reviewBoard, workBoard, workItemPhaseSemantics };
+export { BoardDefinitionError, allowsBuiltInBoardTransition, boardEventHandlers, boardForWorkItem, builtInBoard, createBoardRegistry, defaultBoards, defineBoard, eventBoardId, isTerminalWorkItem, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, reviewBoard, rulePhaseContext, rulePhaseField, withBoardClosure, workBoard, workItemPhaseSemantics };
 
 //# sourceMappingURL=index.js.map

package/dist/boards/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/boards/index.ts"],"sourcesContent":["export { BoardDefinitionError, defineBoard } from './define-board.js';\nexport type {\n  BoardDefinition,\n  BoardPhaseDefinition,\n  BoardPhaseKind,\n  BoardToolResultRuleHandler,\n  BoardToolRule,\n  BoardToolRules,\n  BoardTransition,\n} from './define-board.js';\nexport {\n  boardForWorkItem,\n  isTerminalWorkItem,\n  resolveBoardToolRule,\n  resolvePhaseSemantics,\n  workItemPhaseSemantics,\n} from './semantics.js';\nexport type { PhaseSemantics } from './semantics.js';\nexport type {\n  BoardTransitionPolicy,\n  BoardTransitionPolicyContext,\n  BoardTransitionPolicyResult,\n} from './transition-policy.js';\nexport { createBoardRegistry, defaultBoards } from './registry.js';\nexport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { isReviewBoardPhase, reviewBoard } from './review.js';\nimport { isWorkBoardPhase, workBoard } from './work.js';\n\nexport { reviewBoard } from './review.js';\nexport type { ReviewBoardPhase } from './review.js';\nexport { workBoard } from './work.js';\nexport type { WorkBoardPhase } from './work.js';\n\nconst builtInBoards = { work: workBoard, review: reviewBoard } as const;\n\nexport function builtInBoard(board: 'work' | 'review') {\n  return builtInBoards[board];\n}\n\nexport function allowsBuiltInBoardTransition(board: 'work' | 'review', from: string, to: string): boolean {\n  if (board === 'work') {\n    return isWorkBoardPhase(from) && isWorkBoardPhase(to) && workBoard.allowsTransition(from, to);\n  }\n  return isReviewBoardPhase(from) && isReviewBoardPhase(to) && reviewBoard.allowsTransition(from, to);\n}\n"],"mappings":";;;;;;AAiCA,MAAM,gBAAgB;CAAE,MAAM;CAAW,QAAQ;AAAY;AAE7D,SAAgB,aAAa,OAA0B;CACrD,OAAO,cAAc;AACvB;AAEA,SAAgB,6BAA6B,OAA0B,MAAc,IAAqB;CACxG,IAAI,UAAU,QACZ,OAAO,iBAAiB,IAAI,KAAK,iBAAiB,EAAE,KAAK,UAAU,iBAAiB,MAAM,EAAE;CAE9F,OAAO,mBAAmB,IAAI,KAAK,mBAAmB,EAAE,KAAK,YAAY,iBAAiB,MAAM,EAAE;AACpG"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/boards/index.ts"],"sourcesContent":["export { BoardDefinitionError, defineBoard } from './define-board.js';\nexport type {\n  BoardDefinition,\n  BoardEventIntegration,\n  BoardEventRules,\n  BoardPhaseDefinition,\n  BoardPhaseKind,\n  BoardSourceClosed,\n  BoardToolResultRuleHandler,\n  BoardToolRule,\n  BoardToolRules,\n  BoardTransition,\n} from './define-board.js';\nexport {\n  boardEventHandlers,\n  boardForWorkItem,\n  eventBoardId,\n  isTerminalWorkItem,\n  resolveBoardClosure,\n  resolveBoardToolRule,\n  rulePhaseContext,\n  rulePhaseField,\n  resolvePhaseSemantics,\n  withBoardClosure,\n  workItemPhaseSemantics,\n} from './semantics.js';\nexport type { PhaseSemantics } from './semantics.js';\nexport type {\n  BoardTransitionPolicy,\n  BoardTransitionPolicyContext,\n  BoardTransitionPolicyResult,\n} from './transition-policy.js';\nexport { createBoardRegistry, defaultBoards } from './registry.js';\nexport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { isReviewBoardPhase, reviewBoard } from './review.js';\nimport { isWorkBoardPhase, workBoard } from './work.js';\n\nexport { reviewBoard } from './review.js';\nexport type { ReviewBoardPhase } from './review.js';\nexport { workBoard } from './work.js';\nexport type { WorkBoardPhase } from './work.js';\n\nconst builtInBoards = { work: workBoard, review: reviewBoard } as const;\n\nexport function builtInBoard(board: 'work' | 'review') {\n  return builtInBoards[board];\n}\n\nexport function allowsBuiltInBoardTransition(board: 'work' | 'review', from: string, to: string): boolean {\n  if (board === 'work') {\n    return isWorkBoardPhase(from) && isWorkBoardPhase(to) && workBoard.allowsTransition(from, to);\n  }\n  return isReviewBoardPhase(from) && isReviewBoardPhase(to) && reviewBoard.allowsTransition(from, to);\n}\n"],"mappings":";;;;;;AA0CA,MAAM,gBAAgB;CAAE,MAAM;CAAW,QAAQ;AAAY;AAE7D,SAAgB,aAAa,OAA0B;CACrD,OAAO,cAAc;AACvB;AAEA,SAAgB,6BAA6B,OAA0B,MAAc,IAAqB;CACxG,IAAI,UAAU,QACZ,OAAO,iBAAiB,IAAI,KAAK,iBAAiB,EAAE,KAAK,UAAU,iBAAiB,MAAM,EAAE;CAE9F,OAAO,mBAAmB,IAAI,KAAK,mBAAmB,EAAE,KAAK,YAAY,iBAAiB,MAAM,EAAE;AACpG"}

package/dist/boards/semantics.d.ts

@@ -1,5 +1,6 @@
+import type { FactoryRuleBoardClosure, FactoryRulePhaseContext } from '../rules/types.js';
 import type { WorkItemRow } from '../storage/domains/work-items/base.js';
-import type { BoardPhaseKind, BoardToolResultRuleHandler } from './define-board.js';
+import type { BoardEventIntegration, BoardEventRules, BoardPhaseKind, BoardToolResultRuleHandler } from './define-board.js';
 import type { BoardRegistry } from './registry.js';
 export interface PhaseSemantics {
     readonly kind: BoardPhaseKind;
@@ -23,6 +24,24 @@ export declare function resolvePhaseSemantics(boards: BoardRegistry, boardId: st
  * not installed or declares no rule for the tool; callers must run nothing in that case.
  */
 export declare function resolveBoardToolRule(boards: BoardRegistry, boardId: string, toolName: string): BoardToolResultRuleHandler | undefined;
+/**
+ * Integration event handlers the installed board declares for cards on it, or undefined when the
+ * card is unbound, the board is not installed, or it declares none for this integration. Within the
+ * map, `null` means the board switched that event off for its cards.
+ */
+export declare function boardEventHandlers<I extends BoardEventIntegration>(boards: Pick<BoardRegistry, 'get'>, boardId: string | undefined, integration: I): BoardEventRules[I] | undefined;
+/**
+ * Board whose event handlers answer an integration evaluation: the bound card's board, except on
+ * the evaluation that files a pull request's own Review card, which is about a card that does
+ * not exist yet.
+ */
+export declare function eventBoardId(context: {
+    readonly item?: unknown;
+    readonly board?: string;
+    readonly pullRequestIntake?: boolean;
+}): string | undefined;
+/** What a card's single current phase means on its installed board, for integration rule contexts. */
+export declare function rulePhaseContext(boards: Pick<BoardRegistry, 'get'>, item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>): FactoryRulePhaseContext | undefined;
 /**
  * Whether a persisted card has finished, judged by the board it sits on: the installed
  * board's phase kind first, then the built-in Work and Review names for rows whose board is
@@ -32,4 +51,18 @@ export declare function resolveBoardToolRule(boards: BoardRegistry, boardId: str
 export declare function isTerminalWorkItem(boards: BoardRegistry, item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>): boolean;
 /** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */
 export declare function workItemPhaseSemantics(boards: BoardRegistry, item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>): PhaseSemantics | undefined;
+/**
+ * Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed
+ * board declares, plus whether the card already sits in a terminal phase. Undefined when the
+ * board is not installed or declares no mapping, so closing the source leaves the card alone.
+ */
+export declare function resolveBoardClosure(boards: BoardRegistry, item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>): FactoryRuleBoardClosure | undefined;
+/** Rule-context fragment carrying the card's `boardClosure`, empty when the board declares none. */
+export declare function withBoardClosure(boards: BoardRegistry, item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>): {
+    boardClosure?: FactoryRuleBoardClosure;
+};
+/** `{ phase }` for spreading into an integration rule context, or `{}` when the phase is unknown. */
+export declare function rulePhaseField(boards: Pick<BoardRegistry, 'get'>, item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>): {
+    readonly phase?: FactoryRulePhaseContext;
+};
 //# sourceMappingURL=semantics.d.ts.map

package/dist/boards/semantics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../../src/boards/semantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,gBAAgB,CAAC,GAAG,MAAM,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAM5B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,0BAA0B,GAAG,SAAS,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GAC7D,OAAO,CAOT;AAED,oGAAoG;AACpG,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GAC7D,cAAc,GAAG,SAAS,CAI5B"}
+{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../../src/boards/semantics.ts"],"names":[],"mappings":"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"}

package/dist/boards/semantics.js

@@ -30,6 +30,38 @@ function resolveBoardToolRule(boards, boardId, toolName) {
 	return boards.get(boardId)?.tools[toolName]?.onResult;
 }
 /**
+* Integration event handlers the installed board declares for cards on it, or undefined when the
+* card is unbound, the board is not installed, or it declares none for this integration. Within the
+* map, `null` means the board switched that event off for its cards.
+*/
+function boardEventHandlers(boards, boardId, integration) {
+	return boardId === void 0 ? void 0 : boards.get(boardId)?.events[integration];
+}
+/**
+* Board whose event handlers answer an integration evaluation: the bound card's board, except on
+* the evaluation that files a pull request's own Review card, which is about a card that does
+* not exist yet.
+*/
+function eventBoardId(context) {
+	return context.item && !context.pullRequestIntake ? context.board : void 0;
+}
+/** What a card's single current phase means on its installed board, for integration rule contexts. */
+function rulePhaseContext(boards, item) {
+	const stage = item.stages.length === 1 ? item.stages[0] : void 0;
+	if (!stage) return void 0;
+	const board = boards.get(boardForWorkItem(item));
+	const kind = board?.phaseKind(stage);
+	if (!board || !kind) return void 0;
+	const role = board.roleForPhase(stage);
+	const outcomes = Object.freeze(Object.keys(board.phases[stage]?.outcomes ?? {}));
+	return Object.freeze({
+		id: stage,
+		kind,
+		...role === void 0 ? {} : { role },
+		outcomes
+	});
+}
+/**
 * Whether a persisted card has finished, judged by the board it sits on: the installed
 * board's phase kind first, then the built-in Work and Review names for rows whose board is
 * not installed. Unknown boards or phases are never terminal, so a card is only ever
@@ -49,7 +81,39 @@ function workItemPhaseSemantics(boards, item) {
 	if (!stage) return void 0;
 	return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);
 }
+/**
+* Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed
+* board declares, plus whether the card already sits in a terminal phase. Undefined when the
+* board is not installed or declares no mapping, so closing the source leaves the card alone.
+*/
+function resolveBoardClosure(boards, item) {
+	const board = boards.get(boardForWorkItem(item));
+	if (!board?.sourceClosed) return void 0;
+	const { completed, canceled } = board.sourceClosed;
+	return {
+		boardTitle: board.title,
+		completed: {
+			phase: completed,
+			title: board.phases[completed].title
+		},
+		canceled: {
+			phase: canceled,
+			title: board.phases[canceled].title
+		},
+		itemTerminal: item.stages.some((stage) => board.isTerminal(stage))
+	};
+}
+/** Rule-context fragment carrying the card's `boardClosure`, empty when the board declares none. */
+function withBoardClosure(boards, item) {
+	const boardClosure = resolveBoardClosure(boards, item);
+	return boardClosure ? { boardClosure } : {};
+}
+/** `{ phase }` for spreading into an integration rule context, or `{}` when the phase is unknown. */
+function rulePhaseField(boards, item) {
+	const phase = rulePhaseContext(boards, item);
+	return phase ? { phase } : {};
+}
 //#endregion
-export { boardForWorkItem, isTerminalWorkItem, resolveBoardToolRule, resolvePhaseSemantics, workItemPhaseSemantics };
+export { boardEventHandlers, boardForWorkItem, eventBoardId, isTerminalWorkItem, resolveBoardClosure, resolveBoardToolRule, resolvePhaseSemantics, rulePhaseContext, rulePhaseField, withBoardClosure, workItemPhaseSemantics };
 
 //# sourceMappingURL=semantics.js.map

package/dist/boards/semantics.js.map

@@ -1 +1 @@
-{"version":3,"file":"semantics.js","names":[],"sources":["../../src/boards/semantics.ts"],"sourcesContent":["import type { WorkItemRow } from '../storage/domains/work-items/base.js';\nimport type { BoardPhaseKind, BoardToolResultRuleHandler } from './define-board.js';\nimport type { BoardRegistry } from './registry.js';\n\nexport interface PhaseSemantics {\n  readonly kind: BoardPhaseKind;\n  /** Seat that carries a working phase; absent for resting and terminal phases. */\n  readonly role?: string;\n}\n\n/**\n * Board that owns a work item. Rows created before boards were persisted carry no `board`;\n * they belong to Review when they track a pull request and to Work otherwise, matching the\n * legacy assignment the transition service performs on their next move.\n */\nexport function boardForWorkItem(item: Pick<WorkItemRow, 'board' | 'externalSource'>): string {\n  return item.board ?? (item.externalSource?.type === 'pull-request' ? 'review' : 'work');\n}\n\n/**\n * What the installed board says `phase` means. Returns undefined when the board is not\n * installed or does not declare the phase; callers must fail closed on undefined rather\n * than guess from the phase name.\n */\nexport function resolvePhaseSemantics(\n  boards: BoardRegistry,\n  boardId: string,\n  phase: string,\n): PhaseSemantics | undefined {\n  const board = boards.get(boardId);\n  const kind = board?.phaseKind(phase);\n  if (!board || !kind) return undefined;\n  const role = board.roleForPhase(phase);\n  return role === undefined ? { kind } : { kind, role };\n}\n\n/**\n * Tool-result rule the installed board declares for `toolName`. Undefined when the board is\n * not installed or declares no rule for the tool; callers must run nothing in that case.\n */\nexport function resolveBoardToolRule(\n  boards: BoardRegistry,\n  boardId: string,\n  toolName: string,\n): BoardToolResultRuleHandler | undefined {\n  return boards.get(boardId)?.tools[toolName]?.onResult;\n}\n\n/**\n * Whether a persisted card has finished, judged by the board it sits on: the installed\n * board's phase kind first, then the built-in Work and Review names for rows whose board is\n * not installed. Unknown boards or phases are never terminal, so a card is only ever\n * released from ownership on the board's own say-so.\n */\nexport function isTerminalWorkItem(\n  boards: BoardRegistry,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): boolean {\n  const semantics = workItemPhaseSemantics(boards, item);\n  if (semantics) return semantics.kind === 'terminal';\n  const board = boardForWorkItem(item);\n  if (board !== 'work' && board !== 'review') return false;\n  const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n  return stage === 'done' || stage === 'canceled';\n}\n\n/** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */\nexport function workItemPhaseSemantics(\n  boards: BoardRegistry,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): PhaseSemantics | undefined {\n  const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n  if (!stage) return undefined;\n  return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);\n}\n"],"mappings":";;;;;;AAeA,SAAgB,iBAAiB,MAA6D;CAC5F,OAAO,KAAK,UAAU,KAAK,gBAAgB,SAAS,iBAAiB,WAAW;AAClF;;;;;;AAOA,SAAgB,sBACd,QACA,SACA,OAC4B;CAC5B,MAAM,QAAQ,OAAO,IAAI,OAAO;CAChC,MAAM,OAAO,OAAO,UAAU,KAAK;CACnC,IAAI,CAAC,SAAS,CAAC,MAAM,OAAO,KAAA;CAC5B,MAAM,OAAO,MAAM,aAAa,KAAK;CACrC,OAAO,SAAS,KAAA,IAAY,EAAE,KAAK,IAAI;EAAE;EAAM;CAAK;AACtD;;;;;AAMA,SAAgB,qBACd,QACA,SACA,UACwC;CACxC,OAAO,OAAO,IAAI,OAAO,CAAC,EAAE,MAAM,SAAS,EAAE;AAC/C;;;;;;;AAQA,SAAgB,mBACd,QACA,MACS;CACT,MAAM,YAAY,uBAAuB,QAAQ,IAAI;CACrD,IAAI,WAAW,OAAO,UAAU,SAAS;CACzC,MAAM,QAAQ,iBAAiB,IAAI;CACnC,IAAI,UAAU,UAAU,UAAU,UAAU,OAAO;CACnD,MAAM,QAAQ,KAAK,OAAO,WAAW,IAAI,KAAK,OAAO,KAAK,KAAA;CAC1D,OAAO,UAAU,UAAU,UAAU;AACvC;;AAGA,SAAgB,uBACd,QACA,MAC4B;CAC5B,MAAM,QAAQ,KAAK,OAAO,WAAW,IAAI,KAAK,OAAO,KAAK,KAAA;CAC1D,IAAI,CAAC,OAAO,OAAO,KAAA;CACnB,OAAO,sBAAsB,QAAQ,iBAAiB,IAAI,GAAG,KAAK;AACpE"}
+{"version":3,"file":"semantics.js","names":[],"sources":["../../src/boards/semantics.ts"],"sourcesContent":["import type { FactoryRuleBoardClosure, FactoryRulePhaseContext } from '../rules/types.js';\nimport type { WorkItemRow } from '../storage/domains/work-items/base.js';\nimport type {\n  BoardEventIntegration,\n  BoardEventRules,\n  BoardPhaseKind,\n  BoardToolResultRuleHandler,\n} from './define-board.js';\nimport type { BoardRegistry } from './registry.js';\n\nexport interface PhaseSemantics {\n  readonly kind: BoardPhaseKind;\n  /** Seat that carries a working phase; absent for resting and terminal phases. */\n  readonly role?: string;\n}\n\n/**\n * Board that owns a work item. Rows created before boards were persisted carry no `board`;\n * they belong to Review when they track a pull request and to Work otherwise, matching the\n * legacy assignment the transition service performs on their next move.\n */\nexport function boardForWorkItem(item: Pick<WorkItemRow, 'board' | 'externalSource'>): string {\n  return item.board ?? (item.externalSource?.type === 'pull-request' ? 'review' : 'work');\n}\n\n/**\n * What the installed board says `phase` means. Returns undefined when the board is not\n * installed or does not declare the phase; callers must fail closed on undefined rather\n * than guess from the phase name.\n */\nexport function resolvePhaseSemantics(\n  boards: BoardRegistry,\n  boardId: string,\n  phase: string,\n): PhaseSemantics | undefined {\n  const board = boards.get(boardId);\n  const kind = board?.phaseKind(phase);\n  if (!board || !kind) return undefined;\n  const role = board.roleForPhase(phase);\n  return role === undefined ? { kind } : { kind, role };\n}\n\n/**\n * Tool-result rule the installed board declares for `toolName`. Undefined when the board is\n * not installed or declares no rule for the tool; callers must run nothing in that case.\n */\nexport function resolveBoardToolRule(\n  boards: BoardRegistry,\n  boardId: string,\n  toolName: string,\n): BoardToolResultRuleHandler | undefined {\n  return boards.get(boardId)?.tools[toolName]?.onResult;\n}\n\n/**\n * Integration event handlers the installed board declares for cards on it, or undefined when the\n * card is unbound, the board is not installed, or it declares none for this integration. Within the\n * map, `null` means the board switched that event off for its cards.\n */\nexport function boardEventHandlers<I extends BoardEventIntegration>(\n  boards: Pick<BoardRegistry, 'get'>,\n  boardId: string | undefined,\n  integration: I,\n): BoardEventRules[I] | undefined {\n  return boardId === undefined ? undefined : boards.get(boardId)?.events[integration];\n}\n\n/**\n * Board whose event handlers answer an integration evaluation: the bound card's board, except on\n * the evaluation that files a pull request's own Review card, which is about a card that does\n * not exist yet.\n */\nexport function eventBoardId(context: {\n  readonly item?: unknown;\n  readonly board?: string;\n  readonly pullRequestIntake?: boolean;\n}): string | undefined {\n  return context.item && !context.pullRequestIntake ? context.board : undefined;\n}\n\n/** What a card's single current phase means on its installed board, for integration rule contexts. */\nexport function rulePhaseContext(\n  boards: Pick<BoardRegistry, 'get'>,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): FactoryRulePhaseContext | undefined {\n  const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n  if (!stage) return undefined;\n  const board = boards.get(boardForWorkItem(item));\n  const kind = board?.phaseKind(stage);\n  if (!board || !kind) return undefined;\n  const role = board.roleForPhase(stage);\n  const outcomes = Object.freeze(Object.keys(board.phases[stage]?.outcomes ?? {}));\n  return Object.freeze({ id: stage, kind, ...(role === undefined ? {} : { role }), outcomes });\n}\n\n/**\n * Whether a persisted card has finished, judged by the board it sits on: the installed\n * board's phase kind first, then the built-in Work and Review names for rows whose board is\n * not installed. Unknown boards or phases are never terminal, so a card is only ever\n * released from ownership on the board's own say-so.\n */\nexport function isTerminalWorkItem(\n  boards: BoardRegistry,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): boolean {\n  const semantics = workItemPhaseSemantics(boards, item);\n  if (semantics) return semantics.kind === 'terminal';\n  const board = boardForWorkItem(item);\n  if (board !== 'work' && board !== 'review') return false;\n  const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n  return stage === 'done' || stage === 'canceled';\n}\n\n/** Semantics of the single stage a work item currently occupies; undefined for multi-stage rows. */\nexport function workItemPhaseSemantics(\n  boards: BoardRegistry,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): PhaseSemantics | undefined {\n  const stage = item.stages.length === 1 ? item.stages[0] : undefined;\n  if (!stage) return undefined;\n  return resolvePhaseSemantics(boards, boardForWorkItem(item), stage);\n}\n\n/**\n * Where source-closed rules send a persisted card: the `sourceClosed` mapping its installed\n * board declares, plus whether the card already sits in a terminal phase. Undefined when the\n * board is not installed or declares no mapping, so closing the source leaves the card alone.\n */\nexport function resolveBoardClosure(\n  boards: BoardRegistry,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): FactoryRuleBoardClosure | undefined {\n  const board = boards.get(boardForWorkItem(item));\n  if (!board?.sourceClosed) return undefined;\n  const { completed, canceled } = board.sourceClosed;\n  return {\n    boardTitle: board.title,\n    completed: { phase: completed, title: board.phases[completed]!.title },\n    canceled: { phase: canceled, title: board.phases[canceled]!.title },\n    itemTerminal: item.stages.some(stage => board.isTerminal(stage)),\n  };\n}\n\n/** Rule-context fragment carrying the card's `boardClosure`, empty when the board declares none. */\nexport function withBoardClosure(\n  boards: BoardRegistry,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): { boardClosure?: FactoryRuleBoardClosure } {\n  const boardClosure = resolveBoardClosure(boards, item);\n  return boardClosure ? { boardClosure } : {};\n}\n\n/** `{ phase }` for spreading into an integration rule context, or `{}` when the phase is unknown. */\nexport function rulePhaseField(\n  boards: Pick<BoardRegistry, 'get'>,\n  item: Pick<WorkItemRow, 'board' | 'externalSource' | 'stages'>,\n): { readonly phase?: FactoryRulePhaseContext } {\n  const phase = rulePhaseContext(boards, item);\n  return phase ? { phase } : {};\n}\n"],"mappings":"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"}

package/dist/boards/work.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../src/boards/work.ts"],"names":[],"mappings":"AAmKA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAY3G,eAAO,MAAM,SAAS,oIAwEpB,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}
+{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../src/boards/work.ts"],"names":[],"mappings":"AAmKA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAY3G,eAAO,MAAM,SAAS,oIAyEpB,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}

package/dist/boards/work.js

@@ -1,6 +1,6 @@
+import { needsApproval } from "../rules/types.js";
 import { defineBoard } from "./define-board.js";
 import { workItemNumber } from "../work-item-branch.js";
-import { needsApproval } from "../rules/types.js";
 import { advanceApprovedPlan } from "./work-tool-rules.js";
 import { workTransitionPolicy } from "./work-transition-policy.js";
 //#region src/boards/work.ts
@@ -142,6 +142,10 @@ const workBoard = defineBoard({
 	title: "Work",
 	initialPhase: "intake",
 	transitionPolicy: workTransitionPolicy,
+	sourceClosed: {
+		completed: "done",
+		canceled: "canceled"
+	},
 	tools: { submit_plan: { onResult: advanceApprovedPlan } },
 	phases: {
 		intake: {