Skip to content

Latest commit

 

History

1,840 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Congress.Trade

Congress.Trade is a live product at congress.trade that ingests public US STOCK Act trade disclosures (House, Senate, and Executive Branch OGE 278-T), extracts and normalizes trades, and serves a public dashboard plus REST, webhook, SSE, and APNs delivery.

Deno Deploy and Turso are retired. Production is Coolify Docker on Hetzner fleet-hetzner-nbg1 (same box as host.jays.services), Deno inside the congress-app container, host SQLite at /data/congress-trade/db.sqlite (Litestream-replicated), Infisical secrets. Cloudflare DNS routes https://congress.trade; it is not the application runtime.

Proof (do not treat leftover Worker packages as the live host): AGENTS.md Current Shape, app/Dockerfile (FROM denoland/deno:alpine, src/deno/main.ts), app/docker-compose.yml (congress-app), app/src/deno/main.ts. app/wrangler.toml is gone. Leftover only: app/wrangler.preview.example.toml, @sentry/cloudflare, @cloudflare/workers-types. Do not reintroduce wrangler deploy as the production path. See AGENTS.md "Current Shape" and app/DEPLOY.md.

Repository Layout

Path Purpose
app/ The production app (Deno / Hono). Run almost all commands from here.
app/src/ TypeScript source for ingestion, extraction, delivery, admin, auth, billing, analytics, enrichment, prices, and UI.
app/src/deno/main.ts Production entrypoint. app/Dockerfile caches and runs this file.
app/docker-compose.yml Coolify compose project: congress-app, sqlite-web, scan-cpu-worker.
app/migrations/ Local schema files. Production schema is applied via POST /api/admin/migrate, not Wrangler D1.
app/docs/ Runbooks for auth/billing, preview leftovers, and cross-app FMP data sharing.
app/scripts/ Operational scripts. Some target production, so read headers before running.
congress_trade_watch.py Standalone local House PTR watcher prototype. It is not the production ingest path.
dashboard-design.html Historical/static UI design artifact. Current UI lives in app/src/ui/.
AGENTS.md Collaboration rules for Codex, Claude, Cursor, Copilot, Antigravity, and other agents.
CLAUDE.md Claude entrypoint that points to the same rules.
.cursor/rules/congress-trade.mdc Cursor project rule that points to the same rules.
STATUS.md Current integration snapshot and handoff checklist.

Daily Development

cd app
npm ci
npm run typecheck
npm test
npm run dev

Pushes to main are built by Coolify from app/docker-compose.yml. The npm run deploy script does not publish a Worker; it only reminds you that Coolify owns production. After a main deploy, apply schema with ADMIN_TOKEN=... bash app/scripts/ship.sh (waits for the live /api/health build SHA, then POST /api/admin/migrate against https://congress.trade).

Do not wrangler deploy, do not deploy to Deno Deploy, and do not point the DB at Turso. There is no production app/wrangler.toml. app/scripts/deploy-preview.sh is leftover isolated Wrangler preview tooling and is not the live site. Do not deploy, migrate production, or run ingest/backfill unless that is explicitly intended.

Coordination

Use a separate branch for every non-trivial change. Codex branches should use codex/, Claude branches should use claude/, Cursor branches should use cursor/, Copilot branches should use copilot/, and Antigravity branches should use antigravity/. Shared feature or integration branches should be explicit and descriptive. Before editing, check:

git status --short --branch
git worktree list
gh pr list --state open

See AGENTS.md for the full handoff and verification rules.