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.

IndexEntry

An entry in the ADR/docs index page.

RenderedAdr

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

VaultNote

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

VaultSummary

Aggregate figures for the vault’s _Home overview note.

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. Characters that are awkward in filenames or Obsidian links (: / # whitespace) collapse to -; alphanumerics, ., _ and - are kept. The result is bounded in length (a grouped Rust use can key a 300+ char import node) by truncating and appending a short hash of the full key, so notes stay under filesystem limits while remaining unique and deterministic.

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_note

Render a node’s Explanation into an Obsidian note: YAML frontmatter (with tags for the graph view and an ADR’s status), the captured content as the knowledge base, and its edges as provenance-labelled wikilinks.