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

package/dist/ui/index.html

@@ -19,7 +19,7 @@
       href="/favicon.svg"
       type="image/svg+xml"
     />
-    <script type="module" crossorigin src="/assets/index-D-_uPI2v.js"></script>
+    <script type="module" crossorigin src="/assets/index-CVzwYlz3.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/theme-CdXvqTQ6.js">
     <link rel="stylesheet" crossorigin href="/assets/index-BPIbqRRb.css">
   </head>

package/dist/{ui-CNO1M0qT.mjs → ui-DLrSt5ny.mjs}

@@ -1,7 +1,7 @@
-import { n as ORK_VERSION, t as ORK_NAME } from "./__build_info__-B82-dGJY.mjs";
+import { n as ORK_VERSION, t as ORK_NAME } from "./__build_info__-DcRdK0Du.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { o as mayShowSignIn } from "./in-a-run-cL5N9gpH.mjs";
-import { i as uiFilePath, l as newToken, n as startServer, r as runningServer, t as DEFAULT_PORT } from "./src-8Mul0695.mjs";
+import { o as mayShowSignIn } from "./in-a-run-a447hxq8.mjs";
+import { i as uiFilePath, l as newToken, n as startServer, r as runningServer, t as DEFAULT_PORT } from "./src-nXLIwDrt.mjs";
 import path from "node:path";
 import { constants } from "node:os";
 import { spawn } from "node:child_process";

package/dist/{usage-BVXi0iFY.mjs → usage-CxmpYYO4.mjs}

@@ -1,57 +1,11 @@
-import { At as usd, G as applyPrune, K as planPrune, S as usageReport, U as openStore, mr as placeFor, x as USAGE_DIMENSIONS } from "./src-tsuZRu0H.mjs";
+import { B as planPrune, L as openStore, Pr as placeFor, Ut as usageListTable, g as usageReport, h as USAGE_DIMENSIONS, z as applyPrune } from "./src-DN-RPsil.mjs";
+import { i as readListArgs, n as filterArgs, o as allAlias, r as projectScope, s as agoTime } from "./flags-CdgIH1L6.mjs";
 import { C as termOf, c as write, l as writeErr, n as cost, o as shortCount, r as costOf, s as style, t as confirm } from "./output-B1kwo0YU.mjs";
 import { n as chip, t as CHIP_LABELS } from "./chips-BqcT58qr.mjs";
-import { n as limitsHere } from "./limits-Dhe--wmX.mjs";
-import { a as header, o as table } from "./format-CvTE5CZQ.mjs";
+import { n as limitsHere } from "./limits-C_Xz_t3C.mjs";
+import { a as header, o as table } from "./format-hiDvtNGM.mjs";
 import { defineCommand } from "citty";
 // src/runs/usage.ts
-/**
-* @file How usage reads on the terminal (`ork usage`, specs/usage.md), and the
-*   times its `--since`, `--until` and `ork prune --older-than` take.
-*/
-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);
 /** `950`, `12.3k`, `4.5M`. */
 const tokens = shortCount;
 const percent = (share) => `${String(Math.round(share * 100))}%`;
@@ -87,7 +41,7 @@ const usageTable = (term, groups, cpu = false) => table(term, [
 	{ text: group.key },
 	{ text: cost(group.costUsd) },
 	{ text: String(group.sessions) },
-	{ text: `${tokens(group.inputTokens + group.cacheReadTokens + group.cacheWriteTokens)} in / ${tokens(group.outputTokens)} out` },
+	{ text: `${tokens(group.inputTokens + group.cacheReadTokens + group.cacheWriteTokens)} prompt / ${tokens(group.outputTokens)} out` },
 	{ text: percent(group.cacheHitRate) },
 	...cpu ? [{ text: cpuText(group.cpuMs) }] : []
 ])], "  ");
@@ -106,6 +60,15 @@ const shortTime = (iso) => new Date(iso).toLocaleString(void 0, {
 });
 /** A warning line: a `WARN` chip when rich, else the line in yellow. */
 const warned = (term, text) => term.rich ? `  ${chip(term, CHIP_LABELS.warn, "warn")} ${text}` : style("yellow", `  ${text}`);
+/**
+* `$0.0000 of $0.0100`: both sides of a dollar cap with the same digits, four
+* when either is under a dollar, else cents (`usd` alone gives `$0.00 of
+* $0.0100`).
+*/
+const capAmounts = (spent, cap) => {
+	const places = cap < 1 || spent > 0 && spent < 1 ? 4 : 2;
+	return `$${spent.toFixed(places)} of $${cap.toFixed(places)}`;
+};
 /** The limits across runs, above a report; nothing with none set. */
 const formatLimits = ({ problems, caps, tokenCaps = [], plan }, term = termOf(process.stdout)) => {
 	if (problems.length === 0 && caps.length === 0 && tokenCaps.length === 0 && plan.length === 0) return [];
@@ -113,7 +76,7 @@ const formatLimits = ({ problems, caps, tokenCaps = [], plan }, term = termOf(pr
 		style("bold", "Limits"),
 		...problems.map((problem) => warned(term, problem)),
 		...caps.map((cap) => {
-			const line = `  ${cap.project === void 0 ? "all projects" : "this project"}, this ${cap.window}: ${usd(cap.spentUsd)} of ${usd(cap.capUsd)}, resets ${shortTime(cap.resetsAt)}`;
+			const line = `  ${cap.project === void 0 ? "all projects" : "this project"}, this ${cap.window}: ${capAmounts(cap.spentUsd, cap.capUsd)}, resets ${shortTime(cap.resetsAt)}`;
 			return cap.leftUsd <= 0 ? warned(term, line.trimStart()) : line;
 		}),
 		...tokenCaps.map((cap) => {
@@ -128,7 +91,7 @@ const formatLimits = ({ problems, caps, tokenCaps = [], plan }, term = termOf(pr
 const formatUsage = (report, scope, by, term = termOf(process.stdout)) => {
 	const { totals } = report;
 	if (totals.sessions === 0) return [`No Claude sessions in ${scope}.`];
-	const lines = [`${style("bold", costOf(totals.costUsd, totals.partial, totals.tokens))} in ${scope}`, `${counted(totals.runs, "run")} · ${counted(totals.sessions, "session")} · ${counted(totals.turns, "turn")} · ${tokens(totals.inputTokens + totals.cacheReadTokens + totals.cacheWriteTokens)} in / ${tokens(totals.outputTokens)} out · ${percent(totals.cacheHitRate)} from cache`];
+	const lines = [`${style("bold", costOf(totals.costUsd, totals.partial, totals.tokens))} in ${scope}`, `${counted(totals.runs, "run")} · ${counted(totals.sessions, "session")} · ${counted(totals.turns, "turn")} · ${tokens(totals.inputTokens + totals.cacheReadTokens + totals.cacheWriteTokens)} prompt / ${tokens(totals.outputTokens)} out${totals.tokens === void 0 ? "" : ` (${tokens(totals.tokens)} counted)`} · ${percent(totals.cacheHitRate)} from cache`];
 	for (const dimension of by === void 0 ? OVERVIEW : [by]) {
 		const groups = report.groups[dimension];
 		const shown = by === void 0 ? dimension === "day" ? groups.slice(-10) : groups.slice(0, OVERVIEW_ROWS) : groups;
@@ -163,67 +126,58 @@ const usage = defineCommand({
 		name: "usage",
 		description: "Show what this project's runs spent over time"
 	},
-	args: {
-		all: {
-			type: "boolean",
-			description: "Every project's runs",
-			default: false
-		},
-		"clear-plan-limits": {
-			type: "boolean",
-			description: "Forget what Claude Code last said of your plan's limits, for one that has lifted",
-			default: false
-		},
-		since: {
-			type: "string",
-			description: "Whole days counting today (30d, 12w), exact hours (24h), a day (2026-11-01), or all",
-			default: "30d"
-		},
-		until: {
-			type: "string",
-			description: "The last day to include"
-		},
-		by: {
-			type: "string",
-			description: USAGE_DIMENSIONS.join(", ")
-		},
-		workflow: {
-			type: "string",
-			description: "Only this workflow"
-		},
-		json: {
-			type: "boolean",
-			description: "Print JSON",
-			default: false
+	args: filterArgs(usageListTable, {
+		ids: false,
+		limit: false,
+		extra: {
+			...allAlias,
+			"clear-plan-limits": {
+				type: "boolean",
+				description: "Forget what Claude Code last said of your plan's limits, for one that has lifted",
+				default: false
+			},
+			by: {
+				type: "string",
+				description: USAGE_DIMENSIONS.join(", ")
+			}
 		}
-	},
+	}),
 	run: ({ args }) => {
-		const since = args.since === "all" ? void 0 : sinceTime(args.since, Date.now());
-		const until = args.until === void 0 ? void 0 : untilTime(args.until);
-		if (since === null) {
-			refuse(`--since takes an age (30d), a day (2026-11-01) or all, not \`${args.since}\`.`);
-			return;
-		}
-		if (until === null) {
-			refuse(`--until takes a day (2026-11-01), not \`${String(args.until)}\`.`);
-			return;
-		}
-		if (args.by !== void 0 && !isDimension(args.by)) {
-			refuse(`--by takes one of ${USAGE_DIMENSIONS.join(", ")}, not \`${args.by}\`.`);
+		const asked = args["since"];
+		const since = typeof asked === "string" ? asked : "30d";
+		const request = readListArgs(usageListTable, {
+			...args,
+			since
+		}, { all: "project" });
+		if (request === void 0) return;
+		const rawBy = args["by"];
+		const given = typeof rawBy === "string" ? rawBy : void 0;
+		if (given !== void 0 && !isDimension(given)) {
+			refuse(`--by takes one of ${USAGE_DIMENSIONS.join(", ")}, not \`${given}\`.`);
 			return;
 		}
+		const by = given;
 		const store = openStore();
 		try {
-			if (args["clear-plan-limits"]) store.clearPlanLimits();
+			const scope = projectScope(request.filter, store.projects());
+			if (scope === void 0) return;
+			const named = typeof scope === "object" ? scope.root : void 0;
+			const place = scope === "here" ? placeFor(process.cwd(), store.projects()) : store.projects().find((p) => p.root === named);
+			const { workflow, until, since: from } = request.filter;
+			if (args["clear-plan-limits"] === true) {
+				const cleared = store.clearPlanLimits();
+				const said = cleared === 0 ? "No plan limit was recorded." : `Cleared ${String(cleared)} plan limit(s).`;
+				(args["json"] === true ? writeErr : write)(said);
+			}
 			const filter = {
-				...args.all ? {} : { project: placeFor(process.cwd(), store.projects()).root },
-				...args.workflow === void 0 ? {} : { workflow: args.workflow },
-				...since === void 0 ? {} : { since },
+				...place === void 0 ? {} : { project: place.root },
+				...workflow === void 0 ? {} : { workflow },
+				...from === void 0 || from === "all" ? {} : { since: from },
 				...until === void 0 ? {} : { until }
 			};
 			const report = usageReport(store.usage(filter), store.toolCpu(filter));
-			const limits = limitsHere(store, args.all ? void 0 : placeFor(process.cwd(), store.projects()));
-			if (args.json) {
+			const limits = limitsHere(store, place);
+			if (args["json"] === true) {
 				write(JSON.stringify({
 					...report,
 					limits
@@ -231,9 +185,9 @@ const usage = defineCommand({
 				return;
 			}
 			for (const line of formatLimits(limits)) write(line);
-			const place = args.all ? "every project" : "this project";
-			const period = args.since === "all" ? "" : `, since ${args.since}`;
-			for (const line of formatUsage(report, `${place}${period}`, args.by)) write(line);
+			const where = scope === "here" ? "this project" : scope === "all" ? "every project" : `project ${String(request.filter["project"])}`;
+			const period = since === "all" ? "" : `, since ${since}`;
+			for (const line of formatUsage(report, `${where}${period}`, by)) write(line);
 		} finally {
 			store.close();
 		}

package/dist/{context-Y_I4Mofq.mjs → validate-BVrT43GO.mjs}

@@ -1,8 +1,8 @@
-import { It as checkWorkflowText, Jr as retiredDriverHint, Kr as DriverSchema, L as readProjectTriggers, Lt as walkChecks, M as lateTriggers, Mt as explainSession, N as triggersReport, R as workflowTextHash, Rt as walkSummary, U as openStore, W as storePath, Xn as socketRoom, Xr as INTEGRATIONS, ai as DRIVER_IDS, ci as experimentsOn, ei as driverChecks, et as budgetWarnings, hn as namingNoDriver, ii as AGENT_DRIVERS, li as knownExperiments, mr as placeFor, oi as firstLine, pr as placeFiles, rt as driverQueues, si as EXPERIMENTS, ti as readyDriver, tt as driverRefusals, vr as workflowDirOf, xn as loadProject, xr as LESSON_CAP_TOKENS } from "./src-tsuZRu0H.mjs";
-import { c as checkDue, d as pendingNotice, f as readUpdateCache, h as writeUpdateCache, i as registryOf, m as updateCachePath, n as ORK_VERSION, o as updateSwitchOff, p as refreshUpdateCache, r as isSwitchedOn, t as ORK_NAME, u as newerVersion } from "./__build_info__-B82-dGJY.mjs";
+import { D as triggersReport, Di as EXPERIMENTS, E as lateTriggers, Ei as firstLine, Hn as loadProject, J as driverRefusals, L as openStore, M as workflowTextHash, Nr as placeFiles, Oi as experimentsOn, Pr as placeFor, R as storePath, Rr as workflowDirOf, St as walkSummary, Ti as DRIVER_IDS, X as driverQueues, bi as driverChecks, bt as checkWorkflowText, fi as DriverSchema, gi as INTEGRATIONS, hr as socketRoom, j as readProjectTriggers, ki as knownExperiments, mi as retiredDriverHint, q as budgetWarnings, rn as namingNoDriver, wi as AGENT_DRIVERS, xi as readyDriver, xt as walkChecks } from "./src-DN-RPsil.mjs";
+import { d as readUpdateCache, f as refreshUpdateCache, i as registryOf, l as newerVersion, m as writeUpdateCache, n as ORK_VERSION, o as updateSwitchOff, p as updateCachePath, r as isSwitchedOn, s as checkDue, t as ORK_NAME, u as pendingNotice } from "./__build_info__-DcRdK0Du.mjs";
 import { C as termOf, D as wrap, E as widthOf, a as plain, c as write, h as paint, l as writeErr, s as style, w as cut, x as plainEnv } from "./output-B1kwo0YU.mjs";
 import { n as chip, t as CHIP_LABELS } from "./chips-BqcT58qr.mjs";
-import { c as registeredProjects, i as refusedBuiltin, o as workflowArg, r as findWorkflowFiles, s as projectAt } from "./workflows-B30QkwTk.mjs";
+import { c as registeredProjects, i as refusedBuiltin, r as findWorkflowFiles, s as projectAt } from "./workflows-Bvl2Fquu.mjs";
 import path from "node:path";
 import { readFileSync } from "node:fs";
 import { execFile, spawn } from "node:child_process";
@@ -304,10 +304,30 @@ const experimentsCheck = (place, env = process.env, registry = EXPERIMENTS) => {
 *   `driver.ts` has the whole rule): the one `ork doctor`'s own checks find
 *   ready on this machine, said in one line. With none ready, the run stops
 *   before any session starts, with the hints `ork doctor` gives. A resumed run
-*   keeps the driver it recorded.
+*   keeps the driver it recorded. `--driver <id>` skips that look but checks
+*   that one driver's tool, and stops the run the same way when it isn't
+*   ready.
 */
 /** The real checks: the tools on this machine and its environment. */
-const checksHere = () => driverChecks(exec, process.env);
+const checksHere = (only) => only === void 0 ? driverChecks(exec, process.env) : Promise.all(AGENT_DRIVERS.filter(({ id }) => id === only).map(async (driver) => ({
+	id: driver.id,
+	result: await driver.doctor(exec, process.env)
+})));
+/**
+* What stops a run on `--driver <id>`: its own doctor check isn't `ok`, so its
+* tool isn't found or isn't signed in. Empty when it is ready. Drivers named on
+* nodes aren't looked at here; they can sit on a branch that never runs.
+*/
+const overrideRefusal = async (id, checks) => {
+	const found = (await (checks ?? checksHere)(id)).find((c) => c.id === id);
+	if (found === void 0 || found.result.status === "ok") return [];
+	const { detail, hint } = found.result;
+	return [
+		`--driver ${id}: ${id} isn't ready here (${detail}).`,
+		...hint === void 0 ? [] : [hint],
+		"See `ork doctor`."
+	];
+};
 const subject = (names, all) => {
 	if (all) return "No driver is named, so the run uses";
 	const [only] = names;
@@ -340,7 +360,13 @@ const chooseReadyDriver = (names, all, checks) => {
 * recorded; otherwise the one ready here.
 */
 const runReadyDriver = async (workflow, options) => {
-	if (options.override !== void 0) return { ok: true };
+	if (options.override !== void 0) {
+		const lines = await overrideRefusal(options.override, options.checks);
+		return lines.length === 0 ? { ok: true } : {
+			ok: false,
+			lines
+		};
+	}
 	const names = namingNoDriver(workflow);
 	if (names.length === 0) return { ok: true };
 	if (options.recorded !== void 0) return {
@@ -431,7 +457,8 @@ const pathLines = (walk) => {
 // src/commands/validate-report.ts
 const plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
 const diagnosticLine = (file, d, term) => {
-	const where = d.line === void 0 ? file : `${file}:${d.line}:${d.column ?? 1}`;
+	const at = d.file ?? file;
+	const where = d.line === void 0 ? at : `${at}:${d.line}:${d.column ?? 1}`;
 	if (term.rich) return [
 		`${d.severity === "error" ? chip(term, CHIP_LABELS.error, "danger") : chip(term, CHIP_LABELS.warn, "warn")} ${paint(term, "muted", cut(where, term.width - 9))}`,
 		...wrap(d.message, term.width - 2).map((line) => `  ${line}`),
@@ -602,104 +629,4 @@ const validate = defineCommand({
 		if (reports.some((r) => hasErrors(r.diagnostics))) process.exitCode = 1;
 	}
 });
-// src/commands/context.ts
-/**
-* @file `ork context explain <wf> <node>`: what one node's session would load,
-*   layer by layer, as core's `explainSession` plans it without writing
-*   anything (one of Ork's own `ork:` workflows is written into the project's
-*   run folder first, as `ork run` does): its project instructions, every skill
-*   with the layer it came from and whether it is live, shadowed or switched
-*   off, its context files, its practices, and estimated tokens.
-*/
-/** Loads a workflow file and plans one node's session in it, in place. */
-const explainNode = (file, nodeId, cwd, home) => {
-	const { report, workflow, graph, place, workflowDir } = loadWorkflow(file, cwd, home);
-	if (workflow === null) return {
-		ok: false,
-		lines: formatReport(report)
-	};
-	const result = explainSession(workflow, graph, nodeId, {
-		root: place.root,
-		orkDir: place.dir,
-		workflowDir,
-		...home === void 0 ? {} : { home }
-	});
-	return result.ok ? result : {
-		ok: false,
-		lines: [result.error]
-	};
-};
-const approx = (count) => style("dim", `≈${count.toLocaleString("en")} tokens`);
-const formatExplanation = (e) => {
-	const width = Math.max(8, ...e.skills.map((s) => s.name.length));
-	const sourceWidth = Math.max(0, ...e.skills.map((s) => s.source.length));
-	const lines = [
-		`${style("bold", e.node)} ${style("dim", `(${e.type}) in ${e.workflow}`)}${e.template === void 0 ? "" : style("dim", `, planned as ${e.template}, the node it was spawned from`)}`,
-		"",
-		...e.agent === void 0 ? [] : [`${style("bold", "Agent")}  ${e.agent.name} ${style("dim", `(${e.agent.where})`)}  ${approx(e.agent.tokens)}`],
-		`${style("bold", "Instructions")}  ${e.instructions}`,
-		"",
-		style("bold", "Skills")
-	];
-	if (e.skills.length === 0) lines.push(style("dim", "  none"));
-	for (const s of e.skills) {
-		const mark = s.state === "live" ? style("green", "✓") : style("dim", "−");
-		const state = s.why === void 0 ? approx(s.tokens).replace("tokens", "tokens when used") : style("yellow", `off: ${s.why}`);
-		lines.push(`  ${mark} ${s.name.padEnd(width)}  ${s.layer.padEnd(8)}  ${style("dim", s.source.padEnd(sourceWidth))}  ${state}`);
-	}
-	lines.push("", style("bold", "Context files"));
-	if (e.files.length === 0) lines.push(style("dim", "  none"));
-	for (const f of e.files) {
-		const cut = f.cutFrom === void 0 ? "" : `  ${style("yellow", `cut at the ${LESSON_CAP_TOKENS.toLocaleString("en")}-token cap; the whole file is ${approx(f.cutFrom)}`)}`;
-		lines.push(`  ${f.layer.padEnd(8)}  ${f.name}  ${approx(f.tokens)}${cut}`);
-	}
-	lines.push("", style("bold", "Practices"));
-	for (const p of e.practices) lines.push(`  ${p.name.padEnd(8)}  ${approx(p.tokens)}`);
-	for (const name of e.skippedPractices) lines.push(`  ${name.padEnd(8)}  ${style("dim", "the project's own skill wins")}`);
-	if (e.practices.length === 0 && e.skippedPractices.length === 0) lines.push(style("dim", "  off"));
-	lines.push("", `Appended to Claude Code's system prompt: ${approx(e.appendedTokens)}`);
-	return lines;
-};
-const explain = defineCommand({
-	meta: {
-		name: "explain",
-		description: "Show what one node's session loads, layer by layer"
-	},
-	args: {
-		workflow: {
-			type: "positional",
-			description: "A workflow file, the name of one in the project's workflows (.ork/workflows/), or one of Ork's own (ork:feedback-apply)",
-			required: true
-		},
-		node: {
-			type: "positional",
-			description: "Node id",
-			required: true
-		},
-		json: {
-			type: "boolean",
-			description: "Print JSON",
-			default: false
-		}
-	},
-	run: ({ args }) => {
-		const cwd = process.cwd();
-		if (refusedBuiltin([args.workflow], cwd)) return;
-		const result = explainNode(workflowArg(args.workflow, cwd).file, args.node, cwd);
-		if (!result.ok) {
-			for (const line of result.lines) process.stderr.write(`${line}\n`);
-			process.exitCode = 1;
-			return;
-		}
-		if (args.json) write(JSON.stringify(result.explanation, void 0, 2));
-		else for (const line of formatExplanation(result.explanation)) write(line);
-	}
-});
-const context = defineCommand({
-	meta: {
-		name: "context",
-		description: "Inspect the context Ork compiles for each node"
-	},
-	subCommands: { explain }
-});
-export { showUpdateNotice as C, runUpdateChild as S, updateCheckOff as T, orkCheck as _, validateFile as a, triggerChecks as b, warningLines as c, chooseReadyDriver as d, runReadyDriver as f, headWarning as g, experimentsCheck as h, validate as i, budgetWarningLines as l, exec as m, explainNode as n, walkLoaded as o, unfitLines as p, loadWorkflow as r, formatReport as s, context as t, checksHere as u, runChecks as v, startUpdateCheck as w, UPDATE_CHILD_ENV as x, socketCheck as y };
+export { startUpdateCheck as C, showUpdateNotice as S, runChecks as _, formatReport as a, UPDATE_CHILD_ENV as b, checksHere as c, runReadyDriver as d, unfitLines as f, orkCheck as g, headWarning as h, walkLoaded as i, chooseReadyDriver as l, experimentsCheck as m, validate as n, warningLines as o, exec as p, validateFile as r, budgetWarningLines as s, loadWorkflow as t, overrideRefusal as u, socketCheck as v, updateCheckOff as w, runUpdateChild as x, triggerChecks as y };

package/dist/{watch-DVNIciHp.mjs → watch-mkLm4t9D.mjs}

@@ -1,10 +1,10 @@
-import { B as watchingPid, Br as CheckReportSchema, F as triggerStanding, Gr as isToolNode, I as declaredTriggers, L as readProjectTriggers, N as triggersReport, P as createWatcher, U as openStore, Ut as liveStatus, Xt as stillTheSameProcess, Yr as timeoutMs, pr as placeFiles, wt as detachRun, z as takeWatchLock } from "./src-tsuZRu0H.mjs";
-import { n as newRunId } from "./find-BVX-bL4u.mjs";
+import { A as declaredTriggers, D as triggersReport, In as stillTheSameProcess, L as openStore, N as takeWatchLock, Nr as placeFiles, O as createWatcher, P as watchingPid, di as isToolNode, hi as timeoutMs, hn as startFollowUpChecks, j as readProjectTriggers, k as triggerStanding, kn as liveStatus, lt as detachRun, oi as CheckReportSchema, tr as runGh } from "./src-DN-RPsil.mjs";
+import { n as newRunId } from "./find-mLYsR0uC.mjs";
 import { C as termOf, E as widthOf, a as plain, c as write, l as writeErr, s as style, t as confirm, w as cut } from "./output-B1kwo0YU.mjs";
 import { n as chip, t as CHIP_LABELS } from "./chips-BqcT58qr.mjs";
-import { c as toolExecutor, o as spawnTool, s as mcpCallExecutor } from "./src-C7z_6fhn.mjs";
-import { i as runLimits, r as limitsRefusal } from "./limits-Dhe--wmX.mjs";
-import { t as acceptRefusal } from "./in-a-run-cL5N9gpH.mjs";
+import { c as toolExecutor, o as spawnTool, s as mcpCallExecutor } from "./src-DHDQ0itC.mjs";
+import { i as runLimits, r as limitsRefusal } from "./limits-C_Xz_t3C.mjs";
+import { t as acceptRefusal } from "./in-a-run-a447hxq8.mjs";
 import path from "node:path";
 import { mkdirSync } from "node:fs";
 import { homedir } from "node:os";
@@ -150,6 +150,8 @@ const acceptLines = (item, standing, term = termOf(process.stdout)) => [
 ];
 /** The triggers `--accept` can't offer, so they aren't silently left out. */
 const unacceptableLines = (item, term = termOf(process.stdout)) => [`${style("bold", plain(item.id))} ${style("dim", plain(item.place.root))}`, ...item.diagnostics.filter(({ severity }) => severity === "error").map(({ message }) => `  ${failMark(term)} ${plain(message)}`)];
+/** What `ork watch` says when follow-ups come due. */
+const dueLines = (due) => due.map((f) => `▸ follow-up due (${plain(f.for)}): ${plain(f.title)}${f.note === void 0 ? "" : ` (${plain(f.note)})`}, \`ork follow-ups show ${f.id}\``);
 // src/watch/start.ts
 /**
 * @file Starting a trigger's run (RFC-011): an ordinary run in the background,
@@ -273,7 +275,19 @@ const watchLoop = async (store) => {
 	const timer = setInterval(() => {
 		watcher.tick();
 	}, TICK_MS);
+	const stopChecks = startFollowUpChecks({
+		rows: store,
+		gh: runGh,
+		projects: () => store.projects().map((project) => project.root),
+		onDue: (due) => {
+			for (const line of dueLines(due)) write(line);
+		},
+		onError: (error) => {
+			writeErr(`follow-ups: ${error}`);
+		}
+	});
 	await stopped;
+	stopChecks();
 	clearInterval(timer);
 	stopping.abort();
 	await watcher.settled();

package/dist/{workflows-B30QkwTk.mjs → workflows-Bvl2Fquu.mjs}

@@ -1,5 +1,5 @@
-import { U as openStore, W as storePath, gr as runDirOf, mr as placeFor, pr as placeFiles, yr as inside } from "./src-tsuZRu0H.mjs";
-import { a as isBuiltinArg, n as builtinWorkflowFile, t as builtinProblem } from "./builtin-files-Bdq23IIi.mjs";
+import { Ir as runDirOf, L as openStore, Nr as placeFiles, Pr as placeFor, R as storePath, zr as inside } from "./src-DN-RPsil.mjs";
+import { a as isBuiltinArg, n as builtinWorkflowFile, t as builtinProblem } from "./builtin-files-BRSOObAv.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
 import path from "node:path";
 import { existsSync, readdirSync, statSync } from "node:fs";

package/dist/{worktrees-DD4_TpkH.mjs → worktrees-DOOCoS2w.mjs}

@@ -1,8 +1,12 @@
-import { U as openStore, Y as inspectProject, _ as keyOf, a as planRemove, c as repoRoot, d as planLine, h as applyClean, i as lostWork, l as labelOf, p as stateParts, r as applyRemove, s as readWorktrees, u as mergeStateOf, v as planClean, y as stepActs } from "./src-tsuZRu0H.mjs";
+import { Gt as applyClean, Jt as planClean, L as openStore, Wt as worktreeListTable, Yt as stepActs, Zt as inspectProject, a as planRemove, c as repoRoot, d as planLine, i as lostWork, l as labelOf, p as stateParts, qt as keyOf, r as applyRemove, s as readWorktrees, u as mergeStateOf } from "./src-DN-RPsil.mjs";
+import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
+import { i as readListArgs, n as filterArgs, r as projectScope } from "./flags-CdgIH1L6.mjs";
 import { C as termOf, c as write, h as paint, l as writeErr, s as style, t as confirm, w as cut } from "./output-B1kwo0YU.mjs";
 import { n as chip } from "./chips-BqcT58qr.mjs";
+import { t as printList } from "./print-BaWiWf4v.mjs";
+import { r as withStore } from "./project-records-BRiyQzUo.mjs";
 import path from "node:path";
-import { realpathSync } from "node:fs";
+import { existsSync, realpathSync } from "node:fs";
 import { defineCommand } from "citty";
 // src/project/go-ahead.ts
 /**
@@ -24,11 +28,11 @@ const goAhead = async (yes, verb, terminal = process.stdin.isTTY, ask = confirm)
 };
 // src/project/worktrees.ts
 /**
-* @file What `ork worktrees` prints: each worktree or branch a run left, with
-*   its state read from git, the plan `ork worktrees clean` or `remove` would
-*   carry out, and what a forced remove would lose. The words are core's
-*   (worktree/words.ts), which the Worktrees panel says too; this only colors
-*   them.
+* @file What `ork worktrees` reads across projects, and prints: each worktree
+*   or branch a run left, with its state read from git, the plan `ork worktrees
+*   clean` or `remove` would carry out, and what a forced remove would lose.
+*   The words are core's (worktree/words.ts), which the Worktrees panel says
+*   too; this only colors them.
 */
 /** One line of state: its merge state, then what clean would care about. */
 const worktreeState = (item, term = termOf(process.stdout)) => {
@@ -55,6 +59,22 @@ const formatLosses = (losses) => losses.flatMap(({ item, lost }) => {
 	const lines = formatLost(lost);
 	return lines.length === 0 ? [] : [`Loses in ${labelOf(item)}:`, ...lines];
 });
+/** What Ork created in each registered project's repository still on disk. */
+const inProjects = async (roots) => {
+	const store = openStore();
+	try {
+		return (await Promise.all([...new Set(roots)].filter((root) => existsSync(root)).map(async (root) => {
+			try {
+				return (await readWorktrees(store, root)).items;
+			} catch (error) {
+				writeErr(`Skipped ${root}: ${error instanceof Error ? error.message : String(error)}`);
+				return [];
+			}
+		}))).flat();
+	} finally {
+		store.close();
+	}
+};
 // src/commands/worktrees.ts
 /**
 * @file `ork worktrees` (or `ork wt`): lists the worktrees and branches runs
@@ -105,23 +125,31 @@ const realOr = (target) => {
 const done = (lines) => {
 	for (const line of lines) write(`${style("green", "✓")} ${line}`);
 };
-const show = async (json) => {
-	const found = await here(true);
-	if (found === null) return;
-	if (json) write(JSON.stringify(found.items, void 0, 2));
-	else for (const line of formatWorktrees(found.items)) write(line);
+const show = async (args) => {
+	const request = readListArgs(worktreeListTable, args);
+	if (request === void 0) return;
+	const projects = withStore((store) => store.projects());
+	const scope = projectScope(request.filter, projects);
+	if (scope === void 0) return;
+	let items;
+	if (scope === "here") {
+		const found = await here(true);
+		if (found === null) return;
+		items = found.items;
+	} else items = await inProjects(scope === "all" ? projects.map((p) => p.root) : [scope.root]);
+	const shown = applyFilters(worktreeListTable, items, request.filter).slice(0, request.limit);
+	printList(shown, worktreeListTable, args, (rows) => {
+		for (const line of formatWorktrees(rows)) write(line);
+	});
 };
+const listArgs = filterArgs(worktreeListTable);
 const list = defineCommand({
 	meta: {
 		name: "list",
 		description: "List Ork's worktrees and branches (the default)"
 	},
-	args: { json: {
-		type: "boolean",
-		description: "Print JSON",
-		default: false
-	} },
-	run: ({ args }) => show(args.json)
+	args: listArgs,
+	run: ({ args }) => show(args)
 });
 const yes = {
 	type: "boolean",
@@ -256,15 +284,16 @@ const worktrees = defineCommand({
 		name: "worktrees",
 		description: "Track and clean up the git worktrees Ork creates for runs"
 	},
+	args: listArgs,
 	subCommands: {
 		list,
 		clean,
 		remove
 	},
-	run: async ({ rawArgs }) => {
+	run: async ({ args, rawArgs }) => {
 		const [first] = rawArgs;
 		if (first === "list" || first === "clean" || first === "remove") return;
-		await show(rawArgs.includes("--json"));
+		await show(args);
 	}
 });
 export { worktrees };

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "@krapht/ork",
-  "version": "1.0.0-alpha.14",
-  "description": "Orchestrate Claude agents on your machine: hierarchical, serializable workflows with a CLI and a localhost UI.",
+  "version": "1.0.0-alpha.16",
+  "description": "Orchestrate coding agents (Claude Code, OpenCode, Command Code) on your machine: hierarchical, serializable workflows with a CLI and a localhost UI.",
   "keywords": [
-    "claude",
     "agents",
+    "coding-agents",
     "orchestration",
     "workflow",
     "cli",
-    "ai-engineering"
+    "ai-engineering",
+    "claude",
+    "claude-code",
+    "opencode",
+    "command-code"
   ],
   "license": "MIT",
   "repository": {