comate-cli 0.6.2__tar.gz → 0.7.0a1__tar.gz

{comate_cli-0.6.2 → comate_cli-0.7.0a1}/.gitignore

@@ -5,6 +5,8 @@ __pycache__/
 .agent
 .agents
 set_env.sh
+.vscode/
+codex/
 .worktrees/
 # C extensions
 *.so
@@ -227,3 +229,4 @@ __marimo__/
 .DS_Store
 .DS_Store.worktrees/
 .superpowers/
+.codex/

comate_cli-0.7.0a1/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.7.0a1 - 2026-05-19 (alpha)
+
+> 这是一个 **alpha 预发布版本**，用于内部 / 早期测试。
+> `pip install comate-cli` 默认不会安装到本版本，需要显式 `pip install comate-cli==0.7.0a1` 或 `pip install --pre comate-cli`。
+
+### Breaking Changes
+
+- 依赖 `comate-agent-sdk>=0.8.0a1`，与旧 SDK 不兼容。
+- 旧版本生成的 resume jsonl / context 快照不保证可以正常回放，**建议从空 session 重新开始**。
+
+### 累积变更
+
+自 0.6.x 起累积大量 TUI 与会话能力改进，涵盖：
+
+- Resume picker 重做：搜索、跨 cwd 切换、预览模式、视觉抛光
+- Auto compact 期间显式提示 `Compacting context`
+- Team / subagent 事件透出与渲染统一
+- 与 SDK 0.8.0a1 配套的 tool envelope / token 账本展示
+
+详细变更请参考 git log。

{comate_cli-0.6.2 → comate_cli-0.7.0a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comate-cli
-Version: 0.6.2
+Version: 0.7.0a1
 Summary: Comate terminal CLI built on comate-agent-sdk
 Project-URL: Homepage, https://github.com/AndyLee1024/agent-sdk
 Project-URL: Repository, https://github.com/AndyLee1024/agent-sdk
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.11
 Requires-Dist: charset-normalizer==3.4.7
-Requires-Dist: comate-agent-sdk<1.0.0,>=0.0.2
+Requires-Dist: comate-agent-sdk<0.9.0,>=0.8.0a1
 Requires-Dist: concurrent-log-handler>=0.9.25
 Requires-Dist: curl-cffi==0.13.0
 Requires-Dist: packaging>=21.0

comate_cli-0.7.0a1/bash-exit-code-green-dot-bug.md

@@ -0,0 +1,140 @@
+# Bug 分析：Bash 工具 exit code 非零时仍显示绿色圆点
+
+## 现象
+
+在 `/plugin` 页面 scrollback 中，Bash 工具执行失败（exit code != 0）时，工具结果行显示的是**绿色圆点**（代表成功），而不是**红色叉号**（代表失败）。
+
+用户日志示例：
+
+```
+● Bash(timeout=30s command=cd ... && python -m pytest ...)
+  ⎿  Exit code 1
+```
+
+这里 `●` 是绿色圆点，`Exit code 1` 明确表示失败。
+
+## 根因
+
+Bug 在 **SDK 层** `comate_agent_sdk/system_tools/tools/bash.py`，不在 comate_cli。
+
+Bash 工具在命令执行完毕后构造返回 envelope 时，只检查了三种异常情况：
+- `overflowed` → `err("OUTPUT_OVERFLOW", ...)` — ok=False
+- `timed_out` → `err("TIMEOUT", ...)` — ok=False
+- `interrupted` → `err("INTERRUPTED", ...)` — ok=False
+- **否则** → `return ok(data=data, meta=exec_meta)` — **ok=True**
+
+当 `exit_code=1`（命令执行失败）时，上述三个条件都不满足，envelope 的 `"ok"` 字段被设为 `True`。
+
+## 完整调用链（6 层）
+
+### 第 1 层：Bash 工具 envelope 构造（bug 所在）
+
+**文件**：`comate_agent_sdk/system_tools/tools/bash.py`（约第 404-431 行）
+
+```python
+# 当前逻辑（有 bug）
+if overflowed:
+    return err("OUTPUT_OVERFLOW", ...)
+if timed_out:
+    return err("TIMEOUT", ...)
+if interrupted:
+    return err("INTERRUPTED", ...)
+return ok(data=data, meta=exec_meta)  # ← exit_code=1 时也走这里
+```
+
+### 第 2 层：OutputFormatter 判定 status
+
+**文件**：`comate_agent_sdk/system_tools/output_formatter.py`（第 70-82 行）
+
+```python
+if not bool(result_dict.get("ok", False)):   # ok=True → 不进入 error 分支
+    return format_error(...)
+
+formatter = _TOOL_FORMATTERS.get(tool_name, format_generic_ok)
+return formatter(...)   # → format_bash_result → status="ok"
+```
+
+因为 `ok=True`，走的是成功格式化路径，`status` 被设为 `"ok"`。
+
+### 第 3 层：ToolMessage 的 is_error
+
+**文件**：`comate_agent_sdk/agent/tool_exec.py`（第 342 行）
+
+```python
+is_error = formatted.meta.status == "error"   # "ok" != "error" → is_error=False
+```
+
+### 第 4 层：ToolResultEvent 传递给 CLI
+
+**文件**：`comate_agent_sdk/agent/runner_engine/execution/tool_execution.py`（第 843 行）
+
+```python
+yield ToolResultEvent(
+    ...
+    is_error=tool_result.is_error,   # False
+    ...
+)
+```
+
+### 第 5 层：EventRenderer 设置 severity
+
+**文件**：`comate_cli/comate_cli/terminal_agent/event_renderer.py`（第 1231 行）
+
+```python
+sev = "error" if is_error else "info"   # is_error=False → severity="info"
+```
+
+然后写入 `HistoryEntry(severity="info")`。
+
+### 第 6 层：history_printer 渲染颜色
+
+**文件**：`comate_cli/comate_cli/terminal_agent/history_printer.py`（第 244-246 行）
+
+```python
+if entry.entry_type == "tool_result":
+    prefix_char = HEAVY_MULTIPLICATION if entry.severity == "error" else BLACK_CIRCLE
+    prefix_style = "bold red" if entry.severity == "error" else "bold green"
+```
+
+`severity="info"` → 绿色圆点（`BLACK_CIRCLE` + `bold green`）。
+
+## 修复建议
+
+在 SDK 的 `comate_agent_sdk/system_tools/tools/bash.py` 中，在最终的 `return ok(...)` 之前增加对 exit_code 的检查：
+
+```python
+if overflowed:
+    return err("OUTPUT_OVERFLOW", ...)
+if timed_out:
+    return err("TIMEOUT", ...)
+if interrupted:
+    return err("INTERRUPTED", ...)
+
+# 新增：exit_code 非零视为命令执行失败
+if exit_code != 0:
+    return err(
+        "EXIT_CODE_NON_ZERO",
+        f"Command exited with non-zero code: {exit_code}",
+        data=data,
+        retryable=True,
+        meta=exec_meta,
+    )
+
+return ok(data=data, meta=exec_meta)
+```
+
+### comate_cli 侧的防御性补丁（可选）
+
+如果 SDK 修复周期较长，可以在 comate_cli 的 `event_renderer.py` 的 `ToolResultEvent` 处理分支中增加防御逻辑：当 `is_error=False` 但 `output` 是 `BashOutput` 且 `exit_code != 0` 时，强制将 `is_error` 修正为 `True`。但这种方式侵入性大且绕过了 SDK 的语义契约，建议仅在无法及时修改 SDK 时使用。
+
+## 涉及文件清单
+
+| 层级 | 文件 | 说明 |
+|------|------|------|
+| SDK | `comate_agent_sdk/system_tools/tools/bash.py` | **bug 根源**，envelope 构造 |
+| SDK | `comate_agent_sdk/system_tools/tool_result.py` | `ok()` / `err()` envelope 工厂 |
+| SDK | `comate_agent_sdk/system_tools/output_formatter.py` | `OutputFormatter.format()` 判定 status |
+| SDK | `comate_agent_sdk/agent/tool_exec.py` | `_build_tool_result_message()` 设置 is_error |
+| SDK | `comate_agent_sdk/agent/runner_engine/execution/tool_execution.py` | 构造 `ToolResultEvent` |
+| CLI | `comate_cli/terminal_agent/event_renderer.py` | `handle_event()` 设置 HistoryEntry severity |
+| CLI | `comate_cli/terminal_agent/history_printer.py` | `render_history_group()` 渲染颜色 |

{comate_cli-0.6.2 → comate_cli-0.7.0a1}/comate_cli/main.py

@@ -153,6 +153,10 @@ def _parse_args(argv: list[str]) -> tuple[bool, str | None, bool, str | None]:
 def main(argv: list[str] | None = None) -> None:
     run_argv = list(argv) if argv is not None else sys.argv[1:]
 
+    if run_argv in (["--help"], ["-h"]):
+        sys.stdout.write(f"{_usage_text()}\n")
+        return
+
     if run_argv and run_argv[0] == "mcp":
         from comate_cli.mcp_cli import McpCliError, run_mcp_command