mainflow 0.34.0 → 0.35.0

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { B as parseRef, H as refExample, V as parseUntil, Y as stampMs, k as UNTIL_FORMS } from "./dist-IdbnCDqM.js";
-import { $ as MAX_FILE_BYTES, B as checkHubName, H as loadHub, S as readSession, V as HubError, Y as nodeStorage, _ as untilState, ct as TASK_FILE, d as retroReportFromReceiver, dt as findHubRoot, f as receiverFromEnv, g as initHub, ht as WriteError, l as migrateHub, lt as requireSlug, mt as DATA_DIR, p as RETRY_RULES, q as nowMinute, st as MAINLINE_FILE, u as retroReport, v as duplicateClaimLines, x as loadSessions, y as sessionBriefing, z as applyOperation } from "./host-79T-_NMu.js";
+import { G as parseRef, K as parseUntil, N as UNTIL_FORMS, et as stampMs, n as CLOSED_STATUS, q as refExample } from "./dist-BdvWGTsb.js";
+import { B as applyOperation, C as readSession, H as HubError, Q as nodeStorage, S as loadSessions, V as checkHubName, W as loadHub, X as nowMinute, _ as initHub, _t as DATA_DIR, b as sessionBriefing, d as retroReport, dt as TASK_FILE, f as retroReportFromReceiver, ft as requireSlug, m as RETRY_RULES, mt as findHubRoot, nt as MAX_FILE_BYTES, p as receiverFromEnv, u as migrateHub, ut as MAINLINE_FILE, v as untilState, vt as WriteError, y as duplicateClaimLines } from "./host-bnHYIwuY.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { A as syncPaths, C as ENV, D as SETTINGS_FILE, E as syncSettings, S as ServerError, T as hubName, _ as readDaemon, a as remoteMode, b as oversizedFiles, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, 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 earlierToken, x as ServerApi, y as readRemote } from "./operation--fJnUqvA.js";
+import { C as ServerError, D as syncSettings, E as hubName, O as SETTINGS_FILE, S as ServerApi, T as earlierToken, _ as readDaemon, a as remoteMode, b as readRemote, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, j as syncPaths, l as planFetch, m as DaemonUnavailable, n as hubWriter, o as fetchDenial, p as DaemonRunning, r as writtenLines, s as hookAnswer, t as CONFIRM_MS, u as planFlush, v as silentHint, w as ENV, x as oversizedFiles } from "./operation-DVcJgKM9.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { hookFallback, parsePayload, runHook } from "./hooks.js";
-import { c as watchHubGone, l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-DQVyIbpf.js";
+import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-D80CYPcm.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";
@@ -654,7 +654,10 @@ const WRITES = {
 		op: "mainline.new",
 		input: ({ args, opts }) => ({
 			slug: args[0],
-			title: required(opts, "title", "--title \"重建 mainline 任務管理\"")
+			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)}`)
 	}),
@@ -689,10 +692,37 @@ const WRITES = {
 			slug: args[0],
 			title: required(opts, "title", "--title \"重試不穩定的 VM\""),
 			origin: opts.origin,
+			labels: opts.labels ? list(opts.labels) : void 0,
+			group: opts.group,
+			priority: opts.priority
+		}),
+		print: (_, { id, file }) => done(`created ${id} ${inData(file)}`)
+	}),
+	"new group": write({
+		op: "group.new",
+		input: ({ args, opts }) => ({
+			slug: args[0],
+			title: required(opts, "title", "--title \"量測修正\""),
+			priority: opts.priority,
+			trigger: opts.trigger,
+			origin: opts.origin,
 			labels: opts.labels ? list(opts.labels) : void 0
 		}),
 		print: (_, { id, file }) => done(`created ${id} ${inData(file)}`)
 	}),
+	"group set": write({
+		op: "group.set",
+		input: ({ args, opts }) => ({
+			id: args[0],
+			patch: {
+				status: opts.status,
+				priority: opts.priority,
+				trigger: opts.trigger,
+				title: opts.title
+			}
+		}),
+		print: (_, g) => done(`updated ${g.id} (${g.status})`)
+	}),
 	"new finding": write({
 		op: "finding.new",
 		input: ({ args, opts }) => ({
@@ -707,9 +737,16 @@ const WRITES = {
 		op: "mainline.set",
 		input: ({ args, opts }) => ({
 			id: args[0],
-			status: required(opts, "status", "--status active")
+			status: opts.status,
+			group: opts.group,
+			role: opts.role,
+			priority: opts.priority
 		}),
-		print: (_, m) => done(`updated ${m.id} (${m.status})`)
+		print: (_, m) => done(`updated ${m.id} (${[
+			m.status,
+			m.group,
+			m.role
+		].filter(Boolean).join(", ")})`)
 	}),
 	"mainline archive": write({
 		op: "mainline.archive",
@@ -853,6 +890,17 @@ const WRITES = {
 		}),
 		print: (_, i) => done(`closed ${i.id}`)
 	}),
+	"issue set": write({
+		op: "issue.set",
+		input: ({ args, opts }) => ({
+			id: args[0],
+			patch: {
+				group: opts.group,
+				priority: opts.priority
+			}
+		}),
+		print: (_, i) => done(`updated ${i.id}${i.group ? ` (${i.group})` : ""}`)
+	}),
 	"issue reopen": write({
 		op: "issue.reopen",
 		input: ({ args }) => ({ id: args[0] }),
@@ -980,6 +1028,8 @@ const RUNS = {
 		launchUi(root, config.hub, config.ui?.port, {
 			port: opts.port,
 			open: !opts["no-open"]
+		}).then((result) => {
+			process.exitCode = exitCodeFor(result);
 		}).catch((error) => {
 			console.error(error instanceof WriteError ? `✗ ${error.message}` : error);
 			process.exitCode = 1;
@@ -1034,9 +1084,10 @@ const RUNS = {
 	},
 	"issue list": ({ root, opts }) => {
 		const shown = loadHub(root).issues.filter((i) => opts.all || i.status !== "closed");
-		for (const i of shown) console.log(`  ${i.id}  ${i.status.padEnd(7)}  ${i.title}${i.plannedIn ? `  → ${i.plannedIn}` : ""}${i.origin ? `  (from ${i.origin})` : ""}`);
+		for (const i of shown) console.log(`  ${i.id}  ${i.status.padEnd(7)}  ${i.title}${i.plannedIn ? `  → ${i.plannedIn}` : ""}${i.origin ? `  (from ${i.origin})` : ""}${i.group ? `  [${i.group}]` : ""}`);
 		return done(`${shown.length} issues`);
 	},
+	"group list": ({ root, opts }) => printGroups(loadHub(root), opts.all ?? false),
 	"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(", ")}]` : ""}`);
@@ -1279,18 +1330,39 @@ 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. */
+const membership = (m) => {
+	const tags = [m.group, m.role === "plan" ? "plan" : void 0].filter(Boolean);
+	return tags.length ? `  [${tags.join(", ")}]` : "";
+};
 function printStatus(hub, all) {
 	const shown = hub.mainlines.filter((m) => all || !m.archivedAt);
 	console.log(`${hub.config.hub}: ${shown.length} mainlines${all ? "" : " (archived hidden)"}`);
 	for (const m of shown) {
 		const items = listProgress(m.tasks.flatMap((t) => t.checklist));
 		const archived = m.archivedAt ? "  [archived]" : "";
-		console.log(`  ${m.id}  ${m.status.padEnd(8)}  ${items.done}/${items.total}  ${m.title}${archived}`);
+		console.log(`  ${m.id}  ${m.status.padEnd(8)}  ${items.done}/${items.total}  ${m.title}${membership(m)}${archived}`);
 	}
 	if (hub.problems.length === 0) return 0;
 	console.error(`${hub.problems.length} problems found; run "mainflow check" for details`);
 	return 1;
 }
+/**
+* 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.
+*/
+function printGroups(hub, all) {
+	const rank = (p) => (p ?? "P2").slice(1);
+	const shown = hub.groups.filter((g) => all || g.status !== "done").sort((a, b) => rank(a.priority).localeCompare(rank(b.priority)) || a.id.localeCompare(b.id));
+	for (const g of shown) {
+		console.log(`  ${g.id}  ${g.status.padEnd(4)}  ${g.priority ?? "P2"}  ${g.title}${g.trigger ? `  （時機：${g.trigger}）` : ""}`);
+		const mainlines = hub.mainlines.filter((m) => m.group === g.id && (all || !m.archivedAt && !CLOSED_STATUS.mainline.includes(m.status)));
+		const issues = hub.issues.filter((i) => i.group === g.id && (all || !i.archivedAt && i.status !== "closed"));
+		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}`);
+	}
+	return done(`${shown.length} groups`);
+}
 function printProblems(problems, mark = "✗") {
 	for (const problem of problems) console.error(`${mark} ${problem.file}${problem.field ? ` › ${problem.field}` : ""}: ${problem.message}`);
 }

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

@@ -376,6 +376,8 @@ const ID_PATTERNS = {
 	action: /^a\d{3}$/,
 	issue: /^i\d{3}$/,
 	finding: /^f\d{3}$/,
+	/** A hub-level group of mainlines and issues; groups/w{NNN}-{slug}.md */
+	group: /^w\d{3}$/,
 	grant: /^g\d{3}$/
 };
 const CHECKLIST_REF = /^m\d{3}\/t\d{3}#c\d{3}$/;
@@ -422,6 +424,11 @@ const REF_FORMS = [
 		kind: "finding",
 		pattern: /^(f\d{3})$/,
 		example: "f001"
+	},
+	{
+		kind: "group",
+		pattern: /^(w\d{3})$/,
+		example: "w001"
 	}
 ];
 /** The forms a reference can take, for error messages. */
@@ -488,13 +495,17 @@ function parseLocal(input) {
 				kind: "finding",
 				finding: a
 			};
+			case "group": return {
+				kind: "group",
+				group: a
+			};
 		}
 	}
 	return null;
 }
 /** The reference a blocked task waits for, when its whole `waitingFor` text is one; free text such as 使用者 gives undefined. */
 const waitingForRef = (waitingFor) => waitingFor && parseRef(waitingFor) ? waitingFor : void 0;
-/** The mainline a reference sits in, or undefined for hub-level issues and findings. */
+/** The mainline a reference sits in, or undefined for hub-level issues, findings and groups. */
 const refMainline = (ref) => "mainline" in ref ? ref.mainline : void 0;
 /** The example reference for a kind, used in error messages. */
 const refExample = (kind) => REF_FORMS.find((f) => f.kind === kind)?.example ?? "";
@@ -549,13 +560,16 @@ const SESSION_STATUS = [
 	"ended",
 	"handed-off"
 ];
+/** A group is open while any of the work it gathers is still to be done, and done once it is all settled. */
+const GROUP_STATUS = ["open", "done"];
 /** Statuses after which an entity is closed and carries closedAt. */
 const CLOSED_STATUS = {
 	mainline: ["done", "dropped"],
 	task: ["done", "dropped"],
 	decision: ["superseded"],
 	issue: ["closed"],
-	finding: ["obsolete"]
+	finding: ["obsolete"],
+	group: ["done"]
 };
 /** Default categories, aligned with Conventional Commits types; a hub adds its own in config.yaml. */
 const DEFAULT_CATEGORIES = [
@@ -609,6 +623,8 @@ 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 = ["說明"];
 const SURVEY_SECTION = "現況查核";
 const SURVEY_LINES = [
 	{
@@ -666,7 +682,7 @@ const linkSchema = z.object({
 	note: text.optional()
 });
 /**
-* Attributes every document carries (mainline, task, decision, issue, finding) besides id, title, status
+* Attributes every document carries (mainline, task, decision, issue, finding, group) besides id, title, status
 * and priority, which each schema lists first so the front matter reads the same way in every file. `category` is checked
 * against DEFAULT_CATEGORIES plus config.categories when the hub loads, not here, because the schema does
 * not see the config. `updated` is not stored: readers derive it from the file.
@@ -683,6 +699,8 @@ const documentShape = {
 	links: z.array(linkSchema).optional()
 };
 const priority = z.enum(PRIORITIES).optional();
+/** The hub-level group a mainline or an issue belongs to, at most one; work that goes together, apart from what depends on what */
+const group = id("group").optional();
 const evidenceRequired = (item, ctx) => {
 	if (item.done && !item.evidence) ctx.addIssue({
 		code: "custom",
@@ -744,12 +762,21 @@ 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,
 	status: z.enum(MAINLINE_STATUS),
 	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(),
@@ -980,6 +1007,7 @@ const issueSchema = z.object({
 	status: z.enum(ISSUE_STATUS),
 	priority,
 	...documentShape,
+	group,
 	order: z.number().int().positive().optional(),
 	due: date.optional(),
 	plannedIn: z.string().regex(/^m\d{3}\/t\d{3}$/).optional(),
@@ -1010,6 +1038,21 @@ const findingSchema = z.object({
 	/** Hidden from the default views; independent of status, an obsolete finding stays visible until archived */
 	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
+* 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.
+*/
+const groupSchema = z.object({
+	id: id("group"),
+	title: text,
+	status: z.enum(GROUP_STATUS),
+	priority,
+	...documentShape,
+	/** When to take the group's work up, in a phrase, e.g. 量測修正時 */
+	trigger: text.optional()
+});
 /** One line of ops/{YYYY-MM}.log: an external operation, append-only. */
 const opsEntrySchema = z.object({
 	at: datetime,
@@ -1040,4 +1083,4 @@ function parseOpsLine(line) {
 	return parsed.success ? parsed.data : null;
 }
 //#endregion
-export { describeRequest as $, WORK_STATUS as A, parseRef as B, SESSION_STATUS as C, TASK_REQUIRED_SECTIONS as D, SURVEY_SECTION as E, issueSchema as F, taskSchema as G, refExample as H, mainlineSchema as I, OFFSET as J, waitingForAction as K, opsEntrySchema as L, decisionSchema as M, findingSchema as N, TASK_SECTIONS as O, formatOpsEntry as P, GRANT_TARGET_FORMS as Q, parseActionRef as R, SESSION_ID as S, SURVEY_LINES as T, refMainline as U, parseUntil as V, sessionSchema as W, GRANT_ACTIONS as X, stampMs as Y, GRANT_FORMS as Z, MERGE_STATES as _, DECISION_SECTIONS as a, RESERVED_HUB_NAMES as b, FINDING_SECTIONS as c, ID_PATTERNS as d, grantCovers as et, ISSUE_SECTIONS as f, MAINLINE_STATUS as g, MAINLINE_SECTIONS as h, DECISION_BASES as i, configSchema as j, UNTIL_FORMS as k, FINDING_STATUS as l, LINK_RELS as m, CLOSED_STATUS as n, grantRepo as nt, DECISION_STATUS as o, ISSUE_STATUS as p, waitingForRef as q, DECIDERS as r, parseGrantTarget as rt, DEFAULT_CATEGORIES as s, CHECKLIST_REF as t, grantForm as tt, FORMAT_VERSION as u, PRIORITIES as v, SLUG as w, SERVES_REF as x, REF_EXAMPLES as y, parseOpsLine as z };
+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 };

package/dist/facts.d.ts

@@ -1,4 +1,4 @@
-import { _ as Until, c as ID_PATTERNS, f as SERVES_REF, h as SurveyLine, o as FORMAT_VERSION, p as SLUG, r as CHECKLIST_REF } from "./index-ihgXABQc.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-DgYB5u1f.js";
 //#region src/facts.d.ts
 export interface CommandSpec {
   usage: string;
@@ -106,7 +106,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'action set': {
     readonly usage: 'action set <a|session#a> [--status] [--reason --waiting-for --until] [--text] [--serves] [--before <a>] [--note <text>] [--session <session>]';
-    readonly summary: 'Change, reorder or finish an action; --status blocked needs --reason, and leaving blocked clears it. --status doing reminds like action add. A handed-off action keeps its note';
+    readonly summary: 'Change, reorder or finish an action; --status blocked needs --reason, and leaving blocked clears it. --status doing reminds like action add and moves a planning mainline it serves to active. A handed-off action keeps its note';
     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>';
-    readonly summary: 'Create mainline.md with the next id and the section template; write the rest in the file';
+    readonly usage: 'new mainline <slug> --title <title> [--group <w>] [--role plan|impl] [--priority P0|P1|P2|P3]';
+    readonly summary: 'Create mainline.md with the next id and the section template; write the rest in the file. --group puts it in an existing group; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -142,8 +142,8 @@ export declare const COMMAND_SPECS: {
     readonly needsHub: true;
   };
   readonly 'new issue': {
-    readonly usage: 'new issue <slug> --title <title> [--origin <ref>] [--labels a,b]';
-    readonly summary: 'Create an issue file for a follow-up that must outlive its mainline';
+    readonly usage: 'new issue <slug> --title <title> [--origin <ref>] [--labels a,b] [--group <w>] [--priority P0|P1|P2|P3]';
+    readonly summary: 'Create an issue file for a follow-up that must outlive its mainline; --group puts it with the work it is taken up with';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -153,9 +153,27 @@ export declare const COMMAND_SPECS: {
     readonly args: 1;
     readonly needsHub: true;
   };
+  readonly 'new group': {
+    readonly usage: 'new group <slug> --title <title> [--priority P0|P1|P2|P3] [--trigger <when>] [--origin <ref>] [--labels a,b]';
+    readonly summary: 'Create a group file for mainlines and issues taken up together, apart from dependencies; --trigger says when, e.g. "量測修正時". Members join with --group on new mainline, new issue, mainline set or issue set';
+    readonly args: 1;
+    readonly needsHub: true;
+  };
+  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 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 (--all includes done groups)';
+    readonly args: 0;
+    readonly needsHub: true;
+  };
   readonly 'mainline set': {
-    readonly usage: 'mainline set <m> --status <status>';
-    readonly summary: 'Change status; done needs every criterion met and no proposed decision';
+    readonly usage: 'mainline set <m> [--status <status>] [--group <w|none>] [--role plan|impl] [--priority P0|P1|P2|P3]';
+    readonly summary: 'Change status, group, role or priority; done needs every criterion met and no proposed decision. A planning mainline becomes active by itself when work on it starts, so use --status for paused, done and dropped. --group none leaves the group';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -197,7 +215,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'task set': {
     readonly usage: 'task set <m/t> [--status] [--reason --waiting-for --signal] [--repo] [--branch --worktree --base --merge]';
-    readonly summary: 'Change status, repository or branch state; --status blocked needs --reason';
+    readonly summary: 'Change status, repository or branch state; --status blocked needs --reason. --status doing also moves a planning mainline to active';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -215,7 +233,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly 'item check': {
     readonly usage: 'item check <m/t#c> --evidence <evidence>';
-    readonly summary: 'Check an item with evidence';
+    readonly summary: 'Check an item with evidence; also moves a planning mainline to active';
     readonly args: 1;
     readonly needsHub: true;
   };
@@ -273,6 +291,12 @@ export declare const COMMAND_SPECS: {
     readonly args: 1;
     readonly needsHub: true;
   };
+  readonly 'issue set': {
+    readonly usage: 'issue set <i> [--group <w|none>] [--priority P0|P1|P2|P3]';
+    readonly summary: 'Put an issue in a group, or take it out with --group none, and change its priority';
+    readonly args: 1;
+    readonly needsHub: true;
+  };
   readonly 'issue list': {
     readonly usage: 'issue list [--all]';
     readonly summary: 'List open and planned issues (--all includes closed)';
@@ -316,7 +340,7 @@ export declare const COMMAND_SPECS: {
     readonly needsHub: true;
   };
   readonly 'section append': {
-    readonly usage: 'section append <m|m/t|m/d|i|f> <heading> <text>';
+    readonly usage: 'section append <m|m/t|m/d|i|f|w> <heading> <text>';
     readonly summary: 'Add text at the end of a section of a document\'s body, such as a line under a task\'s 紀錄; two appends keep both, in order. The text is taken as written, even when it starts with "-"; a list line follows the list directly, other text comes after a blank line';
     readonly args: 3;
     readonly literalLast: true;
@@ -468,6 +492,18 @@ export declare const OPTIONS: {
   readonly labels: {
     readonly type: 'string';
   };
+  readonly group: {
+    readonly type: 'string';
+  };
+  readonly role: {
+    readonly type: 'string';
+  };
+  readonly priority: {
+    readonly type: 'string';
+  };
+  readonly trigger: {
+    readonly type: 'string';
+  };
   readonly target: {
     readonly type: 'string';
   };
@@ -515,6 +551,7 @@ export declare const STATUSES: {
   readonly decision: readonly ["proposed", "accepted", "superseded"];
   readonly issue: readonly ["open", "planned", "closed"];
   readonly finding: readonly ["valid", "obsolete"];
+  readonly group: readonly ["open", "done"];
   readonly session: readonly ["active", "paused", "ended", "handed-off"];
   readonly merge: readonly ["open", "merged", "abandoned"];
   readonly decider: readonly ["user", "ai", "relay"];
@@ -549,6 +586,10 @@ export declare const REFERENCES: readonly [{
   readonly target: 'finding';
   readonly format: 'f{NNN}';
   readonly example: 'f001';
+}, {
+  readonly target: 'group';
+  readonly format: 'w{NNN}';
+  readonly example: 'w001';
 }, {
   readonly target: 'another hub';
   readonly format: '{hub}:{reference}';
@@ -616,6 +657,7 @@ export declare const LAYOUT: {
   readonly task: '.mainflow/mainlines/m{NNN}-{slug}/tasks/t{NNN}-{slug}/task.md';
   readonly issue: '.mainflow/issues/i{NNN}-{slug}.md';
   readonly finding: '.mainflow/findings/f{NNN}-{slug}.md';
+  readonly group: '.mainflow/groups/w{NNN}-{slug}.md';
   readonly ops: '.mainflow/ops/{YYYY-MM}.log';
   readonly sessions: '.mainflow/local/sessions/{sessionId}.yaml';
 };
@@ -626,6 +668,7 @@ export declare const CLOSED_STATUSES: {
   readonly decision: readonly ['superseded'];
   readonly issue: readonly ['closed'];
   readonly finding: readonly ['obsolete'];
+  readonly group: readonly ['done'];
 };
 /** Classification every document shares: one category from the list (a hub adds more in config.yaml), P0 to P3. */
 export declare const CLASSIFICATION: {
@@ -633,6 +676,15 @@ 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 ["概述", "背景與前置", "現況查核", "範圍與不做", "限制"];
@@ -641,6 +693,7 @@ export declare const SECTIONS: {
   readonly decision: readonly ["背景", "選項", "建議", "決定", "理由"];
   readonly issue: readonly ["背景", "要做的事", "完成條件"];
   readonly finding: readonly ["發現", "影響", "做法"];
+  readonly group: readonly ["說明"];
 };
 /**
  * The mainline section that records what was checked before tasks were written, one `- {label}：{text}`
@@ -659,11 +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];
+  readonly mainline: readonly [...FieldSpec[], 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];
+  readonly issue: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
   readonly finding: readonly [...FieldSpec[], FieldSpec, FieldSpec, FieldSpec];
+  readonly group: readonly [...FieldSpec[], FieldSpec];
   readonly criterion: FieldSpec[];
   readonly checklistItem: readonly [...FieldSpec[], FieldSpec];
   readonly grant: readonly [FieldSpec, FieldSpec, FieldSpec, FieldSpec];