@tomflow/proflow-execution-browser-extension 0.1.3 → 0.1.4

package/CONFIGURATION.md

@@ -0,0 +1,33 @@
+# execution-browser-extension configuration
+
+Canonical public config: `.proflow/config/execution-browser-extension.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 |
+|---|---|---:|---:|---|---|
+| `bridge.endpoint` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback Browser Reality Bridge endpoint |
+| `bridge.token` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the Browser Reality Bridge extension token |
+| `taskApplication.endpoint` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback Platform Host Task application endpoint |
+| `taskApplication.token` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the Platform Host Task application token |
+| `approvalApplication.endpoint` | `url` | yes | no | User or owning external/runtime Module supplies the reachable endpoint URL. | Loopback Platform Host Approval application endpoint |
+| `approvalApplication.token` | `path` | yes | yes | User or owning Module supplies an absolute/local path that exists on this Workspace. | File containing the Platform Host Approval application token |
+| `verificationEvidenceFile` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | JSON evidence file written after real Chrome loads the Deployment-managed MV3 extension and its Service Worker runs |
+| `chromeRuntimeModuleRef` | `moduleRef` | no | no | Another installed ProFlow Module reference selected from `platform docs` / Module topology. | External resource module governing the Chrome runtime |
+| `carrierModuleRef` | `moduleRef` | no | no | Another installed ProFlow Module reference selected from `platform docs` / Module topology. | External resource module governing the Custom GPT carrier |
+
+## Materialize
+
+Create or update the canonical JSON object at:
+
+`.proflow/config/execution-browser-extension.json`
+
+Use only declared keys and string values. Do not create a second Platform configuration database.
+
+The Browser Extension also requires a package-owned physical runtime config artifact. After the canonical Module config is present, run `proflow-execution-browser-extension materialize-config --workspace <path>`. This package-owned command writes the private runtime artifact under `.proflow/deployment/browser-extension/execution-browser-extension/`; `platform start` must not perform this materialization implicitly.
+
+## 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

@@ -3,7 +3,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.4";
             ok: boolean;
             status: string;
         };
@@ -13,7 +13,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.4";
             ok: boolean;
             status: string;
         };
@@ -23,12 +23,13 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.4";
             ok: boolean;
             status: string;
-            actionRequired: {
-                action: string;
-                description: string;
+            data: {
+                configStatus: "INCOMPLETE" | "INVALID" | "READY";
+                missingConfig?: string[] | undefined;
+                runtimeStatus: "FAILED" | "RUNNING" | "STOPPED" | "UNKNOWN";
             };
         };
         observedEffects: never[];
@@ -37,7 +38,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.4";
             ok: boolean;
             status: string;
             checks: {
@@ -52,7 +53,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.4";
             ok: boolean;
             status: string;
         };

package/dist/deployment/adapter.js

@@ -1,6 +1,7 @@
 import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { observeDeclaredModuleStatus } from "@tomflow/proflow-module-contract";
 import { descriptor } from "./descriptor.js";
 const base = {
     contract: "deployment.result.v1",
@@ -19,12 +20,9 @@ export const behaviorAdapter = {
     status: () => ({
         result: {
             ...base,
-            ok: false,
-            status: "ACTION_REQUIRED",
-            actionRequired: {
-                action: "verify-real-carrier",
-                description: "Load in real Chrome and collect ChatGPT E3/E4 evidence",
-            },
+            ok: true,
+            status: "SUCCEEDED",
+            data: observeDeclaredModuleStatus(descriptor, undefined, "UNKNOWN"),
         },
         observedEffects: [],
     }),
@@ -170,25 +168,21 @@ export function createProductionBinding(input) {
                     },
                 observedEffects: [],
             }),
-            status: async () => ({
-                result: (await configured())
-                    ? {
+            status: async () => {
+                const isConfigured = await configured();
+                const evidence = await readBrowserVerificationEvidence(verificationEvidenceFile, loadDir);
+                return {
+                    result: {
                         ...boundBase,
                         ok: true,
                         status: "SUCCEEDED",
-                        data: { loadDir, configMaterialized: true },
-                    }
-                    : {
-                        ...boundBase,
-                        ok: false,
-                        status: "ACTION_REQUIRED",
-                        actionRequired: {
-                            action: "configure-browser-extension",
-                            description: "Browser Extension runtime config is not materialized",
-                        },
+                        data: observeDeclaredModuleStatus(descriptor, input.config, evidence ? "RUNNING" : "STOPPED", isConfigured),
                     },
-                observedEffects: [],
-            }),
+                    observedEffects: evidence
+                        ? ["Observes real Chrome MV3 load evidence"]
+                        : [],
+                };
+            },
             verify: async () => {
                 const evidence = await readBrowserVerificationEvidence(verificationEvidenceFile, loadDir);
                 return {

package/dist/deployment/descriptor.d.ts

@@ -3,11 +3,10 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "execution-browser-extension";
     readonly packageName: "@tomflow/proflow-execution-browser-extension";
-    readonly moduleVersion: "0.1.3";
+    readonly moduleVersion: "0.1.4";
     readonly kind: "browser-extension";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
-    readonly installClass: "core";
     readonly identity: {
         readonly domain: "execution";
         readonly summary: "Execution-owned MV3 Browser executor, evidence provider and browser application surface.";
@@ -104,5 +103,9 @@ export declare const descriptor: {
         readonly id: "overview";
         readonly path: "./README.md";
         readonly description: "Package-owned module overview";
+    }, {
+        readonly id: "configuration";
+        readonly path: "./CONFIGURATION.md";
+        readonly description: "Module configuration fields, sources and materialization instructions";
     }];
 };

package/dist/deployment/descriptor.js

@@ -3,23 +3,40 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "execution-browser-extension",
     packageName: "@tomflow/proflow-execution-browser-extension",
-    moduleVersion: "0.1.3",
+    moduleVersion: "0.1.4",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
-    installClass: "core",
     identity: {
         domain: "execution",
         summary: "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
     },
-    provides: [{ contractRef: "execution-browser-executor", version: "1.0.0" }],
+    provides: [
+        {
+            contractRef: "execution-browser-executor",
+            version: "1.0.0",
+        },
+    ],
     requires: [
-        { contractRef: "execution", 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: "task-orchestration",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
+        {
+            contractRef: "agent-runtime",
+            versionRange: ">=1.0.0 <2.0.0",
+        },
     ],
     requirements: [
-        { kind: "runtime", runtime: "browser", versionRange: ">=1" },
+        {
+            kind: "runtime",
+            runtime: "browser",
+            versionRange: ">=1",
+        },
         {
             kind: "human",
             action: "Load and verify the unpacked MV3 extension in the real Chrome profile",
@@ -111,5 +128,10 @@ export const descriptor = {
             path: "./README.md",
             description: "Package-owned module overview",
         },
+        {
+            id: "configuration",
+            path: "./CONFIGURATION.md",
+            description: "Module configuration fields, sources and materialization instructions",
+        },
     ],
 };

package/dist/src/configure.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export declare function materializeBrowserExtensionConfig(workspaceRoot: string): Promise<{
+    loadDir: string;
+}>;

package/dist/src/configure.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { materializeProductionConfig } from "../deployment/adapter.js";
+function workspaceFromArgs(args) {
+    if (args[0] !== "materialize-config") {
+        throw new Error("Usage: proflow-execution-browser-extension materialize-config [--workspace /absolute/path]");
+    }
+    const workspaceIndex = args.indexOf("--workspace");
+    if (workspaceIndex < 0)
+        return process.cwd();
+    const value = args[workspaceIndex + 1];
+    if (!value || args.length !== 3) {
+        throw new Error("Usage: proflow-execution-browser-extension materialize-config [--workspace /absolute/path]");
+    }
+    return resolve(value);
+}
+export async function materializeBrowserExtensionConfig(workspaceRoot) {
+    const configPath = resolve(workspaceRoot, ".proflow", "config", "execution-browser-extension.json");
+    const parsed = JSON.parse(await readFile(configPath, "utf8"));
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new Error("execution-browser-extension config must be a JSON object");
+    }
+    const config = Object.fromEntries(Object.entries(parsed).map(([key, value]) => {
+        if (typeof value !== "string") {
+            throw new Error(`browser extension config ${key} must be a string`);
+        }
+        return [key, value];
+    }));
+    return materializeProductionConfig({
+        moduleRef: "execution-browser-extension",
+        config,
+        workspaceRoot,
+    });
+}
+async function main() {
+    const workspaceRoot = workspaceFromArgs(process.argv.slice(2));
+    const result = await materializeBrowserExtensionConfig(workspaceRoot);
+    process.stdout.write(`${JSON.stringify({ status: "MATERIALIZED", ...result })}\n`);
+}
+if (import.meta.main)
+    await main();

package/manifest.json

@@ -1,7 +1,7 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.3",
+	"version": "0.1.4",
 	"permissions": ["tabs", "storage", "sidePanel"],
 	"host_permissions": ["https://chatgpt.com/*", "http://127.0.0.1/*"],
 	"background": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -11,7 +11,8 @@
     "./bridge": "./dist/src/bridge.js",
     "./deployment/adapter": "./dist/deployment/adapter.js",
     "./deployment/descriptor": "./dist/deployment/descriptor.js",
-    "./runtime-composition": "./dist/src/runtime-composition.js"
+    "./runtime-composition": "./dist/src/runtime-composition.js",
+    "./configure": "./dist/src/configure.js"
   },
   "files": [
     "dist",
@@ -21,15 +22,15 @@
     "proflow.module.json",
     "conformance.json",
     "README.md",
-    "self-install.mjs"
+    "CONFIGURATION.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-contracts": "^0.1.2"
+    "@tomflow/proflow-module-contract": "^0.1.2",
+    "@tomflow/proflow-execution-contracts": "^0.1.3"
   },
   "devDependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.1",
-    "@tomflow/proflow-deployment-conformance": "^0.1.2",
-    "@tomflow/proflow-execution-runtime": "^0.1.2"
+    "@tomflow/proflow-deployment-conformance": "^0.1.3",
+    "@tomflow/proflow-execution-runtime": "^0.1.5"
   },
   "keywords": [
     "proflow",
@@ -38,20 +39,11 @@
   ],
   "proflow": {
     "module": true,
-    "installClass": "core",
-    "installRequires": [
-      "@tomflow/proflow-agent-runtime",
-      "@tomflow/proflow-chatgpt-carrier",
-      "@tomflow/proflow-chrome-runtime",
-      "@tomflow/proflow-execution-contracts",
-      "@tomflow/proflow-execution-runtime",
-      "@tomflow/proflow-task-orchestration"
-    ],
     "descriptor": "./dist/deployment/descriptor.js",
     "manifest": "./proflow.module.json"
   },
   "bin": {
-    "proflow-execution-browser-extension": "./self-install.mjs"
+    "proflow-execution-browser-extension": "./dist/src/configure.js"
   },
   "scripts": {
     "test": "node --test tests/**/*.test.ts",

package/proflow.module.json

@@ -3,11 +3,10 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "execution-browser-extension",
 	"packageName": "@tomflow/proflow-execution-browser-extension",
-	"moduleVersion": "0.1.3",
+	"moduleVersion": "0.1.4",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
-	"installClass": "core",
 	"identity": {
 		"domain": "execution",
 		"summary": "Execution-owned MV3 Browser executor, evidence provider and browser application surface."
@@ -128,6 +127,11 @@
 			"id": "overview",
 			"path": "./README.md",
 			"description": "Package-owned module overview"
+		},
+		{
+			"id": "configuration",
+			"path": "./CONFIGURATION.md",
+			"description": "Module configuration fields, sources and materialization instructions"
 		}
 	]
 }

package/CHANGELOG.md

@@ -1,19 +0,0 @@
-# @tomflow/proflow-execution-browser-extension
-
-## 0.1.3
-
-### Patch Changes
-
-- Real-1 final remediation and black-box release closure
-
-## 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.

package/self-install.mjs

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-
-const [command, ...rest] = process.argv.slice(2);
-const usage =
-	"Usage: npx @tomflow/proflow-execution-browser-extension install\n";
-if (command === "--help" || command === "-h") {
-	process.stdout.write(usage);
-	process.exit(0);
-}
-if (command !== "install" || rest.length > 0) {
-	process.stderr.write(usage);
-	process.exit(2);
-}
-const executable = process.platform === "win32" ? "platform.cmd" : "platform";
-const result = spawnSync(
-	executable,
-	[
-		"install",
-		"@tomflow/proflow-execution-browser-extension",
-		"--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);