shariq-pi-extensions 0.3.0 → 0.3.2

package/extensions/git-info/src/git.ts

@@ -1,206 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { sanitizeTerminalText } from "../../shared/tui-dashboard.ts";
-
-export interface GitSummary {
-  isRepository: boolean;
-  root?: string;
-  branch?: string;
-  changedFiles: number;
-  pullRequest?: { number: number; url: string; draft: boolean };
-}
-
-export interface ChangedFile {
-  path: string;
-  name: string;
-  status: string;
-  additions: number | null;
-  deletions: number | null;
-  diff: string[];
-}
-
-interface ChangedPath {
-  path: string;
-  status: string;
-}
-
-const GIT_TIMEOUT_MS = 5_000;
-const GH_TIMEOUT_MS = 10_000;
-const MAX_CHANGED_FILES = 250;
-const MAX_DIFF_LINES = 20_000;
-
-function stripFinalLineBreak(value: string): string {
-  return value.replace(/\r?\n$/, "");
-}
-
-function safePath(value: string): string {
-  return sanitizeTerminalText(value).replace(/[\r\n\t]/g, " ");
-}
-
-export function parseChangedPaths(output: string): ChangedPath[] {
-  const records = output.split("\0");
-  const paths: ChangedPath[] = [];
-  for (let index = 0; index < records.length; index++) {
-    const record = records[index];
-    if (!record || record.length < 4) continue;
-    const status = record.slice(0, 2);
-    const path = record.slice(3);
-    paths.push({ status, path });
-    if (status.includes("R") || status.includes("C")) index++;
-  }
-  return [...new Map(paths.map((entry) => [entry.path, entry])).values()];
-}
-
-export function parseNumstat(output: string): {
-  additions: number | null;
-  deletions: number | null;
-} {
-  const line = output.split("\n").find(Boolean);
-  if (!line) return { additions: 0, deletions: 0 };
-  const [added, deleted] = line.split("\t");
-  return {
-    additions: added === "-" ? null : Number.parseInt(added ?? "0", 10) || 0,
-    deletions: deleted === "-" ? null : Number.parseInt(deleted ?? "0", 10) || 0,
-  };
-}
-
-export async function loadGitSummary(
-  pi: ExtensionAPI,
-  cwd: string,
-  signal?: AbortSignal,
-): Promise<GitSummary> {
-  const root = await pi.exec("git", ["rev-parse", "--show-toplevel"], {
-    cwd,
-    signal,
-    timeout: GIT_TIMEOUT_MS,
-  });
-  if (root.code !== 0) return { isRepository: false, changedFiles: 0 };
-  const repoRoot = stripFinalLineBreak(root.stdout);
-  const [branch, head, status] = await Promise.all([
-    pi.exec("git", ["branch", "--show-current"], {
-      cwd: repoRoot,
-      signal,
-      timeout: GIT_TIMEOUT_MS,
-    }),
-    pi.exec("git", ["rev-parse", "--short", "HEAD"], {
-      cwd: repoRoot,
-      signal,
-      timeout: GIT_TIMEOUT_MS,
-    }),
-    pi.exec("git", ["status", "--porcelain=v1", "-z", "--untracked-files=all"], {
-      cwd: repoRoot,
-      signal,
-      timeout: GIT_TIMEOUT_MS,
-    }),
-  ]);
-  const branchName = branch.stdout.trim();
-  const shortHead = head.stdout.trim();
-  return {
-    isRepository: true,
-    root: repoRoot,
-    branch: safePath(branchName || (shortHead ? `detached@${shortHead}` : "detached")),
-    changedFiles: status.code === 0 ? parseChangedPaths(status.stdout).length : 0,
-  };
-}
-
-export async function loadPullRequest(
-  pi: ExtensionAPI,
-  cwd: string,
-  signal?: AbortSignal,
-): Promise<GitSummary["pullRequest"]> {
-  const result = await pi.exec(
-    "gh",
-    ["pr", "view", "--json", "number,url,state,isDraft"],
-    { cwd, signal, timeout: GH_TIMEOUT_MS },
-  );
-  if (result.code !== 0) return undefined;
-  try {
-    const value = JSON.parse(result.stdout) as unknown;
-    if (!value || typeof value !== "object") return undefined;
-    const record = value as Record<string, unknown>;
-    if (
-      typeof record.number !== "number" ||
-      typeof record.url !== "string" ||
-      record.state !== "OPEN"
-    ) {
-      return undefined;
-    }
-    return {
-      number: record.number,
-      url: record.url,
-      draft: record.isDraft === true,
-    };
-  } catch {
-    return undefined;
-  }
-}
-
-async function loadFile(
-  pi: ExtensionAPI,
-  repoRoot: string,
-  changed: ChangedPath,
-  hasHead: boolean,
-  signal?: AbortSignal,
-): Promise<ChangedFile> {
-  const untracked = changed.status === "??" || !hasHead;
-  const diffArgs = untracked
-    ? ["diff", "--no-index", "--no-ext-diff", "--no-color", "--unified=3", "--", "/dev/null", changed.path]
-    : ["diff", "--no-ext-diff", "--no-color", "--unified=3", "HEAD", "--", changed.path];
-  const statArgs = untracked
-    ? ["diff", "--no-index", "--numstat", "--", "/dev/null", changed.path]
-    : ["diff", "--numstat", "HEAD", "--", changed.path];
-  const [diff, stat] = await Promise.all([
-    pi.exec("git", diffArgs, { cwd: repoRoot, signal, timeout: GH_TIMEOUT_MS }),
-    pi.exec("git", statArgs, { cwd: repoRoot, signal, timeout: GH_TIMEOUT_MS }),
-  ]);
-  const allLines = diff.stdout
-    .trimEnd()
-    .split("\n")
-    .map(sanitizeTerminalText);
-  const lines = allLines.length > MAX_DIFF_LINES
-    ? [...allLines.slice(0, MAX_DIFF_LINES), `… diff truncated after ${MAX_DIFF_LINES.toLocaleString()} lines …`]
-    : allLines;
-  const stats = parseNumstat(stat.stdout);
-  const path = safePath(changed.path);
-  return {
-    ...stats,
-    path,
-    name: path.split("/").at(-1) || path,
-    status: sanitizeTerminalText(changed.status),
-    diff: lines.length === 1 && lines[0] === "" ? ["No textual diff available."] : lines,
-  };
-}
-
-export async function loadChangedFiles(
-  pi: ExtensionAPI,
-  cwd: string,
-  signal?: AbortSignal,
-): Promise<{ root: string; files: ChangedFile[]; omitted: number } | null> {
-  const root = await pi.exec("git", ["rev-parse", "--show-toplevel"], {
-    cwd,
-    signal,
-    timeout: GIT_TIMEOUT_MS,
-  });
-  if (root.code !== 0) return null;
-  const repoRoot = stripFinalLineBreak(root.stdout);
-  const [status, head] = await Promise.all([
-    pi.exec("git", ["status", "--porcelain=v1", "-z", "--untracked-files=all"], {
-      cwd: repoRoot,
-      signal,
-      timeout: GIT_TIMEOUT_MS,
-    }),
-    pi.exec("git", ["rev-parse", "--verify", "HEAD"], {
-      cwd: repoRoot,
-      signal,
-      timeout: GIT_TIMEOUT_MS,
-    }),
-  ]);
-  if (status.code !== 0) return null;
-  const changed = parseChangedPaths(status.stdout);
-  const selected = changed.slice(0, MAX_CHANGED_FILES);
-  const files: ChangedFile[] = [];
-  for (const entry of selected) {
-    signal?.throwIfAborted();
-    files.push(await loadFile(pi, repoRoot, entry, head.code === 0, signal));
-  }
-  return { root: repoRoot, files, omitted: changed.length - selected.length };
-}

package/extensions/git-info/src/ui.ts

@@ -1,291 +0,0 @@
-import type {
-  ExtensionContext,
-  Theme,
-} from "@earendil-works/pi-coding-agent";
-import {
-  Key,
-  matchesKey,
-  truncateToWidth,
-} from "@earendil-works/pi-tui";
-import {
-  frameBottom,
-  frameTop,
-  joinSides,
-  oneLine,
-  padLine,
-  stateLabel,
-  viewportSlice,
-} from "../../shared/tui-dashboard.ts";
-import type { ChangedFile } from "./git.ts";
-
-function statusState(status: string): "success" | "warning" | "error" {
-  if (status === "??" || status.includes("A")) return "success";
-  if (status.includes("D")) return "error";
-  return "warning";
-}
-
-function statText(file: ChangedFile): string {
-  if (file.additions === null || file.deletions === null) return "binary";
-  return `+${file.additions} -${file.deletions}`;
-}
-
-function styleDiff(theme: Theme, line: string): string {
-  if (line.startsWith("diff --git") || line.startsWith("index ")) {
-    return theme.fg("accent", theme.bold(line));
-  }
-  if (line.startsWith("@@")) return theme.fg("mdHeading", line);
-  if (line.startsWith("---") || line.startsWith("+++")) return theme.fg("muted", line);
-  if (line.startsWith("+")) return theme.fg("success", line);
-  if (line.startsWith("-")) return theme.fg("error", line);
-  if (line.startsWith("…")) return theme.fg("warning", line);
-  return theme.fg("text", line);
-}
-
-function combine(left: string, right: string, width: number): string {
-  return truncateToWidth(`${left}${right}`, width, "");
-}
-
-export class GitChangesView {
-  private selected = 0;
-  private focus: "files" | "diff" = "files";
-  private diffOffset = 0;
-  private cachedWidth?: number;
-  private cachedHeight?: number;
-  private cachedLines?: string[];
-  private readonly files: ReadonlyArray<ChangedFile>;
-  private readonly root: string;
-  private readonly omitted: number;
-  private readonly theme: Theme;
-  private readonly rows: () => number;
-  private readonly requestRender: () => void;
-  private readonly close: () => void;
-
-  constructor(
-    files: ReadonlyArray<ChangedFile>,
-    root: string,
-    omitted: number,
-    theme: Theme,
-    rows: () => number,
-    requestRender: () => void,
-    close: () => void,
-  ) {
-    this.files = files;
-    this.root = root;
-    this.omitted = omitted;
-    this.theme = theme;
-    this.rows = rows;
-    this.requestRender = requestRender;
-    this.close = close;
-  }
-
-  private current(): ChangedFile {
-    return this.files[this.selected]!;
-  }
-
-  private invalidateRender(): void {
-    this.cachedWidth = undefined;
-    this.cachedHeight = undefined;
-    this.cachedLines = undefined;
-    this.requestRender();
-  }
-
-  private moveFile(amount: number): void {
-    this.selected = (this.selected + amount + this.files.length) % this.files.length;
-    this.diffOffset = 0;
-    this.invalidateRender();
-  }
-
-  private moveDiff(amount: number): void {
-    const bodyHeight = Math.max(1, this.rows() - 8);
-    const max = Math.max(0, this.current().diff.length - bodyHeight);
-    this.diffOffset = Math.max(0, Math.min(max, this.diffOffset + amount));
-    this.invalidateRender();
-  }
-
-  handleInput(data: string): void {
-    if (this.focus === "files") {
-      if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
-        this.close();
-        return;
-      }
-      if (matchesKey(data, Key.down) || data === "j") this.moveFile(1);
-      else if (matchesKey(data, Key.up) || data === "k") this.moveFile(-1);
-      else if (matchesKey(data, Key.home) || data === "g") {
-        this.selected = 0;
-        this.diffOffset = 0;
-        this.invalidateRender();
-      } else if (matchesKey(data, Key.end) || data === "G") {
-        this.selected = this.files.length - 1;
-        this.diffOffset = 0;
-        this.invalidateRender();
-      } else if (
-        matchesKey(data, Key.enter) ||
-        matchesKey(data, Key.tab) ||
-        matchesKey(data, Key.right) ||
-        data === "l"
-      ) {
-        this.focus = "diff";
-        this.invalidateRender();
-      }
-      return;
-    }
-
-    if (
-      matchesKey(data, Key.escape) ||
-      matchesKey(data, Key.tab) ||
-      matchesKey(data, Key.left) ||
-      data === "h"
-    ) {
-      this.focus = "files";
-      this.invalidateRender();
-      return;
-    }
-    if (matchesKey(data, Key.down) || data === "j") this.moveDiff(4);
-    else if (matchesKey(data, Key.up) || data === "k") this.moveDiff(-4);
-    else if (matchesKey(data, Key.ctrl("d")) || matchesKey(data, Key.pageDown)) {
-      this.moveDiff(Math.max(1, Math.floor((this.rows() - 8) / 2)));
-    } else if (matchesKey(data, Key.ctrl("u")) || matchesKey(data, Key.pageUp)) {
-      this.moveDiff(-Math.max(1, Math.floor((this.rows() - 8) / 2)));
-    } else if (matchesKey(data, Key.home) || data === "g") {
-      this.diffOffset = 0;
-      this.invalidateRender();
-    } else if (matchesKey(data, Key.end) || data === "G") {
-      this.diffOffset = Math.max(0, this.current().diff.length - Math.max(1, this.rows() - 8));
-      this.invalidateRender();
-    } else if (matchesKey(data, Key.ctrl("c"))) {
-      this.close();
-    }
-  }
-
-  private renderList(width: number, height: number): string[] {
-    const inner = Math.max(1, width - 2);
-    const viewport = viewportSlice(this.files, this.selected, height);
-    const lines: string[] = [];
-    for (let row = 0; row < height; row++) {
-      const file = viewport.items[row];
-      if (!file) {
-        lines.push(`${this.theme.fg("border", "│")}${padLine("", inner)}${this.theme.fg("border", "│")}`);
-        continue;
-      }
-      const index = viewport.start + row;
-      const selected = index === this.selected;
-      const prefix = selected ? "❯" : " ";
-      const left = `${prefix} ${file.status.padEnd(2)} ${oneLine(file.path)}`;
-      const rowText = joinSides(left, statText(file), inner);
-      const styled = selected
-        ? this.theme.bg("selectedBg", this.theme.fg("accent", rowText))
-        : this.theme.fg(statusState(file.status), rowText);
-      lines.push(`${this.theme.fg(selected ? "borderAccent" : "border", "│")}${padLine(styled, inner)}${this.theme.fg(selected ? "borderAccent" : "border", "│")}`);
-    }
-    return lines;
-  }
-
-  private renderDiff(width: number, height: number): string[] {
-    const file = this.current();
-    const inner = Math.max(1, width - 2);
-    const lines: string[] = [];
-    const max = Math.max(0, file.diff.length - height);
-    this.diffOffset = Math.min(this.diffOffset, max);
-    for (let row = 0; row < height; row++) {
-      const source = file.diff[this.diffOffset + row];
-      const content = source === undefined ? "" : styleDiff(this.theme, source.replaceAll("\t", "    "));
-      lines.push(`${this.theme.fg(this.focus === "diff" ? "borderAccent" : "border", "│")}${padLine(content, inner)}${this.theme.fg(this.focus === "diff" ? "borderAccent" : "border", "│")}`);
-    }
-    return lines;
-  }
-
-  render(width: number): string[] {
-    const terminalRows = this.rows();
-    if (
-      this.cachedLines &&
-      this.cachedWidth === width &&
-      this.cachedHeight === terminalRows
-    ) {
-      return this.cachedLines;
-    }
-    const safeWidth = Math.max(1, width);
-    const bodyHeight = Math.max(4, terminalRows - 7);
-    const current = this.current();
-    const totals = this.files.reduce(
-      (sum, file) => ({
-        additions: sum.additions + (file.additions ?? 0),
-        deletions: sum.deletions + (file.deletions ?? 0),
-      }),
-      { additions: 0, deletions: 0 },
-    );
-    const loaded = this.omitted > 0
-      ? `${this.files.length} shown · ${this.omitted} omitted`
-      : `${this.files.length} changed`;
-    const header = joinSides(
-      `  ${this.theme.bold("Git changes")} ${this.theme.fg("muted", oneLine(this.root))}`,
-      `${stateLabel(this.theme, "success", `+${totals.additions}`)}  ${stateLabel(this.theme, "error", `-${totals.deletions}`)}`,
-      safeWidth,
-    );
-    const lines = [header];
-
-    if (safeWidth >= 88) {
-      const leftWidth = Math.max(34, Math.floor(safeWidth * 0.4));
-      const rightWidth = safeWidth - leftWidth;
-      const listTitle = `${loaded}${this.focus === "files" ? " · active" : ""}`;
-      const diffTitle = `${oneLine(current.path)} · ${statText(current)}${this.focus === "diff" ? " · active" : ""}`;
-      lines.push(combine(frameTop(this.theme, leftWidth, listTitle), frameTop(this.theme, rightWidth, diffTitle), safeWidth));
-      const list = this.renderList(leftWidth, bodyHeight);
-      const diff = this.renderDiff(rightWidth, bodyHeight);
-      for (let row = 0; row < bodyHeight; row++) {
-        lines.push(combine(list[row]!, diff[row]!, safeWidth));
-      }
-      lines.push(combine(frameBottom(this.theme, leftWidth), frameBottom(this.theme, rightWidth), safeWidth));
-    } else if (this.focus === "files") {
-      lines.push(frameTop(this.theme, safeWidth, loaded));
-      lines.push(...this.renderList(safeWidth, bodyHeight));
-      lines.push(frameBottom(this.theme, safeWidth));
-    } else {
-      lines.push(frameTop(this.theme, safeWidth, `${oneLine(current.path)} · ${statText(current)}`));
-      lines.push(...this.renderDiff(safeWidth, bodyHeight));
-      lines.push(frameBottom(this.theme, safeWidth));
-    }
-
-    const hint = this.focus === "files"
-      ? "  up/down/jk select · enter/tab inspect · g/G first/last · escape close"
-      : "  up/down/jk scroll · ctrl+u/d page · tab/h files · ctrl+c close";
-    lines.push(padLine(this.theme.fg("dim", hint), safeWidth));
-    this.cachedWidth = width;
-    this.cachedHeight = terminalRows;
-    this.cachedLines = lines.map((line) => truncateToWidth(line, safeWidth, ""));
-    return this.cachedLines;
-  }
-
-  invalidate(): void {
-    this.cachedWidth = undefined;
-    this.cachedHeight = undefined;
-    this.cachedLines = undefined;
-  }
-}
-
-export async function openGitChanges(
-  ctx: ExtensionContext,
-  root: string,
-  files: ReadonlyArray<ChangedFile>,
-  omitted: number,
-): Promise<void> {
-  await ctx.ui.custom<void>(
-    (tui, theme, _keybindings, done) =>
-      new GitChangesView(
-        files,
-        root,
-        omitted,
-        theme,
-        () => tui.terminal.rows || 30,
-        () => tui.requestRender(),
-        () => done(undefined),
-      ),
-    {
-      overlay: true,
-      overlayOptions: {
-        width: "100%",
-        maxHeight: "100%",
-        minWidth: 40,
-      },
-    },
-  );
-}

package/extensions/orchestration/README.md

@@ -1,58 +0,0 @@
-# Orchestration
-
-Orchestration coordinates large, explicitly requested software tasks through one dedicated orchestrator and configurable specialist agents. It uses the suite's Subagents runtime rather than creating a competing execution system.
-
-## Workflow
-
-1. Open `/orchestration`, choose **New**, and describe the objective.
-2. The dedicated orchestrator creates a dependency-aware plan and routes tasks to explorer, frontend, backend, or general workers.
-3. Review the plan in the dashboard. Give feedback if needed, then approve it once.
-4. Workers run autonomously. Git-backed writing tasks use one worktree per task; non-Git projects allow only one writer at a time.
-5. The configured reviewer checks each task, may make small obvious fixes, and sends larger findings back to the same worker session with its existing context.
-6. Reviewed changes integrate into a temporary orchestration branch. A final holistic review gates application to the source checkout.
-7. The extension applies the reviewed result without committing or pushing.
-
-The orchestrator sleeps while agents work and wakes automatically at execution boundaries. It asks the user only for a genuine blocker or scope-changing decision.
-
-## Roles and settings
-
-Use `/orchestration settings` (or `s` in the dashboard) to open the interactive role configuration panel. Navigate roles with `j`/`k`, press `Enter` to search and select models from all active providers in the Searchable Model Picker, press `t` or `Tab` to cycle thinking levels directly, and press `s` to save. Settings configure:
-
-- orchestrator
-- explorer
-- frontend worker
-- backend worker
-- general worker
-- reviewer
-
-Settings are stored with restrictive permissions under Pi's active agent directory at `orchestration/settings.json`. They apply globally and are changed only through the settings UI.
-
-Each project has up to 10 concurrent worker, explorer, or reviewer sessions. The dedicated orchestrator does not consume one of those slots. Multiple projects may run concurrently with independent pools.
-
-## Dashboard
-
-Orchestration creation and inspection render as compact main-chat cards with expandable detail. Active runs appear in the shared bounded **Active work** dock; plan-ready and blocked runs are prioritized as attention states. `/orchestration` opens a full-height framed operations dashboard with a bounded body and stable selection. Dashboard actions close the overlay before opening editors, settings, or confirmation prompts, then return to the live dashboard so nested UI cannot stall. **New** opens the objective editor before asking for missing role models, so cancelling a draft does not force configuration; cancelling unchanged settings does not claim they were saved.
-
-- `j` / `k`: select a run
-- `Enter`: inspect tasks and reviews
-- `n`: create a run
-- `s`: configure role models
-- `a`: approve the initial plan
-- `f`: give plan feedback
-- `p`: pause, resume, or recover
-- `x`: leave the dashboard and confirm cancellation while preserving artifacts
-- `Esc`: go back or close
-
-Interrupted runs recover in a paused state and require explicit resume. Run state is machine-local under Pi's active agent directory at `orchestration/runs/<run-id>/`.
-
-## Safety boundaries
-
-- Orchestration starts only from `/orchestration` or an explicit natural-language request.
-- A Git source checkout must be clean before writing begins.
-- Writing workers never share a Git worktree.
-- Reviewers make only small localized fixes; larger fixes return to the original worker session.
-- A task gets at most two automatic fix rounds before the run blocks.
-- Source changes integrate sequentially only after review.
-- The extension never commits or pushes the source repository.
-- Agent thinking is not copied into orchestration artifacts.
-- Disabling Subagents makes Orchestration unavailable rather than falling back to another runtime.