Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 16 additions & 3 deletions CHARTER.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,10 @@ Provide a unified life management and action dashboard that ingests data from 15
- Cron-scheduled data sync across all sources
- Bridge API for inter-service data exchange (ChittyScrape, ChittyLedger)
- Proxy passthrough for ChittySchema validation, ChittyCert verification, ChittyRegister requirements
- MCP server for Claude-driven queries (28 tools: financial, ledger, schema, cert, connect, chat)
- MCP server for Claude-driven queries (48 tools across 12 domains)
- Case timeline aggregation from ChittyEvidence, ChittyLedger, and local DB
- Litigation support (fact synthesis, drafting, QC) via ChittyConnect prompts or AI Gateway fallback
- Scrape job dispatch with retry, dead-letter, and fan-out to downstream agents

### IS NOT Responsible For
- Identity generation (ChittyID)
Expand All @@ -76,6 +79,7 @@ Provide a unified life management and action dashboard that ingests data from 15
| Upstream | ChittyCharge | Billing data |
| Upstream | ChittyScrape | Browser-based scraping for portals without APIs |
| Upstream | ChittyLedger | Evidence and document ledger sync |
| Upstream | ChittyEvidence | Evidence facts, documents, entities for case timelines |
| Upstream | ChittyConnect | Inter-service connectivity and discovery |
| Upstream | ChittyRouter | Unified ingestion gateway (scrape, email routing) |
| Upstream | ChittySchema | Canonical schema validation and drift detection |
Expand Down Expand Up @@ -116,8 +120,17 @@ Provide a unified life management and action dashboard that ingests data from 15
| `/api/recommendations` | GET | Bearer | AI action recommendations |
| `/api/sync` | POST | Bearer | Manual data sync trigger |
| `/api/cashflow` | GET | Bearer | Cash flow analysis |
| `/api/v1/timeline/:caseId` | GET | Bearer | Unified case timeline (facts, deadlines, disputes, docs) |
| `/api/v1/litigation/synthesize` | POST | Bearer | AI fact synthesis from raw notes |
| `/api/v1/litigation/synthesize-from-case` | POST | Bearer | AI fact synthesis auto-pulled from ChittyEvidence |
| `/api/v1/litigation/draft` | POST | Bearer | AI email drafting from synthesized facts |
| `/api/v1/litigation/qc` | POST | Bearer | AI risk scan of draft vs source notes |
| `/api/v1/jobs` | GET/POST | Bearer | Scrape job queue management |
| `/api/v1/jobs/:id` | GET | Bearer | Scrape job details |
| `/api/v1/jobs/:id/retry` | POST | Bearer | Retry failed scrape job |
| `/api/v1/jobs/dead-letters` | GET | Bearer | Dead letter queue |
| `/api/bridge/*` | Various | Service/Bearer | Inter-service bridge routes |
| `/mcp/*` | Various | Service | MCP server for Claude integration |
| `/mcp/*` | Various | Service | MCP server (48 tools across 12 domains) |

### Cron Schedule
| Schedule | Purpose |
Expand Down Expand Up @@ -170,4 +183,4 @@ This charter is part of a synchronized documentation triad. Changes to shared fi
- [x] CHITTY.md present

---
*Charter Version: 1.1.0 | Last Updated: 2026-03-03*
*Charter Version: 1.2.0 | Last Updated: 2026-03-24*
13 changes: 11 additions & 2 deletions CHITTY.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Cloudflare Worker at command.chitty.cc with Neon PostgreSQL via Hyperdrive, R2 f
| Category | Sources |
|----------|---------|
| Financial (auto-sync) | Mercury, Stripe, Plaid, ChittyFinance |
| Direct API | ChittyBooks, ChittyAssets, ChittyCharge, ChittyLedger |
| Direct API | ChittyBooks, ChittyAssets, ChittyCharge, ChittyLedger, ChittyEvidence |
| Scrape (via ChittyScrape) | Mr. Cooper mortgage, Cook County property tax, Court docket |
| Email Parse | ComEd, Peoples Gas, Xfinity, Citi, Home Depot, Lowe's |

Expand Down Expand Up @@ -121,7 +121,16 @@ See [CHARTER.md](CHARTER.md) (Dependencies section) — canonical source for the
| `/auth/*` | Various | No | Login/verify flows |
| `/api/bridge/*` | Various | Service | Inter-service bridge routes |
| `/api/bridge/credentials/get` | POST | Service | Allowlisted credential proxy via ChittyConnect |
| `/mcp/*` | Various | Service | MCP server (32 tools) |
| `/api/v1/timeline/:caseId` | GET | Bearer | Unified case timeline (facts, deadlines, disputes, docs) |
| `/api/v1/litigation/synthesize` | POST | Bearer | AI fact synthesis from raw notes |
| `/api/v1/litigation/synthesize-from-case` | POST | Bearer | AI fact synthesis from ChittyEvidence |
| `/api/v1/litigation/draft` | POST | Bearer | AI email drafting from synthesized facts |
| `/api/v1/litigation/qc` | POST | Bearer | AI risk scan of draft vs source notes |
| `/api/v1/jobs` | GET/POST | Bearer | Scrape job queue management |
| `/api/v1/jobs/:id` | GET | Bearer | Scrape job details |
| `/api/v1/jobs/:id/retry` | POST | Bearer | Retry failed scrape job |
| `/api/v1/jobs/dead-letters` | GET | Bearer | Dead letter queue |
| `/mcp/*` | Various | Service | MCP server (48 tools across 12 domains) |

## Document Triad

Expand Down
5 changes: 3 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ Three modes:
- `src/lib/dispute-sync.ts` — Dispute ↔ Notion ↔ TriageAgent sync coordinator
- `src/routes/bridge/index.ts` — Inter-service bridge (scrape, ledger, finance, Plaid)
- `src/routes/bridge/disputes.ts` — Dispute-Notion manual sync bridge
- `src/routes/mcp.ts` — MCP server for Claude integration (32 tools)
- `src/routes/mcp.ts` — MCP server for Claude integration (48 tools)
- `src/routes/meta.ts` — Public canon/schema/beacon + authenticated whoami
- `src/routes/connect.ts` — ChittyConnect discovery proxy (rate-limited)
- `src/routes/ledger.ts` — ChittyLedger evidence/custody passthrough
Expand Down Expand Up @@ -137,7 +137,7 @@ Example client-side MCP configuration (conceptual):
}
```

The server exposes 43 tools across 10 domains:
The server exposes 48 tools across 12 domains:

**Core meta** — `get_canon_info`, `get_registry_status`, `get_schema_refs`, `whoami`, `get_context_summary`
**Financial** — `query_obligations`, `query_accounts`, `query_disputes`, `get_recommendations`, `get_cash_position`, `get_cashflow_projections`, `query_revenue_sources`, `get_payment_plan`
Expand All @@ -152,5 +152,6 @@ The server exposes 43 tools across 10 domains:
**Legal** — `query_legal_deadlines`
**Documents** — `query_documents`
**Sync** — `get_sync_status`, `trigger_sync`
**Evidence** — `get_case_timeline`, `get_case_facts`, `get_case_contradictions`, `get_pending_facts`, `synthesize_case_facts`

Tools return structured JSON using MCP `content: [{ type: "json", json: ... }]` where applicable, enabling Claude Code to consume results without text parsing.
7 changes: 7 additions & 0 deletions drizzle.config.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
import { defineConfig } from 'drizzle-kit';

export default defineConfig({
schema: './src/db/schema.ts',
out: './migrations',
dialect: 'postgresql',
});
Loading
Loading