Repository Map

Repositories

Repository Details

Repository	Owner	Purpose	Stack	Branch Strategy	Deploy Target
`equa-web`	`EQUAStart`	Frontend SPA	React 18.2, TypeScript 5.3, Webpack 4, Redux 4	Feature branches + `main`	Railway (current app edge)
`equa-server`	`EQUAStart`	Backend API	Express 4, TypeORM, PostgreSQL, Node 18	Feature branches + `staging`; legacy `prod-deploy` path still exists in CI	Railway service config for current runtime target; legacy Cloud Run path remains in `cloudbuild.yaml`
`equa-patternlib-nextjs`	`EQUAStart`	Design system + Storybook	React 18, Next.js 14, Storybook 8.4	staging → main	Railway (Storybook static)
`equabot`	`EQUAStart`	AI gateway CLI + source	TypeScript (ESM), Bun	Feature branches → main	npm publish / macOS app
`equabot-gateway`	`equabot`	Gateway development	TypeScript, Lit Web Components	Feature branches → main	Bundled in equabot
`Comet-Bridge`	`Balancing-Rock`	Persistent browser automation (Comet/Perplexity)	Node.js (ESM), MCP server, Playwright	main	npm (comet-mcp) / local tooling
`command-center-so`	`EQUAStart`	Full-screen Equanaut Command Center	Next.js 16, React 19, Tailwind 4	Feature branches → main	`/command-center` app namespace; local dev on port 3001
`stacks-ranking-priorities`	`Balancing-Rock`	Task/priority tracking (includes auto-add flowchart and project-sync architecture docs)	Python scripts, JSON data	main	GitHub Actions
`equa-desktop-app-mac-ios`	—	Desktop/mobile app	Planned: SwiftUI	—	— (empty)
`equa-docs`	—	Platform documentation	Mintlify	main	docs.equa.cc

What Lives Where

equa-web (Frontend)

Path	Contents
`src/modules/`	Feature modules (auth, captable, esop, etc.)
`src/shared/components/`	Pattern library re-exports
`src/shared/helpers/`	Utility functions, validators, constants
`src/service/`	HTTP client and API service layer
`src/logic/`	Redux store, reducers, types
`src/styles/`	Styled Components theme, global styles
`src/app/`	App shell, routing, error boundary
`e2e/`	Playwright E2E tests
`lab/`	Production entry point

equa-server (Backend)

Path	Contents
`modules/api/`	Express server, endpoint registration, route definitions
`modules/auth/`	Authentication (password, OAuth, magic links), sessions, RBAC
`modules/persistence/`	TypeORM entities (92), database connection, schema
`modules/captable/`	Cap table business logic
`modules/organizations/`	Organization management
`modules/billing/`	Chargify billing integration
`modules/notifications/`	Email delivery (SES/SMTP)
`modules/file-storage/`	AWS S3 file operations
`modules/doc-gen/`	PDF certificate generation
`modules/data-room/`	Data room access control
`modules/google-drive/`	Google Drive sync
`modules/microsoft/`	Microsoft Graph integration
`modules/agent/`	Equanaut AI assistant
`modules/referral/`	Referral system
`modules/activity/`	Activity/event logging
`modules/admin/`	Admin-only operations
`modules/common/`	Shared types and utilities
`modules/raven/`	Raven blockchain integration
`docs/`	Cascading permission diagram

Comet-Bridge (Browser Automation + MCP Servers)

Path	Contents
`scripts/`	Core CLI commands (browse, search, scrape, interact, auto, etc.)
`scripts/cursor-comet.mjs`	Unified `comet` wrapper with startup gating
`scripts/comet-bootstrap.mjs`	Readiness checks (app, CDP, MCP, extension)
`scripts/tab-safety.mjs`	Tab ownership and multi-agent isolation
`scripts/lifecycle-metadata.mjs`	Lifecycle envelope creation and transition helpers
`scripts/lifecycle-mcp-adapter.mjs`	MCP-to-lifecycle bridge for tool calls
`comet-mcp/`	MCP server for Cursor/Claude browser integration (16 tools)
`comet-mcp/extension/`	Chrome extension for tab group management
`gdrive-mcp/`	MCP server for Google Drive file operations (6 tools: list, search, info, mkdir, upload, download)
`docs/`	Setup, config schema, tab ownership protocol

command-center-so (Ops Dashboard)

Path	Contents
`src/app/`	Next.js app router pages
`src/app/api/comet/lifecycle/`	HTTP endpoint for cross-repo Comet run lifecycle sync
`src/components/`	React components (chat, settings, monitors)
`src/lib/`	Utility libraries, gateway client
`src/lib/taskThreads.ts`	CometRun lifecycle adapter (start/update/complete/abort/fail), atomic file persistence
`src/data/comet-runs/`	Ephemeral per-run lifecycle state (gitignored)
`.specify/specs/`	Feature specifications (one directory per spec: `{id}-{slug}/`)
`.specify/specs/{id}-{slug}/diagrams/`	Mermaid `.mmd` visual diagrams (conditional)
`.specify/templates/`	Spequa artifact templates (spec, plan, tasks, checklist)
`.specify/memory/`	Project constitution and persistent context
`.specify/queue/`	Portfolio queue items and session briefs
`e2e/`	Playwright E2E tests

Local Development Ports

See Environments and Config for the complete port map.

Port	Service
3000	equa-server
3001	command-center-so
3333	equa-patternlib (Next.js)
3337	equa-docs (Mintlify)
5432	PostgreSQL
6006	Storybook
8080	equa-web
9222	Comet-Bridge CDP (Comet browser)
18789	equabot Gateway
18791	equabot Browser Control
19792	Equanaut API