From c2fea3ebb5203b6bd8dc666468ee9df51efe25c0 Mon Sep 17 00:00:00 2001
From: Paul Doho <paul.doho.741@my.csun.edu>
Date: Mon, 21 Sep 2026 22:58:17 +0100
Subject: [PATCH 1/2] feat: add TypeScript language adapter

---
 README.md                  |  10 +-
 docs/map/index.html        |   6 +-
 docs/map/map.json          |  16 +-
 docs/reference.md          |   3 +-
 map/model.py               |   8 +-
 pyproject.toml             |   6 +-
 src/systemap/change.py     |  58 ++---
 src/systemap/cli.py        |  12 +-
 src/systemap/config.py     |  45 +++-
 src/systemap/extract.py    | 106 ++++++++-
 src/systemap/language.py   |  68 ++++++
 src/systemap/scaffold.py   |  22 +-
 src/systemap/typescript.py | 470 +++++++++++++++++++++++++++++++++++++
 tests/test_extract.py      |  18 ++
 tests/test_screenshots.py  |   5 +-
 tests/test_typescript.py   | 121 ++++++++++
 uv.lock                    | 217 +++++++++++++++++
 17 files changed, 1116 insertions(+), 75 deletions(-)
 create mode 100644 src/systemap/language.py
 create mode 100644 src/systemap/typescript.py
 create mode 100644 tests/test_typescript.py

diff --git a/README.md b/README.md
index 6e624f2b..8ff22dbc 100644
--- a/README.md
+++ b/README.md
@@ -10,12 +10,12 @@
   <a href="https://pypi.org/project/systemap/"><img alt="the version on PyPI" src="https://img.shields.io/pypi/v/systemap?label=PyPI&color=e0a458&labelColor=121417"></a>
   <a href="https://pypi.org/project/systemap/"><img alt="the Python versions it runs on" src="https://img.shields.io/pypi/pyversions/systemap?color=b3b1aa&labelColor=121417"></a>
   <a href="LICENSE"><img alt="the licence" src="https://img.shields.io/pypi/l/systemap?color=8fbfa6&labelColor=121417"></a>
-  <img alt="how many dependencies it has" src="https://img.shields.io/badge/dependencies-none-b3b1aa?labelColor=121417">
+  <img alt="how many dependencies it has" src="https://img.shields.io/badge/dependencies-2-b3b1aa?labelColor=121417">
 </p>
 
 Your coding agent writes code faster than you can read it. You review the
 diff, you merge, and one day you notice you are no longer sure how the pieces
-of your own Python project fit together.
+of your own Python or TypeScript project fit together.
 
 **systemap gives you one page that shows how they fit.** Your agent draws it
 from your code. A checker then refuses to let that page go out of date, and
@@ -186,8 +186,10 @@ features that failed their test were written down rather than shipped
 
 ## What is systemap not?
 
-It reads Python and only Python. It is not a call graph: the map shows the
-lines your agent declared and defended, not every function call. It is not a
+It reads Python, TypeScript and TSX. TypeScript support reads exported names,
+imports, tests and package binaries; framework-specific routes and configured
+path aliases are not read yet. It is not a call graph: the map shows the lines
+your agent declared and defended, not every function call. It is not a
 dependency diagram: modules are not parts, and the map shows parts. It is not
 a UML tool: one picture, one layout, and nothing to learn beyond card, line
 and journey.
diff --git a/docs/map/index.html b/docs/map/index.html
index 56962c24..89b89c0e 100644
--- a/docs/map/index.html
+++ b/docs/map/index.html
@@ -177,7 +177,7 @@
 .systemap-panel{font-family:var(--fs);font-size:13px;line-height:1.45;color:var(--ink-2);background:var(--surface);border:1px solid var(--line);border-radius:8px;padding:.9rem 1rem 1rem;min-height:3rem}.systemap-panel:empty::before{content:'Click a component to read it.';color:var(--ink-3)}.systemap-f__plain{font-size:19px;font-weight:600;color:var(--ink);letter-spacing:-.01em;line-height:1.2;margin:0}.systemap-f__code{font-family:var(--fm);font-size:12px;color:var(--accent);margin:.3rem 0 0;display:flex;flex-wrap:wrap;gap:.2rem .7rem;align-items:baseline}.systemap-f__kind{color:var(--ink-3);font-size:11px;letter-spacing:.06em;text-transform:uppercase}.systemap-f__does{margin:.6rem 0 .2rem;font-size:13px;color:var(--ink-2)}.systemap-f__iface{margin:.3rem 0 .2rem;font-family:var(--fm);font-size:11.5px;color:var(--ink-2);word-break:break-word}.systemap-f__note{margin:.5rem 0 .2rem;padding:.4rem .6rem;font-size:12.5px;color:var(--ink);border-left:3px solid var(--warn);background:var(--raised);border-radius:0 6px 6px 0}.systemap-f__wheel{margin:.4rem 0 0}.systemap-f__wheel svg{width:100%;height:auto;display:block;margin:0 auto}.systemap-f__say{margin:.2rem 0 .6rem;padding:.55rem .7rem;font-size:13px;line-height:1.45;color:var(--ink);border-left:3px solid var(--accent);background:var(--raised);border-radius:0 6px 6px 0;min-height:2.6rem}.systemap-f__say.muted{color:var(--ink-3);border-left-color:var(--line-2)}.systemap-f__evidence{margin:-.3rem 0 .6rem;font-family:var(--fm);font-size:11px;color:var(--ink-3);min-height:1em}.systemap-f__evidence.declared{color:var(--warn)}.systemap-f__chips{display:flex;flex-wrap:wrap;gap:.35rem;margin:.5rem 0 0}.systemap-chip{display:inline-flex;align-items:center;gap:.35em;min-height:24px;padding:0 .55em;border-radius:4px;font-family:var(--fm);font-size:11px;letter-spacing:.04em;background:var(--raised);color:var(--ink-3);border:1px solid var(--line)}.systemap-chip--built{color:var(--good);border-color:transparent}.systemap-chip--actor{color:var(--ink-3);background:none;border:1px dashed var(--line-2)}.systemap-chip a{color:var(--accent);text-decoration:none}.systemap-chip a:hover{text-decoration:underline}.systemap-chip--rule{color:var(--violet);cursor:help;min-width:24px;justify-content:center}.systemap-f__lives{margin:.6rem 0 0;font-family:var(--fm);font-size:11px;color:var(--ink-3)}.systemap-f__lives b{font-weight:400;color:var(--ink-3)}.systemap-f__entry{margin:.4rem 0 0;font-family:var(--fm);font-size:11px;color:var(--ink-3)}.systemap-f__entry b{font-weight:400;color:var(--ink-2)}.systemap-f__opens{margin:.4rem 0 0;font-family:var(--fm);font-size:11px;color:var(--ink-3)}.systemap-f__opens b{font-weight:400;color:var(--ink-2)}.systemap-f__preview{margin:.5rem 0 0;border:1px solid var(--line);border-radius:6px;overflow:hidden;background:var(--bg)}.systemap-f__preview svg{width:100%;height:auto;display:block}.systemap-f__open{appearance:none;display:block;margin:.5rem 0 0;min-height:30px;padding:0 .8rem;border-radius:6px;border:1px solid var(--accent);background:none;color:var(--accent);font-family:var(--fs);font-size:12.5px;cursor:pointer}.systemap-f__open:hover{background:var(--raised)}.systemap-w__spoke{cursor:pointer;outline:none}.systemap-w__hit{stroke:transparent;stroke-width:26;fill:none;pointer-events:stroke}.systemap-w__line{fill:none;stroke-width:1.5;transition:stroke-width .12s ease}.systemap-w__verb{font-family:var(--fs);font-size:11px;font-weight:500;text-anchor:middle;paint-order:stroke;stroke:var(--surface);stroke-width:5;stroke-linejoin:round;pointer-events:none}.systemap-w__name{font-family:var(--fm);font-size:11px;font-weight:600;fill:var(--ink);pointer-events:none}.systemap-w__centre rect{fill:var(--raised);stroke:var(--accent);stroke-width:1.6}.systemap-w__centre text{font-family:var(--fm);font-size:12px;font-weight:600;fill:var(--ink);text-anchor:middle}.systemap-w__spoke.peek .systemap-w__line,.systemap-w__spoke:hover .systemap-w__line,.systemap-w__spoke:focus-visible .systemap-w__line{stroke-width:3.2}.systemap-w__spoke.peek .systemap-w__name,.systemap-w__spoke:hover .systemap-w__name,.systemap-w__spoke:focus-visible .systemap-w__name{fill:var(--accent)}.systemap-w__empty{font-family:var(--fs);font-size:12px;fill:var(--ink-3);text-anchor:middle}</style></head><body>
 <header class="bar">
 <h1>systemap <span>map</span></h1>
-<p class="meta">A generated map of what the parts of systemap are and what they are to each other: 16 components and 4 actors, 67 flows, five layers. Facts from <code title="the commit the tree was read at">10b4b6c232</code>.</p>
+<p class="meta">A generated map of what the parts of systemap are and what they are to each other: 16 components and 4 actors, 67 flows, five layers. Facts from <code title="the commit the tree was read at">83aabb8180</code>.</p>
 <nav class="nav">
 <a href="#map">Map</a><a href="#components">Components</a>
 <a href="#invariants">Invariants</a>
@@ -304,9 +304,9 @@ <h1>systemap <span>map</span></h1>
 <li id="rule-11" value="11"><span class="rules__t">check and judgement never reach the network; asking Jev is a separate command that sends nothing without a key (src/systemap/jev_cli.py, docstring).</span>
 <span class="governs"><button type="button" class="gv" data-go="Check">Check</button> <button type="button" class="gv" data-go="Judgement">Judgement</button> <button type="button" class="gv" data-go="SecondOpinion">SecondOpinion</button></span></li>
 </ol></section></main>
-<footer class="foot">Generated by <code>systemap</code> from <code>docs/map/map.json</code> and <code>map/model.py</code>. The facts are from <code>10b4b6c232</code>, the commit the tree was read at when they were extracted: the one before the commit that records them, since the facts are committed after they are read. Refresh with <code>systemap refresh</code>.</footer>
+<footer class="foot">Generated by <code>systemap</code> from <code>docs/map/map.json</code> and <code>map/model.py</code>. The facts are from <code>83aabb8180</code>, the commit the tree was read at when they were extracted: the one before the commit that records them, since the facts are committed after they are read. Refresh with <code>systemap refresh</code>.</footer>
 <script>(function(){
-var DETAIL = {"Placer":{"id":"Placer","kind":"component","region":"operate","plain":"what places the cards","does":"A first position for every card without one: regions on a two-column grid with corridors between them, in the order the search scores best (every order tried, the best routed and scored by collisions, refusals, bends and length), cards on the grid inside, ordered by barycentre sweeps over the flows. Writes the positions into map/model.py in place; with --all, lays every card out again and keeps the pinned ones.","state":"built","state_label":"built","lives":"systemap/place.py","interface":"compute(model) -> Placement; write(path, model, placement)","entry":"compute","entry_module":"systemap.place","note":"","calls_model":false,"map":null,"moved":false,"rules":[5],"edges":[3,38,39,46,47,48]},"CLI":{"id":"CLI","kind":"component","region":"operate","plain":"the commands","does":"The commands the agent runs: init, extract, check, render, figure, refresh, judgement, describe, serve, skill. Every non-zero exit names what to run next.","state":"built","state_label":"built","lives":"systemap/cli.py, systemap/__main__.py","interface":"main(argv) -> exit code: 0 current, 1 failed or stale, 2 unusable","entry":"main","entry_module":"systemap.cli","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[0,1,2,3,4,5,6,7,8,9,10,11,12,16]},"FactsExtractor":{"id":"FactsExtractor","kind":"component","region":"gather","plain":"what reads the code","does":"Walks the package's syntax tree and writes the facts: every module, its public surface and every public name, what it imports inside and outside the package, the tests that import it, and where a run can start. Nothing anyone writes changes what it finds; systemap facts reads them back one view at a time.","state":"built","state_label":"built","lives":"systemap/extract.py, systemap/facts.py, systemap/ways_in.py","interface":"build(cfg) -> facts; drift(fresh, stored) -> what no longer matches","entry":"build","entry_module":"systemap.extract","note":"","calls_model":false,"map":null,"moved":false,"rules":[4],"edges":[5,17,24,30,32,33,34,35,40]},"Scaffold":{"id":"Scaffold","kind":"component","region":"operate","plain":"what init writes","does":"What init writes once and never overwrites: the configuration, a starter model laid out as a grid of regions with corridors between them, the output directory, a pinned workflow.","state":"built","state_label":"built","lives":"systemap/scaffold.py","interface":"write(root, name, package, roots, ci) -> one line per file","entry":"write","entry_module":"systemap.scaffold","note":"never overwrites a file that exists: an upgrade of systemap edits nothing init wrote, so a pinned workflow is bumped by hand","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[2,31]},"Config":{"id":"Config","kind":"store","region":"operate","plain":"the configuration","does":"systemap.toml, or [tool.systemap] in pyproject.toml, resolved with defaults: package roots and tests directories discovered, judgement answers kept with their reasons. Unknown keys, ignores and answers without a reason are refused.","state":"built","state_label":"built","lives":"systemap/config.py","interface":"load(root) -> Config; load_model(path) -> (MODEL, MEANING)","entry":"load","entry_module":"systemap.config","note":"","calls_model":false,"map":null,"moved":false,"rules":[9,10],"edges":[16,17,18,19,20,21,22,23]},"ChangeDetector":{"id":"ChangeDetector","kind":"component","region":"gather","plain":"what a branch changed","does":"Works out what a branch changes in the map's terms: which components moved, what each gained or lost on its public surface, which exported names were redefined, and how far the change reaches through imports. systemap delta reads the facts at two commits out of git and says what the change did to the map, one line per thing with its fix; systemap history reads many commits and says what moved between them.","state":"built","state_label":"built","lives":"systemap/ (5 modules)","interface":"compute(cfg, model, base, facts, head) -> change; delta.compute(cfg, model, meaning, base facts, head facts) -> Delta","entry":"compute","entry_module":"systemap.change","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[6,15,18,27,35,36,37,41,56]},"TypeSafe":{"id":"TypeSafe","kind":"actor","region":"outside","plain":"the model asked","does":"The Jev model behind TypeSafe's HTTP API: answers typed questions about the map when a maintainer has set a key.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[25,26]},"Skill":{"id":"Skill","kind":"component","region":"mean","plain":"the procedure the agent follows","does":"The procedure the agent follows: extract, draft, check, judgement, render, the second pass, the stop condition, what to hand back, and the maintenance path when the code changed. A directory of plain text with references, shipped in the package.","state":"built","state_label":"built","lives":"systemap/skill.py","interface":"files() -> the skill directory; write(dir) -> the installed SKILL.md","entry":"write","entry_module":"systemap.skill","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,7],"edges":[4,58]},"Figures":{"id":"Figures","kind":"component","region":"draw","plain":"a picture for a document","does":"One figure from the same generator, for a document: the whole system, a plan's reach, or a change. A .svg output is the bare drawing on its ground.","state":"built","state_label":"built","lives":"systemap/figure.py","interface":"make(cfg, model, meaning, theme, facts, mode, components, base, head, caption, layer) -> (html, collisions)","entry":"make","entry_module":"systemap.figure","note":"","calls_model":false,"map":null,"moved":false,"rules":[1],"edges":[9,14,20,37,50]},"Page":{"id":"Page","kind":"component","region":"draw","plain":"the page you open","does":"Wraps the schematic into one self-contained HTML page: the layer switch, journeys, the focus drawer, the index by region, the invariants. No fonts, scripts or images are fetched; systemap serve serves it over HTTP.","state":"built","state_label":"built","lives":"systemap/page.py","interface":"build(cfg, model, meaning, theme, facts, change) -> html","entry":"build","entry_module":"systemap.page","note":"","calls_model":false,"map":null,"moved":false,"rules":[1,8],"edges":[8,13,19,36,49,54]},"CI":{"id":"CI","kind":"actor","region":"outside","plain":"the runner that refuses","does":"Runs the check on every pull request and fails the ones that leave the map behind.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[1,57]},"Model":{"id":"Model","kind":"store","region":"mean","plain":"the map as written","does":"The schema a map is written in, and the file the agent writes in it: containers, regions, components, flows, invariants, and the meaning tables. Checks that the meaning names only what the model has, reads from the facts whether an import backs each flow (observed, external or declared), and loads the tree of maps when a card opens a map of its own.","state":"built","state_label":"built","lives":"/ (5 modules)","interface":"Model(canvas, containers, regions, components, flows, flow_kinds, invariants) and Meaning(plain, layers, relations, journeys, verbs), exported by map/model.py as MODEL and MEANING","entry":"Model","entry_module":"systemap","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,3,4,5],"edges":[31,38,39,40,41,42,43,59,60,61,65]},"Router":{"id":"Router","kind":"component","region":"draw","plain":"what finds the routes","does":"Routes every flow orthogonally through the gutters between cards, never through a card it does not connect, never across a band it neither starts nor ends in, and seats each label where it touches nothing.","state":"built","state_label":"built","lives":"systemap/route.py","interface":"route_all(edges, cards, actors, blocks, regions, region_of, canvas) -> routes; place_labels(routes, widths, height, obstacles, canvas) -> seated labels","entry":"route_all","entry_module":"systemap.route","note":"","calls_model":false,"map":null,"moved":false,"rules":[5],"edges":[44,45,46]},"Schematic":{"id":"Schematic","kind":"component","region":"draw","plain":"what draws the map","does":"Draws the SVG: cards marked by kind, routes coloured by layer, and the interaction script that lights a clicked component's neighbours, switches readings, steps journeys, pans and zooms. The theme is one table of tokens.","state":"built","state_label":"built","lives":"systemap/schematic.py, systemap/theme.py","interface":"render(model, meaning, theme, facts) -> (svg, detail JSON)","entry":"render","entry_module":"systemap.schematic","note":"","calls_model":false,"map":null,"moved":false,"rules":[1,3,5],"edges":[33,42,44,47,49,50,51,52]},"Maintainer":{"id":"Maintainer","kind":"actor","region":"outside","plain":"the person who confirms","does":"Reads the judgement answers, corrects the model where it disagrees, and commits the map.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[6],"edges":[54,60,64]},"Agent":{"id":"Agent","kind":"actor","region":"outside","plain":"the agent that draws","does":"Reads the skill, runs the commands, writes the model, fixes what the check names, and answers what the judgement asks.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[6,7],"edges":[0,53,55,56,58,59,63,66]},"Judgement":{"id":"Judgement","kind":"component","region":"keep","plain":"what asks","does":"The list the agent acts on and the maintainer confirms: single-module components, odd folds, flows without a sentence, thin layers, entry points without a journey, imports across a boundary with no flow, model SDK imports outside an agent. Answered lines, singly or by family, are suppressed and counted. A report; a gate only with --strict. Before any of it, systemap suggest proposes a first grouping from the facts, to argue with.","state":"built","state_label":"built","lives":"systemap/judgement.py, systemap/suggest.py, systemap/explain.py","interface":"run(model, meaning, facts, sdks) -> lines; exit 1 with --strict while a line is open","entry":"run","entry_module":"systemap.judgement","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,6,7,11],"edges":[10,22,28,34,61,62,63,64]},"SecondOpinion":{"id":"SecondOpinion","kind":"component","region":"keep","plain":"what asks for a second opinion","does":"Help from outside this process, asked one narrow question at a time and cached: the Jev model for what judgement cannot read from names and imports (a module that reads like another card, a card for an unclaimed module, a sentence that may not describe its modules, a flow the code may not carry, an invariant that may govern a card it does not name, the cards an issue will change), and a coding agent named in the configuration for prose only a reader of the code can write. Opt-in; never a gate.","state":"built","state_label":"built","lives":"systemap/ (6 modules)","interface":"run(tree, facts, cfg, jev) -> lines; always exit 0","entry":"run","entry_module":"systemap.audit","note":"","calls_model":false,"map":null,"moved":false,"rules":[11],"edges":[12,23,24,25,26,27,28,29,65,66]},"Check":{"id":"Check","kind":"component","region":"keep","plain":"what refuses","does":"Every rule that refuses a lie: coverage, entry, interface, placement, routes, labels and card text, type size, meaning, wheels, and stale outputs. Each failure prints its fix; exit 1 on the first.","state":"built","state_label":"built","lives":"systemap/check.py","interface":"run(model, meaning, theme, facts, ignores) -> Result; stale(cfg, model, meaning, theme) -> lines","entry":"run","entry_module":"systemap.check","note":"","calls_model":false,"map":null,"moved":false,"rules":[4,5,6,10,11],"edges":[7,13,14,15,21,32,43,51,55,57,62]},"Describe":{"id":"Describe","kind":"component","region":"keep","plain":"what the picture shows","does":"What a look at the picture would tell an agent that cannot look: cards per region, bends and length per edge worst first, seats used per gutter, cards and edges per reading. A description, never a rule.","state":"built","state_label":"built","lives":"systemap/describe.py","interface":"run(model, meaning, theme, facts) -> lines; always exit 0","entry":"run","entry_module":"systemap.describe","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[11,29,30,45,48,52,53]},"_meta":{"layers":[{"id":"structure","label":"Structure","question":"What are the parts, and where does each sit?","sub":"every component inside its region and container; no edges","colour":"var(--l-structure)","tag":"var(--lt-structure)","derived":true},{"id":"system","label":"System context","question":"Who and what is outside, and how does it reach in?","sub":"the actors, and every edge that crosses the boundary","colour":"var(--l-system)","tag":"var(--lt-system)","derived":true},{"id":"data","label":"Data flow","question":"What moves, and where does it go?","sub":"an artifact moves: a file, a record, a message, a response","colour":"var(--l-data)","tag":"var(--lt-data)","derived":false},{"id":"control","label":"Control flow","question":"Who drives whom?","sub":"one part invokes, schedules or drives another: a call, a command, an event","colour":"var(--l-control)","tag":"var(--lt-control)","derived":false},{"id":"judge","label":"What judges","question":"Where does the meaning come from, and who confirms it?","sub":"the skill, the agent, the model, the judgement, the maintainer","colour":"var(--l-judge)","tag":"var(--lt-judge)","derived":false}],"readings":{"structure":{"edges":[],"subjects":["Agent","CI","Maintainer","TypeSafe","CLI","Scaffold","Config","FactsExtractor","ChangeDetector","Placer","Skill","Model","Router","Schematic","Page","Figures","Check","Judgement","SecondOpinion","Describe"]},"system":{"edges":[0,1,25,26,53,54,55,56,57,58,59,60,63,64,66],"subjects":["Agent","CI","Maintainer","TypeSafe"]},"data":{"edges":[16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57],"subjects":[]},"control":{"edges":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"subjects":[]},"judge":{"edges":[58,59,60,61,62,63,64,65,66],"subjects":[]}},"reading":"","edges":[{"from":"Agent","to":"CLI","art":"commands","kind":"control","layer":"control","out":"runs","in":"is run by","say":"The agent drives everything through the commands; it never imports the package.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"CI","to":"CLI","art":"check","kind":"control","layer":"control","out":"runs","in":"is run by","say":"The workflow init writes runs the check on every push and pull request.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"CLI","to":"Scaffold","art":"init","kind":"control","layer":"control","out":"runs","in":"is run by","say":"init hands the scaffold the project's name and package roots; the scaffold writes what does not exist yet.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Placer","art":"place","kind":"control","layer":"control","out":"runs","in":"is run by","say":"place computes a position for every card without one, or with --all for every card not pinned, and writes it into the model; describe places them for one look without writing.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Skill","art":"init, skill","kind":"control","layer":"control","out":"runs","in":"is run by","say":"init installs the skill directory beside the project, and skill reinstalls it; an upgrade of the package refreshes it.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"FactsExtractor","art":"extract","kind":"control","layer":"control","out":"runs","in":"is run by","say":"extract, and the first step of refresh, run the extractor over the configured package roots.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"ChangeDetector","art":"--base, delta","kind":"control","layer":"control","out":"runs","in":"is run by","say":"render --base and figure --base ask the change detector what a git range moved; delta asks it what a change did to the map, from the facts at two commits.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Check","art":"check","kind":"control","layer":"control","out":"runs","in":"is run by","say":"check runs every rule and prints each failure with its fix; refresh runs the same rules before it renders.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Page","art":"render","kind":"control","layer":"control","out":"runs","in":"is run by","say":"render, and refresh, build the page from the facts and the model.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Figures","art":"figure","kind":"control","layer":"control","out":"runs","in":"is run by","say":"figure draws one figure to a file; refresh draws every figure the configuration lists.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Judgement","art":"judgement","kind":"control","layer":"control","out":"runs","in":"is run by","say":"judgement prints the list to act on or answer; with --strict it exits 1 while a line is open.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Describe","art":"describe","kind":"control","layer":"control","out":"runs","in":"is run by","say":"describe draws the map the way the page does and prints what the drawing shows, in numbers.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"SecondOpinion","art":"audit, triage, --jev","kind":"control","layer":"control","out":"runs","in":"is run by","say":"audit, triage and the --jev flags hand their questions to the second opinion; check and judgement never do.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"Page","art":"render to compare","kind":"control","layer":"control","out":"compares","in":"is compared by","say":"The stale rule renders the page from the stored facts and compares it with the committed one.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"Figures","art":"render to compare","kind":"control","layer":"control","out":"compares","in":"is compared by","say":"The stale rule renders every configured figure and compares it with the committed one.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"ChangeDetector","art":"interface rule","kind":"control","layer":"control","out":"lends its rule to","in":"judges by","say":"delta judges an interface name that vanished by the check's own interface rule, so the two cannot disagree about what a line may start with.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"CLI","art":"settings","kind":"data","layer":"data","out":"configures","in":"is configured by","say":"The configuration tells the commands where the packages, the model and the output are.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"FactsExtractor","art":"package roots","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The package roots and the tests directory say what the extractor walks.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"ChangeDetector","art":"roots, tests dir","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The package roots and the tests directory say which changed files are modules and which are tests.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Page","art":"name, paths","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The page takes its title, its footer paths and the label for actors outside every region from the configuration.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Figures","art":"figures table","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The [[figures]] table says which figures refresh regenerates, in which mode, to which file.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Check","art":"ignores","kind":"data","layer":"data","out":"excuses modules to","in":"takes ignores from","say":"An ignore with a reason takes a module out of the coverage rule, on record.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Judgement","art":"answers, sdks","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The answers under [judgement] suppress the lines they cover, and [facts] model_sdks extends or reduces the SDK list the model sdk line reads.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"SecondOpinion","art":"answers, model, cache","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The configuration names the model, where its answers are cached, and the answers that suppress a jev line.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"SecondOpinion","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts give each question its state: a module's docstring, names and imports, and the lines where two cards meet.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"TypeSafe","art":"questions","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"One typed question at a time goes over HTTPS with the maintainer's key; nothing goes without it.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"TypeSafe","to":"SecondOpinion","art":"typed answers","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Jev sends back a probability or a choice with its distribution, which is cached by model release and question.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"SecondOpinion","to":"ChangeDetector","art":"moves Jev read","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"For delta --jev, the modules delta's own rules left unpaired go to Jev, and the new module it reads each as becomes one more move in delta's report.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"SecondOpinion","art":"the ways in with no walk","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Which ways into the system a journey walks from is one rule, and it lives in the judgement; the writer of journeys asks it what is left, so the two cannot disagree about what is covered.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"Describe","art":"the ways in with no walk","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe asks the writer of journeys how many ways into the system have no walk from them, and names the first few.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Describe","art":"entry points","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe names each way in the way a person would name it, which the extractor decides.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Scaffold","to":"Model","art":"starter","kind":"data","layer":"data","out":"writes the first","in":"starts as","say":"The starter model is the smallest map that passes every check; the agent replaces its words.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Check","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts are what the check judges coverage, entry and staleness against.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Schematic","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts file, written by extract and read back by every command, says which modules each card stands for and which flows an import backs.","evidence":"observed","mechanism":"facts file","evidence_says":"observed by: facts file"},{"from":"FactsExtractor","to":"Judgement","art":"entry points","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The entry points in the facts are what the judgement asks journeys for; the imports are what it walks for crossing edges.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"ChangeDetector","art":"surfaces","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The change detector reads a module's public surface with the extractor's parser, on both sides of the diff, so the two cannot disagree about what a module exports.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"ChangeDetector","to":"Page","art":"change map","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"With --base, the page carries a change map: what moved, what it reached.","evidence":"declared","mechanism":"","evidence_says":"declared: no import behind it"},{"from":"ChangeDetector","to":"Figures","art":"reach","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"A change figure marks what a git range changed; a reach figure marks what a plan will.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Placer","art":"cards, flows","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer reads the cards, their regions and the flows between them; a card with x and y is kept, and with --all only a pinned card is.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Placer","to":"Model","art":"positions","kind":"data","layer":"data","out":"places","in":"is placed by","say":"The placer writes the positions, the boxes and the canvas into map/model.py in place; the rest of the file is kept byte for byte.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"FactsExtractor","art":"claims","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The extractor reads the model's claims to warn about a module the tree no longer has.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"ChangeDetector","art":"claims","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The change detector attributes changed modules to the components that claim them.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Schematic","art":"topology, meaning","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The model is the topology the schematic draws and the meaning it prints on the wheel.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Check","art":"model","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The check reads the model's own contradictions first; nothing else is judged until they are gone.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Schematic","art":"routes, labels","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The router hands back the routes and the seated labels, and reports what could not be placed cleanly, with the fix that applies.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Describe","art":"gutters, seats","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The router's gutters and seat counts are what describe reports per gutter.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Placer","art":"routes, seats","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer routes every shortlisted region order with the router and the label pass, and keeps the order with the fewest label collisions, refused routes, bends and length.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Placer","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer scores a candidate layout on the drawing's own geometry (the card boxes, the headers and empty containers as walls, what a label may not sit on) and reads the header measurements so a box it lays out holds its header.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Placer","to":"Describe","art":"region order, score","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe reads the region order off the map as placed and the score of the drawing under it, and says how many orders place tried when it chose the order for the look.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Page","art":"svg, detail","kind":"data","layer":"data","out":"fills","in":"wraps","say":"The page embeds the SVG and the detail JSON the interaction script reads.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Figures","art":"svg","kind":"data","layer":"data","out":"fills","in":"wraps","say":"A figure is the same SVG in a figure element, or bare for an image.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Check","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The check renders once and reads the geometry back: routes, labels, type size, wheels.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Describe","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"describe renders once and reads the geometry back as a description: regions, edges, gutters, readings.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Describe","to":"Agent","art":"the picture in numbers","kind":"data","layer":"data","out":"describes to","in":"reads","say":"An agent that cannot open the page reads the picture in numbers after every refresh.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Page","to":"Maintainer","art":"the page","kind":"data","layer":"data","out":"is read by","in":"reads","say":"The maintainer opens the page: readings, click, journeys, pan and zoom.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Check","to":"Agent","art":"the fix","kind":"data","layer":"data","out":"refuses","in":"is refused by","say":"Every failure names its fix; the agent edits until coverage is complete and the layout is clean.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"ChangeDetector","to":"Agent","art":"what moved, and when","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"delta hands back what a change did to the map, one line per thing with its fix; history hands back what moved over a year, the largest windows first with the commits that wrote them.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Check","to":"CI","art":"verdict","kind":"data","layer":"data","out":"answers","in":"asks","say":"Exit 1 fails the pull request; the message says what to run.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Skill","to":"Agent","art":"procedure","kind":"judge","layer":"judge","out":"guides","in":"follows","say":"The skill gives the agent the loop, the schema, a worked example, the second pass, and what to hand back.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Agent","to":"Model","art":"map/model.py","kind":"judge","layer":"judge","out":"writes","in":"is written by","say":"The agent writes map/model.py: the groupings, the flows, the sentences, the journeys, the invariants.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Maintainer","to":"Model","art":"corrections","kind":"judge","layer":"judge","out":"corrects","in":"is corrected by","say":"The maintainer corrects the calls they disagree with; the model is theirs once reviewed.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Model","to":"Judgement","art":"model","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The judgement reads the model for the calls that could have gone another way.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"Check","art":"the teaching under each line","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The lesson under each kind of line lives with the judgement, because that is where most kinds come from; the check reads it to say why a failing rule matters and what to do.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"Agent","art":"second-pass list","kind":"judge","layer":"judge","out":"asks","in":"answers","say":"In the second pass the agent walks every crossing import and every entry point without a journey, and changes the model or answers the line.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Judgement","to":"Maintainer","art":"judgement answers","kind":"judge","layer":"judge","out":"reports to","in":"confirms","say":"The maintainer reads the agent's answers, line by line; the list is mechanical to produce, so the review cannot be skipped.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Model","to":"SecondOpinion","art":"cards, sentences","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The model's cards, sentences, flows and invariants are what the questions ask about.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"Agent","art":"jev lines","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The agent gets a jev line where the answer disagrees with the map, to act on or answer like a judgement line; when the configuration names an agent command, it is also asked the questions whose answer is prose.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"}],"journeys":[{"id":"over-time","label":"A year of the system: what moved, and what wrote it","starts":"systemap history (subcommand)","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"Somebody asks what the last year did to the system: systemap history, since a date, one sample every so many days."},{"acts":["ChangeDetector"],"measures":[],"edge":6,"say":"The change detector picks one commit per window out of git, oldest first, so a busy fortnight and a quiet one weigh the same."},{"acts":["FactsExtractor"],"measures":[],"edge":35,"say":"The facts at each commit are extracted from the tree git holds, never from the working copy, and kept under .systemap/facts so the second run is quick."},{"acts":["ChangeDetector"],"measures":["Model"],"edge":41,"say":"Every sample is read in today's cards, so a module that moved still counts as the card whose job it does."},{"acts":["ChangeDetector"],"measures":[],"edge":56,"say":"The largest windows are printed first: the cards that grew, the imports that began crossing a boundary, and the commits that wrote the modules which appeared."}]},{"id":"plan-then-check","label":"A plan: the cards the work will touch, then what it actually touched","starts":"plan (subcommand in systemap.jev_cli)","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"Before the work, the agent or the maintainer runs systemap plan with the task in plain words."},{"acts":["SecondOpinion"],"measures":[],"edge":65,"say":"The projection reads every card's purpose out of the model, so the question is asked in the map's own vocabulary."},{"acts":["SecondOpinion"],"measures":[],"edge":25,"say":"One question goes to Jev: which component will this work most likely have to change?"},{"acts":["TypeSafe"],"measures":[],"edge":26,"say":"Jev answers with a weight for every card, and the cards above the measured cut are the projection."},{"acts":["SecondOpinion"],"measures":[],"edge":66,"say":"Around each card named, the map prints the flows, walks and rules it sits in, and the projection is written under .systemap/plans."},{"acts":["ChangeDetector"],"measures":["SecondOpinion"],"edge":35,"say":"After the work, systemap plan --check reads the facts where the work started and the facts now, and names every card that changed outside the plan."}]},{"id":"second-opinion","label":"A second opinion: systemap audit, and triage for an issue","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"With a key set and the judgement clean, the agent runs systemap audit; a maintainer with an issue in hand runs systemap triage."},{"acts":["SecondOpinion"],"measures":[],"edge":65,"say":"The second opinion reads the cards, sentences, flows and invariants, and the facts behind them, into one narrow question each."},{"acts":["SecondOpinion"],"measures":[],"edge":25,"say":"Questions the cache cannot answer go to Jev over HTTPS; audit --dry-run says what would leave the machine first."},{"acts":["TypeSafe"],"measures":[],"edge":26,"say":"Jev answers each with a probability or a choice, and every answer is cached by the model's release."},{"acts":["SecondOpinion"],"measures":["Agent"],"edge":66,"say":"A jev line where the answer disagrees with the map, or triage's three likeliest cards; the agent acts on a line or answers it under [judgement]."}]},{"id":"first-map","label":"The first map: systemap init, extract, a draft, check","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent runs systemap init: configuration, starter model, the workflow."},{"acts":["CLI"],"measures":[],"edge":4,"say":"init installs the skill directory beside the project; systemap skill reinstalls it later."},{"acts":["Skill"],"measures":[],"edge":58,"say":"The skill gives the agent the loop: extract, draft, check, judgement, render, second pass."},{"acts":["FactsExtractor"],"measures":[],"edge":5,"say":"systemap extract reads every module, its surface, its imports and the entry points out of the tree."},{"acts":["Agent"],"measures":[],"edge":59,"say":"The agent runs systemap suggest for a first grouping to argue with, then writes map/model.py: components, flows, one sentence per edge, a journey per entry point, and no positions."},{"acts":["Placer"],"measures":[],"edge":39,"say":"systemap place lays the regions out on a grid with corridors between them, puts every card on it, and writes the positions into the file."},{"acts":["Check"],"measures":["Check"],"edge":55,"say":"systemap check names each failure and its fix; the agent edits until coverage is N/N and the layout is clean."}]},{"id":"second-pass","label":"The second pass: judgement, then refresh","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent runs systemap judgement."},{"acts":["Judgement"],"measures":[],"edge":34,"say":"The judgement walks the imports in the facts for edges the model lacks, and the entry points for journeys it lacks."},{"acts":["Judgement"],"measures":["Judgement"],"edge":63,"say":"One line per crossing import, per entry point without a journey, per thin layer: the agent changes the model or answers the line."},{"acts":["Agent"],"measures":[],"edge":59,"say":"The agent adds the missed edges, regroups what was grouped by directory, and reruns check; a full pass that changes nothing is the stop."},{"acts":["Page"],"measures":[],"edge":8,"say":"systemap refresh renders the page and every configured figure; systemap describe says what the picture shows, and systemap serve opens the page for anyone who can look."},{"acts":["Judgement"],"measures":["Maintainer"],"edge":64,"say":"The agent answers the remaining judgement lines in systemap.toml, under [judgement] answered, singly or by family; judgement --strict exits 0, and the maintainer reads the answers and commits docs/map."}]},{"id":"refactor","label":"A refactor moves a module: the maintenance path","starts":"","drafted":false,"steps":[{"acts":["CI"],"measures":[],"edge":1,"say":"A pull request moves a module; the workflow runs systemap delta --base against the base branch and posts what the change did to the map as one comment."},{"acts":["ChangeDetector"],"measures":[],"edge":6,"say":"The detector reads the facts at both commits out of git, never from the working copy, and names the card that still names the old path, with the rename that fixes it."},{"acts":["Check"],"measures":["CI"],"edge":57,"say":"The job fails while a line needs a decision; the comment names each fix, so the map is maintained in the pull request that changed the code."},{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent follows the maintenance path: acts on the delta's lines alone, never redrawing the map, then runs refresh, check and judgement --strict, and commits docs/map."},{"acts":["Page"],"measures":["Maintainer"],"edge":54,"say":"The maintainer reads the page: the moved part is where the code now says it is."}]}],"regions":[{"id":"operate","label":"OPERATE","box":[250.0,80.0,380.0,204.0],"ids":["CLI","Scaffold","Config","Placer"]},{"id":"gather","label":"GATHER","box":[678.0,80.0,190.0,204.0],"ids":["FactsExtractor","ChangeDetector"]},{"id":"mean","label":"MEAN","box":[250.0,320.0,190.0,204.0],"ids":["Skill","Model"]},{"id":"draw","label":"DRAW","box":[678.0,320.0,380.0,204.0],"ids":["Router","Schematic","Page","Figures"]},{"id":"keep","label":"KEEP TRUE","box":[250.0,560.0,380.0,296.0],"ids":["Check","Judgement","SecondOpinion","Describe"]}],"rules":[{"n":1,"text":"No counts of code or tests anywhere on the page: the map explains what the system does, not how much of it there is (README, Principles).","ids":["Figures","Page","Schematic"]},{"n":2,"text":"A component is something a reader would point at and name; a module is not a part (README, Principles).","ids":["Judgement","Model","Skill"]},{"n":3,"text":"Edges carry the relationships; prose is for emphasis (README, Principles).","ids":["Model","Schematic"]},{"n":4,"text":"The map draws what exists today: every module a component names is in the facts, and nothing on the map is a plan (README, Principles).","ids":["Check","FactsExtractor","Model"]},{"n":5,"text":"Positions are fixed in the model, written once by systemap place or by hand, and the checker decides, so the same system always draws the same picture (README, Principles).","ids":["Check","Model","Placer","Router","Schematic"]},{"n":6,"text":"The agent authors, the checker refuses, the person reviews (README, Principles).","ids":["Agent","Check","Judgement","Maintainer"]},{"n":7,"text":"The map is built in passes; the second pass is the point (README, Principles).","ids":["Agent","Judgement","Skill"]},{"n":8,"text":"The page fetches nothing and depends on nothing (README, opening).","ids":["Page"]},{"n":9,"text":"An unknown configuration key is refused, never ignored (src/systemap/config.py, load: 'unknown key').","ids":["Config"]},{"n":10,"text":"Every ignored module needs a reason (tests/test_coverage.py: test_ignore_without_reason_is_a_config_error).","ids":["Check","Config"]},{"n":11,"text":"check and judgement never reach the network; asking Jev is a separate command that sends nothing without a key (src/systemap/jev_cli.py, docstring).","ids":["Check","Judgement","SecondOpinion"]}],"kinds":["judge"],"states":{"built":20},"evidence":{"observed":51,"external":15,"declared":1},"collisions":[],"notes":[],"headers":[{"id":"outside","kind":"container","box":[24,22,152.4,54]},{"id":"systemap","kind":"container","box":[238,22,360.8,42]},{"id":"operate","kind":"region","box":[256,85,150.0,24]},{"id":"gather","kind":"region","box":[684,85,150.0,24]},{"id":"mean","kind":"region","box":[256,325,150.0,24]},{"id":"draw","kind":"region","box":[684,325,150.0,24]},{"id":"keep","kind":"region","box":[256,565,150.0,24]}]}};
+var DETAIL = {"Placer":{"id":"Placer","kind":"component","region":"operate","plain":"what places the cards","does":"A first position for every card without one: regions on a two-column grid with corridors between them, in the order the search scores best (every order tried, the best routed and scored by collisions, refusals, bends and length), cards on the grid inside, ordered by barycentre sweeps over the flows. Writes the positions into map/model.py in place; with --all, lays every card out again and keeps the pinned ones.","state":"built","state_label":"built","lives":"systemap/place.py","interface":"compute(model) -> Placement; write(path, model, placement)","entry":"compute","entry_module":"systemap.place","note":"","calls_model":false,"map":null,"moved":false,"rules":[5],"edges":[3,38,39,46,47,48]},"CLI":{"id":"CLI","kind":"component","region":"operate","plain":"the commands","does":"The commands the agent runs: init, extract, check, render, figure, refresh, judgement, describe, serve, skill. Every non-zero exit names what to run next.","state":"built","state_label":"built","lives":"systemap/cli.py, systemap/__main__.py","interface":"main(argv) -> exit code: 0 current, 1 failed or stale, 2 unusable","entry":"main","entry_module":"systemap.cli","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[0,1,2,3,4,5,6,7,8,9,10,11,12,16]},"FactsExtractor":{"id":"FactsExtractor","kind":"component","region":"gather","plain":"what reads the code","does":"Walks the package's syntax tree and writes the facts: every module, its public surface and every public name, what it imports inside and outside the package, the tests that import it, and where a run can start. Nothing anyone writes changes what it finds; systemap facts reads them back one view at a time.","state":"built","state_label":"built","lives":"systemap/ (5 modules)","interface":"build(cfg) -> facts; drift(fresh, stored) -> what no longer matches","entry":"build","entry_module":"systemap.extract","note":"","calls_model":false,"map":null,"moved":false,"rules":[4],"edges":[5,17,24,30,32,33,34,35,40]},"Scaffold":{"id":"Scaffold","kind":"component","region":"operate","plain":"what init writes","does":"What init writes once and never overwrites: the configuration, a starter model laid out as a grid of regions with corridors between them, the output directory, a pinned workflow.","state":"built","state_label":"built","lives":"systemap/scaffold.py","interface":"write(root, name, package, roots, ci) -> one line per file","entry":"write","entry_module":"systemap.scaffold","note":"never overwrites a file that exists: an upgrade of systemap edits nothing init wrote, so a pinned workflow is bumped by hand","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[2,31]},"Config":{"id":"Config","kind":"store","region":"operate","plain":"the configuration","does":"systemap.toml, or [tool.systemap] in pyproject.toml, resolved with defaults: package roots and tests directories discovered, judgement answers kept with their reasons. Unknown keys, ignores and answers without a reason are refused.","state":"built","state_label":"built","lives":"systemap/config.py","interface":"load(root) -> Config; load_model(path) -> (MODEL, MEANING)","entry":"load","entry_module":"systemap.config","note":"","calls_model":false,"map":null,"moved":false,"rules":[9,10],"edges":[16,17,18,19,20,21,22,23]},"ChangeDetector":{"id":"ChangeDetector","kind":"component","region":"gather","plain":"what a branch changed","does":"Works out what a branch changes in the map's terms: which components moved, what each gained or lost on its public surface, which exported names were redefined, and how far the change reaches through imports. systemap delta reads the facts at two commits out of git and says what the change did to the map, one line per thing with its fix; systemap history reads many commits and says what moved between them.","state":"built","state_label":"built","lives":"systemap/ (5 modules)","interface":"compute(cfg, model, base, facts, head) -> change; delta.compute(cfg, model, meaning, base facts, head facts) -> Delta","entry":"compute","entry_module":"systemap.change","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[6,15,18,27,35,36,37,41,56]},"TypeSafe":{"id":"TypeSafe","kind":"actor","region":"outside","plain":"the model asked","does":"The Jev model behind TypeSafe's HTTP API: answers typed questions about the map when a maintainer has set a key.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[25,26]},"Skill":{"id":"Skill","kind":"component","region":"mean","plain":"the procedure the agent follows","does":"The procedure the agent follows: extract, draft, check, judgement, render, the second pass, the stop condition, what to hand back, and the maintenance path when the code changed. A directory of plain text with references, shipped in the package.","state":"built","state_label":"built","lives":"systemap/skill.py","interface":"files() -> the skill directory; write(dir) -> the installed SKILL.md","entry":"write","entry_module":"systemap.skill","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,7],"edges":[4,58]},"Figures":{"id":"Figures","kind":"component","region":"draw","plain":"a picture for a document","does":"One figure from the same generator, for a document: the whole system, a plan's reach, or a change. A .svg output is the bare drawing on its ground.","state":"built","state_label":"built","lives":"systemap/figure.py","interface":"make(cfg, model, meaning, theme, facts, mode, components, base, head, caption, layer) -> (html, collisions)","entry":"make","entry_module":"systemap.figure","note":"","calls_model":false,"map":null,"moved":false,"rules":[1],"edges":[9,14,20,37,50]},"Page":{"id":"Page","kind":"component","region":"draw","plain":"the page you open","does":"Wraps the schematic into one self-contained HTML page: the layer switch, journeys, the focus drawer, the index by region, the invariants. No fonts, scripts or images are fetched; systemap serve serves it over HTTP.","state":"built","state_label":"built","lives":"systemap/page.py","interface":"build(cfg, model, meaning, theme, facts, change) -> html","entry":"build","entry_module":"systemap.page","note":"","calls_model":false,"map":null,"moved":false,"rules":[1,8],"edges":[8,13,19,36,49,54]},"CI":{"id":"CI","kind":"actor","region":"outside","plain":"the runner that refuses","does":"Runs the check on every pull request and fails the ones that leave the map behind.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[1,57]},"Model":{"id":"Model","kind":"store","region":"mean","plain":"the map as written","does":"The schema a map is written in, and the file the agent writes in it: containers, regions, components, flows, invariants, and the meaning tables. Checks that the meaning names only what the model has, reads from the facts whether an import backs each flow (observed, external or declared), and loads the tree of maps when a card opens a map of its own.","state":"built","state_label":"built","lives":"/ (5 modules)","interface":"Model(canvas, containers, regions, components, flows, flow_kinds, invariants) and Meaning(plain, layers, relations, journeys, verbs), exported by map/model.py as MODEL and MEANING","entry":"Model","entry_module":"systemap","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,3,4,5],"edges":[31,38,39,40,41,42,43,59,60,61,65]},"Router":{"id":"Router","kind":"component","region":"draw","plain":"what finds the routes","does":"Routes every flow orthogonally through the gutters between cards, never through a card it does not connect, never across a band it neither starts nor ends in, and seats each label where it touches nothing.","state":"built","state_label":"built","lives":"systemap/route.py","interface":"route_all(edges, cards, actors, blocks, regions, region_of, canvas) -> routes; place_labels(routes, widths, height, obstacles, canvas) -> seated labels","entry":"route_all","entry_module":"systemap.route","note":"","calls_model":false,"map":null,"moved":false,"rules":[5],"edges":[44,45,46]},"Schematic":{"id":"Schematic","kind":"component","region":"draw","plain":"what draws the map","does":"Draws the SVG: cards marked by kind, routes coloured by layer, and the interaction script that lights a clicked component's neighbours, switches readings, steps journeys, pans and zooms. The theme is one table of tokens.","state":"built","state_label":"built","lives":"systemap/schematic.py, systemap/theme.py","interface":"render(model, meaning, theme, facts) -> (svg, detail JSON)","entry":"render","entry_module":"systemap.schematic","note":"","calls_model":false,"map":null,"moved":false,"rules":[1,3,5],"edges":[33,42,44,47,49,50,51,52]},"Maintainer":{"id":"Maintainer","kind":"actor","region":"outside","plain":"the person who confirms","does":"Reads the judgement answers, corrects the model where it disagrees, and commits the map.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[6],"edges":[54,60,64]},"Agent":{"id":"Agent","kind":"actor","region":"outside","plain":"the agent that draws","does":"Reads the skill, runs the commands, writes the model, fixes what the check names, and answers what the judgement asks.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[6,7],"edges":[0,53,55,56,58,59,63,66]},"Judgement":{"id":"Judgement","kind":"component","region":"keep","plain":"what asks","does":"The list the agent acts on and the maintainer confirms: single-module components, odd folds, flows without a sentence, thin layers, entry points without a journey, imports across a boundary with no flow, model SDK imports outside an agent. Answered lines, singly or by family, are suppressed and counted. A report; a gate only with --strict. Before any of it, systemap suggest proposes a first grouping from the facts, to argue with.","state":"built","state_label":"built","lives":"systemap/judgement.py, systemap/suggest.py, systemap/explain.py","interface":"run(model, meaning, facts, sdks) -> lines; exit 1 with --strict while a line is open","entry":"run","entry_module":"systemap.judgement","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,6,7,11],"edges":[10,22,28,34,61,62,63,64]},"SecondOpinion":{"id":"SecondOpinion","kind":"component","region":"keep","plain":"what asks for a second opinion","does":"Help from outside this process, asked one narrow question at a time and cached: the Jev model for what judgement cannot read from names and imports (a module that reads like another card, a card for an unclaimed module, a sentence that may not describe its modules, a flow the code may not carry, an invariant that may govern a card it does not name, the cards an issue will change), and a coding agent named in the configuration for prose only a reader of the code can write. Opt-in; never a gate.","state":"built","state_label":"built","lives":"systemap/ (6 modules)","interface":"run(tree, facts, cfg, jev) -> lines; always exit 0","entry":"run","entry_module":"systemap.audit","note":"","calls_model":false,"map":null,"moved":false,"rules":[11],"edges":[12,23,24,25,26,27,28,29,65,66]},"Check":{"id":"Check","kind":"component","region":"keep","plain":"what refuses","does":"Every rule that refuses a lie: coverage, entry, interface, placement, routes, labels and card text, type size, meaning, wheels, and stale outputs. Each failure prints its fix; exit 1 on the first.","state":"built","state_label":"built","lives":"systemap/check.py","interface":"run(model, meaning, theme, facts, ignores) -> Result; stale(cfg, model, meaning, theme) -> lines","entry":"run","entry_module":"systemap.check","note":"","calls_model":false,"map":null,"moved":false,"rules":[4,5,6,10,11],"edges":[7,13,14,15,21,32,43,51,55,57,62]},"Describe":{"id":"Describe","kind":"component","region":"keep","plain":"what the picture shows","does":"What a look at the picture would tell an agent that cannot look: cards per region, bends and length per edge worst first, seats used per gutter, cards and edges per reading. A description, never a rule.","state":"built","state_label":"built","lives":"systemap/describe.py","interface":"run(model, meaning, theme, facts) -> lines; always exit 0","entry":"run","entry_module":"systemap.describe","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[11,29,30,45,48,52,53]},"_meta":{"layers":[{"id":"structure","label":"Structure","question":"What are the parts, and where does each sit?","sub":"every component inside its region and container; no edges","colour":"var(--l-structure)","tag":"var(--lt-structure)","derived":true},{"id":"system","label":"System context","question":"Who and what is outside, and how does it reach in?","sub":"the actors, and every edge that crosses the boundary","colour":"var(--l-system)","tag":"var(--lt-system)","derived":true},{"id":"data","label":"Data flow","question":"What moves, and where does it go?","sub":"an artifact moves: a file, a record, a message, a response","colour":"var(--l-data)","tag":"var(--lt-data)","derived":false},{"id":"control","label":"Control flow","question":"Who drives whom?","sub":"one part invokes, schedules or drives another: a call, a command, an event","colour":"var(--l-control)","tag":"var(--lt-control)","derived":false},{"id":"judge","label":"What judges","question":"Where does the meaning come from, and who confirms it?","sub":"the skill, the agent, the model, the judgement, the maintainer","colour":"var(--l-judge)","tag":"var(--lt-judge)","derived":false}],"readings":{"structure":{"edges":[],"subjects":["Agent","CI","Maintainer","TypeSafe","CLI","Scaffold","Config","FactsExtractor","ChangeDetector","Placer","Skill","Model","Router","Schematic","Page","Figures","Check","Judgement","SecondOpinion","Describe"]},"system":{"edges":[0,1,25,26,53,54,55,56,57,58,59,60,63,64,66],"subjects":["Agent","CI","Maintainer","TypeSafe"]},"data":{"edges":[16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57],"subjects":[]},"control":{"edges":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"subjects":[]},"judge":{"edges":[58,59,60,61,62,63,64,65,66],"subjects":[]}},"reading":"","edges":[{"from":"Agent","to":"CLI","art":"commands","kind":"control","layer":"control","out":"runs","in":"is run by","say":"The agent drives everything through the commands; it never imports the package.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"CI","to":"CLI","art":"check","kind":"control","layer":"control","out":"runs","in":"is run by","say":"The workflow init writes runs the check on every push and pull request.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"CLI","to":"Scaffold","art":"init","kind":"control","layer":"control","out":"runs","in":"is run by","say":"init hands the scaffold the project's name and package roots; the scaffold writes what does not exist yet.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Placer","art":"place","kind":"control","layer":"control","out":"runs","in":"is run by","say":"place computes a position for every card without one, or with --all for every card not pinned, and writes it into the model; describe places them for one look without writing.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Skill","art":"init, skill","kind":"control","layer":"control","out":"runs","in":"is run by","say":"init installs the skill directory beside the project, and skill reinstalls it; an upgrade of the package refreshes it.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"FactsExtractor","art":"extract","kind":"control","layer":"control","out":"runs","in":"is run by","say":"extract, and the first step of refresh, run the extractor over the configured package roots.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"ChangeDetector","art":"--base, delta","kind":"control","layer":"control","out":"runs","in":"is run by","say":"render --base and figure --base ask the change detector what a git range moved; delta asks it what a change did to the map, from the facts at two commits.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Check","art":"check","kind":"control","layer":"control","out":"runs","in":"is run by","say":"check runs every rule and prints each failure with its fix; refresh runs the same rules before it renders.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Page","art":"render","kind":"control","layer":"control","out":"runs","in":"is run by","say":"render, and refresh, build the page from the facts and the model.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Figures","art":"figure","kind":"control","layer":"control","out":"runs","in":"is run by","say":"figure draws one figure to a file; refresh draws every figure the configuration lists.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Judgement","art":"judgement","kind":"control","layer":"control","out":"runs","in":"is run by","say":"judgement prints the list to act on or answer; with --strict it exits 1 while a line is open.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Describe","art":"describe","kind":"control","layer":"control","out":"runs","in":"is run by","say":"describe draws the map the way the page does and prints what the drawing shows, in numbers.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"SecondOpinion","art":"audit, triage, --jev","kind":"control","layer":"control","out":"runs","in":"is run by","say":"audit, triage and the --jev flags hand their questions to the second opinion; check and judgement never do.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"Page","art":"render to compare","kind":"control","layer":"control","out":"compares","in":"is compared by","say":"The stale rule renders the page from the stored facts and compares it with the committed one.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"Figures","art":"render to compare","kind":"control","layer":"control","out":"compares","in":"is compared by","say":"The stale rule renders every configured figure and compares it with the committed one.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"ChangeDetector","art":"interface rule","kind":"control","layer":"control","out":"lends its rule to","in":"judges by","say":"delta judges an interface name that vanished by the check's own interface rule, so the two cannot disagree about what a line may start with.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"CLI","art":"settings","kind":"data","layer":"data","out":"configures","in":"is configured by","say":"The configuration tells the commands where the packages, the model and the output are.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"FactsExtractor","art":"package roots","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The package roots and the tests directory say what the extractor walks.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"ChangeDetector","art":"roots, tests dir","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The package roots and the tests directory say which changed files are modules and which are tests.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Page","art":"name, paths","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The page takes its title, its footer paths and the label for actors outside every region from the configuration.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Figures","art":"figures table","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The [[figures]] table says which figures refresh regenerates, in which mode, to which file.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Check","art":"ignores","kind":"data","layer":"data","out":"excuses modules to","in":"takes ignores from","say":"An ignore with a reason takes a module out of the coverage rule, on record.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Judgement","art":"answers, sdks","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The answers under [judgement] suppress the lines they cover, and [facts] model_sdks extends or reduces the SDK list the model sdk line reads.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"SecondOpinion","art":"answers, model, cache","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The configuration names the model, where its answers are cached, and the answers that suppress a jev line.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"SecondOpinion","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts give each question its state: a module's docstring, names and imports, and the lines where two cards meet.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"TypeSafe","art":"questions","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"One typed question at a time goes over HTTPS with the maintainer's key; nothing goes without it.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"TypeSafe","to":"SecondOpinion","art":"typed answers","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Jev sends back a probability or a choice with its distribution, which is cached by model release and question.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"SecondOpinion","to":"ChangeDetector","art":"moves Jev read","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"For delta --jev, the modules delta's own rules left unpaired go to Jev, and the new module it reads each as becomes one more move in delta's report.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"SecondOpinion","art":"the ways in with no walk","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Which ways into the system a journey walks from is one rule, and it lives in the judgement; the writer of journeys asks it what is left, so the two cannot disagree about what is covered.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"Describe","art":"the ways in with no walk","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe asks the writer of journeys how many ways into the system have no walk from them, and names the first few.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Describe","art":"entry points","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe names each way in the way a person would name it, which the extractor decides.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Scaffold","to":"Model","art":"starter","kind":"data","layer":"data","out":"writes the first","in":"starts as","say":"The starter model is the smallest map that passes every check; the agent replaces its words.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Check","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts are what the check judges coverage, entry and staleness against.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Schematic","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts file, written by extract and read back by every command, says which modules each card stands for and which flows an import backs.","evidence":"observed","mechanism":"facts file","evidence_says":"observed by: facts file"},{"from":"FactsExtractor","to":"Judgement","art":"entry points","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The entry points in the facts are what the judgement asks journeys for; the imports are what it walks for crossing edges.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"ChangeDetector","art":"surfaces","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The change detector reads a module's public surface with the extractor's parser, on both sides of the diff, so the two cannot disagree about what a module exports.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"ChangeDetector","to":"Page","art":"change map","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"With --base, the page carries a change map: what moved, what it reached.","evidence":"declared","mechanism":"","evidence_says":"declared: no import behind it"},{"from":"ChangeDetector","to":"Figures","art":"reach","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"A change figure marks what a git range changed; a reach figure marks what a plan will.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Placer","art":"cards, flows","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer reads the cards, their regions and the flows between them; a card with x and y is kept, and with --all only a pinned card is.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Placer","to":"Model","art":"positions","kind":"data","layer":"data","out":"places","in":"is placed by","say":"The placer writes the positions, the boxes and the canvas into map/model.py in place; the rest of the file is kept byte for byte.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"FactsExtractor","art":"claims","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The extractor reads the model's claims to warn about a module the tree no longer has.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"ChangeDetector","art":"claims","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The change detector attributes changed modules to the components that claim them.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Schematic","art":"topology, meaning","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The model is the topology the schematic draws and the meaning it prints on the wheel.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Check","art":"model","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The check reads the model's own contradictions first; nothing else is judged until they are gone.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Schematic","art":"routes, labels","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The router hands back the routes and the seated labels, and reports what could not be placed cleanly, with the fix that applies.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Describe","art":"gutters, seats","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The router's gutters and seat counts are what describe reports per gutter.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Placer","art":"routes, seats","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer routes every shortlisted region order with the router and the label pass, and keeps the order with the fewest label collisions, refused routes, bends and length.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Placer","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer scores a candidate layout on the drawing's own geometry (the card boxes, the headers and empty containers as walls, what a label may not sit on) and reads the header measurements so a box it lays out holds its header.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Placer","to":"Describe","art":"region order, score","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe reads the region order off the map as placed and the score of the drawing under it, and says how many orders place tried when it chose the order for the look.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Page","art":"svg, detail","kind":"data","layer":"data","out":"fills","in":"wraps","say":"The page embeds the SVG and the detail JSON the interaction script reads.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Figures","art":"svg","kind":"data","layer":"data","out":"fills","in":"wraps","say":"A figure is the same SVG in a figure element, or bare for an image.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Check","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The check renders once and reads the geometry back: routes, labels, type size, wheels.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Describe","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"describe renders once and reads the geometry back as a description: regions, edges, gutters, readings.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Describe","to":"Agent","art":"the picture in numbers","kind":"data","layer":"data","out":"describes to","in":"reads","say":"An agent that cannot open the page reads the picture in numbers after every refresh.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Page","to":"Maintainer","art":"the page","kind":"data","layer":"data","out":"is read by","in":"reads","say":"The maintainer opens the page: readings, click, journeys, pan and zoom.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Check","to":"Agent","art":"the fix","kind":"data","layer":"data","out":"refuses","in":"is refused by","say":"Every failure names its fix; the agent edits until coverage is complete and the layout is clean.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"ChangeDetector","to":"Agent","art":"what moved, and when","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"delta hands back what a change did to the map, one line per thing with its fix; history hands back what moved over a year, the largest windows first with the commits that wrote them.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Check","to":"CI","art":"verdict","kind":"data","layer":"data","out":"answers","in":"asks","say":"Exit 1 fails the pull request; the message says what to run.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Skill","to":"Agent","art":"procedure","kind":"judge","layer":"judge","out":"guides","in":"follows","say":"The skill gives the agent the loop, the schema, a worked example, the second pass, and what to hand back.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Agent","to":"Model","art":"map/model.py","kind":"judge","layer":"judge","out":"writes","in":"is written by","say":"The agent writes map/model.py: the groupings, the flows, the sentences, the journeys, the invariants.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Maintainer","to":"Model","art":"corrections","kind":"judge","layer":"judge","out":"corrects","in":"is corrected by","say":"The maintainer corrects the calls they disagree with; the model is theirs once reviewed.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Model","to":"Judgement","art":"model","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The judgement reads the model for the calls that could have gone another way.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"Check","art":"the teaching under each line","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The lesson under each kind of line lives with the judgement, because that is where most kinds come from; the check reads it to say why a failing rule matters and what to do.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"Agent","art":"second-pass list","kind":"judge","layer":"judge","out":"asks","in":"answers","say":"In the second pass the agent walks every crossing import and every entry point without a journey, and changes the model or answers the line.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Judgement","to":"Maintainer","art":"judgement answers","kind":"judge","layer":"judge","out":"reports to","in":"confirms","say":"The maintainer reads the agent's answers, line by line; the list is mechanical to produce, so the review cannot be skipped.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Model","to":"SecondOpinion","art":"cards, sentences","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The model's cards, sentences, flows and invariants are what the questions ask about.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"Agent","art":"jev lines","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The agent gets a jev line where the answer disagrees with the map, to act on or answer like a judgement line; when the configuration names an agent command, it is also asked the questions whose answer is prose.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"}],"journeys":[{"id":"over-time","label":"A year of the system: what moved, and what wrote it","starts":"systemap history (subcommand)","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"Somebody asks what the last year did to the system: systemap history, since a date, one sample every so many days."},{"acts":["ChangeDetector"],"measures":[],"edge":6,"say":"The change detector picks one commit per window out of git, oldest first, so a busy fortnight and a quiet one weigh the same."},{"acts":["FactsExtractor"],"measures":[],"edge":35,"say":"The facts at each commit are extracted from the tree git holds, never from the working copy, and kept under .systemap/facts so the second run is quick."},{"acts":["ChangeDetector"],"measures":["Model"],"edge":41,"say":"Every sample is read in today's cards, so a module that moved still counts as the card whose job it does."},{"acts":["ChangeDetector"],"measures":[],"edge":56,"say":"The largest windows are printed first: the cards that grew, the imports that began crossing a boundary, and the commits that wrote the modules which appeared."}]},{"id":"plan-then-check","label":"A plan: the cards the work will touch, then what it actually touched","starts":"plan (subcommand in systemap.jev_cli)","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"Before the work, the agent or the maintainer runs systemap plan with the task in plain words."},{"acts":["SecondOpinion"],"measures":[],"edge":65,"say":"The projection reads every card's purpose out of the model, so the question is asked in the map's own vocabulary."},{"acts":["SecondOpinion"],"measures":[],"edge":25,"say":"One question goes to Jev: which component will this work most likely have to change?"},{"acts":["TypeSafe"],"measures":[],"edge":26,"say":"Jev answers with a weight for every card, and the cards above the measured cut are the projection."},{"acts":["SecondOpinion"],"measures":[],"edge":66,"say":"Around each card named, the map prints the flows, walks and rules it sits in, and the projection is written under .systemap/plans."},{"acts":["ChangeDetector"],"measures":["SecondOpinion"],"edge":35,"say":"After the work, systemap plan --check reads the facts where the work started and the facts now, and names every card that changed outside the plan."}]},{"id":"second-opinion","label":"A second opinion: systemap audit, and triage for an issue","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"With a key set and the judgement clean, the agent runs systemap audit; a maintainer with an issue in hand runs systemap triage."},{"acts":["SecondOpinion"],"measures":[],"edge":65,"say":"The second opinion reads the cards, sentences, flows and invariants, and the facts behind them, into one narrow question each."},{"acts":["SecondOpinion"],"measures":[],"edge":25,"say":"Questions the cache cannot answer go to Jev over HTTPS; audit --dry-run says what would leave the machine first."},{"acts":["TypeSafe"],"measures":[],"edge":26,"say":"Jev answers each with a probability or a choice, and every answer is cached by the model's release."},{"acts":["SecondOpinion"],"measures":["Agent"],"edge":66,"say":"A jev line where the answer disagrees with the map, or triage's three likeliest cards; the agent acts on a line or answers it under [judgement]."}]},{"id":"first-map","label":"The first map: systemap init, extract, a draft, check","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent runs systemap init: configuration, starter model, the workflow."},{"acts":["CLI"],"measures":[],"edge":4,"say":"init installs the skill directory beside the project; systemap skill reinstalls it later."},{"acts":["Skill"],"measures":[],"edge":58,"say":"The skill gives the agent the loop: extract, draft, check, judgement, render, second pass."},{"acts":["FactsExtractor"],"measures":[],"edge":5,"say":"systemap extract reads every module, its surface, its imports and the entry points out of the tree."},{"acts":["Agent"],"measures":[],"edge":59,"say":"The agent runs systemap suggest for a first grouping to argue with, then writes map/model.py: components, flows, one sentence per edge, a journey per entry point, and no positions."},{"acts":["Placer"],"measures":[],"edge":39,"say":"systemap place lays the regions out on a grid with corridors between them, puts every card on it, and writes the positions into the file."},{"acts":["Check"],"measures":["Check"],"edge":55,"say":"systemap check names each failure and its fix; the agent edits until coverage is N/N and the layout is clean."}]},{"id":"second-pass","label":"The second pass: judgement, then refresh","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent runs systemap judgement."},{"acts":["Judgement"],"measures":[],"edge":34,"say":"The judgement walks the imports in the facts for edges the model lacks, and the entry points for journeys it lacks."},{"acts":["Judgement"],"measures":["Judgement"],"edge":63,"say":"One line per crossing import, per entry point without a journey, per thin layer: the agent changes the model or answers the line."},{"acts":["Agent"],"measures":[],"edge":59,"say":"The agent adds the missed edges, regroups what was grouped by directory, and reruns check; a full pass that changes nothing is the stop."},{"acts":["Page"],"measures":[],"edge":8,"say":"systemap refresh renders the page and every configured figure; systemap describe says what the picture shows, and systemap serve opens the page for anyone who can look."},{"acts":["Judgement"],"measures":["Maintainer"],"edge":64,"say":"The agent answers the remaining judgement lines in systemap.toml, under [judgement] answered, singly or by family; judgement --strict exits 0, and the maintainer reads the answers and commits docs/map."}]},{"id":"refactor","label":"A refactor moves a module: the maintenance path","starts":"","drafted":false,"steps":[{"acts":["CI"],"measures":[],"edge":1,"say":"A pull request moves a module; the workflow runs systemap delta --base against the base branch and posts what the change did to the map as one comment."},{"acts":["ChangeDetector"],"measures":[],"edge":6,"say":"The detector reads the facts at both commits out of git, never from the working copy, and names the card that still names the old path, with the rename that fixes it."},{"acts":["Check"],"measures":["CI"],"edge":57,"say":"The job fails while a line needs a decision; the comment names each fix, so the map is maintained in the pull request that changed the code."},{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent follows the maintenance path: acts on the delta's lines alone, never redrawing the map, then runs refresh, check and judgement --strict, and commits docs/map."},{"acts":["Page"],"measures":["Maintainer"],"edge":54,"say":"The maintainer reads the page: the moved part is where the code now says it is."}]}],"regions":[{"id":"operate","label":"OPERATE","box":[250.0,80.0,380.0,204.0],"ids":["CLI","Scaffold","Config","Placer"]},{"id":"gather","label":"GATHER","box":[678.0,80.0,190.0,204.0],"ids":["FactsExtractor","ChangeDetector"]},{"id":"mean","label":"MEAN","box":[250.0,320.0,190.0,204.0],"ids":["Skill","Model"]},{"id":"draw","label":"DRAW","box":[678.0,320.0,380.0,204.0],"ids":["Router","Schematic","Page","Figures"]},{"id":"keep","label":"KEEP TRUE","box":[250.0,560.0,380.0,296.0],"ids":["Check","Judgement","SecondOpinion","Describe"]}],"rules":[{"n":1,"text":"No counts of code or tests anywhere on the page: the map explains what the system does, not how much of it there is (README, Principles).","ids":["Figures","Page","Schematic"]},{"n":2,"text":"A component is something a reader would point at and name; a module is not a part (README, Principles).","ids":["Judgement","Model","Skill"]},{"n":3,"text":"Edges carry the relationships; prose is for emphasis (README, Principles).","ids":["Model","Schematic"]},{"n":4,"text":"The map draws what exists today: every module a component names is in the facts, and nothing on the map is a plan (README, Principles).","ids":["Check","FactsExtractor","Model"]},{"n":5,"text":"Positions are fixed in the model, written once by systemap place or by hand, and the checker decides, so the same system always draws the same picture (README, Principles).","ids":["Check","Model","Placer","Router","Schematic"]},{"n":6,"text":"The agent authors, the checker refuses, the person reviews (README, Principles).","ids":["Agent","Check","Judgement","Maintainer"]},{"n":7,"text":"The map is built in passes; the second pass is the point (README, Principles).","ids":["Agent","Judgement","Skill"]},{"n":8,"text":"The page fetches nothing and depends on nothing (README, opening).","ids":["Page"]},{"n":9,"text":"An unknown configuration key is refused, never ignored (src/systemap/config.py, load: 'unknown key').","ids":["Config"]},{"n":10,"text":"Every ignored module needs a reason (tests/test_coverage.py: test_ignore_without_reason_is_a_config_error).","ids":["Check","Config"]},{"n":11,"text":"check and judgement never reach the network; asking Jev is a separate command that sends nothing without a key (src/systemap/jev_cli.py, docstring).","ids":["Check","Judgement","SecondOpinion"]}],"kinds":["judge"],"states":{"built":20},"evidence":{"observed":51,"external":15,"declared":1},"collisions":[],"notes":[],"headers":[{"id":"outside","kind":"container","box":[24,22,152.4,54]},{"id":"systemap","kind":"container","box":[238,22,360.8,42]},{"id":"operate","kind":"region","box":[256,85,150.0,24]},{"id":"gather","kind":"region","box":[684,85,150.0,24]},{"id":"mean","kind":"region","box":[256,325,150.0,24]},{"id":"draw","kind":"region","box":[684,325,150.0,24]},{"id":"keep","kind":"region","box":[256,565,150.0,24]}]}};
 var PAL = {"ink": "var(--ink)"};
 var svg = document.getElementById("schematic");
 var panel = document.getElementById("panel");
diff --git a/docs/map/map.json b/docs/map/map.json
index 81d1a454..6bc30df5 100644
--- a/docs/map/map.json
+++ b/docs/map/map.json
@@ -1,19 +1,19 @@
 {
-"built_at_commit":"10b4b6c232a746dec04b29a909050ea7fecb8f0d",
+"built_at_commit":"83aabb818069b62c3cce16dea34dcb3d4a0ebda7",
 "components":{
 "systemap":{"classes":[],"constants":[],"docstring":"systemap: the map your coding agent draws of your system.","errors":[],"external":[],"file":"src/systemap/__init__.py","functions":[],"id":"systemap","imported_by":["systemap.cli","systemap.scaffold"],"imports":["systemap.model"],"loc":48,"names":[{"kind":"constant","name":"AGENT_KINDS","reexport_of":"systemap.model"},{"kind":"constant","name":"KINDS","reexport_of":"systemap.model"},{"kind":"constant","name":"STANDARD_KINDS","reexport_of":"systemap.model"},{"kind":"class","name":"Component","reexport_of":"systemap.model"},{"kind":"class","name":"Container","reexport_of":"systemap.model"},{"kind":"class","name":"Flow","reexport_of":"systemap.model"},{"kind":"class","name":"Invariant","reexport_of":"systemap.model"},{"kind":"class","name":"Journey","reexport_of":"systemap.model"},{"kind":"class","name":"Layer","reexport_of":"systemap.model"},{"kind":"class","name":"Meaning","reexport_of":"systemap.model"},{"kind":"class","name":"Model","reexport_of":"systemap.model"},{"kind":"class","name":"Region","reexport_of":"systemap.model"},{"kind":"class","name":"Step","reexport_of":"systemap.model"},{"kind":"function","name":"all_layers","reexport_of":"systemap.model"},{"kind":"function","name":"build_state","reexport_of":"systemap.model"}],"package":"systemap","plane":"core","sha":"8aa181586acb","tests":["test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_extract_on_tiny_package_via_cli","test_figure_command","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_marketplace_points_at_the_repository_root","test_plugin_manifest_version_is_the_package_version","test_plugin_skill_tree_is_identical_to_the_package_skill_tree","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_skill_front_matter_fits_the_plugin_limits","test_skill_is_a_directory_of_named_references","test_stale_after_code_change"],"tests_primary":0,"tests_total":18,"uses":{"systemap.model":["AGENT_KINDS","Component","Container","Flow","Invariant","Journey","KINDS","Layer","Meaning","Model","Region","STANDARD_KINDS","Step","all_layers","build_state"]}},
 "systemap.__main__":{"classes":[],"constants":[],"docstring":"","errors":[],"external":[],"file":"src/systemap/__main__.py","functions":[],"id":"systemap.__main__","imported_by":[],"imports":["systemap.cli"],"loc":6,"names":[],"package":"systemap","plane":"core","sha":"0e1e6e0c4977","tests":[],"tests_primary":0,"tests_total":0,"uses":{"systemap.cli":["main"]}},
 "systemap.agent":{"classes":[{"methods":["def line(self) -> str"],"name":"Usage"},{"methods":["def ask(self, question: str, context: Any=None) -> str"],"name":"Agent"}],"constants":[{"name":"TIMEOUT","value":"300.0"},{"name":"OUTPUT_CAP","value":"200000"},{"name":"NO_AGENT","value":"'no agent is set, so this is the structure without the prose. Name one under [ag"}],"docstring":"The one door to a coding agent: a question and the structure, prose back.","errors":[{"methods":[],"name":"AgentError"}],"external":[],"file":"src/systemap/agent.py","functions":[{"name":"cache_key","signature":"def cache_key(command: str, question: str, context: Any) -> str"},{"name":"shell_run","signature":"def shell_run(command: str, question: str, cwd: Path, timeout: float) -> str"},{"name":"from_cfg","signature":"def from_cfg(cfg: Config, run_command: Run | None=None) -> Agent"},{"name":"has_agent","signature":"def has_agent(cfg: Config) -> bool"}],"id":"systemap.agent","imported_by":["systemap.jev_cli","systemap.journeys"],"imports":["systemap.config","systemap.jev"],"loc":158,"names":[{"kind":"constant","name":"TIMEOUT"},{"kind":"constant","name":"OUTPUT_CAP"},{"kind":"constant","name":"NO_AGENT"},{"kind":"error","name":"AgentError"},{"kind":"function","name":"cache_key"},{"kind":"class","name":"Usage"},{"kind":"object","name":"Run"},{"kind":"function","name":"shell_run"},{"kind":"class","name":"Agent"},{"kind":"function","name":"from_cfg"},{"kind":"function","name":"has_agent"}],"package":"systemap","plane":"core","sha":"694b69e9fd9a","tests":["test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_describe_and_judgement_agree_that_a_crowd_is_walked","test_describe_names_the_steps_the_code_does_not_back","test_describe_says_where_each_walk_starts_and_how_many_ways_in_are_walked","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_the_agent_is_asked_once_and_remembered","test_the_agent_is_shown_the_crowd_and_a_sample_of_it"],"tests_primary":0,"tests_total":35,"uses":{"systemap.config":["Config"],"systemap.jev":["Cache"]}},
 "systemap.audit":{"classes":[{"methods":[],"name":"Line"},{"methods":["def add(self, key: str, state: Any, questions: dict[str, Any], read: Any) -> None"],"name":"Plan"}],"constants":[{"name":"MISFOLD_BELOW","value":"0.05"},{"name":"OWNER_AT","value":"0.9"},{"name":"SENTENCE_BELOW","value":"0.2"},{"name":"FLOW_BELOW","value":"0.2"},{"name":"GOVERNS_AT","value":"0.8"},{"name":"QUESTION_OF","value":"{'jev mis-fold': 'owner', 'jev owner': 'owner', 'jev sentence': 'sentence', 'jev"},{"name":"DEFAULT_KINDS","value":"tuple((k for k in QUESTION_OF if k != 'jev flow'))"},{"name":"KINDS","value":"AUDIT_KINDS"},{"name":"NONE","value":"'none of these'"},{"name":"OWNER_Q","value":"'Which component of this system does `module` belong to? Each option is one part"},{"name":"DESCRIBES_Q","value":"'Does `sentence` accurately describe what the code in `modules` does, taken toge"},{"name":"VERIFY_Q","value":"'Does the code in `code` support the claim in `claim`: that `claim.from` passes "},{"name":"GOVERNS_Q","value":"'Does `rule` directly govern `component`: is it one of the parts whose code must"},{"name":"READERS","value":"{'owner': owner_line, 'sentence': sentence_line, 'flow': flow_line, 'governs': g"}],"docstring":"`systemap audit`: a second opinion from Jev on the calls the map makes.","errors":[],"external":[],"file":"src/systemap/audit.py","functions":[{"name":"module_state","signature":"def module_state(facts: dict[str, Any], m: str, doc_cap: int=600, names_cap: int=40) -> dict[str, Any]"},{"name":"card_brief","signature":"def card_brief(model: Model, meaning: Meaning, cid: str) -> str"},{"name":"owner_criteria","signature":"def owner_criteria(model: Model, meaning: Meaning) -> dict[str, str]"},{"name":"owner_question","signature":"def owner_question(model: Model, meaning: Meaning) -> dict[str, Any]"},{"name":"lines_using","signature":"def lines_using(root: Path, facts: dict[str, Any], module: str, names: set[str]) -> list[str]"},{"name":"code_between","signature":"def code_between(root: Path, facts: dict[str, Any], mods: dict[str, list[str]], src: str, dst: str) -> list[str]"},{"name":"modules_by_card","signature":"def modules_by_card(model: Model, facts: dict[str, Any]) -> dict[str, list[str]]"},{"name":"unclaimed","signature":"def unclaimed(model: Model, facts: dict[str, Any], ignores: Iterable[str]) -> list[str]"},{"name":"plan_owner","signature":"def plan_owner(plan: Plan, m: nest.Map, facts: dict[str, Any], extra: list[str], system: str, placed_too: bool=True) -> None"},{"name":"plan_sentences","signature":"def plan_sentences(plan: Plan, m: nest.Map, facts: dict[str, Any]) -> None"},{"name":"plan_flows","signature":"def plan_flows(plan: Plan, m: nest.Map, facts: dict[str, Any], root: Path) -> None"},{"name":"plan_governs","signature":"def plan_governs(plan: Plan, m: nest.Map) -> None"},{"name":"make_plan","signature":"def make_plan(tree: nest.Tree, facts: dict[str, Any], cfg: Config, kinds: Iterable[str]=DEFAULT_KINDS) -> Plan"},{"name":"owner_line","signature":"def owner_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"sentence_line","signature":"def sentence_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"flow_line","signature":"def flow_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"governs_line","signature":"def governs_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"lines","signature":"def lines(plan: Plan, answered: dict[str, Answers]) -> list[Line]"},{"name":"run","signature":"def run(tree: nest.Tree, facts: dict[str, Any], cfg: Config, jev: Jev, kinds: Iterable[str]=DEFAULT_KINDS) -> list[Line]"},{"name":"is_audit_answer","signature":"def is_audit_answer(answer: Answer) -> bool"},{"name":"apply","signature":"def apply(found: list[Line], given: Iterable[Answer], kinds: Iterable[str]=DEFAULT_KINDS) -> tuple[list[Line], int, list[str]]"},{"name":"report","signature":"def report(open_lines: list[Line], answered: int, stale: list[str], usage: str, teach: bool=True) -> list[str]"},{"name":"dry_run","signature":"def dry_run(plan: Plan, pending: int | None) -> list[str]"}],"id":"systemap.audit","imported_by":["systemap.cli","systemap.jev_cli"],"imports":["systemap.config","systemap.evidence","systemap.explain","systemap.extract","systemap.jev","systemap.model","systemap.nest"],"loc":485,"names":[{"kind":"constant","name":"MISFOLD_BELOW"},{"kind":"constant","name":"OWNER_AT"},{"kind":"constant","name":"SENTENCE_BELOW"},{"kind":"constant","name":"FLOW_BELOW"},{"kind":"constant","name":"GOVERNS_AT"},{"kind":"constant","name":"QUESTION_OF"},{"kind":"constant","name":"DEFAULT_KINDS"},{"kind":"constant","name":"KINDS"},{"kind":"constant","name":"NONE"},{"kind":"constant","name":"OWNER_Q"},{"kind":"constant","name":"DESCRIBES_Q"},{"kind":"constant","name":"VERIFY_Q"},{"kind":"constant","name":"GOVERNS_Q"},{"kind":"class","name":"Line"},{"kind":"class","name":"Plan"},{"kind":"function","name":"module_state"},{"kind":"function","name":"card_brief"},{"kind":"function","name":"owner_criteria"},{"kind":"function","name":"owner_question"},{"kind":"function","name":"lines_using"},{"kind":"function","name":"code_between"},{"kind":"function","name":"modules_by_card"},{"kind":"function","name":"unclaimed"},{"kind":"function","name":"plan_owner"},{"kind":"function","name":"plan_sentences"},{"kind":"function","name":"plan_flows"},{"kind":"function","name":"plan_governs"},{"kind":"function","name":"make_plan"},{"kind":"function","name":"owner_line"},{"kind":"function","name":"sentence_line"},{"kind":"function","name":"flow_line"},{"kind":"function","name":"governs_line"},{"kind":"constant","name":"READERS"},{"kind":"function","name":"lines"},{"kind":"function","name":"run"},{"kind":"function","name":"is_audit_answer"},{"kind":"function","name":"apply"},{"kind":"function","name":"report"},{"kind":"function","name":"dry_run"}],"package":"systemap","plane":"core","sha":"7cc232fdf760","tests":["test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_an_answer_about_a_kind_not_asked_is_not_stale","test_apply_suppresses_answered_lines_and_reports_stale_answers","test_audit_answers_are_told_apart_from_judgement_answers","test_audit_cli_end_to_end_over_http","test_audit_dry_run_sends_no_question","test_audit_on_recorded_answers","test_audit_without_a_key_says_so_and_exits_1","test_by_default_the_flow_question_is_not_asked","test_cache_answers_a_second_run_and_a_new_release_invalidates_it","test_config_accepts_audit_kinds_and_a_jev_table","test_delta_asks_only_about_the_unclaimed_modules","test_flow_state_holds_the_lines_where_the_two_cards_meet","test_groups_are_connected_components_largest_first","test_judgement_ignores_audit_answers","test_misfold_fires_below_the_threshold_only","test_no_key_sends_nothing","test_pair_candidates_chain_each_package_and_add_imports","test_plan_asks_one_question_per_module_card_flow_and_invariant_pair","test_recordings_hold_real_responses","test_retries_then_succeeds_or_raises_with_the_status","test_sentence_flow_and_governs_thresholds","test_triage_names_the_cards_with_their_modules","test_unclaimed_module_gets_one_card_when_confident_else_three","test_unclaimed_modules_are_asked_about_on_the_top_map"],"tests_primary":26,"tests_total":26,"uses":{"systemap.config":["AUDIT_KINDS","Answer","Config"],"systemap.evidence":["owners"],"systemap.explain":["*"],"systemap.extract":["is_empty_marker"],"systemap.jev":["Answers","Ask","Jev"],"systemap.model":["Meaning","Model","module_matches"],"systemap.nest":["*"]}},
-"systemap.change":{"classes":[],"constants":[{"name":"BUCKETS","value":"('operations', 'types', 'refusals', 'constants')"}],"docstring":"Work out what a branch changes about the system, in logical terms.","errors":[],"external":[],"file":"src/systemap/change.py","functions":[{"name":"pr_meta","signature":"def pr_meta(repo: Path, pr: str) -> dict[str, Any]"},{"name":"surface_delta","signature":"def surface_delta(base_raw: str, head_raw: str) -> dict[str, Any] | None"},{"name":"compute","signature":"def compute(cfg: Config, model: Model, base: str, facts: dict[str, Any], head: str='HEAD', artifact_owner: dict[str, str] | None=None) -> dict[str, Any]"}],"id":"systemap.change","imported_by":["systemap.cli","systemap.figure"],"imports":["systemap.config","systemap.extract","systemap.model"],"loc":328,"names":[{"kind":"constant","name":"BUCKETS"},{"kind":"function","name":"pr_meta"},{"kind":"function","name":"surface_delta"},{"kind":"function","name":"compute"}],"package":"systemap","plane":"core","sha":"72c00f38b1a9","tests":[],"tests_primary":0,"tests_total":0,"uses":{"systemap.config":["Config"],"systemap.extract":["WHOLE_MODULE","internal_uses","module_of","parse_surface","test_names"],"systemap.model":["Model","module_matches"]}},
+"systemap.change":{"classes":[],"constants":[{"name":"BUCKETS","value":"('operations', 'types', 'refusals', 'constants')"}],"docstring":"Work out what a branch changes about the system, in logical terms.","errors":[],"external":[],"file":"src/systemap/change.py","functions":[{"name":"pr_meta","signature":"def pr_meta(repo: Path, pr: str) -> dict[str, Any]"},{"name":"surface_delta","signature":"def surface_delta(base_raw: str, head_raw: str, language: LanguageAdapter=extract.PYTHON, path: str='') -> dict[str, Any] | None"},{"name":"compute","signature":"def compute(cfg: Config, model: Model, base: str, facts: dict[str, Any], head: str='HEAD', artifact_owner: dict[str, str] | None=None) -> dict[str, Any]"}],"id":"systemap.change","imported_by":["systemap.cli","systemap.figure"],"imports":["systemap.config","systemap.extract","systemap.language","systemap.model"],"loc":310,"names":[{"kind":"constant","name":"BUCKETS"},{"kind":"function","name":"pr_meta"},{"kind":"function","name":"surface_delta"},{"kind":"function","name":"compute"}],"package":"systemap","plane":"core","sha":"c62b889f4c61","tests":["test_init_detects_a_typescript_repository","test_typescript_extracts_surface_imports_tests_and_entry_points","test_typescript_roots_are_discovered_from_package_metadata","test_typescript_surface_and_change_use_the_same_parser","test_typescript_test_names_are_literal_and_nested"],"tests_primary":0,"tests_total":5,"uses":{"systemap.config":["Config"],"systemap.extract":["*"],"systemap.language":["LanguageAdapter"],"systemap.model":["Model","module_matches"]}},
 "systemap.check":{"classes":[{"methods":["def ok(self) -> bool"],"name":"Coverage"},{"methods":["def ok(self) -> bool"],"name":"Result"}],"constants":[{"name":"MONO_CHAR_W","value":"6.6"},{"name":"NAME_LINE_H","value":"13.0"},{"name":"NOT_COUNTED","value":"Coverage(True, 0, 0, 0, (), counted=False)"},{"name":"ENTRY_OPTIONAL","value":"('store', 'context')"},{"name":"INTERFACE_HEAD","value":"re.compile('\\\\s*([A-Za-z_][A-Za-z0-9_]*)(?:\\\\.([A-Za-z_][A-Za-z0-9_]*))?')"}],"docstring":"Check the map geometry and the meaning tables mechanically.","errors":[],"external":[],"file":"src/systemap/check.py","functions":[{"name":"check_labels","signature":"def check_labels(meta: dict[str, Any]) -> list[str]"},{"name":"check_routes","signature":"def check_routes(meta: dict[str, Any], model: Model) -> tuple[list[str], int, int]"},{"name":"check_type_size","signature":"def check_type_size(svg: str) -> list[str]"},{"name":"wrap_name","signature":"def wrap_name(cid: str) -> list[str]"},{"name":"wheel_boxes","signature":"def wheel_boxes(cid: str, edges: list[dict[str, str]], layers: tuple[Layer, ...]) -> tuple[Box, list[tuple[str, Box]]]"},{"name":"check_wheels","signature":"def check_wheels(edges: list[dict[str, str]], model: Model, meaning: Meaning) -> list[str]"},{"name":"check_coverage","signature":"def check_coverage(model: Model, facts: dict[str, Any], ignores: Iterable[Ignore]) -> Coverage"},{"name":"check_nesting","signature":"def check_nesting(parent: Model, card: Component, sub: Model, facts: dict[str, Any], sub_label: str) -> list[str]"},{"name":"check_entry","signature":"def check_entry(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"interface_head","signature":"def interface_head(text: str) -> tuple[str, str] | None"},{"name":"method_names","signature":"def method_names(record: Mapping[str, Any], class_name: str) -> set[str]"},{"name":"check_interface","signature":"def check_interface(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"interface_problem","signature":"def interface_problem(c: Component, components: Mapping[str, Any]) -> str"},{"name":"stale_facts","signature":"def stale_facts(fresh: dict[str, Any], stored: dict[str, Any], model: Model, prefixes: set[str]) -> list[str]"},{"name":"stale","signature":"def stale(cfg: Config, tree: nest.Tree, fresh: dict[str, Any] | None=None) -> list[str]"},{"name":"run","signature":"def run(model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], ignores: Iterable[Ignore]=(), observed_by: Iterable[str]=(), *, coverage: bool=True) -> Result"},{"name":"run_tree","signature":"def run_tree(tree: nest.Tree, facts: dict[str, Any], ignores: Iterable[Ignore]=(), observed_by: Iterable[str]=()) -> dict[str, Result]"},{"name":"tree_ok","signature":"def tree_ok(results: Mapping[str, Result]) -> bool"},{"name":"with_stale","signature":"def with_stale(result: Result, lines: list[str]) -> Result"},{"name":"coverage_line","signature":"def coverage_line(cov: Coverage) -> str"},{"name":"report","signature":"def report(model: Model, result: Result, model_file: str='the model', prefix: str='', teach: bool=True) -> list[str]"},{"name":"report_stale","signature":"def report_stale(lines: list[str], teach: bool=True) -> list[str]"}],"id":"systemap.check","imported_by":["systemap.cli","systemap.delta"],"imports":["systemap.config","systemap.explain","systemap.extract","systemap.figure","systemap.model","systemap.nest","systemap.page","systemap.schematic"],"loc":895,"names":[{"kind":"object","name":"Box"},{"kind":"function","name":"check_labels"},{"kind":"function","name":"check_routes"},{"kind":"function","name":"check_type_size"},{"kind":"constant","name":"MONO_CHAR_W"},{"kind":"constant","name":"NAME_LINE_H"},{"kind":"function","name":"wrap_name"},{"kind":"function","name":"wheel_boxes"},{"kind":"function","name":"check_wheels"},{"kind":"class","name":"Coverage"},{"kind":"function","name":"check_coverage"},{"kind":"constant","name":"NOT_COUNTED"},{"kind":"function","name":"check_nesting"},{"kind":"constant","name":"ENTRY_OPTIONAL"},{"kind":"function","name":"check_entry"},{"kind":"constant","name":"INTERFACE_HEAD"},{"kind":"function","name":"interface_head"},{"kind":"function","name":"method_names"},{"kind":"function","name":"check_interface"},{"kind":"function","name":"interface_problem"},{"kind":"function","name":"stale_facts"},{"kind":"function","name":"stale"},{"kind":"class","name":"Result"},{"kind":"function","name":"run"},{"kind":"function","name":"run_tree"},{"kind":"function","name":"tree_ok"},{"kind":"function","name":"with_stale"},{"kind":"function","name":"coverage_line"},{"kind":"function","name":"report"},{"kind":"function","name":"report_stale"}],"package":"systemap","plane":"core","sha":"cf82e3eb652e","tests":["test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_full_gutter_names_its_seats_and_the_fix","test_a_json_answer_is_unwrapped","test_a_label_collision_names_both_labels","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_lesson_prints_as_two_rows_under_the_line","test_a_package_init_records_the_names_it_reexports","test_a_positioned_card_stays_where_it_was","test_a_symbol_card_needs_an_entry_among_its_symbols","test_a_symbol_claim_counts_as_a_defined_name","test_a_symbol_claim_passes_and_counts_for_no_module","test_a_symbol_of_a_module_nobody_claims_is_refused","test_a_symbol_the_module_does_not_define_is_refused","test_actor_claims_no_code_and_is_not_checked","test_agent_kinds_are_cards_that_claim_code","test_agent_layers_appear_only_with_an_agent","test_agent_model_checks_clean_and_draws_the_marks","test_an_interface_edit_renders_and_refresh_says_what_current_means","test_calls_model_in_the_model_module","test_card_text_budgets_by_kind","test_check_passes_on_sample"],"tests_primary":0,"tests_total":99,"uses":{"systemap.config":["Config","Ignore"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.figure":["*"],"systemap.model":["Component","Layer","Meaning","Model","all_layers","claimed","defines_entry","is_symbol","module_matches","problems","public_names","symbol_claims"],"systemap.nest":["*"],"systemap.page":["*"],"systemap.schematic":["TEXT_PX","render"]}},
-"systemap.cli":{"classes":[{"methods":["def model(self) -> Model","def meaning(self) -> Meaning","def theme(self) -> dict[str, Any]"],"name":"Project"}],"constants":[{"name":"AGENT_SENTENCE","value":"'Map this repository with systemap. Follow the systemap skill.'"},{"name":"MAINTENANCE_SENTENCE","value":"\"The code changed. Update the map with systemap: follow the systemap skill's mai"},{"name":"NO_COMPONENTS","value":"'the model has no components yet; see the skill'"},{"name":"ALREADY_CURRENT","value":"\"map: already current: the page matches the model's rendered fields and the fact"},{"name":"DEFAULT_PORT","value":"8765"}],"docstring":"The `systemap` command: what the agent runs.","errors":[],"external":[],"file":"src/systemap/cli.py","functions":[{"name":"say","signature":"def say(*lines: str) -> None"},{"name":"warn","signature":"def warn(*lines: str) -> None"},{"name":"cmd_init","signature":"def cmd_init(args: argparse.Namespace) -> int"},{"name":"cmd_extract","signature":"def cmd_extract(args: argparse.Namespace) -> int"},{"name":"cmd_facts","signature":"def cmd_facts(args: argparse.Namespace) -> int"},{"name":"cmd_render","signature":"def cmd_render(args: argparse.Namespace) -> int"},{"name":"cmd_check","signature":"def cmd_check(args: argparse.Namespace) -> int"},{"name":"cmd_figure","signature":"def cmd_figure(args: argparse.Namespace) -> int"},{"name":"cmd_refresh","signature":"def cmd_refresh(args: argparse.Namespace) -> int"},{"name":"cmd_judgement","signature":"def cmd_judgement(args: argparse.Namespace) -> int"},{"name":"cmd_delta","signature":"def cmd_delta(args: argparse.Namespace) -> int"},{"name":"cmd_suggest","signature":"def cmd_suggest(args: argparse.Namespace) -> int"},{"name":"cmd_history","signature":"def cmd_history(args: argparse.Namespace) -> int"},{"name":"cmd_explain","signature":"def cmd_explain(args: argparse.Namespace) -> int"},{"name":"cmd_describe","signature":"def cmd_describe(args: argparse.Namespace) -> int"},{"name":"cmd_place","signature":"def cmd_place(args: argparse.Namespace) -> int"},{"name":"make_server","signature":"def make_server(directory: Path, port: int) -> ThreadingHTTPServer"},{"name":"cmd_serve","signature":"def cmd_serve(args: argparse.Namespace) -> int"},{"name":"cmd_skill","signature":"def cmd_skill(args: argparse.Namespace) -> int"},{"name":"build_parser","signature":"def build_parser() -> argparse.ArgumentParser"},{"name":"main","signature":"def main(argv: list[str] | None=None) -> int"}],"id":"systemap.cli","imported_by":["systemap.__main__","systemap.jev_cli"],"imports":["systemap","systemap.audit","systemap.change","systemap.check","systemap.config","systemap.delta","systemap.describe","systemap.explain","systemap.extract","systemap.facts","systemap.figure","systemap.history","systemap.jev","systemap.jev_cli","systemap.judgement","systemap.model","systemap.nest","systemap.page","systemap.place","systemap.scaffold","systemap.skill","systemap.suggest","systemap.trend"],"loc":1207,"names":[{"kind":"class","name":"Project"},{"kind":"function","name":"say"},{"kind":"function","name":"warn"},{"kind":"constant","name":"AGENT_SENTENCE"},{"kind":"constant","name":"MAINTENANCE_SENTENCE"},{"kind":"function","name":"cmd_init"},{"kind":"function","name":"cmd_extract"},{"kind":"function","name":"cmd_facts"},{"kind":"function","name":"cmd_render"},{"kind":"constant","name":"NO_COMPONENTS"},{"kind":"function","name":"cmd_check"},{"kind":"function","name":"cmd_figure"},{"kind":"constant","name":"ALREADY_CURRENT"},{"kind":"function","name":"cmd_refresh"},{"kind":"function","name":"cmd_judgement"},{"kind":"function","name":"cmd_delta"},{"kind":"function","name":"cmd_suggest"},{"kind":"function","name":"cmd_history"},{"kind":"function","name":"cmd_explain"},{"kind":"function","name":"cmd_describe"},{"kind":"function","name":"cmd_place"},{"kind":"constant","name":"DEFAULT_PORT"},{"kind":"function","name":"make_server"},{"kind":"function","name":"cmd_serve"},{"kind":"function","name":"cmd_skill"},{"kind":"function","name":"build_parser"},{"kind":"function","name":"main"}],"package":"systemap","plane":"core","sha":"55fab5a7f62f","tests":["test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_extract_on_tiny_package_via_cli","test_figure_command","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_stale_after_code_change","test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_full_gutter_names_its_seats_and_the_fix"],"tests_primary":13,"tests_total":274,"uses":{"systemap":["__version__"],"systemap.audit":["*"],"systemap.change":["*"],"systemap.check":["*"],"systemap.config":["*"],"systemap.delta":["*"],"systemap.describe":["*"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.facts":["*"],"systemap.figure":["*"],"systemap.history":["*"],"systemap.jev":["*"],"systemap.jev_cli":["*"],"systemap.judgement":["*"],"systemap.model":["Meaning","Model","problems"],"systemap.nest":["*"],"systemap.page":["*"],"systemap.place":["*"],"systemap.scaffold":["*"],"systemap.skill":["*"],"systemap.suggest":["*"],"systemap.trend":["*"]}},
-"systemap.config":{"classes":[{"methods":[],"name":"Figure"},{"methods":[],"name":"Ignore"},{"methods":["def label(self) -> str"],"name":"Answer"},{"methods":["def model_path(self) -> Path","def out_path(self) -> Path","def jev_cache_path(self) -> Path","def agent_cache_path(self) -> Path","def facts_path(self) -> Path","def page_path(self) -> Path","def roots(self) -> list[tuple[Path, str]]","def prefixes(self) -> set[str]","def test_dirs(self) -> tuple[str, ...]","def rel(self, path: Path) -> str"],"name":"Config"}],"constants":[{"name":"CONFIG_FILE","value":"'systemap.toml'"},{"name":"SKIP_DIRS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist', 'tests', 'docs"},{"name":"SKIP_WALK","value":"SKIP_DIRS - {'tests'} | {'venv'}"},{"name":"TEST_DIR_NAMES","value":"('tests', 'test')"},{"name":"CANDIDATE_DEPTH","value":"4"},{"name":"KNOWN_KEYS","value":"{'name', 'package_roots', 'tests_dir', 'model', 'out_dir', 'facts_file', 'spec_p"},{"name":"FACTS_KEYS","value":"{'model_sdks'}"},{"name":"FLOWS_KEYS","value":"{'observed_by'}"},{"name":"JEV_KEYS","value":"{'model', 'cache', 'enabled'}"},{"name":"AGENT_KEYS","value":"{'command', 'cache', 'timeout'}"},{"name":"FIGURE_KEYS","value":"{'out', 'mode', 'components', 'caption', 'interactive', 'svg_id', 'layer', 'map'"},{"name":"COVERAGE_KEYS","value":"{'ignore'}"},{"name":"IGNORE_KEYS","value":"{'module', 'reason'}"},{"name":"JUDGEMENT_KEYS","value":"{'answered'}"}],"docstring":"Project configuration: `systemap.toml` at the repo root, or `[tool.systemap]`.","errors":[{"methods":[],"name":"ConfigError"}],"external":[],"file":"src/systemap/config.py","functions":[{"name":"find_root","signature":"def find_root(start: Path) -> Path | None"},{"name":"workspace_members","signature":"def workspace_members(root: Path) -> list[Path]"},{"name":"discover_roots","signature":"def discover_roots(root: Path) -> list[tuple[str, str]]"},{"name":"discover_tests","signature":"def discover_tests(root: Path) -> list[str]"},{"name":"candidate_packages","signature":"def candidate_packages(root: Path, depth: int=CANDIDATE_DEPTH) -> list[str]"},{"name":"default_name","signature":"def default_name(root: Path) -> str"},{"name":"read_raw","signature":"def read_raw(root: Path) -> tuple[dict[str, Any], str]"},{"name":"load","signature":"def load(root: Path) -> Config"},{"name":"load_model","signature":"def load_model(path: Path, label: str='') -> tuple[Model, Meaning]"}],"id":"systemap.config","imported_by":["systemap.agent","systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.extract","systemap.figure","systemap.history","systemap.jev_cli","systemap.judgement","systemap.nest","systemap.page","systemap.plan","systemap.trend"],"imports":["systemap.model"],"loc":800,"names":[{"kind":"constant","name":"CONFIG_FILE"},{"kind":"constant","name":"SKIP_DIRS"},{"kind":"constant","name":"SKIP_WALK"},{"kind":"constant","name":"TEST_DIR_NAMES"},{"kind":"constant","name":"CANDIDATE_DEPTH"},{"kind":"constant","name":"KNOWN_KEYS"},{"kind":"constant","name":"FACTS_KEYS"},{"kind":"constant","name":"FLOWS_KEYS"},{"kind":"constant","name":"JEV_KEYS"},{"kind":"constant","name":"AGENT_KEYS"},{"kind":"constant","name":"FIGURE_KEYS"},{"kind":"constant","name":"COVERAGE_KEYS"},{"kind":"constant","name":"IGNORE_KEYS"},{"kind":"constant","name":"JUDGEMENT_KEYS"},{"kind":"constant","name":"ANSWER_FORMS"},{"kind":"constant","name":"ANSWER_KEYS"},{"kind":"constant","name":"LINE_KINDS"},{"kind":"constant","name":"AUDIT_KINDS"},{"kind":"error","name":"ConfigError"},{"kind":"class","name":"Figure"},{"kind":"class","name":"Ignore"},{"kind":"class","name":"Answer"},{"kind":"class","name":"Config"},{"kind":"function","name":"find_root"},{"kind":"function","name":"workspace_members"},{"kind":"function","name":"discover_roots"},{"kind":"function","name":"discover_tests"},{"kind":"function","name":"candidate_packages"},{"kind":"function","name":"default_name"},{"kind":"function","name":"read_raw"},{"kind":"function","name":"load"},{"kind":"function","name":"load_model"}],"package":"systemap","plane":"core","sha":"db85fdca3244","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_custom_layer_may_not_take_a_standard_id","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_json_answer_is_unwrapped","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_lesson_prints_as_two_rows_under_the_line","test_a_model_may_import_a_module_beside_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_a_package_init_records_the_names_it_reexports","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_positioned_card_stays_where_it_was"],"tests_primary":0,"tests_total":209,"uses":{"systemap.model":["Meaning","Model"]}},
+"systemap.cli":{"classes":[{"methods":["def model(self) -> Model","def meaning(self) -> Meaning","def theme(self) -> dict[str, Any]"],"name":"Project"}],"constants":[{"name":"AGENT_SENTENCE","value":"'Map this repository with systemap. Follow the systemap skill.'"},{"name":"MAINTENANCE_SENTENCE","value":"\"The code changed. Update the map with systemap: follow the systemap skill's mai"},{"name":"NO_COMPONENTS","value":"'the model has no components yet; see the skill'"},{"name":"ALREADY_CURRENT","value":"\"map: already current: the page matches the model's rendered fields and the fact"},{"name":"DEFAULT_PORT","value":"8765"}],"docstring":"The `systemap` command: what the agent runs.","errors":[],"external":[],"file":"src/systemap/cli.py","functions":[{"name":"say","signature":"def say(*lines: str) -> None"},{"name":"warn","signature":"def warn(*lines: str) -> None"},{"name":"cmd_init","signature":"def cmd_init(args: argparse.Namespace) -> int"},{"name":"cmd_extract","signature":"def cmd_extract(args: argparse.Namespace) -> int"},{"name":"cmd_facts","signature":"def cmd_facts(args: argparse.Namespace) -> int"},{"name":"cmd_render","signature":"def cmd_render(args: argparse.Namespace) -> int"},{"name":"cmd_check","signature":"def cmd_check(args: argparse.Namespace) -> int"},{"name":"cmd_figure","signature":"def cmd_figure(args: argparse.Namespace) -> int"},{"name":"cmd_refresh","signature":"def cmd_refresh(args: argparse.Namespace) -> int"},{"name":"cmd_judgement","signature":"def cmd_judgement(args: argparse.Namespace) -> int"},{"name":"cmd_delta","signature":"def cmd_delta(args: argparse.Namespace) -> int"},{"name":"cmd_suggest","signature":"def cmd_suggest(args: argparse.Namespace) -> int"},{"name":"cmd_history","signature":"def cmd_history(args: argparse.Namespace) -> int"},{"name":"cmd_explain","signature":"def cmd_explain(args: argparse.Namespace) -> int"},{"name":"cmd_describe","signature":"def cmd_describe(args: argparse.Namespace) -> int"},{"name":"cmd_place","signature":"def cmd_place(args: argparse.Namespace) -> int"},{"name":"make_server","signature":"def make_server(directory: Path, port: int) -> ThreadingHTTPServer"},{"name":"cmd_serve","signature":"def cmd_serve(args: argparse.Namespace) -> int"},{"name":"cmd_skill","signature":"def cmd_skill(args: argparse.Namespace) -> int"},{"name":"build_parser","signature":"def build_parser() -> argparse.ArgumentParser"},{"name":"main","signature":"def main(argv: list[str] | None=None) -> int"}],"id":"systemap.cli","imported_by":["systemap.__main__","systemap.jev_cli"],"imports":["systemap","systemap.audit","systemap.change","systemap.check","systemap.config","systemap.delta","systemap.describe","systemap.explain","systemap.extract","systemap.facts","systemap.figure","systemap.history","systemap.jev","systemap.jev_cli","systemap.judgement","systemap.model","systemap.nest","systemap.page","systemap.place","systemap.scaffold","systemap.skill","systemap.suggest","systemap.trend"],"loc":1215,"names":[{"kind":"class","name":"Project"},{"kind":"function","name":"say"},{"kind":"function","name":"warn"},{"kind":"constant","name":"AGENT_SENTENCE"},{"kind":"constant","name":"MAINTENANCE_SENTENCE"},{"kind":"function","name":"cmd_init"},{"kind":"function","name":"cmd_extract"},{"kind":"function","name":"cmd_facts"},{"kind":"function","name":"cmd_render"},{"kind":"constant","name":"NO_COMPONENTS"},{"kind":"function","name":"cmd_check"},{"kind":"function","name":"cmd_figure"},{"kind":"constant","name":"ALREADY_CURRENT"},{"kind":"function","name":"cmd_refresh"},{"kind":"function","name":"cmd_judgement"},{"kind":"function","name":"cmd_delta"},{"kind":"function","name":"cmd_suggest"},{"kind":"function","name":"cmd_history"},{"kind":"function","name":"cmd_explain"},{"kind":"function","name":"cmd_describe"},{"kind":"function","name":"cmd_place"},{"kind":"constant","name":"DEFAULT_PORT"},{"kind":"function","name":"make_server"},{"kind":"function","name":"cmd_serve"},{"kind":"function","name":"cmd_skill"},{"kind":"function","name":"build_parser"},{"kind":"function","name":"main"}],"package":"systemap","plane":"core","sha":"585e7e7b3b32","tests":["test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_extract_on_tiny_package_via_cli","test_figure_command","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_stale_after_code_change","test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_full_gutter_names_its_seats_and_the_fix"],"tests_primary":13,"tests_total":281,"uses":{"systemap":["__version__"],"systemap.audit":["*"],"systemap.change":["*"],"systemap.check":["*"],"systemap.config":["*"],"systemap.delta":["*"],"systemap.describe":["*"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.facts":["*"],"systemap.figure":["*"],"systemap.history":["*"],"systemap.jev":["*"],"systemap.jev_cli":["*"],"systemap.judgement":["*"],"systemap.model":["Meaning","Model","problems"],"systemap.nest":["*"],"systemap.page":["*"],"systemap.place":["*"],"systemap.scaffold":["*"],"systemap.skill":["*"],"systemap.suggest":["*"],"systemap.trend":["*"]}},
+"systemap.config":{"classes":[{"methods":[],"name":"Figure"},{"methods":[],"name":"Ignore"},{"methods":["def label(self) -> str"],"name":"Answer"},{"methods":["def model_path(self) -> Path","def out_path(self) -> Path","def jev_cache_path(self) -> Path","def agent_cache_path(self) -> Path","def facts_path(self) -> Path","def page_path(self) -> Path","def roots(self) -> list[tuple[Path, str]]","def prefixes(self) -> set[str]","def test_dirs(self) -> tuple[str, ...]","def rel(self, path: Path) -> str"],"name":"Config"}],"constants":[{"name":"CONFIG_FILE","value":"'systemap.toml'"},{"name":"SKIP_DIRS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist', 'tests', 'docs"},{"name":"SKIP_WALK","value":"SKIP_DIRS - {'tests'} | {'venv'}"},{"name":"TEST_DIR_NAMES","value":"('tests', 'test')"},{"name":"CANDIDATE_DEPTH","value":"4"},{"name":"KNOWN_KEYS","value":"{'language', 'name', 'package_roots', 'tests_dir', 'model', 'out_dir', 'facts_fi"},{"name":"FACTS_KEYS","value":"{'model_sdks'}"},{"name":"FLOWS_KEYS","value":"{'observed_by'}"},{"name":"JEV_KEYS","value":"{'model', 'cache', 'enabled'}"},{"name":"AGENT_KEYS","value":"{'command', 'cache', 'timeout'}"},{"name":"FIGURE_KEYS","value":"{'out', 'mode', 'components', 'caption', 'interactive', 'svg_id', 'layer', 'map'"},{"name":"COVERAGE_KEYS","value":"{'ignore'}"},{"name":"IGNORE_KEYS","value":"{'module', 'reason'}"},{"name":"JUDGEMENT_KEYS","value":"{'answered'}"}],"docstring":"Project configuration: `systemap.toml` at the repo root, or `[tool.systemap]`.","errors":[{"methods":[],"name":"ConfigError"}],"external":[],"file":"src/systemap/config.py","functions":[{"name":"find_root","signature":"def find_root(start: Path) -> Path | None"},{"name":"discover_typescript_roots","signature":"def discover_typescript_roots(root: Path) -> list[tuple[str, str]]"},{"name":"workspace_members","signature":"def workspace_members(root: Path) -> list[Path]"},{"name":"discover_roots","signature":"def discover_roots(root: Path) -> list[tuple[str, str]]"},{"name":"discover_tests","signature":"def discover_tests(root: Path) -> list[str]"},{"name":"candidate_packages","signature":"def candidate_packages(root: Path, depth: int=CANDIDATE_DEPTH) -> list[str]"},{"name":"default_name","signature":"def default_name(root: Path) -> str"},{"name":"read_raw","signature":"def read_raw(root: Path) -> tuple[dict[str, Any], str]"},{"name":"load","signature":"def load(root: Path) -> Config"},{"name":"load_model","signature":"def load_model(path: Path, label: str='') -> tuple[Model, Meaning]"}],"id":"systemap.config","imported_by":["systemap.agent","systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.extract","systemap.figure","systemap.history","systemap.jev_cli","systemap.judgement","systemap.nest","systemap.page","systemap.plan","systemap.trend"],"imports":["systemap.model"],"loc":837,"names":[{"kind":"constant","name":"CONFIG_FILE"},{"kind":"constant","name":"SKIP_DIRS"},{"kind":"constant","name":"SKIP_WALK"},{"kind":"constant","name":"TEST_DIR_NAMES"},{"kind":"constant","name":"CANDIDATE_DEPTH"},{"kind":"constant","name":"KNOWN_KEYS"},{"kind":"constant","name":"FACTS_KEYS"},{"kind":"constant","name":"FLOWS_KEYS"},{"kind":"constant","name":"JEV_KEYS"},{"kind":"constant","name":"AGENT_KEYS"},{"kind":"constant","name":"FIGURE_KEYS"},{"kind":"constant","name":"COVERAGE_KEYS"},{"kind":"constant","name":"IGNORE_KEYS"},{"kind":"constant","name":"JUDGEMENT_KEYS"},{"kind":"constant","name":"ANSWER_FORMS"},{"kind":"constant","name":"ANSWER_KEYS"},{"kind":"constant","name":"LINE_KINDS"},{"kind":"constant","name":"AUDIT_KINDS"},{"kind":"error","name":"ConfigError"},{"kind":"class","name":"Figure"},{"kind":"class","name":"Ignore"},{"kind":"class","name":"Answer"},{"kind":"class","name":"Config"},{"kind":"function","name":"find_root"},{"kind":"function","name":"discover_typescript_roots"},{"kind":"function","name":"workspace_members"},{"kind":"function","name":"discover_roots"},{"kind":"function","name":"discover_tests"},{"kind":"function","name":"candidate_packages"},{"kind":"function","name":"default_name"},{"kind":"function","name":"read_raw"},{"kind":"function","name":"load"},{"kind":"function","name":"load_model"}],"package":"systemap","plane":"core","sha":"60fced1f2967","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_custom_layer_may_not_take_a_standard_id","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_json_answer_is_unwrapped","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_lesson_prints_as_two_rows_under_the_line","test_a_model_may_import_a_module_beside_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_a_package_init_records_the_names_it_reexports","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_positioned_card_stays_where_it_was"],"tests_primary":0,"tests_total":216,"uses":{"systemap.model":["Meaning","Model"]}},
 "systemap.delta":{"classes":[{"methods":[],"name":"Line"},{"methods":["def open(self) -> list[Line]","def quiet(self) -> list[Line]","def named(self) -> list[str]","def has_change(self) -> bool","def past_a_third(self) -> bool"],"name":"Delta"}],"constants":[{"name":"KINDS","value":"('moved', 'added', 'removed', 'entry vanished', 'interface vanished', 'new cross"},{"name":"MARKER","value":"'<!-- systemap delta -->'"},{"name":"NEXT","value":"'systemap refresh && systemap check && systemap judgement --strict'"},{"name":"FULL_LOOP_SHARE","value":"1 / 3"},{"name":"FULL_LOOP","value":"'more than a third of the cards are named: the skill says to run the full loop i"}],"docstring":"What a change does to the map: `systemap delta --base REF [--head REF]`.","errors":[{"methods":[],"name":"DeltaError"}],"external":[],"file":"src/systemap/delta.py","functions":[{"name":"resolve","signature":"def resolve(repo: Path, ref: str) -> str"},{"name":"merge_base","signature":"def merge_base(repo: Path, base: str, head: str) -> str"},{"name":"facts_at","signature":"def facts_at(cfg: Config, sha: str) -> dict[str, Any]"},{"name":"remote_repository","signature":"def remote_repository(repo: Path) -> str"},{"name":"figure_url","signature":"def figure_url(cfg: Config, sha: str) -> str"},{"name":"with_claims","signature":"def with_claims(model: Model, mapping: dict[str, str]) -> Model"},{"name":"compute","signature":"def compute(cfg: Config, model: Model, meaning: Meaning, base: dict[str, Any], head: dict[str, Any], base_ref: str='', head_ref: str='', *, model_file: str='', within: str='', prefix: str='', told: Mapping[str, tuple[str, str]]=moves_mod.NO_MOVES) -> Delta"},{"name":"compute_tree","signature":"def compute_tree(cfg: Config, tree: nest.Tree, base: dict[str, Any], head: dict[str, Any], base_ref: str='', head_ref: str='', told: Mapping[str, tuple[str, str]]=moves_mod.NO_MOVES) -> Delta"},{"name":"with_claims_of","signature":"def with_claims_of(card: Component, mapping: dict[str, str]) -> Component"},{"name":"report","signature":"def report(d: Delta, teach: bool=True) -> list[str]"},{"name":"near_lines","signature":"def near_lines(d: Delta, teach: bool=True) -> list[str]"},{"name":"markdown","signature":"def markdown(d: Delta, figure: str='') -> str"}],"id":"systemap.delta","imported_by":["systemap.cli","systemap.history","systemap.jev_cli"],"imports":["systemap.check","systemap.config","systemap.evidence","systemap.explain","systemap.extract","systemap.graph","systemap.judgement","systemap.model","systemap.moves","systemap.nest"],"loc":770,"names":[{"kind":"constant","name":"KINDS"},{"kind":"constant","name":"MARKER"},{"kind":"constant","name":"NEXT"},{"kind":"constant","name":"FULL_LOOP_SHARE"},{"kind":"error","name":"DeltaError"},{"kind":"function","name":"resolve"},{"kind":"function","name":"merge_base"},{"kind":"function","name":"facts_at"},{"kind":"function","name":"remote_repository"},{"kind":"function","name":"figure_url"},{"kind":"class","name":"Line"},{"kind":"class","name":"Delta"},{"kind":"function","name":"with_claims"},{"kind":"function","name":"compute"},{"kind":"function","name":"compute_tree"},{"kind":"function","name":"with_claims_of"},{"kind":"constant","name":"FULL_LOOP"},{"kind":"function","name":"report"},{"kind":"function","name":"near_lines"},{"kind":"function","name":"markdown"}],"package":"systemap","plane":"core","sha":"2190f620e2a5","tests":["test_a_card_joined_to_a_third_of_the_map_names_none","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_every_line_kind_with_its_fix","test_markdown_is_the_comment_with_the_committed_figure","test_nothing_to_do_and_no_change_exit_zero","test_the_base_is_the_merge_base_and_the_working_copy_is_not_read","test_the_best_pairing_wins_over_the_first_free_one","test_the_cards_next_to_the_change_are_printed_as_context","test_the_context_is_in_the_pull_request_comment_once","test_the_seed_is_the_card_with_the_most_changed_modules","test_two_empty_modules_with_different_names_are_not_joined","test_unknown_ref_is_refused","test_with_claims_renames_modules_and_symbols_and_keeps_patterns","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_extract_on_tiny_package_via_cli","test_figure_command"],"tests_primary":13,"tests_total":40,"uses":{"systemap.check":["interface_head","interface_problem"],"systemap.config":["Config"],"systemap.evidence":["*"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.graph":["*"],"systemap.judgement":["answers","crossing_line","crossing_pairs"],"systemap.model":["Component","Meaning","Model","claimed","defines_entry","is_symbol","module_matches","symbol_claims"],"systemap.moves":["*"],"systemap.nest":["*"]}},
 "systemap.describe":{"classes":[],"constants":[],"docstring":"What the picture shows, in numbers, for an agent that cannot see it.","errors":[],"external":[],"file":"src/systemap/describe.py","functions":[{"name":"bends","signature":"def bends(points: list[list[float]]) -> int"},{"name":"length","signature":"def length(points: list[list[float]]) -> float"},{"name":"gutter_lines","signature":"def gutter_lines(labels: list[dict[str, Any]], paths: dict[str, list[list[float]]], bands: list[Gutter], horizontal: bool) -> list[str]"},{"name":"drawn_score","signature":"def drawn_score(meta: dict[str, Any], flows: int) -> Score"},{"name":"journey_lines","signature":"def journey_lines(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> list[str]"},{"name":"lines","signature":"def lines(model: Model, meaning: Meaning, meta: dict[str, Any], placed: Iterable[str]=(), searched: tuple[int, int] | None=None) -> list[str]"},{"name":"run","signature":"def run(model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], observed_by: Iterable[str]=(), placed: Iterable[str]=(), searched: tuple[int, int] | None=None) -> list[str]"}],"id":"systemap.describe","imported_by":["systemap.cli"],"imports":["systemap.evidence","systemap.extract","systemap.journeys","systemap.model","systemap.place","systemap.route","systemap.schematic"],"loc":324,"names":[{"kind":"object","name":"Box"},{"kind":"function","name":"bends"},{"kind":"function","name":"length"},{"kind":"function","name":"gutter_lines"},{"kind":"function","name":"drawn_score"},{"kind":"function","name":"journey_lines"},{"kind":"function","name":"lines"},{"kind":"function","name":"run"}],"package":"systemap","plane":"core","sha":"d36c25131330","tests":["test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_full_gutter_names_its_seats_and_the_fix","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_describe_and_judgement_agree_that_a_crowd_is_walked","test_describe_command","test_describe_names_the_steps_the_code_does_not_back","test_describe_reads_the_picture_back","test_describe_says_where_each_walk_starts_and_how_many_ways_in_are_walked","test_gutters_are_named_from_the_card_grid","test_layout_reference_says_what_place_does_and_what_the_agent_decides","test_starter_corridors_route_every_pair_of_regions","test_starter_is_a_2x2_grid_with_corridors","test_starter_is_ruff_formatted_at_88_and_100_columns","test_the_agent_is_shown_the_crowd_and_a_sample_of_it"],"tests_primary":0,"tests_total":31,"uses":{"systemap.evidence":["DECLARED","STATES","of_model","owners"],"systemap.extract":["entry_label"],"systemap.journeys":["*"],"systemap.model":["Edge","Journey","Meaning","Model","all_layers","reading"],"systemap.place":["Score","grid_order"],"systemap.route":["Gutter","gutters","locate","seats"],"systemap.schematic":["LABEL_H","render"]}},
 "systemap.evidence":{"classes":[{"methods":["def says(self) -> str"],"name":"Evidence"}],"constants":[{"name":"OBSERVED","value":"'observed'"},{"name":"EXTERNAL","value":"'external'"},{"name":"DECLARED","value":"'declared'"},{"name":"STATES","value":"(OBSERVED, EXTERNAL, DECLARED)"}],"docstring":"What the facts say about each flow: observed, external or declared.","errors":[],"external":[],"file":"src/systemap/evidence.py","functions":[{"name":"mentioned","signature":"def mentioned(name: str, text: str) -> bool"},{"name":"owners","signature":"def owners(model: Model, facts: dict[str, Any]) -> dict[str, str]"},{"name":"joined_by_import","signature":"def joined_by_import(model: Model, facts: dict[str, Any]) -> set[frozenset[str]]"},{"name":"sharing_a_module","signature":"def sharing_a_module(model: Model, facts: dict[str, Any]) -> set[frozenset[str]]"},{"name":"mechanism_of","signature":"def mechanism_of(flow: Flow, meaning: Meaning, observed_by: Iterable[str]) -> str"},{"name":"of_model","signature":"def of_model(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> dict[Edge, Evidence]"},{"name":"declared","signature":"def declared(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> list[Flow]"}],"id":"systemap.evidence","imported_by":["systemap.audit","systemap.delta","systemap.describe","systemap.jev_cli","systemap.journeys","systemap.judgement","systemap.schematic","systemap.trend"],"imports":["systemap.model"],"loc":157,"names":[{"kind":"constant","name":"OBSERVED"},{"kind":"constant","name":"EXTERNAL"},{"kind":"constant","name":"DECLARED"},{"kind":"constant","name":"STATES"},{"kind":"class","name":"Evidence"},{"kind":"function","name":"mentioned"},{"kind":"function","name":"owners"},{"kind":"function","name":"joined_by_import"},{"kind":"function","name":"sharing_a_module"},{"kind":"function","name":"mechanism_of"},{"kind":"function","name":"of_model"},{"kind":"function","name":"declared"}],"package":"systemap","plane":"core","sha":"56df403ae964","tests":["test_a_declared_edge_is_dashed_and_the_panel_says_so","test_flows_observed_by_in_the_configuration","test_judgement_prints_one_line_per_declared_edge","test_the_three_states_and_observed_by_a_mechanism","test_two_cards_sharing_a_module_are_observed_by_it"],"tests_primary":5,"tests_total":5,"uses":{"systemap.model":["Edge","Flow","Meaning","Model","claimed","symbol_claims"]}},
 "systemap.explain":{"classes":[{"methods":["def rows(self, indent: str=INDENT) -> list[str]"],"name":"Lesson"}],"constants":[{"name":"INDENT","value":"'      '"},{"name":"JUDGEMENT","value":"{'single module': Lesson(means='A card claims one module, so the card and the fi"},{"name":"DELTA","value":"{'moved': Lesson(means='A module is at a new path, and systemap worked out which"},{"name":"AUDIT","value":"{'jev mis-fold': Lesson(means='Jev answers that this module does the job of a di"},{"name":"CHECK","value":"{'coverage': Lesson(means='Some module is claimed by no card, or by two.', why='"},{"name":"LESSONS","value":"{**JUDGEMENT, **DELTA, **AUDIT, **CHECK}"}],"docstring":"What each line means, why it matters, and what to do: the teaching under the report.","errors":[],"external":[],"file":"src/systemap/explain.py","functions":[{"name":"lesson","signature":"def lesson(kind: str) -> Lesson | None"},{"name":"rows","signature":"def rows(kind: str, indent: str=INDENT) -> list[str]"},{"name":"whole","signature":"def whole(kind: str) -> list[str]"}],"id":"systemap.explain","imported_by":["systemap.audit","systemap.check","systemap.cli","systemap.delta","systemap.judgement"],"imports":[],"loc":392,"names":[{"kind":"constant","name":"INDENT"},{"kind":"class","name":"Lesson"},{"kind":"constant","name":"JUDGEMENT"},{"kind":"constant","name":"DELTA"},{"kind":"constant","name":"AUDIT"},{"kind":"constant","name":"CHECK"},{"kind":"constant","name":"LESSONS"},{"kind":"function","name":"lesson"},{"kind":"function","name":"rows"},{"kind":"function","name":"whole"}],"package":"systemap","plane":"core","sha":"e20224518a61","tests":["test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_the_agent_is_asked_once_and_remembered","test_the_agent_table_is_read_and_checked","test_the_walk_follows_flows_forward_and_counts_the_hops","test_the_walk_stops_at_the_depth_it_is_given","test_what_walks_through_a_flow_and_what_governs_a_card","test_without_a_command_nothing_runs_and_the_reason_is_said"],"tests_primary":0,"tests_total":14,"uses":{}},
-"systemap.extract":{"classes":[],"constants":[{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist'}"},{"name":"FORMAT","value":"2"},{"name":"TESTS_KEPT","value":"25"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"FIELDS","value":"(('facts', 'version', 'the facts format; 2, since a package `__init__` records t"},{"name":"SCOPE_TITLES","value":"{'facts': 'The file', 'module': 'Each module, under `components`', 'entry point'"},{"name":"WHOLE_MODULE","value":"'*'"}],"docstring":"Extract the derived tier of the system map from the working tree.","errors":[],"external":[],"file":"src/systemap/extract.py","functions":[{"name":"fields_of","signature":"def fields_of(scope: str) -> set[str]"},{"name":"facts_doc","signature":"def facts_doc() -> str"},{"name":"module_of","signature":"def module_of(path: Path, pkg_dir: Path, pkg_name: str) -> str"},{"name":"plane_of","signature":"def plane_of(module: str, planes: tuple[str, ...]) -> str"},{"name":"signature","signature":"def signature(node: ast.FunctionDef | ast.AsyncFunctionDef) -> str"},{"name":"opening","signature":"def opening(text: str | None) -> str"},{"name":"first_line","signature":"def first_line(text: str | None) -> str"},{"name":"sentence","signature":"def sentence(test_name: str) -> str"},{"name":"parse_surface","signature":"def parse_surface(raw: str, *, module: str='', is_package: bool=False, prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"resolve_reexports","signature":"def resolve_reexports(components: dict[str, Any]) -> None"},{"name":"collect_module","signature":"def collect_module(path: Path, repo: Path, module: str='', prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"internal_uses","signature":"def internal_uses(raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]"},{"name":"external_imports","signature":"def external_imports(raw: str, prefixes: set[str]) -> list[str]"},{"name":"internal_imports","signature":"def internal_imports(path: Path, prefixes: set[str], known: set[str]) -> set[str]"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"},{"name":"collect_tests","signature":"def collect_tests(repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], known: set[str]) -> dict[str, list[dict[str, Any]]]"},{"name":"spec_sections","signature":"def spec_sections(repo: Path, spec_path: str) -> list[dict[str, str]]"},{"name":"subcommands","signature":"def subcommands(raw: str) -> list[str]"},{"name":"console_scripts","signature":"def console_scripts(repo: Path) -> dict[str, tuple[str, str]]"},{"name":"entry_points","signature":"def entry_points(repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]"},{"name":"entry_label","signature":"def entry_label(point: dict[str, str]) -> str"},{"name":"build","signature":"def build(cfg: Config) -> dict[str, Any]"},{"name":"drift","signature":"def drift(fresh: dict[str, Any], stored: dict[str, Any]) -> list[str]"},{"name":"mapping_drift","signature":"def mapping_drift(fresh: dict[str, Any], model: Model, prefixes: set[str]) -> list[str]"},{"name":"read_facts","signature":"def read_facts(path: Path) -> dict[str, Any]"},{"name":"dumps","signature":"def dumps(facts: dict[str, Any]) -> str"},{"name":"write_facts","signature":"def write_facts(path: Path, facts: dict[str, Any]) -> None"},{"name":"is_empty_marker","signature":"def is_empty_marker(record: Mapping[str, Any]) -> bool"},{"name":"empty_markers","signature":"def empty_markers(facts: Mapping[str, Any]) -> list[str]"},{"name":"summary","signature":"def summary(facts: dict[str, Any]) -> list[str]"}],"id":"systemap.extract","imported_by":["systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.describe","systemap.facts","systemap.jev_cli","systemap.journeys","systemap.judgement","systemap.suggest"],"imports":["systemap.config","systemap.model","systemap.ways_in"],"loc":953,"names":[{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"FORMAT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"constant","name":"FIELDS"},{"kind":"constant","name":"SCOPE_TITLES"},{"kind":"function","name":"fields_of"},{"kind":"function","name":"facts_doc"},{"kind":"function","name":"module_of"},{"kind":"function","name":"plane_of"},{"kind":"function","name":"signature"},{"kind":"function","name":"opening"},{"kind":"function","name":"first_line"},{"kind":"function","name":"sentence"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"resolve_reexports"},{"kind":"function","name":"collect_module"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"function","name":"internal_uses"},{"kind":"function","name":"external_imports"},{"kind":"function","name":"internal_imports"},{"kind":"function","name":"test_names"},{"kind":"function","name":"collect_tests"},{"kind":"function","name":"spec_sections"},{"kind":"function","name":"subcommands"},{"kind":"function","name":"console_scripts"},{"kind":"function","name":"entry_points"},{"kind":"function","name":"entry_label"},{"kind":"function","name":"build"},{"kind":"function","name":"drift"},{"kind":"function","name":"mapping_drift"},{"kind":"function","name":"read_facts"},{"kind":"function","name":"dumps"},{"kind":"function","name":"write_facts"},{"kind":"function","name":"is_empty_marker"},{"kind":"function","name":"empty_markers"},{"kind":"function","name":"summary"}],"package":"systemap","plane":"core","sha":"9df5b2abc81d","tests":["test_drift_reports_changes","test_drift_sees_an_entry_point_change","test_entry_may_be_any_public_name","test_extract_attributes_tests_to_modules","test_extract_finds_modules_and_public_surface","test_extract_records_entry_points","test_extract_records_every_public_name_with_its_kind_and_the_external_imports","test_facts_fields_are_the_documented_ones","test_facts_file_is_compact_and_one_record_per_line","test_name_defaults_to_pyproject_then_the_repository_directory","test_no_roots_names_the_candidate_directories","test_spec_sections_and_planes","test_workspace_roots_and_tests_directories_are_discovered","test_zero_tests_is_said_in_one_line_naming_the_directories","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_package_init_records_the_names_it_reexports","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_sub_maps_actors_are_cards_of_the_parent"],"tests_primary":14,"tests_total":111,"uses":{"systemap.config":["Config"],"systemap.model":["Model","is_symbol","module_matches","public_names"],"systemap.ways_in":["*"]}},
+"systemap.extract":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str]) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"PythonLanguage"}],"constants":[{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist'}"},{"name":"FORMAT","value":"2"},{"name":"TESTS_KEPT","value":"25"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"PYTHON","value":"PythonLanguage()"},{"name":"FIELDS","value":"(('facts', 'version', 'the facts format; 2, since a package `__init__` records t"},{"name":"SCOPE_TITLES","value":"{'facts': 'The file', 'module': 'Each module, under `components`', 'entry point'"},{"name":"WHOLE_MODULE","value":"'*'"}],"docstring":"Extract the derived tier of the system map from the working tree.","errors":[],"external":[],"file":"src/systemap/extract.py","functions":[{"name":"language_for","signature":"def language_for(cfg: Config) -> LanguageAdapter"},{"name":"fields_of","signature":"def fields_of(scope: str) -> set[str]"},{"name":"facts_doc","signature":"def facts_doc() -> str"},{"name":"module_of","signature":"def module_of(path: Path, pkg_dir: Path, pkg_name: str) -> str"},{"name":"plane_of","signature":"def plane_of(module: str, planes: tuple[str, ...]) -> str"},{"name":"signature","signature":"def signature(node: ast.FunctionDef | ast.AsyncFunctionDef) -> str"},{"name":"opening","signature":"def opening(text: str | None) -> str"},{"name":"first_line","signature":"def first_line(text: str | None) -> str"},{"name":"sentence","signature":"def sentence(test_name: str) -> str"},{"name":"parse_surface","signature":"def parse_surface(raw: str, *, module: str='', is_package: bool=False, prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"resolve_reexports","signature":"def resolve_reexports(components: dict[str, Any]) -> None"},{"name":"collect_module","signature":"def collect_module(path: Path, repo: Path, module: str='', prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"internal_uses","signature":"def internal_uses(raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]"},{"name":"external_imports","signature":"def external_imports(raw: str, prefixes: set[str]) -> list[str]"},{"name":"internal_imports","signature":"def internal_imports(path: Path, prefixes: set[str], known: set[str]) -> set[str]"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"},{"name":"collect_tests","signature":"def collect_tests(repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], known: set[str]) -> dict[str, list[dict[str, Any]]]"},{"name":"spec_sections","signature":"def spec_sections(repo: Path, spec_path: str) -> list[dict[str, str]]"},{"name":"subcommands","signature":"def subcommands(raw: str) -> list[str]"},{"name":"console_scripts","signature":"def console_scripts(repo: Path) -> dict[str, tuple[str, str]]"},{"name":"entry_points","signature":"def entry_points(repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]"},{"name":"entry_label","signature":"def entry_label(point: dict[str, str]) -> str"},{"name":"build","signature":"def build(cfg: Config) -> dict[str, Any]"},{"name":"drift","signature":"def drift(fresh: dict[str, Any], stored: dict[str, Any]) -> list[str]"},{"name":"mapping_drift","signature":"def mapping_drift(fresh: dict[str, Any], model: Model, prefixes: set[str]) -> list[str]"},{"name":"read_facts","signature":"def read_facts(path: Path) -> dict[str, Any]"},{"name":"dumps","signature":"def dumps(facts: dict[str, Any]) -> str"},{"name":"write_facts","signature":"def write_facts(path: Path, facts: dict[str, Any]) -> None"},{"name":"is_empty_marker","signature":"def is_empty_marker(record: Mapping[str, Any]) -> bool"},{"name":"empty_markers","signature":"def empty_markers(facts: Mapping[str, Any]) -> list[str]"},{"name":"summary","signature":"def summary(facts: dict[str, Any]) -> list[str]"}],"id":"systemap.extract","imported_by":["systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.describe","systemap.facts","systemap.jev_cli","systemap.journeys","systemap.judgement","systemap.suggest"],"imports":["systemap.config","systemap.language","systemap.model","systemap.typescript","systemap.ways_in"],"loc":1043,"names":[{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"FORMAT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"class","name":"PythonLanguage"},{"kind":"constant","name":"PYTHON"},{"kind":"function","name":"language_for"},{"kind":"constant","name":"FIELDS"},{"kind":"constant","name":"SCOPE_TITLES"},{"kind":"function","name":"fields_of"},{"kind":"function","name":"facts_doc"},{"kind":"function","name":"module_of"},{"kind":"function","name":"plane_of"},{"kind":"function","name":"signature"},{"kind":"function","name":"opening"},{"kind":"function","name":"first_line"},{"kind":"function","name":"sentence"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"resolve_reexports"},{"kind":"function","name":"collect_module"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"function","name":"internal_uses"},{"kind":"function","name":"external_imports"},{"kind":"function","name":"internal_imports"},{"kind":"function","name":"test_names"},{"kind":"function","name":"collect_tests"},{"kind":"function","name":"spec_sections"},{"kind":"function","name":"subcommands"},{"kind":"function","name":"console_scripts"},{"kind":"function","name":"entry_points"},{"kind":"function","name":"entry_label"},{"kind":"function","name":"build"},{"kind":"function","name":"drift"},{"kind":"function","name":"mapping_drift"},{"kind":"function","name":"read_facts"},{"kind":"function","name":"dumps"},{"kind":"function","name":"write_facts"},{"kind":"function","name":"is_empty_marker"},{"kind":"function","name":"empty_markers"},{"kind":"function","name":"summary"}],"package":"systemap","plane":"core","sha":"e9c4f6fcb10c","tests":["test_drift_reports_changes","test_drift_sees_an_entry_point_change","test_entry_may_be_any_public_name","test_extract_attributes_tests_to_modules","test_extract_finds_modules_and_public_surface","test_extract_records_entry_points","test_extract_records_every_public_name_with_its_kind_and_the_external_imports","test_facts_fields_are_the_documented_ones","test_facts_file_is_compact_and_one_record_per_line","test_language_defaults_to_python_and_may_be_stated","test_name_defaults_to_pyproject_then_the_repository_directory","test_no_roots_names_the_candidate_directories","test_spec_sections_and_planes","test_unknown_language_is_refused","test_workspace_roots_and_tests_directories_are_discovered","test_zero_tests_is_said_in_one_line_naming_the_directories","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_package_init_records_the_names_it_reexports","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused"],"tests_primary":16,"tests_total":118,"uses":{"systemap.config":["Config"],"systemap.language":["LanguageAdapter"],"systemap.model":["Model","is_symbol","module_matches","public_names"],"systemap.typescript":["TYPESCRIPT"],"systemap.ways_in":["*"]}},
 "systemap.facts":{"classes":[],"constants":[{"name":"NO_DOCSTRING","value":"'no docstring'"},{"name":"EMPTY_MARKER","value":"'empty package marker'"},{"name":"VIEWS","value":"'views: --modules (one line per module: first sentence, counts), --docstrings (f"}],"docstring":"Readable views of the facts file: what `systemap facts` prints.","errors":[{"methods":[],"name":"UnknownModule"}],"external":[],"file":"src/systemap/facts.py","functions":[{"name":"first_sentence","signature":"def first_sentence(text: str) -> str"},{"name":"kinds","signature":"def kinds(record: dict[str, Any]) -> list[tuple[str, str]]"},{"name":"modules","signature":"def modules(facts: dict[str, Any]) -> list[str]"},{"name":"docstrings","signature":"def docstrings(facts: dict[str, Any]) -> list[str]"},{"name":"module","signature":"def module(facts: dict[str, Any], name: str) -> list[str]"},{"name":"names","signature":"def names(facts: dict[str, Any], name: str) -> list[str]"},{"name":"entry_points","signature":"def entry_points(facts: dict[str, Any]) -> list[str]"},{"name":"external","signature":"def external(facts: dict[str, Any]) -> list[str]"},{"name":"imports","signature":"def imports(facts: dict[str, Any], name: str) -> list[str]"},{"name":"overview","signature":"def overview(summary: list[str]) -> list[str]"}],"id":"systemap.facts","imported_by":["systemap.cli"],"imports":["systemap.extract","systemap.model"],"loc":218,"names":[{"kind":"error","name":"UnknownModule"},{"kind":"function","name":"first_sentence"},{"kind":"constant","name":"NO_DOCSTRING"},{"kind":"constant","name":"EMPTY_MARKER"},{"kind":"function","name":"kinds"},{"kind":"function","name":"modules"},{"kind":"function","name":"docstrings"},{"kind":"function","name":"module"},{"kind":"function","name":"names"},{"kind":"function","name":"entry_points"},{"kind":"function","name":"external"},{"kind":"function","name":"imports"},{"kind":"constant","name":"VIEWS"},{"kind":"function","name":"overview"}],"package":"systemap","plane":"core","sha":"6d58db577f55","tests":["test_a_package_init_records_the_names_it_reexports","test_entry_points_view_prints_the_target_beside_each","test_facts_command_views","test_facts_format_is_2_and_an_older_file_is_stale","test_names_and_first_sentence_read_old_and_new_records","test_reexport_resolution_and_relative_sources","test_the_skill_reads_the_facts_through_the_command"],"tests_primary":7,"tests_total":7,"uses":{"systemap.extract":["entry_label","is_empty_marker"],"systemap.model":["public_names"]}},
 "systemap.figure":{"classes":[],"constants":[{"name":"GENERATOR","value":"'systemap'"},{"name":"MARK_STYLE","value":"{'ring': 'box-shadow:inset 0 0 0 1.5px {bg},inset 0 0 0 2.5px {ink}', 'notch': '"}],"docstring":"Emit a figure of the system for embedding in a lesson or a document.","errors":[{"methods":[],"name":"FigureError"}],"external":[],"file":"src/systemap/figure.py","functions":[{"name":"bare_svg","signature":"def bare_svg(svg: str, t: dict[str, Any]) -> str"},{"name":"figure","signature":"def figure(t: dict[str, Any], model: Model, meaning: Meaning, svg: str, caption: str, legend: list[tuple[str, str, str]], svg_id: str, detail_json: str | None, layer: str='') -> str"},{"name":"make","signature":"def make(cfg: Config, model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], *, mode: str='', components: tuple[str, ...]=(), base: str='', head: str='HEAD', caption: str='', svg_id: str='lessonmap', interactive: bool=False, bare: bool=False, layer: str='', map_id: str='', opens: Mapping[str, Mapping[str, Any]] | None=None) -> tuple[str, list[str]]"},{"name":"configured","signature":"def configured(cfg: Config, tree: nest.Tree, m: nest.Map, facts: dict[str, Any], fig: Figure) -> tuple[str, list[str]]"}],"id":"systemap.figure","imported_by":["systemap.check","systemap.cli"],"imports":["systemap.change","systemap.config","systemap.model","systemap.nest","systemap.schematic"],"loc":370,"names":[{"kind":"constant","name":"GENERATOR"},{"kind":"error","name":"FigureError"},{"kind":"function","name":"bare_svg"},{"kind":"constant","name":"MARK_STYLE"},{"kind":"function","name":"figure"},{"kind":"function","name":"make"},{"kind":"function","name":"configured"}],"package":"systemap","plane":"core","sha":"19e2edc84f0f","tests":["test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_layer_figure_holds_only_that_layers_edges","test_a_pick_restamps_the_root_and_is_kept","test_a_standalone_figure_keeps_literal_colours","test_check_passes_on_sample","test_configured_layer_figures_are_refreshed_and_checked","test_contrast_is_the_wcag_formula","test_default_theme_colours_every_layer","test_every_scheme_clears_the_text_floor_on_every_surface","test_every_text_token_clears_four_and_a_half_to_one_on_its_ground","test_flows_observed_by_in_the_configuration","test_judgement_prints_one_line_per_declared_edge","test_overrides_apply_per_scheme_and_bare_keys_to_the_default","test_page_is_small_and_self_contained","test_reach_figure","test_schematic_reports_layout_and_detail","test_structure_has_no_edges_and_system_crosses_the_boundary","test_the_change_map_draws_through_variables_only","test_the_legend_and_caption_reduce_to_the_layer","test_the_page_carries_every_scheme_and_stamps_the_default","test_the_page_draws_through_variables_only","test_the_page_reads_the_same_table","test_the_palette_answers_one_table_two_ways","test_the_scheme_on_load","test_the_schemes_are_three_full_tables_and_the_default_is_warm"],"tests_primary":0,"tests_total":30,"uses":{"systemap.change":["*"],"systemap.config":["Config","ConfigError","Figure"],"systemap.model":["Layer","Meaning","Model","all_layers"],"systemap.nest":["*"],"systemap.schematic":["interactive_script","kind_rows","layer_rows","legend_rows","panel_css","render"]}},
 "systemap.graph":{"classes":[{"methods":[],"name":"Hop"},{"methods":["def cards(self) -> list[str]","def reached(self) -> list[str]","def edges(self) -> set[Edge]","def at(self, depth: int) -> list[str]"],"name":"Walk"}],"constants":[],"docstring":"The map as something to walk: what a card feeds, what walks through it, what governs it.","errors":[],"external":[],"file":"src/systemap/graph.py","functions":[{"name":"out_flows","signature":"def out_flows(model: Model) -> dict[str, list[Flow]]"},{"name":"in_flows","signature":"def in_flows(model: Model) -> dict[str, list[Flow]]"},{"name":"neighbours","signature":"def neighbours(model: Model, card: str) -> list[str]"},{"name":"steps_on","signature":"def steps_on(meaning: Meaning) -> dict[Edge, list[tuple[Journey, int]]]"},{"name":"rules_on","signature":"def rules_on(model: Model) -> dict[str, list[Invariant]]"},{"name":"walk","signature":"def walk(model: Model, start: Iterable[str], keep: Keep=_always, max_depth: int=3) -> Walk"},{"name":"journeys_through","signature":"def journeys_through(meaning: Meaning, edges: Iterable[Edge]) -> list[tuple[Journey, list[int]]]"},{"name":"rules_over","signature":"def rules_over(model: Model, cards: Iterable[str]) -> list[tuple[Invariant, list[str]]]"}],"id":"systemap.graph","imported_by":["systemap.delta","systemap.plan"],"imports":["systemap.model"],"loc":171,"names":[{"kind":"class","name":"Hop"},{"kind":"function","name":"out_flows"},{"kind":"function","name":"in_flows"},{"kind":"function","name":"neighbours"},{"kind":"function","name":"steps_on"},{"kind":"function","name":"rules_on"},{"kind":"object","name":"Keep"},{"kind":"class","name":"Walk"},{"kind":"function","name":"walk"},{"kind":"function","name":"journeys_through"},{"kind":"function","name":"rules_over"}],"package":"systemap","plane":"core","sha":"6ecf0ead4e44","tests":["test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_the_agent_is_asked_once_and_remembered","test_the_agent_table_is_read_and_checked","test_the_walk_follows_flows_forward_and_counts_the_hops","test_the_walk_stops_at_the_depth_it_is_given","test_what_walks_through_a_flow_and_what_governs_a_card","test_without_a_command_nothing_runs_and_the_reason_is_said"],"tests_primary":0,"tests_total":14,"uses":{"systemap.model":["Edge","Flow","Invariant","Journey","Meaning","Model"]}},
@@ -22,6 +22,7 @@
 "systemap.jev_cli":{"classes":[],"constants":[{"name":"REPORT_CAP","value":"2000"},{"name":"MOVE_AT","value":"0.8"},{"name":"SAME_AT","value":"0.4"},{"name":"TRIAGE_Q","value":"'`report` is an issue filed against this system. Which component will the fix mo"},{"name":"BECAME_Q","value":"'In one commit `old_module` disappeared and the modules in the options appeared."},{"name":"NOT_MOVED","value":"'not moved: deleted'"},{"name":"MOVE_OPTIONS","value":"250"},{"name":"SAME_Q","value":"'Do `module_a` and `module_b` belong to the same component of this system: one p"},{"name":"JUDGEMENT_HINT","value":"\"hint: with a TypeSafe key in TYPESAFE_API_KEY, systemap audit adds Jev's second"},{"name":"DELTA_HINT","value":"'hint: with a TypeSafe key in TYPESAFE_API_KEY, delta also asks Jev which new mo"},{"name":"UNCLAIMED","value":"(re.compile('^(?:\\\\S+: )?added: (\\\\S+), claimed by no card'), re.compile('^(?:\\\\"},{"name":"JOURNEY_CAP","value":"3"},{"name":"AROUND_CAP","value":"6"}],"docstring":"The commands that ask Jev: `audit`, `triage`, and the `--jev` of `delta` and `suggest`.","errors":[],"external":[],"file":"src/systemap/jev_cli.py","functions":[{"name":"uses_jev","signature":"def uses_jev(cfg: config.Config, flag: bool | None) -> bool"},{"name":"usage_to_stderr","signature":"def usage_to_stderr(client: jev.Jev) -> None"},{"name":"hint","signature":"def hint(cfg: config.Config, text: str) -> None"},{"name":"cmd_audit","signature":"def cmd_audit(args: argparse.Namespace, send: jev.Send | None=None) -> int"},{"name":"cmd_triage","signature":"def cmd_triage(args: argparse.Namespace, send: jev.Send | None=None) -> int"},{"name":"unclaimed_in","signature":"def unclaimed_in(lines: list[str]) -> list[str]"},{"name":"owner_suggestions","signature":"def owner_suggestions(cfg: config.Config, tree: nest.Tree, head: dict[str, Any], modules: list[str], client: jev.Jev) -> list[str]"},{"name":"cmd_journeys","signature":"def cmd_journeys(args: argparse.Namespace, run_command: agent.Run | None=None) -> int"},{"name":"writer_usage","signature":"def writer_usage(writer: agent.Agent) -> None"},{"name":"jev_moves","signature":"def jev_moves(base: dict[str, Any], head: dict[str, Any], client: jev.Jev) -> dict[str, tuple[str, str]]"},{"name":"pair_candidates","signature":"def pair_candidates(facts: dict[str, Any], mods: list[str]) -> list[tuple[str, str]]"},{"name":"groups","signature":"def groups(mods: list[str], edges: list[tuple[str, str]]) -> list[list[str]]"},{"name":"suggest_groups","signature":"def suggest_groups(cfg: config.Config, facts: dict[str, Any], client: jev.Jev) -> list[str]"},{"name":"run_or_explain","signature":"def run_or_explain(fn: Callable[[], list[str]], label: str) -> tuple[list[str], int]"},{"name":"cmd_plan","signature":"def cmd_plan(args: argparse.Namespace, send: jev.Send | None=None) -> int"},{"name":"add_parsers","signature":"def add_parsers(sub: Any, add_root: Callable[[argparse.ArgumentParser], None]) -> None"}],"id":"systemap.jev_cli","imported_by":["systemap.cli"],"imports":["systemap.agent","systemap.audit","systemap.cli","systemap.config","systemap.delta","systemap.evidence","systemap.extract","systemap.history","systemap.jev","systemap.journeys","systemap.moves","systemap.nest","systemap.plan"],"loc":679,"names":[{"kind":"constant","name":"REPORT_CAP"},{"kind":"constant","name":"MOVE_AT"},{"kind":"constant","name":"SAME_AT"},{"kind":"constant","name":"TRIAGE_Q"},{"kind":"constant","name":"BECAME_Q"},{"kind":"constant","name":"NOT_MOVED"},{"kind":"constant","name":"MOVE_OPTIONS"},{"kind":"constant","name":"SAME_Q"},{"kind":"constant","name":"JUDGEMENT_HINT"},{"kind":"constant","name":"DELTA_HINT"},{"kind":"function","name":"uses_jev"},{"kind":"function","name":"usage_to_stderr"},{"kind":"function","name":"hint"},{"kind":"function","name":"cmd_audit"},{"kind":"function","name":"cmd_triage"},{"kind":"constant","name":"UNCLAIMED"},{"kind":"function","name":"unclaimed_in"},{"kind":"function","name":"owner_suggestions"},{"kind":"constant","name":"JOURNEY_CAP"},{"kind":"function","name":"cmd_journeys"},{"kind":"function","name":"writer_usage"},{"kind":"function","name":"jev_moves"},{"kind":"function","name":"pair_candidates"},{"kind":"function","name":"groups"},{"kind":"function","name":"suggest_groups"},{"kind":"function","name":"run_or_explain"},{"kind":"function","name":"cmd_plan"},{"kind":"constant","name":"AROUND_CAP"},{"kind":"function","name":"add_parsers"}],"package":"systemap","plane":"core","sha":"46fa19b4c268","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_task_no_card_answers_to_says_so_rather_than_guessing","test_a_task_with_nothing_to_name_it_by_still_gets_an_id","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_about_a_kind_not_asked_is_not_stale","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_an_empty_task_asks_for_one_and_sends_nothing","test_apply_suppresses_answered_lines_and_reports_stale_answers","test_audit_answers_are_told_apart_from_judgement_answers","test_audit_cli_end_to_end_over_http","test_audit_dry_run_sends_no_question"],"tests_primary":0,"tests_total":66,"uses":{"systemap.agent":["*"],"systemap.audit":["*"],"systemap.cli":["_root"],"systemap.config":["*"],"systemap.delta":["*"],"systemap.evidence":["*"],"systemap.extract":["*"],"systemap.history":["*"],"systemap.jev":["*"],"systemap.journeys":["*"],"systemap.moves":["*"],"systemap.nest":["*"],"systemap.plan":["*"]}},
 "systemap.journeys":{"classes":[{"methods":["def one(self) -> dict[str, str]","def whole(self) -> bool","def label(self) -> str","def starts(self) -> str"],"name":"Group"},{"methods":[],"name":"Draft"}],"constants":[{"name":"QUESTION","value":"'You are reading a repository to write one journey for its system map.\\n\\nA jour"},{"name":"GROUP_QUESTION","value":"QUESTION.replace('Read the code from the way in named below.', 'Below is a group"},{"name":"SHOWN","value":"14"},{"name":"ANCHORS","value":"('JOURNEYS = (', 'journeys=(')"}],"docstring":"A journey written for a way in nothing walks from yet.","errors":[],"external":[],"file":"src/systemap/journeys.py","functions":[{"name":"uncovered","signature":"def uncovered(meaning: Meaning, facts: dict[str, Any], owner: dict[str, str] | None=None) -> list[dict[str, str]]"},{"name":"gather","signature":"def gather(model: Model, meaning: Meaning, facts: dict[str, Any]) -> list[Group]"},{"name":"context","signature":"def context(model: Model, meaning: Meaning, facts: dict[str, Any], group: Group) -> dict[str, Any]"},{"name":"read_answer","signature":"def read_answer(text: str, model: Model, group: Group) -> Draft"},{"name":"write_one","signature":"def write_one(agent: Agent, model: Model, meaning: Meaning, facts: dict[str, Any], group: Group) -> Draft"},{"name":"add_to_source","signature":"def add_to_source(source: str, journey: Journey) -> str | None"},{"name":"as_source","signature":"def as_source(journey: Journey) -> list[str]"}],"id":"systemap.journeys","imported_by":["systemap.describe","systemap.jev_cli"],"imports":["systemap.agent","systemap.evidence","systemap.extract","systemap.judgement","systemap.model"],"loc":282,"names":[{"kind":"constant","name":"QUESTION"},{"kind":"constant","name":"GROUP_QUESTION"},{"kind":"class","name":"Group"},{"kind":"class","name":"Draft"},{"kind":"function","name":"uncovered"},{"kind":"function","name":"gather"},{"kind":"function","name":"context"},{"kind":"constant","name":"SHOWN"},{"kind":"function","name":"read_answer"},{"kind":"function","name":"write_one"},{"kind":"constant","name":"ANCHORS"},{"kind":"function","name":"add_to_source"},{"kind":"function","name":"as_source"}],"package":"systemap","plane":"core","sha":"6bae94a09466","tests":["test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_describe_and_judgement_agree_that_a_crowd_is_walked","test_describe_names_the_steps_the_code_does_not_back","test_describe_says_where_each_walk_starts_and_how_many_ways_in_are_walked","test_the_agent_is_shown_the_crowd_and_a_sample_of_it","test_the_agent_is_told_the_cards_the_flows_and_where_to_read","test_the_route_with_no_walk_is_listed_and_nothing_is_written","test_the_walk_is_written_into_the_model_where_its_journeys_are_named","test_the_walk_that_comes_back_is_written_in_and_judgement_asks_about_it","test_with_no_agent_set_it_says_so_and_writes_nothing"],"tests_primary":21,"tests_total":21,"uses":{"systemap.agent":["Agent"],"systemap.evidence":["owners"],"systemap.extract":["entry_label"],"systemap.judgement":["*"],"systemap.model":["Journey","Meaning","Model","Step"]}},
 "systemap.judgement":{"classes":[{"methods":[],"name":"Answered"}],"constants":[{"name":"MIN_STEM","value":"4"},{"name":"MODEL_SDKS","value":"('anthropic', 'openai', 'google.generativeai', 'google.adk', 'litellm', 'langcha"},{"name":"TOGETHER_AT","value":"4"},{"name":"CROSSING_LINE","value":"re.compile('^crossing import: (\\\\S+) imports (\\\\S+) in \\\\d+ modules? and no flow"},{"name":"SDK_LINE","value":"re.compile('^model sdk: module \\\\S+ imports (\\\\S+) and its component ')"},{"name":"KIND_PREFIX","value":"{kind: f'{kind}: ' for kind in LINE_KINDS} | {'entry point': 'entry point '}"}],"docstring":"The list a maintainer must confirm before the map is trusted.","errors":[],"external":[],"file":"src/systemap/judgement.py","functions":[{"name":"words","signature":"def words(name: str) -> set[str]"},{"name":"shares_a_word","signature":"def shares_a_word(a: str, b: str) -> bool"},{"name":"share_a_word","signature":"def share_a_word(xs: set[str], ys: set[str]) -> bool"},{"name":"single_module","signature":"def single_module(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"package_of","signature":"def package_of(module: str) -> str"},{"name":"share_a_package","signature":"def share_a_package(a: str, b: str) -> bool"},{"name":"mis_folds","signature":"def mis_folds(model: Model, meaning: Meaning, facts: dict[str, Any]) -> list[str]"},{"name":"no_sentence","signature":"def no_sentence(model: Model, meaning: Meaning) -> list[str]"},{"name":"thin_layers","signature":"def thin_layers(model: Model, meaning: Meaning) -> list[str]"},{"name":"entry_points_without_journey","signature":"def entry_points_without_journey(model: Model, meaning: Meaning, facts: dict[str, Any], *, text: str | None=None, skip: Collection[str]=()) -> list[str]"},{"name":"ways_in_without_journey","signature":"def ways_in_without_journey(meaning: Meaning, facts: dict[str, Any], text: str | None=None, skip: Collection[str]=(), owner: dict[str, str] | None=None) -> list[dict[str, str]]"},{"name":"crowd_label","signature":"def crowd_label(how_many: int, kind: str, card: str) -> str"},{"name":"journey_problems","signature":"def journey_problems(meaning: Meaning, facts: dict[str, Any], cards: Collection[str]=()) -> list[str]"},{"name":"crossing_pairs","signature":"def crossing_pairs(components: dict[str, Any], owner: dict[str, str]) -> dict[Pair, list[tuple[str, str]]]"},{"name":"crossing_line","signature":"def crossing_line(p: str, q: str, imports: list[tuple[str, str]]) -> str"},{"name":"crossing_imports","signature":"def crossing_imports(model: Model, facts: dict[str, Any]) -> dict[Pair, list[tuple[str, str]]]"},{"name":"crossing_imports_without_flow","signature":"def crossing_imports_without_flow(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"crossing_detail","signature":"def crossing_detail(model: Model, facts: dict[str, Any], prefix: str='') -> dict[str, list[str]]"},{"name":"crossing_detail_tree","signature":"def crossing_detail_tree(tree: nest.Tree, facts: dict[str, Any]) -> dict[str, list[str]]"},{"name":"declared_flows","signature":"def declared_flows(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> list[str]"},{"name":"sdk_of","signature":"def sdk_of(name: str, sdks: Iterable[str]) -> str"},{"name":"model_sdk_imports","signature":"def model_sdk_imports(model: Model, facts: dict[str, Any], sdks: Iterable[str]=MODEL_SDKS, *, skip: Collection[str]=()) -> list[str]"},{"name":"sdk_list","signature":"def sdk_list(configured: Iterable[str]) -> tuple[str, ...]"},{"name":"run","signature":"def run(model: Model, meaning: Meaning, facts: dict[str, Any], sdks: Iterable[str]=MODEL_SDKS, observed_by: Iterable[str]=(), *, journeys_text: str | None=None, skip: Collection[str]=()) -> list[str]"},{"name":"run_tree","signature":"def run_tree(tree: nest.Tree, facts: dict[str, Any], sdks: Iterable[str]=MODEL_SDKS, observed_by: Iterable[str]=()) -> list[str]"},{"name":"unprefixed","signature":"def unprefixed(line: str) -> str"},{"name":"answers","signature":"def answers(answer: Answer, line: str) -> bool"},{"name":"apply_answers","signature":"def apply_answers(lines: list[str], answer_list: Iterable[Answer]) -> Answered"},{"name":"of_kind","signature":"def of_kind(lines: list[str], kind: str) -> list[str]"},{"name":"kind_of","signature":"def kind_of(line: str) -> str"},{"name":"report","signature":"def report(lines: list[str] | Answered, detail: dict[str, list[str]] | None=None, kind: str='', teach: bool=True) -> list[str]"}],"id":"systemap.judgement","imported_by":["systemap.cli","systemap.delta","systemap.journeys"],"imports":["systemap.config","systemap.evidence","systemap.explain","systemap.extract","systemap.model","systemap.nest"],"loc":748,"names":[{"kind":"constant","name":"MIN_STEM"},{"kind":"constant","name":"MODEL_SDKS"},{"kind":"function","name":"words"},{"kind":"function","name":"shares_a_word"},{"kind":"function","name":"share_a_word"},{"kind":"function","name":"single_module"},{"kind":"function","name":"package_of"},{"kind":"function","name":"share_a_package"},{"kind":"function","name":"mis_folds"},{"kind":"function","name":"no_sentence"},{"kind":"function","name":"thin_layers"},{"kind":"constant","name":"TOGETHER_AT"},{"kind":"function","name":"entry_points_without_journey"},{"kind":"function","name":"ways_in_without_journey"},{"kind":"function","name":"crowd_label"},{"kind":"function","name":"journey_problems"},{"kind":"object","name":"Pair"},{"kind":"function","name":"crossing_pairs"},{"kind":"function","name":"crossing_line"},{"kind":"function","name":"crossing_imports"},{"kind":"function","name":"crossing_imports_without_flow"},{"kind":"function","name":"crossing_detail"},{"kind":"function","name":"crossing_detail_tree"},{"kind":"function","name":"declared_flows"},{"kind":"function","name":"sdk_of"},{"kind":"function","name":"model_sdk_imports"},{"kind":"function","name":"sdk_list"},{"kind":"function","name":"run"},{"kind":"function","name":"run_tree"},{"kind":"constant","name":"CROSSING_LINE"},{"kind":"constant","name":"SDK_LINE"},{"kind":"constant","name":"KIND_PREFIX"},{"kind":"function","name":"unprefixed"},{"kind":"function","name":"answers"},{"kind":"class","name":"Answered"},{"kind":"function","name":"apply_answers"},{"kind":"function","name":"of_kind"},{"kind":"function","name":"kind_of"},{"kind":"function","name":"report"}],"package":"systemap","plane":"core","sha":"f3d7fdd0f67a","tests":["test_an_ignored_module_is_not_a_question","test_answers_in_the_configuration","test_answers_suppress_count_and_go_stale","test_bulk_answers_cover_a_family_and_go_stale_as_written","test_bulk_answers_in_the_configuration","test_crossing_answers_cover_into_from_and_every_pair","test_crossing_imports_are_one_line_per_pair_with_the_module_count","test_crossing_imports_without_flow","test_crossing_into_and_from_in_the_configuration","test_entry_points_without_journey","test_judgement_command_always_exits_0","test_mentioned_is_a_whole_word","test_mis_fold_count_on_the_workspace_fixture","test_mis_fold_fires_only_on_a_stranger_in_a_foreign_package","test_mis_fold_lines","test_model_sdk_lines","test_model_sdks_configured","test_model_sdks_removal","test_no_sentence_lines","test_report_wording","test_run_orders_the_second_pass_last","test_single_module_lines","test_single_module_reads_implemented_by_without_facts","test_strict_exits_1_while_a_line_is_open","test_thin_layer_lines"],"tests_primary":26,"tests_total":71,"uses":{"systemap.config":["Answer","ConfigError","LINE_KINDS"],"systemap.evidence":["*"],"systemap.explain":["*"],"systemap.extract":["entry_label"],"systemap.model":["Component","Meaning","Model","claimed","flow_layers","is_symbol"],"systemap.nest":["*"]}},
+"systemap.language":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str]) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"LanguageAdapter"}],"constants":[],"docstring":"The source-language boundary shared by extraction and change analysis.","errors":[],"external":[],"file":"src/systemap/language.py","functions":[],"id":"systemap.language","imported_by":["systemap.change","systemap.extract"],"imports":[],"loc":68,"names":[{"kind":"class","name":"LanguageAdapter"}],"package":"systemap","plane":"core","sha":"75c332e4c8fb","tests":[],"tests_primary":0,"tests_total":0,"uses":{}},
 "systemap.model":{"classes":[{"methods":[],"name":"Container"},{"methods":[],"name":"Region"},{"methods":["def opens(self) -> bool","def positioned(self) -> bool","def model_end(self) -> bool","def home(self) -> str","def box(self) -> Box"],"name":"Component"},{"methods":["def edge(self) -> Edge"],"name":"Flow"},{"methods":[],"name":"Invariant"},{"methods":[],"name":"Step"},{"methods":[],"name":"Journey"},{"methods":[],"name":"Layer"},{"methods":["def ids(self) -> set[str]","def opening(self) -> tuple[Component, ...]","def agentic(self) -> bool","def kind_of(self, cid: str) -> str","def component(self, cid: str) -> Component","def rules_of(self, cid: str) -> list[int]","def layout_problems(self) -> list[str]"],"name":"Model"},{"methods":["def layer_for(self, edge: Edge, kind: str) -> str","def verb_for(self, edge: Edge, layer: str, from_clicked: bool) -> str"],"name":"Meaning"}],"constants":[{"name":"KINDS","value":"('component', 'store', 'actor', 'agent', 'tool', 'context')"},{"name":"AGENT_KINDS","value":"('agent', 'tool', 'context')"},{"name":"TONES","value":"('host', 'client', 'server', 'isolated')"},{"name":"CARD_W","value":"150"},{"name":"CARD_H","value":"{'component': 56, 'store': 52, 'actor': 44, 'agent': 56, 'tool': 56, 'context': "},{"name":"STANDARD_LAYERS","value":"(Layer('structure', 'Structure', question='What are the parts, and where does ea"},{"name":"AGENT_LAYERS","value":"(Layer('agents', 'Agents', question='Which parts run a model, and what do they r"},{"name":"STANDARD_KINDS","value":"('data', 'control', 'context', 'tool')"},{"name":"LAYER_OF_STANDARD_KIND","value":"{'data': 'data', 'control': 'control', 'context': 'context', 'tool': 'tools'}"},{"name":"DERIVED_LAYERS","value":"('structure', 'system', 'agents')"},{"name":"RESERVED_LAYER_IDS","value":"frozenset([layer.id for layer in STANDARD_LAYERS + AGENT_LAYERS] + list(LAYER_OF"},{"name":"STANDARD_VERBS","value":"{'data': ('hands to', 'receives from'), 'control': ('drives', 'is driven by'), '"},{"name":"SUBJECT_KIND","value":"{'system': 'actor', 'agents': 'agent', 'context': 'context', 'tools': 'tool'}"},{"name":"BUILT","value":"'built'"}],"docstring":"The schema a system map is written in, and the checks that keep it honest.","errors":[],"external":[],"file":"src/systemap/model.py","functions":[{"name":"all_layers","signature":"def all_layers(model: Model, meaning: Meaning) -> tuple[Layer, ...]"},{"name":"flow_layers","signature":"def flow_layers(model: Model, meaning: Meaning) -> tuple[Layer, ...]"},{"name":"edge_in_layer","signature":"def edge_in_layer(model: Model, layer_id: str, edge_layer: str, src: str, dst: str) -> bool"},{"name":"subject_of_layer","signature":"def subject_of_layer(model: Model, layer_id: str, cid: str) -> bool"},{"name":"reading","signature":"def reading(model: Model, meaning: Meaning, layer_id: str) -> tuple[list[int], list[str]]"},{"name":"meaning_problems","signature":"def meaning_problems(model: Model, meaning: Meaning) -> list[str]"},{"name":"problems","signature":"def problems(model: Model, meaning: Meaning) -> list[str]"},{"name":"is_symbol","signature":"def is_symbol(pattern: str) -> bool"},{"name":"symbol_claims","signature":"def symbol_claims(component: Component) -> list[tuple[str, str]]"},{"name":"module_matches","signature":"def module_matches(pattern: str, module: str) -> bool"},{"name":"claimed","signature":"def claimed(component: Component, modules: Iterable[str]) -> list[str]"},{"name":"public_names","signature":"def public_names(record: Mapping[str, Any]) -> set[str]"},{"name":"defines_entry","signature":"def defines_entry(component: Component, facts: Mapping[str, Any]) -> bool"},{"name":"entry_module","signature":"def entry_module(component: Component, facts: Mapping[str, Any]) -> str"},{"name":"build_state","signature":"def build_state(component: Component, facts: Mapping[str, Any]) -> str"}],"id":"systemap.model","imported_by":["systemap","systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.config","systemap.delta","systemap.describe","systemap.evidence","systemap.extract","systemap.facts","systemap.figure","systemap.graph","systemap.journeys","systemap.judgement","systemap.moves","systemap.nest","systemap.page","systemap.place","systemap.plan","systemap.schematic","systemap.suggest","systemap.theme","systemap.trend"],"imports":[],"loc":744,"names":[{"kind":"object","name":"Box"},{"kind":"object","name":"Edge"},{"kind":"constant","name":"KINDS"},{"kind":"constant","name":"AGENT_KINDS"},{"kind":"constant","name":"TONES"},{"kind":"constant","name":"CARD_W"},{"kind":"constant","name":"CARD_H"},{"kind":"class","name":"Container"},{"kind":"class","name":"Region"},{"kind":"class","name":"Component"},{"kind":"class","name":"Flow"},{"kind":"class","name":"Invariant"},{"kind":"class","name":"Step"},{"kind":"class","name":"Journey"},{"kind":"class","name":"Layer"},{"kind":"constant","name":"STANDARD_LAYERS"},{"kind":"constant","name":"AGENT_LAYERS"},{"kind":"constant","name":"STANDARD_KINDS"},{"kind":"constant","name":"LAYER_OF_STANDARD_KIND"},{"kind":"constant","name":"DERIVED_LAYERS"},{"kind":"constant","name":"RESERVED_LAYER_IDS"},{"kind":"constant","name":"STANDARD_VERBS"},{"kind":"class","name":"Model"},{"kind":"class","name":"Meaning"},{"kind":"function","name":"all_layers"},{"kind":"function","name":"flow_layers"},{"kind":"function","name":"edge_in_layer"},{"kind":"constant","name":"SUBJECT_KIND"},{"kind":"function","name":"subject_of_layer"},{"kind":"function","name":"reading"},{"kind":"function","name":"meaning_problems"},{"kind":"function","name":"problems"},{"kind":"function","name":"is_symbol"},{"kind":"function","name":"symbol_claims"},{"kind":"function","name":"module_matches"},{"kind":"function","name":"claimed"},{"kind":"constant","name":"BUILT"},{"kind":"function","name":"public_names"},{"kind":"function","name":"defines_entry"},{"kind":"function","name":"entry_module"},{"kind":"function","name":"build_state"}],"package":"systemap","plane":"core","sha":"dc78c161fe4a","tests":["test_a_custom_layer_may_not_take_a_standard_id","test_a_model_may_import_a_module_beside_it","test_build_state_has_one_value","test_defines_entry_looks_the_name_up_in_the_claimed_modules","test_layers_are_standard_then_the_models_own","test_layout_problems_find_lies","test_meaning_problems_find_gaps","test_module_matches_exact_and_subtree","test_one_flow_per_ordered_pair","test_sample_every_flow_has_a_relation_and_a_layer","test_sample_flow_endpoints_resolve","test_sample_journeys_resolve","test_sample_positions_and_plain_words","test_sample_validates","test_small_model_is_clean","test_two_invariants_with_one_number_are_refused_with_both_quoted","test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_takes_a_crowd_of_routes_is_asked_once","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_decorator_that_is_not_a_way_in_is_not_one","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered"],"tests_primary":16,"tests_total":229,"uses":{}},
 "systemap.moves":{"classes":[{"methods":[],"name":"Pair"}],"constants":[{"name":"SURFACE_OVERLAP","value":"0.8"},{"name":"NAME_ALIKE","value":"0.6"},{"name":"QUESTIONS","value":"((_same_content, 'same content'), (_same_names, 'same public names'), (_renamed_"},{"name":"NO_MOVES","value":"MappingProxyType({})"}],"docstring":"Which new module a module that disappeared became, between two commits.","errors":[],"external":[],"file":"src/systemap/moves.py","functions":[{"name":"find","signature":"def find(base: dict[str, Any], head: dict[str, Any], gone: list[str], new: list[str]) -> dict[str, tuple[str, str]]"},{"name":"with_told","signature":"def with_told(found: dict[str, tuple[str, str]], told: Mapping[str, tuple[str, str]], gone: list[str], new: list[str]) -> dict[str, tuple[str, str]]"}],"id":"systemap.moves","imported_by":["systemap.delta","systemap.jev_cli"],"imports":["systemap.model"],"loc":182,"names":[{"kind":"constant","name":"SURFACE_OVERLAP"},{"kind":"constant","name":"NAME_ALIKE"},{"kind":"class","name":"Pair"},{"kind":"constant","name":"QUESTIONS"},{"kind":"function","name":"find"},{"kind":"constant","name":"NO_MOVES"},{"kind":"function","name":"with_told"}],"package":"systemap","plane":"core","sha":"0ceaa9f4180d","tests":["test_a_card_joined_to_a_third_of_the_map_names_none","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_delta_alone_pairs_neither","test_every_line_kind_with_its_fix","test_jev_names_the_rewritten_module_and_leaves_the_deleted_one","test_markdown_is_the_comment_with_the_committed_figure","test_nothing_to_do_and_no_change_exit_zero","test_the_base_is_the_merge_base_and_the_working_copy_is_not_read","test_the_best_pairing_wins_over_the_first_free_one","test_the_cards_next_to_the_change_are_printed_as_context","test_the_context_is_in_the_pull_request_comment_once","test_the_seed_is_the_card_with_the_most_changed_modules","test_told_moves_fill_only_what_delta_left_and_take_each_new_module_once","test_two_empty_modules_with_different_names_are_not_joined","test_unknown_ref_is_refused","test_with_claims_renames_modules_and_symbols_and_keeps_patterns"],"tests_primary":0,"tests_total":16,"uses":{"systemap.model":["public_names"]}},
 "systemap.nest":{"classes":[{"methods":["def top(self) -> bool","def prefix(self) -> str","def inside(self) -> int","def page_path(self, cfg: Config) -> Path"],"name":"Map"},{"methods":["def top(self) -> Map","def nested(self) -> bool","def ids(self) -> list[str]","def get(self, map_id: str) -> Map","def has(self, map_id: str) -> bool","def children(self, m: Map) -> list[Map]","def parent_of(self, m: Map) -> Map | None","def opening_card(self, m: Map) -> Component | None"],"name":"Tree"}],"constants":[{"name":"CARDS_PER_MAP","value":"40"},{"name":"MODULES_PER_CARD","value":"10"}],"docstring":"Nested maps: a card that opens a map of its own, and the tree they form.","errors":[],"external":[],"file":"src/systemap/nest.py","functions":[{"name":"load","signature":"def load(cfg: Config) -> Tree"},{"name":"opens","signature":"def opens(tree: Tree, m: Map, links: bool=True) -> dict[str, dict[str, Any]]"},{"name":"unknown_map","signature":"def unknown_map(tree: Tree, map_id: str) -> ConfigError"}],"id":"systemap.nest","imported_by":["systemap.audit","systemap.check","systemap.cli","systemap.delta","systemap.figure","systemap.jev_cli","systemap.judgement","systemap.page","systemap.suggest"],"imports":["systemap.config","systemap.model","systemap.theme"],"loc":199,"names":[{"kind":"constant","name":"CARDS_PER_MAP"},{"kind":"constant","name":"MODULES_PER_CARD"},{"kind":"class","name":"Map"},{"kind":"class","name":"Tree"},{"kind":"function","name":"load"},{"kind":"function","name":"opens"},{"kind":"function","name":"unknown_map"}],"package":"systemap","plane":"core","sha":"043050eba0d7","tests":["test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_a_quiet_stretch_says_so_rather_than_printing_a_chart","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_sub_maps_actors_are_cards_of_the_parent","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_about_a_kind_not_asked_is_not_stale","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_apply_suppresses_answered_lines_and_reports_stale_answers","test_audit_answers_are_told_apart_from_judgement_answers","test_audit_cli_end_to_end_over_http","test_audit_dry_run_sends_no_question","test_audit_on_recorded_answers"],"tests_primary":0,"tests_total":84,"uses":{"systemap.config":["Config","ConfigError","load_model"],"systemap.model":["Component","Meaning","Model","all_layers"],"systemap.theme":["*"]}},
@@ -29,12 +30,13 @@
 "systemap.place":{"classes":[{"methods":["def text(self) -> str"],"name":"Score"},{"methods":["def placed(self) -> tuple[str, ...]"],"name":"Placement"}],"constants":[{"name":"COL_PITCH","value":"190"},{"name":"ROW_PITCH","value":"92"},{"name":"COL_GUTTER","value":"COL_PITCH - CARD_W"},{"name":"ROW_GUTTER","value":"ROW_PITCH - CARD_H['component']"},{"name":"REGION_GAP_X","value":"48"},{"name":"REGION_GAP_Y","value":"36"},{"name":"REGION_PAD_LEFT","value":"20"},{"name":"REGION_PAD_TOP","value":"40"},{"name":"REGION_PAD_BOTTOM","value":"16"},{"name":"CONTAINER_PAD","value":"20"},{"name":"CONTAINER_GAP","value":"24"},{"name":"CANVAS_MARGIN","value":"16"},{"name":"REGION_COLUMNS","value":"2"},{"name":"ROWS_DEEP","value":"3"}],"docstring":"A first placement for every card without one: what `systemap place` writes.","errors":[{"methods":[],"name":"PlaceError"}],"external":[],"file":"src/systemap/place.py","functions":[{"name":"region_slots","signature":"def region_slots(box: Box, top: int=REGION_PAD_TOP) -> list[_Slot]"},{"name":"region_shape","signature":"def region_shape(n: int) -> tuple[int, int]"},{"name":"region_size","signature":"def region_size(n: int, label: str) -> tuple[int, int]"},{"name":"sub_lines","signature":"def sub_lines(sub: str, w: int) -> int"},{"name":"container_width","signature":"def container_width(label: str, sub: str, inner: int) -> int"},{"name":"container_top","signature":"def container_top(sub: str, w: int) -> int"},{"name":"assign","signature":"def assign(ids: list[str], slots: list[_Slot], bary: dict[str, tuple[float, float] | None], heights: dict[str, int]) -> dict[str, tuple[int, int]]"},{"name":"score","signature":"def score(model: Model) -> Score"},{"name":"estimate","signature":"def estimate(model: Model) -> tuple[int, float]"},{"name":"grid_order","signature":"def grid_order(model: Model) -> tuple[str, ...]"},{"name":"order_line","signature":"def order_line(placement: Placement) -> str"},{"name":"kept_by","signature":"def kept_by(model: Model, all_cards: bool) -> tuple[str, ...]"},{"name":"compute","signature":"def compute(model: Model, all_cards: bool=False, keep_order: bool=False) -> Placement"},{"name":"apply","signature":"def apply(model: Model, placement: Placement) -> Model"},{"name":"head","signature":"def head(placement: Placement) -> str"},{"name":"lines","signature":"def lines(placement: Placement) -> list[str]"},{"name":"edits","signature":"def edits(source: str, placement: Placement) -> list[_Edit]"},{"name":"written","signature":"def written(source: str, placement: Placement) -> str"},{"name":"write","signature":"def write(path: Path, placement: Placement) -> str"},{"name":"unwritten","signature":"def unwritten(reloaded: Model, placement: Placement) -> list[str]"}],"id":"systemap.place","imported_by":["systemap.cli","systemap.describe"],"imports":["systemap.model","systemap.route","systemap.schematic"],"loc":1053,"names":[{"kind":"constant","name":"COL_PITCH"},{"kind":"constant","name":"ROW_PITCH"},{"kind":"constant","name":"COL_GUTTER"},{"kind":"constant","name":"ROW_GUTTER"},{"kind":"constant","name":"REGION_GAP_X"},{"kind":"constant","name":"REGION_GAP_Y"},{"kind":"constant","name":"REGION_PAD_LEFT"},{"kind":"constant","name":"REGION_PAD_TOP"},{"kind":"constant","name":"REGION_PAD_BOTTOM"},{"kind":"constant","name":"CONTAINER_PAD"},{"kind":"constant","name":"CONTAINER_GAP"},{"kind":"constant","name":"CANVAS_MARGIN"},{"kind":"constant","name":"REGION_COLUMNS"},{"kind":"constant","name":"ROWS_DEEP"},{"kind":"constant","name":"SWEEPS"},{"kind":"constant","name":"REGION_LABEL_LEAD"},{"kind":"constant","name":"CONTAINER_LABEL_LEAD"},{"kind":"constant","name":"SEARCH_ALL"},{"kind":"constant","name":"ROUTED"},{"kind":"constant","name":"PORT_REACH_X"},{"kind":"constant","name":"PORT_REACH_Y"},{"kind":"constant","name":"ROUTE_CLEAR"},{"kind":"error","name":"PlaceError"},{"kind":"class","name":"Score"},{"kind":"class","name":"Placement"},{"kind":"function","name":"region_slots"},{"kind":"function","name":"region_shape"},{"kind":"function","name":"region_size"},{"kind":"function","name":"sub_lines"},{"kind":"function","name":"container_width"},{"kind":"function","name":"container_top"},{"kind":"function","name":"assign"},{"kind":"function","name":"score"},{"kind":"function","name":"estimate"},{"kind":"function","name":"grid_order"},{"kind":"function","name":"order_line"},{"kind":"function","name":"kept_by"},{"kind":"function","name":"compute"},{"kind":"function","name":"apply"},{"kind":"function","name":"head"},{"kind":"constant","name":"NOTHING_TO_PLACE"},{"kind":"constant","name":"EVERY_CARD_PINNED"},{"kind":"function","name":"lines"},{"kind":"function","name":"edits"},{"kind":"function","name":"written"},{"kind":"function","name":"write"},{"kind":"function","name":"unwritten"}],"package":"systemap","plane":"core","sha":"9d27d67b3491","tests":["test_a_positioned_card_stays_where_it_was","test_check_refuses_a_card_without_a_position","test_describe_prints_the_region_order_for_the_look_and_as_written","test_describe_reports_placed_and_pinned","test_fill_puts_the_card_that_talks_next_to_its_neighbour_and_refuses_a_full_box","test_first_layout_refuses_a_card_with_no_home_and_places_loose_regions","test_fixture_stripped_is_clean_after_place_in_under_ten_seconds","test_past_six_regions_a_greedy_start_and_pairwise_swaps_are_tried","test_place_all_lays_every_card_out_again_and_keeps_the_pinned_ones","test_place_inserts_in_the_call_style_the_file_uses","test_place_writes_the_model_in_place_and_a_second_run_changes_nothing","test_score_ranks_collisions_then_refusals_then_bends_then_length","test_self_map_stripped_is_clean_after_place","test_the_estimate_counts_a_straight_run_an_l_and_a_z","test_the_search_picks_an_order_the_router_scores_no_worse_than_the_listed_one","test_a_sub_maps_actors_are_cards_of_the_parent","test_delta_names_the_card_and_the_map_a_moved_module_belongs_to","test_figure_draws_one_map_by_id","test_judgement_and_describe_lines_carry_the_maps_id","test_pages_are_written_per_map_with_the_links_up_and_down","test_place_writes_into_a_sub_maps_file","test_suggest_reads_the_tree_from_the_command","test_suggest_says_when_a_map_is_past_forty_cards_and_which_cards_to_open","test_the_check_runs_on_every_map_and_counts_coverage_once","test_the_exact_claim_rule_refuses_an_extra_and_a_missing_module"],"tests_primary":15,"tests_total":27,"uses":{"systemap.model":["Box","CARD_H","CARD_W","Model","Region"],"systemap.route":["place_labels","route_all"],"systemap.schematic":["HEADER_LINES","LABEL_CHAR","LABEL_CHAR_W","LABEL_H","SUB_CHAR","geometry","wrap_all"]}},
 "systemap.plan":{"classes":[{"methods":[],"name":"Around"},{"methods":["def as_json(self) -> dict[str, Any]"],"name":"Projection"}],"constants":[{"name":"CUT","value":"0.05"},{"name":"TEXT_CAP","value":"2000"},{"name":"PLAN_Q","value":"'`task` is a piece of work someone is about to do on this system. Which componen"}],"docstring":"A piece of work projected onto the map, and then checked against what happened.","errors":[],"external":[],"file":"src/systemap/plan.py","functions":[{"name":"named","signature":"def named(probabilities: dict[str, float], cut: float=CUT) -> list[str]"},{"name":"around","signature":"def around(model: Model, meaning: Meaning, card: str) -> Around"},{"name":"project","signature":"def project(model: Model, meaning: Meaning, task: str, probabilities: dict[str, float], at: str='') -> Projection"},{"name":"plan_id","signature":"def plan_id(task: str) -> str"},{"name":"path_of","signature":"def path_of(cfg: Config, plan: str) -> Path"},{"name":"save","signature":"def save(cfg: Config, projection: Projection) -> Path"},{"name":"load","signature":"def load(cfg: Config, plan: str) -> dict[str, Any] | None"},{"name":"saved","signature":"def saved(cfg: Config) -> list[str]"},{"name":"touched","signature":"def touched(base: dict[str, Any], head: dict[str, Any], owner: dict[str, str]) -> set[str]"},{"name":"check","signature":"def check(projected: list[str], changed: set[str]) -> tuple[list[str], list[str]]"}],"id":"systemap.plan","imported_by":["systemap.jev_cli"],"imports":["systemap.config","systemap.graph","systemap.model"],"loc":170,"names":[{"kind":"constant","name":"CUT"},{"kind":"constant","name":"TEXT_CAP"},{"kind":"constant","name":"PLAN_Q"},{"kind":"class","name":"Around"},{"kind":"class","name":"Projection"},{"kind":"function","name":"named"},{"kind":"function","name":"around"},{"kind":"function","name":"project"},{"kind":"function","name":"plan_id"},{"kind":"function","name":"path_of"},{"kind":"function","name":"save"},{"kind":"function","name":"load"},{"kind":"function","name":"saved"},{"kind":"function","name":"touched"},{"kind":"function","name":"check"}],"package":"systemap","plane":"core","sha":"69b3ab1f979e","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_task_no_card_answers_to_says_so_rather_than_guessing","test_a_task_with_nothing_to_name_it_by_still_gets_an_id","test_an_empty_task_asks_for_one_and_sends_nothing","test_only_the_cards_with_real_weight_are_named","test_the_cards_a_change_touched_are_read_from_the_facts","test_the_plan_names_its_cards_and_is_written_down","test_the_projection_keeps_the_task_the_weights_and_the_day","test_work_that_landed_where_it_was_projected_says_so"],"tests_primary":12,"tests_total":12,"uses":{"systemap.config":["Config"],"systemap.graph":["*"],"systemap.model":["Meaning","Model"]}},
 "systemap.route":{"classes":[{"methods":[],"name":"Route"},{"methods":[],"name":"Placed"},{"methods":["def size(self) -> float","def holds(self, centre: float) -> bool"],"name":"Gutter"},{"methods":["def route(self, src: str, dst: str) -> Route"],"name":"Router"}],"constants":[{"name":"CARD_MARGIN","value":"4.0"},{"name":"LANE_STEP","value":"9.0"},{"name":"LANE_EDGE","value":"11.0"},{"name":"MAX_LANES","value":"7"},{"name":"PORT_DX","value":"(0.0, -25.0, 25.0, -50.0, 50.0)"},{"name":"PORT_DY","value":"(0.0, -8.0, 8.0, -16.0, 16.0)"},{"name":"PORT_SPREAD_COST","value":"4.0"},{"name":"BEND_COST","value":"40.0"},{"name":"USED_LANE_FACTOR","value":"5.0"},{"name":"USED_PORT_COST","value":"500.0"},{"name":"FOREIGN_REGION_COST","value":"40.0"},{"name":"SIDES","value":"('left', 'right', 'top', 'bottom')"},{"name":"CARD_CLEAR","value":"3.0"},{"name":"SEAT_GAP","value":"2.0"}],"docstring":"Route every flow orthogonally through the gutters between cards.","errors":[],"external":[],"file":"src/systemap/route.py","functions":[{"name":"gutters","signature":"def gutters(cards: dict[str, Box], canvas: tuple[float, float]) -> tuple[list[Gutter], list[Gutter]]"},{"name":"seats","signature":"def seats(size: float, across: float) -> int"},{"name":"find_gutter","signature":"def find_gutter(bands: list[Gutter], centre: float) -> Gutter | None"},{"name":"locate","signature":"def locate(box: Box, horizontal: bool, rows: list[Gutter], cols: list[Gutter]) -> Gutter | None"},{"name":"route_all","signature":"def route_all(edges: list[tuple[str, str]], cards: dict[str, Box], actors: set[str], blocks: list[Box], regions: dict[str, Box], region_of: dict[str, str], canvas: tuple[float, float]) -> dict[int, Route]"},{"name":"path_d","signature":"def path_d(points: list[Point], radius: float=6.0) -> str"},{"name":"label_candidates","signature":"def label_candidates(points: list[Point], lw: float, lh: float, canvas: tuple[float, float]) -> list[tuple[int, bool, Box]]"},{"name":"place_labels","signature":"def place_labels(routes: dict[int, Route], widths: dict[int, float], lh: float, obstacles: list[tuple[str, Box]], canvas: tuple[float, float], gap: float=SEAT_GAP, names: dict[int, str] | None=None, cards: dict[str, Box] | None=None, region_of: dict[str, str] | None=None) -> dict[int, Placed]"}],"id":"systemap.route","imported_by":["systemap.describe","systemap.place","systemap.schematic"],"imports":[],"loc":819,"names":[{"kind":"object","name":"Box"},{"kind":"object","name":"Point"},{"kind":"constant","name":"CARD_MARGIN"},{"kind":"constant","name":"LANE_STEP"},{"kind":"constant","name":"LANE_EDGE"},{"kind":"constant","name":"MAX_LANES"},{"kind":"constant","name":"PORT_DX"},{"kind":"constant","name":"PORT_DY"},{"kind":"constant","name":"PORT_SPREAD_COST"},{"kind":"constant","name":"BEND_COST"},{"kind":"constant","name":"USED_LANE_FACTOR"},{"kind":"constant","name":"USED_PORT_COST"},{"kind":"constant","name":"FOREIGN_REGION_COST"},{"kind":"constant","name":"SIDES"},{"kind":"class","name":"Route"},{"kind":"class","name":"Placed"},{"kind":"constant","name":"CARD_CLEAR"},{"kind":"constant","name":"SEAT_GAP"},{"kind":"class","name":"Gutter"},{"kind":"object","name":"Run"},{"kind":"function","name":"gutters"},{"kind":"function","name":"seats"},{"kind":"function","name":"find_gutter"},{"kind":"function","name":"locate"},{"kind":"class","name":"Router"},{"kind":"function","name":"route_all"},{"kind":"function","name":"path_d"},{"kind":"constant","name":"CORNER_CLEAR"},{"kind":"constant","name":"ARROW_CLEAR"},{"kind":"constant","name":"PORT_CLEAR"},{"kind":"constant","name":"BESIDE"},{"kind":"constant","name":"GUTTER_OFFSETS"},{"kind":"constant","name":"T_ORDER"},{"kind":"function","name":"label_candidates"},{"kind":"function","name":"place_labels"}],"package":"systemap","plane":"core","sha":"d0ea4fbab7e1","tests":["test_a_full_gutter_names_its_seats_and_the_fix","test_a_label_collision_names_both_labels","test_a_label_with_no_seat_off_a_card_is_too_wide","test_actor_claims_no_code_and_is_not_checked","test_component_with_no_module_fails","test_describe_command","test_describe_reads_the_picture_back","test_entry_the_modules_do_not_define_fails","test_gutters_are_named_from_the_card_grid","test_header_labels_wider_than_the_box_and_headers_on_cards_are_refused","test_header_overflow_fails_check_and_refresh","test_header_sub_wraps_to_two_lines_and_is_refused_past_that","test_layout_reference_says_what_place_does_and_what_the_agent_decides","test_missing_entry_with_modules_present_fails","test_module_not_in_the_facts_fails","test_refresh_exits_1_when_the_check_fails_after_writing","test_root_is_accepted_after_the_subcommand","test_stale_facts_after_a_code_change","test_stale_figure_when_missing_or_edited","test_stale_page_after_a_model_change","test_stale_with_no_facts_names_extract","test_starter_corridors_route_every_pair_of_regions","test_starter_is_a_2x2_grid_with_corridors","test_starter_is_ruff_formatted_at_88_and_100_columns","test_svg_figure_is_the_bare_drawing_on_its_ground"],"tests_primary":0,"tests_total":27,"uses":{}},
-"systemap.scaffold":{"classes":[],"constants":[{"name":"CONFIG","value":"'# systemap configuration. Every key is optional; these are the defaults\\n# exce"},{"name":"MODEL","value":"'# ruff: noqa: E501\\n# The map is prose held in strings: a sentence per flow, a "},{"name":"WORKFLOW","value":"'name: systemap\\n\\n# The system map under docs/map is generated from the code an"},{"name":"TOOLING_NOTE","value":"('note: map/model.py imports systemap, a tool this repository runs and need not "}],"docstring":"What `systemap init` writes: a configuration, a starter model, a workflow.","errors":[],"external":[],"file":"src/systemap/scaffold.py","functions":[{"name":"files","signature":"def files(name: str, package: str, roots: list[tuple[str, str]], ci: bool=True) -> dict[str, str]"},{"name":"write","signature":"def write(root: Path, name: str, package: str, roots: list[tuple[str, str]], ci: bool=True) -> list[str]"}],"id":"systemap.scaffold","imported_by":["systemap.cli"],"imports":["systemap"],"loc":404,"names":[{"kind":"constant","name":"CONFIG"},{"kind":"constant","name":"MODEL"},{"kind":"constant","name":"WORKFLOW"},{"kind":"constant","name":"TOOLING_NOTE"},{"kind":"function","name":"files"},{"kind":"function","name":"write"}],"package":"systemap","plane":"core","sha":"e3e619fc0ecf","tests":["test_a_full_gutter_names_its_seats_and_the_fix","test_a_label_with_no_seat_off_a_card_is_too_wide","test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_describe_command","test_describe_reads_the_picture_back","test_extract_on_tiny_package_via_cli","test_figure_command","test_gutters_are_named_from_the_card_grid","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_layout_reference_says_what_place_does_and_what_the_agent_decides","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_stale_after_code_change","test_starter_corridors_route_every_pair_of_regions","test_starter_is_a_2x2_grid_with_corridors","test_starter_is_ruff_formatted_at_88_and_100_columns","test_the_collision_line_carries_the_fix"],"tests_primary":0,"tests_total":23,"uses":{"systemap":["__version__"]}},
+"systemap.scaffold":{"classes":[],"constants":[{"name":"CONFIG","value":"'# systemap configuration. Every key is optional; these are the defaults\\n# exce"},{"name":"MODEL","value":"'# ruff: noqa: E501\\n# The map is prose held in strings: a sentence per flow, a "},{"name":"WORKFLOW","value":"'name: systemap\\n\\n# The system map under docs/map is generated from the code an"},{"name":"TOOLING_NOTE","value":"('note: map/model.py imports systemap, a tool this repository runs and need not "}],"docstring":"What `systemap init` writes: a configuration, a starter model, a workflow.","errors":[],"external":[],"file":"src/systemap/scaffold.py","functions":[{"name":"files","signature":"def files(name: str, package: str, roots: list[tuple[str, str]], ci: bool=True, language: str='python') -> dict[str, str]"},{"name":"write","signature":"def write(root: Path, name: str, package: str, roots: list[tuple[str, str]], ci: bool=True, language: str='python') -> list[str]"}],"id":"systemap.scaffold","imported_by":["systemap.cli"],"imports":["systemap"],"loc":418,"names":[{"kind":"constant","name":"CONFIG"},{"kind":"constant","name":"MODEL"},{"kind":"constant","name":"WORKFLOW"},{"kind":"constant","name":"TOOLING_NOTE"},{"kind":"function","name":"files"},{"kind":"function","name":"write"}],"package":"systemap","plane":"core","sha":"3ea3f5246e82","tests":["test_a_full_gutter_names_its_seats_and_the_fix","test_a_label_with_no_seat_off_a_card_is_too_wide","test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_describe_command","test_describe_reads_the_picture_back","test_extract_on_tiny_package_via_cli","test_figure_command","test_gutters_are_named_from_the_card_grid","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_layout_reference_says_what_place_does_and_what_the_agent_decides","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_stale_after_code_change","test_starter_corridors_route_every_pair_of_regions","test_starter_is_a_2x2_grid_with_corridors","test_starter_is_ruff_formatted_at_88_and_100_columns","test_the_collision_line_carries_the_fix"],"tests_primary":0,"tests_total":23,"uses":{"systemap":["__version__"]}},
 "systemap.schematic":{"classes":[{"methods":[],"name":"Geometry"}],"constants":[{"name":"CARD_W","value":"150.0"},{"name":"RADIUS","value":"4.0"},{"name":"MAP_OFFSET","value":"3.0"},{"name":"TEXT_PX","value":"11.0"},{"name":"NAME_PX","value":"11.5"},{"name":"LABEL_PX","value":"TEXT_PX"},{"name":"LABEL_CHAR_W","value":"6.1"},{"name":"LABEL_H","value":"13.0"},{"name":"LABEL_GAP","value":"2.0"},{"name":"PLAIN_CHARS","value":"26"},{"name":"LABEL_CHAR","value":"7.6"},{"name":"SUB_CHAR","value":"5.6"},{"name":"HEADER_LINES","value":"2"},{"name":"NAME_CHARS","value":"20"}],"docstring":"Draw the logical view as a flat figure. One generator for every picture.","errors":[],"external":[],"file":"src/systemap/schematic.py","functions":[{"name":"esc","signature":"def esc(text: object) -> str"},{"name":"wrap_all","signature":"def wrap_all(text: str, width: int) -> list[str]"},{"name":"wrap_id","signature":"def wrap_id(cid: str, width: int) -> list[str]"},{"name":"card_text","signature":"def card_text(kind: str, cid: str, plain: str) -> tuple[list[str], list[str], list[str]]"},{"name":"lives_in","signature":"def lives_in(modules: list[str]) -> str"},{"name":"legend_rows","signature":"def legend_rows(t: dict[str, Any], mode: str, variables: bool=False) -> list[tuple[str, str, str]]"},{"name":"layer_rows","signature":"def layer_rows(t: dict[str, Any], model: Model, meaning: Meaning, variables: bool=False) -> list[tuple[str, str, str]]"},{"name":"kind_rows","signature":"def kind_rows(t: dict[str, Any], model: Model) -> list[tuple[str, str]]"},{"name":"container_header","signature":"def container_header(box: Container) -> tuple[Box, list[str], list[str]]"},{"name":"region_header","signature":"def region_header(region: Region) -> tuple[Box, list[str]]"},{"name":"geometry","signature":"def geometry(model: Model) -> Geometry"},{"name":"render","signature":"def render(model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], *, changed: set[str] | None=None, changed_modules: set[str] | None=None, adjacent: set[str] | None=None, mode: str='system', svg_id: str='schematic', gained: dict[str, dict[str, int]] | None=None, hot_artifacts: set[str] | None=None, layer: str='', observed_by: Iterable[str]=(), opens: Mapping[str, Mapping[str, Any]] | None=None, variables: bool=False) -> tuple[str, str]"},{"name":"panel_css","signature":"def panel_css(t: dict[str, Any], variables: bool=False) -> str"},{"name":"interactive_script","signature":"def interactive_script(t: dict[str, Any], svg_id: str, panel_id: str, detail_json: str, variables: bool=False) -> str"}],"id":"systemap.schematic","imported_by":["systemap.check","systemap.describe","systemap.figure","systemap.page","systemap.place"],"imports":["systemap.evidence","systemap.model","systemap.route","systemap.theme"],"loc":1919,"names":[{"kind":"constant","name":"CARD_W"},{"kind":"constant","name":"RADIUS"},{"kind":"constant","name":"MAP_OFFSET"},{"kind":"constant","name":"TEXT_PX"},{"kind":"constant","name":"NAME_PX"},{"kind":"constant","name":"LABEL_PX"},{"kind":"constant","name":"LABEL_CHAR_W"},{"kind":"constant","name":"LABEL_H"},{"kind":"constant","name":"LABEL_GAP"},{"kind":"constant","name":"PLAIN_CHARS"},{"kind":"object","name":"Box"},{"kind":"function","name":"esc"},{"kind":"function","name":"wrap_all"},{"kind":"constant","name":"LABEL_CHAR"},{"kind":"constant","name":"SUB_CHAR"},{"kind":"constant","name":"HEADER_LINES"},{"kind":"constant","name":"NAME_CHARS"},{"kind":"constant","name":"NAME_LINE_H"},{"kind":"constant","name":"TWO_LINE_NAME_KINDS"},{"kind":"function","name":"wrap_id"},{"kind":"function","name":"card_text"},{"kind":"function","name":"lives_in"},{"kind":"function","name":"legend_rows"},{"kind":"function","name":"layer_rows"},{"kind":"function","name":"kind_rows"},{"kind":"class","name":"Geometry"},{"kind":"function","name":"container_header"},{"kind":"function","name":"region_header"},{"kind":"function","name":"geometry"},{"kind":"function","name":"render"},{"kind":"function","name":"panel_css"},{"kind":"function","name":"interactive_script"}],"package":"systemap","plane":"core","sha":"c6e0754ac9d5","tests":["test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_flow_of_an_undeclared_kind_fails","test_a_full_gutter_names_its_seats_and_the_fix","test_a_label_collision_names_both_labels","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_layer_figure_holds_only_that_layers_edges","test_a_pick_restamps_the_root_and_is_kept","test_a_standalone_figure_keeps_literal_colours","test_a_symbol_card_needs_an_entry_among_its_symbols","test_a_symbol_claim_counts_as_a_defined_name","test_a_symbol_claim_passes_and_counts_for_no_module","test_a_symbol_of_a_module_nobody_claims_is_refused","test_a_symbol_the_module_does_not_define_is_refused","test_actor_claims_no_code_and_is_not_checked","test_agent_kinds_are_cards_that_claim_code","test_agent_layers_appear_only_with_an_agent","test_agent_model_checks_clean_and_draws_the_marks","test_an_interface_edit_renders_and_refresh_says_what_current_means","test_calls_model_in_the_model_module","test_card_text_budgets_by_kind","test_check_passes_on_sample","test_check_refuses_a_card_whose_text_does_not_fit","test_component_with_no_module_fails","test_configured_layer_figures_are_refreshed_and_checked"],"tests_primary":0,"tests_total":87,"uses":{"systemap.evidence":["*"],"systemap.model":["AGENT_KINDS","CARD_H","Container","DERIVED_LAYERS","Meaning","Model","Region","all_layers","build_state","entry_module","reading"],"systemap.route":["path_d","place_labels","route_all"],"systemap.theme":["Palette"]}},
-"systemap.skill":{"classes":[],"constants":[{"name":"DEFAULT_DIR","value":"'.claude/skills/systemap'"},{"name":"FILE_NAME","value":"'SKILL.md'"},{"name":"REFERENCES","value":"'references'"}],"docstring":"The agent skill: the procedure a coding agent follows to map a repository.","errors":[],"external":[],"file":"src/systemap/skill.py","functions":[{"name":"files","signature":"def files() -> dict[str, str]"},{"name":"text","signature":"def text() -> str"},{"name":"write","signature":"def write(directory: Path) -> Path"}],"id":"systemap.skill","imported_by":["systemap.cli"],"imports":[],"loc":61,"names":[{"kind":"constant","name":"DEFAULT_DIR"},{"kind":"constant","name":"FILE_NAME"},{"kind":"constant","name":"REFERENCES"},{"kind":"function","name":"files"},{"kind":"function","name":"text"},{"kind":"function","name":"write"}],"package":"systemap","plane":"core","sha":"67a0e1886182","tests":["test_layers_reference_covers_the_agentic_kinds","test_schema_defines_state_the_wheel_and_the_pair_rule","test_skill_front_matter_and_vocabulary","test_step_four_lists_every_answer_form_and_every_line_kind","test_the_document_reread_is_bounded","test_worked_example_passes_check","test_write_installs_the_directory_and_removes_a_stale_reference","test_a_full_gutter_names_its_seats_and_the_fix","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_package_init_records_the_names_it_reexports","test_calls_model_in_the_model_module","test_camel_ids","test_context_and_tool_flows_accept_a_calls_model_component","test_describe_command","test_describe_reads_the_picture_back","test_drift_reports_changes","test_drift_sees_an_entry_point_change","test_entry_is_optional_for_store_and_context_kinds","test_entry_may_be_any_public_name","test_entry_points_view_prints_the_target_beside_each","test_extract_attributes_tests_to_modules","test_extract_finds_modules_and_public_surface","test_extract_records_entry_points","test_extract_records_every_public_name_with_its_kind_and_the_external_imports","test_facts_command_views"],"tests_primary":7,"tests_total":52,"uses":{}},
+"systemap.skill":{"classes":[],"constants":[{"name":"DEFAULT_DIR","value":"'.claude/skills/systemap'"},{"name":"FILE_NAME","value":"'SKILL.md'"},{"name":"REFERENCES","value":"'references'"}],"docstring":"The agent skill: the procedure a coding agent follows to map a repository.","errors":[],"external":[],"file":"src/systemap/skill.py","functions":[{"name":"files","signature":"def files() -> dict[str, str]"},{"name":"text","signature":"def text() -> str"},{"name":"write","signature":"def write(directory: Path) -> Path"}],"id":"systemap.skill","imported_by":["systemap.cli"],"imports":[],"loc":61,"names":[{"kind":"constant","name":"DEFAULT_DIR"},{"kind":"constant","name":"FILE_NAME"},{"kind":"constant","name":"REFERENCES"},{"kind":"function","name":"files"},{"kind":"function","name":"text"},{"kind":"function","name":"write"}],"package":"systemap","plane":"core","sha":"67a0e1886182","tests":["test_layers_reference_covers_the_agentic_kinds","test_schema_defines_state_the_wheel_and_the_pair_rule","test_skill_front_matter_and_vocabulary","test_step_four_lists_every_answer_form_and_every_line_kind","test_the_document_reread_is_bounded","test_worked_example_passes_check","test_write_installs_the_directory_and_removes_a_stale_reference","test_a_full_gutter_names_its_seats_and_the_fix","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_package_init_records_the_names_it_reexports","test_calls_model_in_the_model_module","test_camel_ids","test_context_and_tool_flows_accept_a_calls_model_component","test_describe_command","test_describe_reads_the_picture_back","test_drift_reports_changes","test_drift_sees_an_entry_point_change","test_entry_is_optional_for_store_and_context_kinds","test_entry_may_be_any_public_name","test_entry_points_view_prints_the_target_beside_each","test_extract_attributes_tests_to_modules","test_extract_finds_modules_and_public_surface","test_extract_records_entry_points","test_extract_records_every_public_name_with_its_kind_and_the_external_imports","test_facts_command_views"],"tests_primary":7,"tests_total":54,"uses":{}},
 "systemap.suggest":{"classes":[{"methods":[],"name":"Proposal"}],"constants":[{"name":"SPLIT_ABOVE","value":"10"},{"name":"HEADER","value":"('suggest: a first grouping to revise, not the answer', '  one proposal per pack"}],"docstring":"A first grouping to argue with: what `systemap suggest` prints.","errors":[],"external":[],"file":"src/systemap/suggest.py","functions":[{"name":"package_of","signature":"def package_of(module: str, record: dict[str, Any]) -> str"},{"name":"camel","signature":"def camel(dotted: str, whole: bool=False) -> str"},{"name":"proposals","signature":"def proposals(facts: dict[str, Any]) -> tuple[list[Proposal], list[str]]"},{"name":"crossings","signature":"def crossings(facts: dict[str, Any], groups: list[Proposal]) -> list[tuple[str, str, list[str]]]"},{"name":"lines","signature":"def lines(facts: dict[str, Any]) -> list[str]"},{"name":"nesting_lines","signature":"def nesting_lines(tree: nest.Tree, facts: dict[str, Any]) -> list[str]"}],"id":"systemap.suggest","imported_by":["systemap.cli"],"imports":["systemap.extract","systemap.model","systemap.nest"],"loc":184,"names":[{"kind":"constant","name":"SPLIT_ABOVE"},{"kind":"constant","name":"HEADER"},{"kind":"class","name":"Proposal"},{"kind":"function","name":"package_of"},{"kind":"function","name":"camel"},{"kind":"function","name":"proposals"},{"kind":"function","name":"crossings"},{"kind":"function","name":"lines"},{"kind":"function","name":"nesting_lines"}],"package":"systemap","plane":"core","sha":"2ffde20a7faa","tests":["test_camel_ids","test_proposals_on_the_workspace_fixture","test_suggest_command_lists_crossings_between_proposals","test_the_skill_states_the_target_and_runs_suggest_and_the_check_together","test_two_packages_that_shorten_to_one_id_keep_their_path","test_a_sub_maps_actors_are_cards_of_the_parent","test_delta_names_the_card_and_the_map_a_moved_module_belongs_to","test_figure_draws_one_map_by_id","test_judgement_and_describe_lines_carry_the_maps_id","test_pages_are_written_per_map_with_the_links_up_and_down","test_place_writes_into_a_sub_maps_file","test_suggest_reads_the_tree_from_the_command","test_suggest_says_when_a_map_is_past_forty_cards_and_which_cards_to_open","test_the_check_runs_on_every_map_and_counts_coverage_once","test_the_exact_claim_rule_refuses_an_extra_and_a_missing_module","test_the_map_inside_a_card_opens_in_place","test_the_page_names_the_commit_the_facts_are_from"],"tests_primary":5,"tests_total":17,"uses":{"systemap.extract":["empty_markers","is_empty_marker"],"systemap.model":["claimed"],"systemap.nest":["*"]}},
 "systemap.theme":{"classes":[{"methods":["def layer(self, lid: str) -> str","def tag(self, lid: str) -> str","def state(self, name: str) -> tuple[str, str, str]","def actor(self) -> tuple[str, str]","def ghost(self) -> tuple[str, str]","def container(self, tone: str) -> tuple[str, str]","def delta(self, key: str) -> str","def changed_fill(self) -> str","def reach_fill(self) -> str"],"name":"Palette"}],"constants":[{"name":"MARKS","value":"('ring', 'notch', 'dotted')"},{"name":"KIND_MARKS","value":"{'agent': 'ring', 'tool': 'notch', 'context': 'dotted'}"},{"name":"SANS","value":"'ui-sans-serif,system-ui,-apple-system,\"SF Pro Text\",\"Segoe UI\",Roboto,\"Helvetic"},{"name":"MONO","value":"'ui-monospace,\"SF Mono\",SFMono-Regular,\"JetBrains Mono\",Menlo,Consolas,monospace"},{"name":"WARM_GROUND","value":"'#161310'"},{"name":"WARM_INK","value":"'#ece5d8'"},{"name":"WARM_AMBER","value":"'#e5a84f'"},{"name":"GRAPHITE_GROUND","value":"'#121417'"},{"name":"GRAPHITE_INK","value":"'#e6e4df'"},{"name":"GRAPHITE_AMBER","value":"'#e0a458'"},{"name":"PAPER_GROUND","value":"'#f4f2ee'"},{"name":"PAPER_INK","value":"'#1d2024'"},{"name":"PAPER_AMBER","value":"'#905c1a'"},{"name":"STANDARD_LAYERS_WARM","value":"{'structure': '#d9cdb2', 'system': '#82a7ba', 'data': '#e39a86', 'control': '#dd"}],"docstring":"The map's look, as one table of tokens per scheme.","errors":[],"external":[],"file":"src/systemap/theme.py","functions":[{"name":"merge","signature":"def merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]"},{"name":"scheme_name","signature":"def scheme_name(tokens: dict[str, Any]) -> str"},{"name":"resolve","signature":"def resolve(tokens: dict[str, Any], layers: Iterable[Layer]) -> dict[str, Any]"},{"name":"mix","signature":"def mix(a: str, b: str, t: float) -> str"},{"name":"tints","signature":"def tints(t: dict[str, Any]) -> dict[str, Any]"},{"name":"root_css","signature":"def root_css(t: dict[str, Any]) -> str"},{"name":"css_vars","signature":"def css_vars(t: dict[str, Any]) -> str"}],"id":"systemap.theme","imported_by":["systemap.nest","systemap.page","systemap.schematic"],"imports":["systemap.model"],"loc":521,"names":[{"kind":"constant","name":"MARKS"},{"kind":"constant","name":"KIND_MARKS"},{"kind":"constant","name":"SANS"},{"kind":"constant","name":"MONO"},{"kind":"constant","name":"WARM_GROUND"},{"kind":"constant","name":"WARM_INK"},{"kind":"constant","name":"WARM_AMBER"},{"kind":"constant","name":"GRAPHITE_GROUND"},{"kind":"constant","name":"GRAPHITE_INK"},{"kind":"constant","name":"GRAPHITE_AMBER"},{"kind":"constant","name":"PAPER_GROUND"},{"kind":"constant","name":"PAPER_INK"},{"kind":"constant","name":"PAPER_AMBER"},{"kind":"constant","name":"STANDARD_LAYERS_WARM"},{"kind":"constant","name":"LAYER_PALETTE_WARM"},{"kind":"constant","name":"STANDARD_LAYERS_GRAPHITE"},{"kind":"constant","name":"LAYER_PALETTE_GRAPHITE"},{"kind":"constant","name":"STANDARD_LAYERS_PAPER"},{"kind":"constant","name":"LAYER_PALETTE_PAPER"},{"kind":"constant","name":"WARM"},{"kind":"constant","name":"GRAPHITE"},{"kind":"constant","name":"PAPER"},{"kind":"constant","name":"SCHEMES"},{"kind":"constant","name":"ALIASES"},{"kind":"constant","name":"DEFAULT_SCHEME"},{"kind":"constant","name":"LIGHT_SCHEME"},{"kind":"constant","name":"TEXT_TOKENS"},{"kind":"function","name":"merge"},{"kind":"function","name":"scheme_name"},{"kind":"function","name":"resolve"},{"kind":"function","name":"mix"},{"kind":"constant","name":"CSS_NAMES"},{"kind":"constant","name":"ACTOR_MIX"},{"kind":"constant","name":"CHANGED_MIX"},{"kind":"constant","name":"REACH_MIX"},{"kind":"constant","name":"TAG_MIX"},{"kind":"function","name":"tints"},{"kind":"class","name":"Palette"},{"kind":"function","name":"root_css"},{"kind":"function","name":"css_vars"}],"package":"systemap","plane":"core","sha":"06537854b376","tests":["test_a_pick_restamps_the_root_and_is_kept","test_a_standalone_figure_keeps_literal_colours","test_contrast_is_the_wcag_formula","test_every_scheme_clears_the_text_floor_on_every_surface","test_every_text_token_clears_four_and_a_half_to_one_on_its_ground","test_overrides_apply_per_scheme_and_bare_keys_to_the_default","test_the_change_map_draws_through_variables_only","test_the_page_carries_every_scheme_and_stamps_the_default","test_the_page_draws_through_variables_only","test_the_palette_answers_one_table_two_ways","test_the_scheme_on_load","test_the_schemes_are_three_full_tables_and_the_default_is_warm","test_the_self_map_page_stamps_warm_and_switches","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_flow_of_an_undeclared_kind_fails","test_a_label_collision_names_both_labels","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_positioned_card_stays_where_it_was","test_actor_claims_no_code_and_is_not_checked","test_agent_kinds_are_cards_that_claim_code","test_agent_layers_appear_only_with_an_agent","test_agent_model_checks_clean_and_draws_the_marks","test_calls_model_in_the_model_module","test_check_passes_on_sample","test_check_refuses_a_card_without_a_position"],"tests_primary":13,"tests_total":80,"uses":{"systemap.model":["Layer"]}},
 "systemap.trend":{"classes":[{"methods":[],"name":"Sample"},{"methods":["def size(self) -> int"],"name":"Window"}],"constants":[{"name":"FILES_ASKED","value":"60"}],"docstring":"The system over a year, read in today's cards.","errors":[],"external":[],"file":"src/systemap/trend.py","functions":[{"name":"sample_at","signature":"def sample_at(cfg: Config, model: Model, sha: str) -> Sample"},{"name":"between","signature":"def between(before: Sample, now: Sample) -> Window"},{"name":"walk","signature":"def walk(cfg: Config, model: Model, shas: list[str]) -> list[Window]"},{"name":"with_causes","signature":"def with_causes(root: Path, window: Window, cap: int=5) -> Window"},{"name":"report","signature":"def report(windows: list[Window], root: Path, since: str, every: int, top: int) -> list[str]"}],"id":"systemap.trend","imported_by":["systemap.cli"],"imports":["systemap.config","systemap.evidence","systemap.history","systemap.model"],"loc":210,"names":[{"kind":"constant","name":"FILES_ASKED"},{"kind":"class","name":"Sample"},{"kind":"class","name":"Window"},{"kind":"function","name":"sample_at"},{"kind":"function","name":"between"},{"kind":"function","name":"walk"},{"kind":"function","name":"with_causes"},{"kind":"function","name":"report"}],"package":"systemap","plane":"core","sha":"be53ff3c5e41","tests":["test_a_card_that_grew_is_counted_in_todays_cards","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_quiet_stretch_says_so_rather_than_printing_a_chart","test_one_commit_is_not_a_trend","test_the_command_prints_the_largest_windows_and_what_wrote_them","test_the_facts_at_a_commit_are_read_once","test_the_window_names_the_commit_that_wrote_the_new_modules"],"tests_primary":7,"tests_total":7,"uses":{"systemap.config":["Config"],"systemap.evidence":["owners"],"systemap.history":["*"],"systemap.model":["Model"]}},
+"systemap.typescript":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str]) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"TypeScriptLanguage"}],"constants":[{"name":"SOURCE_SUFFIXES","value":"('.ts', '.tsx')"},{"name":"TEST_SUFFIXES","value":"('.test.ts', '.test.tsx', '.spec.ts', '.spec.tsx')"},{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', 'build', 'dist'}"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"WHOLE_MODULE","value":"'*'"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"TESTS_KEPT","value":"25"},{"name":"TSX","value":"Language(tree_sitter_typescript.language_tsx())"},{"name":"TYPESCRIPT","value":"TypeScriptLanguage()"}],"docstring":"Read TypeScript and TSX into systemap's language-neutral facts.","errors":[],"external":["tree_sitter","tree_sitter_typescript"],"file":"src/systemap/typescript.py","functions":[{"name":"parse_surface","signature":"def parse_surface(raw: str, path: str='') -> dict[str, Any] | None"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"}],"id":"systemap.typescript","imported_by":["systemap.extract"],"imports":[],"loc":470,"names":[{"kind":"constant","name":"SOURCE_SUFFIXES"},{"kind":"constant","name":"TEST_SUFFIXES"},{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"object","name":"TS"},{"kind":"constant","name":"TSX"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"test_names"},{"kind":"class","name":"TypeScriptLanguage"},{"kind":"constant","name":"TYPESCRIPT"}],"package":"systemap","plane":"core","sha":"09627ce31313","tests":["test_init_detects_a_typescript_repository","test_typescript_extracts_surface_imports_tests_and_entry_points","test_typescript_roots_are_discovered_from_package_metadata","test_typescript_surface_and_change_use_the_same_parser","test_typescript_test_names_are_literal_and_nested"],"tests_primary":5,"tests_total":5,"uses":{}},
 "systemap.ways_in":{"classes":[],"constants":[{"name":"HTTP_METHODS","value":"('get', 'post', 'put', 'patch', 'delete', 'head', 'options')"},{"name":"COMMAND_DECORATORS","value":"('command', 'group')"},{"name":"TASK_DECORATORS","value":"('task', 'shared_task', 'periodic_task')"},{"name":"ROUTE_CALLS","value":"('path', 're_path', 'url')"}],"docstring":"The ways into a system: routes, commands, tasks and plugin hooks, read from the source.","errors":[],"external":[],"file":"src/systemap/ways_in.py","functions":[{"name":"in_source","signature":"def in_source(module: str, source: str) -> list[dict[str, str]]"},{"name":"in_pyproject","signature":"def in_pyproject(data: dict[str, Any], components: dict[str, Any]) -> list[dict[str, str]]"},{"name":"label","signature":"def label(point: dict[str, str]) -> str"},{"name":"read_pyproject","signature":"def read_pyproject(repo: Path) -> dict[str, Any]"}],"id":"systemap.ways_in","imported_by":["systemap.extract"],"imports":[],"loc":246,"names":[{"kind":"constant","name":"HTTP_METHODS"},{"kind":"constant","name":"COMMAND_DECORATORS"},{"kind":"constant","name":"TASK_DECORATORS"},{"kind":"constant","name":"ROUTE_CALLS"},{"kind":"function","name":"in_source"},{"kind":"function","name":"in_pyproject"},{"kind":"function","name":"label"},{"kind":"function","name":"read_pyproject"}],"package":"systemap","plane":"core","sha":"0f8b97181299","tests":["test_a_card_that_takes_a_crowd_of_routes_is_asked_once","test_a_decorator_that_is_not_a_way_in_is_not_one","test_a_journey_covers_the_way_in_it_names_in_starts","test_a_journey_that_starts_nowhere_says_so","test_background_tasks_are_ways_in_too","test_commands_are_read_from_click_typer_cleo_and_django","test_django_routes_come_from_the_urlpatterns_table","test_each_way_in_is_named_the_way_a_person_would_name_it","test_poetry_scripts_and_plugin_hooks_are_read_from_pyproject","test_web_routes_are_read_with_their_method_and_path"],"tests_primary":10,"tests_total":10,"uses":{}}
 },
 "entry_points":[{"kind":"console_script","module":"systemap.cli","name":"systemap","target":"main"},{"kind":"main_module","module":"systemap.__main__","name":"python -m systemap","target":""},{"kind":"main_function","module":"systemap.cli","name":"main","target":"main"},{"kind":"subcommand","module":"systemap.cli","name":"init","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"extract","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"facts","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"place","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"render","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"check","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"figure","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"refresh","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"judgement","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"delta","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"suggest","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"describe","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"history","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"explain","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"serve","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"skill","target":"systemap"},{"kind":"subcommand","module":"systemap.jev_cli","name":"audit","target":""},{"kind":"subcommand","module":"systemap.jev_cli","name":"journeys","target":""},{"kind":"subcommand","module":"systemap.jev_cli","name":"plan","target":""},{"kind":"subcommand","module":"systemap.jev_cli","name":"triage","target":""}],
diff --git a/docs/reference.md b/docs/reference.md
index 0d3a7fc4..6b3a529c 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -461,8 +461,9 @@ Reinstalls the skill directory that `init` writes: `SKILL.md` and
 
 | key | default | meaning |
 |---|---|---|
+| `language` | `python` | source language: `python` or `typescript`; `init` detects an unambiguous TypeScript repository |
 | `name` | `[project] name`, then the git repository's directory, then the directory name | the page title |
-| `[package_roots]` | every top-level package or `src/<pkg>`, in the root and in every `[tool.uv.workspace]` member | `"path" = "import name"` |
+| `[package_roots]` | Python packages; for TypeScript, `src` then the repository root | `"path" = "module name"` |
 | `tests_dir` | every directory named `tests` or `test` | one directory or a list; tests that import a module count as its guards |
 | `model` | `map/model.py` | the module exporting `MODEL` and `MEANING`; its own directory is on the path while it runs, so a long map can keep its journeys or a region's cards in a module beside it (`import journeys`) and nothing it imports is kept between runs |
 | `out_dir` | `docs/map` | where the facts, the page and the figures go |
diff --git a/map/model.py b/map/model.py
index c06c951c..5d32bbcc 100644
--- a/map/model.py
+++ b/map/model.py
@@ -135,7 +135,13 @@
         id="FactsExtractor",
         does="Walks the package's syntax tree and writes the facts: every module, its public surface and every public name, what it imports inside and outside the package, the tests that import it, and where a run can start. Nothing anyone writes changes what it finds; systemap facts reads them back one view at a time.",
         interface="build(cfg) -> facts; drift(fresh, stored) -> what no longer matches",
-        implemented_by=("systemap.extract", "systemap.facts", "systemap.ways_in"),
+        implemented_by=(
+            "systemap.extract",
+            "systemap.facts",
+            "systemap.language",
+            "systemap.typescript",
+            "systemap.ways_in",
+        ),
         entry="build",
         region="gather",
         x=698,
diff --git a/pyproject.toml b/pyproject.toml
index 040a65de..5f2427ec 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,7 +21,10 @@ classifiers = [
     "Topic :: Documentation",
     "Topic :: Software Development :: Documentation",
 ]
-dependencies = []
+dependencies = [
+    "tree-sitter>=0.25,<0.27",
+    "tree-sitter-typescript>=0.23,<0.24",
+]
 
 [project.urls]
 Homepage = "https://github.com/0xfauzi/systemap"
@@ -40,6 +43,7 @@ packages = ["src/systemap"]
 [dependency-groups]
 dev = [
     "mypy>=1.10",
+    "pre-commit>=4,<5",
     "pytest>=8",
     "ruff>=0.5",
 ]
diff --git a/src/systemap/change.py b/src/systemap/change.py
index 1c24d9d4..93787c55 100644
--- a/src/systemap/change.py
+++ b/src/systemap/change.py
@@ -28,14 +28,10 @@
 from pathlib import Path
 from typing import Any
 
+from systemap import extract
 from systemap.config import Config
-from systemap.extract import (
-    WHOLE_MODULE,
-    internal_uses,
-    module_of,
-    parse_surface,
-    test_names,
-)
+from systemap.extract import WHOLE_MODULE
+from systemap.language import LanguageAdapter
 from systemap.model import Model, module_matches
 
 # `gained` carries only the buckets the schematic's segmented bar draws
@@ -81,28 +77,6 @@ def _changed_files(repo: Path, merge_base: str, head: str) -> list[str]:
     return [f for f in out.split("\0") if f]
 
 
-def _path_module(repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None:
-    """The dotted module a repo-relative path implements, or None.
-
-    Derived from the path alone so a file DELETED by the branch still maps:
-    the facts are built from the head tree and cannot know a module that is
-    gone from it.
-    """
-    if not path.endswith(".py"):
-        return None
-    absolute = repo / path
-    for pkg_dir, pkg_name in roots:
-        if absolute.is_relative_to(pkg_dir):
-            return module_of(absolute, pkg_dir, pkg_name)
-    return None
-
-
-def _is_test_file(path: str, tests_dirs: tuple[str, ...]) -> bool:
-    if not path.endswith(".py") or not path.split("/")[-1].startswith("test_"):
-        return False
-    return any(rel and path.startswith(rel.rstrip("/") + "/") for rel in tests_dirs)
-
-
 def _empty_surface() -> dict[str, Any]:
     return {"functions": [], "classes": [], "errors": [], "constants": []}
 
@@ -117,14 +91,19 @@ def _identity(surface: dict[str, Any]) -> dict[str, dict[str, str]]:
     }
 
 
-def surface_delta(base_raw: str, head_raw: str) -> dict[str, Any] | None:
+def surface_delta(
+    base_raw: str,
+    head_raw: str,
+    language: LanguageAdapter = extract.PYTHON,
+    path: str = "",
+) -> dict[str, Any] | None:
     """What one module's public surface gained, lost, and changed.
 
     None means a side had source that does not parse, which is "cannot tell",
     never "nothing changed".
     """
-    base = parse_surface(base_raw) if base_raw else _empty_surface()
-    head = parse_surface(head_raw) if head_raw else _empty_surface()
+    base = language.parse_surface(base_raw, path) if base_raw else _empty_surface()
+    head = language.parse_surface(head_raw, path) if head_raw else _empty_surface()
     if base is None or head is None:
         return None
     before, after = _identity(base), _identity(head)
@@ -170,6 +149,7 @@ def compute(
     """
     repo = cfg.root
     roots = cfg.roots
+    language = extract.language_for(cfg)
     if artifact_owner is None:
         artifact_owner = {}
 
@@ -198,10 +178,12 @@ def compute(
     deltas: dict[str, dict[str, Any]] = {}
     unparsed: list[str] = []
     for path in files:
-        module = _path_module(repo, path, roots)
-        if not module or _is_test_file(path, cfg.test_dirs):
+        module = language.module_for_path(repo, path, roots)
+        if not module or language.is_test_file(path, cfg.test_dirs):
             continue
-        delta = surface_delta(_show(repo, merge_base, path), _show(repo, head, path))
+        delta = surface_delta(
+            _show(repo, merge_base, path), _show(repo, head, path), language, path
+        )
         if delta is None:
             unparsed.append(module)
             continue
@@ -215,16 +197,16 @@ def compute(
     tests_added: dict[str, set[str]] = {}
     tests_removed: dict[str, set[str]] = {}
     for path in files:
-        if not _is_test_file(path, cfg.test_dirs):
+        if not language.is_test_file(path, cfg.test_dirs):
             continue
         base_raw = _show(repo, merge_base, path)
         head_raw = _show(repo, head, path)
-        before_t, after_t = set(test_names(base_raw)), set(test_names(head_raw))
+        before_t, after_t = set(language.test_names(base_raw)), set(language.test_names(head_raw))
         if before_t == after_t:
             continue
         targets: set[str] = set()
         for raw in (base_raw, head_raw):
-            targets |= set(internal_uses(raw, prefixes, known))
+            targets |= set(language.internal_uses(raw, prefixes, known))
         for target in targets:
             tests_added.setdefault(target, set()).update(after_t - before_t)
             tests_removed.setdefault(target, set()).update(before_t - after_t)
diff --git a/src/systemap/cli.py b/src/systemap/cli.py
index d3b56e0a..4f51dc0c 100644
--- a/src/systemap/cli.py
+++ b/src/systemap/cli.py
@@ -133,10 +133,13 @@ def _project(args: argparse.Namespace) -> Project:
 
 def cmd_init(args: argparse.Namespace) -> int:
     root = Path(args.root).resolve() if args.root else Path.cwd().resolve()
-    roots = config.discover_roots(root)
+    python_roots = config.discover_roots(root)
+    typescript_roots = config.discover_typescript_roots(root)
+    language = "typescript" if typescript_roots and not python_roots else "python"
+    roots = typescript_roots if language == "typescript" else python_roots
     package = roots[0][1] if roots else "mypackage"
     name = args.name or config.default_name(root)
-    say(*scaffold.write(root, name, package, roots, ci=not args.no_ci))
+    say(*scaffold.write(root, name, package, roots, ci=not args.no_ci, language=language))
     skill_path = skill.write(root / skill.DEFAULT_DIR)
     references = len(skill.files()) - 1
     say(
@@ -153,6 +156,11 @@ def cmd_init(args: argparse.Namespace) -> int:
 
 def _require_roots(p: Project) -> None:
     if not p.cfg.roots:
+        if p.cfg.language == "typescript":
+            raise ConfigError(
+                "no package roots found; set [package_roots] in systemap.toml "
+                '("path" = "module name"); no .ts or .tsx source in src or the repository root'
+            )
         found = config.candidate_packages(p.cfg.root)
         where = (
             "directories holding an __init__.py: " + ", ".join(found)
diff --git a/src/systemap/config.py b/src/systemap/config.py
index 5813b11f..a1c0215a 100644
--- a/src/systemap/config.py
+++ b/src/systemap/config.py
@@ -5,13 +5,13 @@
 are, where the tests are, where the model module is, where the output
 goes, and the theme.
 
+    language       source language: "python" (default) or "typescript"
     name           the page title; defaults to [project] name in
                    pyproject.toml, then the name of the directory holding
                    the git repository (the main checkout, even from a
                    worktree), then the directory's name
-    package_roots  table of path = import name; default: every top-level
-                   directory (or src/<dir>) that holds an __init__.py, in
-                   the root and in every [tool.uv.workspace] member
+    package_roots  table of path = import name; Python defaults to every
+                   package directory; TypeScript defaults to src, then root
     tests_dir      where test_*.py files live: one directory or a list;
                    default: every directory named tests or test under the
                    root, outside the skipped directories
@@ -66,6 +66,7 @@
 
 import contextlib
 import dataclasses
+import json
 import os
 import subprocess
 import sys
@@ -87,6 +88,7 @@
 CANDIDATE_DEPTH = 4
 
 KNOWN_KEYS = {
+    "language",
     "name",
     "package_roots",
     "tests_dir",
@@ -206,6 +208,7 @@ class Config:
     root: Path
     name: str
     package_roots: tuple[tuple[str, str], ...]
+    language: str = "python"
     tests_dirs: tuple[str, ...] = ()
     model: str = "map/model.py"
     out_dir: str = "docs/map"
@@ -304,6 +307,32 @@ def _pyproject(root: Path) -> dict[str, Any]:
         return {}
 
 
+def _package_json(root: Path) -> dict[str, Any]:
+    path = root / "package.json"
+    if not path.is_file():
+        return {}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return {}
+    return dict(data) if isinstance(data, dict) else {}
+
+
+def _typescript_name(root: Path) -> str:
+    name = _package_json(root).get("name")
+    if not isinstance(name, str) or not name.strip():
+        return root.name.replace("-", "_")
+    return name.strip().removeprefix("@").replace("/", ".").replace("-", "_")
+
+
+def discover_typescript_roots(root: Path) -> list[tuple[str, str]]:
+    """The conventional TypeScript source root, when it contains source."""
+    for candidate in (root / "src", root):
+        if any(candidate.glob("*.ts")) or any(candidate.glob("*.tsx")):
+            return [(candidate.relative_to(root).as_posix() or ".", _typescript_name(root))]
+    return []
+
+
 def workspace_members(root: Path) -> list[Path]:
     """The directories `[tool.uv.workspace] members` names, by its globs."""
     workspace = _pyproject(root).get("tool", {}).get("uv", {}).get("workspace", {})
@@ -458,9 +487,16 @@ def load(root: Path) -> Config:
             f"{where}: unknown key{'s' if len(unknown) > 1 else ''}: {', '.join(unknown)}"
         )
 
+    language = _str(raw, "language", "python", where)
+    if language not in ("python", "typescript"):
+        raise ConfigError(f'{where}: language must be "python" or "typescript"')
+
     roots_raw = raw.get("package_roots")
     if roots_raw is None:
-        package_roots = tuple(discover_roots(root))
+        discovered = (
+            discover_typescript_roots(root) if language == "typescript" else discover_roots(root)
+        )
+        package_roots = tuple(discovered)
     elif isinstance(roots_raw, dict) and all(
         isinstance(k, str) and isinstance(v, str) for k, v in roots_raw.items()
     ):
@@ -522,6 +558,7 @@ def load(root: Path) -> Config:
         root=root,
         name=_str(raw, "name", "", where) or default_name(root),
         package_roots=package_roots,
+        language=language,
         tests_dirs=tests_dirs,
         model=_str(raw, "model", "map/model.py", where),
         out_dir=_str(raw, "out_dir", "docs/map", where),
diff --git a/src/systemap/extract.py b/src/systemap/extract.py
index 36e62ea9..21c23826 100644
--- a/src/systemap/extract.py
+++ b/src/systemap/extract.py
@@ -22,12 +22,13 @@
 import subprocess
 import sys
 from collections import defaultdict
-from collections.abc import Mapping
+from collections.abc import Iterable, Mapping
 from pathlib import Path
 from typing import Any
 
 from systemap import ways_in
 from systemap.config import Config
+from systemap.language import LanguageAdapter
 from systemap.model import Model, is_symbol, module_matches, public_names
 
 SKIP_PARTS = {".git", ".venv", "node_modules", "__pycache__", "build", "dist"}
@@ -38,6 +39,94 @@
 CONSTANTS_KEPT = 14
 UPPER_NAME = re.compile(r"[A-Z][A-Z0-9_]{2,}")
 
+
+class PythonLanguage:
+    """Python syntax as the language-neutral extractor asks to read it."""
+
+    name = "python"
+
+    def source_paths(self, root: Path) -> Iterable[Path]:
+        return root.rglob("*.py")
+
+    def module_of(self, path: Path, root: Path, name: str) -> str:
+        return module_of(path, root, name)
+
+    def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None:
+        if not path.endswith(".py"):
+            return None
+        absolute = repo / path
+        for package, name in roots:
+            if absolute.is_relative_to(package):
+                return module_of(absolute, package, name)
+        return None
+
+    def collect_module(
+        self,
+        path: Path,
+        repo: Path,
+        module: str,
+        prefixes: frozenset[str],
+        known: set[str],
+    ) -> dict[str, Any] | None:
+        return collect_module(path, repo, module, prefixes)
+
+    def internal_uses(
+        self,
+        raw: str,
+        prefixes: set[str],
+        known: set[str],
+        module: str = "",
+        is_package: bool = False,
+    ) -> dict[str, set[str]]:
+        return internal_uses(raw, prefixes, known, module, is_package)
+
+    def external_imports(self, raw: str, prefixes: set[str]) -> list[str]:
+        return external_imports(raw, prefixes)
+
+    def collect_tests(
+        self,
+        repo: Path,
+        tests_dirs: tuple[str, ...],
+        prefixes: set[str],
+        paths: dict[str, Path],
+    ) -> dict[str, list[dict[str, Any]]]:
+        return collect_tests(repo, tests_dirs, prefixes, set(paths))
+
+    def entry_points(
+        self,
+        repo: Path,
+        prefixes: set[str],
+        components: dict[str, Any],
+        sources: dict[str, str],
+    ) -> list[dict[str, str]]:
+        return entry_points(repo, prefixes, components, sources)
+
+    def parse_surface(self, raw: str, path: str = "") -> dict[str, Any] | None:
+        return parse_surface(raw)
+
+    def test_names(self, raw: str) -> list[str]:
+        return test_names(raw)
+
+    def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool:
+        if not path.endswith(".py") or not path.split("/")[-1].startswith("test_"):
+            return False
+        return any(rel and path.startswith(rel.rstrip("/") + "/") for rel in tests_dirs)
+
+
+PYTHON = PythonLanguage()
+
+
+def language_for(cfg: Config) -> LanguageAdapter:
+    """The one source-language reader configured for this repository."""
+    if cfg.language == PYTHON.name:
+        return PYTHON
+    if cfg.language == "typescript":
+        from systemap.typescript import TYPESCRIPT
+
+        return TYPESCRIPT
+    raise ValueError(f"unsupported language: {cfg.language}")
+
+
 # Every field the extractor writes: (scope, field, what it holds). The
 # scopes are the file itself, each module record under `components`, and
 # each record under `entry_points`. `facts_doc` renders this table for the
@@ -705,20 +794,21 @@ def build(cfg: Config) -> dict[str, Any]:
     """The facts for the tree at `cfg.root`, ready to be written as JSON."""
     repo = cfg.root
     roots = cfg.roots
+    language = language_for(cfg)
     prefixes = {name for _, name in roots}
     paths: dict[str, Path] = {}
     for pkg_dir, pkg_name in roots:
-        for path in pkg_dir.rglob("*.py"):
+        for path in language.source_paths(pkg_dir):
             if any(p in SKIP_PARTS for p in path.parts):
                 continue
-            paths[module_of(path, pkg_dir, pkg_name)] = path
+            paths[language.module_of(path, pkg_dir, pkg_name)] = path
     known = set(paths)
 
     components: dict[str, Any] = {}
     imports: dict[str, set[str]] = {}
     sources: dict[str, str] = {}
     for module, path in sorted(paths.items()):
-        record = collect_module(path, repo, module, frozenset(prefixes))
+        record = language.collect_module(path, repo, module, frozenset(prefixes), known)
         if record is None:
             continue
         record["id"] = module
@@ -729,7 +819,7 @@ def build(cfg: Config) -> dict[str, Any]:
         except OSError:
             raw = ""
         sources[module] = raw
-        uses = internal_uses(
+        uses = language.internal_uses(
             raw, prefixes, known, module=module, is_package=path.name == "__init__.py"
         )
         uses.pop(module, None)
@@ -737,7 +827,7 @@ def build(cfg: Config) -> dict[str, Any]:
             target: [WHOLE_MODULE] if WHOLE_MODULE in names else sorted(names)
             for target, names in sorted(uses.items())
         }
-        record["external"] = external_imports(raw, prefixes)
+        record["external"] = language.external_imports(raw, prefixes)
         imports[module] = set(uses)
         components[module] = record
 
@@ -753,7 +843,7 @@ def build(cfg: Config) -> dict[str, Any]:
         record["imported_by"] = sorted(importers.get(module, set()))
 
     tests_dirs = cfg.test_dirs
-    guards = collect_tests(repo, tests_dirs, prefixes, known)
+    guards = language.collect_tests(repo, tests_dirs, prefixes, paths)
     for module, record in components.items():
         seen: set[str] = set()
         unique: list[dict[str, Any]] = []
@@ -777,7 +867,7 @@ def build(cfg: Config) -> dict[str, Any]:
         "packages": sorted(prefixes),
         "tests_dirs": list(tests_dirs),
         "spec_sections": spec_sections(repo, cfg.spec_path),
-        "entry_points": entry_points(repo, prefixes, components, sources),
+        "entry_points": language.entry_points(repo, prefixes, components, sources),
         "components": components,
     }
 
diff --git a/src/systemap/language.py b/src/systemap/language.py
new file mode 100644
index 00000000..fdf1a41d
--- /dev/null
+++ b/src/systemap/language.py
@@ -0,0 +1,68 @@
+"""The source-language boundary shared by extraction and change analysis.
+
+A language adapter reads syntax. The rest of systemap reads the facts the
+adapter produces, so a checker and a change view cannot disagree about what a
+module exports, imports or tests.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+from pathlib import Path
+from typing import Any, Protocol
+
+
+class LanguageAdapter(Protocol):
+    """Everything extraction and change analysis ask of source syntax."""
+
+    name: str
+
+    def source_paths(self, root: Path) -> Iterable[Path]: ...
+
+    def module_of(self, path: Path, root: Path, name: str) -> str: ...
+
+    def module_for_path(
+        self, repo: Path, path: str, roots: list[tuple[Path, str]]
+    ) -> str | None: ...
+
+    def collect_module(
+        self,
+        path: Path,
+        repo: Path,
+        module: str,
+        prefixes: frozenset[str],
+        known: set[str],
+    ) -> dict[str, Any] | None: ...
+
+    def internal_uses(
+        self,
+        raw: str,
+        prefixes: set[str],
+        known: set[str],
+        module: str = "",
+        is_package: bool = False,
+    ) -> dict[str, set[str]]: ...
+
+    def external_imports(self, raw: str, prefixes: set[str]) -> list[str]: ...
+
+    def collect_tests(
+        self,
+        repo: Path,
+        tests_dirs: tuple[str, ...],
+        prefixes: set[str],
+        paths: dict[str, Path],
+    ) -> dict[str, list[dict[str, Any]]]: ...
+
+    def entry_points(
+        self,
+        repo: Path,
+        prefixes: set[str],
+        components: dict[str, Any],
+        sources: dict[str, str],
+    ) -> list[dict[str, str]]: ...
+
+    def parse_surface(self, raw: str, path: str = "") -> dict[str, Any] | None: ...
+
+    def test_names(self, raw: str) -> list[str]: ...
+
+    def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool: ...
diff --git a/src/systemap/scaffold.py b/src/systemap/scaffold.py
index 50ca1874..193ca4a0 100644
--- a/src/systemap/scaffold.py
+++ b/src/systemap/scaffold.py
@@ -26,6 +26,7 @@
 CONFIG = """# systemap configuration. Every key is optional; these are the defaults
 # except name, which defaults to [project] name in pyproject.toml, then
 # the git repository's directory, then this directory's name.
+language = "{language}"
 name = "{name}"
 # Where the packages are: "path" = "import name". Leave it out to discover
 # every top-level directory (or src/<dir>) that holds an __init__.py, in
@@ -367,7 +368,13 @@
 )
 
 
-def files(name: str, package: str, roots: list[tuple[str, str]], ci: bool = True) -> dict[str, str]:
+def files(
+    name: str,
+    package: str,
+    roots: list[tuple[str, str]],
+    ci: bool = True,
+    language: str = "python",
+) -> dict[str, str]:
     """path -> content for every file `systemap init` writes.
 
     The skill is not in this table: it is package text that is refreshed
@@ -379,7 +386,9 @@ def files(name: str, package: str, roots: list[tuple[str, str]], ci: bool = True
     else:
         roots_block = '# [package_roots]\n# "src/mypackage" = "mypackage"'
     out = {
-        "systemap.toml": CONFIG.format(name=name, roots=roots_block, package=package),
+        "systemap.toml": CONFIG.format(
+            language=language, name=name, roots=roots_block, package=package
+        ),
         "map/model.py": MODEL.format(name=name, upper=name.upper(), package=package),
         "docs/map/.gitkeep": "",
     }
@@ -389,11 +398,16 @@ def files(name: str, package: str, roots: list[tuple[str, str]], ci: bool = True
 
 
 def write(
-    root: Path, name: str, package: str, roots: list[tuple[str, str]], ci: bool = True
+    root: Path,
+    name: str,
+    package: str,
+    roots: list[tuple[str, str]],
+    ci: bool = True,
+    language: str = "python",
 ) -> list[str]:
     """Write every file that does not exist yet; return one line per file."""
     out: list[str] = []
-    for rel, content in files(name, package, roots, ci).items():
+    for rel, content in files(name, package, roots, ci, language).items():
         path = root / rel
         if path.exists():
             out.append(f"kept {rel} (already exists)")
diff --git a/src/systemap/typescript.py b/src/systemap/typescript.py
new file mode 100644
index 00000000..29587db3
--- /dev/null
+++ b/src/systemap/typescript.py
@@ -0,0 +1,470 @@
+"""Read TypeScript and TSX into systemap's language-neutral facts."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+from collections import defaultdict
+from collections.abc import Iterable, Iterator
+from pathlib import Path, PurePosixPath
+from typing import Any
+
+import tree_sitter_typescript
+from tree_sitter import Language, Node, Parser
+
+SOURCE_SUFFIXES = (".ts", ".tsx")
+TEST_SUFFIXES = (".test.ts", ".test.tsx", ".spec.ts", ".spec.tsx")
+SKIP_PARTS = {".git", ".venv", "node_modules", "build", "dist"}
+UPPER_NAME = re.compile(r"[A-Z][A-Z0-9_]{2,}")
+WHOLE_MODULE = "*"
+CONSTANTS_KEPT = 14
+TESTS_KEPT = 25
+
+TS = Language(tree_sitter_typescript.language_typescript())
+TSX = Language(tree_sitter_typescript.language_tsx())
+
+
+def _root(raw: str, path: str = "") -> Node | None:
+    language = TSX if path.endswith(".tsx") else TS
+    tree = Parser(language).parse(raw.encode("utf-8"))
+    return None if tree.root_node.has_error else tree.root_node
+
+
+def _walk(node: Node) -> Iterator[Node]:
+    yield node
+    for child in node.named_children:
+        yield from _walk(child)
+
+
+def _text(node: Node | None) -> str:
+    return (node.text or b"").decode("utf-8") if node is not None else ""
+
+
+def _one_line(text: str) -> str:
+    return " ".join(text.split())
+
+
+def _string(node: Node | None) -> str:
+    if node is None or node.type != "string":
+        return ""
+    fragment = next((c for c in node.named_children if c.type == "string_fragment"), None)
+    return _text(fragment)
+
+
+def _source(node: Node) -> str:
+    return _string(node.child_by_field_name("source"))
+
+
+def _module_name(name: str) -> str:
+    return name.removeprefix("@").replace("/", ".").replace("-", "_")
+
+
+def _without_script_suffix(specifier: str) -> str:
+    for suffix in (".d.ts", ".tsx", ".ts", ".jsx", ".js", ".mjs", ".cjs"):
+        if specifier.endswith(suffix):
+            return specifier[: -len(suffix)]
+    return specifier
+
+
+def _resolve(specifier: str, module: str, known: set[str]) -> str | None:
+    specifier = _without_script_suffix(specifier)
+    if specifier.startswith("."):
+        parts = module.split(".")[:-1]
+        for part in PurePosixPath(specifier).parts:
+            if part == ".":
+                continue
+            if part == "..":
+                if parts:
+                    parts.pop()
+            else:
+                parts.append(part.replace("-", "_"))
+        candidate = ".".join(parts)
+    else:
+        candidate = _module_name(specifier)
+    for choice in (candidate, f"{candidate}.index"):
+        if choice in known:
+            return choice
+    return None
+
+
+def _imported_names(node: Node) -> set[str]:
+    clause = next((c for c in node.named_children if c.type == "import_clause"), None)
+    if clause is None:
+        return {WHOLE_MODULE}
+    if any(c.type == "namespace_import" for c in _walk(clause)):
+        return {WHOLE_MODULE}
+    out: set[str] = set()
+    if any(c.type == "identifier" for c in clause.named_children):
+        out.add("default")
+    for specifier in (c for c in _walk(clause) if c.type == "import_specifier"):
+        original = next((c for c in specifier.named_children if c.type == "identifier"), None)
+        if original is not None:
+            out.add(_text(original))
+    return out
+
+
+def _exported_names(node: Node) -> set[str]:
+    clause = next((c for c in node.named_children if c.type == "export_clause"), None)
+    if clause is None:
+        return {WHOLE_MODULE}
+    out: set[str] = set()
+    for specifier in (c for c in clause.named_children if c.type == "export_specifier"):
+        original = next((c for c in specifier.named_children if c.type == "identifier"), None)
+        if original is not None:
+            out.add(_text(original))
+    return out or {WHOLE_MODULE}
+
+
+def _imports(root: Node) -> Iterator[tuple[str, set[str]]]:
+    for node in root.named_children:
+        specifier = _source(node)
+        if not specifier:
+            continue
+        if node.type == "import_statement":
+            yield specifier, _imported_names(node)
+        elif node.type == "export_statement":
+            yield specifier, _exported_names(node)
+
+
+def _header(node: Node) -> str:
+    body = node.child_by_field_name("body")
+    if body is None:
+        return _one_line(_text(node).rstrip(";"))
+    length = body.start_byte - node.start_byte
+    return _one_line((node.text or b"")[:length].decode("utf-8").strip())
+
+
+def _public_methods(node: Node) -> list[str]:
+    body = node.child_by_field_name("body")
+    if body is None:
+        body = next(
+            (c for c in node.named_children if c.type in ("class_body", "interface_body")), None
+        )
+    if body is None:
+        return []
+    out: list[str] = []
+    for method in body.named_children:
+        if method.type not in ("method_definition", "method_signature"):
+            continue
+        modifiers = {_text(c) for c in method.named_children if c.type == "accessibility_modifier"}
+        if modifiers & {"private", "protected"}:
+            continue
+        out.append(_header(method))
+    return out
+
+
+def _type_record(node: Node) -> tuple[dict[str, Any], bool] | None:
+    name = node.child_by_field_name("name")
+    if name is None:
+        name = next(
+            (c for c in node.named_children if c.type in ("identifier", "type_identifier")), None
+        )
+    public = _text(name) or "default"
+    heritage = next((c for c in node.named_children if c.type == "class_heritage"), None)
+    is_error = node.type == "class_declaration" and "Error" in _text(heritage)
+    return {"name": public, "methods": _public_methods(node)}, is_error
+
+
+def _arrow_signature(name: str, node: Node) -> str:
+    params = node.child_by_field_name("parameters") or node.child_by_field_name("parameter")
+    result = node.child_by_field_name("return_type")
+    return f"const {name} = {_text(params)}{_text(result)} =>"
+
+
+def _reexports(node: Node) -> list[dict[str, str]]:
+    clause = next((c for c in node.named_children if c.type == "export_clause"), None)
+    source = _source(node)
+    if clause is None or not source:
+        return []
+    out: list[dict[str, str]] = []
+    for specifier in (c for c in clause.named_children if c.type == "export_specifier"):
+        identifiers = [c for c in specifier.named_children if c.type == "identifier"]
+        if not identifiers:
+            continue
+        original = _text(identifiers[0])
+        public = _text(identifiers[-1])
+        entry = {"name": public, "kind": "reexport", "reexport_of": source}
+        if public != original:
+            entry["defined_as"] = original
+        out.append(entry)
+    return out
+
+
+def parse_surface(raw: str, path: str = "") -> dict[str, Any] | None:
+    """The exported surface of one TypeScript or TSX module."""
+    root = _root(raw, path)
+    if root is None:
+        return None
+    functions: list[dict[str, str]] = []
+    classes: list[dict[str, Any]] = []
+    errors: list[dict[str, Any]] = []
+    constants: list[dict[str, str]] = []
+    names: list[dict[str, str]] = []
+    for export in (n for n in root.named_children if n.type == "export_statement"):
+        names += _reexports(export)
+        declaration = export.child_by_field_name("declaration")
+        if declaration is None:
+            continue
+        if declaration.type in ("function_declaration", "generator_function_declaration"):
+            name = _text(declaration.child_by_field_name("name")) or "default"
+            functions.append({"name": name, "signature": _header(declaration)})
+            names.append({"name": name, "kind": "function"})
+        elif declaration.type in (
+            "class_declaration",
+            "interface_declaration",
+            "type_alias_declaration",
+            "enum_declaration",
+        ):
+            found = _type_record(declaration)
+            if found is None:
+                continue
+            record, is_error = found
+            (errors if is_error else classes).append(record)
+            names.append({"name": record["name"], "kind": "error" if is_error else "class"})
+        elif declaration.type == "lexical_declaration":
+            for variable in (
+                c for c in declaration.named_children if c.type == "variable_declarator"
+            ):
+                name = _text(variable.child_by_field_name("name"))
+                value = variable.child_by_field_name("value")
+                if not name or value is None:
+                    continue
+                if value.type == "arrow_function":
+                    functions.append({"name": name, "signature": _arrow_signature(name, value)})
+                    names.append({"name": name, "kind": "function"})
+                elif UPPER_NAME.fullmatch(name):
+                    constants.append({"name": name, "value": _one_line(_text(value))[:80]})
+                    names.append({"name": name, "kind": "constant"})
+                else:
+                    names.append({"name": name, "kind": "object"})
+    leading = next((n for n in root.named_children if n.type == "comment"), None)
+    docstring = _text(leading).removeprefix("/**").removesuffix("*/").strip(" *\n")
+    return {
+        "docstring": _one_line(docstring),
+        "functions": functions,
+        "classes": classes,
+        "errors": errors,
+        "constants": constants,
+        "names": names,
+    }
+
+
+def test_names(raw: str) -> list[str]:
+    root = _root(raw)
+    if root is None:
+        return []
+    out: list[str] = []
+    for call in (n for n in _walk(root) if n.type == "call_expression"):
+        function = call.child_by_field_name("function")
+        if _text(function).rsplit(".", 1)[-1] not in ("test", "it"):
+            continue
+        arguments = call.child_by_field_name("arguments")
+        first = arguments.named_children[0] if arguments and arguments.named_children else None
+        name = _string(first)
+        if name:
+            out.append(name)
+    return out
+
+
+def _is_test_path(path: Path) -> bool:
+    text = path.name
+    return text.startswith("test_") or text.endswith(TEST_SUFFIXES)
+
+
+def _target_from_path(specifier: str, importer: Path, paths: dict[str, Path]) -> str | None:
+    if not specifier.startswith("."):
+        normalized = _module_name(_without_script_suffix(specifier))
+        return next((m for m in (normalized, f"{normalized}.index") if m in paths), None)
+    target = importer.parent / _without_script_suffix(specifier)
+    choices = [target.with_suffix(s) for s in SOURCE_SUFFIXES]
+    choices += [(target / "index").with_suffix(s) for s in SOURCE_SUFFIXES]
+    resolved = {p.resolve(): module for module, p in paths.items()}
+    return next((resolved[p.resolve()] for p in choices if p.resolve() in resolved), None)
+
+
+class TypeScriptLanguage:
+    """TypeScript syntax normalized to the facts Python already consumes."""
+
+    name = "typescript"
+
+    def source_paths(self, root: Path) -> Iterable[Path]:
+        return (
+            path
+            for suffix in SOURCE_SUFFIXES
+            for path in root.rglob(f"*{suffix}")
+            if not path.name.endswith(".d.ts")
+            and not _is_test_path(path)
+            and not any(part in SKIP_PARTS for part in path.parts)
+        )
+
+    def module_of(self, path: Path, root: Path, name: str) -> str:
+        parts = path.relative_to(root).with_suffix("").parts
+        return ".".join((name, *(part.replace("-", "_") for part in parts)))
+
+    def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None:
+        absolute = repo / path
+        if absolute.suffix not in SOURCE_SUFFIXES or absolute.name.endswith(".d.ts"):
+            return None
+        for root, name in roots:
+            if absolute.is_relative_to(root):
+                return self.module_of(absolute, root, name)
+        return None
+
+    def collect_module(
+        self,
+        path: Path,
+        repo: Path,
+        module: str,
+        prefixes: frozenset[str],
+        known: set[str],
+    ) -> dict[str, Any] | None:
+        try:
+            raw = path.read_text(encoding="utf-8")
+        except OSError:
+            return None
+        surface = parse_surface(raw, path.as_posix())
+        if surface is None:
+            return None
+        for entry in surface["names"]:
+            if entry.get("kind") != "reexport":
+                continue
+            target = _resolve(entry["reexport_of"], module, known)
+            if target:
+                entry["reexport_of"] = target
+        return {
+            "file": path.relative_to(repo).as_posix(),
+            "loc": len(raw.splitlines()),
+            "sha": hashlib.sha1(raw.encode(), usedforsecurity=False).hexdigest()[:12],
+            **surface,
+            "constants": surface["constants"][:CONSTANTS_KEPT],
+        }
+
+    def internal_uses(
+        self,
+        raw: str,
+        prefixes: set[str],
+        known: set[str],
+        module: str = "",
+        is_package: bool = False,
+    ) -> dict[str, set[str]]:
+        root = _root(raw)
+        if root is None:
+            return {}
+        uses: dict[str, set[str]] = defaultdict(set)
+        for specifier, names in _imports(root):
+            target = _resolve(specifier, module, known)
+            if target:
+                uses[target].update(names)
+        return dict(uses)
+
+    def external_imports(self, raw: str, prefixes: set[str]) -> list[str]:
+        root = _root(raw)
+        if root is None:
+            return []
+        out = {
+            specifier
+            for specifier, _names in _imports(root)
+            if not specifier.startswith(".")
+            and not any(
+                _module_name(specifier) == prefix
+                or _module_name(specifier).startswith(prefix + ".")
+                for prefix in prefixes
+            )
+        }
+        return sorted(out)
+
+    def collect_tests(
+        self,
+        repo: Path,
+        tests_dirs: tuple[str, ...],
+        prefixes: set[str],
+        paths: dict[str, Path],
+    ) -> dict[str, list[dict[str, Any]]]:
+        roots = [repo / rel for rel in tests_dirs if rel] or [repo]
+        files = {
+            path
+            for root in roots
+            if root.is_dir()
+            for path in root.rglob("*")
+            if path.is_file()
+            and _is_test_path(path)
+            and not any(p in SKIP_PARTS for p in path.parts)
+        }
+        guards: dict[str, list[dict[str, Any]]] = defaultdict(list)
+        for path in sorted(files):
+            try:
+                raw = path.read_text(encoding="utf-8")
+            except OSError:
+                continue
+            root = _root(raw, path.as_posix())
+            if root is None:
+                continue
+            targets = {
+                target
+                for specifier, _names in _imports(root)
+                if (target := _target_from_path(specifier, path, paths))
+            }
+            stem = path.name.split(".", 1)[0].removeprefix("test_")
+            for target in targets:
+                primary = stem == target.rsplit(".", 1)[-1]
+                guards[target] += [
+                    {"name": name, "primary": primary} for name in test_names(raw)[:TESTS_KEPT]
+                ]
+        return guards
+
+    def entry_points(
+        self,
+        repo: Path,
+        prefixes: set[str],
+        components: dict[str, Any],
+        sources: dict[str, str],
+    ) -> list[dict[str, str]]:
+        out: list[dict[str, str]] = []
+        package = repo / "package.json"
+        try:
+            data = json.loads(package.read_text(encoding="utf-8")) if package.is_file() else {}
+        except (OSError, json.JSONDecodeError):
+            data = {}
+        bins = data.get("bin", {}) if isinstance(data, dict) else {}
+        if isinstance(bins, str):
+            bins = {str(data.get("name", repo.name)): bins}
+        if isinstance(bins, dict):
+            by_file = {record["file"]: module for module, record in components.items()}
+            for name, target in sorted(bins.items()):
+                if not isinstance(target, str):
+                    continue
+                module = by_file.get(target.removeprefix("./"))
+                if module:
+                    out.append(
+                        {
+                            "kind": "console_script",
+                            "name": str(name),
+                            "module": module,
+                            "target": "",
+                        }
+                    )
+        for prefix in sorted(prefixes):
+            root_module = f"{prefix}.index"
+            for function in components.get(root_module, {}).get("functions", []):
+                out.append(
+                    {
+                        "kind": "public_function",
+                        "name": function["name"],
+                        "module": root_module,
+                        "target": "",
+                    }
+                )
+        return out
+
+    def parse_surface(self, raw: str, path: str = "") -> dict[str, Any] | None:
+        return parse_surface(raw, path)
+
+    def test_names(self, raw: str) -> list[str]:
+        return test_names(raw)
+
+    def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool:
+        return _is_test_path(Path(path))
+
+
+TYPESCRIPT = TypeScriptLanguage()
diff --git a/tests/test_extract.py b/tests/test_extract.py
index 35d4a82a..7d7c0400 100644
--- a/tests/test_extract.py
+++ b/tests/test_extract.py
@@ -45,6 +45,24 @@ def test_extract_finds_modules_and_public_surface(tmp_path: Path) -> None:
     assert reader["imported_by"] == ["pkg.writer"]
 
 
+def test_language_defaults_to_python_and_may_be_stated(tmp_path: Path) -> None:
+    write_tree(tmp_path, TINY_PACKAGE)
+    default = config.load(tmp_path)
+    assert default.language == "python"
+    assert extract.language_for(default) is extract.PYTHON
+
+    (tmp_path / "systemap.toml").write_text('language = "python"\n', encoding="utf-8")
+    stated = config.load(tmp_path)
+    assert stated.language == "python"
+    assert extract.build(stated) == extract.build(default)
+
+
+def test_unknown_language_is_refused(tmp_path: Path) -> None:
+    write_tree(tmp_path, {"systemap.toml": 'language = "go"\n'})
+    with pytest.raises(config.ConfigError, match='language must be "python" or "typescript"'):
+        config.load(tmp_path)
+
+
 def test_extract_attributes_tests_to_modules(tmp_path: Path) -> None:
     write_tree(tmp_path, TINY_PACKAGE)
     facts = extract.build(config.load(tmp_path))
diff --git a/tests/test_screenshots.py b/tests/test_screenshots.py
index f69d275f..b55fa296 100644
--- a/tests/test_screenshots.py
+++ b/tests/test_screenshots.py
@@ -100,8 +100,9 @@ def test_the_readme_embeds_what_the_script_writes() -> None:
         assert rel in readme, rel
         assert (ROOT / rel).is_file(), rel
     assert "[docs/benchmarks.md](docs/benchmarks.md)" in readme
-    # Python, and only Python, is said before a reader has scrolled.
-    assert "Python" in readme[:1200] and "only Python" in readme
+    # Both source languages are said in the introduction.
+    introduction = readme.split("\n## ", 1)[0]
+    assert "Python or TypeScript" in introduction
     # Every cost the README quotes is a cost bench/results.jsonl holds, so the
     # sales line and the measurements cannot drift apart. The maintenance runs
     # are quoted one by one and the first maps as a range.
diff --git a/tests/test_typescript.py b/tests/test_typescript.py
new file mode 100644
index 00000000..34bc2ad6
--- /dev/null
+++ b/tests/test_typescript.py
@@ -0,0 +1,121 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from conftest import write_tree
+
+from systemap import change, config, extract
+from systemap.cli import main
+from systemap.typescript import TYPESCRIPT, parse_surface
+from systemap.typescript import test_names as names_of_tests
+
+TREE = {
+    "package.json": '{"name":"@acme/web","bin":{"web":"src/cli.ts"}}',
+    "systemap.toml": (
+        'language = "typescript"\ntests_dir = "tests"\n[package_roots]\n"src" = "web"\n'
+    ),
+    "src/index.ts": 'export { serve } from "./service";\n',
+    "src/types.ts": "export interface User { name: string; save(): void }\n",
+    "src/client.ts": "export function fetchUser(id: string): User { return { id } as User }\n",
+    "src/service.ts": (
+        "/** Serve one user. */\n"
+        'import type { User } from "./types";\n'
+        'import { fetchUser } from "./client";\n'
+        'import { z } from "zod";\n'
+        "export const LIMIT = 3;\n"
+        "export async function serve(id: string): Promise<User> { return fetchUser(id) }\n"
+        "export class ServeError extends Error { public explain(): string { return z.string() } }\n"
+        "const hidden = 1;\n"
+    ),
+    "src/cli.ts": "export function main(): void {}\n",
+    "tests/service.test.ts": (
+        'import { serve } from "../src/service";\n'
+        'describe("service", () => { test("serves a user", () => serve("1")) });\n'
+    ),
+}
+
+
+def test_typescript_extracts_surface_imports_tests_and_entry_points(tmp_path: Path) -> None:
+    write_tree(tmp_path, TREE)
+    cfg = config.load(tmp_path)
+    assert cfg.language == "typescript"
+    assert extract.language_for(cfg) is TYPESCRIPT
+
+    facts = extract.build(cfg)
+    assert sorted(facts["components"]) == [
+        "web.cli",
+        "web.client",
+        "web.index",
+        "web.service",
+        "web.types",
+    ]
+    service = facts["components"]["web.service"]
+    assert service["docstring"] == "Serve one user."
+    assert service["functions"] == [
+        {"name": "serve", "signature": "async function serve(id: string): Promise<User>"}
+    ]
+    assert service["classes"] == []
+    assert service["errors"] == [{"name": "ServeError", "methods": ["public explain(): string"]}]
+    assert service["constants"] == [{"name": "LIMIT", "value": "3"}]
+    assert service["uses"] == {"web.client": ["fetchUser"], "web.types": ["User"]}
+    assert service["external"] == ["zod"]
+    assert service["tests"] == ["serves a user"]
+    assert service["tests_primary"] == 1
+
+    assert facts["components"]["web.index"]["names"] == [
+        {"name": "serve", "kind": "function", "reexport_of": "web.service"}
+    ]
+    assert facts["entry_points"] == [
+        {"kind": "console_script", "name": "web", "module": "web.cli", "target": ""}
+    ]
+
+
+def test_typescript_roots_are_discovered_from_package_metadata(tmp_path: Path) -> None:
+    write_tree(
+        tmp_path,
+        {
+            "package.json": '{"name":"@acme/web"}',
+            "systemap.toml": 'language = "typescript"\n',
+            "src/index.ts": "export const app = () => 1;\n",
+        },
+    )
+    cfg = config.load(tmp_path)
+    assert cfg.package_roots == (("src", "acme.web"),)
+    assert sorted(extract.build(cfg)["components"]) == ["acme.web.index"]
+
+
+def test_init_detects_a_typescript_repository(tmp_path: Path) -> None:
+    write_tree(
+        tmp_path,
+        {
+            "package.json": '{"name":"web"}',
+            "src/index.ts": "export const app = () => 1;\n",
+        },
+    )
+    assert main(["--root", str(tmp_path), "init", "--no-ci"]) == 0
+    text = (tmp_path / "systemap.toml").read_text(encoding="utf-8")
+    assert 'language = "typescript"' in text
+    assert '[package_roots]\n"src" = "web"' in text
+    assert sorted(extract.build(config.load(tmp_path))["components"]) == ["web.index"]
+
+
+def test_typescript_surface_and_change_use_the_same_parser() -> None:
+    before = "export function read(value: string): string { return value }\n"
+    after = "export function read(value: number): string { return String(value) }\n"
+    surface = parse_surface(before)
+    assert surface is not None
+    assert surface["functions"] == [
+        {"name": "read", "signature": "function read(value: string): string"}
+    ]
+    assert change.surface_delta(before, after, TYPESCRIPT) == {
+        "added": {"operations": [], "types": [], "refusals": [], "constants": []},
+        "removed": {"operations": [], "types": [], "refusals": [], "constants": []},
+        "changed": {"operations": ["read"], "types": [], "refusals": [], "constants": []},
+    }
+
+
+def test_typescript_test_names_are_literal_and_nested() -> None:
+    assert names_of_tests(
+        'test("one", () => {}); describe("group", () => { it("two", () => {}) });'
+    ) == ["one", "two"]
+    assert names_of_tests("test(name, () => {})") == []
diff --git a/uv.lock b/uv.lock
index 47a61a80..2e4d65e3 100644
--- a/uv.lock
+++ b/uv.lock
@@ -70,6 +70,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/25/6c/b400476d3ceba681ab929787edc9554f6d88fcc69435eb681b00fc0457a5/ast_serialize-0.8.0-cp39-abi3-win_arm64.whl", hash = "sha256:b2a5978662fd4db463dfb4b974d2b10ac6430b98f5333aabc7051909df3561d0", size = 1083655, upload-time = "2026-08-07T11:29:00.349Z" },
 ]
 
+[[package]]
+name = "cfgv"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4e/b5/721b8799b04bf9afe054a3899c6cf4e880fcf8563cc71c15610242490a0c/cfgv-3.5.0.tar.gz", hash = "sha256:d5b1034354820651caa73ede66a6294d6e95c1b00acc5e9b098e917404669132", size = 7334, upload-time = "2025-11-19T20:55:51.612Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/3c/33bac158f8ab7f89b2e59426d5fe2e4f63f7ed25df84c036890172b412b5/cfgv-3.5.0-py2.py3-none-any.whl", hash = "sha256:a8dc6b26ad22ff227d2634a65cb388215ce6cc96bbcc5cfde7641ae87e8dacc0", size = 7445, upload-time = "2025-11-19T20:55:50.744Z" },
+]
+
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -79,6 +88,33 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
 ]
 
+[[package]]
+name = "distlib"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/02/bd72be9134d25ed783ecbbc38a539ffaefbf90c78418c7fb7229600dbac7/distlib-0.4.3.tar.gz", hash = "sha256:f152097224a0ae24be5a0f6bae1b9359af82133bce63f98a95f86cae1aede9ed", size = 615141, upload-time = "2026-06-12T08:04:52.847Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/02/08/9c41fb51ab5b43eb21674aff13df270e8ba6c4b29c8624e328dc7a9482af/distlib-0.4.3-py2.py3-none-any.whl", hash = "sha256:4b0ce306c966eb73bc3a7b6abad017c556dadd92c44701562cd528ac7fde4d5b", size = 470628, upload-time = "2026-06-12T08:04:50.506Z" },
+]
+
+[[package]]
+name = "filelock"
+version = "3.32.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/59/e19834834cb01a32febfbb0f8a23a9088088f5d45991824ff2bc3b5e8acb/filelock-3.32.7.tar.gz", hash = "sha256:37b8a3d9811b0f9aef7e5ec5c71bb320de52df51e6ca9bcd6f5ad81187660da7", size = 225154, upload-time = "2026-09-16T00:24:20.907Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/15/df/31098c5aeb4d966b553641472bd55fcf5fdfac953549894b8a765ba44e91/filelock-3.32.7-py3-none-any.whl", hash = "sha256:65ff0d0190ea42038b32bda4b77834fb05be2cad4c5b9b01aa4dfb3614536e52", size = 100157, upload-time = "2026-09-16T00:24:19.543Z" },
+]
+
+[[package]]
+name = "identify"
+version = "2.6.19"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/52/63/51723b5f116cc04b061cb6f5a561790abf249d25931d515cd375e063e0f4/identify-2.6.19.tar.gz", hash = "sha256:6be5020c38fcb07da56c53733538a3081ea5aa70d36a156f83044bfbf9173842", size = 99567, upload-time = "2026-04-17T18:39:50.265Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/84/d9273cd09688070a6523c4aee4663a8538721b2b755c4962aafae0011e72/identify-2.6.19-py2.py3-none-any.whl", hash = "sha256:20e6a87f786f768c092a721ad107fc9df0eb89347be9396cadf3f4abbd1fb78a", size = 99397, upload-time = "2026-04-17T18:39:49.221Z" },
+]
+
 [[package]]
 name = "iniconfig"
 version = "2.3.0"
@@ -273,6 +309,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
 ]
 
+[[package]]
+name = "nodeenv"
+version = "1.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/bf/d1bda4f6168e0b2e9e5958945e01910052158313224ada5ce1fb2e1113b8/nodeenv-1.10.0.tar.gz", hash = "sha256:996c191ad80897d076bdfba80a41994c2b47c68e224c542b48feba42ba00f8bb", size = 55611, upload-time = "2025-12-20T14:08:54.006Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl", hash = "sha256:5bb13e3eed2923615535339b3c620e76779af4cb4c6a90deccc9e36b274d3827", size = 23438, upload-time = "2025-12-20T14:08:52.782Z" },
+]
+
 [[package]]
 name = "packaging"
 version = "26.3"
@@ -291,6 +336,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f1/d9/7fb5aa316bc299258e68c73ba3bddbc499654a07f151cba08f6153988714/pathspec-1.1.1-py3-none-any.whl", hash = "sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189", size = 57328, upload-time = "2026-04-27T01:46:07.06Z" },
 ]
 
+[[package]]
+name = "platformdirs"
+version = "4.11.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f8/13/f870dd0b42690138e4e37a76b5138e5690ed4365a77071bb092d59037da0/platformdirs-4.11.11.tar.gz", hash = "sha256:b0befe8a90759e4a9a8b9820d434ae226a6549063210b596da0038a7a05aede4", size = 39949, upload-time = "2026-09-19T01:18:47.259Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/39/be/3ae887e84c38c4dd1c549cd5825adc93f48069a94fe1cb8ac52a9da16f15/platformdirs-4.11.11-py3-none-any.whl", hash = "sha256:972ea6b2b387155a536226a0750e46923d731d459a387c4a255c583ed2f64547", size = 24992, upload-time = "2026-09-19T01:18:45.825Z" },
+]
+
 [[package]]
 name = "pluggy"
 version = "1.6.0"
@@ -300,6 +354,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
 ]
 
+[[package]]
+name = "pre-commit"
+version = "4.6.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/74/89/1f3e8e1fc3e97de0fa963495832f581f025f29471602a309e48808244292/pre_commit-4.6.2.tar.gz", hash = "sha256:8f5d7bfb021ecdbcd9d49d89847082dd24172ccde534390081a679ad046e2441", size = 198670, upload-time = "2026-08-10T22:07:18.421Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/45/e2/bbb7129c9e7999a6b8ee9cca3b66486c25c423ab5a75f34071798b74ce94/pre_commit-4.6.2-py2.py3-none-any.whl", hash = "sha256:e2dde9a75d3bce11bd3831c26d134df00a2803c1d818be6a0383c3dcda25dc4e", size = 226202, upload-time = "2026-08-10T22:07:16.942Z" },
+]
+
 [[package]]
 name = "pygments"
 version = "2.21.0"
@@ -325,6 +395,73 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
 ]
 
+[[package]]
+name = "python-discovery"
+version = "1.6.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "filelock" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0c/57/250bd238b966cece44328235eb85290045d059265fdaf7527a3a958123db/python_discovery-1.6.1.tar.gz", hash = "sha256:cf87d3627dfb4412437fdd5b13eae402607722998d21567993aedbc59b23c15e", size = 84338, upload-time = "2026-09-18T01:31:53.971Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/16/7d/e9ffbadfbf89c93848412d04594135c4ae8c1d37d9e053b9c3ed718fabc4/python_discovery-1.6.1-py3-none-any.whl", hash = "sha256:d43fcdef879fe795352bd13ccf8d185ba5a9f86f36cfcd00529f596e737442b3", size = 38664, upload-time = "2026-09-18T01:31:52.448Z" },
+]
+
+[[package]]
+name = "pyyaml"
+version = "6.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" },
+    { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" },
+    { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" },
+    { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
+    { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
+    { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
+    { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
+    { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
+    { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
+    { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
+    { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
+    { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
+    { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
+    { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
+    { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
+    { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
+    { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
+    { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
+]
+
 [[package]]
 name = "ruff"
 version = "0.16.4"
@@ -354,23 +491,88 @@ wheels = [
 name = "systemap"
 version = "1.2.0"
 source = { editable = "." }
+dependencies = [
+    { name = "tree-sitter" },
+    { name = "tree-sitter-typescript" },
+]
 
 [package.dev-dependencies]
 dev = [
     { name = "mypy" },
+    { name = "pre-commit" },
     { name = "pytest" },
     { name = "ruff" },
 ]
 
 [package.metadata]
+requires-dist = [
+    { name = "tree-sitter", specifier = ">=0.25,<0.27" },
+    { name = "tree-sitter-typescript", specifier = ">=0.23,<0.24" },
+]
 
 [package.metadata.requires-dev]
 dev = [
     { name = "mypy", specifier = ">=1.10" },
+    { name = "pre-commit", specifier = ">=4,<5" },
     { name = "pytest", specifier = ">=8" },
     { name = "ruff", specifier = ">=0.5" },
 ]
 
+[[package]]
+name = "tree-sitter"
+version = "0.26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f7/03/5600b84aff2e6c4fe80cfebb4063fe2f50299521befe5f6092ab8c082f4a/tree_sitter-0.26.0.tar.gz", hash = "sha256:b40c219edccc4564530c96f8f1556f6202b37cda964d1cbd7bd2b7e68b40a245", size = 191423, upload-time = "2026-06-30T12:14:27.933Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/18/78aae7e4b5a36daaebb0276e4b07d084d45298758000787838e89329e11f/tree_sitter-0.26.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1d6fe0e8fb4df77b5ee816228e2c4475a63d8cc1d4d3a7ffd7097b2b87fc3e95", size = 148679, upload-time = "2026-06-30T12:13:52.27Z" },
+    { url = "https://files.pythonhosted.org/packages/24/e4/b371b9553b0e47d130fc2073e56cab94fecc868be04666bf5bbd1fcd1cc9/tree_sitter-0.26.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:514a9bf8993e5210e7970736aaf6020d1759b670e195ef17b1c48f586aa30736", size = 140759, upload-time = "2026-06-30T12:13:53.221Z" },
+    { url = "https://files.pythonhosted.org/packages/22/7d/266fb0f2c41e6fb00b0f40e7a3338cdf99651e6a6511ca72bc78fc697636/tree_sitter-0.26.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10f0d4eb94aa7242dcb7f554bcd24dd7ba1c114f00d58759ba08c7a46c8ec51a", size = 637206, upload-time = "2026-06-30T12:13:54.334Z" },
+    { url = "https://files.pythonhosted.org/packages/40/9f/47cf22febb47132d5b3a507a27bb99ef89fe5c8ec420a13c6daa9b64f782/tree_sitter-0.26.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:335294ce0504fcefde5245dff596778ffaf820205b98ae0b549c72e48855f1d8", size = 664758, upload-time = "2026-06-30T12:13:55.42Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/4d/8d144ca3beb46a62a5102b6deac76bb0da55235c2c7840faf3b12f2e9d97/tree_sitter-0.26.0-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f9997ba61368c48ed54e715676afadf703947a1542464e39d047764fb3624b01", size = 647438, upload-time = "2026-06-30T12:13:56.523Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/ed/ed1d6e78520c4fb64ed52fec3f2947bf8c1fbad7bc24e282c56193c9ba42/tree_sitter-0.26.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:c56581ad256c4195a21bfe449fed5d44a02fe83a4a7d6e70e6ec302c881191c7", size = 661944, upload-time = "2026-06-30T12:13:57.82Z" },
+    { url = "https://files.pythonhosted.org/packages/10/83/45f5bd43db1b8248d2fd08ef6cbe43e2725c539e09a2cfb8bc2818646788/tree_sitter-0.26.0-cp311-cp311-win_amd64.whl", hash = "sha256:0f8793fd18ad7eec276ed4b51c097b4bf2002b357259b66b0d75db1f3f41c754", size = 129496, upload-time = "2026-06-30T12:13:59.216Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/8d/be68e6c04563eb54145424cc83fe0aa8b0ba6c90d8989cf8a032671b5f16/tree_sitter-0.26.0-cp311-cp311-win_arm64.whl", hash = "sha256:dea4b4e27d49e9ec5b785d4f994da000e6726882fcc6ad05ec98478500c71aef", size = 116484, upload-time = "2026-06-30T12:14:00.147Z" },
+    { url = "https://files.pythonhosted.org/packages/87/ca/565702c44815393e3a973552ad546db4e5ca081ca8698640b4e93d809f51/tree_sitter-0.26.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6cb2bd20efb2544c19ac54486ab7cb8ec7b36f913bbe1ce95df84acb96743d9c", size = 148934, upload-time = "2026-06-30T12:14:01.188Z" },
+    { url = "https://files.pythonhosted.org/packages/54/6f/8bb61957f16ec1b1d92410a006cdc84a952b6352a7313b2ad299f2d21484/tree_sitter-0.26.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:918d89529786873f0982a0f59c2a303cd065fbfd1b903d71a8e4e1584f67b42e", size = 140820, upload-time = "2026-06-30T12:14:02.087Z" },
+    { url = "https://files.pythonhosted.org/packages/78/0a/8a6f08559182643a814a4ab559948ae817b2851890fd9b995a4fff6541ce/tree_sitter-0.26.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:30a88be89ff1f2755297f81e8080d88b795dd98720c3f9fa2acf93873182cc95", size = 638844, upload-time = "2026-06-30T12:14:03.428Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/2f/6e6781b31677231366cb3cf27bc8269157f6d4b03c9032865a4f5f2bbe7e/tree_sitter-0.26.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a6b333b0282d8bb0af741f9b018bd2523d4eecb2686bf6717066a625fecfaa4", size = 667487, upload-time = "2026-06-30T12:14:04.669Z" },
+    { url = "https://files.pythonhosted.org/packages/02/0b/0483078c8567445557a7015b0e5b187f6d7d4fda73464df9c4bdea7f7f3c/tree_sitter-0.26.0-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3f3c44339dd34fe8eb2b8d5aa7610660499a795f70376b130bbee7a437337280", size = 647975, upload-time = "2026-06-30T12:14:05.797Z" },
+    { url = "https://files.pythonhosted.org/packages/27/68/da83ca72c984e96ab4eb3bee0db1a6ffb5de1c8c455f92bd9f420cde7f0e/tree_sitter-0.26.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:94550e13b6ae576969da40246f4c4abb206380b5375ad43f26dd9151d55438e3", size = 665018, upload-time = "2026-06-30T12:14:07.278Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/36/4d67927fd47b89af4a00f65f55a7370e28778cd50e972c2430487e3ecc27/tree_sitter-0.26.0-cp312-cp312-win_amd64.whl", hash = "sha256:ca89e361a276dbc934b28a43dd881199e25d34ff5493ee0ce45f3c52a6124a37", size = 129619, upload-time = "2026-06-30T12:14:08.373Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/72/cdefad523eb78710679c6da6a79e3d90f5afd32b1c6aa5a17bac7eef99f6/tree_sitter-0.26.0-cp312-cp312-win_arm64.whl", hash = "sha256:bc6cb01d5ee75c85424aa1f1c72a82d8f07fd52539a0f3c4a6ed3e8721079b84", size = 116545, upload-time = "2026-06-30T12:14:09.273Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/b0/465257cf8f972ad9f9812ec1cbaa8ec210ebebb601ade9a15881aa2436b4/tree_sitter-0.26.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ed0889dbed843ce45ede9f5169c0b2dea2222f12685844a03fadb81f12705867", size = 148893, upload-time = "2026-06-30T12:14:10.541Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/ec/19d093e854b45e807fecfdd26105c266f43aeecc39c4dc97992a7074ad5a/tree_sitter-0.26.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6189c6c340c7384357711e3d92645e96bfb79f7a502f86de1ebdb23eb43f7dab", size = 140829, upload-time = "2026-06-30T12:14:11.626Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/ee/87e74671ed63a837e7a1f17ab94aa3913871e033b27523d8e7b83d6f7ad0/tree_sitter-0.26.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8ff2e0750b7daa722302838356d7b65e303829b7eb73c915df127ddba115e1d1", size = 639334, upload-time = "2026-06-30T12:14:12.836Z" },
+    { url = "https://files.pythonhosted.org/packages/66/e7/f7e04cd9dff6b6ac0adf23922796fbc76accd4cf4bcda50542748d485679/tree_sitter-0.26.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7075ef857ef86f327dbb72d1e2574dda78db5754b3a1fca6506acd7fe5d561a7", size = 668102, upload-time = "2026-06-30T12:14:14.035Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/90/0bfb16b7894fea728c774a89d5af421a9368a2f913bbd4e8dcab7caaecfb/tree_sitter-0.26.0-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:26c996c1edfee86e977bb3f5462e74fcec0d0b0db1e85a3c475875763caa03be", size = 648560, upload-time = "2026-06-30T12:14:15.302Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/e6/0fe05ba396e9623b0ae40ccf34171336b8701ec8d7bd0ee9f5224d638665/tree_sitter-0.26.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:00289bfe7978f3e0dc0ce69813a20fa9f44ea4c100b3ec62043e5eb74ccfc3a2", size = 665121, upload-time = "2026-06-30T12:14:16.403Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/d2/a944b1ca35bed6068dc84a9967aaf3049d8cc0b7a36179eea8787270a6ab/tree_sitter-0.26.0-cp313-cp313-win_amd64.whl", hash = "sha256:93e220cab7e6a823efeb2046c49171427de92ef71c7c681c01820d14d8d3721f", size = 129615, upload-time = "2026-06-30T12:14:17.463Z" },
+    { url = "https://files.pythonhosted.org/packages/09/ef/c7ca48293580d2249f36940c4eed5b4ddeb9ce75baf9a4ef30621987e0c7/tree_sitter-0.26.0-cp313-cp313-win_arm64.whl", hash = "sha256:b31a8195d2f224224c530ac814632d98c1dcc123d227442c07c736e86b70d564", size = 116525, upload-time = "2026-06-30T12:14:18.53Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/7a/4d84e6f6ae2c3e757490dd84de251712c31e293dfe31f28da1ec019cefa2/tree_sitter-0.26.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:5a3c93a352b7e6f70f73e121bbfa2d0117ba7478bd51114ed35c91b0b78814fa", size = 148901, upload-time = "2026-06-30T12:14:19.452Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/d9/efe62ec65dc9d096e834d27b8c058127e2146e42ff3380b822a233f016a6/tree_sitter-0.26.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:5fc2f41bf246ff2f70a9cc3690be35ec7580a4923151873d898c8bcb1a4503d3", size = 140805, upload-time = "2026-06-30T12:14:20.478Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/2c/c82326b7b97e3c485c18679883b16f89e5e913c639d3b219d3da70c9e67e/tree_sitter-0.26.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b8ea92a255c91671a7ec4625aba3ab7bb5220c423630ffbf83c45d7312abe084", size = 640586, upload-time = "2026-06-30T12:14:21.527Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/7a/f56e7d8282859452611024c7cbc623bfba5b24b8cb9b8f8bc88c5219fe9a/tree_sitter-0.26.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f665510f0fcf4636fb9696f1f7853bed7a3bd764b7bb0cb8494e619c14ed5a0c", size = 668300, upload-time = "2026-06-30T12:14:22.728Z" },
+    { url = "https://files.pythonhosted.org/packages/91/51/240ee81b9d5e9ca0a6cb1528e8605ffa70ab58c89ce126631be96d3e4bae/tree_sitter-0.26.0-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:253df7ab82cc0a9d311cd65f06e9f99fb3eac55996ae9fc94da22f123a861b90", size = 649627, upload-time = "2026-06-30T12:14:23.819Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/54/760035cefedf9eb44f0f84c4ac22f1322e73155853e272576ee876336312/tree_sitter-0.26.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ff80d4833d330a73184a3ac5132abe93c575d2dea31975c6f15c0d21fef238aa", size = 664885, upload-time = "2026-06-30T12:14:25.064Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/1b/0b36fe2a984ecedc4ce6aefd5d56447a6626a8e9b595c4e48658510ce8f8/tree_sitter-0.26.0-cp314-cp314-win_amd64.whl", hash = "sha256:a4033fecc8f606c7f2e8b8014d0057b74668a7f0152763606f7bc25c5f9ec64c", size = 132688, upload-time = "2026-06-30T12:14:26.106Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/74/ebc041a13fbf40144afdb0d4b447e48e0b4012ca866c63de8b48f801f0c1/tree_sitter-0.26.0-cp314-cp314-win_arm64.whl", hash = "sha256:823251c4b6725a7c03ed497a339135ede7ae4bdde75bb8be7ef5e305aeb4ff52", size = 120287, upload-time = "2026-06-30T12:14:26.991Z" },
+]
+
+[[package]]
+name = "tree-sitter-typescript"
+version = "0.23.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1e/fc/bb52958f7e399250aee093751e9373a6311cadbe76b6e0d109b853757f35/tree_sitter_typescript-0.23.2.tar.gz", hash = "sha256:7b167b5827c882261cb7a50dfa0fb567975f9b315e87ed87ad0a0a3aedb3834d", size = 773053, upload-time = "2024-11-11T02:36:11.396Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/28/95/4c00680866280e008e81dd621fd4d3f54aa3dad1b76b857a19da1b2cc426/tree_sitter_typescript-0.23.2-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:3cd752d70d8e5371fdac6a9a4df9d8924b63b6998d268586f7d374c9fba2a478", size = 286677, upload-time = "2024-11-11T02:35:58.839Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/2f/1f36fda564518d84593f2740d5905ac127d590baf5c5753cef2a88a89c15/tree_sitter_typescript-0.23.2-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:c7cc1b0ff5d91bac863b0e38b1578d5505e718156c9db577c8baea2557f66de8", size = 302008, upload-time = "2024-11-11T02:36:00.733Z" },
+    { url = "https://files.pythonhosted.org/packages/96/2d/975c2dad292aa9994f982eb0b69cc6fda0223e4b6c4ea714550477d8ec3a/tree_sitter_typescript-0.23.2-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4b1eed5b0b3a8134e86126b00b743d667ec27c63fc9de1b7bb23168803879e31", size = 351987, upload-time = "2024-11-11T02:36:02.669Z" },
+    { url = "https://files.pythonhosted.org/packages/49/d1/a71c36da6e2b8a4ed5e2970819b86ef13ba77ac40d9e333cb17df6a2c5db/tree_sitter_typescript-0.23.2-cp39-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e96d36b85bcacdeb8ff5c2618d75593ef12ebaf1b4eace3477e2bdb2abb1752c", size = 344960, upload-time = "2024-11-11T02:36:04.443Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/cb/f57b149d7beed1a85b8266d0c60ebe4c46e79c9ba56bc17b898e17daf88e/tree_sitter_typescript-0.23.2-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:8d4f0f9bcb61ad7b7509d49a1565ff2cc363863644a234e1e0fe10960e55aea0", size = 340245, upload-time = "2024-11-11T02:36:06.473Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/ab/dd84f0e2337296a5f09749f7b5483215d75c8fa9e33738522e5ed81f7254/tree_sitter_typescript-0.23.2-cp39-abi3-win_amd64.whl", hash = "sha256:3f730b66396bc3e11811e4465c41ee45d9e9edd6de355a58bbbc49fa770da8f9", size = 278015, upload-time = "2024-11-11T02:36:07.631Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/e4/81f9a935789233cf412a0ed5fe04c883841d2c8fb0b7e075958a35c65032/tree_sitter_typescript-0.23.2-cp39-abi3-win_arm64.whl", hash = "sha256:05db58f70b95ef0ea126db5560f3775692f609589ed6f8dd0af84b7f19f1cbb7", size = 274052, upload-time = "2024-11-11T02:36:09.514Z" },
+]
+
 [[package]]
 name = "typing-extensions"
 version = "4.16.0"
@@ -379,3 +581,18 @@ sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3
 wheels = [
     { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
 ]
+
+[[package]]
+name = "virtualenv"
+version = "21.9.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+    { name = "python-discovery" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2f/5d/42254e91a9203a13d95ab4f5211f4cdda52b82fc3546340f7fb33a642173/virtualenv-21.9.0.tar.gz", hash = "sha256:fa0f2a26fcb6f32b376fc8b2c705b6057366763d5b9e5242d1ab10ecc3279fd3", size = 5372770, upload-time = "2026-09-20T00:29:19.843Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9d/e5/9446b7a2a3d73de5f9fcf8f825efe78b071b111729e89f4ac07649b9448b/virtualenv-21.9.0-py3-none-any.whl", hash = "sha256:8c7cde05f630fbedf61758258014a92e6d6d5b4b9c6e6be7279d233f89e09aac", size = 5477625, upload-time = "2026-09-20T00:29:18.065Z" },
+]

From 307d002bc46dfd95fb66466f5aed68671f28c3a4 Mon Sep 17 00:00:00 2001
From: Paul Doho <paul.doho.741@my.csun.edu>
Date: Tue, 22 Sep 2026 00:04:39 +0100
Subject: [PATCH 2/2] feat: complete TypeScript facts extraction

---
 README.md                                     | 10 +-
 docs/map/index.html                           |  4 +-
 docs/map/map.json                             | 14 +--
 docs/reference.md                             |  2 +-
 pyproject.toml                                |  7 +-
 src/systemap/cli.py                           |  2 +
 src/systemap/config.py                        | 14 ++-
 src/systemap/extract.py                       | 46 +++++++--
 src/systemap/language.py                      | 12 ++-
 src/systemap/typescript.py                    | 99 ++++++++++++++++---
 tests/fixtures/typescript-app/map/model.py    | 37 +++++++
 tests/fixtures/typescript-app/package.json    |  6 ++
 tests/fixtures/typescript-app/src/cli.ts      |  1 +
 tests/fixtures/typescript-app/src/client.ts   |  3 +
 tests/fixtures/typescript-app/src/index.ts    |  3 +
 tests/fixtures/typescript-app/src/service.ts  |  6 ++
 tests/fixtures/typescript-app/src/view.tsx    |  1 +
 tests/fixtures/typescript-app/systemap.toml   |  6 ++
 .../typescript-app/tests/service.test.ts      |  3 +
 tests/fixtures/typescript-app/tsconfig.json   |  8 ++
 tests/test_typescript.py                      | 80 +++++++++++++++
 uv.lock                                       | 13 ++-
 22 files changed, 338 insertions(+), 39 deletions(-)
 create mode 100644 tests/fixtures/typescript-app/map/model.py
 create mode 100644 tests/fixtures/typescript-app/package.json
 create mode 100644 tests/fixtures/typescript-app/src/cli.ts
 create mode 100644 tests/fixtures/typescript-app/src/client.ts
 create mode 100644 tests/fixtures/typescript-app/src/index.ts
 create mode 100644 tests/fixtures/typescript-app/src/service.ts
 create mode 100644 tests/fixtures/typescript-app/src/view.tsx
 create mode 100644 tests/fixtures/typescript-app/systemap.toml
 create mode 100644 tests/fixtures/typescript-app/tests/service.test.ts
 create mode 100644 tests/fixtures/typescript-app/tsconfig.json

diff --git a/README.md b/README.md
index 8ff22dbc..335d1bb4 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
   <a href="https://pypi.org/project/systemap/"><img alt="the version on PyPI" src="https://img.shields.io/pypi/v/systemap?label=PyPI&color=e0a458&labelColor=121417"></a>
   <a href="https://pypi.org/project/systemap/"><img alt="the Python versions it runs on" src="https://img.shields.io/pypi/pyversions/systemap?color=b3b1aa&labelColor=121417"></a>
   <a href="LICENSE"><img alt="the licence" src="https://img.shields.io/pypi/l/systemap?color=8fbfa6&labelColor=121417"></a>
-  <img alt="how many dependencies it has" src="https://img.shields.io/badge/dependencies-2-b3b1aa?labelColor=121417">
+  <img alt="how many dependencies it has" src="https://img.shields.io/badge/dependencies-none-b3b1aa?labelColor=121417">
 </p>
 
 Your coding agent writes code faster than you can read it. You review the
@@ -77,6 +77,10 @@ your reviewer.
     uv tool install systemap        # or: uv add --dev systemap
     systemap init                   # --no-ci to skip the workflow
 
+For a TypeScript repository, install the parser extra:
+
+    uv tool install 'systemap[typescript]'
+
 `init` writes a configuration file, an empty map for your agent to fill in,
 the instructions your agent will follow, and a CI workflow. Then it prints the
 one sentence you hand to your agent:
@@ -187,8 +191,8 @@ features that failed their test were written down rather than shipped
 ## What is systemap not?
 
 It reads Python, TypeScript and TSX. TypeScript support reads exported names,
-imports, tests and package binaries; framework-specific routes and configured
-path aliases are not read yet. It is not a call graph: the map shows the lines
+imports, tests, package binaries and configured `tsconfig.json` path aliases;
+framework-specific routes are not read yet. It is not a call graph: the map shows the lines
 your agent declared and defended, not every function call. It is not a
 dependency diagram: modules are not parts, and the map shows parts. It is not
 a UML tool: one picture, one layout, and nothing to learn beyond card, line
diff --git a/docs/map/index.html b/docs/map/index.html
index 89b89c0e..a4a12ed9 100644
--- a/docs/map/index.html
+++ b/docs/map/index.html
@@ -177,7 +177,7 @@
 .systemap-panel{font-family:var(--fs);font-size:13px;line-height:1.45;color:var(--ink-2);background:var(--surface);border:1px solid var(--line);border-radius:8px;padding:.9rem 1rem 1rem;min-height:3rem}.systemap-panel:empty::before{content:'Click a component to read it.';color:var(--ink-3)}.systemap-f__plain{font-size:19px;font-weight:600;color:var(--ink);letter-spacing:-.01em;line-height:1.2;margin:0}.systemap-f__code{font-family:var(--fm);font-size:12px;color:var(--accent);margin:.3rem 0 0;display:flex;flex-wrap:wrap;gap:.2rem .7rem;align-items:baseline}.systemap-f__kind{color:var(--ink-3);font-size:11px;letter-spacing:.06em;text-transform:uppercase}.systemap-f__does{margin:.6rem 0 .2rem;font-size:13px;color:var(--ink-2)}.systemap-f__iface{margin:.3rem 0 .2rem;font-family:var(--fm);font-size:11.5px;color:var(--ink-2);word-break:break-word}.systemap-f__note{margin:.5rem 0 .2rem;padding:.4rem .6rem;font-size:12.5px;color:var(--ink);border-left:3px solid var(--warn);background:var(--raised);border-radius:0 6px 6px 0}.systemap-f__wheel{margin:.4rem 0 0}.systemap-f__wheel svg{width:100%;height:auto;display:block;margin:0 auto}.systemap-f__say{margin:.2rem 0 .6rem;padding:.55rem .7rem;font-size:13px;line-height:1.45;color:var(--ink);border-left:3px solid var(--accent);background:var(--raised);border-radius:0 6px 6px 0;min-height:2.6rem}.systemap-f__say.muted{color:var(--ink-3);border-left-color:var(--line-2)}.systemap-f__evidence{margin:-.3rem 0 .6rem;font-family:var(--fm);font-size:11px;color:var(--ink-3);min-height:1em}.systemap-f__evidence.declared{color:var(--warn)}.systemap-f__chips{display:flex;flex-wrap:wrap;gap:.35rem;margin:.5rem 0 0}.systemap-chip{display:inline-flex;align-items:center;gap:.35em;min-height:24px;padding:0 .55em;border-radius:4px;font-family:var(--fm);font-size:11px;letter-spacing:.04em;background:var(--raised);color:var(--ink-3);border:1px solid var(--line)}.systemap-chip--built{color:var(--good);border-color:transparent}.systemap-chip--actor{color:var(--ink-3);background:none;border:1px dashed var(--line-2)}.systemap-chip a{color:var(--accent);text-decoration:none}.systemap-chip a:hover{text-decoration:underline}.systemap-chip--rule{color:var(--violet);cursor:help;min-width:24px;justify-content:center}.systemap-f__lives{margin:.6rem 0 0;font-family:var(--fm);font-size:11px;color:var(--ink-3)}.systemap-f__lives b{font-weight:400;color:var(--ink-3)}.systemap-f__entry{margin:.4rem 0 0;font-family:var(--fm);font-size:11px;color:var(--ink-3)}.systemap-f__entry b{font-weight:400;color:var(--ink-2)}.systemap-f__opens{margin:.4rem 0 0;font-family:var(--fm);font-size:11px;color:var(--ink-3)}.systemap-f__opens b{font-weight:400;color:var(--ink-2)}.systemap-f__preview{margin:.5rem 0 0;border:1px solid var(--line);border-radius:6px;overflow:hidden;background:var(--bg)}.systemap-f__preview svg{width:100%;height:auto;display:block}.systemap-f__open{appearance:none;display:block;margin:.5rem 0 0;min-height:30px;padding:0 .8rem;border-radius:6px;border:1px solid var(--accent);background:none;color:var(--accent);font-family:var(--fs);font-size:12.5px;cursor:pointer}.systemap-f__open:hover{background:var(--raised)}.systemap-w__spoke{cursor:pointer;outline:none}.systemap-w__hit{stroke:transparent;stroke-width:26;fill:none;pointer-events:stroke}.systemap-w__line{fill:none;stroke-width:1.5;transition:stroke-width .12s ease}.systemap-w__verb{font-family:var(--fs);font-size:11px;font-weight:500;text-anchor:middle;paint-order:stroke;stroke:var(--surface);stroke-width:5;stroke-linejoin:round;pointer-events:none}.systemap-w__name{font-family:var(--fm);font-size:11px;font-weight:600;fill:var(--ink);pointer-events:none}.systemap-w__centre rect{fill:var(--raised);stroke:var(--accent);stroke-width:1.6}.systemap-w__centre text{font-family:var(--fm);font-size:12px;font-weight:600;fill:var(--ink);text-anchor:middle}.systemap-w__spoke.peek .systemap-w__line,.systemap-w__spoke:hover .systemap-w__line,.systemap-w__spoke:focus-visible .systemap-w__line{stroke-width:3.2}.systemap-w__spoke.peek .systemap-w__name,.systemap-w__spoke:hover .systemap-w__name,.systemap-w__spoke:focus-visible .systemap-w__name{fill:var(--accent)}.systemap-w__empty{font-family:var(--fs);font-size:12px;fill:var(--ink-3);text-anchor:middle}</style></head><body>
 <header class="bar">
 <h1>systemap <span>map</span></h1>
-<p class="meta">A generated map of what the parts of systemap are and what they are to each other: 16 components and 4 actors, 67 flows, five layers. Facts from <code title="the commit the tree was read at">83aabb8180</code>.</p>
+<p class="meta">A generated map of what the parts of systemap are and what they are to each other: 16 components and 4 actors, 67 flows, five layers. Facts from <code title="the commit the tree was read at">c2fea3ebb5</code>.</p>
 <nav class="nav">
 <a href="#map">Map</a><a href="#components">Components</a>
 <a href="#invariants">Invariants</a>
@@ -304,7 +304,7 @@ <h1>systemap <span>map</span></h1>
 <li id="rule-11" value="11"><span class="rules__t">check and judgement never reach the network; asking Jev is a separate command that sends nothing without a key (src/systemap/jev_cli.py, docstring).</span>
 <span class="governs"><button type="button" class="gv" data-go="Check">Check</button> <button type="button" class="gv" data-go="Judgement">Judgement</button> <button type="button" class="gv" data-go="SecondOpinion">SecondOpinion</button></span></li>
 </ol></section></main>
-<footer class="foot">Generated by <code>systemap</code> from <code>docs/map/map.json</code> and <code>map/model.py</code>. The facts are from <code>83aabb8180</code>, the commit the tree was read at when they were extracted: the one before the commit that records them, since the facts are committed after they are read. Refresh with <code>systemap refresh</code>.</footer>
+<footer class="foot">Generated by <code>systemap</code> from <code>docs/map/map.json</code> and <code>map/model.py</code>. The facts are from <code>c2fea3ebb5</code>, the commit the tree was read at when they were extracted: the one before the commit that records them, since the facts are committed after they are read. Refresh with <code>systemap refresh</code>.</footer>
 <script>(function(){
 var DETAIL = {"Placer":{"id":"Placer","kind":"component","region":"operate","plain":"what places the cards","does":"A first position for every card without one: regions on a two-column grid with corridors between them, in the order the search scores best (every order tried, the best routed and scored by collisions, refusals, bends and length), cards on the grid inside, ordered by barycentre sweeps over the flows. Writes the positions into map/model.py in place; with --all, lays every card out again and keeps the pinned ones.","state":"built","state_label":"built","lives":"systemap/place.py","interface":"compute(model) -> Placement; write(path, model, placement)","entry":"compute","entry_module":"systemap.place","note":"","calls_model":false,"map":null,"moved":false,"rules":[5],"edges":[3,38,39,46,47,48]},"CLI":{"id":"CLI","kind":"component","region":"operate","plain":"the commands","does":"The commands the agent runs: init, extract, check, render, figure, refresh, judgement, describe, serve, skill. Every non-zero exit names what to run next.","state":"built","state_label":"built","lives":"systemap/cli.py, systemap/__main__.py","interface":"main(argv) -> exit code: 0 current, 1 failed or stale, 2 unusable","entry":"main","entry_module":"systemap.cli","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[0,1,2,3,4,5,6,7,8,9,10,11,12,16]},"FactsExtractor":{"id":"FactsExtractor","kind":"component","region":"gather","plain":"what reads the code","does":"Walks the package's syntax tree and writes the facts: every module, its public surface and every public name, what it imports inside and outside the package, the tests that import it, and where a run can start. Nothing anyone writes changes what it finds; systemap facts reads them back one view at a time.","state":"built","state_label":"built","lives":"systemap/ (5 modules)","interface":"build(cfg) -> facts; drift(fresh, stored) -> what no longer matches","entry":"build","entry_module":"systemap.extract","note":"","calls_model":false,"map":null,"moved":false,"rules":[4],"edges":[5,17,24,30,32,33,34,35,40]},"Scaffold":{"id":"Scaffold","kind":"component","region":"operate","plain":"what init writes","does":"What init writes once and never overwrites: the configuration, a starter model laid out as a grid of regions with corridors between them, the output directory, a pinned workflow.","state":"built","state_label":"built","lives":"systemap/scaffold.py","interface":"write(root, name, package, roots, ci) -> one line per file","entry":"write","entry_module":"systemap.scaffold","note":"never overwrites a file that exists: an upgrade of systemap edits nothing init wrote, so a pinned workflow is bumped by hand","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[2,31]},"Config":{"id":"Config","kind":"store","region":"operate","plain":"the configuration","does":"systemap.toml, or [tool.systemap] in pyproject.toml, resolved with defaults: package roots and tests directories discovered, judgement answers kept with their reasons. Unknown keys, ignores and answers without a reason are refused.","state":"built","state_label":"built","lives":"systemap/config.py","interface":"load(root) -> Config; load_model(path) -> (MODEL, MEANING)","entry":"load","entry_module":"systemap.config","note":"","calls_model":false,"map":null,"moved":false,"rules":[9,10],"edges":[16,17,18,19,20,21,22,23]},"ChangeDetector":{"id":"ChangeDetector","kind":"component","region":"gather","plain":"what a branch changed","does":"Works out what a branch changes in the map's terms: which components moved, what each gained or lost on its public surface, which exported names were redefined, and how far the change reaches through imports. systemap delta reads the facts at two commits out of git and says what the change did to the map, one line per thing with its fix; systemap history reads many commits and says what moved between them.","state":"built","state_label":"built","lives":"systemap/ (5 modules)","interface":"compute(cfg, model, base, facts, head) -> change; delta.compute(cfg, model, meaning, base facts, head facts) -> Delta","entry":"compute","entry_module":"systemap.change","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[6,15,18,27,35,36,37,41,56]},"TypeSafe":{"id":"TypeSafe","kind":"actor","region":"outside","plain":"the model asked","does":"The Jev model behind TypeSafe's HTTP API: answers typed questions about the map when a maintainer has set a key.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[25,26]},"Skill":{"id":"Skill","kind":"component","region":"mean","plain":"the procedure the agent follows","does":"The procedure the agent follows: extract, draft, check, judgement, render, the second pass, the stop condition, what to hand back, and the maintenance path when the code changed. A directory of plain text with references, shipped in the package.","state":"built","state_label":"built","lives":"systemap/skill.py","interface":"files() -> the skill directory; write(dir) -> the installed SKILL.md","entry":"write","entry_module":"systemap.skill","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,7],"edges":[4,58]},"Figures":{"id":"Figures","kind":"component","region":"draw","plain":"a picture for a document","does":"One figure from the same generator, for a document: the whole system, a plan's reach, or a change. A .svg output is the bare drawing on its ground.","state":"built","state_label":"built","lives":"systemap/figure.py","interface":"make(cfg, model, meaning, theme, facts, mode, components, base, head, caption, layer) -> (html, collisions)","entry":"make","entry_module":"systemap.figure","note":"","calls_model":false,"map":null,"moved":false,"rules":[1],"edges":[9,14,20,37,50]},"Page":{"id":"Page","kind":"component","region":"draw","plain":"the page you open","does":"Wraps the schematic into one self-contained HTML page: the layer switch, journeys, the focus drawer, the index by region, the invariants. No fonts, scripts or images are fetched; systemap serve serves it over HTTP.","state":"built","state_label":"built","lives":"systemap/page.py","interface":"build(cfg, model, meaning, theme, facts, change) -> html","entry":"build","entry_module":"systemap.page","note":"","calls_model":false,"map":null,"moved":false,"rules":[1,8],"edges":[8,13,19,36,49,54]},"CI":{"id":"CI","kind":"actor","region":"outside","plain":"the runner that refuses","does":"Runs the check on every pull request and fails the ones that leave the map behind.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[1,57]},"Model":{"id":"Model","kind":"store","region":"mean","plain":"the map as written","does":"The schema a map is written in, and the file the agent writes in it: containers, regions, components, flows, invariants, and the meaning tables. Checks that the meaning names only what the model has, reads from the facts whether an import backs each flow (observed, external or declared), and loads the tree of maps when a card opens a map of its own.","state":"built","state_label":"built","lives":"/ (5 modules)","interface":"Model(canvas, containers, regions, components, flows, flow_kinds, invariants) and Meaning(plain, layers, relations, journeys, verbs), exported by map/model.py as MODEL and MEANING","entry":"Model","entry_module":"systemap","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,3,4,5],"edges":[31,38,39,40,41,42,43,59,60,61,65]},"Router":{"id":"Router","kind":"component","region":"draw","plain":"what finds the routes","does":"Routes every flow orthogonally through the gutters between cards, never through a card it does not connect, never across a band it neither starts nor ends in, and seats each label where it touches nothing.","state":"built","state_label":"built","lives":"systemap/route.py","interface":"route_all(edges, cards, actors, blocks, regions, region_of, canvas) -> routes; place_labels(routes, widths, height, obstacles, canvas) -> seated labels","entry":"route_all","entry_module":"systemap.route","note":"","calls_model":false,"map":null,"moved":false,"rules":[5],"edges":[44,45,46]},"Schematic":{"id":"Schematic","kind":"component","region":"draw","plain":"what draws the map","does":"Draws the SVG: cards marked by kind, routes coloured by layer, and the interaction script that lights a clicked component's neighbours, switches readings, steps journeys, pans and zooms. The theme is one table of tokens.","state":"built","state_label":"built","lives":"systemap/schematic.py, systemap/theme.py","interface":"render(model, meaning, theme, facts) -> (svg, detail JSON)","entry":"render","entry_module":"systemap.schematic","note":"","calls_model":false,"map":null,"moved":false,"rules":[1,3,5],"edges":[33,42,44,47,49,50,51,52]},"Maintainer":{"id":"Maintainer","kind":"actor","region":"outside","plain":"the person who confirms","does":"Reads the judgement answers, corrects the model where it disagrees, and commits the map.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[6],"edges":[54,60,64]},"Agent":{"id":"Agent","kind":"actor","region":"outside","plain":"the agent that draws","does":"Reads the skill, runs the commands, writes the model, fixes what the check names, and answers what the judgement asks.","state":"actor","state_label":"outside","lives":"","interface":"","entry":"","entry_module":"","note":"","calls_model":false,"map":null,"moved":false,"rules":[6,7],"edges":[0,53,55,56,58,59,63,66]},"Judgement":{"id":"Judgement","kind":"component","region":"keep","plain":"what asks","does":"The list the agent acts on and the maintainer confirms: single-module components, odd folds, flows without a sentence, thin layers, entry points without a journey, imports across a boundary with no flow, model SDK imports outside an agent. Answered lines, singly or by family, are suppressed and counted. A report; a gate only with --strict. Before any of it, systemap suggest proposes a first grouping from the facts, to argue with.","state":"built","state_label":"built","lives":"systemap/judgement.py, systemap/suggest.py, systemap/explain.py","interface":"run(model, meaning, facts, sdks) -> lines; exit 1 with --strict while a line is open","entry":"run","entry_module":"systemap.judgement","note":"","calls_model":false,"map":null,"moved":false,"rules":[2,6,7,11],"edges":[10,22,28,34,61,62,63,64]},"SecondOpinion":{"id":"SecondOpinion","kind":"component","region":"keep","plain":"what asks for a second opinion","does":"Help from outside this process, asked one narrow question at a time and cached: the Jev model for what judgement cannot read from names and imports (a module that reads like another card, a card for an unclaimed module, a sentence that may not describe its modules, a flow the code may not carry, an invariant that may govern a card it does not name, the cards an issue will change), and a coding agent named in the configuration for prose only a reader of the code can write. Opt-in; never a gate.","state":"built","state_label":"built","lives":"systemap/ (6 modules)","interface":"run(tree, facts, cfg, jev) -> lines; always exit 0","entry":"run","entry_module":"systemap.audit","note":"","calls_model":false,"map":null,"moved":false,"rules":[11],"edges":[12,23,24,25,26,27,28,29,65,66]},"Check":{"id":"Check","kind":"component","region":"keep","plain":"what refuses","does":"Every rule that refuses a lie: coverage, entry, interface, placement, routes, labels and card text, type size, meaning, wheels, and stale outputs. Each failure prints its fix; exit 1 on the first.","state":"built","state_label":"built","lives":"systemap/check.py","interface":"run(model, meaning, theme, facts, ignores) -> Result; stale(cfg, model, meaning, theme) -> lines","entry":"run","entry_module":"systemap.check","note":"","calls_model":false,"map":null,"moved":false,"rules":[4,5,6,10,11],"edges":[7,13,14,15,21,32,43,51,55,57,62]},"Describe":{"id":"Describe","kind":"component","region":"keep","plain":"what the picture shows","does":"What a look at the picture would tell an agent that cannot look: cards per region, bends and length per edge worst first, seats used per gutter, cards and edges per reading. A description, never a rule.","state":"built","state_label":"built","lives":"systemap/describe.py","interface":"run(model, meaning, theme, facts) -> lines; always exit 0","entry":"run","entry_module":"systemap.describe","note":"","calls_model":false,"map":null,"moved":false,"rules":[],"edges":[11,29,30,45,48,52,53]},"_meta":{"layers":[{"id":"structure","label":"Structure","question":"What are the parts, and where does each sit?","sub":"every component inside its region and container; no edges","colour":"var(--l-structure)","tag":"var(--lt-structure)","derived":true},{"id":"system","label":"System context","question":"Who and what is outside, and how does it reach in?","sub":"the actors, and every edge that crosses the boundary","colour":"var(--l-system)","tag":"var(--lt-system)","derived":true},{"id":"data","label":"Data flow","question":"What moves, and where does it go?","sub":"an artifact moves: a file, a record, a message, a response","colour":"var(--l-data)","tag":"var(--lt-data)","derived":false},{"id":"control","label":"Control flow","question":"Who drives whom?","sub":"one part invokes, schedules or drives another: a call, a command, an event","colour":"var(--l-control)","tag":"var(--lt-control)","derived":false},{"id":"judge","label":"What judges","question":"Where does the meaning come from, and who confirms it?","sub":"the skill, the agent, the model, the judgement, the maintainer","colour":"var(--l-judge)","tag":"var(--lt-judge)","derived":false}],"readings":{"structure":{"edges":[],"subjects":["Agent","CI","Maintainer","TypeSafe","CLI","Scaffold","Config","FactsExtractor","ChangeDetector","Placer","Skill","Model","Router","Schematic","Page","Figures","Check","Judgement","SecondOpinion","Describe"]},"system":{"edges":[0,1,25,26,53,54,55,56,57,58,59,60,63,64,66],"subjects":["Agent","CI","Maintainer","TypeSafe"]},"data":{"edges":[16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57],"subjects":[]},"control":{"edges":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"subjects":[]},"judge":{"edges":[58,59,60,61,62,63,64,65,66],"subjects":[]}},"reading":"","edges":[{"from":"Agent","to":"CLI","art":"commands","kind":"control","layer":"control","out":"runs","in":"is run by","say":"The agent drives everything through the commands; it never imports the package.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"CI","to":"CLI","art":"check","kind":"control","layer":"control","out":"runs","in":"is run by","say":"The workflow init writes runs the check on every push and pull request.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"CLI","to":"Scaffold","art":"init","kind":"control","layer":"control","out":"runs","in":"is run by","say":"init hands the scaffold the project's name and package roots; the scaffold writes what does not exist yet.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Placer","art":"place","kind":"control","layer":"control","out":"runs","in":"is run by","say":"place computes a position for every card without one, or with --all for every card not pinned, and writes it into the model; describe places them for one look without writing.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Skill","art":"init, skill","kind":"control","layer":"control","out":"runs","in":"is run by","say":"init installs the skill directory beside the project, and skill reinstalls it; an upgrade of the package refreshes it.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"FactsExtractor","art":"extract","kind":"control","layer":"control","out":"runs","in":"is run by","say":"extract, and the first step of refresh, run the extractor over the configured package roots.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"ChangeDetector","art":"--base, delta","kind":"control","layer":"control","out":"runs","in":"is run by","say":"render --base and figure --base ask the change detector what a git range moved; delta asks it what a change did to the map, from the facts at two commits.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Check","art":"check","kind":"control","layer":"control","out":"runs","in":"is run by","say":"check runs every rule and prints each failure with its fix; refresh runs the same rules before it renders.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Page","art":"render","kind":"control","layer":"control","out":"runs","in":"is run by","say":"render, and refresh, build the page from the facts and the model.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Figures","art":"figure","kind":"control","layer":"control","out":"runs","in":"is run by","say":"figure draws one figure to a file; refresh draws every figure the configuration lists.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Judgement","art":"judgement","kind":"control","layer":"control","out":"runs","in":"is run by","say":"judgement prints the list to act on or answer; with --strict it exits 1 while a line is open.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"Describe","art":"describe","kind":"control","layer":"control","out":"runs","in":"is run by","say":"describe draws the map the way the page does and prints what the drawing shows, in numbers.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"CLI","to":"SecondOpinion","art":"audit, triage, --jev","kind":"control","layer":"control","out":"runs","in":"is run by","say":"audit, triage and the --jev flags hand their questions to the second opinion; check and judgement never do.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"Page","art":"render to compare","kind":"control","layer":"control","out":"compares","in":"is compared by","say":"The stale rule renders the page from the stored facts and compares it with the committed one.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"Figures","art":"render to compare","kind":"control","layer":"control","out":"compares","in":"is compared by","say":"The stale rule renders every configured figure and compares it with the committed one.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Check","to":"ChangeDetector","art":"interface rule","kind":"control","layer":"control","out":"lends its rule to","in":"judges by","say":"delta judges an interface name that vanished by the check's own interface rule, so the two cannot disagree about what a line may start with.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"CLI","art":"settings","kind":"data","layer":"data","out":"configures","in":"is configured by","say":"The configuration tells the commands where the packages, the model and the output are.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"FactsExtractor","art":"package roots","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The package roots and the tests directory say what the extractor walks.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"ChangeDetector","art":"roots, tests dir","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The package roots and the tests directory say which changed files are modules and which are tests.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Page","art":"name, paths","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The page takes its title, its footer paths and the label for actors outside every region from the configuration.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Figures","art":"figures table","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The [[figures]] table says which figures refresh regenerates, in which mode, to which file.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Check","art":"ignores","kind":"data","layer":"data","out":"excuses modules to","in":"takes ignores from","say":"An ignore with a reason takes a module out of the coverage rule, on record.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"Judgement","art":"answers, sdks","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The answers under [judgement] suppress the lines they cover, and [facts] model_sdks extends or reduces the SDK list the model sdk line reads.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Config","to":"SecondOpinion","art":"answers, model, cache","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The configuration names the model, where its answers are cached, and the answers that suppress a jev line.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"SecondOpinion","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts give each question its state: a module's docstring, names and imports, and the lines where two cards meet.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"TypeSafe","art":"questions","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"One typed question at a time goes over HTTPS with the maintainer's key; nothing goes without it.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"TypeSafe","to":"SecondOpinion","art":"typed answers","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Jev sends back a probability or a choice with its distribution, which is cached by model release and question.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"SecondOpinion","to":"ChangeDetector","art":"moves Jev read","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"For delta --jev, the modules delta's own rules left unpaired go to Jev, and the new module it reads each as becomes one more move in delta's report.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"SecondOpinion","art":"the ways in with no walk","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Which ways into the system a journey walks from is one rule, and it lives in the judgement; the writer of journeys asks it what is left, so the two cannot disagree about what is covered.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"Describe","art":"the ways in with no walk","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe asks the writer of journeys how many ways into the system have no walk from them, and names the first few.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Describe","art":"entry points","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe names each way in the way a person would name it, which the extractor decides.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Scaffold","to":"Model","art":"starter","kind":"data","layer":"data","out":"writes the first","in":"starts as","say":"The starter model is the smallest map that passes every check; the agent replaces its words.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Check","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts are what the check judges coverage, entry and staleness against.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"Schematic","art":"map.json","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The facts file, written by extract and read back by every command, says which modules each card stands for and which flows an import backs.","evidence":"observed","mechanism":"facts file","evidence_says":"observed by: facts file"},{"from":"FactsExtractor","to":"Judgement","art":"entry points","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The entry points in the facts are what the judgement asks journeys for; the imports are what it walks for crossing edges.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"FactsExtractor","to":"ChangeDetector","art":"surfaces","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The change detector reads a module's public surface with the extractor's parser, on both sides of the diff, so the two cannot disagree about what a module exports.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"ChangeDetector","to":"Page","art":"change map","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"With --base, the page carries a change map: what moved, what it reached.","evidence":"declared","mechanism":"","evidence_says":"declared: no import behind it"},{"from":"ChangeDetector","to":"Figures","art":"reach","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"A change figure marks what a git range changed; a reach figure marks what a plan will.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Placer","art":"cards, flows","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer reads the cards, their regions and the flows between them; a card with x and y is kept, and with --all only a pinned card is.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Placer","to":"Model","art":"positions","kind":"data","layer":"data","out":"places","in":"is placed by","say":"The placer writes the positions, the boxes and the canvas into map/model.py in place; the rest of the file is kept byte for byte.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"FactsExtractor","art":"claims","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The extractor reads the model's claims to warn about a module the tree no longer has.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"ChangeDetector","art":"claims","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The change detector attributes changed modules to the components that claim them.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Schematic","art":"topology, meaning","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The model is the topology the schematic draws and the meaning it prints on the wheel.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Model","to":"Check","art":"model","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The check reads the model's own contradictions first; nothing else is judged until they are gone.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Schematic","art":"routes, labels","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The router hands back the routes and the seated labels, and reports what could not be placed cleanly, with the fix that applies.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Describe","art":"gutters, seats","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The router's gutters and seat counts are what describe reports per gutter.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Router","to":"Placer","art":"routes, seats","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer routes every shortlisted region order with the router and the label pass, and keeps the order with the fewest label collisions, refused routes, bends and length.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Placer","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The placer scores a candidate layout on the drawing's own geometry (the card boxes, the headers and empty containers as walls, what a label may not sit on) and reads the header measurements so a box it lays out holds its header.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Placer","to":"Describe","art":"region order, score","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"Describe reads the region order off the map as placed and the score of the drawing under it, and says how many orders place tried when it chose the order for the look.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Page","art":"svg, detail","kind":"data","layer":"data","out":"fills","in":"wraps","say":"The page embeds the SVG and the detail JSON the interaction script reads.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Figures","art":"svg","kind":"data","layer":"data","out":"fills","in":"wraps","say":"A figure is the same SVG in a figure element, or bare for an image.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Check","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"The check renders once and reads the geometry back: routes, labels, type size, wheels.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Schematic","to":"Describe","art":"geometry","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"describe renders once and reads the geometry back as a description: regions, edges, gutters, readings.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Describe","to":"Agent","art":"the picture in numbers","kind":"data","layer":"data","out":"describes to","in":"reads","say":"An agent that cannot open the page reads the picture in numbers after every refresh.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Page","to":"Maintainer","art":"the page","kind":"data","layer":"data","out":"is read by","in":"reads","say":"The maintainer opens the page: readings, click, journeys, pan and zoom.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Check","to":"Agent","art":"the fix","kind":"data","layer":"data","out":"refuses","in":"is refused by","say":"Every failure names its fix; the agent edits until coverage is complete and the layout is clean.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"ChangeDetector","to":"Agent","art":"what moved, and when","kind":"data","layer":"data","out":"feeds","in":"reads from","say":"delta hands back what a change did to the map, one line per thing with its fix; history hands back what moved over a year, the largest windows first with the commits that wrote them.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Check","to":"CI","art":"verdict","kind":"data","layer":"data","out":"answers","in":"asks","say":"Exit 1 fails the pull request; the message says what to run.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Skill","to":"Agent","art":"procedure","kind":"judge","layer":"judge","out":"guides","in":"follows","say":"The skill gives the agent the loop, the schema, a worked example, the second pass, and what to hand back.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Agent","to":"Model","art":"map/model.py","kind":"judge","layer":"judge","out":"writes","in":"is written by","say":"The agent writes map/model.py: the groupings, the flows, the sentences, the journeys, the invariants.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Maintainer","to":"Model","art":"corrections","kind":"judge","layer":"judge","out":"corrects","in":"is corrected by","say":"The maintainer corrects the calls they disagree with; the model is theirs once reviewed.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Model","to":"Judgement","art":"model","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The judgement reads the model for the calls that could have gone another way.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"Check","art":"the teaching under each line","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The lesson under each kind of line lives with the judgement, because that is where most kinds come from; the check reads it to say why a failing rule matters and what to do.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"Judgement","to":"Agent","art":"second-pass list","kind":"judge","layer":"judge","out":"asks","in":"answers","say":"In the second pass the agent walks every crossing import and every entry point without a journey, and changes the model or answers the line.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Judgement","to":"Maintainer","art":"judgement answers","kind":"judge","layer":"judge","out":"reports to","in":"confirms","say":"The maintainer reads the agent's answers, line by line; the list is mechanical to produce, so the review cannot be skipped.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"},{"from":"Model","to":"SecondOpinion","art":"cards, sentences","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The model's cards, sentences, flows and invariants are what the questions ask about.","evidence":"observed","mechanism":"","evidence_says":"observed: an import joins them"},{"from":"SecondOpinion","to":"Agent","art":"jev lines","kind":"judge","layer":"judge","out":"informs","in":"reads","say":"The agent gets a jev line where the answer disagrees with the map, to act on or answer like a judgement line; when the configuration names an agent command, it is also asked the questions whose answer is prose.","evidence":"external","mechanism":"","evidence_says":"external: outside the code"}],"journeys":[{"id":"over-time","label":"A year of the system: what moved, and what wrote it","starts":"systemap history (subcommand)","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"Somebody asks what the last year did to the system: systemap history, since a date, one sample every so many days."},{"acts":["ChangeDetector"],"measures":[],"edge":6,"say":"The change detector picks one commit per window out of git, oldest first, so a busy fortnight and a quiet one weigh the same."},{"acts":["FactsExtractor"],"measures":[],"edge":35,"say":"The facts at each commit are extracted from the tree git holds, never from the working copy, and kept under .systemap/facts so the second run is quick."},{"acts":["ChangeDetector"],"measures":["Model"],"edge":41,"say":"Every sample is read in today's cards, so a module that moved still counts as the card whose job it does."},{"acts":["ChangeDetector"],"measures":[],"edge":56,"say":"The largest windows are printed first: the cards that grew, the imports that began crossing a boundary, and the commits that wrote the modules which appeared."}]},{"id":"plan-then-check","label":"A plan: the cards the work will touch, then what it actually touched","starts":"plan (subcommand in systemap.jev_cli)","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"Before the work, the agent or the maintainer runs systemap plan with the task in plain words."},{"acts":["SecondOpinion"],"measures":[],"edge":65,"say":"The projection reads every card's purpose out of the model, so the question is asked in the map's own vocabulary."},{"acts":["SecondOpinion"],"measures":[],"edge":25,"say":"One question goes to Jev: which component will this work most likely have to change?"},{"acts":["TypeSafe"],"measures":[],"edge":26,"say":"Jev answers with a weight for every card, and the cards above the measured cut are the projection."},{"acts":["SecondOpinion"],"measures":[],"edge":66,"say":"Around each card named, the map prints the flows, walks and rules it sits in, and the projection is written under .systemap/plans."},{"acts":["ChangeDetector"],"measures":["SecondOpinion"],"edge":35,"say":"After the work, systemap plan --check reads the facts where the work started and the facts now, and names every card that changed outside the plan."}]},{"id":"second-opinion","label":"A second opinion: systemap audit, and triage for an issue","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"With a key set and the judgement clean, the agent runs systemap audit; a maintainer with an issue in hand runs systemap triage."},{"acts":["SecondOpinion"],"measures":[],"edge":65,"say":"The second opinion reads the cards, sentences, flows and invariants, and the facts behind them, into one narrow question each."},{"acts":["SecondOpinion"],"measures":[],"edge":25,"say":"Questions the cache cannot answer go to Jev over HTTPS; audit --dry-run says what would leave the machine first."},{"acts":["TypeSafe"],"measures":[],"edge":26,"say":"Jev answers each with a probability or a choice, and every answer is cached by the model's release."},{"acts":["SecondOpinion"],"measures":["Agent"],"edge":66,"say":"A jev line where the answer disagrees with the map, or triage's three likeliest cards; the agent acts on a line or answers it under [judgement]."}]},{"id":"first-map","label":"The first map: systemap init, extract, a draft, check","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent runs systemap init: configuration, starter model, the workflow."},{"acts":["CLI"],"measures":[],"edge":4,"say":"init installs the skill directory beside the project; systemap skill reinstalls it later."},{"acts":["Skill"],"measures":[],"edge":58,"say":"The skill gives the agent the loop: extract, draft, check, judgement, render, second pass."},{"acts":["FactsExtractor"],"measures":[],"edge":5,"say":"systemap extract reads every module, its surface, its imports and the entry points out of the tree."},{"acts":["Agent"],"measures":[],"edge":59,"say":"The agent runs systemap suggest for a first grouping to argue with, then writes map/model.py: components, flows, one sentence per edge, a journey per entry point, and no positions."},{"acts":["Placer"],"measures":[],"edge":39,"say":"systemap place lays the regions out on a grid with corridors between them, puts every card on it, and writes the positions into the file."},{"acts":["Check"],"measures":["Check"],"edge":55,"say":"systemap check names each failure and its fix; the agent edits until coverage is N/N and the layout is clean."}]},{"id":"second-pass","label":"The second pass: judgement, then refresh","starts":"","drafted":false,"steps":[{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent runs systemap judgement."},{"acts":["Judgement"],"measures":[],"edge":34,"say":"The judgement walks the imports in the facts for edges the model lacks, and the entry points for journeys it lacks."},{"acts":["Judgement"],"measures":["Judgement"],"edge":63,"say":"One line per crossing import, per entry point without a journey, per thin layer: the agent changes the model or answers the line."},{"acts":["Agent"],"measures":[],"edge":59,"say":"The agent adds the missed edges, regroups what was grouped by directory, and reruns check; a full pass that changes nothing is the stop."},{"acts":["Page"],"measures":[],"edge":8,"say":"systemap refresh renders the page and every configured figure; systemap describe says what the picture shows, and systemap serve opens the page for anyone who can look."},{"acts":["Judgement"],"measures":["Maintainer"],"edge":64,"say":"The agent answers the remaining judgement lines in systemap.toml, under [judgement] answered, singly or by family; judgement --strict exits 0, and the maintainer reads the answers and commits docs/map."}]},{"id":"refactor","label":"A refactor moves a module: the maintenance path","starts":"","drafted":false,"steps":[{"acts":["CI"],"measures":[],"edge":1,"say":"A pull request moves a module; the workflow runs systemap delta --base against the base branch and posts what the change did to the map as one comment."},{"acts":["ChangeDetector"],"measures":[],"edge":6,"say":"The detector reads the facts at both commits out of git, never from the working copy, and names the card that still names the old path, with the rename that fixes it."},{"acts":["Check"],"measures":["CI"],"edge":57,"say":"The job fails while a line needs a decision; the comment names each fix, so the map is maintained in the pull request that changed the code."},{"acts":["Agent"],"measures":[],"edge":0,"say":"The agent follows the maintenance path: acts on the delta's lines alone, never redrawing the map, then runs refresh, check and judgement --strict, and commits docs/map."},{"acts":["Page"],"measures":["Maintainer"],"edge":54,"say":"The maintainer reads the page: the moved part is where the code now says it is."}]}],"regions":[{"id":"operate","label":"OPERATE","box":[250.0,80.0,380.0,204.0],"ids":["CLI","Scaffold","Config","Placer"]},{"id":"gather","label":"GATHER","box":[678.0,80.0,190.0,204.0],"ids":["FactsExtractor","ChangeDetector"]},{"id":"mean","label":"MEAN","box":[250.0,320.0,190.0,204.0],"ids":["Skill","Model"]},{"id":"draw","label":"DRAW","box":[678.0,320.0,380.0,204.0],"ids":["Router","Schematic","Page","Figures"]},{"id":"keep","label":"KEEP TRUE","box":[250.0,560.0,380.0,296.0],"ids":["Check","Judgement","SecondOpinion","Describe"]}],"rules":[{"n":1,"text":"No counts of code or tests anywhere on the page: the map explains what the system does, not how much of it there is (README, Principles).","ids":["Figures","Page","Schematic"]},{"n":2,"text":"A component is something a reader would point at and name; a module is not a part (README, Principles).","ids":["Judgement","Model","Skill"]},{"n":3,"text":"Edges carry the relationships; prose is for emphasis (README, Principles).","ids":["Model","Schematic"]},{"n":4,"text":"The map draws what exists today: every module a component names is in the facts, and nothing on the map is a plan (README, Principles).","ids":["Check","FactsExtractor","Model"]},{"n":5,"text":"Positions are fixed in the model, written once by systemap place or by hand, and the checker decides, so the same system always draws the same picture (README, Principles).","ids":["Check","Model","Placer","Router","Schematic"]},{"n":6,"text":"The agent authors, the checker refuses, the person reviews (README, Principles).","ids":["Agent","Check","Judgement","Maintainer"]},{"n":7,"text":"The map is built in passes; the second pass is the point (README, Principles).","ids":["Agent","Judgement","Skill"]},{"n":8,"text":"The page fetches nothing and depends on nothing (README, opening).","ids":["Page"]},{"n":9,"text":"An unknown configuration key is refused, never ignored (src/systemap/config.py, load: 'unknown key').","ids":["Config"]},{"n":10,"text":"Every ignored module needs a reason (tests/test_coverage.py: test_ignore_without_reason_is_a_config_error).","ids":["Check","Config"]},{"n":11,"text":"check and judgement never reach the network; asking Jev is a separate command that sends nothing without a key (src/systemap/jev_cli.py, docstring).","ids":["Check","Judgement","SecondOpinion"]}],"kinds":["judge"],"states":{"built":20},"evidence":{"observed":51,"external":15,"declared":1},"collisions":[],"notes":[],"headers":[{"id":"outside","kind":"container","box":[24,22,152.4,54]},{"id":"systemap","kind":"container","box":[238,22,360.8,42]},{"id":"operate","kind":"region","box":[256,85,150.0,24]},{"id":"gather","kind":"region","box":[684,85,150.0,24]},{"id":"mean","kind":"region","box":[256,325,150.0,24]},{"id":"draw","kind":"region","box":[684,325,150.0,24]},{"id":"keep","kind":"region","box":[256,565,150.0,24]}]}};
 var PAL = {"ink": "var(--ink)"};
diff --git a/docs/map/map.json b/docs/map/map.json
index 6bc30df5..72cafef2 100644
--- a/docs/map/map.json
+++ b/docs/map/map.json
@@ -1,19 +1,19 @@
 {
-"built_at_commit":"83aabb818069b62c3cce16dea34dcb3d4a0ebda7",
+"built_at_commit":"c2fea3ebb5203b6bd8dc666468ee9df51efe25c0",
 "components":{
 "systemap":{"classes":[],"constants":[],"docstring":"systemap: the map your coding agent draws of your system.","errors":[],"external":[],"file":"src/systemap/__init__.py","functions":[],"id":"systemap","imported_by":["systemap.cli","systemap.scaffold"],"imports":["systemap.model"],"loc":48,"names":[{"kind":"constant","name":"AGENT_KINDS","reexport_of":"systemap.model"},{"kind":"constant","name":"KINDS","reexport_of":"systemap.model"},{"kind":"constant","name":"STANDARD_KINDS","reexport_of":"systemap.model"},{"kind":"class","name":"Component","reexport_of":"systemap.model"},{"kind":"class","name":"Container","reexport_of":"systemap.model"},{"kind":"class","name":"Flow","reexport_of":"systemap.model"},{"kind":"class","name":"Invariant","reexport_of":"systemap.model"},{"kind":"class","name":"Journey","reexport_of":"systemap.model"},{"kind":"class","name":"Layer","reexport_of":"systemap.model"},{"kind":"class","name":"Meaning","reexport_of":"systemap.model"},{"kind":"class","name":"Model","reexport_of":"systemap.model"},{"kind":"class","name":"Region","reexport_of":"systemap.model"},{"kind":"class","name":"Step","reexport_of":"systemap.model"},{"kind":"function","name":"all_layers","reexport_of":"systemap.model"},{"kind":"function","name":"build_state","reexport_of":"systemap.model"}],"package":"systemap","plane":"core","sha":"8aa181586acb","tests":["test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_extract_on_tiny_package_via_cli","test_figure_command","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_marketplace_points_at_the_repository_root","test_plugin_manifest_version_is_the_package_version","test_plugin_skill_tree_is_identical_to_the_package_skill_tree","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_skill_front_matter_fits_the_plugin_limits","test_skill_is_a_directory_of_named_references","test_stale_after_code_change"],"tests_primary":0,"tests_total":18,"uses":{"systemap.model":["AGENT_KINDS","Component","Container","Flow","Invariant","Journey","KINDS","Layer","Meaning","Model","Region","STANDARD_KINDS","Step","all_layers","build_state"]}},
 "systemap.__main__":{"classes":[],"constants":[],"docstring":"","errors":[],"external":[],"file":"src/systemap/__main__.py","functions":[],"id":"systemap.__main__","imported_by":[],"imports":["systemap.cli"],"loc":6,"names":[],"package":"systemap","plane":"core","sha":"0e1e6e0c4977","tests":[],"tests_primary":0,"tests_total":0,"uses":{"systemap.cli":["main"]}},
 "systemap.agent":{"classes":[{"methods":["def line(self) -> str"],"name":"Usage"},{"methods":["def ask(self, question: str, context: Any=None) -> str"],"name":"Agent"}],"constants":[{"name":"TIMEOUT","value":"300.0"},{"name":"OUTPUT_CAP","value":"200000"},{"name":"NO_AGENT","value":"'no agent is set, so this is the structure without the prose. Name one under [ag"}],"docstring":"The one door to a coding agent: a question and the structure, prose back.","errors":[{"methods":[],"name":"AgentError"}],"external":[],"file":"src/systemap/agent.py","functions":[{"name":"cache_key","signature":"def cache_key(command: str, question: str, context: Any) -> str"},{"name":"shell_run","signature":"def shell_run(command: str, question: str, cwd: Path, timeout: float) -> str"},{"name":"from_cfg","signature":"def from_cfg(cfg: Config, run_command: Run | None=None) -> Agent"},{"name":"has_agent","signature":"def has_agent(cfg: Config) -> bool"}],"id":"systemap.agent","imported_by":["systemap.jev_cli","systemap.journeys"],"imports":["systemap.config","systemap.jev"],"loc":158,"names":[{"kind":"constant","name":"TIMEOUT"},{"kind":"constant","name":"OUTPUT_CAP"},{"kind":"constant","name":"NO_AGENT"},{"kind":"error","name":"AgentError"},{"kind":"function","name":"cache_key"},{"kind":"class","name":"Usage"},{"kind":"object","name":"Run"},{"kind":"function","name":"shell_run"},{"kind":"class","name":"Agent"},{"kind":"function","name":"from_cfg"},{"kind":"function","name":"has_agent"}],"package":"systemap","plane":"core","sha":"694b69e9fd9a","tests":["test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_describe_and_judgement_agree_that_a_crowd_is_walked","test_describe_names_the_steps_the_code_does_not_back","test_describe_says_where_each_walk_starts_and_how_many_ways_in_are_walked","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_the_agent_is_asked_once_and_remembered","test_the_agent_is_shown_the_crowd_and_a_sample_of_it"],"tests_primary":0,"tests_total":35,"uses":{"systemap.config":["Config"],"systemap.jev":["Cache"]}},
 "systemap.audit":{"classes":[{"methods":[],"name":"Line"},{"methods":["def add(self, key: str, state: Any, questions: dict[str, Any], read: Any) -> None"],"name":"Plan"}],"constants":[{"name":"MISFOLD_BELOW","value":"0.05"},{"name":"OWNER_AT","value":"0.9"},{"name":"SENTENCE_BELOW","value":"0.2"},{"name":"FLOW_BELOW","value":"0.2"},{"name":"GOVERNS_AT","value":"0.8"},{"name":"QUESTION_OF","value":"{'jev mis-fold': 'owner', 'jev owner': 'owner', 'jev sentence': 'sentence', 'jev"},{"name":"DEFAULT_KINDS","value":"tuple((k for k in QUESTION_OF if k != 'jev flow'))"},{"name":"KINDS","value":"AUDIT_KINDS"},{"name":"NONE","value":"'none of these'"},{"name":"OWNER_Q","value":"'Which component of this system does `module` belong to? Each option is one part"},{"name":"DESCRIBES_Q","value":"'Does `sentence` accurately describe what the code in `modules` does, taken toge"},{"name":"VERIFY_Q","value":"'Does the code in `code` support the claim in `claim`: that `claim.from` passes "},{"name":"GOVERNS_Q","value":"'Does `rule` directly govern `component`: is it one of the parts whose code must"},{"name":"READERS","value":"{'owner': owner_line, 'sentence': sentence_line, 'flow': flow_line, 'governs': g"}],"docstring":"`systemap audit`: a second opinion from Jev on the calls the map makes.","errors":[],"external":[],"file":"src/systemap/audit.py","functions":[{"name":"module_state","signature":"def module_state(facts: dict[str, Any], m: str, doc_cap: int=600, names_cap: int=40) -> dict[str, Any]"},{"name":"card_brief","signature":"def card_brief(model: Model, meaning: Meaning, cid: str) -> str"},{"name":"owner_criteria","signature":"def owner_criteria(model: Model, meaning: Meaning) -> dict[str, str]"},{"name":"owner_question","signature":"def owner_question(model: Model, meaning: Meaning) -> dict[str, Any]"},{"name":"lines_using","signature":"def lines_using(root: Path, facts: dict[str, Any], module: str, names: set[str]) -> list[str]"},{"name":"code_between","signature":"def code_between(root: Path, facts: dict[str, Any], mods: dict[str, list[str]], src: str, dst: str) -> list[str]"},{"name":"modules_by_card","signature":"def modules_by_card(model: Model, facts: dict[str, Any]) -> dict[str, list[str]]"},{"name":"unclaimed","signature":"def unclaimed(model: Model, facts: dict[str, Any], ignores: Iterable[str]) -> list[str]"},{"name":"plan_owner","signature":"def plan_owner(plan: Plan, m: nest.Map, facts: dict[str, Any], extra: list[str], system: str, placed_too: bool=True) -> None"},{"name":"plan_sentences","signature":"def plan_sentences(plan: Plan, m: nest.Map, facts: dict[str, Any]) -> None"},{"name":"plan_flows","signature":"def plan_flows(plan: Plan, m: nest.Map, facts: dict[str, Any], root: Path) -> None"},{"name":"plan_governs","signature":"def plan_governs(plan: Plan, m: nest.Map) -> None"},{"name":"make_plan","signature":"def make_plan(tree: nest.Tree, facts: dict[str, Any], cfg: Config, kinds: Iterable[str]=DEFAULT_KINDS) -> Plan"},{"name":"owner_line","signature":"def owner_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"sentence_line","signature":"def sentence_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"flow_line","signature":"def flow_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"governs_line","signature":"def governs_line(read: tuple[Any, ...], answers: Answers) -> Line | None"},{"name":"lines","signature":"def lines(plan: Plan, answered: dict[str, Answers]) -> list[Line]"},{"name":"run","signature":"def run(tree: nest.Tree, facts: dict[str, Any], cfg: Config, jev: Jev, kinds: Iterable[str]=DEFAULT_KINDS) -> list[Line]"},{"name":"is_audit_answer","signature":"def is_audit_answer(answer: Answer) -> bool"},{"name":"apply","signature":"def apply(found: list[Line], given: Iterable[Answer], kinds: Iterable[str]=DEFAULT_KINDS) -> tuple[list[Line], int, list[str]]"},{"name":"report","signature":"def report(open_lines: list[Line], answered: int, stale: list[str], usage: str, teach: bool=True) -> list[str]"},{"name":"dry_run","signature":"def dry_run(plan: Plan, pending: int | None) -> list[str]"}],"id":"systemap.audit","imported_by":["systemap.cli","systemap.jev_cli"],"imports":["systemap.config","systemap.evidence","systemap.explain","systemap.extract","systemap.jev","systemap.model","systemap.nest"],"loc":485,"names":[{"kind":"constant","name":"MISFOLD_BELOW"},{"kind":"constant","name":"OWNER_AT"},{"kind":"constant","name":"SENTENCE_BELOW"},{"kind":"constant","name":"FLOW_BELOW"},{"kind":"constant","name":"GOVERNS_AT"},{"kind":"constant","name":"QUESTION_OF"},{"kind":"constant","name":"DEFAULT_KINDS"},{"kind":"constant","name":"KINDS"},{"kind":"constant","name":"NONE"},{"kind":"constant","name":"OWNER_Q"},{"kind":"constant","name":"DESCRIBES_Q"},{"kind":"constant","name":"VERIFY_Q"},{"kind":"constant","name":"GOVERNS_Q"},{"kind":"class","name":"Line"},{"kind":"class","name":"Plan"},{"kind":"function","name":"module_state"},{"kind":"function","name":"card_brief"},{"kind":"function","name":"owner_criteria"},{"kind":"function","name":"owner_question"},{"kind":"function","name":"lines_using"},{"kind":"function","name":"code_between"},{"kind":"function","name":"modules_by_card"},{"kind":"function","name":"unclaimed"},{"kind":"function","name":"plan_owner"},{"kind":"function","name":"plan_sentences"},{"kind":"function","name":"plan_flows"},{"kind":"function","name":"plan_governs"},{"kind":"function","name":"make_plan"},{"kind":"function","name":"owner_line"},{"kind":"function","name":"sentence_line"},{"kind":"function","name":"flow_line"},{"kind":"function","name":"governs_line"},{"kind":"constant","name":"READERS"},{"kind":"function","name":"lines"},{"kind":"function","name":"run"},{"kind":"function","name":"is_audit_answer"},{"kind":"function","name":"apply"},{"kind":"function","name":"report"},{"kind":"function","name":"dry_run"}],"package":"systemap","plane":"core","sha":"7cc232fdf760","tests":["test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_an_answer_about_a_kind_not_asked_is_not_stale","test_apply_suppresses_answered_lines_and_reports_stale_answers","test_audit_answers_are_told_apart_from_judgement_answers","test_audit_cli_end_to_end_over_http","test_audit_dry_run_sends_no_question","test_audit_on_recorded_answers","test_audit_without_a_key_says_so_and_exits_1","test_by_default_the_flow_question_is_not_asked","test_cache_answers_a_second_run_and_a_new_release_invalidates_it","test_config_accepts_audit_kinds_and_a_jev_table","test_delta_asks_only_about_the_unclaimed_modules","test_flow_state_holds_the_lines_where_the_two_cards_meet","test_groups_are_connected_components_largest_first","test_judgement_ignores_audit_answers","test_misfold_fires_below_the_threshold_only","test_no_key_sends_nothing","test_pair_candidates_chain_each_package_and_add_imports","test_plan_asks_one_question_per_module_card_flow_and_invariant_pair","test_recordings_hold_real_responses","test_retries_then_succeeds_or_raises_with_the_status","test_sentence_flow_and_governs_thresholds","test_triage_names_the_cards_with_their_modules","test_unclaimed_module_gets_one_card_when_confident_else_three","test_unclaimed_modules_are_asked_about_on_the_top_map"],"tests_primary":26,"tests_total":26,"uses":{"systemap.config":["AUDIT_KINDS","Answer","Config"],"systemap.evidence":["owners"],"systemap.explain":["*"],"systemap.extract":["is_empty_marker"],"systemap.jev":["Answers","Ask","Jev"],"systemap.model":["Meaning","Model","module_matches"],"systemap.nest":["*"]}},
-"systemap.change":{"classes":[],"constants":[{"name":"BUCKETS","value":"('operations', 'types', 'refusals', 'constants')"}],"docstring":"Work out what a branch changes about the system, in logical terms.","errors":[],"external":[],"file":"src/systemap/change.py","functions":[{"name":"pr_meta","signature":"def pr_meta(repo: Path, pr: str) -> dict[str, Any]"},{"name":"surface_delta","signature":"def surface_delta(base_raw: str, head_raw: str, language: LanguageAdapter=extract.PYTHON, path: str='') -> dict[str, Any] | None"},{"name":"compute","signature":"def compute(cfg: Config, model: Model, base: str, facts: dict[str, Any], head: str='HEAD', artifact_owner: dict[str, str] | None=None) -> dict[str, Any]"}],"id":"systemap.change","imported_by":["systemap.cli","systemap.figure"],"imports":["systemap.config","systemap.extract","systemap.language","systemap.model"],"loc":310,"names":[{"kind":"constant","name":"BUCKETS"},{"kind":"function","name":"pr_meta"},{"kind":"function","name":"surface_delta"},{"kind":"function","name":"compute"}],"package":"systemap","plane":"core","sha":"c62b889f4c61","tests":["test_init_detects_a_typescript_repository","test_typescript_extracts_surface_imports_tests_and_entry_points","test_typescript_roots_are_discovered_from_package_metadata","test_typescript_surface_and_change_use_the_same_parser","test_typescript_test_names_are_literal_and_nested"],"tests_primary":0,"tests_total":5,"uses":{"systemap.config":["Config"],"systemap.extract":["*"],"systemap.language":["LanguageAdapter"],"systemap.model":["Model","module_matches"]}},
+"systemap.change":{"classes":[],"constants":[{"name":"BUCKETS","value":"('operations', 'types', 'refusals', 'constants')"}],"docstring":"Work out what a branch changes about the system, in logical terms.","errors":[],"external":[],"file":"src/systemap/change.py","functions":[{"name":"pr_meta","signature":"def pr_meta(repo: Path, pr: str) -> dict[str, Any]"},{"name":"surface_delta","signature":"def surface_delta(base_raw: str, head_raw: str, language: LanguageAdapter=extract.PYTHON, path: str='') -> dict[str, Any] | None"},{"name":"compute","signature":"def compute(cfg: Config, model: Model, base: str, facts: dict[str, Any], head: str='HEAD', artifact_owner: dict[str, str] | None=None) -> dict[str, Any]"}],"id":"systemap.change","imported_by":["systemap.cli","systemap.figure"],"imports":["systemap.config","systemap.extract","systemap.language","systemap.model"],"loc":310,"names":[{"kind":"constant","name":"BUCKETS"},{"kind":"function","name":"pr_meta"},{"kind":"function","name":"surface_delta"},{"kind":"function","name":"compute"}],"package":"systemap","plane":"core","sha":"c62b889f4c61","tests":["test_init_detects_a_typescript_repository","test_init_refuses_an_ambiguous_python_and_typescript_repository","test_typescript_discovers_nested_source_and_refuses_module_id_collisions","test_typescript_extracts_surface_imports_tests_and_entry_points","test_typescript_fixture_resolves_aliases_tsx_and_runs_end_to_end","test_typescript_parse_failure_is_not_an_empty_module","test_typescript_roots_are_discovered_from_package_metadata","test_typescript_surface_and_change_use_the_same_parser","test_typescript_test_names_are_literal_and_nested"],"tests_primary":0,"tests_total":9,"uses":{"systemap.config":["Config"],"systemap.extract":["*"],"systemap.language":["LanguageAdapter"],"systemap.model":["Model","module_matches"]}},
 "systemap.check":{"classes":[{"methods":["def ok(self) -> bool"],"name":"Coverage"},{"methods":["def ok(self) -> bool"],"name":"Result"}],"constants":[{"name":"MONO_CHAR_W","value":"6.6"},{"name":"NAME_LINE_H","value":"13.0"},{"name":"NOT_COUNTED","value":"Coverage(True, 0, 0, 0, (), counted=False)"},{"name":"ENTRY_OPTIONAL","value":"('store', 'context')"},{"name":"INTERFACE_HEAD","value":"re.compile('\\\\s*([A-Za-z_][A-Za-z0-9_]*)(?:\\\\.([A-Za-z_][A-Za-z0-9_]*))?')"}],"docstring":"Check the map geometry and the meaning tables mechanically.","errors":[],"external":[],"file":"src/systemap/check.py","functions":[{"name":"check_labels","signature":"def check_labels(meta: dict[str, Any]) -> list[str]"},{"name":"check_routes","signature":"def check_routes(meta: dict[str, Any], model: Model) -> tuple[list[str], int, int]"},{"name":"check_type_size","signature":"def check_type_size(svg: str) -> list[str]"},{"name":"wrap_name","signature":"def wrap_name(cid: str) -> list[str]"},{"name":"wheel_boxes","signature":"def wheel_boxes(cid: str, edges: list[dict[str, str]], layers: tuple[Layer, ...]) -> tuple[Box, list[tuple[str, Box]]]"},{"name":"check_wheels","signature":"def check_wheels(edges: list[dict[str, str]], model: Model, meaning: Meaning) -> list[str]"},{"name":"check_coverage","signature":"def check_coverage(model: Model, facts: dict[str, Any], ignores: Iterable[Ignore]) -> Coverage"},{"name":"check_nesting","signature":"def check_nesting(parent: Model, card: Component, sub: Model, facts: dict[str, Any], sub_label: str) -> list[str]"},{"name":"check_entry","signature":"def check_entry(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"interface_head","signature":"def interface_head(text: str) -> tuple[str, str] | None"},{"name":"method_names","signature":"def method_names(record: Mapping[str, Any], class_name: str) -> set[str]"},{"name":"check_interface","signature":"def check_interface(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"interface_problem","signature":"def interface_problem(c: Component, components: Mapping[str, Any]) -> str"},{"name":"stale_facts","signature":"def stale_facts(fresh: dict[str, Any], stored: dict[str, Any], model: Model, prefixes: set[str]) -> list[str]"},{"name":"stale","signature":"def stale(cfg: Config, tree: nest.Tree, fresh: dict[str, Any] | None=None) -> list[str]"},{"name":"run","signature":"def run(model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], ignores: Iterable[Ignore]=(), observed_by: Iterable[str]=(), *, coverage: bool=True) -> Result"},{"name":"run_tree","signature":"def run_tree(tree: nest.Tree, facts: dict[str, Any], ignores: Iterable[Ignore]=(), observed_by: Iterable[str]=()) -> dict[str, Result]"},{"name":"tree_ok","signature":"def tree_ok(results: Mapping[str, Result]) -> bool"},{"name":"with_stale","signature":"def with_stale(result: Result, lines: list[str]) -> Result"},{"name":"coverage_line","signature":"def coverage_line(cov: Coverage) -> str"},{"name":"report","signature":"def report(model: Model, result: Result, model_file: str='the model', prefix: str='', teach: bool=True) -> list[str]"},{"name":"report_stale","signature":"def report_stale(lines: list[str], teach: bool=True) -> list[str]"}],"id":"systemap.check","imported_by":["systemap.cli","systemap.delta"],"imports":["systemap.config","systemap.explain","systemap.extract","systemap.figure","systemap.model","systemap.nest","systemap.page","systemap.schematic"],"loc":895,"names":[{"kind":"object","name":"Box"},{"kind":"function","name":"check_labels"},{"kind":"function","name":"check_routes"},{"kind":"function","name":"check_type_size"},{"kind":"constant","name":"MONO_CHAR_W"},{"kind":"constant","name":"NAME_LINE_H"},{"kind":"function","name":"wrap_name"},{"kind":"function","name":"wheel_boxes"},{"kind":"function","name":"check_wheels"},{"kind":"class","name":"Coverage"},{"kind":"function","name":"check_coverage"},{"kind":"constant","name":"NOT_COUNTED"},{"kind":"function","name":"check_nesting"},{"kind":"constant","name":"ENTRY_OPTIONAL"},{"kind":"function","name":"check_entry"},{"kind":"constant","name":"INTERFACE_HEAD"},{"kind":"function","name":"interface_head"},{"kind":"function","name":"method_names"},{"kind":"function","name":"check_interface"},{"kind":"function","name":"interface_problem"},{"kind":"function","name":"stale_facts"},{"kind":"function","name":"stale"},{"kind":"class","name":"Result"},{"kind":"function","name":"run"},{"kind":"function","name":"run_tree"},{"kind":"function","name":"tree_ok"},{"kind":"function","name":"with_stale"},{"kind":"function","name":"coverage_line"},{"kind":"function","name":"report"},{"kind":"function","name":"report_stale"}],"package":"systemap","plane":"core","sha":"cf82e3eb652e","tests":["test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_full_gutter_names_its_seats_and_the_fix","test_a_json_answer_is_unwrapped","test_a_label_collision_names_both_labels","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_lesson_prints_as_two_rows_under_the_line","test_a_package_init_records_the_names_it_reexports","test_a_positioned_card_stays_where_it_was","test_a_symbol_card_needs_an_entry_among_its_symbols","test_a_symbol_claim_counts_as_a_defined_name","test_a_symbol_claim_passes_and_counts_for_no_module","test_a_symbol_of_a_module_nobody_claims_is_refused","test_a_symbol_the_module_does_not_define_is_refused","test_actor_claims_no_code_and_is_not_checked","test_agent_kinds_are_cards_that_claim_code","test_agent_layers_appear_only_with_an_agent","test_agent_model_checks_clean_and_draws_the_marks","test_an_interface_edit_renders_and_refresh_says_what_current_means","test_calls_model_in_the_model_module","test_card_text_budgets_by_kind","test_check_passes_on_sample"],"tests_primary":0,"tests_total":99,"uses":{"systemap.config":["Config","Ignore"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.figure":["*"],"systemap.model":["Component","Layer","Meaning","Model","all_layers","claimed","defines_entry","is_symbol","module_matches","problems","public_names","symbol_claims"],"systemap.nest":["*"],"systemap.page":["*"],"systemap.schematic":["TEXT_PX","render"]}},
-"systemap.cli":{"classes":[{"methods":["def model(self) -> Model","def meaning(self) -> Meaning","def theme(self) -> dict[str, Any]"],"name":"Project"}],"constants":[{"name":"AGENT_SENTENCE","value":"'Map this repository with systemap. Follow the systemap skill.'"},{"name":"MAINTENANCE_SENTENCE","value":"\"The code changed. Update the map with systemap: follow the systemap skill's mai"},{"name":"NO_COMPONENTS","value":"'the model has no components yet; see the skill'"},{"name":"ALREADY_CURRENT","value":"\"map: already current: the page matches the model's rendered fields and the fact"},{"name":"DEFAULT_PORT","value":"8765"}],"docstring":"The `systemap` command: what the agent runs.","errors":[],"external":[],"file":"src/systemap/cli.py","functions":[{"name":"say","signature":"def say(*lines: str) -> None"},{"name":"warn","signature":"def warn(*lines: str) -> None"},{"name":"cmd_init","signature":"def cmd_init(args: argparse.Namespace) -> int"},{"name":"cmd_extract","signature":"def cmd_extract(args: argparse.Namespace) -> int"},{"name":"cmd_facts","signature":"def cmd_facts(args: argparse.Namespace) -> int"},{"name":"cmd_render","signature":"def cmd_render(args: argparse.Namespace) -> int"},{"name":"cmd_check","signature":"def cmd_check(args: argparse.Namespace) -> int"},{"name":"cmd_figure","signature":"def cmd_figure(args: argparse.Namespace) -> int"},{"name":"cmd_refresh","signature":"def cmd_refresh(args: argparse.Namespace) -> int"},{"name":"cmd_judgement","signature":"def cmd_judgement(args: argparse.Namespace) -> int"},{"name":"cmd_delta","signature":"def cmd_delta(args: argparse.Namespace) -> int"},{"name":"cmd_suggest","signature":"def cmd_suggest(args: argparse.Namespace) -> int"},{"name":"cmd_history","signature":"def cmd_history(args: argparse.Namespace) -> int"},{"name":"cmd_explain","signature":"def cmd_explain(args: argparse.Namespace) -> int"},{"name":"cmd_describe","signature":"def cmd_describe(args: argparse.Namespace) -> int"},{"name":"cmd_place","signature":"def cmd_place(args: argparse.Namespace) -> int"},{"name":"make_server","signature":"def make_server(directory: Path, port: int) -> ThreadingHTTPServer"},{"name":"cmd_serve","signature":"def cmd_serve(args: argparse.Namespace) -> int"},{"name":"cmd_skill","signature":"def cmd_skill(args: argparse.Namespace) -> int"},{"name":"build_parser","signature":"def build_parser() -> argparse.ArgumentParser"},{"name":"main","signature":"def main(argv: list[str] | None=None) -> int"}],"id":"systemap.cli","imported_by":["systemap.__main__","systemap.jev_cli"],"imports":["systemap","systemap.audit","systemap.change","systemap.check","systemap.config","systemap.delta","systemap.describe","systemap.explain","systemap.extract","systemap.facts","systemap.figure","systemap.history","systemap.jev","systemap.jev_cli","systemap.judgement","systemap.model","systemap.nest","systemap.page","systemap.place","systemap.scaffold","systemap.skill","systemap.suggest","systemap.trend"],"loc":1215,"names":[{"kind":"class","name":"Project"},{"kind":"function","name":"say"},{"kind":"function","name":"warn"},{"kind":"constant","name":"AGENT_SENTENCE"},{"kind":"constant","name":"MAINTENANCE_SENTENCE"},{"kind":"function","name":"cmd_init"},{"kind":"function","name":"cmd_extract"},{"kind":"function","name":"cmd_facts"},{"kind":"function","name":"cmd_render"},{"kind":"constant","name":"NO_COMPONENTS"},{"kind":"function","name":"cmd_check"},{"kind":"function","name":"cmd_figure"},{"kind":"constant","name":"ALREADY_CURRENT"},{"kind":"function","name":"cmd_refresh"},{"kind":"function","name":"cmd_judgement"},{"kind":"function","name":"cmd_delta"},{"kind":"function","name":"cmd_suggest"},{"kind":"function","name":"cmd_history"},{"kind":"function","name":"cmd_explain"},{"kind":"function","name":"cmd_describe"},{"kind":"function","name":"cmd_place"},{"kind":"constant","name":"DEFAULT_PORT"},{"kind":"function","name":"make_server"},{"kind":"function","name":"cmd_serve"},{"kind":"function","name":"cmd_skill"},{"kind":"function","name":"build_parser"},{"kind":"function","name":"main"}],"package":"systemap","plane":"core","sha":"585e7e7b3b32","tests":["test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_extract_on_tiny_package_via_cli","test_figure_command","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_stale_after_code_change","test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_full_gutter_names_its_seats_and_the_fix"],"tests_primary":13,"tests_total":281,"uses":{"systemap":["__version__"],"systemap.audit":["*"],"systemap.change":["*"],"systemap.check":["*"],"systemap.config":["*"],"systemap.delta":["*"],"systemap.describe":["*"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.facts":["*"],"systemap.figure":["*"],"systemap.history":["*"],"systemap.jev":["*"],"systemap.jev_cli":["*"],"systemap.judgement":["*"],"systemap.model":["Meaning","Model","problems"],"systemap.nest":["*"],"systemap.page":["*"],"systemap.place":["*"],"systemap.scaffold":["*"],"systemap.skill":["*"],"systemap.suggest":["*"],"systemap.trend":["*"]}},
-"systemap.config":{"classes":[{"methods":[],"name":"Figure"},{"methods":[],"name":"Ignore"},{"methods":["def label(self) -> str"],"name":"Answer"},{"methods":["def model_path(self) -> Path","def out_path(self) -> Path","def jev_cache_path(self) -> Path","def agent_cache_path(self) -> Path","def facts_path(self) -> Path","def page_path(self) -> Path","def roots(self) -> list[tuple[Path, str]]","def prefixes(self) -> set[str]","def test_dirs(self) -> tuple[str, ...]","def rel(self, path: Path) -> str"],"name":"Config"}],"constants":[{"name":"CONFIG_FILE","value":"'systemap.toml'"},{"name":"SKIP_DIRS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist', 'tests', 'docs"},{"name":"SKIP_WALK","value":"SKIP_DIRS - {'tests'} | {'venv'}"},{"name":"TEST_DIR_NAMES","value":"('tests', 'test')"},{"name":"CANDIDATE_DEPTH","value":"4"},{"name":"KNOWN_KEYS","value":"{'language', 'name', 'package_roots', 'tests_dir', 'model', 'out_dir', 'facts_fi"},{"name":"FACTS_KEYS","value":"{'model_sdks'}"},{"name":"FLOWS_KEYS","value":"{'observed_by'}"},{"name":"JEV_KEYS","value":"{'model', 'cache', 'enabled'}"},{"name":"AGENT_KEYS","value":"{'command', 'cache', 'timeout'}"},{"name":"FIGURE_KEYS","value":"{'out', 'mode', 'components', 'caption', 'interactive', 'svg_id', 'layer', 'map'"},{"name":"COVERAGE_KEYS","value":"{'ignore'}"},{"name":"IGNORE_KEYS","value":"{'module', 'reason'}"},{"name":"JUDGEMENT_KEYS","value":"{'answered'}"}],"docstring":"Project configuration: `systemap.toml` at the repo root, or `[tool.systemap]`.","errors":[{"methods":[],"name":"ConfigError"}],"external":[],"file":"src/systemap/config.py","functions":[{"name":"find_root","signature":"def find_root(start: Path) -> Path | None"},{"name":"discover_typescript_roots","signature":"def discover_typescript_roots(root: Path) -> list[tuple[str, str]]"},{"name":"workspace_members","signature":"def workspace_members(root: Path) -> list[Path]"},{"name":"discover_roots","signature":"def discover_roots(root: Path) -> list[tuple[str, str]]"},{"name":"discover_tests","signature":"def discover_tests(root: Path) -> list[str]"},{"name":"candidate_packages","signature":"def candidate_packages(root: Path, depth: int=CANDIDATE_DEPTH) -> list[str]"},{"name":"default_name","signature":"def default_name(root: Path) -> str"},{"name":"read_raw","signature":"def read_raw(root: Path) -> tuple[dict[str, Any], str]"},{"name":"load","signature":"def load(root: Path) -> Config"},{"name":"load_model","signature":"def load_model(path: Path, label: str='') -> tuple[Model, Meaning]"}],"id":"systemap.config","imported_by":["systemap.agent","systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.extract","systemap.figure","systemap.history","systemap.jev_cli","systemap.judgement","systemap.nest","systemap.page","systemap.plan","systemap.trend"],"imports":["systemap.model"],"loc":837,"names":[{"kind":"constant","name":"CONFIG_FILE"},{"kind":"constant","name":"SKIP_DIRS"},{"kind":"constant","name":"SKIP_WALK"},{"kind":"constant","name":"TEST_DIR_NAMES"},{"kind":"constant","name":"CANDIDATE_DEPTH"},{"kind":"constant","name":"KNOWN_KEYS"},{"kind":"constant","name":"FACTS_KEYS"},{"kind":"constant","name":"FLOWS_KEYS"},{"kind":"constant","name":"JEV_KEYS"},{"kind":"constant","name":"AGENT_KEYS"},{"kind":"constant","name":"FIGURE_KEYS"},{"kind":"constant","name":"COVERAGE_KEYS"},{"kind":"constant","name":"IGNORE_KEYS"},{"kind":"constant","name":"JUDGEMENT_KEYS"},{"kind":"constant","name":"ANSWER_FORMS"},{"kind":"constant","name":"ANSWER_KEYS"},{"kind":"constant","name":"LINE_KINDS"},{"kind":"constant","name":"AUDIT_KINDS"},{"kind":"error","name":"ConfigError"},{"kind":"class","name":"Figure"},{"kind":"class","name":"Ignore"},{"kind":"class","name":"Answer"},{"kind":"class","name":"Config"},{"kind":"function","name":"find_root"},{"kind":"function","name":"discover_typescript_roots"},{"kind":"function","name":"workspace_members"},{"kind":"function","name":"discover_roots"},{"kind":"function","name":"discover_tests"},{"kind":"function","name":"candidate_packages"},{"kind":"function","name":"default_name"},{"kind":"function","name":"read_raw"},{"kind":"function","name":"load"},{"kind":"function","name":"load_model"}],"package":"systemap","plane":"core","sha":"60fced1f2967","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_custom_layer_may_not_take_a_standard_id","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_json_answer_is_unwrapped","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_lesson_prints_as_two_rows_under_the_line","test_a_model_may_import_a_module_beside_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_a_package_init_records_the_names_it_reexports","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_positioned_card_stays_where_it_was"],"tests_primary":0,"tests_total":216,"uses":{"systemap.model":["Meaning","Model"]}},
+"systemap.cli":{"classes":[{"methods":["def model(self) -> Model","def meaning(self) -> Meaning","def theme(self) -> dict[str, Any]"],"name":"Project"}],"constants":[{"name":"AGENT_SENTENCE","value":"'Map this repository with systemap. Follow the systemap skill.'"},{"name":"MAINTENANCE_SENTENCE","value":"\"The code changed. Update the map with systemap: follow the systemap skill's mai"},{"name":"NO_COMPONENTS","value":"'the model has no components yet; see the skill'"},{"name":"ALREADY_CURRENT","value":"\"map: already current: the page matches the model's rendered fields and the fact"},{"name":"DEFAULT_PORT","value":"8765"}],"docstring":"The `systemap` command: what the agent runs.","errors":[],"external":[],"file":"src/systemap/cli.py","functions":[{"name":"say","signature":"def say(*lines: str) -> None"},{"name":"warn","signature":"def warn(*lines: str) -> None"},{"name":"cmd_init","signature":"def cmd_init(args: argparse.Namespace) -> int"},{"name":"cmd_extract","signature":"def cmd_extract(args: argparse.Namespace) -> int"},{"name":"cmd_facts","signature":"def cmd_facts(args: argparse.Namespace) -> int"},{"name":"cmd_render","signature":"def cmd_render(args: argparse.Namespace) -> int"},{"name":"cmd_check","signature":"def cmd_check(args: argparse.Namespace) -> int"},{"name":"cmd_figure","signature":"def cmd_figure(args: argparse.Namespace) -> int"},{"name":"cmd_refresh","signature":"def cmd_refresh(args: argparse.Namespace) -> int"},{"name":"cmd_judgement","signature":"def cmd_judgement(args: argparse.Namespace) -> int"},{"name":"cmd_delta","signature":"def cmd_delta(args: argparse.Namespace) -> int"},{"name":"cmd_suggest","signature":"def cmd_suggest(args: argparse.Namespace) -> int"},{"name":"cmd_history","signature":"def cmd_history(args: argparse.Namespace) -> int"},{"name":"cmd_explain","signature":"def cmd_explain(args: argparse.Namespace) -> int"},{"name":"cmd_describe","signature":"def cmd_describe(args: argparse.Namespace) -> int"},{"name":"cmd_place","signature":"def cmd_place(args: argparse.Namespace) -> int"},{"name":"make_server","signature":"def make_server(directory: Path, port: int) -> ThreadingHTTPServer"},{"name":"cmd_serve","signature":"def cmd_serve(args: argparse.Namespace) -> int"},{"name":"cmd_skill","signature":"def cmd_skill(args: argparse.Namespace) -> int"},{"name":"build_parser","signature":"def build_parser() -> argparse.ArgumentParser"},{"name":"main","signature":"def main(argv: list[str] | None=None) -> int"}],"id":"systemap.cli","imported_by":["systemap.__main__","systemap.jev_cli"],"imports":["systemap","systemap.audit","systemap.change","systemap.check","systemap.config","systemap.delta","systemap.describe","systemap.explain","systemap.extract","systemap.facts","systemap.figure","systemap.history","systemap.jev","systemap.jev_cli","systemap.judgement","systemap.model","systemap.nest","systemap.page","systemap.place","systemap.scaffold","systemap.skill","systemap.suggest","systemap.trend"],"loc":1217,"names":[{"kind":"class","name":"Project"},{"kind":"function","name":"say"},{"kind":"function","name":"warn"},{"kind":"constant","name":"AGENT_SENTENCE"},{"kind":"constant","name":"MAINTENANCE_SENTENCE"},{"kind":"function","name":"cmd_init"},{"kind":"function","name":"cmd_extract"},{"kind":"function","name":"cmd_facts"},{"kind":"function","name":"cmd_render"},{"kind":"constant","name":"NO_COMPONENTS"},{"kind":"function","name":"cmd_check"},{"kind":"function","name":"cmd_figure"},{"kind":"constant","name":"ALREADY_CURRENT"},{"kind":"function","name":"cmd_refresh"},{"kind":"function","name":"cmd_judgement"},{"kind":"function","name":"cmd_delta"},{"kind":"function","name":"cmd_suggest"},{"kind":"function","name":"cmd_history"},{"kind":"function","name":"cmd_explain"},{"kind":"function","name":"cmd_describe"},{"kind":"function","name":"cmd_place"},{"kind":"constant","name":"DEFAULT_PORT"},{"kind":"function","name":"make_server"},{"kind":"function","name":"cmd_serve"},{"kind":"function","name":"cmd_skill"},{"kind":"function","name":"build_parser"},{"kind":"function","name":"main"}],"package":"systemap","plane":"core","sha":"eaeecf780f33","tests":["test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_extract_on_tiny_package_via_cli","test_figure_command","test_init_no_ci_skips_the_workflow","test_init_then_refresh_round_trip","test_init_workflow_posts_the_delta_on_a_pull_request","test_init_writes_an_empty_model_and_a_pinned_workflow","test_rendered_files_end_with_a_newline","test_serve_command_prints_the_url_and_stops_on_interrupt","test_serve_serves_the_output_directory","test_skill_command_writes_the_skill","test_stale_after_code_change","test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_full_gutter_names_its_seats_and_the_fix"],"tests_primary":13,"tests_total":285,"uses":{"systemap":["__version__"],"systemap.audit":["*"],"systemap.change":["*"],"systemap.check":["*"],"systemap.config":["*"],"systemap.delta":["*"],"systemap.describe":["*"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.facts":["*"],"systemap.figure":["*"],"systemap.history":["*"],"systemap.jev":["*"],"systemap.jev_cli":["*"],"systemap.judgement":["*"],"systemap.model":["Meaning","Model","problems"],"systemap.nest":["*"],"systemap.page":["*"],"systemap.place":["*"],"systemap.scaffold":["*"],"systemap.skill":["*"],"systemap.suggest":["*"],"systemap.trend":["*"]}},
+"systemap.config":{"classes":[{"methods":[],"name":"Figure"},{"methods":[],"name":"Ignore"},{"methods":["def label(self) -> str"],"name":"Answer"},{"methods":["def model_path(self) -> Path","def out_path(self) -> Path","def jev_cache_path(self) -> Path","def agent_cache_path(self) -> Path","def facts_path(self) -> Path","def page_path(self) -> Path","def roots(self) -> list[tuple[Path, str]]","def prefixes(self) -> set[str]","def test_dirs(self) -> tuple[str, ...]","def rel(self, path: Path) -> str"],"name":"Config"}],"constants":[{"name":"CONFIG_FILE","value":"'systemap.toml'"},{"name":"SKIP_DIRS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist', 'tests', 'docs"},{"name":"SKIP_WALK","value":"SKIP_DIRS - {'tests'} | {'venv'}"},{"name":"TEST_DIR_NAMES","value":"('tests', 'test')"},{"name":"CANDIDATE_DEPTH","value":"4"},{"name":"KNOWN_KEYS","value":"{'language', 'name', 'package_roots', 'tests_dir', 'model', 'out_dir', 'facts_fi"},{"name":"FACTS_KEYS","value":"{'model_sdks'}"},{"name":"FLOWS_KEYS","value":"{'observed_by'}"},{"name":"JEV_KEYS","value":"{'model', 'cache', 'enabled'}"},{"name":"AGENT_KEYS","value":"{'command', 'cache', 'timeout'}"},{"name":"FIGURE_KEYS","value":"{'out', 'mode', 'components', 'caption', 'interactive', 'svg_id', 'layer', 'map'"},{"name":"COVERAGE_KEYS","value":"{'ignore'}"},{"name":"IGNORE_KEYS","value":"{'module', 'reason'}"},{"name":"JUDGEMENT_KEYS","value":"{'answered'}"}],"docstring":"Project configuration: `systemap.toml` at the repo root, or `[tool.systemap]`.","errors":[{"methods":[],"name":"ConfigError"}],"external":[],"file":"src/systemap/config.py","functions":[{"name":"find_root","signature":"def find_root(start: Path) -> Path | None"},{"name":"discover_typescript_roots","signature":"def discover_typescript_roots(root: Path) -> list[tuple[str, str]]"},{"name":"workspace_members","signature":"def workspace_members(root: Path) -> list[Path]"},{"name":"discover_roots","signature":"def discover_roots(root: Path) -> list[tuple[str, str]]"},{"name":"discover_tests","signature":"def discover_tests(root: Path) -> list[str]"},{"name":"candidate_packages","signature":"def candidate_packages(root: Path, depth: int=CANDIDATE_DEPTH) -> list[str]"},{"name":"default_name","signature":"def default_name(root: Path) -> str"},{"name":"read_raw","signature":"def read_raw(root: Path) -> tuple[dict[str, Any], str]"},{"name":"load","signature":"def load(root: Path) -> Config"},{"name":"load_model","signature":"def load_model(path: Path, label: str='') -> tuple[Model, Meaning]"}],"id":"systemap.config","imported_by":["systemap.agent","systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.extract","systemap.figure","systemap.history","systemap.jev_cli","systemap.judgement","systemap.nest","systemap.page","systemap.plan","systemap.trend","systemap.typescript"],"imports":["systemap.model"],"loc":847,"names":[{"kind":"constant","name":"CONFIG_FILE"},{"kind":"constant","name":"SKIP_DIRS"},{"kind":"constant","name":"SKIP_WALK"},{"kind":"constant","name":"TEST_DIR_NAMES"},{"kind":"constant","name":"CANDIDATE_DEPTH"},{"kind":"constant","name":"KNOWN_KEYS"},{"kind":"constant","name":"FACTS_KEYS"},{"kind":"constant","name":"FLOWS_KEYS"},{"kind":"constant","name":"JEV_KEYS"},{"kind":"constant","name":"AGENT_KEYS"},{"kind":"constant","name":"FIGURE_KEYS"},{"kind":"constant","name":"COVERAGE_KEYS"},{"kind":"constant","name":"IGNORE_KEYS"},{"kind":"constant","name":"JUDGEMENT_KEYS"},{"kind":"constant","name":"ANSWER_FORMS"},{"kind":"constant","name":"ANSWER_KEYS"},{"kind":"constant","name":"LINE_KINDS"},{"kind":"constant","name":"AUDIT_KINDS"},{"kind":"error","name":"ConfigError"},{"kind":"class","name":"Figure"},{"kind":"class","name":"Ignore"},{"kind":"class","name":"Answer"},{"kind":"class","name":"Config"},{"kind":"function","name":"find_root"},{"kind":"function","name":"discover_typescript_roots"},{"kind":"function","name":"workspace_members"},{"kind":"function","name":"discover_roots"},{"kind":"function","name":"discover_tests"},{"kind":"function","name":"candidate_packages"},{"kind":"function","name":"default_name"},{"kind":"function","name":"read_raw"},{"kind":"function","name":"load"},{"kind":"function","name":"load_model"}],"package":"systemap","plane":"core","sha":"6f9a0430a59e","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_custom_layer_may_not_take_a_standard_id","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_json_answer_is_unwrapped","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_lesson_prints_as_two_rows_under_the_line","test_a_model_may_import_a_module_beside_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_a_package_init_records_the_names_it_reexports","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_positioned_card_stays_where_it_was"],"tests_primary":0,"tests_total":220,"uses":{"systemap.model":["Meaning","Model"]}},
 "systemap.delta":{"classes":[{"methods":[],"name":"Line"},{"methods":["def open(self) -> list[Line]","def quiet(self) -> list[Line]","def named(self) -> list[str]","def has_change(self) -> bool","def past_a_third(self) -> bool"],"name":"Delta"}],"constants":[{"name":"KINDS","value":"('moved', 'added', 'removed', 'entry vanished', 'interface vanished', 'new cross"},{"name":"MARKER","value":"'<!-- systemap delta -->'"},{"name":"NEXT","value":"'systemap refresh && systemap check && systemap judgement --strict'"},{"name":"FULL_LOOP_SHARE","value":"1 / 3"},{"name":"FULL_LOOP","value":"'more than a third of the cards are named: the skill says to run the full loop i"}],"docstring":"What a change does to the map: `systemap delta --base REF [--head REF]`.","errors":[{"methods":[],"name":"DeltaError"}],"external":[],"file":"src/systemap/delta.py","functions":[{"name":"resolve","signature":"def resolve(repo: Path, ref: str) -> str"},{"name":"merge_base","signature":"def merge_base(repo: Path, base: str, head: str) -> str"},{"name":"facts_at","signature":"def facts_at(cfg: Config, sha: str) -> dict[str, Any]"},{"name":"remote_repository","signature":"def remote_repository(repo: Path) -> str"},{"name":"figure_url","signature":"def figure_url(cfg: Config, sha: str) -> str"},{"name":"with_claims","signature":"def with_claims(model: Model, mapping: dict[str, str]) -> Model"},{"name":"compute","signature":"def compute(cfg: Config, model: Model, meaning: Meaning, base: dict[str, Any], head: dict[str, Any], base_ref: str='', head_ref: str='', *, model_file: str='', within: str='', prefix: str='', told: Mapping[str, tuple[str, str]]=moves_mod.NO_MOVES) -> Delta"},{"name":"compute_tree","signature":"def compute_tree(cfg: Config, tree: nest.Tree, base: dict[str, Any], head: dict[str, Any], base_ref: str='', head_ref: str='', told: Mapping[str, tuple[str, str]]=moves_mod.NO_MOVES) -> Delta"},{"name":"with_claims_of","signature":"def with_claims_of(card: Component, mapping: dict[str, str]) -> Component"},{"name":"report","signature":"def report(d: Delta, teach: bool=True) -> list[str]"},{"name":"near_lines","signature":"def near_lines(d: Delta, teach: bool=True) -> list[str]"},{"name":"markdown","signature":"def markdown(d: Delta, figure: str='') -> str"}],"id":"systemap.delta","imported_by":["systemap.cli","systemap.history","systemap.jev_cli"],"imports":["systemap.check","systemap.config","systemap.evidence","systemap.explain","systemap.extract","systemap.graph","systemap.judgement","systemap.model","systemap.moves","systemap.nest"],"loc":770,"names":[{"kind":"constant","name":"KINDS"},{"kind":"constant","name":"MARKER"},{"kind":"constant","name":"NEXT"},{"kind":"constant","name":"FULL_LOOP_SHARE"},{"kind":"error","name":"DeltaError"},{"kind":"function","name":"resolve"},{"kind":"function","name":"merge_base"},{"kind":"function","name":"facts_at"},{"kind":"function","name":"remote_repository"},{"kind":"function","name":"figure_url"},{"kind":"class","name":"Line"},{"kind":"class","name":"Delta"},{"kind":"function","name":"with_claims"},{"kind":"function","name":"compute"},{"kind":"function","name":"compute_tree"},{"kind":"function","name":"with_claims_of"},{"kind":"constant","name":"FULL_LOOP"},{"kind":"function","name":"report"},{"kind":"function","name":"near_lines"},{"kind":"function","name":"markdown"}],"package":"systemap","plane":"core","sha":"2190f620e2a5","tests":["test_a_card_joined_to_a_third_of_the_map_names_none","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_every_line_kind_with_its_fix","test_markdown_is_the_comment_with_the_committed_figure","test_nothing_to_do_and_no_change_exit_zero","test_the_base_is_the_merge_base_and_the_working_copy_is_not_read","test_the_best_pairing_wins_over_the_first_free_one","test_the_cards_next_to_the_change_are_printed_as_context","test_the_context_is_in_the_pull_request_comment_once","test_the_seed_is_the_card_with_the_most_changed_modules","test_two_empty_modules_with_different_names_are_not_joined","test_unknown_ref_is_refused","test_with_claims_renames_modules_and_symbols_and_keeps_patterns","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_check_fails_on_overlapping_fixture","test_configuration_errors_exit_2","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_extract_on_tiny_package_via_cli","test_figure_command"],"tests_primary":13,"tests_total":40,"uses":{"systemap.check":["interface_head","interface_problem"],"systemap.config":["Config"],"systemap.evidence":["*"],"systemap.explain":["*"],"systemap.extract":["*"],"systemap.graph":["*"],"systemap.judgement":["answers","crossing_line","crossing_pairs"],"systemap.model":["Component","Meaning","Model","claimed","defines_entry","is_symbol","module_matches","symbol_claims"],"systemap.moves":["*"],"systemap.nest":["*"]}},
 "systemap.describe":{"classes":[],"constants":[],"docstring":"What the picture shows, in numbers, for an agent that cannot see it.","errors":[],"external":[],"file":"src/systemap/describe.py","functions":[{"name":"bends","signature":"def bends(points: list[list[float]]) -> int"},{"name":"length","signature":"def length(points: list[list[float]]) -> float"},{"name":"gutter_lines","signature":"def gutter_lines(labels: list[dict[str, Any]], paths: dict[str, list[list[float]]], bands: list[Gutter], horizontal: bool) -> list[str]"},{"name":"drawn_score","signature":"def drawn_score(meta: dict[str, Any], flows: int) -> Score"},{"name":"journey_lines","signature":"def journey_lines(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> list[str]"},{"name":"lines","signature":"def lines(model: Model, meaning: Meaning, meta: dict[str, Any], placed: Iterable[str]=(), searched: tuple[int, int] | None=None) -> list[str]"},{"name":"run","signature":"def run(model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], observed_by: Iterable[str]=(), placed: Iterable[str]=(), searched: tuple[int, int] | None=None) -> list[str]"}],"id":"systemap.describe","imported_by":["systemap.cli"],"imports":["systemap.evidence","systemap.extract","systemap.journeys","systemap.model","systemap.place","systemap.route","systemap.schematic"],"loc":324,"names":[{"kind":"object","name":"Box"},{"kind":"function","name":"bends"},{"kind":"function","name":"length"},{"kind":"function","name":"gutter_lines"},{"kind":"function","name":"drawn_score"},{"kind":"function","name":"journey_lines"},{"kind":"function","name":"lines"},{"kind":"function","name":"run"}],"package":"systemap","plane":"core","sha":"d36c25131330","tests":["test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_full_gutter_names_its_seats_and_the_fix","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_label_with_no_seat_off_a_card_is_too_wide","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_describe_and_judgement_agree_that_a_crowd_is_walked","test_describe_command","test_describe_names_the_steps_the_code_does_not_back","test_describe_reads_the_picture_back","test_describe_says_where_each_walk_starts_and_how_many_ways_in_are_walked","test_gutters_are_named_from_the_card_grid","test_layout_reference_says_what_place_does_and_what_the_agent_decides","test_starter_corridors_route_every_pair_of_regions","test_starter_is_a_2x2_grid_with_corridors","test_starter_is_ruff_formatted_at_88_and_100_columns","test_the_agent_is_shown_the_crowd_and_a_sample_of_it"],"tests_primary":0,"tests_total":31,"uses":{"systemap.evidence":["DECLARED","STATES","of_model","owners"],"systemap.extract":["entry_label"],"systemap.journeys":["*"],"systemap.model":["Edge","Journey","Meaning","Model","all_layers","reading"],"systemap.place":["Score","grid_order"],"systemap.route":["Gutter","gutters","locate","seats"],"systemap.schematic":["LABEL_H","render"]}},
 "systemap.evidence":{"classes":[{"methods":["def says(self) -> str"],"name":"Evidence"}],"constants":[{"name":"OBSERVED","value":"'observed'"},{"name":"EXTERNAL","value":"'external'"},{"name":"DECLARED","value":"'declared'"},{"name":"STATES","value":"(OBSERVED, EXTERNAL, DECLARED)"}],"docstring":"What the facts say about each flow: observed, external or declared.","errors":[],"external":[],"file":"src/systemap/evidence.py","functions":[{"name":"mentioned","signature":"def mentioned(name: str, text: str) -> bool"},{"name":"owners","signature":"def owners(model: Model, facts: dict[str, Any]) -> dict[str, str]"},{"name":"joined_by_import","signature":"def joined_by_import(model: Model, facts: dict[str, Any]) -> set[frozenset[str]]"},{"name":"sharing_a_module","signature":"def sharing_a_module(model: Model, facts: dict[str, Any]) -> set[frozenset[str]]"},{"name":"mechanism_of","signature":"def mechanism_of(flow: Flow, meaning: Meaning, observed_by: Iterable[str]) -> str"},{"name":"of_model","signature":"def of_model(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> dict[Edge, Evidence]"},{"name":"declared","signature":"def declared(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> list[Flow]"}],"id":"systemap.evidence","imported_by":["systemap.audit","systemap.delta","systemap.describe","systemap.jev_cli","systemap.journeys","systemap.judgement","systemap.schematic","systemap.trend"],"imports":["systemap.model"],"loc":157,"names":[{"kind":"constant","name":"OBSERVED"},{"kind":"constant","name":"EXTERNAL"},{"kind":"constant","name":"DECLARED"},{"kind":"constant","name":"STATES"},{"kind":"class","name":"Evidence"},{"kind":"function","name":"mentioned"},{"kind":"function","name":"owners"},{"kind":"function","name":"joined_by_import"},{"kind":"function","name":"sharing_a_module"},{"kind":"function","name":"mechanism_of"},{"kind":"function","name":"of_model"},{"kind":"function","name":"declared"}],"package":"systemap","plane":"core","sha":"56df403ae964","tests":["test_a_declared_edge_is_dashed_and_the_panel_says_so","test_flows_observed_by_in_the_configuration","test_judgement_prints_one_line_per_declared_edge","test_the_three_states_and_observed_by_a_mechanism","test_two_cards_sharing_a_module_are_observed_by_it"],"tests_primary":5,"tests_total":5,"uses":{"systemap.model":["Edge","Flow","Meaning","Model","claimed","symbol_claims"]}},
 "systemap.explain":{"classes":[{"methods":["def rows(self, indent: str=INDENT) -> list[str]"],"name":"Lesson"}],"constants":[{"name":"INDENT","value":"'      '"},{"name":"JUDGEMENT","value":"{'single module': Lesson(means='A card claims one module, so the card and the fi"},{"name":"DELTA","value":"{'moved': Lesson(means='A module is at a new path, and systemap worked out which"},{"name":"AUDIT","value":"{'jev mis-fold': Lesson(means='Jev answers that this module does the job of a di"},{"name":"CHECK","value":"{'coverage': Lesson(means='Some module is claimed by no card, or by two.', why='"},{"name":"LESSONS","value":"{**JUDGEMENT, **DELTA, **AUDIT, **CHECK}"}],"docstring":"What each line means, why it matters, and what to do: the teaching under the report.","errors":[],"external":[],"file":"src/systemap/explain.py","functions":[{"name":"lesson","signature":"def lesson(kind: str) -> Lesson | None"},{"name":"rows","signature":"def rows(kind: str, indent: str=INDENT) -> list[str]"},{"name":"whole","signature":"def whole(kind: str) -> list[str]"}],"id":"systemap.explain","imported_by":["systemap.audit","systemap.check","systemap.cli","systemap.delta","systemap.judgement"],"imports":[],"loc":392,"names":[{"kind":"constant","name":"INDENT"},{"kind":"class","name":"Lesson"},{"kind":"constant","name":"JUDGEMENT"},{"kind":"constant","name":"DELTA"},{"kind":"constant","name":"AUDIT"},{"kind":"constant","name":"CHECK"},{"kind":"constant","name":"LESSONS"},{"kind":"function","name":"lesson"},{"kind":"function","name":"rows"},{"kind":"function","name":"whole"}],"package":"systemap","plane":"core","sha":"e20224518a61","tests":["test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_the_agent_is_asked_once_and_remembered","test_the_agent_table_is_read_and_checked","test_the_walk_follows_flows_forward_and_counts_the_hops","test_the_walk_stops_at_the_depth_it_is_given","test_what_walks_through_a_flow_and_what_governs_a_card","test_without_a_command_nothing_runs_and_the_reason_is_said"],"tests_primary":0,"tests_total":14,"uses":{}},
-"systemap.extract":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str]) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"PythonLanguage"}],"constants":[{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist'}"},{"name":"FORMAT","value":"2"},{"name":"TESTS_KEPT","value":"25"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"PYTHON","value":"PythonLanguage()"},{"name":"FIELDS","value":"(('facts', 'version', 'the facts format; 2, since a package `__init__` records t"},{"name":"SCOPE_TITLES","value":"{'facts': 'The file', 'module': 'Each module, under `components`', 'entry point'"},{"name":"WHOLE_MODULE","value":"'*'"}],"docstring":"Extract the derived tier of the system map from the working tree.","errors":[],"external":[],"file":"src/systemap/extract.py","functions":[{"name":"language_for","signature":"def language_for(cfg: Config) -> LanguageAdapter"},{"name":"fields_of","signature":"def fields_of(scope: str) -> set[str]"},{"name":"facts_doc","signature":"def facts_doc() -> str"},{"name":"module_of","signature":"def module_of(path: Path, pkg_dir: Path, pkg_name: str) -> str"},{"name":"plane_of","signature":"def plane_of(module: str, planes: tuple[str, ...]) -> str"},{"name":"signature","signature":"def signature(node: ast.FunctionDef | ast.AsyncFunctionDef) -> str"},{"name":"opening","signature":"def opening(text: str | None) -> str"},{"name":"first_line","signature":"def first_line(text: str | None) -> str"},{"name":"sentence","signature":"def sentence(test_name: str) -> str"},{"name":"parse_surface","signature":"def parse_surface(raw: str, *, module: str='', is_package: bool=False, prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"resolve_reexports","signature":"def resolve_reexports(components: dict[str, Any]) -> None"},{"name":"collect_module","signature":"def collect_module(path: Path, repo: Path, module: str='', prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"internal_uses","signature":"def internal_uses(raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]"},{"name":"external_imports","signature":"def external_imports(raw: str, prefixes: set[str]) -> list[str]"},{"name":"internal_imports","signature":"def internal_imports(path: Path, prefixes: set[str], known: set[str]) -> set[str]"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"},{"name":"collect_tests","signature":"def collect_tests(repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], known: set[str]) -> dict[str, list[dict[str, Any]]]"},{"name":"spec_sections","signature":"def spec_sections(repo: Path, spec_path: str) -> list[dict[str, str]]"},{"name":"subcommands","signature":"def subcommands(raw: str) -> list[str]"},{"name":"console_scripts","signature":"def console_scripts(repo: Path) -> dict[str, tuple[str, str]]"},{"name":"entry_points","signature":"def entry_points(repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]"},{"name":"entry_label","signature":"def entry_label(point: dict[str, str]) -> str"},{"name":"build","signature":"def build(cfg: Config) -> dict[str, Any]"},{"name":"drift","signature":"def drift(fresh: dict[str, Any], stored: dict[str, Any]) -> list[str]"},{"name":"mapping_drift","signature":"def mapping_drift(fresh: dict[str, Any], model: Model, prefixes: set[str]) -> list[str]"},{"name":"read_facts","signature":"def read_facts(path: Path) -> dict[str, Any]"},{"name":"dumps","signature":"def dumps(facts: dict[str, Any]) -> str"},{"name":"write_facts","signature":"def write_facts(path: Path, facts: dict[str, Any]) -> None"},{"name":"is_empty_marker","signature":"def is_empty_marker(record: Mapping[str, Any]) -> bool"},{"name":"empty_markers","signature":"def empty_markers(facts: Mapping[str, Any]) -> list[str]"},{"name":"summary","signature":"def summary(facts: dict[str, Any]) -> list[str]"}],"id":"systemap.extract","imported_by":["systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.describe","systemap.facts","systemap.jev_cli","systemap.journeys","systemap.judgement","systemap.suggest"],"imports":["systemap.config","systemap.language","systemap.model","systemap.typescript","systemap.ways_in"],"loc":1043,"names":[{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"FORMAT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"class","name":"PythonLanguage"},{"kind":"constant","name":"PYTHON"},{"kind":"function","name":"language_for"},{"kind":"constant","name":"FIELDS"},{"kind":"constant","name":"SCOPE_TITLES"},{"kind":"function","name":"fields_of"},{"kind":"function","name":"facts_doc"},{"kind":"function","name":"module_of"},{"kind":"function","name":"plane_of"},{"kind":"function","name":"signature"},{"kind":"function","name":"opening"},{"kind":"function","name":"first_line"},{"kind":"function","name":"sentence"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"resolve_reexports"},{"kind":"function","name":"collect_module"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"function","name":"internal_uses"},{"kind":"function","name":"external_imports"},{"kind":"function","name":"internal_imports"},{"kind":"function","name":"test_names"},{"kind":"function","name":"collect_tests"},{"kind":"function","name":"spec_sections"},{"kind":"function","name":"subcommands"},{"kind":"function","name":"console_scripts"},{"kind":"function","name":"entry_points"},{"kind":"function","name":"entry_label"},{"kind":"function","name":"build"},{"kind":"function","name":"drift"},{"kind":"function","name":"mapping_drift"},{"kind":"function","name":"read_facts"},{"kind":"function","name":"dumps"},{"kind":"function","name":"write_facts"},{"kind":"function","name":"is_empty_marker"},{"kind":"function","name":"empty_markers"},{"kind":"function","name":"summary"}],"package":"systemap","plane":"core","sha":"e9c4f6fcb10c","tests":["test_drift_reports_changes","test_drift_sees_an_entry_point_change","test_entry_may_be_any_public_name","test_extract_attributes_tests_to_modules","test_extract_finds_modules_and_public_surface","test_extract_records_entry_points","test_extract_records_every_public_name_with_its_kind_and_the_external_imports","test_facts_fields_are_the_documented_ones","test_facts_file_is_compact_and_one_record_per_line","test_language_defaults_to_python_and_may_be_stated","test_name_defaults_to_pyproject_then_the_repository_directory","test_no_roots_names_the_candidate_directories","test_spec_sections_and_planes","test_unknown_language_is_refused","test_workspace_roots_and_tests_directories_are_discovered","test_zero_tests_is_said_in_one_line_naming_the_directories","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_package_init_records_the_names_it_reexports","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused"],"tests_primary":16,"tests_total":118,"uses":{"systemap.config":["Config"],"systemap.language":["LanguageAdapter"],"systemap.model":["Model","is_symbol","module_matches","public_names"],"systemap.typescript":["TYPESCRIPT"],"systemap.ways_in":["*"]}},
+"systemap.extract":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str], paths: dict[str, Path]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False, repo: Path | None=None, paths: dict[str, Path] | None=None) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str], module: str='', repo: Path | None=None, paths: dict[str, Path] | None=None) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"PythonLanguage"}],"constants":[{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', '__pycache__', 'build', 'dist'}"},{"name":"FORMAT","value":"2"},{"name":"TESTS_KEPT","value":"25"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"PYTHON","value":"PythonLanguage()"},{"name":"FIELDS","value":"(('facts', 'version', 'the facts format; 2, since a package `__init__` records t"},{"name":"SCOPE_TITLES","value":"{'facts': 'The file', 'module': 'Each module, under `components`', 'entry point'"},{"name":"WHOLE_MODULE","value":"'*'"}],"docstring":"Extract the derived tier of the system map from the working tree.","errors":[],"external":[],"file":"src/systemap/extract.py","functions":[{"name":"language_for","signature":"def language_for(cfg: Config) -> LanguageAdapter"},{"name":"fields_of","signature":"def fields_of(scope: str) -> set[str]"},{"name":"facts_doc","signature":"def facts_doc() -> str"},{"name":"module_of","signature":"def module_of(path: Path, pkg_dir: Path, pkg_name: str) -> str"},{"name":"plane_of","signature":"def plane_of(module: str, planes: tuple[str, ...]) -> str"},{"name":"signature","signature":"def signature(node: ast.FunctionDef | ast.AsyncFunctionDef) -> str"},{"name":"opening","signature":"def opening(text: str | None) -> str"},{"name":"first_line","signature":"def first_line(text: str | None) -> str"},{"name":"sentence","signature":"def sentence(test_name: str) -> str"},{"name":"parse_surface","signature":"def parse_surface(raw: str, *, module: str='', is_package: bool=False, prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"resolve_reexports","signature":"def resolve_reexports(components: dict[str, Any]) -> None"},{"name":"collect_module","signature":"def collect_module(path: Path, repo: Path, module: str='', prefixes: frozenset[str]=frozenset()) -> dict[str, Any] | None"},{"name":"internal_uses","signature":"def internal_uses(raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]"},{"name":"external_imports","signature":"def external_imports(raw: str, prefixes: set[str]) -> list[str]"},{"name":"internal_imports","signature":"def internal_imports(path: Path, prefixes: set[str], known: set[str]) -> set[str]"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"},{"name":"collect_tests","signature":"def collect_tests(repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], known: set[str]) -> dict[str, list[dict[str, Any]]]"},{"name":"spec_sections","signature":"def spec_sections(repo: Path, spec_path: str) -> list[dict[str, str]]"},{"name":"subcommands","signature":"def subcommands(raw: str) -> list[str]"},{"name":"console_scripts","signature":"def console_scripts(repo: Path) -> dict[str, tuple[str, str]]"},{"name":"entry_points","signature":"def entry_points(repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]"},{"name":"entry_label","signature":"def entry_label(point: dict[str, str]) -> str"},{"name":"build","signature":"def build(cfg: Config) -> dict[str, Any]"},{"name":"drift","signature":"def drift(fresh: dict[str, Any], stored: dict[str, Any]) -> list[str]"},{"name":"mapping_drift","signature":"def mapping_drift(fresh: dict[str, Any], model: Model, prefixes: set[str]) -> list[str]"},{"name":"read_facts","signature":"def read_facts(path: Path) -> dict[str, Any]"},{"name":"dumps","signature":"def dumps(facts: dict[str, Any]) -> str"},{"name":"write_facts","signature":"def write_facts(path: Path, facts: dict[str, Any]) -> None"},{"name":"is_empty_marker","signature":"def is_empty_marker(record: Mapping[str, Any]) -> bool"},{"name":"empty_markers","signature":"def empty_markers(facts: Mapping[str, Any]) -> list[str]"},{"name":"summary","signature":"def summary(facts: dict[str, Any]) -> list[str]"}],"id":"systemap.extract","imported_by":["systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.delta","systemap.describe","systemap.facts","systemap.jev_cli","systemap.journeys","systemap.judgement","systemap.suggest"],"imports":["systemap.config","systemap.language","systemap.model","systemap.typescript","systemap.ways_in"],"loc":1075,"names":[{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"FORMAT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"class","name":"PythonLanguage"},{"kind":"constant","name":"PYTHON"},{"kind":"function","name":"language_for"},{"kind":"constant","name":"FIELDS"},{"kind":"constant","name":"SCOPE_TITLES"},{"kind":"function","name":"fields_of"},{"kind":"function","name":"facts_doc"},{"kind":"function","name":"module_of"},{"kind":"function","name":"plane_of"},{"kind":"function","name":"signature"},{"kind":"function","name":"opening"},{"kind":"function","name":"first_line"},{"kind":"function","name":"sentence"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"resolve_reexports"},{"kind":"function","name":"collect_module"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"function","name":"internal_uses"},{"kind":"function","name":"external_imports"},{"kind":"function","name":"internal_imports"},{"kind":"function","name":"test_names"},{"kind":"function","name":"collect_tests"},{"kind":"function","name":"spec_sections"},{"kind":"function","name":"subcommands"},{"kind":"function","name":"console_scripts"},{"kind":"function","name":"entry_points"},{"kind":"function","name":"entry_label"},{"kind":"function","name":"build"},{"kind":"function","name":"drift"},{"kind":"function","name":"mapping_drift"},{"kind":"function","name":"read_facts"},{"kind":"function","name":"dumps"},{"kind":"function","name":"write_facts"},{"kind":"function","name":"is_empty_marker"},{"kind":"function","name":"empty_markers"},{"kind":"function","name":"summary"}],"package":"systemap","plane":"core","sha":"235e3a8efcf0","tests":["test_drift_reports_changes","test_drift_sees_an_entry_point_change","test_entry_may_be_any_public_name","test_extract_attributes_tests_to_modules","test_extract_finds_modules_and_public_surface","test_extract_records_entry_points","test_extract_records_every_public_name_with_its_kind_and_the_external_imports","test_facts_fields_are_the_documented_ones","test_facts_file_is_compact_and_one_record_per_line","test_language_defaults_to_python_and_may_be_stated","test_name_defaults_to_pyproject_then_the_repository_directory","test_no_roots_names_the_candidate_directories","test_spec_sections_and_planes","test_unknown_language_is_refused","test_workspace_roots_and_tests_directories_are_discovered","test_zero_tests_is_said_in_one_line_naming_the_directories","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_flow_of_an_undeclared_kind_fails","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_package_init_records_the_names_it_reexports","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused"],"tests_primary":16,"tests_total":122,"uses":{"systemap.config":["Config","ConfigError"],"systemap.language":["LanguageAdapter"],"systemap.model":["Model","is_symbol","module_matches","public_names"],"systemap.typescript":["TYPESCRIPT"],"systemap.ways_in":["*"]}},
 "systemap.facts":{"classes":[],"constants":[{"name":"NO_DOCSTRING","value":"'no docstring'"},{"name":"EMPTY_MARKER","value":"'empty package marker'"},{"name":"VIEWS","value":"'views: --modules (one line per module: first sentence, counts), --docstrings (f"}],"docstring":"Readable views of the facts file: what `systemap facts` prints.","errors":[{"methods":[],"name":"UnknownModule"}],"external":[],"file":"src/systemap/facts.py","functions":[{"name":"first_sentence","signature":"def first_sentence(text: str) -> str"},{"name":"kinds","signature":"def kinds(record: dict[str, Any]) -> list[tuple[str, str]]"},{"name":"modules","signature":"def modules(facts: dict[str, Any]) -> list[str]"},{"name":"docstrings","signature":"def docstrings(facts: dict[str, Any]) -> list[str]"},{"name":"module","signature":"def module(facts: dict[str, Any], name: str) -> list[str]"},{"name":"names","signature":"def names(facts: dict[str, Any], name: str) -> list[str]"},{"name":"entry_points","signature":"def entry_points(facts: dict[str, Any]) -> list[str]"},{"name":"external","signature":"def external(facts: dict[str, Any]) -> list[str]"},{"name":"imports","signature":"def imports(facts: dict[str, Any], name: str) -> list[str]"},{"name":"overview","signature":"def overview(summary: list[str]) -> list[str]"}],"id":"systemap.facts","imported_by":["systemap.cli"],"imports":["systemap.extract","systemap.model"],"loc":218,"names":[{"kind":"error","name":"UnknownModule"},{"kind":"function","name":"first_sentence"},{"kind":"constant","name":"NO_DOCSTRING"},{"kind":"constant","name":"EMPTY_MARKER"},{"kind":"function","name":"kinds"},{"kind":"function","name":"modules"},{"kind":"function","name":"docstrings"},{"kind":"function","name":"module"},{"kind":"function","name":"names"},{"kind":"function","name":"entry_points"},{"kind":"function","name":"external"},{"kind":"function","name":"imports"},{"kind":"constant","name":"VIEWS"},{"kind":"function","name":"overview"}],"package":"systemap","plane":"core","sha":"6d58db577f55","tests":["test_a_package_init_records_the_names_it_reexports","test_entry_points_view_prints_the_target_beside_each","test_facts_command_views","test_facts_format_is_2_and_an_older_file_is_stale","test_names_and_first_sentence_read_old_and_new_records","test_reexport_resolution_and_relative_sources","test_the_skill_reads_the_facts_through_the_command"],"tests_primary":7,"tests_total":7,"uses":{"systemap.extract":["entry_label","is_empty_marker"],"systemap.model":["public_names"]}},
 "systemap.figure":{"classes":[],"constants":[{"name":"GENERATOR","value":"'systemap'"},{"name":"MARK_STYLE","value":"{'ring': 'box-shadow:inset 0 0 0 1.5px {bg},inset 0 0 0 2.5px {ink}', 'notch': '"}],"docstring":"Emit a figure of the system for embedding in a lesson or a document.","errors":[{"methods":[],"name":"FigureError"}],"external":[],"file":"src/systemap/figure.py","functions":[{"name":"bare_svg","signature":"def bare_svg(svg: str, t: dict[str, Any]) -> str"},{"name":"figure","signature":"def figure(t: dict[str, Any], model: Model, meaning: Meaning, svg: str, caption: str, legend: list[tuple[str, str, str]], svg_id: str, detail_json: str | None, layer: str='') -> str"},{"name":"make","signature":"def make(cfg: Config, model: Model, meaning: Meaning, t: dict[str, Any], facts: dict[str, Any], *, mode: str='', components: tuple[str, ...]=(), base: str='', head: str='HEAD', caption: str='', svg_id: str='lessonmap', interactive: bool=False, bare: bool=False, layer: str='', map_id: str='', opens: Mapping[str, Mapping[str, Any]] | None=None) -> tuple[str, list[str]]"},{"name":"configured","signature":"def configured(cfg: Config, tree: nest.Tree, m: nest.Map, facts: dict[str, Any], fig: Figure) -> tuple[str, list[str]]"}],"id":"systemap.figure","imported_by":["systemap.check","systemap.cli"],"imports":["systemap.change","systemap.config","systemap.model","systemap.nest","systemap.schematic"],"loc":370,"names":[{"kind":"constant","name":"GENERATOR"},{"kind":"error","name":"FigureError"},{"kind":"function","name":"bare_svg"},{"kind":"constant","name":"MARK_STYLE"},{"kind":"function","name":"figure"},{"kind":"function","name":"make"},{"kind":"function","name":"configured"}],"package":"systemap","plane":"core","sha":"19e2edc84f0f","tests":["test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_layer_figure_holds_only_that_layers_edges","test_a_pick_restamps_the_root_and_is_kept","test_a_standalone_figure_keeps_literal_colours","test_check_passes_on_sample","test_configured_layer_figures_are_refreshed_and_checked","test_contrast_is_the_wcag_formula","test_default_theme_colours_every_layer","test_every_scheme_clears_the_text_floor_on_every_surface","test_every_text_token_clears_four_and_a_half_to_one_on_its_ground","test_flows_observed_by_in_the_configuration","test_judgement_prints_one_line_per_declared_edge","test_overrides_apply_per_scheme_and_bare_keys_to_the_default","test_page_is_small_and_self_contained","test_reach_figure","test_schematic_reports_layout_and_detail","test_structure_has_no_edges_and_system_crosses_the_boundary","test_the_change_map_draws_through_variables_only","test_the_legend_and_caption_reduce_to_the_layer","test_the_page_carries_every_scheme_and_stamps_the_default","test_the_page_draws_through_variables_only","test_the_page_reads_the_same_table","test_the_palette_answers_one_table_two_ways","test_the_scheme_on_load","test_the_schemes_are_three_full_tables_and_the_default_is_warm"],"tests_primary":0,"tests_total":30,"uses":{"systemap.change":["*"],"systemap.config":["Config","ConfigError","Figure"],"systemap.model":["Layer","Meaning","Model","all_layers"],"systemap.nest":["*"],"systemap.schematic":["interactive_script","kind_rows","layer_rows","legend_rows","panel_css","render"]}},
 "systemap.graph":{"classes":[{"methods":[],"name":"Hop"},{"methods":["def cards(self) -> list[str]","def reached(self) -> list[str]","def edges(self) -> set[Edge]","def at(self, depth: int) -> list[str]"],"name":"Walk"}],"constants":[],"docstring":"The map as something to walk: what a card feeds, what walks through it, what governs it.","errors":[],"external":[],"file":"src/systemap/graph.py","functions":[{"name":"out_flows","signature":"def out_flows(model: Model) -> dict[str, list[Flow]]"},{"name":"in_flows","signature":"def in_flows(model: Model) -> dict[str, list[Flow]]"},{"name":"neighbours","signature":"def neighbours(model: Model, card: str) -> list[str]"},{"name":"steps_on","signature":"def steps_on(meaning: Meaning) -> dict[Edge, list[tuple[Journey, int]]]"},{"name":"rules_on","signature":"def rules_on(model: Model) -> dict[str, list[Invariant]]"},{"name":"walk","signature":"def walk(model: Model, start: Iterable[str], keep: Keep=_always, max_depth: int=3) -> Walk"},{"name":"journeys_through","signature":"def journeys_through(meaning: Meaning, edges: Iterable[Edge]) -> list[tuple[Journey, list[int]]]"},{"name":"rules_over","signature":"def rules_over(model: Model, cards: Iterable[str]) -> list[tuple[Invariant, list[str]]]"}],"id":"systemap.graph","imported_by":["systemap.delta","systemap.plan"],"imports":["systemap.model"],"loc":171,"names":[{"kind":"class","name":"Hop"},{"kind":"function","name":"out_flows"},{"kind":"function","name":"in_flows"},{"kind":"function","name":"neighbours"},{"kind":"function","name":"steps_on"},{"kind":"function","name":"rules_on"},{"kind":"object","name":"Keep"},{"kind":"class","name":"Walk"},{"kind":"function","name":"walk"},{"kind":"function","name":"journeys_through"},{"kind":"function","name":"rules_over"}],"package":"systemap","plane":"core","sha":"6ecf0ead4e44","tests":["test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered","test_a_flow_that_carries_nothing_new_stops_the_walk","test_a_json_answer_is_unwrapped","test_a_lesson_prints_as_two_rows_under_the_line","test_every_kind_of_line_is_taught","test_explain_lists_every_kind_and_prints_one_whole","test_explain_prints_one_entry_whole_and_names_the_kinds_it_knows","test_the_agent_is_asked_once_and_remembered","test_the_agent_table_is_read_and_checked","test_the_walk_follows_flows_forward_and_counts_the_hops","test_the_walk_stops_at_the_depth_it_is_given","test_what_walks_through_a_flow_and_what_governs_a_card","test_without_a_command_nothing_runs_and_the_reason_is_said"],"tests_primary":0,"tests_total":14,"uses":{"systemap.model":["Edge","Flow","Invariant","Journey","Meaning","Model"]}},
@@ -22,7 +22,7 @@
 "systemap.jev_cli":{"classes":[],"constants":[{"name":"REPORT_CAP","value":"2000"},{"name":"MOVE_AT","value":"0.8"},{"name":"SAME_AT","value":"0.4"},{"name":"TRIAGE_Q","value":"'`report` is an issue filed against this system. Which component will the fix mo"},{"name":"BECAME_Q","value":"'In one commit `old_module` disappeared and the modules in the options appeared."},{"name":"NOT_MOVED","value":"'not moved: deleted'"},{"name":"MOVE_OPTIONS","value":"250"},{"name":"SAME_Q","value":"'Do `module_a` and `module_b` belong to the same component of this system: one p"},{"name":"JUDGEMENT_HINT","value":"\"hint: with a TypeSafe key in TYPESAFE_API_KEY, systemap audit adds Jev's second"},{"name":"DELTA_HINT","value":"'hint: with a TypeSafe key in TYPESAFE_API_KEY, delta also asks Jev which new mo"},{"name":"UNCLAIMED","value":"(re.compile('^(?:\\\\S+: )?added: (\\\\S+), claimed by no card'), re.compile('^(?:\\\\"},{"name":"JOURNEY_CAP","value":"3"},{"name":"AROUND_CAP","value":"6"}],"docstring":"The commands that ask Jev: `audit`, `triage`, and the `--jev` of `delta` and `suggest`.","errors":[],"external":[],"file":"src/systemap/jev_cli.py","functions":[{"name":"uses_jev","signature":"def uses_jev(cfg: config.Config, flag: bool | None) -> bool"},{"name":"usage_to_stderr","signature":"def usage_to_stderr(client: jev.Jev) -> None"},{"name":"hint","signature":"def hint(cfg: config.Config, text: str) -> None"},{"name":"cmd_audit","signature":"def cmd_audit(args: argparse.Namespace, send: jev.Send | None=None) -> int"},{"name":"cmd_triage","signature":"def cmd_triage(args: argparse.Namespace, send: jev.Send | None=None) -> int"},{"name":"unclaimed_in","signature":"def unclaimed_in(lines: list[str]) -> list[str]"},{"name":"owner_suggestions","signature":"def owner_suggestions(cfg: config.Config, tree: nest.Tree, head: dict[str, Any], modules: list[str], client: jev.Jev) -> list[str]"},{"name":"cmd_journeys","signature":"def cmd_journeys(args: argparse.Namespace, run_command: agent.Run | None=None) -> int"},{"name":"writer_usage","signature":"def writer_usage(writer: agent.Agent) -> None"},{"name":"jev_moves","signature":"def jev_moves(base: dict[str, Any], head: dict[str, Any], client: jev.Jev) -> dict[str, tuple[str, str]]"},{"name":"pair_candidates","signature":"def pair_candidates(facts: dict[str, Any], mods: list[str]) -> list[tuple[str, str]]"},{"name":"groups","signature":"def groups(mods: list[str], edges: list[tuple[str, str]]) -> list[list[str]]"},{"name":"suggest_groups","signature":"def suggest_groups(cfg: config.Config, facts: dict[str, Any], client: jev.Jev) -> list[str]"},{"name":"run_or_explain","signature":"def run_or_explain(fn: Callable[[], list[str]], label: str) -> tuple[list[str], int]"},{"name":"cmd_plan","signature":"def cmd_plan(args: argparse.Namespace, send: jev.Send | None=None) -> int"},{"name":"add_parsers","signature":"def add_parsers(sub: Any, add_root: Callable[[argparse.ArgumentParser], None]) -> None"}],"id":"systemap.jev_cli","imported_by":["systemap.cli"],"imports":["systemap.agent","systemap.audit","systemap.cli","systemap.config","systemap.delta","systemap.evidence","systemap.extract","systemap.history","systemap.jev","systemap.journeys","systemap.moves","systemap.nest","systemap.plan"],"loc":679,"names":[{"kind":"constant","name":"REPORT_CAP"},{"kind":"constant","name":"MOVE_AT"},{"kind":"constant","name":"SAME_AT"},{"kind":"constant","name":"TRIAGE_Q"},{"kind":"constant","name":"BECAME_Q"},{"kind":"constant","name":"NOT_MOVED"},{"kind":"constant","name":"MOVE_OPTIONS"},{"kind":"constant","name":"SAME_Q"},{"kind":"constant","name":"JUDGEMENT_HINT"},{"kind":"constant","name":"DELTA_HINT"},{"kind":"function","name":"uses_jev"},{"kind":"function","name":"usage_to_stderr"},{"kind":"function","name":"hint"},{"kind":"function","name":"cmd_audit"},{"kind":"function","name":"cmd_triage"},{"kind":"constant","name":"UNCLAIMED"},{"kind":"function","name":"unclaimed_in"},{"kind":"function","name":"owner_suggestions"},{"kind":"constant","name":"JOURNEY_CAP"},{"kind":"function","name":"cmd_journeys"},{"kind":"function","name":"writer_usage"},{"kind":"function","name":"jev_moves"},{"kind":"function","name":"pair_candidates"},{"kind":"function","name":"groups"},{"kind":"function","name":"suggest_groups"},{"kind":"function","name":"run_or_explain"},{"kind":"function","name":"cmd_plan"},{"kind":"constant","name":"AROUND_CAP"},{"kind":"function","name":"add_parsers"}],"package":"systemap","plane":"core","sha":"46fa19b4c268","tests":["test_a_card_is_given_with_what_it_sits_in","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_does_not_pass_through_the_card_is_not_listed","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_plan_nobody_wrote_names_the_ones_that_exist","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_task_no_card_answers_to_says_so_rather_than_guessing","test_a_task_with_nothing_to_name_it_by_still_gets_an_id","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_about_a_kind_not_asked_is_not_stale","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_an_empty_task_asks_for_one_and_sends_nothing","test_apply_suppresses_answered_lines_and_reports_stale_answers","test_audit_answers_are_told_apart_from_judgement_answers","test_audit_cli_end_to_end_over_http","test_audit_dry_run_sends_no_question"],"tests_primary":0,"tests_total":66,"uses":{"systemap.agent":["*"],"systemap.audit":["*"],"systemap.cli":["_root"],"systemap.config":["*"],"systemap.delta":["*"],"systemap.evidence":["*"],"systemap.extract":["*"],"systemap.history":["*"],"systemap.jev":["*"],"systemap.journeys":["*"],"systemap.moves":["*"],"systemap.nest":["*"],"systemap.plan":["*"]}},
 "systemap.journeys":{"classes":[{"methods":["def one(self) -> dict[str, str]","def whole(self) -> bool","def label(self) -> str","def starts(self) -> str"],"name":"Group"},{"methods":[],"name":"Draft"}],"constants":[{"name":"QUESTION","value":"'You are reading a repository to write one journey for its system map.\\n\\nA jour"},{"name":"GROUP_QUESTION","value":"QUESTION.replace('Read the code from the way in named below.', 'Below is a group"},{"name":"SHOWN","value":"14"},{"name":"ANCHORS","value":"('JOURNEYS = (', 'journeys=(')"}],"docstring":"A journey written for a way in nothing walks from yet.","errors":[],"external":[],"file":"src/systemap/journeys.py","functions":[{"name":"uncovered","signature":"def uncovered(meaning: Meaning, facts: dict[str, Any], owner: dict[str, str] | None=None) -> list[dict[str, str]]"},{"name":"gather","signature":"def gather(model: Model, meaning: Meaning, facts: dict[str, Any]) -> list[Group]"},{"name":"context","signature":"def context(model: Model, meaning: Meaning, facts: dict[str, Any], group: Group) -> dict[str, Any]"},{"name":"read_answer","signature":"def read_answer(text: str, model: Model, group: Group) -> Draft"},{"name":"write_one","signature":"def write_one(agent: Agent, model: Model, meaning: Meaning, facts: dict[str, Any], group: Group) -> Draft"},{"name":"add_to_source","signature":"def add_to_source(source: str, journey: Journey) -> str | None"},{"name":"as_source","signature":"def as_source(journey: Journey) -> list[str]"}],"id":"systemap.journeys","imported_by":["systemap.describe","systemap.jev_cli"],"imports":["systemap.agent","systemap.evidence","systemap.extract","systemap.judgement","systemap.model"],"loc":282,"names":[{"kind":"constant","name":"QUESTION"},{"kind":"constant","name":"GROUP_QUESTION"},{"kind":"class","name":"Group"},{"kind":"class","name":"Draft"},{"kind":"function","name":"uncovered"},{"kind":"function","name":"gather"},{"kind":"function","name":"context"},{"kind":"constant","name":"SHOWN"},{"kind":"function","name":"read_answer"},{"kind":"function","name":"write_one"},{"kind":"constant","name":"ANCHORS"},{"kind":"function","name":"add_to_source"},{"kind":"function","name":"as_source"}],"package":"systemap","plane":"core","sha":"6bae94a09466","tests":["test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_describe_and_judgement_agree_that_a_crowd_is_walked","test_describe_names_the_steps_the_code_does_not_back","test_describe_says_where_each_walk_starts_and_how_many_ways_in_are_walked","test_the_agent_is_shown_the_crowd_and_a_sample_of_it","test_the_agent_is_told_the_cards_the_flows_and_where_to_read","test_the_route_with_no_walk_is_listed_and_nothing_is_written","test_the_walk_is_written_into_the_model_where_its_journeys_are_named","test_the_walk_that_comes_back_is_written_in_and_judgement_asks_about_it","test_with_no_agent_set_it_says_so_and_writes_nothing"],"tests_primary":21,"tests_total":21,"uses":{"systemap.agent":["Agent"],"systemap.evidence":["owners"],"systemap.extract":["entry_label"],"systemap.judgement":["*"],"systemap.model":["Journey","Meaning","Model","Step"]}},
 "systemap.judgement":{"classes":[{"methods":[],"name":"Answered"}],"constants":[{"name":"MIN_STEM","value":"4"},{"name":"MODEL_SDKS","value":"('anthropic', 'openai', 'google.generativeai', 'google.adk', 'litellm', 'langcha"},{"name":"TOGETHER_AT","value":"4"},{"name":"CROSSING_LINE","value":"re.compile('^crossing import: (\\\\S+) imports (\\\\S+) in \\\\d+ modules? and no flow"},{"name":"SDK_LINE","value":"re.compile('^model sdk: module \\\\S+ imports (\\\\S+) and its component ')"},{"name":"KIND_PREFIX","value":"{kind: f'{kind}: ' for kind in LINE_KINDS} | {'entry point': 'entry point '}"}],"docstring":"The list a maintainer must confirm before the map is trusted.","errors":[],"external":[],"file":"src/systemap/judgement.py","functions":[{"name":"words","signature":"def words(name: str) -> set[str]"},{"name":"shares_a_word","signature":"def shares_a_word(a: str, b: str) -> bool"},{"name":"share_a_word","signature":"def share_a_word(xs: set[str], ys: set[str]) -> bool"},{"name":"single_module","signature":"def single_module(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"package_of","signature":"def package_of(module: str) -> str"},{"name":"share_a_package","signature":"def share_a_package(a: str, b: str) -> bool"},{"name":"mis_folds","signature":"def mis_folds(model: Model, meaning: Meaning, facts: dict[str, Any]) -> list[str]"},{"name":"no_sentence","signature":"def no_sentence(model: Model, meaning: Meaning) -> list[str]"},{"name":"thin_layers","signature":"def thin_layers(model: Model, meaning: Meaning) -> list[str]"},{"name":"entry_points_without_journey","signature":"def entry_points_without_journey(model: Model, meaning: Meaning, facts: dict[str, Any], *, text: str | None=None, skip: Collection[str]=()) -> list[str]"},{"name":"ways_in_without_journey","signature":"def ways_in_without_journey(meaning: Meaning, facts: dict[str, Any], text: str | None=None, skip: Collection[str]=(), owner: dict[str, str] | None=None) -> list[dict[str, str]]"},{"name":"crowd_label","signature":"def crowd_label(how_many: int, kind: str, card: str) -> str"},{"name":"journey_problems","signature":"def journey_problems(meaning: Meaning, facts: dict[str, Any], cards: Collection[str]=()) -> list[str]"},{"name":"crossing_pairs","signature":"def crossing_pairs(components: dict[str, Any], owner: dict[str, str]) -> dict[Pair, list[tuple[str, str]]]"},{"name":"crossing_line","signature":"def crossing_line(p: str, q: str, imports: list[tuple[str, str]]) -> str"},{"name":"crossing_imports","signature":"def crossing_imports(model: Model, facts: dict[str, Any]) -> dict[Pair, list[tuple[str, str]]]"},{"name":"crossing_imports_without_flow","signature":"def crossing_imports_without_flow(model: Model, facts: dict[str, Any]) -> list[str]"},{"name":"crossing_detail","signature":"def crossing_detail(model: Model, facts: dict[str, Any], prefix: str='') -> dict[str, list[str]]"},{"name":"crossing_detail_tree","signature":"def crossing_detail_tree(tree: nest.Tree, facts: dict[str, Any]) -> dict[str, list[str]]"},{"name":"declared_flows","signature":"def declared_flows(model: Model, meaning: Meaning, facts: dict[str, Any], observed_by: Iterable[str]=()) -> list[str]"},{"name":"sdk_of","signature":"def sdk_of(name: str, sdks: Iterable[str]) -> str"},{"name":"model_sdk_imports","signature":"def model_sdk_imports(model: Model, facts: dict[str, Any], sdks: Iterable[str]=MODEL_SDKS, *, skip: Collection[str]=()) -> list[str]"},{"name":"sdk_list","signature":"def sdk_list(configured: Iterable[str]) -> tuple[str, ...]"},{"name":"run","signature":"def run(model: Model, meaning: Meaning, facts: dict[str, Any], sdks: Iterable[str]=MODEL_SDKS, observed_by: Iterable[str]=(), *, journeys_text: str | None=None, skip: Collection[str]=()) -> list[str]"},{"name":"run_tree","signature":"def run_tree(tree: nest.Tree, facts: dict[str, Any], sdks: Iterable[str]=MODEL_SDKS, observed_by: Iterable[str]=()) -> list[str]"},{"name":"unprefixed","signature":"def unprefixed(line: str) -> str"},{"name":"answers","signature":"def answers(answer: Answer, line: str) -> bool"},{"name":"apply_answers","signature":"def apply_answers(lines: list[str], answer_list: Iterable[Answer]) -> Answered"},{"name":"of_kind","signature":"def of_kind(lines: list[str], kind: str) -> list[str]"},{"name":"kind_of","signature":"def kind_of(line: str) -> str"},{"name":"report","signature":"def report(lines: list[str] | Answered, detail: dict[str, list[str]] | None=None, kind: str='', teach: bool=True) -> list[str]"}],"id":"systemap.judgement","imported_by":["systemap.cli","systemap.delta","systemap.journeys"],"imports":["systemap.config","systemap.evidence","systemap.explain","systemap.extract","systemap.model","systemap.nest"],"loc":748,"names":[{"kind":"constant","name":"MIN_STEM"},{"kind":"constant","name":"MODEL_SDKS"},{"kind":"function","name":"words"},{"kind":"function","name":"shares_a_word"},{"kind":"function","name":"share_a_word"},{"kind":"function","name":"single_module"},{"kind":"function","name":"package_of"},{"kind":"function","name":"share_a_package"},{"kind":"function","name":"mis_folds"},{"kind":"function","name":"no_sentence"},{"kind":"function","name":"thin_layers"},{"kind":"constant","name":"TOGETHER_AT"},{"kind":"function","name":"entry_points_without_journey"},{"kind":"function","name":"ways_in_without_journey"},{"kind":"function","name":"crowd_label"},{"kind":"function","name":"journey_problems"},{"kind":"object","name":"Pair"},{"kind":"function","name":"crossing_pairs"},{"kind":"function","name":"crossing_line"},{"kind":"function","name":"crossing_imports"},{"kind":"function","name":"crossing_imports_without_flow"},{"kind":"function","name":"crossing_detail"},{"kind":"function","name":"crossing_detail_tree"},{"kind":"function","name":"declared_flows"},{"kind":"function","name":"sdk_of"},{"kind":"function","name":"model_sdk_imports"},{"kind":"function","name":"sdk_list"},{"kind":"function","name":"run"},{"kind":"function","name":"run_tree"},{"kind":"constant","name":"CROSSING_LINE"},{"kind":"constant","name":"SDK_LINE"},{"kind":"constant","name":"KIND_PREFIX"},{"kind":"function","name":"unprefixed"},{"kind":"function","name":"answers"},{"kind":"class","name":"Answered"},{"kind":"function","name":"apply_answers"},{"kind":"function","name":"of_kind"},{"kind":"function","name":"kind_of"},{"kind":"function","name":"report"}],"package":"systemap","plane":"core","sha":"f3d7fdd0f67a","tests":["test_an_ignored_module_is_not_a_question","test_answers_in_the_configuration","test_answers_suppress_count_and_go_stale","test_bulk_answers_cover_a_family_and_go_stale_as_written","test_bulk_answers_in_the_configuration","test_crossing_answers_cover_into_from_and_every_pair","test_crossing_imports_are_one_line_per_pair_with_the_module_count","test_crossing_imports_without_flow","test_crossing_into_and_from_in_the_configuration","test_entry_points_without_journey","test_judgement_command_always_exits_0","test_mentioned_is_a_whole_word","test_mis_fold_count_on_the_workspace_fixture","test_mis_fold_fires_only_on_a_stranger_in_a_foreign_package","test_mis_fold_lines","test_model_sdk_lines","test_model_sdks_configured","test_model_sdks_removal","test_no_sentence_lines","test_report_wording","test_run_orders_the_second_pass_last","test_single_module_lines","test_single_module_reads_implemented_by_without_facts","test_strict_exits_1_while_a_line_is_open","test_thin_layer_lines"],"tests_primary":26,"tests_total":71,"uses":{"systemap.config":["Answer","ConfigError","LINE_KINDS"],"systemap.evidence":["*"],"systemap.explain":["*"],"systemap.extract":["entry_label"],"systemap.model":["Component","Meaning","Model","claimed","flow_layers","is_symbol"],"systemap.nest":["*"]}},
-"systemap.language":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str]) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"LanguageAdapter"}],"constants":[],"docstring":"The source-language boundary shared by extraction and change analysis.","errors":[],"external":[],"file":"src/systemap/language.py","functions":[],"id":"systemap.language","imported_by":["systemap.change","systemap.extract"],"imports":[],"loc":68,"names":[{"kind":"class","name":"LanguageAdapter"}],"package":"systemap","plane":"core","sha":"75c332e4c8fb","tests":[],"tests_primary":0,"tests_total":0,"uses":{}},
+"systemap.language":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str], paths: dict[str, Path]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False, repo: Path | None=None, paths: dict[str, Path] | None=None) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str], module: str='', repo: Path | None=None, paths: dict[str, Path] | None=None) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"LanguageAdapter"}],"constants":[],"docstring":"The source-language boundary shared by extraction and change analysis.","errors":[],"external":[],"file":"src/systemap/language.py","functions":[],"id":"systemap.language","imported_by":["systemap.change","systemap.extract"],"imports":[],"loc":78,"names":[{"kind":"class","name":"LanguageAdapter"}],"package":"systemap","plane":"core","sha":"1189dc67f58f","tests":[],"tests_primary":0,"tests_total":0,"uses":{}},
 "systemap.model":{"classes":[{"methods":[],"name":"Container"},{"methods":[],"name":"Region"},{"methods":["def opens(self) -> bool","def positioned(self) -> bool","def model_end(self) -> bool","def home(self) -> str","def box(self) -> Box"],"name":"Component"},{"methods":["def edge(self) -> Edge"],"name":"Flow"},{"methods":[],"name":"Invariant"},{"methods":[],"name":"Step"},{"methods":[],"name":"Journey"},{"methods":[],"name":"Layer"},{"methods":["def ids(self) -> set[str]","def opening(self) -> tuple[Component, ...]","def agentic(self) -> bool","def kind_of(self, cid: str) -> str","def component(self, cid: str) -> Component","def rules_of(self, cid: str) -> list[int]","def layout_problems(self) -> list[str]"],"name":"Model"},{"methods":["def layer_for(self, edge: Edge, kind: str) -> str","def verb_for(self, edge: Edge, layer: str, from_clicked: bool) -> str"],"name":"Meaning"}],"constants":[{"name":"KINDS","value":"('component', 'store', 'actor', 'agent', 'tool', 'context')"},{"name":"AGENT_KINDS","value":"('agent', 'tool', 'context')"},{"name":"TONES","value":"('host', 'client', 'server', 'isolated')"},{"name":"CARD_W","value":"150"},{"name":"CARD_H","value":"{'component': 56, 'store': 52, 'actor': 44, 'agent': 56, 'tool': 56, 'context': "},{"name":"STANDARD_LAYERS","value":"(Layer('structure', 'Structure', question='What are the parts, and where does ea"},{"name":"AGENT_LAYERS","value":"(Layer('agents', 'Agents', question='Which parts run a model, and what do they r"},{"name":"STANDARD_KINDS","value":"('data', 'control', 'context', 'tool')"},{"name":"LAYER_OF_STANDARD_KIND","value":"{'data': 'data', 'control': 'control', 'context': 'context', 'tool': 'tools'}"},{"name":"DERIVED_LAYERS","value":"('structure', 'system', 'agents')"},{"name":"RESERVED_LAYER_IDS","value":"frozenset([layer.id for layer in STANDARD_LAYERS + AGENT_LAYERS] + list(LAYER_OF"},{"name":"STANDARD_VERBS","value":"{'data': ('hands to', 'receives from'), 'control': ('drives', 'is driven by'), '"},{"name":"SUBJECT_KIND","value":"{'system': 'actor', 'agents': 'agent', 'context': 'context', 'tools': 'tool'}"},{"name":"BUILT","value":"'built'"}],"docstring":"The schema a system map is written in, and the checks that keep it honest.","errors":[],"external":[],"file":"src/systemap/model.py","functions":[{"name":"all_layers","signature":"def all_layers(model: Model, meaning: Meaning) -> tuple[Layer, ...]"},{"name":"flow_layers","signature":"def flow_layers(model: Model, meaning: Meaning) -> tuple[Layer, ...]"},{"name":"edge_in_layer","signature":"def edge_in_layer(model: Model, layer_id: str, edge_layer: str, src: str, dst: str) -> bool"},{"name":"subject_of_layer","signature":"def subject_of_layer(model: Model, layer_id: str, cid: str) -> bool"},{"name":"reading","signature":"def reading(model: Model, meaning: Meaning, layer_id: str) -> tuple[list[int], list[str]]"},{"name":"meaning_problems","signature":"def meaning_problems(model: Model, meaning: Meaning) -> list[str]"},{"name":"problems","signature":"def problems(model: Model, meaning: Meaning) -> list[str]"},{"name":"is_symbol","signature":"def is_symbol(pattern: str) -> bool"},{"name":"symbol_claims","signature":"def symbol_claims(component: Component) -> list[tuple[str, str]]"},{"name":"module_matches","signature":"def module_matches(pattern: str, module: str) -> bool"},{"name":"claimed","signature":"def claimed(component: Component, modules: Iterable[str]) -> list[str]"},{"name":"public_names","signature":"def public_names(record: Mapping[str, Any]) -> set[str]"},{"name":"defines_entry","signature":"def defines_entry(component: Component, facts: Mapping[str, Any]) -> bool"},{"name":"entry_module","signature":"def entry_module(component: Component, facts: Mapping[str, Any]) -> str"},{"name":"build_state","signature":"def build_state(component: Component, facts: Mapping[str, Any]) -> str"}],"id":"systemap.model","imported_by":["systemap","systemap.audit","systemap.change","systemap.check","systemap.cli","systemap.config","systemap.delta","systemap.describe","systemap.evidence","systemap.extract","systemap.facts","systemap.figure","systemap.graph","systemap.journeys","systemap.judgement","systemap.moves","systemap.nest","systemap.page","systemap.place","systemap.plan","systemap.schematic","systemap.suggest","systemap.theme","systemap.trend"],"imports":[],"loc":744,"names":[{"kind":"object","name":"Box"},{"kind":"object","name":"Edge"},{"kind":"constant","name":"KINDS"},{"kind":"constant","name":"AGENT_KINDS"},{"kind":"constant","name":"TONES"},{"kind":"constant","name":"CARD_W"},{"kind":"constant","name":"CARD_H"},{"kind":"class","name":"Container"},{"kind":"class","name":"Region"},{"kind":"class","name":"Component"},{"kind":"class","name":"Flow"},{"kind":"class","name":"Invariant"},{"kind":"class","name":"Step"},{"kind":"class","name":"Journey"},{"kind":"class","name":"Layer"},{"kind":"constant","name":"STANDARD_LAYERS"},{"kind":"constant","name":"AGENT_LAYERS"},{"kind":"constant","name":"STANDARD_KINDS"},{"kind":"constant","name":"LAYER_OF_STANDARD_KIND"},{"kind":"constant","name":"DERIVED_LAYERS"},{"kind":"constant","name":"RESERVED_LAYER_IDS"},{"kind":"constant","name":"STANDARD_VERBS"},{"kind":"class","name":"Model"},{"kind":"class","name":"Meaning"},{"kind":"function","name":"all_layers"},{"kind":"function","name":"flow_layers"},{"kind":"function","name":"edge_in_layer"},{"kind":"constant","name":"SUBJECT_KIND"},{"kind":"function","name":"subject_of_layer"},{"kind":"function","name":"reading"},{"kind":"function","name":"meaning_problems"},{"kind":"function","name":"problems"},{"kind":"function","name":"is_symbol"},{"kind":"function","name":"symbol_claims"},{"kind":"function","name":"module_matches"},{"kind":"function","name":"claimed"},{"kind":"constant","name":"BUILT"},{"kind":"function","name":"public_names"},{"kind":"function","name":"defines_entry"},{"kind":"function","name":"entry_module"},{"kind":"function","name":"build_state"}],"package":"systemap","plane":"core","sha":"dc78c161fe4a","tests":["test_a_custom_layer_may_not_take_a_standard_id","test_a_model_may_import_a_module_beside_it","test_build_state_has_one_value","test_defines_entry_looks_the_name_up_in_the_claimed_modules","test_layers_are_standard_then_the_models_own","test_layout_problems_find_lies","test_meaning_problems_find_gaps","test_module_matches_exact_and_subtree","test_one_flow_per_ordered_pair","test_sample_every_flow_has_a_relation_and_a_layer","test_sample_flow_endpoints_resolve","test_sample_journeys_resolve","test_sample_positions_and_plain_words","test_sample_validates","test_small_model_is_clean","test_two_invariants_with_one_number_are_refused_with_both_quoted","test_a_card_is_given_with_what_it_sits_in","test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_changed_outside_the_plan_is_the_finding","test_a_card_that_takes_a_crowd_of_routes_is_asked_once","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_decorator_that_is_not_a_way_in_is_not_one","test_a_failing_check_group_is_taught_and_a_passing_one_is_not","test_a_failing_command_is_reported_never_answered"],"tests_primary":16,"tests_total":229,"uses":{}},
 "systemap.moves":{"classes":[{"methods":[],"name":"Pair"}],"constants":[{"name":"SURFACE_OVERLAP","value":"0.8"},{"name":"NAME_ALIKE","value":"0.6"},{"name":"QUESTIONS","value":"((_same_content, 'same content'), (_same_names, 'same public names'), (_renamed_"},{"name":"NO_MOVES","value":"MappingProxyType({})"}],"docstring":"Which new module a module that disappeared became, between two commits.","errors":[],"external":[],"file":"src/systemap/moves.py","functions":[{"name":"find","signature":"def find(base: dict[str, Any], head: dict[str, Any], gone: list[str], new: list[str]) -> dict[str, tuple[str, str]]"},{"name":"with_told","signature":"def with_told(found: dict[str, tuple[str, str]], told: Mapping[str, tuple[str, str]], gone: list[str], new: list[str]) -> dict[str, tuple[str, str]]"}],"id":"systemap.moves","imported_by":["systemap.delta","systemap.jev_cli"],"imports":["systemap.model"],"loc":182,"names":[{"kind":"constant","name":"SURFACE_OVERLAP"},{"kind":"constant","name":"NAME_ALIKE"},{"kind":"class","name":"Pair"},{"kind":"constant","name":"QUESTIONS"},{"kind":"function","name":"find"},{"kind":"constant","name":"NO_MOVES"},{"kind":"function","name":"with_told"}],"package":"systemap","plane":"core","sha":"0ceaa9f4180d","tests":["test_a_card_joined_to_a_third_of_the_map_names_none","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_delta_alone_pairs_neither","test_every_line_kind_with_its_fix","test_jev_names_the_rewritten_module_and_leaves_the_deleted_one","test_markdown_is_the_comment_with_the_committed_figure","test_nothing_to_do_and_no_change_exit_zero","test_the_base_is_the_merge_base_and_the_working_copy_is_not_read","test_the_best_pairing_wins_over_the_first_free_one","test_the_cards_next_to_the_change_are_printed_as_context","test_the_context_is_in_the_pull_request_comment_once","test_the_seed_is_the_card_with_the_most_changed_modules","test_told_moves_fill_only_what_delta_left_and_take_each_new_module_once","test_two_empty_modules_with_different_names_are_not_joined","test_unknown_ref_is_refused","test_with_claims_renames_modules_and_symbols_and_keeps_patterns"],"tests_primary":0,"tests_total":16,"uses":{"systemap.model":["public_names"]}},
 "systemap.nest":{"classes":[{"methods":["def top(self) -> bool","def prefix(self) -> str","def inside(self) -> int","def page_path(self, cfg: Config) -> Path"],"name":"Map"},{"methods":["def top(self) -> Map","def nested(self) -> bool","def ids(self) -> list[str]","def get(self, map_id: str) -> Map","def has(self, map_id: str) -> bool","def children(self, m: Map) -> list[Map]","def parent_of(self, m: Map) -> Map | None","def opening_card(self, m: Map) -> Component | None"],"name":"Tree"}],"constants":[{"name":"CARDS_PER_MAP","value":"40"},{"name":"MODULES_PER_CARD","value":"10"}],"docstring":"Nested maps: a card that opens a map of its own, and the tree they form.","errors":[],"external":[],"file":"src/systemap/nest.py","functions":[{"name":"load","signature":"def load(cfg: Config) -> Tree"},{"name":"opens","signature":"def opens(tree: Tree, m: Map, links: bool=True) -> dict[str, dict[str, Any]]"},{"name":"unknown_map","signature":"def unknown_map(tree: Tree, map_id: str) -> ConfigError"}],"id":"systemap.nest","imported_by":["systemap.audit","systemap.check","systemap.cli","systemap.delta","systemap.figure","systemap.jev_cli","systemap.judgement","systemap.page","systemap.suggest"],"imports":["systemap.config","systemap.model","systemap.theme"],"loc":199,"names":[{"kind":"constant","name":"CARDS_PER_MAP"},{"kind":"constant","name":"MODULES_PER_CARD"},{"kind":"class","name":"Map"},{"kind":"class","name":"Tree"},{"kind":"function","name":"load"},{"kind":"function","name":"opens"},{"kind":"function","name":"unknown_map"}],"package":"systemap","plane":"core","sha":"043050eba0d7","tests":["test_a_card_joined_to_a_third_of_the_map_names_none","test_a_card_that_grew_is_counted_in_todays_cards","test_a_card_with_a_crowd_of_ways_in_is_one_walk_to_write","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_few_ways_in_are_still_asked_about_one_at_a_time","test_a_journey_starting_at_a_card_is_not_reported_as_starting_at_nothing","test_a_journey_that_names_its_way_in_in_a_sentence_still_covers_it","test_a_model_the_api_does_not_offer_is_refused_before_anything_is_asked","test_a_module_renamed_and_edited_at_once_is_still_one_move","test_a_quiet_stretch_says_so_rather_than_printing_a_chart","test_a_step_naming_a_card_that_is_not_on_the_map_is_refused","test_a_step_tracing_a_flow_the_map_does_not_draw_is_refused","test_a_sub_maps_actors_are_cards_of_the_parent","test_a_walk_the_map_can_hold_becomes_a_journey_marked_as_a_draft","test_a_walk_the_map_cannot_hold_is_reported_and_the_model_is_left_alone","test_a_walk_written_for_the_card_covers_every_way_in_it_takes","test_a_way_in_a_journey_already_starts_from_is_not_asked_about","test_a_way_in_the_extractor_finds_is_the_one_the_agent_is_asked_about","test_an_answer_about_a_kind_not_asked_is_not_stale","test_an_answer_that_is_not_json_is_said_so_never_guessed_at","test_apply_suppresses_answered_lines_and_reports_stale_answers","test_audit_answers_are_told_apart_from_judgement_answers","test_audit_cli_end_to_end_over_http","test_audit_dry_run_sends_no_question","test_audit_on_recorded_answers"],"tests_primary":0,"tests_total":84,"uses":{"systemap.config":["Config","ConfigError","load_model"],"systemap.model":["Component","Meaning","Model","all_layers"],"systemap.theme":["*"]}},
@@ -36,7 +36,7 @@
 "systemap.suggest":{"classes":[{"methods":[],"name":"Proposal"}],"constants":[{"name":"SPLIT_ABOVE","value":"10"},{"name":"HEADER","value":"('suggest: a first grouping to revise, not the answer', '  one proposal per pack"}],"docstring":"A first grouping to argue with: what `systemap suggest` prints.","errors":[],"external":[],"file":"src/systemap/suggest.py","functions":[{"name":"package_of","signature":"def package_of(module: str, record: dict[str, Any]) -> str"},{"name":"camel","signature":"def camel(dotted: str, whole: bool=False) -> str"},{"name":"proposals","signature":"def proposals(facts: dict[str, Any]) -> tuple[list[Proposal], list[str]]"},{"name":"crossings","signature":"def crossings(facts: dict[str, Any], groups: list[Proposal]) -> list[tuple[str, str, list[str]]]"},{"name":"lines","signature":"def lines(facts: dict[str, Any]) -> list[str]"},{"name":"nesting_lines","signature":"def nesting_lines(tree: nest.Tree, facts: dict[str, Any]) -> list[str]"}],"id":"systemap.suggest","imported_by":["systemap.cli"],"imports":["systemap.extract","systemap.model","systemap.nest"],"loc":184,"names":[{"kind":"constant","name":"SPLIT_ABOVE"},{"kind":"constant","name":"HEADER"},{"kind":"class","name":"Proposal"},{"kind":"function","name":"package_of"},{"kind":"function","name":"camel"},{"kind":"function","name":"proposals"},{"kind":"function","name":"crossings"},{"kind":"function","name":"lines"},{"kind":"function","name":"nesting_lines"}],"package":"systemap","plane":"core","sha":"2ffde20a7faa","tests":["test_camel_ids","test_proposals_on_the_workspace_fixture","test_suggest_command_lists_crossings_between_proposals","test_the_skill_states_the_target_and_runs_suggest_and_the_check_together","test_two_packages_that_shorten_to_one_id_keep_their_path","test_a_sub_maps_actors_are_cards_of_the_parent","test_delta_names_the_card_and_the_map_a_moved_module_belongs_to","test_figure_draws_one_map_by_id","test_judgement_and_describe_lines_carry_the_maps_id","test_pages_are_written_per_map_with_the_links_up_and_down","test_place_writes_into_a_sub_maps_file","test_suggest_reads_the_tree_from_the_command","test_suggest_says_when_a_map_is_past_forty_cards_and_which_cards_to_open","test_the_check_runs_on_every_map_and_counts_coverage_once","test_the_exact_claim_rule_refuses_an_extra_and_a_missing_module","test_the_map_inside_a_card_opens_in_place","test_the_page_names_the_commit_the_facts_are_from"],"tests_primary":5,"tests_total":17,"uses":{"systemap.extract":["empty_markers","is_empty_marker"],"systemap.model":["claimed"],"systemap.nest":["*"]}},
 "systemap.theme":{"classes":[{"methods":["def layer(self, lid: str) -> str","def tag(self, lid: str) -> str","def state(self, name: str) -> tuple[str, str, str]","def actor(self) -> tuple[str, str]","def ghost(self) -> tuple[str, str]","def container(self, tone: str) -> tuple[str, str]","def delta(self, key: str) -> str","def changed_fill(self) -> str","def reach_fill(self) -> str"],"name":"Palette"}],"constants":[{"name":"MARKS","value":"('ring', 'notch', 'dotted')"},{"name":"KIND_MARKS","value":"{'agent': 'ring', 'tool': 'notch', 'context': 'dotted'}"},{"name":"SANS","value":"'ui-sans-serif,system-ui,-apple-system,\"SF Pro Text\",\"Segoe UI\",Roboto,\"Helvetic"},{"name":"MONO","value":"'ui-monospace,\"SF Mono\",SFMono-Regular,\"JetBrains Mono\",Menlo,Consolas,monospace"},{"name":"WARM_GROUND","value":"'#161310'"},{"name":"WARM_INK","value":"'#ece5d8'"},{"name":"WARM_AMBER","value":"'#e5a84f'"},{"name":"GRAPHITE_GROUND","value":"'#121417'"},{"name":"GRAPHITE_INK","value":"'#e6e4df'"},{"name":"GRAPHITE_AMBER","value":"'#e0a458'"},{"name":"PAPER_GROUND","value":"'#f4f2ee'"},{"name":"PAPER_INK","value":"'#1d2024'"},{"name":"PAPER_AMBER","value":"'#905c1a'"},{"name":"STANDARD_LAYERS_WARM","value":"{'structure': '#d9cdb2', 'system': '#82a7ba', 'data': '#e39a86', 'control': '#dd"}],"docstring":"The map's look, as one table of tokens per scheme.","errors":[],"external":[],"file":"src/systemap/theme.py","functions":[{"name":"merge","signature":"def merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]"},{"name":"scheme_name","signature":"def scheme_name(tokens: dict[str, Any]) -> str"},{"name":"resolve","signature":"def resolve(tokens: dict[str, Any], layers: Iterable[Layer]) -> dict[str, Any]"},{"name":"mix","signature":"def mix(a: str, b: str, t: float) -> str"},{"name":"tints","signature":"def tints(t: dict[str, Any]) -> dict[str, Any]"},{"name":"root_css","signature":"def root_css(t: dict[str, Any]) -> str"},{"name":"css_vars","signature":"def css_vars(t: dict[str, Any]) -> str"}],"id":"systemap.theme","imported_by":["systemap.nest","systemap.page","systemap.schematic"],"imports":["systemap.model"],"loc":521,"names":[{"kind":"constant","name":"MARKS"},{"kind":"constant","name":"KIND_MARKS"},{"kind":"constant","name":"SANS"},{"kind":"constant","name":"MONO"},{"kind":"constant","name":"WARM_GROUND"},{"kind":"constant","name":"WARM_INK"},{"kind":"constant","name":"WARM_AMBER"},{"kind":"constant","name":"GRAPHITE_GROUND"},{"kind":"constant","name":"GRAPHITE_INK"},{"kind":"constant","name":"GRAPHITE_AMBER"},{"kind":"constant","name":"PAPER_GROUND"},{"kind":"constant","name":"PAPER_INK"},{"kind":"constant","name":"PAPER_AMBER"},{"kind":"constant","name":"STANDARD_LAYERS_WARM"},{"kind":"constant","name":"LAYER_PALETTE_WARM"},{"kind":"constant","name":"STANDARD_LAYERS_GRAPHITE"},{"kind":"constant","name":"LAYER_PALETTE_GRAPHITE"},{"kind":"constant","name":"STANDARD_LAYERS_PAPER"},{"kind":"constant","name":"LAYER_PALETTE_PAPER"},{"kind":"constant","name":"WARM"},{"kind":"constant","name":"GRAPHITE"},{"kind":"constant","name":"PAPER"},{"kind":"constant","name":"SCHEMES"},{"kind":"constant","name":"ALIASES"},{"kind":"constant","name":"DEFAULT_SCHEME"},{"kind":"constant","name":"LIGHT_SCHEME"},{"kind":"constant","name":"TEXT_TOKENS"},{"kind":"function","name":"merge"},{"kind":"function","name":"scheme_name"},{"kind":"function","name":"resolve"},{"kind":"function","name":"mix"},{"kind":"constant","name":"CSS_NAMES"},{"kind":"constant","name":"ACTOR_MIX"},{"kind":"constant","name":"CHANGED_MIX"},{"kind":"constant","name":"REACH_MIX"},{"kind":"constant","name":"TAG_MIX"},{"kind":"function","name":"tints"},{"kind":"class","name":"Palette"},{"kind":"function","name":"root_css"},{"kind":"function","name":"css_vars"}],"package":"systemap","plane":"core","sha":"06537854b376","tests":["test_a_pick_restamps_the_root_and_is_kept","test_a_standalone_figure_keeps_literal_colours","test_contrast_is_the_wcag_formula","test_every_scheme_clears_the_text_floor_on_every_surface","test_every_text_token_clears_four_and_a_half_to_one_on_its_ground","test_overrides_apply_per_scheme_and_bare_keys_to_the_default","test_the_change_map_draws_through_variables_only","test_the_page_carries_every_scheme_and_stamps_the_default","test_the_page_draws_through_variables_only","test_the_palette_answers_one_table_two_ways","test_the_scheme_on_load","test_the_schemes_are_three_full_tables_and_the_default_is_warm","test_the_self_map_page_stamps_warm_and_switches","test_a_declared_edge_is_dashed_and_the_panel_says_so","test_a_flow_of_an_undeclared_kind_fails","test_a_label_collision_names_both_labels","test_a_layer_figure_colours_its_subjects_and_dims_the_untouched","test_a_positioned_card_stays_where_it_was","test_actor_claims_no_code_and_is_not_checked","test_agent_kinds_are_cards_that_claim_code","test_agent_layers_appear_only_with_an_agent","test_agent_model_checks_clean_and_draws_the_marks","test_calls_model_in_the_model_module","test_check_passes_on_sample","test_check_refuses_a_card_without_a_position"],"tests_primary":13,"tests_total":80,"uses":{"systemap.model":["Layer"]}},
 "systemap.trend":{"classes":[{"methods":[],"name":"Sample"},{"methods":["def size(self) -> int"],"name":"Window"}],"constants":[{"name":"FILES_ASKED","value":"60"}],"docstring":"The system over a year, read in today's cards.","errors":[],"external":[],"file":"src/systemap/trend.py","functions":[{"name":"sample_at","signature":"def sample_at(cfg: Config, model: Model, sha: str) -> Sample"},{"name":"between","signature":"def between(before: Sample, now: Sample) -> Window"},{"name":"walk","signature":"def walk(cfg: Config, model: Model, shas: list[str]) -> list[Window]"},{"name":"with_causes","signature":"def with_causes(root: Path, window: Window, cap: int=5) -> Window"},{"name":"report","signature":"def report(windows: list[Window], root: Path, since: str, every: int, top: int) -> list[str]"}],"id":"systemap.trend","imported_by":["systemap.cli"],"imports":["systemap.config","systemap.evidence","systemap.history","systemap.model"],"loc":210,"names":[{"kind":"constant","name":"FILES_ASKED"},{"kind":"class","name":"Sample"},{"kind":"class","name":"Window"},{"kind":"function","name":"sample_at"},{"kind":"function","name":"between"},{"kind":"function","name":"walk"},{"kind":"function","name":"with_causes"},{"kind":"function","name":"report"}],"package":"systemap","plane":"core","sha":"be53ff3c5e41","tests":["test_a_card_that_grew_is_counted_in_todays_cards","test_a_crossing_is_a_pair_the_map_draws_no_flow_between","test_a_quiet_stretch_says_so_rather_than_printing_a_chart","test_one_commit_is_not_a_trend","test_the_command_prints_the_largest_windows_and_what_wrote_them","test_the_facts_at_a_commit_are_read_once","test_the_window_names_the_commit_that_wrote_the_new_modules"],"tests_primary":7,"tests_total":7,"uses":{"systemap.config":["Config"],"systemap.evidence":["owners"],"systemap.history":["*"],"systemap.model":["Model"]}},
-"systemap.typescript":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str]) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"TypeScriptLanguage"}],"constants":[{"name":"SOURCE_SUFFIXES","value":"('.ts', '.tsx')"},{"name":"TEST_SUFFIXES","value":"('.test.ts', '.test.tsx', '.spec.ts', '.spec.tsx')"},{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', 'build', 'dist'}"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"WHOLE_MODULE","value":"'*'"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"TESTS_KEPT","value":"25"},{"name":"TSX","value":"Language(tree_sitter_typescript.language_tsx())"},{"name":"TYPESCRIPT","value":"TypeScriptLanguage()"}],"docstring":"Read TypeScript and TSX into systemap's language-neutral facts.","errors":[],"external":["tree_sitter","tree_sitter_typescript"],"file":"src/systemap/typescript.py","functions":[{"name":"parse_surface","signature":"def parse_surface(raw: str, path: str='') -> dict[str, Any] | None"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"}],"id":"systemap.typescript","imported_by":["systemap.extract"],"imports":[],"loc":470,"names":[{"kind":"constant","name":"SOURCE_SUFFIXES"},{"kind":"constant","name":"TEST_SUFFIXES"},{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"object","name":"TS"},{"kind":"constant","name":"TSX"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"test_names"},{"kind":"class","name":"TypeScriptLanguage"},{"kind":"constant","name":"TYPESCRIPT"}],"package":"systemap","plane":"core","sha":"09627ce31313","tests":["test_init_detects_a_typescript_repository","test_typescript_extracts_surface_imports_tests_and_entry_points","test_typescript_roots_are_discovered_from_package_metadata","test_typescript_surface_and_change_use_the_same_parser","test_typescript_test_names_are_literal_and_nested"],"tests_primary":5,"tests_total":5,"uses":{}},
+"systemap.typescript":{"classes":[{"methods":["def source_paths(self, root: Path) -> Iterable[Path]","def module_of(self, path: Path, root: Path, name: str) -> str","def module_for_path(self, repo: Path, path: str, roots: list[tuple[Path, str]]) -> str | None","def collect_module(self, path: Path, repo: Path, module: str, prefixes: frozenset[str], known: set[str], paths: dict[str, Path]) -> dict[str, Any] | None","def internal_uses(self, raw: str, prefixes: set[str], known: set[str], module: str='', is_package: bool=False, repo: Path | None=None, paths: dict[str, Path] | None=None) -> dict[str, set[str]]","def external_imports(self, raw: str, prefixes: set[str], module: str='', repo: Path | None=None, paths: dict[str, Path] | None=None) -> list[str]","def collect_tests(self, repo: Path, tests_dirs: tuple[str, ...], prefixes: set[str], paths: dict[str, Path]) -> dict[str, list[dict[str, Any]]]","def entry_points(self, repo: Path, prefixes: set[str], components: dict[str, Any], sources: dict[str, str]) -> list[dict[str, str]]","def parse_surface(self, raw: str, path: str='') -> dict[str, Any] | None","def test_names(self, raw: str) -> list[str]","def is_test_file(self, path: str, tests_dirs: tuple[str, ...]) -> bool"],"name":"TypeScriptLanguage"}],"constants":[{"name":"SOURCE_SUFFIXES","value":"('.ts', '.tsx')"},{"name":"TEST_SUFFIXES","value":"('.test.ts', '.test.tsx', '.spec.ts', '.spec.tsx')"},{"name":"SKIP_PARTS","value":"{'.git', '.venv', 'node_modules', 'build', 'dist'}"},{"name":"UPPER_NAME","value":"re.compile('[A-Z][A-Z0-9_]{2,}')"},{"name":"WHOLE_MODULE","value":"'*'"},{"name":"CONSTANTS_KEPT","value":"14"},{"name":"TESTS_KEPT","value":"25"},{"name":"TSX","value":"Language(tree_sitter_typescript.language_tsx())"},{"name":"TYPESCRIPT","value":"TypeScriptLanguage()"}],"docstring":"Read TypeScript and TSX into systemap's language-neutral facts.","errors":[],"external":["tree_sitter","tree_sitter_typescript"],"file":"src/systemap/typescript.py","functions":[{"name":"parse_surface","signature":"def parse_surface(raw: str, path: str='') -> dict[str, Any] | None"},{"name":"test_names","signature":"def test_names(raw: str) -> list[str]"}],"id":"systemap.typescript","imported_by":["systemap.extract"],"imports":["systemap.config"],"loc":545,"names":[{"kind":"constant","name":"SOURCE_SUFFIXES"},{"kind":"constant","name":"TEST_SUFFIXES"},{"kind":"constant","name":"SKIP_PARTS"},{"kind":"constant","name":"UPPER_NAME"},{"kind":"constant","name":"WHOLE_MODULE"},{"kind":"constant","name":"CONSTANTS_KEPT"},{"kind":"constant","name":"TESTS_KEPT"},{"kind":"object","name":"TS"},{"kind":"constant","name":"TSX"},{"kind":"function","name":"parse_surface"},{"kind":"function","name":"test_names"},{"kind":"class","name":"TypeScriptLanguage"},{"kind":"constant","name":"TYPESCRIPT"}],"package":"systemap","plane":"core","sha":"919a8ae55fb0","tests":["test_init_detects_a_typescript_repository","test_init_refuses_an_ambiguous_python_and_typescript_repository","test_typescript_discovers_nested_source_and_refuses_module_id_collisions","test_typescript_extracts_surface_imports_tests_and_entry_points","test_typescript_fixture_resolves_aliases_tsx_and_runs_end_to_end","test_typescript_parse_failure_is_not_an_empty_module","test_typescript_roots_are_discovered_from_package_metadata","test_typescript_surface_and_change_use_the_same_parser","test_typescript_test_names_are_literal_and_nested"],"tests_primary":9,"tests_total":9,"uses":{"systemap.config":["ConfigError"]}},
 "systemap.ways_in":{"classes":[],"constants":[{"name":"HTTP_METHODS","value":"('get', 'post', 'put', 'patch', 'delete', 'head', 'options')"},{"name":"COMMAND_DECORATORS","value":"('command', 'group')"},{"name":"TASK_DECORATORS","value":"('task', 'shared_task', 'periodic_task')"},{"name":"ROUTE_CALLS","value":"('path', 're_path', 'url')"}],"docstring":"The ways into a system: routes, commands, tasks and plugin hooks, read from the source.","errors":[],"external":[],"file":"src/systemap/ways_in.py","functions":[{"name":"in_source","signature":"def in_source(module: str, source: str) -> list[dict[str, str]]"},{"name":"in_pyproject","signature":"def in_pyproject(data: dict[str, Any], components: dict[str, Any]) -> list[dict[str, str]]"},{"name":"label","signature":"def label(point: dict[str, str]) -> str"},{"name":"read_pyproject","signature":"def read_pyproject(repo: Path) -> dict[str, Any]"}],"id":"systemap.ways_in","imported_by":["systemap.extract"],"imports":[],"loc":246,"names":[{"kind":"constant","name":"HTTP_METHODS"},{"kind":"constant","name":"COMMAND_DECORATORS"},{"kind":"constant","name":"TASK_DECORATORS"},{"kind":"constant","name":"ROUTE_CALLS"},{"kind":"function","name":"in_source"},{"kind":"function","name":"in_pyproject"},{"kind":"function","name":"label"},{"kind":"function","name":"read_pyproject"}],"package":"systemap","plane":"core","sha":"0f8b97181299","tests":["test_a_card_that_takes_a_crowd_of_routes_is_asked_once","test_a_decorator_that_is_not_a_way_in_is_not_one","test_a_journey_covers_the_way_in_it_names_in_starts","test_a_journey_that_starts_nowhere_says_so","test_background_tasks_are_ways_in_too","test_commands_are_read_from_click_typer_cleo_and_django","test_django_routes_come_from_the_urlpatterns_table","test_each_way_in_is_named_the_way_a_person_would_name_it","test_poetry_scripts_and_plugin_hooks_are_read_from_pyproject","test_web_routes_are_read_with_their_method_and_path"],"tests_primary":10,"tests_total":10,"uses":{}}
 },
 "entry_points":[{"kind":"console_script","module":"systemap.cli","name":"systemap","target":"main"},{"kind":"main_module","module":"systemap.__main__","name":"python -m systemap","target":""},{"kind":"main_function","module":"systemap.cli","name":"main","target":"main"},{"kind":"subcommand","module":"systemap.cli","name":"init","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"extract","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"facts","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"place","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"render","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"check","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"figure","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"refresh","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"judgement","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"delta","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"suggest","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"describe","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"history","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"explain","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"serve","target":"systemap"},{"kind":"subcommand","module":"systemap.cli","name":"skill","target":"systemap"},{"kind":"subcommand","module":"systemap.jev_cli","name":"audit","target":""},{"kind":"subcommand","module":"systemap.jev_cli","name":"journeys","target":""},{"kind":"subcommand","module":"systemap.jev_cli","name":"plan","target":""},{"kind":"subcommand","module":"systemap.jev_cli","name":"triage","target":""}],
diff --git a/docs/reference.md b/docs/reference.md
index 6b3a529c..7f7bff20 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -461,7 +461,7 @@ Reinstalls the skill directory that `init` writes: `SKILL.md` and
 
 | key | default | meaning |
 |---|---|---|
-| `language` | `python` | source language: `python` or `typescript`; `init` detects an unambiguous TypeScript repository |
+| `language` | `python` | source language: `python` or `typescript`; `init` detects an unambiguous TypeScript repository; TypeScript needs the `systemap[typescript]` extra |
 | `name` | `[project] name`, then the git repository's directory, then the directory name | the page title |
 | `[package_roots]` | Python packages; for TypeScript, `src` then the repository root | `"path" = "module name"` |
 | `tests_dir` | every directory named `tests` or `test` | one directory or a list; tests that import a module count as its guards |
diff --git a/pyproject.toml b/pyproject.toml
index 5f2427ec..7f2dea69 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,7 +21,10 @@ classifiers = [
     "Topic :: Documentation",
     "Topic :: Software Development :: Documentation",
 ]
-dependencies = [
+dependencies = []
+
+[project.optional-dependencies]
+typescript = [
     "tree-sitter>=0.25,<0.27",
     "tree-sitter-typescript>=0.23,<0.24",
 ]
@@ -46,6 +49,8 @@ dev = [
     "pre-commit>=4,<5",
     "pytest>=8",
     "ruff>=0.5",
+    "tree-sitter>=0.25,<0.27",
+    "tree-sitter-typescript>=0.23,<0.24",
 ]
 
 [tool.pytest.ini_options]
diff --git a/src/systemap/cli.py b/src/systemap/cli.py
index 4f51dc0c..c5ae4d95 100644
--- a/src/systemap/cli.py
+++ b/src/systemap/cli.py
@@ -135,6 +135,8 @@ def cmd_init(args: argparse.Namespace) -> int:
     root = Path(args.root).resolve() if args.root else Path.cwd().resolve()
     python_roots = config.discover_roots(root)
     typescript_roots = config.discover_typescript_roots(root)
+    if python_roots and typescript_roots:
+        raise ConfigError("both Python and TypeScript source found; set language in systemap.toml")
     language = "typescript" if typescript_roots and not python_roots else "python"
     roots = typescript_roots if language == "typescript" else python_roots
     package = roots[0][1] if roots else "mypackage"
diff --git a/src/systemap/config.py b/src/systemap/config.py
index a1c0215a..095eef66 100644
--- a/src/systemap/config.py
+++ b/src/systemap/config.py
@@ -326,9 +326,19 @@ def _typescript_name(root: Path) -> str:
 
 
 def discover_typescript_roots(root: Path) -> list[tuple[str, str]]:
-    """The conventional TypeScript source root, when it contains source."""
+    """The conventional TypeScript source root for a configured TS project."""
+    if not (root / "tsconfig.json").is_file():
+        return []
     for candidate in (root / "src", root):
-        if any(candidate.glob("*.ts")) or any(candidate.glob("*.tsx")):
+        sources = (
+            path
+            for path in candidate.rglob("*")
+            if path.is_file()
+            and path.suffix in {".ts", ".tsx"}
+            and not path.name.endswith(".d.ts")
+            and not any(part in SKIP_DIRS for part in path.parts)
+        )
+        if next(sources, None) is not None:
             return [(candidate.relative_to(root).as_posix() or ".", _typescript_name(root))]
     return []
 
diff --git a/src/systemap/extract.py b/src/systemap/extract.py
index 21c23826..436e34cd 100644
--- a/src/systemap/extract.py
+++ b/src/systemap/extract.py
@@ -27,7 +27,7 @@
 from typing import Any
 
 from systemap import ways_in
-from systemap.config import Config
+from systemap.config import Config, ConfigError
 from systemap.language import LanguageAdapter
 from systemap.model import Model, is_symbol, module_matches, public_names
 
@@ -67,6 +67,7 @@ def collect_module(
         module: str,
         prefixes: frozenset[str],
         known: set[str],
+        paths: dict[str, Path],
     ) -> dict[str, Any] | None:
         return collect_module(path, repo, module, prefixes)
 
@@ -77,10 +78,19 @@ def internal_uses(
         known: set[str],
         module: str = "",
         is_package: bool = False,
+        repo: Path | None = None,
+        paths: dict[str, Path] | None = None,
     ) -> dict[str, set[str]]:
         return internal_uses(raw, prefixes, known, module, is_package)
 
-    def external_imports(self, raw: str, prefixes: set[str]) -> list[str]:
+    def external_imports(
+        self,
+        raw: str,
+        prefixes: set[str],
+        module: str = "",
+        repo: Path | None = None,
+        paths: dict[str, Path] | None = None,
+    ) -> list[str]:
         return external_imports(raw, prefixes)
 
     def collect_tests(
@@ -121,7 +131,14 @@ def language_for(cfg: Config) -> LanguageAdapter:
     if cfg.language == PYTHON.name:
         return PYTHON
     if cfg.language == "typescript":
-        from systemap.typescript import TYPESCRIPT
+        try:
+            from systemap.typescript import TYPESCRIPT
+        except ModuleNotFoundError as exc:
+            if exc.name not in {"tree_sitter", "tree_sitter_typescript"}:
+                raise
+            raise ConfigError(
+                "TypeScript support is not installed; install systemap[typescript]"
+            ) from exc
 
         return TYPESCRIPT
     raise ValueError(f"unsupported language: {cfg.language}")
@@ -801,14 +818,21 @@ def build(cfg: Config) -> dict[str, Any]:
         for path in language.source_paths(pkg_dir):
             if any(p in SKIP_PARTS for p in path.parts):
                 continue
-            paths[language.module_of(path, pkg_dir, pkg_name)] = path
+            module = language.module_of(path, pkg_dir, pkg_name)
+            if module in paths and paths[module] != path:
+                first = paths[module].relative_to(repo).as_posix()
+                second = path.relative_to(repo).as_posix()
+                raise ConfigError(
+                    f"module id {module} is shared by {first} and {second}; rename one file"
+                )
+            paths[module] = path
     known = set(paths)
 
     components: dict[str, Any] = {}
     imports: dict[str, set[str]] = {}
     sources: dict[str, str] = {}
     for module, path in sorted(paths.items()):
-        record = language.collect_module(path, repo, module, frozenset(prefixes), known)
+        record = language.collect_module(path, repo, module, frozenset(prefixes), known, paths)
         if record is None:
             continue
         record["id"] = module
@@ -820,14 +844,22 @@ def build(cfg: Config) -> dict[str, Any]:
             raw = ""
         sources[module] = raw
         uses = language.internal_uses(
-            raw, prefixes, known, module=module, is_package=path.name == "__init__.py"
+            raw,
+            prefixes,
+            known,
+            module=module,
+            is_package=path.name == "__init__.py",
+            repo=repo,
+            paths=paths,
         )
         uses.pop(module, None)
         record["uses"] = {
             target: [WHOLE_MODULE] if WHOLE_MODULE in names else sorted(names)
             for target, names in sorted(uses.items())
         }
-        record["external"] = language.external_imports(raw, prefixes)
+        record["external"] = language.external_imports(
+            raw, prefixes, module=module, repo=repo, paths=paths
+        )
         imports[module] = set(uses)
         components[module] = record
 
diff --git a/src/systemap/language.py b/src/systemap/language.py
index fdf1a41d..b9f8b0f7 100644
--- a/src/systemap/language.py
+++ b/src/systemap/language.py
@@ -32,6 +32,7 @@ def collect_module(
         module: str,
         prefixes: frozenset[str],
         known: set[str],
+        paths: dict[str, Path],
     ) -> dict[str, Any] | None: ...
 
     def internal_uses(
@@ -41,9 +42,18 @@ def internal_uses(
         known: set[str],
         module: str = "",
         is_package: bool = False,
+        repo: Path | None = None,
+        paths: dict[str, Path] | None = None,
     ) -> dict[str, set[str]]: ...
 
-    def external_imports(self, raw: str, prefixes: set[str]) -> list[str]: ...
+    def external_imports(
+        self,
+        raw: str,
+        prefixes: set[str],
+        module: str = "",
+        repo: Path | None = None,
+        paths: dict[str, Path] | None = None,
+    ) -> list[str]: ...
 
     def collect_tests(
         self,
diff --git a/src/systemap/typescript.py b/src/systemap/typescript.py
index 29587db3..63d26f7f 100644
--- a/src/systemap/typescript.py
+++ b/src/systemap/typescript.py
@@ -13,6 +13,8 @@
 import tree_sitter_typescript
 from tree_sitter import Language, Node, Parser
 
+from systemap.config import ConfigError
+
 SOURCE_SUFFIXES = (".ts", ".tsx")
 TEST_SUFFIXES = (".test.ts", ".test.tsx", ".spec.ts", ".spec.tsx")
 SKIP_PARTS = {".git", ".venv", "node_modules", "build", "dist"}
@@ -67,7 +69,17 @@ def _without_script_suffix(specifier: str) -> str:
     return specifier
 
 
-def _resolve(specifier: str, module: str, known: set[str]) -> str | None:
+def _resolve(
+    specifier: str,
+    module: str,
+    known: set[str],
+    repo: Path | None = None,
+    paths: dict[str, Path] | None = None,
+) -> str | None:
+    if repo is not None and paths is not None and module in paths:
+        resolved = _target_from_path(specifier, paths[module], paths, repo)
+        if resolved:
+            return resolved
     specifier = _without_script_suffix(specifier)
     if specifier.startswith("."):
         parts = module.split(".")[:-1]
@@ -272,15 +284,67 @@ def _is_test_path(path: Path) -> bool:
     return text.startswith("test_") or text.endswith(TEST_SUFFIXES)
 
 
-def _target_from_path(specifier: str, importer: Path, paths: dict[str, Path]) -> str | None:
-    if not specifier.startswith("."):
-        normalized = _module_name(_without_script_suffix(specifier))
-        return next((m for m in (normalized, f"{normalized}.index") if m in paths), None)
-    target = importer.parent / _without_script_suffix(specifier)
+def _path_choices(target: Path) -> list[Path]:
+    if target.suffix in SOURCE_SUFFIXES:
+        return [target]
     choices = [target.with_suffix(s) for s in SOURCE_SUFFIXES]
     choices += [(target / "index").with_suffix(s) for s in SOURCE_SUFFIXES]
+    return choices
+
+
+def _alias_targets(specifier: str, repo: Path) -> list[Path]:
+    config = repo / "tsconfig.json"
+    try:
+        data = json.loads(config.read_text(encoding="utf-8")) if config.is_file() else {}
+    except (OSError, json.JSONDecodeError):
+        return []
+    compiler = data.get("compilerOptions", {}) if isinstance(data, dict) else {}
+    if not isinstance(compiler, dict):
+        return []
+    base = repo / str(compiler.get("baseUrl", "."))
+    aliases = compiler.get("paths", {})
+    out: list[Path] = []
+    if isinstance(aliases, dict):
+        for pattern, targets in aliases.items():
+            if not isinstance(pattern, str) or not isinstance(targets, list):
+                continue
+            before, marker, after = pattern.partition("*")
+            if marker and specifier.startswith(before) and specifier.endswith(after):
+                matched = specifier[len(before) : len(specifier) - len(after) if after else None]
+            elif not marker and specifier == pattern:
+                matched = ""
+            else:
+                continue
+            for target in targets:
+                if isinstance(target, str):
+                    out.append(base / target.replace("*", matched))
+    return [*out, base / specifier]
+
+
+def _target_from_path(
+    specifier: str,
+    importer: Path,
+    paths: dict[str, Path],
+    repo: Path | None = None,
+) -> str | None:
+    if specifier.startswith("."):
+        targets = [importer.parent / _without_script_suffix(specifier)]
+    else:
+        normalized = _module_name(_without_script_suffix(specifier))
+        named = next((m for m in (normalized, f"{normalized}.index") if m in paths), None)
+        if named:
+            return named
+        targets = _alias_targets(specifier, repo) if repo is not None else []
     resolved = {p.resolve(): module for module, p in paths.items()}
-    return next((resolved[p.resolve()] for p in choices if p.resolve() in resolved), None)
+    return next(
+        (
+            resolved[choice.resolve()]
+            for target in targets
+            for choice in _path_choices(target)
+            if choice.resolve() in resolved
+        ),
+        None,
+    )
 
 
 class TypeScriptLanguage:
@@ -318,6 +382,7 @@ def collect_module(
         module: str,
         prefixes: frozenset[str],
         known: set[str],
+        paths: dict[str, Path],
     ) -> dict[str, Any] | None:
         try:
             raw = path.read_text(encoding="utf-8")
@@ -325,11 +390,11 @@ def collect_module(
             return None
         surface = parse_surface(raw, path.as_posix())
         if surface is None:
-            return None
+            raise ConfigError(f"{path.relative_to(repo).as_posix()}: could not parse TypeScript")
         for entry in surface["names"]:
             if entry.get("kind") != "reexport":
                 continue
-            target = _resolve(entry["reexport_of"], module, known)
+            target = _resolve(entry["reexport_of"], module, known, repo, paths)
             if target:
                 entry["reexport_of"] = target
         return {
@@ -347,18 +412,27 @@ def internal_uses(
         known: set[str],
         module: str = "",
         is_package: bool = False,
+        repo: Path | None = None,
+        paths: dict[str, Path] | None = None,
     ) -> dict[str, set[str]]:
         root = _root(raw)
         if root is None:
             return {}
         uses: dict[str, set[str]] = defaultdict(set)
         for specifier, names in _imports(root):
-            target = _resolve(specifier, module, known)
+            target = _resolve(specifier, module, known, repo, paths)
             if target:
                 uses[target].update(names)
         return dict(uses)
 
-    def external_imports(self, raw: str, prefixes: set[str]) -> list[str]:
+    def external_imports(
+        self,
+        raw: str,
+        prefixes: set[str],
+        module: str = "",
+        repo: Path | None = None,
+        paths: dict[str, Path] | None = None,
+    ) -> list[str]:
         root = _root(raw)
         if root is None:
             return []
@@ -366,6 +440,7 @@ def external_imports(self, raw: str, prefixes: set[str]) -> list[str]:
             specifier
             for specifier, _names in _imports(root)
             if not specifier.startswith(".")
+            and _resolve(specifier, module, set(paths or {}), repo, paths) is None
             and not any(
                 _module_name(specifier) == prefix
                 or _module_name(specifier).startswith(prefix + ".")
@@ -403,7 +478,7 @@ def collect_tests(
             targets = {
                 target
                 for specifier, _names in _imports(root)
-                if (target := _target_from_path(specifier, path, paths))
+                if (target := _target_from_path(specifier, path, paths, repo))
             }
             stem = path.name.split(".", 1)[0].removeprefix("test_")
             for target in targets:
diff --git a/tests/fixtures/typescript-app/map/model.py b/tests/fixtures/typescript-app/map/model.py
new file mode 100644
index 00000000..dbffbd01
--- /dev/null
+++ b/tests/fixtures/typescript-app/map/model.py
@@ -0,0 +1,37 @@
+from systemap.model import Component, Container, Meaning, Model, Region
+
+CONTAINERS = (Container(id="system", label="SYSTEM", box=(20, 20, 600, 300), tone="server"),)
+
+REGIONS = (
+    Region(id="application", label="APPLICATION", box=(40, 60, 560, 220), container="system"),
+)
+
+COMPONENTS = (
+    Component(
+        id="Application",
+        does="Serves a user through the command line and web view.",
+        implemented_by=(
+            "acme.web.cli",
+            "acme.web.client",
+            "acme.web.index",
+            "acme.web.service",
+            "acme.web.view",
+        ),
+        entry="serve",
+        region="application",
+        x=220,
+        y=120,
+    ),
+)
+
+MODEL = Model(
+    canvas=(640, 340),
+    containers=CONTAINERS,
+    regions=REGIONS,
+    components=COMPONENTS,
+    flows=(),
+    flow_kinds=(),
+    invariants=(),
+)
+
+MEANING = Meaning(plain={"Application": "the application"})
diff --git a/tests/fixtures/typescript-app/package.json b/tests/fixtures/typescript-app/package.json
new file mode 100644
index 00000000..d8d464bc
--- /dev/null
+++ b/tests/fixtures/typescript-app/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "@acme/web",
+  "bin": {
+    "web": "src/cli.ts"
+  }
+}
diff --git a/tests/fixtures/typescript-app/src/cli.ts b/tests/fixtures/typescript-app/src/cli.ts
new file mode 100644
index 00000000..993ee602
--- /dev/null
+++ b/tests/fixtures/typescript-app/src/cli.ts
@@ -0,0 +1 @@
+export function main(): void {}
diff --git a/tests/fixtures/typescript-app/src/client.ts b/tests/fixtures/typescript-app/src/client.ts
new file mode 100644
index 00000000..2cedbd87
--- /dev/null
+++ b/tests/fixtures/typescript-app/src/client.ts
@@ -0,0 +1,3 @@
+export interface User { id: string }
+
+export function fetchUser(id: string): User { return { id }; }
diff --git a/tests/fixtures/typescript-app/src/index.ts b/tests/fixtures/typescript-app/src/index.ts
new file mode 100644
index 00000000..e7cb6816
--- /dev/null
+++ b/tests/fixtures/typescript-app/src/index.ts
@@ -0,0 +1,3 @@
+export { serve } from "@/service";
+export { serve as default } from "@/service";
+export { UserView } from "@/view";
diff --git a/tests/fixtures/typescript-app/src/service.ts b/tests/fixtures/typescript-app/src/service.ts
new file mode 100644
index 00000000..f0231baf
--- /dev/null
+++ b/tests/fixtures/typescript-app/src/service.ts
@@ -0,0 +1,6 @@
+import { fetchUser, type User } from "@/client";
+import { z } from "zod";
+
+export const LIMIT = 3;
+
+export function serve(id: string): User { return fetchUser(z.string().parse(id)); }
diff --git a/tests/fixtures/typescript-app/src/view.tsx b/tests/fixtures/typescript-app/src/view.tsx
new file mode 100644
index 00000000..4ba44138
--- /dev/null
+++ b/tests/fixtures/typescript-app/src/view.tsx
@@ -0,0 +1 @@
+export function UserView(): JSX.Element { return <main>User</main>; }
diff --git a/tests/fixtures/typescript-app/systemap.toml b/tests/fixtures/typescript-app/systemap.toml
new file mode 100644
index 00000000..463dd569
--- /dev/null
+++ b/tests/fixtures/typescript-app/systemap.toml
@@ -0,0 +1,6 @@
+language = "typescript"
+name = "TypeScript fixture"
+tests_dir = "tests"
+
+[package_roots]
+"src" = "acme.web"
diff --git a/tests/fixtures/typescript-app/tests/service.test.ts b/tests/fixtures/typescript-app/tests/service.test.ts
new file mode 100644
index 00000000..6a5624ba
--- /dev/null
+++ b/tests/fixtures/typescript-app/tests/service.test.ts
@@ -0,0 +1,3 @@
+import { serve } from "@/service";
+
+test("serves a user", () => serve("1"));
diff --git a/tests/fixtures/typescript-app/tsconfig.json b/tests/fixtures/typescript-app/tsconfig.json
new file mode 100644
index 00000000..2c8ee2bb
--- /dev/null
+++ b/tests/fixtures/typescript-app/tsconfig.json
@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}
diff --git a/tests/test_typescript.py b/tests/test_typescript.py
index 34bc2ad6..3f0b06d7 100644
--- a/tests/test_typescript.py
+++ b/tests/test_typescript.py
@@ -1,7 +1,9 @@
 from __future__ import annotations
 
+import shutil
 from pathlib import Path
 
+import pytest
 from conftest import write_tree
 
 from systemap import change, config, extract
@@ -11,6 +13,7 @@
 
 TREE = {
     "package.json": '{"name":"@acme/web","bin":{"web":"src/cli.ts"}}',
+    "tsconfig.json": '{"compilerOptions":{}}',
     "systemap.toml": (
         'language = "typescript"\ntests_dir = "tests"\n[package_roots]\n"src" = "web"\n'
     ),
@@ -75,6 +78,7 @@ def test_typescript_roots_are_discovered_from_package_metadata(tmp_path: Path) -
         tmp_path,
         {
             "package.json": '{"name":"@acme/web"}',
+            "tsconfig.json": '{"compilerOptions":{}}',
             "systemap.toml": 'language = "typescript"\n',
             "src/index.ts": "export const app = () => 1;\n",
         },
@@ -89,6 +93,7 @@ def test_init_detects_a_typescript_repository(tmp_path: Path) -> None:
         tmp_path,
         {
             "package.json": '{"name":"web"}',
+            "tsconfig.json": '{"compilerOptions":{}}',
             "src/index.ts": "export const app = () => 1;\n",
         },
     )
@@ -119,3 +124,78 @@ def test_typescript_test_names_are_literal_and_nested() -> None:
         'test("one", () => {}); describe("group", () => { it("two", () => {}) });'
     ) == ["one", "two"]
     assert names_of_tests("test(name, () => {})") == []
+
+
+def test_typescript_fixture_resolves_aliases_tsx_and_runs_end_to_end(
+    tmp_path: Path, capsys: pytest.CaptureFixture[str]
+) -> None:
+    fixture = Path(__file__).parent / "fixtures" / "typescript-app"
+    shutil.copytree(fixture, tmp_path, dirs_exist_ok=True)
+
+    cfg = config.load(tmp_path)
+    facts = extract.build(cfg)
+    service = facts["components"]["acme.web.service"]
+    assert service["uses"] == {"acme.web.client": ["User", "fetchUser"]}
+    assert service["external"] == ["zod"]
+    assert service["tests"] == ["serves a user"]
+    assert facts["components"]["acme.web.view"]["functions"] == [
+        {"name": "UserView", "signature": "function UserView(): JSX.Element"}
+    ]
+    assert facts["components"]["acme.web.index"]["names"] == [
+        {"name": "serve", "kind": "function", "reexport_of": "acme.web.service"},
+        {"name": "default", "kind": "function", "reexport_of": "acme.web.service"},
+        {"name": "UserView", "kind": "function", "reexport_of": "acme.web.view"},
+    ]
+
+    assert main(["--root", str(tmp_path), "refresh"]) == 0
+    assert main(["--root", str(tmp_path), "check"]) == 0
+    assert (tmp_path / "docs/map/map.json").is_file()
+    assert (tmp_path / "docs/map/index.html").is_file()
+    capsys.readouterr()
+
+
+def test_typescript_parse_failure_is_not_an_empty_module(tmp_path: Path) -> None:
+    write_tree(
+        tmp_path,
+        {
+            "systemap.toml": 'language = "typescript"\n[package_roots]\n"src" = "web"\n',
+            "src/broken.ts": "export function broken( {",
+        },
+    )
+    with pytest.raises(config.ConfigError, match="src/broken.ts: could not parse TypeScript"):
+        extract.build(config.load(tmp_path))
+
+
+def test_init_refuses_an_ambiguous_python_and_typescript_repository(
+    tmp_path: Path, capsys: pytest.CaptureFixture[str]
+) -> None:
+    write_tree(
+        tmp_path,
+        {
+            "pkg/__init__.py": "",
+            "package.json": '{"name":"web"}',
+            "tsconfig.json": '{"compilerOptions":{}}',
+            "src/index.ts": "export const app = 1;",
+        },
+    )
+    assert main(["--root", str(tmp_path), "init", "--no-ci"]) == 2
+    assert "both Python and TypeScript source found" in capsys.readouterr().err
+
+
+def test_typescript_discovers_nested_source_and_refuses_module_id_collisions(
+    tmp_path: Path,
+) -> None:
+    write_tree(
+        tmp_path,
+        {
+            "package.json": '{"name":"web"}',
+            "tsconfig.json": '{"compilerOptions":{}}',
+            "systemap.toml": 'language = "typescript"\n',
+            "src/nested/one.ts": "export const ONE = 1;",
+        },
+    )
+    assert config.discover_typescript_roots(tmp_path) == [("src", "web")]
+
+    write_tree(tmp_path, {"src/some-file.ts": "", "src/some_file.ts": ""})
+    with pytest.raises(config.ConfigError, match="module id web.some_file is shared"):
+        extract.build(config.load(tmp_path))
diff --git a/uv.lock b/uv.lock
index 2e4d65e3..f798d6e0 100644
--- a/uv.lock
+++ b/uv.lock
@@ -491,7 +491,9 @@ wheels = [
 name = "systemap"
 version = "1.2.0"
 source = { editable = "." }
-dependencies = [
+
+[package.optional-dependencies]
+typescript = [
     { name = "tree-sitter" },
     { name = "tree-sitter-typescript" },
 ]
@@ -502,13 +504,16 @@ dev = [
     { name = "pre-commit" },
     { name = "pytest" },
     { name = "ruff" },
+    { name = "tree-sitter" },
+    { name = "tree-sitter-typescript" },
 ]
 
 [package.metadata]
 requires-dist = [
-    { name = "tree-sitter", specifier = ">=0.25,<0.27" },
-    { name = "tree-sitter-typescript", specifier = ">=0.23,<0.24" },
+    { name = "tree-sitter", marker = "extra == 'typescript'", specifier = ">=0.25,<0.27" },
+    { name = "tree-sitter-typescript", marker = "extra == 'typescript'", specifier = ">=0.23,<0.24" },
 ]
+provides-extras = ["typescript"]
 
 [package.metadata.requires-dev]
 dev = [
@@ -516,6 +521,8 @@ dev = [
     { name = "pre-commit", specifier = ">=4,<5" },
     { name = "pytest", specifier = ">=8" },
     { name = "ruff", specifier = ">=0.5" },
+    { name = "tree-sitter", specifier = ">=0.25,<0.27" },
+    { name = "tree-sitter-typescript", specifier = ">=0.23,<0.24" },
 ]
 
 [[package]]