mainflow 0.34.0 → 0.35.0

package/dist/{host-79T-_NMu.js → host-bnHYIwuY.js}

@@ -1,4 +1,4 @@
-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 { $ as OFFSET, A as SURVEY_SECTION, B as issueSchema, C as REF_EXAMPLES, D as SESSION_STATUS, E as SESSION_ID, F as configSchema, G as parseRef, H as opsEntrySchema, I as decisionSchema, J as refMainline, K as parseUntil, L as findingSchema, M as TASK_SECTIONS, O as SLUG, P as WORK_STATUS, Q as waitingForRef, R as formatOpsEntry, S as PRIORITIES, T as SERVES_REF, U as parseActionRef, V as mainlineSchema, W as parseOpsLine, X as taskSchema, Y as sessionSchema, Z as waitingForAction, a as DECISION_SECTIONS, at as grantCovers, b as MAINLINE_STATUS, ct as parseGrantTarget, et as stampMs, f as GROUP_SECTIONS, h as ISSUE_SECTIONS, i as DECISION_BASES, it as describeRequest, j as TASK_REQUIRED_SECTIONS, k as SURVEY_LINES, l as FINDING_SECTIONS, n as CLOSED_STATUS, ot as grantForm, p as GROUP_STATUS, q as refExample, r as DECIDERS, s as DEFAULT_CATEGORIES, st as grantRepo, u as FINDING_STATUS, v as MAINLINE_ROLES, w as RESERVED_HUB_NAMES, x as MERGE_STATES, y as MAINLINE_SECTIONS, z as groupSchema } from "./dist-BdvWGTsb.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";
@@ -10,7 +10,7 @@ import { performance } from "node:perf_hooks";
 import { gunzipSync, inflateRawSync } from "node:zlib";
 //#region ../core/dist/ops/document.js
 const DATA_DIR = ".mainflow";
-const ENTRY_DIR = /^([mtdif]\d{3})-(.+)$/;
+const ENTRY_DIR = /^([mtdifw]\d{3})-(.+)$/;
 var WriteError = class extends Error {};
 /** The file changed after the caller read it; the caller must reload and retry. */
 var ConflictError = class extends WriteError {};
@@ -315,6 +315,7 @@ const MAINLINES_DIR = "mainlines";
 const CONFIG_FILE = "config.yaml";
 const ISSUES_DIR = "issues";
 const FINDINGS_DIR = "findings";
+const GROUPS_DIR = "groups";
 const SESSIONS_DIR = "local/sessions";
 /** The document inside each mainline and task directory: front matter for attributes, body for prose. */
 const MAINLINE_FILE = "mainline.md";
@@ -667,6 +668,11 @@ function refIndex(hub) {
 		title: f.title,
 		status: f.status
 	});
+	for (const g of hub.groups ?? []) index.set(g.id, {
+		kind: "group",
+		title: g.title,
+		status: g.status
+	});
 	return index;
 }
 const isHubRoot = (dir) => existsSync(join(dir, DATA_DIR, "config.yaml"));
@@ -697,6 +703,7 @@ function linksInto(hub, hubName) {
 	}
 	for (const i of hub.issues) add(i.id, i.links);
 	for (const f of hub.findings) add(f.id, f.links);
+	for (const g of hub.groups) add(g.id, g.links);
 	return out;
 }
 //#endregion
@@ -742,7 +749,11 @@ function dependencyGraph(hub) {
 			}));
 		}
 	}
-	for (const d of [...hub.issues, ...hub.findings]) links(d.id, d.file, d.links);
+	for (const d of [
+		...hub.issues,
+		...hub.findings,
+		...hub.groups ?? []
+	]) links(d.id, d.file, d.links);
 	for (const remote of hub.remotes ?? []) {
 		if (!remote.hub) continue;
 		for (const { to, link } of linksInto(remote.hub, hub.config.hub)) if (link.rel === "depends-on") edge(`${remote.name}:${link.from}`, to, "link", link.note ? { note: link.note } : {});
@@ -774,7 +785,7 @@ function findCycles(edges) {
 	for (const node of [...next.keys()].sort()) if (!state.has(node)) visit(node);
 	return [...cycles.values()];
 }
-/** The mainline a reference sits in, keeping another hub's prefix; undefined for issues and findings. */
+/** The mainline a reference sits in, keeping another hub's prefix; undefined for issues, findings and groups. */
 function mainlineOf(ref) {
 	const parsed = parseRef(ref);
 	const m = parsed ? refMainline(parsed) : void 0;
@@ -885,6 +896,7 @@ const TASK_BODY = body(TASK_SECTIONS);
 const DECISION_BODY = body(DECISION_SECTIONS);
 const ISSUE_BODY = body(ISSUE_SECTIONS);
 const FINDING_BODY = body(FINDING_SECTIONS);
+const GROUP_BODY = body(GROUP_SECTIONS);
 /** The text under `## {heading}` up to the next H2, trimmed; null when the heading is missing. */
 function sectionText(markdown, heading) {
 	const lines = markdown.split("\n");
@@ -936,6 +948,33 @@ function withSection(markdown, heading, text) {
 }
 //#endregion
 //#region ../core/dist/load.js
+/**
+* Read config.yaml and check its format version; throws a HubError naming what is wrong when the hub cannot be
+* used at all. The interface answers 503 for it before loading anything else (docs/ui.md "壞檔與讀取失敗").
+*/
+function loadConfig(root) {
+	const file = join(root, DATA_DIR, "config.yaml");
+	const where = relative(root, file);
+	let data;
+	try {
+		data = parse$1(readText(file) ?? "");
+	} catch (error) {
+		throw new HubError("invalid config.yaml", [{
+			file: where,
+			field: "",
+			message: `cannot parse YAML: ${error.message}`
+		}]);
+	}
+	const result = configSchema.safeParse(data);
+	if (!result.success) throw new HubError("invalid config.yaml", result.error.issues.map((issue) => ({
+		file: where,
+		field: issue.path.join("."),
+		message: issue.message
+	})));
+	const config = result.data;
+	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`, []);
+	return config;
+}
 function loadHub(root, options = {}) {
 	const problems = [];
 	const warnings = [];
@@ -975,9 +1014,7 @@ function loadHub(root, options = {}) {
 			message: `directory name must be "${id}-{slug}" in kebab-case`
 		});
 	};
-	const config = read(join(dataDir, "config.yaml"), configSchema);
-	if (!config) throw new HubError("invalid config.yaml", 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);
+	const config = loadConfig(root);
 	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. */
@@ -1127,6 +1164,9 @@ function loadHub(root, options = {}) {
 		});
 	}
 	const findings = hubDocs(join(dataDir, "findings"), findingSchema);
+	const groups = hubDocs(join(dataDir, "groups"), groupSchema);
+	problems.push(...groupProblems(groups, mainlines, hubIssues, unreadable));
+	warnings.push(...groupWarnings(groups, mainlines, hubIssues));
 	const ops = [];
 	const opsPath = join(dataDir, "ops");
 	for (const name of existsSync(opsPath) ? readdirSync(opsPath).filter((n) => n.endsWith(".log")).sort() : []) readFileSync(join(opsPath, name), "utf8").split("\n").forEach((line, index) => {
@@ -1150,6 +1190,7 @@ function loadHub(root, options = {}) {
 		mainlines,
 		issues: hubIssues,
 		findings,
+		groups,
 		remotes,
 		pending,
 		unreadable,
@@ -1160,6 +1201,7 @@ function loadHub(root, options = {}) {
 		mainlines,
 		issues: hubIssues,
 		findings,
+		groups,
 		remotes
 	});
 	for (const cycle of deps.cycles) {
@@ -1189,12 +1231,34 @@ function loadHub(root, options = {}) {
 		mainlines,
 		issues: hubIssues,
 		findings,
+		groups,
 		ops,
 		problems,
 		warnings,
 		remotes
 	};
 }
+/** Members name their group; one that names a group this hub does not have is reported on the member. */
+function groupProblems(groups, mainlines, issues, unreadable) {
+	const known = new Set(groups.map((g) => g.id));
+	return [...mainlines, ...issues].flatMap((doc) => doc.group && !known.has(doc.group) && !unreadable.has(doc.group) ? [{
+		file: doc.file,
+		field: "group",
+		message: `group ${doc.group} does not exist; create it with "mainflow new group <slug> --title <title>" or name an existing one`
+	}] : []);
+}
+/** A group marked done while some of its members are still open: a plan to settle, not a broken file. */
+function groupWarnings(groups, mainlines, issues) {
+	return groups.flatMap((g) => {
+		if (g.status !== "done") return [];
+		const open = [...mainlines.filter((m) => m.group === g.id && isOpen$2("mainline", m.status)).map((m) => m.id), ...issues.filter((i) => i.group === g.id && i.status !== "closed").map((i) => i.id)];
+		return open.length ? [{
+			file: g.file,
+			field: "status",
+			message: `group ${g.id} is done but ${open.join(", ")} ${open.length === 1 ? "is" : "are"} still open; settle ${open.length === 1 ? "it" : "them"} or reopen the group`
+		}] : [];
+	});
+}
 /** Load every hub registered in config.yaml, read-only and without its own remotes. */
 function loadRemotes(root, config, problems, warnings) {
 	const file = `${DATA_DIR}/config.yaml`;
@@ -1263,7 +1327,7 @@ function loadRemotes(root, config, problems, warnings) {
 * Links are for relations across mainlines; inside one mainline, parent, dependsOn and affects say it.
 */
 function checkReferences(input) {
-	const { config, mainlines, issues, findings, remotes, pending, unreadable, problems } = input;
+	const { config, mainlines, issues, findings, groups, remotes, pending, unreadable, problems } = input;
 	/** A target inside a document that failed to load: its schema problem is already reported. */
 	const inUnreadable = (target) => [
 		target,
@@ -1273,7 +1337,8 @@ function checkReferences(input) {
 	const local = refIndex({
 		mainlines,
 		issues,
-		findings
+		findings,
+		groups
 	});
 	const remoteIndex = new Map(remotes.map((r) => [r.name, r.hub ? refIndex(r.hub) : null]));
 	/** The document's own mainline, when it sits in one; links may not point back into it. */
@@ -1326,6 +1391,7 @@ function checkReferences(input) {
 	}
 	for (const i of issues) add(i.file, i, i.id);
 	for (const f of findings) add(f.file, f, f.id);
+	for (const g of groups) add(g.file, g, g.id);
 	for (const p of pending) {
 		const parsed = parseRef(p.ref);
 		if (!parsed) continue;
@@ -1545,6 +1611,249 @@ function addHub(hub, input) {
 	return draft.result(input.name);
 }
 //#endregion
+//#region ../core/dist/ops/hub-items.js
+function entryFile(hub, dir, id, what) {
+	const file = entryFileIn(hub, dir, id);
+	if (!file) throw new WriteError(`${what} ${id} not found`);
+	return file;
+}
+/**
+* Any reference the schema accepts must also point at something that exists. A reference into another
+* hub only needs that hub registered here; check verifies the target when that hub is on this machine.
+*/
+function requireExisting(hub, ref) {
+	const parsed = parseRef(ref);
+	if (!parsed) throw new WriteError(`"${ref}" is not a reference like ${REF_EXAMPLES}`);
+	const config = readConfigIn(hub);
+	if (parsed.hub !== void 0 && parsed.hub !== config.hub) {
+		if (!config.hubs?.[parsed.hub]) throw new WriteError(`hub "${parsed.hub}" is not registered; run "mainflow hub add ${parsed.hub} <path>" first`);
+		return;
+	}
+	switch (parsed.kind) {
+		case "issue":
+			entryFile(hub, ISSUES_DIR, parsed.issue, "issue");
+			return;
+		case "finding":
+			entryFile(hub, FINDINGS_DIR, parsed.finding, "finding");
+			return;
+		case "group":
+			entryFile(hub, GROUPS_DIR, parsed.group, "group");
+			return;
+		default:
+			mainlineDirIn(hub, parsed.mainline);
+			if ("task" in parsed) taskDirIn(hub, parsed.mainline, parsed.task);
+			if (parsed.kind === "decision") decisionFileIn(hub, parsed.mainline, parsed.decision);
+	}
+}
+/** A priority as a command gives it, checked against P0 to P3. */
+const requirePriority = (value) => requireOneOf(value, PRIORITIES, "priority");
+/**
+* The group a member names, which must exist in this hub. `none` clears the membership; `null` is how a patch says
+* the same, so a command can pass the word and an interface the value.
+*/
+function requireGroup(hub, value) {
+	const ref = requireRef(value, "group");
+	if (ref.hub !== void 0) throw new WriteError(`a group is one of this hub's, like w001; got "${value}"`);
+	entryFile(hub, GROUPS_DIR, ref.group, "group");
+	return ref.group;
+}
+/** Whether a patch clears the group: `none` from a command, or null. */
+const clearsGroup = (value) => value === null || value === "none";
+function createIssue(hub, input, ctx) {
+	requireSlug(input.slug);
+	if (input.origin) requireExisting(hub, input.origin);
+	const group = input.group ? requireGroup(hub, input.group) : void 0;
+	const priority = input.priority ? requirePriority(input.priority) : void 0;
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	const id = draft.number(ctx, {
+		prefix: "i",
+		taken: idsIn(draft, ISSUES_DIR),
+		ref: (id) => id
+	});
+	const issue = validate(issueSchema, {
+		id,
+		title: input.title,
+		status: "open",
+		...priority ? { priority } : {},
+		created: day,
+		...input.origin ? { origin: input.origin } : {},
+		...input.labels?.length ? { labels: input.labels } : {},
+		...group ? { group } : {}
+	}, "issue");
+	const file = `${ISSUES_DIR}/${id}-${input.slug}.md`;
+	draft.write(file, frontMatterText(issue, ISSUE_BODY));
+	return draft.result({
+		id,
+		file
+	});
+}
+function setIssue(hub, input) {
+	const { patch } = input;
+	if (patch.group === void 0 && patch.priority === void 0) throw new WriteError(`${input.id} needs --group or --priority, e.g. --group w001`);
+	const draft = new Draft(hub);
+	const group = patch.group === void 0 || clearsGroup(patch.group) ? void 0 : requireGroup(draft, patch.group);
+	const priority = patch.priority === void 0 ? void 0 : requirePriority(patch.priority);
+	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
+		if (group) i.group = group;
+		else if (clearsGroup(patch.group)) delete i.group;
+		if (priority) i.priority = priority;
+	}, input.expectedVersion));
+}
+/** Schedule an issue into the task that will carry it out. */
+function planIssue(hub, input) {
+	const ref = requireRef(input.task, "task");
+	const draft = new Draft(hub);
+	taskDirIn(draft, ref.mainline, ref.task);
+	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
+		i.status = "planned";
+		i.plannedIn = input.task;
+	}, input.expectedVersion));
+}
+function closeIssue(hub, input, ctx) {
+	if (!input.resolution) throw new WriteError(`closing ${input.id} needs what closed it, e.g. --by "mainflow@3fdd5ac" or --by "不再需要"`);
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
+		i.status = "closed";
+		i.resolution = input.resolution;
+		i.closedAt ??= day;
+	}, input.expectedVersion));
+}
+function reopenIssue(hub, input) {
+	const draft = new Draft(hub);
+	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
+		i.status = "open";
+		delete i.plannedIn;
+		delete i.resolution;
+		delete i.closedAt;
+	}, input.expectedVersion));
+}
+/** Archive or unarchive an issue; the status stays as it is, so a closed issue is visible until archived. */
+function setIssueArchived(hub, input, ctx) {
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
+		if (input.archived) i.archivedAt ??= day;
+		else delete i.archivedAt;
+	}, input.expectedVersion));
+}
+function createFinding(hub, input, ctx) {
+	requireSlug(input.slug);
+	if (input.origin) requireExisting(hub, input.origin);
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	const id = draft.number(ctx, {
+		prefix: "f",
+		taken: idsIn(draft, FINDINGS_DIR),
+		ref: (id) => id
+	});
+	const finding = validate(findingSchema, {
+		id,
+		title: input.title,
+		status: "valid",
+		created: day,
+		...input.origin ? { origin: input.origin } : {},
+		...input.labels?.length ? { labels: input.labels } : {}
+	}, "finding");
+	const file = `${FINDINGS_DIR}/${id}-${input.slug}.md`;
+	draft.write(file, frontMatterText(finding, FINDING_BODY));
+	return draft.result({
+		id,
+		file
+	});
+}
+function setFindingStatus(hub, input, ctx) {
+	const value = requireOneOf(input.status, FINDING_STATUS, "finding status");
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	return draft.result(editFrontMatter(draft, entryFile(draft, FINDINGS_DIR, input.id, "finding"), findingSchema, (f) => {
+		f.status = value;
+		if (value === "obsolete") f.closedAt ??= day;
+		else delete f.closedAt;
+	}, input.expectedVersion));
+}
+/** Archive or unarchive a finding; the status stays as it is, so an obsolete finding is visible until archived. */
+function setFindingArchived(hub, input, ctx) {
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	return draft.result(editFrontMatter(draft, entryFile(draft, FINDINGS_DIR, input.id, "finding"), findingSchema, (f) => {
+		if (input.archived) f.archivedAt ??= day;
+		else delete f.archivedAt;
+	}, input.expectedVersion));
+}
+/**
+* A group gathers mainlines and issues that are taken up together, apart from what depends on what. Its members name
+* it in their own `group`, so creating a group writes only the group's file.
+*/
+function createGroup(hub, input, ctx) {
+	requireSlug(input.slug);
+	if (input.origin) requireExisting(hub, input.origin);
+	const priority = input.priority ? requirePriority(input.priority) : void 0;
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	const id = draft.number(ctx, {
+		prefix: "w",
+		taken: idsIn(draft, GROUPS_DIR),
+		ref: (id) => id
+	});
+	const group = validate(groupSchema, {
+		id,
+		title: input.title,
+		status: "open",
+		...priority ? { priority } : {},
+		created: day,
+		...input.origin ? { origin: input.origin } : {},
+		...input.labels?.length ? { labels: input.labels } : {},
+		...input.trigger?.trim() ? { trigger: input.trigger.trim() } : {}
+	}, "group");
+	const file = `${GROUPS_DIR}/${id}-${input.slug}.md`;
+	draft.write(file, frontMatterText(group, GROUP_BODY));
+	return draft.result({
+		id,
+		file
+	});
+}
+function setGroup(hub, input, ctx) {
+	const { patch } = input;
+	requireRef(input.id, "group");
+	if (Object.values(patch).every((v) => v === void 0)) throw new WriteError(`${input.id} needs --status, --priority, --trigger or --title, e.g. --status done`);
+	const status = patch.status === void 0 ? void 0 : requireOneOf(patch.status, GROUP_STATUS, "group status");
+	const priority = patch.priority === void 0 ? void 0 : requirePriority(patch.priority);
+	const title = patch.title?.replace(/\s+/g, " ").trim();
+	if (patch.title !== void 0 && !title) throw new WriteError(`${input.id} needs a title, e.g. --title "量測修正"`);
+	const { day } = stamps(ctx);
+	const draft = new Draft(hub);
+	return draft.result(editFrontMatter(draft, entryFile(draft, GROUPS_DIR, input.id, "group"), groupSchema, (g) => {
+		if (status) {
+			g.status = status;
+			stampClosed(g, closes("group", status), day);
+		}
+		if (priority) g.priority = priority;
+		if (title) g.title = title;
+		if (patch.trigger !== void 0) {
+			if (patch.trigger.trim()) g.trigger = patch.trigger.trim();
+			else delete g.trigger;
+		}
+	}, input.expectedVersion));
+}
+/** Append one external operation to ops/{YYYY-MM}.log; the log is never rewritten. `at` defaults to the context's time. */
+function appendOps(hub, input, ctx) {
+	if (input.ref) requireExisting(hub, input.ref);
+	const entry = validate(opsEntrySchema, {
+		...input,
+		at: input.at ?? stamps(ctx).minute
+	}, "ops entry");
+	for (const field of [
+		"target",
+		"operation",
+		"result"
+	]) if (entry[field].includes(" | ")) throw new WriteError(`${field} cannot contain " | ", the ops log's separator`);
+	const draft = new Draft(hub);
+	draft.append(`ops/${entry.at.slice(0, 7)}.log`, `${formatOpsEntry(entry)}\n`);
+	return draft.result(entry);
+}
+//#endregion
 //#region ../core/dist/ops/mainlines.js
 /** Every file below `dir`, sorted, skipping dot files. */
 function listFilesIn(hub, dir) {
@@ -1552,6 +1861,9 @@ function listFilesIn(hub, dir) {
 }
 function createMainline(hub, input, ctx) {
 	requireSlug(input.slug);
+	const group = input.group ? requireGroup(hub, input.group) : void 0;
+	const role = input.role ? requireOneOf(input.role, MAINLINE_ROLES, "mainline role") : void 0;
+	const priority = input.priority ? requirePriority(input.priority) : void 0;
 	const { day } = stamps(ctx);
 	const draft = new Draft(hub);
 	const id = draft.number(ctx, {
@@ -1564,7 +1876,10 @@ function createMainline(hub, input, ctx) {
 		id,
 		title: input.title,
 		status: "planning",
+		...priority ? { priority } : {},
 		created: day,
+		...group ? { group } : {},
+		...role ? { role } : {},
 		criteria: []
 	}, MAINLINE_FILE);
 	draft.makeDir(`${dir}/tasks`);
@@ -1589,16 +1904,50 @@ function requireDone(hub, id, m) {
 	if (!open.length && !proposed.length) return;
 	throw new WriteError(`${id} cannot be marked done: ${[open.length ? `unmet criteria ${open.join(", ")} (check each with evidence, e.g. criterion check ${open[0]} --evidence <commit>, or reword or drop it in ${MAINLINE_FILE})` : "", proposed.length ? `proposed decisions ${proposed.join(", ")} (decision accept or decision supersede first)` : ""].filter(Boolean).join("; ")}`);
 }
-/** Move a mainline to another status; done is refused while criteria are open or decisions are proposed. */
-function setMainlineStatus(hub, input, ctx) {
+/**
+* Work starting on a mainline that is still planning moves it to active, in the same draft as the work's own
+* change. It only goes up: any other status is left as it is, and a mainline that cannot be found is skipped.
+*/
+function activatePlanning(draft, id) {
+	let path;
+	try {
+		path = mainlineFileIn(draft, id);
+	} catch (error) {
+		if (error instanceof WriteError) return;
+		throw error;
+	}
+	const { data } = splitFrontMatter(draft.read(path) ?? "");
+	if (data?.status !== "planning") return;
+	editFrontMatter(draft, path, mainlineSchema, (m) => void (m.status = "active"));
+}
+/**
+* Change a mainline's status, group, role or priority. Done is refused while criteria are open or decisions are
+* proposed; the other fields change without conditions, in the same write.
+*/
+function setMainline(hub, input, ctx) {
 	requireRef(input.id, "mainline");
-	const next = requireOneOf(input.status, MAINLINE_STATUS, "mainline status");
+	if ([
+		input.status,
+		input.group,
+		input.role,
+		input.priority
+	].every((v) => v === void 0)) throw new WriteError(`${input.id} needs --status, --group, --role or --priority, e.g. --status paused`);
+	const next = input.status === void 0 ? void 0 : requireOneOf(input.status, MAINLINE_STATUS, "mainline status");
+	const role = input.role === void 0 ? void 0 : requireOneOf(input.role, MAINLINE_ROLES, "mainline role");
+	const priority = input.priority === void 0 ? void 0 : requirePriority(input.priority);
 	const { day } = stamps(ctx);
 	const draft = new Draft(hub);
+	const group = input.group === void 0 || clearsGroup(input.group) ? void 0 : requireGroup(draft, input.group);
 	return draft.result(editFrontMatter(draft, mainlineFileIn(draft, input.id), mainlineSchema, (m) => {
-		if (next === "done" && m.status !== "done") requireDone(draft, input.id, m);
-		m.status = next;
-		stampClosed(m, closes("mainline", next), day);
+		if (next) {
+			if (next === "done" && m.status !== "done") requireDone(draft, input.id, m);
+			m.status = next;
+			stampClosed(m, closes("mainline", next), day);
+		}
+		if (group) m.group = group;
+		else if (clearsGroup(input.group)) delete m.group;
+		if (role) m.role = role;
+		if (priority) m.priority = priority;
 	}, input.expectedVersion));
 }
 /** Rename a mainline. References use its ID, so they keep resolving and show the new title. */
@@ -1724,7 +2073,7 @@ function updateTask(hub, input, ctx) {
 	if (status === "blocked" && !patch.blockedBy?.reason) throw new WriteError(`blocking ${input.ref} needs a reason, e.g. --reason "等使用者提供 API key" --waiting-for 使用者`);
 	const { day } = stamps(ctx);
 	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, taskFileIn(draft, ref.mainline, ref.task), taskSchema, (t) => {
+	const task = editFrontMatter(draft, taskFileIn(draft, ref.mainline, ref.task), taskSchema, (t) => {
 		if (status !== void 0) {
 			t.status = status;
 			if (status === "doing") t.startedAt ??= day;
@@ -1741,7 +2090,9 @@ function updateTask(hub, input, ctx) {
 		if (patch.base !== void 0) t.base = patch.base;
 		if (merge !== void 0) t.merge = merge;
 		checkTaskLinks(draft, ref.mainline, t);
-	}, input.expectedVersion));
+	}, input.expectedVersion);
+	if (status === "doing") activatePlanning(draft, ref.mainline);
+	return draft.result(task);
 }
 /** The criteria a new item serves, as stored: ids of its own mainline's criteria, given as r003 or m001#r003. */
 function servedCriteria(hub, mainline, serves) {
@@ -1786,11 +2137,13 @@ function setChecklistItem(hub, input, ctx) {
 	if (input.done && !input.evidence) throw new WriteError(`checking ${input.ref} needs evidence, e.g. --evidence mainflow@25e4165`);
 	const { day } = stamps(ctx);
 	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, taskFileIn(draft, ref.mainline, ref.task), taskSchema, (t) => {
+	const task = editFrontMatter(draft, taskFileIn(draft, ref.mainline, ref.task), taskSchema, (t) => {
 		const item = t.checklist.find((c) => c.id === ref.item);
 		if (!item) throw new WriteError(`checklist item ${input.ref} not found`);
 		setListItem(item, input.done, input.evidence, `${input.ref} is dropped; run item undrop ${input.ref} to bring it back before checking it`, day);
-	}, input.expectedVersion));
+	}, input.expectedVersion);
+	if (input.done) activatePlanning(draft, ref.mainline);
+	return draft.result(task);
 }
 /** Mark an item as no longer needed, naming what replaced it when something did. */
 function dropChecklistItem(hub, input) {
@@ -1898,161 +2251,6 @@ function supersedeDecision(hub, input, ctx) {
 	}, input.expectedVersion));
 }
 //#endregion
-//#region ../core/dist/ops/hub-items.js
-function entryFile(hub, dir, id, what) {
-	const file = entryFileIn(hub, dir, id);
-	if (!file) throw new WriteError(`${what} ${id} not found`);
-	return file;
-}
-/**
-* Any reference the schema accepts must also point at something that exists. A reference into another
-* hub only needs that hub registered here; check verifies the target when that hub is on this machine.
-*/
-function requireExisting(hub, ref) {
-	const parsed = parseRef(ref);
-	if (!parsed) throw new WriteError(`"${ref}" is not a reference like ${REF_EXAMPLES}`);
-	const config = readConfigIn(hub);
-	if (parsed.hub !== void 0 && parsed.hub !== config.hub) {
-		if (!config.hubs?.[parsed.hub]) throw new WriteError(`hub "${parsed.hub}" is not registered; run "mainflow hub add ${parsed.hub} <path>" first`);
-		return;
-	}
-	switch (parsed.kind) {
-		case "issue":
-			entryFile(hub, ISSUES_DIR, parsed.issue, "issue");
-			return;
-		case "finding":
-			entryFile(hub, FINDINGS_DIR, parsed.finding, "finding");
-			return;
-		default:
-			mainlineDirIn(hub, parsed.mainline);
-			if ("task" in parsed) taskDirIn(hub, parsed.mainline, parsed.task);
-			if (parsed.kind === "decision") decisionFileIn(hub, parsed.mainline, parsed.decision);
-	}
-}
-function createIssue(hub, input, ctx) {
-	requireSlug(input.slug);
-	if (input.origin) requireExisting(hub, input.origin);
-	const { day } = stamps(ctx);
-	const draft = new Draft(hub);
-	const id = draft.number(ctx, {
-		prefix: "i",
-		taken: idsIn(draft, ISSUES_DIR),
-		ref: (id) => id
-	});
-	const issue = validate(issueSchema, {
-		id,
-		title: input.title,
-		status: "open",
-		created: day,
-		...input.origin ? { origin: input.origin } : {},
-		...input.labels?.length ? { labels: input.labels } : {}
-	}, "issue");
-	const file = `${ISSUES_DIR}/${id}-${input.slug}.md`;
-	draft.write(file, frontMatterText(issue, ISSUE_BODY));
-	return draft.result({
-		id,
-		file
-	});
-}
-/** Schedule an issue into the task that will carry it out. */
-function planIssue(hub, input) {
-	const ref = requireRef(input.task, "task");
-	const draft = new Draft(hub);
-	taskDirIn(draft, ref.mainline, ref.task);
-	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
-		i.status = "planned";
-		i.plannedIn = input.task;
-	}, input.expectedVersion));
-}
-function closeIssue(hub, input, ctx) {
-	if (!input.resolution) throw new WriteError(`closing ${input.id} needs what closed it, e.g. --by "mainflow@3fdd5ac" or --by "不再需要"`);
-	const { day } = stamps(ctx);
-	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
-		i.status = "closed";
-		i.resolution = input.resolution;
-		i.closedAt ??= day;
-	}, input.expectedVersion));
-}
-function reopenIssue(hub, input) {
-	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
-		i.status = "open";
-		delete i.plannedIn;
-		delete i.resolution;
-		delete i.closedAt;
-	}, input.expectedVersion));
-}
-/** Archive or unarchive an issue; the status stays as it is, so a closed issue is visible until archived. */
-function setIssueArchived(hub, input, ctx) {
-	const { day } = stamps(ctx);
-	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, entryFile(draft, ISSUES_DIR, input.id, "issue"), issueSchema, (i) => {
-		if (input.archived) i.archivedAt ??= day;
-		else delete i.archivedAt;
-	}, input.expectedVersion));
-}
-function createFinding(hub, input, ctx) {
-	requireSlug(input.slug);
-	if (input.origin) requireExisting(hub, input.origin);
-	const { day } = stamps(ctx);
-	const draft = new Draft(hub);
-	const id = draft.number(ctx, {
-		prefix: "f",
-		taken: idsIn(draft, FINDINGS_DIR),
-		ref: (id) => id
-	});
-	const finding = validate(findingSchema, {
-		id,
-		title: input.title,
-		status: "valid",
-		created: day,
-		...input.origin ? { origin: input.origin } : {},
-		...input.labels?.length ? { labels: input.labels } : {}
-	}, "finding");
-	const file = `${FINDINGS_DIR}/${id}-${input.slug}.md`;
-	draft.write(file, frontMatterText(finding, FINDING_BODY));
-	return draft.result({
-		id,
-		file
-	});
-}
-function setFindingStatus(hub, input, ctx) {
-	const value = requireOneOf(input.status, FINDING_STATUS, "finding status");
-	const { day } = stamps(ctx);
-	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, entryFile(draft, FINDINGS_DIR, input.id, "finding"), findingSchema, (f) => {
-		f.status = value;
-		if (value === "obsolete") f.closedAt ??= day;
-		else delete f.closedAt;
-	}, input.expectedVersion));
-}
-/** Archive or unarchive a finding; the status stays as it is, so an obsolete finding is visible until archived. */
-function setFindingArchived(hub, input, ctx) {
-	const { day } = stamps(ctx);
-	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, entryFile(draft, FINDINGS_DIR, input.id, "finding"), findingSchema, (f) => {
-		if (input.archived) f.archivedAt ??= day;
-		else delete f.archivedAt;
-	}, input.expectedVersion));
-}
-/** Append one external operation to ops/{YYYY-MM}.log; the log is never rewritten. `at` defaults to the context's time. */
-function appendOps(hub, input, ctx) {
-	if (input.ref) requireExisting(hub, input.ref);
-	const entry = validate(opsEntrySchema, {
-		...input,
-		at: input.at ?? stamps(ctx).minute
-	}, "ops entry");
-	for (const field of [
-		"target",
-		"operation",
-		"result"
-	]) if (entry[field].includes(" | ")) throw new WriteError(`${field} cannot contain " | ", the ops log's separator`);
-	const draft = new Draft(hub);
-	draft.append(`ops/${entry.at.slice(0, 7)}.log`, `${formatOpsEntry(entry)}\n`);
-	return draft.result(entry);
-}
-//#endregion
 //#region ../core/dist/ops/sections.js
 /** The documents that have sections, with the sections each kind is created with. */
 const DOCUMENTS = {
@@ -2060,11 +2258,12 @@ const DOCUMENTS = {
 	task: TASK_SECTIONS,
 	decision: DECISION_SECTIONS,
 	issue: ISSUE_SECTIONS,
-	finding: FINDING_SECTIONS
+	finding: FINDING_SECTIONS,
+	group: GROUP_SECTIONS
 };
 function documentFile(hub, input) {
 	const ref = parseRef(input);
-	if (!ref || ref.hub !== void 0 || !(ref.kind in DOCUMENTS)) throw new WriteError(`section append takes a mainline, task, decision, issue or finding of this hub, like m001, m001/t002, m001/d001, i001 or f001; got "${input}"`);
+	if (!ref || ref.hub !== void 0 || !(ref.kind in DOCUMENTS)) throw new WriteError(`section append takes a mainline, task, decision, issue, finding or group of this hub, like m001, m001/t002, m001/d001, i001, f001 or w001; got "${input}"`);
 	const sections = DOCUMENTS[ref.kind];
 	const entry = (dir, id, what) => {
 		const file = entryFileIn(hub, dir, id);
@@ -2088,6 +2287,10 @@ function documentFile(hub, input) {
 			file: entry(ISSUES_DIR, ref.issue, "issue"),
 			sections
 		};
+		case "group": return {
+			file: entry(GROUPS_DIR, ref.group, "group"),
+			sections
+		};
 		default: return {
 			file: entry(FINDINGS_DIR, ref.finding, "finding"),
 			sections
@@ -2547,6 +2750,7 @@ function updateAction(hub, input, ctx) {
 		if (patch.before) place(s.actions, next, patch.before);
 		else s.actions.splice(index, 0, next);
 	});
+	if (status === "doing") for (const m of new Set(updated.serves.map((r) => /^m\d{3}/.exec(r)?.[0]).filter((m) => !!m))) activatePlanning(draft, m);
 	return draft.result(updated);
 }
 //#endregion
@@ -2732,7 +2936,7 @@ const OPERATIONS = {
 	"repo.add": addRepo,
 	"hub.add": addHub,
 	"mainline.new": createMainline,
-	"mainline.set": setMainlineStatus,
+	"mainline.set": setMainline,
 	"mainline.title": setMainlineTitle,
 	"mainline.archive": setMainlineArchived,
 	"criterion.add": addCriterion,
@@ -2748,6 +2952,7 @@ const OPERATIONS = {
 	"decision.accept": acceptDecision,
 	"decision.supersede": supersedeDecision,
 	"issue.new": createIssue,
+	"issue.set": setIssue,
 	"issue.plan": planIssue,
 	"issue.close": closeIssue,
 	"issue.reopen": reopenIssue,
@@ -2755,6 +2960,8 @@ const OPERATIONS = {
 	"finding.new": createFinding,
 	"finding.set": setFindingStatus,
 	"finding.archive": setFindingArchived,
+	"group.new": createGroup,
+	"group.set": setGroup,
 	"ops.add": appendOps,
 	"section.append": appendSection,
 	"session.start": startSession,
@@ -2821,7 +3028,7 @@ function renumberText(text, renumbered, scope) {
 	const parts = [full.size ? `(?<![A-Za-z0-9_:#-])(${alternation([...full.keys()])})${after}` : "(?!)", short.size ? `(?<![A-Za-z0-9_:#/-])(${alternation([...short.keys()])})${after}` : "(?!)"];
 	return text.replace(new RegExp(parts.join("|"), "g"), (match, whole, id) => whole ? full.get(whole) : id ? short.get(id) : match);
 }
-const ENTRY = /^([mtdif]\d{3})(-.+)$/;
+const ENTRY = /^([mtdifw]\d{3})(-.+)$/;
 /** The scope of a file in the data directory, from its path: the mainline and task directories above it, or its session. */
 function scopeOfPath(path) {
 	const [top, second, third, fourth] = path.split("/");
@@ -2836,7 +3043,7 @@ function scopeOfPath(path) {
 }
 /**
 * The path of a file after renumbering: the directory or file named after a renumbered mainline, task, decision,
-* issue or finding takes the new id and keeps its slug, e.g. issues/i004-flaky.md for i003 → i004.
+* issue, finding or group takes the new id and keeps its slug, e.g. issues/i004-flaky.md for i003 → i004.
 */
 function renumberPath(path, renumbered) {
 	const to = new Map(renumbered.map((r) => [r.from, r.to]));
@@ -2846,7 +3053,7 @@ function renumberPath(path, renumbered) {
 		if (!entry) return segment;
 		const id = entry[1];
 		const mainline = ENTRY.exec(segments[1] ?? "")?.[1];
-		const ref = segments[0] === "mainlines" && i === 1 ? id : segments[0] === "mainlines" && i === 3 && (segments[2] === "tasks" || segments[2] === "decisions") && mainline ? `${mainline}/${id}` : (segments[0] === "issues" || segments[0] === "findings") && i === 1 ? id : void 0;
+		const ref = segments[0] === "mainlines" && i === 1 ? id : segments[0] === "mainlines" && i === 3 && (segments[2] === "tasks" || segments[2] === "decisions") && mainline ? `${mainline}/${id}` : (segments[0] === "issues" || segments[0] === "findings" || segments[0] === "groups") && i === 1 ? id : void 0;
 		const next = ref === void 0 ? void 0 : to.get(ref);
 		return next === void 0 ? segment : `${lastId(next)}${entry[2]}`;
 	}).join("/");
@@ -3148,14 +3355,15 @@ function pathOf(ref, target) {
 		case "decision": return `/mainlines/${m}/decisions/${child}`;
 		case "issue": return `/issues?peek=${ref}`;
 		case "finding": return `/findings?peek=${ref}`;
+		case "group": return `/mainlines?peek=${ref}`;
 		default: return null;
 	}
 }
 const sessionPath = (id) => `/sessions/${id}`;
 /** Fenced blocks, inline code, markdown links and bare URLs: text inside them is left as written. */
 const PROTECTED = /(```[\s\S]*?(?:```|$)|`[^`\n]*`|\[[^\]\n]*\]\([^)\n]*\)|https?:\/\/\S+)/;
-/** A file under a mainline directory, or a reference to a mainline, task, decision, issue or finding. */
-const MENTION = /\.mainflow\/mainlines\/(m\d{3})-[\w-]+\/([^\s`'")\]]+\.\w+)|(?<![\w/#.[-])(m\d{3}(?:\/[td]\d{3})?|[if]\d{3})(?![\w\]])/g;
+/** A file under a mainline directory, or a reference to a mainline, task, decision, issue, finding or group. */
+const MENTION = /\.mainflow\/mainlines\/(m\d{3})-[\w-]+\/([^\s`'")\]]+\.\w+)|(?<![\w/#.[-])(m\d{3}(?:\/[td]\d{3})?|[ifw]\d{3})(?![\w\]])/g;
 /** Links for the references and mainline files the text mentions; references the hub does not have stay as text. */
 function linkMentions(text, context) {
 	const index = refIndex(context.hub);
@@ -3238,7 +3446,7 @@ function decorateReply(text, context) {
 	return line ? `${body}\n\n${line}\n` : `${body}\n`;
 }
 /** Cheap test for text that decorateReply could change, so a display hook can skip loading the hub. */
-const mayDecorate = (text) => /m\d{3}|[if]\d{3}|\.mainflow\/mainlines/.test(text) || endsWithMarker(text);
+const mayDecorate = (text) => /m\d{3}|[ifw]\d{3}|\.mainflow\/mainlines/.test(text) || endsWithMarker(text);
 //#endregion
 //#region ../core/dist/grants.js
 /** Mainline statuses whose grants apply. */
@@ -7564,6 +7772,7 @@ function reloadCaddy(sites) {
 	if (reload.error) return reload.error.message;
 	return reload.status === 0 ? null : (reload.stderr || reload.stdout).trim().slice(-300);
 }
+const adminAddress = () => process.env.MAINFLOW_CADDY_ADMIN ?? "http://127.0.0.1:2019";
 /**
 * Whether Caddy is running, judged by its admin API answering at all. The API refuses requests like
 * Node's fetch with 403 ("client is not allowed to access from origin"), so any response counts; only a
@@ -7571,14 +7780,63 @@ function reloadCaddy(sites) {
 * running Caddy as stopped). MAINFLOW_CADDY_ADMIN overrides the address.
 */
 async function caddyRunning() {
-	const admin = process.env.MAINFLOW_CADDY_ADMIN ?? "http://127.0.0.1:2019";
 	try {
-		await fetch(`${admin}/config/`, { signal: AbortSignal.timeout(500) });
+		await fetch(`${adminAddress()}/config/`, { signal: AbortSignal.timeout(500) });
 		return true;
 	} catch {
 		return false;
 	}
 }
+/** Every `dial` address under `node`. */
+function collectDials(node, out) {
+	if (Array.isArray(node)) for (const item of node) collectDials(item, out);
+	else if (node && typeof node === "object") for (const [key, value] of Object.entries(node)) if (key === "dial" && typeof value === "string") out.push(value);
+	else collectDials(value, out);
+}
+/** Every `dial` address of the routes under `node` whose match names `host`. */
+function dialsOf(node, host, out = []) {
+	if (Array.isArray(node)) for (const item of node) dialsOf(item, host, out);
+	else if (node && typeof node === "object") {
+		const route = node;
+		if (Array.isArray(route.match) && route.match.some((m) => m.host?.includes(host))) collectDials(route.handle, out);
+		else for (const value of Object.values(route)) dialsOf(value, host, out);
+	}
+	return out;
+}
+/**
+* The upstream addresses the running Caddy has for `host`, read from its admin API (an empty list when it has
+* no such site), or undefined when the API cannot be read. The request carries an Origin header because the
+* API answers 403 without one.
+*/
+async function runningUpstreams(host) {
+	const admin = adminAddress();
+	try {
+		const response = await fetch(`${admin}/config/`, {
+			headers: { Origin: admin },
+			signal: AbortSignal.timeout(1500)
+		});
+		if (!response.ok) return void 0;
+		return dialsOf(await response.json(), host);
+	} catch {
+		return;
+	}
+}
+/**
+* Remove the mainflow-* links in `sites` whose target is gone. One such link makes every Caddy reload fail,
+* because the Caddyfile imports the whole directory; hubs deleted without being asked to stop (test hubs)
+* leave them behind. Other names and links with a target are not touched. Returns the names removed.
+*/
+function removeDanglingLinks(sites) {
+	const removed = [];
+	for (const name of readdirSync(sites)) {
+		if (!name.startsWith("mainflow-")) continue;
+		const link = join(sites, name);
+		if (!lstatSync(link, { throwIfNoEntry: false })?.isSymbolicLink() || existsSync(link)) continue;
+		rmSync(link, { force: true });
+		removed.push(name);
+	}
+	return removed;
+}
 const realOf = (path) => existsSync(path) ? realpathSync(path) : resolve(path);
 /**
 * Point {hub}.mainflow.localhost at `port`. The site block is rewritten and Caddy reloaded only when the
@@ -7594,23 +7852,36 @@ async function syncHost(root, hub, port, options = {}) {
 	const dir = join(root, DATA_DIR, "local", "caddy");
 	const file = join(dir, `${hub}.caddy`);
 	const link = join(sites, `mainflow-${hub}.caddy`);
+	removeDanglingLinks(sites);
 	const linked = lstatSync(link, { throwIfNoEntry: false });
 	if (linked) {
 		const target = linked.isSymbolicLink() ? resolve(dirname(link), readlinkSync(link)) : link;
 		if (existsSync(target) && realOf(target) !== realOf(file)) throw new WriteError(`host name ${hostName(hub)} is already used by another hub (${link} → ${target}); give one of the hubs a different name in its .mainflow/config.yaml`);
 	}
 	const block = siteBlock(hub, port);
-	if ((linked && existsSync(file) ? readFileSync(file, "utf8") : null) !== block) {
+	const current = linked && existsSync(file) ? readFileSync(file, "utf8") : null;
+	const pending = join(dir, `${hub}.reload-pending`);
+	const upstreams = await (options.upstreams ?? runningUpstreams)(hostName(hub));
+	const stale = upstreams ? upstreams.length !== 1 || upstreams[0] !== `localhost:${port}` : existsSync(pending);
+	if (current !== block || stale) {
 		mkdirSync(dir, { recursive: true });
-		writeFileSync(file, block);
-		if (linked) rmSync(link);
-		symlinkSync(file, link);
+		if (current !== block) {
+			writeFileSync(file, block);
+			if (linked) rmSync(link);
+			symlinkSync(file, link);
+		}
 		const failure = (options.reload ?? reloadCaddy)(sites);
-		if (failure) return {
-			url: null,
-			reason: `caddy reload failed: ${failure}`
-		};
-	} else if (!await (options.running ?? caddyRunning)()) return {
+		if (failure) {
+			writeFileSync(pending, `${failure}\n`);
+			return {
+				url: null,
+				reason: `caddy reload failed: ${failure}`,
+				reloadFailed: true
+			};
+		}
+		rmSync(pending, { force: true });
+	} else if (upstreams) rmSync(pending, { force: true });
+	else if (!await (options.running ?? caddyRunning)()) return {
 		url: null,
 		reason: "Caddy is not running; start it with `brew services start caddy`"
 	};
@@ -7625,10 +7896,16 @@ function removeHostLink(root, hub, reload = reloadCaddy) {
 	const sites = caddySites();
 	if (!sites) return null;
 	const link = join(sites, `mainflow-${hub}.caddy`);
-	if (!lstatSync(link, { throwIfNoEntry: false })?.isSymbolicLink()) return null;
-	if (!resolve(dirname(link), readlinkSync(link)).startsWith(resolve(root) + "/")) return null;
-	rmSync(link);
-	return reload(sites);
+	const linked = lstatSync(link, { throwIfNoEntry: false });
+	let removed = false;
+	if (linked?.isSymbolicLink()) {
+		if (resolve(dirname(link), readlinkSync(link)).startsWith(resolve(root) + "/")) {
+			rmSync(link);
+			removed = true;
+		}
+	}
+	if (removeDanglingLinks(sites).length > 0) removed = true;
+	return removed ? reload(sites) : null;
 }
 /** The macOS app's bundle identifier, from apps/macos/scripts/package.sh. */
 const APP_BUNDLE_ID = "space.carlos.mainflow";
@@ -7662,4 +7939,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { MAX_FILE_BYTES 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, readYaml as J, refIndex as K, renumberText as L, transcriptTitle as M, applyOffline as N, headerLine as O, renumberRequest as P, MAX_BLOB_BYTES as Q, scopeOfPath as R, readSession as S, matchGrants as T, dependencyGraph as U, HubError as V, mainlineEdges as W, ACCESS_HEADERS as X, nodeStorage as Y, BLOB_HASH as Z, untilState as _, splitFrontMatter as _t, openInApp as a, requestTime as at, turnReminder as b, syncHost as c, TASK_FILE as ct, retroReportFromReceiver as d, findHubRoot as dt, ROUTES as et, receiverFromEnv as f, worktreesOf as ft, initHub as g, contentHash as gt, setArchivedMany as h, WriteError as ht, hostName as i, readsAsText as it, traceTranscript as j, mayDecorate as k, migrateHub as l, requireSlug as lt, ARCHIVE_KINDS as m, DATA_DIR as mt, DEFAULT_UI_PORT as n, comparePaths as nt, removeHostLink as o, textBytes as ot, RETRY_RULES as p, ConflictError as pt, nowMinute as q, caddySites as r, exceedsFileLimit as rt, siteBlock as s, MAINLINE_FILE as st, APP_BUNDLE_ID as t, SOCKET_MAX_AGE_CLOSE as tt, retroReport as u, currentBranch as ut, duplicateClaimLines as v, grantScope as w, loadSessions as x, sessionBriefing as y, applyOperation as z };
+export { ACCESS_HEADERS as $, mayDecorate as A, applyOperation as B, readSession as C, decorateReply as D, matchGrants as E, renumberRequest as F, sectionText as G, HubError as H, renumberFiles as I, linksInto as J, dependencyGraph as K, renumberPath as L, traceTranscript as M, transcriptTitle as N, endsWithMarker as O, applyOffline as P, nodeStorage as Q, renumberText as R, loadSessions as S, grantScope as T, loadConfig as U, checkHubName as V, loadHub as W, nowMinute as X, refIndex as Y, readYaml as Z, initHub as _, DATA_DIR as _t, openInApp as a, comparePaths as at, sessionBriefing as b, splitFrontMatter as bt, siteBlock as c, requestTime as ct, retroReport as d, TASK_FILE as dt, BLOB_HASH as et, retroReportFromReceiver as f, requireSlug as ft, setArchivedMany as g, ConflictError as gt, ARCHIVE_KINDS as h, worktreesOf as ht, hostName as i, SOCKET_MAX_AGE_CLOSE as it, attributeTrace as j, headerLine as k, syncHost as l, textBytes as lt, RETRY_RULES as m, findHubRoot as mt, DEFAULT_UI_PORT as n, MAX_FILE_BYTES as nt, removeDanglingLinks as o, exceedsFileLimit as ot, receiverFromEnv as p, currentBranch as pt, mainlineEdges as q, caddySites as r, ROUTES as rt, removeHostLink as s, readsAsText as st, APP_BUNDLE_ID as t, MAX_BLOB_BYTES as tt, migrateHub as u, MAINLINE_FILE as ut, untilState as v, WriteError as vt, transcriptPath as w, turnReminder as x, duplicateClaimLines as y, contentHash as yt, scopeOfPath as z };