feat(fr-033): Python port S-B1 — embed spec/metamodel JSON + reader + descriptions

Embeds the 15 shared spec/metamodel/*.json as Python package data (byte-gated) +
adds a reader sourcing every type/attr/common description (+rules/example/whenToUse)
from them onto the Python registry pre-seal — single-sourced, byte-identical to TS,
never hand-copied. The manifest's description fields now match the golden;
test_registry_conformance stays RED pending the strict children graph + cardinality
+ per-subtype attr scoping (S-B2a/B2b).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: dmealing

server/python/pyproject.toml

@@ -75,6 +75,12 @@ exclude = ["**/KNOWN_GAPS.md"]
 # falls back to walking up to the monorepo agent-context/.
 [tool.hatch.build.hooks.custom]
 
+# FR-033 — the 15 shared spec/metamodel/*.json files are COMMITTED copies under
+# src/metaobjects/spec_metamodel/ (not build-time-generated), so hatchling's default
+# package inclusion ships them in both the sdist and the wheel (read via
+# importlib.resources, AOT-safe). A byte-identity gate
+# (tests/conformance/test_spec_metamodel_embed.py) keeps the copies from drifting
+# from the repo-root spec/metamodel/ source.
 [tool.hatch.build]
 artifacts = ["src/metaobjects/agent_context/_content/**"]
 

server/python/src/metaobjects/provider.py

@@ -63,11 +63,22 @@ def register_types(self, registry: TypeRegistry) -> None:
 
 
 def compose_registry(providers: list[Provider]) -> TypeRegistry:
-    """Topologically sort providers by dependency, then register each into a fresh registry."""
+    """Topologically sort providers by dependency, then register each into a fresh registry.
+
+    FR-033 S-B1 — after every provider has run (and BEFORE any caller seals the
+    registry), source every type / attr / common-attr description from the embedded
+    shared ``spec/metamodel/*.json`` onto the registry. Single-sourced, byte-identical
+    to TS — never hand-copied. A ``(type, subType)`` (or attr) the spec does not
+    declare keeps its empty description (the residual S-B2 scoping work).
+    """
+    # Deferred import avoids a provider -> spec_metamodel -> registry import cycle.
+    from .spec_metamodel import apply_spec_descriptions
+
     ordered = _topo_sort(providers)
     registry = TypeRegistry()
     for provider in ordered:
         provider.register_types(registry)
+    apply_spec_descriptions(registry)
     return registry