BACKLOG.md

CoastWise — Backlog & Handoff

Last updated: 2026-06-15. Picks up after the UI redesign + first deploy.

Shipped (2026-06-15)

• UI/UX redesign ("Ocean & Trust"): custom teal/navy Gradio theme (Lexend + Source Sans 3), branded header with offline-ready badge, status-badge answer cards, "How CoastWise reached this answer" disclosure, example chips, embedded Ask button inside the search field, top source bar ("Sources updated … · freshness") with a compact refresh icon button, light/dark pairing, responsive
  • WCAG-minded contrast/focus.
• Gradio 6 correctness: theme/css applied via launch() (ignored on gr.Blocks in v6); answer text uses adaptive --body-text-color (Gradio mangles .dark custom selectors and .prose * outranks single-class colors); sdk_version: 6.18.0 pinned so the Space can't fall back to v5.
• Offline-first Refresh: bounded, concurrent fetch (≤3s) that never hangs the UI, with a "Checking…" state and graceful "using last-good cache" messaging.
• Freshness: re-stamped the seed cache to 2026-06-15 (reads "current"); the freshness test is now deterministic relative to the seed time.
• Copy: dropped the "CDPH cached evidence:" prefix from advisory answers.
• Deployed: GitHub Mr-Perfection/build-small-hack (main) and the live HF Space build-small-hackathon/coastwise (themed UI verified live).

Backlog (next session)

Priority order for the 2026-06-15 23:59 UTC submission:

1. Demo video — record the ~90s demo path; link it in the README ("Demo And Public Evidence").
2. Social post — create one; link it in the README.
3. openai-codex badge integrity — the Space history is currently Claude-co-authored, not Codex. Either drop the openai-codex tag from the README frontmatter, or land genuine Codex-attributed commits before claiming it.
4. openbmb / tiny-titan substantiation — on main, MiniCPM is "disabled/mocked." The real in-process MiniCPM integration lives on the unmerged source-derived-qna branch (see below). Decide how to substantiate these awards.
5. Reconcile source-derived-qna with the new UI — that branch has ~10 unmerged commits (in-process MiniCPM interpreter, seed expanded to ~47–78 source-verified species + dynamic refresh, location-asked-in-question UI that drops the Beach/coastal-area field, fuzzy place matching, the "dungeness crab rules" real-values fix). It has a different app.py/UI, so merging it will conflict with the redesign shipped today. Plan the merge deliberately (likely: take the branch's backend/data/model work, re-apply today's UI on top).

Handoff notes

• Current Spec Kit plan: specs/002-source-backed-qna/plan.md (+ tasks.md).
• Live Space: https://huggingface.co/spaces/build-small-hackathon/coastwise (creating it in the org IS the submission). stephenlee is now an org member.
• HF push: write token is in .env as HF_WRITE_TOKEN (gitignored — never commit it). Push via a git credential helper reading the env var; do not embed the token in the remote URL. The space remote is configured (plain URL). Docs-only changes go to GitHub only (avoid pointless Space rebuilds).
• Tests: PYTHONPYCACHEPREFIX=/private/tmp/coastwise-pycache .venv/bin/python -m pytest -q → 100 passing. .worktrees/ is skipped by pytest (dot-dir). docs/ is gitignored.
• Stale worktree: .worktrees/coastwise-implement (branch merged into main) is safe to git worktree remove. .worktrees/source-derived-qna is the unmerged feature branch above — keep it.
• Local preview: GRADIO_SERVER_PORT=7860 .venv/bin/python app.py; verify rendering with headless Chrome via Playwright (channel="chrome", drive ?__theme=light|dark). Playwright + huggingface_hub are installed in .venv (dev only — not in requirements.txt).