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

package/dist/{decide-CoIJh34e.mjs → decide-3l9q8UtX.mjs}

@@ -1,4 +1,4 @@
-import { An as guardedBase, Mn as writePlainFile, an as wakeRun, bn as placeFiles, ht as liveStatus, jn as plainPathInside, rn as socketPath } from "./src-hrj2h0IZ.mjs";
+import { Fn as plainPathInside, In as writePlainFile, Pn as guardedBase, an as socketPath, bt as liveStatus, sn as wakeRun, wn as placeFiles } from "./src-Df6KOIDC.mjs";
 import path from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";
@@ -69,7 +69,7 @@ const builtinWorkflowFile = (place, arg) => {
 *   An answer goes to the store (the first one wins), then the run is woken on
 *   its socket so it picks the answer up at once (specs/messaging.md).
 */
-/** Open decisions whose run is still live, oldest first. */
+/** Open decisions whose run is still live, oldest first, ANDing the filter. */
 const pendingDecisions = (store, filter) => {
 	const live = /* @__PURE__ */ new Map();
 	return store.decisions({
@@ -78,7 +78,7 @@ const pendingDecisions = (store, filter) => {
 	}).filter((decision) => {
 		if (!live.has(decision.runId)) {
 			const [run] = store.lookup(decision.runId);
-			live.set(decision.runId, run !== void 0 && liveStatus(run) === "running");
+			live.set(decision.runId, run !== void 0 && liveStatus(run) === "running" && (filter.workflow === void 0 || run.workflow === filter.workflow));
 		}
 		return live.get(decision.runId) === true;
 	});

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

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

package/dist/format-Cb5_m-Qd.mjs

@@ -0,0 +1,191 @@
+import { Dt as isItem, bt as liveStatus } from "./src-Df6KOIDC.mjs";
+import { i as style, n as cost } from "./output-Bqljtmp_.mjs";
+// src/run/format-bus.ts
+/** The first line of a message body, cut to fit one terminal line. */
+const firstLine = (body) => {
+	const [line = ""] = body.trim().split("\n");
+	return line.length > 100 ? `${line.slice(0, 99)}…` : line;
+};
+/** Messages, owner questions and claims, without the node prefix. */
+const formatBusEvent = (event) => {
+	if (event.type === "claim.taken") return [style("dim", `⚑ claimed ${event.resource}`)];
+	if (event.type === "claim.refused") {
+		const held = event.held === event.resource ? "" : ` (it holds ${event.held})`;
+		return [style("yellow", `⚑ ${event.resource} is ${event.holder}'s${held}`)];
+	}
+	if (event.type === "claim.released") return [style("dim", `⚑ released ${event.resource}`)];
+	if (event.type === "message.sent") {
+		const how = event.via === void 0 ? "" : ` (${event.via})`;
+		return [style("dim", `✉ to ${event.to}${how}: ${firstLine(event.body)}`)];
+	}
+	if (event.type === "message.received") {
+		const how = event.via === void 0 ? "" : ` (${event.via})`;
+		return [style("dim", `✉ from ${event.from}${how}: ${firstLine(event.body)}`)];
+	}
+	if (event.type === "call.started") return [style("dim", `↳ started ${event.workflow} as run ${event.run}`)];
+	if (event.type === "link.notice") return [style("dim", `↔ ${event.text}`)];
+	if (event.type === "message.read") return [];
+	if (event.type === "owner.asked") return [`${style(["yellow", "bold"], "?")} asked as the owner of ${event.about}: ${event.text} ${style("dim", `(${event.question})`)}`];
+	if (event.type === "owner.answered") return [style("dim", `→ ${event.answer} (owner)`)];
+	return [style("dim", "→ its session ended first; asking you")];
+};
+// src/run/items-ran.ts
+/**
+* @file How a fan-out's finished line counts its items: only the ones that
+*   started.
+*/
+/** How many of a fan-out's items started; a skipped one never did. */
+const itemsRan = (count, statuses) => {
+	const ran = Array.isArray(statuses) ? statuses.filter((status) => status !== "skipped").length : count;
+	return ran === count ? `${String(count)} ran` : `${String(ran)} of ${String(count)} ran`;
+};
+// src/run/verdict.ts
+/**
+* @file The one-line verdict of a finished node: its report's status, unless
+*   the node failed or its work did not merge.
+*/
+/** Whether a finished node's work did not merge into its owner. */
+const hasConflict = (output) => {
+	const { merge } = output;
+	return typeof merge === "object" && merge !== null && "ok" in merge && merge.ok === false;
+};
+/**
+* A one-line verdict for a finished node, by what its type outputs. A node that
+* failed reads `fail` even when its report said `pass` (a hook refused its
+* commit); a child that did not merge says so.
+*/
+const nodeVerdict = (output, ok = true, error) => {
+	const { status, summary, exitCode, choice, answeredBy, count } = output;
+	if (typeof status === "string") {
+		if (!ok && (status === "pass" || status === "done")) return error === void 0 ? "fail" : `fail: ${firstLine(error)}`;
+		const label = hasConflict(output) ? `${status}, merge conflict` : status;
+		return typeof summary === "string" && summary !== "" ? `${label}: ${summary}` : label;
+	}
+	if (typeof exitCode === "number") return `exit ${String(exitCode)}`;
+	if (typeof choice === "string") return `${choice} (${String(answeredBy)})`;
+	if (typeof count === "number") return itemsRan(count, output["statuses"]);
+	return "done";
+};
+// src/runs/format.ts
+/**
+* @file How stored runs read on the terminal: the `ork ps` table and the `ork
+*   tree` ownership tree with each node's state, tokens and cost, and what is
+*   paused (ADR-041).
+*/
+const STATUS_STYLE = {
+	running: "cyan",
+	paused: "yellow",
+	succeeded: "green",
+	failed: "red",
+	crashed: "red",
+	budget_exhausted: "yellow",
+	quota_exhausted: "yellow",
+	timed_out: "yellow",
+	interrupted: "yellow"
+};
+/** `just now`, `5m ago`, `3h ago`, `2d ago`, then the date. */
+const ago = (iso, now = Date.now()) => {
+	const minutes = Math.floor((now - Date.parse(iso)) / 6e4);
+	if (minutes < 1) return "just now";
+	if (minutes < 60) return `${String(minutes)}m ago`;
+	if (minutes < 1440) return `${String(Math.floor(minutes / 60))}h ago`;
+	if (minutes < 10080) return `${String(Math.floor(minutes / 1440))}d ago`;
+	return iso.slice(0, 10);
+};
+/** `42s`, `3m12s`, `1h05m`. */
+const duration = (ms) => {
+	const s = Math.max(0, Math.round(ms / 1e3));
+	if (s < 60) return `${String(s)}s`;
+	if (s < 3600) return `${String(Math.floor(s / 60))}m${String(s % 60).padStart(2, "0")}s`;
+	return `${String(Math.floor(s / 3600))}h${String(Math.floor(s % 3600 / 60)).padStart(2, "0")}m`;
+};
+/**
+* The `ork ps` table; `withProject` adds each run's project. A called run's
+* cost is dimmed and says its caller's, whose cost already counts it.
+*/
+const formatRuns = (runs, withProject, now = Date.now(), statusOf = liveStatus) => {
+	if (runs.length === 0) return ["No runs."];
+	const rows = runs.map((run) => {
+		const status = statusOf(run);
+		const end = run.finishedAt === void 0 ? now : Date.parse(run.finishedAt);
+		return {
+			id: run.id,
+			workflow: run.workflow,
+			status,
+			when: `${ago(run.startedAt, now)} · ${duration(end - Date.parse(run.startedAt))}`,
+			cost: run.parent === void 0 ? cost(run.costUsd) : `${cost(run.costUsd)} in ${run.parent}`,
+			called: run.parent !== void 0,
+			project: run.project
+		};
+	});
+	const width = (pick, title) => Math.max(title.length, ...rows.map((r) => pick(r).length));
+	const w = {
+		id: width((r) => r.id, "RUN"),
+		workflow: width((r) => r.workflow, "WORKFLOW"),
+		status: width((r) => r.status, "STATUS"),
+		when: width((r) => r.when, "STARTED"),
+		cost: width((r) => r.cost, "COST")
+	};
+	const header = [
+		"RUN".padEnd(w.id),
+		"WORKFLOW".padEnd(w.workflow),
+		"STATUS".padEnd(w.status),
+		"STARTED".padEnd(w.when),
+		"COST".padStart(w.cost),
+		...withProject ? ["PROJECT"] : []
+	].join("  ");
+	return [style("dim", header), ...rows.map((r) => [
+		style("bold", r.id.padEnd(w.id)),
+		r.workflow.padEnd(w.workflow),
+		style(STATUS_STYLE[r.status] ?? "reset", r.status.padEnd(w.status)),
+		style("dim", r.when.padEnd(w.when)),
+		r.called ? style("dim", r.cost.padStart(w.cost)) : r.cost.padStart(w.cost),
+		...withProject ? [style("dim", r.project)] : []
+	].join("  "))];
+};
+const STATE_MARK = {
+	waiting: style("dim", "·"),
+	running: style("cyan", "●"),
+	ok: style("green", "✓"),
+	failed: style("red", "✗"),
+	skipped: style("dim", "-")
+};
+/** `950`, `12.3k`, `1.2M`. */
+const count = (n) => {
+	if (n < 1e3) return String(n);
+	if (n < 1e6) return `${(n / 1e3).toFixed(1)}k`;
+	return `${(n / 1e6).toFixed(1)}M`;
+};
+const stateText = (node) => {
+	if (node.state === "running") return node.runs > 1 ? `running (round ${String(node.runs)})` : "running";
+	if (node.state === "ok" || node.state === "failed") {
+		const verdict = nodeVerdict(node.output ?? {}, node.state === "ok");
+		const line = verdict.length > 60 ? `${verdict.slice(0, 59)}…` : verdict;
+		return node.runs > 1 ? `${line} (${String(node.runs)} runs)` : line;
+	}
+	return node.state;
+};
+/** The ownership tree, one line per node, children under their owner. */
+const formatTree = (roots, now = Date.now()) => {
+	const lines = [];
+	const walk = (node, lead, branch) => {
+		lines.push({
+			label: `${lead}${branch}${node.id}`,
+			node
+		});
+		const next = lead + (branch === "├─ " ? "│  " : branch === "" ? "" : "   ");
+		node.children.forEach((child, index) => {
+			walk(child, next, index === node.children.length - 1 ? "└─ " : "├─ ");
+		});
+	};
+	for (const root of roots) walk(root, "", "");
+	const label = Math.max(...lines.map((l) => l.label.length));
+	const type = Math.max(...lines.map((l) => l.node.type.length));
+	return lines.map(({ label: text, node }) => {
+		const usage = node.inputTokens + node.outputTokens === 0 ? "" : style("dim", `  ${count(node.inputTokens)} in / ${count(node.outputTokens)} out · ${cost(node.costUsd)}`);
+		const state = node.held === true ? `${style("yellow", "‖")} paused` : `${STATE_MARK[node.state]} ${stateText(node)}`;
+		const spent = isItem(node) && node.startedAt !== void 0 ? style("dim", `  ${duration((node.finishedAt === void 0 ? now : Date.parse(node.finishedAt)) - Date.parse(node.startedAt))}`) : "";
+		return `${text.padEnd(label)}  ${style("dim", node.type.padEnd(type))}  ${state}${spent}${usage}`;
+	});
+};
+export { nodeVerdict as a, hasConflict as i, formatRuns as n, firstLine as o, formatTree as r, formatBusEvent as s, ago as t };

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

@@ -1,4 +1,4 @@
-import { p as runMarkerIn } from "./src-BxUJPGa5.mjs";
+import { p as runMarkerIn } from "./src-cmmXKHn1.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-BPM9wUlV.mjs → limits-BSwEjQST.mjs}

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

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

@@ -1,4 +1,4 @@
-import { A as gitOk, j as lines, k as git } from "./src-hrj2h0IZ.mjs";
+import { M as git, N as gitOk, P as lines } from "./src-Df6KOIDC.mjs";
 import { existsSync } from "node:fs";
 // ../core/src/worktree/list.ts
 /**
@@ -56,7 +56,7 @@ const onNoBranch = async (entry) => entry === void 0 ? "0" : (await git(entry.pa
 	"--remotes"
 ])).stdout;
 /** One created worktree or branch, with its state read from git. */
-const stateOf = async (root, entries, item) => {
+const stateOf = async (root, entries, item, recorded) => {
 	const { branch } = item;
 	const entry = branch === void 0 || item.path !== "" ? entries.find((e) => e.path === item.path) : entries.find((e) => e.branch === branch);
 	const holder = branch === void 0 ? void 0 : entries.find((e) => e.branch === branch && e.path !== entry?.path);
@@ -76,6 +76,7 @@ const stateOf = async (root, entries, item) => {
 		...checkedOut === void 0 ? {} : { checkedOut },
 		runId: item.runId,
 		nodeId: item.nodeId,
+		recorded,
 		path: entry?.path ?? null,
 		missing,
 		dirty: changes > 0,
@@ -104,7 +105,13 @@ const listOrkWorktrees = async (root, created = []) => {
 		"refs/heads/"
 	]));
 	const recordedBranches = new Set(created.flatMap((c) => c.branch ?? []));
-	const items = [...created.filter((c) => c.branch === void 0 ? entries.some((e) => e.path === c.path) : branches.includes(c.branch)), ...branches.filter((b) => b.startsWith("ork/") && !recordedBranches.has(b)).map((b) => prefixed(b))];
-	return Promise.all(items.map((item) => stateOf(root, entries, item)));
+	const items = [...created.filter((c) => c.branch === void 0 ? entries.some((e) => e.path === c.path) : branches.includes(c.branch)).map((item) => ({
+		item,
+		recorded: true
+	})), ...branches.filter((b) => b.startsWith("ork/") && !recordedBranches.has(b)).map((b) => ({
+		item: prefixed(b),
+		recorded: false
+	}))];
+	return Promise.all(items.map(({ item, recorded }) => stateOf(root, entries, item, recorded)));
 };
 export { listOrkWorktrees as n, createdWorktrees as t };

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

@@ -1,8 +1,8 @@
-import { h as isNewer } from "./src-hrj2h0IZ.mjs";
-import { n as ORK_VERSION } from "./__build_info__-D9lSlMFy.mjs";
-import { a as openMcp, c as refused, o as tool, s as answer } from "./src-B0TT7DBi.mjs";
-import { n as explainNode } from "./context-6x3kXREO.mjs";
-import { p as runMarkerIn } from "./src-BxUJPGa5.mjs";
+import { h as isNewer } from "./src-Df6KOIDC.mjs";
+import { n as ORK_VERSION } from "./__build_info__-DFF18K8y.mjs";
+import { p as runMarkerIn } from "./src-cmmXKHn1.mjs";
+import { n as explainNode } from "./context-CEaKOVmG.mjs";
+import { a as openMcp, c as refused, o as tool, s as answer } from "./src-i5k2Y-kf.mjs";
 import { 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.1") ? tooOld(all, options.expects) : all;
+	const tools = options.expects !== void 0 && isNewer(options.expects, "1.0.0-alpha.10") ? tooOld(all, options.expects) : all;
 	const server = new McpServer({
 		name: "ork",
 		version: ORK_VERSION

package/dist/output-Bqljtmp_.mjs

@@ -0,0 +1,40 @@
+import { createInterface } from "node:readline/promises";
+import { stripVTControlCharacters, styleText } from "node:util";
+// src/output.ts
+/**
+* @file Terminal output helpers: styled text that turns plain when stdout is
+*   not a TTY or `NO_COLOR` is set, and a yes-or-no question on the terminal.
+*/
+/** Styles text for stdout; plain when stdout is not a TTY or NO_COLOR is set. */
+const style = (format, text) => styleText(format, text, { stream: process.stdout });
+/**
+* Text from outside, fit for a terminal: escape sequences could hide a line on
+* the very screen a person judges from, and a line break could forge one.
+*/
+const plain = (text) => stripVTControlCharacters(text).replaceAll(/[\p{Cc}\p{Bidi_Control}]/gu, " ");
+const write = (text) => {
+	process.stdout.write(`${text}\n`);
+};
+const writeErr = (text) => {
+	process.stderr.write(`${text}\n`);
+};
+/** What a run spent: `$0.0312`, or `$0.00` for nothing. */
+const cost = (usd) => usd === 0 ? "$0.00" : `$${usd.toFixed(4)}`;
+/** Asks a yes-or-no question on the terminal; anything but yes is no. */
+const confirm = async (question) => {
+	const rl = createInterface({
+		input: process.stdin,
+		output: process.stderr
+	});
+	const { promise: ended, resolve: end } = Promise.withResolvers();
+	rl.once("close", () => {
+		end("");
+	});
+	try {
+		const answer = await Promise.race([rl.question(question), ended]);
+		return ["y", "yes"].includes(answer.trim().toLowerCase());
+	} finally {
+		rl.close();
+	}
+};
+export { write as a, style as i, cost as n, writeErr as o, plain as r, confirm as t };

package/dist/{pause-C7lJkSma.mjs → pause-D7OVB5Ac.mjs}

@@ -1,7 +1,7 @@
-import { G as requestContinue, K as requestPause } from "./src-hrj2h0IZ.mjs";
-import { t as findRun } from "./find-rBBk7Jui.mjs";
-import { a as write, c as openStore, i as style, o as writeErr } from "./output-TV_j7Ni0.mjs";
-import { r as continueRefusal } from "./in-a-run-DdAakpRR.mjs";
+import { D as openStore, X as requestPause, Y as requestContinue } from "./src-Df6KOIDC.mjs";
+import { t as findRun } from "./find-DEjjOlTG.mjs";
+import { a as write, i as style, o as writeErr } from "./output-Bqljtmp_.mjs";
+import { r as continueRefusal } from "./in-a-run-BS9Nc-JW.mjs";
 import { defineCommand } from "citty";
 // src/commands/pause.ts
 /**

package/dist/{relay-BipJYszF.mjs → relay-EceRIebO.mjs}

@@ -1,5 +1,5 @@
-import { B as linkNodes, L as addressOf, U as unlinkNodes } from "./src-hrj2h0IZ.mjs";
-import { a as write, c as openStore, i as style, o as writeErr } from "./output-TV_j7Ni0.mjs";
+import { D as openStore, V as addressOf, W as linkNodes, q as unlinkNodes } from "./src-Df6KOIDC.mjs";
+import { a as write, i as style, o as writeErr } from "./output-Bqljtmp_.mjs";
 import { defineCommand } from "citty";
 // src/commands/relay.ts
 /**

package/dist/{remove-BDs9isB6.mjs → remove-0IQZVWmI.mjs}

@@ -1,6 +1,6 @@
-import { ht as liveStatus, j as lines, k as git } from "./src-hrj2h0IZ.mjs";
-import { n as listOrkWorktrees, t as createdWorktrees } from "./list-Bv5Lxu7z.mjs";
-import { i as keyOf, n as applyStep, r as cleanStep, s as stepPrunes } from "./clean-CA_Oi2Wl.mjs";
+import { M as git, P as lines, bt as liveStatus } from "./src-Df6KOIDC.mjs";
+import { n as listOrkWorktrees, t as createdWorktrees } from "./list-Qxr6rwsY.mjs";
+import { i as keyOf, n as applyStep, r as cleanStep, s as stepPrunes } from "./clean-DVaEH9e7.mjs";
 // ../core/src/worktree/words.ts
 /**
 * @file The plain words for what `ork worktrees` shows, in one place, so the
@@ -45,6 +45,7 @@ const stateParts = (item, into) => {
 		if (item.ahead > 0) part(`${counted(item.ahead, "commit")} on no branch`, true);
 		else if (item.path !== null && !item.missing) part("nothing committed");
 	}
+	if (!item.recorded) part("not created by Ork");
 	if (item.inMainCheckout) part("checked out in the main checkout");
 	if (item.heldBy !== void 0) part(`checked out in ${item.heldBy}`);
 	return parts;
@@ -67,11 +68,12 @@ const planLine = (step) => {
 	};
 };
 /**
-* Why an item can't be removed at all, even forced, if it can't: the main
-* checkout or a worktree Ork didn't create holds it, or its run is still
-* going.
+* Why an item can't be removed at all, even forced, if it can't: no run
+* recorded creating it, the main checkout or a worktree Ork didn't create holds
+* it, or its run is still going.
 */
 const removeRefusal = (item, live) => {
+	if (!item.recorded) return "not created by Ork (no run recorded it); delete it with git if it's yours to delete";
 	if (item.inMainCheckout) return "checked out in the main checkout; switch it to another branch first";
 	if (item.heldBy !== void 0) return `checked out in ${item.heldBy}, a worktree Ork didn't create; switch it to another branch first`;
 	return live ? `run ${item.runId} is still going; stop it first` : void 0;
@@ -101,6 +103,11 @@ const projectHead = async (root) => {
 		branch: answer.code === 0 ? answer.stdout.trim() : null
 	};
 };
+/** The top of the repository `cwd` is in, even one with no commit yet. */
+const repoRoot = async (cwd) => {
+	const top = await git(cwd, ["rev-parse", "--show-toplevel"]);
+	return top.code === 0 ? top.stdout.trim() : null;
+};
 /** What Ork created in the repo at `root`, from its runs' records and git. */
 const readWorktrees = async (store, root) => ({
 	items: await listOrkWorktrees(root, createdWorktrees(store, root)),
@@ -191,4 +198,4 @@ const applyRemove = async (root, { step, force }, done = []) => {
 	await applyStep(root, step, force, done);
 	return done;
 };
-export { readWorktrees as a, planLine as c, projectHead as i, removeRefusal as l, lostWork as n, labelOf as o, planRemove as r, mergeStateOf as s, applyRemove as t, stateParts as u };
+export { readWorktrees as a, mergeStateOf as c, stateParts as d, projectHead as i, planLine as l, lostWork as n, repoRoot as o, planRemove as r, labelOf as s, applyRemove as t, removeRefusal as u };

package/dist/{send-nbkjf3sc.mjs → send-C0uwfUYi.mjs}

@@ -1,6 +1,6 @@
-import { an as wakeRun, ht as liveStatus, kt as scriptContactsOf, rn as socketPath } from "./src-hrj2h0IZ.mjs";
-import { c as openStore, o as writeErr } from "./output-TV_j7Ni0.mjs";
-import { u as inheritedScrubber } from "./src-BxUJPGa5.mjs";
+import { At as scriptContactsOf, D as openStore, an as socketPath, bt as liveStatus, sn as wakeRun } from "./src-Df6KOIDC.mjs";
+import { o as writeErr } from "./output-Bqljtmp_.mjs";
+import { u as inheritedScrubber } from "./src-cmmXKHn1.mjs";
 import { defineCommand } from "citty";
 // ../core/src/remote/send.ts
 /**