mainflow 0.11.0 → 0.11.2

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-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-iTpj7MPD.js";
+import { C as supersedeDecision, F as updateAction, G as createIssue, H as appendOps, I as sessionBriefing, J as setFindingArchived, K as planIssue, N as startSession, O as readSession, Q as loadHub, T as addAction, U as closeIssue, W as createFinding, X as setIssueArchived, Y as setFindingStatus, Z as HubError, _ as initHub, b as setCriterion, d as addHub, f as addRepo, g as dropChecklistItem, h as createTask, it as WriteError, j as setSessionStatus, k as setSessionArchived, l as migrateHub, m as createMainline, nt as TASK_FILE, p as createDecision, q as reopenIssue, st as findHubRoot, tt as MAINLINE_FILE, u as acceptDecision, v as setArchived, w as updateTask, x as setMainlineStatus, y as setChecklistItem } from "./host-C3MyDGB_.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-BMuk7UvN.js";
+import { l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-T0sXbTgT.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, 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-iTpj7MPD.js";
+import { A as setSessionInfo, B as headerLine, E as ensureSession, I as sessionBriefing, L as turnReminder, M as settleSession, O as readSession, Q as loadHub, R as decorateReply, V as mayDecorate, Z as HubError, at as DATA_DIR, ct as worktreesOf, i as hostName, j as setSessionStatus, ot as currentBranch, st as findHubRoot, z as endsWithMarker } from "./host-C3MyDGB_.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 }) => {

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

@@ -936,31 +936,54 @@ 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(" › ")}`;
 }
-/** 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) {
+/** 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);
-	const where = served && "mainline" in served ? "task" in served ? `${served.mainline}/${served.task}` : served.mainline : null;
-	return `▸ ${where ? `${where} · ` : ""}${action.id}`;
+	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].*)?$`);
@@ -973,14 +996,15 @@ const lastHeader = (text) => {
 const endsWithMarker = (text) => lastHeader(text) !== null;
 /**
 * The text to display for a piece of a reply: mentions linked, and a trailing header line replaced with the
-* session's current action line, titles and links included. Without an action in progress the line the model
-* wrote stays, its ids linked; a bare marker is dropped. Returns the input unchanged when there is nothing to do.
+* 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) {
 	const header = lastHeader(text);
 	if (header === null) return linkMentions(text, context);
 	const body = linkMentions(text.trimEnd().slice(0, -header.length).trimEnd(), context);
-	const line = currentActionLine(context) ?? (header.trim() === "▸" ? null : linkMentions(header.trim(), 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. */
@@ -1818,6 +1842,20 @@ async function syncHost(root, hub, port, options = {}) {
 	};
 	return { url: `https://${hostName(hub)}` };
 }
+/**
+* Remove {hub}.mainflow.localhost when the hub rooted at `root` is gone, so a dangling link does not stop Caddy
+* from loading every other site. Only a link that points into `root` is removed; the reload failure, if any,
+* is returned for the caller to log.
+*/
+function removeHostLink(root, hub, reload = reloadCaddy) {
+	const sites = caddySites();
+	if (!sites) return null;
+	const link = join(sites, `mainflow-${hub}.caddy`);
+	if (!lstatSync(link, { throwIfNoEntry: false })?.isSymbolicLink()) return null;
+	if (!resolve(dirname(link), readlinkSync(link)).startsWith(resolve(root) + "/")) return null;
+	rmSync(link);
+	return reload(sites);
+}
 /** 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. */
@@ -1850,4 +1888,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-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 };
+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 };

package/dist/host.d.ts

@@ -21,6 +21,12 @@ 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>;
+/**
+ * Remove {hub}.mainflow.localhost when the hub rooted at `root` is gone, so a dangling link does not stop Caddy
+ * from loading every other site. Only a link that points into `root` is removed; the reload failure, if any,
+ * is returned for the caller to log.
+ */
+export declare function removeHostLink(root: string, hub: string, reload?: (sites: string) => string | null): string | null;
 /** The macOS app's bundle identifier, from apps/macos/scripts/package.sh. */
 export declare const APP_BUNDLE_ID = "space.carlos.mainflow";
 /**

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-iTpj7MPD.js";
-export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, siteBlock, syncHost };
+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";
+export { APP_BUNDLE_ID, DEFAULT_UI_PORT, caddySites, hostName, openInApp, removeHostLink, siteBlock, syncHost };

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

@@ -1,5 +1,5 @@
-import { it as DATA_DIR, n as DEFAULT_UI_PORT, rt as WriteError, s as syncHost } from "./host-iTpj7MPD.js";
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+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 { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
 import { createServer } from "node:net";
@@ -111,7 +111,7 @@ async function choosePort(hub, candidates, probe = networkProbe) {
 */
 function startUiInBackground(root) {
 	const cli = process.argv[1];
-	if (!cli) return;
+	if (!cli || process.env.MAINFLOW_NO_BACKGROUND_UI === "1") return;
 	spawn(process.execPath, [
 		cli,
 		"ui",
@@ -122,6 +122,20 @@ function startUiInBackground(root) {
 		stdio: "ignore"
 	}).on("error", () => {}).unref();
 }
+/**
+* Call `onGone` once the hub's config.yaml disappears, checking every `everyMs`. A server started for a hub in a
+* directory that is later deleted, such as a test's, then stops instead of holding its port forever. The timer
+* does not keep the process alive by itself.
+*/
+function watchHubGone(root, onGone, everyMs = 3e4) {
+	const timer = setInterval(() => {
+		if (existsSync(join(root, ".mainflow", "config.yaml"))) return;
+		clearInterval(timer);
+		onGone();
+	}, everyMs);
+	timer.unref();
+	return timer;
+}
 /** Open a URL in the default browser without waiting for it. */
 function openUrl(url) {
 	const [command, ...args] = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? [
@@ -162,13 +176,20 @@ async function launchUi(root, hub, configured, options) {
 	}
 	let server;
 	if (!reuse) {
-		const { serveUi } = await import("./ui-DNLdjWwd.js");
+		const { serveUi } = await import("./ui-BTLe6I--.js");
 		server = await serveUi(root, choice.port);
 		writeUiRecord(root, {
 			port: choice.port,
 			pid: process.pid,
 			version: CLI_VERSION
 		});
+		const started = server;
+		watchHubGone(root, () => {
+			const failure = removeHostLink(root, hub);
+			if (failure) log(`! caddy reload failed after removing ${hostName(hub)}: ${failure}`);
+			started.close();
+			process.exit(0);
+		});
 	}
 	const host = await syncHost(root, hub, choice.port, options.host);
 	if (host.url === null) log(`! host name not available: ${host.reason}`);
@@ -181,4 +202,4 @@ async function launchUi(root, hub, configured, options) {
 	};
 }
 //#endregion
-export { portCandidates as a, CLI_VERSION as c, networkProbe as i, choosePort as n, readUiRecord as o, launchUi as r, startUiInBackground as s, PORT_SPAN as t };
+export { portCandidates as a, watchHubGone as c, networkProbe as i, CLI_VERSION as l, choosePort as n, readUiRecord as o, launchUi as r, startUiInBackground as s, PORT_SPAN as t };

package/dist/launch.d.ts

@@ -51,6 +51,12 @@ export declare function choosePort(hub: string, candidates: number[], probe?: Po
  * pinned version serves its interface.
  */
 export declare function startUiInBackground(root: string): void;
+/**
+ * Call `onGone` once the hub's config.yaml disappears, checking every `everyMs`. A server started for a hub in a
+ * directory that is later deleted, such as a test's, then stops instead of holding its port forever. The timer
+ * does not keep the process alive by itself.
+ */
+export declare function watchHubGone(root: string, onGone: () => void, everyMs?: number): NodeJS.Timeout;
 export interface LaunchOptions {
   port?: string;
   open: boolean;

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-BMuk7UvN.js";
-export { PORT_SPAN, choosePort, launchUi, networkProbe, portCandidates, readUiRecord, startUiInBackground };
+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";
+export { PORT_SPAN, choosePort, launchUi, networkProbe, portCandidates, readUiRecord, startUiInBackground, watchHubGone };

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

@@ -1,6 +1,6 @@
-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-iTpj7MPD.js";
+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 { t as listProgress } from "./progress-1BfPg2zN.js";
-import { c as CLI_VERSION } from "./launch-BMuk7UvN.js";
+import { l as CLI_VERSION } from "./launch-T0sXbTgT.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.11.0",
+  "version": "0.11.2",
   "description": "本機多 AI 協作的主脈絡任務管理：CLI 與介面",
   "license": "MIT",
   "type": "module",