Polish CoastWise submission readiness

README.md

@@ -6,9 +6,12 @@ license: mit
 tags:
   - build-small-hackathon
   - backyard-ai
+  - openbmb
   - tiny-titan
   - off-the-grid
   - off-brand
+  - best-agent
+  - best-demo
   - openai-codex
 ---
 
@@ -30,8 +33,9 @@ Target badges and awards, pending final evidence:
 
 - Best Agent: active-session workflow trace from search/photo candidate to
   deterministic rule/advisory result and constrained explanation.
-- Tiny Titan / Bonus Quest Champion: submitted models must stay at or below 4B
-  parameters.
+- OpenBMB: MiniCPM5-1B is the planned small-model path for constrained
+  safety-result explanation.
+- Tiny Titan: the submitted model inventory stays at or below 4B parameters.
 - Off the Grid: cached name lookup, rule cards, and advisory overlays work
   without cloud APIs.
 - Off Brand: custom CoastWise Gradio interface.
@@ -40,6 +44,10 @@ Target badges and awards, pending final evidence:
 - OpenAI Codex: GitHub can remain private; public Hugging Face Space history
   must include Codex-attributed commits as judge-visible evidence.
 
+Not claimed in the current MVP: NVIDIA, Modal, or Bonus Quest Champion. Those
+should only be added if the final build includes the required sponsor/platform
+evidence.
+
 ## MVP Scope
 
 - Name search for curated San Francisco coast species, aliases, and grouped
@@ -54,22 +62,41 @@ Target badges and awards, pending final evidence:
 
 ## Model Inventory
 
-| Model | Provider | Role | Parameters | Runtime mode | Notes |
-|---|---|---:|---:|---|---|
-| MiniCPM5-1B | OpenBMB | Constrained safety-result explanation | 1.0B | Disabled/mocked fallback in current local MVP | Planned <=4B user-visible model path; deterministic safety result remains authoritative |
+| Model | Provider | Source URL | Role | Parameters | Runtime mode | Required for core safety | Award relevance |
+|---|---|---|---|---:|---|---|---|
+| MiniCPM5-1B | OpenBMB | https://huggingface.co/openbmb/MiniCPM5-1B | Constrained safety-result explanation | 1.0B | Disabled/mocked fallback in current local MVP | No | OpenBMB, Tiny Titan |
 
 Optional future path: MiniCPM-V 4.6 may assist or rerank photo candidates only
 inside the curated reference-image candidate set. No model fine-tuning is
 required for the MVP.
 
+All listed models are under the hackathon 32B cap. Tiny Titan remains eligible
+only while every submitted model stays at or below 4B total parameters.
+
+## Official Sources And Freshness
+
+Cached official source metadata is bundled for offline lookup. CoastWise treats
+cached rule or advisory data older than 30 days as stale and caps harvest-minded
+guidance at `verify_before_harvest` unless a stricter `do_not_harvest` rule
+already applies.
+
+Cache date for the current curated source set: 2026-06-13.
+
+| Source | Use | Cached URL |
+|---|---|---|
+| CDFW San Francisco Region Ocean Regulations | San Francisco coast species and rule-card baseline | https://wildlife.ca.gov/Fishing/Ocean/Regulations/Fishing-Map/San-Francisco |
+| CDFW Ocean Sport Fishing | General ocean sport fishing source for grouped cards | https://wildlife.ca.gov/Fishing/Ocean/Regulations |
+| CDPH Shellfish Advisories | Shellfish advisory overlay source | https://www.cdph.ca.gov/Programs/OPA/Pages/Shellfish-Advisories.aspx |
+| CDPH Annual Mussel Quarantine | Annual mussel quarantine overlay source | https://www.cdph.ca.gov/Programs/CEH/DRSEM/Pages/EMB/Shellfish/Annual-Mussel-Quarantine.aspx |
+
 ## Demo And Public Evidence
 
-- Demo video: placeholder, add public link before final submission.
-- Social post: placeholder, add public link before final submission.
-- Public Space history: push meaningful Codex-attributed commits to the Hugging
-  Face Space repository before claiming the OpenAI Codex award.
-- Source freshness: cached CDFW/CDPH data is labeled and treated as stale after
-  30 days.
+- Demo video: pending, add a public link before final submission.
+- Social post: pending, add a public link before final submission.
+- Public Space URL: pending, publish the Gradio Space under the official
+  hackathon organization before final submission.
+- Public Space history: pending, push meaningful Codex-attributed commits to the
+  Hugging Face Space repository before claiming the OpenAI Codex award.
 
 ## Local Run
 

app.py

@@ -21,14 +21,54 @@ from coastwise.submission import default_model_inventory
 APP_TITLE = "CoastWise"
 
 INTRO = """
-Offline California coastal species and harvest-safety lookup for the San
-Francisco coast MVP.
+Offline California coastal species lookup.
+
+SF coast harvest-safety guidance.
+"""
+
+APP_CSS = """
+.gradio-container {
+    max-width: 100vw !important;
+    overflow-x: hidden !important;
+}
+
+.gradio-container,
+.gradio-container * {
+    box-sizing: border-box;
+}
+
+.gradio-container .form,
+.gradio-container .block,
+.gradio-container .wrap,
+.gradio-container fieldset {
+    max-width: 100% !important;
+    min-width: 0 !important;
+}
+
+.gradio-container p,
+.gradio-container label,
+.gradio-container h1,
+.gradio-container h2,
+.gradio-container h3 {
+    overflow-wrap: anywhere;
+}
+
+@media (max-width: 640px) {
+    .gradio-container {
+        padding-left: 16px !important;
+        padding-right: 16px !important;
+    }
+}
 """
 
 LIMITS = """
-CoastWise is a conservative decision-support guide. It does not certify species
-identification, legality, harvest authorization, or food safety. Verify current
-CDFW and CDPH guidance before harvesting or eating sport-harvested shellfish.
+Conservative decision-support only.
+
+Does not certify species ID or legality.
+
+Does not authorize harvest or food safety.
+
+Verify CDFW/CDPH before harvest.
 """
 
 INTENT_LABELS = {
@@ -151,7 +191,7 @@ def render_photo_candidate(image) -> str:
 
 
 def build_app() -> gr.Blocks:
-    with gr.Blocks(title=APP_TITLE) as demo:
+    with gr.Blocks(title=APP_TITLE, fill_width=True) as demo:
         gr.Markdown(f"# {APP_TITLE}")
         gr.Markdown(INTRO)
         gr.Markdown(LIMITS)
@@ -186,4 +226,4 @@ demo = build_app()
 
 
 if __name__ == "__main__":
-    demo.launch()
+    demo.launch(css=APP_CSS)

specs/001-coastwise-lookup/quickstart.md

@@ -258,6 +258,72 @@ Expected outcome:
 - README includes target track/badge tags, model inventory, prompt/model role
   notes, safety limitations, source freshness policy, demo-video link, and
   social-post link.
+
+## Implementation Validation Log
+
+Recorded on 2026-06-13 from the isolated `coastwise-implement` worktree.
+
+### Automated Suite
+
+Command:
+
+```bash
+PYTHONPYCACHEPREFIX=/private/tmp/coastwise-pycache .venv/bin/python -m pytest -v
+```
+
+Result:
+
+- 39 passed in 1.14s.
+- Coverage included search, rule cards, CDPH advisory/quarantine logic,
+  generated-output constraints, reference-image photo candidates, privacy,
+  source freshness, and submission package validation.
+
+### Local Performance Snapshot
+
+Measured with local Gradio 6.18.0, Python 3.13.12, mocked/disabled model path,
+and deterministic in-process reference-image fallback.
+
+| Path | Result |
+|---|---:|
+| Cold `app` import including Gradio | 4345.90 ms |
+| `search_species("mussel")` average | 0.6572 ms |
+| generated explanation fallback average | 0.0182 ms |
+| reference-image photo fallback average | 0.0442 ms |
+| Python tracemalloc peak | 80.03 MiB |
+| Process max RSS, approximate | 202.28 MiB |
+
+### Manual UI Smoke
+
+Local server:
+
+```text
+http://127.0.0.1:8060
+```
+
+Screenshots captured with headless Chrome:
+
+- Desktop viewport 1280x900: `/private/tmp/coastwise-desktop-v3.png`
+- Phone viewport 390x844: `/private/tmp/coastwise-mobile-v6.png`
+
+Findings:
+
+- Desktop first viewport is readable and primary lookup controls are visible.
+- Phone first viewport has readable safety copy, usable controls, and no text
+  overlap or clipped first-viewport copy after the mobile-safe copy update.
+- Deterministic safety guidance remains visually before generated explanation
+  in rendered result Markdown.
+- Photo candidate section is visually separate from rule-card lookup.
+
+### Scenario Status
+
+- Scenarios 1-12 are locally validated by the automated suite, local HTTP
+  smoke, rendered-result checks, and screenshot smoke.
+- Scenario 13 is partially complete locally: README frontmatter, tags, model
+  inventory, source freshness policy, safety limitations, and public evidence
+  placeholders are present.
+- Remaining external gap: publish the Hugging Face Space, record a public demo
+  video, publish a social post, and push Codex-attributed commits to the public
+  Space history before claiming final OpenAI Codex and Best Demo evidence.
 - Unsupported sponsor or bonus claims are absent.
 - Codex usage is documented and backed by public Space commit history if
   OpenAI Codex is claimed.

specs/001-coastwise-lookup/tasks.md

@@ -207,16 +207,16 @@ export controls, and readable desktop and phone-sized layouts.
 **Purpose**: Final quality, performance, documentation, and submission-readiness
 work that cuts across all stories.
 
-- [ ] T060 Update final model names, source URLs, parameter counts, runtime modes, and award tags in `README.md`
-- [ ] T061 Update official source list, cache dates, and 30-day freshness policy in `README.md`
-- [ ] T062 Remove unsupported sponsor or bonus award claims from `README.md`
-- [ ] T063 Run the full automated suite with `PYTHONPYCACHEPREFIX=/private/tmp/coastwise-pycache pytest -v` covering `tests/`
-- [ ] T064 Measure search, generated explanation fallback, reference-image photo fallback, app import, and baseline memory budgets and record results in `specs/001-coastwise-lookup/quickstart.md`
-- [ ] T065 Complete desktop and phone-sized manual UI smoke validation and record findings in `specs/001-coastwise-lookup/quickstart.md`
-- [ ] T066 Validate all quickstart scenarios and record any gaps in `specs/001-coastwise-lookup/quickstart.md`
+- [X] T060 Update final model names, source URLs, parameter counts, runtime modes, and award tags in `README.md`
+- [X] T061 Update official source list, cache dates, and 30-day freshness policy in `README.md`
+- [X] T062 Remove unsupported sponsor or bonus award claims from `README.md`
+- [X] T063 Run the full automated suite with `PYTHONPYCACHEPREFIX=/private/tmp/coastwise-pycache pytest -v` covering `tests/`
+- [X] T064 Measure search, generated explanation fallback, reference-image photo fallback, app import, and baseline memory budgets and record results in `specs/001-coastwise-lookup/quickstart.md`
+- [X] T065 Complete desktop and phone-sized manual UI smoke validation and record findings in `specs/001-coastwise-lookup/quickstart.md`
+- [X] T066 Validate all quickstart scenarios and record any gaps in `specs/001-coastwise-lookup/quickstart.md`
 - [ ] T067 Verify Hugging Face Space README frontmatter, demo-video link, social-post link, and public Space Codex commit evidence in `README.md`
-- [ ] T068 Run a final safety review for deterministic rule authority, generated-output constraints, source links, stale-data behavior, reference-image photo boundaries, and no-persistence behavior in `tests/test_rules.py`, `tests/test_ai.py`, `tests/test_photo.py`, `tests/test_reference_images.py`, and `tests/test_privacy.py`
-- [ ] T069 Review repository status and ensure generated artifacts are ready for either implementation handoff or commit in `specs/001-coastwise-lookup/tasks.md`
+- [X] T068 Run a final safety review for deterministic rule authority, generated-output constraints, source links, stale-data behavior, reference-image photo boundaries, and no-persistence behavior in `tests/test_rules.py`, `tests/test_ai.py`, `tests/test_photo.py`, `tests/test_reference_images.py`, and `tests/test_privacy.py`
+- [X] T069 Review repository status and ensure generated artifacts are ready for either implementation handoff or commit in `specs/001-coastwise-lookup/tasks.md`
 
 ---