@jdiamond/pi-git 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# pi-git
+
+**Review-gated git/GitHub tools for [pi](https://github.com/mariozechner/pi-coding-agent)**
+
+Every action that publishes content shows a review overlay before executing: approve, edit, or cancel. No accidental commits or PRs.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `git_commit` | Stage files and commit with a review step |
+| (more coming) | |
+
+All tools use a `git_` prefix to avoid conflicts.
+
+## Install
+
+```json
+{
+  "packages": ["npm:@jdiamond/pi-git"]
+}
+```
+
+## Usage
+
+The agent stages files and commits in one call:
+
+```
+git_commit(message: "Fix: resolve race condition in pool shutdown", files: ["src/pool.ts"])
+```
+
+A review overlay shows the commit message and lets you **[a]**pprove, **[e]**dit, or **[c]**ancel before the commit executes.

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@jdiamond/pi-git",
+	"version": "0.1.0",
+	"description": "Review-gated git/GitHub tools for pi. Every action that creates or publishes content shows a review UI before executing.",
+	"keywords": [
+		"pi-package",
+		"git",
+		"github",
+		"review",
+		"commit"
+	],
+	"author": "Jason Diamond <jason@diamond.name>",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/jdiamond/pi-git.git"
+	},
+	"homepage": "https://github.com/jdiamond/pi-git",
+	"bugs": {
+		"url": "https://github.com/jdiamond/pi-git/issues"
+	},
+	"files": [
+		"src",
+		"README.md"
+	],
+	"type": "module",
+	"scripts": {
+		"test": "node --test test/**/*.ts",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check",
+		"lint:fix": "biome check --write",
+		"format": "biome check --write",
+		"format:check": "biome check",
+		"check": "npm run typecheck && npm run lint && npm run format:check",
+		"verify": "npm run check && npm test"
+	},
+	"pi": {
+		"extensions": [
+			"./src/index.ts"
+		]
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"typebox": "*"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.4.16",
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
+		"@types/node": "^25",
+		"typebox": "1.1.39",
+		"typescript": "6.0.3"
+	}
+}

package/src/index.ts

@@ -0,0 +1,170 @@
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+
+function isGitRepo(cwd: string): boolean {
+	const result = spawnSync("git", ["rev-parse", "--git-dir"], {
+		cwd,
+		stdio: "ignore",
+	});
+	return result.status === 0;
+}
+
+function hasStagedChanges(cwd: string): boolean {
+	const result = spawnSync("git", ["diff", "--cached", "--quiet"], {
+		cwd,
+		stdio: "ignore",
+	});
+	return result.status !== 0;
+}
+
+function getStagedFiles(cwd: string): string[] {
+	const result = spawnSync("git", ["diff", "--cached", "--name-only"], {
+		cwd,
+		encoding: "utf-8",
+		stdio: "pipe",
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) {
+		throw new Error(result.stderr.trim() || "git diff --cached failed");
+	}
+	return result.stdout.trim().split("\n").filter(Boolean);
+}
+
+function stageFiles(cwd: string, files: string[]): void {
+	const result = spawnSync("git", ["add", "--", ...files], {
+		cwd,
+		stdio: "pipe",
+		encoding: "utf-8",
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) {
+		throw new Error(result.stderr.trim() || "git add failed");
+	}
+}
+
+function runCommit(cwd: string, message: string): string {
+	const result = spawnSync("git", ["commit", "-m", message], {
+		cwd,
+		encoding: "utf-8",
+		stdio: "pipe",
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) {
+		throw new Error(result.stderr.trim() || "git commit failed");
+	}
+	return result.stdout.trim();
+}
+
+function formatFilesSection(
+	files: string[],
+	label: string,
+): string | undefined {
+	if (!files.length) return undefined;
+	return `${label}:\n  ${files.join("\n  ")}`;
+}
+
+function buildCommitSections(
+	files: string[] | undefined,
+	cwd: string,
+): string[] {
+	const sections: string[] = [];
+
+	if (files?.length) {
+		const existingFiles = getStagedFiles(cwd).filter((f) => !files.includes(f));
+		const es = formatFilesSection(existingFiles, "Already staged");
+		if (es) sections.push(es);
+
+		const s = formatFilesSection(files, "Files to stage");
+		if (s) sections.push(s);
+	}
+
+	return sections;
+}
+
+async function reviewCommit(
+	ctx: ExtensionContext,
+	cwd: string,
+	initialMessage: string,
+	files?: string[],
+): Promise<{ message: string; approved: boolean }> {
+	let message = initialMessage;
+	const sections = buildCommitSections(files, cwd);
+	const header = sections.length
+		? `📝 Git Commit:\n\n${sections.join("\n\n")}\n\n`
+		: `📝 Git Commit:\n\n`;
+
+	for (;;) {
+		const choice = await ctx.ui.select(`${header}${message}`, [
+			"Approve",
+			"Edit",
+			"Cancel",
+		]);
+
+		if (choice === "Approve") return { message, approved: true };
+		if (choice === "Cancel" || choice === undefined) {
+			return { message, approved: false };
+		}
+
+		// edit
+		const edited = await ctx.ui.editor("Edit commit message:", message);
+		if (edited === undefined || edited.trim() === "") {
+			return { message, approved: false };
+		}
+		message = edited;
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.registerTool({
+		name: "git_commit",
+		label: "Git Commit",
+		description:
+			"Create a git commit. Optionally takes a list of files to stage; otherwise commits already-staged changes. Shows a review overlay where the user can approve, edit, or cancel before the commit executes.",
+		parameters: Type.Object({
+			message: Type.String({ description: "The commit message" }),
+			files: Type.Optional(
+				Type.Array(Type.String(), {
+					description:
+						"Files to stage and commit (if omitted, commits already-staged changes)",
+				}),
+			),
+		}),
+		async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+			const cwd = resolve(ctx.cwd);
+
+			if (!isGitRepo(cwd)) {
+				throw new Error("Not inside a git repository.");
+			}
+
+			const files = params.files?.length ? params.files : undefined;
+
+			if (!files && !hasStagedChanges(cwd)) {
+				throw new Error(
+					"Nothing staged for commit. Pass `files` to stage specific files, or stage changes first.",
+				);
+			}
+
+			const result = await reviewCommit(ctx, cwd, params.message, files);
+
+			if (!result.approved) {
+				throw new Error("Commit cancelled by user.");
+			}
+
+			if (files) {
+				stageFiles(cwd, files);
+			}
+
+			const output = runCommit(cwd, result.message);
+
+			return {
+				content: [{ type: "text" as const, text: output || "Commit created." }],
+				details: { message: result.message, output, files },
+			};
+		},
+	});
+}