@tomflow/proflow-execution-runtime 0.1.4 → 0.1.6

package/CONFIGURATION.md

@@ -0,0 +1,31 @@
+# execution-runtime configuration
+
+Canonical public config: `.proflow/config/execution-runtime.json`
+
+This file is Workspace-owned data. `platform uninstall` does not delete it. Values are JSON strings. Raw secrets must not be stored here; `secretRef` fields contain opaque references only.
+
+## Fields
+
+| Key | Type | Required | Sensitive | Source | Meaning |
+|---|---|---:|---:|---|---|
+| `databasePath` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Execution SQLite database |
+| `projectRoot` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Canonical project boundary consumed by the local executor |
+| `artifactRoot` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Execution-owned Artifact/Evidence filesystem root |
+| `browserExecutorConfigPath` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Absolute configuration path for the formal Browser Reality Bridge composition |
+| `transportCredentialFile` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the Execution Runtime transport credential |
+| `identity.endpoint` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback platform-host execution identity endpoint |
+| `identity.tokenFile` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the Execution-to-platform-host identity transport credential |
+| `modelDecision.endpoint` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback Model Runtime endpoint used by execution.command-risk.v1 |
+| `modelDecision.credentialFile` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the Execution-to-Model transport credential |
+
+## Materialize
+
+Create or update the canonical JSON object at:
+
+`.proflow/config/execution-runtime.json`
+
+Use only declared keys and string values. Do not create a second Platform configuration database.
+
+## Base completion check
+
+Run `platform modules`. This Module should no longer report required keys in `missingConfig`. `platform start` performs the authoritative Module-owned validation before starting anything.

package/dist/deployment/adapter.d.ts

@@ -12,14 +12,14 @@ type ProcessService = {
         readiness: "READY" | "NOT_READY";
     };
 };
-export declare function createBehaviorAdapter(service?: ProcessService): {
+export declare function createBehaviorAdapter(service?: ProcessService, config?: Record<string, string>, configValid?: boolean): {
     describe: () => {
         result: {
             readonly contract: "deployment.result.v1";
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     };
@@ -29,53 +29,22 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     };
     status: () => {
         result: {
-            readonly contract: "deployment.result.v1";
-            readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
-            readonly ok: false;
-            readonly status: "ACTION_REQUIRED";
-            readonly actionRequired: {
-                readonly action: "bind-runtime";
-                readonly description: "Bind a configured Execution Runtime service";
-            };
-        } | {
             contract: "deployment.result.v1";
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
-                readiness: "READY" | "NOT_READY";
-            } | undefined;
-            checks: {
-                id: string;
-                status: "FAIL" | "PASS";
-                message: string;
-            }[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
-            ok: false;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+                configStatus: "INCOMPLETE" | "INVALID" | "READY";
+                missingConfig?: string[] | undefined;
+                runtimeStatus: "FAILED" | "RUNNING" | "STOPPED" | "UNKNOWN";
             };
-            data: {
-                readiness: "READY" | "NOT_READY";
-            } | undefined;
-            checks: {
-                id: string;
-                status: "FAIL" | "PASS";
-                message: string;
-            }[];
         };
         observedEffects: never[];
     };
@@ -85,7 +54,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             checks: {
                 id: string;
                 status: "FAIL" | "PASS";
@@ -94,7 +63,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -109,7 +78,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -130,7 +99,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     };
@@ -138,7 +107,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -150,7 +119,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 host: string;
                 port: number;
@@ -164,11 +133,11 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         } | {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -184,7 +153,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: "Runs the single backend Execution Runtime service"[];
     }>;
@@ -192,7 +161,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -204,7 +173,7 @@ export declare function createBehaviorAdapter(service?: ProcessService): {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 host: string;
                 port: number;
@@ -220,7 +189,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     };
@@ -230,53 +199,22 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     };
     status: () => {
         result: {
-            readonly contract: "deployment.result.v1";
-            readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
-            readonly ok: false;
-            readonly status: "ACTION_REQUIRED";
-            readonly actionRequired: {
-                readonly action: "bind-runtime";
-                readonly description: "Bind a configured Execution Runtime service";
-            };
-        } | {
             contract: "deployment.result.v1";
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
-                readiness: "READY" | "NOT_READY";
-            } | undefined;
-            checks: {
-                id: string;
-                status: "FAIL" | "PASS";
-                message: string;
-            }[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
-            ok: false;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+                configStatus: "INCOMPLETE" | "INVALID" | "READY";
+                missingConfig?: string[] | undefined;
+                runtimeStatus: "FAILED" | "RUNNING" | "STOPPED" | "UNKNOWN";
             };
-            data: {
-                readiness: "READY" | "NOT_READY";
-            } | undefined;
-            checks: {
-                id: string;
-                status: "FAIL" | "PASS";
-                message: string;
-            }[];
         };
         observedEffects: never[];
     };
@@ -286,7 +224,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             checks: {
                 id: string;
                 status: "FAIL" | "PASS";
@@ -295,7 +233,7 @@ export declare const behaviorAdapter: {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -310,7 +248,7 @@ export declare const behaviorAdapter: {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -331,7 +269,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     };
@@ -339,7 +277,7 @@ export declare const behaviorAdapter: {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -351,7 +289,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 host: string;
                 port: number;
@@ -365,11 +303,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         } | {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -385,7 +323,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: "Runs the single backend Execution Runtime service"[];
     }>;
@@ -393,7 +331,7 @@ export declare const behaviorAdapter: {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "execution-runtime";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -405,7 +343,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-runtime";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 host: string;
                 port: number;
@@ -414,25 +352,11 @@ export declare const behaviorAdapter: {
         observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
     }>;
 };
-export declare function createServiceProcessBinding(input: {
-    moduleRef: string;
-    config: Record<string, string>;
-    workspaceRoot: string;
-    configByModuleRef: ReadonlyMap<string, Record<string, string>>;
-}): Promise<{
-    serviceProcess: {
-        contract: "deployment.service-process.v1";
-        bin: "proflow-execution-runtime";
-        startCommand: "start";
-        config: Record<string, unknown>;
-    };
-    behaviorAdapter: Record<string, unknown>;
-} | undefined>;
 export declare function createProductionBinding(input: {
     moduleRef: string;
     config: Record<string, string>;
     configByModuleRef: ReadonlyMap<string, Record<string, string>>;
 }): Promise<{
     behaviorAdapter: Record<string, unknown>;
-} | undefined>;
+}>;
 export {};

package/dist/deployment/adapter.js

@@ -1,4 +1,5 @@
 import { createServer } from "node:net";
+import { observeDeclaredModuleStatus } from "@tomflow/proflow-module-contract";
 import { descriptor } from "./descriptor.js";
 const base = {
     contract: "deployment.result.v1",
@@ -87,37 +88,16 @@ async function listenerPreflight(listener) {
             observedEffects: [],
         };
 }
-export function createBehaviorAdapter(service) {
+export function createBehaviorAdapter(service, config, configValid = true) {
     return {
         describe: () => ({ result: base, observedEffects: [] }),
         preflight: () => ({ result: base, observedEffects: [] }),
         status: () => {
             const status = service?.status();
             const ready = status?.readiness === "READY";
+            const data = observeDeclaredModuleStatus(descriptor, config, ready ? "RUNNING" : service ? "FAILED" : "UNKNOWN", configValid);
             return {
-                result: service
-                    ? {
-                        ...(ready
-                            ? base
-                            : {
-                                ...base,
-                                ok: false,
-                                status: "ACTION_REQUIRED",
-                                actionRequired: {
-                                    action: "repair-execution-runtime",
-                                    description: "Execution Runtime is not READY",
-                                },
-                            }),
-                        data: status,
-                        checks: [
-                            {
-                                id: "execution-runtime-readiness",
-                                status: ready ? "PASS" : "FAIL",
-                                message: `Execution Runtime readiness is ${status?.readiness ?? "NOT_READY"}`,
-                            },
-                        ],
-                    }
-                    : unbound,
+                result: { ...base, data },
                 observedEffects: [],
             };
         },
@@ -193,103 +173,10 @@ export function createBehaviorAdapter(service) {
     };
 }
 export const behaviorAdapter = createBehaviorAdapter();
-export async function createServiceProcessBinding(input) {
-    const required = [
-        "databasePath",
-        "projectRoot",
-        "artifactRoot",
-        "browserExecutorConfigPath",
-        "transportCredentialFile",
-        "identity.endpoint",
-        "identity.tokenFile",
-        "modelDecision.endpoint",
-        "modelDecision.credentialFile",
-    ];
-    if (!required.every((key) => input.config[key]))
-        return undefined;
-    const platformHost = input.configByModuleRef.get("platform-host");
-    const advertised = platformHost?.executionBaseUrl;
-    if (!advertised)
-        return undefined;
-    const listener = new URL(advertised);
-    if (listener.protocol !== "http:" || listener.pathname !== "/")
-        return undefined;
-    const port = listener.port === "" ? 80 : Number(listener.port);
-    if (!Number.isInteger(port) || port <= 0 || port > 65_535)
-        return undefined;
-    const { parseExecutionRuntimeProcessConfig } = await import("../src/service.js");
-    const processConfig = parseExecutionRuntimeProcessConfig({
-        host: listener.hostname,
-        port,
-        databasePath: input.config.databasePath,
-        projectRoot: input.config.projectRoot,
-        artifactRoot: input.config.artifactRoot,
-        browserExecutorConfigPath: input.config.browserExecutorConfigPath,
-        transportCredentialFile: input.config.transportCredentialFile,
-        identity: {
-            endpoint: input.config["identity.endpoint"],
-            tokenFile: input.config["identity.tokenFile"],
-        },
-        modelDecision: {
-            endpoint: input.config["modelDecision.endpoint"],
-            credentialFile: input.config["modelDecision.credentialFile"],
-        },
-    });
-    const probeAdapter = {
-        describe: behaviorAdapter.describe,
-        preflight: () => listenerPreflight(listener),
-        verify: async () => {
-            let ready = false;
-            try {
-                ready = (await fetch(new URL("/ready", listener))).ok;
-            }
-            catch {
-                ready = false;
-            }
-            return {
-                result: ready
-                    ? {
-                        ...base,
-                        checks: [
-                            {
-                                id: "execution-runtime-critical-proofs",
-                                status: "PASS",
-                                message: "Managed Execution Runtime /ready probe passed",
-                            },
-                        ],
-                    }
-                    : {
-                        ...base,
-                        ok: false,
-                        status: "ACTION_REQUIRED",
-                        actionRequired: {
-                            action: "repair-execution-runtime",
-                            description: "Managed Execution Runtime /ready probe failed",
-                        },
-                        checks: [
-                            {
-                                id: "execution-runtime-critical-proofs",
-                                status: "FAIL",
-                                message: "Managed Execution Runtime /ready probe failed",
-                            },
-                        ],
-                    },
-                observedEffects: [],
-            };
-        },
-        doctor: behaviorAdapter.doctor,
-    };
-    return {
-        serviceProcess: {
-            contract: "deployment.service-process.v1",
-            bin: "proflow-execution-runtime",
-            startCommand: "start",
-            config: processConfig,
-        },
-        behaviorAdapter: probeAdapter,
-    };
-}
 export async function createProductionBinding(input) {
+    const unboundBinding = (configValid = true) => ({
+        behaviorAdapter: createBehaviorAdapter(undefined, input.config, configValid),
+    });
     const required = [
         "databasePath",
         "projectRoot",
@@ -302,43 +189,65 @@ export async function createProductionBinding(input) {
         "modelDecision.credentialFile",
     ];
     if (!required.every((key) => input.config[key]))
-        return undefined;
+        return unboundBinding();
+    for (const key of ["identity.endpoint", "modelDecision.endpoint"]) {
+        try {
+            const endpoint = new URL(input.config[key] ?? "");
+            if (endpoint.protocol !== "http:")
+                return unboundBinding(false);
+        }
+        catch {
+            return unboundBinding(false);
+        }
+    }
     const platformHost = input.configByModuleRef.get("platform-host");
     const advertised = platformHost?.executionBaseUrl;
     if (!advertised)
-        return undefined;
-    const listener = new URL(advertised);
+        return unboundBinding();
+    let listener;
+    try {
+        listener = new URL(advertised);
+    }
+    catch {
+        return unboundBinding();
+    }
     if (listener.protocol !== "http:" || listener.pathname !== "/")
-        return undefined;
+        return unboundBinding();
     const port = listener.port === "" ? 80 : Number(listener.port);
     if (!Number.isInteger(port) || port <= 0 || port > 65_535)
-        return undefined;
+        return unboundBinding();
     const [{ createFormalExecutionRuntimeLifecycle }, { parseExecutionRuntimeProcessConfig },] = await Promise.all([
         import("../src/formal-process.js"),
         import("../src/service.js"),
     ]);
-    const service = createFormalExecutionRuntimeLifecycle({
-        config: parseExecutionRuntimeProcessConfig({
-            host: listener.hostname,
-            port,
-            databasePath: input.config.databasePath,
-            projectRoot: input.config.projectRoot,
-            artifactRoot: input.config.artifactRoot,
-            browserExecutorConfigPath: input.config.browserExecutorConfigPath,
-            transportCredentialFile: input.config.transportCredentialFile,
-            identity: {
-                endpoint: input.config["identity.endpoint"],
-                tokenFile: input.config["identity.tokenFile"],
-            },
-            modelDecision: {
-                endpoint: input.config["modelDecision.endpoint"],
-                credentialFile: input.config["modelDecision.credentialFile"],
-            },
-        }),
-    });
+    let service;
+    try {
+        service = createFormalExecutionRuntimeLifecycle({
+            config: parseExecutionRuntimeProcessConfig({
+                host: listener.hostname,
+                port,
+                databasePath: input.config.databasePath,
+                projectRoot: input.config.projectRoot,
+                artifactRoot: input.config.artifactRoot,
+                browserExecutorConfigPath: input.config.browserExecutorConfigPath,
+                transportCredentialFile: input.config.transportCredentialFile,
+                identity: {
+                    endpoint: input.config["identity.endpoint"],
+                    tokenFile: input.config["identity.tokenFile"],
+                },
+                modelDecision: {
+                    endpoint: input.config["modelDecision.endpoint"],
+                    credentialFile: input.config["modelDecision.credentialFile"],
+                },
+            }),
+        });
+    }
+    catch {
+        return unboundBinding(false);
+    }
     return {
         behaviorAdapter: {
-            ...createBehaviorAdapter(service),
+            ...createBehaviorAdapter(service, input.config),
             preflight: () => listenerPreflight(listener),
         },
     };

package/dist/deployment/descriptor.d.ts

@@ -3,11 +3,10 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "execution-runtime";
     readonly packageName: "@tomflow/proflow-execution-runtime";
-    readonly moduleVersion: "0.1.4";
+    readonly moduleVersion: "0.1.6";
     readonly kind: "service";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
-    readonly installClass: "core";
     readonly identity: {
         readonly domain: "execution";
         readonly summary: "Durable, policy-controlled Execution Core orchestration over SQLite and controlled executor ports.";
@@ -101,5 +100,9 @@ export declare const descriptor: {
         readonly id: "overview";
         readonly path: "./README.md";
         readonly description: "Execution Runtime package overview";
+    }, {
+        readonly id: "configuration";
+        readonly path: "./CONFIGURATION.md";
+        readonly description: "Module configuration fields, sources and materialization instructions";
     }];
 };

package/dist/deployment/descriptor.js

@@ -3,22 +3,37 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "execution-runtime",
     packageName: "@tomflow/proflow-execution-runtime",
-    moduleVersion: "0.1.4",
+    moduleVersion: "0.1.6",
     kind: "service",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
-    installClass: "core",
     identity: {
         domain: "execution",
         summary: "Durable, policy-controlled Execution Core orchestration over SQLite and controlled executor ports.",
     },
-    provides: [{ contractRef: "execution", version: "1.0.0" }],
+    provides: [
+        {
+            contractRef: "execution",
+            version: "1.0.0",
+        },
+    ],
     requires: [
-        { contractRef: "execution-local", versionRange: ">=1.0.0 <2.0.0" },
+        {
+            contractRef: "execution-local",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
     ],
     requirements: [
-        { kind: "runtime", runtime: "node", versionRange: ">=24.19.0" },
-        { kind: "filesystem", path: ".proflow", access: "read-write" },
+        {
+            kind: "runtime",
+            runtime: "node",
+            versionRange: ">=24.19.0",
+        },
+        {
+            kind: "filesystem",
+            path: ".proflow",
+            access: "read-write",
+        },
     ],
     configSlots: [
         {
@@ -119,5 +134,10 @@ export const descriptor = {
             path: "./README.md",
             description: "Execution Runtime package overview",
         },
+        {
+            id: "configuration",
+            path: "./CONFIGURATION.md",
+            description: "Module configuration fields, sources and materialization instructions",
+        },
     ],
 };

package/dist/src/cli.js

@@ -1,35 +1,12 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
 import { createFormalExecutionRuntimeLifecycle } from "./formal-process.js";
 import { loadExecutionRuntimeProcessConfig } from "./service.js";
-function installSelf() {
-    const executable = process.platform === "win32" ? "platform.cmd" : "platform";
-    const result = spawnSync(executable, [
-        "install",
-        "@tomflow/proflow-execution-runtime",
-        "--workspace",
-        process.cwd(),
-    ], { cwd: process.cwd(), env: process.env, stdio: "inherit" });
-    if (result.error) {
-        if (result.error.code === "ENOENT") {
-            process.stderr.write("GLOBAL_PLATFORM_CLI_REQUIRED: install @tomflow/proflow-platform-cli globally before package-owned install\n");
-            process.exit(127);
-        }
-        throw result.error;
-    }
-    process.exit(result.status ?? 1);
-}
 async function main() {
     const [command, configPath] = process.argv.slice(2);
     if (command === "--help" || command === "-h") {
-        process.stdout.write("Usage: proflow-execution-runtime install | start /absolute/config.json\\n");
+        process.stdout.write("Usage: proflow-execution-runtime start /absolute/config.json\\n");
         process.exit(0);
     }
-    if (command === "install") {
-        if (configPath)
-            throw new Error("Usage: proflow-execution-runtime install");
-        installSelf();
-    }
     if (command !== "start" || !configPath)
         throw new Error("Usage: proflow-execution-runtime start /absolute/config.json");
     const config = await loadExecutionRuntimeProcessConfig(configPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-runtime",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -19,16 +19,18 @@
     "dist",
     "proflow.module.json",
     "conformance.json",
-    "README.md"
+    "README.md",
+    "CONFIGURATION.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-browser-extension": "^0.1.3",
-    "@tomflow/proflow-execution-contracts": "^0.1.2",
-    "@tomflow/proflow-execution-local": "^0.1.3",
-    "@tomflow/proflow-model-contracts": "^0.1.2"
+    "@tomflow/proflow-module-contract": "^0.1.3",
+    "@tomflow/proflow-execution-local": "^0.1.4",
+    "@tomflow/proflow-execution-browser-extension": "^0.1.4",
+    "@tomflow/proflow-model-contracts": "^0.1.3",
+    "@tomflow/proflow-execution-contracts": "^0.1.3"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.2"
+    "@tomflow/proflow-deployment-conformance": "^0.1.3"
   },
   "description": "Durable, policy-controlled Execution Core orchestration over SQLite and controlled executor ports.",
   "keywords": [
@@ -38,15 +40,7 @@
   ],
   "proflow": {
     "module": true,
-    "installClass": "core",
     "descriptor": "./dist/deployment/descriptor.js",
-    "installRequires": [
-      "@tomflow/proflow-execution-browser-extension",
-      "@tomflow/proflow-execution-contracts",
-      "@tomflow/proflow-execution-local",
-      "@tomflow/proflow-model-contracts",
-      "@tomflow/proflow-platform-host"
-    ],
     "manifest": "./proflow.module.json"
   },
   "scripts": {

package/proflow.module.json

@@ -3,11 +3,10 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "execution-runtime",
 	"packageName": "@tomflow/proflow-execution-runtime",
-	"moduleVersion": "0.1.4",
+	"moduleVersion": "0.1.6",
 	"kind": "service",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
-	"installClass": "core",
 	"identity": {
 		"domain": "execution",
 		"summary": "Durable, policy-controlled Execution Core orchestration over SQLite and controlled executor ports."
@@ -134,6 +133,11 @@
 			"id": "overview",
 			"path": "./README.md",
 			"description": "Execution Runtime package overview"
+		},
+		{
+			"id": "configuration",
+			"path": "./CONFIGURATION.md",
+			"description": "Module configuration fields, sources and materialization instructions"
 		}
 	]
 }

package/CHANGELOG.md

@@ -1,25 +0,0 @@
-# @tomflow/proflow-execution-runtime
-
-## 0.1.4
-
-### Patch Changes
-
-- Detect an occupied Execution Runtime listener during deployment preflight before start.
-
-## 0.1.3
-
-### Patch Changes
-
-- Re-probe recoverable identity and model dependencies during Execution Runtime readiness so normal startup order converges without a second manual restart.
-
-## 0.1.2
-
-### Patch Changes
-
-- Real-1 final remediation and black-box release closure
-
-## 0.1.1
-
-### Patch Changes
-
-- Close the Real-1 global Platform control-plane contract across every published ProFlow package. Platform CLI now owns one durable global Workspace binding with canonical identity, cross-process operation locking, cwd/`--workspace` install targeting, cross-directory instance commands, whole-instance uninstall/rebind, and deterministic npm/yarn/pnpm Workspace package-manager selection. Every package-owned install entry, including newly generated Module Template packages, delegates to the Shell-global `platform` command and fails closed when that global CLI is unavailable; Deployment Conformance and the formal test plans mechanically enforce the same rule across all 24 packages.