Skip to content

Add a public occurrence sample browser for EdgeMech - #225

Open
realmarcin wants to merge 2 commits into
mainfrom
feat/edge-pages-browser-20261119
Open

realmarcin wants to merge 2 commits into
mainfrom
feat/edge-pages-browser-20261119

Conversation

@realmarcin

@realmarcin realmarcin commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

EdgeMech's committed occurrence sample and review records currently require reading JSONL files. This adds a static GitHub Pages browser for the 10,000-occurrence public sample, with search, transform/disposition/cohort filters, independent source-fidelity and scientific-support filters, stable detail links, CSV/JSON downloads, and a 100-page catalogue that works without JavaScript.

The page labels its sample scope throughout. Original claims remain distinct from recorded curated changes; inherited presence/rule labels are provenance rather than scientific approval. The two historical 50-occurrence assessment cohorts remain separate from the other 9,900 sample occurrences. A dated metadata section describes the separate 17,637,435-occurrence census and its zero exact-eligible inherited-scope transfers; external Parquet is not hosted.

The standard-library builder verifies seven public inputs against an immutable Git commit and retained sample hash, rejects inconsistent claim/review bindings, allowlists the public projection, and records output hashes. It publishes no retrieved quotations, private source rows or private paths, and invents no repository license. The Pages workflow checks PR builds and deploys only from main. Pages configuration and an authorized merge are still required before the URL can be advertised as live.

Validation: 712 Python tests passed, including 14 publication regressions; four Node behavior tests passed; Ruff and all 16 pinned CLAW contract checks passed; source/wheel distributions built offline. One real occurrence was built and verified before the full build using the same launcher, output path, installed Chrome and browser-check path. Full desktop/mobile QA covered detail reload, filters, CSV persistence, empty/reset/markup input, keyboard navigation, no-JavaScript fallback and failed data loading, with no JavaScript errors. Receipts are retained in docs/validation/public-browser-20261119/.

The public JSON is 7,772,380 bytes (1,225,174 bytes deterministic gzip). The 106 generated files total 18,727,800 bytes before the build receipt. Generated site files and screenshots remain outside Git; source, checks and provenance receipts are retained.

Independent review found that GitHub cannot render source-row anchors in the 7.85 MB manifest. Interactive and static views now link to the full pinned raw JSONL artifact and visibly retain the 1-based source line and SHA-256. One real HTTP download verified status, content type, exact length/hash, and the original occurrence/triple at the advertised line. The finding and resolution are retained in docs/validation/public-browser-20261119/review-resolution-227.md. Follow-up independent verification is pending; this PR is not authorized to merge.

Fixes #227.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Browser source-row links target a manifest too large for GitHub line rendering

1 participant