refactor(examples): consolidate 18 example scripts into 4 guides

[mherod]

Summary

This PR consolidates 18 overlapping example scripts into 4 well-organized, comprehensive guides that eliminate redundancy while preserving all best practices and patterns.

Changes

New Consolidated Example Files

• quick-start.sh - Essential patterns for immediate use with reusable shell functions
• curl-integration.sh - Comprehensive curl guide with colored output and reusable functions
• github-auth.sh - Complete GitHub authentication reference with all patterns
• features-demo.sh - All CLI feature demonstrations in one place

Documentation Updates

• Created comprehensive docs/guide/examples.md page
• Updated all documentation to reference new consolidated examples
• Added examples page to VitePress navigation sidebar
• Updated examples/README.md to reflect new structure

Removed Files (14 redundant examples)

• All curl-related duplicates (5 files)
• All GitHub-related duplicates (5 files)
• All feature demo duplicates (4 files)

Additional Fix

• Fixed husky pre-push hook to properly load nvm for Node version management

Benefits

• Reduced redundancy: 18 files → 4 comprehensive guides
• Better organization: Clear categorization by use case
• Preserved best practices: All patterns from original files maintained
• Improved discoverability: Comprehensive examples documentation
• Net reduction: 818 fewer lines while maintaining all functionality

Testing

✅ All pre-commit hooks passed:

• Type checking
• Linting
• Tests (520 passed)
• Link integrity checks
• Formatting

All example scripts are executable and follow consistent style guidelines.

[claude]

PR Review: Example Script Consolidation

Overview

Excellent refactoring! This PR successfully consolidates 18 overlapping example scripts into 4 well-organized comprehensive guides, reducing redundancy by 818 lines while preserving all functionality and best practices. The new structure is significantly more maintainable and user-friendly.

👍 What's Good

1. Outstanding Organization

• Clear categorization by use case (Quick Start, curl Integration, GitHub Auth, Features Demo)
• Logical progression from basic to advanced patterns
• Each consolidated script has a specific, well-defined purpose

2. Comprehensive Documentation

• New docs/guide/examples.md provides excellent navigation and context
• All documentation cross-references updated consistently
• Added to VitePress sidebar for discoverability
• README.md clearly explains the new structure

3. Enhanced Example Quality

• curl-integration.sh: Great use of colored output for readability
• github-auth.sh: Excellent clarification of web vs API authentication (lines 224-245)
• features-demo.sh: Clear demonstrations with actual comparisons
• All scripts maintain executable permissions and consistent style

4. Preservation of Best Practices

• All reusable shell functions preserved (authenticated_curl, validate_cookie, etc.)
• Security considerations maintained (no logging of cookie values)
• Error handling patterns preserved
• All original functionality consolidated appropriately

5. Bonus Fix

• .husky/pre-push now properly loads nvm (lines 1-14) - this is a valuable improvement for Node version management

🔵 Minor Suggestions

1. Link Verification
In docs/guide/examples.md, the GitHub tree links use tree/main:

[examples/quick-start.sh](https://github.com/mherod/get-cookie/tree/main/examples/quick-start.sh)

Consider using blob/main instead for direct file viewing:

[examples/quick-start.sh](https://github.com/mherod/get-cookie/blob/main/examples/quick-start.sh)

2. Shebang Line Missing
The .husky/pre-push file is missing a shebang line. Consider adding:

#!/bin/sh

at the very top for better shell compatibility.

📊 Impact Analysis

Metrics:

• Files reduced: 18 → 4 comprehensive guides (77% reduction)
• Line reduction: 2102 deletions, 1299 additions = 803 net reduction
• All 520 tests passing ✅
• Pre-commit hooks passing ✅
• Link integrity verified ✅

Maintainability Improvements:

• Single source of truth for each use case
• Easier to update patterns across all examples
• Better discoverability through documentation structure
• Reduced cognitive load for new users

Summary

This is a well-executed refactoring that significantly improves the developer experience. The consolidation eliminates redundancy while actually enhancing the quality and comprehensiveness of the examples. The documentation updates ensure users can easily find and use the new structure.

The only suggestions are minor (link format and shebang line) and non-blocking. This PR is ready to merge.

Recommendation: ✅ APPROVE - Ready to merge as-is. Minor suggestions can be addressed in a follow-up if desired.