@mastra/factory 0.18.1-alpha.0 → 0.19.0-alpha.1

package/dist/routes/work-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"work-items.js","names":["#boards","#defaultBoards","#resolveTenant","#resolveProject","#auditWorkItemPatch","#proposalRoute"],"sources":["../../src/routes/work-items.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for Factory work items (the kanban board).\n *\n * Registered alongside the other `/web/*` routes behind the host auth gate.\n * The board is org-wide: every route re-resolves the caller's `(orgId, userId)`\n * tenant and scopes reads/writes by `orgId`, so any org member sees and moves\n * the same cards while `created_by` / stage history record who acted.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport { createBoardRegistry } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport type {\n  FactoryStartCoordinator,\n  FactoryStartPreparedResult,\n  FactoryStartRequest,\n} from '../rules/start-coordinator.js';\nimport { FactoryStartTransitionError, WorkItemRepositoryError } from '../rules/start-coordinator.js';\nimport type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';\nimport type { WorkItemSource } from '../rules/types.js';\nimport type { LiveSessions } from '../session/live-sessions.js';\nimport { auditRequestOrigin } from '../storage/domains/audit/domain.js';\nimport type { AuditEmitter } from '../storage/domains/audit/domain.js';\nimport type { WorkItemCommentsStorage } from '../storage/domains/comments/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { QueueHealthStorage } from '../storage/domains/queue-health/base.js';\nimport { thresholdsOrDefault } from '../storage/domains/queue-health/base.js';\nimport type {\n  CreateWorkItemInput,\n  FactoryDeferredDecisionRecord,\n  UpdateWorkItemInput,\n  WorkItemRow,\n  WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport {\n  FACTORY_PULL_REQUEST_RECONCILIATION_KEY,\n  FACTORY_RULE_MATERIALIZATION_KEY,\n  WorkItemRelationError,\n  WorkItemUpdateConflictError,\n} from '../storage/domains/work-items/base.js';\nimport { computeFactoryMetrics, parseMetricsRange } from '../storage/domains/work-items/metrics.js';\nimport { buildAttentionRoutes, factoryDecisionType } from './attention.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport type { RouteDependencies } from './route.js';\nimport { Route } from './route.js';\nimport { buildSupervisorRoutes } from './supervisor.js';\n\nexport interface WorkItemRoutesDeps extends RouteDependencies {\n  audit: AuditEmitter;\n  /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n  projects: FactoryProjectsStorage;\n  /** Work-items domain backing the kanban board. */\n  workItems: WorkItemsStorage;\n  /** Boards installed for this Factory instance. */\n  boardRegistry?: BoardRegistry;\n  /** Comments domain — backs the mention attention provider. */\n  comments: WorkItemCommentsStorage;\n  /** Per-project queue-health threshold config. */\n  queueHealth: QueueHealthStorage;\n  /** Governed stage-transition service. Stage moves 503 when absent. */\n  transitionService?: Pick<FactoryTransitionService, 'transition' | 'configVersion'>;\n  /** Coordinator that binds a Factory run before dispatching its kickoff. */\n  startCoordinator?: Pick<FactoryStartCoordinator, 'prepare'>;\n  /** Materialized sessions, read to report which of the listed cards are being worked or wait on someone. */\n  liveSessions: Pick<LiveSessions, 'isRunning' | 'parked' | 'parkedIn'>;\n}\n\n/** The card as clients see it, without the dispatcher's internal bookkeeping. */\nfunction toWireWorkItem(item: WorkItemRow): WorkItemRow {\n  if (\n    !item.metadata ||\n    (!(FACTORY_RULE_MATERIALIZATION_KEY in item.metadata) &&\n      !(FACTORY_PULL_REQUEST_RECONCILIATION_KEY in item.metadata))\n  ) {\n    return item;\n  }\n  return { ...item, metadata: publicWorkItemMetadata(item.metadata) ?? {} };\n}\n\n/** Session ids of the listed cards that the predicate picks, each once. */\nfunction sessionIdsWhere(items: WorkItemRow[], predicate: (sessionId: string) => boolean): string[] {\n  const picked = new Set<string>();\n  for (const item of items) {\n    for (const { sessionId } of Object.values(item.sessions)) {\n      if (predicate(sessionId)) picked.add(sessionId);\n    }\n  }\n  return [...picked];\n}\n\nfunction loose(c: unknown): Context {\n  return c as Context;\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction publicWorkItemMetadata(value: Record<string, unknown> | null): Record<string, unknown> | null {\n  if (value === null) return null;\n  const {\n    [FACTORY_RULE_MATERIALIZATION_KEY]: _materialization,\n    [FACTORY_PULL_REQUEST_RECONCILIATION_KEY]: _reconciliation,\n    ...metadata\n  } = value;\n  return metadata;\n}\n\n/** Validate an untrusted create body. Unknown keys are dropped. */\nexport function parseCreateWorkItem(body: unknown): CreateWorkItemInput | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemCreate.bodySchema.safeParse(body);\n  return parsed.success ? parsed.data : null;\n}\n\n/** Validate an untrusted patch body. Unknown keys are dropped. */\nexport function parseUpdateWorkItem(body: unknown): UpdateWorkItemInput | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemUpdate.bodySchema.safeParse(body);\n  return parsed.success ? parsed.data : null;\n}\n\nasync function readJson(c: Context): Promise<unknown | undefined> {\n  try {\n    return await c.req.json();\n  } catch {\n    return undefined;\n  }\n}\n\n/** Fields a PATCH touched, for the bounded `updated` event summary. */\nfunction patchedFields(patch: Record<string, unknown>): string[] {\n  return Object.keys(patch).filter(key => patch[key] !== undefined);\n}\n\nfunction parseTransitionBody(\n  body: unknown,\n): Omit<FactoryTransitionRequest, 'orgId' | 'factoryProjectId' | 'workItemId' | 'actor'> | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemTransition.bodySchema.safeParse(body);\n  return parsed.success ? parsed.data : null;\n}\n\nfunction parseStartBody(\n  body: unknown,\n  tenant: { orgId: string; userId: string },\n  factoryProjectId: string,\n): FactoryStartRequest | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemStart.bodySchema.safeParse(body);\n  return parsed.success ? { ...tenant, factoryProjectId, ...parsed.data } : null;\n}\n\nfunction encodeDecisionCursor(decision: FactoryDeferredDecisionRecord): string {\n  return Buffer.from(JSON.stringify([decision.createdAt.toISOString(), decision.id]), 'utf8').toString('base64url');\n}\n\n/** A proposed transition names the seat its lane addresses, so the card can label what approving starts. */\nfunction summaryRole(boards: BoardRegistry, decision: Record<string, unknown>): string | null {\n  if (typeof decision.role === 'string') return decision.role.slice(0, 32);\n  if (decision.type !== 'transition') return null;\n  const { board, stage } = decision;\n  if (typeof board !== 'string' || typeof stage !== 'string') return null;\n  return boards.get(board)?.roleForPhase(stage) ?? null;\n}\n\n/** A linked-card decision names where the card is synced from, so the UI can say \"GitHub\" rather than \"a linked card\". */\nfunction summarySource(decision: Record<string, unknown>): WorkItemSource | null {\n  if (decision.type !== 'upsertLinkedWorkItem') return null;\n  const source = decision.source;\n  return source === 'github-issue' ||\n    source === 'github-pr' ||\n    source === 'gitlab-issue' ||\n    source === 'gitlab-pr' ||\n    source === 'linear-issue' ||\n    source === 'manual'\n    ? source\n    : null;\n}\n\nfunction decisionSummary(boards: BoardRegistry, decision: FactoryDeferredDecisionRecord) {\n  return {\n    id: decision.id,\n    evaluationId: decision.evaluationId,\n    workItemId: decision.workItemId,\n    type: factoryDecisionType(decision),\n    role: summaryRole(boards, decision.decision),\n    source: summarySource(decision.decision),\n    status: decision.status,\n    attempts: decision.attempts,\n    failureOccurrence: decision.failureOccurrence,\n    failureCode: decision.failureCode,\n    canRetry: factoryDispatchFailureMetadata(decision.failureCode).canRetry,\n    lastError: decision.lastError?.slice(0, 512) ?? null,\n    createdAt: decision.createdAt.toISOString(),\n    updatedAt: decision.updatedAt.toISOString(),\n    completedAt: decision.completedAt?.toISOString() ?? null,\n  };\n}\n\nexport class WorkItemRoutes extends Route<WorkItemRoutesDeps> {\n  #defaultBoards: BoardRegistry | undefined;\n\n  get #boards(): BoardRegistry {\n    return this.deps.boardRegistry ?? (this.#defaultBoards ??= createBoardRegistry());\n  }\n\n  /** Resolve the `(orgId, userId)` tenant or a ready-to-return error response. */\n  async #resolveTenant(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n    await this.deps.auth.ensureUser(c);\n    const tenant = this.deps.auth.tenant(c);\n    if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n    if (!tenant.orgId) {\n      return {\n        response: c.json(\n          { error: 'organization_required', message: 'The Factory board requires an organization.' },\n          403,\n        ),\n      };\n    }\n    return { orgId: tenant.orgId, userId: tenant.userId };\n  }\n\n  /**\n   * Resolve the tenant AND the org-owned project from the `:id` param. Work\n   * items hang off a project, so listing/creating requires the project to\n   * exist in the caller's org.\n   */\n  async #resolveProject(\n    c: Context,\n  ): Promise<\n    { orgId: string; userId: string; factoryProjectId: string; defaultModelId: string | null } | { response: Response }\n  > {\n    const tenant = await this.#resolveTenant(c);\n    if ('response' in tenant) return tenant;\n\n    const parsedPath = FACTORY_ROUTE_CONTRACTS.projectGet.pathSchema.safeParse({ id: c.req.param('id') });\n    if (!parsedPath.success) {\n      return { response: c.json({ error: 'Project not found' }, 404) };\n    }\n    const projectId = parsedPath.data.id;\n    const { projects } = this.deps;\n    await projects.ensureReady();\n    const project = await projects.get({ orgId: tenant.orgId, id: projectId });\n    if (!project) {\n      return { response: c.json({ error: 'Project not found' }, 404) };\n    }\n    return { ...tenant, factoryProjectId: projectId, defaultModelId: project.defaultModelId };\n  }\n\n  async #auditWorkItemPatch({\n    context,\n    item,\n    patch,\n  }: {\n    context: Context;\n    item: WorkItemRow;\n    patch: Record<string, unknown>;\n  }): Promise<void> {\n    await this.deps.audit.emit({\n      context,\n      input: {\n        action: 'factory.work_item.updated',\n        factoryProjectId: item.factoryProjectId,\n        targets: [{ type: 'work_item', id: item.id, name: item.title }],\n        metadata: { fields: patchedFields(patch) },\n      },\n    });\n  }\n\n  /** Releasing a parked run and dropping it: same request, opposite outcomes, both audited as consent. */\n  #proposalRoute({\n    verb,\n    settle,\n  }: {\n    verb: 'approve' | 'dismiss';\n    settle: (\n      orgId: string,\n      factoryProjectId: string,\n      decisionId: string,\n      now: Date,\n      userId: string,\n    ) => Promise<FactoryDeferredDecisionRecord | null>;\n  }): ApiRoute {\n    const { audit, workItems } = this.deps;\n    const contract =\n      verb === 'approve' ? FACTORY_ROUTE_CONTRACTS.decisionApprove : FACTORY_ROUTE_CONTRACTS.decisionDismiss;\n    return registerApiRoute(contract.path, {\n      method: contract.method,\n      requiresAuth: false,\n      handler: async c => {\n        const context = loose(c);\n        const resolved = await this.#resolveProject(context);\n        if ('response' in resolved) return resolved.response;\n        const parsedPath = contract.pathSchema.safeParse({\n          id: resolved.factoryProjectId,\n          decisionId: context.req.param('decisionId'),\n        });\n        if (!parsedPath.success) return c.json({ error: 'invalid_decision_id' }, 422);\n        const { decisionId } = parsedPath.data;\n        await workItems.ensureReady();\n        const now = new Date();\n        const decision = await settle(resolved.orgId, resolved.factoryProjectId, decisionId, now, resolved.userId);\n        if (!decision) return c.json({ error: 'decision_not_proposed' }, 409);\n        // Releasing a proposal is a person taking the item on. Approval arms the\n        // item's autonomy inside the same storage transaction (see\n        // approveDeferredDecision), so follow-up runs no longer wait for approval.\n        await audit.emit({\n          context,\n          input: {\n            action: verb === 'approve' ? 'factory.run.approved' : 'factory.run.dismissed',\n            factoryProjectId: resolved.factoryProjectId,\n            targets: decision.workItemId\n              ? [{ type: 'work_item', id: decision.workItemId }]\n              : [{ type: 'rule_decision', id: decision.id }],\n            metadata: { decisionId: decision.id, effect: factoryDecisionType(decision) },\n          },\n        });\n        return c.json({ decision: decisionSummary(this.#boards, decision) });\n      },\n    });\n  }\n\n  /** Build the Factory work-item routes as Mastra `apiRoutes`. */\n  routes(): ApiRoute[] {\n    const { audit, workItems, queueHealth, transitionService, startCoordinator, liveSessions } = this.deps;\n    return [\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.boardCatalog.path, {\n        method: FACTORY_ROUTE_CONTRACTS.boardCatalog.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          return c.json({\n            boards: [...this.#boards].map(([id, board]) => ({\n              id,\n              title: board.title,\n              initialPhase: board.initialPhase,\n              phases: Object.entries(board.phases).map(([phaseId, phase]) => ({\n                id: phaseId,\n                title: phase.title,\n                kind: phase.kind,\n                ...(phase.kind === 'working' ? { role: phase.role } : {}),\n                transitions: (board.transitions[phaseId] ?? []).map(({ outcome, to }) => ({ outcome, to })),\n              })),\n            })),\n          });\n        },\n      }),\n      // ── List the org's work items for a project, and which are being worked ─\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemList.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemList.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          await workItems.ensureReady();\n          const items = await workItems.list({\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n          });\n          return c.json({\n            workItems: items.map(toWireWorkItem),\n            runningSessionIds: sessionIdsWhere(items, sessionId => liveSessions.isRunning(sessionId)),\n            parkedSessionIds: sessionIdsWhere(items, sessionId => liveSessions.parked(sessionId) !== undefined),\n          });\n        },\n      }),\n\n      // ── Flow metrics aggregated over the project's work items ───────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.metricsGet.path, {\n        method: FACTORY_ROUTE_CONTRACTS.metricsGet.method,\n        requiresAuth: false,\n        handler: async c => {\n          const context = loose(c);\n          const resolved = await this.#resolveProject(context);\n          if ('response' in resolved) return resolved.response;\n          const query = FACTORY_ROUTE_CONTRACTS.metricsGet.querySchema.safeParse({\n            from: context.req.query('from'),\n            to: context.req.query('to'),\n          });\n          if (!query.success) return c.json({ error: 'invalid_metrics_range' }, 400);\n          const { windowStart, windowEnd } = parseMetricsRange(query.data.from, query.data.to, new Date());\n          await workItems.ensureReady();\n          const items = await workItems.list({\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n          });\n          return c.json({ metrics: computeFactoryMetrics(items, { windowStart, windowEnd }) });\n        },\n      }),\n\n      // ── Per-project queue-health age-threshold config (seconds) ─────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.path, {\n        method: FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          await queueHealth.ensureReady();\n          const stored = await queueHealth.getConfig(resolved.orgId, resolved.factoryProjectId);\n          // Validate at the read choke point: `getConfig` round-trips a stored\n          // JSONB row, and only `saveConfig` validates on write — a corrupted or\n          // hand-edited row (empty / non-ascending) would otherwise flow to the\n          // chart and invert bucket colors. Fall back to the default on invalid.\n          return c.json({ thresholds: thresholdsOrDefault(stored) });\n        },\n      }),\n\n      // ── Bounded durable rule-decision status ────────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.decisionList.path, {\n        method: FACTORY_ROUTE_CONTRACTS.decisionList.method,\n        requiresAuth: false,\n        handler: async c => {\n          const context = loose(c);\n          const resolved = await this.#resolveProject(context);\n          if ('response' in resolved) return resolved.response;\n\n          const query = FACTORY_ROUTE_CONTRACTS.decisionList.querySchema.safeParse({\n            statuses: context.req.query('statuses'),\n            before: context.req.query('before'),\n            limit: context.req.query('limit'),\n          });\n          if (!query.success) {\n            const field = query.error.issues[0]?.path[0];\n            return c.json({ error: field === 'before' ? 'invalid_cursor' : 'invalid_decision_query' }, 400);\n          }\n          await workItems.ensureReady();\n          const page = await workItems.listDeferredDecisionPage({\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n            statuses: query.data.statuses,\n            before: query.data.before,\n            limit: query.data.limit,\n          });\n          const last = page.decisions.at(-1);\n          return c.json({\n            decisions: page.decisions.map(decision => decisionSummary(this.#boards, decision)),\n            ...(page.hasMore && last ? { nextCursor: encodeDecisionCursor(last) } : {}),\n          });\n        },\n      }),\n\n      ...buildAttentionRoutes({\n        workItems,\n        comments: this.deps.comments,\n        liveSessions,\n        resolveProject: context => this.#resolveProject(loose(context)),\n      }),\n\n      ...buildSupervisorRoutes({\n        workItems,\n        boards: this.#boards,\n        resolveProject: context => this.#resolveProject(loose(context)),\n      }),\n\n      this.#proposalRoute({ verb: 'approve', settle: workItems.approveDeferredDecision.bind(workItems) }),\n      this.#proposalRoute({ verb: 'dismiss', settle: workItems.dismissDeferredDecision.bind(workItems) }),\n\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.decisionRetry.path, {\n        method: FACTORY_ROUTE_CONTRACTS.decisionRetry.method,\n        requiresAuth: false,\n        handler: async c => {\n          const context = loose(c);\n          const resolved = await this.#resolveProject(context);\n          if ('response' in resolved) return resolved.response;\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.decisionRetry.pathSchema.safeParse({\n            id: resolved.factoryProjectId,\n            decisionId: context.req.param('decisionId'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'invalid_decision_id' }, 422);\n          const { decisionId } = parsedPath.data;\n          await workItems.ensureReady();\n          const current = await workItems.getDeferredDecision(resolved.orgId, resolved.factoryProjectId, decisionId);\n          if (\n            !current ||\n            current.status !== 'failed' ||\n            !factoryDispatchFailureMetadata(current.failureCode).canRetry\n          ) {\n            return c.json({ error: 'decision_not_retryable' }, 409);\n          }\n          const decision = await workItems.retryDeferredDecision(\n            resolved.orgId,\n            resolved.factoryProjectId,\n            decisionId,\n            new Date(),\n          );\n          if (!decision) return c.json({ error: 'decision_not_retryable' }, 409);\n          return c.json({ decision: decisionSummary(this.#boards, decision) });\n        },\n      }),\n\n      // ── Create (upsert on sourceKey) a work item ─────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemCreate.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemCreate.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n\n          const body = await readJson(loose(c));\n          if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n          const input = parseCreateWorkItem(body);\n          if (!input) return c.json({ error: 'invalid_work_item' }, 400);\n          const boardId = input.board ?? (input.externalSource?.type === 'pull-request' ? 'review' : 'work');\n          const board = this.#boards.get(boardId);\n          if (!board) return c.json({ error: 'invalid_board', message: `Board '${boardId}' is not installed.` }, 422);\n          const initialStages = input.stages ?? [board.initialPhase];\n          if (initialStages.length !== 1 || initialStages[0] !== board.initialPhase) {\n            return c.json(\n              {\n                error: 'governed_transition_required',\n                message: `New work items must enter through the '${board.initialPhase}' phase of board '${boardId}'.`,\n              },\n              409,\n            );\n          }\n\n          await workItems.ensureReady();\n          try {\n            const result = await workItems.upsert({\n              orgId: resolved.orgId,\n              userId: resolved.userId,\n              factoryProjectId: resolved.factoryProjectId,\n              input: { ...input, board: boardId, stages: initialStages },\n              reuseMode: 'non-stage',\n            });\n            let item = result.item;\n            if (result.created) {\n              if (!transitionService) {\n                await workItems.delete({ orgId: resolved.orgId, id: item.id });\n                return c.json({ error: 'factory_transitions_unavailable' }, 503);\n              }\n              const entered = await transitionService.transition({\n                orgId: resolved.orgId,\n                factoryProjectId: resolved.factoryProjectId,\n                workItemId: item.id,\n                board: boardId,\n                stage: board.initialPhase,\n                expectedRevision: item.revision,\n                actor: { type: 'human', id: resolved.userId },\n                ...auditRequestOrigin(loose(c)),\n                ingress: { type: 'human', identity: `work-item:${item.id}:initial-entry` },\n                cause: 'work_item_created',\n                initialEntry: true,\n              });\n              if (entered.status === 'rejected') {\n                await workItems.delete({ orgId: resolved.orgId, id: item.id });\n                return c.json({ status: 'rejected', code: entered.code, reason: entered.reason }, 422);\n              }\n              item = (await workItems.getForProject(resolved.orgId, resolved.factoryProjectId, item.id)) ?? item;\n              await audit.emit({\n                context: loose(c),\n                input: {\n                  action: 'factory.work_item.created',\n                  factoryProjectId: resolved.factoryProjectId,\n                  targets: [{ type: 'work_item', id: item.id, name: item.title }],\n                  metadata: { externalSource: item.externalSource, stages: item.stages },\n                },\n              });\n            } else {\n              // Source-key reuse: the POST updated an existing card, not created one.\n              const { stages: _stages, sessions: _sessions, ...boundedPatch } = input;\n              await this.#auditWorkItemPatch({\n                context: loose(c),\n                item,\n                patch: boundedPatch as unknown as Record<string, unknown>,\n              });\n            }\n            return c.json({ workItem: toWireWorkItem(item) });\n          } catch (error) {\n            if (error instanceof WorkItemRelationError) {\n              return c.json({ error: error.code, message: error.message }, 400);\n            }\n            throw error;\n          }\n        },\n      }),\n\n      // ── Authoritative stage transition ──────────────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemTransition.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemTransition.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          const context = loose(c);\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.workItemTransition.pathSchema.safeParse({\n            id: resolved.factoryProjectId,\n            workItemId: context.req.param('workItemId'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n          const { workItemId } = parsedPath.data;\n          const parsed = parseTransitionBody(await readJson(context));\n          if (!parsed) return c.json({ error: 'invalid_transition_request' }, 400);\n          if (!transitionService) {\n            return c.json({ error: 'factory_transition_unavailable' }, 503);\n          }\n          await workItems.ensureReady();\n          const result = await transitionService.transition({\n            ...parsed,\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n            workItemId,\n            actor: { type: 'human', id: resolved.userId },\n            ...auditRequestOrigin(loose(c)),\n            ingress: {\n              ...parsed.ingress,\n              identity: `human:${resolved.userId}:${parsed.ingress.identity}`,\n            },\n          });\n          if (result.status === 'accepted') return c.json({ result });\n          return c.json({ result }, result.code === 'stale' ? 409 : 422);\n        },\n      }),\n\n      // ── Bind a Factory run before dispatching its kickoff ────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemStart.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemStart.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          if (!startCoordinator) {\n            return c.json({ error: 'factory_start_unavailable' }, 503);\n          }\n          const input = parseStartBody(await readJson(loose(c)), resolved, resolved.factoryProjectId);\n          if (!input) return c.json({ error: 'invalid_factory_start' }, 400);\n          input.requestContext = loose(c).get('requestContext');\n          input.defaultModelId = resolved.defaultModelId ?? undefined;\n          await workItems.ensureReady();\n          let prepared: FactoryStartPreparedResult;\n          try {\n            prepared = await startCoordinator.prepare(input);\n          } catch (error) {\n            if (error instanceof FactoryStartTransitionError) {\n              return c.json({ result: error.result }, error.result.code === 'stale' ? 409 : 422);\n            }\n            if (error instanceof WorkItemRepositoryError) {\n              return c.json({ error: error.code, message: error.message, candidates: error.candidates }, 409);\n            }\n            throw error;\n          }\n          return c.json({ prepared }, 202);\n        },\n      }),\n\n      // ── Patch non-stage metadata / sessions / title ──────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemUpdate.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemUpdate.method,\n        requiresAuth: false,\n        handler: async c => {\n          const tenant = await this.#resolveTenant(loose(c));\n          if ('response' in tenant) return tenant.response;\n\n          const context = loose(c);\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.workItemUpdate.pathSchema.safeParse({\n            id: context.req.param('id'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n          const { id } = parsedPath.data;\n\n          const body = await readJson(context);\n          if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n          const patch = parseUpdateWorkItem(body);\n          if (!patch) return c.json({ error: 'invalid_work_item_patch' }, 400);\n\n          await workItems.ensureReady();\n          const existing = await workItems.get({ orgId: tenant.orgId, id });\n          if (!existing) return c.json({ error: 'Work item not found' }, 404);\n          if (patch.board !== undefined) {\n            const board = this.#boards.get(patch.board);\n            const stage = patch.stages?.length === 1 ? patch.stages[0] : undefined;\n            if (existing.board !== null) {\n              return c.json({ error: 'board_already_assigned' }, 409);\n            }\n            if (!board) {\n              return c.json({ error: 'board_not_installed' }, 400);\n            }\n            if (!stage || !Object.prototype.hasOwnProperty.call(board.phases, stage)) {\n              return c.json({ error: 'invalid_board_migration_phase' }, 400);\n            }\n          } else if (patch.stages !== undefined) {\n            return c.json(\n              { error: 'governed_transition_required', message: 'Use the Factory transition endpoint to move stages.' },\n              409,\n            );\n          }\n\n          try {\n            const updated = await workItems.update({\n              orgId: tenant.orgId,\n              id,\n              userId: tenant.userId,\n              patch,\n              ...(patch.board !== undefined ? { expectedRevision: existing.revision, expectedBoard: null } : {}),\n            });\n            if (!updated) return c.json({ error: 'Work item not found' }, 404);\n            await this.#auditWorkItemPatch({\n              context: loose(c),\n              item: updated.item,\n              patch: patch as Record<string, unknown>,\n            });\n            return c.json({ workItem: toWireWorkItem(updated.item) });\n          } catch (error) {\n            if (error instanceof WorkItemRelationError) {\n              return c.json({ error: error.code, message: error.message }, 400);\n            }\n            if (error instanceof WorkItemUpdateConflictError) {\n              return c.json({ error: error.reason === 'board' ? 'board_already_assigned' : error.code }, 409);\n            }\n            throw error;\n          }\n        },\n      }),\n\n      // ── Remove a work item ───────────────────────────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemDelete.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemDelete.method,\n        requiresAuth: false,\n        handler: async c => {\n          const tenant = await this.#resolveTenant(loose(c));\n          if ('response' in tenant) return tenant.response;\n\n          const context = loose(c);\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.workItemDelete.pathSchema.safeParse({\n            id: context.req.param('id'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n          const { id } = parsedPath.data;\n\n          await workItems.ensureReady();\n          const deleted = await workItems.delete({ orgId: tenant.orgId, id });\n          if (!deleted) return c.json({ error: 'Work item not found' }, 404);\n          await audit.emit({\n            context: loose(c),\n            input: {\n              action: 'factory.work_item.deleted',\n              factoryProjectId: deleted.factoryProjectId,\n              targets: [{ type: 'work_item', id: deleted.id, name: deleted.title }],\n            },\n          });\n          return c.json({ ok: true });\n        },\n      }),\n    ];\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"work-items.js","names":["#boards","#defaultBoards","#resolveTenant","#resolveProject","#auditWorkItemPatch","#proposalRoute"],"sources":["../../src/routes/work-items.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for Factory work items (the kanban board).\n *\n * Registered alongside the other `/web/*` routes behind the host auth gate.\n * The board is org-wide: every route re-resolves the caller's `(orgId, userId)`\n * tenant and scopes reads/writes by `orgId`, so any org member sees and moves\n * the same cards while `created_by` / stage history record who acted.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport { createBoardRegistry } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport { EXTERNAL_SOURCE_MISSING_KEY } from '../integrations/issue-reconciler.js';\nimport { overtakenDecisionIds } from '../rules/decision-applicability.js';\nimport { factoryDispatchFailureMetadata } from '../rules/dispatch-errors.js';\nimport type {\n  FactoryStartCoordinator,\n  FactoryStartPreparedResult,\n  FactoryStartRequest,\n} from '../rules/start-coordinator.js';\nimport { FactoryStartTransitionError, WorkItemRepositoryError } from '../rules/start-coordinator.js';\nimport type { FactoryTransitionRequest, FactoryTransitionService } from '../rules/transition-service.js';\nimport type { WorkItemSource } from '../rules/types.js';\nimport type { LiveSessions } from '../session/live-sessions.js';\nimport { auditRequestOrigin } from '../storage/domains/audit/domain.js';\nimport type { AuditEmitter } from '../storage/domains/audit/domain.js';\nimport type { WorkItemCommentsStorage } from '../storage/domains/comments/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { QueueHealthStorage } from '../storage/domains/queue-health/base.js';\nimport { thresholdsOrDefault } from '../storage/domains/queue-health/base.js';\nimport type {\n  CreateWorkItemInput,\n  FactoryDeferredDecisionRecord,\n  UpdateWorkItemInput,\n  WorkItemRow,\n  WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\nimport {\n  FACTORY_PULL_REQUEST_RECONCILIATION_KEY,\n  FACTORY_RULE_MATERIALIZATION_KEY,\n  WorkItemRelationError,\n  WorkItemUpdateConflictError,\n} from '../storage/domains/work-items/base.js';\nimport { computeFactoryMetrics, parseMetricsRange } from '../storage/domains/work-items/metrics.js';\nimport { buildAttentionRoutes, factoryDecisionType } from './attention.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport type { RouteDependencies } from './route.js';\nimport { Route } from './route.js';\nimport { buildSupervisorRoutes } from './supervisor.js';\n\nexport interface WorkItemRoutesDeps extends RouteDependencies {\n  audit: AuditEmitter;\n  /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n  projects: FactoryProjectsStorage;\n  /** Work-items domain backing the kanban board. */\n  workItems: WorkItemsStorage;\n  /** Boards installed for this Factory instance. */\n  boardRegistry?: BoardRegistry;\n  /** Comments domain — backs the mention attention provider. */\n  comments: WorkItemCommentsStorage;\n  /** Per-project queue-health threshold config. */\n  queueHealth: QueueHealthStorage;\n  /** Governed stage-transition service. Stage moves 503 when absent. */\n  transitionService?: Pick<FactoryTransitionService, 'transition' | 'configVersion'>;\n  /** Coordinator that binds a Factory run before dispatching its kickoff. */\n  startCoordinator?: Pick<FactoryStartCoordinator, 'prepare'>;\n  /** Materialized sessions, read to report which of the listed cards are being worked or wait on someone. */\n  liveSessions: Pick<LiveSessions, 'isRunning' | 'parked' | 'parkedIn'>;\n}\n\n/** The card as clients see it, without the dispatcher's internal bookkeeping. */\nfunction toWireWorkItem(item: WorkItemRow): WorkItemRow {\n  if (\n    !item.metadata ||\n    (!(FACTORY_RULE_MATERIALIZATION_KEY in item.metadata) &&\n      !(FACTORY_PULL_REQUEST_RECONCILIATION_KEY in item.metadata) &&\n      !(EXTERNAL_SOURCE_MISSING_KEY in item.metadata))\n  ) {\n    return item;\n  }\n  return { ...item, metadata: publicWorkItemMetadata(item.metadata) ?? {} };\n}\n\n/** Session ids of the listed cards that the predicate picks, each once. */\nfunction sessionIdsWhere(items: WorkItemRow[], predicate: (sessionId: string) => boolean): string[] {\n  const picked = new Set<string>();\n  for (const item of items) {\n    for (const { sessionId } of Object.values(item.sessions)) {\n      if (predicate(sessionId)) picked.add(sessionId);\n    }\n  }\n  return [...picked];\n}\n\nfunction loose(c: unknown): Context {\n  return c as Context;\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction publicWorkItemMetadata(value: Record<string, unknown> | null): Record<string, unknown> | null {\n  if (value === null) return null;\n  const {\n    [FACTORY_RULE_MATERIALIZATION_KEY]: _materialization,\n    [FACTORY_PULL_REQUEST_RECONCILIATION_KEY]: _reconciliation,\n    [EXTERNAL_SOURCE_MISSING_KEY]: _externalSourceMissingAt,\n    ...metadata\n  } = value;\n  return metadata;\n}\n\n/** Validate an untrusted create body. Unknown keys are dropped. */\nexport function parseCreateWorkItem(body: unknown): CreateWorkItemInput | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemCreate.bodySchema.safeParse(body);\n  return parsed.success ? parsed.data : null;\n}\n\n/** Validate an untrusted patch body. Unknown keys are dropped. */\nexport function parseUpdateWorkItem(body: unknown): UpdateWorkItemInput | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemUpdate.bodySchema.safeParse(body);\n  return parsed.success ? parsed.data : null;\n}\n\nasync function readJson(c: Context): Promise<unknown | undefined> {\n  try {\n    return await c.req.json();\n  } catch {\n    return undefined;\n  }\n}\n\n/** Fields a PATCH touched, for the bounded `updated` event summary. */\nfunction patchedFields(patch: Record<string, unknown>): string[] {\n  return Object.keys(patch).filter(key => patch[key] !== undefined);\n}\n\nfunction parseTransitionBody(\n  body: unknown,\n): Omit<FactoryTransitionRequest, 'orgId' | 'factoryProjectId' | 'workItemId' | 'actor'> | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemTransition.bodySchema.safeParse(body);\n  return parsed.success ? parsed.data : null;\n}\n\nfunction parseStartBody(\n  body: unknown,\n  tenant: { orgId: string; userId: string },\n  factoryProjectId: string,\n): FactoryStartRequest | null {\n  const parsed = FACTORY_ROUTE_CONTRACTS.workItemStart.bodySchema.safeParse(body);\n  return parsed.success ? { ...tenant, factoryProjectId, ...parsed.data } : null;\n}\n\nfunction encodeDecisionCursor(decision: FactoryDeferredDecisionRecord): string {\n  return Buffer.from(JSON.stringify([decision.createdAt.toISOString(), decision.id]), 'utf8').toString('base64url');\n}\n\n/** A proposed transition names the seat its lane addresses, so the card can label what approving starts. */\nfunction summaryRole(boards: BoardRegistry, decision: Record<string, unknown>): string | null {\n  if (typeof decision.role === 'string') return decision.role.slice(0, 32);\n  if (decision.type !== 'transition') return null;\n  const { board, stage } = decision;\n  if (typeof board !== 'string' || typeof stage !== 'string') return null;\n  return boards.get(board)?.roleForPhase(stage) ?? null;\n}\n\n/** A linked-card decision names where the card is synced from, so the UI can say \"GitHub\" rather than \"a linked card\". */\nfunction summarySource(decision: Record<string, unknown>): WorkItemSource | null {\n  if (decision.type !== 'upsertLinkedWorkItem') return null;\n  const source = decision.source;\n  return source === 'github-issue' ||\n    source === 'github-pr' ||\n    source === 'gitlab-issue' ||\n    source === 'gitlab-pr' ||\n    source === 'linear-issue' ||\n    source === 'manual'\n    ? source\n    : null;\n}\n\nfunction decisionSummary(boards: BoardRegistry, decision: FactoryDeferredDecisionRecord, overtaken = false) {\n  return {\n    id: decision.id,\n    evaluationId: decision.evaluationId,\n    workItemId: decision.workItemId,\n    type: factoryDecisionType(decision),\n    role: summaryRole(boards, decision.decision),\n    source: summarySource(decision.decision),\n    status: decision.status,\n    attempts: decision.attempts,\n    failureOccurrence: decision.failureOccurrence,\n    failureCode: decision.failureCode,\n    canRetry: !overtaken && factoryDispatchFailureMetadata(decision.failureCode).canRetry,\n    lastError: decision.lastError?.slice(0, 512) ?? null,\n    createdAt: decision.createdAt.toISOString(),\n    updatedAt: decision.updatedAt.toISOString(),\n    completedAt: decision.completedAt?.toISOString() ?? null,\n  };\n}\n\nexport class WorkItemRoutes extends Route<WorkItemRoutesDeps> {\n  #defaultBoards: BoardRegistry | undefined;\n\n  get #boards(): BoardRegistry {\n    return this.deps.boardRegistry ?? (this.#defaultBoards ??= createBoardRegistry());\n  }\n\n  /** Resolve the `(orgId, userId)` tenant or a ready-to-return error response. */\n  async #resolveTenant(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n    await this.deps.auth.ensureUser(c);\n    const tenant = this.deps.auth.tenant(c);\n    if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n    if (!tenant.orgId) {\n      return {\n        response: c.json(\n          { error: 'organization_required', message: 'The Factory board requires an organization.' },\n          403,\n        ),\n      };\n    }\n    return { orgId: tenant.orgId, userId: tenant.userId };\n  }\n\n  /**\n   * Resolve the tenant AND the org-owned project from the `:id` param. Work\n   * items hang off a project, so listing/creating requires the project to\n   * exist in the caller's org.\n   */\n  async #resolveProject(\n    c: Context,\n  ): Promise<\n    { orgId: string; userId: string; factoryProjectId: string; defaultModelId: string | null } | { response: Response }\n  > {\n    const tenant = await this.#resolveTenant(c);\n    if ('response' in tenant) return tenant;\n\n    const parsedPath = FACTORY_ROUTE_CONTRACTS.projectGet.pathSchema.safeParse({ id: c.req.param('id') });\n    if (!parsedPath.success) {\n      return { response: c.json({ error: 'Project not found' }, 404) };\n    }\n    const projectId = parsedPath.data.id;\n    const { projects } = this.deps;\n    await projects.ensureReady();\n    const project = await projects.get({ orgId: tenant.orgId, id: projectId });\n    if (!project) {\n      return { response: c.json({ error: 'Project not found' }, 404) };\n    }\n    return { ...tenant, factoryProjectId: projectId, defaultModelId: project.defaultModelId };\n  }\n\n  async #auditWorkItemPatch({\n    context,\n    item,\n    patch,\n  }: {\n    context: Context;\n    item: WorkItemRow;\n    patch: Record<string, unknown>;\n  }): Promise<void> {\n    await this.deps.audit.emit({\n      context,\n      input: {\n        action: 'factory.work_item.updated',\n        factoryProjectId: item.factoryProjectId,\n        targets: [{ type: 'work_item', id: item.id, name: item.title }],\n        metadata: { fields: patchedFields(patch) },\n      },\n    });\n  }\n\n  /** Releasing a parked run and dropping it: same request, opposite outcomes, both audited as consent. */\n  #proposalRoute({\n    verb,\n    settle,\n  }: {\n    verb: 'approve' | 'dismiss';\n    settle: (\n      orgId: string,\n      factoryProjectId: string,\n      decisionId: string,\n      now: Date,\n      userId: string,\n    ) => Promise<FactoryDeferredDecisionRecord | null>;\n  }): ApiRoute {\n    const { audit, workItems } = this.deps;\n    const contract =\n      verb === 'approve' ? FACTORY_ROUTE_CONTRACTS.decisionApprove : FACTORY_ROUTE_CONTRACTS.decisionDismiss;\n    return registerApiRoute(contract.path, {\n      method: contract.method,\n      requiresAuth: false,\n      handler: async c => {\n        const context = loose(c);\n        const resolved = await this.#resolveProject(context);\n        if ('response' in resolved) return resolved.response;\n        const parsedPath = contract.pathSchema.safeParse({\n          id: resolved.factoryProjectId,\n          decisionId: context.req.param('decisionId'),\n        });\n        if (!parsedPath.success) return c.json({ error: 'invalid_decision_id' }, 422);\n        const { decisionId } = parsedPath.data;\n        await workItems.ensureReady();\n        const now = new Date();\n        const decision = await settle(resolved.orgId, resolved.factoryProjectId, decisionId, now, resolved.userId);\n        if (!decision) return c.json({ error: 'decision_not_proposed' }, 409);\n        // Releasing a proposal is a person taking the item on. Approval arms the\n        // item's autonomy inside the same storage transaction (see\n        // approveDeferredDecision), so follow-up runs no longer wait for approval.\n        await audit.emit({\n          context,\n          input: {\n            action: verb === 'approve' ? 'factory.run.approved' : 'factory.run.dismissed',\n            factoryProjectId: resolved.factoryProjectId,\n            targets: decision.workItemId\n              ? [{ type: 'work_item', id: decision.workItemId }]\n              : [{ type: 'rule_decision', id: decision.id }],\n            metadata: { decisionId: decision.id, effect: factoryDecisionType(decision) },\n          },\n        });\n        return c.json({ decision: decisionSummary(this.#boards, decision) });\n      },\n    });\n  }\n\n  /** Build the Factory work-item routes as Mastra `apiRoutes`. */\n  routes(): ApiRoute[] {\n    const { audit, workItems, queueHealth, transitionService, startCoordinator, liveSessions } = this.deps;\n    return [\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.boardCatalog.path, {\n        method: FACTORY_ROUTE_CONTRACTS.boardCatalog.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          return c.json({\n            boards: [...this.#boards].map(([id, board]) => ({\n              id,\n              title: board.title,\n              initialPhase: board.initialPhase,\n              phases: Object.entries(board.phases).map(([phaseId, phase]) => ({\n                id: phaseId,\n                title: phase.title,\n                kind: phase.kind,\n                ...(phase.kind === 'working' ? { role: phase.role } : {}),\n                transitions: (board.transitions[phaseId] ?? []).map(({ outcome, to }) => ({ outcome, to })),\n              })),\n            })),\n          });\n        },\n      }),\n      // ── List the org's work items for a project, and which are being worked ─\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemList.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemList.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          await workItems.ensureReady();\n          const items = await workItems.list({\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n          });\n          return c.json({\n            workItems: items.map(toWireWorkItem),\n            runningSessionIds: sessionIdsWhere(items, sessionId => liveSessions.isRunning(sessionId)),\n            parkedSessionIds: sessionIdsWhere(items, sessionId => liveSessions.parked(sessionId) !== undefined),\n          });\n        },\n      }),\n\n      // ── Flow metrics aggregated over the project's work items ───────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.metricsGet.path, {\n        method: FACTORY_ROUTE_CONTRACTS.metricsGet.method,\n        requiresAuth: false,\n        handler: async c => {\n          const context = loose(c);\n          const resolved = await this.#resolveProject(context);\n          if ('response' in resolved) return resolved.response;\n          const query = FACTORY_ROUTE_CONTRACTS.metricsGet.querySchema.safeParse({\n            from: context.req.query('from'),\n            to: context.req.query('to'),\n          });\n          if (!query.success) return c.json({ error: 'invalid_metrics_range' }, 400);\n          const { windowStart, windowEnd } = parseMetricsRange(query.data.from, query.data.to, new Date());\n          await workItems.ensureReady();\n          const items = await workItems.list({\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n          });\n          return c.json({ metrics: computeFactoryMetrics(items, { windowStart, windowEnd }) });\n        },\n      }),\n\n      // ── Per-project queue-health age-threshold config (seconds) ─────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.path, {\n        method: FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          await queueHealth.ensureReady();\n          const stored = await queueHealth.getConfig(resolved.orgId, resolved.factoryProjectId);\n          // Validate at the read choke point: `getConfig` round-trips a stored\n          // JSONB row, and only `saveConfig` validates on write — a corrupted or\n          // hand-edited row (empty / non-ascending) would otherwise flow to the\n          // chart and invert bucket colors. Fall back to the default on invalid.\n          return c.json({ thresholds: thresholdsOrDefault(stored) });\n        },\n      }),\n\n      // ── Bounded durable rule-decision status ────────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.decisionList.path, {\n        method: FACTORY_ROUTE_CONTRACTS.decisionList.method,\n        requiresAuth: false,\n        handler: async c => {\n          const context = loose(c);\n          const resolved = await this.#resolveProject(context);\n          if ('response' in resolved) return resolved.response;\n\n          const query = FACTORY_ROUTE_CONTRACTS.decisionList.querySchema.safeParse({\n            statuses: context.req.query('statuses'),\n            before: context.req.query('before'),\n            limit: context.req.query('limit'),\n          });\n          if (!query.success) {\n            const field = query.error.issues[0]?.path[0];\n            return c.json({ error: field === 'before' ? 'invalid_cursor' : 'invalid_decision_query' }, 400);\n          }\n          await workItems.ensureReady();\n          const page = await workItems.listDeferredDecisionPage({\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n            statuses: query.data.statuses,\n            before: query.data.before,\n            limit: query.data.limit,\n          });\n          const last = page.decisions.at(-1);\n          const overtaken = await overtakenDecisionIds(\n            workItems,\n            this.#boards,\n            resolved,\n            page.decisions.filter(decision => decision.status === 'failed'),\n          );\n          return c.json({\n            decisions: page.decisions.map(decision =>\n              decisionSummary(this.#boards, decision, overtaken.has(decision.id)),\n            ),\n            ...(page.hasMore && last ? { nextCursor: encodeDecisionCursor(last) } : {}),\n          });\n        },\n      }),\n\n      ...buildAttentionRoutes({\n        workItems,\n        boards: this.#boards,\n        comments: this.deps.comments,\n        liveSessions,\n        resolveProject: context => this.#resolveProject(loose(context)),\n      }),\n\n      ...buildSupervisorRoutes({\n        workItems,\n        boards: this.#boards,\n        resolveProject: context => this.#resolveProject(loose(context)),\n      }),\n\n      this.#proposalRoute({ verb: 'approve', settle: workItems.approveDeferredDecision.bind(workItems) }),\n      this.#proposalRoute({ verb: 'dismiss', settle: workItems.dismissDeferredDecision.bind(workItems) }),\n\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.decisionRetry.path, {\n        method: FACTORY_ROUTE_CONTRACTS.decisionRetry.method,\n        requiresAuth: false,\n        handler: async c => {\n          const context = loose(c);\n          const resolved = await this.#resolveProject(context);\n          if ('response' in resolved) return resolved.response;\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.decisionRetry.pathSchema.safeParse({\n            id: resolved.factoryProjectId,\n            decisionId: context.req.param('decisionId'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'invalid_decision_id' }, 422);\n          const { decisionId } = parsedPath.data;\n          await workItems.ensureReady();\n          const current = await workItems.getDeferredDecision(resolved.orgId, resolved.factoryProjectId, decisionId);\n          if (\n            !current ||\n            current.status !== 'failed' ||\n            !factoryDispatchFailureMetadata(current.failureCode).canRetry\n          ) {\n            return c.json({ error: 'decision_not_retryable' }, 409);\n          }\n          // A run decided for a phase the card has left would seat the old role on it.\n          if ((await overtakenDecisionIds(workItems, this.#boards, resolved, [current])).size > 0) {\n            return c.json({ error: 'decision_not_retryable' }, 409);\n          }\n          const decision = await workItems.retryDeferredDecision(\n            resolved.orgId,\n            resolved.factoryProjectId,\n            decisionId,\n            new Date(),\n          );\n          if (!decision) return c.json({ error: 'decision_not_retryable' }, 409);\n          return c.json({ decision: decisionSummary(this.#boards, decision) });\n        },\n      }),\n\n      // ── Create (upsert on sourceKey) a work item ─────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemCreate.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemCreate.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n\n          const body = await readJson(loose(c));\n          if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n          const input = parseCreateWorkItem(body);\n          if (!input) return c.json({ error: 'invalid_work_item' }, 400);\n          const boardId = input.board ?? (input.externalSource?.type === 'pull-request' ? 'review' : 'work');\n          const board = this.#boards.get(boardId);\n          if (!board) return c.json({ error: 'invalid_board', message: `Board '${boardId}' is not installed.` }, 422);\n          const initialStages = input.stages ?? [board.initialPhase];\n          if (initialStages.length !== 1 || initialStages[0] !== board.initialPhase) {\n            return c.json(\n              {\n                error: 'governed_transition_required',\n                message: `New work items must enter through the '${board.initialPhase}' phase of board '${boardId}'.`,\n              },\n              409,\n            );\n          }\n\n          await workItems.ensureReady();\n          try {\n            const result = await workItems.upsert({\n              orgId: resolved.orgId,\n              userId: resolved.userId,\n              factoryProjectId: resolved.factoryProjectId,\n              input: { ...input, board: boardId, stages: initialStages },\n              reuseMode: 'non-stage',\n            });\n            let item = result.item;\n            if (result.created) {\n              if (!transitionService) {\n                await workItems.delete({ orgId: resolved.orgId, id: item.id });\n                return c.json({ error: 'factory_transitions_unavailable' }, 503);\n              }\n              const entered = await transitionService.transition({\n                orgId: resolved.orgId,\n                factoryProjectId: resolved.factoryProjectId,\n                workItemId: item.id,\n                board: boardId,\n                stage: board.initialPhase,\n                expectedRevision: item.revision,\n                actor: { type: 'human', id: resolved.userId },\n                ...auditRequestOrigin(loose(c)),\n                ingress: { type: 'human', identity: `work-item:${item.id}:initial-entry` },\n                cause: 'work_item_created',\n                initialEntry: true,\n              });\n              if (entered.status === 'rejected') {\n                await workItems.delete({ orgId: resolved.orgId, id: item.id });\n                return c.json({ status: 'rejected', code: entered.code, reason: entered.reason }, 422);\n              }\n              item = (await workItems.getForProject(resolved.orgId, resolved.factoryProjectId, item.id)) ?? item;\n              await audit.emit({\n                context: loose(c),\n                input: {\n                  action: 'factory.work_item.created',\n                  factoryProjectId: resolved.factoryProjectId,\n                  targets: [{ type: 'work_item', id: item.id, name: item.title }],\n                  metadata: { externalSource: item.externalSource, stages: item.stages },\n                },\n              });\n            } else {\n              // Source-key reuse: the POST updated an existing card, not created one.\n              const { stages: _stages, sessions: _sessions, ...boundedPatch } = input;\n              await this.#auditWorkItemPatch({\n                context: loose(c),\n                item,\n                patch: boundedPatch as unknown as Record<string, unknown>,\n              });\n            }\n            return c.json({ workItem: toWireWorkItem(item) });\n          } catch (error) {\n            if (error instanceof WorkItemRelationError) {\n              return c.json({ error: error.code, message: error.message }, 400);\n            }\n            throw error;\n          }\n        },\n      }),\n\n      // ── Authoritative stage transition ──────────────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemTransition.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemTransition.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          const context = loose(c);\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.workItemTransition.pathSchema.safeParse({\n            id: resolved.factoryProjectId,\n            workItemId: context.req.param('workItemId'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n          const { workItemId } = parsedPath.data;\n          const parsed = parseTransitionBody(await readJson(context));\n          if (!parsed) return c.json({ error: 'invalid_transition_request' }, 400);\n          if (!transitionService) {\n            return c.json({ error: 'factory_transition_unavailable' }, 503);\n          }\n          await workItems.ensureReady();\n          const result = await transitionService.transition({\n            ...parsed,\n            orgId: resolved.orgId,\n            factoryProjectId: resolved.factoryProjectId,\n            workItemId,\n            actor: { type: 'human', id: resolved.userId },\n            ...auditRequestOrigin(loose(c)),\n            ingress: {\n              ...parsed.ingress,\n              identity: `human:${resolved.userId}:${parsed.ingress.identity}`,\n            },\n          });\n          if (result.status === 'accepted') return c.json({ result });\n          return c.json({ result }, result.code === 'stale' ? 409 : 422);\n        },\n      }),\n\n      // ── Bind a Factory run before dispatching its kickoff ────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemStart.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemStart.method,\n        requiresAuth: false,\n        handler: async c => {\n          const resolved = await this.#resolveProject(loose(c));\n          if ('response' in resolved) return resolved.response;\n          if (!startCoordinator) {\n            return c.json({ error: 'factory_start_unavailable' }, 503);\n          }\n          const input = parseStartBody(await readJson(loose(c)), resolved, resolved.factoryProjectId);\n          if (!input) return c.json({ error: 'invalid_factory_start' }, 400);\n          input.requestContext = loose(c).get('requestContext');\n          input.defaultModelId = resolved.defaultModelId ?? undefined;\n          await workItems.ensureReady();\n          let prepared: FactoryStartPreparedResult;\n          try {\n            prepared = await startCoordinator.prepare(input);\n          } catch (error) {\n            if (error instanceof FactoryStartTransitionError) {\n              return c.json({ result: error.result }, error.result.code === 'stale' ? 409 : 422);\n            }\n            if (error instanceof WorkItemRepositoryError) {\n              return c.json({ error: error.code, message: error.message, candidates: error.candidates }, 409);\n            }\n            throw error;\n          }\n          return c.json({ prepared }, 202);\n        },\n      }),\n\n      // ── Patch non-stage metadata / sessions / title ──────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemUpdate.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemUpdate.method,\n        requiresAuth: false,\n        handler: async c => {\n          const tenant = await this.#resolveTenant(loose(c));\n          if ('response' in tenant) return tenant.response;\n\n          const context = loose(c);\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.workItemUpdate.pathSchema.safeParse({\n            id: context.req.param('id'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n          const { id } = parsedPath.data;\n\n          const body = await readJson(context);\n          if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n          const patch = parseUpdateWorkItem(body);\n          if (!patch) return c.json({ error: 'invalid_work_item_patch' }, 400);\n\n          await workItems.ensureReady();\n          const existing = await workItems.get({ orgId: tenant.orgId, id });\n          if (!existing) return c.json({ error: 'Work item not found' }, 404);\n          if (patch.board !== undefined) {\n            const board = this.#boards.get(patch.board);\n            const stage = patch.stages?.length === 1 ? patch.stages[0] : undefined;\n            if (existing.board !== null) {\n              return c.json({ error: 'board_already_assigned' }, 409);\n            }\n            if (!board) {\n              return c.json({ error: 'board_not_installed' }, 400);\n            }\n            if (!stage || !Object.prototype.hasOwnProperty.call(board.phases, stage)) {\n              return c.json({ error: 'invalid_board_migration_phase' }, 400);\n            }\n          } else if (patch.stages !== undefined) {\n            return c.json(\n              { error: 'governed_transition_required', message: 'Use the Factory transition endpoint to move stages.' },\n              409,\n            );\n          }\n\n          try {\n            const updated = await workItems.update({\n              orgId: tenant.orgId,\n              id,\n              userId: tenant.userId,\n              patch,\n              ...(patch.board !== undefined ? { expectedRevision: existing.revision, expectedBoard: null } : {}),\n            });\n            if (!updated) return c.json({ error: 'Work item not found' }, 404);\n            await this.#auditWorkItemPatch({\n              context: loose(c),\n              item: updated.item,\n              patch: patch as Record<string, unknown>,\n            });\n            return c.json({ workItem: toWireWorkItem(updated.item) });\n          } catch (error) {\n            if (error instanceof WorkItemRelationError) {\n              return c.json({ error: error.code, message: error.message }, 400);\n            }\n            if (error instanceof WorkItemUpdateConflictError) {\n              return c.json({ error: error.reason === 'board' ? 'board_already_assigned' : error.code }, 409);\n            }\n            throw error;\n          }\n        },\n      }),\n\n      // ── Remove a work item ───────────────────────────────────────────────────\n      registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemDelete.path, {\n        method: FACTORY_ROUTE_CONTRACTS.workItemDelete.method,\n        requiresAuth: false,\n        handler: async c => {\n          const tenant = await this.#resolveTenant(loose(c));\n          if ('response' in tenant) return tenant.response;\n\n          const context = loose(c);\n          const parsedPath = FACTORY_ROUTE_CONTRACTS.workItemDelete.pathSchema.safeParse({\n            id: context.req.param('id'),\n          });\n          if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n          const { id } = parsedPath.data;\n\n          await workItems.ensureReady();\n          const deleted = await workItems.delete({ orgId: tenant.orgId, id });\n          if (!deleted) return c.json({ error: 'Work item not found' }, 404);\n          await audit.emit({\n            context: loose(c),\n            input: {\n              action: 'factory.work_item.deleted',\n              factoryProjectId: deleted.factoryProjectId,\n              targets: [{ type: 'work_item', id: deleted.id, name: deleted.title }],\n            },\n          });\n          return c.json({ ok: true });\n        },\n      }),\n    ];\n  }\n}\n"],"mappings":"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"}

package/dist/rules/decision-applicability.d.ts

@@ -0,0 +1,26 @@
+import type { BoardRegistry } from '../boards/index.js';
+import type { FactoryDeferredDecisionRecord, WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
+type ApplicabilityRecord = Pick<FactoryDeferredDecisionRecord, 'id' | 'evaluationId' | 'createdAt' | 'decision'>;
+/** The seat a skill run needs; other decision types are not tied to one phase. */
+export declare function skillDecisionRole(record: Pick<FactoryDeferredDecisionRecord, 'decision'>): string | undefined;
+/**
+ * Whether the card has moved on from the phase a run was decided for: any stage it
+ * now sits in was entered after the decision. Anchored on the decision rather than
+ * an attempt, so a retry after the move is still recognised as stale, and a card
+ * that left and came back to the same role is a new phase entry.
+ */
+export declare function decisionOvertaken(input: {
+    boards: BoardRegistry;
+    item: WorkItemRow | null;
+    record: ApplicabilityRecord;
+    role: string;
+    /** Decisions from the same rule evaluation as `record`. */
+    siblings: ApplicabilityRecord[];
+}): boolean;
+/** Ids of the given skill-run decisions whose card has moved on from their phase. */
+export declare function overtakenDecisionIds(workItems: Pick<WorkItemsStorage, 'listByIds' | 'listDecisionsForEvaluations'>, boards: BoardRegistry, scope: {
+    orgId: string;
+    factoryProjectId: string;
+}, records: FactoryDeferredDecisionRecord[]): Promise<Set<string>>;
+export {};
+//# sourceMappingURL=decision-applicability.d.ts.map

package/dist/rules/decision-applicability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-applicability.d.ts","sourceRoot":"","sources":["../../src/rules/decision-applicability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,6BAA6B,EAC7B,WAAW,EACX,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAE/C,KAAK,mBAAmB,GAAG,IAAI,CAAC,6BAA6B,EAAE,IAAI,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAEjH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAG7G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,GAAG,OAAO,CA4BV;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,6BAA6B,CAAC,EAC9E,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,EAAE,6BAA6B,EAAE,GACvC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAyBtB"}

package/dist/rules/decision-applicability.js

@@ -0,0 +1,47 @@
+import { boardForWorkItem, resolvePhaseSemantics } from "../boards/semantics.js";
+import "../boards/index.js";
+//#region src/rules/decision-applicability.ts
+/** The seat a skill run needs; other decision types are not tied to one phase. */
+function skillDecisionRole(record) {
+	const { type, role } = record.decision;
+	return type === "invokeSkill" && typeof role === "string" ? role : void 0;
+}
+/**
+* Whether the card has moved on from the phase a run was decided for: any stage it
+* now sits in was entered after the decision. Anchored on the decision rather than
+* an attempt, so a retry after the move is still recognised as stale, and a card
+* that left and came back to the same role is a new phase entry.
+*/
+function decisionOvertaken(input) {
+	const { boards, item, record, role } = input;
+	if (item === null) return true;
+	const decidedAt = record.createdAt.getTime();
+	const enteredSince = item.stageHistory.filter((entry) => entry.exitedAt === void 0 && new Date(entry.enteredAt).getTime() > decidedAt);
+	const board = boardForWorkItem(item);
+	const carriesRole = (stage) => resolvePhaseSemantics(boards, board, stage)?.role === role;
+	const movedOn = !item.stageHistory.some((entry) => new Date(entry.enteredAt).getTime() <= decidedAt && (entry.exitedAt === void 0 || new Date(entry.exitedAt).getTime() > decidedAt) && carriesRole(entry.stage)) ? enteredSince.filter((entry) => !carriesRole(entry.stage)) : enteredSince;
+	if (movedOn.length === 0) return false;
+	const siblingStages = new Set(input.siblings.filter((sibling) => sibling.evaluationId === record.evaluationId && sibling.decision.type === "transition").map((sibling) => sibling.decision.stage));
+	return movedOn.some((entry) => !siblingStages.has(entry.stage));
+}
+/** Ids of the given skill-run decisions whose card has moved on from their phase. */
+async function overtakenDecisionIds(workItems, boards, scope, records) {
+	const candidates = records.filter((record) => record.workItemId !== null && skillDecisionRole(record) !== void 0);
+	if (candidates.length === 0) return /* @__PURE__ */ new Set();
+	const [items, siblings] = await Promise.all([workItems.listByIds({
+		...scope,
+		ids: [...new Set(candidates.map((record) => record.workItemId))]
+	}), workItems.listDecisionsForEvaluations(scope.orgId, scope.factoryProjectId, candidates.map((record) => record.evaluationId))]);
+	const itemsById = new Map(items.map((item) => [item.id, item]));
+	return new Set(candidates.filter((record) => decisionOvertaken({
+		boards,
+		item: itemsById.get(record.workItemId) ?? null,
+		record,
+		role: skillDecisionRole(record),
+		siblings
+	})).map((record) => record.id));
+}
+//#endregion
+export { decisionOvertaken, overtakenDecisionIds, skillDecisionRole };
+
+//# sourceMappingURL=decision-applicability.js.map

package/dist/rules/decision-applicability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-applicability.js","names":[],"sources":["../../src/rules/decision-applicability.ts"],"sourcesContent":["import { boardForWorkItem, resolvePhaseSemantics } from '../boards/index.js';\nimport type { BoardRegistry } from '../boards/index.js';\nimport type {\n  FactoryDeferredDecisionRecord,\n  WorkItemRow,\n  WorkItemsStorage,\n} from '../storage/domains/work-items/base.js';\n\ntype ApplicabilityRecord = Pick<FactoryDeferredDecisionRecord, 'id' | 'evaluationId' | 'createdAt' | 'decision'>;\n\n/** The seat a skill run needs; other decision types are not tied to one phase. */\nexport function skillDecisionRole(record: Pick<FactoryDeferredDecisionRecord, 'decision'>): string | undefined {\n  const { type, role } = record.decision;\n  return type === 'invokeSkill' && typeof role === 'string' ? role : undefined;\n}\n\n/**\n * Whether the card has moved on from the phase a run was decided for: any stage it\n * now sits in was entered after the decision. Anchored on the decision rather than\n * an attempt, so a retry after the move is still recognised as stale, and a card\n * that left and came back to the same role is a new phase entry.\n */\nexport function decisionOvertaken(input: {\n  boards: BoardRegistry;\n  item: WorkItemRow | null;\n  record: ApplicabilityRecord;\n  role: string;\n  /** Decisions from the same rule evaluation as `record`. */\n  siblings: ApplicabilityRecord[];\n}): boolean {\n  const { boards, item, record, role } = input;\n  if (item === null) return true;\n  const decidedAt = record.createdAt.getTime();\n  const enteredSince = item.stageHistory.filter(\n    entry => entry.exitedAt === undefined && new Date(entry.enteredAt).getTime() > decidedAt,\n  );\n  // A run decided while the card sat outside its seat's stages (a held\n  // triage in Intake) is fulfilled, not overtaken, when the card first\n  // enters a stage that seat carries — e.g. the Investigate click.\n  const board = boardForWorkItem(item);\n  const carriesRole = (stage: string) => resolvePhaseSemantics(boards, board, stage)?.role === role;\n  const decidedOutsideRole = !item.stageHistory.some(\n    entry =>\n      new Date(entry.enteredAt).getTime() <= decidedAt &&\n      (entry.exitedAt === undefined || new Date(entry.exitedAt).getTime() > decidedAt) &&\n      carriesRole(entry.stage),\n  );\n  const movedOn = decidedOutsideRole ? enteredSince.filter(entry => !carriesRole(entry.stage)) : enteredSince;\n  if (movedOn.length === 0) return false;\n  // A transition from the same rule evaluation lands after this decision\n  // was created; entering that stage is part of this run's intent.\n  const siblingStages = new Set(\n    input.siblings\n      .filter(sibling => sibling.evaluationId === record.evaluationId && sibling.decision.type === 'transition')\n      .map(sibling => sibling.decision.stage),\n  );\n  return movedOn.some(entry => !siblingStages.has(entry.stage));\n}\n\n/** Ids of the given skill-run decisions whose card has moved on from their phase. */\nexport async function overtakenDecisionIds(\n  workItems: Pick<WorkItemsStorage, 'listByIds' | 'listDecisionsForEvaluations'>,\n  boards: BoardRegistry,\n  scope: { orgId: string; factoryProjectId: string },\n  records: FactoryDeferredDecisionRecord[],\n): Promise<Set<string>> {\n  const candidates = records.filter(record => record.workItemId !== null && skillDecisionRole(record) !== undefined);\n  if (candidates.length === 0) return new Set();\n  const [items, siblings] = await Promise.all([\n    workItems.listByIds({ ...scope, ids: [...new Set(candidates.map(record => record.workItemId!))] }),\n    workItems.listDecisionsForEvaluations(\n      scope.orgId,\n      scope.factoryProjectId,\n      candidates.map(record => record.evaluationId),\n    ),\n  ]);\n  const itemsById = new Map(items.map(item => [item.id, item]));\n  return new Set(\n    candidates\n      .filter(record =>\n        decisionOvertaken({\n          boards,\n          item: itemsById.get(record.workItemId!) ?? null,\n          record,\n          role: skillDecisionRole(record)!,\n          siblings,\n        }),\n      )\n      .map(record => record.id),\n  );\n}\n"],"mappings":";;;;AAWA,SAAgB,kBAAkB,QAA6E;CAC7G,MAAM,EAAE,MAAM,SAAS,OAAO;CAC9B,OAAO,SAAS,iBAAiB,OAAO,SAAS,WAAW,OAAO,KAAA;AACrE;;;;;;;AAQA,SAAgB,kBAAkB,OAOtB;CACV,MAAM,EAAE,QAAQ,MAAM,QAAQ,SAAS;CACvC,IAAI,SAAS,MAAM,OAAO;CAC1B,MAAM,YAAY,OAAO,UAAU,QAAQ;CAC3C,MAAM,eAAe,KAAK,aAAa,QACrC,UAAS,MAAM,aAAa,KAAA,KAAa,IAAI,KAAK,MAAM,SAAS,CAAC,CAAC,QAAQ,IAAI,SACjF;CAIA,MAAM,QAAQ,iBAAiB,IAAI;CACnC,MAAM,eAAe,UAAkB,sBAAsB,QAAQ,OAAO,KAAK,CAAC,EAAE,SAAS;CAO7F,MAAM,UAAU,CANY,KAAK,aAAa,MAC5C,UACE,IAAI,KAAK,MAAM,SAAS,CAAC,CAAC,QAAQ,KAAK,cACtC,MAAM,aAAa,KAAA,KAAa,IAAI,KAAK,MAAM,QAAQ,CAAC,CAAC,QAAQ,IAAI,cACtE,YAAY,MAAM,KAAK,CAC3B,IACqC,aAAa,QAAO,UAAS,CAAC,YAAY,MAAM,KAAK,CAAC,IAAI;CAC/F,IAAI,QAAQ,WAAW,GAAG,OAAO;CAGjC,MAAM,gBAAgB,IAAI,IACxB,MAAM,SACH,QAAO,YAAW,QAAQ,iBAAiB,OAAO,gBAAgB,QAAQ,SAAS,SAAS,YAAY,CAAC,CACzG,KAAI,YAAW,QAAQ,SAAS,KAAK,CAC1C;CACA,OAAO,QAAQ,MAAK,UAAS,CAAC,cAAc,IAAI,MAAM,KAAK,CAAC;AAC9D;;AAGA,eAAsB,qBACpB,WACA,QACA,OACA,SACsB;CACtB,MAAM,aAAa,QAAQ,QAAO,WAAU,OAAO,eAAe,QAAQ,kBAAkB,MAAM,MAAM,KAAA,CAAS;CACjH,IAAI,WAAW,WAAW,GAAG,uBAAO,IAAI,IAAI;CAC5C,MAAM,CAAC,OAAO,YAAY,MAAM,QAAQ,IAAI,CAC1C,UAAU,UAAU;EAAE,GAAG;EAAO,KAAK,CAAC,GAAG,IAAI,IAAI,WAAW,KAAI,WAAU,OAAO,UAAW,CAAC,CAAC;CAAE,CAAC,GACjG,UAAU,4BACR,MAAM,OACN,MAAM,kBACN,WAAW,KAAI,WAAU,OAAO,YAAY,CAC9C,CACF,CAAC;CACD,MAAM,YAAY,IAAI,IAAI,MAAM,KAAI,SAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;CAC5D,OAAO,IAAI,IACT,WACG,QAAO,WACN,kBAAkB;EAChB;EACA,MAAM,UAAU,IAAI,OAAO,UAAW,KAAK;EAC3C;EACA,MAAM,kBAAkB,MAAM;EAC9B;CACF,CAAC,CACH,CAAC,CACA,KAAI,WAAU,OAAO,EAAE,CAC5B;AACF"}

package/dist/rules/dispatcher.d.ts

@@ -49,6 +49,10 @@ export interface FactoryDecisionDispatcherOptions {
     }) => Promise<void>;
     /** Injects the work item's recent comments into skill-invocation kickoffs. */
     feedReader?: FactoryFeedReader;
+    /** Dismisses superseded Factory change requests on a GitHub pull request. */
+    dismissStaleReviews?: (decision: Extract<FactoryCommitDecision, {
+        type: 'dismissStaleReviews';
+    }>) => Promise<void>;
     resolveLinkedWorkItemParentId?: (input: {
         orgId: string;
         factoryProjectId: string;

package/dist/rules/dispatcher.d.ts.map

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

package/dist/rules/dispatcher.js

@@ -8,6 +8,7 @@ import { moveCardToBoard } from "../boards/relocate.js";
 import { FactoryDispatchError, factoryDispatchFailureCode, factoryDispatchFailureMetadata } from "./dispatch-errors.js";
 import { isHumanActorId } from "../storage/domains/audit/actors.js";
 import { resolvePromptInvocation, resolveSkillInvocation, resolveSkillResumeInvocation } from "../skills/service.js";
+import { decisionOvertaken } from "./decision-applicability.js";
 import { FACTORY_OPEN_RUN_STALE_MS, heartbeatSessionOpenRun, isOpenRunLiveElsewhere, listSessionOpenRuns, recordSessionRunStart, waitForSessionRunAudit } from "../session/run-audit.js";
 import { withWorkItemFeed } from "../storage/domains/comments/feed-context.js";
 import { RequestContext } from "@mastra/core/request-context";
@@ -33,6 +34,8 @@ const BOOKKEEPING_MAX_IN_FLIGHT = 4;
 const STALE_BINDING_SWEEP_INTERVAL_MS = 10 * 6e4;
 const STALE_BINDING_TTL_MS = 1440 * 6e4;
 const RECONCILE_INTERVAL_MS = 3e4;
+/** The card moved on before this run could act; it settles as superseded, not succeeded. */
+var FactoryDecisionSuperseded = class extends Error {};
 function isTerminalFailure(attempts, failureCode) {
 	return attempts >= MAX_ATTEMPTS || !factoryDispatchFailureMetadata(failureCode).canRetry;
 }
@@ -244,6 +247,7 @@ var FactoryDecisionDispatcher = class {
 	#refreshManagedMemorySettings;
 	#primeCredentials;
 	#feedReader;
+	#dismissStaleReviews;
 	#resolveLinkedWorkItemParentId;
 	#maxInFlight;
 	#staleBindingSweepIntervalMs;
@@ -276,6 +280,7 @@ var FactoryDecisionDispatcher = class {
 		this.#refreshManagedMemorySettings = options.refreshManagedMemorySettings;
 		this.#primeCredentials = options.primeCredentials;
 		this.#feedReader = options.feedReader;
+		this.#dismissStaleReviews = options.dismissStaleReviews;
 		this.#resolveLinkedWorkItemParentId = options.resolveLinkedWorkItemParentId;
 		const maxInFlight = options.maxInFlight ?? MAX_IN_FLIGHT;
 		this.#maxInFlight = Number.isFinite(maxInFlight) && maxInFlight > 0 ? Math.floor(maxInFlight) : MAX_IN_FLIGHT;
@@ -416,6 +421,10 @@ var FactoryDecisionDispatcher = class {
 			executionCompleted = true;
 			if (!await this.#storage.completeDeferredDecision(leaseIdentity(record, this.#ownerId), /* @__PURE__ */ new Date())) throw new Error("Factory decision lease was lost before completion.");
 		} catch (error) {
+			if (error instanceof FactoryDecisionSuperseded) {
+				await this.#storage.supersedeLeasedDecision(leaseIdentity(record, this.#ownerId), /* @__PURE__ */ new Date());
+				return;
+			}
 			const failureCode = factoryDispatchFailureCode(error);
 			const terminal = isTerminalFailure(record.attempts, failureCode);
 			const failed = await this.#storage.failDeferredDecision({
@@ -564,7 +573,7 @@ var FactoryDecisionDispatcher = class {
 				await this.#upsertLinkedItem(record, decision, nextChain);
 				return;
 			case "invokeSkill": {
-				if (await this.#roleSuperseded(record, decision.role)) return;
+				if (await this.#roleSuperseded(record, decision.role) || await this.#decisionOvertaken(record, decision.role)) throw new FactoryDecisionSuperseded();
 				const binding = await this.#requireOrPrepareBinding(record, decision.role);
 				await this.#withBindingSkillRun(binding.id, async () => {
 					const item = record.workItemId ? await this.#storage.get({
@@ -599,24 +608,7 @@ var FactoryDecisionDispatcher = class {
 					await this.#switchThread(session, binding);
 					const deliveryId = record.deliveryGeneration === 0 ? record.id : `${record.id}:retry:${record.deliveryGeneration}`;
 					const kickoffLanded = async () => (await session.thread.listActiveMessages()).some((message) => message.id === deliveryId);
-					const kickoffStale = async () => {
-						if (await this.#roleSuperseded(record, decision.role)) return true;
-						if ((await this.#findBinding(record, decision.role))?.id !== binding.id) return true;
-						if (!record.workItemId) return false;
-						const current = await this.#storage.get({
-							orgId: record.orgId,
-							id: record.workItemId
-						});
-						if (current === null) return true;
-						const decidedAt = record.createdAt.getTime();
-						const enteredSince = current.stageHistory.filter((entry) => entry.exitedAt === void 0 && new Date(entry.enteredAt).getTime() > decidedAt);
-						const board = boardForWorkItem(current);
-						const carriesRole = (stage) => resolvePhaseSemantics(this.#boards, board, stage)?.role === decision.role;
-						const movedOn = !current.stageHistory.some((entry) => new Date(entry.enteredAt).getTime() <= decidedAt && (entry.exitedAt === void 0 || new Date(entry.exitedAt).getTime() > decidedAt) && carriesRole(entry.stage)) ? enteredSince.filter((entry) => !carriesRole(entry.stage)) : enteredSince;
-						if (movedOn.length === 0) return false;
-						const siblingStages = new Set((await this.#storage.listDeferredDecisions(record.orgId, record.factoryProjectId)).filter((sibling) => sibling.evaluationId === record.evaluationId && sibling.decision.type === "transition").map((sibling) => sibling.decision.stage));
-						return movedOn.some((entry) => !siblingStages.has(entry.stage));
-					};
+					const kickoffStale = async () => await this.#roleSuperseded(record, decision.role) || (await this.#findBinding(record, decision.role))?.id !== binding.id || await this.#decisionOvertaken(record, decision.role);
 					const runStillActive = () => this.#controller.listActiveThreadRuns().some((active) => active.threadId === binding.threadId);
 					while (true) {
 						const openRun = watchRun(session, {
@@ -636,10 +628,10 @@ var FactoryDecisionDispatcher = class {
 						}
 						await waitForSessionRunAudit(session);
 					}
-					if (await this.#roleSuperseded(record, decision.role)) return;
+					if (await this.#roleSuperseded(record, decision.role)) throw new FactoryDecisionSuperseded();
 					if ((await this.#requireBinding(record, decision.role)).id !== binding.id) throw new FactoryDispatchError("session_unavailable", `Factory binding ${binding.id} changed while waiting for its open run to end.`);
 					if (await kickoffLanded()) return;
-					if (await kickoffStale()) return;
+					if (await kickoffStale()) throw new FactoryDecisionSuperseded();
 					const kickoffContents = await withWorkItemFeed(this.#feedReader, {
 						orgId: record.orgId,
 						factoryProjectId: record.factoryProjectId,
@@ -686,7 +678,7 @@ var FactoryDecisionDispatcher = class {
 							if (await kickoffLanded()) break;
 							if (!await run.wait()) throw new FactoryDispatchError("run_terminal_event_missing", "Factory skill invocation is waiting on a run whose terminal event was not observed.");
 							if (await kickoffLanded()) break;
-							if (await kickoffStale()) return;
+							if (await kickoffStale()) throw new FactoryDecisionSuperseded();
 							run.arm();
 							settled = await sendKickoff();
 						}
@@ -736,6 +728,10 @@ var FactoryDecisionDispatcher = class {
 				}), true);
 				return;
 			}
+			case "dismissStaleReviews":
+				if (!this.#dismissStaleReviews) throw new Error("GitHub review dismissal is not configured.");
+				await this.#dismissStaleReviews(decision);
+				return;
 			case "notify": {
 				const binding = await this.#requireBinding(record);
 				const session = await this.#requireSession(binding);
@@ -943,6 +939,20 @@ var FactoryDecisionDispatcher = class {
 	* fresh decision for the role (the card came back to it) must still dispatch
 	* even though an older revoked binding for that role is on record.
 	*/
+	async #decisionOvertaken(record, role) {
+		if (!record.workItemId) return false;
+		const [item, siblings] = await Promise.all([this.#storage.get({
+			orgId: record.orgId,
+			id: record.workItemId
+		}), this.#storage.listDecisionsForEvaluations(record.orgId, record.factoryProjectId, [record.evaluationId])]);
+		return decisionOvertaken({
+			boards: this.#boards,
+			item,
+			record,
+			role,
+			siblings
+		});
+	}
 	async #roleSuperseded(record, role) {
 		if (!record.workItemId) return false;
 		const bindings = await this.#storage.listRunBindings(record.orgId, record.factoryProjectId, record.workItemId);