@tomflow/proflow-platform-host 0.1.2 → 0.1.4

package/CONFIGURATION.md

@@ -0,0 +1,29 @@
+# platform-host configuration
+
+Canonical public config: `.proflow/config/platform-host.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 |
+|---|---|---:|---:|---|---|
+| `stateRoot` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Absolute .proflow owner state root |
+| `workspaceRoot` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Absolute Task document workspace root |
+| `gatewayTransportCredentialFile` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the dedicated credential accepted from agent-gateway |
+| `executionBaseUrl` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback Execution Runtime public transport |
+| `executionTransportCredentialFile` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the credential used for Platform Host calls to Execution Runtime |
+| `modelTransportCredentialFile` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the credential used for Platform Host calls to Model Runtime |
+| `modelBaseUrl` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback Model Runtime public transport |
+
+## Materialize
+
+Create or update the canonical JSON object at:
+
+`.proflow/config/platform-host.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 PlatformHostService = {
         readiness: "READY" | "NOT_READY";
     }>;
 };
-export declare function createBehaviorAdapter(service?: PlatformHostService): {
+export declare function createBehaviorAdapter(service?: PlatformHostService, config?: Record<string, string>, configValid?: boolean): {
     describe: () => {
         result: {
             readonly contract: "deployment.result.v1";
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: never[];
     };
@@ -29,53 +29,22 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: never[];
     };
     status: () => Promise<{
         result: {
-            readonly contract: "deployment.result.v1";
-            readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
-            readonly ok: false;
-            readonly status: "ACTION_REQUIRED";
-            readonly actionRequired: {
-                readonly action: "compose-platform-host";
-                readonly description: "Provide validated Host configuration and owner transports";
-            };
-        } | {
             contract: "deployment.result.v1";
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             data: {
-                readiness: "READY" | "NOT_READY";
-            } | undefined;
-            checks: {
-                id: string;
-                status: "FAIL" | "PASS";
-                message: string;
-            }[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
-            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?: PlatformHostService): {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             checks: {
                 id: string;
                 status: "FAIL" | "PASS";
@@ -94,7 +63,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -109,7 +78,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -130,7 +99,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: never[];
     };
@@ -138,7 +107,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -150,7 +119,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             data: {
                 host: string;
                 port: number;
@@ -164,11 +133,11 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         } | {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -182,7 +151,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -194,7 +163,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             data: {
                 host: string;
                 port: number;
@@ -208,17 +177,7 @@ export declare function createBehaviorAdapter(service?: PlatformHostService): {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
-        } | {
-            readonly contract: "deployment.result.v1";
-            readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
-            readonly ok: false;
-            readonly status: "ACTION_REQUIRED";
-            readonly actionRequired: {
-                readonly action: "compose-platform-host";
-                readonly description: "Provide validated Host configuration and owner transports";
-            };
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: string[];
     }>;
@@ -230,7 +189,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: never[];
     };
@@ -240,53 +199,22 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: never[];
     };
     status: () => Promise<{
         result: {
-            readonly contract: "deployment.result.v1";
-            readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
-            readonly ok: false;
-            readonly status: "ACTION_REQUIRED";
-            readonly actionRequired: {
-                readonly action: "compose-platform-host";
-                readonly description: "Provide validated Host configuration and owner transports";
-            };
-        } | {
             contract: "deployment.result.v1";
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             data: {
-                readiness: "READY" | "NOT_READY";
-            } | undefined;
-            checks: {
-                id: string;
-                status: "FAIL" | "PASS";
-                message: string;
-            }[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
-            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[];
     }>;
@@ -296,7 +224,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             checks: {
                 id: string;
                 status: "FAIL" | "PASS";
@@ -305,7 +233,7 @@ export declare const behaviorAdapter: {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -320,7 +248,7 @@ export declare const behaviorAdapter: {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             ok: false;
             status: "ACTION_REQUIRED";
             actionRequired: {
@@ -341,7 +269,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: never[];
     };
@@ -349,7 +277,7 @@ export declare const behaviorAdapter: {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -361,7 +289,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             data: {
                 host: string;
                 port: number;
@@ -375,11 +303,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
         } | {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -393,7 +321,7 @@ export declare const behaviorAdapter: {
         result: {
             readonly contract: "deployment.result.v1";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
+            readonly moduleVersion: "0.1.4";
             readonly ok: false;
             readonly status: "ACTION_REQUIRED";
             readonly actionRequired: {
@@ -405,7 +333,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-host";
-            moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
             data: {
                 host: string;
                 port: number;
@@ -419,40 +347,16 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
-        } | {
-            readonly contract: "deployment.result.v1";
-            readonly moduleRef: "platform-host";
-            readonly moduleVersion: "0.1.2";
-            readonly ok: false;
-            readonly status: "ACTION_REQUIRED";
-            readonly actionRequired: {
-                readonly action: "compose-platform-host";
-                readonly description: "Provide validated Host configuration and owner transports";
-            };
+            readonly moduleVersion: "0.1.4";
         };
         observedEffects: string[];
     }>;
 };
-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-platform-host";
-        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,3 +1,4 @@
+import { observeDeclaredModuleStatus } from "@tomflow/proflow-module-contract";
 import { descriptor } from "./descriptor.js";
 const base = {
     contract: "deployment.result.v1",
@@ -15,37 +16,16 @@ const unbound = {
         description: "Provide validated Host configuration and owner transports",
     },
 };
-export function createBehaviorAdapter(service) {
+export function createBehaviorAdapter(service, config, configValid = true) {
     return {
         describe: () => ({ result: base, observedEffects: [] }),
         preflight: () => ({ result: base, observedEffects: [] }),
         status: async () => {
             const status = service ? await service.status() : undefined;
             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-platform-host",
-                                    description: "Platform Host is not READY",
-                                },
-                            }),
-                        data: status,
-                        checks: [
-                            {
-                                id: "platform-host-readiness",
-                                status: ready ? "PASS" : "FAIL",
-                                message: `Platform Host readiness is ${status?.readiness ?? "NOT_READY"}`,
-                            },
-                        ],
-                    }
-                    : unbound,
+                result: { ...base, data },
                 observedEffects: [],
             };
         },
@@ -101,7 +81,10 @@ export function createBehaviorAdapter(service) {
             if (service)
                 await service.stop();
             return {
-                result: service ? base : unbound,
+                // Uninstall is idempotent: an unbound service means there is no
+                // process to stop before package removal. Runtime readiness still
+                // fails closed in status/start/verify.
+                result: base,
                 observedEffects: service ? ["Manage the platform-host process"] : [],
             };
         },
@@ -117,94 +100,17 @@ const REQUIRED_CONFIG = [
     "modelBaseUrl",
     "modelTransportCredentialFile",
 ];
-// Binds the real Host process only when the materialized config is complete;
-// otherwise stays unbound so the CLI's catalog falls back to the fail-closed
-// default. The heavy src import is deferred until a real binding is requested.
-export async function createServiceProcessBinding(input) {
-    const config = input.config;
-    if (!REQUIRED_CONFIG.every((key) => config[key] !== undefined))
-        return undefined;
-    const executionRuntime = input.configByModuleRef.get("execution-runtime");
-    const advertised = executionRuntime?.["identity.endpoint"];
-    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 { parsePlatformHostConfig } = await import("../src/index.js");
-    const processConfig = parsePlatformHostConfig({
-        stateRoot: config.stateRoot,
-        workspaceRoot: config.workspaceRoot,
-        host: listener.hostname,
-        port,
-        executionBaseUrl: config.executionBaseUrl,
-        executionTransportCredentialFile: config.executionTransportCredentialFile,
-        modelBaseUrl: config.modelBaseUrl,
-        modelTransportCredentialFile: config.modelTransportCredentialFile,
-        gatewayTransportCredentialFile: config.gatewayTransportCredentialFile,
-        roles: [],
-    });
-    const probeAdapter = {
-        describe: behaviorAdapter.describe,
-        preflight: behaviorAdapter.preflight,
-        verify: async () => {
-            let ready = false;
-            try {
-                ready = (await fetch(new URL("/ready", listener))).ok;
-            }
-            catch {
-                ready = false;
-            }
-            return {
-                result: ready
-                    ? {
-                        ...base,
-                        checks: [
-                            {
-                                id: "platform-host-readiness",
-                                status: "PASS",
-                                message: "Managed Platform Host /ready probe passed",
-                            },
-                        ],
-                    }
-                    : {
-                        ...base,
-                        ok: false,
-                        status: "ACTION_REQUIRED",
-                        actionRequired: {
-                            action: "repair-platform-host",
-                            description: "Managed Platform Host /ready probe failed",
-                        },
-                        checks: [
-                            {
-                                id: "platform-host-readiness",
-                                status: "FAIL",
-                                message: "Managed Platform Host /ready probe failed",
-                            },
-                        ],
-                    },
-                observedEffects: [],
-            };
-        },
-        doctor: behaviorAdapter.doctor,
-    };
-    return {
-        serviceProcess: {
-            contract: "deployment.service-process.v1",
-            bin: "proflow-platform-host",
-            startCommand: "start",
-            config: processConfig,
-        },
-        behaviorAdapter: probeAdapter,
-    };
-}
+// Binds the real Host process only when materialized owner config and required
+// dependency composition are available. Unbound bindings still carry owner
+// config so status remains authoritative. The heavy src import is deferred
+// until a real binding is requested.
 export async function createProductionBinding(input) {
     const config = input.config;
+    const unboundBinding = (configValid = true) => ({
+        behaviorAdapter: createBehaviorAdapter(undefined, config, configValid),
+    });
     if (!REQUIRED_CONFIG.every((key) => config[key] !== undefined))
-        return undefined;
+        return unboundBinding();
     // The Platform Host's public loopback endpoint is already a cross-module
     // contract: Execution calls it through identity.endpoint. Reuse that
     // materialized endpoint as the listener instead of binding an ephemeral port
@@ -212,26 +118,38 @@ export async function createProductionBinding(input) {
     const executionRuntime = input.configByModuleRef.get("execution-runtime");
     const advertised = executionRuntime?.["identity.endpoint"];
     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 { createPlatformHost, parsePlatformHostConfig } = await import("../src/index.js");
-    const hostConfig = parsePlatformHostConfig({
-        stateRoot: config.stateRoot,
-        workspaceRoot: config.workspaceRoot,
-        host: listener.hostname,
-        port,
-        executionBaseUrl: config.executionBaseUrl,
-        executionTransportCredentialFile: config.executionTransportCredentialFile,
-        modelBaseUrl: config.modelBaseUrl,
-        modelTransportCredentialFile: config.modelTransportCredentialFile,
-        gatewayTransportCredentialFile: config.gatewayTransportCredentialFile,
-        roles: [],
-    });
+    let hostConfig;
+    try {
+        hostConfig = parsePlatformHostConfig({
+            stateRoot: config.stateRoot,
+            workspaceRoot: config.workspaceRoot,
+            host: listener.hostname,
+            port,
+            executionBaseUrl: config.executionBaseUrl,
+            executionTransportCredentialFile: config.executionTransportCredentialFile,
+            modelBaseUrl: config.modelBaseUrl,
+            modelTransportCredentialFile: config.modelTransportCredentialFile,
+            gatewayTransportCredentialFile: config.gatewayTransportCredentialFile,
+            roles: [],
+        });
+    }
+    catch {
+        return unboundBinding(false);
+    }
     const host = createPlatformHost({ config: hostConfig });
     const service = {
         start: () => host.start(),
@@ -239,5 +157,5 @@ export async function createProductionBinding(input) {
         restart: () => host.restart(),
         status: async () => ({ readiness: (await host.status()).readiness }),
     };
-    return { behaviorAdapter: createBehaviorAdapter(service) };
+    return { behaviorAdapter: createBehaviorAdapter(service, input.config) };
 }

package/dist/deployment/descriptor.d.ts

@@ -3,11 +3,10 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "platform-host";
     readonly packageName: "@tomflow/proflow-platform-host";
-    readonly moduleVersion: "0.1.2";
+    readonly moduleVersion: "0.1.4";
     readonly kind: "service";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
-    readonly installClass: "core";
     readonly identity: {
         readonly domain: "platform-architecture";
         readonly summary: "Provides the ProFlow local application composition root that binds Task, Agent, Execution and Model owner transports.";
@@ -92,5 +91,9 @@ export declare const descriptor: {
         readonly id: "overview";
         readonly path: "./README.md";
         readonly description: "Platform Host package overview";
+    }, {
+        readonly id: "configuration";
+        readonly path: "./CONFIGURATION.md";
+        readonly description: "Module configuration fields, sources and materialization instructions";
     }];
 };

package/dist/deployment/descriptor.js

@@ -3,24 +3,44 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "platform-host",
     packageName: "@tomflow/proflow-platform-host",
-    moduleVersion: "0.1.2",
+    moduleVersion: "0.1.4",
     kind: "service",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
-    installClass: "core",
     identity: {
         domain: "platform-architecture",
         summary: "Provides the ProFlow local application composition root that binds Task, Agent, Execution and Model owner transports.",
     },
-    provides: [{ contractRef: "platform-host", version: "1.0.0" }],
+    provides: [
+        {
+            contractRef: "platform-host",
+            version: "1.0.0",
+        },
+    ],
     requires: [
-        { contractRef: "task-orchestration", versionRange: ">=1.0.0 <2.0.0" },
-        { contractRef: "agent-runtime", versionRange: ">=1.0.0 <2.0.0" },
-        { contractRef: "execution", versionRange: ">=1.0.0 <2.0.0" },
-        { contractRef: "model-inference", versionRange: ">=1.0.0 <2.0.0" },
+        {
+            contractRef: "task-orchestration",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
+        {
+            contractRef: "agent-runtime",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
+        {
+            contractRef: "execution",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
+        {
+            contractRef: "model-inference",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
     ],
     requirements: [
-        { kind: "runtime", runtime: "node", versionRange: ">=24.19.0" },
+        {
+            kind: "runtime",
+            runtime: "node",
+            versionRange: ">=24.19.0",
+        },
     ],
     configSlots: [
         {
@@ -104,5 +124,10 @@ export const descriptor = {
             path: "./README.md",
             description: "Platform Host package overview",
         },
+        {
+            id: "configuration",
+            path: "./CONFIGURATION.md",
+            description: "Module configuration fields, sources and materialization instructions",
+        },
     ],
 };

package/dist/src/cli.js

@@ -1,29 +1,11 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
 import { createPlatformHost, loadPlatformHostConfig } from "./index.js";
-function installSelf() {
-    const executable = process.platform === "win32" ? "platform.cmd" : "platform";
-    const result = spawnSync(executable, ["install", "@tomflow/proflow-platform-host", "--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-platform-host install | start /absolute/config.json\\n");
+        process.stdout.write("Usage: proflow-platform-host start /absolute/config.json\\n");
         process.exit(0);
     }
-    if (command === "install") {
-        if (configPath)
-            throw new Error("Usage: proflow-platform-host install");
-        installSelf();
-    }
     if (command !== "start" || !configPath)
         throw new Error("Usage: proflow-platform-host start /absolute/config.json");
     const config = await loadPlatformHostConfig(configPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-platform-host",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -18,23 +18,24 @@
     "dist",
     "proflow.module.json",
     "conformance.json",
-    "README.md"
+    "README.md",
+    "CONFIGURATION.md"
   ],
   "dependencies": {
     "zod": "4.1.12",
-    "@tomflow/proflow-agent-runtime": "^0.1.1",
-    "@tomflow/proflow-execution-browser-extension": "^0.1.2",
-    "@tomflow/proflow-execution-contracts": "^0.1.2",
-    "@tomflow/proflow-task-migration-runner": "^0.1.1",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.1",
-    "@tomflow/proflow-task-orchestration": "^0.1.1"
+    "@tomflow/proflow-agent-runtime": "^0.1.2",
+    "@tomflow/proflow-task-migration-runner": "^0.1.2",
+    "@tomflow/proflow-execution-browser-extension": "^0.1.3",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.2",
+    "@tomflow/proflow-task-orchestration": "^0.1.1",
+    "@tomflow/proflow-module-contract": "^0.1.1",
+    "@tomflow/proflow-execution-contracts": "^0.1.2"
   },
   "devDependencies": {
-    "@tomflow/proflow-agent-gateway": "^0.1.2",
+    "@tomflow/proflow-agent-gateway": "^0.1.4",
     "@tomflow/proflow-deployment-conformance": "^0.1.2",
-    "@tomflow/proflow-execution-runtime": "^0.1.1",
-    "@tomflow/proflow-model-runtime": "^0.1.2",
-    "@tomflow/proflow-module-contract": "^0.1.1"
+    "@tomflow/proflow-execution-runtime": "^0.1.5",
+    "@tomflow/proflow-model-runtime": "^0.1.5"
   },
   "description": "Provides the ProFlow local application composition root that binds Task, Agent, Execution and Model owner transports.",
   "keywords": [
@@ -44,19 +45,7 @@
   ],
   "proflow": {
     "module": true,
-    "installClass": "core",
     "descriptor": "./dist/deployment/descriptor.js",
-    "installRequires": [
-      "@tomflow/proflow-agent-runtime",
-      "@tomflow/proflow-execution-browser-extension",
-      "@tomflow/proflow-execution-contracts",
-      "@tomflow/proflow-execution-runtime",
-      "@tomflow/proflow-model-contracts",
-      "@tomflow/proflow-model-runtime",
-      "@tomflow/proflow-task-migration-runner",
-      "@tomflow/proflow-task-orchestration",
-      "@tomflow/proflow-task-store-sqlite"
-    ],
     "manifest": "./proflow.module.json"
   },
   "scripts": {

package/proflow.module.json

@@ -3,11 +3,10 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "platform-host",
 	"packageName": "@tomflow/proflow-platform-host",
-	"moduleVersion": "0.1.2",
+	"moduleVersion": "0.1.4",
 	"kind": "service",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
-	"installClass": "core",
 	"identity": {
 		"domain": "platform-architecture",
 		"summary": "Provides the ProFlow local application composition root that binds Task, Agent, Execution and Model owner transports."
@@ -124,6 +123,11 @@
 			"id": "overview",
 			"path": "./README.md",
 			"description": "Platform Host package overview"
+		},
+		{
+			"id": "configuration",
+			"path": "./CONFIGURATION.md",
+			"description": "Module configuration fields, sources and materialization instructions"
 		}
 	]
 }

package/CHANGELOG.md

@@ -1,13 +0,0 @@
-# @tomflow/proflow-platform-host
-
-## 0.1.2
-
-### 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.
-
-## 0.1.1
-
-### Patch Changes
-
-- Close Real-1 deployment graph and Fresh Workspace bootstrap gaps: remove Contract-library runtime-provider aliases, correct Execution/Model dependency direction, materialize logical/moduleRef providers through `installRequires`, enforce repository graph validation, and keep self-install executables stable without package-manager worktree mutation.