ygl-trees 0.77.1 → 0.77.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.77.2（2026-10-17）JSON 纯净性修复
+- **契约修复**：unknown-group 错误路径的 try 提示不再泄漏到 --json stdout（冷启动之旅实测发现）
+- degraded mode 提示在 json 模式改走 stderr
+- 冷安装全链路验证通过（npm install → init → doctor → research → tree → kb → webui）
+
 ## 0.77.1（2026-10-17）DEP0190 hotfix
 - 所有 shell:true 消除（resolvePm 的 where/version 检查改用无 shell 调用）
 - plugin install/remove 零弃用警告

package/dist/apps/cli/src/bin.js

@@ -386,7 +386,11 @@ async function main(argv) {
                     home, dbFile: dbFile2, ctx,
                     db: null, store: null, cordis: null,
                 };
-                (0, fmt_1.out)(ctx, (0, fmt_1.paint)(fmt_1.C.yellow, "  ! degraded mode: user plugins failed to load — plugin commands only", ctx.color));
+                // JSON purity: stdout is the machine channel — degraded-mode notice goes to stderr there
+                if (ctx.json)
+                    console.error((0, fmt_1.paint)(fmt_1.C.yellow, "  ! degraded mode: user plugins failed to load — plugin commands only", ctx.color));
+                else
+                    (0, fmt_1.out)(ctx, (0, fmt_1.paint)(fmt_1.C.yellow, "  ! degraded mode: user plugins failed to load — plugin commands only", ctx.color));
                 return pluginCmds.runPluginCommand(env2, action || "list", args._.slice(2), args);
             }
             (0, startup_diagnostics_1.reportStartupFailure)(e, home, VERSION);
@@ -541,8 +545,9 @@ async function main(argv) {
             else {
                 (0, fmt_1.bad)(ctx, `unknown group: ${group}`);
             }
-            (0, fmt_1.out)(ctx, (0, fmt_1.paint)(fmt_1.C.dim, "  try: ygl-trees (no args) for full usage", ctx.color));
-            ;
+            if (!ctx.json) {
+                (0, fmt_1.out)(ctx, (0, fmt_1.paint)(fmt_1.C.dim, "  try: ygl-trees (no args) for full usage", ctx.color));
+            }
             if (!ctx.json)
                 (0, fmt_1.out)(ctx, usage()); // usage text belongs to the human channel
             return 2;

package/dist/bundle/bin.cjs

@@ -11071,7 +11071,8 @@ async function main(argv) {
 					store: null,
 					cordis: null
 				};
-				out(ctx, paint(C.yellow, "  ! degraded mode: user plugins failed to load — plugin commands only", ctx.color));
+				if (ctx.json) console.error(paint(C.yellow, "  ! degraded mode: user plugins failed to load — plugin commands only", ctx.color));
+				else out(ctx, paint(C.yellow, "  ! degraded mode: user plugins failed to load — plugin commands only", ctx.color));
 				return pluginCmds.runPluginCommand(env2, action || "list", args._.slice(2), args);
 			}
 			reportStartupFailure(e, home, VERSION);
@@ -11238,7 +11239,7 @@ async function main(argv) {
 			if (suggestions.length === 1) bad(ctx, `unknown group: ${group} — did you mean "${suggestions[0]}"?`);
 			else if (suggestions.length > 1) bad(ctx, `unknown group: ${group} — did you mean: ${suggestions.slice(0, 3).join(" | ")}?`);
 			else bad(ctx, `unknown group: ${group}`);
-			out(ctx, paint(C.dim, "  try: ygl-trees (no args) for full usage", ctx.color));
+			if (!ctx.json) out(ctx, paint(C.dim, "  try: ygl-trees (no args) for full usage", ctx.color));
 			if (!ctx.json) out(ctx, usage());
 			return 2;
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ygl-trees",
-  "version": "0.77.1",
+  "version": "0.77.2",
   "description": "猿光 · 科技树 — database-centric CLI for research → production → knowledge reuse, built for AI agents.",
   "type": "commonjs",
   "main": "dist/apps/cli/index.js",