@mickorz/opencode-agentic-workflow 0.3.0

package/dist/quality/verify.d.ts

@@ -0,0 +1,50 @@
+/**
+ * verify —— 语义质量验证节点（P1.2）
+ *
+ * 与 check 的职责边界：
+ *   check = 确定性验证（谓词求值，可重复）
+ *   verify = 语义质量验证（reviewer agent 评审「做得对不对/好不好」）
+ *
+ * 机制：
+ *   verify(artifact, { reviewers: N, criteria })
+ *     -> N 个 reviewer 子 agent 并行评审（复用 parallel() 组合子）
+ *     -> 每个 reviewer 被要求输出 JSON verdict（宽松解析，解析失败按 fail）
+ *     -> 全员 pass 才 passed=true（严格语义；后续失败策略在此之上构建）
+ *
+ * 与 check 对称的双 API：
+ *   verify()      -> 永不抛错，返回 VerifyResult
+ *   assertVerify() -> 失败抛 WorkflowVerifyError
+ */
+import type { AgentResult } from "../runtime/executor.js";
+import { WorkflowError } from "../runtime/errors.js";
+/** 单个 reviewer 的评审结论 */
+export interface ReviewVerdict {
+    /** reviewer 序号（1 起） */
+    reviewer: number;
+    verdict: "pass" | "fail";
+    summary: string;
+    issues: string[];
+}
+export interface VerifyOptions {
+    /** 并行评审人数，默认 1；至少 1 */
+    reviewers?: number;
+    /** 验证标准（评审依据），例如「符合登录模块需求，无安全漏洞」 */
+    criteria?: string;
+    /** 结果标签，默认 "semantic verify" */
+    label?: string;
+}
+export interface VerifyResult {
+    label: string;
+    /** 所有 reviewer 均 pass 才为 true */
+    passed: boolean;
+    verdicts: ReviewVerdict[];
+}
+/** assertVerify 失败时抛出，携带完整 VerifyResult 供失败策略消费 */
+export declare class WorkflowVerifyError extends WorkflowError {
+    readonly result: VerifyResult;
+    constructor(result: VerifyResult);
+}
+/** 语义质量验证：N 个 reviewer 并行评审，全员 pass 才通过；永不抛错 */
+export declare function verify(artifact: string | AgentResult | object, options?: VerifyOptions): Promise<VerifyResult>;
+/** verify 的严格版：失败抛 WorkflowVerifyError，成功原样返回 VerifyResult */
+export declare function assertVerify(artifact: string | AgentResult | object, options?: VerifyOptions): Promise<VerifyResult>;

package/dist/quality/verify.js

@@ -0,0 +1,110 @@
+/**
+ * verify —— 语义质量验证节点（P1.2）
+ *
+ * 与 check 的职责边界：
+ *   check = 确定性验证（谓词求值，可重复）
+ *   verify = 语义质量验证（reviewer agent 评审「做得对不对/好不好」）
+ *
+ * 机制：
+ *   verify(artifact, { reviewers: N, criteria })
+ *     -> N 个 reviewer 子 agent 并行评审（复用 parallel() 组合子）
+ *     -> 每个 reviewer 被要求输出 JSON verdict（宽松解析，解析失败按 fail）
+ *     -> 全员 pass 才 passed=true（严格语义；后续失败策略在此之上构建）
+ *
+ * 与 check 对称的双 API：
+ *   verify()      -> 永不抛错，返回 VerifyResult
+ *   assertVerify() -> 失败抛 WorkflowVerifyError
+ */
+import { WorkflowError } from "../runtime/errors.js";
+import { emitEvent } from "../observability/events.js";
+import { agent } from "../workflow/agent.js";
+import { parallel } from "../workflow/parallel.js";
+import { phase } from "../workflow/phase.js";
+import { parseJsonLoose } from "./json.js";
+/** assertVerify 失败时抛出，携带完整 VerifyResult 供失败策略消费 */
+export class WorkflowVerifyError extends WorkflowError {
+    result;
+    constructor(result) {
+        const failed = result.verdicts
+            .filter((v) => v.verdict === "fail")
+            .map((v) => `#${v.reviewer}: ${v.summary}`)
+            .join("; ");
+        super(`[workflow] verify failed: ${result.label}${failed ? ` (${failed})` : ""}`);
+        this.name = "WorkflowVerifyError";
+        this.result = result;
+    }
+}
+/** 输入产物归一化为文本：string 原样，对象取 output 字段或 JSON 序列化 */
+function artifactToText(artifact) {
+    if (typeof artifact === "string")
+        return artifact;
+    const record = artifact;
+    if (typeof record.output === "string")
+        return record.output;
+    return JSON.stringify(artifact, null, 2);
+}
+function buildReviewerPrompt(artifact, reviewerNo, reviewers, criteria) {
+    return [
+        `你是第 ${reviewerNo}/${reviewers} 号独立评审员。请评审下面的产物，给出严格 JSON 结论。`,
+        criteria ? `评审标准：${criteria}` : "评审标准：产物完整、正确、可交付。",
+        "",
+        "=== 待评审产物 ===",
+        artifact,
+        "=== 产物结束 ===",
+        "",
+        '只输出 JSON，不要任何其他文字，也不要调用任何工具，直接给出结论，格式：',
+        '{"verdict":"pass|fail","summary":"一句话结论","issues":["问题1","问题2"]}',
+        "pass 与 fail 只能二选一；没有问题时 issues 为空数组。",
+    ].join("\n");
+}
+/** 解析单个 reviewer 的输出为 verdict；解析失败按 fail 处理 */
+function toVerdict(reviewer, output) {
+    const parsed = parseJsonLoose(output);
+    if (parsed &&
+        (parsed.verdict === "pass" || parsed.verdict === "fail") &&
+        typeof parsed.summary === "string") {
+        return {
+            reviewer,
+            verdict: parsed.verdict,
+            summary: parsed.summary,
+            issues: Array.isArray(parsed.issues)
+                ? parsed.issues.filter((i) => typeof i === "string")
+                : [],
+        };
+    }
+    return {
+        reviewer,
+        verdict: "fail",
+        summary: "reviewer output was not valid JSON with verdict/summary",
+        issues: [output.slice(0, 200)],
+    };
+}
+/** 语义质量验证：N 个 reviewer 并行评审，全员 pass 才通过；永不抛错 */
+export async function verify(artifact, options) {
+    const reviewers = Math.max(1, Math.floor(options?.reviewers ?? 1));
+    const label = options?.label ?? "semantic verify";
+    phase(`Verify(${label}, ${reviewers} reviewer${reviewers > 1 ? "s" : ""})`);
+    const text = artifactToText(artifact);
+    const outputs = await parallel(Array.from({ length: reviewers }, (_, i) => () => agent(buildReviewerPrompt(text, i + 1, reviewers, options?.criteria))));
+    const verdicts = outputs.map((result, i) => toVerdict(i + 1, result.output));
+    const passed = verdicts.every((v) => v.verdict === "pass");
+    console.log(`[agentic-workflow] verify ${passed ? "ok" : "FAIL"}: ${label} ` +
+        `(${verdicts.filter((v) => v.verdict === "pass").length}/${verdicts.length} pass)`);
+    emitEvent({
+        type: "verify.completed",
+        label,
+        passed,
+        passedCount: verdicts.filter((v) => v.verdict === "pass").length,
+        totalCount: verdicts.length,
+    });
+    return { label, passed, verdicts };
+}
+/** verify 的严格版：失败抛 WorkflowVerifyError，成功原样返回 VerifyResult */
+export async function assertVerify(artifact, options) {
+    const result = await verify(artifact, options);
+    if (!result.passed) {
+        throw new WorkflowVerifyError(result);
+    }
+    return result;
+}
+//# sourceMappingURL=verify.js.map

package/dist/quality/verify.js.map

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

package/dist/registry/definition.d.ts

@@ -0,0 +1,66 @@
+/**
+ * WorkflowDefinition —— workflow 的元数据契约（P2.5）
+ *
+ * 一个 workflow = 一份声明式定义：
+ *   { id, version, description, argsSchema, stepNames, run }
+ *
+ * - version 是第一公民：journal 记录 {id, version}，resume 经 registry
+ *   解析到**精确版本**（绝不隐式取最新），步骤结构变更必须升版本。
+ * - argsSchema 用项目既有的 JSON Schema 风格（最小依赖，不引入 Zod），
+ *   服务于：tool schema 生成 / args 校验 / 未来 TUI 表单与 Hub 展示。
+ * - run(args, ctx)：ctx 携带执行身份（runId / mode / journal / runSteps），
+ *   definition 内部统一用 ctx.runSteps(...) 编排步骤——
+ *   start 与 resume 的差异被 ctx 完全封装。
+ */
+import type { ArgsSchema } from "./schema.js";
+import type { RunJournal } from "../state/recorder.js";
+/** args 声明契约（JSON Schema 子集，见 schema.ts） */
+export type { ArgsSchema };
+/** 步骤函数（与 sequence 的 Step 兼容） */
+export type StepFn<T> = (prev?: T) => Promise<T>;
+/**
+ * 执行上下文：registry runner 构造并传给 definition.run。
+ *
+ * mode:
+ *   - "start"  全新执行（runSteps = sequence + journal 记录）
+ *   - "resume" 从 journal 恢复（runSteps = resumeSequence：跳过 completed
+ *              前缀，从首个未完成步骤重跑）
+ */
+export interface WorkflowContext {
+    runId: string;
+    mode: "start" | "resume";
+    /** journal（配置了 ExecutionStore 时存在；definition 应传给 runSteps） */
+    journal?: RunJournal;
+    /**
+     * 隔离工作区根目录（P2.7；启用隔离且已创建/附着时存在）。
+     * 子 agent 的 cwd 会自动绑定到这里；文件产物应写到该目录下。
+     */
+    workspaceRoot?: string;
+    /** 编排步骤的统一入口（自动处理 start/resume 与 journal 记录） */
+    runSteps<T>(steps: Array<StepFn<T>>, options?: RunStepsOptions): Promise<T | undefined>;
+}
+export interface RunStepsOptions {
+    /** 失败模式，默认 fail-fast */
+    onFailure?: "fail-fast" | "continue";
+    /** 步骤名（错误定位与 journal 记录） */
+    stepNames?: string[];
+}
+export interface WorkflowDefinition<TArgs = unknown, TResult = unknown> {
+    /** 唯一标识（workflow tool 的 flow 参数值 / journal.workflow.id） */
+    id: string;
+    /** 语义化版本：步骤结构或行为变更时必须升版（resume 依赖精确版本解析） */
+    version: string;
+    /** 人读描述（进入工具描述，供主 agent 选择） */
+    description?: string;
+    /** 入参契约（JSON Schema 子集）；undefined 表示无参 */
+    argsSchema?: ArgsSchema;
+    /**
+     * 步骤名（静态声明；同时决定 journal 的 stepCount/stepNames）。
+     * resume 依赖步骤序号稳定——增删/重排步骤必须升 version。
+     */
+    stepNames?: string[];
+    /** 入口：args（已经校验）+ ctx -> 结果（约定带 output 文本字段） */
+    run(args: TArgs, context: WorkflowContext): Promise<TResult>;
+}
+/** defineWorkflow：恒等函数，仅收紧类型（DX 糖） */
+export declare function defineWorkflow<TArgs = unknown, TResult = unknown>(definition: WorkflowDefinition<TArgs, TResult>): WorkflowDefinition<TArgs, TResult>;

package/dist/registry/definition.js

@@ -0,0 +1,19 @@
+/**
+ * WorkflowDefinition —— workflow 的元数据契约（P2.5）
+ *
+ * 一个 workflow = 一份声明式定义：
+ *   { id, version, description, argsSchema, stepNames, run }
+ *
+ * - version 是第一公民：journal 记录 {id, version}，resume 经 registry
+ *   解析到**精确版本**（绝不隐式取最新），步骤结构变更必须升版本。
+ * - argsSchema 用项目既有的 JSON Schema 风格（最小依赖，不引入 Zod），
+ *   服务于：tool schema 生成 / args 校验 / 未来 TUI 表单与 Hub 展示。
+ * - run(args, ctx)：ctx 携带执行身份（runId / mode / journal / runSteps），
+ *   definition 内部统一用 ctx.runSteps(...) 编排步骤——
+ *   start 与 resume 的差异被 ctx 完全封装。
+ */
+/** defineWorkflow：恒等函数，仅收紧类型（DX 糖） */
+export function defineWorkflow(definition) {
+    return definition;
+}
+//# sourceMappingURL=definition.js.map

package/dist/registry/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/registry/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA0DH,sCAAsC;AACtC,MAAM,UAAU,cAAc,CAC5B,UAA8C;IAE9C,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/registry/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Registry 错误家族（P2.5）
+ *
+ * 全部继承 WorkflowError：注册/解析/校验失败与执行失败共用同一
+ * 错误家族，调用方（workflow tool）统一转文本。
+ */
+import { WorkflowError } from "../runtime/errors.js";
+/** 重复注册（同 id + 同 version） */
+export declare class WorkflowRegistrationError extends WorkflowError {
+    constructor(id: string, version: string);
+}
+/** workflow（或精确版本）未注册；消息列出可用版本，供 resume 诊断 */
+export declare class WorkflowNotFoundError extends WorkflowError {
+    constructor(id: string, version: string | undefined, available: string[]);
+}
+/** args 校验失败（JSON Schema 子集） */
+export declare class WorkflowArgsError extends WorkflowError {
+    readonly problems: string[];
+    constructor(id: string, problems: string[]);
+}
+/** run 执行失败（携带 runId，供 resume） */
+export declare class WorkflowExecutionError extends WorkflowError {
+    readonly runId: string;
+    readonly workflowId: string;
+    readonly workflowVersion: string;
+    constructor(identity: {
+        runId: string;
+        id: string;
+        version: string;
+    }, cause: unknown);
+}

package/dist/registry/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Registry 错误家族（P2.5）
+ *
+ * 全部继承 WorkflowError：注册/解析/校验失败与执行失败共用同一
+ * 错误家族，调用方（workflow tool）统一转文本。
+ */
+import { WorkflowError } from "../runtime/errors.js";
+/** 重复注册（同 id + 同 version） */
+export class WorkflowRegistrationError extends WorkflowError {
+    constructor(id, version) {
+        super(`workflow already registered: ${id}@${version}`);
+        this.name = "WorkflowRegistrationError";
+    }
+}
+/** workflow（或精确版本）未注册；消息列出可用版本，供 resume 诊断 */
+export class WorkflowNotFoundError extends WorkflowError {
+    constructor(id, version, available) {
+        super(version === undefined
+            ? `workflow not found: ${id}. available: ${available.join(", ") || "(none)"}`
+            : `workflow version not found: ${id}@${version}. ` +
+                `available versions of ${id}: ${available.join(", ") || "(none)"}`);
+        this.name = "WorkflowNotFoundError";
+    }
+}
+/** args 校验失败（JSON Schema 子集） */
+export class WorkflowArgsError extends WorkflowError {
+    problems;
+    constructor(id, problems) {
+        super(`invalid args for workflow ${id}: ${problems.join("; ")}`);
+        this.name = "WorkflowArgsError";
+        this.problems = problems;
+    }
+}
+/** run 执行失败（携带 runId，供 resume） */
+export class WorkflowExecutionError extends WorkflowError {
+    runId;
+    workflowId;
+    workflowVersion;
+    constructor(identity, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(`workflow ${identity.id}@${identity.version} run ${identity.runId} failed: ${message}`, { cause });
+        this.name = "WorkflowExecutionError";
+        this.runId = identity.runId;
+        this.workflowId = identity.id;
+        this.workflowVersion = identity.version;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/registry/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/registry/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,6BAA6B;AAC7B,MAAM,OAAO,yBAA0B,SAAQ,aAAa;IAC1D,YAAY,EAAU,EAAE,OAAe;QACrC,KAAK,CAAC,gCAAgC,EAAE,IAAI,OAAO,EAAE,CAAC,CAAA;QACtD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,EAAU,EAAE,OAA2B,EAAE,SAAmB;QACtE,KAAK,CACH,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,uBAAuB,EAAE,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE;YAC7E,CAAC,CAAC,+BAA+B,EAAE,IAAI,OAAO,IAAI;gBAChD,yBAAyB,EAAE,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CACvE,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED,gCAAgC;AAChC,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IACzC,QAAQ,CAAU;IAE3B,YAAY,EAAU,EAAE,QAAkB;QACxC,KAAK,CAAC,6BAA6B,EAAE,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;CACF;AAED,kCAAkC;AAClC,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAC9C,KAAK,CAAQ;IACb,UAAU,CAAQ;IAClB,eAAe,CAAQ;IAEhC,YACE,QAAwD,EACxD,KAAc;QAEd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,KAAK,CACH,YAAY,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,OAAO,QAAQ,QAAQ,CAAC,KAAK,YAAY,OAAO,EAAE,EACtF,EAAE,KAAK,EAAE,CACV,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;QAC3B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAA;QAC7B,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAA;IACzC,CAAC;CACF"}

package/dist/registry/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Registry 公共出口（P2.5）
+ */
+export type { WorkflowDefinition, WorkflowContext, RunStepsOptions, StepFn, ArgsSchema, } from "./definition.js";
+export { defineWorkflow } from "./definition.js";
+export { validateArgs } from "./schema.js";
+export { WorkflowRegistry, type AnyWorkflowDefinition, } from "./registry.js";
+export { WorkflowArgsError, WorkflowExecutionError, WorkflowNotFoundError, WorkflowRegistrationError, } from "./errors.js";
+export { resumeWorkflow, startWorkflow, type WorkflowRunResult, type WorkspaceBinding, } from "./runner.js";

package/dist/registry/index.js

@@ -0,0 +1,9 @@
+/**
+ * Registry 公共出口（P2.5）
+ */
+export { defineWorkflow } from "./definition.js";
+export { validateArgs } from "./schema.js";
+export { WorkflowRegistry, } from "./registry.js";
+export { WorkflowArgsError, WorkflowExecutionError, WorkflowNotFoundError, WorkflowRegistrationError, } from "./errors.js";
+export { resumeWorkflow, startWorkflow, } from "./runner.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,gBAAgB,GAEjB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,cAAc,EACd,aAAa,GAGd,MAAM,aAAa,CAAA"}

package/dist/registry/registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * WorkflowRegistry（P2.5）—— 版本感知的 workflow 注册与发现
+ *
+ * - register：同 id 不同 version 允许共存（升级/回滚的关键）；
+ *   同 id + 同 version 重复注册抛错（程序员错误，尽早暴露）。
+ * - get(id)：取该 id 的**最新版本**（semver 最高；非 semver 按注册序最后者，
+ *   排在所有 semver 之后）——用于「启动新 run」。
+ * - get(id, version)：**精确版本**解析——用于 resume：
+ *   journal 记录的 {id, version} 必须精确命中，绝不隐式取最新，
+ *   否则步骤结构变更后旧 journal 恢复会错位（用户态安全约束）。
+ *
+ * 第一版仅支持代码注册；动态发现 / marketplace / 热加载明确不做（P2 范围外）。
+ */
+import type { WorkflowDefinition } from "./definition.js";
+/** 注册边界类型：注册表存异构定义，run 的 args 参数逆变，故边界用 any（仅此边界） */
+export type AnyWorkflowDefinition = WorkflowDefinition<any>;
+export declare class WorkflowRegistry {
+    /** key = `${id}@${version}`，插入序保留注册顺序 */
+    private readonly definitions;
+    /** 注册 workflow；同 id + 同 version 重复抛错 */
+    register(definition: AnyWorkflowDefinition): this;
+    /** 同一 id 的全部已注册版本（注册序） */
+    versions(id: string): AnyWorkflowDefinition[];
+    /** id 的最新版本（semver 最高；非 semver 按注册序最后，低于全部 semver） */
+    latest(id: string): AnyWorkflowDefinition | undefined;
+    /**
+     * 解析 workflow：
+     *   - get(id)          -> 最新版本（启动新 run 用）
+     *   - get(id, version) -> 精确版本（resume 用；未命中抛 WorkflowNotFoundError）
+     */
+    get(id: string, version?: string): AnyWorkflowDefinition | undefined;
+    /**
+     * 解析（严格版）：未命中直接抛错并列出可用版本（resume 诊断友好）。
+     * 工具层用它把「找不到」转成可读文本。
+     */
+    resolve(id: string, version?: string): AnyWorkflowDefinition;
+    /** 全部定义（注册序，含同 id 多版本） */
+    list(): AnyWorkflowDefinition[];
+    /** 全部 id（去重，注册序） */
+    ids(): string[];
+    /** 每个 id 的最新版本各一条（工具枚举/描述用） */
+    listLatest(): AnyWorkflowDefinition[];
+    /** 摘要（工具描述用）：`id@version: description` 每行一条（按最新版本） */
+    summarize(): string;
+}

package/dist/registry/registry.js

@@ -0,0 +1,117 @@
+/**
+ * WorkflowRegistry（P2.5）—— 版本感知的 workflow 注册与发现
+ *
+ * - register：同 id 不同 version 允许共存（升级/回滚的关键）；
+ *   同 id + 同 version 重复注册抛错（程序员错误，尽早暴露）。
+ * - get(id)：取该 id 的**最新版本**（semver 最高；非 semver 按注册序最后者，
+ *   排在所有 semver 之后）——用于「启动新 run」。
+ * - get(id, version)：**精确版本**解析——用于 resume：
+ *   journal 记录的 {id, version} 必须精确命中，绝不隐式取最新，
+ *   否则步骤结构变更后旧 journal 恢复会错位（用户态安全约束）。
+ *
+ * 第一版仅支持代码注册；动态发现 / marketplace / 热加载明确不做（P2 范围外）。
+ */
+import { WorkflowNotFoundError, WorkflowRegistrationError } from "./errors.js";
+/** 解析 semver "1.2.3" -> [1,2,3]；非 semver 返回 null */
+function parseSemver(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compareSemver(a, b) {
+    const sa = parseSemver(a);
+    const sb = parseSemver(b);
+    // 非 semver 一律低于 semver；两个非 semver 之间按注册序（外层处理）
+    if (sa && !sb)
+        return 1;
+    if (!sa && sb)
+        return -1;
+    if (sa && sb) {
+        for (let i = 0; i < 3; i++) {
+            if (sa[i] !== sb[i])
+                return sa[i] - sb[i];
+        }
+        return 0;
+    }
+    return 0;
+}
+export class WorkflowRegistry {
+    /** key = `${id}@${version}`，插入序保留注册顺序 */
+    definitions = new Map();
+    /** 注册 workflow；同 id + 同 version 重复抛错 */
+    register(definition) {
+        if (!definition.id || typeof definition.id !== "string") {
+            throw new Error("[agentic-workflow] workflow definition requires a non-empty id");
+        }
+        if (!definition.version || typeof definition.version !== "string") {
+            throw new Error(`[agentic-workflow] workflow definition ${definition.id} requires a non-empty version`);
+        }
+        const key = `${definition.id}@${definition.version}`;
+        if (this.definitions.has(key)) {
+            throw new WorkflowRegistrationError(definition.id, definition.version);
+        }
+        this.definitions.set(key, definition);
+        return this;
+    }
+    /** 同一 id 的全部已注册版本（注册序） */
+    versions(id) {
+        return this.list().filter((d) => d.id === id);
+    }
+    /** id 的最新版本（semver 最高；非 semver 按注册序最后，低于全部 semver） */
+    latest(id) {
+        const versions = this.versions(id);
+        if (versions.length === 0)
+            return undefined;
+        return versions.reduce((best, current) => compareSemver(current.version, best.version) >= 0 ? current : best);
+    }
+    /**
+     * 解析 workflow：
+     *   - get(id)          -> 最新版本（启动新 run 用）
+     *   - get(id, version) -> 精确版本（resume 用；未命中抛 WorkflowNotFoundError）
+     */
+    get(id, version) {
+        if (version === undefined)
+            return this.latest(id);
+        const exact = this.definitions.get(`${id}@${version}`);
+        return exact;
+    }
+    /**
+     * 解析（严格版）：未命中直接抛错并列出可用版本（resume 诊断友好）。
+     * 工具层用它把「找不到」转成可读文本。
+     */
+    resolve(id, version) {
+        const found = this.get(id, version);
+        if (!found) {
+            const available = version === undefined ? this.ids() : this.versions(id).map((d) => d.version);
+            throw new WorkflowNotFoundError(id, version, available);
+        }
+        return found;
+    }
+    /** 全部定义（注册序，含同 id 多版本） */
+    list() {
+        return [...this.definitions.values()];
+    }
+    /** 全部 id（去重，注册序） */
+    ids() {
+        const seen = [];
+        for (const definition of this.definitions.values()) {
+            if (!seen.includes(definition.id))
+                seen.push(definition.id);
+        }
+        return seen;
+    }
+    /** 每个 id 的最新版本各一条（工具枚举/描述用） */
+    listLatest() {
+        return this.ids()
+            .map((id) => this.latest(id))
+            .filter((d) => d !== undefined);
+    }
+    /** 摘要（工具描述用）：`id@version: description` 每行一条（按最新版本） */
+    summarize() {
+        return this.listLatest()
+            .map((d) => `- ${d.id}@${d.version}${d.description ? `: ${d.description}` : ""}`)
+            .join("\n");
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry/registry.js.map

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

package/dist/registry/runner.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Registry Runner（P2.5 journal 集成）
+ *
+ * 把 Definition / Registry / Journal / Resume 正式串起来：
+ *
+ *   startWorkflow:  registry.resolve(id)[@version] -> args 校验 -> journal 落盘
+ *                   -> definition.run(args, ctx{mode:"start"})
+ *                   -> ctx.runSteps = sequence + journal 记录
+ *
+ *   resumeWorkflow: store.getRun(runId) -> workflow {id, version}
+ *                   -> registry.resolve(id, version)  ← 精确版本，绝不取最新
+ *                   -> definition.run(journal.args, ctx{mode:"resume"})
+ *                   -> ctx.runSteps = resumeSequence（跳过 completed 前缀）
+ *
+ * definition 只感知 ctx.runSteps——start/resume 差异被完全封装；
+ * 失败统一抛 WorkflowExecutionError（携带 runId，供工具层提示恢复入口）。
+ */
+import type { WorkflowIdentity } from "../state/journal.js";
+import type { ExecutionStore } from "../state/store.js";
+import { type CleanupPolicy, type WorkspaceOptions, type WorkspaceProvider } from "../workspace/index.js";
+import type { WorkflowRegistry } from "./registry.js";
+export interface WorkflowRunResult {
+    runId: string;
+    workflow: WorkflowIdentity;
+    output: string;
+}
+/**
+ * 无持久化直跑（插件未配置 journalDir 时的兼容路径）：
+ * 经注册表解析 + args 校验，但不落 journal、不可恢复。
+ */
+export declare function runWorkflowInline(registry: WorkflowRegistry, id: string, args: unknown): Promise<{
+    output: string;
+}>;
+/** 隔离绑定：provider + 创建参数 + 清理策略（start/resume 均可传） */
+export interface WorkspaceBinding {
+    provider: WorkspaceProvider;
+    options?: WorkspaceOptions;
+    /** 缺省 "on-success"（成功清理；失败保留现场便于 debug/resume） */
+    cleanup?: CleanupPolicy;
+}
+/** 启动新 run（默认最新版本；可用 options.version 精确指定） */
+export declare function startWorkflow(registry: WorkflowRegistry, store: ExecutionStore, id: string, args: unknown, options?: {
+    version?: string;
+    workspace?: WorkspaceBinding;
+}): Promise<WorkflowRunResult>;
+/**
+ * 从 journal 恢复 run：
+ *   - workflow {id, version} 来自 journal，registry 精确版本解析（找不到即报错并列版本）
+ *   - args 取 journal 记录（无需调用方重新提供）
+ *   - journal 记录了 workspace 身份时，**重新附着原工作区**（绝不重建——
+ *     durable resume = journal 状态 + 文件系统状态同时恢复；缺失即报错）
+ *   - 已完成的 run 幂等重放（不执行任何步骤，仅重建最终报告）
+ */
+export declare function resumeWorkflow(registry: WorkflowRegistry, store: ExecutionStore, runId: string, options?: {
+    workspace?: WorkspaceBinding;
+}): Promise<WorkflowRunResult>;