mainflow 0.8.0 → 0.10.0

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import { A as closeIssue, D as sessionBriefing, E as updateAction, F as setFindingArchived, G as WriteError, H as MAINLINE_FILE, I as setFindingStatus, J as findHubRoot, L as setIssueArchived, M as createIssue, N as planIssue, P as reopenIssue, R as HubError, S as setSessionStatus, U as TASK_FILE, a as createDecision, b as setSessionArchived, c as dropChecklistItem, d as setChecklistItem, f as setCriterion, g as addAction, h as updateTask, i as addRepo, j as createFinding, k as appendOps, l as initHub, m as supersedeDecision, n as acceptDecision, o as createMainline, p as setMainlineStatus, r as addHub, s as createTask, t as migrateHub, u as setArchived, w as startSession, y as readSession, z as loadHub } from "./dist-DCafRe8c.js";
-import { r as launchUi, s as listProgress } from "./launch-V6oqJDGG.js";
+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 { 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 { readFileSync, realpathSync } from "node:fs";
 import { join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -89,7 +90,8 @@ const RUNS = {
 		const { stdout, error } = runHook(args[0], args[1], {
 			payload,
 			envFile: process.env.CLAUDE_ENV_FILE,
-			cli: CLI
+			cli: CLI,
+			startUi: startUiInBackground
 		});
 		if (error) console.error(error);
 		if (stdout) console.log(stdout);
@@ -249,7 +251,7 @@ function run(argv, cwd) {
 		return fail(`${error.message}\n\n${USAGE}`);
 	}
 	const { values: opts, positionals } = parsed;
-	if (opts.version) return done(JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version);
+	if (opts.version) return done(CLI_VERSION);
 	if (opts.help || positionals.length === 0) {
 		console.log(USAGE);
 		return opts.help ? 0 : 1;

package/dist/hooks.d.ts

@@ -11,6 +11,10 @@ export interface ClaudeCodePayload {
   effort?: {
     level?: string;
   };
+  /** Stop: true when the turn is already continuing because a Stop hook asked it to */
+  stop_hook_active?: boolean;
+  /** MessageDisplay: the lines of an assistant message about to be shown */
+  delta?: string;
   /** PostToolUse: the tool that ran and its input */
   tool_name?: string;
   tool_input?: {
@@ -26,9 +30,13 @@ export interface HookContext {
   envFile?: string;
   /** How the executor should invoke the CLI inside the hub, used in the texts it reads */
   cli: string;
+  /** Start the hub's interface without waiting; given by the CLI entry point, left out by callers that must not spawn */
+  startUi?: (root: string) => void;
 }
 export declare const claudeCodeSessionId: (raw: string) => string;
 type Handler = (root: string, ctx: HookContext) => string | null;
+/** How a hub's interface is linked from a reply: through its /open route, which shows the address in the app. */
+export declare const openLink: (hub: string) => (path: string) => string;
 export declare const HOOK_PLATFORMS: Record<string, Record<string, Handler>>;
 /**
  * Run a hook handler. A hook must never break the host session, so outside a hub it stays silent and any

package/dist/hooks.js

@@ -1,4 +1,4 @@
-import { C as settleSession, D as sessionBriefing, J as findHubRoot, K as DATA_DIR, O as turnReminder, R as HubError, S as setSessionStatus, Y as worktreesOf, _ as ensureSession, q as currentBranch, x as setSessionInfo, y as readSession, z as loadHub } from "./dist-DCafRe8c.js";
+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 { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 //#region src/hooks.ts
@@ -23,8 +23,9 @@ const brief = (text) => {
 const shortId = (raw) => raw.replace(/[^a-z0-9]/gi, "").toLowerCase().slice(0, 8);
 const claudeCodeSessionId = (raw) => `claude-code-${shortId(raw)}`;
 /**
-* One handler per Claude Code event; each returns what to print for the model, or null. SessionStart and
-* UserPromptSubmit take plain text; PostToolUse takes the hook JSON, since its plain stdout never reaches the model.
+* One handler per Claude Code event; each returns what to print, or null. SessionStart and UserPromptSubmit take
+* plain text for the model; PostToolUse, Stop and MessageDisplay take the hook JSON, since their plain stdout
+* never reaches the model or the screen.
 */
 /**
 * Record the main session: create it when it is missing, since a turn that tracked nothing left no record, and
@@ -46,12 +47,55 @@ function recordSession(root, payload, id, refresh) {
 		effort: payload.effort?.level
 	});
 }
+/** Settle the main session by the rules settleSession states; prints nothing. */
+const settleOnEnd = (root, { payload }) => {
+	if (payload.session_id) settleSession(root, claudeCodeSessionId(payload.session_id));
+	return null;
+};
+/** 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
+* returns before the hub is loaded, because Claude Code holds every batch until the hook answers.
+*/
+const displayReply = (root, { payload }) => {
+	const text = payload.delta;
+	if (!text || !mayDecorate(text)) return null;
+	const hub = loadHub(root, { remotes: false });
+	const session = payload.session_id ? readSession(root, claudeCodeSessionId(payload.session_id)) : null;
+	const shown = decorateReply(text, {
+		hub,
+		session,
+		link: openLink(hub.config.hub)
+	});
+	return shown === text ? null : JSON.stringify({ hookSpecificOutput: {
+		hookEventName: "MessageDisplay",
+		displayContent: shown
+	} });
+};
+/**
+* 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
+* 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;
+	return JSON.stringify({ hookSpecificOutput: {
+		hookEventName: "Stop",
+		additionalContext: `[mainflow] 這一輪最後一則回覆沒有以單獨一行的 ▸ 結尾。請只回一則內容為 ▸ 的訊息，不加其他文字。`
+	} });
+};
 const CLAUDE_CODE_EVENTS = {
-	"session-start": (root, { payload, envFile, cli }) => {
+	"session-start": (root, { payload, envFile, cli, startUi }) => {
 		if (!payload.session_id) return null;
 		const id = claudeCodeSessionId(payload.session_id);
 		const session = recordSession(root, payload, id, true);
 		if (envFile) appendFileSync(envFile, `export MAINFLOW_SESSION=${id}\n`);
+		startUi?.(root);
 		return sessionBriefing(root, session, {
 			cli,
 			envNote: envFile ? "已設定環境變數 MAINFLOW_SESSION，指令不必再帶 --session" : `執行指令時帶 --session ${id}`
@@ -61,10 +105,8 @@ const CLAUDE_CODE_EVENTS = {
 		if (!payload.session_id) return null;
 		return turnReminder(root, recordSession(root, payload, claudeCodeSessionId(payload.session_id), false), { cli });
 	},
-	stop: (root, { payload }) => {
-		if (payload.session_id) settleSession(root, claudeCodeSessionId(payload.session_id));
-		return null;
-	},
+	stop: settleAndCheckMarker,
+	"session-end": settleOnEnd,
 	"subagent-start": (root, { payload }) => {
 		if (!payload.agent_id) return null;
 		const parent = payload.session_id ? claudeCodeSessionId(payload.session_id) : null;
@@ -90,7 +132,8 @@ const CLAUDE_CODE_EVENTS = {
 		setSessionStatus(root, id, "ended");
 		return null;
 	},
-	"post-tool-use": checkAfterWrite
+	"post-tool-use": checkAfterWrite,
+	"message-display": displayReply
 };
 /** How many problems outside the written file the reminder lists before it only gives the count. */
 const OTHER_PROBLEMS_SHOWN = 5;
@@ -181,4 +224,4 @@ function runHook(platform, event, ctx) {
 	}
 }
 //#endregion
-export { HOOK_PLATFORMS, claudeCodeSessionId, runHook, subagentTranscript };
+export { HOOK_PLATFORMS, claudeCodeSessionId, openLink, runHook, subagentTranscript };

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

@@ -1,7 +1,7 @@
 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 { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
+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 { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { createHash, randomBytes } from "node:crypto";
 import { parse, stringify } from "yaml";
 //#region ../core/dist/paths.js
@@ -909,6 +909,68 @@ function appendOps(root, input) {
 		return entry;
 	});
 }
+/** Where the hub's interface shows a reference; null for kinds it has no page or panel for. */
+function pathOf(ref, target) {
+	const [m, child] = ref.split("/");
+	switch (target.kind) {
+		case "mainline": return `/mainlines/${m}`;
+		case "task": return `/mainlines/${m}/tasks/${child}`;
+		case "decision": return `/mainlines/${m}/decisions/${child}`;
+		case "issue": return `/issues?peek=${ref}`;
+		case "finding": return `/findings?peek=${ref}`;
+		default: return null;
+	}
+}
+const sessionPath = (id) => `/sessions/${id}`;
+/** Fenced blocks, inline code, markdown links and bare URLs: text inside them is left as written. */
+const PROTECTED = /(```[\s\S]*?(?:```|$)|`[^`\n]*`|\[[^\]\n]*\]\([^)\n]*\)|https?:\/\/\S+)/;
+/** A file under a mainline directory, or a reference to a mainline, task, decision, issue or finding. */
+const MENTION = /\.mainflow\/mainlines\/(m\d{3})-[\w-]+\/([^\s`'")\]]+\.\w+)|(?<![\w/#.[-])(m\d{3}(?:\/[td]\d{3})?|[if]\d{3})(?![\w\]])/g;
+/** Links for the references and mainline files the text mentions; references the hub does not have stay as text. */
+function linkMentions(text, context) {
+	const index = refIndex(context.hub);
+	return text.split(PROTECTED).map((part, i) => i % 2 === 1 ? part : part.replace(MENTION, (all, m, file, ref) => {
+		if (m && file) return index.has(m) ? `[${m}/${file}](${context.link(`/mainlines/${m}/files/${file}`)})` : all;
+		const target = ref ? index.get(ref) : void 0;
+		const path = ref && target ? pathOf(ref, target) : null;
+		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;
+	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());
+		}
+	}
+	parts.push(`[${action.id}](${context.link(sessionPath(context.session.id))}) ${action.do}`);
+	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 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.
+*/
+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;
+}
+/** 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) {
@@ -977,7 +1039,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");
-	return [doing ? `[mainflow] 目前行動 ${doing.id} ${doing.do}，服務 ${doing.serves.join("、") || "（未指定）"}。這一輪的工作若不屬於它，先調整佇列再做。` : open.length === 0 ? `[mainflow] ${session.id} 的行動都已結束。繼續工作前先用 ${options.cli} action add 列出下一個行動。` : `[mainflow] ${session.id} 目前沒有進行中的行動。`, ...queueWarnings(root, session, options.cli).map((w) => `- ${w}`)].join("\n");
+	return [
+		doing ? `[mainflow] 目前行動 ${doing.id} ${doing.do}，服務 ${doing.serves.join("、") || "（未指定）"}。這一輪的工作若不屬於它，先調整佇列再做。` : open.length === 0 ? `[mainflow] ${session.id} 的行動都已結束。繼續工作前先用 ${options.cli} action add 列出下一個行動。` : `[mainflow] ${session.id} 目前沒有進行中的行動。`,
+		...doing ? [`- 這一輪最後一則回覆的最後一行只寫 ▸，回覆範例等其他內容都放在它前面。畫面上它會換成目前行動與連結。`] : [],
+		...queueWarnings(root, session, options.cli).map((w) => `- ${w}`)
+	].join("\n");
 }
 //#endregion
 //#region ../core/dist/sessions.js
@@ -1324,6 +1390,15 @@ function setMainlineStatus(root, id, status, expectedVersion) {
 		stampClosed(m, closes("mainline", next), today());
 	}, expectedVersion);
 }
+/** Rename a mainline. References use its ID, so they keep resolving and show the new title. */
+function setMainlineTitle(root, id, title, expectedVersion) {
+	requireRef(id, "mainline");
+	const next = title.replace(/\s+/g, " ").trim();
+	if (!next) throw new WriteError(`${id} needs a title, e.g. "mainflow 改發布到 npm 公開套件"`);
+	return mutateFrontMatter(root, mainlineFile(root, id), mainlineSchema, (m) => {
+		m.title = next;
+	}, expectedVersion);
+}
 function setArchived(root, id, archived, expectedVersion) {
 	requireRef(id, "mainline");
 	return mutateFrontMatter(root, mainlineFile(root, id), mainlineSchema, (m) => {
@@ -1644,4 +1719,119 @@ function migrateHub(root, options = {}) {
 	});
 }
 //#endregion
-export { closeIssue as A, linksInto as B, settleSession as C, sessionBriefing as D, updateAction as E, setFindingArchived as F, WriteError as G, MAINLINE_FILE as H, setFindingStatus as I, findHubRoot as J, DATA_DIR as K, setIssueArchived as L, createIssue as M, planIssue as N, turnReminder as O, reopenIssue as P, HubError as R, setSessionStatus as S, transcriptPath as T, TASK_FILE as U, refIndex as V, ConflictError as W, worktreesOf as Y, ensureSession as _, createDecision as a, setSessionArchived as b, dropChecklistItem as c, setChecklistItem as d, setCriterion as f, addAction as g, updateTask as h, addRepo as i, createFinding as j, appendOps as k, initHub as l, supersedeDecision as m, acceptDecision as n, createMainline as o, setMainlineStatus as p, currentBranch as q, addHub as r, createTask as s, migrateHub as t, setArchived as u, loadSessions as v, startSession as w, setSessionInfo as x, readSession as y, loadHub as z };
+//#region src/host.ts
+const DEFAULT_UI_PORT = 4320;
+const hostName = (hub) => `${hub}.mainflow.localhost`;
+function siteBlock(hub, port) {
+	return [
+		`# mainflow hub ${hub}: written by \`mainflow ui\` to match the port it serves on; do not edit.`,
+		`${hostName(hub)} {`,
+		"	tls internal",
+		`\treverse_proxy localhost:${port}`,
+		"}",
+		""
+	].join("\n");
+}
+/** Caddy's sites directory: MAINFLOW_CADDY_SITES, or the Homebrew layout {prefix}/etc/caddy/sites; null without either. */
+function caddySites() {
+	if (process.env.MAINFLOW_CADDY_SITES) return process.env.MAINFLOW_CADDY_SITES;
+	const prefix = spawnSync("brew", ["--prefix"], { encoding: "utf8" });
+	if (prefix.error || prefix.status !== 0) return null;
+	return join(prefix.stdout.trim(), "etc/caddy/sites");
+}
+/** Reload Caddy from the Caddyfile two levels above the sites directory; the error text on failure. */
+function reloadCaddy(sites) {
+	const caddyfile = join(sites, "..", "..", "Caddyfile");
+	const reload = spawnSync("caddy", [
+		"reload",
+		"--config",
+		caddyfile
+	], { encoding: "utf8" });
+	if (reload.error) return reload.error.message;
+	return reload.status === 0 ? null : (reload.stderr || reload.stdout).trim().slice(-300);
+}
+/**
+* Whether Caddy is running, judged by its admin API answering at all. The API refuses requests like
+* Node's fetch with 403 ("client is not allowed to access from origin"), so any response counts; only a
+* refused connection or a timeout means Caddy is down (observed 2026-09-25: checking for 200 reported a
+* running Caddy as stopped). MAINFLOW_CADDY_ADMIN overrides the address.
+*/
+async function caddyRunning() {
+	const admin = process.env.MAINFLOW_CADDY_ADMIN ?? "http://127.0.0.1:2019";
+	try {
+		await fetch(`${admin}/config/`, { signal: AbortSignal.timeout(500) });
+		return true;
+	} catch {
+		return false;
+	}
+}
+const realOf = (path) => existsSync(path) ? realpathSync(path) : resolve(path);
+/**
+* Point {hub}.mainflow.localhost at `port`. The site block is rewritten and Caddy reloaded only when the
+* port differs from what Caddy already has, so an ordinary start leaves Caddy alone. A link owned by a
+* different hub of the same name stops here: overwriting it would silently take that hub's host name.
+*/
+async function syncHost(root, hub, port, options = {}) {
+	const sites = caddySites();
+	if (!sites || !existsSync(sites)) return {
+		url: null,
+		reason: `Caddy's sites directory was not found (${sites ?? "no Homebrew prefix"}); install Caddy and import that directory from the Caddyfile, or set MAINFLOW_CADDY_SITES`
+	};
+	const dir = join(root, DATA_DIR, "local", "caddy");
+	const file = join(dir, `${hub}.caddy`);
+	const link = join(sites, `mainflow-${hub}.caddy`);
+	const linked = lstatSync(link, { throwIfNoEntry: false });
+	if (linked) {
+		const target = linked.isSymbolicLink() ? resolve(dirname(link), readlinkSync(link)) : link;
+		if (existsSync(target) && realOf(target) !== realOf(file)) throw new WriteError(`host name ${hostName(hub)} is already used by another hub (${link} → ${target}); give one of the hubs a different name in its .mainflow/config.yaml`);
+	}
+	const block = siteBlock(hub, port);
+	if ((linked && existsSync(file) ? readFileSync(file, "utf8") : null) !== block) {
+		mkdirSync(dir, { recursive: true });
+		writeFileSync(file, block);
+		if (linked) rmSync(link);
+		symlinkSync(file, link);
+		const failure = (options.reload ?? reloadCaddy)(sites);
+		if (failure) return {
+			url: null,
+			reason: `caddy reload failed: ${failure}`
+		};
+	} else if (!await (options.running ?? caddyRunning)()) return {
+		url: null,
+		reason: "Caddy is not running; start it with `brew services start caddy`"
+	};
+	return { url: `https://${hostName(hub)}` };
+}
+/** The macOS app's bundle identifier, from apps/macos/scripts/package.sh. */
+const APP_BUNDLE_ID = "space.carlos.mainflow";
+/** Close the tabs Safari and Chrome opened on this hub's /open route; each browser only when it is running. */
+const closeOpenTabs = (hub) => {
+	const marker = `${hostName(hub)}/open/`;
+	return ["Safari", "Google Chrome"].map((app) => `if application "${app}" is running then
+  tell application "${app}"
+    repeat with w in (every window)
+      close (every tab of w whose URL contains "${marker}")
+    end repeat
+  end tell
+end if`).join("\n");
+};
+/**
+* Show an address of the hub's interface in the macOS app through its mainflow:// scheme (docs/app.md "連結").
+* A link in a reply reaches here through the default browser, so once the app has the address the browser tab
+* it left is closed and the app brought back to the front. Returns false when no app handles the scheme; the
+* caller then leaves the page to the browser. Does nothing and returns false outside macOS.
+*/
+function openInApp(hub, target, closeAfterMs = 150) {
+	if (process.platform !== "darwin") return false;
+	if (spawnSync("open", [`mainflow://${hub}${target}`]).status !== 0) return false;
+	setTimeout(() => {
+		spawnSync("osascript", ["-e", closeOpenTabs(hub)]);
+		spawn("open", ["-b", APP_BUNDLE_ID], {
+			detached: true,
+			stdio: "ignore"
+		}).on("error", () => {}).unref();
+	}, closeAfterMs);
+	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 };

package/dist/host.d.ts

@@ -21,4 +21,13 @@ export type HostResult = {
  * different hub of the same name stops here: overwriting it would silently take that hub's host name.
  */
 export declare function syncHost(root: string, hub: string, port: number, options?: HostOptions): Promise<HostResult>;
+/** The macOS app's bundle identifier, from apps/macos/scripts/package.sh. */
+export declare const APP_BUNDLE_ID = "space.carlos.mainflow";
+/**
+ * Show an address of the hub's interface in the macOS app through its mainflow:// scheme (docs/app.md "連結").
+ * A link in a reply reaches here through the default browser, so once the app has the address the browser tab
+ * it left is closed and the app brought back to the front. Returns false when no app handles the scheme; the
+ * caller then leaves the page to the browser. Does nothing and returns false outside macOS.
+ */
+export declare function openInApp(hub: string, target: string, closeAfterMs?: number): boolean;
 //#endregion

package/dist/host.js

@@ -1,89 +1,2 @@
-import { G as WriteError, K as DATA_DIR } from "./dist-DCafRe8c.js";
-import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { spawnSync } from "node:child_process";
-//#region src/host.ts
-const DEFAULT_UI_PORT = 4320;
-const hostName = (hub) => `${hub}.mainflow.localhost`;
-function siteBlock(hub, port) {
-	return [
-		`# mainflow hub ${hub}: written by \`mainflow ui\` to match the port it serves on; do not edit.`,
-		`${hostName(hub)} {`,
-		"	tls internal",
-		`\treverse_proxy localhost:${port}`,
-		"}",
-		""
-	].join("\n");
-}
-/** Caddy's sites directory: MAINFLOW_CADDY_SITES, or the Homebrew layout {prefix}/etc/caddy/sites; null without either. */
-function caddySites() {
-	if (process.env.MAINFLOW_CADDY_SITES) return process.env.MAINFLOW_CADDY_SITES;
-	const prefix = spawnSync("brew", ["--prefix"], { encoding: "utf8" });
-	if (prefix.error || prefix.status !== 0) return null;
-	return join(prefix.stdout.trim(), "etc/caddy/sites");
-}
-/** Reload Caddy from the Caddyfile two levels above the sites directory; the error text on failure. */
-function reloadCaddy(sites) {
-	const caddyfile = join(sites, "..", "..", "Caddyfile");
-	const reload = spawnSync("caddy", [
-		"reload",
-		"--config",
-		caddyfile
-	], { encoding: "utf8" });
-	if (reload.error) return reload.error.message;
-	return reload.status === 0 ? null : (reload.stderr || reload.stdout).trim().slice(-300);
-}
-/**
-* Whether Caddy is running, judged by its admin API answering at all. The API refuses requests like
-* Node's fetch with 403 ("client is not allowed to access from origin"), so any response counts; only a
-* refused connection or a timeout means Caddy is down (observed 2026-09-25: checking for 200 reported a
-* running Caddy as stopped). MAINFLOW_CADDY_ADMIN overrides the address.
-*/
-async function caddyRunning() {
-	const admin = process.env.MAINFLOW_CADDY_ADMIN ?? "http://127.0.0.1:2019";
-	try {
-		await fetch(`${admin}/config/`, { signal: AbortSignal.timeout(500) });
-		return true;
-	} catch {
-		return false;
-	}
-}
-const realOf = (path) => existsSync(path) ? realpathSync(path) : resolve(path);
-/**
-* Point {hub}.mainflow.localhost at `port`. The site block is rewritten and Caddy reloaded only when the
-* port differs from what Caddy already has, so an ordinary start leaves Caddy alone. A link owned by a
-* different hub of the same name stops here: overwriting it would silently take that hub's host name.
-*/
-async function syncHost(root, hub, port, options = {}) {
-	const sites = caddySites();
-	if (!sites || !existsSync(sites)) return {
-		url: null,
-		reason: `Caddy's sites directory was not found (${sites ?? "no Homebrew prefix"}); install Caddy and import that directory from the Caddyfile, or set MAINFLOW_CADDY_SITES`
-	};
-	const dir = join(root, DATA_DIR, "local", "caddy");
-	const file = join(dir, `${hub}.caddy`);
-	const link = join(sites, `mainflow-${hub}.caddy`);
-	const linked = lstatSync(link, { throwIfNoEntry: false });
-	if (linked) {
-		const target = linked.isSymbolicLink() ? resolve(dirname(link), readlinkSync(link)) : link;
-		if (existsSync(target) && realOf(target) !== realOf(file)) throw new WriteError(`host name ${hostName(hub)} is already used by another hub (${link} → ${target}); give one of the hubs a different name in its .mainflow/config.yaml`);
-	}
-	const block = siteBlock(hub, port);
-	if ((linked && existsSync(file) ? readFileSync(file, "utf8") : null) !== block) {
-		mkdirSync(dir, { recursive: true });
-		writeFileSync(file, block);
-		if (linked) rmSync(link);
-		symlinkSync(file, link);
-		const failure = (options.reload ?? reloadCaddy)(sites);
-		if (failure) return {
-			url: null,
-			reason: `caddy reload failed: ${failure}`
-		};
-	} else if (!await (options.running ?? caddyRunning)()) return {
-		url: null,
-		reason: "Caddy is not running; start it with `brew services start caddy`"
-	};
-	return { url: `https://${hostName(hub)}` };
-}
-//#endregion
-export { DEFAULT_UI_PORT, caddySites, hostName, siteBlock, syncHost };
+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";
+export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, siteBlock, syncHost };