@krapht/ork 1.0.0-alpha.7 → 1.0.0-alpha.9

package/dist/bin.mjs

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-import { $ as adoptedCalls, $n as isClaudeNode, An as projectRootOf, B as peerOf, Cn as placeFiles, Ct as runTree, D as inspectProject, Dn as shownPath, En as runDirOf, F as createCalls, Ft as PROJECT_FILE, Gn as serializeWorkflow, Gt as planPost, Ht as FEEDBACK_SEVERITIES, I as addressOf, It as gitRulesOf, Jn as WorkflowSchema, K as requestStop, L as endLink, Lt as loadProject, M as clearGitLocalEnv, N as parseInputPairs, P as resolveInputs, R as endLinksOf, Sn as newProjectId, St as runStatus, Tn as projectsHome, U as flattenTree, Ut as FEEDBACK_TARGETS, V as tellNode, Vn as beforeOf, Vt as FEEDBACK_KINDS, Xt as fingerprint, Yt as createFeedback, Zn as settingsOf, Zt as normalizeTitle, _ as lateTriggers, _n as catalogAgent, an as socketRoom, at as followEvents, bn as hasInRepoFiles, bt as liveStatus, cr as CLAUDE_DRIVERS, ct as planNodeSession, d as runningRunIds, dn as planMoveInto, dr as experimentsOn, et as detachResume, f as runningScript, fn as linkTools, fr as knownExperiments, gn as deleteAgent, gt as startRun, h as isNewer, hn as createAgent, ht as walkSummary, i as NOT_STARTED, in as socketPath, it as detachRun, kn as inside, l as planUpgrade, ln as planAgentMigration, lr as firstLine, lt as namingNoDriver, mn as toolsInUse, n as resolveBase, nt as listKey, on as wakeRun, or as AGENT_TOOL_LAYOUTS, pn as toolLinks, q as tellLiveRun, qt as sendPost, rn as serveRun, rr as INTEGRATIONS, sn as maskReplacer, sr as ORK_LAYOUT, t as createWorkspace, tt as resumable, u as releaseNotes, un as applySteps, ur as EXPERIMENTS, ut as sessionDriver, v as triggersReport, vn as loadAgents, vt as userMessageText, wn as placeFor, wt as templateOf, xn as inRepoPlace } from "./src-BsLHKQRc.mjs";
-import { a as formatEvent, c as createDecisionQueue, i as nestItems, n as formatRuns, o as formatRunEvent, r as formatTree, s as createTerminalHuman, t as ago } from "./format-DaROJUgG.mjs";
-import { C as placeOf, T as openFixRun, _ as nodeSession, b as recordNote, c as checkDue, d as pendingNotice, f as readUpdateCache, g as activeTree, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, s as runInstall, t as ORK_NAME, u as newerVersion$1, v as previewPost, w as feedbackActions, x as acceptItem, y as checkNote } from "./__build_info__-BGoaUwLd.mjs";
-import { i as builtinWorkflowFile, n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-DsA6kOT7.mjs";
-import { n as newRunId, t as findRun } from "./find-ntyniv2E.mjs";
-import { a as write, c as openStore, i as style, l as storePath, n as cost, o as writeErr, s as isNodeEvent, t as confirm } from "./output-CwqlG1Le.mjs";
-import { n as listOrkWorktrees, t as createdWorktrees } from "./list-D9HPWLPH.mjs";
-import { a as planClean, t as applyClean } from "./clean-BPITM-6p.mjs";
+import { $ as adoptedCalls, $n as settingsOf, $t as normalizeTitle, B as peerOf, Cn as inRepoPlace, Ct as runTree, D as inspectProject, Dn as projectsHome, En as placeFor, F as createCalls, Gt as FEEDBACK_TARGETS, I as addressOf, K as requestStop, L as endLink, Lt as PROJECT_FILE, M as clearGitLocalEnv, Mn as projectRootOf, N as parseInputPairs, On as runDirOf, P as resolveInputs, Qt as fingerprint, R as endLinksOf, Rt as gitRulesOf, Sn as hasInRepoFiles, St as runStatus, Tn as placeFiles, U as flattenTree, Un as beforeOf, Ut as FEEDBACK_KINDS, V as tellNode, Wt as FEEDBACK_SEVERITIES, Xn as WorkflowSchema, Yt as sendPost, Zt as createFeedback, _ as lateTriggers, _n as createAgent, an as serveRun, ar as INTEGRATIONS, at as followEvents, bn as loadAgents, bt as liveStatus, cn as wakeRun, cr as AGENT_TOOL_LAYOUTS, ct as planNodeSession, d as runningRunIds, dn as planAgentMigration, dr as firstLine, et as detachResume, f as runningScript, fn as applySteps, fr as EXPERIMENTS, gn as toolsInUse, gt as startRun, h as isNewer, hn as toolLinks, ht as walkSummary, i as NOT_STARTED, it as detachRun, jn as inside, kn as shownPath, kt as nestItems, l as planUpgrade, ln as maskReplacer, lr as ORK_LAYOUT, lt as namingNoDriver, mn as linkTools, mr as knownExperiments, n as resolveBase, nt as listKey, on as socketPath, pn as planMoveInto, pr as experimentsOn, q as tellLiveRun, qn as serializeWorkflow, qt as planPost, rt as DETACHED_ENV, sn as socketRoom, t as createWorkspace, tr as isClaudeNode, tt as resumable, u as releaseNotes, un as maskSecrets, ur as CLAUDE_DRIVERS, ut as sessionDriver, v as triggersReport, vn as deleteAgent, vt as userMessageText, wn as newProjectId, wt as templateOf, yn as catalogAgent, zt as loadProject } from "./src-BwFxTank.mjs";
+import { C as placeOf, T as openFixRun, _ as nodeSession, b as recordNote, c as checkDue, d as pendingNotice, f as readUpdateCache, g as activeTree, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, s as runInstall, t as ORK_NAME, u as newerVersion$1, v as previewPost, w as feedbackActions, x as acceptItem, y as checkNote } from "./__build_info__-y1TPvZvp.mjs";
+import { i as builtinWorkflowFile, n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-BphP3ONM.mjs";
+import { n as newRunId, t as findRun } from "./find-BXZjliwr.mjs";
+import { a as write, c as openStore, i as style, l as storePath, n as cost, o as writeErr, s as isNodeEvent, t as confirm } from "./output-BVkI6ZVv.mjs";
+import { n as listOrkWorktrees, t as createdWorktrees } from "./list-BmxgNyd3.mjs";
+import { a as planClean, t as applyClean } from "./clean-BRUXyk87.mjs";
 import { c as subcommandsOf, i as argsOf, n as groupedEntries, o as publicArgs, s as resolved, t as groupOf } from "./help-groups-BwYoAWsh.mjs";
-import { _ as namedMcpEntries, a as builtinExecutors, d as maskedEnv, f as maskedNamesOfRun, g as clearOutputFiles, h as sessionEnv, i as onPath, l as clearStateFiles, m as runScrubber, n as missingProgramMessage, r as missingPrograms, t as envProblems, v as resultOf } from "./src-CUeMUVwW.mjs";
-import { c as registeredProjects, i as refusedBuiltin, n as WORKFLOW_SUFFIX, o as workflowArg, s as projectAt, t as WORKFLOW_DIR } from "./workflows-BNCDD6J-.mjs";
-import { a as validate, c as warningLines, i as loadWorkflow, o as validateFile, r as formatReport, s as walkLoaded, t as context } from "./context-CZNM454F.mjs";
-import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-BKzVMwkt.mjs";
-import { i as decideRefusal, n as chatRefusal } from "./in-a-run-D_fnj1Mw.mjs";
+import { _ as namedMcpEntries, a as builtinExecutors, d as maskedEnv, f as maskedNamesOfRun, g as clearOutputFiles, h as sessionEnv, i as onPath, l as clearStateFiles, m as runScrubber, n as missingProgramMessage, r as missingPrograms, t as envProblems, v as resultOf } from "./src-W1i5Bl6N.mjs";
+import { c as registeredProjects, i as refusedBuiltin, n as WORKFLOW_SUFFIX, o as workflowArg, s as projectAt, t as WORKFLOW_DIR } from "./workflows-BJdSHnkr.mjs";
+import { a as validate, c as warningLines, i as loadWorkflow, o as validateFile, r as formatReport, s as walkLoaded, t as context } from "./context-Dbay8l7P.mjs";
+import { a as nodeVerdict, i as hasConflict, n as formatRuns, o as firstLine$1, r as formatTree, s as formatBusEvent, t as ago } from "./format-DeT7vL-8.mjs";
+import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-CBeoYrUH.mjs";
+import { i as decideRefusal, n as chatRefusal } from "./in-a-run-C4E9HfED.mjs";
 import path from "node:path";
 import { stringify } from "yaml";
 import { z } from "zod";
@@ -53,6 +53,221 @@ const readyDriver = (checks) => {
 		ready: ready.length
 	};
 };
+// ../core/src/control/queue.ts
+const PERMISSION_OPTIONS = [{
+	id: "allow",
+	label: "Allow"
+}, {
+	id: "deny",
+	label: "Deny"
+}];
+const DENIED = "The user did not allow this tool.";
+/** The deny message a session gets, with the person's words when given. */
+const deniedMessage = (note) => note === void 0 ? DENIED : `${DENIED} They said: ${note}`;
+/** The input fields that say what a tool will do, the first one present. */
+const TOOL_INPUT_KEYS = [
+	"command",
+	"file_path",
+	"path",
+	"url",
+	"pattern"
+];
+/** A tool's input for the decision's context: as written, cut at `max`. */
+const inputContext = (input, max = 4e3) => {
+	const key = TOOL_INPUT_KEYS.find((k) => typeof input[k] === "string");
+	const text = key === void 0 ? JSON.stringify(input, void 0, 2) : String(input[key]);
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+};
+const createDecisionQueue = (options) => {
+	const { store, runId, emit } = options;
+	const earlier = store.decisions({ runId });
+	let count = Math.max(0, ...earlier.map(({ id }) => Number(id.slice(runId.length + 1)) || 0));
+	for (const { id, node, status } of earlier) {
+		if (status !== "open") continue;
+		store.withdrawDecision(id);
+		emit({
+			type: "decision.withdrawn",
+			node,
+			decision: id
+		});
+	}
+	/** Opens a decision and settles it with the first answer. */
+	const decide = (open, local, withdrawn) => {
+		count += 1;
+		const id = `${runId}-${String(count)}`;
+		const record = store.openDecision({
+			...open,
+			id,
+			runId
+		});
+		const event = {
+			type: "decision.opened",
+			node: record.node,
+			decision: id,
+			kind: record.kind,
+			question: record.question,
+			options: record.options
+		};
+		if (record.recommended !== void 0) event.recommended = record.recommended;
+		if (record.owner !== void 0) event.owner = record.owner;
+		emit(event);
+		const { promise, resolve, reject } = Promise.withResolvers();
+		const settled = new AbortController();
+		/** `note` is the stored one: masked, and absent when blank. */
+		const finish = (answer, by, note) => {
+			if (settled.signal.aborted) return;
+			settled.abort();
+			const answered = {
+				type: "decision.answered",
+				node: open.node,
+				decision: id,
+				answer,
+				by
+			};
+			if (note !== void 0) answered.note = note;
+			emit(answered);
+			resolve(note === void 0 ? {
+				answer,
+				by
+			} : {
+				answer,
+				by,
+				note
+			});
+		};
+		const withdraw = () => {
+			if (settled.signal.aborted) return;
+			settled.abort();
+			store.withdrawDecision(id);
+			emit({
+				type: "decision.withdrawn",
+				node: open.node,
+				decision: id
+			});
+			reject(/* @__PURE__ */ new Error("the question was withdrawn"));
+		};
+		if (withdrawn?.aborted === true) withdraw();
+		withdrawn?.addEventListener("abort", withdraw, { once: true });
+		const fromStore = async () => {
+			try {
+				const closed = await options.waitFor(id, settled.signal);
+				if (closed.status === "answered" && closed.answer !== void 0) finish(closed.answer, closed.answeredBy ?? "decide", closed.note);
+			} catch {}
+		};
+		const fromTerminal = async (ask) => {
+			try {
+				const { answer, note } = await ask(settled.signal);
+				if (store.answerDecision(id, answer, "terminal", note)) finish(answer, "terminal", store.decision(id)?.note);
+			} catch {}
+		};
+		fromStore();
+		if (local !== void 0) fromTerminal(local);
+		return promise;
+	};
+	return {
+		ask: (question) => {
+			const open = {
+				node: question.nodeId,
+				kind: "question",
+				question: question.question,
+				options: question.options
+			};
+			if (question.recommended !== void 0) open.recommended = question.recommended;
+			if (question.context !== void 0) open.context = question.context;
+			if (question.document !== void 0) open.document = question.document;
+			if (question.owner !== void 0) open.owner = question.owner;
+			const { local } = options;
+			return decide(open, local === void 0 ? void 0 : (signal) => {
+				let note;
+				return local.ask({
+					...question,
+					question: maskSecrets(question.question),
+					...question.context === void 0 ? {} : { context: maskSecrets(question.context) },
+					...question.document === void 0 ? {} : { document: maskSecrets(question.document) },
+					signal,
+					onNote: (given) => {
+						note = given;
+					}
+				}).then((answer) => note === void 0 ? { answer } : {
+					answer,
+					note
+				});
+			}, question.signal).then(({ answer, note }) => {
+				if (note !== void 0) question.onNote?.(note);
+				return answer;
+			});
+		},
+		settled: (question) => {
+			count += 1;
+			const id = `${runId}-${String(count)}`;
+			const { owner } = question;
+			const record = store.openDecision({
+				id,
+				runId,
+				node: question.nodeId,
+				kind: "question",
+				question: question.question,
+				options: question.options,
+				owner,
+				...question.recommended === void 0 ? {} : { recommended: question.recommended },
+				...question.context === void 0 ? {} : { context: question.context }
+			});
+			emit({
+				type: "decision.opened",
+				node: record.node,
+				decision: id,
+				kind: "question",
+				question: record.question,
+				options: record.options,
+				owner,
+				...record.recommended === void 0 ? {} : { recommended: record.recommended }
+			});
+			store.answerDecision(id, question.answer, "owner", question.note);
+			const note = store.decision(id)?.note;
+			emit({
+				type: "decision.answered",
+				node: record.node,
+				decision: id,
+				answer: question.answer,
+				by: "owner",
+				owner,
+				...note === void 0 ? {} : { note }
+			});
+		},
+		permit: async (request) => {
+			const { local } = options;
+			let localMessage = DENIED;
+			const { answer, note } = await decide({
+				node: request.nodeId,
+				kind: "permission",
+				question: `Allow ${request.toolName}?`,
+				options: PERMISSION_OPTIONS,
+				context: inputContext(request.input)
+			}, local === void 0 ? void 0 : (signal) => {
+				let said;
+				return local.permit({
+					...request,
+					signal,
+					onNote: (given) => {
+						said = given;
+					}
+				}).then((result) => {
+					if (!result.allow) localMessage = result.message;
+					const choice = result.allow ? "allow" : "deny";
+					return said === void 0 ? { answer: choice } : {
+						answer: choice,
+						note: said
+					};
+				});
+			}, request.signal);
+			if (note !== void 0) request.onNote?.(note);
+			return answer === "allow" ? { allow: true } : {
+				allow: false,
+				message: note === void 0 ? localMessage : deniedMessage(note)
+			};
+		}
+	};
+};
 // ../core/src/control/control.ts
 const startControl = async (options) => {
 	const { store, runId } = options;
@@ -482,6 +697,7 @@ const createReplay = (history, cutOff = /* @__PURE__ */ new Map(), mail, earlier
 			return null;
 		},
 		previousSession: ({ id, item, round = 0 }) => item === void 0 || renewed.has(item.of) ? void 0 : [...fanOuts.items.get(id) ?? []].findLast(([before]) => before < round)?.[1].sessionId,
+		lastOutput: (id) => history.get(id)?.at(-1)?.output,
 		kept: () => [...history.keys(), ...fanOuts.items.keys()],
 		...mail === void 0 ? {} : { mail },
 		...earlier === void 0 ? {} : { earlier }
@@ -589,6 +805,285 @@ const renderHelp = async (cmd, parent) => {
 const showHelp = async (cmd, parent) => {
 	process.stdout.write(`${await renderHelp(cmd, parent)}\n\n`);
 };
+// src/human.ts
+/**
+* @file The terminal `HumanChannel`: answers `ask_user` questions, gates and
+*   permission prompts on the terminal, one at a time, and denies or defers
+*   when no one is there. After a choice it offers one optional line for a
+*   note, which Enter skips. In a run it is the decision queue's local
+*   answerer, racing `ork decide`.
+*/
+const PREVIEW = 160;
+/** A document longer than this is offered (`d`) rather than printed. */
+const SHORT_DOCUMENT_LINES = 40;
+const NO_ONE_TO_PERMIT = "No one is at the terminal to approve this tool, so it is not allowed in this run.";
+const NOTE_PROMPT = "  Note for the run (optional, Enter to skip): ";
+const NO_ONE_TO_ASK = "no one (nobody is at the terminal; use your best judgment and say so in your report)";
+/** One line that shows what a tool is about to do. */
+const previewInput = (toolName, input) => {
+	const key = TOOL_INPUT_KEYS.find((k) => typeof input[k] === "string");
+	const line = (key === void 0 ? JSON.stringify(input) : `${key}: ${String(input[key])}`).replaceAll(/\s+/gu, " ").trim();
+	return line.length > PREVIEW ? `${toolName} ${line.slice(0, 159)}…` : `${toolName} ${line}`;
+};
+/** The option an answer names: its number, or its id. */
+const pickOption = (answer, options, recommended) => {
+	const value = answer.trim();
+	if (value === "") return recommended;
+	const index = Number(value);
+	if (Number.isInteger(index) && index >= 1 && index <= options.length) return options[index - 1]?.id;
+	return options.find((o) => o.id === value)?.id;
+};
+const optionLine = (option, index, recommended) => {
+	const label = option.label === void 0 ? "" : ` ${option.label}`;
+	const description = option.description === void 0 ? "" : style("dim", ` - ${option.description}`);
+	const mark = option.id === recommended ? style("green", " (recommended)") : "";
+	return `  ${String(index + 1)}) ${style("bold", option.id)}${label}${description}${mark}`;
+};
+/**
+* Answers permission prompts and `ask_user` questions on the terminal, one at a
+* time. Without a terminal it denies tools and leaves questions to the node. A
+* withdrawn prompt (answered elsewhere) rejects, which frees the turn.
+*/
+const createTerminalHuman = (io) => {
+	let rl;
+	let turn = Promise.resolve();
+	const say = (text) => {
+		io.output.write(`${text}\n`);
+	};
+	const prompt = (text, signal) => {
+		if (rl === void 0) {
+			rl = createInterface({
+				input: io.input,
+				output: io.output
+			});
+			if (io.interrupt !== void 0) rl.on("SIGINT", io.interrupt);
+		}
+		return signal === void 0 ? rl.question(text) : rl.question(text, { signal });
+	};
+	/** The optional line after a choice, when the asker takes a note. */
+	const takeNote = async (onNote, signal) => {
+		if (onNote === void 0) return;
+		const note = (await prompt(NOTE_PROMPT, signal)).trim();
+		if (note !== "") onNote(note);
+	};
+	const choose = async (hint, options, recommended, signal, document) => {
+		const answer = await prompt(`  Choose${hint}: `, signal);
+		const picked = pickOption(answer, options, recommended);
+		if (picked !== void 0) return picked;
+		if (document !== void 0 && answer.trim() === "d") say(document);
+		else say(style("dim", "  Type an option's number or id."));
+		return choose(hint, options, recommended, signal, document);
+	};
+	const oneAtATime = (work) => {
+		const result = turn.then(work);
+		turn = result.catch(() => null);
+		return result;
+	};
+	return {
+		permit: ({ nodeId, toolName, input, signal, onNote }) => oneAtATime(async () => {
+			if (signal?.aborted === true) throw new Error("the prompt was withdrawn");
+			say(`${style(["yellow", "bold"], "?")} ${style("bold", nodeId)} wants to run ${previewInput(toolName, input)}`);
+			if (!io.interactive) {
+				say(style("dim", `  denied: ${NO_ONE_TO_PERMIT}`));
+				return {
+					allow: false,
+					message: NO_ONE_TO_PERMIT
+				};
+			}
+			const answer = (await prompt("  Allow? [y/N] ", signal)).trim().toLowerCase();
+			if (answer === "y" || answer === "yes") return { allow: true };
+			await takeNote(onNote, signal);
+			return {
+				allow: false,
+				message: "The user did not allow this tool."
+			};
+		}),
+		ask: ({ nodeId, question, options, recommended, context, document, signal, onNote }) => oneAtATime(async () => {
+			if (signal?.aborted === true) throw new Error("the question was withdrawn");
+			const documentLines = document?.trimEnd().split("\n").length ?? 0;
+			if (document !== void 0 && documentLines <= SHORT_DOCUMENT_LINES) say(document);
+			say(`${style(["yellow", "bold"], "?")} ${style("bold", nodeId)} asks: ${question}`);
+			if (context !== void 0) say(style("dim", `  ${context.replaceAll("\n", "\n  ")}`));
+			for (const [index, option] of options.entries()) say(optionLine(option, index, recommended));
+			if (!io.interactive) {
+				const answer = recommended ?? NO_ONE_TO_ASK;
+				say(style("dim", `  no terminal; answered ${answer}`));
+				return answer;
+			}
+			const fallback = options.findIndex((o) => o.id === recommended);
+			const hint = fallback === -1 ? "" : ` [${String(fallback + 1)}]`;
+			if (documentLines > SHORT_DOCUMENT_LINES) say(`  Document: ${String(documentLines)} lines. Type d to read it.`);
+			const picked = await choose(hint, options, recommended, signal, document);
+			await takeNote(onNote, signal);
+			return picked;
+		}),
+		close: () => {
+			rl?.close();
+		}
+	};
+};
+// src/run/format-result.ts
+const RUN_MARK = {
+	succeeded: style("green", "✓"),
+	failed: style("red", "✗"),
+	budget_exhausted: style("yellow", "!"),
+	quota_exhausted: style("yellow", "!"),
+	timed_out: style("yellow", "!"),
+	interrupted: style("yellow", "!")
+};
+/** `1 failure handled`, `2 failures handled`. */
+const failuresHandled = (count) => `${String(count)} ${count === 1 ? "failure" : "failures"} handled`;
+/**
+* The run summary: status, cost, what ran, what was skipped and which failures
+* an edge handled, branches to look at, why, and mail to nodes that never ran.
+*/
+const formatRunResult = (result) => {
+	const ran = result.nodes.filter((n) => n.runs > 0).length;
+	const skipped = result.skipped ?? result.nodes.length - ran;
+	const handled = result.failuresHandled ?? 0;
+	const lines = ["", `${RUN_MARK[result.status]} run ${result.runId} ${result.status.replace("_", " ")} ${style("dim", `· ${cost(result.costUsd)} · ${String(ran)} ran, ${String(skipped)} skipped${handled === 0 ? "" : `, ${failuresHandled(handled)}`}`)}`];
+	for (const kept of result.worktrees) lines.push(`  ${kept.id}: ${kept.branch ?? "detached"} ${style("dim", `at ${kept.path} (${kept.reason})`)}`);
+	for (const reason of result.reasons) lines.push(`  ${style("red", reason)}`);
+	for (const { node, messages } of result.unread ?? []) lines.push(`  ${style(["yellow", "bold"], "warning")} ${node} never ran, so ${messages === 1 ? "1 message" : `${String(messages)} messages`} to it went unread`);
+	return lines;
+};
+// src/run/format.ts
+/** Who answered a decision, as the log says it. */
+const ANSWERED_BY = {
+	terminal: "terminal",
+	decide: "ork decide",
+	ui: "ork ui",
+	owner: "its owner"
+};
+const STATUS_MARK = {
+	pass: style("green", "✓"),
+	done: style("green", "✓"),
+	changes_requested: style("yellow", "!"),
+	fail: style("red", "✗")
+};
+const seconds = (ms) => `${(ms / 1e3).toFixed(1)}s`;
+const indent = (text) => text.trimEnd().split("\n").map((line) => `  ${line}`);
+/** The usage line: cost, tokens, turns and time. */
+const formatUsage = ({ usage }) => style("dim", [
+	cost(usage.costUsd),
+	`${String(usage.inputTokens)} in / ${String(usage.outputTokens)} out (${String(usage.cacheReadTokens)} cached)`,
+	`${String(usage.turns)} turns`,
+	seconds(usage.durationMs)
+].join(" · "));
+/** How a finished session reads on the terminal. */
+const formatOutcome = (nodeId, outcome) => {
+	const { report } = outcome;
+	if (report === null) return [
+		`${style("red", "✗")} ${style("bold", nodeId)} ended without a report (${outcome.subtype})`,
+		...outcome.errors.map((e) => `  ${style("red", e)}`),
+		`  ${formatUsage(outcome)}`
+	];
+	const lines = [`${STATUS_MARK[report.status] ?? "-"} ${style("bold", nodeId)} ${report.status}: ${report.summary}`];
+	if (report.branch !== void 0) lines.push(`  branch: ${report.branch}`);
+	for (const [name, file] of Object.entries(report.artifacts)) lines.push(`  ${name}: ${file}`);
+	for (const [name, value] of Object.entries(report.fields)) lines.push(`  ${name}: ${JSON.stringify(value)}`);
+	lines.push(`  ${formatUsage(outcome)}`);
+	return lines;
+};
+/** The transcript lines for one event; tool names come from `tools`. */
+const formatEvent = (nodeId, event, tools) => {
+	if (event.type === "session.started") {
+		const fork = event.fork === true ? ", a fork to answer a question" : "";
+		return [style("dim", `▸ ${nodeId} (${event.model}, session ${event.sessionId}${fork})`)];
+	}
+	if (event.type === "assistant.text") return indent(event.text);
+	if (event.type === "tool.called") {
+		tools.set(event.id, event.name);
+		return [style("dim", `  · ${previewInput(event.name, event.input)}`)];
+	}
+	if (event.type === "tool.result") return event.isError ? [style("red", `  ✗ ${tools.get(event.id) ?? "tool"} failed`)] : [];
+	if (event.type === "plan.limit") return event.status === "allowed" ? [] : [style("yellow", `  ! plan: ${event.window.replaceAll("_", " ")} limit ${event.status === "rejected" ? "reached" : "is close"}`)];
+	return formatOutcome(nodeId, event.outcome);
+};
+const items = (count) => `${String(count)} ${count === 1 ? "item" : "items"}`;
+/** Transcript lines for one run event, prefixed with the node they are from. */
+const formatRunEvent = (event, width, tools, terminal = false) => {
+	const tag = (id) => style("cyan", `${id.padEnd(width)} │`);
+	if (event.type === "run.started") return [style("dim", `▸ run ${event.runId} of ${event.workflow} (starts at ${event.entries.join(", ")})`), ...event.settings?.trigger === void 0 ? [] : [style("dim", `  started by trigger ${event.settings.trigger}; untrusted inputs: ${(event.settings.untrusted ?? []).join(", ") || "none"}`)]];
+	if (event.type === "node.started") {
+		const round = event.round > 1 ? ` (round ${String(event.round)})` : "";
+		const owner = event.owner === void 0 ? "" : `, for ${event.owner}`;
+		return [`${tag(event.id)} ${style("dim", `${event.nodeType}${round}${owner}`)}`];
+	}
+	if (event.type === "node.event") {
+		const inner = event.event;
+		if (inner.type === "session.finished") return [];
+		const fork = inner.fork === true ? style("dim", "fork · ") : "";
+		if (inner.type === "session.started") {
+			const why = inner.fork === true ? ", to answer a question" : "";
+			return [`${tag(event.id)} ${fork}${style("dim", `${inner.model}, session ${inner.sessionId}${why}`)}`];
+		}
+		return formatEvent(event.id, event.event, tools).map((line) => `${tag(event.id)} ${fork}${line.replace(/^ {2}/u, "")}`);
+	}
+	if (event.type === "node.finished") {
+		const conflict = hasConflict(event.output);
+		const mark = event.ok ? style(conflict ? "yellow" : "green", conflict ? "!" : "✓") : style("red", "✗");
+		const spent = event.usage === void 0 ? "" : style("dim", ` · ${cost(event.usage.costUsd)}`);
+		return [`${tag(event.id)} ${mark} ${nodeVerdict(event.output, event.ok, event.error)}${spent}`];
+	}
+	if (event.type === "node.skipped") return [`${tag(event.id)} ${style("dim", "- skipped")}`];
+	if (event.type === "loop.exhausted") return [`${style(["yellow", "bold"], "!")} the loop ${event.from} -> ${event.to} used all ${String(event.maxRounds)} rounds`];
+	if (event.type === "watch.started") return [`${tag(event.id)} ${style("dim", `watching until ${event.until}, every ${event.every}`)}`];
+	if (event.type === "watch.changed") return [`${tag(event.id)} ${style("dim", `look ${String(event.looks)}:`)} ${event.said}`];
+	if (event.type === "watch.ended") return [`${tag(event.id)} ${style("dim", `${event.outcome} after ${String(event.looks)} looks`)}`];
+	if (event.type === "edge.taken") return [];
+	if (event.type === "worktree") {
+		const detail = event.detail === void 0 ? "" : ` (${event.detail})`;
+		const what = event.action === "removed" && event.branch !== void 0 ? `worktree of ${event.branch} (branch kept)` : `${event.branch ?? event.path}${detail}`;
+		const line = `${event.action} ${what}`;
+		return [`${tag(event.id)} ${event.action === "conflict" ? style("yellow", `! ${line}`) : style("dim", `⎇ ${line}`)}`];
+	}
+	if (event.type === "decision.opened") {
+		const what = event.kind === "permission" ? "asks to" : "asks:";
+		const question = event.kind === "permission" ? event.question.replace(/^Allow /u, "run ").replace(/\?$/u, "") : event.question;
+		const where = event.owner === void 0 ? `decision ${event.decision}; ${terminal ? "answer here or with ork decide" : "ork decide"}` : `decision ${event.decision}, via ${event.owner}`;
+		return [`${tag(event.node)} ${style(["yellow", "bold"], "?")} ${what} ${question} ${style("dim", `(${where})`)}`];
+	}
+	if (event.type === "decision.answered") {
+		const by = event.by === "owner" && event.owner !== void 0 ? event.owner : ANSWERED_BY[event.by];
+		const said = event.note === void 0 ? "" : ` · said: ${event.note.replaceAll(/\s+/gu, " ")}`;
+		return [`${tag(event.node)} ${style("dim", `→ ${event.answer} (${by})${said}`)}`];
+	}
+	if (event.type === "decision.withdrawn") return [`${tag(event.node)} ${style("dim", "→ question withdrawn")}`];
+	if (event.type === "run.command") {
+		const node = event.node === void 0 ? "" : ` --node ${event.node}`;
+		return [style(["yellow", "bold"], `! ork ${event.command}${node} received`)];
+	}
+	if (event.type === "node.held") {
+		const at = event.at === "tool" ? "its tool call waits for ork continue" : "it starts after ork continue";
+		return [`${tag(event.id)} ${style("yellow", `‖ paused: ${at}`)}`];
+	}
+	if (event.type === "node.released") return [`${tag(event.id)} ${style("dim", "▸ continues")}`];
+	if (event.type === "each.listed") {
+		const round = event.round > 1 ? ` (round ${String(event.round)})` : "";
+		return [`${tag(event.node)} ${style("dim", `${items(event.count)}${round}`)}`];
+	}
+	if (event.type === "each.exceeded") {
+		const over = `${items(event.count)}, over maxItems ${String(event.maxItems)}`;
+		return [`${tag(event.node)} ${style("yellow", `! ${over}`)}`];
+	}
+	if (event.type === "run.finished") return formatRunResult(event.result);
+	if (event.type === "run.resumed") {
+		const [one] = event.kept;
+		const kept = one === void 0 ? "every node runs again" : event.kept.length === 1 ? `${one} keeps its result` : `${event.kept.join(", ")} keep their results`;
+		return ["", style("dim", `▸ resumed: ${kept}`)];
+	}
+	if (event.type === "feedback.recorded") {
+		const { target, kind, title } = event.feedback;
+		const line = style("dim", `✎ feedback (${target}, ${kind}): ${title}`);
+		return [event.node === void 0 ? line : `${tag(event.node)} ${line}`];
+	}
+	if (event.type === "user.message") {
+		const note = event.delivered === "queued" ? " (for its next session)" : "";
+		return [`${tag(event.node)} ${style(["magenta", "bold"], "you:")} ${firstLine$1(event.body)}${style("dim", note)}`];
+	}
+	return formatBusEvent(event).map((line) => `${tag(event.node)} ${line}`);
+};
 // src/update/notify.ts
 /**
 * @file The new-version notice (ADR-038). At most once a day a command starts a
@@ -684,7 +1179,7 @@ const versionCheck = (current, cache, checksOff) => {
 	return {
 		name: "ork",
 		status: "ok",
-		detail: `${current} (${cache?.latest === void 0 ? checksOff ? "update check off" : "not checked for updates yet" : `the latest as of ${cache.checkedAt.slice(0, 10)}`})`
+		detail: `${current} (${cache?.latest === void 0 ? checksOff === null ? "not checked for updates yet" : `the daily update check is off here: ${checksOff}` : `the latest as of ${cache.checkedAt.slice(0, 10)}`})`
 	};
 };
 // src/doctor/checks.ts
@@ -708,7 +1203,7 @@ const exec = (program, args) => new Promise((resolve) => {
 	});
 });
 /** Ork's own version, against the last update check (no network). */
-const orkCheck = () => versionCheck(ORK_VERSION, readUpdateCache(updateCachePath()), updateCheckOff(process.env, [], true) !== null);
+const orkCheck = () => versionCheck(ORK_VERSION, readUpdateCache(updateCachePath()), updateCheckOff(process.env, [], process.stderr.isTTY));
 const MIN_NODE = [24, 20];
 const checkNode = (version) => {
 	const [major = 0, minor = 0] = version.split(".").map(Number);
@@ -724,6 +1219,23 @@ const checkNode = (version) => {
 		hint: `Ork needs Node ${MIN_NODE.join(".")} or later.`
 	};
 };
+/** A work tree with no commit has no `HEAD` for a worktree to branch from. */
+const checkHead = async (run) => {
+	return (await run("git", [
+		"rev-parse",
+		"--verify",
+		"HEAD"
+	])).ok ? {
+		name: "git commits",
+		status: "ok",
+		detail: "HEAD exists"
+	} : {
+		name: "git commits",
+		status: "warn",
+		detail: "no commit yet",
+		hint: "Make a first commit: worktree runs branch from HEAD."
+	};
+};
 const checkGit = async (run) => {
 	const version = await run("git", ["--version"]);
 	if (!version.ok) return [{
@@ -733,20 +1245,30 @@ const checkGit = async (run) => {
 		hint: "Install git; Ork gives each writing node its own worktree."
 	}];
 	const inside = await run("git", ["rev-parse", "--is-inside-work-tree"]);
-	return [{
-		name: "git",
-		status: "ok",
-		detail: firstLine(version.stdout)
-	}, inside.ok ? {
-		name: "git repo",
-		status: "ok",
-		detail: "inside a work tree"
-	} : {
-		name: "git repo",
-		status: "warn",
-		detail: "not a git repository",
-		hint: "Run Ork inside a git repository so nodes can use worktrees."
-	}];
+	const head = inside.ok ? await checkHead(run) : null;
+	return [
+		{
+			name: "git",
+			status: "ok",
+			detail: firstLine(version.stdout)
+		},
+		inside.ok ? {
+			name: "git repo",
+			status: "ok",
+			detail: "inside a work tree"
+		} : {
+			name: "git repo",
+			status: "warn",
+			detail: "not a git repository",
+			hint: "Run Ork inside a git repository so nodes can use worktrees."
+		},
+		...head === null ? [] : [head]
+	];
+};
+/** What `ork init` warns of: a work tree with no commit, else null. */
+const headWarning = async (run) => {
+	const head = (await checkGit(run)).find((r) => r.name === "git commits");
+	return head?.status === "warn" ? `${head.detail}. ${head.hint ?? ""}`.trim() : null;
 };
 /**
 * Runs every check: Node and git, then every registered Claude driver and
@@ -1011,6 +1533,16 @@ const createLogPrinter = (options) => {
 	};
 };
 /**
+* Why `--node` names nothing in this run, or `null`: no event names it and the
+* run didn't declare it. A live run may still start it, so that is not
+* refused.
+*/
+const unknownNode = (stored, node, live) => {
+	const named = stored.some(({ event }) => isNodeEvent(event, node));
+	const declared = stored.some(({ event }) => event.type === "run.started" && event.nodes.some((n) => n.id === node));
+	return named || declared || live ? null : `Run has no node ${node}.`;
+};
+/**
 * Prints a run's events; with `follow`, then each new one as it is stored:
 * pushed over the run's socket, or polled from the store when there is none.
 * Returns when `run.finished` is stored, the run's process is gone, or `signal`
@@ -1537,7 +2069,7 @@ const runWorkflowFile = async (options) => {
 		for (const event of signals(raw)) {
 			control.publish(record(event));
 			if (options.json) options.out(JSON.stringify(event));
-			else for (const line of formatRunEvent(event, width, tools)) options.out(line);
+			else for (const line of formatRunEvent(event, width, tools, options.human !== void 0)) options.out(line);
 		}
 	};
 	const workspace = root === void 0 ? void 0 : createWorkspace({
@@ -1634,7 +2166,7 @@ const flagValues = (rawArgs, flag) => {
 };
 const isDriver = (value) => CLAUDE_DRIVERS.some((d) => d.id === value);
 /** Loads the drivers only when a run starts, so other commands stay fast. */
-const loadRuntime = async (driver) => (await import("./src-DhGLtYR-.mjs")).createRuntime(driver, sessionEnv(process.env));
+const loadRuntime = async (driver) => (await import("./src-bOImrq43.mjs")).createRuntime(driver, sessionEnv(process.env));
 /**
 * Ctrl-C asks the run to stop, and so does a terminal closing or a polite kill,
 * so that the run ends tidily and leaves no result unscrubbed.
@@ -1652,11 +2184,18 @@ const onInterrupt = (stop) => {
 	process.once("SIGHUP", interrupt);
 };
 /** The terminal that answers a run's questions; none in a detached run. */
-const terminalHuman = () => process.env["ORK_DETACHED"] === "1" ? void 0 : createTerminalHuman({
-	input: process.stdin,
-	output: process.stderr,
-	interactive: process.stdin.isTTY
-});
+const terminalHuman = () => {
+	const detached = process.env[DETACHED_ENV] === "1";
+	if (detached) writeErr(style("dim", "detached run: no terminal asks; answer with ork decide"));
+	return detached ? void 0 : createTerminalHuman({
+		input: process.stdin,
+		output: process.stderr,
+		interactive: process.stdin.isTTY,
+		interrupt: () => {
+			process.kill(process.pid, "SIGINT");
+		}
+	});
+};
 const run = defineCommand({
 	meta: {
 		name: "run",
@@ -2321,7 +2860,7 @@ const ORK_SKILLS = {
 	principles: "---\nname: principles\ndescription: Use when deciding how to split work into an Ork workflow - which steps are programs, which are Claude sessions, where a person decides - so it costs less than doing it by hand and can't go wrong quietly.\n---\n\n# How Ork splits work\n\nOrk exists to do long jobs for less than doing them by hand, and safely. Four\nrules decide the shape of a workflow.\n\n## 1. A program for what a program can do\n\nA model turn is for judgment. Anything a program can decide, it should: run the\ntests, read a pull request's state, count what changed, wait for CI.\n\n- **A tool node** (`tool.shell`, `tool.git`, `tool.gh`, `tool.aws`) or an\n  **`mcp.call`** does it with no session. With `output: { format: json }`, its\n  answer routes the run: `when: \"json.state == 'OPEN'\"`.\n- **`verify:`** on a session runs a check before its report counts, so a session\n  can't claim success past failing tests. **`before:`** hands it what a program\n  found, so it doesn't spend turns finding it.\n- **`watch:`** waits on CI or a review with a program that looks every few\n  seconds; hours of waiting cost nothing.\n- **`notify:`** lets a program tell a running session what it found, with no\n  model turn to carry the news.\n\n## 2. Spend where it pays\n\n- A small model and low effort for a narrow task (`model: haiku`,\n  `effort: low`); the large ones where thinking pays.\n- `budgetUsd` on each session and on the run (`limits.budgetUsd`). A loop of\n  sessions without a budget or `limits.timeout` gets a warning, for good reason.\n- Give a session what it needs in its `prompt` and `before:`, rather than\n  letting it search; and `isolation: readonly` for a reviewer that only reads.\n\n## 3. Make a mistake impossible before checking for it\n\n- Declare what a node says: `output.schema` lists on tool JSON and Claude\n  reports (`verdict: [approve, escalate]`). Conditions then compare against a\n  closed list, and a run fails a value off it rather than matching nothing.\n- A verdict is a declared field, never words to search a summary for.\n- Give each condition its opposite, and each failure a handler (`when: \"!ok\"`).\n- Check every draft with Ork's `check` tool until it's clean.\n\n## 4. A person decides what can't be undone\n\nMerging, deploying, publishing, spending a lot: put a `human.gate` before it,\nwith the safe option `recommended`. For a run nobody watches, give it a\n`timeout` and the safe `default`. You never answer a gate yourself.\n\n## An example\n\nA review that a program checks first, and a person signs off:\n\n```yaml\nschemaVersion: 1\nname: careful-review\ndescription: Lint with a program, review with a small model, and ask before merging.\ninputs:\n  pr:\n    type: string\n    required: true\nlimits:\n  budgetUsd: 3\nnodes:\n  lint:\n    type: tool.shell\n    command: pnpm lint\n    allow: [pnpm lint]\n  review:\n    type: claude.worker\n    prompt: \"Review pull request {{inputs.pr}}. The linter passed.\"\n    model: haiku\n    effort: low\n    isolation: readonly\n    budgetUsd: 1\n    output:\n      schema:\n        verdict: [approve, escalate]\n  ask:\n    type: human.gate\n    question: \"Merge pull request {{inputs.pr}}? The review says {{nodes.review.output.verdict}}.\"\n    options: [merge, wait]\n    recommended: wait\n  merge:\n    type: tool.gh\n    command: pr merge {{inputs.pr}} --squash\n    allow: [pr merge]\nedges:\n  - lint -> review\n  - review -> ask\n  - from: ask\n    to: merge\n    when: \"choice == 'merge'\"\n```\n\n`lint` costs nothing, `review` is a small model with a cap, and nothing merges\nwithout a person.\n",
 	run: "---\nname: run\ndescription: Use when starting, following or explaining an Ork run - what it's doing, why it failed, what it cost, and what waits on the person - and when the person asks about their Ork runs.\n---\n\n# Running and following Ork workflows\n\nOrk runs workflows on the person's machine with their accounts, so a run spends\ntheir money and can push, merge or deploy. Start one only when they ask, and\nnever answer a decision for them.\n\n## Starting\n\n1. Find it: Ork's `workflows` tool gives each workflow's name and inputs.\n2. Check it first with `check` (`workflow: <name>`). Don't start one with an\n   error.\n3. Start it with `start_run`, giving every required input. Claude Code asks the\n   person first, unless they've allowed it. It answers with the run's id; the run goes on in the\n   background, whatever happens to this conversation.\n\nWithout Ork's tools: `ork run <workflow> --detach --input name=value`.\n\n## Following\n\n- `run` gives a run's status, what it waits on, its cost so far, and each\n  node's state. `runs` lists the newest runs.\n- `run_events` gives its newest events; `node` narrows them, and `last` or\n  `after` widens them. A `node.finished` event with `ok: false` says why a node\n  failed.\n- `explain_context` says what a node's session was given: its agent,\n  instructions, skills and files. Use it when a node didn't know something.\n- `usage` says what runs spent, by workflow and model, and how close the limits\n  are.\n\nSay what you found plainly: which node, what it said, and what it cost. Quote a\nnode's own words rather than retelling them.\n\n## What only the person does\n\n- **Decisions.** `decisions` lists the questions waiting on them: a gate, a loop\n  that ran out of rounds, a permission. Tell them what each asks, the options,\n  and the recommended one, and that they answer in `ork ui` or with\n  `ork decide` in their own terminal. Don't answer one: never run\n  `ork decide --id … --choose …`; with Ork's plugin, a hook stops it.\n- **Stopping, pausing, resuming.** Tell them the command: `ork stop <run>`,\n  `ork pause <run>`, `ork continue <run>`, `ork resume <run>`. A node can be\n  stopped alone with `--node <id>`.\n\n## Without Ork's tools\n\n| Want                   | Command                        |\n| ---------------------- | ------------------------------ |\n| Runs, newest first     | `ork ps`                       |\n| A run's transcript     | `ork logs <run>` (`--follow`)  |\n| Its nodes and cost     | `ork tree <run>`               |\n| What runs spent        | `ork usage`                    |\n| What waits on a person | `ork decide --list`            |\n| A node's context       | `ork context explain <wf> <n>` |\n",
 	setup: "---\nname: setup\ndescription: Use when the person asks you to set up Ork, install it, or get started with it in a repository - checking it's installed, setting up the project, making Ork's tools available to you, and a first workflow.\n---\n\n# Setting up Ork\n\nOrk runs workflows on the person's machine with their own accounts. Setting it\nup changes their machine and their repository, so say what each step does and\nask before it. Work through these in order, and stop where they say no.\n\n## 1. Check\n\n```sh\nork --version\nork doctor\n```\n\n- **No `ork`:** it needs Node 24.20 or later (`node --version`). The install is\n  `npm install --global @krapht/ork`; show it and run it only when they say\n  yes. The guide:\n  https://github.com/mimshins/ork/blob/main/docs/getting-started/installation.md\n- **Read `ork doctor` to them.** It needs git, a git repository with a commit,\n  and one Claude driver. Don't run `git init` or a commit without asking.\n- **A driver not ready:** they log in themselves, with `claude` (the CLI\n  driver), or by setting `ANTHROPIC_API_KEY` or a cloud provider in their own\n  shell (the SDK driver). Never ask for a key, never take one pasted to you, and\n  never write one into a file or a command. `gh` and `aws` are optional, and\n  their logins are their own too (`gh auth login`, `aws sso login`).\n\n## 2. The project\n\n- **`ork init`** keeps Ork's files in the repository, in `.ork/`, committed with\n  the code. It adds `.ork/runs/` to `.gitignore`, links `.claude/` and similar\n  folders to `.ork/`, and writes a starter workflow, `hello`.\n- **`ork register`** keeps them beside it, in `~/.ork/projects/<id>/`, and\n  writes nothing into the repository. For a repository whose process isn't\n  theirs to change, or to try Ork first.\n\nExplain both and ask which. Skip the question when the repository decides it: a\n`.ork/` folder means `ork init` has run (`ork projects` lists what's\nregistered). Neither overwrites a file.\n\n## 3. Make Ork available to you\n\nIf Ork's tools (`workflows`, `check`) already answer you, skip this. Otherwise,\nby where you run, and asking before each change to a config:\n\n- **Claude Code:** Ork's plugin brings the skills and the tools. The person\n  types these themselves:\n\n  ```\n  /plugin marketplace add mimshins/ork\n  /plugin install ork@ork\n  ```\n\n  Or, in a project set up with `ork init`, the skills in the repository for\n  everyone who clones it, then the tools:\n\n  ```sh\n  ork init --skills\n  claude mcp add ork -- ork mcp\n  ```\n\n  New tools start when they restart Claude Code or reconnect `ork` in `/mcp`;\n  so does the plugin's, once `ork` is installed.\n\n- **Another MCP client:** add a server named `ork` with command `ork` and args\n  `[\"mcp\"]` to its MCP config, where its own docs say. Its tools find the\n  project by its id, from `ork projects`.\n- **A shell only:** use the CLI. `ork --help` and each command's `--help` say\n  what it takes.\n\n## 4. A first workflow\n\nOffer to write one for a task they name. Follow `/ork:write`, check each draft\n(the `check` tool, or `ork validate <file>`) until it has no error, then save\nit. Don't start it: a run spends their money. Start it only when they say so,\nin the background with its inputs (`start_run`, or\n`ork run <name> --detach --input name=value`), and follow it with `/ork:run`.\n\n## 5. Show them `ork ui`\n\nTell them to run `ork ui` in their own terminal: their runs, graphs and logs in\nthe browser, and where they answer what a run asks.\n\n## Never\n\n- Ask for, store or pass on a password, key or token.\n- Answer a run's decision: they answer in `ork ui` or with `ork decide` in\n  their own terminal.\n- Install, edit a config, or start a run without a yes.\n",
-	write: "---\nname: write\ndescription: Use when writing or changing an Ork workflow (a `.ork/workflows/*.ork.yaml` file) - its nodes, edges, conditions and loops - and checking each draft until Ork accepts it.\n---\n\n# Writing an Ork workflow\n\nAn Ork workflow is one YAML file in the project, `.ork/workflows/<name>.ork.yaml`.\nIt names the nodes (Claude sessions, programs, a person's decisions) and the\nedges that carry work between them. Ork runs it on the person's machine with\ntheir own accounts.\n\n## How to work\n\n1. **Look first.** Ork's `workflows` tool lists the project's workflows; read\n   one that's close. `agents` lists the agents a node can use. Before you split\n   the work, read `/ork:principles`: a program where a program will do, a\n   session only for judgment.\n2. **Don't guess a field.** `workflow_format` gives the format; ask it for one\n   node type (`nodeType: \"human.gate\"`) to see that type's fields.\n3. **Check every draft** with Ork's `check` tool (`text`, or `workflow` for a\n   file), and fix what it says until it has no error. Read its warnings: they\n   mean something. Without Ork's tools, run `ork validate <file>`.\n4. **Then save the file**, beginning with the schema line below, so editors can\n   check it too.\n\n## The shape of a file\n\n```yaml\n# yaml-language-server: $schema=https://raw.githubusercontent.com/mimshins/ork/main/packages/schema/workflow.schema.json\nschemaVersion: 1\nname: fix-and-ship\ndescription: Fix a failing test, check it with the test suite, and ask before opening a pull request.\ninputs:\n  issue:\n    type: string\n    required: true\n    description: What fails.\ndefaults:\n  model: sonnet\n  budgetUsd: 2\nlimits:\n  budgetUsd: 10\nnodes:\n  fix:\n    type: claude.worker\n    prompt: \"Fix this, and keep the change small: {{inputs.issue}}\"\n  tests:\n    type: tool.shell\n    command: pnpm test\n    allow: [pnpm test]\n  ask:\n    type: human.gate\n    question: \"Open a pull request for {{nodes.fix.output.branch}}?\"\n    options: [open, hold]\n    recommended: hold\n  pr:\n    type: tool.gh\n    command: pr create --fill --head {{nodes.fix.output.branch}}\n    allow: [pr create]\nedges:\n  - fix -> tests\n  - from: tests\n    to: fix\n    when: \"!ok\"\n    maxRounds: 2\n  - from: tests\n    to: ask\n    when: ok\n  - from: ask\n    to: pr\n    when: \"choice == 'open'\"\n```\n\nNode ids are lowercase: letters, digits, `-` and `_`. Secrets never go in the\nfile: a tool reads one with `env:` and `{{env.NAME}}`.\n\n## Nodes\n\n| Type                              | Does                                                                |\n| --------------------------------- | ------------------------------------------------------------------- |\n| `claude.worker`                   | A Claude session that does one task and reports                     |\n| `claude.leader`                   | A session that plans and delegates to the nodes it owns (`parent:`) |\n| `claude.subagent`                 | A subagent inside its parent's session; it takes no edges           |\n| `tool.shell`                      | Any program, run without a shell; `allow:` lists command prefixes   |\n| `tool.git`, `tool.gh`, `tool.aws` | The person's own `git`, `gh`, `aws`, with an allow list             |\n| `mcp.call`                        | One tool call on an MCP server, with no session                     |\n| `human.gate`                      | A question with options and a recommended one                       |\n| `control.join`                    | Waits for its inputs: `all` (default), `any`, or `n` of them        |\n| `control.router`, `control.split` | Pass their input on; a router takes its first matching edge         |\n| `workflow.call`                   | Starts another workflow as its own run                              |\n\n- **A Claude node reports** `status` (`pass`, `changes_requested`, `done` or\n  `fail`), `summary`, `artifacts`, `branch`, and any field its `output.schema`\n  declares, such as `verdict: [approve, escalate]`. For another verdict, declare\n  a field: `status` can't take other values.\n- **A tool node reports** `exitCode`, `stdout`, `stderr`, and with\n  `output: { format: json, schema: { state: [OPEN, CLOSED] } }` its JSON as\n  `json`. Declare the fields you read: a run then checks them, and a typo can't\n  pass.\n- **A gate reports** `choice` and `answeredBy`. A `timeout` needs a `default`.\n\n## Edges and conditions\n\n- `a -> b`, `a -> b, c`, `b, c -> j` are plain edges, taken when the source\n  succeeded. A failed node takes no plain edge: handle a failure with\n  `when: \"!ok\"`, or `status == 'fail'` on a Claude node.\n- `{ from: a, to: b, when: \"...\" }` is taken when the condition holds. A bare\n  name reads the source's output: `when: \"verdict == 'approve'\"`. Quote any\n  condition that starts with `!`, or YAML reads it as a tag.\n- Conditions have `==`, `!=`, `<`, `>`, `&&`, `||`, `!`, and `any`, `all`,\n  `count`, `len`, `contains`. A join's `statuses` suits `any(statuses, 'fail')`.\n- A node runs when any edge into it is taken; only a join waits. A node with no\n  way in taken is skipped, and so is what follows it.\n- Templates, `{{inputs.x}}`, `{{nodes.a.output.field}}`, `{{run.id}}`, go in\n  `prompt`, `instructions`, `command`, `cwd` and `question`. Each value stays\n  one argument of a command, so it can't inject one.\n\n## Loops\n\nEvery cycle needs an edge with `maxRounds`. Give the way back a condition and\nthe way out its opposite, as `!ok` and `ok` above; a plain edge beside a loop\nfires every round. When a loop runs out, Ork asks a person what to do.\n\n## What `check` refuses, and why\n\n- **A value the source can't have** (`when.value`): `status == 'failed'` (it's\n  `fail`), a gate's `choice == 'aprove'` for `approve`, a value outside a\n  declared list. The message names the values it can have.\n- **A loop no condition ends**, a plain edge beside a loop, a loop of sessions\n  with no `limits.budgetUsd` or `limits.timeout`: warnings, each worth fixing.\n- **`no way the walk tried reaches x`**: Ork tried every way through, and none\n  got to `x`. A join waiting on a branch a first-match router never takes is\n  the usual cause.\n"
+	write: "---\nname: write\ndescription: Use when writing or changing an Ork workflow (a `.ork/workflows/*.ork.yaml` file) - its nodes, edges, conditions and loops - and checking each draft until Ork accepts it.\n---\n\n# Writing an Ork workflow\n\nAn Ork workflow is one YAML file in the project, `.ork/workflows/<name>.ork.yaml`.\nIt names the nodes (Claude sessions, programs, a person's decisions) and the\nedges that carry work between them. Ork runs it on the person's machine with\ntheir own accounts.\n\n## How to work\n\n1. **Look first.** Ork's `workflows` tool lists the project's workflows; read\n   one that's close. `agents` lists the agents a node can use. Before you split\n   the work, read `/ork:principles`: a program where a program will do, a\n   session only for judgment.\n2. **Don't guess a field.** `workflow_format` gives the format; ask it for one\n   node type (`nodeType: \"human.gate\"`) to see that type's fields.\n3. **Check every draft** with Ork's `check` tool (`text`, or `workflow` for a\n   file), and fix what it says until it has no error. Read its warnings: they\n   mean something. Without Ork's tools, run `ork validate <file>`.\n4. **Then save the file**, beginning with the schema line below, so editors can\n   check it too.\n\n## The shape of a file\n\n```yaml\n# yaml-language-server: $schema=https://raw.githubusercontent.com/mimshins/ork/main/packages/schema/workflow.schema.json\nschemaVersion: 1\nname: fix-and-ship\ndescription: Fix a failing test, check it with the test suite, and ask before opening a pull request.\ninputs:\n  issue:\n    type: string\n    required: true\n    description: What fails.\ndefaults:\n  model: sonnet\n  budgetUsd: 2\nlimits:\n  budgetUsd: 10\nnodes:\n  fix:\n    type: claude.worker\n    prompt: \"Fix this, and keep the change small: {{inputs.issue}}\"\n  tests:\n    type: tool.shell\n    command: pnpm test\n    allow: [pnpm test]\n  ask:\n    type: human.gate\n    question: \"Open a pull request for {{nodes.fix.output.branch}}?\"\n    options: [open, hold]\n    recommended: hold\n  pr:\n    type: tool.gh\n    command: pr create --fill --head {{nodes.fix.output.branch}}\n    allow: [pr create]\nedges:\n  - fix -> tests\n  - from: tests\n    to: fix\n    when: \"!ok\"\n    maxRounds: 2\n  - from: tests\n    to: ask\n    when: ok\n  - from: ask\n    to: pr\n    when: \"choice == 'open'\"\n```\n\nNode ids are lowercase: letters, digits, `-` and `_`. Secrets never go in the\nfile: a tool reads one with `env:` and `{{env.NAME}}`.\n\n## Nodes\n\n| Type                              | Does                                                                |\n| --------------------------------- | ------------------------------------------------------------------- |\n| `claude.worker`                   | A Claude session that does one task and reports                     |\n| `claude.leader`                   | A session that plans and delegates to the nodes it owns (`parent:`) |\n| `claude.subagent`                 | A subagent inside its parent's session; it takes no edges           |\n| `tool.shell`                      | Any program, run without a shell; `allow:` lists command prefixes   |\n| `tool.git`, `tool.gh`, `tool.aws` | The person's own `git`, `gh`, `aws`, with an allow list             |\n| `mcp.call`                        | One tool call on an MCP server, with no session                     |\n| `human.gate`                      | A question with options and a recommended one                       |\n| `control.join`                    | Waits for its inputs: `all` (default), `any`, or `n` of them        |\n| `control.router`, `control.split` | Pass their input on; a router takes its first matching edge         |\n| `workflow.call`                   | Starts another workflow as its own run                              |\n\nA worker, tool node, `mcp.call` or `workflow.call` can run once per entry of a\nlist: see [One node per item](#one-node-per-item).\n\n- **A Claude node reports** `status` (`pass`, `changes_requested`, `done` or\n  `fail`), `summary`, `artifacts`, `branch`, and any field its `output.schema`\n  declares, such as `verdict: [approve, escalate]`. For another verdict, declare\n  a field: `status` can't take other values.\n- **A tool node reports** `exitCode`, `stdout`, `stderr`, and with\n  `output: { format: json, schema: { state: [OPEN, CLOSED] } }` its JSON as\n  `json`. Declare the fields you read: a run then checks them, and a typo can't\n  pass.\n- **A gate reports** `choice` and `answeredBy`. A `timeout` needs a `default`.\n\n## Edges and conditions\n\n- `a -> b`, `a -> b, c`, `b, c -> j` are plain edges, taken when the source\n  succeeded. A failed node takes no plain edge: handle a failure with\n  `when: \"!ok\"`, or `status == 'fail'` on a Claude node.\n- `{ from: a, to: b, when: \"...\" }` is taken when the condition holds. A bare\n  name reads the source's output: `when: \"verdict == 'approve'\"`. Quote any\n  condition that starts with `!`, or YAML reads it as a tag.\n- Conditions have `==`, `!=`, `<`, `>`, `&&`, `||`, `!`, and `any`, `all`,\n  `count`, `len`, `contains`. A join's `statuses` suits `any(statuses, 'fail')`.\n- A node runs when any edge into it is taken; only a join waits. A node with no\n  way in taken is skipped, and so is what follows it.\n- Templates, `{{inputs.x}}`, `{{nodes.a.output.field}}`, `{{run.id}}`, go in\n  `prompt`, `instructions`, `command`, `cwd` and `question`. Each value stays\n  one argument of a command, so it can't inject one.\n\n## One node per item\n\n`forEach` runs a worker, a tool node, an `mcp.call` or a `workflow.call` once\nper entry of a list, with no model turn to fan out or gather. Not a leader, a\ngate, a subagent or a control node.\n\n```yaml\nplan:\n  type: claude.worker\n  prompt: \"Split this into at most 6 independent tasks: {{inputs.goal}}\"\n  isolation: readonly\n  output:\n    schema:\n      tasks:\n        list: { title: string, detail: string } # declare the list and its shape\nbuild:\n  type: claude.worker\n  prompt: \"Task {{index}}: {{item.title}}. {{item.detail}}\"\n  isolation: worktree\n  forEach:\n    from: \"{{nodes.plan.output.tasks}}\" # exactly one path to a declared list\n    maxItems: 6 # required with `from`: the cap on sessions started\n    maxParallel: 3\n```\n\n- `forEach: { items: [a, b] }` takes a list written in the file instead.\n- `{{item}}` and `{{index}}` work only in a node with `forEach`, in `prompt`,\n  `command`, `arguments`, `inputs`, `env` and `ref`. A program also gets\n  `ORK_ITEM` and `ORK_INDEX`.\n- The next node reads `items`, `results` (each item's output, `summary`,\n  `branch`), `statuses` and `count`: `{{nodes.build.output.results}}`,\n  `when: \"all(statuses, 'pass')\"`. Items follow no edges; the node does.\n- `onFailure: finish` (default) runs every item; `stop` starts no more after a\n  failure. A list over `maxItems` makes Ork ask a person.\n- Declare the source's `list`, or `check` warns `forEach.undeclared`. Fix\n  `forEach.not-list`, `forEach.order` and `item.field` errors; they name the\n  field or node.\n\n## Loops\n\nEvery cycle needs an edge with `maxRounds`. Give the way back a condition and\nthe way out its opposite, as `!ok` and `ok` above; a plain edge beside a loop\nfires every round. When a loop runs out, Ork asks a person what to do.\n\n## What `check` refuses, and why\n\n- **A value the source can't have** (`when.value`): `status == 'failed'` (it's\n  `fail`), a gate's `choice == 'aprove'` for `approve`, a value outside a\n  declared list. The message names the values it can have.\n- **A loop no condition ends**, a plain edge beside a loop, a loop of sessions\n  with no `limits.budgetUsd` or `limits.timeout`: warnings, each worth fixing.\n- **`no way the walk tried reaches x`**: Ork tried every way through, and none\n  got to `x`. A join waiting on a branch a first-match router never takes is\n  the usual cause.\n"
 };
 // src/project/init-skills.ts
 /**
@@ -4188,6 +4727,12 @@ const logs = defineCommand({
 			process.exitCode = 1;
 			return;
 		}
+		const problem = args.node === void 0 ? null : unknownNode(store.events(found.run.id), args.node, args.follow && found.run.status === "running");
+		if (problem !== null) {
+			writeErr(problem);
+			process.exitCode = 1;
+			return;
+		}
 		const abort = new AbortController();
 		process.once("SIGINT", () => {
 			abort.abort();
@@ -4352,6 +4897,8 @@ const init = defineCommand({
 			skills: args.skills,
 			link: args.link
 		});
+		const noCommit = await headWarning(exec);
+		if (noCommit !== null) write(style("yellow", `\n! git: ${noCommit}`));
 		write(`\nNext: edit ${WORKFLOW_DIR}/, then run ${style("bold", "ork validate")}.`);
 	}
 });
@@ -4550,27 +5097,27 @@ const main = defineCommand({
 		ps,
 		logs,
 		tree,
-		usage: () => import("./usage-BuzDsEhq.mjs").then((module) => module.usage),
-		prune: () => import("./usage-BuzDsEhq.mjs").then((module) => module.prune),
+		usage: () => import("./usage-DpHXbQEu.mjs").then((module) => module.usage),
+		prune: () => import("./usage-DpHXbQEu.mjs").then((module) => module.prune),
 		decide,
-		relay: () => import("./relay-Cp8JGrdv.mjs").then((module) => module.relay),
-		pause: () => import("./pause-DhgKQORW.mjs").then((module) => module.pause),
-		continue: () => import("./pause-DhgKQORW.mjs").then((module) => module.continueRun),
+		relay: () => import("./relay-BxRhxL6n.mjs").then((module) => module.relay),
+		pause: () => import("./pause-h66SC4rV.mjs").then((module) => module.pause),
+		continue: () => import("./pause-h66SC4rV.mjs").then((module) => module.continueRun),
 		stop,
 		chat,
-		send: () => import("./send-CHiYkM6X.mjs").then((module) => module.send),
+		send: () => import("./send-BskOwN4p.mjs").then((module) => module.send),
 		resume,
 		feedback,
 		context,
-		worktrees: () => import("./worktrees-DBBcaimX.mjs").then((module) => module.worktrees),
-		wt: () => import("./worktrees-DBBcaimX.mjs").then((module) => module.worktrees),
-		watch: () => import("./watch-CCj0vU3B.mjs").then((module) => module.watch),
-		mcp: () => import("./mcp-BFl3cIDp.mjs").then((module) => module.mcp),
-		ui: () => import("./ui-BxE0L7V0.mjs").then((module) => module.ui),
+		worktrees: () => import("./worktrees-Ccf2lUhE.mjs").then((module) => module.worktrees),
+		wt: () => import("./worktrees-Ccf2lUhE.mjs").then((module) => module.worktrees),
+		watch: () => import("./watch-CJO1ee6Y.mjs").then((module) => module.watch),
+		mcp: () => import("./mcp-DTreb7Nq.mjs").then((module) => module.mcp),
+		ui: () => import("./ui-B46Z3e9E.mjs").then((module) => module.ui),
 		doctor,
 		upgrade,
-		completion: () => import("./completion-CCn8xWmO.mjs").then((module) => module.completion),
-		__complete: () => import("./completion-CCn8xWmO.mjs").then((module) => module.completeCommand(main))
+		completion: () => import("./completion-cpZHtv50.mjs").then((module) => module.completion),
+		__complete: () => import("./completion-cpZHtv50.mjs").then((module) => module.completeCommand(main))
 	}
 });
 // src/bin.ts
@@ -4588,7 +5135,7 @@ const main = defineCommand({
 clearGitLocalEnv();
 const argv = process.argv.slice(2);
 if (argv[0] === "__complete") {
-	const { printCompletions } = await import("./completion-CCn8xWmO.mjs");
+	const { printCompletions } = await import("./completion-cpZHtv50.mjs");
 	await printCompletions(main, argv.slice(1));
 } else if (process.env["ORK_UPDATE_CHECK_CHILD"] === "1") await runUpdateChild();
 else {