feat: Scaffold Chief MOG Officer framework and core architecture

[gpsanant]

Scaffold Chief MOG Officer Framework and Core Architecture

Sets up the complete base framework for the Chief MOG Officer MVP. This is foundational scaffolding only — no full product logic yet.

What is included

Monorepo Structure (pnpm workspaces + Turborepo)

• apps/web — React + Vite frontend with routing, layout, design tokens
• apps/api — Express backend with typed routes and middleware
• apps/worker — Background job processor with polling and retry

Shared Packages

• packages/types — Domain model type definitions (Project, CompanyProfile, Opportunity, etc.)
• packages/config — Environment validation with Zod
• packages/db — Drizzle ORM schema, migrations, seed script
• packages/agents — Agent interface + 5 stub agents
• packages/ui — Reusable React components (Button, Card, StatusBadge)
• packages/lib — Logger and utilities

Domain Model — 10 entity types with full Drizzle ORM schema:
Project, CompanyProfile, NarrativeModel, CompetitorProfile, Opportunity, Asset, Campaign, AgentRun, DailyDigest, User

Backend (API)

• GET /api/health — Health check endpoint
• GET /api/projects — List all projects
• POST /api/projects — Create project with company profile
• GET /api/projects/:id — Get single project
• POST /api/analysis/trigger — Trigger analysis run
• GET /api/analysis/opportunities — List opportunities

Worker

• Polling-based job processor for pending AgentRuns
• Agent execution lifecycle (ingest → analyze → generateOpportunities → summarize)
• Daily scheduled analysis, retry/error handling

Agents — Common interface with 5 stub implementations:

1. SearchMogAgent
2. GeoAgent
3. RedditMogAgent
4. CompetitorIntelAgent
5. ContentFoundryAgent

Frontend

• App shell with React Router
• Command Center (dashboard) page
• Project Creation form
• Opportunity List page
• CSS design tokens for theming
• Error boundary

Database

• Drizzle ORM + PostgreSQL via Docker Compose
• Migration flow (pnpm db:migrate)
• Seed script with demo project (pnpm db:seed)

Developer Experience

• ESLint + Prettier config
• TypeScript strict mode across all packages
• Env validation (Zod)
• Docker Compose for local PostgreSQL

Documentation

• docs/architecture.md — System architecture overview
• docs/domain-model.md — Entity relationship details
• docs/agent-interface.md — Agent contract specification
• docs/dev-setup.md — Local development setup guide

Verification

• ✅ pnpm typecheck — All 9 packages pass
• ✅ pnpm lint — All 9 packages pass
• ✅ pnpm install — 309 packages installed successfully

Note on CI

The pre-existing CI workflow checks for a Dockerfile. The GitHub token does not have workflow scope to update .github/workflows/ci.yml, so the original workflow was preserved. The CI failure is from the pre-existing check, not from this scaffolding code.