@pmelab/gtd 65.0.0 → 66.0.0

package/dist/chunks/{testkit-CgrLmpdJ.mjs → testkit-BJhAAVGt.mjs}

@@ -1,6 +1,6 @@
-import { C as moveScript, D as revertScript, E as restoreScript, H as installContext, K as markedOptions, O as showScript, S as checkScript, T as removeScript, Y as protocolMismatch, i as configure, k as writeScript$1, n as configProblems, o as isFactoryWorkflow, p as numeric, s as answered, t as flows_exports, x as applyScript } from "./flows-DGs0W3HI.mjs";
-import { A as RUN_FAILED_PATH, N as renderFormat, O as ACCESS_REFUSAL, a as renderScriptJson, d as renderLandPlain, f as DEMAND_BRIEFING, g as statusOf, h as renderBeatJson, i as judgeJson, k as PIN_PATH, l as noopText, m as beatDocument, n as resolveSession, o as scriptFields, p as renderBeatPlain, r as selectPath, s as landFields, t as globMatches, u as renderLandJson, v as beatKindOf, y as demandOf } from "./wire-BNS8ciNu.mjs";
-import { F as headingSectionBodies, I as formatFinding, a as sections, c as openThreads, d as formatFromSpec, i as sectionBodies, l as steeringFormatFor, o as threads, r as openQuestions, s as BUILT_IN_MODE_NAMES, t as parseCodeThreads, u as unansweredQuestions } from "./steering-DEh_MS40.mjs";
+import { A as revertScript, E as moveScript, G as installContext, M as writeScript$1, O as removeScript, Q as protocolMismatch, T as checkScript, Y as markedOptions, i as configure, j as showScript, k as restoreScript, n as configProblems, o as isFactoryWorkflow, p as numeric, s as answered, t as flows_exports, w as applyScript } from "./flows-CmQplvh1.mjs";
+import { A as RUN_FAILED_PATH, N as renderFormat, O as ACCESS_REFUSAL, a as renderScriptJson, d as renderLandPlain, f as DEMAND_BRIEFING, g as statusOf, h as renderBeatJson, i as judgeJson, k as PIN_PATH, l as noopText, m as beatDocument, n as resolveSession, o as scriptFields, p as renderBeatPlain, r as selectPath, s as landFields, t as globMatches, u as renderLandJson, v as beatKindOf, y as demandOf } from "./wire-xTbzFc26.mjs";
+import { F as headingSectionBodies, I as formatFinding, a as sections, c as openThreads, d as formatFromSpec, i as sectionBodies, l as steeringFormatFor, o as threads, r as openQuestions, s as BUILT_IN_MODE_NAMES, t as parseCodeThreads, u as unansweredQuestions } from "./steering-CMrePUiY.mjs";
 import { createRequire, isBuiltin } from "node:module";
 import * as Crypto from "node:crypto";
 import { createHash } from "node:crypto";
@@ -20354,7 +20354,8 @@ const orAbsent = (read) => {
 };
 const infoOf = (stats) => ({
 	type: stats.isSymbolicLink() ? "symlink" : stats.isDirectory() ? "directory" : stats.isFile() ? "file" : "other",
-	uid: process.platform === "win32" ? void 0 : stats.uid
+	uid: process.platform === "win32" ? void 0 : stats.uid,
+	...process.platform === "win32" ? {} : { executable: (stats.mode & 64) !== 0 }
 });
 const nodeSyncIo = {
 	readFile: (path) => orAbsent(() => readFileSync(path)),
@@ -20824,6 +20825,15 @@ const applyRawDiff = (tree, entries) => {
 		tree.set(entry.path, entry.newId);
 	}
 };
+/** `git ls-tree -r -z --full-tree <ref>`'s output, parsed into `path → mode`. */
+const parseLsTreeModes = (out) => {
+	const modes = /* @__PURE__ */ new Map();
+	for (const record of out.split("\0")) {
+		const tab = record.indexOf("	");
+		if (tab !== -1) modes.set(record.slice(tab + 1), record.slice(0, tab).split(" ")[0]);
+	}
+	return modes;
+};
 /** `git ls-tree -r -z --full-tree <ref>`'s output, parsed into `path → blob id`. */
 const parseLsTree = (out) => {
 	const entries = /* @__PURE__ */ new Map();
@@ -21056,6 +21066,34 @@ const makeWorkspaceOps = ({ root, pid }, git, commonDir, paths, io) => {
 		}
 		return new Map([...entries].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
 	};
+	const modeSync = (ref) => {
+		const modes = parseLsTreeModes(gitSync([
+			"ls-tree",
+			"-r",
+			"-z",
+			"--full-tree",
+			ref ?? "HEAD"
+		]));
+		if (ref !== void 0) return modes;
+		const status = gitSync([
+			"status",
+			"--porcelain=v1",
+			"-z",
+			"--untracked-files=all",
+			"--no-renames",
+			"--ignore-submodules=none"
+		]);
+		for (const record of status.split("\0")) {
+			if (record.length < 4) continue;
+			const path = record.slice(3).replace(/\/$/, "");
+			const stat = io.lstat(paths.join(root, path));
+			if (stat === void 0) modes.delete(path);
+			else if (stat.type === "symlink") modes.set(path, "120000");
+			else if (stat.type === "directory") modes.set(path, "160000");
+			else modes.set(path, stat.executable === true ? "100755" : "100644");
+		}
+		return modes;
+	};
 	/** A submodule's (or embedded repository's) checked-out commit — what `git add` records for it. */
 	const gitlinkOf = (path) => {
 		try {
@@ -21073,6 +21111,7 @@ const makeWorkspaceOps = ({ root, pid }, git, commonDir, paths, io) => {
 	return {
 		treeSync,
 		worktreeSync,
+		modeSync,
 		episodeTrees,
 		readSync,
 		read: (path) => try_({
@@ -22730,6 +22769,7 @@ while :; do
       model="$(gtd next --json=model)"
       system="$(gtd next --json=system)"
       validate="$(gtd next --json=validate)"
+      fresh="$(gtd next --json=fresh)"
       log="$(gtd next --json=log)"
       # \`model\` is a hint, not a model name — gtd-workflows' default ships
       # \`smart\` and \`base\`, which \`claude --model\` rejects. Resolve them
@@ -22772,8 +22812,14 @@ while :; do
       then first=--resume second=--session-id
       else first=--session-id second=--resume
       fi
+      # A validator retry resumes with the correction alone; a session that
+      # cannot resume starts over with \`fresh\`, the original prompt plus it.
+      second_prompt="$log.prompt"
+      if [ "$second" = --session-id ] && [ -n "\${fresh:-}" ]
+      then printf '%s\\n' "$fresh" >"$log.fresh" && second_prompt="$log.fresh"
+      fi
       turn "$first" "$session_id" <"$log.prompt" ||
-        { [ "$ran" = false ] && turn "$second" "$session_id" <"$log.prompt"; } || {
+        { [ "$ran" = false ] && turn "$second" "$session_id" <"$second_prompt"; } || {
         echo "agent turn failed — see $log" >&2
         exit 1
       }
@@ -22787,7 +22833,7 @@ while :; do
           exit 1
         }
       done
-      rm -f "$log.prompt" ;;
+      rm -f "$log.prompt" "$log.fresh" ;;
   esac
 
   # Read every value the landing needs BEFORE piping the script to \`sh\`:
@@ -23379,6 +23425,9 @@ const treeFromRecord = (files) => ({
 });
 const diffTrees$1 = (before, after) => {
 	const same = (path) => {
+		if (before.mode !== void 0 && after.mode !== void 0) {
+			if (before.mode(path) !== after.mode(path)) return false;
+		}
 		const a = before.id?.(path);
 		const b = after.id?.(path);
 		return a !== void 0 && b !== void 0 ? a === b : before.read(path) === after.read(path);
@@ -23618,7 +23667,8 @@ const formatCommitMessage = (spec) => {
 		...trailer("Anchor", spec.anchor),
 		...trailer("Branch", spec.branch),
 		...trailer("Version", spec.version),
-		`Gtd-Format: 4`
+		`Gtd-Format: 4`,
+		...trailer("Shipped", spec.shipped)
 	];
 	return `${formatSubject(spec.actor, spec.to, spec.from)}\n\n${lines.join("\n")}`;
 };
@@ -23753,7 +23803,11 @@ const KNOWN_OPTIONS = {
 		"model",
 		"system",
 		"allowEmpty",
-		"keep"
+		"keep",
+		"validate",
+		"cap",
+		"exhausted",
+		"correction"
 	]),
 	human: /* @__PURE__ */ new Set([
 		...STEERING_OPTIONS,
@@ -23765,6 +23819,18 @@ const KNOWN_OPTIONS = {
 	ship: /* @__PURE__ */ new Set(["label", "base"]),
 	judge: /* @__PURE__ */ new Set([...STEERING_OPTIONS, "message"])
 };
+const validatorOptionFault = (name, options) => {
+	const { validate, cap, exhausted, correction } = options;
+	const prefix = `gtd: step "${name}": `;
+	const notFunction = Object.entries({
+		validate,
+		exhausted,
+		correction
+	}).find(([, value]) => value !== void 0 && typeof value !== "function");
+	if (notFunction !== void 0) return `${prefix}${notFunction[0]} must be a function in agent() options`;
+	if (cap !== void 0 && !(Number.isInteger(cap) && cap > 0)) return `${prefix}cap must be a positive integer in agent() options`;
+	if (validate !== void 0 && options.keep === true) return `${prefix}validate cannot be combined with keep: true — a kept turn is set aside, so there is no landed result to validate`;
+};
 const restsOnFail = (step) => step.request.kind === "run" && step.request.options.onFail === "rest";
 const onFailFault = (step) => step.request.kind === "run" && step.request.options.onFail !== void 0 && step.request.options.onFail !== "rest" ? `gtd: step "${step.name}": onFail must be "rest" in run() options` : void 0;
 const unknownOptions = (step) => {
@@ -24093,6 +24159,8 @@ const replay = async (raw) => {
 		if (scoped(request.name).startsWith("gtd:")) return `gtd: step "${scoped(request.name)}": the "${ENGINE_PREFIX}" prefix is reserved for gtd's own beats — rename the step`;
 		if (request.kind !== "agent") return bodyFault(request);
 		const name = scoped(request.name);
+		const optionFault = validatorOptionFault(name, request.options);
+		if (optionFault !== void 0) return optionFault;
 		if (request.options.keep === true) {
 			if (request.options.allowEmpty === true) return `gtd: step "${name}": keep: true cannot be combined with allowEmpty — a turn that changes nothing has nothing to keep`;
 			const refFault = name.includes("/") ? "it contains \"/\"" : refNameFault(name);
@@ -25871,11 +25939,10 @@ const validateScriptFor = (resolved, file) => gen(function* () {
 });
 // src/step/planStep.ts
 /**
-* At the human review gate an unconditional `gtd uncheck '<file>'` runs
-* ahead of the commit, resetting every checkbox before `git add -A` picks it
-* up — a tick is read-progress, never sign-off.
+* Clear ticks at the human review gate, a tick is read-progress. Keep them when
+* the next step is an agent turn: the agent reads them.
 */
-const uncheckStep = (snapshot) => snapshot.stepDef.actor === "human" && snapshot.stepDef.mode === "review" && snapshot.file !== void 0 ? [{
+const uncheckStep = (snapshot, keepTicks) => !keepTicks && snapshot.stepDef.actor === "human" && snapshot.stepDef.mode === "review" && snapshot.file !== void 0 ? [{
 	kind: "uncheck",
 	file: snapshot.file
 }] : [];
@@ -25955,7 +26022,7 @@ const planStep = (snapshot, opts = {}) => {
 		...opts.judge !== void 0 && opts.judge.length > 0 ? { judge: opts.judge } : {}
 	});
 	const subject = message.split("\n")[0];
-	const historyRef = landing.keepHistory ?? landing.ship?.historyRef;
+	const historyRef = landing.keepHistory ?? landing.ship?.historyRef ?? landing.recordedHistory;
 	const outcome = landing.to === snapshot.state ? {
 		kind: "outcome",
 		outcome: {
@@ -25980,7 +26047,7 @@ const planStep = (snapshot, opts = {}) => {
 				kind: "switchBranch",
 				branch
 			})),
-			...uncheckStep(snapshot),
+			...uncheckStep(snapshot, landing.keepTicks === true),
 			{
 				kind: "gitWrite",
 				write: gitWriteOf(landing, message)
@@ -26534,6 +26601,7 @@ const promptDef = (common, request, skills, access) => ({
 	...optional("system", request.options.system),
 	...optional("allowEmpty", request.options.allowEmpty),
 	...optional("keep", request.options.keep),
+	...optional("original", request.original),
 	...optional("skills", skills),
 	...optional("access", access)
 });
@@ -26878,6 +26946,7 @@ const renderRest = (rest) => succeed$1({
 	...rest.shipBlocked !== void 0 ? { blocked: rest.shipBlocked } : {},
 	...rest.memory !== void 0 ? { memory: rest.memory } : {},
 	memoryResumed: rest.memoryResumed,
+	...rest.stepDef.original !== void 0 ? { original: rest.stepDef.original } : {},
 	...rest.pin !== void 0 ? { pin: rest.pin } : {}
 });
 /**
@@ -26924,7 +26993,7 @@ const cleanLanding = (rest) => {
 		settled: false
 	};
 };
-/** At the human review gate the pending tree lands with every tick cleared, as the landing script will. */
+/** At the human review gate the pending tree lands with every tick cleared; an agent-bound landing keeps them only if the unrewritten tree replays to the same step. */
 const reviewGateRewrite = (def) => {
 	const reviewFormat = steeringFormatFor("review");
 	if (!isHumanReviewGate(def) || def.file === void 0 || reviewFormat === void 0) return;
@@ -26933,6 +27002,15 @@ const reviewGateRewrite = (def) => {
 		apply: (content) => reviewFormat.clearTicks(content)
 	};
 };
+/** Whether the pending review file differs from HEAD's once both have their ticks cleared. */
+const reviewEditedBeyondTicks = (rest) => {
+	const rewrite = reviewGateRewrite(rest.stepDef);
+	if (rewrite === void 0) return false;
+	const pending = rest.setup.workspace.readSync(rewrite.path);
+	const committed = rest.setup.workspace.readCommittedSync(rewrite.path);
+	if (pending === void 0 || committed === void 0) return true;
+	return rewrite.apply(pending) !== rewrite.apply(committed);
+};
 const multilineRefusal = (vars) => {
 	const multiline = multilineSetting(vars);
 	return multiline === void 0 ? void 0 : {
@@ -27076,7 +27154,17 @@ const decideLanding = (rest, verdicts, branch, approver, shipped) => gen(functio
 	}));
 	const to = yield* landingTarget(outcome, rest);
 	if (typeof to !== "string") return to;
-	return landingTo(rest, to, branch, approver, outcomeMarks(outcome));
+	const landed = landingTo(rest, to, branch, approver, outcomeMarks(outcome));
+	if (landed.kind !== "commit" || !isHumanReviewGate(rest.stepDef) || outcome.kind !== "rest" || outcome.rest.request.kind !== "agent" || !reviewEditedBeyondTicks(rest)) return landed;
+	const ticked = yield* promise(() => replayFor(rest.setup, {
+		tree: pendingTree(rest.setup.workspace, rest.setup.pendingWorktree(), void 0),
+		...verdicts !== void 0 ? { verdicts } : {},
+		...shipped !== void 0 ? { shipped } : {}
+	}));
+	return ticked.kind === "rest" && ticked.rest.name === outcome.rest.name ? {
+		...landed,
+		keepTicks: true
+	} : landed;
 });
 /** The user's branch: `<b>` for a process on `gtd/<b>` while `<b>` still exists; any other branch as is. */
 const userBranch = (git) => gen(function* () {
@@ -27119,7 +27207,7 @@ const withHistory = (landing) => gen(function* () {
 		...out,
 		leaveBranch: back
 	};
-	if (landing.keepHistory === void 0 && landing.ship === void 0) return out;
+	if (landing.keepHistory === void 0 && landing.ship === void 0 && landing.recordedHistory === void 0) return out;
 	const remote = (yield* (yield* ConfigService).load).historyRemote;
 	return remote === void 0 ? out : {
 		...out,
@@ -27142,6 +27230,14 @@ const refusedSnapshot = (rest, message) => snapshotOf(rest, {
 });
 const SHIPPED_STAND_IN = "0".repeat(40);
 const SHIP_EXCLUDED = ".gtd/";
+/** `tree` with file modes read from `ref` (the working tree when `undefined`), for the ship decision only: reading them costs a git call. */
+const withModes = (workspace, tree, ref) => {
+	let modes;
+	return {
+		...tree,
+		mode: (path) => (modes ??= workspace.modeSync(ref)).get(path)
+	};
+};
 const shippedPaths = (before, after) => {
 	const diff = diffTrees$1(before, after);
 	return [
@@ -27174,14 +27270,15 @@ const shipTarget = (git) => gen(function* () {
 * revert. A path the working tree changed since HEAD counts as brought in:
 * whether it carries `<b>`'s change is the person's call, not a merge gtd redoes.
 */
-const revertedPaths = (git, workspace, parent, tree, changed) => gen(function* () {
+const revertedPaths = (git, workspace, parent, tree, changed, treeRef) => gen(function* () {
 	const head = yield* git.resolveRef("HEAD");
 	const shipped = parseCommitMessage(yield* git.lastCommitMessage(parent)).tip;
 	if (shipped !== void 0 && (yield* git.isAncestor(shipped, head))) return [];
 	const fork = yield* git.mergeBase(parent, head);
-	const foreign = isNone(fork) ? [...changed] : shippedPaths(commitTree(workspace, fork.value), commitTree(workspace, parent));
-	const committed = commitTree(workspace, head);
-	return foreign.filter((path) => changed.has(path) && tree.read(path) === committed.read(path));
+	const foreign = isNone(fork) ? [...changed] : shippedPaths(withModes(workspace, commitTree(workspace, fork.value), fork.value), withModes(workspace, commitTree(workspace, parent), parent));
+	const committed = withModes(workspace, commitTree(workspace, head), head);
+	const moded = withModes(workspace, tree, treeRef);
+	return foreign.filter((path) => changed.has(path) && moded.read(path) === committed.read(path) && moded.mode(path) === committed.mode(path));
 });
 /**
 * Whether landing a ship step with `tree` would ship, and onto what. The squash
@@ -27189,13 +27286,18 @@ const revertedPaths = (git, workspace, parent, tree, changed) => gen(function* (
 * branch carries a change `tree` would revert: one made since the last ship
 * (whose `Gtd-Tip` HEAD descends from), or since it forked from HEAD.
 */
-const decideShip = (workspace, tree) => gen(function* () {
+const decideShip = (workspace, tree, treeRef) => gen(function* () {
 	const git = yield* GitService;
 	const target = yield* shipTarget(git);
 	if (target.kind !== "ship") return target;
 	const { branch, parent } = target;
-	const changed = new Set(shippedPaths(commitTree(workspace, parent), tree));
-	const reverted = yield* revertedPaths(git, workspace, parent, tree, changed);
+	const changed = new Set(shippedPaths(withModes(workspace, commitTree(workspace, parent), parent), withModes(workspace, tree, treeRef)));
+	const pending = parseCommitMessage(yield* git.lastCommitMessage(parent)).tip;
+	if (changed.size === 0 && pending !== void 0 && pending === (yield* git.resolveRef("HEAD"))) return {
+		kind: "recorded",
+		hash: parent
+	};
+	const reverted = yield* revertedPaths(git, workspace, parent, tree, changed, treeRef);
 	if (reverted.length > 0) return {
 		kind: "blocked",
 		message: `gtd: ${branch} changed outside this process, and shipping would revert ${reverted.join(", ")} — bring those changes into the working tree (\`git merge --squash --no-commit ${branch}\`, or by hand) and land`
@@ -27208,16 +27310,27 @@ const decideShip = (workspace, tree) => gen(function* () {
 const shipBlockedAt = (setup, pin, step, changes) => gen(function* () {
 	if (pin !== void 0 || step.request.kind !== "ship" || changes.length > 0) return void 0;
 	const head = yield* (yield* GitService).resolveRef("HEAD");
-	const decision = yield* decideShip(setup.workspace, commitTree(setup.workspace, head));
+	const decision = yield* decideShip(setup.workspace, commitTree(setup.workspace, head), head);
 	return decision.kind === "blocked" ? decision.message : void 0;
 });
 const shipSnapshot = (rest, message, verdicts, branch, approver) => gen(function* () {
 	const tree = pendingTree(rest.setup.workspace, rest.setup.pendingWorktree(), void 0);
-	const decision = yield* decideShip(rest.setup.workspace, tree);
+	const decision = yield* decideShip(rest.setup.workspace, tree, void 0);
 	if (decision.kind === "blocked") return refusedSnapshot(rest, decision.message);
 	const shipping = decision.kind === "ship";
-	const decided = yield* decideLanding(rest, verdicts, branch, approver, shipping ? SHIPPED_STAND_IN : void 0);
+	const decided = yield* decideLanding(rest, verdicts, branch, approver, decision.kind === "recorded" ? decision.hash : shipping ? SHIPPED_STAND_IN : void 0);
 	if (decided.kind !== "commit") return snapshotOf(rest, decided);
+	if (decision.kind === "recorded") {
+		const recorded = {
+			...decided,
+			spec: {
+				...decided.spec,
+				shipped: decision.hash
+			},
+			recordedHistory: processHistoryRef(rest.run.startHash)
+		};
+		return snapshotOf(rest, yield* withBranchAndPush(recorded));
+	}
 	const landing = shipping ? {
 		...decided,
 		ship: {
@@ -28498,7 +28611,8 @@ const runRestoreCommand = (json, out) => gen(function* () {
 	if (isNone(retained)) return yield* fail$4(/* @__PURE__ */ new Error("gtd restore: no retained history to restore."));
 	const tip = retained.value;
 	const headHash = yield* git.resolveRef("HEAD");
-	const check = yield* restorability(git, headHash, tip);
+	const shippedTip = parseCommitMessage(yield* git.lastCommitMessage(headHash)).tip;
+	const check = shippedTip !== void 0 && (yield* git.isAncestor(shippedTip, tip)) ? { ok: true } : yield* restorability(git, headHash, tip);
 	if (!check.ok) return yield* fail$4(/* @__PURE__ */ new Error(`gtd restore: ${check.reason} — HEAD ${headHash.slice(0, 7)} is ahead of the retained tip ${tip.slice(0, 7)}.`));
 	const after = yield* restAt(tip);
 	const resumeOn = yield* resumeBranch(git, tip);
@@ -28734,6 +28848,18 @@ const computeStatusChanges = (changes) => changes.map((change) => ({
 }));
 /** The step the pending change would land the process at. */
 const computeNextMatch = (rest) => map(rest.changes.length === 0 ? succeed$1(void 0) : previewLanding(rest), (target) => target === void 0 ? null : { target });
+/** A validator retry's content is the correction; a session that cannot resume needs the original prompt too, and one that can hands a driver that loses it `fresh`. */
+const retryContent = (kind, rendered, resumes) => {
+	if (kind !== "prompt" || rendered.original === void 0) return { rendered };
+	const joined = `${rendered.original}\n\n${rendered.content}`;
+	return resumes ? {
+		rendered,
+		fresh: joined
+	} : { rendered: {
+		...rendered,
+		content: joined
+	} };
+};
 /** Everything one beat needs beyond the resolved rest itself, gathered once so plain/`--json` can never describe different rests for the same beat — built as `wire`'s `Demand` (what to do) and `BeatStatus` (what no driver branches on), then flattened by `beatDocument` into the one wire-shaped object plain/`--json` both render from. */
 const gatherBeatDocument = (rest, rendered) => gen(function* () {
 	const kind = restBeatKind(rest);
@@ -28741,9 +28867,11 @@ const gatherBeatDocument = (rest, rendered) => gen(function* () {
 	const resolvedValidate = kind === "prompt" ? yield* resolveValidateScript(rest).pipe(catch_(() => succeed$1(void 0))) : void 0;
 	const validate = resolvedValidate !== void 0 && resolvedValidate.script.length > 0 ? resolvedValidate.script : void 0;
 	const log = yield* loopLogPath;
+	const retry = retryContent(kind, rendered, session?.resume === true);
 	const demand = demandOf({
-		rendered,
+		rendered: retry.rendered,
 		kind,
+		...retry.fresh !== void 0 ? { fresh: retry.fresh } : {},
 		...session !== void 0 ? { session: {
 			id: session.sessionId,
 			resume: session.resume
@@ -29411,7 +29539,7 @@ The fixed answerer reads --answers and leaves out the questions it does not cove
 		arity: { name: "file" },
 		group: "Driver plumbing",
 		summary: "Untick a review file's boxes",
-		details: `Reset every ticked review box (- [x]) in <file> to - [ ], writing the file only when it changes; a missing file writes nothing. Reads no workflow and runs from any directory — the landing script at a review gate calls it, so no tick is ever committed.`
+		details: `Reset every ticked review box (- [x]) in <file> to - [ ], writing the file only when it changes; a missing file writes nothing. Reads no workflow and runs from any directory — the landing script at a review gate calls it unless the next step is an agent turn, which keeps the ticks.`
 	},
 	{
 		token: "lsp",
@@ -29961,6 +30089,9 @@ function makeHash(message, parent, tree) {
 	const treeStr = [...tree.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}:${v}`).join("\n");
 	return sha1(`${message}\n${parent ?? "null"}\n${treeStr}`);
 }
+/** An executable file's content carries this prefix inside the twin, so every tree copy keeps the mode for free; only the read edges strip it. */
+const EXEC = "\0exec\0";
+const plain = (content) => content.startsWith(EXEC) ? content.slice(6) : content;
 var InMemRepo = class InMemRepo {
 	testDouble = TEST_DOUBLE_SENTINEL;
 	commits = /* @__PURE__ */ new Map();
@@ -30219,7 +30350,8 @@ var InMemRepo = class InMemRepo {
 		if (!hash) return null;
 		const c = this.getCommit(hash);
 		if (!c) return null;
-		return c.files.get(path) ?? null;
+		const content = c.files.get(path);
+		return content === void 0 ? null : plain(content);
 	}
 	/**
 	* `base` (default HEAD) mirrors the port's own optional base. Tree-vs-worktree
@@ -30243,7 +30375,18 @@ var InMemRepo = class InMemRepo {
 	}
 	/** The worktree content of `path`, or `undefined` when absent. A LIVE read — never a snapshot. */
 	readFile(path) {
-		return this.worktree.get(path);
+		const content = this.worktree.get(path);
+		return content === void 0 ? void 0 : plain(content);
+	}
+	/** `chmod +x` / `-x` on a working-tree file. */
+	setExecutable(path, on) {
+		const content = this.readFile(path);
+		if (content !== void 0) this.worktree.set(path, on ? EXEC + content : content);
+	}
+	/** Every path's file mode at `ref`, or in the working tree when `ref` is `undefined`. */
+	modesAt(ref) {
+		const tree = ref === void 0 ? this.worktree : this.treeAt(ref);
+		return new Map([...tree].map(([path, c]) => [path, c.startsWith(EXEC) ? "100755" : "100644"]));
 	}
 	/** True when `path` is exactly a worktree file, or a directory prefix of one (any worktree key starts with `path/`). */
 	hasPath(path) {
@@ -30451,7 +30594,8 @@ var InMemRepo = class InMemRepo {
 		this.worktree = newWorktree;
 	}
 	writeFile(path, content) {
-		this.worktree.set(path, content);
+		const was = this.worktree.get(path);
+		this.worktree.set(path, was?.startsWith(EXEC) ? EXEC + content : content);
 	}
 	deleteFile(path) {
 		this.worktree.delete(path);
@@ -30679,6 +30823,7 @@ const makeInMemoryWorkspaceOps = (repo, root) => {
 		},
 		treeSync: treeOf,
 		episodeTrees: (base, commits) => succeed$1(new Map([...base !== void 0 ? [base] : [], ...commits].map((h) => [h, treeOf(h)]))),
+		modeSync: (ref) => repo.modesAt(ref),
 		worktreeSync: () => new Map(repo.pathsUnder("").filter((path) => !isGitDirKey(path)).map((path) => [path, repo.readFile(path)])),
 		atPath: (path) => readAt(toKey(path)),
 		writeAtPath: (path, content) => try_({
@@ -31605,7 +31750,7 @@ const recognizeGtdCheck = (repo, block) => {
 	};
 };
 const GTD_UNCHECK_RE = /^gtd uncheck (.+)$/;
-/** `gtd uncheck <file>` — the review-gate reset prepended ahead of the human's commit, so no tick ever reaches it. Re-runs the REAL `clearTicks`, writing back only on an actual change. */
+/** `gtd uncheck <file>` — the review-gate reset prepended ahead of the human's commit, absent when the next step is an agent turn. Re-runs the REAL `clearTicks`, writing back only on an actual change. */
 const recognizeGtdUncheck = (repo, block) => {
 	const match = GTD_UNCHECK_RE.exec(block);
 	if (!match) return void 0;

package/dist/chunks/{wire-BNS8ciNu.mjs → wire-xTbzFc26.mjs}

@@ -84,7 +84,7 @@ const stallDiagnosis = (state, actor, failure, blocked) => blocked !== void 0 ?
 * any other kind.
 */
 const demandOf = (input) => {
-	const { rendered, kind, session, validate } = input;
+	const { rendered, kind, session, validate, fresh = null } = input;
 	const content = kind === "stalled" ? stallDiagnosis(rendered.state, rendered.actor, rendered.failure, rendered.blocked) : rendered.content;
 	const skills = rendered.skills !== void 0 && rendered.skills.length > 0 ? rendered.skills : void 0;
 	const access = rendered.access ?? {
@@ -96,6 +96,7 @@ const demandOf = (input) => {
 		content,
 		session,
 		validate,
+		fresh,
 		skills,
 		access
 	};
@@ -158,6 +159,7 @@ const dispatchFieldsOf = (demand) => {
 	const none = {
 		session: void 0,
 		validate: void 0,
+		fresh: null,
 		skills: void 0,
 		access: void 0,
 		pin: void 0
@@ -167,6 +169,7 @@ const dispatchFieldsOf = (demand) => {
 			...none,
 			session: demand.session,
 			validate: demand.validate,
+			fresh: demand.fresh,
 			skills: demand.skills,
 			access: demand.access
 		};
@@ -181,13 +184,13 @@ const dispatchFieldsOf = (demand) => {
 	}
 };
 /**
-* Flatten a `Demand` plus its `BeatStatus` into the single 26-key document
+* Flatten a `Demand` plus its `BeatStatus` into the single 27-key document
 * `gtd next --json` emits — the ONLY place the two are joined. `cost`/
 * `costByModel` are omitted together, exactly when no cost was recorded
 * (`cost <= 0`).
 */
 const beatDocument = (demand, status) => {
-	const { session, validate, skills, access, pin } = dispatchFieldsOf(demand);
+	const { session, validate, fresh, skills, access, pin } = dispatchFieldsOf(demand);
 	const hasCost = status.cost > 0;
 	return {
 		schema: 1,
@@ -199,6 +202,7 @@ const beatDocument = (demand, status) => {
 		model: status.model,
 		system: status.system,
 		validate,
+		fresh,
 		pin,
 		log: status.log,
 		state: status.state,

package/dist/flows.mjs

@@ -1 +1 @@
-export { A as FLOWS_PROTOCOL, j as FlowsProtocolError, M as accessFor, N as agent, s as answered, x as applyScript, P as changes, F as changesSince, c as check, S as checkScript, l as codeChanges, I as codeThreads, r as defineConfig, a as defineWorkflow, u as displayPath, L as envSettings, R as envSettingsOf, z as glob, d as hasThreadFor, B as head, V as human, U as judge, f as judgeDiffShape, W as kept, G as mark, q as matches, C as moveScript, p as numeric, J as openQuestions, w as quote, X as read, Z as refuse, T as removeScript, m as requireAnswers, h as requireProgress, g as requireReplies, _ as requireRevert, v as requireThreadsClosed, Q as restart, E as restoreScript, D as revertScript, $ as run, et as scope, y as seamGate, tt as sectionBodies, nt as sections, rt as settings, it as settingsOf, at as ship, O as showScript, ot as skillsFor, st as start, ct as threads, lt as workflow, k as writeScript, b as wrote } from "./chunks/flows-DGs0W3HI.mjs";
+export { N as FLOWS_PROTOCOL, P as FlowsProtocolError, F as accessFor, I as agent, s as answered, w as applyScript, L as changes, R as changesSince, c as check, T as checkScript, l as codeChanges, z as codeThreads, r as defineConfig, a as defineWorkflow, u as displayPath, B as envSettings, V as envSettingsOf, H as glob, d as hasThreadFor, U as head, W as human, K as judge, f as judgeDiffShape, q as kept, J as mark, X as matches, E as moveScript, p as numeric, Z as openQuestions, m as progressErrors, D as quote, $ as read, et as refuse, O as removeScript, h as repliesErrors, g as requireAnswers, _ as requireProgress, v as requireReplies, y as requireRevert, b as requireThreadsClosed, tt as restart, k as restoreScript, x as revertErrors, A as revertScript, nt as run, rt as scope, S as seamGate, it as sectionBodies, at as sections, ot as settings, st as settingsOf, ct as ship, j as showScript, lt as skillsFor, ut as start, dt as threads, ft as workflow, M as writeScript, C as wrote } from "./chunks/flows-CmQplvh1.mjs";