dream-wf 0.1.1 → 0.1.2

package/src/platforms/cursor/index.js

@@ -2,16 +2,20 @@ import path from 'node:path';
 import { readFile, chmod } from 'node:fs/promises';
 import { readJsonObject, writeJsonObject, pushUniqueByCommand } from '../../lib/json.js';
 import { writeIfChanged } from '../../lib/files.js';
-import { installCommonDreamWfFiles, installRuleFile, installSkill } from '../shared.js';
+import { installCommonDreamWfFiles, installRuleFile, installSelectedSkills } from '../shared.js';
+import { installMcpServers } from '../../lib/mcp.js';
 
 export async function installCursor(packageRoot, targetRoot, options) {
   const results = [];
 
   results.push(await installRuleFile(packageRoot, targetRoot, 'templates/rules/cursor/dream-wf.mdc', '.cursor/rules/dream-wf.mdc'));
-  results.push(await installSkill(packageRoot, targetRoot, '.cursor', 'dream-wf-grill-prd'));
-  results.push(await installSkill(packageRoot, targetRoot, '.cursor', 'dream-wf-mcp-policy'));
+  results.push(...await installSelectedSkills(packageRoot, targetRoot, '.cursor', options.skills));
   results.push(...await installCommonDreamWfFiles(packageRoot, targetRoot));
 
+  if (options.mcps && options.mcps.length > 0) {
+    results.push(await installMcpServers(targetRoot, 'cursor', options.mcps));
+  }
+
   if (options.mode === 'strict') {
     results.push(await installCursorHook(packageRoot, targetRoot));
     results.push(await mergeCursorHooks(targetRoot));

package/src/platforms/opencode/index.js

@@ -1,16 +1,20 @@
 import path from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { writeIfChanged } from '../../lib/files.js';
-import { installCommonDreamWfFiles, installManagedBlock, installSkill } from '../shared.js';
+import { installCommonDreamWfFiles, installManagedBlock, installSelectedSkills } from '../shared.js';
+import { installMcpServers } from '../../lib/mcp.js';
 
 export async function installOpenCode(packageRoot, targetRoot, options) {
   const results = [];
 
   results.push(await installManagedBlock(packageRoot, targetRoot, 'templates/rules/opencode/dream-wf-block.md', 'AGENTS.md', '<!-- DREAM-WF:START -->', '<!-- DREAM-WF:END -->'));
-  results.push(await installSkill(packageRoot, targetRoot, '.opencode', 'dream-wf-grill-prd'));
-  results.push(await installSkill(packageRoot, targetRoot, '.opencode', 'dream-wf-mcp-policy'));
+  results.push(...await installSelectedSkills(packageRoot, targetRoot, '.opencode', options.skills));
   results.push(...await installCommonDreamWfFiles(packageRoot, targetRoot));
 
+  if (options.mcps && options.mcps.length > 0) {
+    results.push(await installMcpServers(targetRoot, 'opencode', options.mcps));
+  }
+
   if (options.mode === 'strict') {
     results.push(await installOpenCodePlugin(packageRoot, targetRoot));
   }

package/src/platforms/shared.js

@@ -9,6 +9,17 @@ export async function installSkill(packageRoot, targetRoot, platformDir, skillNa
   return writeIfChanged(targetPath, contents);
 }
 
+// 按 catalog 选中的 skill 条目安装。skills 为 resolveSkills 返回的数组。
+// 若 skills 为 undefined，则安装全部（向后兼容旧 CLI 行为）。
+export async function installSelectedSkills(packageRoot, targetRoot, platformDir, skills) {
+  const list = skills ?? [];
+  const results = [];
+  for (const skill of list) {
+    results.push(await installSkill(packageRoot, targetRoot, platformDir, skill.name));
+  }
+  return results;
+}
+
 export async function installSpecGuide(packageRoot, targetRoot, fileName) {
   const sourcePath = path.join(packageRoot, 'templates', 'spec', 'guides', fileName);
   const targetPath = path.join(targetRoot, '.trellis', 'spec', 'guides', fileName);

package/src/tui/index.js

@@ -0,0 +1,445 @@
+import process from "node:process";
+import { SUPPORTED_PLATFORMS, PLATFORM_LABELS } from "../lib/platforms.js";
+import {
+  SKILL_CATALOG,
+  MCP_CATALOG,
+  defaultSkillIds,
+  defaultMcpIds,
+} from "../lib/catalog.js";
+import { detectTrellis } from "../lib/trellis.js";
+import { trellisPlatformFlag } from "../lib/platforms.js";
+
+const COLORS = {
+  reset: "\x1B[0m",
+  dim: "\x1B[2m",
+  bold: "\x1B[1m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+};
+
+function colorize(text, color) {
+  if (!process.stdout.isTTY || process.env.NO_COLOR) {
+    return text;
+  }
+  return `${COLORS[color] ?? ""}${text}${COLORS.reset}`;
+}
+
+function renderCheckboxList(items, cursorIndex, selected) {
+  const lines = [];
+  items.forEach((item, index) => {
+    const pointer = index === cursorIndex ? colorize("❯", COLORS.cyan) : " ";
+    const check = selected.has(item.id)
+      ? colorize("◉", COLORS.green)
+      : colorize("◯", COLORS.dim);
+    const label =
+      index === cursorIndex ? colorize(item.label, COLORS.bold) : item.label;
+    lines.push(`${pointer} ${check} ${label}`);
+    if (item.description) {
+      lines.push(colorize(`    ${item.description}`, COLORS.dim));
+    }
+  });
+  return lines.join("\n");
+}
+
+function renderRadioList(items, cursorIndex) {
+  const lines = [];
+  items.forEach((item, index) => {
+    const pointer = index === cursorIndex ? colorize("❯", COLORS.cyan) : " ";
+    const dot =
+      index === cursorIndex
+        ? colorize("●", COLORS.green)
+        : colorize("○", COLORS.dim);
+    const label =
+      index === cursorIndex ? colorize(item.label, COLORS.bold) : item.label;
+    lines.push(`${pointer} ${dot} ${label}`);
+  });
+  return lines.join("\n");
+}
+
+// 在 raw 模式下读取按键。返回标准化按键名。
+// 方向键转义序列 \x1B[A/B/C/D 可能分多个 data 事件到达，这里做拼接。
+function readKeystroke() {
+  return new Promise((resolve) => {
+    let buffer = "";
+    function onRaw(data) {
+      buffer += data.toString();
+      // 完整的转义序列至少 3 字节；单字符按键 1 字节即可判定。
+      if (buffer.length === 1) {
+        const char = buffer;
+        if (char === "\x1B") {
+          // 等待后续字节。
+          return;
+        }
+        process.stdin.removeListener("data", onRaw);
+        resolve(char);
+        return;
+      }
+      if (buffer.length >= 3 && buffer.startsWith("\x1B")) {
+        process.stdin.removeListener("data", onRaw);
+        resolve(buffer);
+        return;
+      }
+      // 超时兜底，避免 hang。
+      if (buffer.length > 8) {
+        process.stdin.removeListener("data", onRaw);
+        resolve(buffer);
+      }
+    }
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.once("data", onRaw);
+    process.stdin.on("data", onRaw);
+  });
+}
+
+function stopRaw() {
+  process.stdin.setRawMode(false);
+  process.stdin.pause();
+  process.stdin.removeAllListeners("data");
+}
+
+async function multiSelect({ title, hint, items, defaults }) {
+  let cursor = 0;
+  const selected = new Set(defaults);
+
+  function render() {
+    process.stdout.write("\x1B[2J\x1B[H");
+    process.stdout.write(`${colorize(title, COLORS.magenta)}\n`);
+    if (hint) {
+      process.stdout.write(`${colorize(hint, COLORS.dim)}\n`);
+    }
+    process.stdout.write("\n");
+    process.stdout.write(renderCheckboxList(items, cursor, selected));
+    process.stdout.write("\n\n");
+    process.stdout.write(
+      colorize(
+        "  ↑/↓ 移动 · space 切换选中 · enter 确认 · a 全选/全不选 · ctrl+c 退出\n",
+        COLORS.dim,
+      ),
+    );
+  }
+
+  while (true) {
+    render();
+    const key = await readKeystroke();
+
+    if (key === "\x03") {
+      stopRaw();
+      process.stdout.write("\n已取消\n");
+      process.exit(0);
+    }
+    if (key === "q") {
+      stopRaw();
+      process.stdout.write("\n已退出\n");
+      process.exit(0);
+    }
+    if (key === "\x1B[A") {
+      cursor = (cursor - 1 + items.length) % items.length;
+      continue;
+    }
+    if (key === "\x1B[B") {
+      cursor = (cursor + 1) % items.length;
+      continue;
+    }
+    if (key === " ") {
+      const item = items[cursor];
+      if (selected.has(item.id)) {
+        selected.delete(item.id);
+      } else {
+        selected.add(item.id);
+      }
+      continue;
+    }
+    if (key === "a") {
+      if (selected.size === items.length) {
+        selected.clear();
+      } else {
+        items.forEach((item) => selected.add(item.id));
+      }
+      continue;
+    }
+    if (key === "\r" || key === "\n") {
+      stopRaw();
+      return [...selected];
+    }
+  }
+}
+
+async function singleSelect({ title, hint, items }) {
+  let cursor = 0;
+
+  function render() {
+    process.stdout.write("\x1B[2J\x1B[H");
+    process.stdout.write(`${colorize(title, COLORS.magenta)}\n`);
+    if (hint) {
+      process.stdout.write(`${colorize(hint, COLORS.dim)}\n`);
+    }
+    process.stdout.write("\n");
+    process.stdout.write(renderRadioList(items, cursor));
+    process.stdout.write("\n\n");
+    process.stdout.write(
+      colorize("  ↑/↓ 移动 · enter 选择 · ctrl+c 退出\n", COLORS.dim),
+    );
+  }
+
+  while (true) {
+    render();
+    const key = await readKeystroke();
+
+    if (key === "\x03") {
+      stopRaw();
+      process.stdout.write("\n已取消\n");
+      process.exit(0);
+    }
+    if (key === "\x1B[A") {
+      cursor = (cursor - 1 + items.length) % items.length;
+      continue;
+    }
+    if (key === "\x1B[B") {
+      cursor = (cursor + 1) % items.length;
+      continue;
+    }
+    if (key === "\r" || key === "\n") {
+      stopRaw();
+      return items[cursor].id;
+    }
+  }
+}
+
+async function confirmPrompt(label) {
+  let cursor = 0;
+  const options = ["确认安装", "取消"];
+
+  function render() {
+    const line = options
+      .map((option, index) => {
+        const prefix = index === cursor ? colorize("❯", COLORS.cyan) : " ";
+        const text = index === cursor ? colorize(option, COLORS.bold) : option;
+        return `${prefix} ${text}`;
+      })
+      .join("   ");
+    process.stdout.write(`\r${colorize(label, COLORS.bold)}  ${line}`);
+  }
+
+  while (true) {
+    render();
+    const key = await readKeystroke();
+
+    if (key === "\x03") {
+      stopRaw();
+      process.stdout.write("\n已取消\n");
+      process.exit(0);
+    }
+    if (
+      key === "\x1B[A" ||
+      key === "\x1B[B" ||
+      key === "\t" ||
+      key === "\x1B[C" ||
+      key === "\x1B[D"
+    ) {
+      cursor = (cursor + 1) % options.length;
+      continue;
+    }
+    if (key === "\r" || key === "\n") {
+      stopRaw();
+      process.stdout.write("\n");
+      return cursor === 0;
+    }
+  }
+}
+
+// 文本输入 prompt：在 raw 模式下逐字符读取，回车确认。
+async function textInput({ title, hint, placeholder }) {
+  let value = "";
+
+  function render() {
+    process.stdout.write("\x1B[2J\x1B[H");
+    process.stdout.write(`${colorize(title, COLORS.magenta)}\n`);
+    if (hint) {
+      process.stdout.write(`${colorize(hint, COLORS.dim)}\n`);
+    }
+    process.stdout.write("\n");
+    const display = value || colorize(placeholder ?? "", COLORS.dim);
+    process.stdout.write(`  ❯ ${display}\n`);
+    process.stdout.write("\n");
+    process.stdout.write(colorize("  输入文字 · enter 确认 · ctrl+c 退出\n", COLORS.dim));
+  }
+
+  while (true) {
+    render();
+    const key = await readKeystroke();
+
+    if (key === "\x03") {
+      stopRaw();
+      process.stdout.write("\n已取消\n");
+      process.exit(0);
+    }
+    if (key === "\r" || key === "\n") {
+      stopRaw();
+      return value.trim();
+    }
+    if (key === "\x7F" || key === "\b") {
+      value = value.slice(0, -1);
+      continue;
+    }
+    // 方向键等转义序列忽略。
+    if (key.startsWith("\x1B")) {
+      continue;
+    }
+    // 普通可打印字符。
+    if (key.length === 1 && key >= " " && key <= "~") {
+      value += key;
+    }
+  }
+}
+
+function renderSummary(platform, skills, mcps, mode, trellisAction) {
+  const lines = [];
+  lines.push(colorize("即将安装:", COLORS.magenta));
+  lines.push(`  平台: ${colorize(PLATFORM_LABELS[platform], COLORS.bold)}`);
+  lines.push(`  模式: ${mode === "strict" ? colorize("strict", COLORS.yellow) : colorize("advisory", COLORS.green)}`);
+
+  if (trellisAction) {
+    lines.push(`  Trellis: ${colorize(trellisAction, COLORS.cyan)}`);
+  }
+
+  lines.push(`  Skills (${skills.length}):`);
+  if (skills.length === 0) {
+    lines.push(colorize("    (无)", COLORS.dim));
+  } else {
+    skills.forEach((s) =>
+      lines.push(`    ${colorize("✓", COLORS.green)} ${s.name}`),
+    );
+  }
+  lines.push(`  MCPs (${mcps.length}):`);
+  if (mcps.length === 0) {
+    lines.push(colorize("    (无)", COLORS.dim));
+  } else {
+    mcps.forEach((m) =>
+      lines.push(`    ${colorize("✓", COLORS.green)} ${m.name}`),
+    );
+  }
+  return lines.join("\n");
+}
+
+// 交互式安装向导：平台 -> Trellis 基础依赖 -> skill -> mcp -> 确认安装。
+export async function runInteractive() {
+  // 第一步：选择平台。
+  const platformItems = [...SUPPORTED_PLATFORMS].map((id) => ({
+    id,
+    label: PLATFORM_LABELS[id],
+  }));
+  const platform = await singleSelect({
+    title: "第一步 · 选择目标平台",
+    hint: "选择你要安装 dream-wf 的 AI 编码平台。",
+    items: platformItems,
+  });
+
+  // 第二步：Trellis 基础依赖。
+  const trellisState = await detectTrellis(process.cwd());
+  let trellisAction = null;
+  let installDeps = false;
+  let developer = undefined;
+
+  if (trellisState.exists) {
+    trellisAction = "已初始化（跳过）";
+  } else if (!trellisState.cli) {
+    // trellis CLI 未安装。
+    const installChoice = await singleSelect({
+      title: "第二步 · Trellis 基础依赖",
+      hint: `检测到 trellis CLI 未安装。是否自动安装 @mindfoldhq/trellis？`,
+      items: [
+        { id: "install", label: "自动安装 trellis CLI 并初始化" },
+        { id: "skip", label: "跳过（稍后手动安装）" },
+      ],
+    });
+
+    if (installChoice === "install") {
+      const name = await textInput({
+        title: "输入开发者名称",
+        hint: "trellis init -u <name> 需要一个开发者名称。",
+        placeholder: "your-name",
+      });
+      if (!name) {
+        process.stdout.write("开发者名称不能为空，已取消\n");
+        return null;
+      }
+      trellisAction = "安装 trellis CLI + 初始化项目";
+      installDeps = true;
+      developer = name;
+    } else {
+      trellisAction = "跳过（需手动安装 trellis CLI）";
+    }
+  } else {
+    // trellis CLI 已安装但项目未初始化。
+    const initChoice = await singleSelect({
+      title: "第二步 · Trellis 基础依赖",
+      hint: `trellis CLI 已安装，但当前项目未初始化。是否初始化？`,
+      items: [
+        { id: "init", label: "初始化 Trellis 项目" },
+        { id: "skip", label: "跳过（稍后手动初始化）" },
+      ],
+    });
+
+    if (initChoice === "init") {
+      const name = await textInput({
+        title: "输入开发者名称",
+        hint: "trellis init -u <name> 需要一个开发者名称。",
+        placeholder: "your-name",
+      });
+      if (!name) {
+        process.stdout.write("开发者名称不能为空，已取消\n");
+        return null;
+      }
+      trellisAction = "初始化 Trellis 项目";
+      installDeps = true;
+      developer = name;
+    } else {
+      trellisAction = "跳过（需手动初始化）";
+    }
+  }
+
+  // 第三步：选择 skills。
+  const skillIds = await multiSelect({
+    title: "第三步 · 选择要安装的 Skills",
+    hint: "这些是 dream-wf 的 Trellis patch skills，默认全选。",
+    items: SKILL_CATALOG,
+    defaults: defaultSkillIds(),
+  });
+
+  // 第四步：选择 MCPs。
+  const mcpIds = await multiSelect({
+    title: "第四步 · 选择要配置的 MCP Servers",
+    hint: "这些 MCP 会被写入对应平台的 mcp 配置文件，默认全选。",
+    items: MCP_CATALOG,
+    defaults: defaultMcpIds(),
+  });
+
+  const skills = SKILL_CATALOG.filter((item) => skillIds.includes(item.id));
+  const mcps = MCP_CATALOG.filter((item) => mcpIds.includes(item.id));
+  const mode = "strict";
+
+  // 确认安装。
+  process.stdout.write("\x1B[2J\x1B[H");
+  process.stdout.write(renderSummary(platform, skills, mcps, mode, trellisAction));
+  process.stdout.write("\n\n");
+
+  const confirmed = await confirmPrompt("确认开始安装？");
+  if (!confirmed) {
+    process.stdout.write("已取消安装\n");
+    return null;
+  }
+
+  return {
+    platform,
+    mode,
+    skillIds,
+    mcpIds,
+    skills,
+    mcps,
+    installDeps,
+    developer,
+  };
+}

package/templates/hooks/claude-code/dream-wf-guard.py

@@ -52,10 +52,12 @@ def is_planning_artifact(root, tool_input):
         return False
 
     try:
+        root_resolved = root.resolve()
         file_path = Path(candidate)
         if not file_path.is_absolute():
-            file_path = (root / file_path).resolve()
-        relative = file_path.relative_to(root).as_posix()
+            file_path = (root_resolved / file_path)
+        # 规范化符号链接，避免 /tmp vs /private/tmp 导致 relative_to 失败。
+        relative = file_path.resolve().relative_to(root_resolved).as_posix()
     except Exception:
         return False
 
@@ -91,6 +93,10 @@ def allow():
 
 
 def main():
+    # 逃生舱：DREAM_WF_MODE=advisory 时跳过 strict 检查。
+    if os.environ.get("DREAM_WF_MODE", "").lower() == "advisory":
+        allow()
+
     try:
         payload = json.load(sys.stdin)
     except Exception:
@@ -111,15 +117,31 @@ def main():
 
     tasks = active_tasks(root)
     if not tasks:
-        deny("dream-wf strict: mutating actions require an active Trellis task. Create or start a Trellis task first, or switch dream-wf to advisory mode.")
-
-    planning_tasks = [(task_dir, task) for task_dir, task in tasks if task.get("status") == "planning"]
-    if planning_tasks:
-        if is_planning_artifact(root, tool_input):
-            allow()
-        unconfirmed = [task for task_dir, task in planning_tasks if not is_prd_confirmed(task_dir)]
-        if unconfirmed:
-            deny("dream-wf strict: implementation is blocked while this task is in planning and its PRD is not confirmed. Continue grill-me PRD clarification first. Planning artifacts under .trellis/tasks/** are allowed.")
+        deny("dream-wf strict: mutating actions require an active Trellis task. Create or start a Trellis task first, or switch dream-wf to advisory mode (DREAM_WF_MODE=advisory).")
+
+    # 规划产物始终允许，便于在 planning 阶段编写 prd/design 等。
+    if is_planning_artifact(root, tool_input):
+        allow()
+
+    # 若存在已确认的 in_progress 任务，允许实现操作，不被其它 stale planning 任务阻塞。
+    in_progress_confirmed = any(
+        task.get("status") == "in_progress" and is_prd_confirmed(task_dir)
+        for task_dir, task in tasks
+    )
+    if in_progress_confirmed:
+        allow()
+
+    in_progress_any = any(task.get("status") == "in_progress" for _, task in tasks)
+    if in_progress_any:
+        allow()
+
+    # 剩余情况：所有活跃任务都是 planning。若任一未确认 PRD，则阻塞实现。
+    planning_unconfirmed = [
+        task_dir for task_dir, task in tasks
+        if task.get("status") == "planning" and not is_prd_confirmed(task_dir)
+    ]
+    if planning_unconfirmed:
+        deny("dream-wf strict: implementation is blocked while all active tasks are in planning and at least one PRD is not confirmed. Continue grill-me PRD clarification first. Planning artifacts under .trellis/tasks/** are allowed.")
 
     allow()