@tomflow/proflow-execution-runtime 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @tomflow/proflow-execution-runtime
+
+Durable, policy-controlled Execution Core orchestration over SQLite. Browser/local/network/file real effects are accepted only through controlled executor ports and converge to Result/Evidence/UNKNOWN; no Browser Extension implementation lives here.
+
+Execution remains the sole real-effect plane. Task/System Observers may request work through public contracts but cannot mutate Execution truth. Browser delivery uncertainty follows current-reality observation and no-blind-replay; ChatGPT routine permission/Always Allow is a Carrier concern and never substitutes for Execution effect approval.

package/conformance.json

@@ -0,0 +1,4 @@
+{
+	"contract": "proflow.conformance.v1",
+	"levels": ["C1", "C2", "C3"]
+}

package/dist/deployment/adapter.d.ts

@@ -0,0 +1,458 @@
+type ProcessService = {
+    start(): Promise<{
+        host: string;
+        port: number;
+    }>;
+    stop(): Promise<void>;
+    restart(): Promise<{
+        host: string;
+        port: number;
+    }>;
+    status(): {
+        readiness: "READY" | "NOT_READY";
+    };
+};
+export declare function createBehaviorAdapter(service?: ProcessService): {
+    describe: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        };
+        observedEffects: never[];
+    };
+    preflight: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        };
+        observedEffects: never[];
+    };
+    status: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            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.0";
+            data: {
+                readiness: "READY" | "NOT_READY";
+            } | undefined;
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        } | {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            actionRequired: {
+                action: string;
+                description: string;
+            };
+            data: {
+                readiness: "READY" | "NOT_READY";
+            } | undefined;
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        };
+        observedEffects: never[];
+    };
+    verify: () => {
+        result: {
+            contract: "deployment.result.v1";
+            ok: true;
+            status: "SUCCEEDED";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        } | {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            actionRequired: {
+                readonly action: "bind-runtime";
+                readonly description: "Bind a configured Execution Runtime service";
+            };
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        } | {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            actionRequired: {
+                action: string;
+                description: string;
+            };
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        };
+        observedEffects: never[];
+    };
+    doctor: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        };
+        observedEffects: never[];
+    };
+    start: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            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.0";
+            data: {
+                host: string;
+                port: number;
+            };
+        };
+        observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
+    }>;
+    stop: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        } | {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            readonly ok: false;
+            readonly status: "ACTION_REQUIRED";
+            readonly actionRequired: {
+                readonly action: "bind-runtime";
+                readonly description: "Bind a configured Execution Runtime service";
+            };
+        };
+        observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
+    }>;
+    uninstall: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        } | {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            readonly ok: false;
+            readonly status: "ACTION_REQUIRED";
+            readonly actionRequired: {
+                readonly action: "bind-runtime";
+                readonly description: "Bind a configured Execution Runtime service";
+            };
+        };
+        observedEffects: "Runs the single backend Execution Runtime service"[];
+    }>;
+    restart: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            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.0";
+            data: {
+                host: string;
+                port: number;
+            };
+        };
+        observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
+    }>;
+};
+export declare const behaviorAdapter: {
+    describe: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        };
+        observedEffects: never[];
+    };
+    preflight: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        };
+        observedEffects: never[];
+    };
+    status: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            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.0";
+            data: {
+                readiness: "READY" | "NOT_READY";
+            } | undefined;
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        } | {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            actionRequired: {
+                action: string;
+                description: string;
+            };
+            data: {
+                readiness: "READY" | "NOT_READY";
+            } | undefined;
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        };
+        observedEffects: never[];
+    };
+    verify: () => {
+        result: {
+            contract: "deployment.result.v1";
+            ok: true;
+            status: "SUCCEEDED";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        } | {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            actionRequired: {
+                readonly action: "bind-runtime";
+                readonly description: "Bind a configured Execution Runtime service";
+            };
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        } | {
+            contract: "deployment.result.v1";
+            moduleRef: "execution-runtime";
+            moduleVersion: "0.1.0";
+            ok: false;
+            status: "ACTION_REQUIRED";
+            actionRequired: {
+                action: string;
+                description: string;
+            };
+            checks: {
+                id: string;
+                status: "FAIL" | "PASS";
+                message: string;
+            }[];
+        };
+        observedEffects: never[];
+    };
+    doctor: () => {
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        };
+        observedEffects: never[];
+    };
+    start: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            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.0";
+            data: {
+                host: string;
+                port: number;
+            };
+        };
+        observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
+    }>;
+    stop: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        } | {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            readonly ok: false;
+            readonly status: "ACTION_REQUIRED";
+            readonly actionRequired: {
+                readonly action: "bind-runtime";
+                readonly description: "Bind a configured Execution Runtime service";
+            };
+        };
+        observedEffects: ("Persists execution state, output references and evidence in WAL SQLite" | "Runs the single backend Execution Runtime service")[];
+    }>;
+    uninstall: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+        } | {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            readonly ok: false;
+            readonly status: "ACTION_REQUIRED";
+            readonly actionRequired: {
+                readonly action: "bind-runtime";
+                readonly description: "Bind a configured Execution Runtime service";
+            };
+        };
+        observedEffects: "Runs the single backend Execution Runtime service"[];
+    }>;
+    restart: () => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly moduleRef: "execution-runtime";
+            readonly moduleVersion: "0.1.0";
+            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.0";
+            data: {
+                host: string;
+                port: number;
+            };
+        };
+        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 {};