mainflow 0.36.0 → 0.38.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, H as HubError, Q as unavailableHubs, S as loadSessions, V as checkHubName, W as loadHub, Y as memberOfGroup, Z as remoteMembers, _ as initHub, _t as findHubRoot, at as MAX_FILE_BYTES, b as sessionBriefing, bt as DATA_DIR, d as retroReport, f as retroReportFromReceiver, ht as requireSlug, m as RETRY_RULES, mt as TASK_FILE, p as receiverFromEnv, pt as MAINLINE_FILE, tt as nodeStorage, u as migrateHub, v as untilState, xt as WriteError, y as duplicateClaimLines } from "./host-BauijAdm.js";
+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 { 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-DGRH4iBE.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 { 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-n2ZDF0BF.js";
+import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-D38sNgXM.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",
@@ -1346,10 +1340,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 +1358,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,14 +1368,10 @@ 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`);

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

@@ -765,13 +765,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 +772,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 +1043,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.
 */
@@ -1095,4 +1087,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 { 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 };

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-BH9gpiap.js";
 //#region src/facts.d.ts
 export interface CommandSpec {
   usage: string;
@@ -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;
   };
@@ -167,13 +167,13 @@ export declare const COMMAND_SPECS: {
   };
   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;
   };
@@ -495,9 +495,6 @@ export declare const OPTIONS: {
   readonly group: {
     readonly type: 'string';
   };
-  readonly role: {
-    readonly type: 'string';
-  };
   readonly priority: {
     readonly type: 'string';
   };
@@ -676,15 +673,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 ["概述", "背景與前置", "現況查核", "範圍與不做", "限制"];
@@ -712,7 +700,7 @@ 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];

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 { $ 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 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 = {
@@ -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
 	},
@@ -157,13 +157,13 @@ const COMMAND_SPECS = {
 	},
 	"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
 	},
@@ -418,7 +418,6 @@ const OPTIONS = {
 	origin: { type: "string" },
 	labels: { type: "string" },
 	group: { type: "string" },
-	role: { type: "string" },
 	priority: { type: "string" },
 	trigger: { type: "string" },
 	target: { type: "string" },
@@ -575,15 +574,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 +645,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"),
@@ -728,4 +717,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-BH9gpiap.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 { et as GRANT_FORMS } from "./dist-CZYL5PJ4.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-B32s8PHu.js";
+import { _ as Task, a as Decision, c as Group, d as Mainline, f as OpsEntry, h as Session, i as ChecklistItem, n as ActionBlock, s as Finding, t as Action, u as Issue } from "./index-BH9gpiap.js";
 import { z } from "zod";
 //#region ../core/dist/ids/allocators.d.ts
 /** The letters ids start with. */
@@ -123,8 +123,6 @@ interface MainlineInput {
   title: string;
   /** A group of this hub the mainline belongs to */
   group?: string;
-  /** plan or impl; without one the mainline is an impl one */
-  role?: string;
   priority?: string;
 }
 declare function createMainline(hub: HubReader, input: MainlineInput, ctx: OpContext): OpResult<{
@@ -137,12 +135,11 @@ interface MainlinePatch {
   status?: string;
   /** A group of this hub, or `none` (null) to leave every group */
   group?: string | null;
-  role?: string;
   priority?: string;
   expectedVersion?: string;
 }
 /**
- * Change a mainline's status, group, role or priority. Done is refused while criteria are open or decisions are
+ * Change a mainline's status, group or priority. Done is refused while criteria are open or decisions are
  * proposed; the other fields change without conditions, in the same write.
  */
 declare function setMainline(hub: HubReader, input: MainlinePatch, ctx: OpContext): OpResult<Mainline>;

package/dist/hooks.js

@@ -1,6 +1,6 @@
-import { F as configSchema, it as describeRequest } from "./dist-ud09dzZo.js";
-import { A as mayDecorate, C as readSession, D as decorateReply, E as matchGrants, H as HubError, O as endsWithMarker, S as loadSessions, T as grantScope, W as loadHub, _t as findHubRoot, b as sessionBriefing, bt as DATA_DIR, et as readYaml, gt as currentBranch, i as hostName, k as headerLine, vt as worktreesOf, x as turnReminder } from "./host-BauijAdm.js";
-import { n as hubWriter, r as writtenLines } from "./operation-DGRH4iBE.js";
+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 { resolveFixed, scanCommand, scopedCwd } from "./grant-commands.js";
 import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
@@ -425,6 +425,18 @@ const PROJECT_HUB_EVENTS = /* @__PURE__ */ new Set(["pre-tool-use"]);
 function hubRootFor(event, ctx) {
 	return (PROJECT_HUB_EVENTS.has(event) && ctx.projectDir && isAbsolute(ctx.projectDir) ? findHubRoot(ctx.projectDir) : null) ?? findHubRoot(typeof ctx.payload.cwd === "string" ? ctx.payload.cwd : process.cwd());
 }
+/** Events whose output reaches the model before it works, so they carry the notice that the hub's data format does not match this CLI. */
+const FORMAT_NOTICE_EVENTS = /* @__PURE__ */ new Set(["session-start", "user-prompt-submit"]);
+/** What the model is told when the hub's data format is not the one this CLI reads and writes; null when it is. */
+function formatNotice(root, cli) {
+	const found = hubFormatVersion(nodeStorage(root));
+	const reason = found === null ? null : formatMismatch(found);
+	if (found === null || reason === null) return null;
+	return {
+		text: found < 3 ? `[mainflow] 這個 hub 的資料格式是 ${found}，這版 mainflow 讀寫的是 3，要先跑 ${cli} migrate 才能讀寫紀錄。` : `[mainflow] 這個 hub 的資料格式是 ${found}，比這版 mainflow 讀寫的 3 新，要先在這個 hub 安裝對應版本的 mainflow 才能讀寫紀錄。`,
+		reason
+	};
+}
 /** What an event prints when it cannot run its handler; null for the events that stay silent. */
 function hookFallback(platform, event, ctx, failure) {
 	const fallback = HOOK_FALLBACKS[platform]?.[event];
@@ -461,6 +473,11 @@ async function runHook(platform, event, ctx) {
 			for (const line of writtenLines(written)) if (line.startsWith("!")) warn(`mainflow hook ${platform} ${event}: ${line.slice(2)}`);
 			return written;
 		};
+		const notice = FORMAT_NOTICE_EVENTS.has(event) ? formatNotice(root, ctx.cli) : null;
+		if (notice) return {
+			stdout: notice.text,
+			error: errorText(`mainflow hook ${platform} ${event}: ${notice.reason}`)
+		};
 		return {
 			stdout: await handler(root, {
 				...ctx,