release: prepare Agora CLI v0.2.9

[digitallysavvy]

Prepare Agora CLI v0.2.9 with consistent quickstart environment setup, official recipe-backed initialization, explicit project selection, Android onboarding, Windows installer compatibility, dependency maintenance, and expanded test coverage.

This release rollup incorporates #57, #58, #59, #60, #61, and #62, and adds official recipe discovery and initialization.

Changes

• Add official recipe discovery with agora recipes list/show.
• Add agora init --recipe <slug> as a second initialization source alongside built-in quickstarts.
• Resolve versioned recipe detail metadata before project creation and use the API-provided cli.env contract without guessing paths or credential keys.
• Record recipe provenance in .agora/project.json and expose recipe discovery and initialization through MCP and introspection.
• Add the Android conversational AI client/server quickstart to agora init and agora quickstart.
• Write Python and Go credentials to server/.env using AGORA_APP_ID and AGORA_APP_CERTIFICATE.
• Remove generation of unsupported APP_ID and APP_CERTIFICATE names.
• Add quickstart create --template-only for explicit clone-only workflows.
• Prompt interactive users to select a project when no project context resolves.
• Return QUICKSTART_PROJECT_REQUIRED before cloning in JSON, CI, non-TTY, and --yes workflows without a project.
• Expose template-only quickstart creation through MCP.
• Add PowerShell 7 detection and actionable execution-policy guidance.
• Upgrade the Go toolchain to 1.26.6 to resolve reachable standard-library vulnerabilities.
• Upgrade actions/setup-node and actions/setup-go to v7.
• Expand quickstart, recipe, environment, project-resolution, and automation documentation.
• Prepare the changelog and command reference for v0.2.9.

CLI behavior

Before v0.2.9, agora init did not accept recipes:

$ agora init recipe-smoke --recipe tool-calling
# --recipe was not supported

With v0.2.9, users can discover an official recipe and initialize it directly:

$ agora recipes list --type ai
$ agora recipes show tool-calling
$ agora init recipe-smoke \
    --recipe tool-calling \
    --project Testing \
    --dir /tmp/agora-recipe-smoke \
    --json

Representative result fields:

{
  "ok": true,
  "command": "init",
  "data": {
    "sourceType": "recipe",
    "recipe": "tool-calling",
    "projectAction": "existing",
    "envPath": "server/.env.local",
    "envStatus": "created",
    "status": "ready"
  }
}

For quickstarts without a resolvable project, clone-only behavior is now explicit:

# Before: silently cloned without binding an Agora project.
$ agora quickstart create python --yes

# After: select/provide a project, or request clone-only behavior explicitly.
$ agora quickstart create python --template-only

Testing

• go test ./...
• go vet ./...
• make lint
• Overall statement coverage: 74.9%
• internal/cli statement coverage: 74.9%
• cmd/gendocs statement coverage: 93.9%
• Production recipe API smoke tests for all, ai, and rtc filtering, official-only results, detail metadata, and non-official 404 behavior
• Production CLI smoke tests for agora recipes list/show
• End-to-end agora init --recipe tool-calling using an existing test project

The end-to-end recipe smoke test confirmed project reuse, recipe resolution, repository cloning, upstream .git removal, API-defined server/.env.local creation, and recipe provenance in .agora/project.json.

Coverage includes public CLI behavior for:

• Quickstart, recipe, and init workflows
• Project and webhook commands
• Config, telemetry, logout, and completion commands
• Install doctor success and failure states
• Upgrade checks, downloads, checksums, and archive extraction
• Command-reference generation

Rollout status

The upstream quickstart migrations are complete:

• fix: align python quickstart environment setup AgoraIO-Conversational-AI/agent-quickstart-python#26 is merged.
• fix: align go quickstart environment setup AgoraIO-Conversational-AI/agent-quickstart-go#8 is merged.

The official recipes API is merged and deployed:

• feat(recipes): add official recipe API and CLI setup metadata AgoraIO-Community/agora-recipes#35 is merged and deployed.
• https://recipes.agora.io/api/v1 returns schema version 1 with 48 official recipes: 33 AI and 15 RTC.
• The API exposes only official recipes; non-official recipe detail requests return RECIPE_NOT_FOUND.
• Official recipes without cli.env remain discoverable and return RECIPE_INIT_UNSUPPORTED; their implementation repositories will be updated separately to support initialization.

Compatibility notes

• agora quickstart create no longer silently performs a clone-only workflow when no project resolves. Use --template-only explicitly, select a project interactively, or provide --project for deterministic automation.
• In non-interactive agora init runs, pass exactly one of --template or --recipe. Omitting the initialization source returns INIT_SOURCE_REQUIRED, replacing the template-specific QUICKSTART_TEMPLATE_REQUIRED error.