@tomflow/proflow-execution-browser-extension 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-execution-browser-extension
 
+## 0.1.8
+
+### Patch Changes
+
+- Resolve DOCS.md from both source and built deployment adapters, prove all 24 built adapters return the published body, and announce package synchronization before the package manager blocks.
+
+## 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

package/SETUP.md

@@ -1,25 +1,10 @@
 # @tomflow/proflow-execution-browser-extension — Module Setup
 
-## Goal
-Reach `setupStatus=READY` by loading the already-materialized MV3 extension; bridge endpoints/tokens/runtime config are automatic.
-
-## Step 1 — Ask the Module for the load directory
-**Type:** automatic preparation
-**Executable:** `platform setup --module execution-browser-extension --workspace <workspace>`
-The returned action identifies the unpacked extension directory materialized by `Module.install`.
-
-## Step 2 — Load the unpacked extension
-**Type:** human Chrome action
-**Human action:** Load that directory in `chrome://extensions`, then copy the canonical 32-character extension ID.
-**Verify/commit executable:** `platform setup --module execution-browser-extension --workspace <workspace> --input '{"extensionId":"<32-char-id>"}'`
-The Module then writes runtime configuration from producer-owned shared facts.
-
-## Step 3 — Reload and verify the MV3 service worker
-**Type:** human observation + Module evidence
-**Human action:** Reload the extension and confirm its service worker is RUNNING.
-**Verify/commit executable:** `platform setup --module execution-browser-extension --workspace <workspace> --input '{"serviceWorker":"RUNNING"}'`
-
-## Step 4 — Verify completion
-**Type:** automatic verification
-**Executable:** `platform status --workspace <workspace>`
-**Success condition:** `execution-browser-extension.setupStatus=READY`.
+## STEP-EXECUTION-BROWSER-EXTENSION-01 — 加载并验证 Chrome 扩展
+
+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.6";
+            moduleVersion: "0.1.8";
             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.6";
+            readonly moduleVersion: "0.1.8";
         };
         observedEffects: never[];
     }>;
@@ -37,7 +37,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.6";
+            moduleVersion: "0.1.8";
             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.6";
+            moduleVersion: "0.1.8";
             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.6";
+            moduleVersion: "0.1.8";
             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.6";
+            readonly moduleVersion: "0.1.8";
         };
         observedEffects: string[];
     }>;
@@ -88,10 +123,9 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.6";
+            moduleVersion: "0.1.8";
             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.6";
+            readonly moduleVersion: "0.1.8";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.6";
+            moduleVersion: "0.1.8";
             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.6";
+            readonly moduleVersion: "0.1.8";
         };
         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 run platform setup --module execution-browser-extension --workspace ${JSON.stringify(context.workspaceRoot)} --input '{"extensionId":"<32-char-id>"}'.`,
+                        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, confirm its MV3 service worker is RUNNING, then run platform setup --module execution-browser-extension --workspace ${JSON.stringify(context.workspaceRoot)} --input '{"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(import.meta.url.includes("/dist/") ? "../../DOCS.md" : "../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.6";
+    readonly moduleVersion: "0.1.8";
     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.6",
+    moduleVersion: "0.1.8",
     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.6",
+	"version": "0.1.8",
 	"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.6",
+  "version": "0.1.8",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -26,12 +26,12 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.5",
-    "@tomflow/proflow-execution-contracts": "^0.1.5"
+    "@tomflow/proflow-module-contract": "^0.1.9",
+    "@tomflow/proflow-execution-contracts": "^0.1.7"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.5",
-    "@tomflow/proflow-execution-runtime": "^0.1.8"
+    "@tomflow/proflow-execution-runtime": "^0.1.10",
+    "@tomflow/proflow-deployment-conformance": "^0.1.7"
   },
   "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.6",
+	"moduleVersion": "0.1.8",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",