@metagptx/deepflow-suite-cli 0.2.11-dev.20261020.1 → 0.3.1

package/README.md

@@ -1,72 +1,66 @@
 # `@metagptx/deepflow-suite-cli`
 
-`deepflow-suite` is the published DeepFlow distribution CLI. It is intentionally
-separate from the legacy `@metagptx/deepflow-cli` package, which owns the
-`deepflow` command.
+DeepFlow ships one portable Node package containing `deepflow-suite`, five service
+CLIs and seven Skills. Node.js 22.13+ is required. Users do not need Go, Make, a
+workspace checkout, optional dependencies or an OS-specific runtime package.
 
-## Install
+## Install and check
 
 ```bash
 npm install -g @metagptx/deepflow-suite-cli
-deepflow-suite --help
-deepflow-suite install --source package
-deepflow-suite doctor --source package --json
+deepflow-suite install
+deepflow-suite doctor --json
 ```
 
-The public package includes the `deepflow-suite` entrypoint, the five service
-CLI launchers (`df-workbench`, `df-task`, `df-taskdriver`, `df-agentctrl`, and
-`df-agentrt`), and seven bundled Skills. npm automatically selects the matching
-runtime package for `darwin-arm64`, `darwin-x64`, `linux-arm64`, `linux-x64`, or
-`win32-x64`; the user does not need a DeepFlow checkout, Go, or Make.
-
-`install --source package` copies the seven Skills into `$CODEX_HOME/skills`
-(or `~/.codex/skills`) and verifies all six command launchers plus the selected
-runtime package. `doctor --source package --json` reports the same complete
-distribution check. Use `--target` to choose another Skill directory and
-`--force` only when replacing an existing installation is intentional.
-
-If npm is run with `--omit=optional`, package installation fails before changing
-the Skill directory and reports the missing platform runtime package. Reinstall
-without `--omit=optional` to obtain the four Go-backed CLIs.
-
-## Environment selection
-
-The service Skills cover `local`, `dev`, and domestic production `prod-cn`.
-Select the environment explicitly, then configure the service URL described in
-its Skill; installing the package does not select an environment or log in.
-The package release does not update deployed Runtime images, existing Session
-Skill snapshots, or Agent Control definitions.
+npm registers `deepflow-suite`, `df-workbench`, `df-task`, `df-taskdriver`,
+`df-agentctrl` and `df-agentrt` through `package.json#bin`. The installer copies
+bundled Skills to `$CODEX_HOME/skills` (or `~/.codex/skills`); `--target` chooses
+another Skill directory. Existing regular Skill directories require `--force`.
+Skills contain instructions and references; they rely on Suite-provided commands
+and do not carry CLI implementations. `--source package` remains supported and
+is the default. npm installation does not modify the user's Skill directories.
+
+`doctor` checks the installed Skill contents, all six entrypoints, their Suite
+version, and the command actually selected by PATH. It reports stale commands
+from previous installations without overwriting them. Each service CLI supports
+`--cli-version --json`, separate from Agent definition `--version` arguments.
+`npm install --ignore-scripts --omit=optional` is supported.
+
+Select local/dev/prod explicitly before service calls, then configure the URL
+and identity documented by the relevant Skill. Installation performs no login
+or service calls. CLI releases do not update services, Agent definitions or
+existing Session snapshots.
 
 ## Workspace development
 
-From the DeepFlow workspace, install relative Skill links and build the five
-service CLIs:
+CLI source belongs to each service's `cli/` directory. Suite bundles those
+sources without maintaining another client implementation. Development links
+point directly to Node entries and do not compile services:
 
 ```bash
-deepflow-suite install --source workspace --bin-dir "$HOME/.local/bin"
-deepflow-suite doctor --source workspace --json
+node tools/deepflow-cli/bin/deepflow-suite.js install --source workspace
+node tools/deepflow-cli/bin/deepflow-suite.js doctor --source workspace --json
 ```
 
-The workspace distribution contains `deepflow-suite`, `df-workbench`,
-`df-task`, `df-taskdriver`, `df-agentctrl`, `df-agentrt`, and `df-agentrt-repo`.
-The four Runtime variant Skills (`df-agentrt-full`, `df-agentrt-git`,
-`df-agentrt-ci`, and `df-agentrt-preview`) are selected by Agent definitions
-and are not part of the ordinary distribution.
+Use `--bin-dir` to choose a command directory. Replacing a different existing
+command requires `--force`. The normal Skill set is `deepflow-suite`,
+`df-workbench`, `df-task`, `df-taskdriver`, `df-agentctrl`, `df-agentrt` and
+`df-agentrt-repo`; Runtime-specific variant Skills remain separate.
 
-## Publishing
+## Build and release
 
-The package is prepared for public scoped publication like Console CLI:
+Run service CLI contract tests and Node tests, then:
 
 ```bash
-npm run test
-npm run build:runtime
-npm run check:runtime
-npm run pack:dry-run
+npm test
+npm pack
 npm publish
 ```
 
-Publish the five platform runtime packages before publishing the main package;
-all six entrypoints and platform packages must use the same version. `prepack`
-materializes the seven Skill bundle, the Workbench Node entrypoint, and the
-runtime release metadata. The published installer never overwrites an existing
-Skill or CLI file without `--force`.
+`prepack` gathers the five Node clients and seven Skills and generates release
+metadata from the npm package version. The package has no native build or
+runtime download step. Cross-platform install tests use the same npm tarball.
+Old platform packages remain available for pinned 0.2.x releases; mark them
+deprecated after the portable release is available, rather than unpublishing
+packages still referenced by older versions. The legacy `@metagptx/deepflow-cli`
+package and its `deepflow` command are a separate product entrypoint.

package/bin/deepflow-suite.js

@@ -14,7 +14,7 @@ function parseArgs(argv) {
   const [first, ...rest] = argv;
   const command = first?.startsWith("-") ? undefined : first;
   const argumentsToParse = command ? rest : argv;
-  const options = { source: "workspace", workspaceRoot: process.cwd() };
+  const options = { source: "package", workspaceRoot: process.cwd() };
   for (let index = 0; index < argumentsToParse.length; index += 1) {
     const argument = argumentsToParse[index];
     if (argument === "--source") options.source = argumentsToParse[++index];
@@ -27,14 +27,14 @@ function parseArgs(argv) {
     else if (argument === "--skip-cli") options.skipCli = true;
     else if (argument === "--json") options.json = true;
     else if (argument === "--help" || argument === "-h") options.help = true;
-    else if (argument === "--version" || argument === "-v") options.version = true;
+    else if (argument === "--version" || argument === "--cli-version" || argument === "-v") options.version = true;
     else throw new Error(`unknown option: ${argument}`);
   }
   return { command, options };
 }
 
 function printHelp() {
-  console.log(`${CLI_NAME} — DeepFlow distribution installer\n\nCommands:\n  install --source workspace [--root <path>] [--bin-dir <path>] [--skip-cli]\n  install --source package [--target <path>] [--force]\n  install --source bundle --bundle <path> [--target <path>] [--force]\n  doctor [--root <path>] [--bin-dir <path>]\n  bundle --root <path> --output <path>\n\nUse ${CLI_NAME} --help for this message.`);
+  console.log(`${CLI_NAME} — DeepFlow distribution installer\n\nCommands:\n  install [--target <path>] [--force]  Install bundled Skills; npm provides all five CLIs\n  doctor [--json]                    Check Skills, CLI versions and PATH\n  install --source workspace [--root <path>] [--bin-dir <path>] [--skip-cli]\n  doctor --source workspace [--root <path>] [--bin-dir <path>]\n  bundle --root <path> --output <path>\n\nThe default source is package.`);
 }
 
 function output(value, json) {
@@ -47,7 +47,7 @@ const manifestPath = path.join(packageRoot, "manifest.json");
 
 if (options.version) {
   const packageJson = JSON.parse(await readFile(path.join(packageRoot, "package.json"), "utf8"));
-  console.log(packageJson.version);
+  console.log(options.json ? JSON.stringify({ name: CLI_NAME, version: packageJson.version, entry: fileURLToPath(import.meta.url) }) : packageJson.version);
   process.exit(0);
 }
 

package/bundle/deepflow-release.json

@@ -2,13 +2,13 @@
   "schemaVersion": 1,
   "distribution": "deepflow-suite",
   "package": "@metagptx/deepflow-suite-cli",
-  "version": "0.2.11-dev.20261020.1",
+  "version": "0.3.1",
   "platform": "any",
   "arch": "any",
   "cli": {
     "name": "deepflow-suite",
     "package": "@metagptx/deepflow-suite-cli",
-    "version": "0.2.11-dev.20261020.1",
+    "version": "0.3.1",
     "command": "deepflow-suite"
   },
   "skills": [
@@ -16,15 +16,10 @@
       "name": "deepflow-suite",
       "source": "tools/deepflow-cli/skills/deepflow-suite",
       "files": [
-        {
-          "path": "manifest.yaml",
-          "size": 362,
-          "sha256": "03089402b9a59b0605c582e968226f7868928043daea37d5944468d1f4b41b92"
-        },
         {
           "path": "SKILL.md",
-          "size": 3524,
-          "sha256": "8be45b44925906998ec838dcd46a74e164b8e75572523b4facc7cc5e0e1a3118"
+          "size": 4018,
+          "sha256": "ebd8b217b9ce1ca5dc50024838db41ad8afae08a2bc6d2b2cebd6cd5f46fd0b1"
         }
       ]
     },
@@ -32,15 +27,10 @@
       "name": "df-workbench",
       "source": "deepflow-workbench/skills/df-workbench",
       "files": [
-        {
-          "path": "manifest.yaml",
-          "size": 84,
-          "sha256": "e7e7697d875a49b5d3d4dd4d38fb8479d8a1fb175ab65ab6a2c79addbb171457"
-        },
         {
           "path": "SKILL.md",
-          "size": 5782,
-          "sha256": "a7df787038aa0f47a81da0c6ff28239d793e621c262c5254661009d16c9177fd"
+          "size": 6670,
+          "sha256": "f85fb71550d67a607a0507fe1259b1da753aeede5704a33035fff4f67029700e"
         }
       ]
     },
@@ -103,15 +93,10 @@
           "size": 1953,
           "sha256": "94bc4eb79b3f560b5bf0eb1cc728a1b2594dc698de02917f0ea53aea3d9c59f2"
         },
-        {
-          "path": "skill_test.go",
-          "size": 9146,
-          "sha256": "88dfe1f8104812ff1c9c8dd2c869e116a0774e0972fde7e2bd3329f0b2cd332e"
-        },
         {
           "path": "SKILL.md",
-          "size": 13099,
-          "sha256": "c83eef5901c10a4669d98ee7cf3d210a310bfef021e6aff5a3f1ec0913318ee1"
+          "size": 13393,
+          "sha256": "cd1ffc54bf884f02e540ddd4b75c805ed868e32d298d20abcecb3c8af51feb8b"
         }
       ]
     },
@@ -121,8 +106,8 @@
       "files": [
         {
           "path": "SKILL.md",
-          "size": 13261,
-          "sha256": "108ad742c99f5299a520954f994c1d969212b945881542a83a6e13d8b4def33d"
+          "size": 13523,
+          "sha256": "e336448764276e9043c7cbf0db57b66ed417be084d086ac161e42b7ca4013df7"
         }
       ]
     },
@@ -157,8 +142,8 @@
         },
         {
           "path": "SKILL.md",
-          "size": 5120,
-          "sha256": "3d4733fecf8feed798c4870356ae403b97a24214ed3c67fe8a89710640f0373e"
+          "size": 5411,
+          "sha256": "11f9127b58bfc7b6d28dfa6c0e588a9f458a9d3f9cc33aefee815d19c04327dc"
         }
       ]
     },
@@ -188,8 +173,8 @@
         },
         {
           "path": "SKILL.md",
-          "size": 10787,
-          "sha256": "a80b106dd9f2661c794eec40da955a267f20119ec9db89b112982c4d6b3f034e"
+          "size": 11934,
+          "sha256": "8710e7ec3da45b8363006bc09befa79b07e8edde4f8f46d98841b8761d1ea228"
         }
       ]
     },
@@ -199,8 +184,8 @@
       "files": [
         {
           "path": "SKILL.md",
-          "size": 3198,
-          "sha256": "1f2e9b3c3631eefc8d0bbf1a3727a0aaf64ea31647da26f22dc025ba0aae996d"
+          "size": 3492,
+          "sha256": "f04a22e7967727217003071b7ad7c9268fde9058af4e1f8d3de22e28e18ac718"
         }
       ]
     }
@@ -209,37 +194,27 @@
     {
       "name": "df-workbench",
       "project": "deepflow-workbench",
-      "install": "project",
-      "package": "@metagptx/deepflow-suite-cli",
-      "mode": "node"
+      "entry": "cli/df-workbench.mjs"
     },
     {
       "name": "df-task",
       "project": "deepflow-task",
-      "install": "make install-cli",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-task.mjs"
     },
     {
       "name": "df-taskdriver",
       "project": "deepflow-task-driver",
-      "install": "make install-cli",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-taskdriver.mjs"
     },
     {
       "name": "df-agentctrl",
       "project": "deepflow-agent-ctrl",
-      "install": "make install-cli",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-agentctrl.mjs"
     },
     {
       "name": "df-agentrt",
       "project": "deepflow-agent-runtime",
-      "install": "make build",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-agentrt.mjs"
     }
   ]
 }

package/bundle/skills/deepflow-suite/SKILL.md

@@ -5,6 +5,10 @@ description: DeepFlow 统一入口。常规任务默认使用 df-workbench；只
 
 # DeepFlow Suite
 
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
 这是 DeepFlow 的统一用户和开发者入口。它开放完整的 DeepFlow 能力，但不默认调用整条链路：普通任务先走 `df-workbench`，只有确实需要解释推进、Agent 或 Runtime 问题时才升级到其他项目 CLI。
 
 ## 依赖
@@ -22,7 +26,9 @@ description: DeepFlow 统一入口。常规任务默认使用 df-workbench；只
 
 ## 环境门禁
 
-用户没有明确说 `local`、本地、`dev`、开发环境或 `prod`、生产环境时，先询问：
+以下门禁适用于连接环境内服务。纯离线证据分析、源码审查或能力编写无需选择环境；不能借离线分析自动连接材料里引用的服务。
+
+需要连接服务、用户尚未明确说 `local`、本地、`dev`、开发环境或 `prod`、生产环境时，先询问：
 
 ```text
 请指定目标环境：local（本地）、dev（开发环境）还是 prod（生产环境）？

package/bundle/skills/df-agentctrl/SKILL.md

@@ -5,7 +5,11 @@ description: 使用df-agentctrl CLI查询DeepFlow Agent控制面的可用智能
 
 # DeepFlow Agent Control
 
-通过`df-agentctrl`操作Agent定义和版本。运行命令前确认CLI已在PATH中；服务地址由`DF_AGENTCTRL_BASE_URL`或`--base-url`提供，默认`http://127.0.0.1:8080`。本Skill不安装二进制，也不自动启动服务。
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
+通过`df-agentctrl`操作Agent定义和版本。运行命令前确认CLI已在PATH中；服务地址由`DF_AGENTCTRL_BASE_URL`或`--base-url`提供，默认`http://127.0.0.1:8080`。本 Skill 不安装 CLI，也不自动启动服务。
 
 ## 环境与可用性
 

package/bundle/skills/df-agentrt/SKILL.md

@@ -5,6 +5,10 @@ description: 在 DeepFlow Agent Runtime 里执行任务时使用。说明你所
 
 # DeepFlow Agent Runtime
 
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
 你运行在 **DeepFlow Agent Runtime** 上。这是一个把「会话 + 多轮消息 + 代码仓库」
 管起来的服务，你现在执行的是其中一轮。
 
@@ -49,6 +53,17 @@ Run 中 `df-agentrt` 只使用部署注入的 `MULTICA_SERVER_URL`，忽略 `AGE
 需要交付文件内容时，用文字描述，或者把关键片段直接贴进回复。**不要**写成本地路径链接，
 也不要写得像文件已经送到了——读的人会去找一个根本不存在的附件。
 
+## 修改已发布的普通文件
+
+用户要求修改已发布的文件时，由你判断直接覆盖原文件还是另存新文件：同一份成果的修订通常覆盖原路径，内容已是另一份交付时另存新文件名。
+
+覆盖已发布文件时：
+- 在该文件所在目录的 `改动记录.md` 末尾追加一条：时间、文件名、改了什么、为什么改；文件不存在时新建，不改写已有记录。
+- 写完后用本轮已加载的事实写入技能重新发布该文件的真实路径，让成果卡片更新到本轮。
+- 同时把 `改动记录.md` 也发布一次（ref 写它的相对路径）；用户只能从成果卡片打开它，不发布就看不到改动记录。
+
+文件仍依赖所属 Worker 工作目录，不是归档或永久可用承诺；未发布或仍在生成的文件不能宣称已交付。
+
 ## 工作目录：跨轮复用，检出是同级目录
 
 - 同一个会话的多轮**复用同一个工作目录**，上一轮留下的文件这一轮还在。

package/bundle/skills/df-agentrt-repo/SKILL.md

@@ -5,6 +5,10 @@ description: 任务进行中发现需要另一个代码仓库时使用。查看
 
 # 中途添加代码仓库
 
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
 会话创建时定下的配置里，只有**代码仓库**这一项是可以在任务进行中追加的。
 
 你可能在分析到一半时才发现答案不在手上这几个仓库里——这时不需要中断任务回报、

package/bundle/skills/df-task/SKILL.md

@@ -5,6 +5,10 @@ description: 在一次 Run 里用 df-task 读写 DeepFlow Task 事实日志 —
 
 # df-task
 
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
 `df-task` 是 DeepFlow Task 事实日志的命令行入口。Task 是一件工作的身份，它下面挂着一本**只追加**的事实日志：谁在什么时候写下了什么。**没有状态字段，也没有状态机** —— 「这件工作到哪一步了」是从这本日志里读出来的，不是查出来的。
 
 服务地址取自 `DF_TASK_BASE_URL`，默认 `http://127.0.0.1:8090`。写事实的身份取自 `DF_TASK_ACTOR_KIND` 与 `DF_TASK_ACTOR_ID`，由 runtime 在起进程时注入 —— **不要自己改这两个环境变量**，身份决定了你能写哪些事实。

package/bundle/skills/df-taskdriver/SKILL.md

@@ -5,6 +5,10 @@ description: 使用df-taskdriver CLI诊断DeepFlow任务推进器的运行状态
 
 # DeepFlow Task Driver
 
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
 通过`df-taskdriver`查看一个正在运行的driver实例。运行命令前确认CLI已在PATH中；实例地址由`DF_TASKDRIVER_BASE_URL`或`--base-url`提供，默认`http://127.0.0.1:8081`。本Skill不安装二进制，也不启动服务。
 
 ## 目标环境门禁与地址
@@ -38,7 +42,7 @@ df-taskdriver help
 df-taskdriver task <task-id>
 ```
 
-若命令不存在，说明缺少CLI部署：本项目源码可用时运行`make install-cli`，否则向调用方说明需要安装`df-taskdriver`并提供实例地址。driver的地址不是事实服务的地址，也不是runtime的地址。
+若命令不存在，说明缺少 Suite CLI 安装；向调用方说明需要安装 `@metagptx/deepflow-suite-cli` 并提供实例地址。driver的地址不是事实服务的地址，也不是runtime的地址。
 
 ## driver做什么，不做什么
 

package/bundle/skills/df-workbench/SKILL.md

@@ -5,6 +5,10 @@ description: 面向普通用户的 DeepFlow Workbench 入口。使用 df-workben
 
 # df-workbench
 
+## CLI 依赖
+
+CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
+
 `df-workbench` 是普通用户的轻量入口。它保持与 Workbench 人工操作一致：先确定当前身份和工作区，再通过 Workbench 的用户 API 创建任务和发送消息。不要直接调用数据库、`df-task` 的写接口或伪造 `DF_TASK_ACTOR_*` 身份。
 
 ## 环境和身份
@@ -36,7 +40,11 @@ df-workbench config --json
 
 `me` 返回当前用户和可访问工作区；`config` 返回认证模式、当前工作区、Task 写入能力和 Workbench UI 能力。不要打印 Token、Cookie 或其他凭据。
 
-local 环境只允许从本机回环地址访问；OIDC 环境使用 Workbench personal token。Token 应通过公司内部配置或 Skill 平台提供，不在命令参数中传递。
+local 环境只允许从本机回环地址访问，无需 Token；OIDC 环境使用 Workbench personal token。
+
+Token 获取入口：使用公司账号登录目标环境 Workbench，打开「头像 → 个人设置 → 个人 Token → 创建 Token」，填写用途名称和到期时间。完整 Token 只在创建时显示一次，将其配置为 `DF_WORKBENCH_TOKEN`；`DF_WORKBENCH_BASE_URL` 使用同一环境的 Workbench 根地址。也可通过公司内部配置或 Skill 平台的个人凭据配置提供，不在命令参数中传递，不打印凭据。
+
+列表仅显示前缀和使用状态，无法找回完整 Token；遗失、到期或不再使用时，在同一入口撤销并按需新建。独立管理员账号不支持创建个人 Token，需使用公司账号登录。网页退出不会撤销 Token。
 
 ## 用户任务流程
 
@@ -103,4 +111,4 @@ Token、工作区或服务地址配置错误。
 
 ## 缺少依赖
 
-如果 `df-workbench` CLI 或本 Skill 缺失，提示用户从公司内部 Skill 共享平台安装对应项目，不执行 `pnpm`、`go install`、`make install-cli`、`git clone` 或本地 Skill 目录复制。
+如果 CLI 或本 Skill 缺失，提示用户安装 `@metagptx/deepflow-suite-cli` 后运行 `deepflow-suite install`；Run 内不执行安装、编译或目录复制。

package/manifest.json

@@ -1,78 +1,60 @@
 {
   "distribution": "deepflow-suite",
-  "version": "0.2.11-dev.20261020.1",
   "skills": [
     {
       "name": "deepflow-suite",
-      "source": "tools/deepflow-cli/skills/deepflow-suite",
-      "packageSource": "skills/deepflow-suite"
+      "source": "tools/deepflow-cli/skills/deepflow-suite"
     },
     {
       "name": "df-workbench",
-      "source": "deepflow-workbench/skills/df-workbench",
-      "packageSource": "skills/df-workbench"
+      "source": "deepflow-workbench/skills/df-workbench"
     },
     {
       "name": "df-task",
-      "source": "deepflow-task/skills/df-task",
-      "packageSource": "skills/df-task"
+      "source": "deepflow-task/skills/df-task"
     },
     {
       "name": "df-taskdriver",
-      "source": "deepflow-task-driver/skills/df-taskdriver",
-      "packageSource": "skills/df-taskdriver"
+      "source": "deepflow-task-driver/skills/df-taskdriver"
     },
     {
       "name": "df-agentctrl",
-      "source": "deepflow-agent-ctrl/skills/df-agentctrl",
-      "packageSource": "skills/df-agentctrl"
+      "source": "deepflow-agent-ctrl/skills/df-agentctrl"
     },
     {
       "name": "df-agentrt",
-      "source": "deepflow-agent-runtime/skills/df-agentrt",
-      "packageSource": "skills/df-agentrt"
+      "source": "deepflow-agent-runtime/skills/df-agentrt"
     },
     {
       "name": "df-agentrt-repo",
-      "source": "deepflow-agent-runtime/skills/df-agentrt-repo",
-      "packageSource": "skills/df-agentrt-repo"
+      "source": "deepflow-agent-runtime/skills/df-agentrt-repo"
     }
   ],
   "clis": [
     {
       "name": "df-workbench",
       "project": "deepflow-workbench",
-      "install": "project",
-      "package": "@metagptx/deepflow-suite-cli",
-      "mode": "node"
+      "entry": "cli/df-workbench.mjs"
     },
     {
       "name": "df-task",
       "project": "deepflow-task",
-      "install": "make install-cli",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-task.mjs"
     },
     {
       "name": "df-taskdriver",
       "project": "deepflow-task-driver",
-      "install": "make install-cli",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-taskdriver.mjs"
     },
     {
       "name": "df-agentctrl",
       "project": "deepflow-agent-ctrl",
-      "install": "make install-cli",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-agentctrl.mjs"
     },
     {
       "name": "df-agentrt",
       "project": "deepflow-agent-runtime",
-      "install": "make build",
-      "package": "platform-runtime",
-      "mode": "binary"
+      "entry": "cli/df-agentrt.mjs"
     }
   ]
 }

package/package.json

@@ -1,23 +1,22 @@
 {
   "name": "@metagptx/deepflow-suite-cli",
-  "version": "0.2.11-dev.20261020.1",
+  "version": "0.3.1",
   "description": "Agent-friendly installer and distribution CLI for the DeepFlow suite.",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {
     "deepflow-suite": "bin/deepflow-suite.js",
-    "df-workbench": "bin/df-workbench.js",
-    "df-task": "bin/df-task.js",
-    "df-taskdriver": "bin/df-taskdriver.js",
-    "df-agentctrl": "bin/df-agentctrl.js",
-    "df-agentrt": "bin/df-agentrt.js"
+    "df-workbench": "runtime/df-workbench/df-workbench.mjs",
+    "df-task": "runtime/df-task/df-task.mjs",
+    "df-taskdriver": "runtime/df-taskdriver/df-taskdriver.mjs",
+    "df-agentctrl": "runtime/df-agentctrl/df-agentctrl.mjs",
+    "df-agentrt": "runtime/df-agentrt/df-agentrt.mjs"
   },
   "files": [
     "bin/",
     "bundle/",
     "manifest.json",
     "runtime/",
-    "skills/",
     "src/",
     "scripts/",
     "README.md"
@@ -25,21 +24,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "optionalDependencies": {
-    "@metagptx/deepflow-suite-cli-darwin-arm64": "0.2.11-dev.20261020.1",
-    "@metagptx/deepflow-suite-cli-darwin-x64": "0.2.11-dev.20261020.1",
-    "@metagptx/deepflow-suite-cli-linux-arm64": "0.2.11-dev.20261020.1",
-    "@metagptx/deepflow-suite-cli-linux-x64": "0.2.11-dev.20261020.1",
-    "@metagptx/deepflow-suite-cli-win32-x64": "0.2.11-dev.20261020.1"
-  },
   "engines": {
     "node": ">=22.13.0"
   },
   "scripts": {
     "test": "node --test tests/*.test.mjs",
-    "build:runtime": "node scripts/build-runtime-packages.mjs",
-    "check:runtime": "node scripts/build-runtime-packages.mjs --check",
     "prepack": "node scripts/build-package.mjs",
-    "pack:dry-run": "npm pack --dry-run"
+    "pack:dry-run": "npm pack --dry-run",
+    "build": "node scripts/build-package.mjs"
   }
 }