@krapht/ork 1.0.0-alpha.16 → 1.0.0-alpha.17

package/dist/{__build_info__-DcRdK0Du.mjs → __build_info__-C1Nm0hlJ.mjs}

@@ -1,4 +1,4 @@
-import { C as compareVersions, T as parseVersion, w as isNewer } from "./src-DN-RPsil.mjs";
+import { C as compareVersions, T as parseVersion, w as isNewer } from "./src-DLsFsmOD.mjs";
 import path from "node:path";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -355,5 +355,5 @@ const registryShown = (registry) => {
 *   fails when it is stale.
 */
 const ORK_NAME = "@krapht/ork";
-const ORK_VERSION = "1.0.0-alpha.16";
+const ORK_VERSION = "1.0.0-alpha.17";
 export { dueCause as _, registryShown as a, githubDraftRefusal as b, fetchLatest as c, readUpdateCache as d, refreshUpdateCache as f, changeFollowUp as g, nodeSession as h, registryOf as i, newerVersion as l, writeUpdateCache as m, ORK_VERSION as n, updateSwitchOff as o, updateCachePath as p, isSwitchedOn as r, checkDue as s, ORK_NAME as t, pendingNotice as u, findFollowUp as v, isGithubIssueUrl as x, followUpActions as y };

package/dist/{attach-7lB5_jpr.mjs → attach-EP374oMP.mjs}

@@ -1,9 +1,9 @@
-import "./src-DN-RPsil.mjs";
-import { l as createTerminalHuman, t as attachRun } from "./attach-B-FeE1dJ.mjs";
-import { t as findRun } from "./find-mLYsR0uC.mjs";
+import "./src-DLsFsmOD.mjs";
+import { l as createTerminalHuman, t as attachRun } from "./attach-RQx__RzH.mjs";
+import { t as findRun } from "./find-k489laBa.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { n as attachRefusal } from "./in-a-run-a447hxq8.mjs";
-import { t as withStore } from "./store-Dyr1mP8K.mjs";
+import { n as attachRefusal } from "./in-a-run-D_9GlAlS.mjs";
+import { t as withStore } from "./store-DACH768X.mjs";
 import { defineCommand } from "citty";
 // src/commands/attach.ts
 /**

package/dist/{attach-B-FeE1dJ.mjs → attach-RQx__RzH.mjs}

@@ -1,4 +1,4 @@
-import { Ft as slotWaitLine, Gn as endOf, I as isNodeEvent, Jn as END_KINDS, Kn as outcomeEnd, kt as lockWaitLine, nt as answerDecision, rt as pendingDecisions, tt as followRunTree, ut as followEvents, vr as maskSecrets } from "./src-DN-RPsil.mjs";
+import { Ft as slotWaitLine, I as isNodeEvent, Kn as endOf, Yn as END_KINDS, kt as lockWaitLine, nt as answerDecision, qn as outcomeEnd, rt as pendingDecisions, tt as followRunTree, ut as followEvents, yr as maskSecrets } from "./src-DLsFsmOD.mjs";
 import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
 import { C as termOf, D as wrap, E as widthOf, O as readKeys, _ as interrupt, a as plain, b as canKey, g as createRegion, h as paint, m as bold, n as cost, p as apply, r as costOf, s as style, u as confirmOrStop, v as readLine, w as cut, x as plainEnv, y as withdrawn } from "./output-B1kwo0YU.mjs";
 import { n as chip, r as nodeChip, t as CHIP_LABELS } from "./chips-BqcT58qr.mjs";

package/dist/bin.mjs

@@ -1,25 +1,25 @@
 #!/usr/bin/env node
-import { Bn as PROJECT_FILE, Bt as feedbackListTable, Ci as ORK_LAYOUT, Cr as toolLinks, Dn as requestStop, Dr as AGENT_SOURCES, Er as deleteAgent, F as activeTree, Gt as applyClean, H as listOrkWorktrees, Hn as loadProject, Ht as runListTable, Jt as planClean, L as openStore, Lr as shownPath, Mn as runStatus, Nr as placeFiles, On as tellLiveRun, Or as catalogAgent, Pr as placeFor, Qn as FEEDBACK_TARGETS, Rn as nestItems, Si as AGENT_TOOL_LAYOUTS, Sr as linkTools, Ti as DRIVER_IDS, Tr as createAgent, V as createdWorktrees, Xn as FEEDBACK_KINDS, Zn as FEEDBACK_SEVERITIES, Zr as renameNodeTypes, ai as WorkflowSchema, b as runningRunIds, bi as driverChecks, br as applySteps, ci as settingsOf, en as clearGitLocalEnv, er as planPost, jr as inRepoPlace, kn as liveStatus, kr as loadAgents, ni as serializeWorkflow, nn as modelDriver, nr as sendPost, nt as answerDecision, ot as detachResume, rt as pendingDecisions, sr as normalizeTitle, st as resumable, ti as parseWorkflow, v as planUpgrade, w as isNewer, wr as toolsInUse, x as runningScript, xi as readyDriver, xr as planMoveInto, y as releaseNotes, yr as planAgentMigration, zt as decisionListTable } from "./src-DN-RPsil.mjs";
-import { a as unknownNode, i as logListTable, l as createTerminalHuman, n as askStored, r as followRun, u as readText } from "./attach-B-FeE1dJ.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-B-j3Qxqc.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-23g_1ngs.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__-DcRdK0Du.mjs";
+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-DLsFsmOD.mjs";
+import { a as unknownNode, i as logListTable, l as createTerminalHuman, n as askStored, r as followRun, u as readText } from "./attach-RQx__RzH.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-OOWQIKMJ.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-PVlV2QPq.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__-C1Nm0hlJ.mjs";
 import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
-import { i as readListArgs, n as filterArgs, o as allAlias, r as projectScope, t as fail$1 } from "./flags-CdgIH1L6.mjs";
-import { n as builtinWorkflowFile, t as builtinProblem } from "./builtin-files-BRSOObAv.mjs";
-import { t as findRun } from "./find-mLYsR0uC.mjs";
+import { n as builtinWorkflowFile, t as builtinProblem } from "./builtin-files-yYaNTQRU.mjs";
+import { t as findRun } from "./find-k489laBa.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 { 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-Bvl2Fquu.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-BVrT43GO.mjs";
-import { a as decideRefusal, r as chatRefusal } from "./in-a-run-a447hxq8.mjs";
-import { t as context } from "./context-BN9A2Nnu.mjs";
-import { t as printList } from "./print-BaWiWf4v.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-BRiyQzUo.mjs";
-import { i as listedStatus, n as formatRuns, r as formatTreeView, t as ago } from "./format-hiDvtNGM.mjs";
-import { t as withStore$1 } from "./store-Dyr1mP8K.mjs";
+import { c as registeredProjects, n as WORKFLOW_SUFFIX, s as projectAt, t as WORKFLOW_DIR } from "./workflows-Djo1edlK.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-BS0nCccW.mjs";
+import { a as decideRefusal, r as chatRefusal } from "./in-a-run-D_9GlAlS.mjs";
+import { t as context } from "./context-Dq-VM_sq.mjs";
+import { i as readListArgs, n as filterArgs, o as allAlias, r as projectScope, t as fail$1 } from "./flags-B4ZZWspN.mjs";
+import { t as printList } from "./print-n2qetUHc.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-Cune1l6I.mjs";
+import { i as listedStatus, n as formatRuns, r as formatTreeView, t as ago } from "./format-DQc9A_ei.mjs";
+import { t as withStore$1 } from "./store-DACH768X.mjs";
 import path from "node:path";
 import { stringify } from "yaml";
 import { z } from "zod";
@@ -727,7 +727,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-CXBmaGwS.mjs");
+	const { cleanStaleLeases, leaseLedger } = await import("./src-BHod38UQ.mjs");
 	const { cleaned, failed } = await cleanStaleLeases({
 		bin,
 		ledger: leaseLedger(placeFiles(place).runs),
@@ -2992,31 +2992,31 @@ const main = defineCommand({
 		run,
 		ps,
 		logs,
-		attach: () => import("./attach-7lB5_jpr.mjs").then((module) => module.attach),
+		attach: () => import("./attach-EP374oMP.mjs").then((module) => module.attach),
 		tree,
-		usage: () => import("./usage-CxmpYYO4.mjs").then((module) => module.usage),
-		prune: () => import("./usage-CxmpYYO4.mjs").then((module) => module.prune),
+		usage: () => import("./usage-DxZ6JGd4.mjs").then((module) => module.usage),
+		prune: () => import("./usage-DxZ6JGd4.mjs").then((module) => module.prune),
 		decide,
-		relay: () => import("./relay-C0M1TWMB.mjs").then((module) => module.relay),
-		pause: () => import("./pause-Cy11KrXK.mjs").then((module) => module.pause),
-		continue: () => import("./pause-Cy11KrXK.mjs").then((module) => module.continueRun),
+		relay: () => import("./relay-D7RN4m68.mjs").then((module) => module.relay),
+		pause: () => import("./pause-Bx3ePGrn.mjs").then((module) => module.pause),
+		continue: () => import("./pause-Bx3ePGrn.mjs").then((module) => module.continueRun),
 		stop,
 		chat,
-		once: () => import("./once-lvwcWfVf.mjs").then((module) => module.once),
-		send: () => import("./send-qBxj0JbJ.mjs").then((module) => module.send),
+		once: () => import("./once-DuUzpzL2.mjs").then((module) => module.once),
+		send: () => import("./send-CKth_vgn.mjs").then((module) => module.send),
 		resume,
 		feedback,
-		"follow-ups": () => import("./follow-ups-DxCsOby1.mjs").then((module) => module.followUps),
+		"follow-ups": () => import("./follow-ups-DD8NTPe6.mjs").then((module) => module.followUps),
 		context,
-		worktrees: () => import("./worktrees-DOOCoS2w.mjs").then((module) => module.worktrees),
-		wt: () => import("./worktrees-DOOCoS2w.mjs").then((module) => module.worktrees),
-		watch: () => import("./watch-mkLm4t9D.mjs").then((module) => module.watch),
-		mcp: () => import("./mcp-CWng9I9n.mjs").then((module) => module.mcp),
-		ui: () => import("./ui-DLrSt5ny.mjs").then((module) => module.ui),
+		worktrees: () => import("./worktrees-Drof_Nyx.mjs").then((module) => module.worktrees),
+		wt: () => import("./worktrees-Drof_Nyx.mjs").then((module) => module.worktrees),
+		watch: () => import("./watch-Dp7IB4FR.mjs").then((module) => module.watch),
+		mcp: () => import("./mcp-D38Ajb0b.mjs").then((module) => module.mcp),
+		ui: () => import("./ui-CJ-BX12n.mjs").then((module) => module.ui),
 		doctor,
 		upgrade,
-		completion: () => import("./completion-Cgb2qPPh.mjs").then((module) => module.completion),
-		__complete: () => import("./completion-Cgb2qPPh.mjs").then((module) => module.completeCommand(main))
+		completion: () => import("./completion-DIXWlnAl.mjs").then((module) => module.completion),
+		__complete: () => import("./completion-DIXWlnAl.mjs").then((module) => module.completeCommand(main))
 	}
 });
 // src/bin.ts
@@ -3036,7 +3036,7 @@ const main = defineCommand({
 clearGitLocalEnv();
 const argv = takePlainFlag(process.argv.slice(2));
 if (argv[0] === "__complete") {
-	const { printCompletions } = await import("./completion-Cgb2qPPh.mjs");
+	const { printCompletions } = await import("./completion-DIXWlnAl.mjs");
 	await printCompletions(main, argv.slice(1));
 } else if (process.env["ORK_UPDATE_CHECK_CHILD"] === "1") await runUpdateChild();
 else {
@@ -3049,7 +3049,7 @@ 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-lvwcWfVf.mjs");
+		const { once } = await import("./once-DuUzpzL2.mjs");
 		await runCommand(once, { rawArgs: argv.slice(1) });
 	} catch (error) {
 		console.error(error);

package/dist/brief-Bs3cMQU0.mjs

@@ -0,0 +1,100 @@
+import { _n as takeFollowUps, nr as runGh } from "./src-DLsFsmOD.mjs";
+import { f as refreshDue, l as briefOf, n as flagValues, u as checkTakeable } from "./run-OOWQIKMJ.mjs";
+import { n as newRunId } from "./find-k489laBa.mjs";
+import { l as writeErr } from "./output-B1kwo0YU.mjs";
+import { t as loadWorkflow } from "./validate-BS0nCccW.mjs";
+// src/follow-ups/brief.ts
+/**
+* @file `ork run --follow-ups <ids>`: the `agent` follow-ups become the run's
+*   `brief` input, and are marked taken by the run, which finishes them when it
+*   publishes (`ork follow-ups published`). Everything that could refuse them
+*   (an unknown id, one for someone else, a workflow with no `brief` input) is
+*   checked before any is marked, so a run that doesn't start leaves them be.
+*/
+const FLAG = "--follow-ups";
+/** What `--follow-ups` takes besides ids: every due agent follow-up. */
+const DUE = "due";
+/**
+* Each `--follow-ups` value as typed (one per use, still comma-joined), and
+* whether one is missing: no value, an empty one, or a next argument that is
+* another flag.
+*/
+const given = (rawArgs) => {
+	const values = [];
+	let empty = false;
+	for (const [index, arg] of rawArgs.entries()) {
+		if (arg !== FLAG && !arg.startsWith(`${FLAG}=`)) continue;
+		const next = rawArgs[index + 1];
+		const parts = (arg === FLAG ? next === void 0 || next.startsWith("--") ? "" : next : arg.slice(13)).split(",").map((part) => part.trim()).filter((part) => part !== "");
+		if (parts.length === 0) empty = true;
+		values.push(...parts);
+	}
+	return {
+		values,
+		empty
+	};
+};
+/**
+* Says what `--follow-ups` needs when it is given with nothing after it, and
+* fails the command; true when it is fine (or not given).
+*/
+const followUpsFlagFine = (rawArgs) => {
+	if (!given(rawArgs).empty) return true;
+	writeErr(`${FLAG} needs follow-up ids, or \`${DUE}\` for every due agent follow-up. \`ork follow-ups list\` shows them.`);
+	process.exitCode = 1;
+	return false;
+};
+/**
+* What stops `--follow-ups` from starting a run, one line each; none when
+* nothing does.
+*/
+const problemsOf = (loaded, inputs) => {
+	const name = loaded.workflow?.name ?? "";
+	if (loaded.workflow?.inputs?.["brief"] === void 0) return [`--follow-ups fills a workflow's \`brief\` input, and ${name} has none.`];
+	return inputs.some((input) => input.startsWith("brief=")) ? ["--follow-ups and --input brief=… both set the brief."] : [];
+};
+/**
+* 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.
+*/
+const prepareFollowUps = async (store, rawArgs, runId, target, gh = runGh) => {
+	const inputs = flagValues(rawArgs, "--input");
+	const plain = {
+		inputs,
+		...runId === void 0 ? {} : { runId }
+	};
+	if (!followUpsFlagFine(rawArgs)) return void 0;
+	const { values } = given(rawArgs);
+	if (values.length === 0) return plain;
+	const loaded = loadWorkflow(target.file, process.cwd(), void 0, store.projects());
+	if (loaded.workflow === null) return plain;
+	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) : [];
+	if (named.length === 0 && due.length === 0) {
+		writeErr(`${FLAG} ${DUE}: no agent follow-ups are due. \`ork follow-ups list\` shows them.`);
+		process.exitCode = 1;
+		return;
+	}
+	const takeable = checkTakeable(store, project, [...named, ...due]);
+	const problems = [...problemsOf(loaded, inputs), ...takeable.ok ? [] : takeable.lines];
+	if (!takeable.ok || problems.length > 0) {
+		for (const line of problems) writeErr(line);
+		process.exitCode = 1;
+		return;
+	}
+	const followUps = [...new Map(takeable.followUps.map((f) => [f.id, f])).values()];
+	const taker = runId ?? newRunId(store);
+	takeFollowUps(store, {
+		project,
+		run: taker,
+		ids: followUps.map((f) => f.id)
+	});
+	return {
+		inputs: [...inputs, `brief=${briefOf(followUps)}`],
+		runId: taker
+	};
+};
+export { followUpsFlagFine, prepareFollowUps };

package/dist/{builtin-files-BRSOObAv.mjs → builtin-files-yYaNTQRU.mjs}

@@ -1,4 +1,4 @@
-import { Gr as writePlainFile, Nr as placeFiles, Ur as guardedBase, Wr as plainPathInside } from "./src-DN-RPsil.mjs";
+import { Gr as plainPathInside, Kr as writePlainFile, Pr as placeFiles, Wr as guardedBase } from "./src-DLsFsmOD.mjs";
 import path from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/{completion-Cgb2qPPh.mjs → completion-DIXWlnAl.mjs}

@@ -1,10 +1,10 @@
-import { L as openStore, Nr as placeFiles, Pr as placeFor, R as storePath, kn as liveStatus, pi as NodeIdSchema, rt as pendingDecisions, wi as AGENT_DRIVERS } from "./src-DN-RPsil.mjs";
-import { a as isBuiltinArg, i as builtinWorkflowText, r as builtinWorkflowNames } from "./builtin-files-BRSOObAv.mjs";
-import { t as findRun } from "./find-mLYsR0uC.mjs";
+import { An as liveStatus, Fr as placeFor, L as openStore, Pr as placeFiles, R as storePath, Ti as AGENT_DRIVERS, mi as NodeIdSchema, rt as pendingDecisions } from "./src-DLsFsmOD.mjs";
+import { a as isBuiltinArg, i as builtinWorkflowText, r as builtinWorkflowNames } from "./builtin-files-yYaNTQRU.mjs";
+import { t as findRun } from "./find-k489laBa.mjs";
 import { a as SHELL_SCRIPTS, i as SHELLS, n as groupedEntries, r as COMPLETE_COMMAND, t as groupOf } from "./help-groups-hB6kY34d.mjs";
 import { i as findEntry, n as argInfoOf, s as subcommandsOf } from "./command-tree-BkSYWmYJ.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-import { a as resolveWorkflowArg, n as WORKFLOW_SUFFIX } from "./workflows-Bvl2Fquu.mjs";
+import { a as resolveWorkflowArg, n as WORKFLOW_SUFFIX } from "./workflows-Djo1edlK.mjs";
 import path from "node:path";
 import { parse } from "yaml";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
@@ -142,6 +142,39 @@ const forCandidates = (store) => [
 		description: p.root
 	}))
 ];
+/** The longest title a menu shows. */
+const TITLE_LIMIT = 60;
+/** A title as one short line: first line only, cut with an ellipsis. */
+const shortTitle = (title) => {
+	const line = (title.split("\n")[0] ?? "").trim();
+	return line.length > TITLE_LIMIT ? `${line.slice(0, 59)}…` : line;
+};
+/**
+* What `ork run --follow-ups` takes: `due` (every due agent follow-up), then
+* the project's open agent follow-ups, due before waiting, each described by
+* its title. Closed and other people's follow-ups are left out; an unreadable
+* store gives `due` only.
+*/
+const followUpCandidates = (store, place) => {
+	const open = (status) => {
+		try {
+			return (store?.followUps(place.root) ?? []).filter((f) => f.for === "agent" && f.status === status).map((f) => ({
+				value: f.id,
+				description: shortTitle(f.title)
+			}));
+		} catch {
+			return [];
+		}
+	};
+	return [
+		{
+			value: "due",
+			description: "every due agent follow-up"
+		},
+		...open("due"),
+		...open("waiting")
+	];
+};
 // src/completion/values.ts
 const withStore = (context, read) => {
 	const store = context.store();
@@ -192,6 +225,14 @@ const forWhom = {
 	group: "for",
 	values: (context) => forCandidates(context.store())
 };
+/** `ork run --follow-ups`: `due`, then the project's open agent follow-ups. */
+const followUps = {
+	group: "follow-ups",
+	values: (context) => {
+		const store = context.store();
+		return followUpCandidates(store, placeOf(context.cwd, store));
+	}
+};
 const drivers = {
 	group: "drivers",
 	values: () => AGENT_DRIVERS.map((driver) => ({
@@ -223,6 +264,7 @@ const VALUE_PROVIDERS = {
 	node: nodes,
 	input: inputs,
 	"decide id": decisions,
+	"run follow-ups": followUps,
 	"completion shell": shells,
 	driver: drivers,
 	project: projects,

package/dist/{context-BN9A2Nnu.mjs → context-Dq-VM_sq.mjs}

@@ -1,7 +1,7 @@
-import { Vr as LESSON_CAP_TOKENS, gt as explainSession } from "./src-DN-RPsil.mjs";
+import { Hr as LESSON_CAP_TOKENS, gt as explainSession } from "./src-DLsFsmOD.mjs";
 import { c as write, s as style } from "./output-B1kwo0YU.mjs";
-import { i as refusedBuiltin, o as workflowArg } from "./workflows-Bvl2Fquu.mjs";
-import { a as formatReport, t as loadWorkflow } from "./validate-BVrT43GO.mjs";
+import { i as refusedBuiltin, o as workflowArg } from "./workflows-Djo1edlK.mjs";
+import { a as formatReport, t as loadWorkflow } from "./validate-BS0nCccW.mjs";
 import { defineCommand } from "citty";
 // src/commands/context.ts
 /**

package/dist/{find-mLYsR0uC.mjs → find-k489laBa.mjs}

@@ -1,4 +1,4 @@
-import { Pr as placeFor } from "./src-DN-RPsil.mjs";
+import { Fr as placeFor } from "./src-DLsFsmOD.mjs";
 import { randomUUID } from "node:crypto";
 // ../core/src/remote/find.ts
 /**

package/dist/{flags-CdgIH1L6.mjs → flags-B4ZZWspN.mjs}

@@ -1,112 +1,7 @@
-import "./src-DN-RPsil.mjs";
+import "./src-DLsFsmOD.mjs";
+import { n as parseLimit, t as parseFilters } from "./parse-BzWpMN-a.mjs";
 import { t as INTERNAL } from "./command-tree-BkSYWmYJ.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-// ../core/src/list-filters/time.ts
-/**
-* @file The times every list's `--since` and `--until` take (specs/usage.md,
-*   RFC-017), and `ork prune --older-than`'s age: an age (`24h`, `30d`, `12w`)
-*   or a day (`2026-11-01`, in the machine's time zone).
-*/
-const UNITS = {
-	h: 36e5,
-	d: 864e5,
-	w: 6048e5
-};
-/** `30d`, `12w`, `24h` before `now`, as an ISO time; `null` when it is not one. */
-const agoTime = (text, now) => {
-	const match = /^(\d+)([hdw])$/u.exec(text);
-	if (match === null) return null;
-	const [, amount = "0", unit = "d"] = match;
-	if (Number(amount) === 0) return null;
-	const date = new Date(now - Number(amount) * (UNITS[unit] ?? 0));
-	return Number.isNaN(date.getTime()) ? null : date.toISOString();
-};
-/** A `YYYY-MM-DD` day's start in the machine's time zone, `after` days on. */
-const dayTime = (text, after) => {
-	const match = /^(\d{4})-(\d{2})-(\d{2})$/u.exec(text);
-	if (match === null) return null;
-	const [, year = "", month = "", day = ""] = match;
-	const start = new Date(Number(year), Number(month) - 1, Number(day));
-	if (start.getMonth() !== Number(month) - 1) return null;
-	if (start.getDate() !== Number(day)) return null;
-	start.setDate(start.getDate() + after);
-	return start.toISOString();
-};
-/** The start of the day `days` whole days ago, counting today as one. */
-const wholeDays = (days, now) => {
-	const today = new Date(now);
-	return new Date(today.getFullYear(), today.getMonth(), today.getDate() - (days - 1)).toISOString();
-};
-/**
-* `--since`: an age or the day it starts from. Days and weeks are whole days,
-* today among them, as the Usage panel counts them; hours are exact.
-*/
-const sinceTime = (text, now) => {
-	const ago = agoTime(text, now);
-	if (ago === null) return dayTime(text, 0);
-	if (text.endsWith("h")) return ago;
-	const amount = Number(text.slice(0, -1));
-	return wholeDays(text.endsWith("w") ? amount * 7 : amount, now);
-};
-/** `--until`: the last day it includes. */
-const untilTime = (text) => dayTime(text, 1);
-// ../core/src/list-filters/parse.ts
-/**
-* @file Reads a list's filter flags against its field table (RFC-017): each
-*   value checked, times turned into ISO times, and `--limit`.
-*/
-const FOR = /^(agent|me|(project|person):\S+)$/u;
-/** The field's value, checked; `null` when the field does not take it. */
-const valueOf = (field, text, now) => {
-	if (text === "all" && field.all === true) return "all";
-	return {
-		enum: () => field.values?.includes(text) === true ? text : null,
-		text: () => text === "" ? null : text,
-		for: () => FOR.test(text) ? text : null,
-		since: () => sinceTime(text, now),
-		until: () => untilTime(text)
-	}[field.type]();
-};
-/** What the field takes, for the error that refuses a value. */
-const takes = (field) => {
-	const all = field.all === true ? ["all"] : [];
-	const or = all.length === 0 ? "" : " or all";
-	return {
-		enum: `one of ${[...field.values ?? [], ...all].join(", ")}`,
-		text: `a value${or}`,
-		for: "agent, me, project:<name> or person:<name>",
-		since: `an age (30d), a day (2026-11-01)${or}`,
-		until: "a day (2026-11-01)"
-	}[field.type];
-};
-/**
-* The filter `given` (a command's parsed flags, by field name) asks for, each
-* value checked against `table`; `now` dates an age. The first value a field
-* does not take is refused, naming the flag and what it takes.
-*/
-const parseFilters = (table, given, now) => {
-	const filter = {};
-	for (const field of table.fields) {
-		const text = given[field.name];
-		if (typeof text !== "string") continue;
-		const value = valueOf(field, text, now);
-		if (value === null) return {
-			ok: false,
-			error: `--${field.name} takes ${takes(field)}, not \`${text}\`.`
-		};
-		filter[field.name] = value;
-	}
-	return {
-		ok: true,
-		filter
-	};
-};
-/** `--limit`: a positive whole number, else `null` (`0`, `-1`, `abc`, `2.5`). */
-const parseLimit = (text) => {
-	if (!/^[1-9]\d*$/u.test(text)) return null;
-	const limit = Number(text);
-	return Number.isSafeInteger(limit) ? limit : null;
-};
 // src/list/all-alias.ts
 /**
 * @file The deprecated `--all` of `ps`, `usage`, `decide`, `follow-ups list`
@@ -227,4 +122,4 @@ const projectScope = (filter, projects) => {
 	const names = projects.map((p) => p.id);
 	fail(`No registered project \`${key}\`; registered: ${names.length === 0 ? "none" : names.join(", ")}.`);
 };
-export { refuseIdsWithJson as a, readListArgs as i, filterArgs as n, allAlias as o, projectScope as r, agoTime as s, fail as t };
+export { refuseIdsWithJson as a, readListArgs as i, filterArgs as n, allAlias as o, projectScope as r, fail as t };

package/dist/{follow-ups-DxCsOby1.mjs → follow-ups-DD8NTPe6.mjs}

@@ -1,13 +1,13 @@
-import { Pr as placeFor, Vt as followUpListTable, _n as deliverFollowUp, mn as recordPublished, pn as markDue, tr as runGh, vn as followUpProblem } from "./src-DN-RPsil.mjs";
-import { d as followUpsRule, f as refreshDue, n as flagValues } from "./run-B-j3Qxqc.mjs";
-import { g as changeFollowUp, v as findFollowUp, x as isGithubIssueUrl, y as followUpActions } from "./__build_info__-DcRdK0Du.mjs";
-import { t as postFollowUpMessage } from "./post-C9soCx7i.mjs";
+import { Fr as placeFor, Ht as followUpListTable, hn as recordPublished, mn as markDue, nr as runGh, vn as deliverFollowUp, yn as followUpProblem } from "./src-DLsFsmOD.mjs";
+import { d as followUpsRule, f as refreshDue, n as flagValues } from "./run-OOWQIKMJ.mjs";
+import { g as changeFollowUp, v as findFollowUp, x as isGithubIssueUrl, y as followUpActions } from "./__build_info__-C1Nm0hlJ.mjs";
+import { t as postFollowUpMessage } from "./post-2CaJz_mV.mjs";
 import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
-import { i as readListArgs, n as filterArgs, o as allAlias } from "./flags-CdgIH1L6.mjs";
-import { t as findRun } from "./find-mLYsR0uC.mjs";
+import { t as findRun } from "./find-k489laBa.mjs";
 import { a as plain, c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { t as printList } from "./print-BaWiWf4v.mjs";
-import { t as withStore } from "./store-Dyr1mP8K.mjs";
+import { i as readListArgs, n as filterArgs, o as allAlias } from "./flags-B4ZZWspN.mjs";
+import { t as printList } from "./print-n2qetUHc.mjs";
+import { t as withStore } from "./store-DACH768X.mjs";
 import { homedir } from "node:os";
 import { defineCommand } from "citty";
 // src/follow-ups/command.ts

package/dist/{format-hiDvtNGM.mjs → format-DQc9A_ei.mjs}

@@ -1,4 +1,4 @@
-import { An as lockWaitsOf, Ln as isItem, Mn as runStatus, Nn as slotWaitsOf, kn as liveStatus, kt as lockWaitLine } from "./src-DN-RPsil.mjs";
+import { An as liveStatus, Nn as runStatus, Pn as slotWaitsOf, Rn as isItem, jn as lockWaitsOf, kt as lockWaitLine } from "./src-DLsFsmOD.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-D_9GlAlS.mjs

@@ -0,0 +1,27 @@
+import { R as storePath } from "./src-DLsFsmOD.mjs";
+import { g as storeGuarded, h as runMarkerIn } from "./src-DmmrX2_C.mjs";
+// src/commands/in-a-run.ts
+/**
+* @file The commands that act as the user refuse a program or an agent in a run
+*   (ADR-047), in the stores that run guards: the store of a nested run under a
+*   temp HOME is not guarded unless an enclosing run lists it. The refusal
+*   names the variable it saw, for someone at their own terminal who inherited
+*   it. It stops accidents; it is not a boundary.
+*/
+const refusal = (why, env, store) => {
+	const marker = runMarkerIn(env);
+	return marker === null || !storeGuarded(env, store) ? null : `${why} ${marker} is set here. If this is your own terminal, it inherited that from a program in a run (a tmux server started by one, say); open a shell without it.`;
+};
+/** Why `ork watch --accept` refuses here, or `null` when it may run. */
+const acceptRefusal = (env = process.env, store = storePath()) => refusal("`ork watch --accept` approves code to run with nobody there, so a program or an agent in a run cannot use it.", env, store);
+/** Why `ork chat` refuses here, or `null` when it may run. */
+const chatRefusal = (env = process.env, store = storePath()) => refusal("`ork chat` speaks as you, so a program or an agent in a run cannot use it. A program writes to a session with `ork send`.", env, store);
+/** Why `ork decide` will not answer here, or `null` when it may. */
+const decideRefusal = (env = process.env, store = storePath()) => refusal("`ork decide` answers as you, so a program or an agent in a run cannot answer with it; `ork decide --list` still shows what is open.", env, store);
+/** Why `ork continue` refuses here, or `null` when it may run. */
+const continueRefusal = (env = process.env, store = storePath()) => refusal("`ork continue` undoes a pause you set, so a program or an agent in a run cannot use it.", env, store);
+/** Whether `ork ui` may print its sign-in link, which acts as the user. */
+const mayShowSignIn = (env = process.env, store = storePath()) => !storeGuarded(env, store);
+/** Why `ork attach` will not answer here, or `null` when it may. */
+const attachRefusal = (env = process.env, store = storePath()) => 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, store);
+export { decideRefusal as a, continueRefusal as i, attachRefusal as n, mayShowSignIn as o, chatRefusal as r, acceptRefusal as t };

package/dist/{install-23g_1ngs.mjs → install-PVlV2QPq.mjs}

@@ -1,4 +1,4 @@
-import { Gr as writePlainFile, Hr as estimateTokens, Nr as placeFiles, Pr as placeFor, Ur as guardedBase, Vr as LESSON_CAP_TOKENS, Wr as plainPathInside, Xn as FEEDBACK_KINDS, Zn as FEEDBACK_SEVERITIES, cr as targetOf, or as fingerprint, rr as publishPost, vr as maskSecrets, zr as inside } from "./src-DN-RPsil.mjs";
+import { Br as inside, Fr as placeFor, Gr as plainPathInside, Hr as LESSON_CAP_TOKENS, Kr as writePlainFile, Pr as placeFiles, Qn as FEEDBACK_SEVERITIES, Ur as estimateTokens, Wr as guardedBase, Zn as FEEDBACK_KINDS, ir as publishPost, lr as targetOf, sr as fingerprint, yr as maskSecrets } from "./src-DLsFsmOD.mjs";
 import path from "node:path";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { spawn } from "node:child_process";

package/dist/{limits-C_Xz_t3C.mjs → limits-CHqBO7wb.mjs}

@@ -1,4 +1,4 @@
-import { _ as capsHere, dt as NOT_STARTED, ft as limitsNow, pt as limitsReport } from "./src-DN-RPsil.mjs";
+import { _ as capsHere, dt as NOT_STARTED, ft as limitsNow, pt as limitsReport } from "./src-DLsFsmOD.mjs";
 // src/run/limits.ts
 /**
 * @file The limits across runs that apply here (RFC-007): the user's settings

package/dist/{mcp-CWng9I9n.mjs → mcp-D38Ajb0b.mjs}

@@ -1,8 +1,8 @@
-import { w as isNewer } from "./src-DN-RPsil.mjs";
-import { n as ORK_VERSION } from "./__build_info__-DcRdK0Du.mjs";
-import { p as runMarkerIn } from "./src-DHDQ0itC.mjs";
-import { n as explainNode } from "./context-BN9A2Nnu.mjs";
-import { a as openMcp, c as refused, o as tool, s as answer } from "./src-nXLIwDrt.mjs";
+import { w as isNewer } from "./src-DLsFsmOD.mjs";
+import { n as ORK_VERSION } from "./__build_info__-C1Nm0hlJ.mjs";
+import { h as runMarkerIn } from "./src-DmmrX2_C.mjs";
+import { n as explainNode } from "./context-Dq-VM_sq.mjs";
+import { a as openMcp, c as refused, o as tool, s as answer } from "./src-DOjTY2ET.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.16") ? tooOld(all, options.expects) : all;
+	const tools = options.expects !== void 0 && isNewer(options.expects, "1.0.0-alpha.17") ? tooOld(all, options.expects) : all;
 	const server = new McpServer({
 		name: "ork",
 		version: ORK_VERSION

package/dist/{once-lvwcWfVf.mjs → once-DuUzpzL2.mjs}

@@ -1,7 +1,7 @@
-import "./src-DN-RPsil.mjs";
-import { t as runOnce } from "./run-D_u9V_Ve.mjs";
+import "./src-DLsFsmOD.mjs";
+import { t as runOnce } from "./run-BfxdsQJk.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { t as ago } from "./format-hiDvtNGM.mjs";
+import { t as ago } from "./format-DQc9A_ei.mjs";
 import { spawn } from "node:child_process";
 import { defineCommand, parseArgs } from "citty";
 // src/commands/once.ts