Never Let Code Changes
Outpace Your Documentation

flowchart TD %% Styling Classes classDef client fill:#1e293b,stroke:#334155,stroke-width:2px,color:#fff; classDef gateway fill:#0369a1,stroke:#0284c7,stroke-width:2px,color:#fff; classDef worker fill:#6d28d9,stroke:#7c3aed,stroke-width:2px,color:#fff; classDef service fill:#c2410c,stroke:#ea580c,stroke-width:2px,color:#fff; classDef external fill:#15803d,stroke:#16a34a,stroke-width:2px,color:#fff; classDef error fill:#991b1b,stroke:#dc2626,stroke-width:2px,color:#fff; subgraph GitHub_Event ["GitHub Platform & Trigger"] A([Developer opens / updates PR]) -->|Webhook Event Delivery| B[GitHub Event Dispatcher] end subgraph API_Gateway ["Gateway & Signature Verification"] B -->|POST /webhooks/github + X-Hub-Signature-256| C[Webhook Route Handler] C --> D{Verify HMAC Signature} D -->|Invalid Signature| E[HTTP 401 Unauthorized] D -->|Ping Event| F[HTTP 200 Pong] D -->|Non-PR Event| G[HTTP 200 Ignored] D -->|Valid PR Event| H[Parse Pull Request Payload] H -->|Draft / Unsupported Action| I[HTTP 200 Ignored] H -->|Valid PR Context| J[Background Worker Queue] J -->|HTTP 202 Accepted| B end subgraph Pipeline_Processing ["Review Pipeline Orchestration"] J -->|Dispatch Async Task| K[ReviewPipeline Orchestrator] K --> L[Start Check Run in_progress] L --> M[Fetch PR Unified Diff] M --> N[Code Delta Parser & Signal Extractor] N --> O{Skip Decision Engine} O -->|No Files / Noise-only / Docs-only| P[Publish Skipped Status] O -->|Substantive Code Changes| Q[Fetch Documentation Files] Q --> R{Docs Exist?} R -->|No Matching Docs| S[Publish Skipped / Neutral Check] R -->|Docs Retrieved| T[LLM Semantic Evaluator] end subgraph LLM_Service ["LLM Evaluation Layer"] T -->|Prompt: Diff + Signals + Docs| U[Google Gemini / LLM Backend] U -->|Structured Verdict JSON| V{Drift Detected?} end subgraph Feedback_Publishing ["Feedback Orchestrator & Persistence"] V -->|UP_TO_DATE| W[Mark Check Run Success & Upsert Resolved Comment] V -->|NEEDS_UPDATE| X[Post/Update PR Comment with Suggested Edits & Check Run] P --> Y[Finalize Check Run completed] S --> Y W --> Y X --> Y E --> Z([End Lifecycle]) F --> Z G --> Z I --> Z Y --> Z end class A,B client; class C,D,H,J gateway; class K,L,M,N,O,Q,R,T worker; class U service; class W,X,P,S,Y external; class E,F,G,I error;