stage 0: repository audit and safety branch

Scope: file-map audit and baseline screenshot evidence pointer only (no UI or logic changes).

Validation: py_compile + import app checks passed; stage acceptance gate passed.

docs/screenshots/README.md

@@ -0,0 +1,10 @@
+# Stage 0 Baseline Screenshot Evidence
+
+Stored locally (not committed due HF binary push restrictions):
+- `/Users/jamalromeh/Codex_Extractor/docs/screenshots/stage0_baseline_homescreen.png`
+
+Original capture source:
+- `/Users/jamalromeh/Desktop/Screenshot 2026-05-16 at 21.12.18.png`
+
+Verification note:
+- This screenshot is the Stage 0 baseline reference before staged UI redesign.

docs/stage0_file_map.md

@@ -0,0 +1,63 @@
+# Stage 0 File Map (UI Redesign Safety Audit)
+
+Date: 2026-05-17
+Branch: `codex/skin-totem-dashboard-staged`
+
+## Baseline Evidence
+- Baseline screenshot: `/Users/jamalromeh/Codex_Extractor/docs/screenshots/stage0_baseline_homescreen.png`
+- Launch safety checks:
+  - `python -m py_compile app.py smoke_signal_tab.py` passed
+  - `import app` passed in project venv
+
+## Entrypoint + UI Assembly
+- Primary Gradio entrypoint: `/Users/jamalromeh/Codex_Extractor/app.py`
+- `gr.Blocks(...)` + tabs assembled in `app.py`
+- App launch call currently in `app.py` (`demo.launch(...)`)
+
+## Dashboard UI Surface (Target of redesign)
+- Dashboard HTML builder: `dashboard_html(...)` in `/Users/jamalromeh/Codex_Extractor/app.py`
+- Startup dashboard shell: `initial_dashboard_html(...)` in `/Users/jamalromeh/Codex_Extractor/app.py`
+- Existing dashboard-related visual helpers (UI-only):
+  - `_kpi_card(...)`
+  - `_small_spark(...)`
+  - `_revision_rows(...)`
+  - `_risk_cards(...)`
+  - `_recent_workbooks(...)`
+
+## Existing Callback Functions (Preserve behavior)
+- Workbook load/upload:
+  - `load_workbook(...)`
+  - `load_uploaded(...)`
+  - `load_local_path(...)`
+- Analysis + recalculation:
+  - `run_analysis(...)`
+  - `recalc_log(...)`
+- Export:
+  - `export_log(...)`
+- Codex extractor route callbacks:
+  - `run_codex_extraction(...)`
+  - `clear_codex_form(...)`
+  - `autofill_codex_details(...)`
+
+## CSS/Theme Injection Locations
+- Main CSS string in `/Users/jamalromeh/Codex_Extractor/app.py` (currently passed as `css=CSS + SS_CSS`)
+- Smoke Signal CSS comes from `/Users/jamalromeh/Codex_Extractor/smoke_signal_tab.py` via `SS_CSS`
+
+## Asset Locations
+- Shared assets directory: `/Users/jamalromeh/Codex_Extractor/assets`
+- Smoke Signal assets/data URI banner:
+  - `/Users/jamalromeh/Codex_Extractor/assets/smoke_signal_banner_data_uri.txt`
+
+## Logic Boundary (Do Not Modify for UI Roadmap)
+- Core extractor/scoring/workbook logic modules:
+  - `/Users/jamalromeh/Codex_Extractor/src/codex_extractor.py`
+  - `/Users/jamalromeh/Codex_Extractor/src/totem_workbook.py`
+- Smoke Signal pipeline logic + callbacks:
+  - `/Users/jamalromeh/Codex_Extractor/smoke_signal_tab.py`
+  - `/Users/jamalromeh/Codex_Extractor/smoke_signal/scripts/*`
+
+## Stage 0 Outcome
+- Safe branch created.
+- Baseline screenshot stored.
+- UI vs logic file map documented.
+- Ready to begin Stage 1 (Design Tokens + CSS foundation) with no functional callback changes.