@ghfs/cli 0.1.0 → 0.1.1

package/dist/{server-n1FLF8Xo.mjs → server-BwSU4kqr.mjs}

@@ -1,8 +1,9 @@
-import { a as formatIssueNumber, n as normalizeReactions, t as createRepositoryProvider } from "./factory-DypZ8oi9.mjs";
+import { a as formatIssueNumber, c as CodedError, d as diagnostics, l as formatInline, n as normalizeReactions, t as createRepositoryProvider, u as log } from "./factory-DmX3S7tf.mjs";
 import { distDir } from "./dir.mjs";
 import process from "node:process";
 import { basename, dirname, isAbsolute, join, resolve } from "pathe";
-import { spawn } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
 import { existsSync } from "node:fs";
 import { createJiti } from "jiti";
 import { access, mkdir, readFile, readdir, rename, rm, stat, watch, writeFile } from "node:fs/promises";
@@ -16,6 +17,7 @@ import { getPort } from "get-port-please";
 import { createApp, createRouter, eventHandler, serveStatic, setResponseHeader, setResponseStatus, toNodeListener } from "h3";
 import { parse as parse$1, stringify as stringify$1 } from "structured-clone-es";
 import { WebSocketServer } from "ws";
+import { fileURLToPath } from "node:url";
 import { hash } from "ohash";
 //#region src/constants.ts
 const CONFIG_FILE_CANDIDATES = [
@@ -359,7 +361,7 @@ async function readAndValidateExecuteFileWithSource(path) {
 	try {
 		parsed = parse(raw || "[]") || [];
 	} catch (error) {
-		throw new Error(`Failed to parse execute YAML: ${error.message}`);
+		throw new CodedError(log.GHFS0105({ detail: error.message }, { cause: error }));
 	}
 	const parsedResult = v.safeParse(executeFileSchema, parsed);
 	if (!parsedResult.success) {
@@ -367,12 +369,12 @@ async function readAndValidateExecuteFileWithSource(path) {
 			const path = issue.path?.map((segment) => String(segment.key)).join(".");
 			return `${path ? `${path}: ` : ""}${issue.message}`;
 		}).join("; ");
-		throw new Error(`Invalid execute file: ${message}`);
+		throw new CodedError(log.GHFS0106({ detail: message }));
 	}
 	const { pending, sourceActions, actionErrors } = normalizeActionInputs(parsedResult.output);
-	if (actionErrors.length) throw new Error(`Invalid execute file: ${actionErrors.join("; ")}`);
+	if (actionErrors.length) throw new CodedError(log.GHFS0107({ detail: actionErrors.join("; ") }));
 	const customErrors = validateExecuteRules(pending);
-	if (customErrors.length) throw new Error(`Invalid execute file: ${customErrors.join("; ")}`);
+	if (customErrors.length) throw new CodedError(log.GHFS0108({ detail: customErrors.join("; ") }));
 	return {
 		ops: pending,
 		sourceActions
@@ -470,14 +472,14 @@ function parseExecuteMdLine(line) {
 	const tokens = tokenizeCommand(trimmed);
 	if (!tokens) return {
 		kind: "warning",
-		message: "invalid quoted string syntax"
+		message: formatInline(diagnostics.GHFS0150())
 	};
 	if (tokens.length === 0) return void 0;
 	const [commandInput, ...args] = tokens;
 	const command = resolveActionName(commandInput);
 	if (!command) return {
 		kind: "warning",
-		message: `unrecognized action pattern: ${commandInput}`
+		message: formatInline(diagnostics.GHFS0151({ command: commandInput }))
 	};
 	if (command === "set-title") return parseSetTitle(args);
 	if (command === "add-labels") return parseAddLabels(args, commandInput);
@@ -487,7 +489,7 @@ function parseExecuteMdLine(line) {
 	if (MULTI_SIMPLE_ACTIONS.has(command)) return parseMultiSimpleAction(command, args, commandInput);
 	return {
 		kind: "warning",
-		message: `unrecognized action pattern: ${commandInput}`
+		message: formatInline(diagnostics.GHFS0151({ command: commandInput }))
 	};
 }
 async function readExecuteMdFile(path) {
@@ -584,12 +586,15 @@ function stringifyExecuteMd(parsed, remainingOpIndexes) {
 function parseSetTitle(args) {
 	if (args.length !== 2) return {
 		kind: "warning",
-		message: "set-title expects: set-title #<number> \"<title>\""
+		message: formatInline(diagnostics.GHFS0152({
+			command: "set-title",
+			syntax: "set-title #<number> \"<title>\""
+		}))
 	};
 	const number = parseIssueRef(args[0]);
 	if (!number) return {
 		kind: "warning",
-		message: "set-title expects a single issue reference (#123)"
+		message: formatInline(diagnostics.GHFS0153({ command: "set-title" }))
 	};
 	return {
 		kind: "single",
@@ -603,17 +608,20 @@ function parseSetTitle(args) {
 function parseAddLabels(args, command) {
 	if (args.length < 2) return {
 		kind: "warning",
-		message: `${command} expects: ${command} #<number> <label1, label2>`
+		message: formatInline(diagnostics.GHFS0152({
+			command,
+			syntax: `${command} #<number> <label1, label2>`
+		}))
 	};
 	const number = parseIssueRef(args[0]);
 	if (!number) return {
 		kind: "warning",
-		message: `${command} expects a single issue reference (#123)`
+		message: formatInline(diagnostics.GHFS0153({ command }))
 	};
 	const labels = args.slice(1).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
 	if (labels.length === 0) return {
 		kind: "warning",
-		message: `${command} requires at least one label`
+		message: formatInline(diagnostics.GHFS0154({ command }))
 	};
 	return {
 		kind: "single",
@@ -627,17 +635,20 @@ function parseAddLabels(args, command) {
 function parseAddAssignees(args, command) {
 	if (args.length < 2) return {
 		kind: "warning",
-		message: `${command} expects: ${command} #<number> <assignee1, assignee2>`
+		message: formatInline(diagnostics.GHFS0152({
+			command,
+			syntax: `${command} #<number> <assignee1, assignee2>`
+		}))
 	};
 	const number = parseIssueRef(args[0]);
 	if (!number) return {
 		kind: "warning",
-		message: `${command} expects a single issue reference (#123)`
+		message: formatInline(diagnostics.GHFS0153({ command }))
 	};
 	const assignees = args.slice(1).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
 	if (assignees.length === 0) return {
 		kind: "warning",
-		message: `${command} requires at least one assignee`
+		message: formatInline(diagnostics.GHFS0155({ command }))
 	};
 	return {
 		kind: "single",
@@ -651,17 +662,20 @@ function parseAddAssignees(args, command) {
 function parseAddComment(args, command) {
 	if (args.length < 2) return {
 		kind: "warning",
-		message: `${command} expects: ${command} #<number> "<comment>"`
+		message: formatInline(diagnostics.GHFS0152({
+			command,
+			syntax: `${command} #<number> "<comment>"`
+		}))
 	};
 	const number = parseIssueRef(args[0]);
 	if (!number) return {
 		kind: "warning",
-		message: `${command} expects a single issue reference (#123)`
+		message: formatInline(diagnostics.GHFS0153({ command }))
 	};
 	const body = args.slice(1).join(" ").trim();
 	if (!body) return {
 		kind: "warning",
-		message: `${command} requires a non-empty comment`
+		message: formatInline(diagnostics.GHFS0156({ command }))
 	};
 	return {
 		kind: "single",
@@ -675,17 +689,20 @@ function parseAddComment(args, command) {
 function parseCloseWithComment(args, command) {
 	if (args.length < 2) return {
 		kind: "warning",
-		message: `${command} expects: ${command} #<number> "<comment>"`
+		message: formatInline(diagnostics.GHFS0152({
+			command,
+			syntax: `${command} #<number> "<comment>"`
+		}))
 	};
 	const number = parseIssueRef(args[0]);
 	if (!number) return {
 		kind: "warning",
-		message: `${command} expects a single issue reference (#123)`
+		message: formatInline(diagnostics.GHFS0153({ command }))
 	};
 	const body = args.slice(1).join(" ").trim();
 	if (!body) return {
 		kind: "warning",
-		message: `${command} requires a non-empty comment`
+		message: formatInline(diagnostics.GHFS0156({ command }))
 	};
 	return {
 		kind: "single",
@@ -700,7 +717,7 @@ function parseMultiSimpleAction(action, args, command) {
 	const numbers = args.map(parseIssueRef);
 	if (numbers.length === 0 || numbers.some((number) => !number)) return {
 		kind: "warning",
-		message: `${command} expects one or more issue references (#123 #456)`
+		message: formatInline(diagnostics.GHFS0157({ command }))
 	};
 	return {
 		kind: "multi",
@@ -759,7 +776,7 @@ function isCommentLine(trimmed) {
 }
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.1";
 //#endregion
 //#region src/meta.ts
 const GHFS_NAME = "ghfs";
@@ -841,6 +858,8 @@ function normalizeItem(item) {
 	if (!item.data || !item.data.item) return void 0;
 	const comments = Array.isArray(item.data.comments) ? item.data.comments : [];
 	const rawItem = item.data.item;
+	const commits = Array.isArray(item.data.commits) ? item.data.commits : void 0;
+	const timeline = Array.isArray(item.data.timeline) ? item.data.timeline : void 0;
 	return {
 		...item,
 		data: {
@@ -854,7 +873,9 @@ function normalizeItem(item) {
 			comments: comments.filter((comment) => comment && typeof comment === "object").map((comment) => ({
 				...comment,
 				reactions: normalizeReactions(comment.reactions)
-			}))
+			})),
+			...commits ? { commits } : {},
+			...timeline ? { timeline } : {}
 		}
 	};
 }
@@ -868,12 +889,15 @@ async function loadPerItemSource(storageDir) {
 	for (const tracked of Object.values(syncState.items)) {
 		const markdownPath = join(storageDir, tracked.filePath);
 		if (!await pathExists(markdownPath)) {
-			warnings.push(`per-item: missing markdown for ${formatIssueNumber(tracked.number, { repo })} (${tracked.filePath})`);
+			warnings.push(formatInline(diagnostics.GHFS0160({
+				issue: formatIssueNumber(tracked.number, { repo }),
+				path: tracked.filePath
+			})));
 			continue;
 		}
 		const frontmatter = parseFrontmatter(await readFile(markdownPath, "utf8"));
 		if (!frontmatter) {
-			warnings.push(`per-item: invalid or missing frontmatter for ${formatIssueNumber(tracked.number, { repo })}`);
+			warnings.push(formatInline(diagnostics.GHFS0161({ issue: formatIssueNumber(tracked.number, { repo }) })));
 			continue;
 		}
 		const trackedItem = tracked.data.item;
@@ -1022,7 +1046,7 @@ async function loadExecuteSources(executeFilePath) {
 		...perItem.ops
 	];
 	const customErrors = validateExecuteRules(mergedOps);
-	if (customErrors.length) throw new Error(`Invalid execute file: ${customErrors.join("; ")}`);
+	if (customErrors.length) throw new CodedError(log.GHFS0108({ detail: customErrors.join("; ") }));
 	return {
 		ops: mergedOps,
 		warnings: [...executeMd.warnings, ...perItem.warnings],
@@ -1044,14 +1068,11 @@ async function loadExecuteSources(executeFilePath) {
 }
 //#endregion
 //#region src/execute/index.ts
-var ExecuteCancelledError = class extends Error {
-	constructor() {
-		super("Execution cancelled");
-		this.name = "ExecuteCancelledError";
-	}
-};
+function createCancelledError() {
+	return new CodedError(log.GHFS0102());
+}
 function isExecuteCancelledError(error) {
-	return error instanceof ExecuteCancelledError;
+	return error instanceof CodedError && error.diagnostic.code === "GHFS0102";
 }
 async function executePendingChanges(options) {
 	try {
@@ -1070,7 +1091,7 @@ async function executePendingChanges(options) {
 			details: []
 		};
 		const interactive = process.stdin.isTTY && !options.nonInteractive;
-		if (interactive && !options.prompts) throw new Error("Interactive execute prompts are unavailable. Use --non-interactive or provide prompts.");
+		if (interactive && !options.prompts) throw new CodedError(log.GHFS0100());
 		const selected = Array.isArray(options.selectedIndexes) ? selectOperationsByIndexes(allOps, options.selectedIndexes) : interactive ? await selectOperations(allOps, options.prompts) : allOps.map((op, index) => ({
 			op,
 			index
@@ -1119,7 +1140,7 @@ async function executePendingChanges(options) {
 			return result;
 		}
 		if (interactive) {
-			if (!await confirmApply(selected.length, options.prompts)) throw new ExecuteCancelledError();
+			if (!await confirmApply(selected.length, options.prompts)) throw createCancelledError();
 		}
 		const provider = options.provider ?? createRepositoryProvider({
 			token: options.token,
@@ -1200,7 +1221,7 @@ async function applyOperation(provider, op) {
 	const isPull = item.kind === "pull";
 	if (op.ifUnchangedSince) {
 		const remoteUpdatedAt = item.updatedAt;
-		if (remoteUpdatedAt && new Date(remoteUpdatedAt).getTime() > new Date(op.ifUnchangedSince).getTime()) throw new Error(`Operation conflict: remote updated_at=${remoteUpdatedAt}`);
+		if (remoteUpdatedAt && new Date(remoteUpdatedAt).getTime() > new Date(op.ifUnchangedSince).getTime()) throw new CodedError(log.GHFS0101({ remoteUpdatedAt }));
 	}
 	switch (op.action) {
 		case "close":
@@ -1268,7 +1289,7 @@ async function applyOperation(provider, op) {
 			ensurePullAction(op.action, op.number, isPull);
 			await provider.actionConvertToDraft(op.number);
 			break;
-		default: throw new Error(`Unsupported action: ${String(op.action)}`);
+		default: throw new CodedError(log.GHFS0103({ action: String(op.action) }));
 	}
 	return item.kind;
 }
@@ -1277,7 +1298,7 @@ function createRunId() {
 }
 async function selectOperations(ops, prompts) {
 	const selectedIndexes = await prompts.selectOperations(ops);
-	if (!selectedIndexes) throw new ExecuteCancelledError();
+	if (!selectedIndexes) throw createCancelledError();
 	const selectedIndexesSet = new Set(selectedIndexes);
 	return ops.map((op, index) => ({
 		op,
@@ -1298,7 +1319,10 @@ function selectOperationsByIndexes(ops, selectedIndexes) {
 	})).filter((item) => selectedSet.has(item.index));
 }
 function ensurePullAction(action, number, isPull) {
-	if (!isPull) throw new Error(`Action ${action} requires #${number} to be a pull request`);
+	if (!isPull) throw new CodedError(log.GHFS0104({
+		action,
+		issue: `#${number}`
+	}));
 }
 function describeExecutionAction(action, number) {
 	return `${action} #${number}`;
@@ -1522,6 +1546,10 @@ function resolvePatchPlan(patchesMode, kind, state) {
 		shouldDeletePatch: !shouldWritePatch
 	};
 }
+function shouldSyncPrDetails(sync, kind, state) {
+	if (kind === "issue") return true;
+	return sync.patches === "all" || sync.patches === "open" && state === "open";
+}
 function relativeToStorage(storageDirAbsolute, absolutePath) {
 	if (absolutePath.startsWith(storageDirAbsolute)) return absolutePath.slice(storageDirAbsolute.length + 1);
 	return basename(absolutePath);
@@ -1683,7 +1711,8 @@ async function prepareIssueCandidateSync(context, issue) {
 			patchPlan
 		};
 	}
-	const hasCanonicalData = Boolean(tracked?.data && (kind !== "pull" || tracked.data.pull));
+	const needsDetails = shouldSyncPrDetails(context.config.sync, kind, state);
+	const hasCanonicalData = Boolean(tracked?.data && (kind !== "pull" || tracked.data.pull) && (!needsDetails || tracked.data.timeline && (kind !== "pull" || tracked.data.commits)));
 	const shouldRefetch = !tracked || tracked.lastUpdatedAt !== issue.updatedAt || !hasCanonicalData;
 	const data = shouldRefetch ? await fetchCanonicalData(context, issue) : tracked.data;
 	updateTrackedItem(context, number, kind, state, issue.updatedAt, paths.targetPath, patchPlan.shouldWritePatch ? paths.patchPath : void 0, data);
@@ -1726,10 +1755,10 @@ async function materializePreparedIssue(context, candidate) {
 		};
 	}
 	const tracked = context.syncState.items[String(number)];
-	if (!tracked) throw new Error(`Missing tracked canonical data for ${formatIssueNumber(number, {
+	if (!tracked) throw new CodedError(log.GHFS0401({ issue: formatIssueNumber(number, {
 		repo: context.repoSlug,
 		kind
-	})}`);
+	}) }));
 	const markdown = buildTrackedMarkdown(context, tracked);
 	const moved = await moveMarkdownByState(paths, state);
 	await writeFileEnsured(paths.targetPath, markdown);
@@ -1794,10 +1823,19 @@ function resolveSyncAction(shouldRefetch, paths, state) {
 	return "create";
 }
 async function fetchCanonicalData(context, issue) {
+	const includeDetails = shouldSyncPrDetails(context.config.sync, issue.kind, issue.state);
+	const [comments, pull, commits, timeline] = await Promise.all([
+		context.provider.fetchComments(issue.number),
+		issue.kind === "pull" ? context.provider.fetchPullMetadata(issue.number) : Promise.resolve(void 0),
+		issue.kind === "pull" && includeDetails ? context.provider.fetchPullCommits(issue.number) : Promise.resolve(void 0),
+		includeDetails ? context.provider.fetchTimeline(issue.number) : Promise.resolve(void 0)
+	]);
 	return {
 		item: issue,
-		comments: await context.provider.fetchComments(issue.number),
-		pull: issue.kind === "pull" ? await context.provider.fetchPullMetadata(issue.number) : void 0
+		comments,
+		pull,
+		commits,
+		timeline
 	};
 }
 async function syncPatchByPlan(context, number, patchPath, patchPlan) {
@@ -2253,7 +2291,7 @@ async function syncRepository(options) {
 	}
 }
 function assertContext(context) {
-	if (!context) throw new Error("Sync context was not initialized");
+	if (!context) throw new CodedError(log.GHFS0400());
 }
 function createSyncRunId() {
 	return `sync_${(/* @__PURE__ */ new Date()).toISOString().replace(/[-:.TZ]/g, "")}_${randomBytes(3).toString("hex")}`;
@@ -2385,6 +2423,66 @@ function createRemotePoller(options) {
 	};
 }
 //#endregion
+//#region src/server/portless.ts
+const execFileAsync = promisify(execFile);
+function slugifyRepoName(repo) {
+	return (repo.includes("/") ? repo.slice(repo.lastIndexOf("/") + 1) : repo).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") || "app";
+}
+function resolvePortlessCliPath() {
+	try {
+		return resolve(dirname(fileURLToPath(import.meta.resolve("portless"))), "cli.js");
+	} catch {
+		return;
+	}
+}
+async function runPortless(args) {
+	const cliPath = resolvePortlessCliPath();
+	if (!cliPath) throw new CodedError(log.GHFS0206({ detail: "portless package is not installed" }));
+	try {
+		const { stdout } = await execFileAsync(process.execPath, [cliPath, ...args], { env: {
+			...process.env,
+			FORCE_COLOR: "0"
+		} });
+		return stdout;
+	} catch (error) {
+		const err = error;
+		const detail = (err.stderr || err.stdout || err.message || "").toString().trim();
+		throw new CodedError(log.GHFS0206({ detail: detail ? `portless failed: ${detail}` : "portless failed" }, { cause: error }));
+	}
+}
+async function registerPortlessRoute(options) {
+	const namespace = options.namespace ?? "ghfs";
+	const tld = options.tld ?? "localhost";
+	const hostname = `${options.subdomain}.${namespace}`;
+	const fallbackUrl = `https://${hostname}.${tld}`;
+	await runPortless([
+		"alias",
+		hostname,
+		String(options.port)
+	]);
+	let url = fallbackUrl;
+	try {
+		const resolved = (await runPortless(["get", hostname])).trim().split(/\r?\n/).pop()?.trim();
+		if (resolved && /^https?:\/\//.test(resolved)) url = resolved;
+	} catch {}
+	let unregistered = false;
+	return {
+		hostname,
+		url,
+		async unregister() {
+			if (unregistered) return;
+			unregistered = true;
+			try {
+				await runPortless([
+					"alias",
+					"--remove",
+					hostname
+				]);
+			} catch {}
+		}
+	};
+}
+//#endregion
 //#region src/server/queue-builder.ts
 async function buildQueueState(options) {
 	const { storageDirAbsolute, executeFilePath } = options;
@@ -2472,7 +2570,7 @@ function createEditorHandler(ctx) {
 function createExecuteHandler(ctx) {
 	let running = false;
 	return async function executeQueue(options) {
-		if (running) throw new Error("An execute is already in progress");
+		if (running) throw new CodedError(log.GHFS0201());
 		running = true;
 		try {
 			const token = await ctx.getToken();
@@ -2838,15 +2936,15 @@ async function addQueueOp(options, op) {
 }
 async function removeQueueOp(options, id) {
 	const entry = (await buildQueueState(options)).entries.find((e) => e.id === id);
-	if (!entry) throw new Error(`Queue entry not found: ${id}`);
-	if (entry.source === "per-item") throw new Error(`Cannot remove a per-item edit from the queue. Edit ${entry.filePath ?? "the markdown file"} directly to adjust it.`);
+	if (!entry) throw new CodedError(log.GHFS0202({ id }));
+	if (entry.source === "per-item") throw new CodedError(log.GHFS0203({ target: entry.filePath ?? "the markdown file" }));
 	if (entry.source === "execute.yml") {
 		const next = (await readAndValidateExecuteFileWithSource(options.executeFilePath)).ops.filter((_, index) => index !== entry.index);
 		await writeExecuteFile(options.executeFilePath, next);
 		return buildQueueState(options);
 	}
 	const mdPath = join(options.storageDirAbsolute, EXECUTE_MD_FILE_NAME);
-	if (!await pathExists(mdPath)) throw new Error("execute.md not found; cannot remove op");
+	if (!await pathExists(mdPath)) throw new CodedError(log.GHFS0204());
 	const parsed = await readExecuteMdFile(mdPath);
 	const remaining = /* @__PURE__ */ new Set();
 	for (let i = 0; i < parsed.ops.length; i += 1) if (i !== entry.index) remaining.add(i);
@@ -2855,8 +2953,8 @@ async function removeQueueOp(options, id) {
 }
 async function updateQueueOp(options, id, op) {
 	const entry = (await buildQueueState(options)).entries.find((e) => e.id === id);
-	if (!entry) throw new Error(`Queue entry not found: ${id}`);
-	if (entry.source !== "execute.yml") throw new Error(`Cannot edit ${entry.source} ops from the queue panel`);
+	if (!entry) throw new CodedError(log.GHFS0202({ id }));
+	if (entry.source !== "execute.yml") throw new CodedError(log.GHFS0205({ source: entry.source }));
 	const replaced = (await readAndValidateExecuteFileWithSource(options.executeFilePath)).ops.map((existing, index) => index === entry.index ? op : existing);
 	await writeExecuteFile(options.executeFilePath, compressOps(replaced));
 	return buildQueueState(options);
@@ -2888,11 +2986,33 @@ function createRemoteHandler(ctx) {
 	};
 }
 //#endregion
+//#region src/sync/repo-snapshot.ts
+async function loadRepoSnapshot(storageDirAbsolute) {
+	try {
+		const raw = await readFile(join(storageDirAbsolute, REPO_SNAPSHOT_FILE_NAME), "utf8");
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+//#endregion
 //#region src/server/ui-state.ts
 const UI_STATE_FILE = ".ui.json";
 function createEmptyUiState() {
 	return { drafts: {} };
 }
+function normalizePrTab(value) {
+	if (value === "conversation" || value === "commits" || value === "changes") return value;
+}
+function normalizeUserOverride(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const raw = value;
+	const out = {};
+	if (typeof raw.login === "string" && raw.login.trim()) out.login = raw.login.trim();
+	if (typeof raw.name === "string" && raw.name.trim()) out.name = raw.name.trim();
+	if (typeof raw.avatarUrl === "string" && raw.avatarUrl.startsWith("https://")) out.avatarUrl = raw.avatarUrl.trim();
+	return Object.keys(out).length > 0 ? out : void 0;
+}
 async function loadUiState(storageDirAbsolute) {
 	try {
 		const raw = await readFile(join(storageDirAbsolute, UI_STATE_FILE), "utf8");
@@ -2903,7 +3023,9 @@ async function loadUiState(storageDirAbsolute) {
 		}
 		return {
 			drafts,
-			listPaneSize: typeof parsed.listPaneSize === "number" ? parsed.listPaneSize : void 0
+			listPaneSize: typeof parsed.listPaneSize === "number" ? parsed.listPaneSize : void 0,
+			lastPrTab: normalizePrTab(parsed.lastPrTab),
+			userOverride: normalizeUserOverride(parsed.userOverride)
 		};
 	} catch {
 		return createEmptyUiState();
@@ -2911,9 +3033,13 @@ async function loadUiState(storageDirAbsolute) {
 }
 async function saveUiState(storageDirAbsolute, state) {
 	await mkdir(storageDirAbsolute, { recursive: true });
+	const tab = normalizePrTab(state.lastPrTab);
+	const override = normalizeUserOverride(state.userOverride);
 	const clean = {
 		drafts: { ...state.drafts },
-		...state.listPaneSize != null ? { listPaneSize: state.listPaneSize } : {}
+		...state.listPaneSize != null ? { listPaneSize: state.listPaneSize } : {},
+		...tab ? { lastPrTab: tab } : {},
+		...override ? { userOverride: override } : {}
 	};
 	await writeFile(join(storageDirAbsolute, UI_STATE_FILE), `${JSON.stringify(clean, null, 2)}\n`, "utf8");
 }
@@ -2948,27 +3074,69 @@ function createStateHandlers(ctx) {
 		});
 	}
 	async function getInitialPayload() {
-		const [repo, syncState, queue, uiState] = await Promise.all([
+		const [repo, syncState, queue, uiState, snapshot] = await Promise.all([
 			getRepoMeta(),
 			getSyncState(),
 			getQueue(),
-			loadUiState(ctx.storageDirAbsolute)
+			loadUiState(ctx.storageDirAbsolute),
+			loadRepoSnapshot(ctx.storageDirAbsolute)
 		]);
+		const repositoryLabels = (snapshot?.labels ?? []).map((label) => ({
+			name: label.name,
+			color: label.color,
+			description: label.description
+		}));
+		const currentUser = await resolveCurrentUser(ctx, uiState);
 		return {
 			repo,
 			syncState,
 			queue,
 			remote: ctx.poller.getCurrent(),
 			recentExecutions: syncState.executions ?? [],
-			uiState
+			uiState,
+			repositoryLabels,
+			currentUser
 		};
 	}
+	async function getPullPatch(number) {
+		const tracked = (await loadSyncState(ctx.storageDirAbsolute)).items[String(number)];
+		if (!tracked?.patchPath) return null;
+		try {
+			return await readFile(join(ctx.storageDirAbsolute, tracked.patchPath), "utf8");
+		} catch (err) {
+			if (err.code === "ENOENT") return null;
+			throw err;
+		}
+	}
 	return {
 		getInitialPayload,
 		getSyncState,
 		getQueue,
 		getRepoMeta,
-		saveUiState: (state) => saveUiState(ctx.storageDirAbsolute, state)
+		saveUiState: (state) => saveUiState(ctx.storageDirAbsolute, state),
+		getPullPatch
+	};
+}
+async function resolveCurrentUser(ctx, uiState) {
+	const override = uiState.userOverride;
+	let fetched = null;
+	try {
+		const user = await (await ctx.getProvider())?.fetchAuthenticatedUser();
+		if (user) fetched = {
+			login: user.login,
+			name: user.name,
+			avatarUrl: user.avatarUrl
+		};
+	} catch {
+		fetched = null;
+	}
+	if (!override && !fetched) return null;
+	const login = override?.login ?? fetched?.login;
+	if (!login) return null;
+	return {
+		login,
+		name: override?.name ?? fetched?.name ?? null,
+		avatarUrl: override?.avatarUrl ?? fetched?.avatarUrl ?? `https://avatars.githubusercontent.com/${login}`
 	};
 }
 //#endregion
@@ -2976,7 +3144,7 @@ function createStateHandlers(ctx) {
 function createSyncHandler(ctx) {
 	let running = false;
 	return async function triggerSync(options) {
-		if (running) throw new Error("A sync is already in progress");
+		if (running) throw new CodedError(log.GHFS0200());
 		running = true;
 		try {
 			const token = await ctx.getToken();
@@ -3039,7 +3207,8 @@ function createServerFunctions(ctx) {
 		clearQueue: queue.clearQueue,
 		checkRemote: createRemoteHandler(ctx),
 		openInEditor: createEditorHandler(ctx),
-		saveUiState: state.saveUiState
+		saveUiState: state.saveUiState,
+		getPullPatch: state.getPullPatch
 	};
 }
 //#endregion
@@ -3191,7 +3360,7 @@ async function createUiServer(options) {
 			cachedToken = await options.onRequestToken();
 			return cachedToken;
 		}
-		throw new Error("Missing GitHub token");
+		throw new CodedError(log.GHFS0001());
 	}
 	let cachedProvider;
 	async function getProvider() {
@@ -3298,11 +3467,29 @@ async function createUiServer(options) {
 			resolvePromise();
 		});
 	});
+	const directUrl = `http://${options.host === "0.0.0.0" ? "localhost" : options.host}:${port}`;
+	let portlessUrl;
+	let portlessUnregister;
+	if (options.portless?.enabled) try {
+		const route = await registerPortlessRoute({
+			subdomain: options.portless.subdomain,
+			namespace: options.portless.namespace,
+			port
+		});
+		portlessUrl = route.url;
+		portlessUnregister = route.unregister;
+	} catch (error) {
+		const message = error.message || String(error);
+		options.logger?.info?.(`portless unavailable (${message}); falling back to ${directUrl}`);
+	}
 	return {
-		url: `http://${options.host === "0.0.0.0" ? "localhost" : options.host}:${port}`,
+		url: portlessUrl ?? directUrl,
+		directUrl,
+		portlessUrl,
 		port,
 		host: options.host,
 		close: async () => {
+			if (portlessUnregister) await portlessUnregister();
 			poller.close();
 			await watcher.close();
 			await new Promise((resolveClose) => wss.close(() => resolveClose()));
@@ -3328,4 +3515,4 @@ function rawToString(raw) {
 	return String(raw);
 }
 //#endregion
-export { isExecuteCancelledError as a, GHFS_VERSION as c, pathExists as d, getExecuteFile as f, executePendingChanges as i, ensureExecuteArtifacts as l, resolveConfig as m, syncRepository as n, loadSyncState as o, getStorageDirAbsolute as p, appendExecutionResult as r, GHFS_NAME as s, createUiServer as t, ACTIONS_COLOR_HEX as u };
+export { executePendingChanges as a, GHFS_NAME as c, ACTIONS_COLOR_HEX as d, pathExists as f, resolveConfig as h, appendExecutionResult as i, GHFS_VERSION as l, getStorageDirAbsolute as m, slugifyRepoName as n, isExecuteCancelledError as o, getExecuteFile as p, syncRepository as r, loadSyncState as s, createUiServer as t, ensureExecuteArtifacts as u };