@roarpeng/graphflow 1.1.0 → 1.3.0

package/dist/core/agent-assignment.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * agent-assignment.ts — 多 Agent 协作编排基础
+ *
+ * 基于任务描述关键词自动为 DAG 节点分配建议的 agent 专业领域（AgentSpecialty）。
+ * 这是规划阶段的标注框架，不涉及真正的多 agent 执行，只标注建议的 agent 角色，
+ * 供 executionDescriptor 携带，方便外部编排器 / 人工决策参考。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferAgentSpecialty = inferAgentSpecialty;
+exports.assignAgentsToTasks = assignAgentsToTasks;
+exports.buildAgentAssignments = buildAgentAssignments;
+/** 各专业领域的关键词匹配规则（小写匹配） */
+const SPECIALTY_KEYWORDS = {
+    testing: ["test", "testing", "spec", "vitest", "jest", "unit test", "e2e", "coverage"],
+    frontend: ["ui", "component", "css", "style", "react", "vue", "dom", "layout", "render", "view"],
+    backend: ["api", "server", "database", "model", "endpoint", "route", "service", "schema", "migration", "orm"],
+    docs: ["doc", "readme", "changelog", "documentation", "guide", "tutorial", "wiki"],
+};
+/**
+ * 根据任务描述推断建议的 agent 专业领域。
+ *
+ * 匹配优先级：testing > frontend > backend > docs > general。
+ * 当多个领域都匹配时，取第一个命中的领域（按上述优先级顺序）。
+ *
+ * @param description 任务描述
+ * @returns 建议的 AgentSpecialty
+ */
+function inferAgentSpecialty(description) {
+    const text = (description ?? "").toLowerCase();
+    if (!text) {
+        return "general";
+    }
+    const order = ["testing", "frontend", "backend", "docs"];
+    for (const specialty of order) {
+        const keywords = SPECIALTY_KEYWORDS[specialty];
+        if (keywords.some((kw) => text.includes(kw))) {
+            return specialty;
+        }
+    }
+    return "general";
+}
+/**
+ * 为 DAG 任务节点列表自动分配建议的 agent 专业领域。
+ *
+ * 该函数不修改原始节点对象，返回带有 assignedAgent 字段的新节点数组。
+ * 如果节点已显式指定 assignedAgent，则保留原值不覆盖。
+ *
+ * @param nodes DAG 任务节点列表
+ * @returns 标注了 assignedAgent 的新节点列表
+ */
+function assignAgentsToTasks(nodes) {
+    return nodes.map((node) => {
+        // 已显式指定的不覆盖
+        if (node.assignedAgent) {
+            return node;
+        }
+        const specialty = inferAgentSpecialty(node.description);
+        return { ...node, assignedAgent: specialty };
+    });
+}
+/**
+ * 将任务节点列表转换为 executionDescriptor 使用的 agent 分配映射。
+ *
+ * @param nodes 已分配 agent 的任务节点列表
+ * @returns agent 分配映射数组
+ */
+function buildAgentAssignments(nodes) {
+    return nodes
+        .filter((node) => Boolean(node.assignedAgent))
+        .map((node) => ({ taskId: node.id, specialty: node.assignedAgent }));
+}
+//# sourceMappingURL=agent-assignment.js.map

package/dist/core/agent-assignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-assignment.js","sourceRoot":"","sources":["../../src/core/agent-assignment.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAqBH,kDAeC;AAWD,kDASC;AAQD,sDAMC;AAlED,0BAA0B;AAC1B,MAAM,kBAAkB,GAAyD;IAC/E,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC;IACtF,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;IAChG,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC;IAC7G,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;CACnF,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,MAAM,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAyC,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/F,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAiB;IACnD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,YAAY;QACZ,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CACnC,KAAiB;IAEjB,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,aAAc,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/core/agent-delegation.d.ts

@@ -7,6 +7,7 @@ export interface AgentWorkItem {
     prompt: string;
     expectedFormat: "json";
     responseSchema: Record<string, unknown>;
+    optional?: boolean;
 }
 export type AgentDelegationMode = "llm" | "agent-delegated" | "heuristic";
 export interface AgentDelegatedPlanInsight {

package/dist/core/agent-delegation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-delegation.d.ts","sourceRoot":"","sources":["../../src/core/agent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CA4BxE;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,EAAE,GACzB,MAAM,CAgBR;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,QAAQ,EAAE,CAwB/F;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAYtF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAO1E"}
+{"version":3,"file":"agent-delegation.d.ts","sourceRoot":"","sources":["../../src/core/agent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CA0DxE;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,EAAE,GACzB,MAAM,CAkBR;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,QAAQ,EAAE,CAwB/F;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAYtF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAO1E"}

package/dist/core/agent-delegation.js

@@ -21,6 +21,35 @@ function buildAgentInsightWorkItems(task) {
         expectedFormat: "json",
         responseSchema: HAT_RESPONSE_SCHEMA,
     }));
+    insight_1.SIX_HATS.forEach((hat, index) => {
+        items.push({
+            id: `why-${index + 1}-${hat.color}`,
+            kind: "five-whys",
+            hat: hat.name,
+            optional: true,
+            prompt: [
+                `Task: ${task}`,
+                "",
+                `[OPTIONAL — only answer if your ${hat.name} observation had certainty < 0.6]`,
+                `You are drilling into your ${hat.name} observation with a 5-Why chain.`,
+                `Focus per step: ${hat.whyFocus}`,
+                `Final convergence: ${hat.whyRootFocus}`,
+                "",
+                "Produce up to 5 Why steps, each a {question, answer}, then the converged rootCause.",
+                "Return ONLY a JSON object:",
+                "{",
+                '  "steps": [{"question": "Why ...?", "answer": "..."}],',
+                '  "rootCause": "the single root cause this chain converges to"',
+                "}",
+                "If the hat's certainty was >= 0.6, skip this item (do not submit).",
+            ].join("\n"),
+            expectedFormat: "json",
+            responseSchema: {
+                steps: "Array<{question:string, answer:string}>",
+                rootCause: "string — the converged root cause",
+            },
+        });
+    });
     items.push({
         id: "plan-refinement",
         kind: "plan-refinement",
@@ -50,7 +79,7 @@ function buildAgentDelegationInstructions(task, workItems) {
         "Work items:",
     ];
     for (const item of workItems) {
-        lines.push(`- ${item.id} (${item.kind}${item.hat ? ` / ${item.hat}` : ""})`);
+        lines.push(`- ${item.id} (${item.kind}${item.hat ? ` / ${item.hat}` : ""})${item.optional ? " [optional]" : ""}`);
     }
     return lines.join("\n");
 }

package/dist/core/agent-delegation.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-delegation.js","sourceRoot":"","sources":["../../src/core/agent-delegation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-delegation.js","sourceRoot":"","sources":["../../src/core/agent-delegation.ts"],"names":[],"mappings":"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"}

package/dist/core/dag-checkpoint.d.ts

@@ -0,0 +1,83 @@
+/**
+ * dag-checkpoint.ts — DAG 执行状态持久化（Checkpoint）
+ *
+ * 在每个 DAG 节点执行完成后，将节点状态（id, status, result, retryCount, executedAt）
+ * 持久化到图存储中（作为 TaskRun 类型的 GraphNode）。
+ *
+ * Checkpoint ID 使用 `dag:${taskHash}` 格式：
+ * - taskHash 由 DAG 计划（节点 id / 描述 / 依赖）计算得出，保证同一计划可恢复。
+ * - 整个 DAG 的 checkpoint 以单个 TaskRun GraphNode 的形式存储，content 字段为 JSON。
+ *
+ * 向后兼容：当图存储不支持 checkpoint 所需操作（getNodesByIds / upsertNodes）时，
+ * 所有 checkpoint 操作都会优雅降级为纯内存执行，不会抛出错误。
+ */
+import type { TaskNode } from "./types";
+import type { GraphClient } from "../graph/client-factory";
+/** 单个节点的 checkpoint 状态快照 */
+export interface CheckpointNodeState {
+    /** 节点 id */
+    id: string;
+    /** 节点最终状态 */
+    status: "COMPLETED" | "FAILED";
+    /** 执行结果（成功 / 失败） */
+    result: boolean;
+    /** 节点重试次数 */
+    retryCount: number;
+    /** 执行完成时间（ISO 字符串） */
+    executedAt: string;
+}
+/**
+ * 计算 DAG 计划的任务哈希。
+ *
+ * 哈希输入为所有节点的 id / description / dependencies 的规范化拼接，
+ * 保证相同计划产生相同哈希，从而命中同一 checkpoint。
+ */
+export declare function computeTaskHash(plan: TaskNode[]): string;
+/**
+ * 根据计划生成 checkpoint ID，格式 `dag:${taskHash}`。
+ */
+export declare function computeDagId(plan: TaskNode[]): string;
+/**
+ * DAG Checkpoint 持久化管理器。
+ *
+ * 用法：
+ * ```ts
+ * const cp = new DagCheckpoint(graphClient);
+ * const restored = await cp.loadCheckpoint(dagId);     // 恢复已完成节点
+ * await cp.saveNodeCompletion(dagId, node, true);       // 持久化节点完成状态
+ * ```
+ *
+ * 所有操作均吞掉错误并记录 warn 日志，确保图存储不可用时不影响 DAG 执行。
+ */
+export declare class DagCheckpoint {
+    private readonly graphClient;
+    /** 内存缓存：nodeId -> 节点状态。避免每次保存都重复读取图存储。 */
+    private readonly cache;
+    /** 是否已从图存储加载过一次 */
+    private hydrated;
+    constructor(graphClient: GraphClient);
+    /**
+     * 从图存储加载 checkpoint，返回已完成节点的状态映射。
+     *
+     * 多次调用只会读取一次图存储，后续返回内存缓存。
+     * 如果图存储不支持 getNodesByIds 或读取失败，返回空映射（优雅降级）。
+     */
+    loadCheckpoint(dagId: string): Promise<Map<string, CheckpointNodeState>>;
+    /**
+     * 持久化单个节点的完成状态到图存储。
+     *
+     * 内部维护内存缓存，每次保存都会将完整 checkpoint 重新写入图存储，
+     * 保证崩溃后可从最近一次保存点恢复。
+     */
+    saveNodeCompletion(dagId: string, node: TaskNode, result: boolean): Promise<void>;
+    /**
+     * 清除指定 DAG 的 checkpoint（例如全部完成后清理）。
+     * 图存储支持 deleteNode 时才生效。
+     */
+    clearCheckpoint(dagId: string): Promise<void>;
+    /** 从图存储读取 checkpoint 内容并填充内存缓存。 */
+    private hydrate;
+    /** 将当前内存缓存写入图存储（单个 TaskRun GraphNode）。 */
+    private persist;
+}
+//# sourceMappingURL=dag-checkpoint.d.ts.map

package/dist/core/dag-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-checkpoint.d.ts","sourceRoot":"","sources":["../../src/core/dag-checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,4BAA4B;AAC5B,MAAM,WAAW,mBAAmB;IAClC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,oBAAoB;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IAMZ,OAAO,CAAC,QAAQ,CAAC,WAAW;IALxC,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,mBAAmB;IACnB,OAAO,CAAC,QAAQ,CAAS;gBAEI,WAAW,EAAE,WAAW;IAErD;;;;;OAKG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAY9E;;;;;OAKG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,mCAAmC;YACrB,OAAO;IAqBrB,0CAA0C;YAC5B,OAAO;CAsBtB"}

package/dist/core/dag-checkpoint.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * dag-checkpoint.ts — DAG 执行状态持久化（Checkpoint）
+ *
+ * 在每个 DAG 节点执行完成后，将节点状态（id, status, result, retryCount, executedAt）
+ * 持久化到图存储中（作为 TaskRun 类型的 GraphNode）。
+ *
+ * Checkpoint ID 使用 `dag:${taskHash}` 格式：
+ * - taskHash 由 DAG 计划（节点 id / 描述 / 依赖）计算得出，保证同一计划可恢复。
+ * - 整个 DAG 的 checkpoint 以单个 TaskRun GraphNode 的形式存储，content 字段为 JSON。
+ *
+ * 向后兼容：当图存储不支持 checkpoint 所需操作（getNodesByIds / upsertNodes）时，
+ * 所有 checkpoint 操作都会优雅降级为纯内存执行，不会抛出错误。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DagCheckpoint = void 0;
+exports.computeTaskHash = computeTaskHash;
+exports.computeDagId = computeDagId;
+const logger_1 = require("../utils/logger");
+const hash_1 = require("../utils/hash");
+/**
+ * 计算 DAG 计划的任务哈希。
+ *
+ * 哈希输入为所有节点的 id / description / dependencies 的规范化拼接，
+ * 保证相同计划产生相同哈希，从而命中同一 checkpoint。
+ */
+function computeTaskHash(plan) {
+    const normalized = plan
+        .map((node) => `${node.id}|${node.description}|${[...node.dependencies].sort().join(",")}`)
+        .sort()
+        .join("||");
+    return (0, hash_1.hashText)(normalized);
+}
+/**
+ * 根据计划生成 checkpoint ID，格式 `dag:${taskHash}`。
+ */
+function computeDagId(plan) {
+    return `dag:${computeTaskHash(plan)}`;
+}
+/**
+ * DAG Checkpoint 持久化管理器。
+ *
+ * 用法：
+ * ```ts
+ * const cp = new DagCheckpoint(graphClient);
+ * const restored = await cp.loadCheckpoint(dagId);     // 恢复已完成节点
+ * await cp.saveNodeCompletion(dagId, node, true);       // 持久化节点完成状态
+ * ```
+ *
+ * 所有操作均吞掉错误并记录 warn 日志，确保图存储不可用时不影响 DAG 执行。
+ */
+class DagCheckpoint {
+    graphClient;
+    /** 内存缓存：nodeId -> 节点状态。避免每次保存都重复读取图存储。 */
+    cache = new Map();
+    /** 是否已从图存储加载过一次 */
+    hydrated = false;
+    constructor(graphClient) {
+        this.graphClient = graphClient;
+    }
+    /**
+     * 从图存储加载 checkpoint，返回已完成节点的状态映射。
+     *
+     * 多次调用只会读取一次图存储，后续返回内存缓存。
+     * 如果图存储不支持 getNodesByIds 或读取失败，返回空映射（优雅降级）。
+     */
+    async loadCheckpoint(dagId) {
+        if (!this.hydrated) {
+            this.hydrated = true;
+            try {
+                await this.hydrate(dagId);
+            }
+            catch (error) {
+                logger_1.logger.warn({ error, dagId }, "DAG checkpoint 读取失败，降级为纯内存执行");
+            }
+        }
+        return new Map(this.cache);
+    }
+    /**
+     * 持久化单个节点的完成状态到图存储。
+     *
+     * 内部维护内存缓存，每次保存都会将完整 checkpoint 重新写入图存储，
+     * 保证崩溃后可从最近一次保存点恢复。
+     */
+    async saveNodeCompletion(dagId, node, result) {
+        const state = {
+            id: node.id,
+            status: result ? "COMPLETED" : "FAILED",
+            result,
+            retryCount: node.retryCount,
+            executedAt: new Date().toISOString(),
+        };
+        this.cache.set(node.id, state);
+        try {
+            await this.persist(dagId);
+        }
+        catch (error) {
+            // 持久化失败不影响内存执行，仅记录告警
+            logger_1.logger.warn({ error, dagId, nodeId: node.id }, "DAG checkpoint 持久化失败");
+        }
+    }
+    /**
+     * 清除指定 DAG 的 checkpoint（例如全部完成后清理）。
+     * 图存储支持 deleteNode 时才生效。
+     */
+    async clearCheckpoint(dagId) {
+        this.cache.clear();
+        this.hydrated = true;
+        try {
+            if (this.graphClient.deleteNode) {
+                await this.graphClient.deleteNode(dagId);
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn({ error, dagId }, "DAG checkpoint 清除失败");
+        }
+    }
+    /** 从图存储读取 checkpoint 内容并填充内存缓存。 */
+    async hydrate(dagId) {
+        if (!this.graphClient.getNodesByIds) {
+            return;
+        }
+        const hits = await this.graphClient.getNodesByIds([dagId]);
+        const node = hits.find((n) => n.id === dagId && n.type === "TaskRun");
+        if (!node) {
+            return;
+        }
+        const parsed = JSON.parse(node.content);
+        if (!parsed || typeof parsed !== "object" || !parsed.nodes) {
+            return;
+        }
+        for (const [nodeId, state] of Object.entries(parsed.nodes)) {
+            if (state && typeof state.id === "string") {
+                this.cache.set(nodeId, state);
+            }
+        }
+        logger_1.logger.info({ dagId, restored: this.cache.size }, "DAG checkpoint 恢复完成");
+    }
+    /** 将当前内存缓存写入图存储（单个 TaskRun GraphNode）。 */
+    async persist(dagId) {
+        if (!this.graphClient.upsertNodes) {
+            return;
+        }
+        const content = {
+            dagId,
+            nodes: Object.fromEntries(this.cache),
+        };
+        const graphNode = {
+            id: dagId,
+            type: "TaskRun",
+            content: JSON.stringify(content),
+            metadata: {
+                kind: "dag-checkpoint",
+                dagId,
+                nodeCount: this.cache.size,
+                completed: Array.from(this.cache.values()).filter((s) => s.status === "COMPLETED").length,
+                failed: Array.from(this.cache.values()).filter((s) => s.status === "FAILED").length,
+            },
+        };
+        await this.graphClient.upsertNodes([graphNode]);
+    }
+}
+exports.DagCheckpoint = DagCheckpoint;
+//# sourceMappingURL=dag-checkpoint.js.map

package/dist/core/dag-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-checkpoint.js","sourceRoot":"","sources":["../../src/core/dag-checkpoint.ts"],"names":[],"mappings":"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"}

package/dist/core/dag-engine.d.ts

@@ -1,14 +1,23 @@
 import type { TaskNode } from "./types";
+import type { GraphClient } from "../graph/client-factory";
 export type TaskExecutor = (task: TaskNode) => Promise<boolean>;
 export interface DagExecutionOptions {
     concurrencyLimit?: number;
     nodeTimeoutMs?: number;
+    /** 图存储客户端，用于 DAG 执行状态持久化（checkpoint）。不提供时纯内存执行。 */
+    graphClient?: GraphClient;
+    /** DAG 检查点 ID，格式 dag:${taskHash}。不提供时根据 plan 自动计算。 */
+    dagId?: string;
+    /** 是否启用 checkpoint 持久化，默认当 graphClient 存在时启用。 */
+    enableCheckpoint?: boolean;
 }
 export interface DagExecutionResult {
     completed: string[];
     failed: string[];
     blocked: string[];
     rounds: string[][];
+    /** 从 checkpoint 恢复（跳过）的节点 id 列表 */
+    restoredFromCheckpoint?: string[];
 }
 export declare function executeDag(plan: TaskNode[], executor: TaskExecutor, options?: DagExecutionOptions): Promise<DagExecutionResult>;
 //# sourceMappingURL=dag-engine.d.ts.map

package/dist/core/dag-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dag-engine.d.ts","sourceRoot":"","sources":["../../src/core/dag-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;CACpB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,QAAQ,EAAE,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA2G7B"}
+{"version":3,"file":"dag-engine.d.ts","sourceRoot":"","sources":["../../src/core/dag-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,mCAAmC;IACnC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,QAAQ,EAAE,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAsJ7B"}

package/dist/core/dag-engine.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeDag = executeDag;
 const logger_1 = require("../utils/logger");
+const dag_checkpoint_1 = require("./dag-checkpoint");
 async function executeDag(plan, executor, options) {
     const tasks = new Map(plan.map((task) => [task.id, task]));
     const completed = new Set();
@@ -9,6 +10,37 @@ async function executeDag(plan, executor, options) {
     const blocked = new Set();
     const rounds = [];
     const timeoutMs = options?.nodeTimeoutMs ?? 30_000;
+    // ── Checkpoint 恢复：尝试加载已完成的节点，跳过重复执行 ──
+    const graphClient = options?.graphClient;
+    const enableCheckpoint = options?.enableCheckpoint ?? Boolean(graphClient);
+    let checkpoint;
+    let dagId;
+    const restoredFromCheckpoint = [];
+    if (enableCheckpoint && graphClient) {
+        try {
+            checkpoint = new dag_checkpoint_1.DagCheckpoint(graphClient);
+            dagId = options?.dagId ?? (0, dag_checkpoint_1.computeDagId)(plan);
+            const restored = await checkpoint.loadCheckpoint(dagId);
+            for (const [nodeId, state] of restored) {
+                if (state.status === "COMPLETED") {
+                    completed.add(nodeId);
+                    restoredFromCheckpoint.push(nodeId);
+                }
+                else if (state.status === "FAILED") {
+                    failed.add(nodeId);
+                    restoredFromCheckpoint.push(nodeId);
+                }
+            }
+            if (restoredFromCheckpoint.length > 0) {
+                logger_1.logger.info({ dagId, restored: restoredFromCheckpoint.length }, "DAG checkpoint 命中，跳过已完成节点");
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn({ error }, "DAG checkpoint 初始化失败，降级为纯内存执行");
+            checkpoint = undefined;
+            dagId = undefined;
+        }
+    }
     while (completed.size + failed.size + blocked.size < tasks.size) {
         const ready = Array.from(tasks.values()).filter((task) => {
             if (completed.has(task.id) || failed.has(task.id) || blocked.has(task.id)) {
@@ -90,6 +122,15 @@ async function executeDag(plan, executor, options) {
                 else {
                     failed.add(result.task.id);
                 }
+                // 持久化节点完成状态到 checkpoint（失败时优雅降级，不影响执行）
+                if (checkpoint && dagId) {
+                    try {
+                        await checkpoint.saveNodeCompletion(dagId, result.task, result.ok);
+                    }
+                    catch (error) {
+                        logger_1.logger.warn({ error, taskId: result.task.id }, "DAG checkpoint 持久化失败");
+                    }
+                }
             }
         }
     }
@@ -98,6 +139,7 @@ async function executeDag(plan, executor, options) {
         failed: Array.from(failed),
         blocked: Array.from(blocked),
         rounds,
+        ...(restoredFromCheckpoint.length > 0 ? { restoredFromCheckpoint } : {}),
     };
 }
 //# sourceMappingURL=dag-engine.js.map

package/dist/core/dag-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"dag-engine.js","sourceRoot":"","sources":["../../src/core/dag-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dag-engine.js","sourceRoot":"","sources":["../../src/core/dag-engine.ts"],"names":[],"mappings":"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"}

package/dist/core/merge-agent-insight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-agent-insight.d.ts","sourceRoot":"","sources":["../../src/core/merge-agent-insight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AAKxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAuCD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAc/B;AA+DD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,EAAE,GAC5B,wBAAwB,CA+D1B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CAGnC"}
+{"version":3,"file":"merge-agent-insight.d.ts","sourceRoot":"","sources":["../../src/core/merge-agent-insight.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAuCD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAc/B;AAkGD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,EAAE,GAC5B,wBAAwB,CAmE1B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CAGnC"}

package/dist/core/merge-agent-insight.js

@@ -60,16 +60,43 @@ function readHatFields(parsed) {
     const criticalInsight = typeof parsed.criticalInsight === "string" ? parsed.criticalInsight.trim() : observation;
     return { observation, certainty, criticalInsight };
 }
+function parseWhyChain(parsed, observation) {
+    const rawSteps = parsed.steps;
+    if (!Array.isArray(rawSteps) || rawSteps.length === 0) {
+        return null;
+    }
+    const steps = rawSteps.slice(0, 5).map((raw, i) => {
+        const step = (raw && typeof raw === "object" ? raw : {});
+        return {
+            level: (i + 1),
+            question: String(step.question ?? ""),
+            answer: String(step.answer ?? ""),
+            certainty: Math.min(0.95, 0.3 + (i + 1) * 0.13),
+        };
+    });
+    const lastAnswer = steps[steps.length - 1]?.answer ?? "";
+    const rootCause = typeof parsed.rootCause === "string" && parsed.rootCause.trim()
+        ? parsed.rootCause.trim()
+        : lastAnswer || observation;
+    return {
+        initialObservation: observation,
+        certainty: steps[0]?.certainty ?? 0.5,
+        steps,
+        rootCause,
+    };
+}
 function buildRefinedStatement(task, hatResults) {
     const rootCauses = hatResults
         .filter((hat) => hat.whyChain !== null)
         .map((hat) => hat.whyChain.rootCause)
         .join("; ");
+    const blueSynthesis = hatResults.find((h) => h.hat.color === "blue")?.criticalInsight ?? "";
     const value = hatResults.find((hat) => hat.hat.color === "yellow")?.observation ?? "";
-    if (!rootCauses && !value) {
+    if (!rootCauses && !blueSynthesis && !value) {
         return task;
     }
-    return `核心问题: ${rootCauses || "待探索"} | 核心价值: ${value || "待发现"}`;
+    const coreProblem = rootCauses || blueSynthesis || "待探索";
+    return `核心问题: ${coreProblem} | 核心价值: ${value || "待发现"}`;
 }
 function parsePlanItems(parsed) {
     const raw = parsed.items;
@@ -103,27 +130,31 @@ function parsePlanItems(parsed) {
     return items.length > 0 ? items.slice(0, 8) : [];
 }
 function mergeAgentInsights(task, records) {
-    const expectedIds = (0, agent_delegation_1.buildAgentInsightWorkItems)(task).map((item) => item.id);
+    const allItems = (0, agent_delegation_1.buildAgentInsightWorkItems)(task);
+    const requiredIds = allItems.filter((i) => !i.optional).map((i) => i.id);
     const byWorkItem = new Map();
     for (const record of records) {
         byWorkItem.set(record.workItemId, record);
     }
-    const submittedIds = expectedIds.filter((id) => byWorkItem.has(id));
-    const missing = expectedIds.filter((id) => !byWorkItem.has(id));
+    const submittedIds = requiredIds.filter((id) => byWorkItem.has(id));
+    const missing = requiredIds.filter((id) => !byWorkItem.has(id));
     const complete = missing.length === 0;
     const hatResults = [];
-    for (const hat of insight_1.SIX_HATS) {
-        const workItemId = `hat-${insight_1.SIX_HATS.indexOf(hat) + 1}-${hat.color}`;
+    for (let index = 0; index < insight_1.SIX_HATS.length; index++) {
+        const hat = insight_1.SIX_HATS[index];
+        const workItemId = `hat-${index + 1}-${hat.color}`;
         const record = byWorkItem.get(workItemId);
         if (!record) {
             continue;
         }
         const fields = readHatFields(record.parsed);
+        const whyRecord = byWorkItem.get(`why-${index + 1}-${hat.color}`);
+        const whyChain = whyRecord ? parseWhyChain(whyRecord.parsed, fields.observation) : null;
         hatResults.push({
             hat,
             observation: fields.observation,
             certainty: fields.certainty,
-            whyChain: null,
+            whyChain,
             criticalInsight: fields.criticalInsight,
         });
     }