iterate-harness 1.10.1 → 1.11.1

package/README.md

@@ -1,5 +1,10 @@
 # iterate-harness (npm distribution wrapper)
 
+<p align="center">
+  <a href="README.md"><strong>English</strong></a> ·
+  <a href="README.zh-CN.md"><strong>简体中文</strong></a>
+</p>
+
 npm one-liner install for [iterate-harness](https://github.com/jingzhao-l/iterate-harness) —
 the dedicated agent harness for the iterate review/fix loop (`ih` CLI, React TUI,
 six `iterate_*` tools, engine-enforced convergence).

package/README.zh-CN.md

@@ -0,0 +1,74 @@
+# iterate-harness（npm 分发包装器）
+
+<p align="center">
+  <a href="README.md"><strong>English</strong></a> ·
+  <a href="README.zh-CN.md"><strong>简体中文</strong></a>
+</p>
+
+[iterate-harness](https://github.com/jingzhao-l/iterate-harness) 的一行 npm 安装入口——
+面向 iterate 评审/修复闭环的专用 agent harness（`ih` CLI、React TUI、
+六个 `iterate_*` 工具、引擎级收敛控制）。
+
+```bash
+npm install -g iterate-harness
+ih --version        # 首次运行引导安装 Python 端，随后打印版本
+```
+
+## 这个包是什么（以及不是什么）
+
+harness 本身是**一个 Python 包**。这个 npm 包是一个薄分发包装器：它不重新实现任何
+逻辑，只是让 `ih` 可以通过 npm 安装并保持更新。
+
+首次运行时，包装器会：
+
+1. 找到一个 >= 3.10 的 Python 解释器（`py -3` / `python` / `python3`，
+   可通过 `ITERATE_HARNESS_PYTHON` 覆盖）。
+2. 在 `~/.iterate-harness-npm/venv` 创建托管虚拟环境
+   （可通过 `ITERATE_HARNESS_NPM_HOME` 覆盖）。
+3. `pip install` **与本 npm 包版本锁定的** harness 发布 tarball —— npm 的 `1.6.0`
+   总会安装 harness `v1.6.0`。升级 npm 包会在下次运行时自动重装对应的 harness 版本。
+4. 代理调用 venv 里真正的 `ih` 可执行文件，转发 argv、stdio、信号与退出码。
+
+React TUI 的前端依赖（`node_modules`）会在首次启动 TUI 时由 harness 自动安装——
+npm 用户必然有 Node，所以 TUI 始终可用。
+
+## 环境要求
+
+- Node.js >= 16（你通过 npm 安装它，必然已具备）
+- Python >= 3.10（可用 `ITERATE_HARNESS_PYTHON=/path/to/python3.12` 覆盖）
+- 能访问 registry.npmjs.org（已完成）、pypi.org 和 github.com（用于一次性 pip 安装）
+
+## 环境变量
+
+| 变量 | 作用 |
+| --- | --- |
+| `ITERATE_HARNESS_PYTHON` | 使用该解释器，而非自动检测 |
+| `ITERATE_HARNESS_NPM_HOME` | 运行时目录（默认 `~/.iterate-harness-npm`） |
+| `ITERATE_HARNESS_INSTALL_URL` | 从这个 pip URL 安装，而非锁定的发布 tarball（例如测试用的 git 分支） |
+| `ITERATE_HARNESS_SKIP_INSTALL=1` | 完全跳过引导安装，直接运行已装好的 `ih` |
+
+## npx（免全局安装）
+
+```bash
+npx -y iterate-harness iterate review --changed
+```
+
+## 卸载
+
+```bash
+npm uninstall -g iterate-harness
+rm -rf ~/.iterate-harness-npm   # 托管虚拟环境
+```
+
+## 版本管理
+
+本包的版本与 harness 保持同步：包装器 `x.y.z` 安装 harness 的 `vx.y.z` 标签。
+包装器在 [iterate-skill monorepo](https://github.com/jingzhao-l/iterate-skill) 的
+`harness/iterate-harness/npm/` 维护，通过 `git subtree` 同步到
+[iterate-harness 发布仓库](https://github.com/jingzhao-l/iterate-harness) 并从那里发布到 npm。
+
+## License / 许可证
+
+MIT —— 与 harness 相同。agent 内核源自
+[OpenHarness](https://github.com/HKUDS/OpenHarness)；iterate 语义层源自
+[iterate-skill](https://github.com/jingzhao-l/iterate-skill)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iterate-harness",
-  "version": "1.10.1",
+  "version": "1.11.1",
   "description": "npm distribution wrapper for iterate-harness — installs the Python harness (ih CLI) into a managed venv on first run and exposes it as a global command",
   "license": "MIT",
   "type": "commonjs",