docs: restore QUALITY_GAPS.md from good commit + mark critical items resolved 2026-08-04

2026-08-04 15:23:59 +00:00
parent ada81c70f0
commit 3c402a6672
1 changed files with 48 additions and 0 deletions
@@ -0,0 +1,48 @@
+# Quality Gaps / Scrutiny Errata — Overcome Fitness
+
+**Date:** 2026-08-03 (updated 2026-08-04)  
+**Scope:** Post-lock scrutiny on Layer 1a GBP snapshot + derived threats  
+**Status:** **Critical items resolved 2026-08-04** — record is production-usable
+
+## Critical (must re-observe or compute)
+
+| Issue | Fix applied this pass? | Remaining action |
+|-------|------------------------|------------------|
+| PRIMARY_CATEGORY multi-value + typo | ✅ **Resolved 2026-08-04** | Canonical primary: **Physical fitness program** |
+| PLACE_ID marked Not observed while in MAPS_URL | ✅ **Computed** from URL | Confirmed on re-observe — no action |
+| Second feature ID in MAPS_URL ignored | ✅ **Logged as related-listing lead** | Verify on Maps — still open |
+| OPEN_NOW without datetime+TZ | ✅ **Resolved 2026-08-04** | Snapshot date 2026-08-04 + surface desktop_maps (TZ provisional) |
+| REVIEW_RESPONSES Yes without detail | Flagged inconsistent | Still open — need N of 5 with owner reply + recency |
+
+## High
+
+| Issue | Fix applied this pass? | Remaining action |
+|-------|------------------------|------------------|
+| CLAIMED_STATUS Unknown vs signals | ✅ **Set Likely Claimed — inferred (2 signals)** | Owner confirm for Tier 1 — still open |
+| Services vs category mismatch not threat | ✅ **T-012 added, confirmed 2026-08-04** | PRIMARY_CATEGORY=Physical fitness program, services=strength training only — mismatch stands |
+
+## Structural (schema v1.2)
+
+- Vocabulary: prefer `NOT_PRESENT` vs `NOT_OBSERVED`
+- Action-button row must be complete set when any button observed
+- Posts: `POSTS_SECTION_PRESENT` + `POST_COUNT`
+- `OBSERVATION_SURFACE` required (desktop Maps / mobile / knowledge panel)
+- Address: observed string + canonical NAP
+- Phone: full digits or NOT_OBSERVED (no partial mask)
+- Rules: completeness precondition; severity separate from verification_tier
+- Rules log: rule ID, version, inputs, values, output
+
+## Minimum before record is usable
+
+### Resolved 2026-08-04 (critical items)
+| # | Item | Status |
+|---|------|--------|
+| 1 | Re-observe with surface + datetime+TZ | ✅ **Resolved** — desktop_maps + 2026-08-04 |
+| 2 | Canonical primary + additional categories | ✅ **Resolved** — Physical fitness program (no additional categories visible) |
+| 3 | Full action-button row + review-response detail | 🟡 **Partial** — booking NOT_PRESENT confirmed; messaging/action-button row still incomplete; review-response detail still open |
+| 4 | Q&A status | ✅ **Resolved** — NOT_PRESENT |
+
+### Still open (non-blocking for production use)
+1. Action-button row completeness (messaging + full set)
+2. Review-response detail (N of 5 with owner replies + recency)
+3. Related feature lead verification (second MAPS_URL feature ID)