@mickorz/opencode-agentic-workflow 0.3.0

package/dist/plugin/opencode-v2-executor.js

@@ -0,0 +1,92 @@
+/**
+ * OpenCodeV2Executor —— AgentExecutor 在 OpenCode V2 上的实现
+ *
+ * 调用链（全部基于 @opencode/plugin 2.0.22 已核实的类型）：
+ *   execute(task)
+ *     -> session.create({ parentID, title, agent?, model? })  创建子会话（挂在主会话下，TUI 可导航）
+ *     -> session.prompt({ sessionID, text })   投递用户消息（V2 为 inbox 异步模型，
+ *                                               返回 SessionInboxUser 而非 assistant 内容）
+ *     -> session.wait({ sessionID })           等待会话空闲（处理完成）
+ *     -> session.context({ sessionID })        拉取消息列表
+ *     -> 取最后一条 assistant 消息的 text parts 拼接为 output
+ *
+ * 架构约束：本文件与 plugin/index.ts 是仅有的允许触碰 OpenCode API 的位置。
+ */
+export class OpenCodeV2Executor {
+    session;
+    parentSessionId;
+    titlePrefix;
+    model;
+    agent;
+    estimateCost;
+    counter = 0;
+    constructor(options) {
+        this.session = options.session;
+        this.parentSessionId = options.parentSessionId;
+        this.titlePrefix = options.titlePrefix ?? "workflow";
+        this.model = options.model;
+        this.agent = options.agent;
+        this.estimateCost = options.estimateCost;
+    }
+    async execute(task) {
+        this.counter += 1;
+        const created = await this.session.create({
+            parentID: this.parentSessionId,
+            title: `${this.titlePrefix}#${this.counter}`,
+            model: this.model,
+            agent: this.agent,
+            // P2.7 隔离：子会话 cwd 绑定到 workflow workspace（worktree 根）
+            ...(task.cwd ? { location: { directory: task.cwd } } : {}),
+        });
+        const sessionID = created.id;
+        await this.session.prompt({
+            sessionID,
+            text: task.prompt,
+        });
+        // V2 的 prompt 是 inbox 投递：等待会话处理完成后再读结果
+        await this.session.wait({ sessionID });
+        const messages = await this.session.context({ sessionID });
+        // 从后往前找最后一条 assistant 消息
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const message = messages[i];
+            if (message && message.type === "assistant") {
+                const output = message.content
+                    .filter((part) => part.type === "text")
+                    .map((part) => part.text)
+                    .join("\n")
+                    .trim();
+                if (output.length > 0) {
+                    // token 用量 / 成本 / 模型（V2 assistant 消息自带；P2.6 metrics 消费）
+                    const usage = message.tokens && {
+                        input: message.tokens.input,
+                        output: message.tokens.output,
+                        reasoning: message.tokens.reasoning,
+                        cache: {
+                            read: message.tokens.cache.read,
+                            write: message.tokens.cache.write,
+                        },
+                    };
+                    const model = message.model && `${message.model.providerID}/${message.model.id}`;
+                    return {
+                        output,
+                        usage,
+                        // 成本优先级：宿主正值（精确）> 价目表估算（宿主 0/缺失时兜底——
+                        // 实测部分 provider 宿主记账为 0 但 models.dev 有实价）> 宿主原值
+                        costUSD: message.cost && message.cost > 0
+                            ? message.cost
+                            : (usage && model ? this.estimateCost?.(model, usage) : undefined) ??
+                                message.cost,
+                        model,
+                    };
+                }
+                // assistant 存在但无文本：带出底层错误信息（如 provider 限流），便于排查
+                const detail = message.error
+                    ? `${message.error.type ?? "error"}: ${message.error.message ?? "unknown"}`
+                    : "assistant message has no text parts";
+                throw new Error(`[agentic-workflow] session ${sessionID} failed: ${detail}`);
+            }
+        }
+        throw new Error(`[agentic-workflow] session ${sessionID} finished without assistant message`);
+    }
+}
+//# sourceMappingURL=opencode-v2-executor.js.map

package/dist/plugin/opencode-v2-executor.js.map

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

package/dist/plugin/policy-checkpoint-gate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PolicyCheckpointGate —— 按固定策略裁决的审批门（plugin 层，P1）
+ *
+ * 背景：server 侧插件域没有创建权限请求/表单的 API（permission.create
+ * 只在 HTTP client 上），交互式审批需要 TUI 双形态插件 + RPC（P2）。
+ * P1 先用策略门证明 checkpoint 的执行语义（headless e2e 可验收）。
+ *
+ * mode:
+ *   "auto-approve" : 自动批准（默认；仅用于验收/演示，日志明确提示非人工）
+ *   "auto-reject"  : 自动拒绝（安全演练/测试拒绝路径）
+ */
+import type { CheckpointDecision, CheckpointGate, CheckpointRequest } from "../quality/checkpoint.js";
+export type CheckpointPolicy = "auto-approve" | "auto-reject";
+export declare class PolicyCheckpointGate implements CheckpointGate {
+    private readonly mode;
+    constructor(mode?: CheckpointPolicy);
+    ask(request: CheckpointRequest): Promise<CheckpointDecision>;
+}

package/dist/plugin/policy-checkpoint-gate.js

@@ -0,0 +1,27 @@
+/**
+ * PolicyCheckpointGate —— 按固定策略裁决的审批门（plugin 层，P1）
+ *
+ * 背景：server 侧插件域没有创建权限请求/表单的 API（permission.create
+ * 只在 HTTP client 上），交互式审批需要 TUI 双形态插件 + RPC（P2）。
+ * P1 先用策略门证明 checkpoint 的执行语义（headless e2e 可验收）。
+ *
+ * mode:
+ *   "auto-approve" : 自动批准（默认；仅用于验收/演示，日志明确提示非人工）
+ *   "auto-reject"  : 自动拒绝（安全演练/测试拒绝路径）
+ */
+export class PolicyCheckpointGate {
+    mode;
+    constructor(mode = "auto-approve") {
+        this.mode = mode;
+    }
+    async ask(request) {
+        console.log(`[agentic-workflow] checkpoint request (${this.mode}): ${request.label} -- ${request.message}`);
+        if (this.mode === "auto-approve") {
+            console.log("[agentic-workflow] NOTE: auto-approved by policy gate; " +
+                "interactive approval lands in P2 (TUI dialog gate)");
+            return { approved: true };
+        }
+        return { approved: false, reason: "rejected by policy gate (auto-reject)" };
+    }
+}
+//# sourceMappingURL=policy-checkpoint-gate.js.map

package/dist/plugin/policy-checkpoint-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-checkpoint-gate.js","sourceRoot":"","sources":["../../src/plugin/policy-checkpoint-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,OAAO,oBAAoB;IACd,IAAI,CAAkB;IAEvC,YAAY,IAAI,GAAqB,cAAc;QACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAA0B;QAClC,OAAO,CAAC,GAAG,CACT,0CAA0C,IAAI,CAAC,IAAI,MAAM,OAAO,CAAC,KAAK,OAAO,OAAO,CAAC,OAAO,EAAE,CAC/F,CAAA;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CACT,yDAAyD;gBACvD,oDAAoD,CACvD,CAAA;YACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC3B,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAA;IAC7E,CAAC;CACF"}

package/dist/plugin/price-table.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 模型价目表与成本估算（P2.6，插件层=宿主关注点）
+ *
+ * 数据源：OpenCode V2 `ctx.model.list()` 的 Model.Info.cost
+ * （USD / 百万 token，含 cache read/write 单价；结构子集本地声明，
+ * 不直接依赖 @opencode 类型，便于单测）。
+ *
+ * 优先级：宿主消息自带精确 cost > 价目表估算 > 不计。
+ */
+import type { TokenUsage } from "../runtime/executor.js";
+/** Model.Info.cost 条目的结构子集（结构兼容 @opencode/schema Model.Info） */
+interface CostTier {
+    tier?: {
+        type: "context";
+        size: number;
+    };
+    input: number;
+    output: number;
+    cache: {
+        read: number;
+        write: number;
+    };
+}
+/** model.list() 元素的结构子集 */
+interface ModelLike {
+    id: string;
+    providerID: string;
+    cost?: CostTier[];
+}
+export interface ModelPrice {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+/** 构建价目表：key = "providerID/id"；基准价取无 tier 限制的条目（缺省第一个） */
+export declare function buildPriceTable(models: readonly ModelLike[]): Map<string, ModelPrice>;
+/**
+ * 估算成本（USD）：
+ *   input×in + cache.read×cacheRead + cache.write×cacheWrite
+ *   + (output + reasoning)×out      —— reasoning 按输出价计
+ * 单位：价目为 USD/百万 token。注意这是估算值（output 是否已含
+ * reasoning 因 provider 而异）；宿主给出精确 cost 时不走本函数。
+ */
+export declare function estimateCostUSD(table: Map<string, ModelPrice>, model: string, usage: TokenUsage): number | undefined;
+export {};

package/dist/plugin/price-table.js

@@ -0,0 +1,44 @@
+/**
+ * 模型价目表与成本估算（P2.6，插件层=宿主关注点）
+ *
+ * 数据源：OpenCode V2 `ctx.model.list()` 的 Model.Info.cost
+ * （USD / 百万 token，含 cache read/write 单价；结构子集本地声明，
+ * 不直接依赖 @opencode 类型，便于单测）。
+ *
+ * 优先级：宿主消息自带精确 cost > 价目表估算 > 不计。
+ */
+/** 构建价目表：key = "providerID/id"；基准价取无 tier 限制的条目（缺省第一个） */
+export function buildPriceTable(models) {
+    const table = new Map();
+    for (const model of models) {
+        const tiers = model.cost ?? [];
+        const base = tiers.find((tier) => !tier.tier) ?? tiers[0];
+        if (!base)
+            continue;
+        table.set(`${model.providerID}/${model.id}`, {
+            input: base.input,
+            output: base.output,
+            cacheRead: base.cache.read,
+            cacheWrite: base.cache.write,
+        });
+    }
+    return table;
+}
+/**
+ * 估算成本（USD）：
+ *   input×in + cache.read×cacheRead + cache.write×cacheWrite
+ *   + (output + reasoning)×out      —— reasoning 按输出价计
+ * 单位：价目为 USD/百万 token。注意这是估算值（output 是否已含
+ * reasoning 因 provider 而异）；宿主给出精确 cost 时不走本函数。
+ */
+export function estimateCostUSD(table, model, usage) {
+    const price = table.get(model);
+    if (!price)
+        return undefined;
+    return ((usage.input * price.input +
+        usage.cache.read * price.cacheRead +
+        usage.cache.write * price.cacheWrite +
+        (usage.output + usage.reasoning) * price.output) /
+        1_000_000);
+}
+//# sourceMappingURL=price-table.js.map

package/dist/plugin/price-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-table.js","sourceRoot":"","sources":["../../src/plugin/price-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,MAA4B;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;IAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC1B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;SAC7B,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAA8B,EAC9B,KAAa,EACb,KAAiB;IAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,OAAO,CACL,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;QACxB,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,SAAS;QAClC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU;QACpC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QAClD,SAAS,CACV,CAAA;AACH,CAAC"}

package/dist/plugin/tui.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OpenCode V2 TUI 插件入口（P2.3 双形态的 TUI 侧）
+ *
+ * 加载约定：package.json exports["./tui"] -> 本文件（default export Plugin.define）。
+ * 职责单一：订阅 server 侧 checkpoint 审批请求事件，弹出 TUI 确认框，
+ * 把人工决定经 RPC 应答回 server（InteractiveCheckpointGate 挂起处）。
+ *
+ * 注意：本文件只在 TUI 宿主内加载；server 宿主只加载 "." 入口（src/plugin/index.ts）。
+ */
+import { Plugin } from "@opencode/plugin/tui";
+declare const _default: Plugin.Definition;
+export default _default;

package/dist/plugin/tui.js

@@ -0,0 +1,53 @@
+/**
+ * OpenCode V2 TUI 插件入口（P2.3 双形态的 TUI 侧）
+ *
+ * 加载约定：package.json exports["./tui"] -> 本文件（default export Plugin.define）。
+ * 职责单一：订阅 server 侧 checkpoint 审批请求事件，弹出 TUI 确认框，
+ * 把人工决定经 RPC 应答回 server（InteractiveCheckpointGate 挂起处）。
+ *
+ * 注意：本文件只在 TUI 宿主内加载；server 宿主只加载 "." 入口（src/plugin/index.ts）。
+ */
+import { Plugin } from "@opencode/plugin/tui";
+import { CHECKPOINT_REQUESTED_EVENT, CheckpointRpc } from "./checkpoint-rpc.js";
+export default Plugin.define({
+    id: "agentic-workflow-tui",
+    setup(ctx) {
+        return ctx.data.on(CHECKPOINT_REQUESTED_EVENT, (event) => {
+            // 事件 data 为 unknown 形状（V2EventRpc.data），手动收窄
+            void handleCheckpointRequest(ctx, event.data);
+        });
+    },
+});
+async function handleCheckpointRequest(ctx, data) {
+    if (typeof data !== "object" || data === null)
+        return;
+    const record = data;
+    if (typeof record.requestId !== "string")
+        return;
+    const label = typeof record.label === "string" ? record.label : "checkpoint";
+    const message = typeof record.message === "string" ? record.message : "";
+    // dialog.confirm: true=确认 / false=取消 / undefined=关闭（全部按「拒绝/批准」二值裁决）
+    const approved = await ctx.ui.dialog.confirm({
+        title: `Agentic Workflow: ${label}`,
+        message,
+        label: { confirm: "批准继续", cancel: "拒绝中止" },
+    });
+    const reason = approved === undefined
+        ? "dialog dismissed (escaped)"
+        : approved
+            ? undefined
+            : "rejected by reviewer in TUI";
+    try {
+        await ctx.client.rpc(CheckpointRpc).reply({
+            requestId: record.requestId,
+            approved: approved === true,
+            reason,
+        });
+    }
+    catch (error) {
+        // server 侧已超时收口等情况；仅记录，不影响 TUI
+        console.log(`[agentic-workflow-tui] checkpoint reply failed (requestId=${record.requestId}): ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=tui.js.map

package/dist/plugin/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../src/plugin/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAI/E,eAAe,MAAM,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,sBAAsB;IAC1B,KAAK,CAAC,GAAe;QACnB,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,KAAK,EAAE,EAAE;YACvD,6CAA6C;YAC7C,KAAK,uBAAuB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA;AAEF,KAAK,UAAU,uBAAuB,CAAC,GAAe,EAAE,IAAa;IACnE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAM;IACrD,MAAM,MAAM,GAAG,IAAmE,CAAA;IAClF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAM;IAChD,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAA;IAC5E,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IAExE,oEAAoE;IACpE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;QAC3C,KAAK,EAAE,qBAAqB,KAAK,EAAE;QACnC,OAAO;QACP,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;KAC3C,CAAC,CAAA;IAEF,MAAM,MAAM,GACV,QAAQ,KAAK,SAAS;QACpB,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,QAAQ;YACR,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,6BAA6B,CAAA;IAErC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,QAAQ,KAAK,IAAI;YAC3B,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+BAA+B;QAC/B,OAAO,CAAC,GAAG,CACT,6DAA6D,MAAM,CAAC,SAAS,KAAK;YAChF,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9D,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/quality/check.d.ts

@@ -0,0 +1,30 @@
+/**
+ * check / assert —— 确定性验证节点（P1.1）
+ *
+ * 职责边界：
+ *   agent  = 做事（LLM，非确定性）
+ *   check  = 确定性验证（谓词求值，可重复）
+ *
+ * 两个 API：
+ *   check(predicate, label)  -> 永不抛错，返回 CheckResult（ok 可能为 false）
+ *   assert(predicate, label) -> 失败抛 WorkflowCheckError（fail-fast 基石，
+ *                               完整失败语义在 P1.3 定义）
+ */
+export interface CheckResult {
+    /** 本次检查的说明，例如 "tests must pass" */
+    label: string;
+    ok: boolean;
+    /** 失败原因（谓词抛错时为错误信息；成功时通常为空） */
+    detail?: string;
+}
+import { WorkflowError } from "../runtime/errors.js";
+/** assert 失败时抛出的错误，携带完整 CheckResult 供上层失败策略消费 */
+export declare class WorkflowCheckError extends WorkflowError {
+    readonly result: CheckResult;
+    constructor(result: CheckResult);
+}
+export type CheckPredicate = () => boolean | Promise<boolean>;
+/** 求值谓词：抛错视为不通过，异常信息进入 detail */
+export declare function check(predicate: CheckPredicate, label: string): Promise<CheckResult>;
+/** check 的严格版：失败抛 WorkflowCheckError，成功原样返回 CheckResult */
+export declare function assert(predicate: CheckPredicate, label: string): Promise<CheckResult>;

package/dist/quality/check.js

@@ -0,0 +1,51 @@
+/**
+ * check / assert —— 确定性验证节点（P1.1）
+ *
+ * 职责边界：
+ *   agent  = 做事（LLM，非确定性）
+ *   check  = 确定性验证（谓词求值，可重复）
+ *
+ * 两个 API：
+ *   check(predicate, label)  -> 永不抛错，返回 CheckResult（ok 可能为 false）
+ *   assert(predicate, label) -> 失败抛 WorkflowCheckError（fail-fast 基石，
+ *                               完整失败语义在 P1.3 定义）
+ */
+import { WorkflowError } from "../runtime/errors.js";
+import { emitEvent } from "../observability/events.js";
+/** assert 失败时抛出的错误，携带完整 CheckResult 供上层失败策略消费 */
+export class WorkflowCheckError extends WorkflowError {
+    result;
+    constructor(result) {
+        super(`[workflow] check failed: ${result.label}` +
+            (result.detail ? ` (${result.detail})` : ""));
+        this.name = "WorkflowCheckError";
+        this.result = result;
+    }
+}
+/** 求值谓词：抛错视为不通过，异常信息进入 detail */
+export async function check(predicate, label) {
+    let ok = false;
+    let detail;
+    try {
+        ok = (await predicate()) === true;
+    }
+    catch (error) {
+        ok = false;
+        detail = error instanceof Error ? error.message : String(error);
+    }
+    const result = { label, ok };
+    if (!ok && detail)
+        result.detail = detail;
+    console.log(`[agentic-workflow] check ${ok ? "ok" : "FAIL"}: ${label}`);
+    emitEvent({ type: "check.completed", label, ok });
+    return result;
+}
+/** check 的严格版：失败抛 WorkflowCheckError，成功原样返回 CheckResult */
+export async function assert(predicate, label) {
+    const result = await check(predicate, label);
+    if (!result.ok) {
+        throw new WorkflowCheckError(result);
+    }
+    return result;
+}
+//# sourceMappingURL=check.js.map

package/dist/quality/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/quality/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD,iDAAiD;AACjD,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAC1C,MAAM,CAAa;IAE5B,YAAY,MAAmB;QAC7B,KAAK,CACH,4BAA4B,MAAM,CAAC,KAAK,EAAE;YACxC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/C,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAID,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,SAAyB,EACzB,KAAa;IAEb,IAAI,EAAE,GAAG,KAAK,CAAA;IACd,IAAI,MAA0B,CAAA;IAC9B,IAAI,CAAC;QACH,EAAE,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,KAAK,IAAI,CAAA;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,GAAG,KAAK,CAAA;QACV,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACjE,CAAC;IACD,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACzC,IAAI,CAAC,EAAE,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IACzC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC,CAAA;IACvE,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAAyB,EACzB,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAC5C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/quality/checkpoint.d.ts

@@ -0,0 +1,44 @@
+/**
+ * checkpoint —— Human-in-the-loop 审批节点（P1.5）
+ *
+ * 执行语义（本文件负责证明的部分）：
+ *   workflow 执行到 checkpoint(message) 时阻塞，等待人工批准：
+ *     approved=true  -> 继续（返回 undefined，可参与 sequence 传值）
+ *     approved=false -> 抛 WorkflowCheckpointError，链路中断
+ *
+ * 宿主交互抽象：CheckpointGate。Core 不知道「人工」在哪里：
+ *   - PolicyCheckpointGate（plugin 层）：按策略自动批准/拒绝（P1 headless 验收用）
+ *   - P2：交互式门（TUI dialog / 权限请求），经 setCheckpointGate 注入同一抽象
+ */
+import { WorkflowError } from "../runtime/errors.js";
+export interface CheckpointRequest {
+    label: string;
+    message: string;
+}
+export interface CheckpointDecision {
+    approved: boolean;
+    /** 拒绝原因（可选，进入错误信息） */
+    reason?: string;
+}
+export interface CheckpointGate {
+    ask(request: CheckpointRequest): Promise<CheckpointDecision>;
+}
+/** checkpoint 被拒绝（或按策略判定不通过）时抛出 */
+export declare class WorkflowCheckpointError extends WorkflowError {
+    readonly label: string;
+    readonly reason?: string;
+    constructor(label: string, reason?: string);
+}
+export interface CheckpointOptions {
+    /** 节点标签，默认 "checkpoint" */
+    label?: string;
+}
+/** 注入 CheckpointGate（plugin 初始化时调用） */
+export declare function setCheckpointGate(value: CheckpointGate): void;
+/** 获取当前 gate；未注入时抛错 */
+export declare function requireCheckpointGate(): CheckpointGate;
+/**
+ * 人工审批节点：阻塞等待批准；拒绝抛 WorkflowCheckpointError。
+ * 批准时返回 undefined，不改变 sequence 的传值流。
+ */
+export declare function checkpoint(message: string, options?: CheckpointOptions): Promise<void>;

package/dist/quality/checkpoint.js

@@ -0,0 +1,55 @@
+/**
+ * checkpoint —— Human-in-the-loop 审批节点（P1.5）
+ *
+ * 执行语义（本文件负责证明的部分）：
+ *   workflow 执行到 checkpoint(message) 时阻塞，等待人工批准：
+ *     approved=true  -> 继续（返回 undefined，可参与 sequence 传值）
+ *     approved=false -> 抛 WorkflowCheckpointError，链路中断
+ *
+ * 宿主交互抽象：CheckpointGate。Core 不知道「人工」在哪里：
+ *   - PolicyCheckpointGate（plugin 层）：按策略自动批准/拒绝（P1 headless 验收用）
+ *   - P2：交互式门（TUI dialog / 权限请求），经 setCheckpointGate 注入同一抽象
+ */
+import { WorkflowError } from "../runtime/errors.js";
+import { emitEvent } from "../observability/events.js";
+import { phase } from "../workflow/phase.js";
+/** checkpoint 被拒绝（或按策略判定不通过）时抛出 */
+export class WorkflowCheckpointError extends WorkflowError {
+    label;
+    reason;
+    constructor(label, reason) {
+        super(`checkpoint rejected: ${label}` + (reason ? ` (${reason})` : ""));
+        this.name = "WorkflowCheckpointError";
+        this.label = label;
+        this.reason = reason;
+    }
+}
+/** ---- gate 注册（与 engine 的 executor 注入同构） ---- */
+let gate;
+/** 注入 CheckpointGate（plugin 初始化时调用） */
+export function setCheckpointGate(value) {
+    gate = value;
+}
+/** 获取当前 gate；未注入时抛错 */
+export function requireCheckpointGate() {
+    if (!gate) {
+        throw new Error("[agentic-workflow] no checkpoint gate bound: call setCheckpointGate() first");
+    }
+    return gate;
+}
+/**
+ * 人工审批节点：阻塞等待批准；拒绝抛 WorkflowCheckpointError。
+ * 批准时返回 undefined，不改变 sequence 的传值流。
+ */
+export async function checkpoint(message, options) {
+    const label = options?.label ?? "checkpoint";
+    phase(`Checkpoint(${label})`);
+    emitEvent({ type: "checkpoint.waiting", label, message });
+    const decision = await requireCheckpointGate().ask({ label, message });
+    console.log(`[agentic-workflow] checkpoint ${label}: ${decision.approved ? "approved" : "rejected"}`);
+    emitEvent({ type: "checkpoint.completed", label, approved: decision.approved });
+    if (!decision.approved) {
+        throw new WorkflowCheckpointError(label, decision.reason);
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/quality/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/quality/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAiB5C,mCAAmC;AACnC,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IAC/C,KAAK,CAAQ;IACb,MAAM,CAAS;IAExB,YAAY,KAAa,EAAE,MAAe;QACxC,KAAK,CACH,wBAAwB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACjE,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAOD,kDAAkD;AAElD,IAAI,IAAgC,CAAA;AAEpC,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,IAAI,GAAG,KAAK,CAAA;AACd,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,OAA2B;IAE3B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,YAAY,CAAA;IAC5C,KAAK,CAAC,cAAc,KAAK,GAAG,CAAC,CAAA;IAE7B,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IAEzD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IAEtE,OAAO,CAAC,GAAG,CACT,iCAAiC,KAAK,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CACzF,CAAA;IAED,SAAS,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IAE/E,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}

package/dist/quality/json.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 宽松 JSON 解析 —— LLM 评审输出的确定性化（P1.2）
+ *
+ * reviewer agent 被要求输出严格 JSON，但 LLM 输出天然不可控：
+ * 可能带 markdown 代码围栏、前后缀解释文字。此处依次尝试：
+ *   原文 -> 剥代码围栏 -> 首尾大括号截取
+ * 全部失败返回 undefined，由调用方按「评审失败」处理。
+ * （策略改编自 V1 opencode-dynamicworkflows 的 parseJsonLoose。）
+ */
+export declare function parseJsonLoose(text: string): unknown;

package/dist/quality/json.js

@@ -0,0 +1,31 @@
+/**
+ * 宽松 JSON 解析 —— LLM 评审输出的确定性化（P1.2）
+ *
+ * reviewer agent 被要求输出严格 JSON，但 LLM 输出天然不可控：
+ * 可能带 markdown 代码围栏、前后缀解释文字。此处依次尝试：
+ *   原文 -> 剥代码围栏 -> 首尾大括号截取
+ * 全部失败返回 undefined，由调用方按「评审失败」处理。
+ * （策略改编自 V1 opencode-dynamicworkflows 的 parseJsonLoose。）
+ */
+export function parseJsonLoose(text) {
+    const trimmed = text.trim();
+    const attempts = [trimmed];
+    const fence = trimmed.match(/```(?:json)?\s*\n([\s\S]*?)\n```/i);
+    if (fence?.[1])
+        attempts.push(fence[1].trim());
+    const firstBrace = trimmed.search(/[[{]/);
+    const lastBrace = Math.max(trimmed.lastIndexOf("}"), trimmed.lastIndexOf("]"));
+    if (firstBrace >= 0 && lastBrace > firstBrace) {
+        attempts.push(trimmed.slice(firstBrace, lastBrace + 1));
+    }
+    for (const attempt of attempts) {
+        try {
+            return JSON.parse(attempt);
+        }
+        catch {
+            // 尝试下一种
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=json.js.map

package/dist/quality/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/quality/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,CAAC,OAAO,CAAC,CAAA;IAEpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAChE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAE9C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9E,IAAI,UAAU,IAAI,CAAC,IAAI,SAAS,GAAG,UAAU,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ;QACV,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/quality/predicates.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 内建确定性谓词库 —— check/assert 的常用积木（P1.1）
+ *
+ * 全部基于可注入的 CommandRunner / Node fs，不触碰 OpenCode API。
+ */
+import { type CommandOptions } from "../runtime/command.js";
+/**
+ * 运行 shell 命令，退出码为 0 视为成功。
+ * 命令一律带超时（默认 120s，可用 options.timeoutMs 覆盖）。
+ */
+export declare function commandSuccess(command: string, options?: CommandOptions): Promise<boolean>;
+/** 路径存在（文件或目录均为 true） */
+export declare function fileExists(path: string): Promise<boolean>;
+/** 路径存在且是文件 */
+export declare function isFile(path: string): Promise<boolean>;
+/** 路径存在且是目录 */
+export declare function isDirectory(path: string): Promise<boolean>;

package/dist/quality/predicates.js

@@ -0,0 +1,44 @@
+/**
+ * 内建确定性谓词库 —— check/assert 的常用积木（P1.1）
+ *
+ * 全部基于可注入的 CommandRunner / Node fs，不触碰 OpenCode API。
+ */
+import { stat } from "node:fs/promises";
+import { getCommandRunner } from "../runtime/command.js";
+/**
+ * 运行 shell 命令，退出码为 0 视为成功。
+ * 命令一律带超时（默认 120s，可用 options.timeoutMs 覆盖）。
+ */
+export async function commandSuccess(command, options) {
+    const result = await getCommandRunner().run(command, options);
+    return result.code === 0 && !result.timedOut;
+}
+/** 路径存在（文件或目录均为 true） */
+export async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 路径存在且是文件 */
+export async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** 路径存在且是目录 */
+export async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=predicates.js.map

package/dist/quality/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../src/quality/predicates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEvC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAA;AAE7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,OAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7D,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAA;AAC9C,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,eAAe;AACf,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,eAAe;AACf,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}