#!/usr/bin/env python3 # Copyright 2026 Exabeam, Inc. # SPDX-License-Identifier: Apache-2.0 """ render_remit.py — render a naked Worker Remit (Markdown) into a styled, shareable HTML page that matches the Praxen analysis report's look. A Worker Remit is authored and co-edited as plain Markdown (great for hand / agent editing, poor for display and review). This is a *mechanical* translator: Markdown in, one self-contained HTML file out. It reads no code and makes no judgments — it only re-skins the remit you already have. Brand chrome (the :root palette, the Praxen wordmark, the page footer) is extracted at render time from the report template (`report_template.html`) so the remit page and the analysis report share one source of styling. The remit body and masthead are rendered by this script. The output is deterministic: it carries the remit's own `Remit Version` / `Last Updated` fields, never a wall-clock generation time, so re-rendering an unchanged remit produces byte-identical HTML (and clean diffs / stable tests). Usage: python render_remit.py REMIT.md [--out REMIT.html] [--template report_template.html] [--praxen-version X.Y.Z] Defaults: --out is REMIT.md with a .html suffix; --template is the sibling report_template.html; --praxen-version is read from .claude-plugin/plugin.json (walked up from this script, then the cwd) when not given. """ import argparse import html import json import re import sys from pathlib import Path class RemitRenderError(Exception): """Raised when the remit or the template cannot be rendered cleanly.""" # ── brand-chrome extraction (shared with the report template) ───────────────── def _extract_between(text, open_pat, close, *, what): """Return the substring from the first `open_pat` match to the next `close`.""" m = re.search(open_pat, text) if not m: raise RemitRenderError(f"template is missing {what} (no {open_pat!r})") idx = text.find(close, m.end()) if idx == -1: raise RemitRenderError(f"template is missing the {close!r} that closes {what}") return text[m.start():idx + len(close)] def extract_chrome(template_html): """Pull (brand ", what="the brand {masthead}

{body}

{footer} """ def main(argv=None): ap = argparse.ArgumentParser(description="Render a Worker Remit (Markdown) to styled HTML.") ap.add_argument("remit", type=Path, help="path to the WORKER_REMIT.md") ap.add_argument("--out", type=Path, default=None, help="output HTML path (default: REMIT.html)") ap.add_argument("--template", type=Path, default=None, help="report_template.html to borrow brand chrome from (default: sibling)") ap.add_argument("--praxen-version", default=None, help="footer version string (default: read from .claude-plugin/plugin.json)") args = ap.parse_args(argv) if not args.remit.is_file(): ap.error(f"remit not found: {args.remit}") template = args.template or (Path(__file__).resolve().parent / "report_template.html") if not template.is_file(): ap.error(f"template not found: {template}") out = args.out or args.remit.with_suffix(".html") version = _praxen_version(args.praxen_version, [Path(__file__).resolve().parent, Path.cwd(), args.remit.resolve().parent]) try: page = render_remit(args.remit.read_text(encoding="utf-8"), template.read_text(encoding="utf-8"), version) except RemitRenderError as e: print(f"render_remit.py: {e}", file=sys.stderr) return 1 out.write_text(page, encoding="utf-8") print(f"render_remit.py: wrote {out}") return 0 if __name__ == "__main__": sys.exit(main())