@mutagent/cli 0.2.4 → 0.2.6

package/README.md

@@ -23,7 +23,7 @@ sandboxes and Helix sessions, and the standalone 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
 use goes through `mutagent helix`); `trace` is not implemented in this binary —
-it prints where to find it (`helix-cli trace`) and exits with an error.
+it prints where to find it (in Helix) and exits with an error.
 
 [Context](#context) · [Concepts](#concepts) · [Components](#components) · [Configuration](#configuration) · [Reference](#reference)
 
@@ -111,7 +111,7 @@ flowchart TD
             ENVIRONMENT["mutagent env"]
             HELIX["mutagent helix"]
             AGENT["mutagent agent"]
-            TRACE["mutagent trace<br/>(→ helix-cli)"]
+            TRACE["mutagent trace<br/>(→ Helix)"]
         end
 
         subgraph LIFECYCLE ["Helix & Feedback"]

package/dist/bin/cli.js

@@ -30790,9 +30790,11 @@ async function resolveGatewayConnection() {
   const workspaceId = tenancy.workspaceId?.trim();
   if (workspaceId === undefined || workspaceId === "")
     throw noWorkspaceSelected();
-  const headers = { "x-api-key": apiKey, "Content-Type": "application/json" };
-  if (tenancy.keyScope !== "workspace")
-    headers["x-workspace-id"] = workspaceId;
+  const headers = {
+    "x-api-key": apiKey,
+    "Content-Type": "application/json",
+    "x-workspace-id": workspaceId
+  };
   return {
     endpoint: tenancy.endpoint,
     apiKey,
@@ -34166,7 +34168,8 @@ var PUBLISH_MARKER_VALUES = ["redacted", "assume-sanitized"];
 var MAX_REPORT_HTML_CHARS = 10 * 1024 * 1024;
 var MAX_RENDER_INPUT_BYTES = 2 * 1024 * 1024;
 var RENDER_INPUT_FILE = "render-input.json";
-var PUBLISH_FIX = "Run: helix-cli report publish <report.html> <report.client.html>, then push the .client.html file";
+var NOT_BY_HELIX = "This report was not published by Helix; rerun the stage in Helix.";
+var PUBLISH_FIX = "Rerun the stage in Helix, which publishes the report, then push its run directory: mutagent reports push <run dir>";
 var INTERNAL_SURFACES = [
   { name: "calibration panel (section#t5)", pattern: /<section\b[^>]*\bid\s*=\s*["']t5["']/i },
   { name: "internal navigation tab", pattern: /<button\b[^>]*\bclass\s*=\s*["']tab-btn internal["']/i },
@@ -34186,7 +34189,7 @@ function parseReportKind(value2) {
     return value2;
   const mapped3 = HELIX_RENDER_KIND_MAP[value2];
   if (mapped3 !== undefined) {
-    throw invalid2(`'${value2}' is the helix-cli render kind; push it as --kind ${mapped3}.`);
+    throw invalid2(`'${value2}' is the Helix render kind; push it as --kind ${mapped3}.`);
   }
   throw invalid2(`Unknown report kind '${value2}'. Allowed: ${REPORT_KINDS.join(", ")}.`);
 }
@@ -34204,17 +34207,17 @@ function assertPublished(html, path) {
   const markers = publishMarkersOf(html);
   const marker = markers[0];
   if (markers.length > 1) {
-    throw notPublished(`${path} carries ${String(markers.length)} ${PUBLISH_MARKER_NAME} markers; a published report has exactly one. ` + "Publish the raw render again with `helix-cli report publish`.");
+    throw notPublished(`${path} carries ${String(markers.length)} ${PUBLISH_MARKER_NAME} markers; a published report has exactly one. ` + NOT_BY_HELIX);
   }
   if (marker === undefined) {
-    throw notPublished(`${path} has no ${PUBLISH_MARKER_NAME} marker, so it was not written by \`helix-cli report publish\` ` + "(the PII gate). A report published by an older helix-cli has no marker either: publish it again.");
+    throw notPublished(`${path} has no ${PUBLISH_MARKER_NAME} marker (publishing is the PII gate). ${NOT_BY_HELIX}`);
   }
   if (!PUBLISH_MARKER_VALUES.includes(marker)) {
-    throw notPublished(`${path} has an unknown ${PUBLISH_MARKER_NAME} value '${marker}' (expected ${PUBLISH_MARKER_VALUES.join(" or ")}). ` + "Publish it again with `helix-cli report publish`.");
+    throw notPublished(`${path} has an unknown ${PUBLISH_MARKER_NAME} value '${marker}' (expected ${PUBLISH_MARKER_VALUES.join(" or ")}). ` + NOT_BY_HELIX);
   }
   const leftovers = internalSurfacesOf(html);
   if (leftovers.length > 0) {
-    throw notPublished(`${path} still carries internal report surfaces (${leftovers.join(", ")}), so it was not produced by ` + "`helix-cli report publish`.");
+    throw notPublished(`${path} still carries internal report surfaces (${leftovers.join(", ")}). ${NOT_BY_HELIX}`);
   }
   return marker;
 }
@@ -34227,7 +34230,7 @@ function resolveReportFiles(target, renderInputFlag) {
     const published = htmlFiles.filter((f) => /\.client\.html?$/i.test(f));
     if (published.length === 0) {
       if (htmlFiles.length > 0) {
-        throw notPublished(`${target} has no published report (*.client.html), only ${htmlFiles.join(", ")}. ` + `Publish it first: helix-cli report publish ${join24(target, htmlFiles[0] ?? "report.html")}`);
+        throw notPublished(`${target} has no published report (*.client.html), only ${htmlFiles.join(", ")}. ${NOT_BY_HELIX}`);
       }
       throw invalid2(`${target} holds no report HTML. Pass the published file itself, or the run directory that holds it.`);
     }
@@ -34302,27 +34305,29 @@ function refuseForHitl(options) {
   throw new MutagentError("VALIDATION_ERROR", `${refused.join(" and ")} cannot be used with --kind hitl: a hitl report carries no run id, so every push stores a new report and there is nothing to replace.`, "Run: mutagent reports push --help");
 }
 function registerReportsPush(reports) {
-  reports.command("push").description("Upload a published run report: its render input and the HTML `helix-cli report publish` wrote").argument("<run-dir|report-file>", "A run directory (render-input.json + one *.client.html), or the published HTML file").option("--kind <kind>", "diagnostics|discovery|evaluator|hitl").option("--run-id <id>", "The producing run (default: the render input's runId). Not with --kind hitl").option("--subject <id>", "The agent, skill or workflow the report is about").option("--session-ref <ref>", "The Helix session reference").option("--title <text>", "Report title (default: the HTML <title>)").option("--render-input <file>", "The render-input JSON (default: render-input.json beside the HTML)").option("--replace", "Swap the content of the report already stored for this run and kind. Not with --kind hitl").addHelpText("after", `
+  reports.command("push").description("Upload a run report Helix published: its render input and its client-safe HTML").argument("<run-dir|report-file>", "A run directory (render-input.json + one *.client.html), or the published HTML file").option("--kind <kind>", "diagnostics|discovery|evaluator|hitl").option("--run-id <id>", "The producing run (default: the render input's runId). Not with --kind hitl").option("--subject <id>", "The agent, skill or workflow the report is about").option("--session-ref <ref>", "The Helix session reference").option("--title <text>", "Report title (default: the HTML <title>)").option("--render-input <file>", "The render-input JSON (default: render-input.json beside the HTML)").option("--replace", "Swap the content of the report already stored for this run and kind. Not with --kind hitl").addHelpText("after", `
 Usage:
   ${PUSH_USAGE}
 
+Helix publishes a run's report and, in a cloud sandbox, pushes it. To push a report
+Helix already published from a local run: \`mutagent reports push <run dir>\`.
+
 Examples:
-  ${chalk54.dim("$")} helix-cli report publish runs/42/report.html runs/42/report.client.html
   ${chalk54.dim("$")} mutagent reports push runs/42 --kind evaluator
   ${chalk54.dim("$")} mutagent reports push runs/42/report.client.html --kind diagnostics --run-id run-42 --json
   ${chalk54.dim("$")} mutagent reports push runs/42 --kind evaluator --replace
   ${chalk54.dim("$")} mutagent reports push review/ --kind hitl
 
-Kinds, and the helix-cli render kind each one comes from:
+Kinds, and the Helix render kind each one comes from:
   diagnosis → diagnostics · discover → discovery · eval → evaluator · review → hitl
   Any other kind (roster, dogfood, ship, the skill-builder kinds) is refused.
 
 Only published reports are accepted:
-  The HTML must be the file \`helix-cli report publish\` wrote (the PII gate). Publish
-  stamps <meta name="mutagent-report-published" content="redacted|assume-sanitized">
+  The HTML must be the client-safe file Helix published (publishing is the PII gate).
+  Publishing stamps <meta name="mutagent-report-published" content="redacted|assume-sanitized">
   into every report; a file without exactly one such tag with one of those values is
   refused (exit 1, REPORT_NOT_PUBLISHED) and nothing is sent. So is a file that still carries the evaluator's internal panels.
-  A report published by an older helix-cli has no marker: publish it again.
+  Such a report was not published by Helix: rerun the stage in Helix.
 
 Idempotent per run and kind:
   A repeat push of the same run id and kind stores nothing new: it prints
@@ -34342,13 +34347,13 @@ Exit 0: stored, or already stored.
 ${EXIT_CODES_LINE}
 
 AI Agent Directive:
-  1. Publish first: \`helix-cli report publish <report.html> <report.client.html>\`, then
-     push the run directory or the .client.html file. Never push the raw render.
+  1. Push only a report Helix published: the run directory or its .client.html file.
+     Never push the raw render.
   2. --json returns { success, created, replaced, report, _links, _directive }.
      created:false with replaced:false means it was already stored; that is success.
   3. Pass --replace only when the user asked to overwrite the stored report.
-  4. On REPORT_NOT_PUBLISHED, run the publish command in suggestedAction; do not edit
-     the HTML to add the marker.
+  4. On REPORT_NOT_PUBLISHED, the report was not published by Helix: rerun the stage in
+     Helix (suggestedAction). Do not edit the HTML to add the marker.
   5. Show _directive.renderedCard to the user verbatim.
 `).action(async (target, options, command) => {
     await runReportsAction(command, async (isJson) => {
@@ -34420,7 +34425,7 @@ The workspace is the usual one: --workspace, MUTAGENT_WORKSPACE_ID or 'mutagent
 
 AI Agent Directive:
   1. Read first: 'mutagent reports list --json'. Reads need no confirmation.
-  2. push only files 'helix-cli report publish' wrote; see 'mutagent reports push --help'.
+  2. push only reports Helix published; see 'mutagent reports push --help'.
   3. review and retract are writes: confirm with the user, then run them (retract with --force).
   4. On an error, run the command in suggestedAction once; never retry blind.
 `);
@@ -37223,4 +37228,4 @@ if (process.env.CLI_VERSION) {
 }
 runCli(process.argv.slice(2), cliVersion);
 
-//# debugId=28FA12E8B2DFAE3B64756E2164756E21
+//# debugId=E319FD98480B5A9D64756E2164756E21

package/package.json

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