mainflow 0.35.0-beta.1 → 0.36.0

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { G as parseRef, K as parseUntil, N as UNTIL_FORMS, et as stampMs, n as CLOSED_STATUS, q as refExample } from "./dist-BdvWGTsb.js";
-import { B as applyOperation, C as readSession, H as HubError, Q as nodeStorage, S as loadSessions, V as checkHubName, W as loadHub, X as nowMinute, _ as initHub, _t as DATA_DIR, b as sessionBriefing, d as retroReport, dt as TASK_FILE, f as retroReportFromReceiver, ft as requireSlug, m as RETRY_RULES, mt as findHubRoot, nt as MAX_FILE_BYTES, p as receiverFromEnv, u as migrateHub, ut as MAINLINE_FILE, v as untilState, vt as WriteError, y as duplicateClaimLines } from "./host-bnHYIwuY.js";
+import { G as parseRef, K as parseUntil, N as UNTIL_FORMS, et as stampMs, n as CLOSED_STATUS, q as refExample } from "./dist-ud09dzZo.js";
+import { $ as nowMinute, B as applyOperation, C as readSession, H as HubError, Q as unavailableHubs, S as loadSessions, V as checkHubName, W as loadHub, Y as memberOfGroup, Z as remoteMembers, _ as initHub, _t as findHubRoot, at as MAX_FILE_BYTES, b as sessionBriefing, bt as DATA_DIR, d as retroReport, f as retroReportFromReceiver, ht as requireSlug, m as RETRY_RULES, mt as TASK_FILE, p as receiverFromEnv, pt as MAINLINE_FILE, tt as nodeStorage, u as migrateHub, v as untilState, xt as WriteError, y as duplicateClaimLines } from "./host-BauijAdm.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { C as ServerError, D as syncSettings, E as hubName, O as SETTINGS_FILE, S as ServerApi, T as earlierToken, _ as readDaemon, a as remoteMode, b as readRemote, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, j as syncPaths, l as planFetch, m as DaemonUnavailable, n as hubWriter, o as fetchDenial, p as DaemonRunning, r as writtenLines, s as hookAnswer, t as CONFIRM_MS, u as planFlush, v as silentHint, w as ENV, x as oversizedFiles } from "./operation-DVcJgKM9.js";
+import { C as ServerError, D as syncSettings, E as hubName, O as SETTINGS_FILE, S as ServerApi, T as earlierToken, _ as readDaemon, a as remoteMode, b as readRemote, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, j as syncPaths, l as planFetch, m as DaemonUnavailable, n as hubWriter, o as fetchDenial, p as DaemonRunning, r as writtenLines, s as hookAnswer, t as CONFIRM_MS, u as planFlush, v as silentHint, w as ENV, x as oversizedFiles } from "./operation-DGRH4iBE.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { hookFallback, parsePayload, runHook } from "./hooks.js";
-import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-D80CYPcm.js";
+import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-n2ZDF0BF.js";
 import { randomBytes } from "node:crypto";
 import { existsSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
 import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";
@@ -524,6 +524,18 @@ function retroText(report) {
 //#endregion
 //#region src/cli.ts
 const write = (spec) => spec;
+/**
+* A group of another hub (`other-hub:w001`) must exist there when that hub is on this machine; the operation only
+* checks that the hub is registered, since a hub kept on another machine cannot be read from here.
+*/
+const checkGroupOption = ({ root, opts }) => {
+	const ref = opts.group ? parseRef(opts.group) : null;
+	if (ref?.kind !== "group" || ref.hub === void 0) return;
+	const hub = loadHub(root);
+	if (ref.hub === hub.config.hub) return;
+	const remote = hub.remotes.find((r) => r.name === ref.hub);
+	if (remote?.hub && !remote.hub.groups.some((g) => g.id === ref.group)) throw new WriteError(`group ${ref.group} not found in hub "${ref.hub}"`);
+};
 /** Where a document an operation created or changed is, as the commands print it: .mainflow/... */
 const inData = (...parts) => join(DATA_DIR, ...parts);
 const WRITES = {
@@ -651,6 +663,7 @@ const WRITES = {
 		}
 	}),
 	"new mainline": write({
+		check: checkGroupOption,
 		op: "mainline.new",
 		input: ({ args, opts }) => ({
 			slug: args[0],
@@ -687,6 +700,7 @@ const WRITES = {
 		print: (_, { ref, file }) => done(`created ${ref} ${inData(file)}`)
 	}),
 	"new issue": write({
+		check: checkGroupOption,
 		op: "issue.new",
 		input: ({ args, opts }) => ({
 			slug: args[0],
@@ -734,6 +748,7 @@ const WRITES = {
 		print: (_, { id, file }) => done(`created ${id} ${inData(file)}`)
 	}),
 	"mainline set": write({
+		check: checkGroupOption,
 		op: "mainline.set",
 		input: ({ args, opts }) => ({
 			id: args[0],
@@ -891,6 +906,7 @@ const WRITES = {
 		print: (_, i) => done(`closed ${i.id}`)
 	}),
 	"issue set": write({
+		check: checkGroupOption,
 		op: "issue.set",
 		input: ({ args, opts }) => ({
 			id: args[0],
@@ -1353,14 +1369,23 @@ function printStatus(hub, all) {
 */
 function printGroups(hub, all) {
 	const rank = (p) => (p ?? "P2").slice(1);
+	const remoteByGroup = remoteMembers(hub.remotes, hub.config.hub);
 	const shown = hub.groups.filter((g) => all || g.status !== "done").sort((a, b) => rank(a.priority).localeCompare(rank(b.priority)) || a.id.localeCompare(b.id));
 	for (const g of shown) {
 		console.log(`  ${g.id}  ${g.status.padEnd(4)}  ${g.priority ?? "P2"}  ${g.title}${g.trigger ? `  （時機：${g.trigger}）` : ""}`);
-		const mainlines = hub.mainlines.filter((m) => m.group === g.id && (all || !m.archivedAt && !CLOSED_STATUS.mainline.includes(m.status)));
-		const issues = hub.issues.filter((i) => i.group === g.id && (all || !i.archivedAt && i.status !== "closed"));
+		const mainlines = hub.mainlines.filter((m) => memberOfGroup(m.group, g.id, hub.config.hub) && (all || !m.archivedAt && !CLOSED_STATUS.mainline.includes(m.status)));
+		const issues = hub.issues.filter((i) => memberOfGroup(i.group, g.id, hub.config.hub) && (all || !i.archivedAt && i.status !== "closed"));
 		for (const m of [...mainlines.filter((m) => m.role === "plan"), ...mainlines.filter((m) => m.role !== "plan")]) console.log(`      ${m.id}  ${(m.role ?? "impl").padEnd(4)}  ${m.status.padEnd(8)}  ${m.title}`);
 		for (const i of issues) console.log(`      ${i.id}  issue  ${i.status.padEnd(8)}  ${i.title}`);
+		const remote = (remoteByGroup.get(g.id) ?? []).filter((m) => all || !m.archived && m.open);
+		for (const m of [
+			...remote.filter((m) => m.role === "plan"),
+			...remote.filter((m) => m.kind === "mainline" && m.role !== "plan"),
+			...remote.filter((m) => m.kind === "issue")
+		]) console.log(`      ${m.ref}  ${(m.kind === "issue" ? "issue" : m.role).padEnd(4)}  ${m.status.padEnd(8)}  ${m.title}`);
 	}
+	const missing = unavailableHubs(hub.remotes);
+	if (missing.length) console.log(`  note: hub ${missing.join(", ")} not loaded, so their members are not listed`);
 	return done(`${shown.length} groups`);
 }
 function printProblems(problems, mark = "✗") {

package/dist/{dist-BdvWGTsb.js → dist-ud09dzZo.js}

@@ -699,8 +699,11 @@ const documentShape = {
 	links: z.array(linkSchema).optional()
 };
 const priority = z.enum(PRIORITIES).optional();
-/** The hub-level group a mainline or an issue belongs to, at most one; work that goes together, apart from what depends on what */
-const group = id("group").optional();
+/**
+* The hub-level group a mainline or an issue belongs to, at most one; work that goes together, apart from what depends on what.
+* It is a group of this hub (`w001`) or of another one (`other-hub:w001`), so work in one hub can join a group of another.
+*/
+const group = z.string().refine((s) => parseRef(s)?.kind === "group", `expected a group like ${refExample("group")}, or one of another hub's like other-hub:${refExample("group")}`).optional();
 const evidenceRequired = (item, ctx) => {
 	if (item.done && !item.evidence) ctx.addIssue({
 		code: "custom",
@@ -889,6 +892,11 @@ const UNTIL_FORMS = [
 		kind: "file",
 		format: "file:{relative path}",
 		example: "file:packages/cli/dist/cli.js"
+	},
+	{
+		kind: "mainline-done",
+		format: "mainline-done:m{NNN} or mainline-done:{hub}:m{NNN}",
+		example: "mainline-done:other-hub:m031"
 	}
 ];
 const UNTIL_EXAMPLES = UNTIL_FORMS.map((f) => f.format).join(", ");
@@ -922,6 +930,10 @@ function parseUntil(input) {
 			kind,
 			path: argument
 		} : null;
+		case "mainline-done": return parseRef(argument)?.kind === "mainline" ? {
+			kind,
+			mainline: argument
+		} : null;
 		default: return null;
 	}
 }

package/dist/facts.d.ts

@@ -1,4 +1,4 @@
-import { g as SurveyLine, l as ID_PATTERNS, m as SLUG, o as FORMAT_VERSION, p as SERVES_REF, r as CHECKLIST_REF, v as Until } from "./index-DgYB5u1f.js";
+import { g as SurveyLine, l as ID_PATTERNS, m as SLUG, o as FORMAT_VERSION, p as SERVES_REF, r as CHECKLIST_REF, v as Until } from "./index-B32s8PHu.js";
 //#region src/facts.d.ts
 export interface CommandSpec {
   usage: string;
@@ -125,7 +125,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'new mainline': {
     readonly usage: 'new mainline <slug> --title <title> [--group <w>] [--role plan|impl] [--priority P0|P1|P2|P3]';
-    readonly summary: 'Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)';
+    readonly summary: 'Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group, or in one of another registered hub as {hub}:w001; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -143,7 +143,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'new issue': {
     readonly usage: 'new issue <slug> --title <title> [--origin <ref>] [--labels a,b] [--group <w>] [--priority P0|P1|P2|P3]';
-    readonly summary: 'Create an issue file for a follow-up that must outlive its mainline; --group puts it with the work it is taken up with';
+    readonly summary: 'Create an issue file for a follow-up that must outlive its mainline; --group puts it with the work it is taken up with, in this hub or another registered one ({hub}:w001)';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -167,13 +167,13 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'group list': {
     readonly usage: 'group list [--all]';
-    readonly summary: 'List open groups by priority with their trigger and members, plan mainlines first (--all includes done groups)';
+    readonly summary: 'List open groups by priority with their trigger and members, plan mainlines first; members in other hubs read {hub}:{id}, and a registered hub that is not loaded is noted (--all includes done groups)';
     readonly args: 0;
     readonly needsHub: true;
   };
   readonly 'mainline set': {
     readonly usage: 'mainline set <m> [--status <status>] [--group <w|none>] [--role plan|impl] [--priority P0|P1|P2|P3]';
-    readonly summary: 'Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group';
+    readonly summary: 'Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group; {hub}:w001 joins a group of another registered hub';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -293,7 +293,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'issue set': {
     readonly usage: 'issue set <i> [--group <w|none>] [--priority P0|P1|P2|P3]';
-    readonly summary: 'Put an issue in a group, or take it out with --group none, and change its priority';
+    readonly summary: 'Put an issue in a group (of this hub, or {hub}:w001 of another registered one), or take it out with --group none, and change its priority';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -620,7 +620,7 @@ export declare const RETRO_FORMATS: {
 };
 /**
  * Conditions a blocked action's `until` takes and `wait` checks, one example each: a commit on a branch whose
- * message contains the text (git log runs at the hub root), an action that is done, a path relative to the hub root that exists (`..` reaches sibling repositories).
+ * message contains the text (git log runs at the hub root), an action that is done, a path relative to the hub root that exists (`..` reaches sibling repositories), a mainline of this hub or a registered hub that is done.
  */
 export declare const UNTIL: readonly {
   kind: Until['kind'];

package/dist/facts.js

@@ -1,4 +1,4 @@
-import { A as SURVEY_SECTION, D as SESSION_STATUS, M as TASK_SECTIONS, N as UNTIL_FORMS, O as SLUG, P as WORK_STATUS, S as PRIORITIES, T as SERVES_REF, _ as LINK_RELS, a as DECISION_SECTIONS, b as MAINLINE_STATUS, c as DEFAULT_ROLE, d as FORMAT_VERSION, f as GROUP_SECTIONS, g as ISSUE_STATUS, h as ISSUE_SECTIONS, i as DECISION_BASES, j as TASK_REQUIRED_SECTIONS, k as SURVEY_LINES, l as FINDING_SECTIONS, m as ID_PATTERNS, n as CLOSED_STATUS, nt as GRANT_FORMS, o as DECISION_STATUS, p as GROUP_STATUS, r as DECIDERS, rt as GRANT_TARGET_FORMS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, tt as GRANT_ACTIONS, u as FINDING_STATUS, v as MAINLINE_ROLES, x as MERGE_STATES, y as MAINLINE_SECTIONS } from "./dist-BdvWGTsb.js";
+import { A as SURVEY_SECTION, D as SESSION_STATUS, M as TASK_SECTIONS, N as UNTIL_FORMS, O as SLUG, P as WORK_STATUS, S as PRIORITIES, T as SERVES_REF, _ as LINK_RELS, a as DECISION_SECTIONS, b as MAINLINE_STATUS, c as DEFAULT_ROLE, d as FORMAT_VERSION, f as GROUP_SECTIONS, g as ISSUE_STATUS, h as ISSUE_SECTIONS, i as DECISION_BASES, j as TASK_REQUIRED_SECTIONS, k as SURVEY_LINES, l as FINDING_SECTIONS, m as ID_PATTERNS, n as CLOSED_STATUS, nt as GRANT_FORMS, o as DECISION_STATUS, p as GROUP_STATUS, r as DECIDERS, rt as GRANT_TARGET_FORMS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, tt as GRANT_ACTIONS, u as FINDING_STATUS, v as MAINLINE_ROLES, x as MERGE_STATES, y as MAINLINE_SECTIONS } from "./dist-ud09dzZo.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 = {
@@ -115,7 +115,7 @@ const COMMAND_SPECS = {
 	},
 	"new mainline": {
 		usage: "new mainline <slug> --title <title> [--group <w>] [--role plan|impl] [--priority P0|P1|P2|P3]",
-		summary: "Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)",
+		summary: "Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group, or in one of another registered hub as {hub}:w001; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)",
 		args: 1,
 		needsHub: true
 	},
@@ -133,7 +133,7 @@ const COMMAND_SPECS = {
 	},
 	"new issue": {
 		usage: "new issue <slug> --title <title> [--origin <ref>] [--labels a,b] [--group <w>] [--priority P0|P1|P2|P3]",
-		summary: "Create an issue file for a follow-up that must outlive its mainline; --group puts it with the work it is taken up with",
+		summary: "Create an issue file for a follow-up that must outlive its mainline; --group puts it with the work it is taken up with, in this hub or another registered one ({hub}:w001)",
 		args: 1,
 		needsHub: true
 	},
@@ -157,13 +157,13 @@ const COMMAND_SPECS = {
 	},
 	"group list": {
 		usage: "group list [--all]",
-		summary: "List open groups by priority with their trigger and members, plan mainlines first (--all includes done groups)",
+		summary: "List open groups by priority with their trigger and members, plan mainlines first; members in other hubs read {hub}:{id}, and a registered hub that is not loaded is noted (--all includes done groups)",
 		args: 0,
 		needsHub: true
 	},
 	"mainline set": {
 		usage: "mainline set <m> [--status <status>] [--group <w|none>] [--role plan|impl] [--priority P0|P1|P2|P3]",
-		summary: "Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group",
+		summary: "Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group; {hub}:w001 joins a group of another registered hub",
 		args: 1,
 		needsHub: true
 	},
@@ -283,7 +283,7 @@ const COMMAND_SPECS = {
 	},
 	"issue set": {
 		usage: "issue set <i> [--group <w|none>] [--priority P0|P1|P2|P3]",
-		summary: "Put an issue in a group, or take it out with --group none, and change its priority",
+		summary: "Put an issue in a group (of this hub, or {hub}:w001 of another registered one), or take it out with --group none, and change its priority",
 		args: 1,
 		needsHub: true
 	},
@@ -538,7 +538,7 @@ const RETRO_FORMATS = {
 };
 /**
 * Conditions a blocked action's `until` takes and `wait` checks, one example each: a commit on a branch whose
-* message contains the text (git log runs at the hub root), an action that is done, a path relative to the hub root that exists (`..` reaches sibling repositories).
+* message contains the text (git log runs at the hub root), an action that is done, a path relative to the hub root that exists (`..` reaches sibling repositories), a mainline of this hub or a registered hub that is done.
 */
 const UNTIL = UNTIL_FORMS;
 /** Relation types a document's links take; readers derive the reverse direction. */
@@ -654,7 +654,7 @@ const LIST_ITEM = [
 const FIELDS = {
 	mainline: [
 		...shared(...EVERY),
-		field("group", false, "所屬的組 w{NNN}，一條主脈絡最多一組；組和依賴無關"),
+		field("group", false, "所屬的組 w{NNN}，或其他 hub 的組 {hub}:w{NNN}，一條主脈絡最多一組；組和依賴無關"),
 		field("role", false, "plan 是拆分顆粒、整合調度與最終確認的規劃型，impl 是執行的實作型；沒填視為 impl"),
 		field("due", false, "預計完成的日期"),
 		field("archivedAt", false, "封存的日期，和狀態分開"),
@@ -690,7 +690,7 @@ const FIELDS = {
 	],
 	issue: [
 		...shared(...EVERY),
-		field("group", false, "所屬的組 w{NNN}，一筆待辦最多一組；同組的待辦在同一個時機一起做"),
+		field("group", false, "所屬的組 w{NNN}，或其他 hub 的組 {hub}:w{NNN}，一筆待辦最多一組；同組的待辦在同一個時機一起做"),
 		field("order", false, "待辦之間的順序"),
 		field("due", false, "預計完成的日期"),
 		field("plannedIn", false, "排進的任務，planned 時必填"),

package/dist/grant-commands.d.ts

@@ -1,4 +1,4 @@
-import "./index-DgYB5u1f.js";
+import "./index-B32s8PHu.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 { nt as GRANT_FORMS } from "./dist-BdvWGTsb.js";
+import { nt as GRANT_FORMS } from "./dist-ud09dzZo.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 { _ as Task, a as Decision, c as Group, d as Mainline, f as OpsEntry, h as Session, i as ChecklistItem, n as ActionBlock, s as Finding, t as Action, u as Issue } from "./index-DgYB5u1f.js";
+import { _ as Task, a as Decision, c as Group, d as Mainline, f as OpsEntry, h as Session, i as ChecklistItem, n as ActionBlock, s as Finding, t as Action, u as Issue } from "./index-B32s8PHu.js";
 import { z } from "zod";
 //#region ../core/dist/ids/allocators.d.ts
 /** The letters ids start with. */

package/dist/hooks.js

@@ -1,6 +1,6 @@
-import { F as configSchema, it as describeRequest } from "./dist-BdvWGTsb.js";
-import { A as mayDecorate, C as readSession, D as decorateReply, E as matchGrants, H as HubError, O as endsWithMarker, S as loadSessions, T as grantScope, W as loadHub, Z as readYaml, _t as DATA_DIR, b as sessionBriefing, ht as worktreesOf, i as hostName, k as headerLine, mt as findHubRoot, pt as currentBranch, x as turnReminder } from "./host-bnHYIwuY.js";
-import { n as hubWriter, r as writtenLines } from "./operation-DVcJgKM9.js";
+import { F as configSchema, it as describeRequest } from "./dist-ud09dzZo.js";
+import { A as mayDecorate, C as readSession, D as decorateReply, E as matchGrants, H as HubError, O as endsWithMarker, S as loadSessions, T as grantScope, W as loadHub, _t as findHubRoot, b as sessionBriefing, bt as DATA_DIR, et as readYaml, gt as currentBranch, i as hostName, k as headerLine, vt as worktreesOf, x as turnReminder } from "./host-BauijAdm.js";
+import { n as hubWriter, r as writtenLines } from "./operation-DGRH4iBE.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-bnHYIwuY.js → host-BauijAdm.js}

@@ -1,4 +1,4 @@
-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 { $ 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, N as UNTIL_FORMS, 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-ud09dzZo.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";
@@ -618,6 +618,7 @@ const mainlineDir = (root, id) => onDisk(root, mainlineDirIn(nodeStorage(root),
 const taskDir = (root, mainline, task) => onDisk(root, taskDirIn(nodeStorage(root), mainline, task));
 const mainlineFile = (root, id) => join(mainlineDir(root, id), MAINLINE_FILE);
 const taskFile = (root, mainline, task) => join(taskDir(root, mainline, task), TASK_FILE);
+const readConfig = (root) => readConfigIn(nodeStorage(root));
 //#endregion
 //#region ../core/dist/refs.js
 const itemStatus = (item) => item.done ? "done" : item.dropped ? "dropped" : "open";
@@ -706,6 +707,64 @@ function linksInto(hub, hubName) {
 	for (const g of hub.groups) add(g.id, g.links);
 	return out;
 }
+/**
+* Where a member's `group` value points: `id` is the group's id, and `hub` is the other hub's name, or undefined
+* for a group of the member's own hub (no prefix, or the member's own hub name as prefix).
+*/
+function splitGroup(value, ownHub) {
+	const colon = value.indexOf(":");
+	if (colon < 0) return { id: value };
+	const hub = value.slice(0, colon);
+	const id = value.slice(colon + 1);
+	return hub === ownHub ? { id } : {
+		hub,
+		id
+	};
+}
+/** Whether a member's `group` value names the group `groupId` of its own hub `ownHub`: `w001` or `{ownHub}:w001`. */
+function memberOfGroup(group, groupId, ownHub) {
+	if (group === void 0) return false;
+	const target = splitGroup(group, ownHub);
+	return target.hub === void 0 && target.id === groupId;
+}
+/**
+* The mainlines and issues of the registered hubs whose `group` names one of `hubName`'s groups, by group id. Only
+* the hubs' own documents are read, one level, so a hub that is not on this machine contributes nothing.
+*/
+function remoteMembers(remotes, hubName) {
+	const out = /* @__PURE__ */ new Map();
+	const add = (group, member) => {
+		if (!group) return;
+		const target = splitGroup(group, member.hub);
+		if (target.hub !== hubName) return;
+		out.set(target.id, [...out.get(target.id) ?? [], member]);
+	};
+	for (const r of remotes) {
+		if (!r.hub) continue;
+		for (const m of r.hub.mainlines) add(m.group, {
+			ref: `${r.name}:${m.id}`,
+			hub: r.name,
+			kind: "mainline",
+			title: m.title,
+			status: m.status,
+			role: m.role ?? "impl",
+			archived: Boolean(m.archivedAt),
+			open: !CLOSED_STATUS.mainline.includes(m.status)
+		});
+		for (const i of r.hub.issues) add(i.group, {
+			ref: `${r.name}:${i.id}`,
+			hub: r.name,
+			kind: "issue",
+			title: i.title,
+			status: i.status,
+			archived: Boolean(i.archivedAt),
+			open: i.status !== "closed"
+		});
+	}
+	return out;
+}
+/** The registered hubs that could not be loaded, for a reader that must say its member list may be incomplete. */
+const unavailableHubs = (remotes) => remotes.filter((r) => r.unavailable).map((r) => r.name);
 //#endregion
 //#region ../core/dist/deps.js
 const MET = /* @__PURE__ */ new Set([
@@ -1165,8 +1224,7 @@ 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));
+	problems.push(...groupProblems(config.hub, groups, mainlines, hubIssues, unreadable));
 	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) => {
@@ -1185,6 +1243,12 @@ function loadHub(root, options = {}) {
 		});
 	});
 	const remotes = options.remotes === false ? [] : loadRemotes(root, config, problems, warnings);
+	warnings.push(...groupWarnings(config.hub, groups, mainlines, hubIssues, remotes));
+	for (const doc of [...mainlines, ...hubIssues]) if (doc.group && splitGroup(doc.group, config.hub).hub !== void 0) pending.push({
+		ref: doc.group,
+		file: doc.file,
+		field: "group"
+	});
 	checkReferences({
 		config,
 		mainlines,
@@ -1238,20 +1302,32 @@ function loadHub(root, options = {}) {
 		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) {
+/** Members name their group; one that names a group this hub does not have is reported on the member. A group of another hub is checked with the other references. */
+function groupProblems(hubName, 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`
-	}] : []);
+	return [...mainlines, ...issues].flatMap((doc) => {
+		if (!doc.group) return [];
+		const { hub, id } = splitGroup(doc.group, hubName);
+		return hub === void 0 && !known.has(id) && !unreadable.has(id) ? [{
+			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) {
+/**
+* A group marked done while some of its members are still open: a plan to settle, not a broken file. Members in
+* other hubs count too, when those hubs are on this machine.
+*/
+function groupWarnings(hubName, groups, mainlines, issues, remotes) {
+	const remote = remoteMembers(remotes, hubName);
 	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)];
+		const open = [
+			...mainlines.filter((m) => memberOfGroup(m.group, g.id, hubName) && isOpen$2("mainline", m.status)).map((m) => m.id),
+			...issues.filter((i) => memberOfGroup(i.group, g.id, hubName) && i.status !== "closed").map((i) => i.id),
+			...(remote.get(g.id) ?? []).filter((m) => m.open).map((m) => m.ref)
+		];
 		return open.length ? [{
 			file: g.file,
 			field: "status",
@@ -1648,12 +1724,18 @@ function requireExisting(hub, ref) {
 /** 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.
+* The group a member names: one of this hub, which must exist, or one of another hub (`other-hub:w001`), which
+* only needs that hub registered here; the commands check the group itself when that hub is on this machine.
+* The hub's own name as prefix gives the group without it. `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}"`);
+	const config = readConfigIn(hub);
+	if (ref.hub !== void 0 && ref.hub !== config.hub) {
+		if (!config.hubs?.[ref.hub]) throw new WriteError(`hub "${ref.hub}" is not registered; run "mainflow hub add ${ref.hub} <path>" first`);
+		return `${ref.hub}:${ref.group}`;
+	}
 	entryFile(hub, GROUPS_DIR, ref.group, "group");
 	return ref.group;
 }
@@ -2692,6 +2774,7 @@ function addAction(hub, input, ctx) {
 * to work that has since been handed off to this very action would otherwise wait forever.
 */
 function requireBlock(hub, ref, block) {
+	if (block.until !== void 0) requireMainlineTarget(hub, block.until);
 	const targets = [waitingForAction(block.waitingFor), block.until === void 0 ? void 0 : untilTarget(block.until)];
 	for (const target of targets) {
 		if (!target) continue;
@@ -2700,10 +2783,23 @@ function requireBlock(hub, ref, block) {
 		if (found.ref === ref) throw new WriteError(`action ${ref} cannot wait for itself${target === ref ? "" : ` (${target} was handed off to it)`}`);
 	}
 }
+/** A `mainline-done` condition has to name a mainline in this hub, or a hub registered here. */
+function requireMainlineTarget(hub, until) {
+	const parsed = parseUntil(until);
+	if (parsed?.kind !== "mainline-done") return;
+	const ref = parseRef(parsed.mainline);
+	if (ref?.kind !== "mainline") return;
+	const config = readConfigIn(hub);
+	if (ref.hub !== void 0 && ref.hub !== config.hub) {
+		if (!config.hubs?.[ref.hub]) throw new WriteError(`hub "${ref.hub}" is not registered; run "mainflow hub add ${ref.hub} <path>" first`);
+		return;
+	}
+	mainlineDirIn(hub, ref.mainline);
+}
 /** The action an `until` waits for; throws when the condition matches none of the forms. */
 function untilTarget(until) {
 	const parsed = parseUntil(until);
-	if (!parsed) throw new WriteError(`--until takes a condition like commit:{branch}:{text}, action-done:{sessionId}#a{NNN} or file:{relative path}, got "${until}"`);
+	if (!parsed) throw new WriteError(`--until takes a condition like ${UNTIL_FORMS.map((f) => f.format).join(", ")}, got "${until}"`);
 	return parsed.kind === "action-done" ? `${parsed.session}#${parsed.action}` : void 0;
 }
 function updateAction(hub, input, ctx) {
@@ -3917,11 +4013,78 @@ function actionState(root, ref) {
 		detail: `${ref}${via} is ${found.action.status}`
 	};
 }
+/**
+* Whether a mainline is done. It can no longer come true when the mainline was dropped, does not exist, or its
+* hub is not registered here. A registered hub that is missing on this machine or fails to load may return, so
+* that case keeps waiting. A prefix equal to this hub's own name reads the local hub.
+*/
+function mainlineState(root, text) {
+	const ref = parseRef(text);
+	if (ref?.kind !== "mainline") return {
+		met: false,
+		unreachable: true,
+		detail: `"${text}" is not a mainline reference like m001 or other-hub:m001`
+	};
+	let target = root;
+	try {
+		const config = readConfig(root);
+		if (ref.hub !== void 0 && ref.hub !== config.hub) {
+			const path = config.hubs?.[ref.hub];
+			if (path === void 0) return {
+				met: false,
+				unreachable: true,
+				detail: `hub "${ref.hub}" is not registered, so ${text} can never be read; run "mainflow hub add ${ref.hub} <path>"`
+			};
+			target = remoteRoot(root, path);
+			if (!isHubRoot(target)) return {
+				met: false,
+				detail: `hub "${ref.hub}" is not at ${path} on this machine, so ${text} cannot be read yet`
+			};
+		}
+	} catch (error) {
+		return {
+			met: false,
+			detail: `the hub config cannot be read, so ${text} cannot be checked: ${error.message}`
+		};
+	}
+	try {
+		mainlineDir(target, ref.mainline);
+	} catch {
+		return {
+			met: false,
+			unreachable: true,
+			detail: `mainline ${text} does not exist, so it will never be done`
+		};
+	}
+	let status;
+	try {
+		status = readFrontMatter(mainlineFile(target, ref.mainline), mainlineSchema).data.status;
+	} catch (error) {
+		return {
+			met: false,
+			detail: `mainline ${text} cannot be read yet: ${error.message}`
+		};
+	}
+	if (status === "done") return {
+		met: true,
+		detail: `mainline ${text} is done`
+	};
+	if (status === "dropped") return {
+		met: false,
+		unreachable: true,
+		detail: `mainline ${text} was dropped, so it will never be done`
+	};
+	return {
+		met: false,
+		detail: `mainline ${text} is ${status}`
+	};
+}
 /** Check a wait condition once. */
 function untilState(root, until) {
 	switch (until.kind) {
 		case "commit": return commitState(root, until.branch, until.text);
 		case "action-done": return actionState(root, `${until.session}#${until.action}`);
+		case "mainline-done": return mainlineState(root, until.mainline);
 		case "file": return existsSync(resolve(root, until.path)) ? {
 			met: true,
 			detail: `${until.path} exists`
@@ -7939,4 +8102,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-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 };
+export { nowMinute as $, mayDecorate as A, applyOperation as B, readSession as C, splitFrontMatter as Ct, 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, unavailableHubs as Q, renumberText as R, loadSessions as S, contentHash as St, grantScope as T, loadConfig as U, checkHubName as V, loadHub as W, refIndex as X, memberOfGroup as Y, remoteMembers as Z, initHub as _, findHubRoot as _t, openInApp as a, MAX_FILE_BYTES as at, sessionBriefing as b, DATA_DIR as bt, siteBlock as c, comparePaths as ct, retroReport as d, requestTime as dt, readYaml as et, retroReportFromReceiver as f, textBytes as ft, setArchivedMany as g, currentBranch as gt, ARCHIVE_KINDS as h, requireSlug as ht, hostName as i, MAX_BLOB_BYTES as it, attributeTrace as j, headerLine as k, syncHost as l, exceedsFileLimit as lt, RETRY_RULES as m, TASK_FILE as mt, DEFAULT_UI_PORT as n, ACCESS_HEADERS as nt, removeDanglingLinks as o, ROUTES as ot, receiverFromEnv as p, MAINLINE_FILE as pt, mainlineEdges as q, caddySites as r, BLOB_HASH as rt, removeHostLink as s, SOCKET_MAX_AGE_CLOSE as st, APP_BUNDLE_ID as t, nodeStorage as tt, migrateHub as u, readsAsText as ut, untilState as v, worktreesOf as vt, transcriptPath as w, turnReminder as x, WriteError as xt, duplicateClaimLines as y, ConflictError as yt, scopeOfPath as z };

package/dist/host.js

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

package/dist/{index-DgYB5u1f.d.ts → index-B32s8PHu.d.ts}

@@ -250,7 +250,8 @@ type Task = z.infer<typeof taskSchema>;
 /**
  * A condition a program can check, written `{kind}:{argument}`. `commit` holds once a commit message on the
  * branch contains the text, `action-done` once the action is done, `file` once the path exists under the hub
- * root. Git branch names cannot contain a colon, so the text after the branch may.
+ * root, `mainline-done` once the mainline (`m{NNN}` or `{hub}:m{NNN}`) is done. Git branch names cannot contain a
+ * colon, so the text after the branch may.
  */
 type Until = {
   kind: 'commit';
@@ -263,6 +264,9 @@ type Until = {
 } | {
   kind: 'file';
   path: string;
+} | {
+  kind: 'mainline-done';
+  mainline: string;
 };
 /**
  * Why a blocked action cannot move, what it waits for, and the condition a program checks to end the wait.

package/dist/{launch-D80CYPcm.js → launch-n2ZDF0BF.js}

@@ -1,4 +1,4 @@
-import { _t as DATA_DIR, i as hostName, l as syncHost, n as DEFAULT_UI_PORT, s as removeHostLink, vt as WriteError } from "./host-bnHYIwuY.js";
+import { bt as DATA_DIR, i as hostName, l as syncHost, n as DEFAULT_UI_PORT, s as removeHostLink, xt as WriteError } from "./host-BauijAdm.js";
 import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -276,7 +276,7 @@ async function launchUi(root, hub, configured, options) {
 		}
 		let server;
 		if (!reuse) {
-			const { serveUi } = await import("./ui-C4h4iLDu.js");
+			const { serveUi } = await import("./ui-C-laSyqU.js");
 			server = await serveUi(root, choice.port);
 			writeUiRecord(root, {
 				port: choice.port,

package/dist/launch.js

@@ -1,2 +1,2 @@
-import { a as networkProbe, c as realRoot, d as withUiLock, i as launchUi, l as startUiInBackground, n as choosePort, o as portCandidates, r as exitCodeFor, s as readUiRecord, t as PORT_SPAN, u as watchHubGone } from "./launch-D80CYPcm.js";
+import { a as networkProbe, c as realRoot, d as withUiLock, i as launchUi, l as startUiInBackground, n as choosePort, o as portCandidates, r as exitCodeFor, s as readUiRecord, t as PORT_SPAN, u as watchHubGone } from "./launch-n2ZDF0BF.js";
 export { PORT_SPAN, choosePort, exitCodeFor, launchUi, networkProbe, portCandidates, readUiRecord, realRoot, startUiInBackground, watchHubGone, withUiLock };