Knowledge Base updated: 2026-11-19
WorldMonitor knowledge base
Orientation
WorldMonitor is a multi-surface intelligence product. Its Vite browser client presents global monitoring dashboards and interactive intelligence experiences; Vercel-style API routes and a server gateway expose those capabilities to web clients and integrations.
Durable product state, user preferences, alerts, entitlements, and asynchronous workflows live in Convex. Seed scripts, relays, and workers collect and refresh the monitoring datasets used throughout the product.
The repository also ships desktop, command-line, SDK, browser-plugin, and AI-agent integration surfaces. Deployment and operational automation spans Vercel, container images, GitHub Actions, and scheduled refresh workflows.
flowchart TD
Sources[External data sources] --> Seeds[Seed scripts and relays]
Seeds --> Convex[Convex state and jobs]
Seeds --> Datasets[Operational datasets]
Client[Vite web client] --> API[API routes]
Client --> Convex
API --> Gateway[Server gateway]
Gateway --> Services[Intelligence and news services]
API --> Convex
Services --> Datasets
Convex --> Alerts[Alerts and notifications]
API --> Integrations[MCP, SDK, plugins, automation]
Client --> Desktop[Tauri desktop client]
Integrations --> External[External consumers]
Ops[CI, containers, Vercel] --> Client
Ops --> API
Routing table
src/app/**,src/config/**,src/locales/**,src/services/**-> Web client experiencesrc/main*.ts*, src/App.ts,src/embed/**,src/settings/**,src/live-channel/**,src/mcp-grant/**,src/browser-plugin/**-> Web application shell and compositionsrc/components/**,src/features/**,src/data/**,src/workers/**-> Monitoring dashboards and feature experiencesscripts/**,workers/**,data/**,datasets/**-> Data ingestion and refresh pipelinesscripts/seed-*.{mjs,js,cjs},scripts/*ingest*.{mjs,js,cjs},scripts/*materializer*.{mjs,js,cjs}, scripts/source-*.mjs -> Seed pipeline orchestration- scripts/notification-relay.cjs, scripts/ais-relay.cjs,
convex/**/alert*,api/**/webhook*-> Alerts and notification delivery consumer-prices/**,scripts/*price*.{mjs,js,cjs},convex/**/price*-> Consumer-price validation pipelineapi/**,server/_shared/**-> API platformapi/mcp/**,api/**/brief*,api/**/search*,api/**/feed*,api/**/embed*-> Domain API routes- server/gateway.ts,
server/worldmonitor/**,server/**/router*,server/**/cors*,server/**/session*-> Backend gateway routing convex/**,shared/**/schema*,src/**/convex*-> Persistent application state- convex/schema.ts,
convex/**/cron*,convex/**/mutation*,convex/**/query*,convex/**/action*-> Convex schema and scheduled workflows api/**/intelligence*,server/worldmonitor/intelligence/**,src/**/intelligence*,convex/**/intelligence*-> Intelligence productsapi/**/brief*,server/worldmonitor/intelligence/**,src/**/brief*,convex/**/brief*-> Intelligence briefs and analysisapi/**/forecast*,api/**/scenario*,api/**/resilience*,scripts/*forecast*,scripts/*resilience*-> Forecasting, scenarios, and resilienceapi/**/company*,convex/**/company*,src/**/company*,scripts/*company*-> Company monitoring intelligenceapi/**/travel*,src/**/travel*,convex/**/travel*,scripts/*travel*-> Travel-risk assessment workflowsapi/**/orbital*,api/**/satellite*,src/**/orbital*,convex/**/orbital*,scripts/*imagery*-> Orbital imagery intelligenceapi/oauth/**, api/_product-catalog.generated.js,api/_api-key*,convex/**/entitlement*,src/**/auth*-> Identity, access, and commerceapi/oauth/**,api/**/checkout*,api/**/portal*,convex/**/subscription*,convex/**/entitlement*,convex/**/apiKey*-> Access control and subscriptionssrc-tauri/**, tauri.conf.json,tauri/**,desktop/**-> Desktop and external clientssrc-tauri/**, tauri.conf.json,tauri/**/capabilities/**,scripts/*tauri*-> Tauri desktop application lifecyclebrowser-plugin/**,src/browser-plugin/**,api/**/plugin*-> Browser plugin country intelligencecli/**,bin/**,src/cli/**-> CLI terminal dashboardintegrations/zapier/**,zapier/**-> Zapier automation integrationsdk/**,packages/*sdk*/**,clients/**-> SDK client librariesplugins/claude/**,plugins/gemini/**,skills/**,api/mcp/**-> AI agent plugin integration.github/workflows/**,Dockerfile*, vercel.json, docker-compose*.yml,scripts/deploy*-> Operations and deployment