@tomflow/proflow-execution-browser-extension 0.1.13 → 0.1.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-execution-browser-extension
 
+## 0.1.14
+
+### Patch Changes
+
+- Retire the obsolete Carrier package and Browser standalone management CLI, make Platform setup/status preserve owner and dependency semantics, and enforce read-only status observation across the final Real-3 deployment closeout.
+
 ## 0.1.13
 
 ### Patch Changes

package/DOCS.md

@@ -32,7 +32,7 @@ Execution 领域拥有的 Chrome MV3 Extension，负责 Task UI、审批提醒
 
 ## 使用方式
 
-运行 `pnpm exec -- proflow-execution-browser-extension setup --workspace <workspace>`。ProFlow 会先准备 unpacked 目录、运行配置和本地 Bridge，并用真实 hello + heartbeat 尝试重验证已有扩展；已有扩展仍在线时不会再次打扰用户。只有未检测到在线扩展时，ProFlow 才把正确目录复制到剪贴板并打开 `chrome://extensions/`，提示用户完成安装操作：如果开发者模式尚未开启则先开启，然后点击“加载未打包的扩展程序”，在目录选择窗口中粘贴并确认目录。完成后无需回终端输入任何标识或状态；扩展身份、session、hello/heartbeat、Browser Executor 配置和 setup evidence 都由机器自动发现、生成并验证。历史 pairing evidence 不能单独代替本次 live revalidation。
+运行 `platform setup --workspace <workspace> --module execution-browser-extension`。ProFlow 会先准备 unpacked 目录、运行配置和本地 Bridge，并用真实 hello + heartbeat 尝试重验证已有扩展；已有扩展仍在线时不会再次打扰用户。只有未检测到在线扩展时，ProFlow 才把正确目录复制到剪贴板并打开 `chrome://extensions/`，提示用户完成安装操作：如果开发者模式尚未开启则先开启，然后点击“加载未打包的扩展程序”，在目录选择窗口中粘贴并确认目录。完成后无需回终端输入任何标识或状态；扩展身份、session、hello/heartbeat、Browser Executor 配置和 setup evidence 都由机器自动发现、生成并验证。历史 pairing evidence 不能单独代替本次 live revalidation。
 
 若 pairing 等待超时，ProFlow 保留已经准备好的扩展文件和机器配置，不写伪 READY evidence，并输出稳定错误代码 `PAIRING_TIMEOUT`。用户确认 Chrome 已完成加载后重新执行 `platform setup` 即可。Agent setup 随后通过 `custom-gpt-web-provisioning` 使用同一 Extension package 的部署期分支。
 

package/SETUP.md

@@ -2,10 +2,10 @@
 
 ## STEP-EXECUTION-BROWSER-EXTENSION-01 — 加载扩展并自动配对
 Responsible: USER
-Interactive executable: `pnpm exec -- proflow-execution-browser-extension setup`
-Non-interactive executable: `pnpm exec -- proflow-execution-browser-extension setup`
+Interactive executable: `platform setup --module execution-browser-extension`
+Non-interactive executable: `platform setup --module execution-browser-extension`
 Required inputs: none
-Verify: `pnpm exec -- proflow-execution-browser-extension verify`
+Verify: `platform status`
 Success condition: 本地 pairing listener 已收到真实 Extension hello + heartbeat，并持久化部署证据。
 
 运行命令后，ProFlow 会先准备 unpacked 目录和所有机器配置，并尝试用真实 hello + heartbeat 重验证已有扩展。若已有扩展仍在线，则无需任何人工操作，setup 直接继续；只有未检测到在线扩展时，ProFlow 才把正确目录复制到剪贴板、打开 `chrome://extensions/` 并提示用户完成安装操作：如果开发者模式尚未开启则先开启，然后点击“加载未打包的扩展程序”，在目录选择窗口中粘贴并确认刚刚复制的目录。完成后无需回终端输入任何内容；扩展身份确认、Bridge 配置、hello/heartbeat 验证和 READY 状态均由 ProFlow 自动完成。历史 `setup.json` / verification evidence 不能单独跳过本次 live revalidation。
@@ -14,8 +14,8 @@ Success condition: 本地 pairing listener 已收到真实 Extension hello + hea
 
 ## STEP-EXECUTION-BROWSER-EXTENSION-02 — 验证部署状态
 Responsible: AI
-Interactive executable: `pnpm exec -- proflow-execution-browser-extension verify`
-Non-interactive executable: `pnpm exec -- proflow-execution-browser-extension verify`
+Interactive executable: `platform status`
+Non-interactive executable: `platform status`
 Required inputs: none
-Verify: `pnpm exec -- proflow-execution-browser-extension verify`
+Verify: `platform status`
 Success condition: `execution-browser-extension.setupStatus=READY`.

package/dist/deployment/adapter.d.ts

@@ -24,7 +24,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data: {
                 loadDir: string;
             };
@@ -37,7 +37,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.13";
+            readonly moduleVersion: "0.1.14";
         };
         observedEffects: never[];
     }>;
@@ -47,10 +47,10 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
-                runtimeStatus: "RUNNING" | "STOPPED";
+                runtimeStatus: "NOT_APPLICABLE";
                 issues?: {
                     scope: "SETUP";
                     code: string;
@@ -63,10 +63,19 @@ export declare const behaviorAdapter: {
         observedEffects: string[];
     }>;
     readonly setup: (context: ModuleCommandContext) => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "execution-browser-extension";
+            readonly moduleVersion: "0.1.14";
+        };
+        observedEffects: string[];
+    } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             ok: false;
             status: "FAILED";
             error: {
@@ -81,69 +90,17 @@ export declare const behaviorAdapter: {
                     readonly state: "BLOCKED";
                     readonly responsible: "EXTERNAL";
                     readonly execution: {
-                        readonly interactive: "pnpm exec -- proflow-execution-browser-extension setup";
-                        readonly nonInteractive: "pnpm exec -- proflow-execution-browser-extension setup";
+                        readonly interactive: "platform setup --module execution-browser-extension";
+                        readonly nonInteractive: "platform setup --module execution-browser-extension";
                     };
                     readonly requiredInputs: readonly [];
-                    readonly verify: "pnpm exec -- proflow-execution-browser-extension verify";
+                    readonly verify: "platform status";
                     readonly successCondition: "配置状态变为“已就绪”";
                     readonly blockedReason: "真实 Extension heartbeat 未到达或本地 pairing 失败";
                 }];
             };
         };
         observedEffects: never[];
-    } | {
-        result: {
-            readonly contract: "deployment.result.v1";
-            readonly ok: true;
-            readonly status: "SUCCEEDED";
-            readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.13";
-        };
-        observedEffects: string[];
-    } | {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.13";
-            ok: false;
-            status: "ACTION_REQUIRED";
-            data: {
-                readonly steps: readonly [{
-                    readonly id: "STEP-EXECUTION-BROWSER-EXTENSION-01";
-                    readonly title: "加载扩展并自动配对";
-                    readonly description: "准备 unpacked 目录和本地 Bridge，等待 Chrome Extension 的真实 hello + heartbeat。";
-                    readonly state: "TODO";
-                    readonly responsible: "USER";
-                    readonly execution: {
-                        readonly interactive: "pnpm exec -- proflow-execution-browser-extension setup";
-                        readonly nonInteractive: "pnpm exec -- proflow-execution-browser-extension setup";
-                    };
-                    readonly requiredInputs: readonly [];
-                    readonly verify: "pnpm exec -- proflow-execution-browser-extension verify";
-                    readonly successCondition: "Extension hello + heartbeat 已被本地 pairing listener 验证并持久化";
-                    readonly humanAction: "启用开发者模式并加载脚本准备的 unpacked 目录；其余身份发现与验证自动完成。";
-                }, {
-                    readonly id: "STEP-EXECUTION-BROWSER-EXTENSION-02";
-                    readonly title: "验证扩展部署状态";
-                    readonly description: "读取 heartbeat 形成的持久化部署证据。";
-                    readonly state: "TODO";
-                    readonly responsible: "AI";
-                    readonly execution: {
-                        readonly interactive: "pnpm exec -- proflow-execution-browser-extension verify";
-                        readonly nonInteractive: "pnpm exec -- proflow-execution-browser-extension verify";
-                    };
-                    readonly requiredInputs: readonly [];
-                    readonly verify: "pnpm exec -- proflow-execution-browser-extension verify";
-                    readonly successCondition: "execution-browser-extension.setupStatus=READY";
-                }];
-            };
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-        };
-        observedEffects: never[];
     }>;
     readonly docs: (_context: ModuleCommandContext) => Promise<{
         result: {
@@ -151,7 +108,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data: {
                 docs: string;
             };
@@ -164,11 +121,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.13";
+            readonly moduleVersion: "0.1.14";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             ok: false;
             status: "FAILED";
             error: {
@@ -185,7 +142,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.13";
+            readonly moduleVersion: "0.1.14";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -3,6 +3,7 @@ import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { deterministicLoopbackPort, ensureModuleSecretFile, moduleWorkspaceStateDirectory, readModuleSharedFacts, writeModuleSharedFacts, } from "@tomflow/proflow-module-contract";
+import { runInteractiveBrowserExtensionSetup } from "../src/install-workflow.js";
 import { createBrowserExtensionPairingServer } from "../src/pairing.js";
 import { descriptor } from "./descriptor.js";
 const base = {
@@ -12,39 +13,6 @@ const base = {
     moduleRef: descriptor.moduleRef,
     moduleVersion: descriptor.moduleVersion,
 };
-const setupPlan = {
-    steps: [
-        {
-            id: "STEP-EXECUTION-BROWSER-EXTENSION-01",
-            title: "加载扩展并自动配对",
-            description: "准备 unpacked 目录和本地 Bridge，等待 Chrome Extension 的真实 hello + heartbeat。",
-            state: "TODO",
-            responsible: "USER",
-            execution: {
-                interactive: "pnpm exec -- proflow-execution-browser-extension setup",
-                nonInteractive: "pnpm exec -- proflow-execution-browser-extension setup",
-            },
-            requiredInputs: [],
-            verify: "pnpm exec -- proflow-execution-browser-extension verify",
-            successCondition: "Extension hello + heartbeat 已被本地 pairing listener 验证并持久化",
-            humanAction: "启用开发者模式并加载脚本准备的 unpacked 目录；其余身份发现与验证自动完成。",
-        },
-        {
-            id: "STEP-EXECUTION-BROWSER-EXTENSION-02",
-            title: "验证扩展部署状态",
-            description: "读取 heartbeat 形成的持久化部署证据。",
-            state: "TODO",
-            responsible: "AI",
-            execution: {
-                interactive: "pnpm exec -- proflow-execution-browser-extension verify",
-                nonInteractive: "pnpm exec -- proflow-execution-browser-extension verify",
-            },
-            requiredInputs: [],
-            verify: "pnpm exec -- proflow-execution-browser-extension verify",
-            successCondition: "execution-browser-extension.setupStatus=READY",
-        },
-    ],
-};
 const blockedSetupPlan = {
     steps: [
         {
@@ -53,11 +21,11 @@ const blockedSetupPlan = {
             state: "BLOCKED",
             responsible: "EXTERNAL",
             execution: {
-                interactive: "pnpm exec -- proflow-execution-browser-extension setup",
-                nonInteractive: "pnpm exec -- proflow-execution-browser-extension setup",
+                interactive: "platform setup --module execution-browser-extension",
+                nonInteractive: "platform setup --module execution-browser-extension",
             },
             requiredInputs: [],
-            verify: "pnpm exec -- proflow-execution-browser-extension verify",
+            verify: "platform status",
             successCondition: "配置状态变为“已就绪”",
             blockedReason: "真实 Extension heartbeat 未到达或本地 pairing 失败",
         },
@@ -244,10 +212,6 @@ async function materializeExecutorConfig(context, setup, prepared) {
         browserExecutorConfigPath: executorConfigFile(context),
     });
 }
-async function materialize(context, setup) {
-    const prepared = await materializeRuntimeConfig(context);
-    await materializeExecutorConfig(context, setup, prepared);
-}
 async function persistPairedBrowserExtension(context, prepared, identity) {
     const setup = { extensionId: identity.extensionId };
     await writeFile(setupFile(context), `${JSON.stringify(setup, null, 2)}\n`, {
@@ -338,7 +302,7 @@ export const behaviorAdapter = {
                     setupStatus: setupReady
                         ? "READY"
                         : "ACTION_REQUIRED",
-                    runtimeStatus: evidence ? "RUNNING" : "STOPPED",
+                    runtimeStatus: "NOT_APPLICABLE",
                     ...(setupReady
                         ? {}
                         : {
@@ -360,43 +324,38 @@ export const behaviorAdapter = {
         };
     },
     setup: async (context) => {
-        await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
-        await installPackage(context);
-        const setup = await readSetup(context);
-        const evidence = await readEvidence(context, browserExtensionLoadDir(context.workspaceRoot));
-        if (setup && evidence && setup.extensionId === evidence.extensionId) {
-            try {
-                await materialize(context, setup);
-            }
-            catch (error) {
-                return {
-                    result: {
-                        ...failed("SETUP_FAILED", error instanceof Error
-                            ? error.message
-                            : "browser extension config materialization failed"),
-                        data: blockedSetupPlan,
-                    },
-                    observedEffects: [],
-                };
-            }
+        try {
+            const input = typeof context.input === "object" && context.input !== null
+                ? context.input
+                : undefined;
+            await runInteractiveBrowserExtensionSetup({
+                workspaceRoot: context.workspaceRoot,
+                ...(input?.timeoutMs === undefined
+                    ? {}
+                    : { timeoutMs: input.timeoutMs }),
+                ...(input?.desktop === undefined ? {} : { desktop: input.desktop }),
+                ...(input?.pair === undefined ? {} : { pair: input.pair }),
+            });
             return {
                 result: base,
-                observedEffects: ["Uses heartbeat-proven Chrome MV3 pairing evidence"],
+                observedEffects: [
+                    "Materializes browser runtime configuration",
+                    "Opens Chrome extension management",
+                    "Persists heartbeat-proven Chrome MV3 pairing evidence",
+                ],
             };
         }
-        return {
-            result: {
-                ...base,
-                ok: false,
-                status: "ACTION_REQUIRED",
-                data: setupPlan,
-                actionRequired: {
-                    action: "load-unpacked-extension",
-                    description: `Run pnpm exec -- proflow-execution-browser-extension setup --workspace ${context.workspaceRoot}; then enable Developer Mode and load ${browserExtensionLoadDir(context.workspaceRoot)}. The package CLI materializes bootstrap config, discovers the extension and verifies its heartbeat automatically.`,
+        catch (error) {
+            return {
+                result: {
+                    ...failed("SETUP_FAILED", error instanceof Error
+                        ? error.message
+                        : "browser extension setup failed"),
+                    data: blockedSetupPlan,
                 },
-            },
-            observedEffects: [],
-        };
+                observedEffects: [],
+            };
+        }
     },
     docs: async (_context) => ({
         result: {

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ 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.13";
+    readonly moduleVersion: "0.1.14";
     readonly kind: "browser-extension";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

package/dist/deployment/descriptor.js

@@ -3,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "execution-browser-extension",
     packageName: "@tomflow/proflow-execution-browser-extension",
-    moduleVersion: "0.1.13",
+    moduleVersion: "0.1.14",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/install-workflow.js

@@ -1,5 +1,4 @@
 import { spawn, spawnSync } from "node:child_process";
-import { pairBrowserExtensionSetup } from "../deployment/adapter.js";
 export function browserExtensionInstallInstruction(loadDir) {
     return `\nChrome 浏览器扩展\n\nProFlow 已准备好扩展文件，并已复制安装目录：\n${loadDir}\n\n请在已经打开的 Chrome 扩展管理页完成以下安装操作：\n1. 如果“开发者模式”尚未开启，请开启\n2. 点击“加载未打包的扩展程序”\n3. 在目录选择窗口中粘贴并确认刚刚复制的目录\n\n完成后无需返回输入任何内容。ProFlow 会自动检测扩展并继续。\n`;
 }
@@ -52,7 +51,8 @@ function systemDesktop() {
 }
 export async function runInteractiveBrowserExtensionSetup(input) {
     const desktop = input.desktop ?? systemDesktop();
-    const pair = input.pair ?? pairBrowserExtensionSetup;
+    const pair = input.pair ??
+        (await import("../deployment/adapter.js")).pairBrowserExtensionSetup;
     return pair({ workspaceRoot: input.workspaceRoot }, {
         timeoutMs: input.timeoutMs ?? 120_000,
         async onWaiting({ loadDir }) {

package/manifest.json

@@ -1,7 +1,7 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.13",
+	"version": "0.1.14",
 	"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.13",
+  "version": "0.1.14",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -13,8 +13,7 @@
     "./deployment/descriptor": "./dist/deployment/descriptor.js",
     "./runtime-composition": "./dist/src/runtime-composition.js",
     "./custom-gpt-provisioning": "./dist/src/custom-gpt-provisioner.js",
-    "./custom-gpt-role": "./dist/src/custom-gpt-role.js",
-    "./configure": "./dist/src/configure.js"
+    "./custom-gpt-role": "./dist/src/custom-gpt-role.js"
   },
   "files": [
     "dist",
@@ -32,8 +31,8 @@
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.11",
-    "@tomflow/proflow-execution-runtime": "^0.1.14"
+    "@tomflow/proflow-deployment-conformance": "^0.1.12",
+    "@tomflow/proflow-execution-runtime": "^0.1.15"
   },
   "keywords": [
     "proflow",
@@ -45,9 +44,6 @@
     "descriptor": "./dist/deployment/descriptor.js",
     "manifest": "./proflow.module.json"
   },
-  "bin": {
-    "proflow-execution-browser-extension": "./dist/src/configure.js"
-  },
   "scripts": {
     "test": "node --test tests/**/*.test.ts",
     "typecheck": "tsc --noEmit"

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "execution-browser-extension",
 	"packageName": "@tomflow/proflow-execution-browser-extension",
-	"moduleVersion": "0.1.13",
+	"moduleVersion": "0.1.14",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",

package/dist/src/configure-args.d.ts

@@ -1,3 +0,0 @@
-export declare function parseBrowserExtensionSetupArgs(args: readonly string[], cwd: string): {
-    workspaceRoot: string;
-};

package/dist/src/configure-args.js

@@ -1,23 +0,0 @@
-import { resolve } from "node:path";
-export function parseBrowserExtensionSetupArgs(args, cwd) {
-    if (args[0] !== "setup")
-        throw new Error("SETUP_COMMAND_REQUIRED");
-    let workspaceRoot = resolve(cwd);
-    for (let index = 1; index < args.length; index += 1) {
-        const value = args[index];
-        if (value === "--workspace") {
-            const workspace = args[index + 1];
-            if (!workspace || workspace.startsWith("--")) {
-                throw new Error("MISSING_WORKSPACE_VALUE");
-            }
-            workspaceRoot = resolve(workspace);
-            index += 1;
-            continue;
-        }
-        if (value?.startsWith("--")) {
-            throw new Error(`UNSUPPORTED_SETUP_OPTION:${value}`);
-        }
-        throw new Error(`UNSUPPORTED_SETUP_STEP:${value}`);
-    }
-    return { workspaceRoot };
-}

package/dist/src/configure.d.ts

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

package/dist/src/configure.js

@@ -1,78 +0,0 @@
-#!/usr/bin/env node
-import { readFile } from "node:fs/promises";
-import { resolve } from "node:path";
-import { behaviorAdapter, materializeProductionConfig, } from "../deployment/adapter.js";
-import { parseBrowserExtensionSetupArgs } from "./configure-args.js";
-import { browserExtensionSetupFailureMessage, browserExtensionSetupSuccessMessage, runInteractiveBrowserExtensionSetup, } from "./install-workflow.js";
-function reportFatal(error) {
-    process.stderr.write(browserExtensionSetupFailureMessage(error));
-    process.exitCode = 1;
-}
-process.on("uncaughtException", reportFatal);
-process.on("unhandledRejection", reportFatal);
-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 args = process.argv.slice(2);
-    if (args.includes("--json"))
-        throw new Error("不支持的选项 --json");
-    const option = (name) => {
-        const index = args.indexOf(name);
-        return index >= 0 ? args[index + 1] : undefined;
-    };
-    const workspaceRoot = option("--workspace")
-        ? resolve(option("--workspace"))
-        : process.cwd();
-    if (args[0] === "setup") {
-        const setup = parseBrowserExtensionSetupArgs(args, process.cwd());
-        await runInteractiveBrowserExtensionSetup({
-            workspaceRoot: setup.workspaceRoot,
-            timeoutMs: 120_000,
-        });
-        process.stdout.write(browserExtensionSetupSuccessMessage());
-        return;
-    }
-    if (args[0] === "verify") {
-        const result = await behaviorAdapter.status({ workspaceRoot });
-        process.stdout.write(result.result.data.setupStatus === "READY"
-            ? "验证通过。\n"
-            : "验证未通过：扩展尚未就绪。\n");
-        if (result.result.data.setupStatus !== "READY")
-            process.exitCode = 1;
-        return;
-    }
-    const legacyWorkspaceRoot = workspaceFromArgs(args);
-    const result = await materializeBrowserExtensionConfig(legacyWorkspaceRoot);
-    process.stdout.write(`浏览器扩展配置已生成：${result.loadDir}\n`);
-}
-if (import.meta.main)
-    await main();