mainflow 0.37.0 → 0.39.0

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-B32s8PHu.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-Dk4fCI7q.js";
 import { z } from "zod";
 //#region ../core/dist/ids/allocators.d.ts
 /** The letters ids start with. */
@@ -123,8 +123,6 @@ interface MainlineInput {
   title: string;
   /** A group of this hub the mainline belongs to */
   group?: string;
-  /** plan or impl; without one the mainline is an impl one */
-  role?: string;
   priority?: string;
 }
 declare function createMainline(hub: HubReader, input: MainlineInput, ctx: OpContext): OpResult<{
@@ -137,12 +135,11 @@ interface MainlinePatch {
   status?: string;
   /** A group of this hub, or `none` (null) to leave every group */
   group?: string | null;
-  role?: string;
   priority?: string;
   expectedVersion?: string;
 }
 /**
- * Change a mainline's status, group, role or priority. Done is refused while criteria are open or decisions are
+ * Change a mainline's status, group or priority. Done is refused while criteria are open or decisions are
  * proposed; the other fields change without conditions, in the same write.
  */
 declare function setMainline(hub: HubReader, input: MainlinePatch, ctx: OpContext): OpResult<Mainline>;
@@ -157,7 +154,7 @@ declare function setMainlineArchived(hub: HubReader, input: {
   archived: boolean;
   expectedVersion?: string;
 }, ctx: OpContext): OpResult<Mainline>;
-/** Add an open criterion at the end of the mainline's list, numbered by the context's allocator. */
+/** Add an open criterion at the end of the list of the mainline or group in `mainline`, numbered by the context's allocator. */
 declare function addCriterion(hub: HubReader, input: ListItemInput & {
   mainline: string;
 }, ctx: OpContext): OpResult<{
@@ -168,7 +165,7 @@ declare function setCriterion(hub: HubReader, input: {
   done: boolean;
   evidence?: string;
   expectedVersion?: string;
-}, ctx: OpContext): OpResult<Mainline>;
+}, ctx: OpContext): OpResult<Mainline | Group>;
 /** What `criterion set` rewrites; at least one must be given. `done` stays as it is; use criterion check/uncheck for that. */
 interface CriterionTextPatch {
   text?: string;
@@ -179,7 +176,7 @@ declare function setCriterionText(hub: HubReader, input: {
   ref: string;
   patch: CriterionTextPatch;
   expectedVersion?: string;
-}): OpResult<Mainline>;
+}): OpResult<Mainline | Group>;
 //#endregion
 //#region ../core/dist/ops/tasks.d.ts
 interface TaskInput {

package/dist/hooks.js

@@ -1,6 +1,6 @@
-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, St as DATA_DIR, T as grantScope, W as loadHub, b as sessionBriefing, bt as worktreesOf, et as readYaml, i as hostName, k as headerLine, mt as hubFormatVersion, pt as formatMismatch, tt as nodeStorage, vt as currentBranch, x as turnReminder, yt as findHubRoot } from "./host-lY8ytTbw.js";
-import { n as hubWriter, r as writtenLines } from "./operation-BZ7CHB6J.js";
+import { P as configSchema, rt as describeRequest } from "./dist-zSabglPq.js";
+import { A as headerLine, C as loadSessions, Ct as DATA_DIR, D as matchGrants, E as grantScope, G as loadHub, O as decorateReply, S as turnReminder, U as HubError, bt as findHubRoot, ht as hubFormatVersion, i as hostName, j as mayDecorate, k as endsWithMarker, mt as formatMismatch, nt as nodeStorage, tt as readYaml, w as readSession, x as sessionBriefing, xt as worktreesOf, yt as currentBranch } from "./host-CIOd2WSh.js";
+import { n as hubWriter, r as writtenLines } from "./operation-DJARDCM0.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";
@@ -301,7 +301,7 @@ function grantableCall(payload) {
 }
 /** Outside a hub, or when deciding failed: ask for a grantable call, stay silent for any other. */
 function askWhenGrantable({ payload }, failure) {
-	const reason = failure.kind === "outside-hub" ? "不在 mainflow hub 裡，沒有主脈絡授權可用" : failure.kind === "error" ? `判斷授權時出錯：${failure.message}` : "hook 讀不到 PreToolUse 的輸入";
+	const reason = failure.kind === "outside-hub" ? "不在 mainflow hub 裡，沒有授權可用" : failure.kind === "error" ? `判斷授權時出錯：${failure.message}` : "hook 讀不到 PreToolUse 的輸入";
 	if (failure.kind === "unreadable-input") return askBecause(reason);
 	try {
 		return grantableCall(payload) ? askBecause(reason) : null;
@@ -318,7 +318,7 @@ async function logGranted(write, scope, call, request, grant, warn) {
 			target: request.action === "publish" ? `npm ${request.name}` : `github release ${request.repos.join("/")}`,
 			operation: opsText(call.text),
 			result: `授權放行 ${grant.ref}（${describeRequest(request)}）`,
-			ref: scope.served[grant.mainline]
+			ref: scope.served[grant.owner]
 		});
 	} catch (error) {
 		warn?.(`mainflow hook claude-code pre-tool-use: allowed by ${grant.ref} but could not write the ops log: ${error.message}`);
@@ -353,7 +353,7 @@ async function decideByGrants(root, { payload, warn, write }) {
 	if (!match.ok) return askBecause(match.reason);
 	const { grant } = match.matches[0];
 	await logGranted(write, scoped.scope, scan.call, resolved.request, grant, warn);
-	return permission("allow", `主脈絡授權 ${grant.ref} 涵蓋 ${describeRequest(resolved.request)}`);
+	return permission("allow", `授權 ${grant.ref} 涵蓋 ${describeRequest(resolved.request)}`);
 }
 /** How many problems outside the written file the reminder lists before it only gives the count. */
 const OTHER_PROBLEMS_SHOWN = 5;

package/dist/{host-lY8ytTbw.js → host-CIOd2WSh.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, 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 { $ 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"));
@@ -880,7 +893,6 @@ function remoteMembers(remotes, hubName) {
 			kind: "mainline",
 			title: m.title,
 			status: m.status,
-			role: m.role ?? "impl",
 			archived: Boolean(m.archivedAt),
 			open: !CLOSED_STATUS.mainline.includes(m.status)
 		});
@@ -1359,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) => {
@@ -1601,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;
@@ -1658,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) {
@@ -1689,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({
@@ -1847,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:
@@ -2030,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");
@@ -2042,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);
 		}
@@ -2078,7 +2120,6 @@ 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);
@@ -2095,7 +2136,6 @@ function createMainline(hub, input, ctx) {
 		...priority ? { priority } : {},
 		created: day,
 		...group ? { group } : {},
-		...role ? { role } : {},
 		criteria: []
 	}, MAINLINE_FILE);
 	draft.makeDir(`${dir}/tasks`);
@@ -2137,7 +2177,7 @@ function activatePlanning(draft, id) {
 	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
+* Change a mainline's status, group 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) {
@@ -2145,11 +2185,9 @@ function setMainline(hub, input, ctx) {
 	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`);
+	].every((v) => v === void 0)) throw new WriteError(`${input.id} needs --status, --group 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);
@@ -2162,7 +2200,6 @@ function setMainline(hub, input, ctx) {
 		}
 		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));
 }
@@ -2185,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;
@@ -2674,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") {
@@ -3237,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,
@@ -3266,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;
@@ -3684,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.
@@ -3708,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)) {
@@ -3723,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: {
@@ -3812,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);
@@ -4016,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("；")}`);
@@ -4058,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 [
@@ -8041,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`;
@@ -8239,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, DATA_DIR as Ct, matchGrants as D, grantScope as E, splitFrontMatter 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, transcriptTitle as P, remoteMembers as Q, renumberPath as R, turnReminder as S, ConflictError as St, transcriptPath as T, contentHash as Tt, HubError as U, applyOperation as V, loadConfig as W, memberOfGroup as X, linksInto as Y, refIndex as Z, setArchivedMany as _, TASK_FILE as _t, openInApp as a, MAX_BLOB_BYTES as at, duplicateClaimLines as b, findHubRoot as bt, siteBlock as c, SOCKET_MAX_AGE_CLOSE as ct, migrateHub as d, readsAsText as dt, nowMinute as et, retroReport as f, requestTime as ft, ARCHIVE_KINDS as g, MAINLINE_FILE as gt, RETRY_RULES as h, hubFormatVersion as ht, hostName as i, BLOB_HASH as it, mayDecorate as j, endsWithMarker as k, syncHost as l, comparePaths as lt, receiverFromEnv as m, formatMismatch as mt, DEFAULT_UI_PORT as n, nodeStorage as nt, removeDanglingLinks as o, MAX_FILE_BYTES as ot, retroReportFromReceiver as p, textBytes as pt, dependencyGraph as q, caddySites as r, ACCESS_HEADERS as rt, removeHostLink as s, ROUTES as st, APP_BUNDLE_ID as t, readYaml as tt, groupPlan as u, exceedsFileLimit as ut, initHub as v, requireSlug as vt, readSession as w, WriteError as wt, sessionBriefing as x, worktreesOf as xt, untilState as y, currentBranch 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-lY8ytTbw.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-CIOd2WSh.js";
 export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, removeDanglingLinks, removeHostLink, siteBlock, syncHost };