v1.222.0-rc.11

feat(emulator): local cloud emulators + emulator-based advanced quick-start & docs example drawer Erik Osterman (Cloud Posse) (@osterman) (#2647)

## what

Emulator feature — run cloud-service emulators locally as first-class Atmos components:

• emulator component kind + driver registry (pkg/emulator): the EmulatorDriver interface, ResolveDriver/Drivers, Endpoint/Profile types, the built-in AWS Floci driver, and the AWS target-profile builder (dummy creds, AWS_ENDPOINT_URL, and the Terraform provider behavior flags env can't set).
• atmos emulator CLI (cmd/emulator): lifecycle verbs (up/down/reset/list/…), flags, and shell completions.
• Auth/identity binding so in-process AWS and Terraform both reach the emulator (pkg/auth, pkg/component, internal/exec); generic provider-config contribution (pkg/generator).
• Design captured as three PRDs: docs/prd/emulators.md, docs/prd/kubernetes-identity.md, docs/prd/provider-config-contributor.md.
• Examples + E2E: examples/emulator-aws, examples/demo-floci, and the floci/acceptance jobs.
• Changelog: website/blog/2026-06-22-emulator-persistence.mdx.

Emulator-based advanced quick-start — rewrote the advanced tutorial to deploy a real event-driven AWS backend (KMS key, encrypted S3 bucket, DynamoDB table, SNS topic, SQS queue, SSM Parameter Store config) entirely on your laptop, with no AWS account and no credentials, via the emulator. New backing example examples/quick-start-advanced (replaces the old VPC-based one).

Docs UI — a right-side [Example] drawer that follows each quickstart page and shows the page's backing example files (QuickStartExampleDrawer, wired through theme/DocItem/Content + theme/Root, reading the file-browser plugin's global data). Plus restyled File, Terminal, KeyPoints ("You will learn"), KeyTakeaways, EmbedExample, and ActionCard components, a CodeBlock line-numbers toggle, and supporting theme/CSS overrides.

why

• Emulators let contributors and CI run the full Atmos workflow — auth, secrets, vendoring, toolchain, Terraform apply — against local cloud emulators, the same on a laptop and in CI, with no cloud credentials. That makes the advanced tutorial runnable by anyone and gives fast, hermetic local iteration.
• The example drawer and component restyle let each tutorial page show its backing example inline, so readers can follow the docs and the code side by side.

references

• Stacked on osterman/container-component-type (reuses its persistent container lifecycle via ComponentType: "emulator").
• See docs/prd/emulators.md for the full design and per-step implementation sequence.

Fix bare command docs links Erik Osterman (Cloud Posse) (@osterman) (#2660)

## what

• Adds explicit redirects from bare command overview routes for auth, ai, and toolchain to their canonical /usage pages.
• Updates announcement and feature-card links to point directly at the canonical command overview URLs.

why

• Prevents users from hitting 404s when following bare command docs links like /cli/commands/auth.
• Keeps existing /usage command overview URLs canonical without changing valid bare command routes such as workflow, devcontainer, and ci.

references

• Reported from https://atmos.tools/cli/commands/auth returning 404.
• Validated with cd website && npm run build.

Summary by CodeRabbit

• Bug Fixes
  • Updated several CLI-related documentation and announcement links to point to the correct usage pages.
  • Added automatic redirects from older command overview URLs to the new usage pages, reducing broken or outdated links.