mainflow 0.33.0 → 0.34.0-alpha.1

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { B as parseRef, H as refExample, V as parseUntil, Y as stampMs, k as UNTIL_FORMS } from "./dist-IdbnCDqM.js";
-import { $ as MAX_FILE_BYTES, B as checkHubName, H as loadHub, S as readSession, V as HubError, Y as nodeStorage, _ as untilState, ct as TASK_FILE, d as retroReportFromReceiver, dt as findHubRoot, f as receiverFromEnv, g as initHub, ht as WriteError, l as migrateHub, lt as requireSlug, mt as DATA_DIR, p as RETRY_RULES, q as nowMinute, st as MAINLINE_FILE, u as retroReport, v as duplicateClaimLines, x as loadSessions, y as sessionBriefing, z as applyOperation } from "./host-CObkJQmr.js";
+import { $ as MAX_FILE_BYTES, B as checkHubName, H as loadHub, S as readSession, V as HubError, Y as nodeStorage, _ as untilState, ct as TASK_FILE, d as retroReportFromReceiver, dt as findHubRoot, f as receiverFromEnv, g as initHub, ht as WriteError, l as migrateHub, lt as requireSlug, mt as DATA_DIR, p as RETRY_RULES, q as nowMinute, st as MAINLINE_FILE, u as retroReport, v as duplicateClaimLines, x as loadSessions, y as sessionBriefing, z as applyOperation } from "./host-79T-_NMu.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { A as syncPaths, C as ENV, D as SETTINGS_FILE, E as syncSettings, S as ServerError, T as hubName, _ as readDaemon, a as remoteMode, b as oversizedFiles, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, 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 earlierToken, x as ServerApi, y as readRemote } from "./operation-B2pq2Q9z.js";
+import { A as syncPaths, C as ENV, D as SETTINGS_FILE, E as syncSettings, S as ServerError, T as hubName, _ as readDaemon, a as remoteMode, b as oversizedFiles, c as planAnnounce, d as toolCallOf, f as startDaemon, g as probeDaemon, h as callDaemon, i as queuedCount, 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 earlierToken, x as ServerApi, y as readRemote } from "./operation--fJnUqvA.js";
 import { COMMAND_SPECS, OPTIONS } from "./facts.js";
 import { hookFallback, parsePayload, runHook } from "./hooks.js";
-import { c as watchHubGone, l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-BemxyV9P.js";
+import { c as watchHubGone, l as CLI_VERSION, r as launchUi, s as startUiInBackground } from "./launch-DQVyIbpf.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

@@ -336,7 +336,7 @@ export declare const COMMAND_SPECS: {
   };
   readonly retro: {
     readonly usage: 'retro <m> [--json]';
-    readonly summary: 'Read the Claude Code transcripts of the sessions that served a mainline, and their subagents\', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only. With MAINFLOW_TELEMETRY_URL and MAINFLOW_TELEMETRY_TOKEN set it also reads the measurement receiver\'s export: billed cost per request, and the run time of every hook, the silent ones too';
+    readonly summary: 'Read the Claude Code transcripts of the sessions that served a mainline, and their subagents\', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only. With MAINFLOW_TELEMETRY_URL, MAINFLOW_TELEMETRY_ACCESS_CLIENT_ID and MAINFLOW_TELEMETRY_ACCESS_CLIENT_SECRET (a Cloudflare Access service token) set it also reads the measurement receiver\'s export: billed cost per request, and the run time of every hook, the silent ones too; sessions whose transcript is not on this machine are downloaded from the receiver into .mainflow/local/transcripts/ first';
     readonly args: 1;
     readonly needsHub: true;
   };

package/dist/facts.js

@@ -326,7 +326,7 @@ const COMMAND_SPECS = {
 	},
 	retro: {
 		usage: "retro <m> [--json]",
-		summary: "Read the Claude Code transcripts of the sessions that served a mainline, and their subagents', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only. With MAINFLOW_TELEMETRY_URL and MAINFLOW_TELEMETRY_TOKEN set it also reads the measurement receiver's export: billed cost per request, and the run time of every hook, the silent ones too",
+		summary: "Read the Claude Code transcripts of the sessions that served a mainline, and their subagents', into estimated list-price cost (per model, opening context, cache hit rate, hook injections) and candidates for where work went wrong (tool errors, rerun Bash commands, hook injections followed by no tool call, blocks, pauses over 5 minutes, failed completion checks); read-only. With MAINFLOW_TELEMETRY_URL, MAINFLOW_TELEMETRY_ACCESS_CLIENT_ID and MAINFLOW_TELEMETRY_ACCESS_CLIENT_SECRET (a Cloudflare Access service token) set it also reads the measurement receiver's export: billed cost per request, and the run time of every hook, the silent ones too; sessions whose transcript is not on this machine are downloaded from the receiver into .mainflow/local/transcripts/ first",
 		args: 1,
 		needsHub: true
 	},

package/dist/hooks.js

@@ -1,6 +1,6 @@
 import { $ as describeRequest, j as configSchema } from "./dist-IdbnCDqM.js";
-import { D as endsWithMarker, E as decorateReply, H as loadHub, J as readYaml, O as headerLine, S as readSession, T as matchGrants, V as HubError, b as turnReminder, dt as findHubRoot, ft as worktreesOf, i as hostName, k as mayDecorate, mt as DATA_DIR, ut as currentBranch, w as grantScope, x as loadSessions, y as sessionBriefing } from "./host-CObkJQmr.js";
-import { n as hubWriter, r as writtenLines } from "./operation-B2pq2Q9z.js";
+import { D as endsWithMarker, E as decorateReply, H as loadHub, J as readYaml, O as headerLine, S as readSession, T as matchGrants, V as HubError, b as turnReminder, dt as findHubRoot, ft as worktreesOf, i as hostName, k as mayDecorate, mt as DATA_DIR, ut as currentBranch, w as grantScope, x as loadSessions, y as sessionBriefing } from "./host-79T-_NMu.js";
+import { n as hubWriter, r as writtenLines } from "./operation--fJnUqvA.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";

package/dist/{host-CObkJQmr.js → host-79T-_NMu.js}

@@ -7,7 +7,7 @@ import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { parse as parse$1, stringify } from "yaml";
 import { homedir } from "node:os";
 import { performance } from "node:perf_hooks";
-import { gunzipSync } from "node:zlib";
+import { gunzipSync, inflateRawSync } from "node:zlib";
 //#region ../core/dist/ops/document.js
 const DATA_DIR = ".mainflow";
 const ENTRY_DIR = /^([mtdif]\d{3})-(.+)$/;
@@ -3774,6 +3774,8 @@ async function setArchivedMany(kind, ids, archived, write) {
 //#endregion
 //#region ../core/dist/retro/util.js
 const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** A 2xx response. Requests use redirect 'manual', so a 3xx (Access sending the caller to its login page) is a failure. */
+const isOk = (response) => response.status >= 200 && response.status < 300;
 const str = (v) => typeof v === "string" && v ? v : void 0;
 const finite = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
 /** Appends `items` to `into` one by one. */
@@ -6334,19 +6336,246 @@ function pairInjection(injection, own, toolUseId, successes, stopSummaries) {
 	if (tag?.reason) return { reason: tag.reason };
 }
 //#endregion
+//#region ../core/dist/retro/transcripts.js
+const PAGE_LIMIT = 1e3;
+const MAX_BUNDLE_KEYS$1 = 40;
+/** Rounds of re-asking for the keys a bundle deferred, so a receiver that never delivers cannot loop forever. */
+const MAX_DEFERRED_ROUNDS = 20;
+const TEXT_SHOWN$1 = 200;
+const SAFE_ID = /^[\w.-]+$/;
+const SAFE_PATH = /^(?:[\w.-]+\.jsonl|subagents\/[\w.-]+\.(?:jsonl|meta\.json))$/;
+/** The file path under a session and the offset a stored key holds: transcripts/{sid}/{path}/{offset}.gz */
+function parseTranscriptKey(sid, key) {
+	const m = new RegExp(`^transcripts/${sid.replace(/[.]/g, "\\.")}/(.+)/(\\d{1,15})\\.gz$`).exec(key);
+	return m && SAFE_PATH.test(m[1]) ? {
+		path: m[1],
+		offset: Number(m[2])
+	} : void 0;
+}
+/** Where a stored path lands: the main transcript beside the directory, the rest under <dir>/{sid}/. */
+function transcriptFile(want, path) {
+	return path.includes("/") ? join(want.dir, want.sid, path) : join(want.dir, path);
+}
+/**
+* The segments of one file in use, from offset 0 on and as far as they run without a gap; a segment overlapping the
+* ones before it (a resend) only adds what lies past them. `length` of a segment is unknown (undefined) before it
+* is downloaded unless the listing gave rawLength, in which case `end` is undefined.
+*/
+function joined(segments, lengthOf) {
+	const used = [];
+	let end = 0;
+	for (const s of [...segments].sort((a, b) => a.offset - b.offset)) {
+		if (end === void 0) {
+			used.push(s);
+			continue;
+		}
+		if (s.offset > end) return {
+			used,
+			end,
+			gapAt: s.offset
+		};
+		used.push(s);
+		const length = lengthOf(s);
+		end = length === void 0 ? void 0 : Math.max(end, s.offset + length);
+	}
+	return {
+		used,
+		end
+	};
+}
+/** The size the receiver's segments add up to for each file, or undefined when a segment of it has no rawLength. */
+function expectedSizes(sid, listed) {
+	const byPath = /* @__PURE__ */ new Map();
+	for (const o of listed) {
+		const parsed = parseTranscriptKey(sid, o.key);
+		if (parsed) byPath.set(parsed.path, [...byPath.get(parsed.path) ?? [], {
+			...o,
+			offset: parsed.offset
+		}]);
+	}
+	return new Map([...byPath].map(([path, segments]) => [path, joined(segments, (s) => s.rawLength).end]));
+}
+/** Cuts the gzip members out of a bundle, one per key: a member is a header, a deflate stream and an 8-byte trailer. */
+function members(bytes, count) {
+	const out = [];
+	let at = 0;
+	while (out.length < count && at < bytes.length) {
+		if (bytes[at] !== 31 || bytes[at + 1] !== 139) throw new Error("bundle is not gzip members");
+		const flags = bytes[at + 3];
+		let p = at + 10;
+		if (flags & 4) p += 2 + bytes.readUInt16LE(p);
+		if (flags & 8) p = bytes.indexOf(0, p) + 1;
+		if (flags & 16) p = bytes.indexOf(0, p) + 1;
+		if (flags & 2) p += 2;
+		const { buffer, engine } = inflateRawSync(bytes.subarray(p), { info: true });
+		out.push(buffer);
+		at = p + engine.bytesWritten + 8;
+	}
+	if (out.length !== count) throw new Error(`bundle holds ${out.length} objects, expected ${count}`);
+	return out;
+}
+/**
+* Brings the transcripts of the wanted sessions into their directories. A session whose files are all there and as
+* long as the receiver's segments add up to (by rawLength) is not downloaded again; with no rawLength it always is.
+*/
+async function fetchTranscripts(source, wanted) {
+	const doFetch = source.fetch ?? globalThis.fetch;
+	const result = {
+		fetched: [],
+		warnings: [],
+		requests: 0
+	};
+	const scrub = (text) => source.accessClientSecret ? text.split(source.accessClientSecret).join("***") : text;
+	const warn = (text) => result.warnings.push(scrub(text));
+	let origin;
+	try {
+		const base = new URL(source.url);
+		if (base.protocol !== "https:" && base.protocol !== "http:") throw new Error("not http");
+		origin = base.origin;
+	} catch {
+		warn("接收端網址不是 http 或 https 網址，沒有下載對話紀錄");
+		return result;
+	}
+	const headers = {
+		"cf-access-client-id": source.accessClientId,
+		"cf-access-client-secret": source.accessClientSecret
+	};
+	const failure = async (response) => {
+		let text = "";
+		try {
+			text = (await response.text()).replace(/\s+/g, " ").trim().slice(0, TEXT_SHOWN$1);
+		} catch {}
+		return `HTTP ${response.status}${text ? ` ${text}` : ""}`;
+	};
+	const thrown = (error) => {
+		const e = error;
+		const cause = e.cause?.code ?? e.cause?.message;
+		return `${e.message ?? String(error)}${cause ? `（${cause}）` : ""}`;
+	};
+	const list = async (sid) => {
+		const objects = [];
+		let cursor;
+		for (let page = 0; page < PAGE_LIMIT; page++) {
+			const u = new URL(`/v1/transcripts/${encodeURIComponent(sid)}`, origin);
+			if (cursor) u.searchParams.set("cursor", cursor);
+			result.requests += 1;
+			const response = await doFetch(u, {
+				headers,
+				redirect: "manual"
+			});
+			if (!isOk(response)) throw new Error(`物件清單讀取失敗：${await failure(response)}`);
+			const body = await response.json();
+			if (!isObject(body) || !Array.isArray(body.objects)) throw new Error("物件清單格式不對");
+			for (const o of body.objects) {
+				if (!isObject(o) || typeof o.key !== "string") continue;
+				const parsed = parseTranscriptKey(sid, o.key);
+				if (parsed) objects.push({
+					key: o.key,
+					offset: parsed.offset,
+					...typeof o.rawLength === "number" ? { rawLength: o.rawLength } : {}
+				});
+			}
+			cursor = typeof body.next === "string" && body.next ? body.next : void 0;
+			if (!cursor) return objects;
+		}
+		throw new Error(`物件清單超過 ${PAGE_LIMIT} 頁`);
+	};
+	/** The bytes of each key, asking again for the keys a bundle deferred. */
+	const download = async (sid, keys) => {
+		const got = /* @__PURE__ */ new Map();
+		let pending = [...keys];
+		for (let round = 0; pending.length && round < MAX_DEFERRED_ROUNDS; round++) {
+			const deferred = [];
+			for (let i = 0; i < pending.length; i += MAX_BUNDLE_KEYS$1) {
+				const batch = pending.slice(i, i + MAX_BUNDLE_KEYS$1);
+				result.requests += 1;
+				const response = await doFetch(new URL(`/v1/transcripts/${encodeURIComponent(sid)}/bundle`, origin), {
+					method: "POST",
+					headers: {
+						...headers,
+						"content-type": "application/json"
+					},
+					redirect: "manual",
+					body: JSON.stringify({ keys: batch })
+				});
+				if (!isOk(response)) throw new Error(`物件下載失敗：${await failure(response)}`);
+				const split = (name) => (response.headers.get(name) ?? "").split(",").map((k) => k.trim()).filter(Boolean);
+				const absent = new Set(split("x-objects-missing"));
+				const later = new Set(split("x-objects-deferred"));
+				if (absent.size) warn(`會話 ${sid} 的 ${absent.size} 個物件接收端找不到，略過`);
+				const present = batch.filter((k) => !absent.has(k) && !later.has(k));
+				const parts = members(Buffer.from(await response.arrayBuffer()), present.length);
+				present.forEach((k, j) => got.set(k, parts[j]));
+				deferred.push(...batch.filter((k) => later.has(k)));
+			}
+			pending = deferred;
+		}
+		if (pending.length) throw new Error(`${pending.length} 個物件一直沒有取回`);
+		return got;
+	};
+	for (const want of wanted) {
+		const { sid } = want;
+		if (!SAFE_ID.test(sid)) continue;
+		try {
+			const listed = await list(sid);
+			if (listed.length === 0) continue;
+			if ([...expectedSizes(sid, listed)].every(([path, size]) => {
+				const file = transcriptFile(want, path);
+				return size !== void 0 && existsSync(file) && statSync(file).size === size;
+			})) continue;
+			const byPath = /* @__PURE__ */ new Map();
+			for (const o of listed) {
+				const { path } = parseTranscriptKey(sid, o.key);
+				byPath.set(path, [...byPath.get(path) ?? [], {
+					key: o.key,
+					offset: o.offset
+				}]);
+			}
+			const bytes = await download(sid, listed.map((o) => o.key));
+			const files = /* @__PURE__ */ new Map();
+			for (const [path, segments] of byPath) {
+				const { used, gapAt } = joined(segments.filter((s) => bytes.has(s.key)).map((s) => ({
+					...s,
+					data: bytes.get(s.key)
+				})), (s) => s.data.length);
+				if (gapAt !== void 0) warn(`會話 ${sid} 的 ${path} 在位置 ${gapAt} 之前的分段不連續，只用前面已有的部分`);
+				const parts = [];
+				let end = 0;
+				for (const s of used) {
+					if (s.offset + s.data.length > end) parts.push(s.data.subarray(end - s.offset));
+					end = Math.max(end, s.offset + s.data.length);
+				}
+				if (parts.length) files.set(path, Buffer.concat(parts));
+			}
+			for (const [path, data] of files) {
+				const file = transcriptFile(want, path);
+				mkdirSync(dirname(file), { recursive: true });
+				writeFileSync(file, data);
+			}
+			if (files.size) result.fetched.push(sid);
+		} catch (error) {
+			warn(`會話 ${sid} 的對話紀錄下載失敗：${thrown(error)}`);
+		}
+	}
+	return result;
+}
+//#endregion
 //#region ../core/dist/retro/receiver.js
-/** The environment variables a command reads the receiver from. Neither set: the retro does not read the receiver. */
+/** The environment variables a command reads the receiver from. None set: the retro does not read the receiver. */
 const RECEIVER_ENV = {
 	url: "MAINFLOW_TELEMETRY_URL",
-	token: "MAINFLOW_TELEMETRY_TOKEN"
+	accessClientId: "MAINFLOW_TELEMETRY_ACCESS_CLIENT_ID",
+	accessClientSecret: "MAINFLOW_TELEMETRY_ACCESS_CLIENT_SECRET"
 };
-/** The receiver named by the environment, or null when neither variable is set. One without the other is passed on, so the report says which is missing. */
+/** The receiver named by the environment, or null when none of the three variables is set. A partial set is passed on, so the report says which is missing. */
 function receiverFromEnv(env) {
 	const url = env[RECEIVER_ENV.url]?.trim() ?? "";
-	const token = env[RECEIVER_ENV.token]?.trim() ?? "";
-	return url || token ? {
+	const accessClientId = env[RECEIVER_ENV.accessClientId]?.trim() ?? "";
+	const accessClientSecret = env[RECEIVER_ENV.accessClientSecret]?.trim() ?? "";
+	return url || accessClientId || accessClientSecret ? {
 		url,
-		token
+		accessClientId,
+		accessClientSecret
 	} : null;
 }
 /** Longest window one export covers. */
@@ -6393,7 +6622,7 @@ function windows(scope) {
 }
 async function readReceiver(config, scopes) {
 	const doFetch = config.fetch ?? globalThis.fetch;
-	const scrub = (text) => config.token ? text.split(config.token).join("***") : text;
+	const scrub = (text) => config.accessClientSecret ? text.split(config.accessClientSecret).join("***") : text;
 	const problems = [];
 	const problem = (text) => problems.push(scrub(text));
 	const unread = (origin) => ({
@@ -6406,8 +6635,13 @@ async function readReceiver(config, scopes) {
 		requests: 0,
 		problems
 	});
-	if (!config.url || !config.token) {
-		problems.push(`${!config.url ? RECEIVER_ENV.url : RECEIVER_ENV.token} 沒有設定，沒有讀取接收端`);
+	const absent = [
+		...config.url ? [] : [RECEIVER_ENV.url],
+		...config.accessClientId ? [] : [RECEIVER_ENV.accessClientId],
+		...config.accessClientSecret ? [] : [RECEIVER_ENV.accessClientSecret]
+	];
+	if (absent.length) {
+		problems.push(`${absent.join("、")} 沒有設定，沒有讀取接收端`);
 		return unread("");
 	}
 	let base;
@@ -6419,7 +6653,10 @@ async function readReceiver(config, scopes) {
 		return unread("");
 	}
 	const origin = base.origin;
-	const auth = { authorization: `Bearer ${config.token}` };
+	const auth = {
+		"cf-access-client-id": config.accessClientId,
+		"cf-access-client-secret": config.accessClientSecret
+	};
 	let requests = 0;
 	/** The reason a request failed: its status and the start of its text, or the network error. */
 	const failure = async (response) => {
@@ -6447,8 +6684,11 @@ async function readReceiver(config, scopes) {
 				u.searchParams.set("sid", scope.sessionId);
 				if (cursor) u.searchParams.set("cursor", cursor);
 				requests += 1;
-				const response = await doFetch(u, { headers: auth });
-				if (!response.ok) {
+				const response = await doFetch(u, {
+					headers: auth,
+					redirect: "manual"
+				});
+				if (!isOk(response)) {
 					problem(`${where}的物件清單讀取失敗：${await failure(response)}，這段的資料缺`);
 					break;
 				}
@@ -6484,9 +6724,10 @@ async function readReceiver(config, scopes) {
 					...auth,
 					"content-type": "application/json"
 				},
+				redirect: "manual",
 				body: JSON.stringify({ keys: batch })
 			});
-			if (!response.ok) {
+			if (!isOk(response)) {
 				problem(`${batch.length} 個物件下載失敗（${keysText(batch)}）：${await failure(response)}，這些列缺`);
 				append(missing, batch);
 				return;
@@ -6756,6 +6997,29 @@ const secondText = (ms) => {
 	const d = new Date(ms);
 	return `${d.toLocaleDateString("sv-SE")}T${d.toTimeString().slice(0, 8)}`;
 };
+/** Where transcripts fetched from the receiver are kept: in the hub's local directory, which the hub ignores. */
+const transcriptCache = (root) => join(root, ".mainflow/local/transcripts");
+/** The transcript to read: the recorded path when the file is there, else the copy fetched from the receiver, else the recorded path. */
+function transcriptOf(root, transcript) {
+	const recorded = transcriptPath(root, transcript);
+	if (existsSync(recorded)) return recorded;
+	const cached = join(transcriptCache(root), basename(recorded));
+	return existsSync(cached) ? cached : recorded;
+}
+/** Sessions serving the mainline whose recorded transcript is not on this machine, as the receiver knows them. */
+function missingTranscripts(root, mainlineId) {
+	const wanted = /* @__PURE__ */ new Map();
+	for (const s of loadSessions(root).sessions) {
+		if (!s.transcript || !s.actions.some((a) => servesMainline(a, mainlineId))) continue;
+		if (existsSync(transcriptPath(root, s.transcript))) continue;
+		const sid = basename(s.transcript, ".jsonl");
+		wanted.set(sid, {
+			sid,
+			dir: transcriptCache(root)
+		});
+	}
+	return [...wanted.values()];
+}
 /** Subagent transcripts Claude Code keeps beside a session's: <dir>/<session>/subagents/*.jsonl. */
 function subagentFiles(transcript) {
 	const dir = join(transcript.replace(/\.jsonl$/, ""), "subagents");
@@ -6888,7 +7152,7 @@ function readGroups(root, mainlineId, windowOf) {
 	};
 	const ordered = [...serving].sort((a, b) => Number(Boolean(a.delegatedFrom)) - Number(Boolean(b.delegatedFrom)));
 	for (const s of ordered) {
-		const file = s.transcript ? transcriptPath(root, s.transcript) : void 0;
+		const file = s.transcript ? transcriptOf(root, s.transcript) : void 0;
 		if (s.delegatedFrom) {
 			if (!file || seen.has(file)) continue;
 			const parent = groups.find((g) => g.session === s.delegatedFrom);
@@ -6949,6 +7213,18 @@ function retroReport(root, mainlineId, options = {}) {
 * `measurements.problems`.
 */
 async function retroReportFromReceiver(root, mainlineId, receiver, options = {}) {
+	if (receiver.url && receiver.accessClientId && receiver.accessClientSecret) {
+		const wanted = missingTranscripts(root, mainlineId);
+		if (wanted.length) {
+			const { warnings } = await fetchTranscripts({
+				url: receiver.url,
+				accessClientId: receiver.accessClientId,
+				accessClientSecret: receiver.accessClientSecret,
+				...receiver.fetch ? { fetch: receiver.fetch } : {}
+			}, wanted);
+			for (const line of warnings) (receiver.warn ?? ((l) => process.stderr.write(`${l}\n`)))(line);
+		}
+	}
 	const read = readRetro(root, mainlineId, options);
 	const t = performance.now();
 	const exported = await readReceiver(receiver, receiverScopes(read.groups));

package/dist/host.js

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

package/dist/{launch-BemxyV9P.js → launch-DQVyIbpf.js}

@@ -1,4 +1,4 @@
-import { c as syncHost, ht as WriteError, i as hostName, mt as DATA_DIR, n as DEFAULT_UI_PORT, o as removeHostLink } from "./host-CObkJQmr.js";
+import { c as syncHost, ht as WriteError, i as hostName, mt as DATA_DIR, n as DEFAULT_UI_PORT, o as removeHostLink } from "./host-79T-_NMu.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
@@ -176,7 +176,7 @@ async function launchUi(root, hub, configured, options) {
 	}
 	let server;
 	if (!reuse) {
-		const { serveUi } = await import("./ui-CFLjhYJ9.js");
+		const { serveUi } = await import("./ui-BcXPk-0P.js");
 		server = await serveUi(root, choice.port);
 		writeUiRecord(root, {
 			port: choice.port,

package/dist/launch.js

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

package/dist/{operation-B2pq2Q9z.js → operation--fJnUqvA.js}

@@ -1,4 +1,4 @@
-import { $ as MAX_FILE_BYTES, F as renumberFiles, I as renumberPath, L as renumberText, N as applyOffline, P as renumberRequest, Q as MAX_BLOB_BYTES, R as scopeOfPath, X as ACCESS_HEADERS, Y as nodeStorage, Z as BLOB_HASH, _t as splitFrontMatter, at as requestTime, et as ROUTES, gt as contentHash, ht as WriteError, it as readsAsText, mt as DATA_DIR, nt as comparePaths, ot as textBytes, pt as ConflictError, q as nowMinute, rt as exceedsFileLimit, tt as SOCKET_MAX_AGE_CLOSE, z as applyOperation } from "./host-CObkJQmr.js";
+import { $ as MAX_FILE_BYTES, F as renumberFiles, I as renumberPath, L as renumberText, N as applyOffline, P as renumberRequest, Q as MAX_BLOB_BYTES, R as scopeOfPath, X as ACCESS_HEADERS, Y as nodeStorage, Z as BLOB_HASH, _t as splitFrontMatter, at as requestTime, et as ROUTES, gt as contentHash, ht as WriteError, it as readsAsText, mt as DATA_DIR, nt as comparePaths, ot as textBytes, pt as ConflictError, q as nowMinute, rt as exceedsFileLimit, tt as SOCKET_MAX_AGE_CLOSE, z as applyOperation } from "./host-79T-_NMu.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-CFLjhYJ9.js → ui-BcXPk-0P.js}

@@ -1,8 +1,8 @@
 import { j as configSchema } from "./dist-IdbnCDqM.js";
-import { A as attributeTrace, C as transcriptPath, G as linksInto, H as loadHub, J as readYaml, K as refIndex, M as transcriptTitle, S as readSession, U as dependencyGraph, W as mainlineEdges, a as openInApp, h as setArchivedMany, ht as WriteError, j as traceTranscript, m as ARCHIVE_KINDS, mt as DATA_DIR, pt as ConflictError, x as loadSessions } from "./host-CObkJQmr.js";
+import { A as attributeTrace, C as transcriptPath, G as linksInto, H as loadHub, J as readYaml, K as refIndex, M as transcriptTitle, S as readSession, U as dependencyGraph, W as mainlineEdges, a as openInApp, h as setArchivedMany, ht as WriteError, j as traceTranscript, m as ARCHIVE_KINDS, mt as DATA_DIR, pt as ConflictError, x as loadSessions } from "./host-79T-_NMu.js";
 import { t as listProgress } from "./progress-1BfPg2zN.js";
-import { A as syncPaths, O as SYNC_DIR, _ as readDaemon, a as remoteMode, h as callDaemon, k as isSynced, m as DaemonUnavailable, n as hubWriter, r as writtenLines, y as readRemote } from "./operation-B2pq2Q9z.js";
-import { l as CLI_VERSION } from "./launch-BemxyV9P.js";
+import { A as syncPaths, O as SYNC_DIR, _ as readDaemon, a as remoteMode, h as callDaemon, k as isSynced, m as DaemonUnavailable, n as hubWriter, r as writtenLines, y as readRemote } from "./operation--fJnUqvA.js";
+import { l as CLI_VERSION } from "./launch-DQVyIbpf.js";
 import { createRequire } from "node:module";
 import { closeSync, existsSync, lstatSync, openSync, readFileSync, readSync, realpathSync, statSync, watch } from "node:fs";
 import { basename, dirname, extname, join, normalize, relative, resolve, sep } from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mainflow",
-  "version": "0.33.0",
+  "version": "0.34.0-alpha.1",
   "description": "本機多 AI 協作的主脈絡任務管理：CLI 與介面",
   "license": "MIT",
   "type": "module",