@elhu/pit 0.1.1

package/dist/worktree.js

@@ -0,0 +1,116 @@
+import { execFile as execFileCb } from "node:child_process";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { promisify } from "node:util";
+const execFile = promisify(execFileCb);
+// ---------------------------------------------------------------------------
+// createWorktree
+// ---------------------------------------------------------------------------
+/**
+ * Creates a git worktree for `epic` under `worktreeDir`.
+ *
+ * Idempotent: if the worktree already exists (directory + .git file), returns
+ * `{ created: false }` without running any git commands.
+ *
+ * Branch-exists fallback: if `git worktree add -b <branch>` fails because the
+ * branch already exists, retries with `git worktree add <path> <branch>`
+ * (checkout existing branch, no -b).
+ */
+export async function createWorktree(worktreeDir, epic, baseBranch) {
+    const worktreePath = path.resolve(worktreeDir, epic);
+    const branch = `pit/${epic}`;
+    // Ensure parent directory exists before any git operations
+    await fsp.mkdir(worktreeDir, { recursive: true });
+    // If worktree already exists (idempotent path)
+    if (await worktreeExists(worktreeDir, epic)) {
+        return { path: worktreePath, created: false, branch };
+    }
+    // Try to create a new branch and worktree
+    try {
+        await execFile("git", ["worktree", "add", "-b", branch, worktreePath, baseBranch]);
+    }
+    catch (err) {
+        const message = String(err.stderr ?? err.message ?? "");
+        if (message.includes("already exists")) {
+            // Branch exists — checkout existing branch without -b
+            await execFile("git", ["worktree", "add", worktreePath, branch]);
+        }
+        else if (message.includes("already registered") || message.includes("already checked out")) {
+            // Worktree is already registered but path doesn't exist (stale registration)
+            try {
+                // Try to prune stale worktree registrations
+                await execFile("git", ["worktree", "prune"]);
+                // Retry the original command after pruning
+                await execFile("git", ["worktree", "add", "-b", branch, worktreePath, baseBranch]);
+            }
+            catch (retryErr) {
+                const retryMessage = String(retryErr.stderr ??
+                    retryErr.message ??
+                    "");
+                if (retryMessage.includes("already exists")) {
+                    // Branch exists after prune — checkout existing branch without -b
+                    await execFile("git", ["worktree", "add", worktreePath, branch]);
+                }
+                else {
+                    throw retryErr;
+                }
+            }
+        }
+        else {
+            throw err;
+        }
+    }
+    return { path: worktreePath, created: true, branch };
+}
+// ---------------------------------------------------------------------------
+// worktreeExists
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if `<worktreeDir>/<epic>` exists as a directory AND contains a
+ * `.git` file (worktrees have a .git file, not a .git directory).
+ */
+export async function worktreeExists(worktreeDir, epic) {
+    const worktreePath = path.resolve(worktreeDir, epic);
+    try {
+        const dirStat = await fsp.stat(worktreePath);
+        if (!dirStat.isDirectory()) {
+            return false;
+        }
+        const gitStat = await fsp.stat(path.join(worktreePath, ".git"));
+        // In worktrees, .git is a file not a directory
+        return gitStat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// removeWorktree
+// ---------------------------------------------------------------------------
+/**
+ * Removes the worktree at `<worktreeDir>/<epic>` via `git worktree remove --force`.
+ * Throws on failure.
+ */
+export async function removeWorktree(worktreeDir, epic) {
+    const worktreePath = path.resolve(worktreeDir, epic);
+    await execFile("git", ["worktree", "remove", worktreePath, "--force"]);
+}
+// ---------------------------------------------------------------------------
+// isWorktreeDirty
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the worktree at the given absolute path has uncommitted
+ * changes (staged, unstaged, or untracked files).
+ * Returns false if the path does not exist or is not a git worktree.
+ */
+export async function isWorktreeDirty(worktreePath) {
+    try {
+        const { stdout } = await execFile("git", ["-C", worktreePath, "status", "--porcelain"]);
+        return stdout.trim().length > 0;
+    }
+    catch {
+        // Path doesn't exist, not a git repo, etc. — treat as not dirty
+        return false;
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@elhu/pit",
+  "version": "0.1.1",
+  "description": "A tmux-based orchestrator that automates parallel AI coding agent sessions",
+  "type": "module",
+  "bin": {
+    "pit": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "npm run build:plugin && npm run build:hook && npm run build:assets && tsc -p tsconfig.build.json",
+    "build:plugin": "esbuild src/plugin/pit.ts --bundle --format=esm --platform=node --external:@opencode-ai/plugin --outfile=dist/plugin/pit.js",
+    "build:hook": "esbuild src/hooks/claude-code-hook.ts --bundle --format=esm --platform=node --outfile=dist/hooks/claude-code-hook.js",
+    "build:assets": "node scripts/generate-assets.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "lint": "eslint . && prettier --check .",
+    "lint:fix": "eslint --fix . && prettier --write .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "release": "bash scripts/release.sh",
+    "prepare": "husky"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "tmux",
+    "ai",
+    "orchestrator",
+    "coding-agent",
+    "automation"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=24"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{js,json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@opencode-ai/plugin": "^1.2.10",
+    "@types/node": "^25.3.0",
+    "esbuild": "^0.27.3",
+    "eslint": "^10.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "commander": "^14.0.3"
+  }
+}