# vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator architecture

> Architecture diagram of the GitHub repository vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator
- Repository: https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator

## Overview

ClauseGuard is a legal-document auditing and navigation app. Users submit contract text for risk scoring, plain-English clause explanations, and verified citations; they can also ask grounded questions or request fair replacement language and a draft negotiation email. The main API routes validate and protect requests, use cached AI-provider results, and verify citations for audits and Q&A. The README documents the principal UI capabilities and Gemini integration; source excerpts show route-level wiring. The page and provider implementations were not excerpted, so some UI and external-service links rely on README documentation.

Main entry points: [`src/app/api/analyze/route.ts`](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/analyze/route.ts) (Contract analysis), [`src/app/api/chat/route.ts`](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/chat/route.ts) (Grounded Q&A), [`src/app/api/negotiate/route.ts`](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/negotiate/route.ts) (Counter-proposal), [`src/lib/ai/factory.ts`](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/factory.ts) (Provider factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Auditor dashboard<br/>[page.tsx]"]
  node_negotiation_modal["Negotiation modal"]
end

subgraph group_workflows["Legal workflows"]
  node_analyze_route["Contract analysis<br/>[route.ts]"]
  node_chat_route["Grounded Q&amp;A<br/>[route.ts]"]
  node_negotiate_route["Counter-proposal<br/>[route.ts]"]
  node_grounding["Citation verifier"]
  node_response_cache[("Response cache<br/>[cache.ts]")]
end

subgraph group_ai["AI providers"]
  node_provider_contract["Provider interface<br/>[provider.ts]"]
  node_provider_factory["Provider factory<br/>[factory.ts]"]
  node_gemini_provider["Gemini provider<br/>[geminiProvider.ts]"]
  node_mock_provider["Demo provider<br/>[mockProvider.ts]"]
end

subgraph group_safeguards["Request safeguards"]
  node_request_validation["Body validation<br/>[validators.ts]"]
  node_input_security["Sanitize and throttle<br/>[security.ts]"]
  node_error_mapping["API error mapping<br/>[apiError.ts]"]
end

node_user(("Contract user"))
node_gemini_service{{"Google Gemini"}}

node_user -->|"uses"| node_dashboard
node_dashboard -->|"submits contract"| node_analyze_route
node_dashboard -->|"asks questions"| node_chat_route
node_dashboard -->|"opens drafter"| node_negotiation_modal
node_negotiation_modal -->|"requests proposal"| node_negotiate_route
node_analyze_route -->|"validates body"| node_request_validation
node_chat_route -->|"validates body"| node_request_validation
node_negotiate_route -->|"validates body"| node_request_validation
node_analyze_route -->|"sanitizes and throttles"| node_input_security
node_chat_route -->|"sanitizes and throttles"| node_input_security
node_negotiate_route -->|"throttles requests"| node_input_security
node_analyze_route -->|"reads and writes"| node_response_cache
node_chat_route -->|"reads and writes"| node_response_cache
node_negotiate_route -->|"reads and writes"| node_response_cache
node_analyze_route -->|"gets provider"| node_provider_factory
node_chat_route -->|"gets provider"| node_provider_factory
node_negotiate_route -->|"gets provider"| node_provider_factory
node_analyze_route -->|"verifies clauses"| node_grounding
node_chat_route -->|"verifies citations"| node_grounding
node_analyze_route -->|"maps failures"| node_error_mapping
node_chat_route -->|"maps failures"| node_error_mapping
node_negotiate_route -->|"maps failures"| node_error_mapping
node_provider_factory -->|"selects when configured"| node_gemini_provider
node_provider_factory -->|"selects demo fallback"| node_mock_provider
node_gemini_provider -->|"implements"| node_provider_contract
node_mock_provider -->|"implements"| node_provider_contract
node_gemini_provider -->|"uses model"| node_gemini_service

click node_dashboard "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/page.tsx"
click node_negotiation_modal "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/components/NegotiationModal.tsx"
click node_analyze_route "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/analyze/route.ts"
click node_chat_route "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/chat/route.ts"
click node_negotiate_route "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/negotiate/route.ts"
click node_grounding "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/groundingVerifier.ts"
click node_response_cache "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/cache.ts"
click node_provider_contract "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/provider.ts"
click node_provider_factory "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/factory.ts"
click node_gemini_provider "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/geminiProvider.ts"
click node_mock_provider "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/mockProvider.ts"
click node_request_validation "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/validators.ts"
click node_input_security "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/security.ts"
click node_error_mapping "https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/apiError.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_negotiation_modal,node_user toneBlue
class node_analyze_route,node_chat_route,node_negotiate_route,node_grounding,node_response_cache toneAmber
class node_provider_contract,node_provider_factory,node_gemini_provider,node_mock_provider toneMint
class node_request_validation,node_input_security,node_error_mapping toneRose
class node_gemini_service toneIndigo
```

## Components

### User experience

- [Auditor dashboard](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Negotiation modal](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/components/NegotiationModal.tsx): `src/components/NegotiationModal.tsx`

### Legal workflows

- [Contract analysis](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/analyze/route.ts): `src/app/api/analyze/route.ts`
- [Grounded Q&A](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/chat/route.ts): `src/app/api/chat/route.ts`
- [Counter-proposal](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/app/api/negotiate/route.ts): `src/app/api/negotiate/route.ts`
- [Citation verifier](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/groundingVerifier.ts): `src/lib/groundingVerifier.ts`
- [Response cache](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/cache.ts): `src/lib/cache.ts`

### AI providers

- [Provider interface](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/provider.ts): `src/lib/ai/provider.ts`
- [Provider factory](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/factory.ts): `src/lib/ai/factory.ts`
- [Gemini provider](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/geminiProvider.ts): `src/lib/ai/geminiProvider.ts`
- [Demo provider](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/ai/mockProvider.ts): `src/lib/ai/mockProvider.ts`

### Request safeguards

- [Body validation](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/validators.ts): `src/lib/validators.ts`
- [Sanitize and throttle](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/security.ts): `src/lib/security.ts`
- [API error mapping](https://github.com/vaishnavi-ctrl-jpg/clauseguard-ai-legal-document-auditor-grounded-clause-navigator/blob/main/src/lib/apiError.ts): `src/lib/apiError.ts`

### Other components

- **Contract user**
- **Google Gemini**

## Connections

- Contract user → Auditor dashboard: uses (evidence: `README.md`)
- Auditor dashboard → Contract analysis: submits contract (evidence: `README.md`)
- Auditor dashboard → Grounded Q&A: asks questions (evidence: `README.md`)
- Auditor dashboard → Negotiation modal: opens drafter (evidence: `src/app/page.tsx`)
- Negotiation modal → Counter-proposal: requests proposal (evidence: `src/components/NegotiationModal.tsx`)
- Contract analysis → Body validation: validates body (evidence: `src/app/api/analyze/route.ts`)
- Grounded Q&A → Body validation: validates body (evidence: `src/app/api/chat/route.ts`)
- Counter-proposal → Body validation: validates body (evidence: `src/app/api/negotiate/route.ts`)
- Contract analysis → Sanitize and throttle: sanitizes and throttles (evidence: `src/app/api/analyze/route.ts`)
- Grounded Q&A → Sanitize and throttle: sanitizes and throttles (evidence: `src/app/api/chat/route.ts`)
- Counter-proposal → Sanitize and throttle: throttles requests (evidence: `src/app/api/negotiate/route.ts`)
- Contract analysis → Response cache: reads and writes (evidence: `src/app/api/analyze/route.ts`)
- Grounded Q&A → Response cache: reads and writes (evidence: `src/app/api/chat/route.ts`)
- Counter-proposal → Response cache: reads and writes (evidence: `src/app/api/negotiate/route.ts`)
- Contract analysis → Provider factory: gets provider (evidence: `src/app/api/analyze/route.ts`)
- Grounded Q&A → Provider factory: gets provider (evidence: `src/app/api/chat/route.ts`)
- Counter-proposal → Provider factory: gets provider (evidence: `src/app/api/negotiate/route.ts`)
- Contract analysis → Citation verifier: verifies clauses (evidence: `src/app/api/analyze/route.ts`)
- Grounded Q&A → Citation verifier: verifies citations (evidence: `src/app/api/chat/route.ts`)
- Contract analysis → API error mapping: maps failures (evidence: `src/app/api/analyze/route.ts`)
- Grounded Q&A → API error mapping: maps failures (evidence: `src/app/api/chat/route.ts`)
- Counter-proposal → API error mapping: maps failures (evidence: `src/app/api/negotiate/route.ts`)
- Provider factory → Gemini provider: selects when configured (evidence: `src/lib/ai/factory.ts`)
- Provider factory → Demo provider: selects demo fallback (evidence: `src/lib/ai/factory.ts`)
- Gemini provider → Provider interface: implements (evidence: `src/lib/ai/geminiProvider.ts`)
- Demo provider → Provider interface: implements (evidence: `src/lib/ai/mockProvider.ts`)
- Gemini provider → Google Gemini: uses model (evidence: `README.md`)
