@krapht/ork 0.4.0 → 1.0.0-alpha.0

package/dist/{output-CXSJO00X.mjs → output-B1V6ZJSx.mjs}

@@ -1,9 +1,9 @@
-import { At as FEEDBACK_KINDS, Ht as maskReplacer, J as eventOf, K as backfillUsage, Mt as FEEDBACK_TARGETS, Ut as maskSecrets, X as text, Y as inTransaction, jt as FEEDBACK_SEVERITIES, pt as ownProcessStart, q as usageQueries, sn as PROJECT_MODES } from "./src-CGqMati3.mjs";
-import { createInterface } from "node:readline/promises";
+import { $ as text, Bt as FEEDBACK_TARGETS, Q as inTransaction, Rt as FEEDBACK_KINDS, X as usageQueries, Xt as maskReplacer, Y as backfillUsage, Z as eventOf, Zt as maskSecrets, gn as PROJECT_MODES, yt as ownProcessStart, zt as FEEDBACK_SEVERITIES } from "./src-DHvWU4tX.mjs";
 import path from "node:path";
 import { mkdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { DatabaseSync } from "node:sqlite";
+import { createInterface } from "node:readline/promises";
 import { stripVTControlCharacters, styleText } from "node:util";
 // ../core/src/store/drafts.ts
 const rowOf = (row) => {
@@ -49,6 +49,11 @@ const choicesOf = (json) => {
 		return [choice];
 	});
 };
+/** A note as stored: masked, or null when blank. */
+const noteOf = (note) => {
+	const trimmed = note?.trim() ?? "";
+	return trimmed === "" ? null : maskSecrets(trimmed);
+};
 const kindOf = (value) => value === "permission" ? "permission" : "question";
 const statusOf$1 = (value) => value === "answered" || value === "withdrawn" ? value : "open";
 const decisionOf = (row) => {
@@ -66,17 +71,19 @@ const decisionOf = (row) => {
 		recommended: text(row, "recommended"),
 		context: text(row, "context"),
 		answer: text(row, "answer"),
-		answeredAt: text(row, "answered_at")
+		answeredAt: text(row, "answered_at"),
+		note: text(row, "note"),
+		owner: text(row, "owner")
 	};
 	for (const [key, value] of Object.entries(optional)) if (value !== "") Object.assign(record, { [key]: value });
 	const by = text(row, "answered_by");
-	if (by === "terminal" || by === "decide" || by === "ui") record.answeredBy = by;
+	if (by === "terminal" || by === "decide" || by === "ui" || by === "owner") record.answeredBy = by;
 	return record;
 };
 const decisionQueries = (db) => {
-	const insert = db.prepare(`INSERT INTO decisions (id, run_id, node, kind, question, options, recommended, context, opened_at, status)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'open')`);
-	const answer = db.prepare(`UPDATE decisions SET status = 'answered', answer = ?, answered_by = ?, answered_at = ?
+	const insert = db.prepare(`INSERT INTO decisions (id, run_id, node, kind, question, options, recommended, context, owner, opened_at, status)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'open')`);
+	const answer = db.prepare(`UPDATE decisions SET status = 'answered', answer = ?, answered_by = ?, answered_at = ?, note = ?
      WHERE id = ? AND status = 'open'`);
 	const withdraw = db.prepare("UPDATE decisions SET status = 'withdrawn', answered_at = ? WHERE id = ? AND status = 'open'");
 	const byId = db.prepare("SELECT * FROM decisions WHERE id = ?");
@@ -97,14 +104,14 @@ const decisionQueries = (db) => {
 				question: maskSecrets(decision.question),
 				...decision.context === void 0 ? {} : { context: maskSecrets(decision.context) }
 			};
-			insert.run(masked.id, masked.runId, masked.node, masked.kind, masked.question, JSON.stringify(masked.options), masked.recommended ?? null, masked.context ?? null, openedAt);
+			insert.run(masked.id, masked.runId, masked.node, masked.kind, masked.question, JSON.stringify(masked.options), masked.recommended ?? null, masked.context ?? null, masked.owner ?? null, openedAt);
 			return {
 				...masked,
 				openedAt,
 				status: "open"
 			};
 		},
-		answerDecision: (id, choice, by) => Number(answer.run(choice, by, (/* @__PURE__ */ new Date()).toISOString(), id).changes) === 1,
+		answerDecision: (id, choice, by, note) => Number(answer.run(choice, by, (/* @__PURE__ */ new Date()).toISOString(), noteOf(note), id).changes) === 1,
 		withdrawDecision: (id) => {
 			withdraw.run((/* @__PURE__ */ new Date()).toISOString(), id);
 		},
@@ -720,9 +727,21 @@ const MIGRATIONS = [
    );`,
 	`ALTER TABLE feedback_items ADD COLUMN merged_into TEXT;
    CREATE INDEX feedback_items_merged ON feedback_items (merged_into);`,
-	`ALTER TABLE runs ADD COLUMN process_start TEXT;`
+	`ALTER TABLE runs ADD COLUMN process_start TEXT;`,
+	`ALTER TABLE runs ADD COLUMN skipped INTEGER;
+   ALTER TABLE runs ADD COLUMN failures_handled INTEGER;`,
+	`ALTER TABLE decisions ADD COLUMN note TEXT;`,
+	`ALTER TABLE decisions ADD COLUMN owner TEXT;`
 ];
 const versionOf = (db) => Number(db.prepare("PRAGMA user_version").get()?.["user_version"] ?? 0);
+/**
+* Refuses a database that is not at this Ork's schema version, newer or older,
+* for a reader that may not migrate it (a read-only open).
+*/
+const requireCurrent = (db, migrations = MIGRATIONS) => {
+	const version = versionOf(db);
+	if (version !== migrations.length) throw new Error(`The store is at schema version ${String(version)}; this Ork reads ${String(migrations.length)}.`);
+};
 /** Applies the migrations the database has not had yet. */
 const migrate = (db, migrations = MIGRATIONS) => {
 	for (const [index, step] of migrations.entries()) {
@@ -741,7 +760,9 @@ const migrate = (db, migrations = MIGRATIONS) => {
 *   project, `~/.ork/state.db`, in WAL mode so other `ork` processes read while
 *   a run writes. Events are stored with secrets masked, feedback records
 *   beside them, and the registered projects; the schema is versioned with
-*   `user_version`.
+*   `user_version`. Tab completion opens it read-only: no store created, no
+*   migration, a store at another version refused, and the database never
+*   changed (SQLite may still add the `-wal` and `-shm` files beside it).
 */
 /** `~/.ork/state.db`; `home` is `~` (tests pass a folder). */
 const storePath = (home = homedir()) => path.join(home, ".ork", "state.db");
@@ -773,6 +794,10 @@ const recordOf = (row) => {
 	if (parent !== "") record.parent = parent;
 	const finished = text(row, "finished_at");
 	if (finished !== "") record.finishedAt = finished;
+	const skipped = row?.["skipped"];
+	if (typeof skipped === "number") record.skipped = skipped;
+	const handled = row?.["failures_handled"];
+	if (typeof handled === "number") record.failuresHandled = handled;
 	return record;
 };
 /** The node an event is about, for filtering. */
@@ -781,9 +806,20 @@ const nodeOf = (event) => {
 	if ("node" in event && typeof event.node === "string") return event.node;
 	return null;
 };
-/** Opens (and creates) the store at `file`; `:memory:` for tests. */
-const openStore = (file = storePath(), options = {}) => {
-	const ownStart = options.processStart ?? ownProcessStart;
+/** A database opened for reading only, refused unless it is current. */
+const openReadOnly = (file) => {
+	const db = new DatabaseSync(file, { readOnly: true });
+	try {
+		db.exec("PRAGMA busy_timeout = 5000");
+		requireCurrent(db);
+		return db;
+	} catch (error) {
+		db.close();
+		throw error;
+	}
+};
+/** A database opened for writing: created, in WAL mode, migrated. */
+const openWritable = (file) => {
 	if (file !== ":memory:") mkdirSync(path.dirname(file), { recursive: true });
 	const db = new DatabaseSync(file);
 	db.exec("PRAGMA busy_timeout = 5000");
@@ -791,18 +827,28 @@ const openStore = (file = storePath(), options = {}) => {
 	db.exec("PRAGMA synchronous = NORMAL");
 	db.exec("PRAGMA foreign_keys = ON");
 	migrate(db);
+	return db;
+};
+/**
+* Opens (and creates) the store at `file`; `:memory:` for tests. With
+* `readOnly`, it neither creates nor migrates, and throws when it can't read.
+*/
+const openStore = (file = storePath(), options = {}) => {
+	const ownStart = options.processStart ?? ownProcessStart;
+	const db = options.readOnly === true ? openReadOnly(file) : openWritable(file);
 	const insertRun = db.prepare(`INSERT INTO runs (id, workflow, file, project, status, pid, process_start, started_at, parent, depth)
      VALUES (?, ?, ?, ?, 'running', ?, ?, ?, ?, ?)`);
 	const lastSeq = db.prepare("SELECT COALESCE(MAX(seq), 0) AS seq FROM events WHERE run_id = ?");
 	const insertEvent = db.prepare("INSERT INTO events (run_id, seq, at, type, node, data) VALUES (?, ?, ?, ?, ?, ?)");
-	const finishRun = db.prepare("UPDATE runs SET status = ?, finished_at = ?, cost_usd = ? WHERE id = ?");
-	const reopenRun = db.prepare("UPDATE runs SET status = 'running', pid = ?, process_start = ?, finished_at = NULL WHERE id = ?");
+	const finishRun = db.prepare("UPDATE runs SET status = ?, finished_at = ?, cost_usd = ?, skipped = ?, failures_handled = ? WHERE id = ?");
+	const reopenRun = db.prepare("UPDATE runs SET status = 'running', pid = ?, process_start = ?, finished_at = NULL, skipped = NULL, failures_handled = NULL WHERE id = ?");
 	const addCost = db.prepare("UPDATE runs SET cost_usd = cost_usd + ? WHERE id = ?");
 	const byId = db.prepare("SELECT * FROM runs WHERE id = ?");
 	const byPrefix = db.prepare("SELECT * FROM runs WHERE substr(id, 1, ?) = ? ORDER BY started_at DESC, rowid DESC");
 	const allRuns = db.prepare("SELECT * FROM runs ORDER BY started_at DESC, rowid DESC LIMIT ?");
 	const projectRuns = db.prepare("SELECT * FROM runs WHERE project = ? ORDER BY started_at DESC, rowid DESC LIMIT ?");
 	const eventsAfter = db.prepare("SELECT seq, at, data FROM events WHERE run_id = ? AND seq > ? ORDER BY seq");
+	const runNodes = db.prepare("SELECT node FROM events WHERE run_id = ? AND node IS NOT NULL GROUP BY node ORDER BY MIN(seq)");
 	const { insertFeedback, recordUsage, recordPlanLimit, ...queries } = storeQueries(db);
 	return {
 		...queries,
@@ -832,7 +878,10 @@ const openStore = (file = storePath(), options = {}) => {
 			if (event.type === "node.event" && event.event.type === "session.finished") recordUsage(runId);
 			if (event.type === "node.event" && event.event.type === "plan.limit") recordPlanLimit(event.event, at);
 			if (event.type === "feedback.recorded") insertFeedback(runId, seq, at, event.node, event.feedback);
-			if (event.type === "run.finished") finishRun.run(event.result.status, at, event.result.costUsd, runId);
+			if (event.type === "run.finished") {
+				const { status, costUsd, skipped, failuresHandled } = event.result;
+				finishRun.run(status, at, costUsd, skipped ?? null, failuresHandled ?? null, runId);
+			}
 			return {
 				runId,
 				seq,
@@ -855,6 +904,7 @@ const openStore = (file = storePath(), options = {}) => {
 			at: text(r, "at"),
 			event: eventOf(text(r, "data"))
 		})),
+		nodes: (runId) => runNodes.all(runId).map((r) => text(r, "node")),
 		close: () => {
 			db.close();
 		}

package/dist/{pause-BPSmg4yz.mjs → pause-B_SL_yDz.mjs}

@@ -1,7 +1,7 @@
-import { H as requestContinue, U as requestPause } from "./src-CGqMati3.mjs";
-import { t as findRun } from "./find-DptmbhGd.mjs";
-import { a as write, c as openStore, i as style, o as writeErr } from "./output-CXSJO00X.mjs";
-import { r as continueRefusal } from "./in-a-run-D1Qc5Mit.mjs";
+import { G as requestContinue, K as requestPause } from "./src-DHvWU4tX.mjs";
+import { t as findRun } from "./find-BKW-uGey.mjs";
+import { a as write, c as openStore, i as style, o as writeErr } from "./output-B1V6ZJSx.mjs";
+import { r as continueRefusal } from "./in-a-run-BPXX09Bs.mjs";
 import { defineCommand } from "citty";
 // src/commands/pause.ts
 /**

package/dist/{relay-Do-aNbSD.mjs → relay-o-Luee1c.mjs}

@@ -1,5 +1,5 @@
-import { B as unlinkNodes, L as linkNodes, P as addressOf } from "./src-CGqMati3.mjs";
-import { a as write, c as openStore, i as style, o as writeErr } from "./output-CXSJO00X.mjs";
+import { B as linkNodes, L as addressOf, U as unlinkNodes } from "./src-DHvWU4tX.mjs";
+import { a as write, c as openStore, i as style, o as writeErr } from "./output-B1V6ZJSx.mjs";
 import { defineCommand } from "citty";
 // src/commands/relay.ts
 /**

package/dist/{remove-AwaMMaHf.mjs → remove-DAZ7ZCzt.mjs}

@@ -1,6 +1,6 @@
-import { D as git, k as lines, lt as liveStatus } from "./src-CGqMati3.mjs";
-import { n as listOrkWorktrees, t as createdWorktrees } from "./list-ZvY2OcLq.mjs";
-import { i as keyOf, n as applyStep, r as cleanStep, s as stepPrunes } from "./clean-Dcr807be.mjs";
+import { ht as liveStatus, j as lines, k as git } from "./src-DHvWU4tX.mjs";
+import { n as listOrkWorktrees, t as createdWorktrees } from "./list-C7UEgmtd.mjs";
+import { i as keyOf, n as applyStep, r as cleanStep, s as stepPrunes } from "./clean-NnboOuz6.mjs";
 // ../core/src/worktree/words.ts
 /**
 * @file The plain words for what `ork worktrees` shows, in one place, so the

package/dist/{send-DhGBkowy.mjs → send-3B64fBNB.mjs}

@@ -1,6 +1,6 @@
-import { Xt as wakeRun, Yt as socketPath, lt as liveStatus, wt as scriptContactsOf } from "./src-CGqMati3.mjs";
-import { c as openStore, o as writeErr } from "./output-CXSJO00X.mjs";
-import { u as inheritedScrubber } from "./src-UWkk1sl9.mjs";
+import { an as wakeRun, ht as liveStatus, kt as scriptContactsOf, rn as socketPath } from "./src-DHvWU4tX.mjs";
+import { c as openStore, o as writeErr } from "./output-B1V6ZJSx.mjs";
+import { u as inheritedScrubber } from "./src-C38BPzit.mjs";
 import { defineCommand } from "citty";
 // ../core/src/remote/send.ts
 /**

package/dist/{src-CpDKIulI.mjs → src-BJTegEzY.mjs}

@@ -1,10 +1,11 @@
-import { $ as resumable, An as parseWorkflow, B as unlinkNodes, Dn as newWorkflowText, Dt as nodeSays, En as applyEdits, Ft as runGh, G as tellLiveRun, H as requestContinue, In as expandEdge, It as sendPost, L as linkNodes, Nt as DISCUSSIONS, On as readDocument, Pn as EdgeInputSchema, Pt as planPost, Q as detachResume, Rn as NodeSchema, Tn as WorkflowEditSchema, U as requestPause, W as requestStop, _n as inside, _t as walkChecks, at as explainWorkflowText, d as runningRunIds, dn as placeFiles, dt as runStatus, f as runningScript, fn as placeFor, ft as runTree, g as triggersReport, gn as workflowDirOf, gt as checkWorkflowText, it as followEvents, kn as renderJsonSchema, l as planUpgrade, lt as liveStatus, mn as runDirOf, mt as processAlive, o as limitsReport, on as loadAgents, p as detectInstaller, qt as readCondition, r as capsHere, rt as detachRun, u as releaseNotes, ut as pausedOf, vt as walkSummary, wn as skillsIn, yn as LESSON_CAP_TOKENS } from "./src-CGqMati3.mjs";
-import { D as placeOf$1, E as lessonPlaceOf, O as feedbackActions, S as previewPost, T as acceptItem, _ as answerDecision, a as registryShown, c as checkDue, f as readUpdateCache, g as nodeSession, h as writeUpdateCache, i as registryOf, k as openFixRun, l as fetchLatest, m as updateCachePath, o as updateSwitchOff, p as refreshUpdateCache, s as runInstall, u as newerVersion, v as pendingDecisions, w as recordNote, y as builtinProblem } from "./__build_info__-CtSVVuZE.mjs";
-import { n as newRunId, t as findRun } from "./find-DptmbhGd.mjs";
-import { c as openStore, l as storePath, s as nodeOf } from "./output-CXSJO00X.mjs";
+import { B as linkNodes, Cn as runDirOf, Ct as walkChecks, En as inside, Fn as applyEdits, G as requestContinue, Gn as expandEdge, Hn as EdgeInputSchema, Ht as planPost, In as newWorkflowText, J as tellLiveRun, K as requestPause, Ln as readDocument, Nn as skillsIn, Nt as nodeSays, On as LESSON_CAP_TOKENS, Pn as WorkflowEditSchema, Rn as renderJsonSchema, St as checkWorkflowText, Tn as workflowDirOf, U as unlinkNodes, Ut as runGh, Vt as DISCUSSIONS, Wt as sendPost, _t as runStatus, bn as placeFiles, bt as processAlive, ct as explainWorkflowText, d as runningRunIds, f as runningScript, gt as pausedOf, hn as loadAgents, ht as liveStatus, l as planUpgrade, nt as resumable, o as limitsReport, ot as detachRun, p as detectInstaller, q as requestStop, qn as NodeSchema, r as capsHere, st as followEvents, tn as readCondition, tt as detachResume, u as releaseNotes, v as triggersReport, vt as runTree, wt as walkSummary, xn as placeFor, zn as parseWorkflow } from "./src-DHvWU4tX.mjs";
+import { C as feedbackActions, S as placeOf$1, _ as previewPost, a as registryShown, b as acceptItem, c as checkDue, f as readUpdateCache, g as nodeSession, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, o as updateSwitchOff, p as refreshUpdateCache, s as runInstall, u as newerVersion, w as openFixRun, x as lessonPlaceOf, y as recordNote } from "./__build_info__-DdTVd2p5.mjs";
+import { n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-B81wCZQg.mjs";
+import { n as newRunId, t as findRun } from "./find-BKW-uGey.mjs";
+import { c as openStore, l as storePath, s as nodeOf } from "./output-B1V6ZJSx.mjs";
 import { n as usageReport } from "./report-DK4LGqwF.mjs";
-import { a as planClean, i as keyOf, o as stepActs, r as cleanStep, s as stepPrunes, t as applyClean } from "./clean-Dcr807be.mjs";
-import { a as readWorktrees, c as planLine, i as projectHead, l as removeRefusal, n as lostWork, o as labelOf, r as planRemove, s as mergeStateOf, t as applyRemove, u as stateParts } from "./remove-AwaMMaHf.mjs";
+import { a as planClean, i as keyOf, o as stepActs, r as cleanStep, s as stepPrunes, t as applyClean } from "./clean-NnboOuz6.mjs";
+import { a as readWorktrees, c as planLine, i as projectHead, l as removeRefusal, n as lostWork, o as labelOf, r as planRemove, s as mergeStateOf, t as applyRemove, u as stateParts } from "./remove-DAZ7ZCzt.mjs";
 import path from "node:path";
 import { z } from "zod";
 import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
@@ -350,7 +351,11 @@ const DecisionsQuerySchema = z.strictObject({
 	run: z.string().min(1).optional(),
 	project: z.string().min(1).optional()
 });
-const AnswerSchema = z.strictObject({ choose: z.string().min(1) });
+/** An answer: the option, and what the person said with it, if anything. */
+const AnswerSchema = z.strictObject({
+	choose: z.string().min(1),
+	note: z.string().optional()
+});
 const RunFlags = {
 	inputs: z.record(z.string(), z.string()).optional(),
 	driver: Driver.optional(),
@@ -955,7 +960,7 @@ const writeRoutes = (context) => {
 	const script = context.script === void 0 ? {} : { script: context.script };
 	return {
 		answer: async ({ params, body }) => {
-			const answered = await answerDecision(context.store, params.id, body.choose, context.home, "ui");
+			const answered = await answerDecision(context.store, params.id, body.choose, context.home, "ui", body.note);
 			return answered.ok ? ok({
 				decision: params.id,
 				answer: body.choose
@@ -1710,8 +1715,11 @@ const mcpTools = (context) => {
 	];
 };
 const NOT_HERE = "This server was not started by `ork ui`.";
-/** Asks the registry when the daily check is due; never throws. */
-const checkIfDue = async (file, options) => {
+/**
+* Asks the registry when the daily check is due; never throws. `current` is the
+* running version, which says whether the `canary` tag counts.
+*/
+const checkIfDue = async (file, options, current) => {
 	try {
 		const now = /* @__PURE__ */ new Date();
 		const cache = readUpdateCache(file);
@@ -1723,7 +1731,8 @@ const checkIfDue = async (file, options) => {
 		const registry = registryOf(options.env ?? process.env);
 		await refreshUpdateCache(file, options.name, now, {
 			...registry === void 0 ? {} : { registry },
-			...options.fetch === void 0 ? {} : { fetch: options.fetch }
+			...options.fetch === void 0 ? {} : { fetch: options.fetch },
+			current
 		});
 		return true;
 	} catch {
@@ -1750,7 +1759,7 @@ const createUpdates = (input) => {
 	let timer;
 	if (options !== void 0 && reason === null) {
 		const due = () => {
-			checkIfDue(file, options).then((asked) => {
+			checkIfDue(file, options, version).then((asked) => {
 				if (asked) record = null;
 				return asked;
 			});
@@ -2276,7 +2285,8 @@ const askPlan = async (context) => {
 	const latest = await fetchLatest(options.name, {
 		...registry === void 0 ? {} : { registry },
 		...options.fetch === void 0 ? {} : { fetch: options.fetch },
-		timeoutMs: ASK_TIMEOUT_MS
+		timeoutMs: ASK_TIMEOUT_MS,
+		current
 	});
 	const script = options.script ?? runningScript();
 	const plan = planUpgrade({