Merge pull request #84 from cbullinger/quick-fix

Copier App: Support for cross-org copy

Author: cbullinger

examples-copier/QUICK-REFERENCE.md

@@ -410,25 +410,31 @@ gcloud secrets list
 ```
 examples-copier/
 ├── README.md                 # Main documentation
-├── MIGRATION-GUIDE.md        # Migration from legacy
 ├── QUICK-REFERENCE.md        # This file
-├── REFACTORING-SUMMARY.md    # Feature details
 ├── docs/
+│   ├── ARCHITECTURE.md       # Architecture overview
+│   ├── CONFIGURATION-GUIDE.md # Complete config reference
 │   ├── DEPLOYMENT.md         # Deployment guide
-│   └── DEPLOYMENT-CHECKLIST.md  # Deployment checklist
-├── TESTING-SUMMARY.md        # Test documentation
+│   ├── DEPLOYMENT-CHECKLIST.md  # Deployment checklist
+│   ├── FAQ.md                # Frequently asked questions
+│   ├── LOCAL-TESTING.md      # Local testing guide
+│   ├── PATTERN-MATCHING-GUIDE.md # Pattern matching guide
+│   ├── PATTERN-MATCHING-CHEATSHEET.md # Quick pattern reference
+│   ├── TROUBLESHOOTING.md    # Troubleshooting guide
+│   └── WEBHOOK-TESTING.md    # Webhook testing guide
 ├── configs/
 │   ├── .env                  # Environment config
-│   ├── .env.example.new      # Environment template
-│   └── config.example.yaml   # Config template
+│   ├── env.yaml.example      # Environment template
+│   └── copier-config.example.yaml # Config template
 └── cmd/
-    └── config-validator/     # CLI tool
+    ├── config-validator/     # CLI validation tool
+    └── test-webhook/         # Webhook testing tool
 ```
 
 ## Quick Start Checklist
 
 - [ ] Clone repository
-- [ ] Copy `.env.example.new` to `.env`
+- [ ] Copy `configs/.env.local.example` to `configs/.env`
 - [ ] Set required environment variables
 - [ ] Create `copier-config.yaml` in source repo
 - [ ] Validate config: `./config-validator validate -config copier-config.yaml`
@@ -440,6 +446,8 @@ examples-copier/
 ## Support
 
 - **Documentation**: [README.md](README.md)
-- **Migration**: [MIGRATION-GUIDE.md](./docs/MIGRATION-GUIDE.md)
-- **Deployment**: [DEPLOYMENT-GUIDE.md](./docs/DEPLOYMENT-GUIDE.md)
+- **Configuration**: [Configuration Guide](./docs/CONFIGURATION-GUIDE.md)
+- **Deployment**: [Deployment Guide](./docs/DEPLOYMENT.md)
+- **Troubleshooting**: [Troubleshooting Guide](./docs/TROUBLESHOOTING.md)
+- **FAQ**: [Frequently Asked Questions](./docs/FAQ.md)
 

examples-copier/README.md

@@ -48,10 +48,14 @@ go build -o config-validator ./cmd/config-validator
 
 ### Configuration
 
-1. **Copy .env example file**
+1. **Copy environment example file**
 
 ```bash
-cp configs/.env.example.new configs/.env
+# For local development
+cp configs/.env.local.example configs/.env
+
+# Or for YAML-based configuration
+cp configs/env.yaml.example env.yaml
 ```
 
 2. **Set required environment variables**
@@ -387,22 +391,34 @@ COPIER_DEBUG=true ./examples-copier
 examples-copier/
 ├── app.go                    # Main application entry point
 ├── cmd/
-│   └── config-validator/     # CLI validation tool
+│   ├── config-validator/     # CLI validation tool
+│   └── test-webhook/         # Webhook testing tool
 ├── configs/
 │   ├── environment.go        # Environment configuration
-│   ├── .env.example.new      # Environment template
-│   └── config.example.yaml   # Config template
+│   ├── .env.local.example    # Local environment template
+│   ├── env.yaml.example      # YAML environment template
+│   └── copier-config.example.yaml # Config template
 ├── services/
 │   ├── pattern_matcher.go    # Pattern matching engine
 │   ├── config_loader.go      # Config loading & validation
 │   ├── audit_logger.go       # MongoDB audit logging
 │   ├── health_metrics.go     # Health & metrics endpoints
 │   ├── file_state_service.go # Thread-safe state management
 │   ├── service_container.go  # Dependency injection
-│   └── webhook_handler_new.go # New webhook handler
-└── types/
-    ├── config.go             # Configuration types
-    └── types.go              # Core types
+│   ├── webhook_handler_new.go # Webhook handler
+│   ├── github_auth.go        # GitHub authentication
+│   ├── github_read.go        # GitHub read operations
+│   ├── github_write_to_target.go # GitHub write operations
+│   └── slack_notifier.go     # Slack notifications
+├── types/
+│   ├── config.go             # Configuration types
+│   └── types.go              # Core types
+└── docs/
+    ├── ARCHITECTURE.md       # Architecture overview
+    ├── CONFIGURATION-GUIDE.md # Complete config reference
+    ├── DEPLOYMENT.md         # Deployment guide
+    ├── FAQ.md                # Frequently asked questions
+    └── ...                   # Additional documentation
 ```
 
 ### Service Container
@@ -452,9 +468,10 @@ docker run -p 8080:8080 --env-file .env examples-copier
 
 - **[Pattern Matching Cheat Sheet](docs/PATTERN-MATCHING-CHEATSHEET.md)** - Quick pattern syntax reference
 - **[Architecture](docs/ARCHITECTURE.md)** - System design and components
-- **[Migration Guide](docs/MIGRATION-GUIDE.md)** - Migrate from legacy JSON config
 - **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions
 - **[FAQ](docs/FAQ.md)** - Frequently asked questions
+- **[Debug Logging](docs/DEBUG-LOGGING.md)** - Debug logging configuration
+- **[Deprecation Tracking](docs/DEPRECATION-TRACKING-EXPLAINED.md)** - How deprecation tracking works
 
 ### Features
 

examples-copier/app.yaml

@@ -6,3 +6,39 @@ env: flex
 
 includes:
   - env.yaml
+
+# Automatic scaling configuration
+# Keeps at least 1 instance running to avoid cold starts
+automatic_scaling:
+  min_num_instances: 1
+  max_num_instances: 10
+  cool_down_period_sec: 120
+  cpu_utilization:
+    target_utilization: 0.6
+
+# Network configuration
+network:
+  session_affinity: true
+
+# Health check configuration
+# These ensure the app is ready before receiving traffic
+liveness_check:
+  path: "/health"
+  check_interval_sec: 30
+  timeout_sec: 4
+  failure_threshold: 2
+  success_threshold: 2
+
+readiness_check:
+  path: "/health"
+  check_interval_sec: 5
+  timeout_sec: 4
+  failure_threshold: 2
+  success_threshold: 2
+  app_start_timeout_sec: 300
+
+# Resources configuration
+resources:
+  cpu: 1
+  memory_gb: 2
+  disk_size_gb: 10

examples-copier/cmd/config-validator/README.md

@@ -338,8 +338,8 @@ EOF
 
 ## See Also
 
-- [Configuration Setup](../../docs/CONFIG-SETUP.md) - Configuration guide
+- [Configuration Guide](../../docs/CONFIGURATION-GUIDE.md) - Complete configuration reference
 - [Pattern Matching Guide](../../docs/PATTERN-MATCHING-GUIDE.md) - Pattern matching help
-- [Migration Guide](../../docs/MIGRATION-GUIDE.md) - Migrating from JSON
-- [Quick Reference](../../docs/QUICK-REFERENCE.md) - All commands
+- [FAQ](../../docs/FAQ.md) - Frequently asked questions (includes JSON to YAML conversion)
+- [Quick Reference](../../QUICK-REFERENCE.md) - All commands
 

examples-copier/configs/README.md

@@ -8,7 +8,7 @@ Overview of the different environment configuration files and when to use each.
 |-----------------------|---------------------------------------|---------------------------------|
 | `env.yaml.example`    | Complete reference with all variables | First-time setup, documentation |
 | `env.yaml.production` | Production-ready template             | Quick deployment to production  |
-| `.env.example`        | Local development template            | Local testing and development   |
+| `.env.local.example`  | Local development template            | Local testing and development   |
 
 ---
 
@@ -61,9 +61,9 @@ Overview of the different environment configuration files and when to use each.
 
 ---
 
-## .env.example.new
+## .env.local.example
 
-**Location:** `configs/.env.example.new`
+**Location:** `configs/.env.local.example`
 
 **Purpose:** Local development template (traditional .env format)
 
@@ -136,11 +136,11 @@ nano env.yaml  # Enable features you need
 
 ### Scenario 3: Local Development
 
-**Recommended:** `.env.example.new`
+**Recommended:** `.env.local.example`
 
 ```bash
 # Local development
-cp configs/.env.example.new configs/.env
+cp configs/.env.local.example configs/.env
 nano configs/.env  # Add your values
 
 # Run locally
@@ -215,7 +215,7 @@ diff configs/env.yaml.production configs/env.yaml.example
 
 - **Use `env.yaml.production` for quick production deployment**
 - **Use `env.yaml.example` as reference documentation**
-- **Use `.env.example.new` for local development**
+- **Use `.env.local.example` for local development**
 - **Add `env.yaml` and `.env` to `.gitignore`**
 - **Use Secret Manager for production secrets**
 - **Keep comments in your env.yaml for team documentation**
@@ -237,7 +237,7 @@ examples-copier/
 ├── configs/
 │   ├── env.yaml.example          # ← Complete reference (all variables)
 │   ├── env.yaml.production       # ← Production template (essential only)
-│   └── .env.example              # ← Local development template
+│   └── .env.local.example        # ← Local development template
 ├── env.yaml                      # ← Your actual config (gitignored)
 └── .env                          # ← Your local config (gitignored)
 ```
@@ -253,7 +253,7 @@ examples-copier/
 → Read `env.yaml.example`
 
 **Need to develop locally?**
-→ Use `.env.example.new`
+→ Use `.env.local.example`
 
 **Need advanced features?**
 → Start with `env.yaml.example`, customize

examples-copier/docs/ARCHITECTURE.md

@@ -42,7 +42,7 @@ path_transform: "source/code-examples/${lang}/${category}/${file}"
 **Files Created:**
 - `types/config.go` - New configuration types
 - `services/config_loader.go` - Configuration loader with YAML/JSON support
-- `configs/config.example.yaml` - Example YAML configuration
+- `configs/copier-config.example.yaml` - Example YAML configuration
 
 **Capabilities:**
 - Native YAML support with `gopkg.in/yaml.v3`
@@ -190,7 +190,7 @@ Returns detailed metrics:
 
 ```bash
 # Validate configuration
-config-validator validate -config copier-copier-config.yaml -v
+config-validator validate -config copier-config.yaml -v
 
 # Test pattern matching
 config-validator test-pattern \

examples-copier/docs/CONFIGURATION-GUIDE.md

@@ -883,9 +883,10 @@ Error: copy_rules[0]: name is required
 
 - [Pattern Matching Guide](PATTERN-MATCHING-GUIDE.md) - Detailed pattern matching documentation
 - [Pattern Matching Cheat Sheet](PATTERN-MATCHING-CHEATSHEET.md) - Quick reference
-- [Migration Guide](MIGRATION-GUIDE.md) - Migrating from legacy JSON config
+- [FAQ](FAQ.md) - Frequently asked questions (includes JSON to YAML conversion)
 - [Quick Reference](../QUICK-REFERENCE.md) - Command reference
 - [Deployment Guide](DEPLOYMENT.md) - Deploying the application
+- [Architecture](ARCHITECTURE.md) - System architecture overview
 
 ---
 

examples-copier/docs/FAQ.md

@@ -71,7 +71,7 @@ Use the config-validator tool:
 ./config-validator convert -input config.json -output copier-config.yaml
 ```
 
-See [Migration Guide](MIGRATION-GUIDE.md) for details.
+The tool will automatically convert your legacy JSON configuration to the new YAML format while preserving all settings.
 
 ## Pattern Matching
 

examples-copier/docs/LOCAL-TESTING.md

@@ -34,7 +34,7 @@ make run-local-quick
 
 ```bash
 # Copy the local template
-cp configs/.env.local configs/.env
+cp configs/.env.local.example configs/.env
 
 # Edit with your values (optional)
 nano configs/.env