mandrel 2.110.0 → 2.112.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/.agents/agents/acceptance-critic.md +14 -0
  2. package/.agents/agents/auditor.md +14 -0
  3. package/.agents/agents/plan-critic.md +5 -0
  4. package/.agents/agents/story-worker.md +4 -1
  5. package/.agents/audit-checklists/state-machines.md +21 -0
  6. package/.agents/docs/agentrc-reference.json +23 -10
  7. package/.agents/docs/configuration.md +362 -15
  8. package/.agents/docs/execution-reference.md +11 -0
  9. package/.agents/docs/workflows.md +2 -1
  10. package/.agents/rules/ci-remediation.md +28 -4
  11. package/.agents/rules/git-conventions-reference.md +7 -0
  12. package/.agents/schemas/agentrc.schema.json +179 -13
  13. package/.agents/schemas/audit-rules.json +28 -0
  14. package/.agents/schemas/baselines/baseline-envelope.schema.json +16 -4
  15. package/.agents/schemas/baselines/bundle-size.schema.json +1 -0
  16. package/.agents/schemas/baselines/coverage.schema.json +1 -0
  17. package/.agents/schemas/baselines/crap.schema.json +37 -10
  18. package/.agents/schemas/baselines/duplication.schema.json +1 -0
  19. package/.agents/schemas/baselines/maintainability.schema.json +1 -0
  20. package/.agents/schemas/baselines/mutation.schema.json +1 -0
  21. package/.agents/schemas/crap-report.schema.json +6 -5
  22. package/.agents/schemas/story-deliver-terminal.schema.json +49 -3
  23. package/.agents/schemas/story-progress.schema.json +1 -1
  24. package/.agents/schemas/validation-evidence.schema.json +2 -2
  25. package/.agents/scripts/boot-sweep.js +41 -3
  26. package/.agents/scripts/coverage-capture.js +39 -3
  27. package/.agents/scripts/coverage-ratchet.js +106 -0
  28. package/.agents/scripts/evidence-gate.js +84 -21
  29. package/.agents/scripts/file-ci-gap.js +220 -10
  30. package/.agents/scripts/lib/audit-baselines/read.js +8 -1
  31. package/.agents/scripts/lib/audit-baselines/trend.js +2 -1
  32. package/.agents/scripts/lib/audit-to-stories/audit-lenses.js +1 -0
  33. package/.agents/scripts/lib/baseline-loader.js +4 -2
  34. package/.agents/scripts/lib/baselines/codec.js +57 -0
  35. package/.agents/scripts/lib/baselines/crap-preview-incremental.js +8 -3
  36. package/.agents/scripts/lib/baselines/crap-preview-scan.js +10 -16
  37. package/.agents/scripts/lib/baselines/crap-updater-cli.js +4 -13
  38. package/.agents/scripts/lib/baselines/kernel.js +19 -1
  39. package/.agents/scripts/lib/baselines/kinds/_crap-codec.js +171 -0
  40. package/.agents/scripts/lib/baselines/kinds/_crap-read.js +56 -16
  41. package/.agents/scripts/lib/baselines/kinds/_shared-metric.js +0 -59
  42. package/.agents/scripts/lib/baselines/kinds/crap.js +283 -319
  43. package/.agents/scripts/lib/baselines/preview-gates.js +29 -10
  44. package/.agents/scripts/lib/baselines/reader.js +36 -9
  45. package/.agents/scripts/lib/baselines/refresh-service.js +79 -18
  46. package/.agents/scripts/lib/baselines/seat-missing.js +173 -7
  47. package/.agents/scripts/lib/baselines/writer.js +36 -21
  48. package/.agents/scripts/lib/changed-files.js +70 -6
  49. package/.agents/scripts/lib/child-exec.js +10 -0
  50. package/.agents/scripts/lib/claude/agents-projection.js +5 -5
  51. package/.agents/scripts/lib/close-lock-events.js +8 -3
  52. package/.agents/scripts/lib/close-validation/ci-deferral.js +40 -0
  53. package/.agents/scripts/lib/close-validation/gates.js +156 -32
  54. package/.agents/scripts/lib/close-validation/process.js +16 -7
  55. package/.agents/scripts/lib/close-validation/projections/crap.js +43 -10
  56. package/.agents/scripts/lib/close-validation/runner.js +160 -41
  57. package/.agents/scripts/lib/close-validation/skip-branch-test.js +144 -0
  58. package/.agents/scripts/lib/close-validation/test-delta.js +33 -8
  59. package/.agents/scripts/lib/codex/agents-projection.js +6 -0
  60. package/.agents/scripts/lib/config/agentrc-overlay.js +9 -5
  61. package/.agents/scripts/lib/config/explain.js +5 -2
  62. package/.agents/scripts/lib/config/gates/coverage.schema.js +53 -0
  63. package/.agents/scripts/lib/config/gates/crap-incremental-coverage.schema.js +1 -1
  64. package/.agents/scripts/lib/config/git-roots.js +38 -4
  65. package/.agents/scripts/lib/config/handoff.js +24 -0
  66. package/.agents/scripts/lib/config/quality.js +28 -12
  67. package/.agents/scripts/lib/config/worktree-isolation.js +2 -5
  68. package/.agents/scripts/lib/config-resolver.js +22 -2
  69. package/.agents/scripts/lib/config-settings-schema-delivery.js +87 -4
  70. package/.agents/scripts/lib/config-settings-schema-quality.js +36 -1
  71. package/.agents/scripts/lib/config-settings-schema.js +1 -1
  72. package/.agents/scripts/lib/coverage-capture-affected.js +1 -0
  73. package/.agents/scripts/lib/coverage-capture-delta.js +164 -32
  74. package/.agents/scripts/lib/coverage-capture-own-fix.js +232 -0
  75. package/.agents/scripts/lib/coverage-capture-usage.js +2 -2
  76. package/.agents/scripts/lib/coverage-capture.js +31 -0
  77. package/.agents/scripts/lib/coverage-deferral.js +96 -0
  78. package/.agents/scripts/lib/coverage-ratchet.js +187 -0
  79. package/.agents/scripts/lib/crap-baseline-join.js +5 -5
  80. package/.agents/scripts/lib/crap-engine.js +3 -3
  81. package/.agents/scripts/lib/crap-method-identity.js +104 -48
  82. package/.agents/scripts/lib/escomplex-anchor.js +135 -0
  83. package/.agents/scripts/lib/escomplex-kernel.js +30 -1
  84. package/.agents/scripts/lib/failure-rows.js +121 -0
  85. package/.agents/scripts/lib/full-suite-lock.js +44 -4
  86. package/.agents/scripts/lib/full-suite-queue.js +89 -13
  87. package/.agents/scripts/lib/generated/agentrc-validator.js +8 -2
  88. package/.agents/scripts/lib/gh-env.js +3 -6
  89. package/.agents/scripts/lib/gh-pr-rest.js +1 -0
  90. package/.agents/scripts/lib/git/base-sync-probe.js +182 -0
  91. package/.agents/scripts/lib/git-branch-lifecycle.js +9 -0
  92. package/.agents/scripts/lib/observability/close-telemetry.js +37 -2
  93. package/.agents/scripts/lib/observability/handoff-telemetry.js +170 -0
  94. package/.agents/scripts/lib/observability/review-dispositions.js +23 -6
  95. package/.agents/scripts/lib/observability/runtime-friction.js +17 -4
  96. package/.agents/scripts/lib/observability/source-classifier.js +3 -0
  97. package/.agents/scripts/lib/observability/story-outcome.js +393 -0
  98. package/.agents/scripts/lib/orchestration/check-baselines/phases/compare.js +2 -1
  99. package/.agents/scripts/lib/orchestration/check-baselines/phases/evaluate.js +19 -1
  100. package/.agents/scripts/lib/orchestration/check-baselines/phases/fail-detail.js +84 -0
  101. package/.agents/scripts/lib/orchestration/check-baselines/phases/pipeline.js +14 -5
  102. package/.agents/scripts/lib/orchestration/check-baselines/phases/refresh-ack.js +3 -2
  103. package/.agents/scripts/lib/orchestration/check-baselines/phases/report.js +26 -6
  104. package/.agents/scripts/lib/orchestration/ci-rerun-guard.js +124 -23
  105. package/.agents/scripts/lib/orchestration/code-review.js +223 -19
  106. package/.agents/scripts/lib/orchestration/handoff-gates.js +217 -44
  107. package/.agents/scripts/lib/orchestration/handoff-rescore.js +169 -0
  108. package/.agents/scripts/lib/orchestration/handoff-suite-of-record.js +45 -0
  109. package/.agents/scripts/lib/orchestration/plan-persist/run-plan-persist.js +5 -1
  110. package/.agents/scripts/lib/orchestration/plan-persist/source-rewrite.js +76 -4
  111. package/.agents/scripts/lib/orchestration/plan-persist/story-ops.js +2 -2
  112. package/.agents/scripts/lib/orchestration/preflight-lanes.js +208 -0
  113. package/.agents/scripts/lib/orchestration/review-base-ref.js +40 -17
  114. package/.agents/scripts/lib/orchestration/review-deposit.js +38 -12
  115. package/.agents/scripts/lib/orchestration/review-depth.js +21 -0
  116. package/.agents/scripts/lib/orchestration/review-history.js +124 -20
  117. package/.agents/scripts/lib/orchestration/review-providers/claude-verdict.js +23 -8
  118. package/.agents/scripts/lib/orchestration/review-providers/code-review.js +82 -39
  119. package/.agents/scripts/lib/orchestration/review-providers/critical-verifier.js +64 -11
  120. package/.agents/scripts/lib/orchestration/review-providers/degraded-gates.js +98 -3
  121. package/.agents/scripts/lib/orchestration/review-providers/finding-identity.js +6 -2
  122. package/.agents/scripts/lib/orchestration/review-providers/findings-renderer.js +55 -8
  123. package/.agents/scripts/lib/orchestration/review-providers/review-guidance.js +1 -0
  124. package/.agents/scripts/lib/orchestration/review-providers/review-provider-factory.js +42 -15
  125. package/.agents/scripts/lib/orchestration/review-providers/types.js +6 -0
  126. package/.agents/scripts/lib/orchestration/single-story-close/failed-terminal.js +10 -1
  127. package/.agents/scripts/lib/orchestration/single-story-close/gate-log.js +10 -0
  128. package/.agents/scripts/lib/orchestration/single-story-close/phases/base-sync.js +7 -4
  129. package/.agents/scripts/lib/orchestration/single-story-close/phases/close-validation.js +17 -2
  130. package/.agents/scripts/lib/orchestration/single-story-close/phases/code-review.js +59 -2
  131. package/.agents/scripts/lib/orchestration/single-story-close/phases/confirm-merge.js +13 -1
  132. package/.agents/scripts/lib/orchestration/single-story-close/phases/finish.js +15 -4
  133. package/.agents/scripts/lib/orchestration/single-story-close/phases/land-review-record.js +213 -0
  134. package/.agents/scripts/lib/orchestration/single-story-close/phases/normalize-pr-title.js +17 -2
  135. package/.agents/scripts/lib/orchestration/single-story-close/phases/open-pr.js +42 -20
  136. package/.agents/scripts/lib/orchestration/single-story-close/phases/post-land.js +51 -26
  137. package/.agents/scripts/lib/orchestration/single-story-close/phases/pre-push.js +3 -1
  138. package/.agents/scripts/lib/orchestration/single-story-close/phases/pull-request.js +51 -15
  139. package/.agents/scripts/lib/orchestration/single-story-close/phases/push.js +59 -11
  140. package/.agents/scripts/lib/orchestration/single-story-close/phases/reconcile-done.js +1 -0
  141. package/.agents/scripts/lib/orchestration/single-story-close/phases/review-block.js +31 -13
  142. package/.agents/scripts/lib/orchestration/single-story-close/phases/review-halt.js +29 -6
  143. package/.agents/scripts/lib/orchestration/single-story-close/phases/review-outcome.js +10 -12
  144. package/.agents/scripts/lib/orchestration/single-story-close/phases/review-override.js +19 -4
  145. package/.agents/scripts/lib/orchestration/single-story-close/result.js +43 -13
  146. package/.agents/scripts/lib/orchestration/single-story-close/review-overlap.js +73 -39
  147. package/.agents/scripts/lib/orchestration/single-story-close/runner.js +11 -2
  148. package/.agents/scripts/lib/orchestration/story-close/baseline-upward-writeback.js +3 -2
  149. package/.agents/scripts/lib/orchestration/story-close/duplication-close-rescore.js +20 -8
  150. package/.agents/scripts/lib/orchestration/story-deliver-terminal.js +7 -0
  151. package/.agents/scripts/lib/orchestration/story-handoff.js +789 -196
  152. package/.agents/scripts/lib/orchestration/ticketing/reads.js +2 -0
  153. package/.agents/scripts/lib/pr-body-lines.js +32 -0
  154. package/.agents/scripts/lib/single-story/ci-ratchet-gate.js +140 -0
  155. package/.agents/scripts/lib/single-story/confirm-and-land.js +17 -7
  156. package/.agents/scripts/lib/single-story/confirm-merge.js +12 -3
  157. package/.agents/scripts/lib/single-story-sweep/report-stalled-executing.js +202 -0
  158. package/.agents/scripts/lib/standalone-ratchets.js +37 -0
  159. package/.agents/scripts/lib/suite-admission.js +20 -8
  160. package/.agents/scripts/lib/suite-sizing.js +146 -0
  161. package/.agents/scripts/lib/workspace-provisioner.js +2 -2
  162. package/.agents/scripts/merge-baseline.js +14 -3
  163. package/.agents/scripts/providers/github/comments.js +19 -3
  164. package/.agents/scripts/providers/github.js +1 -0
  165. package/.agents/scripts/review-dispositions-report.js +1 -1
  166. package/.agents/scripts/role-scope-guard.js +267 -0
  167. package/.agents/scripts/single-story-close.js +4 -4
  168. package/.agents/scripts/single-story-confirm-merge.js +31 -5
  169. package/.agents/scripts/single-story-init.js +24 -4
  170. package/.agents/scripts/story-handoff.js +3 -3
  171. package/.agents/scripts/story-outcomes-report.js +231 -0
  172. package/.agents/scripts/story-review-compute.js +9 -5
  173. package/.agents/scripts/update-coverage-baseline.js +12 -2
  174. package/.agents/scripts/update-crap-baseline.js +9 -1
  175. package/.agents/workflows/audit-state-machines.md +213 -0
  176. package/.agents/workflows/helpers/code-review.md +63 -9
  177. package/.agents/workflows/helpers/deliver-digest.md +53 -54
  178. package/.agents/workflows/helpers/deliver-reference.md +236 -63
  179. package/.agents/workflows/helpers/deliver-story-reference.md +19 -8
  180. package/.agents/workflows/helpers/deliver-story.md +7 -2
  181. package/.agents/workflows/helpers/parallel-tooling.md +29 -0
  182. package/.agents/workflows/helpers/plan-reference.md +10 -2
  183. package/docs/CHANGELOG.md +56 -0
  184. package/lib/cli/doctor-checks/coverage-ratchet.js +54 -0
  185. package/lib/cli/doctor-checks/effective-agentrc.js +23 -0
  186. package/lib/cli/doctor-checks/llm-review.js +2 -11
  187. package/lib/cli/doctor-checks/sync-parity.js +5 -1
  188. package/lib/cli/doctor-checks/test-credit-path.js +7 -2
  189. package/lib/cli/registry.js +5 -0
  190. package/package.json +1 -1
@@ -9,6 +9,13 @@ description: >-
9
9
  whose verdict owner is a fresh critic.
10
10
  effort: medium
11
11
  model: inherit
12
+ disallowedTools: NotebookEdit
13
+ hooks:
14
+ PreToolUse:
15
+ - matcher: "Write|Edit|MultiEdit|NotebookEdit|Bash"
16
+ hooks:
17
+ - type: command
18
+ command: 'node "$CLAUDE_PROJECT_DIR/.agents/scripts/role-scope-guard.js" --role acceptance-critic'
12
19
  ---
13
20
 
14
21
  <!--
@@ -142,6 +149,13 @@ the gate decides.
142
149
  ## Boundaries
143
150
 
144
151
  - Do not fix the code, redraft the diff, or commit. You evaluate and report.
152
+ - Your one write is the verdict file under tempRoot. The
153
+ `role-scope-guard.js` PreToolUse hook denies writes outside tempRoot and
154
+ Bash commands in named mutation classes (git/gh writes, `sed -i` /
155
+ `perl -i`, package installs). It is a deny-list, not a sandbox, and it does
156
+ not run in an untrusted folder, in a `-p` session, under
157
+ `roleScopedAgents: false`, or on Codex (which inherits the parent sandbox) —
158
+ staying read-only remains your duty.
145
159
  - Do not invent criteria beyond the Story's `acceptance[]` array.
146
160
  - Emit only paths, criteria text, and observed results — never secrets or raw
147
161
  credential values (security-baseline § Data Leakage & Logging).
@@ -9,6 +9,13 @@ description: >-
9
9
  audit-<lens> workflow's first-class execution path.
10
10
  effort: medium
11
11
  model: sonnet
12
+ disallowedTools: NotebookEdit
13
+ hooks:
14
+ PreToolUse:
15
+ - matcher: "Write|Edit|MultiEdit|NotebookEdit|Bash"
16
+ hooks:
17
+ - type: command
18
+ command: 'node "$CLAUDE_PROJECT_DIR/.agents/scripts/role-scope-guard.js" --role auditor'
12
19
  ---
13
20
 
14
21
  <!--
@@ -79,6 +86,13 @@ file is its standalone-agent form.
79
86
  the environment variable named by `urlEnv`, read-only, with
80
87
  `default_transaction_read_only=on` on any session you open. Never run a
81
88
  migration or any statement that writes.
89
+ - **Enforcement is partial.** The
90
+ `role-scope-guard.js` PreToolUse hook denies writes outside tempRoot and
91
+ Bash commands in named mutation classes (git/gh writes, `sed -i` /
92
+ `perl -i`, package installs). It is a deny-list, not a sandbox, and it does
93
+ not run in an untrusted folder, in a `-p` session, under
94
+ `roleScopedAgents: false`, or on Codex (which inherits the parent sandbox) —
95
+ staying read-only remains your duty.
82
96
 
83
97
  ## Scope
84
98
 
@@ -9,6 +9,7 @@ description: >-
9
9
  when delivery.routing.roleScopedAgents is enabled (the default).
10
10
  effort: medium
11
11
  model: inherit
12
+ tools: Read, Grep, Glob
12
13
  ---
13
14
 
14
15
  <!--
@@ -100,6 +101,10 @@ nothing to say about returns no findings.
100
101
 
101
102
  - Do not edit the draft, re-author `stories.json`, or persist anything. You
102
103
  evaluate and report; the caller decides.
104
+ - Your frontmatter limits you to Read, Grep and Glob, so Claude Code enforces
105
+ this read-only scope. Under `roleScopedAgents: false` you run as a generic
106
+ sub-agent with no scope; on Codex only your shell is off, and file writes
107
+ depend on the parent sandbox.
103
108
  - Do not invent findings outside your charter.
104
109
  - Emit only paths, slugs, and observed results — never secrets or raw
105
110
  credential values (security-baseline § Data Leakage & Logging).
@@ -140,7 +140,10 @@ A close after a base move re-runs only the affected tests when the
140
140
  consumer declares `project.commands.testChanged`.
141
141
 
142
142
  If it outruns the host's sync Bash ceiling, dispatch it in the
143
- **background**: its completion re-invokes you. Never spawn a task to poll or
143
+ **background** with an explicit timeout (`timeout: 7200000`, the 2-hour
144
+ maximum: [`parallel-tooling.md`](../workflows/helpers/parallel-tooling.md)
145
+ Rule 2): its completion re-invokes you; on a host stop notice re-run it once,
146
+ and a second stop is your blocked path. Never spawn a task to poll or
144
147
  `sleep`-loop against it; a waiter with a wrong condition outlives the agent.
145
148
  An exit code is never evidence a gate did work — its **output** is: read the
146
149
  envelope's per-step outcomes and credit. Redraft rounds run the scoped
@@ -0,0 +1,21 @@
1
+ <!-- GENERATED FILE — do not edit by hand.
2
+ Source of truth: .agents/workflows/audit-state-machines.md
3
+ Regenerate: node .agents/scripts/generate-lens-checklists.js
4
+ Drift is gated by: npm run docs:check
5
+ -->
6
+
7
+ # State Machine Audit — authoring checklist
8
+
9
+ > Audit implicit state machines — co-varying flags, status sidecar fields, scattered transitions, state split across systems — and report only the impossible or unhandled combinations the code can reach, each with a traced write path and a sketch of the explicit form.
10
+
11
+ Self-check your change against this lens's concerns before you ship:
12
+
13
+ - [ ] Shape: the variables move together.
14
+ - [ ] Consequence: a bad combination is reachable.
15
+ - [ ] Flags that encode one enum
16
+ - [ ] Fields valid only in some statuses
17
+ - [ ] Transitions with no single guard
18
+ - [ ] Consumers that miss a value
19
+ - [ ] One state, two stores
20
+ - [ ] Second read of the write order.
21
+ - [ ] Severity calibration.
@@ -78,7 +78,8 @@
78
78
  "delivery": {
79
79
  "execution": {
80
80
  "fullSuiteLock": true,
81
- "workloads": []
81
+ "workloads": [],
82
+ "preflightConcurrency": 1
82
83
  },
83
84
  "docsFreshness": {
84
85
  "paths": ["README.md"]
@@ -104,12 +105,7 @@
104
105
  "primeFromPath": null,
105
106
  "allowSymlinkOnWindows": false,
106
107
  "reapOnSuccess": true,
107
- "bootstrapFiles": [
108
- ".env",
109
- ".mcp.json",
110
- ".agentrc.local.json",
111
- ".agents/instructions.local.md"
112
- ]
108
+ "bootstrapFiles": [".env", ".mcp.json", ".agents/instructions.local.md"]
113
109
  },
114
110
  "quality": {
115
111
  "gates": {
@@ -130,7 +126,13 @@
130
126
  "coveragePath": "coverage/coverage-final.json",
131
127
  "captureScript": "test:coverage",
132
128
  "captureScope": "full",
133
- "timeoutMs": 600000
129
+ "timeoutMs": 600000,
130
+ "onOverBudget": "block",
131
+ "suiteOfRecord": "local",
132
+ "ciRatchetCheck": null,
133
+ "nonInputGlobs": [],
134
+ "captureHandlesConfigChanges": false,
135
+ "ownFixDeltaMaxFiles": 0
134
136
  },
135
137
  "crap": {
136
138
  "enabled": true,
@@ -216,11 +218,17 @@
216
218
  "autoRefresh": {
217
219
  "enabled": true
218
220
  },
221
+ "ratchets": {
222
+ "coveredByLint": []
223
+ },
219
224
  "requireBaselines": false
220
225
  },
221
226
  "mergeWatch": {
222
227
  "maxBudgetSeconds": 3600
223
228
  },
229
+ "close": {
230
+ "baseSync": "always"
231
+ },
224
232
  "codeReview": {
225
233
  "providers": [
226
234
  {
@@ -232,7 +240,8 @@
232
240
  "optional": true
233
241
  }
234
242
  ],
235
- "autoFixSeverity": "medium"
243
+ "autoFixSeverity": "medium",
244
+ "onNoVerdict": "report"
236
245
  },
237
246
  "refactorStage": {
238
247
  "enabled": false
@@ -241,7 +250,8 @@
241
250
  "maxRounds": 2
242
251
  },
243
252
  "feedbackLoop": {
244
- "retroProposals": false
253
+ "retroProposals": false,
254
+ "outcomeRecord": false
245
255
  },
246
256
  "ci": {
247
257
  "autoMerge": "trust-ci",
@@ -252,6 +262,9 @@
252
262
  "pullRequest": {
253
263
  "bodyTrailers": []
254
264
  },
265
+ "handoff": {
266
+ "postSeatChecks": []
267
+ },
255
268
  "routing": {
256
269
  "roleScopedAgents": true,
257
270
  "ceremonyProfile": "standard",