Make Apps status and version sources explicit

[redreceipt]

Summary

• Restore apollos_demo as the Church slug. Separate a sampled device build and last-seen time from the public US Apple lookup and its checked time.
• Show the source version alongside its comparison, with explicit “Behind top seen”, “Top seen”, “Behind source”, “At source”, “Ahead of source”, or “Unverified” status. Remove the ambiguous blanket “Outdated/Current”, unused table metrics, and their BigQuery aggregation so status stays visible.
• The public lookup may lag App Store Connect; this PR does not claim to verify the published release or add credentials. Other stores are not checked.

Validation

• 215 unit tests; Ruff check/format and focused mypy pass.

Proof

• Local /apps request traversed query construction with a disposable BigQuery client fixture and real public US Apple lookup. A later malformed v999 Preview event did not replace its valid runtime 106; the invalid-only app is Unverified with its comparison hidden, the SQL no longer requests unused user/event totals, and the status column is labelled. Unmatched iOS lookups also show when they were checked. Screenshot attached below.

[Copilot]

Copilot review overview

🔵 Needs a closer look

Validate malformed runtime values and clarify the template’s platform-specific version-selection description.

Review effort: Lite
Findings: None

What changed in this PR

Updates the Apps dashboard to distinguish observed builds, public Apple lookup versions, and freshness status.

Changes:

• Adds explicit version-source and timestamp fields.
• Replaces ambiguous status labels with detailed comparisons.
• Updates documentation, templates, and tests.

File	Summary
tests/​test_app_versions.py	Covers updated statuses and rendering behavior.
templates/​app_versions.html	Displays distinct build, lookup, freshness, and status data; one description needs clarification for TV and Roku selection.
README.md	Documents version-source semantics and lookup limitations.
app_versions.py	Computes source comparisons and timestamps; malformed runtime values should be marked Unverified rather than compared lexically.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟡 Changes recommended

Malformed mobile runtime values can replace valid selections, and the unused aggregation should be removed.

Review effort: Lite
Findings: 1

Open (1)

• Ignore malformed mobile versions during latest-version selection · New

[Copilot]

Copilot review overview

🔵 Needs a closer look

Resolve the status-label and unverified-comparison display issues.

Review effort: Lite
Findings: None

Resolved since last review (1)

• Ignore malformed mobile versions during latest-version selection

Previously missed (1)

In code that hasn't changed since last review

Roku status labels don't match the documented vocabulary

app_versions.py:551

The new Roku mapping can still render At source and Ahead of source, while the PR describes the status vocabulary as Behind top seen, Top seen, Behind source, or Unverified. Please either map the non-behind outcomes to the documented statuses or update the user-facing contract and tests to include these additional labels.

[Copilot]

Copilot review overview

🔵 Needs a closer look

Two moderate issues remain regarding lookup timestamps and the missing status-column header.

Review effort: Lite
Findings: None

Previously missed (1)

In code that hasn't changed since last review

Add missing Status table header

templates/​app_versions.html:167

The row now renders a separate status cell after the source-freshness cell, but the header row still ends at Source freshness. This leaves the status column unlabeled and shifts the Expo Runtime/Source freshness headings onto the wrong data columns for screen readers and visual table association. Add a Status header after this one.

[Copilot]

Copilot review overview

🔵 Needs a closer look

Unavailable Apple lookup cases do not display when the lookup was checked.

Review effort: Lite
Findings: None

Previously missed (1)

In code that hasn't changed since last review

Record store check time for unavailable iOS lookup results

app_versions.py:616

The checked timestamp is only attached when Apple returns a version. For an iOS bundle with no US result—or when the lookup fails—the table renders Not available without indicating when that lookup was performed, so the new source/checked-time distinction is lost exactly for the unavailable cases. Set store_checked_display for every eligible iOS row whenever the lookup attempt completes (including no-match/error), while keeping the version source as unavailable.

[Copilot]

Copilot review overview

🔵 Needs a closer look

Add assertions covering Roku “At source” and “Ahead of source” outcomes.

Review effort: Lite
Findings: None

[Copilot]

Copilot review overview

🟢 Approved

No unresolved blocking issues were identified.

Review effort: Lite
Findings: None