aitable-workflow-core 0.1.23 → 0.1.24

package/dist/index.d.ts

@@ -4448,6 +4448,17 @@ type WorkflowCheckResult = {
     name: string;
     ok: boolean;
     items: CheckItem[];
+    /**
+     * 配置表面：本工作流所有可写路径的权威清单（含 required/optional、owned/reference/external）。
+     *
+     * `items` 只包含「当前有状态要报」的项（error/warn/suggestion/ok），由 check 流程决定；
+     * `surface` 由 `buildWorkflowConfigSurface` 直接从 recipe schema 枚举得到，与 check 状态无关。
+     * `config set` 与 `config --json` 都以 surface 为准 —— 任何 surface 知道的路径都可 set，
+     * 不再被 check 是否发射 CheckItem 卡住（reference+optional 的表就是这样被丢的）。
+     *
+     * optional 是为了兼容早退分支（config 缺失、yaml 解析失败等）尚未构建 surface 的情况。
+     */
+    surface?: ConfigSurfaceItem[];
 };
 type ModuleResult = {
     id: "project" | "coding_agent" | "workflow" | "roles" | "env" | "profile" | "ai_toolkit";
@@ -6122,9 +6133,9 @@ type LoadWorkflowOptions = {
 declare function loadWorkflowTemplate(templatePath: string, options?: LoadWorkflowOptions): Promise<WorkflowTemplate>;
 
 /**
- * aitable-workflow — 工作流门禁（validate workflow）类型定义
+ * aitable-workflow — 工作流门禁（validate）类型定义
  *
- * SPEC: docs/plans/2026-08-17-workflow-gate-check-spec.md
+ * SPEC: docs/plans/2026-09-02-cli-exec-validate-contract.md
  *
  * 门禁回答「这个工作流最基本的链路是否能跑通」：结构与 recipe 绑定、
  * 类型检查、配置契约、参数流转连通性。全部为确定性静态校验：
@@ -6230,9 +6241,9 @@ type InferredContract = {
 declare function inferRecipeContractFromSource(source: string, recipePath: string): InferredContract;
 
 /**
- * aitable-workflow — 工作流门禁编排（validate workflow）
+ * aitable-workflow — 工作流门禁编排（validate）
  *
- * SPEC: docs/plans/2026-08-17-workflow-gate-check-spec.md
+ * SPEC: docs/plans/2026-09-02-cli-exec-validate-contract.md
  *
  * 执行顺序与短路策略（对齐钉钉 validate 架构的 structure 先行语义）：
  *   G1 structure ──有 error──→ 其余 gate skipped（结构损坏时后续分析不可靠）
@@ -6758,6 +6769,7 @@ declare function checkRecipeSyntax(content: string, filePath: string): string[];
 declare function checkRecipeTypes(recipePaths: string[]): {
     errors: string[];
     degraded: boolean;
+    unresolvedModules: string[];
 };
 
 /**