@f-o-h/cli 0.1.87 → 0.1.88

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.79`
+Current published baseline: `@f-o-h/cli@0.1.87`
 
 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

@@ -15186,6 +15186,10 @@ var SMOKE_TURNS = [
   "I am interested in buying a 3-bedroom house in the area",
   "Can I book a viewing for this week?"
 ];
+function isGenericTroubleReply(reply) {
+  const normalized = reply.trim().toLowerCase();
+  return /\bi'?m sorry\b/.test(normalized) && /having trouble|try again|something went wrong|unable to help right now/.test(normalized);
+}
 async function resolveChannelPublicKey(agentId, orgId, apiUrlOverride) {
   const data = await apiFetch(
     "/v1/console/channels/widget/ensure",
@@ -15227,12 +15231,17 @@ async function runWidgetSmoke(publicKey, apiUrlOverride) {
       conversationId = data.conversationId;
       if (data.trace_id) traceIds.push(data.trace_id);
       if (data.correlation_id) correlationIds.push(data.correlation_id);
+      const genericTroubleReply = isGenericTroubleReply(data.reply);
       turns.push({
         turn: i + 1,
         message,
-        ok: true,
+        ok: !genericTroubleReply,
         latency_ms: latencyMs,
         reply: data.reply,
+        ...genericTroubleReply ? {
+          reason_code: "widget_generic_trouble_reply",
+          error: "Widget returned a generic trouble reply instead of advancing the customer request."
+        } : {},
         conversation_id: data.conversationId,
         trace_id: data.trace_id ?? null,
         correlation_id: data.correlation_id ?? null,
@@ -15400,7 +15409,7 @@ function buildReasonedNextSteps({
   const verifyTokenValue = verifyToken || "<verify_token>";
   if (has("whatsapp_channel_not_ready") || has("whatsapp_access_token_missing") || has("whatsapp_verify_token_missing") || has("whatsapp_app_secret_missing")) {
     steps.push(
-      "Connect/update channel credentials: foh channel whatsapp connect --phone-number-id <meta_phone_number_id> --access-token <meta_access_token> --verify-token <verify_token> --app-secret <meta_app_secret>"
+      "Connect/update channel credentials: foh channel whatsapp onboard --phone-number-id <meta_phone_number_id> --access-token <meta_access_token> --verify-token <verify_token> --app-secret <meta_app_secret>"
     );
   }
   if (has("whatsapp_verify_check_failed") || has("whatsapp_webhook_challenge_failed")) {
@@ -15676,24 +15685,6 @@ async function runWhatsAppOnboardingSession(params) {
     apiUrlOverride: params.apiUrl
   });
 }
-function emitLegacyCommandNotice({
-  command,
-  canonical,
-  jsonMode
-}) {
-  if (!jsonMode) {
-    process.stderr.write(
-      `[deprecated] foh channel whatsapp ${command} is a compatibility wrapper.
-Use: ${canonical}
-`
-    );
-  }
-  return {
-    command,
-    canonical,
-    status: "deprecated_compat_wrapper"
-  };
-}
 function parseBatchManifest(manifestPathRaw) {
   const manifestPath = String(manifestPathRaw || "").trim();
   if (!manifestPath) {
@@ -15843,51 +15834,10 @@ async function runWhatsAppOnboardingWizard(opts) {
   throw new FohError({
     step: "channel.whatsapp.onboard",
     error: "Unable to complete WhatsApp onboarding after guided retries.",
-    remediation: "Run again with --phone-number-id and --waba-id, or use `foh channel whatsapp start` for deterministic next steps."
+    remediation: "Run again with --phone-number-id and --waba-id, or use `foh channel whatsapp guide` for deterministic next steps."
   });
 }
 function registerWhatsAppOnboardingCommands(whatsapp, addCommonOptions) {
-  addCommonOptions(
-    whatsapp.command("start").description("[Deprecated wrapper] Start onboarding using the canonical session flow")
-  ).option("--access-token <token>", "Meta access token with WhatsApp Business access").option("--waba-id <id>", "Optional explicit WhatsApp Business Account id when /me discovery is restricted").option("--phone-number-id <id>", "Optional explicit phone number id when discovery returns multiple candidates").option("--agent-id <id>", "Agent to bind to the WhatsApp channel").option("--verify-token <token>", "Optional webhook verify token (auto-generated when omitted)").option("--app-secret <secret>", "Optional Meta app secret (required for full signature-ready closure)").option("--business-slug <slug>", "Business identifier for operator-level targeting").option("--audio-enabled <bool>", "Enable inbound WhatsApp audio fallback auto-reply (true/false)", "true").option("--wizard", "Run guided onboarding with automatic recovery prompts").action(async (opts) => withCommandErrorHandling(async () => {
-    const accessToken = String(opts.accessToken || "").trim();
-    const useWizard = Boolean(opts.wizard) || !accessToken;
-    const legacy = emitLegacyCommandNotice({
-      command: "start",
-      canonical: "foh channel whatsapp onboard --wizard",
-      jsonMode: Boolean(opts.json)
-    });
-    const data = useWizard ? await runWhatsAppOnboardingWizard({
-      ...opts,
-      dryRun: true
-    }) : await runWhatsAppOnboardingSession({
-      orgId: opts.org,
-      apiUrl: opts.apiUrl,
-      accessToken,
-      wabaId: String(opts.wabaId || "").trim() || void 0,
-      phoneNumberId: String(opts.phoneNumberId || "").trim() || void 0,
-      verifyToken: String(opts.verifyToken || "").trim() || void 0,
-      appSecret: String(opts.appSecret || "").trim() || void 0,
-      agentId: opts.agentId,
-      businessSlug: opts.businessSlug,
-      audioEnabled: parseBooleanOption({
-        value: opts.audioEnabled,
-        fallback: true,
-        optionName: "--audio-enabled",
-        step: "channel.whatsapp.start"
-      }),
-      dryRun: true
-    });
-    format({
-      ...data,
-      legacy_wrapper: legacy,
-      next_steps: dedupeSteps([
-        "Run canonical onboarding apply flow: foh channel whatsapp onboard --wizard",
-        "Run deterministic closure: foh channel whatsapp proof --strict",
-        "Capture live provider evidence: corepack pnpm ops:whatsapp:proof:live"
-      ])
-    }, { json: opts.json ?? false });
-  }));
   addCommonOptions(
     whatsapp.command("onboard").description("Run one-session WhatsApp onboarding (discover -> bind -> verify -> prove)")
   ).option("--access-token <token>", "Meta access token with WhatsApp Business access").option("--waba-id <id>", "Optional explicit WhatsApp Business Account id when /me discovery is restricted").option("--phone-number-id <id>", "Optional explicit phone number id when discovery returns multiple candidates").option("--verify-token <token>", "Optional webhook verify token (auto-generated when omitted)").option("--app-secret <secret>", "Optional Meta app secret (required for full signature-ready closure)").option("--agent-id <id>", "Agent to bind to the WhatsApp channel").option("--business-slug <slug>", "Business identifier for operator-level targeting").option("--audio-enabled <bool>", "Enable inbound WhatsApp audio fallback auto-reply (true/false)", "true").option("--dry-run", "Run discovery/binding preflight without writing channel config").option("--wizard", "Run guided onboarding with automatic recovery prompts").action(async (opts) => withCommandErrorHandling(async () => {
@@ -15993,75 +15943,6 @@ function registerWhatsAppOnboardingCommands(whatsapp, addCommonOptions) {
       results
     }, { json: opts.json ?? false });
   }));
-  addCommonOptions(
-    whatsapp.command("setup").description("[Deprecated wrapper] Use canonical onboarding session flow")
-  ).option("--phone-number-id <id>", "Meta WhatsApp phone number id").option("--access-token <token>", "Meta access token").option("--verify-token <token>", "Webhook verify token").option("--app-secret <secret>", "Meta app secret for signature verification").option("--agent-id <id>", "Agent to bind to the WhatsApp channel").option("--audio-enabled <bool>", "Enable inbound WhatsApp audio fallback auto-reply (true/false)").option("--generate-verify-token", "Generate webhook verify token automatically when missing").option("--business-slug <slug>", "Business identifier for operator-level targeting").option("--wizard", "Run guided setup wizard prompts").action(async (opts) => withCommandErrorHandling(async () => {
-    const legacy = emitLegacyCommandNotice({
-      command: "setup",
-      canonical: "foh channel whatsapp onboard --wizard",
-      jsonMode: Boolean(opts.json)
-    });
-    const useWizard = Boolean(opts.wizard) || !String(opts.accessToken || "").trim();
-    const generatedVerifyToken = String(opts.verifyToken || "").trim() || (Boolean(opts.generateVerifyToken) ? generateVerifyToken() : "");
-    const data = useWizard ? await runWhatsAppOnboardingWizard({
-      ...opts,
-      verifyToken: generatedVerifyToken || void 0,
-      dryRun: false
-    }) : await runWhatsAppOnboardingSession({
-      orgId: opts.org,
-      apiUrl: opts.apiUrl,
-      accessToken: String(opts.accessToken || "").trim(),
-      wabaId: void 0,
-      phoneNumberId: String(opts.phoneNumberId || "").trim() || void 0,
-      verifyToken: generatedVerifyToken || void 0,
-      appSecret: String(opts.appSecret || "").trim() || void 0,
-      agentId: opts.agentId,
-      businessSlug: String(opts.businessSlug || "").trim() || void 0,
-      audioEnabled: parseBooleanOption({
-        value: opts.audioEnabled,
-        fallback: true,
-        optionName: "--audio-enabled",
-        step: "channel.whatsapp.setup"
-      }),
-      dryRun: false
-    });
-    format({
-      ...data,
-      legacy_wrapper: legacy,
-      generated_verify_token: generatedVerifyToken && !opts.verifyToken ? generatedVerifyToken : null
-    }, { json: opts.json ?? false });
-  }));
-  addCommonOptions(
-    whatsapp.command("connect").description("[Deprecated wrapper] Use canonical onboarding session flow")
-  ).requiredOption("--phone-number-id <id>", "Meta WhatsApp phone number id").requiredOption("--access-token <token>", "Meta access token").option("--agent-id <id>", "Agent to bind to the WhatsApp channel").option("--verify-token <token>", "Webhook verify token").option("--app-secret <secret>", "Meta app secret for signature verification").option("--business-slug <slug>", "Business identifier for operator-level targeting").option("--audio-enabled <bool>", "Enable inbound WhatsApp audio fallback auto-reply (true/false)", "true").action(async (opts) => withCommandErrorHandling(async () => {
-    const legacy = emitLegacyCommandNotice({
-      command: "connect",
-      canonical: "foh channel whatsapp onboard --access-token <token> --phone-number-id <id>",
-      jsonMode: Boolean(opts.json)
-    });
-    const data = await runWhatsAppOnboardingSession({
-      orgId: opts.org,
-      apiUrl: opts.apiUrl,
-      accessToken: String(opts.accessToken || "").trim(),
-      wabaId: void 0,
-      phoneNumberId: String(opts.phoneNumberId || "").trim() || void 0,
-      verifyToken: String(opts.verifyToken || "").trim() || void 0,
-      appSecret: String(opts.appSecret || "").trim() || void 0,
-      agentId: opts.agentId,
-      businessSlug: String(opts.businessSlug || "").trim() || void 0,
-      audioEnabled: parseBooleanOption({
-        value: opts.audioEnabled,
-        fallback: true,
-        optionName: "--audio-enabled",
-        step: "channel.whatsapp.connect"
-      }),
-      dryRun: false
-    });
-    format({
-      ...data,
-      legacy_wrapper: legacy
-    }, { json: opts.json ?? false });
-  }));
 }
 
 // src/commands/channel-whatsapp.ts
@@ -33060,7 +32941,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var injectedVersion = true ? String("0.1.87").trim() : "";
+var injectedVersion = true ? String("0.1.88").trim() : "";
 var envVersion = String(process.env.FOH_CLI_VERSION || process.env.npm_package_version || "").trim();
 var CLI_VERSION = injectedVersion || envVersion || "0.0.0-dev";
 
@@ -34882,8 +34763,190 @@ function writeSetupRunReport(reportPayload, reportOut) {
 }
 
 // src/commands/setup.ts
+var OBJECTIVE_SETUP_INDUSTRIES = ["real_estate", "restaurant", "general"];
+function normalizeString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function csv(value, fallback) {
+  return String(value || fallback).split(",").map((entry) => entry.trim()).filter(Boolean);
+}
+function objectiveChannels(tools) {
+  const allowed = /* @__PURE__ */ new Set(["widget", "voice", "whatsapp", "instagram", "sms"]);
+  const channels = tools.filter((tool) => allowed.has(tool));
+  return channels.length > 0 ? channels : ["widget"];
+}
+function objectiveOptimizationTarget(industry, objective) {
+  const text = objective.toLowerCase();
+  if (industry === "restaurant" || /book|booking|reservation|table/.test(text)) return "booking_rate";
+  if (/support|resolve|resolution/.test(text)) return "support_resolution";
+  if (/speed|lead|callback|call back/.test(text)) return "speed_to_lead";
+  return "lead_quality";
+}
+function objectiveSetupCommand(opts) {
+  const parts = [
+    "npx --yes @f-o-h/cli@latest setup",
+    `--objective ${JSON.stringify(normalizeString(opts.objective) || "<front-of-house objective>")}`,
+    `--business-name ${JSON.stringify(normalizeString(opts.businessName) || "<business name>")}`,
+    `--industry ${normalizeString(opts.industry) || "<real_estate|restaurant>"}`,
+    `--source-url ${JSON.stringify(normalizeString(opts.sourceUrl) || "<official url>")}`,
+    "--json"
+  ];
+  return parts.join(" ");
+}
+function selectedTemplateSummary(selection) {
+  const candidate = Array.isArray(selection?.candidates) ? selection.candidates[0] : null;
+  const template = candidate?.template;
+  const contract = template?.template_contract ?? {};
+  if (!template) return null;
+  return {
+    template_id: String(template.id || contract.template_id || ""),
+    template_name: String(template.name || contract.name || ""),
+    template_slug: String(contract.slug || ""),
+    industry: String(contract.industry || ""),
+    use_case: String(contract.use_case || ""),
+    match_score: Number.isFinite(Number(candidate.match_score)) ? Number(candidate.match_score) : null,
+    matched_reasons: Array.isArray(candidate.matched_reasons) ? candidate.matched_reasons.map(String) : []
+  };
+}
+async function emitObjectiveSetupBootstrap(opts) {
+  const businessName = normalizeString(opts.businessName);
+  const objective = normalizeString(opts.objective);
+  const industry = normalizeString(opts.industry);
+  const sourceUrl = normalizeString(opts.sourceUrl);
+  const tools = csv(opts.tools, "widget,voice,whatsapp");
+  let credentials = null;
+  try {
+    credentials = loadCredentials(opts.apiUrl);
+    if (!opts.org) opts.org = credentials.orgId;
+  } catch {
+    credentials = null;
+  }
+  if (!credentials && !opts.org) {
+    format({
+      schema_version: "foh_cli_objective_setup_bootstrap.v1",
+      ok: false,
+      status: "blocked",
+      reason_code: "auth_required",
+      summary: "Authenticate before objective setup so template selection and setup planning can use the correct org.",
+      spend_policy: resolveCliSpendPolicy(),
+      next_commands: [
+        "npx --yes @f-o-h/cli@latest auth signup --web --json",
+        "npx --yes @f-o-h/cli@latest auth login --web --json",
+        "npx --yes @f-o-h/cli@latest org list --json",
+        objectiveSetupCommand(opts)
+      ]
+    }, { json: opts.json ?? false });
+    markCommandFailed(1);
+    return;
+  }
+  const missing = [];
+  if (!businessName) missing.push("--business-name");
+  if (!industry) missing.push("--industry");
+  if (!objective) missing.push("--objective");
+  if (!sourceUrl) missing.push("--source-url");
+  if (industry && !OBJECTIVE_SETUP_INDUSTRIES.includes(industry)) missing.push("--industry:supported_value");
+  if (missing.length > 0) {
+    format({
+      schema_version: "foh_cli_objective_setup_bootstrap.v1",
+      ok: false,
+      status: "blocked",
+      reason_code: "objective_setup_required_options_missing",
+      summary: "Objective setup needs an explicit business name, industry, objective, and official source URL.",
+      missing_options: missing,
+      org_id: opts.org ?? null,
+      next_commands: [
+        objectiveSetupCommand(opts),
+        "npx --yes @f-o-h/cli@latest templates list --category general --json",
+        "npx --yes @f-o-h/cli@latest templates list --category buyer --json"
+      ],
+      claim_boundaries: {
+        customer_live_claim_allowed: false,
+        production_claim_allowed: false
+      }
+    }, { json: opts.json ?? false });
+    markCommandFailed(1);
+    return;
+  }
+  const brief = {
+    schema_version: "business_requirement_brief.v1",
+    business_name: businessName,
+    industry,
+    desired_use_cases: [objective],
+    channels: objectiveChannels(tools),
+    knowledge_sources: [{ type: "website", label: `${businessName} official website`, uri: sourceUrl }],
+    required_outcomes: [objective],
+    handoff_rules: ["handoff when approved facts, credentials, or action availability are missing"],
+    constraints: ["do not invent business facts or claim live readiness without accepted evidence"],
+    optimization_target: objectiveOptimizationTarget(industry, objective)
+  };
+  const templateSelection = await apiFetch("/v1/console/templates/select", {
+    method: "POST",
+    body: JSON.stringify(brief),
+    apiUrlOverride: opts.apiUrl
+  });
+  const selectedTemplate = selectedTemplateSummary(templateSelection);
+  if (!selectedTemplate) {
+    format({
+      schema_version: "foh_cli_objective_setup_bootstrap.v1",
+      ok: false,
+      status: "blocked",
+      reason_code: "objective_template_selection_empty",
+      summary: "No supported template matched this objective. Do not continue with a guessed template.",
+      requirement_brief: brief,
+      template_selection: templateSelection,
+      next_commands: [objectiveSetupCommand(opts)]
+    }, { json: opts.json ?? false });
+    markCommandFailed(1);
+    return;
+  }
+  const setupWorkflow = await apiFetch("/v1/console/agency-setup/workflow", {
+    method: "POST",
+    body: JSON.stringify({
+      agency_name: businessName,
+      business_objective: objective,
+      requested_tool_surface: tools,
+      target_exposure_mode: normalizeString(opts.targetMode) || "customer_owned_voice_trial",
+      source_url: sourceUrl,
+      ...normalizeString(opts.location) ? { branch_location: normalizeString(opts.location) } : {}
+    }),
+    orgId: opts.org,
+    apiUrlOverride: opts.apiUrl
+  });
+  format({
+    schema_version: "foh_cli_objective_setup_bootstrap.v1",
+    ok: true,
+    status: "hold",
+    reason_code: "objective_setup_plan_ready",
+    summary: "Objective setup plan is ready. Treat this as dry-run planning until evidence is applied and status explicitly allows live claims.",
+    dry_run: opts.apply === true ? false : true,
+    apply_requested: opts.apply === true,
+    org_id: opts.org ?? null,
+    requirement_brief: brief,
+    selected_template: selectedTemplate,
+    setup_workflow: {
+      decision: setupWorkflow?.decision ?? setupWorkflow?.status ?? null,
+      reason_codes: Array.isArray(setupWorkflow?.reason_codes) ? setupWorkflow.reason_codes : [],
+      evidence_packet: setupWorkflow?.evidence_packet ?? null,
+      operator_status: setupWorkflow?.operator_status ?? null
+    },
+    claim_boundaries: {
+      customer_live_claim_allowed: false,
+      production_claim_allowed: false,
+      fully_autonomous_claim_allowed: false
+    },
+    next_commands: [
+      `npx --yes @f-o-h/cli@latest objective status --business-name ${JSON.stringify(businessName)} --industry ${industry} --business-objective ${JSON.stringify(objective)} --source-url ${JSON.stringify(sourceUrl)} --out test-results/objective-status.latest.json --json`,
+      "npx --yes @f-o-h/cli@latest objective debug --from test-results/objective-status.latest.json --json",
+      `npx --yes @f-o-h/cli@latest templates show --template ${selectedTemplate.template_id} --json`
+    ]
+  }, { json: opts.json ?? false });
+}
 function registerSetup(program3) {
-  program3.command("setup").description("Fully provision a new agency customer in one command").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--agent-template <id>", "Agent template ID (e.g. viewing-request)").option("--agent-name <name>", "Name for the new agent").option("--phone-country <cc>", "Phone number country code", "GB").option("--phone-area-code <code>", "Phone area code preference").option("--phone-mode <mode>", "Phone path: observe, skip, or purchase", "purchase").option("--widget-domains <domains>", "Comma-separated widget domain allowlist").option("--voice-provider <p>", "TTS provider: openai, azure, twilio").option("--voice-id <id>", "Voice ID").option("--skip-compliance", "Skip compliance submission and wait").option("--skip-voice", "Skip voice configuration").option("--skip-tests", "Skip smoke tests").option("--cert-mode <m>", "Simulation cert mode: quick, full, stress", "quick").option("--cert-adaptive-runs <n>", "Adaptive run count for certification loop", "30").option("--cert-max-improvement-rounds <n>", "Max instruction improvement rounds in cert loop (0-5)", "1").option("--resume-from <step>", `Resume from a setup step (${SETUP_STEP_ORDER.join(", ")})`).option("--report-out <path>", "Optional path to write signed setup run report JSON").option("--dry-run", "Print all steps that would run without making any API calls").option("--api-url <url>", "API base URL override").option("--console-url <url>", "Console sign-in URL override").option("--json", "Output as JSON").action(async (opts) => {
+  program3.command("setup").description("Fully provision a customer or plan objective-first setup").option("--objective <text>", "Objective-first setup mode: plain-English front-of-house objective").option("--business-name <name>", "Business trading name for objective-first setup").option("--industry <industry>", "Business industry for objective-first setup: real_estate, restaurant, general").option("--source-url <url>", "Official business source URL for objective-first setup").option("--location <value>", "Location or branch represented by this setup").option("--tools <csv>", "Requested surfaces for objective-first setup", "widget,voice,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode for objective-first setup", "customer_owned_voice_trial").option("--apply", "Explicitly request apply mode for objective setup; default is dry-run planning").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--agent-template <id>", "Agent template ID (e.g. viewing-request)").option("--agent-name <name>", "Name for the new agent").option("--phone-country <cc>", "Phone number country code", "GB").option("--phone-area-code <code>", "Phone area code preference").option("--phone-mode <mode>", "Phone path: observe, skip, or purchase", "purchase").option("--widget-domains <domains>", "Comma-separated widget domain allowlist").option("--voice-provider <p>", "TTS provider: openai, azure, twilio").option("--voice-id <id>", "Voice ID").option("--skip-compliance", "Skip compliance submission and wait").option("--skip-voice", "Skip voice configuration").option("--skip-tests", "Skip smoke tests").option("--cert-mode <m>", "Simulation cert mode: quick, full, stress", "quick").option("--cert-adaptive-runs <n>", "Adaptive run count for certification loop", "30").option("--cert-max-improvement-rounds <n>", "Max instruction improvement rounds in cert loop (0-5)", "1").option("--resume-from <step>", `Resume from a setup step (${SETUP_STEP_ORDER.join(", ")})`).option("--report-out <path>", "Optional path to write signed setup run report JSON").option("--dry-run", "Print all steps that would run without making any API calls").option("--api-url <url>", "API base URL override").option("--console-url <url>", "Console sign-in URL override").option("--json", "Output as JSON").action(async (opts) => {
+    if (opts.objective) {
+      await emitObjectiveSetupBootstrap(opts);
+      return;
+    }
     if (!opts.org) {
       try {
         opts.org = loadCredentials(opts.apiUrl).orgId;
@@ -35738,7 +35801,7 @@ function defaultAdaptiveRuns(profile) {
   if (profile === "stress") return 30;
   return 5;
 }
-function csv(raw) {
+function csv2(raw) {
   if (!raw) return void 0;
   const values = String(raw).split(",").map((value) => value.trim()).filter(Boolean);
   return values.length > 0 ? values : void 0;
@@ -35764,8 +35827,8 @@ function registerCertify(program3) {
           body: JSON.stringify({
             mode,
             adaptive_runs: adaptiveRuns,
-            journeys: csv(opts.journeys),
-            scenario_ids: csv(opts.scenarioIds),
+            journeys: csv2(opts.journeys),
+            scenario_ids: csv2(opts.scenarioIds),
             channel: channel(opts.channel)
           }),
           apiUrlOverride: opts.apiUrl
@@ -38114,6 +38177,9 @@ function fail(name, reasonCode, error2, nextCommand) {
 function skipped(name, reasonCode, summary, nextCommand) {
   return { name, category: categoryForCheck(name), status: "skipped", reason_code: reasonCode, summary, next_command: nextCommand };
 }
+function defaultCertificationProfileForMission(mission) {
+  return mission === "publish" ? "release" : "smoke";
+}
 function hasBlockingChecks(checks) {
   return checks.some((check2) => check2.status === "hold" || check2.status === "fail");
 }
@@ -38451,11 +38517,12 @@ function registerProve(program3) {
       if (opts.skipCert) {
         checks.push(skipped("simulation_certification", "operator_skipped", "Skipped by --skip-cert.", `foh certify run --agent ${ctx.agentId} --profile release --json`));
       } else if (!opts.includeCertification) {
+        const certificationProfile = defaultCertificationProfileForMission(mission);
         checks.push(skipped(
           "simulation_certification",
           "certification_explicitly_required",
-          "Runtime proof does not run release certification by default.",
-          `foh certify run --agent ${ctx.agentId} --profile release --json`
+          certificationProfile === "release" ? "Runtime proof does not run release certification by default." : "Runtime proof does not run certification by default; use smoke certification for bounded external-agent verification.",
+          `foh certify run --agent ${ctx.agentId} --profile ${certificationProfile} --json`
         ));
       } else {
         try {
@@ -38551,14 +38618,16 @@ function registerProve(program3) {
 var import_node_fs5 = require("node:fs");
 var import_node_path2 = require("node:path");
 var DEFAULT_OBJECTIVE_REPORT_PATH = "test-results/objective-status.latest.json";
+var VALID_OBJECTIVE_INDUSTRIES = ["real_estate", "restaurant", "general"];
+var BUSINESS_REQUIREMENT_BRIEF_SCHEMA_VERSION = "business_requirement_brief.v1";
 function asRecord3(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function normalizeString(value) {
+function normalizeString2(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function uniqueStrings(values) {
-  return Array.from(new Set(values.map(normalizeString).filter(Boolean)));
+  return Array.from(new Set(values.map(normalizeString2).filter(Boolean)));
 }
 function asArray(value) {
   return Array.isArray(value) ? value : [];
@@ -38630,7 +38699,7 @@ function normalizeCustomerEvidenceActions(value) {
     ]),
     required_evidence: firstString(action, ["required_evidence"]) || null,
     unlocks: firstString(action, ["unlocks"]) || null
-  })).filter((action) => normalizeString(action.id));
+  })).filter((action) => normalizeString2(action.id));
 }
 function normalizeCustomerEvidenceActionPacket(value) {
   const packet = asRecord3(value);
@@ -38716,7 +38785,7 @@ async function resolveEvidenceInput(opts) {
 }
 function firstString(record2, keys) {
   for (const key of keys) {
-    const value = normalizeString(record2[key]);
+    const value = normalizeString2(record2[key]);
     if (value) return value;
   }
   return "";
@@ -38734,13 +38803,13 @@ function statusFromDecision(value) {
   return "hold";
 }
 function firstCustomerEvidenceAction(packet) {
-  const actions = asArray(packet?.actions).map(asRecord3).filter((action) => normalizeString(action.id));
+  const actions = asArray(packet?.actions).map(asRecord3).filter((action) => normalizeString2(action.id));
   return actions[0] ?? null;
 }
 function buildDeveloperReadinessPacket(input) {
   const businessName = resolveBusinessName(input.opts);
-  const sourceUrl = normalizeString(input.opts.sourceUrl);
-  const businessObjective = normalizeString(input.opts.businessObjective);
+  const sourceUrl = normalizeString2(input.opts.sourceUrl);
+  const businessObjective = normalizeString2(input.opts.businessObjective);
   const location = resolveLocation(input.opts);
   const tools = parseCsvOption(input.opts.tools ?? "widget,voice,email,callback,calendar,crm,webhook,whatsapp") ?? [];
   const setupDecision = firstString(input.setupWorkflow, ["decision", "current_decision", "status"]);
@@ -38757,9 +38826,10 @@ function buildDeveloperReadinessPacket(input) {
     business_context: {
       business_name: businessName || null,
       business_objective: businessObjective || null,
+      industry: objectiveIndustryOrNull(input.opts),
       source_url: sourceUrl || null,
       location: location || null,
-      target_mode: normalizeString(input.opts.targetMode) || "customer_owned_voice_trial",
+      target_mode: normalizeString2(input.opts.targetMode) || "customer_owned_voice_trial",
       tools
     },
     input_completeness: {
@@ -38767,7 +38837,7 @@ function buildDeveloperReadinessPacket(input) {
       source_url: Boolean(sourceUrl),
       business_objective: Boolean(businessObjective),
       requested_tools: tools.length > 0,
-      target_mode: Boolean(normalizeString(input.opts.targetMode) || "customer_owned_voice_trial")
+      target_mode: Boolean(normalizeString2(input.opts.targetMode) || "customer_owned_voice_trial")
     },
     readiness_dimensions: {
       setup_workflow: {
@@ -38781,7 +38851,7 @@ function buildDeveloperReadinessPacket(input) {
       customer_evidence_actions: {
         status: firstAction ? "hold" : "pass",
         action_count: finiteNumber(input.customerEvidenceActionPacket?.action_count) ?? asArray(input.customerEvidenceActionPacket?.actions).length,
-        first_action_id: firstAction ? normalizeString(firstAction.id) : null,
+        first_action_id: firstAction ? normalizeString2(firstAction.id) : null,
         first_validator_command: firstActionValidator
       },
       agent_operability: {
@@ -38805,7 +38875,7 @@ function buildDeveloperReadinessPacket(input) {
   };
 }
 function resolveObjectiveReportPath(value) {
-  const raw = normalizeString(value);
+  const raw = normalizeString2(value);
   if (!raw || raw === "latest") return (0, import_node_path2.resolve)(DEFAULT_OBJECTIVE_REPORT_PATH);
   return (0, import_node_path2.resolve)(raw);
 }
@@ -38823,11 +38893,11 @@ function buildSetupBody(opts) {
   const location = resolveLocation(opts);
   const body = {
     agency_name: businessName,
-    business_objective: normalizeString(opts.businessObjective) || null,
+    business_objective: normalizeString2(opts.businessObjective) || null,
     requested_tool_surface: tools,
-    target_exposure_mode: normalizeString(opts.targetMode) || "customer_owned_voice_trial"
+    target_exposure_mode: normalizeString2(opts.targetMode) || "customer_owned_voice_trial"
   };
-  if (opts.sourceUrl) body.source_url = normalizeString(opts.sourceUrl);
+  if (opts.sourceUrl) body.source_url = normalizeString2(opts.sourceUrl);
   if (location) body.branch_location = location;
   return body;
 }
@@ -38835,19 +38905,176 @@ function buildStatusParams(opts) {
   const params = new URLSearchParams();
   const businessName = resolveBusinessName(opts);
   const location = resolveLocation(opts);
-  if (opts.environment) params.set("environment", normalizeString(opts.environment));
+  if (opts.environment) params.set("environment", normalizeString2(opts.environment));
   if (businessName) params.set("agency_name", businessName);
-  if (opts.sourceUrl) params.set("source_url", normalizeString(opts.sourceUrl));
+  if (opts.sourceUrl) params.set("source_url", normalizeString2(opts.sourceUrl));
   if (location) params.set("branch_location", location);
-  if (opts.tools) params.set("tools", normalizeString(opts.tools));
-  if (opts.targetMode) params.set("target_mode", normalizeString(opts.targetMode));
+  if (opts.tools) params.set("tools", normalizeString2(opts.tools));
+  if (opts.targetMode) params.set("target_mode", normalizeString2(opts.targetMode));
   return params;
 }
 function resolveBusinessName(opts) {
-  return normalizeString(opts.businessName) || normalizeString(opts.agencyName);
+  return normalizeString2(opts.businessName) || normalizeString2(opts.agencyName);
 }
 function resolveLocation(opts) {
-  return normalizeString(opts.location) || normalizeString(opts.branchLocation);
+  return normalizeString2(opts.location) || normalizeString2(opts.branchLocation);
+}
+function hasAnyToken(value, tokens) {
+  const normalized = ` ${value.toLowerCase().replace(/[^a-z0-9]+/g, " ")} `;
+  return tokens.some((token) => normalized.includes(` ${token} `));
+}
+function inferObjectiveIndustry(opts) {
+  const explicit = normalizeString2(opts.industry);
+  if (explicit) {
+    if (VALID_OBJECTIVE_INDUSTRIES.includes(explicit)) return explicit;
+    throw new FohError({
+      step: "objective.brief",
+      error: `Unsupported industry: ${explicit}.`,
+      remediation: `Use one of: ${VALID_OBJECTIVE_INDUSTRIES.join(", ")}.`,
+      statusCode: 400,
+      reasonCode: "objective_industry_unsupported"
+    });
+  }
+  const objectiveText = [
+    opts.businessObjective,
+    opts.businessName,
+    opts.agencyName,
+    opts.sourceUrl
+  ].map(normalizeString2).join(" ");
+  const realEstate = hasAnyToken(objectiveText, [
+    "estate",
+    "property",
+    "properties",
+    "viewing",
+    "valuation",
+    "buyer",
+    "seller",
+    "landlord",
+    "tenant",
+    "lettings"
+  ]);
+  const restaurant = hasAnyToken(objectiveText, [
+    "restaurant",
+    "table",
+    "booking",
+    "reservation",
+    "reservations",
+    "diner",
+    "diners",
+    "menu",
+    "allergy",
+    "hospitality"
+  ]);
+  if (realEstate && !restaurant) return "real_estate";
+  if (restaurant && !realEstate) return "restaurant";
+  throw new FohError({
+    step: "objective.brief",
+    error: realEstate && restaurant ? "Objective matches multiple industries." : "Objective is too ambiguous to select a business template.",
+    remediation: "Pass --industry real_estate or --industry restaurant, and keep --business-objective specific to one front-of-house outcome.",
+    statusCode: 400,
+    reasonCode: realEstate && restaurant ? "objective_industry_ambiguous" : "objective_industry_missing",
+    nextCommands: [
+      'foh objective plan --business-name <name> --industry restaurant --business-objective "Book tables from website and voice enquiries" --source-url <official_url> --json',
+      'foh objective plan --business-name <name> --industry real_estate --business-objective "Qualify buyers and book viewings" --source-url <official_url> --json'
+    ]
+  });
+}
+function objectiveIndustryOrNull(opts) {
+  try {
+    return inferObjectiveIndustry(opts);
+  } catch {
+    return null;
+  }
+}
+function channelsFromTools(tools) {
+  const supported = /* @__PURE__ */ new Set(["widget", "voice", "whatsapp", "instagram", "sms"]);
+  const channels = tools.filter((tool) => supported.has(tool));
+  return channels.length > 0 ? channels : ["widget"];
+}
+function inferOptimizationTarget(industry, objective) {
+  const normalized = objective.toLowerCase();
+  if (industry === "restaurant" || /book|booking|reservation|table/.test(normalized)) return "booking_rate";
+  if (/speed|fast|callback|call back|lead/.test(normalized)) return "speed_to_lead";
+  if (/support|help|resolve|resolution/.test(normalized)) return "support_resolution";
+  return "lead_quality";
+}
+function buildRequirementBrief(opts) {
+  const businessName = resolveBusinessName(opts);
+  const businessObjective = normalizeString2(opts.businessObjective);
+  if (!businessObjective) {
+    throw new FohError({
+      step: "objective.brief",
+      error: "Missing business objective.",
+      remediation: "Pass --business-objective with the concrete front-of-house outcome to configure.",
+      statusCode: 400,
+      reasonCode: "objective_business_objective_missing"
+    });
+  }
+  const industry = inferObjectiveIndustry(opts);
+  const tools = parseCsvOption(opts.tools ?? "widget,voice,email,callback,calendar,crm,webhook,whatsapp") ?? [];
+  const knowledgeSources = [];
+  const sourceUrl = normalizeString2(opts.sourceUrl);
+  if (sourceUrl) {
+    knowledgeSources.push({
+      type: "website",
+      label: `${businessName} official website`,
+      uri: sourceUrl
+    });
+  }
+  return {
+    schema_version: BUSINESS_REQUIREMENT_BRIEF_SCHEMA_VERSION,
+    business_name: businessName,
+    industry,
+    desired_use_cases: [businessObjective],
+    channels: channelsFromTools(tools),
+    knowledge_sources: knowledgeSources,
+    required_outcomes: [businessObjective],
+    handoff_rules: ["handoff when customer facts, credentials, or booking/action availability are missing"],
+    constraints: ["do not invent business facts or confirm actions without configured evidence/tool results"],
+    optimization_target: inferOptimizationTarget(industry, businessObjective)
+  };
+}
+function selectedTemplateSummary2(templateSelection) {
+  const candidates = asArray(asRecord3(templateSelection).candidates).map(asRecord3);
+  const top = candidates[0];
+  const template = asRecord3(top?.template);
+  if (!template || Object.keys(template).length === 0) return null;
+  const contract = asRecord3(template.template_contract);
+  return {
+    template_id: normalizeString2(template.id) || normalizeString2(contract.template_id) || null,
+    template_name: normalizeString2(template.name) || normalizeString2(contract.name) || null,
+    industry: normalizeString2(contract.industry) || null,
+    use_case: normalizeString2(contract.use_case) || null,
+    match_score: finiteNumber(top.match_score),
+    matched_reasons: uniqueStrings(asArray(top.matched_reasons))
+  };
+}
+function assertTemplateSelected(templateSelection) {
+  if (selectedTemplateSummary2(templateSelection)) return;
+  throw new FohError({
+    step: "objective.template_selection",
+    error: "No supported template matched this business objective.",
+    remediation: "Use a more specific --business-objective or choose a supported --industry before setup. Do not continue with a guessed template.",
+    statusCode: 422,
+    reasonCode: "objective_template_selection_empty",
+    nextCommands: [
+      "foh templates select --brief @business-brief.json --json"
+    ]
+  });
+}
+async function selectTemplateForObjective(opts) {
+  const brief = buildRequirementBrief(opts);
+  const selection = await apiFetch("/v1/console/templates/select", {
+    method: "POST",
+    body: JSON.stringify(brief),
+    apiUrlOverride: opts.apiUrl
+  });
+  assertTemplateSelected(selection);
+  return {
+    brief,
+    selection,
+    selected: selectedTemplateSummary2(selection)
+  };
 }
 function assertBusinessName(opts, step) {
   if (resolveBusinessName(opts)) return;
@@ -38894,7 +39121,7 @@ function buildObjectiveReport(input) {
     ...collectStringArrays(setup, /* @__PURE__ */ new Set(["reason_codes", "blocker_reason_codes"])),
     ...collectStringArrays(live, /* @__PURE__ */ new Set(["reason_codes", "blocker_reason_codes"]))
   ]);
-  const debugSource = normalizeString(input.opts.out) || "latest";
+  const debugSource = normalizeString2(input.opts.out) || "latest";
   const nextCommands = dedupeCommands([
     ...collectStringArrays(setup, /* @__PURE__ */ new Set(["next_commands"])),
     ...collectStringArrays(live, /* @__PURE__ */ new Set(["next_commands"])),
@@ -38934,15 +39161,19 @@ function buildObjectiveReport(input) {
     safeToRetry: true,
     extra: {
       objective: {
-        business_objective: normalizeString(input.opts.businessObjective) || null,
+        business_objective: normalizeString2(input.opts.businessObjective) || null,
         business_name: resolveBusinessName(input.opts) || null,
-        agency_name: normalizeString(input.opts.agencyName) || resolveBusinessName(input.opts) || null,
-        source_url: normalizeString(input.opts.sourceUrl) || null,
+        agency_name: normalizeString2(input.opts.agencyName) || resolveBusinessName(input.opts) || null,
+        industry: objectiveIndustryOrNull(input.opts),
+        source_url: normalizeString2(input.opts.sourceUrl) || null,
         location: resolveLocation(input.opts) || null,
-        branch_location: normalizeString(input.opts.branchLocation) || resolveLocation(input.opts) || null,
-        target_mode: normalizeString(input.opts.targetMode) || "customer_owned_voice_trial",
+        branch_location: normalizeString2(input.opts.branchLocation) || resolveLocation(input.opts) || null,
+        target_mode: normalizeString2(input.opts.targetMode) || "customer_owned_voice_trial",
         tools: parseCsvOption(input.opts.tools ?? "widget,voice,email,callback,calendar,crm,webhook,whatsapp") ?? []
       },
+      requirement_brief: firstNonEmptyObject(input.requirementBrief) ?? null,
+      selected_template: firstNonEmptyObject(input.selectedTemplate) ?? null,
+      template_selection: firstNonEmptyObject(input.templateSelection) ?? null,
       allowed_mode: allowedMode,
       blocked_modes: blockedModes,
       reason_codes: reasonCodes,
@@ -38996,7 +39227,7 @@ function stripDiagnosticField(target, fieldPath) {
 function buildObjectiveNormalPathOutput(report) {
   const output = JSON.parse(JSON.stringify(report));
   const artifactPolicy = asRecord3(output.artifact_policy);
-  const diagnosticFields = uniqueStrings(asArray(artifactPolicy.diagnostic_fields).map((value) => normalizeString(value)));
+  const diagnosticFields = uniqueStrings(asArray(artifactPolicy.diagnostic_fields).map((value) => normalizeString2(value)));
   for (const fieldPath of diagnosticFields) stripDiagnosticField(output, fieldPath);
   return output;
 }
@@ -39072,8 +39303,9 @@ function buildDebugReport(sourcePath, objectiveReport) {
 }
 function registerObjective(program3) {
   const objective = program3.command("objective").description("Agent-native objective workflow: plan, apply, prove, status, debug");
-  objective.command("plan").description("Generate an objective setup/workflow plan").option("--business-name <name>", "Business trading name").option("--agency-name <name>", "Legacy alias for --business-name").option("--business-objective <text>", "Natural-language business objective").option("--source-url <url>", "Official source URL").option("--location <value>", "Location or branch this setup represents").option("--branch-location <value>", "Legacy alias for --location").option("--tools <csv>", "Requested tool surfaces", "widget,voice,email,callback,calendar,crm,webhook,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode", "customer_owned_voice_trial").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--out <path>", "Write objective plan JSON to this file path").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
+  objective.command("plan").description("Generate an objective setup/workflow plan").option("--business-name <name>", "Business trading name").option("--agency-name <name>", "Legacy alias for --business-name").option("--industry <industry>", "Business industry: real_estate, restaurant, general").option("--business-objective <text>", "Natural-language business objective").option("--source-url <url>", "Official source URL").option("--location <value>", "Location or branch this setup represents").option("--branch-location <value>", "Legacy alias for --location").option("--tools <csv>", "Requested tool surfaces", "widget,voice,email,callback,calendar,crm,webhook,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode", "customer_owned_voice_trial").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--out <path>", "Write objective plan JSON to this file path").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
     assertBusinessName(opts, "objective.plan");
+    const templateSelection = await selectTemplateForObjective(opts);
     const report = await apiFetch("/v1/console/agency-setup/workflow", {
       method: "POST",
       body: JSON.stringify(buildSetupBody(opts)),
@@ -39081,7 +39313,13 @@ function registerObjective(program3) {
       apiUrlOverride: opts.apiUrl
     });
     const outPath = opts.out ? resolveObjectiveReportPath(opts.out) : null;
-    const output = outPath ? { ...asRecord3(report), artifact_path: outPath } : report;
+    const objectiveSetup = {
+      ...asRecord3(report),
+      requirement_brief: templateSelection.brief,
+      template_selection: templateSelection.selection,
+      selected_template: templateSelection.selected
+    };
+    const output = outPath ? { ...objectiveSetup, artifact_path: outPath } : objectiveSetup;
     if (outPath) writeJsonArtifact2(outPath, output);
     format(output, { json: opts.json ?? false });
   }));
@@ -39102,7 +39340,7 @@ function registerObjective(program3) {
     if (outPath) writeJsonArtifact2(outPath, output);
     format(output, { json: opts.json ?? false });
   }));
-  objective.command("prove").description("Run objective proof status against customer-live gate").option("--business-name <name>", "Business trading name").option("--agency-name <name>", "Legacy alias for --business-name").option("--business-objective <text>", "Natural-language business objective").option("--source-url <url>", "Official source URL").option("--location <value>", "Location or branch this setup represents").option("--branch-location <value>", "Legacy alias for --location").option("--tools <csv>", "Requested tool surfaces", "widget,voice,email,callback,calendar,crm,webhook,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode", "customer_owned_voice_trial").option("--environment <value>", "Environment filter").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--out <path>", "Write objective proof JSON to this file path").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
+  objective.command("prove").description("Run objective proof status against customer-live gate").option("--business-name <name>", "Business trading name").option("--agency-name <name>", "Legacy alias for --business-name").option("--industry <industry>", "Business industry: real_estate, restaurant, general").option("--business-objective <text>", "Natural-language business objective").option("--source-url <url>", "Official source URL").option("--location <value>", "Location or branch this setup represents").option("--branch-location <value>", "Legacy alias for --location").option("--tools <csv>", "Requested tool surfaces", "widget,voice,email,callback,calendar,crm,webhook,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode", "customer_owned_voice_trial").option("--environment <value>", "Environment filter").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--out <path>", "Write objective proof JSON to this file path").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
     assertBusinessName(opts, "objective.prove");
     const status = await apiFetch(withQuery("/v1/console/customer-live-status", buildStatusParams(opts)), {
       orgId: opts.org,
@@ -39113,8 +39351,9 @@ function registerObjective(program3) {
     if (outPath) writeJsonArtifact2(outPath, output);
     format(output, { json: opts.json ?? false });
   }));
-  objective.command("status").description("Compose setup and launch evidence into one agent workbench status envelope").option("--business-name <name>", "Business trading name").option("--agency-name <name>", "Legacy alias for --business-name").option("--business-objective <text>", "Natural-language business objective").option("--source-url <url>", "Official source URL").option("--location <value>", "Location or branch this setup represents").option("--branch-location <value>", "Legacy alias for --location").option("--tools <csv>", "Requested tool surfaces", "widget,voice,email,callback,calendar,crm,webhook,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode", "customer_owned_voice_trial").option("--environment <value>", "Environment filter").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--out <path>", "Write objective report JSON to this file path").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
+  objective.command("status").description("Compose setup and launch evidence into one agent workbench status envelope").option("--business-name <name>", "Business trading name").option("--agency-name <name>", "Legacy alias for --business-name").option("--industry <industry>", "Business industry: real_estate, restaurant, general").option("--business-objective <text>", "Natural-language business objective").option("--source-url <url>", "Official source URL").option("--location <value>", "Location or branch this setup represents").option("--branch-location <value>", "Legacy alias for --location").option("--tools <csv>", "Requested tool surfaces", "widget,voice,email,callback,calendar,crm,webhook,whatsapp").option("--target-mode <mode>", "Target launch/exposure mode", "customer_owned_voice_trial").option("--environment <value>", "Environment filter").option("--org <id>", "Org ID (default: stored org from foh org use)").option("--api-url <url>", "API base URL override").option("--out <path>", "Write objective report JSON to this file path").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
     assertBusinessName(opts, "objective.status");
+    const templateSelection = await selectTemplateForObjective(opts);
     const setupWorkflow = await apiFetch("/v1/console/agency-setup/workflow", {
       method: "POST",
       body: JSON.stringify(buildSetupBody(opts)),
@@ -39125,7 +39364,14 @@ function registerObjective(program3) {
       orgId: opts.org,
       apiUrlOverride: opts.apiUrl
     });
-    const report = buildObjectiveReport({ opts, setupWorkflow, customerLiveStatus });
+    const report = buildObjectiveReport({
+      opts,
+      setupWorkflow,
+      customerLiveStatus,
+      requirementBrief: templateSelection.brief,
+      templateSelection: templateSelection.selection,
+      selectedTemplate: templateSelection.selected
+    });
     const artifactPath = resolveObjectiveReportPath(opts.out);
     const fullOutput = withObjectiveArtifactPath(report, artifactPath);
     writeJsonArtifact2(artifactPath, fullOutput);
@@ -39423,9 +39669,9 @@ var COMMAND_SURFACE_DEFINITIONS = [
     includeInSuggestions: false
   },
   {
-    id: "whatsapp_start",
-    commandPath: ["channel", "whatsapp", "start"],
-    label: "whatsapp start",
+    id: "whatsapp_onboard",
+    commandPath: ["channel", "whatsapp", "onboard"],
+    label: "whatsapp onboard",
     descriptionFallback: "WhatsApp readiness path",
     mutatesState: "write",
     shellSlash: "/whatsapp",
@@ -42321,10 +42567,11 @@ function createExternalAgentExecutorPlan(options) {
       ].join("\n"),
       "utf8"
     );
+    const explicitPromptVersion = typeof run.prompt_version === "string" && run.prompt_version.trim() ? run.prompt_version.trim() : typeof batch.prompt_version === "string" && batch.prompt_version.trim() ? batch.prompt_version.trim() : promptVersionFromPath(promptPath);
     const env = buildCodexExecutorEnv({
       sourceEnv: options.env,
       runDir,
-      promptVersion: promptVersionFromPath(promptPath)
+      promptVersion: explicitPromptVersion
     });
     const promptVersion = String(env[EXTERNAL_AGENT_PROMPT_VERSION_ENV] || "unknown");
     const outputStem = runner === "gemini" ? "gemini" : "codex";
@@ -43091,6 +43338,7 @@ var DEFAULT_PROMPT_VERSION = "blank-setup.v1";
 var DEFAULT_BATCH_MODELS = "openai/codex,anthropic/claude,cursor/agent";
 var PROMPTS = {
   "blank-setup.v1": "Go to https://frontofhouse.okii.uk. Use only public docs, public API docs, and the public npm CLI package. Always invoke the CLI with `npx --yes @f-o-h/cli@latest ...`; do not use unpinned `npx @f-o-h/cli ...`, because cached older packages can produce invalid evidence. Install or verify the FOH CLI, authenticate or reach a deterministic auth blocker, then create or configure a Front Of House voice agent and website widget. Mass evals reuse existing eval state: run `npx --yes @f-o-h/cli@latest org status --json` and `npx --yes @f-o-h/cli@latest agent list --json` before trying to create a fresh agent; if an existing eval agent is present, configure and prove that agent instead of creating a second bronze-tier agent. Prefer the certification-oriented buyer templates: run `npx --yes @f-o-h/cli@latest templates list --category buyer --json` and use `UK Buyer Qualification` or `Viewing Booking` when available; do not use a greeting-only template for proof/certification. Prefer `npx --yes @f-o-h/cli@latest setup --phone-mode observe` for the free scaffold path: agent, widget, voice config, smoke test, certification, and publish readiness together. Treat phone-number purchasing as an explicit paid/scarce contact-path step, not part of high-volume eval setup. If `FOH_CLI_SPEND_POLICY=no_spend` is active and a command returns `paid_resource_blocked_by_spend_policy`, do not try to bypass it; continue widget/setup proof and report that exact reason code for the phone path. If the customer/operator explicitly owns a number and asks for real PSTN proof, use `npx --yes @f-o-h/cli@latest provision byon attach --phone-number <e164> --confirm-owned --json`; do not invent ownership or buy a FOH-owned number. Run proof/smoke/certification where available, including widget proof, voice proof, and one explicit `foh certify run --agent <id> --profile release --json` before publish. `foh prove` does not run release certification by default; only pass `--include-certification --proof-cache-dir .foh/proof-cache` when an explicit combined proof/certification run is required. If voice proof returns `contact_phone_missing` or `voice_contact_expected_no_spend_hold`, report that exact reason code unless a BYON/customer-approved phone path already exists. If `FOH_EXTERNAL_AGENT_RUN_DIR` is set, write `${FOH_EXTERNAL_AGENT_RUN_DIR}/external-agent-metadata.json` with `schema_version`, `docs_pages_used`, key decisions, and blocker reason codes before finishing. Produce a final evidence summary with commands run, docs used, artifacts created, and any blocker reason codes. Do not assume access to the private source repository.",
+  "restaurant-table-booking-blackbox.v1": "Set up a front of house system for a real restaurant that takes table bookings. Find Front Of House online and use only public web pages, public docs, public API docs, and public package installs. Do not use or inspect any private repository, local source checkout, unpublished local commands, or hidden runbooks. Pick a real restaurant name and official website from public information, then try to reach a deterministic setup/proof result for a table-booking front-of-house agent. Use the authenticated environment if the public CLI discovers it, but do not expose credentials or secrets. Do not buy phone numbers or paid resources. If the system blocks because customer-owned credentials, booking-system access, approval, or live validation are missing, treat that as a valid hold only when the command returns machine-readable reason codes and exact next commands. If `FOH_EXTERNAL_AGENT_RUN_DIR` is set, write `${FOH_EXTERNAL_AGENT_RUN_DIR}/external-agent-metadata.json` with `schema_version`, `restaurant_name`, `restaurant_source_url`, `docs_pages_used`, `commands_run`, `artifacts_created`, `final_status`, `blocker_reason_codes`, and `friction_points` before finishing. Produce a final evidence summary with commands run, docs used, artifacts created, final pass/hold/fail status, blocker reason codes, and every friction point encountered.",
   "real-estate-buyer-enquiry.v1": "Go to https://frontofhouse.okii.uk. Use only public docs, public API docs, and the public npm CLI package. Always invoke the CLI with `npx --yes @f-o-h/cli@latest ...`; do not use unpinned `npx @f-o-h/cli ...`. Do not assume access to the private source repository. Mission: configure a buyer-enquiry real-estate agent (UK Buyer Qualification preferred), prove widget behavior, and prove voice behavior in no-spend mode. Required path: 1) verify auth/org scope and reuse existing eval org/agent where possible; 2) select/apply buyer template; 3) configure widget + voice; 4) run widget smoke and `foh certify run --profile release`; 5) run voice proof and treat no-spend contact holds as expected only when all non-contact gates pass. Do not buy numbers; if spend policy blocks purchase, record `paid_resource_blocked_by_spend_policy` and continue no-spend proof path. Final artifact must include: selected template id/slug, commands executed, pass/hold/fail per gate, reason codes, docs_pages_used, and next fix commands.",
   "real-estate-seller-valuation.v1": "Go to https://frontofhouse.okii.uk. Use only public docs, public API docs, and the public npm CLI package. Always invoke the CLI with `npx --yes @f-o-h/cli@latest ...`; do not use unpinned `npx @f-o-h/cli ...`. Do not assume access to the private source repository. Mission: configure a seller-valuation real-estate agent, prove valuation lead capture on widget and voice, and keep strict no-spend behavior. Required path: 1) verify auth/org scope and reuse existing eval state; 2) select/apply seller valuation template; 3) configure widget + voice; 4) run widget smoke and release certification; 5) run voice proof and classify holds. Do not claim precise valuation output without approved tooling; safe fallback or handoff must remain explicit. Do not buy numbers. Final artifact must include: selected template id/slug, lead fields observed, tool/action behavior, reason codes, docs_pages_used, and next fix commands.",
   "real-estate-viewing-and-qa.v1": "Go to https://frontofhouse.okii.uk. Use only public docs, public API docs, and the public npm CLI package. Always invoke the CLI with `npx --yes @f-o-h/cli@latest ...`; do not use unpinned `npx @f-o-h/cli ...`. Do not assume access to the private source repository. Mission: configure a viewing-booking/property-QA real-estate agent and prove booking-safe behavior under no-spend policy. Required path: 1) verify auth/org scope and reuse existing eval state; 2) select/apply viewing template; 3) configure widget + voice; 4) run widget smoke, release certification, and voice proof; 5) explicitly check no-duplicate-side-effect behavior and safe fallback/handoff when booking tooling or contact path is unavailable. Do not buy numbers. Final artifact must include: selected template id/slug, booking/fallback evidence, reason codes, docs_pages_used, and next fix commands.",
@@ -43768,11 +44016,12 @@ function installSoftExitTrap() {
 // src/lib/mission-help.ts
 var CLI_MISSION_EXAMPLES = [
   { mission: "Start", command: "foh start", description: "guided setup and next action selector" },
-  { mission: "Objective Plan", command: "foh objective plan --business-name <name> --source-url <url> --out test-results/objective-plan.latest.json --json", description: "generate setup and onboarding context" },
+  { mission: "Setup Objective", command: 'foh setup --objective "<goal>" --business-name <name> --industry <industry> --source-url <url> --json', description: "select template and create/update the agent from a business goal" },
+  { mission: "Objective Plan", command: "foh objective plan --business-name <name> --source-url <url> --out test-results/objective-plan.latest.json --json", description: "preview setup and onboarding context without applying" },
   { mission: "Objective Apply", command: "foh objective apply --evidence <json|@file> --out test-results/objective-apply.latest.json --json", description: "submit verified evidence into customer-live gating path" },
   { mission: "Objective Prove", command: "foh objective prove --business-name <name> --source-url <url> --out test-results/objective-live.latest.json --json", description: "run customer-live proof check directly" },
   { mission: "Objective Status", command: "foh objective status --business-name <name> --source-url <url> --out test-results/objective-status.latest.json --json", description: "compose setup and live status into one report envelope" },
-  { mission: "Setup", command: "foh setup --phone-mode observe --json", description: "create or update agent, widget, voice config, and proof scaffold" },
+  { mission: "Setup Legacy", command: "foh setup --phone-mode observe --json", description: "create or update agent from an explicit template" },
   { mission: "Prove", command: "foh prove --agent <agent_id> --mission widget --json", description: "produce a machine-readable proof report" },
   { mission: "Publish", command: "foh publish --agent <agent_id> --json", description: "publish when proof and release evidence pass" },
   { mission: "Debug", command: "foh debug --out test-results/foh-cli-diag.latest.json --json", description: "collect auth/org/API diagnostics" }

package/package.json

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

package/schemas/foh-template.schema.json

@@ -34,10 +34,61 @@
     "name": { "type": "string", "minLength": 1 },
     "version": { "type": "string", "minLength": 1 },
     "status": { "enum": ["draft", "certification_ready", "published", "deprecated"] },
-    "industry": { "enum": ["real_estate", "general"] },
+    "industry": { "enum": ["real_estate", "restaurant", "general"] },
     "category": { "enum": ["buyer", "seller", "landlord", "tenant", "commercial", "support", "sales", "general"] },
     "use_case": { "type": "string", "minLength": 1 },
     "summary": { "type": "string", "minLength": 1 },
+    "business_blueprint": {
+      "type": "object",
+      "required": [
+        "schema_version",
+        "blueprint_id",
+        "name",
+        "industry",
+        "business_model",
+        "primary_audiences",
+        "supported_objectives",
+        "knowledge_source_types",
+        "default_channels"
+      ],
+      "properties": {
+        "schema_version": { "const": "business_blueprint.v1" },
+        "blueprint_id": { "type": "string", "minLength": 1 },
+        "name": { "type": "string", "minLength": 1 },
+        "industry": { "enum": ["real_estate", "restaurant", "general"] },
+        "business_model": { "type": "string", "minLength": 1 },
+        "primary_audiences": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "supported_objectives": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["id", "label", "outcome"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "label": { "type": "string", "minLength": 1 },
+              "outcome": { "type": "string", "minLength": 1 },
+              "required_fields": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+              "default_tools": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+              "scenario_tags": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            }
+          }
+        },
+        "knowledge_source_types": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "enum": ["website", "document", "manual_text", "crm", "property_feed", "booking_system", "menu"] }
+        },
+        "default_channels": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "enum": ["widget", "voice", "whatsapp", "instagram", "sms"] }
+        },
+        "hard_constraints": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "handoff_triggers": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "evidence_requirements": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
     "channel_support": {
       "type": "array",
       "minItems": 1,