@krapht/ork 1.0.0-alpha.6 → 1.0.0-alpha.7

package/dist/{__build_info__-CxH89h1r.mjs → __build_info__-BGoaUwLd.mjs}

@@ -1,4 +1,4 @@
-import { Cn as placeFiles, Fn as writePlainFile, Ht as FEEDBACK_SEVERITIES, Jt as publishPost, Mn as estimateTokens, Nn as guardedBase, Pn as plainPathInside, Qt as targetOf, Vt as FEEDBACK_KINDS, Xt as fingerprint, cn as maskSecrets, g as parseVersion, h as isNewer, jn as LESSON_CAP_TOKENS, kn as inside, m as compareVersions, wn as placeFor } from "./src-DG4dyBqm.mjs";
+import { Cn as placeFiles, Ct as runTree, Fn as writePlainFile, Ht as FEEDBACK_SEVERITIES, Jt as publishPost, Mn as estimateTokens, Nn as guardedBase, Pn as plainPathInside, Qt as targetOf, Vt as FEEDBACK_KINDS, Xt as fingerprint, cn as maskSecrets, g as parseVersion, h as isNewer, jn as LESSON_CAP_TOKENS, kn as inside, m as compareVersions, wn as placeFor } from "./src-BsLHKQRc.mjs";
 import path from "node:path";
 import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -410,6 +410,75 @@ const nodeSession = (events, node) => {
 		outputs
 	};
 };
+// ../core/src/store/activity.ts
+const LONGEST_LINE = 120;
+/**
+* The fields of a tool's input that say what it's working on, best first. Only
+* these are shown, so what else a tool was given stays in the logs.
+*/
+const TARGETS = [
+	"file_path",
+	"notebook_path",
+	"path",
+	"url",
+	"pattern",
+	"query",
+	"command"
+];
+const oneLine = (text) => {
+	const line = text.replaceAll(/\s+/gu, " ").trim();
+	return line.length > LONGEST_LINE ? `${line.slice(0, 119)}…` : line;
+};
+const toolLine = ({ name, input }) => {
+	const target = TARGETS.map((field) => input[field]).find((value) => typeof value === "string" && value.trim() !== "");
+	if (typeof target !== "string") return name;
+	return oneLine(target.startsWith(`${name} `) ? target : `${name} ${target}`);
+};
+/** What a finished node said, or why it failed. */
+const finishedNow = (ok, error, summary) => {
+	if (!ok) return error === void 0 ? void 0 : oneLine(error);
+	return typeof summary === "string" && summary.trim() !== "" ? oneLine(summary) : void 0;
+};
+/** Each node's activity, by id; a node that never started has none. */
+const runActivity = (stored) => {
+	const nodes = /* @__PURE__ */ new Map();
+	const of = (id) => {
+		const found = nodes.get(id);
+		if (found !== void 0) return found;
+		const fresh = {};
+		nodes.set(id, fresh);
+		return fresh;
+	};
+	for (const { at, event } of stored) if (event.type === "node.started") {
+		const node = of(event.id);
+		node.startedAt ??= at;
+		delete node.finishedAt;
+		delete node.now;
+	} else if (event.type === "node.event") {
+		if (event.event.type === "tool.called") of(event.id).now = toolLine(event.event);
+	} else if (event.type === "decision.opened") of(event.node).now = oneLine(`Asked: ${event.question}`);
+	else if (event.type === "decision.answered") of(event.node).now = oneLine(`Answered: ${event.answer}`);
+	else if (event.type === "decision.withdrawn") delete of(event.node).now;
+	else if (event.type === "node.finished") {
+		const node = of(event.id);
+		node.finishedAt = at;
+		const now = finishedNow(event.ok, event.error, event.output["summary"]);
+		if (now === void 0) delete node.now;
+		else node.now = now;
+	}
+	return nodes;
+};
+/** The ownership tree, with what each node is doing and when it ran. */
+const activeTree = (stored) => {
+	const activity = runActivity(stored);
+	const dress = (node) => {
+		Object.assign(node, activity.get(node.id));
+		for (const child of node.children) dress(child);
+	};
+	const roots = runTree(stored.map(({ event }) => event));
+	for (const root of roots) dress(root);
+	return roots;
+};
 /** The dist-tags every install follows, toward and after 1.0.0. */
 const CHANNEL_TAGS = [
 	"latest",
@@ -611,5 +680,5 @@ const registryShown = (registry) => {
 *   fails when it is stale.
 */
 const ORK_NAME = "@krapht/ork";
-const ORK_VERSION = "1.0.0-alpha.6";
-export { feedbackActions as C, placeOf as S, previewPost as _, registryShown as a, acceptItem as b, checkDue as c, pendingNotice as d, readUpdateCache as f, nodeSession as g, writeUpdateCache as h, registryOf as i, fetchLatest as l, updateCachePath as m, ORK_VERSION as n, updateSwitchOff as o, refreshUpdateCache as p, isSwitchedOn as r, runInstall as s, ORK_NAME as t, newerVersion as u, checkNote as v, openFixRun as w, lessonPlaceOf as x, recordNote as y };
+const ORK_VERSION = "1.0.0-alpha.7";
+export { placeOf as C, lessonPlaceOf as S, openFixRun as T, nodeSession as _, registryShown as a, recordNote as b, checkDue as c, pendingNotice as d, readUpdateCache as f, activeTree as g, writeUpdateCache as h, registryOf as i, fetchLatest as l, updateCachePath as m, ORK_VERSION as n, updateSwitchOff as o, refreshUpdateCache as p, isSwitchedOn as r, runInstall as s, ORK_NAME as t, newerVersion as u, previewPost as v, feedbackActions as w, acceptItem as x, checkNote as y };

package/dist/bin.mjs

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-import { An as projectRootOf, Cn as placeFiles, D as inspectProject, Dn as shownPath, Dt as userMessageText, En as runDirOf, Ft as PROJECT_FILE, Gt as planPost, H as tellNode, Ht as FEEDBACK_SEVERITIES, I as createCalls, It as gitRulesOf, J as tellLiveRun, Kn as WorkflowSchema, L as addressOf, Lt as loadProject, M as clearGitLocalEnv, N as parseInputPairs, P as resolveInputs, Qn as isClaudeNode, R as endLink, Sn as newProjectId, Tn as projectsHome, Tt as startRun, Un as serializeWorkflow, Ut as FEEDBACK_TARGETS, V as peerOf, Vt as FEEDBACK_KINDS, W as flattenTree, Xt as fingerprint, Yn as settingsOf, Yt as createFeedback, Zn as beforeOf, Zt as normalizeTitle, _ as lateTriggers, _n as catalogAgent, _t as runStatus, an as socketRoom, bn as hasInRepoFiles, cr as CLAUDE_DRIVERS, d as runningRunIds, dn as planMoveInto, dr as experimentsOn, dt as namingNoDriver, et as adoptedCalls, f as runningScript, fn as linkTools, fr as knownExperiments, ft as sessionDriver, gn as deleteAgent, h as isNewer, hn as createAgent, ht as liveStatus, i as NOT_STARTED, in as socketPath, it as replayLoopAnswers, kn as inside, l as planUpgrade, ln as planAgentMigration, lr as firstLine, mn as toolsInUse, n as resolveBase, nt as resumable, on as wakeRun, or as AGENT_TOOL_LAYOUTS, ot as detachRun, pn as toolLinks, q as requestStop, qt as sendPost, rn as serveRun, rr as INTEGRATIONS, rt as createReplay, sn as maskReplacer, sr as ORK_LAYOUT, st as followEvents, t as createWorkspace, tt as detachResume, u as releaseNotes, un as applySteps, ur as EXPERIMENTS, ut as planNodeSession, v as triggersReport, vn as loadAgents, vt as runTree, wn as placeFor, wt as walkSummary, xn as inRepoPlace, z as endLinksOf } from "./src-DG4dyBqm.mjs";
-import { a as formatRunEvent, i as formatEvent, n as formatRuns, o as createTerminalHuman, r as formatTree, s as createDecisionQueue, t as ago } from "./format-OL0E1AjA.mjs";
-import { C as feedbackActions, S as placeOf, _ as previewPost, b as acceptItem, c as checkDue, d as pendingNotice, f as readUpdateCache, g as nodeSession, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, s as runInstall, t as ORK_NAME, u as newerVersion$1, v as checkNote, w as openFixRun, y as recordNote } from "./__build_info__-CxH89h1r.mjs";
-import { i as builtinWorkflowFile, n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-Cnt7o3ya.mjs";
-import { n as newRunId, t as findRun } from "./find-Dy2H5IvT.mjs";
-import { a as write, c as openStore, i as style, l as storePath, n as cost, o as writeErr, s as nodeOf, t as confirm } from "./output-CjOPL8W0.mjs";
-import { n as listOrkWorktrees, t as createdWorktrees } from "./list-P5CfcoWx.mjs";
-import { a as planClean, t as applyClean } from "./clean-BbrkMQQi.mjs";
+import { $ as adoptedCalls, $n as isClaudeNode, An as projectRootOf, B as peerOf, Cn as placeFiles, Ct as runTree, D as inspectProject, Dn as shownPath, En as runDirOf, F as createCalls, Ft as PROJECT_FILE, Gn as serializeWorkflow, Gt as planPost, Ht as FEEDBACK_SEVERITIES, I as addressOf, It as gitRulesOf, Jn as WorkflowSchema, K as requestStop, L as endLink, Lt as loadProject, M as clearGitLocalEnv, N as parseInputPairs, P as resolveInputs, R as endLinksOf, Sn as newProjectId, St as runStatus, Tn as projectsHome, U as flattenTree, Ut as FEEDBACK_TARGETS, V as tellNode, Vn as beforeOf, Vt as FEEDBACK_KINDS, Xt as fingerprint, Yt as createFeedback, Zn as settingsOf, Zt as normalizeTitle, _ as lateTriggers, _n as catalogAgent, an as socketRoom, at as followEvents, bn as hasInRepoFiles, bt as liveStatus, cr as CLAUDE_DRIVERS, ct as planNodeSession, d as runningRunIds, dn as planMoveInto, dr as experimentsOn, et as detachResume, f as runningScript, fn as linkTools, fr as knownExperiments, gn as deleteAgent, gt as startRun, h as isNewer, hn as createAgent, ht as walkSummary, i as NOT_STARTED, in as socketPath, it as detachRun, kn as inside, l as planUpgrade, ln as planAgentMigration, lr as firstLine, lt as namingNoDriver, mn as toolsInUse, n as resolveBase, nt as listKey, on as wakeRun, or as AGENT_TOOL_LAYOUTS, pn as toolLinks, q as tellLiveRun, qt as sendPost, rn as serveRun, rr as INTEGRATIONS, sn as maskReplacer, sr as ORK_LAYOUT, t as createWorkspace, tt as resumable, u as releaseNotes, un as applySteps, ur as EXPERIMENTS, ut as sessionDriver, v as triggersReport, vn as loadAgents, vt as userMessageText, wn as placeFor, wt as templateOf, xn as inRepoPlace } from "./src-BsLHKQRc.mjs";
+import { a as formatEvent, c as createDecisionQueue, i as nestItems, n as formatRuns, o as formatRunEvent, r as formatTree, s as createTerminalHuman, t as ago } from "./format-DaROJUgG.mjs";
+import { C as placeOf, T as openFixRun, _ as nodeSession, b as recordNote, c as checkDue, d as pendingNotice, f as readUpdateCache, g as activeTree, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, s as runInstall, t as ORK_NAME, u as newerVersion$1, v as previewPost, w as feedbackActions, x as acceptItem, y as checkNote } from "./__build_info__-BGoaUwLd.mjs";
+import { i as builtinWorkflowFile, n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-DsA6kOT7.mjs";
+import { n as newRunId, t as findRun } from "./find-ntyniv2E.mjs";
+import { a as write, c as openStore, i as style, l as storePath, n as cost, o as writeErr, s as isNodeEvent, t as confirm } from "./output-CwqlG1Le.mjs";
+import { n as listOrkWorktrees, t as createdWorktrees } from "./list-D9HPWLPH.mjs";
+import { a as planClean, t as applyClean } from "./clean-BPITM-6p.mjs";
 import { c as subcommandsOf, i as argsOf, n as groupedEntries, o as publicArgs, s as resolved, t as groupOf } from "./help-groups-BwYoAWsh.mjs";
-import { _ as namedMcpEntries, a as builtinExecutors, d as maskedEnv, f as maskedNamesOfRun, g as clearOutputFiles, h as sessionEnv, i as onPath, l as clearStateFiles, m as runScrubber, n as missingProgramMessage, r as missingPrograms, t as envProblems, v as resultOf } from "./src-8nec4uoe.mjs";
-import { c as registeredProjects, i as refusedBuiltin, n as WORKFLOW_SUFFIX, o as workflowArg, s as projectAt, t as WORKFLOW_DIR } from "./workflows-lpexsAYt.mjs";
-import { a as validate, c as warningLines, i as loadWorkflow, o as validateFile, r as formatReport, s as walkLoaded, t as context } from "./context-CHV6aTs7.mjs";
-import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-TxTnWxix.mjs";
-import { i as decideRefusal, n as chatRefusal } from "./in-a-run-emTc-kZI.mjs";
+import { _ as namedMcpEntries, a as builtinExecutors, d as maskedEnv, f as maskedNamesOfRun, g as clearOutputFiles, h as sessionEnv, i as onPath, l as clearStateFiles, m as runScrubber, n as missingProgramMessage, r as missingPrograms, t as envProblems, v as resultOf } from "./src-CUeMUVwW.mjs";
+import { c as registeredProjects, i as refusedBuiltin, n as WORKFLOW_SUFFIX, o as workflowArg, s as projectAt, t as WORKFLOW_DIR } from "./workflows-BNCDD6J-.mjs";
+import { a as validate, c as warningLines, i as loadWorkflow, o as validateFile, r as formatReport, s as walkLoaded, t as context } from "./context-CZNM454F.mjs";
+import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-BKzVMwkt.mjs";
+import { i as decideRefusal, n as chatRefusal } from "./in-a-run-D_fnj1Mw.mjs";
 import path from "node:path";
 import { stringify } from "yaml";
 import { z } from "zod";
@@ -421,6 +421,88 @@ const createRelay = (options) => {
 		}
 	};
 };
+// ../core/src/run/replay.ts
+const NO_FAN_OUTS = {
+	lists: /* @__PURE__ */ new Map(),
+	items: /* @__PURE__ */ new Map()
+};
+/** Whether an activation's input carries a result this run made anew. */
+const carries = (fresh, input) => {
+	if (input === void 0) return false;
+	if (fresh.has(input)) return true;
+	const results = input["results"];
+	if (results === null || typeof results !== "object") return false;
+	return Object.values(results).some((value) => value !== null && typeof value === "object" && fresh.has(value));
+};
+/**
+* Hands each node's recorded results back in order, until the node runs anew
+* once (it failed or never finished last time, or its input is new); from then
+* on it always runs. A node cut off mid-session continues that session, once.
+*/
+const createReplay = (history, cutOff = /* @__PURE__ */ new Map(), mail, earlier, fanOuts = NO_FAN_OUTS) => {
+	const sessions = new Map(cutOff);
+	const used = /* @__PURE__ */ new Map();
+	const anew = /* @__PURE__ */ new Set();
+	const fresh = /* @__PURE__ */ new WeakSet();
+	/** Fanned nodes whose list was resolved anew: their items can't be replayed. */
+	const renewed = /* @__PURE__ */ new Set();
+	const takeItem = (activation, of) => {
+		const recorded = fanOuts.items.get(activation.id)?.get(activation.round ?? 0);
+		if (recorded !== void 0 && !renewed.has(of) && !carries(fresh, activation.input)) return recorded;
+		anew.add(activation.id);
+		return null;
+	};
+	return {
+		take: (activation) => {
+			const { id } = activation;
+			if (activation.brief !== void 0 || anew.has(id)) return null;
+			if (activation.item !== void 0) return takeItem(activation, activation.item.of);
+			const index = used.get(id) ?? 0;
+			const recorded = history.get(id)?.[index];
+			if (recorded === void 0 || carries(fresh, activation.input)) {
+				anew.add(id);
+				return null;
+			}
+			used.set(id, index + 1);
+			return recorded;
+		},
+		ran: (result) => {
+			fresh.add(result.output);
+		},
+		cutOff: (activation) => {
+			const session = activation.brief === void 0 && (activation.item === void 0 || !renewed.has(activation.item.of)) ? sessions.get(activation.id) : void 0;
+			sessions.delete(activation.id);
+			return session;
+		},
+		listed: (id, round, source) => {
+			const list = fanOuts.lists.get(listKey(id, round));
+			const ranAnew = typeof source === "object" && source !== null && fresh.has(source);
+			if (list !== void 0 && !ranAnew) return list;
+			renewed.add(id);
+			return null;
+		},
+		previousSession: ({ id, item, round = 0 }) => item === void 0 || renewed.has(item.of) ? void 0 : [...fanOuts.items.get(id) ?? []].findLast(([before]) => before < round)?.[1].sessionId,
+		kept: () => [...history.keys(), ...fanOuts.items.keys()],
+		...mail === void 0 ? {} : { mail },
+		...earlier === void 0 ? {} : { earlier }
+	};
+};
+/**
+* The run's `HumanChannel`, answering questions about loops out of rounds as
+* they were answered last time, in order; anything else goes to `human`.
+*/
+const replayLoopAnswers = (human, answers) => {
+	const left = [...answers];
+	return {
+		permit: (request) => human.permit(request),
+		...human.settled === void 0 ? {} : { settled: human.settled },
+		ask: (question) => {
+			const index = left.findIndex((a) => a.question === question.question);
+			const [given] = index === -1 ? [] : left.splice(index, 1);
+			return given === void 0 ? human.ask(question) : Promise.resolve(given.answer);
+		}
+	};
+};
 // ../core/src/store/recorder.ts
 /**
 * @file Records a run as it happens: each event appended to the store and
@@ -831,12 +913,11 @@ const runReadyDriver = async (workflow, options) => {
 *   where it ran, as the run's sessions were set up (ADR-065), and the exchange
 *   is added to the run's record.
 */
-/** The declared node a spawned worker (`<template>-<n>`) is an instance of. */
-const templateOf = (nodes, id) => {
-	if (id in nodes) return void 0;
-	const template = id.replace(/-\d+$/u, "");
-	return template in nodes ? template : void 0;
-};
+/**
+* The declared node a spawned worker or an item of a fanned node is an instance
+* of.
+*/
+const instanceOf = (nodes, id) => id in nodes ? void 0 : templateOf(id, new Set(Object.keys(nodes)));
 /** The run's sessions loaded the machine's Claude setup, so this one does. */
 const machineClaudeOf = (events) => events.some(({ event }) => event.type === "run.started" && event.settings?.machineClaude === true) ? { machineClaude: true } : {};
 /**
@@ -857,7 +938,7 @@ const resumeChat = async (options) => {
 	const notice = chatNotice(store, place, options.home);
 	if (notice !== null) options.out(notice);
 	const runDir = runDirOf(place, run.id);
-	const template = templateOf(workflow.nodes, node);
+	const template = instanceOf(workflow.nodes, node);
 	const plan = planNodeSession(workflow, node, {
 		cwd,
 		inputs: {},
@@ -924,7 +1005,7 @@ const createLogPrinter = (options) => {
 	return (stored) => {
 		const { event } = stored;
 		if (event.type === "run.started") width = Math.max(...event.nodes.map((n) => n.id.length), 1);
-		if (options.node !== void 0 && nodeOf(event) !== options.node) return [];
+		if (options.node !== void 0 && !isNodeEvent(event, options.node)) return [];
 		if (options.json) return [JSON.stringify(stored)];
 		return formatRunEvent(event, width, tools);
 	};
@@ -947,6 +1028,31 @@ const followRun = async (store, run, out, options) => {
 		...options.signal === void 0 ? {} : { signal: options.signal }
 	}) === "crashed") out(style("red", `run ${run.id} stopped without finishing (its process is gone)`));
 };
+// src/run/node-notes.ts
+/**
+* @file What a run of one node (`ork run --node`) leaves out, said before its
+*   session starts: the messages, steps and `forEach` it does not run. A node
+*   with `forEach` (RFC-013) runs once with no item when it has `items`, and is
+*   refused when it has `from`, as the node that reports its list is not run.
+*/
+/** A warning line, as the run prints it. */
+const noteLines = (lines) => lines.map((line) => `${style(["yellow", "bold"], "warning")} ${line}`);
+/** Why a node can't run alone, or what a run of it leaves out. */
+const oneNodeNotes = (workflow, id) => {
+	const node = workflow.nodes[id];
+	if (node === void 0) return { warnings: [] };
+	const each = "forEach" in node ? node.forEach : void 0;
+	if (each !== void 0 && "from" in each) return {
+		error: `\`${id}\` runs once for each item of ${each.from}, a list another node reports, and a run of one node does not run that node; run the whole workflow, or give it \`items\` of its own`,
+		warnings: []
+	};
+	const steps = [...beforeOf(node, workflow.defaults) === void 0 ? [] : ["before"], ..."verify" in node && node.verify !== void 0 ? ["verify"] : []];
+	return { warnings: [
+		..."notify" in node && node.notify ? [`${id}'s notify: does nothing here: a run of one node has no message bus.`] : [],
+		...each === void 0 ? [] : [`${id}'s forEach: does not fan out in a run of one node: it runs once, with no item.`],
+		...steps.map((step) => `${id}'s ${step}: does not run in a run of one node.`)
+	] };
+};
 // src/run/origin.ts
 /**
 * @file Where a run's feedback comes from, beyond what its events say: Ork's
@@ -987,6 +1093,8 @@ const runNode = async (options) => {
 	if (!pairs.ok) return failed([`--input: ${pairs.error}`]);
 	const inputs = resolveInputs(workflow, pairs.raw);
 	if (!inputs.ok) return failed(inputs.errors);
+	const notes = oneNodeNotes(workflow, options.nodeId);
+	if (notes.error !== void 0) return failed([notes.error]);
 	const limits = runLimits(options.store, place, options.home);
 	const refused = limitsRefusal(limits, workflow);
 	if (refused.length > 0) return failed(refused);
@@ -1017,11 +1125,7 @@ const runNode = async (options) => {
 	if (ready?.line !== void 0) options.err(ready.line);
 	const driver = named ?? ready?.driver;
 	if (driver === void 0) return failed(["No Claude driver is ready here."]);
-	const planned = workflow.nodes[options.nodeId];
-	if (planned !== void 0 && "notify" in planned && planned.notify) options.err(`${style(["yellow", "bold"], "warning")} ${options.nodeId}'s notify: does nothing here: a run of one node has no message bus.`);
-	const skipped = planned === void 0 ? [] : [...beforeOf(planned, workflow.defaults) === void 0 ? [] : ["before"], ..."verify" in planned && planned.verify !== void 0 ? ["verify"] : []];
-	for (const step of skipped) options.err(`${style(["yellow", "bold"], "warning")} ${options.nodeId}'s ${step}: does not run in a run of one node.`);
-	for (const warning of plan.warnings) options.err(`${style(["yellow", "bold"], "warning")} ${warning}`);
+	for (const line of noteLines([...notes.warnings, ...plan.warnings])) options.err(line);
 	const id = options.nodeId;
 	const recorder = createRecorder(options.store, {
 		id: runId,
@@ -1459,7 +1563,7 @@ const runWorkflowFile = async (options) => {
 	if (options.tools !== void 0) executorOptions.tools = options.tools;
 	const script = process.argv[1];
 	if (script !== void 0 && onPath(script)) executorOptions.orkBin = script;
-	const replay = options.resume === void 0 ? void 0 : createReplay(options.resume.history, options.resume.cutOff, options.resume.mail, options.resume.earlier);
+	const replay = options.resume === void 0 ? void 0 : createReplay(options.resume.history, options.resume.cutOff, options.resume.mail, options.resume.earlier, options.resume.fanOuts);
 	if (replay !== void 0) onEvent({
 		type: "run.resumed",
 		kept: replay.kept()
@@ -1530,7 +1634,7 @@ const flagValues = (rawArgs, flag) => {
 };
 const isDriver = (value) => CLAUDE_DRIVERS.some((d) => d.id === value);
 /** Loads the drivers only when a run starts, so other commands stay fast. */
-const loadRuntime = async (driver) => (await import("./src-5-sCA7cY.mjs")).createRuntime(driver, sessionEnv(process.env));
+const loadRuntime = async (driver) => (await import("./src-DhGLtYR-.mjs")).createRuntime(driver, sessionEnv(process.env));
 /**
 * Ctrl-C asks the run to stop, and so does a terminal closing or a polite kill,
 * so that the run ends tidily and leaves no result unscrubbed.
@@ -4117,8 +4221,9 @@ const tree = defineCommand({
 			return;
 		}
 		const { run } = found;
-		const events = store.events(run.id).map((s) => s.event);
-		const roots = runTree(events);
+		const stored = store.events(run.id);
+		const events = stored.map((s) => s.event);
+		const roots = nestItems(activeTree(stored));
 		if (args.json) {
 			write(JSON.stringify(roots, void 0, 2));
 			return;
@@ -4445,27 +4550,27 @@ const main = defineCommand({
 		ps,
 		logs,
 		tree,
-		usage: () => import("./usage-Bh1lVioA.mjs").then((module) => module.usage),
-		prune: () => import("./usage-Bh1lVioA.mjs").then((module) => module.prune),
+		usage: () => import("./usage-BuzDsEhq.mjs").then((module) => module.usage),
+		prune: () => import("./usage-BuzDsEhq.mjs").then((module) => module.prune),
 		decide,
-		relay: () => import("./relay-UgK1Cp9a.mjs").then((module) => module.relay),
-		pause: () => import("./pause-CBSAxtTp.mjs").then((module) => module.pause),
-		continue: () => import("./pause-CBSAxtTp.mjs").then((module) => module.continueRun),
+		relay: () => import("./relay-Cp8JGrdv.mjs").then((module) => module.relay),
+		pause: () => import("./pause-DhgKQORW.mjs").then((module) => module.pause),
+		continue: () => import("./pause-DhgKQORW.mjs").then((module) => module.continueRun),
 		stop,
 		chat,
-		send: () => import("./send-B39-Xeo7.mjs").then((module) => module.send),
+		send: () => import("./send-CHiYkM6X.mjs").then((module) => module.send),
 		resume,
 		feedback,
 		context,
-		worktrees: () => import("./worktrees-D4bVVKfY.mjs").then((module) => module.worktrees),
-		wt: () => import("./worktrees-D4bVVKfY.mjs").then((module) => module.worktrees),
-		watch: () => import("./watch-C_vcsn_g.mjs").then((module) => module.watch),
-		mcp: () => import("./mcp-qUwFT9yi.mjs").then((module) => module.mcp),
-		ui: () => import("./ui-DmJWLgxL.mjs").then((module) => module.ui),
+		worktrees: () => import("./worktrees-DBBcaimX.mjs").then((module) => module.worktrees),
+		wt: () => import("./worktrees-DBBcaimX.mjs").then((module) => module.worktrees),
+		watch: () => import("./watch-CCj0vU3B.mjs").then((module) => module.watch),
+		mcp: () => import("./mcp-BFl3cIDp.mjs").then((module) => module.mcp),
+		ui: () => import("./ui-BxE0L7V0.mjs").then((module) => module.ui),
 		doctor,
 		upgrade,
-		completion: () => import("./completion-BeS2NCgO.mjs").then((module) => module.completion),
-		__complete: () => import("./completion-BeS2NCgO.mjs").then((module) => module.completeCommand(main))
+		completion: () => import("./completion-CCn8xWmO.mjs").then((module) => module.completion),
+		__complete: () => import("./completion-CCn8xWmO.mjs").then((module) => module.completeCommand(main))
 	}
 });
 // src/bin.ts
@@ -4483,7 +4588,7 @@ const main = defineCommand({
 clearGitLocalEnv();
 const argv = process.argv.slice(2);
 if (argv[0] === "__complete") {
-	const { printCompletions } = await import("./completion-BeS2NCgO.mjs");
+	const { printCompletions } = await import("./completion-CCn8xWmO.mjs");
 	await printCompletions(main, argv.slice(1));
 } else if (process.env["ORK_UPDATE_CHECK_CHILD"] === "1") await runUpdateChild();
 else {

package/dist/{clean-BbrkMQQi.mjs → clean-BPITM-6p.mjs}

@@ -1,4 +1,4 @@
-import { A as gitOk, O as removeWorktree } from "./src-DG4dyBqm.mjs";
+import { A as gitOk, O as removeWorktree } from "./src-BsLHKQRc.mjs";
 // ../core/src/worktree/clean.ts
 /**
 * @file What `ork worktrees clean` and `ork worktrees remove` do with what

package/dist/{completion-BeS2NCgO.mjs → completion-CCn8xWmO.mjs}

@@ -1,9 +1,9 @@
-import { Cn as placeFiles, cr as CLAUDE_DRIVERS, ht as liveStatus, tr as NodeIdSchema, wn as placeFor } from "./src-DG4dyBqm.mjs";
-import { a as builtinWorkflowNames, n as pendingDecisions, o as builtinWorkflowText, s as isBuiltinArg } from "./decide-Cnt7o3ya.mjs";
-import { t as findRun } from "./find-Dy2H5IvT.mjs";
-import { c as openStore, l as storePath, o as writeErr } from "./output-CjOPL8W0.mjs";
+import { Cn as placeFiles, bt as liveStatus, cr as CLAUDE_DRIVERS, tr as NodeIdSchema, wn as placeFor } from "./src-BsLHKQRc.mjs";
+import { a as builtinWorkflowNames, n as pendingDecisions, o as builtinWorkflowText, s as isBuiltinArg } from "./decide-DsA6kOT7.mjs";
+import { t as findRun } from "./find-ntyniv2E.mjs";
+import { c as openStore, l as storePath, o as writeErr } from "./output-CwqlG1Le.mjs";
 import { a as findEntry, c as subcommandsOf, d as SHELL_SCRIPTS, l as COMPLETE_COMMAND, n as groupedEntries, r as argInfoOf, t as groupOf, u as SHELLS } from "./help-groups-BwYoAWsh.mjs";
-import { a as resolveWorkflowArg, n as WORKFLOW_SUFFIX } from "./workflows-lpexsAYt.mjs";
+import { a as resolveWorkflowArg, n as WORKFLOW_SUFFIX } from "./workflows-BNCDD6J-.mjs";
 import path from "node:path";
 import { parse } from "yaml";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";

package/dist/{context-CHV6aTs7.mjs → context-CZNM454F.mjs}

@@ -1,6 +1,6 @@
-import { C as workflowTextHash, Cn as placeFiles, Ct as walkChecks, On as workflowDirOf, S as readProjectTriggers, St as checkWorkflowText, jn as LESSON_CAP_TOKENS, lt as explainSession, wn as placeFor, wt as walkSummary } from "./src-DG4dyBqm.mjs";
-import { a as write, i as style, r as plain } from "./output-CjOPL8W0.mjs";
-import { c as registeredProjects, i as refusedBuiltin, o as workflowArg, r as findWorkflowFiles, s as projectAt } from "./workflows-lpexsAYt.mjs";
+import { C as workflowTextHash, Cn as placeFiles, On as workflowDirOf, S as readProjectTriggers, ht as walkSummary, jn as LESSON_CAP_TOKENS, mt as walkChecks, pt as checkWorkflowText, st as explainSession, wn as placeFor } from "./src-BsLHKQRc.mjs";
+import { a as write, i as style, r as plain } from "./output-CwqlG1Le.mjs";
+import { c as registeredProjects, i as refusedBuiltin, o as workflowArg, r as findWorkflowFiles, s as projectAt } from "./workflows-BNCDD6J-.mjs";
 import path from "node:path";
 import { readFileSync } from "node:fs";
 import { defineCommand } from "citty";

package/dist/{decide-Cnt7o3ya.mjs → decide-DsA6kOT7.mjs}

@@ -1,4 +1,4 @@
-import { Cn as placeFiles, Fn as writePlainFile, Nn as guardedBase, Pn as plainPathInside, ht as liveStatus, in as socketPath, on as wakeRun } from "./src-DG4dyBqm.mjs";
+import { Cn as placeFiles, Fn as writePlainFile, Nn as guardedBase, Pn as plainPathInside, bt as liveStatus, in as socketPath, on as wakeRun } from "./src-BsLHKQRc.mjs";
 import path from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/{find-Dy2H5IvT.mjs → find-ntyniv2E.mjs}

@@ -1,4 +1,4 @@
-import { wn as placeFor } from "./src-DG4dyBqm.mjs";
+import { wn as placeFor } from "./src-BsLHKQRc.mjs";
 import { randomUUID } from "node:crypto";
 // ../core/src/remote/find.ts
 /**

package/dist/{format-OL0E1AjA.mjs → format-DaROJUgG.mjs}

@@ -1,5 +1,5 @@
-import { cn as maskSecrets, ht as liveStatus } from "./src-DG4dyBqm.mjs";
-import { i as style, n as cost } from "./output-CjOPL8W0.mjs";
+import { bt as liveStatus, cn as maskSecrets } from "./src-BsLHKQRc.mjs";
+import { i as style, n as cost } from "./output-CwqlG1Le.mjs";
 import { createInterface } from "node:readline/promises";
 // ../core/src/control/queue.ts
 const PERMISSION_OPTIONS = [{
@@ -436,6 +436,7 @@ const nodeVerdict = (output) => {
 	if (typeof count === "number") return `${String(count)} ran`;
 	return "done";
 };
+const items = (count) => `${String(count)} ${count === 1 ? "item" : "items"}`;
 /** Transcript lines for one run event, prefixed with the node they are from. */
 const formatRunEvent = (event, width, tools) => {
 	const tag = (id) => style("cyan", `${id.padEnd(width)} │`);
@@ -492,6 +493,14 @@ const formatRunEvent = (event, width, tools) => {
 		return [`${tag(event.id)} ${style("yellow", `‖ paused: ${at}`)}`];
 	}
 	if (event.type === "node.released") return [`${tag(event.id)} ${style("dim", "▸ continues")}`];
+	if (event.type === "each.listed") {
+		const round = event.round > 1 ? ` (round ${String(event.round)})` : "";
+		return [`${tag(event.node)} ${style("dim", `${items(event.count)}${round}`)}`];
+	}
+	if (event.type === "each.exceeded") {
+		const over = `${items(event.count)}, over maxItems ${String(event.maxItems)}`;
+		return [`${tag(event.node)} ${style("yellow", `! ${over}`)}`];
+	}
 	if (event.type === "run.finished") return formatRunResult(event.result);
 	if (event.type === "run.resumed") {
 		const [one] = event.kept;
@@ -608,8 +617,27 @@ const stateText = (node) => {
 	}
 	return node.state;
 };
+const isItem = (node) => node.template !== void 0 && /\.\d+$/u.test(node.id);
+/**
+* Moves each item of a node with `forEach` (`build.2`) under its node, in list
+* order, from beside it or under its owner, where the events put it.
+*/
+const nestItems = (roots) => {
+	const all = [];
+	const collect = (node) => {
+		all.push(node);
+		for (const child of node.children) collect(child);
+	};
+	for (const root of roots) collect(root);
+	const items = all.filter((node) => isItem(node));
+	const home = new Map(all.map((node) => [node.id, node]));
+	const isMoved = (node) => items.includes(node) && home.has(node.template ?? "");
+	for (const node of all) node.children = node.children.filter((c) => !isMoved(c));
+	for (const item of items) home.get(item.template ?? "")?.children.push(item);
+	return roots.filter((root) => !isMoved(root));
+};
 /** The ownership tree, one line per node, children under their owner. */
-const formatTree = (roots) => {
+const formatTree = (roots, now = Date.now()) => {
 	const lines = [];
 	const walk = (node, lead, branch) => {
 		lines.push({
@@ -627,7 +655,8 @@ const formatTree = (roots) => {
 	return lines.map(({ label: text, node }) => {
 		const usage = node.inputTokens + node.outputTokens === 0 ? "" : style("dim", `  ${count(node.inputTokens)} in / ${count(node.outputTokens)} out · ${cost(node.costUsd)}`);
 		const state = node.held === true ? `${style("yellow", "‖")} paused` : `${STATE_MARK[node.state]} ${stateText(node)}`;
-		return `${text.padEnd(label)}  ${style("dim", node.type.padEnd(type))}  ${state}${usage}`;
+		const spent = isItem(node) && node.startedAt !== void 0 ? style("dim", `  ${duration((node.finishedAt === void 0 ? now : Date.parse(node.finishedAt)) - Date.parse(node.startedAt))}`) : "";
+		return `${text.padEnd(label)}  ${style("dim", node.type.padEnd(type))}  ${state}${spent}${usage}`;
 	});
 };
-export { formatRunEvent as a, formatEvent as i, formatRuns as n, createTerminalHuman as o, formatTree as r, createDecisionQueue as s, ago as t };
+export { formatEvent as a, createDecisionQueue as c, nestItems as i, formatRuns as n, formatRunEvent as o, formatTree as r, createTerminalHuman as s, ago as t };

package/dist/{in-a-run-emTc-kZI.mjs → in-a-run-D_fnj1Mw.mjs}

@@ -1,4 +1,4 @@
-import { p as runMarkerIn } from "./src-8nec4uoe.mjs";
+import { p as runMarkerIn } from "./src-CUeMUVwW.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/{limits-TxTnWxix.mjs → limits-BKzVMwkt.mjs}

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

package/dist/{list-P5CfcoWx.mjs → list-D9HPWLPH.mjs}

@@ -1,4 +1,4 @@
-import { A as gitOk, j as lines, k as git } from "./src-DG4dyBqm.mjs";
+import { A as gitOk, j as lines, k as git } from "./src-BsLHKQRc.mjs";
 import { existsSync } from "node:fs";
 // ../core/src/worktree/list.ts
 /**

package/dist/{mcp-qUwFT9yi.mjs → mcp-BFl3cIDp.mjs}

@@ -1,8 +1,8 @@
-import { h as isNewer } from "./src-DG4dyBqm.mjs";
-import { n as ORK_VERSION } from "./__build_info__-CxH89h1r.mjs";
-import { a as openMcp, c as refused, o as tool, s as answer } from "./src-jyCJE1kd.mjs";
-import { p as runMarkerIn } from "./src-8nec4uoe.mjs";
-import { n as explainNode } from "./context-CHV6aTs7.mjs";
+import { h as isNewer } from "./src-BsLHKQRc.mjs";
+import { n as ORK_VERSION } from "./__build_info__-BGoaUwLd.mjs";
+import { p as runMarkerIn } from "./src-CUeMUVwW.mjs";
+import { n as explainNode } from "./context-CZNM454F.mjs";
+import { a as openMcp, c as refused, o as tool, s as answer } from "./src-BwnitlJh.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.6") ? tooOld(all, options.expects) : all;
+	const tools = options.expects !== void 0 && isNewer(options.expects, "1.0.0-alpha.7") ? tooOld(all, options.expects) : all;
 	const server = new McpServer({
 		name: "ork",
 		version: ORK_VERSION

package/dist/{output-CjOPL8W0.mjs → output-CwqlG1Le.mjs}

@@ -1,4 +1,4 @@
-import { $ as text, Ht as FEEDBACK_SEVERITIES, Q as inTransaction, Ut as FEEDBACK_TARGETS, Vt as FEEDBACK_KINDS, X as usageQueries, Y as backfillUsage, Z as eventOf, cn as maskSecrets, sn as maskReplacer, yn as PROJECT_MODES, yt as ownProcessStart } from "./src-DG4dyBqm.mjs";
+import { Ht as FEEDBACK_SEVERITIES, J as backfillUsage, Q as text, Tt as ownProcessStart, Ut as FEEDBACK_TARGETS, Vt as FEEDBACK_KINDS, X as eventOf, Y as usageQueries, Z as inTransaction, cn as maskSecrets, sn as maskReplacer, yn as PROJECT_MODES } from "./src-BsLHKQRc.mjs";
 import path from "node:path";
 import { mkdirSync } from "node:fs";
 import { homedir } from "node:os";
@@ -809,6 +809,15 @@ const nodeOf = (event) => {
 	if ("node" in event && typeof event.node === "string") return event.node;
 	return null;
 };
+/**
+* Whether an event is about `node`, or about one of its items when it has
+* `forEach` (`build` matches `build.2`; an item's id has a `.`, a declared
+* node's never does).
+*/
+const isNodeEvent = (event, node) => {
+	const id = nodeOf(event);
+	return id === node || id !== null && id.startsWith(`${node}.`);
+};
 /** A database opened for reading only, refused unless it is current. */
 const openReadOnly = (file) => {
 	const db = new DatabaseSync(file, { readOnly: true });
@@ -950,4 +959,4 @@ const confirm = async (question) => {
 		rl.close();
 	}
 };
-export { write as a, openStore as c, style as i, storePath as l, cost as n, writeErr as o, plain as r, nodeOf as s, confirm as t };
+export { write as a, openStore as c, style as i, storePath as l, cost as n, writeErr as o, plain as r, isNodeEvent as s, confirm as t };

package/dist/{pause-CBSAxtTp.mjs → pause-DhgKQORW.mjs}

@@ -1,7 +1,7 @@
-import { G as requestContinue, K as requestPause } from "./src-DG4dyBqm.mjs";
-import { t as findRun } from "./find-Dy2H5IvT.mjs";
-import { a as write, c as openStore, i as style, o as writeErr } from "./output-CjOPL8W0.mjs";
-import { r as continueRefusal } from "./in-a-run-emTc-kZI.mjs";
+import { G as requestPause, W as requestContinue } from "./src-BsLHKQRc.mjs";
+import { t as findRun } from "./find-ntyniv2E.mjs";
+import { a as write, c as openStore, i as style, o as writeErr } from "./output-CwqlG1Le.mjs";
+import { r as continueRefusal } from "./in-a-run-D_fnj1Mw.mjs";
 import { defineCommand } from "citty";
 // src/commands/pause.ts
 /**

package/dist/{relay-UgK1Cp9a.mjs → relay-Cp8JGrdv.mjs}

@@ -1,5 +1,5 @@
-import { B as linkNodes, L as addressOf, U as unlinkNodes } from "./src-DG4dyBqm.mjs";
-import { a as write, c as openStore, i as style, o as writeErr } from "./output-CjOPL8W0.mjs";
+import { H as unlinkNodes, I as addressOf, z as linkNodes } from "./src-BsLHKQRc.mjs";
+import { a as write, c as openStore, i as style, o as writeErr } from "./output-CwqlG1Le.mjs";
 import { defineCommand } from "citty";
 // src/commands/relay.ts
 /**

package/dist/{remove-ccycC3vI.mjs → remove-CSpT_nJH.mjs}

@@ -1,6 +1,6 @@
-import { ht as liveStatus, j as lines, k as git } from "./src-DG4dyBqm.mjs";
-import { n as listOrkWorktrees, t as createdWorktrees } from "./list-P5CfcoWx.mjs";
-import { i as keyOf, n as applyStep, r as cleanStep, s as stepPrunes } from "./clean-BbrkMQQi.mjs";
+import { bt as liveStatus, j as lines, k as git } from "./src-BsLHKQRc.mjs";
+import { n as listOrkWorktrees, t as createdWorktrees } from "./list-D9HPWLPH.mjs";
+import { i as keyOf, n as applyStep, r as cleanStep, s as stepPrunes } from "./clean-BPITM-6p.mjs";
 // ../core/src/worktree/words.ts
 /**
 * @file The plain words for what `ork worktrees` shows, in one place, so the

package/dist/{send-B39-Xeo7.mjs → send-CHiYkM6X.mjs}

@@ -1,6 +1,6 @@
-import { ht as liveStatus, in as socketPath, kt as scriptContactsOf, on as wakeRun } from "./src-DG4dyBqm.mjs";
-import { c as openStore, o as writeErr } from "./output-CjOPL8W0.mjs";
-import { u as inheritedScrubber } from "./src-8nec4uoe.mjs";
+import { bt as liveStatus, in as socketPath, kt as scriptContactsOf, on as wakeRun } from "./src-BsLHKQRc.mjs";
+import { c as openStore, o as writeErr } from "./output-CwqlG1Le.mjs";
+import { u as inheritedScrubber } from "./src-CUeMUVwW.mjs";
 import { defineCommand } from "citty";
 // ../core/src/remote/send.ts
 /**