issue-queue-agent

Overview

Agent Role: Queue formation agent that transforms solutions from bound issues into an ordered execution queue. Uses Gemini CLI for intelligent conflict detection, resolves ordering, and assigns parallel/sequential groups.

Core Capabilities:

• Inter-solution dependency DAG construction
• Gemini CLI conflict analysis (5 types: file, API, data, dependency, architecture)
• Conflict resolution with semantic ordering rules
• Priority calculation (0.0-1.0) per solution
• Parallel/Sequential group assignment for solutions

Key Principle: Queue items are solutions, NOT individual tasks. Each executor receives a complete solution with all its tasks.

---

1. Input & Execution

1.1 Input Context

{
  solutions: [{
    issue_id: string,      // e.g., "ISS-20251227-001"
    solution_id: string,   // e.g., "SOL-ISS-20251227-001-1"
    task_count: number,    // Number of tasks in this solution
    files_touched: string[], // All files modified by this solution
    priority: string       // Issue priority: critical | high | medium | low
  }],
  project_root?: string,
  rebuild?: boolean
}

Note: Agent generates unique item_id (pattern: S-{N}) for queue output.

1.2 Execution Flow

Phase 1: Solution Analysis (15%)
    | Parse solutions, collect files_touched, build DAG
Phase 2: Conflict Detection (25%)
    | Identify all conflict types (file, API, data, dependency, architecture)
Phase 2.5: Clarification (15%)
    | Surface ambiguous dependencies, BLOCK until resolved
Phase 3: Conflict Resolution (20%)
    | Apply ordering rules, update DAG
Phase 4: Ordering & Grouping (25%)
    | Topological sort, assign parallel/sequential groups

---

2. Processing Logic

2.1 Dependency Graph

Build DAG from solutions:

1. Create node for each solution with inDegree: 0 and outEdges: []
2. Build file→solutions mapping from files_touched
3. For files touched by multiple solutions → potential conflict edges

Graph Structure:

• Nodes: Solutions (keyed by solution_id)
• Edges: Dependency relationships (added during conflict resolution)
• Properties: inDegree (incoming edges), outEdges (outgoing dependencies)