example.mindmap.json

{
  "schema_version": 1,
  "source_name": "markmap-forge",
  "generation_date": "2026-08-29",
  "markdown": "# Markmap Forge\n## Problem\n### Prior approach\n- One giant one-shot prompt asked an LLM to hand-reproduce 500 lines of HTML, CSS and JS verbatim on every run\n- **Risk**: verbatim template fidelity depended on the LLM, not on code\n- **Risk**: an unescaped backtick or a dollar-brace sequence in the source content could silently break the embedded script\n### What changed\n- The HTML, CSS and JS template is now a static asset, injected by deterministic code\n- The agent's only job is producing a small typed JSON object, not thousands of characters of markup\n## Architecture\n### Typed input\n- **schema_version**: fixed at 1\n- **source_name**: human-readable title of the original document\n- **generation_date**: authored explicitly, never resolved implicitly, so a delivered artifact is reproducible from its JSON source\n- **markdown**: the sanitized outline, using heading levels for pillars and entities and bullets for detail\n### Deterministic pipeline\n- **validate**: schema shape plus markdown structural rules\n- **render**: injects the validated content into the fixed template\n- **deliver**: validates, renders, and reports a SHA-256 receipt for both the JSON source and the HTML artifact\n## Validation rules\n### Structural\n- Exactly one H1 title line\n- No heading-level skips\n- No Markdown tables\n### Safety\n- Stray arrows and pipe glyphs are rejected\n- Backticks and dollar-brace sequences are auto-escaped before they reach the embedded script\n## Output features\n### Inherited from the original template\n- Live search with match count and Ctrl+F\n- Dark and light themes with persisted state\n- SVG export\n- Pitch mode with fullscreen focus-and-zoom\n- One expand button per detected heading depth\n### Borrowed from archify\n- PNG export: a full-resolution, high-DPI (2x) raster of the whole map, distinct from the raw SVG export\n- Decorative animated links: a subtle flowing dash along branches, purely visual, not a data-flow direction\n## Retired features\n### Guided tour and minimap\n- Both were ported from archify, then iterated on across several sessions to fix real bugs (fold-depth calibration, focal-node highlighting, a fixed-position panel hiding tree content, a minimap that painted its own viewport highlight over its node markers)\n- Despite that investment, they never worked reliably enough — removed 2026-08-30 rather than continuing to sink effort into them\n"
}