@pmelab/gtd 62.0.0 → 62.1.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gtd",
-  "version": "62.0.0",
+  "version": "62.1.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

@@ -624,10 +624,10 @@ install for any of these but the testkit's: gtd resolves a `gtd.config.ts`'s
 `@pmelab/gtd/*` imports to its own copy.
 
 The `gtd` bin's commands — `next`, `land`, `start`, `abandon`, `restore`,
-`validate`, `check`, `uncheck`, `guide`, `bundle`, `summary`, `base`, `version`,
-`help`, `history list`, `history show`, `history metrics`, `history judges`,
-`history fetch`, `strays`, the tools `ui`, `lsp`, `judge` (`judge answer`,
-`judge run`) — are listed in the
+`repin`, `validate`, `check`, `uncheck`, `guide`, `bundle`, `summary`, `base`,
+`version`, `help`, `history list`, `history show`, `history metrics`,
+`history judges`, `history fetch`, `strays`, the tools `ui`, `lsp`, `judge`
+(`judge answer`, `judge run`) — are listed in the
 [CLI reference](https://github.com/pmelab/gtd/blob/main/docs/cli.md). Every
 command that prints a script takes `--json=script`, and `--` ends the options.
 
@@ -646,10 +646,12 @@ Histories with pin commits are history format 2, which an older gtd refuses.
 While a process is pinned, the `gtd` on your `PATH` hands every command over to
 the pin, so editing the workflow or upgrading gtd mid-process changes nothing;
 gtd notes on stderr when the live config differs from the pinned one. `ui`,
-`lsp`, `guide`, `bundle`, `help`, `version` and the `history` commands always
-run live, and `gtd --live <command>` runs the live engine for any other, at the
-risk of misreading the process. A pin in a format your gtd does not know is
-refused: upgrade gtd. See
+`lsp`, `guide`, `bundle`, `repin`, `help`, `version` and the `history` commands
+always run live, and `gtd --live <command>` runs the live engine for any other,
+at the risk of misreading the process. To fix a workflow mid-process, edit it
+and run `gtd repin`: its script commits a fresh pin from the live engine and
+config, and the process continues on it. A pin in a format your gtd does not
+know is refused: upgrade gtd. See
 [Pinned processes](https://github.com/pmelab/gtd/blob/main/docs/cli.md#pinned-processes).
 
 ## License

package/dist/chunks/{testkit-XQeYCNMn.mjs → testkit-CPzWnl3P.mjs}

@@ -24610,6 +24610,12 @@ const pinScript = (path) => {
 	const slash = path.lastIndexOf("/");
 	return `${slash === -1 ? "" : `mkdir -p ${shellQuote(path.slice(0, slash))}\n`}gtd bundle >${p} || { rm -f -- ${p}; exit 1; }`;
 };
+/** `gtd repin`'s pin write: a failed `gtd bundle` leaves the committed pin in place. */
+const repinScript = (path) => {
+	const p = shellQuote(path);
+	const next = shellQuote(`${path}.new`);
+	return `gtd bundle >${next} || { rm -f -- ${next}; exit 1; }\nmv -f -- ${next} ${p}`;
+};
 /** An unpin beat's script, and `gtd abandon`'s removal of the pin. */
 const unpinScript = (path) => `rm -f -- ${shellQuote(path)}`;
 /**
@@ -24850,6 +24856,12 @@ const FMT_ABANDONED = "abandoned the process resting at \"%s\" — HEAD is back
 const FMT_RESTORED = "restored the retained history — HEAD is back at %s (\"%s\"), resting at \"%s\". Resume with the loop, or `git reset` to any earlier turn to restart from there.\n";
 /** `no gtd process is underway (resting at "<initial>") — nothing to abandon` — `gtd abandon`'s no-op plain-text line. */
 const abandonNoopText = (initial) => renderFormat(FMT_ABANDON_NOOP, initial);
+/** A landed self-loop/target-change transition. */
+const transitionOutcome = (from, to) => printfLine("%s %s → %s\n", [
+	"'->'",
+	shellQuote(from),
+	shellQuote(to)
+]);
 /** One already-rendered plain line. */
 const noteOutcome = (text) => printfLine("%s\n", [shellQuote(text)]);
 /**
@@ -27328,6 +27340,36 @@ const runRestoreCommand = (json, out) => gen(function* () {
 	yield* writeScript(json, out, combinedScript(required, ""));
 });
 /**
+* `gtd repin`: the pin beat's script and landing, on demand. It runs live,
+* so reading the rest first refuses a live workflow that cannot replay the
+* process before any pin is written.
+*/
+const runRepinCommand = (json, out) => gen(function* () {
+	const rest = yield* currentRest;
+	const refusal = rest.pin === "add" ? "the next beat pins the process already — run it (`gtd next --json=content`), then land" : rest.pin === "remove" ? "the flow has ended — its unpin beat is next, so there is nothing to repin" : noProcessUnderway(rest) ? "no gtd process is underway — nothing to repin" : void 0;
+	if (refusal !== void 0) return yield* fail$4(/* @__PURE__ */ new Error(`gtd repin: ${refusal}`));
+	const message = formatCommitMessage({
+		actor: "check",
+		from: PIN_STATES.add,
+		to: rest.step.name,
+		pin: "add"
+	});
+	yield* writeScript(json, out, combinedScript(emitScripts([
+		{
+			kind: "gitWrite",
+			command: repinScript(PIN_PATH)
+		},
+		{
+			kind: "gitWrite",
+			command: commitPath(PIN_PATH, message)
+		},
+		{
+			kind: "outcome",
+			command: transitionOutcome(PIN_STATES.add, rest.step.name)
+		}
+	]).required, ""));
+});
+/**
 * The mode's own validate command for `file`: a declared `validate:` command
 * verbatim; a `"builtin"` validator or no mode at all names the leaf
 * `gtd check <mode>` invocation instead, so there's always something concrete
@@ -27594,6 +27636,7 @@ const dispatchVoidCommand = (command, json, out) => {
 		case "start": return runStartCommand(command, json, out);
 		case "abandon": return runAbandonCommand(json, out);
 		case "restore": return runRestoreCommand(json, out);
+		case "repin": return runRepinCommand(json, out);
 		case "next": return runNextCommand(json, out);
 		case "validate": return runValidateCommand(json, out);
 		case "check":
@@ -27722,6 +27765,7 @@ const SCRIPT_KINDS = /* @__PURE__ */ new Set([
 	"start",
 	"abandon",
 	"restore",
+	"repin",
 	"validate",
 	"historyFetch"
 ]);
@@ -27989,6 +28033,16 @@ With no <name>, list every workflow and door it can start. An unknown <name>, th
 		summary: "Bring back the last abandoned process",
 		details: `Bring back the process the last \`gtd abandon\` stopped: the printed script resets HEAD to that process's last commit. Refuses on a dirty working tree, when nothing was abandoned, or when commits made since would be lost.`
 	},
+	{
+		token: "repin",
+		kind: "repin",
+		arity: "none",
+		group: "Start and stop",
+		summary: "Pin the process to the live gtd and workflow",
+		details: `Switch the process underway to the live engine and workflow, the way out when the workflow needs a fix mid-process: the printed script runs the pin beat again, writing \`gtd bundle\`'s output to .gtd/process.gtdpin and committing that file alone. Always runs on the gtd on PATH, never on the pin. Refuses when no process is underway, when the next beat is a pin or unpin beat already, or when the live workflow does not replay the process.
+
+  s=$(gtd repin --json=script) && sh -c "$s"`
+	},
 	{
 		token: "summary",
 		kind: "summary",
@@ -29892,9 +29946,9 @@ const recognizeGitBuilders = (repo, block) => {
 };
 /** What the in-memory `gtd bundle` prints: a pin header, and no engine behind it. */
 const IN_MEMORY_PIN = "gtdpin 1 gtd in-memory\n";
-/** A pin or unpin beat's script. */
+/** A pin or unpin beat's script, or `gtd repin`'s. */
 const recognizePinScripts = (repo, block) => {
-	if (block === pinScript(".gtd/process.gtdpin")) {
+	if (block === pinScript(".gtd/process.gtdpin") || block === repinScript(".gtd/process.gtdpin")) {
 		repo.writeFile(PIN_PATH, IN_MEMORY_PIN);
 		return { kind: "applied" };
 	}

package/dist/gtd.bundle.mjs

@@ -31335,6 +31335,12 @@ const pinScript = (path) => {
 	const slash = path.lastIndexOf("/");
 	return `${slash === -1 ? "" : `mkdir -p ${shellQuote$1(path.slice(0, slash))}\n`}gtd bundle >${p} || { rm -f -- ${p}; exit 1; }`;
 };
+/** `gtd repin`'s pin write: a failed `gtd bundle` leaves the committed pin in place. */
+const repinScript = (path) => {
+	const p = shellQuote$1(path);
+	const next = shellQuote$1(`${path}.new`);
+	return `gtd bundle >${next} || { rm -f -- ${next}; exit 1; }\nmv -f -- ${next} ${p}`;
+};
 /** An unpin beat's script, and `gtd abandon`'s removal of the pin. */
 const unpinScript = (path) => `rm -f -- ${shellQuote$1(path)}`;
 /**
@@ -31563,6 +31569,12 @@ const FMT_ABANDONED = "abandoned the process resting at \"%s\" — HEAD is back
 const FMT_RESTORED = "restored the retained history — HEAD is back at %s (\"%s\"), resting at \"%s\". Resume with the loop, or `git reset` to any earlier turn to restart from there.\n";
 /** `no gtd process is underway (resting at "<initial>") — nothing to abandon` — `gtd abandon`'s no-op plain-text line. */
 const abandonNoopText = (initial) => renderFormat(FMT_ABANDON_NOOP, initial);
+/** A landed self-loop/target-change transition. */
+const transitionOutcome = (from, to) => printfLine("%s %s → %s\n", [
+	"'->'",
+	shellQuote$1(from),
+	shellQuote$1(to)
+]);
 /** One already-rendered plain line. */
 const noteOutcome = (text) => printfLine("%s\n", [shellQuote$1(text)]);
 /**
@@ -34055,6 +34067,36 @@ const runRestoreCommand = (json, out) => gen(function* () {
 	yield* writeScript(json, out, combinedScript(required, ""));
 });
 /**
+* `gtd repin`: the pin beat's script and landing, on demand. It runs live,
+* so reading the rest first refuses a live workflow that cannot replay the
+* process before any pin is written.
+*/
+const runRepinCommand = (json, out) => gen(function* () {
+	const rest = yield* currentRest;
+	const refusal = rest.pin === "add" ? "the next beat pins the process already — run it (`gtd next --json=content`), then land" : rest.pin === "remove" ? "the flow has ended — its unpin beat is next, so there is nothing to repin" : noProcessUnderway(rest) ? "no gtd process is underway — nothing to repin" : void 0;
+	if (refusal !== void 0) return yield* fail$8(/* @__PURE__ */ new Error(`gtd repin: ${refusal}`));
+	const message = formatCommitMessage({
+		actor: "check",
+		from: PIN_STATES.add,
+		to: rest.step.name,
+		pin: "add"
+	});
+	yield* writeScript(json, out, combinedScript(emitScripts([
+		{
+			kind: "gitWrite",
+			command: repinScript(PIN_PATH)
+		},
+		{
+			kind: "gitWrite",
+			command: commitPath(PIN_PATH, message)
+		},
+		{
+			kind: "outcome",
+			command: transitionOutcome(PIN_STATES.add, rest.step.name)
+		}
+	]).required, ""));
+});
+/**
 * The mode's own validate command for `file`: a declared `validate:` command
 * verbatim; a `"builtin"` validator or no mode at all names the leaf
 * `gtd check <mode>` invocation instead, so there's always something concrete
@@ -34321,6 +34363,7 @@ const dispatchVoidCommand = (command, json, out) => {
 		case "start": return runStartCommand(command, json, out);
 		case "abandon": return runAbandonCommand(json, out);
 		case "restore": return runRestoreCommand(json, out);
+		case "repin": return runRepinCommand(json, out);
 		case "next": return runNextCommand(json, out);
 		case "validate": return runValidateCommand(json, out);
 		case "check":
@@ -34450,6 +34493,7 @@ const SCRIPT_KINDS = /* @__PURE__ */ new Set([
 	"start",
 	"abandon",
 	"restore",
+	"repin",
 	"validate",
 	"historyFetch"
 ]);
@@ -34717,6 +34761,16 @@ With no <name>, list every workflow and door it can start. An unknown <name>, th
 		summary: "Bring back the last abandoned process",
 		details: `Bring back the process the last \`gtd abandon\` stopped: the printed script resets HEAD to that process's last commit. Refuses on a dirty working tree, when nothing was abandoned, or when commits made since would be lost.`
 	},
+	{
+		token: "repin",
+		kind: "repin",
+		arity: "none",
+		group: "Start and stop",
+		summary: "Pin the process to the live gtd and workflow",
+		details: `Switch the process underway to the live engine and workflow, the way out when the workflow needs a fix mid-process: the printed script runs the pin beat again, writing \`gtd bundle\`'s output to .gtd/process.gtdpin and committing that file alone. Always runs on the gtd on PATH, never on the pin. Refuses when no process is underway, when the next beat is a pin or unpin beat already, or when the live workflow does not replay the process.
+
+  s=$(gtd repin --json=script) && sh -c "$s"`
+	},
 	{
 		token: "summary",
 		kind: "summary",
@@ -35418,6 +35472,7 @@ const LIVE_KINDS = /* @__PURE__ */ new Set([
 	"lsp",
 	"guide",
 	"bundle",
+	"repin",
 	"historyList",
 	"historyShow",
 	"historyMetrics",