@zq-silk/yui 2.23.0 → 2.25.0

package/docs/roles-and-configuration.zh-CN.md

@@ -15,6 +15,33 @@ Task Role 是 Task 局部的；global Role 提供已配置的默认值和全局
 的 global Role。只有当请求的 Task Role 不存在时，global Role 才作为创建模板。
 可用性、producer 分离和冻结的审查候选仍然适用。
 
+## Git 操作预算
+
+三项 Git 超时均有正式配置。本地命令（包括本地 ref 复制和产物仓库）使用总耗时上限；
+clone、远程 fetch 和需要连接远端的 `ls-remote` 使用独立的无进展超时与总耗时上限：
+
+```sh
+yui config tools show
+yui config tools set git-local-timeout-seconds 30
+yui config tools set git-remote-inactivity-timeout-seconds 120
+yui config tools set git-remote-timeout-seconds 1800
+yui config tools clear git-local-timeout-seconds
+yui config tools clear git-remote-inactivity-timeout-seconds
+yui config tools clear git-remote-timeout-seconds
+```
+
+三项都接受 1–86400 的整数秒，默认分别为单条本地命令总耗时 30 秒、
+无 stdout/stderr 输出 120 秒、单条远程命令总耗时 1800 秒。
+保存后下一条命令生效，包括 Controller 的 Project refresh 和 Task
+准备；无需重启，已启动命令保持原预算。clone/fetch 即使没有终端也显式请求进度输出。
+每次输出只重置静默计时，不延长总上限；输出仅证明活动，不证明传输在推进。
+远程 stderr 只保留末尾 64 KiB，避免长时间进度输出耗尽缓冲；stdout 和本地命令输出
+保留原缓冲上限。
+
+任一预算耗尽时终止该次调用自己的进程组（含传输 helper），等待进程与管道关闭。
+错误保留超时类型和预算、实际耗时、可用的退出码、信号及 stderr；不会自动重试，
+失败也不等于已回滚。存储 1.28 → 1.29 声明三项可选配置，不重写旧配置或持久化默认值。
+
 ## 可选实例码与会话标题
 
 每个 Role 独立配置仅用于展示的实例码。例如只设置 Operator，其他角色留空：

package/docs/storage-baseline.md

@@ -2,7 +2,11 @@
 
 # Storage baseline 1.0
 
-Current storage is 1.28. The 1.27 → 1.28 transition admits exact-identity native
+Current storage is 1.29. The 1.28 → 1.29 transition admits optional local Git
+total and remote Git inactivity/total timeout settings. Existing configuration payloads remain
+byte-for-byte unchanged; absent fields use runtime defaults.
+
+The 1.27 → 1.28 transition admits exact-identity native
 title effect receipts under `runtime/native-titles`. It does not infer historical
 title ownership, rename conversations, or change existing database payloads.
 Unconfirmed naming intents remain non-replayable across Host replacement.

package/docs/storage-baseline.zh-CN.md

@@ -2,7 +2,9 @@
 
 # 存储基线 1.0
 
-当前存储为 1.28。1.27 → 1.28 声明 `runtime/native-titles` 下绑定精确会话身份的原生标题意图与回执；迁移不认领历史标题、不改名、不改写既有数据库 payload。未确认改名意图在 Host 替换后也不得重放。
+当前存储为 1.29。1.28 → 1.29 声明本地 Git 总耗时、远程 Git 无进展超时和总耗时上限三项可选配置；既有配置 payload 逐字节保留，缺失字段使用运行时默认值。
+
+1.27 → 1.28 声明 `runtime/native-titles` 下绑定精确会话身份的原生标题意图与回执；迁移不认领历史标题、不改名、不改写既有数据库 payload。未确认改名意图在 Host 替换后也不得重放。
 
 1.26 → 1.27 允许现有 role-runtime mailbox 保存版本化 Host 升级信号，不新增表、不推断历史升级请求、不改写既有 payload。排空回执先于 Host 退出持久化；Controller 重启继续精确升级请求，不重放业务输入。
 

package/docs/testing/verification-levels.md

@@ -53,12 +53,12 @@ is required.
 Both include `test/core` and `test/platform`. For an already built checkout,
 `npm run test:business` runs only `test/core` and `npm run test:platform` runs
 only `test/platform`; neither rebuilds. CI owns one explicit build per job.
-The stable suite owns current storage 1.28 and its declared 1.0 through 1.27 minor
+The stable suite owns current storage 1.29 and its declared 1.0 through 1.28 minor
 transition. It contains no undeclared historical format compatibility path.
 
 Current coverage includes:
 
-1. Fresh storage 1.28, exact schema/record validation, no initialization over
+1. Fresh storage 1.29, exact schema/record validation, no initialization over
    unknown data, and rejection of old integer formats without mutation.
 2. Exact-version staging, mismatched-target refusal, same-major contiguous
    minor preflight, explicit maintenance-owner identity across handover, and
@@ -160,17 +160,17 @@ adjudication aggregation are deterministic; they do not run or measure a model.
 
 `ci.yml` runs on PRs and master. Business contracts and full package business
 wiring run once on Linux x64/Node 24. Platform tests run on Linux Node 24/26
-and Mac Intel/Apple Silicon Node 24. Every job builds exactly once, without
+and macOS Apple Silicon Node 24. Every job builds exactly once, without
 another lint or implicit pretest build. Keep the existing job names for branch
 checks; the complete workflow must pass for the exact master commit.
 
 | Evidence | PR/master | Exact release tarball |
 | --- | --- | --- |
 | Business/state/authority contracts (`test/core`) | Linux 24 once | Reuse exact-SHA successful Core CI |
-| OS/helper/PTY/Git/SQLite boundaries (`test/platform`) | Linux 24/26, both Macs 24 | Real SQLite SQL/GC on all 12 installs; other installed boundaries below |
+| OS/helper/PTY/Git/SQLite boundaries (`test/platform`) | Linux 24/26, Apple Silicon Mac 24 | Real SQLite SQL/GC on all 8 installs; other installed boundaries below |
 | `full` smoke: business Jobs/Schedules + lifecycle + compatibility | Linux 24 once | Reuse exact-SHA business evidence |
-| `lifecycle` smoke: restart, Session/Host handoff, archive + compatibility | Both Macs 24 (Linux included in full) | Node 24 on each of the 3 platforms |
-| `compatibility` smoke: setup, CLI/bin, helpers, Doctor/PTY/SQLite | Linux 26 (included in other profiles) | All 3 platforms × Node 20/22/24/26 (included in lifecycle on 24) |
+| `lifecycle` smoke: restart, Session/Host handoff, archive + compatibility | Apple Silicon Mac 24 (Linux included in full) | Node 24 on each of the 2 platforms |
+| `compatibility` smoke: setup, CLI/bin, helpers, Doctor/PTY/SQLite | Linux 26 (included in other profiles) | Both platforms × Node 20/22/24/26 (included in lifecycle on 24) |
 
 `node scripts/smoke-runtime-package.mjs --assembled .release-stage` exercises
 the actual CLI/Controller/Host/SQLite and isolated tmux, replacing only the
@@ -224,7 +224,7 @@ It starts empty on each smoke invocation and is removed with the fixture.
 No cache is restored across jobs, packages or Node versions, and no production
 default changes. Keep it out of V8 coverage runs, where it can reduce precision.
 
-`publish.yml` builds one archive containing all three native targets and runs
+`publish.yml` builds one archive containing both supported native targets and runs
 the profiles above against that exact freshly installed package through
 `YUI_INSTALLED_ROOT`, adding actual npm-bin, dependency, supported Node version,
 artifact and provenance boundaries. This validates runtime integration, not

package/docs/testing/verification-levels.zh-CN.md

@@ -39,12 +39,12 @@ Yui 是一个单用户本地产品。永久验证保护关键的 happy path 和
 两者均包含 `test/core` 和 `test/platform`。已构建的 checkout 可分别运行
 `npm run test:business` 与 `npm run test:platform`，它们不会再次构建。
 CI 每个作业只显式构建一次。
-稳定套件维护当前存储 1.28 和明确声明的 1.0 至 1.27 连续小版本迁移，
+稳定套件维护当前存储 1.29 和明确声明的 1.0 至 1.28 连续小版本迁移，
 不包含未声明的历史格式兼容路径。
 
 当前覆盖包括：
 
-1. 新建存储 1.28、精确结构与记录校验、禁止覆盖未知数据库、无修改拒绝旧整数格式。
+1. 新建存储 1.29、精确结构与记录校验、禁止覆盖未知数据库、无修改拒绝旧整数格式。
 2. 精确版本暂存、目标不匹配拒绝、同主版本连续小版本预检、交接锁显式所有者，
    以及恢复时核对捕获的协议和存储身份，不接受缺失字段。
 3. 持久 Task／Message／Decision 上下文、Draft 激活权威、mailbox 认领、
@@ -101,17 +101,17 @@ package-start 检查跟随已安装树中的本地 Skill 引用，包括跨 Role
 ## CI 与发布
 
 `ci.yml` 在 PR 和 master 上执行。业务契约与完整业务链路仅在 Linux x64/Node 24
-运行一次；平台测试在 Linux Node 24/26、Intel/Apple Silicon Mac Node 24 上运行。
+运行一次；平台测试在 Linux Node 24/26、Apple Silicon Mac Node 24 上运行。
 每个作业只构建一次，不重复 lint 或隐含 pretest 构建。保留现有作业名称；发布仍要求
 精确 master SHA 的整个 Core CI 成功，不复用另一源码的结果。
 
 | 证据 | PR/master | 精确发布 tarball |
 | --- | --- | --- |
 | 业务、状态、授权契约（`test/core`） | Linux 24 一次 | 复用精确 SHA 的成功 Core CI |
-| OS/helper/PTY/Git/SQLite（`test/platform`） | Linux 24/26、双 Mac 24 | 12 组真实 SQL/GC；其余安装边界见下 |
+| OS/helper/PTY/Git/SQLite（`test/platform`） | Linux 24/26、Apple Silicon Mac 24 | 8 组真实 SQL/GC；其余安装边界见下 |
 | `full`：Jobs/Schedules 业务链路 + lifecycle + compatibility | Linux 24 一次 | 复用精确 SHA 业务证据 |
-| `lifecycle`：重启、Session/Host 交接、归档 + compatibility | 双 Mac 24，Linux 已在 full 内 | 三平台 Node 24 |
-| `compatibility`：setup、CLI/bin、helper、Doctor/PTY/SQLite | Linux 26，其余已包含 | 三平台 × Node 20/22/24/26，24 已包含在 lifecycle 内 |
+| `lifecycle`：重启、Session/Host 交接、归档 + compatibility | Apple Silicon Mac 24，Linux 已在 full 内 | 两平台 Node 24 |
+| `compatibility`：setup、CLI/bin、helper、Doctor/PTY/SQLite | Linux 26，其余已包含 | 两平台 × Node 20/22/24/26，24 已包含在 lifecycle 内 |
 
 `node scripts/smoke-runtime-package.mjs --assembled .release-stage` 经过真实
 CLI/Controller/Host/SQLite 与隔离 tmux，仅用确定性夹具替换外部 Provider。它验证

package/i18n/README.zh-CN.md

@@ -5,7 +5,7 @@
 [![Core CI](https://github.com/zhangqian-silk/yui/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/zhangqian-silk/yui/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../LICENSE)
 ![Node](https://img.shields.io/badge/node-20%20%7C%2022%20%7C%2024-brightgreen.svg)
-![Platform](https://img.shields.io/badge/platform-Linux%20x64%20%28glibc%29%20%7C%20macOS%20x64%2Farm64-blue.svg)
+![Platform](https://img.shields.io/badge/platform-Linux%20x64%20%28glibc%29%20%7C%20macOS%20arm64-blue.svg)
 [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#参与开发)
 
 让 Agent 持续推进你的任务，而不只是回答一轮对话。
@@ -37,10 +37,14 @@ Yui 是面向编程 Agent 的本地控制面。你只需用自然语言把目标
 
 ## 快速开始
 
-npm 包包含 Linux x64、Mac Intel 和 Apple Silicon 的 Yui 预编译程序。
-同一份包在三个平台验证后发布，运行时只选择对应平台的程序。
+npm 包包含 Linux x64 和 macOS Apple Silicon 的 Yui 预编译程序。
+同一份包在两个平台验证后发布，运行时只选择对应平台的程序。
+从 2.25.0 开始不再支持 macOS Intel，也不支持通过 Rosetta 运行的 x64 Node.js。
+Intel Mac 用户须停留在 2.23.0；Apple Silicon 用户须使用原生 arm64 Node.js。
+npm 的 OS/CPU 字段不能表达这种平台配对，因此不支持的组合仍可能安装成功，
+但 Yui 会在加载任一 CLI 产品或打开 Home 前明确拒绝，不新增安装脚本。
 
-需要 Linux x64 / glibc 或 macOS（x64 或 Apple Silicon）、Git 2.29.0 或更新版本、tmux，以及
+需要 Linux x64 / glibc 或 macOS Apple Silicon（使用原生 arm64 Node.js）、Git 2.29.0 或更新版本、tmux，以及
 Node.js `^20.17.0`、`^22.9.0`、`^24.0.0` 或 `^26.0.0`。macOS 上可用
 `brew install tmux` 安装 tmux。最简单的方式是先安装 Codex CLI 或 Claude
 Code CLI，并确保它已经可以使用你自己的账号正常工作。Yui 负责协调 Agent，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zq-silk/yui",
-  "version": "2.23.0",
+  "version": "2.25.0",
   "description": "Local control plane for long-running native agent CLI sessions backed by tmux.",
   "license": "MIT",
   "private": false,