Rendering boundary

Topo renders committed diagram stories through the pinned, integrity-checked Archify 3.0.0 runtime in @topo/diagram-core. Authored .topo.json documents remain renderer-neutral; source anchors resolve before rendering, and failures do not publish partial output.

The generated application shell is owned by @topo/cli. It inventories every story and embeds each unchanged Archify HTML artifact at /stories/<story-id>/viewer.html. Archify continues to own diagram geometry, theme, presentation, zoom, source/evidence details, and canonical SVG/PNG exports. The shell owns navigation, grouping, filtering, Git-backed sorting, responsive containment, and deep-link coordination around that iframe.

Pinned distribution and upgrades

The exact @jdylanmc/topo-archify@0.1.0 dependency supplies the complete, unmodified 104-file runtime from the official v3.0.0 release ZIP, at commit 9286c3b9c2cef359e98586b420d769d87bcb163f. archify-pin.json records the adapter's expected source and archive SHA-256; the renderer package verifies every path and file using runtime-integrity.json. Metadata stays outside the upstream tree. Installed rendering requires no runtime download or npm package named archify. Package acquisition is explicit at install/bootstrap time, not during build/rendering.

The prior 2.17.0-dev.1 and 3.0.0 vendor manifests are preserved unchanged under packages/diagram-core/integrity/. A future upgrade needs its own reviewed pin and inventory, not an integrity-baseline rewrite to bless local edits. Keep upstream licenses, font notices, brand attribution and trademark disclaimers verbatim. Proposed renderer changes go upstream first; any approved local patch must be separately listed with its upstream status. This pin has no vendor patches.

Topocode no longer maintains a full vendor runtime. The packaging-first fork owns the pristine distribution; product-specific adaptation remains here. The maintenance skill requires loading the integration history and executing package, consumer and full regression checks. See bootstrap/release. Initial package 0.1.0 deliberately retains upstream 3.0.0; 3.0.1's changed network update-check behavior is a separate compatibility decision.

The v3 adapter adds portable meta.output only to its generated renderer input; authored Topocode stories retain their identity and schema. Rendering runs in an owned temporary working directory, so resolving that generated output field cannot depend on an unrelated story.html in the caller's directory. Lifecycle remains on the compatible native v1 geometry: state widths and column clearance account for final typography, preserving Topocode's 12px effective text requirement. The v3 viewer's own guided/story-view and ordinary share-card removal does not remove Topocode's authored-story catalogue or canonical SVG/PNG exports. Native v3 PNG exports add the viewer's title and canvas frame around the uniformly scaled canonical diagram. SVG remains the bare canonical geometry; the test oracle accounts for frame dimensions rather than distorting or cropping the diagram to preserve the previous whole-image aspect ratio.

Native deliver provenance receipts describe the raw native artifact. Topocode then applies adapter typography/narrative changes and, for repository views, shared-asset packaging. Those bytes must not be presented as the original native artifact's hash or as a successful upstream finalize result. Topocode validates its delivered behavior through the existing CLI/browser regressions. The public release ZIP intentionally omits the upstream test suite; integrating that suite remains separate work in #41.

Generated repository views

The default Repository canvas uses bounded generated Architecture views at /repository/<view-id>/viewer.html through the same package boundary. Its wrapper owns scanner/source evidence and navigation, including explicit dirty, partial and stale states. The batch path still invokes the pinned native renderer and output checker for every page; it does not modify the vendor copy. See repository exploration.

Retired repository explorer

The former PixiJS/WebGL repository explorer is no longer a shipped product surface. Scan and bundle generation prune its route and assets, /explorer/ returns not found, and the @topo/site build exports only the validated site-data contract and legal notices. Scanner, graph, layout, curated-view, module, logical-architecture, report, and enrichment data remain in the generation pipeline. The new source-grounded Archify exploration uses the scanner and compiler evidence without restoring the old renderer or its application types.

Historical WebGL benchmark inputs and results remain repository evidence for the retired implementation. They do not describe the current shipped renderer or create a current performance claim.

Read or edit this page on GitHub