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

package/dist/bin.mjs

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-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, sn as socketRoom, t as createWorkspace, tr as isClaudeNode, tt as resumable, u as releaseNotes, 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-DosUvy4B.mjs";
-import { a as formatRunEvent, i as formatEvent, n as formatRuns, o as createTerminalHuman, r as formatTree, s as createDecisionQueue, t as ago } from "./format-sGEQmQid.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__-B83zdwIv.mjs";
-import { i as builtinWorkflowFile, n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-BaEOo7sO.mjs";
-import { n as newRunId, t as findRun } from "./find-DDAkEoda.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-D1wMNIly.mjs";
-import { n as listOrkWorktrees, t as createdWorktrees } from "./list-CZTh_wdE.mjs";
-import { a as planClean, t as applyClean } from "./clean-NtapkN2x.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-COHxAj7X.mjs";
-import { c as registeredProjects, i as refusedBuiltin, n as WORKFLOW_SUFFIX, o as workflowArg, s as projectAt, t as WORKFLOW_DIR } from "./workflows-BF9fO-ER.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-C5wQNjp9.mjs";
-import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-DezRXN0Z.mjs";
-import { i as decideRefusal, n as chatRefusal } from "./in-a-run-DENitTUe.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-BNhCiDQw.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",
@@ -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-jYI2QHt7.mjs").then((module) => module.usage),
-		prune: () => import("./usage-jYI2QHt7.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-DCGGYSdz.mjs").then((module) => module.relay),
-		pause: () => import("./pause-HuQhHyET.mjs").then((module) => module.pause),
-		continue: () => import("./pause-HuQhHyET.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-C8pQfhED.mjs").then((module) => module.send),
+		send: () => import("./send-BskOwN4p.mjs").then((module) => module.send),
 		resume,
 		feedback,
 		context,
-		worktrees: () => import("./worktrees-0iUiA6eD.mjs").then((module) => module.worktrees),
-		wt: () => import("./worktrees-0iUiA6eD.mjs").then((module) => module.worktrees),
-		watch: () => import("./watch-D4lFXnHT.mjs").then((module) => module.watch),
-		mcp: () => import("./mcp-B2DW26HO.mjs").then((module) => module.mcp),
-		ui: () => import("./ui-Cdb05xJw.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-DAQMrf1u.mjs").then((module) => module.completion),
-		__complete: () => import("./completion-DAQMrf1u.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-DAQMrf1u.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 {