@f-o-h/cli 0.1.0 → 0.1.2

package/README.md

@@ -4,6 +4,8 @@ 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.2`
+
 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.
 
@@ -20,13 +22,37 @@ npm install -g @f-o-h/cli
 foh --help
 ```
 
+Verify the package version:
+
+```bash
+npx @f-o-h/cli --version
+```
+
 ## First Run
 
 ```bash
+foh auth signup --web
+foh auth login --web
 foh auth login
 foh org list
 foh org use --org <org-id>
 foh setup
 ```
 
+For AI agents and text-only terminals:
+
+```bash
+foh auth signup --web --json
+foh auth login --web --json
+foh auth login --email "$FOH_EMAIL" --password "$FOH_PASSWORD" --json
+foh org list --json
+foh org use --org <org-id> --json
+foh setup --org <org-id> --agent-template <template-id> --agent-name "Demo Agent" --json
+```
+
+`auth signup --web` opens the console signup page when possible and always
+prints the fallback URL. `auth login --web` does the same for sign-in. The CLI
+still requires explicit credential auth until device-code browser-token
+exchange is available.
+
 The CLI defaults to the production API at `https://api.frontofhouse.okii.uk`.

package/dist/foh.js

@@ -10136,7 +10136,121 @@ async function promptSecret(label) {
   });
 }
 
+// src/lib/console-url.ts
+var DEFAULT_FOH_CONSOLE_URL = "https://app.frontofhouse.okii.uk";
+function normalizeBaseUrl(value) {
+  const normalized = String(value ?? "").trim().replace(/\/+$/, "");
+  return normalized || DEFAULT_FOH_CONSOLE_URL;
+}
+function resolveConsoleBaseUrl(cliOverride) {
+  return normalizeBaseUrl(cliOverride ?? process.env.FOH_CONSOLE_URL);
+}
+function buildConsoleSignInUrl(consoleUrl) {
+  return `${normalizeBaseUrl(consoleUrl)}/sign-in?redirect=%2Fdashboard`;
+}
+function buildConsoleSignUpUrl(consoleUrl) {
+  return `${normalizeBaseUrl(consoleUrl)}/sign-up?redirect=%2Fdashboard`;
+}
+function buildCliAuthFallbackCommands() {
+  return [
+    "foh auth login --email <email> --password <password> --json",
+    "foh org list --json",
+    "foh org use --org <org-id> --json"
+  ];
+}
+function buildCliAuthFallbackInstructions(signInUrl) {
+  return {
+    human: [
+      `Open ${signInUrl}`,
+      "Sign in to Front Of House.",
+      "Return to the terminal and authenticate the CLI with email/password until browser-token exchange is available."
+    ],
+    ai_agent: [
+      "Show the sign_in_url to the user if browser opening is unavailable.",
+      "Ask the user for FOH email/password or an approved service-token path.",
+      "Run the explicit CLI auth commands in next_commands.",
+      "Never scrape browser cookies or local storage."
+    ]
+  };
+}
+function buildCliSignupFallbackInstructions(signUpUrl) {
+  return {
+    human: [
+      `Open ${signUpUrl}`,
+      "Create a Front Of House account.",
+      "Confirm your email if prompted.",
+      "Return to the terminal and run `foh auth login --web --json` or credential login."
+    ],
+    ai_agent: [
+      "Show the sign_up_url to the user if browser opening is unavailable.",
+      "Ask the user to complete signup and email confirmation in the browser.",
+      "After the user confirms signup, run `foh auth login --web --json`.",
+      "Never ask the user to paste browser cookies or local storage."
+    ]
+  };
+}
+
+// src/lib/open-url.ts
+var import_child_process = require("child_process");
+function openUrl(url2) {
+  const platform = process.platform;
+  const command = platform === "win32" ? "cmd" : platform === "darwin" ? "open" : "xdg-open";
+  const args = platform === "win32" ? ["/c", "start", "", url2] : [url2];
+  try {
+    const child = (0, import_child_process.spawn)(command, args, {
+      detached: true,
+      stdio: "ignore",
+      shell: false,
+      windowsHide: true
+    });
+    child.unref();
+    return { attempted: true, command };
+  } catch (error2) {
+    return {
+      attempted: false,
+      command,
+      error: error2 instanceof Error ? error2.message : String(error2)
+    };
+  }
+}
+
 // src/commands/auth.ts
+function emitBrowserAuthLink(opts) {
+  const consoleUrl = resolveConsoleBaseUrl(opts.consoleUrl);
+  const signInUrl = buildConsoleSignInUrl(consoleUrl);
+  const openResult = openUrl(signInUrl);
+  const nextCommands = buildCliAuthFallbackCommands();
+  format({
+    status: openResult.attempted ? "browser_auth_link_opened" : "browser_auth_link",
+    sign_in_url: signInUrl,
+    opened: openResult.attempted,
+    opener_command: openResult.command,
+    opener_error: openResult.error ?? null,
+    cli_auth_required: true,
+    note: "Browser sign-in opens the console. Until device-code auth is implemented, authenticate this CLI with the explicit credential command after sign-in.",
+    next_commands: nextCommands,
+    text_fallback: buildCliAuthFallbackInstructions(signInUrl)
+  }, { json: opts.json ?? false });
+}
+function emitBrowserSignupLink(opts) {
+  const consoleUrl = resolveConsoleBaseUrl(opts.consoleUrl);
+  const signUpUrl = buildConsoleSignUpUrl(consoleUrl);
+  const openResult = openUrl(signUpUrl);
+  format({
+    status: openResult.attempted ? "browser_signup_link_opened" : "browser_signup_link",
+    sign_up_url: signUpUrl,
+    opened: openResult.attempted,
+    opener_command: openResult.command,
+    opener_error: openResult.error ?? null,
+    cli_auth_required_after_signup: true,
+    note: "Signup is completed in the FOH console. After account creation and email confirmation, return to the CLI and authenticate.",
+    next_commands: [
+      "foh auth login --web --json",
+      ...buildCliAuthFallbackCommands()
+    ],
+    text_fallback: buildCliSignupFallbackInstructions(signUpUrl)
+  }, { json: opts.json ?? false });
+}
 async function resolveLoginInputs(opts) {
   let email3 = String(opts.email ?? "").trim();
   let password = String(opts.password ?? "").trim();
@@ -10195,7 +10309,14 @@ async function maybeSelectDefaultOrg(orgs, jsonMode) {
 }
 function registerAuth(program3) {
   const auth = program3.command("auth").description("Manage CLI authentication");
-  auth.command("login").description("Authenticate with the FOH API and store a token locally").option("--email <email>", "FOH account email").option("--password <password>", "FOH account password").option("--wizard", "Run guided login wizard prompts").option("--api-url <url>", "Internal API base URL override (operators only)").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
+  auth.command("login").description("Authenticate with the FOH API and store a token locally").option("--email <email>", "FOH account email").option("--password <password>", "FOH account password").option("--web", "Open browser sign-in and print text fallback commands").option("--browser", "Alias for --web").option("--wizard", "Run guided login wizard prompts").option("--console-url <url>", "Console sign-in URL override").option("--api-url <url>", "Internal API base URL override (operators only)").option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
+    if ((opts.web || opts.browser) && !opts.email && !opts.password) {
+      emitBrowserAuthLink({
+        consoleUrl: opts.consoleUrl,
+        json: opts.json
+      });
+      return;
+    }
     const apiUrl = resolveApiBaseUrl(opts.apiUrl);
     const login = await resolveLoginInputs({
       email: opts.email,
@@ -10264,6 +10385,12 @@ function registerAuth(program3) {
     }
     format(output, { json: opts.json ?? false });
   }));
+  auth.command("signup").description("Open account signup and print text fallback commands").option("--web", "Open browser signup and print text fallback commands", true).option("--browser", "Alias for --web").option("--console-url <url>", "Console signup URL override").option("--json", "Output as JSON").action((opts) => {
+    emitBrowserSignupLink({
+      consoleUrl: opts.consoleUrl,
+      json: opts.json
+    });
+  });
   auth.command("logout").description("Remove stored credentials").option("--json", "Output as JSON").action((opts) => {
     clearCredentials();
     format({ status: "logged_out" }, { json: opts.json ?? false });
@@ -32101,7 +32228,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.0";
+var CLI_VERSION = "0.1.2";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -33606,8 +33733,53 @@ function timedStepResult(result, startedAtIso, startedAtMs) {
     duration_ms: Math.max(0, Date.now() - startedAtMs)
   };
 }
+function optionNameToFlag(key) {
+  return "--" + key.replace(/([A-Z])/g, "-$1").toLowerCase();
+}
+function buildMissingOptionsPlan(missing, opts) {
+  const missingFlags = missing.map(optionNameToFlag);
+  const signInUrl = buildConsoleSignInUrl(resolveConsoleBaseUrl(opts.consoleUrl));
+  return {
+    status: "blocked",
+    code: "setup_required_options_missing",
+    missing_options: missingFlags,
+    reason: "setup requires an authenticated org, an agent template, and an agent name before it can mutate customer resources",
+    sign_in_url: signInUrl,
+    next_commands: [
+      "foh auth signup --web --json",
+      "foh auth login --web --json",
+      ...buildCliAuthFallbackCommands(),
+      "foh templates list --json",
+      'foh setup --org <org-id> --agent-template <template-id> --agent-name "Demo Agent" --widget-domains <domain> --report-out setup-report.json --json'
+    ],
+    text_fallback: buildCliAuthFallbackInstructions(signInUrl),
+    ai_agent_instruction: [
+      "Do not guess org IDs, template IDs, or customer domains.",
+      "If no browser is available, print sign_in_url and ask the user to sign in.",
+      "After auth, discover orgs and templates with the listed commands.",
+      "Rerun setup only after all missing_options are resolved."
+    ]
+  };
+}
+function emitMissingOptionsPlan(missing, opts) {
+  const plan = buildMissingOptionsPlan(missing, { consoleUrl: opts.consoleUrl });
+  if (resolveJsonMode({ json: opts.json })) {
+    format(plan, { json: true });
+    return;
+  }
+  const flags = missing.map(optionNameToFlag).join(", ");
+  process.stderr.write(`error: required options missing: ${flags}
+`);
+  process.stderr.write(`  Sign in: ${plan.sign_in_url}
+`);
+  process.stderr.write("  Remediation:\n");
+  for (const command of plan.next_commands) {
+    process.stderr.write(`    ${command}
+`);
+  }
+}
 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("--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("--json", "Output as JSON").action(async (opts) => {
+  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("--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.org) {
       try {
         opts.org = loadCredentials(opts.apiUrl).orgId;
@@ -33616,12 +33788,7 @@ function registerSetup(program3) {
     }
     const missing = ["org", "agentTemplate", "agentName"].filter((key) => !opts[key]);
     if (missing.length) {
-      const flags = missing.map((key) => "--" + key.replace(/([A-Z])/g, "-$1").toLowerCase()).join(", ");
-      process.stderr.write(`error: required options missing: ${flags}
-`);
-      if (missing.includes("org")) {
-        process.stderr.write("  Remediation: Run: foh org use --org <id>  to set a default, or pass --org <id>\n");
-      }
+      emitMissingOptionsPlan(missing, { json: opts.json, consoleUrl: opts.consoleUrl });
       markCommandFailed(1);
       return;
     }
@@ -35775,7 +35942,7 @@ function getHomeQuickActions(state) {
 }
 
 // src/commands/home-interaction.ts
-var import_child_process = require("child_process");
+var import_child_process2 = require("child_process");
 var import_readline2 = require("readline");
 
 // src/tui/keypress.ts
@@ -35830,7 +35997,7 @@ async function runSelf(args, apiUrlOverride) {
     spawnArgs.push("--api-url", apiUrlOverride);
   }
   return await new Promise((resolve5, reject) => {
-    const child = (0, import_child_process.spawn)(process.execPath, [process.argv[1], ...spawnArgs], {
+    const child = (0, import_child_process2.spawn)(process.execPath, [process.argv[1], ...spawnArgs], {
       stdio: "inherit",
       env: {
         ...process.env,
@@ -36131,7 +36298,7 @@ function maybeDefaultToHome(argv = process.argv) {
 // src/lib/update.ts
 var import_fs6 = require("fs");
 var import_path5 = require("path");
-var import_child_process2 = require("child_process");
+var import_child_process3 = require("child_process");
 var import_crypto5 = require("crypto");
 function parseSemver(version2) {
   const trimmed = String(version2 ?? "").trim();
@@ -36218,7 +36385,7 @@ async function applyRepoUpdate(repoRoot) {
   const scriptPath = (0, import_path5.join)(repoRoot, "scripts", "Install-FohCli.ps1");
   if (process.platform === "win32") {
     return await new Promise((resolve5, reject) => {
-      const child = (0, import_child_process2.spawn)(
+      const child = (0, import_child_process3.spawn)(
         "powershell",
         ["-ExecutionPolicy", "Bypass", "-File", scriptPath],
         { stdio: "inherit" }
@@ -36228,7 +36395,7 @@ async function applyRepoUpdate(repoRoot) {
     });
   }
   return await new Promise((resolve5, reject) => {
-    const child = (0, import_child_process2.spawn)(
+    const child = (0, import_child_process3.spawn)(
       "corepack",
       ["pnpm", "cli:install:global"],
       {

package/package.json

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