@actiondock/cli 2.9.0 → 2.9.1

package/README.md

@@ -174,7 +174,7 @@ $data | ConvertTo-Json -Depth 100 | ad run complex-action --input-file -
 | `ad playbook list` / `show` | 查看智能体操作规程 Playbook |
 | `ad config list` / `get` / `set` | 管理包运行时配置与环境变量绑定 |
 | `ad state list` / `get` / `set` / `delete` / `clear` | 查看与维护 SQLite 持久化状态 |
-| `ad runs list` / `show` | 查询任务执行历史与追踪记录 |
+| `ad runs list` / `show` / `clear` | 查询任务执行历史与追踪记录，或按时间与数量策略清理历史数据 |
 | `ad test` | 执行快速单元测试 |
 | `ad build` | 构建 Node.js 目录交付产物（支持 `--vendor-deps` 与 `--archive`） |
 | `ad pack` | 打包为标准 npm tarball（`.tgz`），支持 `--dry-run` |

package/dist/commands/run.js

@@ -216,6 +216,36 @@ export async function executeAction(id, options, context, flatArgs, control) {
         throw err;
     }
 }
+const RUN_HELP_AFTER_TEXT = `
+Introspection & Guidance:
+  If uncertain about an action's inputs or schemas:
+    ad describe <id>               Inspect action schema, required fields, and assignment examples
+  If handling multi-step tasks or complex workflows:
+    ad playbook list               List available Standard Operating Procedures (SOPs)
+    ad playbook show <id>          View step-by-step procedure and execution rules
+
+Flat Input Syntax & Examples:
+  Standard invocation syntax:
+    ad run <id> [control-options] [-- <assignments...>]
+
+  Flat parameter assignments:
+    # String assignment (= keeps raw string, no type coercion)
+    ad run <id> -- key="value" path="src/index.ts"
+
+    # Typed / JSON assignment (:= parses numbers, booleans, arrays, objects)
+    ad run <id> -- count:=10 enabled:=true timeoutMs:=5000
+
+    # Sequential array indexing (zero-indexed, consecutive)
+    ad run <id> -- paths.0="src" paths.1="docs"
+    # Or direct JSON array
+    ad run <id> -- paths:='["src", "docs"]'
+
+    # Nested object properties
+    ad run <id> -- user.name="alice" user.age:=30
+
+  Complex or multiline inputs:
+    # Pass via JSON file with --input-file to avoid shell escaping issues
+    ad run <id> --input-file input.json`;
 /**
  * 挂载 run 子命令至指定 Commander 节点。
  *
@@ -236,6 +266,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")
+        .addHelpText("after", RUN_HELP_AFTER_TEXT)
         .action(async (id, params, rawOptions, cmd) => {
         let flatArgs;
         let effectiveRawOptions = rawOptions;

package/dist/commands/runs.js

@@ -1,4 +1,4 @@
-import { findProjectRoot, loadProjectConfig, } from "@actiondock/core";
+import { findProjectRoot, loadProjectConfig, parseDuration, } from "@actiondock/core";
 import { filterWithFallbackInfo, } from "@actiondock/core/project";
 import { listLinkedPackages, resolvePackageRoot, } from "@actiondock/core/registry";
 import { ArgumentError, ExecutionError, NO_PROJECT_NO_LINKED_MESSAGE, packageNotFoundError, } from "../errors.js";
@@ -177,7 +177,10 @@ export function registerRunsCommands(program, context) {
         .command("clear")
         .description("Clear execution run records")
         .option("-P, --package <id>", "Target package ID or path")
-        .option("-a, --action <actionId>", "Filter by action ID"))
+        .option("-a, --action <actionId>", "Filter by action ID")
+        .option("--status <status>", "Filter by run status (e.g. success, failed)")
+        .option("--older-than <duration>", "Only clear runs older than specified duration (e.g. 14d, 7d, 24h, 30m)")
+        .option("--keep <count>", "Keep the most recent N runs and clear older ones"))
         .option("--data-dir <path>", "Custom database storage directory")
         .option("--json", "Output as JSON")
         .action(async (rawOptions, cmd) => {
@@ -193,16 +196,49 @@ export function registerRunsCommands(program, context) {
                 // 清单损坏时保留原始 -P 参数作为包标识
             }
         }
+        let olderThanMs;
+        if (options.olderThan) {
+            try {
+                olderThanMs = parseDuration(options.olderThan);
+            }
+            catch (err) {
+                throw new ArgumentError(`Invalid --older-than argument: ${err.message}`);
+            }
+        }
+        let keep;
+        if (options.keep !== undefined) {
+            const parsed = parseInt(String(options.keep), 10);
+            if (isNaN(parsed) || parsed < 0) {
+                throw new ArgumentError("Invalid --keep argument: must be a non-negative integer");
+            }
+            keep = parsed;
+        }
         await withService(options, context, async (service, resolved) => {
             const count = service.runs.clear
-                ? await service.runs.clear({ packageId, actionId: options.action })
+                ? await service.runs.clear({
+                    packageId,
+                    actionId: options.action,
+                    status: options.status,
+                    olderThanMs,
+                    keep,
+                })
                 : 0;
+            const filters = [];
+            if (options.action)
+                filters.push(`action='${options.action}'`);
+            if (options.status)
+                filters.push(`status='${options.status}'`);
+            if (options.olderThan)
+                filters.push(`older than ${options.olderThan}`);
+            if (keep !== undefined)
+                filters.push(`keeping newest ${keep}`);
+            const filterDesc = filters.length > 0 ? ` (${filters.join(", ")})` : "";
             const payload = { ok: true, clearedCount: count };
             renderResult(payload, {
                 json: options.json,
                 humanFormatter: () => resolved.type === "remote"
-                    ? `Cleared ${count} execution run(s) on remote server.`
-                    : `Cleared ${count} execution run(s) in package '${packageId}'.`,
+                    ? `Cleared ${count} execution run(s) on remote server${filterDesc}.`
+                    : `Cleared ${count} execution run(s) in package '${packageId}'${filterDesc}.`,
                 context,
             });
         }, { localRoot: targetPackageRoot });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/cli",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "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.9.0",
-    "@actiondock/core": "^2.9.0",
-    "@actiondock/mcp": "^2.9.0",
-    "@actiondock/sdk": "^2.9.0",
+    "@actiondock/builder": "^2.9.1",
+    "@actiondock/core": "^2.9.1",
+    "@actiondock/mcp": "^2.9.1",
+    "@actiondock/sdk": "^2.9.1",
     "commander": "^13.1.0",
     "selfsigned": "^5.5.0"
   },