Front Of House public developer docs

- README.md: public docs landing page
- guides/partner-quickstart.md: core public quickstart for API and webhook integrations
- guides/agent-testing.md: shortest path for external coding agents to self-serve setup and testing
- guides/choose-your-mission.md: canonical mission-first onboarding router
- guides/cli-install-and-upgrade.md: deterministic CLI installation and update flow
- guides/start-by-goal.md: role-based route selector for inbound voice, web widget, tool/webhook, and WhatsApp channel builders
- guides/any-agency-setup-workflow.md: objective-first business setup workflow for AI agents using the public CLI and public docs only; restaurant table booking and estate-agency workflows are the proven example verticals
- guides/end-to-end-recipes.md: deterministic command recipes for voice, widget, tool/webhook, external reply, and WhatsApp setup/proof flows
- guides/troubleshooting-decision-trees.md: fail-closed diagnostic trees for auth, signature, delivery, retries, and WhatsApp setup/proof
- guides/environment-and-release-promotion.md: release promotion and rollback semantics
- guides/auth-key-rotation.md: zero-downtime key rotation strategy
- guides/prompt-and-persona-cookbook.md: production prompt/persona patterns and anti-patterns
- guides/telephony-advanced-twilio.md: advanced telephony routing tradeoffs and cautions
- guides/widget-production-deploy.md: widget deployment and smoke checks
- guides/integration-playbooks.md: deterministic multi-system integration playbooks
- guides/tool-runbooks-sales-crm-support.md: runbook-level tool automation sequences
- guides/testing-strategy-and-modes.md: smoke/deterministic/adversarial/external-agent test model
- guides/testing-scenario-library.md: reusable scenario set guidance
- guides/ci-eval-recipes.md: CI execution recipes for docs and external-agent gates
- guides/operator-troubleshooting-runbook.md: deploy-time and infrastructure troubleshooting
- guides/session-initialization-and-preflight.md: deterministic first-turn and preflight contract
- guides/telephony-byoc-interop.md: managed vs advanced vs SIP telephony contract
- guides/scheduled-evals-and-notifications.md: nightly/cron eval operations and alerting
- guides/cli-artifact-verification.md: CLI artifact checksum/signature trust policy
- reference/integration-catalog.md: provider and runtime integration matrix
- reference/provider-capability-matrix.md: provider capability and maturity matrix
- reference/realtime-transport-contract.md: channel transport and failure semantics
- reference/runtime-trace-contract.md: canonical event taxonomy and trace timing semantics
- reference/realtime-session-bootstrap-contract.md: realtime token and environment bootstrap lifecycle
- reference/mcp-provider-contract.md: hosted MCP/tool provider behavior and fallback contract
- reference/compatibility-and-limitations.md: explicit supported vs limited surfaces
- reference/agent-consumption-contract.md: strict AI-agent execution contract
- reference/testing-scenario-spec-v1.md: testing scenario schema contract
- reference/enterprise-trust.md: uptime and incident evidence standards
- reference/partner-api-versioning.md: contract stability and deprecation rules
- reference/partner-api-changelog.md: published partner API changes
- openapi/partner-openapi.yaml: canonical public OpenAPI contract

Rules for AI agents:

- If starting from the landing domain, read `https://frontofhouse.okii.uk/llms.txt`, then fetch `https://frontofhouse.okii.uk/openapi.yaml`.
- Do not assume access to the private Front Of House monorepo. Install the CLI from the public npm package path in `guides/cli-install-and-upgrade.md`.
- The public CLI release mirror is `https://github.com/iiko38/front-of-house-cli`; use it for source/package transparency, not as the primary install path.
- If auth is needed and no credentials are configured, first offer signup with `npx @f-o-h/cli auth signup --web --json`. If the user already has an account, run `npx @f-o-h/cli auth login --web --json`, let the browser approval complete, then continue with the authenticated CLI session. Do not scrape browser cookies or local storage.
- If `npx @f-o-h/cli setup --json` returns `setup_required_options_missing`, follow its `next_commands` instead of guessing org/template values.
- Treat `openapi/partner-openapi.yaml` as the canonical API contract.
- Treat `reference/partner-api-versioning.md` as the contract-stability policy.
- Start from `guides/choose-your-mission.md` and then execute `guides/end-to-end-recipes.md`.
- For business setup from public sources, start with `guides/any-agency-setup-workflow.md` and run `npx --yes @f-o-h/cli@latest setup --objective "<front-of-house outcome>" --business-name <name> --industry <real_estate|restaurant> --source-url <url> --json`. Use `--industry restaurant` for table bookings and `--industry real_estate` for property enquiries/viewings.
- For WhatsApp, use `guides/end-to-end-recipes.md#recipe-5-whatsapp-channel-setup-and-proof` and preserve the sender model: Meta test numbers are sandbox-only; production senders are verified WhatsApp Business phone numbers.
- For WhatsApp proof failures, use `guides/troubleshooting-decision-trees.md#tree-5-whatsapp-channel-setup-and-proof-failures` before escalating.
- Use `guides/troubleshooting-decision-trees.md` before escalating failures.
- Follow `reference/agent-consumption-contract.md` for deterministic execution order.
- Use `guides/session-initialization-and-preflight.md` and `reference/realtime-session-bootstrap-contract.md` for first-turn runtime debugging.
- Use `reference/testing-scenario-spec-v1.md` for repeatable test scenarios.
- Prefer the SDK path first, direct HTTP second, unpublished internal routes never.
- Do not assume internal console workflows or private runbooks are available.
- If a workflow requires information not present in these public docs, surface the gap as a docs bug.