xtrm-tools 0.7.2 → 0.7.4

package/.xtrm/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/.xtrm/extensions/core/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "@xtrm/pi-core",
-  "version": "1.0.0",
-  "description": "Shared utilities for xtrm Pi extensions",
-  "type": "module",
-  "exports": {
-    ".": "./lib.ts",
-    "./lib": "./lib.ts",
-    "./logger": "./logger.ts",
-    "./runner": "./runner.ts",
-    "./adapter": "./adapter.ts",
-    "./guard-rules": "./guard-rules.ts",
-    "./session-state": "./session-state.ts"
-  },
-  "keywords": ["pi", "extension", "xtrm"],
-  "author": "xtrm",
-  "license": "MIT"
-}

package/.xtrm/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/.xtrm/extensions/core/session-state.ts

@@ -1,59 +0,0 @@
-import path from 'node:path';
-import fs from 'node:fs';
-
-export type SessionPhase =
-  | 'claimed'
-  | 'phase1-done'
-  | 'waiting-merge'
-  | 'conflicting'
-  | 'pending-cleanup'
-  | 'merged'
-  | 'cleanup-done';
-
-export interface SessionState {
-  issueId: string;
-  branch: string;
-  worktreePath: string;
-  prNumber: number | null;
-  prUrl: string | null;
-  phase: SessionPhase;
-  conflictFiles: string[];
-  startedAt: string;
-  lastChecked: string;
-}
-
-const SESSION_STATE_FILE = '.xtrm-session-state.json';
-
-export function findSessionStateFile(startCwd: string): string | null {
-  let current = path.resolve(startCwd || process.cwd());
-  for (;;) {
-    const candidate = path.join(current, SESSION_STATE_FILE);
-    if (fs.existsSync(candidate)) return candidate;
-    const parent = path.dirname(current);
-    if (parent === current) return null;
-    current = parent;
-  }
-}
-
-export function readSessionState(startCwd: string): SessionState | null {
-  const filePath = findSessionStateFile(startCwd);
-  if (!filePath) return null;
-  try {
-    const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-    if (!parsed || typeof parsed !== 'object') return null;
-    if (!parsed.issueId || !parsed.branch || !parsed.worktreePath || !parsed.phase) return null;
-    return {
-      issueId: String(parsed.issueId),
-      branch: String(parsed.branch),
-      worktreePath: String(parsed.worktreePath),
-      prNumber: parsed.prNumber ?? null,
-      prUrl: parsed.prUrl ?? null,
-      phase: parsed.phase,
-      conflictFiles: Array.isArray(parsed.conflictFiles) ? parsed.conflictFiles.map(String) : [],
-      startedAt: String(parsed.startedAt || ''),
-      lastChecked: String(parsed.lastChecked || ''),
-    } as SessionState;
-  } catch {
-    return null;
-  }
-}

package/.xtrm/extensions/custom-footer/index.ts

@@ -1,398 +0,0 @@
-/**
- * XTRM Custom Footer Extension
- *
- * Layout:
- * Line 1: ~/path (branch *+↑) — with git status flags, no session name
- * Line 2: XX%/window | (provider) model • thinking — simplified stats
- * Line 3: ◐ 4843.5 Rework project bootstrap... — beads claim or ○ 6 open
- */
-
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
-
-import { SubprocessRunner, EventAdapter } from "@xtrm/pi-core";
-
-export default function (pi: ExtensionAPI) {
-	interface BeadClaim {
-		id: string;
-		shortId: string;
-		title: string | null;
-		status: string;
-	}
-
-	interface BeadState {
-		claims: BeadClaim[];
-		openCount: number;
-		lastFetch: number;
-	}
-
-	interface RuntimeState {
-		branch: string | null;
-		gitStatus: string;
-		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";
-	const CHIP_BG_ACTIVE = "\x1b[48;5;39m";
-	const CHIP_BG_BLOCKED = "\x1b[48;5;88m";
-	const CHIP_FG = "\x1b[38;5;15m";
-	const CHIP_RESET = "\x1b[0m";
-
-	const STATUS_BG: Record<string, string> = {
-		open: CHIP_BG_NEUTRAL,
-		in_progress: CHIP_BG_ACTIVE,
-		blocked: CHIP_BG_BLOCKED,
-	};
-
-	const chip = (text: string, bg = CHIP_BG_NEUTRAL): string => `${bg}${CHIP_FG} ${text} ${CHIP_RESET}`;
-
-	let capturedPi: ExtensionAPI = pi;
-	let capturedCtx: any = null;
-	let requestRender: (() => void) | null = null;
-
-	const CACHE_TTL = 5000;
-	let refreshingBeads = false;
-	let refreshingRuntime = false;
-
-	let beadState: BeadState = {
-		claims: [],
-		openCount: 0,
-		lastFetch: 0,
-	};
-
-	let runtimeState: RuntimeState = {
-		branch: null,
-		gitStatus: "",
-		lastFetch: 0,
-	};
-
-	const getCwd = () => capturedCtx?.cwd || process.cwd();
-	const getShortId = (id: string) => id.split("-").pop() ?? id;
-
-	/**
-	 * Parse git status --porcelain output into status flags
-	 */
-	const parseGitFlags = (porcelain: string): string => {
-		let modified = false;
-		let staged = false;
-		let deleted = false;
-		for (const line of porcelain.split("\n").filter(Boolean)) {
-			if (/^ M|^AM|^MM/.test(line)) modified = true;
-			if (/^A |^M /.test(line)) staged = true;
-			if (/^ D|^D /.test(line)) deleted = true;
-		}
-		return `${modified ? "*" : ""}${staged ? "+" : ""}${deleted ? "-" : ""}`;
-	};
-
-	/**
-	 * Fetch git branch and status
-	 */
-	const refreshRuntimeState = async () => {
-		if (refreshingRuntime || Date.now() - runtimeState.lastFetch < CACHE_TTL) return;
-		refreshingRuntime = true;
-		const cwd = getCwd();
-		try {
-			let branch: string | null = null;
-			let gitStatus = "";
-
-			const rootResult = await SubprocessRunner.run("git", ["rev-parse", "--show-toplevel"], { cwd });
-			const repoRoot = rootResult.code === 0 ? rootResult.stdout.trim() : null;
-
-			if (repoRoot) {
-				const branchResult = await SubprocessRunner.run("git", ["branch", "--show-current"], { cwd });
-				branch = branchResult.code === 0 ? branchResult.stdout.trim() || null : null;
-
-				const porcelainResult = await SubprocessRunner.run(
-					"git",
-					["--no-optional-locks", "status", "--porcelain"],
-					{ cwd },
-				);
-				const baseFlags = porcelainResult.code === 0 ? parseGitFlags(porcelainResult.stdout) : "";
-
-				let upstreamFlags = "";
-				const abResult = await SubprocessRunner.run(
-					"git",
-					["--no-optional-locks", "rev-list", "--left-right", "--count", "@{upstream}...HEAD"],
-					{ cwd },
-				);
-				if (abResult.code === 0) {
-					const [behindRaw, aheadRaw] = abResult.stdout.trim().split(/\s+/);
-					const behind = Number(behindRaw || 0);
-					const ahead = Number(aheadRaw || 0);
-					if (ahead > 0 && behind > 0) upstreamFlags = "↕";
-					else if (ahead > 0) upstreamFlags = "↑";
-					else if (behind > 0) upstreamFlags = "↓";
-				}
-
-				gitStatus = `${baseFlags}${upstreamFlags}`;
-			}
-
-			runtimeState = {
-				branch,
-				gitStatus,
-				lastFetch: Date.now(),
-			};
-			requestRender?.();
-		} catch {
-			// Fail soft — keep last known runtime state.
-		} finally {
-			refreshingRuntime = false;
-		}
-	};
-
-	/**
-	 * Format token counts (from original footer)
-	 */
-	const formatTokens = (count: number): string => {
-		if (count < 1000) return count.toString();
-		if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
-		if (count < 1000000) return `${Math.round(count / 1000)}k`;
-		if (count < 10000000) return `${(count / 1000000).toFixed(1)}M`;
-		return `${Math.round(count / 1000000)}M`;
-	};
-
-	const refreshBeadState = async () => {
-		if (refreshingBeads || Date.now() - beadState.lastFetch < CACHE_TTL) return;
-		const cwd = getCwd();
-		if (!EventAdapter.isBeadsProject(cwd)) return;
-		refreshingBeads = true;
-		try {
-			const inProgressResult = await SubprocessRunner.run("bd", ["list", "--status=in_progress"], { cwd });
-			const inProgressRaw = inProgressResult.code === 0 ? inProgressResult.stdout : "";
-			const ids = [...new Set([...inProgressRaw.matchAll(/^◐\s+([a-z][\w-]+)/gm)].map((m) => m[1]).filter((id) => id.includes("-")))];
-
-			let claims: BeadClaim[] = [];
-			if (ids.length === 1) {
-				const [id] = ids;
-				const showResult = await SubprocessRunner.run("bd", ["show", id, "--json"], { cwd });
-				if (showResult.code === 0) {
-					try {
-						const issue = JSON.parse(showResult.stdout)?.[0];
-						claims = [{ id, shortId: getShortId(id), title: issue?.title ?? null, status: issue?.status ?? "in_progress" }];
-					} catch {
-						claims = [{ id, shortId: getShortId(id), title: null, status: "in_progress" }];
-					}
-				} else {
-					claims = [{ id, shortId: getShortId(id), title: null, status: "in_progress" }];
-				}
-			} else if (ids.length > 1) {
-				claims = ids.map((id) => ({ id, shortId: getShortId(id), title: null, status: "in_progress" }));
-			}
-
-			let openCount = 0;
-			if (claims.length === 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 = {
-				claims,
-				openCount,
-				lastFetch: Date.now(),
-			};
-			requestRender?.();
-		} catch {
-			// Fail soft — keep last known beads state.
-		} finally {
-			refreshingBeads = false;
-		}
-	};
-
-	/**
-	 * Build beads line: ◐ 4843.5 Rework project bootstrap... or ○ 6 open
-	 */
-	const buildBeadsLine = (width: number, theme: any): string => {
-		const { claims, openCount } = beadState;
-
-		if (claims.length === 1) {
-			const [{ shortId, title, status }] = claims;
-			const icon = STATUS_ICONS[status] ?? "◐";
-			const idChip = chip(`${icon} ${shortId}`, STATUS_BG[status] ?? CHIP_BG_NEUTRAL);
-			const cappedTitle = title ? (title.length > 40 ? `${title.slice(0, 39)}…` : title) : "";
-			const line = cappedTitle ? `${idChip} ${theme.fg("muted", cappedTitle)}` : idChip;
-			return truncateToWidth(line, width);
-		}
-
-		if (claims.length > 1) {
-			const chips = claims.map(({ shortId, status }) => {
-				const icon = STATUS_ICONS[status] ?? "◐";
-				return chip(`${icon} ${shortId}`, STATUS_BG[status] ?? CHIP_BG_ACTIVE);
-			});
-			return truncateToWidth(chips.join(" "), width);
-		}
-
-		if (openCount > 0) {
-			return truncateToWidth(`○ ${openCount} open`, width);
-		}
-
-		return truncateToWidth(`○ no open issues`, width);
-	};
-
-	let footerReapplyTimer: ReturnType<typeof setTimeout> | null = null;
-
-	const applyCustomFooter = (ctx: any) => {
-		capturedCtx = ctx;
-		ctx.ui.setFooter((tui, theme, footerData) => {
-			requestRender = () => tui.requestRender();
-			const unsub = footerData.onBranchChange(() => {
-				runtimeState.lastFetch = 0;
-				tui.requestRender();
-			});
-
-			return {
-				dispose() {
-					unsub();
-					requestRender = null;
-				},
-				invalidate() {},
-				render(width: number): string[] {
-					refreshRuntimeState().catch(() => {});
-					refreshBeadState().catch(() => {});
-
-					// === LINE 1: ~/path (branch *+↑) ===
-					// Like original, no session name, but with git status flags
-					let pwd = process.cwd();
-					const home = process.env.HOME || process.env.USERPROFILE;
-					if (home && pwd.startsWith(home)) {
-						pwd = `~${pwd.slice(home.length)}`;
-					}
-
-					// Use runtimeState branch (with git status) or fallback to footerData
-					const branch = runtimeState.branch || footerData.getGitBranch();
-					if (branch) {
-						const branchWithStatus = runtimeState.gitStatus
-							? `${branch} ${runtimeState.gitStatus}`
-							: branch;
-						pwd = `${pwd} (${branchWithStatus})`;
-					}
-
-					const pwdLine = truncateToWidth(theme.fg("dim", pwd), width, theme.fg("dim", "..."));
-
-					// === LINE 2: XX%/window (provider) model • thinking ===
-					const usage = ctx.getContextUsage();
-					const model = ctx.model;
-
-					const contextWindow = usage?.contextWindow ?? model?.contextWindow ?? 0;
-					const contextPercentValue = usage?.percent ?? 0;
-					const contextPercent = usage?.percent !== null ? contextPercentValue.toFixed(1) : "?";
-
-					// Build left side: context %/window (color-coded like original)
-					const contextDisplay =
-						contextPercent === "?"
-							? `?/${formatTokens(contextWindow)}`
-							: `${contextPercent}%/${formatTokens(contextWindow)}`;
-
-					const colorizeUsage = (text: string) => {
-						if (contextPercentValue > 90) return theme.fg("error", text);
-						if (contextPercentValue > 70) return theme.fg("warning", text);
-						return text;
-					};
-
-					// Build right side: (provider) model • thinking
-					const modelName = model?.id || "no-model";
-					const providerCount = footerData.getAvailableProviderCount();
-
-					// Thinking level if model supports reasoning
-					let rightSideWithoutProvider = modelName;
-					if (model?.reasoning) {
-						const thinkingLevel = capturedPi.getThinkingLevel() || "off";
-						rightSideWithoutProvider =
-							thinkingLevel === "off" ? `${modelName} • thinking off` : `${modelName} • ${thinkingLevel}`;
-					}
-
-					// Prepend provider if >1
-					let rightSide = rightSideWithoutProvider;
-					if (providerCount > 1 && model) {
-						rightSide = `(${model.provider}) ${rightSideWithoutProvider}`;
-						if (visibleWidth(contextDisplay) + 3 + visibleWidth(rightSide) > width) {
-							rightSide = rightSideWithoutProvider;
-						}
-					}
-
-					// Keep provider/model adjacent to usage (no right-bound alignment)
-					const separator = " ";
-					const leftWidth = visibleWidth(contextDisplay);
-					const separatorWidth = visibleWidth(separator);
-
-					let line2: string;
-					if (leftWidth >= width) {
-						line2 = colorizeUsage(truncateToWidth(contextDisplay, width, ""));
-					} else {
-						const availableForRight = Math.max(0, width - leftWidth - separatorWidth);
-						const truncatedRight = truncateToWidth(rightSide, availableForRight, "");
-						line2 = `${colorizeUsage(contextDisplay)}${theme.fg("dim", separator)}${theme.fg("dim", truncatedRight)}`;
-					}
-
-					// === LINE 3: ◐ 4843.5 Rework project bootstrap... ===
-					const line3 = buildBeadsLine(width, theme);
-
-					return [pwdLine, line2, line3];
-				},
-			};
-		});
-	};
-
-	const scheduleFooterReapply = (ctx: any, delayMs = 40) => {
-		if (footerReapplyTimer) clearTimeout(footerReapplyTimer);
-		footerReapplyTimer = setTimeout(() => {
-			applyCustomFooter(ctx);
-			footerReapplyTimer = null;
-		}, delayMs);
-	};
-
-	pi.on("session_start", async (_event, ctx) => {
-		capturedCtx = ctx;
-		runtimeState.lastFetch = 0;
-		beadState.lastFetch = 0;
-		applyCustomFooter(ctx);
-		scheduleFooterReapply(ctx);
-	});
-
-	pi.on("session_switch", async (_event, ctx) => {
-		runtimeState.lastFetch = 0;
-		scheduleFooterReapply(ctx);
-	});
-
-	pi.on("session_fork", async (_event, ctx) => {
-		runtimeState.lastFetch = 0;
-		scheduleFooterReapply(ctx);
-	});
-
-	pi.on("model_select", async (_event, ctx) => {
-		scheduleFooterReapply(ctx);
-	});
-
-	pi.on("session_shutdown", async () => {
-		if (footerReapplyTimer) {
-			clearTimeout(footerReapplyTimer);
-			footerReapplyTimer = null;
-		}
-	});
-
-	// Bust caches immediately after relevant writes
-	pi.on("tool_result", async (event: any) => {
-		const cmd = event?.input?.command;
-		if (!cmd) return undefined;
-
-		if (/\bbd\s+(close|update|create|claim)\b/.test(cmd)) {
-			beadState.lastFetch = 0;
-			setTimeout(() => refreshBeadState().catch(() => {}), 200);
-		}
-		if (/\bgit\s+/.test(cmd)) {
-			runtimeState.lastFetch = 0;
-			setTimeout(() => refreshRuntimeState().catch(() => {}), 200);
-		}
-		return undefined;
-	});
-}

package/.xtrm/extensions/custom-footer/package.json

@@ -1,19 +0,0 @@
-{
-  "name": "@xtrm/pi-custom-footer",
-  "version": "1.0.0",
-  "description": "xtrm Pi extension: custom-footer",
-  "type": "module",
-  "exports": {
-    ".": "./index.ts"
-  },
-  "keywords": [
-    "pi",
-    "extension",
-    "xtrm"
-  ],
-  "author": "xtrm",
-  "license": "MIT",
-  "dependencies": {
-    "@xtrm/pi-core": "^1.0.0"
-  }
-}