Skip to content

Publish immutable Orrery graphs and render run visualizations - #1

Merged
anth-volk merged 10 commits into
mainfrom
feat/immutable-run-viewer
Oct 14, 2026
Merged

anth-volk merged 10 commits into
mainfrom
feat/immutable-run-viewer

Conversation

@anth-volk

@anth-volk anth-volk commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #2

Implement the runs application as three commits: Next.js and isolated environment provisioning; authenticated immutable publication API; Orrery React viewer with deep links.

Authentication reuses short-lived collector sessions without requiring a telemetry run. Graph bytes upload directly to storage with exact-object, non-overwriting signed URLs, avoiding function body limits. Finalization verifies inventory digests, JSON, Orrery parsing, and evidence references. Same-content retry is idempotent; conflicting content or owners cannot overwrite publications.

Provisioned production, preview, and development Blob stores and BLOB_STORE_ID values, enabled OIDC, and deployed https://microcosm-runs.vercel.app. No producer upload secret or collector signing key is introduced. Required configuration and provisioning commands are documented.

Checks: 28 app-owned tests, lint, typecheck, production build. Independent live development-store qualification passed for a 22,020,322-byte synthetic graph, overwrite rejection, exact retry, and downloaded digest. No cross-stack tests and no automated visual inspection.

Dependency: PolicyEngine/calibration-diagnostics#208 must merge and deploy before authenticated production uploads work. Production API qualification remains pending that deployment. The user confirmed that the local synthetic Orrery viewer displays correctly.

This branch also includes #7 (release automation: every merge to main versions, tags and deploys to Vercel production) and #6 (viewing local Microcosm output during development). #4 closed unmerged, so the app keeps its own reader. Merging this PR runs the first automated release, 0.2.0.

MICROCOSM_RUNS_LOCAL_DIR points the metadata and file routes at preserved
Microcosm publication directories instead of Blob storage, applying the same
size, digest, JSON, Orrery and source-reference checks as publication. The
viewer accepts the graph from this app's own route only for that exact path.
Only inventory-listed files are served, writes still use Blob, and a
production server refuses the setting.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adopt the org's two-pass push workflow. On a merge commit, push.yaml
bumps package.json from the changelog fragment types, builds
CHANGELOG.md with towncrier and commits "Update microcosm-runs" with the
PolicyEngine GitHub App token. On that commit it runs every check, tags
the commit with the bare version, then builds and deploys exactly that
commit to Vercel production and checks the public homepage.

pr.yaml adds actionlint, a typed changelog fragment check and a
"Required checks" aggregate; ci.yml becomes a reusable workflow called
by both. vercel.json turns off Vercel's own production deploys from main
so production never skips the checks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Release and deploy automatically on every merge to main
@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
microcosm-runs Ready Ready Preview Oct 14, 2026 9:21pm UTC

Request Review

anth-volk and others added 3 commits October 15, 2026 01:13
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Read publications from a local directory during development
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@anth-volk
anth-volk marked this pull request as ready for review October 14, 2026 21:21
@anth-volk
anth-volk merged commit aabaa8a into main Oct 14, 2026
6 checks passed

This branch was successfully deployed

1 active deployment
Preview — 6220c071 Deployed Oct 14, 2026 by vercel[bot]
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.

Host immutable Orrery graph publications and a React viewer

1 participant