Skip to content

Epic: Website compute surfaces (#493) - #511

Draft
neuromechanist wants to merge 17 commits into
stagingfrom
feature/issue-493-epic-compute-web
Draft

neuromechanist wants to merge 17 commits into
stagingfrom
feature/issue-493-epic-compute-web

Conversation

@neuromechanist

Copy link
Copy Markdown
Contributor

Epic #493: the website's compute surfaces. Draft until nemar-cli's Epic D (nemarOrg/nemar-cli#2116) is on dev; do not merge before it.

What lands

Gates run on this head

  • bun run lint, bun run typecheck (0 errors): pass.
  • vitest: 5,470 pass, 0 fail, 0 skipped when the drift tests read the nemar-cli Epic D checkout (the same file mapping CI uses); without a checkout, 5,436 pass and the 5 drift files skip.

Order and the red checks

  • The drift tests compare the website's copy and contracts with nemar-cli dev, so they are red here until Epic D (#2116) merges into dev. In the other direction, nemar-cli's account-copy parity test is red on #2116 until this epic's keys are on the website. That cycle is why #2116 carries the one-time parity exception and merges first.
  • Release gate: do not promote until the production API serves GET /compute/me; a site talking to an API without it shows one "not available" notice (ADR 0030).
  • The terms page link 404s until the docs repository publishes the compute terms (held for counsel).

* Capture compute access fixtures from the backend

* Parse compute access onto the session user

* Transcribe the compute access copy

* Add the compute gap block and affiliation row

* Derive compute state and add the request client

* Add refusal renderer, compute flag, docs paths, personas

* Add the Settings compute access card

* Add local backend recipe and ADR 0030

* Bind the local backend to loopback and guard it

* Open the terms link in a new tab

* Fix the terms fallback and empty refusal lists

* Record the D2 hand-off in ADR 0030
* Mirror the compute read vocabulary

* Capture compute read fixtures

* Add SU and time formatters

* Add usage chart geometry

* Add compute job state badges

* Add the compute read client

* Add compute page copy keys and Settings link

* Add compute view models and labels

* Add chart color tokens

* Route /compute to the app host

* Add compute badge, panel and notice components

* Add access, balances and queue panels

* Add the usage chart panel

* Add the jobs table with Load more

* Add the compute page

* Link compute from the user menu

* Guard the compute page wiring

* Offer one way back after a bad cursor

* Seed compute data in the local backend

* Record the compute dashboard phase

* Fix the notice prop type

* Rename SU formats, share contract extractors

* Separate the chart series by lightness too

* Keep a chart stack inside the plot

* Use American spelling in compute text

* Leave modified clicks on Load more alone

* Tighten usage states, caption unit and labels

* Mirror the reworded compute copy

* Soften the compute access lede
* Capture admin compute fixtures from the backend

* Mirror and drift-test the compute admin contract

* Add formatSu and job state badges

* Add the admin compute API client

* Add admin compute view models

* Transcribe the compute_admin copy keys

* Add the compute decide flow

* Add the Compute admin tab and badge

* Add quarter and gateway view helpers

* Add the admin Compute page and request rows

* Guard the admin Compute tab sources

* Seed the admin Compute world in the local backend

* Trim dialog labels and keep flags on one line

* Document the admin Compute tab

* Spell the compute copy keys out for the consumer rule

* Reword compute_admin copy and add error keys

* Give decisions a 25 s deadline and move sentences to copy

* Tell the admin to check email after a lost decision answer

* Uncache the Compute page, hand the opener to the dialog, say when cut off

* American spelling, escape unknown job states, order CI notes

* Widen the Compute source scan to the libs

* Update the copy key count in the handoff

* Use E2's job state and source lists, fix the shared drift extractors

* Read errors with the shared compute reader

* Use jobBadge, keep admin libs out of the dashboard scan

* Note what the admin tab shares with E2
* Capture the compute CLI help as fixtures

* Add the compute dialog instruction builder

* Pin the compute dialog to the CLI help

* Replace the dataset page Compute dialog

* Guard the Compute dialog wiring

* Top-align the multi-line copy button

* Format the Compute dialog tests

* Document the Compute dialog (ADR 0030, map)

* Carry the page fragment through sign-in

* Lead the access step with the shared lede

* Scan every rendered dialog string

* Refresh the captured CLI help
* Capture job page fixtures from the backend

* Transcribe job page vocabulary with drift test

* Add job page clients to the compute API

* Make job logs safe to show

* Word the job failure codes

* Share one charge rule

* Add job page view models and polling rules

* Forward the truncated header; skip cache for compute

* Add the compute job page

* Fix local time wording and back link target

* Document the job page

* Give job read and cancel longer deadlines

* Test the held result links as a pure state

* Write out direction marks in job logs

* Scan job files for navigation and beacons

* Fix job page review findings in the browser code

* Update job page docs after review
* Update admin badge and card after a decision

* Place empty chart text between gridlines

* Hide empty Actions card and stray download line

* Backdate seeded job records to their start

* Fix doubled period in decision announcement
…epic-compute-web

# Conflicts:
#	.context/decisions/README.md
#	.context/handoff.md
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

Deploying nemar-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0e06e24
Status: ✅  Deploy successful!
Preview URL: https://8c43b36c.nemar-website.pages.dev
Branch Preview URL: https://feature-issue-493-epic-compu.nemar-website.pages.dev

View logs

@neuromechanist

Copy link
Copy Markdown
Contributor Author

Review fixes pushed to this branch (25345aa). Merged origin/staging first (changelog and version only, no conflicts). Still a draft, waiting for nemar-cli#2116.

  1. Changelog: added entries for the admin Compute tab (E4), the replaced dataset-page dialog (E5), and folded the browser-check fixes and copy changes (Epic browser check fixes for the compute web epic #508, Transcribe compute copy changes from nemar-cli #509) into the entries they belong to; trimmed the CI-internal sentences from E1 and E2 and kept the release gate (do not promote before the API serves GET /compute/me).
  2. CLI help: recaptured test/fixtures/compute/cli-help/ from nemar-cli 17d5efb9 (Epic D head); the parity test passes with no further changes. Corrected the "paths are not in the CLI's help" sentence in ADR 0030's E5 addendum and the header of src/lib/compute-instructions.ts: the help now states them and the dialog deliberately stays silent until compute opens. No path text added to the dialog.
  3. Assistant widget: /compute added to OSA_WIDGET_EXCLUDED_PATHS; the exclusion test now covers /compute, a job page, /oauth/authorize and a sibling-prefix path that must still render the widget.
  4. ADR 0030: added the E4 addendum (nothing owner-only or cost-bearing offered; a non-owner cannot Grant their own row, an owner may; the export-review checkbox gates the button but is not recorded; the badge derives from the first page of the requested listing). Refreshed the "Two interim decisions" and Consequences text for D2 having landed, and added E4 to the receipts.
  5. Badge page size: lowered from 200 to 50 rows (50+ when capped); the existing capped handling made this a constant, comment and test-value change only. Link to nemar-cli#2085 kept.
  6. 404 text: a 404 with no code (the router's own "no such route") now reads "Compute is not available on this server yet." using the /compute page's website-owned label, so no mirrored copy key was added and nothing changes in nemar-cli account-copy.ts. A 404 that carries a code (account_not_found and so on) keeps the backend's sentence. Test added.
  7. Drift test: COMPUTE_ACCESS_STATES is now compared in full against nemar-cli's.
  8. CI comment: the numbering comments in ci.yml now read EIGHTH, NINTH, TENTH, ELEVENTH in order.

Gates: bun run lint and bun run typecheck clean; bunx vitest run with the NEMAR_CLI_* variables pointed at a checkout of 17d5efb9: 203 files, 5471 tests passed, none skipped.

Mirror nemar-cli's COMPUTE_TERMS_PUBLISHED in the gap table, tag Affiliation only where requests are open, and drift-test the constant.
@neuromechanist

Copy link
Copy Markdown
Contributor Author

Follow-up pushed: no compute nudge from the site's own gap table while the compute terms are unpublished (owner's ruling; nemar-cli computeProfileGaps gate at 82ddd0a0).

  • Choice (a): the Settings and admin pages derive gaps locally (the admin review card always does), so the site mirrors the gate with its own COMPUTE_TERMS_PUBLISHED in src/lib/compute-terms.ts, drift-tested against nemar-cli's constant in test/compute-terms-contract-drift.test.ts.
  • profileGaps (src/lib/profile-gaps.ts): while unpublished it raises no Affiliation gap and names compute_access in no gap's blocks, dropping a gap left with none. Applied to the wire profile_gaps as well as the derivation, so the two paths stay indistinguishable and an API that has not gated its own list cannot put a nudge on a page. Published, the output is unchanged (the existing 512-combination sweeps now run with computeTermsPublished: true). A refusal's own missing list (gapsForFields, the compute request flow) is deliberately not gated, as in the contract.
  • Settings: the Affiliation field's "needed to request compute access" tag now needs the request form to be on offer (computeOpen); in the production build while unpublished the field reads optional.
  • COMPUTE_REQUESTS_ENABLED cannot be true while COMPUTE_TERMS_PUBLISHED is false (new test in flags.test.ts); the three constants flip together.
  • Tests written first: unpublished raises no affiliation gap for an account without one, published does; no gap names compute access; unpublished equals published minus affiliation minus the compute block over all 512 combinations; wire and derivation agree; ungated wire entries are filtered; a refusal list is untouched.
  • Also updated: ADR 0030 (Consequences and the Affiliation tag sentence) and the E1 changelog entry.

Deliberately not changed, please say if the owner wants it: the inert Settings card ("not open yet", state none, production while unpublished) and the dataset page dialog's "not open yet" notice still show, as ADR 0030 designed them. They state that compute is not open rather than nudging toward a request; hiding the card for none while !computeOpen is a small change in settings.astro.

Gates: lint and typecheck clean; bunx vitest run with the NEMAR_CLI_* variables at nemar-cli 82ddd0a0: 203 files, 5484 tests passed, none skipped.

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.

1 participant