@mutagent/cli 0.2.21 → 0.2.23

package/README.md

@@ -18,7 +18,7 @@
 
 MutagenT CLI is the command-line client for the MutagenT AI platform. It handles
 authentication, BYOK LLM providers, workspace Environments, managed agents, cloud
-sandboxes and Helix sessions, and the standalone Helix binary installer.
+sandboxes and Helix sessions, and the Helix binary installer.
 
 **Status:** all commands and flags below were verified against `mutagent --help`
 (and each subcommand's `--help`) on this branch. `sandbox` is internal (everyday
@@ -47,7 +47,7 @@ For where the CLI sits relative to the rest of the platform, see the
 - **LLM providers (BYOK)**: configure and test your own provider keys (`mutagent providers`), or copy them from a local Helix login (`mutagent providers mirror`)
 - **Workspace Environments**: `mutagent env` holds the variables and secrets an agent's tools need, separate from LLM provider keys
 - **Managed agents**: `mutagent agent` checks, packages, deploys and runs `agent.md` folders; `mutagent helix agent @slug` runs a deployed one in the cloud
-- **Helix installer**: `mutagent install helix` installs the standalone Helix binary into `~/.mutagent/bin` (no login needed)
+- **Helix installer**: `mutagent install helix` installs the Helix binary into `~/.mutagent/bin` (no login needed)
 - **Claude Code integration**: install the CLI skill (`mutagent skills install`) and session-telemetry hooks (`mutagent hooks install`)
 - **Built-in feedback**: `mutagent feedback send` reports bugs and product feedback, optionally with your coding-agent session transcript
 

package/dist/bin/cli.js

@@ -19762,15 +19762,18 @@ var LEAVES = {
   get: {
     details: `Reads a revision's agentspec, parsed: id, kind, version, description,
 criteria, tools, skills, harnesses, targets and instructions. Without --revision:
-the default slot's active revision, else the newest. A revision whose spec cannot
-be read answers status unreadable with the reason (exit 0: it is data).
+the default slot's active revision, else the newest. A revision with no
+agentspec answers status absent (agent.md defines the agent; the spec is
+optional). A revision whose spec cannot be read answers status unreadable with
+the reason. Both exit 0: they are data.
 --out writes the revision's raw agentspec.yaml bytes to a file; replacing an
 existing file needs --force.
 Examples:
   mutagent agent spec get invoice-pricing --json
   mutagent agent spec get invoice-pricing --out agentspec.yaml --force`,
-    directive: `  Read-only on the platform. --json prints { slug, status, revision, path, spec } or,
-  when unreadable, { status: "unreadable", reason }. With --out, 'written' names the file
+    directive: `  Read-only on the platform. --json prints { slug, status, revision, path, spec };
+  { status: "absent", path: null } when the revision has no agentspec (not an error);
+  or { status: "unreadable", reason } when one is there but fails to read. With --out, 'written' names the file
   and its digest. Replacing a file is destructive: confirm with the user before --force.`
   },
   diff: {
@@ -19826,29 +19829,40 @@ function parseRevision(value) {
     usageError("--revision must be a revision such as v3 or 3.", "spec get");
   return number;
 }
-function printCard(result) {
+function specCardLines(result) {
   const where = `${String(result.slug)}  v${String(result.revision)}  ${typeof result.path === "string" ? result.path : "(no agentspec)"}`;
+  if (result.status === "absent") {
+    return [
+      `${chalk2.bold(where)}  ${chalk2.dim("no spec")}`,
+      chalk2.dim("  agent.md defines this agent, so an agentspec is optional.")
+    ];
+  }
   if (result.status !== "readable") {
-    console.log(`${chalk2.bold(where)}  ${chalk2.yellow("unreadable")}`);
-    console.log(`  ${String(result.reason)}`);
-  } else {
-    const spec = result.spec;
-    console.log(`${chalk2.bold(where)}  ${chalk2.dim(`profile ${spec.profile}`)}`);
-    console.log(`  id: ${spec.id}   kind: ${spec.kind}   version: ${spec.version || "(none)"}`);
-    if (spec.description)
-      console.log(`  ${spec.description}`);
-    console.log(`  criteria (${String(spec.criteria.length)}):`);
-    for (const c of spec.criteria)
-      console.log(`    ${c.id || "-"}  ${c.type ? `[${c.type}] ` : ""}${c.statement}`);
-    for (const [label, values] of [["tools", spec.tools], ["skills", spec.skills], ["harnesses", spec.harnesses]]) {
-      console.log(`  ${label}: ${values.length > 0 ? values.join(", ") : "-"}`);
-    }
-    console.log(`  targets: ${spec.targets.length > 0 ? spec.targets.map((t) => `${t.type}:${t.name}`).join(", ") : "-"}`);
-    if (spec.instructions)
-      console.log(`  instructions: ${spec.instructions.split(`
+    return [`${chalk2.bold(where)}  ${chalk2.yellow("unreadable")}`, `  ${String(result.reason)}`];
+  }
+  const spec = result.spec;
+  const lines = [
+    `${chalk2.bold(where)}  ${chalk2.dim(`profile ${spec.profile}`)}`,
+    `  id: ${spec.id}   kind: ${spec.kind}   version: ${spec.version || "(none)"}`
+  ];
+  if (spec.description)
+    lines.push(`  ${spec.description}`);
+  lines.push(`  criteria (${String(spec.criteria.length)}):`);
+  for (const c of spec.criteria)
+    lines.push(`    ${c.id || "-"}  ${c.type ? `[${c.type}] ` : ""}${c.statement}`);
+  for (const [label, values] of [["tools", spec.tools], ["skills", spec.skills], ["harnesses", spec.harnesses]]) {
+    lines.push(`  ${label}: ${values.length > 0 ? values.join(", ") : "-"}`);
+  }
+  lines.push(`  targets: ${spec.targets.length > 0 ? spec.targets.map((t) => `${t.type}:${t.name}`).join(", ") : "-"}`);
+  if (spec.instructions)
+    lines.push(`  instructions: ${spec.instructions.split(`
 `)[0] ?? ""}${spec.instructions.includes(`
 `) ? " …" : ""}`);
-  }
+  return lines;
+}
+function printCard(result) {
+  for (const line of specCardLines(result))
+    console.log(line);
   const written = result.written;
   if (written)
     console.log(chalk2.green(`✓ Wrote ${written.file} (${String(written.bytes)} bytes)`));
@@ -23273,7 +23287,7 @@ name: mutagent-cli
 description: |
   Mutagent CLI - the command-line client for the Mutagent platform.
   Guides coding agents through setup (login, init, providers, workspaces),
-  installing the standalone Helix binary, and sending
+  installing Helix, and sending
   product feedback, and deploying and running managed agents (agent.md folders).
   Triggers: "mutagent", "mutagent cli", "mutagent login", "set up mutagent",
   "install diagnostics", "install evaluator", "install helix", "mutagent install",
@@ -23407,7 +23421,7 @@ skill never inlines flags. The active surface:
 | \`usage\` | Show usage + quota | [workflows/setup.md](./workflows/setup.md) |
 | \`skills install\` | Install this skill into a project | [workflows/setup.md](./workflows/setup.md) |
 | \`hooks install\` | Install Claude Code telemetry hooks | [workflows/setup.md](./workflows/setup.md) |
-| \`install helix\` | Install the standalone Helix binary (diagnostics / evaluator are retired) | [workflows/install.md](./workflows/install.md) |
+| \`install helix\` | Install the Helix binary (diagnostics / evaluator are retired) | [workflows/install.md](./workflows/install.md) |
 | \`agent\` | Check, pack, run locally, deploy, activate, list, inspect and retire managed agents | [workflows/agent-deployment.md](./workflows/agent-deployment.md) |
 | \`feedback send\` | Send product feedback | [workflows/feedback.md](./workflows/feedback.md) |
 
@@ -23432,7 +23446,7 @@ Match the user's first request. Load ONLY the matching subfile per the table. Do
 | User said / signal detected | Load subfile | Why |
 |---|---|---|
 | "log in", "authenticate", "set up mutagent", "init", "which workspace", "what models", "usage", "quota", "install the skill", "install hooks" | [workflows/setup.md](./workflows/setup.md) | Auth + project setup + discovery commands |
-| "install helix", "install diagnostics", "install evaluator", "add mutagent package" | [workflows/install.md](./workflows/install.md) | Standalone Helix binary installer, no login (diagnostics/evaluator are retired → helix) |
+| "install helix", "install diagnostics", "install evaluator", "add mutagent package" | [workflows/install.md](./workflows/install.md) | Helix binary installer, no login (diagnostics/evaluator are retired → helix) |
 | "agent.md", "deploy agent", "managed agent", "mutagent agent", "helix agent @slug" | [workflows/agent-deployment.md](./workflows/agent-deployment.md) | agent.md folder → check → deploy to a slot → run with \`helix agent @slug\` |
 | "send feedback", "report a bug", "file feedback", "the CLI crashed" | [workflows/feedback.md](./workflows/feedback.md) | Product feedback (+ optional transcript) |
 | Unclear / first time | run \`mutagent --help --json\` then reroute | Discover the surface before acting |
@@ -23444,7 +23458,7 @@ Match the user's first request. Load ONLY the matching subfile per the table. Do
 | File | WHEN to load | WHY |
 |---|---|---|
 | [workflows/setup.md](./workflows/setup.md) | User is onboarding: login, init, config, workspaces, providers, usage, skill/hooks install | Auth + configuration + discovery |
-| [workflows/install.md](./workflows/install.md) | User wants to install Helix | \`install helix\`: the standalone binary into ~/.mutagent/bin |
+| [workflows/install.md](./workflows/install.md) | User wants to install Helix | \`install helix\`: the Helix binary into ~/.mutagent/bin |
 | [workflows/agent-deployment.md](./workflows/agent-deployment.md) | User wants to deploy or run a managed agent, or run an agent.md locally | Slots (\`--env\`), revisions (\`vN\`), \`@slug\` runs, rollback and retire |
 | [workflows/feedback.md](./workflows/feedback.md) | User wants to send feedback or report a bug | \`feedback send\` + \`--attach-transcript\` |
 
@@ -23673,8 +23687,8 @@ how they learn something sensitive was in the file at all.
   "workflows/install.md": `---
 name: mutagent-cli-workflows-install
 description: |
-  Install workflow. \`mutagent install helix\` installs the standalone Helix
-  binary into ~/.mutagent/bin, the same result as
+  Install workflow. \`mutagent install helix\` installs the Helix binary
+  into ~/.mutagent/bin, the same result as
   \`curl -fsSL https://install.mutagent.io/helix | bash\`. No login needed.
   \`diagnostics\` and \`evaluator\` are RETIRED as install targets — both skills
   now ship inside helix.
@@ -23691,7 +23705,7 @@ triggers:
 # Workflow — Install Helix
 
 > **\`helix\` is the only install target.** \`mutagent install helix\` installs the
-> standalone Helix binary at \`~/.mutagent/bin/helix\`, the same result as
+> Helix binary (the Helix harness) at \`~/.mutagent/bin/helix\`, the same result as
 > \`curl -fsSL https://install.mutagent.io/helix | bash\`.
 >
 > \`diagnostics\` and \`evaluator\` are **retired** — their npm packages are no
@@ -24003,7 +24017,7 @@ confirm before running (Core Rule 5).
 ## Cross-references
 
 - [SKILL.md](../SKILL.md) → Core Rules + Task Router
-- [workflows/install.md](./install.md) → install the standalone Helix binary (diagnostics / evaluator are retired)
+- [workflows/install.md](./install.md) → install the Helix binary (diagnostics / evaluator are retired)
 `
 };
 var SKILL_CONTENT = SKILL_FILES["SKILL.md"] ?? "";
@@ -24187,7 +24201,7 @@ It never prompts. Without a sign-in it exits 3 (AUTH_REQUIRED) and names the sig
       } else {
         console.log("");
         console.log(chalk17.bold(`  What's next:`));
-        console.log(`    ${chalk17.cyan("mutagent install helix".padEnd(30))}${chalk17.dim("# the standalone Helix binary")}`);
+        console.log(`    ${chalk17.cyan("mutagent install helix".padEnd(30))}${chalk17.dim("# the Helix binary")}`);
         console.log("");
         console.log(chalk17.dim("  Your coding agent now knows these workflows — restart it to pick up"));
         console.log(chalk17.dim('  the skill, then just say "set up Mutagent on this project".'));
@@ -25493,7 +25507,7 @@ var BY_DESIGN_ENTRIES = [
     id: "mutagent-helix-not-on-npm",
     title: "@mutagent/helix is not published to npm — on purpose",
     looksLike: pairPatterns(HELIX_PKG, NOT_FOUND),
-    reality: "Helix is not distributed through the public npm registry, so a 404 there is expected. It ships as a standalone binary from install.mutagent.io, verified against the checksums published beside it. Install it with: mutagent install helix"
+    reality: "Helix is not distributed through the public npm registry, so a 404 there is expected. It ships as the Helix binary from install.mutagent.io, verified against the checksums published beside it. Install it with: mutagent install helix"
   },
   {
     id: "trace-lives-in-a-different-binary",
@@ -25818,13 +25832,13 @@ init_errors();
 import { Command as Command12 } from "commander";
 import chalk23 from "chalk";
 function createInstallCommand(deps) {
-  const install = new Command12("install").description("Install the standalone Helix binary on this machine").argument("<package>", `Package to install: ${VALID_PACKAGES.join(", ")}`).option("--channel <channel>", `Release channel: ${HELIX_CHANNELS.join(" or ")} (default: latest)`).addHelpText("after", `
+  const install = new Command12("install").description("Install the Helix binary on this machine").argument("<package>", `Package to install: ${VALID_PACKAGES.join(", ")}`).option("--channel <channel>", `Release channel: ${HELIX_CHANNELS.join(" or ")} (default: latest)`).addHelpText("after", `
 ${chalk23.bold("Examples:")}
   ${chalk23.dim("$")} mutagent install helix
   ${chalk23.dim("$")} mutagent install helix --channel candidate
   ${chalk23.dim("$")} mutagent install helix --json
 
-${chalk23.bold("helix")}: the standalone Helix binary, the same one
+${chalk23.bold("helix")}: the Helix binary (the Helix harness), the same one
 \`curl -fsSL https://install.mutagent.io/helix | bash\` installs. It downloads
 helix-<os>-<arch> for macOS or Linux (x64, arm64), verifies it against
 checksums.txt from the same origin, writes ~/.mutagent/bin/helix and points the
@@ -30212,7 +30226,7 @@ function createHelixCommand() {
     "  Choose -p (one-shot), --mode json or --mode rpc (a steerable session) explicitly.",
     "  Without --prime the full Helix orchestrator runs; --prime runs the lean Prime agent.",
     "  Keep the session reference (hs1_...) printed on stderr; attach, send, signal and checkpoint take it.",
-    "  mutagent install helix installs the standalone Helix binary on this machine; this command runs it in the cloud.",
+    "  mutagent install helix installs the Helix binary on this machine; this command runs it in the cloud.",
     "  Inside a git checkout, pass the git remote's owner/name to start with it checked out: --repository <owner/name> [--branch <name>].",
     "  On a refusal, show the returned fix: the Run: lines, the notes, and who has to act; do not invent other commands.",
     "  In --mode rpc/json a launch refusal is one JSON line on stderr: {success:false, code, error, suggestedAction,",
@@ -37860,7 +37874,7 @@ ${chalk64.yellow("Get started:")}
      ${chalk64.dim("Create an Environment: the variables and secrets a sandbox gets")}
   4. mutagent helix --env staging -p "<task>"
      ${chalk64.dim("Run Helix on the task in a cloud sandbox and print its answer")}
-  ${chalk64.dim("To run Helix on this machine instead: mutagent install helix installs the standalone binary")}
+  ${chalk64.dim("To run Helix on this machine instead: mutagent install helix installs the Helix binary")}
 
 ${chalk64.yellow("Managed agents:")}
   mutagent agent deploy <agent.md>        ${chalk64.dim("Check, upload and activate an agent.md folder (--env names the Environment whose slot is used)")}
@@ -37980,4 +37994,4 @@ if (process.env.CLI_VERSION) {
 }
 runCli(process.argv.slice(2), cliVersion);
 
-//# debugId=6B702C81145D372764756E2164756E21
+//# debugId=02AF2BDB9E29C77264756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutagent/cli",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "description": "Bun-native CLI for the MutagenT AI platform - auth, provider config, and lifecycle-tool installer for AI-native workflows",
   "type": "module",
   "bin": {