@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,521 +1,521 @@
1
- # -*- coding: utf-8 -*-
2
- """test_state_event_op · cg(op=state_event) 记账写口守卫(P3 批:写侧入口)。
3
-
4
- 契约:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md` §2「事件是源、槽位是
5
- 投影、查询走 stg」+ §5②(记账入口形态)。本批把「记账」这一步放到 MCP 面:
6
- `md_cg/mcp_server.py` 的 cg 基元新增 op=state_event(写口),底层仍是
7
- `md_cg/state_events.append`(append-only 台账)。
8
-
9
- 断言分组:
10
-
11
- A 全链——cg(op=state_event) 写入 → `_state_events.jsonl` 得一行(五元
12
- subject/slot/old/new/kind + seq/evidence/actor 逐字段)→ 投影
13
- (state_slots.project)与查询面(stg.state_chain,开关开)可见该事件;
14
- 台账追加一条变迁后变迁史条数随之增长;经最外层 `call_tool` 的通路同形。
15
- B 双闸——① op 映射:state_event 映射到既有 "write" 词(受限令牌的拒绝消息
16
- 点名 op=write 而非 op=state_event;**含 write 不含 state_event** 的白名单
17
- 令牌可记账);② 写闸 require_write:can_write=False / theory_ok=False /
18
- clearance 不足三态各自被拒(台账直写盘面、绕过库层节点写闸,故须显式补齐)。
19
- C 防伪造——请求里塞 actor 参数无效:落盘 actor 恒=令牌 actor(无 principal
20
- 时="system")。
21
- D kind 归一——缺省/空串/纯空白 → 落盘 kind=None(「未分类」是合法记账,而
22
- append 对空串抛 ValueError);显式合法值(含带空白)strip 后透传;非法值
23
- ValueError 原样上抛。
24
- E 参数校验——缺/空 subject、缺/空 slot、old/new 双空 → ValueError 原样上抛
25
- (fail-closed,不吞、不包装);合法撤回(old 有值、new 空)照常通过。
26
- F 回归——既有 op(info/read/recent 抽查)行为与权限行改动前一致:designer
27
- 令牌全过、受限令牌该拒的仍拒且消息点名原 op 词;`_ACTION_SIGS` /
28
- `_ACTION_DEFAULT` 未被本批改动(state_event 无 action 面)。
29
-
30
- 隔离:全部落临时目录(`tempfile.mkdtemp`);env 里的根变量与投影开关全程置空或
31
- 指向临时根,令牌签发写临时令牌库,**绝不动在役库/在役令牌库**(本文件不含任何
32
- 真实数据根路径字面量)。
33
-
34
- 运行:python -X utf8 -m md_cg.test_state_event_op
35
- python -X utf8 -m md_cg.test_state_event_op --mutate # 定点变异自证
36
- python -X utf8 -m md_cg.test_state_event_op --mutate --list # 只列变异表
37
-
38
- 退出码(fail-closed):0 = 全绿 / 变异自证 PASS;1 = 有断言失败 / 变异未按预期转红;
39
- 2 = ANCHOR-MISS(变异锚点在当前源码里找不到——实现改了却没同步本表即硬失败)。
40
- """
41
- from __future__ import annotations
42
-
43
- import contextlib
44
- import io
45
- import json
46
- import os
47
- import shutil
48
- import sys
49
- import tempfile
50
- import types
51
-
52
- from . import mcp_server
53
- from . import state_events
54
- from . import state_slots
55
- from . import stg
56
- from . import tokens
57
- from .mdcos import MdCGOS, MdCGSecure
58
- from .security import Principal
59
-
60
- _PASS = []
61
- _FAIL = []
62
- _GEN = [0]
63
- _TMP = tempfile.mkdtemp(prefix="mdcg_se_")
64
- _SAVED = {}
65
- _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
66
- _KEK = os.urandom(32)
67
- #: 被测写口模块的**可变引用**(定点变异把全局换成变异副本,组内一律经 _ms() 取用)。
68
- MS = mcp_server
69
- _REAL_MS = mcp_server
70
-
71
-
72
- # 生效条件:cond 为真记入 _PASS 并打印 PASS,否则记入 _FAIL 并打印 FAIL(extra 仅在失败时打印,供定位)。
73
- def ok(cond, msg, extra=""):
74
- (_PASS if cond else _FAIL).append(msg)
75
- print((" PASS " if cond else " FAIL ") + msg
76
- + ((" ← " + str(extra)) if (extra and not cond) else ""))
77
-
78
-
79
- # 生效条件:无入参;返回当前被测写口模块(未变异=mcp_server 本体,变异轮=内存副本)。
80
- def _ms():
81
- return globals()["MS"]
82
-
83
-
84
- # 生效条件:无入参;把 MDCG_ROOT/MDCG_STATE_ROOT/MDCG_AUX_ROOT/MDCG_DATA_ROOT/MDCG_STG_STATE 的现值存入 _SAVED 并逐个从 os.environ 移除(隔离:任何经 env 取根的路径都不得落到在役库)。
85
- def _sandbox_env():
86
- for k in ("MDCG_ROOT", "MDCG_STATE_ROOT", "MDCG_AUX_ROOT", "MDCG_DATA_ROOT",
87
- "MDCG_STG_STATE"):
88
- _SAVED[k] = os.environ.get(k)
89
- os.environ.pop(k, None)
90
- # #86(令牌运行期复检):把复检读的令牌库钉到本进程隔离库——本件 _principal 的签发/
91
- # 校验都显式落 _tokfile(),而 mcp_server._runtime_token_recheck 经 tokens.token_file(None)
92
- # 读 env MDCG_TOKEN_FILE(缺省=在役库);不钉则复检在在役库查不到本库 token_id ⇒
93
- # A10(最外层 call_tool 通路)被误判「令牌记录已不存在」。_restore_env 依 _SAVED 原样还原。
94
- _SAVED["MDCG_TOKEN_FILE"] = os.environ.get("MDCG_TOKEN_FILE")
95
- os.environ["MDCG_TOKEN_FILE"] = _tokfile()
96
-
97
-
98
- # 生效条件:无入参;把 _SAVED 逐个还原(原值 None 则移除键),恢复进程原有 env 形态。
99
- def _restore_env():
100
- for k, v in _SAVED.items():
101
- if v is None:
102
- os.environ.pop(k, None)
103
- else:
104
- os.environ[k] = v
105
-
106
-
107
- # 生效条件:无入参;返回本进程专用的临时令牌库文件路径(签发/校验全落 _TMP,不触在役令牌库)。
108
- def _tokfile():
109
- return os.path.join(_TMP, "_tokens.json")
110
-
111
-
112
- # 生效条件:role 为 tokens.ROLE_SPECS 角色名;签发该角色令牌(actor 缺省 evt-<role>)后经 verify_token 取回 Principal;**签发与校验都只落临时令牌库**;未知角色/参数非法时抛原异常(不吞)。
113
- def _principal(role, actor=None, **kw):
114
- r = tokens.issue(role, actor=actor or ("evt-" + role), path=_tokfile(),
115
- _allow_bootstrap=True, **kw) # 测试搭架:签发闸的证明在 test_issue543
116
- return tokens.verify_token(r["token"], path=_tokfile())
117
-
118
-
119
- # 生效条件:无入参;在 _TMP 下新建自增代次目录并返回其上的 MdCGOS 实例(**无 principal**——测「无令牌只读面」路径;每调用一个新根,组间零串味)。
120
- def _plain_cg():
121
- _GEN[0] += 1
122
- return MdCGOS(os.path.join(_TMP, "gen%d" % _GEN[0], "root"))
123
-
124
-
125
- # 生效条件:principal 为 security.Principal 实例;在 _TMP 下新建自增代次目录并返回其上的 MdCGSecure 实例(principal 参与授权判定;master_key 用进程级随机 kek,密钥库落临时根内)。
126
- def _secure_cg(principal):
127
- _GEN[0] += 1
128
- return MdCGSecure(os.path.join(_TMP, "gen%d" % _GEN[0], "root"),
129
- principal=principal, master_key=_KEK)
130
-
131
-
132
- # 生效条件:cg 为沙箱实例、a 为 cg 面参数(不含 op);按外层 _cg_call 调 op=state_event 并返回其返回体(op 显式传入,不走 op 推导)。
133
- def _evt(cg, **a):
134
- args = {"op": "state_event"}
135
- args.update(a)
136
- return _ms()._cg_call(cg, args)
137
-
138
-
139
- # 生效条件:fn 为无参可调用对象时——正常返回 ("", "");抛异常返回 (异常类型名, 错误文本)。用于「该拒的拒、且拒的理由是哪个类型/哪句话」的断言。
140
- def _err(fn):
141
- try:
142
- fn()
143
- return "", ""
144
- except Exception as exc: # noqa: BLE001
145
- return type(exc).__name__, str(exc)
146
-
147
-
148
- # 生效条件:cg 为沙箱实例;读取其台账文件并返回逐行 json.loads 的列表(台账缺失 → [];坏行照常抛——守卫只写合法行)。
149
- def _ledger(cg):
150
- p = state_events.ledger_path(cg)
151
- if not os.path.exists(p):
152
- return []
153
- with open(p, encoding="utf-8") as f:
154
- return [json.loads(l) for l in f if l.strip()]
155
-
156
-
157
- # ---------------------------------------------------------------- A
158
- # 生效条件:无入参;在自有沙箱根上(designer 令牌 principal)经 cg(op=state_event) 连写两条事件,断言返回体/落盘行/投影/state_chain 四面对齐、开关关臂不抛、最外层 call_tool 通路同形(落点见组内文案)。
159
- def gA():
160
- print("== A 全链:记账 → 台账 → 投影 → state_chain ==")
161
- cg = _secure_cg(_principal("designer", actor="evt-designer"))
162
- out = _evt(cg, subject="甲", slot="住所", old=None, new="别墅",
163
- kind="enablement", seq=1, evidence="u1")
164
- ev = (out or {}).get("event") or {}
165
- ok(out.get("ok") is True and isinstance(ev, dict),
166
- "A1 cg(op=state_event) 返回 {ok:true, event:rec}", out)
167
- ok(ev.get("subject") == "甲" and ev.get("slot") == "住所"
168
- and ev.get("old") is None and ev.get("new") == "别墅"
169
- and ev.get("kind") == "enablement" and ev.get("seq") == 1
170
- and ev.get("evidence") == "u1" and ev.get("actor") == "evt-designer"
171
- and isinstance(ev.get("t"), (int, float)),
172
- "A2 event 五元/seq/evidence/actor/t 逐字段", ev)
173
- lines = _ledger(cg)
174
- ok(len(lines) == 1, "A3 台账 _state_events.jsonl 恰得一行", len(lines))
175
- ok(lines and lines[0] == ev,
176
- "A4 落盘行与返回 event 逐字段相等(落盘记录=append 返回值)",
177
- (lines, ev))
178
- units = state_slots.project(cg, subject="甲", slot="住所")
179
- ok(len(units) == 1 and units[0]["value"] == "别墅"
180
- and units[0]["state"] == "active" and units[0]["seq_from"] == 1
181
- and units[0]["t_from"] == ev.get("t"),
182
- "A5 投影可见:project 得该槽位单元(value/state/seq_from/t_from 对齐)",
183
- units)
184
- os.environ["MDCG_STG_STATE"] = "1"
185
- try:
186
- chain = stg.state_chain(cg, subject="甲")
187
- finally:
188
- os.environ.pop("MDCG_STG_STATE", None)
189
- ok(chain.get("count") == 1 and chain.get("kept") == 1
190
- and (chain.get("items") or []) == state_slots.project(cg, subject="甲"),
191
- "A6 stg(state_chain)(开关开)可见该事件:items 与 project 逐位一致",
192
- chain)
193
- off = stg.state_chain(cg)
194
- ok(off.get("error") == "disabled",
195
- "A7 开关关 → disabled 体(「没开」与「没命中」可分辨,不抛)", off)
196
- out2 = _evt(cg, subject="甲", slot="住所", old="别墅", new="小屋",
197
- kind="migration", seq=2, evidence="u2")
198
- ok((out2 or {}).get("ok") is True, "A8 第二条(迁移)写入成功", out2)
199
- units2 = state_slots.project(cg, subject="甲", slot="住所")
200
- ok(len(units2) == 1 and units2[0]["value"] == "小屋"
201
- and units2[0]["event_count"] == 2
202
- and len(units2[0]["history"]) == 2,
203
- "A9 变迁史:event_count=2、history 两条(台账追加即投影可见)",
204
- units2)
205
- via = _ms().call_tool(cg, "cg",
206
- {"op": "state_event", "subject": "乙", "slot": "住所",
207
- "new": "帐篷", "seq": 3, "evidence": "u3"})
208
- ok((via or {}).get("ok") is True
209
- and (via.get("event") or {}).get("actor") == "evt-designer",
210
- "A10 经最外层 call_tool(MCP tools/call 通路)同形:ok=true、actor=令牌 actor",
211
- via)
212
- ok(len(_ledger(cg)) == 3, "A11 三条事件皆落盘(append-only 不截断)",
213
- len(_ledger(cg)))
214
-
215
-
216
- # ---------------------------------------------------------------- B
217
- # 生效条件:无入参;在自有沙箱根上按三类令牌(受限 ops_allow 无 write / 含 write 不含 state_event / designer 星号)与三种写闸不足(can_write=False / theory_ok=False / clearance 不足)逐条断言拒绝或放行,并校验拒绝消息点名的 op 词(落点见组内文案)。
218
- def gB():
219
- print("== B 双闸:op 映射(write 词)+ require_write(三态) ==")
220
- # ① op 映射:受限令牌(白名单无 write)→ 拒,且消息点名 op=write(不是 op=state_event)
221
- rcg = _secure_cg(_principal("recorder", actor="evt-restricted",
222
- ops_allow=["read"]))
223
- t, txt = _err(lambda: _evt(rcg, subject="甲", slot="住所", new="值"))
224
- ok(t == "AccessDenied" and "op=write" in txt and "op=state_event" not in txt,
225
- "B1 受限令牌(ops_allow 无 write)→ AccessDenied 且消息点名 op=write"
226
- "(映射生效;不引入 state_event 新 op 词)", (t, txt[:120]))
227
- ok(_ledger(rcg) == [], "B2 被拒时不落盘(台账零行)", _ledger(rcg))
228
- # ② 含 write 不含 state_event → 可记账(回退成 require_op(op) 则此处转红)
229
- wcg = _secure_cg(_principal("recorder", actor="evt-writer",
230
- ops_allow=["read", "write"]))
231
- out = _evt(wcg, subject="甲", slot="住所", new="值", seq=1, evidence="b2")
232
- ok(out.get("ok") is True and len(_ledger(wcg)) == 1,
233
- "B3 白名单含 write 不含 state_event → 放行并落盘(映射到既有 write 词)",
234
- out)
235
- # ③ designer(ops_allow 星号)→ 放行
236
- dcg = _secure_cg(_principal("designer", actor="evt-designer"))
237
- out = _evt(dcg, subject="甲", slot="住所", new="值", seq=1)
238
- ok(out.get("ok") is True, "B4 designer(ops_allow=*)→ 放行", out)
239
- # ④ guest 令牌(can_write=False,白名单无 write)→ op 闸先拒
240
- gcg = _secure_cg(_principal("guest", actor="evt-guest"))
241
- t, txt = _err(lambda: _evt(gcg, subject="甲", slot="住所", new="值"))
242
- ok(t == "AccessDenied" and "op=write" in txt,
243
- "B5 guest 令牌 → AccessDenied(只读访客照拒)", (t, txt[:120]))
244
- # ⑤ 写闸·can_write:直接构造「白名单含 write 但 can_write=False」的 principal
245
- # (角色规格里无此组合,须显式构造——这条正是 require_write 补齐的判据)
246
- ncg = _secure_cg(Principal(actor="evt-nocw", role="guest", clearance="internal",
247
- can_write=False, ops_allow=("*",)))
248
- t, txt = _err(lambda: _evt(ncg, subject="甲", slot="住所", new="值"))
249
- ok(t == "AccessDenied" and "无写权限" in txt,
250
- "B6 can_write=False(op 闸放行)→ 被 require_write 拒(写闸显式补齐)",
251
- (t, txt[:120]))
252
- ok(_ledger(ncg) == [], "B7 该拒的不落盘", _ledger(ncg))
253
- # ⑥ 写闸·theory_ok=False
254
- tcg = _secure_cg(Principal(actor="evt-notheory", clearance="internal",
255
- can_write=True, ops_allow=("*",),
256
- theory_ok=False))
257
- t, txt = _err(lambda: _evt(tcg, subject="甲", slot="住所", new="值"))
258
- ok(t == "AccessDenied" and "版本层校验未通过" in txt,
259
- "B8 theory_ok=False → 被拒(版本层校验维度)", (t, txt[:120]))
260
- # ⑦ 写闸·密级:clearance=public < internal
261
- scg = _secure_cg(Principal(actor="evt-lowclear", clearance="public",
262
- can_write=True, ops_allow=("*",)))
263
- t, txt = _err(lambda: _evt(scg, subject="甲", slot="住所", new="值"))
264
- ok(t == "AccessDenied" and "clearance" in txt,
265
- "B9 clearance 不足 internal → 被拒(密级维度)", (t, txt[:120]))
266
-
267
-
268
- # ---------------------------------------------------------------- C
269
- # 生效条件:无入参;在自有沙箱根上断言请求里塞 actor 参数不生效:带令牌时落盘 actor 恒=令牌 actor、无 principal 时恒="system"(落点见组内文案)。
270
- def gC():
271
- print("== C 防伪造:actor 恒取令牌/系统(请求参数无效) ==")
272
- cg = _secure_cg(_principal("recorder", actor="evt-real",
273
- ops_allow=["read", "write"]))
274
- out = _evt(cg, subject="甲", slot="住所", new="值", seq=1,
275
- evidence="c1", actor="forger")
276
- ok((out.get("event") or {}).get("actor") == "evt-real",
277
- "C1 请求 actor=forger 无效:落盘 actor=令牌 actor", out)
278
- lines = _ledger(cg)
279
- ok(lines and lines[0].get("actor") == "evt-real",
280
- "C2 台账行 actor 逐字=令牌 actor(不落伪造值)", lines)
281
- pcg = _plain_cg()
282
- out = _evt(pcg, subject="甲", slot="住所", new="值", seq=1,
283
- evidence="c3", actor="forger")
284
- ok((out.get("event") or {}).get("actor") == "system",
285
- "C3 无 principal:actor 恒=system(也不取请求参数)", out)
286
-
287
-
288
- # ---------------------------------------------------------------- D
289
- # 生效条件:无入参;在自有沙箱根上按 kind 的五态(缺省/空串/纯空白/显式合法含空白/非法)逐条断言落盘归一结果或 ValueError 上抛(落点见组内文案)。
290
- def gD():
291
- print("== D kind 归一(空串 → None;非法值 fail-closed) ==")
292
- cg = _secure_cg(_principal("designer", actor="evt-d"))
293
- out = _evt(cg, subject="甲", slot="s1", new="v1", seq=1)
294
- ok((out.get("event") or {}).get("kind") is None,
295
- "D1 缺省 kind → 落盘 None(未分类是合法记账)", out)
296
- out = _evt(cg, subject="甲", slot="s2", new="v2", seq=2, kind="")
297
- ok((out.get("event") or {}).get("kind") is None,
298
- "D2 kind=空串 → 归一 None(不抛 ValueError)", out)
299
- out = _evt(cg, subject="甲", slot="s3", new="v3", seq=3, kind=" ")
300
- ok((out.get("event") or {}).get("kind") is None,
301
- "D3 kind=纯空白 → 归一 None", out)
302
- out = _evt(cg, subject="甲", slot="s4", new="v4", seq=4, kind="migration")
303
- ok((out.get("event") or {}).get("kind") == "migration",
304
- "D4 显式合法值透传", out)
305
- out = _evt(cg, subject="甲", slot="s5", new="v5", seq=5, kind=" migration ")
306
- ok((out.get("event") or {}).get("kind") == "migration",
307
- "D5 带空白合法值 strip 后透传", out)
308
- t, txt = _err(lambda: _evt(cg, subject="甲", slot="s6", new="v6",
309
- kind="bogus"))
310
- ok(t == "ValueError" and "bogus" in txt,
311
- "D6 非法 kind → ValueError 原样上抛(fail-closed)", (t, txt[:120]))
312
- ok(len(_ledger(cg)) == 5, "D7 只有合法五条落盘(非法值不落盘)",
313
- len(_ledger(cg)))
314
-
315
-
316
- # ---------------------------------------------------------------- E
317
- # 生效条件:无入参;在自有沙箱根上按 subject/slot/old-new 组合逐条断言 ValueError 原样上抛(不包装、不吞)与合法撤回照常通过(落点见组内文案)。
318
- def gE():
319
- print("== E 参数校验(ValueError 原样上抛) ==")
320
- cg = _secure_cg(_principal("designer", actor="evt-e"))
321
- t, txt = _err(lambda: _evt(cg, slot="住所", new="值"))
322
- ok(t == "ValueError" and "subject" in txt,
323
- "E1 缺 subject → ValueError(点名 subject)", (t, txt[:120]))
324
- t, txt = _err(lambda: _evt(cg, subject=" ", slot="住所", new="值"))
325
- ok(t == "ValueError" and "subject" in txt,
326
- "E2 subject 纯空白 → ValueError", (t, txt[:120]))
327
- t, txt = _err(lambda: _evt(cg, subject="甲", new="值"))
328
- ok(t == "ValueError" and "slot" in txt,
329
- "E3 缺 slot → ValueError(点名 slot)", (t, txt[:120]))
330
- t, txt = _err(lambda: _evt(cg, subject="甲", slot=" ", new="值"))
331
- ok(t == "ValueError" and "slot" in txt,
332
- "E4 slot 纯空白 → ValueError", (t, txt[:120]))
333
- t, txt = _err(lambda: _evt(cg, subject="甲", slot="住所"))
334
- ok(t == "ValueError" and "old" in txt and "new" in txt,
335
- "E5 old/new 双空(缺省)→ ValueError", (t, txt[:120]))
336
- t, txt = _err(lambda: _evt(cg, subject="甲", slot="住所",
337
- old=None, new=None))
338
- ok(t == "ValueError", "E6 old/new 显式双 None → ValueError", (t, txt[:120]))
339
- out = _evt(cg, subject="甲", slot="住所", old="旧值", new=None,
340
- kind="retraction", seq=9, evidence="e7")
341
- ok(out.get("ok") is True
342
- and (out.get("event") or {}).get("new") is None
343
- and (out.get("event") or {}).get("old") == "旧值",
344
- "E7 合法撤回(old 有值、new 空)照常通过", out)
345
- ok(len(_ledger(cg)) == 1,
346
- "E8 校验失败的各次均未落盘(台账仅合法撤回一条)", len(_ledger(cg)))
347
-
348
-
349
- # ---------------------------------------------------------------- F
350
- # 生效条件:无入参;在自有沙箱根上断言既有 op(info/read/recent/未知 op)与受限令牌拒绝路径行为不变(消息点名原 op 词)、无 principal 只读面照常、_ACTION_SIGS/_ACTION_DEFAULT 未被本批改动(落点见组内文案)。
351
- def gF():
352
- print("== F 回归:既有 op 行为与权限行改动前一致 ==")
353
- dcg = _secure_cg(_principal("designer", actor="evt-reg"))
354
- r = _err(lambda: _ms()._cg_call(dcg, {"op": "info"}))
355
- ok(r[0] == "", "F1 designer:op=info 放行(无异常)", r)
356
- r = _err(lambda: _ms()._cg_call(dcg, {"op": "read", "query": "回归"}))
357
- ok(r[0] == "", "F2 designer:op=read 放行", r)
358
- r = _err(lambda: _ms()._cg_call(dcg, {"op": "recent",
359
- "action": "list"}))
360
- ok(r[0] == "", "F3 designer:op=recent/list 放行", r)
361
- t, txt = _err(lambda: _ms()._cg_call(dcg, {"op": "no_such_op"}))
362
- ok(t == "ValueError",
363
- "F4 designer:未识别 op 仍走 ValueError 兜底(分发尾部不变)",
364
- (t, txt[:100]))
365
- rcg = _secure_cg(_principal("recorder", actor="evt-reg2",
366
- ops_allow=["read"]))
367
- r = _err(lambda: _ms()._cg_call(rcg, {"op": "read", "query": "回归"}))
368
- ok(r[0] == "", "F5 受限令牌:白名单内 op=read 放行", r)
369
- t, txt = _err(lambda: _ms()._cg_call(rcg, {"op": "whitebox",
370
- "action": "ping"}))
371
- ok(t == "AccessDenied" and "op=whitebox" in txt,
372
- "F6 受限令牌:白名单外 op=whitebox 拒且消息点名 op=whitebox"
373
- "(非 state_event 的 op 词逐位不变)", (t, txt[:120]))
374
- t, txt = _err(lambda: _ms()._cg_call(rcg, {"op": "write", "node_id": "x",
375
- "content": "y"}))
376
- ok(t == "AccessDenied" and "op=write" in txt,
377
- "F7 受限令牌:白名单外 op=write 拒(既有写面拒绝行为不变)",
378
- (t, txt[:120]))
379
- pcg = _plain_cg()
380
- r = _err(lambda: _ms()._cg_call(pcg, {"op": "read", "query": "回归"}))
381
- ok(r[0] == "", "F8 无 principal(MdCGOS):只读面照常(闸门跳过路径不变)", r)
382
- ok("state_event" not in _ms()._ACTION_SIGS
383
- and "state_event" not in _ms()._ACTION_DEFAULT,
384
- "F9 state_event 无 action 面(_ACTION_SIGS/_ACTION_DEFAULT 未动)",
385
- (sorted(_ms()._ACTION_SIGS), sorted(_ms()._ACTION_DEFAULT)))
386
-
387
-
388
- _GROUPS = (gA, gB, gC, gD, gE, gF)
389
-
390
-
391
- # 生效条件:无入参;逐组执行 _GROUPS(每组自行建沙箱根),组内抛异常记为一条失败并把栈尾打印出来(不中断其余组),返回失败条数。
392
- def _run_groups() -> int:
393
- _PASS.clear()
394
- _FAIL.clear()
395
- for g in _GROUPS:
396
- try:
397
- g()
398
- except Exception as exc: # noqa: BLE001
399
- ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
400
- import traceback
401
- print(traceback.format_exc()[-900:])
402
- return len(_FAIL)
403
-
404
-
405
- # ---------------------------------------------------------------- 变异表
406
- # 锚点 = (名字, rel, ((old, new), …))。每条必须让套件**转红**(红项原文由 --mutate 打印):
407
- # M1 权限映射回退(require_op(op),state_event 失去 write 词映射)→ B1/B3 红
408
- # M2 actor 改取请求参数(防伪造失效)→ C1/C2/C3 红
409
- # M3 kind 不归一(空串直传,append 对空串抛 ValueError)→ D2/D3 红
410
- # M4 删写闸 require_write(can_write=False 不再拦)→ B6/B7 红
411
- _MUTATIONS = (
412
- ("权限映射回退(state_event 不再映射到 write 词)", "md_cg/mcp_server.py",
413
- ((' _p.require_op("write" if op == "state_event" else op)',
414
- ' _p.require_op(op)'),)),
415
- ("actor 改取请求参数(防伪造失效)", "md_cg/mcp_server.py",
416
- ((' from . import state_events as _se\n'
417
- ' _actor = _p.actor if _p is not None else "system"',
418
- ' from . import state_events as _se\n'
419
- ' _actor = a.get("actor") or (_p.actor if _p is not None else "system")'),)),
420
- ("kind 不归一(空串直传)", "md_cg/mcp_server.py",
421
- ((' kind=(a.get("kind") or "").strip() or None,',
422
- ' kind=a.get("kind"),'),)),
423
- ("删写闸 require_write(can_write 不再拦)", "md_cg/mcp_server.py",
424
- ((' if _p is not None:\n _p.require_write("internal")\n',
425
- ' if False:\n _p.require_write("internal")\n'),)),
426
- )
427
-
428
-
429
- # 生效条件:rel 为仓根相对路径时返回该文件的当前源码文本(每次从盘读,不缓存——变异基线必须是**当前工作区**实现)。
430
- def _rel_text(rel: str) -> str:
431
- with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
432
- return f.read()
433
-
434
-
435
- # 生效条件:name/rel/text 给定时——把 text 以 __package__="md_cg"、__file__=<仓内 rel 路径> 执行成命名空间并包成新模块对象返回(不注册 sys.modules、不触发 __main__;语法错误原样抛)。
436
- def _exec_module(name: str, rel: str, text: str):
437
- ns = {"__name__": name, "__package__": "md_cg",
438
- "__file__": os.path.join(_REPO, rel)}
439
- exec(compile(text, rel, "exec"), ns) # noqa: S102 —— 基线自证用
440
- m = types.ModuleType(name)
441
- m.__dict__.update(ns)
442
- return m
443
-
444
-
445
- # 生效条件:list_only 为真时只打印变异表并返回 0;否则先跑未变异基线(必须 0 失败),再逐条在**内存副本**上注入变异(逐锚点 replace,锚点缺失记 ANCHOR-MISS)后重跑整套分组——有红项记 OK、无红项记 MISS(空转即失败);全部锚点命中有红项时返回 0、否则 1;有 ANCHOR-MISS 时返回 2(fail-closed)。
446
- def _mutate_mode(list_only: bool = False) -> int:
447
- print("!! 定点变异自证:逐条把机制改回「错误/缺陷」形态,套件必须转红\n")
448
- if list_only:
449
- for name, rel, _pairs in _MUTATIONS:
450
- print(" %-40s [%s]" % (name, rel))
451
- return 0
452
- anchor_miss, bad = [], []
453
- with contextlib.redirect_stdout(buf0 := io.StringIO()):
454
- clean = _run_groups()
455
- print(" 未变异基线:失败=%d(必须为 0)" % clean)
456
- if clean:
457
- bad.append("未变异基线即失败")
458
- for l in buf0.getvalue().splitlines(): # 基线红项逐条打印(可定位)
459
- if l.strip().startswith("FAIL "):
460
- print(" " + l.strip()[5:])
461
- for name, rel, pairs in _MUTATIONS:
462
- mut_src, miss = _rel_text(rel), []
463
- for old, new in pairs:
464
- if old not in mut_src:
465
- miss.append(old.splitlines()[0].strip()[:48])
466
- continue
467
- mut_src = mut_src.replace(old, new, 1)
468
- if miss:
469
- print(" ANCHOR-MISS %s —— 锚点在 %s 源码里找不到(实现改了却没"
470
- "同步本表):%s" % (name, rel, miss))
471
- anchor_miss.append(name)
472
- continue
473
- try:
474
- globals()["MS"] = _exec_module("md_cg._ms_mut", rel, mut_src)
475
- with contextlib.redirect_stdout(buf := io.StringIO()):
476
- reds = _run_groups()
477
- detail = buf.getvalue()
478
- finally:
479
- globals()["MS"] = _REAL_MS
480
- reds_lines = [l for l in detail.splitlines()
481
- if l.strip().startswith("FAIL ")]
482
- verdict = "红" if reds else "**仍全绿 = 该判据空转**"
483
- print(" %s %-40s 红项=%d %s"
484
- % ("OK " if reds else "MISS ", name, reds, verdict))
485
- for l in reds_lines[:6]:
486
- print(" " + l.strip()[5:])
487
- if not reds:
488
- bad.append(name)
489
- # 恢复证明:全部轮次结束后把真模块放回,重跑一次基线并须全绿。
490
- with contextlib.redirect_stdout(buf1 := io.StringIO()):
491
- restored = _run_groups()
492
- print(" 恢复后基线(真模块):失败=%d(必须为 0)" % restored)
493
- if restored:
494
- bad.append("恢复后基线失败")
495
- if anchor_miss:
496
- print("\nANCHOR-MISS:%s" % "、".join(anchor_miss))
497
- print("退出码 2(fail-closed):变异表锚点漂移即判失败,不得静默跳过")
498
- return 2
499
- print("\n定点变异自证:%s"
500
- % ("PASS(每处机制都有断言把它钉死)" if not bad
501
- else "FAIL —— " + "、".join(bad)))
502
- return 0 if not bad else 1
503
-
504
-
505
- def main() -> int:
506
- _sandbox_env()
507
- try:
508
- if "--mutate" in sys.argv:
509
- return _mutate_mode("--list" in sys.argv)
510
- n = _run_groups()
511
- print("\n状态事件记账写口守卫:%d 通过 / %d 失败" % (len(_PASS), n))
512
- print("SUMMARY: md_cg.test_state_event_op 通过=%d 失败=%d"
513
- % (len(_PASS), n))
514
- return 0 if not n else 1
515
- finally:
516
- _restore_env()
517
- shutil.rmtree(_TMP, ignore_errors=True)
518
-
519
-
520
- if __name__ == "__main__":
521
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """test_state_event_op · cg(op=state_event) 记账写口守卫(P3 批:写侧入口)。
3
+
4
+ 契约:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md` §2「事件是源、槽位是
5
+ 投影、查询走 stg」+ §5②(记账入口形态)。本批把「记账」这一步放到 MCP 面:
6
+ `md_cg/mcp_server.py` 的 cg 基元新增 op=state_event(写口),底层仍是
7
+ `md_cg/state_events.append`(append-only 台账)。
8
+
9
+ 断言分组:
10
+
11
+ A 全链——cg(op=state_event) 写入 → `_state_events.jsonl` 得一行(五元
12
+ subject/slot/old/new/kind + seq/evidence/actor 逐字段)→ 投影
13
+ (state_slots.project)与查询面(stg.state_chain,开关开)可见该事件;
14
+ 台账追加一条变迁后变迁史条数随之增长;经最外层 `call_tool` 的通路同形。
15
+ B 双闸——① op 映射:state_event 映射到既有 "write" 词(受限令牌的拒绝消息
16
+ 点名 op=write 而非 op=state_event;**含 write 不含 state_event** 的白名单
17
+ 令牌可记账);② 写闸 require_write:can_write=False / theory_ok=False /
18
+ clearance 不足三态各自被拒(台账直写盘面、绕过库层节点写闸,故须显式补齐)。
19
+ C 防伪造——请求里塞 actor 参数无效:落盘 actor 恒=令牌 actor(无 principal
20
+ 时="system")。
21
+ D kind 归一——缺省/空串/纯空白 → 落盘 kind=None(「未分类」是合法记账,而
22
+ append 对空串抛 ValueError);显式合法值(含带空白)strip 后透传;非法值
23
+ ValueError 原样上抛。
24
+ E 参数校验——缺/空 subject、缺/空 slot、old/new 双空 → ValueError 原样上抛
25
+ (fail-closed,不吞、不包装);合法撤回(old 有值、new 空)照常通过。
26
+ F 回归——既有 op(info/read/recent 抽查)行为与权限行改动前一致:designer
27
+ 令牌全过、受限令牌该拒的仍拒且消息点名原 op 词;`_ACTION_SIGS` /
28
+ `_ACTION_DEFAULT` 未被本批改动(state_event 无 action 面)。
29
+
30
+ 隔离:全部落临时目录(`tempfile.mkdtemp`);env 里的根变量与投影开关全程置空或
31
+ 指向临时根,令牌签发写临时令牌库,**绝不动在役库/在役令牌库**(本文件不含任何
32
+ 真实数据根路径字面量)。
33
+
34
+ 运行:python -X utf8 -m md_cg.test_state_event_op
35
+ python -X utf8 -m md_cg.test_state_event_op --mutate # 定点变异自证
36
+ python -X utf8 -m md_cg.test_state_event_op --mutate --list # 只列变异表
37
+
38
+ 退出码(fail-closed):0 = 全绿 / 变异自证 PASS;1 = 有断言失败 / 变异未按预期转红;
39
+ 2 = ANCHOR-MISS(变异锚点在当前源码里找不到——实现改了却没同步本表即硬失败)。
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import contextlib
44
+ import io
45
+ import json
46
+ import os
47
+ import shutil
48
+ import sys
49
+ import tempfile
50
+ import types
51
+
52
+ from . import mcp_server
53
+ from . import state_events
54
+ from . import state_slots
55
+ from . import stg
56
+ from . import tokens
57
+ from .mdcos import MdCGOS, MdCGSecure
58
+ from .security import Principal
59
+
60
+ _PASS = []
61
+ _FAIL = []
62
+ _GEN = [0]
63
+ _TMP = tempfile.mkdtemp(prefix="mdcg_se_")
64
+ _SAVED = {}
65
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
66
+ _KEK = os.urandom(32)
67
+ #: 被测写口模块的**可变引用**(定点变异把全局换成变异副本,组内一律经 _ms() 取用)。
68
+ MS = mcp_server
69
+ _REAL_MS = mcp_server
70
+
71
+
72
+ # 生效条件:cond 为真记入 _PASS 并打印 PASS,否则记入 _FAIL 并打印 FAIL(extra 仅在失败时打印,供定位)。
73
+ def ok(cond, msg, extra=""):
74
+ (_PASS if cond else _FAIL).append(msg)
75
+ print((" PASS " if cond else " FAIL ") + msg
76
+ + ((" ← " + str(extra)) if (extra and not cond) else ""))
77
+
78
+
79
+ # 生效条件:无入参;返回当前被测写口模块(未变异=mcp_server 本体,变异轮=内存副本)。
80
+ def _ms():
81
+ return globals()["MS"]
82
+
83
+
84
+ # 生效条件:无入参;把 MDCG_ROOT/MDCG_STATE_ROOT/MDCG_AUX_ROOT/MDCG_DATA_ROOT/MDCG_STG_STATE 的现值存入 _SAVED 并逐个从 os.environ 移除(隔离:任何经 env 取根的路径都不得落到在役库)。
85
+ def _sandbox_env():
86
+ for k in ("MDCG_ROOT", "MDCG_STATE_ROOT", "MDCG_AUX_ROOT", "MDCG_DATA_ROOT",
87
+ "MDCG_STG_STATE"):
88
+ _SAVED[k] = os.environ.get(k)
89
+ os.environ.pop(k, None)
90
+ # #86(令牌运行期复检):把复检读的令牌库钉到本进程隔离库——本件 _principal 的签发/
91
+ # 校验都显式落 _tokfile(),而 mcp_server._runtime_token_recheck 经 tokens.token_file(None)
92
+ # 读 env MDCG_TOKEN_FILE(缺省=在役库);不钉则复检在在役库查不到本库 token_id ⇒
93
+ # A10(最外层 call_tool 通路)被误判「令牌记录已不存在」。_restore_env 依 _SAVED 原样还原。
94
+ _SAVED["MDCG_TOKEN_FILE"] = os.environ.get("MDCG_TOKEN_FILE")
95
+ os.environ["MDCG_TOKEN_FILE"] = _tokfile()
96
+
97
+
98
+ # 生效条件:无入参;把 _SAVED 逐个还原(原值 None 则移除键),恢复进程原有 env 形态。
99
+ def _restore_env():
100
+ for k, v in _SAVED.items():
101
+ if v is None:
102
+ os.environ.pop(k, None)
103
+ else:
104
+ os.environ[k] = v
105
+
106
+
107
+ # 生效条件:无入参;返回本进程专用的临时令牌库文件路径(签发/校验全落 _TMP,不触在役令牌库)。
108
+ def _tokfile():
109
+ return os.path.join(_TMP, "_tokens.json")
110
+
111
+
112
+ # 生效条件:role 为 tokens.ROLE_SPECS 角色名;签发该角色令牌(actor 缺省 evt-<role>)后经 verify_token 取回 Principal;**签发与校验都只落临时令牌库**;未知角色/参数非法时抛原异常(不吞)。
113
+ def _principal(role, actor=None, **kw):
114
+ r = tokens.issue(role, actor=actor or ("evt-" + role), path=_tokfile(),
115
+ _allow_bootstrap=True, **kw) # 测试搭架:签发闸的证明在 test_issue543
116
+ return tokens.verify_token(r["token"], path=_tokfile())
117
+
118
+
119
+ # 生效条件:无入参;在 _TMP 下新建自增代次目录并返回其上的 MdCGOS 实例(**无 principal**——测「无令牌只读面」路径;每调用一个新根,组间零串味)。
120
+ def _plain_cg():
121
+ _GEN[0] += 1
122
+ return MdCGOS(os.path.join(_TMP, "gen%d" % _GEN[0], "root"))
123
+
124
+
125
+ # 生效条件:principal 为 security.Principal 实例;在 _TMP 下新建自增代次目录并返回其上的 MdCGSecure 实例(principal 参与授权判定;master_key 用进程级随机 kek,密钥库落临时根内)。
126
+ def _secure_cg(principal):
127
+ _GEN[0] += 1
128
+ return MdCGSecure(os.path.join(_TMP, "gen%d" % _GEN[0], "root"),
129
+ principal=principal, master_key=_KEK)
130
+
131
+
132
+ # 生效条件:cg 为沙箱实例、a 为 cg 面参数(不含 op);按外层 _cg_call 调 op=state_event 并返回其返回体(op 显式传入,不走 op 推导)。
133
+ def _evt(cg, **a):
134
+ args = {"op": "state_event"}
135
+ args.update(a)
136
+ return _ms()._cg_call(cg, args)
137
+
138
+
139
+ # 生效条件:fn 为无参可调用对象时——正常返回 ("", "");抛异常返回 (异常类型名, 错误文本)。用于「该拒的拒、且拒的理由是哪个类型/哪句话」的断言。
140
+ def _err(fn):
141
+ try:
142
+ fn()
143
+ return "", ""
144
+ except Exception as exc: # noqa: BLE001
145
+ return type(exc).__name__, str(exc)
146
+
147
+
148
+ # 生效条件:cg 为沙箱实例;读取其台账文件并返回逐行 json.loads 的列表(台账缺失 → [];坏行照常抛——守卫只写合法行)。
149
+ def _ledger(cg):
150
+ p = state_events.ledger_path(cg)
151
+ if not os.path.exists(p):
152
+ return []
153
+ with open(p, encoding="utf-8") as f:
154
+ return [json.loads(l) for l in f if l.strip()]
155
+
156
+
157
+ # ---------------------------------------------------------------- A
158
+ # 生效条件:无入参;在自有沙箱根上(designer 令牌 principal)经 cg(op=state_event) 连写两条事件,断言返回体/落盘行/投影/state_chain 四面对齐、开关关臂不抛、最外层 call_tool 通路同形(落点见组内文案)。
159
+ def gA():
160
+ print("== A 全链:记账 → 台账 → 投影 → state_chain ==")
161
+ cg = _secure_cg(_principal("designer", actor="evt-designer"))
162
+ out = _evt(cg, subject="甲", slot="住所", old=None, new="别墅",
163
+ kind="enablement", seq=1, evidence="u1")
164
+ ev = (out or {}).get("event") or {}
165
+ ok(out.get("ok") is True and isinstance(ev, dict),
166
+ "A1 cg(op=state_event) 返回 {ok:true, event:rec}", out)
167
+ ok(ev.get("subject") == "甲" and ev.get("slot") == "住所"
168
+ and ev.get("old") is None and ev.get("new") == "别墅"
169
+ and ev.get("kind") == "enablement" and ev.get("seq") == 1
170
+ and ev.get("evidence") == "u1" and ev.get("actor") == "evt-designer"
171
+ and isinstance(ev.get("t"), (int, float)),
172
+ "A2 event 五元/seq/evidence/actor/t 逐字段", ev)
173
+ lines = _ledger(cg)
174
+ ok(len(lines) == 1, "A3 台账 _state_events.jsonl 恰得一行", len(lines))
175
+ ok(lines and lines[0] == ev,
176
+ "A4 落盘行与返回 event 逐字段相等(落盘记录=append 返回值)",
177
+ (lines, ev))
178
+ units = state_slots.project(cg, subject="甲", slot="住所")
179
+ ok(len(units) == 1 and units[0]["value"] == "别墅"
180
+ and units[0]["state"] == "active" and units[0]["seq_from"] == 1
181
+ and units[0]["t_from"] == ev.get("t"),
182
+ "A5 投影可见:project 得该槽位单元(value/state/seq_from/t_from 对齐)",
183
+ units)
184
+ os.environ["MDCG_STG_STATE"] = "1"
185
+ try:
186
+ chain = stg.state_chain(cg, subject="甲")
187
+ finally:
188
+ os.environ.pop("MDCG_STG_STATE", None)
189
+ ok(chain.get("count") == 1 and chain.get("kept") == 1
190
+ and (chain.get("items") or []) == state_slots.project(cg, subject="甲"),
191
+ "A6 stg(state_chain)(开关开)可见该事件:items 与 project 逐位一致",
192
+ chain)
193
+ off = stg.state_chain(cg)
194
+ ok(off.get("error") == "disabled",
195
+ "A7 开关关 → disabled 体(「没开」与「没命中」可分辨,不抛)", off)
196
+ out2 = _evt(cg, subject="甲", slot="住所", old="别墅", new="小屋",
197
+ kind="migration", seq=2, evidence="u2")
198
+ ok((out2 or {}).get("ok") is True, "A8 第二条(迁移)写入成功", out2)
199
+ units2 = state_slots.project(cg, subject="甲", slot="住所")
200
+ ok(len(units2) == 1 and units2[0]["value"] == "小屋"
201
+ and units2[0]["event_count"] == 2
202
+ and len(units2[0]["history"]) == 2,
203
+ "A9 变迁史:event_count=2、history 两条(台账追加即投影可见)",
204
+ units2)
205
+ via = _ms().call_tool(cg, "cg",
206
+ {"op": "state_event", "subject": "乙", "slot": "住所",
207
+ "new": "帐篷", "seq": 3, "evidence": "u3"})
208
+ ok((via or {}).get("ok") is True
209
+ and (via.get("event") or {}).get("actor") == "evt-designer",
210
+ "A10 经最外层 call_tool(MCP tools/call 通路)同形:ok=true、actor=令牌 actor",
211
+ via)
212
+ ok(len(_ledger(cg)) == 3, "A11 三条事件皆落盘(append-only 不截断)",
213
+ len(_ledger(cg)))
214
+
215
+
216
+ # ---------------------------------------------------------------- B
217
+ # 生效条件:无入参;在自有沙箱根上按三类令牌(受限 ops_allow 无 write / 含 write 不含 state_event / designer 星号)与三种写闸不足(can_write=False / theory_ok=False / clearance 不足)逐条断言拒绝或放行,并校验拒绝消息点名的 op 词(落点见组内文案)。
218
+ def gB():
219
+ print("== B 双闸:op 映射(write 词)+ require_write(三态) ==")
220
+ # ① op 映射:受限令牌(白名单无 write)→ 拒,且消息点名 op=write(不是 op=state_event)
221
+ rcg = _secure_cg(_principal("recorder", actor="evt-restricted",
222
+ ops_allow=["read"]))
223
+ t, txt = _err(lambda: _evt(rcg, subject="甲", slot="住所", new="值"))
224
+ ok(t == "AccessDenied" and "op=write" in txt and "op=state_event" not in txt,
225
+ "B1 受限令牌(ops_allow 无 write)→ AccessDenied 且消息点名 op=write"
226
+ "(映射生效;不引入 state_event 新 op 词)", (t, txt[:120]))
227
+ ok(_ledger(rcg) == [], "B2 被拒时不落盘(台账零行)", _ledger(rcg))
228
+ # ② 含 write 不含 state_event → 可记账(回退成 require_op(op) 则此处转红)
229
+ wcg = _secure_cg(_principal("recorder", actor="evt-writer",
230
+ ops_allow=["read", "write"]))
231
+ out = _evt(wcg, subject="甲", slot="住所", new="值", seq=1, evidence="b2")
232
+ ok(out.get("ok") is True and len(_ledger(wcg)) == 1,
233
+ "B3 白名单含 write 不含 state_event → 放行并落盘(映射到既有 write 词)",
234
+ out)
235
+ # ③ designer(ops_allow 星号)→ 放行
236
+ dcg = _secure_cg(_principal("designer", actor="evt-designer"))
237
+ out = _evt(dcg, subject="甲", slot="住所", new="值", seq=1)
238
+ ok(out.get("ok") is True, "B4 designer(ops_allow=*)→ 放行", out)
239
+ # ④ guest 令牌(can_write=False,白名单无 write)→ op 闸先拒
240
+ gcg = _secure_cg(_principal("guest", actor="evt-guest"))
241
+ t, txt = _err(lambda: _evt(gcg, subject="甲", slot="住所", new="值"))
242
+ ok(t == "AccessDenied" and "op=write" in txt,
243
+ "B5 guest 令牌 → AccessDenied(只读访客照拒)", (t, txt[:120]))
244
+ # ⑤ 写闸·can_write:直接构造「白名单含 write 但 can_write=False」的 principal
245
+ # (角色规格里无此组合,须显式构造——这条正是 require_write 补齐的判据)
246
+ ncg = _secure_cg(Principal(actor="evt-nocw", role="guest", clearance="internal",
247
+ can_write=False, ops_allow=("*",)))
248
+ t, txt = _err(lambda: _evt(ncg, subject="甲", slot="住所", new="值"))
249
+ ok(t == "AccessDenied" and "无写权限" in txt,
250
+ "B6 can_write=False(op 闸放行)→ 被 require_write 拒(写闸显式补齐)",
251
+ (t, txt[:120]))
252
+ ok(_ledger(ncg) == [], "B7 该拒的不落盘", _ledger(ncg))
253
+ # ⑥ 写闸·theory_ok=False
254
+ tcg = _secure_cg(Principal(actor="evt-notheory", clearance="internal",
255
+ can_write=True, ops_allow=("*",),
256
+ theory_ok=False))
257
+ t, txt = _err(lambda: _evt(tcg, subject="甲", slot="住所", new="值"))
258
+ ok(t == "AccessDenied" and "版本层校验未通过" in txt,
259
+ "B8 theory_ok=False → 被拒(版本层校验维度)", (t, txt[:120]))
260
+ # ⑦ 写闸·密级:clearance=public < internal
261
+ scg = _secure_cg(Principal(actor="evt-lowclear", clearance="public",
262
+ can_write=True, ops_allow=("*",)))
263
+ t, txt = _err(lambda: _evt(scg, subject="甲", slot="住所", new="值"))
264
+ ok(t == "AccessDenied" and "clearance" in txt,
265
+ "B9 clearance 不足 internal → 被拒(密级维度)", (t, txt[:120]))
266
+
267
+
268
+ # ---------------------------------------------------------------- C
269
+ # 生效条件:无入参;在自有沙箱根上断言请求里塞 actor 参数不生效:带令牌时落盘 actor 恒=令牌 actor、无 principal 时恒="system"(落点见组内文案)。
270
+ def gC():
271
+ print("== C 防伪造:actor 恒取令牌/系统(请求参数无效) ==")
272
+ cg = _secure_cg(_principal("recorder", actor="evt-real",
273
+ ops_allow=["read", "write"]))
274
+ out = _evt(cg, subject="甲", slot="住所", new="值", seq=1,
275
+ evidence="c1", actor="forger")
276
+ ok((out.get("event") or {}).get("actor") == "evt-real",
277
+ "C1 请求 actor=forger 无效:落盘 actor=令牌 actor", out)
278
+ lines = _ledger(cg)
279
+ ok(lines and lines[0].get("actor") == "evt-real",
280
+ "C2 台账行 actor 逐字=令牌 actor(不落伪造值)", lines)
281
+ pcg = _plain_cg()
282
+ out = _evt(pcg, subject="甲", slot="住所", new="值", seq=1,
283
+ evidence="c3", actor="forger")
284
+ ok((out.get("event") or {}).get("actor") == "system",
285
+ "C3 无 principal:actor 恒=system(也不取请求参数)", out)
286
+
287
+
288
+ # ---------------------------------------------------------------- D
289
+ # 生效条件:无入参;在自有沙箱根上按 kind 的五态(缺省/空串/纯空白/显式合法含空白/非法)逐条断言落盘归一结果或 ValueError 上抛(落点见组内文案)。
290
+ def gD():
291
+ print("== D kind 归一(空串 → None;非法值 fail-closed) ==")
292
+ cg = _secure_cg(_principal("designer", actor="evt-d"))
293
+ out = _evt(cg, subject="甲", slot="s1", new="v1", seq=1)
294
+ ok((out.get("event") or {}).get("kind") is None,
295
+ "D1 缺省 kind → 落盘 None(未分类是合法记账)", out)
296
+ out = _evt(cg, subject="甲", slot="s2", new="v2", seq=2, kind="")
297
+ ok((out.get("event") or {}).get("kind") is None,
298
+ "D2 kind=空串 → 归一 None(不抛 ValueError)", out)
299
+ out = _evt(cg, subject="甲", slot="s3", new="v3", seq=3, kind=" ")
300
+ ok((out.get("event") or {}).get("kind") is None,
301
+ "D3 kind=纯空白 → 归一 None", out)
302
+ out = _evt(cg, subject="甲", slot="s4", new="v4", seq=4, kind="migration")
303
+ ok((out.get("event") or {}).get("kind") == "migration",
304
+ "D4 显式合法值透传", out)
305
+ out = _evt(cg, subject="甲", slot="s5", new="v5", seq=5, kind=" migration ")
306
+ ok((out.get("event") or {}).get("kind") == "migration",
307
+ "D5 带空白合法值 strip 后透传", out)
308
+ t, txt = _err(lambda: _evt(cg, subject="甲", slot="s6", new="v6",
309
+ kind="bogus"))
310
+ ok(t == "ValueError" and "bogus" in txt,
311
+ "D6 非法 kind → ValueError 原样上抛(fail-closed)", (t, txt[:120]))
312
+ ok(len(_ledger(cg)) == 5, "D7 只有合法五条落盘(非法值不落盘)",
313
+ len(_ledger(cg)))
314
+
315
+
316
+ # ---------------------------------------------------------------- E
317
+ # 生效条件:无入参;在自有沙箱根上按 subject/slot/old-new 组合逐条断言 ValueError 原样上抛(不包装、不吞)与合法撤回照常通过(落点见组内文案)。
318
+ def gE():
319
+ print("== E 参数校验(ValueError 原样上抛) ==")
320
+ cg = _secure_cg(_principal("designer", actor="evt-e"))
321
+ t, txt = _err(lambda: _evt(cg, slot="住所", new="值"))
322
+ ok(t == "ValueError" and "subject" in txt,
323
+ "E1 缺 subject → ValueError(点名 subject)", (t, txt[:120]))
324
+ t, txt = _err(lambda: _evt(cg, subject=" ", slot="住所", new="值"))
325
+ ok(t == "ValueError" and "subject" in txt,
326
+ "E2 subject 纯空白 → ValueError", (t, txt[:120]))
327
+ t, txt = _err(lambda: _evt(cg, subject="甲", new="值"))
328
+ ok(t == "ValueError" and "slot" in txt,
329
+ "E3 缺 slot → ValueError(点名 slot)", (t, txt[:120]))
330
+ t, txt = _err(lambda: _evt(cg, subject="甲", slot=" ", new="值"))
331
+ ok(t == "ValueError" and "slot" in txt,
332
+ "E4 slot 纯空白 → ValueError", (t, txt[:120]))
333
+ t, txt = _err(lambda: _evt(cg, subject="甲", slot="住所"))
334
+ ok(t == "ValueError" and "old" in txt and "new" in txt,
335
+ "E5 old/new 双空(缺省)→ ValueError", (t, txt[:120]))
336
+ t, txt = _err(lambda: _evt(cg, subject="甲", slot="住所",
337
+ old=None, new=None))
338
+ ok(t == "ValueError", "E6 old/new 显式双 None → ValueError", (t, txt[:120]))
339
+ out = _evt(cg, subject="甲", slot="住所", old="旧值", new=None,
340
+ kind="retraction", seq=9, evidence="e7")
341
+ ok(out.get("ok") is True
342
+ and (out.get("event") or {}).get("new") is None
343
+ and (out.get("event") or {}).get("old") == "旧值",
344
+ "E7 合法撤回(old 有值、new 空)照常通过", out)
345
+ ok(len(_ledger(cg)) == 1,
346
+ "E8 校验失败的各次均未落盘(台账仅合法撤回一条)", len(_ledger(cg)))
347
+
348
+
349
+ # ---------------------------------------------------------------- F
350
+ # 生效条件:无入参;在自有沙箱根上断言既有 op(info/read/recent/未知 op)与受限令牌拒绝路径行为不变(消息点名原 op 词)、无 principal 只读面照常、_ACTION_SIGS/_ACTION_DEFAULT 未被本批改动(落点见组内文案)。
351
+ def gF():
352
+ print("== F 回归:既有 op 行为与权限行改动前一致 ==")
353
+ dcg = _secure_cg(_principal("designer", actor="evt-reg"))
354
+ r = _err(lambda: _ms()._cg_call(dcg, {"op": "info"}))
355
+ ok(r[0] == "", "F1 designer:op=info 放行(无异常)", r)
356
+ r = _err(lambda: _ms()._cg_call(dcg, {"op": "read", "query": "回归"}))
357
+ ok(r[0] == "", "F2 designer:op=read 放行", r)
358
+ r = _err(lambda: _ms()._cg_call(dcg, {"op": "recent",
359
+ "action": "list"}))
360
+ ok(r[0] == "", "F3 designer:op=recent/list 放行", r)
361
+ t, txt = _err(lambda: _ms()._cg_call(dcg, {"op": "no_such_op"}))
362
+ ok(t == "ValueError",
363
+ "F4 designer:未识别 op 仍走 ValueError 兜底(分发尾部不变)",
364
+ (t, txt[:100]))
365
+ rcg = _secure_cg(_principal("recorder", actor="evt-reg2",
366
+ ops_allow=["read"]))
367
+ r = _err(lambda: _ms()._cg_call(rcg, {"op": "read", "query": "回归"}))
368
+ ok(r[0] == "", "F5 受限令牌:白名单内 op=read 放行", r)
369
+ t, txt = _err(lambda: _ms()._cg_call(rcg, {"op": "whitebox",
370
+ "action": "ping"}))
371
+ ok(t == "AccessDenied" and "op=whitebox" in txt,
372
+ "F6 受限令牌:白名单外 op=whitebox 拒且消息点名 op=whitebox"
373
+ "(非 state_event 的 op 词逐位不变)", (t, txt[:120]))
374
+ t, txt = _err(lambda: _ms()._cg_call(rcg, {"op": "write", "node_id": "x",
375
+ "content": "y"}))
376
+ ok(t == "AccessDenied" and "op=write" in txt,
377
+ "F7 受限令牌:白名单外 op=write 拒(既有写面拒绝行为不变)",
378
+ (t, txt[:120]))
379
+ pcg = _plain_cg()
380
+ r = _err(lambda: _ms()._cg_call(pcg, {"op": "read", "query": "回归"}))
381
+ ok(r[0] == "", "F8 无 principal(MdCGOS):只读面照常(闸门跳过路径不变)", r)
382
+ ok("state_event" not in _ms()._ACTION_SIGS
383
+ and "state_event" not in _ms()._ACTION_DEFAULT,
384
+ "F9 state_event 无 action 面(_ACTION_SIGS/_ACTION_DEFAULT 未动)",
385
+ (sorted(_ms()._ACTION_SIGS), sorted(_ms()._ACTION_DEFAULT)))
386
+
387
+
388
+ _GROUPS = (gA, gB, gC, gD, gE, gF)
389
+
390
+
391
+ # 生效条件:无入参;逐组执行 _GROUPS(每组自行建沙箱根),组内抛异常记为一条失败并把栈尾打印出来(不中断其余组),返回失败条数。
392
+ def _run_groups() -> int:
393
+ _PASS.clear()
394
+ _FAIL.clear()
395
+ for g in _GROUPS:
396
+ try:
397
+ g()
398
+ except Exception as exc: # noqa: BLE001
399
+ ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
400
+ import traceback
401
+ print(traceback.format_exc()[-900:])
402
+ return len(_FAIL)
403
+
404
+
405
+ # ---------------------------------------------------------------- 变异表
406
+ # 锚点 = (名字, rel, ((old, new), …))。每条必须让套件**转红**(红项原文由 --mutate 打印):
407
+ # M1 权限映射回退(require_op(op),state_event 失去 write 词映射)→ B1/B3 红
408
+ # M2 actor 改取请求参数(防伪造失效)→ C1/C2/C3 红
409
+ # M3 kind 不归一(空串直传,append 对空串抛 ValueError)→ D2/D3 红
410
+ # M4 删写闸 require_write(can_write=False 不再拦)→ B6/B7 红
411
+ _MUTATIONS = (
412
+ ("权限映射回退(state_event 不再映射到 write 词)", "md_cg/mcp_server.py",
413
+ ((' _p.require_op("write" if op == "state_event" else op)',
414
+ ' _p.require_op(op)'),)),
415
+ ("actor 改取请求参数(防伪造失效)", "md_cg/mcp_server.py",
416
+ ((' from . import state_events as _se\n'
417
+ ' _actor = _p.actor if _p is not None else "system"',
418
+ ' from . import state_events as _se\n'
419
+ ' _actor = a.get("actor") or (_p.actor if _p is not None else "system")'),)),
420
+ ("kind 不归一(空串直传)", "md_cg/mcp_server.py",
421
+ ((' kind=(a.get("kind") or "").strip() or None,',
422
+ ' kind=a.get("kind"),'),)),
423
+ ("删写闸 require_write(can_write 不再拦)", "md_cg/mcp_server.py",
424
+ ((' if _p is not None:\n _p.require_write("internal")\n',
425
+ ' if False:\n _p.require_write("internal")\n'),)),
426
+ )
427
+
428
+
429
+ # 生效条件:rel 为仓根相对路径时返回该文件的当前源码文本(每次从盘读,不缓存——变异基线必须是**当前工作区**实现)。
430
+ def _rel_text(rel: str) -> str:
431
+ with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
432
+ return f.read()
433
+
434
+
435
+ # 生效条件:name/rel/text 给定时——把 text 以 __package__="md_cg"、__file__=<仓内 rel 路径> 执行成命名空间并包成新模块对象返回(不注册 sys.modules、不触发 __main__;语法错误原样抛)。
436
+ def _exec_module(name: str, rel: str, text: str):
437
+ ns = {"__name__": name, "__package__": "md_cg",
438
+ "__file__": os.path.join(_REPO, rel)}
439
+ exec(compile(text, rel, "exec"), ns) # noqa: S102 —— 基线自证用
440
+ m = types.ModuleType(name)
441
+ m.__dict__.update(ns)
442
+ return m
443
+
444
+
445
+ # 生效条件:list_only 为真时只打印变异表并返回 0;否则先跑未变异基线(必须 0 失败),再逐条在**内存副本**上注入变异(逐锚点 replace,锚点缺失记 ANCHOR-MISS)后重跑整套分组——有红项记 OK、无红项记 MISS(空转即失败);全部锚点命中有红项时返回 0、否则 1;有 ANCHOR-MISS 时返回 2(fail-closed)。
446
+ def _mutate_mode(list_only: bool = False) -> int:
447
+ print("!! 定点变异自证:逐条把机制改回「错误/缺陷」形态,套件必须转红\n")
448
+ if list_only:
449
+ for name, rel, _pairs in _MUTATIONS:
450
+ print(" %-40s [%s]" % (name, rel))
451
+ return 0
452
+ anchor_miss, bad = [], []
453
+ with contextlib.redirect_stdout(buf0 := io.StringIO()):
454
+ clean = _run_groups()
455
+ print(" 未变异基线:失败=%d(必须为 0)" % clean)
456
+ if clean:
457
+ bad.append("未变异基线即失败")
458
+ for l in buf0.getvalue().splitlines(): # 基线红项逐条打印(可定位)
459
+ if l.strip().startswith("FAIL "):
460
+ print(" " + l.strip()[5:])
461
+ for name, rel, pairs in _MUTATIONS:
462
+ mut_src, miss = _rel_text(rel), []
463
+ for old, new in pairs:
464
+ if old not in mut_src:
465
+ miss.append(old.splitlines()[0].strip()[:48])
466
+ continue
467
+ mut_src = mut_src.replace(old, new, 1)
468
+ if miss:
469
+ print(" ANCHOR-MISS %s —— 锚点在 %s 源码里找不到(实现改了却没"
470
+ "同步本表):%s" % (name, rel, miss))
471
+ anchor_miss.append(name)
472
+ continue
473
+ try:
474
+ globals()["MS"] = _exec_module("md_cg._ms_mut", rel, mut_src)
475
+ with contextlib.redirect_stdout(buf := io.StringIO()):
476
+ reds = _run_groups()
477
+ detail = buf.getvalue()
478
+ finally:
479
+ globals()["MS"] = _REAL_MS
480
+ reds_lines = [l for l in detail.splitlines()
481
+ if l.strip().startswith("FAIL ")]
482
+ verdict = "红" if reds else "**仍全绿 = 该判据空转**"
483
+ print(" %s %-40s 红项=%d %s"
484
+ % ("OK " if reds else "MISS ", name, reds, verdict))
485
+ for l in reds_lines[:6]:
486
+ print(" " + l.strip()[5:])
487
+ if not reds:
488
+ bad.append(name)
489
+ # 恢复证明:全部轮次结束后把真模块放回,重跑一次基线并须全绿。
490
+ with contextlib.redirect_stdout(buf1 := io.StringIO()):
491
+ restored = _run_groups()
492
+ print(" 恢复后基线(真模块):失败=%d(必须为 0)" % restored)
493
+ if restored:
494
+ bad.append("恢复后基线失败")
495
+ if anchor_miss:
496
+ print("\nANCHOR-MISS:%s" % "、".join(anchor_miss))
497
+ print("退出码 2(fail-closed):变异表锚点漂移即判失败,不得静默跳过")
498
+ return 2
499
+ print("\n定点变异自证:%s"
500
+ % ("PASS(每处机制都有断言把它钉死)" if not bad
501
+ else "FAIL —— " + "、".join(bad)))
502
+ return 0 if not bad else 1
503
+
504
+
505
+ def main() -> int:
506
+ _sandbox_env()
507
+ try:
508
+ if "--mutate" in sys.argv:
509
+ return _mutate_mode("--list" in sys.argv)
510
+ n = _run_groups()
511
+ print("\n状态事件记账写口守卫:%d 通过 / %d 失败" % (len(_PASS), n))
512
+ print("SUMMARY: md_cg.test_state_event_op 通过=%d 失败=%d"
513
+ % (len(_PASS), n))
514
+ return 0 if not n else 1
515
+ finally:
516
+ _restore_env()
517
+ shutil.rmtree(_TMP, ignore_errors=True)
518
+
519
+
520
+ if __name__ == "__main__":
521
+ sys.exit(main())