@pmelab/gtd 2.7.0 → 2.8.0

package/bin/gtd-loop

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-# Drives the two-beat protocol (README.md "The reference loop driver") to a
+# Drives the two-beat protocol (docs/loop.md "The reference loop driver") to a
 # human gate. Both mutators are attempted every iteration, refusal-tolerant:
 # whichever actor is actually awaited claims the turn (captures the human's
 # uncommitted edit after a halt, or the agent's own edit from the previous

package/dist/gtd.bundle.mjs

@@ -351784,6 +351784,7 @@ const parseReviewDoc = (content) => {
 const GTD_DIR = ".gtd";
 const TODO_FILE = `${GTD_DIR}/TODO.md`;
 const ARCHITECTURE_FILE = `${GTD_DIR}/ARCHITECTURE.md`;
+const PLAN_FILE = `${GTD_DIR}/PLAN.md`;
 const REVIEW_FILE = `${GTD_DIR}/REVIEW.md`;
 const FEEDBACK_FILE = `${GTD_DIR}/FEEDBACK.md`;
 const ERRORS_FILE = `${GTD_DIR}/ERRORS.md`;
@@ -351795,6 +351796,7 @@ const LEGACY_FEEDBACK_FILE = "FEEDBACK.md";
 const STEERING_FILES = {
 	todo: TODO_FILE,
 	architecture: ARCHITECTURE_FILE,
+	plan: PLAN_FILE,
 	review: REVIEW_FILE,
 	feedback: FEEDBACK_FILE,
 	errors: ERRORS_FILE,
@@ -352014,18 +352016,21 @@ const gatherEvents = (invoker) => gen(function* () {
 		const parsed = parseSubject(subjectOf$1(commit.message));
 		const isTurn = parsed.kind === "turn";
 		const isRouting = parsed.kind === "routing";
+		const routingPhase = parsed.kind === "routing" ? parsed.phase : "";
+		const turnGate = parsed.kind === "turn" ? parsed.gate : "";
 		return {
 			type: "COMMIT",
-			...isTurn ? {
+			...parsed.kind === "turn" ? {
 				turnActor: parsed.actor,
 				turnGate: parsed.gate
 			} : {},
-			isErrors: isRouting && parsed.phase === "errors",
-			isFeedback: isTurn && parsed.gate === "agentic-review" && touchedFeedback(commit.touched),
-			isPackageStart: isRouting && (parsed.phase === "planning" || parsed.phase === "package-done"),
+			isErrors: routingPhase === "errors",
+			isFeedback: turnGate === "agentic-review" && touchedFeedback(commit.touched),
+			isPackageStart: routingPhase === "planning" || routingPhase === "package-done",
 			isWorkflowCommit: isTurn || isRouting,
 			removedErrors: commit.removedErrors,
-			isHealthCheck: isRouting && parsed.phase === "health-check"
+			isHealthCheck: routingPhase === "health-check",
+			isTestsGreen: routingPhase === "tests-green"
 		};
 	});
 	const hasCommits = yield* git.hasCommits();
@@ -352058,6 +352063,7 @@ const gatherEvents = (invoker) => gen(function* () {
 	const codeDirty = entries.some((e) => !isGtdPath(e.path));
 	const todoExists = yield* fs.exists(resolve(TODO_FILE));
 	const architectureExists = yield* fs.exists(resolve(ARCHITECTURE_FILE));
+	const planExists = yield* fs.exists(resolve(PLAN_FILE));
 	const reviewPresent = yield* fs.exists(resolve(REVIEW_FILE));
 	const feedbackPresent = yield* fs.exists(resolve(FEEDBACK_FILE));
 	const errorsPresent = yield* fs.exists(resolve(ERRORS_FILE));
@@ -352073,6 +352079,7 @@ const gatherEvents = (invoker) => gen(function* () {
 	const reviewDirty = reviewTrackedAtHead && !workingTreeClean;
 	const todoCommitted = todoExists && !isUncommitted(TODO_FILE);
 	const architectureCommitted = architectureExists && !isUncommitted(ARCHITECTURE_FILE);
+	const planCommitted = planExists && !isUncommitted(PLAN_FILE);
 	const grillingDocPath = todoExists ? TODO_FILE : architectureExists ? ARCHITECTURE_FILE : void 0;
 	const grillingDocErrors = grillingDocPath ? parseOpenQuestions(yield* fs.readFileString(resolve(grillingDocPath))).errors : [];
 	const reviewDocErrors = reviewPresent ? parseReviewDoc(yield* fs.readFileString(resolve(REVIEW_FILE))).errors : [];
@@ -352101,7 +352108,7 @@ const gatherEvents = (invoker) => gen(function* () {
 		}
 		const isGrillingTurn = (message) => {
 			const parsed = parseSubject(subjectOf$1(message));
-			return parsed.kind === "turn" && (parsed.gate === "grilling" || parsed.gate === "architecting");
+			return parsed.kind === "turn" && (parsed.gate === "grilling" || parsed.gate === "architecting" || parsed.gate === "grilled");
 		};
 		const firstGrilling = currentCycle.find((c) => isGrillingTurn(c.message));
 		const lastAwaitingReview = (() => {
@@ -352141,7 +352148,7 @@ const gatherEvents = (invoker) => gen(function* () {
 			const squashCycle = squashHistory.slice(prevDoneIdx + 1, lastDoneIdxForSquash + 1);
 			const isGrillingTurnSubject = (subject) => {
 				const parsed = parseSubject(subject);
-				return parsed.kind === "turn" && (parsed.gate === "grilling" || parsed.gate === "architecting");
+				return parsed.kind === "turn" && (parsed.gate === "grilling" || parsed.gate === "architecting" || parsed.gate === "grilled");
 			};
 			const isReviewingAnchor = (subject) => {
 				const parsed = parseSubject(subject);
@@ -352176,28 +352183,23 @@ const gatherEvents = (invoker) => gen(function* () {
 	const healthCommitted = healthPresent && !isUncommitted(HEALTH_FILE);
 	let healthFixBase;
 	if (config.squash || config.learning) {
-		let firstHealthCheckHash;
-		let healthCheckCount = 0;
-		for (const commit of commitEvents) {
-			if (commit.isPackageStart || commit.removedErrors) {
-				firstHealthCheckHash = void 0;
-				healthCheckCount = 0;
-			}
-			if (commit.isHealthCheck) healthCheckCount++;
-		}
-		if (healthCheckCount > 0) {
-			let resetAt = -1;
-			for (let i = 0; i < history.length; i++) {
-				const c = commitEvents[i];
-				if (c.isPackageStart || c.removedErrors) resetAt = i;
-			}
-			for (let i = resetAt + 1; i < history.length; i++) if (commitEvents[i].isHealthCheck) {
-				firstHealthCheckHash = history[i].hash;
-				break;
+		const inHealthProcessingChain = headParsedForSquash.kind === "routing" && (headParsedForSquash.phase === "tests-green" || headParsedForSquash.phase === "learning-template" || headParsedForSquash.phase === "learning-drafted" || headParsedForSquash.phase === "learning-approved" || headParsedForSquash.phase === "squash-template" || headParsedForSquash.phase === "learning-applied" && config.squash) || headParsedForSquash.kind === "turn" && SQUASH_OR_LEARNING_TURN_GATES.has(headParsedForSquash.gate);
+		let lastTestsGreenIdx = -1;
+		for (let i = 0; i < commitEvents.length; i++) if (commitEvents[i].isTestsGreen) lastTestsGreenIdx = i;
+		const ignoredTestsGreenIdx = inHealthProcessingChain ? lastTestsGreenIdx : -1;
+		const isHealthEntryTurn = (c) => c.turnActor === "human" && c.turnGate === "health-fixing";
+		let anchorIdx = -1;
+		for (let i = 0; i < commitEvents.length; i++) {
+			const c = commitEvents[i];
+			if (c.isPackageStart || c.removedErrors || c.isTestsGreen && i !== ignoredTestsGreenIdx) {
+				anchorIdx = -1;
+				continue;
 			}
+			if (anchorIdx === -1 && (c.isHealthCheck || isHealthEntryTurn(c))) anchorIdx = i;
 		}
-		if (healthCheckCount > 0 && firstHealthCheckHash !== void 0) {
-			const healthBase = yield* git.resolveRef(`${firstHealthCheckHash}~1`).pipe(catchAll(() => succeed$3(EMPTY_TREE)));
+		if (anchorIdx !== -1) {
+			const anchorHash = history[anchorIdx].hash;
+			const healthBase = yield* git.resolveRef(`${anchorHash}~1`).pipe(catchAll(() => succeed$3(EMPTY_TREE)));
 			healthFixBase = healthBase;
 			const healthCandidateDiff = yield* git.diffRef(healthBase).pipe(catchAll(() => succeed$3("")));
 			if (healthCandidateDiff.trim().length > 0) {
@@ -352217,6 +352219,8 @@ const gatherEvents = (invoker) => gen(function* () {
 			todoCommitted,
 			architectureExists,
 			architectureCommitted,
+			planExists,
+			planCommitted,
 			packagesPresent: packages.length > 0,
 			reviewPresent,
 			feedbackPresent,
@@ -352349,6 +352353,13 @@ const SQUASH_TEMPLATE = [
 */
 const ARCHITECTURE_SEED_BANNER = "<!-- gtd: seeded from the converged product plan (.gtd/TODO.md); decide the technical/architectural questions below. -->\n\n";
 /**
+* Banner prepended to `.gtd/ARCHITECTURE.md` when it is seeded from a
+* hand-written `.gtd/PLAN.md` (the direct-to-decompose entry) — same
+* orientation role as `ARCHITECTURE_SEED_BANNER`, one phase later: the plan
+* is final, the next turn decomposes it.
+*/
+const ARCHITECTURE_PLAN_SEED_BANNER = "<!-- gtd: seeded from the final plan (.gtd/PLAN.md); decompose into ordered work packages. -->\n\n";
+/**
 * A short skeleton written by `writeLearningTemplate`, instructing the
 * learning agent to replace it with the real distilled learnings.
 */
@@ -352379,8 +352390,11 @@ const perform = (action) => gen(function* () {
 	const ensureGtdDir = fs.makeDirectory(resolve(GTD_DIR), { recursive: true }).pipe(catchAll(() => _void));
 	switch (action.kind) {
 		case "captureTurn":
-			if (yield* fs.exists(resolve(TODO_FILE))) yield* formatFile(resolve(TODO_FILE)).pipe(catchAll(() => _void));
-			if (yield* fs.exists(resolve(ARCHITECTURE_FILE))) yield* formatFile(resolve(ARCHITECTURE_FILE)).pipe(catchAll(() => _void));
+			for (const file of [
+				TODO_FILE,
+				ARCHITECTURE_FILE,
+				PLAN_FILE
+			]) if (yield* fs.exists(resolve(file))) yield* formatFile(resolve(file)).pipe(catchAll(() => _void));
 			yield* git.commitAllWithPrefix(turnSubject(action.actor, action.gate));
 			return { stop: false };
 		case "commitRouting":
@@ -352390,6 +352404,12 @@ const perform = (action) => gen(function* () {
 				yield* fs.writeFileString(resolve(ARCHITECTURE_FILE), ARCHITECTURE_SEED_BANNER + todoContent);
 				yield* fs.remove(resolve(TODO_FILE)).pipe(catchAll(() => _void));
 			}
+			if (action.seedArchitectureFromPlan === true) {
+				const planContent = yield* fs.readFileString(resolve(PLAN_FILE)).pipe(catchAll(() => succeed$3("")));
+				yield* ensureGtdDir;
+				yield* fs.writeFileString(resolve(ARCHITECTURE_FILE), ARCHITECTURE_PLAN_SEED_BANNER + planContent);
+				yield* fs.remove(resolve(PLAN_FILE)).pipe(catchAll(() => _void));
+			}
 			if (action.removeArchitecture === true) yield* fs.remove(resolve(ARCHITECTURE_FILE)).pipe(catchAll(() => _void));
 			if (action.removeReview === true) yield* fs.remove(resolve(REVIEW_FILE)).pipe(catchAll(() => _void));
 			if (action.removeFeedback === true) yield* fs.remove(resolve(FEEDBACK_FILE)).pipe(catchAll(() => _void));
@@ -352481,7 +352501,7 @@ const counterRules = {
 		incrementsOn: (e) => e.isFeedback
 	},
 	healthFixCount: {
-		resetsOn: (e) => e.isPackageStart || e.removedErrors,
+		resetsOn: (e) => e.isPackageStart || e.removedErrors || e.isTestsGreen,
 		incrementsOn: (e) => e.isHealthCheck
 	}
 };
@@ -352533,6 +352553,8 @@ const DEFAULT_PAYLOAD = {
 	todoCommitted: false,
 	architectureExists: false,
 	architectureCommitted: false,
+	planExists: false,
+	planCommitted: false,
 	packagesPresent: false,
 	reviewPresent: false,
 	feedbackPresent: false,
@@ -352594,6 +352616,52 @@ const healthFileConflictRules = [
 	{
 		isViolated: (p) => p.healthPresent && p.errorsPresent,
 		message: ".gtd/HEALTH.md + .gtd/ERRORS.md"
+	},
+	{
+		isViolated: (p) => p.healthPresent && p.todoExists,
+		message: ".gtd/HEALTH.md + .gtd/TODO.md"
+	},
+	{
+		isViolated: (p) => p.healthPresent && p.architectureExists,
+		message: ".gtd/HEALTH.md + .gtd/ARCHITECTURE.md"
+	},
+	{
+		isViolated: (p) => p.healthPresent && p.planExists,
+		message: ".gtd/HEALTH.md + .gtd/PLAN.md"
+	}
+];
+const planFileConflictRules = [
+	{
+		isViolated: (p) => p.planExists && p.todoExists,
+		message: ".gtd/PLAN.md + .gtd/TODO.md"
+	},
+	{
+		isViolated: (p) => p.planExists && p.architectureExists,
+		message: ".gtd/PLAN.md + .gtd/ARCHITECTURE.md"
+	},
+	{
+		isViolated: (p) => p.planExists && p.packagesPresent,
+		message: ".gtd/PLAN.md + packages"
+	},
+	{
+		isViolated: (p) => p.planExists && p.reviewPresent,
+		message: ".gtd/PLAN.md + .gtd/REVIEW.md"
+	},
+	{
+		isViolated: (p) => p.planExists && p.feedbackPresent,
+		message: ".gtd/PLAN.md + .gtd/FEEDBACK.md"
+	},
+	{
+		isViolated: (p) => p.planExists && p.errorsPresent,
+		message: ".gtd/PLAN.md + .gtd/ERRORS.md"
+	},
+	{
+		isViolated: (p) => p.planExists && p.squashMsgPresent,
+		message: ".gtd/PLAN.md + .gtd/SQUASH_MSG.md"
+	},
+	{
+		isViolated: (p) => p.planExists && p.learningMsgPresent,
+		message: ".gtd/PLAN.md + .gtd/LEARNINGS.md"
 	}
 ];
 const learningFileConflictRules = [
@@ -352689,6 +352757,7 @@ const assertLegal = (p) => {
 	for (const rule of [
 		...healthFileConflictRules,
 		...learningFileConflictRules,
+		...planFileConflictRules,
 		...reviewAndFeedbackRules
 	]) if (rule.isViolated(p)) throw new GtdStateError("illegal-combination", `illegal combination: ${rule.message}`);
 };
@@ -352818,6 +352887,16 @@ const classifyHead = (subject, flags) => {
 				actor: "agent"
 			};
 		}
+		if (actor === "human" && gate === "grilled") return flags.planExists ? {
+			kind: "mid-chain",
+			state: "grilled",
+			actor: "agent",
+			action: {
+				kind: "commitRouting",
+				subject: "gtd: grilled",
+				seedArchitectureFromPlan: true
+			}
+		} : null;
 		if (actor === "agent" && gate === "grilled") return flags.hasPackages ? {
 			kind: "mid-chain",
 			state: "grilled",
@@ -353064,7 +353143,11 @@ const gateForState = (state) => STATE_IS_OWN_GATE.has(state) ? state : GATE_OVER
 * (CLAUDE.md/AGENTS.md/docs), so it's unconditionally inert on a clean tree,
 * same as `building`/`fixing`. `health-fixing` is deliberately absent: its
 * empty turn is meaningful (environmental fix; the machine removes
-* HEALTH.md and re-tests).
+* HEALTH.md and re-tests) — EXCEPT while HEAD is the human's hand-written
+* HEALTH.md entry turn (`gtd(human): health-fixing`), where the loop
+* protocol's opening clean-tree `gtd step-agent` would otherwise consume the
+* human's error description before any agent read it (see
+* `isInertEmptyAgentRest`).
 */
 const INERT_EMPTY_AGENT_GATES = /* @__PURE__ */ new Set([
 	"grilling",
@@ -353077,11 +353160,20 @@ const INERT_EMPTY_AGENT_GATES = /* @__PURE__ */ new Set([
 	"learning-apply"
 ]);
 /**
+* HEAD is the human's HEALTH.md entry turn (`gtd(human): health-fixing`) —
+* the hand-written error description was just captured and no agent has
+* acted on it yet.
+*/
+const isHumanHealthEntryHead = (head) => {
+	const parsed = parseSubject(head);
+	return parsed.kind === "turn" && parsed.actor === "human" && parsed.gate === "health-fixing";
+};
+/**
 * True when a `step-agent` invocation at this rest has nothing to capture —
 * see `INERT_EMPTY_AGENT_GATES`. Shared by `applyTurnTaking` (author nothing)
 * and `predictTurn` (predict null) so the two can never disagree.
 */
-const isInertEmptyAgentRest = (state, p) => p.workingTreeClean && (INERT_EMPTY_AGENT_GATES.has(state) || state === "squashing" && p.squashMsgIsTemplate || state === "learning" && p.learningMsgIsTemplate);
+const isInertEmptyAgentRest = (state, p) => p.workingTreeClean && (INERT_EMPTY_AGENT_GATES.has(state) || state === "squashing" && p.squashMsgIsTemplate || state === "learning" && p.learningMsgIsTemplate || state === "health-fixing" && isHumanHealthEntryHead(p.lastCommitSubject));
 /**
 * The baseline decision: classify HEAD, falling through to the payload-driven
 * ladder for the rows `classifyHead` cannot resolve alone (boundary subjects,
@@ -353132,6 +353224,7 @@ const resolveBaseline = (p, counters, head, corrupt, lastTurn) => {
 	const flags = {
 		headTurnIsEmpty: p.headTurnIsEmpty,
 		hasPackages: p.packagesPresent,
+		planExists: p.planExists,
 		agenticReviewForceApproved: forceApprove,
 		squashEnabled: p.squashEnabled,
 		hasSquashBase: p.squashBase !== void 0,
@@ -353198,6 +353291,11 @@ const resolveBaseline = (p, counters, head, corrupt, lastTurn) => {
 		state: "architecting",
 		actor: "agent"
 	};
+	if (p.planExists) return {
+		kind: "rest",
+		state: "grilled",
+		actor: "human"
+	};
 	if (p.packagesPresent && p.packages.length > 0 && lastTurn?.actor === "agent" && lastTurn.gate === "building") return {
 		kind: "mid-chain",
 		state: "building",
@@ -353208,7 +353306,7 @@ const resolveBaseline = (p, counters, head, corrupt, lastTurn) => {
 			capReached: false
 		}
 	};
-	if (!p.packagesPresent && !p.reviewPresent && !p.feedbackPresent && !p.errorsPresent && !p.healthPresent && !p.todoExists && !p.architectureExists) return resolveIdleOrHealth(p);
+	if (!p.packagesPresent && !p.reviewPresent && !p.feedbackPresent && !p.errorsPresent && !p.healthPresent && !p.todoExists && !p.architectureExists && !p.planExists) return resolveIdleOrHealth(p);
 	return corrupt();
 };
 /** Boundary/idle lifecycle: no steering files, unrecognized or absent workflow HEAD. */
@@ -353233,8 +353331,8 @@ const resolveIdleOrHealth = (p) => {
 const applyTurnTaking = (p, counters, head, baseline) => {
 	const context = buildContext(p, counters);
 	const invoker = p.invoker;
-	if (invoker === "human" && !p.workingTreeClean && !p.todoCommitted && !p.architectureCommitted && !p.packagesPresent && !p.reviewPresent && !p.feedbackPresent && !p.errorsPresent && !p.healthPresent && (parseSubject(head).kind === "boundary" || head === "gtd: done")) {
-		const entryGate = p.architectureExists ? "architecting" : "grilling";
+	if (invoker === "human" && !p.workingTreeClean && !p.todoCommitted && !p.architectureCommitted && !p.planCommitted && !p.packagesPresent && !p.reviewPresent && !p.feedbackPresent && !p.errorsPresent && !p.healthCommitted && (parseSubject(head).kind === "boundary" || head === "gtd: done")) {
+		const entryGate = p.healthPresent ? "health-fixing" : p.planExists ? "grilled" : p.architectureExists ? "architecting" : "grilling";
 		return {
 			state: entryGate,
 			actor: "human",
@@ -353271,7 +353369,7 @@ const applyTurnTaking = (p, counters, head, baseline) => {
 	};
 	const healthCheckCapReached = head === "gtd: health-check" && counters.healthFixCount >= p.fixAttemptCap;
 	if (head === "gtd: health-fix" && baseline.state === "idle" || healthCheckCapReached && baseline.state === "health-fixing") {
-		const chainAfterGreenAtHealthFix = (p.squashEnabled || p.learningEnabled) && counters.healthFixCount > 0 && p.healthFixBase !== void 0;
+		const chainAfterGreenAtHealthFix = (p.squashEnabled || p.learningEnabled) && p.healthFixBase !== void 0;
 		return {
 			state: "idle",
 			actor: "agent",
@@ -353293,7 +353391,7 @@ const applyTurnTaking = (p, counters, head, baseline) => {
 		context
 	};
 	if (baseline.state === "idle" && invoker === "human") {
-		const chainAfterGreen = (p.squashEnabled || p.learningEnabled) && counters.healthFixCount > 0 && p.healthFixBase !== void 0;
+		const chainAfterGreen = (p.squashEnabled || p.learningEnabled) && p.healthFixBase !== void 0;
 		return {
 			state: "idle",
 			actor: "human",
@@ -353401,8 +353499,8 @@ const predictTurn = (events) => {
 			state: baseline.state
 		};
 	}
-	if (!payload.workingTreeClean && !payload.todoCommitted && !payload.architectureCommitted && !payload.packagesPresent && !payload.reviewPresent && !payload.feedbackPresent && !payload.errorsPresent && !payload.healthPresent && (parseSubject(head).kind === "boundary" || head === "gtd: done")) {
-		const entryGate = payload.architectureExists ? "architecting" : "grilling";
+	if (!payload.workingTreeClean && !payload.todoCommitted && !payload.architectureCommitted && !payload.planCommitted && !payload.packagesPresent && !payload.reviewPresent && !payload.feedbackPresent && !payload.errorsPresent && !payload.healthCommitted && (parseSubject(head).kind === "boundary" || head === "gtd: done")) {
+		const entryGate = payload.healthPresent ? "health-fixing" : payload.planExists ? "grilled" : payload.architectureExists ? "architecting" : "grilling";
 		return {
 			actor: "human",
 			subject: `gtd(human): ${entryGate}`,
@@ -353965,7 +354063,7 @@ var building_default = "<%~ include(\"@header\") %>\n\nBuild the package describ
 var fixing_default = "<%~ include(\"@header\") %>\n\nSpawn a **fix subagent** using model `<%= it.model %>` to apply fixes for the feedback\nbelow:\n\n1. **Work through the Feedback to address section below** — address every item\n   it lists. For test output, make the failing tests pass; for review findings,\n   satisfy each finding against the package's task specs.\n2. **Make the fix in place** — change the code to resolve the feedback. Keep the\n   change focused; do not refactor unrelated code.\n3. **Or dispute the feedback** — if a finding is wrong, empty or delete\n   `.gtd/FEEDBACK.md` instead of fixing it. The machine picks the dispute up\n   either way.\n4. **Leave every change uncommitted and finish your turn** — do **not** commit\n   or stage.\n<% if (it.context.feedbackContent.trim()) { %>\n<%~ include(\"@feedback\", { content: it.context.feedbackContent, fenceFor: it.fenceFor }) %>\n<% } %>\n\n<% if (it.tail) { %>\n<%~ include(it.tail) %>\n<% } %>\n";
 //#endregion
 //#region src/prompts/health-fixing.md
-var health_fixing_default = "<%~ include(\"@header\") %>\n\nThe idle health check failed — the repository's test suite is red outside any\nwork cycle. Spawn a **fix subagent** using model `<%= it.model %>` to repair\nit:\n\n1. **Work through the failure output below** — make the failing test command\n   pass again.\n2. **Make the fix in place** — keep the change focused; do not refactor\n   unrelated code.\n3. **If the failure does not reproduce** (or nothing needs changing), change\n   nothing and simply finish your turn — the machine re-runs the health check\n   either way.\n4. **Never create or edit any file under `.gtd/`** — in particular, do NOT\n   write `.gtd/FEEDBACK.md`. The machine removes `.gtd/HEALTH.md` itself when\n   your turn is captured.\n5. **Leave every change uncommitted and finish your turn** — do **not** commit\n   or stage.\n<% if (it.context.feedbackContent.trim()) { %>\n<%~ include(\"@feedback\", { content: it.context.feedbackContent, fenceFor: it.fenceFor }) %>\n<% } %>\n\n<% if (it.tail) { %>\n<%~ include(it.tail) %>\n<% } %>\n";
+var health_fixing_default = "<%~ include(\"@header\") %>\n\nThe repository's health gate is red outside any work cycle — either the idle\nhealth check failed, or a human hand-wrote `.gtd/HEALTH.md` describing errors\nto fix. Spawn a **fix subagent** using model `<%= it.model %>` to repair it:\n\n1. **Work through the report below** — fix the described errors and make the\n   test command pass.\n2. **Make the fix in place** — keep the change focused; do not refactor\n   unrelated code.\n3. **If the failure does not reproduce** (or nothing needs changing), change\n   nothing and simply finish your turn — the machine re-runs the health check\n   either way.\n4. **Never create or edit any file under `.gtd/`** — in particular, do NOT\n   write `.gtd/FEEDBACK.md`. The machine removes `.gtd/HEALTH.md` itself when\n   your turn is captured.\n5. **Leave every change uncommitted and finish your turn** — do **not** commit\n   or stage.\n<% if (it.context.feedbackContent.trim()) { %>\n<%~ include(\"@feedback\", { content: it.context.feedbackContent, fenceFor: it.fenceFor }) %>\n<% } %>\n\n<% if (it.tail) { %>\n<%~ include(it.tail) %>\n<% } %>\n";
 //#endregion
 //#region src/prompts/agentic-review.md
 var agentic_review_default = "<%~ include(\"@header\") %>\n\nSpawn a **reviewing subagent** using model `<%= it.model %>`. The package's task spec\nfiles and its cumulative diff are found below. The subagent must:\n\n1. **Read the task spec files** — they define the acceptance criteria. Every\n   requirement must be checked, with one exception: ignore any spec\n   requirement about files under `.gtd/` (or a root-level `TODO.md` /\n   `REVIEW.md` / `FEEDBACK.md` acting as workflow state). Those files are\n   managed by the workflow machine — created and deleted outside the\n   implementation's control — so never report a finding about their\n   presence, absence, or content.\n2. **Read the package diff** — examine every hunk to determine whether the\n   implementation satisfies the spec.\n3. **Always write `.gtd/FEEDBACK.md`**:\n   - **Fully satisfies the spec** → write an **empty** `.gtd/FEEDBACK.md` (zero bytes\n     or whitespace only). This empty file is the **approval** signal.\n   - **Does not fully satisfy** → write concrete, actionable findings anchored\n     to specific file and symbol names, grouped under short headings, so the fix\n     agent can act without re-reading the diff.\n4. **Do not edit source files and do not commit** — the reviewer only writes\n   `.gtd/FEEDBACK.md`, left uncommitted, then finishes its turn.\n<% if (it.context.packages[0]) { %>\n<%~ include(\"@package\", { pkg: it.context.packages[0], fenceFor: it.fenceFor }) %>\n<% } %><% if (it.context.refDiff && it.context.refDiff.trim()) { %>\n<%~ include(\"@diff\", { heading: \"Package diff\", diff: it.context.refDiff, fenceFor: it.fenceFor }) %>\n<% } %>\n\n<% if (it.tail) { %>\n<%~ include(it.tail) %>\n<% } %>\n";
@@ -365139,7 +365237,7 @@ const reviewWindowBase = (history) => {
 		const parsed = parseSubject(subjectOf(c.message));
 		if (parsed.kind === "routing" && parsed.phase === "reviewing" && parsed.param !== void 0) anchor = parsed.param;
 		if (parsed.kind === "routing" && parsed.phase === "awaiting-review") lastAwaitingReview = c.hash;
-		if (parsed.kind === "turn" && parsed.gate === "grilling" && firstGrilling === void 0) firstGrilling = c.hash;
+		if (parsed.kind === "turn" && (parsed.gate === "grilling" || parsed.gate === "architecting" || parsed.gate === "grilled") && firstGrilling === void 0) firstGrilling = c.hash;
 	}
 	return anchor ?? lastAwaitingReview ?? firstGrilling;
 };
@@ -365476,6 +365574,7 @@ const edgeActionHandlers = {
 	commitRouting: (a) => {
 		let msg = `commit routing as "${a.subject}"`;
 		if (a.seedArchitectureFromTodo) msg += " (seeding .gtd/ARCHITECTURE.md from .gtd/TODO.md)";
+		if (a.seedArchitectureFromPlan) msg += " (seeding .gtd/ARCHITECTURE.md from .gtd/PLAN.md)";
 		const removed = [];
 		if (a.removeArchitecture) removed.push(".gtd/ARCHITECTURE.md");
 		if (a.removeReview) removed.push(".gtd/REVIEW.md");