mainflow 0.10.0 → 0.11.1

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { $ as MAINLINE_FILE, A as setSessionStatus, B as appendOps, C as updateTask, D as readSession, F as sessionBriefing, G as reopenIssue, H as createFinding, J as setIssueArchived, K as setFindingArchived, M as startSession, O as setSessionArchived, P as updateAction, S as supersedeDecision, U as createIssue, V as closeIssue, W as planIssue, X as loadHub, Y as HubError, _ as setArchived, at as findHubRoot, b as setMainlineStatus, c as migrateHub, d as addRepo, et as TASK_FILE, f as createDecision, g as initHub, h as dropChecklistItem, l as acceptDecision, m as createTask, nt as WriteError, p as createMainline, q as setFindingStatus, u as addHub, v as setChecklistItem, w as addAction, y as setCriterion } from "./host-BFGfpTDq.js";
+import { A as setSessionStatus, C as updateTask, D as readSession, F as sessionBriefing, G as planIssue, H as closeIssue, J as setFindingStatus, K as reopenIssue, M as startSession, O as setSessionArchived, P as updateAction, S as supersedeDecision, U as createFinding, V as appendOps, W as createIssue, X as HubError, Y as setIssueArchived, Z as loadHub, _ as setArchived, b as setMainlineStatus, c as migrateHub, d as addRepo, et as MAINLINE_FILE, f as createDecision, g as initHub, h as dropChecklistItem, l as acceptDecision, m as createTask, ot as findHubRoot, p as createMainline, q as setFindingArchived, rt as WriteError, tt as TASK_FILE, u as addHub, v as setChecklistItem, w as addAction, y as setCriterion } from "./host-ByGN9mGS.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { runHook } from "./hooks.js";
-import { c as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-D5uHpqkh.js";
+import { c as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-B9QrvwZQ.js";
 import { readFileSync, realpathSync } from "node:fs";
 import { join, relative } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/hooks.js

@@ -1,4 +1,4 @@
-import { A as setSessionStatus, D as readSession, F as sessionBriefing, I as turnReminder, L as decorateReply, R as endsWithMarker, T as ensureSession, X as loadHub, Y as HubError, at as findHubRoot, i as hostName, it as currentBranch, j as settleSession, k as setSessionInfo, ot as worktreesOf, rt as DATA_DIR, z as mayDecorate } from "./host-BFGfpTDq.js";
+import { A as setSessionStatus, B as mayDecorate, D as readSession, F as sessionBriefing, I as turnReminder, L as decorateReply, R as endsWithMarker, T as ensureSession, X as HubError, Z as loadHub, at as currentBranch, i as hostName, it as DATA_DIR, j as settleSession, k as setSessionInfo, ot as findHubRoot, st as worktreesOf, z as headerLine } from "./host-ByGN9mGS.js";
 import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 //#region src/hooks.ts
@@ -55,8 +55,9 @@ const settleOnEnd = (root, { payload }) => {
 /** How a hub's interface is linked from a reply: through its /open route, which shows the address in the app. */
 const openLink = (hub) => (path) => `https://${hostName(hub)}/open${path}`;
 /**
-* MessageDisplay: link the references in the lines about to be shown and expand a trailing end marker into the
-* current action line. Display only, so the model keeps reading what it wrote. Text with nothing to change
+* MessageDisplay: link the references in the lines about to be shown and expand the trailing header line into
+* the mainline › task › action its ids name, titles included, whatever state that action is in now. Display
+* only, so the model keeps reading what it wrote. Text with nothing to change
 * returns before the hub is loaded, because Claude Code holds every batch until the hook answers.
 */
 const displayReply = (root, { payload }) => {
@@ -75,18 +76,19 @@ const displayReply = (root, { payload }) => {
 	} });
 };
 /**
-* Stop: settle the session, then ask for the end marker when a session with an action in progress ended its
-* turn without one. Only the model knows which message closes a turn, so the marker is its to write; this makes
+* Stop: settle the session, then ask for the header line when a session with an action in progress ended its
+* turn without one. Only the model knows which message closes a turn, so the header is its to write; this makes
 * a forgotten one cost a single extra message. stop_hook_active stops it from asking twice in a row.
 */
 const settleAndCheckMarker = (root, context) => {
 	settleOnEnd(root, context);
 	const { payload } = context;
 	if (!payload.session_id || payload.stop_hook_active || endsWithMarker(payload.last_assistant_message ?? "")) return null;
-	if (!readSession(root, claudeCodeSessionId(payload.session_id))?.actions.some((a) => a.status === "doing")) return null;
+	const header = headerLine(readSession(root, claudeCodeSessionId(payload.session_id)));
+	if (!header) return null;
 	return JSON.stringify({ hookSpecificOutput: {
 		hookEventName: "Stop",
-		additionalContext: `[mainflow] 這一輪最後一則回覆沒有以單獨一行的 ▸ 結尾。請只回一則內容為 ▸ 的訊息，不加其他文字。`
+		additionalContext: `[mainflow] 這一輪最後一則回覆的最後一行不是標頭。請只回一則內容為「${header}」的訊息，不加其他文字。`
 	} });
 };
 const CLAUDE_CODE_EVENTS = {

package/dist/{host-BFGfpTDq.js → host-ByGN9mGS.js}

@@ -936,38 +936,76 @@ function linkMentions(text, context) {
 		return path ? `[${ref}](${context.link(path)})` : all;
 	})).join("");
 }
-/** `▸ m001 title › t001 title › a001 do`, each id linked; null when the session has no action in progress. */
-function currentActionLine(context) {
-	const action = context.session?.actions.find((a) => a.status === "doing");
-	if (!context.session || !action) return null;
+/** `▸ m001 title › t001 title › a001 do` for the given ids, each linked; titles come from the hub and the session. */
+function headerLineFor(ids, context) {
 	const index = refIndex(context.hub);
 	const parts = [];
-	const served = action.serves.map((s) => parseRef(s)).find((r) => r !== null);
-	if (served && "mainline" in served) {
-		const mainline = index.get(served.mainline);
-		parts.push(`[${served.mainline}](${context.link(`/mainlines/${served.mainline}`)}) ${mainline?.title ?? ""}`.trimEnd());
-		if ("task" in served) {
-			const ref = `${served.mainline}/${served.task}`;
-			parts.push(`[${served.task}](${context.link(`/mainlines/${served.mainline}/tasks/${served.task}`)}) ${index.get(ref)?.title ?? ""}`.trimEnd());
+	if (ids.mainline) {
+		parts.push(`[${ids.mainline}](${context.link(`/mainlines/${ids.mainline}`)}) ${index.get(ids.mainline)?.title ?? ""}`.trimEnd());
+		if (ids.task) {
+			const ref = `${ids.mainline}/${ids.task}`;
+			parts.push(`[${ids.task}](${context.link(`/mainlines/${ids.mainline}/tasks/${ids.task}`)}) ${index.get(ref)?.title ?? ""}`.trimEnd());
 		}
 	}
-	parts.push(`[${action.id}](${context.link(sessionPath(context.session.id))}) ${action.do}`);
+	const action = context.session?.actions.find((a) => a.id === ids.action);
+	parts.push(context.session ? `[${ids.action}](${context.link(sessionPath(context.session.id))}) ${action?.do ?? ""}`.trimEnd() : ids.action);
 	return `▸ ${parts.join(" › ")}`;
 }
-/** Whether a message ends with the marker line, as the turn's last message should. */
-const endsWithMarker = (text) => text.trimEnd().split("\n").at(-1)?.trim() === "▸";
+/** The ids of the session's action in progress; null when there is none. */
+function currentIds(session) {
+	const action = session?.actions.find((a) => a.status === "doing");
+	if (!action) return null;
+	const served = action.serves.map((s) => parseRef(s)).find((r) => r !== null);
+	if (served && "mainline" in served) return {
+		mainline: served.mainline,
+		task: "task" in served ? served.task : void 0,
+		action: action.id
+	};
+	return { action: action.id };
+}
+/** The current action line for a bare marker; null when the session has no action in progress. */
+function currentActionLine(context) {
+	const ids = currentIds(context.session);
+	return ids ? headerLineFor(ids, context) : null;
+}
+/** The header line the model writes at the end of a turn, e.g. `▸ m001/t001 · a001`; null without an action in progress. */
+function headerLine(session) {
+	const ids = currentIds(session);
+	if (!ids) return null;
+	const where = ids.mainline ? ids.task ? `${ids.mainline}/${ids.task}` : ids.mainline : null;
+	return `▸ ${where ? `${where} · ` : ""}${ids.action}`;
+}
+/** The ids in a header line the model wrote, or null for a bare marker or a line that does not parse. */
+const WRITTEN = new RegExp(`^\\s*▸\\s+(?:(m\\d{3})(?:\\/(t\\d{3}))?\\s*·\\s*)?(a\\d{3})\\s*$`);
+function parseHeader(line) {
+	const m = WRITTEN.exec(line);
+	return m ? {
+		mainline: m[1],
+		task: m[2],
+		action: m[3]
+	} : null;
+}
+/** A line that is the header: the marker alone, or the marker followed by the ids the model copied. */
+const HEADER = new RegExp(`^[ \\t]*▸(?:[ \\t].*)?$`);
+/** The last non-empty line, if it is the header line. */
+const lastHeader = (text) => {
+	const last = text.trimEnd().split("\n").at(-1) ?? "";
+	return HEADER.test(last) ? last : null;
+};
+/** Whether a message ends with the header line, as the turn's last message should. */
+const endsWithMarker = (text) => lastHeader(text) !== null;
 /**
-* The text to display for a piece of a reply: mentions linked, and a trailing marker line replaced with the
-* current action line (or removed when there is none). Returns the input unchanged when there is nothing to do.
+* The text to display for a piece of a reply: mentions linked, and a trailing header line replaced with the
+* mainline › task › action it names, titles and links included. A bare marker names the session's action in
+* progress and is dropped without one. Returns the input unchanged when there is nothing to do.
 */
 function decorateReply(text, context) {
-	let shown = linkMentions(text, context);
-	if (endsWithMarker(shown)) {
-		const body = shown.trimEnd().slice(0, -1).trimEnd();
-		const line = currentActionLine(context);
-		shown = line ? `${body}\n\n${line}\n` : `${body}\n`;
-	}
-	return shown;
+	const header = lastHeader(text);
+	if (header === null) return linkMentions(text, context);
+	const body = linkMentions(text.trimEnd().slice(0, -header.length).trimEnd(), context);
+	const written = parseHeader(header);
+	const line = written ? headerLineFor(written, context) : header.trim() === "▸" ? currentActionLine(context) : linkMentions(header.trim(), context);
+	return line ? `${body}\n\n${line}\n` : `${body}\n`;
 }
 /** 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);
@@ -1039,9 +1077,11 @@ 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 [
-		doing ? `[mainflow] 目前行動 ${doing.id} ${doing.do}，服務 ${doing.serves.join("、") || "（未指定）"}。這一輪的工作若不屬於它，先調整佇列再做。` : open.length === 0 ? `[mainflow] ${session.id} 的行動都已結束。繼續工作前先用 ${options.cli} action add 列出下一個行動。` : `[mainflow] ${session.id} 目前沒有進行中的行動。`,
-		...doing ? [`- 這一輪最後一則回覆的最後一行只寫 ▸，回覆範例等其他內容都放在它前面。畫面上它會換成目前行動與連結。`] : [],
+		head,
+		...header ? [`- 這一輪最後一則回覆的最後一行寫「${header}」，回覆範例等其他內容都放在它前面。有顯示 hook 時，它會換成標題與連結。`] : [],
 		...queueWarnings(root, session, options.cli).map((w) => `- ${w}`)
 	].join("\n");
 }
@@ -1834,4 +1874,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { MAINLINE_FILE as $, setSessionStatus as A, appendOps as B, updateTask as C, readSession as D, loadSessions as E, sessionBriefing as F, reopenIssue as G, createFinding as H, turnReminder as I, setIssueArchived as J, setFindingArchived as K, decorateReply as L, startSession as M, transcriptPath as N, setSessionArchived as O, updateAction as P, refIndex as Q, endsWithMarker as R, supersedeDecision as S, ensureSession as T, createIssue as U, closeIssue as V, planIssue as W, loadHub as X, HubError as Y, linksInto as Z, setArchived as _, openInApp as a, findHubRoot as at, setMainlineStatus as b, migrateHub as c, addRepo as d, TASK_FILE as et, createDecision as f, initHub as g, dropChecklistItem as h, hostName as i, currentBranch as it, settleSession as j, setSessionInfo as k, acceptDecision as l, createTask as m, DEFAULT_UI_PORT as n, WriteError as nt, siteBlock as o, worktreesOf as ot, createMainline as p, setFindingStatus as q, caddySites as r, DATA_DIR as rt, syncHost as s, APP_BUNDLE_ID as t, ConflictError as tt, addHub as u, setChecklistItem as v, addAction as w, setMainlineTitle as x, setCriterion as y, mayDecorate as z };
+export { refIndex as $, setSessionStatus as A, mayDecorate as B, updateTask as C, readSession as D, loadSessions as E, sessionBriefing as F, planIssue as G, closeIssue as H, turnReminder as I, setFindingStatus as J, reopenIssue as K, decorateReply as L, startSession as M, transcriptPath as N, setSessionArchived as O, updateAction as P, linksInto as Q, endsWithMarker as R, supersedeDecision as S, ensureSession as T, createFinding as U, appendOps as V, createIssue as W, HubError as X, setIssueArchived as Y, loadHub as Z, setArchived as _, openInApp as a, currentBranch as at, setMainlineStatus as b, migrateHub as c, addRepo as d, MAINLINE_FILE as et, createDecision as f, initHub as g, dropChecklistItem as h, hostName as i, DATA_DIR as it, settleSession as j, setSessionInfo as k, acceptDecision as l, createTask as m, DEFAULT_UI_PORT as n, ConflictError as nt, siteBlock as o, findHubRoot as ot, createMainline as p, setFindingArchived as q, caddySites as r, WriteError as rt, syncHost as s, worktreesOf as st, APP_BUNDLE_ID as t, TASK_FILE as tt, addHub as u, setChecklistItem as v, addAction as w, setMainlineTitle as x, setCriterion as y, headerLine as z };

package/dist/host.js

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

package/dist/{launch-D5uHpqkh.js → launch-B9QrvwZQ.js}

@@ -1,4 +1,4 @@
-import { n as DEFAULT_UI_PORT, nt as WriteError, rt as DATA_DIR, s as syncHost } from "./host-BFGfpTDq.js";
+import { it as DATA_DIR, n as DEFAULT_UI_PORT, rt as WriteError, s as syncHost } from "./host-ByGN9mGS.js";
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -162,7 +162,7 @@ async function launchUi(root, hub, configured, options) {
 	}
 	let server;
 	if (!reuse) {
-		const { serveUi } = await import("./ui-DbEmJiwO.js");
+		const { serveUi } = await import("./ui-BY65lR7x.js");
 		server = await serveUi(root, choice.port);
 		writeUiRecord(root, {
 			port: choice.port,

package/dist/launch.js

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

package/dist/{ui-DbEmJiwO.js → ui-BY65lR7x.js}

@@ -1,6 +1,6 @@
-import { C as updateTask, D as readSession, E as loadSessions, J as setIssueArchived, K as setFindingArchived, N as transcriptPath, O as setSessionArchived, Q as refIndex, X as loadHub, Z as linksInto, _ as setArchived, a as openInApp, b as setMainlineStatus, nt as WriteError, rt as DATA_DIR, tt as ConflictError, v as setChecklistItem, x as setMainlineTitle, y as setCriterion } from "./host-BFGfpTDq.js";
+import { $ as refIndex, C as updateTask, D as readSession, E as loadSessions, N as transcriptPath, O as setSessionArchived, Q as linksInto, Y as setIssueArchived, Z as loadHub, _ as setArchived, a as openInApp, b as setMainlineStatus, it as DATA_DIR, nt as ConflictError, q as setFindingArchived, rt as WriteError, v as setChecklistItem, x as setMainlineTitle, y as setCriterion } from "./host-ByGN9mGS.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { c as CLI_VERSION } from "./launch-D5uHpqkh.js";
+import { c as CLI_VERSION } from "./launch-B9QrvwZQ.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.10.0",
+  "version": "0.11.1",
   "description": "本機多 AI 協作的主脈絡任務管理：CLI 與介面",
   "license": "MIT",
   "type": "module",