pm-workflow-studio 0.1.2 → 0.1.4

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,20 @@ 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),
+};
+
+const symbol = {
+  pointer: useColor ? color.cyan("?") : "?",
+  done: useColor ? color.green("✔") : "✔",
+  arrow: useColor ? color.cyan("›") : "›",
+};
+
 function exists(target) {
   return fs.existsSync(target);
 }
@@ -89,6 +110,7 @@ function parseInitArgs(argv) {
     ai: "auto",
     root: ".",
     name: "My Product",
+    interactive: false,
   };
 
   for (let index = 0; index < argv.length; index += 1) {
@@ -97,6 +119,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 +166,124 @@ 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.bold("PM Workflow Studio"));
+  console.log(color.dim("Create a Codex or Claude Code product workspace."));
+  console.log("");
+}
+
+function promptLine(label, defaultValue) {
+  const suffix = defaultValue ? ` ${color.dim(`(${defaultValue})`)}` : "";
+  return `${symbol.pointer} ${label}${suffix} ${symbol.arrow} `;
+}
+
+function printAnswer(label, value) {
+  console.log(`${symbol.done} ${label}: ${color.green(value)}`);
+}
+
+async function askText(prompt, label, defaultValue) {
+  const answer = await prompt.ask(promptLine(label, defaultValue));
+  const value = answer || defaultValue;
+  printAnswer(label, value);
+  return value;
+}
+
+async function askAi(prompt, defaultValue) {
+  const choices = [
+    ["1", "auto", "Auto, choose by target directory"],
+    ["2", "codex", "Codex, generate .codex + .agents"],
+    ["3", "claude", "Claude Code, generate .claude"],
+  ];
+
+  while (true) {
+    console.log(`${symbol.pointer} Select AI workspace ${color.dim(`(${defaultValue})`)}`);
+    for (const [key, value, description] of choices) {
+      const marker = value === defaultValue ? color.dim(" (default)") : "";
+      console.log(`  ${key}. ${value.padEnd(6)} ${color.dim(description)}${marker}`);
+    }
+    const answer = await prompt.ask(`  ${symbol.arrow} `);
+    const normalized = answer ? answer.toLowerCase() : defaultValue;
+    const matched = choices.find(([key, value]) => normalized === key || normalized === value);
+    if (matched) {
+      printAnswer("AI workspace", matched[1]);
+      return matched[1];
+    }
+    console.log(color.dim("  Enter 1/2/3, or auto/codex/claude."));
+  }
+}
+
+async function askConfirm(prompt, label, defaultValue = true) {
+  const suffix = defaultValue ? "Y/n" : "y/N";
+  while (true) {
+    const answer = (await prompt.ask(promptLine(label, suffix))).toLowerCase();
+    if (!answer) {
+      printAnswer(label, defaultValue ? "yes" : "no");
+      return defaultValue;
+    }
+    if (["y", "yes", "是", "确认"].includes(answer)) {
+      printAnswer(label, "yes");
+      return true;
+    }
+    if (["n", "no", "否", "取消"].includes(answer)) {
+      printAnswer(label, "no");
+      return false;
+    }
+    console.log(color.dim("  Enter y or 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();
+
+    const name = await askText(prompt, "What is your product named?", seedOptions.name || "My Product");
+    const root = await askText(prompt, "Where should the project be created?", seedOptions.root || ".");
+
+    const ai = await askAi(prompt, seedOptions.ai || "auto");
+
+    console.log("");
+    console.log(color.bold("Summary"));
+    console.log(`  Product:   ${color.green(name)}`);
+    console.log(`  Directory: ${color.green(path.resolve(root))}`);
+    console.log(`  Workspace: ${color.green(ai)}`);
+    console.log("");
+
+    const confirmed = await askConfirm(prompt, "Create this workspace?", true);
+    if (!confirmed) {
+      console.log(color.dim("Canceled."));
+      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 +586,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.4",
   "description": "AI product development studio CLI for Codex and Claude Code.",
   "type": "commonjs",
   "bin": {