mainflow 0.29.0 → 0.30.0

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { $ as nowMinute, G as loadHub, H as applyOperation, Q as requireSlug, S as readSession, U as checkHubName, W as HubError, X as MAINLINE_FILE, Z as TASK_FILE, _ as untilState, d as retroReportFromReceiver, f as receiverFromEnv, g as initHub, l as migrateHub, ot as DATA_DIR, p as RETRY_RULES, rt as findHubRoot, st as WriteError, tt as nodeStorage, u as retroReport, v as duplicateClaimLines, x as loadSessions, y as sessionBriefing } from "./host-BJnrv8xF.js";
-import { B as parseRef, H as refExample, V as parseUntil, k as UNTIL_FORMS } from "./dist-BbamrIPW.js";
+import { B as parseRef, H as refExample, V as parseUntil, Y as stampMs, k as UNTIL_FORMS } from "./dist-IdbnCDqM.js";
+import { B as checkHubName, H as loadHub, J as TASK_FILE, Q as nodeStorage, S as readSession, V as HubError, X as nowMinute, Y as requireSlug, _ as untilState, d as retroReportFromReceiver, f as receiverFromEnv, g as initHub, l as migrateHub, ot as DATA_DIR, p as RETRY_RULES, q as MAINLINE_FILE, rt as findHubRoot, st as WriteError, u as retroReport, v as duplicateClaimLines, x as loadSessions, y as sessionBriefing, z as applyOperation } from "./host-DmVNYRql.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { C as ServerError, S as ServerApi, _ as silentHint, a as remoteMode, c as syncSettings, d as startDaemon, f as DaemonRunning, g as readDaemon, h as probeDaemon, i as queuedCount, l as hookAnswer, m as callDaemon, n as hubWriter, o as ENV, p as DaemonUnavailable, r as writtenLines, s as hubName, t as CONFIRM_MS, u as planFlush, v as SETTINGS_FILE, x as syncPaths } from "./operation-Bp4U2bx3.js";
+import { C as ServerError, S as ServerApi, _ as silentHint, a as remoteMode, c as syncSettings, d as startDaemon, f as DaemonRunning, g as readDaemon, h as probeDaemon, i as queuedCount, l as hookAnswer, m as callDaemon, n as hubWriter, o as ENV, p as DaemonUnavailable, r as writtenLines, s as hubName, t as CONFIRM_MS, u as planFlush, v as SETTINGS_FILE, x as syncPaths } from "./operation-BQiUL0eq.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { hookFallback, parsePayload, runHook } from "./hooks.js";
-import { c as watchHubGone, l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-DefacJEL.js";
+import { c as watchHubGone, l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-DHug6eli.js";
 import { randomBytes } from "node:crypto";
 import { existsSync, readFileSync, realpathSync, rmSync, statSync } from "node:fs";
 import { basename, join, relative, resolve } from "node:path";
@@ -56,7 +56,7 @@ async function syncRun(root) {
 	});
 	await daemon.stop();
 	forgetStarted(root);
-	return 0;
+	process.exit(0);
 }
 /** Clear the record of a background start when it names this process. */
 function forgetStarted(root) {
@@ -900,8 +900,12 @@ const RUNS = {
 	},
 	"ops list": ({ root, opts }) => {
 		const covers = (ref) => !opts.ref || ref !== void 0 && (ref === opts.ref || ref.startsWith(`${opts.ref}/`) || ref.startsWith(`${opts.ref}#`));
-		const shown = loadHub(root).ops.filter((o) => (!opts.month || o.at.startsWith(opts.month)) && covers(o.ref));
-		for (const o of shown) console.log(`  ${o.at}  ${o.target}  ${o.operation}  ${o.result}${o.ref ? `  ${o.ref}` : ""}`);
+		const local = (at) => {
+			const d = new Date(stampMs(at));
+			return `${d.toLocaleDateString("sv-SE")}T${d.toTimeString().slice(0, 5)}`;
+		};
+		const shown = loadHub(root).ops.filter((o) => (!opts.month || local(o.at).startsWith(opts.month)) && covers(o.ref));
+		for (const o of shown) console.log(`  ${local(o.at)}  ${o.target}  ${o.operation}  ${o.result}${o.ref ? `  ${o.ref}` : ""}`);
 		return done(`${shown.length} operations`);
 	},
 	retro: ({ root, args, opts }) => {

package/dist/{dist-BbamrIPW.js → dist-IdbnCDqM.js}

@@ -344,8 +344,29 @@ function satisfies(version, range) {
 	});
 }
 //#endregion
+//#region ../schema/dist/stamp.js
+/** An offset from UTC: `Z` for UTC itself, otherwise ±HH:mm with hours 00 to 23 and minutes 00 to 59. */
+const OFFSET = "(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)";
+/** A time to the minute: the local minute and, since format 3, its offset from UTC. One without an offset was written before format 3. */
+const DATETIME = new RegExp(`^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}${OFFSET}?$`);
+/** A day, or a day with the time when the moment matters. */
+const DATE_OR_TIME = new RegExp(`^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}${OFFSET}?)?$`);
+const STAMP = new RegExp(`^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2})(${OFFSET})?$`);
+/**
+* The instant a time-to-the-minute stamp names, in epoch milliseconds. A stamp with an offset names one instant
+* everywhere; a stamp without one (written before format 3) is read as the reader's local time. NaN when `stamp` is
+* not in that form.
+*/
+function stampMs(stamp) {
+	const m = STAMP.exec(stamp);
+	if (!m) return NaN;
+	const [, y, mo, d, hh, mm, offset] = m;
+	if (offset) return Date.parse(`${y}-${mo}-${d}T${hh}:${mm}:00${offset}`);
+	return new Date(Number(y), Number(mo) - 1, Number(d), Number(hh), Number(mm)).getTime();
+}
+//#endregion
 //#region ../schema/dist/index.js
-const FORMAT_VERSION = 2;
+const FORMAT_VERSION = 3;
 const ID_PATTERNS = {
 	mainline: /^m\d{3}$/,
 	task: /^t\d{3}$/,
@@ -362,7 +383,6 @@ const CHECKLIST_REF = /^m\d{3}\/t\d{3}#c\d{3}$/;
 const SERVES_REF = /^m\d{3}(?:\/t\d{3}#c\d{3}|#r\d{3})$/;
 const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const DATE = /^\d{4}-\d{2}-\d{2}$/;
-const DATETIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/;
 /** A hub name: kebab-case, also the first label of {hub}.mainflow.localhost and the prefix of a cross-hub reference. */
 const HUB_NAME = SLUG;
 /** Prefixes the web interface already uses in its own references, so no registered hub may take them. */
@@ -482,7 +502,7 @@ const id = (kind) => z.string().regex(ID_PATTERNS[kind]);
 const date = z.string().regex(DATE);
 const datetime = z.string().regex(DATETIME);
 /** A day, or a day with the time when the moment matters (who decided what, and when). */
-const dateOrTime = z.string().regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?$/);
+const dateOrTime = z.string().regex(DATE_OR_TIME);
 const text = z.string().min(1);
 /** Any reference parseRef understands, in this hub or, with a `{hub}:` prefix, in another one. */
 const anyRef = z.string().refine((s) => parseRef(s) !== null, `expected a reference like ${REF_EXAMPLES}`);
@@ -1020,4 +1040,4 @@ function parseOpsLine(line) {
 	return parsed.success ? parsed.data : null;
 }
 //#endregion
-export { grantForm as $, WORK_STATUS as A, parseRef as B, SESSION_STATUS as C, TASK_REQUIRED_SECTIONS as D, SURVEY_SECTION as E, issueSchema as F, taskSchema as G, refExample as H, mainlineSchema as I, GRANT_ACTIONS as J, waitingForAction as K, opsEntrySchema as L, decisionSchema as M, findingSchema as N, TASK_SECTIONS as O, formatOpsEntry as P, grantCovers as Q, parseActionRef as R, SESSION_ID as S, SURVEY_LINES as T, refMainline as U, parseUntil as V, sessionSchema as W, GRANT_TARGET_FORMS as X, GRANT_FORMS as Y, describeRequest as Z, MERGE_STATES as _, DECISION_SECTIONS as a, RESERVED_HUB_NAMES as b, FINDING_SECTIONS as c, ID_PATTERNS as d, grantRepo as et, ISSUE_SECTIONS as f, MAINLINE_STATUS as g, MAINLINE_SECTIONS as h, DECISION_BASES as i, configSchema as j, UNTIL_FORMS as k, FINDING_STATUS as l, LINK_RELS as m, CLOSED_STATUS as n, DECISION_STATUS as o, ISSUE_STATUS as p, waitingForRef as q, DECIDERS as r, DEFAULT_CATEGORIES as s, CHECKLIST_REF as t, parseGrantTarget as tt, FORMAT_VERSION as u, PRIORITIES as v, SLUG as w, SERVES_REF as x, REF_EXAMPLES as y, parseOpsLine as z };
+export { describeRequest as $, WORK_STATUS as A, parseRef as B, SESSION_STATUS as C, TASK_REQUIRED_SECTIONS as D, SURVEY_SECTION as E, issueSchema as F, taskSchema as G, refExample as H, mainlineSchema as I, OFFSET as J, waitingForAction as K, opsEntrySchema as L, decisionSchema as M, findingSchema as N, TASK_SECTIONS as O, formatOpsEntry as P, GRANT_TARGET_FORMS as Q, parseActionRef as R, SESSION_ID as S, SURVEY_LINES as T, refMainline as U, parseUntil as V, sessionSchema as W, GRANT_ACTIONS as X, stampMs as Y, GRANT_FORMS as Z, MERGE_STATES as _, DECISION_SECTIONS as a, RESERVED_HUB_NAMES as b, FINDING_SECTIONS as c, ID_PATTERNS as d, grantCovers as et, ISSUE_SECTIONS as f, MAINLINE_STATUS as g, MAINLINE_SECTIONS as h, DECISION_BASES as i, configSchema as j, UNTIL_FORMS as k, FINDING_STATUS as l, LINK_RELS as m, CLOSED_STATUS as n, grantRepo as nt, DECISION_STATUS as o, ISSUE_STATUS as p, waitingForRef as q, DECIDERS as r, parseGrantTarget as rt, DEFAULT_CATEGORIES as s, CHECKLIST_REF as t, grantForm as tt, FORMAT_VERSION as u, PRIORITIES as v, SLUG as w, SERVES_REF as x, REF_EXAMPLES as y, parseOpsLine as z };

package/dist/facts.d.ts

@@ -1,4 +1,4 @@
-import { _ as Until, c as ID_PATTERNS, f as SERVES_REF, h as SurveyLine, o as FORMAT_VERSION, p as SLUG, r as CHECKLIST_REF } from "./index-DV6Gqu8K.js";
+import { _ as Until, c as ID_PATTERNS, f as SERVES_REF, h as SurveyLine, o as FORMAT_VERSION, p as SLUG, r as CHECKLIST_REF } from "./index-ihgXABQc.js";
 //#region src/facts.d.ts
 export interface CommandSpec {
   usage: string;

package/dist/facts.js

@@ -1,4 +1,4 @@
-import { A as WORK_STATUS, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, J as GRANT_ACTIONS, O as TASK_SECTIONS, T as SURVEY_LINES, X as GRANT_TARGET_FORMS, Y as GRANT_FORMS, _ as MERGE_STATES, a as DECISION_SECTIONS, c as FINDING_SECTIONS, d as ID_PATTERNS, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, k as UNTIL_FORMS, l as FINDING_STATUS, m as LINK_RELS, n as CLOSED_STATUS, o as DECISION_STATUS, p as ISSUE_STATUS, r as DECIDERS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, u as FORMAT_VERSION, v as PRIORITIES, w as SLUG, x as SERVES_REF } from "./dist-BbamrIPW.js";
+import { A as WORK_STATUS, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, O as TASK_SECTIONS, Q as GRANT_TARGET_FORMS, T as SURVEY_LINES, X as GRANT_ACTIONS, Z as GRANT_FORMS, _ as MERGE_STATES, a as DECISION_SECTIONS, c as FINDING_SECTIONS, d as ID_PATTERNS, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, k as UNTIL_FORMS, l as FINDING_STATUS, m as LINK_RELS, n as CLOSED_STATUS, o as DECISION_STATUS, p as ISSUE_STATUS, r as DECIDERS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, u as FORMAT_VERSION, v as PRIORITIES, w as SLUG, x as SERVES_REF } from "./dist-IdbnCDqM.js";
 import { a as LABEL_ROLES, i as FINDING_SEVERITIES, n as FINDING_CLASSES, r as FINDING_FIELDS, t as FINDINGS_FENCE } from "./retro-formats-ECy0gGOL.js";
 //#region src/facts.ts
 const COMMAND_SPECS = {

package/dist/grant-commands.d.ts

@@ -1,4 +1,4 @@
-import "./index-DV6Gqu8K.js";
+import "./index-ihgXABQc.js";
 //#region ../schema/dist/grants.d.ts
 /** An operation about to run, resolved to what a grant is written against. */
 type GrantRequest = {

package/dist/grant-commands.js

@@ -1,4 +1,4 @@
-import { Y as GRANT_FORMS } from "./dist-BbamrIPW.js";
+import { Z as GRANT_FORMS } from "./dist-IdbnCDqM.js";
 import { closeSync, constants, fstatSync, openSync, readFileSync, realpathSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import { spawnSync } from "node:child_process";

package/dist/hooks.d.ts

@@ -1,4 +1,4 @@
-import { a as Decision, d as OpsEntry, g as Task, i as ChecklistItem, l as Issue, m as Session, n as ActionBlock, s as Finding, t as Action, u as Mainline } from "./index-DV6Gqu8K.js";
+import { a as Decision, d as OpsEntry, g as Task, i as ChecklistItem, l as Issue, m as Session, n as ActionBlock, s as Finding, t as Action, u as Mainline } from "./index-ihgXABQc.js";
 import { z } from "zod";
 //#region ../core/dist/ids/allocators.d.ts
 /** The letters ids start with. */
@@ -29,9 +29,9 @@ interface IdAllocator {
 /** What an operation needs from its caller besides its input. */
 interface OpContext {
   /**
-   * The caller's local time to the minute, like 2026-09-24T15:30. Dates and times an operation writes come
-   * from it, so an operation run where the clock is in another time zone, such as UTC in Workers, writes the
-   * same dates as one run on the caller's machine.
+   * The caller's local time to the minute with its offset from UTC, like 2026-09-24T15:30+08:00 (`Z` for UTC).
+   * Dates and times an operation writes come from it, so an operation run where the clock is in another time
+   * zone, such as UTC in Workers, writes the caller's dates, and its times keep the caller's offset.
    */
   now: string;
   /** Who numbers new entries (src/ids/); without one, the next free id, final at once */

package/dist/hooks.js

@@ -1,6 +1,6 @@
-import { D as endsWithMarker, E as decorateReply, G as loadHub, O as headerLine, S as readSession, T as matchGrants, W as HubError, b as turnReminder, et as readYaml, i as hostName, it as worktreesOf, k as mayDecorate, nt as currentBranch, ot as DATA_DIR, rt as findHubRoot, w as grantScope, x as loadSessions, y as sessionBriefing } from "./host-BJnrv8xF.js";
-import { Z as describeRequest, j as configSchema } from "./dist-BbamrIPW.js";
-import { n as hubWriter, r as writtenLines } from "./operation-Bp4U2bx3.js";
+import { $ as describeRequest, j as configSchema } from "./dist-IdbnCDqM.js";
+import { D as endsWithMarker, E as decorateReply, H as loadHub, O as headerLine, S as readSession, T as matchGrants, V as HubError, Z as readYaml, b as turnReminder, i as hostName, it as worktreesOf, k as mayDecorate, nt as currentBranch, ot as DATA_DIR, rt as findHubRoot, w as grantScope, x as loadSessions, y as sessionBriefing } from "./host-DmVNYRql.js";
+import { n as hubWriter, r as writtenLines } from "./operation-BQiUL0eq.js";
 import { resolveFixed, scanCommand, scopedCwd } from "./grant-commands.js";
 import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";

package/dist/{host-BJnrv8xF.js → host-DmVNYRql.js}

@@ -1,4 +1,4 @@
-import { $ as grantForm, A as WORK_STATUS, B as parseRef, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, F as issueSchema, G as taskSchema, H as refExample, I as mainlineSchema, K as waitingForAction, L as opsEntrySchema, M as decisionSchema, N as findingSchema, O as TASK_SECTIONS, P as formatOpsEntry, Q as grantCovers, R as parseActionRef, S as SESSION_ID, T as SURVEY_LINES, U as refMainline, V as parseUntil, W as sessionSchema, Z as describeRequest, _ as MERGE_STATES, a as DECISION_SECTIONS, b as RESERVED_HUB_NAMES, c as FINDING_SECTIONS, et as grantRepo, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, j as configSchema, l as FINDING_STATUS, n as CLOSED_STATUS, q as waitingForRef, r as DECIDERS, s as DEFAULT_CATEGORIES, tt as parseGrantTarget, w as SLUG, x as SERVES_REF, y as REF_EXAMPLES, z as parseOpsLine } from "./dist-BbamrIPW.js";
+import { $ as describeRequest, A as WORK_STATUS, B as parseRef, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, F as issueSchema, G as taskSchema, H as refExample, I as mainlineSchema, J as OFFSET, K as waitingForAction, L as opsEntrySchema, M as decisionSchema, N as findingSchema, O as TASK_SECTIONS, P as formatOpsEntry, R as parseActionRef, S as SESSION_ID, T as SURVEY_LINES, U as refMainline, V as parseUntil, W as sessionSchema, Y as stampMs, _ as MERGE_STATES, a as DECISION_SECTIONS, b as RESERVED_HUB_NAMES, c as FINDING_SECTIONS, et as grantCovers, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, j as configSchema, l as FINDING_STATUS, n as CLOSED_STATUS, nt as grantRepo, q as waitingForRef, r as DECIDERS, rt as parseGrantTarget, s as DEFAULT_CATEGORIES, tt as grantForm, w as SLUG, x as SERVES_REF, y as REF_EXAMPLES, z as parseOpsLine } from "./dist-IdbnCDqM.js";
 import { a as LABEL_ROLES, i as FINDING_SEVERITIES, n as FINDING_CLASSES, r as FINDING_FIELDS, t as FINDINGS_FENCE } from "./retro-formats-ECy0gGOL.js";
 import { createHash } from "node:crypto";
 import { appendFileSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, rmdirSync, statSync, symlinkSync, writeFileSync, writeSync } from "node:fs";
@@ -34,10 +34,10 @@ function splitFrontMatter(source) {
 	};
 }
 const contentHash = (text) => createHash("sha1").update(text).digest("hex");
-const MINUTE$1 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/;
-/** The day and the minute of the context's time, after checking its form. */
+const MINUTE$1 = new RegExp(`^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}${OFFSET}?$`);
+/** The day and the minute of the context's time, after checking its form. The minute keeps the offset the context has. */
 function stamps(ctx) {
-	if (!MINUTE$1.test(ctx.now)) throw new WriteError(`the operation time must look like 2026-09-24T15:30, got "${ctx.now}"`);
+	if (!MINUTE$1.test(ctx.now)) throw new WriteError(`the operation time must look like 2026-09-24T15:30+08:00, got "${ctx.now}"`);
 	return {
 		day: ctx.now.slice(0, 10),
 		minute: ctx.now
@@ -310,6 +310,36 @@ function editFrontMatter(draft, path, schema, mutate, expectedVersion) {
 	return next;
 }
 //#endregion
+//#region ../core/dist/ops/protocol.js
+/** `now` of a request: a local minute and its offset from UTC, `Z` for UTC itself. */
+const REQUEST_TIME = new RegExp(`^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2})(${OFFSET})$`);
+/** The local minute of a request's `now` without its offset, like 2026-10-06T15:30; null when `now` is not REQUEST_TIME. Operations stamp the whole `now` (stampOf in apply.ts). */
+function requestMinute(now) {
+	return typeof now === "string" ? REQUEST_TIME.exec(now)?.[1] ?? null : null;
+}
+/** `instant` as a request's `now`: the minute it is in this machine's time zone, with that zone's offset. */
+function requestTime(instant = /* @__PURE__ */ new Date()) {
+	const pad = (n) => String(n).padStart(2, "0");
+	const minute = `${instant.getFullYear()}-${pad(instant.getMonth() + 1)}-${pad(instant.getDate())}T${pad(instant.getHours())}:${pad(instant.getMinutes())}`;
+	const offset = -instant.getTimezoneOffset();
+	if (offset === 0) return `${minute}Z`;
+	const abs = Math.abs(offset);
+	return `${minute}${offset > 0 ? "+" : "-"}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
+}
+/** The routes, below the server's origin. `{hub}` is the hub's name, like carlos-space. */
+const ROUTES = {
+	/** GET, without a token: the protocol version this server speaks, `{ protocol }` */
+	version: "/version",
+	/** POST one request (SyncRequest), answered with its response and broadcast to the hub's connections when applied */
+	request: (hub) => `/hub/${hub}/request`,
+	/** GET `?protocol=2`: every file and directory of the hub (Snapshot). PUT: upload a whole hub (UploadRequest) */
+	snapshot: (hub) => `/hub/${hub}/snapshot`,
+	/** GET `?protocol=2` with `Upgrade: websocket`: receive every broadcast of the hub (ServerBroadcast) */
+	socket: (hub) => `/hub/${hub}/ws`
+};
+/** Every route below /hub/ needs this header as `Bearer <token>`, with the token of that hub. */
+const AUTHORIZATION = "authorization";
+//#endregion
 //#region ../core/dist/storage/node.js
 const LOCK_WAIT_MS = 5e3;
 const LOCK_STALE_MS = 3e4;
@@ -336,6 +366,7 @@ function removeIfEmpty(dir) {
 function holdLock(dir, fn) {
 	const lock = join(dir, "write.lock");
 	const deadline = Date.now() + LOCK_WAIT_MS;
+	let vanished = 0;
 	for (;;) try {
 		const fd = openSync(lock, "wx");
 		writeSync(fd, String(process.pid));
@@ -347,12 +378,13 @@ function holdLock(dir, fn) {
 			continue;
 		}
 		if (error.code !== "EEXIST") throw error;
-		if (Date.now() - statSync(lock, { throwIfNoEntry: false }).mtimeMs > LOCK_STALE_MS) {
+		const held = statSync(lock, { throwIfNoEntry: false });
+		if (held && Date.now() - held.mtimeMs > LOCK_STALE_MS) {
 			rmSync(lock, { force: true });
 			continue;
 		}
 		if (Date.now() > deadline) throw new WriteError(`hub is locked by another writer (${lock}); retry in a moment`);
-		sleep(50);
+		sleep(held ? 50 : Math.min(2 ** vanished++, 50));
 	}
 	try {
 		return fn();
@@ -402,18 +434,8 @@ function nodeStorage(root) {
 }
 //#endregion
 //#region ../core/dist/io.js
-/** Local time to the minute, the form sessions, actions and decisions use: 2026-09-24T15:30. */
-const nowMinute = () => {
-	const d = /* @__PURE__ */ new Date();
-	return `${d.toLocaleDateString("sv-SE")}T${d.toTimeString().slice(0, 5)}`;
-};
-/** Epoch milliseconds of a stamp in that form, read as local time. */
-const minuteMs = (stamp) => {
-	const [date = "", time = ""] = stamp.split("T");
-	const [y, m, d] = date.split("-").map(Number);
-	const [hh, mm] = time.split(":").map(Number);
-	return new Date(y, m - 1, d, hh, mm).getTime();
-};
+/** The time now to the minute with this machine's offset from UTC, the form sessions, actions and decisions use: 2026-09-24T15:30+08:00, or 2026-09-24T07:30Z in UTC. */
+const nowMinute = () => requestTime();
 /** The context an operation run from this machine gets: the local time, which is the user's. */
 const localContext = () => ({ now: nowMinute() });
 /** Run an operation on the hub at `root` under its write lock, apply its changes and return what it reports. */
@@ -866,7 +888,7 @@ function loadHub(root, options = {}) {
 	};
 	const config = read(join(dataDir, "config.yaml"), configSchema);
 	if (!config) throw new HubError("invalid config.yaml", problems);
-	if (config.formatVersion !== 2) throw new HubError(config.formatVersion < 2 ? `data format version ${config.formatVersion} is older than this CLI's (2); run "mainflow migrate --dry-run" to preview the conversion, then "mainflow migrate"` : `data format version ${config.formatVersion} is newer than this CLI supports (2); install the matching mainflow version in this hub`, problems);
+	if (config.formatVersion !== 3) throw new HubError(config.formatVersion < 3 ? `data format version ${config.formatVersion} is older than this CLI's (3); run "mainflow migrate --dry-run" to preview the conversion, then "mainflow migrate"` : `data format version ${config.formatVersion} is newer than this CLI supports (3); install the matching mainflow version in this hub`, problems);
 	problems.push(...repoPathProblems(root, config));
 	const categories = /* @__PURE__ */ new Set([...DEFAULT_CATEGORIES, ...config.categories ?? []]);
 	/** Read a Markdown document's front matter against `schema`, with the attributes every document shares. */
@@ -1394,7 +1416,7 @@ function initHub$1(hub, input) {
 	if (hub.read("config.yaml") !== null) throw new WriteError(`${hub.where("")} already holds a hub`);
 	const config = validate(configSchema, {
 		hub: input.name,
-		formatVersion: 2,
+		formatVersion: 3,
 		repos: {}
 	}, CONFIG_FILE);
 	const draft = new Draft(hub);
@@ -2493,7 +2515,7 @@ function migrateListItem(item) {
 }
 const openItem = (item) => !item.done && !item.dropped;
 /**
-* Convert a format 1 hub to the current format. The report lists what the changes write and remove; a dry
+* Convert a format 1 or 2 hub to the current format. Times already written are never changed. The report lists what the changes write and remove; a dry
 * run reports them without applying them.
 */
 function migrateHub$1(hub) {
@@ -2507,94 +2529,103 @@ function migrateHub$1(hub) {
 	const markdownIn = (dir) => hub.list(dir).map((e) => e.name).filter((n) => n.endsWith(".md"));
 	const config = parse$1(read(CONFIG_FILE));
 	const from = Number(config.formatVersion);
-	if (from === 2) throw new WriteError(`${rel(CONFIG_FILE)} is already format 2; nothing to migrate`);
-	if (from !== 1) throw new WriteError(`cannot migrate from format ${String(config.formatVersion)}; this CLI migrates format 1 to 2`);
+	if (from === 3) throw new WriteError(`${rel(CONFIG_FILE)} is already format 3; nothing to migrate`);
+	if (from !== 1 && from !== 2) throw new WriteError(`cannot migrate from format ${String(config.formatVersion)}; this CLI migrates format 1 or 2 to 3`);
 	const writes = /* @__PURE__ */ new Map();
 	const removes = [];
 	const missing = [];
 	const document = (file, schema, data, body) => {
 		writes.set(file, frontMatterText(validate(schema, data, rel(file)), body));
 	};
-	for (const mainlineDir of subdirs(MAINLINES_DIR)) {
-		const yamlFile = `${mainlineDir}/mainline.yaml`;
-		const yamlText = hub.read(yamlFile);
-		if (yamlText === null) continue;
-		const m = parse$1(yamlText);
-		dropNull(m, "archivedAt");
-		if (isClosed("mainline", m.status) && m.archivedAt) m.closedAt = m.archivedAt;
-		const criteria = (m.criteria ?? []).map(migrateListItem);
-		m.criteria = criteria;
-		const id = String(m.id);
-		const open = !isClosed("mainline", m.status);
-		if (open) {
-			for (const c of criteria) if (openItem(c) && !c.doneWhen) missing.push(`${id}#${c.id} doneWhen`);
-		}
-		const contextFile = `${mainlineDir}/context.md`;
-		const contextText = hub.read(contextFile);
-		const context = contextText === null ? "" : withoutTitle(contextText);
-		document(`${mainlineDir}/${MAINLINE_FILE}`, mainlineSchema, m, `\n${context.trimEnd()}\n`);
-		removes.push(yamlFile, ...contextText === null ? [] : [contextFile]);
-		for (const taskDir of subdirs(`${mainlineDir}/tasks`)) {
-			const taskYaml = `${taskDir}/task.yaml`;
-			const taskText = hub.read(taskYaml);
-			if (taskText === null) continue;
-			const t = parse$1(taskText);
-			const content = typeof t.content === "string" ? t.content.trim() : "";
-			drop(t, "content");
-			dropNull(t, "parent", "repo");
-			t.created ??= m.created;
-			const checklist = (t.checklist ?? []).map(migrateListItem);
-			t.checklist = checklist;
-			const doneDays = checklist.map((c) => c.doneAt).filter((d) => typeof d === "string").sort();
-			if (isClosed("task", t.status) && doneDays.length) t.closedAt = doneDays.at(-1);
-			let body = content ? withSection(TASK_BODY, "目標", content) : TASK_BODY;
-			const notesFile = `${taskDir}/notes.md`;
-			const notes = hub.read(notesFile);
-			if (notes !== null) {
-				body = foldNotes(body, notes);
-				removes.push(notesFile);
+	/** Format 1 to 2: documents are rewritten in their new shape and the old files removed. */
+	const convertFormat1 = () => {
+		for (const mainlineDir of subdirs(MAINLINES_DIR)) {
+			const yamlFile = `${mainlineDir}/mainline.yaml`;
+			const yamlText = hub.read(yamlFile);
+			if (yamlText === null) continue;
+			const m = parse$1(yamlText);
+			dropNull(m, "archivedAt");
+			if (isClosed("mainline", m.status) && m.archivedAt) m.closedAt = m.archivedAt;
+			const criteria = (m.criteria ?? []).map(migrateListItem);
+			m.criteria = criteria;
+			const id = String(m.id);
+			const open = !isClosed("mainline", m.status);
+			if (open) {
+				for (const c of criteria) if (openItem(c) && !c.doneWhen) missing.push(`${id}#${c.id} doneWhen`);
 			}
-			const taskRef = `${id}/${String(t.id)}`;
-			if (open && !isClosed("task", t.status)) {
-				for (const section of TASK_REQUIRED_SECTIONS) if (!sectionText(body, section)) missing.push(`${taskRef} ${section}`);
-				for (const c of checklist) if (openItem(c) && !c.doneWhen) missing.push(`${taskRef}#${c.id} doneWhen`);
+			const contextFile = `${mainlineDir}/context.md`;
+			const contextText = hub.read(contextFile);
+			const context = contextText === null ? "" : withoutTitle(contextText);
+			document(`${mainlineDir}/${MAINLINE_FILE}`, mainlineSchema, m, `\n${context.trimEnd()}\n`);
+			removes.push(yamlFile, ...contextText === null ? [] : [contextFile]);
+			for (const taskDir of subdirs(`${mainlineDir}/tasks`)) {
+				const taskYaml = `${taskDir}/task.yaml`;
+				const taskText = hub.read(taskYaml);
+				if (taskText === null) continue;
+				const t = parse$1(taskText);
+				const content = typeof t.content === "string" ? t.content.trim() : "";
+				drop(t, "content");
+				dropNull(t, "parent", "repo");
+				t.created ??= m.created;
+				const checklist = (t.checklist ?? []).map(migrateListItem);
+				t.checklist = checklist;
+				const doneDays = checklist.map((c) => c.doneAt).filter((d) => typeof d === "string").sort();
+				if (isClosed("task", t.status) && doneDays.length) t.closedAt = doneDays.at(-1);
+				let body = content ? withSection(TASK_BODY, "目標", content) : TASK_BODY;
+				const notesFile = `${taskDir}/notes.md`;
+				const notes = hub.read(notesFile);
+				if (notes !== null) {
+					body = foldNotes(body, notes);
+					removes.push(notesFile);
+				}
+				const taskRef = `${id}/${String(t.id)}`;
+				if (open && !isClosed("task", t.status)) {
+					for (const section of TASK_REQUIRED_SECTIONS) if (!sectionText(body, section)) missing.push(`${taskRef} ${section}`);
+					for (const c of checklist) if (openItem(c) && !c.doneWhen) missing.push(`${taskRef}#${c.id} doneWhen`);
+				}
+				document(`${taskDir}/${TASK_FILE}`, taskSchema, t, body);
+				removes.push(taskYaml);
+			}
+			const decisionsDir = `${mainlineDir}/decisions`;
+			for (const name of markdownIn(decisionsDir)) {
+				const file = `${decisionsDir}/${name}`;
+				const { data, body } = splitFrontMatter(read(file));
+				const d = data;
+				rename(d, "date", "created");
+				if (d.status !== "proposed") d.decidedAt = d.created;
+				dropNull(d, "supersededBy");
+				rename(d, "blocks", "affects");
+				document(file, decisionSchema, d, body);
 			}
-			document(`${taskDir}/${TASK_FILE}`, taskSchema, t, body);
-			removes.push(taskYaml);
-		}
-		const decisionsDir = `${mainlineDir}/decisions`;
-		for (const name of markdownIn(decisionsDir)) {
-			const file = `${decisionsDir}/${name}`;
-			const { data, body } = splitFrontMatter(read(file));
-			const d = data;
-			rename(d, "date", "created");
-			if (d.status !== "proposed") d.decidedAt = d.created;
-			dropNull(d, "supersededBy");
-			rename(d, "blocks", "affects");
-			document(file, decisionSchema, d, body);
-		}
-	}
-	const hubDocs = (dir, migrate, schema) => {
-		for (const name of markdownIn(dir)) {
-			const file = `${dir}/${name}`;
-			const { data, body } = splitFrontMatter(read(file));
-			migrate(data);
-			document(file, schema, data, body);
 		}
+		const hubDocs = (dir, migrate, schema) => {
+			for (const name of markdownIn(dir)) {
+				const file = `${dir}/${name}`;
+				const { data, body } = splitFrontMatter(read(file));
+				migrate(data);
+				document(file, schema, data, body);
+			}
+		};
+		hubDocs(ISSUES_DIR, (i) => rename(i, "closedBy", "resolution"), issueSchema);
+		hubDocs(FINDINGS_DIR, (f) => {
+			rename(f, "date", "created");
+			rename(f, "tags", "labels");
+		}, findingSchema);
 	};
-	hubDocs(ISSUES_DIR, (i) => rename(i, "closedBy", "resolution"), issueSchema);
-	hubDocs(FINDINGS_DIR, (f) => {
-		rename(f, "date", "created");
-		rename(f, "tags", "labels");
-	}, findingSchema);
-	config.formatVersion = 2;
-	writes.set(CONFIG_FILE, toYaml(validate(configSchema, config, rel(CONFIG_FILE))));
+	if (from === 1) convertFormat1();
+	const configText = read(CONFIG_FILE);
+	const versionLine = /^formatVersion:[ \t]*2[ \t]*$/m;
+	config.formatVersion = 3;
+	if (from === 2 && versionLine.test(configText)) {
+		validate(configSchema, config, rel(CONFIG_FILE));
+		writes.set(CONFIG_FILE, configText.replace(versionLine, `formatVersion: 3`));
+	} else writes.set(CONFIG_FILE, toYaml(validate(configSchema, config, rel(CONFIG_FILE))));
 	const draft = new Draft(hub);
 	for (const [file, text] of writes) draft.write(file, text);
 	for (const file of removes) draft.remove(file);
 	return draft.result({
 		from,
-		to: 2,
+		to: 3,
 		written: [...writes.keys()].map(rel),
 		removed: removes.map(rel),
 		missingDefinitions: missing
@@ -2656,36 +2687,6 @@ function applyOperation(storage, name, input, ctx) {
 	return applyOp(storage, (hub) => operation(hub, input, ctx));
 }
 //#endregion
-//#region ../core/dist/ops/protocol.js
-/** `now` of a request: a local minute and its offset from UTC, `Z` for UTC itself. */
-const REQUEST_TIME = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2})(Z|[+-]\d{2}:\d{2})$/;
-/** The local minute of a request's `now`, like 2026-10-06T15:30, which an operation stamps; null when `now` is not REQUEST_TIME. */
-function requestMinute(now) {
-	return typeof now === "string" ? REQUEST_TIME.exec(now)?.[1] ?? null : null;
-}
-/** `instant` as a request's `now`: the minute it is in this machine's time zone, with that zone's offset. */
-function requestTime(instant = /* @__PURE__ */ new Date()) {
-	const pad = (n) => String(n).padStart(2, "0");
-	const minute = `${instant.getFullYear()}-${pad(instant.getMonth() + 1)}-${pad(instant.getDate())}T${pad(instant.getHours())}:${pad(instant.getMinutes())}`;
-	const offset = -instant.getTimezoneOffset();
-	if (offset === 0) return `${minute}Z`;
-	const abs = Math.abs(offset);
-	return `${minute}${offset > 0 ? "+" : "-"}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
-}
-/** The routes, below the server's origin. `{hub}` is the hub's name, like carlos-space. */
-const ROUTES = {
-	/** GET, without a token: the protocol version this server speaks, `{ protocol }` */
-	version: "/version",
-	/** POST one request (SyncRequest), answered with its response and broadcast to the hub's connections when applied */
-	request: (hub) => `/hub/${hub}/request`,
-	/** GET `?protocol=2`: every file and directory of the hub (Snapshot). PUT: upload a whole hub (UploadRequest) */
-	snapshot: (hub) => `/hub/${hub}/snapshot`,
-	/** GET `?protocol=2` with `Upgrade: websocket`: receive every broadcast of the hub (ServerBroadcast) */
-	socket: (hub) => `/hub/${hub}/ws`
-};
-/** Every route below /hub/ needs this header as `Bearer <token>`, with the token of that hub. */
-const AUTHORIZATION = "authorization";
-//#endregion
 //#region ../core/dist/ids/renumber.js
 /** The id at the end of a reference: c003 in m001/t002#c003, a002 in claude-code-1a2b3c4d#a002. */
 const lastId = (ref) => /([a-z]\d{3})$/.exec(ref)?.[1] ?? "";
@@ -2791,11 +2792,10 @@ function renumberFiles(hub, paths, renumbered) {
 }
 //#endregion
 //#region ../core/dist/ops/apply.js
-/** The local minute an operation stamps, from a request's `now`; a `now` without its offset is refused. */
-function minuteOf(now) {
-	const minute = requestMinute(now);
-	if (minute === null) throw new WriteError(`the request time must be a local minute with its offset from UTC, like 2026-10-06T15:30+08:00 (${REQUEST_TIME.source}); got "${String(now)}"`);
-	return minute;
+/** The time an operation stamps, from a request's `now`: the sender's local minute with its offset, UTC as `Z`. A `now` without the offset is refused. */
+function stampOf(now) {
+	if (requestMinute(now) === null) throw new WriteError(`the request time must be a local minute with its offset from UTC, like 2026-10-06T15:30+08:00 (${REQUEST_TIME.source}); got "${String(now)}"`);
+	return now.replace(/[+-]00:00$/, "Z");
 }
 /**
 * Apply a request to an offline copy of the hub, numbering new entries provisionally, and return the request to
@@ -2804,7 +2804,7 @@ function minuteOf(now) {
 */
 function applyOffline(storage, request) {
 	const result = applyOperation(storage, request.op, request.input, {
-		now: minuteOf(request.now),
+		now: stampOf(request.now),
 		ids: offlineIds
 	});
 	return {
@@ -3034,8 +3034,8 @@ function summarize$1(entries) {
 function attributeTrace(trace, actions, now = Date.now()) {
 	const windows = actions.filter((a) => a.startedAt).map((a) => ({
 		id: a.id,
-		from: minuteMs(a.startedAt),
-		to: a.doneAt ? minuteMs(a.doneAt) + 6e4 : now
+		from: stampMs(a.startedAt),
+		to: a.doneAt ? stampMs(a.doneAt) + 6e4 : now
 	}));
 	const grouped = {};
 	const rest = [];
@@ -4803,13 +4803,13 @@ function actionTimeline(session, stamps) {
 		if (a.status !== "todo" && a.startedAt && !stamped(a, ["doing"])) events.push({
 			action: a.id,
 			status: "doing",
-			at: minuteMs(a.startedAt),
+			at: stampMs(a.startedAt),
 			order: events.length
 		});
 		if (a.doneAt && (a.status === "done" || a.status === "dropped") && !stamped(a, ["done", "dropped"])) events.push({
 			action: a.id,
 			status: a.status,
-			at: minuteMs(a.doneAt) + MINUTE,
+			at: stampMs(a.doneAt) + MINUTE,
 			order: events.length
 		});
 	}
@@ -7297,4 +7297,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { nowMinute as $, attributeTrace as A, ROUTES as B, transcriptPath as C, endsWithMarker as D, decorateReply as E, renumberFiles as F, loadHub as G, applyOperation as H, renumberPath as I, linksInto as J, dependencyGraph as K, renumberText as L, transcriptTitle as M, applyOffline as N, headerLine as O, renumberRequest as P, requireSlug as Q, scopeOfPath as R, readSession as S, matchGrants as T, checkHubName as U, requestTime as V, HubError as W, MAINLINE_FILE as X, refIndex as Y, TASK_FILE as Z, untilState as _, openInApp as a, ConflictError as at, turnReminder as b, syncHost as c, contentHash as ct, retroReportFromReceiver as d, readYaml as et, receiverFromEnv as f, initHub as g, setArchivedMany as h, hostName as i, worktreesOf as it, traceTranscript as j, mayDecorate as k, migrateHub as l, ARCHIVE_KINDS as m, DEFAULT_UI_PORT as n, currentBranch as nt, removeHostLink as o, DATA_DIR as ot, RETRY_RULES as p, mainlineEdges as q, caddySites as r, findHubRoot as rt, siteBlock as s, WriteError as st, APP_BUNDLE_ID as t, nodeStorage as tt, retroReport as u, duplicateClaimLines as v, grantScope as w, loadSessions as x, sessionBriefing as y, AUTHORIZATION as z };
+export { AUTHORIZATION as $, attributeTrace as A, checkHubName as B, transcriptPath as C, endsWithMarker as D, decorateReply as E, renumberFiles as F, linksInto as G, loadHub as H, renumberPath as I, TASK_FILE as J, refIndex as K, renumberText as L, transcriptTitle as M, applyOffline as N, headerLine as O, renumberRequest as P, nodeStorage as Q, scopeOfPath as R, readSession as S, matchGrants as T, dependencyGraph as U, HubError as V, mainlineEdges as W, nowMinute as X, requireSlug as Y, readYaml as Z, untilState as _, openInApp as a, ConflictError as at, turnReminder as b, syncHost as c, contentHash as ct, retroReportFromReceiver as d, ROUTES as et, receiverFromEnv as f, initHub as g, setArchivedMany as h, hostName as i, worktreesOf as it, traceTranscript as j, mayDecorate as k, migrateHub as l, ARCHIVE_KINDS as m, DEFAULT_UI_PORT as n, currentBranch as nt, removeHostLink as o, DATA_DIR as ot, RETRY_RULES as p, MAINLINE_FILE as q, caddySites as r, findHubRoot as rt, siteBlock as s, WriteError as st, APP_BUNDLE_ID as t, requestTime as tt, retroReport as u, duplicateClaimLines as v, grantScope as w, loadSessions as x, sessionBriefing as y, applyOperation as z };

package/dist/host.js

@@ -1,2 +1,2 @@
-import { a as openInApp, c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, r as caddySites, s as siteBlock, t as APP_BUNDLE_ID } from "./host-BJnrv8xF.js";
+import { a as openInApp, c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, r as caddySites, s as siteBlock, t as APP_BUNDLE_ID } from "./host-DmVNYRql.js";
 export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, removeHostLink, siteBlock, syncHost };

package/dist/{index-DV6Gqu8K.d.ts → index-ihgXABQc.d.ts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 //#region ../schema/dist/index.d.ts
-declare const FORMAT_VERSION = 2;
+declare const FORMAT_VERSION = 3;
 declare const ID_PATTERNS: {
   readonly mainline: RegExp;
   readonly task: RegExp;

package/dist/{launch-DefacJEL.js → launch-DHug6eli.js}

@@ -1,4 +1,4 @@
-import { c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, ot as DATA_DIR, st as WriteError } from "./host-BJnrv8xF.js";
+import { c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, ot as DATA_DIR, st as WriteError } from "./host-DmVNYRql.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -176,7 +176,7 @@ async function launchUi(root, hub, configured, options) {
 	}
 	let server;
 	if (!reuse) {
-		const { serveUi } = await import("./ui-CiapFoik.js");
+		const { serveUi } = await import("./ui-BqRmaHXn.js");
 		server = await serveUi(root, choice.port);
 		writeUiRecord(root, {
 			port: choice.port,

package/dist/launch.js

@@ -1,2 +1,2 @@
-import { a as portCandidates, c as watchHubGone, i as networkProbe, n as choosePort, o as readUiRecord, r as launchUi, s as startUiInBackground, t as PORT_SPAN } from "./launch-DefacJEL.js";
+import { a as portCandidates, c as watchHubGone, i as networkProbe, n as choosePort, o as readUiRecord, r as launchUi, s as startUiInBackground, t as PORT_SPAN } from "./launch-DHug6eli.js";
 export { PORT_SPAN, choosePort, launchUi, networkProbe, portCandidates, readUiRecord, startUiInBackground, watchHubGone };