plan-tree 0.2.1 → 0.2.2

package/README.md

@@ -97,25 +97,39 @@ A plan is implementation-ready only when the scope, chosen approach, expected be
 
 ## Installation
 
-Install the lightweight installer from PyPI or npm, then install the skill for your provider:
+Install the lightweight installer from npm, then install the skill for your provider:
 
 ```bash
-python -m pip install seemseam-plan-tree
-plan-tree install --provider claude
+npm install -g plan-tree
+plan-tree install codex
 ```
 
+Common usage:
+
 ```bash
-npm install -g plan-tree
-plan-tree install --provider opencode
+plan-tree version
+plan-tree install claude
+plan-tree install opencode
+plan-tree install codex
+plan-tree install all
+```
+
+You can also install the same `plan-tree` command from PyPI:
+
+```bash
+python -m pip install seemseam-plan-tree
+plan-tree install claude
 ```
 
-Supported providers:
+The npm package exposes a `plan-tree` binary through its `bin` field. Install it globally when you want to run `plan-tree` directly from any shell. A local install with `npm install plan-tree` exposes the command only inside npm's local binary path, so run it with `npx plan-tree ...`, `npm exec plan-tree -- ...`, or `./node_modules/.bin/plan-tree ...`.
+
+Supported install targets:
 
 ```bash
-plan-tree install --provider claude
-plan-tree install --provider opencode
-plan-tree install --provider codex
-plan-tree install --provider all
+plan-tree install claude
+plan-tree install opencode
+plan-tree install codex
+plan-tree install all
 ```
 
 The installer copies only the skill payload: `SKILL.md`, `VERSION`, README files, `references/`, `assets/`, and Codex/OpenAI metadata when installing for Codex. It does not install `.ccb/`, git state, logs, generated artifacts, or project runtime files.
@@ -123,7 +137,7 @@ The installer copies only the skill payload: `SKILL.md`, `VERSION`, README files
 For local development or offline installation, point the installer at this repository:
 
 ```bash
-plan-tree install --provider claude --source /path/to/plan-tree
+plan-tree install claude --source /path/to/plan-tree
 ```
 
 You can also clone this repository directly into your skill directory:

package/README.zh-CN.md

@@ -97,25 +97,39 @@ A plan is implementation-ready only when the scope, chosen approach, expected be
 
 ## 安装
 
-先从 PyPI 或 npm 安装轻量 installer，再用 installer 安装 skill：
+先从 npm 安装轻量 installer，再用 installer 安装 skill：
 
 ```bash
-python -m pip install seemseam-plan-tree
-plan-tree install --provider claude
+npm install -g plan-tree
+plan-tree install codex
 ```
 
+常用命令：
+
 ```bash
-npm install -g plan-tree
-plan-tree install --provider opencode
+plan-tree version
+plan-tree install claude
+plan-tree install opencode
+plan-tree install codex
+plan-tree install all
+```
+
+也可以从 PyPI 安装同一个 `plan-tree` 命令：
+
+```bash
+python -m pip install seemseam-plan-tree
+plan-tree install claude
 ```
 
-支持的 provider：
+npm 包通过 `bin` 字段暴露 `plan-tree` 命令。想在任意 shell 里直接运行 `plan-tree`，需要全局安装。普通的 `npm install plan-tree` 只会把命令放到 npm 的本地 binary 路径里，需要用 `npx plan-tree ...`、`npm exec plan-tree -- ...` 或 `./node_modules/.bin/plan-tree ...` 调用。
+
+支持的安装目标：
 
 ```bash
-plan-tree install --provider claude
-plan-tree install --provider opencode
-plan-tree install --provider codex
-plan-tree install --provider all
+plan-tree install claude
+plan-tree install opencode
+plan-tree install codex
+plan-tree install all
 ```
 
 installer 只复制 skill payload：`SKILL.md`、`VERSION`、README 文件、`references/`、`assets/`，以及安装到 Codex 时需要的 Codex/OpenAI metadata。它不会安装 `.ccb/`、git 状态、日志、生成物或项目运行态文件。
@@ -123,7 +137,7 @@ installer 只复制 skill payload：`SKILL.md`、`VERSION`、README 文件、`re
 本地开发或离线安装时，可以显式指定当前仓库：
 
 ```bash
-plan-tree install --provider claude --source /path/to/plan-tree
+plan-tree install claude --source /path/to/plan-tree
 ```
 
 也可以直接把仓库克隆到你的 skill 目录：

package/VERSION

@@ -1 +1 @@
-0.2.1
+0.2.2

package/bin/plan-tree.js

@@ -5,8 +5,9 @@ const os = require("os");
 const path = require("path");
 const { spawnSync } = require("child_process");
 
-const PACKAGE_VERSION = "0.2.1";
+const PACKAGE_VERSION = "0.2.2";
 const REPO_URL = "https://github.com/SeemSeam/plan-tree.git";
+const README_URL = "https://github.com/SeemSeam/plan-tree#readme";
 const SKILL_NAME = "plan-tree";
 
 const CORE_FILES = ["SKILL.md", "VERSION", "README.md", "README.zh-CN.md"];
@@ -32,23 +33,30 @@ function main(argv) {
 }
 
 function usage() {
-  console.log("Use `plan-tree install --provider claude|opencode|codex`.");
+  console.log("Use `plan-tree install claude|opencode|codex|all`.");
+  console.log(`README: ${README_URL}`);
 }
 
 function parseInstallArgs(args) {
   const options = {
-    provider: "claude",
+    provider: null,
     target: null,
     source: null,
     version: PACKAGE_VERSION,
     force: false,
     dryRun: false
   };
+  let providerArg = null;
 
   for (let i = 0; i < args.length; i += 1) {
     const arg = args[i];
-    if (arg === "--provider") options.provider = requireValue(args, ++i, arg);
-    else if (arg === "--target") options.target = requireValue(args, ++i, arg);
+    if (arg === "--provider") {
+      const providerValue = requireValue(args, ++i, arg);
+      if (providerArg && providerArg !== providerValue) {
+        throw new Error("provider specified twice with different values");
+      }
+      providerArg = providerValue;
+    } else if (arg === "--target") options.target = requireValue(args, ++i, arg);
     else if (arg === "--source") options.source = requireValue(args, ++i, arg);
     else if (arg === "--version") options.version = requireValue(args, ++i, arg);
     else if (arg === "--force") options.force = true;
@@ -56,17 +64,23 @@ function parseInstallArgs(args) {
     else if (arg === "--help" || arg === "-h") {
       usage();
       process.exit(0);
-    } else {
+    } else if (arg.startsWith("-")) {
       throw new Error(`Unknown argument: ${arg}`);
+    } else if (providerArg) {
+      throw new Error(`Unexpected argument: ${arg}`);
+    } else {
+      providerArg = arg;
     }
   }
 
+  options.provider = providerArg || "claude";
+
   const allowed = [...Object.keys(PROVIDER_TARGETS), "all"];
   if (!allowed.includes(options.provider)) {
-    throw new Error(`--provider must be one of: ${allowed.join(", ")}`);
+    throw new Error(`provider must be one of: ${allowed.join(", ")}`);
   }
   if (options.target && options.provider === "all") {
-    throw new Error("--target cannot be combined with --provider all");
+    throw new Error("--target cannot be combined with provider all");
   }
   return options;
 }
@@ -88,6 +102,9 @@ function install(options) {
     const target = path.resolve(expandHome(options.target || PROVIDER_TARGETS[provider]()));
     installToProvider(source, target, provider, options.force, options.dryRun);
   }
+  if (!options.dryRun) {
+    console.log(`Read the README: ${README_URL}`);
+  }
   return 0;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plan-tree",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Installer for the portable plan-tree AI planning skill.",
   "homepage": "https://github.com/SeemSeam/plan-tree",
   "repository": {