@ghfs/cli 0.0.3 → 0.0.4

package/dist/cli.mjs

@@ -1,20 +1,23 @@
 #!/usr/bin/env node
-import { a as formatIssueNumber, i as formatDuration, n as normalizeReactions, o as formatTerminalLink$1, r as countNoun, s as formatValue, t as createRepositoryProvider } from "./factory-COZFMWsb.mjs";
+import { a as formatIssueNumber, i as formatDuration, n as normalizeReactions, o as formatTerminalLink$1, r as countNoun, s as formatValue, t as createRepositoryProvider } from "./factory-DYHQBeCz.mjs";
 import process from "node:process";
 import { cac } from "cac";
-import { basename, dirname, isAbsolute, join, resolve } from "pathe";
+import { basename, dirname, extname, isAbsolute, join, normalize, resolve } from "pathe";
 import { execFile } 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, writeFile } from "node:fs/promises";
+import { access, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import * as v from "valibot";
 import { parse, stringify } from "yaml";
 import { randomBytes } from "node:crypto";
 import c from "ansis";
 import * as p from "@clack/prompts";
 import { cancel, confirm, isCancel, multiselect, password, select } from "@clack/prompts";
-
+import { createServer } from "node:http";
+import { createBirpcGroup } from "birpc";
+import { parse as parse$1, stringify as stringify$1 } from "structured-clone-es";
+import { WebSocketServer } from "ws";
 //#region src/config/auth.ts
 const execFileAsync$1 = promisify(execFile);
 async function resolveAuthToken(options) {
@@ -44,7 +47,6 @@ async function readTokenFromEnv() {
 		if (value) return value;
 	}
 }
-
 //#endregion
 //#region src/constants.ts
 const CONFIG_FILE_CANDIDATES = [
@@ -54,7 +56,6 @@ const CONFIG_FILE_CANDIDATES = [
 	"ghfs.config.js",
 	"ghfs.config.cjs"
 ];
-const DEFAULT_STORAGE_DIR = ".ghfs";
 const ISSUE_DIR_NAME = "issues";
 const PULL_DIR_NAME = "pulls";
 const CLOSED_DIR_NAME = "closed";
@@ -65,7 +66,6 @@ const REPO_SNAPSHOT_FILE_NAME = "repo.json";
 const EXECUTE_FILE_NAME = "execute.yml";
 const EXECUTE_MD_FILE_NAME = "execute.md";
 const EXECUTE_SCHEMA_RELATIVE_PATH = "schema/execute.schema.json";
-
 //#endregion
 //#region src/config/load.ts
 async function loadUserConfig(cwd) {
@@ -90,7 +90,7 @@ async function resolveConfig(options = {}) {
 	const overrides = options.overrides ?? {};
 	const { config: userConfig } = await loadUserConfig(cwd);
 	const merged = mergeUserConfig(userConfig, overrides);
-	const directory = merged.directory ?? DEFAULT_STORAGE_DIR;
+	const directory = merged.directory ?? ".ghfs";
 	const configuredToken = merged.auth?.token?.trim() || "";
 	const repo = merged.repo?.trim() || "";
 	const issuesEnabled = merged.sync?.issues ?? true;
@@ -136,7 +136,6 @@ function mergeUserConfig(base, overrides) {
 		}
 	};
 }
-
 //#endregion
 //#region src/utils/fs.ts
 async function pathExists(path) {
@@ -179,7 +178,6 @@ async function removePatchIfExists(storageDirAbsolute, number) {
 	}
 	return removed;
 }
-
 //#endregion
 //#region src/config/repo.ts
 const execFileAsync = promisify(execFile);
@@ -318,7 +316,6 @@ function prioritizeRemotes(remotes) {
 function stripGitSuffix(name) {
 	return name.replace(/\.git$/, "");
 }
-
 //#endregion
 //#region src/execute/actions.ts
 const ACTIONS_SUPPORTED = [
@@ -400,7 +397,6 @@ function resolveActionName(action) {
 function normalizeActionInput(action) {
 	return action.trim().toLowerCase();
 }
-
 //#endregion
 //#region src/execute/schema.ts
 const executeSchema = {
@@ -450,23 +446,22 @@ const executeSchema = {
 };
 const EXECUTE_FILE_PLACEHOLDER = [
 	`# yaml-language-server: $schema=./${EXECUTE_SCHEMA_RELATIVE_PATH}`,
-	"# Add operations as YAML list items, then run: ghfs execute --run",
-	"# Action names are case-insensitive and support aliases (for example: label, assign, comment, close-comment).",
+	"# Add operations as YAML list items, then run: `ghfs execute`, examples:",
+	"#",
 	"# - action: close",
 	"#   number: 123",
-	"[]",
 	""
 ].join("\n");
 const EXECUTE_MD_FILE_PLACEHOLDER = [
-	"# Add one action per line, then run: ghfs execute --run",
-	"# Command names are case-insensitive and support aliases.",
-	"# close #123 #124",
-	"# label #123 bug, triage",
-	"# assign #123 antfu",
-	"# comment #123 \"Need more context\"",
-	"# close-comment #123 \"Closing as completed\"",
-	"# set-title #123 \"new title\"",
-	"# add-tag #123 foo, bar",
+	"<!-- Add one action per line, then run: `ghfs execute`, examples: -->",
+	"",
+	"<!-- close #123 #124 -->",
+	"<!-- label #123 bug, triage -->",
+	"<!-- assign #123 antfu -->",
+	"<!-- comment #123 \"Need more context\" -->",
+	"<!-- close-comment #123 \"Closing as completed\" -->",
+	"<!-- set-title #123 \"new title\" -->",
+	"<!-- add-tag #123 foo, bar -->",
 	""
 ].join("\n");
 async function writeExecuteSchema(storageDirAbsolute) {
@@ -506,7 +501,6 @@ async function ensureExecuteMdFile(storageDirAbsolute) {
 function getExecuteSchemaPath(storageDirAbsolute) {
 	return join(storageDirAbsolute, EXECUTE_SCHEMA_RELATIVE_PATH);
 }
-
 //#endregion
 //#region src/execute/validate.ts
 const executeOpSchema = v.looseObject({
@@ -532,7 +526,7 @@ async function readAndValidateExecuteFileWithSource(path) {
 	const raw = await readFile(path, "utf8");
 	let parsed;
 	try {
-		parsed = parse(raw);
+		parsed = parse(raw || "[]") || [];
 	} catch (error) {
 		throw new Error(`Failed to parse execute YAML: ${error.message}`);
 	}
@@ -629,7 +623,6 @@ function normalizeActionInputs(pending) {
 		actionErrors
 	};
 }
-
 //#endregion
 //#region src/execute/sources/execute-md.ts
 const MULTI_SIMPLE_ACTIONS = new Set([
@@ -933,16 +926,13 @@ function tokenizeCommand(value) {
 function isCommentLine(trimmed) {
 	return trimmed.startsWith("#") || trimmed.startsWith("//") || trimmed.startsWith("<!--");
 }
-
 //#endregion
 //#region package.json
-var version = "0.0.3";
-
+var version = "0.0.4";
 //#endregion
 //#region src/meta.ts
 const GHFS_NAME = "ghfs";
 const GHFS_VERSION = version;
-
 //#endregion
 //#region src/sync/state.ts
 function getSyncStatePath(storageDirAbsolute) {
@@ -1034,7 +1024,143 @@ function normalizeItem(item) {
 		}
 	};
 }
-
+//#endregion
+//#region src/execute/diff.ts
+function computeExecuteDiffOps(options) {
+	const ops = [];
+	const ifUnchangedSince = options.ifUnchangedSince;
+	const current = normalizeDiffFields(options.current);
+	const desired = normalizeDiffFields(options.desired);
+	if (current.title !== desired.title) ops.push({
+		action: "set-title",
+		number: options.number,
+		title: desired.title,
+		ifUnchangedSince
+	});
+	if (options.includeBody && current.body !== desired.body && desired.body) ops.push({
+		action: "set-body",
+		number: options.number,
+		body: desired.body,
+		ifUnchangedSince
+	});
+	if (current.state !== desired.state) ops.push({
+		action: desired.state === "closed" ? "close" : "reopen",
+		number: options.number,
+		ifUnchangedSince
+	});
+	if (!sameStringSet(current.labels, desired.labels)) {
+		const additions = diffStrings(desired.labels, current.labels);
+		const deletions = diffStrings(current.labels, desired.labels);
+		if (additions.length > 0 && deletions.length > 0) ops.push({
+			action: "set-labels",
+			number: options.number,
+			labels: desired.labels,
+			ifUnchangedSince
+		});
+		else if (additions.length > 0) ops.push({
+			action: "add-labels",
+			number: options.number,
+			labels: additions,
+			ifUnchangedSince
+		});
+		else if (deletions.length > 0) ops.push({
+			action: "remove-labels",
+			number: options.number,
+			labels: deletions,
+			ifUnchangedSince
+		});
+	}
+	if (!sameStringSet(current.assignees, desired.assignees)) {
+		if (desired.assignees.length > 0) ops.push({
+			action: "set-assignees",
+			number: options.number,
+			assignees: desired.assignees,
+			ifUnchangedSince
+		});
+		else if (current.assignees.length > 0) ops.push({
+			action: "remove-assignees",
+			number: options.number,
+			assignees: current.assignees,
+			ifUnchangedSince
+		});
+	}
+	if (current.milestone !== desired.milestone) if (desired.milestone) ops.push({
+		action: "set-milestone",
+		number: options.number,
+		milestone: desired.milestone,
+		ifUnchangedSince
+	});
+	else ops.push({
+		action: "clear-milestone",
+		number: options.number,
+		ifUnchangedSince
+	});
+	if (!sameStringSet(current.reviewers, desired.reviewers)) {
+		const additions = diffStrings(desired.reviewers, current.reviewers);
+		const deletions = diffStrings(current.reviewers, desired.reviewers);
+		if (additions.length > 0) ops.push({
+			action: "request-reviewers",
+			number: options.number,
+			reviewers: additions,
+			ifUnchangedSince
+		});
+		if (deletions.length > 0) ops.push({
+			action: "remove-reviewers",
+			number: options.number,
+			reviewers: deletions,
+			ifUnchangedSince
+		});
+	}
+	if (typeof current.isDraft === "boolean" && typeof desired.isDraft === "boolean" && current.isDraft !== desired.isDraft) ops.push({
+		action: desired.isDraft ? "convert-to-draft" : "mark-ready-for-review",
+		number: options.number,
+		ifUnchangedSince
+	});
+	return ops;
+}
+function normalizeStringArray(value) {
+	if (!Array.isArray(value)) return [];
+	const unique = /* @__PURE__ */ new Set();
+	for (const entry of value) {
+		if (typeof entry !== "string") continue;
+		const normalized = entry.trim();
+		if (!normalized) continue;
+		unique.add(normalized);
+	}
+	return [...unique];
+}
+function normalizeMilestone(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	return normalized.length > 0 ? normalized : null;
+}
+function normalizeBody(value) {
+	if (value == null) return null;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeDiffFields(fields) {
+	return {
+		...fields,
+		title: fields.title.trim(),
+		body: normalizeBody(fields.body),
+		labels: normalizeStringArray(fields.labels),
+		assignees: normalizeStringArray(fields.assignees),
+		milestone: normalizeMilestone(fields.milestone),
+		reviewers: normalizeStringArray(fields.reviewers),
+		isDraft: Boolean(fields.isDraft)
+	};
+}
+function sameStringSet(left, right) {
+	if (left.length !== right.length) return false;
+	const sortedLeft = [...left].sort();
+	const sortedRight = [...right].sort();
+	return sortedLeft.every((value, index) => value === sortedRight[index]);
+}
+function diffStrings(source, target) {
+	const targetSet = new Set(target);
+	return source.filter((value) => !targetSet.has(value));
+}
 //#endregion
 //#region src/execute/sources/per-item.ts
 async function loadPerItemSource(storageDir) {
@@ -1074,67 +1200,20 @@ async function loadPerItemSource(storageDir) {
 	};
 }
 function computePerItemOps(input) {
-	const ops = [];
-	const ifUnchangedSince = input.updatedAt;
-	if (input.current.title !== input.desired.title) ops.push({
-		action: "set-title",
-		number: input.number,
-		title: input.desired.title,
-		ifUnchangedSince
-	});
-	if (input.current.state !== input.desired.state) ops.push({
-		action: input.desired.state === "closed" ? "close" : "reopen",
+	return computeExecuteDiffOps({
 		number: input.number,
-		ifUnchangedSince
-	});
-	if (!sameStringSet(input.current.labels, input.desired.labels)) {
-		const additions = diffStrings(input.desired.labels, input.current.labels);
-		const deletions = diffStrings(input.current.labels, input.desired.labels);
-		if (additions.length > 0 && deletions.length > 0) ops.push({
-			action: "set-labels",
-			number: input.number,
-			labels: input.desired.labels,
-			ifUnchangedSince
-		});
-		else if (additions.length > 0) ops.push({
-			action: "add-labels",
-			number: input.number,
-			labels: additions,
-			ifUnchangedSince
-		});
-		else if (deletions.length > 0) ops.push({
-			action: "remove-labels",
-			number: input.number,
-			labels: deletions,
-			ifUnchangedSince
-		});
-	}
-	if (!sameStringSet(input.current.assignees, input.desired.assignees)) {
-		if (input.desired.assignees.length > 0) ops.push({
-			action: "set-assignees",
-			number: input.number,
-			assignees: input.desired.assignees,
-			ifUnchangedSince
-		});
-		else if (input.current.assignees.length > 0) ops.push({
-			action: "remove-assignees",
-			number: input.number,
-			assignees: input.current.assignees,
-			ifUnchangedSince
-		});
-	}
-	if (normalizeMilestone(input.current.milestone) !== normalizeMilestone(input.desired.milestone)) if (input.desired.milestone) ops.push({
-		action: "set-milestone",
-		number: input.number,
-		milestone: input.desired.milestone,
-		ifUnchangedSince
-	});
-	else ops.push({
-		action: "clear-milestone",
-		number: input.number,
-		ifUnchangedSince
+		current: {
+			...input.current,
+			body: null,
+			reviewers: []
+		},
+		desired: {
+			...input.desired,
+			body: null,
+			reviewers: []
+		},
+		ifUnchangedSince: input.updatedAt
 	});
-	return ops;
 }
 function parseFrontmatter(raw) {
 	const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
@@ -1158,33 +1237,6 @@ function parseFrontmatter(raw) {
 		milestone: normalizeMilestone(data.milestone)
 	};
 }
-function normalizeStringArray(value) {
-	if (!Array.isArray(value)) return [];
-	const unique = /* @__PURE__ */ new Set();
-	for (const entry of value) {
-		if (typeof entry !== "string") continue;
-		const normalized = entry.trim();
-		if (!normalized) continue;
-		unique.add(normalized);
-	}
-	return [...unique];
-}
-function sameStringSet(left, right) {
-	if (left.length !== right.length) return false;
-	const sortedLeft = [...left].sort();
-	const sortedRight = [...right].sort();
-	return sortedLeft.every((value, index) => value === sortedRight[index]);
-}
-function normalizeMilestone(value) {
-	if (typeof value !== "string") return null;
-	const normalized = value.trim();
-	return normalized.length > 0 ? normalized : null;
-}
-function diffStrings(source, target) {
-	const targetSet = new Set(target);
-	return source.filter((value) => !targetSet.has(value));
-}
-
 //#endregion
 //#region src/execute/sources/index.ts
 async function loadExecuteSources(executeFilePath) {
@@ -1199,10 +1251,32 @@ async function loadExecuteSources(executeFilePath) {
 		...executeMd.ops,
 		...perItem.ops
 	];
+	const entries = mergedOps.map((op, mergedIndex) => {
+		if (mergedIndex < ymlOps.length) return {
+			op,
+			source: "execute.yml",
+			sourceIndex: mergedIndex,
+			mergedIndex
+		};
+		const mdOffset = mergedIndex - ymlOps.length;
+		if (mdOffset < executeMd.ops.length) return {
+			op,
+			source: "execute.md",
+			sourceIndex: mdOffset,
+			mergedIndex
+		};
+		return {
+			op,
+			source: "per-item",
+			sourceIndex: mdOffset - executeMd.ops.length,
+			mergedIndex
+		};
+	});
 	const customErrors = validateExecuteRules(mergedOps);
 	if (customErrors.length) throw new Error(`Invalid execute file: ${customErrors.join("; ")}`);
 	return {
 		ops: mergedOps,
+		entries,
 		warnings: [...executeMd.warnings, ...perItem.warnings],
 		async writeRemaining(remainingIndexes) {
 			await writeExecuteFile(executeFilePath, ymlOps.map((op, index) => ({
@@ -1215,12 +1289,11 @@ async function loadExecuteSources(executeFilePath) {
 			if (!await pathExists(executeMdPath)) return;
 			const mdOffset = ymlOps.length;
 			const mdRemaining = /* @__PURE__ */ new Set();
-			for (const index of remainingIndexes) if (index >= mdOffset) mdRemaining.add(index - mdOffset);
+			for (const index of remainingIndexes) if (index >= mdOffset && index < mdOffset + executeMd.ops.length) mdRemaining.add(index - mdOffset);
 			await writeFile(executeMdPath, stringifyExecuteMd(executeMd, mdRemaining), "utf-8");
 		}
 	};
 }
-
 //#endregion
 //#region src/execute/index.ts
 var ExecuteCancelledError = class extends Error {
@@ -1482,13 +1555,11 @@ function ensurePullAction(action, number, isPull) {
 function describeExecutionAction(action, number) {
 	return `${action} #${number}`;
 }
-
 //#endregion
 //#region src/sync/execution-log.ts
 async function appendExecutionResult(storageDirAbsolute, result) {
 	await saveSyncState(storageDirAbsolute, appendExecution(await loadSyncState(storageDirAbsolute), result));
 }
-
 //#endregion
 //#region src/utils/sync.ts
 function resolveSince(options, syncState) {
@@ -1500,7 +1571,6 @@ function normalizeIssueNumbers(numbers) {
 	if (!numbers) return void 0;
 	return [...new Set(numbers.filter((number) => Number.isInteger(number) && number > 0))];
 }
-
 //#endregion
 //#region src/sync/markdown.ts
 const FIELDS_ALWAYS_KEEP = new Set(["labels", "assignees"]);
@@ -1635,7 +1705,6 @@ function getReactionEntries(reactions) {
 		};
 	}).filter((entry) => Boolean(entry));
 }
-
 //#endregion
 //#region src/utils/string.ts
 function slugifyTitle(title, maxLength = 48) {
@@ -1643,7 +1712,6 @@ function slugifyTitle(title, maxLength = 48) {
 	if (!normalized) return "item";
 	return normalized.slice(0, maxLength).replace(/-+$/g, "") || "item";
 }
-
 //#endregion
 //#region src/sync/paths.ts
 const FILE_NUMBER_PAD_LENGTH = 5;
@@ -1668,7 +1736,6 @@ function getItemFileName(number, title) {
 function getPrPatchPath(storageDirAbsolute, number, title) {
 	return join(storageDirAbsolute, PULL_DIR_NAME, getItemFileName(number, title).replace(/\.md$/, ".patch"));
 }
-
 //#endregion
 //#region src/sync/sync-repository-utils.ts
 function createCounters(scanned = 0, selected = 0) {
@@ -1711,7 +1778,6 @@ function relativeToStorage(storageDirAbsolute, absolutePath) {
 	if (absolutePath.startsWith(storageDirAbsolute)) return absolutePath.slice(storageDirAbsolute.length + 1);
 	return basename(absolutePath);
 }
-
 //#endregion
 //#region src/sync/sync-repository-storage.ts
 async function resolveIssuePaths(storageDirAbsolute, kind, number, title, state, trackedFilePath) {
@@ -1838,7 +1904,6 @@ async function pruneMissingOpenTrackedItems(storageDirAbsolute, syncState, openN
 	}
 	return patchesDeleted;
 }
-
 //#endregion
 //#region src/sync/sync-repository-item.ts
 async function prepareIssueCandidateSync(context, issue) {
@@ -2068,7 +2133,6 @@ async function resolveUniqueClosedTarget(closedDirAbsolute, fileName) {
 	}
 	return candidate;
 }
-
 //#endregion
 //#region src/sync/sync-repository-provider.ts
 async function fetchIssueCandidatesByPagination(context, since) {
@@ -2098,7 +2162,6 @@ async function fetchIssueCandidatesByNumbers(context, numbers) {
 		scanned: issues.length
 	};
 }
-
 //#endregion
 //#region src/utils/markdown.ts
 function getTimestamp(value) {
@@ -2124,7 +2187,6 @@ function escapeTableCell(value) {
 function escapeInlineCode(value) {
 	return value.replace(/`/g, "\\`");
 }
-
 //#endregion
 //#region src/sync/sync-repository-snapshot.ts
 async function writeRepoSnapshot(context) {
@@ -2227,7 +2289,6 @@ async function buildRepoSnapshot(context) {
 		milestones
 	};
 }
-
 //#endregion
 //#region src/sync/sync-repository.ts
 async function syncRepository(options) {
@@ -2482,7 +2543,6 @@ function computeTotals(items) {
 		trackedItems: totalIssues + totalPulls
 	};
 }
-
 //#endregion
 //#region src/cli/action-color.ts
 function colorizeAction(action, enabled = true) {
@@ -2536,7 +2596,6 @@ function wrapTextValue(value) {
 	if (normalized.length <= 48) return normalized;
 	return `${normalized.slice(0, 45)}...`;
 }
-
 //#endregion
 //#region src/cli/errors.ts
 function withErrorHandling(fn) {
@@ -2547,7 +2606,6 @@ function withErrorHandling(fn) {
 		});
 	};
 }
-
 //#endregion
 //#region src/cli/meta.ts
 const CLI_NAME = GHFS_NAME;
@@ -2565,7 +2623,6 @@ function ASCII_HEADER(repo) {
 function toGitHubRepoUrl(repo) {
 	return `https://github.com/${repo}`;
 }
-
 //#endregion
 //#region src/cli/printer.ts
 function createCliPrinter(command, options = {}) {
@@ -2686,7 +2743,7 @@ function createRichSyncReporter(printer) {
 			printer.success(`Sync finished. ${event.summary.updatedIssues} issues and ${event.summary.updatedPulls} PRs updated${c.dim(` (${formatDuration(event.summary.durationMs)})`)}.`);
 		},
 		onError(event) {
-			const message = `Sync failed${event.stage && !isHiddenSyncStage(event.stage) ? ` while ${describeStage(event.stage)}` : ""}: ${toErrorMessage(event.error)}`;
+			const message = `Sync failed${event.stage && !isHiddenSyncStage(event.stage) ? ` while ${describeStage(event.stage)}` : ""}: ${toErrorMessage$2(event.error)}`;
 			if (hasSyncProgress) {
 				syncProgress.error(message);
 				hasSyncProgress = false;
@@ -2726,7 +2783,7 @@ function createPlainSyncReporter(printer, progressEvery) {
 		},
 		onError(event) {
 			const stage = event.stage && !isHiddenSyncStage(event.stage) ? ` while ${describeStage(event.stage)}` : "";
-			printer.error(c.red(`Sync failed${stage}: ${toErrorMessage(event.error)}`));
+			printer.error(c.red(`Sync failed${stage}: ${toErrorMessage$2(event.error)}`));
 		}
 	};
 }
@@ -2764,7 +2821,7 @@ function createRichExecuteReporter(printer) {
 			printer.success(`${runMode} finished. Planned ${event.result.planned}, applied ${event.result.applied}, failed ${event.result.failed}.`);
 		},
 		onError(event) {
-			const message = `Execution failed: ${toErrorMessage(event.error)}`;
+			const message = `Execution failed: ${toErrorMessage$2(event.error)}`;
 			if (hasApplyProgress) {
 				applyProgress.error(message);
 				hasApplyProgress = false;
@@ -2788,7 +2845,7 @@ function createPlainExecuteReporter(printer) {
 			printer.success(`${runMode} finished. Planned ${event.result.planned}, applied ${event.result.applied}, failed ${event.result.failed}.`);
 		},
 		onError(event) {
-			printer.error(c.red(`Execution failed: ${toErrorMessage(event.error)}`));
+			printer.error(c.red(`Execution failed: ${toErrorMessage$2(event.error)}`));
 		}
 	};
 }
@@ -2808,7 +2865,7 @@ function formatStageCompletionLine(stage, snapshot, durationMs) {
 	if (stage === "pagination") return `Pagination scanned ${countNoun(snapshot.scanned, "candidate item")}${duration}.`;
 	if (stage === "fetch") return `Fetched updated issues/PRs (${snapshot.processed}/${snapshot.selected})${duration}.`;
 }
-function toErrorMessage(error) {
+function toErrorMessage$2(error) {
 	return error.message || String(error);
 }
 function formatKeyValueLines(entries, options = {}) {
@@ -2844,7 +2901,6 @@ function describeStage(stage) {
 	if (stage === "prune") return "pruning local artifacts";
 	return "saving sync state";
 }
-
 //#endregion
 //#region src/cli/prompts.ts
 async function promptForToken() {
@@ -2913,11 +2969,10 @@ async function confirmExecuteApply(count) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/cli/commands/execute.ts
 const PLAN_PREVIEW_LIMIT = 20;
-const defaultDependencies = {
+const defaultDependencies$1 = {
 	createCliPrinter,
 	resolveConfig,
 	isTTY: () => Boolean(process.stdin.isTTY),
@@ -2933,7 +2988,7 @@ const defaultDependencies = {
 function registerExecuteCommand(cli) {
 	cli.command("execute", "Execute operations from .ghfs/execute.yml").option("--repo <repo>", "GitHub repository in owner/name format").option("--file <file>", "Path to execute yaml file").option("--run", "Run mutations on GitHub").option("--non-interactive", "Disable interactive prompts").option("--continue-on-error", "Continue applying ops after a failure").action(withErrorHandling(async (options) => runExecuteCommand(options)));
 }
-async function runExecuteCommand(options, dependencies = defaultDependencies) {
+async function runExecuteCommand(options, dependencies = defaultDependencies$1) {
 	const printer = dependencies.createCliPrinter("execute");
 	const config = await dependencies.resolveConfig();
 	const storageDirAbsolute = getStorageDirAbsolute(config);
@@ -3090,7 +3145,6 @@ function printExecutionSummary(printer, result) {
 	}
 	printer.success(summary);
 }
-
 //#endregion
 //#region src/sync/status.ts
 async function getStatusSummary(config) {
@@ -3144,7 +3198,6 @@ async function getStatusSummary(config) {
 		} : void 0
 	};
 }
-
 //#endregion
 //#region src/cli/commands/status.ts
 function registerStatusCommand(cli) {
@@ -3163,7 +3216,6 @@ function registerStatusCommand(cli) {
 		printer.done("");
 	}));
 }
-
 //#endregion
 //#region src/cli/summary.ts
 function printSyncSummaryTable(printer, summary, title) {
@@ -3177,7 +3229,6 @@ function printSyncSummaryTable(printer, summary, title) {
 		["duration", formatDuration(summary.durationMs)]
 	]);
 }
-
 //#endregion
 //#region src/cli/commands/sync.ts
 function registerSyncCommand(cli) {
@@ -3213,7 +3264,647 @@ function setupSyncCommand(command) {
 		printer.done("Sync finished");
 	}));
 }
-
+//#endregion
+//#region src/cli/ui/server.ts
+const MIME_TYPES = {
+	".css": "text/css; charset=utf-8",
+	".html": "text/html; charset=utf-8",
+	".ico": "image/x-icon",
+	".js": "text/javascript; charset=utf-8",
+	".json": "application/json; charset=utf-8",
+	".map": "application/json; charset=utf-8",
+	".png": "image/png",
+	".svg": "image/svg+xml",
+	".txt": "text/plain; charset=utf-8",
+	".woff": "font/woff",
+	".woff2": "font/woff2"
+};
+async function createUiServer(options) {
+	const uiRoot = resolve(options.uiDir);
+	const uiRootPrefix = `${uiRoot}/`;
+	const indexPath = resolve(uiRoot, "index.html");
+	await assertFile(indexPath);
+	const server = createServer(async (req, res) => {
+		try {
+			const pathname = normalizeRequestPath(req.url || "/");
+			if (pathname === "/api/metadata.json") {
+				const body = `${JSON.stringify(options.getMetadata())}\n`;
+				res.statusCode = 200;
+				res.setHeader("Content-Type", "application/json; charset=utf-8");
+				res.end(body);
+				return;
+			}
+			const filePath = resolve(uiRoot, `.${pathname === "/" ? "/index.html" : pathname}`);
+			const resolvedFilePath = (filePath === uiRoot || filePath.startsWith(uiRootPrefix)) && await isFile(filePath) ? filePath : indexPath;
+			const body = await readFile(resolvedFilePath);
+			res.statusCode = 200;
+			res.setHeader("Content-Type", mimeTypeFor(resolvedFilePath));
+			res.end(body);
+		} catch (error) {
+			res.statusCode = 500;
+			res.setHeader("Content-Type", "text/plain; charset=utf-8");
+			res.end(`Internal Server Error: ${toErrorMessage$1(error)}`);
+		}
+	});
+	await new Promise((resolvePromise, reject) => {
+		server.once("error", reject);
+		server.listen(options.port, options.host, () => {
+			resolvePromise();
+		});
+	});
+	const address = server.address();
+	if (!address || typeof address === "string") throw new Error("Failed to start UI HTTP server");
+	return {
+		server,
+		close: () => {
+			return new Promise((resolvePromise, reject) => {
+				server.close((error) => {
+					if (error) {
+						reject(error);
+						return;
+					}
+					resolvePromise();
+				});
+			});
+		},
+		url: `http://${address.address === "127.0.0.1" ? "localhost" : address.address}:${address.port}`
+	};
+}
+function normalizeRequestPath(raw) {
+	const pathOnly = raw.split("?")[0].split("#")[0] || "/";
+	let decodedPath = pathOnly;
+	try {
+		decodedPath = decodeURIComponent(pathOnly);
+	} catch {
+		decodedPath = pathOnly;
+	}
+	const normalized = normalize(decodedPath);
+	return normalized.startsWith("/") ? normalized : `/${normalized}`;
+}
+async function assertFile(path) {
+	if (!await isFile(path)) throw new Error(`UI assets not found at ${path}`);
+}
+async function isFile(path) {
+	try {
+		return (await stat(path)).isFile();
+	} catch {
+		return false;
+	}
+}
+function mimeTypeFor(path) {
+	return MIME_TYPES[extname(path)] ?? "application/octet-stream";
+}
+function toErrorMessage$1(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+//#endregion
+//#region src/cli/ui/rpc.ts
+const REPLACEABLE_FAMILIES = new Set([
+	"title",
+	"body",
+	"state",
+	"labels",
+	"assignees",
+	"milestone",
+	"reviewers",
+	"draft"
+]);
+function createServerFunctions(options) {
+	const resolveRepoFn = options.resolveRepo ?? resolveRepo;
+	const resolveAuthTokenFn = options.resolveAuthToken ?? resolveAuthToken;
+	const executePendingChangesFn = options.executePendingChanges ?? executePendingChanges;
+	const appendExecutionResultFn = options.appendExecutionResult ?? appendExecutionResult;
+	const syncRepositoryFn = options.syncRepository ?? syncRepository;
+	const loadExecuteSourcesFn = options.loadExecuteSources ?? loadExecuteSources;
+	let executing = false;
+	async function getBootstrap() {
+		const syncState = await loadSyncState(options.storageDirAbsolute);
+		const loaded = await loadExecuteSourcesFn(options.executeFilePath);
+		const items = Object.values(syncState.items).map((entry) => {
+			const item = entry.data.item;
+			return {
+				number: entry.number,
+				kind: entry.kind,
+				state: entry.state,
+				title: item.title,
+				updatedAt: item.updatedAt,
+				createdAt: item.createdAt,
+				closedAt: item.closedAt,
+				author: item.author,
+				url: item.url,
+				labels: item.labels,
+				assignees: item.assignees,
+				milestone: item.milestone,
+				commentsCount: entry.data.comments.length,
+				isDraft: entry.data.pull?.isDraft,
+				merged: entry.data.pull?.merged,
+				requestedReviewers: entry.data.pull?.requestedReviewers ?? []
+			};
+		}).sort((left, right) => right.number - left.number);
+		const queue = toQueueEntries(loaded.entries, syncState.repo);
+		const openCount = items.filter((item) => item.state === "open").length;
+		return {
+			repo: syncState.repo,
+			syncedAt: syncState.lastSyncedAt,
+			lastSyncRunAt: syncState.lastSyncRun?.finishedAt,
+			totalTracked: items.length,
+			openCount,
+			closedCount: items.length - openCount,
+			warnings: loaded.warnings,
+			items,
+			queue,
+			queueSummary: {
+				total: queue.length,
+				executeYml: queue.filter((entry) => entry.source === "execute.yml").length,
+				executeMd: queue.filter((entry) => entry.source === "execute.md").length,
+				perItem: queue.filter((entry) => entry.source === "per-item").length
+			}
+		};
+	}
+	async function getItemDetail(number) {
+		const [syncState, repoSnapshot, loaded, yml] = await Promise.all([
+			loadSyncState(options.storageDirAbsolute),
+			readRepoSnapshot(options.storageDirAbsolute),
+			loadExecuteSourcesFn(options.executeFilePath),
+			readAndValidateExecuteFileWithSource(options.executeFilePath)
+		]);
+		const tracked = syncState.items[String(number)];
+		if (!tracked) throw new Error(`Item #${number} is not available in local mirror`);
+		const queue = toQueueEntries(loaded.entries, syncState.repo).filter((entry) => entry.op.number === number);
+		const effective = applyQueuedYmlOpsToItem(tracked, yml.ops.filter((op) => op.number === number));
+		return {
+			number: tracked.number,
+			kind: tracked.kind,
+			state: effective.state,
+			title: effective.title,
+			body: effective.body,
+			updatedAt: tracked.data.item.updatedAt,
+			createdAt: tracked.data.item.createdAt,
+			closedAt: tracked.data.item.closedAt,
+			author: tracked.data.item.author,
+			url: tracked.data.item.url,
+			labels: effective.labels,
+			assignees: effective.assignees,
+			milestone: effective.milestone,
+			commentsCount: tracked.data.comments.length,
+			comments: tracked.data.comments.map((comment) => ({
+				id: comment.id,
+				author: comment.author,
+				body: comment.body || "",
+				createdAt: comment.createdAt,
+				updatedAt: comment.updatedAt
+			})),
+			isDraft: effective.isDraft,
+			merged: tracked.data.pull?.merged,
+			requestedReviewers: effective.reviewers,
+			labelsCatalog: repoSnapshot?.labels ?? [],
+			milestonesCatalog: (repoSnapshot?.milestones ?? []).map((m) => ({
+				number: m.number,
+				title: m.title,
+				state: m.state
+			})),
+			queue
+		};
+	}
+	async function queueItemEdits(payload) {
+		const tracked = (await loadSyncState(options.storageDirAbsolute)).items[String(payload.number)];
+		if (!tracked) throw new Error(`Item #${payload.number} is not available in local mirror`);
+		const nextOps = toQueuedOps(tracked, payload);
+		const yml = await readAndValidateExecuteFileWithSource(options.executeFilePath);
+		const filteredOps = [];
+		for (const [index, op] of yml.ops.entries()) {
+			const family = getActionFamily(op.action);
+			if (op.number === payload.number && REPLACEABLE_FAMILIES.has(family)) continue;
+			filteredOps.push({
+				...op,
+				_actionInput: yml.sourceActions[index] ?? op.action
+			});
+		}
+		const writable = [...filteredOps.map(({ _actionInput, ...op }) => ({
+			...op,
+			action: _actionInput
+		})), ...nextOps.map((op) => ({
+			...op,
+			action: op.action
+		}))];
+		await writeExecuteFile(options.executeFilePath, writable);
+		return await notifyAndGetBootstrap(options.onStateChanged, getBootstrap);
+	}
+	async function removeQueueYmlEntry(index) {
+		const yml = await readAndValidateExecuteFileWithSource(options.executeFilePath);
+		if (!Number.isInteger(index) || index < 0 || index >= yml.ops.length) throw new Error(`Invalid execute.yml index: ${index}`);
+		const writable = yml.ops.map((op, opIndex) => ({
+			...op,
+			action: yml.sourceActions[opIndex] ?? op.action
+		})).filter((_, opIndex) => opIndex !== index);
+		await writeExecuteFile(options.executeFilePath, writable);
+		return await notifyAndGetBootstrap(options.onStateChanged, getBootstrap);
+	}
+	async function refresh() {
+		return await notifyAndGetBootstrap(options.onStateChanged, getBootstrap);
+	}
+	async function executeNow() {
+		if (executing) throw new Error("Execution is already in progress");
+		executing = true;
+		try {
+			const resolvedRepo = await resolveRepoFn({
+				cwd: options.config.cwd,
+				configRepo: options.config.repo,
+				interactive: false
+			});
+			const token = await resolveAuthTokenFn({
+				token: options.config.auth.token,
+				interactive: false
+			});
+			const result = await executePendingChangesFn({
+				config: options.config,
+				repo: resolvedRepo.repo,
+				token,
+				executeFilePath: options.executeFilePath,
+				apply: true,
+				nonInteractive: true,
+				continueOnError: false,
+				reporter: {
+					onStart: (event) => {
+						fireAndForget(options.onExecuteProgress, {
+							type: "start",
+							planned: event.planned,
+							repo: event.repo
+						});
+					},
+					onProgress: (event) => {
+						fireAndForget(options.onExecuteProgress, {
+							type: "progress",
+							repo: event.repo,
+							planned: event.planned,
+							completed: event.completed,
+							applied: event.applied,
+							failed: event.failed,
+							detail: event.detail
+						});
+					},
+					onError: (event) => {
+						fireAndForget(options.onExecuteProgress, {
+							type: "error",
+							message: toErrorMessage(event.error)
+						});
+					}
+				}
+			});
+			await appendExecutionResultFn(options.storageDirAbsolute, result);
+			const affectedNumbers = [...new Set(result.details.filter((detail) => detail.status === "applied").map((detail) => detail.number))];
+			if (affectedNumbers.length > 0) await syncRepositoryFn({
+				config: options.config,
+				repo: resolvedRepo.repo,
+				token,
+				numbers: affectedNumbers
+			});
+			await options.onExecuteComplete?.(result);
+			return {
+				result,
+				bootstrap: await notifyAndGetBootstrap(options.onStateChanged, getBootstrap)
+			};
+		} finally {
+			executing = false;
+		}
+	}
+	return {
+		getBootstrap,
+		getItemDetail,
+		queueItemEdits,
+		removeQueueYmlEntry,
+		refresh,
+		executeNow
+	};
+}
+function toQueueEntries(entries, repo) {
+	return entries.map((entry) => ({
+		id: `${entry.source}:${entry.sourceIndex}:${entry.mergedIndex}`,
+		mergedIndex: entry.mergedIndex,
+		source: entry.source,
+		sourceIndex: entry.sourceIndex,
+		editable: entry.source === "execute.yml",
+		op: entry.op,
+		description: describeCliOperation(entry.op, {
+			tty: false,
+			repo
+		})
+	}));
+}
+function toQueuedOps(tracked, payload) {
+	const current = tracked.data.item;
+	const reviewersCurrent = tracked.data.pull?.requestedReviewers ?? [];
+	const desiredLabels = normalizeStringArray(payload.labels);
+	const desiredAssignees = normalizeStringArray(payload.assignees);
+	const desiredReviewers = normalizeStringArray(payload.reviewers);
+	const desiredMilestone = normalizeMilestone(payload.milestone);
+	const desiredTitle = payload.title.trim() || current.title;
+	const desiredBody = payload.body.trim().length > 0 ? payload.body : current.body || "";
+	const desiredState = payload.state;
+	const desiredDraft = tracked.kind === "pull" ? Boolean(payload.isDraft) : tracked.data.pull?.isDraft;
+	const ops = computeExecuteDiffOps({
+		number: tracked.number,
+		current: {
+			title: current.title,
+			body: current.body,
+			state: current.state,
+			labels: current.labels,
+			assignees: current.assignees,
+			milestone: current.milestone,
+			reviewers: reviewersCurrent,
+			isDraft: tracked.data.pull?.isDraft
+		},
+		desired: {
+			title: desiredTitle,
+			body: desiredBody,
+			state: desiredState,
+			labels: desiredLabels,
+			assignees: desiredAssignees,
+			milestone: desiredMilestone,
+			reviewers: tracked.kind === "pull" ? desiredReviewers : reviewersCurrent,
+			isDraft: desiredDraft
+		},
+		ifUnchangedSince: current.updatedAt,
+		includeBody: true
+	});
+	const comment = payload.comment.trim();
+	if (comment) ops.push({
+		action: "add-comment",
+		number: tracked.number,
+		body: comment
+	});
+	return ops;
+}
+function applyQueuedYmlOpsToItem(tracked, ops) {
+	let title = tracked.data.item.title;
+	let body = tracked.data.item.body || "";
+	let state = tracked.data.item.state;
+	let labels = [...tracked.data.item.labels];
+	let assignees = [...tracked.data.item.assignees];
+	let milestone = tracked.data.item.milestone;
+	let reviewers = [...tracked.data.pull?.requestedReviewers ?? []];
+	let isDraft = tracked.data.pull?.isDraft;
+	for (const op of ops) switch (op.action) {
+		case "set-title":
+			title = op.title;
+			break;
+		case "set-body":
+			body = op.body;
+			break;
+		case "close":
+		case "close-with-comment":
+			state = "closed";
+			break;
+		case "reopen":
+			state = "open";
+			break;
+		case "add-labels":
+			labels = mergeStrings(labels, op.labels);
+			break;
+		case "remove-labels":
+			labels = removeStrings(labels, op.labels);
+			break;
+		case "set-labels":
+			labels = normalizeStringArray(op.labels);
+			break;
+		case "add-assignees":
+			assignees = mergeStrings(assignees, op.assignees);
+			break;
+		case "remove-assignees":
+			assignees = removeStrings(assignees, op.assignees);
+			break;
+		case "set-assignees":
+			assignees = normalizeStringArray(op.assignees);
+			break;
+		case "set-milestone":
+			milestone = String(op.milestone);
+			break;
+		case "clear-milestone":
+			milestone = null;
+			break;
+		case "request-reviewers":
+			reviewers = mergeStrings(reviewers, op.reviewers);
+			break;
+		case "remove-reviewers":
+			reviewers = removeStrings(reviewers, op.reviewers);
+			break;
+		case "convert-to-draft":
+			if (tracked.kind === "pull") isDraft = true;
+			break;
+		case "mark-ready-for-review":
+			if (tracked.kind === "pull") isDraft = false;
+			break;
+		default: break;
+	}
+	return {
+		title,
+		body,
+		state,
+		labels,
+		assignees,
+		milestone,
+		reviewers,
+		isDraft
+	};
+}
+async function notifyAndGetBootstrap(onStateChanged, getBootstrap) {
+	const bootstrap = await getBootstrap();
+	await onStateChanged?.(bootstrap);
+	return bootstrap;
+}
+function getActionFamily(action) {
+	switch (action) {
+		case "set-title": return "title";
+		case "set-body": return "body";
+		case "close":
+		case "reopen": return "state";
+		case "add-labels":
+		case "remove-labels":
+		case "set-labels": return "labels";
+		case "add-assignees":
+		case "remove-assignees":
+		case "set-assignees": return "assignees";
+		case "set-milestone":
+		case "clear-milestone": return "milestone";
+		case "request-reviewers":
+		case "remove-reviewers": return "reviewers";
+		case "mark-ready-for-review":
+		case "convert-to-draft": return "draft";
+		case "add-comment":
+		case "close-with-comment": return "comment";
+		default: return "other";
+	}
+}
+function mergeStrings(base, incoming) {
+	const known = new Set(base);
+	const merged = [...base];
+	for (const value of normalizeStringArray(incoming)) {
+		if (known.has(value)) continue;
+		known.add(value);
+		merged.push(value);
+	}
+	return merged;
+}
+function removeStrings(base, removing) {
+	const removingSet = new Set(normalizeStringArray(removing));
+	return base.filter((value) => !removingSet.has(value));
+}
+function fireAndForget(callback, payload) {
+	if (!callback) return;
+	Promise.resolve(callback(payload)).catch(() => {});
+}
+function toErrorMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+async function readRepoSnapshot(storageDirAbsolute) {
+	const path = resolve(storageDirAbsolute, REPO_SNAPSHOT_FILE_NAME);
+	if (!await pathExists(path)) return void 0;
+	try {
+		const raw = await readFile(path, "utf8");
+		return JSON.parse(raw);
+	} catch {
+		return;
+	}
+}
+//#endregion
+//#region src/cli/ui/ws.ts
+async function createWsServer(options) {
+	const wss = new WebSocketServer({
+		host: options.host,
+		port: options.port ?? 0
+	});
+	await waitForListen(wss);
+	const wsClients = /* @__PURE__ */ new Set();
+	let rpc;
+	const serverFunctions = createServerFunctions({
+		...options,
+		onStateChanged: (bootstrap) => rpc.broadcast.onStateChanged.asEvent(bootstrap),
+		onExecuteProgress: (event) => rpc.broadcast.onExecuteProgress.asEvent(event),
+		onExecuteComplete: (result) => rpc.broadcast.onExecuteComplete.asEvent(result)
+	});
+	rpc = createBirpcGroup(serverFunctions, [], {
+		timeout: 12e4,
+		onFunctionError(error, name) {
+			console.error(c.red(`RPC error on "${name}":`));
+			console.error(error);
+		}
+	});
+	wss.on("connection", (ws) => {
+		wsClients.add(ws);
+		const channel = {
+			post: (d) => ws.send(d),
+			on: (fn) => {
+				ws.on("message", (data) => {
+					fn(data);
+				});
+			},
+			serialize: stringify$1,
+			deserialize: parse$1
+		};
+		rpc.updateChannels((channels) => {
+			channels.push(channel);
+		});
+		ws.on("close", () => {
+			wsClients.delete(ws);
+			rpc.updateChannels((channels) => {
+				const index = channels.indexOf(channel);
+				if (index >= 0) channels.splice(index, 1);
+			});
+		});
+	});
+	return {
+		wss,
+		rpc,
+		serverFunctions,
+		close: async () => {
+			for (const client of wsClients) client.terminate();
+			await new Promise((resolve, reject) => {
+				wss.close((error) => {
+					if (error) {
+						reject(error);
+						return;
+					}
+					resolve();
+				});
+			});
+		},
+		getMetadata() {
+			const address = wss.address();
+			if (!address) throw new Error("WebSocket server is not listening");
+			return {
+				backend: "websocket",
+				websocket: address.port
+			};
+		}
+	};
+}
+async function waitForListen(server) {
+	await new Promise((resolve, reject) => {
+		server.once("listening", () => resolve());
+		server.once("error", (error) => reject(error));
+	});
+}
+//#endregion
+//#region src/cli/commands/ui.ts
+const defaultDependencies = {
+	createCliPrinter,
+	resolveConfig,
+	ensureExecuteArtifacts,
+	createUiServer,
+	createWsServer
+};
+function registerUiCommand(cli) {
+	cli.command("ui", "Serve local Web UI for synced mirror and execute queue").option("--host <host>", "Host for local UI server", { default: "127.0.0.1" }).option("--port <port>", "Port for local UI server", { default: 3589 }).action(withErrorHandling(async (options) => {
+		await runUiCommand(options);
+	}));
+}
+async function runUiCommand(options, dependencies = defaultDependencies) {
+	const printer = dependencies.createCliPrinter("ui");
+	const host = options.host || "127.0.0.1";
+	const parsedPort = Number(options.port);
+	const port = Number.isFinite(parsedPort) && parsedPort >= 0 ? parsedPort : 3589;
+	const config = await dependencies.resolveConfig();
+	const storageDirAbsolute = getStorageDirAbsolute(config);
+	const executeFilePath = resolve(config.cwd, getExecuteFile(config));
+	const uiDir = resolve(config.cwd, "dist/ui");
+	await dependencies.ensureExecuteArtifacts(executeFilePath);
+	const ws = await dependencies.createWsServer({
+		host,
+		config,
+		executeFilePath,
+		storageDirAbsolute
+	});
+	let http;
+	try {
+		http = await dependencies.createUiServer({
+			host,
+			port,
+			uiDir,
+			getMetadata: ws.getMetadata
+		});
+	} catch (error) {
+		await ws.close().catch(() => {});
+		throw error;
+	}
+	printer.success(`Web UI ready at ${http.url}`);
+	printer.info(`RPC websocket listening on ${ws.getMetadata().websocket}`);
+	printer.info("Press Ctrl+C to stop.");
+	let shuttingDown = false;
+	const shutdown = async () => {
+		if (shuttingDown) return;
+		shuttingDown = true;
+		await Promise.allSettled([http.close(), ws.close()]);
+		process.exit(0);
+	};
+	process.once("SIGINT", () => {
+		shutdown();
+	});
+	process.once("SIGTERM", () => {
+		shutdown();
+	});
+}
 //#endregion
 //#region src/cli/index.ts
 function createCli() {
@@ -3221,6 +3912,7 @@ function createCli() {
 	registerSyncCommand(cli);
 	registerExecuteCommand(cli);
 	registerStatusCommand(cli);
+	registerUiCommand(cli);
 	cli.help();
 	cli.version(CLI_VERSION);
 	return cli;
@@ -3228,10 +3920,8 @@ function createCli() {
 function runCli(argv = process.argv) {
 	createCli().parse(argv);
 }
-
 //#endregion
 //#region src/cli.ts
 runCli();
-
 //#endregion
-export {  };
+export {};