@mastra/factory 0.13.0-alpha.6 → 0.13.0-alpha.7

package/README.md

@@ -29,6 +29,41 @@ A host application calls `MastraFactory.prepare()`, constructs its `Mastra` inst
 
 `prepare()` initializes the Factory-owned resources needed before Mastra is constructed. `finalize()` connects those resources to the completed host, including Factory routes, integrations, storage-backed behavior, and agent-controller features. Consumers should keep frontend concerns in `factory-ui` and host-specific environment or deployment wiring in `web` rather than adding them to this package.
 
+### GitHub event rules
+
+Both `GithubIntegration` and `PlatformGithubIntegration` own their GitHub event handlers. Existing installations retain the defaults without additional configuration.
+
+```typescript
+import { PlatformGithubIntegration } from '@mastra/factory/integrations/platform/github/integration';
+
+const github = new PlatformGithubIntegration({
+  rules: {
+    issueOpened: context => ({
+      type: 'reject',
+      code: 'manual_intake',
+      reason: 'This deployment manages issue intake manually.',
+    }),
+    issueCommentCreated: null,
+  },
+});
+```
+
+Pass the integration in `MastraFactory`'s `integrations` array. The direct `GithubIntegration` accepts the same `rules` option alongside its GitHub App credentials. A function replaces one default handler without composing with it. `null` disables that event's handler, not authentication, webhook ingestion, or reconciliation bookkeeping. Omitted events and `undefined` retain their defaults. Each instance copies and freezes its resolved handler map; unknown event names and invalid handler values are rejected during construction.
+
+**Migration:** Move each global `rules.github[event].onEvent` value to the integration constructor's `rules[event]` option:
+
+```typescript
+// Before: global Factory rule overrides
+const overrides = { github: { issueCommentCreated: { onEvent: null } } };
+
+// After: GitHub integration constructor options
+const github = new PlatformGithubIntegration({ rules: { issueCommentCreated: null } });
+```
+
+Work, Review, tool, and Linear configuration remain unchanged. The global rule version remains shared audit metadata, including for GitHub evaluations; it is not a hash of custom handler code and does not change delivery replay semantics. Update the deployment-owned version when changing handler behavior.
+
+Handlers receive the existing typed GitHub context and return one decision or `undefined`. External titles, bodies, and comments remain untrusted data after webhook authentication. Custom handlers must preserve any required actor-permission checks explicitly.
+
 ### GitHub review commands
 
 A repository maintainer with write or admin access can start a Factory review from a pull-request comment by posting the exact first-line command:

package/dist/boards/index.d.ts

@@ -1,10 +1,11 @@
-import type { FactoryRuleBoard } from '../rules/types.js';
 export { BoardDefinitionError, defineBoard } from './define-board.js';
 export type { BoardDefinition, BoardPhaseDefinition, BoardTransition } from './define-board.js';
+export { createBoardRegistry, defaultBoards } from './registry.js';
+export type { BoardRegistry, InstalledBoard } from './registry.js';
 export { reviewBoard } from './review.js';
 export type { ReviewBoardPhase } from './review.js';
 export { workBoard } from './work.js';
 export type { WorkBoardPhase } from './work.js';
-export declare function builtInBoard(board: FactoryRuleBoard): import("./define-board.js").BoardDefinition<"review", "intake" | "review" | "done" | "canceled"> | import("./define-board.js").BoardDefinition<"work", "intake" | "triage" | "planning" | "execute" | "review" | "done" | "canceled">;
-export declare function allowsBuiltInBoardTransition(board: FactoryRuleBoard, from: string, to: string): boolean;
+export declare function builtInBoard(board: 'work' | 'review'): import("./define-board.js").BoardDefinition<"review", "intake" | "review" | "done" | "canceled"> | import("./define-board.js").BoardDefinition<"work", "intake" | "triage" | "planning" | "execute" | "review" | "done" | "canceled">;
+export declare function allowsBuiltInBoardTransition(board: 'work' | 'review', from: string, to: string): boolean;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boards/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,yOAEnD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKvG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAInE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,yOAEpD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKxG"}

package/dist/boards/index.js

@@ -1,6 +1,7 @@
 import { BoardDefinitionError, defineBoard } from "./define-board.js";
 import { isReviewBoardPhase, reviewBoard } from "./review.js";
 import { isWorkBoardPhase, workBoard } from "./work.js";
+import { createBoardRegistry, defaultBoards } from "./registry.js";
 //#region src/boards/index.ts
 const builtInBoards = {
 	work: workBoard,
@@ -14,6 +15,6 @@ function allowsBuiltInBoardTransition(board, from, to) {
 	return isReviewBoardPhase(from) && isReviewBoardPhase(to) && reviewBoard.allowsTransition(from, to);
 }
 //#endregion
-export { BoardDefinitionError, allowsBuiltInBoardTransition, builtInBoard, defineBoard, reviewBoard, workBoard };
+export { BoardDefinitionError, allowsBuiltInBoardTransition, builtInBoard, createBoardRegistry, defaultBoards, defineBoard, reviewBoard, workBoard };
 
 //# sourceMappingURL=index.js.map

package/dist/boards/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/boards/index.ts"],"sourcesContent":["import type { FactoryRuleBoard } from '../rules/types.js';\nimport { isReviewBoardPhase, reviewBoard } from './review.js';\nimport { isWorkBoardPhase, workBoard } from './work.js';\n\nexport { BoardDefinitionError, defineBoard } from './define-board.js';\nexport type { BoardDefinition, BoardPhaseDefinition, BoardTransition } from './define-board.js';\nexport { reviewBoard } from './review.js';\nexport type { ReviewBoardPhase } from './review.js';\nexport { workBoard } from './work.js';\nexport type { WorkBoardPhase } from './work.js';\n\nconst builtInBoards = { work: workBoard, review: reviewBoard } as const;\n\nexport function builtInBoard(board: FactoryRuleBoard) {\n  return builtInBoards[board];\n}\n\nexport function allowsBuiltInBoardTransition(board: FactoryRuleBoard, from: string, to: string): boolean {\n  if (board === 'work') {\n    return isWorkBoardPhase(from) && isWorkBoardPhase(to) && workBoard.allowsTransition(from, to);\n  }\n  return isReviewBoardPhase(from) && isReviewBoardPhase(to) && reviewBoard.allowsTransition(from, to);\n}\n"],"mappings":";;;;AAWA,MAAM,gBAAgB;CAAE,MAAM;CAAW,QAAQ;AAAY;AAE7D,SAAgB,aAAa,OAAyB;CACpD,OAAO,cAAc;AACvB;AAEA,SAAgB,6BAA6B,OAAyB,MAAc,IAAqB;CACvG,IAAI,UAAU,QACZ,OAAO,iBAAiB,IAAI,KAAK,iBAAiB,EAAE,KAAK,UAAU,iBAAiB,MAAM,EAAE;CAE9F,OAAO,mBAAmB,IAAI,KAAK,mBAAmB,EAAE,KAAK,YAAY,iBAAiB,MAAM,EAAE;AACpG"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/boards/index.ts"],"sourcesContent":["export { BoardDefinitionError, defineBoard } from './define-board.js';\nexport type { BoardDefinition, BoardPhaseDefinition, BoardTransition } from './define-board.js';\nexport { createBoardRegistry, defaultBoards } from './registry.js';\nexport type { BoardRegistry, InstalledBoard } from './registry.js';\nimport { isReviewBoardPhase, reviewBoard } from './review.js';\nimport { isWorkBoardPhase, workBoard } from './work.js';\n\nexport { reviewBoard } from './review.js';\nexport type { ReviewBoardPhase } from './review.js';\nexport { workBoard } from './work.js';\nexport type { WorkBoardPhase } from './work.js';\n\nconst builtInBoards = { work: workBoard, review: reviewBoard } as const;\n\nexport function builtInBoard(board: 'work' | 'review') {\n  return builtInBoards[board];\n}\n\nexport function allowsBuiltInBoardTransition(board: 'work' | 'review', from: string, to: string): boolean {\n  if (board === 'work') {\n    return isWorkBoardPhase(from) && isWorkBoardPhase(to) && workBoard.allowsTransition(from, to);\n  }\n  return isReviewBoardPhase(from) && isReviewBoardPhase(to) && reviewBoard.allowsTransition(from, to);\n}\n"],"mappings":";;;;;AAYA,MAAM,gBAAgB;CAAE,MAAM;CAAW,QAAQ;AAAY;AAE7D,SAAgB,aAAa,OAA0B;CACrD,OAAO,cAAc;AACvB;AAEA,SAAgB,6BAA6B,OAA0B,MAAc,IAAqB;CACxG,IAAI,UAAU,QACZ,OAAO,iBAAiB,IAAI,KAAK,iBAAiB,EAAE,KAAK,UAAU,iBAAiB,MAAM,EAAE;CAE9F,OAAO,mBAAmB,IAAI,KAAK,mBAAmB,EAAE,KAAK,YAAY,iBAAiB,MAAM,EAAE;AACpG"}

package/dist/boards/registry.d.ts

@@ -0,0 +1,16 @@
+import type { BoardDefinition } from './define-board.js';
+export type InstalledBoard = BoardDefinition<string, string>;
+export interface BoardRegistry extends Iterable<[string, InstalledBoard]> {
+    readonly size: number;
+    get(id: string): InstalledBoard | undefined;
+    has(id: string): boolean;
+    keys(): MapIterator<string>;
+    values(): MapIterator<InstalledBoard>;
+    entries(): MapIterator<[string, InstalledBoard]>;
+}
+export declare const defaultBoards: readonly InstalledBoard[];
+export declare function createBoardRegistry(options?: {
+    boards?: readonly InstalledBoard[];
+    includeDefaultBoards?: boolean;
+}): BoardRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/boards/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7D,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;IACtC,OAAO,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,aAAa,EAA8C,SAAS,cAAc,EAAE,CAAC;AAGlG,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC3B,GACL,aAAa,CA0Bf"}

package/dist/boards/registry.js

@@ -0,0 +1,27 @@
+import { reviewBoard } from "./review.js";
+import { workBoard } from "./work.js";
+//#region src/boards/registry.ts
+const defaultBoards = Object.freeze([workBoard, reviewBoard]);
+const reservedBoardIds = new Set(defaultBoards.map((board) => board.id));
+function createBoardRegistry(options = {}) {
+	const installed = options.includeDefaultBoards === false ? [] : defaultBoards;
+	const registry = /* @__PURE__ */ new Map();
+	for (const board of options.boards ?? []) if (reservedBoardIds.has(board.id)) throw new Error(`MastraFactory: board id '${board.id}' is reserved for a built-in board.`);
+	for (const board of [...installed, ...options.boards ?? []]) {
+		if (registry.has(board.id)) throw new Error(`MastraFactory: duplicate board id '${board.id}' in 'boards'.`);
+		registry.set(board.id, board);
+	}
+	return Object.freeze({
+		size: registry.size,
+		get: registry.get.bind(registry),
+		has: registry.has.bind(registry),
+		keys: registry.keys.bind(registry),
+		values: registry.values.bind(registry),
+		entries: registry.entries.bind(registry),
+		[Symbol.iterator]: registry[Symbol.iterator].bind(registry)
+	});
+}
+//#endregion
+export { createBoardRegistry, defaultBoards };
+
+//# sourceMappingURL=registry.js.map

package/dist/boards/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/boards/registry.ts"],"sourcesContent":["import type { BoardDefinition } from './define-board.js';\nimport { reviewBoard } from './review.js';\nimport { workBoard } from './work.js';\n\nexport type InstalledBoard = BoardDefinition<string, string>;\nexport interface BoardRegistry extends Iterable<[string, InstalledBoard]> {\n  readonly size: number;\n  get(id: string): InstalledBoard | undefined;\n  has(id: string): boolean;\n  keys(): MapIterator<string>;\n  values(): MapIterator<InstalledBoard>;\n  entries(): MapIterator<[string, InstalledBoard]>;\n}\n\nexport const defaultBoards = Object.freeze([workBoard, reviewBoard]) as readonly InstalledBoard[];\nconst reservedBoardIds = new Set(defaultBoards.map(board => board.id));\n\nexport function createBoardRegistry(\n  options: {\n    boards?: readonly InstalledBoard[];\n    includeDefaultBoards?: boolean;\n  } = {},\n): BoardRegistry {\n  const installed = options.includeDefaultBoards === false ? [] : defaultBoards;\n  const registry = new Map<string, InstalledBoard>();\n\n  for (const board of options.boards ?? []) {\n    if (reservedBoardIds.has(board.id)) {\n      throw new Error(`MastraFactory: board id '${board.id}' is reserved for a built-in board.`);\n    }\n  }\n\n  for (const board of [...installed, ...(options.boards ?? [])]) {\n    if (registry.has(board.id)) {\n      throw new Error(`MastraFactory: duplicate board id '${board.id}' in 'boards'.`);\n    }\n    registry.set(board.id, board);\n  }\n\n  return Object.freeze({\n    size: registry.size,\n    get: registry.get.bind(registry),\n    has: registry.has.bind(registry),\n    keys: registry.keys.bind(registry),\n    values: registry.values.bind(registry),\n    entries: registry.entries.bind(registry),\n    [Symbol.iterator]: registry[Symbol.iterator].bind(registry),\n  });\n}\n"],"mappings":";;;AAcA,MAAa,gBAAgB,OAAO,OAAO,CAAC,WAAW,WAAW,CAAC;AACnE,MAAM,mBAAmB,IAAI,IAAI,cAAc,KAAI,UAAS,MAAM,EAAE,CAAC;AAErE,SAAgB,oBACd,UAGI,CAAC,GACU;CACf,MAAM,YAAY,QAAQ,yBAAyB,QAAQ,CAAC,IAAI;CAChE,MAAM,2BAAW,IAAI,IAA4B;CAEjD,KAAK,MAAM,SAAS,QAAQ,UAAU,CAAC,GACrC,IAAI,iBAAiB,IAAI,MAAM,EAAE,GAC/B,MAAM,IAAI,MAAM,4BAA4B,MAAM,GAAG,oCAAoC;CAI7F,KAAK,MAAM,SAAS,CAAC,GAAG,WAAW,GAAI,QAAQ,UAAU,CAAC,CAAE,GAAG;EAC7D,IAAI,SAAS,IAAI,MAAM,EAAE,GACvB,MAAM,IAAI,MAAM,sCAAsC,MAAM,GAAG,eAAe;EAEhF,SAAS,IAAI,MAAM,IAAI,KAAK;CAC9B;CAEA,OAAO,OAAO,OAAO;EACnB,MAAM,SAAS;EACf,KAAK,SAAS,IAAI,KAAK,QAAQ;EAC/B,KAAK,SAAS,IAAI,KAAK,QAAQ;EAC/B,MAAM,SAAS,KAAK,KAAK,QAAQ;EACjC,QAAQ,SAAS,OAAO,KAAK,QAAQ;EACrC,SAAS,SAAS,QAAQ,KAAK,QAAQ;GACtC,OAAO,WAAW,SAAS,OAAO,SAAS,CAAC,KAAK,QAAQ;CAC5D,CAAC;AACH"}

package/dist/boards/review.js

@@ -1,5 +1,5 @@
-import { workItemNumber } from "../work-item-branch.js";
 import { defineBoard } from "./define-board.js";
+import { workItemNumber } from "../work-item-branch.js";
 //#region src/boards/review.ts
 function sourceRef(item) {
 	const link = item.url ? ` (${item.url})` : "";

package/dist/boards/work.js

@@ -1,6 +1,6 @@
-import { needsApproval } from "../rules/types.js";
-import { workItemNumber } from "../work-item-branch.js";
 import { defineBoard } from "./define-board.js";
+import { workItemNumber } from "../work-item-branch.js";
+import { needsApproval } from "../rules/types.js";
 //#region src/boards/work.ts
 function linearIdentifier(item) {
 	const identifier = item.metadata?.identifier;

package/dist/factory.d.ts

@@ -22,6 +22,7 @@ import type { Mastra } from '@mastra/core/mastra';
 import type { IMastraAuthProvider } from '@mastra/core/server';
 import type { FactoryStorage } from '@mastra/core/storage';
 import type { MastraVector } from '@mastra/core/vector';
+import type { InstalledBoard } from './boards/index.js';
 import type { FactoryIntegration } from './integrations/base.js';
 import type { FactoryRules } from './rules/types.js';
 import type { MastraFactorySandboxConfig } from './sandbox/session-sandbox.js';
@@ -114,12 +115,16 @@ export interface MastraFactoryConfig {
      */
     integrations?: FactoryIntegration[];
     /**
-     * Authoritative Factory board, tool-result, and GitHub-event rules. Construct
+     * Authoritative Factory board, tool-result, and Linear-event rules. Construct
      * with `defaultFactoryRules({ version, overrides })` so deployment policy has
      * an explicit version and exact handler leaves replace rather than compose.
      * Omitted → conservative built-in rules for the current deployment.
      */
     rules?: FactoryRules;
+    /** Board definitions installed for this Factory instance. */
+    boards?: readonly InstalledBoard[];
+    /** Whether the built-in Work and Review boards are installed. Default: true. */
+    includeDefaultBoards?: boolean;
     /**
      * Platform-specific overrides. `githubAppSlug` identifies Factory's own
      * GitHub App writes so their webhook deliveries do not retrigger triage.

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWxD,OAAO,KAAK,EAAE,kBAAkB,EAAgD,MAAM,wBAAwB,CAAC;AA0B/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAqCtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,mDAAmD;IACnD,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAyED,qBAAa,aAAa;;gBAOZ,MAAM,EAAE,mBAAmB;IAWvC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAszBpC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,iFAAiF;IAC3E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWxD,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,KAAK,EAAE,kBAAkB,EAAgD,MAAM,wBAAwB,CAAC;AA0B/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAqCtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,mDAAmD;IACnD,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAyED,qBAAa,aAAa;;gBAQZ,MAAM,EAAE,mBAAmB;IAevC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAyzBpC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,iFAAiF;IAC3E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/factory.js

@@ -1,5 +1,7 @@
 import { timedPhase } from "./timing.js";
 import { buildAuthRoutes, createFactoryAuthGate, createFactoryRouteAuth, getFactoryAuthOrgId, getFactoryAuthUserFromContext, getFactoryAuthUserId } from "./auth.js";
+import { createBoardRegistry } from "./boards/registry.js";
+import "./boards/index.js";
 import { touchFeed } from "./feed-events.js";
 import { reconcileGithubAcceptanceLabels } from "./integrations/github/acceptance-labels.js";
 import { recordFactoryPullRequestProvenance, resolveFactoryPullRequestParentWorkItemId } from "./integrations/github/provenance.js";
@@ -133,12 +135,17 @@ function parentDomainFromPublicUrl(publicUrl) {
 }
 var MastraFactory = class {
 	#config;
+	#boards;
 	#prepared;
 	#dispatcher;
 	#factoryProcessor;
 	#preparing = false;
 	constructor(config) {
 		if (!config?.storage) throw new Error("MastraFactory: 'storage' is required. Pass a FactoryStorage backend — e.g. new PgFactoryStorage({ connectionString }) from '@mastra/pg' for deployments, or new LibSQLFactoryStorage({ url }) from '@mastra/libsql' for local dev.");
+		this.#boards = createBoardRegistry({
+			boards: config.boards,
+			includeDefaultBoards: config.includeDefaultBoards
+		});
 		this.#config = config;
 	}
 	/**
@@ -286,6 +293,7 @@ var MastraFactory = class {
 		}) : retireTerminalSessions;
 		const transitionService = workItemsReady ? new FactoryTransitionService({
 			rules,
+			boards: this.#boards,
 			storage: workItemsStorage,
 			...onTerminalStage ? { onTerminalStage } : {},
 			...githubIntegration ? { onAccepted: (args) => reconcileGithubAcceptanceLabels(githubIntegration, sourceControlStorage.forIntegration(githubIntegration.id), args) } : {}
@@ -324,6 +332,7 @@ var MastraFactory = class {
 		const factoryProcessor = workItemsReady ? new FactoryPhaseStateProcessor({
 			rules,
 			storage: workItemsStorage,
+			boardRegistry: this.#boards,
 			...transitionService ? { transitionService } : {},
 			...githubIntegration ? { recordPullRequestProvenance: (input) => recordFactoryPullRequestProvenance(githubIntegration, sourceControlStorage.forIntegration("github"), integrationStorage.forIntegration("github"), workItemsStorage, input) } : {},
 			messageReader: { listMessages: async (input) => {
@@ -482,6 +491,7 @@ var MastraFactory = class {
 					factoryReady,
 					knowledgeEnabled,
 					rules,
+					boardRegistry: this.#boards,
 					factoryTransitionService: transitionService,
 					onFactoryRuntime: ({ transitionService: runtimeTransitionService, prepareBinding }) => {
 						this.#dispatcher ??= new FactoryDecisionDispatcher({