fellow-agents 0.0.10 → 0.0.12

package/dist/cli.js

@@ -2,8 +2,10 @@
 const args = process.argv.slice(2);
 // Default to "start" if no command given or first arg is a flag
 const command = args[0] === "stop" ? "stop"
-    : (args[0] === "--help" || args[0] === "-h") ? "help"
-        : "start";
+    : args[0] === "clean" ? "clean"
+        : args[0] === "uninstall" ? "uninstall"
+            : (args[0] === "--help" || args[0] === "-h") ? "help"
+                : "start";
 function getFlag(name, fallback) {
     const idx = args.indexOf(name);
     return idx !== -1 && args[idx + 1] ? args[idx + 1] : fallback;
@@ -25,12 +27,25 @@ else if (command === "stop") {
     const { stop } = await import("./commands/stop.js");
     stop();
 }
+else if (command === "clean") {
+    const { clean } = await import("./commands/clean.js");
+    clean();
+}
+else if (command === "uninstall") {
+    const { uninstall } = await import("./commands/uninstall.js");
+    uninstall({
+        dir: getFlag("--dir", process.cwd()),
+        yes: hasFlag("--yes"),
+    });
+}
 else {
     console.log(`fellow-agents — multi-agent system for Claude Code
 
 Usage:
   fellow-agents [options]            Start services (default)
   fellow-agents stop                 Stop all running services
+  fellow-agents clean                Wipe cached binaries + pty-win, preserve logs
+  fellow-agents uninstall [--yes]    Remove all fellow-agents state (data dir + workspaces)
 
 Options:
   --port <number>       pty-win port (default: 3700)
@@ -38,6 +53,7 @@ Options:
   --dir <path>          Working directory (default: current)
   --no-browser          Don't open browser
   --update              Force re-download binaries
+  --yes                 Skip confirmation prompt (uninstall only)
 
   -h, --help            Show this help`);
 }

package/dist/commands/clean.js

@@ -0,0 +1,72 @@
+import { existsSync, rmSync, statSync, readdirSync } from "fs";
+import { join } from "path";
+import { dataDir, binDir, ptyWinDir, pidDir } from "../lib/paths.js";
+import { stopAll } from "../lib/services.js";
+function dirSize(path) {
+    if (!existsSync(path))
+        return 0;
+    let total = 0;
+    const stack = [path];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        try {
+            const stat = statSync(current);
+            if (stat.isDirectory()) {
+                for (const entry of readdirSync(current))
+                    stack.push(join(current, entry));
+            }
+            else {
+                total += stat.size;
+            }
+        }
+        catch { }
+    }
+    return total;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+export function clean() {
+    console.log("");
+    console.log("  Cleaning fellow-agents state...");
+    stopAll();
+    // Wipe these — logs/ is preserved for postmortem
+    const targets = [
+        { label: "bin", path: binDir },
+        { label: "pty-win", path: ptyWinDir },
+        { label: "pid", path: pidDir },
+    ];
+    let totalFreed = 0;
+    for (const t of targets) {
+        if (existsSync(t.path)) {
+            const size = dirSize(t.path);
+            try {
+                rmSync(t.path, { recursive: true, force: true });
+                console.log(`  Removed ${t.label}/ (${formatBytes(size)})`);
+                totalFreed += size;
+            }
+            catch (err) {
+                console.error(`  Failed to remove ${t.label}/: ${err.message}`);
+            }
+        }
+    }
+    // Reset version stamp (separate from bin/ since it's nested but worth calling out)
+    const versionPath = join(dataDir, "bin", ".version");
+    if (existsSync(versionPath)) {
+        try {
+            rmSync(versionPath);
+        }
+        catch { }
+    }
+    console.log("");
+    console.log(`  Cleaned ${formatBytes(totalFreed)} from ${dataDir}`);
+    console.log(`  Logs preserved at ${join(dataDir, "logs")}`);
+    console.log(`  Run 'fellow-agents' to reinstall.`);
+    console.log("");
+}

package/dist/commands/start.js

@@ -1,4 +1,4 @@
-import { existsSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import http from "http";
 import { join, resolve } from "path";
 import { execSync } from "child_process";
@@ -7,6 +7,15 @@ import { downloadBinaries } from "../lib/download.js";
 import { startEmcomServer, startPtyWin, stopAll, logPath } from "../lib/services.js";
 import { scaffoldWorkspaces, registerAgents, writeHooks } from "../lib/workspaces.js";
 import { binarySuffix } from "../lib/platform.js";
+// Minimal engines.node range check — handles ">=N", "<N", and combinations.
+function nodeInRange(version, range) {
+    const major = parseInt(version.split(".")[0], 10);
+    const minMatch = range.match(/>=?\s*(\d+)/);
+    const maxMatch = range.match(/<\s*(\d+)/);
+    const min = minMatch ? parseInt(minMatch[1], 10) : 0;
+    const max = maxMatch ? parseInt(maxMatch[1], 10) : Infinity;
+    return major >= min && major < max;
+}
 export async function start(opts) {
     console.log("");
     console.log("  fellow-agents");
@@ -53,16 +62,34 @@ export async function start(opts) {
     }
     // 3. Install pty-win dependencies
     console.log("[3/7] Installing pty-win...");
-    if (existsSync(join(ptyWinDir, "package.json"))) {
-        if (!existsSync(join(ptyWinDir, "node_modules"))) {
-            execSync("npm install --production", { cwd: ptyWinDir, stdio: "pipe" });
-        }
-        console.log("  pty-win ready");
-    }
-    else {
+    const ptyPkgPath = join(ptyWinDir, "package.json");
+    if (!existsSync(ptyPkgPath)) {
         console.error("  pty-win not found — download may have failed");
         process.exit(1);
     }
+    // Warn fail-fast if Node is outside pty-win's supported range
+    try {
+        const ptyPkg = JSON.parse(readFileSync(ptyPkgPath, "utf-8"));
+        const range = ptyPkg.engines?.node;
+        if (range && !nodeInRange(nodeVer, range)) {
+            console.error(`  WARNING: pty-win supports Node ${range}, you have ${nodeVer}.`);
+            console.error(`  Install may fail. Consider using Node 22 LTS.`);
+        }
+    }
+    catch { }
+    // Probe for a real dep instead of just node_modules/ — partial installs leave the dir but miss packages
+    const expressInstalled = existsSync(join(ptyWinDir, "node_modules", "express", "package.json"));
+    if (!expressInstalled) {
+        try {
+            execSync("npm install --omit=dev", { cwd: ptyWinDir, stdio: "inherit" });
+        }
+        catch (err) {
+            console.error(`  pty-win install failed — see output above`);
+            console.error(`  Logs will be written to: ${logPath("pty-win")}`);
+            process.exit(1);
+        }
+    }
+    console.log("  pty-win ready");
     // 4. Scaffold workspaces
     console.log("[4/7] Scaffolding workspaces...");
     scaffoldWorkspaces(workDir);

package/dist/commands/uninstall.js

@@ -0,0 +1,99 @@
+import { existsSync, rmSync, statSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { dataDir } from "../lib/paths.js";
+import { stopAll } from "../lib/services.js";
+function dirSize(path) {
+    if (!existsSync(path))
+        return 0;
+    let total = 0;
+    const stack = [path];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        try {
+            const stat = statSync(current);
+            if (stat.isDirectory()) {
+                for (const entry of readdirSync(current))
+                    stack.push(join(current, entry));
+            }
+            else {
+                total += stat.size;
+            }
+        }
+        catch { }
+    }
+    return total;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+export function uninstall(opts) {
+    const workDir = resolve(opts.dir);
+    // Two possible workspace locations — start.ts uses either depending on whether cwd has workspaces/
+    const wsCandidates = [
+        join(workDir, "workspaces"),
+        join(workDir, "fellow-agents", "workspaces"),
+    ];
+    const targets = [];
+    if (existsSync(dataDir)) {
+        targets.push({ label: "Data directory", path: dataDir, size: dirSize(dataDir) });
+    }
+    for (const ws of wsCandidates) {
+        if (existsSync(ws)) {
+            targets.push({ label: "Workspaces", path: ws, size: dirSize(ws) });
+        }
+    }
+    console.log("");
+    console.log("  fellow-agents uninstall");
+    console.log("  =======================");
+    console.log("");
+    if (targets.length === 0) {
+        console.log("  Nothing to remove — no fellow-agents state found.");
+        console.log("");
+        console.log("  To uninstall the npm package itself, run:");
+        console.log("    npm uninstall -g fellow-agents");
+        console.log("");
+        return;
+    }
+    const totalSize = targets.reduce((sum, t) => sum + t.size, 0);
+    console.log("  The following will be permanently removed:");
+    console.log("");
+    for (const t of targets) {
+        console.log(`    ${t.path}  (${formatBytes(t.size)})`);
+    }
+    console.log("");
+    console.log(`  Total: ${formatBytes(totalSize)}`);
+    console.log("");
+    if (!opts.yes) {
+        console.log("  This is a dry run. To proceed, add --yes:");
+        console.log("    fellow-agents uninstall --yes");
+        console.log("");
+        console.log("  Tip: pass --dir <path> if your workspaces are elsewhere.");
+        console.log("");
+        return;
+    }
+    // Actually do the uninstall
+    console.log("  Stopping services...");
+    stopAll();
+    console.log("");
+    for (const t of targets) {
+        try {
+            rmSync(t.path, { recursive: true, force: true });
+            console.log(`  Removed ${t.path}`);
+        }
+        catch (err) {
+            console.error(`  Failed to remove ${t.path}: ${err.message}`);
+        }
+    }
+    console.log("");
+    console.log("  fellow-agents state removed.");
+    console.log("");
+    console.log("  To uninstall the npm package itself, run:");
+    console.log("    npm uninstall -g fellow-agents");
+    console.log("");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fellow-agents",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "Multi-agent system — multiple Claude Code instances collaborating via messaging",
   "type": "module",
   "bin": {