minecodex 0.2.2 → 1.0.1

package/features/images/web/styles.css

@@ -4,6 +4,12 @@
   --color-token-main-surface-primary: #fff;
   --color-token-bg-primary: #f9f9f9;
   --color-token-bg-secondary: color-mix(in srgb, #f9f9f9 92%, transparent);
+  --color-surface-tertiary: #f0f0f0;
+  --color-surface-elevated-secondary: #fff;
+  --color-border-subtle: color-mix(in oklab, #1a1c1f 4%, transparent);
+  --color-background-primary-ghost-hover: color-mix(in oklab, #1a1c1f 5%, transparent);
+  --color-chart-blue: #339cff;
+  --color-text-inverse: #fff;
   --color-background-elevated-primary-opaque: #fff;
   --color-background-panel: #f5f5f5;
   --color-background-primary-solid: #1a1c1f;
@@ -48,6 +54,12 @@
   --color-token-main-surface-primary: #181818;
   --color-token-bg-primary: #141414;
   --color-token-bg-secondary: color-mix(in srgb, #141414 92%, transparent);
+  --color-surface-tertiary: rgb(40 40 40);
+  --color-surface-elevated-secondary: rgb(45 45 45);
+  --color-border-subtle: rgb(255 255 255 / 4.2%);
+  --color-background-primary-ghost-hover: rgb(255 255 255 / 7.8%);
+  --color-chart-blue: #339cff;
+  --color-text-inverse: rgb(13 13 13);
   --color-background-elevated-primary-opaque: #363636;
   --color-background-panel: #232323;
   --color-background-primary-solid: #fff;
@@ -76,6 +88,12 @@
     --color-token-main-surface-primary: #181818;
     --color-token-bg-primary: #141414;
     --color-token-bg-secondary: color-mix(in srgb, #141414 92%, transparent);
+    --color-surface-tertiary: rgb(40 40 40);
+    --color-surface-elevated-secondary: rgb(45 45 45);
+    --color-border-subtle: rgb(255 255 255 / 4.2%);
+    --color-background-primary-ghost-hover: rgb(255 255 255 / 7.8%);
+    --color-chart-blue: #339cff;
+    --color-text-inverse: rgb(13 13 13);
     --color-background-elevated-primary-opaque: #363636;
     --color-background-panel: #232323;
     --color-background-primary-solid: #fff;
@@ -810,6 +828,68 @@ h1,
   background: var(--color-token-bg-primary);
 }
 
+/* Native-token image editor: tokens arrive from RuntimeHost with the active Codex theme. */
+.image-editor { position: relative; background: var(--color-token-bg-primary); }
+.image-editor [hidden] { display: none !important; }
+.image-editor-controls { position: sticky; z-index: 6; top: 0; background: var(--color-token-bg-primary); }
+.image-editor-toolbar { position: relative; display: flex; justify-content: center; min-height: 48px; padding: 8px 16px; }
+.image-edit-actions, .image-edit-mode { display: flex; min-width: 0; align-items: center; gap: 2px; padding: 2px; overflow: hidden; border-radius: 9999px; background: color-mix(in srgb, var(--color-surface-tertiary) 95%, transparent); box-shadow: 0 0 0 1px var(--color-border-subtle), var(--shadow-md); backdrop-filter: blur(4px); }
+.image-edit-action, .image-edit-mode button { display: inline-flex; height: 28px; align-items: center; justify-content: center; gap: 4px; border: 1px solid transparent; border-radius: 999px; padding: 0 6px; background: transparent; color: var(--color-text-foreground); font-family: var(--font-sans-default); font-size: var(--text-base); font-weight: var(--font-weight-normal); line-height: 18px; white-space: nowrap; cursor: pointer; }
+.image-edit-action:hover, .image-edit-action[aria-expanded="true"], .image-edit-mode button:hover { background: var(--color-background-primary-ghost-hover); }
+.image-edit-action:focus-visible, .image-edit-mode button:focus-visible, .image-zoom-trigger:focus-visible, .image-edit-menu button:focus-visible { outline: 1px solid var(--color-border-focus); outline-offset: 1px; }
+.image-edit-mode button:disabled { color: var(--color-text-foreground-tertiary); cursor: default; }
+.image-edit-mode > span { min-width: 0; overflow: hidden; padding: 0 6px; color: var(--color-text-foreground-tertiary); font-size: var(--text-base); line-height: 18px; text-overflow: ellipsis; white-space: nowrap; }
+.image-edit-mode button { width: 28px; padding: 0; flex: 0 0 auto; }
+.image-edit-mode button > svg { width: 16px; height: 16px; fill: currentColor; }
+.image-edit-mode button[aria-label="Redo"] > svg { transform: scaleX(-1); }
+.image-edit-mode [data-edit-cancel] { color: var(--color-text-foreground-tertiary); }
+.image-edit-mode [data-edit-cancel] > svg { width: 14px; height: 14px; }
+.image-edit-mode [data-edit-send] { width: auto; padding: 0 6px; background: var(--color-chart-blue); color: var(--color-text-inverse); }
+.image-edit-mode [data-edit-send]:hover { background: color-mix(in srgb, var(--color-chart-blue) 90%, transparent); }
+.image-edit-mode [data-edit-send]:disabled { color: var(--color-text-inverse); opacity: .4; }
+.image-zoom-trigger { position: absolute; top: 8px; right: 10px; height: 28px; display: inline-flex; align-items: center; gap: 2px; border: 1px solid transparent; border-radius: var(--radius-lg); padding: 0 8px; background: transparent; color: var(--color-text-foreground-tertiary); cursor: pointer; font-family: var(--font-sans-default); font-size: var(--text-sm); font-weight: var(--font-weight-normal); line-height: 20px; font-variant-numeric: tabular-nums; }
+.image-zoom-trigger:hover, .image-zoom-trigger[aria-expanded="true"] { background: var(--color-background-primary-ghost-hover); }
+.image-zoom-trigger [data-zoom-chevron] { width: 12px; height: 12px; fill: none; stroke: currentColor; stroke-width: 1.5; opacity: .5; }
+.image-edit-menu { position: absolute; z-index: 8; width: 160px; padding: 4px; border: 0; border-radius: var(--radius-xl); background: color-mix(in srgb, var(--color-surface-elevated-secondary) 90%, transparent); box-shadow: 0 0 0 .5px var(--color-border), var(--shadow-xl); backdrop-filter: blur(4px); }
+.image-edit-menu button { display: flex; width: 100%; align-items: center; gap: 6px; border: 0; border-radius: var(--radius-lg); padding: 5px 8px; background: transparent; color: var(--color-text-foreground); font-family: var(--font-sans-default); font-size: var(--text-sm); font-weight: var(--font-weight-normal); line-height: var(--text-sm--line-height); text-align: left; cursor: pointer; }
+.image-edit-menu button:hover { background: var(--color-background-primary-ghost-hover); }
+.image-ratio-label { min-width: 0; flex: 1; display: flex; align-items: center; justify-content: space-between; gap: 16px; }
+.image-ratio-label small { margin: 0; color: var(--color-text-foreground-tertiary); font-size: inherit; }
+.image-ratio-icon { display: block; width: 16px; height: 16px; flex: 0 0 auto; fill: currentColor; opacity: .75; }
+.image-menu-check { width: 17px; height: 17px; flex: 0 0 auto; fill: currentColor; opacity: .75; }
+.image-menu-check.is-hidden { visibility: hidden; }
+.image-menu-separator { height: 1px; margin: 0 8px; background: var(--color-border); }
+.image-zoom-menu { width: 136px; padding: 6px; border-radius: 10px; }
+.image-zoom-menu button { border-radius: 6px; padding: 5px 5px 5px 8px; line-height: 20px; }
+.image-editor-stage { position: relative; overflow: auto; touch-action: none; }
+.image-editor-stage img { transform-origin: center; transition: transform 120ms ease-out; }
+.image-edit-mask, .image-comment-layer { position: absolute; inset: 0; width: 100%; height: 100%; }
+.image-edit-mask { cursor: crosshair; opacity: .5; color: var(--color-text-accent); }
+.image-comment-layer { pointer-events: none; }
+.image-comment-marker { position: absolute; display: flex; width: 30px; height: 30px; align-items: center; justify-content: center; border: 0; padding: 0; background: transparent; color: var(--color-text-accent); font-family: var(--font-sans-default); transform: translate(-50%, -50%); }
+button.image-comment-marker { pointer-events: auto; cursor: pointer; }
+.image-comment-marker > svg { position: absolute; inset: 0; width: 30px; height: 30px; fill: currentColor; overflow: visible; stroke: white; stroke-width: 1.65; }
+.image-comment-marker > span { position: relative; z-index: 1; color: white; font-size: 10px; font-weight: 700; line-height: 10px; transform: translate(-1px, -1px); }
+.image-comment-popover { position: absolute; z-index: 4; width: min(294px, calc(100% - 16px)); height: 44px; padding: 8px 8px 8px 16px; border: 0; border-radius: 22px; background: var(--color-surface-elevated-secondary); box-shadow: 0 0 0 1px var(--color-border-subtle), var(--shadow-md); }
+.image-comment-popover input { width: 100%; height: 28px; border: 0; padding: 0; outline: 0; background: transparent; color: var(--color-token-input-foreground); font-family: var(--font-sans-default); font-size: var(--text-base); font-weight: var(--font-weight-normal); line-height: 21px; }
+.image-comment-popover.is-existing-comment { height: 120px; padding: 8px 12px 8px 16px; }
+.image-comment-popover textarea { display: block; width: 100%; height: 60px; resize: none; border: 0; padding: 2px 0 0; outline: 0; background: transparent; color: var(--color-token-input-foreground); font-family: var(--font-sans-default); font-size: var(--text-base); font-weight: var(--font-weight-normal); line-height: 24px; }
+.image-comment-editor-footer { height: 44px; display: flex; align-items: end; justify-content: space-between; }
+.image-comment-editor-actions { display: flex; gap: 6px; }
+.image-comment-editor-footer button { height: 28px; border: 1px solid var(--color-border); border-radius: 999px; padding: 0 8px; background: color-mix(in srgb, var(--color-token-main-surface-primary) 96%, transparent); color: var(--color-text-foreground); font-family: var(--font-sans-default); font-size: var(--text-sm); font-weight: var(--font-weight-normal); line-height: 18px; cursor: pointer; }
+.image-comment-editor-footer button:hover { background: var(--color-background-primary-ghost-hover); }
+.image-comment-editor-footer .image-comment-delete { width: 28px; padding: 0; border-color: transparent; background: transparent; }
+.image-comment-delete > svg { width: 20px; height: 20px; fill: currentColor; }
+.image-comment-editor-footer .image-comment-save { border-color: transparent; background: var(--color-background-primary-solid); color: var(--color-text-button-primary); }
+.image-comment-editor-footer button:disabled { cursor: default; opacity: .4; }
+.image-brush-slider { position: absolute; z-index: 3; top: 50%; left: 16px; transform: translateY(-50%) rotate(-90deg); transform-origin: center; }
+.image-brush-slider input { accent-color: var(--color-text-accent); }
+.image-edit-menu[data-resize-menu] { top: 48px; left: 50%; transform: translateX(-50%); }
+.image-zoom-menu { top: 48px; right: 10px; }
+.image-edit-action > svg { width: 16px; height: 16px; flex: 0 0 auto; fill: currentColor; }
+.image-edit-action > [data-native-image-icon="resize"] { width: 18px; height: 18px; }
+@media (max-width: 520px) { .image-edit-action span { display: none; } .image-edit-action { width: 28px; padding: 0; } }
+
 .drawer-figure img {
   max-width: 100%;
   max-height: min(68vh, 720px);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "0.2.2",
+  "version": "1.0.1",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",

package/packages/cli/src/commands.mjs

@@ -4,7 +4,7 @@ import { createInterface } from "node:readline/promises";
 import { assertNodeSupported, MacPlatformAdapter } from "./platform.mjs";
 import { ensureConfig, ensureControlToken, readConfig } from "./config.mjs";
 import { createControlServer } from "./control-server.mjs";
-import { createInstallReporter } from "./install-progress.mjs";
+import { createProgressReporter } from "./progress.mjs";
 import { createNpmAdapter } from "./npm-adapter.mjs";
 import { resolvePaths } from "./paths.mjs";
 import { RuntimeManager, writeServicePid } from "./runtime-manager.mjs";
@@ -119,7 +119,7 @@ export async function confirmRestartNow({ input = process.stdin, terminalOutput
 }
 
 async function installCommand({ paths, platform, cliPath, output, serviceProbe, fetchImpl, confirmRestart, nodeVersion = process.versions.node }) {
-  const reporter = createInstallReporter({ output });
+  const reporter = createProgressReporter({ output });
   reporter.heading("Installing MineCodex");
   let previousService = null;
   try {
@@ -167,21 +167,30 @@ async function installCommand({ paths, platform, cliPath, output, serviceProbe,
 }
 }
 
-async function openCommand({ paths, platform, serviceProbe, fetchImpl }) {
+async function openCommand({ paths, platform, output, serviceProbe, fetchImpl }) {
   const waitForServiceImpl = serviceProbe?.waitForService ?? waitForService;
+  let reporter = null;
   if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl, timeoutMs: 750 }))) {
     if (!(await serviceInstalled(platform, paths))) throw new Error("MineCodex is not installed. Run `mcx install` first.");
-    await platform.startService(paths);
-    if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl }))) throw new Error("MineCodex service could not be started.");
+    reporter = createProgressReporter({ output });
+    reporter.heading("Opening MineCodex");
+    await reporter.step(1, 2, "Starting the background helper", async () => {
+      await platform.startService(paths);
+      if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl }))) throw new Error("MineCodex service could not be started.");
+    });
   }
-  const exchangeResponse = await authorizedFetch(paths, "/api/auth/exchange", {
-    method: "POST",
-    body: "{}",
-  }, { fetchImpl });
-  if (!exchangeResponse.ok) throw new Error(`MineCodex browser exchange failed: HTTP ${exchangeResponse.status}`);
-  const { exchange } = await exchangeResponse.json();
-  if (!exchange) throw new Error("MineCodex browser exchange did not return a short-lived value.");
-  await platform.openBrowser(`${controlOrigin()}/auth?exchange=${encodeURIComponent(exchange)}`);
+  const openControlPanel = async () => {
+    const exchangeResponse = await authorizedFetch(paths, "/api/auth/exchange", {
+      method: "POST",
+      body: "{}",
+    }, { fetchImpl });
+    if (!exchangeResponse.ok) throw new Error(`MineCodex browser exchange failed: HTTP ${exchangeResponse.status}`);
+    const { exchange } = await exchangeResponse.json();
+    if (!exchange) throw new Error("MineCodex browser exchange did not return a short-lived value.");
+    await platform.openBrowser(`${controlOrigin()}/auth?exchange=${encodeURIComponent(exchange)}`);
+  };
+  if (reporter) await reporter.step(2, 2, "Opening the control panel", openControlPanel);
+  else await openControlPanel();
 }
 
 function featureStatusText(feature) {
@@ -239,95 +248,130 @@ async function statusCommand({ paths, platform, jsonOutput, output, fetchImpl })
 }
 
 async function restartCommand({ paths, output, fetchImpl }) {
-  const response = await authorizedFetch(paths, "/api/restart", { method: "POST", body: "{}" }, { fetchImpl });
-  if (!response.ok) throw new Error(`MineCodex restart failed: HTTP ${response.status}`);
-  output("MineCodex restarted and saved plugin switches are now applied.");
+  const reporter = createProgressReporter({ output });
+  reporter.heading("Restarting MineCodex");
+  await reporter.step(1, 1, "Restarting Codex and applying plugin changes", async () => {
+    const response = await authorizedFetch(paths, "/api/restart", { method: "POST", body: "{}" }, { fetchImpl });
+    if (!response.ok) throw new Error(`MineCodex restart failed: HTTP ${response.status}`);
+  });
+  reporter.heading("MineCodex restarted and saved plugin switches are now applied.");
 }
 
 async function uninstallCommand({ paths, platform, purge, output, cliPath }) {
-  platform.assertInstallSupported();
-  const previousService = await serviceSnapshot(platform, paths);
+  const reporter = createProgressReporter({ output });
+  reporter.heading("Uninstalling MineCodex");
+  const previousService = await reporter.step(1, 2, "Checking the current installation", async () => {
+    platform.assertInstallSupported();
+    return serviceSnapshot(platform, paths);
+  });
   let wasManaged = false;
   try {
-    await platform.removeService(paths);
-    wasManaged = await platform.terminateOwnedCodex(paths);
-    await platform.assertServiceStopped?.();
-    await platform.assertOwnedCodexStopped?.(paths);
-    if (purge) {
-      const targets = [paths.supportDir, paths.notesDataDir, paths.imagesDataDir];
-      for (const target of targets) {
-        if (!path.isAbsolute(target) || target === paths.homeDir || target.length <= paths.homeDir.length + 2) {
-          throw new Error(`Refusing unsafe purge target: ${target}`);
+    await reporter.step(2, 2, purge ? "Removing MineCodex and its data" : "Removing the MineCodex integration", async () => {
+      await platform.removeService(paths);
+      wasManaged = await platform.terminateOwnedCodex(paths);
+      await platform.assertServiceStopped?.();
+      await platform.assertOwnedCodexStopped?.(paths);
+      if (purge) {
+        const targets = [paths.supportDir, paths.notesDataDir, paths.imagesDataDir];
+        for (const target of targets) {
+          if (!path.isAbsolute(target) || target === paths.homeDir || target.length <= paths.homeDir.length + 2) {
+            throw new Error(`Refusing unsafe purge target: ${target}`);
+          }
         }
+        for (const target of targets) await rm(target, { recursive: true, force: true });
       }
-      for (const target of targets) await rm(target, { recursive: true, force: true });
-      output("MineCodex integration and MineCodex-owned data were removed.");
-    } else {
-      output("MineCodex integration was removed. Plugin data was preserved.");
-    }
+    });
   } catch (error) {
     let rollbackError = null;
+    reporter.heading("Uninstall failed. Restoring the background helper.");
     try {
-      await restoreService(platform, previousService, { cliPath, paths });
+      await reporter.step(1, 1, "Restoring the background helper", async () => {
+        await restoreService(platform, previousService, { cliPath, paths });
+      });
     } catch (failure) {
       rollbackError = failure;
     }
     throw appendRollbackError(error, rollbackError);
   }
-  if (wasManaged) await platform.openNativeCodex();
-  output("Codex generated images and files referenced by Notes were not modified.");
+  reporter.heading(purge
+    ? "MineCodex integration and MineCodex-owned data were removed."
+    : "MineCodex integration was removed. Plugin data was preserved.");
+  if (wasManaged) {
+    await reporter.step(1, 1, "Reopening Codex", async () => platform.openNativeCodex());
+  }
+  reporter.heading("Codex generated images and files referenced by Notes were not modified.");
 }
 
 async function updateCommand({ paths, platform, cliPath, output, npm = createNpmAdapter(), serviceProbe, fetchImpl }) {
-  platform.assertInstallSupported();
-  const latest = await npm.viewLatestVersion();
-  if (!latest) throw new Error("Could not resolve the latest MineCodex version.");
+  const reporter = createProgressReporter({ output });
+  reporter.heading("Updating MineCodex");
+  const latest = await reporter.step(1, 5, "Checking for updates", async () => {
+    platform.assertInstallSupported();
+    const version = await npm.viewLatestVersion();
+    if (!version) throw new Error("Could not resolve the latest MineCodex version.");
+    return version;
+  });
   if (latest === packageMetadata.version) {
-    output(`MineCodex ${packageMetadata.version} is already up to date.`);
+    reporter.heading(`MineCodex ${packageMetadata.version} is already up to date.`);
     return;
   }
-  const wasInstalled = await serviceInstalled(platform, paths);
-  const previousService = wasInstalled
-    ? (await serviceSnapshot(platform, paths) ?? { running: true, plist: { exists: true } })
-    : null;
-  const rollback = await npm.createRollbackArchive(paths.packageRoot);
+  let wasInstalled;
+  let previousService;
+  const rollback = await reporter.step(2, 5, "Backing up the current version", async () => {
+    wasInstalled = await serviceInstalled(platform, paths);
+    previousService = wasInstalled
+      ? (await serviceSnapshot(platform, paths) ?? { running: true, plist: { exists: true } })
+      : null;
+    return npm.createRollbackArchive(paths.packageRoot);
+  });
   const rollbackPath = typeof rollback === "string" ? rollback : rollback.archivePath;
   if (!rollbackPath) throw new Error("Could not create a rollback archive for the installed MineCodex version.");
   try {
-    if (wasInstalled && previousService?.running) {
-      await platform.stopService(paths, { ignoreErrors: false });
-      await platform.assertServiceStopped?.();
-    }
-    await npm.installGlobal("minecodex@latest");
-    if (wasInstalled) {
-      await platform.installService({ cliPath, paths, start: previousService.running });
-      if (previousService.running) {
-        const waitForServiceImpl = serviceProbe?.waitForService ?? waitForService;
-        const waitForManagedReadyImpl = serviceProbe?.waitForManagedReady ?? waitForManagedReady;
-        if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl }))
-          || !(await waitForManagedReadyImpl(paths, { fetchImpl }))) {
-          throw new Error("MineCodex service did not become ready after update.");
-        }
-      } else {
+    await reporter.step(3, 5, "Pausing the background helper", async () => {
+      if (wasInstalled && previousService?.running) {
+        await platform.stopService(paths, { ignoreErrors: false });
         await platform.assertServiceStopped?.();
       }
-    }
-    output(`MineCodex updated from ${packageMetadata.version} to ${latest}.`);
+    });
+    await reporter.step(4, 5, `Installing MineCodex ${latest}`, async () => {
+      await npm.installGlobal("minecodex@latest");
+    });
+    await reporter.step(5, 5, "Restoring the background helper", async () => {
+      if (wasInstalled) {
+        await platform.installService({ cliPath, paths, start: previousService.running });
+        if (previousService.running) {
+          const waitForServiceImpl = serviceProbe?.waitForService ?? waitForService;
+          const waitForManagedReadyImpl = serviceProbe?.waitForManagedReady ?? waitForManagedReady;
+          if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl }))
+            || !(await waitForManagedReadyImpl(paths, { fetchImpl }))) {
+            throw new Error("MineCodex service did not become ready after update.");
+          }
+        } else {
+          await platform.assertServiceStopped?.();
+        }
+      }
+    });
+    reporter.heading(`MineCodex updated from ${packageMetadata.version} to ${latest}.`);
   } catch (error) {
     let rollbackError = null;
+    reporter.heading("Update failed. Restoring the previous version.");
     try {
-      await npm.installGlobal(rollbackPath);
-      await restoreService(platform, previousService, { cliPath, paths });
-      if (wasInstalled && previousService?.running) {
-        const waitForServiceImpl = serviceProbe?.waitForService ?? waitForService;
-        const waitForManagedReadyImpl = serviceProbe?.waitForManagedReady ?? waitForManagedReady;
-        if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl }))
-          || !(await waitForManagedReadyImpl(paths, { fetchImpl }))) {
-          throw new Error("Rolled-back MineCodex service did not become ready.");
+      await reporter.step(1, 2, "Restoring the previous version", async () => {
+        await npm.installGlobal(rollbackPath);
+      });
+      await reporter.step(2, 2, "Restoring the background helper", async () => {
+        await restoreService(platform, previousService, { cliPath, paths });
+        if (wasInstalled && previousService?.running) {
+          const waitForServiceImpl = serviceProbe?.waitForService ?? waitForService;
+          const waitForManagedReadyImpl = serviceProbe?.waitForManagedReady ?? waitForManagedReady;
+          if (!(await waitForServiceImpl(DEFAULT_CONTROL_PORT, { fetchImpl }))
+            || !(await waitForManagedReadyImpl(paths, { fetchImpl }))) {
+            throw new Error("Rolled-back MineCodex service did not become ready.");
+          }
+        } else if (wasInstalled && !previousService?.running) {
+          await platform.assertServiceStopped?.();
         }
-      } else if (wasInstalled && !previousService?.running) {
-        await platform.assertServiceStopped?.();
-      }
+      });
     } catch (failure) {
       rollbackError = failure;
     }
@@ -397,7 +441,7 @@ export async function runCli(argv, {
   if (["--help", "-h", "help"].includes(command)) return printHelp(output);
   if (["--version", "-v"].includes(command)) return output(packageMetadata.version);
   if (command === "install") return installCommand({ paths, platform, cliPath, output, serviceProbe, fetchImpl, confirmRestart, nodeVersion });
-  if (command === "open" || command === "gui") return openCommand({ paths, platform, serviceProbe, fetchImpl });
+  if (command === "open" || command === "gui") return openCommand({ paths, platform, output, serviceProbe, fetchImpl });
   if (command === "status") return statusCommand({ paths, platform, jsonOutput: args.includes("--json"), output, fetchImpl });
   if (command === "restart") return restartCommand({ paths, output, fetchImpl });
   if (command === "uninstall" || command === "remove") {

package/packages/cli/src/{install-progress.mjs → progress.mjs}

@@ -1,6 +1,6 @@
 const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
-function createInstallReporter({ output = console.log, terminalOutput = process.stdout } = {}) {
+function createProgressReporter({ output = console.log, terminalOutput = process.stdout } = {}) {
   // 只有真实终端才显示 spinner；测试或脚本环境保持普通逐行文本。
   const interactive = output === console.log && Boolean(terminalOutput?.isTTY);
   let timer = null;
@@ -53,4 +53,4 @@ function createInstallReporter({ output = console.log, terminalOutput = process.
   };
 }
 
-export { createInstallReporter };
+export { createProgressReporter };