109 Commits

This Branch

This Branch

All Branches

• docs: add documentation structure diagram and changelog

  Added comprehensive documentation infrastructure:
  
  1. DOCUMENTATION_STRUCTURE.md (31,736 bytes, 399 lines)
     - ASCII art visualization of documentation hierarchy
     - File structure tree diagram
     - Documentation coverage matrix
     - Documentation flow diagram
     - Cross-reference map
     - Statistics and metrics
     - Visual organization for easy navigation
  
  2. CHANGELOG.md (9,863 bytes, 308 lines)
     - Follows Keep a Changelog format
     - Documents v2.0.0 major release (Ruflo integration)
     - Lists all added features (multi-agent swarm, plugin system, hooks, enhanced memory)
     - Documents 6 new tools (swarm_spawn, swarm_execute, etc.)
     - Details documentation updates (README, INSTALLATION, CREDITS, CONTRIBUTING)
     - Includes feature comparison table
     - Notes on breaking changes, migration guide
     - Unreleased section for v2.1.0 and v2.2.0
  
  Documentation Statistics:
  - Total: 13 files
  - Size: 134,636 bytes (131.5 KB)
  - Lines: 3,766 lines
  - Average: 10,356 bytes/file, 289 lines/file
  
  All documentation now fully complete and professional-grade!

  admin · 2026-05-06 10:11:52 +00:00
  b6bbeaf449
• docs: add repository update summary

  Document the comprehensive documentation update for Ruflo integration:
  - README.md rewrite (1,180 lines changed)
  - package.json enhancement (55 lines)
  - New INSTALLATION.md (545 lines)
  - New CREDITS.md (309 lines)
  - New CONTRIBUTING.md (461 lines)
  - Total: 1,934 lines added, 616 removed
  - 100% feature coverage
  - All credits and licenses attributed

  admin · 2026-05-06 10:09:17 +00:00
  5db516b87c
• 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.

  admin · 2026-05-06 10:08:36 +00:00
  53b9fa8c8a
• test: add comprehensive smoke test for Ruflo-inspired systems

  Test coverage:
  - PluginSystem: 10 assertions (load, unload, extension points)
  - HookSystem: 4 assertions (pre/post tool, pre/post AI)
  - AgentSystem: 9 assertions (creation, capabilities, tasks)
  - SwarmCoordinator: 12 assertions (spawn, execute, distribute, terminate)
  - AgentOrchestrator: 4 assertions (single/multi-agent execution)
  - MemoryBackend: 14 assertions (JSON + InMemory, LRU, TTL, search)
  
  Total: 53 assertions, all passing.
  
  This validates that all 1977 lines of Ruflo-inspired code work correctly at runtime.

  admin · 2026-05-06 09:59:30 +00:00
  24d2da0b2d
• fix: resolve smoke test failures

  - Fixed memory backend API: getAll() now includes all memory types (lesson, gotcha, pattern, preference, discovery, context, ephemeral)
  - Fixed memory test assertions: use MEMORY_TYPES.LESSON instead of undefined FACT, await retrieve() calls
  - Added getAll() method to JSONBackend for grouped memory access
  - Fixed InMemoryBackend to support all memory types in getAll()
  - Fixed smoke test to properly await async methods and check correct properties

  admin · 2026-05-06 09:55:48 +00:00
  416dedb94b
• feat: massive Ruflo-inspired upgrade — plugin system, multi-agent swarm, hooks, enhanced memory

  New systems (src/plugins/):
    - Plugin.js: lifecycle hooks (onLoad, onUnload, onConfigChange) + BasePlugin
    - PluginManager.js: fault-isolated extension point dispatch with metrics
    - PluginLoader.js: dependency-resolving batch loader with health checks
    - ExtensionPoints.js: 16 standard extension point names
  
  New systems (src/bot/):
    - hooks.js: HookManager with pre/post tool, pre/post AI, session lifecycle
    - memory-backend.js: JSONBackend (typed entries + LRU) + InMemoryBackend (ephemeral with TTL)
  
  New systems (src/agents/):
    - Agent.js: typed agents with capabilities, status tracking
    - Task.js: DAG-compatible tasks with priorities, dependencies, rollback
    - SwarmCoordinator.js: multi-agent orchestration (simple/hierarchical/swarm topologies)
    - agents/index.js: 9 agent roles + AgentOrchestrator
  
  Bot integration (src/bot/index.js):
    - 6 new Ruflo-inspired tools: swarm_spawn, swarm_execute, swarm_distribute, swarm_state, swarm_terminate
    - Plugin system, hook system, swarm initialized in initBot
    - Pre/post tool hooks wired into tool execution
    - Ephemeral + persistent memory backends
    - Agent orchestrator with 9 specialized agent types
    - Graceful shutdown: all systems cleanup, conversation flush, pidfile release
    - Return object exposes pluginManager, swarm, hookManager, memBackend, agentOrchestrator, getState
  
  This brings Ruflo's multi-agent architecture, plugin extensibility, hook-based lifecycle, and typed memory to zCode.

  admin · 2026-05-06 09:22:21 +00:00
  dcd01da1b1
• backup: before ruflo integration (plugins + multi-agent + hooks)
  admin · 2026-05-06 09:00:31 +00:00
  321279b430
• backup: before performance rewrite
  admin · 2026-05-06 08:45:43 +00:00
  9615b0ba98
• 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

  admin · 2026-05-06 08:20:29 +00:00
  5908239ce9
• feat: add zCode Swarm — multi-agent orchestration system

  - 6 agent skills: code-review, performance, security, architecture, test, git
  - 4 coordinator modes: hierarchical, mesh, gossip, consensus
  - Federated memory system (6 namespaces)
  - Neural network agent recommendation
  - Agent marketplace (plugin discovery/install)
  - Real-time dashboard + performance metrics
  - CRDT-based sync for decentralized modes
  - 22 files, ~1400 lines total
  
  Inspired by ruflo distributed multi-agent patterns.

  admin · 2026-05-06 07:59:19 +00:00
  68cfeb5cba
• feat: enterprise-grade agentic loop — 50 turns, stuck detection, context compaction, progress feedback

  - MAX_TOOL_TURNS: 10 → 50 (complex tasks need more room)
  - max_tokens: 4096 → 8192 (longer responses, better summaries)
  - Tool result limit: 8000 → 16000 chars (less truncation)
  - Stuck detection: 3x same tool+args pattern → intervention
  - Context compaction: every 15 turns, trims old tool results
  - Progress feedback: user sees step count during tool loops
  - Error recovery: don't give up on mid-loop errors, inject recovery msg
  - Max-turns: requests structured summary + next steps (not silent quit)
  - SSE timeouts: 90s→180s fetch, 30s→45s idle, 2→4 retries
  - Self-correction: clone messages instead of mutating originals

  admin · 2026-05-05 20:18:29 +00:00
  129d4a6def
• fix: handle truncated tool call JSON — guide model to use bash heredoc for large files

  When file_write gets a 15KB+ HTML payload, the streaming JSON gets
  truncated. Now catches JSON parse errors and returns a specific
  hint to use bash heredoc instead of silently failing.

  admin · 2026-05-05 20:12:15 +00:00
  7d82eff753
• feat: add infrastructure context to zCode system prompt

  Non-secret only: Gitea repo URL, systemd service name, deploy workflow,
  self-evolve push behavior. Zero credentials in source.

  admin · 2026-05-05 19:47:30 +00:00
  91165bf6d1
• docs: add persistent typing indicator to README
  admin · 2026-05-05 19:29:57 +00:00
  ac5de0df28
• fix: keep typing indicator alive during entire response (not just until first token)

  The old logic stopped typing on first stream token, leaving tool
  execution gaps (30s+) with zero visual feedback. Now typing persists
  until the full response + streaming edits are complete.

  admin · 2026-05-05 19:21:01 +00:00
  00264a37e4
• fix: add typing indicator debug logging
  admin · 2026-05-05 19:05:06 +00:00
  09f5ce080b
• feat: persistent typing indicator — refreshes every 4s until first stream token arrives
  admin · 2026-05-05 18:59:08 +00:00
  709071106c
• feat: persistent typing indicator — refreshes every 4s until first stream token
  admin · 2026-05-05 18:46:32 +00:00
  145f49b28a
• restore: 2026-05-05T18-26-18-915Z__index.js
  admin · 2026-05-05 18:26:20 +00:00
  eb158ce089
• test: full suite backup verification
  admin · 2026-05-05 18:26:19 +00:00
  6aadeb3a35
• checkpoint: before self-evolve self-evolve-1778005578572
  admin · 2026-05-05 18:26:18 +00:00
  d520d8d41e
• checkpoint: before self-evolve self-evolve-1778005525695
  admin · 2026-05-05 18:25:26 +00:00
  20c784597c
• restore: 2026-05-05T18-25-07-009Z__index.js
  admin · 2026-05-05 18:25:08 +00:00
  f3ff7a30ee
• test: full suite backup verification
  admin · 2026-05-05 18:25:07 +00:00
  e5256da10b
• checkpoint: before self-evolve self-evolve-1778005506674
  admin · 2026-05-05 18:25:06 +00:00
  b51d4fa59d
• docs: self-evolution section + feature comparison table
  admin · 2026-05-05 18:22:52 +00:00
  999770b75c
• checkpoint: before self-evolve self-evolve-1778005211558
  admin · 2026-05-05 18:20:11 +00:00
  73e3e0a439
• restore: 2026-05-05T18-18-15-895Z__index.js
  admin · 2026-05-05 18:19:22 +00:00
  26de119a1b
• fix: destructure backup_id in execute()
  admin · 2026-05-05 18:18:59 +00:00
  e80cd21973
• test: verify auto-backup before patch
  admin · 2026-05-05 18:18:16 +00:00
  1870635847
• checkpoint: before self-evolve self-evolve-1778005095485
  admin · 2026-05-05 18:18:15 +00:00
  076b30eda9
• fix: remove undefined logger reference in SelfEvolveTool
  admin · 2026-05-05 18:17:49 +00:00
  c97e42e052
• checkpoint: before self-evolve self-evolve-1778005033751
  admin · 2026-05-05 18:17:14 +00:00
  5ccae14bc7
• feat: file-level backups for self-evolve — auto-backup before every patch, backups/restore actions
  admin · 2026-05-05 18:15:29 +00:00
  8d904af246
• feat: SelfEvolveTool — self-modifying code with auto-rollback

  Safety chain: git stash → checkpoint → apply patch → syntax check → restart → health check → smoke test → rollback on ANY failure
  Protected files: SelfEvolveTool.js, stt.py cannot be self-modified
  Rate limit: 1 evolve per 60s
  Max file size: 50KB per edit

  admin · 2026-05-05 18:09:56 +00:00
  cfa92c81b0
• fix: voice STT path fix + execSync error handling + fetch download
  admin · 2026-05-05 17:56:22 +00:00
  3bfd842998
• feat: add Vosk STT - offline voice-to-text, no API key needed
  admin · 2026-05-05 17:50:50 +00:00
  3b6a7ec502
• docs: add Intelligence Routing section to README
  admin · 2026-05-05 17:46:24 +00:00
  6685f60855
• fix: rewrite chatWithAI as unified agentic tool loop

  OLD: streaming and non-streaming were separate paths. Streaming detected tool
  calls and recursively called non-streaming which only did ONE round of tool
  execution with no loop-back. This caused silent hangs.
  
  NEW: single chatWithAI with internal while loop (max 10 turns):
    1. Call API (stream or non-stream)
    2. If tool_calls → execute all → append results → loop
    3. If text content → return final answer
  
  Key fixes:
  - streamChat now ACCUMULATES tool_call deltas instead of aborting
  - Tool results are fed back to the AI in the same conversation
  - Multi-turn: AI can call tools multiple times before answering
  - Max 10 turns with forced final answer as safety net
  - Proper { content, tool_calls, error } return type from both paths
  - Non-streaming fallback if SSE fails
  - No more recursive calls between stream/non-stream

  admin · 2026-05-05 17:12:16 +00:00
  fe6d3f4db8
• fix: non-streaming tool calls now feed results back to AI for final answer

  Previously tool calls in non-streaming path returned raw tool output as the
  response. Now executes tool, sends results back to model for a synthesized
  answer. Fixes the 'silent after streaming fallback' bug.

  admin · 2026-05-05 17:09:32 +00:00
  78349bb22b
• feat: add DelegateTool with multi-turn agentic loop (18 tools total)

  - DelegateTool.js: multi-turn sub-agent (max 10 turns), feeds tool results back
  - Moved TOOL_DEFS to startBot scope so delegate handler can access tool schemas
  - Fixed scoping: delegate handler resolves model from svc.config instead of chatWithAI local
  - Wired into tools/index.js, TOOL_DEFS, and toolHandlers

  admin · 2026-05-05 16:59:59 +00:00
  092fefbc52
• feat: add vision, TTS, and browser tools (17 tools total)

  - VisionTool: image analysis via Z.AI GLM-4V multimodal API
  - TTSTool: text-to-speech via node-edge-tts (free, auto-sends audio to chat)
  - BrowserTool: web page content extraction via cheerio (strips HTML, extracts text)
  - All 3 wired into tools/index.js + bot tool definitions + handlers
  - TTS handler auto-sends generated audio as voice message to chat

  admin · 2026-05-05 16:52:12 +00:00
  e92e9f5b9d
• feat: real agent execution + real skill execution (system-prompt-driven)

  - delegate_agent: now makes actual AI call with role-specific system prompts
    (coder=code review, architect=system design, devops=infrastructure)
  - run_skill: now makes actual AI call with skill-specific system prompts
    (code_review, bug_fix, refactor, documentation, testing)
  - Both return structured AI-generated results instead of placeholder text

  admin · 2026-05-05 16:45:06 +00:00
  d7f1e3db90
• feat: wire 10 new tools — file_read, file_write, glob, grep, web_fetch, task CRUD, send_message, schedule_cron

  - 10 new JS tool classes in src/tools/ (clean, no framework deps)
  - tools/index.js: registry-based init with env toggles
  - bot/index.js: 16 tool definitions + 16 handlers (was 4)
  - Added glob npm dependency
  - Tools: bash, file_edit, file_read, file_write, glob, grep, web_search, web_fetch, git, task_create/update/list, send_message, schedule_cron, delegate_agent, run_skill

  admin · 2026-05-05 16:43:05 +00:00
  0a81aa2b82
• fix: handle tool calls in streaming mode - fall back to non-streaming

  Model says "let me research" then calls web_search tool.
  Streaming path ignored tool_calls entirely (no-op comment).
  Now: detect tool_calls delta, cancel stream, fall back to non-streaming
  which properly executes tools and returns results.

  admin · 2026-05-05 16:31:59 +00:00
  78d994fdda
• fix: markdownToHtml multiline bold — [\s\S] instead of dot

  GLM outputs multi-line **bold** blocks in essays. The dot regex .+?
  does not match newlines, so multiline bold rendered as raw **.

  admin · 2026-05-05 16:28:35 +00:00
  316f3115f6
• fix: delete+resend streaming draft instead of edit with HTML parse_mode switch

  Telegram rejects parse_mode changes on existing messages.
  Old: editMessageText with HTML on a plain-text message → silent fail, raw ** shown.
  New: deleteMessage + sendFormatted (fresh HTML) → always renders bold/italic correctly.

  admin · 2026-05-05 16:24:32 +00:00
  5cc00aa4fe
• fix: pidfile lock + port conflict guard + systemd ready

  - Pidfile lock prevents duplicate instances (auto-kills stale PIDs)
  - EADDRINUSE retry: kills port hog, retries up to 3x with 1.5s delay
  - releasePidfile() on graceful shutdown
  - Added fs/path imports needed by pidfile utilities

  admin · 2026-05-05 16:20:00 +00:00
  9537bf2dc4
• perf: 3-tier conversation context with LRU cache, keyword relevance, debounced I/O

  UPGRADE from naive JSON to production-grade conversation memory:
  
  Tier 1 — Compressed Summary (max 600 chars):
    Incrementally built from evicted messages. Preserves conversation
    topics across 100+ messages in a tiny budget.
  
  Tier 2 — Relevant Snippets (BM25-style keyword matching):
    Scores older messages against current query, injects top 3 matches.
    Zero external deps — keyword extraction is ~0.1ms.
  
  Tier 3 — Sliding Window (last 12 exchanges verbatim):
    Recent context preserved word-for-word, fitting within token budget.
  
  Performance optimizations:
    - In-memory Map cache with lazy-load from disk (0ms reads)
    - Debounced async disk writes (3s, non-blocking, never stalls response)
    - LRU eviction for cache (max 50 chats, prevents memory leak)
    - Keywords stripped before saving (smaller JSON files)
    - Backward-compatible: loads old format without keywords, backfills on load
    - Graceful shutdown flushes all pending saves to disk
    - Token-aware budget allocation: summary 15% + relevant 15% + recent 70%

  admin · 2026-05-05 15:51:24 +00:00
  4ebd7acca7
• feat: persistent conversation history across sessions and restarts

  - ConversationStore: per-chat JSON files in data/, survives restarts
  - 6000 token budget per chat context (fits ~20-30 exchanges)
  - Auto-trims old messages, always includes most recent
  - Wired into message handler: loads history before AI call, saves after
  - /reset command to clear chat history per chat
  - Cross-session, cross-model, cross-chat isolation

  admin · 2026-05-05 15:47:14 +00:00
  c1a3090f7d