pi-harness-runtime 0.9.4 → 0.9.6

package/packages/worktree/dist/worktree.js

@@ -0,0 +1,242 @@
+/**
+ * Git Worktree Manager — RFC-0005
+ *
+ * Creates isolated workspaces for parallel or recoverable coding tasks.
+ *
+ * Goals:
+ * - avoid branch conflicts
+ * - preserve partial work
+ * - allow reviewer agent to inspect diffs
+ * - allow separate models to work on separate tasks
+ */
+// @ts-expect-error - Bun has built-in Node.js types
+import { execSync } from "node:child_process";
+// @ts-expect-error - Bun has built-in Node.js types
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+// @ts-expect-error - Bun has built-in Node.js types
+import { join, dirname } from "node:path";
+export class WorktreeManager {
+    rootDir;
+    baseBranch;
+    metaPath;
+    constructor(options) {
+        this.rootDir = options.rootDir;
+        this.baseBranch = options.baseBranch ?? "main";
+        this.metaPath = join(this.rootDir, ".worktrees.json");
+    }
+    /**
+     * Create a new worktree
+     */
+    async create(options) {
+        const name = options.name.replace(/[^a-zA-Z0-9-_]/g, "-");
+        const branch = options.branch ?? `worktree/${name}`;
+        const path = join(this.rootDir, "worktrees", name);
+        // Ensure directory exists
+        mkdirSync(dirname(path), { recursive: true });
+        // Create git worktree
+        const startPoint = options.startPoint ?? this.baseBranch;
+        const worktreePath = this.execGit([
+            "worktree",
+            "add",
+            "-b",
+            branch,
+            path,
+            startPoint,
+        ]);
+        // Record metadata
+        const worktree = {
+            name,
+            path: worktreePath,
+            branch,
+            jobId: options.jobId,
+            taskId: options.taskId,
+            createdAt: new Date().toISOString(),
+            status: "active",
+        };
+        this.saveWorktree(worktree);
+        return worktree;
+    }
+    /**
+     * List all worktrees
+     */
+    async list() {
+        if (!existsSync(this.metaPath)) {
+            return [];
+        }
+        try {
+            const content = readFileSync(this.metaPath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get worktree by name
+     */
+    async get(name) {
+        const worktrees = await this.list();
+        return worktrees.find((w) => w.name === name) ?? null;
+    }
+    /**
+     * Get worktree by job ID
+     */
+    async getByJob(jobId) {
+        const worktrees = await this.list();
+        return worktrees.find((w) => w.jobId === jobId) ?? null;
+    }
+    /**
+     * Remove a worktree
+     */
+    async remove(name, force = false) {
+        const worktree = await this.get(name);
+        if (!worktree) {
+            throw new Error(`Worktree ${name} not found`);
+        }
+        // Remove git worktree
+        this.execGit(["worktree", "remove", worktree.path, force ? "--force" : ""]);
+        // Remove from metadata
+        const worktrees = await this.list();
+        const updated = worktrees.filter((w) => w.name !== name);
+        this.saveAllWorktrees(updated);
+    }
+    /**
+     * Prune stale worktrees
+     */
+    async prune() {
+        const output = this.execGit(["worktree", "list", "--porcelain"]);
+        const lines = output.split("\n");
+        const pruned = [];
+        // Parse git worktree list
+        const worktreePaths = [];
+        for (const line of lines) {
+            if (line.startsWith("worktree ")) {
+                worktreePaths.push(line.replace("worktree ", "").trim());
+            }
+        }
+        // Check our tracked worktrees
+        const tracked = await this.list();
+        for (const worktree of tracked) {
+            if (!worktreePaths.includes(worktree.path)) {
+                // Git worktree no longer exists
+                worktree.status = "abandoned";
+                pruned.push(worktree.name);
+            }
+        }
+        this.saveAllWorktrees(tracked);
+        return pruned;
+    }
+    /**
+     * Get diff between worktree and base
+     */
+    async getDiff(worktreePath) {
+        const output = this.execGit(["diff", "--stat", `main...${worktreePath}`], {
+            cwd: worktreePath,
+        });
+        const diffs = [];
+        const lines = output.split("\n");
+        for (const line of lines) {
+            if (!line.includes("|"))
+                continue;
+            const [file, stats] = line.split("|").map((s) => s.trim());
+            if (!file || !stats)
+                continue;
+            let status = "modified";
+            if (stats.startsWith("+"))
+                status = "added";
+            else if (stats.startsWith("-"))
+                status = "deleted";
+            const match = stats.match(/\+(\d+)/);
+            const insertions = match ? parseInt(match[1], 10) : undefined;
+            const delMatch = stats.match(/-(\d+)/);
+            const deletions = delMatch ? parseInt(delMatch[1], 10) : undefined;
+            diffs.push({ file, status, insertions, deletions });
+        }
+        return diffs;
+    }
+    /**
+     * Get uncommitted changes
+     */
+    async getUncommitted(worktreePath) {
+        const output = this.execGit(["diff", "--numstat"], { cwd: worktreePath });
+        const diffs = [];
+        const lines = output.split("\n");
+        for (const line of lines) {
+            const parts = line.split("\t");
+            if (parts.length < 3)
+                continue;
+            const [ins, del, file] = parts;
+            diffs.push({
+                file,
+                status: "modified",
+                insertions: parseInt(ins, 10) || 0,
+                deletions: parseInt(del, 10) || 0,
+            });
+        }
+        return diffs;
+    }
+    /**
+     * Mark worktree as merged
+     */
+    async markMerged(name) {
+        const worktrees = await this.list();
+        const worktree = worktrees.find((w) => w.name === name);
+        if (worktree) {
+            worktree.status = "merged";
+            this.saveAllWorktrees(worktrees);
+        }
+    }
+    /**
+     * Execute git command
+     */
+    execGit(args, options) {
+        try {
+            const cwd = options?.cwd ?? this.rootDir;
+            return execSync(["git", ...args].join(" "), {
+                cwd,
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+        }
+        catch (error) {
+            const e = error;
+            throw new Error(`Git command failed: ${e.message ?? error}`);
+        }
+    }
+    /**
+     * Save worktree to metadata
+     */
+    saveWorktree(worktree) {
+        const current = this.listSync();
+        const idx = current.findIndex((w) => w.name === worktree.name);
+        if (idx >= 0) {
+            current[idx] = worktree;
+        }
+        else {
+            current.push(worktree);
+        }
+        this.saveAllWorktrees(current);
+    }
+    /**
+     * Save all worktrees
+     */
+    saveAllWorktrees(worktrees) {
+        mkdirSync(dirname(this.metaPath), { recursive: true });
+        writeFileSync(this.metaPath, JSON.stringify(worktrees, null, 2), "utf-8");
+    }
+    /**
+     * List worktrees synchronously
+     */
+    listSync() {
+        if (!existsSync(this.metaPath)) {
+            return [];
+        }
+        try {
+            return JSON.parse(readFileSync(this.metaPath, "utf-8"));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/packages/worktree/dist/worktree.js.map

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

package/packages/worktree/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@pi-harness/worktree",
+  "version": "0.9.6",
+  "description": "pi-harness-runtime — worktree",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "dependencies": {}
+}

package/packages/worktree/src/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Worktree Manager (RFC-0005)
+ *
+ * Git worktree management for parallel development.
+ */
+
+export * from "./worktree.js";

package/packages/worktree/src/worktree.ts

@@ -0,0 +1,293 @@
+/**
+ * Git Worktree Manager — RFC-0005
+ *
+ * Creates isolated workspaces for parallel or recoverable coding tasks.
+ *
+ * Goals:
+ * - avoid branch conflicts
+ * - preserve partial work
+ * - allow reviewer agent to inspect diffs
+ * - allow separate models to work on separate tasks
+ */
+
+import type { WorktreeInfo } from "../../packages/types/src/runtime-types.ts";
+// @ts-expect-error - Bun has built-in Node.js types
+import { execSync } from "node:child_process";
+// @ts-expect-error - Bun has built-in Node.js types
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+// @ts-expect-error - Bun has built-in Node.js types
+import { join, dirname } from "node:path";
+
+export interface WorktreeOptions {
+	rootDir: string;
+	baseBranch?: string;
+}
+
+export interface CreateWorktreeOptions {
+	name: string;
+	branch?: string;
+	jobId?: string;
+	taskId?: string;
+	startPoint?: string;
+}
+
+export interface WorktreeDiff {
+	file: string;
+	status: "added" | "modified" | "deleted" | "renamed";
+	insertions?: number;
+	deletions?: number;
+}
+
+export class WorktreeManager {
+	private readonly rootDir: string;
+	private readonly baseBranch: string;
+	private readonly metaPath: string;
+
+	constructor(options: WorktreeOptions) {
+		this.rootDir = options.rootDir;
+		this.baseBranch = options.baseBranch ?? "main";
+		this.metaPath = join(this.rootDir, ".worktrees.json");
+	}
+
+	/**
+	 * Create a new worktree
+	 */
+	async create(options: CreateWorktreeOptions): Promise<WorktreeInfo> {
+		const name = options.name.replace(/[^a-zA-Z0-9-_]/g, "-");
+		const branch = options.branch ?? `worktree/${name}`;
+		const path = join(this.rootDir, "worktrees", name);
+
+		// Ensure directory exists
+		mkdirSync(dirname(path), { recursive: true });
+
+		// Create git worktree
+		const startPoint = options.startPoint ?? this.baseBranch;
+		const worktreePath = this.execGit([
+			"worktree",
+			"add",
+			"-b",
+			branch,
+			path,
+			startPoint,
+		]);
+
+		// Record metadata
+		const worktree: WorktreeInfo = {
+			name,
+			path: worktreePath,
+			branch,
+			jobId: options.jobId,
+			taskId: options.taskId,
+			createdAt: new Date().toISOString(),
+			status: "active",
+		};
+
+		this.saveWorktree(worktree);
+
+		return worktree;
+	}
+
+	/**
+	 * List all worktrees
+	 */
+	async list(): Promise<WorktreeInfo[]> {
+		if (!existsSync(this.metaPath)) {
+			return [];
+		}
+
+		try {
+			const content = readFileSync(this.metaPath, "utf-8");
+			return JSON.parse(content) as WorktreeInfo[];
+		} catch {
+			return [];
+		}
+	}
+
+	/**
+	 * Get worktree by name
+	 */
+	async get(name: string): Promise<WorktreeInfo | null> {
+		const worktrees = await this.list();
+		return worktrees.find((w) => w.name === name) ?? null;
+	}
+
+	/**
+	 * Get worktree by job ID
+	 */
+	async getByJob(jobId: string): Promise<WorktreeInfo | null> {
+		const worktrees = await this.list();
+		return worktrees.find((w) => w.jobId === jobId) ?? null;
+	}
+
+	/**
+	 * Remove a worktree
+	 */
+	async remove(name: string, force: boolean = false): Promise<void> {
+		const worktree = await this.get(name);
+		if (!worktree) {
+			throw new Error(`Worktree ${name} not found`);
+		}
+
+		// Remove git worktree
+		this.execGit(["worktree", "remove", worktree.path, force ? "--force" : ""]);
+
+		// Remove from metadata
+		const worktrees = await this.list();
+		const updated = worktrees.filter((w) => w.name !== name);
+		this.saveAllWorktrees(updated);
+	}
+
+	/**
+	 * Prune stale worktrees
+	 */
+	async prune(): Promise<string[]> {
+		const output = this.execGit(["worktree", "list", "--porcelain"]);
+		const lines = output.split("\n");
+		const pruned: string[] = [];
+
+		// Parse git worktree list
+		const worktreePaths: string[] = [];
+		for (const line of lines) {
+			if (line.startsWith("worktree ")) {
+				worktreePaths.push(line.replace("worktree ", "").trim());
+			}
+		}
+
+		// Check our tracked worktrees
+		const tracked = await this.list();
+		for (const worktree of tracked) {
+			if (!worktreePaths.includes(worktree.path)) {
+				// Git worktree no longer exists
+				worktree.status = "abandoned";
+				pruned.push(worktree.name);
+			}
+		}
+
+		this.saveAllWorktrees(tracked);
+
+		return pruned;
+	}
+
+	/**
+	 * Get diff between worktree and base
+	 */
+	async getDiff(worktreePath: string): Promise<WorktreeDiff[]> {
+		const output = this.execGit(["diff", "--stat", `main...${worktreePath}`], {
+			cwd: worktreePath,
+		});
+
+		const diffs: WorktreeDiff[] = [];
+		const lines = output.split("\n");
+
+		for (const line of lines) {
+			if (!line.includes("|")) continue;
+
+			const [file, stats] = line.split("|").map((s) => s.trim());
+			if (!file || !stats) continue;
+
+			let status: WorktreeDiff["status"] = "modified";
+			if (stats.startsWith("+")) status = "added";
+			else if (stats.startsWith("-")) status = "deleted";
+
+			const match = stats.match(/\+(\d+)/);
+			const insertions = match ? parseInt(match[1], 10) : undefined;
+
+			const delMatch = stats.match(/-(\d+)/);
+			const deletions = delMatch ? parseInt(delMatch[1], 10) : undefined;
+
+			diffs.push({ file, status, insertions, deletions });
+		}
+
+		return diffs;
+	}
+
+	/**
+	 * Get uncommitted changes
+	 */
+	async getUncommitted(worktreePath: string): Promise<WorktreeDiff[]> {
+		const output = this.execGit(["diff", "--numstat"], { cwd: worktreePath });
+
+		const diffs: WorktreeDiff[] = [];
+		const lines = output.split("\n");
+
+		for (const line of lines) {
+			const parts = line.split("\t");
+			if (parts.length < 3) continue;
+
+			const [ins, del, file] = parts;
+			diffs.push({
+				file,
+				status: "modified",
+				insertions: parseInt(ins, 10) || 0,
+				deletions: parseInt(del, 10) || 0,
+			});
+		}
+
+		return diffs;
+	}
+
+	/**
+	 * Mark worktree as merged
+	 */
+	async markMerged(name: string): Promise<void> {
+		const worktrees = await this.list();
+		const worktree = worktrees.find((w) => w.name === name);
+		if (worktree) {
+			worktree.status = "merged";
+			this.saveAllWorktrees(worktrees);
+		}
+	}
+
+	/**
+	 * Execute git command
+	 */
+	private execGit(args: string[], options?: { cwd?: string }): string {
+		try {
+			const cwd = options?.cwd ?? this.rootDir;
+			return execSync(["git", ...args].join(" "), {
+				cwd,
+				encoding: "utf-8",
+				stdio: ["pipe", "pipe", "pipe"],
+			}).trim();
+		} catch (error) {
+			const e = error as { message?: string };
+			throw new Error(`Git command failed: ${e.message ?? error}`);
+		}
+	}
+
+	/**
+	 * Save worktree to metadata
+	 */
+	private saveWorktree(worktree: WorktreeInfo): void {
+		const current = this.listSync();
+		const idx = current.findIndex((w) => w.name === worktree.name);
+		if (idx >= 0) {
+			current[idx] = worktree;
+		} else {
+			current.push(worktree);
+		}
+		this.saveAllWorktrees(current);
+	}
+
+	/**
+	 * Save all worktrees
+	 */
+	private saveAllWorktrees(worktrees: WorktreeInfo[]): void {
+		mkdirSync(dirname(this.metaPath), { recursive: true });
+		writeFileSync(this.metaPath, JSON.stringify(worktrees, null, 2), "utf-8");
+	}
+
+	/**
+	 * List worktrees synchronously
+	 */
+	private listSync(): WorktreeInfo[] {
+		if (!existsSync(this.metaPath)) {
+			return [];
+		}
+		try {
+			return JSON.parse(readFileSync(this.metaPath, "utf-8")) as WorktreeInfo[];
+		} catch {
+			return [];
+		}
+	}
+}