@mickorz/opencode-agentic-workflow 0.4.0 → 0.5.0

package/dist/plugin/checkpoint-override.js

@@ -7,18 +7,14 @@
  * 交互门（5 分钟超时假失败）+ 观测数据写进别的项目。
  *
  * 修复策略：**运行时显式 > 环境隐式**。workflow 工具新增保留参数
- * `checkpointMode`，调用时显式覆盖本次运行的审批门，结束恢复原绑定。
- * 对守护进程宿主天然免疫（参数随调用走，不依赖 init 快照）。
+ * `checkpointMode`，调用时为**本次 run** 构建策略门，经 P2-9 的
+ * run 级上下文（RunLaunchOptions.gate）注入——不再换装全局门，
+ * 无恢复交叠竞态，对守护进程宿主与并发调用天然免疫。
  *
  * 范围收敛（v0.4.0）：只支持策略门（auto-approve / auto-reject）——
  * interactive 门需要 RPC 域 + bind() 注册，按调用创建会累积 RPC
  * 注册且无 unbind 通道，保持「仅限插件配置」。
- *
- * 已知限制：全局 gate 仍是单例，两个并发调用携带不同覆盖值时存在
- * 竞态（restore 交叠）。per-run gate 线程化是后续 L 范围工作；
- * 单会话 `opencode run` / TUI 串行场景不受影响。
  */
-import { getCheckpointGate, setCheckpointGate } from "../quality/checkpoint.js";
 import { PolicyCheckpointGate } from "./policy-checkpoint-gate.js";
 export function parseCheckpointModeOverride(value) {
     if (value === undefined || value === null || value === "")
@@ -34,16 +30,14 @@ export function parseCheckpointModeOverride(value) {
     return undefined;
 }
 /**
- * 为**本次**调用绑定覆盖门；返回恢复函数（无覆盖时返回 undefined）。
- * 必须在 finally 中调用恢复函数，防止覆盖泄漏到后续调用。
+ * 为本次调用构建覆盖门（无覆盖返回 undefined——run 走默认 gate 链：
+ * run 上下文继承 / 全局绑定）。
  */
-export function applyCheckpointModeOverride(mode) {
+export function buildCheckpointGate(mode) {
     if (!mode)
         return undefined;
-    const previous = getCheckpointGate();
-    setCheckpointGate(new PolicyCheckpointGate(mode));
-    console.log(`[agentic-workflow] checkpoint gate override for this invocation: ${mode} ` +
+    console.log(`[agentic-workflow] checkpoint gate for this run: ${mode} ` +
         "(explicit per-call control; init-time config may differ)");
-    return () => setCheckpointGate(previous);
+    return new PolicyCheckpointGate(mode);
 }
 //# sourceMappingURL=checkpoint-override.js.map

package/dist/plugin/checkpoint-override.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-override.js","sourceRoot":"","sources":["../../src/plugin/checkpoint-override.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAKlE,MAAM,UAAU,2BAA2B,CACzC,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC3E,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,KAAK,CAAA;IACrE,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CACT,uEAAuE;YACrE,4DAA4D,CAC/D,CAAA;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CACT,+DAA+D,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/E,CAAA;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAwC;IAExC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,OAAO,CAAC,GAAG,CACT,oEAAoE,IAAI,GAAG;QACzE,0DAA0D,CAC7D,CAAA;IACD,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"checkpoint-override.js","sourceRoot":"","sources":["../../src/plugin/checkpoint-override.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAKlE,MAAM,UAAU,2BAA2B,CACzC,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC3E,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,KAAK,CAAA;IACrE,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CACT,uEAAuE;YACrE,4DAA4D,CAC/D,CAAA;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,CACT,+DAA+D,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/E,CAAA;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAwC;IAExC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3B,OAAO,CAAC,GAAG,CACT,oDAAoD,IAAI,GAAG;QACzD,0DAA0D,CAC7D,CAAA;IACD,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC"}

package/dist/plugin/define-workflow.d.ts

@@ -0,0 +1,33 @@
+/**
+ * workflow_define 核心（v1-parity P0-2：自然语言 → 声明式 JSON 生成链路）
+ *
+ * 主 agent 在对话中把需求整理成声明式 JSON，经本函数「校验 → 注册 → 落盘」，
+ * 全程无需人工编辑文件——v1「零代码」体验在 v2 的声明式形态。
+ *
+ * 语义（与既有纪律对齐）：
+ * - 校验复用装载器同一套规则（validateWorkflow），错误逐一指名
+ * - 内置保留 id 直接拒绝（防遮蔽，同装载器 reservedIds 语义）
+ * - 注册先行、落盘其后：同 id@version 重复注册被拦（版本契约）；
+ *   内容相同的重复 define = 幂等成功（agent 重试友好）；
+ *   内容不同 = 拒绝并提示升 version（registry 同 id 多版本共存，取最新）
+ * - 落盘失败 fail-loud 报告（会话内已注册但未持久化，明确说出后果与修法）
+ *
+ * 纪律：Core 侧逻辑，禁止 import OpenCode API（架构不变量）。
+ */
+import type { WorkflowRegistry } from "../registry/registry.js";
+export interface DefineOutcome {
+    ok: boolean;
+    /** 给主 agent 看的结果文案（成功含调用指引，失败含精确修法） */
+    message: string;
+}
+export declare function defineWorkflow(params: {
+    registry: WorkflowRegistry;
+    /** 内置流程 id（防遮蔽）；与 init 装载用的 reservedIds 同源 */
+    reservedIds: readonly string[];
+    /** 待定义的声明式 JSON（未经校验的原始对象） */
+    raw: unknown;
+    /** 已配置的 flows 候选目录（绝对路径；来自插件 options.workflows 的解析） */
+    flowsDirs: readonly string[];
+    /** 显式目标目录覆盖（绝对路径） */
+    dir?: string;
+}): Promise<DefineOutcome>;

package/dist/plugin/define-workflow.js

@@ -0,0 +1,103 @@
+/**
+ * workflow_define 核心（v1-parity P0-2：自然语言 → 声明式 JSON 生成链路）
+ *
+ * 主 agent 在对话中把需求整理成声明式 JSON，经本函数「校验 → 注册 → 落盘」，
+ * 全程无需人工编辑文件——v1「零代码」体验在 v2 的声明式形态。
+ *
+ * 语义（与既有纪律对齐）：
+ * - 校验复用装载器同一套规则（validateWorkflow），错误逐一指名
+ * - 内置保留 id 直接拒绝（防遮蔽，同装载器 reservedIds 语义）
+ * - 注册先行、落盘其后：同 id@version 重复注册被拦（版本契约）；
+ *   内容相同的重复 define = 幂等成功（agent 重试友好）；
+ *   内容不同 = 拒绝并提示升 version（registry 同 id 多版本共存，取最新）
+ * - 落盘失败 fail-loud 报告（会话内已注册但未持久化，明确说出后果与修法）
+ *
+ * 纪律：Core 侧逻辑，禁止 import OpenCode API（架构不变量）。
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { WorkflowRegistrationError } from "../registry/errors.js";
+import { toDefinition, validateWorkflow } from "../workflows/loader.js";
+export async function defineWorkflow(params) {
+    const { registry, reservedIds, raw, flowsDirs, dir } = params;
+    const checked = validateWorkflow(raw, "workflow_define");
+    if (!checked.ok) {
+        return { ok: false, message: `[agentic-workflow] invalid workflow definition: ${checked.error}` };
+    }
+    const dw = checked.value;
+    if (reservedIds.includes(dw.id)) {
+        return {
+            ok: false,
+            message: `[agentic-workflow] id "${dw.id}" is reserved by a built-in workflow; pick a different id`,
+        };
+    }
+    const targetDir = dir && dir.length > 0 ? dir : flowsDirs[0] ?? "";
+    if (!targetDir) {
+        return {
+            ok: false,
+            message: "[agentic-workflow] no flows directory configured: add " +
+                '\\"workflows\\": ["flows"] to the plugin options (opencode.json) and define again',
+        };
+    }
+    const definition = toDefinition(dw);
+    try {
+        registry.register(definition);
+    }
+    catch (error) {
+        if (error instanceof WorkflowRegistrationError) {
+            // 同 id@version 已注册：内容相同 = 幂等成功；不同 = 版本契约拒绝
+            if (isSameDefinition(registry, dw.id, dw.version ?? "1.0.0", definition)) {
+                return {
+                    ok: true,
+                    message: `[agentic-workflow] ${dw.id}@${dw.version} already defined (identical) - ready to call. ` +
+                        "No changes were needed.",
+                };
+            }
+            return {
+                ok: false,
+                message: `[agentic-workflow] ${dw.id}@${dw.version} is already registered with DIFFERENT content: ` +
+                    'bump "version" to publish the change (the registry keeps versions side by side and ' +
+                    "runs the latest; resume still resolves old journals against their exact version).",
+            };
+        }
+        throw error;
+    }
+    const filePath = path.join(targetDir, `${dw.id}.json`);
+    try {
+        await mkdir(targetDir, { recursive: true });
+        await writeFile(filePath, JSON.stringify(dw, null, 2) + "\n", "utf8");
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: `[agentic-workflow] registered ${dw.id}@${dw.version} for THIS session, but persisting to ` +
+                `${filePath} failed: ${error instanceof Error ? error.message : String(error)}. The definition ` +
+                "will be lost on restart - fix the directory, then define again with a bumped version " +
+                "(the already-registered error for this version is expected; the file on disk wins after restart).",
+        };
+    }
+    return {
+        ok: true,
+        message: `[agentic-workflow] defined ${dw.id}@${dw.version} ` +
+            `(${(definition.stepNames ?? []).join(" -> ")})\n` +
+            `persisted: ${filePath} (auto-loads on every start)\n` +
+            `call it: workflow tool with flow="${dw.id}", topic=<...>` +
+            (dw.args ? " plus the args your schema declares" : ""),
+    };
+}
+/** 与已注册的同 id@version 定义比对「声明层」等价性（run 闭包无法深比较） */
+function isSameDefinition(registry, id, version, candidate) {
+    let existing;
+    try {
+        existing = registry.resolve(id, version);
+    }
+    catch {
+        return false;
+    }
+    if (!existing)
+        return false;
+    return (existing.description === candidate.description &&
+        JSON.stringify(existing.argsSchema) === JSON.stringify(candidate.argsSchema) &&
+        JSON.stringify(existing.stepNames) === JSON.stringify(candidate.stepNames));
+}
+//# sourceMappingURL=define-workflow.js.map

package/dist/plugin/define-workflow.js.map

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