@webappwiz/arbor 0.0.19 → 0.0.20

package/README.md

@@ -137,7 +137,8 @@ in silence: it is the one thing that makes the work resumable.
 
 A `ARBOR.md` that is there gets checked against the shape the agent skill
 prescribes (`# <task>`, `## Goal`, `## Next` with something unchecked in it, a
-`## Blocked` question once escalated), and anything off is printed under it.
+`## Blocked` with `- [ ] Q1.` items once escalated, and none left open after),
+and anything off is printed under it.
 Warnings only, never a refusal: the agent that wrote the file is the one that
 runs `show` on it, and a rough plan still beats none.
 

package/index.js

@@ -227,6 +227,8 @@ import { Markdown } from "webappwiz/md";
 var SECTIONS = ["Goal", "Files", "Done", "Next", "Notes", "Blocked"];
 var REQUIRED = ["Goal", "Files", "Next"];
 var UNCHECKED = /^[ \t]*- \[ \]/m;
+var QUESTION = /^[ \t]*- \[[ xX]\] Q\d+\./m;
+var OPEN_QUESTION = /^[ \t]*- \[ \] (Q\d+)\./gm;
 function checkPlan(text, { task, escalated = false }) {
   const md = Markdown.parse(text);
   const problems = [];
@@ -255,10 +257,15 @@ function checkPlan(text, { task, escalated = false }) {
   }
   const blocked = section("Blocked");
   if (escalated && blocked === null) {
-    problems.push("escalated with no ## Blocked section: state what needs verifying and the question a human must answer");
+    problems.push("escalated with no ## Blocked section: add `- [ ] Q1.` items for what the reviewer must do");
   }
-  if (blocked !== null && !blocked.includes("?")) {
-    problems.push("## Blocked asks nothing: a human needs one specific question to answer");
+  if (blocked !== null && !QUESTION.test(blocked)) {
+    problems.push("## Blocked lists nothing: add `- [ ] Q1.` items for what the reviewer must do");
+  }
+  const open = blocked === null ? [] : [...blocked.matchAll(OPEN_QUESTION)];
+  if (!escalated && open.length > 0) {
+    const numbers = open.map((match) => match[1]).join(", ");
+    problems.push(`## Blocked has open ${numbers}: ask the reviewer before merging`);
   }
   const known = SECTIONS.map((section2) => section2.toLowerCase());
   for (const section2 of md.sections) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webappwiz/arbor",
-	"version": "0.0.19",
+	"version": "0.0.20",
 	"description": "Runs several AI coding agents on one repository at once, each in its own git worktree",
 	"license": "MIT",
 	"author": "Jared Johnson",
@@ -17,7 +17,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"webappwiz": "^0.0.19",
+		"webappwiz": "^0.0.20",
 		"zod": "^4.4.3"
 	},
 	"main": "./index.js",