flower-trellis 0.3.1-beta.6 → 0.3.1

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

@@ -60,7 +60,9 @@ python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target <im
 python3 .claude/skills/trellis-route/scripts/route_state.py resolve --target <implement|check>
 ```
 
-helper 只接受当前 session 或唯一 session fallback 的 `.trellis/.runtime/sessions/<context-key>.json`，并只从 `route_decisions.<target>` 恢复决策。命中时输出 `{"status":"hit", ...}`，其中 `decision` 已经过 task/target/source/mode/scope 校验，可跳过 Step 2 并进入 Step 3 输出决策。`source=route-prefs` 且 `wrote_runtime=true` 时，输出模板同时写明来自个人 route 配置和已写入 session runtime state。
+helper 只接受当前 session 或唯一 session fallback 的 `.trellis/.runtime/sessions/<context-key>.json`，并只从 `route_decisions.<target>` 恢复决策。命中时输出 `{"status":"hit", ...}`，其中默认输出里的 `mode` / `source` 已经过 task/target/source/mode/scope 校验，可跳过 Step 2 并进入 Step 3 输出决策。`origin=route-prefs` 表示来自个人 route 配置，并且 helper 已写回 session runtime state；`origin=runtime` 表示来自 session runtime state。
+
+helper 默认输出为精简 JSON，只包含 route 执行必需的 `status`、`origin`、`mode`、`source`/`reason` 等字段。需要排查完整 `decision`、session 文件、context key、任务路径、个人配置路径或写回标记时，在同一命令末尾加 `--verbose`；不要为了诊断信息额外读取 runtime 文件。
 
 输出 `status=miss`、文件缺失、JSON 损坏、任务不匹配、source/mode 不合法、prefs 缺失或 prefs 值不合法时，忽略已有状态并继续 Step 2。不要删除不匹配 runtime 文件，避免误伤其他窗口。
 
@@ -212,7 +214,6 @@ route_decision:
   mode: <inline | subagent | check-all-inline | check-all-subagent | check-inline | check-subagent>
   source: <trellis-route | route-prefs | numbered-fallback>
   scope: task
-  task: <task.py current 的任务路径或 current>
 
 接下来主 agent 应当：
 - <路由表里对应的工具调用形式>
@@ -222,7 +223,7 @@ route_decision:
 - <要避免的工具调用>
 ```
 
-中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅轻量 check 时显示隐藏逃生口说明；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中；compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
+中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅轻量 check 时显示隐藏逃生口说明；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中，但默认只保留 target/mode/source/scope；需要 task/path/decided_at 等诊断字段时重新调用 helper 并加 `--verbose`。compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
 
 ---
 

package/enhancements/0.6/.agents/skills/trellis-route/scripts/route_state.py

@@ -73,6 +73,21 @@ def _print(data: dict[str, Any]) -> int:
     return 0
 
 
+def _output(args: argparse.Namespace, data: dict[str, Any], verbose: dict[str, Any] | None = None) -> int:
+    """按默认精简模式或详细模式输出 JSON。"""
+    if getattr(args, "verbose", False) and verbose:
+        data = {**data, **verbose}
+    return _print(data)
+
+
+def _decision_summary(decision: dict[str, Any]) -> dict[str, Any]:
+    """提取默认输出需要的最小 route 决策字段。"""
+    return {
+        "mode": decision.get("mode"),
+        "source": decision.get("source"),
+    }
+
+
 def _current_task(repo_root: Path) -> tuple[str | None, str | None, str | None]:
     """通过 task.py current --source 获取当前任务和 session key。"""
     result = subprocess.run(
@@ -236,20 +251,27 @@ def read_runtime(args: argparse.Namespace) -> int:
     context = _read_json(path)
     decision = context.get("route_decisions", {}).get(args.target)
     if _valid_decision(decision, args.target, current_task):
-        return _print(
+        return _output(
+            args,
             {
                 "status": "hit",
+                **_decision_summary(decision),
+            },
+            {
+                "decision": decision,
                 "path": _rel_path(repo_root, path),
                 "context_key": context_key,
                 "task": current_task,
-                "decision": decision,
             }
         )
 
-    return _print(
+    return _output(
+        args,
         {
             "status": "miss",
             "reason": "no-valid-decision",
+        },
+        {
             "path": _rel_path(repo_root, path),
             "context_key": context_key,
             "task": current_task,
@@ -272,14 +294,18 @@ def resolve_route(args: argparse.Namespace) -> int:
     context = _read_json(path)
     decision = context.get("route_decisions", {}).get(args.target)
     if _valid_decision(decision, args.target, current_task):
-        return _print(
+        return _output(
+            args,
             {
                 "status": "hit",
-                "source": "runtime",
+                "origin": "runtime",
+                **_decision_summary(decision),
+            },
+            {
+                "decision": decision,
                 "path": _rel_path(repo_root, path),
                 "context_key": context_key,
                 "task": current_task,
-                "decision": decision,
             }
         )
 
@@ -294,23 +320,30 @@ def resolve_route(args: argparse.Namespace) -> int:
             pref_mode,
             "route-prefs",
         )
-        return _print(
+        return _output(
+            args,
             {
                 "status": "hit",
-                "source": "route-prefs",
+                "origin": "route-prefs",
+                **_decision_summary(pref_decision),
+            },
+            {
+                "decision": pref_decision,
                 "path": _rel_path(repo_root, written_path),
                 "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
                 "context_key": context_key,
                 "task": current_task,
-                "decision": pref_decision,
                 "wrote_runtime": True,
             }
         )
 
-    return _print(
+    return _output(
+        args,
         {
             "status": "miss",
             "reason": "no-valid-decision-or-pref",
+        },
+        {
             "path": _rel_path(repo_root, path),
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
             "context_key": context_key,
@@ -365,14 +398,18 @@ def write_route(args: argparse.Namespace) -> int:
         args.mode,
         args.source,
     )
-    return _print(
+    return _output(
+        args,
         {
             "status": "written",
+            **_decision_summary(decision),
+        },
+        {
+            "decision": decision,
             "path": _rel_path(repo_root, path),
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)) if args.save_pref else None,
             "context_key": context_key,
             "task": current_task,
-            "decision": decision,
             "saved_pref": bool(args.save_pref),
         }
     )
@@ -387,10 +424,13 @@ def clear_pref(args: argparse.Namespace) -> int:
     existed = args.target in prefs
     prefs.pop(args.target, None)
     _write_prefs(repo_root, prefs)
-    return _print(
+    return _output(
+        args,
         {
             "status": "cleared",
             "target": args.target,
+        },
+        {
             "existed": existed,
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
         }
@@ -404,10 +444,12 @@ def build_parser() -> argparse.ArgumentParser:
 
     resolve_parser = subparsers.add_parser("resolve", help="resolve route from runtime then prefs")
     resolve_parser.add_argument("--target", choices=sorted(VALID_MODES), required=True)
+    resolve_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     resolve_parser.set_defaults(func=resolve_route)
 
     read_parser = subparsers.add_parser("read-runtime", help="read a runtime route decision")
     read_parser.add_argument("--target", choices=sorted(VALID_MODES), required=True)
+    read_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     read_parser.set_defaults(func=read_runtime)
 
     write_parser = subparsers.add_parser("write", help="write a route decision")
@@ -415,10 +457,12 @@ def build_parser() -> argparse.ArgumentParser:
     write_parser.add_argument("--mode", required=True)
     write_parser.add_argument("--source", choices=sorted(VALID_SOURCES), required=True)
     write_parser.add_argument("--save-pref", action="store_true")
+    write_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     write_parser.set_defaults(func=write_route)
 
     clear_parser = subparsers.add_parser("clear-pref", help="clear a personal route preference")
     clear_parser.add_argument("--target", choices=sorted(PREF_MODES), required=True)
+    clear_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and preference metadata")
     clear_parser.set_defaults(func=clear_pref)
 
     return parser

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

@@ -60,7 +60,9 @@ python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target <im
 python3 .claude/skills/trellis-route/scripts/route_state.py resolve --target <implement|check>
 ```
 
-helper 只接受当前 session 或唯一 session fallback 的 `.trellis/.runtime/sessions/<context-key>.json`，并只从 `route_decisions.<target>` 恢复决策。命中时输出 `{"status":"hit", ...}`，其中 `decision` 已经过 task/target/source/mode/scope 校验，可跳过 Step 2 并进入 Step 3 输出决策。`source=route-prefs` 且 `wrote_runtime=true` 时，输出模板同时写明来自个人 route 配置和已写入 session runtime state。
+helper 只接受当前 session 或唯一 session fallback 的 `.trellis/.runtime/sessions/<context-key>.json`，并只从 `route_decisions.<target>` 恢复决策。命中时输出 `{"status":"hit", ...}`，其中默认输出里的 `mode` / `source` 已经过 task/target/source/mode/scope 校验，可跳过 Step 2 并进入 Step 3 输出决策。`origin=route-prefs` 表示来自个人 route 配置，并且 helper 已写回 session runtime state；`origin=runtime` 表示来自 session runtime state。
+
+helper 默认输出为精简 JSON，只包含 route 执行必需的 `status`、`origin`、`mode`、`source`/`reason` 等字段。需要排查完整 `decision`、session 文件、context key、任务路径、个人配置路径或写回标记时，在同一命令末尾加 `--verbose`；不要为了诊断信息额外读取 runtime 文件。
 
 输出 `status=miss`、文件缺失、JSON 损坏、任务不匹配、source/mode 不合法、prefs 缺失或 prefs 值不合法时，忽略已有状态并继续 Step 2。不要删除不匹配 runtime 文件，避免误伤其他窗口。
 
@@ -212,7 +214,6 @@ route_decision:
   mode: <inline | subagent | check-all-inline | check-all-subagent | check-inline | check-subagent>
   source: <trellis-route | route-prefs | numbered-fallback>
   scope: task
-  task: <task.py current 的任务路径或 current>
 
 接下来主 agent 应当：
 - <路由表里对应的工具调用形式>
@@ -222,7 +223,7 @@ route_decision:
 - <要避免的工具调用>
 ```
 
-中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅轻量 check 时显示隐藏逃生口说明；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中；compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
+中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅轻量 check 时显示隐藏逃生口说明；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中，但默认只保留 target/mode/source/scope；需要 task/path/decided_at 等诊断字段时重新调用 helper 并加 `--verbose`。compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
 
 ---
 

package/enhancements/0.6/.claude/skills/trellis-route/scripts/route_state.py

@@ -73,6 +73,21 @@ def _print(data: dict[str, Any]) -> int:
     return 0
 
 
+def _output(args: argparse.Namespace, data: dict[str, Any], verbose: dict[str, Any] | None = None) -> int:
+    """按默认精简模式或详细模式输出 JSON。"""
+    if getattr(args, "verbose", False) and verbose:
+        data = {**data, **verbose}
+    return _print(data)
+
+
+def _decision_summary(decision: dict[str, Any]) -> dict[str, Any]:
+    """提取默认输出需要的最小 route 决策字段。"""
+    return {
+        "mode": decision.get("mode"),
+        "source": decision.get("source"),
+    }
+
+
 def _current_task(repo_root: Path) -> tuple[str | None, str | None, str | None]:
     """通过 task.py current --source 获取当前任务和 session key。"""
     result = subprocess.run(
@@ -236,20 +251,27 @@ def read_runtime(args: argparse.Namespace) -> int:
     context = _read_json(path)
     decision = context.get("route_decisions", {}).get(args.target)
     if _valid_decision(decision, args.target, current_task):
-        return _print(
+        return _output(
+            args,
             {
                 "status": "hit",
+                **_decision_summary(decision),
+            },
+            {
+                "decision": decision,
                 "path": _rel_path(repo_root, path),
                 "context_key": context_key,
                 "task": current_task,
-                "decision": decision,
             }
         )
 
-    return _print(
+    return _output(
+        args,
         {
             "status": "miss",
             "reason": "no-valid-decision",
+        },
+        {
             "path": _rel_path(repo_root, path),
             "context_key": context_key,
             "task": current_task,
@@ -272,14 +294,18 @@ def resolve_route(args: argparse.Namespace) -> int:
     context = _read_json(path)
     decision = context.get("route_decisions", {}).get(args.target)
     if _valid_decision(decision, args.target, current_task):
-        return _print(
+        return _output(
+            args,
             {
                 "status": "hit",
-                "source": "runtime",
+                "origin": "runtime",
+                **_decision_summary(decision),
+            },
+            {
+                "decision": decision,
                 "path": _rel_path(repo_root, path),
                 "context_key": context_key,
                 "task": current_task,
-                "decision": decision,
             }
         )
 
@@ -294,23 +320,30 @@ def resolve_route(args: argparse.Namespace) -> int:
             pref_mode,
             "route-prefs",
         )
-        return _print(
+        return _output(
+            args,
             {
                 "status": "hit",
-                "source": "route-prefs",
+                "origin": "route-prefs",
+                **_decision_summary(pref_decision),
+            },
+            {
+                "decision": pref_decision,
                 "path": _rel_path(repo_root, written_path),
                 "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
                 "context_key": context_key,
                 "task": current_task,
-                "decision": pref_decision,
                 "wrote_runtime": True,
             }
         )
 
-    return _print(
+    return _output(
+        args,
         {
             "status": "miss",
             "reason": "no-valid-decision-or-pref",
+        },
+        {
             "path": _rel_path(repo_root, path),
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
             "context_key": context_key,
@@ -365,14 +398,18 @@ def write_route(args: argparse.Namespace) -> int:
         args.mode,
         args.source,
     )
-    return _print(
+    return _output(
+        args,
         {
             "status": "written",
+            **_decision_summary(decision),
+        },
+        {
+            "decision": decision,
             "path": _rel_path(repo_root, path),
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)) if args.save_pref else None,
             "context_key": context_key,
             "task": current_task,
-            "decision": decision,
             "saved_pref": bool(args.save_pref),
         }
     )
@@ -387,10 +424,13 @@ def clear_pref(args: argparse.Namespace) -> int:
     existed = args.target in prefs
     prefs.pop(args.target, None)
     _write_prefs(repo_root, prefs)
-    return _print(
+    return _output(
+        args,
         {
             "status": "cleared",
             "target": args.target,
+        },
+        {
             "existed": existed,
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
         }
@@ -404,10 +444,12 @@ def build_parser() -> argparse.ArgumentParser:
 
     resolve_parser = subparsers.add_parser("resolve", help="resolve route from runtime then prefs")
     resolve_parser.add_argument("--target", choices=sorted(VALID_MODES), required=True)
+    resolve_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     resolve_parser.set_defaults(func=resolve_route)
 
     read_parser = subparsers.add_parser("read-runtime", help="read a runtime route decision")
     read_parser.add_argument("--target", choices=sorted(VALID_MODES), required=True)
+    read_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     read_parser.set_defaults(func=read_runtime)
 
     write_parser = subparsers.add_parser("write", help="write a route decision")
@@ -415,10 +457,12 @@ def build_parser() -> argparse.ArgumentParser:
     write_parser.add_argument("--mode", required=True)
     write_parser.add_argument("--source", choices=sorted(VALID_SOURCES), required=True)
     write_parser.add_argument("--save-pref", action="store_true")
+    write_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     write_parser.set_defaults(func=write_route)
 
     clear_parser = subparsers.add_parser("clear-pref", help="clear a personal route preference")
     clear_parser.add_argument("--target", choices=sorted(PREF_MODES), required=True)
+    clear_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and preference metadata")
     clear_parser.set_defaults(func=clear_pref)
 
     return parser

package/enhancements/MANIFEST.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-06-26T09:44:08.667Z",
+  "syncedAt": "2026-06-28T06:07:58.327Z",
   "syncedFrom": "vendor/skill-garden/.trellis",
-  "sourceCommit": "031d74571ff336e44693d240700220f365f231db",
+  "sourceCommit": "57bac1361b3afe6ae3ea3fa456405bb888edab11",
   "variants": {
     "old": {
       "claudeSkills": [],

package/package.json

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