feat(council): add Consensus Summary layer for multi-agent output (#1263)

[JeremyDev87]

Summary

• Define CouncilSummary, Disagreement, CouncilInput types for structured consensus output
• Implement generateCouncilSummary service: aggregates opinions, detects consensus/disagreements, extracts blocking risks, recommends next step
• Handle partial failures gracefully — degraded but useful summary when specialists fail
• 11 test cases covering normal, partial failure, no-disagreement, blocker-heavy, and edge cases

Test plan

• Normal case: all specialists respond → full summary with opinions, consensus, disagreements
• Partial failure: 1+ specialist fails → degraded summary still produced
• No disagreement: all agree → empty disagreements array
• Blocker-heavy: multiple reject-stance agents → all blocking risks collected
• nextStep always present even on total failure
• Edge case: empty input, shared suggested changes

Closes #1263

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
codingbuddy-landing	Ready	Preview, Comment	Apr 4, 2026 1:53am

[JeremyDev87]

Review: APPROVE ✅

CI Status: ALL PASS (25/25)

Code Quality

• Pure function generateCouncilSummary — no side effects, no I/O
• CouncilSummary type: readonly properties throughout for immutability
• Clean separation: types in .types.ts, logic in .service.ts
• Graceful partial failure: failed agents tracked, degraded summary still produced
• determineNextStep priority chain: blockers > failures > concerns > proceed
• Shared suggestion detection across agents
• Barrel export in index.ts

Tests (11)

• All specialists respond → full summary
• Partial failure (1+ fail) → degraded summary
• Single survivor → still works
• No disagreement → empty disagreements
• Blocker-heavy → blocking risks collected
• Total failure → meaningful nextStep
• Empty input → safe defaults
• Shared suggestions → detected in consensus

No Issues Found

• No unused imports/variables
• No any types
• Reuses existing AgentOpinion and Stance types from ./types

Recommendation: APPROVE