@tomflow/proflow-platform-cli 0.1.36 → 0.1.37

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-platform-cli
 
+## 0.1.37
+
+### Patch Changes
+
+- Ship the Phase 3 browser, tunnel, model automation, platform readiness, and documentation closure as one verifiable platform snapshot.
+
 ## 0.1.36
 
 ### Patch Changes

package/README.md

@@ -32,7 +32,7 @@ Platform does not interpret Module-private configuration or recreate a cross-Mod
 
 ## Install / Uninstall
 
-`platform install` validates or creates the minimal Workspace metadata, discovers the complete governed package set from the Registry, synchronizes that set, validates the installed descriptors, then invokes `Module.install` in dependency order. It does not perform human setup work.
+`platform install` validates or creates the minimal Workspace metadata, discovers the complete governed package set from the Registry, synchronizes that set, validates the installed descriptors, then invokes `Module.install` in the frozen Deployment Install Order. This product deployment order is distinct from Runtime dependency topology: Chrome is first, followed by Browser Extension, Agent packages, Gateway/Tunnel, runtime/data foundations and governance packages. It does not perform human setup work.
 
 `platform uninstall` invokes `Module.uninstall` in reverse dependency order before package removal. `.proflow` is Workspace/user data and is preserved unless an owning Module explicitly removes its own artifacts.
 

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.36";
+            readonly moduleVersion: "0.1.37";
         };
         observedEffects: never[];
     }>;
@@ -16,7 +16,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.36";
+            readonly moduleVersion: "0.1.37";
         };
         observedEffects: never[];
     }>;
@@ -26,7 +26,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.36";
+            moduleVersion: "0.1.37";
             data: {
                 readonly setupStatus: "READY";
                 readonly runtimeStatus: "NOT_APPLICABLE";
@@ -40,7 +40,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.36";
+            readonly moduleVersion: "0.1.37";
         };
         observedEffects: never[];
     }>;
@@ -50,7 +50,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.36";
+            moduleVersion: "0.1.37";
             data: {
                 docs: string;
             };
@@ -63,7 +63,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.36";
+            readonly moduleVersion: "0.1.37";
         };
         observedEffects: never[];
     }>;
@@ -73,7 +73,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.36";
+            readonly moduleVersion: "0.1.37";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "platform-cli";
     readonly packageName: "@tomflow/proflow-platform-cli";
-    readonly moduleVersion: "0.1.36";
+    readonly moduleVersion: "0.1.37";
     readonly kind: "cli";
     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: "platform-cli",
     packageName: "@tomflow/proflow-platform-cli",
-    moduleVersion: "0.1.36",
+    moduleVersion: "0.1.37",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/cli.js

@@ -604,10 +604,10 @@ function renderStatus(data, theme) {
     };
     compact("运行中", running, "●");
     compact("已就绪", healthy, "○");
-    const ready = modules.filter((item) => item.setupStatus === "READY").length;
-    const action = modules.filter((item) => item.setupStatus === "ACTION_REQUIRED").length;
-    const failed = modules.filter((item) => item.setupStatus === "FAILED").length;
-    const blocked = modules.filter((item) => item.setupStatus === "BLOCKED").length;
+    const ready = healthy.length + running.length;
+    const action = modules.filter((item) => item.setupStatus === "ACTION_REQUIRED" && item.runtimeStatus !== "FAILED").length;
+    const failed = failedModules.length;
+    const blocked = modules.filter((item) => item.setupStatus === "BLOCKED" && item.runtimeStatus !== "FAILED").length;
     lines.push(theme.section("汇总"), `${theme.success(`${ready} 已就绪`)} · ${theme.warning(`${action} 需要操作`)} · ${theme.info(`${blocked} 等待依赖`)} · ${failed > 0 ? theme.failure(`${failed} 失败`) : `${failed} 失败`}`);
     return lines.join("\n");
 }
@@ -653,36 +653,36 @@ function renderDocs(data, theme) {
 }
 const setupCommands = {
     "chatgpt-carrier": {
-        ai: "pnpm exec -- proflow-chatgpt-carrier setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "pnpm exec -- proflow-chatgpt-carrier setup",
+        inputs: "无",
     },
     "dev-tunnel": {
-        ai: "pnpm exec -- proflow-dev-tunnel setup --tunnel-id <id> --public-base-url <url>",
-        inputs: "Tunnel ID、公开 HTTPS URL",
+        ai: "pnpm exec -- proflow-dev-tunnel setup",
+        inputs: "无",
     },
     "model-provider-api": {
-        ai: "pnpm exec -- proflow-model-provider-api setup --provider-base-url <url>",
-        inputs: "模型服务 Base URL",
+        ai: "pnpm exec -- proflow-model-provider-api setup",
+        inputs: "无（等待 Deployment resolver 提供 endpoint）",
     },
     "model-runtime": {
-        ai: "pnpm exec -- proflow-model-runtime setup --fast-model <id> --reason-model <id>",
-        inputs: "FAST 模型 ID、REASON 模型 ID",
+        ai: "pnpm exec -- proflow-model-runtime setup",
+        inputs: "无（仅等价合格候选歧义时选择）",
     },
     "execution-browser-extension": {
-        ai: "pnpm exec -- proflow-execution-browser-extension setup --extension-id <id>",
-        inputs: "Chrome Extension ID",
+        ai: "pnpm exec -- proflow-execution-browser-extension setup",
+        inputs: "无",
     },
     "agent-controller-dev": {
-        ai: "pnpm exec -- proflow-agent-controller-dev setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "pnpm exec -- proflow-agent-controller-dev setup",
+        inputs: "无",
     },
     "agent-product": {
-        ai: "pnpm exec -- proflow-agent-product setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "pnpm exec -- proflow-agent-product setup",
+        inputs: "无",
     },
     "agent-test-ops": {
-        ai: "pnpm exec -- proflow-agent-test-ops setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "pnpm exec -- proflow-agent-test-ops setup",
+        inputs: "无",
     },
 };
 function renderSetup(data, theme) {
@@ -693,10 +693,12 @@ function renderSetup(data, theme) {
     let ready = skipped.filter((item) => isRecord(item) && item.reason === "READY").length;
     let needsAction = 0;
     let blocked = 0;
+    const renderedModuleRefs = new Set();
     for (const raw of data.results) {
         if (!isRecord(raw) || !isRecord(raw.result))
             continue;
         const moduleRef = String(raw.moduleRef ?? raw.result.moduleRef ?? "unknown");
+        renderedModuleRefs.add(moduleRef);
         const status = String(raw.result.status ?? "UNKNOWN");
         if (status === "SUCCEEDED") {
             ready += 1;
@@ -759,6 +761,16 @@ function renderSetup(data, theme) {
         }
         lines.push("");
     }
+    const dependencyBlockers = Array.isArray(data.blockers)
+        ? data.blockers.filter(isRecord)
+        : [];
+    for (const item of dependencyBlockers) {
+        const moduleRef = String(item.moduleRef ?? "unknown");
+        if (renderedModuleRefs.has(moduleRef))
+            continue;
+        blocked += 1;
+        lines.push(`${theme.info("◇")} ${theme.section(moduleRef)}`, `  原因：${typeof item.reason === "string" ? item.reason : "等待上游 Module 就绪"}`, `  下一步：${theme.command(typeof item.nextCommand === "string" ? item.nextCommand : `platform setup --module ${moduleRef}`)}`, "");
+    }
     if (needsAction === 0 && blocked === 0)
         lines.push("全部模块均已就绪。");
     lines.push(theme.section("汇总"), `汇总：${theme.success(`${ready} 个已就绪`)}，${theme.warning(`${needsAction} 个需要操作`)}，${blocked > 0 ? theme.failure(`${blocked} 个系统阻塞`) : `${blocked} 个系统阻塞`}`);
@@ -830,7 +842,6 @@ function renderHelp(theme, command) {
         theme.section("人工配置示例"),
         `  人工：${theme.command("pnpm exec -- proflow-chatgpt-carrier setup")}`,
         `  AI：  ${theme.command("pnpm exec -- proflow-chatgpt-carrier setup")}`,
-        `        ${theme.command("--carrier-url <url>")}`,
         "",
         theme.section("状态图例"),
         `  ${theme.success("已就绪")}    配置与验证完成`,

package/dist/src/deployment-order.d.ts

@@ -0,0 +1,2 @@
+export declare const FROZEN_DEPLOYMENT_INSTALL_ORDER: readonly ["chrome-runtime", "execution-browser-extension", "agent-controller-dev", "agent-product", "agent-test-ops", "agent-gateway", "dev-tunnel", "agent-runtime", "platform-host", "execution-runtime", "execution-local", "model-provider-api", "model-runtime", "task-orchestration", "task-store-sqlite", "task-migration-runner", "execution-contracts", "model-contracts", "module-contract", "module-skill", "module-template", "deployment-conformance", "platform-cli", "chatgpt-carrier"];
+export declare function orderModuleRefsForInstall(moduleRefs: readonly string[]): string[];

package/dist/src/deployment-order.js

@@ -0,0 +1,40 @@
+export const FROZEN_DEPLOYMENT_INSTALL_ORDER = [
+    "chrome-runtime",
+    "execution-browser-extension",
+    "agent-controller-dev",
+    "agent-product",
+    "agent-test-ops",
+    "agent-gateway",
+    "dev-tunnel",
+    "agent-runtime",
+    "platform-host",
+    "execution-runtime",
+    "execution-local",
+    "model-provider-api",
+    "model-runtime",
+    "task-orchestration",
+    "task-store-sqlite",
+    "task-migration-runner",
+    "execution-contracts",
+    "model-contracts",
+    "module-contract",
+    "module-skill",
+    "module-template",
+    "deployment-conformance",
+    "platform-cli",
+    "chatgpt-carrier",
+];
+const installRank = new Map(FROZEN_DEPLOYMENT_INSTALL_ORDER.map((moduleRef, index) => [moduleRef, index]));
+export function orderModuleRefsForInstall(moduleRefs) {
+    return [...moduleRefs].sort((left, right) => {
+        const leftRank = installRank.get(left);
+        const rightRank = installRank.get(right);
+        if (leftRank !== undefined && rightRank !== undefined)
+            return leftRank - rightRank;
+        if (leftRank !== undefined)
+            return -1;
+        if (rightRank !== undefined)
+            return 1;
+        return left.localeCompare(right);
+    });
+}

package/dist/src/lifecycle/thin.js

@@ -1,4 +1,5 @@
 import { moduleStatusObservationSchema, } from "@tomflow/proflow-module-contract";
+import { orderModuleRefsForInstall } from "../deployment-order.js";
 import { PlatformError } from "../errors.js";
 import { buildDependencyGraph } from "../graph/graph.js";
 import { reportProgress } from "../progress.js";
@@ -13,6 +14,16 @@ function ordered(modules, reverse = false) {
         .map((ref) => byRef.get(ref))
         .filter((item) => item !== undefined);
 }
+function orderedForInstall(modules) {
+    // Keep dependency validation, but do not let dependency depth/alphabetical order
+    // dictate the user-facing package installation trajectory.
+    buildDependencyGraph(modules);
+    const refs = orderModuleRefsForInstall(modules.map((module) => module.moduleRef));
+    const byRef = new Map(modules.map((module) => [module.moduleRef, module]));
+    return refs
+        .map((ref) => byRef.get(ref))
+        .filter((item) => item !== undefined);
+}
 export async function observeStatuses(catalog, modules, workspaceRoot, reporter) {
     const results = [];
     const modulesInOrder = [...modules].sort((a, b) => a.moduleRef.localeCompare(b.moduleRef));
@@ -69,7 +80,9 @@ export async function observeDocs(catalog, modules, workspaceRoot, reporter) {
 }
 async function runOrdered(catalog, modules, workspaceRoot, command, reverse, reporter) {
     const results = [];
-    const modulesInOrder = ordered(modules, reverse);
+    const modulesInOrder = command === "install"
+        ? orderedForInstall(modules)
+        : ordered(modules, reverse);
     for (const [index, module] of modulesInOrder.entries()) {
         reportProgress(reporter, {
             command,
@@ -162,12 +175,37 @@ export async function stopModulesThin(catalog, modules, workspaceRoot, reporter)
 export async function setupModulesThin(catalog, modules, workspaceRoot, target, reporter) {
     const results = [];
     const skipped = [];
-    let matched = target === undefined;
+    const blockers = [];
+    const graph = buildDependencyGraph(modules);
+    const byRef = new Map(modules.map((module) => [module.moduleRef, module]));
+    const dependenciesByRef = new Map();
+    for (const edge of graph.edges) {
+        const dependencies = dependenciesByRef.get(edge.from) ?? [];
+        dependencies.push(edge.to);
+        dependenciesByRef.set(edge.from, dependencies);
+    }
+    if (target !== undefined && !byRef.has(target.moduleRef))
+        throw new PlatformError("INVALID_REQUEST", `setup target module ${target.moduleRef} was not discovered`);
+    const visitedRefs = new Set();
+    const includeWithDependencies = (moduleRef) => {
+        if (visitedRefs.has(moduleRef))
+            return;
+        visitedRefs.add(moduleRef);
+        for (const dependency of dependenciesByRef.get(moduleRef) ?? [])
+            includeWithDependencies(dependency);
+    };
+    if (target !== undefined)
+        includeWithDependencies(target.moduleRef);
+    else
+        for (const moduleRef of graph.order)
+            visitedRefs.add(moduleRef);
+    const modulesInOrder = graph.order
+        .filter((moduleRef) => visitedRefs.has(moduleRef))
+        .map((moduleRef) => byRef.get(moduleRef))
+        .filter((module) => module !== undefined);
+    const setupStatusByRef = new Map();
     let completed = true;
-    const modulesInOrder = ordered(modules);
     for (const [index, module] of modulesInOrder.entries()) {
-        if (target !== undefined && module.moduleRef !== target.moduleRef)
-            continue;
         reportProgress(reporter, {
             command: "setup",
             phase: "setup",
@@ -177,17 +215,20 @@ export async function setupModulesThin(catalog, modules, workspaceRoot, target,
             status: "STARTED",
             message: module.moduleRef,
         });
-        matched = true;
         const status = await dispatchModuleCommand(catalog, module, "status", context(workspaceRoot));
         if (!succeeded(status.result)) {
             results.push(status);
+            setupStatusByRef.set(module.moduleRef, "FAILED");
             completed = false;
-            if (target !== undefined)
+            if (target?.moduleRef === module.moduleRef)
                 break;
             continue;
         }
         const observed = moduleStatusObservationSchema.parse(status.result.data);
-        if (observed.setupStatus === "READY" && target?.input === undefined) {
+        setupStatusByRef.set(module.moduleRef, observed.setupStatus);
+        if (target !== undefined && module.moduleRef !== target.moduleRef)
+            continue;
+        if (observed.setupStatus === "READY" && target === undefined) {
             skipped.push({ moduleRef: module.moduleRef, reason: "READY" });
             reportProgress(reporter, {
                 command: "setup",
@@ -200,6 +241,29 @@ export async function setupModulesThin(catalog, modules, workspaceRoot, target,
             });
             continue;
         }
+        const unavailableDependencies = (dependenciesByRef.get(module.moduleRef) ?? []).filter((moduleRef) => setupStatusByRef.get(moduleRef) !== "READY");
+        if (unavailableDependencies.length > 0) {
+            const first = unavailableDependencies[0];
+            blockers.push({
+                moduleRef: module.moduleRef,
+                setupStatus: "BLOCKED",
+                reason: `等待依赖模块就绪：${unavailableDependencies.join(", ")}`,
+                nextCommand: `platform setup --module ${first}`,
+            });
+            completed = false;
+            reportProgress(reporter, {
+                command: "setup",
+                phase: "setup",
+                current: index + 1,
+                total: modulesInOrder.length,
+                moduleRef: module.moduleRef,
+                status: "SKIPPED",
+                message: `${module.moduleRef} 等待 ${unavailableDependencies.join(", ")}`,
+            });
+            if (target !== undefined)
+                break;
+            continue;
+        }
         const setup = await dispatchModuleCommand(catalog, module, "setup", context(workspaceRoot, target?.input));
         results.push(setup);
         reportProgress(reporter, {
@@ -217,13 +281,25 @@ export async function setupModulesThin(catalog, modules, workspaceRoot, target,
         });
         if (!succeeded(setup.result)) {
             completed = false;
-            if (target !== undefined)
-                break;
         }
+        const reconciled = await dispatchModuleCommand(catalog, module, "status", context(workspaceRoot));
+        if (succeeded(reconciled.result))
+            setupStatusByRef.set(module.moduleRef, moduleStatusObservationSchema.parse(reconciled.result.data).setupStatus);
+        else {
+            results.push(reconciled);
+            setupStatusByRef.set(module.moduleRef, "FAILED");
+            completed = false;
+        }
+        if (target !== undefined && !succeeded(setup.result))
+            break;
     }
-    if (!matched)
-        throw new PlatformError("INVALID_REQUEST", `setup target module ${target?.moduleRef ?? ""} was not discovered`);
-    return { phase: "setup", results, completed, skipped };
+    return {
+        phase: "setup",
+        results,
+        completed,
+        ...(blockers[0] ? { blockedBy: blockers[0], blockers } : {}),
+        skipped,
+    };
 }
 export async function startModulesThin(catalog, modules, workspaceRoot, reporter) {
     const results = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-platform-cli",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -24,11 +24,11 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.12"
+    "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.10",
-    "@tomflow/proflow-module-template": "^0.1.9"
+    "@tomflow/proflow-module-template": "^0.1.10",
+    "@tomflow/proflow-deployment-conformance": "^0.1.11"
   },
   "description": "Thin Platform CLI for Module discovery, documentation, package synchronization and lifecycle orchestration.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "platform-cli",
 	"packageName": "@tomflow/proflow-platform-cli",
-	"moduleVersion": "0.1.36",
+	"moduleVersion": "0.1.37",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",