mainflow 0.37.0 → 0.39.0

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { G as parseRef, K as parseUntil, N as UNTIL_FORMS, et as stampMs, n as CLOSED_STATUS, q as refExample } from "./dist-ud09dzZo.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-lY8ytTbw.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-BZ7CHB6J.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-3HLHjQF0.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";
@@ -669,7 +669,6 @@ const WRITES = {
 			slug: args[0],
 			title: required(opts, "title", "--title \"重建 mainline 任務管理\""),
 			group: opts.group,
-			role: opts.role,
 			priority: opts.priority
 		}),
 		print: (_, { id, dir }) => done(`created ${id} ${inData(dir, MAINLINE_FILE)}`)
@@ -754,14 +753,9 @@ const WRITES = {
 			id: args[0],
 			status: opts.status,
 			group: opts.group,
-			role: opts.role,
 			priority: opts.priority
 		}),
-		print: (_, m) => done(`updated ${m.id} (${[
-			m.status,
-			m.group,
-			m.role
-		].filter(Boolean).join(", ")})`)
+		print: (_, m) => done(`updated ${m.id} (${[m.status, m.group].filter(Boolean).join(", ")})`)
 	}),
 	"mainline archive": write({
 		op: "mainline.archive",
@@ -1104,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(", ")}]` : ""}`);
@@ -1346,10 +1341,9 @@ function required(opts, name, example) {
 	if (!value) throw new WriteError(`--${name} is required, e.g. ${example}`);
 	return value;
 }
-/** The group and role a mainline line ends with, like `  [w001, plan]`; nothing for an impl mainline outside a group. */
+/** The group a mainline line ends with, like `  [w001]`; nothing for a mainline outside a group. */
 const membership = (m) => {
-	const tags = [m.group, m.role === "plan" ? "plan" : void 0].filter(Boolean);
-	return tags.length ? `  [${tags.join(", ")}]` : "";
+	return m.group ? `  [${m.group}]` : "";
 };
 function printStatus(hub, all) {
 	const shown = hub.mainlines.filter((m) => all || !m.archivedAt);
@@ -1365,7 +1359,7 @@ function printStatus(hub, all) {
 }
 /**
 * Open groups by priority, P0 first and a group without one as P2, then by id; each with its trigger and its members:
-* plan mainlines first, then impl mainlines, then issues. Archived and closed members are left out unless --all.
+* mainlines first, then issues. Archived and closed members are left out unless --all.
 */
 function printGroups(hub, all) {
 	const rank = (p) => (p ?? "P2").slice(1);
@@ -1375,19 +1369,44 @@ function printGroups(hub, all) {
 		console.log(`  ${g.id}  ${g.status.padEnd(4)}  ${g.priority ?? "P2"}  ${g.title}${g.trigger ? `  （時機：${g.trigger}）` : ""}`);
 		const mainlines = hub.mainlines.filter((m) => memberOfGroup(m.group, g.id, hub.config.hub) && (all || !m.archivedAt && !CLOSED_STATUS.mainline.includes(m.status)));
 		const issues = hub.issues.filter((i) => memberOfGroup(i.group, g.id, hub.config.hub) && (all || !i.archivedAt && i.status !== "closed"));
-		for (const m of [...mainlines.filter((m) => m.role === "plan"), ...mainlines.filter((m) => m.role !== "plan")]) console.log(`      ${m.id}  ${(m.role ?? "impl").padEnd(4)}  ${m.status.padEnd(8)}  ${m.title}`);
-		for (const i of issues) console.log(`      ${i.id}  issue  ${i.status.padEnd(8)}  ${i.title}`);
+		for (const m of mainlines) console.log(`      ${m.id}  mainline  ${m.status.padEnd(8)}  ${m.title}`);
+		for (const i of issues) console.log(`      ${i.id}  issue     ${i.status.padEnd(8)}  ${i.title}`);
 		const remote = (remoteByGroup.get(g.id) ?? []).filter((m) => all || !m.archived && m.open);
-		for (const m of [
-			...remote.filter((m) => m.role === "plan"),
-			...remote.filter((m) => m.kind === "mainline" && m.role !== "plan"),
-			...remote.filter((m) => m.kind === "issue")
-		]) console.log(`      ${m.ref}  ${(m.kind === "issue" ? "issue" : m.role).padEnd(4)}  ${m.status.padEnd(8)}  ${m.title}`);
+		for (const m of [...remote.filter((m) => m.kind === "mainline"), ...remote.filter((m) => m.kind === "issue")]) console.log(`      ${m.ref}  ${(m.kind === "issue" ? "issue" : "mainline").padEnd(8)}  ${m.status.padEnd(8)}  ${m.title}`);
 	}
 	const missing = unavailableHubs(hub.remotes);
 	if (missing.length) console.log(`  note: hub ${missing.join(", ")} not loaded, so their members are not listed`);
 	return done(`${shown.length} groups`);
 }
+/**
+* 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-ud09dzZo.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"),
@@ -765,13 +784,6 @@ const grantSchema = z.object({
 		message: parsed.message
 	});
 });
-/**
-* What a mainline is for. A plan mainline sizes the work, splits it into impl mainlines, coordinates them and makes
-* the final check; an impl mainline carries a piece of the work out. A mainline without a role is an impl one, and
-* a group may hold no plan mainline at all: a small piece of work needs none.
-*/
-const MAINLINE_ROLES = ["plan", "impl"];
-const DEFAULT_ROLE = "impl";
 const mainlineSchema = z.object({
 	id: id("mainline"),
 	title: text,
@@ -779,7 +791,6 @@ const mainlineSchema = z.object({
 	priority,
 	...documentShape,
 	group,
-	role: z.enum(MAINLINE_ROLES).optional(),
 	due: date.optional(),
 	/** Hidden from the default listings; independent of status, a done mainline may stay visible */
 	archivedAt: date.optional(),
@@ -1051,8 +1062,8 @@ const findingSchema = z.object({
 	archivedAt: date.optional()
 });
 /**
-* Front matter of groups/w{NNN}-{slug}.md: mainlines and issues that belong together, such as a plan mainline with the
-* impl mainlines it split off, or the issues to take up together when a measurement is fixed. Membership is written
+* Front matter of groups/w{NNN}-{slug}.md: mainlines and issues that belong together, such as the mainlines that split one
+* piece of work, or the issues to take up together when a measurement is fixed. Membership is written
 * on each member (`group`), so a group file never lists its members and the two cannot disagree. A group is apart
 * from dependencies: depends-on between groups orders them, and priority and trigger say how urgent and when.
 */
@@ -1063,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({
@@ -1095,4 +1110,4 @@ function parseOpsLine(line) {
 	return parsed.success ? parsed.data : null;
 }
 //#endregion
-export { OFFSET as $, SURVEY_SECTION as A, issueSchema as B, REF_EXAMPLES as C, SESSION_STATUS as D, SESSION_ID as E, configSchema as F, parseRef as G, opsEntrySchema as H, decisionSchema as I, refMainline as J, parseUntil as K, findingSchema as L, TASK_SECTIONS as M, UNTIL_FORMS as N, SLUG as O, WORK_STATUS as P, waitingForRef as Q, formatOpsEntry as R, PRIORITIES as S, SERVES_REF as T, parseActionRef as U, mainlineSchema as V, parseOpsLine as W, taskSchema as X, sessionSchema as Y, waitingForAction as Z, LINK_RELS as _, DECISION_SECTIONS as a, grantCovers as at, MAINLINE_STATUS as b, DEFAULT_ROLE as c, parseGrantTarget as ct, FORMAT_VERSION as d, stampMs as et, GROUP_SECTIONS as f, ISSUE_STATUS as g, ISSUE_SECTIONS as h, DECISION_BASES as i, describeRequest as it, TASK_REQUIRED_SECTIONS as j, SURVEY_LINES as k, FINDING_SECTIONS as l, ID_PATTERNS as m, CLOSED_STATUS as n, GRANT_FORMS as nt, DECISION_STATUS as o, grantForm as ot, GROUP_STATUS as p, refExample as q, DECIDERS as r, GRANT_TARGET_FORMS as rt, DEFAULT_CATEGORIES as s, grantRepo as st, CHECKLIST_REF as t, GRANT_ACTIONS as tt, FINDING_STATUS as u, MAINLINE_ROLES as v, RESERVED_HUB_NAMES as w, MERGE_STATES as x, MAINLINE_SECTIONS as y, groupSchema 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-B32s8PHu.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;
   };
@@ -124,8 +124,8 @@ export declare const COMMAND_SPECS: {
     readonly needsHub: false;
   };
   readonly 'new mainline': {
-    readonly usage: 'new mainline <slug> --title <title> [--group <w>] [--role plan|impl] [--priority P0|P1|P2|P3]';
-    readonly summary: 'Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group, or in one of another registered hub as {hub}:w001; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)';
+    readonly usage: 'new mainline <slug> --title <title> [--group <w>] [--priority P0|P1|P2|P3]';
+    readonly summary: 'Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group, or in one of another registered hub as {hub}:w001';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -161,19 +161,25 @@ 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;
   };
   readonly 'group list': {
     readonly usage: 'group list [--all]';
-    readonly summary: 'List open groups by priority with their trigger and members, plan mainlines first; members in other hubs read {hub}:{id}, and a registered hub that is not loaded is noted (--all includes done groups)';
+    readonly summary: 'List open groups by priority with their trigger and members, mainlines before issues; members in other hubs read {hub}:{id}, and a registered hub that is not loaded is noted (--all includes done groups)';
     readonly args: 0;
     readonly needsHub: true;
   };
   readonly 'mainline set': {
-    readonly usage: 'mainline set <m> [--status <status>] [--group <w|none>] [--role plan|impl] [--priority P0|P1|P2|P3]';
-    readonly summary: 'Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group; {hub}:w001 joins a group of another registered hub';
+    readonly usage: 'mainline set <m> [--status <status>] [--group <w|none>] [--priority P0|P1|P2|P3]';
+    readonly summary: 'Change status, group or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group; {hub}:w001 joins a group of another registered hub';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -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;
@@ -495,9 +501,6 @@ export declare const OPTIONS: {
   readonly group: {
     readonly type: 'string';
   };
-  readonly role: {
-    readonly type: 'string';
-  };
   readonly priority: {
     readonly type: 'string';
   };
@@ -574,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}';
@@ -632,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.
  */
@@ -676,15 +685,6 @@ export declare const CLASSIFICATION: {
   readonly priorities: readonly ["P0", "P1", "P2", "P3"];
   readonly defaultPriority: "P2";
 };
-/**
- * What a mainline is for: a plan mainline sizes the work, splits it into impl mainlines, coordinates them and makes
- * the final check; an impl mainline carries a piece out. Without a role a mainline is `default`. A group needs no plan
- * mainline: whether to open one, and how many impl mainlines, follows from how big the work is.
- */
-export declare const ROLES: {
-  readonly values: readonly ["plan", "impl"];
-  readonly default: "impl";
-};
 /** Body sections each document is created with; the task sections in `taskRequired` must be filled while it is open. */
 export declare const SECTIONS: {
   readonly mainline: readonly ["概述", "背景與前置", "現況查核", "範圍與不做", "限制"];
@@ -693,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}`
@@ -712,12 +712,12 @@ export interface FieldSpec {
 }
 /** Every front matter field of each document and list entry; facts.test keeps it equal to the schema. */
 export declare const FIELDS: {
-  readonly mainline: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
+  readonly mainline: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
   readonly task: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
   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 { A as SURVEY_SECTION, D as SESSION_STATUS, M as TASK_SECTIONS, N as UNTIL_FORMS, O as SLUG, P as WORK_STATUS, S as PRIORITIES, T as SERVES_REF, _ as LINK_RELS, a as DECISION_SECTIONS, b as MAINLINE_STATUS, c as DEFAULT_ROLE, d as FORMAT_VERSION, f as GROUP_SECTIONS, g as ISSUE_STATUS, h as ISSUE_SECTIONS, i as DECISION_BASES, j as TASK_REQUIRED_SECTIONS, k as SURVEY_LINES, l as FINDING_SECTIONS, m as ID_PATTERNS, n as CLOSED_STATUS, nt as GRANT_FORMS, o as DECISION_STATUS, p as GROUP_STATUS, r as DECIDERS, rt as GRANT_TARGET_FORMS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, tt as GRANT_ACTIONS, u as FINDING_STATUS, v as MAINLINE_ROLES, x as MERGE_STATES, y as MAINLINE_SECTIONS } from "./dist-ud09dzZo.js";
+import { A as 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
 	},
@@ -114,8 +114,8 @@ const COMMAND_SPECS = {
 		needsHub: false
 	},
 	"new mainline": {
-		usage: "new mainline <slug> --title <title> [--group <w>] [--role plan|impl] [--priority P0|P1|P2|P3]",
-		summary: "Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group, or in one of another registered hub as {hub}:w001; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)",
+		usage: "new mainline <slug> --title <title> [--group <w>] [--priority P0|P1|P2|P3]",
+		summary: "Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group, or in one of another registered hub as {hub}:w001",
 		args: 1,
 		needsHub: true
 	},
@@ -151,19 +151,25 @@ 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
 	},
 	"group list": {
 		usage: "group list [--all]",
-		summary: "List open groups by priority with their trigger and members, plan mainlines first; members in other hubs read {hub}:{id}, and a registered hub that is not loaded is noted (--all includes done groups)",
+		summary: "List open groups by priority with their trigger and members, mainlines before issues; members in other hubs read {hub}:{id}, and a registered hub that is not loaded is noted (--all includes done groups)",
 		args: 0,
 		needsHub: true
 	},
 	"mainline set": {
-		usage: "mainline set <m> [--status <status>] [--group <w|none>] [--role plan|impl] [--priority P0|P1|P2|P3]",
-		summary: "Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group; {hub}:w001 joins a group of another registered hub",
+		usage: "mainline set <m> [--status <status>] [--group <w|none>] [--priority P0|P1|P2|P3]",
+		summary: "Change status, group or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group; {hub}:w001 joins a group of another registered hub",
 		args: 1,
 		needsHub: true
 	},
@@ -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
@@ -418,7 +424,6 @@ const OPTIONS = {
 	origin: { type: "string" },
 	labels: { type: "string" },
 	group: { type: "string" },
-	role: { type: "string" },
 	priority: { type: "string" },
 	trigger: { type: "string" },
 	target: { type: "string" },
@@ -486,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}",
@@ -544,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.
 */
@@ -575,15 +587,6 @@ const CLASSIFICATION = {
 	priorities: PRIORITIES,
 	defaultPriority: "P2"
 };
-/**
-* What a mainline is for: a plan mainline sizes the work, splits it into impl mainlines, coordinates them and makes
-* the final check; an impl mainline carries a piece out. Without a role a mainline is `default`. A group needs no plan
-* mainline: whether to open one, and how many impl mainlines, follows from how big the work is.
-*/
-const ROLES = {
-	values: MAINLINE_ROLES,
-	default: DEFAULT_ROLE
-};
 /** Body sections each document is created with; the task sections in `taskRequired` must be filled while it is open. */
 const SECTIONS = {
 	mainline: MAINLINE_SECTIONS,
@@ -655,7 +658,6 @@ const FIELDS = {
 	mainline: [
 		...shared(...EVERY),
 		field("group", false, "所屬的組 w{NNN}，或其他 hub 的組 {hub}:w{NNN}，一條主脈絡最多一組；組和依賴無關"),
-		field("role", false, "plan 是拆分顆粒、整合調度與最終確認的規劃型，impl 是執行的實作型；沒填視為 impl"),
 		field("due", false, "預計完成的日期"),
 		field("archivedAt", false, "封存的日期，和狀態分開"),
 		field("criteria", true, "解決條件清單，每條的欄位見 criterion"),
@@ -702,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: [
@@ -715,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 寫入"),
@@ -728,4 +735,4 @@ const FIELDS = {
 	]
 };
 //#endregion
-export { CHECKLIST_REF, CLASSIFICATION, CLOSED_STATUSES, COMMAND_SPECS, FIELDS, FORMAT_VERSION, GRANTS, ID_PATTERNS, LAYOUT, LINKS, OPTIONS, REFERENCES, RETRO_FORMATS, ROLES, SECTIONS, SERVES_REF, SLUG, STATUSES, SURVEY, UNTIL };
+export { CHECKLIST_REF, CLASSIFICATION, CLOSED_STATUSES, COMMAND_SPECS, FIELDS, FORMAT_VERSION, GRANTS, ID_PATTERNS, LAYOUT, LINKS, OPTIONS, REFERENCES, RETRO_FORMATS, SECTIONS, SERVES_REF, SLUG, STATUSES, SURVEY, UNTIL };

package/dist/grant-commands.d.ts

@@ -1,4 +1,4 @@
-import "./index-B32s8PHu.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 { nt as GRANT_FORMS } from "./dist-ud09dzZo.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";