flower-trellis 0.1.0

package/src/constants.js

@@ -0,0 +1,50 @@
+/**
+ * 全局常量集中地。
+ *
+ * 这里的名单从 skill-garden 的 install.sh 与 Trellis cli/index.ts 对齐而来,
+ * 改动时需与上游保持一致。
+ */
+
+/** 强化包支持的三个版本变体目录名。 */
+export const VARIANTS = ["old", "0.5", "0.6"];
+
+/**
+ * Trellis init 支持的全部平台 flag。
+ *
+ * 用途:当用户未显式指定任何平台时,flower-trellis 默认补 `--claude`
+ * (对应「默认 Claude + agents」决策)。来源为 Trellis cli/index.ts 的 init 注册。
+ * 上游新增平台时此名单可滞后 —— 最坏后果仅是误补 `--claude`(与用户新平台共存),
+ * 不会致命。
+ */
+export const PLATFORM_FLAGS = [
+  "--cursor",
+  "--claude",
+  "--opencode",
+  "--codex",
+  "--kilo",
+  "--kiro",
+  "--gemini",
+  "--antigravity",
+  "--windsurf",
+  "--qoder",
+  "--codebuddy",
+  "--copilot",
+  "--droid",
+  "--pi",
+  "--reasonix",
+];
+
+/**
+ * flower-trellis 自有 flag —— 这些不能透传给 trellis,需在解析时剔除。
+ *
+ * 值含义:
+ *   false → 布尔 flag(出现即生效,不带取值)
+ *   true  → 带取值 flag(其后紧跟一个取值 token,剔除时要连带跳过)
+ */
+export const OWN_FLAGS = {
+  "--no-enhance": false,
+  "--enhance-only": false,
+  "--skills": true,
+  "--variant": true,
+  "--target": true,
+};

package/src/lib/apply-enhancements.js

@@ -0,0 +1,133 @@
+import fs from "node:fs";
+import path from "node:path";
+import { selectVariant } from "./variant.js";
+import { ENHANCEMENTS_ROOT } from "./paths.js";
+import { VARIANTS } from "../constants.js";
+import { copySkills } from "./copy-skills.js";
+import { injectWorkflow } from "./workflow-inject.js";
+import { applyCodexTweaks } from "./codex-tweaks.js";
+import { readManifest, writeManifest } from "./manifest.js";
+import { rmrf } from "./fs-utils.js";
+
+/** 清理升级后可能变空的强化目录(深 → 浅)。 */
+function pruneEmptyDirs(target) {
+  for (const d of [
+    ".agents/skills",
+    ".agents",
+    ".claude/commands/trellis",
+    ".claude/commands",
+  ]) {
+    const abs = path.join(target, ...d.split("/"));
+    try {
+      if (fs.readdirSync(abs).length === 0) fs.rmdirSync(abs);
+    } catch {
+      // 不存在或非空,忽略
+    }
+  }
+}
+
+/**
+ * 叠加强化包 —— init / update 共享。
+ *
+ * 流程:校验是 Trellis 项目 → 选变体 → 铺 skill → 升级清理(删过期)→ 注入 workflow。
+ *
+ * 升级清理:用 flower manifest 记录上次全装铺过的精确路径,本次全装时删除
+ * 「上次有、这次变体不含」的过期项(覆盖 0.5/old → 0.6 升级)。仅全装(无 --skills)
+ * 时维护 manifest 与清理;带 --skills 为精细操作,不动 manifest、不清理。
+ *
+ * @param {string} target 目标项目根
+ * @param {object} [opts] { variant?, skills?[] }
+ * @returns {{variant: string, installed: string[]}}
+ */
+export function applyEnhancements(target, opts = {}) {
+  const trellisDir = path.join(target, ".trellis");
+  if (!fs.existsSync(trellisDir)) {
+    throw new Error(`目标不是 Trellis 项目(缺 .trellis/):${target}`);
+  }
+
+  // 选变体:--variant 优先,否则读 .trellis/.version
+  let variant = opts.variant;
+  let version = "";
+  if (variant) {
+    if (!VARIANTS.includes(variant)) {
+      throw new Error(`非法 --variant:${variant}(可选 ${VARIANTS.join(" / ")})`);
+    }
+  } else {
+    ({ variant, version } = selectVariant(target));
+  }
+
+  const variantDir = path.join(ENHANCEMENTS_ROOT, variant);
+  if (!fs.existsSync(variantDir)) {
+    throw new Error(`强化包快照缺变体 ${variant}/(请先在 flower-trellis 包内运行 npm run sync)`);
+  }
+
+  console.log(
+    `\n强化包变体:${variant}${version ? `(项目 Trellis ${version})` : ""}`,
+  );
+
+  const skills = opts.skills || [];
+  const { installed, paths: newPaths } = copySkills(
+    target,
+    variantDir,
+    variant,
+    skills,
+  );
+  const where = [];
+  if (newPaths.some((p) => p.startsWith(".claude/skills"))) where.push(".claude/skills");
+  if (newPaths.some((p) => p.startsWith(".agents/skills"))) where.push(".agents/skills");
+  if (newPaths.some((p) => p.startsWith(".claude/commands"))) where.push(".claude/commands/trellis");
+  console.log(
+    `  ✓ 铺设 ${installed.length} 个强化技能 → ${where.join(" + ") || "(无平台目录)"}`,
+  );
+
+  // 升级清理 + manifest(仅全装时维护)
+  if (skills.length === 0) {
+    const old = readManifest(target);
+    if (old && Array.isArray(old.paths)) {
+      const keep = new Set(newPaths);
+      const stale = old.paths.filter((p) => !keep.has(p));
+      let removed = 0;
+      for (const rel of stale) {
+        const abs = path.join(target, ...rel.split("/"));
+        if (fs.existsSync(abs)) {
+          rmrf(abs);
+          removed++;
+        }
+      }
+      if (removed > 0) {
+        console.log(
+          `  ✓ 清理 ${removed} 个过期强化项(${old.variant || "?"} → ${variant})`,
+        );
+        pruneEmptyDirs(target);
+      }
+    }
+    writeManifest(target, { variant, version, skills: installed, paths: newPaths });
+  }
+
+  // workflow 注入:无过滤名(全装)或显式指定 workflow-enhancement/finish-work-enhancement 时执行
+  const wantWorkflow =
+    skills.length === 0 ||
+    skills.includes("workflow-enhancement") ||
+    skills.includes("finish-work-enhancement");
+  if (wantWorkflow) {
+    const r = injectWorkflow(target, variantDir, variant);
+    if (r.skipped) {
+      console.log(`  · workflow 注入跳过(${r.reason})`);
+    } else if (r.changed === false) {
+      console.log(`  ✓ workflow.md 强化块已是最新${r.backupNote}`);
+    } else {
+      console.log(`  ✓ workflow.md 已注入强化块(${r.action})${r.backupNote}`);
+    }
+  }
+
+  // codex 平台后处理:注释 config.toml 的 multi_agent_v2 + 挂上 SessionStart hook(仅当 .codex/ 存在)
+  const codex = applyCodexTweaks(target);
+  if (codex.applied) {
+    const seg = codex.tomlChanged
+      ? "config.toml 已注释 multi_agent_v2"
+      : "config.toml(multi_agent_v2 已是注释态)";
+    console.log(`  ✓ codex 调整:${seg};hooks.json = SessionStart + UserPromptSubmit`);
+  }
+
+  return { variant, installed };
+}

package/src/lib/banner.js

@@ -0,0 +1,45 @@
+import figlet from "figlet";
+import chalk from "chalk";
+import { execFileSync } from "node:child_process";
+
+/**
+ * 打印 flower-trellis 品牌头部 —— ASCII logo + 副标题 + 开发者身份,
+ * 风格对齐 Trellis 页面。init 交互模式与 update 都会显示。
+ *
+ * @param {string|null} developer 开发者名(来自 -u/--user 或 git config)
+ */
+export function printBanner(developer) {
+  let art;
+  try {
+    art = figlet.textSync("Flower", { font: "ANSI Shadow" });
+  } catch {
+    art = "flower-trellis";
+  }
+  console.log("\n" + chalk.hex("#ff6fb5")(art));
+  console.log(
+    chalk.gray("  一键装 Trellis 工程框架,并融合 skill-garden 强化包\n"),
+  );
+  if (developer) {
+    console.log(
+      `👤 ${chalk.magentaBright("Developer")}: ${chalk.bold(developer)}\n`,
+    );
+  }
+}
+
+/** 解析开发者名:优先 -u/--user 的取值,否则回退到目标仓库的 git config user.name。 */
+export function getDeveloper(passthrough, target) {
+  const i = passthrough.findIndex((a) => a === "-u" || a === "--user");
+  if (i >= 0) {
+    const v = passthrough[i + 1];
+    if (v && !v.startsWith("-")) return v;
+  }
+  try {
+    return (
+      execFileSync("git", ["-C", target, "config", "user.name"], {
+        encoding: "utf8",
+      }).trim() || null
+    );
+  } catch {
+    return null;
+  }
+}

package/src/lib/codex-tweaks.js

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * flower-trellis 对 Trellis 生成的 codex 配置的定制后处理。
+ *
+ * 仅当目标项目已配置 codex 平台(存在 .codex/)时生效;在 init / update 叠加阶段调用,幂等。
+ * 做两件事:
+ *   1. 注释掉 .codex/config.toml 的 [features.multi_agent_v2] 段;
+ *   2. 用指定内容覆盖 .codex/hooks.json —— 在 Trellis 默认(仅 UserPromptSubmit)基础上挂 SessionStart。
+ */
+
+// 期望的 .codex/hooks.json。两个脚本均由 Trellis codex configurator 写入 .codex/hooks/。
+const CODEX_HOOKS = {
+  hooks: {
+    SessionStart: [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: "python3 .codex/hooks/session-start.py",
+            timeout: 5,
+          },
+        ],
+      },
+    ],
+    UserPromptSubmit: [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: "python3 .codex/hooks/inject-workflow-state.py",
+            timeout: 5,
+          },
+        ],
+      },
+    ],
+  },
+};
+
+/**
+ * 注释掉 config.toml 里的 [features.multi_agent_v2] 段(段头 + 段内键,直到下一个 section)。
+ * 幂等:段头已被注释则不再处理。
+ * @returns {boolean} 是否发生改动
+ */
+function commentMultiAgentV2(tomlPath) {
+  if (!fs.existsSync(tomlPath)) return false;
+  const lines = fs.readFileSync(tomlPath, "utf8").split("\n");
+  const out = [];
+  let inSection = false;
+  let changed = false;
+
+  for (const line of lines) {
+    const t = line.trim();
+    if (inSection) {
+      // 段结束:遇到下一个未注释的 section 头
+      if (t.startsWith("[") && !t.startsWith("#")) {
+        inSection = false;
+        out.push(line);
+        continue;
+      }
+      // 段内非空、未注释行 → 注释
+      if (t && !t.startsWith("#")) {
+        out.push("# " + line);
+        changed = true;
+      } else {
+        out.push(line);
+      }
+      continue;
+    }
+    if (t === "[features.multi_agent_v2]") {
+      out.push("# " + line);
+      inSection = true;
+      changed = true;
+      continue;
+    }
+    out.push(line);
+  }
+
+  if (changed) fs.writeFileSync(tomlPath, out.join("\n"));
+  return changed;
+}
+
+/**
+ * 用 flower 指定内容覆盖 .codex/hooks.json。幂等:内容一致则不写。
+ * @returns {boolean} 是否写入
+ */
+function rewriteHooks(hooksPath) {
+  const desired = JSON.stringify(CODEX_HOOKS, null, 2) + "\n";
+  let current = null;
+  try {
+    current = fs.readFileSync(hooksPath, "utf8");
+  } catch {
+    // 文件不存在,视为需要写
+  }
+  if (current === desired) return false;
+  fs.writeFileSync(hooksPath, desired);
+  return true;
+}
+
+/**
+ * codex 平台后处理入口。仅当 .codex/ 存在时执行。
+ * @param {string} target 目标项目根
+ * @returns {{applied: boolean, tomlChanged?: boolean, hooksWritten?: boolean}}
+ */
+export function applyCodexTweaks(target) {
+  const codexDir = path.join(target, ".codex");
+  if (!fs.existsSync(codexDir)) return { applied: false };
+  const tomlChanged = commentMultiAgentV2(path.join(codexDir, "config.toml"));
+  const hooksWritten = rewriteHooks(path.join(codexDir, "hooks.json"));
+  return { applied: true, tomlChanged, hooksWritten };
+}

package/src/lib/copy-skills.js

@@ -0,0 +1,91 @@
+import fs from "node:fs";
+import path from "node:path";
+import { copyPath, listDirs, listFiles, ensureDir } from "./fs-utils.js";
+
+/**
+ * 技能名过滤(移植 install.sh 的 should_install)。
+ * 空清单 → 全装;否则精确匹配,或「去掉 trellis- 前缀后」匹配
+ * (例:传 analyze-task 也命中 trellis-analyze-task)。
+ */
+function shouldInstall(name, skills) {
+  if (!skills || skills.length === 0) return true;
+  const stripped = name.replace(/^trellis-/, "");
+  return skills.some((f) => f === name || f === stripped);
+}
+
+/**
+ * 把指定变体的强化 skill / command 铺到目标项目,**跟随平台**。
+ *
+ * 平台 → 目录映射(对齐 Trellis 各 configurator 实际写入位置):
+ * - claude 平台          → .claude/skills(强化包 .claude/skills 源;old 用 .agents 镜像),
+ *                          command 仅 claude → .claude/commands/trellis
+ * - codex / gemini 等     → 共享层 .agents/skills(强化包 .agents/skills 源)
+ *   (见 Trellis configureCodex:codex 的共享 skill 写在 .agents/skills,非 .codex/skills)
+ *
+ * 「跟随平台」靠检测目标项目已存在的 .claude/ 与 .agents/ 目录实现 —— 这两个目录由
+ * Trellis init 按所选平台创建(claude 建 .claude;codex/gemini 建 .agents),
+ * 因此 init / update / enhance-only 统一用此检测即可自动对齐用户实际选的平台。
+ *
+ * @returns {{ installed: string[], paths: string[] }}
+ */
+export function copySkills(target, variantDir, variant, skills) {
+  const installed = new Set();
+  const paths = [];
+
+  const agentsSrc = path.join(variantDir, ".agents", "skills");
+  const claudeSrc = path.join(variantDir, ".claude", "skills");
+  const cmdSrc = path.join(variantDir, ".claude", "commands", "trellis");
+
+  // 跟随平台:目标已有 .claude → claude 平台;已有 .agents → codex/gemini 等共享层
+  let needClaude = fs.existsSync(path.join(target, ".claude"));
+  let needAgents = fs.existsSync(path.join(target, ".agents"));
+  if (!needClaude && !needAgents) needClaude = true; // 兜底:至少铺 claude
+
+  // codex / gemini 等 → .agents/skills
+  if (needAgents) {
+    ensureDir(path.join(target, ".agents", "skills"));
+    for (const name of listDirs(agentsSrc)) {
+      if (!shouldInstall(name, skills)) continue;
+      copyPath(
+        path.join(agentsSrc, name),
+        path.join(target, ".agents", "skills", name),
+      );
+      installed.add(name);
+      paths.push(`.agents/skills/${name}`);
+    }
+  }
+
+  // claude → .claude/skills(0.5/0.6 源自带;old 源为空,用 .agents 镜像)
+  if (needClaude) {
+    ensureDir(path.join(target, ".claude", "skills"));
+    const claudeNames = listDirs(claudeSrc);
+    const claudeSource = claudeNames.length > 0 ? claudeSrc : agentsSrc;
+    for (const name of listDirs(claudeSource)) {
+      if (!shouldInstall(name, skills)) continue;
+      copyPath(
+        path.join(claudeSource, name),
+        path.join(target, ".claude", "skills", name),
+      );
+      installed.add(name);
+      paths.push(`.claude/skills/${name}`);
+    }
+
+    // command 仅 claude(old 变体)→ .claude/commands/trellis
+    const cmds = listFiles(cmdSrc, ".md");
+    if (cmds.length > 0) {
+      ensureDir(path.join(target, ".claude", "commands", "trellis"));
+      for (const file of cmds) {
+        const name = file.replace(/\.md$/, "");
+        if (!shouldInstall(name, skills)) continue;
+        copyPath(
+          path.join(cmdSrc, file),
+          path.join(target, ".claude", "commands", "trellis", file),
+        );
+        installed.add(name);
+        paths.push(`.claude/commands/trellis/${file}`);
+      }
+    }
+  }
+
+  return { installed: [...installed], paths };
+}

package/src/lib/fs-utils.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/** 确保目录存在(等价 `mkdir -p`)。 */
+export function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+/** 递归删除(等价 `rm -rf`,目标不存在不报错)。 */
+export function rmrf(target) {
+  fs.rmSync(target, { recursive: true, force: true });
+}
+
+/**
+ * 复制文件或目录到目标,已存在则无条件覆盖。
+ *
+ * 移植 skill-garden install.sh 的 install_one 语义:
+ *   - 目标是软链时先删链,避免写穿到链接指向的真实文件;
+ *   - 目标已存在时先整体 rm -rf 再复制,保证不残留被上游删掉的旧文件。
+ *
+ * @param {string} src 源文件/目录
+ * @param {string} dst 目标路径
+ */
+export function copyPath(src, dst) {
+  ensureDir(path.dirname(dst));
+  // lstat 不跟随软链:软链需先删,否则 cpSync 可能写穿
+  try {
+    if (fs.lstatSync(dst).isSymbolicLink()) {
+      fs.unlinkSync(dst);
+    }
+  } catch {
+    // 目标不存在,无需处理
+  }
+  rmrf(dst);
+  fs.cpSync(src, dst, { recursive: true });
+}
+
+/** 列出目录下的直接子目录名;目录不存在返回空数组。 */
+export function listDirs(dir) {
+  try {
+    return fs
+      .readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isDirectory())
+      .map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+
+/** 列出目录下匹配后缀的文件名;目录不存在返回空数组。 */
+export function listFiles(dir, ext) {
+  try {
+    return fs
+      .readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isFile() && (!ext || e.name.endsWith(ext)))
+      .map((e) => e.name);
+  } catch {
+    return [];
+  }
+}

package/src/lib/legacy-blocks.js

@@ -0,0 +1,70 @@
+/**
+ * 0.5 / old 变体的 workflow-state 注入文本常量。
+ *
+ * 这些块在 skill-garden 的 install.sh 里是内嵌 Python 的 `LEGACY_*` 字面量
+ * (0.6 变体的 state 文本改为从 overrides/workflow-states/*.md 读取,不走这里)。
+ * 此处逐字符移植,**包括每个块结尾的两个换行**(state 替换时直接拼接,依赖此尾部空行)。
+ * 改动需与上游 install.sh 保持一致。
+ */
+
+export const LEGACY_NO_TASK_BLOCK = `<!-- BEGIN skill-garden workflow-state no-task-gate v0.5 -->
+HIGHEST PRIORITY NO-TASK GUARD (skill-garden):
+Creating/resuming a task ≠ permission to implement inline.
+After PRD ready and task started, next impl action = \`trellis-route(implement)\`.
+Don't infer opt-out from "small/urgent/unclear" — opt-out requires an explicit phrase in the current message (see C below).
+<!-- END skill-garden workflow-state no-task-gate v0.5 -->
+
+`;
+
+export const LEGACY_PLANNING_BLOCK = `<!-- BEGIN skill-garden workflow-state planning-handoff v0.5 -->
+HIGHEST PRIORITY PLANNING GUARD (skill-garden):
+Planning is not implementation permission.
+Complete prd.md + context first.
+After in_progress, next action = \`trellis-route(implement)\`, not direct edits.
+<!-- END skill-garden workflow-state planning-handoff v0.5 -->
+
+`;
+
+export const LEGACY_PUSH_PROGRESS_BLOCK = `<!-- BEGIN skill-garden workflow-state push-progress-recovery v0.6 -->
+PUSH PROGRESS RECOVERY (skill-garden):
+If you haven't already relayed recovery in this session, scan
+\`.trellis/tasks/*/task.json\` for entries where status="in_progress" AND a
+\`last_push_snapshot\` field is present (schema: snapshot_at / branch /
+pushed_commits / completed_steps / partial_step / next_step / notes).
+For each match, surface to the user:
+  「发现未完成任务 <title>:上次 push 完成到 <completed_steps>,下一步 <next_step>。要继续吗?」
+If multiple match, list them with \`snapshot_at\` so the user can pick.
+Then suggest \`python3 ./.trellis/scripts/task.py start <task_path>\` to
+re-bind the active-task pointer before resuming work.
+Skip this hint if (a) you've already relayed recovery this session, or
+(b) no in_progress task carries \`last_push_snapshot\`.
+<!-- END skill-garden workflow-state push-progress-recovery v0.6 -->
+
+`;
+
+export const LEGACY_IN_PROGRESS_BLOCK = `<!-- BEGIN skill-garden workflow-state trellis-route v0.5 -->
+HIGHEST PRIORITY ROUTE GUARD (skill-garden):
+This guard is intentionally appended after upstream in_progress breadcrumbs and overrides earlier direct-dispatch defaults in this same <workflow-state>.
+At Phase 2.1/2.2/3.1, invoke \`trellis-route(implement|check)\` first, including every check / check-all path.
+Codex \`dispatch_mode: sub-agent\` only makes subagent a selectable route outcome; it is not permission to bypass \`trellis-route\`.
+Do NOT spawn \`trellis-implement\` / \`trellis-check\` / \`trellis-check-all\` directly from the main session unless \`trellis-route\` just selected a subagent mode.
+If \`trellis-route\` selected inline mode, load \`trellis-before-dev\` / \`trellis-check\` / \`trellis-check-all\` as applicable and execute in the main session.
+If \`trellis-route\` or its interactive helper is unavailable, present the same numbered route choices in normal chat and wait for the user's selection; do not record an inline/subagent choice yourself.
+CHECK RULE: check never uses \`.trellis/.route-prefs.tmp\`; ask every time before \`trellis-check\`, \`trellis-check-all\`, or their subagents.
+ANTI-DEFER: at phase boundaries, never ask meta questions ("X or Y?", "continue?", "what's next?") — invoke \`trellis-route(check)\` instead, or ask the numbered route choices if the helper is unavailable.
+<!-- END skill-garden workflow-state trellis-route v0.5 -->
+
+`;
+
+export const LEGACY_PUSH_SNAPSHOT_BLOCK = `<!-- BEGIN skill-garden workflow-state in-progress-push-snapshot v0.6 -->
+IN-PROGRESS PUSH SNAPSHOT (skill-garden):
+The active task's task.json may carry a \`last_push_snapshot\` field (schema:
+snapshot_at / branch / pushed_commits / completed_steps / partial_step /
+next_step / notes). Before starting new work this turn, read that field; if
+present, briefly relay \`partial_step\` + \`next_step\` so the user knows you
+recognize the paused state instead of restarting from scratch. Skip if you
+have already relayed this snapshot earlier in the session, or if the field
+is absent.
+<!-- END skill-garden workflow-state in-progress-push-snapshot v0.6 -->
+
+`;

package/src/lib/manifest.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * flower-trellis 自己的安装清单。
+ *
+ * 记录「flower 上一次为该项目铺设了哪些强化文件」,使升级(如 0.5/old → 0.6)时
+ * 能精确删除当前变体不再包含的过期 skill / command —— 只删自己铺过的路径,
+ * 绝不误删用户或 Trellis 本体的文件。
+ *
+ * 放在 .trellis/ 下,随项目的 Trellis 生命周期存在(uninstall 删 .trellis 时一并消失)。
+ */
+const MANIFEST_REL = path.join(".trellis", ".flower-manifest.json");
+
+/** manifest 文件的绝对路径。 */
+export function manifestPath(target) {
+  return path.join(target, MANIFEST_REL);
+}
+
+/** 读取 manifest;不存在或损坏时返回 null。 */
+export function readManifest(target) {
+  try {
+    return JSON.parse(fs.readFileSync(manifestPath(target), "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+/** 写入 manifest。 */
+export function writeManifest(target, data) {
+  fs.writeFileSync(manifestPath(target), JSON.stringify(data, null, 2) + "\n");
+}

package/src/lib/paths.js

@@ -0,0 +1,16 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * 包内路径定位。
+ *
+ * ESM 没有 __dirname,统一用 import.meta.url 推导。本文件位于 <pkg>/src/lib/,
+ * 故包根是其上两级目录。
+ */
+const here = path.dirname(fileURLToPath(import.meta.url)); // .../src/lib
+
+/** flower-trellis 包根目录。 */
+export const PKG_ROOT = path.resolve(here, "..", "..");
+
+/** 随包发布的强化包快照根目录(由 scripts/sync-enhancements.mjs 生成)。 */
+export const ENHANCEMENTS_ROOT = path.join(PKG_ROOT, "enhancements");

package/src/lib/pick-platforms.js

@@ -0,0 +1,57 @@
+import inquirer from "inquirer";
+
+/**
+ * 平台多选清单 —— flower 自己的平台选择菜单。
+ *
+ * 为什么 flower 自己出菜单:Trellis 原生平台菜单的默认勾选写死为 Claude Code + Cursor
+ * (types/ai-tools.ts 的 defaultChecked),外部 wrapper 改不了。这里默认勾 Claude Code + Codex,
+ * 用户选完后把 value(= trellis init 的平台 flag)透传给 trellis。
+ *
+ * name 取自 Trellis types/ai-tools.ts;value 为对应 CLI flag。
+ */
+const PLATFORMS = [
+  { name: "Claude Code", value: "--claude", checked: true },
+  {
+    name: "Codex(同时写 .agents/skills/ — Cursor / Gemini CLI / GitHub Copilot 等可读)",
+    value: "--codex",
+    checked: true,
+  },
+  { name: "Cursor", value: "--cursor" },
+  { name: "OpenCode", value: "--opencode" },
+  { name: "Gemini CLI", value: "--gemini" },
+  { name: "Kilo CLI", value: "--kilo" },
+  { name: "Kiro Code", value: "--kiro" },
+  { name: "Antigravity", value: "--antigravity" },
+  { name: "Windsurf", value: "--windsurf" },
+  { name: "Qoder", value: "--qoder" },
+  { name: "CodeBuddy", value: "--codebuddy" },
+  { name: "GitHub Copilot", value: "--copilot" },
+  { name: "Factory Droid", value: "--droid" },
+  { name: "Pi", value: "--pi" },
+  { name: "Reasonix", value: "--reasonix" },
+];
+
+/**
+ * 弹出平台多选菜单,返回选中的 trellis 平台 flag 数组(如 ["--claude","--codex"])。
+ * 非 TTY(无法交互)时回退到默认 codex + claude。
+ *
+ * @returns {Promise<string[]>}
+ */
+export async function pickPlatforms() {
+  if (!process.stdin.isTTY) return ["--codex", "--claude"];
+  const { tools } = await inquirer.prompt([
+    {
+      type: "checkbox",
+      name: "tools",
+      message:
+        "选择要配置的 AI 工具(空格勾选 / 回车确认,默认已勾 Claude Code + Codex):",
+      choices: PLATFORMS.map((p) => ({
+        name: p.name,
+        value: p.value,
+        checked: !!p.checked,
+      })),
+      loop: false,
+    },
+  ]);
+  return tools;
+}