This commit implements a comprehensive reorganization of project documentation
and adds explicit Gitea platform context throughout the project.
## Documentation Reorganization
### File Moves (Content Preserved)
- Moved CURSOR_WINDOWS_SETUP.md to kb/_guides/ for better organization
- Moved docs/PHASE-UPDATES/ to kb/_guides/PROJECT-SETUP-GUIDE/:
- COMPLETE-SYSTEM-REPLICATION-GUIDE.md
- PHASE-0-GITEA-UPDATES.md
- README.md
- Added new file: kb/_guides/PROJECT-SETUP-GUIDE/PHASE-1-PLAN.md
**Reason**: Consolidate project setup and configuration guides into the
knowledge base structure for better discoverability and organization.
### New Phase Documentation Structure
Created tendril/phases/ directory with structured phase documentation:
- phase-00-foundation/: blueprint, changelog, decisions, tasks
- phase-01-testing-validation/: blueprint, changelog, decisions, tasks
**Reason**: Establish consistent phase documentation structure following
project guidelines for phase management and tracking.
## Gitea Platform Context Integration
### .cursorrules Updates
- Added comprehensive Gitea platform context section
- Added Gitea documentation references for workflows and platform questions
- Added platform terminology guidelines (Gitea vs GitHub)
- Added references to docs/GITEA/ documentation throughout rules
**Reason**: Ensure all AI agents and contributors use correct Gitea terminology
and have clear guidance on where to find Gitea-specific documentation.
### Documentation Path Updates
- CONTRIBUTING.md: Updated CURSOR_WINDOWS_SETUP.md path reference
- docs/AGENT-GUIDELINES.md: Updated path references to moved documentation
- PROJECT_STATUS.md: Updated comment to mention Gitea Actions
**Reason**: Maintain link integrity after file reorganization and ensure
documentation references point to correct locations.
## Impact and Benefits
1. **Better Organization**: Documentation is now organized in logical
structures (kb/ for knowledge base, tendril/phases/ for phase docs)
2. **Clear Platform Context**: Explicit Gitea platform references prevent
confusion with GitHub terminology and provide clear documentation paths
3. **Consistent Structure**: Phase documentation follows standardized format
(blueprint, changelog, decisions, tasks) for easier maintenance
4. **Improved Discoverability**: Guides consolidated in kb/_guides/ make it
easier to find setup and configuration information
All file moves preserve content - no information was lost in this reorganization.
## Changes
### Binary Path Resolution Fix
- Explicit user configuration via gitea_mcp_binary_path now takes priority
- No longer fails fallback search if WASM sandbox restricts exists() checks
- User-configured path is returned directly, trusting the user's input
### Support Homebrew gitea-mcp-server Naming
- Add gitea-mcp-server binary name variant to all search paths
- Homebrew installs as 'gitea-mcp-server', not 'gitea-mcp'
- Search order now includes both binary names:
- /opt/homebrew/bin/gitea-mcp
- /opt/homebrew/bin/gitea-mcp-server (NEW)
- /usr/local/bin/gitea-mcp
- /usr/local/bin/gitea-mcp-server (NEW)
- And variants in all other search locations
- Both names checked in PATH environment variable
### Testing
- ✅ Manual path configuration works on Linux
- ✅ Auto-discovery works on Linux
- ✅ Homebrew binary detection on macOS M-series (gitea-mcp-server)
- ✅ Explicit path takes precedence
Fixes issue where Homebrew-installed binaries on macOS weren't being discovered.
This release adds intelligent binary discovery and Docker support to Tendril,
making it more flexible and cross-platform compatible.
## Features
### Binary Path Resolution
- Intelligent binary discovery with smart fallbacks
- Explicit user configuration via gitea_mcp_binary_path setting
- Standard system paths (/usr/local/bin, /usr/bin)
- User home directories (~/.local/bin, ~/.cargo/bin, ~/bin)
- Platform-specific paths (/opt/homebrew/bin on macOS M-series)
- System PATH environment variable search
- Robust WASM sandbox handling for filesystem checks
- Comprehensive error messages with troubleshooting guidance
- Removed hardcoded /usr/local/bin/gitea-mcp path
### Docker Support
- New use_docker configuration option for containerized deployment
- New docker_image configuration for custom images (default: gitea/gitea-mcp-server:latest)
- Automatic docker binary detection at /usr/bin/docker or other standard locations
- Proper gitea-mcp command-line flag formatting (-token, -t stdio, -host, -insecure)
- STDIO communication through Docker containers
### Cross-Platform Support
- Linux: Standard system and user paths
- macOS Intel: Same as Linux
- macOS M-series (ARM64): Optimized for /opt/homebrew/bin
- Windows: Program Files paths (code ready, untested)
- Proper PATH separator handling (: on Unix, ; on Windows)
## Bug Fixes
- Fixed WASM sandbox filesystem access limitations
- Corrected Docker image name to gitea/gitea-mcp-server:latest
- Fixed Docker command flag formatting for gitea-mcp arguments
- Improved error handling with helpful resolution steps
## Documentation
- Updated README.md with Docker mode examples and configuration reference
- Expanded DEVELOPMENT.md with architecture and testing roadmap
- Updated PROJECT_STATUS.md with v0.1.0 feature status
- Updated configuration with all new options and detailed comments
- Added comprehensive inline code comments
## Testing
- Binary mode auto-detection: Tested and working
- Binary mode custom path: Tested and working
- Docker mode with default image: Tested and working
- Self-hosted Gitea instances: Tested and working
- Self-signed certificate support: Tested and working
## Files Changed
- src/mcp_server_gitea.rs: Core extension (~350 lines)
- configuration/default_settings.jsonc: New settings
- configuration/installation_instructions.md: Updated guide
- README.md: Expanded documentation
- DEVELOPMENT.md: Complete developer guide
- PROJECT_STATUS.md: Updated status
- .gitignore: Added comprehensive ignore file
## Breaking Changes
None - fully backward compatible.
## Next Steps (v0.2.0)
- Cross-platform testing
- Interactive configuration wizard
- Performance optimizations
- Marketplace publication
