Skip to content

chore: release v1.1 with E2E tested improvements and fixes#1

Merged
joakimriedel merged 5 commits into
mainfrom
feature/v1.1-release
Nov 19, 2025
Merged

chore: release v1.1 with E2E tested improvements and fixes#1
joakimriedel merged 5 commits into
mainfrom
feature/v1.1-release

Conversation

@joakimriedel

@joakimriedel joakimriedel commented Nov 19, 2025

Copy link
Copy Markdown
Member

AgentHub v1.1 Release

This release includes comprehensive improvements based on extensive end-to-end testing, addressing usability, documentation, and notification issues.

🎯 Key Improvements

🐛 Bug Fixes

  • Parameter Consistency: Intent operations (i.renew, i.vote, i.close) now accept both id and intentId variants for better CLI compatibility
  • Vote Values: Documentation and schemas updated to correctly reflect ack/nack values with approve/defer aliases
  • Queue Position: Expert requests now report accurate global queue position
  • Conflict Notifications: Agents now receive inbox notifications when conflicts occur
  • State Verbosity: Added summary filter to s.get for minimal output

✨ New Features

  • Async Expert System: Robust job queue with background worker for Azure OpenAI integration
  • Enhanced Dashboard v2:
    • Zoomable grid layout with keyboard navigation (keys 1-5)
    • Expert panel for monitoring AI consultations
    • Reviews panel for code review lifecycle
    • Interactive cleanup (press 'c')
  • Structured Logging: Pino-based JSON logging with pretty-printing in development
  • Orphaned Artifact Cleanup: Automatic removal of zombie intents/reviews when agents disconnect
  • Inbox Hints: Unread message count shown on agent registration

📝 Documentation

  • Comprehensive help system (s.help) with field variants
  • Clear indication when review jobs are auto-created on intent close
  • Improved README with correct installation instructions

📊 Changes Summary

  • 56 files changed, 4827 insertions(+), 1271 deletions(-)
  • Major improvements to expert system (expert-worker.ts, expert-bridge.ts)
  • Enhanced dashboard with new panels and zoom functionality
  • Comprehensive test coverage additions

🧪 Testing

  • All 16 MCP operations verified working correctly
  • Multi-agent coordination tested with concurrent agents
  • Conflict detection and resolution validated
  • Expert system integration confirmed functional
  • Dashboard functionality verified

🔄 Breaking Changes

None - All changes maintain backward compatibility

📦 Dependencies

  • Added pino and pino-pretty for structured logging
  • Dashboard improvements with Ink v5

🤖 Generated with Claude Code

joakimriedel and others added 3 commits November 17, 2025 18:46
- Fix dashboard responsiveness for small screens (single column < 120 cols)

- Rewrite README.md for public release (add Quick Links, Workflow Guide)

- Fix ExpertStatusPayload duplicate type error

- Fix Dashboard terminal clearing on start

- Remove legacy ExpertAskPayload code
- Fix parameter name consistency (id/intentId variants)
- Update vote values documentation (ack/nack)
- Add conflict notifications to agents
- Improve expert queue position accuracy
- Add s.get verbosity control with summary filter
- Update help documentation with correct field names
- Add inbox hints for unread messages

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings November 19, 2025 13:22
Comment thread src/server/core/coordinator.ts
Comment thread src/server/core/expert-worker.ts
Change "Review conflict" to "Intent conflict detected" for clarity
as suggested in PR review

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This release (v1.1) represents a significant evolution of AgentHub with comprehensive E2E testing and major architectural improvements. The PR successfully transitions from synchronous to asynchronous expert consultation, implements structured logging with Pino, and delivers an enhanced dashboard with zoomable panels.

Key Changes:

  • Refactored expert system from synchronous expert.ask to async job queue (expert.request, expert.status, expert.cancel, expert.list)
  • Replaced all console.log calls with structured Pino logging for better observability
  • Dashboard v2 with 2-column grid layout, panel zoom (keys 1-5), and new Review/Expert panels
  • Increased default intent TTL from 2 minutes to 10 minutes based on E2E feedback
  • Added orphaned artifact cleanup and better session management

Reviewed Changes

Copilot reviewed 54 out of 56 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/server/types/models.ts Extended with expert request types, message types, and enhanced review/state models
src/server/transports/http.ts Migrated logging to Pino, added admin cleanup endpoint
src/server/tools/state.ts Added filter support for s.get operation
src/server/tools/review.ts Added review.list operation and claim expiration tracking
src/server/tools/messages.ts Enhanced message filtering (type, topic, includeSelf)
src/server/tools/intents.ts Added default TTL support and TTL warnings
src/server/tools/help.ts Updated documentation with correct parameter names and examples
src/server/tools/expert.ts Complete rewrite for async expert system with 4 operations
src/server/tools/agents.ts Improved session binding logic for idempotent registration
src/server/server.ts Added new operations, passed config for TTL defaults
src/server/schemas/ Updated all schemas for field variants and better validation
src/server/core/logger.ts New Pino logger module
src/server/core/expert-worker.ts New background worker for async expert requests
src/server/core/expert-bridge.ts Refactored for background mode with polling
src/server/core/state-cache.ts Added expert request management and cleanup methods
src/server/core/coordinator.ts Added conflict notifications and TTL warnings
src/server/core/bus.ts Enhanced message filtering with type/topic support
src/server/core/watcher.ts Migrated to structured logging
src/server/index.ts Added expert worker initialization
src/dashboard/ Complete v2 redesign with zoomable panels
README.md Streamlined for clarity with quick start focus
CHANGELOG.md Comprehensive v1.1 release notes
package.json Added Pino dependencies, updated scripts
server.json Updated MCP schema URL and registry type format

The changes are well-structured, maintain backward compatibility where appropriate, and demonstrate thorough testing. The code quality is high with proper TypeScript usage and comprehensive error handling.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@joakimriedel joakimriedel changed the title Release v1.1: E2E tested improvements and fixes chore: release v1.1 with E2E tested improvements and fixes Nov 19, 2025
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@joakimriedel joakimriedel merged commit d386ab6 into main Nov 19, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants