Crate rto_render 

Renderers over the Roteiro graph. All outputs — docs site, Obsidian vault, and the optional MCP server (feature mcp) — are build products of the same store, so humans and agents always see the same data.

Structs

AdrEntry

One ADR in the overview, with its lifecycle status.

ConfigSecretSummary

The _Home overview’s config-secret inventory figures.

CouplingEntry

One node in the _Home overview’s directed-coupling table.

CrossLink

One cross-repo edge the workspace vault can actually follow: a spoke’s node linking to a hub’s, through the external-ref placeholder ADR-0009 persists.

DensityEntry

One file in the _Home overview’s intent-debt density table.

IndexEntry

An entry in the ADR/docs index page.

NavEntry

One page in the site navigation bar: where it goes and what it is called.

PublishedPages

Where each source document is actually published: the file the site serves, keyed by the source markdown’s file name.

RenderedAdr

A rendered ADR: its title (for the index) and the full themed HTML page.

SourceBase

Where a link that leaves the site points instead: the repository’s own web view, at the commit the site was built from.

VaultNote

A rendered vault note: its filename (with .md) and markdown content.

VaultScope

Which vault a note is being rendered into: a single project’s, or one member of a workspace vault spanning several repositories.

VaultSummary

Aggregate figures for the vault’s _Home overview note.

WorkspaceSummary

Aggregate figures for a workspace vault’s _Home overview: the members, each with exactly the aggregates a single-project _Home carries, plus the cross-repo links between them.

Enums

Target

A render target for the graph.

Constants

HOME_NOTE

Filename of the generated overview note (sorts first in the file list).

Functions

markdown_to_html

Convert CommonMark md to an HTML fragment (GitHub tables + strikethrough, and Roteiro [[wiki-links]] resolved). Resolves ADR links relative to the ADR directory; use render_doc for root-level pages.

note_name

Map a node key to a filesystem- and wikilink-safe note stem that is unique per key even after case folding.

render_adr

Render one ADR markdown document to a themed HTML page. Leading YAML frontmatter is stripped; the title is the first # heading, or fallback if there is none. ADR [[…]] links resolve to sibling ADR pages.

render_adr_index

Render the docs index: any lifetime docs (Build Plan, …) then the ADRs.

render_doc

Render a root-level “lifetime doc” (e.g. the Build Plan) to a themed page. Its [[docs/adr/…]] links resolve into the adr/ subdirectory.

render_home

Render the vault’s overview note: what was scanned, the structure by kind, the provenance breakdown, the decisions (ADRs) and their status, the intent-debt summary, and how to navigate. The entry point for the vault.

render_nav

The site navigation bar: one link per page, the current one marked.

render_note

Render a node’s Explanation into an Obsidian note: YAML frontmatter (with tags for the graph view and an ADR’s status), a clickable Source link (when source_base — a web “blob” base like https://github.com/org/repo/blob/<sha> — is known and the node has a path), the content as the knowledge base, and its edges as provenance-labelled wikilinks.

render_note_scoped

render_note, for one member of a workspace vault: identical except that the note’s own name and every link it emits are resolved through scope (see VaultScope).

render_site_page

Render one site page — a document that declared itself published — to a themed root-level page carrying the site navigation bar.

render_workspace_home

Render a workspace vault’s overview: the members and their scale, the cross-repo links between them, and then each member’s own aggregates — structure, provenance, ADRs, intent debt, config-secret inventory and call coupling — under its own heading.

replace_site_nav

Replace the <nav class="sitenav">…</nav> block in a hand-written page with the bar the renderer computes, returning None when the page carries no such block.

scoped_note_name

The note name for a node key owned by scope’s project.