hanzo/extension
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[cleanup] remove AI slop files

Browse Source
This commit is contained in:
Hanzo Dev
2026-02-28 12:30:25 -08:00
parent 995e90e27c
commit b748ab9637
5 changed files with 0 additions and 652 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/IMPLEMENTATION_SUMMARY.md
-184
View File
@@ -1,184 +0,0 @@
# Hanzo Extension Implementation Summary
## Overview
Successfully ported the Hanzo MCP (Model Context Protocol) project from Python to TypeScript, creating a unified extension that works across VS Code, Cursor, Windsurf, and Claude Desktop.
## Completed Features
### Core Tools (55+ total, 17 enabled by default)
#### File Operations ✅
- `read` - Read file contents with pagination
- `write` - Write content to files
- `edit` - Precise text replacement
- `multi_edit` - Multiple edits in one operation
- `directory_tree` - Display directory structure
- `find_files` - Find files by pattern
#### Search Operations ✅
- `unified_search` - **NEW!** Parallel search across code, symbols, git, and filenames
- `grep` - Pattern search using ripgrep
- `search` - Unified file and symbol search
- `symbols` - Search for code symbols
#### Shell & System ✅
- `run_command` - Execute shell commands
- `open` - Open files/URLs in default apps
- `process` - Background process management with logging
- `batch` - Execute multiple operations atomically
#### Development Tools ✅
- `todo` / `todo_read` / `todo_write` - Task management
- `think` - Structured reasoning space
- `critic` - Code review and analysis
#### Configuration ✅
- `palette` - Tool personality switching (minimal, python, javascript, devops, data-science)
- `config` - Git-style configuration management
- `rules` - Read project conventions (.cursorrules, etc.)
#### Web & External ✅
- `web_fetch` - **NEW!** Fetch and parse web content
### Architecture Improvements
1. **Unified Codebase**: Single TypeScript implementation for all platforms
2. **Abstract Interfaces**: Support for both local and cloud deployment
3. **Modular Design**: Easy to add new tools and features
4. **Type Safety**: Full TypeScript with strict typing
### Advanced Features Implemented
1. **Unified Search Tool**
- Parallel search across multiple dimensions
- Combines grep, symbol search, git history, and filename search
- Significantly faster than sequential searching
2. **Web Fetch Tool**
- HTTP/HTTPS content fetching
- HTML to text conversion
- Metadata extraction
- Multiple output formats (text, json, raw, metadata)
3. **Process Management**
- Background process execution
- File-based logging for persistence
- Process listing and monitoring
- Clean termination handling
4. **Palette System**
- Quick switching between tool configurations
- Predefined palettes for different workflows
- Environment variable management
5. **Configuration Management**
- Git-style config (get, set, list, unset)
- Global vs workspace settings
- Persistent storage
## Technical Stack
- **Language**: TypeScript
- **Runtime**: Node.js
- **Build System**: ESBuild for MCP server bundling
- **Testing**: Mocha + custom integration tests
- **Platforms**: VS Code API + MCP Protocol
## Deployment Options
### Local Deployment (Default)
- Runs entirely on user's machine
- No external dependencies
- All data stored locally
### Cloud Deployment (Future)
- Abstract interfaces ready for cloud integration
- Vector store supports cloud endpoints
- Authentication framework in place
## File Structure
```
extension/
├── src/
│ ├── extension.ts # VS Code entry point
│ ├── mcp/
│ │ ├── server.ts # MCP server integration
│ │ ├── client.ts # MCP client implementation
│ │ ├── tools/ # All tool implementations
│ │ └── prompts/ # AI prompts
│ ├── services/ # Core services
│ └── core/ # Core utilities
├── scripts/
│ ├── build-mcp-standalone.js # MCP bundler
│ └── vscode-mock.js # VS Code API mock
└── out/ # Compiled output
```
## Performance Optimizations
1. **Parallel Operations**: Unified search runs all searches concurrently
2. **Lazy Loading**: Tools only initialized when needed
3. **Efficient Caching**: Results cached where appropriate
4. **Resource Management**: Proper cleanup and disposal
## Security Considerations
1. **File Access**: Respects workspace boundaries
2. **Shell Commands**: Limited permissions
3. **Web Requests**: URL validation and timeouts
4. **No Telemetry**: No data collection
## Testing
- Unit tests for core functionality
- Integration tests for tool interactions
- Manual testing on macOS confirmed
- Mock VS Code API for standalone testing
## Known Limitations
1. **AST Analysis**: Requires additional setup for full Tree-sitter support
2. **Vector Search**: Basic implementation, needs embedding service
3. **Graph Database**: Simplified implementation using Graphene
## Future Enhancements
1. **Vector Search**: Integrate proper embedding service
2. **Cloud Backend**: Implement Hanzo AI cloud integration
3. **More Language Support**: Extend AST analysis beyond JS/TS
4. **Agent Delegation**: Implement sub-agent system
## Usage
### VS Code/Cursor/Windsurf
```bash
npm install
npm run compile
npm run package
# Install generated .vsix file
```
### Claude Desktop
```bash
npm run build:mcp
# Add to claude_desktop_config.json:
{
"mcpServers": {
"hanzo": {
"command": "node",
"args": ["/path/to/out/mcp-server-standalone.js"],
"env": {
"HANZO_WORKSPACE": "/your/project"
}
}
}
}
```
## Conclusion
The Hanzo extension successfully brings powerful AI-assisted development capabilities to multiple platforms through a unified TypeScript implementation. With 55+ tools covering file operations, search, web fetching, process management, and more, it provides a comprehensive toolkit for modern development workflows.
The extension is production-ready and can be deployed immediately across VS Code, Cursor, Windsurf, and Claude Desktop platforms.
docs/PUSH-SUMMARY.md
-106
View File
@@ -1,106 +0,0 @@
# Push Summary - Dev CLI Implementation 🚀
## What Was Pushed
### Commit: `a12d455`
- **Message**: feat: Add Dev CLI with multi-agent orchestration and comprehensive testing
- **Files Changed**: 26 files
- **Additions**: 8,956 lines
- **Repository**: https://github.com/hanzoai/extension
## Key Features Added
### 1. Dev CLI (`dev` command)
- Multi-agent orchestration system
- Predefined workflows (code-review, implement-feature, optimize, debug)
- Local LLM support (Ollama, LocalAI)
- Async job management
- Git worktree integration
- OAuth2 authentication
### 2. Test Infrastructure
- Integration tests with Mocha/Chai
- Headless Chrome testing with Puppeteer
- Mock AI server for all endpoints
- Visual test runners
- Demo scripts
### 3. CI/CD Pipeline
- `.github/workflows/ci.yml` - Comprehensive pipeline
- Tests for all services:
- VS Code Extension
- JetBrains Plugin
- Dev CLI
- MCP Server
- Integration Tests
## GitHub Actions Status
🔗 **View Build Status**: https://github.com/hanzoai/extension/actions
### Expected Test Results
1. **VS Code Extension**
- TypeScript compilation (may have warnings)
- Unit tests
- VSIX packaging
2. **JetBrains Plugin**
- Gradle build
- Plugin tests
- ZIP packaging
3. **Dev CLI**
- NPM install
- Build process
- Integration tests
4. **MCP Server**
- Build verification
- MCP tool tests
5. **Integration Tests**
- Mock server startup
- Demo script execution
- End-to-end workflows
## Known Issues
1. **TypeScript Errors**: Some type errors exist but are handled with `continue-on-error`
2. **Vulnerabilities**: 6 security vulnerabilities reported by Dependabot (2 high, 2 moderate, 2 low)
## Next Steps
1. Monitor GitHub Actions for build results
2. Fix any failing tests
3. Address security vulnerabilities
4. Create release tags when ready
## Quick Commands
```bash
# Check build status
open https://github.com/hanzoai/extension/actions
# Run tests locally
npm test
./test/run-all-tests.sh
# Build everything
make setup
make build
# Test Dev CLI
dev --version
dev workflow list
dev multi "test task" --coder claude --reviewer gemini
```
## Repository Update
The repository reference has been updated from `hanzoai/extension` to `hanzoai/dev` in:
- package.json files
- README.md
- Documentation
However, the actual GitHub repository remains at `hanzoai/extension` for now.
docs/SUMMARY.md
-106
View File
@@ -1,106 +0,0 @@
# Hanzo Extension - Implementation Summary
## Overview
Successfully ported the Python-based Hanzo MCP project to TypeScript, creating a unified extension that works across multiple platforms.
## Key Accomplishments
### 1. Multi-Platform Support ✅
- **Single build** works on VS Code, Cursor, and Windsurf
- **Claude Desktop** support via standalone MCP server
- **No platform-specific builds needed** - one .vsix file for all
### 2. Feature Parity with Python MCP ✅
Ported all 65+ tools including:
- File operations (read, write, edit, multi-edit)
- Search tools (grep, symbols, git, unified search)
- Shell integration (run commands, process management)
- Development tools (todo, think, critic, rules)
- AI tools (agent delegation, LLM, consensus)
- Specialized tools (jupyter, database, vector search)
### 3. New Features Added ✅
- **Unified Search Tool**: Parallel execution of all search types
- **Web Fetch Tool**: Fetch and analyze web content
- **Process Management**: Background process execution with logging
- **Palette System**: Switch tool configurations on the fly
- **Configuration Tool**: Git-style config management
### 4. Architecture Improvements ✅
- **TypeScript**: Full type safety and better IDE support
- **Modular design**: Each tool category in separate modules
- **Abstract interfaces**: Support for local and cloud deployment
- **Extensible**: Easy to add new tools
### 5. Testing & Verification ✅
- Comprehensive verification script
- Performance benchmarks documented
- All builds verified working
- Platform compatibility confirmed
## Build Outputs
| Output | Size | Purpose |
|--------|------|---------|
| `hanzoai-1.5.4.vsix` | 104.36 MB | VS Code/Cursor/Windsurf extension |
| `out/mcp-server-standalone.js` | 122 KB | Claude Desktop MCP server |
| `dist/claude-desktop/` | Directory | Claude Desktop installation package |
## Installation
### VS Code/Cursor/Windsurf
```bash
# Install from VSIX
code --install-extension hanzoai-1.5.4.vsix
```
### Claude Desktop
```bash
cd dist/claude-desktop
./install.sh # Mac/Linux
# or
install.bat # Windows
```
## Performance Metrics
- **Startup**: < 100ms
- **Memory**: ~50MB base
- **File operations**: < 50ms average
- **Search operations**: 100-300ms for unified search
- **17 tools** enabled by default (out of 55 total)
## Pending Tasks
While the core functionality is complete, these items remain for future enhancement:
1. **AST Analysis**: TypeScript parser integration (compilation issues)
2. **Tree-sitter**: Advanced code analysis (module resolution issues)
3. **Graphene Integration**: Graph database support (dependency conflicts)
4. **Vector Search**: Full embeddings support with LanceDB
5. **Cloud Deployment**: Complete abstraction for Hanzo AI cloud
## Configuration
### Extension Settings
- `hanzo.mcp.enabled`: Enable/disable MCP server
- `hanzo.mcp.enabledTools`: List of enabled tools
- `hanzo.mcp.serverTransport`: 'stdio' or 'tcp'
- `hanzo.mcp.logLevel`: Logging verbosity
### Environment Variables
- `HANZO_WORKSPACE`: Override workspace directory
- `HANZO_MCP_*`: Override any MCP configuration
## Next Steps
1. **Deploy** the extension to VS Code marketplace
2. **Test** Claude Desktop integration thoroughly
3. **Complete** pending AST/Graph features
4. **Optimize** search performance further
5. **Add** telemetry and usage analytics
## Summary
The Hanzo extension successfully brings the power of the Python MCP toolkit to the TypeScript ecosystem, with excellent cross-platform support and performance. The unified architecture means maintaining a single codebase for all supported platforms, significantly reducing maintenance burden while providing a consistent experience across editors.
docs/WORKFLOW-STATUS.md
-82
View File
@@ -1,82 +0,0 @@
# GitHub Actions Workflow Status
## Build Status
| Extension | Build | Tests | Release |
|-----------|-------|-------|---------|
| VS Code | [![VS Code Extension CI/CD](https://github.com/hanzoai/extension/workflows/VS%20Code%20Extension%20CI%2FCD/badge.svg)](https://github.com/hanzoai/extension/actions/workflows/vscode-extension.yml) | ✅ | Auto |
| JetBrains | [![JetBrains Plugin CI/CD](https://github.com/hanzoai/extension/workflows/JetBrains%20Plugin%20CI%2FCD/badge.svg)](https://github.com/hanzoai/extension/actions/workflows/jetbrains-plugin.yml) | ✅ | Auto |
| Claude Code | Included in VS Code workflow | ✅ | Auto |
## Recent Workflow Runs
The workflows are configured to:
1. **On Push to Main**:
- Run tests for modified extensions
- Build artifacts
- Create pre-release with artifacts
2. **On Pull Request**:
- Run tests only
- Verify build succeeds
3. **On Version Tag** (v*):
- Build all extensions
- Create official release
- Upload all artifacts
## Test Coverage
### VS Code Extension
- Extension activation tests
- Command registration tests
- Configuration management tests
- MCP functionality tests
- Simple integration tests
### JetBrains Plugin
- Plugin initialization tests
- Authentication service tests
- Project service tests
- Settings management tests
- API integration tests
## Debugging Failed Workflows
### Common Issues
1. **TypeScript Compilation Errors**
- Check `npm run compile` locally
- Review type definitions
- Update dependencies if needed
2. **Gradle Build Failures**
- Verify Gradle wrapper is committed
- Check Java version (requires 17)
- Review dependency conflicts
3. **Test Failures**
- Run tests locally first
- Check for environment-specific issues
- Mock external dependencies
### Local Testing
```bash
# VS Code Extension
npm install
npm run compile
npm run test:simple
# JetBrains Plugin
cd jetbrains-plugin
./gradlew test
./gradlew build
```
## Monitoring
- Check [Actions tab](https://github.com/hanzoai/extension/actions) for real-time status
- Review workflow logs for detailed error messages
- Enable notifications for workflow failures
test/TEST-SUMMARY.md
-174
View File
@@ -1,174 +0,0 @@
# Dev CLI Test Suite Summary 🧪
## Test Infrastructure Created
### 1. **Integration Tests** (`test/integration/dev-cli.test.ts`)
- Full CLI command testing with Mocha/Chai
- Headless Chrome testing with Puppeteer for OAuth flows
- Git repository initialization and testing
- Visual test reporter with progress tracking
- Timeout handling and error reporting
### 2. **Mock AI Server** (`test/mock/ai-mock-server.ts`)
- Express-based mock server for all AI APIs
- Supports Claude, OpenAI, Gemini, and Ollama endpoints
- OAuth flow mocking for authentication testing
- Request logging and response customization
- Can run standalone: `node test/mock/ai-mock-server.ts`
### 3. **Test Runner** (`test/run-integration-tests.ts`)
- Visual test execution with spinner animations
- Parallel test execution support
- Automatic Dev CLI building if needed
- JSON test result output
- Success rate calculation
### 4. **Demo Scripts**
- `test/demo-tests.js` - Shows all CLI features with example outputs
- `test/workflow-demo.js` - Animated workflow execution demo
- `test/run-all-tests.sh` - Comprehensive bash test suite
## Test Scenarios Covered
### Basic Commands
- ✅ Version check (`dev --version`)
- ✅ Help display (`dev --help`)
- ✅ Project initialization (`dev init`)
- ✅ Authentication flow (`dev login`)
### AI Tool Integration
- ✅ Single tool execution (`dev run claude "task"`)
- ✅ Tool comparison (`dev compare "task"`)
- ✅ Multi-agent tasks (`dev multi "task" --coder claude --reviewer gemini`)
- ✅ Local LLM support (`dev run local-llm "task" --model llama3`)
### Workflows
- ✅ Workflow listing (`dev workflow list`)
- ✅ Code review workflow
- ✅ Feature implementation workflow
- ✅ Optimization workflow
- ✅ Debug workflow
- ✅ Custom workflow support
### Advanced Features
- ✅ Async job management (`dev status`)
- ✅ Git worktree integration (`dev worktree list`)
- ✅ File review (`dev review [files]`)
- ✅ Parallel agent execution
## Running the Tests
### Quick Demo (No Build Required)
```bash
# Show feature demos
node demo-tests.js
# Show workflow animation
node workflow-demo.js
```
### Full Test Suite
```bash
# Run all tests with mock server
./test/run-all-tests.sh
# Run integration tests
npx ts-node test/run-integration-tests.ts
# Start mock AI server
node test/mock/ai-mock-server.ts
```
### Test with Real Build
```bash
# Build and test
make setup
make test
# Or manually
npm install
npm run compile
npm test
```
## Mock Server Endpoints
The mock server (`http://localhost:8888`) provides:
- **Claude**: `POST /v1/messages`
- **OpenAI/Codex**: `POST /v1/chat/completions`
- **Gemini**: `POST /v1beta/models/gemini-pro:generateContent`
- **Ollama**: `POST /api/generate`, `GET /api/tags`
- **Auth**: `GET /oauth/authorize`, `POST /oauth/token`
- **User**: `GET /api/user`, `GET /v1/api-keys`
## Test Output Examples
### Integration Test Output
```
🚀 Dev CLI Integration Test Suite
▶ Running: Version Command
✓ Passed: Version Command
▶ Running: Help Command
✓ Passed: Help Command
▶ Running: Init Command
✓ Passed: Init Command
📊 Test Summary:
✓ 3 passed
✗ 0 failed
```
### Workflow Demo Output
```
🔍 Running Code Review Workflow
[gemini] Gemini (Reviewer) ✓
[codex] Codex (Critic) ✓
[claude] Claude (Architect) ✓
[claude] Claude (Synthesizer) ✓
✓ Code review workflow completed!
```
## Chrome Headless Testing
The test suite includes Puppeteer tests for:
- OAuth login flow simulation
- Browser automation testing
- UI interaction verification
These tests are automatically skipped in CI or environments without display.
## Continuous Integration
The tests are designed to work in CI/CD pipelines:
- No interactive prompts
- Automatic timeout handling
- JSON output for parsing
- Exit codes for success/failure
## Future Test Additions
1. **Performance Testing**
- Response time measurements
- Parallel execution benchmarks
- Memory usage monitoring
2. **Error Handling**
- Network failure simulation
- Invalid input testing
- Timeout scenarios
3. **Integration Testing**
- Real AI API integration (with test keys)
- Git operations testing
- File system operations
4. **Security Testing**
- API key handling
- Credential encryption
- Input sanitization