flower-trellis 0.3.0-beta.0 → 0.3.0-beta.1

package/enhancements/0.6/.agents/skills/trellis-route/SKILL.md

@@ -20,6 +20,8 @@ description: |
 
 个人 route 配置只决定“已获准执行后的模式”，不是开工授权。读取 `.trellis/.route-prefs.tmp` 前，必须确认当前 workflow 已允许进入对应 target：implement 需要任务已完成规划确认并处于 `in_progress`；check 需要已有本轮实现变更或用户明确要求检查。如果仍在 planning、等待用户确认，或用户表达“等一下 / 我再想想”，停止，不读取个人配置。
 
+Codex inline mode 只表示主会话默认直接执行，不是 route 选项过滤器。即使当前上下文出现 `<codex-mode>inline...do not dispatch...</codex-mode>` 或 `workflow-state:in_progress-inline`，也不能推断“只能 inline”或跳过 subagent 选项；仍必须读取 `.trellis/.route-prefs.tmp`，或在无有效配置时展示正常 inline/subagent 选项。若本 skill 的紧邻路由决定是 subagent，本步骤允许主 agent dispatch 对应 implement/check sub-agent；禁止的是绕过 `trellis-route` 直接 dispatch。
+
 先判断本次路由目标：
 
 - `target=implement`：决定 `inline` / `subagent`。
@@ -239,6 +241,7 @@ OLD_CHECK=$(awk -F= '$1=="check"{print $2}' "$PREF_FILE" 2>/dev/null | tail -n 1
 5. **轻量 check 是隐藏逃生口**：只有用户明确请求 `light check` / `轻量检查` 时才可走轻量 `trellis-check`。
 6. **决策与执行分离**：本 skill 只输出指令，下一轮由主 agent 调工具。
 7. **严格执行用户选择**：路由结论一旦输出，主 agent 必须按指令执行，不可“出于谨慎”再换路径。
+8. **Codex inline 不裁剪选项**：Codex inline 是默认执行模式，不是只能 inline 的强制模式；route 明确选中 subagent 时，本步骤可按 subagent 路径执行。
 
 ---
 
@@ -252,6 +255,7 @@ OLD_CHECK=$(awk -F= '$1=="check"{print $2}' "$PREF_FILE" 2>/dev/null | tail -n 1
 - `AskUserQuestion` / `request_user_input` 不可用时，记录为 inline 或 subagent 路径并继续。
 - 给 check 任何模式附加“跳过编译”指令。
 - 询问后忽视用户答案默认 subagent。
+- 因 `<codex-mode>` 或 `in_progress-inline` 提到 inline，就自行把无配置 route 结果改成 inline 或隐藏 subagent 选项。
 
 ---
 

package/enhancements/0.6/.claude/skills/trellis-route/SKILL.md

@@ -20,6 +20,8 @@ description: |
 
 个人 route 配置只决定“已获准执行后的模式”，不是开工授权。读取 `.trellis/.route-prefs.tmp` 前，必须确认当前 workflow 已允许进入对应 target：implement 需要任务已完成规划确认并处于 `in_progress`；check 需要已有本轮实现变更或用户明确要求检查。如果仍在 planning、等待用户确认，或用户表达“等一下 / 我再想想”，停止，不读取个人配置。
 
+Codex inline mode 只表示主会话默认直接执行，不是 route 选项过滤器。即使当前上下文出现 `<codex-mode>inline...do not dispatch...</codex-mode>` 或 `workflow-state:in_progress-inline`，也不能推断“只能 inline”或跳过 subagent 选项；仍必须读取 `.trellis/.route-prefs.tmp`，或在无有效配置时展示正常 inline/subagent 选项。若本 skill 的紧邻路由决定是 subagent，本步骤允许主 agent dispatch 对应 implement/check sub-agent；禁止的是绕过 `trellis-route` 直接 dispatch。
+
 先判断本次路由目标：
 
 - `target=implement`：决定 `inline` / `subagent`。
@@ -239,6 +241,7 @@ OLD_CHECK=$(awk -F= '$1=="check"{print $2}' "$PREF_FILE" 2>/dev/null | tail -n 1
 5. **轻量 check 是隐藏逃生口**：只有用户明确请求 `light check` / `轻量检查` 时才可走轻量 `trellis-check`。
 6. **决策与执行分离**：本 skill 只输出指令，下一轮由主 agent 调工具。
 7. **严格执行用户选择**：路由结论一旦输出，主 agent 必须按指令执行，不可“出于谨慎”再换路径。
+8. **Codex inline 不裁剪选项**：Codex inline 是默认执行模式，不是只能 inline 的强制模式；route 明确选中 subagent 时，本步骤可按 subagent 路径执行。
 
 ---
 
@@ -252,6 +255,7 @@ OLD_CHECK=$(awk -F= '$1=="check"{print $2}' "$PREF_FILE" 2>/dev/null | tail -n 1
 - `AskUserQuestion` / `request_user_input` 不可用时，记录为 inline 或 subagent 路径并继续。
 - 给 check 任何模式附加“跳过编译”指令。
 - 询问后忽视用户答案默认 subagent。
+- 因 `<codex-mode>` 或 `in_progress-inline` 提到 inline，就自行把无配置 route 结果改成 inline 或隐藏 subagent 选项。
 
 ---
 

package/enhancements/0.6/overrides/workflow-states/in_progress-inline.md

@@ -1,6 +1,6 @@
 <!-- BEGIN skill-garden workflow-state in_progress_inline v0.6 -->
 HIGHEST PRIORITY SKILL-GARDEN STATE GUARD (in_progress-inline):
-Inline mode does not skip `trellis-route`: before implementation, route `implement` first; before checking, route `check` first. Only after the route selects inline should the main session run `trellis-before-dev`, edit code, or run `trellis-check` / `trellis-check-all`.
+Inline mode does not skip or constrain `trellis-route`: before implementation, route `implement` first; before checking, route `check` first. The default inline flow is direct main-session work, but if the immediate route decision selects subagent, that decision permits dispatch for this step.
 After `trellis-check` / `trellis-check-all`, stop and report; do not run `/trellis:finish-work` unless the user explicitly asks after Phase 3.4 is complete.
 This guard overrides any lower `Flow: ... -> /trellis:finish-work` line in this state block.
 At Phase 3.4, code commit/push still goes through `trellis-push` (commit-only for commit-without-push); never bare `git commit`/`git push` on code (hub: Code Commit Confirmation Gate).

package/enhancements/MANIFEST.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-06-16T07:52:49.765Z",
+  "syncedAt": "2026-06-16T11:04:55.690Z",
   "syncedFrom": "vendor/skill-garden/.trellis",
-  "sourceCommit": "d05cb9de53e0ca04f854a5471d24f4df542f0c0f",
+  "sourceCommit": "987263bc8fce1e6057ba5624a9f8d1c8d4d40fe4",
   "variants": {
     "old": {
       "claudeSkills": [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flower-trellis",
-  "version": "0.3.0-beta.0",
+  "version": "0.3.0-beta.1",
   "description": "一键安装/升级 Trellis 并自动融合 skill-garden 强化包(默认 Claude + agents)",
   "type": "module",
   "bin": {

package/src/lib/apply-enhancements.js

@@ -129,13 +129,16 @@ export function applyEnhancements(target, opts = {}) {
     }
   }
 
-  // codex 平台后处理:旧 multi_agent_v2 兼容清理 + 合并 SessionStart hook(仅当 .codex/ 存在)
+  // codex 平台后处理:旧 multi_agent_v2 兼容清理 + 合并 SessionStart hook + 强制 sub-agent 调度
   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`);
+    const dispatch = codex.dispatchModeChanged
+      ? "dispatch_mode 已强制为 sub-agent"
+      : "dispatch_mode 已是 sub-agent";
+    console.log(`  ✓ codex 调整:${seg};hooks.json 已合并 SessionStart;${dispatch}`);
   }
 
   return { variant, installed };

package/src/lib/codex-tweaks.js

@@ -5,13 +5,153 @@ import path from "node:path";
  * flower-trellis 对 Trellis 生成的 codex 配置的定制后处理。
  *
  * 仅当目标项目已配置 codex 平台(存在 .codex/)时生效;在 init / update 叠加阶段调用,幂等。
- * 做两件事:
+ * 做三件事:
  *   1. 兼容旧 Trellis:注释掉 .codex/config.toml 的 [features.multi_agent_v2] 段;
  *   2. 合并 .codex/hooks.json —— 保留 Trellis 上游 hook 设置,只补 flower 需要的 SessionStart。
+ *   3. 强制 .trellis/config.yaml 的 codex.dispatch_mode 为 sub-agent。
  */
 
 const WORKFLOW_HOOK_SCRIPT = ".codex/hooks/inject-workflow-state.py";
 const SESSION_START_SCRIPT = ".codex/hooks/session-start.py";
+const CODEX_DISPATCH_MODE = "sub-agent";
+
+/** 返回一行开头的空白缩进。 */
+function leadingWhitespace(line) {
+  return line.match(/^\s*/)?.[0] || "";
+}
+
+/** 判断一行是否是未注释的顶层 YAML key。 */
+function isTopLevelKey(line) {
+  const trimmed = line.trim();
+  return Boolean(trimmed && !trimmed.startsWith("#") && !leadingWhitespace(line) && /^[^:#]+:/.test(trimmed));
+}
+
+/** 找到未注释的顶层 `codex:` 块行号。 */
+function findCodexBlockStart(lines) {
+  return lines.findIndex((line) => {
+    const trimmed = line.trim();
+    return isTopLevelKey(line) && /^codex\s*:/.test(trimmed);
+  });
+}
+
+/** 找到 YAML 顶层块结束位置,注释和空行不结束当前块。 */
+function findTopLevelBlockEnd(lines, start) {
+  for (let i = start + 1; i < lines.length; i += 1) {
+    if (isTopLevelKey(lines[i])) return i;
+  }
+  return lines.length;
+}
+
+/** 按逗号拆分 YAML inline map 内容,保留引号内逗号。 */
+function splitInlineMapItems(content) {
+  const items = [];
+  let quote = "";
+  let token = "";
+  for (const ch of content) {
+    if (quote) {
+      token += ch;
+      if (ch === quote) quote = "";
+      continue;
+    }
+    if (ch === "\"" || ch === "'") {
+      quote = ch;
+      token += ch;
+      continue;
+    }
+    if (ch === ",") {
+      if (token.trim()) items.push(token.trim());
+      token = "";
+      continue;
+    }
+    token += ch;
+  }
+  if (token.trim()) items.push(token.trim());
+  return items;
+}
+
+/** 解析简单 YAML inline map,失败时返回 null。 */
+function parseInlineMapEntries(value) {
+  if (!value.startsWith("{") || !value.endsWith("}")) return null;
+  const body = value.slice(1, -1).trim();
+  if (!body) return [];
+  const entries = [];
+  for (const item of splitInlineMapItems(body)) {
+    const [key, ...rest] = item.split(":");
+    if (!key || rest.length === 0) return null;
+    entries.push({ key: key.trim(), value: rest.join(":").trim() });
+  }
+  return entries;
+}
+
+/**
+ * 强制目标项目 `.trellis/config.yaml` 使用 Codex sub-agent 调度。
+ *
+ * Trellis 默认缺失该字段时按 inline 注入 `<codex-mode>`,会让 route 误判 subagent
+ * 不可执行。flower 在 Codex 目标上直接写真实配置,避免依赖注释示例或模型推断。
+ *
+ * @param {string} configPath 目标项目 `.trellis/config.yaml` 路径
+ * @returns {boolean} 是否写入
+ */
+function forceCodexDispatchMode(configPath) {
+  const current = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : "";
+  const normalized = current.replace(/\r\n/g, "\n");
+  const hadFinalNewline = normalized.endsWith("\n");
+  const lines = normalized.length === 0
+    ? []
+    : normalized.replace(/\n$/, "").split("\n");
+
+  const codexStart = findCodexBlockStart(lines);
+  if (codexStart === -1) {
+    if (lines.length > 0 && lines[lines.length - 1].trim()) lines.push("");
+    lines.push("codex:", `  dispatch_mode: ${CODEX_DISPATCH_MODE}`);
+  } else {
+    const blockEnd = findTopLevelBlockEnd(lines, codexStart);
+    const codexMatch = lines[codexStart].match(/^(\s*)codex\s*:\s*(.*)$/);
+    const codexIndent = codexMatch?.[1] || "";
+    const codexValue = (codexMatch?.[2] || "").trim();
+    const inlineEntries = parseInlineMapEntries(codexValue);
+    if (inlineEntries) {
+      const nextLines = [`${codexIndent}codex:`];
+      let hasDispatchMode = false;
+      for (const entry of inlineEntries) {
+        if (entry.key === "dispatch_mode") {
+          hasDispatchMode = true;
+          nextLines.push(`${codexIndent}  dispatch_mode: ${CODEX_DISPATCH_MODE}`);
+        } else {
+          nextLines.push(`${codexIndent}  ${entry.key}: ${entry.value}`);
+        }
+      }
+      if (!hasDispatchMode) {
+        nextLines.splice(1, 0, `${codexIndent}  dispatch_mode: ${CODEX_DISPATCH_MODE}`);
+      }
+      lines.splice(codexStart, 1, ...nextLines);
+    } else if (codexValue && !codexValue.startsWith("#")) {
+      lines[codexStart] = `${codexIndent}codex:`;
+    }
+
+    const nextBlockEnd = inlineEntries
+      ? findTopLevelBlockEnd(lines, codexStart)
+      : blockEnd;
+    const dispatchIndex = lines.findIndex((line, index) => {
+      if (index <= codexStart || index >= nextBlockEnd) return false;
+      const trimmed = line.trim();
+      return Boolean(trimmed && !trimmed.startsWith("#") && /^dispatch_mode\s*:/.test(trimmed));
+    });
+
+    if (dispatchIndex === -1) {
+      lines.splice(codexStart + 1, 0, `${codexIndent}  dispatch_mode: ${CODEX_DISPATCH_MODE}`);
+    } else {
+      const indent = leadingWhitespace(lines[dispatchIndex]);
+      lines[dispatchIndex] = `${indent}dispatch_mode: ${CODEX_DISPATCH_MODE}`;
+    }
+  }
+
+  const desired = lines.join("\n") + (hadFinalNewline || lines.length > 0 ? "\n" : "");
+  if (current === desired) return false;
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, desired);
+  return true;
+}
 
 /**
  * 注释掉 config.toml 里的 [features.multi_agent_v2] 段(段头 + 段内键,直到下一个 section)。
@@ -141,12 +281,13 @@ function mergeHooks(hooksPath) {
 /**
  * codex 平台后处理入口。仅当 .codex/ 存在时执行。
  * @param {string} target 目标项目根
- * @returns {{applied: boolean, tomlChanged?: boolean, hooksWritten?: boolean}}
+ * @returns {{applied: boolean, tomlChanged?: boolean, hooksWritten?: boolean, dispatchModeChanged?: 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 = mergeHooks(path.join(codexDir, "hooks.json"));
-  return { applied: true, tomlChanged, hooksWritten };
+  const dispatchModeChanged = forceCodexDispatchMode(path.join(target, ".trellis", "config.yaml"));
+  return { applied: true, tomlChanged, hooksWritten, dispatchModeChanged };
 }