# Chromium Helper - TODO & Future Enhancements
## 🚧 In Progress
- [x] Enhanced issue search with metadata (v1.5.6)
- [ ] Gitiles blame/history commands (v1.5.7)
## 🎯 High Priority - Quick Wins
### 1. Blame/History Commands ⭐ IN PROGRESS (v1.5.7)
Git history and contribution tracking using Gitiles API
- `ch blame <file> [--line <num>]` - Git blame for a file
- `ch history <file> [--limit 10]` - File change history
- `ch contributors <path>` - Top contributors to a path
- `ch file-age <pattern>` - Find oldest/newest files matching pattern
**Value**: Code evolution, expert finding, technical debt tracking
**Difficulty**: Easy (uses existing Gitiles API)
### 2. Improve Issue Search Data Parsing
Fix existing functionality that's not working correctly
- View counts showing 0 - find correct position in protobuf array
- Status codes like "Status15" - enhance status mapping dictionary
- CL detection not working - improve field parsing logic
- Type mapping - add more accurate type codes
**Value**: Fixes v1.5.6 features to work correctly
**Difficulty**: Medium (requires Chrome DevTools MCP analysis)
### 3. Test Discovery Commands
Help developers find and understand tests
- `ch test-find <file>` - Find tests for a source file
- `ch test-coverage <path>` - Test coverage for path
- `ch test-history <test-name>` - Test flakiness history
**Value**: Test discovery, coverage gaps, flaky test identification
**Difficulty**: Easy-Medium (uses search + pattern matching)
### 4. Code Review Helper
Improve code review workflow
- `ch suggest-reviewers <files...>` - Suggest reviewers (OWNERS + git history)
- `ch similar-cls <cl-id>` - Find similar CLs for reference
- `ch cl-impact <cl-id>` - Estimate impact (files touched, LOC)
**Value**: Better code reviews, finding examples
**Difficulty**: Medium (combines existing data cleverly)
## 🔥 High Impact Features
### 5. Dependency Analysis
Understand code relationships and architecture
- `ch deps <file>` - Show file dependencies (includes)
- `ch reverse-deps <file>` - What files depend on this one
- `ch deps-graph <file> [--depth 2]` - Visualize dependency tree
- `ch circular-deps [path]` - Find circular dependencies
**Value**: Refactoring, architecture understanding, breaking up monoliths
**Difficulty**: Medium-Hard (requires include parsing)
### 6. Code Metrics
Identify risky code and technical debt
- `ch metrics <path>` - LOC, complexity, file count
- `ch complexity <file>` - Cyclomatic complexity analysis
- `ch churn <path> [--since 2024-01-01]` - Most frequently changed files
- `ch hotspots [path]` - Files with most bugs/changes
**Value**: Technical debt, risky code identification
**Difficulty**: Medium-Hard (requires code analysis)
### 7. Component/Feature Analysis
Deep-dive into Chromium components
- `ch component-info <component>` - Get component details
- `ch feature-flag <flag>` - Find feature flag usage
- `ch experiment <name>` - Find experiment/Finch config
- `ch component-health <component>` - Bugs, churn, test coverage
**Value**: Feature understanding, component ownership
**Difficulty**: Medium (aggregates existing data)
### 8. Cross-Reference Tools
Advanced code navigation
- `ch xref <symbol>` - Full cross-reference (def + all uses)
- `ch callers <function>` - Find function callers
- `ch callees <function>` - Find functions called by this
- `ch inheritance <class>` - Class hierarchy up and down
**Value**: Code navigation, call graphs, refactoring
**Difficulty**: Medium (enhanced symbol search)
## 📚 Documentation & Discovery
### 9. Documentation Search
Find and access Chromium documentation
- `ch docs <query>` - Search Chromium docs
- `ch api-docs <class>` - Find API documentation
- `ch readme <path>` - Find README files in path
- `ch design-doc <feature>` - Search design docs
**Value**: Learning, onboarding, feature understanding
**Difficulty**: Easy (search + known doc locations)
### 10. API Evolution Tracking
Track API changes over time
- `ch api-changes <class> [--since v100]` - Track API changes
- `ch deprecations [path]` - Find deprecated API usage
- `ch breaking-changes --since v100` - List breaking changes
- `ch api-adoption <api>` - Track API adoption rate
**Value**: Migration planning, version upgrades
**Difficulty**: Medium (git history analysis)
## 🔒 Security & Quality
### 11. Security Analysis
Security auditing and vulnerability detection
- `ch security <query>` - Search security-related code
- `ch security-bugs [component]` - List security bugs
- `ch security-reviews <path>` - Find security review comments
- `ch dangerous-apis <path>` - Flag potentially unsafe API usage
**Value**: Security audits, vulnerability finding
**Difficulty**: Medium (pattern detection + API)
### 12. Advanced Code Search
More powerful search capabilities
- `ch regex <pattern>` - Full regex search
- `ch ast-search <query>` - AST-based semantic search
- `ch duplicate-code [path]` - Find code duplication
- `ch dead-code [path]` - Find potentially unused code
**Value**: Advanced analysis, refactoring opportunities
**Difficulty**: Hard (requires AST parsing or advanced tools)
## 🏗️ Build & CI
### 13. Build System Commands
GN/Ninja build system integration
- `ch build-deps <target>` - Build dependencies for GN target
- `ch build-time <target>` - Historical build times
- `ch build-graph <target>` - Visualize build dependency graph
- `ch gn-refs <target>` - Find GN target references
**Value**: Build optimization, understanding build system
**Difficulty**: Hard (GN parsing and analysis)
### 14. Bot/CI Integration
CI health and tree status
- `ch bot-status` - Current bot farm status
- `ch bot-health <bot-name>` - Bot reliability metrics
- `ch sheriff` - Current sheriff info
- `ch tree-status` - Tree open/closed status
**Value**: CI health, deployment readiness
**Difficulty**: Easy-Medium (API calls)
### 15. Performance Tracking
Benchmark and performance monitoring
- `ch benchmarks <query>` - Search performance benchmarks
- `ch perf-history <benchmark>` - Benchmark historical data
- `ch perf-regressions [--days 7]` - Recent perf regressions
**Value**: Performance tracking, regression detection
**Difficulty**: Medium (benchmark API integration)
## 🔄 Migration & Refactoring
### 16. Migration Tools
Large-scale code changes
- `ch migrate-api <old> <new>` - Find migration opportunities
- `ch bulk-replace <pattern> <replacement>` - Dry-run bulk changes
- `ch refactor-preview <file>` - Preview refactoring impact
**Value**: Large-scale migrations, API updates
**Difficulty**: Hard (requires careful analysis)
### 17. Comparison Tools
Version and branch comparison
- `ch diff-versions <file> <v1> <v2>` - Compare file across versions
- `ch diff-branches <file> <b1> <b2>` - Compare across branches
- `ch component-diff <comp> <v1> <v2>` - Component changes
**Value**: Version comparison, understanding changes
**Difficulty**: Medium (git diff + formatting)
## 🌿 Release Management
### 18. Release/Branch Tools
Track features across versions
- `ch releases` - List Chromium releases
- `ch branch-info <branch>` - Branch details
- `ch merge-status <commit>` - Track commit across branches
- `ch cherry-picks <commit>` - Find cherry-picks
**Value**: Release management, feature tracking
**Difficulty**: Medium (git + release API)
## 🔔 Monitoring & Alerts
### 19. Watch/Monitor Commands
Stay informed about changes
- `ch watch-file <file>` - Watch file for changes
- `ch watch-component <comp>` - Watch component activity
- `ch alerts` - Show configured alerts
- `ch trending` - Trending issues/CLs/commits
**Value**: Staying informed, tracking areas of interest
**Difficulty**: Medium (requires state management)
## 📊 Project Management
### 20. Project Tracking
Planning and velocity metrics
- `ch roadmap <component>` - Component roadmap
- `ch milestones [component]` - Track milestones
- `ch velocity <team>` - Team velocity metrics
**Value**: Planning, progress tracking
**Difficulty**: Medium (data aggregation)
## 🤖 AI Integration (Future)
### 21. AI-Powered Analysis
Experimental AI features
- `ch explain <file>` - AI explanation of code
- `ch summarize-cl <cl-id>` - AI summary of CL
- `ch suggest-fixes <issue-id>` - AI suggested fixes
- `ch code-review-ai <cl-id>` - AI code review
**Value**: AI assistance, learning, automated reviews
**Difficulty**: Hard (requires AI model integration)
## 📦 Enhancements to Existing Features
### Issue Search Improvements
- Add issue comments/history to search results
- Client-side filtering: `--min-views`, `--with-cl`, `--assignee-only`
- Sorting: `--sort-by <field>`, `--sort-order <asc|desc>`
- Export: `--export csv/xlsx`
- Statistics: `ch issues stats <query>`
### Gerrit Enhancements
- Related CL discovery
- CL comparison
- Review statistics
- Automatic reviewer suggestions
### Search Improvements
- Search result caching
- Search history
- Saved queries
- Better result ranking
## 🛠️ Infrastructure
### Quality & Testing
- Add comprehensive test suite
- Integration tests with real API calls
- Mock API responses for unit tests
- Performance benchmarks
### Developer Experience
- Improve error messages
- Add progress indicators for slow operations
- Better debugging output
- Interactive mode (REPL)
### Configuration
- More configuration options
- Profile support (work/personal)
- Plugin system for custom commands
- Shell completion scripts
## 📝 Documentation
### User Documentation
- Video tutorials
- Interactive examples
- Common workflow guides
- Troubleshooting guide
### Developer Documentation
- API documentation
- Contributing guide
- Architecture overview
- Plugin development guide
## 🎯 Roadmap
### v1.5.7 - Gitiles Commands (Current)
- Blame, history, contributors commands
### v1.6.0 - Test Discovery
- Test finding and coverage tools
### v1.7.0 - Code Review Helper
- Reviewer suggestions, CL impact analysis
### v1.8.0 - Dependency Analysis
- Dependency tracking and visualization
### v2.0.0 - Major Feature Release
- Code metrics and quality analysis
- Component health tracking
- Advanced search capabilities
---
**Priority Legend**:
- ⭐ = Current sprint
- 🔥 = High impact
- 📚 = Documentation/Learning
- 🔒 = Security/Quality
- 🏗️ = Build/CI
- 🔄 = Migration/Refactoring
- 🌿 = Release Management
- 🔔 = Monitoring
- 🤖 = AI/Experimental
**Difficulty Scale**:
- Easy: 1-2 days
- Medium: 3-5 days
- Hard: 1-2 weeks
- Very Hard: 2+ weeks
