mainflow 0.40.0 → 0.41.0-beta.1

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { $ as stampMs, G as parseUntil, K as refExample, M as UNTIL_FORMS, W as parseRef, n as CLOSED_STATUS } from "./dist-zSabglPq.js";
-import { $ as unavailableHubs, C as loadSessions, Et as WriteError, G as loadHub, H as checkHubName, K as sectionText, Q as remoteMembers, St as findHubRoot, Tt as DATA_DIR, U as HubError, V as applyOperation, X as memberOfGroup, b as duplicateClaimLines, bt as requireSlug, ct as MAX_FILE_BYTES, d as migrateHub, f as retroReport, h as RETRY_RULES, it as nodeStorage, m as receiverFromEnv, p as retroReportFromReceiver, tt as nowMinute, u as groupPlan, v as initHub, vt as MAINLINE_FILE, w as readSession, x as sessionBriefing, y as untilState, yt as TASK_FILE } from "./host-erQ_Sr8U.js";
+import { At as WriteError, Ct as TASK_FILE, D as loadSessions, Et as findHubRoot, G as applyOperation, K as checkHubName, O as readSession, St as MAINLINE_FILE, X as sectionText, Y as loadHub, at as nowMinute, b as duplicateClaimLines, ct as nodeStorage, d as migrateHub, et as memberOfGroup, f as retroReport, ft as MAX_FILE_BYTES, h as RETRY_RULES, kt as DATA_DIR, m as receiverFromEnv, nt as remoteMembers, p as retroReportFromReceiver, q as HubError, rt as unavailableHubs, u as groupPlan, v as initHub, wt as requireSlug, x as sessionBriefing, y as untilState } from "./host-BAMZmRy8.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { C as ServerError, D as syncSettings, E as hubName, O as SETTINGS_FILE, S as ServerApi, T as earlierToken, _ as readDaemon, a as remoteMode, b as readRemote, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, j as syncPaths, l as planFetch, m as DaemonUnavailable, n as hubWriter, o as fetchDenial, p as DaemonRunning, r as writtenLines, s as hookAnswer, t as CONFIRM_MS, u as planFlush, v as silentHint, w as ENV, x as oversizedFiles } from "./operation-Bf6DtnfD.js";
+import { C as ServerError, D as syncSettings, E as hubName, O as SETTINGS_FILE, S as ServerApi, T as earlierToken, _ as readDaemon, a as remoteMode, b as readRemote, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, j as syncPaths, l as planFetch, m as DaemonUnavailable, n as hubWriter, o as fetchDenial, p as DaemonRunning, r as writtenLines, s as hookAnswer, t as CONFIRM_MS, u as planFlush, v as silentHint, w as ENV, x as oversizedFiles } from "./operation-DlR1P_Pt.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { hookFallback, parsePayload, runHook } from "./hooks.js";
-import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-I_JDTAtU.js";
+import { f as CLI_VERSION, i as launchUi, l as startUiInBackground, r as exitCodeFor, u as watchHubGone } from "./launch-CMeKJsNd.js";
 import { randomBytes } from "node:crypto";
 import { existsSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
 import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/facts.d.ts

@@ -724,5 +724,20 @@ export declare const FIELDS: {
   readonly action: readonly [FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec, FieldSpec];
   readonly link: readonly [FieldSpec, FieldSpec, FieldSpec];
 };
+/** The first day the start gate applies; a task created earlier began before the lines below existed. */
+export declare const START_GATE_FROM = "2026-10-19";
+/** The kinds of change that need no acceptance scenarios, as a skip line names them. */
+export declare const SCENARIO_SKIP_KINDS: readonly ['措辭或格式', '照抄或同步版號', '單一設定值', '一句話說得完'];
+/** The two lines under a task's 紀錄 that let writing start: the scenarios were confirmed, or the change needs none. */
+export declare const SCENARIO_LINES: {
+  readonly confirmed: {
+    readonly form: '- 驗收情境確認：{使用者怎麼回覆}';
+    readonly pattern: RegExp;
+  };
+  readonly skipped: {
+    readonly form: `- 驗收情境略過（{${string} 之一}）：{理由}`;
+    readonly pattern: RegExp;
+  };
+};
 //#endregion
 export { CHECKLIST_REF, FORMAT_VERSION, ID_PATTERNS, SERVES_REF, SLUG };

package/dist/facts.js

@@ -734,5 +734,25 @@ const FIELDS = {
 		field("note", false, "一句話說明這個關係")
 	]
 };
+/** The first day the start gate applies; a task created earlier began before the lines below existed. */
+const START_GATE_FROM = "2026-10-19";
+/** The kinds of change that need no acceptance scenarios, as a skip line names them. */
+const SCENARIO_SKIP_KINDS = [
+	"措辭或格式",
+	"照抄或同步版號",
+	"單一設定值",
+	"一句話說得完"
+];
+/** The two lines under a task's 紀錄 that let writing start: the scenarios were confirmed, or the change needs none. */
+const SCENARIO_LINES = {
+	confirmed: {
+		form: "- 驗收情境確認：{使用者怎麼回覆}",
+		pattern: /^- 驗收情境確認：\S/
+	},
+	skipped: {
+		form: `- 驗收情境略過（{${SCENARIO_SKIP_KINDS.join("、")} 之一}）：{理由}`,
+		pattern: new RegExp(`^- 驗收情境略過（(?:${SCENARIO_SKIP_KINDS.join("|")})）：\\S`)
+	}
+};
 //#endregion
-export { CHECKLIST_REF, CLASSIFICATION, CLOSED_STATUSES, COMMAND_SPECS, FIELDS, FORMAT_VERSION, GRANTS, ID_PATTERNS, LAYOUT, LINKS, OPTIONS, REFERENCES, RETRO_FORMATS, SECTIONS, SERVES_REF, SLUG, STATUSES, SURVEY, UNTIL };
+export { CHECKLIST_REF, CLASSIFICATION, CLOSED_STATUSES, COMMAND_SPECS, FIELDS, FORMAT_VERSION, GRANTS, ID_PATTERNS, LAYOUT, LINKS, OPTIONS, REFERENCES, RETRO_FORMATS, SCENARIO_LINES, SCENARIO_SKIP_KINDS, SECTIONS, SERVES_REF, SLUG, START_GATE_FROM, STATUSES, SURVEY, UNTIL };

package/dist/hooks.d.ts

@@ -618,21 +618,6 @@ export type HookFailure = {
 } | {
   kind: 'unreadable-input';
 };
-/** The first day the start gate applies; a task created earlier began before the lines below existed. */
-export declare const START_GATE_FROM = "2026-10-19";
-/** The kinds of change that need no acceptance scenarios, as a skip line names them. */
-export declare const SCENARIO_SKIP_KINDS: readonly ['措辭或格式', '照抄或同步版號', '單一設定值', '一句話說得完'];
-/** The two lines under a task's 紀錄 that let writing start: the scenarios were confirmed, or the change needs none. */
-export declare const SCENARIO_LINES: {
-  readonly confirmed: {
-    readonly form: '- 驗收情境確認：{使用者怎麼回覆}';
-    readonly pattern: RegExp;
-  };
-  readonly skipped: {
-    readonly form: `- 驗收情境略過（{${string} 之一}）：{理由}`;
-    readonly pattern: RegExp;
-  };
-};
 /** Whether a task's 紀錄 holds a confirmation or a skip line as a top-level item; its lines are read untrimmed, so an indented one does not count. */
 export declare function hasScenarioLine(body: string): boolean;
 export declare const HOOK_PLATFORMS: Record<string, Record<string, Handler>>;

package/dist/hooks.js

@@ -1,6 +1,7 @@
 import { P as configSchema, W as parseRef, Y as taskSchema, rt as describeRequest } from "./dist-zSabglPq.js";
-import { A as headerLine, C as loadSessions, Ct as worktreesOf, D as matchGrants, E as grantScope, G as loadHub, O as decorateReply, S as turnReminder, St as findHubRoot, Tt as DATA_DIR, U as HubError, _t as hubFormatVersion, et as taskFile, gt as formatMismatch, i as hostName, it as nodeStorage, j as mayDecorate, k as endsWithMarker, nt as readFrontMatter, rt as readYaml, w as readSession, x as sessionBriefing, xt as currentBranch } from "./host-erQ_Sr8U.js";
-import { n as hubWriter, r as writtenLines } from "./operation-Bf6DtnfD.js";
+import { A as grantScope, D as loadSessions, Dt as worktreesOf, Et as findHubRoot, F as mayDecorate, M as decorateReply, N as endsWithMarker, O as readSession, P as headerLine, S as turnReminder, Tt as currentBranch, Y as loadHub, bt as formatMismatch, ct as nodeStorage, i as hostName, it as taskFile, j as matchGrants, kt as DATA_DIR, ot as readFrontMatter, q as HubError, st as readYaml, x as sessionBriefing, xt as hubFormatVersion } from "./host-BAMZmRy8.js";
+import { n as hubWriter, r as writtenLines } from "./operation-DlR1P_Pt.js";
+import { SCENARIO_LINES, SCENARIO_SKIP_KINDS } from "./facts.js";
 import { resolveFixed, scanCommand, scopedCwd } from "./grant-commands.js";
 import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
@@ -355,26 +356,6 @@ async function decideByGrants(root, { payload, warn, write }) {
 	await logGranted(write, scoped.scope, scan.call, resolved.request, grant, warn);
 	return permission("allow", `授權 ${grant.ref} 涵蓋 ${describeRequest(resolved.request)}`);
 }
-/** The first day the start gate applies; a task created earlier began before the lines below existed. */
-const START_GATE_FROM = "2026-10-19";
-/** The kinds of change that need no acceptance scenarios, as a skip line names them. */
-const SCENARIO_SKIP_KINDS = [
-	"措辭或格式",
-	"照抄或同步版號",
-	"單一設定值",
-	"一句話說得完"
-];
-/** The two lines under a task's 紀錄 that let writing start: the scenarios were confirmed, or the change needs none. */
-const SCENARIO_LINES = {
-	confirmed: {
-		form: "- 驗收情境確認：{使用者怎麼回覆}",
-		pattern: /^- 驗收情境確認：\S/
-	},
-	skipped: {
-		form: `- 驗收情境略過（{${SCENARIO_SKIP_KINDS.join("、")} 之一}）：{理由}`,
-		pattern: new RegExp(`^- 驗收情境略過（(?:${SCENARIO_SKIP_KINDS.join("|")})）：\\S`)
-	}
-};
 /** Whether a task's 紀錄 holds a confirmation or a skip line as a top-level item; its lines are read untrimmed, so an indented one does not count. */
 function hasScenarioLine(body) {
 	const lines = body.split("\n");
@@ -582,4 +563,4 @@ async function runHook(platform, event, ctx) {
 	}
 }
 //#endregion
-export { HOOK_PLATFORMS, SCENARIO_LINES, SCENARIO_SKIP_KINDS, START_GATE_FROM, claudeCodeSessionId, hasScenarioLine, hookFallback, openLink, parsePayload, runHook, subagentTranscript };
+export { HOOK_PLATFORMS, claudeCodeSessionId, hasScenarioLine, hookFallback, openLink, parsePayload, runHook, subagentTranscript };

package/dist/{host-erQ_Sr8U.js → host-BAMZmRy8.js}

@@ -3919,6 +3919,157 @@ function setReminderDigest(root, id, digest) {
 	}));
 }
 //#endregion
+//#region ../core/dist/sync-notices.js
+const SYNC_DIR = "local/sync";
+const NOTICES_FILE = `${SYNC_DIR}/notices.jsonl`;
+const KNOWN_FILE = `${SYNC_DIR}/known.json`;
+const QUEUE_FILE = `${SYNC_DIR}/queue.json`;
+/** Where the notices marked handled by hand are kept, relative to .mainflow/ */
+const HANDLED_FILE = `${SYNC_DIR}/handled.json`;
+/** What sync's known.json writes before a binary file's sha256 (BLOB_PREFIX in packages/sync/src/state.ts) */
+const BLOB_PREFIX = "blob:";
+/** The key a notice is marked handled by. */
+const noticeKey = (n) => `${n.at}|${n.kind}|${n.path}`;
+/** One line of notices.jsonl as a notice; null for a line that is not a warn-level notice. */
+function parseWarn(line) {
+	if (!line.trim()) return null;
+	try {
+		const { at, level, kind, path, message, saved, renumbered } = JSON.parse(line);
+		if (level !== "warn" || typeof at !== "string" || typeof kind !== "string" || typeof message !== "string") return null;
+		const ids = Array.isArray(renumbered) ? renumbered.filter((r) => typeof r?.from === "string" && typeof r?.to === "string") : [];
+		return {
+			at,
+			kind,
+			path: typeof path === "string" ? path : "",
+			message,
+			...typeof saved === "string" ? { saved } : {},
+			...ids.length ? { renumbered: ids.map(({ from, to }) => ({
+				from,
+				to
+			})) } : {}
+		};
+	} catch {
+		return null;
+	}
+}
+function readJson$1(file, fallback) {
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {
+		return fallback;
+	}
+}
+/** A path relative to .mainflow/ that stays inside it. */
+const inside = (path) => path !== "" && !isAbsolute(path) && !path.split("/").some((part) => part === "" || part === "." || part === "..");
+/** The hash known.json would name for the file at `file`, null when it cannot be read. */
+function localHash(file) {
+	let bytes;
+	try {
+		bytes = readFileSync(file);
+	} catch {
+		return null;
+	}
+	try {
+		return contentHash(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+	} catch {
+		return `${BLOB_PREFIX}${createHash("sha256").update(bytes).digest("hex")}`;
+	}
+}
+function readSyncState(data) {
+	const known = readJson$1(join(data, KNOWN_FILE), {}).files ?? {};
+	const entries = readJson$1(join(data, QUEUE_FILE), {}).entries ?? [];
+	const queued = /* @__PURE__ */ new Set();
+	for (const entry of entries) {
+		if (entry.refused !== void 0) continue;
+		if (entry.kind === "op") for (const path of Object.keys(entry.written ?? {})) queued.add(path);
+		else if (typeof entry.path === "string") queued.add(entry.path);
+	}
+	return {
+		known,
+		queued,
+		hashes: /* @__PURE__ */ new Map()
+	};
+}
+/**
+* Kinds telling that a file did not reach the server. Once the file is the confirmed version it did, whenever it last
+* changed: a binary file an older server skipped is uploaded later as it is, without being written again.
+*/
+const UNSENT_KINDS = /* @__PURE__ */ new Set([
+	"skipped-binary",
+	"skipped-large",
+	"binary-text-file",
+	"upload-failing",
+	"download-failed"
+]);
+/**
+* Whether the files show a notice settled. With a saved text, once the saved text is removed. Without one, when the
+* file is the confirmed version (its hash is known.json's) and no write of it waits in the outbox; for the other kinds,
+* whose file is already the confirmed version when the notice is written, it must also have changed after the notice.
+* A file that neither this machine nor known.json has needs nothing either. A notice naming no file is settled by hand
+* only.
+*/
+function settled(data, notice, state) {
+	if (notice.saved !== void 0) return inside(notice.saved) && !existsSync(join(data, notice.saved));
+	if (!inside(notice.path)) return false;
+	const file = join(data, notice.path);
+	const known = state.known[notice.path];
+	if (!existsSync(file)) return known === void 0;
+	if (known === void 0 || state.queued.has(notice.path)) return false;
+	if (!state.hashes.has(file)) state.hashes.set(file, localHash(file));
+	if (state.hashes.get(file) !== known) return false;
+	if (UNSENT_KINDS.has(notice.kind)) return true;
+	try {
+		return statSync(file).mtimeMs > Date.parse(notice.at);
+	} catch {
+		return false;
+	}
+}
+const handledFile = (root) => join(root, DATA_DIR, HANDLED_FILE);
+/** The keys marked handled by hand. */
+function readHandledKeys(root) {
+	const keys = readJson$1(handledFile(root), {}).keys;
+	return keys && typeof keys === "object" && !Array.isArray(keys) ? keys : {};
+}
+/** Every warn-level line of notices.jsonl, newest first, each with how it was handled if it was; unreadable lines are skipped. */
+function readNotices(root) {
+	const data = join(root, DATA_DIR);
+	const file = join(data, NOTICES_FILE);
+	if (!existsSync(file)) return [];
+	const manual = readHandledKeys(root);
+	const state = readSyncState(data);
+	const notices = [];
+	for (const line of readFileSync(file, "utf8").split("\n")) {
+		const notice = parseWarn(line);
+		if (!notice) continue;
+		const handled = noticeKey(notice) in manual ? "manual" : settled(data, notice, state) ? "auto" : void 0;
+		notices.push(handled ? {
+			...notice,
+			handled
+		} : notice);
+	}
+	return notices.reverse();
+}
+/** The notices nobody has handled yet, newest first. */
+const unhandledNotices = (root) => readNotices(root).filter((n) => n.handled === void 0);
+/**
+* Mark notices handled by hand, writing handled.json by a rename so a reader never sees half of it. `keys` names the
+* notices (noticeKey); without it every notice unhandled now is marked. Returns the number marked.
+*/
+function markNoticesHandled(root, keys) {
+	const unhandled = new Set(unhandledNotices(root).map(noticeKey));
+	const wanted = (keys ?? [...unhandled]).filter((key) => unhandled.has(key));
+	if (wanted.length === 0) return 0;
+	const marked = readHandledKeys(root);
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	for (const key of wanted) marked[key] = now;
+	const file = handledFile(root);
+	mkdirSync(dirname(file), { recursive: true });
+	const temp = `${file}.${process.pid}.tmp`;
+	writeFileSync(temp, JSON.stringify({ keys: marked }, null, 1));
+	renameSync(temp, file);
+	return wanted.length;
+}
+//#endregion
 //#region ../core/dist/briefing.js
 function describe(root, ref) {
 	const parsed = parseRef(ref);
@@ -4118,6 +4269,21 @@ function overlapLines(root, session) {
 	}
 	return lines;
 }
+/** How many unhandled sync notices the briefing lists; the page lists the rest. */
+const BRIEFING_NOTICES = 5;
+/** Longest message summary of a notice in the briefing, in characters. */
+const NOTICE_SUMMARY = 80;
+/** The unhandled sync notices for the briefing: up to BRIEFING_NOTICES, the total, and where the page lists them; empty when none. */
+function syncNoticeLines(root) {
+	const notices = unhandledNotices(root);
+	if (notices.length === 0) return [];
+	const summary = (message) => message.length > NOTICE_SUMMARY ? `${message.slice(0, NOTICE_SUMMARY)}…` : message;
+	return [
+		`有 ${notices.length} 條同步提醒還沒處理，寫入者的內容可能沒有照原樣進入 hub。先列最新的 ${Math.min(notices.length, BRIEFING_NOTICES)} 條：`,
+		...notices.slice(0, BRIEFING_NOTICES).map((n) => `- ${n.kind}${n.path ? ` ${n.path}` : ""}：${summary(n.message)}`),
+		`全部 ${notices.length} 條與標記已處理的操作在介面的同步提醒頁（/sync）。`
+	];
+}
 /** Full briefing for the start of a session, after resuming, clearing or compacting. */
 function sessionBriefing(root, session, options) {
 	const { cli } = options;
@@ -4147,6 +4313,7 @@ function sessionBriefing(root, session, options) {
 	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(...syncNoticeLines(root));
 	lines.push("工作方式：", `- 開始一件新工作前，先列進佇列：${cli} action add "<做法>" --serves <m/t#c>。主脈絡還沒拆任務時（查核與規劃階段），--serves 指向解決條件 <m#r>。`, `- 開始做標 doing，做完標 done：${cli} action set <a編號> --status doing。`, `- 勾選 checklist 要附證據：${cli} item check <m/t#c> --evidence <commit、檔案:行號或指令輸出>。`, `- 內容直接寫進檔案：意圖或需求寫進 mainline.md 的內文，任務的目標與完成定義寫進 task.md，選擇寫成決策（${cli} new decision <m> <slug> --title <標題> 建檔後再寫內文）。`, `- 改完 .mainflow/ 的檔案跑 ${cli} check，把它列出的問題修到沒有。`, "- 用完其他 skill 或子流程後，回到上面的目前行動再繼續。", "- 要開主脈絡、拆任務、記決策、延後或收尾時，用 mainflow skill，它依序帶過並告訴你資訊該寫在哪裡。");
 	return lines.join("\n");
 }
@@ -8430,4 +8597,4 @@ function openInApp(hub, target, closeAfterMs = 150) {
 	return true;
 }
 //#endregion
-export { unavailableHubs as $, headerLine as A, scopeOfPath as B, loadSessions as C, worktreesOf as Ct, matchGrants as D, contentHash as Dt, grantScope as E, WriteError as Et, applyOffline as F, loadHub as G, checkHubName as H, renumberRequest as I, mainlineEdges as J, sectionText as K, renumberFiles as L, attributeTrace as M, traceTranscript as N, decorateReply as O, splitFrontMatter as Ot, transcriptTitle as P, remoteMembers as Q, renumberPath as R, turnReminder as S, findHubRoot as St, transcriptPath as T, DATA_DIR as Tt, HubError as U, applyOperation as V, loadConfig as W, memberOfGroup as X, linksInto as Y, refIndex as Z, setArchivedMany as _, hubFormatVersion as _t, openInApp as a, ACCESS_HEADERS as at, duplicateClaimLines as b, requireSlug as bt, siteBlock as c, MAX_FILE_BYTES as ct, migrateHub as d, comparePaths as dt, taskFile as et, retroReport as f, exceedsFileLimit as ft, ARCHIVE_KINDS as g, formatMismatch as gt, RETRY_RULES as h, textBytes as ht, hostName as i, nodeStorage as it, mayDecorate as j, endsWithMarker as k, syncHost as l, ROUTES as lt, receiverFromEnv as m, requestTime as mt, DEFAULT_UI_PORT as n, readFrontMatter as nt, removeDanglingLinks as o, BLOB_HASH as ot, retroReportFromReceiver as p, readsAsText as pt, dependencyGraph as q, caddySites as r, readYaml as rt, removeHostLink as s, MAX_BLOB_BYTES as st, APP_BUNDLE_ID as t, nowMinute as tt, groupPlan as u, SOCKET_MAX_AGE_CLOSE as ut, initHub as v, MAINLINE_FILE as vt, readSession as w, ConflictError as wt, sessionBriefing as x, currentBranch as xt, untilState as y, TASK_FILE as yt, renumberText as z };
+export { linksInto as $, grantScope as A, WriteError as At, renumberRequest as B, HANDLED_FILE as C, TASK_FILE as Ct, loadSessions as D, worktreesOf as Dt, readNotices as E, findHubRoot as Et, mayDecorate as F, applyOperation as G, renumberPath as H, attributeTrace as I, loadConfig as J, checkHubName as K, traceTranscript as L, decorateReply as M, splitFrontMatter as Mt, endsWithMarker as N, readSession as O, ConflictError as Ot, headerLine as P, mainlineEdges as Q, transcriptTitle as R, turnReminder as S, MAINLINE_FILE as St, parseWarn as T, currentBranch as Tt, renumberText as U, renumberFiles as V, scopeOfPath as W, sectionText as X, loadHub as Y, dependencyGraph as Z, setArchivedMany as _, readsAsText as _t, openInApp as a, nowMinute as at, duplicateClaimLines as b, formatMismatch as bt, siteBlock as c, nodeStorage as ct, migrateHub as d, MAX_BLOB_BYTES as dt, memberOfGroup as et, retroReport as f, MAX_FILE_BYTES as ft, ARCHIVE_KINDS as g, exceedsFileLimit as gt, RETRY_RULES as h, comparePaths as ht, hostName as i, taskFile as it, matchGrants as j, contentHash as jt, transcriptPath as k, DATA_DIR as kt, syncHost as l, ACCESS_HEADERS as lt, receiverFromEnv as m, SOCKET_MAX_AGE_CLOSE as mt, DEFAULT_UI_PORT as n, remoteMembers as nt, removeDanglingLinks as o, readFrontMatter as ot, retroReportFromReceiver as p, ROUTES as pt, HubError as q, caddySites as r, unavailableHubs as rt, removeHostLink as s, readYaml as st, APP_BUNDLE_ID as t, refIndex as tt, groupPlan as u, BLOB_HASH as ut, initHub as v, requestTime as vt, markNoticesHandled as w, requireSlug as wt, sessionBriefing as x, hubFormatVersion as xt, untilState as y, textBytes as yt, applyOffline as z };

package/dist/host.js

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

package/dist/{launch-I_JDTAtU.js → launch-CMeKJsNd.js}

@@ -1,4 +1,4 @@
-import { Et as WriteError, Tt as DATA_DIR, i as hostName, l as syncHost, n as DEFAULT_UI_PORT, s as removeHostLink } from "./host-erQ_Sr8U.js";
+import { At as WriteError, i as hostName, kt as DATA_DIR, l as syncHost, n as DEFAULT_UI_PORT, s as removeHostLink } from "./host-BAMZmRy8.js";
 import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -276,7 +276,7 @@ async function launchUi(root, hub, configured, options) {
 		}
 		let server;
 		if (!reuse) {
-			const { serveUi } = await import("./ui-CFtibt8x.js");
+			const { serveUi } = await import("./ui-9uuI4Jif.js");
 			server = await serveUi(root, choice.port);
 			writeUiRecord(root, {
 				port: choice.port,

package/dist/launch.js

@@ -1,2 +1,2 @@
-import { a as networkProbe, c as realRoot, d as withUiLock, i as launchUi, l as startUiInBackground, n as choosePort, o as portCandidates, r as exitCodeFor, s as readUiRecord, t as PORT_SPAN, u as watchHubGone } from "./launch-I_JDTAtU.js";
+import { a as networkProbe, c as realRoot, d as withUiLock, i as launchUi, l as startUiInBackground, n as choosePort, o as portCandidates, r as exitCodeFor, s as readUiRecord, t as PORT_SPAN, u as watchHubGone } from "./launch-CMeKJsNd.js";
 export { PORT_SPAN, choosePort, exitCodeFor, launchUi, networkProbe, portCandidates, readUiRecord, realRoot, startUiInBackground, watchHubGone, withUiLock };

package/dist/{operation-Bf6DtnfD.js → operation-DlR1P_Pt.js}

@@ -1,4 +1,4 @@
-import { B as scopeOfPath, Dt as contentHash, Et as WriteError, F as applyOffline, I as renumberRequest, L as renumberFiles, Ot as splitFrontMatter, R as renumberPath, Tt as DATA_DIR, V as applyOperation, at as ACCESS_HEADERS, ct as MAX_FILE_BYTES, dt as comparePaths, ft as exceedsFileLimit, ht as textBytes, it as nodeStorage, lt as ROUTES, mt as requestTime, ot as BLOB_HASH, pt as readsAsText, st as MAX_BLOB_BYTES, tt as nowMinute, ut as SOCKET_MAX_AGE_CLOSE, wt as ConflictError, z as renumberText } from "./host-erQ_Sr8U.js";
+import { At as WriteError, B as renumberRequest, G as applyOperation, H as renumberPath, Mt as splitFrontMatter, Ot as ConflictError, U as renumberText, V as renumberFiles, W as scopeOfPath, _t as readsAsText, at as nowMinute, ct as nodeStorage, dt as MAX_BLOB_BYTES, ft as MAX_FILE_BYTES, gt as exceedsFileLimit, ht as comparePaths, jt as contentHash, kt as DATA_DIR, lt as ACCESS_HEADERS, mt as SOCKET_MAX_AGE_CLOSE, pt as ROUTES, ut as BLOB_HASH, vt as requestTime, yt as textBytes, z as applyOffline } from "./host-BAMZmRy8.js";
 import { createHash, randomBytes } from "node:crypto";
 import { accessSync, appendFileSync, chmodSync, closeSync, constants, copyFileSync, createReadStream, createWriteStream, existsSync, linkSync, lstatSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/{ui-CFtibt8x.js → ui-9uuI4Jif.js}

@@ -1,8 +1,8 @@
 import { P as configSchema } from "./dist-zSabglPq.js";
-import { C as loadSessions, Et as WriteError, G as loadHub, J as mainlineEdges, K as sectionText, M as attributeTrace, N as traceTranscript, P as transcriptTitle, Q as remoteMembers, T as transcriptPath, Tt as DATA_DIR, U as HubError, W as loadConfig, Y as linksInto, Z as refIndex, _ as setArchivedMany, a as openInApp, g as ARCHIVE_KINDS, q as dependencyGraph, rt as readYaml, u as groupPlan, w as readSession, wt as ConflictError } from "./host-erQ_Sr8U.js";
+import { $ as linksInto, At as WriteError, C as HANDLED_FILE, D as loadSessions, E as readNotices$1, I as attributeTrace, J as loadConfig, L as traceTranscript, O as readSession, Ot as ConflictError, Q as mainlineEdges, R as transcriptTitle, T as parseWarn, X as sectionText, Y as loadHub, Z as dependencyGraph, _ as setArchivedMany, a as openInApp, g as ARCHIVE_KINDS, k as transcriptPath, kt as DATA_DIR, nt as remoteMembers, q as HubError, st as readYaml, tt as refIndex, u as groupPlan, w as markNoticesHandled } from "./host-BAMZmRy8.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { A as isSynced, _ as readDaemon, a as remoteMode, b as readRemote, h as callDaemon, j as syncPaths, k as SYNC_DIR, m as DaemonUnavailable, n as hubWriter, r as writtenLines, y as watchTree } from "./operation-Bf6DtnfD.js";
-import { c as realRoot, f as CLI_VERSION, s as readUiRecord } from "./launch-I_JDTAtU.js";
+import { A as isSynced, _ as readDaemon, a as remoteMode, b as readRemote, h as callDaemon, j as syncPaths, k as SYNC_DIR, m as DaemonUnavailable, n as hubWriter, r as writtenLines, y as watchTree } from "./operation-DlR1P_Pt.js";
+import { c as realRoot, f as CLI_VERSION, s as readUiRecord } from "./launch-CMeKJsNd.js";
 import { createRequire } from "node:module";
 import { closeSync, existsSync, lstatSync, openSync, readFileSync, readSync, realpathSync, statSync } from "node:fs";
 import { basename, dirname, extname, join, normalize, relative, resolve, sep } from "node:path";
@@ -414,6 +414,11 @@ function createApp(root, options = {}) {
 		running: readDaemon(root) !== null,
 		notices: readNotices(root)
 	}));
+	app.post("/api/sync/handled", async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		if (body.key !== void 0 && typeof body.key !== "string") return c.json({ error: "key must be a string" }, 400);
+		return c.json({ marked: markNoticesHandled(root, body.key === void 0 ? void 0 : [body.key]) });
+	});
 	app.get("/api/sync/conflicts/:name", async (c) => {
 		const name = c.req.param("name");
 		const saved = `${SYNC_DIR}/conflicts/${name}`;
@@ -448,38 +453,8 @@ function runsElsewhere(root, session) {
 	if (existsSync(session.cwd)) return false;
 	return !(session.transcript && existsSync(transcriptPath(root, session.transcript)));
 }
-/** Every warn-level line of .mainflow/local/sync/notices.jsonl, newest first; unreadable lines are skipped. */
-function readNotices(root) {
-	const file = syncPaths(root).notices;
-	if (!existsSync(file)) return [];
-	const notices = [];
-	for (const line of readFileSync(file, "utf8").split("\n")) {
-		const notice = parseWarn(line);
-		if (notice) notices.push(notice);
-	}
-	return notices.reverse();
-}
-function parseWarn(line) {
-	if (!line.trim()) return null;
-	try {
-		const { at, level, kind, path, message, saved, renumbered } = JSON.parse(line);
-		if (level !== "warn" || typeof at !== "string" || typeof kind !== "string" || typeof message !== "string") return null;
-		const ids = Array.isArray(renumbered) ? renumbered.filter((r) => typeof r?.from === "string" && typeof r?.to === "string") : [];
-		return {
-			at,
-			kind,
-			path: typeof path === "string" ? path : "",
-			message,
-			...typeof saved === "string" ? { saved } : {},
-			...ids.length ? { renumbered: ids.map(({ from, to }) => ({
-				from,
-				to
-			})) } : {}
-		};
-	} catch {
-		return null;
-	}
-}
+/** The notices of the sync client as the interface lists them (core reads the files and tells which are handled). */
+const readNotices = (root) => readNotices$1(root);
 /**
 * Whether `file` really is inside the hub's .mainflow/ once every symbolic link on the way is followed. A file that
 * does not exist yet is judged by the deepest directory above it that does.
@@ -573,6 +548,7 @@ async function fetchFromServer(root, path) {
 function eventOf(name) {
 	const path = name.split(sep).join("/");
 	if (path === `local/sync/notices.jsonl`) return "notices";
+	if (path === HANDLED_FILE) return "handled";
 	if (path === `local/sync/remote.json`) return "change";
 	if (path === "local/sync" || path.startsWith(`local/sync/`)) return null;
 	if (path.endsWith("write.lock") || path.endsWith(".tmp")) return null;
@@ -605,14 +581,17 @@ var HubWatch = class {
 	watcher;
 	/** How far notices.jsonl has been read */
 	offset;
+	/** handled.json as last told of, so the several events of one write tell the interface once */
+	handledSeen;
 	constructor(root) {
 		this.root = root;
 		this.offset = sizeOf(syncPaths(root).notices);
+		this.handledSeen = this.handledSignature();
 		this.watcher = watchDataDir(join(root, DATA_DIR), (name) => {
 			const kind = eventOf(name);
-			if (kind === null || kind === "notices" && !this.newWarnings()) return;
+			if (kind === null || kind === "notices" && !this.newWarnings() || kind === "handled" && !this.handledChanged()) return;
 			const event = {
-				kind: kind === "notices" ? "notice" : kind,
+				kind: kind === "notices" || kind === "handled" ? "notice" : kind,
 				name
 			};
 			for (const notify of this.listeners) notify(event);
@@ -645,6 +624,22 @@ var HubWatch = class {
 		this.offset += complete;
 		return buffer.subarray(0, complete).toString("utf8").split("\n").some((line) => parseWarn(line) !== null);
 	}
+	/** handled.json's time and size, empty while there is none. */
+	handledSignature() {
+		try {
+			const info = statSync(join(this.root, DATA_DIR, HANDLED_FILE));
+			return `${info.mtimeMs}:${info.size}`;
+		} catch {
+			return "";
+		}
+	}
+	/** Whether handled.json changed since the interface was last told of it. */
+	handledChanged() {
+		const signature = this.handledSignature();
+		if (signature === this.handledSeen) return false;
+		this.handledSeen = signature;
+		return true;
+	}
 };
 const watches = /* @__PURE__ */ new Map();
 /** The size of a file, 0 when it does not exist; it may be removed between any two calls, so it is read in one. */