mellos-mapping 0.16.0 → 0.18.0

package/README.md

@@ -130,9 +130,12 @@ To watch the live pane beside a Codex session on Windows, run
 terminal window hosting the session (or falls back to a dedicated
 "mellos-mapping" window; `--window` picks that on purpose). Add
 `--page <slug>` to open on a particular page — and with a pane already open,
-rerunning with `--page` retargets it instead of opening another. Elsewhere
-run `node <plugin root>/dist/watch.mjs` (same `--page` flag) from the
-project directory in a second terminal (or any terminal split).
+rerunning with `--page` retargets it instead of opening another. The pane
+auto-follows the page being written — the map the agent is operating on
+right now; press `f` to toggle that (a manual page switch also turns it
+off), or start with `--no-follow`. Elsewhere run
+`node <plugin root>/dist/watch.mjs` (same `--page` / `--no-follow` flags)
+from the project directory in a second terminal (or any terminal split).
 
 ## Any MCP client
 

package/README.zh-CN.md

@@ -120,8 +120,10 @@ node ~/.codex/plugins/cache/mellos-mapping/mellos-mapping/<版本>/scripts/codex
 终端窗口里分屏（识别不到就确定性地开到专属的 "mellos-mapping" 窗口；
 `--window` 则是主动选择专属窗口）。加 `--page <slug>` 指定打开哪一页；
 面板已经开着时，带 `--page` 重跑一次不会再开新面板，而是让现有面板
-切到那一页。其他环境在项目目录下的第二个终端（或任意分屏）运行
-`node <插件根>/dist/watch.mjs`（同样支持 `--page`）。
+切到那一页。面板默认**自动跟随**正在被写入的页——AI 此刻操作哪张图，
+就看哪张图；按 `f` 开关（手动切页也会关掉），或用 `--no-follow` 启动。
+其他环境在项目目录下的第二个终端（或任意分屏）运行
+`node <插件根>/dist/watch.mjs`（同样支持 `--page` / `--no-follow`）。
 
 ## 任意 MCP 客户端
 

package/dist/server.mjs

@@ -22515,7 +22515,7 @@ function summarize(map) {
 
 // src/server/server.ts
 var SERVER_NAME = "mellos-mapping";
-var SERVER_VERSION = "0.16.0";
+var SERVER_VERSION = "0.18.0";
 var ID = external_exports.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/, "lowercase letters, digits and dashes, 1-64 chars").describe("stable kebab-case identifier");
 var PAGE = ID.optional().describe(
   "page (parallel map) this call targets; omit for the default page. One effort = one page: start a NEW effort on its own page named after the effort, so concurrent sessions never write over each other and the pane can switch between pages."
@@ -22556,7 +22556,7 @@ function buildServer(stateFile) {
     "mmap_declare",
     {
       title: "Declare map structure",
-      description: "Grow the Mellos map: set the title and diagram kind, add layer bands, lanes and groups (labeled subsystems within a band \u2014 the zoomed-out view renders groups, so declare them for any map beyond a handful of nodes), add nodes, add dependency edges. Declare the whole ghost design up front, then grow it as understanding deepens. Edges must point strictly downward (a node may only use nodes on lower layers); the batch is all-or-nothing.",
+      description: "Grow the Mellos map: set the title and diagram kind, add layer bands, lanes and groups (labeled subsystems within ONE band \u2014 declare them when a single band grows crowded, roughly five or more nodes in that band; a group must be a strict subset of its band, and a map spread thin across many bands needs none), add nodes, add dependency edges. Declare the whole ghost design up front, then grow it as understanding deepens. Edges must point strictly downward (a node may only use nodes on lower layers); the batch is all-or-nothing.",
       inputSchema: {
         page: PAGE,
         title: external_exports.string().max(120).optional().describe("map title, e.g. the feature being built"),

package/dist/watch.mjs

@@ -1259,6 +1259,7 @@ function parseInput(chunk) {
     else if (ch === "-") events.push({ kind: "zoom", delta: -1 });
     else if (ch === "	") events.push({ kind: "next-page" });
     else if (ch === "\x7F" || ch === "\b") events.push({ kind: "back" });
+    else if (ch === "f" || ch === "F") events.push({ kind: "follow-toggle" });
     else if (ch >= "1" && ch <= "9") events.push({ kind: "page", index: ch.charCodeAt(0) - "1".charCodeAt(0) });
     else if (KEY_PAN[ch]) events.push({ kind: "pan", ...KEY_PAN[ch] });
     i += 1;
@@ -1274,6 +1275,7 @@ function parseArgs(argv, cwd) {
   let color = true;
   let mouse = true;
   let page;
+  let follow = true;
   for (let i = 0; i < argv.length; i++) {
     switch (argv[i]) {
       case "--file":
@@ -1296,11 +1298,26 @@ function parseArgs(argv, cwd) {
       case "--no-mouse":
         mouse = false;
         break;
+      case "--no-follow":
+        follow = false;
+        break;
       default:
         break;
     }
   }
-  return { file, intervalMs, unicode, color, mouse, page };
+  return { file, intervalMs, unicode, color, mouse, page, follow };
+}
+function dividerRow(width, unicode, follow) {
+  const grip = unicode ? " \u22EF " : " ~ ";
+  let bar = (unicode ? "\u2500" : "-").repeat(width);
+  const gripAt = Math.max(0, Math.floor((width - grip.length) / 2));
+  if (width > grip.length + 2) bar = bar.slice(0, gripAt) + grip + bar.slice(gripAt + grip.length);
+  if (follow) {
+    const tag = unicode ? " \u21E2 follow " : " > follow ";
+    const at = width - tag.length - 1;
+    if (at > gripAt + grip.length) bar = bar.slice(0, at) + tag + bar.slice(at + tag.length);
+  }
+  return bar;
 }
 function mostRecentPageFile(files, mtimeOf) {
   let best;
@@ -1678,6 +1695,7 @@ function main() {
   let activeFile;
   let firstScan = true;
   let pendingFocusFile = cfg.page === void 0 ? void 0 : pageFilePath(cfg.file, cfg.page);
+  let follow = cfg.follow;
   let lastTabSegments = [];
   let tabScroll = 0;
   let offsetX = 0;
@@ -1744,6 +1762,10 @@ function main() {
   };
   const handSwitch = (file) => {
     pendingFocusFile = void 0;
+    if (follow) {
+      follow = false;
+      flash = { text: "auto-follow off \u2014 press f to re-enable", until: Date.now() + 3e3 };
+    }
     switchPage(file);
   };
   const hitTest = (termX, termY) => {
@@ -1805,10 +1827,7 @@ function main() {
     } else {
       panel = mapPanel(map, cfg.unicode, panelWidth, panelContentRows);
     }
-    const grip = cfg.unicode ? " \u22EF " : " ~ ";
-    const bar = (cfg.unicode ? "\u2500" : "-").repeat(viewW);
-    const gripAt = Math.max(0, Math.floor((viewW - grip.length) / 2));
-    const separator = viewW > grip.length + 2 ? bar.slice(0, gripAt) + grip + bar.slice(gripAt + grip.length) : bar;
+    const separator = dividerRow(viewW, cfg.unicode, follow);
     const panelRows = [
       cfg.color ? `\x1B[90m${separator}${RESET}` : separator,
       ...panel.map(
@@ -1875,6 +1894,7 @@ function main() {
         pageViews.delete(known);
       }
     }
+    const changedFiles = [];
     for (const file of pageFiles) {
       let mtimeMs;
       try {
@@ -1886,6 +1906,7 @@ function main() {
       if (mtimeMs === entry?.mtimeMs) continue;
       const loaded = loadMapFile(file);
       if (loaded.ok) {
+        if (!firstScan) changedFiles.push(file);
         const becameFresh = !firstScan && file !== activeFile;
         pageData.set(file, { map: loaded.value, mtimeMs, fresh: becameFresh });
         if (file === activeFile) {
@@ -1905,9 +1926,15 @@ function main() {
     if (request !== void 0 && !(firstScan && pendingFocusFile !== void 0)) {
       pendingFocusFile = pageFilePath(cfg.file, request.page);
     }
+    let requestApplied = false;
     if (pendingFocusFile !== void 0 && pageFiles.includes(pendingFocusFile)) {
       if (pendingFocusFile !== activeFile) switchPage(pendingFocusFile);
       pendingFocusFile = void 0;
+      requestApplied = true;
+    }
+    if (follow && !requestApplied && changedFiles.length > 0 && dragAnchor === void 0) {
+      const target = mostRecentPageFile(changedFiles, (f) => pageData.get(f)?.mtimeMs);
+      if (target !== activeFile) switchPage(target);
     }
     firstScan = false;
     if (activeFile === void 0 || !pageFiles.includes(activeFile)) {
@@ -2076,6 +2103,11 @@ function main() {
           case "back":
             if (climbBack()) dirty = true;
             break;
+          case "follow-toggle":
+            follow = !follow;
+            flash = { text: follow ? "auto-follow on" : "auto-follow off", until: Date.now() + 2500 };
+            dirty = true;
+            break;
         }
       }
       if (dirty) paint();
@@ -2110,6 +2142,7 @@ export {
   anchorOffsets,
   clampPanelRows,
   diveOrigin,
+  dividerRow,
   fitWidth,
   launchedAsEntry,
   liveRipples,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mellos-mapping",
-  "version": "0.16.0",
+  "version": "0.18.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",