shariq-pi-extensions 0.3.0 → 0.3.2

package/README.md

@@ -24,13 +24,10 @@ The package contains:
 
 - structured user questions
 - managed background terminals
-- copy-all transcript support
 - Firecrawl search and scraping
-- Git status UI
 - persistent task goals
 - branch-safe model-maintained task lists with live progress UI and compaction continuity
 - configurable steer, interrupt, or follow-up input behavior
-- dedicated multi-agent orchestration
 - Smart Compaction with high-fidelity checkpointing, delta-merging, and custom model routing
 - per-response TPS, TTFT, elapsed-time, and output status
 - Context Usage display
@@ -38,7 +35,7 @@ The package contains:
 - Pi subagents
 - lightweight URL fetching
 
-The package also includes the `ember-warm-dark` TUI theme and declares the `background-terminals`, `orchestration`, and `subagents` skills so Pi loads their operating guidance automatically. Pi reads them from the installed package; duplicating files under `<agent-dir>/skills` is unnecessary and would leave stale copies after removal.
+The package also includes the `ember-warm-dark` TUI theme and declares the `background-terminals` and `subagents` skills so Pi loads their operating guidance automatically. Pi reads them from the installed package; duplicating files under `<agent-dir>/skills` is unnecessary and would leave stale copies after removal.
 
 See [`docs/EXTENSIONS.md`](docs/EXTENSIONS.md) for commands, tools, configuration, and external dependencies.
 

package/docs/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Architecture
 
-Last verified: 2026-08-21
+Last verified: 2026-09-04
 
 ## Package boundary
 
@@ -17,7 +17,7 @@ docs/                            package-level maintenance documentation
 scripts/                         repository validation helpers
 ```
 
-Extension entrypoints register tools, commands, providers, events, or UI. Shared code stays in `extensions/shared` only when more than one extension owns the behavior. The shared activity dock combines active Task List, terminal, subagent, and orchestration rows under one bounded widget; shared tool cards keep lifecycle operations compact in the timeline while preserving expanded output. Provider-specific protocol and authentication code remains inside its provider directory. The background-terminal, orchestration, and subagent skills ship beside their extensions so a new machine receives the required lifecycle guidance with the tools.
+Extension entrypoints register tools, commands, providers, events, or UI. Shared code stays in `extensions/shared` only when more than one extension owns the behavior. The shared activity dock combines active Task List, terminal, and subagent rows under one bounded widget; shared tool cards keep lifecycle operations compact in the timeline while preserving expanded output. Provider-specific protocol and authentication code remains inside its provider directory. The background-terminal and subagent skills ship beside their extensions so a new machine receives the required lifecycle guidance with the tools.
 
 ## Dependency model
 
@@ -37,7 +37,6 @@ Installed package directories are treated as immutable. Extensions resolve writa
 - Smart Compaction configuration and details ledgers: `<agent-dir>/smart-compaction.json`
 - Input mode configuration: `<agent-dir>/input-mode.json`
 - Subagent configuration and catalog: paths derived from `getAgentDir()`
-- Orchestration settings and run ledgers: `<agent-dir>/orchestration/`
 - Goal and Task List state: branch-local Pi session entries; neither writes a separate runtime-state file
 - project configuration: paths derived from Pi's `CONFIG_DIR_NAME`
 

package/docs/DEVELOPMENT.md

@@ -1,6 +1,6 @@
 # Development and cutover
 
-Last verified: 2026-08-21
+Last verified: 2026-09-04
 
 ## Requirements
 
@@ -45,7 +45,7 @@ Keep secrets out of examples and fixtures. Tests should inject temporary roots,
 
 ## Skills paired with extensions
 
-The root manifest declares `skills/background-terminals`, `skills/orchestration`, and `skills/subagents`. Pi loads them directly from the managed package. Do not copy them into the agent directory from install scripts; that would create duplicates and leave stale files after removal.
+The root manifest declares `skills/background-terminals` and `skills/subagents`. Pi loads them directly from the managed package. Do not copy them into the agent directory from install scripts; that would create duplicates and leave stale files after removal.
 
 When any paired skill changes, validate its structure and keep its behavior aligned with the corresponding extension tools.
 

package/docs/EXTENSIONS.md

@@ -1,6 +1,6 @@
 # Extension catalog
 
-Last verified: 2026-09-03
+Last verified: 2026-09-04
 
 ## Agent workflow
 
@@ -24,12 +24,6 @@ The subagent extension runs flat Pi child agents with profiles, capability polic
 
 The extension supplies tools including `spawn_agent`, `task`, `check_agent`, `list_agents`, `wait_agent`, `send_message`, `close_agent`, `reply_question`, and `apply_agent_changes`. These lifecycle operations render as compact expandable main-chat cards; only active manager entries contribute to the bounded Active work dock, while workflow progress is intentionally omitted from the footer so persisted history cannot inflate or duplicate live status. Cancellation and reload interruption use a distinct `cancelled` state rather than `error`. All completed and cancelled production subagent snapshots and transcripts persist across Pi restarts (`<agent-dir>/subagents/runs/`), allowing `resume_from` to resume completed workers at any point. Interruption immediately cascades across all child fibers in `<10ms`. Child settlement stays in a private extension queue while the parent is active, then starts one custom-result turn at Pi's safe idle edge with the summary guaranteed in model context and never rendered as user-authored or follow-up input; status tools are for explicit inspection, not waiting.
 
-### [Orchestration](../extensions/orchestration/README.md)
-
-The Orchestration extension coordinates explicitly requested large tasks through a dedicated orchestrator plus configurable explorer, frontend, backend, general-worker, and reviewer models. `/orchestration` opens the dashboard and `/orchestration settings` opens the interactive role-configuration panel with the Searchable Model Picker. It reuses the canonical Subagents runtime, maintains a 10-worker pool per project, isolates Git writers in task worktrees, resumes the original worker for substantial review fixes, and applies final reviewed changes without committing or pushing.
-
-The model-facing `create_orchestration` tool starts planning only after an explicit orchestration request. `get_orchestration` reports status without advancing work. Both use compact expandable timeline cards, and active runs share the full-screen Active work dock with explicit plan-ready, blocked, running, and paused states instead of duplicating workflow progress in the footer. The full-height framed dashboard provides scrollable multi-task inspection and runs editors and confirmations outside its overlay to avoid nested-input stalls. Interrupted runs recover paused under `<agent-dir>/orchestration/`.
-
 ### [Smart Compaction](../extensions/smart-compaction/README.md)
 
 Replaces standard context compaction with a defensive, high-fidelity continuity engine. It intercepts `session_before_compact` events and synthesizes multi-turn conversations into structured checkpoint summaries capturing primary goals and negative constraints, progress ledgers (`Done`/`In Progress`/`Blocked`), verbatim code snippets for active/uncommitted edits, exact error root causes, architectural decisions, resume anchors, and deterministic file/diff state.
@@ -73,14 +67,6 @@ Displays the estimated prompt and session contribution to the active context win
 
 Adds a responsive footer-area status row while each assistant message is active and for an eight-second completion linger, then clears it to avoid permanent footer noise. Live TPS/output are marked as estimates; final TPS uses conventional decode throughput from first streamed token to message completion. TTFT and total elapsed time separately expose provider latency, prefill, and hidden reasoning; output tokens and active tools remain separate.
 
-### [Git info](../extensions/git-info/README.md)
-
-Adds repository state to Pi's interface. `/lg` opens the local Git view and `/pr` exposes pull-request context when available.
-
-### [Copy all](../extensions/copy-all/README.md)
-
-`/copy-all` copies the current conversation in a readable form while omitting tool protocol noise that does not belong in the transcript.
-
 ### [Input mode](../extensions/input-mode/README.md)
 
 `/input-mode` chooses what ordinary Enter does while Pi is running: steer before the next model step, interrupt the active run, or wait as a follow-up. The global selection lives in `<agent-dir>/input-mode.json`; explicit Alt+Enter follow-ups and non-interactive inputs retain native behavior. Pi does not expose extension rows in core `/settings`, so this is a dedicated extension settings picker rather than a private TUI patch.

package/extensions/shared/README.md

@@ -4,7 +4,7 @@ Internal runtime utilities used by more than one extension. This directory is no
 
 ## Modules
 
-- `activity-dock.ts` aggregates bounded urgency-ordered live rows from Task List, Background Terminals, Subagents, and Orchestration into one automatic widget.
+- `activity-dock.ts` aggregates bounded urgency-ordered live rows from Task List, Background Terminals, and Subagents into one automatic widget.
 - `activity-status.ts` formats compact running/completed/failed status counts.
 - `child-session.ts` owns trust-aware child resources and bounded session shutdown.
 - `context-utilization.ts` formats model-context usage and capacity.

package/extensions/shared/child-session.ts

@@ -18,8 +18,6 @@ export const CHILD_EXCLUDED_TOOL_NAMES = [
   "subagent_check",
   "subagent_list",
   "workflow",
-  "create_orchestration",
-  "get_orchestration",
   "ask_user",
 ] as const;
 

package/extensions/shared/dashboard-state.ts

@@ -1,5 +1,4 @@
 export const MODEL_INFO_CHANNEL = "dashboard:model-info";
-export const GIT_INFO_CHANNEL = "dashboard:git-info";
 export const REFRESH_CHANNEL = "dashboard:refresh";
 
 export interface ModelInfoState {
@@ -15,19 +14,6 @@ export interface ModelInfoState {
   generating: boolean;
 }
 
-export interface PullRequestInfo {
-  number: number;
-  url: string;
-  isDraft: boolean;
-}
-
-export interface GitInfoState {
-  isRepository: boolean;
-  branch: string | null;
-  changedFiles: number;
-  pullRequest: PullRequestInfo | null;
-}
-
 export function emptyModelInfoState(): ModelInfoState {
   return {
     provider: "",
@@ -43,15 +29,6 @@ export function emptyModelInfoState(): ModelInfoState {
   };
 }
 
-export function emptyGitInfoState(): GitInfoState {
-  return {
-    isRepository: false,
-    branch: null,
-    changedFiles: 0,
-    pullRequest: null,
-  };
-}
-
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null;
 }
@@ -76,24 +53,3 @@ export function isModelInfoState(value: unknown): value is ModelInfoState {
     typeof value.generating === "boolean"
   );
 }
-
-function isPullRequestInfo(value: unknown): value is PullRequestInfo {
-  if (!isRecord(value)) return false;
-
-  return (
-    typeof value.number === "number" &&
-    typeof value.url === "string" &&
-    typeof value.isDraft === "boolean"
-  );
-}
-
-export function isGitInfoState(value: unknown): value is GitInfoState {
-  if (!isRecord(value)) return false;
-
-  return (
-    typeof value.isRepository === "boolean" &&
-    (value.branch === null || typeof value.branch === "string") &&
-    typeof value.changedFiles === "number" &&
-    (value.pullRequest === null || isPullRequestInfo(value.pullRequest))
-  );
-}

package/extensions/smart-compaction/engine.ts

@@ -50,6 +50,7 @@ export interface SmartCompactionDetails {
   serializedCharacters: number;
   summaryCharacters: number;
   attemptCount: number;
+  retainedIdentifiersAppended?: number;
   durationMs: number;
   timestamp: number;
 }
@@ -328,7 +329,9 @@ const REQUIRED_SECTION_PATTERNS = [
   /## 6\.\s+Resume Anchor/i,
 ];
 
-export function validateSummaryOutput(response: AssistantMessage, protectedFacts: readonly string[] = []): string {
+export const RETAINED_IDENTIFIERS_HEADING = "### Retained Identifiers";
+
+export function extractSummaryText(response: AssistantMessage): string {
   if (response.stopReason !== "stop") {
     const errorDetails = response.errorMessage ? `: ${response.errorMessage}` : "";
     throw new Error(`Compaction model did not complete successfully (stopReason="${response.stopReason}"${errorDetails}).`);
@@ -350,13 +353,38 @@ export function validateSummaryOutput(response: AssistantMessage, protectedFacts
     throw new Error("Compaction model returned an empty summary.");
   }
 
+  return rawSummaryText;
+}
+
+export function getDroppedProtectedFacts(summaryText: string, protectedFacts: readonly string[] = []): string[] {
+  return protectedFacts.filter((fact) => fact && !summaryText.includes(fact));
+}
+
+export function withRetainedIdentifiers(summaryText: string, droppedFacts: readonly string[]): string {
+  // Protected facts are single-line opaque identifiers (hashes, UUIDs, clean
+  // URLs, IPs), so reproducing them on their own bullet lines is verbatim-safe.
+  const lines = [summaryText.trimEnd(), "", RETAINED_IDENTIFIERS_HEADING];
+  for (const fact of droppedFacts) {
+    const clean = String(fact).trim();
+    if (clean) lines.push(`- ${clean}`);
+  }
+  return lines.join("\n") + "\n";
+}
+
+export function validateSummaryText(summaryText: string, protectedFacts: readonly string[] = []): string {
+  const rawSummaryText = summaryText.trim();
+
+  if (!rawSummaryText) {
+    throw new Error("Compaction model returned an empty summary.");
+  }
+
   // Verify all 6 required sections exist
   for (const pattern of REQUIRED_SECTION_PATTERNS) {
     if (!pattern.test(rawSummaryText)) {
       throw new Error(`Compaction summary is incomplete: missing required section matching ${pattern.source}`);
     }
   }
-  const missingFacts = protectedFacts.filter((fact) => !rawSummaryText.includes(fact));
+  const missingFacts = getDroppedProtectedFacts(rawSummaryText, protectedFacts);
   if (missingFacts.length > 0) {
     throw new Error(`Compaction summary dropped protected facts: ${missingFacts.slice(0, 3).join(" | ")}`);
   }
@@ -364,6 +392,29 @@ export function validateSummaryOutput(response: AssistantMessage, protectedFacts
   return rawSummaryText;
 }
 
+export function validateSummaryOutput(response: AssistantMessage, protectedFacts: readonly string[] = []): string {
+  return validateSummaryText(extractSummaryText(response), protectedFacts);
+}
+
+/**
+ * Return the summary text when it is structurally sound (extractable with all
+ * required sections) regardless of dropped protected facts. Identifier-only
+ * defects can be repaired deterministically with {@link withRetainedIdentifiers};
+ * structural defects cannot, so those return undefined.
+ */
+export function extractRepairableSummary(response: AssistantMessage): string | undefined {
+  let text: string;
+  try {
+    text = extractSummaryText(response);
+  } catch {
+    return undefined;
+  }
+  for (const pattern of REQUIRED_SECTION_PATTERNS) {
+    if (!pattern.test(text)) return undefined;
+  }
+  return text;
+}
+
 export function computeCompactionTokenCeiling(
   model: Model<Api>,
   config: SmartCompactionConfig,
@@ -529,6 +580,8 @@ export async function runSmartCompaction(
 
   let lastError: Error | undefined;
   let finalSummaryText = "";
+  let repairCandidate: string | undefined;
+  let retainedIdentifiersAppended = 0;
   let accumulatedUsage: Usage | undefined;
   let attemptCount = 0;
   let activeModel = primaryModel;
@@ -572,7 +625,16 @@ export async function runSmartCompaction(
       if (response.usage) {
         accumulatedUsage = combineCompactionUsage(accumulatedUsage, response.usage);
       }
-      finalSummaryText = validateSummaryOutput(response, protectedFacts);
+      try {
+        finalSummaryText = validateSummaryOutput(response, protectedFacts);
+      } catch (validationError) {
+        // Structurally sound summaries that only drop protected facts are
+        // kept as deterministic-repair candidates; structural defects cannot
+        // be repaired, so those leave no candidate behind.
+        const repairable = extractRepairableSummary(response);
+        if (repairable !== undefined) repairCandidate = repairable;
+        throw validationError;
+      }
       lastError = undefined;
       break; // Success!
     } catch (err) {
@@ -586,6 +648,23 @@ export async function runSmartCompaction(
     }
   }
 
+  if ((lastError || !finalSummaryText) && repairCandidate !== undefined) {
+    // Every stage produced a structurally sound summary but the model
+    // deterministically refused to repeat low-signal identifiers. Restore
+    // them verbatim instead of failing the whole compaction.
+    const stillMissing = getDroppedProtectedFacts(repairCandidate, protectedFacts);
+    try {
+      finalSummaryText = validateSummaryText(
+        withRetainedIdentifiers(repairCandidate, stillMissing),
+        protectedFacts,
+      );
+      lastError = undefined;
+      retainedIdentifiersAppended = stillMissing.length;
+    } catch {
+      // Repair rejected; fall through to the original failure below.
+    }
+  }
+
   if (lastError || !finalSummaryText) {
     throw lastError ?? new Error("All smart compaction retry stages failed.");
   }
@@ -643,6 +722,7 @@ export async function runSmartCompaction(
     serializedCharacters: conversationText.length,
     summaryCharacters: finalSummary.length,
     attemptCount,
+    retainedIdentifiersAppended: retainedIdentifiersAppended > 0 ? retainedIdentifiersAppended : undefined,
     durationMs: Date.now() - startedAt,
     timestamp: Date.now(),
   };

package/extensions/subagents/src/backends/pi.ts

@@ -107,8 +107,6 @@ const CHILD_EXCLUDED_TOOL_NAMES = [
   "task",
   "reply_question",
   "workflow",
-  "create_orchestration",
-  "get_orchestration",
   "ask_user",
 ] as const;
 

package/extensions/task-list/README.md

@@ -64,7 +64,7 @@ Run:
 /tasks
 ```
 
-While work is active, the shared bounded **Active work** dock above the editor shows progress and current items alongside any live terminals, subagents, or orchestration runs without stacking separate widgets. A finished list lingers for four seconds so the final checkmark is visible, then clears from the live chrome while remaining available in session history.
+While work is active, the shared bounded **Active work** dock above the editor shows progress and current items alongside any live terminals or subagents without stacking separate widgets. A finished list lingers for four seconds so the final checkmark is visible, then clears from the live chrome while remaining available in session history.
 
 `/tasks` opens the full-width interactive dashboard:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shariq-pi-extensions",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Cross-platform extension suite for the Pi coding agent.",
   "license": "MIT",
   "author": "Shariq Riaz",
@@ -40,12 +40,9 @@
       "./extensions/ask-user/index.ts",
       "./extensions/background-terminals/index.ts",
       "./extensions/context-usage/index.ts",
-      "./extensions/copy-all/index.ts",
       "./extensions/firecrawl-web/index.ts",
-      "./extensions/git-info/index.ts",
       "./extensions/goal/index.ts",
       "./extensions/input-mode/index.ts",
-      "./extensions/orchestration/index.ts",
       "./extensions/performance-status/index.ts",
       "./extensions/shell-shortcuts/index.ts",
       "./extensions/smart-compaction/index.ts",
@@ -55,7 +52,6 @@
     ],
     "skills": [
       "./skills/background-terminals",
-      "./skills/orchestration",
       "./skills/subagents"
     ],
     "themes": [

package/extensions/copy-all/README.md

@@ -1,15 +0,0 @@
-# Copy All
-
-Copies a readable transcript of the active Pi conversation branch to the system clipboard.
-
-## Command
-
-`/copy-all` waits for the current agent run to settle, then copies visible user and assistant messages from the active branch. Messages are labeled `USER` and `ASSISTANT` and separated with a horizontal divider.
-
-The exported transcript intentionally excludes system messages, tool calls, tool results, and hidden reasoning. Image blocks are represented as `[image]`. Empty branches produce an informational notification instead of changing the clipboard.
-
-Clipboard access uses Pi's cross-platform clipboard helper. A clipboard failure is shown in the interface and does not alter the session.
-
-## Validation
-
-From the repository root, run `npm run validate`.

package/extensions/copy-all/index.ts

@@ -1,72 +0,0 @@
-import {
-  copyToClipboard,
-  type ExtensionAPI,
-} from "@earendil-works/pi-coding-agent";
-
-export function textFromMessageContent(content: unknown): string {
-  if (typeof content === "string") return content.trim();
-  if (!Array.isArray(content)) return "";
-  return content
-    .map((block) => {
-      if (!block || typeof block !== "object" || !("type" in block)) return "";
-      if (
-        block.type === "text" &&
-        "text" in block &&
-        typeof block.text === "string"
-      ) {
-        return block.text;
-      }
-      if (block.type === "image") return "[image]";
-      return "";
-    })
-    .filter(Boolean)
-    .join("\n")
-    .trim();
-}
-
-export function formatConversation(
-  messages: ReadonlyArray<{ role?: unknown; content?: unknown }>,
-): string {
-  return messages
-    .filter(
-      (message) => message.role === "user" || message.role === "assistant",
-    )
-    .map((message) => ({
-      role: String(message.role).toUpperCase(),
-      text: textFromMessageContent(message.content),
-    }))
-    .filter((message) => message.text)
-    .map((message) => `${message.role}:\n${message.text}`)
-    .join("\n\n---\n\n");
-}
-
-export default function copyAllExtension(pi: ExtensionAPI) {
-  pi.registerCommand("copy-all", {
-    description: "Copy visible user and assistant text from the current branch",
-    handler: async (_args, ctx) => {
-      await ctx.waitForIdle();
-      const messages = ctx.sessionManager
-        .getBranch()
-        .filter((entry) => entry.type === "message")
-        .map((entry) => entry.message);
-      const visibleMessages = messages.filter(
-        (message) => message.role === "user" || message.role === "assistant",
-      );
-      const transcript = formatConversation(visibleMessages);
-      if (!transcript) {
-        ctx.ui.notify("No user or assistant messages to copy", "info");
-        return;
-      }
-      try {
-        await copyToClipboard(transcript);
-      } catch (error) {
-        ctx.ui.notify(
-          `Could not copy the conversation: ${error instanceof Error ? error.message : String(error)}`,
-          "error",
-        );
-        return;
-      }
-      ctx.ui.notify(`Copied ${visibleMessages.length} branch messages`, "info");
-    },
-  });
-}

package/extensions/git-info/README.md

@@ -1,25 +0,0 @@
-# Git Info
-
-Shows the current Git branch and working-tree state in Pi and provides an interactive changed-file viewer.
-
-## Interface and commands
-
-- The footer status displays the branch, changed-file count, and open pull-request number when known.
-- `/lg` opens a TUI browser for changed and untracked files, line counts, and bounded textual diffs.
-- `/pr` refreshes pull-request information for the current branch and reports its URL.
-
-Status refreshes after user input and tool execution, with debounce and stale-result protection. Outside a Git repository, the footer is hidden and commands return a clear notice.
-
-## Dependencies and limits
-
-- Requires `git` for repository status and diffs.
-- `/pr` additionally requires an authenticated GitHub CLI (`gh`); unavailable or non-open pull requests are treated as no matching open pull request.
-- The changed-file viewer loads at most 250 files and bounds each textual diff to 20,000 lines.
-- Binary file statistics may be unavailable and are displayed without fabricated counts.
-- Repository paths and command output are sanitized before TUI rendering.
-
-The extension reads repository state only. It does not stage, commit, push, or modify files.
-
-## Validation
-
-From the repository root, run `npm run validate`.

package/extensions/git-info/index.ts

@@ -1,160 +0,0 @@
-import {
-  BorderedLoader,
-  type ExtensionAPI,
-  type ExtensionContext,
-  type ExtensionUIContext,
-} from "@earendil-works/pi-coding-agent";
-import {
-  loadChangedFiles,
-  loadGitSummary,
-  loadPullRequest,
-  type GitSummary,
-} from "./src/git.ts";
-import { openGitChanges } from "./src/ui.ts";
-
-const STATUS_KEY = "git-info";
-const REFRESH_DEBOUNCE_MS = 150;
-
-function statusText(ui: ExtensionUIContext, summary: GitSummary): string | undefined {
-  if (!summary.isRepository || !summary.branch) return undefined;
-  const changed = summary.changedFiles === 0
-    ? ui.theme.fg("muted", "✓")
-    : ui.theme.fg("warning", `+${summary.changedFiles}`);
-  const pr = summary.pullRequest
-    ? ` · ${ui.theme.fg("accent", `PR #${summary.pullRequest.number}${summary.pullRequest.draft ? " draft" : ""}`)}`
-    : "";
-  const command = summary.changedFiles > 0 || summary.pullRequest ? ` · ${ui.theme.fg("dim", "/lg")}` : "";
-  return `${ui.theme.fg("muted", "git")} ${ui.theme.fg("accent", summary.branch)} ${changed}${pr}${command}`;
-}
-
-export default function gitInfoExtension(pi: ExtensionAPI) {
-  let ui: ExtensionUIContext | undefined;
-  let summary: GitSummary = { isRepository: false, changedFiles: 0 };
-  let generation = 0;
-  let refreshTimer: ReturnType<typeof setTimeout> | undefined;
-  let refreshSequence = 0;
-
-  const publish = () => ui?.setStatus(STATUS_KEY, statusText(ui, summary));
-
-  const refresh = async (ctx: ExtensionContext, expectedGeneration: number) => {
-    const sequence = ++refreshSequence;
-    try {
-      const next = await loadGitSummary(pi, ctx.cwd);
-      if (generation !== expectedGeneration || sequence !== refreshSequence) return;
-      const sameBranch = next.branch && next.branch === summary.branch;
-      summary = {
-        ...next,
-        pullRequest: sameBranch ? summary.pullRequest : undefined,
-      };
-      publish();
-    } catch {
-      if (generation === expectedGeneration && sequence === refreshSequence) {
-        summary = { isRepository: false, changedFiles: 0 };
-        publish();
-      }
-    }
-  };
-
-  const scheduleRefresh = (ctx: ExtensionContext) => {
-    if (!ui) return;
-    const expectedGeneration = generation;
-    if (refreshTimer) clearTimeout(refreshTimer);
-    refreshTimer = setTimeout(() => {
-      refreshTimer = undefined;
-      void refresh(ctx, expectedGeneration);
-    }, REFRESH_DEBOUNCE_MS);
-    refreshTimer.unref?.();
-  };
-
-  pi.on("session_start", (_event, ctx) => {
-    generation++;
-    summary = { isRepository: false, changedFiles: 0 };
-    if (ctx.hasUI) ui = ctx.ui;
-    void refresh(ctx, generation);
-  });
-  pi.on("input", (_event, ctx) => {
-    scheduleRefresh(ctx);
-    return { action: "continue" };
-  });
-  pi.on("tool_execution_end", (_event, ctx) => scheduleRefresh(ctx));
-  pi.on("session_shutdown", () => {
-    generation++;
-    refreshSequence++;
-    if (refreshTimer) clearTimeout(refreshTimer);
-    refreshTimer = undefined;
-    ui?.setStatus(STATUS_KEY, undefined);
-    ui = undefined;
-  });
-
-  pi.registerCommand("lg", {
-    description: "Browse changed files and diffs in the current Git repository",
-    handler: async (_args, ctx) => {
-      if (ctx.mode !== "tui") {
-        if (ctx.hasUI) ctx.ui.notify("The Git changes viewer requires the TUI", "warning");
-        return;
-      }
-      type LoadOutcome =
-        | { loaded: Awaited<ReturnType<typeof loadChangedFiles>> }
-        | { error: string }
-        | null;
-      const outcome = await ctx.ui.custom<LoadOutcome>((tui, theme, _keybindings, done) => {
-        const loader = new BorderedLoader(tui, theme, "Loading Git changes…");
-        let settled = false;
-        const finish = (value: LoadOutcome) => {
-          if (settled) return;
-          settled = true;
-          done(value);
-        };
-        loader.onAbort = () => finish(null);
-        loadChangedFiles(pi, ctx.cwd, loader.signal).then(
-          (loaded) => finish({ loaded }),
-          (error: unknown) => {
-            if (loader.signal.aborted) finish(null);
-            else finish({ error: error instanceof Error ? error.message : String(error) });
-          },
-        );
-        return loader;
-      });
-      if (!outcome) {
-        ctx.ui.notify("Git changes load cancelled", "info");
-        return;
-      }
-      if ("error" in outcome) {
-        ctx.ui.notify(`Could not load Git changes: ${outcome.error}`, "error");
-        return;
-      }
-      const { loaded } = outcome;
-      if (!loaded) {
-        ctx.ui.notify("Not a Git repository", "warning");
-        return;
-      }
-      if (loaded.files.length === 0) {
-        ctx.ui.notify("Working tree is clean", "info");
-        return;
-      }
-      await openGitChanges(ctx, loaded.root, loaded.files, loaded.omitted);
-    },
-  });
-
-  pi.registerCommand("pr", {
-    description: "Refresh pull-request information for the current branch",
-    handler: async (_args, ctx) => {
-      const next = await loadGitSummary(pi, ctx.cwd);
-      if (!next.isRepository) {
-        ctx.ui.notify("Not a Git repository", "warning");
-        return;
-      }
-      const pullRequest = await loadPullRequest(pi, next.root ?? ctx.cwd);
-      summary = { ...next, pullRequest };
-      publish();
-      if (!pullRequest) {
-        ctx.ui.notify(`No open pull request found for ${next.branch ?? "this branch"}`, "info");
-        return;
-      }
-      ctx.ui.notify(
-        `PR #${pullRequest.number}${pullRequest.draft ? " (draft)" : ""}: ${pullRequest.url}`,
-        "info",
-      );
-    },
-  });
-}