mainflow 0.28.0 → 0.29.0

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: {
@@ -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';
@@ -301,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';
@@ -315,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: {
@@ -445,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;
@@ -508,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-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: {
@@ -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",
@@ -292,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",
@@ -306,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 = {
@@ -361,6 +399,10 @@ const OPTIONS = {
 		type: "boolean",
 		default: false
 	},
+	hook: {
+		type: "boolean",
+		default: false
+	},
 	"dry-run": {
 		type: "boolean",
 		default: false
@@ -435,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).
 */
@@ -527,7 +588,7 @@ 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 指令改"),
@@ -611,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 = {