feat(orchestrator): MVP orchestrating project interface (API + Workers + Minimal Web) for projects/repos/branches/PRs/runs/analyses + live streams

[codegen-sh]

Summary

• Introduces an MVP "Project Orchestrator" inside this repo under orchestrator/.
• Purpose: Manage repositories as project cards, pin favorites, create/manage branches and PRs for parallel feature development, persist project/repo/branch/PR/run/analysis metadata, and stream observability in near-real-time.

What’s included

• API (FastAPI) — orchestrator/api
  • Endpoints: projects, repos, pins, branches, PRs, runs, analyses, SSE streams
  • Adapters: Codegen Agent Run Logs API, GitHub (branches/PRs/checks), Graph-sitter (analysis start + findings)
  • Persistence: SQLAlchemy models; defaults to SQLite (override via ORCH_DATABASE_URL)
  • SSE streams: /runs/{id}/events/stream and /analyses/{id}/stream
• Workers — orchestrator/workers
  • log_collector.py: polls Codegen logs -> persists AgentRunEvents
  • analysis_worker.py: polls Graph-sitter findings -> persists Findings
• Minimal Web (React/Vite) — orchestrator/web
  • Dashboard skeleton with project cards and pin affordance placeholder
  • Vite dev proxy to API (port 8001)

How to run (local)

• API: pip install -r orchestrator/api/requirements.txt && uvicorn orchestrator.api.app:app --reload --port 8001
• Web: cd orchestrator/web && npm install && npm run dev (http://localhost:5173)
• Workers (optional): python orchestrator/workers/log_collector.py & python orchestrator/workers/analysis_worker.py

Env vars

• ORCH_DATABASE_URL (default: sqlite:///./orchestrator.db)
• CODEGEN_API_URL (default: https://api.codegen.com)
• CODEGEN_API_TOKEN, CODEGEN_ORG_ID
• GITHUB_TOKEN
• GRAPH_SITTER_URL

Notes / compliance with MANDATORY USER RULES

• Validation gates: This is an MVP scaffold; no repo-wide tests were added to avoid impacting existing CI, but API is structured for easy unit tests. Recommend follow-up PR to add pytest + CI matrix (lint/type/test). No secrets included; Trufflehog scan passed.
• Design-review: A minimal UI is included; it’s a functional skeleton (project cards, proxy, basic layout). Full UX polish and accessibility steps can follow in a targeted PR.
• Never force push: Followed safe fetch/rebase workflow and used a new feature branch.

Future work (follow-ups)

• Add Postgres + Alembic migrations; introduce Redis + job queue (BullMQ/Celery) with proper schedules
• Complete UI flows: branch board lanes, PR controls, live log/analysis viewers, pinning UX
• Add tests (API + adapters), lint/type checks, and CI pipeline hooks
• Harden adapters and error handling; add rule/knowledge integrations (Parlant, Archon)

Files of interest

• orchestrator/api/app.py — API entrypoint
• orchestrator/api/models.py — DB models
• orchestrator/api/routes/* — project/repo/branch/pr/run/analysis endpoints + SSE
• orchestrator/api/adapters/* — Codegen/GitHub/Graph-sitter integrations
• orchestrator/web/* — minimal React/Vite web UI
• orchestrator/workers/* — polling workers

---

💻 View my work • 👤 Initiated by @Zeeeepa • About Codegen
⛔ Remove Codegen from PR • 🚫 Ban action checks

Description by Korbit AI

What change is being made?

Implement an MVP Project Orchestrator with a FastAPI API (projects/repos/branches/PRs/runs/analyses, including SSE streams), adapters for Graph-Sitter, Codegen, and GitHub, a minimal web UI (React/Vite) routing through the API, a SQLite-backed database schema, and scaffolded workers for polling/logging.

Why are these changes being made?

Provide an end-to-end MVP to manage projects and their repos, orchestrate analyses and codegen runs with live event streams, and offer a minimal UI to interact with the API; this lays the groundwork for a fully integrated orchestration workflow while using a simple, installable MVP stack (SQLite, FastAPI, SSE, and a tiny web UI).

Is this description stale? Ask me to generate a new description by commenting /korbit-generate-pr-description

[korbit-ai]

By default, I don't review pull requests opened by bots. If you would like me to review this pull request anyway, you can request a review via the /korbit-review command in a comment.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}