…k.yml

Improved the docs-preview-link workflow with comprehensive GitHub Actions best practices including:
- Enhanced security controls with proper environment configuration
- Better image detection and tracking for docs PRs
- Cross-platform compatibility for file operations
- Advanced git configuration for performance
- Content-based caching for better efficiency
- Document structure analysis for better context
- Improved error handling and self-validation
- Standardized metrics reporting
- Enhanced artifact handling for cross-job communication

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Created a reusable composite action for documentation analysis that can be used across any docs-related workflows. The action:

- Only runs on files in docs/ directory or markdown files
- Provides robust metrics for documentation changes
- Tracks image changes with better reporting
- Generates document structure analysis
- Identifies the most significant changes
- Returns standardized outputs with comprehensive metrics

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Enhanced the docs-analysis composite action with several GitHub Actions best practices:
- Added input validation to prevent command injection
- Implemented path sanitization for safer file operations
- Created retry logic for git operations to handle rate limiting
- Enhanced cross-platform compatibility with fallbacks
- Added repository size detection with adaptive throttling
- Implemented Python integration for safer JSON handling
- Added execution time tracking and performance metrics
- Created comprehensive documentation with examples

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Replace manual docs analysis with composite action in docs-preview-link
- Add missing output fields to docs-analysis action
- Update variable references in workflow to use composite outputs
- Add integration guide for documentation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Implement strict whitelist input validation for branch references
- Add path traversal detection to sanitize_path function
- Replace eval with direct command execution in git_with_retry
- Add error tracing with line numbers for better debugging
- Add performance monitoring and metrics generation
- Update README with security enhancements

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Update workflow description to mention security features
- Add throttling and performance parameters to docs-analysis
- Add detailed image metrics to job summary
- Add most changed file information to reports
- Add performance metrics section to job summary
- Add execution time reporting from composite action

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Fixed Python code in analyze_docs.py to use external script
- Improved error handling when script isn't found
- Added proper fallback mechanism for Python-based analysis
- Fixed command injection vulnerabilities in analyze_docs.py for better security

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Add external Python script for document structure analysis
- Improves maintainability by separating Python code from YAML
- Handles document heading counts and title extraction
- Includes error handling for corrupted files

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Change 'timing' id to 'execution_timing' to avoid duplicate IDs
- Update references to the step ID throughout the action
- Fix value reference in outputs section for execution-time

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Change from whitelist to blacklist validation approach
- Allow more characters commonly used in branch names
- Still maintain protection against command injection
- Block only potentially dangerous characters

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Replace regex pattern with simple string comparisons
- Check for specific unsafe shell characters individually
- Provide more explicit validation for shell injection characters
- Fix syntax error in conditional expression

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Correctly using  syntax instead of  in Markdown links within Bash here-documents to ensure proper variable expansion.

Uses SHA-pinned reference to force GitHub Actions to fetch the latest version of the custom action, preventing cache issues.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

- Replace composite action with inline Bash steps
- Simplify file analysis algorithm to avoid dependency on accurate git
history
- Fix error with document structure analysis

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: EdwardAngert <[email protected]>
Co-authored-by: Claude <[email protected]>