@kw-yeh/vibeflow 4.0.2 → 4.0.4

package/README.md

@@ -82,6 +82,20 @@ vibeflow doctor
 npm i -g @kw-yeh/vibeflow@latest
 ```
 
+### 安裝時出現 `EACCES: permission denied`
+
+代表 npm 的全域目錄屬於系統管理員（從 nodejs.org 下載安裝檔裝 Node 時常見）。建議不要用 `sudo`，改成讓全域套件裝在你自己的家目錄：
+
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix ~/.npm-global
+echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+npm i -g @kw-yeh/vibeflow@latest
+```
+
+用 Homebrew（`brew install node`）或 [nvm](https://github.com/nvm-sh/nvm) 裝的 Node 本來就不需要 `sudo`。已經用 `sudo` 裝好也能正常使用；若 `vibeflow doctor` 回報終端機模組沒有執行權限，照它列出的 `sudo chmod +x …` 指令執行一次即可。
+
 ---
 
 ## 常用指令

package/dist/postinstall.mjs

@@ -0,0 +1,57 @@
+import { createRequire as __vfCreateRequire } from 'node:module';
+const require = __vfCreateRequire(import.meta.url);
+
+// packages/core/src/pty-helper.ts
+import fs from "fs";
+import path from "path";
+import { createRequire } from "module";
+function nodePtyRoot() {
+  try {
+    return path.dirname(createRequire(import.meta.url).resolve("node-pty/package.json"));
+  } catch {
+    return null;
+  }
+}
+function ensurePtySpawnHelper(root = nodePtyRoot()) {
+  if (process.platform === "win32" || !root) return [];
+  const candidates = [
+    path.join(root, "build", "Release", "spawn-helper"),
+    path.join(root, "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper")
+  ];
+  const failures = [];
+  for (const file of candidates) {
+    let stat;
+    try {
+      stat = fs.statSync(file);
+    } catch {
+      continue;
+    }
+    try {
+      fs.accessSync(file, fs.constants.X_OK);
+      continue;
+    } catch {
+    }
+    try {
+      fs.chmodSync(file, stat.mode & 4095 | 73);
+    } catch (err) {
+      const uid = process.getuid?.();
+      failures.push({ path: file, error: err.message, ownedByOther: uid !== void 0 && stat.uid !== uid });
+    }
+  }
+  return failures;
+}
+function spawnHelperFixCommand(failures) {
+  const sudo = failures.some((f) => f.ownedByOther) ? "sudo " : "";
+  return `${sudo}chmod +x ${failures.map((f) => `"${f.path}"`).join(" ")}`;
+}
+
+// packages/cli/src/postinstall.ts
+try {
+  const failures = ensurePtySpawnHelper();
+  if (failures.length > 0) {
+    console.warn(`[vibeflow] node-pty spawn-helper \u7121\u6CD5\u8A2D\u70BA\u53EF\u57F7\u884C\uFF0C\u7D42\u7AEF\u6A5F\u6703\u7121\u6CD5\u555F\u52D5\u3002\u8ACB\u57F7\u884C\uFF1A
+  ${spawnHelperFixCommand(failures)}`);
+  }
+} catch (err) {
+  console.warn(`[vibeflow] postinstall \u7565\u904E\uFF1A${err.message}`);
+}

package/dist/vibeflow.mjs

@@ -257,6 +257,11 @@ var init_pty = __esm({
       scrollback(key) {
         return this.scrollbacks.get(key) ?? null;
       }
+      async isScrolledBack() {
+        return false;
+      }
+      async scrollToBottom() {
+      }
       shutdown() {
         for (const key of Array.from(this.sessions.keys())) this.killNow(key);
       }
@@ -416,6 +421,20 @@ var init_tmux_backend = __esm({
       scrollback() {
         return null;
       }
+      /** The attached client sits on the alternate screen, so history is tmux copy-mode. */
+      async isScrolledBack(key) {
+        const { code: code2, stdout } = await this.tmux(
+          "display-message",
+          "-p",
+          "-t",
+          `=${this.sessionName(key)}:`,
+          "#{pane_in_mode}"
+        );
+        return code2 === 0 && stdout.trim() === "1";
+      }
+      async scrollToBottom(key) {
+        await this.tmux("send-keys", "-t", `=${this.sessionName(key)}:`, "-X", "cancel");
+      }
       attachArgs(key) {
         return ["-L", TMUX_SOCKET, "-f", this.confPath, "attach-session", "-t", `=${this.sessionName(key)}`];
       }
@@ -1840,6 +1859,10 @@ function createBridge(t) {
       resize: (sessionKey, cols, rows) => t.send("pty:resize", { sessionKey, cols, rows }),
       /** Kill a task's PTY session (tears down the session and its watchers). */
       kill: (sessionKey) => t.send("pty:kill", sessionKey),
+      /** Whether the session's own history view (tmux copy-mode) is off the live output. */
+      isScrolledBack: (sessionKey) => t.invoke("pty:scrolled", sessionKey),
+      /** Return the session's own history view to the live output. */
+      scrollToBottom: (sessionKey) => t.invoke("pty:scroll-bottom", sessionKey),
       /** Whether the task's pinned Claude conversation already exists on disk. */
       sessionExists: (taskId) => t.invoke("claude:sessionExists", taskId),
       /**
@@ -1899,9 +1922,9 @@ function ensurePtySpawnHelper(root = nodePtyRoot()) {
   ];
   const failures = [];
   for (const file of candidates) {
-    let mode;
+    let stat;
     try {
-      mode = fs4.statSync(file).mode;
+      stat = fs4.statSync(file);
     } catch {
       continue;
     }
@@ -1911,13 +1934,18 @@ function ensurePtySpawnHelper(root = nodePtyRoot()) {
     } catch {
     }
     try {
-      fs4.chmodSync(file, mode & 4095 | 73);
+      fs4.chmodSync(file, stat.mode & 4095 | 73);
     } catch (err) {
-      failures.push({ path: file, error: err.message });
+      const uid = process.getuid?.();
+      failures.push({ path: file, error: err.message, ownedByOther: uid !== void 0 && stat.uid !== uid });
     }
   }
   return failures;
 }
+function spawnHelperFixCommand(failures) {
+  const sudo = failures.some((f) => f.ownedByOther) ? "sudo " : "";
+  return `${sudo}chmod +x ${failures.map((f) => `"${f.path}"`).join(" ")}`;
+}
 
 // packages/cli/src/task-command.ts
 import { parseArgs } from "node:util";
@@ -4936,6 +4964,9 @@ function createCore({ sessions, bus, version }) {
       sessions.resize(requireSessionKey(p.sessionKey), p.cols, p.rows);
     },
     "pty:kill": (sessionKey) => teardownSession(requireSessionKey(sessionKey)),
+    // History a frontend cannot scroll itself (tmux copy-mode).
+    "pty:scrolled": (sessionKey) => sessions.isScrolledBack(requireSessionKey(sessionKey)),
+    "pty:scroll-bottom": (sessionKey) => sessions.scrollToBottom(requireSessionKey(sessionKey)),
     // Does the task's pinned Claude conversation exist on disk? Used to decide
     // whether selecting a task may auto-resume (session present) or should
     // leave the interactive terminal for manual commands.
@@ -5641,8 +5672,8 @@ async function checkNodePty() {
       id: "node-pty",
       name: "node-pty",
       level: "fail",
-      detail: `spawn-helper \u6C92\u6709\u57F7\u884C\u6B0A\u9650\uFF1A${unrepaired[0].error}`,
-      fix: unrepaired.map((f) => `chmod +x "${f.path}"`).join(" && ")
+      detail: unrepaired.some((f) => f.ownedByOther) ? "spawn-helper \u6C92\u6709\u57F7\u884C\u6B0A\u9650\uFF0C\u800C\u4E14\u6A94\u6848\u5C6C\u65BC\u5176\u4ED6\u4F7F\u7528\u8005\uFF08\u901A\u5E38\u662F\u7528 sudo \u5168\u57DF\u5B89\u88DD\uFF09\uFF0CVibeFlow \u7121\u6CD5\u81EA\u884C\u4FEE\u6B63" : `spawn-helper \u6C92\u6709\u57F7\u884C\u6B0A\u9650\uFF1A${unrepaired[0].error}`,
+      fix: spawnHelperFixCommand(unrepaired)
     };
   }
   try {

package/dist/web/404/index.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/edcc6abb24dfd492.css" as="style"/><link rel="stylesheet" href="/_next/static/css/edcc6abb24dfd492.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-c8aa5df0425f6b7b.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-320afeed07d86516.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/2aQtkEcIfRS2Nbk-qwUwY/_buildManifest.js" defer=""></script><script src="/_next/static/2aQtkEcIfRS2Nbk-qwUwY/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"2aQtkEcIfRS2Nbk-qwUwY","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
+<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/5576c1267923e491.css" as="style"/><link rel="stylesheet" href="/_next/static/css/5576c1267923e491.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-c8aa5df0425f6b7b.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-fde992b12936b886.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/zygbxZW3DHGve5whWS7yR/_buildManifest.js" defer=""></script><script src="/_next/static/zygbxZW3DHGve5whWS7yR/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"zygbxZW3DHGve5whWS7yR","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>

package/dist/web/404.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/edcc6abb24dfd492.css" as="style"/><link rel="stylesheet" href="/_next/static/css/edcc6abb24dfd492.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-c8aa5df0425f6b7b.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-320afeed07d86516.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/2aQtkEcIfRS2Nbk-qwUwY/_buildManifest.js" defer=""></script><script src="/_next/static/2aQtkEcIfRS2Nbk-qwUwY/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"2aQtkEcIfRS2Nbk-qwUwY","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>
+<!DOCTYPE html><html><head><meta charSet="utf-8" data-next-head=""/><meta name="viewport" content="width=device-width" data-next-head=""/><link rel="icon" href="/favicon.ico" sizes="any" data-next-head=""/><link rel="icon" href="/logo.svg" type="image/svg+xml" data-next-head=""/><link rel="apple-touch-icon" href="/apple-touch-icon.png" data-next-head=""/><title data-next-head="">404: This page could not be found</title><link rel="preload" href="/_next/static/css/5576c1267923e491.css" as="style"/><link rel="stylesheet" href="/_next/static/css/5576c1267923e491.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" noModule="" src="/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="/_next/static/chunks/webpack-c8aa5df0425f6b7b.js" defer=""></script><script src="/_next/static/chunks/framework-b92a367cf1ad4bf7.js" defer=""></script><script src="/_next/static/chunks/main-ec7fd4c371d06729.js" defer=""></script><script src="/_next/static/chunks/pages/_app-fde992b12936b886.js" defer=""></script><script src="/_next/static/chunks/pages/_error-8f65b0f8749f42d2.js" defer=""></script><script src="/_next/static/zygbxZW3DHGve5whWS7yR/_buildManifest.js" defer=""></script><script src="/_next/static/zygbxZW3DHGve5whWS7yR/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">This page could not be found<!-- -->.</h2></div></div></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"statusCode":404}},"page":"/_error","query":{},"buildId":"zygbxZW3DHGve5whWS7yR","nextExport":true,"isFallback":false,"gip":true,"scriptLoader":[]}</script></body></html>