xtrm-cli 0.5.0 → 0.5.27

package/extensions/beads.ts

@@ -1,109 +0,0 @@
-import type { ExtensionAPI, ToolCallEvent, ToolResultEvent } from "@mariozechner/pi-coding-agent";
-import { isToolCallEventType, isBashToolResult } from "@mariozechner/pi-coding-agent";
-import * as path from "node:path";
-import * as fs from "node:fs";
-import { SubprocessRunner, EventAdapter, Logger } from "./core/lib";
-
-const logger = new Logger({ namespace: "beads" });
-
-export default function (pi: ExtensionAPI) {
-	const getCwd = (ctx: any) => ctx.cwd || process.cwd();
-	const isBeadsProject = (cwd: string) => fs.existsSync(path.join(cwd, ".beads"));
-	let cachedSessionId: string | null = null;
-
-	// Resolve a stable session ID across event types.
-	const getSessionId = (ctx: any): string => {
-		const fromManager = ctx?.sessionManager?.getSessionId?.();
-		const fromContext = ctx?.sessionId ?? ctx?.session_id;
-		const resolved = fromManager || fromContext || cachedSessionId || process.pid.toString();
-		if (resolved && !cachedSessionId) cachedSessionId = resolved;
-		return resolved;
-	};
-
-	const getSessionClaim = async (sessionId: string, cwd: string): Promise<string | null> => {
-		const result = await SubprocessRunner.run("bd", ["kv", "get", `claimed:${sessionId}`], { cwd });
-		if (result.code === 0) return result.stdout.trim();
-		return null;
-	};
-
-	const hasTrackableWork = async (cwd: string): Promise<boolean> => {
-		const result = await SubprocessRunner.run("bd", ["list"], { cwd });
-		if (result.code === 0 && result.stdout.includes("Total:")) {
-			const m = result.stdout.match(/Total:\s*\d+\s+issues?\s*\((\d+)\s+open,\s*(\d+)\s+in progress\)/);
-			if (m) {
-				const open = parseInt(m[1], 10);
-				const inProgress = parseInt(m[2], 10);
-				return (open + inProgress) > 0;
-			}
-		}
-		return false;
-	};
-
-	pi.on("session_start", async (_event, ctx) => {
-		cachedSessionId = ctx?.sessionManager?.getSessionId?.() ?? ctx?.sessionId ?? ctx?.session_id ?? cachedSessionId;
-		return undefined;
-	});
-
-	pi.on("tool_call", async (event, ctx) => {
-		const cwd = getCwd(ctx);
-		if (!isBeadsProject(cwd)) return undefined;
-
-		const sessionId = getSessionId(ctx);
-
-		if (EventAdapter.isMutatingFileTool(event)) {
-			const claim = await getSessionClaim(sessionId, cwd);
-			if (!claim) {
-			    const hasWork = await hasTrackableWork(cwd);
-			    if (hasWork) {
-			        if (ctx.hasUI) {
-				        ctx.ui.notify("Beads: Edit blocked. Claim an issue first.", "warning");
-			        }
-			        return {
-                        block: true,
-                        reason: `No active issue claim for this session (${sessionId}).\n  bd update <id> --claim`,
-                    };
-                }
-            }
-		}
-
-		if (isToolCallEventType("bash", event)) {
-			const command = event.input.command;
-			if (command && /\bgit\s+commit\b/.test(command)) {
-                const claim = await getSessionClaim(sessionId, cwd);
-				if (claim) {
-					return {
-                        block: true,
-                        reason: `Resolve open claim [${claim}] before committing.`,
-                    };
-				}
-			}
-		}
-
-		return undefined;
-	});
-
-	pi.on("tool_result", async (event, ctx) => {
-		if (isBashToolResult(event)) {
-			const command = event.input.command;
-			const sessionId = getSessionId(ctx);
-
-			if (command && /\bbd\s+update\b/.test(command) && /--claim\b/.test(command)) {
-				const issueMatch = command.match(/\bbd\s+update\s+(\S+)/);
-				if (issueMatch) {
-					const issueId = issueMatch[1];
-					const cwd = getCwd(ctx);
-					await SubprocessRunner.run("bd", ["kv", "set", `claimed:${sessionId}`, issueId], { cwd });
-					const claimNotice = `\n\n✅ **Beads**: Session \`${sessionId}\` claimed issue \`${issueId}\`. File edits are now unblocked.`;
-					return { content: [...event.content, { type: "text", text: claimNotice }] };
-				}
-			}
-
-			if (command && /\bbd\s+close\b/.test(command) && !event.isError) {
-				const reminder = "\n\n**Beads Insight**: Work completed. Consider if this session produced insights worth persisting via `bd remember`.";
-				const newContent = [...event.content, { type: "text", text: reminder }];
-				return { content: newContent };
-			}
-		}
-		return undefined;
-	});
-}

package/extensions/core/adapter.ts

@@ -1,45 +0,0 @@
-import type { ExtensionAPI, ToolCallEvent } from "@mariozechner/pi-coding-agent";
-
-export class EventAdapter {
-	/**
-	 * Checks if the tool event is a mutating file operation (write, edit, etc).
-	 */
-	static isMutatingFileTool(event: ToolCallEvent<any, any>): boolean {
-		const tools = [
-			"write",
-			"edit",
-			"replace_content",
-			"replace_lines",
-			"delete_lines",
-			"insert_at_line",
-			"create_text_file",
-			"rename_symbol",
-			"replace_symbol_body",
-			"insert_after_symbol",
-			"insert_before_symbol",
-		];
-		return tools.includes(event.toolName);
-	}
-
-	/**
-	 * Extracts the target path from a tool input, resolving against the current working directory.
-	 */
-	static extractPathFromToolInput(event: ToolCallEvent<any, any>, cwd: string): string | null {
-		const input = event.input;
-		if (!input) return null;
-
-		const pathRaw = input.path || input.file || input.filePath;
-		if (typeof pathRaw === "string") {
-			return pathRaw; // Usually Pi passes absolute paths anyway or paths relative to root
-		}
-
-		return null;
-	}
-
-	/**
-	 * Safely formats a block reason string to ensure UI readiness.
-	 */
-	static formatBlockReason(prefix: string, details: string): string {
-		return `${prefix}: ${details}`;
-	}
-}

package/extensions/core/lib.ts

@@ -1,3 +0,0 @@
-export * from "./logger";
-export * from "./runner";
-export * from "./adapter";

package/extensions/core/logger.ts

@@ -1,45 +0,0 @@
-export type LogLevel = "debug" | "info" | "warn" | "error";
-
-export interface LoggerOptions {
-	namespace: string;
-	level?: LogLevel;
-}
-
-export class Logger {
-	private namespace: string;
-	private level: LogLevel;
-
-	constructor(options: LoggerOptions) {
-		this.namespace = options.namespace;
-		this.level = options.level || "info";
-	}
-
-	private shouldLog(level: LogLevel): boolean {
-		const levels: LogLevel[] = ["debug", "info", "warn", "error"];
-		return levels.indexOf(level) >= levels.indexOf(this.level);
-	}
-
-	debug(message: string, ...args: any[]) {
-		if (this.shouldLog("debug")) {
-			console.debug(`[${this.namespace}] DEBUG: ${message}`, ...args);
-		}
-	}
-
-	info(message: string, ...args: any[]) {
-		if (this.shouldLog("info")) {
-			console.info(`[${this.namespace}] INFO: ${message}`, ...args);
-		}
-	}
-
-	warn(message: string, ...args: any[]) {
-		if (this.shouldLog("warn")) {
-			console.warn(`[${this.namespace}] WARN: ${message}`, ...args);
-		}
-	}
-
-	error(message: string, ...args: any[]) {
-		if (this.shouldLog("error")) {
-			console.error(`[${this.namespace}] ERROR: ${message}`, ...args);
-		}
-	}
-}

package/extensions/core/runner.ts

@@ -1,71 +0,0 @@
-import { execFile, spawnSync } from "node:child_process";
-import { promisify } from "node:util";
-
-const execFileAsync = promisify(execFile);
-
-export interface RunOptions {
-	timeoutMs?: number;
-	cwd?: string;
-	env?: Record<string, string>;
-	input?: string; // Standard input
-}
-
-export interface RunResult {
-	code: number;
-	stdout: string;
-	stderr: string;
-}
-
-export class SubprocessRunner {
-	/**
-	 * Run a command deterministically with a timeout and optional stdin.
-	 */
-	static async run(
-		command: string,
-		args: string[],
-		options: RunOptions = {}
-	): Promise<RunResult> {
-		const timeout = options.timeoutMs ?? 10000;
-		const cwd = options.cwd ?? process.cwd();
-		const env = { ...process.env, ...options.env };
-
-		if (options.input !== undefined) {
-			// Use spawnSync for stdin support if input is provided
-			const result = spawnSync(command, args, {
-				cwd,
-				env,
-				input: options.input,
-				encoding: "utf8",
-				timeout,
-				maxBuffer: 1024 * 1024 * 10,
-			});
-
-			return {
-				code: result.status ?? 1,
-				stdout: (result.stdout ?? "").trim(),
-				stderr: (result.stderr ?? "").trim(),
-			};
-		}
-
-		try {
-			const result = await execFileAsync(command, args, {
-				timeout,
-				cwd,
-				env,
-				maxBuffer: 1024 * 1024 * 10,
-			});
-
-			return {
-				code: 0,
-				stdout: result.stdout.trim(),
-				stderr: result.stderr.trim(),
-			};
-		} catch (error: any) {
-			return {
-				code: error.code ?? 1,
-				stdout: (error.stdout ?? "").trim(),
-				stderr: (error.stderr ?? error.message ?? "").trim(),
-			};
-		}
-	}
-}

package/extensions/custom-footer.ts

@@ -1,160 +0,0 @@
-/**
- * XTRM Custom Footer Extension
- *
- * Displays: XTRM brand, Model, Context%, CWD, Git branch, Beads chip
- */
-
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { truncateToWidth } from "@mariozechner/pi-tui";
-
-import { SubprocessRunner, EventAdapter } from "./core/lib";
-
-export default function (pi: ExtensionAPI) {
-	interface BeadState {
-		claimId: string | null;
-		shortId: string | null;
-		status: string | null;
-		openCount: number;
-		lastFetch: number;
-	}
-
-	const STATUS_ICONS: Record<string, string> = {
-		open: "○",
-		in_progress: "◐",
-		blocked: "●",
-		closed: "✓",
-	};
-	// Chip background colours (raw ANSI — theme has no bg() API)
-	const CHIP_BG_NEUTRAL  = "\x1b[48;5;238m"; // dark gray
-	const CHIP_BG_ACTIVE   = "\x1b[48;5;39m";  // blue
-	const CHIP_BG_BLOCKED  = "\x1b[48;5;88m";  // red
-	const CHIP_FG          = "\x1b[38;5;15m";  // white
-	const CHIP_RESET       = "\x1b[0m";
-	const chip = (text: string, bg = CHIP_BG_NEUTRAL): string =>
-		`${bg}${CHIP_FG} ${text} ${CHIP_RESET}`;
-
-	const STATUS_BG: Record<string, string> = {
-		open: CHIP_BG_NEUTRAL,
-		in_progress: CHIP_BG_ACTIVE,
-		blocked: CHIP_BG_BLOCKED,
-	};
-
-	let capturedCtx: any = null;
-	let sessionId: string = "";
-	let beadState: BeadState = { claimId: null, shortId: null, status: null, openCount: 0, lastFetch: 0 };
-	let refreshing = false;
-	let requestRender: (() => void) | null = null;
-	const CACHE_TTL = 5000;
-
-	const getCwd = () => capturedCtx?.cwd || process.cwd();
-	const getShortId = (id: string) => id.split("-").pop() ?? id;
-
-	const refreshBeadState = async () => {
-		if (refreshing || Date.now() - beadState.lastFetch < CACHE_TTL) return;
-		const cwd = getCwd();
-		if (!EventAdapter.isBeadsProject(cwd)) return;
-		if (!sessionId) return;
-		refreshing = true;
-		try {
-			const claimResult = await SubprocessRunner.run("bd", ["kv", "get", `claimed:${sessionId}`], { cwd });
-			const claimId = claimResult.code === 0 ? claimResult.stdout.trim() || null : null;
-
-			let status: string | null = null;
-			if (claimId) {
-				const showResult = await SubprocessRunner.run("bd", ["show", claimId, "--json"], { cwd });
-				if (showResult.code === 0) {
-					try { status = JSON.parse(showResult.stdout)[0]?.status ?? null; } catch {}
-				}
-				if (status === "closed") {
-					await SubprocessRunner.run("bd", ["kv", "clear", `claimed:${sessionId}`], { cwd });
-					beadState = { claimId: null, shortId: null, status: null, openCount: beadState.openCount, lastFetch: Date.now() };
-					requestRender?.();
-					return;
-				}
-			}
-
-			let openCount = 0;
-			const listResult = await SubprocessRunner.run("bd", ["list"], { cwd });
-			if (listResult.code === 0) {
-				const m = listResult.stdout.match(/\((\d+)\s+open/);
-				if (m) openCount = parseInt(m[1], 10);
-			}
-
-			beadState = { claimId, shortId: claimId ? getShortId(claimId) : null, status, openCount, lastFetch: Date.now() };
-			requestRender?.();
-		} catch {}
-		finally { refreshing = false; }
-	};
-
-	const buildBeadChip = (): string => {
-		const { claimId, shortId, status, openCount } = beadState;
-		if (claimId && shortId && status) {
-			const icon = STATUS_ICONS[status] ?? "?";
-			const bg = STATUS_BG[status] ?? CHIP_BG_NEUTRAL;
-			return chip(`bd:${shortId}${icon}`, bg);
-		}
-		if (openCount > 0) {
-			return chip(`bd:${openCount}${STATUS_ICONS.open}`);
-		}
-		return "";
-	};
-
-	pi.on("session_start", async (_event, ctx) => {
-		capturedCtx = ctx;
-		// Get session ID from sessionManager/context (prefer UUID, consistent with hooks)
-		sessionId = ctx.sessionManager?.getSessionId?.() ?? ctx.sessionId ?? ctx.session_id ?? process.pid.toString();
-
-		ctx.ui.setFooter((tui, theme, footerData) => {
-			requestRender = () => tui.requestRender();
-			const unsub = footerData.onBranchChange(() => tui.requestRender());
-
-			return {
-				dispose() { unsub(); requestRender = null; },
-				invalidate() {},
-				render(width: number): string[] {
-					refreshBeadState().catch(() => {});
-
-					const BOLD = "\x1b[1m", BOLD_OFF = "\x1b[22m";
-					const brand = `${BOLD}${theme.fg("accent", "XTRM")}${BOLD_OFF}`;
-
-					const usage = ctx.getContextUsage();
-					const pct = usage?.percent ?? 0;
-					const pctColor = pct > 75 ? "error" : pct > 50 ? "warning" : "success";
-					const usageStr = theme.fg(pctColor, `${pct.toFixed(0)}%`);
-
-					const parts = process.cwd().split("/");
-					const short = parts.length > 2 ? parts.slice(-2).join("/") : process.cwd();
-					const cwdStr = theme.fg("muted", `⌂ ${short}`);
-
-					const branch = footerData.getGitBranch();
-					const branchStr = branch ? theme.fg("accent", `⎇ ${branch}`) : "";
-
-					const modelId = ctx.model?.id || "no-model";
-					const modelChip = chip(modelId);
-
-					const sep = " ";
-
-					const brandModel = `${brand} ${modelChip}`;
-					const beadChip = buildBeadChip();
-					const leftParts = [brandModel, usageStr];
-					if (beadChip) leftParts.push(beadChip);
-					leftParts.push(cwdStr);
-					if (branchStr) leftParts.push(branchStr);
-
-					const left = leftParts.join(sep);
-					return [truncateToWidth(left, width)];
-				},
-			};
-		});
-	});
-
-	// Bust the bead cache immediately after any bd write
-	pi.on("tool_result", async (event: any) => {
-		const cmd = event?.input?.command;
-		if (cmd && /\bbd\s+(close|update|create|claim)\b/.test(cmd)) {
-			beadState.lastFetch = 0;
-			setTimeout(() => refreshBeadState().catch(() => {}), 200);
-		}
-		return undefined;
-	});
-}

package/extensions/main-guard-post-push.ts

@@ -1,44 +0,0 @@
-import type { ExtensionAPI, ToolResultEvent } from "@mariozechner/pi-coding-agent";
-import { isBashToolResult } from "@mariozechner/pi-coding-agent";
-import { SubprocessRunner, Logger } from "./core/lib";
-
-const logger = new Logger({ namespace: "main-guard-post-push" });
-
-export default function (pi: ExtensionAPI) {
-	const getProtectedBranches = (): string[] => {
-		const env = process.env.MAIN_GUARD_PROTECTED_BRANCHES;
-		if (env) return env.split(",").map(b => b.trim()).filter(Boolean);
-		return ["main", "master"];
-	};
-
-	pi.on("tool_result", async (event, ctx) => {
-		const cwd = ctx.cwd || process.cwd();
-		if (!isBashToolResult(event) || event.isError) return undefined;
-
-		const cmd = event.input.command.trim();
-		if (!/\bgit\s+push\b/.test(cmd)) return undefined;
-
-		// Check if we pushed to a protected branch
-		const protectedBranches = getProtectedBranches();
-		const tokens = cmd.split(/\s+/);
-		const lastToken = tokens[tokens.length - 1];
-		if (protectedBranches.some(b => lastToken === b || lastToken.endsWith(`:${b}`))) {
-			return undefined;
-		}
-
-		// Success! Suggest PR workflow
-		const reminder = "\n\n**Main-Guard**: Push successful. Next steps:\n" +
-			"  1. `gh pr create --fill` (if not already open)\n" +
-			"  2. `gh pr merge --squash` (once approved)\n" +
-			"  3. `git checkout main && git reset --hard origin/main` (sync local)";
-
-		const newContent = [...event.content];
-		newContent.push({ type: "text", text: reminder });
-
-		if (ctx.hasUI) {
-			ctx.ui.notify("Main-Guard: Suggesting PR workflow", "info");
-		}
-
-		return { content: newContent };
-	});
-}

package/extensions/main-guard.ts

@@ -1,126 +0,0 @@
-import type { ExtensionAPI, ToolCallEvent } from "@mariozechner/pi-coding-agent";
-import { isToolCallEventType } from "@mariozechner/pi-coding-agent";
-import { SubprocessRunner, EventAdapter, Logger } from "./core/lib";
-
-const logger = new Logger({ namespace: "main-guard" });
-
-export default function (pi: ExtensionAPI) {
-	const getProtectedBranches = (): string[] => {
-		const env = process.env.MAIN_GUARD_PROTECTED_BRANCHES;
-		if (env) return env.split(",").map(b => b.trim()).filter(Boolean);
-		return ["main", "master"];
-	};
-
-	const getCurrentBranch = async (cwd: string): Promise<string | null> => {
-		const result = await SubprocessRunner.run("git", ["branch", "--show-current"], { cwd });
-		if (result.code === 0) return result.stdout;
-		return null;
-	};
-
-	const protectedPaths = [".env", ".git/", "node_modules/"];
-
-	pi.on("tool_call", async (event, ctx) => {
-		const cwd = ctx.cwd || process.cwd();
-		
-		// 1. Safety Check: Protected Paths (Global)
-		if (EventAdapter.isMutatingFileTool(event)) {
-			const path = EventAdapter.extractPathFromToolInput(event, cwd);
-			if (path && protectedPaths.some((p) => path.includes(p))) {
-				const reason = `Path "${path}" is protected. Edits to sensitive system files are restricted.`;
-				if (ctx.hasUI) {
-					ctx.ui.notify(`Safety: Blocked edit to protected path`, "error");
-				}
-				return { block: true, reason };
-			}
-		}
-
-		// 2. Safety Check: Dangerous Commands (Global)
-		if (isToolCallEventType("bash", event)) {
-			const cmd = event.input.command.trim();
-			if (cmd.includes("rm -rf") && !cmd.includes("--help")) {
-				if (ctx.hasUI) {
-					const ok = await ctx.ui.confirm("Dangerous Command", `Allow execution of: ${cmd}?`);
-					if (!ok) return { block: true, reason: "Blocked by user confirmation" };
-				} else {
-					return { block: true, reason: "Dangerous command 'rm -rf' blocked in non-interactive mode" };
-				}
-			}
-		}
-
-		// 3. Main-Guard: Branch Protection
-		const protectedBranches = getProtectedBranches();
-		const branch = await getCurrentBranch(cwd);
-
-		if (branch && protectedBranches.includes(branch)) {
-			// A. Mutating File Tools on Main
-			if (EventAdapter.isMutatingFileTool(event)) {
-				const reason = `On protected branch '${branch}'. Checkout a feature branch first: \`git checkout -b feature/<name>\``;
-				if (ctx.hasUI) {
-					ctx.ui.notify(`Main-Guard: Blocked edit on ${branch}`, "error");
-				}
-				return { block: true, reason };
-			}
-
-			// B. Bash Commands on Main
-			if (isToolCallEventType("bash", event)) {
-				const cmd = event.input.command.trim();
-
-				// Emergency override
-				if (process.env.MAIN_GUARD_ALLOW_BASH === "1") return undefined;
-
-				// Enforce squash-only PR merges
-				if (/^gh\s+pr\s+merge\b/.test(cmd)) {
-					if (!/--squash\b/.test(cmd)) {
-						const reason = "Squash only: use `gh pr merge --squash` (or MAIN_GUARD_ALLOW_BASH=1)";
-						return { block: true, reason };
-					}
-					return undefined;
-				}
-
-				// Safe allowlist
-				const SAFE_BASH_PATTERNS = [
-					/^git\s+(status|log|diff|branch|show|describe|fetch|remote|config)\b/,
-					/^git\s+pull\b/,
-					/^git\s+stash\b/,
-					/^git\s+worktree\b/,
-					/^git\s+checkout\s+-b\s+\S+/,
-					/^git\s+switch\s+-c\s+\S+/,
-					...protectedBranches.map(b => new RegExp(`^git\\s+reset\\s+--hard\\s+origin/${b}\\b`)),
-					/^gh\s+/,
-					/^bd\s+/,
-					/^touch\s+\.beads\//,
-				];
-
-				if (SAFE_BASH_PATTERNS.some(p => p.test(cmd))) {
-					return undefined;
-				}
-
-				// Specific blocks
-				if (/\bgit\s+commit\b/.test(cmd)) {
-					return { block: true, reason: `No commits on '${branch}' — use a feature branch.` };
-				}
-
-				if (/\bgit\s+push\b/.test(cmd)) {
-					const tokens = cmd.split(/\s+/);
-					const lastToken = tokens[tokens.length - 1];
-					const explicitProtected = protectedBranches.some(b => lastToken === b || lastToken.endsWith(`:${b}`));
-					const impliedProtected = tokens.length <= 3 && protectedBranches.includes(branch);
-					
-					if (explicitProtected || impliedProtected) {
-						return { block: true, reason: `No direct push to '${branch}' — push a feature branch and open a PR.` };
-					}
-					return undefined;
-				}
-
-				// Default deny
-				const reason = `Bash restricted on '${branch}'. Allowed: git status/log/diff/pull/stash, gh, bd.\n  Exit: git checkout -b feature/<name>`;
-				if (ctx.hasUI) {
-					ctx.ui.notify("Main-Guard: Command blocked", "error");
-				}
-				return { block: true, reason };
-			}
-		}
-
-		return undefined;
-	});
-}