mellos-mapping 0.23.0 → 0.24.0

package/README.md

@@ -661,6 +661,26 @@ by a test, so a graphical client (a web panel, an editor view) can parse state
 files and reuse the exact aggregation, zoom and glyph semantics the terminal
 pane draws with.
 
+## Optional GitHub Star reminder
+
+npm/npx installations may show one small, dismissible reminder after at least
+7 days and successful map viewing on 3 different UTC dates. Web viewers show
+it inline without taking focus; a native interactive terminal shows it only
+after a successful viewing session exits. It is never added to MCP replies,
+AI prompts, install logs, CI or piped output. Plugin editions and source
+checkouts are excluded.
+
+The reminder is claimed once per user, across projects, versions and installs.
+The Star button opens GitHub in the system's default browser, keeping its
+existing sign-in session. A failed launch leaves the notice open with a copy-address option.
+Closing it, following its Star link, or simply leaving the session means it
+will not appear again. To suppress it before it appears, set
+`MELLOS_MAPPING_NO_STAR=1` in the environment of the viewer/MCP process.
+Only the first-use time, last UTC day, a capped day count and the one-time flag
+are stored in `~/.mellos/support/star-reminder.json`; nothing is uploaded and
+GitHub is contacted only when the user follows the link. Unreadable settings
+or a busy store silently skip the reminder.
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -596,6 +596,22 @@ npm run verify
 守护——图形客户端（web 面板、编辑器视图）可以直接解析状态文件，并复用与
 终端面板完全一致的聚合、缩放与字形语义。
 
+## 可选的 GitHub Star 提醒
+
+仅 npm/npx 安装会在首次成功查看地图满 7 天、且已在至少 3 个不同 UTC 日期
+成功查看地图后，显示一次轻提示。网页中是一行可关闭的文字，不抢焦点；
+原生交互终端只在正常退出地图后提示。MCP 返回、AI 提示词、安装日志、CI
+及管道输出中都不会加入提醒，插件版和源码运行也不触发。
+
+Star 按钮会调用系统默认浏览器打开 GitHub，方便沿用已有登录状态。
+若未能打开，会保留提示并提供复制地址按钮。
+提醒按用户跨项目、版本及安装去重，一生效就记为已提醒。关闭、点击 Star
+或直接离开后，都不会再次出现。想提前关闭，可在启动地图或 MCP 的环境中
+设置 `MELLOS_MAPPING_NO_STAR=1`。
+仅在 `~/.mellos/support/star-reminder.json` 本地记录首次使用时间、最后一个
+UTC 日期、最多 3 天的计数和已提醒标记，不上传数据，不查询是否点过 Star；
+只有用户主动点击链接时才访问 GitHub。设置损坏、不可写或锁忙时静默跳过。
+
 ## 许可证
 
 MIT

package/dist/server.mjs

@@ -24590,7 +24590,7 @@ function launcherViewerPid(run) {
 
 // src/server/server.ts
 var SERVER_NAME = "mellos-mapping";
-var SERVER_VERSION = "0.23.0";
+var SERVER_VERSION = "0.24.0";
 function text(s, isError = false) {
   return { content: [{ type: "text", text: s }], ...isError ? { isError: true } : {} };
 }

package/dist/terminal-worker.mjs

@@ -2896,6 +2896,7 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
         lastHits = [];
       } else {
         const windowed = rendered.value;
+        if (map.nodes.length > 0) io.onMapRendered?.();
         const maxX = Math.max(0, windowed.contentWidth - viewW);
         const maxY = Math.max(0, windowed.contentHeight - viewH);
         if (view.offsetX > maxX || view.offsetY > maxY || view.offsetX < 0 || view.offsetY < 0) {

package/dist/watch.mjs

@@ -2735,12 +2735,12 @@ function viewerReportOf(pane, defaultFile) {
   const shown = pane.activeFile ?? pane.pendingFocusFile ?? defaultFile;
   return { page: pageIdOfFile(defaultFile, shown), follow: pane.follow };
 }
-function runWatcher(cfg, io = nativeWatcherIO()) {
+function runWatcher(cfg, io2 = nativeWatcherIO()) {
   const renderScene = createWindowRenderer();
   if (migrateLegacyStore(cfg.file)) console.error("mellos-mapping: moved the legacy .claude map store to .mellos/ \u2014 commit the move.");
   sweepQuitRequest(cfg.file);
   sweepQuitRequest(cfg.file, process.pid);
-  const interactive = io.interactive;
+  const interactive = io2.interactive;
   const mouseActive = interactive && cfg.mouse;
   let lastFrame = "";
   let spinnerFrame = 0;
@@ -2749,8 +2749,8 @@ function runWatcher(cfg, io = nativeWatcherIO()) {
   const standbyNotice = "waiting for the first mmap_declare ...";
   let map;
   let notice = standbyNotice;
-  let lastCols = io.output.columns ?? 0;
-  let lastRows = io.output.rows ?? 0;
+  let lastCols = io2.output.columns ?? 0;
+  let lastRows = io2.output.rows ?? 0;
   let pane = initialPaneState(
     cfg.follow,
     cfg.page === void 0 ? void 0 : pageFilePath(cfg.file, cfg.page)
@@ -2777,8 +2777,8 @@ function runWatcher(cfg, io = nativeWatcherIO()) {
     }
     return false;
   };
-  const viewWidth = () => usableColumns(io.output.columns ?? FALLBACK_COLUMNS);
-  const viewHeight = () => Math.max(1, (io.output.rows ?? FALLBACK_ROWS) - (1 + panelContentRows) - 1 - tabRows());
+  const viewWidth = () => usableColumns(io2.output.columns ?? FALLBACK_COLUMNS);
+  const viewHeight = () => Math.max(1, (io2.output.rows ?? FALLBACK_ROWS) - (1 + panelContentRows) - 1 - tabRows());
   const dividerY = () => tabRows() + viewHeight() + 1;
   const pageTabsOf = (files) => files.map((f) => {
     const entry = entryOf(pane, f);
@@ -2833,20 +2833,20 @@ function runWatcher(cfg, io = nativeWatcherIO()) {
     return lastHits.find((h) => cx >= h.x && cx < h.x + h.w && cy >= h.y && cy < h.y + h.h)?.id;
   };
   const publishPresence = () => {
-    io.report?.(viewerReportOf(pane, cfg.file));
+    io2.report?.(viewerReportOf(pane, cfg.file));
     publishViewer(cfg.file, process.pid, {
       ...viewerReportOf(pane, cfg.file),
       ...cfg.owner === void 0 ? {} : { owner: cfg.owner }
     });
   };
-  if (interactive) io.input.setRawMode(true);
-  const terminal = openTerminalSession({ interactive, mouse: cfg.mouse, write: (text) => io.output.write(text) });
+  if (interactive) io2.input.setRawMode(true);
+  const terminal = openTerminalSession({ interactive, mouse: cfg.mouse, write: (text) => io2.output.write(text) });
   const frameOutput = interactive ? createFrameOutput({
-    write: (text) => io.output.write(text),
+    write: (text) => io2.output.write(text),
     onDrain: (ready) => {
-      io.output.once("drain", ready);
+      io2.output.once("drain", ready);
       return () => {
-        io.output.off("drain", ready);
+        io2.output.off("drain", ready);
       };
     }
   }) : void 0;
@@ -2877,9 +2877,9 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
   const paint2 = () => {
     clearTimeout(paintTimer);
     paintTimer = void 0;
-    const cols = io.output.columns ?? FALLBACK_COLUMNS;
+    const cols = io2.output.columns ?? FALLBACK_COLUMNS;
     const viewW = viewWidth();
-    panelContentRows = clampPanelRows(panelContentRows, io.output.rows ?? FALLBACK_ROWS, tabRows());
+    panelContentRows = clampPanelRows(panelContentRows, io2.output.rows ?? FALLBACK_ROWS, tabRows());
     const viewH = viewHeight();
     const focus = view.hoverId ?? view.selectedId;
     let body;
@@ -2897,6 +2897,7 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
         lastHits = [];
       } else {
         const windowed = rendered.value;
+        if (map.nodes.length > 0) io2.onMapRendered?.();
         const maxX = Math.max(0, windowed.contentWidth - viewW);
         const maxY = Math.max(0, windowed.contentHeight - viewH);
         if (view.offsetX > maxX || view.offsetY > maxY || view.offsetX < 0 || view.offsetY < 0) {
@@ -2990,7 +2991,7 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
     } else {
       const frame = HOME + rows.map((row) => row + ERASE_LINE_END).join("\n");
       if (frame !== lastFrame) {
-        io.output.write(frame);
+        io2.output.write(frame);
         lastFrame = frame;
       }
     }
@@ -2999,16 +3000,16 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
     paintTimer ??= setTimeout(paint2, 16);
   };
   const handleResize = () => {
-    lastCols = io.output.columns ?? lastCols;
-    lastRows = io.output.rows ?? lastRows;
+    lastCols = io2.output.columns ?? lastCols;
+    lastRows = io2.output.rows ?? lastRows;
     lastFrame = "";
     frameOutput?.invalidate();
-    io.output.write(CLEAR_ALL);
+    io2.output.write(CLEAR_ALL);
     paint2();
   };
   const tick = () => {
     if (takeQuitRequest(cfg.file, process.pid)) quit();
-    if ((io.output.columns ?? lastCols) !== lastCols || (io.output.rows ?? lastRows) !== lastRows) {
+    if ((io2.output.columns ?? lastCols) !== lastCols || (io2.output.rows ?? lastRows) !== lastRows) {
       handleResize();
     }
     const discovered = listPageFiles(cfg.file);
@@ -3077,9 +3078,9 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
     tick();
   };
   if (interactive) {
-    io.input.resume();
-    io.input.setEncoding("utf8");
-    io.input.on("data", (chunk) => {
+    io2.input.resume();
+    io2.input.setEncoding("utf8");
+    io2.input.on("data", (chunk) => {
       const parsed2 = parseInput(pendingInput + chunk);
       pendingInput = parsed2.rest;
       let dirty = false;
@@ -3152,7 +3153,7 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
             break;
           case "mouse-drag":
             if (view.dividerDrag) {
-              const next = panelRowsFromDividerY(event.y, io.output.rows ?? FALLBACK_ROWS, tabRows());
+              const next = panelRowsFromDividerY(event.y, io2.output.rows ?? FALLBACK_ROWS, tabRows());
               if (next !== panelContentRows) {
                 panelContentRows = next;
                 dirty = true;
@@ -3248,7 +3249,7 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
         else paint2();
       }
     });
-    io.output.on("resize", handleResize);
+    io2.output.on("resize", handleResize);
   }
   tick();
   setInterval(tick, cfg.intervalMs);
@@ -3263,6 +3264,73 @@ the map pane stopped: ${e instanceof Error ? e.stack ?? e.message : String(e)}
   }
 }
 
+// src/watch/cli.ts
+import { homedir as homedir2 } from "node:os";
+import { fileURLToPath } from "node:url";
+
+// src/support/star-reminder.ts
+import { existsSync as existsSync5, readFileSync as readFileSync5, realpathSync as realpathSync3 } from "node:fs";
+import { basename as basename2, dirname as dirname10, join as join9 } from "node:path";
+var STAR_URL = "https://github.com/GuangminJu/mellos-mapping";
+var DAY_MS = 864e5;
+function isNpmInstallation(entry) {
+  try {
+    const root = dirname10(dirname10(realpathSync3(entry)));
+    if (basename2(dirname10(root)).toLowerCase() !== "node_modules" || existsSync5(join9(root, ".git")) || existsSync5(join9(root, ".codex-plugin")) || existsSync5(join9(root, ".claude-plugin"))) return false;
+    const pkg = JSON.parse(readFileSync5(join9(root, "package.json"), "utf8"));
+    return pkg.name === "mellos-mapping" && pkg.bin?.mmap === "dist/mmap.mjs";
+  } catch {
+    return false;
+  }
+}
+function starReminderFile(userBase) {
+  return join9(userBase, ".mellos", "support", "star-reminder.json");
+}
+function enabledFlag(value) {
+  return !!value && value !== "0" && value.toLowerCase() !== "false";
+}
+function validState(value) {
+  if (!value || typeof value !== "object") return false;
+  const s = value;
+  return s.version === 1 && Number.isFinite(s.firstSeen) && s.firstSeen >= 0 && Number.isSafeInteger(s.lastDay) && s.lastDay >= Math.floor(s.firstSeen / DAY_MS) && Number.isSafeInteger(s.days) && s.days >= 1 && s.days <= 3 && typeof s.notified === "boolean";
+}
+function createStarReminder(options) {
+  const eligible = isNpmInstallation(options.entry) && !enabledFlag(options.env["CI"]) && !enabledFlag(options.env["MELLOS_MAPPING_NO_STAR"]);
+  const file = starReminderFile(options.userBase);
+  return {
+    visit() {
+      if (!eligible) return false;
+      try {
+        return withStoreLock(file, () => {
+          const now = (options.now ?? Date.now)();
+          if (!Number.isFinite(now) || now < 0) return false;
+          const day = Math.floor(now / DAY_MS);
+          let state;
+          try {
+            const saved2 = JSON.parse(readFileSync5(file, "utf8"));
+            if (!validState(saved2)) return false;
+            state = saved2;
+          } catch (error) {
+            if (error.code !== "ENOENT") return false;
+            state = { version: 1, firstSeen: now, lastDay: day, days: 1, notified: false };
+          }
+          if (state.notified || now < state.firstSeen || day < state.lastDay) return false;
+          if (day > state.lastDay) {
+            state.days = Math.min(3, state.days + 1);
+            state.lastDay = day;
+          }
+          const show = state.days >= 3 && now - state.firstSeen >= 7 * DAY_MS;
+          if (show) state.notified = true;
+          const saved = writeAtomic(file, JSON.stringify(state, null, 2) + "\n", 1);
+          return saved.ok && show;
+        });
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+
 // src/watch/cli.ts
 var parsed = parseArgs(process.argv.slice(2), process.cwd());
 if (!parsed.ok) {
@@ -3270,4 +3338,17 @@ if (!parsed.ok) {
 ${USAGE}`);
   process.exit(1);
 }
-runWatcher(parsed.value);
+var viewed = false;
+var io = nativeWatcherIO();
+var reminder = createStarReminder({ entry: fileURLToPath(import.meta.url), userBase: homedir2(), env: process.env });
+runWatcher(parsed.value, { ...io, onMapRendered: () => {
+  viewed = true;
+} });
+process.on("exit", (code) => {
+  if (code === 0 && viewed && io.interactive && process.stderr.isTTY && process.env["TERM"] !== "dumb" && reminder.visit()) {
+    process.stderr.write(`
+If Mellos Mapping has been useful, a GitHub Star is welcome: ${STAR_URL}
+This optional reminder will not appear again.
+`);
+  }
+});

package/dist/web/app.css

@@ -724,7 +724,8 @@ h2 {
   margin-left: 20px;
 }
 footer {
-  height: 29px;
+  min-height: 29px;
+  flex-wrap: wrap;
   flex-shrink: 0;
   border-top: 1px solid var(--line);
   display: flex;
@@ -919,7 +920,7 @@ dialog p {
   #app {
     display: grid;
     grid-template-columns: minmax(0, 1fr) 300px;
-    grid-template-rows: 58px auto auto minmax(0, 1fr) 29px;
+    grid-template-rows: 58px auto auto minmax(0, 1fr) auto;
   }
   header {
     grid-column: 1 / -1;
@@ -965,3 +966,106 @@ dialog p {
     grid-column: 1 / -1;
   }
 }
+
+#star-reminder {
+  --star-surface: linear-gradient(115deg, #15302e, #202341 48%, #36243b);
+  --star-text: #f2f5ff;
+  --star-muted: #c9d2e5;
+  width: 100%;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 10px 14px;
+  margin: 4px 0 8px;
+  padding: 12px 16px;
+  border: 1px solid transparent;
+  border-radius: 12px;
+  background: var(--star-surface) padding-box,
+    linear-gradient(110deg, #69ebc9, #8299ff, #d897ff, #ffc17d, #69ebc9) border-box;
+  background-size: 200% 100%;
+  color: var(--star-text);
+  font-size: 14px;
+  line-height: 1.5;
+  animation: star-color-flow 6s ease-in-out 2, star-glow 3s ease-in-out 4;
+}
+#star-reminder::before {
+  content: "★";
+  display: grid;
+  place-items: center;
+  flex: 0 0 36px;
+  height: 36px;
+  border: 1px solid #ffe49950;
+  border-radius: 10px;
+  background: #f9c76916;
+  color: #ffe49b;
+  font-size: 26px;
+  line-height: 1;
+  text-shadow: 0 0 14px #ffd47870;
+  animation: star-beat 3s ease-in-out 4;
+}
+#star-reminder > span { flex: 1 1 230px; font-weight: 550; }
+#star-reminder a {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 36px;
+  padding: 7px 16px;
+  border: 1px solid #ffffff50;
+  border-radius: 8px;
+  background: linear-gradient(110deg, #8bf0d0, #babaff 55%, #ffd0aa);
+  color: #17243a;
+  font-size: 13px;
+  font-weight: 750;
+  line-height: 1.4;
+  text-decoration: none;
+  white-space: nowrap;
+  box-shadow: 0 2px 12px #8b96ff25;
+}
+#star-reminder a:hover { filter: brightness(1.1); }
+#star-reminder a[aria-disabled=true] { cursor: progress; opacity: .8; }
+#star-reminder .star-open-error { flex: 1 1 100%; display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-size: 12px; color: var(--star-muted); }
+#star-reminder .star-open-error input { min-width: 0; max-width: 100%; width: 340px; padding: 6px; color: var(--star-text); background: transparent; border: 1px solid #b8c5e470; border-radius: 6px; }
+#star-reminder button {
+  min-height: 34px;
+  padding: 6px 10px;
+  border: 1px solid #b8c5e42e;
+  border-radius: 8px;
+  background: transparent;
+  color: var(--star-muted);
+  font-size: 12px;
+  line-height: 1.4;
+  white-space: nowrap;
+}
+#star-reminder button:hover { background: #a0b5f014; border-color: #b8c5e470; }
+#star-reminder a:focus-visible, #star-reminder button:focus-visible {
+  outline: 2px solid #b0b9ff;
+  outline-offset: 3px;
+}
+#star-reminder:hover, #star-reminder:focus-within,
+#star-reminder:hover::before, #star-reminder:focus-within::before { animation-play-state: paused; }
+[data-theme=light] #star-reminder {
+  --star-surface: linear-gradient(115deg, #e4fbf5, #eeedff 48%, #fff0e5);
+  --star-text: #263451;
+  --star-muted: #53607b;
+}
+[data-theme=light] #star-reminder::before { color: #a5660c; background: #ffe6aa80; border-color: #dbae6340; text-shadow: none; }
+@keyframes star-color-flow {
+  0%, 100% { background-position: 0% 50%; }
+  50% { background-position: 100% 50%; }
+}
+@keyframes star-glow {
+  0%, 100% { box-shadow: 0 0 0 #8299ff00; }
+  50% { box-shadow: 0 0 16px #8299ff30, inset 0 0 18px #b897ff0c; }
+}
+@keyframes star-beat {
+  0%, 100% { transform: scale(1) rotate(0deg); }
+  50% { transform: scale(1.1) rotate(-7deg); }
+}
+@media (max-width: 520px) {
+  #star-reminder { padding: 12px; gap: 10px; }
+  #star-reminder > span { flex-basis: calc(100% - 50px); font-size: 13px; }
+  #star-reminder a { margin-left: 46px; }
+}
+@media (prefers-reduced-motion: reduce) {
+  #star-reminder, #star-reminder::before { animation: none; }
+}

package/dist/web/app.js

@@ -904,6 +904,82 @@ function zoomScene(state, factor, x, y) {
   };
 }
 
+// src/web/star-reminder.ts
+function createStarNotice(base2) {
+  let attempted = false;
+  const notice = document.getElementById("star-reminder");
+  const link = notice.querySelector("a");
+  let opening = false;
+  link.title = "\u5728\u7CFB\u7EDF\u9ED8\u8BA4\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 GitHub";
+  const dismiss = () => {
+    notice.hidden = true;
+  };
+  notice.querySelector("button").addEventListener("click", dismiss);
+  const launch = async (event) => {
+    event.preventDefault();
+    if (opening) return;
+    opening = true;
+    link.setAttribute("aria-disabled", "true");
+    link.textContent = "\u6B63\u5728\u6253\u5F00\u2026";
+    notice.querySelector(".star-open-error")?.remove();
+    try {
+      const response = await fetch(new URL("api/star-reminder/open", base2), { method: "POST", signal: AbortSignal.timeout(8e3) });
+      const result = await response.json();
+      if (!response.ok || result.opened !== true) throw new Error("Not opened");
+      dismiss();
+    } catch {
+      const error = document.createElement("div");
+      error.className = "star-open-error";
+      error.setAttribute("role", "status");
+      const message = document.createElement("span");
+      message.textContent = "\u9ED8\u8BA4\u6D4F\u89C8\u5668\u672A\u80FD\u6253\u5F00\uFF0C\u53EF\u91CD\u8BD5\u6216\u590D\u5236\u5730\u5740\u3002";
+      const copy = document.createElement("button");
+      copy.type = "button";
+      copy.textContent = "\u590D\u5236 GitHub \u5730\u5740";
+      copy.addEventListener("click", () => {
+        void (async () => {
+          try {
+            await navigator.clipboard.writeText(link.href);
+            copy.textContent = "\u5DF2\u590D\u5236";
+          } catch {
+            const address = document.createElement("input");
+            address.readOnly = true;
+            address.value = link.href;
+            address.setAttribute("aria-label", "GitHub \u5730\u5740");
+            copy.replaceWith(address);
+            address.focus();
+            address.select();
+          }
+        })();
+      });
+      error.append(message, copy);
+      notice.append(error);
+    } finally {
+      opening = false;
+      link.removeAttribute("aria-disabled");
+      link.textContent = "\u53BB\u70B9 Star \u2197";
+    }
+  };
+  link.addEventListener("click", (event) => {
+    void launch(event);
+  });
+  link.addEventListener("auxclick", (event) => {
+    if (event.button === 1) void launch(event);
+  });
+  return (page) => {
+    if (attempted || document.visibilityState !== "visible") return;
+    attempted = true;
+    const url = new URL("api/star-reminder/visit", base2);
+    if (page) url.searchParams.set("page", page);
+    void fetch(url, { method: "POST", signal: AbortSignal.timeout(3e3) }).then(async (response) => {
+      if (!response.ok) return;
+      const result = await response.json();
+      if (result.show === true && document.visibilityState === "visible") notice.hidden = false;
+    }).catch(() => {
+    });
+  };
+}
+
 // src/web/app.ts
 var element = (id) => document.getElementById(id);
 var viewport = element("viewport");
@@ -913,6 +989,7 @@ var pages = element("pages");
 var search = element("search");
 var dialog = element("dialog");
 var base = new URL(".", window.location.href);
+var starNotice = createStarNotice(base);
 var kinds = { dev: "\u5F00\u53D1\u5730\u56FE", architecture: "\u67B6\u6784\u5730\u56FE", dataflow: "\u6570\u636E\u6D41", "behavior-tree": "\u884C\u4E3A\u6811", sequence: "\u65F6\u5E8F\u5730\u56FE" };
 var snapshot = { project: "", pages: [] };
 var revision = "";
@@ -1340,6 +1417,7 @@ async function poll() {
         }
         if (initial || JSON.stringify(priorPage) !== JSON.stringify(current())) render();
         else renderHeading();
+        if ((current()?.map?.nodes.length ?? 0) > 0 && !current()?.error) starNotice(currentId);
         element("updated").textContent = `\u5DF2\u540C\u6B65 ${(/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN", { hour12: false })}`;
       }
     }

package/dist/web/index.html

@@ -5,5 +5,5 @@
 <section class="map-heading"><div class="project-line"><span id="project">本地项目</span><span>/</span><span id="kind">开发地图</span></div><div class="title-row"><h1 id="title">正在读取地图…</h1><select id="pages" aria-label="切换地图页面"></select></div><div id="breadcrumbs"></div><div class="progress-row"><span id="summary"></span><div id="progress"><i></i></div><button id="follow" class="follow active" aria-pressed="true">● 自动跟随</button></div></section>
 <section class="toolbar"><label class="search"><svg viewBox="0 0 20 20" aria-hidden="true"><circle cx="8" cy="8" r="5.5"/><path d="m12 12 5 5"/></svg><input id="search" placeholder="搜索模块、说明…" aria-label="搜索模块"><kbd>/</kbd></label><button id="overview" class="tool-button" aria-pressed="false">分组概览</button><button id="export" class="icon-button" title="导出 SVG" aria-label="导出 SVG">↓</button><button id="delete" class="icon-button" title="删除当前地图" aria-label="删除当前地图">×</button></section>
 <section class="canvas-shell"><div id="viewport" tabindex="0" aria-label="交互地图画布"><div id="stage"></div><div id="empty" hidden></div></div><div id="filters" class="filters" aria-label="按状态筛选"><button data-status="all" class="active">全部</button><button data-status="planned"><i class="planned"></i>待开发</button><button data-status="in-progress"><i class="in-progress"></i>进行中</button><button data-status="done"><i class="done"></i>已验证</button><button data-status="regressed"><i class="regressed"></i>回归</button><button data-status="unverified"><i class="unverified"></i>待验证</button></div><div class="zoom-controls"><button id="zoom-out" aria-label="缩小">−</button><output id="zoom-label">100%</output><button id="zoom-in" aria-label="放大">+</button><span></span><button id="fit" title="适应窗口 · 0" aria-label="适应窗口">⛶</button></div><div id="minimap" title="点击移动视口"></div><div id="match-count" role="status"></div></section>
-<div id="divider" role="separator" aria-label="调整详情高度" aria-orientation="horizontal" aria-valuemin="100" aria-valuemax="500" aria-valuenow="210" tabindex="0"><i></i></div><aside id="inspector"></aside><footer><span>滚轮缩放 · 拖动画布 · 双击进入子地图</span><span id="updated">等待同步</span></footer>
+<div id="divider" role="separator" aria-label="调整详情高度" aria-orientation="horizontal" aria-valuemin="100" aria-valuemax="500" aria-valuenow="210" tabindex="0"><i></i></div><aside id="inspector"></aside><footer><span>滚轮缩放 · 拖动画布 · 双击进入子地图</span><span id="updated">等待同步</span><aside id="star-reminder" aria-label="支持 Mellos Mapping" hidden><span>地图有帮到你？欢迎在 GitHub 点个 Star。</span><a href="https://github.com/GuangminJu/mellos-mapping" target="_blank" rel="noopener noreferrer">去点 Star ↗</a><button type="button">不再提醒</button></aside></footer>
 </main><div id="toast" role="status" hidden></div><dialog id="dialog"><h2 id="dialog-title"></h2><p id="dialog-body"></p><div class="dialog-actions"><button id="dialog-cancel">关闭</button><button id="dialog-confirm" class="danger" hidden>删除此地图</button></div></dialog></body></html>

package/dist/web/terminal.css

@@ -7,3 +7,106 @@ header{display:flex;align-items:center;justify-content:space-between;gap:12px;pa
 footer{min-height:32px;display:flex;flex-wrap:wrap;align-items:center;gap:8px 12px;padding:5px 14px;border-top:1px solid #283343;color:#8c9eb5;font-size:11px}#connection{overflow-wrap:anywhere}#connection[data-state="connected"]{color:#81dbae}#connection[data-state="error"]{color:#ffaf87}.hint{margin-left:auto}[hidden]{display:none!important}
 @media(max-width:440px){.brand span{margin-left:6px}.hint{margin-left:0;width:100%}header{padding:0 10px}#terminal .xterm{padding-left:4px;padding-right:4px}}
 dialog{max-width:min(420px,90vw);border:1px solid #3b4b60;border-radius:10px;background:#151c25;color:#d9e2ed;padding:24px}dialog::backdrop{background:#0009}dialog h2{font-size:18px;margin-top:0}dialog p{line-height:1.9;font-size:13px}dialog form{text-align:right}
+
+#star-reminder {
+  --star-surface: linear-gradient(115deg, #15302e, #202341 48%, #36243b);
+  --star-text: #f2f5ff;
+  --star-muted: #c9d2e5;
+  width: 100%;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 10px 14px;
+  margin: 4px 0 8px;
+  padding: 12px 16px;
+  border: 1px solid transparent;
+  border-radius: 12px;
+  background: var(--star-surface) padding-box,
+    linear-gradient(110deg, #69ebc9, #8299ff, #d897ff, #ffc17d, #69ebc9) border-box;
+  background-size: 200% 100%;
+  color: var(--star-text);
+  font-size: 14px;
+  line-height: 1.5;
+  animation: star-color-flow 6s ease-in-out 2, star-glow 3s ease-in-out 4;
+}
+#star-reminder::before {
+  content: "★";
+  display: grid;
+  place-items: center;
+  flex: 0 0 36px;
+  height: 36px;
+  border: 1px solid #ffe49950;
+  border-radius: 10px;
+  background: #f9c76916;
+  color: #ffe49b;
+  font-size: 26px;
+  line-height: 1;
+  text-shadow: 0 0 14px #ffd47870;
+  animation: star-beat 3s ease-in-out 4;
+}
+#star-reminder > span { flex: 1 1 230px; font-weight: 550; }
+#star-reminder a {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 36px;
+  padding: 7px 16px;
+  border: 1px solid #ffffff50;
+  border-radius: 8px;
+  background: linear-gradient(110deg, #8bf0d0, #babaff 55%, #ffd0aa);
+  color: #17243a;
+  font-size: 13px;
+  font-weight: 750;
+  line-height: 1.4;
+  text-decoration: none;
+  white-space: nowrap;
+  box-shadow: 0 2px 12px #8b96ff25;
+}
+#star-reminder a:hover { filter: brightness(1.1); }
+#star-reminder a[aria-disabled=true] { cursor: progress; opacity: .8; }
+#star-reminder .star-open-error { flex: 1 1 100%; display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-size: 12px; color: var(--star-muted); }
+#star-reminder .star-open-error input { min-width: 0; max-width: 100%; width: 340px; padding: 6px; color: var(--star-text); background: transparent; border: 1px solid #b8c5e470; border-radius: 6px; }
+#star-reminder button {
+  min-height: 34px;
+  padding: 6px 10px;
+  border: 1px solid #b8c5e42e;
+  border-radius: 8px;
+  background: transparent;
+  color: var(--star-muted);
+  font-size: 12px;
+  line-height: 1.4;
+  white-space: nowrap;
+}
+#star-reminder button:hover { background: #a0b5f014; border-color: #b8c5e470; }
+#star-reminder a:focus-visible, #star-reminder button:focus-visible {
+  outline: 2px solid #b0b9ff;
+  outline-offset: 3px;
+}
+#star-reminder:hover, #star-reminder:focus-within,
+#star-reminder:hover::before, #star-reminder:focus-within::before { animation-play-state: paused; }
+[data-theme=light] #star-reminder {
+  --star-surface: linear-gradient(115deg, #e4fbf5, #eeedff 48%, #fff0e5);
+  --star-text: #263451;
+  --star-muted: #53607b;
+}
+[data-theme=light] #star-reminder::before { color: #a5660c; background: #ffe6aa80; border-color: #dbae6340; text-shadow: none; }
+@keyframes star-color-flow {
+  0%, 100% { background-position: 0% 50%; }
+  50% { background-position: 100% 50%; }
+}
+@keyframes star-glow {
+  0%, 100% { box-shadow: 0 0 0 #8299ff00; }
+  50% { box-shadow: 0 0 16px #8299ff30, inset 0 0 18px #b897ff0c; }
+}
+@keyframes star-beat {
+  0%, 100% { transform: scale(1) rotate(0deg); }
+  50% { transform: scale(1.1) rotate(-7deg); }
+}
+@media (max-width: 520px) {
+  #star-reminder { padding: 12px; gap: 10px; }
+  #star-reminder > span { flex-basis: calc(100% - 50px); font-size: 13px; }
+  #star-reminder a { margin-left: 46px; }
+}
+@media (prefers-reduced-motion: reduce) {
+  #star-reminder, #star-reminder::before { animation: none; }
+}

package/dist/web/terminal.html

@@ -2,6 +2,6 @@
 <html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Mellos · 终端地图</title><link rel="icon" href="data:,"><link rel="stylesheet" href="./xterm.css"><link rel="stylesheet" href="./terminal.css"><script type="module" src="./terminal.js"></script></head>
 <body><header><a class="brand" id="graphic" href="./" title="切换到图形地图">Mellos <span>图形地图 ↗</span></a><div class="tools"><label for="font-size">字号</label><select id="font-size" aria-label="终端字号"><option>10</option><option>11</option><option>12</option><option selected>13</option><option>14</option><option>15</option><option>16</option><option>18</option><option>20</option><option>24</option><option>28</option></select><button id="help" aria-label="操作帮助">?</button></div></header>
 <main id="terminal" aria-label="Mellos 终端地图"></main>
-<footer><span id="connection" role="status" aria-live="polite">正在连接…</span><button id="restart" hidden>重新连接</button><span class="hint">滚轮缩放 · 拖动平移 · 点击选择 · ? 帮助</span></footer>
+<footer><span id="connection" role="status" aria-live="polite">正在连接…</span><button id="restart" hidden>重新连接</button><span class="hint">滚轮缩放 · 拖动平移 · 点击选择 · ? 帮助</span><aside id="star-reminder" aria-label="支持 Mellos Mapping" hidden><span>地图有帮到你？欢迎在 GitHub 点个 Star。</span><a href="https://github.com/GuangminJu/mellos-mapping" target="_blank" rel="noopener noreferrer">去点 Star ↗</a><button type="button">不再提醒</button></aside></footer>
 <dialog id="help-dialog"><h2>终端地图操作</h2><p>滚轮 / + / −：总览 → 模块 → 细节<br>拖动：平移 · 单击：固定详情<br>双击带 ⊞ 的节点：进入子地图<br>Backspace：返回父地图<br>Tab / 数字 1–9：切换页面<br>f：自动跟随 · 0：重置视图<br>x 按两次：确认删除当前页<br>q：关闭地图，可用「重新连接」再次打开</p><p>右上角字号只影响此网页终端。</p><form method="dialog"><button>关闭帮助</button></form></dialog>
 </body></html>

package/dist/web/terminal.js

@@ -9137,6 +9137,82 @@ var o = class {
   }
 };
 
+// src/web/star-reminder.ts
+function createStarNotice(base2) {
+  let attempted = false;
+  const notice = document.getElementById("star-reminder");
+  const link = notice.querySelector("a");
+  let opening = false;
+  link.title = "\u5728\u7CFB\u7EDF\u9ED8\u8BA4\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 GitHub";
+  const dismiss = () => {
+    notice.hidden = true;
+  };
+  notice.querySelector("button").addEventListener("click", dismiss);
+  const launch = async (event) => {
+    event.preventDefault();
+    if (opening) return;
+    opening = true;
+    link.setAttribute("aria-disabled", "true");
+    link.textContent = "\u6B63\u5728\u6253\u5F00\u2026";
+    notice.querySelector(".star-open-error")?.remove();
+    try {
+      const response = await fetch(new URL("api/star-reminder/open", base2), { method: "POST", signal: AbortSignal.timeout(8e3) });
+      const result = await response.json();
+      if (!response.ok || result.opened !== true) throw new Error("Not opened");
+      dismiss();
+    } catch {
+      const error = document.createElement("div");
+      error.className = "star-open-error";
+      error.setAttribute("role", "status");
+      const message = document.createElement("span");
+      message.textContent = "\u9ED8\u8BA4\u6D4F\u89C8\u5668\u672A\u80FD\u6253\u5F00\uFF0C\u53EF\u91CD\u8BD5\u6216\u590D\u5236\u5730\u5740\u3002";
+      const copy = document.createElement("button");
+      copy.type = "button";
+      copy.textContent = "\u590D\u5236 GitHub \u5730\u5740";
+      copy.addEventListener("click", () => {
+        void (async () => {
+          try {
+            await navigator.clipboard.writeText(link.href);
+            copy.textContent = "\u5DF2\u590D\u5236";
+          } catch {
+            const address = document.createElement("input");
+            address.readOnly = true;
+            address.value = link.href;
+            address.setAttribute("aria-label", "GitHub \u5730\u5740");
+            copy.replaceWith(address);
+            address.focus();
+            address.select();
+          }
+        })();
+      });
+      error.append(message, copy);
+      notice.append(error);
+    } finally {
+      opening = false;
+      link.removeAttribute("aria-disabled");
+      link.textContent = "\u53BB\u70B9 Star \u2197";
+    }
+  };
+  link.addEventListener("click", (event) => {
+    void launch(event);
+  });
+  link.addEventListener("auxclick", (event) => {
+    if (event.button === 1) void launch(event);
+  });
+  return (page2) => {
+    if (attempted || document.visibilityState !== "visible") return;
+    attempted = true;
+    const url = new URL("api/star-reminder/visit", base2);
+    if (page2) url.searchParams.set("page", page2);
+    void fetch(url, { method: "POST", signal: AbortSignal.timeout(3e3) }).then(async (response) => {
+      if (!response.ok) return;
+      const result = await response.json();
+      if (result.show === true && document.visibilityState === "visible") notice.hidden = false;
+    }).catch(() => {
+    });
+  };
+}
+
 // src/web/terminal-app.ts
 var element = (id) => document.getElementById(id);
 var container = element("terminal");
@@ -9145,6 +9221,7 @@ var restart = element("restart");
 var font = element("font-size");
 var graphic = element("graphic");
 var base = new URL(".", location.href);
+var starNotice = createStarNotice(base);
 var page = new URL(location.href).searchParams.get("page") ?? void 0;
 var socket;
 var retryTimer;
@@ -9264,6 +9341,7 @@ function connect() {
     } else if (message.type === "view") {
       page = message.page;
       syncPage();
+      starNotice(page);
     } else if (message.type === "error") setStatus(message.message, "error");
   });
   connection.addEventListener("close", (event) => {

package/dist/web.mjs

@@ -3703,9 +3703,10 @@ var require_websocket_server = __commonJS({
 });
 
 // src/web/cli.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync5, realpathSync as realpathSync2, rmSync as rmSync4, statSync as statSync2 } from "node:fs";
-import { dirname as dirname8, join as join6, resolve as resolve2 } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync6, realpathSync as realpathSync3, rmSync as rmSync4, statSync as statSync2 } from "node:fs";
+import { dirname as dirname9, join as join7, resolve as resolve2 } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { homedir } from "node:os";
 
 // src/domain/types.ts
 var ok = (value) => ({ ok: true, value });
@@ -5435,12 +5436,117 @@ function attachTerminalService(server, options) {
   };
 }
 
+// src/support/open-star.ts
+import { spawn as spawn3 } from "node:child_process";
+import { win32 } from "node:path";
+
+// src/support/star-reminder.ts
+import { existsSync as existsSync4, readFileSync as readFileSync5, realpathSync as realpathSync2 } from "node:fs";
+import { basename as basename3, dirname as dirname8, join as join6 } from "node:path";
+var STAR_URL = "https://github.com/GuangminJu/mellos-mapping";
+var DAY_MS = 864e5;
+function isNpmInstallation(entry) {
+  try {
+    const root = dirname8(dirname8(realpathSync2(entry)));
+    if (basename3(dirname8(root)).toLowerCase() !== "node_modules" || existsSync4(join6(root, ".git")) || existsSync4(join6(root, ".codex-plugin")) || existsSync4(join6(root, ".claude-plugin"))) return false;
+    const pkg = JSON.parse(readFileSync5(join6(root, "package.json"), "utf8"));
+    return pkg.name === "mellos-mapping" && pkg.bin?.mmap === "dist/mmap.mjs";
+  } catch {
+    return false;
+  }
+}
+function starReminderFile(userBase) {
+  return join6(userBase, ".mellos", "support", "star-reminder.json");
+}
+function enabledFlag(value) {
+  return !!value && value !== "0" && value.toLowerCase() !== "false";
+}
+function validState(value) {
+  if (!value || typeof value !== "object") return false;
+  const s = value;
+  return s.version === 1 && Number.isFinite(s.firstSeen) && s.firstSeen >= 0 && Number.isSafeInteger(s.lastDay) && s.lastDay >= Math.floor(s.firstSeen / DAY_MS) && Number.isSafeInteger(s.days) && s.days >= 1 && s.days <= 3 && typeof s.notified === "boolean";
+}
+function createStarReminder(options) {
+  const eligible = isNpmInstallation(options.entry) && !enabledFlag(options.env["CI"]) && !enabledFlag(options.env["MELLOS_MAPPING_NO_STAR"]);
+  const file = starReminderFile(options.userBase);
+  return {
+    visit() {
+      if (!eligible) return false;
+      try {
+        return withStoreLock(file, () => {
+          const now = (options.now ?? Date.now)();
+          if (!Number.isFinite(now) || now < 0) return false;
+          const day = Math.floor(now / DAY_MS);
+          let state;
+          try {
+            const saved2 = JSON.parse(readFileSync5(file, "utf8"));
+            if (!validState(saved2)) return false;
+            state = saved2;
+          } catch (error) {
+            if (error.code !== "ENOENT") return false;
+            state = { version: 1, firstSeen: now, lastDay: day, days: 1, notified: false };
+          }
+          if (state.notified || now < state.firstSeen || day < state.lastDay) return false;
+          if (day > state.lastDay) {
+            state.days = Math.min(3, state.days + 1);
+            state.lastDay = day;
+          }
+          const show = state.days >= 3 && now - state.firstSeen >= 7 * DAY_MS;
+          if (show) state.notified = true;
+          const saved = writeAtomic(file, JSON.stringify(state, null, 2) + "\n", 1);
+          return saved.ok && show;
+        });
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+
+// src/support/open-star.ts
+function starBrowserCommand(platform, windowsRoot = "C:\\Windows") {
+  if (platform === "win32") return {
+    file: win32.join(windowsRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe"),
+    args: [
+      "-NoLogo",
+      "-NoProfile",
+      "-NonInteractive",
+      "-WindowStyle",
+      "Hidden",
+      "-Command",
+      `$ErrorActionPreference = 'Stop'; Start-Process -FilePath '${STAR_URL}'`
+    ]
+  };
+  if (platform === "darwin") return { file: "/usr/bin/open", args: [STAR_URL] };
+  if (platform === "linux") return { file: "xdg-open", args: [STAR_URL] };
+  throw new Error("No supported desktop browser launcher");
+}
+function openStarInDefaultBrowser() {
+  const command = starBrowserCommand(process.platform, process.env["SystemRoot"]);
+  return new Promise((resolve3, reject) => {
+    const child = spawn3(command.file, command.args, { windowsHide: true, stdio: "ignore" });
+    let finished = false;
+    const finish = (error) => {
+      if (finished) return;
+      finished = true;
+      clearTimeout(deadline);
+      child.unref();
+      if (error) reject(error);
+      else resolve3();
+    };
+    const deadline = setTimeout(() => finish(), 5e3);
+    child.once("error", (error) => finish(error));
+    child.once("exit", (code) => finish(code === 0 ? void 0 : new Error("Default browser launch failed")));
+  });
+}
+
 // src/web/service.ts
 async function startWebService(defaultFile, assets, options = {}) {
   const token = options.token ?? randomBytes(24).toString("hex");
   if (!/^[a-f0-9]{48}$/.test(token)) throw new Error("Invalid web token");
   const prefix = `/${token}/`;
   let origin = "", lastRequest = Date.now(), closed = false;
+  let openingStar = false;
   const send = (res, code, body, type = "application/json; charset=utf-8") => {
     res.writeHead(code, {
       "Content-Type": type,
@@ -5492,6 +5598,36 @@ async function startWebService(defaultFile, assets, options = {}) {
         send(res, 200, JSON.stringify({ file: defaultFile, pid: process.pid, formats: [1, 2], surfaces: terminalService ? ["web", "web-terminal"] : ["web"] }));
         return;
       }
+      if (req.method === "POST" && route === "api/star-reminder/open") {
+        if (req.headers.origin !== origin) {
+          send(res, 403, '{"error":"Origin refused"}');
+          return;
+        }
+        if (req.url !== `${prefix}api/star-reminder/open` || req.headers["transfer-encoding"] || Number(req.headers["content-length"] ?? 0) !== 0) {
+          send(res, 400, '{"error":"No parameters accepted"}');
+          return;
+        }
+        if (openingStar) {
+          send(res, 409, '{"error":"Browser is already opening"}');
+          return;
+        }
+        openingStar = true;
+        void Promise.resolve().then(options.openStar ?? openStarInDefaultBrowser).then(() => {
+          send(res, 200, '{"opened":true}');
+        }, () => {
+          send(res, 503, '{"error":"\u65E0\u6CD5\u6253\u5F00\u9ED8\u8BA4\u6D4F\u89C8\u5668"}');
+        }).finally(() => {
+          openingStar = false;
+        });
+        return;
+      }
+      if (req.method === "POST" && route === "api/star-reminder/visit") {
+        const requested = new URL(req.url, origin).searchParams.get("page");
+        const id = !requested || requested === "_default" ? "" : requested;
+        const hasMap = options.starReminder && readWebSnapshot(defaultFile).value.pages.some((page) => page.id === id && !page.error && (page.map?.nodes.length ?? 0) > 0);
+        send(res, 200, JSON.stringify({ show: !!hasMap && options.starReminder.visit() }));
+        return;
+      }
       if (req.method === "GET" && route === "api/state") {
         const snapshot = readWebSnapshot(defaultFile);
         const etag = `"${snapshot.revision}"`;
@@ -5582,19 +5718,19 @@ async function runWeb(args) {
   if (args[0] === "--serve" && args.length === 2) {
     const file2 = resolve2(args[1]);
     if (await runningWebUrl(file2)) return;
-    const directory = dirname8(webRuntimeFile(file2));
+    const directory = dirname9(webRuntimeFile(file2));
     mkdirSync4(directory, { recursive: true });
-    if (realpathSync2(directory).toLowerCase() !== join6(realpathSync2(dirname8(directory)), "web").toLowerCase()) throw new Error("Redirected web runtime directory");
-    const assets = join6(dirname8(entry), "web");
+    if (realpathSync3(directory).toLowerCase() !== join7(realpathSync3(dirname9(directory)), "web").toLowerCase()) throw new Error("Redirected web runtime directory");
+    const assets = join7(dirname9(entry), "web");
     let service;
     service = await startWebService(file2, {
-      html: readFileSync5(join6(assets, "index.html"), "utf8"),
-      javascript: readFileSync5(join6(assets, "app.js"), "utf8"),
-      css: readFileSync5(join6(assets, "app.css"), "utf8"),
-      terminal: { html: readFileSync5(join6(assets, "terminal.html"), "utf8"), javascript: readFileSync5(join6(assets, "terminal.js"), "utf8"), css: readFileSync5(join6(assets, "terminal.css"), "utf8"), xtermCss: readFileSync5(join6(assets, "xterm.css"), "utf8") }
-    }, { terminalWorker: join6(dirname8(entry), "terminal-worker.mjs"), onClose: () => {
+      html: readFileSync6(join7(assets, "index.html"), "utf8"),
+      javascript: readFileSync6(join7(assets, "app.js"), "utf8"),
+      css: readFileSync6(join7(assets, "app.css"), "utf8"),
+      terminal: { html: readFileSync6(join7(assets, "terminal.html"), "utf8"), javascript: readFileSync6(join7(assets, "terminal.js"), "utf8"), css: readFileSync6(join7(assets, "terminal.css"), "utf8"), xtermCss: readFileSync6(join7(assets, "xterm.css"), "utf8") }
+    }, { starReminder: createStarReminder({ entry, userBase: homedir(), env: process.env }), terminalWorker: join7(dirname9(entry), "terminal-worker.mjs"), onClose: () => {
       try {
-        if (JSON.parse(readFileSync5(webRuntimeFile(file2), "utf8")).token === service.token) rmSync4(webRuntimeFile(file2));
+        if (JSON.parse(readFileSync6(webRuntimeFile(file2), "utf8")).token === service.token) rmSync4(webRuntimeFile(file2));
       } catch {
       }
     } });
@@ -5625,8 +5761,8 @@ async function runWeb(args) {
     else throw new Error(usage);
   }
   const project = resolve2(args[0]);
-  if (!existsSync4(project) || !statSync2(project).isDirectory()) throw new Error(`Project directory does not exist: ${project}`);
-  const file = join6(project, STATE_FILE_RELATIVE_PATH);
+  if (!existsSync5(project) || !statSync2(project).isDirectory()) throw new Error(`Project directory does not exist: ${project}`);
+  const file = join7(project, STATE_FILE_RELATIVE_PATH);
   if (stop) {
     const url = await runningWebUrl(file);
     if (url) await fetch(`${url}api/stop`, { method: "POST", signal: AbortSignal.timeout(2e3) });
@@ -5635,7 +5771,7 @@ async function runWeb(args) {
   }
   console.log(JSON.stringify({ surface: terminal ? "web-terminal" : "web", url: await openWebPreview(file, entry, page, terminal), visibility: "unconfirmed" }));
 }
-if (process.argv[1] && existsSync4(process.argv[1]) && import.meta.url === pathToFileURL(realpathSync2(process.argv[1])).href) {
+if (process.argv[1] && existsSync5(process.argv[1]) && import.meta.url === pathToFileURL(realpathSync3(process.argv[1])).href) {
   runWeb(process.argv.slice(2)).catch((error) => {
     console.error(String(error));
     process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mellos-mapping",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "mcpName": "io.github.GuangminJu/mellos-mapping",
   "description": "A live layered dependency map for bottom-up development — MCP server + terminal pane. Ghost the design first, then light nodes up from the bottom as they are built and verified.",
   "type": "module",