{"title": "How to read the site",
 "producer": ["docs/site/guides/01-reading.md"],
 "format": "effect4-document/1",
 "body":
 [{"line":
   [{"text":
     "This guide explains how to read the documentation site. It describes what each page holds, how status marks work, how keys connect parts, and how tools inspect JSON artifacts."}],
   "kind": "para"},
  {"title": "What a page holds",
   "kind": "part",
   "key": "page-structure",
   "body":
   [{"line":
     [{"text":
       "Every page presents one topic with structured text. A page belongs to a site category such as guides, semantics, or the specimen."}],
     "kind": "para"},
    {"line": [{"text": "Each page provides three formats:"}], "kind": "para"},
    {"lines":
     [[{"text": "An HTML view rendered through a typed content shell."}],
      [{"text": "A Markdown file named "},
       {"code": "index.md"},
       {"text": " for text readers."}],
      [{"text": "A JSON document named "},
       {"code": "document.json"},
       {"text": " for machine tools."}]],
     "kind": "items"},
    {"line":
     [{"text":
       "The site derives pages from the loaded Lean environment and written Markdown sources. Generated pages show evidence from the repository, while written guides explain design principles."}],
     "kind": "para"}]},
  {"title": "Status words and marks",
   "kind": "part",
   "key": "status-marks",
   "body":
   [{"line":
     [{"text":
       "The site uses status words to communicate evidence. Each status word renders with a distinct visual mark in the interface:"}],
     "kind": "para"},
    {"lines":
     [[{"status": "proved"},
       {"text":
        ": A theorem accepted by the Lean kernel within the trust ceiling."}],
      [{"status": "modulo"},
       {"text": ": A theorem whose proof reaches one or more planned goals."}],
      [{"status": "goal"},
       {"text": ": A planned goal whose proof is admitted with "},
       {"code": "sorry"},
       {"text": "."}],
      [{"status": "open"},
       {"text": ": A requirement or task with unfinished obligations."}],
      [{"status": "refuted"},
       {"text": ": A statement that a registered counterexample refutes."}],
      [{"status": "absent"},
       {"text":
        ": A property with no declaration or goal, accompanied by a stated reason."}],
      [{"status": "assumed"},
       {"text": ": A condition taken as an external assumption."}]],
     "kind": "items"},
    {"line":
     [{"text":
       "These words keep evidence kinds distinct. A reader inspects the assigned mark to determine whether a claim rests on verified proofs or pending goals."}],
     "kind": "para"}]},
  {"title": "Keys and cross references",
   "kind": "part",
   "key": "keys",
   "body":
   [{"line":
     [{"text":
       "A part of a page carries a unique anchor key. Headings define keys either from explicit attributes or from normalized title text."}],
     "kind": "para"},
    {"line":
     [{"text": "A link refers to a key on the same page or across pages:"}],
     "kind": "para"},
    {"lines":
     [[{"text": "An anchor link points to a key using a hash prefix."}],
      [{"text": "A relative link points to another page directory."}],
      [{"text":
        "A claim key references a specific semantics claim in the registry."}]],
     "kind": "items"},
    {"line":
     [{"text":
       "These keys allow readers and tools to cite exact parts without relying on line numbers."}],
     "kind": "para"}]},
  {"title": "The open work",
   "kind": "part",
   "key": "open-work",
   "body":
   [{"line":
     [{"text":
       "The open work part of the semantics pages lists every open planned goal and every theorem proved modulo goals."}],
     "kind": "para"},
    {"line": [{"text": "Each entry gives three things:"}], "kind": "para"},
    {"lines":
     [[{"text": "The declared goal statement in Lean."}],
      [{"text": "The module and requirement that own the obligation."}],
      [{"text":
        "The docstring explaining why the proof waits and which consumer needs it."}]],
     "kind": "items"},
    {"line":
     [{"text":
       "Dependency chains show how higher milestones depend on open goals. Readers trace these chains to see the remaining verification steps."}],
     "kind": "para"}]},
  {"title": "Figures and code blocks",
   "kind": "part",
   "key": "figures",
   "body":
   [{"line":
     [{"text":
       "A figure draws a requirement's open work as a graph (decisions row 365). Its nodes are the planned goals and the theorems proved modulo them. An arrow goes from a node to a node its proof reaches first. Each node links to its claim or goal, and its mark gives its status."}],
     "kind": "para"},
    {"line":
     [{"text":
       "Below each figure, the figure in words lists every node with its status and the nodes it points to. It serves a reader who does not see the picture, and a screen reader names the figure by its caption."}],
     "kind": "para"},
    {"line":
     [{"text":
       "A code block shows a Lean statement or a definition. A statement longer than eight lines folds under its first line, and opens on demand (decisions row 366)."}],
     "kind": "para"}]},
  {"title": "Navigation and the margin",
   "kind": "part",
   "key": "navigation",
   "body":
   [{"line":
     [{"text":
       "The site provides navigation elements across every page. The top header displays major areas and breadcrumbs for the current path."}],
     "kind": "para"},
    {"line":
     [{"text":
       "The margin presents the parts list of the current page under the heading On this page. Readers select an entry in the margin to jump directly to that subsection."}],
     "kind": "para"},
    {"line":
     [{"text":
       "The bottom of each page links to the previous and next pages in the sequence. A dedicated contents page indexes every document across the site."}],
     "kind": "para"}]},
  {"title": "Reading the site as JSON",
   "kind": "part",
   "key": "json-records",
   "body":
   [{"line":
     [{"text":
       "Machine agents read the site through structured JSON files. Every page directory contains a "},
      {"code": "document.json"},
      {"text": " file conforming to the "},
      {"code": "effect4-document/1"},
      {"text": " format."}],
     "kind": "para"},
    {"line": [{"text": "The root provides two additional JSON resources:"}],
     "kind": "para"},
    {"lines":
     [[{"code": "site.json"},
       {"text":
        ": An index containing page paths, titles, group memberships, and part keys."}],
      [{"code": "semantics/report.json"},
       {"text":
        ": The whole semantics report data emitted by the semantics driver."}]],
     "kind": "items"},
    {"line":
     [{"text":
       "An automated agent parses these JSON files directly to verify claims, inspect dependency graphs, and follow part references."}],
     "kind": "para"}]}]}