@cyning/harness 0.3.2 → 0.4.0

package/CHANGELOG.md

@@ -4,6 +4,27 @@
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-06-15
+
+### Added
+
+- **MIT [`LICENSE`](LICENSE)** · 根目录开源许可
+- **[`ontology.yaml`](ontology.yaml)** · 产品设计本体机器可读草案（对齐 DESIGN_ONTOLOGY v1.2）
+- **[`docs/PUSH_AUDIT_a3_v1.md`](docs/PUSH_AUDIT_a3_v1.md)** · STRATEGY §5.1 push 前审计表
+- **[`docs/ETCLOVG_MAPPING_v1_zh.md`](docs/ETCLOVG_MAPPING_v1_zh.md)** · 行业坐标摘要
+- **D7 [`TEMPLATE_HG_RELEASE_v1_zh.md`](docs/methodology/execution/TEMPLATE_HG_RELEASE_v1_zh.md)** · 维护者 CLOSE 人闸 checklist
+
+### Changed
+
+- **`golden/`** · POINTER 化 · 移除内部 invoke 路径枚举
+- **`examples/oss-fork/README.md`** · 脱敏工作区硬链
+- **README** · 顶部 Quick Start 三行 · MIT public 叙事 · v0.4.0 状态
+
+### Notes
+
+- **GitHub public / npm publish** · 留维护者 **HG-RELEASE** CLOSE（OTP）
+- demo 阶段 E（22 CLOSE 终轮）· 仍可选 · 不阻塞 A3 产品树
+
 ## [0.3.2] - 2026-06-15
 
 ### Added

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cyning
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,11 @@
 # cyning-harness
 
-可 clone、可嵌入业务仓库的 **Harness 纪律包**（无业务代码，无内置 LLM）。
+```bash
+npx @cyning/harness@latest init --preset harness-only --ide cursor,agents
+npx @cyning/harness upgrade && npx @cyning/harness check
+```
+
+可 clone、可嵌入业务仓库的 **Harness 纪律包**（无业务代码，无内置 LLM）· **MIT 开源**。
 
 > **设计哲学**：用 **本体论** 定义「Track / Hat / Gate / Artifact」与 **ICVO 四支柱**（Inform · Constrain · Verify · Orchestrate），把 AI Coding 的上下文、规则与验收变成 **可同步、可审计、不覆盖用户 task** 的仓库真值。  
 > **公众连载** 使用 **ICV 三支柱**（SDD 层）；**Orchestrate** 是对卷三过程编排的 **产品化命名**，见 [`docs/methodology/product/README.md`](docs/methodology/product/README.md) · [`docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md`](docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md)。  
@@ -30,14 +35,7 @@
 
 ## Quick Start（npx · v0.3+）
 
-```bash
-# 新业务仓根（须在目标业务仓执行，勿在本产品仓根目录跑 npx）
-npx @cyning/harness@latest init --preset harness-only --ide cursor,agents
-
-# 日常升级
-npx @cyning/harness upgrade
-npx @cyning/harness check
-```
+> 顶部三行即最小接入。须在 **目标业务仓根** 执行（勿在本产品仓根跑 `npx`，会报 `harness: command not found`）。
 
 **维护者 · 在本仓库根验证 CLI**（npm 不会为「当前包」链接 `bin`，`npx` 会报 `harness: command not found`）：
 
@@ -115,9 +113,9 @@ cyning-harness/
 
 | 项 | 值 |
 |----|-----|
-| 当前 | **v0.2.1** — P0 金样 · 方法论归集 · 本体 v1.2 |
-| 下一档 | **v0.3** — npx CLI · manifest · S5 git-clean |
-| 许可 | 私有；战略见 [`methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md`](docs/methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md) |
+| 当前 | **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) |
 
 ---
 
@@ -127,7 +125,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) |
+| **落地** | [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/docs/ETCLOVG_MAPPING_v1_zh.md

@@ -0,0 +1,65 @@
+# ETCLOVG 映射 · cyning-harness（v1 摘要）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `draft` · A3 首版 public |
+| **版本** | v1.0 |
+| **日期** | 2026-06-15 |
+| **详评** | 工作区 [`ASSESSMENT_cyning_harness_etclovg_industry_v1_zh.md`](https://github.com/Cyning12/cyning-ai-coding-governance)（私有治理仓 POINTER · 公开叙事见 [`ai-coding-closed-loop-articles`](https://github.com/Cyning12/ai-coding-closed-loop-articles)） |
+
+> **定位（对外）**：cyning-harness 是嵌入业务仓的 **SDD 过程纪律包**（Inform / Constrain / Verify 的仓库化落地），**非** Agent Runtime · **非** MCP 宿主全栈。
+
+---
+
+## 1. ETCLOVG 覆盖快照
+
+| 维度 | 覆盖 | cyning-harness 落点 |
+| --- | --- | --- |
+| **E** Execution | 低（外置） | 用户 IDE / Agent 基座 · 本产品不含 LLM 调用 |
+| **T** Tooling | 中 | `wizard/` · `gate-check.sh` · npx CLI |
+| **C** Context | 高 | `graph/` · `coding_wiki/` · `standards/` |
+| **L** Lifecycle | 高 | SDD 帽链 · `HumanGate` · task 状态机 |
+| **O** Observability | 低–中 | invoke · reviews 文档追溯 · 无运行时遥测 |
+| **V** Verification | 中–高 | CI 样例 · `test_strategy` · gate-check |
+| **G** Governance | 高 | 规范轨 · 22 审查 · S2 不覆盖业务 task |
+
+**综合（行业对照）**：约 **3.6 / 5** · 与 ETCLOVG 全栈 Harness **互补而非竞争**。
+
+---
+
+## 2. ICVO 四支柱（产品叙事）
+
+| 支柱 | 产品映射 |
+| --- | --- |
+| **Inform** | GraphTrack + WikiTrack → `_tech_graph` · `coding_wiki` |
+| **Constrain** | StandardsTrack + IDETrack → `standards/` · `.cursor/rules` |
+| **Verify** | VerifyTrack → `ci/` · `gate-check` · `test_strategy` |
+| **Orchestrate** | ProcessTrack · Epic/00 帽（Extended · 工作区 POINTER） |
+
+公众稿使用 **ICV 三支柱**；Orchestrate 为产品化命名 · 见 [`methodology/product/README.md`](./methodology/product/README.md)。
+
+---
+
+## 3. 与 MCP / 国标
+
+| 参照 | 关系 |
+| --- | --- |
+| **MCP** | 不替代；v1.0 后可预留只读 ctx（C1 · 后置） |
+| **信通院 / AIIA** | SDD + 人工闸 + 可追溯制品 · 对齐「构建与开发 / 可靠性」方向 |
+| **LangChain 等** | 纪律层 vs 编排 SDK · 见 DESIGN_ONTOLOGY §7.5 |
+
+---
+
+## 4. v1.0 增量（Q4 stable · 非 A3 阻塞）
+
+- B2 量化段落写入 README
+- `harness ontology-check` CLI
+- ETCLOVG 映射页扩展为完整对照表
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+| --- | --- |
+| 2026-06-15 | A3 首版摘要 · 详评 POINTER 治理仓 |

package/docs/PUSH_AUDIT_a3_v1.md

@@ -0,0 +1,52 @@
+# Push 前审计 · A3 v0.4.0（§5.1）
+
+| 项 | 值 |
+| --- | --- |
+| **日期** | 2026-06-15 |
+| **执行** | 30 A3 Agent |
+| **分支** | `task/cyning-harness-a3-push` |
+| **基准** | STRATEGY_ONTOLOGY §5.1 · ROADMAP §2.1 A3 |
+
+---
+
+## §5.1 清单
+
+| # | 检查项 | 结果 | 动作 / 证据 |
+| --- | --- | --- | --- |
+| 1 | **密钥 / 令牌** | ✅ pass | `rg -i 'API_KEY\|password\|git@\|token\|secret'` 无真实泄露 · 仅文档占位 |
+| 2 | **内部路径** | ✅ pass | 无 `/Users/cyning/` · `kimi-code-meta` 绝对路径 · `golden/` 已 POINTER 化 |
+| 3 | **私有 POINTER** | ✅ pass | `golden/` 仅摘要 + 公开 PR 链 · 无 invoke 全文 |
+| 4 | **试点脱敏** | ✅ pass | `examples/oss-fork/` 无凭据 · 工作区路径改通用表述 |
+| 5 | **工作区耦合** | ✅ pass | README 无私有 workspace 硬链 · STRATEGY 为 POINTER |
+| 6 | **License** | ✅ pass | 根目录 [`LICENSE`](../LICENSE) MIT |
+| 7 | **npm 包名** | ✅ pass | `package.json` → `@cyning/harness` |
+| 8 | **安装自测** | ✅ pass | 空目录 `node bin/harness.js init --yes` · manifest 写入（见 30 invoke） |
+
+---
+
+## 复检命令（维护者 CLOSE 前复跑）
+
+```bash
+cd cyning-harness
+npm test
+rg -n '/Users/cyning|kimi-code-meta|cyning-ink-workspace|Desktop/Projects' . \
+  --glob '!node_modules' --glob '!_sandbox' --glob '!.git'
+npm pack --dry-run | head -30
+```
+
+---
+
+## 不进 public 树（§5.3 确认）
+
+- 工作区 `docs/harness/prompts` 全量帽
+- invoke/review 正文 bulk
+- `examples/demo_checkout/_sandbox/`（`.gitignore` + npm files 排除）
+- 维护者个人 fork 元数据
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+| --- | --- |
+| 2026-06-15 | A3 30 首版审计表 |

package/docs/RELEASE_v0.4.0.md

@@ -0,0 +1,89 @@
+# Release v0.4.0 · 首版 public push 准备（A3）
+
+> **包名**：`@cyning/harness@0.4.0`  
+> **许可**：MIT  
+> **日期**：2026-06-15  
+> **代号**：A3 · PublicBeta 产品树（纪律包 · 无业务代码 · 无 LLM Runtime）
+
+---
+
+## 概要
+
+本版本为 **首版开源 public push 的产品树**：完成 push 前审计与脱敏、MIT 许可、对外金样 POINTER 化，并补齐本体机器可读草案与发布人闸模板。
+
+**定位**：嵌入任意业务仓的 **SDD 过程纪律包**（Inform / Constrain / Verify 仓库化落地），与 Agent Runtime / MCP 宿主 **互补而非竞争**。详见 [`docs/ETCLOVG_MAPPING_v1_zh.md`](./ETCLOVG_MAPPING_v1_zh.md)。
+
+---
+
+## Quick Start
+
+在 **目标业务仓根**（非本产品仓根）：
+
+```bash
+npx @cyning/harness@0.4.0 init --preset harness-only --ide cursor,agents
+npx @cyning/harness upgrade
+npx @cyning/harness check
+```
+
+---
+
+## 新增
+
+| 项 | 说明 |
+| --- | --- |
+| **MIT LICENSE** | 根目录 [`LICENSE`](../LICENSE) |
+| **`ontology.yaml`** | 产品设计本体机器可读草案 · 对齐 DESIGN_ONTOLOGY v1.2 |
+| **Push 审计表** | [`docs/PUSH_AUDIT_a3_v1.md`](./PUSH_AUDIT_a3_v1.md) · STRATEGY §5.1 八项 |
+| **ETCLOVG 映射** | [`docs/ETCLOVG_MAPPING_v1_zh.md`](./ETCLOVG_MAPPING_v1_zh.md) |
+| **HG-RELEASE 模板** | [`docs/methodology/execution/TEMPLATE_HG_RELEASE_v1_zh.md`](./methodology/execution/TEMPLATE_HG_RELEASE_v1_zh.md) |
+
+---
+
+## 变更
+
+- **README**：顶部 Quick Start 三行 · MIT public 叙事 · v0.4.0 状态
+- **`golden/`**：POINTER 化 · 保留公开 PR 证据 · 移除内部 invoke 路径枚举
+- **`examples/oss-fork/`** · **`standards/`** · **`harness/prompts/README`**：脱敏私有工作区硬链
+
+---
+
+## 继承自 v0.3.x（仍可用）
+
+- **npx CLI**：`init` · `upgrade` · `check` · `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` — **14/14** pass
+- 空目录 init — `manifest.version: 0.4.0`
+- `npm pack --dry-run` — 含 LICENSE / ontology · 无 `_sandbox`
+- §5.1 路径/密钥 grep — 无泄露
+
+复跑见 [`PUSH_AUDIT_a3_v1.md`](./PUSH_AUDIT_a3_v1.md) §复检命令。
+
+---
+
+## 已知限制
+
+- **demo 阶段 E**（22 CLOSE 终轮）仍可选 defer
+- **Extended 帽**（00/50/链式 PROMPT）不在 Starter 默认闭包 · 见 `harness/prompts/README`
+- **v1.0 stable**（A4）：ICVO audit CLI · B2 量化进 README — 见 ROADMAP
+
+---
+
+## 完整变更日志
+
+[`CHANGELOG.md`](../CHANGELOG.md#040---2026-06-15)
+
+---
+
+## 链接
+
+- 文档索引：[`docs/README.md`](./README.md)
+- 接入：[`docs/ONBOARDING.md`](./ONBOARDING.md)
+- 路线：[`docs/methodology/ROADMAP_v1_zh.md`](./methodology/ROADMAP_v1_zh.md)

package/docs/methodology/execution/TEMPLATE_HG_RELEASE_v1_zh.md

@@ -0,0 +1,57 @@
+# HumanGate · HG-RELEASE（首版 public push 人闸）
+
+> **用途**：维护者 **CLOSE 棒** 执行 GitHub public · npm publish · Release 前逐项勾选。  
+> **非 Agent 代签** · 须 OTP / 维护者账号操作。
+
+---
+
+## 元信息
+
+| 字段 | 值 |
+| --- | --- |
+| **gate_id** | `HG-RELEASE` |
+| **blocks** | public visibility · npm publish · GitHub Release |
+| **关联** | STRATEGY §5.2 · [`PUSH_AUDIT_a3_v1.md`](../../PUSH_AUDIT_a3_v1.md) |
+
+---
+
+## 前置（须全绿）
+
+- [ ] `npm test` **14/14** 绿（产品仓根）
+- [ ] [`PUSH_AUDIT_a3_v1.md`](../../PUSH_AUDIT_a3_v1.md) §5.1 **八项全 pass**
+- [ ] 空目录 `npx @cyning/harness@<version> init --yes` 成功（**非**产品仓根）
+- [ ] `npm pack --dry-run` 无 `_sandbox` / `.env` / 密钥泄露
+- [ ] `HG-AUDIT-R1` + A3 30 invoke 已落盘
+
+---
+
+## 发布序列（建议顺序）
+
+1. [ ] 本地 `package.json` version 与计划 tag 一致（如 `0.4.0`）
+2. [ ] `git tag v0.4.0` · `git push origin v0.4.0`
+3. [ ] GitHub → Settings → Change visibility → **Public**
+4. [ ] Description / Topics：`harness-engineering` · `sdd` · `agent` · `cursor`
+5. [ ] `gh release create v0.4.0` · 附 Release notes（CHANGELOG 摘录）
+6. [ ] `npm publish --access public`（OTP）
+7. [ ] README Quick Start 链 immutability Release URL
+8. [ ] （可选）对外短文 · **链 repo** · 非工作区 harness 理论全文
+
+---
+
+## 回滚备忘
+
+| 场景 | 动作 |
+| --- | --- |
+| npm 误发错误版本 | `npm deprecate @cyning/harness@x.y.z` · 勿 unpublish 已消费版本 |
+| 泄露发现 post-push | 立即 private · rotate 密钥 · `git filter-repo` 若必要 |
+
+---
+
+## 签收
+
+| 项 | 值 |
+| --- | --- |
+| **维护者** | _______________ |
+| **日期** | _______________ |
+| **tag** | _______________ |
+| **npm** | `@cyning/harness@_______________` |

package/examples/demo_checkout/ACCEPTANCE.md

@@ -56,7 +56,9 @@ CYNING_HARNESS=/path/to/cyning-harness \
 
 ---
 
-## 阶段 E · 22 CLOSE（可选 · P0 完整闭环）
+## 阶段 E · 22 CLOSE（可选 · **defer A3**）
+
+> **A2 关账不阻塞**。完整 SDD 链 `10→22→30→40→22(CLOSE)` 的 **最后一棒 22 终轮** 在 **A3 对外金样** 时执行。
 
 - [ ] 22 终轮 · 产出 `*_audit_CLOSE_*.md` 或 R2
 - [ ] task status → `done`
@@ -64,11 +66,22 @@ CYNING_HARNESS=/path/to/cyning-harness \
 
 ---
 
+## 阶段 F · 40 自检帽（A2 · 2026-06-15 ✅）
+
+> **已在 `_sandbox` 阶段 2 完成** · commits `769964c` + `7d5b375` · **无需再开 Agent**，仅需本清单勾选留档。
+
+- [x] sync 后存在 `docs/harness/prompts/40-self-check.md`
+- [x] `@` task + 40-self-check.md · 跑验证命令
+- [x] task 回填 `### 自检结论（执行者）`
+- [x] sidecar `task check` schema OK（产品仓路径 · 阶段 1）
+- [x] gate-check 输出 manifest.version（upgrade 后 · `7d5b375`）
+
+---
+
 ## P0 通过标准（最小）
 
 满足 **A + B + C（签后）+ D** 即 P0 通过。  
-**2026-06-15**：`_sandbox` **最小通过 ✅**  
-**E** 为完整 SDD 闭环，可与 A2（40 帽）一并补全。
+**2026-06-15**：`_sandbox` **A–D 最小通过 ✅** · **F（40 帽）✅** · **E defer A3**
 
 ---
 

package/examples/oss-fork/README.md

@@ -91,11 +91,10 @@ git checkout -B cyning/meta   # 或已有 meta
 
 ---
 
-## 5. 试点文档（工作区）
+## 5. 试点文档（维护者 · 可选）
 
-工作区维护者扫描分级示例：  
-`Projects/docs/harness/guides/ISSUE_SCAN_kimi_code_open_c2_v1_zh.md` ·  
-`PILOT_kimi_code_fork_adoption_v1_zh.md`
+上游 Issue 扫描与 fork 采纳指南见 **Cyning12 治理文档**（公开叙事仓 / 维护者私有工作区 POINTER）。  
+本产品仅提供通用 `scan-upstream-issues.sh` 与 [`wizard/profiles/issue-scan-presets.json`](../../wizard/profiles/issue-scan-presets.json)。
 
 ---
 

package/golden/POINTER_gold_epic_serial.md

@@ -3,65 +3,34 @@
 | 项 | 内容 |
 | --- | --- |
 | **状态** | `active` |
-| **日期** | 2026-06-09 |
+| **日期** | 2026-06-15（A3 脱敏） |
 | **freeze_id** | `freeze_epic_orchestration_pilot_v1` |
-| **性质** | **只读指针**；金样真值在 Ink 私有工作区，本产品 **不复制** 业务代码或 invoke 全文 |
+| **性质** | **只读摘要** · 详细 invoke 链在业务仓 · 本产品 **不复制** |
 
 ---
 
 ## 金样是什么
 
-**M1 已签收** 的前端 Epic 串行编排试点：Epic 总纲 + 00 编排 + **M01→M02→M03** 子 task 链 + invoke 落盘 + CI 绿 + PR merge。
+**M1 已签收** 的前端 Epic 串行编排试点：Epic 总纲 + 00 编排 + **M01→M03** 子 task 链 + invoke 落盘 + CI 绿 + PR merge。
 
 | 维度 | 值 |
 |------|-----|
-| **编排模式** | 单分支串行 · `Cursor Task 链` · `semi_auto: false` |
-| **子仓** | `ai-ink-brain/`（前端 Ink） |
+| **编排模式** | 单分支串行 · `semi_auto: false` |
 | **Epic slug** | `tech-debt-code-quality-frontend` |
-| **分支（已 merge）** | `task/tech-debt-code-quality-frontend` |
 | **人签** | `HG-M1-SIGNOFF` approved（2026-06-09） |
 
 ---
 
-## 证据路径（Ink 私有工作区 · 只读）
-
-> 本地常名 `Projects/`（cyning-ink-workspace）。无访问权限时仅用本产品 `harness/templates/TASK_epic.md` 作结构对照。
-
-### 工作区 · M1 跟踪 task
-
-| 资产 | 路径 |
-|------|------|
-| M1 签收单 | `docs/harness/tasks/done/task_harness_m1_epic_orchestration_frontend_pilot_v1.md` |
-| Epic 编排 GUIDANCE | `docs/harness/guides/GUIDANCE_epic_orchestration_task_chain_v1_zh.md` |
-| PLAN §6 M1 行 | `docs/harness/guides/PLAN_self_hosted_runtime_mvp_phases_v1_zh.md` |
-
-### 前端子仓 · Epic 与 invoke
-
-| 资产 | 路径 |
-|------|------|
-| Epic 总纲（done） | `ai-ink-brain/docs/tasks/done/task_tech_debt_code_quality_frontend_epic_v1.md` |
-| **invoke 索引目录** | `ai-ink-brain/docs/harness/invokes/by-task/tech-debt-code-quality-frontend/` |
-| 关账 invoke | `…/invoke_20260609_CLOSE_epic.md` |
-| 00 编排 | `…/invoke_20260609_00_orchestrator.md` |
-
-### M1 签收子集（串行棒）
-
-| 棒 | 子 task（done） | 典型 invoke |
-|----|-----------------|-------------|
-| 00 | 编排派发 M01 | `invoke_20260609_00_orchestrator.md` |
-| M01 | `task_tech_debt_cq_frontend_m01_py_proxy_v1.md` | `invoke_20260609_40_m01_py_proxy.md` |
-| M02 | `task_tech_debt_cq_frontend_m02_bff_routes_v1.md` | `invoke_20260609_40_m02_bff_routes.md` |
-| M03 | `task_tech_debt_cq_frontend_m03_unified_chat_v1.md` | `invoke_20260609_40_m03_unified_chat.md` |
-
-M04～M06 为编码 Epic 延续（已关账），**不阻塞** M1 签收。
-
-### 外部链接
+## 公开证据（可独立验证）
 
 | 项 | URL |
 |----|-----|
 | PR → production | https://github.com/Cyning12/ai-ink-brain/pull/64 |
 | PR → main | https://github.com/Cyning12/ai-ink-brain/pull/65 |
 
+有权限时可在 **Cyning12/ai-ink-brain** 对照 `docs/harness/invokes/by-task/tech-debt-code-quality-frontend/`。  
+无权限时仅用本产品模板演练。
+
 ---
 
 ## 与本产品（cyning-harness）的关系
@@ -71,18 +40,9 @@ M04～M06 为编码 Epic 延续（已关账），**不阻塞** M1 签收。
 | [`harness/templates/TASK_epic.md`](../harness/templates/TASK_epic.md) | Epic 编排主表 §3.1 |
 | [`harness/templates/TASK_TEMPLATE.md`](../harness/templates/TASK_TEMPLATE.md) | 各 sub-task 结构 |
 | [`harness/invokes/TEMPLATE_invoke.md`](../harness/invokes/TEMPLATE_invoke.md) | invoke 快照格式 |
-| M2 本仓执行 invoke | 工作区 `docs/harness/invokes/by-task/cyning-harness-v0-1/`（**不**复制进产品仓） |
-
-**纪律**：clone `cyning-harness` 的用户 **打开金样** = 有权限时读上述 Ink 路径；否则按模板 + 本 POINTER 摘要演练。
-
----
-
-## 后端编码 Epic（可选对照 · 非 M1 别名）
+| [`examples/demo_checkout/`](../examples/demo_checkout/) | **A3 对外金样** · P0 10→22→30 |
 
-| 项 | 路径 |
-|----|------|
-| CC W2～W8 Manifest | `ai-ink-brain-api-python/docs/tasks/active/task_standards_backend_api_modularization_manifest_v1.md` |
-| 说明 | 形态类似 Epic+PR，**≠** PLAN M1 编排试点；可作 M2 扩展金样来源 |
+**纪律**：clone `cyning-harness` 的用户 **打开金样** = 读公开 PR + 本 POINTER + `demo_checkout`；勿期望 invoke 全文在产品包内。
 
 ---
 
@@ -91,3 +51,4 @@ M04～M06 为编码 Epic 延续（已关账），**不阻塞** M1 签收。
 | 日期 | 说明 |
 |------|------|
 | 2026-06-09 | M2 T6：M1 串行 Epic 金样 POINTER 首版 |
+| 2026-06-15 | A3 public push：移除内部工作区路径与 invoke 文件枚举 |

package/golden/README.md

@@ -1,25 +1,24 @@
 # golden · 金样 pointer
 
-本目录仅存放 **外部金样链接说明**（invoke 链、验收口径摘要），**不复制**任何业务代码。
+本目录仅存放 **外部金样链接说明**（验收口径摘要），**不复制**任何业务代码或 invoke 全文。
 
 ## v0.1 已交付（T6 · M2）
 
 | 文件 | 状态 | 说明 |
 |------|------|------|
-| [`POINTER_gold_epic_serial.md`](./POINTER_gold_epic_serial.md) | ✅ | M1 串行 Epic 金样 · invoke 链索引 · PR 证据 |
+| [`POINTER_gold_epic_serial.md`](./POINTER_gold_epic_serial.md) | ✅ | M1 串行 Epic 金样 · 公开 PR 证据 · 结构对照 |
 
 ## 金样摘要
 
 | 项 | 值 |
 |----|-----|
 | **freeze_id** | `freeze_epic_orchestration_pilot_v1` |
-| **Epic slug** | `tech-debt-code-quality-frontend` |
-| **invoke 目录** | `ai-ink-brain/docs/harness/invokes/by-task/tech-debt-code-quality-frontend/` |
-| **M1 跟踪** | 工作区 `docs/harness/tasks/done/task_harness_m1_epic_orchestration_frontend_pilot_v1.md` |
+| **编排模式** | 单分支串行 · Epic + sub-task 链 |
+| **公开证据** | [ai-ink-brain PR #64](https://github.com/Cyning12/ai-ink-brain/pull/64) · [#65](https://github.com/Cyning12/ai-ink-brain/pull/65) |
 
 ## 使用
 
-1. 读本目录 POINTER → 有权限时钻取 Ink 路径对照  
+1. 读本目录 POINTER 摘要  
 2. 无私有工作区：用 [`harness/templates/TASK_epic.md`](../harness/templates/TASK_epic.md) 结构演练  
 3. **禁止** 将金样 invoke 全文或业务代码复制进产品仓分发包
 
@@ -28,3 +27,4 @@
 | 日期 | 说明 |
 |------|------|
 | 2026-06-09 | T6 M2 首版 POINTER |
+| 2026-06-15 | A3 脱敏 · 移除内部 invoke 路径明细 |

package/harness/prompts/README.md

@@ -16,16 +16,16 @@
 
 ## 完整库（POINTER · 不复制全文）
 
-Ink 工作区维护完整帽子链：`docs/harness/prompts/`（00/20/40/50、TEMPLATE-*-invoke、PROMPT_*_chain_*）。
+Extended 帽（00/20/40/50、链式 PROMPT）由维护者在 **私有工作区或签约伙伴仓** 维护 · **不**默认复制进用户仓。
 
-嵌入用户仓后可在 README 追加：
+嵌入用户仓后可在 README 追加（示例）：
 
 ```markdown
 ## 完整 Harness 库
-- 上游：Cyning12/cyning-ink-workspace `docs/harness/prompts/`（只读对照）
+- 上游：你的组织/monorepo `docs/harness/prompts/`（只读对照 · 非 Starter 默认）
 ```
 
 ## 链式执行
 
-- 串行 Task 链：工作区 `PROMPT_cursor_task_chain_serial_v1.md`（M3 `harness ctx` 前手工 `@` 引用）
+- 串行 Task 链：维护者工作区链式 PROMPT（M3 `harness ctx` 前手工 `@` 引用）
 - 每帽 invoke：[`../invokes/TEMPLATE_invoke.md`](../invokes/TEMPLATE_invoke.md)

package/ontology.yaml

@@ -0,0 +1,93 @@
+# cyning-harness 产品设计本体 · 机器可读抽取（草案 v0.4.0）
+# 人类真值：docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md
+# 冲突时以 Markdown 为准 · 供未来 harness ontology-check 使用
+
+version: "1.2"
+product_semver: "0.4.0"
+license: MIT
+
+classes:
+  - id: Track
+    domain: Package
+    subclasses: [GraphTrack, WikiTrack, StandardsTrack, ProcessTrack, VerifyTrack, IDETrack]
+  - id: Template
+    domain: Package
+  - id: Preset
+    domain: Package
+  - id: WizardTool
+    domain: Package
+  - id: IDEFragment
+    domain: Package
+  - id: AdoptedProfile
+    domain: Instance
+  - id: VersionManifest
+    domain: Instance
+  - id: Task
+    domain: Instance
+  - id: Hat
+    domain: Instance
+  - id: HumanGate
+    domain: Instance
+  - id: InvokeSnapshot
+    domain: Instance
+  - id: AuditReview
+    domain: Instance
+  - id: InformArtifact
+    domain: Instance
+  - id: ConstrainArtifact
+    domain: Instance
+  - id: VerifyArtifact
+    domain: Instance
+
+relations:
+  - id: embedsInto
+    subject: DisciplinePackage
+    object: BusinessRepository
+    cardinality: "1..*"
+  - id: blocks
+    subject: HumanGate
+    object: Hat
+    cardinality: "1..*"
+  - id: governedBy
+    subject: Task
+    object: Hat
+    cardinality: "1..*"
+  - id: produces
+    subject: Hat
+    object: TraceArtifact
+    cardinality: "0..*"
+
+axioms:
+  - id: P1
+    text: "纪律包不含业务代码与 LLM Runtime"
+  - id: S2
+    text: "禁止 sync 覆盖 docs/tasks、reviews、invokes/by-task"
+  - id: S5
+    text: "harness-sync apply 前须 git-clean（可 --force 跳过）"
+  - id: D2
+    text: "HG-AUDIT-R1 pending 时 22 不得附 30 Prompt"
+  - id: D7
+    text: "public push 须 HG-RELEASE 人闸 checklist 全勾"
+
+starter_hats:
+  - hat_id: "10-requirements"
+    role: RequirementsHat
+  - hat_id: "22-task-audit"
+    role: TaskAuditHat
+  - hat_id: "30-execute-code"
+    role: ExecuteHat
+  - hat_id: "40-self-check"
+    role: SelfCheckHat
+
+human_gates:
+  - id: HG-TASK-DRAFT
+    blocks_hats: ["22-task-audit", "30-execute-code"]
+  - id: HG-AUDIT-R1
+    blocks_hats: ["30-execute-code"]
+  - id: HG-RELEASE
+    blocks_hats: []
+    note: "维护者 CLOSE · npm/GitHub public · 非 Agent 自动签"
+
+schemas:
+  manifest: "./schema/manifest.v1.schema.json"
+  task_sidecar: "./schema/task.harness.v1.schema.json"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyning/harness",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "cyning-harness discipline package · init / upgrade / check CLI",
   "license": "MIT",
   "type": "module",
@@ -26,6 +26,8 @@
     "docs/",
     "README.md",
     "CHANGELOG.md",
+    "LICENSE",
+    "ontology.yaml",
     "AGENTS.md"
   ],
   "scripts": {

package/standards/POINTER_workspace_truth_v1_zh.md

@@ -1,10 +1,10 @@
-# POINTER · 工作区编码规范真值（Ink · 不复制全文）
+# POINTER · 工作区编码规范真值（示例 · 不复制全文）
 
 | 项 | 内容 |
 | --- | --- |
 | **状态** | `active` |
-| **日期** | 2026-06-09 |
-| **性质** | **只读指针**；Starter 交付 TEMPLATE，Ink 维护 L1/L2 **active** 条文 |
+| **日期** | 2026-06-15（A3 脱敏） |
+| **性质** | **只读指针**；Starter 交付 TEMPLATE，各业务仓维护 L1/L2 **active** 条文 |
 
 ---
 
@@ -12,42 +12,26 @@
 
 | 规则 | 说明 |
 | --- | --- |
-| **禁止双维护** | 不得将 Ink `docs/standards/` L1/L2 **全文**复制进 `cyning-harness` 产品仓 |
-| **嵌入用户仓** | 从本目录 **TEMPLATE_*** 复制生成用户仓 `docs/standards/`；按需 **POINTER** 回链 Ink |
+| **禁止双维护** | 不得将某业务仓 `docs/standards/` L1/L2 **全文**复制进 `cyning-harness` 产品仓 |
+| **嵌入用户仓** | 从本目录 **TEMPLATE_*** 复制生成用户仓 `docs/standards/`；按需 **POINTER** 回链源仓 |
 | **冲突** | task + 图谱 + PROJECT_CONFIG > 用户仓已嵌入 L1/L2 > 本 POINTER |
 
 ---
 
-## Ink 工作区真值（金样 · 只读）
+## 使用方式
 
-> 路径相对 **cyning-ink-workspace**（本地常名 `Projects/`）。无访问权限时仅用本仓 TEMPLATE。
-
-| 资产 | 路径 | 状态 |
-| --- | --- | --- |
-| **L1 基线** | `docs/standards/CODING_BASELINE_L1_v1_zh.md` | `active` · R1 2026-06-09 |
-| **L2 前端** | `ai-ink-brain/docs/standards/CODING_FRONTEND_L2_v1_zh.md` | `active` |
-| **L2 后端** | `ai-ink-brain-api-python/docs/standards/CODING_BACKEND_L2_v1_zh.md` | `active` |
-| **外部参考** | `docs/standards/SOURCES_编码规范外部参考_v1_zh.md` | `draft` |
-| **改进大纲** | `docs/standards/00_OUTLINE_工程编码规范改进_v1_zh.md` | 规划 |
-| **Harness 衔接** | `docs/harness/guides/GUIDANCE_standards_in_harness_starter_m2_v1_zh.md` | M2 打包真值 |
+1. **默认**：仅用本目录 [`TEMPLATE_CODING_BASELINE_L1_v1_zh.md`](TEMPLATE_CODING_BASELINE_L1_v1_zh.md) 等模板  
+2. **有上游规范仓时**：在用户仓 README 追加 POINTER 链（GitHub 路径 · 非本地绝对路径）  
+3. **禁止** 将私有工作区 invoke / task 正文 bulk 复制进产品包
 
 ---
 
-## 治理仓（可选 · 私有）
+## 治理仓（可选 · 公开）
 
 | 仓 | 用途 |
 | --- | --- |
 | [`cyning-ai-coding-governance`](https://github.com/Cyning12/cyning-ai-coding-governance) | 方法论 · L3/L2/L1 整合导读 · 对比研究 |
 
-本地镜像（若有）：`Projects/ai_coding_governance/methodology/`
-
----
-
-## M2 金样来源（后续 T6）
-
-- 编码规范 Epic：`ai-ink-brain-api-python/docs/tasks/active/task_standards_backend_api_modularization_manifest_v1.md`
-- 过程 invoke：工作区 `docs/harness/invokes/by-task/`（**不**复制进产品仓）
-
 ---
 
 ## 修订记录
@@ -55,3 +39,4 @@
 | 日期 | 说明 |
 | --- | --- |
 | 2026-06-09 | M2 T2：TEMPLATE + POINTER 首版 |
+| 2026-06-15 | A3 public push：移除私有工作区路径与 Ink 内部 task 枚举 |