@furongjun1999/dsh-memory 0.9.6 → 0.9.8

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.
Files changed (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
@@ -1,244 +1,244 @@
1
- # -*- coding: utf-8 -*-
2
- """G6 · node_ 结构提炼抽检工单与扩批闸门(P40 设计态验收)。
3
-
4
- 对照 `docs/mdcg/认知图_G4-G8缺口裁定单_v0.1.md` §四 G6:`node_*`(P37 派生记忆)
5
- 自带 `ccg_exempt=true`,只声明「功能名 / 生效条件」,`子功能/执行/不适用条件` 全缺。
6
- 条件 A 要求**先抽 20 条做提炼预演、人工核对提炼口径,绝不盲跑全量**。
7
-
8
- 覆盖:①契约链 ②plan 只读 ③工单结构 ④同源口径 ⑤预演 grounded+模板词标记
9
- ⑥样本不足不产候选 ⑦确定性 ⑧闸门关闭 ⑨闸门放行 ⑩闸门否决 ⑪不改节点
10
- ⑫权限分档 ⑬样本量校准 ⑭未知 action。
11
-
12
- 独立临时根,重跑 ≡ 首跑。运行:python -m md_cg.test_p40_refine_worklist
13
- """
14
- from __future__ import annotations
15
-
16
- import os
17
- import shutil
18
- import tempfile
19
-
20
- from . import consolidate as C
21
- from . import refine as rf
22
- from . import tokens
23
- from .mdcos import MdCGOS
24
- from .mcp_server import KERNEL_TOOLS, call_tool
25
- from .security import AccessDenied, Principal
26
-
27
- PASS = FAIL = 0
28
- FAILS = []
29
-
30
-
31
- def ok(cond, label):
32
- global PASS, FAIL
33
- if cond:
34
- PASS += 1
35
- else:
36
- FAIL += 1
37
- FAILS.append(label)
38
- print(f" FAIL {label}")
39
-
40
-
41
- def denied(fn, label):
42
- try:
43
- fn()
44
- except AccessDenied:
45
- ok(True, label)
46
- return
47
- ok(False, label)
48
-
49
-
50
- #: 与 P37 派生记忆同型:有「功能名/生效条件」,缺「子功能/执行/不适用条件」
51
- TEMPLATE = ("# 功能名:感知单元\n"
52
- "# 生效条件:载体/位置:感知系统;时间:2026-01-01 00:00~"
53
- "2026-01-01 01:00(UTC);方法:感官输入;约束:协议实例运行中\n"
54
- "协议实例在感知系统中完成一次观测,产出结构化记录。\n")
55
-
56
-
57
- def _seed_root(root, n=30):
58
- cg = MdCGOS(root)
59
- for i in range(n):
60
- cg.add("node_dup_%02d" % i, TEMPLATE, layer="knowledge", tags=["p37"])
61
- cg.add("note_out", "情境笔记,不在抽检前缀内。\n", layer="contextual",
62
- tags=["note"])
63
- cg.flush()
64
- cg.rebuild_index()
65
- return cg
66
-
67
-
68
- def _write_layer():
69
- s = tokens.role_spec("reflection")
70
- return Principal(tenant="default", actor="writer", clearance="internal",
71
- can_write=True, can_admin=False, role="reflect",
72
- layers_allow=s["layers_allow"], ops_allow=s["ops_allow"])
73
-
74
-
75
- def _p(cg, **kw):
76
- return call_tool(cg, "cg", {"op": "maintain", **kw})
77
-
78
-
79
- def main():
80
- print("md 认知图 P40 验收 · G6 node_ 提炼抽检工单(只读预演 + 扩批闸门)")
81
- print("=" * 70)
82
- tmp = tempfile.mkdtemp(prefix="mdcg_p40_")
83
- ROOT = os.path.join(tmp, "root")
84
- try:
85
- from . import corpus
86
- corpus.reset_root(ROOT)
87
- cg = _seed_root(ROOT)
88
- cg.principal = Principal(tenant="default", actor="p40",
89
- clearance="private", can_write=True,
90
- can_admin=True, role="designer")
91
- acts = ("refine", "refine_gate", "refine_history", "refine_calibrate")
92
-
93
- print("\n【1】op 契约链(防漏改)")
94
- prop = next(t for t in KERNEL_TOOLS
95
- if t["name"] == "cg")["inputSchema"]["properties"]
96
- desc = prop["action"]["description"]
97
- ok(all(a in desc for a in acts), "①4 个 refine action 已在 schema 声明")
98
- ok(all(k in prop for k in ("sample_n", "prefix", "verdicts")),
99
- "①sample_n/prefix/verdicts 参数已声明")
100
- ok(all(a in MdCGOS.MAINTAIN_ACTIONS for a in acts),
101
- "①4 个 action 已在 MAINTAIN_ACTIONS 注册")
102
-
103
- print("\n【2】plan 只读(不写盘 / 前缀内 20 条)")
104
- # 2026-10-19(#559 方案2):`refine` 的**默认前缀已改为空(不过滤)**——本用例
105
- # 验的是「前缀内 30 条 / 前缀外不纳入」,故必须显式给前缀;不给就变成全量池
106
- # (实测 31 条),那是另一条契约,不是本用例的判据。
107
- rep = _p(cg, action="refine", prefix="node_")
108
- ok(rep.get("dry_run") is True and rep.get("readonly") is True,
109
- "②dry_run/readonly 标记")
110
- ok(rep.get("pool") == 30, f"②抽检池 30(实测 {rep.get('pool')})")
111
- ok(rep.get("sampled") == 20, f"②抽检 20 条(实测 {rep.get('sampled')})")
112
- ok(all(i["id"].startswith("node_") for i in rep["items"]),
113
- "②前缀外节点不纳入")
114
- ok(not os.path.exists(os.path.join(ROOT, rf.REFINE_LOG)),
115
- "②预演不写日志")
116
-
117
- print("\n【3】工单结构(原文 + 字段缺口 + 指纹 + 口径声明)")
118
- ok(len(rep["worklist"]) == 20, "③工单 20 条")
119
- it = rep["items"][0]
120
- ok(all(k in it for k in ("id", "family", "layer", "body", "body_len",
121
- "ccg_present", "ccg_missing", "source_sha")),
122
- "③工单条目字段齐备")
123
- ok("子功能" in it["ccg_missing"] and "执行" in it["ccg_missing"],
124
- "③如实登记缺失的 CCG 字段(不编造)")
125
- ok(it["body"].strip(), "③工单带原文(供人工核对)")
126
- ok(len(it["source_sha"]) == 16, "③来源指纹(可复核正文)")
127
- ok([r["key"] for r in rep["spec"]["review_items"]]
128
- == ["faithful", "added_info", "discriminating", "member_consistency"],
129
- "③口径声明含 4 项人工核对项")
130
- ok(rep["spec"]["evidence"].startswith("inferred"),
131
- "③产出证据档恒 inferred")
132
-
133
- print("\n【4】同源口径(不另起提炼器)")
134
- ok(rf.MIN_CLUSTER == C.INDUCE_MIN_CLUSTER
135
- and rf.MIN_JACCARD == C.INDUCE_MIN_JACCARD, "④聚类阈值取自 induce")
136
-
137
- print("\n【5】预演(grounded + 模板词标记)")
138
- pv = rep["preview"]
139
- ok(pv["clusters"] == 1, f"⑤产出 1 个候选(实测 {pv['clusters']})")
140
- c0 = pv["candidates"][0]
141
- ok(c0["size"] == 20, f"⑤候选成员 20(实测 {c0['size']})")
142
- ok(c0["grounding_gap"] == [], "⑤共性条件全成员可追溯(无忠实性缺口)")
143
- ok(all(len(v) == c0["size"] for v in c0["condition_sources"].values()),
144
- "⑤每条共性条件都有成员索引来源")
145
- ok(any(g["ratio"] >= rf.GENERIC_DF for g in c0["generic_conditions"]),
146
- "⑤高 df 模板词被标记 generic")
147
- ok(c0["discriminating"] == [], "⑤该候选无区分性共性")
148
- ok(pv["candidates_generic_only"] == 1, "⑤如实报「模板化」候选计数")
149
-
150
- print("\n【6】样本不足不产候选(<min_cluster 不成簇)")
151
- pv2 = rf.preview(cg, ids=sorted(rep["sample"])[:2])
152
- ok(pv2["clusters"] == 0, "⑥2 条 < min_cluster → 0 候选")
153
- ok(pv2["sample_adequacy"] == "insufficient", "⑥判 insufficient")
154
-
155
- print("\n【7】确定性(同 seed 同样本)")
156
- rep2 = _p(cg, action="refine", prefix="node_")
157
- ok(rep["sample_sha"] == rep2["sample_sha"], "⑦同样本指纹")
158
- ok([c["concept_id"] for c in pv["candidates"]]
159
- == [c["concept_id"] for c in rep2["preview"]["candidates"]],
160
- "⑦同候选集")
161
- ok(rep["sample"] == rep2["sample"], "⑦同抽样序")
162
-
163
- print("\n【8】闸门(未审不放行)")
164
- g0 = _p(cg, action="refine_gate")
165
- ok(g0.get("expand_allowed") is False and g0.get("reason") == "no_batch",
166
- "⑧无留痕 → no_batch 且不放行")
167
- ap0 = _p(cg, action="refine", apply=True, batch="t-review")
168
- ok(ap0.get("reviewed") == 0
169
- and ap0["gate"]["reason"] == "awaiting_human_review",
170
- "⑧未审 → awaiting_human_review 且不放行")
171
- ok(os.path.exists(os.path.join(ROOT, rf.REFINE_LOG)), "⑧留痕已落盘")
172
-
173
- print("\n【9】闸门放行(全审 / 全忠实 / 无新增)")
174
- cids = [c["concept_id"] for c in pv["candidates"]]
175
- good = [{"concept_id": c, "faithful": True, "added_info": False}
176
- for c in cids]
177
- ap1 = _p(cg, action="refine", apply=True, batch="t-ok", verdicts=good)
178
- ok(ap1["gate"]["reviewed"] == len(cids), "⑨裁决全部候选")
179
- ok(ap1["gate"]["expand_allowed"] is True
180
- and ap1["gate"]["reason"] == "ok", "⑨通过率达标 → 放行扩批")
181
- g1 = _p(cg, action="refine_gate", batch="t-ok")
182
- ok(g1.get("expand_allowed") is True, "⑨gate 动作复算一致")
183
-
184
- print("\n【10】闸门否决(新增信息 / 忠实率不足)")
185
- bad = [{"concept_id": c, "faithful": True, "added_info": True}
186
- for c in cids]
187
- ap2 = _p(cg, action="refine", apply=True, batch="t-added", verdicts=bad)
188
- ok(ap2["gate"]["reason"] == "added_info_detected"
189
- and ap2["gate"]["expand_allowed"] is False, "⑩新增信息 → 整批否决")
190
- st = rf._verdict_stats(
191
- [{"concept_id": "a", "faithful": False, "added_info": False},
192
- {"concept_id": "b", "faithful": True, "added_info": False}],
193
- [{"concept_id": "a"}, {"concept_id": "b"}])
194
- ok(st["reason"] == "faithful_rate_below_gate"
195
- and st["expand_allowed"] is False, "⑩忠实率不足 → 拒放行")
196
-
197
- print("\n【11】apply 不改任何节点")
198
- nid = rep["items"][0]["id"]
199
- before = cg._read(cg.index["nodes"][nid])
200
- _p(cg, action="refine", apply=True, batch="t-immutable")
201
- cg.rebuild_index()
202
- after = cg._read(cg.index["nodes"][nid])
203
- ok(before[0] == after[0] and before[1] == after[1],
204
- "⑪frontmatter 与正文逐字节不变")
205
- hist = _p(cg, action="refine_history")
206
- ok(hist["total"] >= 4 and hist["returned"] >= 1, "⑪history 可回读留痕")
207
- ok("root" in hist, "⑪history 结构含 root")
208
-
209
- print("\n【12】权限分档(写层可看 / apply 需管理)")
210
- cg.principal = _write_layer()
211
- ok(isinstance(_p(cg, action="refine"), dict), "⑫写层可看工单")
212
- ok(isinstance(_p(cg, action="refine_gate"), dict), "⑫写层可看闸门")
213
- denied(lambda: _p(cg, action="refine", apply=True), "⑫写层不可 apply")
214
- cg.principal = Principal(tenant="default", actor="p40",
215
- clearance="private", can_write=True,
216
- can_admin=True, role="designer")
217
-
218
- print("\n【13】样本量校准(只读爬坡,如实归因)")
219
- cal = _p(cg, action="refine_calibrate")
220
- ok(cal.get("readonly") is True and cal["steps"][0]["n"] == 20,
221
- "⑬校准从 20 条起步")
222
- ok(isinstance(cal.get("blocked"), bool)
223
- and isinstance(cal.get("recommend"), str), "⑬如实报 blocked + 归因")
224
- ok("扩批" in cal["recommend"], "⑬归因指向「不得扩批」")
225
-
226
- print("\n【14】未知 action 不静默成功")
227
- try:
228
- _p(cg, action="refine_x")
229
- ok(False, "⑭未知 action 必须报错")
230
- except ValueError as e:
231
- ok("未知 action" in str(e), "⑭未知 action 报错")
232
- finally:
233
- shutil.rmtree(tmp, ignore_errors=True)
234
-
235
- print("\n" + "=" * 70)
236
- print(f"P40 结果:PASS {PASS} / FAIL {FAIL}")
237
- if FAILS:
238
- print("未通过:" + ";".join(FAILS))
239
- return 0 if FAIL == 0 else 1
240
-
241
-
242
- if __name__ == "__main__":
243
- import sys
244
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """G6 · node_ 结构提炼抽检工单与扩批闸门(P40 设计态验收)。
3
+
4
+ 对照 `docs/mdcg/认知图_G4-G8缺口裁定单_v0.1.md` §四 G6:`node_*`(P37 派生记忆)
5
+ 自带 `ccg_exempt=true`,只声明「功能名 / 生效条件」,`子功能/执行/不适用条件` 全缺。
6
+ 条件 A 要求**先抽 20 条做提炼预演、人工核对提炼口径,绝不盲跑全量**。
7
+
8
+ 覆盖:①契约链 ②plan 只读 ③工单结构 ④同源口径 ⑤预演 grounded+模板词标记
9
+ ⑥样本不足不产候选 ⑦确定性 ⑧闸门关闭 ⑨闸门放行 ⑩闸门否决 ⑪不改节点
10
+ ⑫权限分档 ⑬样本量校准 ⑭未知 action。
11
+
12
+ 独立临时根,重跑 ≡ 首跑。运行:python -m md_cg.test_p40_refine_worklist
13
+ """
14
+ from __future__ import annotations
15
+
16
+ import os
17
+ import shutil
18
+ import tempfile
19
+
20
+ from . import consolidate as C
21
+ from . import refine as rf
22
+ from . import tokens
23
+ from .mdcos import MdCGOS
24
+ from .mcp_server import KERNEL_TOOLS, call_tool
25
+ from .security import AccessDenied, Principal
26
+
27
+ PASS = FAIL = 0
28
+ FAILS = []
29
+
30
+
31
+ def ok(cond, label):
32
+ global PASS, FAIL
33
+ if cond:
34
+ PASS += 1
35
+ else:
36
+ FAIL += 1
37
+ FAILS.append(label)
38
+ print(f" FAIL {label}")
39
+
40
+
41
+ def denied(fn, label):
42
+ try:
43
+ fn()
44
+ except AccessDenied:
45
+ ok(True, label)
46
+ return
47
+ ok(False, label)
48
+
49
+
50
+ #: 与 P37 派生记忆同型:有「功能名/生效条件」,缺「子功能/执行/不适用条件」
51
+ TEMPLATE = ("# 功能名:感知单元\n"
52
+ "# 生效条件:载体/位置:感知系统;时间:2026-01-01 00:00~"
53
+ "2026-01-01 01:00(UTC);方法:感官输入;约束:协议实例运行中\n"
54
+ "协议实例在感知系统中完成一次观测,产出结构化记录。\n")
55
+
56
+
57
+ def _seed_root(root, n=30):
58
+ cg = MdCGOS(root)
59
+ for i in range(n):
60
+ cg.add("node_dup_%02d" % i, TEMPLATE, layer="knowledge", tags=["p37"])
61
+ cg.add("note_out", "情境笔记,不在抽检前缀内。\n", layer="contextual",
62
+ tags=["note"])
63
+ cg.flush()
64
+ cg.rebuild_index()
65
+ return cg
66
+
67
+
68
+ def _write_layer():
69
+ s = tokens.role_spec("reflection")
70
+ return Principal(tenant="default", actor="writer", clearance="internal",
71
+ can_write=True, can_admin=False, role="reflect",
72
+ layers_allow=s["layers_allow"], ops_allow=s["ops_allow"])
73
+
74
+
75
+ def _p(cg, **kw):
76
+ return call_tool(cg, "cg", {"op": "maintain", **kw})
77
+
78
+
79
+ def main():
80
+ print("md 认知图 P40 验收 · G6 node_ 提炼抽检工单(只读预演 + 扩批闸门)")
81
+ print("=" * 70)
82
+ tmp = tempfile.mkdtemp(prefix="mdcg_p40_")
83
+ ROOT = os.path.join(tmp, "root")
84
+ try:
85
+ from . import corpus
86
+ corpus.reset_root(ROOT)
87
+ cg = _seed_root(ROOT)
88
+ cg.principal = Principal(tenant="default", actor="p40",
89
+ clearance="private", can_write=True,
90
+ can_admin=True, role="designer")
91
+ acts = ("refine", "refine_gate", "refine_history", "refine_calibrate")
92
+
93
+ print("\n【1】op 契约链(防漏改)")
94
+ prop = next(t for t in KERNEL_TOOLS
95
+ if t["name"] == "cg")["inputSchema"]["properties"]
96
+ desc = prop["action"]["description"]
97
+ ok(all(a in desc for a in acts), "①4 个 refine action 已在 schema 声明")
98
+ ok(all(k in prop for k in ("sample_n", "prefix", "verdicts")),
99
+ "①sample_n/prefix/verdicts 参数已声明")
100
+ ok(all(a in MdCGOS.MAINTAIN_ACTIONS for a in acts),
101
+ "①4 个 action 已在 MAINTAIN_ACTIONS 注册")
102
+
103
+ print("\n【2】plan 只读(不写盘 / 前缀内 20 条)")
104
+ # 2026-10-19(#559 方案2):`refine` 的**默认前缀已改为空(不过滤)**——本用例
105
+ # 验的是「前缀内 30 条 / 前缀外不纳入」,故必须显式给前缀;不给就变成全量池
106
+ # (实测 31 条),那是另一条契约,不是本用例的判据。
107
+ rep = _p(cg, action="refine", prefix="node_")
108
+ ok(rep.get("dry_run") is True and rep.get("readonly") is True,
109
+ "②dry_run/readonly 标记")
110
+ ok(rep.get("pool") == 30, f"②抽检池 30(实测 {rep.get('pool')})")
111
+ ok(rep.get("sampled") == 20, f"②抽检 20 条(实测 {rep.get('sampled')})")
112
+ ok(all(i["id"].startswith("node_") for i in rep["items"]),
113
+ "②前缀外节点不纳入")
114
+ ok(not os.path.exists(os.path.join(ROOT, rf.REFINE_LOG)),
115
+ "②预演不写日志")
116
+
117
+ print("\n【3】工单结构(原文 + 字段缺口 + 指纹 + 口径声明)")
118
+ ok(len(rep["worklist"]) == 20, "③工单 20 条")
119
+ it = rep["items"][0]
120
+ ok(all(k in it for k in ("id", "family", "layer", "body", "body_len",
121
+ "ccg_present", "ccg_missing", "source_sha")),
122
+ "③工单条目字段齐备")
123
+ ok("子功能" in it["ccg_missing"] and "执行" in it["ccg_missing"],
124
+ "③如实登记缺失的 CCG 字段(不编造)")
125
+ ok(it["body"].strip(), "③工单带原文(供人工核对)")
126
+ ok(len(it["source_sha"]) == 16, "③来源指纹(可复核正文)")
127
+ ok([r["key"] for r in rep["spec"]["review_items"]]
128
+ == ["faithful", "added_info", "discriminating", "member_consistency"],
129
+ "③口径声明含 4 项人工核对项")
130
+ ok(rep["spec"]["evidence"].startswith("inferred"),
131
+ "③产出证据档恒 inferred")
132
+
133
+ print("\n【4】同源口径(不另起提炼器)")
134
+ ok(rf.MIN_CLUSTER == C.INDUCE_MIN_CLUSTER
135
+ and rf.MIN_JACCARD == C.INDUCE_MIN_JACCARD, "④聚类阈值取自 induce")
136
+
137
+ print("\n【5】预演(grounded + 模板词标记)")
138
+ pv = rep["preview"]
139
+ ok(pv["clusters"] == 1, f"⑤产出 1 个候选(实测 {pv['clusters']})")
140
+ c0 = pv["candidates"][0]
141
+ ok(c0["size"] == 20, f"⑤候选成员 20(实测 {c0['size']})")
142
+ ok(c0["grounding_gap"] == [], "⑤共性条件全成员可追溯(无忠实性缺口)")
143
+ ok(all(len(v) == c0["size"] for v in c0["condition_sources"].values()),
144
+ "⑤每条共性条件都有成员索引来源")
145
+ ok(any(g["ratio"] >= rf.GENERIC_DF for g in c0["generic_conditions"]),
146
+ "⑤高 df 模板词被标记 generic")
147
+ ok(c0["discriminating"] == [], "⑤该候选无区分性共性")
148
+ ok(pv["candidates_generic_only"] == 1, "⑤如实报「模板化」候选计数")
149
+
150
+ print("\n【6】样本不足不产候选(<min_cluster 不成簇)")
151
+ pv2 = rf.preview(cg, ids=sorted(rep["sample"])[:2])
152
+ ok(pv2["clusters"] == 0, "⑥2 条 < min_cluster → 0 候选")
153
+ ok(pv2["sample_adequacy"] == "insufficient", "⑥判 insufficient")
154
+
155
+ print("\n【7】确定性(同 seed 同样本)")
156
+ rep2 = _p(cg, action="refine", prefix="node_")
157
+ ok(rep["sample_sha"] == rep2["sample_sha"], "⑦同样本指纹")
158
+ ok([c["concept_id"] for c in pv["candidates"]]
159
+ == [c["concept_id"] for c in rep2["preview"]["candidates"]],
160
+ "⑦同候选集")
161
+ ok(rep["sample"] == rep2["sample"], "⑦同抽样序")
162
+
163
+ print("\n【8】闸门(未审不放行)")
164
+ g0 = _p(cg, action="refine_gate")
165
+ ok(g0.get("expand_allowed") is False and g0.get("reason") == "no_batch",
166
+ "⑧无留痕 → no_batch 且不放行")
167
+ ap0 = _p(cg, action="refine", apply=True, batch="t-review")
168
+ ok(ap0.get("reviewed") == 0
169
+ and ap0["gate"]["reason"] == "awaiting_human_review",
170
+ "⑧未审 → awaiting_human_review 且不放行")
171
+ ok(os.path.exists(os.path.join(ROOT, rf.REFINE_LOG)), "⑧留痕已落盘")
172
+
173
+ print("\n【9】闸门放行(全审 / 全忠实 / 无新增)")
174
+ cids = [c["concept_id"] for c in pv["candidates"]]
175
+ good = [{"concept_id": c, "faithful": True, "added_info": False}
176
+ for c in cids]
177
+ ap1 = _p(cg, action="refine", apply=True, batch="t-ok", verdicts=good)
178
+ ok(ap1["gate"]["reviewed"] == len(cids), "⑨裁决全部候选")
179
+ ok(ap1["gate"]["expand_allowed"] is True
180
+ and ap1["gate"]["reason"] == "ok", "⑨通过率达标 → 放行扩批")
181
+ g1 = _p(cg, action="refine_gate", batch="t-ok")
182
+ ok(g1.get("expand_allowed") is True, "⑨gate 动作复算一致")
183
+
184
+ print("\n【10】闸门否决(新增信息 / 忠实率不足)")
185
+ bad = [{"concept_id": c, "faithful": True, "added_info": True}
186
+ for c in cids]
187
+ ap2 = _p(cg, action="refine", apply=True, batch="t-added", verdicts=bad)
188
+ ok(ap2["gate"]["reason"] == "added_info_detected"
189
+ and ap2["gate"]["expand_allowed"] is False, "⑩新增信息 → 整批否决")
190
+ st = rf._verdict_stats(
191
+ [{"concept_id": "a", "faithful": False, "added_info": False},
192
+ {"concept_id": "b", "faithful": True, "added_info": False}],
193
+ [{"concept_id": "a"}, {"concept_id": "b"}])
194
+ ok(st["reason"] == "faithful_rate_below_gate"
195
+ and st["expand_allowed"] is False, "⑩忠实率不足 → 拒放行")
196
+
197
+ print("\n【11】apply 不改任何节点")
198
+ nid = rep["items"][0]["id"]
199
+ before = cg._read(cg.index["nodes"][nid])
200
+ _p(cg, action="refine", apply=True, batch="t-immutable")
201
+ cg.rebuild_index()
202
+ after = cg._read(cg.index["nodes"][nid])
203
+ ok(before[0] == after[0] and before[1] == after[1],
204
+ "⑪frontmatter 与正文逐字节不变")
205
+ hist = _p(cg, action="refine_history")
206
+ ok(hist["total"] >= 4 and hist["returned"] >= 1, "⑪history 可回读留痕")
207
+ ok("root" in hist, "⑪history 结构含 root")
208
+
209
+ print("\n【12】权限分档(写层可看 / apply 需管理)")
210
+ cg.principal = _write_layer()
211
+ ok(isinstance(_p(cg, action="refine"), dict), "⑫写层可看工单")
212
+ ok(isinstance(_p(cg, action="refine_gate"), dict), "⑫写层可看闸门")
213
+ denied(lambda: _p(cg, action="refine", apply=True), "⑫写层不可 apply")
214
+ cg.principal = Principal(tenant="default", actor="p40",
215
+ clearance="private", can_write=True,
216
+ can_admin=True, role="designer")
217
+
218
+ print("\n【13】样本量校准(只读爬坡,如实归因)")
219
+ cal = _p(cg, action="refine_calibrate")
220
+ ok(cal.get("readonly") is True and cal["steps"][0]["n"] == 20,
221
+ "⑬校准从 20 条起步")
222
+ ok(isinstance(cal.get("blocked"), bool)
223
+ and isinstance(cal.get("recommend"), str), "⑬如实报 blocked + 归因")
224
+ ok("扩批" in cal["recommend"], "⑬归因指向「不得扩批」")
225
+
226
+ print("\n【14】未知 action 不静默成功")
227
+ try:
228
+ _p(cg, action="refine_x")
229
+ ok(False, "⑭未知 action 必须报错")
230
+ except ValueError as e:
231
+ ok("未知 action" in str(e), "⑭未知 action 报错")
232
+ finally:
233
+ shutil.rmtree(tmp, ignore_errors=True)
234
+
235
+ print("\n" + "=" * 70)
236
+ print(f"P40 结果:PASS {PASS} / FAIL {FAIL}")
237
+ if FAILS:
238
+ print("未通过:" + ";".join(FAILS))
239
+ return 0 if FAIL == 0 else 1
240
+
241
+
242
+ if __name__ == "__main__":
243
+ import sys
244
+ sys.exit(main())