@pmelab/gtd 27.8.0 → 27.9.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gtd",
-  "version": "27.8.0",
+  "version": "27.9.0",
   "description": "Drive the gtd loop inside Claude Code: agent turns run as subagents, gtd decides every beat",
   "author": {
     "name": "Philipp Melab"

package/README.md

@@ -662,10 +662,15 @@ install for any of these but `./testkit`: gtd resolves a `gtd.config.ts`'s
 `@pmelab/gtd/*` imports to its own copy.
 
 The `gtd` bin's commands — `next`, `land`, `abandon`, `restore`, `validate`,
-`check`, `uncheck`, `install`, `summary`, `base`, `door`, `doors`, `version`,
-`help`, `history list`, `history show`, `history fetch`, `strays`, and the tools
-`ui`, `lsp`, `loop` and `judge` (`judge answer`, `judge run`) — are listed in
-the [CLI reference](https://github.com/pmelab/gtd/blob/main/docs/cli.md).
+`check`, `uncheck`, `install`, `summary`, `base`, `door`, `doors`, `slices`,
+`version`, `help`, `history list`, `history show`, `history fetch`, `strays`,
+and the tools `ui`, `lsp`, `loop`, `judge` (`judge answer`, `judge run`) — are
+listed in the
+[CLI reference](https://github.com/pmelab/gtd/blob/main/docs/cli.md).
+`gtd slices` lists the spans a flow's `slice()` calls mark. It refuses (exit 1)
+when HEAD neither closes nor sits inside a process, or when today's config
+disagrees with history about the process; a version mismatch only warns on
+stderr.
 
 ## License
 

package/dist/chunks/{wire-C12dahrH.mjs → wire-D3Rc5r22.mjs}

@@ -475,4 +475,17 @@ const compile = (glob) => {
 };
 const globMatches = (path, glob) => compile(glob).test(path);
 //#endregion
-export { EXIT_SIGTERM as C, UNATTRIBUTED_MODEL as D, ACCESS_REFUSAL as E, WIRE_SCHEMA as O, EXIT_SIGINT as S, EXIT_USAGE_ERROR as T, demandOf as _, landFields as a, EXIT_OK as b, renderLandJson as c, renderBeatPlain as d, beatDocument as f, beatKindOf as g, BEAT_KINDS as h, judgeJson as i, renderFormat as k, renderLandPlain as l, statusOf as m, resolveSession as n, landProseText as o, renderBeatJson as p, selectPath as r, noopText as s, globMatches as t, DEMAND_BRIEFING as u, stallDiagnosis as v, EXIT_STRAYS_FOUND as w, EXIT_RUNTIME_ERROR as x, EXIT_CODES as y };
+//#region src/wire/Slices.ts
+/** The ONLY place `gtd slices --json`'s shape is built; copies exactly the four fields, in order. */
+const slicesDocument = (slices) => ({
+	schema: 1,
+	slices: slices.map(({ name, base, tip, closed }) => ({
+		name,
+		base,
+		tip,
+		closed
+	}))
+});
+const renderSlicesJson = (document) => JSON.stringify(document) + "\n";
+//#endregion
+export { WIRE_SCHEMA as A, EXIT_RUNTIME_ERROR as C, EXIT_USAGE_ERROR as D, EXIT_STRAYS_FOUND as E, ACCESS_REFUSAL as O, EXIT_OK as S, EXIT_SIGTERM as T, BEAT_KINDS as _, selectPath as a, stallDiagnosis as b, landProseText as c, renderLandPlain as d, DEMAND_BRIEFING as f, statusOf as g, renderBeatJson as h, resolveSession as i, renderFormat as j, UNATTRIBUTED_MODEL as k, noopText as l, beatDocument as m, slicesDocument as n, judgeJson as o, renderBeatPlain as p, globMatches as r, landFields as s, renderSlicesJson as t, renderLandJson as u, beatKindOf as v, EXIT_SIGINT as w, EXIT_CODES as x, demandOf as y };

package/dist/gtd.bundle.mjs

@@ -37652,6 +37652,22 @@ var init_Glob = __esmMin((() => {
 	globMatches = (path, glob) => compile(glob).test(path);
 }));
 //#endregion
+//#region src/wire/Slices.ts
+var slicesDocument, renderSlicesJson;
+var init_Slices = __esmMin((() => {
+	init_constants();
+	slicesDocument = (slices) => ({
+		schema: 1,
+		slices: slices.map(({ name, base, tip, closed }) => ({
+			name,
+			base,
+			tip,
+			closed
+		}))
+	});
+	renderSlicesJson = (document) => JSON.stringify(document) + "\n";
+}));
+//#endregion
 //#region src/wire/index.ts
 var init_wire = __esmMin((() => {
 	init_constants();
@@ -37666,6 +37682,7 @@ var init_wire = __esmMin((() => {
 	init_Select();
 	init_Sessions();
 	init_Glob();
+	init_Slices();
 }));
 //#endregion
 //#region src/replay/RefName.ts
@@ -37867,7 +37884,7 @@ const TRAILER_READERS = {
 		if (value !== "") into.branch ??= value;
 	},
 	"Gtd-Version": (value, into) => {
-		if (value !== "") into.version ??= value;
+		if (value !== "" && !/[\u0000-\u001f\u007f-\u009f]/.test(value)) into.version ??= value;
 	},
 	"Gtd-Kept": (value, into) => {
 		if (HASH_RE.test(value)) into.kept ??= value;
@@ -38305,7 +38322,8 @@ const replay = async (input) => {
 		via,
 		trace,
 		landed,
-		marks
+		marks,
+		slices: slices.map((s) => ({ ...s }))
 	};
 	const changesSince = (hash) => {
 		const tree = treeAt(hash);
@@ -39746,22 +39764,14 @@ const runAtTip = (git, def, tip) => gen(function* () {
 	if (closing.length === 0) closing = yield* git.commitHistory(void 0, tip.hash);
 	return yield* runOf([...before, ...closing], { ...location }, tip.hash);
 });
+const runAtHead = (git, def) => gen(function* () {
+	return yield* runAtTip(git, def, (yield* git.subjectHistory(1, 0))[0]);
+});
 /** The process HEAD closes or sits inside — `gtd summary`'s run. */
 const summaryRun = gen(function* () {
 	const git = yield* GitService;
 	const def = (yield* (yield* ConfigService).load).workflow;
-	return yield* runAtTip(git, def, (yield* git.subjectHistory(1, 0))[0]);
-});
-/** The process whose finishing commit is `tip` — reads from `tip`'s own ancestry, so it works when no branch reaches it. */
-const closedRunAt = (tip) => gen(function* () {
-	const git = yield* GitService;
-	const def = (yield* (yield* ConfigService).load).workflow;
-	const hash = yield* git.resolveRef(tip);
-	const subject = yield* git.lastCommitSubject(hash);
-	return yield* runAtTip(git, def, {
-		hash,
-		subject
-	});
+	return yield* runAtHead(git, def);
 });
 const commitTree = (workspace, hash) => {
 	let entries;
@@ -40090,12 +40100,54 @@ const restAt = (ref, startOverrides = {}) => gen(function* () {
 			total: run.costEntries.reduce((sum, entry) => sum + entry.cost, 0),
 			byModel: costByModel(run.costEntries)
 		},
-		setup,
-		slices: sliceRangesOf(outcome.slices, run)
+		setup
 	};
 });
 const currentRest = restAt(void 0);
 /**
+* The slices of the process HEAD closes or sits inside, current episode only,
+* stack order. Reads like `historyTrail`, never `restAt`: it narrates and
+* writes nothing, and returns a version warning for a closed run.
+*/
+const processSlices = gen(function* () {
+	const git = yield* GitService;
+	const config = yield* (yield* ConfigService).load;
+	const workspace = yield* Workspace;
+	const host = yield* Host;
+	const run = yield* runAtHead(git, config.workflow);
+	if (run.trace.length === 0) return yield* fail$7(/* @__PURE__ */ new Error("gtd slices: refused — HEAD neither closes nor sits inside a process"));
+	const closing = run.closingHash;
+	let outcome;
+	let versionWarning;
+	if (closing !== void 0) {
+		const replayed = yield* replayFinishedProcess(config, run, closing, {
+			command: "gtd slices",
+			configReason: "HEAD's process replays under today's config; revert or stash the edit to list its slices",
+			notEnded: (o) => slicesDivergence(run, o)
+		});
+		outcome = replayed.outcome;
+		versionWarning = replayed.versionWarning;
+	} else {
+		const { setup } = yield* setupFor(config, run, workspace, host);
+		outcome = yield* promise(() => replayFor(setup));
+		if (outcome.kind !== "rest") return yield* fail$7(slicesDivergence(run, outcome));
+	}
+	return {
+		slices: sliceRangesOf(outcome.slices, run).map(({ name, base, tip, open }) => ({
+			name,
+			base,
+			tip,
+			closed: closing !== void 0 || !open
+		})),
+		...versionWarning !== void 0 ? { versionWarning } : {}
+	};
+});
+/** Every `gtd slices` refusal reads `gtd slices: refused — <reason>`; replay's own `gtd: ` lead is dropped. */
+const slicesDivergence = (run, outcome) => {
+	const reason = outcome.kind === "rest" && run.closingHash !== void 0 ? `${run.closingHash.slice(0, 7)} closes a process that does not end under today's config` : replayError(outcome)?.message.replace(/^gtd: /, "") ?? "replay failed";
+	return /* @__PURE__ */ new Error(`gtd slices: refused — ${reason}`);
+};
+/**
 * Whether `gtd --workflow <name>` can start a process here: the workflow must
 * reach a step from the tree the opening commit would capture. That step is
 * what the opening commit's subject names.
@@ -40329,7 +40381,7 @@ const inRepoConfigPaths = (root, files, recorded) => {
 	for (const file of files) paths.add(relative(root, resolve(root, file)).split(sep).join("/"));
 	return [...paths].filter((p) => p !== "" && !p.startsWith("..") && !isAbsolute(p)).sort();
 };
-const configRefusal = (tip, paths) => /* @__PURE__ */ new Error(`gtd history: refused — config differs at ${tip.slice(0, 7)}: ${paths.join(", ")}. A history ref replays under today's config, so it is unreadable after the config changes`);
+const configRefusal = (command, tip, paths, reason = "A history ref replays under today's config, so it is unreadable after the config changes") => /* @__PURE__ */ new Error(`${command}: refused — config differs at ${tip.slice(0, 7)}: ${paths.join(", ")}. ${reason}`);
 const differingConfigPaths = (git, workspace, root, config, run, hash) => gen(function* () {
 	const differing = [];
 	for (const path of inRepoConfigPaths(root, Object.keys(config.fingerprint), run.pinnedConfig?.files ?? {})) if ((yield* orElseSucceed(git.readFileAtRef(hash, path), () => void 0)) !== workspace.readSync(path)) differing.push(path);
@@ -40360,22 +40412,19 @@ const versionWarningFor = (recorded) => recorded === GTD_VERSION ? void 0 : `gtd
 const historyTrail = (tip) => gen(function* () {
 	const git = yield* GitService;
 	const config = yield* (yield* ConfigService).load;
-	const workspace = yield* Workspace;
-	const host = yield* Host;
 	const hash = yield* git.resolveRef(tip);
-	const run = yield* closedRunAt(hash);
-	const differing = yield* differingConfigPaths(git, workspace, host.root, config, run, hash);
-	if (differing.length > 0) return yield* fail$7(configRefusal(hash, differing));
-	const { setup } = yield* setupFor(config, run, workspace, host);
-	yield* workspace.episodeTrees(run.episode.base, run.episode.commits.map((c) => c.hash));
-	const outcome = yield* promise(() => replayFor(setup));
-	if (outcome.kind !== "ended") return yield* fail$7(notClosedError(hash, outcome));
-	const steps = historySteps(run);
-	const recorded = parseCommitMessage(yield* git.lastCommitMessage(hash)).version;
-	const versionWarning = versionWarningFor(recorded);
+	const subject = yield* git.lastCommitSubject(hash);
+	const run = yield* runAtTip(git, config.workflow, {
+		hash,
+		subject
+	});
+	const { outcome, recorded, versionWarning } = yield* replayFinishedProcess(config, run, hash, {
+		command: "gtd history",
+		notEnded: (o) => notClosedError(hash, o)
+	});
 	return {
 		tip: hash,
-		steps,
+		steps: historySteps(run),
 		ended: outcome.via,
 		version: {
 			recorded,
@@ -40384,6 +40433,24 @@ const historyTrail = (tip) => gen(function* () {
 		...versionWarning !== void 0 ? { versionWarning } : {}
 	};
 });
+/** Refuses on config drift before replaying, so a stale config never runs the flow. */
+const replayFinishedProcess = (config, run, hash, how) => gen(function* () {
+	const git = yield* GitService;
+	const workspace = yield* Workspace;
+	const host = yield* Host;
+	const differing = yield* differingConfigPaths(git, workspace, host.root, config, run, hash);
+	if (differing.length > 0) return yield* fail$7(configRefusal(how.command, hash, differing, how.configReason));
+	const { setup } = yield* setupFor(config, run, workspace, host);
+	const outcome = yield* promise(() => replayFor(setup));
+	if (outcome.kind !== "ended") return yield* fail$7(how.notEnded(outcome));
+	const recorded = parseCommitMessage(run.episode.commits.find((c) => c.hash === hash)?.message ?? "").version;
+	const versionWarning = versionWarningFor(recorded);
+	return {
+		outcome,
+		recorded,
+		...versionWarning !== void 0 ? { versionWarning } : {}
+	};
+});
 //#endregion
 //#region src/emit/GitScript.ts
 const shellQuote$1 = (value) => `'${value.replace(/'/g, "'\\''")}'`;
@@ -41256,6 +41323,17 @@ const runDoorsCommand = (json, out) => gen(function* () {
 	if (json.kind === "document") out.write(`${JSON.stringify(document)}\n`);
 	else yield* writeSelection(out, document, json.path);
 });
+const runSlicesCommand = (json, out) => gen(function* () {
+	const { slices, versionWarning } = yield* processSlices;
+	if (versionWarning !== void 0) yield* (yield* Narrator).warn(versionWarning);
+	if (json.kind === "off") {
+		out.write(slices.map((s) => `${s.name} ${s.base}..${s.tip}\n`).join(""));
+		return;
+	}
+	const document = slicesDocument(slices);
+	if (json.kind === "document") out.write(renderSlicesJson(document));
+	else yield* writeSelection(out, document, json.path);
+});
 /**
 * Ends the process underway without completing it. Nothing is discarded: a
 * `git reset --mixed` to the process's start commit leaves every turn
@@ -41591,6 +41669,7 @@ const dispatchVoidCommand = (command, json, out) => {
 		case "start": return runStartCommand(command.actor, command.workflow, command.vars, out, command.label);
 		case "door": return runDoorCommand(command.name, command.args, out);
 		case "doors": return runDoorsCommand(json, out);
+		case "slices": return runSlicesCommand(json, out);
 		case "abandon": return runAbandonCommand(out);
 		case "restore": return runRestoreCommand(out);
 		case "next": return runNextCommand(json, out);
@@ -41649,12 +41728,12 @@ const FLAGS = [
 		name: "--json",
 		arity: "optional",
 		repeatable: false,
-		scope: (kind) => kind === "next" || kind === "land" || kind === "judge" || kind === "judgeAnswer" || kind === "doors" || kind === "historyList" || kind === "historyShow" || kind === "strays",
+		scope: (kind) => kind === "next" || kind === "land" || kind === "judge" || kind === "judgeAnswer" || kind === "doors" || kind === "slices" || kind === "historyList" || kind === "historyShow" || kind === "strays",
 		decode: ([raw]) => right(raw ?? ""),
-		scopeError: "gtd: --json is only valid for `gtd next`/`gtd land`/`gtd judge`/`gtd judge answer`/`gtd doors`/`gtd history list`/`gtd history show`/`gtd strays` — every other command prints plain text; see `gtd install` for the driver protocol briefing",
+		scopeError: "gtd: --json is only valid for `gtd next`/`gtd land`/`gtd judge`/`gtd judge answer`/`gtd doors`/`gtd slices`/`gtd history list`/`gtd history show`/`gtd strays` — every other command prints plain text; see `gtd install` for the driver protocol briefing",
 		valueHint: "<path>",
 		help: [
-			"(gtd next/gtd land/gtd judge/gtd judge answer/gtd doors/gtd history",
+			"(gtd next/gtd land/gtd judge/gtd judge answer/gtd doors/gtd slices/gtd history",
 			"list/gtd history show/gtd strays only) output structured JSON. Bare --json prints the whole document;",
 			"--json=<path> (a dotted key path into that document, e.g.",
 			"kind, content, session.id) prints just that value: a",
@@ -42124,6 +42203,25 @@ const COMMAND_ROWS = [
 			"value off it. Writes nothing"
 		]
 	},
+	{
+		token: "slices",
+		kind: "slices",
+		arity: "none",
+		details: [
+			"List the slices of the process HEAD closes or sits inside,",
+			"first slice first: one `name base..tip` line each (full",
+			"hashes; plain output carries no promise). --json prints",
+			"{ schema: 1, slices: [{ name, base, tip, closed }] };",
+			"--json=<path> reads one value off it. Writes nothing: no",
+			"git, no state transition, no session identity. When HEAD",
+			"closes a process, every slice is listed as closed; a gtd",
+			"version mismatch only warns on stderr. Refuses (exit 1)",
+			"when HEAD neither closes nor sits inside a process, or when",
+			"today's config disagrees with history about the process:",
+			"HEAD closes it and its config files differ from the working",
+			"tree, or the replay diverged"
+		]
+	},
 	{
 		token: "judge",
 		kind: "judge",

package/dist/testkit.mjs

@@ -1,5 +1,5 @@
 import { checkScript, configProblems, configure, installContext, isFactoryWorkflow, moveScript, protocolMismatch, removeScript, restoreScript, revertScript, showScript, t as flows_exports } from "./flows.mjs";
-import { E as ACCESS_REFUSAL, _ as demandOf, a as landFields, c as renderLandJson, d as renderBeatPlain, f as beatDocument, g as beatKindOf, i as judgeJson, k as renderFormat, l as renderLandPlain, m as statusOf, n as resolveSession, p as renderBeatJson, r as selectPath, s as noopText, t as globMatches } from "./chunks/wire-C12dahrH.mjs";
+import { O as ACCESS_REFUSAL, a as selectPath, d as renderLandPlain, g as statusOf, h as renderBeatJson, i as resolveSession, j as renderFormat, l as noopText, m as beatDocument, n as slicesDocument, o as judgeJson, p as renderBeatPlain, r as globMatches, s as landFields, t as renderSlicesJson, u as renderLandJson, v as beatKindOf, y as demandOf } from "./chunks/wire-D3Rc5r22.mjs";
 import { C as headingSections, S as headingSectionBodies, a as unansweredQuestions, b as parseThreadsWithFindings, n as openThreads, r as steeringFormatFor, s as parseCodeThreads, t as BUILT_IN_MODE_NAMES, w as formatFinding } from "./chunks/steering-DVILanVf.mjs";
 import { $ as logWarning, $i as NodeInspectSymbol, $n as map$5, $r as make$19, $t as provide$1, A as catchIf, Ai as add, An as scopeMake, Ar as flatMap$3, At as suspend$5, B as flatMap$4, Bi as getOrElse, Bn as get$3, Br as sync$1, Bt as unsafeMakeLatch, C as all$1, Ci as toArray, Cn as isInterrupted, Cr as exitFail, Ct as sandbox, D as async, Di as GenericTag, Dn as squash, Dr as exitZipRight, Dt as scopedWith$1, E as asVoid$1, Ei as unsafeHead, En as reduceWithContext, Er as exitVoid, Et as scoped$4, F as ensuring$2, Fi as fromIterable, Fn as join$3, Fr as map$3, Ft as tryMap, G as forkIn, Gi as none, Gn as TypeId$10, Gr as whenEffect, Gt as zipLeft, H as fnUntraced, Hi as isSome, Hn as modify$1, Hr as uninterruptible, Ht as when, I as exit, Ii as splitAt, In as sequential, Ir as onInterrupt, It as tryPromise, J as ignore, Ji as left, Jn as all, Jr as DeferredTypeId$1, Jt as spaced$1, K as forkScoped, Ki as some, Kn as Class, Kr as withFiberRuntime, Kt as zipRight$3, L as fail$5, Li as filter$1, Ln as bind, Lr as scopeClose, Lt as try_, M as die$2, Mi as getOption, Mn as _await$2, Mr as interruptAsFiber, Mt as tap, N as dieMessage, Ni as omit, Nn as inheritAll$1, Nr as interruptFiber, Nt as tapErrorCause, O as catchAll$1, Oi as Reference, On as ensuring$3, Or as fiberId, Ot as serviceOption, P as either, Pi as empty$5, Pn as interruptAllAs$1, Pr as interruptible$1, Pt as timeout, Q as isEffect, Qi as BaseProto, Qn as isFailure, Qr as ids, Qt as mergeAll$2, R as failCause$4, Ri as flatMap$5, Rn as bindTo, Rr as succeed$4, Rt as uninterruptible$1, S as addFinalizer$1, Si as takeRight, Sn as isDieType, Sr as exitAs, St as runtime, T as as, Ti as unsafeGet, Tn as map$6, Tr as exitSucceed, Tt as scopeWith, U as forEach$2, Ui as map$8, Un as set$1, Ur as uninterruptibleMask$1, Ut as withFiberRuntime$1, V as flatten$4, Vi as isNone, Vn as make$16, Vr as tap$1, Vt as unsafeMakeSemaphore$1, W as forkDaemon, Wi as match$4, Wn as update$1, Wr as void_$2, Wt as zip$1, X as interruptible, Xi as right, Xn as fail$4, Xr as combine, Xt as tagged, Y as interrupt$4, Yi as match$2, Yn as die, Yr as empty$6, Yt as TaggedError$1, Z as intoDeferred, Zi as pipeArguments, Zn as failCause$3, Zr as combineAll, Zt as fromEffect$5, _ as decodeSync, _i as of, _n as fail$3, _r as deferredIsDone, _t as raceWith, a as Literal, aa as constTrue, ai as size$2, an as updateContext$1, ar as zipRight$2, at as matchCause, b as acquireRelease, bi as reverse, bn as interrupt$3, br as deferredUnsafeDone, bt as runPromise, c as String$, ca as dual, ci as append$1, cn as Scope, cr as asyncInterrupt, ct as negate, d as Union, di as empty$4, dn as close, dr as deferredAwait, dt as orElse, ea as format, ei as none$1, en as provideMerge$1, er as mapBoth, et as makeSemaphore, f as between, fi as filter, fn as extend, fr as deferredComplete, ft as orElseSucceed, gi as map$7, gn as die$1, gr as deferredInterruptWith, gt as race, hi as isEmpty$2, hn as NoSuchElementException, hr as deferredInterrupt, ht as provideService, i as Defect, ia as constFalse, ii as has, in as unsafeRunPromiseExit, ir as zip$2, it as match$5, j as catchTag, ji as get$5, jn as scopeTag, jr as interrupt$2, jt as sync$2, k as catchAllCause, ki as Tag, kn as forEachConcurrentDiscard, kr as fiberRefLocally, kt as succeed$6, l as Struct, la as identity, li as appendAll, ln as addFinalizer, lr as catchAll, lt as onError, m as optional$1, mi as isChunk, mn as make$18, mr as deferredFailCause, mt as provide$2, n as Boolean$, na as equals, ni as make$17, nn as succeed$3, nr as succeed$5, nt as mapBoth$1, o as Never, oa as constUndefined, oi as decode, on as forkIn$1, or as as$1, ot as matchCauseEffect, p as decodeUnknown, pi as fromIterable$1, pn as fork, pr as deferredFail, pt as promise, q as gen, qi as isLeft, qn as spanTag, qr as zipRight$1, qt as zipWith, r as Cause, ra as hasProperty, ri as set$2, rn as unsafeFork, rr as void_$3, rt as mapError, s as Number$, sa as constVoid, si as isFinite, sn as unsafeMakeSemaphore, sr as asVoid, st as matchEffect, t as Array$, ta as toJSON, ti as get$4, tn as scoped$3, tr as match$3, tt as map$4, u as TaggedError, ua as pipe, ui as drop, un as addFinalizerExit, ur as currentContext$1, ut as orDie, v as encodeSync, vi as prepend, vn as failureOrCause, vr as deferredMake, vt as repeat, w as annotateLogs, wi as unsafeFromArray, wn as isInterruptedOnly, wr as exitFailCause, wt as scope, x as acquireUseRelease$2, xi as take$2, xn as interruptors, xr as deferredUnsafeMake, xt as runPromiseExit$1, y as _void, yi as reduce, yn as flipCauseOption, yr as deferredSucceed, yt as retry, z as fiberIdWith, zi as fromNullable, zn as sleep, zr as suspend$4, zt as uninterruptibleMask } from "./chunks/Schema-DO5ttJaI.mjs";
 import { createRequire } from "node:module";
@@ -6999,7 +6999,7 @@ const TRAILER_READERS = {
 		if (value !== "") into.branch ??= value;
 	},
 	"Gtd-Version": (value, into) => {
-		if (value !== "") into.version ??= value;
+		if (value !== "" && !/[\u0000-\u001f\u007f-\u009f]/.test(value)) into.version ??= value;
 	},
 	"Gtd-Kept": (value, into) => {
 		if (HASH_RE.test(value)) into.kept ??= value;
@@ -7437,7 +7437,8 @@ const replay = async (input) => {
 		via,
 		trace,
 		landed,
-		marks
+		marks,
+		slices: slices.map((s) => ({ ...s }))
 	};
 	const changesSince = (hash) => {
 		const tree = treeAt(hash);
@@ -8867,22 +8868,14 @@ const runAtTip = (git, def, tip) => gen(function* () {
 	if (closing.length === 0) closing = yield* git.commitHistory(void 0, tip.hash);
 	return yield* runOf([...before, ...closing], { ...location }, tip.hash);
 });
-/** The process HEAD closes or sits inside — `gtd summary`'s run. */
-const summaryRun = gen(function* () {
-	const git = yield* GitService;
-	const def = (yield* (yield* ConfigService).load).workflow;
+const runAtHead = (git, def) => gen(function* () {
 	return yield* runAtTip(git, def, (yield* git.subjectHistory(1, 0))[0]);
 });
-/** The process whose finishing commit is `tip` — reads from `tip`'s own ancestry, so it works when no branch reaches it. */
-const closedRunAt = (tip) => gen(function* () {
+/** The process HEAD closes or sits inside — `gtd summary`'s run. */
+const summaryRun = gen(function* () {
 	const git = yield* GitService;
 	const def = (yield* (yield* ConfigService).load).workflow;
-	const hash = yield* git.resolveRef(tip);
-	const subject = yield* git.lastCommitSubject(hash);
-	return yield* runAtTip(git, def, {
-		hash,
-		subject
-	});
+	return yield* runAtHead(git, def);
 });
 const commitTree = (workspace, hash) => {
 	let entries;
@@ -9211,12 +9204,54 @@ const restAt = (ref, startOverrides = {}) => gen(function* () {
 			total: run.costEntries.reduce((sum, entry) => sum + entry.cost, 0),
 			byModel: costByModel(run.costEntries)
 		},
-		setup,
-		slices: sliceRangesOf(outcome.slices, run)
+		setup
 	};
 });
 const currentRest = restAt(void 0);
 /**
+* The slices of the process HEAD closes or sits inside, current episode only,
+* stack order. Reads like `historyTrail`, never `restAt`: it narrates and
+* writes nothing, and returns a version warning for a closed run.
+*/
+const processSlices = gen(function* () {
+	const git = yield* GitService;
+	const config = yield* (yield* ConfigService).load;
+	const workspace = yield* Workspace;
+	const host = yield* Host;
+	const run = yield* runAtHead(git, config.workflow);
+	if (run.trace.length === 0) return yield* fail$5(/* @__PURE__ */ new Error("gtd slices: refused — HEAD neither closes nor sits inside a process"));
+	const closing = run.closingHash;
+	let outcome;
+	let versionWarning;
+	if (closing !== void 0) {
+		const replayed = yield* replayFinishedProcess(config, run, closing, {
+			command: "gtd slices",
+			configReason: "HEAD's process replays under today's config; revert or stash the edit to list its slices",
+			notEnded: (o) => slicesDivergence(run, o)
+		});
+		outcome = replayed.outcome;
+		versionWarning = replayed.versionWarning;
+	} else {
+		const { setup } = yield* setupFor(config, run, workspace, host);
+		outcome = yield* promise(() => replayFor(setup));
+		if (outcome.kind !== "rest") return yield* fail$5(slicesDivergence(run, outcome));
+	}
+	return {
+		slices: sliceRangesOf(outcome.slices, run).map(({ name, base, tip, open }) => ({
+			name,
+			base,
+			tip,
+			closed: closing !== void 0 || !open
+		})),
+		...versionWarning !== void 0 ? { versionWarning } : {}
+	};
+});
+/** Every `gtd slices` refusal reads `gtd slices: refused — <reason>`; replay's own `gtd: ` lead is dropped. */
+const slicesDivergence = (run, outcome) => {
+	const reason = outcome.kind === "rest" && run.closingHash !== void 0 ? `${run.closingHash.slice(0, 7)} closes a process that does not end under today's config` : replayError(outcome)?.message.replace(/^gtd: /, "") ?? "replay failed";
+	return /* @__PURE__ */ new Error(`gtd slices: refused — ${reason}`);
+};
+/**
 * Whether `gtd --workflow <name>` can start a process here: the workflow must
 * reach a step from the tree the opening commit would capture. That step is
 * what the opening commit's subject names.
@@ -9450,7 +9485,7 @@ const inRepoConfigPaths = (root, files, recorded) => {
 	for (const file of files) paths.add(relative(root, resolve(root, file)).split(sep).join("/"));
 	return [...paths].filter((p) => p !== "" && !p.startsWith("..") && !isAbsolute(p)).sort();
 };
-const configRefusal = (tip, paths) => /* @__PURE__ */ new Error(`gtd history: refused — config differs at ${tip.slice(0, 7)}: ${paths.join(", ")}. A history ref replays under today's config, so it is unreadable after the config changes`);
+const configRefusal = (command, tip, paths, reason = "A history ref replays under today's config, so it is unreadable after the config changes") => /* @__PURE__ */ new Error(`${command}: refused — config differs at ${tip.slice(0, 7)}: ${paths.join(", ")}. ${reason}`);
 const differingConfigPaths = (git, workspace, root, config, run, hash) => gen(function* () {
 	const differing = [];
 	for (const path of inRepoConfigPaths(root, Object.keys(config.fingerprint), run.pinnedConfig?.files ?? {})) if ((yield* orElseSucceed(git.readFileAtRef(hash, path), () => void 0)) !== workspace.readSync(path)) differing.push(path);
@@ -9481,22 +9516,19 @@ const versionWarningFor = (recorded) => recorded === GTD_VERSION ? void 0 : `gtd
 const historyTrail = (tip) => gen(function* () {
 	const git = yield* GitService;
 	const config = yield* (yield* ConfigService).load;
-	const workspace = yield* Workspace;
-	const host = yield* Host;
 	const hash = yield* git.resolveRef(tip);
-	const run = yield* closedRunAt(hash);
-	const differing = yield* differingConfigPaths(git, workspace, host.root, config, run, hash);
-	if (differing.length > 0) return yield* fail$5(configRefusal(hash, differing));
-	const { setup } = yield* setupFor(config, run, workspace, host);
-	yield* workspace.episodeTrees(run.episode.base, run.episode.commits.map((c) => c.hash));
-	const outcome = yield* promise(() => replayFor(setup));
-	if (outcome.kind !== "ended") return yield* fail$5(notClosedError(hash, outcome));
-	const steps = historySteps(run);
-	const recorded = parseCommitMessage(yield* git.lastCommitMessage(hash)).version;
-	const versionWarning = versionWarningFor(recorded);
+	const subject = yield* git.lastCommitSubject(hash);
+	const run = yield* runAtTip(git, config.workflow, {
+		hash,
+		subject
+	});
+	const { outcome, recorded, versionWarning } = yield* replayFinishedProcess(config, run, hash, {
+		command: "gtd history",
+		notEnded: (o) => notClosedError(hash, o)
+	});
 	return {
 		tip: hash,
-		steps,
+		steps: historySteps(run),
 		ended: outcome.via,
 		version: {
 			recorded,
@@ -9505,6 +9537,24 @@ const historyTrail = (tip) => gen(function* () {
 		...versionWarning !== void 0 ? { versionWarning } : {}
 	};
 });
+/** Refuses on config drift before replaying, so a stale config never runs the flow. */
+const replayFinishedProcess = (config, run, hash, how) => gen(function* () {
+	const git = yield* GitService;
+	const workspace = yield* Workspace;
+	const host = yield* Host;
+	const differing = yield* differingConfigPaths(git, workspace, host.root, config, run, hash);
+	if (differing.length > 0) return yield* fail$5(configRefusal(how.command, hash, differing, how.configReason));
+	const { setup } = yield* setupFor(config, run, workspace, host);
+	const outcome = yield* promise(() => replayFor(setup));
+	if (outcome.kind !== "ended") return yield* fail$5(how.notEnded(outcome));
+	const recorded = parseCommitMessage(run.episode.commits.find((c) => c.hash === hash)?.message ?? "").version;
+	const versionWarning = versionWarningFor(recorded);
+	return {
+		outcome,
+		recorded,
+		...versionWarning !== void 0 ? { versionWarning } : {}
+	};
+});
 //#endregion
 //#region src/emit/GitScript.ts
 const shellQuote = (value) => `'${value.replace(/'/g, "'\\''")}'`;
@@ -10373,6 +10423,17 @@ const runDoorsCommand = (json, out) => gen(function* () {
 	if (json.kind === "document") out.write(`${JSON.stringify(document)}\n`);
 	else yield* writeSelection(out, document, json.path);
 });
+const runSlicesCommand = (json, out) => gen(function* () {
+	const { slices, versionWarning } = yield* processSlices;
+	if (versionWarning !== void 0) yield* (yield* Narrator).warn(versionWarning);
+	if (json.kind === "off") {
+		out.write(slices.map((s) => `${s.name} ${s.base}..${s.tip}\n`).join(""));
+		return;
+	}
+	const document = slicesDocument(slices);
+	if (json.kind === "document") out.write(renderSlicesJson(document));
+	else yield* writeSelection(out, document, json.path);
+});
 /**
 * Ends the process underway without completing it. Nothing is discarded: a
 * `git reset --mixed` to the process's start commit leaves every turn
@@ -10708,6 +10769,7 @@ const dispatchVoidCommand = (command, json, out) => {
 		case "start": return runStartCommand(command.actor, command.workflow, command.vars, out, command.label);
 		case "door": return runDoorCommand(command.name, command.args, out);
 		case "doors": return runDoorsCommand(json, out);
+		case "slices": return runSlicesCommand(json, out);
 		case "abandon": return runAbandonCommand(out);
 		case "restore": return runRestoreCommand(out);
 		case "next": return runNextCommand(json, out);
@@ -10764,12 +10826,12 @@ const FLAGS = [
 		name: "--json",
 		arity: "optional",
 		repeatable: false,
-		scope: (kind) => kind === "next" || kind === "land" || kind === "judge" || kind === "judgeAnswer" || kind === "doors" || kind === "historyList" || kind === "historyShow" || kind === "strays",
+		scope: (kind) => kind === "next" || kind === "land" || kind === "judge" || kind === "judgeAnswer" || kind === "doors" || kind === "slices" || kind === "historyList" || kind === "historyShow" || kind === "strays",
 		decode: ([raw]) => right(raw ?? ""),
-		scopeError: "gtd: --json is only valid for `gtd next`/`gtd land`/`gtd judge`/`gtd judge answer`/`gtd doors`/`gtd history list`/`gtd history show`/`gtd strays` — every other command prints plain text; see `gtd install` for the driver protocol briefing",
+		scopeError: "gtd: --json is only valid for `gtd next`/`gtd land`/`gtd judge`/`gtd judge answer`/`gtd doors`/`gtd slices`/`gtd history list`/`gtd history show`/`gtd strays` — every other command prints plain text; see `gtd install` for the driver protocol briefing",
 		valueHint: "<path>",
 		help: [
-			"(gtd next/gtd land/gtd judge/gtd judge answer/gtd doors/gtd history",
+			"(gtd next/gtd land/gtd judge/gtd judge answer/gtd doors/gtd slices/gtd history",
 			"list/gtd history show/gtd strays only) output structured JSON. Bare --json prints the whole document;",
 			"--json=<path> (a dotted key path into that document, e.g.",
 			"kind, content, session.id) prints just that value: a",
@@ -11239,6 +11301,25 @@ const COMMAND_ROWS = [
 			"value off it. Writes nothing"
 		]
 	},
+	{
+		token: "slices",
+		kind: "slices",
+		arity: "none",
+		details: [
+			"List the slices of the process HEAD closes or sits inside,",
+			"first slice first: one `name base..tip` line each (full",
+			"hashes; plain output carries no promise). --json prints",
+			"{ schema: 1, slices: [{ name, base, tip, closed }] };",
+			"--json=<path> reads one value off it. Writes nothing: no",
+			"git, no state transition, no session identity. When HEAD",
+			"closes a process, every slice is listed as closed; a gtd",
+			"version mismatch only warns on stderr. Refuses (exit 1)",
+			"when HEAD neither closes nor sits inside a process, or when",
+			"today's config disagrees with history about the process:",
+			"HEAD closes it and its config files differ from the working",
+			"tree, or the replay diverged"
+		]
+	},
 	{
 		token: "judge",
 		kind: "judge",

package/dist/wire.mjs

@@ -1,2 +1,2 @@
-import { C as EXIT_SIGTERM, D as UNATTRIBUTED_MODEL, E as ACCESS_REFUSAL, O as WIRE_SCHEMA, S as EXIT_SIGINT, T as EXIT_USAGE_ERROR, _ as demandOf, a as landFields, b as EXIT_OK, c as renderLandJson, d as renderBeatPlain, f as beatDocument, g as beatKindOf, h as BEAT_KINDS, i as judgeJson, k as renderFormat, l as renderLandPlain, m as statusOf, n as resolveSession, o as landProseText, p as renderBeatJson, r as selectPath, s as noopText, t as globMatches, u as DEMAND_BRIEFING, v as stallDiagnosis, w as EXIT_STRAYS_FOUND, x as EXIT_RUNTIME_ERROR, y as EXIT_CODES } from "./chunks/wire-C12dahrH.mjs";
-export { ACCESS_REFUSAL, BEAT_KINDS, DEMAND_BRIEFING, EXIT_CODES, EXIT_OK, EXIT_RUNTIME_ERROR, EXIT_SIGINT, EXIT_SIGTERM, EXIT_STRAYS_FOUND, EXIT_USAGE_ERROR, UNATTRIBUTED_MODEL, WIRE_SCHEMA, beatDocument, beatKindOf, demandOf, globMatches, judgeJson, landFields, landProseText, noopText, renderBeatJson, renderBeatPlain, renderFormat, renderLandJson, renderLandPlain, resolveSession, selectPath, stallDiagnosis, statusOf };
+import { A as WIRE_SCHEMA, C as EXIT_RUNTIME_ERROR, D as EXIT_USAGE_ERROR, E as EXIT_STRAYS_FOUND, O as ACCESS_REFUSAL, S as EXIT_OK, T as EXIT_SIGTERM, _ as BEAT_KINDS, a as selectPath, b as stallDiagnosis, c as landProseText, d as renderLandPlain, f as DEMAND_BRIEFING, g as statusOf, h as renderBeatJson, i as resolveSession, j as renderFormat, k as UNATTRIBUTED_MODEL, l as noopText, m as beatDocument, n as slicesDocument, o as judgeJson, p as renderBeatPlain, r as globMatches, s as landFields, t as renderSlicesJson, u as renderLandJson, v as beatKindOf, w as EXIT_SIGINT, x as EXIT_CODES, y as demandOf } from "./chunks/wire-D3Rc5r22.mjs";
+export { ACCESS_REFUSAL, BEAT_KINDS, DEMAND_BRIEFING, EXIT_CODES, EXIT_OK, EXIT_RUNTIME_ERROR, EXIT_SIGINT, EXIT_SIGTERM, EXIT_STRAYS_FOUND, EXIT_USAGE_ERROR, UNATTRIBUTED_MODEL, WIRE_SCHEMA, beatDocument, beatKindOf, demandOf, globMatches, judgeJson, landFields, landProseText, noopText, renderBeatJson, renderBeatPlain, renderFormat, renderLandJson, renderLandPlain, renderSlicesJson, resolveSession, selectPath, slicesDocument, stallDiagnosis, statusOf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmelab/gtd",
-  "version": "27.8.0",
+  "version": "27.9.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {