fix: edit extras install command and render symlink parent dir

CHEATSHEET.md

@@ -51,6 +51,9 @@ npm run preview
 ## Edit
 
 ```bash
+# Install edit dependencies (FastAPI + uvicorn) — one-time
+uv sync --extra edit
+
 # Start the edit server (port 4041 by default)
 uv run bincio edit --data-dir ~/bincio_data
 

README.md

@@ -60,6 +60,7 @@ uv run bincio render --serve    # merges edits, links data, starts astro dev
 # → http://localhost:4321
 
 # Optional: enable the activity edit UI
+uv sync --extra edit            # install FastAPI + uvicorn (one-time)
 uv run bincio edit              # starts edit server on http://localhost:4041
 # Set PUBLIC_EDIT_URL=http://localhost:4041 in site/.env
 ```

bincio/edit/cli.py

@@ -42,7 +42,7 @@ def edit(
     except ImportError:
         raise click.ClickException(
             "uvicorn is required for the edit server.\n"
-            "Install with: uv add 'bincio[edit]'"
+            "Install with: uv sync --extra edit"
         )
 
     data = _resolve_data_dir(data_dir, config_path)

bincio/render/cli.py

@@ -76,6 +76,7 @@ def _link_data(site: Path, data: Path) -> None:
     merged = data / "_merged"
     target = merged if merged.exists() else data
     public_data = site / "public" / "data"
+    public_data.parent.mkdir(parents=True, exist_ok=True)
     if public_data.is_symlink():
         if public_data.resolve() == target.resolve():
             return  # already correct