@mc-and-his-agents/loom-installer 0.1.18 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mc-and-his-agents/loom-installer",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Node installer for Loom plugin and single-skill installation surfaces.",
   "type": "module",
   "bin": {

package/payload/manifest.json

@@ -2,9 +2,9 @@
   "schema_version": "loom-installer-payload/v1",
   "loom_version": "0.4.0",
   "source_repository": "https://github.com/MC-and-his-Agents/Loom",
-  "source_commit": "3daaced2a93b2f5170fc738bcd631d6323336c82",
+  "source_commit": "f25d0954fff0ab7dcf7234f89eb001bc08a0c9df",
   "source_ref": "main",
-  "built_at": "2026-04-25T13:30:42+08:00",
+  "built_at": "2026-04-25T13:46:37+08:00",
   "runtime": {
     "python_minimum": "3.10",
     "python_recommended": "3.11+"
@@ -628,18 +628,18 @@
     },
     {
       "path": "plugin/loom/skills/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "plugin/loom/skills/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "plugin/loom/skills/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "plugin/loom/skills/shared/scripts/loom_status.py",
@@ -1213,18 +1213,18 @@
     },
     {
       "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_status.py",
@@ -1828,18 +1828,18 @@
     },
     {
       "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_status.py",
@@ -2443,18 +2443,18 @@
     },
     {
       "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_status.py",
@@ -3063,18 +3063,18 @@
     },
     {
       "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_status.py",
@@ -3678,18 +3678,18 @@
     },
     {
       "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_status.py",
@@ -4293,18 +4293,18 @@
     },
     {
       "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_status.py",
@@ -4908,18 +4908,18 @@
     },
     {
       "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_status.py",
@@ -5523,18 +5523,18 @@
     },
     {
       "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_status.py",
@@ -6138,18 +6138,18 @@
     },
     {
       "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_check.py",
-      "bytes": 271781,
-      "sha256": "916036e9f69521168511ca4e30cd7066ae2d9abb22294fb984ebe3d76d199cfa"
+      "bytes": 273789,
+      "sha256": "2d0a345221eeca04cef5e635b84f059ce6cf4b9316f4a210360237597406ae2e"
     },
     {
       "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_flow.py",
-      "bytes": 288183,
-      "sha256": "76fd6610e74672d527f43edd1311dbd6ca571406536d04dae502236eb67a5a38"
+      "bytes": 290536,
+      "sha256": "69c44efb623eb26aadda9141ecb73eea036444c1023b833da7f9cbb709f68428"
     },
     {
       "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_init.py",
-      "bytes": 81617,
-      "sha256": "5ebf6b81bd6d0ef6ef5ac2663d98b47d9e4117f1087fd52742bd189a6be5692b"
+      "bytes": 83763,
+      "sha256": "3132627c8aec74fd5f8dd232bd2f8c10a035674723de22877b6079c1ca8cf9d1"
     },
     {
       "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_status.py",

package/payload/plugin/loom/skills/shared/scripts/loom_check.py

@@ -95,6 +95,7 @@ CORE_DOCS = (
     "docs/evidence/validations/validation-closeout-reconciliation-blocking-gate.md",
     "docs/evidence/validations/validation-adoption-maturity-upgrade-automation.md",
     "docs/evidence/validations/validation-adoption-maturity-required-fields.md",
+    "docs/evidence/validations/validation-skills-consume-maturity-upgrade-path.md",
     "docs/evidence/validations/validation-github-profile-binding-orchestration.md",
     "docs/evidence/validations/validation-github-profile-drift-reconciliation.md",
     "docs/evidence/validations/validation-github-profile-graphql-budget-guard.md",
@@ -1388,6 +1389,35 @@ def require_governance_upgrade_payload(
             failures.append(Failure(category, f"{context} missing-input actions must include recommended_action"))
 
 
+def require_maturity_upgrade_path(
+    failures: list[Failure],
+    *,
+    category: str,
+    context: str,
+    payload: object,
+) -> None:
+    if not isinstance(payload, dict):
+        failures.append(Failure(category, f"{context} must include maturity_upgrade_path"))
+        return
+    if payload.get("result") not in {"pass", "block"}:
+        failures.append(Failure(category, f"{context} result must be pass/block"))
+    if payload.get("current") not in {"unadopted", "light", "standard", "strong", "unknown"}:
+        failures.append(Failure(category, f"{context} current maturity must stay within the stable set"))
+    if payload.get("next") not in {None, "light", "standard", "strong"}:
+        failures.append(Failure(category, f"{context} next maturity must stay within the stable set"))
+    if not isinstance(payload.get("missing_inputs"), list):
+        failures.append(Failure(category, f"{context} missing_inputs must be a list"))
+    if not isinstance(payload.get("missing_details"), list):
+        failures.append(Failure(category, f"{context} missing_details must be a list"))
+    if payload.get("fallback_to") not in {None, "adoption", "admission"}:
+        failures.append(Failure(category, f"{context} fallback_to must be stable"))
+    if payload.get("next") is not None and not isinstance(payload.get("upgrade_entry"), str):
+        failures.append(Failure(category, f"{context} upgrade_entry must be present when next maturity exists"))
+    validation_entries = payload.get("validation_entries")
+    if not isinstance(validation_entries, list) or not validation_entries:
+        failures.append(Failure(category, f"{context} validation_entries must be non-empty"))
+
+
 def require_review_record_contract(
     failures: list[Failure],
     *,
@@ -2734,6 +2764,12 @@ def check_daily_execution_cli(root: Path) -> list[Failure]:
                 context="`flow resume`",
                 payload=payload,
             )
+            require_maturity_upgrade_path(
+                failures,
+                category="daily-execution-cli",
+                context="`flow resume`",
+                payload=payload.get("maturity_upgrade_path"),
+            )
             steps = payload.get("steps")
             if not isinstance(steps, list):
                 failures.append(Failure("daily-execution-cli", "`flow resume` must include `steps`"))

package/payload/plugin/loom/skills/shared/scripts/loom_flow.py

@@ -3728,6 +3728,50 @@ def governance_profile_upgrade_payload(
     }
 
 
+def maturity_upgrade_path(governance_surface: dict[str, Any], target_root: Path) -> dict[str, Any]:
+    control_plane = governance_surface.get("governance_control_plane")
+    maturity = control_plane.get("maturity") if isinstance(control_plane, dict) else None
+    if not isinstance(maturity, dict):
+        return {
+            "result": "block",
+            "current": "unknown",
+            "next": None,
+            "missing_inputs": ["governance_control_plane.maturity"],
+            "missing_details": [],
+            "fallback_to": "admission",
+            "upgrade_entry": None,
+            "validation_entries": [],
+        }
+    current = maturity.get("current")
+    next_level = maturity.get("next")
+    missing_by_level = maturity.get("missing_by_level")
+    missing_details_by_level = maturity.get("missing_details_by_level")
+    missing_inputs = []
+    missing_details = []
+    if isinstance(next_level, str):
+        if isinstance(missing_by_level, dict) and isinstance(missing_by_level.get(next_level), list):
+            missing_inputs = list(missing_by_level[next_level])
+        if isinstance(missing_details_by_level, dict) and isinstance(missing_details_by_level.get(next_level), list):
+            missing_details = list(missing_details_by_level[next_level])
+    return {
+        "result": "pass" if next_level is None else "block",
+        "current": current,
+        "next": next_level,
+        "missing_inputs": missing_inputs,
+        "missing_details": missing_details,
+        "fallback_to": None if next_level is None else "adoption",
+        "upgrade_entry": (
+            f"python3 tools/loom_flow.py governance-profile upgrade --target {target_root} --to {next_level} --dry-run"
+            if isinstance(next_level, str)
+            else None
+        ),
+        "validation_entries": [
+            f"python3 tools/loom_flow.py governance-profile status --target {target_root}",
+            f"python3 tools/loom_flow.py governance-profile upgrade-plan --target {target_root}",
+        ],
+    }
+
+
 def issue_binding_entry(role: str, number: int | None, payload: dict[str, Any] | None, errors: list[str]) -> dict[str, Any]:
     status = "present" if payload is not None else "missing"
     if errors:
@@ -6349,6 +6393,7 @@ def handle_flow(args: argparse.Namespace) -> int:
 
     review_payload: dict[str, Any] | None = None
     governance_surface = build_governance_surface(target_root)
+    upgrade_path = maturity_upgrade_path(governance_surface, target_root)
     repo_interface = governance_surface.get("repo_interface")
     repo_specific_requirements: dict[str, Any] | None = None
 
@@ -6540,6 +6585,9 @@ def handle_flow(args: argparse.Namespace) -> int:
         for message in governance_surface.get("missing_inputs", []):
             if message not in missing_inputs:
                 missing_inputs.append(message)
+        for message in upgrade_path.get("missing_inputs", []):
+            if message not in missing_inputs:
+                missing_inputs.append(message)
 
     return emit(
         {
@@ -6558,6 +6606,7 @@ def handle_flow(args: argparse.Namespace) -> int:
             "steps": steps,
             "runtime_state": runtime_state,
             **({"governance_surface": governance_surface} if args.operation == "resume" else {}),
+            **({"maturity_upgrade_path": upgrade_path} if args.operation == "resume" else {}),
             **(
                 {
                     "workspace": {

package/payload/plugin/loom/skills/shared/scripts/loom_init.py

@@ -970,6 +970,11 @@ def build_result(target_root: Path, scenario: str, intake: dict[str, object], in
         ),
     }[scenario]
 
+    governance_surface = build_governance_surface(
+        target_root,
+        bootstrap_mode=True,
+        scenario_override=scenario,
+    )
     result = {
         "schema_version": "loom-init-output/v1",
         "generator": {
@@ -1059,15 +1064,55 @@ def build_result(target_root: Path, scenario: str, intake: dict[str, object], in
             ),
         },
         "runtime_state": runtime_state_payload(target_root),
-        "governance_surface": build_governance_surface(
-            target_root,
-            bootstrap_mode=True,
-            scenario_override=scenario,
-        ),
+        "governance_surface": governance_surface,
+        "maturity_upgrade_path": init_maturity_upgrade_path(governance_surface),
     }
     return result
 
 
+def init_maturity_upgrade_path(governance_surface: dict[str, object]) -> dict[str, object]:
+    control_plane = governance_surface.get("governance_control_plane")
+    maturity = control_plane.get("maturity") if isinstance(control_plane, dict) else None
+    if not isinstance(maturity, dict):
+        return {
+            "result": "block",
+            "current": "unknown",
+            "next": None,
+            "missing_inputs": ["governance_control_plane.maturity"],
+            "missing_details": [],
+            "fallback_to": "admission",
+            "upgrade_entry": None,
+            "validation_entries": [],
+        }
+    next_level = maturity.get("next")
+    missing_by_level = maturity.get("missing_by_level")
+    missing_details_by_level = maturity.get("missing_details_by_level")
+    missing_inputs: list[object] = []
+    missing_details: list[object] = []
+    if isinstance(next_level, str):
+        if isinstance(missing_by_level, dict) and isinstance(missing_by_level.get(next_level), list):
+            missing_inputs = list(missing_by_level[next_level])
+        if isinstance(missing_details_by_level, dict) and isinstance(missing_details_by_level.get(next_level), list):
+            missing_details = list(missing_details_by_level[next_level])
+    return {
+        "result": "pass" if next_level is None else "block",
+        "current": maturity.get("current"),
+        "next": next_level,
+        "missing_inputs": missing_inputs,
+        "missing_details": missing_details,
+        "fallback_to": None if next_level is None else "adoption",
+        "upgrade_entry": (
+            f"python3 .loom/bin/loom_flow.py governance-profile upgrade --target . --to {next_level} --dry-run"
+            if isinstance(next_level, str)
+            else None
+        ),
+        "validation_entries": [
+            "python3 .loom/bin/loom_flow.py governance-profile status --target .",
+            "python3 .loom/bin/loom_flow.py governance-profile upgrade-plan --target .",
+        ],
+    }
+
+
 def render_loom_readme(result: dict[str, object]) -> str:
     run = result["run"]
     attach_only = uses_attach_only_path(str(result["recommended_adoption"]["path"]))
@@ -1481,6 +1526,7 @@ def verify_target(target_root: Path, output_path: Path) -> list[str]:
             "initial_artifacts",
             "initial_work_items",
             "runtime_state",
+            "maturity_upgrade_path",
             "validation_and_closing",
         ):
             if key not in result:

package/payload/skills/loom-adopt/.loom-runtime/shared/scripts/loom_check.py

@@ -95,6 +95,7 @@ CORE_DOCS = (
     "docs/evidence/validations/validation-closeout-reconciliation-blocking-gate.md",
     "docs/evidence/validations/validation-adoption-maturity-upgrade-automation.md",
     "docs/evidence/validations/validation-adoption-maturity-required-fields.md",
+    "docs/evidence/validations/validation-skills-consume-maturity-upgrade-path.md",
     "docs/evidence/validations/validation-github-profile-binding-orchestration.md",
     "docs/evidence/validations/validation-github-profile-drift-reconciliation.md",
     "docs/evidence/validations/validation-github-profile-graphql-budget-guard.md",
@@ -1388,6 +1389,35 @@ def require_governance_upgrade_payload(
             failures.append(Failure(category, f"{context} missing-input actions must include recommended_action"))
 
 
+def require_maturity_upgrade_path(
+    failures: list[Failure],
+    *,
+    category: str,
+    context: str,
+    payload: object,
+) -> None:
+    if not isinstance(payload, dict):
+        failures.append(Failure(category, f"{context} must include maturity_upgrade_path"))
+        return
+    if payload.get("result") not in {"pass", "block"}:
+        failures.append(Failure(category, f"{context} result must be pass/block"))
+    if payload.get("current") not in {"unadopted", "light", "standard", "strong", "unknown"}:
+        failures.append(Failure(category, f"{context} current maturity must stay within the stable set"))
+    if payload.get("next") not in {None, "light", "standard", "strong"}:
+        failures.append(Failure(category, f"{context} next maturity must stay within the stable set"))
+    if not isinstance(payload.get("missing_inputs"), list):
+        failures.append(Failure(category, f"{context} missing_inputs must be a list"))
+    if not isinstance(payload.get("missing_details"), list):
+        failures.append(Failure(category, f"{context} missing_details must be a list"))
+    if payload.get("fallback_to") not in {None, "adoption", "admission"}:
+        failures.append(Failure(category, f"{context} fallback_to must be stable"))
+    if payload.get("next") is not None and not isinstance(payload.get("upgrade_entry"), str):
+        failures.append(Failure(category, f"{context} upgrade_entry must be present when next maturity exists"))
+    validation_entries = payload.get("validation_entries")
+    if not isinstance(validation_entries, list) or not validation_entries:
+        failures.append(Failure(category, f"{context} validation_entries must be non-empty"))
+
+
 def require_review_record_contract(
     failures: list[Failure],
     *,
@@ -2734,6 +2764,12 @@ def check_daily_execution_cli(root: Path) -> list[Failure]:
                 context="`flow resume`",
                 payload=payload,
             )
+            require_maturity_upgrade_path(
+                failures,
+                category="daily-execution-cli",
+                context="`flow resume`",
+                payload=payload.get("maturity_upgrade_path"),
+            )
             steps = payload.get("steps")
             if not isinstance(steps, list):
                 failures.append(Failure("daily-execution-cli", "`flow resume` must include `steps`"))

package/payload/skills/loom-adopt/.loom-runtime/shared/scripts/loom_flow.py

@@ -3728,6 +3728,50 @@ def governance_profile_upgrade_payload(
     }
 
 
+def maturity_upgrade_path(governance_surface: dict[str, Any], target_root: Path) -> dict[str, Any]:
+    control_plane = governance_surface.get("governance_control_plane")
+    maturity = control_plane.get("maturity") if isinstance(control_plane, dict) else None
+    if not isinstance(maturity, dict):
+        return {
+            "result": "block",
+            "current": "unknown",
+            "next": None,
+            "missing_inputs": ["governance_control_plane.maturity"],
+            "missing_details": [],
+            "fallback_to": "admission",
+            "upgrade_entry": None,
+            "validation_entries": [],
+        }
+    current = maturity.get("current")
+    next_level = maturity.get("next")
+    missing_by_level = maturity.get("missing_by_level")
+    missing_details_by_level = maturity.get("missing_details_by_level")
+    missing_inputs = []
+    missing_details = []
+    if isinstance(next_level, str):
+        if isinstance(missing_by_level, dict) and isinstance(missing_by_level.get(next_level), list):
+            missing_inputs = list(missing_by_level[next_level])
+        if isinstance(missing_details_by_level, dict) and isinstance(missing_details_by_level.get(next_level), list):
+            missing_details = list(missing_details_by_level[next_level])
+    return {
+        "result": "pass" if next_level is None else "block",
+        "current": current,
+        "next": next_level,
+        "missing_inputs": missing_inputs,
+        "missing_details": missing_details,
+        "fallback_to": None if next_level is None else "adoption",
+        "upgrade_entry": (
+            f"python3 tools/loom_flow.py governance-profile upgrade --target {target_root} --to {next_level} --dry-run"
+            if isinstance(next_level, str)
+            else None
+        ),
+        "validation_entries": [
+            f"python3 tools/loom_flow.py governance-profile status --target {target_root}",
+            f"python3 tools/loom_flow.py governance-profile upgrade-plan --target {target_root}",
+        ],
+    }
+
+
 def issue_binding_entry(role: str, number: int | None, payload: dict[str, Any] | None, errors: list[str]) -> dict[str, Any]:
     status = "present" if payload is not None else "missing"
     if errors:
@@ -6349,6 +6393,7 @@ def handle_flow(args: argparse.Namespace) -> int:
 
     review_payload: dict[str, Any] | None = None
     governance_surface = build_governance_surface(target_root)
+    upgrade_path = maturity_upgrade_path(governance_surface, target_root)
     repo_interface = governance_surface.get("repo_interface")
     repo_specific_requirements: dict[str, Any] | None = None
 
@@ -6540,6 +6585,9 @@ def handle_flow(args: argparse.Namespace) -> int:
         for message in governance_surface.get("missing_inputs", []):
             if message not in missing_inputs:
                 missing_inputs.append(message)
+        for message in upgrade_path.get("missing_inputs", []):
+            if message not in missing_inputs:
+                missing_inputs.append(message)
 
     return emit(
         {
@@ -6558,6 +6606,7 @@ def handle_flow(args: argparse.Namespace) -> int:
             "steps": steps,
             "runtime_state": runtime_state,
             **({"governance_surface": governance_surface} if args.operation == "resume" else {}),
+            **({"maturity_upgrade_path": upgrade_path} if args.operation == "resume" else {}),
             **(
                 {
                     "workspace": {