pm-workflow-studio 0.1.2 → 0.1.3

package/README.md

@@ -17,6 +17,20 @@ pm-workflow --help
 
 ## 快速开始
 
+交互式：
+
+```bash
+pmflow
+```
+
+或：
+
+```bash
+pmflow init
+```
+
+CLI 会逐步询问产品名称、项目目录和 AI 工作区结构。适合不想记参数的日常使用。
+
 Codex：
 
 ```bash
@@ -49,6 +63,7 @@ claude
 
 ```bash
 pmflow init --ai auto --name "习惯打卡"
+pmflow init --interactive
 pmflow init --ai codex --root ./pm-workflow-demo --name "习惯打卡"
 pmflow init --ai claude --root ./pm-workflow-claude-demo --name "习惯打卡"
 ```
@@ -56,6 +71,7 @@ pmflow init --ai claude --root ./pm-workflow-claude-demo --name "习惯打卡"
 - `--ai auto|codex|claude`：选择生成结构。默认 `auto`；空目录默认 Codex；目录已有 `.claude/` 时选择 Claude Code。
 - `--root <dir>`：目标项目目录，默认当前目录。
 - `--name <product name>`：产品名称，默认 `My Product`。
+- `--interactive` / `-i`：进入交互式创建向导。
 - `--cli` 是 `--ai` 的别名。
 
 当前支持 Codex 和 Claude Code；`kiro` 暂未支持。

package/bin/pmflow.js

@@ -2,6 +2,7 @@
 
 const fs = require("node:fs");
 const path = require("node:path");
+const readline = require("node:readline");
 
 const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const CODEX_MIRROR = path.join(PACKAGE_ROOT, ".codex");
@@ -26,6 +27,8 @@ function printHelp() {
   console.log(`PM Workflow Studio
 
 Usage:
+  pmflow
+  pmflow init
   pmflow init [--ai auto|codex|claude] [--root <dir>] [--name <product name>]
   pm-workflow init [--ai auto|codex|claude] [--root <dir>] [--name <product name>]
 
@@ -36,9 +39,13 @@ Options:
               claude: generate .claude structure for Claude Code.
   --root        Target workspace directory. Defaults to current directory.
   --name        Product name for generated templates. Defaults to "My Product".
+  -i, --interactive
+               Start the interactive setup wizard.
   -h, --help    Show help.
 
 Examples:
+  pmflow
+  pmflow init
   pmflow init --ai codex --root ./pm-workflow-demo --name "习惯打卡"
   pmflow init --ai claude --root ./pm-workflow-claude-demo --name "习惯打卡"
   pmflow init --ai auto --name "习惯打卡"
@@ -54,6 +61,14 @@ function fail(message) {
   process.exit(1);
 }
 
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const color = {
+  cyan: (value) => (useColor ? `\u001b[36m${value}\u001b[0m` : value),
+  dim: (value) => (useColor ? `\u001b[2m${value}\u001b[0m` : value),
+  green: (value) => (useColor ? `\u001b[32m${value}\u001b[0m` : value),
+  bold: (value) => (useColor ? `\u001b[1m${value}\u001b[0m` : value),
+};
+
 function exists(target) {
   return fs.existsSync(target);
 }
@@ -89,6 +104,7 @@ function parseInitArgs(argv) {
     ai: "auto",
     root: ".",
     name: "My Product",
+    interactive: false,
   };
 
   for (let index = 0; index < argv.length; index += 1) {
@@ -97,6 +113,10 @@ function parseInitArgs(argv) {
       printHelp();
       process.exit(0);
     }
+    if (arg === "-i" || arg === "--interactive") {
+      options.interactive = true;
+      continue;
+    }
     if (arg === "--ai" || arg === "--cli") {
       const value = argv[index + 1];
       if (!value) fail(`${arg} requires a value.`);
@@ -140,6 +160,110 @@ function parseInitArgs(argv) {
   return options;
 }
 
+function createPrompt() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  return {
+    ask(question) {
+      return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+      });
+    },
+    close() {
+      rl.close();
+    },
+  };
+}
+
+function printInteractiveHeader() {
+  console.log("");
+  console.log(color.cyan("┌────────────────────────────────────────────┐"));
+  console.log(color.cyan("│") + ` ${color.bold("PM Workflow Studio")}                         ` + color.cyan("│"));
+  console.log(color.cyan("│") + "  交互式创建产品工作室，命令参数仍然可用  " + color.cyan("│"));
+  console.log(color.cyan("└────────────────────────────────────────────┘"));
+  console.log("");
+}
+
+function printStep(index, title) {
+  console.log(color.dim(`\nStep ${index}`));
+  console.log(color.bold(title));
+}
+
+function formatDefault(value) {
+  return color.dim(`(${value})`);
+}
+
+async function askText(prompt, label, defaultValue) {
+  const answer = await prompt.ask(`${label} ${formatDefault(defaultValue)}: `);
+  return answer || defaultValue;
+}
+
+async function askAi(prompt, defaultValue) {
+  const choices = [
+    ["1", "auto", "自动判断，空目录默认 Codex"],
+    ["2", "codex", "生成 .codex + .agents 结构"],
+    ["3", "claude", "生成 .claude 结构"],
+  ];
+
+  while (true) {
+    for (const [key, value, description] of choices) {
+      const marker = value === defaultValue ? color.green(" *") : "  ";
+      console.log(`  ${key}. ${value.padEnd(6)} ${color.dim(description)}${marker}`);
+    }
+    const answer = await prompt.ask(`选择 AI CLI ${formatDefault(defaultValue)}: `);
+    const normalized = answer ? answer.toLowerCase() : defaultValue;
+    const matched = choices.find(([key, value]) => normalized === key || normalized === value);
+    if (matched) return matched[1];
+    console.log("请输入 1/2/3，或 auto/codex/claude。");
+  }
+}
+
+async function askConfirm(prompt, label, defaultValue = true) {
+  const suffix = defaultValue ? "Y/n" : "y/N";
+  while (true) {
+    const answer = (await prompt.ask(`${label} ${formatDefault(suffix)}: `)).toLowerCase();
+    if (!answer) return defaultValue;
+    if (["y", "yes", "是", "确认"].includes(answer)) return true;
+    if (["n", "no", "否", "取消"].includes(answer)) return false;
+    console.log("请输入 y 或 n。");
+  }
+}
+
+async function runInteractiveInit(seedOptions = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    fail("interactive mode requires a TTY. Use `pmflow init --ai auto --root . --name \"My Product\"` in non-interactive environments.");
+  }
+
+  const prompt = createPrompt();
+  try {
+    printInteractiveHeader();
+
+    printStep(1, "产品信息");
+    const name = await askText(prompt, "产品名称", seedOptions.name || "My Product");
+    const root = await askText(prompt, "项目目录", seedOptions.root || ".");
+
+    printStep(2, "AI 工作区结构");
+    const ai = await askAi(prompt, seedOptions.ai || "auto");
+
+    printStep(3, "确认创建");
+    console.log(`  产品名称: ${color.green(name)}`);
+    console.log(`  项目目录: ${color.green(path.resolve(root))}`);
+    console.log(`  AI 结构:  ${color.green(ai)}`);
+    const confirmed = await askConfirm(prompt, "开始创建？", true);
+    if (!confirmed) {
+      console.log("已取消。");
+      return;
+    }
+
+    console.log("");
+    createStructure(root, name, normalizeAi(ai));
+  } finally {
+    prompt.close();
+  }
+}
+
 function templatePath(name) {
   const centralPath = path.join(CODEX_TEMPLATES, name);
   if (exists(centralPath)) return centralPath;
@@ -442,22 +566,41 @@ function createStructure(rootInput, productName, cli) {
   console.log(nextStep);
 }
 
-function runInit(argv) {
+async function runInit(argv) {
   const options = parseInitArgs(argv);
+  if (options.interactive || (argv.length === 0 && process.stdin.isTTY && process.stdout.isTTY)) {
+    await runInteractiveInit(options);
+    return;
+  }
   createStructure(options.root, options.name, options.ai);
 }
 
-function main() {
+async function main() {
   const [command, ...rest] = process.argv.slice(2);
   if (!command || command === "-h" || command === "--help") {
+    if (!command) {
+      if (process.stdin.isTTY && process.stdout.isTTY) {
+        await runInteractiveInit();
+      } else {
+        printHelp();
+      }
+      return;
+    }
     printHelp();
     return;
   }
   if (command === "init") {
-    runInit(rest);
+    await runInit(rest);
     return;
   }
   fail(`unknown command "${command}".`);
 }
 
-main();
+main().catch((error) => {
+  if (error && error.message) {
+    console.error(`pmflow: ${error.message}`);
+  } else {
+    console.error(error);
+  }
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-workflow-studio",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "AI product development studio CLI for Codex and Claude Code.",
   "type": "commonjs",
   "bin": {