@diegopetrucci/pi-extensions 0.1.42 → 0.1.44

package/README.md

@@ -1,8 +1,10 @@
 # pi-extensions
 
-A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions I made.
+A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions and skills I made.
 
 - [`agent-workflow-audit`](./extensions/agent-workflow-audit): Adds `/agent-workflow-audit`, which runs an isolated repo workflow audit subagent and returns only the final distilled report to the main session.
+- [`annotate-git-diff`](./extensions/annotate-git-diff): Adds `/annotate-git-diff`, a native Glimpse UI for annotating git diffs and appending structured feedback prompts to the editor.
+- [`annotate-last-message`](./extensions/annotate-last-message): Adds `/annotate-last-message`, a native Glimpse UI for annotating the latest assistant reply and sending planning-oriented feedback back through the editor.
 - [`brrr`](./extensions/brrr): Sends brrr push notifications when pi finishes an agent turn and is ready for input, with optional macOS idle gating.
 - [`claude-fast`](./extensions/claude-fast): Adds `/claude-fast` to enable Anthropic Claude Fast mode for supported Claude Opus models by injecting `speed: "fast"`.
 - [`confirm-destructive`](./extensions/confirm-destructive): Confirms before destructive session actions like clear, switch, and fork.
@@ -12,6 +14,7 @@ A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions
 - [`git-footer`](./extensions/git-footer): Standalone extension that adds TLH-style git dirty counts, ahead/behind, and optional PR number to pi's built-in footer status area.
 - [`gnosis`](./extensions/gnosis): Exposes the `gn` repo-local knowledge base CLI as an agent tool for searching and recording durable project decisions, constraints, and intent.
 - [`inline-bash`](./extensions/inline-bash): Expands `!{command}` snippets in user prompts by running them through bash before the prompt reaches the agent.
+- [`illustrations-to-explain-things`](./extensions/illustrations-to-explain-things): Adds a skill for generating clean, absurd Xiaohei-style article illustrations, shot lists, image edits, and visual metaphors.
 - [`librarian`](./extensions/librarian): Adds a GitHub research scout with a local repo checkout cache disabled by default under the OS user cache directory, toggleable with `/librarian-cache`, configurable subagent model/thinking defaults via `/librarian-config`, and cached repos expiring after 7 days of non-use.
 - [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch/repo on the first line, context/model on the second, optional `DUMB ZONE`, plus OpenAI Codex 5-hour and 7-day usage when available.
 - [`notify`](./extensions/notify): Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.

package/extensions/annotate-git-diff/.pi-fleet-tested-version

@@ -0,0 +1 @@
+0.78.0

package/extensions/annotate-git-diff/README.md

@@ -0,0 +1,43 @@
+# annotate-git-diff
+
+A standalone pi extension that adds `/annotate-git-diff`, a native Glimpse window for reviewing git changes and sending structured feedback back to the current editor buffer.
+
+## Attribution
+
+This extension was ported from the first-party The Last Harness implementation. It adapts the MIT-licensed `@ryan_nookpi/pi-extension-diff-review` implementation from the `Jonghakseo/pi-extension` monorepo and preserves its original inspiration credit to [badlogic/pi-diff-review](https://github.com/badlogic/pi-diff-review).
+
+## Install
+
+```bash
+pi install npm:@diegopetrucci/pi-annotate-git-diff
+```
+
+Then reload pi:
+
+```text
+/reload
+```
+
+## Usage
+
+Run `/annotate-git-diff` inside a git repository. The command opens a native review window with:
+
+- Monaco-based diff viewing,
+- branch diff, per-commit including working tree, and all-files scopes,
+- inline, file-level, and overall review comments,
+- submit-to-editor feedback prompt insertion.
+
+Submitting feedback does not auto-apply code changes. The extension appends a structured prompt to the current editor buffer so you can send that feedback back to the active agent.
+
+## Requirements
+
+- Run inside a git repository.
+- Local desktop support for opening a native [Glimpse](https://github.com/mariozechner/glimpse) window.
+- Packaged Monaco and Tailwind assets from this npm package.
+- POSIX shell utilities (`bash`, `mktemp`, `base64`, and `tr`) for some git snapshot/binary-file paths.
+
+## Troubleshooting
+
+- `Review failed: Not inside a git repository.` → change into a git repo and rerun `/annotate-git-diff`.
+- `No reviewable files found.` → make or fetch reviewable changes, then rerun.
+- `Review failed: Glimpse host not found ...` → the native window runtime is unavailable; reinstall/update the package and rerun from a machine/session that can open native windows.

package/extensions/annotate-git-diff/clipboard.ts

@@ -0,0 +1,143 @@
+import { spawnSync } from "node:child_process";
+
+const MAX_CLIPBOARD_BYTES = 16 * 1024 * 1024;
+
+type ClipboardPlatform = NodeJS.Platform;
+
+interface ClipboardCommand {
+	command: string;
+	args: string[];
+}
+
+export interface ClipboardCommandResult {
+	status: number | null;
+	signal?: NodeJS.Signals | null;
+	stdout?: string | Buffer;
+	stderr?: string | Buffer;
+	error?: Error;
+}
+
+export type ClipboardCommandRunner = (
+	command: string,
+	args: string[],
+	options: { encoding: "utf8"; maxBuffer: number; input?: string },
+) => ClipboardCommandResult;
+
+interface ClipboardOptions {
+	platform?: ClipboardPlatform;
+	runner?: ClipboardCommandRunner;
+}
+
+const defaultRunner: ClipboardCommandRunner = (command, args, options) => spawnSync(command, args, options);
+
+function clipboardReadCommands(platform: ClipboardPlatform): ClipboardCommand[] {
+	switch (platform) {
+		case "darwin":
+			return [{ command: "pbpaste", args: [] }];
+		case "win32":
+			return [
+				{
+					command: "powershell.exe",
+					args: [
+						"-NoProfile",
+						"-NonInteractive",
+						"-Command",
+						"[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; Get-Clipboard -Raw",
+					],
+				},
+			];
+		case "linux":
+			return [
+				{ command: "wl-paste", args: ["--type", "text/plain"] },
+				{ command: "xclip", args: ["-selection", "clipboard", "-out"] },
+				{ command: "xsel", args: ["--clipboard", "--output"] },
+			];
+		default:
+			return [];
+	}
+}
+
+function clipboardWriteCommands(platform: ClipboardPlatform): ClipboardCommand[] {
+	switch (platform) {
+		case "darwin":
+			return [{ command: "pbcopy", args: [] }];
+		case "win32":
+			return [
+				{
+					command: "powershell.exe",
+					args: [
+						"-NoProfile",
+						"-NonInteractive",
+						"-Command",
+						"[Console]::InputEncoding = [System.Text.Encoding]::UTF8; $text = [Console]::In.ReadToEnd(); Set-Clipboard -Value $text",
+					],
+				},
+			];
+		case "linux":
+			return [
+				{ command: "wl-copy", args: ["--type", "text/plain"] },
+				{ command: "xclip", args: ["-selection", "clipboard", "-in"] },
+				{ command: "xsel", args: ["--clipboard", "--input"] },
+			];
+		default:
+			return [];
+	}
+}
+
+function commandLabel(command: ClipboardCommand): string {
+	return [command.command, ...command.args].join(" ");
+}
+
+function outputToString(value: string | Buffer | undefined): string {
+	if (value == null) return "";
+	return typeof value === "string" ? value : value.toString("utf8");
+}
+
+function runClipboardCommand(command: ClipboardCommand, runner: ClipboardCommandRunner, input?: string): string {
+	const result = runner(command.command, command.args, {
+		encoding: "utf8",
+		maxBuffer: MAX_CLIPBOARD_BYTES,
+		...(input == null ? {} : { input }),
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) {
+		const stderr = outputToString(result.stderr).trim();
+		const status = result.status == null ? result.signal || "unknown" : result.status;
+		throw new Error(`${commandLabel(command)} exited with ${status}${stderr ? `: ${stderr}` : ""}`);
+	}
+	return outputToString(result.stdout);
+}
+
+function runFirstAvailable(commands: ClipboardCommand[], runner: ClipboardCommandRunner, input?: string): string {
+	if (commands.length === 0) {
+		throw new Error(`System clipboard is unsupported on ${process.platform}.`);
+	}
+
+	const errors: string[] = [];
+	for (const command of commands) {
+		try {
+			return runClipboardCommand(command, runner, input);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			errors.push(`${commandLabel(command)}: ${message}`);
+		}
+	}
+	throw new Error(`No system clipboard command succeeded. ${errors.join("; ")}`);
+}
+
+export function readSystemClipboard(options: ClipboardOptions = {}): string {
+	const platform = options.platform ?? process.platform;
+	const runner = options.runner ?? defaultRunner;
+	return runFirstAvailable(clipboardReadCommands(platform), runner);
+}
+
+export function writeSystemClipboard(text: string, options: ClipboardOptions = {}): void {
+	const platform = options.platform ?? process.platform;
+	const runner = options.runner ?? defaultRunner;
+	runFirstAvailable(clipboardWriteCommands(platform), runner, text);
+}
+
+export const __testing = {
+	clipboardReadCommands,
+	clipboardWriteCommands,
+};