@pi-harness/pi-harness 0.1.13 → 0.1.15

package/packages/core/src/plugins/dependency-checker.ts

@@ -1,241 +0,0 @@
-import { readdir, readFile, stat } from "node:fs/promises";
-import { basename, dirname, join, relative } from "node:path";
-import type { Context } from "@deepseek-ai/cordis";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-import { resolveExistingWorkspacePath } from "../workspace-path.js";
-
-export type DependencyConflict = {
-  name: string;
-  constraints: string[];
-};
-
-export type DependencyReport = {
-  manifest: string;
-  ecosystem: "npm" | "python";
-  declared: number;
-  installed: number;
-  missing: string[];
-  invalid: string[];
-  conflicts: DependencyConflict[];
-};
-
-export type ParsedRequirements = {
-  names: string[];
-  constraints: DependencyConflict[];
-};
-
-function conflictList(entries: readonly { name: string; constraint: string }[]): DependencyConflict[] {
-  const grouped = new Map<string, string[]>();
-  for (const entry of entries) {
-    const values = grouped.get(entry.name) ?? [];
-    if (!values.includes(entry.constraint)) values.push(entry.constraint);
-    grouped.set(entry.name, values);
-  }
-  return [...grouped.entries()].filter(([, constraints]) => constraintsConflict(constraints)).map(([name, constraints]) => ({ name, constraints }));
-}
-
-type NumericVersion = readonly number[];
-
-function numericVersion(value: string): NumericVersion | undefined {
-  const match = /^v?(\d+(?:\.\d+){0,3})(?:[-+].*)?$/u.exec(value.trim());
-  return match?.[1]?.split(".").map(Number);
-}
-
-function compareVersions(left: NumericVersion, right: NumericVersion): number {
-  for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
-    const difference = (left[index] ?? 0) - (right[index] ?? 0);
-    if (difference !== 0) return Math.sign(difference);
-  }
-  return 0;
-}
-
-function constraintAllows(constraint: string, version: NumericVersion): boolean {
-  const parts = constraint
-    .split(",")
-    .map((part) => part.trim())
-    .filter(Boolean);
-  return parts.every((part) => {
-    const match = /^(===|==|=|>=|<=|>|<|\^|~)?\s*(v?\d+(?:\.\d+){0,3}(?:[-+][^\s]+)?)$/u.exec(part);
-    if (match === null) return true;
-    const candidate = numericVersion(match[2] ?? "");
-    if (candidate === undefined) return true;
-    const comparison = compareVersions(version, candidate);
-    switch (match[1] ?? "=") {
-      case ">=":
-        return comparison >= 0;
-      case "<=":
-        return comparison <= 0;
-      case ">":
-        return comparison > 0;
-      case "<":
-        return comparison < 0;
-      case "^":
-        return (
-          comparison >= 0 &&
-          version[0] === candidate[0] &&
-          ((candidate[0] ?? 0) > 0 || (version[1] === candidate[1] && ((candidate[1] ?? 0) > 0 || version[2] === candidate[2])))
-        );
-      case "~":
-        return comparison >= 0 && version[0] === candidate[0] && version[1] === candidate[1];
-      default:
-        return comparison === 0;
-    }
-  });
-}
-
-function constraintsConflict(constraints: readonly string[]): boolean {
-  if (constraints.length < 2) return false;
-  const pinned = constraints.flatMap((constraint) => {
-    const match = /^(?:===|==|=)?\s*(v?\d+(?:\.\d+){0,3}(?:[-+][^\s]+)?)$/u.exec(constraint);
-    const version = match === null ? undefined : numericVersion(match[1] ?? "");
-    return version === undefined ? [] : [version];
-  });
-  if (pinned.length === 0) return false;
-  return pinned.some((version) => constraints.some((constraint) => !constraintAllows(constraint, version)));
-}
-
-export function parseRequirements(source: string): ParsedRequirements {
-  const entries: { name: string; constraint: string }[] = [];
-  for (const rawLine of source.split("\n")) {
-    const line = rawLine.trim();
-    if (line === "" || line.startsWith("#") || line.startsWith("-") || line.startsWith("git+") || line.startsWith("http://") || line.startsWith("https://"))
-      continue;
-    const match = /^([A-Za-z0-9][A-Za-z0-9._-]*)(?:\[[^\]]+\])?\s*(.*)$/u.exec(line);
-    if (!match) continue;
-    const name = match[1]!.toLowerCase().replaceAll("_", "-");
-    entries.push({ name, constraint: match[2]?.trim() ?? "" });
-  }
-  const names = [...new Set(entries.map((entry) => entry.name))];
-  return { names, constraints: conflictList(entries) };
-}
-
-async function installedPythonPackage(workspace: string, name: string): Promise<boolean> {
-  const normalized = name.toLowerCase().replaceAll("-", "_");
-  for (const environment of [".venv", "venv"]) {
-    const lib = join(workspace, environment, "lib");
-    const versions = await readdir(lib, { withFileTypes: true }).catch(() => []);
-    for (const version of versions) {
-      if (!version.isDirectory() || !version.name.startsWith("python")) continue;
-      const sitePackages = join(lib, version.name, "site-packages");
-      const entries = await readdir(sitePackages, { withFileTypes: true }).catch(() => []);
-      if (entries.some((entry) => entry.name === normalized || entry.name.startsWith(`${normalized}-`) || entry.name.startsWith(`${normalized}.`))) return true;
-    }
-  }
-  return false;
-}
-
-async function inspectRequirements(workspace: string, target: string): Promise<DependencyReport> {
-  const parsed = parseRequirements(await readFile(target, "utf8"));
-  const missing: string[] = [];
-  for (const name of parsed.names) {
-    if (!(await installedPythonPackage(dirname(target), name)) && !(await installedPythonPackage(workspace, name))) missing.push(name);
-  }
-  return {
-    manifest: relative(workspace, target) || ".",
-    ecosystem: "python",
-    declared: parsed.names.length,
-    installed: parsed.names.length - missing.length,
-    missing,
-    invalid: [],
-    conflicts: parsed.constraints,
-  };
-}
-
-export async function inspectManifest(workspace: string, requested = "package.json"): Promise<DependencyReport> {
-  const resolved = await resolveExistingWorkspacePath(workspace, requested, "Manifest path must stay inside the current workspace");
-  const target = resolved.target;
-  workspace = resolved.root;
-  const source = await readFile(target, "utf8");
-  if (basename(target).toLowerCase().startsWith("requirements") && target.toLowerCase().endsWith(".txt")) return inspectRequirements(workspace, target);
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(source) as unknown;
-  } catch (error) {
-    throw new Error(`Invalid JSON manifest: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-  }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("Manifest root must be an object");
-  const record = parsed as Record<string, unknown>;
-  const sections = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
-  const entries = sections.flatMap((section) => {
-    const value = record[section];
-    return value !== null && typeof value === "object" && !Array.isArray(value)
-      ? Object.entries(value).map(([name, constraint]) => ({ name, constraint: typeof constraint === "string" ? constraint : String(constraint) }))
-      : [];
-  });
-  const unique = [...new Set(entries.map((entry) => entry.name))];
-  const moduleRoots: string[] = [];
-  for (let directory = dirname(target); ; directory = dirname(directory)) {
-    moduleRoots.push(join(directory, "node_modules"));
-    if (directory === workspace) break;
-  }
-  const missing: string[] = [];
-  const invalid: string[] = [];
-  for (const name of unique) {
-    let found = false;
-    for (const moduleRoot of moduleRoots) {
-      try {
-        const moduleStat = await stat(join(moduleRoot, ...name.split("/")));
-        if (moduleStat.isDirectory()) {
-          found = true;
-          break;
-        }
-        invalid.push(name);
-        found = true;
-        break;
-      } catch {
-        continue;
-      }
-    }
-    if (!found) missing.push(name);
-  }
-  return {
-    manifest: relative(workspace, target) || ".",
-    ecosystem: "npm",
-    declared: unique.length,
-    installed: unique.length - missing.length - invalid.length,
-    missing,
-    invalid,
-    conflicts: conflictList(entries),
-  };
-}
-
-export default {
-  name: "pi-dependency-checker",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    let latest: DependencyReport | undefined;
-    const inspect = async (manifest?: string): Promise<DependencyReport> => {
-      latest = await inspectManifest(context.piHarnessLaunch.cwd, manifest);
-      return latest;
-    };
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "dependency_check",
-        label: "Dependency check",
-        description: "Inspect package.json or requirements.txt and report missing dependencies plus conflicting version constraints.",
-        promptSnippet: "check local dependency installation and version conflicts",
-        parameters: Type.Object({ manifest: Type.Optional(Type.String({ description: "package.json or requirements.txt path relative to the workspace" })) }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<DependencyReport>> {
-          const report = await inspect(params.manifest);
-          return {
-            content: [{ type: "text", text: `${report.manifest}: ${report.missing.length} missing dependencies, ${report.conflicts.length} conflicts.` }],
-            details: report,
-          };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "dependency-checker-panel",
-      pluginId: "@pi-harness/core/plugins/dependency-checker",
-      title: "Dependency Checker",
-      description: "检查 package.json 或 requirements.txt 的依赖安装状态和版本冲突。",
-      icon: "⊙",
-      read: async () => ({ report: latest ?? (await inspect()) }),
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/docker-sandbox.ts

@@ -1,100 +0,0 @@
-import { execFile } from "node:child_process";
-import { basename } from "node:path";
-import { promisify } from "node:util";
-import type { Context } from "@deepseek-ai/cordis";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-const execFileAsync = promisify(execFile);
-const shellCommands = new Set(["sh", "bash", "zsh", "fish", "cmd", "powershell", "pwsh"]);
-type SandboxRun = { image: string; command: string[]; write: boolean; exitCode: number; output: string };
-
-function validateImage(image: string): void {
-  if (!/^[a-zA-Z0-9][a-zA-Z0-9._/@:-]*$/.test(image)) throw new Error("Invalid Docker image reference");
-}
-
-export default {
-  name: "pi-docker-sandbox",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    let latest: SandboxRun | undefined;
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "sandbox_exec",
-        label: "Docker sandbox",
-        description: "Run an argv command in a no-network Docker container with the workspace mounted read-only by default.",
-        promptSnippet: "run a command in an isolated no-network Docker sandbox",
-        parameters: Type.Object({
-          command: Type.Array(Type.String(), { description: "Executable and arguments; shell wrappers are rejected" }),
-          image: Type.Optional(Type.String({ description: "Local Docker image, default alpine:3.20" })),
-          write: Type.Optional(Type.Boolean({ description: "Mount the workspace read-write" })),
-          confirmWrite: Type.Optional(Type.Boolean({ description: "Must be true when write is enabled" })),
-        }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<SandboxRun>> {
-          if (params.command.length === 0) throw new Error("Sandbox command cannot be empty");
-          const executable = params.command[0];
-          if (executable === undefined) throw new Error("Sandbox command cannot be empty");
-          if (shellCommands.has(basename(executable).toLowerCase())) throw new Error("Shell wrappers are not allowed; pass an executable argv directly");
-          const image = params.image?.trim() || "alpine:3.20";
-          validateImage(image);
-          const write = params.write === true;
-          if (write && params.confirmWrite !== true) throw new Error("Writable sandbox requires confirmWrite=true");
-          try {
-            await execFileAsync("docker", ["image", "inspect", image], { timeout: 30_000, maxBuffer: 1_000_000 });
-          } catch (error) {
-            const failure = error as { code?: number | string; message?: string };
-            if (failure.code === "ENOENT") throw new Error("Docker executable is not available on PATH", { cause: error });
-            throw new Error(`Docker image is not available locally: ${image}`, { cause: error });
-          }
-          const args = [
-            "run",
-            "--rm",
-            "--network",
-            "none",
-            "--read-only",
-            "--tmpfs",
-            "/tmp:rw,noexec,nosuid",
-            "--cap-drop",
-            "ALL",
-            "--security-opt",
-            "no-new-privileges",
-            "--pids-limit",
-            "256",
-            "--mount",
-            `type=bind,src=${context.piHarnessLaunch.cwd},dst=/workspace${write ? "" : ",readonly"}`,
-            "--workdir",
-            "/workspace",
-            image,
-            ...params.command,
-          ];
-          try {
-            const result = await execFileAsync("docker", args, { cwd: context.piHarnessLaunch.cwd, timeout: 120_000, maxBuffer: 4 * 1024 * 1024 });
-            latest = { image, command: [...params.command], write, exitCode: 0, output: `${result.stdout}${result.stderr}`.slice(-12_000) };
-          } catch (error) {
-            const failure = error as { code?: number | string; stdout?: string; stderr?: string; message?: string };
-            latest = {
-              image,
-              command: [...params.command],
-              write,
-              exitCode: typeof failure.code === "number" ? failure.code : 1,
-              output: `${failure.stdout ?? ""}${failure.stderr ?? failure.message ?? ""}`.slice(-12_000),
-            };
-          }
-          return { content: [{ type: "text", text: `Docker sandbox exited with ${latest.exitCode}.\n${latest.output}` }], details: latest };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "docker-sandbox-panel",
-      pluginId: "@pi-harness/core/plugins/docker-sandbox",
-      title: "Docker Sandbox",
-      description: "无网络、只读挂载、去除 Linux capabilities 的隔离执行环境。",
-      icon: "⬡",
-      read: () => ({ latest: latest ?? null, defaults: { network: "none", workspace: "read-only", image: "alpine:3.20" } }),
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/fail-logger.ts

@@ -1,51 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-
-type Failure = { time: string; source: string; message: string };
-
-function messageOf(error: unknown): string {
-  if (error instanceof Error) return error.message;
-  if (typeof error === "object" && error !== null && "error" in error) {
-    const { error: message, extensionPath } = error as { error: unknown; extensionPath?: unknown };
-    const text = typeof message === "string" ? message : String(message);
-    return typeof extensionPath === "string" ? `${extensionPath}: ${text}` : text;
-  }
-  return typeof error === "string" ? error : (JSON.stringify(error) ?? String(error));
-}
-
-export default {
-  name: "pi-fail-logger",
-  inject: ["piPluginUi"],
-  apply(context: Context) {
-    const failures: Failure[] = [];
-    let previous: string | undefined;
-    const record = (source: string, error: unknown): void => {
-      const message = messageOf(error);
-      const fingerprint = `${source}:${message}`;
-      if (fingerprint === previous) return;
-      previous = fingerprint;
-      failures.push({ time: new Date().toISOString(), source, message });
-      if (failures.length > 50) failures.shift();
-    };
-    const unsubscribeExtension = context.on("pi/extension-error", (error) => record("extension", error));
-    const unsubscribeSession = context.on("pi/session-event", (event) => {
-      const last = event.type === "agent_end" ? event.messages.at(-1) : undefined;
-      if (last?.role === "assistant" && last.stopReason === "error") {
-        record("agent", last.errorMessage ?? "Agent turn failed");
-      }
-      if (event.type === "compaction_end" && event.errorMessage) record("compaction", event.errorMessage);
-    });
-    const disposePanel = context.piPluginUi.register({
-      id: "fail-logger-panel",
-      pluginId: "@pi-harness/core/plugins/fail-logger",
-      title: "Failure Logger",
-      description: "集中记录扩展、Agent 和上下文压缩错误，并去重重复故障。",
-      icon: "!",
-      read: () => ({ total: failures.length, failures: [...failures].reverse() }),
-    });
-    context.effect(() => () => {
-      unsubscribeExtension();
-      unsubscribeSession();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/genui.ts

@@ -1,88 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-const maxBlocks = 12;
-const maxTextLength = 4000;
-type BlockType = "text" | "badge" | "progress";
-type Tone = "neutral" | "info" | "success" | "warning" | "danger";
-type GenUiBlock = { type: BlockType; label: string; value: string | number; tone: Tone };
-type GenUiReport = { title: string; blocks: GenUiBlock[]; renderedAt: string };
-
-function cleanText(value: string, field: string): string {
-  const text = value.trim();
-  if (text.length === 0) throw new Error(`${field} must not be empty`);
-  if (text.length > maxTextLength) throw new Error(`${field} must be at most ${maxTextLength} characters`);
-  return text;
-}
-
-function normalizeBlock(block: { type: BlockType; label: string; value: string; tone?: Tone }): GenUiBlock {
-  const label = cleanText(block.label, "Block label");
-  const rawValue = cleanText(block.value, "Block value");
-  if (block.type !== "progress") return { type: block.type, label, value: rawValue, tone: block.tone ?? "neutral" };
-  const value = Number(rawValue);
-  if (!Number.isFinite(value) || value < 0 || value > 100) throw new Error("Progress value must be a number from 0 to 100");
-  return { type: "progress", label, value, tone: block.tone ?? "info" };
-}
-
-export default {
-  name: "pi-genui",
-  inject: ["piPluginUi", "piTools"],
-  apply(context: Context) {
-    let rendered = 0;
-    let latest: GenUiReport | undefined;
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "genui_render",
-        label: "Render structured UI",
-        description: "Render safe structured text, badge, and progress blocks in the GenUI panel; HTML and scripts are treated as plain text.",
-        promptSnippet: "render a structured status card for the user",
-        parameters: Type.Object({
-          title: Type.String(),
-          blocks: Type.Array(
-            Type.Object({
-              type: Type.Union(["text", "badge", "progress"]),
-              label: Type.String(),
-              value: Type.String(),
-              tone: Type.Optional(Type.Union(["neutral", "info", "success", "warning", "danger"])),
-            }),
-          ),
-        }),
-        execute(_toolCallId, params): Promise<AgentToolResult<GenUiReport>> {
-          return Promise.resolve().then(() => {
-            if (params.blocks.length === 0 || params.blocks.length > maxBlocks) throw new Error(`GenUI requires 1 to ${maxBlocks} blocks`);
-            latest = {
-              title: cleanText(params.title, "Title"),
-              blocks: params.blocks.map((block) =>
-                normalizeBlock({
-                  type: block.type as BlockType,
-                  label: block.label,
-                  value: block.value,
-                  ...(block.tone === undefined ? {} : { tone: block.tone as Tone }),
-                }),
-              ),
-              renderedAt: new Date().toISOString(),
-            };
-            rendered += 1;
-            return {
-              content: [{ type: "text" as const, text: `Rendered ${latest.blocks.length} structured UI block(s): ${latest.title}` }],
-              details: latest,
-            };
-          });
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "genui-panel",
-      pluginId: "@pi-harness/core/plugins/genui",
-      title: "GenUI",
-      description: "渲染安全的结构化状态卡片；文本中的 HTML 和脚本不会被执行。",
-      icon: "▤",
-      read: () => ({ rendered, latest: latest ?? null }),
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/git-time-capsule.ts

@@ -1,97 +0,0 @@
-import { execFile } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { mkdir, readdir, stat, writeFile } from "node:fs/promises";
-import { promisify } from "node:util";
-import { basename, join } from "node:path";
-import type { Context } from "@deepseek-ai/cordis";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-const execFileAsync = promisify(execFile);
-const capsuleDirectory = "capsules";
-
-async function git(cwd: string, args: readonly string[]): Promise<string> {
-  const result = await execFileAsync("git", [...args], { cwd, maxBuffer: 8 * 1024 * 1024 });
-  return result.stdout;
-}
-
-export async function applyCapsule(cwd: string, capsulePath: string): Promise<void> {
-  try {
-    await git(cwd, ["apply", "--reverse", "--check", "--binary", capsulePath]);
-  } catch (cause) {
-    throw new Error("Git capsule does not apply cleanly", { cause });
-  }
-  await git(cwd, ["apply", "--reverse", "--binary", capsulePath]);
-}
-
-async function listCapsules(directory: string): Promise<{ name: string; bytes: number }[]> {
-  const names = (await readdir(directory).catch(() => [] as string[]))
-    .filter((name) => name.endsWith(".patch"))
-    .sort()
-    .reverse()
-    .slice(0, 20);
-  return Promise.all(names.map(async (name) => ({ name, bytes: (await stat(join(directory, name))).size })));
-}
-
-export default {
-  name: "pi-git-time-capsule",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    const directory = join(context.piHarnessLaunch.agentDir, capsuleDirectory);
-    let latest: { name: string; bytes: number; files: number; restored?: boolean } | undefined;
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "git_snapshot",
-        label: "Git snapshot",
-        description: "Save the current tracked Git diff as a timestamped patch outside the workspace for rollback or review.",
-        promptSnippet: "save a rollback patch before changing code",
-        parameters: Type.Object({}),
-        async execute(): Promise<AgentToolResult<{ path: string; bytes: number; files: number }>> {
-          const status = await git(context.piHarnessLaunch.cwd, ["status", "--short"]);
-          const patch = await git(context.piHarnessLaunch.cwd, ["diff", "HEAD", "--binary", "--no-ext-diff", "--", ".", ":(exclude).pi-harness/capsules"]);
-          await mkdir(directory, { recursive: true });
-          const timestamp = new Date().toISOString().replace(/[-:.]/g, "");
-          const name = `${timestamp}-${randomUUID().slice(0, 8)}.patch`;
-          const path = join(directory, name);
-          await writeFile(path, patch, { encoding: "utf8", mode: 0o600, flag: "wx" });
-          const files = status.split("\n").filter((line) => line.trim() !== "" && !line.startsWith("??")).length;
-          latest = { name, bytes: Buffer.byteLength(patch), files };
-          return { content: [{ type: "text", text: `Git snapshot saved: ${name}` }], details: { path, bytes: latest.bytes, files } };
-        },
-      }),
-    );
-    const unregisterRestore = context.piTools.register(
-      defineTool({
-        name: "git_restore",
-        label: "Restore Git snapshot",
-        description: "Apply a saved Git time capsule after an explicit confirmation; the patch is checked before it changes the workspace.",
-        promptSnippet: "restore a previously saved Git snapshot",
-        parameters: Type.Object({ name: Type.String({ description: "Capsule filename from the recent snapshots list" }), confirm: Type.Boolean() }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<{ name: string; restored: true }>> {
-          if (!params.confirm) throw new Error("Git capsule restore writes the workspace and requires confirm=true");
-          const name = params.name.trim();
-          if (name.length === 0 || name.length > 255 || basename(name) !== name || !name.endsWith(".patch"))
-            throw new Error("Capsule name must be a .patch filename");
-          const path = join(directory, name);
-          await applyCapsule(context.piHarnessLaunch.cwd, path);
-          const bytes = (await stat(path)).size;
-          latest = { name, bytes, files: 0, restored: true };
-          return { content: [{ type: "text", text: `Git snapshot restored: ${name}` }], details: { name, restored: true } };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "git-time-capsule-panel",
-      pluginId: "@pi-harness/core/plugins/git-time-capsule",
-      title: "Git Time Capsule",
-      description: "查看最近的代码快照；快照保存在工作区之外，不会污染项目文件。",
-      icon: "◫",
-      read: async () => ({ latest: latest ?? null, capsules: await listCapsules(directory) }),
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      unregisterRestore();
-      disposePanel();
-    });
-  },
-};