Register Engine telemetry runtime deploy successor

2026-07-23 22:31:01 +03:00
parent 25b12d77e4
commit 59f9fc2b26
3 changed files with 1024 additions and 0 deletions
@@ -612,6 +612,45 @@ ENGINE_MCP_EXECUTION_PLAN_MATERIALIZATION_NEW_PATHS = (
    "nodedc-source/server/assets/execution-plans/v1/catalog.json",
    ENGINE_MCP_EXECUTION_PLAN_MATERIALIZATION_DESCRIPTOR_REL,
 )
+ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_DESCRIPTOR_REL = (
+    "nodedc-source/server/deployTransitions/executionPlanTelemetryRuntimeV2.json"
+)
+ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_ARTIFACT_ENTRIES = (
+    "nodedc-source/server/l2ExecutionPlan/compiler.js",
+    "nodedc-source/server/assets/execution-plans/v1/catalog.json",
+    ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_DESCRIPTOR_REL,
+)
+ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_PREDECESSOR_SHA256 = {
+    "nodedc-source/server/l2ExecutionPlan/compiler.js":
+        "beb3f664073f9a372432643936a04d0cb0028cd695f759c68bd053e9cd892fe4",
+    "nodedc-source/server/assets/execution-plans/v1/catalog.json":
+        "a153e040e0a592bad4375b98d9a1d83d148923aa0f0fd47d225b92eda281c4e9",
+}
+ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_FOUNDATION_SHA256 = {
+    "nodedc-source/server/routes/n8n.js":
+        "391fc81228fdacd6efc6c0868991a3485f71869708e49ac15819db6ccce1bfce",
+    "nodedc-source/server/routes/engineAgentGateway.js":
+        "9020cf49a3558c0497fed4ecfd81367cbc11b5b249881804c29fe437900c71f8",
+    "nodedc-source/server/l2ExecutionPlan/catalog.js":
+        "c35b4c7ad9319aabbf1366a11ff52a6e99d961893bafdfcb4e84fc5f24fc04be",
+    "nodedc-source/server/l2ExecutionPlan/materializer.js":
+        "ee3bcfd06b3a5fa46800df974a2dedfdd55eeaf662329f837486c011a9bd713e",
+    ENGINE_MCP_EXECUTION_PLAN_MATERIALIZATION_DESCRIPTOR_REL:
+        "52c0152cff49c251be5581a9209d2e63ba710c16e815bdd6ece24f7c9dd7e480",
+    ENGINE_NODE_INTELLIGENCE_DESCRIPTOR_REL:
+        "03b2ba120c3929e9cf99940ddc927082de376ceff762895a84103144202aef42",
+}
+ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_TARGET_SHA256 = {
+    "nodedc-source/server/l2ExecutionPlan/compiler.js":
+        "6b783ad15c26dc7de0645082c8a426002d943138c70bf31a240247b16a33b6a0",
+    "nodedc-source/server/assets/execution-plans/v1/catalog.json":
+        "5bdfc92284a7c836ff326e3a89b559110e376b32efd34b5f23f2bec272745781",
+    ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_DESCRIPTOR_REL:
+        "68b275efb6303284336d8b637c966c24d891a4bd0b3fec4fb83247359929ef79",
+}
+ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_NEW_PATHS = (
+    ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_DESCRIPTOR_REL,
+)
 ENGINE_AGENT_FULL_GRANT_MIGRATION_ARTIFACT_ENTRIES = (
    ENGINE_AGENT_FULL_GRANT_MIGRATION_STORE_REL,
 )
@@ -4506,6 +4545,44 @@ process.stdout.write('engine-mcp-execution-plan-materialization:0.9.0:provider-p
    }


+def accept_engine_mcp_execution_plan_telemetry_runtime():
+    root = component_root("engine")
+    validate_engine_mcp_execution_plan_telemetry_runtime_slice(
+        root,
+        ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_ARTIFACT_ENTRIES,
+    )
+    live = run_engine_backend_probe(
+        (
+            "node",
+            "--input-type=module",
+            "-e",
+            """
+const fs=await import('node:fs/promises');
+const catalogModule=await import('file:///app/server/l2ExecutionPlan/catalog.js');
+const catalog=await catalogModule.loadExecutionPlanCatalog();
+const compiler=await fs.readFile('/app/server/l2ExecutionPlan/compiler.js','utf8');
+const versions=catalog.runtime?.compilerVersions||[];
+if(versions.join(',')!=='1.1.0,1.2.0'||!compiler.includes("if (compilerVersion === '1.1.0')")||!compiler.includes("if (compilerVersion !== '1.2.0')")||!compiler.includes('"msgParam", "msg_param"')||!compiler.includes('descriptor.telemetryProjection')||!compiler.includes('"message-param"')||!compiler.includes('convertedSensorValue')||!compiler.includes('visibleSensorDefinition')||/gelios|robot2b/i.test(compiler))process.exit(2);
+process.stdout.write('engine-mcp-execution-plan-telemetry-runtime:0.9.0:compiler-1.2.0:declared-projected:v2');
+""".strip(),
+        ),
+        "Engine MCP execution plan telemetry runtime",
+        container_id=engine_backend_container_id(),
+    )
+    expected = (
+        "engine-mcp-execution-plan-telemetry-runtime:"
+        "0.9.0:compiler-1.2.0:declared-projected:v2"
+    )
+    if live != expected:
+        die("Engine MCP execution plan telemetry runtime live acceptance mismatch")
+    return {
+        "target_sha256": dict(
+            ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_TARGET_SHA256
+        ),
+        "live": live,
+    }
+
+
 def validate_no_lifecycle_scripts(payload_dir, label):
    forbidden = ("preinstall", "install", "postinstall", "prepare", "prepack", "postpack")
    for package_path in payload_dir.rglob("package.json"):
@@ -5391,6 +5468,107 @@ def validate_engine_mcp_execution_plan_materialization_slice(payload_dir, entrie
        )


+def validate_engine_mcp_execution_plan_telemetry_runtime_slice(
+    payload_dir,
+    entries,
+):
+    if (
+        tuple(entries)
+        != ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_ARTIFACT_ENTRIES
+    ):
+        die(
+            "Engine MCP execution plan telemetry runtime files.txt exact "
+            "set/order mismatch"
+        )
+    for rel, expected_sha256 in (
+        ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_TARGET_SHA256.items()
+    ):
+        path = payload_dir / rel
+        try:
+            path_stat = path.lstat()
+        except FileNotFoundError:
+            die(
+                "Engine MCP execution plan telemetry runtime target is "
+                f"missing: {rel}"
+            )
+        if (
+            stat.S_ISLNK(path_stat.st_mode)
+            or not stat.S_ISREG(path_stat.st_mode)
+            or sha256_file(path) != expected_sha256
+        ):
+            die(
+                "Engine MCP execution plan telemetry runtime target sha256 "
+                f"mismatch: {rel}"
+            )
+    descriptor = read_strict_json(
+        payload_dir
+        / ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_DESCRIPTOR_REL,
+        "Engine MCP execution plan telemetry runtime descriptor",
+        max_bytes=32 * 1024,
+    )
+    expected_descriptor = {
+        "schemaVersion": "nodedc.engine.deploy-transition/v1",
+        "id": "engine-mcp-l2-execution-plan-telemetry-runtime-v2",
+        "component": "engine",
+        "scope": "external-mcp-l2-authoring-runtime",
+        "mcpVersion": "0.9.0",
+        "sourcePaths": [
+            "nodedc-source/server/l2ExecutionPlan/compiler.js",
+            "nodedc-source/server/assets/execution-plans/v1/catalog.json",
+        ],
+        "compilerTransition": {
+            "predecessor": "1.1.0",
+            "supported": ["1.1.0", "1.2.0"],
+            "legacyRuntimePreserved": True,
+        },
+        "telemetryInputBoundary": {
+            "sources": [
+                "declared-sensor-values",
+                "declared-message-parameters",
+            ],
+            "authorization": [
+                "trusted-telemetry-projection",
+                "visible-sensor-definition",
+            ],
+            "unprojectedParameters": "discarded",
+            "rawProviderPayloadAtPublish": "forbidden",
+            "conversion": "bounded-declared-conversion-table",
+        },
+        "providerLogicAuthority": "trusted-provider-package",
+        "engineProviderHardcode": False,
+        "embeddedCodexChanged": False,
+    }
+    if descriptor != expected_descriptor:
+        die(
+            "Engine MCP execution plan telemetry runtime descriptor "
+            "contract mismatch"
+        )
+    compiler_source = (
+        payload_dir / "nodedc-source/server/l2ExecutionPlan/compiler.js"
+    ).read_text(encoding="utf-8")
+    catalog = read_strict_json(
+        payload_dir
+        / "nodedc-source/server/assets/execution-plans/v1/catalog.json",
+        "Engine execution plan catalog",
+        max_bytes=512 * 1024,
+    )
+    required_markers = (
+        "if (compilerVersion === '1.1.0')",
+        "if (compilerVersion !== '1.2.0')",
+        '"msgParam", "msg_param"',
+        "descriptor.telemetryProjection",
+        '"message-param"',
+        "convertedSensorValue",
+        "visibleSensorDefinition",
+    )
+    if any(marker not in compiler_source for marker in required_markers):
+        die("Engine MCP execution plan telemetry runtime contract mismatch")
+    if catalog.get("runtime", {}).get("compilerVersions") != ["1.1.0", "1.2.0"]:
+        die("Engine MCP execution plan telemetry runtime catalog mismatch")
+    if re.search(r"gelios|robot2b", compiler_source, re.IGNORECASE):
+        die("Engine MCP execution plan telemetry runtime contains provider hardcode")
+
+
 def validate_engine_agent_full_grant_migration_slice(payload_dir, entries):
    if tuple(entries) != ENGINE_AGENT_FULL_GRANT_MIGRATION_ARTIFACT_ENTRIES:
        die("Engine agent full grant migration files.txt exact set/order mismatch")
@@ -5859,6 +6037,14 @@ def load_artifact(artifact, work_dir):
                payload_dir,
                entries,
            )
+        if is_engine_mcp_execution_plan_telemetry_runtime_slice(
+            manifest["component"],
+            entries,
+        ):
+            validate_engine_mcp_execution_plan_telemetry_runtime_slice(
+                payload_dir,
+                entries,
+            )
        if is_engine_provider_security_catalog_slice(manifest["component"], entries):
            validate_engine_provider_security_catalog_payload(payload_dir, entries)
        if touches_engine_credential_sink(manifest["component"], entries):
@@ -5884,6 +6070,10 @@ def load_artifact(artifact, work_dir):
                manifest["component"],
                entries,
            )
+            and not is_engine_mcp_execution_plan_telemetry_runtime_slice(
+                manifest["component"],
+                entries,
+            )
            and (
                touches_engine_data_product_publish_grant(entries)
                or ENGINE_DATA_PRODUCT_PUBLISH_GRANT_OVERRIDE_REL in entries
@@ -6087,6 +6277,15 @@ def is_engine_mcp_execution_plan_materialization_slice(component, entries):
    )


+def is_engine_mcp_execution_plan_telemetry_runtime_slice(component, entries):
+    return (
+        component == "engine"
+        and entries is not None
+        and tuple(entries)
+        == ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_ARTIFACT_ENTRIES
+    )
+
+
 def is_engine_agent_full_grant_migration_slice(component, entries):
    return (
        component == "engine"
@@ -6689,6 +6888,82 @@ def preflight_engine_mcp_execution_plan_materialization_predecessor():
    }


+def preflight_engine_mcp_execution_plan_telemetry_runtime_predecessor():
+    root = component_root("engine")
+    actual = {}
+    for rel, expected_sha256 in (
+        ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_PREDECESSOR_SHA256.items()
+    ):
+        path = root / rel
+        try:
+            path_stat = path.lstat()
+        except FileNotFoundError:
+            die(
+                "Engine MCP execution plan telemetry runtime predecessor is "
+                f"missing: {rel}"
+            )
+        if stat.S_ISLNK(path_stat.st_mode) or not stat.S_ISREG(path_stat.st_mode):
+            die(
+                "Engine MCP execution plan telemetry runtime predecessor is "
+                f"unsafe: {rel}"
+            )
+        actual_sha256 = sha256_file(path)
+        if actual_sha256 != expected_sha256:
+            die(
+                "Engine MCP execution plan telemetry runtime predecessor drift "
+                f"detected: path={rel} expected={expected_sha256} "
+                f"actual={actual_sha256}"
+            )
+        actual[rel] = actual_sha256
+    foundation = {}
+    for rel, expected_sha256 in (
+        ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_FOUNDATION_SHA256.items()
+    ):
+        path = root / rel
+        try:
+            path_stat = path.lstat()
+        except FileNotFoundError:
+            die(
+                "Engine MCP execution plan telemetry runtime foundation is "
+                f"missing: {rel}"
+            )
+        if (
+            stat.S_ISLNK(path_stat.st_mode)
+            or not stat.S_ISREG(path_stat.st_mode)
+            or sha256_file(path) != expected_sha256
+        ):
+            die(
+                "Engine MCP execution plan telemetry runtime foundation drift "
+                f"detected: {rel}"
+            )
+        foundation[rel] = expected_sha256
+    for rel in ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_NEW_PATHS:
+        path = root / rel
+        if path.exists() or path.is_symlink():
+            die(
+                "Engine MCP execution plan telemetry runtime new path already "
+                f"exists: {rel}"
+            )
+    backend = preflight_engine_credential_backend_runtime()
+    if backend["mode"] != "verified-derived-retry":
+        die(
+            "Engine MCP execution plan telemetry runtime requires the active "
+            "immutable backend"
+        )
+    return {
+        "mode": "execution-plan-materialization-v1-to-telemetry-runtime-v2",
+        "predecessor_sha256": actual,
+        "foundation_sha256": foundation,
+        "target_sha256": dict(
+            ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_TARGET_SHA256
+        ),
+        "new_paths": tuple(
+            ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_NEW_PATHS
+        ),
+        "backend_mode": backend["mode"],
+    }
+
+
 def preflight_engine_agent_full_grant_migration_predecessor():
    root = component_root("engine")
    store_path = root / ENGINE_AGENT_FULL_GRANT_MIGRATION_STORE_REL
@@ -6745,6 +7020,7 @@ def component_services(component, entries=None):
        or is_engine_mcp_execution_profile_decoder_slice(component, entries)
        or is_engine_mcp_telemetry_catalog_slice(component, entries)
        or is_engine_mcp_execution_plan_materialization_slice(component, entries)
+        or is_engine_mcp_execution_plan_telemetry_runtime_slice(component, entries)
        or is_engine_provider_security_catalog_slice(component, entries)
    ):
        # This slice updates only the existing Engine backend control plane.
@@ -8956,6 +9232,7 @@ def plan_artifact(artifact):
    mcp_execution_profile_decoder_preflight = None
    mcp_telemetry_catalog_preflight = None
    mcp_execution_plan_materialization_preflight = None
+    mcp_execution_plan_telemetry_runtime_preflight = None
    provider_catalog_preflight = None
    with tempfile.TemporaryDirectory(prefix="plan-", dir=TMP_DIR) as tmp:
        manifest, entries, payload_dir = load_artifact(artifact, Path(tmp))
@@ -9028,6 +9305,13 @@ def plan_artifact(artifact):
            mcp_execution_plan_materialization_preflight = (
                preflight_engine_mcp_execution_plan_materialization_predecessor()
            )
+        if is_engine_mcp_execution_plan_telemetry_runtime_slice(
+            manifest["component"],
+            entries,
+        ):
+            mcp_execution_plan_telemetry_runtime_preflight = (
+                preflight_engine_mcp_execution_plan_telemetry_runtime_predecessor()
+            )
        if is_engine_provider_security_catalog_slice(manifest["component"], entries):
            provider_catalog_preflight = preflight_engine_provider_security_catalog_predecessor()

@@ -9076,6 +9360,12 @@ def plan_artifact(artifact):
            entries,
        )
    )
+    touches_mcp_execution_plan_telemetry_runtime = (
+        is_engine_mcp_execution_plan_telemetry_runtime_slice(
+            component,
+            entries,
+        )
+    )
    touches_agent_grant_migration = is_engine_agent_full_grant_migration_slice(
        component,
        entries,
@@ -9094,6 +9384,7 @@ def plan_artifact(artifact):
        or touches_mcp_execution_profile_decoder
        or touches_mcp_telemetry_catalog
        or touches_mcp_execution_plan_materialization
+        or touches_mcp_execution_plan_telemetry_runtime
        or touches_agent_grant_migration
    ):
        credential_backend_preflight = preflight_engine_credential_backend_runtime()
@@ -9152,6 +9443,17 @@ def plan_artifact(artifact):
                "Engine MCP execution plan materialization requires the active "
                "immutable credential backend"
            )
+    if touches_mcp_execution_plan_telemetry_runtime:
+        if mcp_execution_plan_telemetry_runtime_preflight is None:
+            die(
+                "Engine MCP execution plan telemetry runtime preflight is "
+                "missing"
+            )
+        if credential_backend_preflight["mode"] != "verified-derived-retry":
+            die(
+                "Engine MCP execution plan telemetry runtime requires the "
+                "active immutable credential backend"
+            )
    if touches_agent_grant_migration:
        agent_grant_migration_predecessor_sha256 = (
            preflight_engine_agent_full_grant_migration_predecessor()
@@ -9594,6 +9896,78 @@ def plan_artifact(artifact):
        print("credentials=preserved")
        print("mcp_nginx=untouched")
        print("embedded_ai_workspace=untouched")
+    if mcp_execution_plan_telemetry_runtime_preflight:
+        print(
+            "engine_mcp_authoring_runtime_transition="
+            f"{mcp_execution_plan_telemetry_runtime_preflight['mode']}"
+        )
+        print("engine_mcp_version=0.9.0")
+        print("engine_mcp_surface=external-codex")
+        print("engine_mcp_compiler_predecessor=1.1.0")
+        print("engine_mcp_compiler_supported=1.1.0,1.2.0")
+        print("engine_mcp_legacy_runtime_preserved=yes")
+        print("engine_mcp_provider_logic_authority=trusted-provider-package")
+        print(
+            "engine_mcp_telemetry_authority="
+            "trusted-projection+visible-declared-sensor"
+        )
+        print("engine_mcp_unprojected_parameters=discarded")
+        print("engine_mcp_raw_provider_payload_at_publish=forbidden")
+        for foundation_path, foundation_sha256 in (
+            mcp_execution_plan_telemetry_runtime_preflight[
+                "foundation_sha256"
+            ].items()
+        ):
+            print(
+                "engine_mcp_execution_plan_telemetry_runtime_foundation_sha256"
+                f"[{foundation_path}]={foundation_sha256}"
+            )
+        for changed_path in (
+            ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_ARTIFACT_ENTRIES
+        ):
+            print(
+                "engine_mcp_execution_plan_telemetry_runtime_changed_path="
+                f"{changed_path}"
+            )
+            if changed_path in mcp_execution_plan_telemetry_runtime_preflight[
+                "predecessor_sha256"
+            ]:
+                print(
+                    "engine_mcp_execution_plan_telemetry_runtime_predecessor_sha256"
+                    f"[{changed_path}]="
+                    f"{mcp_execution_plan_telemetry_runtime_preflight['predecessor_sha256'][changed_path]}"
+                )
+            elif changed_path in mcp_execution_plan_telemetry_runtime_preflight[
+                "new_paths"
+            ]:
+                print(
+                    "engine_mcp_execution_plan_telemetry_runtime_predecessor_state"
+                    f"[{changed_path}]=absent"
+                )
+            else:
+                die(
+                    "Engine MCP execution plan telemetry runtime plan has no "
+                    f"predecessor state: {changed_path}"
+                )
+            print(
+                "engine_mcp_execution_plan_telemetry_runtime_target_sha256"
+                f"[{changed_path}]="
+                f"{mcp_execution_plan_telemetry_runtime_preflight['target_sha256'][changed_path]}"
+            )
+        print(
+            "backend_current_barrier="
+            f"{mcp_execution_plan_telemetry_runtime_preflight['backend_mode']}"
+        )
+        print("backend_force_recreate=yes")
+        print("backend_pull=never")
+        print("l2_graph=untouched")
+        print("n8n_l1=untouched")
+        print("engine_ui=untouched")
+        print("engine_databases=untouched")
+        print("credentials=preserved")
+        print("node_intelligence_image=preserved")
+        print("mcp_nginx=untouched")
+        print("embedded_ai_workspace=untouched")
    if transition_descriptor:
        print(f"n8n_transition={transition_descriptor['action']}")
        print(f"n8n_version={transition_descriptor['n8nVersion']}")
@@ -10716,6 +11090,10 @@ def component_healthchecks(component, entries=None, services=None):
                component,
                entries,
            )
+            or is_engine_mcp_execution_plan_telemetry_runtime_slice(
+                component,
+                entries,
+            )
            or is_engine_agent_full_grant_migration_slice(component, entries)
            or is_engine_mcp_control_plane_slice(component, entries)
            or is_engine_mcp_ontology_sdk_slice(component, entries)
@@ -11139,6 +11517,12 @@ def run_healthchecks(component, entries=None, services=None):
            entries,
        )
    )
+    touches_mcp_execution_plan_telemetry_runtime = (
+        is_engine_mcp_execution_plan_telemetry_runtime_slice(
+            component,
+            entries,
+        )
+    )
    touches_agent_grant_migration = is_engine_agent_full_grant_migration_slice(
        component,
        entries,
@@ -11158,6 +11542,7 @@ def run_healthchecks(component, entries=None, services=None):
        or touches_mcp_execution_profile_decoder
        or touches_mcp_telemetry_catalog
        or touches_mcp_execution_plan_materialization
+        or touches_mcp_execution_plan_telemetry_runtime
        or touches_agent_grant_migration
        or touches_mcp_control_plane
        or touches_mcp_ontology_sdk
@@ -11181,6 +11566,7 @@ def run_healthchecks(component, entries=None, services=None):
        or touches_mcp_execution_profile_decoder
        or touches_mcp_telemetry_catalog
        or touches_mcp_execution_plan_materialization
+        or touches_mcp_execution_plan_telemetry_runtime
        or touches_agent_grant_migration
        or touches_mcp_control_plane
        or touches_mcp_ontology_sdk
@@ -11368,6 +11754,48 @@ def run_healthchecks(component, entries=None, services=None):
                "Engine MCP execution plan materialization installed state is "
                "neither target nor rollback predecessor"
            )
+    if touches_mcp_execution_plan_telemetry_runtime:
+        root = component_root("engine")
+        target_state = all(
+            (root / rel).is_file()
+            and not (root / rel).is_symlink()
+            and sha256_file(root / rel) == expected
+            for rel, expected in (
+                ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_TARGET_SHA256.items()
+            )
+        ) and all(
+            (root / rel).is_file()
+            and not (root / rel).is_symlink()
+            and sha256_file(root / rel) == expected
+            for rel, expected in (
+                ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_FOUNDATION_SHA256.items()
+            )
+        )
+        predecessor_state = all(
+            (root / rel).is_file()
+            and not (root / rel).is_symlink()
+            and sha256_file(root / rel) == expected
+            for rel, expected in (
+                ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_PREDECESSOR_SHA256.items()
+            )
+        ) and all(
+            (root / rel).is_file()
+            and not (root / rel).is_symlink()
+            and sha256_file(root / rel) == expected
+            for rel, expected in (
+                ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_FOUNDATION_SHA256.items()
+            )
+        ) and all(
+            not (root / rel).exists() and not (root / rel).is_symlink()
+            for rel in ENGINE_MCP_EXECUTION_PLAN_TELEMETRY_RUNTIME_NEW_PATHS
+        )
+        if target_state:
+            accept_engine_mcp_execution_plan_telemetry_runtime()
+        elif not predecessor_state:
+            die(
+                "Engine MCP execution plan telemetry runtime installed state "
+                "is neither target nor rollback predecessor"
+            )
    container_name = COMPONENTS[component].get("health_container")
    if container_name:
        healthcheck_container(container_name)
@@ -11501,6 +11929,22 @@ def apply_artifact(artifact):
                            "Engine MCP execution plan materialization requires "
                            "the active immutable credential backend"
                        )
+                if is_engine_mcp_execution_plan_telemetry_runtime_slice(
+                    component,
+                    entries,
+                ):
+                    preflight_engine_mcp_execution_plan_telemetry_runtime_predecessor()
+                    execution_plan_telemetry_runtime_backend_preflight = (
+                        preflight_engine_credential_backend_runtime()
+                    )
+                    if (
+                        execution_plan_telemetry_runtime_backend_preflight["mode"]
+                        != "verified-derived-retry"
+                    ):
+                        die(
+                            "Engine MCP execution plan telemetry runtime "
+                            "requires the active immutable credential backend"
+                        )
                if is_engine_agent_full_grant_migration_slice(component, entries):
                    preflight_engine_agent_full_grant_migration_predecessor()
                    migration_backend_preflight = preflight_engine_credential_backend_runtime()
@@ -11762,6 +12206,10 @@ def apply_artifact(artifact):
                            component,
                            entries,
                        )
+                        or is_engine_mcp_execution_plan_telemetry_runtime_slice(
+                            component,
+                            entries,
+                        )
                        or is_engine_agent_full_grant_migration_slice(component, entries)
                        or is_engine_mcp_control_plane_slice(component, entries)
                        or is_engine_mcp_ontology_sdk_slice(component, entries)