ambitgraph 0.5.0__tar.gz → 0.7.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ambitgraph
-Version: 0.5.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.5.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.5.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"
@@ -42,6 +46,25 @@ ENRICH_DOC_NAME = "ambit-map-enrich.md"
 # generalisation of ambit-map-enrich.md's own producer-portability clause.
 CONTRACT_DOC_NAME = "ambit-mapllm-contract.md"
 
+# 2026-09-05 (embed-fragment ruling): a
+# SECOND artifact for the Graph screen, alongside map.html -- canvas and
+# its own interaction only, for a host (Omniscient's UrCode tab) that
+# integrates it as native DOM instead of serving map.html's full page
+# inside an iframe. `embed/<kind>.html` is IDP's own proposed naming,
+# accepted in the ruling. One default-seed fragment for v1 (IDP's own
+# call, 2026-09-05: the dashboard shows THE map, a sha-gated regenerate
+# keeps one fragment cheap and current, and per-seed fragments would
+# 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")
 
 _SLUG_HTML_RE = re.compile(r".+-[0-9a-f]{6}\.html$")
@@ -298,6 +321,85 @@ def write_export(state, out_dir, route, render, now_iso):
         if row.rel == EXPORT_INDEX:
             index_text = html
 
+    # 2026-09-05 (embed-fragment ruling): the default-seed graph fragment,
+    # written OUTSIDE the row loop above because it is not a `route()`-
+    # addressable page -- no reader ever navigates to embed/graph.html
+    # directly, an embedder's own build step reads it. seed_id=None reuses
+    # render_graph's own always-seeded resolution (the same fallback
+    # map.html's own row already relies on via page_rows' index_query), so
+    # this can never silently pick a different seed than map.html draws.
+    # "" (no real canvas -- a damaged model, or the map_repo's own
+    # zero-unit branch) means no file at all, never an empty one an
+    # embedder would have to special-case; its own absence is the signal.
+    embed_frag = gph.render_graph_embed_fragment(model, dialects=dialects)
+    embed_rel = None
+    if embed_frag:
+        # render_graph_embed_fragment builds its hrefs the SAME way
+        # render_graph does (registry.href_seed_unit/href_table, absolute
+        # /unit?u=.../table?t=... paths meant for a SERVED map) -- every
+        # other exported page gets those rewritten to real static
+        # sibling-file paths by objects.document()'s own static_rewrite
+        # call, which this fragment never passes through (it skips
+        # document() by design, no hero/nav to assemble). Without this,
+        # a node click in an embedder's integrated canvas would 404
+        # against a route that only exists in served mode -- exactly the
+        # "navigate to the export's per-seed page" IDP's own build
+        # depends on. depth=1 matches embed/graph.html's own real
+        # location, same as graph/<slug>.html's row above.
+        embed_ctx = reg.StaticCtx(EMBED_GRAPH_REL.count("/"), graph_slugs, "")
+        embed_frag = reg.static_rewrite(embed_frag, embed_ctx)
+        # A4: resolve `N noun(s)` markers here too -- objects.document()
+        # does this for every real page (customer voice is not a property
+        # of how a page was served), but this fragment never passes
+        # through document() at all, so nothing else ever will.
+        embed_frag = reg.inflect_counts(embed_frag)
+        embed_p = out_dir / EMBED_GRAPH_REL
+        embed_p.parent.mkdir(parents=True, exist_ok=True)
+        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
@@ -323,5 +425,15 @@ def write_export(state, out_dir, route, render, now_iso):
     # again would name it twice in the manifest. C3: the contract doc joins
     # ENRICH_DOC_NAME here for the identical reason -- an un-manifested copy
     # would be a stray file the NEXT export cannot recognise as its own.
-    _write_manifest(out_dir, [row.rel for row in rows] + [ENRICH_DOC_NAME, CONTRACT_DOC_NAME])
+    # embed_rel is None (never named) exactly when no file was written --
+    # naming an absent path here would make the NEXT export's prune try to
+    # unlink a file that was never there.
+    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