@actiondock/cli 2.10.0 → 2.11.0

package/dist/renderers/action.js

@@ -0,0 +1,112 @@
+import { buildActionDescribePayload, ACTION_DESCRIBE_SYNTAX_REFERENCE, } from "@actiondock/core/project";
+/**
+ * 格式化渲染 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}`);
+        }
+    }
+    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 实现。
+ */
+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");
+}

package/dist/renderers/config.d.ts

@@ -0,0 +1,31 @@
+import type { EnvCheckItem } from "../types.js";
+/**
+ * 格式化渲染配置项列表。
+ * 掩码决策收敛在命令层（传入的 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;
+/**
+ * 格式化配置值：字符串原样输出，其余类型 JSON 序列化。
+ */
+export declare function formatConfigValue(value: unknown): 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;

package/dist/renderers/config.js

@@ -0,0 +1,93 @@
+/**
+ * 格式化渲染配置项列表。
+ * 掩码决策收敛在命令层（传入的 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 序列化。
+ */
+export 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");
+}

package/dist/renderers/playbook.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 格式化渲染 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;

package/dist/renderers/playbook.js

@@ -0,0 +1,42 @@
+/**
+ * 格式化渲染 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}`);
+        }
+    }
+    lines.push("\nTip: Run 'ad playbook show <id>' to inspect procedure steps before execution.");
+    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);
+    }
+    lines.push("\nTip: Follow steps sequentially. Invoke constituent actions using 'ad run <action> [options] -- <assignments...>'.");
+    return lines.join("\n");
+}

package/dist/renderers/project.d.ts

@@ -0,0 +1,45 @@
+import type { ProjectDetailInfo, ProjectDetailJson, AggregatedPackage } from "../types.js";
+import type { RegistryStatusReport } from "@actiondock/core/registry";
+/**
+ * 将工程详情信息转换为机器输出视图（结构化配置契约、规程与动作索引）。
+ */
+export declare function projectDetailToJson(info: ProjectDetailInfo): ProjectDetailJson;
+/**
+ * 格式化渲染单个项目的元数据与详情信息。
+ */
+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;

package/dist/renderers/project.js

@@ -0,0 +1,196 @@
+/**
+ * 将工程详情信息转换为机器输出视图（结构化配置契约、规程与动作索引）。
+ */
+export function projectDetailToJson(info) {
+    const config = {};
+    if (info.configDeclared && info.configDeclared.length > 0) {
+        for (const key of info.configDeclared) {
+            const item = info.configDef?.[key];
+            config[key] = {
+                ...(item?.description !== undefined ? { description: item.description } : {}),
+                ...(item?.default !== undefined ? { default: item.default } : {}),
+                secret: Boolean(item?.secret),
+            };
+        }
+    }
+    const playbooks = [];
+    if (info.playbooksMap && info.playbooksMap.size > 0) {
+        for (const [id, pb] of info.playbooksMap.entries()) {
+            playbooks.push({
+                id,
+                ...(pb?.description ? { description: pb.description } : {}),
+            });
+        }
+    }
+    else if (info.playbooks && info.playbooks.length > 0) {
+        for (const pbId of info.playbooks) {
+            playbooks.push({ id: pbId });
+        }
+    }
+    const actions = [];
+    if (info.actionsMap && info.actionsMap.size > 0) {
+        for (const [id, act] of info.actionsMap.entries()) {
+            actions.push({
+                id,
+                ...(act?.description ? { description: act.description } : {}),
+            });
+        }
+    }
+    else if (info.actions && info.actions.length > 0) {
+        for (const actId of info.actions) {
+            actions.push({ id: actId });
+        }
+    }
+    const hints = [
+        "Tip: Run 'ad playbook show <id>' to inspect procedure steps before execution.",
+    ];
+    if (info.configDeclared && info.configDeclared.length > 0) {
+        hints.push("Tip: Run 'ad config set <KEY> <val>' to configure required settings.");
+    }
+    const result = {
+        id: info.id,
+        name: info.name || info.id,
+        version: info.version || "0.0.0",
+        root: info.projectRoot,
+        config,
+        playbooks,
+        actions,
+        hints,
+    };
+    if (info.description) {
+        result.description = info.description;
+    }
+    return result;
+}
+/**
+ * 格式化渲染单个项目的元数据与详情信息。
+ */
+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}`);
+    if (info.configDeclared.length > 0) {
+        lines.push(`\nDeclared Config Keys (${info.configDeclared.length}):`);
+        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}`);
+        }
+    }
+    lines.push(`\nPlaybooks (${info.playbooksCount}):`);
+    if (info.playbooksMap && info.playbooksMap.size > 0) {
+        for (const [id, pb] of info.playbooksMap.entries()) {
+            lines.push(`  - ${id.padEnd(28)} ${pb.description || ""}`);
+        }
+    }
+    else if (info.playbooks && info.playbooks.length > 0) {
+        for (const pbId of info.playbooks) {
+            lines.push(`  - ${pbId}`);
+        }
+    }
+    else {
+        lines.push("  (no playbooks declared)");
+    }
+    lines.push(`\nActions (${info.actionsCount}):`);
+    const actionList = [];
+    if (info.actionsMap) {
+        for (const [id, act] of info.actionsMap.entries()) {
+            actionList.push({ id, description: act.description || "" });
+        }
+    }
+    else if (info.actions) {
+        for (const actId of info.actions) {
+            actionList.push({ id: actId, description: "" });
+        }
+    }
+    if (actionList.length === 0) {
+        lines.push("  (no actions declared)");
+    }
+    else {
+        for (const a of actionList) {
+            lines.push(`  - ${a.id.padEnd(28)} ${a.description}`);
+        }
+    }
+    lines.push("\nTip: Run 'ad playbook show <id>' to inspect procedure steps before execution.");
+    if (info.configDeclared.length > 0) {
+        lines.push("Tip: Run 'ad config set <KEY> <val>' to configure required settings.");
+    }
+    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");
+}

package/dist/renderers/runs.d.ts

@@ -0,0 +1,15 @@
+import type { RunRecord } from "@actiondock/sdk";
+/**
+ * 格式化渲染执行记录列表。
+ */
+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/renderers/runs.js

@@ -0,0 +1,47 @@
+/**
+ * 格式化渲染执行记录列表。
+ */
+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}`);
+    if (run.requestId)
+        lines.push(`Request ID:   ${run.requestId}`);
+    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");
+}

package/dist/renderers/state.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 格式化渲染状态键列表。
+ */
+export declare function renderStateList(keys: string[], scopeLabel?: string, isFallback?: boolean, intent?: string): string;

package/dist/renderers/state.js

@@ -0,0 +1,19 @@
+/**
+ * 格式化渲染状态键列表。
+ */
+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");
+}

package/dist/services/config-merge.js

@@ -1,6 +1,5 @@
 import { isSecretConfigKey, maskSecretValue, } from "@actiondock/core/project";
-import { loadProjectConfig, } from "@actiondock/core";
-import { resolveEnvValue, } from "@actiondock/core/profile";
+import { loadProjectConfig, resolveEnvValue, } from "@actiondock/core";
 /**
  * 解析单个配置键的合并视图（项目包级 > 全局持久化 > 环境变量 > 声明默认值）。
  *

package/dist/services/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./inspect.js";
 export * from "./config-merge.js";
+export * from "./run-watch.js";

package/dist/services/index.js

@@ -1,2 +1,3 @@
 export * from "./inspect.js";
 export * from "./config-merge.js";
+export * from "./run-watch.js";