ppxans-harness 2.4.0 → 2.6.0

package/src/mcp/tasks.js

@@ -0,0 +1,138 @@
+// src/mcp/tasks.js - 任务面板存储 (零依赖)
+// 轻量任务工作区: 任务 = { id, title, description, status, steps[], result, createdAt, updatedAt }
+// 持久化到 <root>/data/tasks.json (原子写), 支持 create/list/get/update/step/delete/complete。
+// 供 MCP 工具 ppx.task.* 与 web 前端任务面板使用。
+import fs from "node:fs";
+import path from "node:path";
+import { ensureDir, atomicWrite } from "../utils/store.js";
+
+const VALID_TASK_STATUS = new Set(["todo", "running", "done", "failed"]);
+const VALID_STEP_STATUS = new Set(["pending", "running", "done", "failed"]);
+
+export class TaskBoard {
+  constructor(root) {
+    this.root = root;
+    this.file = path.join(root, "data", "tasks.json");
+    this.tasks = new Map();
+    this._load();
+  }
+
+  _load() {
+    try {
+      if (fs.existsSync(this.file)) {
+        const raw = JSON.parse(fs.readFileSync(this.file, "utf8"));
+        if (Array.isArray(raw.tasks)) {
+          for (const t of raw.tasks) {
+            if (t && t.id) this.tasks.set(t.id, this._normalize(t));
+          }
+        }
+      }
+    } catch (e) { /* 损坏则从空开始, 下次写入覆盖 */ }
+  }
+
+  _save() {
+    try {
+      ensureDir(path.dirname(this.file));
+      atomicWrite(this.file, JSON.stringify({ tasks: [...this.tasks.values()] }, null, 2));
+    } catch (e) { /* 持久化失败不阻断内存操作 */ }
+  }
+
+  _normalize(t) {
+    return {
+      id: String(t.id),
+      title: String(t.title || "未命名任务"),
+      description: String(t.description || ""),
+      status: VALID_TASK_STATUS.has(t.status) ? t.status : "todo",
+      steps: Array.isArray(t.steps) ? t.steps.map((s, i) => ({
+        title: String((s && s.title) || (typeof s === "string" ? s : `步骤 ${i + 1}`)),
+        status: VALID_STEP_STATUS.has(s && s.status) ? s.status : "pending",
+        detail: String((s && s.detail) || ""),
+      })) : [],
+      result: String(t.result || ""),
+      createdAt: t.createdAt || Date.now(),
+      updatedAt: t.updatedAt || Date.now(),
+    };
+  }
+
+  _touch(t) { t.updatedAt = Date.now(); }
+
+  create({ title, description = "", steps = [] } = {}) {
+    if (!title) throw new Error("任务需 title");
+    const id = "t_" + Date.now().toString(36) + Math.random().toString(36).slice(2, 5);
+    const t = this._normalize({
+      id, title, description,
+      steps: steps.map((s) => ({ title: String(s) })).filter((s) => s.title),
+    });
+    this.tasks.set(id, t);
+    this._save();
+    return t;
+  }
+
+  get(id) { return this.tasks.get(String(id)) || null; }
+
+  list() {
+    const arr = [...this.tasks.values()].sort((a, b) => (b.createdAt || 0) - (a.createdAt || 0));
+    return {
+      tasks: arr,
+      counts: {
+        todo: arr.filter((t) => t.status === "todo").length,
+        running: arr.filter((t) => t.status === "running").length,
+        done: arr.filter((t) => t.status === "done").length,
+        failed: arr.filter((t) => t.status === "failed").length,
+      },
+    };
+  }
+
+  update({ id, status, title, description } = {}) {
+    const t = this.get(id);
+    if (!t) throw new Error("任务不存在");
+    if (status != null) {
+      if (!VALID_TASK_STATUS.has(status)) throw new Error(`非法任务状态: ${status}`);
+      t.status = status;
+    }
+    if (title != null) t.title = String(title);
+    if (description != null) t.description = String(description);
+    this._touch(t);
+    this._save();
+    return t;
+  }
+
+  step({ id, index, status, detail } = {}) {
+    const t = this.get(id);
+    if (!t) throw new Error("任务不存在");
+    const i = Number(index);
+    if (!Number.isInteger(i) || i < 0 || i >= t.steps.length) throw new Error("步骤 index 越界");
+    if (status != null) {
+      if (!VALID_STEP_STATUS.has(status)) throw new Error(`非法步骤状态: ${status}`);
+      t.steps[i].status = status;
+    }
+    if (detail != null) t.steps[i].detail = String(detail);
+    // 任一步骤 running → 任务 running; 全部 done → 任务 done (自动派生)
+    if (t.steps.some((s) => s.status === "running")) t.status = "running";
+    else if (t.steps.length && t.steps.every((s) => s.status === "done")) t.status = "done";
+    this._touch(t);
+    this._save();
+    return t;
+  }
+
+  complete(id, result = "") {
+    const t = this.get(id);
+    if (!t) throw new Error("任务不存在");
+    for (const s of t.steps) if (s.status !== "failed") s.status = "done";
+    t.status = "done";
+    if (result) t.result = String(result).slice(0, 20000);
+    this._touch(t);
+    this._save();
+    return t;
+  }
+
+  delete({ id } = {}) {
+    const ok = this.tasks.delete(String(id || ""));
+    if (ok) this._save();
+    return { ok };
+  }
+}
+
+export function createTaskBoard(root) {
+  return new TaskBoard(root);
+}

package/src/plugin/builtin.js

@@ -26,7 +26,10 @@ import { exportMemorySnapshot, mergeSnapshotBack, hasSnapshot } from "../memory/
 
 // fork 工具 (供 ctx.consume("fork") 取用)
 const forkTools = { exportMemorySnapshot, mergeSnapshotBack, hasSnapshot };
-export { isUsableProvider, resolveLLM, resolveAllLLMs } from "../llm/router.js";
+// LLM 路由: import 本地绑定 + re-export 向后兼容 (v2.5.0 修复: 仅 export-from 不产生本地绑定,
+// 导致 llmPlugin 里 resolveLLM/resolveAllLLMs 未定义, 插件装配被隔离且 LLM 实际未注入)
+import { isUsableProvider, resolveLLM, resolveAllLLMs } from "../llm/router.js";
+export { isUsableProvider, resolveLLM, resolveAllLLMs };
 import { ModeRegistry, registerDefaultModes } from "../mode/index.js";
 import { planExecExecutor } from "../mode/plan-exec.js";
 import { routerExecutor } from "../mode/router.js";