@join-pantheon/cli 0.26.0 → 0.26.1

package/bin/pantheon.js

@@ -9,7 +9,7 @@
  */
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const root = resolve(here, "..");
@@ -25,4 +25,9 @@ if (!existsSync(entry)) {
   process.exit(1);
 }
 
-await import(entry);
+// A path is not a URL, and on Windows that is fatal rather than pedantic: an
+// absolute POSIX path happens to work as an import specifier, while `D:\...`
+// is read as the scheme "d:" and Node refuses it — so `pantheon --version`,
+// the first command anyone runs, died with ERR_UNSUPPORTED_ESM_URL_SCHEME on
+// every Windows machine. A real Windows runner is what said so.
+await import(pathToFileURL(entry).href);

package/dist/agents.js

@@ -1,8 +1,9 @@
 import { execFileSync } from "node:child_process";
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
+import { homedir, platform } from "node:os";
 import { join, dirname, isAbsolute } from "node:path";
 import { launcher } from "./install.js";
+import { agentSpawn, which } from "./which.js";
 import { PANTHEON_TOOL_NAMES, PANTHEON_TOOLS } from "./tools.js";
 export function launchArgs(agent, prompt, name) {
     if (agent === "claude-code")
@@ -38,7 +39,7 @@ const sh = (cmd) => {
 };
 export function cliOnPath(name) {
     if (!binaryCache.has(`path:${name}`))
-        binaryCache.set(`path:${name}`, sh(`command -v ${name}`));
+        binaryCache.set(`path:${name}`, which(name));
     return binaryCache.get(`path:${name}`) ?? null;
 }
 export function agentById(id) {
@@ -87,7 +88,8 @@ const binaryCache = new Map();
 export function resolveBinary(backend) {
     for (const b of backend.binaries) {
         if (!binaryCache.has(b)) {
-            let found = sh(`command -v ${b}`) ? b : null;
+            const hit = which(b);
+            let found = hit ? (platform() === "win32" ? hit : b) : null;
             if (found && b === "agent") {
                 const v = `${sh("agent --version 2>/dev/null | head -1") ?? ""} ${sh("agent --help 2>/dev/null | head -3") ?? ""}`;
                 if (!/cursor/i.test(v))
@@ -119,7 +121,8 @@ export function copilotSignedIn(run = runStatus, env = process.env, gh = () => !
 }
 const runStatus = (binary, args) => {
     try {
-        const out = execFileSync(binary, args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 8_000, env: { ...process.env, NO_COLOR: "1" } });
+        const sp = agentSpawn(binary, args);
+        const out = execFileSync(sp.command, sp.args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 8_000, env: { ...process.env, NO_COLOR: "1" }, ...sp.options });
         return { status: 0, out };
     }
     catch (e) {

package/dist/cli.js

@@ -10,6 +10,7 @@ import { randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { PantheonClient } from "./client.js";
+import { agentSpawn } from "./which.js";
 import { fromInvite, looksLikeInviteCode, resolveInviteCode, load, save, toInvite, toJoinLink, resolveFor, loadAll, repoInfo, bindRepo, findMembership, setDefaultSpace, removeMembership, configFor, CONFIG_DIR, CONFIG_PATH, DEFAULT_RELAY, resolveForHook } from "./config.js";
 import { fmtLimit } from "./plans.js";
 import { validEmail, validUsername } from "./accounts.js";
@@ -2318,7 +2319,10 @@ async function main() {
                             const prompt = o ? dp(o.id, dt(o.body)) : `Read Pantheon act ${a.id}${goalId ? ` and the thread of goal ${goalId}` : ""}. Explain in plain words what happened and whether anything is owed by me, then give me numbered next steps. Do not act until I choose.`;
                             console.error(D(`opening ${agent.id}…`));
                             const { spawnSync } = await import("node:child_process");
-                            spawnSync(agent.binary, launchArgs(agent.id, prompt, sessionName(prompt)), { stdio: "inherit" });
+                            {
+                                const sp = agentSpawn(agent.binary, launchArgs(agent.id, prompt, sessionName(prompt)));
+                                spawnSync(sp.command, sp.args, { stdio: "inherit", ...sp.options });
+                            }
                             return;
                         }
                         if (choice === "2") {
@@ -2382,7 +2386,10 @@ async function main() {
                     const bin = cliOnPath("grok") ?? die("grok is not on PATH here");
                     console.error(D("opening grok…"));
                     const { spawnSync } = await import("node:child_process");
-                    spawnSync(bin, [hud.prompt], { stdio: "inherit" });
+                    {
+                        const sp = agentSpawn(bin, [hud.prompt]);
+                        spawnSync(sp.command, sp.args, { stdio: "inherit", ...sp.options });
+                    }
                     return;
                 }
                 if (hud.prompt) {
@@ -2391,7 +2398,10 @@ async function main() {
                         die("no agent CLI found on this machine (claude, cursor-agent, codex, or copilot)");
                     console.error(D(`opening ${agent.id}…`));
                     const { spawnSync } = await import("node:child_process");
-                    spawnSync(agent.binary, launchArgs(agent.id, hud.prompt, sessionName(hud.prompt)), { stdio: "inherit" });
+                    {
+                        const sp = agentSpawn(agent.binary, launchArgs(agent.id, hud.prompt, sessionName(hud.prompt)));
+                        spawnSync(sp.command, sp.args, { stdio: "inherit", ...sp.options });
+                    }
                     return;
                 }
                 if (hud.decision)
@@ -2414,7 +2424,10 @@ async function main() {
                 die("no agent CLI found on this machine (claude, cursor-agent, codex, or copilot)");
             console.error(D(`opening ${agent.id} with the question…`));
             const { spawnSync } = await import("node:child_process");
-            spawnSync(agent.binary, launchArgs(agent.id, prompt, sessionName(prompt)), { stdio: "inherit" });
+            {
+                const sp = agentSpawn(agent.binary, launchArgs(agent.id, prompt, sessionName(prompt)));
+                spawnSync(sp.command, sp.args, { stdio: "inherit", ...sp.options });
+            }
             return;
         }
         case "approvals": {

package/dist/doctor.js

@@ -14,6 +14,7 @@ import { hookState, readIntent, agentHookStates } from "./notify.js";
 import { loadPersonas } from "./persona.js";
 import { workerProc, menubarProc, notifierProc } from "./machine.js";
 import { chooseAgent, describeChoice } from "./agents.js";
+import { onPathNamed } from "./which.js";
 import { VERSION } from "./version.js";
 import { serviceInstalled } from "./service.js";
 import { hostEnv } from "./host-env.js";
@@ -135,7 +136,7 @@ export async function doctor(projectDir) {
         if (branch)
             add("pass", "git branch", branch);
     }
-    const agents = ["claude", "codex", "cursor-agent", "copilot"].filter((a) => sh(`command -v ${a}`));
+    const agents = ["claude", "codex", "cursor-agent", "copilot"].filter((a) => onPathNamed(a));
     agents.length
         ? add("pass", "agent cli", agents.join(", "), undefined, agents.join(", "))
         : add("warn", "agent cli", "found none of claude / codex / cursor-agent / copilot on PATH", "fine if you only drive agents through a GUI (Conductor, Cursor, VS Code), but `pantheon worker` needs a CLI to spawn", "none of claude / codex / cursor-agent / copilot on PATH");

package/dist/hooks-install.js

@@ -1,10 +1,10 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { HOOK_MARKER, MAX_CONSECUTIVE_BLOCKS } from "./notify.js";
+import { MAX_CONSECUTIVE_BLOCKS, isOurHookCommand } from "./notify.js";
 import { copilotHome } from "./agents.js";
 function ours(cmd) {
-    return !!cmd?.includes(HOOK_MARKER);
+    return isOurHookCommand(cmd);
 }
 function readJson(file) {
     if (!existsSync(file))

package/dist/install.js

@@ -7,18 +7,15 @@ import { grantToolPermissions, claudeSettingsFile, cursorCliConfigFile } from ".
 import { PANTHEON_TOOL_NAMES, WRITE_TOOL_NAMES } from "./tools.js";
 import { load } from "./config.js";
 import { loadProfile } from "./profile.js";
+import { agentSpawn, onPathNamed, which } from "./which.js";
 const HERE = dirname(fileURLToPath(import.meta.url));
 export function onPath() {
-    try {
-        execFileSync("sh", ["-lc", "command -v pantheon"], { stdio: ["ignore", "ignore", "ignore"] });
-        return true;
-    }
-    catch {
-        return false;
-    }
+    return onPathNamed("pantheon");
 }
-export function launcher(force) {
+export function launcher(force, os = platform()) {
     const portable = force === "portable" || (force !== "local" && onPath());
+    if (os === "win32")
+        return { command: process.execPath, args: [resolve(HERE, "cli.js"), "mcp"], portable: false };
     return portable
         ? { command: "pantheon", args: ["mcp"], portable: true }
         : { command: process.execPath, args: [resolve(HERE, "cli.js"), "mcp"], portable: false };
@@ -159,9 +156,17 @@ export function install(projectDir, cfg, force) {
 function localEntry() {
     return { command: process.execPath, args: [resolve(HERE, "cli.js"), "mcp"] };
 }
-function userEntry() {
+function userEntry(os = platform()) {
+    if (os === "win32") {
+        const node = process.execPath;
+        const entry = resolve(HERE, "cli.js");
+        if (existsSync(entry))
+            return { command: node, args: [entry, "mcp"] };
+        const abs = which("pantheon");
+        return abs ? { command: abs, args: ["mcp"] } : { command: "pantheon", args: ["mcp"] };
+    }
     try {
-        const abs = execFileSync("sh", ["-lc", "command -v pantheon"], { encoding: "utf8" }).trim();
+        const abs = which("pantheon") ?? "";
         if (abs && !isVersionManagedPath(abs))
             return { command: abs, args: ["mcp"] };
         if (abs)
@@ -176,18 +181,17 @@ function isVersionManagedPath(p) {
 }
 function claudeUserScope(entry) {
     const tool = "claude code";
-    try {
-        execFileSync("sh", ["-lc", "command -v claude"], { stdio: "ignore" });
-    }
-    catch {
+    const claudeBin = which("claude");
+    if (!claudeBin)
         return { tool, where: "-", status: "skipped (claude not on PATH)" };
-    }
     try {
+        const remove = agentSpawn(claudeBin, ["mcp", "remove", "pantheon", "-s", "user"]);
+        const add = agentSpawn(claudeBin, ["mcp", "add", "pantheon", "-s", "user", "--", entry.command, ...entry.args]);
         try {
-            execFileSync("claude", ["mcp", "remove", "pantheon", "-s", "user"], { stdio: "ignore" });
+            execFileSync(remove.command, remove.args, { stdio: "ignore", ...remove.options });
         }
         catch { }
-        execFileSync("claude", ["mcp", "add", "pantheon", "-s", "user", "--", entry.command, ...entry.args], { stdio: "ignore" });
+        execFileSync(add.command, add.args, { stdio: "ignore", ...add.options });
         return { tool, where: "user scope", status: "ready in every project and every Conductor window" };
     }
     catch (e) {
@@ -207,13 +211,8 @@ function copilotUserScope(entry) {
     const tool = "copilot";
     const file = copilotMcpConfigFile();
     let present = existsSync(dirname(file));
-    if (!present) {
-        try {
-            execFileSync("sh", ["-lc", "command -v copilot"], { stdio: "ignore" });
-            present = true;
-        }
-        catch { }
-    }
+    if (!present && onPathNamed("copilot"))
+        present = true;
     if (!present)
         return { tool, where: "-", status: "skipped (copilot not on PATH)" };
     try {

package/dist/notify.js

@@ -5,6 +5,9 @@ import { whichPantheon } from "./service.js";
 import { detectForHooks, agentById } from "./agents.js";
 import { codexHookState, cursorHookState, copilotHookState, installCodexHooks, installCursorHooks, installCopilotHooks, removeCodexHooks, removeCursorHooks, removeCopilotHooks, } from "./hooks-install.js";
 export const HOOK_MARKER = "pantheon hook";
+export const HOOK_RE = /pantheon(?:\.cmd|\.exe|\.bat)?"?\s+hook\s/i;
+export const isOurHookCommand = (cmd) => !!cmd && (cmd.includes(HOOK_MARKER) || HOOK_RE.test(cmd));
+export const hookBin = (bin) => (/\s/.test(bin) ? `"${bin}"` : bin);
 export function settingsPath(scope, projectDir = process.cwd()) {
     return scope === "user"
         ? join(homedir(), ".claude", "settings.json")
@@ -25,7 +28,7 @@ function write(file, doc) {
     writeFileSync(file, JSON.stringify(doc, null, 2) + "\n");
 }
 function ours(g) {
-    return g.hooks?.some((h) => h.command?.includes(HOOK_MARKER)) ?? false;
+    return g.hooks?.some((h) => isOurHookCommand(h.command)) ?? false;
 }
 export function hookState(projectDir = process.cwd(), only) {
     for (const scope of (only ? [only] : ["project", "user"])) {
@@ -46,7 +49,7 @@ export function hookState(projectDir = process.cwd(), only) {
             if (!hit)
                 continue;
             events.push(event);
-            command ??= hit.hooks.find((h) => h.command.includes(HOOK_MARKER)).command;
+            command ??= hit.hooks.find((h) => isOurHookCommand(h.command)).command;
         }
         if (events.length)
             return { installed: true, scope, file, command, events };
@@ -137,7 +140,10 @@ export function repairHook(home) {
 function installClaudeHook(scope, projectDir = process.cwd()) {
     const file = settingsPath(scope, projectDir);
     const doc = read(file);
-    const bin = whichPantheon();
+    const found = whichPantheon();
+    if (!found)
+        throw new Error("pantheon binary not found on PATH");
+    const bin = hookBin(found);
     const events = {
         Stop: `${bin} hook stop`,
         UserPromptSubmit: `${bin} hook prompt`,

package/dist/quickstart.js

@@ -16,6 +16,7 @@ import { desktopUnavailable, ephemeralWarning, hostEnv } from "./host-env.js";
 import { existsSync } from "node:fs";
 import { grant as grantCap, loadPolicy, policyPath, savePolicy } from "./worker-policy.js";
 import { Relay } from "./relay.js";
+import { which } from "./which.js";
 const sh = (cmd) => {
     try {
         return execFileSync("sh", ["-lc", cmd], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim() || null;
@@ -126,7 +127,7 @@ export function findReach(port) {
     if (ts && /^\d+\.\d+\.\d+\.\d+$/.test(ts)) {
         return { url: `ws://${ts}:${port}`, how: `tailscale (${ts})`, shareable: true };
     }
-    if (sh("command -v cloudflared")) {
+    if (which("cloudflared")) {
         return {
             url: `ws://127.0.0.1:${port}`, how: "localhost", shareable: false,
             hint: `cloudflared is installed. To let a teammate reach you:\n` +

package/dist/service.js

@@ -1,6 +1,7 @@
 import { writeFileSync, mkdirSync, existsSync, unlinkSync } from "node:fs";
 import { execFileSync } from "node:child_process";
 import { homedir, platform } from "node:os";
+import { which } from "./which.js";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { launcher } from "./install.js";
@@ -29,6 +30,8 @@ function argvFor(kind, args) {
     return abs ? [abs, kind, ...args] : [process.execPath, resolve(HERE, "cli.js"), kind, ...args];
 }
 export function whichPantheon() {
+    if (platform() === "win32")
+        return which("pantheon");
     try {
         const p = execFileSync("/usr/bin/which", ["pantheon"], { encoding: "utf8" }).trim();
         return p.startsWith("/") && existsSync(p) ? p : null;

package/dist/update-check.js

@@ -43,6 +43,8 @@ export function updateStatus(deps) {
 export function versionLine(version, behind, latest) {
     if (behind <= 0)
         return `pantheon ${version}`;
+    if (latest && !semverGt(latest, version))
+        return `pantheon ${version}`;
     return latest
         ? `pantheon ${version}  ·  ${latest} available — run \`pantheon upgrade\``
         : `pantheon ${version}  ·  ${behind} update${behind === 1 ? "" : "s"} behind — run \`pantheon upgrade\``;

package/dist/which.js

@@ -0,0 +1,73 @@
+import { execFileSync } from "node:child_process";
+import { accessSync, constants, existsSync, statSync } from "node:fs";
+import { win32 } from "node:path";
+import { platform } from "node:os";
+export const DEFAULT_PATHEXT = ".COM;.EXE;.BAT;.CMD;.VBS;.JS;.PS1";
+const isWindows = (os = platform()) => os === "win32";
+function runnable(file) {
+    try {
+        if (!existsSync(file) || !statSync(file).isFile())
+            return false;
+        if (isWindows())
+            return true;
+        accessSync(file, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function whichWindows(name, env = process.env, exists = runnable) {
+    if (!name)
+        return null;
+    const exts = (env.PATHEXT || DEFAULT_PATHEXT).split(";").map((e) => e.trim()).filter(Boolean);
+    const ext = win32.extname(name);
+    const hasExt = !!ext && exts.some((e) => e.toLowerCase() === ext.toLowerCase());
+    const candidates = (base) => hasExt ? [base] : exts.flatMap((e) => (e === e.toLowerCase() ? [base + e] : [base + e.toLowerCase(), base + e]));
+    if (win32.isAbsolute(name)) {
+        for (const c of candidates(name))
+            if (exists(c))
+                return c;
+        return null;
+    }
+    for (const dir of (env.PATH || env.Path || "").split(";")) {
+        const d = dir.replace(/^"|"$/g, "").trim();
+        if (!d)
+            continue;
+        for (const c of candidates(win32.join(d, name)))
+            if (exists(c))
+                return c;
+    }
+    return null;
+}
+export function which(name, os = platform(), env = process.env) {
+    if (isWindows(os))
+        return whichWindows(name, env);
+    try {
+        const out = execFileSync("sh", ["-lc", `command -v ${name}`], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        if (!out)
+            return null;
+        return out.startsWith("/") && !runnable(out) ? null : out;
+    }
+    catch {
+        return null;
+    }
+}
+export const onPathNamed = (name, os = platform(), env = process.env) => which(name, os, env) !== null;
+export function spawnShape(binary, os = platform()) {
+    if (!isWindows(os))
+        return { command: binary, shell: false };
+    return { command: binary, shell: /\.(cmd|bat)$/i.test(binary) };
+}
+const cmdQuote = (a) => (/[\s"&|<>^()]/.test(a) || a === "" ? `"${a.replace(/"/g, '\\"')}"` : a);
+export function agentSpawn(binary, args, os = platform()) {
+    if (!isWindows(os) || !/\.(cmd|bat)$/i.test(binary))
+        return { command: binary, args: [...args], options: {} };
+    const line = [binary, ...args].map(cmdQuote).join(" ");
+    return {
+        command: process.env.ComSpec || "cmd.exe",
+        args: ["/d", "/s", "/c", `"${line}"`],
+        options: { windowsVerbatimArguments: true },
+    };
+}
+//# sourceMappingURL=which.js.map

package/dist/worker.js

@@ -5,6 +5,7 @@ import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { PantheonClient } from "./client.js";
 import { headlessSpawn, materializeSpawnFiles, chooseAgent, describeChoice } from "./agents.js";
+import { agentSpawn } from "./which.js";
 import { VERSION } from "./version.js";
 import { applyAnswer, loadPolicy, mayAsk, needsSelfUpgrade, recordAsk, savePolicy, useGrant, } from "./worker-policy.js";
 import { agentHookStates, repairHook } from "./notify.js";
@@ -616,7 +617,8 @@ export class Worker {
             return { obligation: o, branch, worktree, ok: false, detail };
         }
         const detail = await new Promise((res) => {
-            const child = procSpawn(command, args, { cwd: worktree, stdio: ["ignore", "pipe", "pipe"], env });
+            const sp = agentSpawn(command, args);
+            const child = procSpawn(sp.command, sp.args, { cwd: worktree, stdio: ["ignore", "pipe", "pipe"], env, ...sp.options });
             let out = "";
             child.stdout.on("data", (b) => { out += b.toString(); });
             child.stderr.on("data", (b) => { out += b.toString(); });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@join-pantheon/cli",
-  "version": "0.26.0",
-  "description": "Let your coding agent collaborate directly with your teammates' agents — ask, agree an interface, and deliver, without a human relaying messages.",
+  "version": "0.26.1",
+  "description": "Let your coding agent collaborate directly with your teammates' agents \u2014 ask, agree an interface, and deliver, without a human relaying messages.",
   "type": "module",
   "bin": {
     "pantheon": "bin/pantheon.js"
@@ -10,13 +10,15 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc -p .",
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p .",
     "dev": "tsc -p . --watch",
     "relay": "node dist/cli.js relay",
     "test": "PANTHEON_HOME=\"$(mktemp -d)\" HOME=\"$(mktemp -d)\" node --test --test-force-exit dist/test/*.test.js",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build && npm test",
-    "start": "node dist/cli.js relay"
+    "start": "node dist/cli.js relay",
+    "test:ci": "node scripts/test.mjs",
+    "smoke": "node scripts/smoke.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",