mainflow 0.38.0 → 0.40.0-beta.1

package/dist/{host-aYx3DYrv.js → host-erQ_Sr8U.js}

@@ -1,4 +1,4 @@
-import { A as TASK_SECTIONS, B as opsEntrySchema, C as SERVES_REF, D as SURVEY_LINES, E as SLUG, F as findingSchema, G as refExample, H as parseOpsLine, I as formatOpsEntry, J as taskSchema, K as refMainline, L as groupSchema, M as WORK_STATUS, N as configSchema, O as SURVEY_SECTION, P as decisionSchema, Q as stampMs, R as issueSchema, S as RESERVED_HUB_NAMES, T as SESSION_STATUS, U as parseRef, V as parseActionRef, W as parseUntil, X as waitingForRef, Y as waitingForAction, Z as OFFSET, _ as MAINLINE_SECTIONS, a as DECISION_SECTIONS, at as grantRepo, b as PRIORITIES, c as FINDING_SECTIONS, d as GROUP_SECTIONS, f as GROUP_STATUS, i as DECISION_BASES, it as grantForm, j as UNTIL_FORMS, k as TASK_REQUIRED_SECTIONS, l as FINDING_STATUS, m as ISSUE_SECTIONS, n as CLOSED_STATUS, nt as describeRequest, ot as parseGrantTarget, q as sessionSchema, r as DECIDERS, rt as grantCovers, s as DEFAULT_CATEGORIES, v as MAINLINE_STATUS, w as SESSION_ID, x as REF_EXAMPLES, y as MERGE_STATES, z as mainlineSchema } from "./dist-CZYL5PJ4.js";
+import { $ as stampMs, A as TASK_REQUIRED_SECTIONS, B as mainlineSchema, C as RESERVED_HUB_NAMES, D as SLUG, E as SESSION_STATUS, F as decisionSchema, G as parseUntil, H as parseActionRef, I as findingSchema, J as sessionSchema, K as refExample, L as formatOpsEntry, M as UNTIL_FORMS, N as WORK_STATUS, O as SURVEY_LINES, P as configSchema, Q as OFFSET, R as groupSchema, S as REF_EXAMPLES, T as SESSION_ID, U as parseOpsLine, V as opsEntrySchema, W as parseRef, X as waitingForAction, Y as taskSchema, Z as waitingForRef, a as DECISION_SECTIONS, at as grantForm, b as MERGE_STATES, c as FINDING_SECTIONS, d as GROUP_SECTIONS, f as GROUP_STATUS, h as ISSUE_SECTIONS, i as DECISION_BASES, it as grantCovers, j as TASK_SECTIONS, k as SURVEY_SECTION, l as FINDING_STATUS, n as CLOSED_STATUS, ot as grantRepo, q as refMainline, r as DECIDERS, rt as describeRequest, s as DEFAULT_CATEGORIES, st as parseGrantTarget, v as MAINLINE_SECTIONS, w as SERVES_REF, x as PRIORITIES, y as MAINLINE_STATUS, z as issueSchema } from "./dist-zSabglPq.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";
@@ -459,6 +459,11 @@ function decisionFileIn(hub, mainline, decision) {
 	return file;
 }
 const sessionFileIn = (id) => `${SESSIONS_DIR}/${id}.yaml`;
+function groupFileIn(hub, id) {
+	const file = entryFileIn(hub, GROUPS_DIR, id);
+	if (!file) throw new WriteError(`group ${id} not found`);
+	return file;
+}
 //#endregion
 //#region ../core/dist/ops/format.js
 /** Why a hub whose data format is `found` cannot be written by this CLI; null when it can. */
@@ -751,6 +756,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 groupFile = (root, id) => onDisk(root, groupFileIn(nodeStorage(root), id));
 const readConfig = (root) => readConfigIn(nodeStorage(root));
 //#endregion
 //#region ../core/dist/refs.js
@@ -802,11 +808,18 @@ 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
-	});
+	for (const g of hub.groups ?? []) {
+		index.set(g.id, {
+			kind: "group",
+			title: g.title,
+			status: g.status
+		});
+		for (const r of g.criteria ?? []) index.set(`${g.id}#${r.id}`, {
+			kind: "groupCriterion",
+			title: r.text,
+			status: itemStatus(r)
+		});
+	}
 	return index;
 }
 const isHubRoot = (dir) => existsSync(join(dir, DATA_DIR, "config.yaml"));
@@ -1358,6 +1371,7 @@ function loadHub(root, options = {}) {
 	const findings = hubDocs(join(dataDir, "findings"), findingSchema);
 	const groups = hubDocs(join(dataDir, "groups"), groupSchema);
 	problems.push(...groupProblems(config.hub, groups, mainlines, hubIssues, unreadable));
+	for (const g of groups) problems.push(...grantProblems(g, config), ...listGaps(g.file, "criteria", g.criteria ?? [], g.status === "open"));
 	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) => {
@@ -1600,7 +1614,10 @@ 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 g of groups) {
+		add(g.file, g, g.id);
+		items(g.file, "criteria", g.criteria ?? []);
+	}
 	for (const p of pending) {
 		const parsed = parseRef(p.ref);
 		if (!parsed) continue;
@@ -1657,7 +1674,7 @@ function repoPathProblems(root, config) {
 	});
 }
 /**
-* What the schema cannot see about a mainline's grants: ids must be unique, since the file is edited directly,
+* What the schema cannot see about a mainline's or a group's grants: ids must be unique, since the file is edited directly,
 * and a target that names a repository must name one listed in config.yaml.
 */
 function grantProblems(mainline, config) {
@@ -1688,24 +1705,28 @@ const isOpen$2 = (kind, status) => !CLOSED_STATUS[kind].includes(status);
 * entries are skipped, because their evidence already says what was done. Ids must also be unique within
 * a list, since the files are edited directly and nothing else allocates them.
 */
-function contentGaps(mainline, tasks) {
+/** Ids unique within a list, and every open item saying what has to be true to check it. */
+function listGaps(file, field, items, open) {
 	const gaps = [];
-	const list = (file, field, items, open) => {
-		const seen = /* @__PURE__ */ new Set();
-		items.forEach((item, i) => {
-			if (seen.has(item.id)) gaps.push({
-				file,
-				field: `${field}.${i}.id`,
-				message: `${item.id} is used twice; give it the next free id`
-			});
-			seen.add(item.id);
-			if (open && !item.done && !item.dropped && !item.doneWhen?.trim()) gaps.push({
-				file,
-				field: `${field}.${i}.doneWhen`,
-				message: `${item.id} is open and needs doneWhen: what has to be true to check it`
-			});
+	const seen = /* @__PURE__ */ new Set();
+	items.forEach((item, i) => {
+		if (seen.has(item.id)) gaps.push({
+			file,
+			field: `${field}.${i}.id`,
+			message: `${item.id} is used twice; give it the next free id`
 		});
-	};
+		seen.add(item.id);
+		if (open && !item.done && !item.dropped && !item.doneWhen?.trim()) gaps.push({
+			file,
+			field: `${field}.${i}.doneWhen`,
+			message: `${item.id} is open and needs doneWhen: what has to be true to check it`
+		});
+	});
+	return gaps;
+}
+function contentGaps(mainline, tasks) {
+	const gaps = [];
+	const list = (file, field, items, open) => gaps.push(...listGaps(file, field, items, open));
 	const mainlineOpen = isOpen$2("mainline", mainline.status);
 	list(mainline.file, "criteria", mainline.criteria, mainlineOpen);
 	if (mainlineOpen && tasks.length > 0) for (const message of surveyGaps(mainline.body)) gaps.push({
@@ -1846,6 +1867,7 @@ function requireExisting(hub, ref) {
 			entryFile(hub, FINDINGS_DIR, parsed.finding, "finding");
 			return;
 		case "group":
+		case "groupCriterion":
 			entryFile(hub, GROUPS_DIR, parsed.group, "group");
 			return;
 		default:
@@ -2029,6 +2051,26 @@ function createGroup(hub, input, ctx) {
 		file
 	});
 }
+/** The mainlines and issues of this hub that are members of group `id` and not yet settled, by id. */
+function openMembers(hub, id) {
+	const own = readConfigIn(hub).hub;
+	const isMember = (value) => value === id || value === `${own}:${id}`;
+	const read = (path) => splitFrontMatter(hub.read(path) ?? "").data ?? {};
+	const mainlines = hub.list(MAINLINES_DIR).filter((e) => e.dir).map((e) => read(`${MAINLINES_DIR}/${e.name}/${MAINLINE_FILE}`));
+	const issues = hub.list(ISSUES_DIR).filter((e) => !e.dir && e.name.endsWith(".md")).map((e) => read(`${ISSUES_DIR}/${e.name}`));
+	return [...mainlines.filter((m) => isMember(m.group) && !closes("mainline", m.status ?? "")), ...issues.filter((i) => isMember(i.group) && i.status !== "closed")].map((d) => d.id ?? "?");
+}
+/**
+* Marking a group done is a claim that its goal is reached and its work is settled, so it is refused while a
+* criterion is still open or a mainline or issue of this hub in the group is not finished. The message names each one.
+* Members in other hubs are not read here, since the writer only sees this hub.
+*/
+function requireGroupDone(hub, id, g) {
+	const open = (g.criteria ?? []).filter((c) => !c.done && !c.dropped).map((c) => `${id}#${c.id}`);
+	const members = openMembers(hub, id);
+	if (!open.length && !members.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 the group file)` : "", members.length ? `unfinished members ${members.join(", ")} (finish them, or move them out with mainline set or issue set --group none)` : ""].filter(Boolean).join("; ")}`);
+}
 function setGroup(hub, input, ctx) {
 	const { patch } = input;
 	requireRef(input.id, "group");
@@ -2041,6 +2083,7 @@ function setGroup(hub, input, ctx) {
 	const draft = new Draft(hub);
 	return draft.result(editFrontMatter(draft, entryFile(draft, GROUPS_DIR, input.id, "group"), groupSchema, (g) => {
 		if (status) {
+			if (status === "done" && g.status !== "done") requireGroupDone(draft, input.id, g);
 			g.status = status;
 			stampClosed(g, closes("group", status), day);
 		}
@@ -2179,45 +2222,69 @@ function setMainlineArchived(hub, input, ctx) {
 		else delete m.archivedAt;
 	}, input.expectedVersion));
 }
-/** Add an open criterion at the end of the mainline's list, numbered by the context's allocator. */
+/** The mainline or group a criterion list belongs to, from `m001` or `w001`. */
+function requireOwner(input) {
+	const ref = parseRef(input);
+	if (ref?.kind !== "mainline" && ref?.kind !== "group") throw new WriteError(`expected a mainline or group reference like ${refExample("mainline")} or ${refExample("group")}, got "${input}"`);
+	return input;
+}
+/** The owner and criterion ids of `m001#r001` or `w001#r001`. */
+function requireCriterionRef(input) {
+	const ref = parseRef(input);
+	if (ref?.kind === "criterion") return {
+		owner: ref.mainline,
+		criterion: ref.criterion
+	};
+	if (ref?.kind === "groupCriterion") return {
+		owner: ref.group,
+		criterion: ref.criterion
+	};
+	throw new WriteError(`expected a criterion reference like ${refExample("criterion")} or ${refExample("groupCriterion")}, got "${input}"`);
+}
+/** Edit the criteria of the mainline or group `owner`; a group written before criteria existed gets an empty list first. */
+function editCriteria(draft, owner, mutate, expectedVersion) {
+	if (parseRef(owner)?.kind === "group") return editFrontMatter(draft, groupFileIn(draft, owner), groupSchema, (g) => mutate(g.criteria ??= []), expectedVersion);
+	return editFrontMatter(draft, mainlineFileIn(draft, owner), mainlineSchema, (m) => mutate(m.criteria), expectedVersion);
+}
+/** Add an open criterion at the end of the list of the mainline or group in `mainline`, numbered by the context's allocator. */
 function addCriterion(hub, input, ctx) {
-	requireRef(input.mainline, "mainline");
-	const fields = newListItem(input, `criterion add ${input.mainline}`);
+	const owner = requireOwner(input.mainline);
+	const fields = newListItem(input, `criterion add ${owner}`);
 	const draft = new Draft(hub);
 	let ref = "";
-	editFrontMatter(draft, mainlineFileIn(draft, input.mainline), mainlineSchema, (m) => {
+	editCriteria(draft, owner, (criteria) => {
 		const id = draft.number(ctx, {
 			prefix: "r",
-			taken: m.criteria.map((c) => c.id),
-			ref: (id) => `${input.mainline}#${id}`
+			taken: criteria.map((c) => c.id),
+			ref: (id) => `${owner}#${id}`
 		});
-		m.criteria.push({
+		criteria.push({
 			id,
 			...fields
 		});
-		ref = `${input.mainline}#${id}`;
+		ref = `${owner}#${id}`;
 	});
 	return draft.result({ ref });
 }
 function setCriterion(hub, input, ctx) {
-	const ref = requireRef(input.ref, "criterion");
+	const { owner, criterion: id } = requireCriterionRef(input.ref);
 	if (input.done && !input.evidence) throw new WriteError(`marking ${input.ref} as met needs evidence, e.g. --evidence mainflow@25e4165`);
 	const { day } = stamps(ctx);
 	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, mainlineFileIn(draft, ref.mainline), mainlineSchema, (m) => {
-		const criterion = m.criteria.find((c) => c.id === ref.criterion);
+	return draft.result(editCriteria(draft, owner, (criteria) => {
+		const criterion = criteria.find((c) => c.id === id);
 		if (!criterion) throw new WriteError(`criterion ${input.ref} not found`);
-		setListItem(criterion, input.done, input.evidence, `${input.ref} is dropped; remove dropped and supersededBy in ${MAINLINE_FILE} to bring it back before checking it`, day);
+		setListItem(criterion, input.done, input.evidence, `${input.ref} is dropped; remove dropped and supersededBy in ${parseRef(owner)?.kind === "group" ? "the group file" : MAINLINE_FILE} to bring it back before checking it`, day);
 	}, input.expectedVersion));
 }
 /** Rewrite a criterion's text or doneWhen, leaving done and evidence as they are. */
 function setCriterionText(hub, input) {
-	const ref = requireRef(input.ref, "criterion");
+	const { owner, criterion: id } = requireCriterionRef(input.ref);
 	const { patch } = input;
 	if (patch.text === void 0 && patch.doneWhen === void 0) throw new WriteError(`${input.ref} needs --text or --done-when, e.g. --text "CLI can create mainlines"`);
 	const draft = new Draft(hub);
-	return draft.result(editFrontMatter(draft, mainlineFileIn(draft, ref.mainline), mainlineSchema, (m) => {
-		const criterion = m.criteria.find((c) => c.id === ref.criterion);
+	return draft.result(editCriteria(draft, owner, (criteria) => {
+		const criterion = criteria.find((c) => c.id === id);
 		if (!criterion) throw new WriteError(`criterion ${input.ref} not found`);
 		if (patch.text !== void 0) criterion.text = patch.text;
 		if (patch.doneWhen !== void 0) criterion.doneWhen = patch.doneWhen;
@@ -2668,14 +2735,21 @@ function resolveActionIn(hub, ref) {
 }
 /**
 * Every served checklist item or criterion must exist, so a session never points at work that is not in a
-* mainline. A criterion stands in while the mainline has no task for it yet, as when it is still being surveyed
-* and planned. Its mainline must still be open: follow-up work on an ended one either reopens it with a criterion
+* mainline or a group. A criterion stands in while the mainline has no task for it yet, as when it is still being
+* surveyed and planned; a group's criterion (w001#r001) stands for work that belongs to the group as a whole. Its
+* mainline or group must still be open: follow-up work on an ended one either reopens it with a criterion
 * or task for the follow-up, or starts a new mainline, so the follow-up is tracked instead of hanging off finished work.
 */
 function requireServes(hub, serves) {
 	for (const ref of serves) {
 		const parsed = parseRef(ref);
-		if (!SERVES_REF.test(ref) || parsed?.kind !== "checklistItem" && parsed?.kind !== "criterion") throw new WriteError(`--serves takes checklist items like m001/t002#c003 or criteria like m001#r001, got "${ref}"`);
+		if (!SERVES_REF.test(ref) || parsed?.kind !== "checklistItem" && parsed?.kind !== "criterion" && parsed?.kind !== "groupCriterion") throw new WriteError(`--serves takes checklist items like m001/t002#c003 or criteria like m001#r001 or w001#r001, got "${ref}"`);
+		if (parsed.kind === "groupCriterion") {
+			const group = readFrontMatterIn(hub, groupFileIn(hub, parsed.group), groupSchema);
+			if (group.status !== "open") throw new WriteError(`${parsed.group} is ${group.status}; to continue it, run "group set ${parsed.group} --status open" and add a criterion for the follow-up`);
+			if (!(group.criteria ?? []).some((r) => r.id === parsed.criterion)) throw new WriteError(`criterion ${ref} not found`);
+			continue;
+		}
 		const mainline = readFrontMatterIn(hub, mainlineFileIn(hub, parsed.mainline), mainlineSchema);
 		if (CLOSED_STATUS.mainline.includes(mainline.status)) throw new WriteError(`${parsed.mainline} is ${mainline.status}; to continue it, run "mainline set ${parsed.mainline} --status active" and add a criterion or task for the follow-up, or start a new mainline with "new mainline"`);
 		if (parsed.kind === "criterion") {
@@ -3231,6 +3305,7 @@ const rewriteOf = ({ from, to }) => {
 		case "task":
 		case "decision":
 		case "criterion": return short((s) => s.mainline === ref.mainline);
+		case "groupCriterion": return short((s) => s.group === ref.group);
 		case "checklistItem": return short((s) => s.mainline === ref.mainline && s.task === ref.task);
 		default: return {
 			full: from,
@@ -3260,6 +3335,10 @@ const ENTRY = /^([mtdifw]\d{3})(-.+)$/;
 function scopeOfPath(path) {
 	const [top, second, third, fourth] = path.split("/");
 	if (top === "local" && second === "sessions" && third?.endsWith(".yaml") && fourth === void 0) return { session: third.slice(0, -5) };
+	if (top === "groups" && second && third === void 0) {
+		const group = ENTRY.exec(second)?.[1];
+		return group ? { group } : {};
+	}
 	if (top !== "mainlines" || !second) return {};
 	const mainline = ENTRY.exec(second)?.[1];
 	const task = third === "tasks" && fourth ? ENTRY.exec(fourth)?.[1] : void 0;
@@ -3678,6 +3757,8 @@ const mayDecorate = (text) => /m\d{3}|[ifw]\d{3}|\.mainflow\/mainlines/.test(tex
 //#region ../core/dist/grants.js
 /** Mainline statuses whose grants apply. */
 const GRANTING_STATUS = ["active", "planning"];
+/** Group statuses whose grants apply. */
+const GRANTING_GROUP_STATUS = ["open"];
 /**
 * The grants in effect for a session. Reading a mainline that is missing or invalid throws, so a caller that
 * must fail closed catches it and asks.
@@ -3702,13 +3783,21 @@ function grantScope(root, session) {
 		return parsed ? refMainline(parsed) : void 0;
 	};
 	const mainlines = [...new Set(action.serves.flatMap((ref) => mainlineOf(ref) ?? []))];
-	if (mainlines.length === 0) return {
+	const direct = /* @__PURE__ */ new Map();
+	for (const ref of action.serves) {
+		const parsed = parseRef(ref);
+		if (parsed?.kind === "groupCriterion" && !direct.has(parsed.group)) direct.set(parsed.group, ref);
+	}
+	if (mainlines.length === 0 && direct.size === 0) return {
 		ok: false,
 		reason: `${action.id} 沒有服務任何 checklist 項目或解決條件`
 	};
 	const grants = [];
 	const served = {};
 	const closed = [];
+	const hubName = readConfig(root).hub;
+	const groups = new Map(direct);
+	const reachedByMainline = /* @__PURE__ */ new Set();
 	for (const id of mainlines) {
 		const mainline = readFrontMatter(mainlineFile(root, id), mainlineSchema).data;
 		if (!GRANTING_STATUS.includes(mainline.status)) {
@@ -3717,15 +3806,42 @@ function grantScope(root, session) {
 		}
 		served[id] = action.serves.find((ref) => mainlineOf(ref) === id);
 		for (const grant of mainline.grants ?? []) grants.push({
-			mainline: id,
+			owner: id,
 			grant,
 			ref: `${id}#${grant.id}`
 		});
+		const own = mainline.group ? splitGroup(mainline.group, hubName) : void 0;
+		if (own && own.hub === void 0 && !groups.has(own.id)) {
+			groups.set(own.id, served[id]);
+			reachedByMainline.add(own.id);
+		}
+	}
+	for (const [id, via] of groups) {
+		let group;
+		try {
+			group = readFrontMatter(groupFile(root, id), groupSchema).data;
+		} catch (error) {
+			if (reachedByMainline.has(id)) continue;
+			throw error;
+		}
+		if (!GRANTING_GROUP_STATUS.includes(group.status)) {
+			closed.push(`${id} 是 ${group.status}`);
+			continue;
+		}
+		served[id] = via;
+		for (const grant of group.grants ?? []) grants.push({
+			owner: id,
+			grant,
+			ref: `${id}#${grant.id}`
+		});
+	}
+	if (Object.keys(served).length === 0) {
+		const what = [closed.some((c) => c.startsWith("m")) ? "主脈絡" : "", closed.some((c) => c.startsWith("w")) ? "組" : ""].filter(Boolean).join("或");
+		return {
+			ok: false,
+			reason: `${action.id} 服務的${what}已不在進行中（${closed.join("、")}），授權不再生效`
+		};
 	}
-	if (Object.keys(served).length === 0) return {
-		ok: false,
-		reason: `${action.id} 服務的主脈絡已不在進行中（${closed.join("、")}），授權不再生效`
-	};
 	return {
 		ok: true,
 		scope: {
@@ -3806,8 +3922,18 @@ function setReminderDigest(root, id, digest) {
 //#region ../core/dist/briefing.js
 function describe(root, ref) {
 	const parsed = parseRef(ref);
-	if (parsed?.kind !== "checklistItem" && parsed?.kind !== "criterion") return null;
+	if (parsed?.kind !== "checklistItem" && parsed?.kind !== "criterion" && parsed?.kind !== "groupCriterion") return null;
 	try {
+		if (parsed.kind === "groupCriterion") {
+			const group = readFrontMatter(groupFile(root, parsed.group), groupSchema).data;
+			const criterion = group.criteria?.find((r) => r.id === parsed.criterion);
+			return criterion ? {
+				ref,
+				text: criterion.text,
+				checked: criterion.done,
+				where: `${group.id} ${group.title} › 解決條件`
+			} : null;
+		}
 		const mainline = readFrontMatter(mainlineFile(root, parsed.mainline), mainlineSchema).data;
 		if (parsed.kind === "criterion") {
 			const criterion = mainline.criteria.find((r) => r.id === parsed.criterion);
@@ -4010,7 +4136,7 @@ function sessionBriefing(root, session, options) {
 		lines.push(doing ? `目前行動：${doing.id} ${doing.do}` : "目前沒有進行中的行動。");
 		if (doing) lines.push(`服務：${servedLine(root, doing)}`);
 		const grants = grantLines(root, session);
-		if (grants.length > 0) lines.push("目前行動服務的主脈絡預先授權了這些動作：", ...grants);
+		if (grants.length > 0) lines.push("目前行動服務的主脈絡與所屬的組預先授權了這些動作：", ...grants);
 		if (upcoming.length > 0) lines.push(`接下來：${upcoming.map((a) => `${a.id} ${a.do}`).join("、")}`);
 		const blocked = session.actions.filter((a) => a.status === "blocked");
 		if (blocked.length > 0) lines.push(`等外部條件：${blocked.map(waitingLine).join("；")}`);
@@ -4052,7 +4178,7 @@ function turnReminder(root, session, options) {
 		else setReminderDigest(root, session.id, digest);
 	} catch {}
 	const once = (lines, summary, full) => lines.length === 0 ? [] : repeated ? [summary] : full;
-	const granted = once(grants, `- 預先授權同上一輪，共 ${grants.length} 條。`, ["- 目前行動服務的主脈絡預先授權了這些動作：", ...grants.map((g) => `  ${g}`)]);
+	const granted = once(grants, `- 預先授權同上一輪，共 ${grants.length} 條。`, ["- 目前行動服務的主脈絡與所屬的組預先授權了這些動作：", ...grants.map((g) => `  ${g}`)]);
 	const waiting = once(waiters, `- 等待行同上一輪，共 ${waiters.length} 條。`, waiters.map((w) => `- ${w}`));
 	const warned = once(warnings, `- 佇列提醒同上一輪，共 ${warnings.length} 條。`, warnings.map((w) => `- ${w}`));
 	return [
@@ -8035,6 +8161,77 @@ function migrateHub(root, options = {}) {
 	}).value;
 }
 //#endregion
+//#region ../core/dist/group-plan.js
+/** Sessions that can still hold work: not archived, and active or paused. */
+const live = (s) => !s.archivedAt && (s.status === "active" || s.status === "paused");
+/** Order `refs` so each comes after the ones it depends on; members in a dependency loop keep their given order at the end. */
+function ordered(refs, dependsOn) {
+	const done = /* @__PURE__ */ new Set();
+	const out = [];
+	for (let progressed = true; progressed && out.length < refs.length;) {
+		progressed = false;
+		for (const ref of refs) {
+			if (done.has(ref) || !(dependsOn.get(ref) ?? []).every((d) => done.has(d))) continue;
+			done.add(ref);
+			out.push(ref);
+			progressed = true;
+			break;
+		}
+	}
+	return [...out, ...refs.filter((r) => !done.has(r))];
+}
+function groupPlan(hub, sessions, groupId) {
+	const own = hub.config.hub;
+	const mainlines = hub.mainlines.filter((m) => memberOfGroup(m.group, groupId, own));
+	const issues = hub.issues.filter((i) => memberOfGroup(i.group, groupId, own));
+	const docs = [...mainlines.map((m) => ({
+		ref: m.id,
+		kind: "mainline",
+		title: m.title,
+		status: m.status,
+		open: !CLOSED_STATUS.mainline.includes(m.status),
+		links: m.links
+	})), ...issues.map((i) => ({
+		ref: i.id,
+		kind: "issue",
+		title: i.title,
+		status: i.status,
+		open: i.status !== "closed",
+		links: i.links
+	}))];
+	const refs = docs.map((d) => d.ref);
+	const dependsOn = new Map(docs.map((d) => [d.ref, (d.links ?? []).filter((l) => l.rel === "depends-on").map((l) => parseRef(l.to)?.hub === own ? l.to.slice(l.to.indexOf(":") + 1) : l.to).filter((to) => refs.includes(to) && to !== d.ref)]));
+	const active = (matches) => sessions.filter(live).flatMap((s) => s.actions.flatMap((a) => (a.status === "doing" || a.status === "blocked") && a.serves.some(matches) ? [{
+		session: s.id,
+		action: a.id,
+		status: a.status,
+		do: a.do
+	}] : []));
+	const mainlineOf = (served) => {
+		const parsed = parseRef(served);
+		return parsed ? refMainline(parsed) : void 0;
+	};
+	const byRef = new Map(docs.map((d) => [d.ref, d]));
+	return {
+		members: ordered(refs, dependsOn).map((ref) => {
+			const d = byRef.get(ref);
+			return {
+				ref,
+				kind: d.kind,
+				title: d.title,
+				status: d.status,
+				open: d.open,
+				dependsOn: dependsOn.get(ref) ?? [],
+				active: d.kind === "mainline" ? active((s) => mainlineOf(s) === ref) : []
+			};
+		}),
+		active: active((s) => {
+			const parsed = parseRef(s);
+			return parsed?.kind === "groupCriterion" && parsed.group === groupId;
+		})
+	};
+}
+//#endregion
 //#region src/host.ts
 const DEFAULT_UI_PORT = 4320;
 const hostName = (hub) => `${hub}.mainflow.localhost`;
@@ -8233,4 +8430,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { nowMinute as $, mayDecorate as A, applyOperation as B, readSession as C, WriteError 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, DATA_DIR as St, grantScope as T, splitFrontMatter as Tt, loadConfig as U, checkHubName as V, loadHub as W, refIndex as X, memberOfGroup as Y, remoteMembers as Z, initHub as _, requireSlug as _t, openInApp as a, MAX_FILE_BYTES as at, sessionBriefing as b, worktreesOf 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, TASK_FILE as gt, ARCHIVE_KINDS as h, MAINLINE_FILE 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, hubFormatVersion as mt, DEFAULT_UI_PORT as n, ACCESS_HEADERS as nt, removeDanglingLinks as o, ROUTES as ot, receiverFromEnv as p, formatMismatch 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, currentBranch as vt, transcriptPath as w, contentHash as wt, turnReminder as x, ConflictError as xt, duplicateClaimLines as y, findHubRoot as yt, scopeOfPath as z };
+export { unavailableHubs as $, headerLine as A, scopeOfPath as B, loadSessions as C, worktreesOf as Ct, matchGrants as D, contentHash as Dt, grantScope as E, WriteError as Et, applyOffline as F, loadHub as G, checkHubName as H, renumberRequest as I, mainlineEdges as J, sectionText as K, renumberFiles as L, attributeTrace as M, traceTranscript as N, decorateReply as O, splitFrontMatter as Ot, transcriptTitle as P, remoteMembers as Q, renumberPath as R, turnReminder as S, findHubRoot as St, transcriptPath as T, DATA_DIR as Tt, HubError as U, applyOperation as V, loadConfig as W, memberOfGroup as X, linksInto as Y, refIndex as Z, setArchivedMany as _, hubFormatVersion as _t, openInApp as a, ACCESS_HEADERS as at, duplicateClaimLines as b, requireSlug as bt, siteBlock as c, MAX_FILE_BYTES as ct, migrateHub as d, comparePaths as dt, taskFile as et, retroReport as f, exceedsFileLimit as ft, ARCHIVE_KINDS as g, formatMismatch as gt, RETRY_RULES as h, textBytes as ht, hostName as i, nodeStorage as it, mayDecorate as j, endsWithMarker as k, syncHost as l, ROUTES as lt, receiverFromEnv as m, requestTime as mt, DEFAULT_UI_PORT as n, readFrontMatter as nt, removeDanglingLinks as o, BLOB_HASH as ot, retroReportFromReceiver as p, readsAsText as pt, dependencyGraph as q, caddySites as r, readYaml as rt, removeHostLink as s, MAX_BLOB_BYTES as st, APP_BUNDLE_ID as t, nowMinute as tt, groupPlan as u, SOCKET_MAX_AGE_CLOSE as ut, initHub as v, MAINLINE_FILE as vt, readSession as w, ConflictError as wt, sessionBriefing as x, currentBranch as xt, untilState as y, TASK_FILE as yt, renumberText 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-aYx3DYrv.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-erQ_Sr8U.js";
 export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, removeDanglingLinks, removeHostLink, siteBlock, syncHost };

package/dist/{index-BH9gpiap.d.ts → index-Dk4fCI7q.d.ts}

@@ -15,7 +15,10 @@ declare const ID_PATTERNS: {
   readonly grant: RegExp;
 };
 declare const CHECKLIST_REF: RegExp;
-/** What an action may serve: a checklist item, or a mainline's criterion while the mainline has no task for it yet. */
+/**
+ * What an action may serve: a checklist item, or a mainline's criterion while the mainline has no task for it yet,
+ * or a group's criterion (`w017#r001`).
+ */
 declare const SERVES_REF: RegExp;
 declare const SLUG: RegExp;
 /** One source the survey checks: the line's label, what it holds, and how it may be left unchecked. */
@@ -459,6 +462,31 @@ declare const groupSchema: z.ZodObject<{
     P3: "P3";
   }>>;
   trigger: z.ZodOptional<z.ZodString>;
+  criteria: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    text: z.ZodString;
+    doneWhen: z.ZodOptional<z.ZodString>;
+    done: z.ZodBoolean;
+    evidence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    doneAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dropped: z.ZodOptional<z.ZodBoolean>;
+    supersededBy: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+  }, z.core.$strip>>>;
+  grants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    action: z.ZodEnum<{
+      commit: "commit";
+      "install-prompts": "install-prompts";
+      "merge-pr": "merge-pr";
+      publish: "publish";
+      push: "push";
+      release: "release";
+      "sync-hubs": "sync-hubs";
+    }>;
+    target: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 type Group = z.infer<typeof groupSchema>;
 /** One line of ops/{YYYY-MM}.log: an external operation, append-only. */

package/dist/{launch-D38sNgXM.js → launch-I_JDTAtU.js}

@@ -1,4 +1,4 @@
-import { Ct as WriteError, St as DATA_DIR, i as hostName, l as syncHost, n as DEFAULT_UI_PORT, s as removeHostLink } from "./host-aYx3DYrv.js";
+import { Et as WriteError, Tt as DATA_DIR, i as hostName, l as syncHost, n as DEFAULT_UI_PORT, s as removeHostLink } from "./host-erQ_Sr8U.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-BwAp_sgf.js");
+			const { serveUi } = await import("./ui-CFtibt8x.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-D38sNgXM.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-I_JDTAtU.js";
 export { PORT_SPAN, choosePort, exitCodeFor, launchUi, networkProbe, portCandidates, readUiRecord, realRoot, startUiInBackground, watchHubGone, withUiLock };

package/dist/{operation-1oQ8lA9C.js → operation-Bf6DtnfD.js}

@@ -1,4 +1,4 @@
-import { $ as nowMinute, B as applyOperation, Ct as WriteError, F as renumberRequest, I as renumberFiles, L as renumberPath, P as applyOffline, R as renumberText, St as DATA_DIR, Tt as splitFrontMatter, at as MAX_FILE_BYTES, ct as comparePaths, dt as requestTime, ft as textBytes, it as MAX_BLOB_BYTES, lt as exceedsFileLimit, nt as ACCESS_HEADERS, ot as ROUTES, rt as BLOB_HASH, st as SOCKET_MAX_AGE_CLOSE, tt as nodeStorage, ut as readsAsText, wt as contentHash, xt as ConflictError, z as scopeOfPath } from "./host-aYx3DYrv.js";
+import { B as scopeOfPath, Dt as contentHash, Et as WriteError, F as applyOffline, I as renumberRequest, L as renumberFiles, Ot as splitFrontMatter, R as renumberPath, Tt as DATA_DIR, V as applyOperation, at as ACCESS_HEADERS, ct as MAX_FILE_BYTES, dt as comparePaths, ft as exceedsFileLimit, ht as textBytes, it as nodeStorage, lt as ROUTES, mt as requestTime, ot as BLOB_HASH, pt as readsAsText, st as MAX_BLOB_BYTES, tt as nowMinute, ut as SOCKET_MAX_AGE_CLOSE, wt as ConflictError, z as renumberText } from "./host-erQ_Sr8U.js";
 import { createHash, randomBytes } from "node:crypto";
 import { accessSync, appendFileSync, chmodSync, closeSync, constants, copyFileSync, createReadStream, createWriteStream, existsSync, linkSync, lstatSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/{ui-BwAp_sgf.js → ui-CFtibt8x.js}

@@ -1,8 +1,8 @@
-import { N as configSchema, d as GROUP_SECTIONS } from "./dist-CZYL5PJ4.js";
-import { C as readSession, Ct as WriteError, G as sectionText, H as HubError, J as linksInto, K as dependencyGraph, M as traceTranscript, N as transcriptTitle, S as loadSessions, St as DATA_DIR, U as loadConfig, W as loadHub, X as refIndex, Z as remoteMembers, a as openInApp, et as readYaml, g as setArchivedMany, h as ARCHIVE_KINDS, j as attributeTrace, q as mainlineEdges, w as transcriptPath, xt as ConflictError } from "./host-aYx3DYrv.js";
+import { P as configSchema } from "./dist-zSabglPq.js";
+import { C as loadSessions, Et as WriteError, G as loadHub, J as mainlineEdges, K as sectionText, M as attributeTrace, N as traceTranscript, P as transcriptTitle, Q as remoteMembers, T as transcriptPath, Tt as DATA_DIR, U as HubError, W as loadConfig, Y as linksInto, Z as refIndex, _ as setArchivedMany, a as openInApp, g as ARCHIVE_KINDS, q as dependencyGraph, rt as readYaml, u as groupPlan, w as readSession, wt as ConflictError } from "./host-erQ_Sr8U.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { A as isSynced, _ as readDaemon, a as remoteMode, b as readRemote, h as callDaemon, j as syncPaths, k as SYNC_DIR, m as DaemonUnavailable, n as hubWriter, r as writtenLines, y as watchTree } from "./operation-1oQ8lA9C.js";
-import { c as realRoot, f as CLI_VERSION, s as readUiRecord } from "./launch-D38sNgXM.js";
+import { A as isSynced, _ as readDaemon, a as remoteMode, b as readRemote, h as callDaemon, j as syncPaths, k as SYNC_DIR, m as DaemonUnavailable, n as hubWriter, r as writtenLines, y as watchTree } from "./operation-Bf6DtnfD.js";
+import { c as realRoot, f as CLI_VERSION, s as readUiRecord } from "./launch-I_JDTAtU.js";
 import { createRequire } from "node:module";
 import { closeSync, existsSync, lstatSync, openSync, readFileSync, readSync, realpathSync, statSync } from "node:fs";
 import { basename, dirname, extname, join, normalize, relative, resolve, sep } from "node:path";
@@ -133,11 +133,12 @@ function summarize(m) {
 }
 /** The first paragraph of a group's 說明 on one line, for the heading of its group in a list. */
 function groupSummary(body) {
-	return ((sectionText(body, GROUP_SECTIONS[0]) ?? "").split(/\n\s*\n/)[0] ?? "").replace(/\s+/g, " ").trim();
+	return ((sectionText(body, "說明") ?? "").split(/\n\s*\n/)[0] ?? "").replace(/\s+/g, " ").trim();
 }
-const groupView = (g) => ({
+const groupView = (hub, g) => ({
 	...g,
-	summary: groupSummary(g.body)
+	summary: groupSummary(g.body),
+	order: groupPlan(hub, [], g.id).members.map((m) => m.ref)
 });
 /** The 503 body for a config.yaml that cannot be used, with the hub's root left out of paths. */
 function configErrorView(root, error) {
@@ -241,7 +242,7 @@ function createApp(root, options = {}) {
 			version: CLI_VERSION,
 			repos: hub.config.repos,
 			mainlines: hub.mainlines.map(summarize),
-			groups: hub.groups.map(groupView),
+			groups: hub.groups.map((g) => groupView(hub, g)),
 			openIssues: hub.issues.filter((i) => i.status !== "closed").length,
 			validFindings: hub.findings.filter((f) => f.status === "valid").length,
 			problems: hub.problems