flower-trellis 0.6.0-beta.4 → 0.6.0-beta.5

package/enhancements/0.6/.agents/skills/trellis-flower-update/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: trellis-flower-update
+description: "手动检查和执行已安装 Flower/Trellis 强化包升级。用于用户明确要求更新或升级 flower-trellis、Flower、Trellis 强化包、skill-garden 快照、项目 flower 版本追平，或自动更新提示被稍后/跳过后仍想在对话里升级时。不要用于用户说想发版、发布版本、release、打 tag、npm publish 或修改 package 版本号；这些属于项目发版流程。"
+---
+
+# Trellis Flower Update
+
+用于用户主动要求升级已安装的 Flower/Trellis 强化层时。自动 SessionStart 提示的 snooze、skip 和 cooldown 只是不主动打扰，不能阻止用户显式要求升级。
+
+本 skill 不是发版入口。用户说“我想发版了”、release、打 tag、npm publish、更新 package 版本号或准备发布包时，不使用本 skill；按当前项目的 release SOP、`trellis-release` 或发布规范处理。
+
+## Workflow
+
+1. 确认目标项目。用户给出路径时使用该路径，否则使用当前工作目录。
+2. 运行人工检查，默认强制刷新远端版本证据：
+
+```bash
+flower-trellis self-check --json --manual --force-remote --target <target>
+```
+
+3. 解析 JSON：
+   - `update_available`：展示当前版本、推荐版本、release notes 摘要和 `commands.recommended`。
+   - `project_out_of_sync`：展示当前 Flower/Trellis 与项目记录的差异，并展示 `commands.recommended`。
+   - `up_to_date`：说明当前安装和项目记录已一致。
+   - `disabled` / `offline` / `skipped`：说明原因；不要靠重置缓存伪造可执行状态。
+4. 写入前遵守确认和安全门槛：
+   - 用户当前消息已经明确要求执行升级时，可以执行 `commands.recommended`。
+   - 用户只是询问、查看或比较版本时，只展示结果并等待确认。
+   - `safety.reasons` 非空时，先说明风险，再等待用户明确确认。
+5. 执行推荐命令后读取 `<flower-update-result>`。如果结果要求 `run_trellis_push_confirmation`，进入 `trellis-push`，展示文件和 commit message 后等待确认。
+
+## Rules
+
+- 不直接读写 `.flower/update-check.tmp`。
+- 不使用 `update-check reset`、`snooze` 或 `skip` 作为升级绕过手段。
+- 不运行 `npm run release`、不打 tag、不 publish，也不修改 `package.json` 版本号。
+- 不把 `self-check --manual` 用在 SessionStart 自动 hook；自动路径必须继续尊重提示节流。
+- 目标项目有脏文件、活动任务或命令缺失时，按 `safety.reasons` 报告并等待用户确认。

package/enhancements/0.6/.claude/skills/trellis-flower-update/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: trellis-flower-update
+description: "手动检查和执行已安装 Flower/Trellis 强化包升级。用于用户明确要求更新或升级 flower-trellis、Flower、Trellis 强化包、skill-garden 快照、项目 flower 版本追平，或自动更新提示被稍后/跳过后仍想在对话里升级时。不要用于用户说想发版、发布版本、release、打 tag、npm publish 或修改 package 版本号；这些属于项目发版流程。"
+---
+
+# Trellis Flower Update
+
+用于用户主动要求升级已安装的 Flower/Trellis 强化层时。自动 SessionStart 提示的 snooze、skip 和 cooldown 只是不主动打扰，不能阻止用户显式要求升级。
+
+本 skill 不是发版入口。用户说“我想发版了”、release、打 tag、npm publish、更新 package 版本号或准备发布包时，不使用本 skill；按当前项目的 release SOP、`trellis-release` 或发布规范处理。
+
+## Workflow
+
+1. 确认目标项目。用户给出路径时使用该路径，否则使用当前工作目录。
+2. 运行人工检查，默认强制刷新远端版本证据：
+
+```bash
+flower-trellis self-check --json --manual --force-remote --target <target>
+```
+
+3. 解析 JSON：
+   - `update_available`：展示当前版本、推荐版本、release notes 摘要和 `commands.recommended`。
+   - `project_out_of_sync`：展示当前 Flower/Trellis 与项目记录的差异，并展示 `commands.recommended`。
+   - `up_to_date`：说明当前安装和项目记录已一致。
+   - `disabled` / `offline` / `skipped`：说明原因；不要靠重置缓存伪造可执行状态。
+4. 写入前遵守确认和安全门槛：
+   - 用户当前消息已经明确要求执行升级时，可以执行 `commands.recommended`。
+   - 用户只是询问、查看或比较版本时，只展示结果并等待确认。
+   - `safety.reasons` 非空时，先说明风险，再等待用户明确确认。
+5. 执行推荐命令后读取 `<flower-update-result>`。如果结果要求 `run_trellis_push_confirmation`，进入 `trellis-push`，展示文件和 commit message 后等待确认。
+
+## Rules
+
+- 不直接读写 `.flower/update-check.tmp`。
+- 不使用 `update-check reset`、`snooze` 或 `skip` 作为升级绕过手段。
+- 不运行 `npm run release`、不打 tag、不 publish，也不修改 `package.json` 版本号。
+- 不把 `self-check --manual` 用在 SessionStart 自动 hook；自动路径必须继续尊重提示节流。
+- 目标项目有脏文件、活动任务或命令缺失时，按 `safety.reasons` 报告并等待用户确认。

package/enhancements/MANIFEST.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-08-04T10:14:37.206Z",
+  "syncedAt": "2026-08-04T12:07:53.744Z",
   "syncedFrom": "vendor/skill-garden",
-  "sourceCommit": "5dbd85563bd521a93fcde4fe8b3e00993d75e7b6",
+  "sourceCommit": "634fdd29a3110498b74494cdecceb4a181363e77",
   "common": {
     "codexSkills": [
       "aliyun-sls-query",
@@ -105,6 +105,7 @@
         "trellis-create-command",
         "trellis-diff-brief",
         "trellis-extract-prd",
+        "trellis-flower-update",
         "trellis-plan-version",
         "trellis-push",
         "trellis-release",
@@ -121,6 +122,7 @@
         "trellis-create-command",
         "trellis-diff-brief",
         "trellis-extract-prd",
+        "trellis-flower-update",
         "trellis-plan-version",
         "trellis-push",
         "trellis-release",

package/enhancements/common/.common/.claude/skills/aliyun-sls-query/SKILL.md

@@ -120,6 +120,8 @@ for _ in range(300):
 - `from`/`to` 是 unix **秒**（不是毫秒）。
 - `query` 是全文/索引查询串（如 `ERROR`、`status>=500 and method:POST`）；`topic` 按 `__topic__` 精确过滤，两者可叠加。
 - `reverse=true` 最新在前，排障看最新日志必开。
+- **project/logstore 选择纪律**：不能只凭 project 名称“看起来像生产”或业务词相似就先查。先用用户给出的系统线索、服务名、应用名或已知前缀锚定 project（例如 SRM/supplier/API 应优先核对 `xhgj-zysys` 这类系统 project，而不是把 `xhxhgjmall` 仅因看起来像线上业务就当主入口）；再列该 project 的 logstore，并用 logstore 名、service/app 标记、已知 traceid 或 Request URL 反查确认。多个 K8s/业务 project 并存时，把未验证项目列为候选，不要直接下结论。
+- **Java Forest/HTTP trace 配对纪律**：不能用“某条 trace 链路里出现 404”反推“目标接口本身 404”。同一 trace 里可能有多个外部请求，状态码各不相同；必须按时间回查完整链路，把 `[Forest] Request`、`Response: Status = ...`、`调用接口异常` 配对后，再判断具体哪个 Request URL 失败。
 - 典型场景——**FC custom-container 排障**：FC 控制面只给 `operation not permitted` / `CAExited` 这类兜底信息，**真因（Java 堆栈等）在容器 stdout/stderr，落在 SLS**。FC 日志的 topic 形态是 `FCLogs:<函数名>`，用 `--topic` 精确过滤比全文查询准。
 - 多行日志（Java 堆栈）是否合并成一条，取决于采集端配置（如 K8s 采集 CRD 的 Multiline 配置），查询侧改不了；散成 N 条时按 `__time__` + 实例 id 拼回去。
 

package/enhancements/common/.common/.codex/skills/aliyun-sls-query/SKILL.md

@@ -120,6 +120,8 @@ for _ in range(300):
 - `from`/`to` 是 unix **秒**（不是毫秒）。
 - `query` 是全文/索引查询串（如 `ERROR`、`status>=500 and method:POST`）；`topic` 按 `__topic__` 精确过滤，两者可叠加。
 - `reverse=true` 最新在前，排障看最新日志必开。
+- **project/logstore 选择纪律**：不能只凭 project 名称“看起来像生产”或业务词相似就先查。先用用户给出的系统线索、服务名、应用名或已知前缀锚定 project（例如 SRM/supplier/API 应优先核对 `xhgj-zysys` 这类系统 project，而不是把 `xhxhgjmall` 仅因看起来像线上业务就当主入口）；再列该 project 的 logstore，并用 logstore 名、service/app 标记、已知 traceid 或 Request URL 反查确认。多个 K8s/业务 project 并存时，把未验证项目列为候选，不要直接下结论。
+- **Java Forest/HTTP trace 配对纪律**：不能用“某条 trace 链路里出现 404”反推“目标接口本身 404”。同一 trace 里可能有多个外部请求，状态码各不相同；必须按时间回查完整链路，把 `[Forest] Request`、`Response: Status = ...`、`调用接口异常` 配对后，再判断具体哪个 Request URL 失败。
 - 典型场景——**FC custom-container 排障**：FC 控制面只给 `operation not permitted` / `CAExited` 这类兜底信息，**真因（Java 堆栈等）在容器 stdout/stderr，落在 SLS**。FC 日志的 topic 形态是 `FCLogs:<函数名>`，用 `--topic` 精确过滤比全文查询准。
 - 多行日志（Java 堆栈）是否合并成一条，取决于采集端配置（如 K8s 采集 CRD 的 Multiline 配置），查询侧改不了；散成 N 条时按 `__time__` + 实例 id 拼回去。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flower-trellis",
-  "version": "0.6.0-beta.4",
+  "version": "0.6.0-beta.5",
   "description": "一键安装/升级 Trellis 并自动融合 skill-garden 强化包(默认 Claude + agents)",
   "type": "module",
   "bin": {
@@ -68,9 +68,9 @@
     "commit-and-tag-version": "^12.7.3"
   },
   "flowerReleaseNotes": {
-    "version": "0.6.0-beta.4",
+    "version": "0.6.0-beta.5",
     "source": "CHANGELOG.md",
-    "body": "### ✨ 新功能 Features\n\n* **common:** 升级 humanize-writing 去 AI 味流程 ([c02910c](https://github.com/SilentFlower/flower-trellis/commit/c02910c0e9bb7f31c221f0f927df2254309f8e92))\n* **trellis:** 新增 linked worktree 入口准备能力 ([5af8e7a](https://github.com/SilentFlower/flower-trellis/commit/5af8e7ad3f5fcbe839a27fd518a4d0341da9bc5d))",
+    "body": "### ✨ 新功能 Features\n\n* **update:** 新增对话内 Flower 手动升级入口 ([b1df949](https://github.com/SilentFlower/flower-trellis/commit/b1df949cfc42bee5fd2d2b98fef5dd2870386bbb))",
     "truncated": false
   },
   "optionalDependencies": {

package/src/cli.js

@@ -71,7 +71,8 @@ function printHelp() {
 用法:
   flower-trellis [init] [trellis flags] [flower flags]   安装 + 叠加强化包(默认命令)
   flower-trellis update [trellis flags] [flower flags]   升级 + 按新版本重新叠加
-  flower-trellis self-check --json [--target <dir>]      输出启动更新检查 JSON
+  flower-trellis self-check --json [--manual] [--target <dir>]
+                                                        输出启动更新检查 JSON
   flower-trellis self-update --target <dir> --yes        自更新 + 项目重叠加
   flower-trellis update-check <get|set|disable|enable|snooze|skip|reset>
                                                         管理启动更新策略
@@ -91,7 +92,7 @@ flower 自有 flag:
   --backup-retention <n>   update 成功后保留最近 n 份升级备份(默认 3,0=不清理)
 
 启动更新检查:
-  self-check --json                 稳定输出检查 JSON
+  self-check --json [--manual]      稳定输出检查 JSON；manual 只绕过提示节流
   self-update --yes [--dry-run]     执行或预览全局更新与项目 update
   update-check set --policy <off|notify|ask|auto> [--interval-hours <n>]
   update-check snooze [--hours <n>|--days <n>]  延后当前更新提示(默认 7 天)

package/src/commands/self-check.js

@@ -12,12 +12,15 @@ import { reportTelemetry } from "../lib/telemetry.js";
  */
 export async function selfCheck(ctx) {
   const forceRemote = ctx.passthrough.includes("--force-remote");
+  const manual = ctx.passthrough.includes("--manual") ||
+    ctx.passthrough.includes("--ignore-prompt-suppression");
   if (ctx.updateCheck === false) {
     process.env.FLOWER_NO_UPDATE_CHECK = "1";
   }
   const result = await buildSelfCheck(ctx.target, {
     forceRemote,
-    recordPrompt: true,
+    ignorePromptSuppression: manual,
+    recordPrompt: !manual,
     onRemoteCheck: () => reportTelemetry(ctx.target, "version_check"),
   });
   console.log(JSON.stringify(result, null, 2));

package/src/commands/self-update.js

@@ -123,6 +123,7 @@ export async function selfUpdate(ctx) {
   const check = await buildSelfCheck(ctx.target, {
     writeCache: !dryRun,
     forceRemote: !projectOnly,
+    ignorePromptSuppression: true,
   });
   const shouldInstallFlower = !projectOnly && check.status === "update_available" && check.recommendation;
   const effectiveSafety = check.safety || safetyState(

package/src/lib/skill-catalog.js

@@ -55,6 +55,7 @@ const SKILL_DESCRIPTION_OVERRIDES = {
   "trellis-diff-brief": "快速总结当前 git 改动",
   "trellis-draw-uml": "绘制 UML 活动图梳理业务流程",
   "trellis-extract-prd": "从需求文档提取任务 PRD",
+  "trellis-flower-update": "手动追平已安装 Flower 强化包",
   "trellis-migrate-skill": "迁移旧命令为 Trellis skill",
   "trellis-plan-version": "规划版本任务、波次和分工",
   "trellis-push": "提交、推送并同步任务进度",
@@ -67,6 +68,7 @@ const SKILL_DESCRIPTION_OVERRIDES = {
   "trellis-verify-task": "校验任务文档是否覆盖需求",
   "trellis-verify-prd": "校验 PRD 准确性和覆盖度",
   "trellis-visualize": "生成架构、流程或状态图",
+  "trellis-worktree": "准备 linked worktree 的 Trellis 入口",
 };
 
 /**