mainflow 0.11.2 → 0.13.0

package/dist/{host-C3MyDGB_.js → host-daQGe7no.js}

@@ -1,4 +1,4 @@
-import { A as mainlineSchema, C as TASK_SECTIONS, D as findingSchema, E as decisionSchema, F as refMainline, I as sessionSchema, L as taskSchema, M as parseOpsLine, N as parseRef, O as formatOpsEntry, P as refExample, S as TASK_REQUIRED_SECTIONS, T as configSchema, b as SESSION_STATUS, c as FINDING_STATUS, d as ISSUE_SECTIONS, g as MERGE_STATES, h as MAINLINE_STATUS, i as DECISION_SECTIONS, j as opsEntrySchema, k as issueSchema, m as MAINLINE_SECTIONS, n as CLOSED_STATUS, o as DEFAULT_CATEGORIES, r as DECIDERS, s as FINDING_SECTIONS, t as CHECKLIST_REF, v as REF_EXAMPLES, w as WORK_STATUS, x as SLUG, y as RESERVED_HUB_NAMES } from "./dist-D2NK-QQP.js";
+import { A as mainlineSchema, C as TASK_SECTIONS, D as findingSchema, E as decisionSchema, F as refMainline, I as sessionSchema, L as taskSchema, M as parseOpsLine, N as parseRef, O as formatOpsEntry, P as refExample, R as waitingForRef, S as TASK_REQUIRED_SECTIONS, T as configSchema, b as SESSION_STATUS, c as FINDING_STATUS, d as ISSUE_SECTIONS, g as MERGE_STATES, h as MAINLINE_STATUS, i as DECISION_SECTIONS, j as opsEntrySchema, k as issueSchema, m as MAINLINE_SECTIONS, n as CLOSED_STATUS, o as DEFAULT_CATEGORIES, r as DECIDERS, s as FINDING_SECTIONS, t as CHECKLIST_REF, v as REF_EXAMPLES, w as WORK_STATUS, x as SLUG, y as RESERVED_HUB_NAMES } from "./dist-BQmXEfAf.js";
 import { appendFileSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync, writeSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -32,10 +32,11 @@ function currentBranch(cwd) {
 }
 /**
 * The hub for `cwd`: the first directory upwards holding `.mainflow/config.yaml`, except that a linked
-* worktree's checkout of a hub resolves to the same hub in the main working tree. A worktree is another
-* checkout of the same repository, so without this every worktree would write its own copy of the hub and
-* the copies would conflict on merge. A different hub nested inside a worktree (a scratch hub under tmp/,
-* say) has no counterpart in the main tree and stays as found.
+* worktree's checkout of a hub at the repository root resolves to the same hub in the main working tree.
+* A worktree is another checkout of the same repository, so without this every worktree would write its
+* own copy of the hub and the copies would conflict on merge. A hub below the root (a sample hub under
+* examples/, a scratch hub under tmp/) stays as found: it is data the worktree's own branch owns, and
+* mapping it would let tests and migrations in the worktree write the main tree's copy.
 */
 function findHubRoot(cwd) {
 	let found = null;
@@ -48,8 +49,8 @@ function findHubRoot(cwd) {
 	}
 	const trees = worktreesOf(cwd);
 	if (!trees || trees.main === trees.current) return found;
-	const counterpart = join(trees.main, relative(trees.current, found ?? trees.current));
-	return isHub(counterpart) ? counterpart : found;
+	if (found && found !== trees.current) return found;
+	return isHub(trees.main) ? trees.main : found;
 }
 function subdirs(dir) {
 	if (!existsSync(dir)) return [];
@@ -311,6 +312,113 @@ function linksInto(hub, hubName) {
 	return out;
 }
 //#endregion
+//#region ../core/dist/deps.js
+const MET = /* @__PURE__ */ new Set([
+	"done",
+	"closed",
+	"accepted",
+	"superseded",
+	"obsolete"
+]);
+const depState = (target) => !target ? "unknown" : MET.has(target.status) ? "met" : target.status === "dropped" ? "dropped" : "pending";
+function dependencyGraph(hub) {
+	const own = refIndex(hub);
+	const others = new Map((hub.remotes ?? []).flatMap((r) => r.hub ? [[r.name, refIndex(r.hub)]] : []));
+	/** A reference as this hub writes it: this hub's own prefix is dropped, another hub's is kept. */
+	const normal = (ref) => parseRef(ref)?.hub === hub.config.hub ? ref.slice(ref.indexOf(":") + 1) : ref;
+	const target = (ref) => {
+		const hubName = parseRef(ref)?.hub;
+		return hubName === void 0 ? own.get(ref) : others.get(hubName)?.get(ref.slice(ref.indexOf(":") + 1));
+	};
+	const edges = [];
+	const edge = (from, to, source, extra) => edges.push({
+		from,
+		to,
+		source,
+		state: depState(target(to)),
+		...extra
+	});
+	const links = (from, file, list) => list?.forEach((l, i) => l.rel === "depends-on" && edge(from, normal(l.to), "link", {
+		file,
+		field: `links.${i}.to`,
+		...l.note ? { note: l.note } : {}
+	}));
+	for (const m of hub.mainlines) {
+		links(m.id, m.file, m.links);
+		for (const d of m.decisions) links(`${m.id}/${d.id}`, d.file, d.links);
+		for (const t of m.tasks) {
+			links(`${m.id}/${t.id}`, t.file, t.links);
+			t.dependsOn?.forEach((dep, i) => edge(`${m.id}/${t.id}`, `${m.id}/${dep}`, "task", {
+				file: t.file,
+				field: `dependsOn.${i}`
+			}));
+		}
+	}
+	for (const d of [...hub.issues, ...hub.findings]) links(d.id, d.file, d.links);
+	for (const remote of hub.remotes ?? []) {
+		if (!remote.hub) continue;
+		for (const { to, link } of linksInto(remote.hub, hub.config.hub)) if (link.rel === "depends-on") edge(`${remote.name}:${link.from}`, to, "link", link.note ? { note: link.note } : {});
+	}
+	return {
+		edges,
+		cycles: findCycles(edges)
+	};
+}
+/** Cycles among this hub's own documents, each once, starting from its smallest reference. */
+function findCycles(edges) {
+	const next = /* @__PURE__ */ new Map();
+	for (const e of edges) if (!e.from.includes(":") && !e.to.includes(":")) next.set(e.from, [...next.get(e.from) ?? [], e.to]);
+	const state = /* @__PURE__ */ new Map();
+	const stack = [];
+	const cycles = /* @__PURE__ */ new Map();
+	const visit = (node) => {
+		state.set(node, "open");
+		stack.push(node);
+		for (const to of next.get(node) ?? []) if (state.get(to) === "open") {
+			const loop = stack.slice(stack.indexOf(to));
+			const start = loop.indexOf([...loop].sort()[0]);
+			const ordered = [...loop.slice(start), ...loop.slice(0, start)];
+			cycles.set(ordered.join(" "), [...ordered, ordered[0]]);
+		} else if (!state.has(to)) visit(to);
+		stack.pop();
+		state.set(node, "closed");
+	};
+	for (const node of [...next.keys()].sort()) if (!state.has(node)) visit(node);
+	return [...cycles.values()];
+}
+/** The mainline a reference sits in, keeping another hub's prefix; undefined for issues and findings. */
+function mainlineOf(ref) {
+	const parsed = parseRef(ref);
+	const m = parsed ? refMainline(parsed) : void 0;
+	return m && (parsed.hub ? `${parsed.hub}:${m}` : m);
+}
+/** Dependencies lifted to mainlines, for a map of how mainlines wait for one another. */
+function mainlineEdges(graph) {
+	const out = /* @__PURE__ */ new Map();
+	for (const e of graph.edges) {
+		const from = mainlineOf(e.from);
+		const to = mainlineOf(e.to);
+		if (!from || !to || from === to) continue;
+		const key = `${from} ${to}`;
+		const entry = out.get(key) ?? {
+			from,
+			to,
+			state: e.state,
+			edges: []
+		};
+		entry.edges.push(e);
+		const states = entry.edges.map((x) => x.state);
+		entry.state = [
+			"pending",
+			"unknown",
+			"dropped",
+			"met"
+		].find((s) => states.includes(s));
+		out.set(key, entry);
+	}
+	return [...out.values()];
+}
+//#endregion
 //#region ../core/dist/templates.js
 const body = (headings) => ["", ...headings.flatMap((h) => [`## ${h}`, ""])].join("\n");
 const MAINLINE_BODY = body(MAINLINE_SECTIONS);
@@ -553,6 +661,21 @@ function loadHub(root, options = {}) {
 		unreadable,
 		problems
 	});
+	const deps = dependencyGraph({
+		config,
+		mainlines,
+		issues: hubIssues,
+		findings,
+		remotes
+	});
+	for (const cycle of deps.cycles) {
+		const first = deps.edges.find((e) => e.from === cycle[0] && e.to === cycle[1]);
+		problems.push({
+			file: first.file,
+			field: first.field,
+			message: `dependency cycle ${cycle.join(" → ")}; drop one of these dependencies`
+		});
+	}
 	return {
 		root,
 		config,
@@ -686,6 +809,12 @@ function checkReferences(input) {
 		for (const t of m.tasks) {
 			add(t.file, t, `${m.id}/${t.id}`, m.id);
 			items(t.file, "checklist", t.checklist);
+			const waiting = waitingForRef(t.blockedBy?.waitingFor);
+			if (waiting) pending.push({
+				ref: waiting,
+				file: t.file,
+				field: "blockedBy.waitingFor"
+			});
 		}
 	}
 	for (const i of issues) add(i.file, i, i.id);
@@ -718,7 +847,7 @@ function checkReferences(input) {
 		});
 	}
 }
-const isOpen = (kind, status) => !CLOSED_STATUS[kind].includes(status);
+const isOpen$2 = (kind, status) => !CLOSED_STATUS[kind].includes(status);
 /**
 * What a reader without the conversation needs to pick the work up: every open task says what it is for
 * and when it is done, and every open criterion or item says what has to be true to check it. Closed
@@ -743,10 +872,10 @@ function contentGaps(mainline, tasks) {
 			});
 		});
 	};
-	const mainlineOpen = isOpen("mainline", mainline.status);
+	const mainlineOpen = isOpen$2("mainline", mainline.status);
 	list(mainline.file, "criteria", mainline.criteria, mainlineOpen);
 	for (const task of tasks) {
-		const open = mainlineOpen && isOpen("task", task.status);
+		const open = mainlineOpen && isOpen$2("task", task.status);
 		list(task.file, "checklist", task.checklist, open);
 		if (!open) continue;
 		for (const section of TASK_REQUIRED_SECTIONS) if (!sectionText(task.body, section)) gaps.push({
@@ -1010,82 +1139,6 @@ function decorateReply(text, context) {
 /** Cheap test for text that decorateReply could change, so a display hook can skip loading the hub. */
 const mayDecorate = (text) => /m\d{3}|[if]\d{3}|\.mainflow\/mainlines/.test(text) || endsWithMarker(text);
 //#endregion
-//#region ../core/dist/briefing.js
-function describe(root, ref) {
-	const parsed = parseRef(ref);
-	if (parsed?.kind !== "checklistItem") return null;
-	try {
-		const mainline = readFrontMatter(mainlineFile(root, parsed.mainline), mainlineSchema).data;
-		const task = readFrontMatter(taskFile(root, parsed.mainline, parsed.task), taskSchema).data;
-		const item = task.checklist.find((c) => c.id === parsed.item);
-		if (!item) return null;
-		return {
-			ref,
-			text: item.text,
-			checked: item.done,
-			where: `${mainline.id} ${mainline.title} › ${task.id} ${task.title}`
-		};
-	} catch {
-		return null;
-	}
-}
-/** Problems in a session's queue that the executor should fix before going on, each with the command that fixes it. */
-function queueWarnings(root, session, cli) {
-	const warnings = [];
-	const doing = session.actions.filter((a) => a.status === "doing");
-	if (doing.length > 1) warnings.push(`同時有 ${doing.length} 個進行中的行動（${doing.map((a) => a.id).join("、")}）。一次只推進一個，其餘改回 todo。`);
-	for (const action of doing) {
-		const served = action.serves.map((ref) => describe(root, ref));
-		if (served.some((s) => s === null)) warnings.push(`${action.id} 服務的項目有的已不存在，用 ${cli} action set ${action.id} --serves <m/t#c> 改正。`);
-		else if (served.length > 0 && served.every((s) => s.checked)) warnings.push(`${action.id} 服務的項目都已勾選。做完了就執行 ${cli} action set ${action.id} --status done。`);
-	}
-	const next = session.actions.find((a) => a.status === "todo");
-	if (doing.length === 0 && next) warnings.push(`下一個行動是 ${next.id}。開始前先執行 ${cli} action set ${next.id} --status doing。`);
-	return warnings;
-}
-const current = (session) => session.actions.find((a) => a.status === "doing");
-const servedLine = (root, action) => action.serves.map((ref) => {
-	const s = describe(root, ref);
-	return s ? `${ref} ${s.text}（${s.where}）` : `${ref}（找不到這個項目）`;
-}).join("；") || "沒有指定服務的 checklist 項目";
-/** Full briefing for the start of a session, after resuming, clearing or compacting. */
-function sessionBriefing(root, session, options) {
-	const { cli } = options;
-	const lines = [`[mainflow] 這場會話的 id 是 ${session.id}${options.envNote ? `（${options.envNote}）` : ""}。`];
-	const doing = current(session);
-	const upcoming = session.actions.filter((a) => a.status === "todo").slice(0, 3);
-	if (session.actions.length === 0) {
-		const active = loadHub(root).mainlines.filter((m) => !m.archivedAt && (m.status === "active" || m.status === "planning"));
-		lines.push("這場會話還沒有行動。");
-		if (active.length > 0) {
-			lines.push("進行中的主脈絡：");
-			for (const m of active) lines.push(`- ${m.id} ${m.title}`);
-			lines.push(`要推進其中一個時，先用 ${cli} status 與它的任務 checklist 決定要做什麼，再列出行動。`);
-		}
-	} else {
-		lines.push(doing ? `目前行動：${doing.id} ${doing.do}` : "目前沒有進行中的行動。");
-		if (doing) lines.push(`服務：${servedLine(root, doing)}`);
-		if (upcoming.length > 0) lines.push(`接下來：${upcoming.map((a) => `${a.id} ${a.do}`).join("、")}`);
-	}
-	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>。`, `- 開始做標 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 to anchor to. */
-function turnReminder(root, session, options) {
-	if (session.actions.length === 0) return null;
-	const doing = current(session);
-	const open = session.actions.filter((a) => a.status === "todo" || a.status === "doing");
-	const head = doing ? `[mainflow] 目前行動 ${doing.id} ${doing.do}，服務 ${doing.serves.join("、") || "（未指定）"}。這一輪的工作若不屬於它，先調整佇列再做。` : open.length === 0 ? `[mainflow] ${session.id} 的行動都已結束。繼續工作前先用 ${options.cli} action add 列出下一個行動。` : `[mainflow] ${session.id} 目前沒有進行中的行動。`;
-	const header = headerLine(session);
-	return [
-		head,
-		...header ? [`- 這一輪最後一則回覆的最後一行寫「${header}」，回覆範例等其他內容都放在它前面。有顯示 hook 時，它會換成標題與連結。`] : [],
-		...queueWarnings(root, session, options.cli).map((w) => `- ${w}`)
-	].join("\n");
-}
-//#endregion
 //#region ../core/dist/sessions.js
 const sessionsDir = (root) => join(root, DATA_DIR, "local", "sessions");
 const sessionFile = (root, id) => join(sessionsDir(root), `${id}.yaml`);
@@ -1162,6 +1215,29 @@ function requireServes(root, serves) {
 		if (!readFrontMatter(taskFile(root, parsed.mainline, parsed.task), taskSchema).data.checklist.some((c) => c.id === parsed.item)) throw new WriteError(`checklist item ${ref} not found`);
 	}
 }
+const isOpen$1 = (a) => a.status === "todo" || a.status === "doing";
+/**
+* The previous session's unfinished actions, numbered after `existing`, with the previous session marked
+* handed-off. Runs inside the caller's lock.
+*/
+function takeUnfinished(root, from, existing) {
+	const previousFile = requireSession(root, from);
+	const previous = readYaml(previousFile, sessionSchema).data;
+	const ids = [...existing];
+	const carried = previous.actions.filter(isOpen$1).map((a) => {
+		const id = nextId("a", ids);
+		ids.push(id);
+		return {
+			...a,
+			id
+		};
+	});
+	writeAtomic(previousFile, toYaml(validate(sessionSchema, {
+		...previous,
+		status: "handed-off"
+	}, previousFile)));
+	return carried;
+}
 /**
 * Start a session. Taking over from another session copies its unfinished actions into this one and marks
 * the other session handed-off, so the queue continues where it stopped.
@@ -1173,19 +1249,7 @@ function startSession(root, input) {
 		const file = sessionFile(root, id);
 		if (existsSync(file)) throw new WriteError(`session ${id} already exists`);
 		if (input.delegatedFrom) requireSession(root, input.delegatedFrom);
-		let carried = [];
-		if (input.handoffFrom) {
-			const previousFile = requireSession(root, input.handoffFrom);
-			const previous = readYaml(previousFile, sessionSchema).data;
-			carried = previous.actions.filter((a) => a.status === "todo" || a.status === "doing").map((a, i) => ({
-				...a,
-				id: `a${String(i + 1).padStart(3, "0")}`
-			}));
-			writeAtomic(previousFile, toYaml(validate(sessionSchema, {
-				...previous,
-				status: "handed-off"
-			}, previousFile)));
-		}
+		const carried = input.handoffFrom ? takeUnfinished(root, input.handoffFrom, []) : [];
 		const session = validate(sessionSchema, {
 			id,
 			agent: input.agent,
@@ -1223,6 +1287,32 @@ function ensureSession(root, input) {
 		created: false
 	};
 }
+/**
+* Take over another session's unfinished actions into a session that already exists, such as one a host hook
+* created when the conversation opened. The receiving session must have nothing unfinished of its own, so the
+* carried queue is not mixed into work already under way; its finished actions stay and the carried ones are
+* numbered after them.
+*/
+function handoffSession(root, id, from) {
+	if (id === from) throw new WriteError(`session ${id} cannot take over from itself`);
+	return withLock(root, () => {
+		const file = requireSession(root, id);
+		const session = readYaml(file, sessionSchema).data;
+		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`);
+		const carried = takeUnfinished(root, from, session.actions.map((a) => a.id));
+		const next = validate(sessionSchema, {
+			...session,
+			status: "active",
+			handoffFrom: from,
+			actions: [...session.actions, ...carried]
+		}, file);
+		writeAtomic(file, toYaml(next));
+		return next;
+	});
+}
 /** Where a session's transcript is on disk: a platform records an absolute path, a hub may record one relative to its root. */
 function transcriptPath(root, transcript) {
 	return isAbsolute(transcript) ? transcript : join(root, transcript);
@@ -1327,6 +1417,106 @@ function updateAction(root, ref, patch) {
 	return updated;
 }
 //#endregion
+//#region ../core/dist/briefing.js
+function describe(root, ref) {
+	const parsed = parseRef(ref);
+	if (parsed?.kind !== "checklistItem") return null;
+	try {
+		const mainline = readFrontMatter(mainlineFile(root, parsed.mainline), mainlineSchema).data;
+		const task = readFrontMatter(taskFile(root, parsed.mainline, parsed.task), taskSchema).data;
+		const item = task.checklist.find((c) => c.id === parsed.item);
+		if (!item) return null;
+		return {
+			ref,
+			text: item.text,
+			checked: item.done,
+			where: `${mainline.id} ${mainline.title} › ${task.id} ${task.title}`
+		};
+	} catch {
+		return null;
+	}
+}
+/** Problems in a session's queue that the executor should fix before going on, each with the command that fixes it. */
+function queueWarnings(root, session, cli) {
+	const warnings = [];
+	const doing = session.actions.filter((a) => a.status === "doing");
+	if (doing.length > 1) warnings.push(`同時有 ${doing.length} 個進行中的行動（${doing.map((a) => a.id).join("、")}）。一次只推進一個，其餘改回 todo。`);
+	for (const action of doing) {
+		const served = action.serves.map((ref) => describe(root, ref));
+		if (served.some((s) => s === null)) warnings.push(`${action.id} 服務的項目有的已不存在，用 ${cli} action set ${action.id} --serves <m/t#c> 改正。`);
+		else if (served.length > 0 && served.every((s) => s.checked)) warnings.push(`${action.id} 服務的項目都已勾選。做完了就執行 ${cli} action set ${action.id} --status done。`);
+	}
+	const next = session.actions.find((a) => a.status === "todo");
+	if (doing.length === 0 && next) warnings.push(`下一個行動是 ${next.id}。開始前先執行 ${cli} action set ${next.id} --status doing。`);
+	return warnings;
+}
+const current = (session) => session.actions.find((a) => a.status === "doing");
+const isOpen = (a) => a.status === "todo" || a.status === "doing";
+/** Mainlines a session could be pushing forward. */
+const openMainlines = (root) => loadHub(root).mainlines.filter((m) => !m.archivedAt && (m.status === "active" || m.status === "planning"));
+/** How recently a session's transcript must have been written for the session to count as possibly still running. */
+const RUNNING_WINDOW_MS = 9e5;
+/** Whether the session's transcript was written within the running window; false when no transcript is recorded or readable. */
+function mayBeRunning(root, session) {
+	if (!session.transcript) return false;
+	try {
+		return Date.now() - statSync(transcriptPath(root, session.transcript)).mtimeMs < RUNNING_WINDOW_MS;
+	} catch {
+		return false;
+	}
+}
+/**
+* Lines naming the other top-level sessions that still hold unfinished actions, with the command that takes them
+* 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));
+	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("；")}`)];
+}
+const servedLine = (root, action) => action.serves.map((ref) => {
+	const s = describe(root, ref);
+	return s ? `${ref} ${s.text}（${s.where}）` : `${ref}（找不到這個項目）`;
+}).join("；") || "沒有指定服務的 checklist 項目";
+/** Full briefing for the start of a session, after resuming, clearing or compacting. */
+function sessionBriefing(root, session, options) {
+	const { cli } = options;
+	const lines = [`[mainflow] 這場會話的 id 是 ${session.id}${options.envNote ? `（${options.envNote}）` : ""}。`];
+	const doing = current(session);
+	const upcoming = session.actions.filter((a) => a.status === "todo").slice(0, 3);
+	if (session.actions.length === 0) {
+		const active = openMainlines(root);
+		lines.push("這場會話還沒有行動。");
+		if (active.length > 0) {
+			lines.push("進行中的主脈絡：");
+			for (const m of active) lines.push(`- ${m.id} ${m.title}`);
+			lines.push(`要推進其中一個時，先用 ${cli} status 與它的任務 checklist 決定要做什麼，再列出行動。`);
+		}
+	} else {
+		lines.push(doing ? `目前行動：${doing.id} ${doing.do}` : "目前沒有進行中的行動。");
+		if (doing) lines.push(`服務：${servedLine(root, doing)}`);
+		if (upcoming.length > 0) lines.push(`接下來：${upcoming.map((a) => `${a.id} ${a.do}`).join("、")}`);
+	}
+	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>。`, `- 開始做標 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. */
+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);
+	const open = session.actions.filter((a) => a.status === "todo" || a.status === "doing");
+	const head = doing ? `[mainflow] 目前行動 ${doing.id} ${doing.do}，服務 ${doing.serves.join("、") || "（未指定）"}。這一輪的工作若不屬於它，先調整佇列再做。` : open.length === 0 ? `[mainflow] ${session.id} 的行動都已結束。繼續工作前先用 ${options.cli} action add 列出下一個行動。` : `[mainflow] ${session.id} 目前沒有進行中的行動。`;
+	const header = headerLine(session);
+	return [
+		head,
+		...header ? [`- 這一輪最後一則回覆的最後一行寫「${header}」，回覆範例等其他內容都放在它前面。有顯示 hook 時，它會換成標題與連結。`] : [],
+		...queueWarnings(root, session, options.cli).map((w) => `- ${w}`)
+	].join("\n");
+}
+//#endregion
 //#region ../core/dist/write.js
 function checkTaskLinks(root, mainline, task) {
 	if (task.repo && !(task.repo in readConfig(root).repos)) throw new WriteError(`repo "${task.repo}" is not listed in .mainflow/config.yaml; add it under repos first`);
@@ -1455,6 +1645,17 @@ function setCriterion(root, refInput, done, evidence, expectedVersion) {
 		setListItem(criterion, done, evidence);
 	}, expectedVersion);
 }
+/** Rewrite a criterion's text or doneWhen, leaving done and evidence as they are. */
+function setCriterionText(root, refInput, patch, expectedVersion) {
+	const ref = requireRef(refInput, "criterion");
+	if (patch.text === void 0 && patch.doneWhen === void 0) throw new WriteError(`${refInput} needs --text or --done-when, e.g. --text "CLI can create mainlines"`);
+	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`);
+		if (patch.text !== void 0) criterion.text = patch.text;
+		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) {
 	item.done = done;
@@ -1605,6 +1806,44 @@ function supersedeDecision(root, refInput, by, expectedVersion) {
 	}, expectedVersion);
 }
 //#endregion
+//#region ../core/dist/archive.js
+/** The entities that carry `archivedAt`; tasks and decisions follow their mainline instead. */
+const ARCHIVE_KINDS = [
+	"mainline",
+	"issue",
+	"finding",
+	"session"
+];
+const ARCHIVERS = {
+	mainline: setArchived,
+	issue: setIssueArchived,
+	finding: setFindingArchived,
+	session: setSessionArchived
+};
+/**
+* Archive or unarchive several entities of one kind. Each file is written on its own: one that fails, such
+* as an ID that no longer exists, is reported and the others still change, because a selection in the
+* interface can go stale while it is open.
+*/
+function setArchivedMany(root, kind, ids, archived) {
+	const archiver = ARCHIVERS[kind];
+	if (!archiver) throw new WriteError(`kind must be one of: ${ARCHIVE_KINDS.join(", ")}`);
+	const result = {
+		done: [],
+		failed: []
+	};
+	for (const id of new Set(ids)) try {
+		archiver(root, id, archived);
+		result.done.push(id);
+	} catch (error) {
+		result.failed.push({
+			id,
+			error: error instanceof Error ? error.message : String(error)
+		});
+	}
+	return result;
+}
+//#endregion
 //#region ../core/dist/migrate.js
 const drop = (o, ...keys) => keys.forEach((k) => delete o[k]);
 const dropNull = (o, ...keys) => keys.forEach((k) => o[k] === null && delete o[k]);
@@ -1888,4 +2127,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { linksInto as $, setSessionInfo as A, headerLine as B, supersedeDecision as C, loadSessions as D, ensureSession as E, updateAction as F, createIssue as G, appendOps as H, sessionBriefing as I, setFindingArchived as J, planIssue as K, turnReminder as L, settleSession as M, startSession as N, readSession as O, transcriptPath as P, loadHub as Q, decorateReply as R, setMainlineTitle as S, addAction as T, closeIssue as U, mayDecorate as V, createFinding as W, setIssueArchived as X, setFindingStatus as Y, HubError as Z, initHub as _, openInApp as a, DATA_DIR as at, setCriterion as b, syncHost as c, worktreesOf as ct, addHub as d, refIndex as et, addRepo as f, dropChecklistItem as g, createTask as h, hostName as i, WriteError as it, setSessionStatus as j, setSessionArchived as k, migrateHub as l, createMainline as m, DEFAULT_UI_PORT as n, TASK_FILE as nt, removeHostLink as o, currentBranch as ot, createDecision as p, reopenIssue as q, caddySites as r, ConflictError as rt, siteBlock as s, findHubRoot as st, APP_BUNDLE_ID as t, MAINLINE_FILE as tt, acceptDecision as u, setArchived as v, updateTask as w, setMainlineStatus as x, setChecklistItem as y, endsWithMarker as z };
+export { setFindingStatus as $, addAction as A, transcriptPath as B, setCriterionText as C, updateTask as D, supersedeDecision as E, setSessionArchived as F, mayDecorate as G, decorateReply as H, setSessionInfo as I, createFinding as J, appendOps as K, setSessionStatus as L, handoffSession as M, loadSessions as N, sessionBriefing as O, readSession as P, setFindingArchived as Q, settleSession as R, setCriterion as S, setMainlineTitle as T, endsWithMarker as U, updateAction as V, headerLine as W, planIssue as X, createIssue as Y, reopenIssue as Z, createTask as _, openInApp as a, linksInto as at, setArchived as b, syncHost as c, TASK_FILE as ct, setArchivedMany as d, DATA_DIR as dt, setIssueArchived as et, acceptDecision as f, currentBranch as ft, createMainline as g, createDecision as h, hostName as i, mainlineEdges as it, ensureSession as j, turnReminder as k, migrateHub as l, ConflictError as lt, addRepo as m, worktreesOf as mt, DEFAULT_UI_PORT as n, loadHub as nt, removeHostLink as o, refIndex as ot, addHub as p, findHubRoot as pt, closeIssue as q, caddySites as r, dependencyGraph as rt, siteBlock as s, MAINLINE_FILE as st, APP_BUNDLE_ID as t, HubError as tt, ARCHIVE_KINDS as u, WriteError as ut, dropChecklistItem as v, setMainlineStatus as w, setChecklistItem as x, initHub as y, startSession 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-C3MyDGB_.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-daQGe7no.js";
 export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, removeHostLink, siteBlock, syncHost };

package/dist/{launch-T0sXbTgT.js → launch-JK8l8BYu.js}

@@ -1,4 +1,4 @@
-import { at as DATA_DIR, c as syncHost, i as hostName, it as WriteError, n as DEFAULT_UI_PORT, o as removeHostLink } from "./host-C3MyDGB_.js";
+import { c as syncHost, dt as DATA_DIR, i as hostName, n as DEFAULT_UI_PORT, o as removeHostLink, ut as WriteError } from "./host-daQGe7no.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-BTLe6I--.js");
+		const { serveUi } = await import("./ui-BoBBdpZH.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-T0sXbTgT.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-JK8l8BYu.js";
 export { PORT_SPAN, choosePort, launchUi, networkProbe, portCandidates, readUiRecord, startUiInBackground, watchHubGone };

package/dist/{ui-BTLe6I--.js → ui-BoBBdpZH.js}

@@ -1,6 +1,6 @@
-import { $ as linksInto, D as loadSessions, J as setFindingArchived, O as readSession, P as transcriptPath, Q as loadHub, S as setMainlineTitle, X as setIssueArchived, a as openInApp, at as DATA_DIR, b as setCriterion, et as refIndex, it as WriteError, k as setSessionArchived, rt as ConflictError, v as setArchived, w as updateTask, x as setMainlineStatus, y as setChecklistItem } from "./host-C3MyDGB_.js";
+import { B as transcriptPath, D as updateTask, F as setSessionArchived, N as loadSessions, P as readSession, Q as setFindingArchived, S as setCriterion, T as setMainlineTitle, a as openInApp, at as linksInto, b as setArchived, d as setArchivedMany, dt as DATA_DIR, et as setIssueArchived, it as mainlineEdges, lt as ConflictError, nt as loadHub, ot as refIndex, rt as dependencyGraph, u as ARCHIVE_KINDS, ut as WriteError, w as setMainlineStatus, x as setChecklistItem } from "./host-daQGe7no.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { l as CLI_VERSION } from "./launch-T0sXbTgT.js";
+import { l as CLI_VERSION } from "./launch-JK8l8BYu.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";
@@ -226,7 +226,9 @@ function relationsView(hub) {
 	const own = refIndex(hub);
 	const indexes = new Map(hub.remotes.flatMap((r) => r.hub ? [[r.name, refIndex(r.hub)]] : []));
 	const targets = {};
-	for (const ref of prefixedRefs(hub)) {
+	const graph = dependencyGraph(hub);
+	const depRefs = graph.edges.flatMap((e) => [e.from, e.to]);
+	for (const ref of /* @__PURE__ */ new Set([...prefixedRefs(hub), ...depRefs.filter((r) => r.includes(":"))])) {
 		const colon = ref.indexOf(":");
 		const name = ref.slice(0, colon);
 		const found = name === hub.config.hub ? own.get(ref.slice(colon + 1)) : indexes.get(name)?.get(ref.slice(colon + 1));
@@ -255,7 +257,10 @@ function relationsView(hub) {
 			...r.unavailable ? { reason: r.unavailable } : {}
 		})),
 		targets,
-		backlinks
+		backlinks,
+		deps: graph.edges,
+		mainlineDeps: mainlineEdges(graph),
+		cycles: graph.cycles
 	};
 }
 const pick = (t) => t ? {
@@ -369,6 +374,11 @@ function createApp(root) {
 			problems
 		});
 	});
+	app.post("/api/archive", async (c) => {
+		const { kind, ids, archived } = await c.req.json();
+		if (!ARCHIVE_KINDS.includes(kind) || !Array.isArray(ids)) return c.json({ error: `kind must be one of ${ARCHIVE_KINDS.join(", ")} and ids a list` }, 400);
+		return c.json(setArchivedMany(root, kind, ids, archived));
+	});
 	app.post("/api/sessions/:id/archive", async (c) => {
 		const { archived } = await c.req.json();
 		return c.json(setSessionArchived(root, c.req.param("id"), archived));