Skip to content

Latest commit

 

History

History
50 lines (37 loc) · 2.62 KB

README.md

File metadata and controls

50 lines (37 loc) · 2.62 KB

CodeHawk Documentation

Navigation hub for all CodeHawk documentation.


Architecture

Document Description
Architecture System design, component interactions, two-phase data flow, and design decisions

Feature Documentation

Document Description
Agent Runner OpenAI agent runner internals: API detection, tool registry, conversation loop, turn budget management, and findings extraction fallback chain
Graph Tools AST-based structural analysis: change analysis, blast radius, caller lookup, file dependency resolution, and graceful degradation
Review Modes Mode auto-detection from file paths and PR labels, mode-specific checklists, and severity multiplier effects
Scoring Penalty-based PR scoring: penalty matrix, star rating thresholds, mode multipliers, and configuration
Post Findings Phase 2 engine: schema validation, confidence filtering, finding caps, deduplication, summary generation, and CI gate evaluation
Fix Verification Re-push detection, delta diff analysis, fixed/still-present/not-relevant classification, and thread resolution
CI Integration Pipeline setup for Azure DevOps and GitHub Actions, Docker usage, and environment variable reference
VCS CLI VCS command wrappers for Azure DevOps and GitHub: get-pr, get-file, list-threads, and authentication

Design Documents

Document Description
Developer Dismissal Handling Design: how CodeHawk evaluates developer replies to disputed findings
Two-Pass Review Design Design: scan → verify two-pass review architecture

Quick Links

Resource Link
Findings Schema (JSON) commands/findings-schema.json
Agent Instruction Set commands/review-pr-core.md
Mode Checklists commands/review-pr-core.md — Step 3
Scoring Matrix features/scoring.md
.codereview.yml config features/ci-integration.md
Docker setup features/ci-integration.md
CI pipeline templates ci/
Repository templates templates/