@mastra/factory 0.0.0-fix-thread-subscription-multi-instance-redis-streams-20260730204150

package/dist/rules/types.d.ts

@@ -0,0 +1,234 @@
+export type WorkItemSource = 'github-issue' | 'github-pr' | 'linear-issue' | 'manual';
+export declare const FACTORY_RULE_STAGES: readonly ["intake", "triage", "planning", "execute", "review", "done", "canceled"];
+export type FactoryRuleStage = (typeof FACTORY_RULE_STAGES)[number];
+export declare const FACTORY_RULE_BOARDS: readonly ["work", "review"];
+export type FactoryRuleBoard = (typeof FACTORY_RULE_BOARDS)[number];
+export declare const FACTORY_RULE_SOURCES: readonly ["issue", "pullRequest", "linearIssue", "manual"];
+export type FactoryRuleSource = (typeof FACTORY_RULE_SOURCES)[number];
+export declare const FACTORY_GITHUB_EVENTS: readonly ["issueOpened", "pullRequestOpened", "pullRequestUpdated", "pullRequestReviewRequested", "pullRequestMerged", "pullRequestClosed"];
+export type FactoryGithubEventName = (typeof FACTORY_GITHUB_EVENTS)[number];
+export declare const FACTORY_LINEAR_EVENTS: readonly ["issueObserved"];
+export type FactoryLinearEventName = (typeof FACTORY_LINEAR_EVENTS)[number];
+export type FactoryRuleJsonValue = null | boolean | number | string | FactoryRuleJsonValue[] | {
+    [key: string]: FactoryRuleJsonValue;
+};
+export interface FactoryRuleItemContext {
+    id: string;
+    source: WorkItemSource;
+    sourceKey: string | null;
+    parentWorkItemId: string | null;
+    title: string;
+    url: string | null;
+    stages: readonly string[];
+}
+export type FactoryRuleActor = {
+    type: 'human';
+    id: string;
+} | {
+    type: 'agent';
+    bindingId: string;
+    role: string;
+} | {
+    type: 'github';
+    login: string;
+    trusted: boolean;
+    factoryAuthored: boolean;
+} | {
+    type: 'system';
+    id: string;
+};
+export interface FactoryRuleIngressIdentity {
+    type: 'human' | 'agent' | 'toolResult' | 'github' | 'linear' | 'rule';
+    id: string;
+}
+export interface FactoryRuleCausalEntry {
+    ingressId: string;
+    decisionType: FactoryCommitDecision['type'];
+}
+export interface FactoryRuleContextBase {
+    tenant: {
+        orgId: string;
+        projectId: string;
+    };
+    actor: FactoryRuleActor;
+    ingress: FactoryRuleIngressIdentity;
+    cause: string;
+    causalChain: readonly FactoryRuleCausalEntry[];
+    ruleSetVersion: string;
+}
+export interface FactoryBoundRuleContext extends FactoryRuleContextBase {
+    item: FactoryRuleItemContext;
+    board: FactoryRuleBoard;
+    itemRevision: number;
+}
+export interface FactoryStageRuleContext extends FactoryBoundRuleContext {
+    source: FactoryRuleSource;
+    stage: FactoryRuleStage;
+    fromStage: FactoryRuleStage;
+    toStage: FactoryRuleStage;
+}
+export interface FactoryToolResultRuleContext extends FactoryBoundRuleContext {
+    toolName: string;
+    threadId: string;
+    assistantMessageId: string;
+    toolCallId: string;
+    result: {
+        status: 'success' | 'error';
+        value: FactoryRuleJsonValue;
+    };
+}
+export interface FactoryGithubRuleContext extends FactoryRuleContextBase {
+    item?: FactoryRuleItemContext;
+    board?: FactoryRuleBoard;
+    itemRevision?: number;
+    event: FactoryGithubEventName;
+    deliveryId: string;
+    factory: {
+        createdAt: string;
+    };
+    repository: {
+        id: number;
+        fullName: string;
+    };
+    issue?: {
+        number: number;
+        title: string;
+        url: string;
+        createdAt?: string;
+    };
+    pullRequest?: {
+        number: number;
+        title: string;
+        url: string;
+        createdAt?: string;
+        state: 'open' | 'closed';
+        merged: boolean;
+        headBranch: string;
+        baseBranch: string;
+    };
+}
+export interface FactoryLinearRuleContext extends FactoryRuleContextBase {
+    item?: FactoryRuleItemContext;
+    board?: FactoryRuleBoard;
+    itemRevision?: number;
+    event: FactoryLinearEventName;
+    issue: {
+        id: string;
+        identifier: string;
+        title: string;
+        url: string;
+        state: string;
+        stateType: string;
+        priorityLabel: string;
+        assignee: string | null;
+        team: string | null;
+        labels: readonly string[];
+        createdAt: string;
+        updatedAt: string;
+    };
+}
+export type FactoryRuleHandler<TContext> = (context: Readonly<TContext>) => FactoryRuleDecision | void | Promise<FactoryRuleDecision | void>;
+export interface FactoryBoardRuleLeaf {
+    onEnter?: FactoryRuleHandler<FactoryStageRuleContext>;
+    onExit?: FactoryRuleHandler<FactoryStageRuleContext>;
+}
+export interface FactoryToolRuleLeaf {
+    onResult?: FactoryRuleHandler<FactoryToolResultRuleContext>;
+}
+export interface FactoryGithubRuleLeaf {
+    onEvent?: FactoryRuleHandler<FactoryGithubRuleContext>;
+}
+export interface FactoryLinearRuleLeaf {
+    onEvent?: FactoryRuleHandler<FactoryLinearRuleContext>;
+}
+export type FactoryBoardRules = Partial<Record<FactoryRuleStage, Partial<Record<FactoryRuleSource, FactoryBoardRuleLeaf>>>>;
+export interface FactoryRules {
+    version: string;
+    work: FactoryBoardRules;
+    review: FactoryBoardRules;
+    tools: Record<string, FactoryToolRuleLeaf>;
+    github: Partial<Record<FactoryGithubEventName, FactoryGithubRuleLeaf>>;
+    linear: Partial<Record<FactoryLinearEventName, FactoryLinearRuleLeaf>>;
+}
+export interface FactoryRulesOverrides {
+    work?: FactoryBoardRules;
+    review?: FactoryBoardRules;
+    tools?: Record<string, FactoryToolRuleLeaf>;
+    github?: Partial<Record<FactoryGithubEventName, FactoryGithubRuleLeaf>>;
+    linear?: Partial<Record<FactoryLinearEventName, FactoryLinearRuleLeaf>>;
+}
+export type FactoryRuleRejectionCode = 'forbidden' | 'invalid_transition' | 'missing_binding' | 'stale' | 'timeout' | 'rule_error' | 'causal_depth_exceeded' | 'repeated_transition';
+export interface FactoryRuleRejectDecision {
+    type: 'reject';
+    code: FactoryRuleRejectionCode;
+    reason: string;
+}
+interface FactoryCommitDecisionBase {
+    idempotencyKey: string;
+}
+export interface FactoryTransitionDecision extends FactoryCommitDecisionBase {
+    type: 'transition';
+    board: FactoryRuleBoard;
+    stage: FactoryRuleStage;
+    /**
+     * Delivered to the item's active session (waking it if idle) after the
+     * transition commits. Skipped when the item has no active run binding, so
+     * informational messages never fail the transition.
+     */
+    message?: {
+        text: string;
+        role?: string;
+    };
+}
+export interface FactoryUpsertLinkedWorkItemDecision extends FactoryCommitDecisionBase {
+    type: 'upsertLinkedWorkItem';
+    board: FactoryRuleBoard;
+    source: WorkItemSource;
+    sourceKey: string;
+    title: string;
+    url: string | null;
+    stage: FactoryRuleStage;
+    metadata?: Record<string, FactoryRuleJsonValue>;
+}
+export interface FactoryInvokeSkillDecision extends FactoryCommitDecisionBase {
+    type: 'invokeSkill';
+    role: string;
+    skillName: string;
+    arguments?: string;
+    precedingMessage?: string;
+}
+export interface FactorySendMessageDecision extends FactoryCommitDecisionBase {
+    type: 'sendMessage';
+    role: string;
+    message: string;
+    priority?: 'medium' | 'high' | 'urgent';
+    idleBehavior?: 'persist' | 'wake';
+    prepareBinding?: boolean;
+}
+export interface FactoryNotifyDecision extends FactoryCommitDecisionBase {
+    type: 'notify';
+    title: string;
+    body?: string;
+    level?: 'info' | 'warning' | 'error';
+}
+export type FactoryCommitDecision = FactoryTransitionDecision | FactoryUpsertLinkedWorkItemDecision | FactoryInvokeSkillDecision | FactorySendMessageDecision | FactoryNotifyDecision;
+export type FactoryRuleDecision = FactoryRuleRejectDecision | FactoryCommitDecision;
+export interface FactoryTransitionResultAccepted {
+    status: 'accepted';
+    transitionId: string;
+    itemId: string;
+    revision: number;
+    stage: FactoryRuleStage;
+    decisions: FactoryCommitDecision[];
+}
+export interface FactoryTransitionResultRejected {
+    status: 'rejected';
+    transitionId: string;
+    itemId: string;
+    code: FactoryRuleRejectionCode;
+    reason: string;
+}
+export type FactoryTransitionResult = FactoryTransitionResultAccepted | FactoryTransitionResultRejected;
+export declare function factoryRuleSourceForWorkItem(source: WorkItemSource): FactoryRuleSource;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/rules/types.js

@@ -0,0 +1,38 @@
+//#region src/rules/types.ts
+const FACTORY_RULE_STAGES = [
+	"intake",
+	"triage",
+	"planning",
+	"execute",
+	"review",
+	"done",
+	"canceled"
+];
+const FACTORY_RULE_BOARDS = ["work", "review"];
+const FACTORY_RULE_SOURCES = [
+	"issue",
+	"pullRequest",
+	"linearIssue",
+	"manual"
+];
+const FACTORY_GITHUB_EVENTS = [
+	"issueOpened",
+	"pullRequestOpened",
+	"pullRequestUpdated",
+	"pullRequestReviewRequested",
+	"pullRequestMerged",
+	"pullRequestClosed"
+];
+const FACTORY_LINEAR_EVENTS = ["issueObserved"];
+function factoryRuleSourceForWorkItem(source) {
+	switch (source) {
+		case "github-issue": return "issue";
+		case "github-pr": return "pullRequest";
+		case "linear-issue": return "linearIssue";
+		case "manual": return "manual";
+	}
+}
+//#endregion
+export { FACTORY_GITHUB_EVENTS, FACTORY_LINEAR_EVENTS, FACTORY_RULE_BOARDS, FACTORY_RULE_SOURCES, FACTORY_RULE_STAGES, factoryRuleSourceForWorkItem };
+
+//# sourceMappingURL=types.js.map

package/dist/rules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/rules/types.ts"],"sourcesContent":["export type WorkItemSource = 'github-issue' | 'github-pr' | 'linear-issue' | 'manual';\n\nexport const FACTORY_RULE_STAGES = ['intake', 'triage', 'planning', 'execute', 'review', 'done', 'canceled'] as const;\nexport type FactoryRuleStage = (typeof FACTORY_RULE_STAGES)[number];\n\nexport const FACTORY_RULE_BOARDS = ['work', 'review'] as const;\nexport type FactoryRuleBoard = (typeof FACTORY_RULE_BOARDS)[number];\n\nexport const FACTORY_RULE_SOURCES = ['issue', 'pullRequest', 'linearIssue', 'manual'] as const;\nexport type FactoryRuleSource = (typeof FACTORY_RULE_SOURCES)[number];\n\nexport const FACTORY_GITHUB_EVENTS = [\n  'issueOpened',\n  'pullRequestOpened',\n  'pullRequestUpdated',\n  'pullRequestReviewRequested',\n  'pullRequestMerged',\n  'pullRequestClosed',\n] as const;\nexport type FactoryGithubEventName = (typeof FACTORY_GITHUB_EVENTS)[number];\n\nexport const FACTORY_LINEAR_EVENTS = ['issueObserved'] as const;\nexport type FactoryLinearEventName = (typeof FACTORY_LINEAR_EVENTS)[number];\n\nexport type FactoryRuleJsonValue =\n  | null\n  | boolean\n  | number\n  | string\n  | FactoryRuleJsonValue[]\n  | { [key: string]: FactoryRuleJsonValue };\n\nexport interface FactoryRuleItemContext {\n  id: string;\n  source: WorkItemSource;\n  sourceKey: string | null;\n  parentWorkItemId: string | null;\n  title: string;\n  url: string | null;\n  stages: readonly string[];\n}\n\nexport type FactoryRuleActor =\n  | { type: 'human'; id: string }\n  | { type: 'agent'; bindingId: string; role: string }\n  | { type: 'github'; login: string; trusted: boolean; factoryAuthored: boolean }\n  | { type: 'system'; id: string };\n\nexport interface FactoryRuleIngressIdentity {\n  type: 'human' | 'agent' | 'toolResult' | 'github' | 'linear' | 'rule';\n  id: string;\n}\n\nexport interface FactoryRuleCausalEntry {\n  ingressId: string;\n  decisionType: FactoryCommitDecision['type'];\n}\n\nexport interface FactoryRuleContextBase {\n  tenant: { orgId: string; projectId: string };\n  actor: FactoryRuleActor;\n  ingress: FactoryRuleIngressIdentity;\n  cause: string;\n  causalChain: readonly FactoryRuleCausalEntry[];\n  ruleSetVersion: string;\n}\n\nexport interface FactoryBoundRuleContext extends FactoryRuleContextBase {\n  item: FactoryRuleItemContext;\n  board: FactoryRuleBoard;\n  itemRevision: number;\n}\n\nexport interface FactoryStageRuleContext extends FactoryBoundRuleContext {\n  source: FactoryRuleSource;\n  stage: FactoryRuleStage;\n  fromStage: FactoryRuleStage;\n  toStage: FactoryRuleStage;\n}\n\nexport interface FactoryToolResultRuleContext extends FactoryBoundRuleContext {\n  toolName: string;\n  threadId: string;\n  assistantMessageId: string;\n  toolCallId: string;\n  result: {\n    status: 'success' | 'error';\n    value: FactoryRuleJsonValue;\n  };\n}\n\nexport interface FactoryGithubRuleContext extends FactoryRuleContextBase {\n  item?: FactoryRuleItemContext;\n  board?: FactoryRuleBoard;\n  itemRevision?: number;\n  event: FactoryGithubEventName;\n  deliveryId: string;\n  factory: { createdAt: string };\n  repository: { id: number; fullName: string };\n  issue?: { number: number; title: string; url: string; createdAt?: string };\n  pullRequest?: {\n    number: number;\n    title: string;\n    url: string;\n    createdAt?: string;\n    state: 'open' | 'closed';\n    merged: boolean;\n    headBranch: string;\n    baseBranch: string;\n  };\n}\n\nexport interface FactoryLinearRuleContext extends FactoryRuleContextBase {\n  item?: FactoryRuleItemContext;\n  board?: FactoryRuleBoard;\n  itemRevision?: number;\n  event: FactoryLinearEventName;\n  issue: {\n    id: string;\n    identifier: string;\n    title: string;\n    url: string;\n    state: string;\n    stateType: string;\n    priorityLabel: string;\n    assignee: string | null;\n    team: string | null;\n    labels: readonly string[];\n    createdAt: string;\n    updatedAt: string;\n  };\n}\n\nexport type FactoryRuleHandler<TContext> = (\n  context: Readonly<TContext>,\n) => FactoryRuleDecision | void | Promise<FactoryRuleDecision | void>;\n\nexport interface FactoryBoardRuleLeaf {\n  onEnter?: FactoryRuleHandler<FactoryStageRuleContext>;\n  onExit?: FactoryRuleHandler<FactoryStageRuleContext>;\n}\n\nexport interface FactoryToolRuleLeaf {\n  onResult?: FactoryRuleHandler<FactoryToolResultRuleContext>;\n}\n\nexport interface FactoryGithubRuleLeaf {\n  onEvent?: FactoryRuleHandler<FactoryGithubRuleContext>;\n}\n\nexport interface FactoryLinearRuleLeaf {\n  onEvent?: FactoryRuleHandler<FactoryLinearRuleContext>;\n}\n\nexport type FactoryBoardRules = Partial<\n  Record<FactoryRuleStage, Partial<Record<FactoryRuleSource, FactoryBoardRuleLeaf>>>\n>;\n\nexport interface FactoryRules {\n  version: string;\n  work: FactoryBoardRules;\n  review: FactoryBoardRules;\n  tools: Record<string, FactoryToolRuleLeaf>;\n  github: Partial<Record<FactoryGithubEventName, FactoryGithubRuleLeaf>>;\n  linear: Partial<Record<FactoryLinearEventName, FactoryLinearRuleLeaf>>;\n}\n\nexport interface FactoryRulesOverrides {\n  work?: FactoryBoardRules;\n  review?: FactoryBoardRules;\n  tools?: Record<string, FactoryToolRuleLeaf>;\n  github?: Partial<Record<FactoryGithubEventName, FactoryGithubRuleLeaf>>;\n  linear?: Partial<Record<FactoryLinearEventName, FactoryLinearRuleLeaf>>;\n}\n\nexport type FactoryRuleRejectionCode =\n  | 'forbidden'\n  | 'invalid_transition'\n  | 'missing_binding'\n  | 'stale'\n  | 'timeout'\n  | 'rule_error'\n  | 'causal_depth_exceeded'\n  | 'repeated_transition';\n\nexport interface FactoryRuleRejectDecision {\n  type: 'reject';\n  code: FactoryRuleRejectionCode;\n  reason: string;\n}\n\ninterface FactoryCommitDecisionBase {\n  idempotencyKey: string;\n}\n\nexport interface FactoryTransitionDecision extends FactoryCommitDecisionBase {\n  type: 'transition';\n  board: FactoryRuleBoard;\n  stage: FactoryRuleStage;\n  /**\n   * Delivered to the item's active session (waking it if idle) after the\n   * transition commits. Skipped when the item has no active run binding, so\n   * informational messages never fail the transition.\n   */\n  message?: { text: string; role?: string };\n}\n\nexport interface FactoryUpsertLinkedWorkItemDecision extends FactoryCommitDecisionBase {\n  type: 'upsertLinkedWorkItem';\n  board: FactoryRuleBoard;\n  source: WorkItemSource;\n  sourceKey: string;\n  title: string;\n  url: string | null;\n  stage: FactoryRuleStage;\n  metadata?: Record<string, FactoryRuleJsonValue>;\n}\n\nexport interface FactoryInvokeSkillDecision extends FactoryCommitDecisionBase {\n  type: 'invokeSkill';\n  role: string;\n  skillName: string;\n  arguments?: string;\n  precedingMessage?: string;\n}\n\nexport interface FactorySendMessageDecision extends FactoryCommitDecisionBase {\n  type: 'sendMessage';\n  role: string;\n  message: string;\n  priority?: 'medium' | 'high' | 'urgent';\n  idleBehavior?: 'persist' | 'wake';\n  prepareBinding?: boolean;\n}\n\nexport interface FactoryNotifyDecision extends FactoryCommitDecisionBase {\n  type: 'notify';\n  title: string;\n  body?: string;\n  level?: 'info' | 'warning' | 'error';\n}\n\nexport type FactoryCommitDecision =\n  | FactoryTransitionDecision\n  | FactoryUpsertLinkedWorkItemDecision\n  | FactoryInvokeSkillDecision\n  | FactorySendMessageDecision\n  | FactoryNotifyDecision;\n\nexport type FactoryRuleDecision = FactoryRuleRejectDecision | FactoryCommitDecision;\n\nexport interface FactoryTransitionResultAccepted {\n  status: 'accepted';\n  transitionId: string;\n  itemId: string;\n  revision: number;\n  stage: FactoryRuleStage;\n  decisions: FactoryCommitDecision[];\n}\n\nexport interface FactoryTransitionResultRejected {\n  status: 'rejected';\n  transitionId: string;\n  itemId: string;\n  code: FactoryRuleRejectionCode;\n  reason: string;\n}\n\nexport type FactoryTransitionResult = FactoryTransitionResultAccepted | FactoryTransitionResultRejected;\n\nexport function factoryRuleSourceForWorkItem(source: WorkItemSource): FactoryRuleSource {\n  switch (source) {\n    case 'github-issue':\n      return 'issue';\n    case 'github-pr':\n      return 'pullRequest';\n    case 'linear-issue':\n      return 'linearIssue';\n    case 'manual':\n      return 'manual';\n  }\n}\n"],"mappings":";AAEA,MAAa,sBAAsB;CAAC;CAAU;CAAU;CAAY;CAAW;CAAU;CAAQ;AAAU;AAG3G,MAAa,sBAAsB,CAAC,QAAQ,QAAQ;AAGpD,MAAa,uBAAuB;CAAC;CAAS;CAAe;CAAe;AAAQ;AAGpF,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,wBAAwB,CAAC,eAAe;AAyPrD,SAAgB,6BAA6B,QAA2C;CACtF,QAAQ,QAAR;EACE,KAAK,gBACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,UACH,OAAO;CACX;AACF"}

package/dist/rules/validation.d.ts

@@ -0,0 +1,11 @@
+import type { FactoryCommitDecision, FactoryRuleDecision, FactoryRuleJsonValue, FactoryRules } from './types.js';
+export declare const MAX_FACTORY_RULE_CAUSAL_DEPTH = 8;
+export declare class FactoryRuleValidationError extends Error {
+    readonly code = "invalid_factory_rule";
+    constructor(message: string);
+}
+export declare function normalizeFactoryRuleJsonValue(value: unknown, depth?: number, seen?: Set<object>): FactoryRuleJsonValue;
+export declare function assertFactoryRules(rules: unknown): asserts rules is FactoryRules;
+export declare function validateFactoryRuleDecision(value: unknown, causalDepth?: number): FactoryRuleDecision;
+export declare function validateFactoryRuleDecisions(values: readonly unknown[], causalDepth?: number): FactoryCommitDecision[];
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/rules/validation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,6BAA6B,IAAI,CAAC;AA+B/C,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,0BAA0B;gBAE3B,OAAO,EAAE,MAAM;CAI5B;AAoCD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,KAAK,SAAI,EACT,IAAI,cAAoB,GACvB,oBAAoB,CAkCtB;AA8BD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAqChF;AAQD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAAI,GAAG,mBAAmB,CAmIhG;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,WAAW,SAAI,GAAG,qBAAqB,EAAE,CAiBjH"}

package/dist/rules/validation.js

@@ -0,0 +1,308 @@
+import { FACTORY_GITHUB_EVENTS, FACTORY_LINEAR_EVENTS, FACTORY_RULE_BOARDS, FACTORY_RULE_SOURCES, FACTORY_RULE_STAGES } from "./types.js";
+//#region src/rules/validation.ts
+const MAX_FACTORY_RULE_CAUSAL_DEPTH = 8;
+const MAX_VERSION_LENGTH = 128;
+const MAX_IDEMPOTENCY_KEY_LENGTH = 256;
+const MAX_REASON_LENGTH = 512;
+const MAX_TITLE_LENGTH = 512;
+const MAX_MESSAGE_LENGTH = 8192;
+const MAX_ARGUMENTS_LENGTH = 4096;
+const MAX_ROLE_LENGTH = 32;
+const MAX_SKILL_NAME_LENGTH = 128;
+const MAX_SOURCE_KEY_LENGTH = 256;
+const MAX_URL_LENGTH = 2048;
+const MAX_METADATA_JSON_LENGTH = 16384;
+const MAX_JSON_DEPTH = 8;
+const MAX_JSON_COLLECTION_SIZE = 100;
+const IDENTIFIER_RE = /^[a-z0-9][a-z0-9_-]*$/i;
+const SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const SENSITIVE_KEY_RE = /(?:authorization|cookie|credential|password|secret|token)/i;
+const WORK_ITEM_SOURCES = [
+	"github-issue",
+	"github-pr",
+	"linear-issue",
+	"manual"
+];
+const REJECTION_CODES = [
+	"forbidden",
+	"invalid_transition",
+	"missing_binding",
+	"stale",
+	"timeout",
+	"rule_error",
+	"causal_depth_exceeded",
+	"repeated_transition"
+];
+var FactoryRuleValidationError = class extends Error {
+	code = "invalid_factory_rule";
+	constructor(message) {
+		super(message);
+		this.name = "FactoryRuleValidationError";
+	}
+};
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+function assertExactKeys(value, keys, label) {
+	const allowed = new Set(keys);
+	if (Object.keys(value).some((key) => !allowed.has(key))) throw new FactoryRuleValidationError(`${label} contains an unsupported field.`);
+}
+function boundedString(value, label, max, pattern) {
+	if (typeof value !== "string") throw new FactoryRuleValidationError(`${label} must be a string.`);
+	const normalized = value.trim();
+	if (normalized.length === 0 || normalized.length > max || pattern && !pattern.test(normalized)) throw new FactoryRuleValidationError(`${label} is invalid.`);
+	return normalized;
+}
+function optionalBoundedString(value, label, max) {
+	if (value === void 0) return void 0;
+	return boundedString(value, label, max);
+}
+function enumValue(value, allowed, label) {
+	if (typeof value !== "string" || !allowed.includes(value)) throw new FactoryRuleValidationError(`${label} is invalid.`);
+	return value;
+}
+function normalizeFactoryRuleJsonValue(value, depth = 0, seen = /* @__PURE__ */ new Set()) {
+	if (value === null || typeof value === "boolean" || typeof value === "string") return value;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw new FactoryRuleValidationError("Rule metadata must contain finite numbers.");
+		return value;
+	}
+	if (depth >= MAX_JSON_DEPTH || typeof value !== "object" && !Array.isArray(value)) throw new FactoryRuleValidationError("Rule metadata is not bounded JSON.");
+	if (seen.has(value)) throw new FactoryRuleValidationError("Rule metadata must not contain cycles.");
+	seen.add(value);
+	try {
+		if (Array.isArray(value)) {
+			if (value.length > MAX_JSON_COLLECTION_SIZE) throw new FactoryRuleValidationError("Rule metadata contains too many entries.");
+			return value.map((entry) => normalizeFactoryRuleJsonValue(entry, depth + 1, seen));
+		}
+		if (!isPlainObject(value)) throw new FactoryRuleValidationError("Rule metadata must use plain objects.");
+		const entries = Object.entries(value);
+		if (entries.length > MAX_JSON_COLLECTION_SIZE) throw new FactoryRuleValidationError("Rule metadata contains too many fields.");
+		const sanitized = {};
+		for (const [key, entry] of entries) {
+			const normalizedKey = boundedString(key, "Rule metadata key", 128, IDENTIFIER_RE);
+			sanitized[normalizedKey] = SENSITIVE_KEY_RE.test(normalizedKey) ? "[REDACTED]" : normalizeFactoryRuleJsonValue(entry, depth + 1, seen);
+		}
+		return sanitized;
+	} finally {
+		seen.delete(value);
+	}
+}
+function sanitizeMetadata(value) {
+	if (value === void 0) return void 0;
+	const sanitized = normalizeFactoryRuleJsonValue(value);
+	if (!isPlainObject(sanitized)) throw new FactoryRuleValidationError("Rule metadata must be an object.");
+	if (JSON.stringify(sanitized).length > MAX_METADATA_JSON_LENGTH) throw new FactoryRuleValidationError("Rule metadata is too large.");
+	return sanitized;
+}
+function validateBoardRules(rules, label) {
+	if (!isPlainObject(rules)) throw new FactoryRuleValidationError(`${label} must be an object.`);
+	for (const [stage, sources] of Object.entries(rules)) {
+		enumValue(stage, FACTORY_RULE_STAGES, `${label} stage`);
+		if (!isPlainObject(sources)) throw new FactoryRuleValidationError(`${label}.${stage} must be an object.`);
+		for (const [source, leaf] of Object.entries(sources)) {
+			enumValue(source, FACTORY_RULE_SOURCES, `${label}.${stage} source`);
+			if (!isPlainObject(leaf)) throw new FactoryRuleValidationError(`${label}.${stage}.${source} must be an object.`);
+			assertExactKeys(leaf, ["onEnter", "onExit"], `${label}.${stage}.${source}`);
+			for (const handler of Object.values(leaf)) if (handler !== void 0 && typeof handler !== "function") throw new FactoryRuleValidationError(`${label}.${stage}.${source} handlers must be functions.`);
+		}
+	}
+}
+function assertFactoryRules(rules) {
+	if (!isPlainObject(rules)) throw new FactoryRuleValidationError("Factory rules must be an object.");
+	assertExactKeys(rules, [
+		"version",
+		"work",
+		"review",
+		"tools",
+		"github",
+		"linear"
+	], "Factory rules");
+	boundedString(rules.version, "Factory rule version", MAX_VERSION_LENGTH);
+	validateBoardRules(rules.work, "Factory rules.work");
+	validateBoardRules(rules.review, "Factory rules.review");
+	if (!isPlainObject(rules.tools)) throw new FactoryRuleValidationError("Factory rules.tools must be an object.");
+	for (const [toolName, leaf] of Object.entries(rules.tools)) {
+		boundedString(toolName, "Factory tool name", 128, IDENTIFIER_RE);
+		if (!isPlainObject(leaf)) throw new FactoryRuleValidationError(`Factory rules.tools.${toolName} must be an object.`);
+		assertExactKeys(leaf, ["onResult"], `Factory rules.tools.${toolName}`);
+		if (leaf.onResult !== void 0 && typeof leaf.onResult !== "function") throw new FactoryRuleValidationError(`Factory rules.tools.${toolName}.onResult must be a function.`);
+	}
+	if (!isPlainObject(rules.github)) throw new FactoryRuleValidationError("Factory rules.github must be an object.");
+	for (const [event, leaf] of Object.entries(rules.github)) {
+		enumValue(event, FACTORY_GITHUB_EVENTS, "Factory GitHub event");
+		if (!isPlainObject(leaf)) throw new FactoryRuleValidationError(`Factory rules.github.${event} must be an object.`);
+		assertExactKeys(leaf, ["onEvent"], `Factory rules.github.${event}`);
+		if (leaf.onEvent !== void 0 && typeof leaf.onEvent !== "function") throw new FactoryRuleValidationError(`Factory rules.github.${event}.onEvent must be a function.`);
+	}
+	if (!isPlainObject(rules.linear)) throw new FactoryRuleValidationError("Factory rules.linear must be an object.");
+	for (const [event, leaf] of Object.entries(rules.linear)) {
+		enumValue(event, FACTORY_LINEAR_EVENTS, "Factory Linear event");
+		if (!isPlainObject(leaf)) throw new FactoryRuleValidationError(`Factory rules.linear.${event} must be an object.`);
+		assertExactKeys(leaf, ["onEvent"], `Factory rules.linear.${event}`);
+		if (leaf.onEvent !== void 0 && typeof leaf.onEvent !== "function") throw new FactoryRuleValidationError(`Factory rules.linear.${event}.onEvent must be a function.`);
+	}
+}
+function commonCommitFields(value) {
+	return { idempotencyKey: boundedString(value.idempotencyKey, "Factory decision idempotencyKey", MAX_IDEMPOTENCY_KEY_LENGTH) };
+}
+function validateFactoryRuleDecision(value, causalDepth = 0) {
+	if (causalDepth > 8) throw new FactoryRuleValidationError("Factory rule causal depth exceeded.");
+	if (!isPlainObject(value)) throw new FactoryRuleValidationError("Factory rule decision must be an object.");
+	const type = value.type;
+	if (typeof type !== "string") throw new FactoryRuleValidationError("Factory rule decision type is required.");
+	switch (type) {
+		case "reject":
+			assertExactKeys(value, [
+				"type",
+				"code",
+				"reason"
+			], "Factory reject decision");
+			return {
+				type,
+				code: enumValue(value.code, REJECTION_CODES, "Factory rejection code"),
+				reason: boundedString(value.reason, "Factory rejection reason", MAX_REASON_LENGTH)
+			};
+		case "transition": {
+			assertExactKeys(value, [
+				"type",
+				"idempotencyKey",
+				"board",
+				"stage",
+				"message"
+			], "Factory transition decision");
+			let message;
+			if (value.message !== void 0) {
+				if (!isPlainObject(value.message)) throw new FactoryRuleValidationError("Factory transition message must be an object.");
+				assertExactKeys(value.message, ["text", "role"], "Factory transition message");
+				const role = value.message.role === void 0 ? void 0 : boundedString(value.message.role, "Factory transition message role", MAX_ROLE_LENGTH, IDENTIFIER_RE);
+				message = {
+					text: boundedString(value.message.text, "Factory transition message text", MAX_MESSAGE_LENGTH),
+					...role ? { role } : {}
+				};
+			}
+			return {
+				type,
+				...commonCommitFields(value),
+				board: enumValue(value.board, FACTORY_RULE_BOARDS, "Factory transition board"),
+				stage: enumValue(value.stage, FACTORY_RULE_STAGES, "Factory transition stage"),
+				...message ? { message } : {}
+			};
+		}
+		case "upsertLinkedWorkItem": {
+			assertExactKeys(value, [
+				"type",
+				"idempotencyKey",
+				"board",
+				"source",
+				"sourceKey",
+				"title",
+				"url",
+				"stage",
+				"metadata"
+			], "Factory linked work item decision");
+			const url = value.url;
+			if (url !== null && (typeof url !== "string" || url.length > MAX_URL_LENGTH || !/^https?:\/\//.test(url))) throw new FactoryRuleValidationError("Factory linked work item URL is invalid.");
+			const metadata = sanitizeMetadata(value.metadata);
+			return {
+				type,
+				...commonCommitFields(value),
+				board: enumValue(value.board, FACTORY_RULE_BOARDS, "Factory linked work item board"),
+				source: enumValue(value.source, WORK_ITEM_SOURCES, "Factory linked work item source"),
+				sourceKey: boundedString(value.sourceKey, "Factory linked work item sourceKey", MAX_SOURCE_KEY_LENGTH),
+				title: boundedString(value.title, "Factory linked work item title", MAX_TITLE_LENGTH),
+				url,
+				stage: enumValue(value.stage, FACTORY_RULE_STAGES, "Factory linked work item stage"),
+				...metadata ? { metadata } : {}
+			};
+		}
+		case "invokeSkill": {
+			assertExactKeys(value, [
+				"type",
+				"idempotencyKey",
+				"role",
+				"skillName",
+				"arguments",
+				"precedingMessage"
+			], "Factory invoke skill decision");
+			const args = optionalBoundedString(value.arguments, "Factory skill arguments", MAX_ARGUMENTS_LENGTH);
+			const precedingMessage = optionalBoundedString(value.precedingMessage, "Factory skill preceding message", MAX_MESSAGE_LENGTH);
+			return {
+				type,
+				...commonCommitFields(value),
+				role: boundedString(value.role, "Factory skill role", MAX_ROLE_LENGTH, IDENTIFIER_RE),
+				skillName: boundedString(value.skillName, "Factory skill name", MAX_SKILL_NAME_LENGTH, SKILL_NAME_RE),
+				...args ? { arguments: args } : {},
+				...precedingMessage ? { precedingMessage } : {}
+			};
+		}
+		case "sendMessage": {
+			assertExactKeys(value, [
+				"type",
+				"idempotencyKey",
+				"role",
+				"message",
+				"priority",
+				"idleBehavior",
+				"prepareBinding"
+			], "Factory send message decision");
+			const priority = value.priority === void 0 ? void 0 : enumValue(value.priority, [
+				"medium",
+				"high",
+				"urgent"
+			], "Factory message priority");
+			const idleBehavior = value.idleBehavior === void 0 ? void 0 : enumValue(value.idleBehavior, ["persist", "wake"], "Factory message idle behavior");
+			if (value.prepareBinding !== void 0 && typeof value.prepareBinding !== "boolean") throw new FactoryRuleValidationError("Factory message prepareBinding must be a boolean.");
+			return {
+				type,
+				...commonCommitFields(value),
+				role: boundedString(value.role, "Factory message role", MAX_ROLE_LENGTH, IDENTIFIER_RE),
+				message: boundedString(value.message, "Factory message", MAX_MESSAGE_LENGTH),
+				...priority ? { priority } : {},
+				...idleBehavior ? { idleBehavior } : {},
+				...value.prepareBinding === true ? { prepareBinding: true } : {}
+			};
+		}
+		case "notify": {
+			assertExactKeys(value, [
+				"type",
+				"idempotencyKey",
+				"title",
+				"body",
+				"level"
+			], "Factory notify decision");
+			const body = optionalBoundedString(value.body, "Factory notification body", MAX_MESSAGE_LENGTH);
+			const level = value.level === void 0 ? void 0 : enumValue(value.level, [
+				"info",
+				"warning",
+				"error"
+			], "Factory notification level");
+			return {
+				type,
+				...commonCommitFields(value),
+				title: boundedString(value.title, "Factory notification title", MAX_TITLE_LENGTH),
+				...body ? { body } : {},
+				...level ? { level } : {}
+			};
+		}
+		default: throw new FactoryRuleValidationError("Factory rule decision type is unsupported.");
+	}
+}
+function validateFactoryRuleDecisions(values, causalDepth = 0) {
+	if (values.length > MAX_JSON_COLLECTION_SIZE) throw new FactoryRuleValidationError("Factory rule produced too many decisions.");
+	const decisions = [];
+	for (const value of values) {
+		const decision = validateFactoryRuleDecision(value, causalDepth);
+		if (decision.type === "reject") throw new FactoryRuleValidationError("A rejection cannot be persisted with commit decisions.");
+		decisions.push(decision);
+	}
+	const keys = decisions.map((decision) => decision.idempotencyKey);
+	if (new Set(keys).size !== keys.length) throw new FactoryRuleValidationError("Factory decisions require unique idempotency keys.");
+	return decisions;
+}
+//#endregion
+export { FactoryRuleValidationError, MAX_FACTORY_RULE_CAUSAL_DEPTH, assertFactoryRules, normalizeFactoryRuleJsonValue, validateFactoryRuleDecision, validateFactoryRuleDecisions };
+
+//# sourceMappingURL=validation.js.map