ambitgraph 0.4.0__tar.gz → 0.6.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ambitgraph
-Version: 0.4.0
+Version: 0.6.0
 Summary: Read-only codebase scan: reusable units, families, roles, ownership candidates, duplication.
 Author: AmbitGraph
 License: Proprietary

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

@@ -23,6 +23,10 @@ GRAPH_EXPORT_CAP = 200          # the brief's cap
 EXPORT_INDEX = "index.html"
 EXPORT_MAP = reg.EXPORT_MAP_REL
 EXPORT_LIBRARY = "library.html"
+# The Whole map tab. NOT map.html -- that is the default GRAPH seed page
+# and every existing link plus the manifest resolve to it; renaming it to
+# free the nicer name would break links to fix an aesthetic.
+EXPORT_OVERVIEW = reg.EXPORT_OVERVIEW_REL
 MANIFEST_NAME = "ambitgraph-map.export.json"   # U4 review fix (blocker): the
 # scoped-prune manifest -- lists every relative path THIS export wrote, so
 # the NEXT export deletes only what it itself owns, never a hand-placed file.
@@ -38,6 +42,18 @@ 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"
+
 Row = collections.namedtuple("Row", "rel route_path raw_query depth")
 
 _SLUG_HTML_RE = re.compile(r".+-[0-9a-f]{6}\.html$")
@@ -139,6 +155,8 @@ def page_rows(model, dialects):
     # existing link and the manifest resolve to it. A real row now, not a copy.
     rows.append(Row(EXPORT_MAP, "/graph", index_query, 0))
 
+    rows.append(Row(EXPORT_OVERVIEW, "/overview", "", 0))
+
     routes_by_uid = lib._routes_by_uid(dialects)
     units_iter = model.units.values() if hasattr(model, "units") else ()
     order = fam.families_in_use(units_iter, routes_by_uid)
@@ -292,6 +310,43 @@ 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
+
     # 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
@@ -317,5 +372,11 @@ 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)
+    _write_manifest(out_dir, [row.rel for row in rows] + extra)
     return index_text