5.7 KiB
Renderer inventory and draft contract
Source and ownership
Inspected legacy typst_reporter commit
1d381904fff3d378a7c0e04588e75310a9b7ed60 on 2026-09-15.
Software carries an MIT notice, copyright 2026 Beffroi. Synthetic fixtures retain
that notice; no Beffroi graphical assets are imported into Reportist.
| Source | Disposition |
|---|---|
report.typ |
Generic entry point: retain author/date checks; replace fixed theme/logo lookup and add versioned YAML/JSON validation. |
modules/model.typ: dict-get, as-content, theme-color, severity-color |
Generic helpers; report strings must remain inert content. |
report-type-label, badge, metadata-line, section-title, subsection-title, callout, code-block |
Generic presentation; remove organisation-specific defaults. |
render-block, render-findings, render-timeline, render-actions |
Generic structured content; preserve evidence/assessment separation. |
confidence-bar, diagnostic-list, render-diagnostics |
Extract bars/lists/cards; supply domain labels and values as data. Never compute diagnostic confidence here. |
report-header, report-footer, report-model |
Generic layout; remove default Beffroi identity and mandatory logo. |
modules/diagnostics-model.typ |
Split widgets from fixed Windows sections and report assembly. Generic widgets go here, report shaping goes to beffroi-reports. |
modules/diagnostics-normalize.typ |
Excluded: generic interpretation goes to win-diagnostics; display shaping goes to beffroi-reports. |
diagnostics.typ, render-diagnostics.sh |
Excluded as renderer interfaces: replace raw-capture-to-PDF with diagnostic artifact → adapter → report input. |
render.sh |
Reuse single-report CLI behavior; leave incident discovery and category cleaning to orchestration. |
config/themes.yaml |
Generic palette/font defaults and external overrides; organisation choices belong in reports. |
| Diagnostic rules/watchlist | Technical matchers go to diagnostics; report-ready recommendations go to reports. |
| Real reports, captures, assets | beffroi-reports. |
| Packaging and publication | Integration orchestration. |
tools/check-diagnostics.typ |
Mixed synthetic/private analysis tests; do not copy wholesale. |
Diagnostic-model helpers are color, get, ink, muted, accent,
line-color, soft, severity-color, badge, heading, part-title, panel,
metric, header, footer, short-text, finding-target, finding-card,
evidence, and diagnostics-model. Extracting widgets does not justify moving
the final domain-specific model unchanged.
Existing CLI and dependencies
The Bash wrapper accepts YAML/YML, one path or --all, and optional --clean.
It resolves caller/repository paths, preserves subfolders under build/, reserves
build/diagnostics/, and fails on missing input/tool or Typst errors. The entry
point requires nonblank metadata.Author and metadata.Date, rejects unknown
themes, and always supplies /assets/beffroi.png. There is no versioned schema.
Defaults use A4, DejaVu Sans and DejaVu Sans Mono. No external Typst packages are
imported. The new CLI must accept explicit input/output paths independently of
legacy incident directory conventions.
Field mapping for version 1
| Existing fields | Proposed treatment |
|---|---|
| No schema version | Require an explicit new schema_version; migration adds it deliberately. |
title, subtitle, id, report_type |
Generic identity/purpose; require nonempty title, retain technical/briefing options. |
metadata.Date, metadata.Author, extra labels |
Preserve capitalization and extra display labels; dates remain strings. |
organization, theme, fixed logo |
Explicit branding/configuration with optional logo and neutral defaults; document external asset resolution. |
status, severity |
Supplied display values, never inferred conclusions. |
summary, closing |
Optional supplied prose. |
timeline: time, event, notes |
Optional generic timeline. |
findings: title, severity, status, evidence, assessment |
Preserve evidence and interpretation separately; define stable references. |
sections, nested content |
Preserve text, bullets, steps, callout, code, subsection; reject unknown block types explicitly. |
actions_title, actions: title, status, text, commands |
Generic action display; commands are inert text. |
diagnostics.hypotheses and lists |
Map to generic sections/cards or a documented generic assessment block. |
Version-1 schema validation, YAML/JSON parity, optional-field and branding shape checks are now implemented; see report contract. Rendering, asset loading, and actual branding/layout behavior remain unimplemented.
Baseline
The first two YAML examples from legacy docs/examples.md are copied unchanged
to tests/fixtures/legacy/minimal.yaml and technical.yaml. All names, services,
organisation, and timestamps are example data. No historical report was copied.
The macro migration runner renders these from pinned temporary legacy sources
and checks missing author/date and unknown theme rejection. It is a migration
comparison aid, not a Reportist runtime dependency. On 2026-09-15 Typst
0.15.1 (586e1bd4) produced a one-page minimal report and two-page technical
report. First-page technical-report review found readable metadata, timeline,
findings and sections without visible clipping. The Beffroi logo remains visible:
this is a known coupling to remove. Other pages, long-content pagination,
alternate branding, all optional constructs, and font-version reproducibility
still require tests.
Next: define the rendering command precisely and implement the generic single-report slice against the validated contract.