@tomflow/proflow-execution-browser-extension 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @tomflow/proflow-execution-browser-extension
+
+## 0.1.7
+
+### Patch Changes
+
+- Replace JSON terminal protocols with typed CLI outcomes, add real-time Chinese progress and lifecycle summaries, publish DOCS content, standardize executable setup plans and package-owned setup commands, and preserve only user-owned pnpm policy during uninstall.
+
+## 0.1.6
+
+### Patch Changes
+
+- Align all Modules to the seven-command setup contract with executable package-owned setup guidance and full Platform setup aggregation.

package/SETUP.md

@@ -1,7 +1,10 @@
 # @tomflow/proflow-execution-browser-extension — Module Setup
 
-After Module.install materializes the deployment directory and deterministic local configuration, load the unpacked extension in Chrome when requested. Confirm the real extension Service Worker is running, then rerun Module.setup so it can re-observe Chrome reality and record evidence. Endpoints, tokens and evidence paths are not user configuration.
+## STEP-EXECUTION-BROWSER-EXTENSION-01 — 加载并验证 Chrome 扩展
 
-## Completion
-
-Setup is complete only when the Module's own `status` reports `setupStatus=READY`. Re-running setup must re-observe reality; it must not resume from a blind historical step index.
+Responsible: USER
+Interactive executable: `proflow-execution-browser-extension setup`
+Non-interactive executable: `proflow-execution-browser-extension setup --extension-id <id>`
+Required inputs: Chrome Extension ID
+Verify: `proflow-execution-browser-extension verify`
+Success condition: `execution-browser-extension.setupStatus=READY`.

package/dist/deployment/adapter.d.ts

@@ -14,7 +14,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.5";
+            moduleVersion: "0.1.7";
             data: {
                 loadDir: string;
             };
@@ -27,7 +27,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.5";
+            readonly moduleVersion: "0.1.7";
         };
         observedEffects: never[];
     }>;
@@ -37,7 +37,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.5";
+            moduleVersion: "0.1.7";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "RUNNING" | "STOPPED";
@@ -49,7 +49,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.5";
+            moduleVersion: "0.1.7";
             ok: false;
             status: "FAILED";
             error: {
@@ -57,15 +57,50 @@ export declare const behaviorAdapter: {
                 message: string;
                 retryable: boolean;
             };
+            data: {
+                readonly steps: readonly [{
+                    readonly id: "STEP-EXECUTION-BROWSER-EXTENSION-02";
+                    readonly title: "修复扩展配置";
+                    readonly state: "BLOCKED";
+                    readonly responsible: "EXTERNAL";
+                    readonly execution: {
+                        readonly interactive: "proflow-execution-browser-extension setup";
+                        readonly nonInteractive: "proflow-execution-browser-extension setup --extension-id <id>";
+                    };
+                    readonly requiredInputs: readonly [];
+                    readonly verify: "proflow-execution-browser-extension verify";
+                    readonly successCondition: "配置状态变为“已就绪”";
+                    readonly blockedReason: "Extension ID 或生成配置无效";
+                }];
+            };
         };
         observedEffects: never[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.5";
+            moduleVersion: "0.1.7";
             ok: false;
             status: "ACTION_REQUIRED";
+            data: {
+                readonly steps: readonly [{
+                    readonly id: "STEP-EXECUTION-BROWSER-EXTENSION-01";
+                    readonly title: "加载 Chrome 扩展";
+                    readonly state: "TODO";
+                    readonly responsible: "USER";
+                    readonly execution: {
+                        readonly interactive: "proflow-execution-browser-extension setup";
+                        readonly nonInteractive: "proflow-execution-browser-extension setup --extension-id <id>";
+                    };
+                    readonly requiredInputs: readonly [{
+                        readonly name: "extensionId";
+                        readonly description: "Chrome Extension ID";
+                        readonly sensitive: false;
+                    }];
+                    readonly verify: "proflow-execution-browser-extension verify";
+                    readonly successCondition: "配置状态变为“已就绪”";
+                }];
+            };
             actionRequired: {
                 action: string;
                 description: string;
@@ -78,7 +113,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.5";
+            readonly moduleVersion: "0.1.7";
         };
         observedEffects: string[];
     }>;
@@ -88,10 +123,9 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.5";
+            moduleVersion: "0.1.7";
             data: {
                 docs: string;
-                setup: string;
             };
         };
         observedEffects: never[];
@@ -102,11 +136,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.5";
+            readonly moduleVersion: "0.1.7";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.5";
+            moduleVersion: "0.1.7";
             ok: false;
             status: "FAILED";
             error: {
@@ -123,7 +157,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.5";
+            readonly moduleVersion: "0.1.7";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -10,6 +11,47 @@ const base = {
     moduleRef: descriptor.moduleRef,
     moduleVersion: descriptor.moduleVersion,
 };
+const setupPlan = {
+    steps: [
+        {
+            id: "STEP-EXECUTION-BROWSER-EXTENSION-01",
+            title: "加载 Chrome 扩展",
+            state: "TODO",
+            responsible: "USER",
+            execution: {
+                interactive: "proflow-execution-browser-extension setup",
+                nonInteractive: "proflow-execution-browser-extension setup --extension-id <id>",
+            },
+            requiredInputs: [
+                {
+                    name: "extensionId",
+                    description: "Chrome Extension ID",
+                    sensitive: false,
+                },
+            ],
+            verify: "proflow-execution-browser-extension verify",
+            successCondition: "配置状态变为“已就绪”",
+        },
+    ],
+};
+const blockedSetupPlan = {
+    steps: [
+        {
+            id: "STEP-EXECUTION-BROWSER-EXTENSION-02",
+            title: "修复扩展配置",
+            state: "BLOCKED",
+            responsible: "EXTERNAL",
+            execution: {
+                interactive: "proflow-execution-browser-extension setup",
+                nonInteractive: "proflow-execution-browser-extension setup --extension-id <id>",
+            },
+            requiredInputs: [],
+            verify: "proflow-execution-browser-extension verify",
+            successCondition: "配置状态变为“已就绪”",
+            blockedReason: "Extension ID 或生成配置无效",
+        },
+    ],
+};
 const factString = (facts, name) => (typeof facts?.[name] === "string" ? String(facts[name]) : undefined);
 function packageRoot() {
     const candidate = dirname(dirname(fileURLToPath(import.meta.url)));
@@ -223,7 +265,10 @@ export const behaviorAdapter = {
         if (supplied.extensionId) {
             if (!/^[a-z]{32}$/.test(supplied.extensionId))
                 return {
-                    result: failed("SETUP_FAILED", "extensionId must be a canonical 32-character Chromium extension id", false),
+                    result: {
+                        ...failed("SETUP_FAILED", "extensionId must be a canonical 32-character Chromium extension id", false),
+                        data: blockedSetupPlan,
+                    },
                     observedEffects: [],
                 };
             setup = { extensionId: supplied.extensionId };
@@ -235,9 +280,10 @@ export const behaviorAdapter = {
                     ...base,
                     ok: false,
                     status: "ACTION_REQUIRED",
+                    data: setupPlan,
                     actionRequired: {
                         action: "load-unpacked-extension",
-                        description: `Load ${browserExtensionLoadDir(context.workspaceRoot)} in Chrome, copy its extensionId, then rerun Module.setup with extensionId.`,
+                        description: `Load ${browserExtensionLoadDir(context.workspaceRoot)} in Chrome, copy its extensionId, then run proflow-execution-browser-extension setup --extension-id <id>.`,
                     },
                 },
                 observedEffects: [],
@@ -247,9 +293,12 @@ export const behaviorAdapter = {
         }
         catch (error) {
             return {
-                result: failed("SETUP_FAILED", error instanceof Error
-                    ? error.message
-                    : "browser extension config materialization failed"),
+                result: {
+                    ...failed("SETUP_FAILED", error instanceof Error
+                        ? error.message
+                        : "browser extension config materialization failed"),
+                    data: blockedSetupPlan,
+                },
                 observedEffects: [],
             };
         }
@@ -273,16 +322,22 @@ export const behaviorAdapter = {
                 ...base,
                 ok: false,
                 status: "ACTION_REQUIRED",
+                data: setupPlan,
                 actionRequired: {
                     action: "reload-and-verify-extension",
-                    description: "Reload the unpacked extension after runtime config materialization, confirm its MV3 service worker is RUNNING, then rerun Module.setup with serviceWorker=RUNNING.",
+                    description: "Reload the unpacked extension, confirm its MV3 service worker is RUNNING, then rerun proflow-execution-browser-extension setup --extension-id <id>.",
                 },
             },
             observedEffects: [],
         };
     },
     docs: async (_context) => ({
-        result: { ...base, data: { docs: "DOCS.md", setup: "SETUP.md" } },
+        result: {
+            ...base,
+            data: {
+                docs: readFileSync(new URL("../DOCS.md", import.meta.url), "utf8"),
+            },
+        },
         observedEffects: [],
     }),
     start: async (context) => {

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

package/dist/src/configure.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
-import { materializeProductionConfig } from "../deployment/adapter.js";
+import { createInterface } from "node:readline/promises";
+import { behaviorAdapter, 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]");
@@ -34,9 +35,55 @@ export async function materializeBrowserExtensionConfig(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`);
+    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") {
+        let extensionId = option("--extension-id");
+        if (!extensionId && !process.stdin.isTTY)
+            throw new Error("非交互环境必须提供 --extension-id");
+        if (!extensionId) {
+            const prompt = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                extensionId = await prompt.question("Chrome Extension ID（32 位小写字母）：");
+            }
+            finally {
+                prompt.close();
+            }
+        }
+        const result = await behaviorAdapter.setup({
+            workspaceRoot,
+            input: { extensionId, serviceWorker: "RUNNING" },
+        });
+        process.stdout.write(result.result.status === "SUCCEEDED"
+            ? "浏览器扩展配置与运行证据已保存。\n"
+            : "浏览器扩展尚未就绪。\n");
+        if (result.result.status === "FAILED")
+            process.exitCode = 1;
+        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();

package/manifest.json

@@ -1,7 +1,7 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.5",
+	"version": "0.1.7",
 	"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.5",
+  "version": "0.1.7",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -26,12 +26,12 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-contracts": "^0.1.4",
-    "@tomflow/proflow-module-contract": "^0.1.4"
+    "@tomflow/proflow-module-contract": "^0.1.8",
+    "@tomflow/proflow-execution-contracts": "^0.1.6"
   },
   "devDependencies": {
-    "@tomflow/proflow-execution-runtime": "^0.1.7",
-    "@tomflow/proflow-deployment-conformance": "^0.1.4"
+    "@tomflow/proflow-deployment-conformance": "^0.1.6",
+    "@tomflow/proflow-execution-runtime": "^0.1.9"
   },
   "keywords": [
     "proflow",

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.5",
+	"moduleVersion": "0.1.7",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",