pi-bridge 0.2.8 → 0.3.0

package/README.md

@@ -52,7 +52,7 @@ pii (bin/pii.js)
        │    → prints PORT:TOKEN:PID to stdout
        ├─ SSH port forward localhost:PORT
        ├─ create fake local dir:
-       │    <home>/.pi-bridge/myserver/root/projects/my-app
+       │    /tmp/pi-bridge/root/projects/my-app
        ├─ process.chdir(fakeLocalCwd)
        ├─ strip --ssh from process.argv
        ├─ patch fs.*  (sync + promises)     remote/index.js
@@ -67,7 +67,6 @@ pi loads — unaware of bridge               restricts to remoteCwd
   → git branch in footer ✓
 ```
 
-The fake local directory lives under `<home>/.pi-bridge/<remote>/` (not the OS temp directory) so it survives reboots and pi can always resume sessions correctly. On Windows this is `%USERPROFILE%\.pi-bridge\`; on macOS/Linux it is `~/.pi-bridge/`.
 
 ## What Gets Patched
 
@@ -121,7 +120,7 @@ Host myserver
 ```
 
 **Files show as empty / ENOENT**
-The fake local directory (`<home>/.pi-bridge/<remote>/…`) is intentionally empty — all reads go to the remote. If you see ENOENT, the bridge may not have started correctly. Check that Node.js is available on the remote (`node --version`).
+The fake local directory (`/tmp/pi-bridge/…`) is intentionally empty — all reads go to the remote. If you see ENOENT, the bridge may not have started correctly. Check that Node.js is available on the remote (`node --version`).
 
 **Branch name not updating**
 The footer polls `.git` every second. Switching branches from outside a pi session is reflected within ~1s. If the branch is stuck, restart `pii`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-bridge",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "Transparent filesystem bridge that makes pi run natively on a remote machine over SSH",
   "type": "commonjs",
   "bin": {

package/src/local/child-process-patch.js

@@ -5,19 +5,18 @@ const path = require('path');
 const { isFakePath, toRemotePath } = require('./path-mapper');
 
 /**
- * Patch child_process.spawn and child_process.spawnSync so that commands
+ * Patch child_process spawn/spawnSync/execSync/execFileSync so that commands
  * whose cwd lands inside fakeRoot are transparently redirected to run on
  * the remote machine via SSH.
  *
- * Pi's bash tool uses spawn/spawnSync exclusively, so this covers all shell
- * command execution (ls, cat, grep, npm run, etc.).
- *
  * @param {string} fakeRoot - Local fake root directory (real path, no symlinks)
  * @param {string} remote   - SSH target, e.g. 'user@host'
  */
 function patchChildProcess(fakeRoot, remote) {
-  const origSpawn     = cp.spawn.bind(cp);
-  const origSpawnSync = cp.spawnSync.bind(cp);
+  const origSpawn       = cp.spawn.bind(cp);
+  const origSpawnSync   = cp.spawnSync.bind(cp);
+  const origExecSync    = cp.execSync.bind(cp);
+  const origExecFileSync = cp.execFileSync.bind(cp);
 
   /**
    * Resolve the effective cwd from spawn options.
@@ -44,6 +43,7 @@ function patchChildProcess(fakeRoot, remote) {
    * - node / node.exe: pi's internal tooling (session export, compaction, …)
    *   spawns Node with large payloads as args; redirecting those over SSH would
    *   produce an ENAMETOOLONG error on Windows and is never correct anyway.
+   * - pi / pii: need local internet access for the Claude API and auth.
    */
   function isLocalOnly(file) {
     const name = normalizeCmd(file).toLowerCase();
@@ -51,15 +51,14 @@ function patchChildProcess(fakeRoot, remote) {
   }
 
   /**
-   * Build the SSH-redirected command: cd to remote cwd, then run the
-   * original command with its arguments, all shell-quoted.
+   * Build SSH args for a file + args invocation:
+   * cd to remote cwd, then run the command with shell-quoted arguments.
    */
   function buildSshArgs(file, args, opts) {
     file = normalizeCmd(file);
-    const fakeCwd    = effectiveCwd(opts);
-    const remoteCwd  = toRemotePath(fakeCwd, fakeRoot);
+    const fakeCwd   = effectiveCwd(opts);
+    const remoteCwd = toRemotePath(fakeCwd, fakeRoot);
 
-    // Reconstruct the command string with shell-safe quoting
     const argStr = (args || [])
       .map(function(a) { return "'" + String(a).replace(/'/g, "'\\''") + "'"; })
       .join(' ');
@@ -68,10 +67,19 @@ function patchChildProcess(fakeRoot, remote) {
     return ['-o', 'BatchMode=yes', remote, remoteCmd];
   }
 
+  /**
+   * Build SSH args for a raw shell command string (used by execSync).
+   */
+  function buildSshArgsForShell(command, opts) {
+    const fakeCwd   = effectiveCwd(opts);
+    const remoteCwd = toRemotePath(fakeCwd, fakeRoot);
+    const remoteCmd = 'cd ' + JSON.stringify(remoteCwd) + ' && ' + command;
+    return ['-o', 'BatchMode=yes', remote, remoteCmd];
+  }
+
   // ── spawn ────────────────────────────────────────────────────────────────────
 
   cp.spawn = function patchedSpawn(file, args, opts) {
-    // Normalise overloaded signature: spawn(file) / spawn(file, opts) / spawn(file, args, opts)
     if (!Array.isArray(args)) { opts = args; args = []; }
     opts = opts || {};
 
@@ -92,6 +100,29 @@ function patchChildProcess(fakeRoot, remote) {
 
     return origSpawnSync('ssh', buildSshArgs(file, args, opts), Object.assign({}, opts, { cwd: undefined }));
   };
+
+  // ── execSync ─────────────────────────────────────────────────────────────────
+
+  cp.execSync = function patchedExecSync(command, opts) {
+    opts = opts || {};
+
+    const cwd = effectiveCwd(opts);
+    if (!isFakePath(cwd, fakeRoot)) return origExecSync(command, opts);
+
+    return origExecFileSync('ssh', buildSshArgsForShell(command, opts), Object.assign({}, opts, { cwd: undefined }));
+  };
+
+  // ── execFileSync ─────────────────────────────────────────────────────────────
+
+  cp.execFileSync = function patchedExecFileSync(file, args, opts) {
+    if (!Array.isArray(args)) { opts = args; args = []; }
+    opts = opts || {};
+
+    const cwd = effectiveCwd(opts);
+    if (!isFakePath(cwd, fakeRoot) || isLocalOnly(file)) return origExecFileSync(file, args, opts);
+
+    return origExecFileSync('ssh', buildSshArgs(file, args, opts), Object.assign({}, opts, { cwd: undefined }));
+  };
 }
 
 module.exports = { patchChildProcess };

package/src/local/fake-dir.js

@@ -8,33 +8,21 @@ const path = require('path');
 // filesystem rather than being redirected through the SSH bridge.
 const origRmSync = fs.rmSync.bind(fs);
 
-/**
- * Sanitise an SSH target string (user@host or alias) into a safe dir name.
- */
-function sanitizeRemote(remote) {
-  return remote.replace(/[^a-zA-Z0-9._-]/g, '_');
-}
-
 /**
  * Create the fake local directory skeleton for the given remote path.
- *
- * The directory lives under ~/.pi-bridge/<remote>/ rather than the OS temp
- * directory so it survives reboots — this prevents pi's session-cwd check
- * from failing when it tries to resume a previous session whose cwd points
- * at a directory that was cleaned up between runs.
+ * The structure mirrors the remote path so that path-mapper can convert
+ * between fake local paths and remote paths deterministically.
  *
  * Example:
- *   remote    = 'myserver'
  *   remoteCwd = '/root/project-x'
- *   fakeRoot  = '~/.pi-bridge/myserver'
- *   fakeLocalCwd = '~/.pi-bridge/myserver/root/project-x'
+ *   fakeRoot  = '/tmp/pi-bridge'
+ *   fakeLocalCwd = '/tmp/pi-bridge/root/project-x'
  *
- * @param {string} remote    - SSH target, e.g. 'user@host' or alias
  * @param {string} remoteCwd - Absolute remote path, e.g. '/root/project-x'
  * @returns {{ fakeRoot: string, fakeLocalCwd: string }}
  */
-function createFakeDir(remote, remoteCwd) {
-  const fakeRootRaw = path.join(os.homedir(), '.pi-bridge', sanitizeRemote(remote));
+function createFakeDir(remoteCwd) {
+  const fakeRootRaw = path.join(os.tmpdir(), 'pi-bridge');
 
   // Build the local mirror path from the remote path segments
   const segments = remoteCwd.split('/').filter(Boolean);

package/src/local/fs-patch.js

@@ -192,10 +192,15 @@ function patchFs(fakeRoot, port, token) {
     if (process.platform === 'win32' && isBashPath(s)) return true;
     if (!s || !isFakePath(s, fakeRoot)) return orig.existsSync(p);
     try {
-      return httpGet(port, token, '/exists?path=' + encodeURIComponent(rpath(s))).trim() === '1';
+      const remoteExists = httpGet(port, token, '/exists?path=' + encodeURIComponent(rpath(s))).trim() === '1';
+      // Also check locally: the fake dir root always exists on disk (pi-bridge
+      // creates it in preload). This lets pi's session-cwd check pass even when
+      // Node.js 24's ESM existsSync bypasses our patch and the remote check
+      // returns an unexpected result for the project root directory.
+      return remoteExists || orig.existsSync(p);
     } catch (e) {
       if (e.message && (e.message.includes('403') || e.message.includes('ENOENT'))) return false;
-      throw e;
+      return orig.existsSync(p);
     }
   };
 

package/src/local/preload.js

@@ -57,7 +57,7 @@ try {
 const { port, token, sessionId, remotePid } = config;
 
 // --- Step 3: Create fake local directory ---
-const { fakeRoot, fakeLocalCwd } = createFakeDir(remote, remoteCwd);
+const { fakeRoot, fakeLocalCwd } = createFakeDir(remoteCwd);
 
 // --- Step 4: Change working directory to fake local cwd ---
 process.chdir(fakeLocalCwd);