Diagram Export Manifest

Status: public-asset planning draft. This is not website publication approval, release approval, artifact publication approval, native boot approval, or a security certification.

Date: 2026-07-03

Pipeline

Use the repeatable render helper to produce static SVG assets for website publication. The selected source of truth for public static assets is docs/public/diagrams/src/*.mmd. Keep the interactive Mermaid source in repo docs for review, but do not rely on CDN Mermaid rendering in the published website build.

Pinned command shape used by the helper:

npx --yes @mermaid-js/mermaid-cli@11.4.2 -i INPUT.mmd -o OUTPUT.svg --backgroundColor transparent

Local validation without writing SVGs:

scripts/render-polymeros-public-diagrams.sh --check
scripts/render-polymeros-public-diagrams.sh --install-browser
scripts/render-polymeros-public-diagrams.sh --verify-render

Publication export:

scripts/render-polymeros-public-diagrams.sh --artifact build-artifacts/evidence/2026/YYYY-MM-DD-public-diagram-svg-render-manifest.md

Publication build jobs should keep the Mermaid CLI version pinned, record the generated asset hashes in an artifact packet, and link every exported asset back to this manifest or a later publication packet.

Asset Manifest

Source	Diagram	Proposed asset	Public gate
`docs/public/diagrams/src/spectrum-architecture.mmd`	Spectrum Architecture	`docs/public/diagrams/spectrum-architecture.svg`	allowed after local visual review and static export
`docs/public/diagrams/src/vm-launch-path.mmd`	VM Launch Path	`docs/public/diagrams/vm-launch-path.svg`	allowed after wording confirms this is design, not pass evidence
`docs/public/diagrams/src/polymeros-product-stack.mmd`	Product Stack	`docs/public/diagrams/polymeros-product-stack.svg`	allowed after claim-map review
`docs/public/diagrams/src/service-vm-roles.mmd`	Service VM Roles	`docs/public/diagrams/service-vm-roles.svg`	allowed while catalog payload wording remains gated
`docs/public/diagrams/src/bond-lifecycle.mmd`	Bond Lifecycle	`docs/public/diagrams/bond-lifecycle.svg`	allowed after bond schema links are present
`docs/public/diagrams/src/temporary-handoff.mmd`	Temporary Handoff	`docs/public/diagrams/temporary-handoff.svg`	allowed as planning-only unless runtime enforcement evidence exists
`docs/public/diagrams/src/release-evidence-flow.mmd`	Release Evidence Flow	`docs/public/diagrams/release-evidence-flow.svg`	allowed only if publication-ready remains gated until evidence changes
`docs/public/architecture-preview.html`	Spectrum Architecture	`docs/public/diagrams/spectrum-architecture.svg`	allowed after local visual review and no operational host paths
`docs/public/architecture-preview.html`	VM Launch Path	`docs/public/diagrams/vm-launch-path.svg`	allowed after wording confirms this is design, not pass evidence
`docs/public/architecture-preview.html`	Trust Boundaries	`docs/public/diagrams/trust-boundaries.svg`	allowed after security-review claim map cross-check
`docs/public/architecture-preview.html`	Native Apple Path	`docs/public/diagrams/native-apple-path.svg`	allowed after copy clearly says postbuild evidence only, not runtime proof
`docs/public/architecture-preview.html`	PolymerOS Product Boundary	`docs/public/diagrams/polymeros-product-boundary.svg`	allowed after publication copy scrub
`docs/public/architecture-preview.html`	Covalent Security Framework	`docs/public/diagrams/covalent-security-framework.svg`	allowed as planning-only unless runtime enforcement evidence exists
`docs/public/architecture-preview.html`	Temporary Bond Model	`docs/public/diagrams/temporary-security-framework.svg`	allowed as planning-only unless runtime enforcement evidence exists
`docs/public/architecture-preview.html`	Bond Object Lifecycle	`docs/public/diagrams/bond-object-lifecycle.svg`	allowed after bond schema links are present
`docs/public/architecture-preview.html`	Monomer Appliance Modules	`docs/public/diagrams/monomer-appliance-modules.svg`	blocked from payload-readiness wording until rootfs artifact review passes
`docs/public/architecture-preview.html`	VM Catalog Publication Gate	`docs/public/diagrams/vm-catalog-publication-gate.svg`	allowed only if publication-ready remains `no` until evidence changes
`docs/publishable-polymeros-design.md`	Product Layer	`docs/public/diagrams/polymeros-product-layer.svg`	allowed after claim-map review
`docs/publishable-polymeros-design.md`	covalent bonds and temporary bonds	`docs/public/diagrams/polymeros-security-frameworks.svg`	allowed as planning-only
`docs/publishable-spectrum-design.md`	Spectrum VM Architecture	`docs/public/diagrams/spectrum-vm-architecture.svg`	allowed after Spectrum claims are evidence-linked

Required Checks Before Publication

Render each asset from a Mermaid source file or extracted fenced block.
Open each SVG locally and check that labels are readable at desktop and mobile

widths.

Confirm diagrams do not include private hostnames, local paths, raw job IDs,

or unapproved release claims.

Confirm each public page links claims to docs/polymeros-review-claim-map.md

or names a future gate.

Keep native Apple boot, USB write, EFI mutation, signing, VM catalog

publication, and release publication claims blocked until explicit approval and evidence packets exist.

Next Implementation Step

Use scripts/render-polymeros-public-diagrams.sh --verify-render for repeatability checks before writing public SVGs. Use the publication export command only after local visual review is scheduled and the generated hash artifact path is selected. The HTML preview can stay as an interactive review cockpit; generated SVGs are the future website asset candidate.