aidevops 2.52.1 → 2.53.1

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

@@ -1,230 +0,0 @@
----
-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

@@ -1,353 +0,0 @@
----
-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