flower-trellis 0.6.1-beta.5 → 0.6.2

package/enhancements/MANIFEST.json

@@ -1,5 +1,5 @@
 {
-  "syncedAt": "2026-08-19T08:42:56.853Z",
+  "syncedAt": "2026-08-26T01:20:11.756Z",
   "syncedFrom": "vendor/skill-garden",
   "sourceCommit": "124b592037eef542d7faf7ecb3be93b4bfd3aed0",
   "common": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flower-trellis",
-  "version": "0.6.1-beta.5",
+  "version": "0.6.2",
   "description": "一键安装/升级 Trellis 并自动融合 skill-garden 强化包(默认 Claude + agents)",
   "type": "module",
   "bin": {
@@ -70,9 +70,9 @@
     "commit-and-tag-version": "^12.7.3"
   },
   "flowerReleaseNotes": {
-    "version": "0.6.1-beta.5",
+    "version": "0.6.2",
     "source": "CHANGELOG.md",
-    "body": "### 🐛 修复 Bug Fixes\n\n* **plugin:** 恢复 rd-guide 内置来源 ref ([c399f86](https://github.com/SilentFlower/flower-trellis/commit/c399f868a6ea96bf1beca616dc9548ef9a86bfb0))\n* **telemetry:** 更新安装监控上报地址 ([53d8b79](https://github.com/SilentFlower/flower-trellis/commit/53d8b79b374db095094f0fe8b107d54719d1c94f))",
+    "body": "### 🐛 修复 Bug Fixes\n\n* **flower:** 修正遥测上报地址并忽略上游 npm 升级提示 ([3030472](https://github.com/SilentFlower/flower-trellis/commit/303047282032270267cf3b26ffc20c13f9892324))",
     "truncated": false
   },
   "optionalDependencies": {

package/src/lib/telemetry.js

@@ -8,8 +8,8 @@ import { readGitDeveloper } from "./developer.js";
 import { readManifest, readUpdateCheck } from "./manifest.js";
 import { flowerVersion, trellisVersion } from "./versions.js";
 
-/** Flower 遥测接收地址。 */
-export const FLOWER_TELEMETRY_ENDPOINT = "https://ai-api.hub.flower-cli.com/";
+/** Flower 遥测接收地址。主机名与 `/api/flower-trellis` 路由前缀都由服务端契约固定,缺一不可。 */
+export const FLOWER_TELEMETRY_ENDPOINT = "https://ai-api.hub.flower-cli.com/api/flower-trellis/telemetry";
 
 const TELEMETRY_SCHEMA_VERSION = 1;
 /** 遥测请求保留 10 秒公网预算，避免慢速 TLS 建连或服务端响应被过早中止。 */

package/src/lib/trellis-runner.js

@@ -60,6 +60,45 @@ function classifyHeaderLine(line, bannerSet) {
   return "content";
 }
 
+/**
+ * 上游 `trellis update` 的 npm 落后提示行。用宽松匹配容忍上游微调文案,
+ * 捕获组取出它自报的 CLI 版本,复用到 Flower 的替代说明里。
+ */
+const UPSTREAM_UPGRADE_NOTICE = /Your CLI \(([^)]+)\) is behind npm\b/;
+
+/**
+ * 上游紧跟其后的引导动作行。只匹配独立成行的 `Run: trellis upgrade`,
+ * 避免误伤降级分支里 `1. Update your CLI: trellis upgrade` 这类真实错误指引。
+ */
+const UPSTREAM_UPGRADE_ACTION = /^Run:\s*trellis upgrade$/;
+
+/**
+ * 正文开始后继续按行过滤的行数上限。
+ *
+ * 上游版本提示固定打印在 `trellis update` 输出最前面,给一个有限窗口即可覆盖;
+ * 设上限是为了不让不完整行长期滞留在缓冲区里,影响后续交互输出的实时性。
+ */
+const UPSTREAM_NOTICE_LINE_BUDGET = 40;
+
+/**
+ * 改写上游 trellis 的 npm 升级提示。
+ *
+ * Flower 在 package.json 里固定 `@mindfoldhq/trellis` 版本,并由 postinstall 同步全局 CLI,
+ * 所以上游「CLI 落后于 npm,请运行 trellis upgrade」是错误引导:照做会让全局 CLI 脱离
+ * Flower 的版本控制,下次安装又被同步回去。这里替换成 Flower 自己的说明而不是静默丢弃,
+ * 让用户仍然知道版本检查发生过、以及为什么不需要照做。
+ *
+ * @param {string} line 未去色的原始输出行
+ * @returns {string|null|undefined} 替换文案;null 表示丢弃该行;undefined 表示不匹配
+ */
+export function rewriteUpstreamUpgradeNotice(line) {
+  const t = stripAnsi(line).trim();
+  const notice = UPSTREAM_UPGRADE_NOTICE.exec(t);
+  if (notice) return `  · Trellis 版本由 Flower 固定(${notice[1]}),已忽略上游 npm 升级提示`;
+  if (UPSTREAM_UPGRADE_ACTION.test(t)) return null;
+  return undefined;
+}
+
 /**
  * 用当前 node 执行 trellis bin(普通 spawn),透传子命令与参数。
  *
@@ -83,6 +122,11 @@ export function runTrellis(args, cwd, opts = {}) {
       const banner = trellisBannerLines();
       const rl = createInterface({ input: child.stdout });
       rl.on("line", (line) => {
+        const notice = rewriteUpstreamUpgradeNotice(line);
+        if (notice !== undefined) {
+          if (notice !== null) process.stdout.write(notice + "\n");
+          return;
+        }
         const kind = classifyHeaderLine(line, banner);
         // 普通(非 pty)场景一直按行过滤即可:trellis 此时是 -y 非交互,无 inquirer
         if (kind === "skip") return;
@@ -99,10 +143,15 @@ export function runTrellis(args, cwd, opts = {}) {
 
 /**
  * 在伪终端(node-pty)里运行 trellis,**保留其全部交互**(模板 / monorepo / 冲突菜单),
- * 同时过滤掉它开头重复打印的启动 banner / 副标题 / Developer / Mode。
+ * 同时过滤掉它开头重复打印的启动 banner / 副标题 / Developer / Mode,
+ * 以及它自带的、与 Flower 版本固定策略冲突的 npm 升级提示。
+ *
+ * 过滤分三个阶段:
+ *  - "header":逐行识别 banner 类行并丢弃(proxy 保留),遇到正文行转入 "notice";
+ *  - "notice":只改写上游 npm 升级提示,其余原样输出,超出行数预算后转入 "raw";
+ *  - "raw":完全透传。
  *
- * 过滤只作用于「头部阶段」:逐行识别 banner 类行并丢弃(proxy 保留),
- * 一旦遇到正文行或 inquirer 渲染(隐藏光标序列 ESC[?25l)立即停止过滤、转为完全透传,
+ * 任一阶段遇到 inquirer 渲染(隐藏光标序列 ESC[?25l)都立即转入 "raw",
  * 以免破坏交互菜单的光标控制。
  *
  * @param {string[]} args
@@ -133,17 +182,18 @@ export function runTrellisPty(args, cwd, opts = {}) {
     }
 
     const bannerSet = trellisBannerLines();
-    let filtering = !!opts.stripBanner;
+    let phase = opts.stripBanner ? "header" : "raw";
+    let noticeBudget = UPSTREAM_NOTICE_LINE_BUDGET;
     let buf = "";
 
     const dataSubscription = child.onData((data) => {
-      if (!filtering) {
+      if (phase === "raw") {
         stdout.write(data);
         return;
       }
       // inquirer 开始渲染(隐藏光标)→ 立即停止过滤,整体透传,保住交互菜单
       if (data.includes("\x1b[?25l")) {
-        filtering = false;
+        phase = "raw";
         stdout.write(buf + data);
         buf = "";
         return;
@@ -152,16 +202,32 @@ export function runTrellisPty(args, cwd, opts = {}) {
       const parts = buf.split(/\r?\n/);
       buf = parts.pop(); // 末尾不完整行留待下次
       for (const line of parts) {
-        const kind = classifyHeaderLine(line, bannerSet);
-        if (kind === "skip") continue;
-        if (kind === "keep") {
+        if (phase === "raw") {
+          stdout.write(line + "\r\n");
+          continue;
+        }
+        if (phase === "notice" && noticeBudget-- <= 0) {
+          phase = "raw";
           stdout.write(line + "\r\n");
           continue;
         }
-        filtering = false; // 正文开始
+        const notice = rewriteUpstreamUpgradeNotice(line);
+        if (notice !== undefined) {
+          if (notice !== null) stdout.write(notice + "\r\n");
+          continue;
+        }
+        if (phase === "header") {
+          const kind = classifyHeaderLine(line, bannerSet);
+          if (kind === "skip") continue;
+          if (kind === "keep") {
+            stdout.write(line + "\r\n");
+            continue;
+          }
+          phase = "notice"; // 正文开始:banner 过滤结束,但仍在有限窗口内改写上游版本提示
+        }
         stdout.write(line + "\r\n");
       }
-      if (!filtering && buf) {
+      if (phase === "raw" && buf) {
         stdout.write(buf);
         buf = "";
       }
@@ -185,6 +251,11 @@ export function runTrellisPty(args, cwd, opts = {}) {
     stdout.on("resize", onResize);
 
     child.onExit(({ exitCode, signal }) => {
+      // 过滤阶段可能扣着一行不完整输出(末尾无换行),退出前补发,避免最后一行被吞掉。
+      if (buf) {
+        stdout.write(buf);
+        buf = "";
+      }
       // 先停止接收子进程输出，再恢复宿主终端；否则迟到的 9001h 会重新污染父终端。
       dataSubscription.dispose();
       stdin.off("data", onStdin);