anthonyrawlins
bd19709b31
docs: Add comprehensive documentation foundation (Phase 1: Architecture & Commands)
...
Created complete documentation infrastructure with master index and detailed
command-line tool documentation.
Documentation Structure:
- docs/comprehensive/README.md - Master index with navigation
- docs/comprehensive/architecture/README.md - System architecture overview
- docs/comprehensive/commands/chorus-agent.md - Autonomous agent binary (✅ Production)
- docs/comprehensive/commands/chorus-hap.md - Human Agent Portal (🔶 Beta)
- docs/comprehensive/commands/chorus.md - Deprecated wrapper (⚠️ Deprecated)
Coverage Statistics:
- 3 command binaries fully documented (3,056 lines, ~14,500 words)
- Complete source code analysis with line numbers
- Configuration reference for all environment variables
- Runtime behavior and execution flows
- P2P networking details
- Health checks and monitoring
- Example deployments (local, Docker, Swarm)
- Troubleshooting guides
- Cross-references between docs
Key Features Documented:
- Container-first architecture
- P2P mesh networking
- Democratic leader election
- Docker sandbox execution
- HMMM collaborative reasoning
- UCXL decision publishing
- DHT encrypted storage
- Multi-layer security
- Human-agent collaboration
Implementation Status Tracking:
- ✅ Production features marked
- 🔶 Beta features identified
- ⏳ Stubbed components noted
- ⚠️ Deprecated code flagged
Next Phase: Package documentation (30+ packages in pkg/)
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-30 13:49:46 +10:00
anthonyrawlins
e8d95b3655
feat(execution): Add Docker Hub image support and comprehensive documentation
...
- Updated ImageRegistry to use public Docker Hub (anthonyrawlins namespace)
- Modified image naming: chorus-base, chorus-rust-dev, chorus-go-dev, etc.
- Added Docker Hub URLs and actual image sizes to metadata
- Created comprehensive TaskExecutionEngine.md documentation covering:
* Complete architecture and implementation details
* Security isolation layers and threat mitigation
* Performance characteristics and benchmarks
* Real-world examples with resource usage metrics
* Troubleshooting guide and FAQ
* Comparisons with alternative approaches (SSH, VMs, native)
Images now publicly available at docker.io/anthonyrawlins/chorus-*
🤖 Generated with Claude Code (https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-30 13:26:31 +10:00
anthonyrawlins
aea4d45fd8
Implement Phase 2 & 3: Complete HAP Terminal Interface with Patch Management
...
🎭 Phase 2: HAP Terminal Interface Implementation
✅ **Core Terminal Interface**: Interactive command-driven HAP terminal with help system
✅ **HMMM Message Composition System**:
- New reasoning messages, thread replies, network queries, decision proposals
- Complete message metadata handling (topics, threads, timestamps)
✅ **UCXL Context Browsing System**:
- Address parsing, content retrieval from DHT encrypted storage
- Search functionality, content creation, history navigation
✅ **Decision Participation System**:
- Active decision listing, decision details with voting status
- Vote casting with reasoning, decision proposals, HMMM integration
🔧 Phase 3: Enhanced Human Workflows
✅ **Patch Creation and Submission Workflows**:
- Complete patch lifecycle management (create, review, submit, track)
- Multiple patch types (context, code, config, docs)
- UCXL integration with DHT storage, HMMM coordination
✅ **Time-Travel Diff Support**:
- Temporal navigation operators (~~<n>, ^^<n>, @<time>)
- Decision-hop analysis, visual diff display, version comparison
🏗️ **Architecture Highlights**:
- **Multi-binary structure**: Separate chorus-agent and chorus-hap binaries
- **Shared P2P runtime**: Both binaries use identical libp2p, DHT, HMMM, UCXL systems
- **Interactive sub-shells**: Dedicated command environments for HMMM, UCXL, patches, decisions
- **Network integration**: All features connect to distributed P2P agent network
- **Human-agent parity**: Humans participate as first-class network citizens
📦 **New Files**:
- internal/hapui/terminal.go: Complete HAP terminal interface (2400+ lines)
- prompts/human-roles.yaml: Role-based prompt configuration
- docs/decisions/*: HAP conversion decision record
🔗 **Integration Points**:
- HMMM: Collaborative reasoning and patch/decision announcements
- UCXL: Context addressing and version management
- DHT: Distributed storage of patches and content
- Decision System: Formal approval and consensus workflows
The HAP terminal interface now provides comprehensive human portal into the CHORUS
autonomous agent network, enabling collaborative reasoning, context sharing, patch
management, and distributed decision-making between humans and AI agents.
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-09-07 09:38:14 +10:00
