[Programcode]

Summary

• Add .superset/config.json (setup/run/teardown) so a new Superset workspace installs deps automatically and starts the dev server through .superset/dev.sh.
• Add a shared port allocator (.superset/lib/port-alloc.cjs + .superset/lib/lock.sh) so parallel worktrees each get a unique port instead of colliding on the hardcoded :8080 in vite.config.ts (now reads process.env.PORT first).
• Add .superset/db-gate.sh to serialize the Docker-backed Supabase DB gate (supabase db start / npm run test:db) across workspaces, since supabase/config.toml has no per-project port config and two workspaces running it at once collide in Docker.
• Document the above in AGENTS.md and gitignore personal .superset/config.local.json overrides.

Test plan

• bash -n on all new shell scripts, node --check on the port allocator, JSON validated
• Allocator verified directly: sequential ports for distinct workspace keys, reuse on repeat calls, clean release
• npm ci + ./.superset/dev.sh end-to-end: allocated port 8080, curl returned HTTP 200, ./.superset/teardown.sh released the allocation
• npm run typecheck and npm run lint pass with the vite.config.ts change

🤖 Generated with Claude Code

https://claude.ai/code/session_0163LcrphWJjYjTXM33mQuH6

Summary by CodeRabbit

• New Features
  • Added support for running multiple development workspaces concurrently with automatic port allocation.
  • Added safeguards to coordinate local database startup and database tests.
  • Added automated workspace cleanup for allocated development ports and local services.
• Documentation
  • Documented setup and workflow guidance for concurrent workspaces.
• Developer Experience
  • Development servers now honor a configured port and default to port 8080 when none is provided.
  • Added local configuration support for workspace tooling.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
debate-navigator	Ready	Preview	Sep 5, 2026 3:30pm UTC

[coderabbitai]

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Free

Run ID: 325ccc0f-bb02-4941-867a-b7e151ab8911

📥 Commits

Reviewing files that changed from the base of the PR and between 89529bf and 410ff27.

📒 Files selected for processing (9)

• .gitignore
• .superset/config.json
• .superset/db-gate.sh
• .superset/dev.sh
• .superset/lib/lock.sh
• .superset/lib/port-alloc.cjs
• .superset/teardown.sh
• AGENTS.md
• vite.config.ts

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

Added tooling for concurrent Superset workspaces. The tooling allocates ports, coordinates shared locks, manages Supabase lifecycle operations, configures Vite, and documents workspace setup.

Changes

Superset workspace tooling

Layer / File(s)	Summary
Coordination primitives .superset/lib/lock.sh, .superset/lib/port-alloc.cjs	Added advisory locking and persistent workspace port allocation.
Workspace lifecycle integration .superset/dev.sh, .superset/teardown.sh, vite.config.ts	Added port allocation and cleanup scripts. Vite now reads the selected PORT value.
Database test gate .superset/db-gate.sh	Added exclusive Supabase locking, database startup, database tests, and cleanup.
Workspace configuration and guidance .superset/config.json, AGENTS.md, .gitignore	Added setup commands, teardown commands, parallel-workspace guidance, and local configuration ignores.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Workspace as Superset workspace
  participant DevScript as .superset/dev.sh
  participant PortAllocator as port-alloc.cjs
  participant Vite as Vite dev server
  Workspace->>DevScript: start development
  DevScript->>PortAllocator: allocate workspace port
  PortAllocator-->>DevScript: return port
  DevScript->>Vite: run with PORT
  Vite-->>Workspace: serve on allocated localhost port

Loading

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Essentials by visiting https://app.coderabbit.ai/settings/billing.

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