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

package/factory-skills/configure-factory-rules/SKILL.md

@@ -12,18 +12,26 @@ Help the user change Factory policy in the typed deployment configuration. Facto
 1. Search for `new MastraFactory`, `defaultFactoryRules`, and the `rules` property.
 2. Read the existing rule configuration and its tests before editing.
 3. Import rule helpers and types from the same local Factory module used by the deployment.
-4. If the deployment doesn't configure `rules`, start with `defaultFactoryRules({ version, overrides })` and pass the result to `MastraFactory`.
+4. For board, tool, or Linear rules, start with `defaultFactoryRules({ version, overrides })` if needed and pass the result to `MastraFactory`. For GitHub rules, configure the installed GitHub integration constructor directly.
 
 Do not guess a file path. Factory deployments can assemble `MastraFactory` from different entry points.
 
 ## Preserve the public shape
 
-Use one rules tree:
+Use the global rules tree for board, tool, and Linear handlers:
 
 - `work.<stage>.<source>.onEnter` or `onExit`
 - `review.<stage>.<source>.onEnter` or `onExit`
 - `tools.<toolName>.onResult`
-- `github.<event>.onEvent`
+- `linear.<event>.onEvent`
+
+Configure GitHub on the installed `GithubIntegration` or `PlatformGithubIntegration` constructor instead:
+
+```typescript
+new PlatformGithubIntegration({ rules: { issueCommentCreated: null } });
+```
+
+GitHub integrations exclusively own their event handlers; configure them through constructor `rules[event]`, not the global Factory rules tree. A function replaces the default, `null` disables that event's handler, and omitted or `undefined` values retain defaults. Constructors validate names and handler values, then copy and freeze the effective map per instance. Disabling a handler does not disable webhook authentication or reconciliation bookkeeping.
 
 Do not create an `actions` config or execute authoritative policy in React. Each handler returns one typed `FactoryRuleDecision` or `undefined`.
 
@@ -35,7 +43,7 @@ An override replaces the exact handler leaf. It does not compose with the built-
 
 Before replacing a built-in leaf:
 
-1. Read the built-in handler in `src/web/factory/rules/defaults.ts`.
+1. Find and read the built-in handler: GitHub handlers live in `src/integrations/github/default-rules.ts` within the Factory package; global defaults live in `src/rules/defaults.ts`.
 2. Decide whether the replacement must preserve part of that behavior explicitly.
 3. Use only fields exposed by the typed context. Do not reach into Factory storage or raw webhook payloads.
 4. Return `undefined` to allow the ingress with no decision, or return a typed rejection or bounded structured decision.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/factory",
-  "version": "0.13.0-alpha.6",
+  "version": "0.13.0-alpha.7",
   "description": "Mastra Software Factory module: the server core behind the Mastra Software Factory — storage domains, integrations, and surfaces for agent-powered software delivery",
   "type": "module",
   "publishConfig": {
@@ -52,9 +52,9 @@
     "zod": "^4.3.6",
     "@mastra/auth-studio": "1.3.5",
     "@mastra/auth-workos": "1.6.5",
-    "@mastra/code-sdk": "1.7.0-alpha.5",
-    "@mastra/core": "1.65.0-alpha.4",
-    "@mastra/slack": "1.6.3"
+    "@mastra/slack": "1.6.3",
+    "@mastra/code-sdk": "1.7.0-alpha.6",
+    "@mastra/core": "1.65.0-alpha.5"
   },
   "devDependencies": {
     "@types/node": "22.20.1",
@@ -63,9 +63,9 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.57.0",
     "vitest": "4.1.10",
-    "@mastra/libsql": "1.22.4-alpha.0",
-    "@mastra/pg": "1.23.0-alpha.1",
     "@internal/lint": "0.0.130",
+    "@mastra/pg": "1.23.0-alpha.1",
+    "@mastra/libsql": "1.22.4-alpha.0",
     "@internal/workspace": "0.0.2",
     "@internal/types-builder": "0.0.105"
   },