@pmelab/gtd 28.1.0 → 29.0.0

package/dist/workflows.mjs

@@ -77,6 +77,20 @@ const scope = async (scope, fn) => {
 		context.popScope();
 	}
 };
+/**
+* Mark the span `fn` covers as one named slice of the process. Lands no
+* commit, prefixes no step name, opens no memory scope.
+*/
+const slice = async (name, fn) => {
+	const context = ctx();
+	if (typeof context.enterSlice !== "function") return fn();
+	context.enterSlice(name);
+	try {
+		return await fn();
+	} finally {
+		context.leaveSlice?.();
+	}
+};
 const read = (path) => ctx().read(path);
 /** Every path in the tree matching `pattern` (`*` stays within a segment, `**` crosses them). */
 const glob = (pattern) => ctx().glob(pattern);
@@ -396,27 +410,6 @@ const judgeDiffShape = async (name, options) => {
 	};
 };
 const displayPath = (path) => /[\x00-\x1f\x7f-\x9f]/.test(path) ? JSON.stringify(path) : path;
-const seamReport = (shape) => {
-	const unreadable = new Set(shape.unreadable);
-	return [
-		"Seam report: the judge found the diff's shape needs a refactor first. These paths stray outside the allowlist:",
-		"",
-		...shape.strays.map((path) => `- ${displayPath(path)}${unreadable.has(path) ? " (unreadable — not judged)" : ""}`),
-		"",
-		"Landing a clean tree with `gtd land` approves this diff exactly as judged; edits are refused. To stop instead, run `gtd abandon`."
-	].join("\n");
-};
-/**
-* Rest at an approval gate `name` showing the seam report — only when
-* `shape.choice` is `refactor-first`. `land` and `reject` reach no step.
-*/
-const seamGate = async (name, shape) => {
-	if (shape.choice !== "refactor-first") return;
-	await human(name, {
-		message: seamReport(shape),
-		approve: true
-	});
-};
 //#endregion
 //#region src/flows/factory.ts
 const FACTORY = Symbol.for("@pmelab/gtd/workflow-factory");
@@ -16576,14 +16569,28 @@ const stripCodeThreads = (path, text) => {
 [...(/* @__PURE__ */ new Map([["qa", qaDescriptor], ["review", reviewDescriptor]])).keys()];
 //#endregion
 //#region src/workflow-kit/review.ts
-const collect = async (p, capture) => {
-	await p.collecting(capture);
+const collect = async (p, capture, round, requested) => {
+	await p.collecting(capture, round);
 	if (read(p.feedback) !== void 0) return "feedback";
-	if (changes().length === 0) return "signoff";
+	if (changes().length === 0) {
+		if (p.refusals.dropped !== void 0 && requested !== void 0 && requested.notes.length + requested.paths.length > 0) return refuse(p.refusals.dropped(requested));
+		return "signoff";
+	}
 	return refuse(p.refusals.unmatched);
 };
-/** A review with ticks, footnote markers and thread definitions removed: what is left is line notes. */
-const notesOf = (text) => text.replace(/^\[\^[^\]]+\]:[^\n]*(\n(?: {2,}|\t)[^\n]*|\n(?=\s*\n(?: {2,}|\t)))*/gm, "").replace(/\[\^[^\]]+\]/g, "").replace(/\[x\]/gi, "[ ]").replace(/\s+/g, " ").trim();
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* A review with ticks and THREAD footnotes (definition plus markers) removed:
+* what is left is line notes and one-shot footnotes, which the triage judges.
+*/
+const notesOf = (text) => {
+	let out = text;
+	for (const { name } of parseThreads(text)) {
+		const n = escapeRe(name);
+		out = out.replace(new RegExp(`^\\[\\^${n}\\]:[^\\n]*(\\n(?: {2,}|\\t)[^\\n]*|\\n(?=\\s*\\n(?: {2,}|\\t)))*`, "gim"), "").replace(new RegExp(`\\[\\^${n}\\]`, "gi"), "");
+	}
+	return out.replace(/\[x\]/gi, "[ ]").replace(/\s+/g, " ").trim();
+};
 /**
 * The human gate and its reply rounds: a question gets an answer inside
 * the review file and rests at the gate again, without a lap. Resolves the
@@ -16601,7 +16608,7 @@ const converse = async (p, base, collectedBefore) => {
 		}
 		requireThreadsClosed(p.file);
 		if (!hasThreadFor("agent", p.file)) return collectedAt;
-		await p.collecting(p.captures.edits(head$1()));
+		await p.collecting(p.captures.edits(head$1()), "reply");
 		collectedAt = head$1();
 		requireReplies(p.file);
 		if (!hasThreadFor("human", p.file)) return collectedAt;
@@ -16630,7 +16637,10 @@ const routeNotes = async (p, notes, r) => {
 	if (deferred.length > 0) await p.defer(deferred);
 	if (edits.length > 0) {
 		await r.close();
-		return r.outcome(await collect(p, p.captures.editNotes(r.round, edits, answeredAt)));
+		return r.outcome(await collect(p, p.captures.editNotes(r.round, edits, answeredAt), "triaged", {
+			notes: edits,
+			paths: []
+		}));
 	}
 	if (nits.length > 0) {
 		await r.close();
@@ -16661,34 +16671,47 @@ const settledAfter = (p, collectedAt) => ({
 	folded: collectedAt !== void 0 && read(p.feedback) !== void 0,
 	settled: collectedAt !== void 0 && changesSince(collectedAt).every((c) => !isCodeEdit(p, c)) && !notedSince(p, collectedAt)
 });
+const finishNotes = async (p, before, reopened, ctx) => {
+	const notes = reviewNotes(before, read(p.file) ?? "");
+	if (notes.length > 0) return routeNotes(p, notes, ctx);
+	if (reopened) return ctx.unfolded();
+	await ctx.close();
+	return ctx.outcome(await collect(p, p.captures.notes(ctx.round), "notes"));
+};
+const toOutcome = (verdict, rest) => verdict === "signoff" ? { verdict } : {
+	verdict,
+	...rest
+};
+const isReopened = (p, r) => r.settled && !r.folded && p.refusals.dropped !== void 0;
 const finish = async (p, reviewed, collectedAt) => {
 	const round = head$1();
 	const since = changesSince(reviewed);
 	const edited = since.filter((c) => isCodeEdit(p, c));
-	const baselineText = since.get(p.file)?.before ?? "";
-	const record = read(p.file) ?? "";
 	const { folded, settled } = afterCollect(p, collectedAt);
 	const noted = since.some((c) => c.path === p.file);
 	const close = () => p.close(round);
-	const outcome = (verdict) => verdict === "signoff" ? { verdict } : {
-		verdict,
+	const outcome = (verdict) => toOutcome(verdict, {
 		base: round,
 		restoreFrom: reviewed,
 		edited
-	};
+	});
 	const unfolded = async () => {
 		await close();
 		return outcome(folded ? "feedback" : "signoff");
 	};
-	const collectWith = async (capture) => {
+	const reopened = isReopened(p, {
+		settled,
+		folded
+	});
+	if (settled && !reopened || edited.length === 0 && !noted) return unfolded();
+	if (edited.length > 0) {
 		await close();
-		return outcome(await collect(p, capture));
-	};
-	if (settled || edited.length === 0 && !noted) return unfolded();
-	if (edited.length > 0) return collectWith(p.captures.edits(round));
-	const notes = reviewNotes(baselineText, record);
-	if (notes.length === 0) return collectWith(p.captures.notes(round));
-	return routeNotes(p, notes, {
+		return outcome(await collect(p, p.captures.edits(round, reopened ? reviewed : void 0), "edits", {
+			notes: [],
+			paths: edited.map((c) => c.path)
+		}));
+	}
+	return finishNotes(p, since.get(p.file)?.before ?? "", reopened, {
 		round,
 		close,
 		outcome,
@@ -16874,6 +16897,15 @@ const requireFlag = (workflow, registryPath, name, defaultOn) => {
 };
 //#endregion
 //#region src/workflows/shared/vars.ts
+/** The refactor guard's fixed list, and `seamAllow`'s default minus `.gtd/**`. */
+const testFileGlobs = [
+	"**/*.test.*",
+	"**/*.spec.*",
+	"**/*.feature",
+	"**/tests/**",
+	"**/test/**",
+	"**/__tests__/**"
+];
 const defaultFlagRegistry = "src/flags/index.ts";
 /** Process settings. */
 const defaults = {
@@ -16883,10 +16915,11 @@ const defaults = {
 	reviewNoteActionable: "0.7",
 	reviewSeverityMinP: "0.7",
 	refactorFlagPattern: "\\bGTD_FLAG_\\w+",
-	seamAllow: "**/*.test.*, **/*.spec.*, **/*.feature, **/tests/**, **/test/**, **/__tests__/**, .gtd/**",
+	seamAllow: [...testFileGlobs, ".gtd/**"].join(", "),
 	flag_naive_pass: "0",
 	flag_risk_tier: "0",
-	qualityReviews: "correctness, owasp-security, ponytail-review, test-audit, conventions, spec-challenge"
+	qualityReviews: "correctness, owasp-security, ponytail-review, test-audit, conventions, spec-challenge",
+	refactorQualityReviews: "correctness, ponytail-review, conventions"
 };
 /** Environment settings. */
 const envDefaults = {
@@ -17115,11 +17148,12 @@ const footnoteRules = `- Leave a footnote anywhere: mark the exact spot with \`[
 - The same conversation works as \`// H: <question>\` comment lines in a
   file changed in this process (\`#\`, \`--\` or \`;\` by language); the phone UI does not show them,
   and \`gtd check --open-threads\` lists the open ones`;
-const footnoteFoldIn = `- A footnote (\`[^name]\` plus its \`[^name]:\` definition) is a comment on
+const footnoteAnchor = `- A footnote (\`[^name]\` plus its \`[^name]:\` definition) is a comment on
   its exact anchor — fold it in as a mandatory concern described
   against that anchor's hunk or paragraph, never flattened into a
   whole-file remark
-- A one-shot footnote needs no reply: fold it in and DELETE it in this
+`;
+const footnoteFoldIn = `${footnoteAnchor}- A one-shot footnote needs no reply: fold it in and DELETE it in this
   same turn — marker and definition together. Never re-read a footnote
   already acted on. A one-shot footnote that asks a question becomes a
   thread instead: rewrite its definition as \`- H: <its body>\` then
@@ -17504,14 +17538,17 @@ ${fixFeedbackPrompt}
 - Leave everything uncommitted and finish your turn — do not commit
 `;
 const refactorRules = (strays, pattern) => `- Behaviour-neutral: the suite's outcome must not change
-- Change only these paths, nothing else — a test file only when it is
-  one of them:
-${strays.map((path) => `  - \`${path}\``).join("\n")}
+- Change only these paths, nothing else, and never a test file even
+  when it is one of them:
+${strays.map((path) => `  - \`${displayPath(path)}\``).join("\n")}
 - Introduce no new flag read and add no second read of an existing one:
   every match of \`${pattern}\` may move, never increase in number`;
-const refactorBuildingPrompt = (pkg, strays, pattern, reference) => `${stateFileRules}
+const withRules = (rules) => rules === void 0 ? "" : `${rules}\n`;
+const refactorBuildingPrompt = (pkg, strays, pattern, reference, feedback = false) => `${stateFileRules}
 - The package to implement is \`${pkg}\`; never delete it
-${refactorRules(strays, pattern)}
+${feedback ? `- The package carries a \`## Review feedback\` section: a human's review of the
+  last refactor. Act on it, within the rules below
+` : ""}${refactorRules(strays, pattern)}
 ${reference === void 0 ? "" : `- Reference only: \`git show ${reference} -- ${strays.map(quote).join(" ")}\` shows an
   earlier attempt at this change. Read it for ideas; never apply,
   cherry-pick or check it out — write a fresh refactor
@@ -17530,7 +17567,7 @@ verdict — identical, new-failure, or progress — or land (with or
 without an edit of your own) to accept the conservative default
 (retry the fix) with no verdict recorded.
 `;
-const healthDescribePrompt = () => `${stateFileRules}
+const healthDescribePrompt = (rules) => `${stateFileRules}
 - The only state file this turn writes is \`.gtd/ESCALATION.md\`
 - Read \`.gtd/FEEDBACK.md\` (this round's failing check output),
   earlier rounds' from history (\`git log -p -- .gtd/FEEDBACK.md\` —
@@ -17540,7 +17577,7 @@ const healthDescribePrompt = () => `${stateFileRules}
   attempts did not resolve it, and concrete suggested approaches to
   solve it
 - Never fix the code yourself — this turn only writes the document
-`;
+${withRules(rules)}`;
 const escalationSystem = () => `${escalationPersona}
 
 ${agentConduct}`;
@@ -17560,21 +17597,21 @@ Edit \`.gtd/ESCALATION.md\` with fresh instructions for the next fix
 turn, or land untouched to give it one more attempt at the same
 analysis.
 `;
-const buildFixPrompt = () => `${stateFileRules}
+const buildFixPrompt = (rules) => `${stateFileRules}
 ${fixFeedbackPrompt}
-- Leave everything uncommitted — do not commit
+${withRules(rules)}- Leave everything uncommitted — do not commit
 `;
 const finisherSystem = () => `${finisherPersona}
 
 ${agentConduct}`;
-const buildFixQualityPrompt = () => `${stateFileRules}
+const buildFixQualityPrompt = (rules) => `${stateFileRules}
 - Read \`.gtd/QUALITY.md\` — one \`## \` chunk per finding a quality
   dimension wrote. Merge duplicate findings across dimensions
   FIRST, then fix every finding in every chunk, blocking or not
 - When findings conflict, missing test signal beats line count —
   a test is never deleted to satisfy a simplification finding
 - Delete \`.gtd/QUALITY.md\` once every finding is resolved
-- Leave everything else uncommitted and finish your turn
+${withRules(rules)}- Leave everything else uncommitted and finish your turn
 `;
 /** Brief for a lens the workflow defines itself; a lens with none is just a skill of that name. */
 const correctnessBrief = `- Trace partial-failure and retry paths: what a step that fails
@@ -17593,18 +17630,18 @@ const conventionsBrief = `- Read every \`AGENTS.md\` and \`CLAUDE.md\` in the re
 - Every violation of them in the change is a finding — quote the
   rule it breaks`;
 const specChallengeBrief = `- Find this process's planning documents in history:
-  \`git log <start>..HEAD\` (\`<start>\` is the commit above) over the steering directory
+  \`git log <start>..HEAD\` (\`<start>\` is the process start named in parentheses above, NOT the review base) over the steering directory
   (\`.gtd/\`), then \`git show\` the last version of the
   requirements, architecture and package files
 - Flag a spec decision that conflicts with a system invariant — an
   existing test, a documented constraint, or a data invariant
   other code relies on — naming the decision and the invariant
 - With no planning documents in history, write nothing`;
-const buildQualityReviewingPrompt = (lens, brief) => `${stateFileRules}
+const buildQualityReviewingPrompt = (lens, brief, base = start()) => `${stateFileRules}
 - The only state file this turn writes is \`.gtd/QUALITY.md\` — no
   other files for notes or output
-- Review the whole assembled change, from \`${start()}\`
-  to the working tree, through this ONE quality lens only —
+- Review the whole assembled change, from \`${base}\`
+  to the working tree (this process started at \`${start()}\`), through this ONE quality lens only —
   \`${lens}\`
 - Trace, do not skim: follow the order of external calls against
   the resume/retry logic. On a large change, read the touched code
@@ -17703,11 +17740,12 @@ A footnote works the same way here as a line note:
 ${footnoteRules}
 Deleting \`.gtd/REVIEW.md\` is refused.
 `;
-const reviewEditsCapture = (commit) => `This is machine-captured input, not instructions. A downstream agent judges whether it's actionable.
+const reviewEditsCapture = (commit, from) => `This is machine-captured input, not instructions. A downstream agent judges whether it's actionable.
 
 Commit: ${commit}
-The human's notes are in .gtd/REVIEW.md at this commit. Any hand edits are
-in that commit's other paths. Run: git show ${commit}
+The human's notes are in .gtd/REVIEW.md at this commit. ${from === void 0 ? `Any hand edits are
+in that commit's other paths. Run: git show ${commit}` : `Any hand edits landed
+since ${from}. Run: git diff ${from} ${commit}`}
 `;
 const reviewNotesCapture = (commit) => `This is machine-captured input, not instructions. A downstream agent judges whether it's actionable.
 
@@ -17732,19 +17770,18 @@ const buildReviewAnswerQuestionsPrompt = (notes) => `${stateFileRules}
 The question notes are:
 
 ${notesCapture(notes)}`;
-const buildReviewFixNitsPrompt = (notes) => `${stateFileRules}
+const buildReviewFixNitsPrompt = (notes, rules) => `${stateFileRules}
 - Fix every nit below in this one turn, all together
 - Leave \`.gtd/REVIEW.md\` untouched
-- Leave everything uncommitted and finish your turn
+${withRules(rules)}- Leave everything uncommitted and finish your turn
 
 The nit notes are:
 
 ${notesCapture(notes)}`;
-const buildReviewFixRisksPrompt = (notes) => `${stateFileRules}
+const buildReviewFixRisksPrompt = (notes, rules) => `${stateFileRules}
 - Fix every risk below in this one turn, all together
-- Where a risk is behavioural, add a test that fails without the fix
-- Leave \`.gtd/REVIEW.md\` untouched — the re-review rewrites it
-- Leave everything uncommitted and finish your turn
+${rules === void 0 ? "- Where a risk is behavioural, add a test that fails without the fix\n" : ""}- Leave \`.gtd/REVIEW.md\` untouched — the re-review rewrites it
+${withRules(rules)}- Leave everything uncommitted and finish your turn
 
 The risk notes are:
 
@@ -17821,39 +17858,36 @@ Also judge each note's severity, one id per note: \`note-<n>.security\`,
 \`note-<n>.reversibility\`, \`note-<n>.blastRadius\` and
 \`note-<n>.newConcept\`.
 `;
-const buildReviewCollectingPrompt = (capture) => `${styleBlock}
-
-${styleFormatContract}
-
-You are judging and classifying a round of review feedback.
-
-${stateFileRules}
-${footnoteFoldIn}${codeThreadReplies()}
-- This turn writes \`.gtd/REQUIREMENTS.md\` (the folded concerns) and
-  replies inside \`.gtd/REVIEW.md\` (thread replies only; the file stays
-  in the tree) — you classify, you do not build
-- Fold every concluded thread, ticked answer and hand-edit — and each
-  \`edit\` note the capture lists, no other note — into
-  \`.gtd/REQUIREMENTS.md\` and delete the folded threads from
-  \`.gtd/REVIEW.md\`; append one \`- A:\` reply to each thread
-  whose last entry is a \`- H:\` question
-- When the capture names an answering commit, carry each answered
-  question into \`.gtd/REQUIREMENTS.md\`'s \`## Answered Questions\` as
-  \`### <the note>\` plus its answer — the lap replaces \`.gtd/REVIEW.md\`
-- Keep capture order, and carry each note's \`(tier: reason)\`
-  label into the concern folded from it
-- Nit notes were already fixed: never re-raise a fixed nit as a concern
-- Finish by running \`gtd check review .gtd/REVIEW.md\` and fix
-  what it reports
-
-The raw review material is:
-
-${capture}
-It names a commit. Work from what you already reviewed if you
-wrote today's review earlier this conversation; otherwise read
-that commit's diff yourself first.
+const closedFold = (round, target) => round === "edits" ? `- Fold every hand-edit and every note the human left that round into
+  \`${target}\`
+` : round === "notes" ? `- Fold each note that asks for a change into \`${target}\`
+` : `- Fold each \`edit\` note the capture lists, no other note, and every
+  hand-edit, into \`${target}\`
+`;
+/** `refactor` retargets the prompt at `.gtd/REFACTOR.md` and fences it to the strays. A concern outside the fence is not folded; if nothing at all is written the landing is refused, but a partly buildable round drops the rest silently. */
+const buildReviewCollectingPrompt = (capture, refactor) => {
+	const target = refactor ? ".gtd/REFACTOR.md" : ".gtd/REQUIREMENTS.md";
+	const fence = refactor ? `- The next refactor may change only these paths, and never a test file
+  or a flag read:
+${refactor.strays.map((path) => `  - \`${displayPath(path)}\``).join("\n")}
+  A concern needing any other path, a test file, a new or added flag
+  read, or a change in behaviour (that belongs to the feature, not this
+  refactor) cannot be built: do not fold it
+` : "";
+	const actionable = refactor ? `The round is actionable if the human left a note on
+\`.gtd/REVIEW.md\`, added a code comment, or hand-edited code this
+round (a sketch of what they were reaching for, re-derived from
+scratch, never final).
 
-The round is actionable if any of these hold:
+- If actionable and a concern can be built: write \`.gtd/REFACTOR.md\`.
+  Then finish
+- A round with an \`edit\` note or a hand-edit MUST write
+  \`.gtd/REFACTOR.md\`: landing without it is refused, and the only
+  way out is \`gtd abandon\`. Fold whatever can be built, and name in
+  your final message each concern left out
+- Finish without writing anything only when no \`edit\` note and no
+  hand-edit asked for a change — changing nothing is the sign-off
+` : `The round is actionable if any of these hold:
 
 - The human left a note on \`.gtd/REVIEW.md\`. A note is a mandatory
   concern below
@@ -17883,6 +17917,50 @@ actionability, and never dismiss a real note or edit as approval.
 - If not: finish without writing anything — changing nothing is
   the sign-off
 `;
+	return `${styleBlock}
+
+${styleFormatContract}
+
+You are judging and classifying a round of review feedback${refactor ? " on a\nbehaviour-neutral refactor" : ""}.
+
+${stateFileRules}
+${refactor && refactor.round !== "reply" ? footnoteAnchor : `${footnoteFoldIn}${codeThreadReplies()}`}
+${refactor ? refactor.round === "reply" ? `- This turn replies inside \`.gtd/REVIEW.md\` (thread replies only; the
+  file stays in the tree) — you classify, you do not build. Write
+  exactly one \`- A:\` reply to each thread whose last entry is a
+  \`- H:\` question, then run \`gtd check review .gtd/REVIEW.md\`
+- Fold a concluded thread into \`${target}\` only when it asks for a
+  change, then delete it from \`.gtd/REVIEW.md\`; a concluded thread
+  that asks for none is just deleted
+- Fold each one-shot footnote and note that asks for a change into
+  \`${target}\` and delete it in this same turn; praise is just deleted
+` : `- This turn writes \`${target}\` (the folded concerns) — you classify,
+  you do not build. \`.gtd/REVIEW.md\` is already closed: do not
+  recreate it or reply in it
+${closedFold(refactor.round, target)}` : `- This turn writes \`${target}\` (the folded concerns) and
+  replies inside \`.gtd/REVIEW.md\` (thread replies only; the file stays
+  in the tree) — you classify, you do not build
+- Fold every concluded thread, ticked answer and hand-edit — and each
+  \`edit\` note the capture lists, no other note — into
+  \`${target}\` and delete the folded threads from
+  \`.gtd/REVIEW.md\`; append one \`- A:\` reply to each thread
+  whose last entry is a \`- H:\` question
+`}- When the capture names an answering commit, carry each answered
+  question into \`${target}\`'s \`## Answered Questions\` as
+  \`### <the note>\` plus its answer — the lap replaces \`.gtd/REVIEW.md\`
+- Keep capture order, and carry each note's \`(tier: reason)\`
+  label into the concern folded from it
+- Nit notes were already fixed: never re-raise a fixed nit as a concern
+${fence}${refactor ? "" : "- Finish by running `gtd check review .gtd/REVIEW.md` and fix\n  what it reports\n"}
+The raw review material is:
+
+${capture}
+It names a commit. Work from what you already reviewed if you
+wrote today's review earlier this conversation; otherwise read
+that commit's diff yourself first.
+
+${actionable}`;
+};
 const scenariosPrompt = (removed) => `- When a scenario in a \`.feature\` file was added or changed since the
   base, the first chunk is \`## Scenarios\`: one pointer per such
   scenario, its note saying in plain words what behaviour it now pins
@@ -17894,7 +17972,12 @@ ${removed.map(({ path, lines }) => lines.map((a) => `    ${path} — ${a.scenari
   put its \`Weakened:\` note on a pointer of the chunk covering its
   removal
 `}`;
-const buildReviewReviewingPrompt = (base, carry, removed = []) => `${styleBlock}
+const lapRange = {
+	first: "it covers everything since the base.",
+	feedback: "it starts at the previous review's boundary, so it covers only what is new since the previous review.",
+	refactor: "it covers the whole refactor since it started, on every round."
+};
+const buildReviewReviewingPrompt = (base, lap, carry, removed = []) => `${styleBlock}
 
 ${styleFormatContract}
 
@@ -17938,8 +18021,7 @@ review the changes:
   — that parses as a second pointer, not a note
 ${scenariosPrompt(removed)}No diff is given — read the changes yourself. The range runs
 from \`${base}\` to the working tree (committed turns
-plus anything pending); on a feedback round that's the previous
-review's boundary, so it covers only what's new.
+plus anything pending); ${lapRange[lap]}
 
 ${carry === void 0 ? "" : `Carry-over: commit \`${carry}\` answered questions inline in the previous
 review (each \`A: \` line under the note it answers). Copy each answered
@@ -18037,13 +18119,15 @@ re-implement. It changed these files outside the expected set:
 ${listed(rejection.strays)}
 Start over and choose a different approach; do not rebuild the same diff.
 `}`;
-const implementBuildingPrompt = (reference, tier) => `${stateFileRules}
+const implementBuildingPrompt = (reference, tier, amend) => `${stateFileRules}
 - Read \`.gtd/REQUIREMENTS.md\`: the settled requirements for this change
-- Implement them properly, fitting the codebase's seams and conventions
-- Reference only: \`git show ${reference}\` shows an earlier naive attempt.
+${amend === true ? `- The change already exists in the tree from an earlier lap; amend it to meet
+  the re-derived requirements instead of rewriting it
+` : `- Implement them properly, fitting the codebase's seams and conventions
+`}${reference === void 0 || amend === true ? "" : `- Reference only: \`git show ${reference}\` shows an earlier naive attempt.
   Read it for ideas; never apply, cherry-pick or check it out — write
   the change fresh
-${tier === "low" ? "- Add no release flag — this change is low risk tier" : `- Put the new behaviour behind a new release flag, following the
+`}${tier === "low" ? "- Add no release flag — this change is low risk tier" : amend === true ? "- Keep the release flag the earlier lap added, if it added one; otherwise put\n  the behaviour behind a new release flag" : `- Put the new behaviour behind a new release flag, following the
   repository's flag conventions`}
 - Write the tests first, then the code that makes them pass
 - Leave \`.gtd/REQUIREMENTS.md\` in place and everything uncommitted, then
@@ -18077,6 +18161,9 @@ ${listed(strays, unreadable)}
 See them with \`git show ${reference} -- <path>\` and review by hand. Land a
 clean tree to go on to the implementation, which runs next.
 `;
+const refactorDroppedRefusal = (requested) => `gtd land: refactor-feedback: the refactor review asked for a change but .gtd/REFACTOR.md was not written, so nothing can be built from it:
+${[...requested.notes.map((n) => `  - ${n.id} (${n.anchor}): ${n.text}`), ...requested.paths.map((path) => `  - hand-edited ${path}`)].join("\n")}
+The only way out is \`gtd abandon\`, which throws away the naive pass, the refactor and its review.`;
 //#endregion
 //#region src/workflows/shared/steps.ts
 const FEEDBACK = ".gtd/FEEDBACK.md";
@@ -18084,16 +18171,17 @@ const ESCALATION = ".gtd/ESCALATION.md";
 const REQUIREMENTS = ".gtd/REQUIREMENTS.md";
 const ARCHITECTURE = ".gtd/ARCHITECTURE.md";
 const REVIEW = ".gtd/REVIEW.md";
+const REFACTOR = ".gtd/REFACTOR.md";
 const QUALITY = ".gtd/QUALITY.md";
 const planner = () => env.plannerModel ?? "";
 const coder = () => env.coderModel ?? "";
-const fixCheck = () => agentWithSkills("fix", buildFixPrompt(), {
+const fixCheck = (rules) => agentWithSkills("fix", buildFixPrompt(rules), {
 	label: "Fixing the check",
 	file: FEEDBACK,
 	model: coder(),
 	system: finisherSystem()
 });
-const describeEscalation = () => agentWithSkills("health.describe", healthDescribePrompt(), {
+const describeEscalation = (rules) => agentWithSkills("health.describe", healthDescribePrompt(rules), {
 	label: "Describing the escalation",
 	file: FEEDBACK,
 	model: coder(),
@@ -18128,14 +18216,14 @@ const builtInLenses = {
 	}
 };
 /** One quality review through `lens`; each lens is its own scope, so its own conversation and skills. */
-const reviewQuality = (lens) => agentWithSkills(`quality.${lens}.reviewing`, buildQualityReviewingPrompt(lens, builtInLenses[lens]?.brief), {
+const reviewQuality = (lens, base) => agentWithSkills(`quality.${lens}.reviewing`, buildQualityReviewingPrompt(lens, builtInLenses[lens]?.brief, base), {
 	label: "Reviewing (one quality lens)",
 	file: QUALITY,
 	model: planner(),
 	system: reviewerSystem(),
 	allowEmpty: true
 });
-const fixQuality = () => agentWithSkills("fix.quality.fixing", buildFixQualityPrompt(), {
+const fixQuality = (rules) => agentWithSkills("fix.quality.fixing", buildFixQualityPrompt(rules), {
 	label: "Fixing quality findings",
 	file: QUALITY,
 	model: coder(),
@@ -18143,7 +18231,7 @@ const fixQuality = () => agentWithSkills("fix.quality.fixing", buildFixQualityPr
 	allowEmpty: true
 });
 /** Write `.gtd/REVIEW.md` over everything since `base`, carrying the answers of commit `carry` when given. */
-const reviewing = (base, carry) => agentWithSkills("review.reviewing", buildReviewReviewingPrompt(base, carry, removedAssertions(changesSince(base))), {
+const reviewing = (base, carry, lap = "first") => agentWithSkills("review.reviewing", buildReviewReviewingPrompt(base, lap, carry, removedAssertions(changesSince(base))), {
 	label: "Reviewing",
 	file: REVIEW,
 	mode: "review",
@@ -18152,13 +18240,19 @@ const reviewing = (base, carry) => agentWithSkills("review.reviewing", buildRevi
 	base
 });
 /** Fix the `Risk:`-marked notes the reviewer named; an empty turn means the risk was judged false. */
-const fixRisks = (notes) => agentWithSkills("review.fix.risks.fixing", buildReviewFixRisksPrompt(notes), {
-	label: "Fixing the reviewer's risks",
-	file: REVIEW,
-	model: planner(),
-	system: reviewerSystem(),
-	allowEmpty: true
-});
+const fixRisks = (notes, access, rules) => {
+	const fixing = (name) => agentWithSkills(name, buildReviewFixRisksPrompt(notes, rules), {
+		label: "Fixing the reviewer's risks",
+		file: REVIEW,
+		model: planner(),
+		system: reviewerSystem(),
+		allowEmpty: true
+	});
+	return access === void 0 ? fixing("review.fix.risks.fixing") : scope({
+		name: "review.fix.risks",
+		access
+	}, () => fixing("fixing"));
+};
 const awaitReview = (base, message = buildReviewAwaitReviewMessage(base)) => human("review.await-review", {
 	message,
 	label: "Awaiting your review",
@@ -18181,28 +18275,31 @@ const baseline = (name, label = "Checking the baseline") => check(name, env.test
 	report: FEEDBACK,
 	label
 });
-const escalationSteps = {
+const escalationSteps = (rules) => ({
 	limit: 2,
-	describe: describeEscalation,
+	describe: () => describeEscalation(rules),
 	stop: escalate,
 	exhausted: escalationExhausted
-};
+});
 const guarded = (turn, guard) => async (...a) => {
 	await turn(...a);
 	guard?.();
 };
-const guardedSteps = (guard, describeGuard) => ({
-	limit: escalationSteps.limit,
-	describe: guarded(guarded(escalationSteps.describe, guard), describeGuard),
-	stop: guarded(escalationSteps.stop, guard),
-	exhausted: guarded(escalationSteps.exhausted, guard)
-});
+const guardedSteps = (guard, describeGuard, rests = true, rules) => {
+	const steps = escalationSteps(rules);
+	return {
+		limit: steps.limit,
+		describe: guarded(guarded(steps.describe, guard), describeGuard),
+		stop: guarded(steps.stop, rests ? guard : void 0),
+		exhausted: guarded(steps.exhausted, rests ? guard : void 0)
+	};
+};
 /**
 * Hand a red suite that repeated attempts could not fix to a person: an
 * agent writes `.gtd/ESCALATION.md`, a human narrows it. From the third round
 * on, the human is told the budget is spent instead.
 */
-const escalation = (count, guard) => escalation$1(count, guardedSteps(guard));
+const escalation = (count, guard, guardRests = true, rules) => escalation$1(count, guardedSteps(guard, void 0, guardRests, rules));
 /** "Is this red round the same failure as the last one?" — asked of two reports, or of nothing when one is empty. */
 const retryQuestion = (comparable) => comparable ? {
 	id: "verdict",
@@ -18245,7 +18342,7 @@ const healthy = (fix, options = {}) => healthy$1(guarded(fix, options.guard), {
 	fixesSoFar: options.fixesSoFar ?? 0,
 	sameFailure,
 	escalations: options.escalations ?? { rounds: 0 },
-	escalation: guardedSteps(options.guard, options.describeGuard)
+	escalation: guardedSteps(options.guard, options.describeGuard, options.guardRests, options.rules)
 });
 /**
 * Hold the process at `<name>.blocked` until the suite is green. `guard` runs
@@ -37583,6 +37680,7 @@ const ShippedOptions = Struct({
 	refactorFlagPattern: setting,
 	seamAllow: setting,
 	qualityReviews: setting,
+	refactorQualityReviews: setting,
 	testCommand: setting,
 	plannerModel: setting,
 	coderModel: setting
@@ -37635,13 +37733,13 @@ const REVIEW_ORIG = ".gtd/REVIEW.orig.md";
 * finding to `.gtd/QUALITY.md`. Resolves `"findings"` when that file
 * has any.
 */
-const qualityLap = (guard) => qualityLap$1(lensesOf(vars.qualityReviews ?? ""), guarded(reviewQuality, guard), QUALITY);
+const qualityLap = (guard, lenses, base) => qualityLap$1(lenses ?? lensesOf(vars.qualityReviews ?? ""), guarded((lens) => reviewQuality(lens, base), guard), QUALITY);
 /** Resolves `true` once `.gtd/QUALITY.md` is resolved, `false` when the fix cap escalated instead. */
-const fixQualityFindings = (escalations, guard) => fixFindings({
-	fix: guarded(fixQuality, guard),
+const fixQualityFindings = (escalations, guard, guardRests = true, rules) => fixFindings({
+	fix: guarded(() => fixQuality(rules), guard),
 	findings: QUALITY,
 	cap: 3,
-	escalate: () => escalation(escalations, guard)
+	escalate: () => escalation(escalations, guard, guardRests, rules)
 });
 /** `.gtd/REVIEW.md` removed at the end of a round at commit `round`. */
 const closeReview = (round) => run("review.closing", removeScript([REVIEW, REVIEW_ORIG]), {
@@ -37656,26 +37754,33 @@ const refusePendingHandOff = () => {
 * The build tail: fix (when entered red), keep green, the quality lap, then
 * `finish` — the human review, as the calling workflow runs it. `green`: the
 * caller just left the full suite green (the package loop), so no run opens it.
+* `guardRests: false` leaves the escalation's human rests unguarded.
 */
-const tail = (fixFirst, finish, green = false, guard) => scope("build", async () => {
+const tail = (fixFirst, finish, green = false, guard, lenses, guardRests = true, lensBase, rules) => scope("build", async () => {
 	const escalations = { rounds: 0 };
-	const fix = fixCheck;
+	const fix = () => fixCheck(rules);
 	const repair = async () => {
 		await guarded(fix, guard)();
 		await healthy(fix, {
 			fixesSoFar: 1,
 			escalations,
-			guard
+			guard,
+			guardRests,
+			rules
 		});
 	};
 	if (fixFirst) await repair();
 	else if (!green) await healthy(fix, {
 		escalations,
-		guard
+		guard,
+		guardRests,
+		rules
 	});
-	if (await qualityLap(guard) === "findings") if (await fixQualityFindings(escalations, guard)) await healthy(fix, {
+	if (await qualityLap(guard, lenses, lensBase) === "findings") if (await fixQualityFindings(escalations, guard, guardRests, rules)) await healthy(fix, {
 		escalations,
-		guard
+		guard,
+		guardRests,
+		rules
 	});
 	else await repair();
 	return finish(escalations);
@@ -37687,7 +37792,7 @@ const tail = (fixFirst, finish, green = false, guard) => scope("build", async ()
 */
 const handOffReview = (base, escalations, guard) => reviewToHandOff(base, {
 	file: REVIEW,
-	reviewing: guarded(reviewing, guard),
+	reviewing: guarded((b, carry) => reviewing(b, carry), guard),
 	fixRisks: guarded(fixRisks, guard),
 	keepGreen: () => healthy(fixCheck, {
 		escalations,
@@ -37704,9 +37809,7 @@ const handOffReview = (base, escalations, guard) => reviewToHandOff(base, {
 /** The tail the review and fix workflows run: ends at the hand-off review since `base`. */
 const handOffTail = (fixFirst, base, guard) => tail(fixFirst, (escalations) => handOffReview(base, escalations, guard), false, guard);
 //#endregion
-//#region src/workflows/feature/tier.ts
-/** GTD_FLAG_NAIVE_PASS, GTD_FLAG_RISK_TIER: both pinned at process start, so a mid-process flip never moves a process. */
-const riskTierOn = () => vars.flag_naive_pass === "1" && vars.flag_risk_tier === "1";
+//#region src/workflows/shared/fences.ts
 const markFenced = (text) => {
 	let fence;
 	return text.split(/\r?\n/).map((line) => {
@@ -37720,6 +37823,10 @@ const markFenced = (text) => {
 		};
 	});
 };
+//#endregion
+//#region src/workflows/feature/tier.ts
+/** GTD_FLAG_NAIVE_PASS, GTD_FLAG_RISK_TIER: both pinned at process start, so a mid-process flip never moves a process. */
+const riskTierOn = () => vars.flag_naive_pass === "1" && vars.flag_risk_tier === "1";
 const sectionLines = (text, title) => {
 	if (text === void 0) return [];
 	const heading = new RegExp(`^##[ \\t]+${title}[ \\t]*$`, "i");
@@ -37809,12 +37916,18 @@ const answerReviewQuestions = (notes) => agentWithSkills("review.answer-review-q
 	system: reviewerSystem()
 });
 /** Fix every `nit` note in one turn. */
-const fixNits = (notes) => agentWithSkills("review.fix.nits.fixing", buildReviewFixNitsPrompt(notes), {
-	label: "Fixing your nits",
-	file: REVIEW,
-	model: planner(),
-	system: reviewerSystem()
-});
+const fixNits = (notes, access, rules) => {
+	const fixing = (name) => agentWithSkills(name, buildReviewFixNitsPrompt(notes, rules), {
+		label: "Fixing your nits",
+		file: REVIEW,
+		model: planner(),
+		system: reviewerSystem()
+	});
+	return access === void 0 ? fixing("review.fix.nits.fixing") : scope({
+		name: "review.fix.nits",
+		access
+	}, () => fixing("fixing"));
+};
 /** Turn the review round `capture` describes into `.gtd/REQUIREMENTS.md`, or change nothing. */
 const collecting = (capture) => agentWithSkills("review.collecting", buildReviewCollectingPrompt(capture), {
 	label: "Collecting your feedback",
@@ -37824,6 +37937,17 @@ const collecting = (capture) => agentWithSkills("review.collecting", buildReview
 	system: reviewerSystem(),
 	allowEmpty: true
 });
+/** Turn the refactor review round `capture` describes into `.gtd/REFACTOR.md`, or change nothing. */
+const refactorCollecting = (capture, round, strays) => agentWithSkills("review.collecting", buildReviewCollectingPrompt(capture, {
+	strays,
+	round
+}), {
+	label: "Collecting your refactor feedback",
+	file: REFACTOR,
+	model: planner(),
+	system: reviewerSystem(),
+	allowEmpty: true
+});
 /** `build.review.defer`: append `notes` to `.gtd/TODO.md` as one section; the step's landing is the commit. */
 const deferNotes = (notes, round) => run("review.defer", deferNotesScript(notes, round), {
 	label: "Deferring could-notes to TODO.md",
@@ -38041,26 +38165,37 @@ const isCode$1 = (path) => path !== ".gtd" && !path.startsWith(".gtd/");
 * another planning lap, questions are answered in place, nits fixed in one
 * batch, praise dropped.
 */
-const review$1 = (base, escalations = { rounds: 0 }) => {
+const review$1 = (base, escalations = { rounds: 0 }, options = {}) => {
+	const { guard, guardRests, fixAccess, rules } = options;
+	const feedback = options.feedback ?? {
+		file: ".gtd/REQUIREMENTS.md",
+		collecting,
+		unmatched: "gtd land: no declared pattern matches the pending changes — write .gtd/REQUIREMENTS.md from the feedback, or change nothing when it asks for nothing"
+	};
 	const severities = /* @__PURE__ */ new Map();
 	let deferred = [];
 	return review$2(base, {
 		file: REVIEW,
-		feedback: REQUIREMENTS,
+		feedback: feedback.file,
 		isCode: isCode$1,
 		reviewing: (b, carry) => {
 			deferred = [];
-			return reviewing(b, carry);
+			return reviewing(b, carry, options.lap);
 		},
-		fixRisks,
-		keepGreen: () => healthy(fixCheck, { escalations }),
+		fixRisks: guarded((notes) => fixRisks(notes, fixAccess, rules), guard),
+		keepGreen: () => healthy(() => fixCheck(rules), {
+			escalations,
+			guard,
+			guardRests,
+			rules
+		}),
 		awaitReview: (b) => {
 			const notes = deferred;
 			deferred = [];
 			return notes.length > 0 ? awaitReview(b, buildReviewAwaitAfterDeferMessage(b, notes)) : awaitReview(b);
 		},
 		reviewMissing,
-		collecting,
+		collecting: feedback.collecting,
 		triage: triage$1(severities),
 		defer: (notes) => {
 			deferred = notes.map((n) => ({
@@ -38072,7 +38207,7 @@ const review$1 = (base, escalations = { rounds: 0 }) => {
 			return deferNotes(deferred, head$1());
 		},
 		answerQuestions: answerReviewQuestions,
-		fixNits,
+		fixNits: guarded((notes) => fixNits(notes, fixAccess, rules), guard),
 		close: closeReview,
 		captures: {
 			edits: reviewEditsCapture,
@@ -38090,21 +38225,44 @@ const review$1 = (base, escalations = { rounds: 0 }) => {
 		},
 		refusals: {
 			deleted: "gtd land: review-doc: .gtd/REVIEW.md was deleted — restore it, or leave a note (or edit code) to request changes.",
-			unmatched: "gtd land: no declared pattern matches the pending changes — write .gtd/REQUIREMENTS.md from the feedback, or change nothing when it asks for nothing"
+			unmatched: feedback.unmatched,
+			...feedback.dropped === void 0 ? {} : { dropped: feedback.dropped }
 		}
 	});
 };
 /** The build tail: fix (when entered red), keep green unless `green`, the quality lap, then human review since `base`. */
-const buildTail = (fixFirst, base, green = false) => tail(fixFirst, (escalations) => review$1(base, escalations), green);
+const buildTail = (fixFirst, base, green = false, options = {}) => tail(fixFirst, (escalations) => review$1(base, escalations, options), green, options.guard, options.lenses, options.guardRests, options.lensBase, options.rules);
+/**
+* Undo the human's review-round code edits. A path changed since the human
+* left it is not overwritten; requireRevert names it instead.
+*/
+const reUnwind = async (feedback) => {
+	const { base, restoreFrom, edited } = feedback;
+	await run("re-unwind", restoreScript(base, {
+		restore: edited.filter((c) => c.status !== "added").map((c) => c.path),
+		remove: edited.filter((c) => c.status === "added").map((c) => c.path)
+	}, restoreFrom), {
+		label: "Re-unwinding your review edit",
+		file: REVIEW,
+		base
+	});
+	requireRevert(edited, base);
+};
 //#endregion
 //#region src/workflows/feature/refactor.ts
-const REFACTOR_PACKAGE = ".gtd/REFACTOR.md";
+const REFACTOR_PACKAGE = REFACTOR;
 const isCode = (path) => path !== ".gtd" && !path.startsWith(".gtd/");
 const requireWithin = (allowed) => {
 	const outside = changes().map((c) => c.path).filter((path) => isCode(path) && !allowed.includes(path));
 	if (outside.length === 0) return;
 	refuse(`gtd land: refactor-scope: the refactor may change only its stray paths — revert these:\n${outside.map((path) => `  - ${path}`).join("\n")}`);
 };
+const isTestFile = (path) => testFileGlobs.some((glob) => matches(path, glob));
+const requireNoTestFiles = () => {
+	const tests = changes().map((c) => c.path).filter((path) => isCode(path) && isTestFile(path));
+	if (tests.length === 0) return;
+	refuse(`gtd land: refactor-tests: the refactor may not change a test file — revert these:\n${tests.map((path) => `  - ${path}`).join("\n")}`);
+};
 const flagExpression = (pattern) => {
 	if (pattern.trim() === "") throw new Error("gtd: refactorFlagPattern must not be blank");
 	let expression;
@@ -38146,6 +38304,8 @@ const requireNoNewFlags = (pattern, since) => {
 	if (raised.length === 0) return;
 	refuse(`gtd land: refactor-flags: the refactor may not introduce or add reads of a flag (${pattern}):\n${raised.map(([name, count]) => `  - ${name}: ${before.get(name) ?? 0} → ${count}`).join("\n")}`);
 };
+/** A test-file stray is never refactored: the implement turn still reads it in the naive tip. */
+const refactorStrays = (shape) => shape.strays.filter((path) => !isTestFile(path));
 const packageLines = (strays, pattern, reference) => [
 	"# Behaviour-neutral refactor",
 	"",
@@ -38158,7 +38318,7 @@ const packageLines = (strays, pattern, reference) => [
 	"## Rules",
 	"",
 	"- The suite's outcome must not change",
-	"- Change only the paths above; a test file only when it is one of them",
+	"- Change only the paths above, and never a test file",
 	`- Introduce no flag read and add no second read of an existing one (\`${pattern}\`)`,
 	"",
 	"## Reference",
@@ -38166,49 +38326,125 @@ const packageLines = (strays, pattern, reference) => [
 	reference === void 0 ? "None." : `Reading material only, never applied: \`git show ${reference} -- ${strays.map(quote).join(" ")}\``,
 	""
 ];
+const demoteHeadings = (text) => {
+	const marked = markFenced(text.trimEnd());
+	const lines = marked.map((m) => m.line);
+	const headings = marked.map((m) => m.fenced ? void 0 : /^(#{1,6}) /.exec(m.line)?.[1]?.length);
+	const shift = 3 - Math.min(...headings.filter((n) => n !== void 0));
+	return lines.map((line, i) => {
+		const depth = headings[i];
+		if (depth === void 0) return line;
+		return "#".repeat(Math.min(6, depth + shift)) + line.slice(depth);
+	});
+};
 const deriveScript = (lines) => `mkdir -p .gtd
 printf '%s\\n' ${lines.map(quote).join(" ")} > ${quote(REFACTOR_PACKAGE)}
 `;
-const refactorFirst = async (shape, options = {}) => {
-	if (shape.choice !== "refactor-first" || shape.unreadable.length > 0) return false;
+/** Undefined for every shape that is not a readable `refactor-first`; throws on a bad flag pattern. */
+const plan = (shape, options) => {
+	if (shape.choice !== "refactor-first" || shape.unreadable.length > 0) return void 0;
 	const pattern = vars.refactorFlagPattern ?? defaults.refactorFlagPattern;
 	const expression = flagExpression(pattern);
-	const { strays } = shape;
+	const strays = refactorStrays(shape);
+	if (strays.length === 0) return void 0;
 	const zeroLength = strays.filter((path) => countFlags(read(path) ?? "", expression, /* @__PURE__ */ new Map()));
 	if (zeroLength.length > 0) throw new Error(`gtd: refactorFlagPattern (${pattern}) produces a zero-length match in:\n${listPaths(zeroLength)}`);
-	const reference = options.reference?.trim() ? options.reference : void 0;
-	return scope({
-		name: "refactor",
-		access: { write: [...strays, ".gtd/**"] }
-	}, async () => {
-		await run("deriving", deriveScript(packageLines(strays, pattern, reference)), {
-			label: "Deriving the refactor package",
-			file: REFACTOR_PACKAGE
-		});
-		const from = head$1();
-		const guard = () => {
-			requireWithin(strays);
-			requireNoNewFlags(pattern, from);
-		};
-		await agentWithSkills("building", refactorBuildingPrompt(REFACTOR_PACKAGE, strays, pattern, reference), {
-			label: "Refactoring",
+	return {
+		pattern,
+		strays,
+		reference: options.reference?.trim() ? options.reference : void 0
+	};
+};
+const guardOf = ({ pattern, strays }, entry) => () => {
+	requireNoTestFiles();
+	requireWithin(strays);
+	requireNoNewFlags(pattern, entry);
+};
+/** Derive, build, check and close one refactor lap; `feedback` is the collected review text of the lap before. */
+const refactorLap = async (p, guard, feedback) => {
+	const { pattern, strays, reference } = p;
+	await run("deriving", deriveScript([...packageLines(strays, pattern, reference), ...feedback === void 0 ? [] : [
+		"## Review feedback",
+		"",
+		...demoteHeadings(feedback),
+		""
+	]]), {
+		label: "Deriving the refactor package",
+		file: REFACTOR_PACKAGE
+	});
+	await agentWithSkills("building", refactorBuildingPrompt(REFACTOR_PACKAGE, strays, pattern, reference, feedback !== void 0), {
+		label: "Refactoring",
+		model: coder(),
+		system: builderSystem()
+	});
+	guard();
+	await healthy(async () => {
+		await agentWithSkills("fix.suite.fixing", refactorFixPrompt(strays, pattern), {
+			label: "Fixing the check",
+			file: FEEDBACK,
 			model: coder(),
 			system: builderSystem()
 		});
 		guard();
-		await healthy(async () => {
-			await agentWithSkills("fix.suite.fixing", refactorFixPrompt(strays, pattern), {
-				label: "Fixing the check",
-				file: FEEDBACK,
-				model: coder(),
-				system: builderSystem()
-			});
-			guard();
-		}, { describeGuard: guard });
-		await run("closing", removeScript([REFACTOR_PACKAGE]), { label: "Closing out the refactor" });
+	}, {
+		describeGuard: guard,
+		rules: refactorRules(strays, pattern)
+	});
+	await run("closing", removeScript([REFACTOR_PACKAGE]), { label: "Closing out the refactor" });
+};
+const strayAccess = (strays) => ({ write: [...strays, ".gtd/**"] });
+const refactorFirst = async (shape, options = {}) => {
+	const p = plan(shape, options);
+	if (p === void 0) return false;
+	return scope({
+		name: "refactor",
+		access: strayAccess(p.strays)
+	}, async () => {
+		await refactorLap(p, guardOf(p, head$1()));
 		return true;
 	});
 };
+/**
+* `refactorFirst` plus its review, in the one `refactor` scope so the tail's
+* steps are `refactor.build.*`. A review edit re-runs the refactor, never a
+* re-plan: the collected notes ride the re-derived package. Every round
+* reviews the whole refactor since `entry`, since each lap rebuilds over it.
+*/
+const reviewedRefactor = async (shape, options = {}) => {
+	const p = plan(shape, options);
+	if (p === void 0) return false;
+	return scope({
+		name: "refactor",
+		access: strayAccess(p.strays)
+	}, async () => {
+		const entry = head$1();
+		const guard = guardOf(p, entry);
+		const feedback = {
+			file: REFACTOR_PACKAGE,
+			collecting: (capture, round) => refactorCollecting(capture, round, p.strays),
+			unmatched: "gtd land: refactor-feedback: the review feedback changed files but wrote no .gtd/REFACTOR.md — a refactor cannot act on it; revert the change, or `gtd abandon` and restart",
+			dropped: refactorDroppedRefusal
+		};
+		let collected;
+		for (;;) {
+			await refactorLap(p, guard, collected);
+			const outcome = await buildTail(false, entry, true, {
+				guard,
+				guardRests: false,
+				lenses: lensesOf(vars.refactorQualityReviews ?? ""),
+				feedback,
+				fixAccess: strayAccess(p.strays),
+				lensBase: entry,
+				rules: refactorRules(p.strays, p.pattern),
+				lap: "refactor"
+			});
+			if (outcome.verdict === "signoff") return true;
+			await reUnwind(outcome);
+			collected = read(REFACTOR_PACKAGE);
+			if (collected === void 0) throw new Error(`gtd: review feedback left no ${REFACTOR_PACKAGE}`);
+		}
+	});
+};
 //#endregion
 //#region src/workflows/feature/seam.ts
 /** Naive-pass retries after a `reject`; the next `reject` rests at `seam.steer`. */
@@ -38225,8 +38461,8 @@ const naivePass = (rejection) => agentWithSkills("naive", naivePassPrompt(reject
 	model: coder(),
 	system: builderSystem()
 });
-const implement = (reference, tier) => scope("implement", async () => {
-	await agentWithSkills("building", implementBuildingPrompt(reference, tier), {
+const implement = (reference, tier, amend) => scope("implement", async () => {
+	await agentWithSkills("building", implementBuildingPrompt(reference, tier, amend), {
 		label: "Implementing",
 		model: coder(),
 		system: builderSystem()
@@ -38247,13 +38483,10 @@ const decide = () => scope("seam", async () => {
 		const tip = kept("naive");
 		const shape = await judgeSeam(tip);
 		if (shape.choice === "land") return { reference: tip.hash };
-		if (shape.choice === "refactor-first") {
-			await seamGate("approve", shape);
-			return {
-				reference: tip.hash,
-				shape
-			};
-		}
+		if (shape.choice === "refactor-first") return {
+			reference: tip.hash,
+			shape
+		};
 		rejection = {
 			strays: shape.strays,
 			p: shape.judgment?.answers.shape?.p ?? 0
@@ -38273,14 +38506,32 @@ const decide = () => scope("seam", async () => {
 		retries = 0;
 	}
 });
-const seamBuild = async (tier) => {
+const seamBuild = async (base) => {
 	const { reference, shape } = await decide();
-	if (shape !== void 0 && !await refactorFirst(shape, { reference })) await scope("seam", () => human("by-hand", {
-		message: seamByHandMessage(shape.strays, shape.unreadable, reference),
-		label: "Reviewing unreadable files by hand",
-		acceptClean: true
-	}));
-	await implement(reference, tier);
+	if (shape === void 0) return {
+		reference,
+		base
+	};
+	if (shape.unreadable.length > 0) {
+		await scope("seam", () => human("by-hand", {
+			message: seamByHandMessage(shape.strays, shape.unreadable, reference),
+			label: "Reviewing unreadable files by hand",
+			acceptClean: true
+		}));
+		return {
+			reference,
+			base
+		};
+	}
+	if (refactorStrays(shape).length === 0) return {
+		reference,
+		base
+	};
+	await slice("refactor", () => reviewedRefactor(shape, { reference }));
+	return {
+		reference,
+		base: head$1()
+	};
 };
 //#endregion
 //#region src/workflows/feature/feature.ts
@@ -38289,44 +38540,49 @@ const unwind = () => {
 	const commit = head$1();
 	return run("unwind", revertScript(commit, FEEDBACK, unwindFailure(commit)), { label: "Unwinding your input" });
 };
-/**
-* Undo the human's review-round code edits. A path changed since the human
-* left it is not overwritten; requireRevert names it instead.
-*/
-const reUnwind = async (feedback) => {
-	const { base, restoreFrom, edited } = feedback;
-	await run("re-unwind", restoreScript(base, {
-		restore: edited.filter((c) => c.status !== "added").map((c) => c.path),
-		remove: edited.filter((c) => c.status === "added").map((c) => c.path)
-	}, restoreFrom), {
-		label: "Re-unwinding your review edit",
-		file: REVIEW,
-		base
-	});
-	requireRevert(edited, base);
-};
 /** Plan, build and review until a review round signs off; feedback re-plans from scratch. */
-const planAndBuild = async (firstBase) => {
+const planAndBuild = async (firstBase, firstLap = "first") => {
+	if (vars.flag_naive_pass === "1") return naivePlanAndBuild(firstBase);
 	let base = firstBase;
+	let lap = firstLap;
 	for (;;) {
 		await design(base);
-		const tier = riskTierOn() ? recordRisk() : void 0;
-		if (vars.flag_naive_pass === "1") await seamBuild(tier);
-		else {
-			await architecture();
-			await packages();
-		}
-		const outcome = await buildTail(false, base, true);
+		await architecture();
+		await packages();
+		const outcome = await buildTail(false, base, true, lap === "first" ? {} : { lap });
 		if (outcome.verdict === "signoff") return;
 		await reUnwind(outcome);
 		base = outcome.base;
+		lap = "feedback";
+	}
+};
+const naivePlanAndBuild = async (firstBase) => {
+	await design(firstBase);
+	const tier = riskTierOn() ? recordRisk() : void 0;
+	const seam = await seamBuild(firstBase);
+	await slice("feature", async () => {
+		await implement(seam.reference, tier);
+		await featureFeedback(await buildTail(false, seam.base, true, { lensBase: seam.base }), seam.base);
+	});
+};
+const featureFeedback = async (first, lensBase) => {
+	let outcome = first;
+	while (outcome.verdict === "feedback") {
+		await reUnwind(outcome);
+		await design(outcome.base);
+		await implement(void 0, riskTierOn() ? recordRisk() : void 0, true);
+		outcome = await buildTail(false, outcome.base, true, {
+			lap: "feedback",
+			...lensBase === void 0 ? {} : { lensBase }
+		});
 	}
 };
-/** After a tail that skipped planning: stop on sign-off, re-plan on feedback. */
+/** After a tail that skipped planning: stop on sign-off, re-plan on feedback. Opens no slice: slices cannot nest. */
 const afterTail = async (outcome) => {
 	if (outcome.verdict === "signoff") return;
+	if (vars.flag_naive_pass === "1") return featureFeedback(outcome);
 	await reUnwind(outcome);
-	await planAndBuild(outcome.base);
+	await planAndBuild(outcome.base, "feedback");
 };
 /** An ordinary start: wait at `idle`, unwind the sketch, check the baseline, then plan and build. */
 const ordinaryStart = async () => {
@@ -38348,33 +38604,40 @@ const ordinaryStart = async () => {
 const feature = shipped(ordinaryStart);
 //#endregion
 //#region src/workflows/shared/skills.ts
-const skills = (vars) => ({
-	design: ["spec-driven-development", "planning-and-task-breakdown"],
-	architecture: [
-		"api-and-interface-design",
-		"documentation-and-adrs",
-		"ponytail"
-	],
-	"architecture.decompose": ["incremental-implementation", "planning-and-task-breakdown"],
-	"packages.item": ["test-driven-development", "incremental-implementation"],
-	"packages.item.fix.suite": ["debugging-and-error-recovery"],
-	"packages.item.health": ["debugging-and-error-recovery"],
-	build: ["debugging-and-error-recovery"],
-	"build.health": ["debugging-and-error-recovery"],
-	"build.fix.quality": ["incremental-implementation", "code-simplification"],
-	"build.review": ["code-review-and-quality"],
-	"build.review.fix.nits": ["incremental-implementation", "code-simplification"],
-	"build.review.fix.risks": ["debugging-and-error-recovery", "incremental-implementation"],
-	notes: ["incremental-implementation", "code-simplification"],
-	refactor: ["ponytail"],
-	"refactor.fix.suite": ["ponytail", "debugging-and-error-recovery"],
-	"refactor.health": ["ponytail", "debugging-and-error-recovery"],
-	seam: ["incremental-implementation"],
-	implement: ["test-driven-development", "incremental-implementation"],
-	"implement.fix.suite": ["debugging-and-error-recovery"],
-	"implement.health": ["debugging-and-error-recovery"],
-	...lensScopes("build.quality", lensesOf(vars.qualityReviews ?? ""), (lens) => builtInLenses[lens]?.skills ?? [lens])
-});
+const skills = (vars) => {
+	const build = {
+		build: ["debugging-and-error-recovery"],
+		"build.health": ["debugging-and-error-recovery"],
+		"build.fix.quality": ["incremental-implementation", "code-simplification"],
+		"build.review": ["code-review-and-quality"],
+		"build.review.fix.nits": ["incremental-implementation", "code-simplification"],
+		"build.review.fix.risks": ["debugging-and-error-recovery", "incremental-implementation"]
+	};
+	return {
+		design: ["spec-driven-development", "planning-and-task-breakdown"],
+		architecture: [
+			"api-and-interface-design",
+			"documentation-and-adrs",
+			"ponytail"
+		],
+		"architecture.decompose": ["incremental-implementation", "planning-and-task-breakdown"],
+		"packages.item": ["test-driven-development", "incremental-implementation"],
+		"packages.item.fix.suite": ["debugging-and-error-recovery"],
+		"packages.item.health": ["debugging-and-error-recovery"],
+		notes: ["incremental-implementation", "code-simplification"],
+		...build,
+		...Object.fromEntries(Object.entries(build).map(([name, list]) => [`refactor.${name}`, list])),
+		refactor: ["ponytail"],
+		"refactor.fix.suite": ["ponytail", "debugging-and-error-recovery"],
+		"refactor.health": ["ponytail", "debugging-and-error-recovery"],
+		seam: ["incremental-implementation"],
+		implement: ["test-driven-development", "incremental-implementation"],
+		"implement.fix.suite": ["debugging-and-error-recovery"],
+		"implement.health": ["debugging-and-error-recovery"],
+		...lensScopes("build.quality", lensesOf(vars.qualityReviews ?? ""), (lens) => builtInLenses[lens]?.skills ?? [lens]),
+		...lensScopes("refactor.build.quality", lensesOf(vars.refactorQualityReviews ?? ""), (lens) => builtInLenses[lens]?.skills ?? [lens])
+	};
+};
 //#endregion
 //#region src/workflows/shared/access.ts
 const access = (vars) => ({
@@ -38385,7 +38648,10 @@ const access = (vars) => ({
 	"build.review.defer": { write: [".gtd/TODO.md"] },
 	"build.review.fix.nits": {},
 	"build.review.fix.risks": {},
-	...lensScopes("build.quality", lensesOf(vars.qualityReviews ?? ""), () => ({ write: [] }))
+	"refactor.build.review": { write: [".gtd/REVIEW.md"] },
+	"refactor.build.review.defer": { write: [".gtd/TODO.md"] },
+	...lensScopes("build.quality", lensesOf(vars.qualityReviews ?? ""), () => ({ write: [] })),
+	...lensScopes("refactor.build.quality", lensesOf(vars.refactorQualityReviews ?? ""), () => ({ write: [] }))
 });
 //#endregion
 //#region src/workflows/shared/reserved.ts
@@ -38531,4 +38797,4 @@ var workflows_default = feature;
 */
 const doors = {};
 //#endregion
-export { ARCHITECTURE, ESCALATION, FEEDBACK, FIX_CAP, FlagOptions, QUALITY, REFACTOR_PACKAGE, REQUIREMENTS, REVIEW, REVIEW_ORIG, ShippedOptions, access, afterTail, agentWithSkills, answerProductQuestions, answerReviewQuestions, answerTechnicalQuestions, architecture, author, awaitReview, base, baseline, build, buildTail, builtInLenses, cleanup, cleanupFlow, closeReview, coder, collecting, declaredTests, decompose, workflows_default as default, defaults, deferNotes, describeEscalation, design, doors, envDefaults, escalate, escalation, escalationExhausted, feature, fix, fixCheck, fixFlow, fixNits, fixQuality, fixQualityFindings, fixReviewNotes, fixRisks, fixSuite, gate, guarded, handOffReview, handOffTail, healthy, implement, judgeSeam, lensesOf, naivePass, nextPackage, ordinaryStart, packageItem, packages, planAndBuild, planner, qualityLap, reUnwind, refactorFirst, requireDeclaredTests, requireNoNewFlags, requireWithin, retryQuestion, review, reviewFlow, reviewMissing, reviewQuality, reviewing, rollout, rolloutFlow, seamBuild, skills, steering, summary, tail, threads, triage, unwind };
+export { ARCHITECTURE, ESCALATION, FEEDBACK, FIX_CAP, FlagOptions, QUALITY, REFACTOR, REFACTOR_PACKAGE, REQUIREMENTS, REVIEW, REVIEW_ORIG, ShippedOptions, access, afterTail, agentWithSkills, answerProductQuestions, answerReviewQuestions, answerTechnicalQuestions, architecture, author, awaitReview, base, baseline, build, buildTail, builtInLenses, cleanup, cleanupFlow, closeReview, coder, collecting, declaredTests, decompose, workflows_default as default, defaults, deferNotes, describeEscalation, design, doors, envDefaults, escalate, escalation, escalationExhausted, feature, fix, fixCheck, fixFlow, fixNits, fixQuality, fixQualityFindings, fixReviewNotes, fixRisks, fixSuite, gate, guarded, handOffReview, handOffTail, healthy, implement, judgeSeam, lensesOf, naivePass, nextPackage, ordinaryStart, packageItem, packages, planAndBuild, planner, qualityLap, reUnwind, refactorCollecting, refactorFirst, refactorStrays, requireDeclaredTests, requireNoNewFlags, requireNoTestFiles, requireWithin, retryQuestion, review, reviewFlow, reviewMissing, reviewQuality, reviewedRefactor, reviewing, rollout, rolloutFlow, seamBuild, skills, steering, summary, tail, threads, triage, unwind };