Skip to content

v1.2.8

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 17 Jul 01:33
v1.2.8
98ca8f3

What's in this release

Added

  • Check passed 消息可见化： Check 节点通过时现在会显示 "Checks passed." 消息（status=COMPLETED, badge=PASSED），不再静默跳过，用户可明确感知校验环节已执行。
  • Agent_task 无条件并行扇出： 编译器和前端统一支持 agent_task 节点最多 3 条无条件出边（之前编译器硬拒绝 >1 条，前端 canvas 兼容性检查也不允许），支持一个节点同时驱动多个下游并行执行。

Changed

  • Human Gate 提示文案修正： 从 "Validation checks did not pass" (FAILED / VALIDATION FAILED) 改为 "Awaiting human approval. Please review…" (PENDING / AWAITING APPROVAL)，不再让用户误以为是 Check 节点报错。
  • Evaluator / Supervisor / Builder 头像统一： 工作流元 Agent 不再随机匹配 Cursor 或默认图标，统一使用 Rivet logo 作为头像标识。

Fixed

  • Check/Gate 节点 end 汇聚不兼容修复： getCanvasIncompatibilities 中 end 节点入度检查从 endIn !== 1 放宽到 endIn < 1，允许多路径汇聚到 end。
  • Agent_task 多出边放宽： 移除 agent_task 节点 branching_node（out>1）限制，所有节点类型统一使用 MAX_BRANCH_OUT=3 出度上限。
  • Gate/Check 数据透明穿透： 下游 agent_task 节点的直接上游如果是 human_gate 或 check，现在会递归向上查找真正的数据源（agent_task），而非把审批信号 "approve" 当作数据传入。修复了 3-Parameter Engineer 收到 "approve" 而非画面描述的问题。
  • Workflow step 状态防污染： buildWorkflowReplyStepIndex 不再将 Evaluator / Supervisor 等元消息错误映射到 agent_task 步骤，修复了 1-Aesthetic Architect 被标记为 FAILED 的问题。
  • 新建会话消息泄露： 修复 WebSocket 竞态条件——旧 socket 关闭时先清除 onmessage 回调，并增加 runId 守卫，避免旧工作流的 state_patch 注入空白新会话。
  • brandLogos 别名过宽： 移除 agent: 'cursor-cli' 通配别名，防止 Evaluator 等消息意外匹配到 Cursor logo。

Install

macOS (Apple Silicon only):

curl -fsSL https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.sh | bash

Or Homebrew:

brew tap fancy1108/clutch
brew install --cask clutch

Windows:

irm https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.ps1 | iex

Or download *-setup.exe / *.msi from Assets on this page.

Full guide: docs/INSTALL.md · docs/PACKAGE_MANAGERS.md

Upgrade

Situation Action
macOS v1.0.0 / v1.0.1 Install v1.0.2+ DMG manually once — older builds lack the in-app updater
macOS v1.0.2+ Follow the in-app update banner, or reinstall from Assets
Homebrew brew upgrade --cask clutch
Windows Download and run the new installer (no in-app updater yet)

Details: docs/UPDATES.md · docs/INSTALL.md §3

macOS: first launch (unsigned app)

Clutch is unsigned (no Apple notarization yet — see D31). Gatekeeper warnings are expected, not malware or a corrupt download.

You may see: “cannot verify developer”, “Clutch is damaged”, or double-click does nothing.

Fix (pick one):

  1. Finder: Applications → right-click Clutch.app → Open → Open again.
  2. Terminal (one-time): xattr -cr /Applications/Clutch.app && open -a Clutch

More: docs/INSTALL.md §2–§4 · docs/DATA_AND_PRIVACY.md

Windows

Windows 10/11 x64 MSI and NSIS (.exe) may appear under Assets (since v1.0.2).

Item Note
CI Built by GitHub Actions; pytest and packaging checks pass
Smoke test Maintainers have not completed full manual smoke on physical Win10/11 (#23)
Code signing None — SmartScreen may warn; verify SHA-256 and Release source first

Report issues: GitHub Issues (include installer filename and Windows version).

Verify download

Checksum (recommended):

shasum -a 256 -c SHA256SUMS.txt

(Run in the folder where you downloaded the DMG and SHA256SUMS.txt.)

After launch (~5 s):

curl -s http://127.0.0.1:8123/health

Expected: {"status":"ok"}

Assets 7
Loading