akm-cli 0.9.9-beta.1 → 0.9.10

package/CHANGELOG.md

@@ -4,7 +4,18 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## [0.9.9-beta.1] - 2026-09-02
+## [0.9.10] - 2026-09-02
+
+### Fixed
+
+- **`akm task history <id>` now filters to that task instead of silently
+  ignoring the positional id (#911).** `task run <id>` and `task explain <ref>`
+  take the id positionally, so `task history <id>` was the natural thing to
+  write, and it answered with every task's newest rows while exiting 0. A
+  positional id now means the same as `--id`; passing both with different
+  values is a usage error (exit 2) rather than a silent pick.
+
+## [0.9.9] - 2026-09-02
 
 ### Changed
 

package/dist/commands/tasks/tasks-cli.js

@@ -289,9 +289,23 @@ const tasksRunCommand = defineCommand({
         });
     },
 });
+/**
+ * #911: `task run <id>` and `task explain <ref>` take the id positionally, so
+ * `task history <id>` is the natural thing to write — and it used to be
+ * accepted and silently discarded, answering with every task's newest rows.
+ * A positional id now means the same as `--id`; giving both with different
+ * values is a usage error rather than a silent pick.
+ */
+export function resolveTaskHistoryId(positional, flag) {
+    if (positional !== undefined && flag !== undefined && positional !== flag) {
+        throw new UsageError(`\`akm task history\` was given two task ids: "${positional}" and --id "${flag}". Pass one.`, "INVALID_FLAG_VALUE");
+    }
+    return flag ?? positional;
+}
 const tasksHistoryCommand = defineJsonCommand({
     meta: { name: "history", description: "Show recent task run history" },
     args: {
+        task: { type: "positional", description: "Task id to filter to (same as --id)", required: false },
         id: { type: "string", description: "Filter to one task id" },
         limit: { type: "string", description: "Maximum rows to return (default 50)" },
         ...bundleArg,
@@ -299,7 +313,8 @@ const tasksHistoryCommand = defineJsonCommand({
     async run({ args }) {
         rejectRetiredTaskTargetFlag();
         const limit = parsePositiveIntFlag(args.limit ?? undefined);
-        const result = await akmTasksHistory({ id: args.id, limit, target: args.bundle });
+        const id = resolveTaskHistoryId(args.task, args.id);
+        const result = await akmTasksHistory({ id, limit, target: args.bundle });
         output("task-history", result);
     },
 });

package/docs/reference/cli.md

@@ -2472,7 +2472,7 @@ akm task add nightly --schedule "@daily" --command "akm improve" --disabled  # r
 akm task add nightly --schedule "@daily" --command "akm improve" --force    # overwrite an existing task id
 akm task run <id>                           # Execute now (what the scheduler calls)
 akm task explain <ref>                      # Read-only: declared inputs, target, schedule — spawns nothing
-akm task history [--id <id>] [--limit <n>]  # Recent runs from state.db
+akm task history [<id>] [--id <id>] [--limit <n>]  # Recent runs from state.db (positional id == --id)
 akm task sync                               # Reconcile on-disk YAML with scheduler
 akm task sync --dry-run                     # Preview the reconcile — zero scheduler writes
 akm task sync --rebind                      # Also capture the current installed runtime

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.9.9-beta.1",
+  "version": "0.9.10",
   "type": "module",
   "description": "akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cursor.",
   "keywords": [