tianshu-harness 3.36.0 → 3.37.0

package/README.en.md

@@ -16,6 +16,7 @@
   <a href="docs/user-guide.md"><img src="https://img.shields.io/badge/Docs-User%20Guide-FBBC04" alt="Docs"></a>
   <a href="https://discord.gg/XjWTATCHB"><img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-34A853" alt="License"></a>
+  <a href="https://github.com/RyanAlberts/best-of-Agent-Harnesses"><img src="https://img.shields.io/badge/%F0%9F%8F%86_Best_of-Agent_Harnesses-5ac4bf" alt="Best of Agent Harnesses"></a>
 </p>
 
 <p align="center">
@@ -105,6 +106,23 @@ Download from [Releases](https://github.com/huiliyi37/Tianshu-harness/releases/l
 </tr>
 </table>
 
+> [!WARNING]
+> **Hard Node.js requirement (v3.36.0+):** the CLI supports only **Node 24.22.1+
+> (24.x line) or Node 26.12.1+ (26.x line)**. Node 22 / 23 / 25 / 27,
+> Node 24.x below 24.22.1, and Node 26.x below 26.12.1 are rejected at startup
+> by the security gate. `/update` may install the new package successfully while
+> the new CLI still cannot start. Run `node -v` first; if it does not match, upgrade
+> via nvm / fnm / Volta or nodejs.org before installing.
+>
+> ```bash
+> node -v   # requires v24.22.1+ or v26.12.1+
+> ```
+>
+> The desktop app bundles its own runtime; no manual Node installation is required.
+> If it still fails after the upgrade, see the
+> [installation guide](docs/guides/installation.md) and
+> [troubleshooting guide](docs/guides/troubleshooting.md).
+
 <details>
 <summary><b>One-line installers · migrating from the legacy package</b></summary>
 

package/README.ja.md

@@ -150,7 +150,7 @@ Layer 4: RuntimeHookPipeline（75 hooks）→ trap-and-emulate で退化行動
 
 ### 1. 環境要件
 
-- **Node.js ≥ 24**（`engines` で固定）—— `node --version` で確認。低いバージョンは npm インストール時に警告が出るだけでサポート対象外。ワンラインインストールスクリプトは直接ブロックしてアップグレード案内を出します。
+- **Node.js 24.22.1+（24.x 系）または 26.12.1+（26.x 系）**（`engines` 固定）—— `node --version` で確認。Node 22 / 23 / 25 / 27、24.x < 24.22.1、26.x < 26.12.1 は v3.36.0 以降の安全ゲートで起動時に拒否されます。`/update` 後に新 CLI が起動しない場合も、まず Node をアップグレードしてください。ワンラインインストールスクリプトは事前にブロックして案内します。
 - **Git**（強く推奨）—— 任意。無くても天枢は動作します（その場で修正）が、Git があると委譲 worktree 分離・チェックポイントロールバック・`commit`/`diff` レビュー・worker ごとの diff レビューが使えます。インストール：<https://git-scm.com/downloads>。
 
 ### 2. インストール（いずれかを選択）
@@ -161,7 +161,7 @@ Layer 4: RuntimeHookPipeline（75 hooks）→ trap-and-emulate で退化行動
 > **Windows サポート範囲**：Windows 10（1809+、22H2 推奨）/ Windows 11。画面描画は **WebView2 Runtime（推奨 ≥ 120）** に依存——v3.5 以降のスクロール・描画最適化には新しいランタイムが必要で、古いとセッション領域のスクロールがカクつきます。3.5.3 以降インストーラーは完全なオフラインインストールパッケージを同梱（ネット不要・システムレベル登録）。既存ユーザーが自動更新で古すぎる旨の表示が出た場合：通知バーまたは「設定 → ランタイムとバージョン情報」で「修復ツールを実行」。**ウィンドウが完全に開かない**場合は、スタートメニューの「WebView2 を修復」、または [Releases](https://github.com/huiliyi37/Tianshu-harness/releases/latest) の `windows-repair` ディレクトリから `repair-webview2.cmd` をダブルクリック。[WebView2 オフラインインストールパッケージ](https://go.microsoft.com/fwlink/p/?LinkId=2124703) を手動インストールして再起動しても構いません。
 > **Win10 タブレットモードの既知動作**：タブレットモードでアプリを切り替えると前のアプリが画面外へスライドします——computer_use のスナップショットは遮へい／バックグラウンド自己修復（PrintWindow 描画）済みで、タブレットモードを切る必要はありません。
 
-**方法 B：ワンラインインストールスクリプト（推奨）** —— Node ≥ 24 を検証 → `tianshu-harness` をグローバルインストール（デフォルトは npmmirror ミラー加速、`NPM_CONFIG_REGISTRY` で上書き可）→ `tianshu` を起動。冪等で再実行可能：
+**方法 B：ワンラインインストールスクリプト（推奨）** —— Node 24.22.1+ / 26.12.1+ を検証 → `tianshu-harness` をグローバルインストール（デフォルトは npmmirror ミラー加速、`NPM_CONFIG_REGISTRY` で上書き可）→ `tianshu` を起動。冪等で再実行可能：
 
 ```bash
 # macOS / Linux（bash）

package/README.ko.md

@@ -150,7 +150,7 @@ Layer 4: RuntimeHookPipeline（75 hooks） → trap-and-emulate로 퇴화 행동
 
 ### 1. 환경 요구사항
 
-- **Node.js ≥ 24**（`engines` 고정）—— `node --version`으로 확인하세요. 낮은 버전은 npm 설치 시 경고만 뜨며 지원 범위가 아닙니다. 원클릭 설치 스크립트는 직접 차단하고 업그레이드 안내를 제시합니다.
+- **Node.js 24.22.1+（24.x 계열）또는 26.12.1+（26.x 계열）**（`engines` 고정）—— `node --version`으로 확인하세요. Node 22 / 23 / 25 / 27, 24.x < 24.22.1, 26.x < 26.12.1은 v3.36.0 이후 안전 게이트에서 시작 시 거부됩니다. `/update` 후 새 CLI가 시작되지 않는 경우에도 먼저 Node를 업그레이드하세요. 원클릭 설치 스크립트는 사전에 차단하고 안내를 제시합니다.
 - **Git**（강력 권장）—— 선택 사항. 없어도 天枢는 동작하지만（그 자리에서 수정）, Git이 있으면 위임 worktree 격리, 체크포인트 롤백, `commit`/`diff` 검토, worker별 diff 검토가 가능합니다. 설치: <https://git-scm.com/downloads>.
 
 ### 2. 설치（택一）
@@ -161,7 +161,7 @@ Layer 4: RuntimeHookPipeline（75 hooks） → trap-and-emulate로 퇴화 행동
 > **Windows 지원 범위**: Windows 10（1809+, 22H2 권장）/ Windows 11. 화면 렌더링은 **WebView2 Runtime（≥ 120 권장）**에 의존합니다——v3.5부터의 스크롤·렌더링 최적화는 최신 런타임이 필요하며, 구버전은 세션 영역 스크롤이 끊깁니다. 3.5.3부터 설치 프로그램에 완전한 오프라인 설치 패키지가 내장됩니다（네트워크 불필요, 시스템 레벨 등록）. 기존 사용자가 자동 업데이트 후 "너무 오래됨" 안내를 받으면: 안내 바 또는 「설정 → 런타임 및 정보」에서 「복구 도구 실행」. **창이 아예 열리지 않을 때**는 시작 메뉴의 「WebView2 복구」를 사용하거나, [Releases](https://github.com/huiliyi37/Tianshu-harness/releases/latest)에서 `windows-repair` 디렉터리의 `repair-webview2.cmd`를 더블클릭하세요. 또는 [WebView2 오프라인 설치 패키지](https://go.microsoft.com/fwlink/p/?LinkId=2124703)를 수동 설치 후 재시작하세요.
 > **Win10 태블릿 모드 알려진 동작**: 태블릿 모드에서 앱 전환 시 이전 앱이 화면 밖으로 밀려납니다——computer_use 스냅샷이 가림/백그라운드 자가복구를 수행하므로（PrintWindow 렌더링）태블릿 모드를 끌 필요가 없습니다.
 
-**방식 B: 원클릭 설치 스크립트（권장）** —— Node ≥ 24 확인 → `tianshu-harness` 전역 설치（기본 npmmirror 미러 가속, `NPM_CONFIG_REGISTRY`로 덮어쓰기 가능）→ `tianshu` 실행. 멱등하게 반복 실행 가능:
+**방식 B: 원클릭 설치 스크립트（권장）** —— Node 24.22.1+ / 26.12.1+ 확인 → `tianshu-harness` 전역 설치（기본 npmmirror 미러 가속, `NPM_CONFIG_REGISTRY`로 덮어쓰기 가능）→ `tianshu` 실행. 멱등하게 반복 실행 가능:
 
 ```bash
 # macOS / Linux（bash）

package/README.md

@@ -16,6 +16,7 @@
   <a href="docs/user-guide.md"><img src="https://img.shields.io/badge/Docs-%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C-FBBC04" alt="Docs"></a>
   <a href="https://discord.gg/XjWTATCHB"><img src="https://img.shields.io/badge/Discord-%E4%BA%A4%E6%B5%81%E7%BE%A4-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-34A853" alt="License"></a>
+  <a href="https://github.com/RyanAlberts/best-of-Agent-Harnesses"><img src="https://img.shields.io/badge/%F0%9F%8F%86_Best_of-Agent_Harnesses-5ac4bf" alt="Best of Agent Harnesses"></a>
 </p>
 
 <p align="center">
@@ -103,6 +104,19 @@ tianshu
 </tr>
 </table>
 
+> [!WARNING]
+> **Node.js 版本硬门槛（v3.36.0 起）**：CLI 仅支持 **Node 24.22.1+（24.x 线）或 26.12.1+（26.x 线）**。
+> Node 22 / 23 / 25 / 27、24.x < 24.22.1、26.x < 26.12.1 会在启动时被安全闸门拒绝；
+> `/update` 可能已经装上新包，但新 CLI 仍无法启动。先运行 `node -v`，不满足时用
+> nvm / fnm / Volta 或 nodejs.org 升级后再安装。
+>
+> ```bash
+> node -v   # 需要 v24.22.1+ 或 v26.12.1+
+> ```
+>
+> 桌面端自带运行时，不需要手动安装 Node。升级后仍失败时见
+> [安装指南](docs/guides/installation.md) 与 [排障指南](docs/guides/troubleshooting.md)。
+
 <details>
 <summary><b>一键安装脚本 · 从旧包迁移</b></summary>
 

package/dist/{account-FN6PNEAC.js → account-Q54MGORC.js}

@@ -33,11 +33,11 @@ import {
   saveAccountIdentity,
   saveAccountProfile,
   saveAccountToken
-} from "./chunk-JGVY5WCB.js";
-import "./chunk-OKQSB4Q7.js";
-import "./chunk-UOQ7KPKF.js";
-import "./chunk-MZWIL6AJ.js";
-import "./chunk-5XJXMOU6.js";
+} from "./chunk-ESJSMCQS.js";
+import "./chunk-XUMXRP3L.js";
+import "./chunk-GH4JI6BC.js";
+import "./chunk-R5Q7AA2C.js";
+import "./chunk-4I2HDYJG.js";
 export {
   ACCOUNT_IDENTITY_TTL_MS,
   HTTP_TIMEOUT_MS,

package/dist/{account-login-JMZGAHFE.js → account-login-7X53AED6.js}

@@ -2,10 +2,10 @@
 import { createRequire as __rivetCreateRequire } from 'node:module'; const require = __rivetCreateRequire(import.meta.url);
 import {
   accountDeviceFingerprint
-} from "./chunk-CQJEQQH7.js";
+} from "./chunk-UGHCGSJI.js";
 import {
   init_esm_shims
-} from "./chunk-5XJXMOU6.js";
+} from "./chunk-4I2HDYJG.js";
 
 // src/tui/account-login.ts
 init_esm_shims();
@@ -17,9 +17,9 @@ async function handleAccountLogin(app) {
     accountStore,
     saveAccountToken,
     isTerminalPollStatus
-  } = await import("./account-FN6PNEAC.js");
-  const { openInBrowser } = await import("./login-flow-POAD22XJ.js");
-  const { rivetHome } = await import("./paths-CIFLNBLG.js");
+  } = await import("./account-Q54MGORC.js");
+  const { openInBrowser } = await import("./login-flow-WBIW4TPG.js");
+  const { rivetHome } = await import("./paths-PE56RINB.js");
   app.commitStatic("\u6B63\u5728\u5411\u5929\u67A2\u7533\u8BF7\u8BBE\u5907\u6388\u6743\u2026");
   let created;
   try {
@@ -42,7 +42,7 @@ ${created.verifyUrl}
   });
   if (result.status === "approved" && result.accessToken) {
     const token = saveAccountToken(accountStore(rivetHome()), result);
-    const { primeStellarIdentity } = await import("./account-status-BLI25EMO.js");
+    const { primeStellarIdentity } = await import("./account-status-I4TDW3ZM.js");
     const identityLine = await primeStellarIdentity(token.accessToken);
     app.commitStatic("\u2705 \u5DF2\u767B\u5F55\u5929\u67A2\u8D26\u53F7\u2014\u2014\u684C\u9762\u7AEF\u4E0E\u7F51\u9875\u7AEF\u73B0\u5728\u770B\u5230\u540C\u4E00\u4EFD\u8BBE\u5907\u4E0E\u8BA2\u9605\u3002");
     if (identityLine) app.commitStatic(`\u661F\u7C4D\uFF1A${identityLine}`);
@@ -54,8 +54,8 @@ ${created.verifyUrl}
   return true;
 }
 async function handleAccountLogout(app) {
-  const { accountStore, revokeAccountSession } = await import("./account-FN6PNEAC.js");
-  const { rivetHome } = await import("./paths-CIFLNBLG.js");
+  const { accountStore, revokeAccountSession } = await import("./account-Q54MGORC.js");
+  const { rivetHome } = await import("./paths-PE56RINB.js");
   const store = accountStore(rivetHome());
   const credential = store.load()?.accessToken;
   store.clear();

package/dist/{account-status-BLI25EMO.js → account-status-I4TDW3ZM.js}

@@ -5,17 +5,17 @@ import {
   commitWelcomeStellarIdentityLine,
   formatStellarIdentityLine,
   primeStellarIdentity
-} from "./chunk-WB3IS2OB.js";
-import "./chunk-JGVY5WCB.js";
-import "./chunk-OKQSB4Q7.js";
-import "./chunk-4EZXXQUC.js";
-import "./chunk-UOQ7KPKF.js";
-import "./chunk-QXHDQ2ZO.js";
-import "./chunk-3S6UAT6V.js";
-import "./chunk-VLS656NA.js";
-import "./chunk-MZWIL6AJ.js";
-import "./chunk-EVYOMEJD.js";
-import "./chunk-5XJXMOU6.js";
+} from "./chunk-6G4FHROQ.js";
+import "./chunk-ESJSMCQS.js";
+import "./chunk-6I2YCDUJ.js";
+import "./chunk-XUMXRP3L.js";
+import "./chunk-MUIODEN6.js";
+import "./chunk-GH4JI6BC.js";
+import "./chunk-3DZ5UT3I.js";
+import "./chunk-GP37UWT4.js";
+import "./chunk-R5Q7AA2C.js";
+import "./chunk-M5U2TMZN.js";
+import "./chunk-4I2HDYJG.js";
 export {
   accountIdentityLines,
   commitWelcomeStellarIdentityLine,