@krapht/ork 1.0.0-alpha.18 → 1.0.0-alpha.19

package/dist/bin.mjs

@@ -1,29 +1,30 @@
 #!/usr/bin/env node
-import { $n as FEEDBACK_TARGETS, An as liveStatus, Ar as loadAgents, Bt as decisionListTable, Ci as AGENT_TOOL_LAYOUTS, Cr as linkTools, Dr as deleteAgent, Ei as DRIVER_IDS, Er as createAgent, F as activeTree, Fr as placeFor, H as listOrkWorktrees, Kt as applyClean, L as openStore, Mr as inRepoPlace, Nn as runStatus, On as requestStop, Or as AGENT_SOURCES, Pr as placeFiles, Qn as FEEDBACK_SEVERITIES, Qr as renameNodeTypes, Rr as shownPath, Si as readyDriver, Sr as planMoveInto, Tr as toolsInUse, Un as loadProject, Ut as runListTable, V as createdWorktrees, Vn as PROJECT_FILE, Vt as feedbackListTable, Yt as planClean, Zn as FEEDBACK_KINDS, b as runningRunIds, br as planAgentMigration, cr as normalizeTitle, kn as tellLiveRun, kr as catalogAgent, li as settingsOf, ni as parseWorkflow, nt as answerDecision, oi as WorkflowSchema, ot as detachResume, ri as serializeWorkflow, rn as modelDriver, rr as sendPost, rt as pendingDecisions, st as resumable, tn as clearGitLocalEnv, tr as planPost, v as planUpgrade, w as isNewer, wi as ORK_LAYOUT, wr as toolLinks, x as runningScript, xi as driverChecks, xr as applySteps, y as releaseNotes, zn as nestItems } from "./src-Frwpx3WF.mjs";
-import { a as unknownNode, i as logListTable, l as createTerminalHuman, n as askStored, r as followRun, u as readText } from "./attach-qvfyaQXC.mjs";
-import { a as onInterrupt, c as runWorkflowFile, g as machineSlotLedger, h as sweepLocks, i as loadRuntime, m as machineLocksDir, n as flagValues, o as run, p as resumeChat, r as isDriver, s as terminalHuman, t as badDriver } from "./run-D4yuTmmJ.mjs";
-import { a as acceptItem, c as feedbackActions, i as recordNote, l as openFixRun, n as previewPost, r as checkNote, s as placeOf, t as runInstall } from "./install-B743Bwzz.mjs";
-import { c as fetchLatest, d as readUpdateCache, h as nodeSession, i as registryOf, m as writeUpdateCache, n as ORK_VERSION, p as updateCachePath, t as ORK_NAME } from "./__build_info__-B8TNbFtN.mjs";
+import { Ai as driverChecks, Ar as applySteps, Fi as DRIVER_IDS, Fr as createAgent, G as listOrkWorktrees, Hn as nestItems, I as activeTree, In as runStatus, Ir as deleteAgent, Kn as loadProject, Kt as runListTable, Lr as AGENT_SOURCES, Mi as AGENT_TOOL_LAYOUTS, Mn as tellLiveRun, Mr as linkTools, Ni as ORK_LAYOUT, Nn as liveStatus, Nr as toolLinks, Pr as toolsInUse, Qt as planClean, R as openStore, Rr as catalogAgent, S as runningScript, T as isNewer, Ur as placeFiles, Ut as decisionListTable, Vr as inRepoPlace, W as createdWorktrees, Wn as PROJECT_FILE, Wr as placeFor, Wt as feedbackListTable, Yt as applyClean, _r as feedbackActions, ar as previewPost, at as answerDecision, b as releaseNotes, cr as FEEDBACK_KINDS, di as parseWorkflow, fi as serializeWorkflow, fr as planPost, gr as normalizeTitle, hi as WorkflowSchema, in as clearGitLocalEnv, ji as readyDriver, jn as requestStop, jr as planMoveInto, kr as planAgentMigration, lr as FEEDBACK_SEVERITIES, lt as detachResume, mr as sendPost, on as modelDriver, or as checkNote, ot as pendingDecisions, qr as shownPath, si as renameNodeTypes, sr as recordNote, ur as FEEDBACK_TARGETS, ut as resumable, vi as settingsOf, vr as openFixRun, x as runningRunIds, y as planUpgrade, zr as loadAgents } from "./src-Ciy7i3se.mjs";
+import { i as placeOf, n as acceptItem, t as runInstall } from "./install-CsqK1avz.mjs";
+import { _ as machineSlotLedger, a as onInterrupt, c as runWorkflowFile, g as sweepLocks, h as machineLocksDir, i as loadRuntime, m as resumeChat, n as flagValues, o as run, r as isDriver, s as terminalHuman, t as badDriver } from "./run-C0C54UiU.mjs";
 import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
-import { n as builtinWorkflowFile, t as builtinProblem } from "./builtin-files-dnTP2GaX.mjs";
-import { t as findRun } from "./find-P-VV4B47.mjs";
-import { n as groupedEntries, t as groupOf } from "./help-groups-hB6kY34d.mjs";
-import { a as publicArgs, o as resolved, r as argsOf, s as subcommandsOf } from "./command-tree-BkSYWmYJ.mjs";
+import { n as builtinWorkflowFile, t as builtinProblem } from "./builtin-files-CWL3JEo-.mjs";
+import { p as scrubberOfRun } from "./src-DP02RP9O.mjs";
+import { t as findRun } from "./find-B30-rd-u.mjs";
+import { c as fetchLatest, d as readUpdateCache, h as nodeSession, i as registryOf, m as writeUpdateCache, n as ORK_VERSION, p as updateCachePath, t as ORK_NAME } from "./__build_info__-dPf4cEGL.mjs";
+import { n as groupedEntries, t as groupOf } from "./help-groups-BpRgBSTh.mjs";
+import { a as resolved, i as publicArgs, n as argsOf, o as subcommandsOf } from "./command-tree-B6uvMJq1.mjs";
 import { C as termOf, D as wrap, E as widthOf, S as takePlainFlag, T as hang, a as plain, b as canKey, c as write, h as paint, l as writeErr, m as bold, s as style, t as confirm, w as cut } from "./output-B1kwo0YU.mjs";
 import { n as chip, r as nodeChip, t as CHIP_LABELS } from "./chips-BqcT58qr.mjs";
-import { c as registeredProjects, n as WORKFLOW_SUFFIX, s as projectAt, t as WORKFLOW_DIR } from "./workflows-CBYtycIy.mjs";
-import { C as startUpdateCheck, S as showUpdateNotice, _ as runChecks, a as formatReport, c as checksHere, g as orkCheck, h as headWarning, m as experimentsCheck, n as validate, p as exec, r as validateFile, v as socketCheck, w as updateCheckOff, x as runUpdateChild, y as triggerChecks } from "./validate-Xn2ZbJQC.mjs";
-import { a as decideRefusal, r as chatRefusal } from "./in-a-run-DKoMGTNE.mjs";
-import { t as context } from "./context-b4_gPlv3.mjs";
-import { i as readListArgs, n as filterArgs, o as allAlias, r as projectScope, t as fail$1 } from "./flags-CqjJ44uW.mjs";
-import { t as printList } from "./print-DLe4MHn-.mjs";
-import { a as formatRegistered, i as formatProjects, n as move, o as recordInRepo, r as withStore, s as registerProject, t as forget } from "./project-records-CsILxwfI.mjs";
-import { i as listedStatus, n as formatRuns, r as formatTreeView, t as ago } from "./format-BS1qzpkf.mjs";
-import { t as withStore$1 } from "./store-B0nGqnPq.mjs";
+import { a as unknownNode, i as logListTable, l as createTerminalHuman, n as askStored, r as followRun, u as readText } from "./attach-DhZQ87Nz.mjs";
+import { c as projectAt, l as registeredProjects, n as WORKFLOW_SUFFIX, t as WORKFLOW_DIR } from "./workflows-8GV-SeRm.mjs";
+import { C as startUpdateCheck, S as showUpdateNotice, _ as runChecks, a as formatReport, c as checksHere, g as orkCheck, h as headWarning, m as experimentsCheck, n as validate, p as exec, r as validateFile, v as socketCheck, w as updateCheckOff, x as runUpdateChild, y as triggerChecks } from "./validate-UrmC5AG1.mjs";
+import { a as decideRefusal, r as chatRefusal } from "./in-a-run-CZFzoT3R.mjs";
+import { t as context } from "./context-Bw6R_EYq.mjs";
+import { i as readListArgs, n as filterArgs, o as resolveRun, r as projectScope, s as refuseUnknownFlags, t as fail$1 } from "./flags-ByYBx-Xb.mjs";
+import { i as listedStatus, n as formatRuns, r as formatTreeView, t as ago } from "./format-C-nEZv-P.mjs";
+import { t as printList } from "./print-Bd8MWVJk.mjs";
+import { a as formatRegistered, i as formatProjects, n as move, o as recordInRepo, r as withStore, s as registerProject, t as forget } from "./project-records-BOEVs69i.mjs";
+import { t as withStore$1 } from "./store-2KXzMCEN.mjs";
 import path from "node:path";
 import { stringify } from "yaml";
 import { z } from "zod";
-import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmdirSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { setTimeout } from "node:timers/promises";
 import { defineCommand, renderUsage, runCommand, runMain } from "citty";
@@ -280,11 +281,94 @@ const chat = defineCommand({
 		}
 	}
 });
+// src/runs/feedback.ts
+/**
+* @file `ork feedback`'s helpers (specs/feedback.md): finding an item by a
+*   prefix of its fingerprint, the lines `list` and `show` print, and the
+*   writes a person makes: `restore` an item, `note` a run or node.
+*/
+/** The item whose fingerprint starts with `prefix`, dismissed ones included. */
+const findFeedbackItem = (store, prefix) => {
+	const found = store.findFeedback(prefix);
+	const [item, other] = found;
+	if (item === void 0) return {
+		ok: false,
+		error: `No feedback item ${prefix}; see ork feedback list.`
+	};
+	if (other !== void 0) return {
+		ok: false,
+		error: [`${prefix} matches ${String(found.length)} items:`, ...found.map((i) => `  ${i.id}  ${i.title}`)].join("\n")
+	};
+	return {
+		ok: true,
+		item
+	};
+};
+const SEVERITY_STYLE = {
+	low: "dim",
+	medium: "yellow",
+	high: "red"
+};
+const about = (item) => `${item.target}/${item.kind}`;
+/** One line per item, most recently seen first. */
+const formatFeedbackItems = (items, now = Date.now(), term = termOf(process.stdout)) => {
+	if (items.length === 0) return ["No feedback yet."];
+	const width = Math.max(...items.map((i) => about(i).length));
+	return items.map((item) => {
+		const mark = item.status === "new" ? "" : term.rich ? ` ${chip(term, item.status.toUpperCase(), item.status === "dismissed" ? "muted" : "accent")}` : ` ${style("dim", `[${item.status}]`)}`;
+		const times = `${String(item.count)}×`.padStart(4);
+		const when = ` ${style("dim", `· ${ago(item.lastSeen, now)}`)}`;
+		const room = term.width - (item.id.length + 1 + times.length + 1 + width + 2) - widthOf(mark) - widthOf(when);
+		const title = term.rich ? cut(item.title, Math.max(8, room)) : item.title;
+		return `${style("dim", item.id)} ${times} ${style(SEVERITY_STYLE[item.severity], about(item).padEnd(width))}  ${title}${mark}${when}`;
+	});
+};
+const plural = (n, word) => `${String(n)} ${word}${n === 1 ? "" : "s"}`;
+/** An item and each of its records. */
+const formatFeedbackItem = (item, records, now = Date.now()) => {
+	const lines = [
+		style("bold", item.title),
+		style("dim", `${item.id} · ${item.status} · ${about(item)} · ${item.severity} · from ${item.sources.join(", ")}`),
+		`Seen ${plural(item.count, "time")} in ${plural(item.runs.length, "run")}, first ${ago(item.firstSeen, now)}, last ${ago(item.lastSeen, now)}.`
+	];
+	if (item.workflows.length > 0) lines.push(`Workflows: ${item.workflows.join(", ")}`);
+	if (item.models.length > 0) lines.push(`Models: ${item.models.join(", ")}`);
+	if (item.merged.length > 0) lines.push(`Merged into it: ${item.merged.map((id) => id.slice(0, 12)).join(", ")} (ork feedback split ${item.id.slice(0, 12)} takes them apart)`);
+	for (const record of records) {
+		const { feedback } = record;
+		const where = record.node === void 0 ? "" : ` · ${record.node}`;
+		lines.push("", style("dim", `${ago(record.at, now)} · run ${record.runId}${where} · ${feedback.source}`));
+		if (feedback.title !== item.title) lines.push(`  ${feedback.title}`);
+		if (feedback.body !== "") lines.push(`  ${feedback.body}`);
+		if (feedback.evidence.length > 0) lines.push(style("dim", `  evidence: ${feedback.evidence.join(", ")}`));
+	}
+	return lines;
+};
+/**
+* `ork feedback note`: records a person's note on a run, or one of its nodes,
+* as that run's feedback; returns the item it joins, or why it could not.
+*/
+const noteRun = (store, cwd, args) => {
+	const found = findRun(store, args.run, cwd);
+	if (!found.ok) return found;
+	return noteOn(store, found.run, args);
+};
+/**
+* Records a person's note on `run`, masked with the env values its workflow
+* file names (by pattern only when the file is gone or no longer parses).
+*/
+const noteOn = (store, run, ask) => recordNote(store, run, ask, "--", scrubberOfRun(run, store.projects()));
 // src/commands/decide-list.ts
 /**
 * @file The list `ork decide --list` prints: one line per open decision, and
 *   the filters (RFC-017) that choose which.
 */
+/** `ork decide`'s filter flags, with `--list`. */
+const listArgs = filterArgs(decisionListTable, { extra: { list: {
+	type: "boolean",
+	description: "List them without answering",
+	default: false
+} } });
 /**
 * One line per open decision, for `--list`: on a terminal an ASK chip and the
 * node's chip with the id and the question after, cut to the screen; plain, the
@@ -316,7 +400,7 @@ const asksForList = (args) => args["list"] === true || args["json"] === true ||
 * refused (said, exit code set).
 */
 const selectDecisions = (store, args) => {
-	const request = readListArgs(decisionListTable, args, { all: "project" });
+	const request = readListArgs(decisionListTable, args);
 	if (request === void 0) return void 0;
 	const scope = projectScope(request.filter, store.projects());
 	if (scope === void 0) return void 0;
@@ -324,15 +408,20 @@ const selectDecisions = (store, args) => {
 	const { workflow } = request.filter;
 	if (workflow !== void 0) filter.workflow = workflow;
 	const positional = args["run-id"];
-	const run = request.filter["run"] ?? (typeof positional === "string" ? positional : void 0);
-	if (run !== void 0 && run !== "") {
-		const found = findRun(store, run, process.cwd());
-		if (!found.ok) {
-			fail$1(found.error);
-			return;
-		}
-		filter.runId = found.run.id;
-	} else if (scope === "here") filter.project = placeFor(process.cwd(), store.projects()).root;
+	const named = request.filter["run"] ?? (typeof positional === "string" ? positional : void 0);
+	const hint = named !== void 0 && request.filter["run"] === void 0 ? decisionHint(store, named) : void 0;
+	if (hint !== void 0) {
+		fail$1(hint);
+		return;
+	}
+	const resolved = resolveRun(store, named === void 0 ? request.filter : {
+		...request.filter,
+		run: named
+	});
+	if (resolved === void 0) return void 0;
+	const run = resolved["run"];
+	if (run !== void 0 && run !== "") filter.runId = run;
+	else if (scope === "here") filter.project = placeFor(process.cwd(), store.projects()).root;
 	else if (scope !== "all") filter.project = scope.root;
 	const pending = pendingDecisions(store, filter);
 	return {
@@ -346,6 +435,16 @@ const printDecisions = (open, args, workflow) => {
 		for (const line of formatDecisions(shown, workflow)) write(line);
 	});
 };
+/**
+* What to say when the positional meant for a run is an open decision's id: the
+* form that answers it (a run id is the positional; a decision answers with
+* `--id` and `--choose`).
+*/
+const decisionHint = (store, arg) => {
+	const decision = store.decision(arg);
+	if (decision === void 0 || decision.status !== "open") return void 0;
+	return `${arg} is a decision id, not a run: answer it with \`ork decide --id ${arg} --choose ${decision.recommended ?? decision.options[0]?.id ?? "<option>"}\``;
+};
 // src/commands/decide.ts
 /**
 * @file `ork decide`: answer a live run's open decisions from any terminal (it
@@ -371,11 +470,11 @@ const noteDecision = (store, id, note, rating) => {
 		ok: false,
 		error: `No decision ${id} to note.`
 	};
-	return recordNote(store, run, {
+	return noteOn(store, run, {
 		text: note ?? `Rated ${rating ?? ""} at ${decision.question}`,
 		node: decision.node,
 		rating
-	}, "--");
+	});
 };
 /** Why a note given with an answer can't be recorded, before answering. */
 const noteProblem = (note, rating) => {
@@ -396,20 +495,14 @@ const decide = defineCommand({
 		name: "decide",
 		description: "Answer the open decisions of this project's live runs"
 	},
+	plugins: [refuseUnknownFlags],
 	args: {
 		"run-id": {
 			type: "positional",
 			description: "Only this run's decisions (an id or a prefix)",
 			required: false
 		},
-		...filterArgs(decisionListTable, { extra: {
-			...allAlias,
-			list: {
-				type: "boolean",
-				description: "List them without answering",
-				default: false
-			}
-		} }),
+		...listArgs,
 		document: {
 			type: "boolean",
 			description: "Print the document of the decision --id names",
@@ -534,6 +627,8 @@ const failed$1 = (message) => {
 	writeErr(message);
 	process.exitCode = 1;
 };
+/** The mark of how the run ended, as the run's own summary line has it. */
+const endMark = (status) => status === "succeeded" ? style("green", "✓") : status === "failed" || status === "crashed" ? style("red", "✗") : style("yellow", "!");
 const stop = defineCommand({
 	meta: {
 		name: "stop",
@@ -571,7 +666,7 @@ const stop = defineCommand({
 			for (let i = 0; i < 150; i += 1) {
 				const [now] = store.lookup(run.id);
 				if (now !== void 0 && liveStatus(now) !== "running") {
-					write(`${style("green", "✓")} run ${run.id} ${liveStatus(now)}`);
+					write(`${endMark(liveStatus(now))} run ${run.id} ${liveStatus(now)}`);
 					return;
 				}
 				await setTimeout(100);
@@ -727,7 +822,7 @@ const formatCheck = (result, term = termOf(process.stdout)) => {
 * folder. Says nothing when there were none. `bin` is the `cmd` program.
 */
 const leaseChecks = async (place, env = process.env, bin = "cmd") => {
-	const { cleanStaleLeases, leaseLedger } = await import("./src-ygFMh2eP.mjs");
+	const { cleanStaleLeases, leaseLedger } = await import("./src-D2qpd-G7.mjs");
 	const { cleaned, failed } = await cleanStaleLeases({
 		bin,
 		ledger: leaseLedger(placeFiles(place).runs),
@@ -753,10 +848,22 @@ const leaseChecks = async (place, env = process.env, bin = "cmd") => {
 *   nothing when there were none.
 */
 const named = (held) => held.map(({ run, node, pid }) => `${run}/${node} (pid ${String(pid)})`).join(", ");
-/** Sweeps the slots and locks in `home`'s `~/.ork`; one line per kind swept. */
+/** Removes `dir`'s `queue` folder when sweeping left it empty (else it stays). */
+const dropEmptyQueue = (dir) => {
+	try {
+		rmdirSync(path.join(dir, "queue"));
+	} catch {}
+};
+/**
+* Sweeps the slots and locks in `home`'s `~/.ork`; one line per kind swept, and
+* the empty `queue/` folders the sweep left are removed.
+*/
 const ledgerChecks = (home = homedir()) => {
 	const slots = machineSlotLedger({ home }).sweep();
-	const locks = sweepLocks(machineLocksDir(home));
+	const locksDir = machineLocksDir(home);
+	const locks = sweepLocks(locksDir);
+	if (slots.length > 0) dropEmptyQueue(path.join(home, ".ork", "slots"));
+	if (locks.length > 0) for (const folder of readdirSync(locksDir)) dropEmptyQueue(path.join(locksDir, folder));
 	return [...slots.length === 0 ? [] : [{
 		name: "check slots",
 		status: "ok",
@@ -1559,6 +1666,7 @@ const projects = defineCommand({
 		name: "projects",
 		description: "List the registered projects, in-repo and attached"
 	},
+	plugins: [refuseUnknownFlags],
 	args: filterArgs(projectListTable),
 	subCommands: {
 		forget,
@@ -1625,78 +1733,6 @@ const migrate = defineCommand({
 		}, (file) => formatReport(validateFile(file, process.cwd())));
 	}
 });
-// src/runs/feedback.ts
-/**
-* @file `ork feedback`'s helpers (specs/feedback.md): finding an item by a
-*   prefix of its fingerprint, the lines `list` and `show` print, and the
-*   writes a person makes: `restore` an item, `note` a run or node.
-*/
-/** The item whose fingerprint starts with `prefix`, dismissed ones included. */
-const findFeedbackItem = (store, prefix) => {
-	const found = store.findFeedback(prefix);
-	const [item, other] = found;
-	if (item === void 0) return {
-		ok: false,
-		error: `No feedback item ${prefix}; see ork feedback list.`
-	};
-	if (other !== void 0) return {
-		ok: false,
-		error: [`${prefix} matches ${String(found.length)} items:`, ...found.map((i) => `  ${i.id}  ${i.title}`)].join("\n")
-	};
-	return {
-		ok: true,
-		item
-	};
-};
-const SEVERITY_STYLE = {
-	low: "dim",
-	medium: "yellow",
-	high: "red"
-};
-const about = (item) => `${item.target}/${item.kind}`;
-/** One line per item, most recently seen first. */
-const formatFeedbackItems = (items, now = Date.now(), term = termOf(process.stdout)) => {
-	if (items.length === 0) return ["No feedback yet."];
-	const width = Math.max(...items.map((i) => about(i).length));
-	return items.map((item) => {
-		const mark = item.status === "new" ? "" : term.rich ? ` ${chip(term, item.status.toUpperCase(), item.status === "dismissed" ? "muted" : "accent")}` : ` ${style("dim", `[${item.status}]`)}`;
-		const times = `${String(item.count)}×`.padStart(4);
-		const when = ` ${style("dim", `· ${ago(item.lastSeen, now)}`)}`;
-		const room = term.width - (item.id.length + 1 + times.length + 1 + width + 2) - widthOf(mark) - widthOf(when);
-		const title = term.rich ? cut(item.title, Math.max(8, room)) : item.title;
-		return `${style("dim", item.id)} ${times} ${style(SEVERITY_STYLE[item.severity], about(item).padEnd(width))}  ${title}${mark}${when}`;
-	});
-};
-const plural = (n, word) => `${String(n)} ${word}${n === 1 ? "" : "s"}`;
-/** An item and each of its records. */
-const formatFeedbackItem = (item, records, now = Date.now()) => {
-	const lines = [
-		style("bold", item.title),
-		style("dim", `${item.id} · ${item.status} · ${about(item)} · ${item.severity} · from ${item.sources.join(", ")}`),
-		`Seen ${plural(item.count, "time")} in ${plural(item.runs.length, "run")}, first ${ago(item.firstSeen, now)}, last ${ago(item.lastSeen, now)}.`
-	];
-	if (item.workflows.length > 0) lines.push(`Workflows: ${item.workflows.join(", ")}`);
-	if (item.models.length > 0) lines.push(`Models: ${item.models.join(", ")}`);
-	if (item.merged.length > 0) lines.push(`Merged into it: ${item.merged.map((id) => id.slice(0, 12)).join(", ")} (ork feedback split ${item.id.slice(0, 12)} takes them apart)`);
-	for (const record of records) {
-		const { feedback } = record;
-		const where = record.node === void 0 ? "" : ` · ${record.node}`;
-		lines.push("", style("dim", `${ago(record.at, now)} · run ${record.runId}${where} · ${feedback.source}`));
-		if (feedback.title !== item.title) lines.push(`  ${feedback.title}`);
-		if (feedback.body !== "") lines.push(`  ${feedback.body}`);
-		if (feedback.evidence.length > 0) lines.push(style("dim", `  evidence: ${feedback.evidence.join(", ")}`));
-	}
-	return lines;
-};
-/**
-* `ork feedback note`: records a person's note on a run, or one of its nodes,
-* as that run's feedback; returns the item it joins, or why it could not.
-*/
-const noteRun = (store, cwd, args) => {
-	const found = findRun(store, args.run, cwd);
-	if (!found.ok) return found;
-	return recordNote(store, found.run, args, "--");
-};
 // src/commands/feedback-list.ts
 /**
 * @file `ork feedback list`: the items, newest first, filtered by the flags
@@ -1708,16 +1744,16 @@ const list = defineCommand({
 		name: "list",
 		description: "List feedback items, newest first"
 	},
-	args: {
-		...filterArgs(feedbackListTable),
-		...allAlias
-	},
+	plugins: [refuseUnknownFlags],
+	args: filterArgs(feedbackListTable),
 	run: async ({ args }) => {
 		const given = args;
-		const asked = readListArgs(feedbackListTable, given, { all: "status" });
+		const asked = readListArgs(feedbackListTable, given);
 		if (asked === void 0) return;
-		const { filter, limit } = asked;
+		const { limit } = asked;
 		await withStore$1((store) => {
+			const filter = resolveRun(store, asked.filter);
+			if (filter === void 0) return;
 			const items = applyFilters(feedbackListTable, store.feedbackItems({ all: filter["status"] !== void 0 }), filter).slice(0, limit);
 			printList(items, feedbackListTable, given, (shown) => {
 				for (const line of formatFeedbackItems(shown)) write(line);
@@ -2422,15 +2458,13 @@ const ps = defineCommand({
 		name: "ps",
 		description: "List this project's runs, newest first"
 	},
-	args: {
-		...filterArgs(runListTable, { extra: { limit: {
-			type: "string",
-			description: `Show at most this many, a positive whole number (default ${String(PS_LIMIT)})`
-		} } }),
-		...allAlias
-	},
+	plugins: [refuseUnknownFlags],
+	args: { ...filterArgs(runListTable, { extra: { limit: {
+		type: "string",
+		description: `Show at most this many, a positive whole number (default ${String(PS_LIMIT)})`
+	} } }) },
 	run: ({ args }) => withStore$1((store) => {
-		const req = readListArgs(runListTable, args, { all: "project" });
+		const req = readListArgs(runListTable, args);
 		if (req === void 0) return;
 		const scope = projectScope(req.filter, store.projects());
 		if (scope === void 0) return;
@@ -2447,7 +2481,13 @@ const ps = defineCommand({
 			json: args["json"]
 		}, (runs) => {
 			for (const line of formatRuns(runs, scope === "all", Date.now(), statusOf)) write(line);
-		}, (runs) => runs.map((run) => byId.get(run.id) ?? run));
+		}, (runs) => runs.map((run) => {
+			const record = byId.get(run.id) ?? run;
+			return {
+				...record,
+				live: statusOf(record)
+			};
+		}));
 	})
 });
 const runArg = {
@@ -2458,8 +2498,9 @@ const runArg = {
 const logs = defineCommand({
 	meta: {
 		name: "logs",
-		description: "Print a run's transcript"
+		description: "Print a run's transcript. A delegated task shows its task label: the lead's short description, whitespace folded, clipped to 80 characters, secrets masked"
 	},
+	plugins: [refuseUnknownFlags],
 	args: {
 		run: runArg,
 		...filterArgs(logListTable, {
@@ -2525,7 +2566,7 @@ const logs = defineCommand({
 const tree = defineCommand({
 	meta: {
 		name: "tree",
-		description: "Show a run's ownership tree with status, tokens and cost"
+		description: "Show a run's ownership tree with status, tokens and cost. A delegated task shows its task label: the lead's short description, whitespace folded, clipped to 80 characters, secrets masked"
 	},
 	args: {
 		run: runArg,
@@ -2695,6 +2736,7 @@ const issuesStep = async (root, options, checks = checksHere) => {
 		return;
 	}
 	write(`${style("green", "created")} ${ISSUES_FILE}`);
+	write(style("dim", `Commit it before \`ork run issues\`: the builders' worktrees come from your commits.`));
 	const line = await issuesDriverLine(checks);
 	if (line !== null) write(line);
 };
@@ -2886,6 +2928,7 @@ const agents = defineCommand({
 				name: "list",
 				description: "Every agent, and where it comes from"
 			},
+			plugins: [refuseUnknownFlags],
 			args: agentListArgs,
 			run: ({ args }) => {
 				const catalog = catalogHere();
@@ -2992,31 +3035,31 @@ const main = defineCommand({
 		run,
 		ps,
 		logs,
-		attach: () => import("./attach-CU4Pk42S.mjs").then((module) => module.attach),
+		attach: () => import("./attach-BQl8nQz2.mjs").then((module) => module.attach),
 		tree,
-		usage: () => import("./usage-BIs4j5Rw.mjs").then((module) => module.usage),
-		prune: () => import("./usage-BIs4j5Rw.mjs").then((module) => module.prune),
+		usage: () => import("./usage-BFBco5OS.mjs").then((module) => module.usage),
+		prune: () => import("./usage-BFBco5OS.mjs").then((module) => module.prune),
 		decide,
-		relay: () => import("./relay-Bvm9JEoN.mjs").then((module) => module.relay),
-		pause: () => import("./pause-8gnVgICR.mjs").then((module) => module.pause),
-		continue: () => import("./pause-8gnVgICR.mjs").then((module) => module.continueRun),
+		relay: () => import("./relay-CeNiq3GT.mjs").then((module) => module.relay),
+		pause: () => import("./pause-B1grR1cl.mjs").then((module) => module.pause),
+		continue: () => import("./pause-B1grR1cl.mjs").then((module) => module.continueRun),
 		stop,
 		chat,
-		once: () => import("./once-6L8gciJV.mjs").then((module) => module.once),
-		send: () => import("./send-BV9eIxQ7.mjs").then((module) => module.send),
+		once: () => import("./once-BKn3pOtg.mjs").then((module) => module.once),
+		send: () => import("./send-DqgF58hb.mjs").then((module) => module.send),
 		resume,
 		feedback,
-		"follow-ups": () => import("./follow-ups-B_c1DSpA.mjs").then((module) => module.followUps),
+		"follow-ups": () => import("./follow-ups-Cxca1Jgg.mjs").then((module) => module.followUps),
 		context,
-		worktrees: () => import("./worktrees-C7vfh7y5.mjs").then((module) => module.worktrees),
-		wt: () => import("./worktrees-C7vfh7y5.mjs").then((module) => module.worktrees),
-		watch: () => import("./watch-9VM3DFTp.mjs").then((module) => module.watch),
-		mcp: () => import("./mcp-BMwekw38.mjs").then((module) => module.mcp),
-		ui: () => import("./ui-BZ9BhFw8.mjs").then((module) => module.ui),
+		worktrees: () => import("./worktrees-CUdUvZlO.mjs").then((module) => module.worktrees),
+		wt: () => import("./worktrees-CUdUvZlO.mjs").then((module) => module.worktrees),
+		watch: () => import("./watch-DTxkgB8R.mjs").then((module) => module.watch),
+		mcp: () => import("./mcp-B4wME9C4.mjs").then((module) => module.mcp),
+		ui: () => import("./ui-CAvygxTb.mjs").then((module) => module.ui),
 		doctor,
 		upgrade,
-		completion: () => import("./completion-CzXUGSVn.mjs").then((module) => module.completion),
-		__complete: () => import("./completion-CzXUGSVn.mjs").then((module) => module.completeCommand(main))
+		completion: () => import("./completion-DKPuD_Rw.mjs").then((module) => module.completion),
+		__complete: () => import("./completion-DKPuD_Rw.mjs").then((module) => module.completeCommand(main))
 	}
 });
 // src/bin.ts
@@ -3032,11 +3075,13 @@ const main = defineCommand({
 *   completion runs on every Tab, goes first: no update check, and no citty, so
 *   a typed `--help` is a word to complete. `ork once -- <command>` skips
 *   citty's help scan, so a `--help` or `-h` of the command is the command's.
+*   An argument error of a command with no subcommands prints its message
+*   alone, without the help (specs/cli/list-filters.md).
 */
 clearGitLocalEnv();
 const argv = takePlainFlag(process.argv.slice(2));
 if (argv[0] === "__complete") {
-	const { printCompletions } = await import("./completion-CzXUGSVn.mjs");
+	const { printCompletions } = await import("./completion-DKPuD_Rw.mjs");
 	await printCompletions(main, argv.slice(1));
 } else if (process.env["ORK_UPDATE_CHECK_CHILD"] === "1") await runUpdateChild();
 else {
@@ -3049,15 +3094,20 @@ else {
 	const dash = argv.indexOf("--");
 	const askedHelp = argv.slice(1, dash === -1 ? 0 : dash).some((arg) => arg === "--help" || arg === "-h");
 	if (argv[0] === "once" && dash !== -1 && !askedHelp) try {
-		const { once } = await import("./once-6L8gciJV.mjs");
+		const { once } = await import("./once-BKn3pOtg.mjs");
 		await runCommand(once, { rawArgs: argv.slice(1) });
 	} catch (error) {
 		console.error(error);
 		process.exitCode = 1;
 	}
-	else await runMain(main, {
-		rawArgs: argv,
-		showUsage: showHelp
-	});
+	else {
+		const wantsHelp = argv.some((arg) => arg === "--help" || arg === "-h");
+		await runMain(main, {
+			rawArgs: argv,
+			showUsage: async (cmd, parent) => {
+				if (wantsHelp || cmd.subCommands !== void 0) await showHelp(cmd, parent);
+			}
+		});
+	}
 }
 export {};

package/dist/{brief-Bh1FnAHv.mjs → brief-BQbeoPMc.mjs}

@@ -1,8 +1,8 @@
-import { _n as takeFollowUps, nr as runGh } from "./src-Frwpx3WF.mjs";
-import { f as refreshDue, l as briefOf, n as flagValues, u as checkTakeable } from "./run-D4yuTmmJ.mjs";
-import { n as newRunId } from "./find-P-VV4B47.mjs";
+import { pr as runGh } from "./src-Ciy7i3se.mjs";
+import { f as refreshDue, l as briefOf, n as flagValues, p as runIsLive, u as checkTakeable, v as availableDue, y as takeFollowUps } from "./run-C0C54UiU.mjs";
+import { n as newRunId } from "./find-B30-rd-u.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-import { t as loadWorkflow } from "./validate-Xn2ZbJQC.mjs";
+import { t as loadWorkflow } from "./validate-UrmC5AG1.mjs";
 // src/follow-ups/brief.ts
 /**
 * @file `ork run --follow-ups <ids>`: the `agent` follow-ups become the run's
@@ -56,9 +56,11 @@ const problemsOf = (loaded, inputs) => {
 /**
 * The inputs and run id `ork run` starts with: those it was given and, for
 * `--follow-ups`, a `brief` made of the follow-ups with the id of the run that
-* takes them. `undefined` after saying why it can't start.
+* takes them. `undefined` after saying why it can't start. With `mark` false
+* nothing is marked taken: a `--detach` parent checks before it makes the run
+* folder, and the run it starts marks them.
 */
-const prepareFollowUps = async (store, rawArgs, runId, target, gh = runGh) => {
+const prepareFollowUps = async (store, rawArgs, runId, target, gh = runGh, mark = true) => {
 	const inputs = flagValues(rawArgs, "--input");
 	const plain = {
 		inputs,
@@ -72,9 +74,15 @@ const prepareFollowUps = async (store, rawArgs, runId, target, gh = runGh) => {
 	const project = loaded.place.root;
 	const named = values.filter((value) => value !== DUE);
 	if (values.includes(DUE)) await refreshDue(store, project, writeErr, gh);
-	const due = values.includes(DUE) ? store.followUps(project).filter((f) => f.for === "agent" && f.status === "due").map((f) => f.id) : [];
+	const isLive = runIsLive(store);
+	const { ids: due, held } = values.includes(DUE) ? availableDue(store, project, isLive, runId) : {
+		ids: [],
+		held: []
+	};
+	for (const f of held) writeErr(`${FLAG} ${DUE}: skipped ${f.id}, taken by run ${f.takenBy}, still running.`);
 	if (named.length === 0 && due.length === 0) {
-		writeErr(`${FLAG} ${DUE}: no agent follow-ups are due. \`ork follow-ups list\` shows them.`);
+		const reason = held.length > 0 ? ` ${held.length} due ${held.length === 1 ? "one is" : "ones are"} taken by a run still running.` : "";
+		writeErr(`${FLAG} ${DUE}: no agent follow-ups are due.${reason} \`ork follow-ups list\` shows them.`);
 		process.exitCode = 1;
 		return;
 	}
@@ -86,11 +94,13 @@ const prepareFollowUps = async (store, rawArgs, runId, target, gh = runGh) => {
 		return;
 	}
 	const followUps = [...new Map(takeable.followUps.map((f) => [f.id, f])).values()];
+	if (!mark) return plain;
 	const taker = runId ?? newRunId(store);
 	takeFollowUps(store, {
 		project,
 		run: taker,
-		ids: followUps.map((f) => f.id)
+		ids: followUps.map((f) => f.id),
+		isLive
 	});
 	return {
 		inputs: [...inputs, `brief=${briefOf(followUps)}`],

package/dist/{builtin-files-dnTP2GaX.mjs → builtin-files-CWL3JEo-.mjs}

@@ -1,4 +1,4 @@
-import { Gr as plainPathInside, Kr as writePlainFile, Pr as placeFiles, Wr as guardedBase } from "./src-Frwpx3WF.mjs";
+import { $r as guardedBase, Ur as placeFiles, ei as plainPathInside, ti as writePlainFile } from "./src-Ciy7i3se.mjs";
 import path from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/{command-tree-BkSYWmYJ.mjs → command-tree-B6uvMJq1.mjs}

@@ -60,4 +60,4 @@ const subcommandsOf = async (cmd) => {
 };
 /** The subcommand `name` (or one of its aliases) of `entries`. */
 const findEntry = (entries, name) => entries.find((entry) => entry.name === name || entry.aliases.includes(name));
-export { publicArgs as a, findEntry as i, argInfoOf as n, resolved as o, argsOf as r, subcommandsOf as s, INTERNAL as t };
+export { resolved as a, publicArgs as i, argsOf as n, subcommandsOf as o, findEntry as r, argInfoOf as t };