Commit Graph

23 Commits

  • docs: update README + CHANGELOG with v2.0.2 performance overhaul
    - README: header now shows v2.0.2 with Hermes/OpenCode/Ruflo sources
    - CHANGELOG: moved performance section to proper [2.0.2] version header
    - Added files changed list with line counts
    
    Co-Authored-By: zcode <noreply@zcode.dev>
  • fix: eliminate EADDRINUSE crash loop with robust port binding
    Root cause: fuser-based EADDRINUSE handler killed the current process
    due to a race condition during systemd restart cycles. The fuser command
    returned the current PID because the socket was half-open, and the guard
    condition (p !== process.pid) failed to filter it.
    
    Additionally, two competing systemd services (system-level and user-level)
    created a restart war where each instance killed the other.
    
    Fix approach (inspired by Next.js, Vite, webpack-dev-server):
    - Replace fuser with net.createServer port probe (no external commands)
    - PID-file based stale detection + ss fallback for orphan detection
    - Wait loop with 300ms polling after SIGTERM to stale process
    - Single-service architecture (disabled user-level unit)
    
    Tested: 5 consecutive rapid restarts, 8+ minute uptime, zero crashes.
    
    Co-Authored-By: zcode <noreply@zcode.dev>
  • docs: comprehensive documentation update for Ruflo integration
    - Updated README.md with complete feature documentation:
      * Added Hermes Agent × Claude Code × Ruflo × Opencode branding
      * Comprehensive feature list (24/7 bot, self-learning, voice I/O, self-evolve)
      * Multi-agent swarm system (9 agent roles, 3 topologies)
      * Plugin system (16 extension points)
      * Hook system (pre/post tool/AI/session)
      * Enhanced memory backend (JSON + LRU)
      * Full feature comparison table vs Hermes/Claude/Ruflo
      * Architecture diagrams
      * Usage examples for all commands
    
    - Updated package.json:
      * Bumped version to 2.0.0
      * Added comprehensive metadata (author, license, repository)
      * Added keywords for discoverability
      * Added support/funding links
    
    - Added INSTALLATION.md:
      * Complete setup guide (5-minute quick start)
      * Detailed installation steps (Node.js, ffmpeg, Python, Vosk)
      * Telegram bot configuration
      * Webhook setup (ngrok + domain)
      * Systemd service installation
      * Troubleshooting section
      * Advanced setup (Docker, multiple instances, SSL)
    
    - Added CREDITS.md:
      * Core project credits (Hermes Agent, Claude Code, Ruflo, Opencode)
      * Technology libraries (grammy, Express, Winston, Vosk, etc.)
      * Special thanks to NousResearch, Anthropic, RuvNet
      * Third-party license attribution
    
    - Added CONTRIBUTING.md:
      * How to contribute (bugs, features, docs, tests)
      * Development guidelines (code style, commit messages)
      * Architecture guidelines (plugins, hooks, agents)
      * Testing requirements
      * Security guidelines
      * Bug report and feature request templates
      * PR process and code review
    
    All documentation now reflects the complete Ruflo integration with 1,977 lines of new code.
  • docs: add zCode Swarm section to README
    - Full architecture diagram (ASCII)
    - 6 agent skills table
    - 4 coordination modes table
    - Advanced features list (neural, marketplace, dashboard, metrics, memory)
    - Quick start + configuration examples
    - Updated feature comparison table (3 new rows)
    - Updated summary with swarm description
    - Added swarm to integrations
  • fix: bulletproof command handler + auto-restart + README overhaul
    - sendStreamingMessage: replaced broken simulated streaming with reliable
      HTML send + stripped plain text fallback (was silently failing)
    - Added global unhandledRejection guard (catches async errors that
      sequentialize middleware would swallow)
    - restart.sh: auto-restart loop on crash (3s delay) instead of bare node
    - README: comprehensive update with self-learning memory, curiosity engine,
      memory architecture diagram, updated command table, updated comparison
  • docs: comprehensive README overhaul — streaming, self-correction, RTK, formatting
    - New streaming architecture section with ASCII pipeline diagrams
    - Self-correction loops documented (2 retries + backoff + auto-simplification)
    - RTK integration section (60-90% token savings)
    - Telegram HTML formatting system documented
    - Updated feature comparison table (all checkmarks accurate)
    - systemd service deployment guide added
    - Command reference table
    - Architecture flow diagrams
  • feat: full service exposure with grammy bot + claudegram patterns
    - Rewrote bot/index.js using grammy (@grammyjs/auto-retry + runner)
    - Added deduplication.js (adapted from claudegram)
    - Added request-queue.js (per-chat sequential processing)
    - Added message-sender.js (chunking + Markdown fallback)
    - Wired all JS-shim services: tools, skills, agents, config, RTK
    - Added function calling support to ZAIProvider.chat()
    - Added dynamic command routing (tools, skills, agents, model, stats)
    - Added per-agent delegation commands (/agent_coder, /agent_architect, etc.)
    - Added dedup + queue patterns from claudegram's battle-tested codebase
    - Updated zcode.js to pass agents to initBot()
    - Updated README feature comparison table to reflect real capabilities
  • docs: Add Z.AI banner with 10% OFF invite code
    - Add promotional banner after title with ROK78RJKNW code
    - Include direct link to z.ai/subscribe with invite code
    - Positioned prominently for visibility
    - Encourages Z.AI usage for AI-powered coding
  • feat: Complete zCode CLI X with Telegram bot integration
    - Add full Telegram bot functionality with Z.AI API integration
    - Implement 4 tools: Bash, FileEdit, WebSearch, Git
    - Add 3 agents: Code Reviewer, Architect, DevOps Engineer
    - Add 6 skills for common coding tasks
    - Add systemd service file for 24/7 operation
    - Add nginx configuration for HTTPS webhook
    - Add comprehensive documentation
    - Implement WebSocket server for real-time updates
    - Add logging system with Winston
    - Add environment validation
    
    🤖 zCode CLI X - Agentic coder with Z.AI + Telegram integration