Skip to content

PROGRESS.md

Latest commit

 

History

History
101 lines (77 loc) · 2.77 KB

PROGRESS.md

File metadata and controls

101 lines (77 loc) · 2.77 KB

CodeCourt - Progress Tracker

Current Status

Phase: 3 - Advanced Features (In Progress)
Next Up: Debate System (Defender/Prosecutor/Judge)
Last Updated: 2026-03-15

Phase 1: Foundation ✅

1.1 Project Setup

  • Initialize monorepo structure
  • Set up Python package with pyproject.toml
  • Set up TypeScript package with package.json
  • Create docs/ROADMAP.md, PROGRESS.md, devlog/

1.2 LLM Provider Abstraction

  • Create base provider interface (providers/base.py)
  • Implement OpenAI provider
  • Implement Anthropic provider
  • Implement Ollama provider
  • Add provider factory with config

1.3 Git/Diff Tools

  • Parse git diff output
  • Extract changed files and hunks
  • Read file contents with context
  • Create patch/diff models

1.4 Basic Code Review Agent

  • Single agent that reviews a diff (code_reviewer.py)
  • Returns structured feedback (file, line, severity, message)
  • Test on sample PRs

Phase 2: Multi-Agent Core ✅

2.1 Coordinator Agent

  • Orchestrates multiple specialist agents
  • Parallel execution of agents
  • Aggregates and deduplicates findings
  • Prioritizes issues by severity
  • Consensus-based approval decision

2.2 Security Agent

  • OWASP vulnerability detection
  • Secrets/credential scanning
  • Security-specific prompts and rules
  • Dependency vulnerability awareness (future)

2.3 Agent Communication

  • Define message format between agents (Finding, ReviewResult models)
  • Implement handoff protocol via Coordinator
  • Structured logging for debugging

Phase 3: Advanced Features (In Progress)

3.1 CLI ✅

  • Create cli.py module
  • codecourt review <diff-file> command
  • codecourt review --stdin for piped input
  • codecourt review --repo <path> for local repos
  • Provider/model selection flags
  • Multiple output formats (rich, json, markdown)
  • codecourt providers command
  • codecourt parse command (debugging)
  • Config file support (.codecourtrc)

3.2 Debate System

  • Defender agent: argues FOR the code changes
  • Prosecutor agent: argues AGAINST / finds problems
  • Judge agent: synthesizes and makes final call
  • Structured debate rounds

3.3 Auto-Fix Agent

  • Generate fix suggestions as patches
  • Validate patches apply cleanly
  • Output unified diff format

Blockers / Open Questions

None currently

Next Session: Start Here

Continue with: Phase 3.2 - Debate System

Implement the debate-based review system:

  • Defender agent: argues FOR the code changes
  • Prosecutor agent: argues AGAINST / finds problems
  • Judge agent: synthesizes arguments, delivers verdict
  • Structured debate rounds (2-3 exchanges)