@eigenpal/cli 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/cli
 
+## 0.6.2
+
+### Patch Changes
+
+- d2202b6: List all agent runs for unqualified targets, and reserve source-ref filtering for explicit `@ref` targets.
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/cli.js

@@ -188719,7 +188719,7 @@ import { fileURLToPath as fileURLToPath6 } from "url";
 // package.json
 var package_default = {
   name: "@eigenpal/cli",
-  version: "0.6.1",
+  version: "0.6.2",
   description: "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   keywords: [
     "eigenpal",
@@ -191162,12 +191162,16 @@ function parseAgentTarget(target) {
   const [rawTarget, rawRef, extra] = target.split("@");
   if (extra !== undefined)
     throw new Error("Agent target must be <slug>[@ref].");
-  const normalizedTarget = rawTarget.includes(".") ? target : `agents.${rawTarget}${rawRef ? `@${rawRef}` : ""}`;
+  const normalizedTarget = rawTarget.includes(".") ? target : `agents.${rawTarget}${rawRef !== undefined ? `@${rawRef}` : ""}`;
   const parsed = parseAutomationTarget(normalizedTarget);
   if (parsed.type !== "agents") {
     throw new Error("Only agent targets are supported in this release. Use agents.<slug>[@ref].");
   }
-  return { packageName: parsed.packageName, slug: parsed.slug, sourceRef: parsed.ref };
+  return {
+    packageName: parsed.packageName,
+    slug: parsed.slug,
+    sourceRef: rawRef !== undefined ? parsed.ref : undefined
+  };
 }
 async function runTarget(target, opts) {
   const parsed = parseAgentTarget(target);
@@ -191212,7 +191216,7 @@ function registerRunCommands(agent) {
     process.stderr.write("`eigenpal agents runs` requires a subcommand. Run `eigenpal agents runs --help`.\n");
     process.exit(2);
   });
-  const listRunsCmd = addJsonFlag(withPagination(withBaseUrl(runs.command("list <target>")), 50)).description("List runs for an agent target, e.g. agents.invoice-agent.").option("--status <status>", "Filter by run status").option("--include <items>", "Comma-separated include list").option("--compact", "Render compact run rows").option("--sort <field>", "Sort field").option("--order <asc|desc>", "Sort order");
+  const listRunsCmd = addJsonFlag(withPagination(withBaseUrl(runs.command("list <target>")), 50)).description("List runs for an agent target; unqualified targets include all source refs.").option("--status <status>", "Filter by run status").option("--include <items>", "Comma-separated include list").option("--compact", "Render compact run rows").option("--sort <field>", "Sort field").option("--order <asc|desc>", "Sort order");
   listRunsCmd.action(action(listRunsTarget));
   addJsonFlag(withBaseUrl(runs.command("get <run-id>"))).description("Get one agent run.").option("--include <parts>", "Comma-separated extra parts: feedback,expected,files,trace,issues", "feedback").action(action(getRun));
   addJsonFlag(withBaseUrl(runs.command("rerun <run-id>"))).description("Create a new run from a previous run's stored input snapshot.").option("--wait", "Poll until the rerun reaches a terminal status").option("--interval <seconds>", "Polling interval in seconds", intArg, 2).option("--max-wait <seconds>", "Maximum wait before exiting 2", intArg, 1800).action(action(rerunRun));

package/dist/skill/SKILL.md

@@ -148,7 +148,7 @@ eigenpal agents save -m "Improve invoice extraction prompts"
 SOURCE_REF="$(eigenpal git -- rev-parse HEAD)"
 eigenpal agents run agents.<slug>@"$SOURCE_REF" --input-json '{"text":"hello"}' --wait
 eigenpal agents run agents.<slug>@"$SOURCE_REF" --example example-name --wait
-eigenpal agents runs get <agent-execution-id> --json
+eigenpal agents runs get <agent-execution-id> --json | jq '.run'
 eigenpal agents runs trace <agent-execution-id> --out ./trace.jsonl
 
 # 5. Release to main + tag when ready to ship (-m optional; defaults to "Release <packagePath>").
@@ -192,11 +192,13 @@ Run a persisted example with `eigenpal agents run agents.<slug>@<ref> --example
 ### Debug Agent Runs
 
 ```bash
+eigenpal agents runs list agents.<slug> --compact
 eigenpal agents runs list agents.<slug> --status failed --compact
 eigenpal agents runs pull <agent-execution-id> --include all --out ./review/<agent-execution-id>
 eigenpal agents runs trace <agent-execution-id> --out ./review/<agent-execution-id>/trace.jsonl
 eigenpal agents runs rerun <agent-execution-id> --wait
 eigenpal agents runs compare <source-agent-execution-id> <new-agent-execution-id> \
+  --baseline \
   --normalize-dates
 
 eigenpal agents runs feedback resolve <source-agent-execution-id> \
@@ -205,7 +207,10 @@ eigenpal agents runs feedback resolve <source-agent-execution-id> \
 
 Agent commands commonly accept `<agent-id-or-slug>`. Agent execution commands
 take an agent execution id. Execution pulls and comparisons write review
-artifacts under `.eigenpal/artifacts/...` by default.
+artifacts under `.eigenpal/artifacts/...` by default. Unqualified run-list
+targets show all source refs; add `@<ref>` only when you want a specific
+release, branch, tag, semver range, or commit. `runs list --json` returns
+`{ runs, total, limit, offset }`; `runs get --json` returns `{ run }`.
 
 Root `eigenpal run` / `eigenpal runs` and `eigenpal git <cmd>` (for moved subcommands) exit with a deprecation message — use `agents run`, `agents runs list`, and `agents <cmd>` instead.
 
@@ -319,7 +324,7 @@ would change.
 ```bash
 eigenpal agents runs list <agent-id-or-slug> --status failed --limit 10
 eigenpal agents runs list <agent-id-or-slug> --feedback-rating fail --include feedback,expected
-eigenpal agents runs get <agent-execution-id> --include feedback,expected,files,trace,issues --json
+eigenpal agents runs get <agent-execution-id> --include feedback,expected,files,trace,issues --json | jq '.run'
 eigenpal agents runs pull <agent-execution-id> --include all
 eigenpal agents runs artifacts list <agent-execution-id>
 ```
@@ -378,7 +383,8 @@ script or agent needs to inspect the result with `jq`.
 
 ```bash
 eigenpal workflow execution list <workflow-id> --json | jq '.data[0].id'
-eigenpal agents runs list <agent-id-or-slug> --json | jq '.executions[0].id'
+eigenpal agents runs list <agent-id-or-slug> --json | jq '.runs[0].id'
+eigenpal agents runs get <agent-execution-id> --json | jq '.run.id'
 ```
 
 General exit-code convention:

package/dist/skill/reference/cli/agents.md

@@ -212,7 +212,7 @@ agents
 
 | Command                                                                                | Description                                                                                                      |
 | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
-| `eigenpal agents\|agent runs list\|ls [options] <target>`                              | List runs for an agent target, e.g. agents.invoice-agent.                                                        |
+| `eigenpal agents\|agent runs list\|ls [options] <target>`                              | List runs for an agent target; unqualified targets include all source refs.                                      |
 | `eigenpal agents\|agent runs get [options] <run-id>`                                   | Get one agent run.                                                                                               |
 | `eigenpal agents\|agent runs rerun [options] <run-id>`                                 | Create a new run from a previous run's stored input snapshot.                                                    |
 | `eigenpal agents\|agent runs pull [options] <run-id>`                                  | Download run feedback, expected artifacts, files, and metadata.                                                  |
@@ -737,7 +737,7 @@ Validate a local dataset directory against the agent input/output schemas.
 
 ### `eigenpal agents|agent runs list|ls [options] <target>`
 
-List runs for an agent target, e.g. agents.invoice-agent.
+List runs for an agent target; unqualified targets include all source refs.
 
 ### Arguments
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/cli",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   "keywords": [
     "eigenpal",