Skip to content

feat(view): Hologram design system for every Prism app, closure v2 and build provenance - #550

Merged
humuhumu33 merged 25 commits into
mainfrom
adr/016-holo-canonical-bytes
Nov 5, 2026
Merged

humuhumu33 merged 25 commits into
mainfrom
adr/016-holo-canonical-bytes

Conversation

@humuhumu33

Copy link
Copy Markdown
Contributor

Summary

Every generated Prism app now carries the Hologram design system, and this branch also lands the Rust half of build provenance.

  • Hologram workbench (817fd35, d55302b). The generated workbench and the prism-code dev studio use the Hologram brand tokens on shadcn/ui new-york-v4 anatomy. Three brand-kit values that fail WCAG are corrected (focus ring, light destructive text, brand orange as text); the upstream fix is fix(brand): meet WCAG contrast in the Hologram paper theme and gate it Hologram-Technologies/hologram-brand-kit#3.
  • Design catalogue with a contrast proof (f742c5c). The private DK-38 catalogue grows to 25 tokens per theme with a Hologram font family. Admission now requires WCAG text 4.5:1 and focus 3:1 through a conservative integer rule. HologramDesign.lex.tex, generated from the kit's tokens, proves its catalogue admitted by kernel evaluation with no axioms; a planted failing palette fails lexlean verify.
  • Browser closure v2 (898dcdf, SPEC §1.2.1). Pages ship Geist, Geist Mono and Archivo with their OFL licences, two icons and a per-app web app manifest, so they render in the brand fonts and install on phones with no remote request. browser-provenance/2 names every file's digest; export-browser and verify-browser-publication return new /2 receipts that admit exactly closure v1 or v2.
  • Build provenance, part 2 of Provenance on by default at prism build #268 (7a5301d). prismpm build writes the unsigned SLSA provenance statement, HO-32 to HO-35. The generator-recipe pin change was signed off by Ilya Paveliev (deb2f2e).
  • Keyboard journey fix (8ba214f). The workbench keyboard-only probe now uses native multiline controls; it had failed on every run since feat(workbench): add keyboard, focus and contrast accessibility checks #393.

Breaking changes

  • An export is now sixteen files and the receipts are /2. Anything that pins the six-file closure must move, including the calculator-example Pages contract.
  • A plain prismpm build of an application needs a /2 or /3 lock, or --no-provenance (Provenance on by default at prism build #268).

Verification

Run in the SDK image before the merge with main:

  • prismpm library selection (brand, workbench, contracts, export, publication, release verification, projector, provenance) passes except two tests that need network access to build the Hologram oracle; they fail identically on the parent revision.
  • repo-model and xtask match their parent results; validate-model is clean.
  • prism-code 26/26, @prism-code/spec 132/132, product SDK check 19/19, workbench journey 27/27, hologram-design 3/3.
  • The real emitter function confirms the registered digest.

On the merge commit (1a247ad): validate-model clean, emitter digest unchanged, ct-02 checks, repo-model passes, repo-conformance compiles, and the prismpm selection passes apart from the same two network tests. The xtask, prism-code and spec suites were not rerun locally on the merge because the local Docker host went down; this PR's CI covers them.

Still to come on this branch

  • The merge carries main's goldens as placeholders. A golden-refresh run and a native review on the merge commit will follow, then their outputs are committed here.
  • After hologram-brand-kit#3 merges, regenerate HologramDesign.lex.tex from the merged kit commit (it cites caa064af).

🤖 Generated with Claude Code

humuhumu33 and others added 25 commits October 29, 2026 13:48
Make stdlib/src/Foundation/Holo the single normative .holo definition,
with hologram-archive generated from it. Fix the canonical byte rules
(section order, set vs sequence lists, empty sections, in-model BLAKE3
footer, determinism) and the version policy (v4 only; v2/v3 via a
non-normative legacy shim; append-only discriminants).

PrismPM's existing Holo/1 profiles already conform, so no PrismPM
archive bytes change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Brings in the attestation code #268 part 2 builds on.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… anatomy

Restyle the generic Text V3 workbench stylesheet with the Hologram warm
tokens (hologram-brand-kit brand/css/hologram-warm.css) and shadcn/ui
new-york-v4 metrics for button, outline button, input, native select,
card, alert, empty state, table and collapsible. The runtime, its markup
and element ids are unchanged; every app built by PrismPM inherits the
look from this one emitter input.

Three kit values fail WCAG and are corrected in the adapter: the light
focus ring uses #6b6660 (kit ring #a8a399 is 2.26:1 on paper), light
destructive text uses #c10007 (kit #e7000b is 4.29:1 on paper), and the
brand orange is decorative only (3.71:1 as text on paper). Colour
transitions are removed so a scheme switch never leaves a control
mid-change. The forced-colors block keeps every system colour the
journey asserts.

The contrast test's negative control now mutates the new muted-text
token. The emitter digest is re-registered for the new stylesheet.
Goldens and the ct-02 fixture still need the golden-refresh run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…line controls

The keyboard-only probe pressed Enter in the guided message field and
expected a submission, but the fixture models that field as multiline,
so it renders as a textarea where a native Enter inserts a newline. It
also typed into fields that already held a value, so the submitted bytes
were the old value plus the typed text. The probe has failed every run
since it was added in #393, on main and in every local SDK image.

The runtime is correct: SPEC section 3 requires keyboard-native
controls. The probe now replaces each field's text before typing,
reaches the compute control with Tab and submits with Enter, and keeps
Control+Enter for the raw editor. It asserts that Tab from the multiline
field lands on the compute control. The planted missing-submit-handler
control still fails, and the suite passes 27 of 27 in the SDK image.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ogram workbench stylesheet

The workbench stylesheet is an emitter input, so 817fd35 changes the
emitter digest and every artifact that records it.

The five shared stdlib goldens come from golden-refresh run 42020871126
at 8ba214f (golden.patch sha256 ed405f96). The prism-code model fixture
now binds the application model digest this compiler projects
(069ab0e9), taken from PP2101 and confirmed by a passing check in the
SDK image. The native records follow from a review run on this commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…kbench stylesheet

Taken from native-source-review run 42025182110 at 898acb0, artifacts
native-golden-review-amd64 and native-golden-review-arm64 (records/
only). Both jobs passed, both reviews name source 898acb0, and every
record matches the sha256 its review.json declares.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… anatomy

The studio now uses the same warm Hologram tokens as the generated
workbench: paper and warm-dark grounds, one brand mark in the header,
shadcn tabs as a segmented list, cards with the new-york radius and
shadow, and Geist/Archivo/Geist Mono stacks with system fallbacks.

Verdict colours are text-safe on both surfaces in both schemes: pass
#1f7a4d/#5fd18b, fail #c10007/#ff6467, warn #bb370b/#ec6032, each 4.5:1
or more. Forced-colors keeps the mark, the selected tab and the focus
ring visible. The dev suite passes; markup and scripts are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… 2 of #268)

`prismpm build` now writes one in-toto Statement v1 with a SLSA provenance
v1 predicate into the attestation section of the archive it builds, the
Rust side of the statement prism-code already writes (#359). Subjects are
the four content blobs, resolvedDependencies come from prismpm.lock, and
the builder is the SDK image the lock pins. Min mode, the default, holds
nothing that varies between machines; max mode is opt-in. Nothing signs,
so a built holo stays P0 until attest (#272).

Registers HO-32 to HO-35 with their diagnostics, conformance cases and
feature scenarios, and re-registers the emitter digest for holo/mod.rs.

Verified in the SDK image: 15 provenance tests pass, clippy -D warnings
is clean, and validate-model reports current documents and clean audits.
oci::tests::coherently_rehashed_provenance_must_bind_the_genuine_release
fails here only because leanchecker is OOM-killed (exit 137) in a local
container; it fails identically on the parent commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e its contrast

The private DK-38 design catalogue grows from 16 to 25 tokens per theme:
nine appended colors (card, muted, muted text, hover, input, brand, brand
text, success, warning) and a Hologram font family (Geist, Archivo
display, Geist Mono). Appending keeps every original wire position.

Contrast becomes part of admission. designTokensValid stays a shape
predicate; designCatalogueAdmitted also requires text pairs at 4.5:1 and
focus at 3:1 (WCAG 1.4.3, 1.4.11). Luminance uses a 256-entry linearized
sRGB table, and the integer rule den*(high+O-E) >= num*(low+O+E) absorbs
the table's rounding, so it never overstates contrast. designCatalogueBytes
and the browser decoder (sdk/browser/design-contrast.mjs) refuse a failing
palette.

HologramDesign.lex.tex is generated by scripts/hologram-design.mjs from the
brand kit's tokens (Hologram-Technologies/hologram-brand-kit#3 at caa064af)
and proves designCatalogueAdmitted with decide. In the SDK image the module
set passes lexlean check, build and verify; the theorem is ok with no
axioms, and a planted failing palette fails verification. The new
hologram-design test checks the Lean table against the WCAG formula, the
decoder against the theorem's catalogue, and 4,000 random pairs against
the exact ratio.

The DK-38 fixture and corpus are widened to match. The fixture is still in
the language 1.1 data form that check-source.mjs and compile.mjs reject on
the parent revision too, so the complete DK-38 owner did not rerun; see
VERIFICATION.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…web app manifest

Every generated browser page, the Text/1 page and the Text/3 workbench,
now carries the Hologram brand beside the six-file page: Geist, Geist Mono
and Archivo web fonts with their OFL licences, icon.svg, icon-512.png and
a per-application manifest.webmanifest. Pages render in the brand fonts
and install on phones with no remote request, and the HOLOVIEW bundle
carries the same files. SPEC section 1.2.1 states the closure.

The files are the new hologram-brand vendored dependency
(vendor/hologram-brand, kit develop f14a9d8, pinned by tree manifest).
crates/prismpm/src/brand.rs owns the names, @font-face rules, head links,
manifest bytes and the exact closure v1 and v2 sets; brand.rs and the nine
brand files join the emitter inputs, and the digest is re-registered.

provenance.json becomes prismpm/browser-provenance/2, which adds the
SHA-256 of every other closure file. export-browser and
verify-browser-publication return the new browser-export/2 and
browser-publication-integrity/2 contracts, which admit exactly closure v1
or v2; the /1 contracts stay registered. Release verification accepts
either closure and checks every v2 file digest. prism-code verifies both
provenance versions and exports either closure.

Breaking: an export is now sixteen files and the receipts are /2, so a
consumer that pins the six-file closure, such as the calculator-example
Pages contract, must move.

Verified in the SDK image: brand, workbench, contracts, export,
publication and release verification tests pass apart from two that need
network access to build the Hologram oracle; repo-model and xtask match
their parent-revision results; prism-code (26), @prism-code/spec (132),
the product SDK check (19), the workbench journey (27) and the generator
test (3) pass; validate-model is clean; the real emitter function confirms
the registered digest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… v2 and the design catalogue

The emitter inputs grew with closure v2 (brand.rs and the vendored brand
files) and the stdlib browser view sources changed with the design
catalogue, so the shared stdlib goldens and their source snapshots move.

The seven updated files and the new HologramDesign snapshot come from
golden-refresh run 42052303234 (attempt 2) at 898dcdf (golden.patch
sha256 78765e77); the source snapshots equal the committed stdlib sources.
The prism-code model fixture binds the application model digest this
compiler projects (c0404fc2), taken from PP2101 and confirmed by a passing
check in the SDK image. Native records follow from a review run on this
commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rator recipe owner

scripts/native-golden.mjs pins crates/prismpm/src/controller/mod.rs as the
application generator recipe owner, so a change to it needs an explicit
source-review sign-off before native records are produced. 7a5301d
(build provenance, #268) threads BuildProvenance through the build and
stamps an application holo's provenance statement into its artifacts
before the build identity is hashed (+26/-5).

Reviewed and signed off by Ilya Paveliev on 2026-11-05. The pin moves from
38211cf8 to 5800a14b, the SHA-256 of the committed file.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he design catalogue

Taken from native-source-review run 42060369314 at deb2f2e, artifacts
native-golden-review-amd64 and native-golden-review-arm64 (records/ only).
Both jobs passed, both reviews name source deb2f2e, and every record
matches the sha256 its review.json declares.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Conflicts resolved:
- CHANGELOG.md: both sides' entries kept.
- crates/prismpm/src/error.rs: main's PP2019 to PP2022 and this branch's
  PP3018, 122 registered codes.
- crates/conformance/src/cases/mod.rs: both the HO-32 to HO-35 provenance
  arm and main's AL-07 arm.
- scripts/native-golden.mjs: the application generator recipe owner pin is
  the SHA-256 of the merged controller/mod.rs (13f6f18d). Both changes to
  it were signed off: main's on main, the provenance change by Ilya
  Paveliev on 2026-11-05 (deb2f2e).
- sdk/npm/prism-code/CHANGELOG.md and README.md: main's text plus this
  branch's closure v2 and studio wording only. This drops a prism-code
  setup/mcp changelog line and README section that 898dcdf had taken in by
  mistake from another session's uncommitted edits.
- Goldens and native records: main's versions, to be refreshed by
  golden-refresh and the native review on this merge.
- sdk/stdlib-sources.tar: regenerated by validate-model --write.

On the merged tree in the SDK image: validate-model is clean (232 ids, 122
codes), the emitter digest is unchanged, ct-02 checks, repo-model passes,
repo-conformance compiles, and the prismpm library selection passes except
two tests that need network access to build the Hologram oracle.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…int on PR 550

- sdk/npm/conformance/format-gate.json: exempt browser-provenance-v2,
  with the reason. provenance.json is a file of the browser export,
  written beside the holo and never into it, so no holo byte changes; the
  sdk-lock-v3 exemption is the precedent.
- prism-code is back under its 1,236,992-byte cap (1,236,503): the studio
  stylesheet loses comments and indentation (declarations unchanged) and
  the closure module's added comments are shortened.
- docs/site/guides/ship.md: the vocabulary lint refuses "Hologram" in the
  guides, so the export paragraph names the brand fonts instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
.gitattributes already says a CRLF checkout on Windows must not change
what an npm package packs, but it covered only .js, .mjs, .json, .d.ts
and .rego. prism-code also packs .md, .css, .html, .toml, .tex, .sh, .wit
and .lock files, so on the Windows runner each of their lines gained a
byte and the package measured 1,579 bytes more than on Linux, over its
cap. Those types under sdk/npm are now eol=lf too; all 53 such files are
already LF in the index, so nothing is renormalized.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
From golden-refresh run 42072046042 at 1a247ad (golden.patch sha256
f6a1a768). The commits since touch no golden input.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…nd the studio

After main added the doctor fix, prism-code packed 1,237,538 bytes against
the 1208 KiB (1,236,992-byte) cap. This branch adds about 2.7 KiB to the
package: closure v2 provenance verification in src/closure.mjs and the
Hologram studio stylesheet, already stripped of comments and indentation.
Following the cap's own record of per-feature allowances, it rises by
4 KiB to 1212 KiB (1,241,088 bytes) in check-package.mjs, its test and the
npm-prism-code workflow, each noting why.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- rustfmt: brand.rs, workbench.rs, the export, publication and release
  verification code and two xtask files are formatted as cargo fmt writes
  them.
- check-modules rule 2: crates/prismpm/src/brand.rs is owned by `images`.
- check-modules rule 5: holo/provenance.rs no longer reaches modules that
  already depend on holo. It keeps local copies of the RFC 3339 formatter
  and three wire constants, each held equal to its owner by a unit test,
  and Stamp::begin takes a closure that reads the lock, which the
  controller supplies with sdk::committed_lock. Same read, same validation,
  only when provenance is wanted.
- The controller change moves the application generator recipe pin to
  2709684c; signed off by Ilya Paveliev on 2026-11-05.
- The emitter digest is re-registered (e2e8cb38, confirmed by
  compute_emitter_semantics_id), and the ct-02 and tm-01 copies of the
  prism-code model bind the application model digest this compiler
  projects (e098acb8). check-fixtures passes all 35 fixtures.

Shared goldens and native records follow from a refresh on this commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The prism-code package cap combines both sides: main's 1320 KiB for
prism-code mcp plus this branch's 4 KiB for closure v2 provenance
verification and the Hologram studio stylesheet, 1324 KiB in all.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
From golden-refresh run 42086897374 at f1e4ea3 (golden.patch sha256
8923e5d2c067102bb36bc2184028decdea6d99a9b197186d1617abbfd08228d8).
The model emission and its attestation move with main's model changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
#549)

Taken from native-source-review run 42093185675 at 526d392, artifacts
native-golden-review-amd64 and native-golden-review-arm64 (records/ only).
Both jobs passed, both reviews name source 526d392, and every record
matches the sha256 its review.json declares.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
product-sdk-check now requires the sixteen-file closure v2 export, so
the sdk-release-evidence product fixture names the same files.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The browser oracle admits the closure v2 fonts, icons and web app
manifest, so its pin in hologram_interop.rs moves to 35b28278 and the
reviewed owner digest in hologram-source-pins.mjs moves to 8308ff62.
Signed off by Ilya Paveliev.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@humuhumu33
humuhumu33 merged commit 18a60a3 into main Nov 5, 2026
37 checks passed
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