@krapht/ork 1.0.0-alpha.10 → 1.0.0-alpha.12

package/dist/{decide-3l9q8UtX.mjs → builtin-files-w0YULJ4c.mjs}

@@ -1,4 +1,4 @@
-import { Fn as plainPathInside, In as writePlainFile, Pn as guardedBase, an as socketPath, bt as liveStatus, sn as wakeRun, wn as placeFiles } from "./src-Df6KOIDC.mjs";
+import { Bn as placeFiles, Qn as writePlainFile, Xn as guardedBase, Zn as plainPathInside } from "./src-CdDTQLdQ.mjs";
 import path from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";
@@ -62,52 +62,4 @@ const builtinWorkflowFile = (place, arg) => {
 	if (existsSync(file) && readFileSync(file, "utf8") === text) return file;
 	return writePlainFile(base, file, text).ok ? file : void 0;
 };
-// ../core/src/remote/decide.ts
-/**
-* @file The open decisions of live runs, and answering one from another process
-*   (`ork decide`, the local server), with the person's note if they gave one.
-*   An answer goes to the store (the first one wins), then the run is woken on
-*   its socket so it picks the answer up at once (specs/messaging.md).
-*/
-/** Open decisions whose run is still live, oldest first, ANDing the filter. */
-const pendingDecisions = (store, filter) => {
-	const live = /* @__PURE__ */ new Map();
-	return store.decisions({
-		...filter,
-		status: "open"
-	}).filter((decision) => {
-		if (!live.has(decision.runId)) {
-			const [run] = store.lookup(decision.runId);
-			live.set(decision.runId, run !== void 0 && liveStatus(run) === "running" && (filter.workflow === void 0 || run.workflow === filter.workflow));
-		}
-		return live.get(decision.runId) === true;
-	});
-};
-/**
-* Answers an open decision with one of its options, and wakes its run. `home`
-* is `~`, where the sockets are (tests pass a folder); `by` says who answered;
-* `note` is what they said with it, if anything (blank is nothing).
-*/
-const answerDecision = async (store, id, choice, home, by = "decide", note) => {
-	const decision = store.decision(id);
-	if (decision === void 0) return {
-		ok: false,
-		error: `No decision \`${id}\`.`
-	};
-	if (!decision.options.some((o) => o.id === choice)) return {
-		ok: false,
-		error: `\`${choice}\` is not an option of \`${id}\`: \`${decision.options.map((o) => o.id).join("`, `")}\``
-	};
-	if (!store.answerDecision(id, choice, by, note)) {
-		const now = store.decision(id);
-		return {
-			ok: false,
-			error: now?.status === "answered" ? `${id} was already answered: ${now.answer ?? ""} (${now.answeredBy ?? ""})` : `${id} was withdrawn`
-		};
-	}
-	return {
-		ok: true,
-		woke: await wakeRun(socketPath(decision.runId, home))
-	};
-};
-export { builtinWorkflowNames as a, builtinWorkflowFile as i, pendingDecisions as n, builtinWorkflowText as o, builtinProblem as r, isBuiltinArg as s, answerDecision as t };
+export { isBuiltinArg as a, builtinWorkflowText as i, builtinWorkflowFile as n, builtinWorkflowNames as r, builtinProblem as t };

package/dist/chips-CyeB_rhR.mjs

@@ -0,0 +1,43 @@
+import { d as apply, l as CHIP, u as NODE_PALETTE } from "./output-CnRzrbUM.mjs";
+// src/term/chips.ts
+/** The chip words the kit's commands use. */
+const CHIP_LABELS = {
+	ask: "ASK",
+	run: "RUN",
+	ok: "OK",
+	fail: "FAIL",
+	wait: "WAIT",
+	warn: "WARN",
+	skip: "SKIP",
+	error: "ERROR"
+};
+/** A run's or trigger's state word as a chip: its label and role. */
+const statusChip = (status) => {
+	const role = status === "running" ? "accent" : status === "succeeded" ? "ok" : status === "failed" || status === "crashed" ? "danger" : [
+		"paused",
+		"budget_exhausted",
+		"quota_exhausted",
+		"timed_out",
+		"interrupted"
+	].includes(status) ? "warn" : "muted";
+	return {
+		label: status === "running" ? CHIP_LABELS.run : status === "succeeded" ? CHIP_LABELS.ok : status === "failed" ? CHIP_LABELS.fail : status.replaceAll("_", " ").toUpperCase(),
+		role
+	};
+};
+/** A chip: ` LABEL ` on the role's background; `[LABEL]` when plain. */
+const chip = (term, label, role) => term.rich ? apply(term, CHIP[role], ` ${label} `) : `[${label}]`;
+/** A stable non-negative number for `text` (FNV-1a). */
+const hash = (text) => {
+	let h = 2166136261;
+	for (const char of text) h = Math.imul(h ^ (char.codePointAt(0) ?? 0), 16777619);
+	return h >>> 0;
+};
+/** The palette slot of a node id, 0 to 5, the same on every call. */
+const nodeSlot = (id) => hash(id) % NODE_PALETTE.length;
+/** A node's chip: its id on the color its id picks; `[id]` when plain. */
+const nodeChip = (term, id) => {
+	const format = NODE_PALETTE[nodeSlot(id)] ?? CHIP.muted;
+	return term.rich ? apply(term, format, ` ${id} `) : `[${id}]`;
+};
+export { statusChip as i, chip as n, nodeChip as r, CHIP_LABELS as t };

package/dist/{clean-DVaEH9e7.mjs → clean-D8GI_2K-.mjs}

@@ -1,4 +1,4 @@
-import { N as gitOk, j as removeWorktree } from "./src-Df6KOIDC.mjs";
+import { D as removeWorktree, k as gitOk } from "./src-CdDTQLdQ.mjs";
 // ../core/src/worktree/clean.ts
 /**
 * @file What `ork worktrees clean` and `ork worktrees remove` do with what

package/dist/{completion-Dv5kf598.mjs → completion-CzElB8nS.mjs}

@@ -1,9 +1,10 @@
-import { D as openStore, O as storePath, Tn as placeFor, bt as liveStatus, mr as AGENT_DRIVERS, rr as NodeIdSchema, wn as placeFiles } from "./src-Df6KOIDC.mjs";
-import { a as builtinWorkflowNames, n as pendingDecisions, o as builtinWorkflowText, s as isBuiltinArg } from "./decide-3l9q8UtX.mjs";
-import { t as findRun } from "./find-DEjjOlTG.mjs";
-import { a as findEntry, c as subcommandsOf, d as SHELL_SCRIPTS, l as COMPLETE_COMMAND, n as groupedEntries, r as argInfoOf, t as groupOf, u as SHELLS } from "./help-groups-BwYoAWsh.mjs";
-import { o as writeErr } from "./output-Bqljtmp_.mjs";
-import { a as resolveWorkflowArg, n as WORKFLOW_SUFFIX } from "./workflows-BT1gDRIV.mjs";
+import { Ar as AGENT_DRIVERS, Bn as placeFiles, C as openStore, Vn as placeFor, w as storePath, xt as liveStatus, yr as NodeIdSchema } from "./src-CdDTQLdQ.mjs";
+import { a as isBuiltinArg, i as builtinWorkflowText, r as builtinWorkflowNames } from "./builtin-files-w0YULJ4c.mjs";
+import { n as pendingDecisions } from "./decide-DlbyctOE.mjs";
+import { t as findRun } from "./find-p05wlbmu.mjs";
+import { a as findEntry, c as subcommandsOf, d as SHELL_SCRIPTS, l as COMPLETE_COMMAND, n as groupedEntries, r as argInfoOf, t as groupOf, u as SHELLS } from "./help-groups-DYP_zMRP.mjs";
+import { s as writeErr } from "./output-CnRzrbUM.mjs";
+import { a as resolveWorkflowArg, n as WORKFLOW_SUFFIX } from "./workflows-Rr5w90A0.mjs";
 import path from "node:path";
 import { parse } from "yaml";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
@@ -184,16 +185,23 @@ const subcommandSections = (position) => {
 };
 const flagSection = (position) => ({
 	title: "flags",
-	candidates: [...position.flags.flatMap((flag) => [{
-		value: `--${flag.name}`,
-		description: brief(flag.description)
-	}, ...flag.negatable ? [{
-		value: `--no-${flag.name}`,
-		description: `Turn off --${flag.name}`
-	}] : []]), {
-		value: "--help",
-		description: "Show this command's help"
-	}]
+	candidates: [
+		...position.flags.flatMap((flag) => [{
+			value: `--${flag.name}`,
+			description: brief(flag.description)
+		}, ...flag.negatable ? [{
+			value: `--no-${flag.name}`,
+			description: `Turn off --${flag.name}`
+		}] : []]),
+		{
+			value: "--plain",
+			description: "Plain output, no color or redraw"
+		},
+		{
+			value: "--help",
+			description: "Show this command's help"
+		}
+	]
 });
 const fromProvider = (provider, context) => provider === void 0 ? NONE : {
 	sections: [{

package/dist/{context-CEaKOVmG.mjs → context-BAwgVSX5.mjs}

@@ -1,7 +1,8 @@
-import { C as workflowTextHash, D as openStore, Mn as LESSON_CAP_TOKENS, O as storePath, R as driverRefusals, Rt as loadProject, S as readProjectTriggers, Tn as placeFor, _ as lateTriggers, _r as EXPERIMENTS, dr as readyDriver, gr as firstLine, hr as DRIVER_IDS, ht as walkSummary, ir as retiredDriverHint, kn as workflowDirOf, lt as namingNoDriver, mr as AGENT_DRIVERS, mt as walkChecks, nr as DriverSchema, on as socketRoom, or as INTEGRATIONS, pt as checkWorkflowText, st as explainSession, ur as driverChecks, v as triggersReport, vr as experimentsOn, wn as placeFiles, yr as knownExperiments, z as driverQueues } from "./src-Df6KOIDC.mjs";
-import { c as checkDue, d as pendingNotice, f as readUpdateCache, h as writeUpdateCache, i as registryOf, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, t as ORK_NAME, u as newerVersion } from "./__build_info__-DFF18K8y.mjs";
-import { a as write, i as style, o as writeErr, r as plain } from "./output-Bqljtmp_.mjs";
-import { c as registeredProjects, i as refusedBuiltin, o as workflowArg, r as findWorkflowFiles, s as projectAt } from "./workflows-BT1gDRIV.mjs";
+import { Ar as AGENT_DRIVERS, Bn as placeFiles, C as openStore, Dr as readyDriver, Er as driverChecks, F as driverQueues, Fr as knownExperiments, Gn as workflowDirOf, Jn as LESSON_CAP_TOKENS, Mr as firstLine, Nr as EXPERIMENTS, P as driverRefusals, Pr as experimentsOn, Sn as socketRoom, Sr as INTEGRATIONS, Vn as placeFor, _ as readProjectTriggers, br as retiredDriverHint, ct as explainSession, f as lateTriggers, gt as walkSummary, ht as walkChecks, jr as DRIVER_IDS, mt as checkWorkflowText, p as triggersReport, qt as loadProject, ut as namingNoDriver, v as workflowTextHash, vr as DriverSchema, w as storePath } from "./src-CdDTQLdQ.mjs";
+import { c as checkDue, d as pendingNotice, f as readUpdateCache, h as writeUpdateCache, i as registryOf, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, t as ORK_NAME, u as newerVersion } from "./__build_info__-BJbE3Zvp.mjs";
+import { S as cut, T as wrap, a as style, i as plain, o as write, p as paint, s as writeErr, w as widthOf, x as termOf, y as plainEnv } from "./output-CnRzrbUM.mjs";
+import { n as chip, t as CHIP_LABELS } from "./chips-CyeB_rhR.mjs";
+import { c as registeredProjects, i as refusedBuiltin, o as workflowArg, r as findWorkflowFiles, s as projectAt } from "./workflows-Rr5w90A0.mjs";
 import path from "node:path";
 import { readFileSync } from "node:fs";
 import { execFile, spawn } from "node:child_process";
@@ -73,7 +74,7 @@ const showUpdateNotice = (file = updateCachePath(), now = /* @__PURE__ */ new Da
 		const latest = pendingNotice(cache, ORK_VERSION, now);
 		if (cache === null || latest === null) return;
 		const text = updateNotice(latest, ORK_VERSION);
-		process.stderr.write(`\n${styleText("yellow", text, { stream: process.stderr })}\n`);
+		process.stderr.write(`\n${plainEnv() ? text : styleText("yellow", text, { stream: process.stderr })}\n`);
 		writeUpdateCache(file, {
 			...cache,
 			notified: {
@@ -417,6 +418,41 @@ const pathLines = (walk) => {
 	const endings = walk?.endings ?? [];
 	return [...endings.filter(({ status }) => status === "succeeded"), ...endings.filter(({ status }) => status !== "succeeded")].flatMap((ending) => endingLines(ending));
 };
+// src/commands/validate-report.ts
+const plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
+const diagnosticLine = (file, d, term) => {
+	const where = d.line === void 0 ? file : `${file}:${d.line}:${d.column ?? 1}`;
+	if (term.rich) return [
+		`${d.severity === "error" ? chip(term, CHIP_LABELS.error, "danger") : chip(term, CHIP_LABELS.warn, "warn")} ${paint(term, "muted", cut(where, term.width - 9))}`,
+		...wrap(d.message, term.width - 2).map((line) => `  ${line}`),
+		`  ${paint(term, "muted", `(${d.code})`)}`
+	];
+	const severity = d.severity === "error" ? style(["red", "bold"], "error") : style(["yellow", "bold"], "warning");
+	return [`${style("dim", where)} ${severity} ${d.message} ${style("dim", `(${d.code})`)}`];
+};
+/** The warnings alone, for a run that goes ahead despite them. */
+const warningLines = (report, term = termOf(process.stderr)) => report.diagnostics.filter((d) => d.severity === "warning").flatMap((d) => diagnosticLine(report.file, d, term));
+/** The verdict line: `OK` or `FAIL` chip when rich, else `✓` or `✗`. */
+const verdictLine = (term, ok, file, note) => {
+	const mark = term.rich ? chip(term, ok ? CHIP_LABELS.ok : CHIP_LABELS.fail, ok ? "ok" : "danger") : style(ok ? "green" : "red", ok ? "✓" : "✗");
+	const room = term.rich ? Math.max(8, term.width - widthOf(file) - 8) : Infinity;
+	return `${mark} ${file}${note === "" ? "" : ` ${style("dim", cut(note, room))}`}`;
+};
+/** Human-readable report, one line per diagnostic, compiler style. */
+const formatReport = (report, showsPaths = false, term = termOf(process.stdout)) => {
+	const lines = report.diagnostics.flatMap((d) => diagnosticLine(report.file, d, term));
+	const errors = report.diagnostics.filter((d) => d.severity === "error").length;
+	const warnings = report.diagnostics.length - errors;
+	if (report.summary === void 0 && errors === 0) lines.push(verdictLine(term, true, report.file, warnings === 0 ? "" : `(${plural(warnings, "warning")})`));
+	else if (report.summary !== void 0 && errors === 0) {
+		const { nodes, edges, entries } = report.summary;
+		const extra = warnings > 0 ? `, ${plural(warnings, "warning")}` : "";
+		lines.push(verdictLine(term, true, report.file, `(${plural(nodes, "node")}, ${plural(edges, "edge")}, starts at ${entries.join(", ")}${extra})`));
+	} else lines.push(verdictLine(term, false, report.file, `(${plural(errors, "error")}, ${plural(warnings, "warning")})`));
+	return [...lines, ...walkLine(report.walk, showsPaths)];
+};
+/** A report's lines, and with `showsPaths` each path the walk found. */
+const reportLines = (report, showsPaths) => [...formatReport(report, showsPaths), ...showsPaths ? pathLines(report.walk) : []];
 // src/commands/validate.ts
 /**
 * @file `ork validate`: loads, parses and compiles workflow files with the
@@ -494,27 +530,6 @@ const walkLoaded = async (loaded) => {
 		}
 	};
 };
-const plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
-const diagnosticLine = (file, d) => {
-	const where = d.line === void 0 ? file : `${file}:${d.line}:${d.column ?? 1}`;
-	const severity = d.severity === "error" ? style(["red", "bold"], "error") : style(["yellow", "bold"], "warning");
-	return `${style("dim", where)} ${severity} ${d.message} ${style("dim", `(${d.code})`)}`;
-};
-/** The warnings alone, for a run that goes ahead despite them. */
-const warningLines = (report) => report.diagnostics.filter((d) => d.severity === "warning").map((d) => diagnosticLine(report.file, d));
-/** Human-readable report, one line per diagnostic, compiler style. */
-const formatReport = (report, showsPaths = false) => {
-	const lines = report.diagnostics.map((d) => diagnosticLine(report.file, d));
-	const errors = report.diagnostics.filter((d) => d.severity === "error").length;
-	const warnings = report.diagnostics.length - errors;
-	if (report.summary === void 0 && errors === 0) lines.push(`${style("green", "✓")} ${report.file}${warnings === 0 ? "" : style("dim", ` (${plural(warnings, "warning")})`)}`);
-	else if (report.summary !== void 0 && errors === 0) {
-		const { nodes, edges, entries } = report.summary;
-		const extra = warnings > 0 ? `, ${plural(warnings, "warning")}` : "";
-		lines.push(`${style("green", "✓")} ${report.file} ${style("dim", `(${plural(nodes, "node")}, ${plural(edges, "edge")}, starts at ${entries.join(", ")}${extra})`)}`);
-	} else lines.push(`${style("red", "✗")} ${report.file} ${style("dim", `(${plural(errors, "error")}, ${plural(warnings, "warning")})`)}`);
-	return [...lines, ...walkLine(report.walk, showsPaths)];
-};
 const validate = defineCommand({
 	meta: {
 		name: "validate",
@@ -573,10 +588,7 @@ const validate = defineCommand({
 			diagnostics: [...triggers.diagnostics, ...triggers.triggers.flatMap((item) => item.diagnostics)]
 		}] : []];
 		if (args.json) write(JSON.stringify(reports, void 0, 2));
-		else for (const report of reports) {
-			for (const line of formatReport(report, args.paths)) write(line);
-			if (args.paths) for (const line of pathLines(report.walk)) write(line);
-		}
+		else for (const report of reports) for (const line of reportLines(report, args.paths)) write(line);
 		if (reports.some((r) => hasErrors(r.diagnostics))) process.exitCode = 1;
 	}
 });
@@ -680,4 +692,4 @@ const context = defineCommand({
 	},
 	subCommands: { explain }
 });
-export { startUpdateCheck as C, showUpdateNotice as S, runChecks as _, validate as a, UPDATE_CHILD_ENV as b, warningLines as c, runReadyDriver as d, unfitLines as f, orkCheck as g, headWarning as h, loadWorkflow as i, checksHere as l, experimentsCheck as m, explainNode as n, validateFile as o, exec as p, formatReport as r, walkLoaded as s, context as t, chooseReadyDriver as u, socketCheck as v, updateCheckOff as w, runUpdateChild as x, triggerChecks as y };
+export { startUpdateCheck as C, showUpdateNotice as S, runChecks as _, validateFile as a, UPDATE_CHILD_ENV as b, warningLines as c, runReadyDriver as d, unfitLines as f, orkCheck as g, headWarning as h, validate as i, checksHere as l, experimentsCheck as m, explainNode as n, walkLoaded as o, exec as p, loadWorkflow as r, formatReport as s, context as t, chooseReadyDriver as u, socketCheck as v, updateCheckOff as w, runUpdateChild as x, triggerChecks as y };

package/dist/decide-DlbyctOE.mjs

@@ -0,0 +1,50 @@
+import { Cn as wakeRun, xn as socketPath, xt as liveStatus } from "./src-CdDTQLdQ.mjs";
+// ../core/src/remote/decide.ts
+/**
+* @file The open decisions of live runs, and answering one from another process
+*   (`ork decide`, the local server), with the person's note if they gave one.
+*   An answer goes to the store (the first one wins), then the run is woken on
+*   its socket so it picks the answer up at once (specs/messaging.md).
+*/
+/** Open decisions whose run is still live, oldest first, ANDing the filter. */
+const pendingDecisions = (store, filter) => {
+	const live = /* @__PURE__ */ new Map();
+	return store.decisions({
+		...filter,
+		status: "open"
+	}).filter((decision) => {
+		if (!live.has(decision.runId)) {
+			const [run] = store.lookup(decision.runId);
+			live.set(decision.runId, run !== void 0 && liveStatus(run) === "running" && (filter.workflow === void 0 || run.workflow === filter.workflow));
+		}
+		return live.get(decision.runId) === true;
+	});
+};
+/**
+* Answers an open decision with one of its options, and wakes its run. `home`
+* is `~`, where the sockets are (tests pass a folder); `by` says who answered;
+* `note` is what they said with it, if anything (blank is nothing).
+*/
+const answerDecision = async (store, id, choice, home, by = "decide", note) => {
+	const decision = store.decision(id);
+	if (decision === void 0) return {
+		ok: false,
+		error: `No decision \`${id}\`.`
+	};
+	if (!decision.options.some((o) => o.id === choice)) return {
+		ok: false,
+		error: `\`${choice}\` is not an option of \`${id}\`: \`${decision.options.map((o) => o.id).join("`, `")}\``
+	};
+	if (!store.answerDecision(id, choice, by, note)) {
+		const now = store.decision(id);
+		return {
+			ok: false,
+			error: now?.status === "answered" ? `${id} was already answered: ${now.answer ?? ""} (${now.answeredBy ?? ""})` : `${id} was withdrawn`
+		};
+	}
+	return {
+		ok: true,
+		woke: await wakeRun(socketPath(decision.runId, home))
+	};
+};
+export { pendingDecisions as n, answerDecision as t };

package/dist/{find-DEjjOlTG.mjs → find-p05wlbmu.mjs}

@@ -1,4 +1,4 @@
-import { Tn as placeFor } from "./src-Df6KOIDC.mjs";
+import { Vn as placeFor } from "./src-CdDTQLdQ.mjs";
 import { randomUUID } from "node:crypto";
 // ../core/src/remote/find.ts
 /**

package/dist/format-Dni98cbh.mjs

@@ -0,0 +1,206 @@
+import { Ct as runStatus, Tt as slotWaitsOf, kt as isItem, xt as liveStatus } from "./src-CdDTQLdQ.mjs";
+import { S as cut, a as style, n as cost, w as widthOf, x as termOf } from "./output-CnRzrbUM.mjs";
+import { i as statusChip, n as chip } from "./chips-CyeB_rhR.mjs";
+import { n as nodeVerdict } from "./verdict-CIy8tAyX.mjs";
+// src/term/table.ts
+/**
+* @file Aligned columns for the listing commands: each column as wide as its
+*   widest cell, a two-space gap, the last column left unpadded. Rich, a cell
+*   may be a chip and a table wider than the screen cuts its flexible columns
+*   with `…`; plain, nothing is cut or styled, as the listings always printed.
+*/
+/** A dimmed header cell. */
+const header = (text) => ({
+	text,
+	look: (s) => style("dim", s)
+});
+const GAP = "  ";
+/** A flexible column is never cut under this many columns. */
+const MIN_FLEX = 8;
+/** The text a cell shows, and its columns. */
+const shown = (term, cell) => term.rich && cell.chip !== void 0 ? cell.chip.label : cell.text;
+const widthOfCell = (term, cell) => widthOf(shown(term, cell)) + (term.rich && cell.chip !== void 0 ? 2 : 0);
+/** The lines of a table, one per row (a header is a row the caller passes). */
+const table = (term, columns, rows, indent = "") => {
+	const widths = columns.map((_, c) => Math.max(0, ...rows.map((row) => widthOfCell(term, row[c] ?? { text: "" }))));
+	if (term.rich) {
+		const gaps = 2 * (columns.length - 1);
+		let over = indent.length + widths.reduce((a, b) => a + b, 0) + gaps - term.width;
+		columns.forEach((column, c) => {
+			const width = widths[c] ?? 0;
+			if (over <= 0 || column.flex !== true || width <= MIN_FLEX) return;
+			const next = Math.max(MIN_FLEX, width - over);
+			over -= width - next;
+			widths[c] = next;
+		});
+	}
+	const last = columns.length - 1;
+	return rows.map((row) => indent + columns.map((column, c) => {
+		const cell = row[c] ?? { text: "" };
+		const width = widths[c] ?? 0;
+		const look = cell.look ?? ((s) => s);
+		if (term.rich && cell.chip !== void 0) {
+			const used = widthOfCell(term, cell);
+			const pad = " ".repeat(Math.max(0, width - used));
+			return column.align === "right" ? pad + chip(term, cell.chip.label, cell.chip.role) : chip(term, cell.chip.label, cell.chip.role) + (c === last ? "" : pad);
+		}
+		const text = cut(shown(term, cell), width);
+		const pad = " ".repeat(Math.max(0, width - widthOf(text)));
+		if (column.align === "right") return look(pad + text);
+		return c === last ? look(text) : look(text + pad);
+	}).join(GAP));
+};
+// src/runs/format.ts
+/**
+* @file How stored runs read on the terminal: the `ork ps` table and the `ork
+*   tree` ownership tree with each node's state, tokens and cost, and what is
+*   paused (ADR-041).
+*/
+const STATUS_STYLE = {
+	running: "cyan",
+	paused: "yellow",
+	succeeded: "green",
+	failed: "red",
+	crashed: "red",
+	budget_exhausted: "yellow",
+	quota_exhausted: "yellow",
+	timed_out: "yellow",
+	interrupted: "yellow"
+};
+/** `just now`, `5m ago`, `3h ago`, `2d ago`, then the date. */
+const ago = (iso, now = Date.now()) => {
+	const minutes = Math.floor((now - Date.parse(iso)) / 6e4);
+	if (minutes < 1) return "just now";
+	if (minutes < 60) return `${String(minutes)}m ago`;
+	if (minutes < 1440) return `${String(Math.floor(minutes / 60))}h ago`;
+	if (minutes < 10080) return `${String(Math.floor(minutes / 1440))}d ago`;
+	return iso.slice(0, 10);
+};
+/** `42s`, `3m12s`, `1h05m`. */
+const duration = (ms) => {
+	const s = Math.max(0, Math.round(ms / 1e3));
+	if (s < 60) return `${String(s)}s`;
+	if (s < 3600) return `${String(Math.floor(s / 60))}m${String(s % 60).padStart(2, "0")}s`;
+	return `${String(Math.floor(s / 3600))}h${String(Math.floor(s % 3600 / 60)).padStart(2, "0")}m`;
+};
+const dim = (s) => style("dim", s);
+/**
+* A run's status as `ork ps` reads it: `waiting for slot` for a running run
+* with a command waiting for a machine-wide slot; `events` are a running
+* run's.
+*/
+const listedStatus = (run, events) => {
+	const status = runStatus(run, events);
+	return status === "running" && slotWaitsOf(events).length > 0 ? "waiting for slot" : status;
+};
+/**
+* The `ork ps` table; `withProject` adds each run's project. A called run's
+* cost is dimmed and says its caller's, whose cost already counts it.
+*/
+const formatRuns = (runs, withProject, now = Date.now(), statusOf = liveStatus, term = termOf(process.stdout)) => {
+	if (runs.length === 0) return ["No runs."];
+	const rows = runs.map((run) => {
+		const status = statusOf(run);
+		const end = run.finishedAt === void 0 ? now : Date.parse(run.finishedAt);
+		return {
+			id: run.id,
+			workflow: run.workflow,
+			status,
+			when: `${ago(run.startedAt, now)} · ${duration(end - Date.parse(run.startedAt))}`,
+			cost: run.parent === void 0 ? cost(run.costUsd) : `${cost(run.costUsd)} in ${run.parent}`,
+			called: run.parent !== void 0,
+			project: run.project
+		};
+	});
+	const rowOf = (r) => {
+		const cells = [
+			{
+				text: r.id,
+				look: (s) => style("bold", s)
+			},
+			{ text: r.workflow },
+			{
+				text: r.status,
+				chip: statusChip(r.status),
+				look: (s) => style(STATUS_STYLE[r.status] ?? "reset", s)
+			},
+			{
+				text: r.when,
+				look: dim
+			},
+			r.called ? {
+				text: r.cost,
+				look: dim
+			} : { text: r.cost }
+		];
+		if (withProject) cells.push({
+			text: r.project,
+			look: dim
+		});
+		return cells;
+	};
+	const heads = [
+		"RUN",
+		"WORKFLOW",
+		"STATUS",
+		"STARTED",
+		"COST"
+	].map((text) => header(text));
+	if (withProject) heads.push(header("PROJECT"));
+	const columns = [
+		{},
+		{ flex: true },
+		{},
+		{},
+		{ align: "right" }
+	];
+	if (withProject) columns.push({ flex: true });
+	return table(term, columns, [heads, ...rows.map((row) => rowOf(row))]);
+};
+/** Marks are made when used, so `--plain` (set after load) is read. */
+const STATE_MARK = {
+	waiting: () => style("dim", "·"),
+	running: () => style("cyan", "●"),
+	ok: () => style("green", "✓"),
+	failed: () => style("red", "✗"),
+	skipped: () => style("dim", "-")
+};
+/** `950`, `12.3k`, `1.2M`. */
+const count = (n) => {
+	if (n < 1e3) return String(n);
+	if (n < 1e6) return `${(n / 1e3).toFixed(1)}k`;
+	return `${(n / 1e6).toFixed(1)}M`;
+};
+const stateText = (node) => {
+	if (node.state === "running") return node.runs > 1 ? `running (round ${String(node.runs)})` : "running";
+	if (node.state === "ok" || node.state === "failed") {
+		const verdict = nodeVerdict(node.output ?? {}, node.state === "ok");
+		const line = verdict.length > 60 ? `${verdict.slice(0, 59)}…` : verdict;
+		return node.runs > 1 ? `${line} (${String(node.runs)} runs)` : line;
+	}
+	return node.state;
+};
+/** The ownership tree, one line per node, children under their owner. */
+const formatTree = (roots, now = Date.now()) => {
+	const lines = [];
+	const walk = (node, lead, branch) => {
+		lines.push({
+			label: `${lead}${branch}${node.id}`,
+			node
+		});
+		const next = lead + (branch === "├─ " ? "│  " : branch === "" ? "" : "   ");
+		node.children.forEach((child, index) => {
+			walk(child, next, index === node.children.length - 1 ? "└─ " : "├─ ");
+		});
+	};
+	for (const root of roots) walk(root, "", "");
+	const label = Math.max(...lines.map((l) => l.label.length));
+	const type = Math.max(...lines.map((l) => l.node.type.length));
+	return lines.map(({ label: text, node }) => {
+		const usage = node.inputTokens + node.outputTokens === 0 ? "" : style("dim", `  ${count(node.inputTokens)} in / ${count(node.outputTokens)} out · ${cost(node.costUsd)}`);
+		const state = node.held === true ? `${style("yellow", "‖")} paused` : `${STATE_MARK[node.state]()} ${stateText(node)}`;
+		const spent = isItem(node) && node.startedAt !== void 0 ? style("dim", `  ${duration((node.finishedAt === void 0 ? now : Date.parse(node.finishedAt)) - Date.parse(node.startedAt))}`) : "";
+		return `${text.padEnd(label)}  ${style("dim", node.type.padEnd(type))}  ${state}${spent}${usage}`;
+	});
+};
+export { header as a, listedStatus as i, formatRuns as n, table as o, formatTree as r, ago as t };

package/dist/{help-groups-BwYoAWsh.mjs → help-groups-DYP_zMRP.mjs}

@@ -220,6 +220,10 @@ const HELP_GROUPS = [
 				name: "logs",
 				short: "Print a run's transcript"
 			},
+			{
+				name: "attach",
+				short: "Follow a run here and answer its questions"
+			},
 			{
 				name: "tree",
 				short: "Show a run's tree, tokens and cost"

package/dist/{in-a-run-BS9Nc-JW.mjs → in-a-run-BI-hLIl_.mjs}

@@ -1,4 +1,4 @@
-import { p as runMarkerIn } from "./src-cmmXKHn1.mjs";
+import { p as runMarkerIn } from "./src-BfxkJOYm.mjs";
 // src/commands/in-a-run.ts
 /**
 * @file The commands that act as the user refuse a program or an agent in a run
@@ -19,4 +19,6 @@ const decideRefusal = (env = process.env) => refusal("`ork decide` answers as yo
 const continueRefusal = (env = process.env) => refusal("`ork continue` undoes a pause you set, so a program or an agent in a run cannot use it.", env);
 /** Whether `ork ui` may print its sign-in link, which acts as the user. */
 const mayShowSignIn = (env = process.env) => runMarkerIn(env) === null;
-export { mayShowSignIn as a, decideRefusal as i, chatRefusal as n, continueRefusal as r, acceptRefusal as t };
+/** Why `ork attach` will not answer here, or `null` when it may. */
+const attachRefusal = (env = process.env) => refusal("`ork attach` answers as you, so a program or an agent in a run cannot use it; `ork logs` still shows the run.", env);
+export { decideRefusal as a, continueRefusal as i, attachRefusal as n, mayShowSignIn as o, chatRefusal as r, acceptRefusal as t };

package/dist/{limits-BSwEjQST.mjs → limits-CElmhowV.mjs}

@@ -1,4 +1,4 @@
-import { a as limitsNow, i as NOT_STARTED, o as limitsReport, r as capsHere } from "./src-Df6KOIDC.mjs";
+import { it as limitsReport, nt as NOT_STARTED, r as capsHere, rt as limitsNow } from "./src-CdDTQLdQ.mjs";
 // src/run/limits.ts
 /**
 * @file The limits across runs that apply here (RFC-007): the user's settings

package/dist/{list-Qxr6rwsY.mjs → list-zW2xKuGr.mjs}

@@ -1,4 +1,4 @@
-import { M as git, N as gitOk, P as lines } from "./src-Df6KOIDC.mjs";
+import { A as lines, O as git, k as gitOk } from "./src-CdDTQLdQ.mjs";
 import { existsSync } from "node:fs";
 // ../core/src/worktree/list.ts
 /**

package/dist/{mcp-CslnG5wf.mjs → mcp-CM3b65AZ.mjs}

@@ -1,8 +1,8 @@
-import { h as isNewer } from "./src-Df6KOIDC.mjs";
-import { n as ORK_VERSION } from "./__build_info__-DFF18K8y.mjs";
-import { p as runMarkerIn } from "./src-cmmXKHn1.mjs";
-import { n as explainNode } from "./context-CEaKOVmG.mjs";
-import { a as openMcp, c as refused, o as tool, s as answer } from "./src-i5k2Y-kf.mjs";
+import { u as isNewer } from "./src-CdDTQLdQ.mjs";
+import { n as ORK_VERSION } from "./__build_info__-BJbE3Zvp.mjs";
+import { p as runMarkerIn } from "./src-BfxkJOYm.mjs";
+import { n as explainNode } from "./context-BAwgVSX5.mjs";
+import { a as openMcp, c as refused, o as tool, s as answer } from "./src-S9yK2OHU.mjs";
 import { z } from "zod";
 import { defineCommand } from "citty";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -43,7 +43,7 @@ const orkMcpServer = (options = {}) => {
 		...options.script === void 0 ? {} : { script: options.script }
 	});
 	const all = [...opened.tools, explainTool(opened, options.home)];
-	const tools = options.expects !== void 0 && isNewer(options.expects, "1.0.0-alpha.10") ? tooOld(all, options.expects) : all;
+	const tools = options.expects !== void 0 && isNewer(options.expects, "1.0.0-alpha.12") ? tooOld(all, options.expects) : all;
 	const server = new McpServer({
 		name: "ork",
 		version: ORK_VERSION