@tomflow/proflow-platform-cli 0.1.36 → 0.1.38

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-platform-cli
 
+## 0.1.38
+
+### 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.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.38";
         };
         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.38";
         };
         observedEffects: never[];
     }>;
@@ -26,7 +26,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.36";
+            moduleVersion: "0.1.38";
             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.38";
         };
         observedEffects: never[];
     }>;
@@ -50,7 +50,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.36";
+            moduleVersion: "0.1.38";
             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.38";
         };
         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.38";
         };
         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.38";
     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.38",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/cli.js

@@ -158,6 +158,9 @@ async function handleStatus(root, runtime) {
             ...(parsed.data.issues === undefined
                 ? {}
                 : { issues: parsed.data.issues }),
+            ...(item.externalAvailabilityClaim === undefined
+                ? {}
+                : { externalAvailabilityClaim: item.externalAvailabilityClaim }),
         };
     });
     reportProgress(runtime.onProgress, {
@@ -558,9 +561,17 @@ function renderStatus(data, theme) {
         NOT_APPLICABLE: "无独立进程",
     };
     const modules = data.modules.filter(isRecord);
+    const productOrder = new Map([
+        ["execution-browser-extension", 0],
+        ["dev-tunnel", 1],
+        ["model-provider-api", 2],
+    ]);
+    const orderedProblems = (entries) => [...entries].sort((a, b) => (productOrder.get(String(a.moduleRef)) ?? 100) -
+        (productOrder.get(String(b.moduleRef)) ?? 100));
     const failedModules = modules.filter((item) => item.setupStatus === "FAILED" || item.runtimeStatus === "FAILED");
-    const actionModules = modules.filter((item) => item.setupStatus === "ACTION_REQUIRED" && item.runtimeStatus !== "FAILED");
-    const blockedModules = modules.filter((item) => item.setupStatus === "BLOCKED" && item.runtimeStatus !== "FAILED");
+    const actionModules = orderedProblems(modules.filter((item) => item.setupStatus === "ACTION_REQUIRED" &&
+        item.runtimeStatus !== "FAILED"));
+    const blockedModules = orderedProblems(modules.filter((item) => item.setupStatus === "BLOCKED" && item.runtimeStatus !== "FAILED"));
     const running = modules.filter((item) => item.setupStatus === "READY" && item.runtimeStatus === "RUNNING");
     const healthy = modules.filter((item) => item.setupStatus === "READY" &&
         item.runtimeStatus !== "RUNNING" &&
@@ -574,8 +585,11 @@ function renderStatus(data, theme) {
             const moduleRef = String(raw.moduleRef);
             const setupStatus = String(raw.setupStatus);
             const runtimeStatus = String(raw.runtimeStatus);
+            const runtimeLabel = raw.externalAvailabilityClaim === "AVAILABLE"
+                ? "外部资源可用"
+                : (runtimeLabels[runtimeStatus] ?? "未知");
             lines.push(`${tone(icon)} ${theme.section(moduleRef)}  ${theme.muted(String(raw.version))}`);
-            lines.push(`  ${tone(setupLabels[setupStatus] ?? "未知")} · ${runtimeLabels[runtimeStatus] ?? "未知"}`);
+            lines.push(`  ${tone(setupLabels[setupStatus] ?? "未知")} · ${runtimeLabel}`);
             const issues = Array.isArray(raw.issues)
                 ? raw.issues.filter(isRecord)
                 : [];
@@ -584,7 +598,8 @@ function renderStatus(data, theme) {
                 if (Array.isArray(issue.relatedModuleRefs) &&
                     issue.relatedModuleRefs.length > 0)
                     lines.push(`  依赖：${issue.relatedModuleRefs.map(String).join("、")}`);
-                lines.push(`  下一步：${theme.command(String(issue.nextCommand))}`);
+                if (setupStatus !== "BLOCKED")
+                    lines.push(`  下一步：${theme.command(String(issue.nextCommand))}`);
             }
             lines.push("");
         }
@@ -597,18 +612,20 @@ function renderStatus(data, theme) {
             return;
         lines.push(theme.section(title), "");
         for (const item of entries) {
-            const runtime = runtimeLabels[String(item.runtimeStatus)] ?? "未知";
+            const runtime = item.externalAvailabilityClaim === "AVAILABLE"
+                ? "外部资源可用"
+                : (runtimeLabels[String(item.runtimeStatus)] ?? "未知");
             lines.push(`${theme.success(symbol)} ${String(item.moduleRef).padEnd(32)} ${theme.muted(String(item.version).padEnd(9))} ${runtime}`);
         }
         lines.push("");
     };
     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;
-    lines.push(theme.section("汇总"), `${theme.success(`${ready} 已就绪`)} · ${theme.warning(`${action} 需要操作`)} · ${theme.info(`${blocked} 等待依赖`)} · ${failed > 0 ? theme.failure(`${failed} 失败`) : `${failed} 失败`}`);
+    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} 失败`} · ${running.length} 个真实进程运行中`, `PLATFORM_READY=${action === 0 && blocked === 0 && failed === 0 ? "YES" : "NO"}`);
     return lines.join("\n");
 }
 function renderTerminalMarkdown(source, theme) {
@@ -652,37 +669,33 @@ function renderDocs(data, theme) {
     return lines.join("\n");
 }
 const setupCommands = {
-    "chatgpt-carrier": {
-        ai: "pnpm exec -- proflow-chatgpt-carrier setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
-    },
     "dev-tunnel": {
-        ai: "pnpm exec -- proflow-dev-tunnel setup --tunnel-id <id> --public-base-url <url>",
-        inputs: "Tunnel ID、公开 HTTPS URL",
+        ai: "platform setup --module dev-tunnel",
+        inputs: "无",
     },
     "model-provider-api": {
-        ai: "pnpm exec -- proflow-model-provider-api setup --provider-base-url <url>",
-        inputs: "模型服务 Base URL",
+        ai: "platform setup --module model-provider-api",
+        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: "platform setup --module model-runtime",
+        inputs: "无（仅等价合格候选歧义时选择）",
     },
     "execution-browser-extension": {
-        ai: "pnpm exec -- proflow-execution-browser-extension setup --extension-id <id>",
-        inputs: "Chrome Extension ID",
+        ai: "platform setup --module execution-browser-extension",
+        inputs: "无",
     },
     "agent-controller-dev": {
-        ai: "pnpm exec -- proflow-agent-controller-dev setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "platform setup --module agent-controller-dev",
+        inputs: "无",
     },
     "agent-product": {
-        ai: "pnpm exec -- proflow-agent-product setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "platform setup --module agent-product",
+        inputs: "无",
     },
     "agent-test-ops": {
-        ai: "pnpm exec -- proflow-agent-test-ops setup --carrier-url <url>",
-        inputs: "Custom GPT URL",
+        ai: "platform setup --module agent-test-ops",
+        inputs: "无",
     },
 };
 function renderSetup(data, theme) {
@@ -693,10 +706,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;
@@ -739,13 +754,13 @@ function renderSetup(data, theme) {
         const error = raw.result.error;
         if (status !== "FAILED") {
             const commands = setupCommands[moduleRef] ?? {
-                ai: `proflow-${moduleRef} setup`,
+                ai: `platform setup --module ${moduleRef}`,
                 inputs: "按命令提示提供",
             };
-            lines.push(`  人工执行：pnpm exec -- proflow-${moduleRef} setup`);
+            lines.push(`  人工执行：${commands.ai}`);
             lines.push(`  AI 执行：${commands.ai}`);
             lines.push(`  需要输入：${commands.inputs}`);
-            lines.push(`  验证：proflow-${moduleRef} verify`);
+            lines.push("  验证：platform status");
             lines.push("  完成条件：配置状态变为“已就绪”");
         }
         else if (isRecord(error)) {
@@ -759,6 +774,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} 个系统阻塞`}`);
@@ -827,18 +852,17 @@ function renderHelp(theme, command) {
         theme.section("推荐流程"),
         `  ${theme.command("install → status → docs → setup → start → status → stop")}`,
         "",
-        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.command("platform setup")}`,
         "",
         theme.section("状态图例"),
         `  ${theme.success("已就绪")}    配置与验证完成`,
         `  ${theme.warning("需要操作")}  需要执行 setup 步骤`,
         `  ${theme.info("等待依赖")}  等待上游 Module 或外部服务`,
         `  ${theme.failure("失败")}      已确认配置或运行故障`,
-        "  运行中    服务进程正在运行",
-        "  无独立进程 该模块无需启动",
+        "  运行中      服务进程正在运行",
+        "  外部资源可用 Chrome 等外部资源已通过真实探测",
+        "  无独立进程  该模块无需启动",
         "",
         theme.section("遇到问题"),
         `  先运行 ${theme.command("platform status")}；配置问题运行 ${theme.command("platform setup")}。`,
@@ -855,24 +879,35 @@ export function renderHumanResult(result, options = {}) {
             ? result.data.blockers.filter(isRecord)
             : [];
         if (blockers.length > 0) {
+            const productOrder = new Map([
+                ["execution-browser-extension", 0],
+                ["dev-tunnel", 1],
+                ["model-provider-api", 2],
+            ]);
             const groups = [
                 { status: "FAILED", title: "失败", icon: "✕", tone: theme.failure },
                 {
                     status: "ACTION_REQUIRED",
-                    title: "需要操作",
+                    title: "当前根阻塞",
                     icon: "◆",
                     tone: theme.warning,
                 },
-                { status: "BLOCKED", title: "等待依赖", icon: "◇", tone: theme.info },
+                { status: "BLOCKED", title: "下游等待", icon: "◇", tone: theme.info },
             ];
             const lines = [theme.failure("平台未启动：存在未就绪模块"), ""];
             for (const group of groups) {
-                const entries = blockers.filter((item) => item.setupStatus === group.status);
+                const entries = blockers
+                    .filter((item) => item.setupStatus === group.status)
+                    .sort((a, b) => (productOrder.get(String(a.moduleRef)) ?? 100) -
+                    (productOrder.get(String(b.moduleRef)) ?? 100));
                 if (entries.length === 0)
                     continue;
                 lines.push(theme.section(group.title));
-                for (const item of entries)
-                    lines.push(`${group.tone(group.icon)} ${theme.section(String(item.moduleRef))}`, `  原因：${typeof item.reason === "string" ? item.reason : "模块尚未就绪"}`, `  下一步：${theme.command(typeof item.nextCommand === "string" ? item.nextCommand : `platform setup --module ${String(item.moduleRef)}`)}`);
+                for (const item of entries) {
+                    lines.push(`${group.tone(group.icon)} ${theme.section(String(item.moduleRef))}`, `  原因：${typeof item.reason === "string" ? item.reason : "模块尚未就绪"}`);
+                    if (group.status !== "BLOCKED")
+                        lines.push(`  下一步：${theme.command(typeof item.nextCommand === "string" ? item.nextCommand : `platform setup --module ${String(item.moduleRef)}`)}`);
+                }
                 lines.push("");
             }
             const readyCount = Array.isArray(result.data.results)
@@ -880,7 +915,7 @@ export function renderHumanResult(result, options = {}) {
                     isRecord(item.result) &&
                     item.result.status === "SUCCEEDED").length - blockers.length
                 : 0;
-            lines.push(theme.section("检查汇总"), `${Math.max(0, readyCount)} 已就绪 · ${blockers.length} 未就绪 · 0 个模块已启动`, `处理方式：${theme.command(`platform setup${result.workspaceRoot ? ` --workspace "${result.workspaceRoot}"` : ""}`)}`);
+            lines.push(theme.section("检查汇总"), `${Math.max(0, readyCount)} 配置已完成 · ${blockers.filter((item) => item.setupStatus === "ACTION_REQUIRED").length} 根阻塞 · ${blockers.filter((item) => item.setupStatus === "BLOCKED").length} 下游等待 · 0 个真实进程启动`, "PLATFORM_READY=NO", `处理方式：${theme.command(`platform setup${result.workspaceRoot ? ` --workspace "${result.workspaceRoot}"` : ""}`)}`);
             return lines.join("\n");
         }
     }

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"];
+export declare function orderModuleRefsForInstall(moduleRefs: readonly string[]): string[];

package/dist/src/deployment-order.js

@@ -0,0 +1,39 @@
+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",
+];
+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/dispatch.d.ts

@@ -6,5 +6,6 @@ export interface ModuleDispatchResult {
     command: ModuleManagementCommand;
     result: ModuleOperationResult;
     observedEffects: string[];
+    externalAvailabilityClaim?: "AVAILABLE" | "UNAVAILABLE";
 }
 export declare function dispatchModuleCommand(catalog: ModuleCatalog, module: ResolvedModule, command: ModuleManagementCommand, context: ModuleCommandContext): Promise<ModuleDispatchResult>;

package/dist/src/lifecycle/dispatch.js

@@ -24,6 +24,10 @@ function normalizeInvocation(raw) {
         observedEffects: Array.isArray(raw.observedEffects)
             ? raw.observedEffects.filter((item) => typeof item === "string")
             : [],
+        ...(raw.externalAvailabilityClaim === "AVAILABLE" ||
+            raw.externalAvailabilityClaim === "UNAVAILABLE"
+            ? { externalAvailabilityClaim: raw.externalAvailabilityClaim }
+            : {}),
     };
 }
 export async function dispatchModuleCommand(catalog, module, command, context) {
@@ -32,7 +36,7 @@ export async function dispatchModuleCommand(catalog, module, command, context) {
     const invoke = adapter[command];
     if (!isCommandFn(invoke))
         throw new PlatformError("COMMAND_FAILED", `module ${module.moduleRef} does not implement standard command "${command}"`);
-    const { result, observedEffects } = normalizeInvocation(await invoke(context));
+    const { result, observedEffects, externalAvailabilityClaim } = normalizeInvocation(await invoke(context));
     const parsed = moduleOperationResultSchema.safeParse(result);
     if (!parsed.success)
         throw new PlatformError("COMMAND_FAILED", `module ${module.moduleRef} "${command}" returned an invalid result: ${parsed.error.message}`);
@@ -41,5 +45,8 @@ export async function dispatchModuleCommand(catalog, module, command, context) {
         command,
         result: parsed.data,
         observedEffects,
+        ...(externalAvailabilityClaim === undefined
+            ? {}
+            : { externalAvailabilityClaim }),
     };
 }

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,18 @@ 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]));
+    if (target !== undefined && !byRef.has(target.moduleRef))
+        throw new PlatformError("INVALID_REQUEST", `setup target module ${target.moduleRef} was not discovered`);
+    const selectedRefs = new Set(target === undefined ? graph.order : [target.moduleRef]);
+    const modulesInOrder = graph.order
+        .filter((moduleRef) => selectedRefs.has(moduleRef))
+        .map((moduleRef) => byRef.get(moduleRef))
+        .filter((module) => module !== undefined);
     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 +196,16 @@ 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);
             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) {
+        if (observed.setupStatus === "READY" && target === undefined) {
             skipped.push({ moduleRef: module.moduleRef, reason: "READY" });
             reportProgress(reporter, {
                 command: "setup",
@@ -217,13 +235,38 @@ 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)) {
+            results.push(reconciled);
+            completed = false;
+        }
+        else {
+            const reconciledStatus = moduleStatusObservationSchema.parse(reconciled.result.data);
+            if (reconciledStatus.setupStatus === "BLOCKED" ||
+                reconciledStatus.setupStatus === "FAILED") {
+                const issue = reconciledStatus.issues?.find((item) => item.scope === "SETUP");
+                blockers.push({
+                    moduleRef: module.moduleRef,
+                    setupStatus: reconciledStatus.setupStatus,
+                    ...(issue === undefined
+                        ? {}
+                        : { reason: issue.message, nextCommand: issue.nextCommand }),
+                });
+                completed = false;
+            }
+        }
+        if (target !== undefined &&
+            (!succeeded(setup.result) || blockers.length > 0))
+            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/dist/src/registry/index.d.ts

@@ -1,2 +1,2 @@
 export type { NpmCommandResult, NpmCommandRunner, RegistryDiscoveryResult, RegistryModuleCandidate, RegistryRejectedPackage, } from "./npm-registry.ts";
-export { discoverRegistryModules, PRO_FLOW_PACKAGE_PREFIX, PRO_FLOW_SCOPE, resolveScopeRegistry, systemNpmRunner, } from "./npm-registry.ts";
+export { discoverRegistryModules, PRO_FLOW_PACKAGE_PREFIX, PRO_FLOW_SCOPE, RETIRED_PRO_FLOW_PACKAGES, resolveScopeRegistry, systemNpmRunner, } from "./npm-registry.ts";

package/dist/src/registry/index.js

@@ -1 +1 @@
-export { discoverRegistryModules, PRO_FLOW_PACKAGE_PREFIX, PRO_FLOW_SCOPE, resolveScopeRegistry, systemNpmRunner, } from "./npm-registry.js";
+export { discoverRegistryModules, PRO_FLOW_PACKAGE_PREFIX, PRO_FLOW_SCOPE, RETIRED_PRO_FLOW_PACKAGES, resolveScopeRegistry, systemNpmRunner, } from "./npm-registry.js";

package/dist/src/registry/npm-registry.d.ts

@@ -1,5 +1,6 @@
 export declare const PRO_FLOW_SCOPE = "@tomflow";
 export declare const PRO_FLOW_PACKAGE_PREFIX = "@tomflow/proflow-";
+export declare const RETIRED_PRO_FLOW_PACKAGES: Set<string>;
 export interface NpmCommandResult {
     stdout: string;
     stderr: string;
@@ -26,6 +27,7 @@ export interface RegistryDiscoveryResult {
     registry: string;
     candidates: RegistryModuleCandidate[];
     rejected: RegistryRejectedPackage[];
+    retired: string[];
 }
 export declare function systemNpmRunner(): NpmCommandRunner;
 export declare function resolveScopeRegistry(workspaceRoot: string, runner?: NpmCommandRunner): Promise<string>;

package/dist/src/registry/npm-registry.js

@@ -6,6 +6,9 @@ import { versionSatisfies } from "../modules.js";
 const execFileAsync = promisify(execFile);
 export const PRO_FLOW_SCOPE = "@tomflow";
 export const PRO_FLOW_PACKAGE_PREFIX = "@tomflow/proflow-";
+export const RETIRED_PRO_FLOW_PACKAGES = new Set([
+    "@tomflow/proflow-chatgpt-carrier",
+]);
 export function systemNpmRunner() {
     return {
         async run(args, cwd, timeoutMs) {
@@ -42,15 +45,17 @@ export async function discoverRegistryModules(options) {
     const names = options.packageName === undefined
         ? await searchPackageNames(options.workspaceRoot, registry, runner)
         : [validateRequestedPackageName(options.packageName)];
-    options.onSearchComplete?.(names.length);
+    const retired = names.filter((name) => RETIRED_PRO_FLOW_PACKAGES.has(name));
+    const activeNames = names.filter((name) => !RETIRED_PRO_FLOW_PACKAGES.has(name));
+    options.onSearchComplete?.(activeNames.length);
     const candidates = [];
     const rejected = [];
     let nextIndex = 0;
     let completed = 0;
     const worker = async () => {
-        while (nextIndex < names.length) {
+        while (nextIndex < activeNames.length) {
             const index = nextIndex++;
-            const packageName = names[index];
+            const packageName = activeNames[index];
             if (packageName === undefined)
                 return;
             const manifest = await viewManifest(options.workspaceRoot, registry, packageName, runner);
@@ -62,15 +67,15 @@ export async function discoverRegistryModules(options) {
             completed += 1;
             options.onPackageChecked?.({
                 current: completed,
-                total: names.length,
+                total: activeNames.length,
                 packageName,
             });
         }
     };
-    await Promise.all(Array.from({ length: Math.min(4, names.length) }, () => worker()));
+    await Promise.all(Array.from({ length: Math.min(4, activeNames.length) }, () => worker()));
     candidates.sort((left, right) => left.packageName.localeCompare(right.packageName));
     rejected.sort((left, right) => left.packageName.localeCompare(right.packageName));
-    return { registry, candidates, rejected };
+    return { registry, candidates, rejected, retired };
 }
 async function searchPackageNames(workspaceRoot, registry, runner) {
     const result = await runner.run([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-platform-cli",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "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-deployment-conformance": "^0.1.12",
+    "@tomflow/proflow-module-template": "^0.1.10"
   },
   "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.38",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",