mainflow 0.27.0 → 0.28.0

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { $ as createFinding, A as duplicateClaimLines, B as setSessionStatus, C as setCriterion, D as supersedeDecision, F as handoffSession, H as startSession, I as loadSessions, L as readSession, N as addAction, O as updateTask, Q as closeIssue, R as setSessionArchived, S as setChecklistItem, T as setMainlineStatus, W as updateAction, Z as appendOps, _ as createMainline, at as setIssueArchived, b as initHub, et as createIssue, ft as MAINLINE_FILE, g as createDecision, h as addRepo, ht as WriteError, it as setFindingStatus, j as sessionBriefing, k as untilState, l as migrateHub, m as addHub, nt as reopenIssue, ot as HubError, p as acceptDecision, pt as TASK_FILE, rt as setFindingArchived, st as loadHub, tt as planIssue, u as retroReport, v as createTask, w as setCriterionText, x as setArchived, y as dropChecklistItem, yt as findHubRoot } from "./host-sSWrUJeC.js";
-import { B as parseRef, H as refExample, V as parseUntil, k as UNTIL_FORMS } from "./dist-CBGKXsoi.js";
+import { $ as appendOps, A as untilState, B as setSessionArchived, C as setCriterion, D as supersedeDecision, H as setSessionStatus, I as handoffSession, K as updateAction, L as loadSessions, M as sessionBriefing, O as undropChecklistItem, P as addAction, R as readSession, S as setChecklistItem, T as setMainlineStatus, W as startSession, _ as createMainline, _t as WriteError, at as setFindingArchived, b as initHub, ct as HubError, et as closeIssue, g as createDecision, h as addRepo, ht as TASK_FILE, it as reopenIssue, j as duplicateClaimLines, k as updateTask, l as migrateHub, lt as loadHub, m as addHub, mt as MAINLINE_FILE, nt as createIssue, ot as setFindingStatus, p as acceptDecision, rt as planIssue, st as setIssueArchived, tt as createFinding, u as retroReport, v as createTask, w as setCriterionText, x as setArchived, xt as findHubRoot, y as dropChecklistItem } from "./host-CeN3dvXg.js";
+import { B as parseRef, H as refExample, V as parseUntil, k as UNTIL_FORMS } from "./dist-BbamrIPW.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { hookFallback, parsePayload, runHook } from "./hooks.js";
-import { l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-1i4OAsD6.js";
+import { l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-BKKoCyTj.js";
 import { readFileSync, realpathSync } from "node:fs";
 import { basename, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -206,7 +206,8 @@ const RUNS = {
 		const { id, file } = createIssue(root, {
 			slug: args[0],
 			title: required(opts, "title", "--title \"重試不穩定的 VM\""),
-			origin: opts.origin
+			origin: opts.origin,
+			labels: opts.labels ? list(opts.labels) : void 0
 		});
 		return done(`created ${id} ${relative(root, file)}`);
 	},
@@ -288,6 +289,10 @@ const RUNS = {
 		});
 		return done(`dropped ${args[0]}`);
 	},
+	"item undrop": ({ root, args }) => {
+		undropChecklistItem(root, args[0]);
+		return done(`undropped ${args[0]}`);
+	},
 	"issue plan": ({ root, args }) => done(`planned ${planIssue(root, args[0], args[1]).id} in ${args[1]}`),
 	"issue close": ({ root, args, opts }) => done(`closed ${closeIssue(root, args[0], opts.by ?? "").id}`),
 	"issue reopen": ({ root, args }) => done(`reopened ${reopenIssue(root, args[0]).id}`),

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

@@ -140,7 +140,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;
@@ -223,6 +223,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';

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, 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";
 //#region src/facts.ts
 const COMMAND_SPECS = {
 	init: {
@@ -131,7 +131,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
@@ -214,6 +214,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",
@@ -527,7 +533,7 @@ const LIST_ITEM = [
 	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 +555,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）會檢查它存在"),

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";

package/dist/hooks.js

@@ -1,5 +1,5 @@
-import { B as setSessionStatus, G as grantScope, I as loadSessions, J as endsWithMarker, K as matchGrants, L as readSession, M as turnReminder, P as ensureSession, V as settleSession, X as mayDecorate, Y as headerLine, Z as appendOps, _t as DATA_DIR, bt as worktreesOf, gt as readYaml, i as hostName, j as sessionBriefing, ot as HubError, q as decorateReply, st as loadHub, vt as currentBranch, yt as findHubRoot, z as setSessionInfo } from "./host-sSWrUJeC.js";
-import { Z as describeRequest, j as configSchema } from "./dist-CBGKXsoi.js";
+import { $ as appendOps, F as ensureSession, H as setSessionStatus, J as matchGrants, L as loadSessions, M as sessionBriefing, N as turnReminder, Q as mayDecorate, R as readSession, St as worktreesOf, U as settleSession, V as setSessionInfo, X as endsWithMarker, Y as decorateReply, Z as headerLine, bt as currentBranch, ct as HubError, i as hostName, lt as loadHub, q as grantScope, vt as readYaml, xt as findHubRoot, yt as DATA_DIR, z as setReminderDigest } from "./host-CeN3dvXg.js";
+import { Z as describeRequest, j as configSchema } from "./dist-BbamrIPW.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";
@@ -125,10 +125,55 @@ function openMainlinesIn(root, text) {
 	if (mentioned.size === 0) return [];
 	return loadHub(root, { remotes: false }).mainlines.filter((m) => mentioned.has(m.id) && !m.archivedAt && (m.status === "active" || m.status === "planning")).map((m) => m.id);
 }
+/** Tools whose `file_path` input writes a file. */
+const WRITE_TOOLS = /* @__PURE__ */ new Set([
+	"Edit",
+	"Write",
+	"MultiEdit",
+	"NotebookEdit"
+]);
+/** A Bash command that runs the mainflow CLI: by the form the hook texts give, or as a `mainflow` command word that starts a command, not one that is only an argument. */
+const isMainflowCommand = (command, cli) => command.includes(cli) || /(?:^|[;&|(])\s*mainflow\s+\S|(?:\.bin|mainflow\/dist)\/(?:cli\.js|mainflow)\b/.test(command);
+/** Whether a path lies under a `.mainflow/` directory. */
+const inMainflowData = (path) => /(?:^|\/)\.mainflow\//.test(path);
+/** A user record that holds what the user typed; tool results come back as user records too, but carry only tool_result blocks. */
+const isUserPrompt = (r) => r.type === "user" && !r.isSidechain && (typeof r.message?.content === "string" || Array.isArray(r.message?.content) && r.message.content.some((b) => b.type === "text"));
+/**
+* Whether the turn that is ending, everything after the last user message in the transcript, ran a mainflow
+* command or wrote a file under `.mainflow/`. False when the transcript is missing or unreadable, so a hook that
+* cannot tell never asks.
+*/
+function turnTouchedMainflow(transcript, cli) {
+	if (!transcript || !existsSync(transcript)) return false;
+	let lines;
+	try {
+		lines = readFileSync(transcript, "utf8").split("\n");
+	} catch {
+		return false;
+	}
+	for (let i = lines.length - 1; i >= 0; i--) {
+		if (!lines[i].trim()) continue;
+		let record;
+		try {
+			record = JSON.parse(lines[i]);
+		} catch {
+			continue;
+		}
+		if (isUserPrompt(record)) return false;
+		const content = Array.isArray(record.message?.content) ? record.message.content : [];
+		for (const block of content) {
+			if (block.type !== "tool_use") continue;
+			if (block.name === "Bash" && typeof block.input?.command === "string" && isMainflowCommand(block.input.command, cli)) return true;
+			if (block.name && WRITE_TOOLS.has(block.name) && typeof block.input?.file_path === "string" && inMainflowData(block.input.file_path)) return true;
+		}
+	}
+	return false;
+}
 /**
 * What to ask for when a turn ends without its header line: the header itself when an action is in progress, or
-* an action first when the queue is empty but the reply talks about an open mainline, since the header only names
-* the session's own action in progress. Null when there is nothing to ask for.
+* an action first when the queue is empty, the reply talks about an open mainline and the turn ran a mainflow
+* command or wrote under `.mainflow/`, since the header only names the session's own action in progress. A reply
+* that only mentions a mainline, in a draft or a question, asks for nothing. Null when there is nothing to ask for.
 */
 function missingHeaderRequest(root, { payload, cli }) {
 	if (!payload.session_id || payload.stop_hook_active) return null;
@@ -139,8 +184,8 @@ function missingHeaderRequest(root, { payload, cli }) {
 	if (header) return `[mainflow] 這一輪最後一則回覆的最後一行不是標頭。請只回一則內容為「${header}」的訊息，不加其他文字。`;
 	if (session && session.actions.length > 0) return null;
 	const mainlines = openMainlinesIn(root, message);
-	if (mainlines.length === 0) return null;
-	return `[mainflow] 這一輪的回覆提到 ${mainlines.join("、")}，但這場會話沒有行動，所以回覆結尾沒有標頭。這一輪若在推進它，先用 ${cli} action add "<做法>" --serves <m/t#c>（還沒拆任務時用解決條件 <m#r>）列出行動並用 ${cli} action set <a編號> --status doing 標為進行中，或用 ${cli} session handoff <會話> 接手上一場沒做完的行動；再只回一則內容為「▸ <m/t> · <a編號>」的訊息，不加其他文字。只是提到、沒有推進時，不必處理。`;
+	if (mainlines.length === 0 || !turnTouchedMainflow(payload.transcript_path, cli)) return null;
+	return `[mainflow] 這一輪的回覆提到 ${mainlines.join("、")}，也執行了 mainflow 指令或寫入 .mainflow/，但這場會話沒有行動，所以回覆結尾沒有標頭。這一輪若在推進它，先用 ${cli} action add "<做法>" --serves <m/t#c>（還沒拆任務時用解決條件 <m#r>）列出行動並用 ${cli} action set <a編號> --status doing 標為進行中，或用 ${cli} session handoff <會話> 接手上一場沒做完的行動；再只回一則內容為「▸ <m/t> · <a編號>」的訊息，不加其他文字。只是提到、沒有推進時，不必處理。`;
 }
 /**
 * Stop: ask for what the turn's header needs, then settle the session. Only the model knows which message closes a
@@ -162,6 +207,7 @@ const CLAUDE_CODE_EVENTS = {
 		if (!payload.session_id) return null;
 		const id = claudeCodeSessionId(payload.session_id);
 		const session = recordSession(root, payload, id, true);
+		setReminderDigest(root, id, null);
 		if (envFile) appendFileSync(envFile, `export MAINFLOW_SESSION=${id}\n`);
 		startUi?.(root);
 		return sessionBriefing(root, session, {

package/dist/{host-sSWrUJeC.js → host-CeN3dvXg.js}

@@ -1,4 +1,4 @@
-import { $ as grantForm, A as WORK_STATUS, B as parseRef, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, F as issueSchema, G as taskSchema, H as refExample, I as mainlineSchema, K as waitingForAction, L as opsEntrySchema, M as decisionSchema, N as findingSchema, O as TASK_SECTIONS, P as formatOpsEntry, Q as grantCovers, R as parseActionRef, S as SESSION_ID, T as SURVEY_LINES, U as refMainline, V as parseUntil, W as sessionSchema, Z as describeRequest, _ as MERGE_STATES, a as DECISION_SECTIONS, b as RESERVED_HUB_NAMES, c as FINDING_SECTIONS, et as grantRepo, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, j as configSchema, l as FINDING_STATUS, n as CLOSED_STATUS, q as waitingForRef, r as DECIDERS, s as DEFAULT_CATEGORIES, tt as parseGrantTarget, w as SLUG, x as SERVES_REF, y as REF_EXAMPLES, z as parseOpsLine } from "./dist-CBGKXsoi.js";
+import { $ as grantForm, A as WORK_STATUS, B as parseRef, C as SESSION_STATUS, D as TASK_REQUIRED_SECTIONS, E as SURVEY_SECTION, F as issueSchema, G as taskSchema, H as refExample, I as mainlineSchema, K as waitingForAction, L as opsEntrySchema, M as decisionSchema, N as findingSchema, O as TASK_SECTIONS, P as formatOpsEntry, Q as grantCovers, R as parseActionRef, S as SESSION_ID, T as SURVEY_LINES, U as refMainline, V as parseUntil, W as sessionSchema, Z as describeRequest, _ as MERGE_STATES, a as DECISION_SECTIONS, b as RESERVED_HUB_NAMES, c as FINDING_SECTIONS, et as grantRepo, f as ISSUE_SECTIONS, g as MAINLINE_STATUS, h as MAINLINE_SECTIONS, i as DECISION_BASES, j as configSchema, l as FINDING_STATUS, n as CLOSED_STATUS, q as waitingForRef, r as DECIDERS, s as DEFAULT_CATEGORIES, tt as parseGrantTarget, w as SLUG, x as SERVES_REF, y as REF_EXAMPLES, z as parseOpsLine } from "./dist-BbamrIPW.js";
 import { appendFileSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync, writeSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, matchesGlob, parse, posix, relative, resolve, sep } from "node:path";
 import { execFileSync, spawn, spawnSync } from "node:child_process";
@@ -451,16 +451,27 @@ function dependsOn(edges, from, to) {
 	const lands = (ref) => ref === to.mainline || ref.startsWith(`${to.mainline}#`) || ref === `${to.mainline}/${to.task.id}` || ref.startsWith(`${to.mainline}/${to.task.id}#`);
 	return edges.some((e) => fromRefs.includes(e.from) && lands(e.to));
 }
+/** Unfinished tasks of planning or active mainlines that list `touches`, each with the mainline it sits in. */
+function openTouching(mainlines) {
+	return mainlines.filter((m) => COMPARED_MAINLINE.includes(m.status)).flatMap((m) => m.tasks.filter((t) => !CLOSED_STATUS.task.includes(t.status) && t.touches?.length).map((task) => ({
+		mainline: m.id,
+		task
+	})));
+}
+/** Unfinished tasks that list `touches` but no `repo`: their paths have no root, so touchOverlaps skips them. */
+function touchesWithoutRepo(mainlines) {
+	return openTouching(mainlines).filter((p) => !p.task.repo).map((p) => ({
+		task: `${p.mainline}/${p.task.id}`,
+		file: p.task.file
+	}));
+}
 /**
 * Open tasks of different open mainlines whose `touches` overlap in the same repo and which have no depends-on
 * between them in either direction, written on the mainline or on the task. Tasks without a repo are not compared,
-* since their paths have no root to share.
+* since their paths have no root to share; touchesWithoutRepo names them.
 */
 function touchOverlaps(mainlines, edges) {
-	const open = mainlines.filter((m) => COMPARED_MAINLINE.includes(m.status)).flatMap((m) => m.tasks.filter((t) => !CLOSED_STATUS.task.includes(t.status) && t.repo && t.touches?.length).map((task) => ({
-		mainline: m.id,
-		task
-	})));
+	const open = openTouching(mainlines).filter((p) => p.task.repo);
 	const overlaps = [];
 	open.forEach((a, i) => {
 		for (const b of open.slice(i + 1)) {
@@ -715,11 +726,18 @@ function loadHub(root, options = {}) {
 	});
 	const hubIssues = hubDocs(join(dataDir, "issues"), issueSchema);
 	const taskRefs = new Set(mainlines.flatMap((m) => m.tasks.map((t) => `${m.id}/${t.id}`)));
-	for (const issue of hubIssues) if (issue.plannedIn && !taskRefs.has(issue.plannedIn)) problems.push({
-		file: issue.file,
-		field: "plannedIn",
-		message: `task ${issue.plannedIn} does not exist`
-	});
+	for (const issue of hubIssues) {
+		if (issue.plannedIn && !taskRefs.has(issue.plannedIn)) problems.push({
+			file: issue.file,
+			field: "plannedIn",
+			message: `task ${issue.plannedIn} does not exist`
+		});
+		if (issue.status !== "closed" && !issue.archivedAt && !issue.labels?.length) warnings.push({
+			file: issue.file,
+			field: "labels",
+			message: `issue ${issue.id} is ${issue.status} but has no labels; add labels so it can be found by topic`
+		});
+	}
 	const findings = hubDocs(join(dataDir, "findings"), findingSchema);
 	const ops = [];
 	const opsPath = join(dataDir, "ops");
@@ -772,6 +790,11 @@ function loadHub(root, options = {}) {
 			message: `${o.tasks[0]} and ${o.tasks[1]} both touch ${pairs} in repo ${o.repo}, and neither depends on the other; coordinate before both run, or add a depends-on link`
 		});
 	}
+	for (const t of touchesWithoutRepo(mainlines)) warnings.push({
+		file: t.file,
+		field: "repo",
+		message: `${t.task} lists touches but no repo, so its paths are not compared with other tasks; add the repo they are relative to`
+	});
 	return {
 		root,
 		config,
@@ -1093,7 +1116,8 @@ function createIssue(root, input) {
 			title: input.title,
 			status: "open",
 			created: today(),
-			...input.origin ? { origin: input.origin } : {}
+			...input.origin ? { origin: input.origin } : {},
+			...input.labels?.length ? { labels: input.labels } : {}
 		}, "issue");
 		const file = join(dir, `${id}-${input.slug}.md`);
 		writeAtomic(file, frontMatterText(issue, ISSUE_BODY));
@@ -1519,9 +1543,11 @@ function requireServes(root, serves) {
 	}
 }
 const isOpen$1 = (a) => a.status === "todo" || a.status === "doing";
+const isCarried$1 = (a) => isOpen$1(a) || a.status === "blocked";
 /**
 * The previous session's unfinished actions, numbered after `existing`, with the previous session marked
-* handed-off. Each carried action is dropped in the previous session with a note naming its new reference,
+* handed-off. Blocked actions go along with their `blockedBy`, since the wait is still on and whoever is
+* waited for keeps seeing it. Each carried action is dropped in the previous session with a note naming its new reference,
 * so the work stays open in one place only and the old session still shows where it went. Runs inside the
 * caller's lock.
 */
@@ -1532,7 +1558,7 @@ function takeUnfinished(root, from, to, existing) {
 	const carried = [];
 	const at = nowMinute();
 	const left = previous.actions.map((a) => {
-		if (!isOpen$1(a)) return a;
+		if (!isCarried$1(a)) return a;
 		const id = nextId("a", ids);
 		ids.push(id);
 		carried.push({
@@ -1540,8 +1566,9 @@ function takeUnfinished(root, from, to, existing) {
 			id
 		});
 		const handedOff = handedOffNote(`${to}#${id}`);
+		const { blockedBy: _moved, ...rest } = a;
 		return {
-			...a,
+			...rest,
 			status: "dropped",
 			note: a.note ? `${a.note}; ${handedOff}` : handedOff,
 			doneAt: at
@@ -1617,7 +1644,7 @@ function handoffSession(root, id, from) {
 		if (session.handoffFrom && session.handoffFrom !== from) throw new WriteError(`session ${id} already took over from ${session.handoffFrom}`);
 		const open = session.actions.filter(isOpen$1);
 		if (open.length > 0) throw new WriteError(`session ${id} has unfinished actions (${open.map((a) => a.id).join(", ")}); finish or drop them before taking over from ${from}`);
-		if (!readYaml(requireSession(root, from), sessionSchema).data.actions.some(isOpen$1)) throw new WriteError(`session ${from} has no unfinished actions to take over`);
+		if (!readYaml(requireSession(root, from), sessionSchema).data.actions.some(isCarried$1)) throw new WriteError(`session ${from} has no unfinished actions to take over`);
 		const carried = takeUnfinished(root, from, id, session.actions.map((a) => a.id));
 		const next = validate(sessionSchema, {
 			...session,
@@ -1638,6 +1665,13 @@ function setSessionInfo(root, id, info) {
 		for (const [key, value] of Object.entries(info)) if (value !== void 0 && value !== null && value !== "") s[key] = value;
 	});
 }
+/** Remember the digest of what the last turn reminder listed in full; null forgets it, so the next reminder lists everything again. */
+function setReminderDigest(root, id, digest) {
+	mutateYaml(root, requireSession(root, id), sessionSchema, (s) => {
+		if (digest === null) delete s.reminderDigest;
+		else s.reminderDigest = digest;
+	});
+}
 function setSessionStatus(root, id, status) {
 	const value = requireOneOf(status, SESSION_STATUS, "session status");
 	return mutateYaml(root, requireSession(root, id), sessionSchema, (s) => {
@@ -1734,6 +1768,8 @@ function updateAction(root, ref, patch) {
 		const index = s.actions.findIndex((a) => a.id === action);
 		if (index < 0) throw new WriteError(`action ${ref} not found`);
 		const [current] = s.actions.splice(index, 1);
+		const movedTo = HANDED_OFF.exec(current.note ?? "")?.[1];
+		if (movedTo && current.status === "dropped" && status !== void 0 && status !== "dropped") throw new WriteError(`${ref} was handed off to ${movedTo}, and references to ${ref} follow its note only while it stays dropped; change ${movedTo} instead`);
 		const handedTo = patch.note ? HANDED_OFF.exec(current.note ?? "")?.[1] : void 0;
 		if (handedTo) throw new WriteError(`${ref} was handed off to ${handedTo}, and references to ${ref} follow its note there, so the note stays as it is; add the note to ${handedTo} instead`);
 		const next = {
@@ -1834,6 +1870,8 @@ function queueWarnings(root, session, cli) {
 }
 const current = (session) => session.actions.find((a) => a.status === "doing");
 const isOpen = (a) => a.status === "todo" || a.status === "doing";
+/** What a handoff takes over: open actions and blocked ones, which are still unfinished. */
+const isCarried = (a) => isOpen(a) || a.status === "blocked";
 /** A blocked action and what it waits for: the reason, the other party and the condition, as `action set --status blocked` recorded them. */
 function waitingLine(a) {
 	const block = a.blockedBy;
@@ -1925,14 +1963,32 @@ function duplicateClaimLines(root, sessionId, actionId) {
 * over into this one. Subagent sessions are left out: their work returns to the session that delegated it.
 */
 function handoffLines(root, session, cli) {
-	const others = loadSessions(root).sessions.filter((s) => s.id !== session.id && !s.delegatedFrom && !s.archivedAt && (s.status === "active" || s.status === "paused") && s.actions.some(isOpen));
+	const others = loadSessions(root).sessions.filter((s) => s.id !== session.id && !s.delegatedFrom && !s.archivedAt && (s.status === "active" || s.status === "paused") && s.actions.some(isCarried));
 	if (others.length === 0) return [];
-	return [`其他會話還有沒做完的行動。要接續的是其中一場已經停下的工作時，先用 ${cli} session handoff <會話> 把它的行動接進這場會話，再開始做：`, ...others.map((s) => `- ${s.id}${mayBeRunning(root, s) ? "（15 分鐘內還有寫入對話紀錄，可能還在執行，不要接手）" : ""}：${s.actions.filter(isOpen).map((a) => `${a.id} ${a.do}（${a.status}，服務 ${a.serves.join("、") || "未指定"}）`).join("；")}`)];
+	return [`其他會話還有沒做完的行動。要接續的是其中一場已經停下的工作時，先用 ${cli} session handoff <會話> 把它的行動接進這場會話，再開始做：`, ...others.map((s) => `- ${s.id}${mayBeRunning(root, s) ? "（15 分鐘內還有寫入對話紀錄，可能還在執行，不要接手）" : ""}：${s.actions.filter(isCarried).map((a) => `${a.id} ${a.do}（${a.status}，服務 ${a.serves.join("、") || "未指定"}）`).join("；")}`)];
 }
 const servedLine = (root, action) => action.serves.map((ref) => {
 	const s = describe(root, ref);
 	return s ? `${ref} ${s.text}（${s.where}）` : `${ref}（找不到這個項目或條件）`;
 }).join("；") || "沒有指定服務的 checklist 項目或解決條件";
+/**
+* Lines for each pair of overlapping touches that involves a mainline an action in progress serves: the other
+* mainline and task, and the paths they share. Empty when the session serves nothing that overlaps.
+*/
+function overlapLines(root, session) {
+	const mine = new Set(session.actions.filter((a) => a.status === "doing").flatMap((a) => a.serves.map((ref) => parseRef(ref))).flatMap((parsed) => parsed && "mainline" in parsed ? [parsed.mainline] : []));
+	if (mine.size === 0) return [];
+	const hub = loadHub(root, { remotes: false });
+	const lines = [];
+	for (const o of touchOverlaps(hub.mainlines, dependencyGraph(hub).edges)) {
+		const [own, other] = mine.has(o.tasks[0].split("/")[0]) ? [0, 1] : mine.has(o.tasks[1].split("/")[0]) ? [1, 0] : [-1, -1];
+		if (own < 0) continue;
+		const paths = o.paths.map(([a, b]) => own === 0 ? [a, b] : [b, a]).map(([a, b]) => a === b ? a : `${a} ~ ${b}`).join("、");
+		const title = hub.mainlines.find((m) => m.id === o.tasks[other].split("/")[0])?.title;
+		lines.push(`- ${o.tasks[own]} 和 ${o.tasks[other]}${title ? `（${title}）` : ""} 都會動到 ${paths}（倉庫 ${o.repo}），兩邊沒有 depends-on`);
+	}
+	return lines;
+}
 /** Full briefing for the start of a session, after resuming, clearing or compacting. */
 function sessionBriefing(root, session, options) {
 	const { cli } = options;
@@ -1957,13 +2013,18 @@ function sessionBriefing(root, session, options) {
 		if (blocked.length > 0) lines.push(`等外部條件：${blocked.map(waitingLine).join("；")}`);
 	}
 	lines.push(...waiterLines(root, session));
+	const overlaps = overlapLines(root, session);
+	if (overlaps.length > 0) lines.push("目前行動服務的主脈絡和其他進行中的主脈絡預計動到同樣的路徑，開始改之前先和對方協調，或加 depends-on：", ...overlaps);
 	if (!session.actions.some(isOpen)) lines.push(...handoffLines(root, session, cli));
 	const warnings = queueWarnings(root, session, cli);
 	if (warnings.length > 0) lines.push("需要處理：", ...warnings.map((w) => `- ${w}`));
 	lines.push("工作方式：", `- 開始一件新工作前，先列進佇列：${cli} action add "<做法>" --serves <m/t#c>。主脈絡還沒拆任務時（查核與規劃階段），--serves 指向解決條件 <m#r>。`, `- 開始做標 doing，做完標 done：${cli} action set <a編號> --status doing。`, `- 勾選 checklist 要附證據：${cli} item check <m/t#c> --evidence <commit、檔案:行號或指令輸出>。`, `- 內容直接寫進檔案：意圖或需求寫進 mainline.md 的內文，任務的目標與完成定義寫進 task.md，選擇寫成決策（${cli} new decision <m> <slug> --title <標題> 建檔後再寫內文）。`, `- 改完 .mainflow/ 的檔案跑 ${cli} check，把它列出的問題修到沒有。`, "- 用完其他 skill 或子流程後，回到上面的目前行動再繼續。", "- 要開主脈絡、拆任務、記決策、延後或收尾時，用 mainflow skill，它依序帶過並告訴你資訊該寫在哪裡。");
 	return lines.join("\n");
 }
-/** One or two lines for every user turn; null when the session has no actions and the hub has no open mainline. */
+/**
+* One or two lines for every user turn; null when the session has no actions and the hub has no open mainline.
+* Records a digest of the grants, waits and warnings it lists in the session file, only when the digest changes.
+*/
 function turnReminder(root, session, options) {
 	if (session.actions.length === 0) return openMainlines(root).length > 0 ? `[mainflow] ${session.id} 還沒有行動。這一輪要推進主脈絡時，先用 ${options.cli} action add 列出行動並標為 doing，或用 ${options.cli} session handoff <會話> 接手上一場沒做完的行動，再開始做。回覆結尾的標頭只看這場會話進行中的行動。` : null;
 	const doing = current(session);
@@ -1973,13 +2034,28 @@ function turnReminder(root, session, options) {
 	const header = headerLine(session);
 	const marker = header ? [`- 這一輪最後一則回覆的最後一行寫「${header}」，回覆範例等其他內容都放在它前面。有顯示 hook 時，它會換成標題與連結。`] : [];
 	const grants = grantLines(root, session);
-	const granted = grants.length > 0 ? ["- 目前行動服務的主脈絡預先授權了這些動作：", ...grants.map((g) => `  ${g}`)] : [];
+	const waiters = waiterLines(root, session);
+	const warnings = queueWarnings(root, session, options.cli);
+	const digest = contentHash(JSON.stringify([
+		doing?.id ?? null,
+		grants,
+		waiters,
+		warnings
+	]));
+	const repeated = session.reminderDigest === digest;
+	if (!repeated && (session.reminderDigest !== void 0 || grants.length + waiters.length + warnings.length > 0) && readSession(root, session.id)) try {
+		setReminderDigest(root, session.id, digest);
+	} catch {}
+	const once = (lines, summary, full) => lines.length === 0 ? [] : repeated ? [summary] : full;
+	const granted = once(grants, `- 預先授權同上一輪，共 ${grants.length} 條。`, ["- 目前行動服務的主脈絡預先授權了這些動作：", ...grants.map((g) => `  ${g}`)]);
+	const waiting = once(waiters, `- 等待行同上一輪，共 ${waiters.length} 條。`, waiters.map((w) => `- ${w}`));
+	const warned = once(warnings, `- 佇列提醒同上一輪，共 ${warnings.length} 條。`, warnings.map((w) => `- ${w}`));
 	return [
 		head,
-		...waiterLines(root, session).map((w) => `- ${w}`),
+		...waiting,
 		...granted,
 		...marker,
-		...queueWarnings(root, session, options.cli).map((w) => `- ${w}`)
+		...warned
 	].join("\n");
 }
 //#endregion
@@ -2203,7 +2279,7 @@ function setCriterion(root, refInput, done, evidence, expectedVersion) {
 	return mutateFrontMatter(root, mainlineFile(root, ref.mainline), mainlineSchema, (m) => {
 		const criterion = m.criteria.find((c) => c.id === ref.criterion);
 		if (!criterion) throw new WriteError(`criterion ${refInput} not found`);
-		setListItem(criterion, done, evidence);
+		setListItem(criterion, done, evidence, `${refInput} is dropped; remove dropped and supersededBy in ${MAINLINE_FILE} to bring it back before checking it`);
 	}, expectedVersion);
 }
 /** Rewrite a criterion's text or doneWhen, leaving done and evidence as they are. */
@@ -2217,14 +2293,17 @@ function setCriterionText(root, refInput, patch, expectedVersion) {
 		if (patch.doneWhen !== void 0) criterion.doneWhen = patch.doneWhen;
 	}, expectedVersion);
 }
-/** Check or uncheck a criterion or checklist item; checking clears a drop. */
-function setListItem(item, done, evidence) {
+/**
+* Check or uncheck a criterion or checklist item. A dropped item cannot be checked, because a drop is a
+* ruling that the item is no longer needed; `droppedHint` says how to bring it back. Neither direction
+* touches dropped or supersededBy.
+*/
+function setListItem(item, done, evidence, droppedHint) {
+	if (done && item.dropped) throw new WriteError(droppedHint);
 	item.done = done;
 	if (done) {
 		item.evidence = evidence;
 		item.doneAt = today();
-		delete item.dropped;
-		delete item.supersededBy;
 	} else {
 		delete item.evidence;
 		delete item.doneAt;
@@ -2299,7 +2378,7 @@ function setChecklistItem(root, refInput, done, evidence, expectedVersion) {
 	return mutateFrontMatter(root, taskFile(root, ref.mainline, ref.task), taskSchema, (t) => {
 		const item = t.checklist.find((c) => c.id === ref.item);
 		if (!item) throw new WriteError(`checklist item ${refInput} not found`);
-		setListItem(item, done, evidence);
+		setListItem(item, done, evidence, `${refInput} is dropped; run item undrop ${refInput} to bring it back before checking it`);
 	}, expectedVersion);
 }
 /** Mark an item as no longer needed, naming what replaced it when something did. */
@@ -2314,6 +2393,20 @@ function dropChecklistItem(root, refInput, input = {}, expectedVersion) {
 		if (input.note) item.note = input.note;
 	}, expectedVersion);
 }
+/** Bring a dropped item back as an open one: clears dropped and supersededBy, keeps the note. */
+function undropChecklistItem(root, refInput, expectedVersion) {
+	const ref = requireRef(refInput, "checklistItem");
+	return mutateFrontMatter(root, taskFile(root, ref.mainline, ref.task), taskSchema, (t) => {
+		const item = t.checklist.find((c) => c.id === ref.item);
+		if (!item) throw new WriteError(`checklist item ${refInput} not found`);
+		if (!item.dropped) throw new WriteError(`${refInput} is not dropped`);
+		delete item.dropped;
+		delete item.supersededBy;
+		item.done = false;
+		delete item.evidence;
+		delete item.doneAt;
+	}, expectedVersion);
+}
 function createDecision(root, mainline, input) {
 	requireRef(mainline, "mainline");
 	requireSlug(input.slug);
@@ -3172,4 +3265,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { createFinding as $, duplicateClaimLines as A, setSessionStatus as B, setCriterion as C, supersedeDecision as D, setMainlineTitle as E, handoffSession as F, grantScope as G, startSession as H, loadSessions as I, endsWithMarker as J, matchGrants as K, readSession as L, turnReminder as M, addAction as N, updateTask as O, ensureSession as P, closeIssue as Q, setSessionArchived as R, setChecklistItem as S, setMainlineStatus as T, transcriptPath as U, settleSession as V, updateAction as W, mayDecorate as X, headerLine as Y, appendOps as Z, createMainline as _, DATA_DIR as _t, openInApp as a, setIssueArchived as at, initHub as b, worktreesOf as bt, syncHost as c, dependencyGraph as ct, ARCHIVE_KINDS as d, refIndex as dt, createIssue as et, setArchivedMany as f, MAINLINE_FILE as ft, createDecision as g, readYaml as gt, addRepo as h, WriteError as ht, hostName as i, setFindingStatus as it, sessionBriefing as j, untilState as k, migrateHub as l, mainlineEdges as lt, addHub as m, ConflictError as mt, DEFAULT_UI_PORT as n, reopenIssue as nt, removeHostLink as o, HubError as ot, acceptDecision as p, TASK_FILE as pt, decorateReply as q, caddySites as r, setFindingArchived as rt, siteBlock as s, loadHub as st, APP_BUNDLE_ID as t, planIssue as tt, retroReport as u, linksInto as ut, createTask as v, currentBranch as vt, setCriterionText as w, setArchived as x, dropChecklistItem as y, findHubRoot as yt, setSessionInfo as z };
+export { appendOps as $, untilState as A, setSessionArchived as B, setCriterion as C, supersedeDecision as D, setMainlineTitle as E, ensureSession as F, transcriptPath as G, setSessionStatus as H, handoffSession as I, matchGrants as J, updateAction as K, loadSessions as L, sessionBriefing as M, turnReminder as N, undropChecklistItem as O, addAction as P, mayDecorate as Q, readSession as R, setChecklistItem as S, worktreesOf as St, setMainlineStatus as T, settleSession as U, setSessionInfo as V, startSession as W, endsWithMarker as X, decorateReply as Y, headerLine as Z, createMainline as _, WriteError as _t, openInApp as a, setFindingArchived as at, initHub as b, currentBranch as bt, syncHost as c, HubError as ct, ARCHIVE_KINDS as d, mainlineEdges as dt, closeIssue as et, setArchivedMany as f, linksInto as ft, createDecision as g, ConflictError as gt, addRepo as h, TASK_FILE as ht, hostName as i, reopenIssue as it, duplicateClaimLines as j, updateTask as k, migrateHub as l, loadHub as lt, addHub as m, MAINLINE_FILE as mt, DEFAULT_UI_PORT as n, createIssue as nt, removeHostLink as o, setFindingStatus as ot, acceptDecision as p, refIndex as pt, grantScope as q, caddySites as r, planIssue as rt, siteBlock as s, setIssueArchived as st, APP_BUNDLE_ID as t, createFinding as tt, retroReport as u, dependencyGraph as ut, createTask as v, readYaml as vt, setCriterionText as w, setArchived as x, findHubRoot as xt, dropChecklistItem as y, DATA_DIR as yt, setReminderDigest as z };

package/dist/host.js

@@ -1,2 +1,2 @@
-import { a as openInApp, c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, r as caddySites, s as siteBlock, t as APP_BUNDLE_ID } from "./host-sSWrUJeC.js";
+import { a as openInApp, c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, r as caddySites, s as siteBlock, t as APP_BUNDLE_ID } from "./host-CeN3dvXg.js";
 export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, removeHostLink, siteBlock, syncHost };

package/dist/{launch-1i4OAsD6.js → launch-BKKoCyTj.js}

@@ -1,4 +1,4 @@
-import { _t as DATA_DIR, c as syncHost, ht as WriteError, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink } from "./host-sSWrUJeC.js";
+import { _t as WriteError, c as syncHost, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, yt as DATA_DIR } from "./host-CeN3dvXg.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -176,7 +176,7 @@ async function launchUi(root, hub, configured, options) {
 	}
 	let server;
 	if (!reuse) {
-		const { serveUi } = await import("./ui-DcBLvgqY.js");
+		const { serveUi } = await import("./ui-D_9x6XNs.js");
 		server = await serveUi(root, choice.port);
 		writeUiRecord(root, {
 			port: choice.port,

package/dist/launch.js

@@ -1,2 +1,2 @@
-import { a as portCandidates, c as watchHubGone, i as networkProbe, n as choosePort, o as readUiRecord, r as launchUi, s as startUiInBackground, t as PORT_SPAN } from "./launch-1i4OAsD6.js";
+import { a as portCandidates, c as watchHubGone, i as networkProbe, n as choosePort, o as readUiRecord, r as launchUi, s as startUiInBackground, t as PORT_SPAN } from "./launch-BKKoCyTj.js";
 export { PORT_SPAN, choosePort, launchUi, networkProbe, portCandidates, readUiRecord, startUiInBackground, watchHubGone };

package/dist/{ui-DcBLvgqY.js → ui-D_9x6XNs.js}

@@ -1,6 +1,6 @@
-import { C as setCriterion, E as setMainlineTitle, I as loadSessions, L as readSession, O as updateTask, R as setSessionArchived, S as setChecklistItem, T as setMainlineStatus, U as transcriptPath, _t as DATA_DIR, a as openInApp, at as setIssueArchived, ct as dependencyGraph, d as ARCHIVE_KINDS, dt as refIndex, f as setArchivedMany, ht as WriteError, lt as mainlineEdges, mt as ConflictError, rt as setFindingArchived, st as loadHub, ut as linksInto, x as setArchived } from "./host-sSWrUJeC.js";
+import { B as setSessionArchived, C as setCriterion, E as setMainlineTitle, G as transcriptPath, L as loadSessions, R as readSession, S as setChecklistItem, T as setMainlineStatus, _t as WriteError, a as openInApp, at as setFindingArchived, d as ARCHIVE_KINDS, dt as mainlineEdges, f as setArchivedMany, ft as linksInto, gt as ConflictError, k as updateTask, lt as loadHub, pt as refIndex, st as setIssueArchived, ut as dependencyGraph, x as setArchived, yt as DATA_DIR } from "./host-CeN3dvXg.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { l as CLI_VERSION } from "./launch-1i4OAsD6.js";
+import { l as CLI_VERSION } from "./launch-BKKoCyTj.js";
 import { createRequire } from "node:module";
 import { closeSync, existsSync, openSync, readFileSync, readSync, statSync, watch } from "node:fs";
 import { basename, dirname, extname, join, normalize, relative, sep } from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mainflow",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "本機多 AI 協作的主脈絡任務管理：CLI 與介面",
   "license": "MIT",
   "type": "module",