aidevops 2.52.1

package/.agent/tools/code-review/tools.md

@@ -0,0 +1,230 @@
+---
+description: AI DevOps code review tools and resources
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+  task: true
+---
+
+# AI DevOps Resources
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- Linter manager: `bash .agent/scripts/linter-manager.sh detect|install-detected|install-all|install [lang]`
+- Languages: Python (pycodestyle, Pylint, Bandit, Ruff), JS/TS (Oxlint, ESLint), CSS (Stylelint), Shell (ShellCheck), Docker (Hadolint), YAML (Yamllint)
+- Platforms comparison:
+  - CodeRabbit: AI code review, no auto-fix
+  - Codacy: 40+ langs, auto-fix safe violations
+  - SonarCloud: Enterprise analysis, no auto-fix
+  - Qlty: 70+ tools, 40+ langs, auto-format
+  - CodeFactor: Reference collection, web-only
+- Auto-fix tools: Codacy CLI (70-90%), Qlty CLI (80-95%), ESLint (60-80%)
+- Config files: .eslintrc.*, .pylintrc, .shellcheckrc, .hadolint.yaml, .stylelintrc.*
+- Best practices: Start conservative, customize gradually, version control configs
+<!-- AI-CONTEXT-END -->
+
+## Code Quality & Linting Tools
+
+### CodeFactor Linters Collection
+
+CodeFactor uses a comprehensive collection of open-source analysis tools. Our framework includes a linter manager based on their collection.
+
+**Reference**: [CodeFactor Analysis Tools](https://docs.codefactor.io/bootcamp/analysis-tools/)
+
+#### Language-Specific Linters
+
+| Language | Tools | Version | Configuration |
+|----------|-------|---------|---------------|
+| **Python** | pycodestyle, Pylint, Bandit, Ruff | Latest | setup.cfg, .pylintrc, .bandit |
+| **JavaScript/TypeScript** | Oxlint, ESLint | Latest | .eslintrc.* |
+| **CSS/SCSS/Less** | Stylelint | 16.25.0 | .stylelintrc* |
+| **Shell** | ShellCheck | 0.11.0 | .shellcheckrc |
+| **Docker** | Hadolint | 2.14.0 | .hadolint.yaml |
+| **YAML** | Yamllint | 1.37.1 | .yamllint* |
+| **Go** | Revive | 1.12.0 | revive.toml |
+| **PHP** | PHP_CodeSniffer | 3.13.5 | phpcs.xml |
+| **Ruby** | RuboCop, bundler-audit, Brakeman | Latest | .rubocop.yml |
+| **Java** | Checkstyle | 12.1.1 | checkstyle.xml |
+| **C#** | StyleCop.Analyzers | Latest | .editorconfig |
+| **Swift** | SwiftLint | 0.62.1 | .swiftlint.yml |
+| **Kotlin** | Detekt | 1.23.8 | detekt.yml |
+| **Dart** | Linter for Dart | 3.10.0 | analysis_options.yaml |
+| **R** | Lintr | 3.2.0 | .lintr |
+| **C/C++** | CppLint, Flawfinder | Latest | CPPLINT.CFG |
+| **Haskell** | HLint | 3.10 | .hlint.yaml |
+| **Groovy** | CodeNarc | 3.6.0 | codenarc.xml |
+| **PowerShell** | PSScriptAnalyzer | 1.24.0 | PSScriptAnalyzerSettings.psd1 |
+| **Security** | Trivy | 0.67.2 | trivy.yaml |
+
+#### Usage with Our Framework
+
+```bash
+# Detect languages in current project
+bash .agent/scripts/linter-manager.sh detect
+
+# Install linters for detected languages
+bash .agent/scripts/linter-manager.sh install-detected
+
+# Install all supported linters
+bash .agent/scripts/linter-manager.sh install-all
+
+# Install linters for specific language
+bash .agent/scripts/linter-manager.sh install python
+```
+
+### Quality Analysis Platforms
+
+#### Integrated Platforms
+
+| Platform | Type | Integration | Auto-Fix |
+|----------|------|-------------|----------|
+| **CodeRabbit** | AI Code Review | ✅ CLI | ❌ Analysis Only |
+| **Codacy** | Code Quality | ✅ CLI + Web | ✅ Auto-Fix |
+| **SonarCloud** | Code Quality | ✅ CLI + Web | ❌ Analysis Only |
+| **Qlty** | Universal Linting | ✅ CLI | ✅ Auto-Format |
+| **CodeFactor** | Code Quality | 📚 Reference | ❌ Web Only |
+
+#### Platform Comparison
+
+**CodeRabbit**:
+
+- AI-powered code review
+- Pull request analysis
+- Contextual suggestions
+- No auto-fix capabilities
+
+**Codacy**:
+
+- Comprehensive code analysis
+- 40+ languages supported
+- Auto-fix for safe violations
+- Web dashboard + CLI
+
+**SonarCloud**:
+
+- Enterprise-grade analysis
+- Security vulnerability detection
+- Technical debt tracking
+- Analysis only (no auto-fix)
+
+**Qlty**:
+
+- Universal linting platform
+- 70+ tools, 40+ languages
+- Auto-formatting capabilities
+- Account-wide and organization-specific access
+
+**CodeFactor**:
+
+- Comprehensive linter collection
+- Reference for tool selection
+- Web-based analysis
+- Open-source tool integration
+
+### Auto-Fix Capabilities
+
+#### Tools with Auto-Fix Support
+
+| Tool | Languages | Fix Types | Time Savings |
+|------|-----------|-----------|--------------|
+| **Codacy CLI** | Multi-language | Style, Best Practices, Security | 70-90% |
+| **Qlty CLI** | 40+ Languages | Formatting, Linting, Smells | 80-95% |
+| **ESLint** | JavaScript/TypeScript | Style, Best Practices | 60-80% |
+| **Pylint** | Python | Style, Code Quality | 50-70% |
+| **RuboCop** | Ruby | Style, Best Practices | 60-80% |
+| **SwiftLint** | Swift | Style, Best Practices | 50-70% |
+
+#### Auto-Fix Workflow
+
+1. **Detection**: Identify code quality issues
+2. **Analysis**: Determine safe fixes
+3. **Application**: Apply fixes automatically
+4. **Verification**: Validate changes
+5. **Reporting**: Document applied fixes
+
+### Configuration Management
+
+#### Configuration Files by Tool
+
+**Python**:
+
+- `setup.cfg`: pycodestyle, flake8
+- `.pylintrc`: Pylint configuration
+- `.bandit`: Bandit security rules
+- `pyproject.toml`: Modern Python configuration
+
+**JavaScript/TypeScript**:
+
+- `.eslintrc.js/.json/.yaml`: ESLint rules
+- `tsconfig.json`: TypeScript configuration
+- `.oxlintrc.json`: Oxlint configuration
+
+**CSS/SCSS**:
+
+- `.stylelintrc.json/.yaml`: Stylelint rules
+- `stylelint.config.js`: JavaScript configuration
+
+**Shell**:
+
+- `.shellcheckrc`: ShellCheck configuration
+
+**Docker**:
+
+- `.hadolint.yaml`: Hadolint rules
+
+**YAML**:
+
+- `.yamllint.yaml`: Yamllint configuration
+
+### Best Practices
+
+#### Linter Selection
+
+1. **Language Coverage**: Choose tools that cover your tech stack
+2. **Auto-Fix Support**: Prioritize tools with automatic fixing
+3. **Configuration**: Use standard configuration files
+4. **Integration**: Ensure CI/CD compatibility
+5. **Performance**: Consider analysis speed and resource usage
+
+#### Configuration Strategy
+
+1. **Start Conservative**: Begin with standard rule sets
+2. **Customize Gradually**: Adjust rules based on team needs
+3. **Document Decisions**: Maintain configuration rationale
+4. **Version Control**: Track configuration changes
+5. **Team Alignment**: Ensure team consensus on rules
+
+#### Workflow Integration
+
+1. **Pre-commit Hooks**: Run linters before commits
+2. **CI/CD Pipeline**: Integrate with build process
+3. **IDE Integration**: Configure editor plugins
+4. **Auto-Fix Scheduling**: Regular automated fixes
+5. **Quality Gates**: Block merges on quality issues
+
+### Additional Resources
+
+#### Documentation Links
+
+- [CodeFactor Analysis Tools](https://docs.codefactor.io/bootcamp/analysis-tools/)
+- [ESLint Rules](https://eslint.org/docs/rules/)
+- [Pylint Messages](https://pylint.pycqa.org/en/latest/technical_reference/features.html)
+- [ShellCheck Wiki](https://github.com/koalaman/shellcheck/wiki)
+- [Stylelint Rules](https://stylelint.io/user-guide/rules/list)
+
+#### Community Resources
+
+- [Awesome Static Analysis](https://github.com/analysis-tools-dev/static-analysis)
+- [Code Quality Tools](https://github.com/collections/code-quality)
+- [Linting Best Practices](https://github.com/topics/linting)
+
+This resource collection provides comprehensive guidance for implementing
+code quality analysis and automated fixing in AI-assisted development workflows.

package/.agent/tools/content/summarize.md

@@ -0,0 +1,353 @@
+---
+description: URL/YouTube/podcast summarization using steipete/summarize CLI
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+  task: true
+---
+
+# Summarize CLI Integration
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: Summarize URLs, YouTube videos, podcasts, and files using AI
+- **Install**: `npm i -g @steipete/summarize` or `brew install steipete/tap/summarize`
+- **Repo**: https://github.com/steipete/summarize (726+ stars)
+- **Website**: https://summarize.sh
+
+**Quick Commands**:
+
+```bash
+# Summarize any URL
+summarize "https://example.com"
+
+# YouTube video
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
+
+# Podcast RSS feed
+summarize "https://feeds.npr.org/500005/podcast.xml"
+
+# Local file (PDF, images, audio/video)
+summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
+
+# Extract content only (no summary)
+summarize "https://example.com" --extract --format md
+```
+
+**Key Features**:
+
+- URLs, files, and media: web pages, PDFs, images, audio/video, YouTube, podcasts, RSS
+- Real extraction pipeline: fetch -> clean -> Markdown (readability + markitdown)
+- Transcript-first media flow: published transcripts when available, Whisper fallback
+- Streaming TTY output with Markdown rendering
+- Local, paid, and free models: OpenAI-compatible local endpoints, paid providers, OpenRouter free preset
+
+**Env Vars**: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, `XAI_API_KEY`, `OPENROUTER_API_KEY`
+
+<!-- AI-CONTEXT-END -->
+
+## Installation
+
+### npm (recommended)
+
+```bash
+# Global install
+npm i -g @steipete/summarize
+
+# One-shot (no install)
+npx -y @steipete/summarize "https://example.com"
+```
+
+### Homebrew (macOS Apple Silicon)
+
+```bash
+brew install steipete/tap/summarize
+```
+
+### Requirements
+
+- Node.js 22+
+- Optional: `yt-dlp` for YouTube audio extraction
+- Optional: `whisper.cpp` for local transcription
+- Optional: `uvx markitdown` for enhanced preprocessing
+
+## Usage
+
+### Basic Summarization
+
+```bash
+# Web page
+summarize "https://example.com"
+
+# With specific model
+summarize "https://example.com" --model openai/gpt-5-mini
+
+# Auto model selection (default)
+summarize "https://example.com" --model auto
+```
+
+### YouTube Videos
+
+```bash
+# Auto-detect transcript method
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
+
+# Supports youtube.com and youtu.be URLs
+summarize "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+```
+
+### Podcasts
+
+```bash
+# RSS feed (transcribes latest episode)
+summarize "https://feeds.npr.org/500005/podcast.xml"
+
+# Apple Podcasts episode
+summarize "https://podcasts.apple.com/us/podcast/2424-jelly-roll/id360084272?i=1000740717432"
+
+# Spotify episode (best-effort)
+summarize "https://open.spotify.com/episode/5auotqWAXhhKyb9ymCuBJY"
+```
+
+### Local Files
+
+```bash
+# PDF (Google models work best)
+summarize "/path/to/document.pdf" --model google/gemini-3-flash-preview
+
+# Images
+summarize "/path/to/image.png"
+
+# Audio/Video
+summarize "/path/to/video.mp4" --video-mode transcript
+```
+
+### Output Control
+
+```bash
+# Length presets: short, medium, long, xl, xxl
+summarize "https://example.com" --length long
+
+# Character target
+summarize "https://example.com" --length 20k
+
+# Hard token cap
+summarize "https://example.com" --max-output-tokens 2000
+
+# Output language
+summarize "https://example.com" --language en
+summarize "https://example.com" --lang auto  # match source
+```
+
+### Content Extraction
+
+```bash
+# Extract content without summarizing
+summarize "https://example.com" --extract
+
+# Extract as Markdown
+summarize "https://example.com" --extract --format md
+
+# Extract as plain text
+summarize "https://example.com" --extract --format text
+```
+
+### Output Formats
+
+```bash
+# JSON output with diagnostics
+summarize "https://example.com" --json
+
+# Plain output (no ANSI/colors)
+summarize "https://example.com" --plain
+
+# Disable streaming
+summarize "https://example.com" --stream off
+```
+
+## Model Configuration
+
+### Supported Providers
+
+| Provider | Model ID Format | API Key |
+|----------|-----------------|---------|
+| OpenAI | `openai/gpt-5-mini` | `OPENAI_API_KEY` |
+| Anthropic | `anthropic/claude-sonnet-4-5` | `ANTHROPIC_API_KEY` |
+| Google | `google/gemini-3-flash-preview` | `GEMINI_API_KEY` |
+| xAI | `xai/grok-4-fast-non-reasoning` | `XAI_API_KEY` |
+| Z.AI | `zai/glm-4.7` | `Z_AI_API_KEY` |
+| OpenRouter | `openrouter/openai/gpt-5-mini` | `OPENROUTER_API_KEY` |
+
+### Free Models via OpenRouter
+
+```bash
+# Setup free model preset
+OPENROUTER_API_KEY=sk-or-... summarize refresh-free --set-default
+
+# Use free models
+summarize "https://example.com" --model free
+```
+
+### Configuration File
+
+Location: `~/.summarize/config.json`
+
+```json
+{
+  "model": { "id": "openai/gpt-5-mini" }
+}
+```
+
+Or shorthand:
+
+```json
+{
+  "model": "openai/gpt-5-mini"
+}
+```
+
+## Chrome Extension
+
+Summarize includes a Chrome Side Panel extension for one-click summarization.
+
+### Setup
+
+1. Install CLI: `npm i -g @steipete/summarize`
+2. Build extension: `pnpm -C apps/chrome-extension build`
+3. Load in Chrome: `chrome://extensions` -> Developer mode -> Load unpacked
+4. Pick: `apps/chrome-extension/.output/chrome-mv3`
+5. Open Side Panel -> copy install command
+6. Run: `summarize daemon install --token <TOKEN>`
+
+### Daemon Commands
+
+```bash
+# Check daemon status
+summarize daemon status
+
+# Restart daemon
+summarize daemon restart
+```
+
+## Advanced Features
+
+### Firecrawl Fallback
+
+For blocked or thin content, Firecrawl can be used as fallback:
+
+```bash
+# Auto fallback (default)
+summarize "https://example.com" --firecrawl auto
+
+# Force Firecrawl
+summarize "https://example.com" --firecrawl always
+
+# Disable Firecrawl
+summarize "https://example.com" --firecrawl off
+```
+
+Requires `FIRECRAWL_API_KEY` environment variable.
+
+### Whisper Transcription
+
+For audio/video without transcripts:
+
+```bash
+# Force transcription mode
+summarize "/path/to/video.mp4" --video-mode transcript
+
+# Environment variables
+export SUMMARIZE_WHISPER_CPP_MODEL_PATH=/path/to/model.bin
+export SUMMARIZE_WHISPER_CPP_BINARY=whisper-cli
+export SUMMARIZE_DISABLE_LOCAL_WHISPER_CPP=1  # force remote
+```
+
+### Markdown Conversion
+
+```bash
+# Readability mode (default)
+summarize "https://example.com" --markdown-mode readability
+
+# LLM conversion
+summarize "https://example.com" --markdown-mode llm
+
+# Auto (LLM when configured)
+summarize "https://example.com" --markdown-mode auto
+
+# Disable
+summarize "https://example.com" --markdown-mode off
+```
+
+## Common Flags
+
+| Flag | Description |
+|------|-------------|
+| `--model <provider/model>` | Model to use (default: `auto`) |
+| `--timeout <duration>` | Request timeout (`30s`, `2m`, `5000ms`) |
+| `--retries <count>` | LLM retry attempts (default: 1) |
+| `--length <preset\|chars>` | Output length control |
+| `--language, --lang` | Output language (`auto` = match source) |
+| `--max-output-tokens` | Hard cap for LLM output tokens |
+| `--stream auto\|on\|off` | Stream LLM output |
+| `--plain` | No ANSI/OSC Markdown rendering |
+| `--no-color` | Disable ANSI colors |
+| `--format md\|text` | Content format |
+| `--extract` | Print extracted content and exit |
+| `--json` | Machine-readable output |
+| `--verbose` | Debug/diagnostics on stderr |
+| `--metrics off\|on\|detailed` | Metrics output |
+
+## Integration with aidevops
+
+### Use Cases
+
+1. **Research**: Summarize articles, papers, documentation
+2. **Content Curation**: Extract key points from multiple sources
+3. **Podcast Notes**: Generate show notes from episodes
+4. **Video Summaries**: Create text summaries of YouTube content
+5. **Document Processing**: Summarize PDFs and reports
+
+### Example Workflow
+
+```bash
+# Research a topic
+summarize "https://docs.example.com/api" --length long --json > api-summary.json
+
+# Summarize multiple sources
+for url in "${urls[@]}"; do
+  summarize "$url" --length medium >> research-notes.md
+done
+
+# Extract and process
+summarize "https://example.com" --extract --format md | process-content.sh
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Model not responding**: Check API key is set correctly
+2. **YouTube transcript unavailable**: Install `yt-dlp` for audio extraction
+3. **PDF extraction failing**: Use Google models for best PDF support
+4. **Rate limiting**: Add `--timeout` and `--retries` flags
+
+### Debug Mode
+
+```bash
+summarize "https://example.com" --verbose
+```
+
+## Resources
+
+- **GitHub**: https://github.com/steipete/summarize
+- **Website**: https://summarize.sh
+- **npm**: https://www.npmjs.com/package/@steipete/summarize
+- **Docs**: https://github.com/steipete/summarize/tree/main/docs