@pi-harness/pi-harness 0.1.13 → 0.1.15

package/packages/core/src/plugins/agent-teams.ts

@@ -1,291 +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 customType = "pi-harness/agent-teams";
-export type TeamTask = { id: string; title: string; assignee: string; status: string; dependsOn: string[] };
-type TeamMessage = { id: string; from: string; to: string; body: string; timestamp: string; read: boolean };
-type TeamState = {
-  members: { id: string; name: string; role: string; status: string }[];
-  tasks: TeamTask[];
-  messages: TeamMessage[];
-};
-
-export function dependencyCycle(tasks: readonly TeamTask[]): string[] | null {
-  const byId = new Map(tasks.map((task) => [task.id, task]));
-  const visiting = new Set<string>();
-  const visited = new Set<string>();
-  const path: string[] = [];
-  const visit = (id: string): string[] | null => {
-    if (visiting.has(id)) {
-      const start = path.indexOf(id);
-      return start >= 0 ? [...path.slice(start), id] : [id, id];
-    }
-    if (visited.has(id)) return null;
-    const task = byId.get(id);
-    if (task === undefined) {
-      visited.add(id);
-      return null;
-    }
-    visiting.add(id);
-    path.push(id);
-    for (const dependency of task.dependsOn) {
-      const cycle = visit(dependency);
-      if (cycle !== null) return cycle;
-    }
-    path.pop();
-    visiting.delete(id);
-    visited.add(id);
-    return null;
-  };
-  for (const task of tasks) {
-    const cycle = visit(task.id);
-    if (cycle !== null) return cycle;
-  }
-  return null;
-}
-
-export function readyTeamTasks(tasks: readonly TeamTask[]): TeamTask[] {
-  const completed = new Set(tasks.filter((task) => task.status === "done").map((task) => task.id));
-  return tasks.filter((task) => task.status === "todo" && task.dependsOn.every((dependency) => completed.has(dependency)));
-}
-
-const initialState = (): TeamState => ({
-  members: [
-    { id: "planner", name: "Planner", role: "拆解任务", status: "idle" },
-    { id: "builder", name: "Builder", role: "实现改动", status: "idle" },
-    { id: "reviewer", name: "Reviewer", role: "验证结果", status: "idle" },
-  ],
-  tasks: [],
-  messages: [],
-});
-
-function readState(context: Context): TeamState {
-  const entries = context.piSession.manager.getEntries();
-  const entry = [...entries].reverse().find((item) => item.type === "custom" && item.customType === customType);
-  if (entry?.type !== "custom" || entry.data === undefined) return initialState();
-  const value = entry.data as Partial<TeamState>;
-  if (!Array.isArray(value.members) || !Array.isArray(value.tasks)) return initialState();
-  const tasks = value.tasks.map((task, index) => {
-    const item = task as Partial<TeamTask>;
-    return {
-      id: typeof item.id === "string" && item.id.trim() !== "" ? item.id : `task-${index + 1}`,
-      title: typeof item.title === "string" ? item.title : "未命名任务",
-      assignee: typeof item.assignee === "string" ? item.assignee : "unassigned",
-      status: typeof item.status === "string" ? item.status : "todo",
-      dependsOn: Array.isArray(item.dependsOn) ? item.dependsOn.filter((id): id is string => typeof id === "string" && id.trim() !== "") : [],
-    };
-  });
-  const messages = Array.isArray(value.messages)
-    ? value.messages.flatMap((message, index) => {
-        const item = message as Partial<TeamMessage>;
-        if (typeof item.from !== "string" || typeof item.to !== "string" || typeof item.body !== "string") return [];
-        return [
-          {
-            id: typeof item.id === "string" && item.id.trim() !== "" ? item.id : `message-${index + 1}`,
-            from: item.from,
-            to: item.to,
-            body: item.body,
-            timestamp: typeof item.timestamp === "string" ? item.timestamp : new Date(0).toISOString(),
-            read: item.read === true,
-          },
-        ];
-      })
-    : [];
-  return structuredClone({ members: value.members, tasks, messages });
-}
-
-function persist(context: Context, state: TeamState): void {
-  context.piSession.manager.appendCustomEntry(customType, state);
-}
-
-function refreshTaskReadiness(state: TeamState): void {
-  const completed = new Set(state.tasks.filter((task) => task.status === "done").map((task) => task.id));
-  for (const task of state.tasks) {
-    if (task.status === "blocked" && task.dependsOn.every((id) => completed.has(id))) task.status = "todo";
-    if ((task.status === "todo" || task.status === "blocked") && task.dependsOn.some((id) => !completed.has(id))) task.status = "blocked";
-  }
-}
-
-function syncMemberStatuses(state: TeamState): void {
-  const activeAssignees = new Set(state.tasks.filter((task) => task.status === "in_progress").map((task) => task.assignee));
-  for (const member of state.members) {
-    if (member.status === "working" || activeAssignees.has(member.id)) member.status = activeAssignees.has(member.id) ? "working" : "idle";
-  }
-}
-
-function nextReadyTask(state: TeamState, assignee: string): TeamTask {
-  refreshTaskReadiness(state);
-  const task = readyTeamTasks(state.tasks)[0];
-  if (task === undefined) throw new Error("No ready team task is available");
-  task.status = "in_progress";
-  task.assignee = assignee || task.assignee;
-  return task;
-}
-
-export default {
-  name: "pi-agent-teams",
-  inject: ["piSession", "piTools", "piPluginUi"],
-  apply(context: Context) {
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "team_task",
-        label: "Team task",
-        description: "Create or update durable agent-team members, tasks, and mailbox messages in the current Pi session.",
-        promptSnippet: "manage durable team members, tasks, and mailbox messages",
-        parameters: Type.Object({
-          action: Type.String({ description: "add_task, update_task, claim_task, add_member, send_message, or read_messages" }),
-          id: Type.Optional(Type.String()),
-          title: Type.Optional(Type.String()),
-          assignee: Type.Optional(Type.String()),
-          name: Type.Optional(Type.String()),
-          role: Type.Optional(Type.String()),
-          status: Type.Optional(Type.String()),
-          dependsOn: Type.Optional(Type.Array(Type.String())),
-          from: Type.Optional(Type.String()),
-          to: Type.Optional(Type.String()),
-          body: Type.Optional(Type.String()),
-          unreadOnly: Type.Optional(Type.Boolean()),
-        }),
-        execute(_toolCallId, params): Promise<AgentToolResult<unknown>> {
-          return Promise.resolve().then(() => {
-            const state = readState(context);
-            if (params.action === "add_task") {
-              const title = params.title?.trim();
-              if (!title) throw new Error("title is required when action is add_task");
-              const id = params.id?.trim() || `task-${state.tasks.length + 1}`;
-              if (state.tasks.some((item) => item.id === id)) throw new Error(`Task already exists: ${id}`);
-              const dependsOn = [...new Set((params.dependsOn ?? []).map((item) => item.trim()).filter(Boolean))];
-              if (dependsOn.includes(id)) throw new Error("A task cannot depend on itself");
-              if (dependsOn.some((dependency) => !state.tasks.some((item) => item.id === dependency)))
-                throw new Error("All task dependencies must already exist");
-              const task = {
-                id,
-                title,
-                assignee: params.assignee?.trim() || "unassigned",
-                status: params.status?.trim() || "todo",
-                dependsOn,
-              };
-              state.tasks.push(task);
-              const cycle = dependencyCycle(state.tasks);
-              if (cycle !== null) {
-                state.tasks.pop();
-                throw new Error(`Task dependency cycle detected: ${cycle.join(" → ")}`);
-              }
-              refreshTaskReadiness(state);
-              syncMemberStatuses(state);
-              persist(context, state);
-              return { content: [{ type: "text" as const, text: `Task ${task.id} created.` }], details: { kind: "task", item: task } };
-            }
-            if (params.action === "update_task") {
-              const task = state.tasks.find((item) => item.id === params.id);
-              if (!task) throw new Error(`Task not found: ${params.id ?? ""}`);
-              if (params.title?.trim()) task.title = params.title.trim();
-              if (params.assignee?.trim()) task.assignee = params.assignee.trim();
-              if (params.dependsOn !== undefined) {
-                const dependsOn = [...new Set(params.dependsOn.map((item) => item.trim()).filter(Boolean))];
-                if (dependsOn.includes(task.id)) throw new Error("A task cannot depend on itself");
-                if (dependsOn.some((dependency) => !state.tasks.some((item) => item.id === dependency)))
-                  throw new Error("All task dependencies must already exist");
-                const previous = task.dependsOn;
-                task.dependsOn = dependsOn;
-                const cycle = dependencyCycle(state.tasks);
-                if (cycle !== null) {
-                  task.dependsOn = previous;
-                  throw new Error(`Task dependency cycle detected: ${cycle.join(" → ")}`);
-                }
-              }
-              if (params.status?.trim()) {
-                if (
-                  params.status.trim() === "done" &&
-                  task.dependsOn.some((dependency) => state.tasks.find((item) => item.id === dependency)?.status !== "done")
-                )
-                  throw new Error("A task cannot be completed before its dependencies");
-                task.status = params.status.trim();
-              }
-              refreshTaskReadiness(state);
-              syncMemberStatuses(state);
-              persist(context, state);
-              return { content: [{ type: "text" as const, text: `Task ${task.id} updated.` }], details: { kind: "task", item: task } };
-            }
-            if (params.action === "claim_task") {
-              const task = nextReadyTask(state, params.assignee?.trim() || "unassigned");
-              const member = state.members.find((item) => item.id === task.assignee);
-              if (member !== undefined) member.status = "working";
-              syncMemberStatuses(state);
-              persist(context, state);
-              return { content: [{ type: "text" as const, text: `Task ${task.id} claimed.` }], details: { kind: "task", item: task } };
-            }
-            if (params.action === "add_member") {
-              const name = params.name?.trim();
-              if (!name) throw new Error("name is required when action is add_member");
-              const member = {
-                id: params.id?.trim() || name.toLowerCase().replace(/[^a-z0-9]+/g, "-"),
-                name,
-                role: params.role?.trim() || "协作成员",
-                status: params.status?.trim() || "idle",
-              };
-              if (state.members.some((item) => item.id === member.id)) throw new Error(`Member already exists: ${member.id}`);
-              state.members.push(member);
-              persist(context, state);
-              return { content: [{ type: "text" as const, text: `Member ${member.name} added.` }], details: { kind: "member", item: member } };
-            }
-            if (params.action === "send_message") {
-              const from = params.from?.trim();
-              const to = params.to?.trim();
-              const body = params.body?.trim();
-              if (!from || !to || !body) throw new Error("from, to, and body are required when action is send_message");
-              if (!state.members.some((item) => item.id === from)) throw new Error(`Unknown sender: ${from}`);
-              if (!state.members.some((item) => item.id === to)) throw new Error(`Unknown recipient: ${to}`);
-              if (body.length > 4000) throw new Error("Message body must be 4000 characters or fewer");
-              const message: TeamMessage = {
-                id: `message-${state.messages.length + 1}`,
-                from,
-                to,
-                body,
-                timestamp: new Date().toISOString(),
-                read: false,
-              };
-              state.messages.push(message);
-              persist(context, state);
-              return { content: [{ type: "text" as const, text: `Message ${message.id} sent.` }], details: { kind: "message", item: message } };
-            }
-            if (params.action === "read_messages") {
-              const to = params.to?.trim();
-              if (!to) throw new Error("to is required when action is read_messages");
-              if (!state.members.some((item) => item.id === to)) throw new Error(`Unknown recipient: ${to}`);
-              const messages = state.messages.filter((message) => message.to === to && (!params.unreadOnly || !message.read));
-              for (const message of messages) message.read = true;
-              if (messages.length > 0) persist(context, state);
-              return {
-                content: [{ type: "text" as const, text: `${messages.length} message${messages.length === 1 ? "" : "s"} read.` }],
-                details: { kind: "mailbox", messages },
-              };
-            }
-            throw new Error(`Unknown team action: ${params.action}`);
-          });
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "agent-teams-panel",
-      pluginId: "@pi-harness/core/plugins/agent-teams",
-      title: "Agent Teams",
-      description: "查看协作成员、任务状态和当前会话中的持久化任务队列。",
-      icon: "◎",
-      read: () => {
-        const state = readState(context);
-        const cycle = dependencyCycle(state.tasks);
-        return {
-          ...state,
-          readyTasks: readyTeamTasks(state.tasks).map((task) => task.id),
-          dependencyCycle: cycle,
-        };
-      },
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/anchored-standard.ts

@@ -1,88 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-import z from "@deepseek-ai/schemastery";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-export interface AnchoredStandardPluginConfig {
-  maxToolCalls?: number;
-}
-
-export const Config: z<AnchoredStandardPluginConfig> = z.object({ maxToolCalls: z.number().default(64) });
-type AnchorStatus = "idle" | "anchored" | "violated";
-type Violation = { code: "orphan_tool" | "nested_run" | "tool_budget" | "orphan_end"; message: string };
-type AnchorReport = { status: AnchorStatus; events: number; toolCalls: number; maxToolCalls: number; violations: Violation[] };
-
-export default {
-  name: "pi-anchored-standard",
-  inject: ["piPluginUi", "piTools"],
-  Config,
-  apply(context: Context, config: AnchoredStandardPluginConfig) {
-    const maxToolCalls = Math.max(1, Math.min(512, Math.trunc(config.maxToolCalls ?? 64)));
-    let active = false;
-    let events = 0;
-    let toolCalls = 0;
-    const violations: Violation[] = [];
-    const record = (violation: Violation): void => {
-      if (!violations.some((item) => item.code === violation.code)) violations.push(violation);
-    };
-    const inspect = (event: { type: string }): void => {
-      events += 1;
-      if (event.type === "agent_start") {
-        if (active) record({ code: "nested_run", message: "检测到未结束的 Agent 运行被再次启动。" });
-        active = true;
-        toolCalls = 0;
-      } else if (event.type === "agent_end") {
-        if (!active) record({ code: "orphan_end", message: "检测到没有对应启动事件的 Agent 结束事件。" });
-        active = false;
-      } else if (event.type === "tool_execution_start") {
-        toolCalls += 1;
-        if (!active) record({ code: "orphan_tool", message: "工具调用发生在 Agent 运行锚点之外。" });
-        if (toolCalls > maxToolCalls) record({ code: "tool_budget", message: `单次运行工具调用超过 ${maxToolCalls} 次上限。` });
-      }
-    };
-    const report = (): AnchorReport => ({
-      status: violations.length > 0 ? "violated" : active ? "anchored" : "idle",
-      events,
-      toolCalls,
-      maxToolCalls,
-      violations: [...violations],
-    });
-    const unsubscribe = context.on("pi/session-event", inspect);
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "trajectory_anchor_check",
-        label: "Trajectory anchor check",
-        description: "Audit Agent lifecycle and tool-call ordering against the anchored execution standard.",
-        promptSnippet: "audit the current agent trajectory for lifecycle violations",
-        parameters: Type.Object({}),
-        execute(): Promise<AgentToolResult<AnchorReport>> {
-          return Promise.resolve().then(() => {
-            const result = report();
-            return {
-              content: [
-                {
-                  type: "text" as const,
-                  text: `${result.status}: ${result.events} events, ${result.toolCalls} tool calls, ${result.violations.length} violation(s).`,
-                },
-              ],
-              details: result,
-            };
-          });
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "anchored-standard-panel",
-      pluginId: "@pi-harness/core/plugins/anchored-standard",
-      title: "Anchored Standard",
-      description: "审计 Agent 生命周期和工具调用顺序，发现脱离运行锚点的执行。",
-      icon: "⌁",
-      read: report,
-    });
-    context.effect(() => () => {
-      unsubscribe();
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

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

@@ -1,106 +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 maxQuoteLength = 4_000;
-const maxNoteLength = 1_000;
-const maxAnnotations = 50;
-
-export interface Annotation {
-  id: number;
-  quote: string;
-  note: string;
-  createdAt: string;
-}
-
-export interface AnnotationReport {
-  count: number;
-  annotations: Annotation[];
-}
-
-function requiredText(value: string, label: string, max: number): string {
-  const text = value.trim();
-  if (text.length === 0 || text.length > max) throw new Error(`${label} must contain 1-${max} characters`);
-  return text;
-}
-
-function formatPrompt(annotations: readonly Annotation[], question: string): string {
-  const lines = annotations.flatMap((item) => [`${item.id}. ${item.quote}`, ...(item.note === "" ? [] : [`   Note: ${item.note}`])]);
-  const instruction = annotations.map((item) => `Annotation ${item.id}: …`).join("; ");
-  const body = lines.join("\n");
-  const ask = question.trim();
-  return `I annotated the following ${annotations.length} passage(s):\n\n${body}\n\nPlease respond to each annotation using ${instruction}.\n\nAsk:\n${ask}`;
-}
-
-export default {
-  name: "pi-annotation",
-  inject: ["piPluginUi", "piTools"],
-  apply(context: Context) {
-    let annotations: Annotation[] = [];
-    let lastPrompt: string | undefined;
-    const report = (): AnnotationReport => ({ count: annotations.length, annotations: [...annotations] });
-    const unregister = context.piTools.register(
-      defineTool({
-        name: "annotation_manage",
-        label: "Manage annotations",
-        description: "Collect numbered passage annotations and render them into a model-ready prompt block.",
-        promptSnippet: "collect a passage annotation and prepare it for the next question",
-        parameters: Type.Object({
-          action: Type.Union([Type.Literal("add"), Type.Literal("list"), Type.Literal("remove"), Type.Literal("clear"), Type.Literal("prompt")]),
-          quote: Type.Optional(Type.String()),
-          note: Type.Optional(Type.String()),
-          id: Type.Optional(Type.Number()),
-          question: Type.Optional(Type.String()),
-        }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<AnnotationReport | Annotation | { prompt: string }>> {
-          await Promise.resolve();
-          if (params.action === "add") {
-            if (annotations.length >= maxAnnotations) throw new Error(`At most ${maxAnnotations} annotations can be collected`);
-            const quote = requiredText(params.quote ?? "", "Annotation quote", maxQuoteLength);
-            const note = (params.note ?? "").trim();
-            if (note.length > maxNoteLength) throw new Error(`Annotation note must contain 0-${maxNoteLength} characters`);
-            const annotation: Annotation = {
-              id: annotations.length === 0 ? 1 : Math.max(...annotations.map((item) => item.id)) + 1,
-              quote,
-              note,
-              createdAt: new Date().toISOString(),
-            };
-            annotations = [...annotations, annotation];
-            return { content: [{ type: "text", text: `Annotation ${annotation.id} added.` }], details: annotation };
-          }
-          if (params.action === "remove") {
-            if (!Number.isInteger(params.id) || params.id === undefined) throw new Error("Annotation id is required");
-            const before = annotations.length;
-            annotations = annotations.filter((item) => item.id !== params.id);
-            if (annotations.length === before) throw new Error(`Annotation ${params.id} was not found`);
-            return { content: [{ type: "text", text: `Annotation ${params.id} removed.` }], details: report() };
-          }
-          if (params.action === "clear") {
-            annotations = [];
-            lastPrompt = undefined;
-            return { content: [{ type: "text", text: "Annotations cleared." }], details: report() };
-          }
-          if (params.action === "prompt") {
-            if (annotations.length === 0) throw new Error("Add at least one annotation before rendering a prompt");
-            const prompt = formatPrompt(annotations, params.question ?? "");
-            lastPrompt = prompt;
-            return { content: [{ type: "text", text: prompt }], details: { prompt } };
-          }
-          return { content: [{ type: "text", text: `${annotations.length} annotation(s) collected.` }], details: report() };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "annotation-panel",
-      pluginId: "@pi-harness/core/plugins/annotation",
-      title: "Annotations",
-      description: "收集回复片段并生成带编号的提问上下文。",
-      icon: "⌁",
-      read: () => ({ ...report(), lastPrompt }),
-    });
-    context.effect(() => () => {
-      unregister();
-      disposePanel();
-    });
-  },
-};

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

@@ -1,124 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { basename, resolve } 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 { listWorkspaceNodes, type WorkspaceNode } from "./workspace-navigator.js";
-
-const defaultMaxNodes = 300;
-const maxComponents = 40;
-const maxDependencies = 40;
-
-export interface ArchitectureComponent {
-  readonly id: string;
-  readonly label: string;
-  readonly path: string;
-  readonly files: number;
-  readonly directories: number;
-}
-
-export interface ArchitectureReport {
-  readonly workspace: string;
-  readonly components: readonly ArchitectureComponent[];
-  readonly dependencies: readonly string[];
-  readonly truncated: boolean;
-  readonly mermaid: string;
-}
-
-function componentId(path: string): string {
-  const normalized = path.replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-  return `component_${normalized || "root"}`;
-}
-
-function dependencyId(name: string): string {
-  const normalized = name.replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-  return `dependency_${normalized || "package"}`;
-}
-
-function escapeLabel(value: string): string {
-  return value.replace(/["\r\n]/g, (character) => (character === '"' ? """ : " "));
-}
-
-function topLevelComponents(nodes: readonly WorkspaceNode[]): ArchitectureComponent[] {
-  return nodes
-    .filter((node) => node.kind === "directory" && node.depth === 1)
-    .slice(0, maxComponents)
-    .map((directory) => {
-      const prefix = `${directory.path}/`;
-      const descendants = nodes.filter((node) => node.path.startsWith(prefix));
-      return {
-        id: componentId(directory.path),
-        label: directory.name,
-        path: directory.path,
-        files: descendants.filter((node) => node.kind === "file").length,
-        directories: descendants.filter((node) => node.kind === "directory").length,
-      };
-    });
-}
-
-async function packageDependencies(root: string): Promise<string[]> {
-  try {
-    const parsed = JSON.parse(await readFile(resolve(root, "package.json"), "utf8")) as Record<string, unknown>;
-    const sections = [parsed.dependencies, parsed.devDependencies, parsed.peerDependencies, parsed.optionalDependencies];
-    return [...new Set(sections.flatMap((section) => (section !== null && typeof section === "object" && !Array.isArray(section) ? Object.keys(section) : [])))]
-      .sort((left, right) => left.localeCompare(right))
-      .slice(0, maxDependencies);
-  } catch {
-    return [];
-  }
-}
-
-function render(workspace: string, components: readonly ArchitectureComponent[], dependencies: readonly string[]): string {
-  const lines = [`flowchart LR`, `    project["${escapeLabel(basename(workspace) || "workspace")}"]`];
-  for (const component of components) {
-    lines.push(`    ${component.id}["${escapeLabel(component.label)}\\n${component.files} files · ${component.directories} dirs"]`);
-    lines.push(`    project --> ${component.id}`);
-  }
-  for (const dependency of dependencies) {
-    const id = dependencyId(dependency);
-    lines.push(`    ${id}["${escapeLabel(dependency)}"]`);
-    lines.push(`    project --> ${id}`);
-  }
-  return lines.join("\n");
-}
-
-export async function buildArchitectureReport(root: string, maxNodes = defaultMaxNodes): Promise<ArchitectureReport> {
-  const workspace = resolve(root);
-  const tree = await listWorkspaceNodes(workspace, { maxDepth: 4, maxNodes: Math.max(1, Math.min(500, Math.trunc(maxNodes))) });
-  const components = topLevelComponents(tree.nodes);
-  const dependencies = await packageDependencies(workspace);
-  return { workspace, components, dependencies, truncated: tree.truncated, mermaid: render(workspace, components, dependencies) };
-}
-
-export default {
-  name: "pi-archify",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    let latest: ArchitectureReport | undefined;
-    const unregister = context.piTools.register(
-      defineTool({
-        name: "architecture_map",
-        label: "Architecture map",
-        description: "Build a bounded, read-only architecture map from top-level workspace components and package dependencies.",
-        promptSnippet: "map the current workspace architecture",
-        parameters: Type.Object({ maxNodes: Type.Optional(Type.Number({ description: "Maximum scanned workspace nodes, 1-500" })) }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<ArchitectureReport>> {
-          latest = await buildArchitectureReport(context.piHarnessLaunch.cwd, params.maxNodes);
-          return { content: [{ type: "text", text: latest.mermaid }], details: latest };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "archify-panel",
-      pluginId: "@pi-harness/core/plugins/archify",
-      title: "Architecture Map",
-      description: "从工作区目录和 package.json 依赖生成可审计的架构图源码。",
-      icon: "⌘",
-      read: () => ({ latest: latest ?? null, componentCount: latest?.components.length ?? 0, dependencyCount: latest?.dependencies.length ?? 0 }),
-    });
-    context.effect(() => () => {
-      unregister();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/at-file.ts

@@ -1,54 +0,0 @@
-import { readFile, stat } from "node:fs/promises";
-import { relative, resolve } 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 maxBytes = 256 * 1024;
-
-function resolveWorkspaceFile(workspace: string, requested: string): string {
-  const root = resolve(workspace);
-  const target = resolve(root, requested);
-  const path = relative(root, target);
-  if (path.startsWith("..") || path.includes("/..")) throw new Error("File path must stay inside the current workspace");
-  return target;
-}
-
-export default {
-  name: "pi-at-file",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    let lastFile: { path: string; bytes: number } | undefined;
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "file_context",
-        label: "File context",
-        description: "Attach a text file from the current workspace to the model context with a bounded size.",
-        promptSnippet: "attach a workspace file to the current context",
-        parameters: Type.Object({ path: Type.String({ description: "File path relative to the workspace" }) }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<{ path: string; bytes: number }>> {
-          const target = resolveWorkspaceFile(context.piHarnessLaunch.cwd, params.path);
-          const metadata = await stat(target);
-          if (!metadata.isFile()) throw new Error("Context path is not a file");
-          if (metadata.size > maxBytes) throw new Error("Context file exceeds the 256 KiB attachment limit");
-          const path = relative(context.piHarnessLaunch.cwd, target) || ".";
-          const text = await readFile(target, "utf8");
-          lastFile = { path, bytes: metadata.size };
-          return { content: [{ type: "text", text: `<file path="${path}">\n${text}\n</file>` }], details: lastFile };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "at-file-panel",
-      pluginId: "@pi-harness/core/plugins/at-file",
-      title: "@file 上下文",
-      description: "将工作区内的文本文件安全附加到当前对话。",
-      icon: "⌁",
-      read: () => ({ lastFile: lastFile ?? null, maxBytes }),
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};