@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
@@ -0,0 +1,727 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:#322 同一 node_id 并发写的跨进程串行化(writepipe 写链 + MdCGOS.add/_move_layer 库层)
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue322_node_write_lock [--mutate];
4
+ # 被测面=md_cg/writepipe.py 的 WritePipeline.execute、md_cg/mdcos.py 的 MdCGOS.add、
5
+ # MdCGSecure.add、MdCGOS._move_layer、md_cg/fsutil.py 的 node_write_lock
6
+ # 子功能:A1=writepipe 并发同 id(3 进程 × 2 轮)不丢正文且至多一个 committed;
7
+ # A2=writepipe anchor/knowledge 同 id 并发不得两份并存;A3=**库层** cg.add 直接并发
8
+ # anchor/knowledge 同 id 不得两份并存(钉 add 自己的锁,不靠 writepipe);
9
+ # A4=**_move_layer 与 add 并发同 id**(搬迁的读旧位置→写新层→删旧文件 vs 覆写)——
10
+ # 已应答的 add 新值不得被搬迁写下的旧正文顶掉;A5=**密级继承的读改写**
11
+ # (A 显式声明 internal 覆写 / B 未声明应继承当前密级)——盘面不得被陈旧索引降级回
12
+ # public;K1=串行覆写仍真生效(锁不是空操作);
13
+ # E1/E2=结构锚(走 FileLock + strict、不用进程内锁);E3/E4/E5/E5b/E6=各落点在锁块内
14
+ # (E5b=密级继承读前先做跨进程代际探活:互斥 ≠ 读到新值)
15
+ # 执行:每轮新建隔离库;写者各自独立进程自旋对齐后并发写同一 id;读盘面同 id 文件集合
16
+ # 验证方式:全部 PASS 即通过(rc=0);--mutate 走镜像树定点变异,红项集合须恰为预期
17
+ # 不适用条件:① 不测吞吐/锁开销(那是性能面,不是本缺陷);② 不覆盖 Windows 之外的
18
+ # OS 锁实现差异(FileLock 自身的语义由既有守卫负责);③ 不判「不同 node_id 是否并行」
19
+ # (按 id 分锁的设计意图,不是本缺陷的验收面);④ 不覆盖**直接构造 `MdCG`**(父类)
20
+ # 的搬迁路径——锁的覆盖点在 `MdCGOS`(子类覆盖),`md_cg/mdcg.py` 不在本单元写面
21
+ """#322 守卫:同 id 并发写必须被同一把**跨进程**锁串行化。
22
+
23
+ 病象(修前,探针 .tmp/u06/probe_322.py 实测):
24
+ · 普通腿 6/6 轮:4 个写者全部回执 committed:true,盘面只有 1 份正文,
25
+ 其余 3 份**已应答却从 root 里消失**(静默丢正文);
26
+ · anchor 腿 6/6 轮:anchor 与 knowledge 各写同 id,盘面**两份并存**
27
+ (anchor\\x.md + knowledge/orphan\\x.md),保护闸在两侧都看不到对方
28
+ ⇒ 保护被绕过。
29
+ · 搬迁腿(`.tmp/u06/probe_move_add.py`)3/3 轮:`_move_layer` 读到旧位置后
30
+ 慢写新层,并发的 add 已应答的新正文被搬迁写下的旧正文顶掉。
31
+ · 密级继承腿(`.tmp/u06/probe_secure_add.py`):无锁 6/6 轮、只加 add 锁仍 3/6 轮
32
+ ——B 按**陈旧内存索引**继承密级,把他进程刚落盘的 internal 静默降级回 public。
33
+ 修法(单点):fsutil.node_write_lock(OS 级 FileLock + 同线程重入计数),
34
+ writepipe.execute 整条链 + MdCGOS.add / MdCGSecure.add / MdCGOS._move_layer
35
+ 各持同一把(同线程重入不互锁);密级继承读之前另做一次
36
+ `_maybe_reload_index` 代际探活(锁保证互斥,探活保证读到新值)。
37
+ """
38
+ import os
39
+ import shutil
40
+ import subprocess
41
+ import sys
42
+ import tempfile
43
+
44
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
45
+
46
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
47
+ if _REPO not in sys.path:
48
+ sys.path.insert(0, _REPO)
49
+
50
+ PASSED, FAILS = [], []
51
+
52
+ CCG = ("# 功能名:并发写守卫夹具\n"
53
+ "# 生效条件:多进程同 id 同 root 并发写\n"
54
+ "# 子功能:无\n"
55
+ "# 执行:无\n"
56
+ "# 验证方式:无\n"
57
+ "# 不适用条件:无\n"
58
+ "%s\n")
59
+
60
+ _W_WRITEPIPE = r'''
61
+ import json, sys, time
62
+ sys.path.insert(0, sys.argv[1])
63
+ from md_cg.mdcos import MdCGOS
64
+ from md_cg.writepipe import default_pipeline
65
+ root, nid, layer, body, t0 = sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], float(sys.argv[6])
66
+ cg = MdCGOS(root)
67
+ while time.time() < t0:
68
+ pass
69
+ try:
70
+ r = default_pipeline().execute(cg, {"node_id": nid, "content": body,
71
+ "layer": layer, "content_kind": "text"})
72
+ out = {"ok": r.get("ok"), "committed": r.get("committed"),
73
+ "error": r.get("error")}
74
+ except Exception as exc:
75
+ out = {"ok": False, "committed": False,
76
+ "error": type(exc).__name__ + ": " + str(exc)[:90]}
77
+ try:
78
+ cg.close()
79
+ except Exception:
80
+ pass
81
+ print(json.dumps(out, ensure_ascii=False))
82
+ '''
83
+
84
+ _W_ADD = r'''
85
+ import json, sys, time
86
+ sys.path.insert(0, sys.argv[1])
87
+ from md_cg.mdcos import MdCGOS
88
+ root, nid, layer, body, t0 = sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], float(sys.argv[6])
89
+ cg = MdCGOS(root)
90
+ while time.time() < t0:
91
+ pass
92
+ try:
93
+ cg.add(nid, body, layer=layer)
94
+ out = {"ok": True, "committed": True, "error": None}
95
+ except Exception as exc:
96
+ out = {"ok": False, "committed": False,
97
+ "error": type(exc).__name__ + ": " + str(exc)[:90]}
98
+ try:
99
+ cg.close()
100
+ except Exception:
101
+ pass
102
+ print(json.dumps(out, ensure_ascii=False))
103
+ '''
104
+
105
+ #: 搬迁腿:把基类 `_write_node` 包一层 sleep 0.5s(只拉长「读到旧位置 → 写新层 →
106
+ #: 删旧文件」的窗口,不改任何判据),再对同一 id 调 `_move_layer`。
107
+ _W_MOVE = r'''
108
+ import json, sys, time
109
+ sys.path.insert(0, sys.argv[1])
110
+ from md_cg.mdcos import MdCGOS
111
+ from md_cg.mdcg import MdCG
112
+ root, nid, t0 = sys.argv[2], sys.argv[3], float(sys.argv[4])
113
+ _o = MdCG._write_node
114
+ def _slow(self, *a, **k):
115
+ time.sleep(0.5)
116
+ return _o(self, *a, **k)
117
+ MdCG._write_node = _slow
118
+ cg = MdCGOS(root)
119
+ while time.time() < t0:
120
+ pass
121
+ try:
122
+ r = cg._move_layer(nid, "contextual", reason="i322-guard")
123
+ out = {"ok": True, "committed": True,
124
+ "error": None, "to": (r or {}).get("to")}
125
+ except Exception as exc:
126
+ out = {"ok": False, "committed": False,
127
+ "error": type(exc).__name__ + ": " + str(exc)[:90]}
128
+ try:
129
+ cg.close()
130
+ except Exception:
131
+ pass
132
+ print(json.dumps(out, ensure_ascii=False))
133
+ '''
134
+
135
+
136
+ def _check(n, c, d=''):
137
+ if c:
138
+ print(' PASS ' + n)
139
+ PASSED.append(n)
140
+ else:
141
+ print(' FAIL ' + n + ' ' + str(d)[:200])
142
+ FAILS.append(n)
143
+
144
+
145
+ def _env(t):
146
+ env = {k: v for k, v in os.environ.items()
147
+ if not k.startswith(("MDCG_", "PYTHON"))}
148
+ for k, d in (("HOME", "home"), ("MDCG_STATE_ROOT", "state"),
149
+ ("MDCG_AUX_ROOT", "auxstore"), ("MDCG_DATA_ROOT", "data"),
150
+ ("MDCG_EXPORT_ROOT", "export")):
151
+ env[k] = os.path.join(t, d)
152
+ os.makedirs(env[k])
153
+ env.update(MDCG_SUSTAIN="0", MDCG_SLEEP="0", PYTHONUTF8="1",
154
+ PYTHONPATH=_REPO)
155
+ return env
156
+
157
+
158
+ def _race(root, env, worker, writers):
159
+ t0 = __import__("time").time() + 1.5
160
+ ps = [subprocess.Popen([sys.executable, "-X", "utf8", "-c", worker, _REPO,
161
+ root, nid, layer, body, str(t0)], env=env,
162
+ cwd=env["HOME"], stdout=subprocess.PIPE,
163
+ stderr=subprocess.PIPE, text=True,
164
+ encoding="utf-8", errors="replace")
165
+ for nid, layer, body in writers]
166
+ res = []
167
+ for p in ps:
168
+ o, e = p.communicate(timeout=180)
169
+ try:
170
+ res.append(__import__("json").loads(o.strip().splitlines()[-1]))
171
+ except Exception:
172
+ res.append({"ok": False, "committed": False,
173
+ "error": "ERR " + e.strip()[-120:]})
174
+ return res
175
+
176
+
177
+ def _same_id_files(root, nid):
178
+ out = []
179
+ for dirpath, _d, files in os.walk(root):
180
+ for fn in files:
181
+ if fn == nid + ".md":
182
+ out.append(os.path.relpath(os.path.join(dirpath, fn), root))
183
+ return sorted(out)
184
+
185
+
186
+ def _one_round(worker, writers, tag):
187
+ t = tempfile.mkdtemp(prefix="i322_" + tag + "_")
188
+ env = _env(t)
189
+ root = os.path.join(t, "root")
190
+ res = _race(root, env, worker, writers)
191
+ files = _same_id_files(root, writers[0][0])
192
+ return res, files, root
193
+
194
+
195
+ def _body_of(root, nid):
196
+ """从盘面读回该 id 节点的正文(唯一一份时)。"""
197
+ for dirpath, _d, files in os.walk(root):
198
+ if nid + ".md" in files:
199
+ with open(os.path.join(dirpath, nid + ".md"),
200
+ encoding="utf-8") as f:
201
+ return f.read()
202
+ return ""
203
+
204
+
205
+ #: A4 的 add 腿:在 `_write_node` 里睡 0.4s(< 搬迁腿的 0.5s)——把「add 正在落盘」
206
+ #: 精确放进「搬迁已读完旧位置、还没删旧文件」的窗口。**只拉长窗口,不改判据**。
207
+ _W_ADD_SLOW = r'''
208
+ import json, sys, time
209
+ sys.path.insert(0, sys.argv[1])
210
+ from md_cg.mdcos import MdCGOS
211
+ from md_cg.mdcg import MdCG
212
+ root, nid, layer, body, t0 = sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], float(sys.argv[6])
213
+ _o = MdCG._write_node
214
+ def _slow(self, *a, **k):
215
+ time.sleep(0.4)
216
+ return _o(self, *a, **k)
217
+ MdCG._write_node = _slow
218
+ cg = MdCGOS(root)
219
+ while time.time() < t0:
220
+ pass
221
+ try:
222
+ cg.add(nid, body, layer=layer)
223
+ out = {"ok": True, "committed": True, "error": None}
224
+ except Exception as exc:
225
+ out = {"ok": False, "committed": False,
226
+ "error": type(exc).__name__ + ": " + str(exc)[:90]}
227
+ try:
228
+ cg.close()
229
+ except Exception:
230
+ pass
231
+ print(json.dumps(out, ensure_ascii=False))
232
+ '''
233
+
234
+
235
+ #: A5 的 worker:带 principal 的写(密级继承面)。`delay` 非 0 时在
236
+ #: `_write_sensitivity` **解析完旧密级之后**睡一会儿——这正是「读到旧值 → 据此落盘」
237
+ #: 的窗口(只拉长窗口,不改判据)。
238
+ _W_SECURE = r'''
239
+ import json, sys, time
240
+ sys.path.insert(0, sys.argv[1])
241
+ from md_cg.mdcos import MdCGSecure
242
+ from md_cg.security import Principal
243
+ from md_cg.tokens import role_spec
244
+ root, nid, body, sens, delay, t0 = (sys.argv[2], sys.argv[3], sys.argv[4],
245
+ sys.argv[5], float(sys.argv[6]),
246
+ float(sys.argv[7]))
247
+ sp = role_spec("designer")
248
+ cg = MdCGSecure(root, principal=Principal(
249
+ actor="designer", clearance="secret", can_write=True, can_admin=True,
250
+ role="designer", layers_allow=sp["layers_allow"],
251
+ ops_allow=sp["ops_allow"]))
252
+ if delay:
253
+ _o = cg._write_sensitivity
254
+ def _slow(node_id, declared):
255
+ s = _o(node_id, declared)
256
+ time.sleep(delay)
257
+ return s
258
+ cg._write_sensitivity = _slow
259
+ while time.time() < t0:
260
+ pass
261
+ try:
262
+ cg.add(nid, body, layer="knowledge", sensitivity=(sens or None))
263
+ out = {"ok": True, "committed": True, "error": None}
264
+ except Exception as exc:
265
+ out = {"ok": False, "committed": False,
266
+ "error": type(exc).__name__ + ": " + str(exc)[:90]}
267
+ try:
268
+ cg.close()
269
+ except Exception:
270
+ pass
271
+ print(json.dumps(out, ensure_ascii=False))
272
+ '''
273
+
274
+
275
+ def _sens_on_disk(root, nid):
276
+ """盘面 frontmatter 里的 sensitivity 字面量(取不到返回 None)。"""
277
+ import re
278
+ for dirpath, _d, files in os.walk(root):
279
+ if nid + ".md" in files:
280
+ with open(os.path.join(dirpath, nid + ".md"),
281
+ encoding="utf-8") as f:
282
+ m = re.search(r"^sensitivity:\s*\"?([A-Za-z]+)\"?",
283
+ f.read(), re.M)
284
+ return m.group(1) if m else None
285
+ return None
286
+
287
+
288
+ def _bodies_of(root, nid):
289
+ """盘面上所有同 id 文件的正文(同 id 可能并存于多层——那本身就是缺陷,
290
+ 故 A4 判「新值是否在**任意一份**里」,而不是只看先遍历到的那份)。"""
291
+ out = []
292
+ for dirpath, _d, files in os.walk(root):
293
+ if nid + ".md" in files:
294
+ with open(os.path.join(dirpath, nid + ".md"),
295
+ encoding="utf-8") as f:
296
+ out.append(f.read())
297
+ return out
298
+
299
+
300
+ def group_a1():
301
+ print('== A1:writepipe 并发同 id(3 进程 × 2 轮)==')
302
+ bad_files = 0
303
+ multi = 0
304
+ lost = 0
305
+ for rd in range(2):
306
+ nid = "race_same"
307
+ writers = [(nid, "knowledge", CCG % ("BODY-%04d" % i))
308
+ for i in range(3)]
309
+ res, files, root = _one_round(_W_WRITEPIPE, writers, "a1")
310
+ committed = [i for i, r in enumerate(res) if r.get("committed")]
311
+ text = _body_of(root, nid)
312
+ hit = [i for i in committed if "BODY-%04d" % i in text]
313
+ bad_files += int(len(files) != 1)
314
+ multi += int(len(committed) > 1)
315
+ lost += len(committed) - len(hit)
316
+ print(" round %d: committed=%s files=%s 命中=%s"
317
+ % (rd, committed, files, hit))
318
+ _check('A1a 盘面同 id 文件恒为 1 份(不并存)', bad_files == 0, bad_files)
319
+ _check('A1b 并发下至多一个写者回执 committed(其余入审核队列/被拒)',
320
+ multi == 0, multi)
321
+ _check('A1c 已回执 committed 的正文 100% 在盘面(丢失 0)', lost == 0, lost)
322
+
323
+
324
+ def group_a2():
325
+ print('== A2:writepipe anchor/knowledge 同 id 并发(2 轮)==')
326
+ coex = 0
327
+ for rd in range(2):
328
+ nid = "race_anchor"
329
+ res, files, _root = _one_round(
330
+ _W_WRITEPIPE,
331
+ [(nid, "anchor", CCG % "ANCHOR-BODY"),
332
+ (nid, "knowledge", CCG % "KNOW-BODY")], "a2")
333
+ coex += int(len(files) > 1)
334
+ print(" round %d: files=%s res=%s"
335
+ % (rd, files, [(r.get("committed"),
336
+ str(r.get("error") or "")[:40]) for r in res]))
337
+ _check('A2 同 id 的 anchor 与 knowledge 两份文件不得并存', coex == 0, coex)
338
+
339
+
340
+ def group_a3():
341
+ print('== A3:库层 cg.add 直接并发 anchor/knowledge 同 id(2 轮)==')
342
+ coex = 0
343
+ for rd in range(2):
344
+ nid = "race_add_anchor"
345
+ res, files, _root = _one_round(
346
+ _W_ADD,
347
+ [(nid, "anchor", CCG % "ANCHOR-BODY"),
348
+ (nid, "knowledge", CCG % "KNOW-BODY")], "a3")
349
+ coex += int(len(files) > 1)
350
+ print(" round %d: files=%s res=%s"
351
+ % (rd, files, [(r.get("committed"),
352
+ str(r.get("error") or "")[:40]) for r in res]))
353
+ _check('A3 库层 add 并发同 id 也不得两份并存(add 自己的锁在位)',
354
+ coex == 0, coex)
355
+
356
+
357
+ def group_a4():
358
+ print('== A4:_move_layer 与 add 并发同 id(搬迁读改写 vs 覆写,2 轮)==')
359
+ import json as _json
360
+ import time as _time
361
+ lost = 0
362
+ for rd in range(2):
363
+ t = tempfile.mkdtemp(prefix="i322_a4_")
364
+ env = _env(t)
365
+ root = os.path.join(t, "root")
366
+ nid = "race_move"
367
+ old = dict(os.environ)
368
+ try:
369
+ os.environ.update({k: v for k, v in env.items()
370
+ if k.startswith(("MDCG_", "HOME"))})
371
+ from md_cg.mdcos import MdCGOS
372
+ _cg = MdCGOS(root)
373
+ _cg.add(nid, CCG % "OLD-BODY", layer="knowledge")
374
+ _cg.close()
375
+ finally:
376
+ os.environ.clear()
377
+ os.environ.update(old)
378
+ t0 = _time.time() + 1.5
379
+ ps = []
380
+ for worker, extra in ((_W_MOVE, [nid, str(t0)]),
381
+ (_W_ADD_SLOW, [nid, "knowledge",
382
+ CCG % "NEW-BODY", str(t0)])):
383
+ ps.append(subprocess.Popen(
384
+ [sys.executable, "-X", "utf8", "-c", worker, _REPO,
385
+ root] + extra, env=env, cwd=env["HOME"],
386
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True,
387
+ encoding="utf-8", errors="replace"))
388
+ res = []
389
+ for p in ps:
390
+ o, e = p.communicate(timeout=180)
391
+ try:
392
+ res.append(_json.loads(o.strip().splitlines()[-1]))
393
+ except Exception:
394
+ res.append({"ok": False, "error": "ERR " + e.strip()[-120:]})
395
+ bodies = _bodies_of(root, nid)
396
+ hit = any("NEW-BODY" in t for t in bodies)
397
+ lost += int(not hit)
398
+ print(" round %d: 新值在盘=%s files=%s res=%s"
399
+ % (rd, hit, _same_id_files(root, nid),
400
+ [(r.get("committed"), str(r.get("error") or "")[:36])
401
+ for r in res]))
402
+ _check('A4 搬迁与 add 并发时,已应答 add 的新正文不得被搬迁的旧正文顶掉',
403
+ lost == 0, lost)
404
+
405
+
406
+ def group_a5():
407
+ print('== A5:MdCGSecure.add 密级继承的读改写(声明 vs 未声明,2 轮)==')
408
+ import json as _json
409
+ import time as _time
410
+ downgraded = 0
411
+ for rd in range(2):
412
+ t = tempfile.mkdtemp(prefix="i322_a5_")
413
+ env = _env(t)
414
+ root = os.path.join(t, "root")
415
+ nid = "race_sens"
416
+ old = dict(os.environ)
417
+ try:
418
+ os.environ.update({k: v for k, v in env.items()
419
+ if k.startswith(("MDCG_", "HOME"))})
420
+ from md_cg.mdcos import MdCGSecure
421
+ from md_cg.security import Principal
422
+ from md_cg.tokens import role_spec
423
+ sp = role_spec("designer")
424
+ _cg = MdCGSecure(root, principal=Principal(
425
+ actor="designer", clearance="secret", can_write=True,
426
+ can_admin=True, role="designer",
427
+ layers_allow=sp["layers_allow"],
428
+ ops_allow=sp["ops_allow"]))
429
+ _cg.add(nid, CCG % "SEED", layer="knowledge",
430
+ sensitivity="public")
431
+ _cg.close()
432
+ finally:
433
+ os.environ.clear()
434
+ os.environ.update(old)
435
+ t0 = _time.time() + 1.5
436
+ ps = [
437
+ # A:显式声明 internal,快写
438
+ subprocess.Popen([sys.executable, "-X", "utf8", "-c", _W_SECURE,
439
+ _REPO, root, nid, CCG % "A-INTERNAL",
440
+ "internal", "0", str(t0)],
441
+ env=env, cwd=env["HOME"],
442
+ stdout=subprocess.PIPE,
443
+ stderr=subprocess.PIPE, text=True,
444
+ encoding="utf-8", errors="replace"),
445
+ # B:未声明(应继承**当前**密级),读到旧值后睡 0.5s 再落盘
446
+ subprocess.Popen([sys.executable, "-X", "utf8", "-c", _W_SECURE,
447
+ _REPO, root, nid, CCG % "B-INHERIT",
448
+ "", "0.5", str(t0)],
449
+ env=env, cwd=env["HOME"],
450
+ stdout=subprocess.PIPE,
451
+ stderr=subprocess.PIPE, text=True,
452
+ encoding="utf-8", errors="replace"),
453
+ ]
454
+ res = []
455
+ for p in ps:
456
+ o, e = p.communicate(timeout=180)
457
+ try:
458
+ res.append(_json.loads(o.strip().splitlines()[-1]))
459
+ except Exception:
460
+ res.append({"ok": False, "error": "ERR " + e.strip()[-120:]})
461
+ final = _sens_on_disk(root, nid)
462
+ bad = final != "internal"
463
+ downgraded += int(bad)
464
+ print(" round %d: 盘面密级=%s 降级=%s res=%s"
465
+ % (rd, final, bad,
466
+ [(r.get("ok"), str(r.get("error") or "")[:36])
467
+ for r in res]))
468
+ _check('A5 未声明的同 id 写必须继承他进程刚落盘的密级'
469
+ '(不得按陈旧索引把 internal 静默降级回 public)',
470
+ downgraded == 0, downgraded)
471
+
472
+
473
+ def group_k1():
474
+ print('== K1:串行覆写仍真生效(锁不是空操作/不会永久占锁)==')
475
+ t = tempfile.mkdtemp(prefix="i322_k1_")
476
+ env = _env(t)
477
+ root = os.path.join(t, "root")
478
+ old = dict(os.environ)
479
+ try:
480
+ os.environ.update({k: v for k, v in env.items()
481
+ if k.startswith(("MDCG_", "HOME"))})
482
+ from md_cg.mdcos import MdCGOS
483
+ cg = MdCGOS(root)
484
+ nid = "serial_node"
485
+ cg.add(nid, CCG % "SERIAL-V1", layer="knowledge")
486
+ cg.add(nid, CCG % "SERIAL-V2", layer="knowledge") # 同 id 串行覆写
487
+ got = cg.get(nid) or {}
488
+ cg.close()
489
+ finally:
490
+ os.environ.clear()
491
+ os.environ.update(old)
492
+ text = got.get("content") or ""
493
+ _check('K1 串行第二次覆写真落盘(正文为 V2,且锁未卡死/未误吞)',
494
+ "SERIAL-V2" in text, text[-80:])
495
+
496
+
497
+ def _src(rel):
498
+ with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
499
+ return f.read()
500
+
501
+
502
+ def _method_src(cls, name):
503
+ """取运行中方法的源码(与既有守卫 test_session_attribution_consistency:555
504
+ 同手法:`inspect.getsource` + `textwrap.dedent`)。用它而不是整文件 grep,
505
+ 是因为 `node_write_lock(self, node_id)` 现在在 MdCGOS.add 与 MdCGSecure.add
506
+ 各出现一次——整文件计数判不出「哪一层漏了」。"""
507
+ import inspect
508
+ import textwrap
509
+ return textwrap.dedent(inspect.getsource(getattr(cls, name)))
510
+
511
+
512
+ def group_e():
513
+ print('== E 组:结构锚(fail-closed)==')
514
+ from md_cg.mdcos import MdCGOS, MdCGSecure
515
+ fs = _src("md_cg/fsutil.py")
516
+ wp = _src("md_cg/writepipe.py")
517
+ mo = _src("md_cg/mdcos.py")
518
+ _add_src = _method_src(MdCGOS, "add")
519
+ _sec_add_src = _method_src(MdCGSecure, "add")
520
+ _move_src = _method_src(MdCGOS, "_move_layer")
521
+ _ws_src = _method_src(MdCGSecure, "_write_sensitivity")
522
+ _check('E1 node_write_lock 走 FileLock 且 strict=True(不得无锁放行)',
523
+ "def node_write_lock" in fs and "strict=True" in fs
524
+ and "FileLock(" in fs)
525
+ _seg = fs.split("def node_write_lock")[1].split("def merge_rmw_lock")[0]
526
+ _check('E2 不得用进程内锁冒充(node_write_lock 内无 threading.Lock;'
527
+ '重入记账只允许 threading.local)',
528
+ "threading.Lock(" not in _seg and "threading.RLock(" not in _seg,
529
+ _seg[:200])
530
+ _check('E3 writepipe.execute 在 node_write_lock 内跑整条链',
531
+ "with node_write_lock(cg, _nid):" in wp
532
+ and "return self._run_chain(ctx, a)" in wp)
533
+ _check('E4 MdCGOS.add 在 node_write_lock 内落盘(落盘段在锁块内,'
534
+ '不得只把加锁写在函数外/抽成子函数)',
535
+ "with node_write_lock(self, node_id):" in _add_src
536
+ and 'self._audit("add"' in _add_src.split(
537
+ "with node_write_lock(self, node_id):", 1)[1]
538
+ and "def _add_locked" not in mo)
539
+ _check('E5 MdCGSecure.add 的密级继承读改写也在同一把锁内'
540
+ '(_write_sensitivity 读旧值 → 据此落盘,锁在 super 之前)',
541
+ "with node_write_lock(self, node_id):" in _sec_add_src
542
+ and "self._write_sensitivity(node_id, sensitivity)" in
543
+ _sec_add_src.split("with node_write_lock(self, node_id):", 1)[1])
544
+ _check('E5b 密级继承读之前先做跨进程代际探活(_maybe_reload_index)'
545
+ '——锁只保证互斥,不保证读到他进程已落盘的新密级',
546
+ "_maybe_reload_index" in _ws_src
547
+ and _ws_src.index("_maybe_reload_index")
548
+ < _ws_src.index("subgraph.node_sensitivity("))
549
+ _check('E6 MdCGOS._move_layer 在 node_write_lock 内转调父类'
550
+ '(搬迁=同 id 读改写,不经 add,必须单独覆盖)',
551
+ "with node_write_lock(self, node_id):" in _move_src
552
+ and "super()._move_layer(" in
553
+ _move_src.split("with node_write_lock(self, node_id):", 1)[1])
554
+
555
+
556
+ def main():
557
+ print('== #322 守卫 ==')
558
+ # 锚点自检(fail-closed):修复的关键字面量不在源码里 ⇒ 对应 E 项红 + 整体 rc=1。
559
+ # 不用 exit 2 提前返回:变异自证要求「撤哪一处就红哪一条」,提前退出会让
560
+ # 红项集合为空、判别力无从体现。
561
+ fs = _src("md_cg/fsutil.py")
562
+ wp = _src("md_cg/writepipe.py")
563
+ from md_cg.mdcos import MdCGOS
564
+ _mo_add = _method_src(MdCGOS, "add")
565
+ _check('E0a fsutil.node_write_lock 在位(锚点自检)',
566
+ "def node_write_lock" in fs)
567
+ _check('E0b writepipe 调用 node_write_lock 的锚点在位(锚点自检)',
568
+ "with node_write_lock(cg, _nid):" in wp)
569
+ # 锚点取 **MdCGOS.add 自己的源码**而非整文件:同一条 `with node_write_lock(
570
+ # self, node_id):` 现在在 MdCGOS.add 与 MdCGSecure.add 各出现一次,整文件
571
+ # 计数会让「撤掉 MdCGOS.add 那把锁」时本项仍绿(变异腿实测 M2 漏红)。
572
+ _check('E0c mdcos.add 调用 node_write_lock 的锚点在位(锚点自检)',
573
+ "with node_write_lock(self, node_id):" in _mo_add)
574
+ try:
575
+ group_a1()
576
+ group_a2()
577
+ group_a3()
578
+ group_a4()
579
+ group_a5()
580
+ group_k1()
581
+ except Exception as e:
582
+ import traceback
583
+ traceback.print_exc()
584
+ _check('A/K 组内异常(fail-closed)', False, str(e)[:150])
585
+ group_e()
586
+ print('=' * 62)
587
+ print('#322 守卫:%d 通过,%d 失败' % (len(PASSED), len(FAILS)))
588
+ for f in FAILS:
589
+ print(' 红项:' + f)
590
+ return 0 if not FAILS else 1
591
+
592
+
593
+ def _mirror():
594
+ """镜像树:md_cg 包 + data/policy.json(包内默认策略按包根解析,
595
+ 缺它则写链在镜像里 policy_unavailable ⇒ 并发腿全被短路,变异判别力假绿)。"""
596
+ d = tempfile.mkdtemp(prefix="i322_mirror_")
597
+ shutil.copytree(os.path.join(_REPO, "md_cg"),
598
+ os.path.join(d, "md_cg"),
599
+ ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
600
+ # 仓根一级模块(`md_cg/mcp_server.py` 顶部 `from utf8_boot import ensure_utf8`
601
+ # 等)必须一并镜像,否则副本里写链 import 即失败、并发腿全空跑(假红/假绿)。
602
+ for fn in os.listdir(_REPO):
603
+ if fn.endswith(".py") and os.path.isfile(os.path.join(_REPO, fn)):
604
+ shutil.copy2(os.path.join(_REPO, fn), os.path.join(d, fn))
605
+ src_pol = os.path.join(_REPO, "data", "policy.json")
606
+ if os.path.exists(src_pol):
607
+ os.makedirs(os.path.join(d, "data"), exist_ok=True)
608
+ shutil.copy2(src_pol, os.path.join(d, "data", "policy.json"))
609
+ return d
610
+
611
+
612
+ def _run_in(tree):
613
+ p = subprocess.run([sys.executable, "-X", "utf8", "-m",
614
+ "md_cg.test_issue322_node_write_lock"],
615
+ cwd=tree, capture_output=True, text=True,
616
+ encoding="utf-8", errors="replace",
617
+ timeout=1800,
618
+ env=dict({k: v for k, v in os.environ.items()
619
+ if not k.startswith("PYTHON")},
620
+ PYTHONPATH=tree, PYTHONUTF8="1"))
621
+ reds = [ln.strip().split(" ", 1)[0].replace("FAIL ", "")
622
+ for ln in p.stdout.splitlines() if ln.strip().startswith("FAIL ")]
623
+ return p.returncode, reds, p.stdout + p.stderr
624
+
625
+
626
+ _MUTATIONS = [
627
+ ("M1 撤 writepipe 整链锁", [("md_cg/writepipe.py",
628
+ " with node_write_lock(cg, _nid):\n"
629
+ " return self._run_chain(ctx, a)",
630
+ " return self._run_chain(ctx, a)")],
631
+ # 撤链锁:add 级锁仍在 ⇒ 盘面不会两份并存(A1a/A2 仍绿,如实),
632
+ # 但「判存在 → 定档 → 落盘」的整段不再互斥 ⇒ 两个写者都 committed(A1b)、
633
+ # 输的那份正文从 root 消失(A1c)——正是 #322 的症状。
634
+ ("A1b", "A1c", "E0b", "E3")),
635
+ # M2/M3 用 `if True:` 顶替 `with`(保留缩进/作用域,只把锁去掉):
636
+ # 行为腿(A3)与结构锚同时可判,且不依赖字符串再缩进。
637
+ ("M2 撤 MdCGOS.add 锁", [("md_cg/mdcos.py",
638
+ " with node_write_lock(self, node_id):\n"
639
+ " # #151",
640
+ " if True: # MUT\n"
641
+ " # #151")],
642
+ ("A3", "E0c", "E4")),
643
+ ("M3 撤 MdCGSecure.add 的密级继承锁", [("md_cg/mdcos.py",
644
+ " with node_write_lock(self, "
645
+ "node_id):\n"
646
+ " sens = self."
647
+ "_write_sensitivity(",
648
+ " if True: # MUT\n"
649
+ " sens = self."
650
+ "_write_sensitivity(")],
651
+ ("E5",)),
652
+ # M3b:只撤「读前代际探活」——锁与结构锚都还在,只有**行为腿 A5** 能判它
653
+ # (这正是复核意见 5 指出的残留窗口:互斥 ≠ 读到新值)。
654
+ ("M3b 撤密级继承的跨进程代际探活", [("md_cg/mdcos.py",
655
+ " _probe = getattr(self, "
656
+ "\"_maybe_reload_index\", None)\n"
657
+ " if callable(_probe):\n"
658
+ " _probe()\n",
659
+ " _probe = None\n")],
660
+ ("A5",)),
661
+ ("M4 撤 MdCGOS._move_layer 的搬迁锁", [("md_cg/mdcos.py",
662
+ " with node_write_lock(self, "
663
+ "node_id):\n"
664
+ " return super()."
665
+ "_move_layer(",
666
+ " if True: # MUT\n"
667
+ " return super()."
668
+ "_move_layer(")],
669
+ ("A4", "E6")),
670
+ ]
671
+
672
+
673
+ def _mutate():
674
+ print('!! 定点变异自证:把锁撤掉,守卫必须转红')
675
+ tree = _mirror()
676
+ try:
677
+ rc, reds, out = _run_in(tree)
678
+ print(' 未变异镜像基线:rc=%d 红项=%d(须 rc=0/0 红)' % (rc, len(reds)))
679
+ if rc != 0 or reds:
680
+ print(chr(10).join(out.splitlines()[-25:]))
681
+ bad = []
682
+ for desc, edits, exp in _MUTATIONS:
683
+ backups = []
684
+ miss = []
685
+ for rel, oldp, newp in edits:
686
+ p = os.path.join(tree, rel)
687
+ with open(p, encoding="utf-8", newline="") as f:
688
+ t = f.read()
689
+ if t.count(oldp) != 1:
690
+ miss.append("%s 命中 %d 次" % (rel, t.count(oldp)))
691
+ continue
692
+ backups.append((p, t))
693
+ with open(p, "w", encoding="utf-8", newline="") as f:
694
+ f.write(t.replace(oldp, newp, 1))
695
+ if miss:
696
+ bad.append("%s —— %s" % (desc, ";".join(miss)))
697
+ print(' ANCHOR-MISS ' + desc)
698
+ for p, t in backups:
699
+ with open(p, "w", encoding="utf-8", newline="") as f:
700
+ f.write(t)
701
+ continue
702
+ rc2, reds2, out2 = _run_in(tree)
703
+ for p, t in backups:
704
+ with open(p, "w", encoding="utf-8", newline="") as f:
705
+ f.write(t)
706
+ hit = sorted({e for r in reds2 for e in exp if r.startswith(e + " ")
707
+ or r.startswith(e)})
708
+ if rc2 != 0 and hit == sorted(exp):
709
+ print(' OK %s 红项=%s' % (desc, reds2))
710
+ else:
711
+ bad.append(desc)
712
+ print(' MISMATCH %s rc=%d 红项=%s' % (desc, rc2, reds2))
713
+ print(chr(10).join(out2.splitlines()[-20:]))
714
+ print('定点变异自证:%s(%d 条不合格)'
715
+ % ('PASS' if not bad else 'FAIL', len(bad)))
716
+ for b in bad:
717
+ print(' 不合格:' + b)
718
+ _check('变异自证全过', not bad, bad)
719
+ finally:
720
+ shutil.rmtree(tree, ignore_errors=True)
721
+
722
+
723
+ if __name__ == '__main__':
724
+ if '--mutate' in sys.argv:
725
+ _mutate()
726
+ sys.exit(0 if not FAILS else 1)
727
+ sys.exit(main())