fix: allow placeholder GitHub key in dev mode and update Litestar CLI

- Allow placeholder GitHub private key 'ThisIsNotAProductionToken' in dev mode
- Fix run-dev-server Makefile target to use LITESTAR_APP env var instead of deprecated --app flag
- Resolves API server startup validation error in development
- All services now start successfully (API, bot, frontend)
- Add byte-docs-preview/ to .gitignore

Fixes stability issues from Phase 3.5

Author: JacobCoffee

.gitignore

@@ -30,3 +30,4 @@ next-env.d.ts
 
 # project
 !/docs/web/api/lib/
+byte-docs-preview/

Makefile

@@ -355,7 +355,7 @@ run-dev-bot: ## Run the bot in dev mode
 	@cd services/bot && $(UV) run python -m byte_bot
 
 run-dev-server: up-container ## Run the app in dev mode
-	@cd services/api && $(UV) run litestar run --app byte_api.app:create_app --reload --debug
+	@cd services/api && LITESTAR_APP=byte_api.app:create_app $(UV) run litestar run --reload --debug
 
 run-dev-frontend: ## Run the app frontend in dev mode
 	@cd services/api && $(UV) run tailwindcss -i src/byte_api/domain/web/resources/input.css -o src/byte_api/domain/web/resources/style.css --watch

services/api/src/byte_api/lib/settings.py

@@ -398,10 +398,14 @@ def validate_and_load_private_key(cls, value: str) -> str:
         Returns:
             The validated and loaded GitHub App private key.
         """
+        # Allow placeholder values in dev mode
+        environment = os.getenv("ENVIRONMENT", "dev")
+        if environment == "dev" and (not value or value == "ThisIsNotAProductionToken"):
+            return value
+
         try:
             decoded_key = base64.b64decode(value).decode("utf-8")
         except binascii.Error as e:
-            environment = os.getenv("ENVIRONMENT", "dev")
             if environment != "dev":
                 msg = "The GitHub private key must be a valid base64 encoded string"
                 raise ValueError(msg) from e