@annix/claude-swarm 0.1.0

package/README.md

@@ -0,0 +1,197 @@
+# claude-swarm
+
+Manage multiple parallel Claude CLI sessions with worktree isolation and pluggable dev server lifecycle management.
+
+## Features
+
+- **Session Management**: Detect, spawn, and terminate Claude CLI sessions
+- **Worktree Isolation**: Run parallel sessions in separate git worktrees
+- **Cross-Platform**: Works on Windows, macOS, and Linux
+- **GitHub Integration**: Start sessions from GitHub issues
+- **Process Detection**: Distinguish between active (terminal-attached) and orphaned (detached) sessions
+- **Cleanup Tools**: Kill orphaned sessions individually or in bulk
+- **Pluggable App Adapters**: Manage dev servers for any project via config or built-in adapters
+- **Live Log Viewing**: Tail dev server logs inside the TUI
+
+## Installation
+
+```sh
+npm install -g @annix/claude-swarm
+# or run directly via the launcher
+../claude-swarm/bin/claude-swarm
+```
+
+## Usage
+
+Run from any git repository:
+
+```sh
+claude-swarm
+```
+
+The tool will detect the current project and load configuration from `.claude-swarm.json` in the current directory if present.
+
+## Project configuration
+
+### `.claude-swarm.json`
+
+Create a `.claude-swarm.json` in your project root to configure the branch prefix and dev servers:
+
+```json
+{
+  "branchPrefix": "claude/",
+  "apps": [
+    {
+      "name": "backend",
+      "start": "pnpm dev:backend",
+      "stop": "lsof -ti:4001 | xargs kill -15 2>/dev/null; true",
+      "kill": "lsof -ti:4001 | xargs kill -9 2>/dev/null; true",
+      "readyPattern": "Nest application successfully started"
+    },
+    {
+      "name": "frontend",
+      "start": "pnpm dev:frontend",
+      "stop": "lsof -ti:3000 | xargs kill -15 2>/dev/null; true",
+      "kill": "lsof -ti:3000 | xargs kill -9 2>/dev/null; true",
+      "readyPattern": "Ready in"
+    }
+  ]
+}
+```
+
+### Configuration fields
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `branchPrefix` | `string` | `"claude/"` | Prefix for Claude-managed branches |
+| `apps` | `AppAdapterConfig[]` | `[]` | Dev server definitions |
+
+### App adapter config
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Display name shown in the TUI |
+| `start` | `string` | Yes | Shell command to start the server |
+| `stop` | `string` | Yes | Shell command or signal to stop gracefully (e.g. `signal:SIGTERM`) |
+| `kill` | `string` | Yes | Shell command or signal to force-stop (e.g. `signal:SIGKILL`, or `lsof -ti:PORT | xargs kill -9`) |
+| `readyPattern` | `string` | No | Regex to match against stdout/stderr to detect when the server is ready |
+
+When `readyPattern` is set, `start` blocks until the pattern matches or the 120 second timeout elapses.
+
+Dev server output is always streamed to `.claude-swarm-<name>.log` in the project directory, regardless of whether `readyPattern` is set. Add `.claude-swarm-*.log` to your `.gitignore`.
+
+### Stop vs Kill commands
+
+- **stop**: Sent first; should request graceful shutdown (e.g. SIGTERM or port-based kill -15)
+- **kill**: Fallback if stop throws; should force-terminate (e.g. SIGKILL or port-based kill -9)
+
+Use port-based kill commands (via `lsof`) for processes spawned through npm/pnpm scripts, as the script process PID differs from the actual server PID:
+
+```
+"stop": "lsof -ti:4001 | xargs kill -15 2>/dev/null; true"
+"kill": "lsof -ti:4001 | xargs kill -9 2>/dev/null; true"
+```
+
+Use signal format for processes you start directly:
+
+```
+"stop": "signal:SIGTERM"
+"kill": "signal:SIGKILL"
+```
+
+## Multi-project support
+
+claude-swarm manages sessions across multiple projects. On first run it detects the current git repo and adds it automatically. Additional projects can be added interactively via the session menu.
+
+Project configurations are saved to `~/.config/claude-swarm/projects.json`. This is a user-level config file shared across all invocations.
+
+### `~/.config/claude-swarm/projects.json`
+
+```json
+{
+  "projects": [
+    {
+      "name": "myapp",
+      "path": "/Users/you/dev/myapp",
+      "worktreeDir": "/Users/you/dev/myapp-worktrees"
+    }
+  ],
+  "defaultProject": "myapp"
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `projects[].name` | `string` | Display name |
+| `projects[].path` | `string` | Absolute path to the git repo root |
+| `projects[].worktreeDir` | `string` | Where worktrees are created (default: `../name-worktrees` sibling) |
+| `defaultProject` | `string` | Name of the project to select on startup |
+
+## Bin launcher
+
+The `bin/claude-swarm` script provides hash-based auto-install/build: it only runs `npm install` or `npm run build` when `package-lock.json` or `src/` files have changed since the last run. This means subsequent invocations start instantly.
+
+```sh
+# From annix:
+pnpm claude-swarm
+
+# Directly:
+../claude-swarm/bin/claude-swarm
+```
+
+## Branch workflow
+
+Claude sessions work on branches with the configured prefix (default `claude/`). The TUI provides:
+
+- **Branch listing** — all claude branches with ahead/behind status
+- **Rebase** — rebase a claude branch onto main
+- **Approve** — rebase + fast-forward merge + delete in one step
+- **Cherry-pick** — pull specific commits from a claude branch for testing on main
+
+## App Adapter interface
+
+You can use the built-in adapters programmatically:
+
+```typescript
+import {
+  AppAdapter,
+  NestAdapter,
+  NextAdapter,
+  ViteAdapter,
+  NullAdapter,
+  ConfigAdapter,
+  DevServerAdapter,
+} from "@annix/claude-swarm";
+```
+
+### Built-in adapters
+
+| Adapter | Description |
+|---------|-------------|
+| `NestAdapter` | NestJS backend (`nest start --watch`) |
+| `NextAdapter` | Next.js frontend (`next dev`) |
+| `ViteAdapter` | Vite dev server (`vite`) |
+| `NullAdapter` | No-op for projects with no managed dev server |
+| `ConfigAdapter` | Generic adapter driven by `.claude-swarm.json` |
+| `DevServerAdapter` | Abstract base class; extend to build custom adapters |
+
+### Custom adapters
+
+Implement the `AppAdapter` interface:
+
+```typescript
+interface AppAdapter {
+  readonly name: string;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  kill(): Promise<void>;
+  isRunning(): Promise<boolean>;
+  logFile(): string | null;
+}
+```
+
+`logFile()` should return the absolute path to the log file for this adapter, or `null` if no log is available. The path is used by the "View logs" TUI feature.
+
+## License
+
+MIT

package/bin/claude-swarm

@@ -0,0 +1,50 @@
+#!/bin/bash
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+  DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+DEPS_HASH_FILE="node_modules/.install-hash"
+BUILD_HASH_FILE="dist/.build-hash"
+
+compute_deps_hash() {
+  cat package-lock.json 2>/dev/null | shasum -a 256 | cut -d' ' -f1
+}
+
+compute_src_hash() {
+  find src -name "*.ts" | sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -d' ' -f1
+}
+
+needs_install() {
+  [ ! -d "node_modules" ] && return 0
+  [ ! -f "$DEPS_HASH_FILE" ] && return 0
+  [ "$(compute_deps_hash)" != "$(cat "$DEPS_HASH_FILE" 2>/dev/null)" ] && return 0
+  return 1
+}
+
+needs_build() {
+  [ ! -d "dist" ] && return 0
+  [ ! -f "dist/index.js" ] && return 0
+  [ ! -f "$BUILD_HASH_FILE" ] && return 0
+  [ "$(compute_src_hash)" != "$(cat "$BUILD_HASH_FILE" 2>/dev/null)" ] && return 0
+  return 1
+}
+
+if needs_install; then
+  echo "Installing dependencies..."
+  npm install --silent
+  compute_deps_hash > "$DEPS_HASH_FILE"
+fi
+
+if needs_build; then
+  echo "Building..."
+  npm run build --silent
+  compute_src_hash > "$BUILD_HASH_FILE"
+fi
+
+exec node dist/index.js "$@"

package/dist/.build-hash

@@ -0,0 +1 @@
+b314e1ee99e0d74721451e9016635836eaf0687106d416b2fadc05f5f93e6be3

package/dist/adapters/AppAdapter.d.ts

@@ -0,0 +1,9 @@
+export interface AppAdapter {
+    readonly name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    logFile(): string | null;
+}
+//# sourceMappingURL=AppAdapter.d.ts.map

package/dist/adapters/AppAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/AppAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/adapters/AppAdapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AppAdapter.js.map

package/dist/adapters/AppAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppAdapter.js","sourceRoot":"","sources":["../../src/adapters/AppAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/ConfigAdapter.d.ts

@@ -0,0 +1,21 @@
+import type { AppAdapter } from "./AppAdapter.js";
+export interface AppAdapterConfig {
+    name: string;
+    start: string;
+    stop: string;
+    kill: string;
+    readyPattern?: string;
+}
+export declare class ConfigAdapter implements AppAdapter {
+    readonly name: string;
+    private readonly config;
+    private readonly cwd;
+    constructor(config: AppAdapterConfig, cwd: string);
+    logFile(): string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    private sendSignalToChildren;
+}
+//# sourceMappingURL=ConfigAdapter.d.ts.map

package/dist/adapters/ConfigAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ConfigAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM;IAMjD,OAAO,IAAI,MAAM;IAIX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAYnC,OAAO,CAAC,oBAAoB;CAK7B"}

package/dist/adapters/ConfigAdapter.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigAdapter = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+class ConfigAdapter {
+    name;
+    config;
+    cwd;
+    constructor(config, cwd) {
+        this.name = config.name;
+        this.config = config;
+        this.cwd = cwd;
+    }
+    logFile() {
+        return (0, node_path_1.join)(this.cwd, `.claude-swarm-${this.name}.log`);
+    }
+    async start() {
+        const logPath = this.logFile();
+        const logStream = (0, node_fs_1.createWriteStream)(logPath, { flags: "a" });
+        if (!this.config.readyPattern) {
+            const proc = (0, node_child_process_1.spawn)(this.config.start, [], {
+                cwd: this.cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                detached: true,
+                shell: true,
+            });
+            proc.stdout?.pipe(logStream);
+            proc.stderr?.pipe(logStream);
+            proc.unref();
+            return;
+        }
+        const pattern = new RegExp(this.config.readyPattern);
+        const timeoutMs = 120000;
+        await new Promise((resolve, reject) => {
+            const proc = (0, node_child_process_1.spawn)(this.config.start, [], {
+                cwd: this.cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                detached: true,
+                shell: true,
+            });
+            proc.stdout?.pipe(logStream, { end: false });
+            proc.stderr?.pipe(logStream, { end: false });
+            let settled = false;
+            const finish = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                proc.unref();
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            };
+            const checkOutput = (data) => {
+                if (pattern.test(data.toString())) {
+                    finish();
+                }
+            };
+            proc.stdout?.on("data", checkOutput);
+            proc.stderr?.on("data", checkOutput);
+            proc.on("error", (err) => finish(err));
+            const timer = setTimeout(() => finish(new Error(`${this.name} did not start within ${timeoutMs}ms`)), timeoutMs);
+        });
+    }
+    async stop() {
+        if (this.config.stop.startsWith("signal:")) {
+            const signal = this.config.stop.replace("signal:", "");
+            this.sendSignalToChildren(signal);
+        }
+        else {
+            try {
+                (0, node_child_process_1.execSync)(this.config.stop, { cwd: this.cwd, stdio: "pipe" });
+            }
+            catch { }
+        }
+    }
+    async kill() {
+        if (this.config.kill.startsWith("signal:")) {
+            const signal = this.config.kill.replace("signal:", "");
+            this.sendSignalToChildren(signal);
+        }
+        else {
+            try {
+                (0, node_child_process_1.execSync)(this.config.kill, { cwd: this.cwd, stdio: "pipe" });
+            }
+            catch { }
+        }
+    }
+    async isRunning() {
+        try {
+            const result = (0, node_child_process_1.execSync)(`pgrep -f "${this.config.start}" 2>/dev/null`, {
+                encoding: "utf-8",
+                stdio: "pipe",
+            }).trim();
+            return result !== "";
+        }
+        catch {
+            return false;
+        }
+    }
+    sendSignalToChildren(signal) {
+        try {
+            (0, node_child_process_1.execSync)(`pkill -${signal} -f "${this.config.start}" 2>/dev/null`, { stdio: "pipe" });
+        }
+        catch { }
+    }
+}
+exports.ConfigAdapter = ConfigAdapter;
+//# sourceMappingURL=ConfigAdapter.js.map

package/dist/adapters/ConfigAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigAdapter.js","sourceRoot":"","sources":["../../src/adapters/ConfigAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/DevServerAdapter.d.ts

@@ -0,0 +1,15 @@
+import type { AppAdapter } from "./AppAdapter.js";
+export declare abstract class DevServerAdapter implements AppAdapter {
+    abstract readonly name: string;
+    protected readonly cwd: string;
+    protected readonly port: number;
+    protected abstract readonly startArgs: string[];
+    protected abstract readonly processPattern: string;
+    constructor(cwd: string, port: number);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    logFile(): string | null;
+}
+//# sourceMappingURL=DevServerAdapter.d.ts.map

package/dist/adapters/DevServerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServerAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/DevServerAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,8BAAsB,gBAAiB,YAAW,UAAU;IAC1D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAChD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEvC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAK/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAYnC,OAAO,IAAI,MAAM,GAAG,IAAI;CAGzB"}

package/dist/adapters/DevServerAdapter.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevServerAdapter = void 0;
+const node_child_process_1 = require("node:child_process");
+class DevServerAdapter {
+    cwd;
+    port;
+    constructor(cwd, port) {
+        this.cwd = cwd;
+        this.port = port;
+    }
+    async start() {
+        const { spawn } = await Promise.resolve().then(() => __importStar(require("node:child_process")));
+        const [cmd, ...args] = this.startArgs;
+        const proc = spawn(cmd, args, {
+            cwd: this.cwd,
+            stdio: "ignore",
+            detached: true,
+        });
+        proc.unref();
+    }
+    async stop() {
+        try {
+            (0, node_child_process_1.execSync)(`pkill -f "${this.processPattern}" 2>/dev/null`, { stdio: "pipe" });
+        }
+        catch { }
+    }
+    async kill() {
+        try {
+            (0, node_child_process_1.execSync)(`pkill -9 -f "${this.processPattern}" 2>/dev/null`, { stdio: "pipe" });
+        }
+        catch { }
+    }
+    async isRunning() {
+        try {
+            const result = (0, node_child_process_1.execSync)(`lsof -i :${this.port} -sTCP:LISTEN 2>/dev/null | grep -c LISTEN`, {
+                encoding: "utf-8",
+                stdio: "pipe",
+            }).trim();
+            return Number.parseInt(result, 10) > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    logFile() {
+        return null;
+    }
+}
+exports.DevServerAdapter = DevServerAdapter;
+//# sourceMappingURL=DevServerAdapter.js.map

package/dist/adapters/DevServerAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServerAdapter.js","sourceRoot":"","sources":["../../src/adapters/DevServerAdapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2DAA8C;AAG9C,MAAsB,gBAAgB;IAEjB,GAAG,CAAS;IACZ,IAAI,CAAS;IAIhC,YAAY,GAAW,EAAE,IAAY;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,KAAK,EAAE,GAAG,wDAAa,oBAAoB,GAAC,CAAC;QACrD,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;YAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAA,6BAAQ,EAAC,aAAa,IAAI,CAAC,cAAc,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAA,6BAAQ,EAAC,gBAAgB,IAAI,CAAC,cAAc,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,6BAAQ,EAAC,YAAY,IAAI,CAAC,IAAI,4CAA4C,EAAE;gBACzF,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,MAAM;aACd,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAlDD,4CAkDC"}

package/dist/adapters/NestAdapter.d.ts

@@ -0,0 +1,8 @@
+import { DevServerAdapter } from "./DevServerAdapter.js";
+export declare class NestAdapter extends DevServerAdapter {
+    readonly name = "nest";
+    protected readonly startArgs: string[];
+    protected readonly processPattern = "nest.* start";
+    constructor(cwd: string, port?: number);
+}
+//# sourceMappingURL=NestAdapter.d.ts.map

package/dist/adapters/NestAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NestAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/NestAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,QAAQ,CAAC,IAAI,UAAU;IACvB,SAAS,CAAC,QAAQ,CAAC,SAAS,WAAuC;IACnE,SAAS,CAAC,QAAQ,CAAC,cAAc,kBAAkB;gBAEvC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAO;CAGrC"}

package/dist/adapters/NestAdapter.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestAdapter = void 0;
+const DevServerAdapter_js_1 = require("./DevServerAdapter.js");
+class NestAdapter extends DevServerAdapter_js_1.DevServerAdapter {
+    name = "nest";
+    startArgs = ["npx", "nest", "start", "--watch"];
+    processPattern = "nest.* start";
+    constructor(cwd, port = 3000) {
+        super(cwd, port);
+    }
+}
+exports.NestAdapter = NestAdapter;
+//# sourceMappingURL=NestAdapter.js.map

package/dist/adapters/NestAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NestAdapter.js","sourceRoot":"","sources":["../../src/adapters/NestAdapter.ts"],"names":[],"mappings":";;;AAAA,+DAAyD;AAEzD,MAAa,WAAY,SAAQ,sCAAgB;IACtC,IAAI,GAAG,MAAM,CAAC;IACJ,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAChD,cAAc,GAAG,cAAc,CAAC;IAEnD,YAAY,GAAW,EAAE,IAAI,GAAG,IAAI;QAClC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnB,CAAC;CACF;AARD,kCAQC"}

package/dist/adapters/NextAdapter.d.ts

@@ -0,0 +1,8 @@
+import { DevServerAdapter } from "./DevServerAdapter.js";
+export declare class NextAdapter extends DevServerAdapter {
+    readonly name = "next";
+    protected readonly startArgs: string[];
+    protected readonly processPattern = "next dev";
+    constructor(cwd: string, port?: number);
+}
+//# sourceMappingURL=NextAdapter.d.ts.map

package/dist/adapters/NextAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/NextAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,QAAQ,CAAC,IAAI,UAAU;IACvB,SAAS,CAAC,QAAQ,CAAC,SAAS,WAA0B;IACtD,SAAS,CAAC,QAAQ,CAAC,cAAc,cAAc;gBAEnC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAO;CAGrC"}

package/dist/adapters/NextAdapter.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextAdapter = void 0;
+const DevServerAdapter_js_1 = require("./DevServerAdapter.js");
+class NextAdapter extends DevServerAdapter_js_1.DevServerAdapter {
+    name = "next";
+    startArgs = ["npx", "next", "dev"];
+    processPattern = "next dev";
+    constructor(cwd, port = 3000) {
+        super(cwd, port);
+    }
+}
+exports.NextAdapter = NextAdapter;
+//# sourceMappingURL=NextAdapter.js.map

package/dist/adapters/NextAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextAdapter.js","sourceRoot":"","sources":["../../src/adapters/NextAdapter.ts"],"names":[],"mappings":";;;AAAA,+DAAyD;AAEzD,MAAa,WAAY,SAAQ,sCAAgB;IACtC,IAAI,GAAG,MAAM,CAAC;IACJ,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACnC,cAAc,GAAG,UAAU,CAAC;IAE/C,YAAY,GAAW,EAAE,IAAI,GAAG,IAAI;QAClC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnB,CAAC;CACF;AARD,kCAQC"}

package/dist/adapters/NullAdapter.d.ts

@@ -0,0 +1,10 @@
+import type { AppAdapter } from "./AppAdapter.js";
+export declare class NullAdapter implements AppAdapter {
+    readonly name = "null";
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    logFile(): string | null;
+}
+//# sourceMappingURL=NullAdapter.d.ts.map

package/dist/adapters/NullAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NullAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/NullAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,qBAAa,WAAY,YAAW,UAAU;IAC5C,QAAQ,CAAC,IAAI,UAAU;IAEjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,OAAO,IAAI,MAAM,GAAG,IAAI;CAGzB"}

package/dist/adapters/NullAdapter.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullAdapter = void 0;
+class NullAdapter {
+    name = "null";
+    async start() { }
+    async stop() { }
+    async kill() { }
+    async isRunning() {
+        return false;
+    }
+    logFile() {
+        return null;
+    }
+}
+exports.NullAdapter = NullAdapter;
+//# sourceMappingURL=NullAdapter.js.map

package/dist/adapters/NullAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NullAdapter.js","sourceRoot":"","sources":["../../src/adapters/NullAdapter.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IACb,IAAI,GAAG,MAAM,CAAC;IAEvB,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,KAAK,CAAC,SAAS;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAhBD,kCAgBC"}

package/dist/adapters/ProcessAdapter.d.ts

@@ -0,0 +1,21 @@
+import type { AppAdapter } from "./AppAdapter.js";
+export interface ProcessAdapterConfig {
+    name: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    readyPattern: RegExp;
+    readyTimeoutMs?: number;
+}
+export declare class ProcessAdapter implements AppAdapter {
+    readonly name: string;
+    private process;
+    private readonly config;
+    constructor(config: ProcessAdapterConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    logFile(): string | null;
+}
+//# sourceMappingURL=ProcessAdapter.d.ts.map

package/dist/adapters/ProcessAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ProcessAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,EAAE,oBAAoB;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBnC,OAAO,IAAI,MAAM,GAAG,IAAI;CAGzB"}