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

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

@@ -1,8 +1,8 @@
-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 { mr as runGh } from "./src-8cOPOgrT.mjs";
+import { b as takeFollowUps, f as refreshDue, l as briefOf, n as flagValues, p as runIsLive, u as checkTakeable, v as availableDue, y as heldNote } from "./run-DBUAq-Uu.mjs";
+import { n as newRunId } from "./find-BTikxc54.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-import { t as loadWorkflow } from "./validate-UrmC5AG1.mjs";
+import { t as loadWorkflow } from "./validate-BxayjjkV.mjs";
 // src/follow-ups/brief.ts
 /**
 * @file `ork run --follow-ups <ids>`: the `agent` follow-ups become the run's
@@ -75,11 +75,16 @@ const prepareFollowUps = async (store, rawArgs, runId, target, gh = runGh, mark
 	const named = values.filter((value) => value !== DUE);
 	if (values.includes(DUE)) await refreshDue(store, project, writeErr, gh);
 	const isLive = runIsLive(store);
-	const { ids: due, held } = values.includes(DUE) ? availableDue(store, project, isLive, runId) : {
+	const stamp = (/* @__PURE__ */ new Date()).toISOString();
+	const { ids: due, held } = values.includes(DUE) ? availableDue(store, project, isLive, runId, () => stamp) : {
 		ids: [],
 		held: []
 	};
-	for (const f of held) writeErr(`${FLAG} ${DUE}: skipped ${f.id}, taken by run ${f.takenBy}, still running.`);
+	const at = Date.parse(stamp);
+	for (const f of held) {
+		const note = heldNote(f, isLive, at) ?? "still running";
+		writeErr(`${FLAG} ${DUE}: skipped ${f.id}, taken by run ${f.takenBy}, ${note}.`);
+	}
 	if (named.length === 0 && due.length === 0) {
 		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.`);

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

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

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

@@ -16,7 +16,7 @@ const flagOf = (name, def) => ({
 	takesValue: def.type === "string" || def.type === "enum",
 	aliases: "alias" in def ? listOf(def.alias) : [],
 	options: def.type === "enum" ? def.options ?? [] : [],
-	negatable: def.type === "boolean" && def.default === true
+	negatable: def.type === "boolean" && (def.default === true || def.negativeDescription !== void 0)
 });
 /** A command's public flags and positionals, in the order it defines them. */
 const argInfoOf = async (cmd) => {

package/dist/{completion-DKPuD_Rw.mjs → completion-DS0gCZRm.mjs}

@@ -1,10 +1,10 @@
-import { Ci as NodeIdSchema, Nn as liveStatus, Pi as AGENT_DRIVERS, R as openStore, Ur as placeFiles, Wr as placeFor, ot as pendingDecisions, z as storePath } from "./src-Ciy7i3se.mjs";
-import { a as isBuiltinArg, i as builtinWorkflowText, r as builtinWorkflowNames } from "./builtin-files-CWL3JEo-.mjs";
-import { t as findRun } from "./find-B30-rd-u.mjs";
+import { Fi as AGENT_DRIVERS, Gr as placeFor, Pn as liveStatus, R as openStore, Wr as placeFiles, st as pendingDecisions, wi as NodeIdSchema, z as storePath } from "./src-8cOPOgrT.mjs";
+import { a as isBuiltinArg, i as builtinWorkflowText, r as builtinWorkflowNames } from "./builtin-files-Cf-NZDqM.mjs";
+import { t as findRun } from "./find-BTikxc54.mjs";
 import { a as SHELL_SCRIPTS, i as SHELLS, n as groupedEntries, r as COMPLETE_COMMAND, t as groupOf } from "./help-groups-BpRgBSTh.mjs";
-import { o as subcommandsOf, r as findEntry, t as argInfoOf } from "./command-tree-B6uvMJq1.mjs";
+import { o as subcommandsOf, r as findEntry, t as argInfoOf } from "./command-tree-CEkzWNy6.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-import { n as WORKFLOW_SUFFIX, o as resolveWorkflowArg } from "./workflows-8GV-SeRm.mjs";
+import { n as WORKFLOW_SUFFIX, o as resolveWorkflowArg } from "./workflows-DHHi-APg.mjs";
 import path from "node:path";
 import { parse } from "yaml";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
@@ -309,13 +309,20 @@ 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}`
-		}] : []]),
+		...position.flags.flatMap((flag) => [
+			{
+				value: `--${flag.name}`,
+				description: brief(flag.description)
+			},
+			...flag.aliases.filter((alias) => alias.length > 1).map((alias) => ({
+				value: `--${alias}`,
+				description: `Same as --${flag.name}`
+			})),
+			...flag.negatable ? [{
+				value: `--no-${flag.name}`,
+				description: `Turn off --${flag.name}`
+			}] : []
+		]),
 		{
 			value: "--plain",
 			description: "Plain output, no color or redraw"

package/dist/{context-Bw6R_EYq.mjs → context-CGPh12HV.mjs}

@@ -1,7 +1,7 @@
-import { Zr as LESSON_CAP_TOKENS, yt as explainSession } from "./src-Ciy7i3se.mjs";
+import { Qr as LESSON_CAP_TOKENS, bt as explainSession } from "./src-8cOPOgrT.mjs";
 import { c as write, s as style } from "./output-B1kwo0YU.mjs";
-import { a as refusedBuiltin, s as workflowArg } from "./workflows-8GV-SeRm.mjs";
-import { a as formatReport, t as loadWorkflow } from "./validate-UrmC5AG1.mjs";
+import { a as refusedBuiltin, s as workflowArg } from "./workflows-DHHi-APg.mjs";
+import { a as formatReport, t as loadWorkflow } from "./validate-BxayjjkV.mjs";
 import { defineCommand } from "citty";
 // src/commands/context.ts
 /**

package/dist/{detached-BQlbmqR0.mjs → detached-Dakw5RZj.mjs}

@@ -1,5 +1,5 @@
-import { ft as detachRun } from "./src-Ciy7i3se.mjs";
-import { n as newRunId } from "./find-B30-rd-u.mjs";
+import { pt as detachRun } from "./src-8cOPOgrT.mjs";
+import { n as newRunId } from "./find-BTikxc54.mjs";
 import { c as write, i as detachHint, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
 // src/run/detached.ts
 /**
@@ -10,7 +10,7 @@ import { c as write, i as detachHint, l as writeErr, s as style } from "./output
 /** Starts the run in the background; `rawArgs` are `ork run`'s own, as typed. */
 const startDetached = async (store, options) => {
 	const { rawArgs, cwd, target } = options;
-	const { prepareFollowUps } = await import("./brief-BQbeoPMc.mjs");
+	const { prepareFollowUps } = await import("./brief-DH66xmj8.mjs");
 	if (await prepareFollowUps(store, rawArgs, void 0, target, void 0, false) === void 0) return;
 	const single = options.node !== void 0 && options.node !== "";
 	const runId = newRunId(store, single ? "node-" : "");

package/dist/extra-arguments-BxQMXARO.mjs

@@ -0,0 +1,13 @@
+import { n as argsOf } from "./command-tree-CEkzWNy6.mjs";
+import { t as argumentError } from "./argument-error-CihH46Le.mjs";
+// src/extra-arguments.ts
+/** Refuses the first word beyond the positionals the command declares. */
+const refuseExtraArguments = {
+	name: "refuse-extra-arguments",
+	setup: async ({ cmd, args }) => {
+		const declared = Object.values(await argsOf(cmd)).filter((def) => def.type === "positional").length;
+		const extra = args._[declared];
+		if (extra !== void 0) throw argumentError(`Unexpected argument \`${extra}\`.`);
+	}
+};
+export { refuseExtraArguments as t };

package/dist/{find-B30-rd-u.mjs → find-BTikxc54.mjs}

@@ -1,4 +1,4 @@
-import { Wr as placeFor } from "./src-Ciy7i3se.mjs";
+import { Gr as placeFor } from "./src-8cOPOgrT.mjs";
 import { randomUUID } from "node:crypto";
 // ../core/src/remote/find.ts
 /**

package/dist/{flags-ByYBx-Xb.mjs → flags-C8yCq0j5.mjs}

@@ -1,19 +1,10 @@
-import "./src-Ciy7i3se.mjs";
+import { Gr as placeFor } from "./src-8cOPOgrT.mjs";
 import { i as parseLimit, n as unknownProjectRefusal, r as parseFilters, t as limitRefusal } from "./refusals-DQQX3AIb.mjs";
-import { t as findRun } from "./find-B30-rd-u.mjs";
-import { a as resolved, n as argsOf } from "./command-tree-B6uvMJq1.mjs";
+import { t as findRun } from "./find-BTikxc54.mjs";
+import { a as resolved, n as argsOf } from "./command-tree-CEkzWNy6.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-import { parseArgs } from "citty";
+import { t as argumentError } from "./argument-error-CihH46Le.mjs";
 // src/list/known-flags.ts
-/**
-* @file The citty plugin that refuses a flag a list command does not have (`ork
-*   ps --bogus`, `ork decide --list --since 24h`). citty's parser is not
-*   strict: it puts an unknown `--since 24h` into the arguments as `since:
-*   true` plus a positional, which `decide` would read as a run id. The plugin
-*   runs before the command, on the nine list commands only (specs/cli/
-*   list-filters.md), and refuses with citty's own argument error, so the
-*   one-line message and exit code 1 are the same as for a wrong enum value.
-*/
 /** Names citty reads without the command declaring them. */
 const BUILT_IN = /* @__PURE__ */ new Set([
 	"_",
@@ -22,24 +13,6 @@ const BUILT_IN = /* @__PURE__ */ new Set([
 ]);
 /** A flag's name without its spelling: `run-id`, `runId` and `run_id` agree. */
 const spelling = (name) => name.replaceAll(/[-_]/gu, "").toLowerCase();
-/**
-* An error citty's `runMain` takes for an argument error (its `CLIError`, which
-* it does not export): a failed parse gives one, and it takes `message`.
-*/
-const argumentError = (message) => {
-	try {
-		parseArgs([], { x: {
-			type: "string",
-			required: true
-		} });
-	} catch (error) {
-		if (error instanceof Error) {
-			error.message = message;
-			return error;
-		}
-	}
-	return new Error(message);
-};
 /** How the flag is typed: `--since`, or `-x` for a one-letter name. */
 const written = (name) => name.length === 1 ? `-${name}` : `--${name}`;
 /** Refuses the first flag the command does not declare. */
@@ -134,6 +107,8 @@ const readListArgs = (table, args, options = {}) => {
 		limit
 	};
 };
+/** The project root a scope other than `all` names. */
+const rootOf = (scope, projects) => scope === "here" ? placeFor(process.cwd(), projects).root : scope.root;
 /**
 * The scope the filter's `project` names, checked against the registered
 * projects (core does not know them): an id or a root, or `all`; none given is
@@ -167,4 +142,4 @@ const resolveRun = (store, filter) => {
 		run: found.run.id
 	};
 };
-export { refuseIdsWithJson as a, readListArgs as i, filterArgs as n, resolveRun as o, projectScope as r, refuseUnknownFlags as s, fail as t };
+export { refuseIdsWithJson as a, refuseUnknownFlags as c, readListArgs as i, filterArgs as n, resolveRun as o, projectScope as r, rootOf as s, fail as t };

package/dist/{follow-ups-Cxca1Jgg.mjs → follow-ups-CtlhHbwe.mjs}

@@ -1,12 +1,13 @@
-import { Gt as followUpListTable, Jn as changeFollowUp, Qn as isGithubIssueUrl, Sn as followUpProblem, Wr as placeFor, Xn as findFollowUp, Zn as followUpActions, gn as postFollowUpMessage, pr as runGh, vn as markDue, xn as deliverFollowUp, yn as recordPublished } from "./src-Ciy7i3se.mjs";
-import { d as followUpsRule, f as refreshDue, n as flagValues } from "./run-C0C54UiU.mjs";
+import { $n as isGithubIssueUrl, Cn as followUpProblem, Gr as placeFor, Kt as followUpListTable, Qn as followUpActions, Sn as deliverFollowUp, Yn as changeFollowUp, Zn as findFollowUp, _n as postFollowUpMessage, bn as recordPublished, mr as runGh, yn as markDue } from "./src-8cOPOgrT.mjs";
+import { d as followUpsRule, f as refreshDue, n as flagValues } from "./run-DBUAq-Uu.mjs";
 import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
 import { n as unknownProjectRefusal } from "./refusals-DQQX3AIb.mjs";
-import { t as findRun } from "./find-B30-rd-u.mjs";
+import { t as findRun } from "./find-BTikxc54.mjs";
 import { a as plain, c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { i as readListArgs, n as filterArgs, s as refuseUnknownFlags } from "./flags-ByYBx-Xb.mjs";
-import { t as printList } from "./print-Bd8MWVJk.mjs";
-import { t as withStore } from "./store-2KXzMCEN.mjs";
+import { t as refuseExtraArguments } from "./extra-arguments-BxQMXARO.mjs";
+import { c as refuseUnknownFlags, i as readListArgs, n as filterArgs } from "./flags-C8yCq0j5.mjs";
+import { t as printList } from "./print-DNYzq4Rr.mjs";
+import { t as withStore } from "./store-CDpk8Wtz.mjs";
 import { homedir } from "node:os";
 import { defineCommand } from "citty";
 // src/follow-ups/command.ts
@@ -77,6 +78,48 @@ const withFollowUp = (args, body) => inProject(args.project, async (store, place
 	}
 	await body(store, place, found.followUp);
 });
+/**
+* The follow-ups several words name (`done a b`, `drop a,b`: a comma splits a
+* word too), each once, or `undefined` after saying every word that failed and
+* making the command exit 1; the caller then changes nothing.
+*/
+const eachTarget = (words, resolve) => {
+	const named = [...new Set(words.flatMap((word) => word.split(",")).map((word) => word.trim()).filter((word) => word !== ""))];
+	if (named.length === 0) {
+		fail("Give a follow-up id.");
+		return;
+	}
+	const found = /* @__PURE__ */ new Map();
+	let failed = false;
+	for (const word of named) {
+		const one = resolve(word);
+		if (one.ok) for (const f of one.followUps) found.set(f.id, f);
+		else {
+			fail(one.error);
+			failed = true;
+		}
+	}
+	return failed ? void 0 : [...found.values()];
+};
+/**
+* Like `withFollowUp`, for every id in `args._` (space or comma separated):
+* `refused` says why one may not be changed, and any refusal stops the call.
+*/
+const withFollowUps = (args, refused, body) => inProject(args.project, async (store, place) => {
+	const followUps = eachTarget(args._, (word) => {
+		const found = findFollowUp(store, place.root, word);
+		if (!found.ok) return found;
+		const why = refused(found.followUp);
+		return why === void 0 ? {
+			ok: true,
+			followUps: [found.followUp]
+		} : {
+			ok: false,
+			error: why
+		};
+	});
+	if (followUps !== void 0) await body(store, place, followUps);
+});
 // src/follow-ups/format.ts
 /** The groups of the list, in the order they are shown. */
 const GROUPS = [
@@ -163,23 +206,34 @@ const formatFollowUp = (f) => [
 *   the person's own `gh` and only with `--confirm`, after showing the exact
 *   text; Ork never runs a task's commands.
 */
-/** `done`, `drop` or `reopen`: one change of status, or why it can't be. */
+/**
+* `done`, `drop` or `reopen`: one change of status for each id given (space or
+* comma separated), or why one can't be; any refusal changes none.
+*/
 const closing = (action, description, verb) => defineCommand({
 	meta: {
 		name: action,
 		description
 	},
 	args: {
-		id: idArg,
+		id: {
+			...idArg,
+			description: "A follow-up's id, or a prefix of one; several allowed, space or comma separated"
+		},
 		project
 	},
-	run: ({ args }) => withFollowUp(args, (store, _place, followUp) => {
-		const changed = changeFollowUp(store, followUp, action);
-		if (!changed.ok) {
-			fail(changed.error);
-			return;
+	run: ({ args }) => withFollowUps(args, (followUp) => {
+		const allowed = followUpActions(followUp)[action];
+		return allowed.ok ? void 0 : allowed.error;
+	}, (store, _place, followUps) => {
+		for (const followUp of followUps) {
+			const changed = changeFollowUp(store, followUp, action);
+			if (!changed.ok) {
+				fail(changed.error);
+				continue;
+			}
+			write(`${style("green", "✓")} ${verb} ${changed.followUp.id}: ${plain(changed.followUp.title)}`);
 		}
-		write(`${style("green", "✓")} ${verb} ${changed.followUp.id}: ${plain(changed.followUp.title)}`);
 	})
 });
 const due = defineCommand({
@@ -190,22 +244,26 @@ const due = defineCommand({
 	args: {
 		target: {
 			type: "positional",
-			description: "A follow-up's id (or a prefix), or a run id",
+			description: "A follow-up's id (or a prefix), or a run id; several allowed, space or comma separated",
 			required: true
 		},
 		project
 	},
 	run: ({ args }) => inProject(args.project, (store, place) => {
-		const one = findFollowUp(store, place.root, args.target);
-		const run = findRun(store, args.target, "");
-		const runId = run.ok ? run.run.id : args.target;
-		const key = one.ok ? one.followUp.id : runId;
-		const marked = markDue(store, place.root, key);
-		if (marked.length === 0) {
-			fail(`Nothing waiting under \`${args.target}\`: give a waiting follow-up's id, or a run that left some.`);
-			return;
-		}
-		for (const f of marked) write(`${style("green", "✓")} due ${f.id}: ${plain(f.title)}`);
+		const waiting = eachTarget(args._, (target) => {
+			const one = findFollowUp(store, place.root, target);
+			const run = findRun(store, target, "");
+			const runId = run.ok ? run.run.id : target;
+			const ready = (one.ok ? [one.followUp] : store.followUps(place.root).filter((f) => f.from.run === runId)).filter((f) => f.status === "waiting");
+			return ready.length === 0 ? {
+				ok: false,
+				error: `Nothing waiting under \`${target}\`: give a waiting follow-up's id, or a run that left some.`
+			} : {
+				ok: true,
+				followUps: ready
+			};
+		});
+		for (const f of waiting ?? []) for (const marked of markDue(store, place.root, f.id)) write(`${style("green", "✓")} due ${marked.id}: ${plain(marked.title)}`);
 	})
 });
 const post = defineCommand({
@@ -213,6 +271,7 @@ const post = defineCommand({
 		name: "post",
 		description: "Post a message drafted for GitHub, as a comment through your own gh, with --confirm; without it, show what would be posted"
 	},
+	plugins: [refuseExtraArguments],
 	args: {
 		id: idArg,
 		confirm: {
@@ -253,6 +312,7 @@ const published = defineCommand({
 		name: "published",
 		description: "Record that this run published a pull request or branch (a workflow step calls it): its follow-ups wait on it, and the ones it took are done"
 	},
+	plugins: [refuseExtraArguments],
 	args: { ref: {
 		type: "positional",
 		description: "The pull request URL or the branch",
@@ -452,7 +512,7 @@ const followUps = defineCommand({
 				name: "list",
 				description: "List the follow-ups, due first, then by who they are for"
 			},
-			plugins: [refuseUnknownFlags],
+			plugins: [refuseUnknownFlags, refuseExtraArguments],
 			args: filterArgs(followUpListTable),
 			run: async ({ args }) => {
 				const given = args;
@@ -480,6 +540,7 @@ const followUps = defineCommand({
 				name: "show",
 				description: "Show a follow-up whole, with its draft and its steps to copy"
 			},
+			plugins: [refuseExtraArguments],
 			args: {
 				id: idArg,
 				project,

package/dist/{format-C-nEZv-P.mjs → format-BB4E-T6x.mjs}

@@ -1,4 +1,4 @@
-import { In as runStatus, Ln as slotWaitsOf, Mt as lockWaitLine, Nn as liveStatus, Or as maskSecrets, Pn as lockWaitsOf, Vn as isItem } from "./src-Ciy7i3se.mjs";
+import { Fn as lockWaitsOf, Hn as isItem, Ln as runStatus, Nt as lockWaitLine, Pn as liveStatus, Rn as slotWaitsOf, kr as maskSecrets } from "./src-8cOPOgrT.mjs";
 import { C as termOf, E as widthOf, n as cost, o as shortCount, r as costOf, s as style, w as cut } from "./output-B1kwo0YU.mjs";
 import { i as statusChip, n as chip } from "./chips-BqcT58qr.mjs";
 import { n as nodeVerdict } from "./verdict-CMvPCpWC.mjs";

package/dist/{in-a-run-CZFzoT3R.mjs → in-a-run-CbnKjO7t.mjs}

@@ -1,5 +1,5 @@
-import { z as storePath } from "./src-Ciy7i3se.mjs";
-import { g as storeGuarded, h as runMarkerIn } from "./src-DP02RP9O.mjs";
+import { z as storePath } from "./src-8cOPOgrT.mjs";
+import { g as storeGuarded, h as runMarkerIn } from "./src-I_RyKu6_.mjs";
 // src/commands/in-a-run.ts
 /**
 * @file The commands that act as the user refuse a program or an agent in a run

package/dist/{install-CsqK1avz.mjs → install-CWcpX5g4.mjs}

@@ -1,4 +1,4 @@
-import { $r as guardedBase, Qr as estimateTokens, Ur as placeFiles, Wr as placeFor, Yr as inside, Zr as LESSON_CAP_TOKENS, _r as feedbackActions, ei as plainPathInside, ti as writePlainFile } from "./src-Ciy7i3se.mjs";
+import { $r as estimateTokens, Gr as placeFor, Qr as LESSON_CAP_TOKENS, Wr as placeFiles, Xr as inside, ei as guardedBase, ni as writePlainFile, ti as plainPathInside, vr as feedbackActions } from "./src-8cOPOgrT.mjs";
 import path from "node:path";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { spawn } from "node:child_process";

package/dist/{limits-CXh052II.mjs → limits-VQqsBoQk.mjs}

@@ -1,4 +1,4 @@
-import { gt as limitsReport, ht as limitsNow, mt as NOT_STARTED, v as capsHere } from "./src-Ciy7i3se.mjs";
+import { _t as limitsReport, gt as limitsNow, ht as NOT_STARTED, v as capsHere } from "./src-8cOPOgrT.mjs";
 // src/run/limits.ts
 /**
 * @file The limits across runs that apply here (RFC-007): the user's settings

package/dist/{mcp-B4wME9C4.mjs → mcp-wGfkMCVF.mjs}

@@ -1,8 +1,8 @@
-import { T as isNewer } from "./src-Ciy7i3se.mjs";
-import { h as runMarkerIn } from "./src-DP02RP9O.mjs";
-import { n as ORK_VERSION } from "./__build_info__-dPf4cEGL.mjs";
-import { n as explainNode } from "./context-Bw6R_EYq.mjs";
-import { a as openMcp, c as refused, o as tool, s as answer } from "./src-n-u4TGev.mjs";
+import { T as isNewer } from "./src-8cOPOgrT.mjs";
+import { h as runMarkerIn } from "./src-I_RyKu6_.mjs";
+import { n as ORK_VERSION } from "./__build_info__-D6mXC4cD.mjs";
+import { n as explainNode } from "./context-CGPh12HV.mjs";
+import { a as openMcp, c as refused, o as tool, s as answer } from "./src-CmEvHdju.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.19") ? tooOld(all, options.expects) : all;
+	const tools = options.expects !== void 0 && isNewer(options.expects, "1.0.0-alpha.20") ? tooOld(all, options.expects) : all;
 	const server = new McpServer({
 		name: "ork",
 		version: ORK_VERSION

package/dist/{once-BKn3pOtg.mjs → once-BHxSdZz_.mjs}

@@ -1,7 +1,7 @@
-import "./src-Ciy7i3se.mjs";
-import { t as runOnce } from "./run-D6yU2rLf.mjs";
+import "./src-8cOPOgrT.mjs";
+import { n as OncePathspecError, t as runOnce } from "./run-Bvvg-fiF.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { t as ago } from "./format-C-nEZv-P.mjs";
+import { t as ago } from "./format-BB4E-T6x.mjs";
 import { spawn } from "node:child_process";
 import { defineCommand, parseArgs } from "citty";
 // src/commands/once.ts
@@ -21,6 +21,10 @@ const args = {
 		type: "string",
 		description: "Also record the pass for this name (repeat for more)"
 	},
+	on: {
+		type: "string",
+		description: "A git pathspec the check depends on; only matching files key it (repeat for more)"
+	},
 	"with-head": {
 		type: "boolean",
 		description: "Key the check by HEAD too (for checks relative to it)"
@@ -42,7 +46,22 @@ const exitCodeOf = (command) => new Promise((resolve) => {
 		resolve(code ?? 1);
 	});
 });
-const listOf = (value) => [value].flat().filter((item) => typeof item === "string" && item !== "");
+/**
+* Every use of a repeatable flag, `--flag v` or `--flag=v`: citty keeps only
+* the last. Not `run.ts`'s `flagValues`, which would load the run command's
+* imports on every `ork once`.
+*/
+const valuesOf = (before, flag) => before.flatMap((arg, index) => {
+	if (arg.startsWith(`${flag}=`)) return [arg.slice(flag.length + 1)];
+	if (arg !== flag) return [];
+	const next = before[index + 1];
+	return [next === void 0 || next.startsWith("--") ? void 0 : next];
+});
+/** The values of `flag`, or `undefined` when one of its uses has none. */
+const listOf = (before, flag) => {
+	const values = valuesOf(before, flag);
+	return values.every((value) => value !== void 0 && value !== "") ? values.filter((value) => value !== void 0) : void 0;
+};
 const once = defineCommand({
 	meta: {
 		name: "once",
@@ -53,22 +72,39 @@ const once = defineCommand({
 		const split = rawArgs.indexOf("--");
 		const command = split === -1 ? [] : rawArgs.slice(split + 1);
 		if (command.length === 0) {
-			writeErr("Say what to run after --: ork once [--as <name>] [--covers <name>] [--with-head] [--force] -- <command…>");
+			writeErr("Say what to run after --: ork once [--as <name>] [--covers <name>]… [--on <pathspec>]… [--with-head] [--force] -- <command…>");
+			process.exitCode = 1;
+			return;
+		}
+		const before = rawArgs.slice(0, split);
+		const given = parseArgs(before, args);
+		const covers = listOf(before, "--covers");
+		const on = listOf(before, "--on");
+		if (covers === void 0 || on === void 0) {
+			writeErr(`${covers === void 0 ? "--covers needs a name" : "--on needs a pathspec"}: ork once [--covers <name>]… [--on <pathspec>]… -- <command…>`);
 			process.exitCode = 1;
 			return;
 		}
-		const given = parseArgs(rawArgs.slice(0, split), args);
 		const run = process.env["ORK_RUN"];
 		const node = process.env["ORK_NODE"];
 		const result = await runOnce({
 			cwd: process.cwd(),
 			name: given["as"] ?? command.join(" "),
-			covers: listOf(given["covers"]),
+			covers,
+			on,
 			withHead: given["with-head"] === true,
 			force: given["force"] === true,
 			...run === void 0 || node === void 0 ? {} : { who: `${run}/${node}` },
 			run: () => exitCodeOf(command)
+		}).catch((error) => {
+			if (!(error instanceof OncePathspecError)) throw error;
+			writeErr(error.message);
+			return null;
 		});
+		if (result === null) {
+			process.exitCode = 1;
+			return;
+		}
 		if (result.skipped) write(`${style("green", "✓")} check already passed on these files · ${ago(result.pass.at)} · ${result.pass.who}`);
 		process.exitCode = result.code;
 	}

package/dist/{pause-B1grR1cl.mjs → pause-C_Wxh-KM.mjs}

@@ -1,7 +1,8 @@
-import { An as requestPause, R as openStore, kn as requestContinue } from "./src-Ciy7i3se.mjs";
-import { t as findRun } from "./find-B30-rd-u.mjs";
+import { An as requestContinue, R as openStore, jn as requestPause } from "./src-8cOPOgrT.mjs";
+import { t as findRun } from "./find-BTikxc54.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { i as continueRefusal } from "./in-a-run-CZFzoT3R.mjs";
+import { i as continueRefusal } from "./in-a-run-CbnKjO7t.mjs";
+import { t as refuseExtraArguments } from "./extra-arguments-BxQMXARO.mjs";
 import { defineCommand } from "citty";
 // src/commands/pause.ts
 /**
@@ -43,6 +44,7 @@ const pause = defineCommand({
 		name: "pause",
 		description: "Pause a live run, or one node, before its next tool call"
 	},
+	plugins: [refuseExtraArguments],
 	args,
 	run: ({ args: given }) => ask(given.run, (store, run) => requestPause(store, run, void 0, given.node), (run) => given.node === void 0 ? `Run ${run.id} pauses: nothing new starts, and running sessions wait before their next tool call. Go on with: ork continue ${run.id}` : `${given.node} in run ${run.id} pauses before its next tool call. Go on with: ork continue ${run.id} --node ${given.node}`)
 });
@@ -51,6 +53,7 @@ const continueRun = defineCommand({
 		name: "continue",
 		description: "Let a paused run, or one paused node, go on"
 	},
+	plugins: [refuseExtraArguments],
 	args,
 	run: async ({ args: given }) => {
 		const refused = continueRefusal();

package/dist/{print-Bd8MWVJk.mjs → print-DNYzq4Rr.mjs}

@@ -1,5 +1,5 @@
 import { c as write } from "./output-B1kwo0YU.mjs";
-import { a as refuseIdsWithJson } from "./flags-ByYBx-Xb.mjs";
+import { a as refuseIdsWithJson } from "./flags-C8yCq0j5.mjs";
 // src/list/print.ts
 /**
 * Prints `rows`: `--ids` their ids (`table.id`) comma-separated; `--json` the

package/dist/{project-records-BOEVs69i.mjs → project-records-XY3ku95x.mjs}

@@ -1,6 +1,7 @@
-import { Br as hasInRepoFiles, Gr as projectsHome, Hr as newProjectId, R as openStore, Ur as placeFiles, Vr as inRepoPlace, Xr as projectRootOf, qr as shownPath } from "./src-Ciy7i3se.mjs";
+import { Hr as inRepoPlace, Jr as shownPath, Kr as projectsHome, R as openStore, Ur as newProjectId, Vr as hasInRepoFiles, Wr as placeFiles, Zr as projectRootOf } from "./src-8cOPOgrT.mjs";
 import { C as termOf, c as write, l as writeErr, s as style, w as cut } from "./output-B1kwo0YU.mjs";
 import { n as chip } from "./chips-BqcT58qr.mjs";
+import { t as refuseExtraArguments } from "./extra-arguments-BxQMXARO.mjs";
 import path from "node:path";
 import { existsSync, mkdirSync, realpathSync, statSync } from "node:fs";
 import { defineCommand } from "citty";
@@ -194,6 +195,7 @@ const forget = defineCommand({
 		name: "forget",
 		description: "Forget a registered project; its files and runs are kept"
 	},
+	plugins: [refuseExtraArguments],
 	args: { id },
 	run: ({ args }) => {
 		if (withStore((store) => store.forgetProject(args.id))) {
@@ -209,6 +211,7 @@ const move = defineCommand({
 		name: "move",
 		description: "Point a registered project at its clone's new place, after moving or renaming it"
 	},
+	plugins: [refuseExtraArguments],
 	args: {
 		id,
 		path: {

package/dist/{relay-CeNiq3GT.mjs → relay-BA6tsnpc.mjs}

@@ -1,4 +1,4 @@
-import { Dn as linkNodes, On as unlinkNodes, R as openStore, Tn as addressOf } from "./src-Ciy7i3se.mjs";
+import { En as addressOf, On as linkNodes, R as openStore, kn as unlinkNodes } from "./src-8cOPOgrT.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
 import { defineCommand } from "citty";
 // src/commands/relay.ts