feat: Add agent-friendly features and theme inheritance proposal

[mikel]

Summary

This PR implements agent-friendly features for the StoreConnect Go CLI and includes a comprehensive proposal for theme inheritance and content change workflow improvements.

Milestones Completed

✅ Milestone 1: JSON Output & Exit Codes

• Added --json flag for machine-readable output on all commands
• Implemented 9 semantic exit codes (0-8) for different error types
• Structured JSON responses with helpful error suggestions
• 100% backward compatible with existing human-friendly output

New Files:

• internal/commands/exit_codes.go - Exit code constants
• internal/commands/responses.go - JSON response types
• internal/commands/output.go - Output handlers

✅ Milestone 2: Non-Interactive Mode

• Added --non-interactive flag for CI/CD environments
• Added --yes/-y flag for auto-confirming prompts
• Added --dry-run flag for safe testing
• Environment variable support: SC_ORG_ID, SC_STORE_ID, SC_API_KEY
• Clear error messages when required input is missing

New Files:

• internal/commands/input.go - Credential input helpers
• internal/commands/input_test.go - Test coverage (15 test cases)

✅ Milestone 4: Self-Documenting Help System

• JSON help output with sc help <command> --json
• Complete flag documentation
• Exit codes reference
• Subcommand discovery

New Files:

• internal/commands/help.go - JSON help system

📋 Theme Inheritance & Content Change Proposal

Added comprehensive proposal document THEME_AND_CHANGE_SETS.md (1207 lines) addressing:

1. Security Fix: Prevent CLI from bypassing Salesforce approval workflow
2. Content Change Sessions: Group multiple edits into draft → submitted → approved → published workflow
3. Theme Inheritance: parent_theme_id system for easier version upgrades
4. Base Theme Installation: Post-install script to create "Base Theme v21" in Salesforce
5. 5-Phase Implementation Plan: Detailed roadmap for implementation (Weeks 1-6)

Test Coverage

All tests passing ✅

Package                  Coverage
-----------------------------------------
internal/api             62.2%
internal/commands        7.0%  (new tests added)
internal/config          66.7%
internal/theme           86.0%
internal/ui              33.3%
internal/utils           96.8%
internal/validators      100.0%

CI/CD Integration Examples

GitHub Actions

- name: Deploy theme
  env:
    SC_ORG_ID: ${{ secrets.SC_ORG_ID }}
    SC_STORE_ID: ${{ secrets.SC_STORE_ID }}
    SC_API_KEY: ${{ secrets.SC_API_KEY }}
  run: |
    sc theme push production-theme --non-interactive --yes --json

Usage Examples

# JSON output for agents
sc theme list --json | jq -r '.data.themes[].name'

# Exit code handling
sc status --json
echo $?  # 0=success, 8=config error, etc.

# Non-interactive CI/CD
export SC_ORG_ID=00D... SC_STORE_ID=a0A... SC_API_KEY=...
sc connect https://prod.mystore.com --alias prod --non-interactive

# Auto-confirm dangerous operations
sc theme publish my-theme --yes

Documentation

• MILESTONES_COMPLETE.md - Comprehensive summary of completed work
• THEME_AND_CHANGE_SETS.md - Detailed proposal for theme inheritance and security improvements
• CLAUDE.md - Updated with Milestone 1, 2, and 4 details

Breaking Changes

None. All changes are fully backward compatible.

🤖 Generated with Claude Code