@actiondock/cli 2.11.0 → 2.13.0

package/README.md

@@ -59,6 +59,10 @@ ad run sample.greet -- name=Alice count:=1
 # 复杂参数或对象从文件读取（与扁平参数互斥）
 ad run sample.greet --input-file input.json
 
+# 原始文本管道绑定（假定已注册 summarize 动作且 text 是字符串入参）
+# 可与扁平赋值组合，与 --input / --input-file 互斥
+printf '这是一段正文' | ad run summarize --stdin-field text -- style=brief
+
 # 自动化与脚本通过标准输入传递
 cat input.json | ad run sample.greet --input-file -
 ```
@@ -126,11 +130,12 @@ ad pack
   - 路径冲突（叶节点与容器冲突、对象与数组冲突、重复赋值）严格拒绝（`INPUT_PATH_CONFLICT`）。
   - 拦截原型污染敏感属性（`__proto__`、`constructor`、`prototype`）。
 - 三种输入模式互斥：扁平参数、`--input` 与 `--input-file` 严格互斥，不可混用（`INPUT_CONFLICT`）；未指定输入时默认为 `{}`。
+- 原始文本管道绑定：`printf '正文' | ad run <action> --stdin-field <field> [-- <assignments...>]` 将 stdin 完整正文原样绑定为指定顶层字段的字符串值（不解析类型、不剥 BOM、不修剪空白、空输入为空字符串）；可与扁平赋值组合，与 `--input` / `--input-file` 互斥；stdin 源字节与绑定后的最终入参序列化大小各自受默认 10MiB 上限约束，分别超限报 `INPUT_LIMIT_EXCEEDED` 与 `FLAT_INPUT_LIMIT_EXCEEDED`，JSON 转义放大也计入最终大小；严格 UTF-8 校验失败报读取错误。管道非事务，高风险写入先完整生成并校验再执行。
 - 传统输入选项：
   - 简单内联参数：使用 `--input <json>` 直接解析 JSON 字符串。
   - 复杂对象文件：使用 `--input-file <path>` 读取文件并解析 JSON，避免各类终端的引号转义损坏。
   - 标准输入管道：使用 `--input-file -` 从标准输入读取全部数据并解析 JSON。
-  - 统一解析：解析前均自动剔除 UTF-8 BOM 标记，且不设人为大小上限。
+  - 统一解析：JSON 输入在解析前剔除 UTF-8 BOM，默认大小上限为 10MiB；改用文件不会解除限制。原始文本绑定保留正文 BOM。
 
 ### Windows 与多终端传参建议
 
@@ -152,8 +157,13 @@ $data | ConvertTo-Json -Depth 100 | ad run complex-action --input-file -
 
 ### Action 输出模式与机器模式
 
-- **默认原始纯文本输出**：`ad run` 默认采用面向终端人类阅读与 LLM Agent 上下文消费的原始输出模式。直接将执行结果正文内容（如文件 `content`、`text`、`message` 或标量字符串）输出至 stdout（保留真实换行且无 JSON 转义），相关元数据（如文件路径、行号范围、截断标记）独立输出至 stderr，符合 Unix 管道安全原则。业务执行失败时在 stderr 输出错误详情并以退出码 1 退出。
-- **机器 JSON 格式**（`--json`）：当需要以程序化方式消费、获取完整结构化数据或被外部系统集成时，传入 `--json`。面向智能体调用推荐使用该模式；此时输出标准 JSON 结果（包含 `ok`、`runId`、`data` 或 `error`）；若参数解析出错输出标准错误信封并以退出码 2 退出。
+- **默认纯文本输出**：`ad run` 默认采用纯文本模式。标量直接输出；结构化对象完整输出为标准 JSON 格式到 stdout；不进行私有业务字段自动嗅探。
+- **显式正文输出与默认注解**：
+  - 显式指定正文字段：通过 `ad run <id> --text-field <field> -- ...` 提取结果中特定顶层自有字符串字段输出至 stdout（保留真实换行且无 JSON 转义），其余字段以 JSON 对象形式输出至 stderr（元数据为空时不输出）。
+  - 声明式默认正文：Action 清单中声明 `annotations["actiondock.cli"] = { "textField": "<field>" }` 时，未指定 `--text-field` 时自动按声明提取正文与元数据；显式 `--text-field` 优先于默认注解。
+  - 严格校验与契约闭环：正文字段缺失、非字符串或返回数据非对象时，明确输出错误并以退出码 1 退出，不静默回退，不改写运行记录。契约通过 `ad describe` 呈现通道语义与覆盖指引，并通过 `ad validate` 进行纯静态元数据合规校验。
+  - 参数互斥：`--text-field` 与 `--json`、`--async` 严格互斥，在执行前校验并以退出码 2 退出。
+- **机器模式**（`--json`）：当需要以程序化方式消费、获取完整结构化数据或被外部系统集成时，传入 `--json`。此时始终输出完整执行信封（包含 `ok`、`runId`、`data` 或 `error`），忽略默认正文注解；若参数解析出错输出标准错误信封并以退出码 2 退出。
 
 ---
 
@@ -166,9 +176,9 @@ $data | ConvertTo-Json -Depth 100 | ad run complex-action --input-file -
 | `ad remove <package>` | 卸载并更新锁定依赖，提供原子回滚保护 |
 | `ad info [patterns...]` | 检索包元数据与能力清单，支持模式匹配与树形展示 |
 | `ad list [patterns...]` | 列出包内所有已注册的 Action |
-| `ad describe <id>` | 编码顾问：查看 Action 的详情、模式字段明细、Flat 编码指引与建议赋值 |
-| `ad run <id>` | 本地或远程执行指定 Action（规范语法 `ad run <id> [options] -- <assignments...>`，支持 `--json` 输出标准信封） |
-| `ad validate [id]` | 校验 Action 规范与模式规范 |
+| `ad describe <id>` | 编码顾问：查看 Action 的详情、模式字段明细、Flat 编码指引、建议赋值与输出选择契约 |
+| `ad run <id>` | 本地或远程执行指定 Action（规范语法 `ad run <id> [options] -- <assignments...>`，支持 `--stdin-field` 绑定原始文本、`--text-field` 提取正文与 `--json` 输出标准信封） |
+| `ad validate [id]` | 校验 Action 规范、模式规范与输出选择契约 |
 | `ad doctor` | 执行运行环境与项目结构健康诊断 |
 | `ad action create <id>` | 创建新 Action 源码 |
 | `ad playbook list` / `show` | 查看智能体操作规程 Playbook |

package/dist/commands/action/create.js

@@ -199,8 +199,9 @@ ${returnBody}
         writeStdout(`\nParameter contract:`, context);
         writeStdout(`  ad describe ${id}`, context);
         writeStdout(`\nUsage:`, context);
-        writeStdout(`  Pass parameters according to describe assignment template: ad run ${id} --json -- ASSIGNMENT...`, context);
-        writeStdout(`  Complex input or large text: ad run ${id} --json --input-file input.json`, context);
+        writeStdout(`  Pass parameters according to describe assignment template: ad run ${id} -- ASSIGNMENT...`, context);
+        writeStdout(`  Complex input or large text: ad run ${id} --input-file input.json`, context);
+        writeStdout(`  Append --json only when structured extraction is needed`, context);
     }
     catch (err) {
         throw wrapAsExecutionError(err);

package/dist/commands/run.d.ts

@@ -2,14 +2,18 @@ import { type InvocationControl } from "@actiondock/core/server";
 import type { ExecutionResult } from "@actiondock/sdk";
 import { Command } from "commander";
 import type { CliContext } from "../types.js";
+export interface RawExecutionRenderOptions {
+    textField?: string;
+}
 /**
  * 以原始纯文本形式渲染 Action 执行终态结果（默认纯文本模式）。
  *
  * 设计契约：
  * - 通用纯文本透传：标量直接输出，结构化对象按标准规范呈现，杜绝私有业务字段嗅探。
+ * - 显式或声明式正文输出：指定 textField 时仅输出该自有字符串字段至 stdout，剩余字段以 JSON 对象形式输出至 stderr。
  * - 标准输出仅承载业务有效载荷，保持原生排版与真实换行，供用户调阅或下游管道消费。
  */
-export declare function renderRawExecutionResult(targetRef: string, result: ExecutionResult, context?: CliContext): void;
+export declare function renderRawExecutionResult(targetRef: string, result: ExecutionResult, context?: CliContext, options?: RawExecutionRenderOptions): void;
 /**
  * 统一执行 Action 核心逻辑（使用 ActionDockService 服务端口）。
  *

package/dist/commands/run.js

@@ -1,18 +1,27 @@
 import { validateActionInputValue, mapInputValidationFailure, } from "@actiondock/core/project";
 import { resolveTarget, } from "@actiondock/core/profile";
-import { resolveExecutionHint } from "@actiondock/core";
+import { ACTION_NOT_FOUND, NOT_FOUND, resolveExecutionHint, } from "@actiondock/core";
 import { ArgumentError, ExecutionError, SigintError, packageNotFoundError } from "../errors.js";
-import { writeStderr, writeStdout } from "../renderer.js";
+import { extractTextFieldPayload, resolveActionDefaultTextField, writeStderr, writeStdout, } from "../renderer.js";
 import { applyTargetOptions, getEffectiveOptions, resolveActionInput, resolveLocalPackageRoot, resolveTimeoutMs, withService, } from "../utils/index.js";
 /**
  * 以原始纯文本形式渲染 Action 执行终态结果（默认纯文本模式）。
  *
  * 设计契约：
  * - 通用纯文本透传：标量直接输出，结构化对象按标准规范呈现，杜绝私有业务字段嗅探。
+ * - 显式或声明式正文输出：指定 textField 时仅输出该自有字符串字段至 stdout，剩余字段以 JSON 对象形式输出至 stderr。
  * - 标准输出仅承载业务有效载荷，保持原生排版与真实换行，供用户调阅或下游管道消费。
  */
-export function renderRawExecutionResult(targetRef, result, context) {
+export function renderRawExecutionResult(targetRef, result, context, options) {
     if (result.ok) {
+        if (options?.textField !== undefined) {
+            const { text, metadata } = extractTextFieldPayload(result.data, options.textField);
+            writeStdout(text, context);
+            if (metadata) {
+                writeStderr(JSON.stringify(metadata, null, 2), context);
+            }
+            return;
+        }
         const data = result.data;
         let rawText;
         if (typeof data === "string") {
@@ -58,6 +67,24 @@ export async function executeAction(id, options, context, flatArgs, control) {
     if (!id) {
         throw new ArgumentError("Action ID is required for run");
     }
+    if (options.textField !== undefined) {
+        if (typeof options.textField !== "string" || options.textField.trim() === "") {
+            throw new ArgumentError("The --text-field option requires a non-empty field name.");
+        }
+        if (options.json) {
+            throw new ArgumentError("Cannot specify both --text-field and --json.");
+        }
+        if (options.async) {
+            throw new ArgumentError("Cannot specify both --text-field and --async.");
+        }
+    }
+    // --stdin-field 与 --text-field 分属输入绑定与输出选择，可同时使用；
+    // 与完整 JSON 输入来源的互斥由共享 resolver 统一裁决（INPUT_CONFLICT）
+    if (options.stdinField !== undefined) {
+        if (typeof options.stdinField !== "string") {
+            throw new ArgumentError("The --stdin-field option requires a field name.");
+        }
+    }
     const effectiveControl = control ?? context?.control;
     const effectiveSignal = effectiveControl?.signal;
     const effectiveFlatArgs = flatArgs ?? options.flatArgs;
@@ -65,7 +92,9 @@ export async function executeAction(id, options, context, flatArgs, control) {
         input: options.input,
         inputFile: options.inputFile,
         flatArgs: effectiveFlatArgs && effectiveFlatArgs.length > 0 ? effectiveFlatArgs : undefined,
+        stdinField: options.stdinField,
         stdin: context?.stdin,
+        signal: effectiveSignal,
     });
     const check = validateActionInputValue(input);
     if (!check.valid) {
@@ -131,6 +160,21 @@ export async function executeAction(id, options, context, flatArgs, control) {
                 }
             }
             else {
+                let effectiveTextField = options.textField;
+                if (!isMachine && effectiveTextField === undefined) {
+                    try {
+                        const spec = await service.discovery.describeAction(targetRef);
+                        effectiveTextField = resolveActionDefaultTextField(spec.annotations);
+                    }
+                    catch (err) {
+                        if (err?.code === ACTION_NOT_FOUND || err?.code === NOT_FOUND) {
+                            // 若动作未找到，继续交由 execution.run 生成统一的执行与提示结果
+                        }
+                        else {
+                            throw err;
+                        }
+                    }
+                }
                 const result = await service.execution.run(targetRef, input, {
                     signal: effectiveSignal,
                     timeoutMs,
@@ -152,7 +196,7 @@ export async function executeAction(id, options, context, flatArgs, control) {
                     }
                 }
                 else {
-                    renderRawExecutionResult(targetRef, result, context);
+                    renderRawExecutionResult(targetRef, result, context, { textField: effectiveTextField });
                 }
                 if (!result.ok) {
                     if (context) {
@@ -203,6 +247,15 @@ Flat Input Syntax & Examples:
     # Nested object properties
     ad run <id> -- user.name="alice" user.age:=30
 
+  Text Field Output:
+    # Extract specific text field to stdout (remaining fields as JSON to stderr)
+    ad run <id> --text-field content -- path="README.md"
+
+  Raw Text Input from stdin:
+    # Bind entire stdin content as a string to the given input field
+    printf 'body text' | ad run <id> --stdin-field text -- style=brief
+    cat report.md | ad run <id> --stdin-field content
+
   Complex or multiline inputs:
     # Pass via JSON file with --input-file to avoid shell escaping issues
     ad run <id> --input-file input.json`;
@@ -219,7 +272,8 @@ export function attachRunCommand(parent, context) {
         .option("-P, --package <id>", "Target package ID or path")
         .option("-i, --input <json>", "Action input as inline JSON")
         .option("-f, --input-file <path>", "Action input from JSON file, or '-' for stdin")
-        .option("-c, --config <key=value...>", "Temporary config override (repeatable)");
+        .option("-c, --config <key=value...>", "Temporary config override (repeatable)")
+        .option("--stdin-field <field>", "Bind raw stdin text to a top-level action input field");
     cmd.unknownOption = function (flag) {
         this.error(`unknown option '${flag}'\nHint: Separate action inputs from CLI options using '--', e.g.: ad run <id> [options] -- <param>=<val> or <param>:=<json>.`, { code: "commander.unknownOption" });
     };
@@ -229,6 +283,7 @@ export function attachRunCommand(parent, context) {
         .option("--async", "Execute asynchronously in background (requires remote server or profile)")
         .option("--data-dir <path>", "Custom database directory")
         .option("--json", "Output as JSON")
+        .option("--text-field <field>", "Extract and output a specific top-level string field as raw text")
         .addHelpText("after", RUN_HELP_AFTER_TEXT)
         .action(async (id, params, rawOptions, cmd) => {
         let flatArgs;

package/dist/commands/validate.js

@@ -1,4 +1,4 @@
-import { checkGeneratedTypes, GENERATED_TYPES_OUTDATED_CODE, loadActions, } from "@actiondock/core/project";
+import { checkGeneratedTypes, GENERATED_TYPES_OUTDATED_CODE, loadActions, analyzeActionOutputContract, } from "@actiondock/core/project";
 import { ArgumentError, ExecutionError } from "../errors.js";
 import { renderActionValidation, renderResult } from "../renderer.js";
 import { getEffectiveOptions, requirePackageRoot } from "../utils/index.js";
@@ -49,10 +49,22 @@ export function attachValidateCommand(parent, context) {
             if (outSchema && typeof outSchema !== "object") {
                 errors.push("Invalid outputSchema object");
             }
+            const annotations = item.spec?.annotations ?? item.act?.annotations;
+            const contractAnalysis = analyzeActionOutputContract({
+                annotations,
+                outputSchema: outSchema,
+            });
+            if (contractAnalysis.errors.length > 0) {
+                for (const err of contractAnalysis.errors) {
+                    errors.push(err);
+                }
+            }
+            const warnings = contractAnalysis.warnings.slice();
             results.push({
                 id: item.id,
                 valid: errors.length === 0,
                 errors,
+                ...(warnings.length > 0 ? { warnings } : {}),
             });
         }
         const allValid = results.every((r) => r.valid);

package/dist/renderers/action.d.ts

@@ -1,5 +1,32 @@
-import type { ActionSpec } from "@actiondock/core";
-import { buildActionDescribePayload } from "@actiondock/core/project";
+import { formatActionDetail, type FormatActionDetailOptions } from "@actiondock/core/project";
+export { formatActionDetail, type FormatActionDetailOptions, };
+/**
+ * 解析 Action 注解中的默认正文输出字段声明。
+ *
+ * 契约规范：
+ * - 注解键名固定为 actiondock.cli，值必须为非空非数组对象。
+ * - 正文字段键名为 textField，值必须为非空字符串。
+ * - 无相关注解或未声明 textField 时返回 undefined。
+ * - 注解存在但类型非法时抛出 ExecutionError (INVALID_ANNOTATION)。
+ */
+export declare function resolveActionDefaultTextField(annotations?: Record<string, unknown>): string | undefined;
+/**
+ * 结构化正文与元数据抽取结果。
+ */
+export interface TextFieldExtractionResult {
+    text: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 从 Action 执行数据中抽取指定自有顶层正文字段及剩余元数据。
+ *
+ * 契约规范：
+ * - 仅支持结果数据的顶层自有字符串字段，拒绝通过原型链提取。
+ * - 结果数据本身必须为对象且不能为数组。
+ * - 目标字段必须存在且值为字符串（空字符串为合法有效正文）。
+ * - 剩余元数据安全构造，杜绝原型污染；元数据为空时返回 undefined。
+ */
+export declare function extractTextFieldPayload(data: unknown, textField: string): TextFieldExtractionResult;
 /**
  * 格式化渲染 Action 列表。
  */
@@ -8,30 +35,9 @@ export declare function renderActionList(items: Array<{
     description: string;
     packageId?: string;
 }>, title?: string, isFallback?: boolean, intent?: string): string;
-/**
- * 格式化渲染 Action 详情人类可读文本。
- *
- * @param input Action 描述载荷或 Action 规范
- * @returns 格式化后的说明文本
- */
-export declare function formatActionDetail(input: ReturnType<typeof buildActionDescribePayload> | (Partial<ActionSpec> & {
-    id: string;
-}) | {
-    id: string;
-    packageId?: string;
-    projectRoot?: string;
-    description?: string;
-    inputSchema?: unknown;
-    outputSchema?: unknown;
-    tags?: string[];
-    annotations?: Record<string, unknown>;
-    uses?: string[];
-    entry?: string;
-    [key: string]: any;
-}): string;
 /**
  * 格式化渲染 Action 详情（编码顾问 Encoding Advisor）。
- * 统一复用 formatActionDetail 实现。
+ * 统一复用核心 formatActionDetail 实现。
  */
 export declare function renderActionDetail(action: {
     id: string;
@@ -48,4 +54,5 @@ export declare function renderActionValidation(results: Array<{
     id: string;
     valid: boolean;
     errors: string[];
+    warnings?: string[];
 }>): string;

package/dist/renderers/action.js

@@ -1,4 +1,61 @@
-import { buildActionDescribePayload, ACTION_DESCRIBE_SYNTAX_REFERENCE, } from "@actiondock/core/project";
+import { inspectActionTextFieldAnnotation, formatActionDetail, } from "@actiondock/core/project";
+export { formatActionDetail, };
+import { ExecutionError } from "../errors.js";
+/**
+ * 解析 Action 注解中的默认正文输出字段声明。
+ *
+ * 契约规范：
+ * - 注解键名固定为 actiondock.cli，值必须为非空非数组对象。
+ * - 正文字段键名为 textField，值必须为非空字符串。
+ * - 无相关注解或未声明 textField 时返回 undefined。
+ * - 注解存在但类型非法时抛出 ExecutionError (INVALID_ANNOTATION)。
+ */
+export function resolveActionDefaultTextField(annotations) {
+    const inspection = inspectActionTextFieldAnnotation(annotations);
+    if (!inspection.valid) {
+        throw new ExecutionError(inspection.error, undefined, "INVALID_ANNOTATION");
+    }
+    return inspection.textField;
+}
+/**
+ * 从 Action 执行数据中抽取指定自有顶层正文字段及剩余元数据。
+ *
+ * 契约规范：
+ * - 仅支持结果数据的顶层自有字符串字段，拒绝通过原型链提取。
+ * - 结果数据本身必须为对象且不能为数组。
+ * - 目标字段必须存在且值为字符串（空字符串为合法有效正文）。
+ * - 剩余元数据安全构造，杜绝原型污染；元数据为空时返回 undefined。
+ */
+export function extractTextFieldPayload(data, textField) {
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new ExecutionError(`CLI output format error: expected result data to be an object, but received ${data === null ? "null" : Array.isArray(data) ? "an array" : typeof data}.`, undefined, "OUTPUT_FORMAT_ERROR");
+    }
+    if (!Object.hasOwn(data, textField)) {
+        throw new ExecutionError(`CLI output format error: text field '${textField}' was not found in result data.`, undefined, "OUTPUT_FORMAT_ERROR");
+    }
+    const textValue = data[textField];
+    if (typeof textValue !== "string") {
+        throw new ExecutionError(`CLI output format error: text field '${textField}' must be a string, but received ${textValue === null ? "null" : Array.isArray(textValue) ? "an array" : typeof textValue}.`, undefined, "OUTPUT_FORMAT_ERROR");
+    }
+    const metadata = {};
+    let hasMetadata = false;
+    for (const key of Object.keys(data)) {
+        if (key === textField) {
+            continue;
+        }
+        Object.defineProperty(metadata, key, {
+            value: data[key],
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+        hasMetadata = true;
+    }
+    return {
+        text: textValue,
+        metadata: hasMetadata ? metadata : undefined,
+    };
+}
 /**
  * 格式化渲染 Action 列表。
  */
@@ -19,78 +76,9 @@ export function renderActionList(items, title = "Actions", isFallback = false, i
     lines.push("\nTip: For composite or multi-step tasks, check 'ad playbook list' for standard operating procedures.");
     return lines.join("\n");
 }
-/**
- * 格式化渲染 Action 详情人类可读文本。
- *
- * @param input Action 描述载荷或 Action 规范
- * @returns 格式化后的说明文本
- */
-export function formatActionDetail(input) {
-    const payload = "inputAdvice" in input && input.inputAdvice
-        ? input
-        : buildActionDescribePayload(input);
-    const lines = [];
-    lines.push(`Action: ${payload.id}`);
-    if (payload.packageId) {
-        lines.push(`Package: ${payload.packageId}`);
-    }
-    if (payload.description) {
-        lines.push(`Description: ${payload.description}`);
-    }
-    if (payload.tags && payload.tags.length > 0) {
-        lines.push(`Tags: ${payload.tags.join(", ")}`);
-    }
-    if (payload.uses && payload.uses.length > 0) {
-        lines.push(`Uses: ${payload.uses.join(", ")}`);
-    }
-    if (payload.entry) {
-        lines.push(`Entry: ${payload.entry}`);
-    }
-    if (payload.inputSchema !== undefined) {
-        lines.push("");
-        lines.push("Input Schema:");
-        lines.push(typeof payload.inputSchema === "string"
-            ? payload.inputSchema
-            : JSON.stringify(payload.inputSchema, null, 2));
-    }
-    if (payload.outputSchema !== undefined) {
-        lines.push("");
-        lines.push("Output Schema:");
-        lines.push(typeof payload.outputSchema === "string"
-            ? payload.outputSchema
-            : JSON.stringify(payload.outputSchema, null, 2));
-    }
-    lines.push("");
-    lines.push(`Recommended Input: ${payload.inputAdvice.recommendedMode}`);
-    if (payload.inputAdvice.reason) {
-        lines.push(`Reason: ${payload.inputAdvice.reason}`);
-    }
-    const hasAssignments = Boolean(payload.inputAdvice.assignments &&
-        Object.keys(payload.inputAdvice.assignments).length > 0);
-    if (hasAssignments) {
-        lines.push("");
-        lines.push("Assignments:");
-        for (const [key, op] of Object.entries(payload.inputAdvice.assignments)) {
-            lines.push(`  ${key}${op}`);
-        }
-    }
-    if (payload.inputAdvice.recommendedMode === "flat" || hasAssignments) {
-        lines.push("");
-        lines.push("Syntax Reference:");
-        lines.push(...(payload.syntaxReference || ACTION_DESCRIBE_SYNTAX_REFERENCE));
-    }
-    if (payload.inputAdvice.issues && payload.inputAdvice.issues.length > 0) {
-        lines.push("");
-        lines.push("Issues:");
-        for (const issue of payload.inputAdvice.issues) {
-            lines.push(`  - ${issue.path}: ${issue.code}`);
-        }
-    }
-    return lines.join("\n");
-}
 /**
  * 格式化渲染 Action 详情（编码顾问 Encoding Advisor）。
- * 统一复用 formatActionDetail 实现。
+ * 统一复用核心 formatActionDetail 实现。
  */
 export function renderActionDetail(action) {
     return formatActionDetail(action);
@@ -102,10 +90,19 @@ export function renderActionValidation(results) {
     const lines = [];
     for (const r of results) {
         if (r.valid) {
-            lines.push(`[OK] ${r.id}: Valid`);
+            if (r.warnings && r.warnings.length > 0) {
+                lines.push(`[OK] ${r.id}: Valid (warnings: ${r.warnings.join("; ")})`);
+            }
+            else {
+                lines.push(`[OK] ${r.id}: Valid`);
+            }
         }
         else {
-            lines.push(`[FAIL] ${r.id}: ${r.errors.join(", ")}`);
+            let msg = `[FAIL] ${r.id}: ${r.errors.join(", ")}`;
+            if (r.warnings && r.warnings.length > 0) {
+                msg += ` (warnings: ${r.warnings.join("; ")})`;
+            }
+            lines.push(msg);
         }
     }
     return lines.join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/cli",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "ActionDock CLI facade for developing, testing, building, and exporting standalone Agent Actions and Skills",
   "type": "module",
   "bin": {
@@ -34,10 +34,10 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/builder": "^2.11.0",
-    "@actiondock/core": "^2.11.0",
-    "@actiondock/mcp": "^2.11.0",
-    "@actiondock/sdk": "^2.11.0",
+    "@actiondock/builder": "^2.13.0",
+    "@actiondock/core": "^2.13.0",
+    "@actiondock/mcp": "^2.13.0",
+    "@actiondock/sdk": "^2.13.0",
     "commander": "^13.1.0",
     "selfsigned": "^5.5.0"
   },