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

package/README.md

@@ -1,9 +1,9 @@
 # @krapht/ork
 
-The `ork` command: orchestrate Claude agents on your machine with hierarchical,
-serializable workflows.
+The `ork` command: orchestrate coding agents (Claude Code, OpenCode, Command
+Code) on your machine with hierarchical, serializable workflows.
 
-> **Alpha.** Workflows of Claude agents and tools, run from the terminal or the
+> **Alpha.** Workflows of coding agents and tools, run from the terminal or the
 > browser (`ork ui`). Expect changes until 1.0.0. See the
 > [project README](https://github.com/mimshins/ork#readme), the
 > [guides](https://github.com/mimshins/ork/tree/main/docs#readme) and
@@ -28,7 +28,13 @@ ork upgrade             # a newer version? upgrade the way you installed Ork
 
 A workflow that names no agent driver runs on the one that's ready. Today that
 is `claude-code`: your own `claude`, logged in or with `ANTHROPIC_API_KEY` or a
-cloud provider set. `--driver claude-code` names it.
+cloud provider set. Your own `opencode` (`open-code`) and Command Code's `cmd`
+(`command-code`) work too: `--driver <id>`, or a driver per node
+([Drivers](https://github.com/mimshins/ork/blob/main/docs/guides/drivers.md)).
+
+Ork is built with Ork: its own workflows plan, build, review and document its
+features, and each run is measured against a manual session in
+[Benchmarks: Ork building Ork](https://github.com/mimshins/ork/blob/main/benchmarks/README.md).
 
 Ork never stores or asks for credentials: it uses the tools you already have,
 signed in with your own accounts. Once a day it asks the npm registry whether a

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

@@ -1,4 +1,4 @@
-import { A as isNewer, j as parseVersion, k as compareVersions } from "./src-Dr_fTSu-.mjs";
+import { C as compareVersions, T as parseVersion, w as isNewer } from "./src-DLsFsmOD.mjs";
 import path from "node:path";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -57,19 +57,38 @@ const check = (f, action) => {
 	const error = refusal(f, action);
 	return error === void 0 ? { ok: true } : {
 		ok: false,
+		kind: "status",
 		why: `it is ${f.status}`,
 		error
 	};
 };
-const postCheck = (f) => {
-	const open = f.status === "waiting" || f.status === "due";
+/** Whether `to` names one GitHub issue or pull request by its URL. */
+const isGithubIssueUrl = (to) => /^https:\/\/github\.com\/[^/\s]+\/[^/\s]+\/(?:issues|pull)\/\d+$/u.test(to);
+/**
+* Why `f`'s draft can't be posted to GitHub whatever its status, or
+* `undefined`.
+*/
+const githubDraftRefusal = (f) => {
 	if (f.kind !== "message" || f.draft?.channel !== "github") return {
-		ok: false,
 		why: "not drafted for the github channel",
 		error: "only a message drafted for the github channel is posted; send the others yourself"
 	};
+	return isGithubIssueUrl(f.draft.to) ? void 0 : {
+		why: "its `to` isn't a GitHub issue or pull request URL",
+		error: `${f.id}'s \`to\` (${f.draft.to}) isn't a GitHub issue or pull request URL, so it is not posted; copy the text and send it yourself.`
+	};
+};
+const postCheck = (f) => {
+	const open = f.status === "waiting" || f.status === "due";
+	const refused = githubDraftRefusal(f);
+	if (refused !== void 0) return {
+		ok: false,
+		kind: "draft",
+		...refused
+	};
 	return open ? { ok: true } : {
 		ok: false,
+		kind: "status",
 		why: `it is ${f.status}`,
 		error: `${f.id} is ${f.status}, so it is not posted.`
 	};
@@ -336,5 +355,5 @@ const registryShown = (registry) => {
 *   fails when it is stale.
 */
 const ORK_NAME = "@krapht/ork";
-const ORK_VERSION = "1.0.0-alpha.15";
-export { dueCause as _, registryShown as a, fetchLatest as c, readUpdateCache as d, refreshUpdateCache as f, changeFollowUp as g, nodeSession as h, registryOf as i, newerVersion as l, writeUpdateCache as m, ORK_VERSION as n, updateSwitchOff as o, updateCachePath as p, isSwitchedOn as r, checkDue as s, ORK_NAME as t, pendingNotice as u, findFollowUp as v, followUpActions as y };
+const ORK_VERSION = "1.0.0-alpha.17";
+export { dueCause as _, registryShown as a, githubDraftRefusal as b, fetchLatest as c, readUpdateCache as d, refreshUpdateCache as f, changeFollowUp as g, nodeSession as h, registryOf as i, newerVersion as l, writeUpdateCache as m, ORK_VERSION as n, updateSwitchOff as o, updateCachePath as p, isSwitchedOn as r, checkDue as s, ORK_NAME as t, pendingNotice as u, findFollowUp as v, isGithubIssueUrl as x, followUpActions as y };

package/dist/apply-Mb0fNpCX.mjs

@@ -0,0 +1,17 @@
+// ../core/src/list-filters/apply.ts
+/**
+* @file Keeps the rows a list's filter matches (RFC-017). The list's own order
+*   and `--limit` stay the caller's: filter, then order, then limit.
+*/
+const fieldMatches = (field, row, wanted) => {
+	if (wanted === void 0 || wanted === "all" || field.get === void 0) return true;
+	const got = field.get(row);
+	if (got === void 0) return false;
+	const values = typeof got === "string" ? [got] : got;
+	if (field.type === "since") return values.some((value) => Date.parse(value) >= Date.parse(wanted));
+	if (field.type === "until") return values.some((value) => Date.parse(value) < Date.parse(wanted));
+	return values.includes(wanted);
+};
+/** The rows of `rows` every field of `filter` matches, in their order. */
+const applyFilters = (table, rows, filter) => rows.filter((row) => table.fields.every((field) => fieldMatches(field, row, filter[field.name])));
+export { applyFilters as t };

package/dist/{attach-CPespxlQ.mjs → attach-EP374oMP.mjs}

@@ -1,9 +1,9 @@
-import "./src-Dr_fTSu-.mjs";
-import { c as createTerminalHuman, t as attachRun } from "./attach-BHO3X3cf.mjs";
-import { t as findRun } from "./find-BYLlszqj.mjs";
+import "./src-DLsFsmOD.mjs";
+import { l as createTerminalHuman, t as attachRun } from "./attach-RQx__RzH.mjs";
+import { t as findRun } from "./find-k489laBa.mjs";
 import { c as write, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { n as attachRefusal } from "./in-a-run-Bp0k0J09.mjs";
-import { t as withStore } from "./store-oKJ-cCf3.mjs";
+import { n as attachRefusal } from "./in-a-run-D_9GlAlS.mjs";
+import { t as withStore } from "./store-DACH768X.mjs";
 import { defineCommand } from "citty";
 // src/commands/attach.ts
 /**

package/dist/{attach-BHO3X3cf.mjs → attach-RQx__RzH.mjs}

@@ -1,4 +1,5 @@
-import { Bn as outcomeEnd, H as isNodeEvent, Hn as END_KINDS, Lt as lockWaitLine, Ut as slotWaitLine, _t as followEvents, ct as followRunTree, fr as maskSecrets, lt as answerDecision, ut as pendingDecisions, zn as endOf } from "./src-Dr_fTSu-.mjs";
+import { Ft as slotWaitLine, I as isNodeEvent, Kn as endOf, Yn as END_KINDS, kt as lockWaitLine, nt as answerDecision, qn as outcomeEnd, rt as pendingDecisions, tt as followRunTree, ut as followEvents, yr as maskSecrets } from "./src-DLsFsmOD.mjs";
+import { t as applyFilters } from "./apply-Mb0fNpCX.mjs";
 import { C as termOf, D as wrap, E as widthOf, O as readKeys, _ as interrupt, a as plain, b as canKey, g as createRegion, h as paint, m as bold, n as cost, p as apply, r as costOf, s as style, u as confirmOrStop, v as readLine, w as cut, x as plainEnv, y as withdrawn } from "./output-B1kwo0YU.mjs";
 import { n as chip, r as nodeChip, t as CHIP_LABELS } from "./chips-BqcT58qr.mjs";
 import { a as createView, i as formatBusEvent, n as nodeVerdict, o as styler, r as firstLine, t as hasConflict } from "./verdict-CMvPCpWC.mjs";
@@ -1038,7 +1039,8 @@ const formatRunEvent = (event, width, tools, terminal = false, verbose = false,
 	if (event.type === "node.started") {
 		const round = event.round > 1 ? ` (round ${String(event.round)})` : "";
 		const owner = event.owner === void 0 ? "" : `, for ${event.owner}`;
-		return [`${tag(event.id)} ${style("dim", `${event.nodeType}${round}${owner}`)}`];
+		const named = event.description === void 0 ? "" : ` · ${event.description}`;
+		return [`${tag(event.id)} ${style("dim", `${event.nodeType}${round}${owner}${named}`)}`];
 	}
 	if (event.type === "node.event") {
 		const inner = event.event;
@@ -1121,7 +1123,7 @@ const formatRunEvent = (event, width, tools, terminal = false, verbose = false,
 /** Turns stored events into lines, keeping the state a transcript needs. */
 const createLogPrinter = (options) => {
 	const tools = /* @__PURE__ */ new Map();
-	const view = createView();
+	const view = options.view ?? createView();
 	let width = 8;
 	return (stored) => {
 		const { event } = stored;
@@ -1141,6 +1143,19 @@ const unknownNode = (stored, node, live) => {
 	const declared = stored.some(({ event }) => event.type === "run.started" && event.nodes.some((n) => n.id === node));
 	return named || declared || live ? null : `Run has no node ${node}.`;
 };
+/** `ork logs`'s filter flags (RFC-017): an event's time; no ids. */
+const logListTable = { fields: [{
+	name: "since",
+	description: "Only events since an age (24h, 30d, 12w), a day (2026-11-01), or all",
+	type: "since",
+	all: true,
+	get: (stored) => stored.at
+}, {
+	name: "until",
+	description: "Only events on or before this day (2026-11-01)",
+	type: "until",
+	get: (stored) => stored.at
+}] };
 /**
 * Prints a run's events; with `follow`, then each new one as it is stored:
 * pushed over the run's socket, or polled from the store when there is none.
@@ -1149,8 +1164,13 @@ const unknownNode = (stored, node, live) => {
 */
 const followRun = async (store, run, out, options) => {
 	const print = createLogPrinter(options);
+	const matches = (stored) => applyFilters(logListTable, [stored], options.filter ?? {}).length > 0 && (options.node === void 0 || isNodeEvent(stored.event, options.node));
+	const replayed = options.limit === void 0 ? [] : store.events(run.id, options.after ?? 0).filter((stored) => matches(stored)).slice(0, -options.limit);
+	const dropped = new Set(replayed.map((stored) => stored.seq));
 	if (await followEvents(store, run.id, (stored) => {
-		for (const line of print(stored)) out(line);
+		const lines = print(stored);
+		if (!matches(stored) || dropped.has(stored.seq)) return;
+		for (const line of lines) out(line);
 	}, {
 		follow: options.follow,
 		...options.after === void 0 ? {} : { after: options.after },
@@ -1208,13 +1228,15 @@ const askStored = async (store, human, decision, { place, by, signal, home }) =>
 *   asked through one `TerminalHuman`, withdrawn when it closes elsewhere.
 */
 const where = (path) => path.join(" › ");
+/** The gutter before a called run's lines: its call path, then ` › `. */
+const gutterOf = (path) => path.length === 0 ? "" : `${where(path)} › `;
 /**
 * Prints the events of `root` and of the runs it called until the root ends or
 * `signal` aborts, and asks each open decision with `options.human`.
 */
 const attachRun = async (store, root, out, options = {}) => {
 	const { human, basePath = [] } = options;
-	const { term } = createView();
+	const { term } = options.view ?? createView();
 	const say = styler(term);
 	const printers = /* @__PURE__ */ new Map();
 	const prompts = /* @__PURE__ */ new Map();
@@ -1226,9 +1248,25 @@ const attachRun = async (store, root, out, options = {}) => {
 		succeeded: false
 	};
 	const show = (path, lines) => {
-		const prefix = path.length === 0 ? "" : paint(term, "muted", `${where(path)} › `);
+		const gutter = gutterOf(path);
+		const prefix = gutter === "" ? "" : paint(term, "muted", gutter);
 		for (const line of lines) out(line === "" ? line : `${prefix}${line}`);
 	};
+	/**
+	* A run's printer, laid out in the columns its gutter leaves, so a line fits
+	* the terminal with the gutter before it and a wrapped line goes on under its
+	* own text, not at the terminal's first column.
+	*/
+	const printerFor = (path) => createLogPrinter({
+		json: false,
+		view: {
+			term: {
+				...term,
+				width: Math.max(20, term.width - widthOf(gutterOf(path)))
+			},
+			roots: /* @__PURE__ */ new Map()
+		}
+	});
 	const ask = (run, path, id) => {
 		const decision = store.decision(id);
 		if (human === void 0 || decision === void 0) return;
@@ -1288,7 +1326,7 @@ const attachRun = async (store, root, out, options = {}) => {
 		}
 		let print = printers.get(run);
 		if (print === void 0) {
-			print = createLogPrinter({ json: false });
+			print = printerFor(path);
 			printers.set(run, print);
 		}
 		show(path, print(stored));
@@ -1307,4 +1345,4 @@ const attachRun = async (store, root, out, options = {}) => {
 		exitCode: end === "aborted" || seen.succeeded ? 0 : 1
 	};
 };
-export { formatEvent as a, createTerminalHuman as c, unknownNode as i, readText as l, askStored as n, formatRunEvent as o, followRun as r, callsShown as s, attachRun as t, createDecisionQueue as u };
+export { unknownNode as a, callsShown as c, createDecisionQueue as d, logListTable as i, createTerminalHuman as l, askStored as n, formatEvent as o, followRun as r, formatRunEvent as s, attachRun as t, readText as u };