@actiondock/cli 2.9.1 → 2.11.0

package/dist/index.js

@@ -1,5 +1,6 @@
 import { CommanderError } from "commander";
-import { createCliProgram } from "./commands/index.js";
+import { StandaloneDispatcher } from "@actiondock/core/server";
+import { createCliProgram, isNodeArgv } from "./commands/index.js";
 import { formatError, SigintError } from "./errors.js";
 import { renderError } from "./renderer.js";
 import { ExitCode } from "./types.js";
@@ -7,10 +8,21 @@ export * from "./types.js";
 export * from "./errors.js";
 export * from "./renderer.js";
 export * from "./prompt.js";
-export * from "./standalone/index.js";
 export * from "./utils/index.js";
 export * from "./services/index.js";
 export * from "./commands/index.js";
+/**
+ * 运行独立二进制参数解析分发器并返回退出状态码（委托 Core 统一实现）。
+ */
+export async function runStandaloneCli(argv = process.argv.slice(2), options, control) {
+    const dispatcher = new StandaloneDispatcher(options);
+    return dispatcher.dispatch(argv, control);
+}
+/**
+ * 独立二进制进程入口适配器（事实源位于 core 包，此处 re-export 维持既有导入路径兼容）。
+ * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
+ */
+export { runStandaloneProcess } from "@actiondock/core/server";
 /**
  * ActionDock CLI 主执行入口函数。
  *
@@ -22,16 +34,7 @@ export async function main(argv = process.argv, control, contextOptions) {
     const context = { control, exitCode: 0, ...contextOptions };
     const program = createCliProgram(context);
     const isMachine = argv.includes("--json");
-    const normalizedArgv = argv.length >= 2 &&
-        (argv[0].endsWith("node") ||
-            argv[0].endsWith("bun") ||
-            argv[0].endsWith("tsx") ||
-            argv[1].includes("/") ||
-            argv[1].includes("\\") ||
-            argv[1].endsWith(".js") ||
-            argv[1].endsWith(".ts"))
-        ? argv
-        : ["node", "ad", ...argv];
+    const normalizedArgv = isNodeArgv(argv) ? argv : ["node", "ad", ...argv];
     try {
         await program.parseAsync(normalizedArgv);
         if (control?.cancellationSource === "sigint" && control?.signal?.aborted) {

package/dist/prompt.d.ts

@@ -34,6 +34,9 @@ export declare function promptText(promptText: string, options?: {
 export declare function readStreamLine(stream: NodeJS.ReadableStream): Promise<string>;
 /**
  * 从流中完整读取所有数据，并移除末尾的换行符。
+ *
+ * 委托 readStdinBounded 统一收集：保留宽松 UTF-8 解码与 BOM，
+ * 补齐默认 10MB 上限保护，流错误通过 INPUT_FILE_READ_FAILED 透传。
  */
 export declare function readEntireStdin(stream?: NodeJS.ReadableStream): Promise<string>;
 /**

package/dist/prompt.js

@@ -1,4 +1,5 @@
 import { createInterface } from "node:readline";
+import { readStdinBounded } from "@actiondock/core/project";
 import { ArgumentError, SigintError } from "./errors.js";
 /**
  * 在终端中安全交互式读取用户输入的密码或敏感信息。
@@ -126,22 +127,13 @@ export async function readStreamLine(stream) {
 }
 /**
  * 从流中完整读取所有数据，并移除末尾的换行符。
+ *
+ * 委托 readStdinBounded 统一收集：保留宽松 UTF-8 解码与 BOM，
+ * 补齐默认 10MB 上限保护，流错误通过 INPUT_FILE_READ_FAILED 透传。
  */
 export async function readEntireStdin(stream = process.stdin) {
-    return new Promise((resolve, reject) => {
-        const chunks = [];
-        stream.on("data", (chunk) => {
-            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-        });
-        stream.once("end", () => {
-            const content = Buffer.concat(chunks).toString("utf-8");
-            resolve(content.replace(/[\r\n]+$/, ""));
-        });
-        stream.once("error", reject);
-        if ("resume" in stream && typeof stream.resume === "function") {
-            stream.resume();
-        }
-    });
+    const content = await readStdinBounded(stream, { strictUtf8: false });
+    return content.replace(/[\r\n]+$/, "");
 }
 /**
  * 解析并获取配置项的具体输入值。

package/dist/renderer.d.ts

@@ -1,6 +1,10 @@
-import type { RunRecord } from "@actiondock/sdk";
-import { type RegistryStatusReport } from "@actiondock/core/registry";
-import type { Envelope, ProjectDetailInfo, AggregatedPackage, EnvCheckItem, CliContext } from "./types.js";
+import type { Envelope, CliContext } from "./types.js";
+export * from "./renderers/project.js";
+export * from "./renderers/action.js";
+export * from "./renderers/playbook.js";
+export * from "./renderers/config.js";
+export * from "./renderers/state.js";
+export * from "./renderers/runs.js";
 /**
  * 构造标准成功结果信封。
  *
@@ -16,7 +20,7 @@ export declare function createSuccessEnvelope<T>(data: T, meta?: Record<string,
  * @param details 附加错误细节
  * @param meta 附加元数据
  */
-export declare function createErrorEnvelope(code: string, message: string, details?: unknown, meta?: Record<string, unknown>): Envelope<never>;
+export declare function createErrorEnvelope(code: string, message: string, details?: unknown, meta?: Record<string, unknown>, hint?: string): Envelope<never>;
 /**
  * 序列化数据为格式化 JSON 字符串。
  *
@@ -47,150 +51,3 @@ export declare function renderError(err: unknown, options: {
     json?: boolean;
     context?: CliContext;
 }): void;
-/**
- * 将工程详情信息转换为机器输出视图（剔除 Map 明细与定义字典）。
- */
-export declare function projectDetailToJson(info: ProjectDetailInfo): {
-    id: string;
-    name: string;
-    version: string;
-    description: string | undefined;
-    projectRoot: string;
-    actionsDir: string;
-    playbooksDir: string;
-    actionsCount: number;
-    playbooksCount: number;
-    actions: string[];
-    playbooks: string[];
-    configDeclared: string[];
-};
-/**
- * 格式化渲染单个项目的元数据与详情信息。
- */
-export declare function renderProjectDetail(info: ProjectDetailInfo): string;
-/**
- * 格式化渲染已链接的多个 Package 摘要信息。
- */
-export declare function renderAggregatedPackages(packages: AggregatedPackage[], options?: {
-    header?: string;
-    showTip?: boolean;
-}): string;
-/**
- * 远端 info 接口返回的注册表树视图（与 RegistryStatusReport 字段兼容的宽松结构）。
- */
-export type RegistryTreeView = RegistryStatusReport | (Record<string, unknown> & {
-    workspaces?: Array<{
-        id?: string;
-        path: string;
-        status: string;
-        packagesCount?: number;
-        children?: Array<{
-            id: string;
-            version?: string;
-            path: string;
-        }>;
-    }>;
-    packages?: Array<{
-        id: string;
-        version?: string;
-        path: string;
-        status: string;
-    }>;
-    totalPackagesCount?: number;
-    staleCount?: number;
-});
-/**
- * 格式化渲染注册表层级树结构。
- */
-export declare function renderRegistryTree(status: RegistryTreeView): string;
-/**
- * 格式化渲染 Action 列表。
- */
-export declare function renderActionList(items: Array<{
-    id: string;
-    description: string;
-    packageId?: string;
-}>, title?: string, isFallback?: boolean, intent?: string): string;
-/**
- * 格式化渲染 Action 详情（编码顾问 Encoding Advisor）。
- * 统一复用 core 下沉的 formatActionDetail 实现，与独立分发器保持完全一致。
- */
-export declare function renderActionDetail(action: {
-    id: string;
-    packageId?: string;
-    projectRoot?: string;
-    description?: string;
-    inputSchema?: unknown;
-    outputSchema?: unknown;
-}): string;
-/**
- * 格式化渲染 Action 校验结果。
- */
-export declare function renderActionValidation(results: Array<{
-    id: string;
-    valid: boolean;
-    errors: string[];
-}>): string;
-/**
- * 格式化渲染 Playbook 列表。
- */
-export declare function renderPlaybookList(items: Array<{
-    id: string;
-    description?: string;
-    packageId?: string;
-}>, title?: string, isFallback?: boolean, intent?: string): string;
-/**
- * 格式化渲染 Playbook 详情。
- */
-export declare function renderPlaybookDetail(pb: {
-    id: string;
-    packageId?: string;
-    description?: string;
-    actions?: string[];
-    filePath?: string;
-    content?: string;
-}): string;
-/**
- * 格式化渲染配置项列表。
- * 掩码决策收敛在命令层（传入的 value 已完成是否打码处理），
- * 此处仅负责值的字符串格式化：字符串原样输出，其余类型 JSON 序列化。
- */
-export declare function renderConfigList(items: Array<{
-    key: string;
-    value: unknown;
-    source: string;
-    secret: boolean;
-    description?: string;
-}>, scopeLabel?: string, isFallback?: boolean, intent?: string): string;
-/**
- * 格式化渲染配置依赖规范检查。
- */
-export declare function renderConfigSchema(items: Array<{
-    key: string;
-    status: string;
-    source: string;
-    secret: boolean;
-    description: string;
-}>, packageId: string, root: string): string;
-/**
- * 格式化渲染环境变量满足率诊断。
- */
-export declare function renderConfigEnv(checks: EnvCheckItem[], packageId?: string): string;
-/**
- * 格式化渲染状态键列表。
- */
-export declare function renderStateList(keys: string[], scopeLabel?: string, isFallback?: boolean, intent?: string): string;
-/**
- * 格式化渲染执行记录列表。
- */
-export declare function renderRunsList(items: Array<{
-    id: string;
-    actionId: string;
-    packageId?: string;
-    status: string;
-    startedAt: string;
-}>, scopeLabel?: string, isFallback?: boolean, intent?: string): string;
-/**
- * 格式化渲染单次执行记录详情。
- */
-export declare function renderRunDetail(run: RunRecord): string;

package/dist/renderer.js

@@ -1,5 +1,10 @@
-import { formatActionDetail, } from "@actiondock/core/project";
 import { formatError } from "./errors.js";
+export * from "./renderers/project.js";
+export * from "./renderers/action.js";
+export * from "./renderers/playbook.js";
+export * from "./renderers/config.js";
+export * from "./renderers/state.js";
+export * from "./renderers/runs.js";
 /**
  * 构造标准成功结果信封。
  *
@@ -24,7 +29,11 @@ export function createSuccessEnvelope(data, meta) {
  * @param details 附加错误细节
  * @param meta 附加元数据
  */
-export function createErrorEnvelope(code, message, details, meta) {
+export function createErrorEnvelope(code, message, details, meta, hint) {
+    const effectiveHint = hint ??
+        (details && typeof details === "object" && typeof details.hint === "string"
+            ? details.hint
+            : undefined);
     const result = {
         ok: false,
         error: {
@@ -33,6 +42,9 @@ export function createErrorEnvelope(code, message, details, meta) {
             ...(details !== undefined ? { details } : {}),
         },
     };
+    if (effectiveHint !== undefined) {
+        result.hint = effectiveHint;
+    }
     if (meta && Object.keys(meta).length > 0) {
         result.meta = meta;
     }
@@ -93,383 +105,13 @@ export function renderError(err, options) {
     const formatted = formatError(err);
     const isMachine = Boolean(options.json);
     if (isMachine) {
-        const errorEnv = createErrorEnvelope(formatted.code, formatted.message, formatted.details);
+        const errorEnv = createErrorEnvelope(formatted.code, formatted.message, formatted.details, undefined, formatted.hint);
         writeStdout(formatJson(errorEnv), options.context);
     }
     else {
         writeStderr(`Error: ${formatted.message}`, options.context);
-    }
-}
-/**
- * 将工程详情信息转换为机器输出视图（剔除 Map 明细与定义字典）。
- */
-export function projectDetailToJson(info) {
-    return {
-        id: info.id,
-        name: info.name || info.id,
-        version: info.version || "0.0.0",
-        description: info.description,
-        projectRoot: info.projectRoot,
-        actionsDir: info.actionsDir,
-        playbooksDir: info.playbooksDir,
-        actionsCount: info.actionsCount,
-        playbooksCount: info.playbooksCount,
-        actions: info.actions,
-        playbooks: info.playbooks,
-        configDeclared: info.configDeclared,
-    };
-}
-/**
- * 格式化渲染单个项目的元数据与详情信息。
- */
-export function renderProjectDetail(info) {
-    const lines = [];
-    lines.push(`ActionDock Project: ${info.name} (${info.id})`);
-    lines.push(`Version:     ${info.version}`);
-    if (info.description) {
-        lines.push(`Description: ${info.description}`);
-    }
-    lines.push(`Root:        ${info.projectRoot}`);
-    lines.push(`\nActions (${info.actionsCount}):`);
-    if (info.actionsMap) {
-        for (const [id, act] of info.actionsMap.entries()) {
-            lines.push(`  - ${id.padEnd(28)} ${act.description || ""}`);
-        }
-    }
-    else {
-        for (const actId of info.actions) {
-            lines.push(`  - ${actId}`);
-        }
-    }
-    lines.push(`\nPlaybooks (${info.playbooksCount}):`);
-    if (info.playbooksMap) {
-        for (const [id, pb] of info.playbooksMap.entries()) {
-            lines.push(`  - ${id.padEnd(28)} ${pb.description || ""}`);
+        if (formatted.hint) {
+            writeStderr(formatted.hint, options.context);
         }
     }
-    else {
-        for (const pbId of info.playbooks) {
-            lines.push(`  - ${pbId}`);
-        }
-    }
-    if (info.configDeclared.length > 0) {
-        lines.push(`\nDeclared Config Keys:`);
-        for (const k of info.configDeclared) {
-            const item = info.configDef?.[k];
-            const isSec = item?.secret ? " [secret]" : "";
-            const def = item?.default !== undefined ? ` (default: ${JSON.stringify(item.default)})` : "";
-            lines.push(`  - ${k.padEnd(24)} ${item?.description || ""}${def}${isSec}`);
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染已链接的多个 Package 摘要信息。
- */
-export function renderAggregatedPackages(packages, options) {
-    const lines = [];
-    if (options?.header) {
-        lines.push(options.header);
-    }
-    else {
-        lines.push(`ActionDock Linked Packages (${packages.length}):\n`);
-    }
-    for (const p of packages) {
-        lines.push(`- ${p.name} (${p.id}) v${p.version}`);
-        lines.push(`  Path:      ${p.path}`);
-        if (p.description) {
-            lines.push(`  Desc:      ${p.description}`);
-        }
-        lines.push(`  Actions (${p.actionsCount}):   ${p.actions.join(", ") || "(none)"}`);
-        lines.push(`  Playbooks (${p.playbooksCount}): ${p.playbooks.join(", ") || "(none)"}`);
-        lines.push("");
-    }
-    if (options?.showTip !== false) {
-        lines.push("Tip: Run 'ad info <package-id>' to view detailed package configuration and schema.");
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染注册表层级树结构。
- */
-export function renderRegistryTree(status) {
-    const lines = [];
-    const workspaces = status.workspaces || [];
-    const packages = status.packages || [];
-    const hasWorkspaces = workspaces.length > 0;
-    const hasPackages = packages.length > 0;
-    if (!hasWorkspaces && !hasPackages) {
-        lines.push("[INFO] No ActionDock packages or workspaces currently linked.");
-        lines.push("       Run 'ad link' inside an Action package or workspace to register it.");
-        return lines.join("\n");
-    }
-    lines.push("[ActionDock Workspace & Package Tree]\n");
-    if (hasWorkspaces) {
-        lines.push("Workspaces:");
-        for (const ws of workspaces) {
-            const tag = ws.status === "active" ? "[OK]" : "[STALE]";
-            lines.push(`  ${tag} ${ws.path} (${ws.packagesCount} package${ws.packagesCount === 1 ? "" : "s"})`);
-            if (ws.children && ws.children.length > 0) {
-                const children = ws.children;
-                children.forEach((child, idx) => {
-                    const isLast = idx === children.length - 1;
-                    const prefix = isLast ? "    +-- " : "    |-- ";
-                    lines.push(`${prefix}${child.id} (v${child.version}) -> ${child.path}`);
-                });
-            }
-        }
-    }
-    if (hasPackages) {
-        if (hasWorkspaces)
-            lines.push("");
-        lines.push("Standalone Packages:");
-        for (const pkg of packages) {
-            const tag = pkg.status === "active" ? "[OK]" : "[STALE]";
-            lines.push(`  ${tag} ${pkg.id} (v${pkg.version || "unknown"}) -> ${pkg.path}`);
-        }
-    }
-    const totalActive = status.totalPackagesCount ?? packages.length;
-    lines.push(`\n[Summary] Total: ${totalActive} active package(s), ${workspaces.length} workspace(s)`);
-    if (status.staleCount && status.staleCount > 0) {
-        lines.push(`[WARN] ${status.staleCount} stale entry/entries detected. Run 'ad unlink --prune' to clean up.`);
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染 Action 列表。
- */
-export function renderActionList(items, title = "Actions", isFallback = false, intent) {
-    const lines = [];
-    lines.push(`${title}:\n`);
-    if (isFallback && intent) {
-        lines.push(`(No actions matched intent '${intent}', showing all actions)\n`);
-    }
-    if (items.length === 0) {
-        lines.push("  (no actions found)");
-    }
-    else {
-        for (const a of items) {
-            lines.push(`  - ${a.id.padEnd(28)} ${a.description}`);
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染 Action 详情（编码顾问 Encoding Advisor）。
- * 统一复用 core 下沉的 formatActionDetail 实现，与独立分发器保持完全一致。
- */
-export function renderActionDetail(action) {
-    return formatActionDetail(action);
-}
-/**
- * 格式化渲染 Action 校验结果。
- */
-export function renderActionValidation(results) {
-    const lines = [];
-    for (const r of results) {
-        if (r.valid) {
-            lines.push(`[OK] ${r.id}: Valid`);
-        }
-        else {
-            lines.push(`[FAIL] ${r.id}: ${r.errors.join(", ")}`);
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染 Playbook 列表。
- */
-export function renderPlaybookList(items, title = "Playbooks", isFallback = false, intent) {
-    const lines = [];
-    lines.push(`${title}:\n`);
-    if (isFallback && intent) {
-        lines.push(`(No playbooks matched intent '${intent}', showing all playbooks)\n`);
-    }
-    if (items.length === 0) {
-        lines.push("  (no playbooks found)");
-    }
-    else {
-        for (const p of items) {
-            const pkgDesc = p.packageId ? ` (Package: ${p.packageId})` : "";
-            lines.push(`  - ${p.id.padEnd(26)} ${p.description}${pkgDesc}`);
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染 Playbook 详情。
- */
-export function renderPlaybookDetail(pb) {
-    const lines = [];
-    const pkgDesc = pb.packageId ? ` (Package: ${pb.packageId})` : "";
-    lines.push(`Playbook:    ${pb.id}${pkgDesc}`);
-    if (pb.description)
-        lines.push(`Description: ${pb.description}`);
-    if (pb.actions && pb.actions.length > 0) {
-        lines.push(`Actions:     ${pb.actions.join(", ")}`);
-    }
-    if (pb.filePath)
-        lines.push(`File:        ${pb.filePath}\n`);
-    if (pb.content) {
-        lines.push("--- Content ---");
-        lines.push(pb.content);
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染配置项列表。
- * 掩码决策收敛在命令层（传入的 value 已完成是否打码处理），
- * 此处仅负责值的字符串格式化：字符串原样输出，其余类型 JSON 序列化。
- */
-export function renderConfigList(items, scopeLabel = "Global Scope", isFallback = false, intent) {
-    const lines = [];
-    lines.push(`Configurations [${scopeLabel}]:\n`);
-    if (isFallback && intent) {
-        lines.push(`(No config entries matched intent '${intent}', showing all entries)\n`);
-    }
-    if (items.length === 0) {
-        lines.push("  (No configuration entries found)");
-    }
-    else {
-        for (const item of items) {
-            const valStr = formatConfigValue(item.value);
-            const secretBadge = item.secret ? ", secret" : "";
-            lines.push(`  - ${item.key.padEnd(24)} = ${valStr} (${item.source}${secretBadge})`);
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化配置值：字符串原样输出，其余类型 JSON 序列化。
- */
-function formatConfigValue(value) {
-    return typeof value === "string" ? value : JSON.stringify(value);
-}
-/**
- * 格式化渲染配置依赖规范检查。
- */
-export function renderConfigSchema(items, packageId, root) {
-    const lines = [];
-    lines.push(`Configuration Requirements for ${packageId} (${root}):\n`);
-    if (items.length === 0) {
-        lines.push("  (No configuration dependencies declared for this package)");
-        return lines.join("\n");
-    }
-    lines.push(`  ${"KEY".padEnd(24)} ${"STATUS".padEnd(12)} ${"SOURCE".padEnd(10)} ${"SECRET".padEnd(8)} DESCRIPTION`);
-    lines.push("  " + "-".repeat(85));
-    const missing = [];
-    for (const item of items) {
-        const statusLabel = item.status === "SET" ? "[SET]" : item.status === "DEFAULT" ? "[DEFAULT]" : "[MISSING]";
-        const secretLabel = item.secret ? "yes" : "no";
-        lines.push(`  ${item.key.padEnd(24)} ${statusLabel.padEnd(12)} ${item.source.padEnd(10)} ${secretLabel.padEnd(8)} ${item.description}`);
-        if (item.status === "MISSING") {
-            missing.push(item.key);
-        }
-    }
-    if (missing.length > 0) {
-        lines.push(`\n[WARNING] ${missing.length} required config(s) not set:`);
-        for (const m of missing) {
-            lines.push(`  - ${m}: Run 'ad config set ${m} <value>' to configure.`);
-        }
-    }
-    else {
-        lines.push("\n[OK] All configuration dependencies are satisfied.");
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染环境变量满足率诊断。
- */
-export function renderConfigEnv(checks, packageId) {
-    const lines = [];
-    const targetDesc = packageId ? `for Package '${packageId}'` : "Global";
-    lines.push(`Environment Variable Satisfaction Diagnostics ${targetDesc}:\n`);
-    if (checks.length === 0) {
-        lines.push("  (No configuration dependencies declared)");
-        return lines.join("\n");
-    }
-    lines.push(`  ${"KEY".padEnd(24)} ${"SATISFIED".padEnd(12)} ${"REQUIRED".padEnd(10)} ${"MATCHED ENV".padEnd(28)} SECRET`);
-    lines.push("  " + "-".repeat(85));
-    for (const c of checks) {
-        const satLabel = c.satisfied ? "[OK]" : "[MISSING]";
-        const reqLabel = c.required ? "yes" : "no";
-        const matched = c.matchedEnv || (c.hasDefault ? "(using default)" : "-");
-        const secLabel = c.secret ? "yes" : "no";
-        lines.push(`  ${c.key.padEnd(24)} ${satLabel.padEnd(12)} ${reqLabel.padEnd(10)} ${matched.padEnd(28)} ${secLabel}`);
-    }
-    const missingRequired = checks.filter((c) => c.required && !c.satisfied);
-    if (missingRequired.length > 0) {
-        lines.push(`\n[WARNING] ${missingRequired.length} required environment variable(s) not satisfied:`);
-        for (const m of missingRequired) {
-            lines.push(`  - ${m.key}: Please export ${m.key}=... in your environment.`);
-        }
-    }
-    else {
-        lines.push("\n[OK] All declared configuration dependencies are satisfied by environment or defaults.");
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染状态键列表。
- */
-export function renderStateList(keys, scopeLabel = "Current State", isFallback = false, intent) {
-    const lines = [];
-    lines.push(`State keys for ${scopeLabel} (${keys.length}):\n`);
-    if (isFallback && intent) {
-        lines.push(`(No state keys matched intent '${intent}', showing all keys)\n`);
-    }
-    if (keys.length === 0) {
-        lines.push("  (no state keys found)");
-    }
-    else {
-        for (const k of keys) {
-            lines.push(`  - ${k}`);
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染执行记录列表。
- */
-export function renderRunsList(items, scopeLabel = "Execution Runs", isFallback = false, intent) {
-    const lines = [];
-    lines.push(`${scopeLabel} (${items.length}):\n`);
-    if (isFallback && intent) {
-        lines.push(`(No runs matched intent '${intent}', showing all runs)\n`);
-    }
-    lines.push(`  ${"RUN ID".padEnd(38)} ${"PACKAGE".padEnd(18)} ${"ACTION".padEnd(22)} ${"STATUS".padEnd(10)} STARTED`);
-    lines.push("  " + "-".repeat(105));
-    for (const r of items) {
-        const time = (r.startedAt || "").replace("T", " ").slice(0, 19);
-        const pkg = (r.packageId || "").padEnd(18);
-        lines.push(`  ${r.id.padEnd(38)} ${pkg} ${r.actionId.padEnd(22)} ${r.status.padEnd(10)} ${time}`);
-    }
-    return lines.join("\n");
-}
-/**
- * 格式化渲染单次执行记录详情。
- */
-export function renderRunDetail(run) {
-    const lines = [];
-    lines.push(`Run:          ${run.id}`);
-    lines.push(`Action:       ${run.actionId}`);
-    if (run.packageId)
-        lines.push(`Package:      ${run.packageId}`);
-    lines.push(`Status:       ${run.status}`);
-    if (run.parentRunId)
-        lines.push(`Parent Run:   ${run.parentRunId}`);
-    lines.push(`Started:      ${run.startedAt}`);
-    if (run.finishedAt)
-        lines.push(`Finished:     ${run.finishedAt}`);
-    lines.push("\nInput:");
-    lines.push(JSON.stringify(run.input, null, 2));
-    if (run.output !== undefined) {
-        lines.push("\nOutput:");
-        lines.push(JSON.stringify(run.output, null, 2));
-    }
-    if (run.error) {
-        lines.push("\nError:");
-        lines.push(JSON.stringify(run.error, null, 2));
-    }
-    return lines.join("\n");
 }