Repository object · documentation
EM-0043 - Register design system adoption
Apply the owner-approved Register visual grammar to every generated Epistemedia human surface while preserving the exact accepted knowledge record and every machine-readable representation.
- Source path
docs/execution-plans/EM-0043.md- Media type
text/markdown- Object ID
em:documentation:sha256:5d78c264199a4f3894b54494c80ab3022420fc2389acda54c57801f9439315a6- Content digest
4a7b93bffbd818da9dc70b9f9286e666af637888ea4dbeda7a5901ba50b0e1ce
Source content
EM-0043 - Register design system adoption
Objective
Apply the owner-approved Register visual grammar to every generated Epistemedia human surface while
preserving the exact accepted knowledge record and every machine-readable representation.
Accepted inputs and boundaries
- Epistemedia contract base:
4a5e154abda1bd7279f828f2aa67997a3ae44fbb. - Register design source:
yoheinakajima/registerat - Register's
DESIGN.md, shared stylesheet grammar, Case showcase, and dossier example are design - Accepted Cases 001-004, source spans, relations, counts, evaluations, mission, open dockets,
- The public
design-slop-copnpm package was unavailable during the template audit. Its 0/14 score
5ac05e2758885d92ed2a9a8cfd4c6eb70ccbdbe4.
references. Their sample content and navigation are not repository evidence and are not imported.
receipts, policies, schemas, and public object identities remain unchanged.
is a bounded tooling gap unless the package becomes available. The mapping below records each
explicit DESIGN.md requirement as adopted, adapted, exempt, or not applicable; it does not claim
scorer equivalence.
Design mapping
1. Replace the large serif display layer with compact sans headings and preserve monospace only for
identifiers, labels, counts, state, provenance, and code.
2. Replace decorative grid, gradient, shadow, radius, and card-wall treatments with Register's
paper tokens, hairlines, aligned rows, restrained fills, and one accent plus explicit state colors.
3. Keep the existing semantic HTML and deterministic compilation model, adding only the shared
chrome or structural hooks needed to make the system legible across all routes.
4. Recast topic-object collections as aligned records: kind and identity in the register column,
human title and summary in the reading column, interlinks and technical identity retained but
visually subordinate.
5. Keep exact count lists, source x-rays, ledgers, receipts, policy switches, native disclosures,
and HTML/Markdown/JSON twins inspectable without JavaScript.
6. Retain an attribution note for substantial Register-derived design material under its MIT license.
Register requirement mapping
When design-slop-cop is unavailable, record evidence for every row rather than infer its 0/14 score:
1. Stylesheet, adopted. Emit one shared external stylesheet for every HTML page. Do not add
Tailwind, a component library, inline style blocks, or JavaScript required for completeness.
2. Component grammar, adopted for new or changed markup. Component classes name structure.
Variants use data-surface, data-series, data-state, data-style, data-size, data-kind,
data-theme, data-display, or data-skin, rather than decorative one-off class names.
3. Surface vocabulary, adopted. Permitted data-surface values are tint, wash, deep,
s1-s4, s1w-s4w, ok, open, stop, info, and duo.
4. Series and state vocabulary, adopted where represented. data-series is 1-4 and only
describes data. data-state is done, active, waiting, blocked, parked, optional,
live, reserved, or superseded. Claim states map proposed, sourced, and derived to waiting;
implemented and checked to active; verified and independently reproduced to done; refuted to
blocked; and superseded and retired to parked.
5. Style, size, kind, theme, and display vocabulary, adopted where represented. data-size uses
sm, lg, or wide; data-style stays component-specific; data-kind names the listed object;
and data-theme plus data-display belong on <html>.
6. Skin files, adapted. Epistemedia ships one owner-selected look, not Register's skin gallery.
Visual variation remains token-only in the shared stylesheet. No data-skin file is emitted, so
skin load order, the skin schema, and the seven-line skin image brief are not applicable. A future
skin would require a separately scoped change that restores those exact gates.
7. Images, exempt for preserved assets and not applicable to new work. EM-0043 adds no generated
or photographic image and does not alter accepted deterministic SVG share cards. Therefore fixed
image ratios, palette treatments, captions, provenance lines, prompt templates, pasted skin
briefs, and the no-generated-text rule are not exercised. If an image enters scope, the task must
stop rather than mark these requirements passed.
8. Register identity, adopted. Each inspectable object keeps its identifier in a consistent
register position; at 390 px the identifier collapses inline without being hidden.
9. Rule, do not box, adopted. Hierarchy comes from hairlines and alignment. Routine content has
no radius, blurred shadow, gradient, backdrop blur, colored edge stripe, or adjacent deep or
series surfaces. At most one deep or series surface appears per viewport. A deep surface always
uses the --deep token and never raw #000; any future skin relaxation may use only a hard-offset
shadow, never a blurred shadow.
10. Typography, adopted for generated chrome. Identifiers, numbers, labels, and metadata are
lowercase monospace; prose and headings are sans; names and sentences retain natural case; CSS
does not use text-transform: uppercase.
11. Color semantics, adopted. Links and current state use one accent; ok, open, and stop use their
state colors; series colors are limited to charts or labs; every color meaning also has a glyph
or word.
12. Plain-text twins, adapted to Epistemedia's compiler. Every changed component has a visible
list, table, key-value block, Markdown twin, or JSON twin. Epistemedia has no components.html;
focused tests and the design mapping document replace Register's component-demo inventory. No
new component may pass without one of those inspectable twins.
13. Accent source and ration, adapted. Epistemedia has no accents.html gallery and imports no
decorative accent asset from Register. The shared stylesheet token block is the sole source of
accent color or treatment. A page uses at most one signature accent, one texture, and one stamp;
introducing an accent outside those tokens fails this check.
14. Exact numbers, adopted. Exact results use 20 px monospace; ordinary counts remain metadata;
the largest stat-banner or scorer value is 22 px; no row promotes a value above that ceiling.
Live readouts, when present, use 18 px monospace.
15. Figure and source rules, adopted. A filled figure block stands alone, never in a row. Every
number strip or chart names its source run, claim, commit, dossier, or review receipt.
16. Copy, adapted to preserve accepted bytes. Newly authored navigation and explanatory chrome
use plain verbs, sentence case, straight quotes, no filler, no em dash, and no emoji. Accepted
source text, quotations, dossier findings, mission text, and research records remain byte-for-byte
unchanged even when they contain smart punctuation or an em dash.
17. Headline and identity integrity, adopted. Headlines state a specific claim or question. No
number, identifier, citation, or state is invented, and sample data is explicitly marked.
18. Responsive behavior, adopted. At 390 px, no page-level horizontal overflow exists except an
explicit table wrapper, register columns collapse inline, focus remains visible, and native
controls remain complete without JavaScript.
Validation sequence
1. Add focused tests for shared tokens, forbidden visual treatments, compact heading bounds,
metadata hierarchy, register-style topic rows, semantic chrome, and no-script output.
2. Run focused interface, dossier, mission, open-docket, and research-kit tests.
3. Build the full disposable site twice and run deterministic, disclosure, source-state, link,
canonical, twin, sitemap, llms.txt, REST, MCP, and CLI checks through make check.
4. Serve the candidate locally and inspect representative routes at desktop and 390 px. Record one
H1, page dimensions, overflow, focus visibility, native disclosure behavior, and console errors.
5. Audit the exact changed path scope and confirm accepted data bytes are unchanged.
6. Obtain a fresh exact-head independent review before protected integration. Validate resulting
main and perform a separately gated Pages deployment and custom-domain read-back before saying
the design is live.
Status
- 2026-09-01: owner requested a site-wide adoption of the Register template after reviewing the
- 2026-09-01: implementation began from the accepted contract merge
- 2026-09-01: the focused interface suite passed (
32 passed). The complete governed check passed: - 2026-09-01: exact-head independent review, protected integration, resulting-main validation, and
- 2026-09-01: the first exact-head review of
bc43b4d7a2b626cadd0ef0948075cce456dc2702 - 2026-09-01: the corrected candidate again passed the full governed check. A fresh 32-observation
- 2026-09-01: the second exact-head review of
current four-case Epistemedia design. Contract registration began from exact main
4a5e154abda1bd7279f828f2aa67997a3ae44fbb.
cf0c09fa01967c727d5f37f823f4bf745c44b083. The compiler now emits one external
register.css for every HTML projection and applies the Register paper, hairline, compact sans,
monospace-register, accent, state, and responsive grammar across the homepage, case library,
Cases 001-004, reviews, About, agent workflow, open dockets, topic projections, objects, Docs,
Status, and build receipts. Accepted knowledge records and machine-readable twins were not
edited.
accepted-input validation, full test suite, public-projection audit, deterministic comparison
build, and source-tree-state check. A headless Chrome audit covered 16 representative routes at
both 1440 px and 390 px: all returned HTTP 200, had exactly one H1, one shared stylesheet, no
script, no page-level horizontal overflow, and routine cards computed to no shadow, no radius,
and no background image. The unavailable design-slop-cop package remains the bounded tooling
gap documented above; no scorer result is claimed.
separately gated live deployment verification remain pending.
returned CHANGES REQUIRED. It found one legacy .scope-note gradient and colored left border still
effective on 15 generated pages, plus an underspecified CLI run receipt. The stylesheet now gives
.scope-note the same final restrained paper-and-hairline treatment as the surrounding Register
surfaces, and the interface suite asserts that this effective override follows the legacy rule.
browser audit across 16 routes at desktop and 390 px reported no route, H1, stylesheet, script,
overflow, routine-card, or scope-note defects. A structured superseding receipt will bind the
corrected tested commit and tree, commands, versions, catalog/frontier, output hashes, UTC times,
and bounded scorer limitation before the second exact-head review.
1280605a8a84331cf0187fe4d5dedb91f5610025 closed both first-review defects, then found a long
unbroken test identifier causing one public object route to measure 475 px wide at a 390 px
viewport. Source-document paragraphs, list items, definitions, and code now wrap long technical
tokens safely. The exact failing object class was added to the browser matrix; the corrected local
result is 390 px client width and 390 px scroll width, with no overflow. A new structured receipt
will supersede the now-outdated 32-observation receipt after exact-commit revalidation.
Build receipt
Reproduce this projection
- Catalog
em:catalog:sha256:9bfc972213cba2cde167386103dc2c011ee74639fb7f0794c54120fbbdef1a5d- Frontier
em:frontier:sha256:f33be3eae4c75232d56750ef9a1aa79d96274ece3417d65a75c1391bf61a81bf- Accepted commit
f92846570180dfa4511263f8ba98ecd18f7772c9- Epistemic policy
commons-balanced-v0.1- Disclosure policy
public-noninterference-v0.1- Compiler
epistemedia/0.2.0