iflow-mcp_hulupeep_ruvscan-mcp 0.5.0__tar.gz

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/.env.example

@@ -0,0 +1,41 @@
+# RuvScan Environment Variables
+
+# GitHub API
+GITHUB_TOKEN=ghp_your_github_personal_access_token_here
+
+# Supabase (optional - for cloud storage)
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_KEY=your_supabase_anon_key_here
+
+# OpenAI API (for embeddings and LLM)
+OPENAI_API_KEY=sk-your_openai_api_key_here
+
+# Anthropic API (alternative LLM)
+ANTHROPIC_API_KEY=sk-ant-your_anthropic_api_key_here
+
+# MCP Server
+RUVSCAN_HOST=0.0.0.0
+RUVSCAN_PORT=8000
+
+# Rust Engine
+RUST_ENGINE_HOST=localhost
+RUST_ENGINE_PORT=50051
+
+# Go Scanner
+RUVSCAN_SOURCE_TYPE=org
+RUVSCAN_SOURCE_NAME=ruvnet
+RUVSCAN_MCP_ENDPOINT=http://localhost:8000/ingest
+
+# Database Seeding
+# Default repository to seed on first setup
+# Options: 'org' (organization) or 'user' (individual user)
+# Run: python3 scripts/seed_database.py
+# Or with custom source: python3 scripts/seed_database.py --org openai --limit 30
+# See docs/DATABASE_SEEDING.md for details
+
+# Logging
+LOG_LEVEL=INFO
+
+# Database
+DATABASE_TYPE=sqlite  # sqlite or supabase
+SQLITE_PATH=data/ruvscan.db

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,46 @@
+---
+name: Bug Report
+about: Report a bug in RuvScan
+title: '[BUG] '
+labels: 'type: bug'
+assignees: ''
+---
+
+## 🐛 Description
+
+A clear and concise description of the bug.
+
+## 📋 Steps to Reproduce
+
+1.
+2.
+3.
+
+## ✅ Expected Behavior
+
+What you expected to happen.
+
+## ❌ Actual Behavior
+
+What actually happened.
+
+## 🖥️ Environment
+
+- **OS**: [e.g., Ubuntu 22.04, macOS 14.0]
+- **Docker version**: [e.g., 24.0.0]
+- **RuvScan version**: [e.g., 0.5.0]
+- **Installation method**: [Docker/Manual]
+
+## 📊 Logs
+
+```
+Paste relevant logs here
+```
+
+## 📸 Screenshots
+
+If applicable, add screenshots to help explain the problem.
+
+## 🔍 Additional Context
+
+Any other context about the problem.

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,43 @@
+---
+name: Feature Request
+about: Suggest a feature for RuvScan
+title: '[FEATURE] '
+labels: 'type: feature'
+assignees: ''
+---
+
+## 💡 Feature Description
+
+A clear description of the feature you'd like to see.
+
+## 🎯 Problem It Solves
+
+What problem does this feature solve? Who would benefit?
+
+## 🚀 Proposed Solution
+
+How should this feature work?
+
+## 🔄 Alternatives Considered
+
+What other solutions have you considered?
+
+## 📝 Use Cases
+
+Describe specific scenarios where this would be useful.
+
+**Example 1:**
+```
+User does X
+Feature enables Y
+Result: Z
+```
+
+**Example 2:**
+```
+...
+```
+
+## 🎨 Additional Context
+
+Mockups, examples, or any other relevant information.

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/.gitignore

@@ -0,0 +1,81 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Rust
+/target/
+Cargo.lock
+**/*.rs.bk
+*.pdb
+
+# Go
+/bin/
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+go.work
+
+# Data and logs
+data/*.db
+data/*.db-*
+logs/*.log
+*.sqlite
+
+# Environment
+.env
+.env.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+.dockerignore
+
+# Testing
+.coverage
+.pytest_cache/
+.tox/
+htmlcov/
+
+# Temporary files
+*.tmp
+*.bak
+*.swp
+/src/rust/target/

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/.mcp.json.example

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "ruvscan": {
+      "command": "uvx",
+      "args": ["ruvscan-mcp"],
+      "env": {
+        "RUVSCAN_API_URL": "http://localhost:8000",
+        "GITHUB_TOKEN": "ghp_your_github_token_here"
+      }
+    }
+  }
+}

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/2879_process.log

@@ -0,0 +1,3 @@
+[2025-02-03] [开始] 步骤1: 获取项目 - fork并克隆GitHub项目成功
+[2025-02-03] [完成] 步骤2: 阅读代码 - 项目类型Python MCP服务端，支持stdio协议
+[2025-02-03] [完成] 步骤3: 本地测试成功 - 使用uvx方式测试，检测到4个工具

iflow_mcp_hulupeep_ruvscan_mcp-0.5.0/CHANGELOG.md

@@ -0,0 +1,178 @@
+# Changelog
+
+All notable changes to RuvScan will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.5.1] - 2025-10-23
+
+### Changed
+- **BREAKING**: Updated to Docker Compose V2 syntax (use `docker compose` instead of `docker-compose`)
+- Removed obsolete `version` field from docker-compose.yml
+- Updated all documentation to use Docker Compose V2 commands
+- Updated all scripts to use Docker Compose V2 syntax
+
+### Added
+- Complete MCP (Model Context Protocol) server implementation
+- Claude Code CLI integration support
+- Claude Desktop integration support
+- New documentation:
+  - `docs/MCP_INSTALL.md` - Complete MCP installation guide
+  - `docs/QUICK_MCP_START.md` - 30-second MCP setup guide
+  - `docs/MCP_QUICK_REFERENCE.md` - Quick reference for MCP usage
+  - `docs/CLAUDE_CODE_EXAMPLES.md` - Claude Code CLI examples
+  - `docs/CLAUDE_DESKTOP_EXAMPLES.md` - Claude Desktop examples
+  - `QUICK_START_LOCAL.md` - Local development quick start
+- Python package configuration (setup.py, pyproject.toml, MANIFEST.in)
+- MCP stdio server for Claude integration
+- Example .mcp.json configuration
+
+### Fixed
+- Docker Compose V2 compatibility issues
+- All shell scripts updated for modern Docker syntax
+- Documentation consistency across all files
+
+## [0.5.0] - 2025-10-23
+
+### Added
+- Initial MVP release
+- Python MCP orchestrator with FastAPI
+- Rust sublinear engine with gRPC
+- Go concurrent GitHub scanner
+- FACT deterministic caching
+- SAFLA analogical reasoning
+- Johnson-Lindenstrauss O(log n) similarity
+- SQLite database storage
+- Docker Compose orchestration
+- CLI tool with 6 commands
+- Comprehensive documentation
+- Example usage scripts
+- Unit and integration tests
+
+### MCP Endpoints
+- `/scan` - Scan GitHub org/user/topic
+- `/query` - Query for leverage cards
+- `/compare` - Compare repositories
+- `/analyze` - Analyze reasoning chain
+- `/cards` - List saved leverage cards
+- `/mcp/tools` - List available MCP tools
+
+### Components
+- **Python MCP Server**
+  - FastAPI with async support
+  - FACT cache implementation
+  - SAFLA reasoning engine
+  - Embedding generation (OpenAI)
+  - Database layer with SQLite
+  - gRPC client for Rust
+
+- **Rust Sublinear Engine**
+  - TRUE O(log n) algorithms
+  - JL dimension reduction
+  - gRPC server
+  - Cosine similarity
+  - Batch processing
+
+- **Go Scanner Workers**
+  - Concurrent GitHub API
+  - README extraction
+  - Rate limit handling
+  - REST integration
+
+### Infrastructure
+- Docker multi-container setup
+- Kubernetes manifests
+- Production configurations
+- Monitoring and metrics
+- Health checks
+- Backup scripts
+
+### Documentation
+- README with architecture
+- Quick start guide
+- API reference
+- Deployment guide
+- Architecture details
+- Build summary
+
+## [Unreleased]
+
+### Planned for v0.6
+- [ ] Complete Rust-Python gRPC integration
+- [ ] Real Go scanner → Python data flow
+- [ ] LLM integration for SAFLA reasoning
+- [ ] Enhanced error handling
+- [ ] Performance optimizations
+- [ ] Supabase cloud storage option
+
+### Planned for v0.7
+- [ ] MidStream real-time updates
+- [ ] Advanced caching strategies
+- [ ] Prometheus metrics export
+- [ ] Grafana dashboards
+- [ ] API authentication
+- [ ] Rate limiting
+
+### Planned for v1.0
+- [ ] Self-optimizing agent
+- [ ] Federated scanning nodes
+- [ ] Graph analysis
+- [ ] WebSocket support
+- [ ] Advanced query DSL
+- [ ] ML-powered ranking
+
+## Security
+
+### Known Issues
+- No authentication implemented (v0.5)
+- No rate limiting (v0.5)
+- Secrets in environment variables (consider Vault)
+
+### Addressed in Future Versions
+- API key authentication (v0.6)
+- OAuth 2.0 support (v0.7)
+- Rate limiting (v0.6)
+- Audit logging (v0.7)
+
+## Performance
+
+### Current Metrics (v0.5)
+- Query latency: Not yet benchmarked
+- Scan throughput: Not yet benchmarked
+- Memory footprint: <500MB target
+- CPU usage: <1 core target
+
+### Improvements Planned
+- Database query optimization
+- Caching improvements
+- Batch processing enhancements
+- Connection pooling
+
+## Breaking Changes
+
+### v0.5.0
+- Initial release - no breaking changes
+
+## Migration Guide
+
+### From Development to Production
+1. Update environment variables
+2. Enable SSL/TLS
+3. Configure external database
+4. Set up monitoring
+5. Configure backups
+6. Review security checklist
+
+## Contributors
+
+- Colm Byrne (Flout Labs) - Initial implementation
+
+## Acknowledgments
+
+Built with:
+- [sublinear-time-solver](https://github.com/ruvnet/sublinear-time-solver)
+- [FACT](https://github.com/ruvnet/FACT)
+- [FastAPI](https://fastapi.tiangolo.com/)
+- [Rust](https://www.rust-lang.org/)
+- [Go](https://go.dev/)