Skip to content

Pages client: Prism product model of the page, generated from it, with browser acceptance - #132

Merged
afflom merged 20 commits into
mainfrom
claude/project-thread-1dvr1c
Nov 11, 2026
Merged

afflom merged 20 commits into
mainfrom
claude/project-thread-1dvr1c

Conversation

@afflom

@afflom afflom commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Requested by Alex · project thread

v0.4 lane 6. Builds on #129, which added closure v2. It is up to date with main (99c4290: #130, #131, #134, #133).

What was broken on the v0.3 page

I drove the page in headless Chromium with real files and with archives the CLI wrote.

  • Traps: Verify, every example button, and decompressing any folder or multi-file archive hit a WebAssembly trap (unreachable). After one trap, every later action trapped until the page was reloaded.
  • Cause: in-memory decoding always spawned threads, which wasm32-unknown-unknown cannot do. Now one core decodes in stream order with no thread.
  • Large files: compressing an 18 MB file took 90 s. The page was frozen the whole time, and there was no way to cancel.
  • Confusing controls: one file field took both inputs and archives. Choosing a folder silently ignored a chosen file. The "program-search steps" field had no effect a visitor could see.

The product model: src/Uorc/Page.lex.tex (UC-WEB-01)

The model uses Prism's product-modeling vocabulary from the PrismPM stdlib:

  • Foundation.Arch: stakeholders, features with their calls and acceptance cases, journeys, and the UML state machine (7 states, 11 transitions).
  • Foundation.Qual: quality requirements and measures.
  • The text/3 workbench: operations, fields, controls (each with the states it is enabled in), examples, error hints, sections, usage, links and labels.

The model declares these records itself because the page works on files, which the text/3 profile does not carry. Each record keeps the field names of its Prism counterpart.

repo-model (crates/model/src/page.rs) checks the model the way PrismPM checks its own:

  • PP2014–PP2017 for features and journeys.
  • Exactly one initial state, closed triggers, and every state reachable.
  • Closed sets of operations, controls, field kinds, error codes and tables.
  • Links that go only to GitHub or to files of the site.

It then renders web/index.html, and check-model requires that file to match the rendering byte for byte. app.js reads the model embedded in the page and runs it: the state machine, the controls each state enables, the operations and their fields, the examples and the error hints.

The page

  • Workbench: tabs for Compress, Decompress, Inspect and Verify, each showing its own fields.
  • Worker: the codec runs in a module worker, which is uorc.js itself. The page shows progress and an estimate of the time left. Cancel takes about 0.1 s.
  • Streaming: files and folders stream a frame at a time. compressTreeBlob and decompressTreeBlob use FrameEncoder::objects over the tree layout and split each decoded frame at its object lengths. A wasm test checks that a streamed tree produces the same bytes as the library's compress_tree and restores the same entries.
  • Errors: every failure shows the model's title, explanation and recovery. A worker that dies is replaced.
  • SIMD: the wasm build uses SIMD128: 1.34x faster, with the same bytes.

Acceptance: scripts/page-acceptance.mjs

The script drives the built site in headless Chrome over the DevTools protocol, with no npm dependencies. It covers:

  • the 3 journeys and the 18 acceptance cases, including restoring the released v0.2.0 and v0.3.0 archives
  • all 11 transitions
  • every control, checked against the model in every state
  • every uorc.* call a feature names, which must be defined in the uorc.js that ships

All gates pass against ncm v4 (#133); memory and throughput below are from that run.

Gated measure Result Limit
Longest page task while running 0 ms 200 ms
Cancel 108 ms 3000 ms
Time to ready 211 ms 5000 ms
Archives that differ from the library's 0 0
WebAssembly memory after a 3-frame stream 215 MiB 256 MiB
Controls without an accessible name 0 0

Measured but not gated: compress 178 KB/s, decompress 467 KB/s. Planted defects are recorded in docs/verification/pages-client.md.

CI through the factory

The acceptance is the factory obligation pages, and the release gate requires it. Its identity covers only what the page reads. The formal set now includes web/index.html, because that file is a projection of the page model. Without it, #131's materialized reproducibility leg could not find the file.

The rest legs ran out of space in PrismPM's native regeneration. Measured in the leg: the SDK container's /tmp is a 2 GiB tmpfs, and CARGO_HOME (/tmp/prismpm-cargo-1001) already holds 1.1 GiB of it. PrismPM copies the tree there and runs just model-write with a cleared environment, which rebuilt xtask beside the copy (0.69 GiB at peak). Now template-check leaves .tmp/model-write-target, which is copied with the tree, and model-write builds into target/regeneration on the workspace's disk. It has a directory of its own because a binary built from the copy carries the copy's paths, and cargo would take it as current for the workspace.


Generated by Claude Code

…sure v2

Uorc.Neuromorphic (src/Uorc/Neuromorphic.lex.tex) states the plasticity of
every learning part of the ncm coder as the Prism neuromorphic standard, in
the codec's own integer (offset) form, with kernel-checked bounds:

- hebbianBoundsHold: every mixer weight stays within +-2^22 under the
  bounded Hebbian rule; potentiation never lowers and depression never
  raises a weight.
- plasticityBoundsHold: the plasticity 24 + 104*4096/(4096+pos) lies in
  [24, 128] per 65536 (closed vectors 128, 76, 25, 24 by decide).
- laneFitHolds: |x * err * plasticity| <= 1,073,217,536 < 2^31, so the
  SIMD kernels' 32-bit lanes cannot overflow, and one bit changes a weight
  by at most 16,376.
- slot plasticity: rates 131072/(2n+3) lie in [510, 43690], a slot never
  steps past its gap to the coded bit, and consolidates at count 127.
- refinementBoundsHold: probability-map points stay within 16 bits.

The products are proved through `scale`, the product by its recursion
(scaleIsMultiply bridges it to `*`), with each bound carried in one
induction, since omega has no nonlinear arithmetic.

The native coder reads the model's constants from ncm::standard (byte
identical output); tests/neuromorphic.rs holds them equal to the model's and
the theorem inventory complete. Registered as UC-NEU-01 (kernel_theorem).

The Pages site becomes a Prism browser closure v2 (PrismPM SPEC 1.2.1):
index.html, app.css, app.js, uorc.js, uorc_bg.wasm, provenance.json and the
ten Hologram brand files (fonts, licences, icons, manifest.webmanifest),
flat and same-origin, installable, with no remote load. The brand files are
vendored byte-identical to PrismPM's (vendor/hologram-brand).
scripts/site.mjs assembles and checks the closure (provenance.json names
every file's SHA-256); release.yml uses it and `just test` runs its tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3MmVJi8mhN3UZ6rgwH
…-5h3yzm

# Conflicts:
#	.github/workflows/release.yml
#	scripts/ci-receipt.sh
…h browser acceptance

src/Uorc/Page.lex.tex states the page in Prism's product-modeling vocabulary
(Foundation.Arch stakeholders, features, journeys and UML state machine;
Foundation.Qual requirements and measures; the text/3 workbench's operations,
fields, examples, error hints, sections, usage, links and labels), registered
as UC-WEB-01. repo-model checks it as PrismPM checks its own (PP2014-PP2017,
one initial state, closed triggers, reachability, closed sets) and renders
web/index.html from it; app.js interprets the embedded model.

The codec runs in a module worker (uorc.js), with progress, Cancel, typed
error hints and recovery from a stopped worker. In-memory decoding no longer
spawns threads, which trapped WebAssembly on Verify, every example and every
folder archive. The wasm client builds with SIMD128 (1.34x, same bytes).

scripts/page-acceptance.mjs drives the built site in headless Chrome over the
DevTools protocol: every journey, all 17 acceptance cases, all 11 transitions,
controls checked against the model in every state, gated quality measures.
CI runs it in pages-client.yml.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
The page acceptance runs as obligation `pages` (factory/graph.json): its
identity covers the client set, the wasm crate, web/, the brand files and the
two site scripts, so other changes find its receipt and skip it. The release
gate needs it, and factory.yml records its receipts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
@afflom afflom self-assigned this Nov 10, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
The sequential one-core decode path stays ahead of the threaded scheduler,
which now counts cores per block. The acceptance's repeat input is a
repeated passage: under #130 three all-zero frames are coded as ncm frames,
not reference frames, so they no longer exercise reference decoding.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
compressTreeBlob and decompressTreeBlob run a file tree a frame at a time
(FrameEncoder::objects over the tree layout; decoded frames split at their
object lengths), so a folder of any size never sits whole in wasm memory.
The wasm test checks the streamed tree equals the library's compress_tree
bytes and restores the same entries. The model's features name the new
calls, and the acceptance checks that every uorc.* call a feature names
exists in the shipped uorc.js.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
The formal and scripts sets exclude the page acceptance and its workflow;
the pages obligation and its gate edge sit beside #131's per-leg inputs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
…e model

#131's legs run on a checkout materialized to their inputs, and the formal
set excluded web/, so reproducibility found the check-model projection
web/index.html missing (URP004). The page is rendered from
src/Uorc/Page.lex.tex, so it belongs with the formal inputs; the rest of
web/ stays out.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
…hives

New acceptance case decompress-released (feature decompressArchive): every
archive in crates/uorc/tests/compat is restored in the browser to its
original bytes. Measured against ncm v4 (#133): 18 cases pass; compress
178 KB/s, decompress 467 KB/s, worker memory 215 MiB.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
The rest legs fail with ENOSPC while PrismPM's template check builds the
regeneration copy in the SDK container's 2 GiB /tmp; locally the copy and
its build peak at 0.72 GB both at the last green revision and now. Print
what holds /tmp at that point so the cause is measured, not guessed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
Measured in the rest leg: when PrismPM's native regeneration starts,
/tmp (2 GiB tmpfs in the SDK container) already holds 1.2 GB, all of it
/tmp/prismpm-cargo-1001, the debug xtask build audit-bootstrap leaves
there. The regeneration copies the tree (0.13 GB) and builds it from
scratch (0.72 GB at peak, measured in a 2 GiB tmpfs), so the lexlean
rlib write hits ENOSPC. Running the template check first gives it an
empty /tmp; both checks still run and must pass. Drops the /tmp report.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
…the template check

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
…target

Measured in the rest leg: the SDK container's /tmp is a 2 GiB tmpfs and
CARGO_HOME (/tmp/prismpm-cargo-1001) already holds 1.1 GiB of it when the
template check starts. Native regeneration copies the tree there (0.13 GB)
and built it from scratch beside the copy (0.69 GiB at peak), which ran
out of space writing the lexlean rlib. With CARGO_TARGET_DIR at the
workspace's target on disk the build reuses audit-bootstrap's compiled
dependencies, rebuilds the workspace crates from the staged sources, and
/tmp holds only the copy (measured in a 2 GiB tmpfs: 0.13 GB, 4 s instead
of 43 s). Restores the original order and drops the diagnostics.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
…de the staged copy

PrismPM runs model-write in a copy of the tree staged in the SDK's /tmp
(a 2 GiB tmpfs of which CARGO_HOME holds 1.1 GiB) with a cleared
environment that keeps only PATH, the toolchain homes, HOME and
XDG_CACHE_HOME, so CARGO_TARGET_DIR (8032234) never reached it. The
template check now leaves .tmp/model-write-target, which is copied with
the tree, and model-write builds into that directory (the workspace's
target on disk) when the note is there and into target otherwise.
Simulated with the same cleared environment in a 2 GiB tmpfs: /tmp holds
only the 0.13 GB copy.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
…of its own

On e6399ae the template check passed, but the next recipe (validate) ran
the xtask binary the staged copy had built into the workspace's target:
cargo took it as current, and it read sources at the copy's deleted
/tmp path. The note now names target/regeneration, still on the
workspace's disk and shared with nothing else.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N6Mcveqrwnu6XBiYk
@afflom
afflom merged commit 7452a14 into main Nov 11, 2026
17 checks passed
afflom pushed a commit that referenced this pull request Nov 11, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3PhocgkyQBi9JbhCuH
afflom pushed a commit that referenced this pull request Nov 11, 2026
Registry keeps UC-WEB-01 and UC-PERF-02..06; projections regenerated (34 ids).

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3LszhHCxmceQ2V8xxx
afflom pushed a commit that referenced this pull request Nov 11, 2026
#136's choice rule (x86 before size) moves into portfolio::family; its
retrained weights are reseeded in model/engine.toml and weights.rs is
regenerated from them. The outcomes table and its example stay removed:
the engine decides the weights over a κ-named corpus.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3LeJgXkUvvAfeAGt9A
afflom pushed a commit that referenced this pull request Nov 11, 2026
Takes lane 3's resolution of #136 against the portfolio table (its weights
reseeded in weights.rs) and main's factory sets with the frontier entries;
re-decides the offline corpus at main's export identity.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3QshCSRwiddS64zU3j
afflom pushed a commit that referenced this pull request Nov 11, 2026
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.

2 participants