From eaa83207a0aff84a6c9d5770d177ee5ab719e8fe Mon Sep 17 00:00:00 2001
From: Kevin Turcios <106575910+KRRT7@users.noreply.github.com>
Date: Wed, 29 Apr 2026 04:18:39 -0500
Subject: [PATCH] Fix blackbox dev server command and add repo-root
 instructions (#48)

fastapi[standard] extras aren't resolved at workspace level, so
`fastapi dev` fails without `--package blackbox`. Add working
commands for both repo root (uvicorn) and package directory (fastapi dev).
---
 packages/blackbox/README.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/packages/blackbox/README.md b/packages/blackbox/README.md
index 47bec9f..54b4959 100644
--- a/packages/blackbox/README.md
+++ b/packages/blackbox/README.md
@@ -53,9 +53,19 @@ src/blackbox/
 
 ## Development
 
+From the repo root:
+
 ```bash
 uv sync
-uv run fastapi dev src/blackbox/dashboard/app.py  # hot reload on :8000
+uv run --package blackbox uvicorn blackbox.dashboard.app:app --reload  # hot reload on :8000
+uv run pytest packages/blackbox/tests/ -v
+uv run ruff check packages/blackbox/
+```
+
+From `packages/blackbox/`:
+
+```bash
+uv run --package blackbox fastapi dev src/blackbox/dashboard/app.py  # hot reload on :8000
 uv run pytest tests/ -v
 uv run ruff check src/ tests/
 ```