@mastra/factory 0.12.0-alpha.0 → 0.12.0-alpha.10

package/dist/rules/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","names":[],"sources":["../../src/rules/defaults.ts"],"sourcesContent":["import type {\n  FactoryBoardRuleLeaf,\n  FactoryBoardRules,\n  FactoryGithubRuleLeaf,\n  FactoryGithubEventName,\n  FactoryGithubRuleContext,\n  FactoryLinearEventName,\n  FactoryLinearRuleContext,\n  FactoryLinearRuleLeaf,\n  FactoryRules,\n  FactoryRulesOverrides,\n  FactoryRuleSource,\n  FactoryRuleStage,\n  FactoryStageRuleContext,\n  FactoryToolResultRuleContext,\n  FactoryToolRuleLeaf,\n} from './types.js';\nimport { assertFactoryRules, FactoryRuleValidationError } from './validation.js';\n\nexport const DEFAULT_FACTORY_RULE_VERSION = 'factory-default-v1';\n\nfunction trustedGithubActor(context: Pick<FactoryStageRuleContext, 'actor'>): boolean {\n  return context.actor.type === 'github' && context.actor.trusted;\n}\n\nfunction githubActorLogin(context: Pick<FactoryStageRuleContext, 'actor'>): string | undefined {\n  return context.actor.type === 'github' ? context.actor.login : undefined;\n}\n\nfunction invokeIssueInvestigation(context: FactoryStageRuleContext) {\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-triage`,\n    role: 'triage',\n    skillName: 'factory-triage',\n    arguments: context.item.url ? `GitHub issue (${context.item.url})` : context.item.title,\n  } as const;\n}\n\nfunction investigateTriagedIssue(context: FactoryStageRuleContext) {\n  if (\n    context.cause === 'run_start' ||\n    (context.cause === 'linked_item_materialized' && context.fromStage === 'intake' && context.toStage === 'triage')\n  ) {\n    return;\n  }\n  return invokeIssueInvestigation(context);\n}\n\nfunction retriageGithubIssue(context: FactoryGithubRuleContext) {\n  if (!context.item || context.item.source !== 'github-issue' || !context.item.url) return;\n  if (context.actor.type === 'github' && context.actor.factoryAuthored) return;\n\n  const reason =\n    context.event === 'issueEdited'\n      ? context.issueChange?.title && context.issueChange.body\n        ? 'issue title and body edited'\n        : context.issueChange?.title\n          ? 'issue title edited'\n          : 'issue body edited'\n      : context.event === 'issueCommentDeleted'\n        ? 'comment deleted'\n        : context.event === 'issueCommentEdited'\n          ? 'comment edited'\n          : 'comment created';\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-triage`,\n    role: 'triage',\n    skillName: 'factory-triage',\n    arguments: `Re-triage GitHub issue (${context.item.url}) after ${reason}.`,\n  } as const;\n}\n\nfunction investigateTriagedLinearIssue(context: FactoryStageRuleContext) {\n  const identifier = context.item.sourceKey?.startsWith('linear:')\n    ? context.item.sourceKey.slice('linear:'.length)\n    : context.item.title;\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-triage-linear`,\n    role: 'triage',\n    skillName: 'factory-triage',\n    arguments: `Linear issue ${identifier}${context.item.url ? ` (${context.item.url})` : ''}`,\n  } as const;\n}\n\nfunction planWorkItem(context: FactoryStageRuleContext) {\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-plan`,\n    role: 'plan',\n    skillName: 'factory-plan',\n    arguments: context.item.url ? `Work item (${context.item.url})` : context.item.title,\n  } as const;\n}\n\n// A GitHub login is alphanumeric with interior hyphens — no underscores, no\n// spaces. Checking the grammar rejects the placeholder the issue poller stamps\n// when the reporter's account is gone (`__unknown__`), which would otherwise\n// become a trailer crediting an account that does not exist.\nconst GITHUB_LOGIN = /^[a-zA-Z0-9](?:[a-zA-Z0-9]|-(?=[a-zA-Z0-9])){0,38}$/;\n\n/**\n * The reporter earns a `Co-Authored-By` trailer on the work their report caused.\n * Only a GitHub issue qualifies: Linear stamps a display name and a manual card\n * stamps nothing, and neither resolves to the GitHub identity a trailer needs.\n * Factory's own reports are skipped — crediting ourselves is noise.\n */\nfunction reporterCoAuthor(context: FactoryStageRuleContext) {\n  if (context.source !== 'issue') return undefined;\n  const author = context.item.metadata?.author;\n  if (typeof author !== 'string' || !author) return undefined;\n  if (author.endsWith('[bot]') || !GITHUB_LOGIN.test(author)) return undefined;\n  return author;\n}\n\n/**\n * Building carries a prompt rather than a skill. The approved plan is already\n * the specification, so there is nothing for a skill document to add, and the\n * handoff a skill would define is unnecessary here: Building ends by opening a\n * pull request, which arrives as its own event and raises the Review card.\n */\nfunction buildWorkItem(context: FactoryStageRuleContext) {\n  const subject = context.item.url ? `the approved plan for ${context.item.url}` : 'the approved plan';\n  const reporter = reporterCoAuthor(context);\n  // The trailer needs the reporter's numeric id, which intake does not stamp, so\n  // the agent resolves it from the same issue it is already reading.\n  const credit = reporter\n    ? ` The work was reported by @${reporter}: credit them on every commit with a ` +\n      `\\`Co-Authored-By: ${reporter} <ID+${reporter}@users.noreply.github.com>\\` trailer, ` +\n      `resolving ID with \\`gh api users/${reporter} --jq .id\\`.`\n    : '';\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:build`,\n    role: 'work',\n    prompt: `Implement ${subject}. Open a pull request when the work is ready for review.${credit}`,\n  } as const;\n}\n\nfunction completeIssue(context: FactoryStageRuleContext) {\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-complete-issue`,\n    role: 'triage',\n    skillName: 'factory-complete-issue',\n    arguments: context.item.url ? `GitHub issue (${context.item.url})` : context.item.title,\n  } as const;\n}\n\nfunction reviewPullRequest(context: FactoryStageRuleContext) {\n  // A re-entry into Review (from any post-intake stage) supersedes whichever\n  // review pass previously ran on this card: cancel any in-flight run before\n  // dispatching a fresh one so we don't burn tokens on the stale pass and race\n  // two agents on the same card. Cancellation is safe when nothing is in flight.\n  const supersedes = context.fromStage !== 'intake';\n  // The re-review skill only applies when a prior review pass actually completed\n  // (the card is returning from `done`). A cancelled first-time review that\n  // re-enters Review from `review` itself still has no prior pass to reconcile —\n  // it gets the regular factory-review skill.\n  const priorReviewCompleted = context.fromStage === 'done';\n  const skillName = priorReviewCompleted ? 'factory-rereview' : 'factory-review';\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:${skillName}`,\n    role: 'review',\n    skillName,\n    arguments: context.item.url ? `GitHub pull request (${context.item.url})` : context.item.title,\n    ...(supersedes ? { cancelInFlight: true } : {}),\n  } as const;\n}\n\nfunction resultContent(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return;\n  const content = (value as { content?: unknown }).content;\n  return typeof content === 'string' ? content : undefined;\n}\n\n// Interactive-session path only: factory-plan never calls submit_plan — it\n// advances planning → execute via factory_transition_work_item directly.\nfunction advanceApprovedPlan(context: FactoryToolResultRuleContext) {\n  if (\n    context.result.status !== 'success' ||\n    context.board !== 'work' ||\n    context.item.stages.length !== 1 ||\n    context.item.stages[0] !== 'planning' ||\n    context.actor.type !== 'agent' ||\n    context.actor.role !== 'plan' ||\n    !resultContent(context.result.value)?.startsWith('Plan approved.')\n  ) {\n    return;\n  }\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:approved-plan`,\n    board: 'work',\n    stage: 'execute',\n  } as const;\n}\n\nfunction createdAfterFactory(createdAt: string | undefined, factoryCreatedAt: string): boolean {\n  if (!createdAt) return false;\n  const sourceCreatedAt = Date.parse(createdAt);\n  const projectCreatedAt = Date.parse(factoryCreatedAt);\n  return Number.isFinite(sourceCreatedAt) && Number.isFinite(projectCreatedAt) && sourceCreatedAt > projectCreatedAt;\n}\n\nfunction issueOpened(context: FactoryGithubRuleContext) {\n  if (!context.issue) return;\n  return {\n    type: 'upsertLinkedWorkItem',\n    idempotencyKey: `${context.ingress.id}:issue-intake`,\n    board: 'work',\n    source: 'github-issue',\n    sourceKey: `github-issue:${context.issue.number}`,\n    title: context.issue.title,\n    url: context.issue.url,\n    stage:\n      trustedGithubActor(context) && createdAfterFactory(context.issue.createdAt, context.factory.createdAt)\n        ? 'triage'\n        : 'intake',\n    metadata: {\n      githubRepositoryId: context.repository.id,\n      githubIssueNumber: context.issue.number,\n      ...(githubActorLogin(context) ? { author: githubActorLogin(context) } : {}),\n      assignees: context.issue.assignees ?? [],\n      labels: context.issue.labels ?? [],\n    },\n  } as const;\n}\n\nfunction issueClosed(context: FactoryGithubRuleContext) {\n  if (!context.item || context.item.source !== 'github-issue' || !context.issue) return;\n  if (context.board !== 'work') return;\n  // Already off the board: nothing to reconcile.\n  if (context.item.stages.some(stage => stage === 'done' || stage === 'canceled')) return;\n  // Issue closure is a repository fact, not third-party input — no actor trust\n  // gate. `not_planned` (and `duplicate`) means abandoned, everything else is\n  // completed work.\n  const canceled = context.issue.stateReason === 'not_planned' || context.issue.stateReason === 'duplicate';\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:issue-closed`,\n    board: 'work',\n    stage: canceled ? 'canceled' : 'done',\n    message: {\n      text:\n        `GitHub issue #${context.issue.number} was closed` +\n        `${context.issue.stateReason ? ` (${context.issue.stateReason})` : ''}; ` +\n        `this Work card was moved to ${canceled ? 'Canceled' : 'Done'}.`,\n    },\n  } as const;\n}\n\nfunction pullRequestOpened(context: FactoryGithubRuleContext) {\n  if (!context.pullRequest) return;\n  // Trust is a repository-collaborator permission lookup, and a GitHub App bot\n  // is never a collaborator — so a PR Factory opened itself scores as untrusted\n  // and parks in Intake, the one class of PR whose provenance we know best.\n  // Factory authorship is its own trust signal: the branch came from a Work run\n  // this Factory dispatched.\n  const factoryAuthored = context.actor.type === 'github' && context.actor.factoryAuthored;\n  return {\n    type: 'upsertLinkedWorkItem',\n    idempotencyKey: `${context.ingress.id}:pull-request-intake`,\n    board: 'review',\n    source: 'github-pr',\n    sourceKey: `github-pr:${context.pullRequest.number}`,\n    title: context.pullRequest.title,\n    url: context.pullRequest.url,\n    stage:\n      (trustedGithubActor(context) || factoryAuthored) &&\n      createdAfterFactory(context.pullRequest.createdAt, context.factory.createdAt)\n        ? 'review'\n        : 'intake',\n    metadata: {\n      githubRepositoryId: context.repository.id,\n      githubPullRequestNumber: context.pullRequest.number,\n      factoryAuthored,\n      state: context.pullRequest.state,\n      draft: context.pullRequest.draft,\n      merged: context.pullRequest.merged,\n      assignees: context.pullRequest.assignees ?? [],\n      requestedReviewers: context.pullRequest.requestedReviewers ?? [],\n      labels: context.pullRequest.labels ?? [],\n      headBranch: context.pullRequest.headBranch,\n      baseBranch: context.pullRequest.baseBranch,\n      ...(githubActorLogin(context) ? { author: githubActorLogin(context) } : {}),\n    },\n  } as const;\n}\n\nfunction pullRequestMerged(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest?.merged) return;\n  if (context.board === 'review') {\n    // The event is bound to the PR's own Review card: a merged PR is finished\n    // review work, so always move the card to Done. The message only reaches\n    // an active session (if any) — cards without one just move, instead of\n    // failing retries against a binding that never existed.\n    return {\n      type: 'transition',\n      idempotencyKey: `${context.ingress.id}:pull-request-merged`,\n      board: 'review',\n      stage: 'done',\n      message: {\n        text:\n          `Pull request #${context.pullRequest.number} merged; this Review card was moved to Done. ` +\n          'No further review is needed unless follow-up work was requested.',\n      },\n    } as const;\n  }\n  // Provenance bound the event to the originating Work item instead: remind\n  // its agent to assess completion — never auto-complete the Work item.\n  return {\n    type: 'sendMessage',\n    idempotencyKey: `${context.ingress.id}:assess-work-completion`,\n    role: 'work',\n    message:\n      `Pull request #${context.pullRequest.number} merged. Assess whether the linked Work item is complete. ` +\n      'Do not mark it Done solely because this PR merged; use factory_transition_work_item only after verifying the work.',\n  } as const;\n}\n\nfunction addressReviewFeedback(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest || !context.review) return;\n  // Only the Work item that authored the PR can act on the feedback. Provenance\n  // binds the event there; a Review card seeing its own posted review must not\n  // react to it (that would loop the reviewer against itself).\n  if (context.board !== 'work') return;\n  // A closed or merged pull request has no branch left to push fixes to.\n  if (context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // `approved` needs no work, and `commented` (a review body with no verdict)\n  // is how a reviewer leaves notes without blocking — only a verdict that asks\n  // for changes should pull the author back in.\n  if (context.review.state.toLowerCase() !== 'changes_requested') return;\n  // The authoring thread is already subscribed to this PR (`gh pr create`\n  // subscribes automatically), so it can read the individual line comments\n  // from its own notification inbox — the message only has to wake it and\n  // point at the review.\n  return {\n    type: 'sendMessage',\n    idempotencyKey: `${context.ingress.id}:address-review-feedback`,\n    role: 'work',\n    priority: 'high',\n    message:\n      `Changes were requested on pull request #${context.pullRequest.number} (${context.review.url}). ` +\n      'Read the review comments on this PR, address the ones you agree with, and push the fixes to the PR branch. ' +\n      'Reply on GitHub to anything you are deliberately not changing, explaining why.',\n  } as const;\n}\n\n/**\n * Detects the `factory-review` handoff verdict in a comment body.\n *\n * GitHub forbids an app from reviewing a pull request it authored, so on\n * Factory-authored PRs the review skill falls back to posting its verdict as a\n * plain comment. That comment is the only signal the authoring agent gets, so\n * it has to be readable back out. The skill's handoff contract puts the verdict\n * on the first line (`Verdict: request changes`), so only that line is\n * inspected — a verdict quoted later in the findings must not count.\n */\nfunction requestsChangesVerdict(body: string | undefined): boolean {\n  const firstLine = body\n    ?.split('\\n')\n    .map(line => line.trim())\n    .find(line => line.length > 0);\n  if (!firstLine) return false;\n  // Tolerate the markdown the skill wraps the line in (`**Verdict: ...**`).\n  const normalized = firstLine\n    .replaceAll(/[*_`#>\\s]+/g, ' ')\n    .trim()\n    .toLowerCase();\n  // Match the verdict exactly so negated phrasings (\"Verdict: do not request\n  // changes\") cannot wake the author.\n  return /^verdict: ?(request changes|changes requested)$/.test(normalized);\n}\n\nfunction addressPullRequestComment(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest || !context.issueComment) return;\n  // Provenance binds the comment to the Work item that authored the PR — the\n  // only session that can act on it. A Review card must not react to comments\n  // on the PR it is reviewing.\n  if (context.board !== 'work') return;\n  if (context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // `factoryAuthored` is one bit for the whole Factory, so Factory's own\n  // comments are indistinguishable between roles — waking on all of them would\n  // let the Work agent's own progress comments wake itself in a loop. The one\n  // exception is the review verdict the Review run had to post as a comment\n  // because GitHub refused a self-review: that is the handoff, and it only ever\n  // asks for changes once per review, so it cannot sustain a loop.\n  if (\n    context.actor.type === 'github' &&\n    context.actor.factoryAuthored &&\n    !requestsChangesVerdict(context.issueComment.body)\n  ) {\n    return;\n  }\n  return {\n    type: 'sendMessage',\n    idempotencyKey: `${context.ingress.id}:address-pull-request-comment`,\n    role: 'work',\n    priority: 'high',\n    message:\n      `${context.issueComment.author ?? 'Someone'} commented on pull request #${context.pullRequest.number} ` +\n      `(${context.issueComment.url ?? context.pullRequest.url}). Read the comment, address it if you agree, and push ` +\n      'the fixes to the PR branch. Reply on GitHub to anything you are deliberately not changing, explaining why.',\n  } as const;\n}\n\nfunction pullRequestClosed(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest || context.pullRequest.merged) return;\n  if (context.board !== 'review') return;\n  // A PR closed without merging is abandoned review work: clear the card off\n  // the board instead of leaving it in Reviewing forever.\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:pull-request-closed`,\n    board: 'review',\n    stage: 'canceled',\n    message: {\n      text:\n        `Pull request #${context.pullRequest.number} was closed without merging; ` +\n        'this Review card was moved to Canceled.',\n    },\n  } as const;\n}\n\nfunction reReviewRequestedPullRequest(context: FactoryGithubRuleContext) {\n  // Only a review re-requested *from Factory's own bot* restarts the review —\n  // requesting a human reviewer is not Factory's signal.\n  if (!context.item || context.board !== 'review' || !context.reviewRequest?.factoryReviewer) return;\n  if (!context.pullRequest || context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // Trusted (write/admin) requesters only: re-entering review checks out and\n  // executes PR code, the same bar pullRequestOpened applies to auto-review.\n  if (!trustedGithubActor(context)) return;\n  if (context.actor.type === 'github' && context.actor.factoryAuthored) return;\n  // Already in Reviewing: a review pass is pending or running; re-entering\n  // would be a same-stage no-op anyway (stage rules only fire on change).\n  if (context.item.stages.length === 1 && context.item.stages[0] === 'review') return;\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:re-review-requested`,\n    board: 'review',\n    stage: 'review',\n  } as const;\n}\n\nfunction reReviewUpdatedPullRequest(context: FactoryGithubRuleContext) {\n  if (!context.item || context.board !== 'review') return;\n  if (!context.pullRequest || context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // Intake has not started a review pass yet, so a push there is just more of\n  // the code the first pass will read. A push to a card sitting in Reviewing is\n  // different: it invalidates whatever that pass is reading, so re-enter the\n  // stage to supersede it. `reviewPullRequest` cancels the stale run and picks\n  // the right skill for the entry it sees.\n  if (context.item.stages.some(stage => stage === 'intake')) return;\n  const alreadyReviewing = context.item.stages.some(stage => stage === 'review');\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:re-review-updated`,\n    board: 'review',\n    stage: 'review',\n    // Re-entry is the point when the card is already Reviewing: the stage's\n    // entry rule is what cancels the superseded pass and starts one on the code\n    // that just landed.\n    ...(alreadyReviewing ? { reenter: true } : {}),\n  } as const;\n}\n\nfunction linearIssueObserved(context: FactoryLinearRuleContext) {\n  if (context.item) return;\n  return {\n    type: 'upsertLinkedWorkItem',\n    idempotencyKey: `${context.ingress.id}:issue-triage`,\n    board: 'work',\n    source: 'linear-issue',\n    sourceKey: `linear:${context.issue.identifier}`,\n    title: `${context.issue.identifier}: ${context.issue.title}`,\n    url: context.issue.url,\n    stage: 'triage',\n    metadata: {\n      linearIssueId: context.issue.id,\n      identifier: context.issue.identifier,\n      linearState: context.issue.state,\n      linearStateType: context.issue.stateType,\n      linearPriority: context.issue.priorityLabel,\n      linearAssignee: context.issue.assignee,\n      linearCreator: context.issue.creator,\n      linearTeam: context.issue.team,\n      labels: [...context.issue.labels] as string[],\n      ...(context.issue.assignee ? { assignee: context.issue.assignee } : {}),\n      ...(context.issue.creator ? { creator: context.issue.creator, author: context.issue.creator } : {}),\n    },\n  } as const;\n}\n\nfunction linearIssueClosed(context: FactoryLinearRuleContext) {\n  if (!context.item || context.item.source !== 'linear-issue') return;\n  if (context.board !== 'work') return;\n  // Already off the board: nothing to reconcile.\n  if (context.item.stages.some(stage => stage === 'done' || stage === 'canceled')) return;\n  // Only terminal state types trigger close.\n  const stateType = context.issue.stateType;\n  if (stateType !== 'completed' && stateType !== 'canceled') return;\n  const canceled = stateType === 'canceled';\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:issue-closed`,\n    board: 'work',\n    stage: canceled ? 'canceled' : 'done',\n    message: {\n      text: `Linear issue ${context.issue.identifier} was ${canceled ? 'canceled' : 'completed'}; this Work card was moved to ${canceled ? 'Canceled' : 'Done'}.`,\n    },\n  } as const;\n}\n\nconst BUILT_IN_DEFAULTS: FactoryRulesOverrides = {\n  work: {\n    triage: {\n      issue: { onEnter: investigateTriagedIssue },\n      linearIssue: { onEnter: investigateTriagedLinearIssue },\n    },\n    planning: {\n      issue: { onEnter: planWorkItem },\n      linearIssue: { onEnter: planWorkItem },\n      manual: { onEnter: planWorkItem },\n    },\n    execute: {\n      issue: { onEnter: buildWorkItem },\n      linearIssue: { onEnter: buildWorkItem },\n      manual: { onEnter: buildWorkItem },\n    },\n    done: {\n      issue: { onEnter: completeIssue },\n    },\n  },\n  review: { review: { pullRequest: { onEnter: reviewPullRequest } } },\n  tools: { submit_plan: { onResult: advanceApprovedPlan } },\n  github: {\n    issueOpened: { onEvent: issueOpened },\n    issueEdited: { onEvent: retriageGithubIssue },\n    issueClosed: { onEvent: issueClosed },\n    issueCommentCreated: { onEvent: retriageGithubIssue },\n    issueCommentEdited: { onEvent: retriageGithubIssue },\n    issueCommentDeleted: { onEvent: retriageGithubIssue },\n    pullRequestOpened: { onEvent: pullRequestOpened },\n    pullRequestUpdated: { onEvent: reReviewUpdatedPullRequest },\n    pullRequestCommentCreated: { onEvent: addressPullRequestComment },\n    pullRequestReviewRequested: { onEvent: reReviewRequestedPullRequest },\n    pullRequestReviewSubmitted: { onEvent: addressReviewFeedback },\n    pullRequestMerged: { onEvent: pullRequestMerged },\n    pullRequestClosed: { onEvent: pullRequestClosed },\n  },\n  linear: { issueObserved: { onEvent: linearIssueObserved }, issueClosed: { onEvent: linearIssueClosed } },\n};\n\nfunction mergeBoardRules(\n  base: FactoryBoardRules | undefined,\n  overrides: FactoryBoardRules | undefined,\n): FactoryBoardRules {\n  const result: FactoryBoardRules = {};\n  const stages = new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})]) as Set<FactoryRuleStage>;\n  for (const stage of stages) {\n    const baseSources = base?.[stage];\n    const overrideSources = overrides?.[stage];\n    const sources = new Set([\n      ...Object.keys(baseSources ?? {}),\n      ...Object.keys(overrideSources ?? {}),\n    ]) as Set<FactoryRuleSource>;\n    const mergedSources: Partial<Record<FactoryRuleSource, FactoryBoardRuleLeaf>> = {};\n    for (const source of sources) {\n      const baseLeaf = baseSources?.[source];\n      const overrideLeaf = overrideSources?.[source];\n      mergedSources[source] = {\n        ...(baseLeaf && 'onEnter' in baseLeaf ? { onEnter: baseLeaf.onEnter } : {}),\n        ...(baseLeaf && 'onExit' in baseLeaf ? { onExit: baseLeaf.onExit } : {}),\n        ...(overrideLeaf && 'onEnter' in overrideLeaf ? { onEnter: overrideLeaf.onEnter } : {}),\n        ...(overrideLeaf && 'onExit' in overrideLeaf ? { onExit: overrideLeaf.onExit } : {}),\n      };\n    }\n    result[stage] = mergedSources;\n  }\n  return result;\n}\n\nfunction mergeToolRules(\n  base: Record<string, FactoryToolRuleLeaf> | undefined,\n  overrides: Record<string, FactoryToolRuleLeaf> | undefined,\n): Record<string, FactoryToolRuleLeaf> {\n  const result: Record<string, FactoryToolRuleLeaf> = {};\n  for (const name of new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})])) {\n    const baseLeaf = base?.[name];\n    const overrideLeaf = overrides?.[name];\n    result[name] = {\n      ...(baseLeaf && 'onResult' in baseLeaf ? { onResult: baseLeaf.onResult } : {}),\n      ...(overrideLeaf && 'onResult' in overrideLeaf ? { onResult: overrideLeaf.onResult } : {}),\n    };\n  }\n  return result;\n}\n\nfunction mergeGithubRules(\n  base: FactoryRulesOverrides['github'],\n  overrides: FactoryRulesOverrides['github'],\n): NonNullable<FactoryRulesOverrides['github']> {\n  const result: Partial<Record<FactoryGithubEventName, FactoryGithubRuleLeaf>> = {};\n  const events = new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})]) as Set<FactoryGithubEventName>;\n  for (const event of events) {\n    const baseLeaf = base?.[event];\n    const overrideLeaf = overrides?.[event];\n    result[event] = {\n      ...(baseLeaf && 'onEvent' in baseLeaf ? { onEvent: baseLeaf.onEvent } : {}),\n      ...(overrideLeaf && 'onEvent' in overrideLeaf ? { onEvent: overrideLeaf.onEvent } : {}),\n    };\n  }\n  return result;\n}\n\nfunction mergeLinearRules(\n  base: FactoryRulesOverrides['linear'],\n  overrides: FactoryRulesOverrides['linear'],\n): NonNullable<FactoryRulesOverrides['linear']> {\n  const result: Partial<Record<FactoryLinearEventName, FactoryLinearRuleLeaf>> = {};\n  const events = new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})]) as Set<FactoryLinearEventName>;\n  for (const event of events) {\n    const baseLeaf = base?.[event];\n    const overrideLeaf = overrides?.[event];\n    result[event] = {\n      ...(baseLeaf && 'onEvent' in baseLeaf ? { onEvent: baseLeaf.onEvent } : {}),\n      ...(overrideLeaf && 'onEvent' in overrideLeaf ? { onEvent: overrideLeaf.onEvent } : {}),\n    };\n  }\n  return result;\n}\n\nexport function mergeFactoryRuleOverrides(\n  base: FactoryRulesOverrides,\n  overrides: FactoryRulesOverrides = {},\n): Omit<FactoryRules, 'version'> {\n  return {\n    work: mergeBoardRules(base.work, overrides.work),\n    review: mergeBoardRules(base.review, overrides.review),\n    tools: mergeToolRules(base.tools, overrides.tools),\n    github: mergeGithubRules(base.github, overrides.github),\n    linear: mergeLinearRules(base.linear, overrides.linear),\n  };\n}\n\nexport function defaultFactoryRules(input: { version: string; overrides?: FactoryRulesOverrides }): FactoryRules {\n  if (typeof input?.version !== 'string' || input.version.trim().length === 0) {\n    throw new FactoryRuleValidationError('Factory rule version is required.');\n  }\n\n  const rules: FactoryRules = {\n    version: input.version.trim(),\n    ...mergeFactoryRuleOverrides(BUILT_IN_DEFAULTS, input.overrides),\n  };\n  assertFactoryRules(rules);\n  return rules;\n}\n\nexport function builtInFactoryRules(): FactoryRules {\n  return defaultFactoryRules({ version: DEFAULT_FACTORY_RULE_VERSION });\n}\n"],"mappings":"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"}
+{"version":3,"file":"defaults.js","names":[],"sources":["../../src/rules/defaults.ts"],"sourcesContent":["import type {\n  FactoryBoardRuleLeaf,\n  FactoryBoardRules,\n  FactoryGithubRuleLeaf,\n  FactoryGithubEventName,\n  FactoryGithubRuleContext,\n  FactoryLinearEventName,\n  FactoryLinearRuleContext,\n  FactoryLinearRuleLeaf,\n  FactoryRules,\n  FactoryRulesOverrides,\n  FactoryRuleSource,\n  FactoryRuleStage,\n  FactoryStageRuleContext,\n  FactoryToolResultRuleContext,\n  FactoryToolRuleLeaf,\n} from './types.js';\nimport { assertFactoryRules, FactoryRuleValidationError } from './validation.js';\n\nexport const DEFAULT_FACTORY_RULE_VERSION = 'factory-default-v1';\n\nfunction trustedGithubActor(context: Pick<FactoryStageRuleContext, 'actor'>): boolean {\n  return context.actor.type === 'github' && context.actor.trusted;\n}\n\nfunction githubActorLogin(context: Pick<FactoryStageRuleContext, 'actor'>): string | undefined {\n  return context.actor.type === 'github' ? context.actor.login : undefined;\n}\n\nfunction invokeIssueInvestigation(context: FactoryStageRuleContext) {\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-triage`,\n    role: 'triage',\n    skillName: 'factory-triage',\n    arguments: context.item.url ? `GitHub issue (${context.item.url})` : context.item.title,\n  } as const;\n}\n\nfunction retriageGithubIssue(context: FactoryGithubRuleContext) {\n  if (!context.item || context.item.source !== 'github-issue' || !context.item.url) return;\n  if (context.actor.type === 'github' && context.actor.factoryAuthored) return;\n\n  const reason =\n    context.event === 'issueEdited'\n      ? context.issueChange?.title && context.issueChange.body\n        ? 'issue title and body edited'\n        : context.issueChange?.title\n          ? 'issue title edited'\n          : 'issue body edited'\n      : context.event === 'issueCommentDeleted'\n        ? 'comment deleted'\n        : context.event === 'issueCommentEdited'\n          ? 'comment edited'\n          : 'comment created';\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-triage`,\n    role: 'triage',\n    skillName: 'factory-triage',\n    arguments: `Re-triage GitHub issue (${context.item.url}) after ${reason}.`,\n  } as const;\n}\n\nfunction investigateTriagedLinearIssue(context: FactoryStageRuleContext) {\n  const identifier = context.item.sourceKey?.startsWith('linear:')\n    ? context.item.sourceKey.slice('linear:'.length)\n    : context.item.title;\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-triage-linear`,\n    role: 'triage',\n    skillName: 'factory-triage',\n    arguments: `Linear issue ${identifier}${context.item.url ? ` (${context.item.url})` : ''}`,\n  } as const;\n}\n\nfunction planWorkItem(context: FactoryStageRuleContext) {\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-plan`,\n    role: 'plan',\n    skillName: 'factory-plan',\n    arguments: context.item.url ? `Work item (${context.item.url})` : context.item.title,\n  } as const;\n}\n\n// A GitHub login is alphanumeric with interior hyphens — no underscores, no\n// spaces. Checking the grammar rejects the placeholder the issue poller stamps\n// when the reporter's account is gone (`__unknown__`), which would otherwise\n// become a trailer crediting an account that does not exist.\nconst GITHUB_LOGIN = /^[a-zA-Z0-9](?:[a-zA-Z0-9]|-(?=[a-zA-Z0-9])){0,38}$/;\n\n/**\n * The reporter earns a `Co-Authored-By` trailer on the work their report caused.\n * Only a GitHub issue qualifies: Linear stamps a display name and a manual card\n * stamps nothing, and neither resolves to the GitHub identity a trailer needs.\n * Factory's own reports are skipped — crediting ourselves is noise.\n */\nfunction reporterCoAuthor(context: FactoryStageRuleContext) {\n  if (context.source !== 'issue') return undefined;\n  const author = context.item.metadata?.author;\n  if (typeof author !== 'string' || !author) return undefined;\n  if (author.endsWith('[bot]') || !GITHUB_LOGIN.test(author)) return undefined;\n  return author;\n}\n\n/**\n * Building carries a prompt rather than a skill. The approved plan is already\n * the specification, so there is nothing for a skill document to add, and the\n * handoff a skill would define is unnecessary here: Building ends by opening a\n * pull request, which arrives as its own event and raises the Review card.\n */\nfunction buildWorkItem(context: FactoryStageRuleContext) {\n  const subject = context.item.url ? `the approved plan for ${context.item.url}` : 'the approved plan';\n  const reporter = reporterCoAuthor(context);\n  // The trailer needs the reporter's numeric id, which intake does not stamp, so\n  // the agent resolves it from the same issue it is already reading.\n  const credit = reporter\n    ? ` The work was reported by @${reporter}: credit them on every commit with a ` +\n      `\\`Co-Authored-By: ${reporter} <ID+${reporter}@users.noreply.github.com>\\` trailer, ` +\n      `resolving ID with \\`gh api users/${reporter} --jq .id\\`.`\n    : '';\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:build`,\n    role: 'work',\n    prompt: `Implement ${subject}. Open a pull request when the work is ready for review.${credit}`,\n  } as const;\n}\n\nfunction completeIssue(context: FactoryStageRuleContext) {\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:factory-complete-issue`,\n    role: 'triage',\n    skillName: 'factory-complete-issue',\n    arguments: context.item.url ? `GitHub issue (${context.item.url})` : context.item.title,\n  } as const;\n}\n\nfunction reviewPullRequest(context: FactoryStageRuleContext) {\n  // A re-entry into Review (from any post-intake stage) supersedes whichever\n  // review pass previously ran on this card: cancel any in-flight run before\n  // dispatching a fresh one so we don't burn tokens on the stale pass and race\n  // two agents on the same card. Cancellation is safe when nothing is in flight.\n  const supersedes = context.fromStage !== 'intake';\n  // The re-review skill only applies when a prior review pass actually completed\n  // (the card is returning from `done`). A cancelled first-time review that\n  // re-enters Review from `review` itself still has no prior pass to reconcile —\n  // it gets the regular factory-review skill.\n  const priorReviewCompleted = context.fromStage === 'done';\n  const skillName = priorReviewCompleted ? 'factory-rereview' : 'factory-review';\n  return {\n    type: 'invokeSkill',\n    idempotencyKey: `${context.ingress.id}:${skillName}`,\n    role: 'review',\n    skillName,\n    arguments: context.item.url ? `GitHub pull request (${context.item.url})` : context.item.title,\n    ...(supersedes ? { cancelInFlight: true } : {}),\n  } as const;\n}\n\n// Fires only on webhook materialization, so an item filed by hand or re-synced\n// from source never suggests its own run.\nfunction onArrival<Effect>(rule: (context: FactoryStageRuleContext) => Effect) {\n  return (context: FactoryStageRuleContext): Effect | undefined => {\n    if (context.cause !== 'linked_item_materialized') return;\n    if (context.item.metadata?.autoStartCandidate !== true) return;\n    return rule(context);\n  };\n}\n\nfunction resultContent(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return;\n  const content = (value as { content?: unknown }).content;\n  return typeof content === 'string' ? content : undefined;\n}\n\n// Interactive-session path only: factory-plan never calls submit_plan — it\n// advances planning → execute via factory_transition_work_item directly.\nfunction advanceApprovedPlan(context: FactoryToolResultRuleContext) {\n  if (\n    context.result.status !== 'success' ||\n    context.board !== 'work' ||\n    context.item.stages.length !== 1 ||\n    context.item.stages[0] !== 'planning' ||\n    context.actor.type !== 'agent' ||\n    context.actor.role !== 'plan' ||\n    !resultContent(context.result.value)?.startsWith('Plan approved.')\n  ) {\n    return;\n  }\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:approved-plan`,\n    board: 'work',\n    stage: 'execute',\n  } as const;\n}\n\nfunction createdAfterFactory(createdAt: string | undefined, factoryCreatedAt: string): boolean {\n  if (!createdAt) return false;\n  const sourceCreatedAt = Date.parse(createdAt);\n  const projectCreatedAt = Date.parse(factoryCreatedAt);\n  return Number.isFinite(sourceCreatedAt) && Number.isFinite(projectCreatedAt) && sourceCreatedAt > projectCreatedAt;\n}\n\nfunction issueOpened(context: FactoryGithubRuleContext) {\n  if (!context.issue) return;\n  // Everything arrives in Intake; arrival only stamps whether `onArrival` may\n  // suggest this card's run without a person.\n  return {\n    type: 'upsertLinkedWorkItem',\n    idempotencyKey: `${context.ingress.id}:issue-intake`,\n    board: 'work',\n    source: 'github-issue',\n    sourceKey: `github-issue:${context.issue.number}`,\n    title: context.issue.title,\n    url: context.issue.url,\n    stage: 'intake',\n    metadata: {\n      githubRepositoryId: context.repository.id,\n      githubIssueNumber: context.issue.number,\n      ...(githubActorLogin(context) ? { author: githubActorLogin(context) } : {}),\n      authorTrusted: trustedGithubActor(context),\n      autoStartCandidate:\n        trustedGithubActor(context) && createdAfterFactory(context.issue.createdAt, context.factory.createdAt),\n      assignees: context.issue.assignees ?? [],\n      labels: context.issue.labels ?? [],\n    },\n  } as const;\n}\n\nfunction issueClosed(context: FactoryGithubRuleContext) {\n  if (!context.item || context.item.source !== 'github-issue' || !context.issue) return;\n  if (context.board !== 'work') return;\n  // Already off the board: nothing to reconcile.\n  if (context.item.stages.some(stage => stage === 'done' || stage === 'canceled')) return;\n  // Issue closure is a repository fact, not third-party input — no actor trust\n  // gate. `not_planned` (and `duplicate`) means abandoned, everything else is\n  // completed work.\n  const canceled = context.issue.stateReason === 'not_planned' || context.issue.stateReason === 'duplicate';\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:issue-closed`,\n    board: 'work',\n    stage: canceled ? 'canceled' : 'done',\n    message: {\n      text:\n        `GitHub issue #${context.issue.number} was closed` +\n        `${context.issue.stateReason ? ` (${context.issue.stateReason})` : ''}; ` +\n        `this Work card was moved to ${canceled ? 'Canceled' : 'Done'}.`,\n    },\n  } as const;\n}\n\nfunction pullRequestOpened(context: FactoryGithubRuleContext) {\n  if (!context.pullRequest) return;\n  // A GitHub App bot is never a collaborator, so Factory's own PRs score\n  // untrusted; their authorship is the trust signal.\n  const factoryAuthored = context.actor.type === 'github' && context.actor.factoryAuthored;\n  const autoStartCandidate =\n    (trustedGithubActor(context) || factoryAuthored) &&\n    createdAfterFactory(context.pullRequest.createdAt, context.factory.createdAt);\n  return {\n    type: 'upsertLinkedWorkItem',\n    idempotencyKey: `${context.ingress.id}:pull-request-intake`,\n    board: 'review',\n    source: 'github-pr',\n    sourceKey: `github-pr:${context.pullRequest.number}`,\n    title: context.pullRequest.title,\n    url: context.pullRequest.url,\n    stage: 'intake',\n    metadata: {\n      githubRepositoryId: context.repository.id,\n      githubPullRequestNumber: context.pullRequest.number,\n      factoryAuthored,\n      authorTrusted: trustedGithubActor(context),\n      autoStartCandidate,\n      state: context.pullRequest.state,\n      draft: context.pullRequest.draft,\n      merged: context.pullRequest.merged,\n      assignees: context.pullRequest.assignees ?? [],\n      requestedReviewers: context.pullRequest.requestedReviewers ?? [],\n      labels: context.pullRequest.labels ?? [],\n      headBranch: context.pullRequest.headBranch,\n      baseBranch: context.pullRequest.baseBranch,\n      ...(githubActorLogin(context) ? { author: githubActorLogin(context) } : {}),\n    },\n  } as const;\n}\n\nfunction pullRequestMerged(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest?.merged) return;\n  if (context.board === 'review') {\n    // The event is bound to the PR's own Review card: a merged PR is finished\n    // review work, so always move the card to Done. The message only reaches\n    // an active session (if any) — cards without one just move, instead of\n    // failing retries against a binding that never existed.\n    return {\n      type: 'transition',\n      idempotencyKey: `${context.ingress.id}:pull-request-merged`,\n      board: 'review',\n      stage: 'done',\n      message: {\n        text:\n          `Pull request #${context.pullRequest.number} merged; this Review card was moved to Done. ` +\n          'No further review is needed unless follow-up work was requested.',\n      },\n    } as const;\n  }\n  // Provenance bound the event to the originating Work item instead: remind\n  // its agent to assess completion — never auto-complete the Work item.\n  return {\n    type: 'sendMessage',\n    idempotencyKey: `${context.ingress.id}:assess-work-completion`,\n    role: 'work',\n    message:\n      `Pull request #${context.pullRequest.number} merged. Assess whether the linked Work item is complete. ` +\n      'Do not mark it Done solely because this PR merged; use factory_transition_work_item only after verifying the work.',\n  } as const;\n}\n\nfunction addressReviewFeedback(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest || !context.review) return;\n  // Only the Work item that authored the PR can act on the feedback. Provenance\n  // binds the event there; a Review card seeing its own posted review must not\n  // react to it (that would loop the reviewer against itself).\n  if (context.board !== 'work') return;\n  // A closed or merged pull request has no branch left to push fixes to.\n  if (context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // `approved` needs no work, and `commented` (a review body with no verdict)\n  // is how a reviewer leaves notes without blocking — only a verdict that asks\n  // for changes should pull the author back in.\n  if (context.review.state.toLowerCase() !== 'changes_requested') return;\n  // The authoring thread is already subscribed to this PR (`gh pr create`\n  // subscribes automatically), so it can read the individual line comments\n  // from its own notification inbox — the message only has to wake it and\n  // point at the review.\n  return {\n    type: 'sendMessage',\n    idempotencyKey: `${context.ingress.id}:address-review-feedback`,\n    role: 'work',\n    priority: 'high',\n    message:\n      `Changes were requested on pull request #${context.pullRequest.number} (${context.review.url}). ` +\n      'Read the review comments on this PR, address the ones you agree with, and push the fixes to the PR branch. ' +\n      'Reply on GitHub to anything you are deliberately not changing, explaining why.',\n  } as const;\n}\n\n/**\n * Detects the `factory-review` handoff verdict in a comment body.\n *\n * GitHub forbids an app from reviewing a pull request it authored, so on\n * Factory-authored PRs the review skill falls back to posting its verdict as a\n * plain comment. That comment is the only signal the authoring agent gets, so\n * it has to be readable back out. The skill's handoff contract puts the verdict\n * on the first line (`Verdict: request changes`), so only that line is\n * inspected — a verdict quoted later in the findings must not count.\n */\nfunction requestsChangesVerdict(body: string | undefined): boolean {\n  const firstLine = body\n    ?.split('\\n')\n    .map(line => line.trim())\n    .find(line => line.length > 0);\n  if (!firstLine) return false;\n  // Tolerate the markdown the skill wraps the line in (`**Verdict: ...**`).\n  const normalized = firstLine\n    .replaceAll(/[*_`#>\\s]+/g, ' ')\n    .trim()\n    .toLowerCase();\n  // Match the verdict exactly so negated phrasings (\"Verdict: do not request\n  // changes\") cannot wake the author.\n  return /^verdict: ?(request changes|changes requested)$/.test(normalized);\n}\n\nfunction addressPullRequestComment(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest || !context.issueComment) return;\n  // Provenance binds the comment to the Work item that authored the PR — the\n  // only session that can act on it. A Review card must not react to comments\n  // on the PR it is reviewing.\n  if (context.board !== 'work') return;\n  if (context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // `factoryAuthored` is one bit for the whole Factory, so Factory's own\n  // comments are indistinguishable between roles — waking on all of them would\n  // let the Work agent's own progress comments wake itself in a loop. The one\n  // exception is the review verdict the Review run had to post as a comment\n  // because GitHub refused a self-review: that is the handoff, and it only ever\n  // asks for changes once per review, so it cannot sustain a loop.\n  if (\n    context.actor.type === 'github' &&\n    context.actor.factoryAuthored &&\n    !requestsChangesVerdict(context.issueComment.body)\n  ) {\n    return;\n  }\n  return {\n    type: 'sendMessage',\n    idempotencyKey: `${context.ingress.id}:address-pull-request-comment`,\n    role: 'work',\n    priority: 'high',\n    message:\n      `${context.issueComment.author ?? 'Someone'} commented on pull request #${context.pullRequest.number} ` +\n      `(${context.issueComment.url ?? context.pullRequest.url}). Read the comment, address it if you agree, and push ` +\n      'the fixes to the PR branch. Reply on GitHub to anything you are deliberately not changing, explaining why.',\n  } as const;\n}\n\nfunction pullRequestClosed(context: FactoryGithubRuleContext) {\n  if (!context.item || !context.pullRequest || context.pullRequest.merged) return;\n  if (context.board !== 'review') return;\n  // A PR closed without merging is abandoned review work: clear the card off\n  // the board instead of leaving it in Reviewing forever.\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:pull-request-closed`,\n    board: 'review',\n    stage: 'canceled',\n    message: {\n      text:\n        `Pull request #${context.pullRequest.number} was closed without merging; ` +\n        'this Review card was moved to Canceled.',\n    },\n  } as const;\n}\n\nfunction reReviewRequestedPullRequest(context: FactoryGithubRuleContext) {\n  // Only a review re-requested *from Factory's own bot* restarts the review —\n  // requesting a human reviewer is not Factory's signal.\n  if (!context.item || context.board !== 'review' || !context.reviewRequest?.factoryReviewer) return;\n  if (!context.pullRequest || context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // Trusted (write/admin) requesters only: re-entering review checks out and\n  // executes PR code, the same bar pullRequestOpened applies to auto-review.\n  if (!trustedGithubActor(context)) return;\n  if (context.actor.type === 'github' && context.actor.factoryAuthored) return;\n  // Already in Reviewing: a review pass is pending or running; re-entering\n  // would be a same-stage no-op anyway (stage rules only fire on change).\n  if (context.item.stages.length === 1 && context.item.stages[0] === 'review') return;\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:re-review-requested`,\n    board: 'review',\n    stage: 'review',\n  } as const;\n}\n\nfunction reReviewUpdatedPullRequest(context: FactoryGithubRuleContext) {\n  if (!context.item || context.board !== 'review') return;\n  if (!context.pullRequest || context.pullRequest.state !== 'open' || context.pullRequest.merged) return;\n  // Intake has not started a review pass yet, so a push there is just more of\n  // the code the first pass will read. A push to a card sitting in Reviewing is\n  // different: it invalidates whatever that pass is reading, so re-enter the\n  // stage to supersede it. `reviewPullRequest` cancels the stale run and picks\n  // the right skill for the entry it sees.\n  if (context.item.stages.some(stage => stage === 'intake')) return;\n  const alreadyReviewing = context.item.stages.some(stage => stage === 'review');\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:re-review-updated`,\n    board: 'review',\n    stage: 'review',\n    // Re-entry is the point when the card is already Reviewing: the stage's\n    // entry rule is what cancels the superseded pass and starts one on the code\n    // that just landed.\n    ...(alreadyReviewing ? { reenter: true } : {}),\n  } as const;\n}\n\nfunction linearIssueObserved(context: FactoryLinearRuleContext) {\n  if (context.item) return;\n  return {\n    type: 'upsertLinkedWorkItem',\n    idempotencyKey: `${context.ingress.id}:issue-triage`,\n    board: 'work',\n    source: 'linear-issue',\n    sourceKey: `linear:${context.issue.identifier}`,\n    title: `${context.issue.identifier}: ${context.issue.title}`,\n    url: context.issue.url,\n    stage: 'triage',\n    metadata: {\n      linearIssueId: context.issue.id,\n      identifier: context.issue.identifier,\n      linearState: context.issue.state,\n      linearStateType: context.issue.stateType,\n      linearPriority: context.issue.priorityLabel,\n      linearAssignee: context.issue.assignee,\n      linearCreator: context.issue.creator,\n      linearTeam: context.issue.team,\n      labels: [...context.issue.labels] as string[],\n      ...(context.issue.assignee ? { assignee: context.issue.assignee } : {}),\n      ...(context.issue.creator ? { creator: context.issue.creator, author: context.issue.creator } : {}),\n    },\n  } as const;\n}\n\nfunction linearIssueClosed(context: FactoryLinearRuleContext) {\n  if (!context.item || context.item.source !== 'linear-issue') return;\n  if (context.board !== 'work') return;\n  // Already off the board: nothing to reconcile.\n  if (context.item.stages.some(stage => stage === 'done' || stage === 'canceled')) return;\n  // Only terminal state types trigger close.\n  const stateType = context.issue.stateType;\n  if (stateType !== 'completed' && stateType !== 'canceled') return;\n  const canceled = stateType === 'canceled';\n  return {\n    type: 'transition',\n    idempotencyKey: `${context.ingress.id}:issue-closed`,\n    board: 'work',\n    stage: canceled ? 'canceled' : 'done',\n    message: {\n      text: `Linear issue ${context.issue.identifier} was ${canceled ? 'canceled' : 'completed'}; this Work card was moved to ${canceled ? 'Canceled' : 'Done'}.`,\n    },\n  } as const;\n}\n\nconst BUILT_IN_DEFAULTS: FactoryRulesOverrides = {\n  work: {\n    intake: { issue: { onEnter: onArrival(invokeIssueInvestigation) } },\n    triage: {\n      issue: { onEnter: invokeIssueInvestigation },\n      linearIssue: { onEnter: investigateTriagedLinearIssue },\n    },\n    planning: {\n      issue: { onEnter: planWorkItem },\n      linearIssue: { onEnter: planWorkItem },\n      manual: { onEnter: planWorkItem },\n    },\n    execute: {\n      issue: { onEnter: buildWorkItem },\n      linearIssue: { onEnter: buildWorkItem },\n      manual: { onEnter: buildWorkItem },\n    },\n    done: {\n      issue: { onEnter: completeIssue },\n    },\n  },\n  review: {\n    intake: { pullRequest: { onEnter: onArrival(reviewPullRequest) } },\n    review: { pullRequest: { onEnter: reviewPullRequest } },\n  },\n  tools: { submit_plan: { onResult: advanceApprovedPlan } },\n  github: {\n    issueOpened: { onEvent: issueOpened },\n    issueEdited: { onEvent: retriageGithubIssue },\n    issueClosed: { onEvent: issueClosed },\n    issueCommentCreated: { onEvent: retriageGithubIssue },\n    issueCommentEdited: { onEvent: retriageGithubIssue },\n    issueCommentDeleted: { onEvent: retriageGithubIssue },\n    pullRequestOpened: { onEvent: pullRequestOpened },\n    pullRequestUpdated: { onEvent: reReviewUpdatedPullRequest },\n    pullRequestCommentCreated: { onEvent: addressPullRequestComment },\n    pullRequestReviewRequested: { onEvent: reReviewRequestedPullRequest },\n    pullRequestReviewSubmitted: { onEvent: addressReviewFeedback },\n    pullRequestMerged: { onEvent: pullRequestMerged },\n    pullRequestClosed: { onEvent: pullRequestClosed },\n  },\n  linear: { issueObserved: { onEvent: linearIssueObserved }, issueClosed: { onEvent: linearIssueClosed } },\n};\n\nfunction mergeBoardRules(\n  base: FactoryBoardRules | undefined,\n  overrides: FactoryBoardRules | undefined,\n): FactoryBoardRules {\n  const result: FactoryBoardRules = {};\n  const stages = new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})]) as Set<FactoryRuleStage>;\n  for (const stage of stages) {\n    const baseSources = base?.[stage];\n    const overrideSources = overrides?.[stage];\n    const sources = new Set([\n      ...Object.keys(baseSources ?? {}),\n      ...Object.keys(overrideSources ?? {}),\n    ]) as Set<FactoryRuleSource>;\n    const mergedSources: Partial<Record<FactoryRuleSource, FactoryBoardRuleLeaf>> = {};\n    for (const source of sources) {\n      const baseLeaf = baseSources?.[source];\n      const overrideLeaf = overrideSources?.[source];\n      mergedSources[source] = {\n        ...(baseLeaf && 'onEnter' in baseLeaf ? { onEnter: baseLeaf.onEnter } : {}),\n        ...(baseLeaf && 'onExit' in baseLeaf ? { onExit: baseLeaf.onExit } : {}),\n        ...(overrideLeaf && 'onEnter' in overrideLeaf ? { onEnter: overrideLeaf.onEnter } : {}),\n        ...(overrideLeaf && 'onExit' in overrideLeaf ? { onExit: overrideLeaf.onExit } : {}),\n      };\n    }\n    result[stage] = mergedSources;\n  }\n  return result;\n}\n\nfunction mergeToolRules(\n  base: Record<string, FactoryToolRuleLeaf> | undefined,\n  overrides: Record<string, FactoryToolRuleLeaf> | undefined,\n): Record<string, FactoryToolRuleLeaf> {\n  const result: Record<string, FactoryToolRuleLeaf> = {};\n  for (const name of new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})])) {\n    const baseLeaf = base?.[name];\n    const overrideLeaf = overrides?.[name];\n    result[name] = {\n      ...(baseLeaf && 'onResult' in baseLeaf ? { onResult: baseLeaf.onResult } : {}),\n      ...(overrideLeaf && 'onResult' in overrideLeaf ? { onResult: overrideLeaf.onResult } : {}),\n    };\n  }\n  return result;\n}\n\nfunction mergeGithubRules(\n  base: FactoryRulesOverrides['github'],\n  overrides: FactoryRulesOverrides['github'],\n): NonNullable<FactoryRulesOverrides['github']> {\n  const result: Partial<Record<FactoryGithubEventName, FactoryGithubRuleLeaf>> = {};\n  const events = new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})]) as Set<FactoryGithubEventName>;\n  for (const event of events) {\n    const baseLeaf = base?.[event];\n    const overrideLeaf = overrides?.[event];\n    result[event] = {\n      ...(baseLeaf && 'onEvent' in baseLeaf ? { onEvent: baseLeaf.onEvent } : {}),\n      ...(overrideLeaf && 'onEvent' in overrideLeaf ? { onEvent: overrideLeaf.onEvent } : {}),\n    };\n  }\n  return result;\n}\n\nfunction mergeLinearRules(\n  base: FactoryRulesOverrides['linear'],\n  overrides: FactoryRulesOverrides['linear'],\n): NonNullable<FactoryRulesOverrides['linear']> {\n  const result: Partial<Record<FactoryLinearEventName, FactoryLinearRuleLeaf>> = {};\n  const events = new Set([...Object.keys(base ?? {}), ...Object.keys(overrides ?? {})]) as Set<FactoryLinearEventName>;\n  for (const event of events) {\n    const baseLeaf = base?.[event];\n    const overrideLeaf = overrides?.[event];\n    result[event] = {\n      ...(baseLeaf && 'onEvent' in baseLeaf ? { onEvent: baseLeaf.onEvent } : {}),\n      ...(overrideLeaf && 'onEvent' in overrideLeaf ? { onEvent: overrideLeaf.onEvent } : {}),\n    };\n  }\n  return result;\n}\n\nexport function mergeFactoryRuleOverrides(\n  base: FactoryRulesOverrides,\n  overrides: FactoryRulesOverrides = {},\n): Omit<FactoryRules, 'version'> {\n  return {\n    work: mergeBoardRules(base.work, overrides.work),\n    review: mergeBoardRules(base.review, overrides.review),\n    tools: mergeToolRules(base.tools, overrides.tools),\n    github: mergeGithubRules(base.github, overrides.github),\n    linear: mergeLinearRules(base.linear, overrides.linear),\n  };\n}\n\nexport function defaultFactoryRules(input: { version: string; overrides?: FactoryRulesOverrides }): FactoryRules {\n  if (typeof input?.version !== 'string' || input.version.trim().length === 0) {\n    throw new FactoryRuleValidationError('Factory rule version is required.');\n  }\n\n  const rules: FactoryRules = {\n    version: input.version.trim(),\n    ...mergeFactoryRuleOverrides(BUILT_IN_DEFAULTS, input.overrides),\n  };\n  assertFactoryRules(rules);\n  return rules;\n}\n\nexport function builtInFactoryRules(): FactoryRules {\n  return defaultFactoryRules({ version: DEFAULT_FACTORY_RULE_VERSION });\n}\n"],"mappings":"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"}

package/dist/rules/dispatch-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-errors.d.ts","sourceRoot":"","sources":["../../src/rules/dispatch-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAExF,UAAU,8BAA8B;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EAAE,0BAA0B;gBAAhC,IAAI,EAAE,0BAA0B,EACzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAErF;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,0BAA0B,GAAG,IAAI,GACtC,8BAA8B,CAEhC"}
+{"version":3,"file":"dispatch-errors.d.ts","sourceRoot":"","sources":["../../src/rules/dispatch-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAExF,UAAU,8BAA8B;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAqBD,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EAAE,0BAA0B;gBAAhC,IAAI,EAAE,0BAA0B,EACzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAErF;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,0BAA0B,GAAG,IAAI,GACtC,8BAA8B,CAEhC"}

package/dist/rules/dispatch-errors.js

@@ -20,6 +20,14 @@ const FAILURE_METADATA = {
 		canRetry: true,
 		label: "Factory message delivery failed"
 	},
+	plan_awaiting_approval: {
+		canRetry: false,
+		label: "Plan waiting for review"
+	},
+	run_awaiting_input: {
+		canRetry: false,
+		label: "Agent is waiting for an answer"
+	},
 	repository_git_missing: {
 		canRetry: false,
 		label: "Git is unavailable in the workspace"

package/dist/rules/dispatch-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-errors.js","names":[],"sources":["../../src/rules/dispatch-errors.ts"],"sourcesContent":["import type { FactoryDispatchFailureCode } from '../storage/domains/work-items/base.js';\n\ninterface FactoryDispatchFailureMetadata {\n  canRetry: boolean;\n  label: string;\n}\n\nconst FAILURE_METADATA = {\n  session_unavailable: { canRetry: true, label: 'Factory session unavailable' },\n  source_control_missing: { canRetry: true, label: 'Source-control connection unavailable' },\n  source_repository_missing: { canRetry: true, label: 'Source repository unavailable' },\n  unsupported_provider_item: { canRetry: false, label: 'Unsupported provider work item' },\n  notification_delivery_failed: { canRetry: true, label: 'Factory message delivery failed' },\n  repository_git_missing: { canRetry: false, label: 'Git is unavailable in the workspace' },\n  repository_egress_blocked: { canRetry: false, label: 'Repository network access is blocked' },\n  repository_clone_failed: { canRetry: true, label: 'Repository clone failed' },\n  repository_pull_failed: { canRetry: true, label: 'Repository update failed' },\n  repository_push_failed: { canRetry: true, label: 'Repository push failed' },\n  repository_commit_failed: { canRetry: true, label: 'Repository commit failed' },\n  repository_cli_missing: { canRetry: false, label: 'GitHub CLI is unavailable in the workspace' },\n  repository_pr_failed: { canRetry: true, label: 'Pull request creation failed' },\n  unknown: { canRetry: true, label: 'Factory automation failed' },\n} satisfies Record<FactoryDispatchFailureCode, FactoryDispatchFailureMetadata>;\n\nexport class FactoryDispatchError extends Error {\n  constructor(\n    readonly code: FactoryDispatchFailureCode,\n    message: string,\n    options?: ErrorOptions,\n  ) {\n    super(message, options);\n    this.name = 'FactoryDispatchError';\n  }\n}\n\nexport function factoryDispatchFailureCode(error: unknown): FactoryDispatchFailureCode {\n  return error instanceof FactoryDispatchError ? error.code : 'unknown';\n}\n\nexport function factoryDispatchFailureMetadata(\n  code: FactoryDispatchFailureCode | null,\n): FactoryDispatchFailureMetadata {\n  return code === null ? FAILURE_METADATA.unknown : FAILURE_METADATA[code];\n}\n"],"mappings":";AAOA,MAAM,mBAAmB;CACvB,qBAAqB;EAAE,UAAU;EAAM,OAAO;CAA8B;CAC5E,wBAAwB;EAAE,UAAU;EAAM,OAAO;CAAwC;CACzF,2BAA2B;EAAE,UAAU;EAAM,OAAO;CAAgC;CACpF,2BAA2B;EAAE,UAAU;EAAO,OAAO;CAAiC;CACtF,8BAA8B;EAAE,UAAU;EAAM,OAAO;CAAkC;CACzF,wBAAwB;EAAE,UAAU;EAAO,OAAO;CAAsC;CACxF,2BAA2B;EAAE,UAAU;EAAO,OAAO;CAAuC;CAC5F,yBAAyB;EAAE,UAAU;EAAM,OAAO;CAA0B;CAC5E,wBAAwB;EAAE,UAAU;EAAM,OAAO;CAA2B;CAC5E,wBAAwB;EAAE,UAAU;EAAM,OAAO;CAAyB;CAC1E,0BAA0B;EAAE,UAAU;EAAM,OAAO;CAA2B;CAC9E,wBAAwB;EAAE,UAAU;EAAO,OAAO;CAA6C;CAC/F,sBAAsB;EAAE,UAAU;EAAM,OAAO;CAA+B;CAC9E,SAAS;EAAE,UAAU;EAAM,OAAO;CAA4B;AAChE;AAEA,IAAa,uBAAb,cAA0C,MAAM;CAEnC;CADX,YACE,MACA,SACA,SACA;EACA,MAAM,SAAS,OAAO;EAJb,KAAA,OAAA;EAKT,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,2BAA2B,OAA4C;CACrF,OAAO,iBAAiB,uBAAuB,MAAM,OAAO;AAC9D;AAEA,SAAgB,+BACd,MACgC;CAChC,OAAO,SAAS,OAAO,iBAAiB,UAAU,iBAAiB;AACrE"}
+{"version":3,"file":"dispatch-errors.js","names":[],"sources":["../../src/rules/dispatch-errors.ts"],"sourcesContent":["import type { FactoryDispatchFailureCode } from '../storage/domains/work-items/base.js';\n\ninterface FactoryDispatchFailureMetadata {\n  canRetry: boolean;\n  label: string;\n}\n\nconst FAILURE_METADATA = {\n  session_unavailable: { canRetry: true, label: 'Factory session unavailable' },\n  source_control_missing: { canRetry: true, label: 'Source-control connection unavailable' },\n  source_repository_missing: { canRetry: true, label: 'Source repository unavailable' },\n  unsupported_provider_item: { canRetry: false, label: 'Unsupported provider work item' },\n  notification_delivery_failed: { canRetry: true, label: 'Factory message delivery failed' },\n  plan_awaiting_approval: { canRetry: false, label: 'Plan waiting for review' },\n  run_awaiting_input: { canRetry: false, label: 'Agent is waiting for an answer' },\n  repository_git_missing: { canRetry: false, label: 'Git is unavailable in the workspace' },\n  repository_egress_blocked: { canRetry: false, label: 'Repository network access is blocked' },\n  repository_clone_failed: { canRetry: true, label: 'Repository clone failed' },\n  repository_pull_failed: { canRetry: true, label: 'Repository update failed' },\n  repository_push_failed: { canRetry: true, label: 'Repository push failed' },\n  repository_commit_failed: { canRetry: true, label: 'Repository commit failed' },\n  repository_cli_missing: { canRetry: false, label: 'GitHub CLI is unavailable in the workspace' },\n  repository_pr_failed: { canRetry: true, label: 'Pull request creation failed' },\n  unknown: { canRetry: true, label: 'Factory automation failed' },\n} satisfies Record<FactoryDispatchFailureCode, FactoryDispatchFailureMetadata>;\n\nexport class FactoryDispatchError extends Error {\n  constructor(\n    readonly code: FactoryDispatchFailureCode,\n    message: string,\n    options?: ErrorOptions,\n  ) {\n    super(message, options);\n    this.name = 'FactoryDispatchError';\n  }\n}\n\nexport function factoryDispatchFailureCode(error: unknown): FactoryDispatchFailureCode {\n  return error instanceof FactoryDispatchError ? error.code : 'unknown';\n}\n\nexport function factoryDispatchFailureMetadata(\n  code: FactoryDispatchFailureCode | null,\n): FactoryDispatchFailureMetadata {\n  return code === null ? FAILURE_METADATA.unknown : FAILURE_METADATA[code];\n}\n"],"mappings":";AAOA,MAAM,mBAAmB;CACvB,qBAAqB;EAAE,UAAU;EAAM,OAAO;CAA8B;CAC5E,wBAAwB;EAAE,UAAU;EAAM,OAAO;CAAwC;CACzF,2BAA2B;EAAE,UAAU;EAAM,OAAO;CAAgC;CACpF,2BAA2B;EAAE,UAAU;EAAO,OAAO;CAAiC;CACtF,8BAA8B;EAAE,UAAU;EAAM,OAAO;CAAkC;CACzF,wBAAwB;EAAE,UAAU;EAAO,OAAO;CAA0B;CAC5E,oBAAoB;EAAE,UAAU;EAAO,OAAO;CAAiC;CAC/E,wBAAwB;EAAE,UAAU;EAAO,OAAO;CAAsC;CACxF,2BAA2B;EAAE,UAAU;EAAO,OAAO;CAAuC;CAC5F,yBAAyB;EAAE,UAAU;EAAM,OAAO;CAA0B;CAC5E,wBAAwB;EAAE,UAAU;EAAM,OAAO;CAA2B;CAC5E,wBAAwB;EAAE,UAAU;EAAM,OAAO;CAAyB;CAC1E,0BAA0B;EAAE,UAAU;EAAM,OAAO;CAA2B;CAC9E,wBAAwB;EAAE,UAAU;EAAO,OAAO;CAA6C;CAC/F,sBAAsB;EAAE,UAAU;EAAM,OAAO;CAA+B;CAC9E,SAAS;EAAE,UAAU;EAAM,OAAO;CAA4B;AAChE;AAEA,IAAa,uBAAb,cAA0C,MAAM;CAEnC;CADX,YACE,MACA,SACA,SACA;EACA,MAAM,SAAS,OAAO;EAJb,KAAA,OAAA;EAKT,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,2BAA2B,OAA4C;CACrF,OAAO,iBAAiB,uBAAuB,MAAM,OAAO;AAC9D;AAEA,SAAgB,+BACd,MACgC;CAChC,OAAO,SAAS,OAAO,iBAAiB,UAAU,iBAAiB;AACrE"}

package/dist/rules/dispatcher.d.ts

@@ -20,6 +20,11 @@ export interface FactoryDecisionDispatcherOptions {
         orgId: string;
         factoryProjectId: string;
     }) => Promise<boolean>;
+    /** `true` lets the dispatcher answer a run's plan itself, so started work carries to Done. */
+    autoApprovePlans?: (tenant: {
+        orgId: string;
+        factoryProjectId: string;
+    }) => Promise<boolean>;
     reconcileToolResults?: () => Promise<void>;
     prepareBinding?: (input: FactoryBindingPreparationInput) => Promise<void>;
     primeCredentials?: (tenant: {

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

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/rules/dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAyC,MAAM,+BAA+B,CAAC;AAM5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EACV,6BAA6B,EAG7B,WAAW,EACX,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAA4C,MAAM,YAAY,CAAC;AA+DlG,KAAK,iBAAiB,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC,CAAC;AAGxF,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,6BAA6B,CAAC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,8EAA8E;IAC9E,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,6BAA6B,CAAC,EAAE,CAAC,KAAK,EAAE;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE;YAAE,IAAI,EAAE,sBAAsB,CAAA;SAAE,CAAC,CAAC;KAC5E,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,mCAAmC,CAAC,EAAE,MAAM,CAAC;CAC9C;AA+FD,qBAAa,yBAAyB;;gBAuBxB,OAAO,EAAE,gCAAgC;IAyBrD,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,OAAO,CAAC,GAAG,OAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAyuB/C;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;CAU7B,CAAC"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/rules/dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAyC,MAAM,+BAA+B,CAAC;AAO5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EACV,6BAA6B,EAI7B,WAAW,EACX,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAA4C,MAAM,YAAY,CAAC;AA4KlG,KAAK,iBAAiB,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC,CAAC;AAGxF,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,6BAA6B,CAAC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5F,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,8EAA8E;IAC9E,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,6BAA6B,CAAC,EAAE,CAAC,KAAK,EAAE;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE;YAAE,IAAI,EAAE,sBAAsB,CAAA;SAAE,CAAC,CAAC;KAC5E,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,mCAAmC,CAAC,EAAE,MAAM,CAAC;CAC9C;AAyGD,qBAAa,yBAAyB;;gBAwBxB,OAAO,EAAE,gCAAgC;IA0BrD,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,OAAO,CAAC,GAAG,OAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CA0sB/C;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;CAU7B,CAAC"}

package/dist/rules/dispatcher.js

@@ -1,7 +1,7 @@
-import { FACTORY_RULE_STAGES } from "./types.js";
+import { FACTORY_RULE_STAGES, externallyAuthoredWorkItem, isWorkingFactoryRuleStage } from "./types.js";
 import { validateFactoryRuleDecision } from "./validation.js";
 import { FACTORY_RULE_MATERIALIZATION_KEY } from "../storage/domains/work-items/base.js";
-import { FactoryDispatchError, factoryDispatchFailureCode } from "./dispatch-errors.js";
+import { FactoryDispatchError, factoryDispatchFailureCode, factoryDispatchFailureMetadata } from "./dispatch-errors.js";
 import { withWorkItemFeed } from "../storage/domains/comments/feed-context.js";
 import { resolvePromptInvocation, resolveSkillInvocation } from "../skills/service.js";
 import { randomUUID } from "crypto";
@@ -11,6 +11,7 @@ const LEASE_MS = 3e4;
 const POLL_MS = 1e3;
 const BATCH_SIZE = 10;
 const MAX_ATTEMPTS = 5;
+const MAX_PLAN_APPROVALS = 3;
 const MAX_ERROR_LENGTH = 512;
 const MAX_BACKOFF_MS = 6e4;
 const SKILL_COMPLETION_OBSERVATION_TIMEOUT_MS = 10 * 6e4;
@@ -18,6 +19,65 @@ const MAX_IN_FLIGHT = 25;
 const STALE_BINDING_SWEEP_INTERVAL_MS = 10 * 6e4;
 const STALE_BINDING_TTL_MS = 1440 * 6e4;
 const RECONCILE_INTERVAL_MS = 3e4;
+function isTerminalFailure(attempts, failureCode) {
+	return attempts >= MAX_ATTEMPTS || !factoryDispatchFailureMetadata(failureCode).canRetry;
+}
+function watchRun(session, { timeoutMs, approvePlans, onParkedRun, label }) {
+	let resolveAgentEnd;
+	let agentEnd;
+	let endReason;
+	let parked;
+	const arm = () => {
+		endReason = void 0;
+		agentEnd = new Promise((resolve) => {
+			resolveAgentEnd = resolve;
+		});
+	};
+	arm();
+	const unsubscribe = session.subscribe((event) => {
+		if (event.type === "agent_end") {
+			endReason = event.reason;
+			resolveAgentEnd();
+			return;
+		}
+		if (event.type === "tool_suspended") {
+			parked = {
+				toolName: event.toolName,
+				toolCallId: event.toolCallId
+			};
+			return;
+		}
+		if (event.type === "tool_suspension_cancelled" && parked?.toolCallId === event.toolCallId) parked = void 0;
+	});
+	const wait = () => waitForAgentEndOrTimeout(agentEnd, timeoutMs);
+	return {
+		arm,
+		wait,
+		close: unsubscribe,
+		/** The run's own verdict, thrown as what the dispatcher should record. */
+		async settle() {
+			let observed = await wait();
+			if (approvePlans) for (let approvals = 0; parked?.toolName === "submit_plan" && approvals < MAX_PLAN_APPROVALS; approvals += 1) {
+				const { toolCallId } = parked;
+				parked = void 0;
+				arm();
+				await session.respondToToolSuspension({
+					resumeData: { action: "approved" },
+					toolCallId
+				});
+				observed = await wait();
+			}
+			if (parked !== void 0 && (!observed || endReason === "suspended")) {
+				if (onParkedRun === "await") return;
+				if (parked.toolName === "submit_plan") throw new FactoryDispatchError("plan_awaiting_approval", "Factory run wrote a plan and is waiting for it to be reviewed.");
+				throw new FactoryDispatchError("run_awaiting_input", `Factory run is waiting on ${parked.toolName} for an answer.`);
+			}
+			if (!observed) throw new Error(`${label} terminal event was not observed before timeout.`);
+			if (endReason === "error") throw new Error(`${label} ended in error.`);
+			if (endReason === "aborted") throw new Error(`${label} was aborted before it finished.`);
+		}
+	};
+}
 function waitForAgentEndOrTimeout(agentEnd, timeoutMs) {
 	return new Promise((resolve) => {
 		const timeout = setTimeout(() => resolve(false), timeoutMs);
@@ -59,6 +119,14 @@ function deferredActor(record) {
 		id: "factory-rule-dispatcher"
 	};
 }
+function externalActor(actor) {
+	return actor !== null && actor.type !== "human" && actor.type !== "agent" && actor.type !== "system";
+}
+/** A run start asks for consent; an external event asks before pulling a card back into a working lane. */
+function requestsConsent(record, decision) {
+	if (decision.type === "invokeSkill") return true;
+	return decision.type === "transition" && isWorkingFactoryRuleStage(decision.stage) && externalActor(record.actor);
+}
 function leaseIdentity(record, ownerId) {
 	return {
 		id: record.id,
@@ -94,6 +162,7 @@ var FactoryDecisionDispatcher = class {
 	#storage;
 	#ownerId;
 	#isAutoRunEnabled;
+	#autoApprovePlans;
 	#reconcileToolResults;
 	#prepareBinding;
 	#primeCredentials;
@@ -116,6 +185,7 @@ var FactoryDecisionDispatcher = class {
 		this.#storage = options.storage;
 		this.#ownerId = options.ownerId ?? `factory-dispatcher:${randomUUID()}`;
 		this.#isAutoRunEnabled = options.isAutoRunEnabled;
+		this.#autoApprovePlans = options.autoApprovePlans;
 		this.#reconcileToolResults = options.reconcileToolResults;
 		this.#prepareBinding = options.prepareBinding;
 		this.#primeCredentials = options.primeCredentials;
@@ -241,14 +311,14 @@ 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) {
-			const terminal = record.attempts >= MAX_ATTEMPTS;
+			const failureCode = factoryDispatchFailureCode(error);
 			await this.#storage.failDeferredDecision({
 				...leaseIdentity(record, this.#ownerId),
 				now: /* @__PURE__ */ new Date(),
 				availableAt: retryAt(now, record.attempts),
 				lastError: sanitizeDispatchError(error),
-				failureCode: factoryDispatchFailureCode(error),
-				terminal,
+				failureCode,
+				terminal: isTerminalFailure(record.attempts, failureCode),
 				advanceDeliveryGeneration: !executionCompleted
 			});
 		}
@@ -274,17 +344,18 @@ var FactoryDecisionDispatcher = class {
 			console.error("Factory proposal supersede failed", sanitizeDispatchError(error));
 		}
 	}
-	/** Starting an agent run spends the project's compute and executes its code — the one effect a human owns. */
 	async #needsApproval(record, decision) {
-		if (decision.type !== "invokeSkill" || record.approvedAt !== null) return false;
-		if (await this.#isAutoRunEnabled({
-			orgId: record.orgId,
-			factoryProjectId: record.factoryProjectId
-		})) return false;
-		return (record.workItemId ? await this.#storage.get({
+		if (record.approvedAt !== null || !requestsConsent(record, decision)) return false;
+		const item = record.workItemId ? await this.#storage.get({
 			orgId: record.orgId,
 			id: record.workItemId
-		}) : null)?.autonomyArmedAt == null;
+		}) : null;
+		if (item && externallyAuthoredWorkItem(item)) return true;
+		if (item?.autonomyArmedAt != null) return false;
+		return !await this.#isAutoRunEnabled({
+			orgId: record.orgId,
+			factoryProjectId: record.factoryProjectId
+		});
 	}
 	async #executeDecision(record, decision) {
 		const nextChain = [...record.causalChain, {
@@ -352,10 +423,11 @@ var FactoryDecisionDispatcher = class {
 				return;
 			case "invokeSkill": {
 				const binding = await this.#requireOrPrepareBinding(record, decision.role);
-				const startedBy = (record.workItemId ? await this.#storage.get({
+				const item = record.workItemId ? await this.#storage.get({
 					orgId: record.orgId,
 					id: record.workItemId
-				}) : null)?.sessions[binding.role]?.startedBy;
+				}) : null;
+				const startedBy = item?.sessions[binding.role]?.startedBy;
 				if (!startedBy) throw new Error(`Factory binding ${binding.id} has no authenticated session owner.`);
 				await this.#primeCredentials?.({
 					orgId: record.orgId,
@@ -398,21 +470,11 @@ var FactoryDecisionDispatcher = class {
 					ifIdle: { behavior: "persist" },
 					requestContext
 				}));
-				let resolveAgentEnd;
-				let agentEnd;
-				let endReason;
-				const armAgentEnd = () => {
-					endReason = void 0;
-					agentEnd = new Promise((resolve) => {
-						resolveAgentEnd = resolve;
-					});
-				};
-				armAgentEnd();
-				const unsubscribe = session.subscribe((event) => {
-					if (event.type === "agent_end") {
-						endReason = event.reason;
-						resolveAgentEnd();
-					}
+				const run = watchRun(session, {
+					timeoutMs: this.#skillCompletionObservationTimeoutMs,
+					approvePlans: await this.#plansAreAutoApproved(record, item),
+					onParkedRun: "escalate",
+					label: "Factory skill run"
 				});
 				const sendKickoff = async () => {
 					const settled = await session.sendSignal({
@@ -431,22 +493,21 @@ var FactoryDecisionDispatcher = class {
 					let settled = await sendKickoff();
 					if (settled.action === "deliver") {
 						if (!(await session.thread.listActiveMessages()).some((message) => message.id === deliveryId)) {
-							if (!await waitForAgentEndOrTimeout(agentEnd, this.#skillCompletionObservationTimeoutMs)) throw new Error("Factory skill invocation is waiting on a run that has not ended.");
-							armAgentEnd();
+							if (!await run.wait()) throw new Error("Factory skill invocation is waiting on a run that has not ended.");
+							run.arm();
 							settled = await sendKickoff();
 							if (settled.action !== "wake") throw new Error("Factory skill invocation was queued onto an ending run and never reached the agent.");
 						}
 					}
-					if (!await waitForAgentEndOrTimeout(agentEnd, this.#skillCompletionObservationTimeoutMs)) throw new Error("Factory skill run terminal event was not observed before timeout.");
-					else if (endReason === "error") throw new Error("Factory skill run ended in error.");
-					else if (endReason === "aborted") throw new Error("Factory skill run was aborted before it finished.");
+					await run.settle();
 				} finally {
-					unsubscribe();
+					run.close();
 				}
 				return;
 			}
 			case "sendMessage": {
-				const binding = decision.prepareBinding ? await this.#requireOrPrepareBinding(record, decision.role) : await this.#requireBinding(record, decision.role);
+				const binding = await this.#messageBinding(record, decision);
+				if (!binding) return;
 				const startedBy = (record.workItemId ? await this.#storage.get({
 					orgId: record.orgId,
 					id: record.workItemId
@@ -601,6 +662,10 @@ var FactoryDecisionDispatcher = class {
 		if (!binding) throw new FactoryDispatchError("session_unavailable", role ? `No active Factory binding for role ${role}.` : "No active Factory binding.");
 		return binding;
 	}
+	async #messageBinding(record, decision) {
+		if (decision.prepareBinding && decision.role !== void 0) return this.#requireOrPrepareBinding(record, decision.role);
+		return this.#findBinding(record, decision.role);
+	}
 	async #requireOrPrepareBinding(record, role) {
 		const binding = await this.#findBinding(record, role);
 		if (binding) {
@@ -621,6 +686,14 @@ var FactoryDecisionDispatcher = class {
 		await this.#switchThread(session, binding);
 		return session;
 	}
+	/** Unset means off: a plan nobody asked us to answer is a plan someone should see. */
+	async #plansAreAutoApproved({ orgId, factoryProjectId }, item) {
+		if (item?.plansPreapprovedAt) return true;
+		return this.#autoApprovePlans ? await this.#autoApprovePlans({
+			orgId,
+			factoryProjectId
+		}) : false;
+	}
 	async #requireSession(binding) {
 		const session = await this.#findSession(binding);
 		if (!session) throw new FactoryDispatchError("session_unavailable", "Bound Factory session not found.");
@@ -657,10 +730,11 @@ var FactoryDecisionDispatcher = class {
 				if (record.message === null) return;
 				const binding = (await this.#storage.listRunBindings(record.orgId, record.factoryProjectId)).find((candidate) => candidate.id === record.bindingId && candidate.status === "active");
 				if (!binding) throw new FactoryDispatchError("session_unavailable", "Prepared Factory binding is unavailable or revoked.");
-				const startedBy = (await this.#storage.get({
+				const item = await this.#storage.get({
 					orgId: record.orgId,
 					id: binding.workItemId
-				}))?.sessions[binding.role]?.startedBy;
+				});
+				const startedBy = item?.sessions[binding.role]?.startedBy;
 				if (!startedBy) throw new Error(`Factory binding ${binding.id} has no authenticated session owner.`);
 				await this.#primeCredentials?.({
 					orgId: record.orgId,
@@ -672,21 +746,11 @@ var FactoryDecisionDispatcher = class {
 					organizationId: record.orgId
 				});
 				const session = await this.#requireSession(binding);
-				let resolveAgentEnd;
-				let agentEnd;
-				let endReason;
-				const armAgentEnd = () => {
-					endReason = void 0;
-					agentEnd = new Promise((resolve) => {
-						resolveAgentEnd = resolve;
-					});
-				};
-				armAgentEnd();
-				const unsubscribe = session.subscribe((event) => {
-					if (event.type === "agent_end") {
-						endReason = event.reason;
-						resolveAgentEnd();
-					}
+				const run = watchRun(session, {
+					timeoutMs: this.#skillCompletionObservationTimeoutMs,
+					approvePlans: await this.#plansAreAutoApproved(record, item),
+					onParkedRun: "await",
+					label: "Factory kickoff run"
 				});
 				const sendKickoff = (dedupeKey) => awaitNotification(() => session.sendNotificationSignal({
 					source: "factory",
@@ -704,27 +768,26 @@ var FactoryDecisionDispatcher = class {
 				try {
 					let settled = await sendKickoff(`factory-kickoff:${record.kickoffKey}`);
 					if (settled?.action === "deliver") {
-						if (!await waitForAgentEndOrTimeout(agentEnd, this.#skillCompletionObservationTimeoutMs)) throw new Error("Factory kickoff is waiting on a run that has not ended.");
-						armAgentEnd();
+						if (!await run.wait()) throw new Error("Factory kickoff is waiting on a run that has not ended.");
+						run.arm();
 						settled = await sendKickoff(`factory-kickoff:${record.kickoffKey}:retry:${record.attempts}`);
 						if (settled?.action !== "wake") throw new Error("Factory kickoff was queued onto an ending run and never reached the agent.");
 					}
-					if (!await waitForAgentEndOrTimeout(agentEnd, this.#skillCompletionObservationTimeoutMs)) throw new Error("Factory kickoff run terminal event was not observed before timeout.");
-					else if (endReason === "error") throw new Error("Factory kickoff run ended in error.");
-					else if (endReason === "aborted") throw new Error("Factory kickoff run was aborted before it finished.");
+					await run.settle();
 				} finally {
-					unsubscribe();
+					run.close();
 				}
 			});
 			if (!await this.#storage.completePendingStart(leaseIdentity(record, this.#ownerId), /* @__PURE__ */ new Date())) throw new Error("Factory kickoff lease was lost before completion.");
 		} catch (error) {
+			const failureCode = factoryDispatchFailureCode(error);
 			await this.#storage.failPendingStart({
 				...leaseIdentity(record, this.#ownerId),
 				now: /* @__PURE__ */ new Date(),
 				availableAt: retryAt(now, record.attempts),
 				lastError: sanitizeDispatchError(error),
-				failureCode: factoryDispatchFailureCode(error),
-				terminal: record.attempts >= MAX_ATTEMPTS
+				failureCode,
+				terminal: isTerminalFailure(record.attempts, failureCode)
 			});
 		}
 	}