feat: initial commit

ci-observer-handover/contexts/CI_OBSERVER_COMPACT_DUMP.md

@@ -0,0 +1,59 @@
+# CI Observer Compact Dump
+
+## Current Production (authoritative)
+- Server path: `/webapps/ci-observer-dashboard-prod`
+- Container: `ci-observer-dashboard-prod`
+- Port: `8089 -> 8088`
+- Deploy branch: `main`
+- Health check: `curl -s http://127.0.0.1:8089/api/config`
+
+## Stack
+- FE: HTML + CSS + Vanilla JavaScript
+- BE: Python + FastAPI
+- FE-BE bridge: REST API (`/api/runs`, `/api/filters`, `/api/config`)
+- Data layer: SQLite + GitHub Actions API
+
+## Required Env
+- `GITHUB_TOKEN`
+- `GH_REPOS`
+- `GH_WORKFLOWS` (required for polling in current logic)
+- `REFRESH_SECONDS`
+- `DASHBOARD_TITLE`
+
+## Key Features in main
+- Metadata-rich run cards (event, actor, author, commit SHA, message, date, duration)
+- Repo short name display (without org prefix)
+- Race-style clock (`HH:MM:SS.cc`) + date in same panel
+- Light mode toggle (hanging bulb), default dark, preference in localStorage
+- Light mode contrast tuned for pass/fail (medium)
+
+## Recent Important Commits on main
+- `689a78c` merge: metadata cards + race clock
+- `a719b7d` docs: runbook + architecture + stack overview
+- `d33f96e` merge: light mode toggle + contrast tuning
+
+## Standard Production Update
+```bash
+cd /webapps/ci-observer-dashboard-prod
+git checkout main
+git pull
+docker compose up -d --build
+```
+
+## Troubleshooting Fast Path
+- UI loads but no runs:
+  - check `.env` (`GH_WORKFLOWS` not empty)
+  - `docker compose up -d --build`
+- FE change not visible:
+  - browser hard refresh `Ctrl+Shift+R`
+
+## Test Workflow Pattern
+- Create isolated test folder: `/webapps/ci-observer-dashboard-<feature>`
+- Use separate port (e.g. 8090)
+- Validate, then merge to `main`, deploy prod, cleanup test folder
+
+## Canonical Docs
+- `docs/OPERATIONS_RUNBOOK.md`
+- `docs/ARCHITECTURE.md`
+- `docs/STACK_OVERVIEW.md`
+- `ci-observer-handover/AGENTS.md`