mandrel 1.94.0 → 2.1.0

package/.agents/docs/agentrc-reference.json

@@ -27,12 +27,18 @@
     "projectNumber": null,
     "projectOwner": null,
     "operatorHandle": "@[USERNAME]",
+    "defaultTimeoutMs": 60000,
     "branchProtection": {
       "enforce": true,
       "requiredChecks": [
-        { "name": "lint", "cmd": ["npm", "run", "lint"] },
-        { "name": "format:check", "cmd": ["npm", "run", "format:check"] },
-        { "name": "test", "cmd": ["npm", "test"] },
+        {
+          "name": "lint",
+          "cmd": ["npm", "run", "lint"]
+        },
+        {
+          "name": "test",
+          "cmd": ["npm", "test"]
+        },
         {
           "name": "baselines",
           "cmd": ["node", ".agents/scripts/check-baselines.js"]
@@ -50,19 +56,17 @@
       "mentionOperator": false,
       "commentEvents": ["state-transition", "story-merged", "operator-message"],
       "webhookEvents": [
-        "epic-started",
-        "epic-progress",
-        "epic-blocked",
-        "epic-unblocked",
-        "epic-complete"
+        "state-transition",
+        "story-merged",
+        "story-closing",
+        "operator-message",
+        "merge.unlanded",
+        "merge.flip-failed",
+        "loop.tick"
       ]
     }
   },
   "planning": {
-    "context": {
-      "maxBytes": 50000,
-      "summaryMode": "auto"
-    },
     "codebaseSnapshot": {
       "tier": "skinny",
       "include": [
@@ -76,6 +80,8 @@
         "**/node_modules/**",
         "**/dist/**",
         "**/build/**",
+        "**/.next/**",
+        "**/.turbo/**",
         "**/coverage/**",
         "**/*.test.*",
         "**/*.spec.*"
@@ -89,118 +95,198 @@
       "Monorepo-wide AST or text replacements touching overlapping files in parallel (catastrophic merge-conflict risk across concurrent agents).",
       "Schema migrations that rewrite existing rows or drop columns without a backfill or rollback plan."
     ],
-    "taskSizing": {
-      "softFiles": 15,
-      "hardFiles": 30,
-      "softAcceptanceCount": 10
+    "failOnSharedEditors": false,
+    "requireExplicitCrossStoryDeps": false,
+    "failOnRegistryConflicts": false,
+    "failOnLargeFanOut": false,
+    "largeFanOutThreshold": 10,
+    "crossCuttingRegistries": [
+      "lib/orchestration/lifecycle/listeners/index.js",
+      "**/listeners/index.js",
+      "**/handlers/index.js"
+    ],
+    "navigation": {
+      "routeGlobs": [],
+      "navRegistry": []
     }
   },
   "delivery": {
-    "execution": { "timeoutMs": 600000 },
-    "maxTokenBudget": 300000,
-    "lease": { "ttlMs": 900000 },
+    "execution": {
+      "timeoutMs": 600000
+    },
+    "lease": {
+      "ttlMs": 900000
+    },
     "ci": {
-      "skipForStoryPushes": true,
-      "earlyPr": true,
       "watch": {
-        "pollIntervalMs": 30000,
-        "maxPolls": 120,
+        "pollIntervalMs": 10000,
+        "maxPolls": 180,
         "maxResumes": 3
       },
       "autoMerge": "trust-ci"
     },
-    "preflight": {
-      "maxStories": 50,
-      "maxWaves": 10,
-      "maxInstallCostSeconds": 600,
-      "maxGithubApiRequests": 5000,
-      "maxClaudeQuotaTokens": 2000000
-    },
     "docsFreshness": {
       "paths": ["README.md"]
     },
     "deliverRunner": {
-      "concurrencyCap": 3,
-      "progressReportIntervalSec": 120,
-      "verifyConcurrencyCap": 4
+      "concurrencyCap": 3
     },
     "worktreeIsolation": {
       "enabled": true,
       "root": ".worktrees",
-      "nodeModulesStrategy": "pnpm-store",
+      "nodeModulesStrategy": "clone",
       "primeFromPath": null,
       "allowSymlinkOnWindows": false,
       "reapOnSuccess": true,
-      "reapOnCancel": true,
-      "bootstrapFiles": [".env", ".mcp.json"]
+      "bootstrapFiles": [
+        ".env",
+        ".mcp.json",
+        ".agentrc.local.json",
+        ".agents/instructions.local.md"
+      ]
     },
     "signals": {
-      "hotspot": { "p95Multiplier": 1.25 },
-      "rework": { "editsPerFile": 5 },
-      "retry": { "repeatCount": 3 }
+      "rework": {
+        "editsPerFile": 5
+      },
+      "retry": {
+        "repeatCount": 3
+      }
+    },
+    "mergeWatch": {
+      "intervalSeconds": 30,
+      "maxBudgetSeconds": 3600
     },
     "codeReview": {
       "providers": [
-        { "name": "native" },
-        { "name": "security-review", "scopes": ["epic"], "optional": true },
+        {
+          "name": "native"
+        },
+        {
+          "name": "security-review",
+          "scopes": ["story"],
+          "optional": true
+        },
         {
           "name": "ultrareview",
-          "scopes": ["epic"],
+          "scopes": ["story"],
           "manualPrompt": true,
-          "when": { "label": "risk::high" }
+          "when": {
+            "label": "risk::high"
+          }
         }
       ],
       "maxFixAttempts": 3,
-      "maxFixScopeFiles": 5
+      "maxFixScopeFiles": 5,
+      "autoFixSeverity": "medium"
+    },
+    "routing": {
+      "roleScopedAgents": true,
+      "freshCriticSampleRate": 0.2,
+      "ceremonyProfile": "standard",
+      "closeAndLand": true
+    },
+    "feedbackLoop": {
+      "auditResultsAutoFile": true,
+      "retroProposals": true
     },
     "quality": {
-      "gateScoping": { "scope": "diff", "diffRef": "main" },
+      "gateScoping": {
+        "scope": "diff",
+        "diffRef": "main"
+      },
       "gates": {
         "lint": {
           "enabled": true,
           "baselinePath": "baselines/lint.json",
-          "tolerance": { "kind": "absolute", "value": 0 },
-          "floors": { "*": { "errorCount": 0 } }
+          "tolerance": {
+            "kind": "absolute",
+            "value": 0
+          },
+          "floors": {
+            "*": {
+              "errorCount": 0
+            }
+          }
         },
         "coverage": {
           "enabled": true,
           "baselinePath": "baselines/coverage.json",
-          "tolerance": { "kind": "absolute", "value": 0 },
-          "floors": { "*": { "lines": 90, "branches": 85, "functions": 90 } },
+          "tolerance": {
+            "kind": "absolute",
+            "value": 0
+          },
+          "floors": {
+            "*": {
+              "lines": 90,
+              "branches": 85,
+              "functions": 90
+            }
+          },
           "coveragePath": "coverage/coverage-final.json",
           "timeoutMs": 600000
         },
         "crap": {
           "enabled": true,
           "baselinePath": "baselines/crap.json",
-          "tolerance": { "kind": "absolute", "value": 0.05 },
-          "floors": { "*": { "max": 30, "p95": 20, "methodsAbove20": 50 } },
+          "tolerance": {
+            "kind": "absolute",
+            "value": 0.05
+          },
+          "floors": {
+            "*": {
+              "max": 30,
+              "p95": 20,
+              "methodsAbove20": 50
+            }
+          },
           "targetDirs": ["src"],
           "newMethodCeiling": 30,
           "requireCoverage": true,
-          "friction": { "markerKey": "crap-baseline-regression" },
+          "friction": {
+            "markerKey": "crap-baseline-regression"
+          },
           "refreshTag": "baseline-refresh:",
-          "ignoreGlobs": ["**/fixtures/**", "**/*.generated.ts"]
+          "refreshTimeoutMs": 60000,
+          "ignoreGlobs": []
         },
         "maintainability": {
           "enabled": true,
           "baselinePath": "baselines/maintainability.json",
-          "tolerance": { "kind": "absolute", "value": 0.5 },
-          "floors": { "*": { "min": 70, "p50": 80 } },
-          "targetDirs": ["src", "tests"],
-          "ignoreGlobs": ["**/fixtures/**", "**/*.generated.ts"]
+          "tolerance": {
+            "kind": "absolute",
+            "value": 0.5
+          },
+          "floors": {
+            "*": {
+              "min": 70
+            }
+          },
+          "targetDirs": [],
+          "refreshTimeoutMs": 60000,
+          "ignoreGlobs": []
         },
         "mutation": {
           "enabled": true,
           "baselinePath": "baselines/mutation.json",
-          "tolerance": { "kind": "percent", "value": 0 },
-          "floors": { "*": { "score": 60 } },
+          "tolerance": {
+            "kind": "percent",
+            "value": 0
+          },
+          "floors": {
+            "*": {
+              "score": 60
+            }
+          },
           "strykerConfigPath": null
         },
         "lighthouse": {
           "enabled": false,
           "baselinePath": "baselines/lighthouse.json",
-          "tolerance": { "kind": "absolute", "value": 0 },
+          "tolerance": {
+            "kind": "absolute",
+            "value": 0
+          },
           "floors": {
             "*": {
               "performance": 0,
@@ -215,29 +301,42 @@
         "bundle-size": {
           "enabled": false,
           "baselinePath": "baselines/bundle-size.json",
-          "tolerance": { "kind": "percent", "value": 0 },
-          "floors": { "*": {} },
+          "tolerance": {
+            "kind": "percent",
+            "value": 0
+          },
+          "floors": {
+            "*": {}
+          },
           "bundles": []
         },
         "duplication": {
           "enabled": false,
           "baselinePath": "baselines/duplication.json",
-          "tolerance": { "kind": "absolute", "value": 1 },
-          "floors": { "*": { "percentage": 25 } },
+          "tolerance": {
+            "kind": "absolute",
+            "value": 1
+          },
+          "floors": {
+            "*": {
+              "percentage": 25
+            }
+          },
           "targetDirs": ["src"],
           "refreshTimeoutMs": 60000,
-          "ignoreGlobs": ["**/fixtures/**", "**/*.generated.ts"]
+          "ignoreGlobs": []
         }
       },
+      "formatAutofix": {
+        "timeoutMs": 60000
+      },
       "codingGuardrails": {
         "cyclomaticFlag": 8,
         "cyclomaticMustFix": 12,
-        "miDropMustRefactor": 1.5,
         "requireSiblingTest": false
       },
       "autoRefresh": {
         "enabled": true,
-        "miDropCap": 1.5,
         "crapJumpCap": 5,
         "scope": "diff"
       },
@@ -250,21 +349,19 @@
         "lighthouse": 1,
         "bundle-size": 1024,
         "duplication": 0.5
-      }
-    },
-    "lifecycle": {
-      "timeouts": {
-        "acceptance.reconcile": 600,
-        "epic.finalize": 600,
-        "epic.watch": 1800
       },
-      "heartbeatWarnSeconds": 60
+      "requireBaselines": false,
+      "navigability": {
+        "routeGlobs": [],
+        "navRegistry": []
+      }
     },
     "refactorStage": {
       "enabled": false
     },
     "acceptanceEval": {
-      "maxRounds": 2
+      "maxRounds": 2,
+      "clusterCeiling": 4
     }
   },
   "qa": {
@@ -273,17 +370,25 @@
     "environments": {
       "local": {
         "baseUrl": "http://localhost:3000",
-        "signInSeam": { "urlTemplate": "/dev/sign-in-as/{persona}" }
+        "signInSeam": {
+          "urlTemplate": "/dev/sign-in-as/{persona}"
+        }
       },
       "staging": {
         "baseUrl": "https://staging.example.test",
-        "signInSeam": { "skill": "stack/qa/sign-in" },
+        "signInSeam": {
+          "skill": "stack/qa/sign-in"
+        },
         "allowWrites": false
       }
     },
     "personas": {
-      "admin": { "credentialRef": "QA_ADMIN_CREDENTIAL" },
-      "member": { "signInSkill": "stack/qa/sign-in-member" }
+      "admin": {
+        "credentialRef": "QA_ADMIN_CREDENTIAL"
+      },
+      "member": {
+        "signInSkill": "stack/qa/sign-in-member"
+      }
     },
     "consoleAllowlist": ["Download the React DevTools", "[HMR]"],
     "designTokens": "src/styles/tokens.css"