@f-o-h/cli 0.1.38 → 0.1.40

package/README.md

@@ -4,7 +4,7 @@ AI-operator provisioning CLI for Front Of House.
 
 Public mirror: https://github.com/iiko38/front-of-house-cli
 
-Current published baseline: `@f-o-h/cli@0.1.38`
+Current published baseline: `@f-o-h/cli@0.1.40`
 
 This mirror is a generated release artifact. The private product monorepo is not
 published here, and no open-source license is granted unless stated separately.

package/dist/foh.js

@@ -9927,7 +9927,12 @@ function envelopeOk(status) {
 function dedupeCommands(commands = []) {
   return Array.from(new Set(commands.map((command) => String(command || "").trim()).filter(Boolean)));
 }
+function defaultSafeToRetry(status) {
+  return !(status === "fail" || status === "blocked" || status === "hold");
+}
 function cliEnvelope(input) {
+  const extra = input.extra ?? {};
+  const artifacts = input.artifacts ?? {};
   return {
     schema_version: input.schemaVersion ?? "foh_cli_envelope.v1",
     ok: envelopeOk(input.status),
@@ -9936,9 +9941,13 @@ function cliEnvelope(input) {
     summary: input.summary,
     ids: input.ids ?? {},
     checks: input.checks ?? [],
-    artifacts: input.artifacts ?? {},
+    artifacts,
+    spend_class: input.spendClass ?? extra.spend_class ?? null,
+    safe_to_retry: input.safeToRetry ?? extra.safe_to_retry ?? defaultSafeToRetry(input.status),
+    proof_artifacts: input.proofArtifacts ?? extra.proof_artifacts ?? artifacts.proof_bundle ?? artifacts.proof_report ?? null,
+    operator_note: input.operatorNote ?? extra.operator_note ?? null,
     next_commands: dedupeCommands(input.nextCommands),
-    ...input.extra ?? {}
+    ...extra
   };
 }
 function reasonCodeFromStep(step, fallback = "cli_command_failed") {
@@ -14332,6 +14341,31 @@ function boundedInt(value, params) {
   if (!Number.isFinite(parsed)) return params.fallback;
   return Math.max(params.min, Math.min(params.max, Math.trunc(parsed)));
 }
+function certModeFlag(mode) {
+  if (mode === "full") return ["--full"];
+  if (mode === "stress") return ["--stress"];
+  return [];
+}
+function buildCertificationFailureCommands(params) {
+  const modeFlags = certModeFlag(params.certMode);
+  const orgFlags = params.orgId ? ["--org", params.orgId] : [];
+  const scenarioFlags = params.topBlocker?.scenario_id ? ["--scenario-ids", params.topBlocker.scenario_id] : [];
+  const command = [
+    "foh",
+    "sim",
+    "certify-loop",
+    "--agent",
+    params.agentId,
+    ...orgFlags,
+    ...modeFlags,
+    ...scenarioFlags,
+    "--json"
+  ].join(" ");
+  return [
+    command,
+    `foh bug improve --from external-agent-run --file <run_dir>/run.json --json`
+  ];
+}
 function resolveCertifiedPublishOptions(opts) {
   const rawMode = String(opts.certMode || "quick").toLowerCase();
   const certMode = normalizeAgentCertMode(rawMode);
@@ -14383,10 +14417,22 @@ async function validateCertifyAndPublishAgent(opts) {
   const certificate = certification.certificate;
   if (!certification.ok || !certification.overall_pass || !certificate) {
     const topBlocker = certificate?.blockers?.[0];
+    const blockerLabel = topBlocker?.invariant && topBlocker?.scenario_id ? `${topBlocker.invariant} in ${topBlocker.scenario_id}` : "unknown";
+    const nextCommands = buildCertificationFailureCommands({
+      agentId: opts.agentId,
+      orgId: opts.orgId,
+      certMode,
+      topBlocker
+    });
     throw new FohError({
       step: "agent.publish",
-      error: `Simulation certification failed before publish: ${certificate?.scenario_summary?.failed ?? "unknown"}/${certificate?.scenario_summary?.total ?? "unknown"} scenario(s) failed.`,
-      remediation: topBlocker?.suggested_fix ?? certificate?.recommendations?.[0] ?? `Run: foh sim certify-loop --agent ${opts.agentId} --${certMode === "quick" ? "full" : certMode}  for detailed output.`,
+      error: `Simulation certification failed before publish: ${certificate?.scenario_summary?.failed ?? "unknown"}/${certificate?.scenario_summary?.total ?? "unknown"} scenario(s) failed. Top blocker: ${blockerLabel}.`,
+      remediation: [
+        topBlocker?.suggested_fix ?? certificate?.recommendations?.[0] ?? "Fix the top simulation blocker before publishing.",
+        `Re-run: ${nextCommands[0]}`
+      ].filter(Boolean).join(" "),
+      reasonCode: "simulation_certification_failed",
+      nextCommands,
       detail: {
         certification,
         top_blocker: topBlocker ?? null
@@ -32755,7 +32801,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.38";
+var CLI_VERSION = "0.1.40";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;

package/package.json

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

package/schemas/cli-envelope.schema.json

@@ -3,7 +3,7 @@
   "$id": "https://frontofhouse.okii.uk/schemas/cli-envelope.schema.json",
   "title": "FOH CLI Envelope",
   "type": "object",
-  "required": ["schema_version", "ok", "status", "reason_code", "summary", "ids", "checks", "artifacts", "next_commands"],
+  "required": ["schema_version", "ok", "status", "reason_code", "summary", "ids", "checks", "artifacts", "spend_class", "safe_to_retry", "proof_artifacts", "operator_note", "next_commands"],
   "properties": {
     "schema_version": { "type": "string" },
     "ok": { "type": "boolean" },
@@ -13,6 +13,10 @@
     "ids": { "type": "object" },
     "checks": { "type": "array" },
     "artifacts": { "type": "object" },
+    "spend_class": { "type": ["string", "null"] },
+    "safe_to_retry": { "type": "boolean" },
+    "proof_artifacts": { "type": ["object", "string", "null"] },
+    "operator_note": { "type": ["string", "null"] },
     "next_commands": {
       "type": "array",
       "items": { "type": "string" }