feat(forge): Enhanced agent orchestration validation system with /forge command

[echobt]

Summary

This PR introduces the Forge Orchestration System, a comprehensive modular framework for code validation through specialized agents. Each agent validates specific aspects of the codebase and returns structured JSON responses indicating rule compliance.

Features

🔧 Core Orchestration System

• DAG-based Agent Execution: Agents can have dependencies, allowing conditional execution flows
• Parallel Execution: Configurable concurrent agent execution with max_parallel setting
• Fail-fast Mode: Option to stop on first failure or continue all validations

🤖 Validation Agents

Three built-in agents with extensible architecture:

Agent	Purpose
SecurityAgent	Detects secrets, audits dependencies, checks unsafe code
QualityAgent	Validates TODOs, unwrap usage, documentation coverage
AggregatorAgent	Combines results, generates recommendations, triggers actions if all pass

📋 Modular Configuration (TOML)

All agent behavior is controlled via modifiable TOML configuration files:

.cortex/forge/
├── forge.toml                 # Global orchestration settings
└── agents/
    ├── security/rules.toml    # Security rules & patterns
    ├── quality/rules.toml     # Quality checks configuration
    └── aggregator/rules.toml  # Aggregation thresholds

📊 JSON Protocol

Agents respond with structured JSON for machine-readable validation:

{
  "status": "pass|warning|fail",
  "agent_id": "security",
  "rules_applied": [...],
  "findings": [{
    "severity": "error|warning|info",
    "message": "Description",
    "location": { "file": "...", "line": 42 },
    "suggestion": "How to fix"
  }]
}

🖥️ TUI Dashboard

Interactive dashboard via /forge command showing:

• Real-time agent execution status
• Findings list with severity highlighting
• Progress bar for overall validation
• Detailed finding inspection

🔗 Slash Command Integration

New /forge command for validation orchestration

Files Changed

New Modules

• src/cortex-agents/src/forge/ - Core orchestration
  • protocol.rs - Validation protocol (JSON serialization)
  • orchestrator.rs - DAG-based execution engine
  • config.rs - TOML configuration loader
  • agents/ - Built-in validation agents
• src/cortex-engine/src/commands/forge.rs - Slash command
• src/cortex-tui/src/views/forge.rs - Dashboard view

Configuration Files

• .cortex/forge/forge.toml - Global settings
• .cortex/forge/agents/*/rules.toml - Per-agent rules

Testing

• ✅ cargo check passes
• ✅ cargo fmt applied
• ✅ Unit tests for protocol serialization
• ✅ Unit tests for validation status logic