mainflow 0.34.0 → 0.35.0

package/dist/facts.js

@@ -1,4 +1,4 @@
-import { A as WORK_STATUS, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, O as TASK_SECTIONS, Q as GRANT_TARGET_FORMS, T as SURVEY_LINES, X as GRANT_ACTIONS, Z as GRANT_FORMS, _ as MERGE_STATES, a as DECISION_SECTIONS, c as FINDING_SECTIONS, d as ID_PATTERNS, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, k as UNTIL_FORMS, l as FINDING_STATUS, m as LINK_RELS, n as CLOSED_STATUS, o as DECISION_STATUS, p as ISSUE_STATUS, r as DECIDERS, s as DEFAULT_CATEGORIES, t as CHECKLIST_REF, u as FORMAT_VERSION, v as PRIORITIES, w as SLUG, x as SERVES_REF } from "./dist-IdbnCDqM.js";
+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-BdvWGTsb.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 = {
@@ -96,7 +96,7 @@ const COMMAND_SPECS = {
 	},
 	"action set": {
 		usage: "action set <a|session#a> [--status] [--reason --waiting-for --until] [--text] [--serves] [--before <a>] [--note <text>] [--session <session>]",
-		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",
+		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",
 		args: 1,
 		needsHub: true
 	},
@@ -114,8 +114,8 @@ const COMMAND_SPECS = {
 		needsHub: false
 	},
 	"new mainline": {
-		usage: "new mainline <slug> --title <title>",
-		summary: "Create mainline.md with the next id and the section template; write the rest in the file",
+		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; --role plan makes it the mainline that splits the work, coordinates it and makes the final check (without --role it is an impl mainline)",
 		args: 1,
 		needsHub: true
 	},
@@ -132,8 +132,8 @@ const COMMAND_SPECS = {
 		needsHub: true
 	},
 	"new issue": {
-		usage: "new issue <slug> --title <title> [--origin <ref>] [--labels a,b]",
-		summary: "Create an issue file for a follow-up that must outlive its mainline",
+		usage: "new issue <slug> --title <title> [--origin <ref>] [--labels a,b] [--group <w>] [--priority P0|P1|P2|P3]",
+		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",
 		args: 1,
 		needsHub: true
 	},
@@ -143,9 +143,27 @@ const COMMAND_SPECS = {
 		args: 1,
 		needsHub: true
 	},
+	"new group": {
+		usage: "new group <slug> --title <title> [--priority P0|P1|P2|P3] [--trigger <when>] [--origin <ref>] [--labels a,b]",
+		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",
+		args: 1,
+		needsHub: true
+	},
+	"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",
+		args: 1,
+		needsHub: true
+	},
+	"group list": {
+		usage: "group list [--all]",
+		summary: "List open groups by priority with their trigger and members, plan mainlines first (--all includes done groups)",
+		args: 0,
+		needsHub: true
+	},
 	"mainline set": {
-		usage: "mainline set <m> --status <status>",
-		summary: "Change status; done needs every criterion met and no proposed decision",
+		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",
 		args: 1,
 		needsHub: true
 	},
@@ -187,7 +205,7 @@ const COMMAND_SPECS = {
 	},
 	"task set": {
 		usage: "task set <m/t> [--status] [--reason --waiting-for --signal] [--repo] [--branch --worktree --base --merge]",
-		summary: "Change status, repository or branch state; --status blocked needs --reason",
+		summary: "Change status, repository or branch state; --status blocked needs --reason. --status doing also moves a planning mainline to active",
 		args: 1,
 		needsHub: true
 	},
@@ -205,7 +223,7 @@ const COMMAND_SPECS = {
 	},
 	"item check": {
 		usage: "item check <m/t#c> --evidence <evidence>",
-		summary: "Check an item with evidence",
+		summary: "Check an item with evidence; also moves a planning mainline to active",
 		args: 1,
 		needsHub: true
 	},
@@ -263,6 +281,12 @@ const COMMAND_SPECS = {
 		args: 1,
 		needsHub: true
 	},
+	"issue set": {
+		usage: "issue set <i> [--group <w|none>] [--priority P0|P1|P2|P3]",
+		summary: "Put an issue in a group, or take it out with --group none, and change its priority",
+		args: 1,
+		needsHub: true
+	},
 	"issue list": {
 		usage: "issue list [--all]",
 		summary: "List open and planned issues (--all includes closed)",
@@ -306,7 +330,7 @@ const COMMAND_SPECS = {
 		needsHub: true
 	},
 	"section append": {
-		usage: "section append <m|m/t|m/d|i|f> <heading> <text>",
+		usage: "section append <m|m/t|m/d|i|f|w> <heading> <text>",
 		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",
 		args: 3,
 		literalLast: true,
@@ -393,6 +417,10 @@ const OPTIONS = {
 	affects: { type: "string" },
 	origin: { type: "string" },
 	labels: { type: "string" },
+	group: { type: "string" },
+	role: { type: "string" },
+	priority: { type: "string" },
+	trigger: { type: "string" },
 	target: { type: "string" },
 	op: { type: "string" },
 	result: { type: "string" },
@@ -430,6 +458,7 @@ const STATUSES = {
 	decision: DECISION_STATUS,
 	issue: ISSUE_STATUS,
 	finding: FINDING_STATUS,
+	group: GROUP_STATUS,
 	session: SESSION_STATUS,
 	merge: MERGE_STATES,
 	decider: DECIDERS,
@@ -472,6 +501,11 @@ const REFERENCES = [
 		format: "f{NNN}",
 		example: "f001"
 	},
+	{
+		target: "group",
+		format: "w{NNN}",
+		example: "w001"
+	},
 	{
 		target: "another hub",
 		format: "{hub}:{reference}",
@@ -529,6 +563,7 @@ const LAYOUT = {
 	task: ".mainflow/mainlines/m{NNN}-{slug}/tasks/t{NNN}-{slug}/task.md",
 	issue: ".mainflow/issues/i{NNN}-{slug}.md",
 	finding: ".mainflow/findings/f{NNN}-{slug}.md",
+	group: ".mainflow/groups/w{NNN}-{slug}.md",
 	ops: ".mainflow/ops/{YYYY-MM}.log",
 	sessions: ".mainflow/local/sessions/{sessionId}.yaml"
 };
@@ -540,6 +575,15 @@ 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,
@@ -547,7 +591,8 @@ const SECTIONS = {
 	taskRequired: TASK_REQUIRED_SECTIONS,
 	decision: DECISION_SECTIONS,
 	issue: ISSUE_SECTIONS,
-	finding: FINDING_SECTIONS
+	finding: FINDING_SECTIONS,
+	group: GROUP_SECTIONS
 };
 /**
 * The mainline section that records what was checked before tasks were written, one `- {label}：{text}`
@@ -609,6 +654,8 @@ const LIST_ITEM = [
 const FIELDS = {
 	mainline: [
 		...shared(...EVERY),
+		field("group", false, "所屬的組 w{NNN}，一條主脈絡最多一組；組和依賴無關"),
+		field("role", false, "plan 是拆分顆粒、整合調度與最終確認的規劃型，impl 是執行的實作型；沒填視為 impl"),
 		field("due", false, "預計完成的日期"),
 		field("archivedAt", false, "封存的日期，和狀態分開"),
 		field("criteria", true, "解決條件清單，每條的欄位見 criterion"),
@@ -643,6 +690,7 @@ const FIELDS = {
 	],
 	issue: [
 		...shared(...EVERY),
+		field("group", false, "所屬的組 w{NNN}，一筆待辦最多一組；同組的待辦在同一個時機一起做"),
 		field("order", false, "待辦之間的順序"),
 		field("due", false, "預計完成的日期"),
 		field("plannedIn", false, "排進的任務，planned 時必填"),
@@ -654,6 +702,7 @@ const FIELDS = {
 		field("reviewAfter", false, "到這天要重新確認它還成立"),
 		field("archivedAt", false, "封存的日期，和狀態分開")
 	],
+	group: [...shared(...EVERY), field("trigger", false, "什麼時機做這組的事，一句話，例如「量測修正時」")],
 	criterion: LIST_ITEM,
 	checklistItem: [...LIST_ITEM, field("serves", false, "這個項目推進的解決條件，r{NNN} 清單")],
 	grant: [
@@ -674,9 +723,9 @@ const FIELDS = {
 	],
 	link: [
 		field("rel", true, "關係類型：depends-on、relates、split-from，反向由讀者推出"),
-		field("to", true, "對方的參照，不能在同一條主脈絡內；其他 hub 的加 {hub}: 前綴"),
+		field("to", true, "對方的參照，不能在同一條主脈絡內，也可以是組 w{NNN}；其他 hub 的加 {hub}: 前綴"),
 		field("note", false, "一句話說明這個關係")
 	]
 };
 //#endregion
-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 };
+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 };

package/dist/grant-commands.d.ts

@@ -1,4 +1,4 @@
-import "./index-ihgXABQc.js";
+import "./index-DgYB5u1f.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 { Z as GRANT_FORMS } from "./dist-IdbnCDqM.js";
+import { nt as GRANT_FORMS } from "./dist-BdvWGTsb.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,8 +1,8 @@
-import { a as Decision, d as OpsEntry, g as Task, i as ChecklistItem, l as Issue, m as Session, n as ActionBlock, s as Finding, t as Action, u as Mainline } from "./index-ihgXABQc.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-DgYB5u1f.js";
 import { z } from "zod";
 //#region ../core/dist/ids/allocators.d.ts
 /** The letters ids start with. */
-type IdPrefix = 'm' | 't' | 'd' | 'i' | 'f' | 'c' | 'r' | 'a';
+type IdPrefix = 'm' | 't' | 'd' | 'i' | 'f' | 'w' | 'c' | 'r' | 'a';
 /** One id an operation needs. */
 interface IdRequest {
   prefix: IdPrefix;
@@ -121,17 +121,31 @@ declare function addHub(hub: HubReader, input: {
 interface MainlineInput {
   slug: string;
   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<{
   id: string;
   dir: string;
 }>;
-/** Move a mainline to another status; done is refused while criteria are open or decisions are proposed. */
-declare function setMainlineStatus(hub: HubReader, input: {
+/** What `mainline set` changes; at least one. */
+interface MainlinePatch {
   id: string;
-  status: string;
+  status?: string;
+  /** A group of this hub, or `none` (null) to leave every group */
+  group?: string | null;
+  role?: string;
+  priority?: string;
   expectedVersion?: string;
-}, ctx: OpContext): OpResult<Mainline>;
+}
+/**
+ * Change a mainline's status, group, role 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>;
 /** Rename a mainline. References use its ID, so they keep resolving and show the new title. */
 declare function setMainlineTitle(hub: HubReader, input: {
   id: string;
@@ -272,10 +286,24 @@ interface HubItemInput {
   origin?: string;
   labels?: string[];
 }
-declare function createIssue(hub: HubReader, input: HubItemInput, ctx: OpContext): OpResult<{
+declare function createIssue(hub: HubReader, input: HubItemInput & {
+  group?: string;
+  priority?: string;
+}, ctx: OpContext): OpResult<{
   id: string;
   file: string;
 }>;
+/** What `issue set` changes: the group the issue is taken up with and its priority; at least one. */
+interface IssuePatch {
+  /** A group of this hub, or `none` (null) to leave every group */
+  group?: string | null;
+  priority?: string;
+}
+declare function setIssue(hub: HubReader, input: {
+  id: string;
+  patch: IssuePatch;
+  expectedVersion?: string;
+}): OpResult<Issue>;
 /** Schedule an issue into the task that will carry it out. */
 declare function planIssue(hub: HubReader, input: {
   id: string;
@@ -312,6 +340,29 @@ declare function setFindingArchived(hub: HubReader, input: {
   archived: boolean;
   expectedVersion?: string;
 }, ctx: OpContext): OpResult<Finding>;
+/**
+ * A group gathers mainlines and issues that are taken up together, apart from what depends on what. Its members name
+ * it in their own `group`, so creating a group writes only the group's file.
+ */
+declare function createGroup(hub: HubReader, input: HubItemInput & {
+  priority?: string;
+  trigger?: string;
+}, ctx: OpContext): OpResult<{
+  id: string;
+  file: string;
+}>;
+/** What `group set` changes; at least one. An empty trigger removes it. */
+interface GroupPatch {
+  status?: string;
+  priority?: string;
+  trigger?: string;
+  title?: string;
+}
+declare function setGroup(hub: HubReader, input: {
+  id: string;
+  patch: GroupPatch;
+  expectedVersion?: string;
+}, ctx: OpContext): OpResult<Group>;
 /** Append one external operation to ops/{YYYY-MM}.log; the log is never rewritten. `at` defaults to the context's time. */
 declare function appendOps(hub: HubReader, input: Omit<OpsEntry, 'at'> & {
   at?: string;
@@ -431,7 +482,7 @@ declare function updateAction(hub: HubReader, input: {
  * (`item check` and `item uncheck` send `item.check`, with done true or false). The operations no command sends
  * are listed in COMMANDLESS_OPERATIONS with who sends them.
  */
-declare const OPERATION_NAMES: readonly ['repo.add', 'hub.add', 'mainline.new', 'mainline.set', 'mainline.title', 'mainline.archive', 'criterion.add', 'criterion.check', 'criterion.set', 'task.new', 'task.set', 'item.add', 'item.check', 'item.drop', 'item.undrop', 'decision.new', 'decision.accept', 'decision.supersede', 'issue.new', 'issue.plan', 'issue.close', 'issue.reopen', 'issue.archive', 'finding.new', 'finding.set', 'finding.archive', 'ops.add', 'section.append', 'session.start', 'session.ensure', 'session.handoff', 'session.info', 'session.reminder', 'session.set', 'session.settle', 'session.archive', 'action.add', 'action.set', 'file.remove'];
+declare const OPERATION_NAMES: readonly ['repo.add', 'hub.add', 'mainline.new', 'mainline.set', 'mainline.title', 'mainline.archive', 'criterion.add', 'criterion.check', 'criterion.set', 'task.new', 'task.set', 'item.add', 'item.check', 'item.drop', 'item.undrop', 'decision.new', 'decision.accept', 'decision.supersede', 'issue.new', 'issue.set', 'issue.plan', 'issue.close', 'issue.reopen', 'issue.archive', 'finding.new', 'finding.set', 'finding.archive', 'group.new', 'group.set', 'ops.add', 'section.append', 'session.start', 'session.ensure', 'session.handoff', 'session.info', 'session.reminder', 'session.set', 'session.settle', 'session.archive', 'action.add', 'action.set', 'file.remove'];
 type OperationName = (typeof OPERATION_NAMES)[number];
 //#endregion
 //#region ../core/dist/ops/operations.d.ts
@@ -445,7 +496,7 @@ declare const OPERATIONS: {
   readonly 'repo.add': typeof addRepo;
   readonly 'hub.add': typeof addHub;
   readonly 'mainline.new': typeof createMainline;
-  readonly 'mainline.set': typeof setMainlineStatus;
+  readonly 'mainline.set': typeof setMainline;
   readonly 'mainline.title': typeof setMainlineTitle;
   readonly 'mainline.archive': typeof setMainlineArchived;
   readonly 'criterion.add': typeof addCriterion;
@@ -461,6 +512,7 @@ declare const OPERATIONS: {
   readonly 'decision.accept': typeof acceptDecision;
   readonly 'decision.supersede': typeof supersedeDecision;
   readonly 'issue.new': typeof createIssue;
+  readonly 'issue.set': typeof setIssue;
   readonly 'issue.plan': typeof planIssue;
   readonly 'issue.close': typeof closeIssue;
   readonly 'issue.reopen': typeof reopenIssue;
@@ -468,6 +520,8 @@ declare const OPERATIONS: {
   readonly 'finding.new': typeof createFinding;
   readonly 'finding.set': typeof setFindingStatus;
   readonly 'finding.archive': typeof setFindingArchived;
+  readonly 'group.new': typeof createGroup;
+  readonly 'group.set': typeof setGroup;
   readonly 'ops.add': typeof appendOps;
   readonly 'section.append': typeof appendSection;
   readonly 'session.start': typeof startSession;

package/dist/hooks.js

@@ -1,6 +1,6 @@
-import { $ as describeRequest, j as configSchema } from "./dist-IdbnCDqM.js";
-import { D as endsWithMarker, E as decorateReply, H as loadHub, J as readYaml, O as headerLine, S as readSession, T as matchGrants, V as HubError, b as turnReminder, dt as findHubRoot, ft as worktreesOf, i as hostName, k as mayDecorate, mt as DATA_DIR, ut as currentBranch, w as grantScope, x as loadSessions, y as sessionBriefing } from "./host-79T-_NMu.js";
-import { n as hubWriter, r as writtenLines } from "./operation--fJnUqvA.js";
+import { F as configSchema, it as describeRequest } from "./dist-BdvWGTsb.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, Z as readYaml, _t as DATA_DIR, b as sessionBriefing, ht as worktreesOf, i as hostName, k as headerLine, mt as findHubRoot, pt as currentBranch, x as turnReminder } from "./host-bnHYIwuY.js";
+import { n as hubWriter, r as writtenLines } from "./operation-DVcJgKM9.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";