docs: update CLI tool documentation for current config system

- Update config-validator README to clarify it validates workflow configs, not main configs
- Update test-webhook README to remove outdated CONFIG_FILE references
- Update all example commands to reflect current usage
- Add note that main config validation is built into the app

Author: cbullinger

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

@@ -1,11 +1,13 @@
 # config-validator
 
-Command-line tool for validating and testing examples-copier configurations.
+Command-line tool for validating and testing examples-copier workflow configurations.
+
+> **Note:** This tool validates individual workflow config files. It does not validate main config files. Main config validation is built into the application itself.
 
 ## Overview
 
 The `config-validator` tool helps you:
-- Validate configuration files
+- Validate workflow configuration files
 - Test pattern matching
 - Test path transformations
 - Convert legacy JSON configs to YAML
@@ -36,13 +38,13 @@ Validate a configuration file.
 **Examples:**
 
 ```bash
-# Validate YAML config
-./config-validator validate -config copier-config.yaml
+# Validate workflow config
+./config-validator validate -config .copier/workflows/config.yaml
 
 # Validate with verbose output
-./config-validator validate -config copier-config.yaml -v
+./config-validator validate -config .copier/workflows/config.yaml -v
 
-# Validate JSON config
+# Validate legacy JSON config
 ./config-validator validate -config config.json
 ```
 
@@ -192,20 +194,20 @@ Convert legacy JSON configuration to YAML format.
 **Example:**
 
 ```bash
-./config-validator convert -input config.json -output copier-config.yaml
+./config-validator convert -input config.json -output workflow-config.yaml
 ```
 
 **Output:**
 ```
 ✅ Conversion successful!
 
 Converted 2 legacy rules to YAML format.
-Output written to: copier-config.yaml
+Output written to: workflow-config.yaml
 
 Next steps:
-1. Review the generated copier-config.yaml
+1. Review the generated workflow-config.yaml
 2. Enhance with new features (regex patterns, path transforms)
-3. Validate: ./config-validator validate -config copier-config.yaml
+3. Validate: ./config-validator validate -config workflow-config.yaml
 ```
 
 ## Common Use Cases
@@ -250,8 +252,8 @@ When files are copied to wrong locations:
 Before deploying a new configuration:
 
 ```bash
-# Validate the config
-./config-validator validate -config copier-config.yaml -v
+# Validate the workflow config
+./config-validator validate -config .copier/workflows/config.yaml -v
 
 # Test with sample file paths
 ./config-validator test-pattern \
@@ -270,10 +272,10 @@ Before deploying a new configuration:
 
 ```bash
 # Convert
-./config-validator convert -input config.json -output copier-config.yaml
+./config-validator convert -input config.json -output workflow-config.yaml
 
 # Validate
-./config-validator validate -config copier-config.yaml -v
+./config-validator validate -config workflow-config.yaml -v
 
 # Test patterns
 ./config-validator test-pattern \
@@ -304,8 +306,8 @@ Before deploying a new configuration:
 ### Complete Workflow
 
 ```bash
-# 1. Create config
-cat > copier-config.yaml << EOF
+# 1. Create workflow config
+cat > workflow-config.yaml << EOF
 workflows:
   - name: "Copy Go examples"
     source:
@@ -321,7 +323,7 @@ workflows:
 EOF
 
 # 2. Validate
-./config-validator validate -config copier-config.yaml -v
+./config-validator validate -config workflow-config.yaml -v
 
 # 3. Test pattern
 ./config-validator test-pattern \
@@ -338,8 +340,7 @@ EOF
 
 ## See Also
 
-- [Configuration Guide](../../docs/CONFIGURATION-GUIDE.md) - Complete configuration reference
+- [Main Config README](../../configs/copier-config-examples/MAIN-CONFIG-README.md) - Main config documentation
 - [Pattern Matching Guide](../../docs/PATTERN-MATCHING-GUIDE.md) - Pattern matching help
-- [FAQ](../../docs/FAQ.md) - Frequently asked questions (includes JSON to YAML conversion)
-- [Quick Reference](../../QUICK-REFERENCE.md) - All commands
+- [FAQ](../../docs/FAQ.md) - Frequently asked questions
 

examples-copier/cmd/test-webhook/README.md

@@ -108,7 +108,7 @@ Test your configuration locally before deploying:
 
 ```bash
 # 1. Start app in dry-run mode
-DRY_RUN=true CONFIG_FILE=copier-config.yaml make run-local-quick
+DRY_RUN=true make run-local-quick
 
 # 2. In another terminal, send test webhook
 ./test-webhook -payload test-payloads/example-pr-merged.json
@@ -122,8 +122,8 @@ tail -f logs/app.log
 Test if your patterns match real PR files:
 
 ```bash
-# 1. Start app with your config
-CONFIG_FILE=copier-config.yaml make run-local-quick
+# 1. Start app
+make run-local-quick
 
 # 2. Send webhook with real PR data
 export GITHUB_TOKEN=ghp_...
@@ -139,7 +139,7 @@ Verify files are copied to correct locations:
 
 ```bash
 # 1. Start app in dry-run mode
-DRY_RUN=true CONFIG_FILE=copier-config.yaml ./examples-copier &
+DRY_RUN=true ./examples-copier &
 
 # 2. Send test webhook
 ./test-webhook -payload test-payloads/example-pr-merged.json
@@ -155,7 +155,7 @@ Test Slack integration:
 ```bash
 # 1. Start app with Slack enabled
 export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."
-CONFIG_FILE=copier-config.yaml ./examples-copier &
+./examples-copier &
 
 # 2. Send test webhook
 ./test-webhook -payload test-payloads/example-pr-merged.json
@@ -170,7 +170,7 @@ Debug webhook processing:
 ```bash
 # 1. Enable debug logging
 export LOG_LEVEL=debug
-CONFIG_FILE=copier-config.yaml ./examples-copier &
+./examples-copier &
 
 # 2. Send test webhook
 ./test-webhook -payload test-payloads/example-pr-merged.json
@@ -233,29 +233,20 @@ vim test-payloads/my-test.json
 ### Complete Testing Workflow
 
 ```bash
-# 1. Validate configuration
-./config-validator validate -config copier-config.yaml -v
-
-# 2. Test pattern matching
-./config-validator test-pattern \
-  -type regex \
-  -pattern "^examples/(?P<lang>[^/]+)/(?P<file>.+)$" \
-  -file "examples/go/main.go"
-
-# 3. Start app in dry-run mode
-DRY_RUN=true CONFIG_FILE=copier-config.yaml ./examples-copier &
+# 1. Start app in dry-run mode
+DRY_RUN=true ./examples-copier &
 
-# 4. Test with example payload
+# 2. Test with example payload
 ./test-webhook -payload test-payloads/example-pr-merged.json
 
-# 5. Check metrics
+# 3. Check metrics
 curl http://localhost:8080/metrics | jq
 
-# 6. Test with real PR
+# 4. Test with real PR
 export GITHUB_TOKEN=ghp_...
 ./test-webhook -pr 42 -owner myorg -repo myrepo
 
-# 7. Review logs
+# 5. Review logs
 grep "matched" logs/app.log
 ```
 
@@ -353,7 +344,7 @@ cat > run-tests.sh << 'EOF'
 set -e
 
 echo "Starting app..."
-DRY_RUN=true CONFIG_FILE=copier-config.yaml ./examples-copier &
+DRY_RUN=true ./examples-copier &
 APP_PID=$!
 sleep 2
 
@@ -399,7 +390,7 @@ jobs:
       
       - name: Test
         run: |
-          DRY_RUN=true CONFIG_FILE=copier-config.yaml ./examples-copier &
+          DRY_RUN=true ./examples-copier &
           sleep 2
           ./test-webhook -payload test-payloads/example-pr-merged.json
 ```