@cyning/harness 0.4.0 → 1.0.1

package/CHANGELOG.md

@@ -4,6 +4,48 @@
 
 ## [Unreleased]
 
+## [1.0.1] - 2026-06-16
+
+### Added
+
+- **业务仓 CLI 入口**：`npx @cyning/harness gate-check` · `verify` · `sync index`（读 `.cyning-harness/local.json`，无需 clone 产品包）
+- **`verify` 聚合命令**：30 前一条命令跑 gate-check + audit D5 + S5 warn + 可选 `--graph`
+- **`--help` / `--version` / `-V`**：全局与各子命令帮助
+- **Node 仓可选 `--with-scripts`**：`init|upgrade --with-scripts [--pm pnpm|npm|yarn|auto]` 写入 `devDependencies` 与 `scripts`（merge 不覆盖）
+- **业务仓 QUICKREF**：`harness/templates/QUICKREF_v1_zh.md`，install/upgrade 后写入 `.cyning-harness/QUICKREF.md`
+
+### Changed
+
+- `lib/audit.js` 使用统一 `resolveHarnessRootForTarget`，修复无 `CYNING_HARNESS` 时的路径 bug
+- `lib/cli.js` 子命令透传 `CYNING_HARNESS` 到 wizard 脚本
+- `README.md` · `docs/ONBOARDING.md` · `docs/USER_GUIDE_v1.0_zh.md` · `wizard/README.md` · IDE 片段：同步 v1.0.1 CLI 与 `verify` 用法
+- **`ontology.yaml`**：`product_semver: "1.0.1"`
+
+### Notes
+
+- **HG-RELEASE**（tag v1.0.1 · npm publish）仍留维护者人闸
+- `verify --graph` 硬挡规则与 `gate-check --graph` 一致
+
+## [1.0.0] - 2026-06-16
+
+### Added
+
+- **ICVO 机械审计 CLI**：`harness audit [--target PATH] [--task FILE]` · D3/D5/S5 子集
+- **InvokeSnapshot 索引**：`schema/invoke_index.v1.schema.json` · `wizard/harness-sync.sh --index`
+- **Inform 图谱闸**：`wizard/gate-check.sh --graph [--json]` · 读 `HG-GRAPH-MODULES` + `docs/_tech_graph/`
+- **B2 试点证据**：README「试点证据（B2）」节 · 链 [`PILOT_EVIDENCE_B2_v1_zh.md`](docs/methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md)
+- **SDD-Compliance micro-bench**：`examples/compliance_bench/` · `wizard/compliance-bench.sh` · S1–S4 4/4
+
+### Changed
+
+- **README** · **ONBOARDING** · 文档：v1.0 stable 叙事 · ICVO 审计 · B2 证据
+- **`ontology.yaml`**：`product_semver: "1.0.0"`
+
+### Notes
+
+- **HG-RELEASE**（tag v1.0.0 · npm publish · GitHub Release）仍留维护者人闸
+- **Track G HGM**：v1.0 关账后评估，v2.0+ 另开 Epic
+
 ## [0.4.0] - 2026-06-15
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 ```bash
 npx @cyning/harness@latest init --preset harness-only --ide cursor,agents
-npx @cyning/harness upgrade && npx @cyning/harness check
+npx @cyning/harness verify
 ```
 
 可 clone、可嵌入业务仓库的 **Harness 纪律包**（无业务代码，无内置 LLM）· **MIT 开源**。
@@ -33,9 +33,10 @@ npx @cyning/harness upgrade && npx @cyning/harness check
 
 ---
 
-## Quick Start（npx · v0.3+）
+## Quick Start（npx · v1.0）
 
-> 顶部三行即最小接入。须在 **目标业务仓根** 执行（勿在本产品仓根跑 `npx`，会报 `harness: command not found`）。
+> 顶部三行即最小接入。须在 **目标业务仓根** 执行（勿在本产品仓根跑 `npx`，会报 `harness: command not found`）。  
+> **陌生人完整手册**：[`docs/USER_GUIDE_v1.0_zh.md`](docs/USER_GUIDE_v1.0_zh.md)
 
 **维护者 · 在本仓库根验证 CLI**（npm 不会为「当前包」链接 `bin`，`npx` 会报 `harness: command not found`）：
 
@@ -64,13 +65,66 @@ git clone git@github.com:Cyning12/cyning-harness.git && cd cyning-harness
 ```text
 install / adopt  →  harness-sync plan/apply  →  @ task + prompts（10→22→30）
                       ↑ 产品包 git pull 后 upgrade.sh
-30 前：gate-check.sh  ·  HG-AUDIT-R1 = approved
+30 前：npx @cyning/harness verify  ·  HG-AUDIT-R1 = approved
 ```
 
 1. 阅读 [`docs/ONBOARDING.md`](docs/ONBOARDING.md)  
-2. [`wizard/install.sh`](wizard/install.sh) 或 [`adopt-existing.sh`](wizard/adopt-existing.sh)  
-3. 产品包更新：[`wizard/upgrade.sh`](wizard/upgrade.sh) 或 [`harness-sync.sh`](wizard/harness-sync.sh) `apply`  
-4. IDE `@` task + `docs/harness/prompts/`；30 前 [`gate-check.sh`](wizard/gate-check.sh)  
+2. [`npx @cyning/harness init`](docs/USER_GUIDE_v1.0_zh.md) 或 [`wizard/install.sh`](wizard/install.sh) / [`adopt-existing.sh`](wizard/adopt-existing.sh)  
+3. 产品包更新：`npx @cyning/harness upgrade` 或 [`wizard/upgrade.sh`](wizard/upgrade.sh) / [`harness-sync.sh`](wizard/harness-sync.sh) `apply`  
+4. IDE `@` task + `docs/harness/prompts/`；30 前 `npx @cyning/harness verify` 或 `npx @cyning/harness gate-check`  
+
+---
+
+## ICVO 机械审计（v1.0+）
+
+`npx @cyning/harness verify` 在 30 执行前聚合检查 ICVO 公理子集：
+
+```bash
+npx @cyning/harness verify --target /path/to/your-repo --task docs/tasks/active/task_xxx.md
+npx @cyning/harness gate-check --target /path/to/your-repo --task docs/tasks/active/task_xxx.md
+npx @cyning/harness audit --target /path/to/your-repo --task docs/tasks/active/task_xxx.md
+npx @cyning/harness upgrade --gate-check       # upgrade 前自动 audit
+```
+
+- **D3**：`gate-check` 真值唯一来源，HG-AUDIT-R1 / HG-GRAPH-MODULES pending 时拒 30  
+- **D5**：`test_strategy=required` 任务须声明测试路径或 CI 引用  
+- **S5**：dirty 工作区 warn，apply 须 `--force` 明示  
+
+Inform 图谱闸：`npx @cyning/harness gate-check --graph --target /path/to/your-repo`  
+Invoke 索引：`npx @cyning/harness sync index --target /path/to/your-repo`（不覆盖 S2 域）
+
+Node 仓可选：`npx @cyning/harness init --with-scripts` → `pnpm harness:verify`。  
+详见 [`docs/USER_GUIDE_v1.0_zh.md`](docs/USER_GUIDE_v1.0_zh.md) · [`docs/ONBOARDING.md`](docs/ONBOARDING.md) §2.2。
+
+---
+
+## 试点证据（B2）
+
+> **冻结状态**：2026-06-16 · 策略 A（3 字段未系统采集，标 N/A，不编造）  
+> **完整证据链**：[`docs/methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md`](docs/methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md)
+
+**真实试点 retro（kimi-code-meta preset · 2026-06-10 → 2026-06-15）**
+
+| 指标 | 值 | 说明 |
+| --- | --- | --- |
+| `sample_n` | **6** | harness-only dogfood、文档修复、agent-core 改码等 |
+| `upstream_pr_d6_clean` | **3/3 = 100%** | D6 双分支过程轨零泄漏（#622 / #630 / #708） |
+| `ci_first_green_rate` | **3/3 = 100%** | 改码 task 首次 CI 绿（样本极小，禁止外推胜率） |
+| `gate_block_count` | **3+** | 30 前 gate-check 拦截样例已记录 |
+| `failure_report_count` | **1** | #94 越闸事件 → 修复 GATE_VERIFY 协议 |
+| `audit_reject_rate` | **N/A** | 策略 A：样本期未系统采集 22 R1 内容阻塞 |
+| `audit_rounds_mean` | **N/A** | 策略 A：同 `audit_reject_rate` |
+| `wizard_adoption_days` | **N/A** | 策略 A：install 日期未落盘，无法准确计算 |
+
+**SDD-Compliance micro-bench（可机械复现 · 不测 LLM 解题）**
+
+| 项 | 值 |
+| --- | --- |
+| 覆盖 | S1–S4（D2 HumanGate · D3 gate-check · S2 sync 域） |
+| 结果 | **4/4 = 100%** |
+| 运行 | [`./wizard/compliance-bench.sh --all`](../wizard/compliance-bench.sh) · 说明 [`examples/compliance_bench/README.md`](../examples/compliance_bench/README.md) |
+
+**免责声明**：本表为 **小样本机制证据**，非胜率承诺；Part A 与 Terminal-Bench / SWE-bench **互补、不对标**。
 
 ---
 
@@ -113,9 +167,9 @@ cyning-harness/
 
 | 项 | 值 |
 |----|-----|
-| 当前 | **v0.4.0** — A3 public push 准备 · ontology.yaml · MIT · 脱敏金样 |
-| 上一档 | v0.3.x — npx CLI · Starter 四帽 · manifest · S5 |
-| 许可 | **MIT** · [`LICENSE`](LICENSE) · 战略 POINTER 见 [`methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md`](docs/methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md) |
+| 当前 | **v1.0.0** — A4 stable · ICVO audit · invoke_index · gate-check --graph · B2 证据 |
+| 上一档 | v0.4.0 — A3 public push · MIT · 脱敏金样 |
+| 许可 | **MIT** · [`LICENSE`](LICENSE) · Release [`docs/RELEASE_v1.0.0.md`](docs/RELEASE_v1.0.0.md) |
 
 ---
 
@@ -125,7 +179,7 @@ cyning-harness/
 | --- | --- |
 | **总指引** | [`methodology/README.md`](docs/methodology/README.md) · [关系图](docs/methodology/DOCUMENT_MAP_v1_zh.md) · [路线 ROADMAP](docs/methodology/ROADMAP_v1_zh.md) |
 | **本体** | [DESIGN_ONTOLOGY v1.2](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md) |
-| **落地** | [P0 差距](docs/methodology/execution/P0_V0.2_GAP.md) · [金样验收](examples/demo_checkout/ACCEPTANCE.md) · [ETCLOVG 映射](docs/ETCLOVG_MAPPING_v1_zh.md) |
+| **使用** | [**USER_GUIDE v1.0**](docs/USER_GUIDE_v1.0_zh.md) · [P0 差距](docs/methodology/execution/P0_V0.2_GAP.md) · [金样验收](examples/demo_checkout/ACCEPTANCE.md) · [ETCLOVG 映射](docs/ETCLOVG_MAPPING_v1_zh.md) |
 | **远期** | [HGM 草案](docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md) |
 | **接入** | [ONBOARDING](docs/ONBOARDING.md) · [ARCHITECTURE](docs/ARCHITECTURE.md) |
 

package/bin/harness.js

@@ -2,6 +2,6 @@
 import { runCli } from '../lib/cli.js';
 
 runCli(process.argv.slice(2)).catch((err) => {
-  console.error(err.message || err);
+  if (err.message) console.error(err.message);
   process.exit(typeof err.exitCode === 'number' ? err.exitCode : 1);
 });

package/docs/ARCHITECTURE.md

@@ -67,5 +67,5 @@ CLI/Worker 与模板 **同一仓库** 演进，避免多仓割裂。
 
 Track / Hat / Sync / SDD 公理与扩展规则见 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)（**v1.2**）。  
 **方法论总指引**：[`methodology/README.md`](./methodology/README.md) · 关系图 [`methodology/DOCUMENT_MAP_v1_zh.md`](./methodology/DOCUMENT_MAP_v1_zh.md)  
-远期 **过程实例图 + 事件历史** 见 [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)（HGM · v0.5+ 提案）。  
+远期 **过程实例图 + 事件历史** 见 [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)（HGM · **v2.0+** 提案 · v1.0 后）。  
 与 **战略本体**（工作区 `docs/harness/guides/STRATEGY_ONTOLOGY_*`）分层：本文件描述 **产品如何实现**，战略文档描述 **对外演进**。

package/docs/BENCHMARK_REPORT_TEMPLATE.md

@@ -0,0 +1,135 @@
+# cyning-harness 项目开发收益基准报告（模板）
+
+> **用途**：产品稳定后，用真实数据替换占位符，快速生成有说服力的验证报告。  
+> **状态**：`draft` · 待实验填充  
+> **关联**：Epic #8 B2+bench · ROADMAP v1.0 README 量化段落 · `profiles/benchmark-profile.json`（待建）
+
+| 项目 | 内容 |
+| --- | --- |
+| **报告版本** | v1.0 |
+| **日期** | YYYY-MM-DD |
+| **测试执行者** | [你的姓名 / 社区团队] |
+| **产品版本** | cyning-harness vX.Y.Z |
+| **实验类型** | 对照项目（with vs without harness） |
+
+---
+
+## 1. 实验目标
+
+验证 cyning-harness 纪律包在真实项目开发中是否能够：
+
+- 提升任务交付效率
+- 提高代码质量与合规性
+- 增强过程可追溯性
+- 减少协作摩擦
+
+---
+
+## 2. 实验设计
+
+### 2.1 演示项目
+
+| 项 | 内容 |
+| --- | --- |
+| **项目名称** | [例如：todo-api-cli] |
+| **项目规模** | 预估 5–10 个任务（功能点/修复） |
+| **技术栈** | [例如：Node.js + TypeScript + PostgreSQL] |
+| **开发方式** | 单人/模拟团队（AI 助手 + 人工审查） |
+
+### 2.2 对照分组
+
+| 组别 | 配置 | 说明 |
+| --- | --- | --- |
+| **对照组** | 无 Harness | 裸 AI 助手（如 Kimi Code / Copilot）+ 手动流程 |
+| **实验组** | 有 Harness | 使用 cyning-harness，preset = [fullstack-node-py / harness-only]，并按项目需求定制 AdoptedProfile |
+
+### 2.3 测量指标
+
+| 类别 | 指标 | 测量方式 |
+| --- | --- | --- |
+| **效率** | 平均任务完成耗时 | 从任务创建到 PR merge 的时间 |
+| **质量** | 代码审查一次性通过率 | 审查中无需修改直接合并的比例 |
+| **合规性** | 关键闸门遵守率 | 任务是否按要求执行 test_strategy、graph-modules 等 |
+| **可追溯性** | 审计覆盖率 | 任务关联 AuditReview / InvokeSnapshot 的比例 |
+| **协作摩擦** | 沟通澄清次数 | 每个任务在聊天/评论中询问规则的平均次数 |
+
+---
+
+## 3. 实验结果（占位符）
+
+> **说明**：以下数据为示例格式，请替换为实际测量值。
+
+### 3.1 效率对比
+
+| 任务 ID | 对照组耗时 (h) | 实验组耗时 (h) | 变化 |
+| --- | --- | --- | --- |
+| T1 | 3.2 | 2.8 | -12.5% |
+| T2 | 5.0 | 4.1 | -18.0% |
+| … | … | … | … |
+| **平均** | X.X | Y.Y | ±XX% |
+
+### 3.2 质量对比
+
+| 指标 | 对照组 | 实验组 | 变化 |
+| --- | --- | --- | --- |
+| 代码审查一次性通过率 | XX% | YY% | +ZZ% |
+| 缺陷密度（Bug/千行） | X.X | Y.Y | -ZZ% |
+| 单元测试覆盖率 | XX% | YY% | +ZZ% |
+
+### 3.3 合规性与可追溯性
+
+| 指标 | 对照组 | 实验组 |
+| --- | --- | --- |
+| 关键闸门遵守率 | XX% | YY% |
+| 任务 → AuditReview 关联率 | XX% | YY% |
+| 任务 → InvokeSnapshot 关联率 | XX% | YY% |
+
+### 3.4 协作摩擦
+
+| 指标 | 对照组 | 实验组 |
+| --- | --- | --- |
+| 每任务平均澄清次数 | X.X | Y.Y |
+
+---
+
+## 4. 结论
+
+- **效率**：Harness 通过标准化流程（ProcessTrack + StarterHat）减少了不必要的等待和返工，任务耗时降低了约 XX%。
+- **质量**：强制 `test_strategy=required` 和 HumanGate 审批，使代码缺陷密度下降 XX%，审查通过率提升 XX%。
+- **合规与追溯**：所有关键闸门均有记录，任务与审计产物的关联率达到 100%，极大方便事后复盘。
+- **协作**：明确的规则和帽子链减少了沟通成本，每任务澄清次数从 X.X 降至 Y.Y。
+
+**总体**：cyning-harness 能够在不改变底层 AI 模型的前提下，显著提升项目开发的可靠性、规范性与效率。
+
+---
+
+## 5. 展望：从项目纪律到 Agent 治理
+
+当前 Harness 约束的是人类 + AI 的协作流程。未来当 AI Agent 具备更强自主性时，同一套本体（Task、Gate、AuditReview、InvokeSnapshot）可直接被 Agent 用作自检与审计接口，实现可信任的自主执行。cyning-harness 为这一演进提供了基础语义层和工程框架。
+
+---
+
+## 6. 附录
+
+| 项 | 路径 |
+| --- | --- |
+| 实验详细数据（原始日志、任务清单） | `/benchmarks/data/`（待建） |
+| 复现步骤 | `/benchmarks/REPRODUCE.md`（待建） |
+| 使用的 Harness 配置文件 | `profiles/benchmark-profile.json`（待建） |
+
+---
+
+## 模板使用建议
+
+1. 将本文件作为母版保留于 `docs/BENCHMARK_REPORT_TEMPLATE.md`。
+2. 完成实验后，复制一份命名为 `docs/BENCHMARK_REPORT_vX.X.md`，填入真实数据。
+3. 可配合图表（Mermaid 或截屏）增强可读性。
+4. v1.0 stable push 前，将结论摘要写入根 `README.md`（ROADMAP A4 · B2 量化段落）。
+
+---
+
+## 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | YYYY-MM-DD | 初版草稿 · 占位符待实验填充 |

package/docs/ONBOARDING.md

@@ -40,6 +40,38 @@ cd your-project
 
 ---
 
+## 2.2 ICVO 机械审计（v1.0+）
+
+`npx @cyning/harness verify` 在 30 执行前聚合扫描人工闸与测试声明，确保 ICVO 公理可机械检查：
+
+```bash
+# 30 前聚合验证（gate-check + audit D5 + S5 warn + 可选 --graph）
+npx @cyning/harness verify --target /path/to/your-repo
+npx @cyning/harness verify --target /path/to/your-repo \
+  --task docs/tasks/active/task_xxx.md
+
+# 仅人工闸
+npx @cyning/harness gate-check --target /path/to/your-repo
+npx @cyning/harness gate-check --graph --target /path/to/your-repo
+
+# 指定 task 的 ICVO 审计
+npx @cyning/harness audit --target /path/to/your-repo \
+  --task docs/tasks/active/task_xxx.md
+
+# 生成 invoke 索引（只读聚合，不覆盖 S2 域）
+npx @cyning/harness sync index --target /path/to/your-repo
+```
+
+| 公理 | 检查项 | 行为 |
+|------|--------|------|
+| **D3** | 30 前置人闸 | 复用 `gate-check.sh`，HG-AUDIT-R1 非 approved 时 verify 非 0 |
+| **D5** | 改码任务测试声明 | `test_strategy=required` 但无测试/CI 引用时 verify 非 0 |
+| **S5** | Git 工作区干净 | dirty 时 warn（不直接 fail verify，但 apply 须 `--force`） |
+
+Audit **不替代** 维护者最终判断；Agent 首输出仍须人工复核。
+
+---
+
 ## 2.1 安装向导（wizard · 存量/离线）
 
 `wizard/` 将提供勾选问卷（规划 **v0.1**）：

package/docs/README.md

@@ -3,7 +3,7 @@
 | 项 | 内容 |
 | --- | --- |
 | **入口** | 本页 → **[方法论总指引](./methodology/README.md)** |
-| **接入** | [`ONBOARDING.md`](./ONBOARDING.md) · [`../wizard/README.md`](../wizard/README.md) |
+| **接入** | [**USER_GUIDE v1.0**](./USER_GUIDE_v1.0_zh.md) · [`ONBOARDING.md`](./ONBOARDING.md) · [`../wizard/README.md`](../wizard/README.md) |
 | **架构** | [`ARCHITECTURE.md`](./ARCHITECTURE.md) |
 
 ---
@@ -12,7 +12,7 @@
 
 | 读者 | 先读 |
 | --- | --- |
-| **新接入** | ONBOARDING → wizard/install → [`methodology/execution/P0_V0.2_GAP.md`](./methodology/execution/P0_V0.2_GAP.md) |
+| **新接入** | **USER_GUIDE v1.0** → ONBOARDING → [`methodology/execution/P0_V0.2_GAP.md`](./methodology/execution/P0_V0.2_GAP.md) |
 | **实现 / 扩展** | [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md) |
 | **战略 / 开源** | [`methodology/pointers/`](./methodology/pointers/README.md) → 工作区 STRATEGY_* |
 | **HGM 远期** | [`methodology/graph/`](./methodology/graph/README.md) |

package/docs/RELEASE_v1.0.0.md

@@ -0,0 +1,91 @@
+# Release v1.0.0 · A4 stable
+
+> **包名**：`@cyning/harness@1.0.0`  
+> **许可**：MIT  
+> **日期**：2026-06-16  
+> **代号**：A4 · Stable（纪律包 · 无业务代码 · 无 LLM Runtime）
+
+---
+
+## 概要
+
+本版本为 **v1.0 stable**：完成 ICVO 四支柱机械审计、InvokeSnapshot 索引、Inform 图谱闸，并将 #8 B2 试点证据写入 README。v0.4 已解决「能公开分发」；v1.0 解决「公理可机械审计 + 编排索引 + Inform 图谱闸 + 证据进 README」。
+
+**定位**：嵌入任意业务仓的 **SDD 过程纪律包**（Inform / Constrain / Verify / Orchestrate 仓库化落地），与 Agent Runtime / MCP 宿主 **互补而非竞争**。详见 [`docs/ETCLOVG_MAPPING_v1_zh.md`](./ETCLOVG_MAPPING_v1_zh.md)。
+
+---
+
+## Quick Start
+
+在 **目标业务仓根**（非本产品仓根）：
+
+```bash
+npx @cyning/harness@1.0.0 init --preset harness-only --ide cursor,agents
+npx @cyning/harness upgrade
+npx @cyning/harness check
+npx @cyning/harness audit --target . --task docs/tasks/active/task_xxx.md
+```
+
+---
+
+## 新增
+
+| 项 | 说明 |
+| --- | --- |
+| **`harness audit`** | ICVO 机械审计 CLI · D3/D5/S5 · 复用 `gate-check.sh` |
+| **`schema/invoke_index.v1.schema.json`** | InvokeSnapshot 机器索引 schema |
+| **`wizard/harness-sync.sh --index`** | 生成 `.cyning-harness/invoke_index.json`（只读聚合 · 不覆盖 S2 域） |
+| **`wizard/gate-check.sh --graph [--json]`** | Inform 图谱闸 · 读 `HG-GRAPH-MODULES` + `docs/_tech_graph/` |
+| **B2 试点证据** | README「试点证据（B2）」节 · 链 [`PILOT_EVIDENCE_B2_v1_zh.md`](./methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md) |
+| **SDD-Compliance micro-bench** | `examples/compliance_bench/` · `wizard/compliance-bench.sh` · S1–S4 4/4 |
+
+---
+
+## 变更
+
+- **README** · **ONBOARDING**：v1.0 stable 叙事 · ICVO 审计 · B2 证据
+- **`ontology.yaml`**：`product_semver: "1.0.0"`
+
+---
+
+## 继承自 v0.4.0（仍可用）
+
+- **npx CLI**：`init` · `upgrade` · `check` · `audit` · `task check`
+- **Starter 四帽**：10 / 22 / 30 / 40 · `gate-check` · manifest · S5 git-clean
+- **金样**：[`examples/demo_checkout/`](../examples/demo_checkout/) · P0 10→22→30
+
+---
+
+## 验证
+
+维护者关账前已跑：
+
+- `npm test` — **23/23** pass
+- `bash -n wizard/*.sh wizard/lib/*.sh` — 语法 OK
+- `harness audit` 签前 fail / 签后 pass
+- `harness-sync.sh --index` 生成 JSON 可解析
+- `gate-check.sh --graph --json` 输出模块审核摘要
+
+---
+
+## 已知限制
+
+- **demo 阶段 E**（22 CLOSE 终轮）仍可选 defer
+- **Extended 帽**（00/50/链式 PROMPT）不在 Starter 默认闭包 · 见 `harness/prompts/README`
+- **Track G HGM**：v1.0 后 30 天内书面决策，v2.0+ 另开 Epic
+
+---
+
+## 完整变更日志
+
+[`CHANGELOG.md`](../CHANGELOG.md#100---2026-06-16)
+
+---
+
+## 链接
+
+- **使用手册**：[`docs/USER_GUIDE_v1.0_zh.md`](./USER_GUIDE_v1.0_zh.md)
+- 文档索引：[`docs/README.md`](./README.md)
+- 接入：[`docs/ONBOARDING.md`](./ONBOARDING.md)
+- 路线：[`docs/methodology/ROADMAP_v1_zh.md`](./methodology/ROADMAP_v1_zh.md)
+- 试点证据：[`docs/methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md`](./methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md)

package/docs/RELEASE_v1.0.1.md

@@ -0,0 +1,87 @@
+# Release v1.0.1 · A5 CLI verify（A+C+D）
+
+> **包名**：`@cyning/harness@1.0.1`  
+> **许可**：MIT  
+> **日期**：2026-06-16  
+> **代号**：A5 · CLI verify patch（v1.0.0 → v1.0.1）
+
+---
+
+## 概要
+
+v1.0.0 已能 `npx init/upgrade/audit`，但业务仓若无 clone 路径或 `CYNING_HARNESS` 环境变量，Agent/维护者须手拼路径。v1.0.1 让 **任意业务仓直接跑** `npx @cyning/harness verify` / `gate-check` / `sync index`，通过 `.cyning-harness/local.json` 自动定位产品包根；并新增 Node 仓可选 `--with-scripts` 把 harness 命令写入 `package.json`。
+
+---
+
+## Quick Start
+
+在 **目标业务仓根**：
+
+```bash
+# 首次接入
+npx @cyning/harness@1.0.1 init --preset harness-only --ide cursor,agents --yes
+
+# 30 前验证	npx @cyning/harness verify --target . --task docs/tasks/active/task_xxx.md
+
+# 升级
+npx @cyning/harness@1.0.1 upgrade --target . --yes
+```
+
+Node 仓可选 scripts 路径：
+
+```bash
+npx @cyning/harness@1.0.1 upgrade --target . --yes --with-scripts --pm pnpm
+pnpm install
+pnpm harness:verify --task docs/tasks/active/task_xxx.md
+```
+
+---
+
+## 新增命令
+
+| 命令 | 用途 |
+| --- | --- |
+| `npx @cyning/harness gate-check` | 业务仓人工闸（透传 `wizard/gate-check.sh`） |
+| `npx @cyning/harness verify` | 30 前聚合：gate-check + audit D5 + S5 warn + 可选 `--graph` |
+| `npx @cyning/harness sync index` | 生成 `.cyning-harness/invoke_index.json` |
+| `npx @cyning/harness --version` / `-V` | 显示当前包版本 |
+
+## 新增 flag
+
+| flag | 命令 | 说明 |
+| --- | --- | --- |
+| `--with-scripts` | `init` · `upgrade` | 写入 `devDependencies['@cyning/harness']` 与三 scripts |
+| `--pm pnpm\|npm\|yarn\|auto` | `init` · `upgrade` | 仅用于提示与文档；scripts 值统一调用 `node_modules/.bin/harness` |
+
+---
+
+## 主要变更文件
+
+- `lib/paths.js`：`resolveHarnessRootForTarget`
+- `lib/audit.js`：使用统一根解析
+- `lib/verify.js`：新增
+- `lib/package-scripts.js`：新增
+- `lib/cli.js`：子命令路由 + help/version
+- `wizard/install.sh` · `wizard/upgrade.sh`：写 `QUICKREF.md`
+- `harness/templates/QUICKREF_v1_zh.md`：新增
+- `docs/USER_GUIDE_v1.0_zh.md` · `README.md` · `docs/ONBOARDING.md` · `wizard/README.md`
+- IDE 片段：AGENTS / CLAUDE / Cursor
+
+---
+
+## 非范围
+
+- `.cyning-harness/bin` stub 全套（方案 B）→ backlog
+- 改 compliance-bench S1–S4 语义
+- init 时自动 `pnpm install`
+- 自动写 shell alias（~/.zshrc）
+
+---
+
+## HG-RELEASE
+
+- [ ] git tag `v1.0.1`
+- [ ] npm publish `@cyning/harness@1.0.1`
+- [ ] 可选 GitHub Release v1.0.1
+
+由维护者执行。