pi-harness-runtime 0.10.12 → 0.10.13

package/packages/worktree/dist/worktree.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 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 "../../types/src/runtime-types.js";
+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 declare class WorktreeManager {
+    private readonly rootDir;
+    private readonly baseBranch;
+    private readonly metaPath;
+    constructor(options: WorktreeOptions);
+    /**
+     * Create a new worktree
+     */
+    create(options: CreateWorktreeOptions): Promise<WorktreeInfo>;
+    /**
+     * List all worktrees
+     */
+    list(): Promise<WorktreeInfo[]>;
+    /**
+     * Get worktree by name
+     */
+    get(name: string): Promise<WorktreeInfo | null>;
+    /**
+     * Get worktree by job ID
+     */
+    getByJob(jobId: string): Promise<WorktreeInfo | null>;
+    /**
+     * Remove a worktree
+     */
+    remove(name: string, force?: boolean): Promise<void>;
+    /**
+     * Prune stale worktrees
+     */
+    prune(): Promise<string[]>;
+    /**
+     * Get diff between worktree and base
+     */
+    getDiff(worktreePath: string): Promise<WorktreeDiff[]>;
+    /**
+     * Get uncommitted changes
+     */
+    getUncommitted(worktreePath: string): Promise<WorktreeDiff[]>;
+    /**
+     * Mark worktree as merged
+     */
+    markMerged(name: string): Promise<void>;
+    /**
+     * Execute git command
+     */
+    private execGit;
+    /**
+     * Save worktree to metadata
+     */
+    private saveWorktree;
+    /**
+     * Save all worktrees
+     */
+    private saveAllWorktrees;
+    /**
+     * List worktrees synchronously
+     */
+    private listSync;
+}
+//# sourceMappingURL=worktree.d.ts.map

package/packages/worktree/dist/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,YAAY,OAAO,EAAE,eAAe,EAInC;IAED;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiClE;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAWpC;IAED;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAGpD;IAED;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAG1D;IAED;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B/B;IAED;;OAEG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B3D;IAED;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoBlE;IAED;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5C;IAED;;OAEG;IACH,OAAO,CAAC,OAAO;IAcf;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAUhB"}

package/packages/worktree/dist/worktree.js

@@ -0,0 +1,239 @@
+/**
+ * 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 { execSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+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/scripts/check-version-sync.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env bun
+/**
+ * Check that all version files match the latest git tag.
+ * Usage: bun scripts/check-version-sync.ts
+ *
+ * Exits 0 if all versions match, exits 1 if mismatch.
+ */
+
+import { execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { resolve } from "path";
+
+const repoRoot = resolve(import.meta.dir, "..");
+
+function git(args: string[]): string {
+	try {
+		return execSync(`git ${args.join(" ")}`, {
+			cwd: repoRoot,
+			encoding: "utf-8",
+			stdio: ["pipe", "pipe", "pipe"],
+		}).trim();
+	} catch (e) {
+		const err = e as { status?: number };
+		if (err.status === 128) return ""; // no tags
+		throw e;
+	}
+}
+
+interface PackageJson {
+	version: string;
+	workspaces?: string[];
+}
+
+function readJson(path: string): PackageJson | null {
+	try {
+		return JSON.parse(readFileSync(resolve(repoRoot, path), "utf-8"));
+	} catch {
+		return null;
+	}
+}
+
+// Get latest git tag
+const tags = git(["tag", "--sort=-v:refname"]);
+const latestTag = tags.split("\n")[0] || "";
+const latestVersion = latestTag.startsWith("v")
+	? latestTag.slice(1)
+	: latestTag;
+
+console.log(`Git tag (latest): ${latestVersion}`);
+
+// Check root package.json
+const rootPkg = readJson("package.json");
+if (!rootPkg) {
+	console.error("Cannot read package.json");
+	process.exit(1);
+}
+console.log(`package.json     : ${rootPkg.version}`);
+
+// Check all workspace packages
+let hasMismatch = rootPkg.version !== latestVersion;
+
+const workspaces = rootPkg.workspaces ?? [];
+for (const ws of workspaces) {
+	const pkgPath = ws.replace(/\/\*$/, "/package.json");
+	const pkg = readJson(pkgPath);
+	if (pkg && pkg.version !== latestVersion) {
+		console.log(`${pkgPath} : ${pkg.version} ❌`);
+		hasMismatch = true;
+	}
+}
+
+// Result
+if (hasMismatch) {
+	console.log("\n❌ Version files do not match latest git tag.");
+	console.log(`\nTo fix: bun run release:patch\n`);
+	process.exit(1);
+} else {
+	console.log("\n✅ All versions match git tag");
+	process.exit(0);
+}

package/scripts/convert-skills-to-okf.ts

@@ -0,0 +1,168 @@
+#!/usr/bin/env bun
+/**
+ * Skills to OKF Converter
+ *
+ * Converts frappe-bench skills to OKF format for pi-harness-runtime
+ * - Sanitizes sensitive info (IPs, URLs, API keys)
+ * - Converts to OKF markdown format
+ * - Preserves procedures and best practices
+ */
+
+import { readdir, readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+
+const SOURCE_DIR =
+	"/home/frappe/frappe-bench/.claude-plugins/moocoding-skills/skills";
+const OUTPUT_DIR = "./OKF/skills";
+
+// Sensitive patterns to sanitize
+const SANITIZE_PATTERNS: [RegExp, string][] = [
+	// IP addresses
+	[/(\b\d{1,3}\.){3}\d{1,3}\b/g, "{IP}"],
+	// Specific domains (high priority - before generic)
+	[/grist\.bunchee\.online/gi, "{GRIST_DOMAIN}"],
+	[
+		/(https?:\/\/)?[\w.-]+\.(bunchee\.online|hetzner\.com|digitalocean\.com)/gi,
+		"{DOMAIN}",
+	],
+	// API keys (generic pattern - 32+ chars)
+	[/(?<![a-zA-Z0-9])[a-zA-Z0-9]{32,}(?![a-zA-Z0-9])/g, "{API_KEY}"],
+	// Bearer tokens
+	[/Bearer [a-zA-Z0-9._-]+/g, "Bearer {TOKEN}"],
+	// NPM tokens
+	[/npm_[a-zA-Z0-9]{36}/gi, "npm_{TOKEN}"],
+	// Frappe sites
+	[/frappe-bench\/sites\/[\w.-]+/g, "frappe-bench/sites/{SITE}"],
+	// Server paths
+	[/\/home\/frappe\/[\w-]+/g, "/home/{USER}"],
+];
+
+interface SkillMetadata {
+	name: string;
+	description: string;
+	scope?: string;
+}
+
+function sanitize(text: string): string {
+	let result = text;
+	for (const [pattern, replacement] of SANITIZE_PATTERNS) {
+		result = result.replace(pattern, replacement);
+	}
+	return result;
+}
+
+function parseSkillMetadata(content: string): SkillMetadata | null {
+	const nameMatch = content.match(/^name:\s*(.+)$/m);
+	const descMatch = content.match(/^description:\s*(.+)$/m);
+	const scopeMatch = content.match(/^scope:\s*(.+)$/m);
+
+	if (!nameMatch || !descMatch) return null;
+
+	return {
+		name: sanitize(nameMatch[1].trim()),
+		description: sanitize(descMatch[1].trim()),
+		scope: scopeMatch?.[1]?.trim(),
+	};
+}
+
+function convertToOKF(skillPath: string, content: string): string {
+	const metadata = parseSkillMetadata(content);
+	if (!metadata) return "";
+
+	const sanitized = sanitize(content);
+
+	// Convert YAML frontmatter to OKF header
+	let okf = `# ${metadata.name}\n\n`;
+	okf += `## Overview\n\n`;
+	okf += `${metadata.description}\n\n`;
+
+	// Extract key sections
+	const sections = extractSections(sanitized);
+
+	for (const [title, body] of Object.entries(sections)) {
+		okf += `## ${title}\n\n`;
+		okf += body.trim() + "\n\n";
+	}
+
+	// Add provenance
+	okf += `---\n\n`;
+	okf += `**Source:** ${skillPath}\n`;
+	okf += `**Scope:** ${metadata.scope || "global"}\n`;
+	okf += `**Converted:** ${new Date().toISOString().split("T")[0]}\n`;
+
+	return okf;
+}
+
+function extractSections(content: string): Record<string, string> {
+	const sections: Record<string, string> = {};
+	const lines = content.split("\n");
+	let currentSection = "Details";
+	let currentBody: string[] = [];
+
+	for (const line of lines) {
+		const h2Match = line.match(/^## (.+)$/);
+		const h3Match = line.match(/^### (.+)$/);
+
+		if (h2Match) {
+			if (currentBody.length > 0) {
+				sections[currentSection] = currentBody.join("\n");
+			}
+			currentSection = h2Match[1];
+			currentBody = [];
+		} else if (h3Match) {
+			currentBody.push(`### ${h3Match[1]}`);
+		} else if (
+			!line.startsWith("---") &&
+			!line.match(/^name:|^description:|^scope:/)
+		) {
+			currentBody.push(line);
+		}
+	}
+
+	if (currentBody.length > 0) {
+		sections[currentSection] = currentBody.join("\n");
+	}
+
+	return sections;
+}
+
+async function convertSkills(): Promise<void> {
+	if (!existsSync(OUTPUT_DIR)) {
+		await mkdir(OUTPUT_DIR, { recursive: true });
+	}
+
+	const skillDirs = await readdir(SOURCE_DIR);
+	let converted = 0;
+	let skipped = 0;
+
+	for (const dir of skillDirs) {
+		const skillFile = `${SOURCE_DIR}/${dir}/SKILL.md`;
+
+		if (!existsSync(skillFile)) {
+			skipped++;
+			continue;
+		}
+
+		try {
+			const content = await readFile(skillFile, "utf-8");
+			const okfContent = convertToOKF(skillFile, content);
+
+			if (okfContent) {
+				const outputPath = `${OUTPUT_DIR}/${dir}.md`;
+				await writeFile(outputPath, okfContent);
+				console.log(`✅ Converted: ${dir}`);
+				converted++;
+			} else {
+				console.log(`⚠️ Skipped (no metadata): ${dir}`);
+				skipped++;
+			}
+		} catch (err) {
+			console.error(`❌ Error converting ${dir}:`, err);
+			skipped++;
+		}
+	}
+
+	console.log(`\n📊 Results: ${converted} converted, ${skipped} skipped`);
+}
+
+convertSkills();

package/scripts/gist-auth.ts

@@ -0,0 +1,64 @@
+/**
+ * Gist Auth Setup
+ *
+ * Usage:
+ *   bun run gist-auth
+ *
+ * Prompts for GitHub PAT and creates a secret Gist for clipboard sync.
+ */
+
+import { readline } from "bun";
+import {
+	createGist,
+	isConfigured,
+} from "../packages/clipboard/src/gist-relay.ts";
+
+async function main() {
+	console.log("\n=== pi-harness-runtime Gist Clipboard Sync Setup ===\n");
+
+	if (isConfigured()) {
+		console.log("Gist clipboard sync is already configured.");
+		console.log("Run with --reset to reconfigure.\n");
+		const rl = new readline.Interface({ input: stdin, output: stdout });
+		const answer = await rl.question("Reset configuration? (y/N): ");
+		rl.close();
+		if (answer.toLowerCase() !== "y") {
+			console.log("Aborted.\n");
+			return;
+		}
+	}
+
+	console.log("To enable clipboard sync to GitHub Gist:\n");
+	console.log("1. Go to https://github.com/settings/tokens");
+	console.log("2. Click 'Generate new token (classic)'");
+	console.log("3. Select scopes: 'gist' (read and write gists)");
+	console.log("4. Copy the token\n");
+
+	const rl = new readline.Interface({ input: stdin, output: stdout });
+	const token = await rl.question("GitHub Personal Access Token: ");
+	rl.close();
+
+	if (!token.trim()) {
+		console.log("No token provided. Aborted.\n");
+		return;
+	}
+
+	console.log("\nCreating secret Gist...\n");
+
+	const testContent = `pi-harness-runtime clipboard sync active
+Timestamp: ${new Date().toISOString()}
+`;
+
+	const result = await createGist(token.trim(), testContent);
+
+	if (result) {
+		console.log("✅ Gist clipboard sync configured!");
+		console.log(`   Gist URL: ${result.gistUrl}`);
+		console.log("\nClient devices can poll this Gist for clipboard content.");
+		console.log("See scripts/gist-poll.sh for client setup.\n");
+	} else {
+		console.log("❌ Failed to create Gist. Check your token and try again.\n");
+	}
+}
+
+main().catch(console.error);