extension/docs/FEATURE_PARITY.md

Feature Parity Between Python MCP and TypeScript Extension

This document tracks the feature parity between the Python MCP implementation (~/work/hanzo/mcp) and the TypeScript extension (~/work/hanzo/extension).

Tool Parity Status

✅ Fully Implemented in Both

Tool Category	Tool Name	Python MCP	TypeScript Extension	Notes
File System	read	✅	✅
	write	✅	✅
	edit	✅	✅
	multi_edit	✅	✅
	directory_tree	✅	✅
	find_files	✅	✅
	grep	✅	✅
	git_search	✅	✅	Newly added
	content_replace	✅	✅	Newly added
	diff	✅	✅	Newly added
Search	symbols	✅	✅
	search	✅	✅	Unified search
	batch_search	✅	✅	Newly added
Shell	bash	✅	✅	Newly added
	run_command	✅	✅
	run_background	✅	✅	Newly added
	processes	✅	✅	Newly added
	pkill	✅	✅	Newly added
	logs	✅	✅	Newly added
	npx	✅	✅	Newly added
	uvx	✅	✅	Newly added
	open	✅	✅
Development	todo	✅	✅	Unified
	think	✅	✅
	critic	✅	✅	Newly added
AI/LLM	llm	✅	✅	Newly added
	consensus	✅	✅	Newly added
	agent	✅	✅	Newly added
	mode	✅	✅	Newly added
Database	sql_query	✅	✅
	sql_search	✅	✅
	sql_stats	✅	✅
	graph_*	✅	✅	Graph operations
Vector	vector_index	✅	✅
	vector_search	✅	✅
Utility	batch	✅	✅	Newly added - consolidated tool
	web_fetch	✅	✅
	rules	✅	✅
	config	✅	✅
System	stats	✅	✅
	tool_enable	✅	✅
	tool_disable	✅	✅
	tool_list	✅	✅
MCP	mcp	✅	✅	Newly added - manage arbitrary MCP servers

🚧 Python-Only Tools (Not Implemented in TypeScript)

Tool	Reason	Priority
watch	File watching in VS Code is limited	Low
neovim_*	Editor-specific tools	Low
mcp_*	MCP management tools	Medium

🚧 TypeScript-Only Tools

Tool	Reason	Priority
zen	VS Code specific implementation	N/A
palette	VS Code command palette integration	N/A

Test Coverage

New Test Files Added

1. batch-tools.test.ts

   • Sequential and parallel batch execution
   • Error handling and timeout support
   • Batch search with deduplication
   • Tool handler registration

2. ai-tools.test.ts

   • LLM provider integration (OpenAI, Anthropic, local)
   • Consensus mechanism across multiple LLMs
   • Agent delegation with different personalities
   • Development mode management

3. bash-tools.test.ts

   • Command execution with sessions
   • Background process management
   • Process monitoring and logging
   • NPX and UVX package runners

Key Improvements Made

1. Batch Tool Enhancement

   • Proper tool handler registration system
   • Support for parallel and sequential execution
   • Timeout handling per operation
   • Detailed execution results

2. AI Tools Integration

   • Unified LLM interface for multiple providers
   • Consensus mechanism for multi-LLM queries
   • Development mode system with 10+ personalities
   • Agent delegation for specialized tasks

3. Shell Tools Expansion

   • Full bash session support with persistence
   • Background process management
   • Process monitoring and log streaming
   • Package runner integration (npx, uvx)

4. Search Tools Enhancement

   • Git history and diff search
   • Content replacement across files
   • Batch search operations
   • File watching (limited implementation)

Authentication & Cloud Features

• ✅ Standalone authentication against iam.hanzo.ai
• ✅ Anonymous mode (--anon) for local-only usage
• ✅ OAuth flow with device ID generation
• ✅ Token refresh mechanism

Platform Support

• ✅ VS Code Extension
• ✅ Cursor IDE
• ✅ Windsurf IDE
• ✅ Claude Desktop
• ✅ Claude Code (via DXT)
• ✅ Standalone CLI via npx

Build System

All build targets are supported:

• npm run build - Standard VS Code extension
• npm run build:claude-desktop - Claude Desktop MCP server
• npm run build:dxt - Desktop Extension package
• npm run build:all - All targets

GitHub Actions automatically builds and releases all versions on tag push.

Next Steps

1. Performance Optimization

   • Implement caching for frequently used tools
   • Optimize batch operations for large datasets
   • Add streaming support for long-running operations

2. Enhanced Testing

   • Add integration tests for cross-tool workflows
   • Add performance benchmarks
   • Increase test coverage to >90%

3. Documentation

   • Complete API documentation for all tools
   • Add more usage examples
   • Create video tutorials

4. Feature Additions

   • Implement remaining Python-only tools if needed
   • Add more AI agent personalities
   • Enhance consensus mechanism with voting strategies