@cockpit-ai/worktree 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+interface WorktreeInfo {
+    path: string;
+    branch: string;
+    commit: string;
+    isMain: boolean;
+    assignedAgent?: string;
+}
+interface CreateWorktreeOptions {
+    repo: string;
+    branch: string;
+    path?: string;
+    createBranch?: boolean;
+}
+declare class WorktreeManager {
+    private readonly repoPath;
+    constructor(repoPath: string);
+    /**
+     * Create a new worktree.
+     * git worktree add -b <branch> <path> [base-branch]
+     */
+    create(opts: Omit<CreateWorktreeOptions, "repo">): WorktreeInfo;
+    /**
+     * List all worktrees in the repo.
+     * git worktree list --porcelain
+     */
+    list(): WorktreeInfo[];
+    /**
+     * Remove a worktree by path.
+     * git worktree remove <path> [--force]
+     */
+    remove(worktreePath: string, force?: boolean): void;
+    /**
+     * Prune stale worktree references.
+     * git worktree prune
+     */
+    prune(): void;
+}
+
+interface WorktreeState {
+    worktrees: Record<string, {
+        path: string;
+        branch: string;
+        assignedAgent?: string;
+        createdAt: string;
+    }>;
+}
+declare function readWorktreeState(): WorktreeState;
+declare function writeWorktreeState(state: WorktreeState): void;
+declare function registerWorktree(path: string, branch: string): void;
+declare function unregisterWorktree(path: string): void;
+declare function assignAgent(worktreePath: string, agentName: string): void;
+declare function getWorktreeState(path: string): WorktreeState["worktrees"][string] | undefined;
+
+export { type CreateWorktreeOptions, type WorktreeInfo, WorktreeManager, type WorktreeState, assignAgent, getWorktreeState, readWorktreeState, registerWorktree, unregisterWorktree, writeWorktreeState };

package/dist/index.js

@@ -0,0 +1,140 @@
+// src/manager.ts
+import { execSync } from "child_process";
+import { join, dirname } from "path";
+var WorktreeManager = class {
+  constructor(repoPath) {
+    this.repoPath = repoPath;
+  }
+  /**
+   * Create a new worktree.
+   * git worktree add -b <branch> <path> [base-branch]
+   */
+  create(opts) {
+    const targetPath = opts.path ?? join(dirname(this.repoPath), opts.branch.replace(/\//g, "-"));
+    const flag = opts.createBranch !== false ? "-b" : "";
+    execSync(`git worktree add ${flag} ${opts.branch} ${targetPath}`, {
+      cwd: this.repoPath,
+      stdio: "pipe"
+    });
+    return { path: targetPath, branch: opts.branch, commit: "", isMain: false };
+  }
+  /**
+   * List all worktrees in the repo.
+   * git worktree list --porcelain
+   */
+  list() {
+    const output = execSync("git worktree list --porcelain", {
+      cwd: this.repoPath,
+      stdio: "pipe"
+    }).toString("utf-8");
+    const worktrees = [];
+    const blocks = output.trim().split(/\n\n+/);
+    for (let i = 0; i < blocks.length; i++) {
+      const block = blocks[i];
+      if (!block) continue;
+      const lines = block.split("\n");
+      let path = "";
+      let commit = "";
+      let branch = "";
+      for (const line of lines) {
+        if (line.startsWith("worktree ")) {
+          path = line.slice("worktree ".length).trim();
+        } else if (line.startsWith("HEAD ")) {
+          commit = line.slice("HEAD ".length).trim();
+        } else if (line.startsWith("branch ")) {
+          const ref = line.slice("branch ".length).trim();
+          branch = ref.replace(/^refs\/heads\//, "");
+        }
+      }
+      if (path) {
+        worktrees.push({
+          path,
+          branch,
+          commit,
+          isMain: i === 0
+        });
+      }
+    }
+    return worktrees;
+  }
+  /**
+   * Remove a worktree by path.
+   * git worktree remove <path> [--force]
+   */
+  remove(worktreePath, force) {
+    const forceFlag = force ? " --force" : "";
+    execSync(`git worktree remove ${worktreePath}${forceFlag}`, {
+      cwd: this.repoPath,
+      stdio: "pipe"
+    });
+  }
+  /**
+   * Prune stale worktree references.
+   * git worktree prune
+   */
+  prune() {
+    execSync("git worktree prune", {
+      cwd: this.repoPath,
+      stdio: "pipe"
+    });
+  }
+};
+
+// src/registry.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join as join2, dirname as dirname2 } from "path";
+import { homedir } from "os";
+var STATE_FILE = join2(homedir(), ".cockpit", "worktree-state.json");
+function readWorktreeState() {
+  if (!existsSync(STATE_FILE)) {
+    return { worktrees: {} };
+  }
+  try {
+    const raw = readFileSync(STATE_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return { worktrees: {} };
+  }
+}
+function writeWorktreeState(state) {
+  const dir = dirname2(STATE_FILE);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), "utf-8");
+}
+function registerWorktree(path, branch) {
+  const state = readWorktreeState();
+  state.worktrees[path] = {
+    path,
+    branch,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  writeWorktreeState(state);
+}
+function unregisterWorktree(path) {
+  const state = readWorktreeState();
+  delete state.worktrees[path];
+  writeWorktreeState(state);
+}
+function assignAgent(worktreePath, agentName) {
+  const state = readWorktreeState();
+  const entry = state.worktrees[worktreePath];
+  if (!entry) {
+    throw new Error(`Worktree not registered: ${worktreePath}`);
+  }
+  entry.assignedAgent = agentName;
+  writeWorktreeState(state);
+}
+function getWorktreeState(path) {
+  const state = readWorktreeState();
+  return state.worktrees[path];
+}
+export {
+  WorktreeManager,
+  assignAgent,
+  getWorktreeState,
+  readWorktreeState,
+  registerWorktree,
+  unregisterWorktree,
+  writeWorktreeState
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manager.ts","../src/registry.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { join, dirname } from \"node:path\";\n\n// ─── Types ─────────────────────────────────────────────────────────────────\n\nexport interface WorktreeInfo {\n  path: string;\n  branch: string;\n  commit: string;\n  isMain: boolean;\n  assignedAgent?: string;\n}\n\nexport interface CreateWorktreeOptions {\n  repo: string;        // path to git repo (defaults to cwd)\n  branch: string;      // branch name to create/checkout\n  path?: string;       // where to create the worktree (defaults to ../<branch>)\n  createBranch?: boolean; // -b flag, true by default\n}\n\n// ─── WorktreeManager ───────────────────────────────────────────────────────\n\nexport class WorktreeManager {\n  constructor(private readonly repoPath: string) {}\n\n  /**\n   * Create a new worktree.\n   * git worktree add -b <branch> <path> [base-branch]\n   */\n  create(opts: Omit<CreateWorktreeOptions, \"repo\">): WorktreeInfo {\n    const targetPath =\n      opts.path ?? join(dirname(this.repoPath), opts.branch.replace(/\\//g, \"-\"));\n    const flag = opts.createBranch !== false ? \"-b\" : \"\";\n    execSync(`git worktree add ${flag} ${opts.branch} ${targetPath}`, {\n      cwd: this.repoPath,\n      stdio: \"pipe\",\n    });\n    return { path: targetPath, branch: opts.branch, commit: \"\", isMain: false };\n  }\n\n  /**\n   * List all worktrees in the repo.\n   * git worktree list --porcelain\n   */\n  list(): WorktreeInfo[] {\n    const output = execSync(\"git worktree list --porcelain\", {\n      cwd: this.repoPath,\n      stdio: \"pipe\",\n    }).toString(\"utf-8\");\n\n    const worktrees: WorktreeInfo[] = [];\n    const blocks = output.trim().split(/\\n\\n+/);\n\n    for (let i = 0; i < blocks.length; i++) {\n      const block = blocks[i];\n      if (!block) continue;\n\n      const lines = block.split(\"\\n\");\n      let path = \"\";\n      let commit = \"\";\n      let branch = \"\";\n\n      for (const line of lines) {\n        if (line.startsWith(\"worktree \")) {\n          path = line.slice(\"worktree \".length).trim();\n        } else if (line.startsWith(\"HEAD \")) {\n          commit = line.slice(\"HEAD \".length).trim();\n        } else if (line.startsWith(\"branch \")) {\n          // refs/heads/main -> main\n          const ref = line.slice(\"branch \".length).trim();\n          branch = ref.replace(/^refs\\/heads\\//, \"\");\n        }\n      }\n\n      if (path) {\n        worktrees.push({\n          path,\n          branch,\n          commit,\n          isMain: i === 0,\n        });\n      }\n    }\n\n    return worktrees;\n  }\n\n  /**\n   * Remove a worktree by path.\n   * git worktree remove <path> [--force]\n   */\n  remove(worktreePath: string, force?: boolean): void {\n    const forceFlag = force ? \" --force\" : \"\";\n    execSync(`git worktree remove ${worktreePath}${forceFlag}`, {\n      cwd: this.repoPath,\n      stdio: \"pipe\",\n    });\n  }\n\n  /**\n   * Prune stale worktree references.\n   * git worktree prune\n   */\n  prune(): void {\n    execSync(\"git worktree prune\", {\n      cwd: this.repoPath,\n      stdio: \"pipe\",\n    });\n  }\n}\n","import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { homedir } from \"node:os\";\n\n// ─── Types ─────────────────────────────────────────────────────────────────\n\nexport interface WorktreeState {\n  worktrees: Record<\n    string,\n    { path: string; branch: string; assignedAgent?: string; createdAt: string }\n  >;\n}\n\n// ─── State file path ────────────────────────────────────────────────────────\n\nconst STATE_FILE = join(homedir(), \".cockpit\", \"worktree-state.json\");\n\n// ─── I/O helpers ───────────────────────────────────────────────────────────\n\nexport function readWorktreeState(): WorktreeState {\n  if (!existsSync(STATE_FILE)) {\n    return { worktrees: {} };\n  }\n  try {\n    const raw = readFileSync(STATE_FILE, \"utf-8\");\n    return JSON.parse(raw) as WorktreeState;\n  } catch {\n    return { worktrees: {} };\n  }\n}\n\nexport function writeWorktreeState(state: WorktreeState): void {\n  const dir = dirname(STATE_FILE);\n  mkdirSync(dir, { recursive: true });\n  writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), \"utf-8\");\n}\n\n// ─── Registry operations ────────────────────────────────────────────────────\n\nexport function registerWorktree(path: string, branch: string): void {\n  const state = readWorktreeState();\n  state.worktrees[path] = {\n    path,\n    branch,\n    createdAt: new Date().toISOString(),\n  };\n  writeWorktreeState(state);\n}\n\nexport function unregisterWorktree(path: string): void {\n  const state = readWorktreeState();\n  delete state.worktrees[path];\n  writeWorktreeState(state);\n}\n\nexport function assignAgent(worktreePath: string, agentName: string): void {\n  const state = readWorktreeState();\n  const entry = state.worktrees[worktreePath];\n  if (!entry) {\n    throw new Error(`Worktree not registered: ${worktreePath}`);\n  }\n  entry.assignedAgent = agentName;\n  writeWorktreeState(state);\n}\n\nexport function getWorktreeState(\n  path: string\n): WorktreeState[\"worktrees\"][string] | undefined {\n  const state = readWorktreeState();\n  return state.worktrees[path];\n}\n"],"mappings":"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","names":["join","dirname"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cockpit-ai/worktree",
+  "version": "0.1.0",
+  "description": "Cockpit worktree orchestration",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cockpit-ai/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}