@cyning/harness 0.4.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +42 -0
- package/README.md +65 -11
- package/bin/harness.js +1 -1
- package/docs/ARCHITECTURE.md +1 -1
- package/docs/BENCHMARK_REPORT_TEMPLATE.md +135 -0
- package/docs/ONBOARDING.md +32 -0
- package/docs/README.md +2 -2
- package/docs/RELEASE_v1.0.0.md +91 -0
- package/docs/RELEASE_v1.0.1.md +87 -0
- package/docs/ROADMAP_TO_AGENT_GOVERNANCE.md +209 -0
- package/docs/USER_GUIDE_v1.0_zh.md +284 -0
- package/docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md +5 -3
- package/docs/methodology/README.md +7 -6
- package/docs/methodology/ROADMAP_v1_zh.md +45 -12
- package/docs/methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md +45 -37
- package/docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md +25 -23
- package/docs/methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md +2 -2
- package/docs/methodology/graph/HGM_UPGRADE_OUTLINE_v1_zh.md +248 -0
- package/docs/methodology/graph/README.md +2 -2
- package/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md +2 -2
- package/docs/methodology/prompts/PROMPT_article_theory_roundtable_v1_zh.md +3 -3
- package/docs/methodology/prompts/PROMPT_doc_consistency_audit_v1_zh.md +4 -4
- package/examples/compliance_bench/README.md +81 -0
- package/examples/compliance_bench/S1_r1_pending/task.md +30 -0
- package/examples/compliance_bench/S2_r1_no_review/task.md +31 -0
- package/examples/compliance_bench/S3_r1_with_review/reviews/s3_r1_with_review_audit_R1_20260616.md +18 -0
- package/examples/compliance_bench/S3_r1_with_review/task.md +31 -0
- package/examples/compliance_bench/S4_sync_domain/profile.json +16 -0
- package/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md +1 -1
- package/harness/templates/QUICKREF_v1_zh.md +47 -0
- package/ide/adapters/AGENTS.md.fragment.example +1 -0
- package/ide/adapters/CLAUDE.md.fragment.example +1 -0
- package/ide/adapters/cursor-harness-starter.mdc.example +1 -0
- package/lib/audit.js +166 -0
- package/lib/cli.js +245 -5
- package/lib/package-scripts.js +65 -0
- package/lib/paths.js +27 -0
- package/lib/verify.js +103 -0
- package/ontology.yaml +2 -2
- package/package.json +1 -1
- package/schema/invoke_index.v1.schema.json +53 -0
- package/wizard/README.md +4 -0
- package/wizard/compliance-bench.sh +251 -0
- package/wizard/gate-check.sh +139 -19
- package/wizard/harness-sync.sh +16 -3
- package/wizard/install.sh +5 -3
- package/wizard/lib/generate-invoke-index.js +60 -0
- package/wizard/upgrade.sh +7 -2
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
| 项 | 内容 |
|
|
4
4
|
| --- | --- |
|
|
5
5
|
| **状态** | `active` |
|
|
6
|
-
| **版本** | v1.
|
|
6
|
+
| **版本** | v1.4 |
|
|
7
7
|
| **日期** | 2026-06-15 |
|
|
8
8
|
| **性质** | **L2 产品路线真值** · 吸收本体 v1.2 + HGM + P0 后修订 |
|
|
9
9
|
| **L1 对齐** | 工作区 [`STRATEGY_MASTER`](./pointers/STRATEGY_MASTER_v1_zh.md) Track A/B/C/D · **冲突时本文件管产品 semver 与能力边界** |
|
|
10
10
|
|
|
11
|
-
> **2026-06-15 结论**:OOP / 本体 / 图论 / History 融合 **不推翻** v0.2→v1.0
|
|
11
|
+
> **2026-06-15 结论**:OOP / 本体 / 图论 / History 融合 **不推翻** v0.2→v1.0 主轨;**Track G(HGM)** 在 **v1.0 关账后** 以 **v2.x** semver 推进(G1→v2.0+ · G2→v2.1+)· **不阻塞** A1 npx 与 Q3 push。
|
|
12
|
+
> **SEM-02**:废止用 **v0.5/v0.6** 标注 HGM(易误读为 v0.4 与 v1.0 之间的主轨版本)。
|
|
12
13
|
|
|
13
14
|
---
|
|
14
15
|
|
|
@@ -18,8 +19,8 @@
|
|
|
18
19
|
| --- | --- | --- |
|
|
19
20
|
| **OOP** | wizard 脚本 · bash/TS 实现 · Task/Hat 作「类」的 runtime 投影 | 现在 |
|
|
20
21
|
| **本体** | `product/DESIGN_ONTOLOGY` · P/S/D 公理 · ICVO 四支柱 | v1.2 已文档化 |
|
|
21
|
-
| **图论(过程)** | HGM:显式边 · 遍历 · 模式查询 | **
|
|
22
|
-
| **History** | append-only 事件 · gate/task 状态变迁 | **
|
|
22
|
+
| **图论(过程)** | HGM:显式边 · 遍历 · 模式查询 | **v2.0+**(Track G · v1.0 后) |
|
|
23
|
+
| **History** | append-only 事件 · gate/task 状态变迁 | **v2.0+**(Track G · v1.0 后) |
|
|
23
24
|
| **图论(Inform)** | `docs/_tech_graph/` · `gate-check --graph` | v1.0 |
|
|
24
25
|
|
|
25
26
|
```text
|
|
@@ -31,7 +32,17 @@
|
|
|
31
32
|
|
|
32
33
|
## 2. 版本里程碑(产品 semver)
|
|
33
34
|
|
|
34
|
-
|
|
35
|
+
### 2.0 Semver 命名纪律(SEM-02 · 2026-06-15)
|
|
36
|
+
|
|
37
|
+
| 轨道 | 版本序列 | 说明 |
|
|
38
|
+
| --- | --- | --- |
|
|
39
|
+
| **Track A · 主轨** | **v0.2 → v0.3 → v0.4 → v1.0** | `@cyning/harness` npm · A1–A4 · **当前已到 v0.4** |
|
|
40
|
+
| **Track G · HGM** | **v2.0+(G1)→ v2.1+(G2)→ …** | **仅 v1.0 关账后** 启动 · 主版本 **2** 表示「公理稳定后的增强线」 |
|
|
41
|
+
| **废止** | ~~v0.5 / v0.6~~ 作 HGM 号 | 数字像插在 v0.4 与 v1.0 之间 · 已全部改 **v2.x** |
|
|
42
|
+
|
|
43
|
+
对外一句:**主轨到 v1.0 · HGM 从 v2.0 起 · 不写「产品 v0.5」指 HGM。**
|
|
44
|
+
|
|
45
|
+
> **对外表述(semver 纪律)**:主产品按 **§2.0 主轨** 推进。**Track G** 能力标签 **G1 / v2.0+**(见 §2.2),**启动闸门在 v1.0 之后**(§5);**不是**主轨下一档 semver,也 **不阻塞** public push。对外请写 **「Track G 提案 · v2.x」**,避免 **「即将发布 v0.5」** 或 **「v0.5 在 v1.0 前」**。
|
|
35
46
|
|
|
36
47
|
### 2.1 主轨(A · 产品包)
|
|
37
48
|
|
|
@@ -41,14 +52,14 @@
|
|
|
41
52
|
| **v0.3.0** | **A1 分发** | manifest · npx init/upgrade/check · S5 git-clean · **✅ 2026-06-15**(Release/npm 留维护者) | FailureReport 模板 · rejected→draft gate-check |
|
|
42
53
|
| **v0.3.x** | **A2 Starter** | 40-self-check 帽 · `task.harness.v1.json` · depends_on 禁环 CLI · **✅ 2026-06-15** | ONBOARDING npx 优先 |
|
|
43
54
|
| **v0.4.0** | **A3 + push** | ontology.yaml · D7 HG-RELEASE · demo_checkout 脱敏 · MIT public | ETCLOVG 映射页 · README 叙事 |
|
|
44
|
-
| **v1.0.0** | **A4 stable** | ICVO audit CLI · invoke_index · gate-check --graph(Inform) | CHANGELOG 冻结 · B2 量化进 README |
|
|
55
|
+
| **v1.0.0** | **A4 stable** | ICVO audit CLI · invoke_index · gate-check --graph(Inform) | CHANGELOG 冻结 · B2 量化进 README · **✅ 2026-06-16**(HG-RELEASE 留维护者) |
|
|
45
56
|
|
|
46
57
|
### 2.2 Track G(HGM · v1.0 后 · proposal)
|
|
47
58
|
|
|
48
59
|
| 能力标签 | 代号 | 须交付(实现) | 文档 |
|
|
49
60
|
| --- | --- | --- | --- |
|
|
50
|
-
| **G1 ·
|
|
51
|
-
| **G2 ·
|
|
61
|
+
| **G1 · v2.0+** | HGM 起步 | `events/*.jsonl` · graph ingest · snapshot · axioms check 子集(**均未实现**) | HGM design v0.1→v0.2 |
|
|
62
|
+
| **G2 · v2.1+** | HGM 查询 | timeline · patterns · SQLite 投影 | 可选 Neo4j 导出 |
|
|
52
63
|
|
|
53
64
|
**刻意不做(至 v1.0)**:GrowingReasoningAgent · OWL 推理机 · 热插拔 Track(Q5)· Neo4j 默认后端 · **Track G ingest(v1.0 前)**。
|
|
54
65
|
|
|
@@ -62,7 +73,7 @@
|
|
|
62
73
|
| **B** | kimi-code-meta 试点 | oss-fork-meta / kimi-code-meta preset · 上游 PR 证据 · **#8 B2+micro-bench(1+3 主链)** · **#9 Agent-shell(2 并行)** | B0 · 证据方案待审 |
|
|
63
74
|
| **C** | Runtime | harness ctx · Worker · **HGM 不替代 C** | 后置 |
|
|
64
75
|
| **D** | 对外叙事 | ICVO · §7.5 对比 · 理论文章(见 prompts/) | 待 P0 绿 |
|
|
65
|
-
| **G** | **(新增)HGM** | §2
|
|
76
|
+
| **G** | **(新增)HGM** | §2 **v2.x** · 依赖 v1.0 公理稳定 | proposal |
|
|
66
77
|
|
|
67
78
|
---
|
|
68
79
|
|
|
@@ -72,7 +83,7 @@
|
|
|
72
83
|
| --- | --- |
|
|
73
84
|
| **A3 与 P0 关系** | P0 金样已建 `examples/demo_checkout/` · A3 = 脱敏 + 补 40 帽完整链 |
|
|
74
85
|
| **methodology/** | L2 文档真值集中 · 不改变 A1–A4 日期 |
|
|
75
|
-
| **Track G** | 新增 · 不插入 A1/A2 人力 ·
|
|
86
|
+
| **Track G** | 新增 · 不插入 A1/A2 人力 · **v2.0 启动条件**:v1.0 关账 + 事件 schema 冻结 |
|
|
76
87
|
| **ICVO 叙事** | 纳入 D 轨与 v1.0 验收 · 非新 semver |
|
|
77
88
|
| **三路合并 / rollback** | 仍 v0.3 设计 · v0.4 实现(本体 §4.3) |
|
|
78
89
|
|
|
@@ -87,7 +98,7 @@
|
|
|
87
98
|
| v0.2 → v0.3 | P0 金样 ACCEPTANCE ✅ · A1 实现 ✅(Release/npm 可后补) |
|
|
88
99
|
| v0.3 → v0.4 | npx upgrade dogfood(kimi-code-meta)· ontology.yaml 草案 |
|
|
89
100
|
| v0.4 → v1.0 | public push 审计 · **#8 B2 + SDD-Compliance micro-bench** · ICVO audit 子集绿 |
|
|
90
|
-
| v1.0 →
|
|
101
|
+
| v1.0 → v2.0 HGM | 维护者确认事件 schema 冻结 · ingest 不破坏 S2 · G1 立项 |
|
|
91
102
|
|
|
92
103
|
---
|
|
93
104
|
|
|
@@ -106,7 +117,9 @@ Epic 与子 task 真值:`Projects/docs/harness/tasks/active/`
|
|
|
106
117
|
| #6 A3 public push | v0.4.0 |
|
|
107
118
|
| #7 A4 v1.0 | v1.0.0 · 引用 #8 |
|
|
108
119
|
| **#8 B2 + bench** | Track B · **1+3 主证据** · P0 绿后优先 |
|
|
109
|
-
| **#9 Agent-shell** | Track B ·
|
|
120
|
+
| **#9 Agent-shell** | Track B · **后置** · HGM+agent 后 | deferred · 见 §8 |
|
|
121
|
+
| **I-YAML** | Track A · v1.1+ Inform | [`task_y1`](../../../../docs/harness/tasks/active/task_cyning_harness_y1_yaml_inform_v19_v1.md) · YAML P0 后 |
|
|
122
|
+
| **Track G G1** | HGM v2.0 | [`task_g1`](../../../../docs/harness/tasks/active/task_cyning_harness_g1_hgm_v2_v1.md) · I-YAML + G0 后 |
|
|
110
123
|
|
|
111
124
|
**证据策略(2026-06-15 锁定)**:
|
|
112
125
|
|
|
@@ -123,6 +136,24 @@ Epic 与子 task 真值:`Projects/docs/harness/tasks/active/`
|
|
|
123
136
|
|
|
124
137
|
---
|
|
125
138
|
|
|
139
|
+
## 8. Post-v1.0 执行序(2026-06-16)
|
|
140
|
+
|
|
141
|
+
维护者决策真值:工作区 [`POST_V1_0_SEQUENCE_v1_zh.md`](../../../../docs/harness/guides/POST_V1_0_SEQUENCE_v1_zh.md) · HGM 讨论 [`HGM_UPGRADE_OUTLINE_v1_zh.md`](./graph/HGM_UPGRADE_OUTLINE_v1_zh.md)
|
|
142
|
+
|
|
143
|
+
| 序 | 里程碑 | 阻塞 |
|
|
144
|
+
| --- | --- | --- |
|
|
145
|
+
| 0 | A5 @1.0.1 · Epic CLOSE · **v1.0 公众号本周发** | — |
|
|
146
|
+
| 1 | Ink 后端 Graph YAML P0 CLOSE | — |
|
|
147
|
+
| 2 | 产品 Inform-YAML **v1.1+**(2.0 前) | 1 |
|
|
148
|
+
| 3 | HGM G0 大纲讨论 + schema 冻结 | 1 |
|
|
149
|
+
| 4 | HGM G1 **v2.0** ingest | 2 + 3 |
|
|
150
|
+
| 5 | cyning-harness-agent 基础 | 4 · 待立项 |
|
|
151
|
+
| 6 | B9 Agent-shell findings | 5 |
|
|
152
|
+
|
|
153
|
+
**原则**:Inform YAML 在 v2.0 前并入主轨 · HGM 在后端 YAML 试点后启动 · B9 最后。
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
126
157
|
## 7. 修订记录
|
|
127
158
|
|
|
128
159
|
| 版本 | 日期 | 说明 |
|
|
@@ -134,3 +165,5 @@ Epic 与子 task 真值:`Projects/docs/harness/tasks/active/`
|
|
|
134
165
|
| v1.3.1 | 2026-06-15 | B8/B9 审核结论回写 · S1–S4 · 3×2 · D6 字段 |
|
|
135
166
|
| v1.3.2 | 2026-06-15 | P0 金样关账 · v0.2→v0.3 首闸满足 · A1 next |
|
|
136
167
|
| v1.3.3 | 2026-06-15 | A1 实现关账 · A2 next · v0.3.0 表标注 |
|
|
168
|
+
| v1.4 | 2026-06-15 | **SEM-02**:HGM Track G **v0.5/v0.6 → v2.x** · 增 §2.0 命名纪律 |
|
|
169
|
+
| v1.5 | 2026-06-16 | 增 §8 Post-v1.0 序 · I-YAML v1.1+ · B9 后置 · 链 HGM 大纲 |
|
|
@@ -2,14 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
| 项 | 内容 |
|
|
4
4
|
| --- | --- |
|
|
5
|
-
| **状态** | `
|
|
5
|
+
| **状态** | `frozen` · **数字已冻结** · 2026-06-16 |
|
|
6
6
|
| **版本** | v1.0 |
|
|
7
7
|
| **日期** | 2026-06-15 |
|
|
8
8
|
| **task** | 工作区 [`task_cyning_harness_b8_b2_compliance_bench_v1.md`](../../../../docs/harness/tasks/active/task_cyning_harness_b8_b2_compliance_bench_v1.md) |
|
|
9
9
|
| **审核** | [`REVIEW_B3` §10](../reviews/REVIEW_B3_pilot_evidence_and_sdd_compliance_bench_v1_zh.md#10-审核记录2026-06-15) · APPROVE_WITH_CHANGES |
|
|
10
10
|
| **ROADMAP** | v0.4→v1.0 闸门 · [`ROADMAP_v1_zh.md`](../ROADMAP_v1_zh.md) §5 |
|
|
11
11
|
|
|
12
|
-
> **读者说明**:本文档为 **双证据** 同页真值。**Part A** = 真实试点 retro(小样本 · 机制叙事);**Part B** = 可复现 SDD-Compliance bench(不测 LLM 解题)。
|
|
13
12
|
> **读者说明**:本文档为 **双证据** 同页真值。**Part A** = 真实试点 retro(小样本 · 机制叙事);**Part B** = 可复现 SDD-Compliance bench(不测 LLM 解题)。
|
|
14
13
|
> **禁止**在未冻结前将下表数字复制进 README / 公众稿(续篇篇 1 §8)。
|
|
15
14
|
> **执行委派**:工作区 Epic §00 · 下一档 A1 — [`PROMPT_START_a1_npx_v1.md`](../../../../docs/harness/invokes/by-task/cyning-harness-a1-npx/PROMPT_START_a1_npx_v1.md)
|
|
@@ -29,45 +28,49 @@
|
|
|
29
28
|
| 字段 | 值 |
|
|
30
29
|
| --- | --- |
|
|
31
30
|
| **preset** | `kimi-code-meta`(repo 嵌入 · 主路径) |
|
|
32
|
-
| **样本窗口** |
|
|
33
|
-
| **`sample_n`** |
|
|
34
|
-
| **task 类型** |
|
|
35
|
-
| **是否与 #4 共用** | 是 · 与 [`task_cyning_harness_b_kimi_dogfood_v1.md`](../../../../docs/harness/tasks/
|
|
36
|
-
| **retro 方法** |
|
|
31
|
+
| **样本窗口** | 2026-06-10 → 2026-06-15 |
|
|
32
|
+
| **`sample_n`** | **6**(见 A.3 列表) |
|
|
33
|
+
| **task 类型** | harness-only dogfood ×1 · 文档修复 ×1 · agent-core 改码 ×3 · 起草/进行中 ×1 |
|
|
34
|
+
| **是否与 #4 共用** | 是 · 与 [`task_cyning_harness_b_kimi_dogfood_v1.md`](../../../../docs/harness/tasks/done/cyning-harness/task_cyning_harness_b_kimi_dogfood_close_v1.md) 对齐 dogfood 样本 |
|
|
35
|
+
| **retro 方法** | invoke 日志 · gate-check 拦截记录 · CI 首次绿 · D6 PR diff 人工核对 |
|
|
37
36
|
|
|
38
37
|
### A.2 指标表(PilotEvidence)
|
|
39
38
|
|
|
39
|
+
> **数字状态**:frozen · 2026-06-16 冻结 · §1 策略 A(待采集字段标 N/A)· 可引用进 README/ASSESSMENT。
|
|
40
|
+
|
|
40
41
|
| 字段 | 定义 | 值 | 备注 |
|
|
41
42
|
| --- | --- | --- | --- |
|
|
42
|
-
| `audit_reject_rate` | 22 轮次中「内容阻塞 / 打回」比例 |
|
|
43
|
-
| `audit_rounds_mean` | R1→R2… 平均轮次 |
|
|
44
|
-
| `ci_first_green_rate` | 含改码 task 的 **首次** CI 绿比例 |
|
|
45
|
-
| `gate_block_count` | 30 前 gate-check
|
|
46
|
-
| `wizard_adoption_days` | install/adopt → 首个 task CLOSE 人天 |
|
|
47
|
-
| **`upstream_pr_d6_clean`** | D6 双分支 **零过程轨泄漏** PR 数 / 率 |
|
|
48
|
-
| `failure_report_count` | 30 失败路径 / FailureReport 次数 |
|
|
49
|
-
| `sample_n` | 纳入统计的 task 数 |
|
|
43
|
+
| `audit_reject_rate` | 22 轮次中「内容阻塞 / 打回」比例 | **N/A** | §1 策略 A:样本期未系统采集 22 R1 内容阻塞;不编造 |
|
|
44
|
+
| `audit_rounds_mean` | R1→R2… 平均轮次 | **N/A** | §1 策略 A:同 audit_reject_rate · 未系统采集 |
|
|
45
|
+
| `ci_first_green_rate` | 含改码 task 的 **首次** CI 绿比例 | **3/3 = 100%** | 改码 task:#565 docs · #583 agent-core · #94 agent-core · invoke 30 验证命令均通过;样本极小 |
|
|
46
|
+
| `gate_block_count` | 30 前 gate-check **拦截**次数(累计) | **3+** | P0 金样签前 exit 2 · #94 签前验证 exit 2 · dogfood gate-check exit 2(#705 pending);不含日常开发中可能的未记录拦截 |
|
|
47
|
+
| `wizard_adoption_days` | install/adopt → 首个 task CLOSE 人天 | **N/A** | §1 策略 A:install 日期未落盘;无法准确计算 |
|
|
48
|
+
| **`upstream_pr_d6_clean`** | D6 双分支 **零过程轨泄漏** PR 数 / 率 | **3/3 = 100%** | #622 · #630 · #708 的 upstream diff 均 **未含** `docs/harness/` / `docs/tasks/` / harness meta 文件;#580 PR 未开 |
|
|
49
|
+
| `failure_report_count` | 30 失败路径 / FailureReport 次数 | **1** | #94 30 越闸事件(HG-AUDIT-R1 pending 改码)· 已记录 SOLUTION 并修复 GATE_VERIFY 协议 |
|
|
50
|
+
| `sample_n` | 纳入统计的 task 数 | **6** | 见 A.3 · 禁止外推胜率 |
|
|
50
51
|
|
|
51
52
|
### A.3 机制证据(叙事用 · 非胜率)
|
|
52
53
|
|
|
53
54
|
| 项 | 说明 | 状态 |
|
|
54
55
|
| --- | --- | --- |
|
|
55
|
-
|
|
|
56
|
-
|
|
|
56
|
+
| 纳入 `sample_n` 的 task slug | `cyning-harness-b-kimi-dogfood` · `fix-docs-node-565` · `fix-telemetry-bash-cancel-583` · `fix-skill-frontmatter-580` · `fix-read-dual-limit-94` · `fix-open-tool-calls-705`(进行中) | ✅ 已列出 |
|
|
57
|
+
| 上游 PR 链 | Kimi fork → Moonshot upstream · 过程轨隔离 | ✅ #622/#630/#708 零泄漏 |
|
|
58
|
+
| gate 拦截样例 | P0 金样 pending R1 拒 30 · #94 签前验证拒 30 · dogfood pending #705 拒 30 | ✅ 3 个场景已记录 |
|
|
57
59
|
| 与 bench 关系 | Part B 覆盖 **可机械复现** 子集;Part A 覆盖 **真实绑定深度** | 见 Part B |
|
|
58
60
|
|
|
59
61
|
### A.4 Part A 采集清单(维护者)
|
|
60
62
|
|
|
61
|
-
- [
|
|
62
|
-
- [
|
|
63
|
-
- [
|
|
64
|
-
- [
|
|
63
|
+
- [x] 列出纳入 `sample_n` 的 task slug + 类型
|
|
64
|
+
- [x] 从 #4 dogfood 增量填入 fork 数据
|
|
65
|
+
- [x] 核对 D6 PR:过程轨文件未进入 upstream diff(#622/#630/#708)
|
|
66
|
+
- [x] **冻结**:按 §1 策略 A 将未采集字段标 N/A · 可写入 README/ASSESSMENT
|
|
67
|
+
- [ ] 后续维护周期可补采 22 R1 内容阻塞 / 轮次(不影响冻结值)
|
|
65
68
|
|
|
66
69
|
---
|
|
67
70
|
|
|
68
71
|
## Part B · SDD-Compliance micro-bench
|
|
69
72
|
|
|
70
|
-
> **依赖**:P0 金样 ACCEPTANCE 全绿 · gate-check 行为与 P0 金样 D2/D3
|
|
73
|
+
> **依赖**:P0 金样 ACCEPTANCE 全绿 · gate-check 行为与 P0 金样 D2/D3 一致 · **已冻结**。
|
|
71
74
|
> **初版范围**:**S1–S4** · S5(rejected→draft)待 **v0.3** gate 落地后再纳入。
|
|
72
75
|
|
|
73
76
|
### B.1 覆盖边界(README 须声明)
|
|
@@ -82,36 +85,40 @@
|
|
|
82
85
|
|
|
83
86
|
| ID | 场景 | 公理 | 期望(合规) | 夹具路径 | 实测 |
|
|
84
87
|
| --- | --- | --- | --- | --- | --- |
|
|
85
|
-
| **S1** | R1 pending 即 30 | D2 | gate-check exit≠0 · 30 应拒 | `examples/compliance_bench/S1_r1_pending/` |
|
|
86
|
-
| **S2** | R1 approved · 无 review | D2/D3 |
|
|
87
|
-
| **S3** | R1 approved + review 落盘 | D2/D3 | gate-check exit=0 | `examples/compliance_bench/S3_r1_with_review/` |
|
|
88
|
-
| **S4** | sync 域 vs S2 | S2 | apply **不得**含 S2 路径 | `examples/compliance_bench/S4_sync_domain/` |
|
|
88
|
+
| **S1** | R1 pending 即 30 | D2 | gate-check exit≠0 · 30 应拒 | `examples/compliance_bench/S1_r1_pending/` | **PASS** · exit 2 |
|
|
89
|
+
| **S2** | R1 approved · 无 review | D2/D3 | bench 判非合规(缺 `*_audit_R1_*`) | `examples/compliance_bench/S2_r1_no_review/` | **PASS** · 缺 review → 非合规 |
|
|
90
|
+
| **S3** | R1 approved + review 落盘 | D2/D3 | gate-check exit=0 · review 存在 | `examples/compliance_bench/S3_r1_with_review/` | **PASS** · exit 0 |
|
|
91
|
+
| **S4** | sync 域 vs S2 | S2 | apply **不得**含 S2 路径 | `examples/compliance_bench/S4_sync_domain/` | **PASS** · plan 无 task/reviews 路径 |
|
|
89
92
|
| ~~S5~~ | rejected→draft | D2 | v0.3+ · **条件项** | — | _未纳入 v1_ |
|
|
90
93
|
|
|
91
|
-
### B.3
|
|
94
|
+
### B.3 运行方式
|
|
92
95
|
|
|
93
96
|
```bash
|
|
94
|
-
|
|
97
|
+
cd /path/to/cyning-harness
|
|
95
98
|
./wizard/compliance-bench.sh --all
|
|
96
|
-
#
|
|
99
|
+
# 仅输出合规率 %
|
|
100
|
+
./wizard/compliance-bench.sh --quiet --all
|
|
97
101
|
```
|
|
98
102
|
|
|
103
|
+
手工步骤见 `examples/compliance_bench/README.md`。
|
|
104
|
+
|
|
99
105
|
### B.4 结果摘要(数字冻结区)
|
|
100
106
|
|
|
101
107
|
| 项 | 值 |
|
|
102
108
|
| --- | --- |
|
|
103
|
-
| **运行日期** |
|
|
104
|
-
| **gate-check 版本 / commit** |
|
|
105
|
-
| **S1–S4 合规率** |
|
|
106
|
-
| **失败 scenario** |
|
|
107
|
-
| **与 Part A 对照** |
|
|
109
|
+
| **运行日期** | 2026-06-16 |
|
|
110
|
+
| **gate-check 版本 / commit** | `wizard/gate-check.sh` · 工作区 `main` |
|
|
111
|
+
| **S1–S4 合规率** | **4/4 = 100%**(基于当前 fixtures · P0 绿后首跑) |
|
|
112
|
+
| **失败 scenario** | 无 |
|
|
113
|
+
| **与 Part A 对照** | S1/S3 与 #94 签前/签后验证、P0 金样 gate-check 行为一致;S4 与 `harness-sync.sh` 不覆盖 task/reviews 的实现一致 |
|
|
108
114
|
|
|
109
115
|
### B.5 Part B 待办
|
|
110
116
|
|
|
111
|
-
- [
|
|
112
|
-
- [
|
|
113
|
-
- [
|
|
117
|
+
- [x] 创建 `examples/compliance_bench/` 目录与 S1–S4 夹具
|
|
118
|
+
- [x] `wizard/compliance-bench.sh` 或 ACCEPTANCE 级手工步骤
|
|
119
|
+
- [x] P0 绿后首跑 · 填入 §B.4 · **已冻结 4/4=100%**
|
|
114
120
|
- [ ] v0.3 后评估是否纳入 S5
|
|
121
|
+
- [x] 冻结后可写入 README/公众稿(须由 A4 D4 执行)
|
|
115
122
|
|
|
116
123
|
---
|
|
117
124
|
|
|
@@ -129,4 +136,5 @@
|
|
|
129
136
|
|
|
130
137
|
| 版本 | 日期 | 说明 |
|
|
131
138
|
| --- | --- | --- |
|
|
139
|
+
| v1.0 | 2026-06-16 | 回填 Part A 最小集 + Part B 首跑 4/4=100% · 数字仍 draft |
|
|
132
140
|
| v1.0 | 2026-06-15 | 初版模板 · 双证据同页 · 数字 TBD |
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
| 项 | 内容 |
|
|
5
5
|
| -------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
|
6
|
-
| **状态** | `proposal` · 远期架构(**
|
|
6
|
+
| **状态** | `proposal` · 远期架构(**v2.0+**) |
|
|
7
7
|
| **版本** | v0.1 |
|
|
8
8
|
| **日期** | 2026-06-15 |
|
|
9
9
|
| **范围** | 过程轨 **实例** 的显式图 + 事件历史 + 公理可查询 |
|
|
10
10
|
| **非范围** | 替代 Git/Markdown 真值 · 替代 LLM Runtime · `**GraphTrack` 架构图**(见 §0.3) |
|
|
11
11
|
| **依赖** | [`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) v1.2 · P0 金样路径已建(ACCEPTANCE 待绿)· v0.3 `ontology.yaml`(未实现)· v1.0 `gate-check --graph`(Inform · 未实现) |
|
|
12
|
+
| **升级大纲** | [`HGM_UPGRADE_OUTLINE_v1_zh.md`](./HGM_UPGRADE_OUTLINE_v1_zh.md) · G0 讨论入口(2026-06-16) |
|
|
12
13
|
| **思想来源** | [`HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md`](./HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md) |
|
|
13
14
|
|
|
14
15
|
|
|
@@ -33,7 +34,7 @@ HGM 是 **本体论在工程中的可落地形态之一**:不引入 OWL 推理
|
|
|
33
34
|
```text
|
|
34
35
|
语义层 DESIGN_ONTOLOGY v1.2 + ontology.yaml(类 · 关系 · 公理)
|
|
35
36
|
文件层 docs/tasks · reviews · invokes · gate-check.log(当前真值 · S2 保护)
|
|
36
|
-
图+事件层 HGM(可选增强 ·
|
|
37
|
+
图+事件层 HGM(可选增强 · v2.0+)— 从文件层 **推导** · 不反向覆盖文件层
|
|
37
38
|
```
|
|
38
39
|
|
|
39
40
|
### 0.3 易混概念
|
|
@@ -55,7 +56,7 @@ HGM 是 **本体论在工程中的可落地形态之一**:不引入 OWL 推理
|
|
|
55
56
|
| H2 | **文件优先** | S2 保护域只追加事件,**不**用图 DB 覆盖 task/reviews |
|
|
56
57
|
| H3 | **事件不可变** | 修正 = 新事件 · 禁止删改历史 |
|
|
57
58
|
| H4 | **公理同源** | 图约束与 `DESIGN_ONTOLOGY` §5 公理 ID 一一对应 |
|
|
58
|
-
| H5 | **渐进存储** |
|
|
59
|
+
| H5 | **渐进存储** | v2.0 JSONL → v2.1 SQLite 投影 → v2.2+ 可选外部图库 |
|
|
59
60
|
|
|
60
61
|
|
|
61
62
|
---
|
|
@@ -75,7 +76,7 @@ HGM 是 **本体论在工程中的可落地形态之一**:不引入 OWL 推理
|
|
|
75
76
|
| `InvokeSnapshot` | InvokeSnapshot | `invoke:{path}` | `docs/harness/invokes/*` |
|
|
76
77
|
| `FailureReport` | FailureReport | `failure:{path}` | reviews 或 task 附录 · v0.3+ |
|
|
77
78
|
| `GateCheckRun` | GateCheckRun | `gcr:{iso8601}:{task_slug}` | `.cyning-harness/gate-check.log` |
|
|
78
|
-
| `SyncOperation` | SyncOperation | `sync:{iso8601}:plan|apply` | wizard 日志 ·
|
|
79
|
+
| `SyncOperation` | SyncOperation | `sync:{iso8601}:plan|apply` | wizard 日志 · v2.0+ |
|
|
79
80
|
| `InformArtifact` | InformArtifact | `inform:{repo_rel_path}` | `_tech_graph/*` 等 |
|
|
80
81
|
|
|
81
82
|
|
|
@@ -101,7 +102,7 @@ HGM 是 **本体论在工程中的可落地形态之一**:不引入 OWL 推理
|
|
|
101
102
|
|
|
102
103
|
### 1.3 事件类型(Event · append-only)
|
|
103
104
|
|
|
104
|
-
存储默认:`.cyning-harness/events/YYYY-MM.jsonl`(
|
|
105
|
+
存储默认:`.cyning-harness/events/YYYY-MM.jsonl`(v2.0 提案)
|
|
105
106
|
|
|
106
107
|
```json
|
|
107
108
|
{
|
|
@@ -139,7 +140,7 @@ HGM 是 **本体论在工程中的可落地形态之一**:不引入 OWL 推理
|
|
|
139
140
|
## 2. 公理 → 可执行检查(HGM 视角)
|
|
140
141
|
|
|
141
142
|
|
|
142
|
-
| 公理 | 图/事件表述 | 现有机械检查 | HGM
|
|
143
|
+
| 公理 | 图/事件表述 | 现有机械检查 | HGM v2.0 |
|
|
143
144
|
| --------------- | ---------------------------------------------------------------- | ------------------ | -------------------- |
|
|
144
145
|
| **D2** | pending 的 `HG-AUDIT-R1` --BLOCKS--> 30 帽 | gate-check exit 2 | 查询 + 事件告警 |
|
|
145
146
|
| **D3** | 30 首动作须关联 `GateCheckRun` | 30 prompt 模板 | 缺 `CHECKED` 边 → 违规 |
|
|
@@ -148,7 +149,7 @@ HGM 是 **本体论在工程中的可落地形态之一**:不引入 OWL 推理
|
|
|
148
149
|
| **rejected→10** | `GateStatusChanged(rejected)` → 下一事件须 `TaskStatusChanged(draft)` | v0.3 gate-check 警告 | 时序约束 |
|
|
149
150
|
|
|
150
151
|
|
|
151
|
-
示例查询(**Cypher 风格伪码** · 非
|
|
152
|
+
示例查询(**Cypher 风格伪码** · 非 v2.0 承诺语法):
|
|
152
153
|
|
|
153
154
|
```cypher
|
|
154
155
|
// 违反 D2:R1 pending 但存在 30 执行事件
|
|
@@ -174,19 +175,19 @@ RETURN t, e
|
|
|
174
175
|
| task 表改 status / gate | task md | `TaskStatusChanged` / `GateStatusChanged` |
|
|
175
176
|
|
|
176
177
|
|
|
177
|
-
**
|
|
178
|
+
**v2.0 最小实现**:`harness graph ingest --from-repo .` 扫描目录 + 解析 gate-check.log **回填**事件(幂等)。
|
|
178
179
|
|
|
179
180
|
### 3.2 CLI 路线图
|
|
180
181
|
|
|
181
182
|
|
|
182
183
|
| 命令 | 版本 | 说明 |
|
|
183
184
|
| -------------------------------------- | ---- | ---------------------------------- |
|
|
184
|
-
| `harness graph ingest` |
|
|
185
|
-
| `harness graph snapshot` |
|
|
186
|
-
| `harness graph query` |
|
|
187
|
-
| `harness graph timeline --task <slug>` |
|
|
188
|
-
| `harness graph axioms check` |
|
|
189
|
-
| `harness graph patterns` |
|
|
185
|
+
| `harness graph ingest` | v2.0 | 文件 → 事件 JSONL |
|
|
186
|
+
| `harness graph snapshot` | v2.0 | 事件 → snapshot.json |
|
|
187
|
+
| `harness graph query` | v2.1 | 简单过滤器(非完整 Cypher) |
|
|
188
|
+
| `harness graph timeline --task <slug>` | v2.1 | 单 Task 事件轴 |
|
|
189
|
+
| `harness graph axioms check` | v2.1 | 跑 D2/D3/S2 图规则 |
|
|
190
|
+
| `harness graph patterns` | v2.2 | 频繁路径统计(blocked / failed) |
|
|
190
191
|
| `gate-check --graph` | v1.0 | **Inform** 模块图 · 与 HGM **并列** · Q3 |
|
|
191
192
|
|
|
192
193
|
|
|
@@ -197,12 +198,12 @@ RETURN t, e
|
|
|
197
198
|
|
|
198
199
|
| 阶段 | 存储 | 适用 |
|
|
199
200
|
| -------- | -------------------------------------------------------- | -------------- |
|
|
200
|
-
| **
|
|
201
|
-
| **
|
|
202
|
-
| **
|
|
201
|
+
| **v2.0** | `.cyning-harness/events/*.jsonl` + `graph/snapshot.json` | 一人 · 单仓 |
|
|
202
|
+
| **v2.1** | + SQLite(nodes/edges/events 表) | 本地查询加速 |
|
|
203
|
+
| **v2.2** | 可选 Neo4j / 外部导出 | 多仓聚合 · **非默认** |
|
|
203
204
|
|
|
204
205
|
|
|
205
|
-
**不采用**「事件与图库强分离到 PostgreSQL+Neo4j」作为
|
|
206
|
+
**不采用**「事件与图库强分离到 PostgreSQL+Neo4j」作为 v2.0 默认——与「纪律包轻嵌入」冲突。
|
|
206
207
|
|
|
207
208
|
---
|
|
208
209
|
|
|
@@ -213,8 +214,8 @@ v0.2 P0 金样路径(ACCEPTANCE 进行中)
|
|
|
213
214
|
v0.3 manifest · npx · FailureReport · gate-check rejected(多数未实现)
|
|
214
215
|
v0.4 ontology.yaml · D7 HG-RELEASE · public push
|
|
215
216
|
v1.0 ICVO 审计 · invoke_index · gate-check --graph(Inform)
|
|
216
|
-
|
|
217
|
-
|
|
217
|
+
v2.0+ Track G / G1:HGM ingest + snapshot + 基础 axioms check(proposal · 本文件 · v1.0 后启动)
|
|
218
|
+
v2.1–v2.2 timeline · patterns · 可选外置图库(proposal)
|
|
218
219
|
```
|
|
219
220
|
|
|
220
221
|
**后置**:GrowingReasoningAgent / 自动 Recommendation 节点 — **未在本仓立项** · 依赖 HGM 事件量积累后再评。
|
|
@@ -226,8 +227,8 @@ v0.6–v0.8 timeline · patterns · 可选外置图库(proposal)
|
|
|
226
227
|
|
|
227
228
|
| # | 问题 | 暂定 |
|
|
228
229
|
| --- | --------------------------- | ----------------------------- |
|
|
229
|
-
| Q1 | ingest 由 git hook 还是手动 CLI? |
|
|
230
|
-
| Q2 | 是否「时光机」重建任意时点图? |
|
|
230
|
+
| Q1 | ingest 由 git hook 还是手动 CLI? | v2.0 **手动** + gate-check 钩子可选 |
|
|
231
|
+
| Q2 | 是否「时光机」重建任意时点图? | v2.2+ · 事件重放 |
|
|
231
232
|
| Q3 | HGM 与 Supabase/远端同步? | **否** · v1.0 后单独评 |
|
|
232
233
|
| Q4 | 用户能否删事件? | **否** · 仅追加 `CorrectionEvent` |
|
|
233
234
|
| Q5 | Epic 升格后图模型变更? | Epic 变 `Epic` 标签节点 · 随 Q1 本体 |
|
|
@@ -252,7 +253,8 @@ v0.6–v0.8 timeline · patterns · 可选外置图库(proposal)
|
|
|
252
253
|
|
|
253
254
|
| 版本 | 日期 | 说明 |
|
|
254
255
|
| ---- | ---------- | ------------------------------------ |
|
|
255
|
-
| v0.1 | 2026-06-15 | 初稿 · 对齐本体 v1.2 · 校正对话稿偏差 ·
|
|
256
|
+
| v0.1 | 2026-06-15 | 初稿 · 对齐本体 v1.2 · 校正对话稿偏差 · v2.0 轻量存储 |
|
|
257
|
+
| v0.2 | 2026-06-15 | **SEM-02**:HGM 产品阶段号 v0.5/v0.6 → **v2.x** |
|
|
256
258
|
| v0.1.1 | 2026-06-15 | §5 路线图与 ROADMAP 对齐 · gate-check --graph → v1.0 · proposal 标注 |
|
|
257
259
|
|
|
258
260
|
|
|
@@ -109,7 +109,7 @@ Harness Graph Model (HGM)
|
|
|
109
109
|
| 存储 | SQLite → Neo4j 渐进 |
|
|
110
110
|
| CLI | `graph query` · `timeline` · `analyze` · `predict` |
|
|
111
111
|
| 采集 | install · task · gate-check · 22/30 产出 |
|
|
112
|
-
| 路线 |
|
|
112
|
+
| 路线 | v2.0+ 分阶段(**v1.0 关账后**) |
|
|
113
113
|
|
|
114
114
|
**已知偏差(相对本地 v1.2)**:
|
|
115
115
|
|
|
@@ -118,7 +118,7 @@ Harness Graph Model (HGM)
|
|
|
118
118
|
| PRODUCT_ONTOLOGY v1.1 | **DESIGN_ONTOLOGY v1.2** |
|
|
119
119
|
| FailureReport 已模板化 | **v0.3 backlog** |
|
|
120
120
|
| ontology.yaml 已有 | **v0.4+ 抽取** |
|
|
121
|
-
| Neo4j
|
|
121
|
+
| Neo4j v2.2 默认 | **真值稿优先 JSONL + 可选 SQLite 投影** |
|
|
122
122
|
| GrowingReasoningAgent 衔接 | **未立项 · C 轨后置** |
|
|
123
123
|
|
|
124
124
|
**完整工程化草案** → [`HARNESS_GRAPH_MODEL_design_v0_zh.md`](./HARNESS_GRAPH_MODEL_design_v0_zh.md)(同目录真值稿)。
|