mainflow 0.27.0 → 0.29.0-alpha.1

package/dist/{dist-CBGKXsoi.js → dist-BbamrIPW.js}

@@ -948,6 +948,8 @@ const sessionSchema = z.object({
 	description: text.optional(),
 	depth: z.number().int().nonnegative().optional(),
 	summary: text.optional(),
+	/** Digest of the grants, waits and queue warnings the last turn reminder listed in full, so an unchanged set is not listed again */
+	reminderDigest: text.optional(),
 	/** Hidden from the default views; independent of status, an ended session stays visible until archived */
 	archivedAt: date.optional()
 });

package/dist/facts.d.ts

@@ -1,4 +1,4 @@
-import { a as SLUG, i as SERVES_REF, n as FORMAT_VERSION, o as SurveyLine, r as ID_PATTERNS, s as Until, t as CHECKLIST_REF } from "./index-bIFT1ORw.js";
+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-DV6Gqu8K.js";
 //#region src/facts.d.ts
 export interface CommandSpec {
   usage: string;
@@ -7,6 +7,8 @@ export interface CommandSpec {
   args: number;
   /** Extra positional arguments the command also accepts */
   optionalArgs?: number;
+  /** The last argument is text taken as written, so a list line such as "- 完成" is not read as an option */
+  literalLast?: boolean;
   needsHub: boolean;
 }
 export declare const COMMAND_SPECS: {
@@ -140,7 +142,7 @@ export declare const COMMAND_SPECS: {
     readonly needsHub: true;
   };
   readonly 'new issue': {
-    readonly usage: 'new issue <slug> --title <title> [--origin <ref>]';
+    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 args: 1;
     readonly needsHub: true;
@@ -169,6 +171,12 @@ export declare const COMMAND_SPECS: {
     readonly args: 1;
     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 args: 2;
+    readonly needsHub: true;
+  };
   readonly 'criterion check': {
     readonly usage: 'criterion check <m#r> --evidence <evidence>';
     readonly summary: 'Mark a criterion as met';
@@ -199,6 +207,12 @@ export declare const COMMAND_SPECS: {
     readonly args: 1;
     readonly needsHub: true;
   };
+  readonly 'item add': {
+    readonly usage: 'item add <m/t> <text> --done-when <text> [--serves <r>[,...]]';
+    readonly summary: 'Add an open checklist item at the end of the task\'s checklist with the next c id; --serves names criteria of its mainline';
+    readonly args: 2;
+    readonly needsHub: true;
+  };
   readonly 'item check': {
     readonly usage: 'item check <m/t#c> --evidence <evidence>';
     readonly summary: 'Check an item with evidence';
@@ -223,6 +237,12 @@ export declare const COMMAND_SPECS: {
     readonly args: 1;
     readonly needsHub: true;
   };
+  readonly 'item undrop': {
+    readonly usage: 'item undrop <m/t#c>';
+    readonly summary: 'Bring a dropped item back as an unchecked item, clearing dropped and supersededBy';
+    readonly args: 1;
+    readonly needsHub: true;
+  };
   readonly 'issue plan': {
     readonly usage: 'issue plan <i> <m/t>';
     readonly summary: 'Schedule an issue into the task that will carry it out';
@@ -295,6 +315,13 @@ export declare const COMMAND_SPECS: {
     readonly args: 0;
     readonly needsHub: true;
   };
+  readonly 'section append': {
+    readonly usage: 'section append <m|m/t|m/d|i|f> <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;
+    readonly needsHub: true;
+  };
   readonly 'decision supersede': {
     readonly usage: 'decision supersede <m/d> --by <d>';
     readonly summary: 'Mark a decision as replaced by another';
@@ -309,10 +336,28 @@ export declare const COMMAND_SPECS: {
   };
   readonly retro: {
     readonly usage: 'retro <m> [--json]';
-    readonly summary: 'Read the Claude Code transcripts of the sessions that served a mainline, and their subagents\', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only';
+    readonly summary: 'Read the Claude Code transcripts of the sessions that served a mainline, and their subagents\', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only. With MAINFLOW_TELEMETRY_URL and MAINFLOW_TELEMETRY_TOKEN set it also reads the measurement receiver\'s export: billed cost per request, and the run time of every hook, the silent ones too';
     readonly args: 1;
     readonly needsHub: true;
   };
+  readonly sync: {
+    readonly usage: 'sync';
+    readonly summary: `Keep .mainflow/ in step with the hub on the sync server until stopped: pull its changes, send every local change. The server and token come from MAINFLOW_SYNC_URL and MAINFLOW_SYNC_TOKEN, or url and token in .mainflow/local/sync.json. While it runs, or with a server and token set, every mainflow write is applied here and put in the outbox, which it sends in order; a writing command waits up to 15 s for the server's answer`;
+    readonly args: 0;
+    readonly needsHub: true;
+  };
+  readonly 'sync flush': {
+    readonly usage: 'sync flush [--hook]';
+    readonly summary: 'Send every change to .mainflow/ now and print what did not reach the hub as written, such as a refused edit and where it was saved; --hook reads a PostToolUse payload from stdin and answers as the hook';
+    readonly args: 0;
+    readonly needsHub: true;
+  };
+  readonly 'sync status': {
+    readonly usage: 'sync status';
+    readonly summary: 'Say whether mainflow sync runs for this hub, whether it is online and caught up with the server, and how many writes wait to be sent';
+    readonly args: 0;
+    readonly needsHub: true;
+  };
 };
 export type CommandName = keyof typeof COMMAND_SPECS;
 export declare const OPTIONS: {
@@ -439,6 +484,10 @@ export declare const OPTIONS: {
     readonly type: 'boolean';
     readonly default: false;
   };
+  readonly hook: {
+    readonly type: 'boolean';
+    readonly default: false;
+  };
   readonly 'dry-run': {
     readonly type: 'boolean';
     readonly default: false;
@@ -502,6 +551,25 @@ export declare const REFERENCES: readonly [{
   readonly format: '{sessionId}#a{NNN}';
   readonly example: 'claude-code-1a2b3c4d#a003';
 }];
+/**
+ * The formats `retro` reads from a delegation. `label` is the subagent's description, `{item} {role} r{round}`:
+ * the item is a checklist item or task reference, or `noItem`; the role is one of `roles`; the round counts from 1
+ * per item and role. `findings` is the block a reviewer ends its reply with: a `fence` code block, one JSON object
+ * per line with `fields`, `sev` one of `severities` and `class` one of `classes`.
+ */
+export declare const RETRO_FORMATS: {
+  readonly label: {
+    readonly pattern: '{item} {role} r{round}';
+    readonly roles: readonly ["impl", "review", "check", "survey", "explore"];
+    readonly noItem: "-";
+  };
+  readonly findings: {
+    readonly fence: "review-findings";
+    readonly fields: readonly ["id", "sev", "class", "src"];
+    readonly severities: readonly ["high", "mid", "low"];
+    readonly classes: readonly ["preexisting", "spec-gap", "impl-bug"];
+  };
+};
 /**
  * Conditions a blocked action's `until` takes and `wait` checks, one example each: a commit on a branch whose
  * message contains the text (git log runs at the hub root), an action that is done, a path relative to the hub root that exists (`..` reaches sibling repositories).

package/dist/facts.js

@@ -1,4 +1,5 @@
-import { A as WORK_STATUS, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, J as GRANT_ACTIONS, O as TASK_SECTIONS, T as SURVEY_LINES, X as GRANT_TARGET_FORMS, Y 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-CBGKXsoi.js";
+import { A as WORK_STATUS, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, J as GRANT_ACTIONS, O as TASK_SECTIONS, T as SURVEY_LINES, X as GRANT_TARGET_FORMS, Y 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-BbamrIPW.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 = {
 	init: {
@@ -131,7 +132,7 @@ const COMMAND_SPECS = {
 		needsHub: true
 	},
 	"new issue": {
-		usage: "new issue <slug> --title <title> [--origin <ref>]",
+		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",
 		args: 1,
 		needsHub: true
@@ -160,6 +161,12 @@ const COMMAND_SPECS = {
 		args: 1,
 		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",
+		args: 2,
+		needsHub: true
+	},
 	"criterion check": {
 		usage: "criterion check <m#r> --evidence <evidence>",
 		summary: "Mark a criterion as met",
@@ -190,6 +197,12 @@ const COMMAND_SPECS = {
 		args: 1,
 		needsHub: true
 	},
+	"item add": {
+		usage: "item add <m/t> <text> --done-when <text> [--serves <r>[,...]]",
+		summary: "Add an open checklist item at the end of the task's checklist with the next c id; --serves names criteria of its mainline",
+		args: 2,
+		needsHub: true
+	},
 	"item check": {
 		usage: "item check <m/t#c> --evidence <evidence>",
 		summary: "Check an item with evidence",
@@ -214,6 +227,12 @@ const COMMAND_SPECS = {
 		args: 1,
 		needsHub: true
 	},
+	"item undrop": {
+		usage: "item undrop <m/t#c>",
+		summary: "Bring a dropped item back as an unchecked item, clearing dropped and supersededBy",
+		args: 1,
+		needsHub: true
+	},
 	"issue plan": {
 		usage: "issue plan <i> <m/t>",
 		summary: "Schedule an issue into the task that will carry it out",
@@ -286,6 +305,13 @@ const COMMAND_SPECS = {
 		args: 0,
 		needsHub: true
 	},
+	"section append": {
+		usage: "section append <m|m/t|m/d|i|f> <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,
+		needsHub: true
+	},
 	"decision supersede": {
 		usage: "decision supersede <m/d> --by <d>",
 		summary: "Mark a decision as replaced by another",
@@ -300,9 +326,27 @@ const COMMAND_SPECS = {
 	},
 	retro: {
 		usage: "retro <m> [--json]",
-		summary: "Read the Claude Code transcripts of the sessions that served a mainline, and their subagents', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only",
+		summary: "Read the Claude Code transcripts of the sessions that served a mainline, and their subagents', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only. With MAINFLOW_TELEMETRY_URL and MAINFLOW_TELEMETRY_TOKEN set it also reads the measurement receiver's export: billed cost per request, and the run time of every hook, the silent ones too",
 		args: 1,
 		needsHub: true
+	},
+	sync: {
+		usage: "sync",
+		summary: `Keep .mainflow/ in step with the hub on the sync server until stopped: pull its changes, send every local change. The server and token come from MAINFLOW_SYNC_URL and MAINFLOW_SYNC_TOKEN, or url and token in .mainflow/local/sync.json. While it runs, or with a server and token set, every mainflow write is applied here and put in the outbox, which it sends in order; a writing command waits up to 15 s for the server's answer`,
+		args: 0,
+		needsHub: true
+	},
+	"sync flush": {
+		usage: "sync flush [--hook]",
+		summary: "Send every change to .mainflow/ now and print what did not reach the hub as written, such as a refused edit and where it was saved; --hook reads a PostToolUse payload from stdin and answers as the hook",
+		args: 0,
+		needsHub: true
+	},
+	"sync status": {
+		usage: "sync status",
+		summary: "Say whether mainflow sync runs for this hub, whether it is online and caught up with the server, and how many writes wait to be sent",
+		args: 0,
+		needsHub: true
 	}
 };
 const OPTIONS = {
@@ -355,6 +399,10 @@ const OPTIONS = {
 		type: "boolean",
 		default: false
 	},
+	hook: {
+		type: "boolean",
+		default: false
+	},
 	"dry-run": {
 		type: "boolean",
 		default: false
@@ -429,6 +477,25 @@ const REFERENCES = [
 	}
 ];
 /**
+* The formats `retro` reads from a delegation. `label` is the subagent's description, `{item} {role} r{round}`:
+* the item is a checklist item or task reference, or `noItem`; the role is one of `roles`; the round counts from 1
+* per item and role. `findings` is the block a reviewer ends its reply with: a `fence` code block, one JSON object
+* per line with `fields`, `sev` one of `severities` and `class` one of `classes`.
+*/
+const RETRO_FORMATS = {
+	label: {
+		pattern: "{item} {role} r{round}",
+		roles: LABEL_ROLES,
+		noItem: "-"
+	},
+	findings: {
+		fence: FINDINGS_FENCE,
+		fields: FINDING_FIELDS,
+		severities: FINDING_SEVERITIES,
+		classes: FINDING_CLASSES
+	}
+};
+/**
 * Conditions a blocked action's `until` takes and `wait` checks, one example each: a commit on a branch whose
 * message contains the text (git log runs at the hub root), an action that is done, a path relative to the hub root that exists (`..` reaches sibling repositories).
 */
@@ -521,13 +588,13 @@ const EVERY = [
 ];
 /** Criteria and checklist items share these; items add serves. */
 const LIST_ITEM = [
-	field("id", true, "清單內不重複的編號，解決條件為 r{NNN}，checklist 項目為 c{NNN}；直接改檔時自己寫下一個"),
+	field("id", true, "清單內不重複的編號，解決條件為 r{NNN}，checklist 項目為 c{NNN}；由 criterion add 或 item add 配發，直接改檔時自己寫下一個"),
 	field("text", true, "要做到的事，一句話"),
 	field("doneWhen", false, "怎樣才算完成；還沒結束的條目必填，check 會檢查"),
 	field("done", true, "是否已完成，用 check 指令改"),
 	field("evidence", false, "完成的證據，done 為 true 時必填"),
 	field("doneAt", false, "完成的日期，由 CLI 寫入"),
-	field("dropped", false, "不再需要時為 true，用 item drop 標記"),
+	field("dropped", false, "不再需要時為 true，用 item drop 標記，item undrop 撤銷；已放棄的條目不能 check"),
 	field("supersededBy", false, "被哪個參照取代"),
 	field("note", false, "一句備註，例如放棄的原因")
 ];
@@ -549,7 +616,7 @@ const FIELDS = {
 		field("order", false, "在主脈絡內的順序，小的在前"),
 		field("dependsOn", false, "開始前必須先完成的任務"),
 		field("repo", false, "主要動到的倉庫，名稱需在 config.yaml 登記"),
-		field("touches", false, "預計會改到的路徑或 glob 清單，相對於 repo 的根目錄；兩條進行中的主脈絡各有未結束的任務在同一個 repo 碰到重疊的路徑、彼此又沒有 depends-on 時，check 列出警告"),
+		field("touches", false, "預計會改到的路徑或 glob 清單，相對於 repo 的根目錄；兩條進行中的主脈絡各有未結束的任務在同一個 repo 碰到重疊的路徑、彼此又沒有 depends-on 時，check 列出警告；有 touches 卻沒填 repo 時路徑不會被比對，check 也列警告"),
 		field("startedAt", false, "第一次轉為 doing 時由 CLI 寫入"),
 		field("checklist", true, "checklist 項目清單，每項的欄位見 checklistItem"),
 		field("blockedBy", false, "卡住時的原因、等待對象與繼續的訊號，blocked 時必填；等待對象整串是參照時（例如 m031/t002）會檢查它存在"),
@@ -605,4 +672,4 @@ const FIELDS = {
 	]
 };
 //#endregion
-export { CHECKLIST_REF, CLASSIFICATION, CLOSED_STATUSES, COMMAND_SPECS, FIELDS, FORMAT_VERSION, GRANTS, ID_PATTERNS, LAYOUT, LINKS, OPTIONS, REFERENCES, 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-bIFT1ORw.js";
+import "./index-DV6Gqu8K.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 { Y as GRANT_FORMS } from "./dist-CBGKXsoi.js";
+import { Y as GRANT_FORMS } from "./dist-BbamrIPW.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";