Copilot AI left a comment

Optimizes cross-endpoint communication by skipping State Manager queries
for local-only endpoints and injecting API keys only when needed.
- ServiceRegistry checks makes_remote_calls to skip unnecessary queries
- ServerlessResource injects RUNPOD_API_KEY for QB endpoints at deploy time
- Added comprehensive API key management documentation

Strip -fb suffix and live- prefix from resource names when looking up
configuration in manifest to ensure resources with these naming patterns
are properly matched.

...mmands
Add three new documentation files following established patterns:
- flash-deploy.md: Build and deploy workflow, environment resolution,
 post-deployment guidance, preview mode, and troubleshooting
- flash-env.md: Environment management (list/create/get/delete),
 lifecycle, common workflows, and best practices
- flash-app.md: App management (list/create/get/delete), hierarchy,
 organization strategies, and relationship to environments
All docs include:
- Usage syntax and options
- Real command-line examples with output
- Conceptual explanations
- Troubleshooting sections
- Cross-references to related commands
Total: 47KB of new user-facing documentation

Add comprehensive sections for previously undocumented commands:
- flash deploy: Build and deploy in one step, with all options and examples
- flash env: Environment management subcommands (list/create/get/delete)
- flash app: App management subcommands (list/create/get/delete)
Each section includes:
- Usage syntax
- Key options
- Practical examples
- Link to full documentation page
Commands now follow logical workflow order:
init → run → build → deploy → env → app → undeploy

Add prominent CLI Reference section before "Key concepts" with:
- Overview of all main commands (init, run, build, deploy)
- Management commands (env, app, undeploy)
- Quick examples showing common workflows
- Links to complete CLI documentation
- Individual command reference links
Also enhanced existing sections:
- Added CLI documentation link in "Create Flash API endpoints"
- Added flash run documentation link in "Step 5"
- Updated Table of Contents to include CLI Reference
Makes CLI capabilities more discoverable for new users while
providing clear path to comprehensive documentation.

flash-build.md:
- Updated "Next Steps" with links to deploy and env commands
- Enhanced "Related Commands" with bidirectional links to new docs
Flash_Deploy_Guide.md:
- Added prominent note at top distinguishing architectural guide
 from user-facing CLI documentation
- Links to flash deploy, flash env, and complete CLI docs
Ensures users can easily navigate between:
- Architectural implementation details (Deploy Guide)
- User-facing command references (CLI docs)
- Related commands within CLI documentation

Document the completed work on this branch:
- Purpose: Update CLI documentation for new commands
- Status: All documentation created and cross-referenced
- Files added: flash-deploy.md, flash-env.md, flash-app.md
- Files updated: CLI README, main README, cross-references
Provides context for future work and Claude Code assistance.

Addresses critical and important issues from PR review:
Critical Fixes:
- Remove CLAUDE.md template file from PR (worktree-specific, not for main)
- Replace "comprehensive" with "complete" (CLAUDE.md style compliance)
- Remove emoji from CLI documentation link
Important Fixes:
- Remove duplicated "Environment:" label in flash-env.md output examples
- Remove redundant example block in flash-app.md (flash app list)
- Remove "Examples with Real Output" sections (duplicated content)
- Remove incorrect LiveServerless SDK example (no 'url' parameter)
- Add note explaining why flash app delete requires --app flag
These changes improve documentation quality, reduce maintenance burden,
and ensure compliance with project style guidelines.