@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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 (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,514 +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
-
91
-
92
- # 生效条件:无入参;把 _SAVED 逐个还原(原值 None 则移除键),恢复进程原有 env 形态。
93
- def _restore_env():
94
- for k, v in _SAVED.items():
95
- if v is None:
96
- os.environ.pop(k, None)
97
- else:
98
- os.environ[k] = v
99
-
100
-
101
- # 生效条件:无入参;返回本进程专用的临时令牌库文件路径(签发/校验全落 _TMP,不触在役令牌库)。
102
- def _tokfile():
103
- return os.path.join(_TMP, "_tokens.json")
104
-
105
-
106
- # 生效条件:role 为 tokens.ROLE_SPECS 角色名;签发该角色令牌(actor 缺省 evt-<role>)后经 verify_token 取回 Principal;**签发与校验都只落临时令牌库**;未知角色/参数非法时抛原异常(不吞)。
107
- def _principal(role, actor=None, **kw):
108
- r = tokens.issue(role, actor=actor or ("evt-" + role), path=_tokfile(), **kw)
109
- return tokens.verify_token(r["token"], path=_tokfile())
110
-
111
-
112
- # 生效条件:无入参;在 _TMP 下新建自增代次目录并返回其上的 MdCGOS 实例(**无 principal**——测「无令牌只读面」路径;每调用一个新根,组间零串味)。
113
- def _plain_cg():
114
- _GEN[0] += 1
115
- return MdCGOS(os.path.join(_TMP, "gen%d" % _GEN[0], "root"))
116
-
117
-
118
- # 生效条件:principal 为 security.Principal 实例;在 _TMP 下新建自增代次目录并返回其上的 MdCGSecure 实例(principal 参与授权判定;master_key 用进程级随机 kek,密钥库落临时根内)。
119
- def _secure_cg(principal):
120
- _GEN[0] += 1
121
- return MdCGSecure(os.path.join(_TMP, "gen%d" % _GEN[0], "root"),
122
- principal=principal, master_key=_KEK)
123
-
124
-
125
- # 生效条件:cg 为沙箱实例、a 为 cg 面参数(不含 op);按外层 _cg_call 调 op=state_event 并返回其返回体(op 显式传入,不走 op 推导)。
126
- def _evt(cg, **a):
127
- args = {"op": "state_event"}
128
- args.update(a)
129
- return _ms()._cg_call(cg, args)
130
-
131
-
132
- # 生效条件:fn 为无参可调用对象时——正常返回 ("", "");抛异常返回 (异常类型名, 错误文本)。用于「该拒的拒、且拒的理由是哪个类型/哪句话」的断言。
133
- def _err(fn):
134
- try:
135
- fn()
136
- return "", ""
137
- except Exception as exc: # noqa: BLE001
138
- return type(exc).__name__, str(exc)
139
-
140
-
141
- # 生效条件:cg 为沙箱实例;读取其台账文件并返回逐行 json.loads 的列表(台账缺失 → [];坏行照常抛——守卫只写合法行)。
142
- def _ledger(cg):
143
- p = state_events.ledger_path(cg)
144
- if not os.path.exists(p):
145
- return []
146
- with open(p, encoding="utf-8") as f:
147
- return [json.loads(l) for l in f if l.strip()]
148
-
149
-
150
- # ---------------------------------------------------------------- A
151
- # 生效条件:无入参;在自有沙箱根上(designer 令牌 principal)经 cg(op=state_event) 连写两条事件,断言返回体/落盘行/投影/state_chain 四面对齐、开关关臂不抛、最外层 call_tool 通路同形(落点见组内文案)。
152
- def gA():
153
- print("== A 全链:记账 → 台账 → 投影 → state_chain ==")
154
- cg = _secure_cg(_principal("designer", actor="evt-designer"))
155
- out = _evt(cg, subject="甲", slot="住所", old=None, new="别墅",
156
- kind="enablement", seq=1, evidence="u1")
157
- ev = (out or {}).get("event") or {}
158
- ok(out.get("ok") is True and isinstance(ev, dict),
159
- "A1 cg(op=state_event) 返回 {ok:true, event:rec}", out)
160
- ok(ev.get("subject") == "甲" and ev.get("slot") == "住所"
161
- and ev.get("old") is None and ev.get("new") == "别墅"
162
- and ev.get("kind") == "enablement" and ev.get("seq") == 1
163
- and ev.get("evidence") == "u1" and ev.get("actor") == "evt-designer"
164
- and isinstance(ev.get("t"), (int, float)),
165
- "A2 event 五元/seq/evidence/actor/t 逐字段", ev)
166
- lines = _ledger(cg)
167
- ok(len(lines) == 1, "A3 台账 _state_events.jsonl 恰得一行", len(lines))
168
- ok(lines and lines[0] == ev,
169
- "A4 落盘行与返回 event 逐字段相等(落盘记录=append 返回值)",
170
- (lines, ev))
171
- units = state_slots.project(cg, subject="甲", slot="住所")
172
- ok(len(units) == 1 and units[0]["value"] == "别墅"
173
- and units[0]["state"] == "active" and units[0]["seq_from"] == 1
174
- and units[0]["t_from"] == ev.get("t"),
175
- "A5 投影可见:project 得该槽位单元(value/state/seq_from/t_from 对齐)",
176
- units)
177
- os.environ["MDCG_STG_STATE"] = "1"
178
- try:
179
- chain = stg.state_chain(cg, subject="甲")
180
- finally:
181
- os.environ.pop("MDCG_STG_STATE", None)
182
- ok(chain.get("count") == 1 and chain.get("kept") == 1
183
- and (chain.get("items") or []) == state_slots.project(cg, subject="甲"),
184
- "A6 stg(state_chain)(开关开)可见该事件:items 与 project 逐位一致",
185
- chain)
186
- off = stg.state_chain(cg)
187
- ok(off.get("error") == "disabled",
188
- "A7 开关关 → disabled 体(「没开」与「没命中」可分辨,不抛)", off)
189
- out2 = _evt(cg, subject="甲", slot="住所", old="别墅", new="小屋",
190
- kind="migration", seq=2, evidence="u2")
191
- ok((out2 or {}).get("ok") is True, "A8 第二条(迁移)写入成功", out2)
192
- units2 = state_slots.project(cg, subject="甲", slot="住所")
193
- ok(len(units2) == 1 and units2[0]["value"] == "小屋"
194
- and units2[0]["event_count"] == 2
195
- and len(units2[0]["history"]) == 2,
196
- "A9 变迁史:event_count=2、history 两条(台账追加即投影可见)",
197
- units2)
198
- via = _ms().call_tool(cg, "cg",
199
- {"op": "state_event", "subject": "乙", "slot": "住所",
200
- "new": "帐篷", "seq": 3, "evidence": "u3"})
201
- ok((via or {}).get("ok") is True
202
- and (via.get("event") or {}).get("actor") == "evt-designer",
203
- "A10 经最外层 call_tool(MCP tools/call 通路)同形:ok=true、actor=令牌 actor",
204
- via)
205
- ok(len(_ledger(cg)) == 3, "A11 三条事件皆落盘(append-only 不截断)",
206
- len(_ledger(cg)))
207
-
208
-
209
- # ---------------------------------------------------------------- B
210
- # 生效条件:无入参;在自有沙箱根上按三类令牌(受限 ops_allow 无 write / 含 write 不含 state_event / designer 星号)与三种写闸不足(can_write=False / theory_ok=False / clearance 不足)逐条断言拒绝或放行,并校验拒绝消息点名的 op 词(落点见组内文案)。
211
- def gB():
212
- print("== B 双闸:op 映射(write 词)+ require_write(三态) ==")
213
- # ① op 映射:受限令牌(白名单无 write)→ 拒,且消息点名 op=write(不是 op=state_event)
214
- rcg = _secure_cg(_principal("recorder", actor="evt-restricted",
215
- ops_allow=["read"]))
216
- t, txt = _err(lambda: _evt(rcg, subject="甲", slot="住所", new="值"))
217
- ok(t == "AccessDenied" and "op=write" in txt and "op=state_event" not in txt,
218
- "B1 受限令牌(ops_allow 无 write)→ AccessDenied 且消息点名 op=write"
219
- "(映射生效;不引入 state_event 新 op 词)", (t, txt[:120]))
220
- ok(_ledger(rcg) == [], "B2 被拒时不落盘(台账零行)", _ledger(rcg))
221
- # ② 含 write 不含 state_event → 可记账(回退成 require_op(op) 则此处转红)
222
- wcg = _secure_cg(_principal("recorder", actor="evt-writer",
223
- ops_allow=["read", "write"]))
224
- out = _evt(wcg, subject="甲", slot="住所", new="值", seq=1, evidence="b2")
225
- ok(out.get("ok") is True and len(_ledger(wcg)) == 1,
226
- "B3 白名单含 write 不含 state_event → 放行并落盘(映射到既有 write 词)",
227
- out)
228
- # ③ designer(ops_allow 星号)→ 放行
229
- dcg = _secure_cg(_principal("designer", actor="evt-designer"))
230
- out = _evt(dcg, subject="甲", slot="住所", new="值", seq=1)
231
- ok(out.get("ok") is True, "B4 designer(ops_allow=*)→ 放行", out)
232
- # ④ guest 令牌(can_write=False,白名单无 write)→ op 闸先拒
233
- gcg = _secure_cg(_principal("guest", actor="evt-guest"))
234
- t, txt = _err(lambda: _evt(gcg, subject="甲", slot="住所", new="值"))
235
- ok(t == "AccessDenied" and "op=write" in txt,
236
- "B5 guest 令牌 → AccessDenied(只读访客照拒)", (t, txt[:120]))
237
- # ⑤ 写闸·can_write:直接构造「白名单含 write 但 can_write=False」的 principal
238
- # (角色规格里无此组合,须显式构造——这条正是 require_write 补齐的判据)
239
- ncg = _secure_cg(Principal(actor="evt-nocw", role="guest", clearance="internal",
240
- can_write=False, ops_allow=("*",)))
241
- t, txt = _err(lambda: _evt(ncg, subject="甲", slot="住所", new="值"))
242
- ok(t == "AccessDenied" and "无写权限" in txt,
243
- "B6 can_write=False(op 闸放行)→ 被 require_write 拒(写闸显式补齐)",
244
- (t, txt[:120]))
245
- ok(_ledger(ncg) == [], "B7 该拒的不落盘", _ledger(ncg))
246
- # ⑥ 写闸·theory_ok=False
247
- tcg = _secure_cg(Principal(actor="evt-notheory", clearance="internal",
248
- can_write=True, ops_allow=("*",),
249
- theory_ok=False))
250
- t, txt = _err(lambda: _evt(tcg, subject="甲", slot="住所", new="值"))
251
- ok(t == "AccessDenied" and "版本层校验未通过" in txt,
252
- "B8 theory_ok=False → 被拒(版本层校验维度)", (t, txt[:120]))
253
- # ⑦ 写闸·密级:clearance=public < internal
254
- scg = _secure_cg(Principal(actor="evt-lowclear", clearance="public",
255
- can_write=True, ops_allow=("*",)))
256
- t, txt = _err(lambda: _evt(scg, subject="甲", slot="住所", new="值"))
257
- ok(t == "AccessDenied" and "clearance" in txt,
258
- "B9 clearance 不足 internal → 被拒(密级维度)", (t, txt[:120]))
259
-
260
-
261
- # ---------------------------------------------------------------- C
262
- # 生效条件:无入参;在自有沙箱根上断言请求里塞 actor 参数不生效:带令牌时落盘 actor 恒=令牌 actor、无 principal 时恒="system"(落点见组内文案)。
263
- def gC():
264
- print("== C 防伪造:actor 恒取令牌/系统(请求参数无效) ==")
265
- cg = _secure_cg(_principal("recorder", actor="evt-real",
266
- ops_allow=["read", "write"]))
267
- out = _evt(cg, subject="甲", slot="住所", new="值", seq=1,
268
- evidence="c1", actor="forger")
269
- ok((out.get("event") or {}).get("actor") == "evt-real",
270
- "C1 请求 actor=forger 无效:落盘 actor=令牌 actor", out)
271
- lines = _ledger(cg)
272
- ok(lines and lines[0].get("actor") == "evt-real",
273
- "C2 台账行 actor 逐字=令牌 actor(不落伪造值)", lines)
274
- pcg = _plain_cg()
275
- out = _evt(pcg, subject="甲", slot="住所", new="值", seq=1,
276
- evidence="c3", actor="forger")
277
- ok((out.get("event") or {}).get("actor") == "system",
278
- "C3 无 principal:actor 恒=system(也不取请求参数)", out)
279
-
280
-
281
- # ---------------------------------------------------------------- D
282
- # 生效条件:无入参;在自有沙箱根上按 kind 的五态(缺省/空串/纯空白/显式合法含空白/非法)逐条断言落盘归一结果或 ValueError 上抛(落点见组内文案)。
283
- def gD():
284
- print("== D kind 归一(空串 → None;非法值 fail-closed) ==")
285
- cg = _secure_cg(_principal("designer", actor="evt-d"))
286
- out = _evt(cg, subject="甲", slot="s1", new="v1", seq=1)
287
- ok((out.get("event") or {}).get("kind") is None,
288
- "D1 缺省 kind → 落盘 None(未分类是合法记账)", out)
289
- out = _evt(cg, subject="甲", slot="s2", new="v2", seq=2, kind="")
290
- ok((out.get("event") or {}).get("kind") is None,
291
- "D2 kind=空串 → 归一 None(不抛 ValueError)", out)
292
- out = _evt(cg, subject="甲", slot="s3", new="v3", seq=3, kind=" ")
293
- ok((out.get("event") or {}).get("kind") is None,
294
- "D3 kind=纯空白 → 归一 None", out)
295
- out = _evt(cg, subject="甲", slot="s4", new="v4", seq=4, kind="migration")
296
- ok((out.get("event") or {}).get("kind") == "migration",
297
- "D4 显式合法值透传", out)
298
- out = _evt(cg, subject="甲", slot="s5", new="v5", seq=5, kind=" migration ")
299
- ok((out.get("event") or {}).get("kind") == "migration",
300
- "D5 带空白合法值 strip 后透传", out)
301
- t, txt = _err(lambda: _evt(cg, subject="甲", slot="s6", new="v6",
302
- kind="bogus"))
303
- ok(t == "ValueError" and "bogus" in txt,
304
- "D6 非法 kind → ValueError 原样上抛(fail-closed)", (t, txt[:120]))
305
- ok(len(_ledger(cg)) == 5, "D7 只有合法五条落盘(非法值不落盘)",
306
- len(_ledger(cg)))
307
-
308
-
309
- # ---------------------------------------------------------------- E
310
- # 生效条件:无入参;在自有沙箱根上按 subject/slot/old-new 组合逐条断言 ValueError 原样上抛(不包装、不吞)与合法撤回照常通过(落点见组内文案)。
311
- def gE():
312
- print("== E 参数校验(ValueError 原样上抛) ==")
313
- cg = _secure_cg(_principal("designer", actor="evt-e"))
314
- t, txt = _err(lambda: _evt(cg, slot="住所", new="值"))
315
- ok(t == "ValueError" and "subject" in txt,
316
- "E1 缺 subject → ValueError(点名 subject)", (t, txt[:120]))
317
- t, txt = _err(lambda: _evt(cg, subject=" ", slot="住所", new="值"))
318
- ok(t == "ValueError" and "subject" in txt,
319
- "E2 subject 纯空白 → ValueError", (t, txt[:120]))
320
- t, txt = _err(lambda: _evt(cg, subject="甲", new="值"))
321
- ok(t == "ValueError" and "slot" in txt,
322
- "E3 缺 slot → ValueError(点名 slot)", (t, txt[:120]))
323
- t, txt = _err(lambda: _evt(cg, subject="甲", slot=" ", new="值"))
324
- ok(t == "ValueError" and "slot" in txt,
325
- "E4 slot 纯空白 → ValueError", (t, txt[:120]))
326
- t, txt = _err(lambda: _evt(cg, subject="甲", slot="住所"))
327
- ok(t == "ValueError" and "old" in txt and "new" in txt,
328
- "E5 old/new 双空(缺省)→ ValueError", (t, txt[:120]))
329
- t, txt = _err(lambda: _evt(cg, subject="甲", slot="住所",
330
- old=None, new=None))
331
- ok(t == "ValueError", "E6 old/new 显式双 None → ValueError", (t, txt[:120]))
332
- out = _evt(cg, subject="甲", slot="住所", old="旧值", new=None,
333
- kind="retraction", seq=9, evidence="e7")
334
- ok(out.get("ok") is True
335
- and (out.get("event") or {}).get("new") is None
336
- and (out.get("event") or {}).get("old") == "旧值",
337
- "E7 合法撤回(old 有值、new 空)照常通过", out)
338
- ok(len(_ledger(cg)) == 1,
339
- "E8 校验失败的各次均未落盘(台账仅合法撤回一条)", len(_ledger(cg)))
340
-
341
-
342
- # ---------------------------------------------------------------- F
343
- # 生效条件:无入参;在自有沙箱根上断言既有 op(info/read/recent/未知 op)与受限令牌拒绝路径行为不变(消息点名原 op 词)、无 principal 只读面照常、_ACTION_SIGS/_ACTION_DEFAULT 未被本批改动(落点见组内文案)。
344
- def gF():
345
- print("== F 回归:既有 op 行为与权限行改动前一致 ==")
346
- dcg = _secure_cg(_principal("designer", actor="evt-reg"))
347
- r = _err(lambda: _ms()._cg_call(dcg, {"op": "info"}))
348
- ok(r[0] == "", "F1 designer:op=info 放行(无异常)", r)
349
- r = _err(lambda: _ms()._cg_call(dcg, {"op": "read", "query": "回归"}))
350
- ok(r[0] == "", "F2 designer:op=read 放行", r)
351
- r = _err(lambda: _ms()._cg_call(dcg, {"op": "recent",
352
- "action": "list"}))
353
- ok(r[0] == "", "F3 designer:op=recent/list 放行", r)
354
- t, txt = _err(lambda: _ms()._cg_call(dcg, {"op": "no_such_op"}))
355
- ok(t == "ValueError",
356
- "F4 designer:未识别 op 仍走 ValueError 兜底(分发尾部不变)",
357
- (t, txt[:100]))
358
- rcg = _secure_cg(_principal("recorder", actor="evt-reg2",
359
- ops_allow=["read"]))
360
- r = _err(lambda: _ms()._cg_call(rcg, {"op": "read", "query": "回归"}))
361
- ok(r[0] == "", "F5 受限令牌:白名单内 op=read 放行", r)
362
- t, txt = _err(lambda: _ms()._cg_call(rcg, {"op": "whitebox",
363
- "action": "ping"}))
364
- ok(t == "AccessDenied" and "op=whitebox" in txt,
365
- "F6 受限令牌:白名单外 op=whitebox 拒且消息点名 op=whitebox"
366
- "(非 state_event 的 op 词逐位不变)", (t, txt[:120]))
367
- t, txt = _err(lambda: _ms()._cg_call(rcg, {"op": "write", "node_id": "x",
368
- "content": "y"}))
369
- ok(t == "AccessDenied" and "op=write" in txt,
370
- "F7 受限令牌:白名单外 op=write 拒(既有写面拒绝行为不变)",
371
- (t, txt[:120]))
372
- pcg = _plain_cg()
373
- r = _err(lambda: _ms()._cg_call(pcg, {"op": "read", "query": "回归"}))
374
- ok(r[0] == "", "F8 无 principal(MdCGOS):只读面照常(闸门跳过路径不变)", r)
375
- ok("state_event" not in _ms()._ACTION_SIGS
376
- and "state_event" not in _ms()._ACTION_DEFAULT,
377
- "F9 state_event 无 action 面(_ACTION_SIGS/_ACTION_DEFAULT 未动)",
378
- (sorted(_ms()._ACTION_SIGS), sorted(_ms()._ACTION_DEFAULT)))
379
-
380
-
381
- _GROUPS = (gA, gB, gC, gD, gE, gF)
382
-
383
-
384
- # 生效条件:无入参;逐组执行 _GROUPS(每组自行建沙箱根),组内抛异常记为一条失败并把栈尾打印出来(不中断其余组),返回失败条数。
385
- def _run_groups() -> int:
386
- _PASS.clear()
387
- _FAIL.clear()
388
- for g in _GROUPS:
389
- try:
390
- g()
391
- except Exception as exc: # noqa: BLE001
392
- ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
393
- import traceback
394
- print(traceback.format_exc()[-900:])
395
- return len(_FAIL)
396
-
397
-
398
- # ---------------------------------------------------------------- 变异表
399
- # 锚点 = (名字, rel, ((old, new), …))。每条必须让套件**转红**(红项原文由 --mutate 打印):
400
- # M1 权限映射回退(require_op(op),state_event 失去 write 词映射)→ B1/B3 红
401
- # M2 actor 改取请求参数(防伪造失效)→ C1/C2/C3 红
402
- # M3 kind 不归一(空串直传,append 对空串抛 ValueError)→ D2/D3 红
403
- # M4 删写闸 require_write(can_write=False 不再拦)→ B6/B7 红
404
- _MUTATIONS = (
405
- ("权限映射回退(state_event 不再映射到 write 词)", "md_cg/mcp_server.py",
406
- ((' _p.require_op("write" if op == "state_event" else op)',
407
- ' _p.require_op(op)'),)),
408
- ("actor 改取请求参数(防伪造失效)", "md_cg/mcp_server.py",
409
- ((' from . import state_events as _se\n'
410
- ' _actor = _p.actor if _p is not None else "system"',
411
- ' from . import state_events as _se\n'
412
- ' _actor = a.get("actor") or (_p.actor if _p is not None else "system")'),)),
413
- ("kind 不归一(空串直传)", "md_cg/mcp_server.py",
414
- ((' kind=(a.get("kind") or "").strip() or None,',
415
- ' kind=a.get("kind"),'),)),
416
- ("删写闸 require_write(can_write 不再拦)", "md_cg/mcp_server.py",
417
- ((' if _p is not None:\n _p.require_write("internal")\n',
418
- ' if False:\n _p.require_write("internal")\n'),)),
419
- )
420
-
421
-
422
- # 生效条件:rel 为仓根相对路径时返回该文件的当前源码文本(每次从盘读,不缓存——变异基线必须是**当前工作区**实现)。
423
- def _rel_text(rel: str) -> str:
424
- with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
425
- return f.read()
426
-
427
-
428
- # 生效条件:name/rel/text 给定时——把 text 以 __package__="md_cg"、__file__=<仓内 rel 路径> 执行成命名空间并包成新模块对象返回(不注册 sys.modules、不触发 __main__;语法错误原样抛)。
429
- def _exec_module(name: str, rel: str, text: str):
430
- ns = {"__name__": name, "__package__": "md_cg",
431
- "__file__": os.path.join(_REPO, rel)}
432
- exec(compile(text, rel, "exec"), ns) # noqa: S102 —— 基线自证用
433
- m = types.ModuleType(name)
434
- m.__dict__.update(ns)
435
- return m
436
-
437
-
438
- # 生效条件:list_only 为真时只打印变异表并返回 0;否则先跑未变异基线(必须 0 失败),再逐条在**内存副本**上注入变异(逐锚点 replace,锚点缺失记 ANCHOR-MISS)后重跑整套分组——有红项记 OK、无红项记 MISS(空转即失败);全部锚点命中有红项时返回 0、否则 1;有 ANCHOR-MISS 时返回 2(fail-closed)。
439
- def _mutate_mode(list_only: bool = False) -> int:
440
- print("!! 定点变异自证:逐条把机制改回「错误/缺陷」形态,套件必须转红\n")
441
- if list_only:
442
- for name, rel, _pairs in _MUTATIONS:
443
- print(" %-40s [%s]" % (name, rel))
444
- return 0
445
- anchor_miss, bad = [], []
446
- with contextlib.redirect_stdout(buf0 := io.StringIO()):
447
- clean = _run_groups()
448
- print(" 未变异基线:失败=%d(必须为 0)" % clean)
449
- if clean:
450
- bad.append("未变异基线即失败")
451
- for l in buf0.getvalue().splitlines(): # 基线红项逐条打印(可定位)
452
- if l.strip().startswith("FAIL "):
453
- print(" " + l.strip()[5:])
454
- for name, rel, pairs in _MUTATIONS:
455
- mut_src, miss = _rel_text(rel), []
456
- for old, new in pairs:
457
- if old not in mut_src:
458
- miss.append(old.splitlines()[0].strip()[:48])
459
- continue
460
- mut_src = mut_src.replace(old, new, 1)
461
- if miss:
462
- print(" ANCHOR-MISS %s —— 锚点在 %s 源码里找不到(实现改了却没"
463
- "同步本表):%s" % (name, rel, miss))
464
- anchor_miss.append(name)
465
- continue
466
- try:
467
- globals()["MS"] = _exec_module("md_cg._ms_mut", rel, mut_src)
468
- with contextlib.redirect_stdout(buf := io.StringIO()):
469
- reds = _run_groups()
470
- detail = buf.getvalue()
471
- finally:
472
- globals()["MS"] = _REAL_MS
473
- reds_lines = [l for l in detail.splitlines()
474
- if l.strip().startswith("FAIL ")]
475
- verdict = "红" if reds else "**仍全绿 = 该判据空转**"
476
- print(" %s %-40s 红项=%d %s"
477
- % ("OK " if reds else "MISS ", name, reds, verdict))
478
- for l in reds_lines[:6]:
479
- print(" " + l.strip()[5:])
480
- if not reds:
481
- bad.append(name)
482
- # 恢复证明:全部轮次结束后把真模块放回,重跑一次基线并须全绿。
483
- with contextlib.redirect_stdout(buf1 := io.StringIO()):
484
- restored = _run_groups()
485
- print(" 恢复后基线(真模块):失败=%d(必须为 0)" % restored)
486
- if restored:
487
- bad.append("恢复后基线失败")
488
- if anchor_miss:
489
- print("\nANCHOR-MISS:%s" % "、".join(anchor_miss))
490
- print("退出码 2(fail-closed):变异表锚点漂移即判失败,不得静默跳过")
491
- return 2
492
- print("\n定点变异自证:%s"
493
- % ("PASS(每处机制都有断言把它钉死)" if not bad
494
- else "FAIL —— " + "、".join(bad)))
495
- return 0 if not bad else 1
496
-
497
-
498
- def main() -> int:
499
- _sandbox_env()
500
- try:
501
- if "--mutate" in sys.argv:
502
- return _mutate_mode("--list" in sys.argv)
503
- n = _run_groups()
504
- print("\n状态事件记账写口守卫:%d 通过 / %d 失败" % (len(_PASS), n))
505
- print("SUMMARY: md_cg.test_state_event_op 通过=%d 失败=%d"
506
- % (len(_PASS), n))
507
- return 0 if not n else 1
508
- finally:
509
- _restore_env()
510
- shutil.rmtree(_TMP, ignore_errors=True)
511
-
512
-
513
- if __name__ == "__main__":
514
- 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())