@zhushanwen/pi-subagent-workflow 8.6.0 → 8.7.0

package/src/orchestration/models/workflow-script.ts

@@ -1,117 +0,0 @@
-/**
- * Workflow Extension — WorkflowScript 实体
- *
- * 一个 workflow 脚本文件的数据 + 操作收敛（domain-models.md §7）。
- *
- * 设计：
- * - 将"脚本源 + meta + validate + toExecutable"收敛为实体。
- * - validate 委托 engine/script-lint.ts 的 lintScript。
- * - toExecutable 只做 strip `export const meta`（纯文本变换）；worker 线程 wrap
- * （注入 agent/parallel/pipeline globals）由 infra/worker-script-builder.ts
- * 的 buildWorkerScript 承担——那是技术资源模板生成，不属于实体职责（D-12：
- * 模型只管数据+不变式）。
- *
- * 层归属：Engine。
- *
- * 参考：domain-models.md §7（字段/操作）、engine/script-lint.ts（lint 实现）。
- */
-import { type LintResult,lintScript } from "../script-lint.ts";
-// LintFinding/LintResult 类型规范归属 engine/script-lint.ts（canonical 源）。
-
-// WorkflowMeta 规范来源是 shared/resource-meta.ts（m1 DM1，含 parameters/usage/when/notFor）。
-// m2：删本地封闭 3 字段 interface，re-export m1 的判别联合。
-import type { WorkflowMeta } from "../../shared/resource-meta.ts";
-export type { WorkflowMeta };
-
-// ── validate lint memo（IF9/#15，TC9/DM2）─────────────────────
-
-/**
- * 模块级 lint 结果缓存：key = path，命中条件 = sourceCode 与缓存 srcRef 相等
- *（`===`——JS 字符串比较是**值相等**，设计原文的「引用相等」前提在 JS 不可实现，
- * 实测等值异字面量同样命中；lintScript 是 source 的纯函数，值相等 ⟹ 结果必然
- * 相同，故值键 memo 语义严格正确，且是引用键意图的超集：registry 重建实例传等值
- * 内容也命中）。
- *
- * 重复点：registry.getPath/get 每次 new WorkflowScript（workflow-script-registry-impl），
- * launcher.ts runAndWait / executeNestedWorkflow（每 nested call）各 validate 一次，
- * 同脚本 N 次嵌套 = N 次全量正则 lint。失效语义：文件变更 → 内容值不等 → miss →
- * 重 lint 并覆写条目。等长前缀不同的内容比较在 V8 走指针/长度快路径 + memcmp，
- * 成本远低于正则 lint（TC9 alternatives 中「值键成本≈重 lint」的量级判断不成立）。
- */
-const lintMemo = new Map<string, { srcRef: string; result: LintResult }>();
-
-/** 清空 validate lint 缓存（config-loader.invalidateCache 追加调用，测试隔离用）。 */
-export function clearLintMemo(): void {
-  lintMemo.clear();
-}
-
-/** 脚本来源：saved（.pi/workflows/ 固定）或 tmp（.pi/workflows/.tmp/ 临时）。 */
-export type WorkflowSource = "saved" | "tmp";
-
-/**
- * WorkflowScript 实体。
- *
- * 不变式：
- * - name 非空（meta 提取成功时来自 meta.name，失败时来自文件名 stem）
- * - available=false 时 meta 为空壳（name=stem, description="", phases=[]）
- * - sourceCode 为原始文件内容（含 export）；toExecutable 返回 strip 后的副本
- */
-export class WorkflowScript {
-  readonly name: string;
-  readonly source: WorkflowSource;
-  readonly path: string;
- /** 原始文件内容（可编辑）。toExecutable 返回 strip 后的副本，不改本字段。 */
-  sourceCode: string;
-  readonly meta: WorkflowMeta;
- /** false 当 meta 提取失败（loader 不抛错，标记不可用但仍列出）。 */
-  available: boolean;
-
-  constructor(opts: {
-    name: string;
-    source: WorkflowSource;
-    path: string;
-    sourceCode: string;
-    meta: WorkflowMeta;
-    available: boolean;
-  }) {
-    this.name = opts.name;
-    this.source = opts.source;
-    this.path = opts.path;
-    this.sourceCode = opts.sourceCode;
-    this.meta = opts.meta;
-    this.available = opts.available;
-  }
-
- /**
- * 静态检查脚本合法性。
- *
- * 委托 engine/script-lint.ts 的 lintScript——检查项含：
- * - 必须含 agent/parallel/pipeline 入口之一
- * - agent 选项 outputSchema → schema
- * - result.output/parsedOutput/content 不存在
- * - 文件传状态警告
- *
- * IF9（#15）：同 path 且 sourceCode 引用相等 → 返回缓存 lint 结果（launcher 嵌套
- * 场景下 registry 重建实例的重复全量 lint 消除）；否则 lint + 覆写条目。
- */
-  validate(): LintResult {
-    const memoized = lintMemo.get(this.path);
-    if (memoized && memoized.srcRef === this.sourceCode) {
-      return memoized.result;
-    }
-    const result = lintScript(this.sourceCode);
-    lintMemo.set(this.path, { srcRef: this.sourceCode, result });
-    return result;
-  }
-
- /**
- * 返回可执行源。
- *
- * m2：不再 strip `export const meta`——meta 现为 @pi-meta 块注释（合法 JS，
- * worker 天然忽略），无 const meta 变量。toExecutable 返回原文（含块注释）。
- * Worker 线程 wrap（注入 globals）由 infra/worker-script-builder.ts buildWorkerScript 完成。
- */
-  toExecutable(): string {
-    return this.sourceCode;
-  }
-}