@inthedark/wb 0.0.1 → 0.0.2

package/README.md

@@ -1,60 +1,60 @@
-
-# workbench
-
-an agentic ide about the human
-
-## how 2 use
-```bash
-# install & open
-npx @inthedark/wb
-
-# set up daemon on another device
-npx @inthedark/wb connect
-```
-
-## features
-
-key features:
-- fully customisable agent instructions with support for comments & imports
-- strong thread transcript UX for when you need to keep an eye on a thread (command matching + html elements for agents)
-- strong thread management UX for when you're managing LOTS of threads (thread status-sorted sidebar)
-- better shared workspace support than any other agentic ide, because a lot of work is not worktree->pr shaped; agents claim the files they need and other agents don't freak out about unclaimed dirt
-- near-identical agent behaviour across providers (codex, opencode 2, claude code) as if they're the same harness
-- agents can orchestrate subagents working in threads across providers and projects
-- customisable voice to text ("what if voice to text was like working in a rich text editor")
-- git UI for doing your own work at the same time as other agents, allowing easy commits while agents have other files claimed
-- quickly switch between saved profiles for harness/model/effort/window/fast mode/agent identity
-- automatic compaction on turn start past configurable time & token thresholds (reduce cache write costs)
-- agents can search repos with shell tools like they're on disk via vfs
-
-setup/meta:
-- built on top of other harnesses (codex, opencode 2, claude code) so you can use subscriptions
-- tailscale integration
-- daemon sleeps when idle, leaving only a light http wake service up
-
-unpolished/unfinished/broken stuff (coming soon tm!!!!!):
-- soon, autocomplete/suggestions extension for vscode & similar (highly configurable, able to be FAST)
-- worktree->pr workflow is unsupported (gonna be honest i have been in a cave working solo on wb for so long that i have not needed this yet)
-- browse AX & UX
-- search UX
-- i'd like more git ui
-- many places around the app could use a UI polish pass
-- the codebase itself could use a polish pass, esp. the react & tailwind
-
-## tech
-
-note: have tried to keep dependencies minimal for the most part
-
-`/package` — the entrypoint/installer, what actually gets published to npm  
-`/daemon/host` — wake service  
-`/daemon/server` — workbench harness  
-`/daemon/voice` - vtt service (rust)  
-`/instructions` — instructions for agents, copied into the user's `~/.workbench` folder whenever read  
-`/app/server` — server for frontend app  
-`/app/client` — frontend SPA  
-`/app/tray` — system tray application for the frontend app (rust/tauri)  
-`/shared` — shared stuff between the projects  
-`/shared/network/native` — tailscale integration (go)  
-`/test` — test runner  
-`/scripts` — stuff used by package scripts plus anything i didn't notice an agent left behind :3  
-`/docs` — help agents find things and not break them without eating all their tokens
+
+# workbench
+
+an agentic ide about the human
+
+## how 2 use
+```bash
+# install & open
+npx @inthedark/wb
+
+# set up daemon on another device
+npx @inthedark/wb connect
+```
+
+## features
+
+key features:
+- fully customisable agent instructions with support for comments & imports
+- strong thread transcript UX for when you need to keep an eye on a thread (command matching + html elements for agents)
+- strong thread management UX for when you're managing LOTS of threads (thread status-sorted sidebar)
+- better shared workspace support than any other agentic ide, because a lot of work is not worktree->pr shaped; agents claim the files they need and other agents don't freak out about unclaimed dirt
+- near-identical agent behaviour across providers (codex, opencode 2, claude code) as if they're the same harness
+- agents can orchestrate subagents working in threads across providers and projects
+- customisable voice to text ("what if voice to text was like working in a rich text editor")
+- git UI for doing your own work at the same time as other agents, allowing easy commits while agents have other files claimed
+- quickly switch between saved profiles for harness/model/effort/window/fast mode/agent identity
+- automatic compaction on turn start past configurable time & token thresholds (reduce cache write costs)
+- agents can search repos with shell tools like they're on disk via vfs
+
+setup/meta:
+- built on top of other harnesses (codex, opencode 2, claude code) so you can use subscriptions
+- tailscale integration
+- daemon sleeps when idle, leaving only a light http wake service up
+
+unpolished/unfinished/broken stuff (coming soon tm!!!!!):
+- soon, autocomplete/suggestions extension for vscode & similar (highly configurable, able to be FAST)
+- worktree->pr workflow is unsupported (gonna be honest i have been in a cave working solo on wb for so long that i have not needed this yet)
+- browse AX & UX
+- search UX
+- i'd like more git ui
+- many places around the app could use a UI polish pass
+- the codebase itself could use a polish pass, esp. the react & tailwind
+
+## tech
+
+note: have tried to keep dependencies minimal for the most part
+
+`/package` — the entrypoint/installer, what actually gets published to npm  
+`/daemon/host` — wake service  
+`/daemon/server` — workbench harness  
+`/daemon/voice` - vtt service (rust)  
+`/instructions` — instructions for agents, copied into the user's `~/.workbench` folder whenever read  
+`/app/server` — server for frontend app  
+`/app/client` — frontend SPA  
+`/app/tray` — system tray application for the frontend app (rust/tauri)  
+`/shared` — shared stuff between the projects  
+`/shared/network/native` — tailscale integration (go)  
+`/test` — test runner  
+`/scripts` — stuff used by package scripts plus anything i didn't notice an agent left behind :3  
+`/docs` — help agents find things and not break them without eating all their tokens

package/WorkbenchBootstrap.mjs

@@ -1,45 +1,45 @@
-/*
- * Exports:
- * - WorkbenchBootstrap (default): locates or installs an editable checkout and delegates to it.
- */
-import fs from "node:fs/promises";
-import { constants } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { randomUUID } from "node:crypto";
-import { fileURLToPath } from "node:url";
-import { DatabaseSync } from "node:sqlite";
+/*
+ * Exports:
+ * - WorkbenchBootstrap (default): locates or installs an editable checkout and delegates to it.
+ */
+import fs from "node:fs/promises";
+import { constants } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import { DatabaseSync } from "node:sqlite";
 import WorkbenchBootstrapPrompt from "./WorkbenchBootstrapPrompt.mjs";
 import WorkbenchBootstrapCommand from "./WorkbenchBootstrapCommand.mjs";
-
-export default class WorkbenchBootstrap {
-  constructor({
-    home = os.homedir(),
-    packageRoot = path.dirname(fileURLToPath(import.meta.url)),
-    environment = process.env,
+
+export default class WorkbenchBootstrap {
+  constructor({
+    home = os.homedir(),
+    packageRoot = path.dirname(fileURLToPath(import.meta.url)),
+    environment = process.env,
     prompt = new WorkbenchBootstrapPrompt(),
     commands = new WorkbenchBootstrapCommand(),
-    write = text => process.stdout.write(text),
-  } = {}) {
-    this.home = home;
-    this.packageRoot = packageRoot;
-    this.environment = environment;
-    this.prompt = prompt;
-    this.commands = commands;
-    this.write = write;
-    this.registry = path.join(home, ".workbench", "installation.json");
-  }
-
+    write = text => process.stdout.write(text),
+  } = {}) {
+    this.home = home;
+    this.packageRoot = packageRoot;
+    this.environment = environment;
+    this.prompt = prompt;
+    this.commands = commands;
+    this.write = write;
+    this.registry = path.join(home, ".workbench", "installation.json");
+  }
+
   async checkoutExists(root) {
     try {
       const manifest = JSON.parse(await fs.readFile(path.join(root, "package.json"), "utf8"));
       if (manifest.name !== "workbench-root") return false;
-      await fs.access(path.join(root, "wb"));
+      await fs.access(path.join(root, "wb"));
       await fs.access(path.join(root, "installation", "install.mjs"));
       await fs.access(path.join(root, "cli", "dispatch.mjs"));
-      return true;
-    } catch (error) {
-      if (error.code === "ENOENT") return false;
+      return true;
+    } catch (error) {
+      if (error.code === "ENOENT") return false;
       throw error;
     }
   }
@@ -58,84 +58,84 @@ export default class WorkbenchBootstrap {
   async readInstallation() {
     try {
       const record = JSON.parse(await fs.readFile(this.registry, "utf8"));
-      if (record.version !== 1 || typeof record.root !== "string" || !path.isAbsolute(record.root)
-        || !["cloning", "setup", "ready"].includes(record.phase)) {
-        throw new Error(`Invalid Workbench installation record: ${this.registry}. Existing files were not changed.`);
-      }
-      return record;
-    } catch (error) {
-      if (error.code === "ENOENT") return null;
-      throw error;
-    }
-  }
-
-  async writeInstallation(record) {
-    const candidate = `${this.registry}.${randomUUID()}.tmp`;
-    await fs.writeFile(candidate, `${JSON.stringify(record, null, 2)}\n`, { flag: "wx", mode: 0o600 });
-    await fs.rename(candidate, this.registry);
-  }
-
-  async requireTool(command, cwd) {
-    try {
-      await this.commands.run(command, ["--version"], {
-        cwd,
-        output: { write() {} },
-        errorOutput: { write() {} },
-      });
-    } catch (error) {
-      if (error.code !== "ENOENT") throw error;
-      throw new Error(`${command} is required to install Workbench. Install it and make it available on PATH, then retry.`, { cause: error });
-    }
-  }
-
-  async discardIncomplete(record) {
-    const root = path.resolve(record.root);
-    if (root !== record.root || !["wb", "workbench"].includes(path.basename(root).toLowerCase())) {
-      throw new Error(`Cannot verify failed install destination ${record.root}; it was preserved.`);
-    }
-    let stat;
-    try { stat = await fs.lstat(root); }
-    catch (error) {
-      if (error.code !== "ENOENT") throw error;
-      await fs.unlink(this.registry);
-      return;
-    }
-    if (!stat.isDirectory() || stat.isSymbolicLink()) {
-      throw new Error(`Failed install destination ${root} is not an ordinary directory; it was preserved.`);
-    }
-    if (await fs.realpath(root) !== root) {
-      throw new Error(`Failed install destination ${root} resolves elsewhere; it was preserved.`);
-    }
-    if ((await fs.readdir(root)).length) {
-      if (!await this.checkoutExists(root)) {
-        throw new Error(`Failed install destination ${root} is not a complete Workbench checkout; it was preserved.`);
-      }
-      const git = await fs.lstat(path.join(root, ".git")).catch(error => {
-        if (error.code === "ENOENT") return null;
-        throw error;
-      });
-      if (!git?.isDirectory() || git.isSymbolicLink()) {
-        throw new Error(`Failed install destination ${root} is not a regular Git clone; it was preserved.`);
-      }
-      let changes = "";
-      await this.commands.run("git", ["status", "--porcelain=v1", "--untracked-files=all"], {
-        cwd: root,
-        output: { write: bytes => { changes += bytes.toString(); } },
-        errorOutput: { write() {} },
-      });
-      if (changes.trim()) throw new Error(`Failed install destination ${root} has changes; it was preserved.`);
-    }
-    await fs.rm(root, { recursive: true });
-    await fs.unlink(this.registry);
-  }
-
-  async run(args) {
-    const managed = this.environment.WORKBENCH_THREAD_ID || this.environment.CODEX_THREAD_ID;
-    const view = args[0] === "view" && (args.length === 1 || args.length === 2 && ["daemon", "app"].includes(args[1]));
-    const humanCommand = view || args.length === 0 || (args.length === 1 && ["connect", "disconnect", "shortcut"].includes(args[0]));
-    if (managed && humanCommand) throw new Error("Managed threads cannot install or launch Workbench services.");
-    const linked = path.resolve(this.packageRoot, "..");
-    if (await this.checkoutExists(linked)) {
+      if (record.version !== 1 || typeof record.root !== "string" || !path.isAbsolute(record.root)
+        || !["cloning", "setup", "ready"].includes(record.phase)) {
+        throw new Error(`Invalid Workbench installation record: ${this.registry}. Existing files were not changed.`);
+      }
+      return record;
+    } catch (error) {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    }
+  }
+
+  async writeInstallation(record) {
+    const candidate = `${this.registry}.${randomUUID()}.tmp`;
+    await fs.writeFile(candidate, `${JSON.stringify(record, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+    await fs.rename(candidate, this.registry);
+  }
+
+  async requireTool(command, cwd) {
+    try {
+      await this.commands.run(command, ["--version"], {
+        cwd,
+        output: { write() {} },
+        errorOutput: { write() {} },
+      });
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+      throw new Error(`${command} is required to install Workbench. Install it and make it available on PATH, then retry.`, { cause: error });
+    }
+  }
+
+  async discardIncomplete(record) {
+    const root = path.resolve(record.root);
+    if (root !== record.root || !["wb", "workbench"].includes(path.basename(root).toLowerCase())) {
+      throw new Error(`Cannot verify failed install destination ${record.root}; it was preserved.`);
+    }
+    let stat;
+    try { stat = await fs.lstat(root); }
+    catch (error) {
+      if (error.code !== "ENOENT") throw error;
+      await fs.unlink(this.registry);
+      return;
+    }
+    if (!stat.isDirectory() || stat.isSymbolicLink()) {
+      throw new Error(`Failed install destination ${root} is not an ordinary directory; it was preserved.`);
+    }
+    if (await fs.realpath(root) !== root) {
+      throw new Error(`Failed install destination ${root} resolves elsewhere; it was preserved.`);
+    }
+    if ((await fs.readdir(root)).length) {
+      if (!await this.checkoutExists(root)) {
+        throw new Error(`Failed install destination ${root} is not a complete Workbench checkout; it was preserved.`);
+      }
+      const git = await fs.lstat(path.join(root, ".git")).catch(error => {
+        if (error.code === "ENOENT") return null;
+        throw error;
+      });
+      if (!git?.isDirectory() || git.isSymbolicLink()) {
+        throw new Error(`Failed install destination ${root} is not a regular Git clone; it was preserved.`);
+      }
+      let changes = "";
+      await this.commands.run("git", ["status", "--porcelain=v1", "--untracked-files=all"], {
+        cwd: root,
+        output: { write: bytes => { changes += bytes.toString(); } },
+        errorOutput: { write() {} },
+      });
+      if (changes.trim()) throw new Error(`Failed install destination ${root} has changes; it was preserved.`);
+    }
+    await fs.rm(root, { recursive: true });
+    await fs.unlink(this.registry);
+  }
+
+  async run(args) {
+    const managed = this.environment.WORKBENCH_THREAD_ID || this.environment.CODEX_THREAD_ID;
+    const view = args[0] === "view" && (args.length === 1 || args.length === 2 && ["daemon", "app"].includes(args[1]));
+    const humanCommand = view || args.length === 0 || (args.length === 1 && ["connect", "disconnect", "shortcut"].includes(args[0]));
+    if (managed && humanCommand) throw new Error("Managed threads cannot install or launch Workbench services.");
+    const linked = path.resolve(this.packageRoot, "..");
+    if (await this.checkoutExists(linked)) {
       return await this.delegate(linked, args);
     }
     const installed = await this.readInstallation();
@@ -148,7 +148,7 @@ export default class WorkbenchBootstrap {
     }
     if (managed || !(args.length === 0 || (args.length === 1 && args[0] === "connect"))) {
       throw new Error("Workbench is not installed. Run wb or wb connect in an interactive terminal first.");
-    }
+    }
     await this.requireTool("git");
     await this.requireTool("bash");
     await this.requireTool("vp");
@@ -158,24 +158,24 @@ export default class WorkbenchBootstrap {
     const choice = await this.prompt.choose(
       `Workbench is not installed. This command will clone the repository and run build commands. It may take 1-2 minutes. Continue?${warning}`,
       ["Let's go!", "Cancel"],
-    );
-    if (choice !== "Let's go!") throw new DOMException("Setup cancelled.", "AbortError");
-    const defaultRoot = installed?.root ?? (process.platform === "win32"
-      ? path.join(this.environment.LOCALAPPDATA || path.join(this.home, "AppData", "Local"), "Programs", "inthedark", "wb")
-      : path.join(this.home, ".local", "lib", "inthedark", "wb"));
-    const root = path.resolve(await this.prompt.location("Install location", defaultRoot));
-    await fs.mkdir(path.dirname(this.registry), { recursive: true });
-    const lockPath = `${this.registry}.lock.sqlite3`;
-    const lock = new DatabaseSync(lockPath);
-    try {
-      lock.exec("PRAGMA busy_timeout = 0; BEGIN EXCLUSIVE");
-    } catch (error) {
-      lock.close();
-      if (error.errcode === 5 || error.errcode === 6) {
-        throw new Error("Another Workbench installation is running. Let it finish before trying again.");
-      }
-      throw error;
-    }
+    );
+    if (choice !== "Let's go!") throw new DOMException("Setup cancelled.", "AbortError");
+    const defaultRoot = installed?.root ?? (process.platform === "win32"
+      ? path.join(this.environment.LOCALAPPDATA || path.join(this.home, "AppData", "Local"), "Programs", "inthedark", "wb")
+      : path.join(this.home, ".local", "lib", "inthedark", "wb"));
+    const root = path.resolve(await this.prompt.location("Install location", defaultRoot));
+    await fs.mkdir(path.dirname(this.registry), { recursive: true });
+    const lockPath = `${this.registry}.lock.sqlite3`;
+    const lock = new DatabaseSync(lockPath);
+    try {
+      lock.exec("PRAGMA busy_timeout = 0; BEGIN EXCLUSIVE");
+    } catch (error) {
+      lock.close();
+      if (error.errcode === 5 || error.errcode === 6) {
+        throw new Error("Another Workbench installation is running. Let it finish before trying again.");
+      }
+      throw error;
+    }
     try {
       // Another invocation may have finished while this one was accepting input.
       const latest = await this.readInstallation();
@@ -192,49 +192,49 @@ export default class WorkbenchBootstrap {
       if (latest && latest.phase !== "ready") await this.discardIncomplete(latest);
       await this.requireEmptyDestination(root);
       let record = { version: 1, root, phase: "cloning" };
-      await this.writeInstallation(record);
-      await this.prompt.withHeader(async () => {
-        this.write(`Installing Workbench at ${root}\n`);
-        try {
-          // Install sandboxes substitute a local snapshot; ordinary installs clone the public repository.
-          const repository = this.environment.WORKBENCH_INSTALL_REPOSITORY || "https://github.com/ErisInTheDark/workbench.git";
-          await this.commands.run("git", ["clone", "--progress", "--branch", "main", "--single-branch", repository, root]);
-          if (!await this.checkoutExists(root)) throw new Error("Clone did not produce a Workbench checkout.");
-          record = { ...record, phase: "setup" };
-          await this.writeInstallation(record);
+      await this.writeInstallation(record);
+      await this.prompt.withHeader(async () => {
+        this.write(`Installing Workbench at ${root}\n`);
+        try {
+          // Install sandboxes substitute a local snapshot; ordinary installs clone the public repository.
+          const repository = this.environment.WORKBENCH_INSTALL_REPOSITORY || "https://github.com/ErisInTheDark/workbench.git";
+          await this.commands.run("git", ["clone", "--progress", "--branch", "main", "--single-branch", repository, root]);
+          if (!await this.checkoutExists(root)) throw new Error("Clone did not produce a Workbench checkout.");
+          record = { ...record, phase: "setup" };
+          await this.writeInstallation(record);
           await this.commands.run(process.execPath, [path.join(root, "installation", "install.mjs"), "--prepare"], { cwd: root });
-        } catch (error) {
-          try { await this.discardIncomplete(record); }
-          catch (cleanupError) {
-            throw new Error(`${error.message} Incomplete checkout was preserved at ${root}: ${cleanupError.message}`, { cause: error });
-          }
-          throw error;
-        }
-      });
-      record = { ...record, phase: "ready" };
-      await this.writeInstallation(record);
-    } finally {
-      // Closing the connection also releases the OS lock after normal completion;
-      // process death releases it without a stale PID or lock-file recovery path.
-      lock.close();
-    }
-    // Persist readiness before optional platform actions: missing native artifacts
-    // must not turn a usable source installation into an endless setup loop.
+        } catch (error) {
+          try { await this.discardIncomplete(record); }
+          catch (cleanupError) {
+            throw new Error(`${error.message} Incomplete checkout was preserved at ${root}: ${cleanupError.message}`, { cause: error });
+          }
+          throw error;
+        }
+      });
+      record = { ...record, phase: "ready" };
+      await this.writeInstallation(record);
+    } finally {
+      // Closing the connection also releases the OS lock after normal completion;
+      // process death releases it without a stale PID or lock-file recovery path.
+      lock.close();
+    }
+    // Persist readiness before optional platform actions: missing native artifacts
+    // must not turn a usable source installation into an endless setup loop.
     await this.commands.run(process.execPath, [path.join(root, "installation", "install.mjs"),
       args[0] === "connect" ? "--connect" : "--welcome"], { cwd: root, interactive: true });
   }
 
   async delegate(root, args) {
     return await this.commands.run(process.execPath, [path.join(root, "cli", "dispatch.mjs"), ...args], { interactive: true });
-  }
-
-  async requireEmptyDestination(root) {
-    try {
-      if ((await fs.readdir(root)).length) throw new Error(`Installation destination must be empty: ${root}. Existing files were preserved.`);
-    } catch (error) {
-      if (error.code !== "ENOENT") throw error;
-    }
-    await fs.mkdir(path.dirname(root), { recursive: true });
-    await fs.access(path.dirname(root), constants.W_OK);
-  }
-}
+  }
+
+  async requireEmptyDestination(root) {
+    try {
+      if ((await fs.readdir(root)).length) throw new Error(`Installation destination must be empty: ${root}. Existing files were preserved.`);
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+    await fs.mkdir(path.dirname(root), { recursive: true });
+    await fs.access(path.dirname(root), constants.W_OK);
+  }
+}

package/WorkbenchBootstrapCommand.mjs

@@ -1,140 +1,140 @@
-/*
- * Exports:
+/*
+ * Exports:
  * - WorkbenchBootstrapCommand (default): owns bootstrap child commands, Windows executable lookup (including Git Bash), and failures.
- */
-import { spawn } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+
 export default class WorkbenchBootstrapCommand {
-  constructor({ output = process.stdout, errorOutput = process.stderr, environment = process.env } = {}) {
-    this.output = output;
-    this.errorOutput = errorOutput;
-    this.environment = environment;
-  }
-
-  /** Environment variable by name; Windows names are case-insensitive, but copied env objects are not. */
-  variable(name) {
-    if (process.platform !== "win32") return this.environment[name];
-    const key = Object.keys(this.environment).find(candidate => candidate.toLowerCase() === name.toLowerCase());
-    return key === undefined ? undefined : this.environment[key];
-  }
-
-  async resolve(command) {
-    if (process.platform === "win32" && command === "bash") return [await this.resolveBash()];
-    if (process.platform !== "win32" || !["npm", "pnpm"].includes(command)) return [command];
-    const directories = [path.dirname(process.execPath), ...(this.variable("PATH") || "").split(path.delimiter)];
-    for (const directory of directories) {
-      if (!directory) continue;
-      const executable = path.join(directory, `${command}.exe`);
-      try {
-        await fs.access(executable);
-        return [executable];
-      } catch (error) {
-        if (error.code !== "ENOENT") throw error;
-      }
-      // npm/pnpm's Windows cmd wrappers cannot safely forward arbitrary paths.
-      // Invoke their installed Node entry instead of adding a command-shell layer.
-      const entry = command === "npm" ? "npm/bin/npm-cli.js" : "pnpm/bin/pnpm.cjs";
-      const script = path.join(directory, "node_modules", entry);
-      try {
-        await fs.access(script);
-        return [process.execPath, script];
-      } catch (error) {
-        if (error.code !== "ENOENT") throw error;
-      }
-    }
-    throw new Error(`Cannot locate ${command}'s executable or Node entry. Install ${command} and ensure it is on PATH.`);
-  }
-
-  /**
-   * Windows bash that can run Workbench. Git for Windows usually puts only git on PATH, and the
-   * bash.exe Windows does find is often WSL's launcher, which runs scripts inside Linux.
-   */
-  async resolveBash() {
-    const exists = async file => {
-      try { await fs.access(file); return true; }
-      catch (error) { if (error.code === "ENOENT") return false; throw error; }
-    };
-    const directories = (this.variable("PATH") || "").split(path.delimiter).filter(Boolean);
-    const local = this.variable("LOCALAPPDATA");
-    const launchers = [
-      path.join(this.variable("SystemRoot") || "C:\\Windows", "System32"),
-      ...(local ? [path.join(local, "Microsoft", "WindowsApps")] : []),
-    ].map(directory => path.resolve(directory).toLowerCase());
-    let sawLauncher = false;
-    for (const directory of directories) {
-      const bash = path.join(directory, "bash.exe");
-      if (!await exists(bash)) continue;
-      if (launchers.includes(path.resolve(directory).toLowerCase())) sawLauncher = true;
-      else return bash;
-    }
-    // git.exe lives in Git\cmd, Git\bin or Git\mingw64\bin; Git Bash is always Git\bin\bash.exe.
-    for (const directory of directories) {
-      if (!await exists(path.join(directory, "git.exe"))) continue;
-      const parent = path.dirname(directory);
-      const root = path.basename(parent).toLowerCase() === "mingw64" ? path.dirname(parent) : parent;
-      const bash = path.join(root, "bin", "bash.exe");
-      if (await exists(bash)) return bash;
-    }
-    for (const base of [this.variable("ProgramFiles"), local && path.join(local, "Programs")]) {
-      if (!base) continue;
-      const bash = path.join(base, "Git", "bin", "bash.exe");
-      if (await exists(bash)) return bash;
-    }
-    throw new Error(`Workbench needs Git Bash on Windows.${sawLauncher ? " The bash on PATH is WSL's, which cannot run Workbench." : ""} Install Git for Windows, then retry.`);
-  }
-
-  async run(command, args, { cwd, signal, onOutput, environment = {}, output = this.output, errorOutput = this.errorOutput, interactive = false } = {}) {
-    signal?.throwIfAborted();
-    const [executable, ...prefix] = await this.resolve(command);
-    signal?.throwIfAborted();
-    return await new Promise((resolve, reject) => {
-      const child = spawn(executable, [...prefix, ...args], {
-        cwd,
-        env: { ...this.environment, ...environment },
-        windowsHide: true,
-        stdio: interactive ? "inherit" : ["ignore", "pipe", "pipe"],
-        signal,
-      });
-      let failure;
-      const relay = signal => { child.kill(signal); };
-      const interrupt = () => relay("SIGINT");
-      const terminate = () => relay("SIGTERM");
-      const hangup = () => relay("SIGHUP");
-      if (interactive) {
-        process.on("SIGINT", interrupt);
-        process.on("SIGTERM", terminate);
-        process.on("SIGHUP", hangup);
-      }
-      child.on("error", error => { failure = error; });
-      const forward = (stream, output) => {
-        stream.on("data", bytes => {
-          output.write(bytes);
-          if (onOutput) {
-            try { onOutput(bytes.toString()); }
-            catch (error) { failure = error; child.kill(); }
-          }
-        });
-      };
-      if (!interactive) {
-        forward(child.stdout, output);
-        forward(child.stderr, errorOutput);
-      }
-      child.once("close", (code, exitSignal) => {
-        if (interactive) {
-          process.off("SIGINT", interrupt);
-          process.off("SIGTERM", terminate);
-          process.off("SIGHUP", hangup);
-        }
-        if (failure?.code === "ENOENT") {
-          reject(Object.assign(new Error(`Cannot start ${command}: executable not found. Install it and make it available on PATH, then retry.`, { cause: failure }), {
-            code: "ENOENT",
-          }));
-        } else if (failure) reject(failure);
-        else if (code === 0) resolve();
-        else reject(Object.assign(new Error(`${command} failed with ${exitSignal ? `signal ${exitSignal}` : `status ${code ?? "unknown"}`}.`), { exitCode: code ?? 1 }));
-      });
-    });
-  }
-}
+  constructor({ output = process.stdout, errorOutput = process.stderr, environment = process.env } = {}) {
+    this.output = output;
+    this.errorOutput = errorOutput;
+    this.environment = environment;
+  }
+
+  /** Environment variable by name; Windows names are case-insensitive, but copied env objects are not. */
+  variable(name) {
+    if (process.platform !== "win32") return this.environment[name];
+    const key = Object.keys(this.environment).find(candidate => candidate.toLowerCase() === name.toLowerCase());
+    return key === undefined ? undefined : this.environment[key];
+  }
+
+  async resolve(command) {
+    if (process.platform === "win32" && command === "bash") return [await this.resolveBash()];
+    if (process.platform !== "win32" || !["npm", "pnpm"].includes(command)) return [command];
+    const directories = [path.dirname(process.execPath), ...(this.variable("PATH") || "").split(path.delimiter)];
+    for (const directory of directories) {
+      if (!directory) continue;
+      const executable = path.join(directory, `${command}.exe`);
+      try {
+        await fs.access(executable);
+        return [executable];
+      } catch (error) {
+        if (error.code !== "ENOENT") throw error;
+      }
+      // npm/pnpm's Windows cmd wrappers cannot safely forward arbitrary paths.
+      // Invoke their installed Node entry instead of adding a command-shell layer.
+      const entry = command === "npm" ? "npm/bin/npm-cli.js" : "pnpm/bin/pnpm.cjs";
+      const script = path.join(directory, "node_modules", entry);
+      try {
+        await fs.access(script);
+        return [process.execPath, script];
+      } catch (error) {
+        if (error.code !== "ENOENT") throw error;
+      }
+    }
+    throw new Error(`Cannot locate ${command}'s executable or Node entry. Install ${command} and ensure it is on PATH.`);
+  }
+
+  /**
+   * Windows bash that can run Workbench. Git for Windows usually puts only git on PATH, and the
+   * bash.exe Windows does find is often WSL's launcher, which runs scripts inside Linux.
+   */
+  async resolveBash() {
+    const exists = async file => {
+      try { await fs.access(file); return true; }
+      catch (error) { if (error.code === "ENOENT") return false; throw error; }
+    };
+    const directories = (this.variable("PATH") || "").split(path.delimiter).filter(Boolean);
+    const local = this.variable("LOCALAPPDATA");
+    const launchers = [
+      path.join(this.variable("SystemRoot") || "C:\\Windows", "System32"),
+      ...(local ? [path.join(local, "Microsoft", "WindowsApps")] : []),
+    ].map(directory => path.resolve(directory).toLowerCase());
+    let sawLauncher = false;
+    for (const directory of directories) {
+      const bash = path.join(directory, "bash.exe");
+      if (!await exists(bash)) continue;
+      if (launchers.includes(path.resolve(directory).toLowerCase())) sawLauncher = true;
+      else return bash;
+    }
+    // git.exe lives in Git\cmd, Git\bin or Git\mingw64\bin; Git Bash is always Git\bin\bash.exe.
+    for (const directory of directories) {
+      if (!await exists(path.join(directory, "git.exe"))) continue;
+      const parent = path.dirname(directory);
+      const root = path.basename(parent).toLowerCase() === "mingw64" ? path.dirname(parent) : parent;
+      const bash = path.join(root, "bin", "bash.exe");
+      if (await exists(bash)) return bash;
+    }
+    for (const base of [this.variable("ProgramFiles"), local && path.join(local, "Programs")]) {
+      if (!base) continue;
+      const bash = path.join(base, "Git", "bin", "bash.exe");
+      if (await exists(bash)) return bash;
+    }
+    throw new Error(`Workbench needs Git Bash on Windows.${sawLauncher ? " The bash on PATH is WSL's, which cannot run Workbench." : ""} Install Git for Windows, then retry.`);
+  }
+
+  async run(command, args, { cwd, signal, onOutput, environment = {}, output = this.output, errorOutput = this.errorOutput, interactive = false } = {}) {
+    signal?.throwIfAborted();
+    const [executable, ...prefix] = await this.resolve(command);
+    signal?.throwIfAborted();
+    return await new Promise((resolve, reject) => {
+      const child = spawn(executable, [...prefix, ...args], {
+        cwd,
+        env: { ...this.environment, ...environment },
+        windowsHide: true,
+        stdio: interactive ? "inherit" : ["ignore", "pipe", "pipe"],
+        signal,
+      });
+      let failure;
+      const relay = signal => { child.kill(signal); };
+      const interrupt = () => relay("SIGINT");
+      const terminate = () => relay("SIGTERM");
+      const hangup = () => relay("SIGHUP");
+      if (interactive) {
+        process.on("SIGINT", interrupt);
+        process.on("SIGTERM", terminate);
+        process.on("SIGHUP", hangup);
+      }
+      child.on("error", error => { failure = error; });
+      const forward = (stream, output) => {
+        stream.on("data", bytes => {
+          output.write(bytes);
+          if (onOutput) {
+            try { onOutput(bytes.toString()); }
+            catch (error) { failure = error; child.kill(); }
+          }
+        });
+      };
+      if (!interactive) {
+        forward(child.stdout, output);
+        forward(child.stderr, errorOutput);
+      }
+      child.once("close", (code, exitSignal) => {
+        if (interactive) {
+          process.off("SIGINT", interrupt);
+          process.off("SIGTERM", terminate);
+          process.off("SIGHUP", hangup);
+        }
+        if (failure?.code === "ENOENT") {
+          reject(Object.assign(new Error(`Cannot start ${command}: executable not found. Install it and make it available on PATH, then retry.`, { cause: failure }), {
+            code: "ENOENT",
+          }));
+        } else if (failure) reject(failure);
+        else if (code === 0) resolve();
+        else reject(Object.assign(new Error(`${command} failed with ${exitSignal ? `signal ${exitSignal}` : `status ${code ?? "unknown"}`}.`), { exitCode: code ?? 1 }));
+      });
+    });
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inthedark/wb",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "repository": {
     "type": "git",
@@ -31,6 +31,7 @@
     "index.d.ts",
     "store-definitions.mjs",
     "StoreCommandRunner.mjs",
+    "wb.schema.json",
     "README.md"
   ],
   "dependencies": {

package/wb.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "description": "Editor schema reference; ignored by Workbench.",
+      "type": "string"
+    },
+    "vis": {
+      "type": "object",
+      "properties": {
+        "css": {
+          "description": "Compiles CSS for .html and .svg vis files containing <link rel=\"workbench-css\">.",
+          "type": "object",
+          "properties": {
+            "command": {
+              "minItems": 1,
+              "maxItems": 64,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4000
+              },
+              "description": "Argument vector run from the project root, inside the calling thread's sandbox. Its stdout is the result. {file}, {root} and {input} are substituted."
+            },
+            "input": {
+              "description": "Written to a temporary file named by {input}, for tools that read an entry file rather than arguments.",
+              "type": "string",
+              "maxLength": 16000
+            }
+          },
+          "required": [
+            "command"
+          ],
+          "additionalProperties": false
+        },
+        "build": {
+          "description": "Builds .tsx and .jsx vis files; prints JSON { document, inputs }.",
+          "type": "object",
+          "properties": {
+            "command": {
+              "minItems": 1,
+              "maxItems": 64,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4000
+              },
+              "description": "Argument vector run from the project root, inside the calling thread's sandbox. Its stdout is the result. {file}, {root} and {input} are substituted."
+            },
+            "input": {
+              "description": "Written to a temporary file named by {input}, for tools that read an entry file rather than arguments.",
+              "type": "string",
+              "maxLength": 16000
+            }
+          },
+          "required": [
+            "command"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false,
+      "description": "Live visual drafts agents show with wb vis start."
+    }
+  },
+  "additionalProperties": false,
+  "description": "Project-owned Workbench settings, read from .wb.json at the project root."
+}