ambitgraph 0.6.0__tar.gz → 0.7.0__tar.gz

{ambitgraph-0.6.0/ambitgraph.egg-info → ambitgraph-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ambitgraph
-Version: 0.6.0
+Version: 0.7.0
 Summary: Read-only codebase scan: reusable units, families, roles, ownership candidates, duplication.
 Author: AmbitGraph
 License: Proprietary
@@ -53,6 +53,16 @@ Your codebase is displayed in your browser as local webpages.
 
 It does not make any changes to your codebase.
 
+## Update
+
+```
+pip install --upgrade ambitgraph
+```
+
+`python -m ambitgraph --version` (or `ambit --version`) prints the version you have.
+
+Updating the tool is not the same as refreshing a map: after your code changes, just run `python -m ambitgraph map <folder>` again.
+
 ## A GRAPH
 
 Modules, Classes, Imports, Calls, DB Tables, anything in your code mapped on its connections.

{ambitgraph-0.6.0 → ambitgraph-0.7.0}/README.md

@@ -25,6 +25,16 @@ Your codebase is displayed in your browser as local webpages.
 
 It does not make any changes to your codebase.
 
+## Update
+
+```
+pip install --upgrade ambitgraph
+```
+
+`python -m ambitgraph --version` (or `ambit --version`) prints the version you have.
+
+Updating the tool is not the same as refreshing a map: after your code changes, just run `python -m ambitgraph map <folder>` again.
+
 ## A GRAPH
 
 Modules, Classes, Imports, Calls, DB Tables, anything in your code mapped on its connections.

{ambitgraph-0.6.0 → ambitgraph-0.7.0}/ambit_map/export.py

@@ -2,10 +2,13 @@
 
 Pure over the model + a writer: `page_rows` is PURE (no I/O, no clock) and
 `write_export` writes what its `render` callable returns. Imports:
-registry, objects, families, graph, library (same package only) plus
-`hashlib`, `collections`, `pathlib`, `urllib.parse.quote`. It never imports
-`serve` -- `serve` imports IT (U4-F/U4-G), so there is no cycle and
-`write_export` is unit-testable against a fake router/renderer (T-36).
+registry, objects, families, graph, library, page (same package only) plus
+`hashlib`, `collections`, `pathlib`, `urllib.parse.quote`. `page` added
+2026-09-06 for `resolve_overview_state`/`resolve_library_extras` -- `page`
+does not import `export`, so this stays a one-way edge, not a cycle. It
+never imports `serve` -- `serve` imports IT (U4-F/U4-G), so there is no
+cycle and `write_export` is unit-testable against a fake router/renderer
+(T-36).
 """
 import collections
 import json
@@ -18,6 +21,7 @@ from . import objects as ob
 from . import families as fam
 from . import graph as gph
 from . import library as lib
+from . import page as pg
 
 GRAPH_EXPORT_CAP = 200          # the brief's cap
 EXPORT_INDEX = "index.html"
@@ -53,6 +57,13 @@ CONTRACT_DOC_NAME = "ambit-mapllm-contract.md"
 # multiply for clicks that may never come) -- not every graph_keys() seed
 # page.py:page_rows() also pre-renders.
 EMBED_GRAPH_REL = "embed/graph.html"
+# 2026-09-06 (IDP's ur5 inline-switch wave, "the tile should switch what
+# is displayed below the tiles"): the Whole-map (islands) tab's own
+# fragment, beside embed/graph.html under the SAME ur4 contract.
+EMBED_OVERVIEW_REL = "embed/overview.html"
+# 2026-09-06 (founder live-page review, item 1): the Library home's own
+# fragment, beside embed/graph.html and embed/overview.html.
+EMBED_LIBRARY_REL = "embed/library.html"
 
 Row = collections.namedtuple("Row", "rel route_path raw_query depth")
 
@@ -347,6 +358,48 @@ def write_export(state, out_dir, route, render, now_iso):
         embed_p.write_text(embed_frag, encoding="utf-8", newline="\n")
         embed_rel = EMBED_GRAPH_REL
 
+    # 2026-09-06 (IDP's ur5 inline-switch wave): the SAME embed-fragment
+    # shape for the Whole-map (islands) tab, beside embed/graph.html. The
+    # flash draws no hrefs at all (opening-view ruling section 4.6, no
+    # hit-testing) so static_rewrite/inflect_counts have nothing to touch
+    # today -- called anyway, for the same reason the graph fragment
+    # calls them unconditionally: this fragment skips objects.document()
+    # by design, so nothing else ever will if render_islands_canvas later
+    # grows either shape.
+    ov_state, ov_layout = pg.resolve_overview_state(model, dialects, state.run_dir)
+    overview_frag = gph.render_overview_embed_fragment(ov_layout) if ov_layout else ""
+    overview_rel = None
+    if overview_frag:
+        overview_ctx = reg.StaticCtx(EMBED_OVERVIEW_REL.count("/"), graph_slugs, "")
+        overview_frag = reg.static_rewrite(overview_frag, overview_ctx)
+        overview_frag = reg.inflect_counts(overview_frag)
+        overview_p = out_dir / EMBED_OVERVIEW_REL
+        overview_p.parent.mkdir(parents=True, exist_ok=True)
+        overview_p.write_text(overview_frag, encoding="utf-8", newline="\n")
+        overview_rel = EMBED_OVERVIEW_REL
+
+    # 2026-09-06 (founder live-page review, item 1): the SAME embed-
+    # fragment shape for the Library home, beside embed/graph.html and
+    # embed/overview.html. `gap`/`grammarless_table` are the wall-legal
+    # seams lib.render_library's own docstring names -- computed here via
+    # page.resolve_library_extras, the SAME helper serve.py's own library
+    # dispatch now calls, so this can never silently diverge on either
+    # fact from the served route's own library.html.
+    lib_gap, lib_grammarless = pg.resolve_library_extras(model, dialects)
+    library_frag = lib.render_library_embed_fragment(
+        model, dialects=dialects, judged=state.judged, envelope=state.envelope,
+        gap=lib_gap, grammarless_table=lib_grammarless,
+        mapllm_stranger_groups=state.mapllm_stranger_groups)
+    library_rel = None
+    if library_frag:
+        library_ctx = reg.StaticCtx(EMBED_LIBRARY_REL.count("/"), graph_slugs, "")
+        library_frag = reg.static_rewrite(library_frag, library_ctx)
+        library_frag = reg.inflect_counts(library_frag)
+        library_p = out_dir / EMBED_LIBRARY_REL
+        library_p.parent.mkdir(parents=True, exist_ok=True)
+        library_p.write_text(library_frag, encoding="utf-8", newline="\n")
+        library_rel = EMBED_LIBRARY_REL
+
     # W6 D-8/D-10 (THE PACKAGING ITEM): drop ambit-map-enrich.md beside the
     # export so it is ALWAYS present -- even for a wheel-only install where
     # a repo checkout's own top-level copy is absent -- the SAME copy-beside
@@ -378,5 +431,9 @@ def write_export(state, out_dir, route, render, now_iso):
     extra = [ENRICH_DOC_NAME, CONTRACT_DOC_NAME]
     if embed_rel is not None:
         extra.append(embed_rel)
+    if overview_rel is not None:
+        extra.append(overview_rel)
+    if library_rel is not None:
+        extra.append(library_rel)
     _write_manifest(out_dir, [row.rel for row in rows] + extra)
     return index_text