Normalize modeled decision surface paths (#233)

* Normalize modeled decision surface paths

* Refresh AGENTS mesh after decision route update

* Require modeled surfaces to be explicit lists

Author: 8Dionysus

docs/decisions/AGENTS.md

@@ -21,6 +21,7 @@ docs thematic cleanup, also read `docs/guardrails/THEMATIC_DISTRICT_PROTOCOL.md`
 - Keep provenance, dates, and source relationships explicit.
 - Route current mechanic doctrine to `mechanics/<slug>/` packages when a package owns the material.
 - Route owner-local truth to the owner repository instead of expanding the center.
+- Keep `modeled_surfaces` in `docs/decisions/indexes/index_contract.yaml` as a top-level list of normalized repo-relative paths under `docs/decisions/`; do not use it for root non-record Markdown.
 
 ## Decision Review Gate
 

docs/decisions/indexes/index_contract.yaml

@@ -10,7 +10,7 @@ generated_indexes:
   - docs/decisions/indexes/by-center-facet.md
   - docs/decisions/indexes/by-mechanic.md
   - docs/decisions/indexes/by-guard.md
-modeled_surfaces:
+modeled_surfaces: []
 fields:
   decision_id:
     required: true

generated/agents_mesh.min.json

@@ -395,19 +395,24 @@ def modeled_decision_lane_surfaces(
     contract: dict[str, object],
     issues: list[tuple[str, str]],
 ) -> set[str]:
-    modeled = contract.get("modeled_surfaces", [])
+    modeled = contract.get("modeled_surfaces")
     if modeled is None:
+        issues.append((INDEX_CONTRACT_PATH.as_posix(), "modeled_surfaces must be a list of repo-relative docs/decisions paths"))
         return set()
     if not isinstance(modeled, list) or not all(isinstance(item, str) for item in modeled):
         issues.append((INDEX_CONTRACT_PATH.as_posix(), "modeled_surfaces must be a list of repo-relative docs/decisions paths"))
         return set()
-    prefix = f"{DECISIONS_DIR.as_posix()}/"
     allowed: set[str] = set()
     for item in modeled:
-        if not item.startswith(prefix):
+        relative = Path(item)
+        if relative.is_absolute() or ".." in relative.parts:
+            issues.append((INDEX_CONTRACT_PATH.as_posix(), f"modeled_surfaces entry must be a normalized repo-relative path under {DECISIONS_DIR.as_posix()}: {item}"))
+            continue
+        try:
+            relative.relative_to(DECISIONS_DIR)
+        except ValueError:
             issues.append((INDEX_CONTRACT_PATH.as_posix(), f"modeled_surfaces entry must live under {DECISIONS_DIR.as_posix()}: {item}"))
             continue
-        relative = Path(item)
         if relative.parent == DECISIONS_DIR and relative.suffix == ".md" and not FULL_ID_FILENAME_RE.match(relative.name):
             issues.append((INDEX_CONTRACT_PATH.as_posix(), f"modeled_surfaces must not include root non-record Markdown: {item}"))
             continue