mainflow 0.38.0 → 0.39.0

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { G as refExample, Q as stampMs, U as parseRef, W as parseUntil, j as UNTIL_FORMS, n as CLOSED_STATUS } from "./dist-CZYL5PJ4.js";
-import { $ as nowMinute, B as applyOperation, C as readSession, Ct as WriteError, H as HubError, Q as unavailableHubs, S as loadSessions, St as DATA_DIR, V as checkHubName, W as loadHub, Y as memberOfGroup, Z as remoteMembers, _ as initHub, _t as requireSlug, at as MAX_FILE_BYTES, b as sessionBriefing, d as retroReport, f as retroReportFromReceiver, gt as TASK_FILE, ht as MAINLINE_FILE, m as RETRY_RULES, p as receiverFromEnv, tt as nodeStorage, u as migrateHub, v as untilState, y as duplicateClaimLines, yt as findHubRoot } from "./host-aYx3DYrv.js";
+import { $ as stampMs, G as parseUntil, K as refExample, M as UNTIL_FORMS, W as parseRef, n as CLOSED_STATUS } from "./dist-zSabglPq.js";
+import { $ as unavailableHubs, C as loadSessions, Ct as DATA_DIR, G as loadHub, H as checkHubName, K as sectionText, Q as remoteMembers, U as HubError, V as applyOperation, X as memberOfGroup, _t as TASK_FILE, b as duplicateClaimLines, bt as findHubRoot, d as migrateHub, et as nowMinute, f as retroReport, gt as MAINLINE_FILE, h as RETRY_RULES, m as receiverFromEnv, nt as nodeStorage, ot as MAX_FILE_BYTES, p as retroReportFromReceiver, u as groupPlan, v as initHub, vt as requireSlug, w as readSession, wt as WriteError, x as sessionBriefing, y as untilState } from "./host-CIOd2WSh.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-1oQ8lA9C.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-DJARDCM0.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-D38sNgXM.js";
+import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-DJ944-bI.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";
@@ -1098,6 +1098,7 @@ const RUNS = {
 		return done(`${shown.length} issues`);
 	},
 	"group list": ({ root, opts }) => printGroups(loadHub(root), opts.all ?? false),
+	"group show": ({ root, args }) => printGroup(loadHub(root), loadSessions(root).sessions, args[0]),
 	"finding list": ({ root, opts }) => {
 		const shown = loadHub(root).findings.filter((f) => opts.all || f.status === "valid");
 		for (const f of shown) console.log(`  ${f.id}  ${f.created}  ${f.title}${f.labels?.length ? `  [${f.labels.join(", ")}]` : ""}`);
@@ -1377,6 +1378,35 @@ function printGroups(hub, all) {
 	if (missing.length) console.log(`  note: hub ${missing.join(", ")} not loaded, so their members are not listed`);
 	return done(`${shown.length} groups`);
 }
+/**
+* One group: goal, criteria, grants, then its members of this hub in the order their depends-on links give, each
+* with the actions in progress or blocked that serve it. Members in other hubs are listed by `group list`.
+*/
+function printGroup(hub, sessions, idInput) {
+	const ref = parseRef(idInput);
+	if (ref?.kind !== "group") throw new WriteError(`expected a group reference like ${refExample("group")}, got "${idInput}"`);
+	const g = hub.groups.find((x) => x.id === ref.group);
+	if (!g) throw new WriteError(`group ${ref.group} not found; run "mainflow group list --all" to list groups`);
+	console.log(`${g.id}  ${g.status.padEnd(4)}  ${g.priority ?? "P2"}  ${g.title}${g.trigger ? `  （時機：${g.trigger}）` : ""}`);
+	const goal = sectionText(g.body, "目標");
+	console.log(`  目標：${goal ? goal.replace(/\s+/g, " ") : "（未填）"}`);
+	const criteria = g.criteria ?? [];
+	console.log(`  條件：${criteria.length ? "" : "（無）"}`);
+	for (const c of criteria) console.log(`    ${c.dropped ? "[-]" : c.done ? "[x]" : "[ ]"} ${g.id}#${c.id}  ${c.text}${c.dropped ? "  (dropped)" : ""}`);
+	const grants = g.grants ?? [];
+	console.log(`  授權：${grants.length ? "" : "（無）"}`);
+	for (const x of grants) console.log(`    ${g.id}#${x.id}  ${x.action} ${x.target}`);
+	const plan = groupPlan(hub, sessions, g.id);
+	const work = (list) => list.map((a) => `${a.session}#${a.action}（${a.status}）`).join("、");
+	console.log(`  成員：${plan.members.length ? "（依 depends-on 排序）" : "（無）"}`);
+	plan.members.forEach((m, i) => {
+		const waits = m.dependsOn.length ? `  依賴 ${m.dependsOn.join("、")}` : "";
+		const active = m.active.length ? `  進行中：${work(m.active)}` : "";
+		console.log(`    ${i + 1}. ${m.ref}  ${m.kind.padEnd(8)}  ${m.status.padEnd(8)}  ${m.title}${waits}${active}`);
+	});
+	if (plan.active.length) console.log(`  服務組條件的行動：${work(plan.active)}`);
+	return done(`${plan.members.length} members`);
+}
 function printProblems(problems, mark = "✗") {
 	for (const problem of problems) console.error(`${mark} ${problem.file}${problem.field ? ` › ${problem.field}` : ""}: ${problem.message}`);
 }

package/dist/{dist-CZYL5PJ4.js → dist-zSabglPq.js}

@@ -381,8 +381,11 @@ const ID_PATTERNS = {
 	grant: /^g\d{3}$/
 };
 const CHECKLIST_REF = /^m\d{3}\/t\d{3}#c\d{3}$/;
-/** What an action may serve: a checklist item, or a mainline's criterion while the mainline has no task for it yet. */
-const SERVES_REF = /^m\d{3}(?:\/t\d{3}#c\d{3}|#r\d{3})$/;
+/**
+* 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`).
+*/
+const SERVES_REF = /^(?:m\d{3}(?:\/t\d{3}#c\d{3}|#r\d{3})|w\d{3}#r\d{3})$/;
 const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const DATE = /^\d{4}-\d{2}-\d{2}$/;
 /** A hub name: kebab-case, also the first label of {hub}.mainflow.localhost and the prefix of a cross-hub reference. */
@@ -410,6 +413,11 @@ const REF_FORMS = [
 		pattern: /^(m\d{3})#(r\d{3})$/,
 		example: "m001#r001"
 	},
+	{
+		kind: "groupCriterion",
+		pattern: /^(w\d{3})#(r\d{3})$/,
+		example: "w001#r001"
+	},
 	{
 		kind: "decision",
 		pattern: /^(m\d{3})\/(d\d{3})$/,
@@ -482,6 +490,11 @@ function parseLocal(input) {
 				mainline: a,
 				criterion: b
 			};
+			case "groupCriterion": return {
+				kind: "groupCriterion",
+				group: a,
+				criterion: b
+			};
 			case "decision": return {
 				kind: "decision",
 				mainline: a,
@@ -623,8 +636,13 @@ const FINDING_SECTIONS = [
 	"影響",
 	"做法"
 ];
-/** 說明 says what the group gathers and why; its first paragraph is the summary the interface shows on the group's heading. */
-const GROUP_SECTIONS = ["說明"];
+/**
+* 目標 says what the group's work is meant to achieve; 說明 says what the group gathers and its scope, and its first
+* paragraph is the summary the interface shows on the group's heading.
+*/
+const GROUP_SECTIONS = ["目標", "說明"];
+/** The group section whose first paragraph is the summary. */
+const GROUP_SUMMARY_SECTION = "說明";
 const SURVEY_SECTION = "現況查核";
 const SURVEY_LINES = [
 	{
@@ -749,8 +767,9 @@ const costSchema = z.object({
 	note: text.optional()
 });
 /**
-* One thing the mainline authorizes ahead of time: an action plus the target it covers. It applies only while
-* a session's action in progress serves this mainline and the mainline is still open.
+* One thing a mainline or a group authorizes ahead of time: an action plus the target it covers. It applies only while
+* a session's action in progress serves this mainline (or a mainline of this group, or the group's own criterion)
+* and the mainline or group is still open.
 */
 const grantSchema = z.object({
 	id: id("grant"),
@@ -1055,7 +1074,11 @@ const groupSchema = z.object({
 	priority,
 	...documentShape,
 	/** When to take the group's work up, in a phrase, e.g. 量測修正時 */
-	trigger: text.optional()
+	trigger: text.optional(),
+	/** What has to be true for the group's work as a whole to be done; the same shape as a mainline's, referenced as w001#r001 */
+	criteria: z.array(criterionSchema).optional(),
+	/** Granted ahead of time to the work of every member mainline, and to actions serving the group's own criteria; referenced as w001#g001 */
+	grants: z.array(grantSchema).optional()
 });
 /** One line of ops/{YYYY-MM}.log: an external operation, append-only. */
 const opsEntrySchema = z.object({
@@ -1087,4 +1110,4 @@ function parseOpsLine(line) {
 	return parsed.success ? parsed.data : null;
 }
 //#endregion
-export { GRANT_ACTIONS as $, TASK_SECTIONS as A, opsEntrySchema as B, SERVES_REF as C, SURVEY_LINES as D, SLUG as E, findingSchema as F, refExample as G, parseOpsLine as H, formatOpsEntry as I, taskSchema as J, refMainline as K, groupSchema as L, WORK_STATUS as M, configSchema as N, SURVEY_SECTION as O, decisionSchema as P, stampMs as Q, issueSchema as R, RESERVED_HUB_NAMES as S, SESSION_STATUS as T, parseRef as U, parseActionRef as V, parseUntil as W, waitingForRef as X, waitingForAction as Y, OFFSET as Z, MAINLINE_SECTIONS as _, DECISION_SECTIONS as a, grantRepo as at, PRIORITIES as b, FINDING_SECTIONS as c, GROUP_SECTIONS as d, GRANT_FORMS as et, GROUP_STATUS as f, LINK_RELS as g, ISSUE_STATUS as h, DECISION_BASES as i, grantForm as it, UNTIL_FORMS as j, TASK_REQUIRED_SECTIONS as k, FINDING_STATUS as l, ISSUE_SECTIONS as m, CLOSED_STATUS as n, describeRequest as nt, DECISION_STATUS as o, parseGrantTarget as ot, ID_PATTERNS as p, sessionSchema as q, DECIDERS as r, grantCovers as rt, DEFAULT_CATEGORIES as s, CHECKLIST_REF as t, GRANT_TARGET_FORMS as tt, FORMAT_VERSION as u, MAINLINE_STATUS as v, SESSION_ID as w, REF_EXAMPLES as x, MERGE_STATES as y, mainlineSchema as z };
+export { stampMs as $, TASK_REQUIRED_SECTIONS as A, mainlineSchema as B, RESERVED_HUB_NAMES as C, SLUG as D, SESSION_STATUS as E, decisionSchema as F, parseUntil as G, parseActionRef as H, findingSchema as I, sessionSchema as J, refExample as K, formatOpsEntry as L, UNTIL_FORMS as M, WORK_STATUS as N, SURVEY_LINES as O, configSchema as P, OFFSET as Q, groupSchema as R, REF_EXAMPLES as S, SESSION_ID as T, parseOpsLine as U, opsEntrySchema as V, parseRef as W, waitingForAction as X, taskSchema as Y, waitingForRef as Z, LINK_RELS as _, DECISION_SECTIONS as a, grantForm as at, MERGE_STATES as b, FINDING_SECTIONS as c, GROUP_SECTIONS as d, GRANT_ACTIONS as et, GROUP_STATUS as f, ISSUE_STATUS as g, ISSUE_SECTIONS as h, DECISION_BASES as i, grantCovers as it, TASK_SECTIONS as j, SURVEY_SECTION as k, FINDING_STATUS as l, ID_PATTERNS as m, CLOSED_STATUS as n, GRANT_TARGET_FORMS as nt, DECISION_STATUS as o, grantRepo as ot, GROUP_SUMMARY_SECTION as p, refMainline as q, DECIDERS as r, describeRequest as rt, DEFAULT_CATEGORIES as s, parseGrantTarget as st, CHECKLIST_REF as t, GRANT_FORMS as tt, FORMAT_VERSION as u, MAINLINE_SECTIONS as v, SERVES_REF as w, PRIORITIES as x, MAINLINE_STATUS as y, issueSchema as z };

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-BH9gpiap.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-Dk4fCI7q.js";
 //#region src/facts.d.ts
 export interface CommandSpec {
   usage: string;
@@ -99,8 +99,8 @@ export declare const COMMAND_SPECS: {
     readonly needsHub: true;
   };
   readonly 'action add': {
-    readonly usage: 'action add <text> --serves <m/t#c|m#r>[,...] [--before <a>] [--session <session>]';
-    readonly summary: 'Add an action to the session queue; --serves names checklist items, or criteria while the mainline has no task for them. Prints a reminder when another session active in the last 15 minutes is doing what it serves';
+    readonly usage: 'action add <text> --serves <m/t#c|m#r|w#r>[,...] [--before <a>] [--session <session>]';
+    readonly summary: 'Add an action to the session queue; --serves names checklist items, or criteria while the mainline has no task for them, or a group\'s criterion (w#r) for work that belongs to the group as a whole. Prints a reminder when another session active in the last 15 minutes is doing what it serves';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -161,7 +161,13 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'group set': {
     readonly usage: 'group set <w> [--status open|done] [--priority P0|P1|P2|P3] [--trigger <when>] [--title <title>]';
-    readonly summary: 'Change a group\'s status, priority, trigger or title; an empty --trigger "" removes it. Relations between groups go in links in the file';
+    readonly summary: 'Change a group\'s status, priority, trigger or title; an empty --trigger "" removes it. --status done needs every criterion met or dropped and every mainline and issue of this hub in the group finished. Relations between groups go in links in the file';
+    readonly args: 1;
+    readonly needsHub: true;
+  };
+  readonly 'group show': {
+    readonly usage: 'group show <w>';
+    readonly summary: 'Print a group: goal, criteria, grants, and its members in the order their depends-on links give, each with the sessions whose actions in progress or blocked serve it';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -190,25 +196,25 @@ export declare const COMMAND_SPECS: {
     readonly needsHub: true;
   };
   readonly 'criterion add': {
-    readonly usage: 'criterion add <m> <text> --done-when <text>';
-    readonly summary: 'Add an open criterion at the end of the mainline\'s criteria with the next r id';
+    readonly usage: 'criterion add <m|w> <text> --done-when <text>';
+    readonly summary: 'Add an open criterion at the end of the mainline\'s or group\'s criteria with the next r id';
     readonly args: 2;
     readonly needsHub: true;
   };
   readonly 'criterion check': {
-    readonly usage: 'criterion check <m#r> --evidence <evidence>';
+    readonly usage: 'criterion check <m#r|w#r> --evidence <evidence>';
     readonly summary: 'Mark a criterion as met';
     readonly args: 1;
     readonly needsHub: true;
   };
   readonly 'criterion uncheck': {
-    readonly usage: 'criterion uncheck <m#r>';
+    readonly usage: 'criterion uncheck <m#r|w#r>';
     readonly summary: 'Mark a criterion as not met';
     readonly args: 1;
     readonly needsHub: true;
   };
   readonly 'criterion set': {
-    readonly usage: 'criterion set <m#r> [--text <text>] [--done-when <text>]';
+    readonly usage: 'criterion set <m#r|w#r> [--text <text>] [--done-when <text>]';
     readonly summary: 'Rewrite a criterion\'s text or doneWhen; done stays as it is (use criterion check/uncheck)';
     readonly args: 1;
     readonly needsHub: true;
@@ -571,6 +577,10 @@ export declare const REFERENCES: readonly [{
   readonly target: 'criterion';
   readonly format: 'm{NNN}#r{NNN}';
   readonly example: 'm001#r001';
+}, {
+  readonly target: 'group criterion';
+  readonly format: 'w{NNN}#r{NNN}';
+  readonly example: 'w001#r001';
 }, {
   readonly target: 'decision';
   readonly format: 'm{NNN}/d{NNN}';
@@ -629,8 +639,10 @@ export declare const LINKS: {
   readonly rels: readonly ["depends-on", "relates", "split-from"];
 };
 /**
- * What a mainline's grants authorize: each action with the form of its target. A grant applies only while the
- * session's action in progress serves the mainline and the mainline is active or planning. The PreToolUse hook
+ * What a mainline's or group's grants authorize: each action with the form of its target. A mainline's grant applies
+ * only while the session's action in progress serves the mainline and the mainline is active or planning. A group's
+ * grant applies while the group is open and the action serves one of the group's mainlines (of this hub) or the
+ * group's own criterion. The PreToolUse hook
  * allows `publish` and `release` only when the command is written in the fixed form in `forms`; the other
  * actions are for the executor to read.
  */
@@ -681,7 +693,7 @@ export declare const SECTIONS: {
   readonly decision: readonly ["背景", "選項", "建議", "決定", "理由"];
   readonly issue: readonly ["背景", "要做的事", "完成條件"];
   readonly finding: readonly ["發現", "影響", "做法"];
-  readonly group: readonly ["說明"];
+  readonly group: readonly ["目標", "說明"];
 };
 /**
  * The mainline section that records what was checked before tasks were written, one `- {label}：{text}`
@@ -705,7 +717,7 @@ export declare const FIELDS: {
   readonly decision: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
   readonly issue: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
   readonly finding: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec];
-  readonly group: readonly [...FieldSpec[], FieldSpec];
+  readonly group: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec];
   readonly criterion: FieldSpec[];
   readonly checklistItem: readonly [...FieldSpec[], FieldSpec];
   readonly grant: readonly [FieldSpec, FieldSpec, FieldSpec, FieldSpec];

package/dist/facts.js

@@ -1,4 +1,4 @@
-import { $ as GRANT_ACTIONS, A as TASK_SECTIONS, C as SERVES_REF, D as SURVEY_LINES, E as SLUG, M as WORK_STATUS, O as SURVEY_SECTION, T as SESSION_STATUS, _ as MAINLINE_SECTIONS, a as DECISION_SECTIONS, b as PRIORITIES, c as FINDING_SECTIONS, d as GROUP_SECTIONS, et as GRANT_FORMS, f as GROUP_STATUS, g as LINK_RELS, h as ISSUE_STATUS, i as DECISION_BASES, j as UNTIL_FORMS, k as TASK_REQUIRED_SECTIONS, l as FINDING_STATUS, m as ISSUE_SECTIONS, n as CLOSED_STATUS, o as DECISION_STATUS, p as ID_PATTERNS, r as DECIDERS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, tt as GRANT_TARGET_FORMS, u as FORMAT_VERSION, v as MAINLINE_STATUS, y as MERGE_STATES } from "./dist-CZYL5PJ4.js";
+import { A as TASK_REQUIRED_SECTIONS, D as SLUG, E as SESSION_STATUS, M as UNTIL_FORMS, N as WORK_STATUS, O as SURVEY_LINES, _ as LINK_RELS, a as DECISION_SECTIONS, b as MERGE_STATES, c as FINDING_SECTIONS, d as GROUP_SECTIONS, et as GRANT_ACTIONS, f as GROUP_STATUS, g as ISSUE_STATUS, h as ISSUE_SECTIONS, i as DECISION_BASES, j as TASK_SECTIONS, k as SURVEY_SECTION, l as FINDING_STATUS, m as ID_PATTERNS, n as CLOSED_STATUS, nt as GRANT_TARGET_FORMS, o as DECISION_STATUS, r as DECIDERS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, tt as GRANT_FORMS, u as FORMAT_VERSION, v as MAINLINE_SECTIONS, w as SERVES_REF, x as PRIORITIES, y as MAINLINE_STATUS } 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";
 //#region src/facts.ts
 const COMMAND_SPECS = {
@@ -89,8 +89,8 @@ const COMMAND_SPECS = {
 		needsHub: true
 	},
 	"action add": {
-		usage: "action add <text> --serves <m/t#c|m#r>[,...] [--before <a>] [--session <session>]",
-		summary: "Add an action to the session queue; --serves names checklist items, or criteria while the mainline has no task for them. Prints a reminder when another session active in the last 15 minutes is doing what it serves",
+		usage: "action add <text> --serves <m/t#c|m#r|w#r>[,...] [--before <a>] [--session <session>]",
+		summary: "Add an action to the session queue; --serves names checklist items, or criteria while the mainline has no task for them, or a group's criterion (w#r) for work that belongs to the group as a whole. Prints a reminder when another session active in the last 15 minutes is doing what it serves",
 		args: 1,
 		needsHub: true
 	},
@@ -151,7 +151,13 @@ const COMMAND_SPECS = {
 	},
 	"group set": {
 		usage: "group set <w> [--status open|done] [--priority P0|P1|P2|P3] [--trigger <when>] [--title <title>]",
-		summary: "Change a group's status, priority, trigger or title; an empty --trigger \"\" removes it. Relations between groups go in links in the file",
+		summary: "Change a group's status, priority, trigger or title; an empty --trigger \"\" removes it. --status done needs every criterion met or dropped and every mainline and issue of this hub in the group finished. Relations between groups go in links in the file",
+		args: 1,
+		needsHub: true
+	},
+	"group show": {
+		usage: "group show <w>",
+		summary: "Print a group: goal, criteria, grants, and its members in the order their depends-on links give, each with the sessions whose actions in progress or blocked serve it",
 		args: 1,
 		needsHub: true
 	},
@@ -180,25 +186,25 @@ const COMMAND_SPECS = {
 		needsHub: true
 	},
 	"criterion add": {
-		usage: "criterion add <m> <text> --done-when <text>",
-		summary: "Add an open criterion at the end of the mainline's criteria with the next r id",
+		usage: "criterion add <m|w> <text> --done-when <text>",
+		summary: "Add an open criterion at the end of the mainline's or group's criteria with the next r id",
 		args: 2,
 		needsHub: true
 	},
 	"criterion check": {
-		usage: "criterion check <m#r> --evidence <evidence>",
+		usage: "criterion check <m#r|w#r> --evidence <evidence>",
 		summary: "Mark a criterion as met",
 		args: 1,
 		needsHub: true
 	},
 	"criterion uncheck": {
-		usage: "criterion uncheck <m#r>",
+		usage: "criterion uncheck <m#r|w#r>",
 		summary: "Mark a criterion as not met",
 		args: 1,
 		needsHub: true
 	},
 	"criterion set": {
-		usage: "criterion set <m#r> [--text <text>] [--done-when <text>]",
+		usage: "criterion set <m#r|w#r> [--text <text>] [--done-when <text>]",
 		summary: "Rewrite a criterion's text or doneWhen; done stays as it is (use criterion check/uncheck)",
 		args: 1,
 		needsHub: true
@@ -485,6 +491,11 @@ const REFERENCES = [
 		format: "m{NNN}#r{NNN}",
 		example: "m001#r001"
 	},
+	{
+		target: "group criterion",
+		format: "w{NNN}#r{NNN}",
+		example: "w001#r001"
+	},
 	{
 		target: "decision",
 		format: "m{NNN}/d{NNN}",
@@ -543,8 +554,10 @@ const UNTIL = UNTIL_FORMS;
 /** Relation types a document's links take; readers derive the reverse direction. */
 const LINKS = { rels: LINK_RELS };
 /**
-* What a mainline's grants authorize: each action with the form of its target. A grant applies only while the
-* session's action in progress serves the mainline and the mainline is active or planning. The PreToolUse hook
+* What a mainline's or group's grants authorize: each action with the form of its target. A mainline's grant applies
+* only while the session's action in progress serves the mainline and the mainline is active or planning. A group's
+* grant applies while the group is open and the action serves one of the group's mainlines (of this hub) or the
+* group's own criterion. The PreToolUse hook
 * allows `publish` and `release` only when the command is written in the fixed form in `forms`; the other
 * actions are for the executor to read.
 */
@@ -691,7 +704,12 @@ const FIELDS = {
 		field("reviewAfter", false, "到這天要重新確認它還成立"),
 		field("archivedAt", false, "封存的日期，和狀態分開")
 	],
-	group: [...shared(...EVERY), field("trigger", false, "什麼時機做這組的事，一句話，例如「量測修正時」")],
+	group: [
+		...shared(...EVERY),
+		field("trigger", false, "什麼時機做這組的事，一句話，例如「量測修正時」"),
+		field("criteria", false, "這組的解決條件清單，每條的欄位見 criterion，參照寫 w{NNN}#r{NNN}；組改成 done 前要全部已勾或已放棄"),
+		field("grants", false, "預先授權清單，每條的欄位見 grant，參照寫 w{NNN}#g{NNN}；組是 open 時，對成員主脈絡的行動和服務這組解決條件的行動生效")
+	],
 	criterion: LIST_ITEM,
 	checklistItem: [...LIST_ITEM, field("serves", false, "這個項目推進的解決條件，r{NNN} 清單")],
 	grant: [
@@ -704,7 +722,7 @@ const FIELDS = {
 		field("id", true, "會話內不重複的編號 a{NNN}，由 action add 配發"),
 		field("do", true, "要做的事，一句話"),
 		field("status", true, "狀態值見 STATUSES，用 action set 改"),
-		field("serves", true, "推進的 checklist 項目（m{NNN}/t{NNN}#c{NNN}）或解決條件（m{NNN}#r{NNN}）參照清單，可以是空的；主脈絡還沒拆任務時指向解決條件"),
+		field("serves", true, "推進的 checklist 項目（m{NNN}/t{NNN}#c{NNN}）或解決條件（主脈絡 m{NNN}#r{NNN}、組 w{NNN}#r{NNN}）參照清單，可以是空的；主脈絡還沒拆任務時指向解決條件"),
 		field("note", false, "一句備註"),
 		field("blockedBy", false, "卡住時的原因 reason、等待對象 waitingFor 與程式可判斷的條件 until，blocked 時必填，其他狀態不得有；等待對象整串是其他會話的行動（例如 claude-code-1a2b3c4d#a003）時，對方的簡報會列出有人在等它；條件格式見 UNTIL"),
 		field("startedAt", false, "轉為 doing 時由 CLI 寫入"),

package/dist/grant-commands.d.ts

@@ -1,4 +1,4 @@
-import "./index-BH9gpiap.js";
+import "./index-Dk4fCI7q.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 { et as GRANT_FORMS } from "./dist-CZYL5PJ4.js";
+import { tt as GRANT_FORMS } from "./dist-zSabglPq.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-BH9gpiap.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. */
@@ -154,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<{
@@ -165,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;
@@ -176,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 { N as configSchema, nt as describeRequest } from "./dist-CZYL5PJ4.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-aYx3DYrv.js";
-import { n as hubWriter, r as writtenLines } from "./operation-1oQ8lA9C.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;