@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,146 +1,146 @@
1
- # -*- coding: utf-8 -*-
2
- """接口形状(schema)与 golden 例子——把「可复跑」扩到接口面。
3
-
4
- 外部 issue #5 第 15 条:四个动作只有签名、没有字段表,而「可复跑」是 KPI 之一,
5
- 接口的形状本身就是判据的一部分。
6
-
7
- 设计约束:
8
- * **零外部依赖**(D-005):不引入 jsonschema,本模块自带极简校验器。
9
- * **文档与实现共用一份**:schema 与 golden 在此定义,文档引用,测试断言。
10
- * **只约束已实现的部分**:Envelope 尚未定型(见 issues #15),标 target_only,
11
- 不假装它已经能通过校验。
12
- """
13
-
14
- import json
15
-
16
- __all__ = ["VERDICT", "ENVELOPE", "LEDGER", "GOLDEN", "validate", "main"]
17
-
18
- # ---- 极简 schema 描述 ----------------------------------------------------
19
- # 类型标记:str / int / num / bool / list / dict / "nullable:X" / "enum:a|b"
20
- VERDICT = {
21
- "state": "enum:ACCEPT|REJECT|DEFER|BLINDSPOT",
22
- "kind": "str",
23
- "basis": "nullable:str",
24
- "evidence": "str",
25
- "detail": {
26
- "acceptance": "enum:formal_pass|formal_reject|undetermined",
27
- "verification_state": "enum:unverified|confirmed|weakened|falsified",
28
- },
29
- }
30
-
31
- ENVELOPE = {
32
- "items": "list",
33
- "completeness": "bool",
34
- "hit_count": "nullable:int",
35
- "snapshot_id": "nullable:str",
36
- "operation_status": "enum:success|partial|timeout|unavailable|operation_error",
37
- }
38
-
39
- LEDGER = {
40
- "seq": "int",
41
- "op": "str",
42
- "node_id": "str",
43
- "outcome": "str",
44
- }
45
-
46
- #: golden 例子:三种裁决各一,外加一个 envelope 目标态样例(标 target_only)
47
- GOLDEN = [
48
- {"name": "verdict_accept", "schema": "verdict", "target_only": False, "doc": {
49
- "state": "ACCEPT", "kind": "work_done", "basis": "test",
50
- "evidence": "形式完备:V1 条件空间齐全、V2 见出处标记、V4 未发现字面同槽冲突",
51
- "detail": {"acceptance": "formal_pass", "verification_state": "unverified"}}},
52
- {"name": "verdict_reject", "schema": "verdict", "target_only": False, "doc": {
53
- "state": "REJECT", "kind": "work_done", "basis": "test",
54
- "evidence": "V1 未过:条件空间缺 observation_position;请补齐后重新提交",
55
- "detail": {"acceptance": "formal_reject", "verification_state": "unverified",
56
- "return_to": "author", "action": "resubmit_with_condition_space"}}},
57
- {"name": "verdict_blindspot", "schema": "verdict", "target_only": False, "doc": {
58
- "state": "BLINDSPOT", "kind": "work_done", "basis": "test",
59
- "evidence": "V4 无法判定:检索失败;按 I5/I6 不得判通过",
60
- "detail": {"acceptance": "undetermined", "verification_state": "unverified",
61
- "criterion": "V4", "v4_status": "unknown"}}},
62
- {"name": "envelope_target", "schema": "envelope", "target_only": True, "doc": {
63
- "items": [], "completeness": True, "hit_count": 0,
64
- "snapshot_id": "snap-0001", "operation_status": "success"}},
65
- ]
66
-
67
- _SCHEMAS = {"verdict": VERDICT, "envelope": ENVELOPE, "ledger": LEDGER}
68
-
69
-
70
- def _check_value(spec, value, path, errs):
71
- # 顺序要紧:dict 必须在字符串方法之前判——否则顶层 spec(dict)调 startswith 直接崩。
72
- if isinstance(spec, dict):
73
- if not isinstance(value, dict):
74
- errs.append("%s: 期望 dict,实为 %s" % (path, type(value).__name__))
75
- return
76
- for k, sub in spec.items():
77
- if k not in value:
78
- errs.append("%s.%s: 缺必填字段" % (path, k))
79
- else:
80
- _check_value(sub, value[k], "%s.%s" % (path, k), errs)
81
- return
82
- if spec.startswith("enum:"):
83
- allowed = spec[5:].split("|")
84
- if value not in allowed:
85
- errs.append("%s: %r 不在枚举 %s 内" % (path, value, allowed))
86
- return
87
- if spec.startswith("nullable:"):
88
- if value is None:
89
- return
90
- _check_value(spec[9:], value, path, errs)
91
- return
92
- if spec == "str":
93
- if not isinstance(value, str):
94
- errs.append("%s: 期望 str,实为 %s" % (path, type(value).__name__))
95
- elif spec == "int":
96
- if not isinstance(value, int) or isinstance(value, bool):
97
- errs.append("%s: 期望 int,实为 %s" % (path, type(value).__name__))
98
- elif spec == "num":
99
- if not isinstance(value, (int, float)) or isinstance(value, bool):
100
- errs.append("%s: 期望 num,实为 %s" % (path, type(value).__name__))
101
- elif spec == "bool":
102
- if not isinstance(value, bool):
103
- errs.append("%s: 期望 bool,实为 %s" % (path, type(value).__name__))
104
- elif spec == "list":
105
- if not isinstance(value, list):
106
- errs.append("%s: 期望 list,实为 %s" % (path, type(value).__name__))
107
- elif spec == "dict":
108
- if not isinstance(value, dict):
109
- errs.append("%s: 期望 dict,实为 %s" % (path, type(value).__name__))
110
- else:
111
- errs.append("%s: 未知 spec %r" % (path, spec))
112
-
113
-
114
- def validate(doc, schema_name):
115
- """校验 doc 符合指定 schema。返回 (ok, errors)。未知 schema 抛 KeyError。"""
116
- spec = _SCHEMAS[schema_name]
117
- errs = []
118
- _check_value(spec, doc, "$", errs)
119
- return (not errs), errs
120
-
121
-
122
- def check_golden():
123
- """全部非 target_only 的 golden 例子必须过校验。"""
124
- out = []
125
- for g in GOLDEN:
126
- if g.get("target_only"):
127
- out.append({"name": g["name"], "status": "target_only"})
128
- continue
129
- ok, errs = validate(g["doc"], g["schema"])
130
- out.append({"name": g["name"], "status": "pass" if ok else "fail", "errors": errs})
131
- return out
132
-
133
-
134
- def main(argv=None):
135
- import sys
136
- try:
137
- sys.stdout.reconfigure(encoding="utf-8")
138
- except Exception:
139
- pass
140
- res = check_golden()
141
- print(json.dumps(res, ensure_ascii=False, indent=1))
142
- return 0 if all(r["status"] != "fail" for r in res) else 1
143
-
144
-
145
- if __name__ == "__main__":
146
- raise SystemExit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """接口形状(schema)与 golden 例子——把「可复跑」扩到接口面。
3
+
4
+ 外部 issue #5 第 15 条:四个动作只有签名、没有字段表,而「可复跑」是 KPI 之一,
5
+ 接口的形状本身就是判据的一部分。
6
+
7
+ 设计约束:
8
+ * **零外部依赖**(D-005):不引入 jsonschema,本模块自带极简校验器。
9
+ * **文档与实现共用一份**:schema 与 golden 在此定义,文档引用,测试断言。
10
+ * **只约束已实现的部分**:Envelope 尚未定型(见 issues #15),标 target_only,
11
+ 不假装它已经能通过校验。
12
+ """
13
+
14
+ import json
15
+
16
+ __all__ = ["VERDICT", "ENVELOPE", "LEDGER", "GOLDEN", "validate", "main"]
17
+
18
+ # ---- 极简 schema 描述 ----------------------------------------------------
19
+ # 类型标记:str / int / num / bool / list / dict / "nullable:X" / "enum:a|b"
20
+ VERDICT = {
21
+ "state": "enum:ACCEPT|REJECT|DEFER|BLINDSPOT",
22
+ "kind": "str",
23
+ "basis": "nullable:str",
24
+ "evidence": "str",
25
+ "detail": {
26
+ "acceptance": "enum:formal_pass|formal_reject|undetermined",
27
+ "verification_state": "enum:unverified|confirmed|weakened|falsified",
28
+ },
29
+ }
30
+
31
+ ENVELOPE = {
32
+ "items": "list",
33
+ "completeness": "bool",
34
+ "hit_count": "nullable:int",
35
+ "snapshot_id": "nullable:str",
36
+ "operation_status": "enum:success|partial|timeout|unavailable|operation_error",
37
+ }
38
+
39
+ LEDGER = {
40
+ "seq": "int",
41
+ "op": "str",
42
+ "node_id": "str",
43
+ "outcome": "str",
44
+ }
45
+
46
+ #: golden 例子:三种裁决各一,外加一个 envelope 目标态样例(标 target_only)
47
+ GOLDEN = [
48
+ {"name": "verdict_accept", "schema": "verdict", "target_only": False, "doc": {
49
+ "state": "ACCEPT", "kind": "work_done", "basis": "test",
50
+ "evidence": "形式完备:V1 条件空间齐全、V2 见出处标记、V4 未发现字面同槽冲突",
51
+ "detail": {"acceptance": "formal_pass", "verification_state": "unverified"}}},
52
+ {"name": "verdict_reject", "schema": "verdict", "target_only": False, "doc": {
53
+ "state": "REJECT", "kind": "work_done", "basis": "test",
54
+ "evidence": "V1 未过:条件空间缺 observation_position;请补齐后重新提交",
55
+ "detail": {"acceptance": "formal_reject", "verification_state": "unverified",
56
+ "return_to": "author", "action": "resubmit_with_condition_space"}}},
57
+ {"name": "verdict_blindspot", "schema": "verdict", "target_only": False, "doc": {
58
+ "state": "BLINDSPOT", "kind": "work_done", "basis": "test",
59
+ "evidence": "V4 无法判定:检索失败;按 I5/I6 不得判通过",
60
+ "detail": {"acceptance": "undetermined", "verification_state": "unverified",
61
+ "criterion": "V4", "v4_status": "unknown"}}},
62
+ {"name": "envelope_target", "schema": "envelope", "target_only": True, "doc": {
63
+ "items": [], "completeness": True, "hit_count": 0,
64
+ "snapshot_id": "snap-0001", "operation_status": "success"}},
65
+ ]
66
+
67
+ _SCHEMAS = {"verdict": VERDICT, "envelope": ENVELOPE, "ledger": LEDGER}
68
+
69
+
70
+ def _check_value(spec, value, path, errs):
71
+ # 顺序要紧:dict 必须在字符串方法之前判——否则顶层 spec(dict)调 startswith 直接崩。
72
+ if isinstance(spec, dict):
73
+ if not isinstance(value, dict):
74
+ errs.append("%s: 期望 dict,实为 %s" % (path, type(value).__name__))
75
+ return
76
+ for k, sub in spec.items():
77
+ if k not in value:
78
+ errs.append("%s.%s: 缺必填字段" % (path, k))
79
+ else:
80
+ _check_value(sub, value[k], "%s.%s" % (path, k), errs)
81
+ return
82
+ if spec.startswith("enum:"):
83
+ allowed = spec[5:].split("|")
84
+ if value not in allowed:
85
+ errs.append("%s: %r 不在枚举 %s 内" % (path, value, allowed))
86
+ return
87
+ if spec.startswith("nullable:"):
88
+ if value is None:
89
+ return
90
+ _check_value(spec[9:], value, path, errs)
91
+ return
92
+ if spec == "str":
93
+ if not isinstance(value, str):
94
+ errs.append("%s: 期望 str,实为 %s" % (path, type(value).__name__))
95
+ elif spec == "int":
96
+ if not isinstance(value, int) or isinstance(value, bool):
97
+ errs.append("%s: 期望 int,实为 %s" % (path, type(value).__name__))
98
+ elif spec == "num":
99
+ if not isinstance(value, (int, float)) or isinstance(value, bool):
100
+ errs.append("%s: 期望 num,实为 %s" % (path, type(value).__name__))
101
+ elif spec == "bool":
102
+ if not isinstance(value, bool):
103
+ errs.append("%s: 期望 bool,实为 %s" % (path, type(value).__name__))
104
+ elif spec == "list":
105
+ if not isinstance(value, list):
106
+ errs.append("%s: 期望 list,实为 %s" % (path, type(value).__name__))
107
+ elif spec == "dict":
108
+ if not isinstance(value, dict):
109
+ errs.append("%s: 期望 dict,实为 %s" % (path, type(value).__name__))
110
+ else:
111
+ errs.append("%s: 未知 spec %r" % (path, spec))
112
+
113
+
114
+ def validate(doc, schema_name):
115
+ """校验 doc 符合指定 schema。返回 (ok, errors)。未知 schema 抛 KeyError。"""
116
+ spec = _SCHEMAS[schema_name]
117
+ errs = []
118
+ _check_value(spec, doc, "$", errs)
119
+ return (not errs), errs
120
+
121
+
122
+ def check_golden():
123
+ """全部非 target_only 的 golden 例子必须过校验。"""
124
+ out = []
125
+ for g in GOLDEN:
126
+ if g.get("target_only"):
127
+ out.append({"name": g["name"], "status": "target_only"})
128
+ continue
129
+ ok, errs = validate(g["doc"], g["schema"])
130
+ out.append({"name": g["name"], "status": "pass" if ok else "fail", "errors": errs})
131
+ return out
132
+
133
+
134
+ def main(argv=None):
135
+ import sys
136
+ try:
137
+ sys.stdout.reconfigure(encoding="utf-8")
138
+ except Exception:
139
+ pass
140
+ res = check_golden()
141
+ print(json.dumps(res, ensure_ascii=False, indent=1))
142
+ return 0 if all(r["status"] != "fail" for r in res) else 1
143
+
144
+
145
+ if __name__ == "__main__":
146
+ raise SystemExit(main())