Initial commit

skills/prow-job-extract-must-gather/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to the Prow Job Extract Must-Gather skill will be documented in this file.
+
+## [1.0.0] - 2025-01-17
+
+### Added
+- Initial release of Prow Job Extract Must-Gather skill
+- Command file: `plugins/prow-job/commands/extract-must-gather.md`
+- Comprehensive SKILL.md with detailed implementation instructions
+- `extract_archives.py` script for recursive archive extraction
+  - Extracts must-gather.tar to specified directory
+  - Renames long "-ci-" containing subdirectory to "content/"
+  - Recursively processes nested .tar.gz, .tgz, and .gz archives
+  - Removes original compressed files after extraction
+  - Handles up to 10 levels of nesting
+  - Reports extraction statistics
+- `generate_html_report.py` script for HTML file browser generation
+  - Scans directory tree and collects file metadata
+  - Classifies files by type (log, yaml, json, xml, cert, archive, script, config, other)
+  - Generates interactive HTML with dark theme matching analyze-resource skill
+  - Multi-select file type filters
+  - Regex pattern filter for powerful file searches
+  - Text search for file names and paths
+  - Direct links to files with relative paths
+  - Statistics dashboard showing file counts and sizes
+  - Scroll to top button
+- Comprehensive README.md documentation
+- Working directory structure: `.work/prow-job-extract-must-gather/{build_id}/`
+- Subdirectory organization: `logs/` for extracted content, `tmp/` for temporary files
+- Same URL parsing logic as analyze-resource skill
+- Support for caching extracted content (ask user before re-extracting)
+- Error handling for corrupted archives, missing files, and invalid URLs
+- Progress indicators for all long-running operations
+- Platform-aware browser opening (xdg-open, open, start)
+
+### Features
+- **Automatic Archive Extraction**: Handles all nested archive formats automatically
+- **Directory Renaming**: Shortens long subdirectory names for better usability
+- **Interactive File Browser**: Modern HTML interface with powerful filtering
+- **Regex Pattern Matching**: Search files using full regex syntax
+- **File Type Classification**: Automatic detection and categorization of file types
+- **Relative File Links**: Click to open files directly from HTML browser
+- **Statistics Dashboard**: Visual overview of extracted content
+- **Extraction Caching**: Avoid re-extracting by reusing cached content
+- **Error Recovery**: Continue processing despite individual archive failures
+
+### Technical Details
+- Python 3 scripts using standard library (tarfile, gzip, os, pathlib)
+- No external dependencies required
+- Memory-efficient incremental processing
+- Follows same patterns as analyze-resource skill
+- Integrated with Claude Code permissions system
+- Uses `.work/` directory (already in .gitignore)