@f-o-h/cli 0.1.51 → 0.1.52

package/README.md

@@ -133,14 +133,25 @@ foh eval external-agent run \
   --prompt-version blank-setup.v1
 ```
 
-The command writes a versioned prompt, launches an instrumented shell, captures
-FOH CLI commands into `commands.ndjson`, and finalizes `run.json` as an
-`external_agent_run.v1` artifact when the shell exits.
-
+The command writes a versioned prompt, launches an instrumented shell, captures
+FOH CLI commands into `commands.ndjson`, and finalizes `run.json` as an
+`external_agent_run.v1` artifact when the shell exits.
+
 Run artifacts include `eval_state` so repeated benchmark runs make reuse
 explicit: org, agent, and widget reuse are expected; fresh paid phone-number
 creation is not expected.
 
+## Common Missions
+
+| Mission | Command |
+|---|---|
+| Start | `foh start` |
+| Setup | `foh setup --phone-mode observe --json` |
+| Prove | `foh prove --agent <agent_id> --mission widget --json` |
+| Debug | `foh debug --out test-results/foh-cli-diag.latest.json --json` |
+| Improve | `foh bug improve --from-file <artifact.json> --json` |
+| Publish | `foh agent publish --agent <agent_id> --json` |
+
 For a planted knowledge-miss benchmark:
 
 ```bash

package/dist/foh.js

@@ -32801,7 +32801,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.51";
+var CLI_VERSION = "0.1.52";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -36486,7 +36486,7 @@ function toErrorRecord(error2) {
   return { message: String(error2) };
 }
 function registerDiag(program3) {
-  program3.command("diag").description("Collect support diagnostics bundle for current CLI/API context").requiredOption("--out <path>", "Write diagnostics bundle JSON to this file path").option("--org <id>", "Org ID to probe (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--json", "Output as machine-readable JSON").action(async (opts) => {
+  program3.command("diag").alias("debug").description("Collect support diagnostics bundle for current CLI/API context").requiredOption("--out <path>", "Write diagnostics bundle JSON to this file path").option("--org <id>", "Org ID to probe (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--json", "Output as machine-readable JSON").action(async (opts) => {
     try {
       const checks = [];
       const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -40506,6 +40506,28 @@ function installSoftExitTrap() {
   });
 }
 
+// src/lib/mission-help.ts
+var CLI_MISSION_EXAMPLES = [
+  { mission: "Start", command: "foh start", description: "guided setup and next action selector" },
+  { mission: "Setup", command: "foh setup --phone-mode observe --json", description: "create or update agent, widget, voice config, and proof scaffold" },
+  { mission: "Prove", command: "foh prove --agent <agent_id> --mission widget --json", description: "produce a machine-readable proof report" },
+  { mission: "Debug", command: "foh debug --out test-results/foh-cli-diag.latest.json --json", description: "collect auth/org/API diagnostics" },
+  { mission: "Improve", command: "foh bug improve --from-file <artifact.json> --json", description: "convert a failure artifact into a redacted improvement packet" },
+  { mission: "Publish", command: "foh agent publish --agent <agent_id> --json", description: "publish after proof gates pass" }
+];
+function missionHelpText() {
+  return [
+    "",
+    "Common missions:",
+    ...CLI_MISSION_EXAMPLES.map((item) => `  ${item.command.padEnd(66)} ${item.description}`),
+    "",
+    "For AI agents: prefer --json and follow next_commands exactly when a command blocks."
+  ].join("\n");
+}
+function addMissionHelp(program3) {
+  program3.addHelpText("afterAll", missionHelpText());
+}
+
 // src/index.ts
 installSoftExitTrap();
 installExternalAgentCliCompletionRecorder(recordExternalAgentCliInvocation({ argv: process.argv, cliVersion: CLI_VERSION }));
@@ -40563,6 +40585,7 @@ function writeKnownError(message, remediation) {
 `);
 }
 program2.name("foh").description("Front Of House CLI - AI-operator provisioning tool").version(CLI_VERSION).option("--json", "Output as machine-readable JSON").option("--api-url <url>", "Internal API base URL override (operators only)").option("--no-color", "Disable colour output");
+addMissionHelp(program2);
 registerAuth(program2);
 registerOrg(program2);
 registerTenant(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f-o-h/cli",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "description": "FOH CLI - AI-operator provisioning tool for Front Of House",
   "license": "UNLICENSED",
   "bin": {