@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,355 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:凭据载体权限收敛「声明与实现一致 + 失败不静默」(⑤)与 unwrap_dek 的 clearance 已文档化事实(⑥)(issue #326)
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue326_key_perms [--mutate];被测面=md_cg/crypto.py 的 _tighten_perms / load_master_key / _save_keys(⑤)与 unwrap_dek、provision_dek、envelopes(⑥)
4
+ # 子功能:A 组=⑤ 两处凭据载体都收敛、失败进有界告警且不上抛、成功不告警、密钥行为不变;K 组=非恒真对照(过度收紧方向:chmod 失败不得阻断密钥生成;正常路径不得恒告警;_save_keys 对账/锁定语义与 provision→unwrap 往返不受扰);E 组=源码面(静默形态退役)+ **⑥ 的三条已文档化事实钉**
5
+ # 执行:--mutate 时在镜像树里逐条改回「静默 chmod」(回缺陷)、「失败即上抛」(过度收紧)、「只修 master.key 不修 _keys.json」(半修),守卫必须按指定项转红
6
+ # 验证方式:全部 PASS 即通过(退出码 0);--mutate 下每条变异的红项集合须与预期**逐项相符**
7
+ # 不适用条件:**不判「是否真的实现了 0600 语义」**——Windows 上 os.chmod 只切只读位是既有事实,本批确立的是「声明与实现一致 + 失败不静默」而非「已隔离」(icacls 方案经编排侧裁定不上);不判 ⑥ 的行为改动(判为有意设计,**只记录不改**);不判 _keys.json 的加密/信封语义
8
+ """issue #326-⑤⑥ 守卫。
9
+
10
+ ⑤ 病象(修前):`load_master_key` 里 `try: os.chmod(path, 0o600) except OSError: pass` ——
11
+ **静默**;且 `_save_keys` 写 `_keys.json` 后**完全无权限收敛**(同为凭据载体,两种待遇)。
12
+ 平台事实:Windows 上 `os.chmod` 只切只读位、不产生 POSIX 隔离(真实保护来自用户目录 ACL),
13
+ 故本条**不宣称**「已隔离」,只消除**声明与实现不符 + 静默**。
14
+
15
+ ⑥ 事实:`unwrap_dek(root, kek, tenant, actor, clearance=None)` 的 `clearance` **从不参与判定**
16
+ (函数体不引用);`provision_dek` 的**位置透传**仅为与签发端签名对称;信封里的 `clearance`
17
+ 供 `envelopes()` 审计。该事实**本仓审计已留痕**(`unwrap_dek` 的「生效条件」注释明写),
18
+ 编排侧裁定为**有意设计 ⇒ 只记录、不改**(删形参是跨 2 模块的破坏性 API 改动)。
19
+ 本守卫的 E 组把这三条钉住:**防后来者误以为它是活鉴权位而去「修」它**。
20
+
21
+ 「守卫必须能在变异态下跑完」:取数经包装折成可命名形态,不崩栈。
22
+ """
23
+ from __future__ import annotations
24
+
25
+ import ast
26
+ import os
27
+ import shutil
28
+ import subprocess
29
+ import sys
30
+ import tempfile
31
+
32
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
33
+
34
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
35
+ if _REPO not in sys.path:
36
+ sys.path.insert(0, _REPO)
37
+
38
+ FAILS = []
39
+
40
+
41
+ def _check(name, cond, detail=""):
42
+ if cond:
43
+ print(" PASS " + name)
44
+ else:
45
+ print(" FAIL " + name + " " + str(detail)[:220])
46
+ FAILS.append(name)
47
+
48
+
49
+ _TMP = tempfile.mkdtemp(prefix="iss326e_")
50
+ os.environ.update({"MDCG_ROOT": _TMP + "/brain", "MDCG_STATE_ROOT": _TMP + "/state",
51
+ "MDCG_AUX_ROOT": _TMP + "/auxstore",
52
+ "MDCG_DATA_ROOT": _TMP + "/datastore",
53
+ "MDCG_EXPORT_ROOT": _TMP, "MDCG_SUSTAIN": "0", "MDCG_SLEEP": "0"})
54
+
55
+ from md_cg import crypto as _c # noqa: E402
56
+
57
+ _REAL_OS = _c.os
58
+
59
+
60
+ class _OsShim:
61
+ """os 模块代理:只覆盖指定函数,其余转发(不改进程全局 os)。"""
62
+
63
+ def __init__(self, **over):
64
+ self._over = over
65
+
66
+ def __getattr__(self, name):
67
+ if name in self._over:
68
+ return self._over[name]
69
+ return getattr(os, name)
70
+
71
+
72
+ def _err(fn):
73
+ """调 fn:正常返回 ("", 结果);抛异常(含 BaseException)返回 (类型名, 异常对象)。"""
74
+ try:
75
+ return "", fn()
76
+ except BaseException as exc: # noqa: BLE001 —— 变异态不得崩栈
77
+ return type(exc).__name__, exc
78
+
79
+
80
+ def _fresh_root(tag):
81
+ d = os.path.join(_TMP, tag)
82
+ os.makedirs(d, exist_ok=True)
83
+ return d
84
+
85
+
86
+ print("== A 组:⑤ 两处凭据载体都收敛、失败不静默、也不上抛 ==")
87
+ _calls = []
88
+ _c.PERM_WARNINGS.clear()
89
+ _r1 = _fresh_root("root1")
90
+ _mk = os.path.join(_r1, "master.key")
91
+ _real_chmod = os.chmod
92
+ _c.os = _OsShim(chmod=lambda p, m: _calls.append((p, m)))
93
+ _t1, _k1 = _err(lambda: _c.load_master_key(master_file=_mk))
94
+ _c.os = _REAL_OS
95
+ _check("A01 master.key 生成后**调用**权限收敛(path 命中、mode=0o600)",
96
+ _t1 == "" and any(os.path.abspath(p) == os.path.abspath(_mk) and m == 0o600
97
+ for p, m in _calls), (_t1, _calls))
98
+ _check("A02 收敛成功时**不**告警(不得恒告警)", _c.PERM_WARNINGS == [],
99
+ _c.PERM_WARNINGS)
100
+ _calls2 = []
101
+ _c.PERM_WARNINGS.clear()
102
+ _mk2 = os.path.join(_fresh_root("root2"), "master.key")
103
+ _c.os = _OsShim(chmod=lambda p, m: _calls2.append((p, m)))
104
+ _t2, _k2 = _err(lambda: _c.load_master_key(master_file=_mk2))
105
+ _c.os = _REAL_OS
106
+ _check("A03 第二次生成也是同一路径收敛(幂等,不受首次告警影响)",
107
+ _t2 == "" and len(_calls2) == 1 and len(_k2) == 32, (_t2, _calls2))
108
+ # 失败路径:chmod 抛 OSError ⇒ 不上抛 + **不静默**(进有界告警)
109
+ _c.PERM_WARNINGS.clear()
110
+ _mk3 = os.path.join(_fresh_root("root3"), "master.key")
111
+ _c.os = _OsShim(chmod=lambda p, m: (_ for _ in ()).throw(OSError("not permitted")))
112
+ _t3, _k3 = _err(lambda: _c.load_master_key(master_file=_mk3))
113
+ _c.os = _REAL_OS
114
+ _check("A04 chmod 失败**不上抛**(受限平台/只读介质不得阻断启动)且密钥照常产出",
115
+ _t3 == "" and len(_k3) == 32, (_t3, _k3))
116
+ _check("A05 chmod 失败**不静默**:告警含 (path, 异常类型, 文本) 且 path 命中",
117
+ len(_c.PERM_WARNINGS) == 1
118
+ and os.path.abspath(_c.PERM_WARNINGS[0][0]) == os.path.abspath(_mk3)
119
+ and _c.PERM_WARNINGS[0][1] == "OSError", _c.PERM_WARNINGS)
120
+ _check("A06 密钥文件确实落盘且内容非空(失败的是权限收敛,不是写入)",
121
+ os.path.exists(_mk3) and os.path.getsize(_mk3) > 0, "")
122
+ # _keys.json:同为凭据载体,同款收敛
123
+ _calls4 = []
124
+ _c.PERM_WARNINGS.clear()
125
+ _r4 = _fresh_root("root4")
126
+ _c.os = _OsShim(chmod=lambda p, m: _calls4.append((p, m)))
127
+ _t4, _ = _err(lambda: _c._save_keys(_r4, {"v": 1, "alg": "x", "envelopes": {}}))
128
+ _c.os = _REAL_OS
129
+ _kp = _c.keys_path(_r4)
130
+ _check("A07 _keys.json 写入后**也**收敛(修前完全无收敛;与 master.key 同待遇)",
131
+ _t4 == "" and any(os.path.abspath(p) == os.path.abspath(_kp) and m == 0o600
132
+ for p, m in _calls4), (_t4, _calls4, _kp))
133
+ _check("A08 _keys.json 落盘内容正确(收敛不改写入语义)",
134
+ _t4 == "" and os.path.exists(_kp) and _c._load_keys(_r4).get("v") == 1,
135
+ (_t4, _kp))
136
+
137
+ print("== K 组:非恒真对照(过度收紧方向——失败不得阻断、正常路径不得恒告警) ==")
138
+ _c.PERM_WARNINGS.clear()
139
+ _mk5 = os.path.join(_fresh_root("root5"), "master.key")
140
+ _c.os = _OsShim(chmod=lambda p, m: (_ for _ in ()).throw(OSError(13, "denied")))
141
+ _t5, _k5 = _err(lambda: _c.load_master_key(master_file=_mk5))
142
+ _c.os = _REAL_OS
143
+ _check("K01 chmod 失败**不得阻断**密钥生成(返回 key、文件已落盘)",
144
+ _t5 == "" and len(_k5) == 32 and os.path.exists(_mk5), (_t5, _k5))
145
+ _check("K02 失败告警**有界**(重复失败不无限增长)",
146
+ len(_c.PERM_WARNINGS) <= _c._PERM_WARN_LIMIT, len(_c.PERM_WARNINGS))
147
+ _c.PERM_WARNINGS.clear()
148
+ _mk6 = os.path.join(_fresh_root("root6"), "master.key")
149
+ _t6, _k6 = _err(lambda: _c.load_master_key(master_file=_mk6))
150
+ _check("K03 正常路径不告警(真实 chmod 成功时告警列表保持空)",
151
+ _t6 == "" and _c.PERM_WARNINGS == [], (_t6, _c.PERM_WARNINGS))
152
+ _r7 = _fresh_root("root7")
153
+ with open(_c.keys_path(_r7), "w", encoding="utf-8") as f:
154
+ f.write("{broken-json")
155
+ _t7, _e7 = _err(lambda: _c._save_keys(_r7, {"envelopes": {}}))
156
+ _check("K04 _save_keys 的对账契约不受扰(盘面不可解析 ⇒ LockedError,拒绝整份覆盖)",
157
+ _t7 == "LockedError", (_t7, str(_e7)[:80]))
158
+ _r8 = _fresh_root("root8")
159
+ _kek = b"k" * 32
160
+ _t8, _dek8 = _err(lambda: _c.provision_dek(_r8, _kek, "t1", "alice"))
161
+ _t9, _back8 = _err(lambda: _c.unwrap_dek(_r8, _kek, "t1", "alice"))
162
+ _check("K05 provision→unwrap 往返仍解出同一 DEK(⑤ 的收敛不触碰密钥语义)",
163
+ _t8 == "" and _t9 == "" and _back8 == _dek8, (_t8, _t9))
164
+
165
+ print("== E 组:源码面(⑤ 静默形态退役)+ ⑥ 三条已文档化事实钉 ==")
166
+
167
+
168
+ def _csrc():
169
+ with open(os.path.join(_REPO, "md_cg/crypto.py"), encoding="utf-8") as f:
170
+ return f.read()
171
+
172
+
173
+ _CS = _csrc()
174
+ _tree = ast.parse(_CS)
175
+ _chmod_calls = [n for n in ast.walk(_tree) if isinstance(n, ast.Call)
176
+ and isinstance(n.func, ast.Attribute) and n.func.attr == "chmod"]
177
+ _check("E01 ⑤ 静默形态已退役:全模块只有 **1 处** chmod 调用(在 _tighten_perms 内)",
178
+ len(_chmod_calls) == 1 and "def _tighten_perms(path):" in _CS,
179
+ len(_chmod_calls))
180
+ _check("E02 ⑤ 失败不静默:OSError 分支写入 PERM_WARNINGS(有界)且 return False(不上抛)",
181
+ "PERM_WARNINGS.append(" in _CS and "_PERM_WARN_LIMIT" in _CS, "")
182
+ _tighten_calls = sorted(ast.unparse(n) for n in ast.walk(_tree)
183
+ if isinstance(n, ast.Call) and isinstance(n.func, ast.Name)
184
+ and n.func.id == "_tighten_perms")
185
+ _check("E03 ⑤ 两处凭据载体同待遇:收敛调用点恰为 {master.key, _keys.json}",
186
+ _tighten_calls == ["_tighten_perms(keys_path(root))", "_tighten_perms(path)"],
187
+ _tighten_calls)
188
+ _check("E04 ⑤ Windows 平台事实被**如实文档化**(含 Windows + 只读位/ACL 字样)",
189
+ "Windows" in _CS and ("只读位" in _CS or "ACL" in _CS), "")
190
+ _uw = [n for n in ast.walk(_tree)
191
+ if isinstance(n, ast.FunctionDef) and n.name == "unwrap_dek"]
192
+ _uw_names = set()
193
+ if _uw:
194
+ for _n in ast.walk(_uw[0]):
195
+ if isinstance(_n, ast.Name):
196
+ _uw_names.add(_n.id)
197
+ elif isinstance(_n, ast.Attribute):
198
+ _uw_names.add(_n.attr)
199
+ _uw_args = [a.arg for a in _uw[0].args.args] if _uw else []
200
+ _check("E05 ⑥ 钉①:unwrap_dek 的 clearance **不参与条件判定**(形参在、函数体不引用)",
201
+ bool(_uw) and "clearance" in _uw_args
202
+ and "clearance" not in _uw_names, (_uw_args, sorted(_uw_names)))
203
+ _check("E06 ⑥ 钉②:provision_dek 对 unwrap_dek 的 clearance 仅为**位置透传**(签名对称)",
204
+ "return unwrap_dek(root, kek, tenant, actor, clearance)" in _CS, "")
205
+ _check("E07 ⑥ 钉③:信封存 clearance 供 envelopes() 审计(读方不是判定方)",
206
+ "def envelopes(" in _CS and _CS.count("clearance") >= 4, _CS.count("clearance"))
207
+ _check("E08 ⑥ 已文档化:unwrap_dek 的生效条件注释明写「clearance 形参默认 None 但源码未在条件中使用」",
208
+ "clearance 形参默认 None 但源码未在条件中使用" in _CS, "")
209
+
210
+ shutil.rmtree(_TMP, ignore_errors=True)
211
+ print("")
212
+ if FAILS:
213
+ print("issue #326-⑤⑥ 结果:%d 失败" % len(FAILS))
214
+ else:
215
+ print("issue #326-⑤⑥ 结果:全部通过")
216
+
217
+ # ---------------------------------------------------------------- 定点变异表
218
+ # 锚点跨行用 chr(10) 拼接;_apply_text 按目标文件**实际行尾**折算(crypto.py 为 CRLF)。
219
+ _TIGHTEN_CALL = " _tighten_perms(path)"
220
+ _SILENT = chr(10).join([
221
+ " try:",
222
+ " os.chmod(path, 0o600)",
223
+ " except OSError:",
224
+ " pass",
225
+ ])
226
+ _RAISE = chr(10).join([
227
+ " except OSError as e:",
228
+ " if len(PERM_WARNINGS) < _PERM_WARN_LIMIT:",
229
+ " PERM_WARNINGS.append((path, type(e).__name__, str(e)[:120]))",
230
+ " raise",
231
+ ])
232
+ _WARN_BLOCK = chr(10).join([
233
+ " except OSError as e:",
234
+ " if len(PERM_WARNINGS) < _PERM_WARN_LIMIT:",
235
+ " PERM_WARNINGS.append((path, type(e).__name__, str(e)[:120]))",
236
+ " return False",
237
+ ])
238
+ _KEYS_CALL = " _tighten_perms(keys_path(root))"
239
+ _KEYS_OFF = " # 变异:删掉 _keys.json 的收敛(半修)"
240
+
241
+ _MUTATIONS = (
242
+ # M1 回缺陷(静默):失败不告警 ⇒ A05 转红;裸 chmod 回到调用点 ⇒ E01(chmod 调用数)与
243
+ # E03(收敛调用点集合)同步转红。A04/K01(不上抛)两态皆不抛 ⇒ 恒绿(如实)。
244
+ ("M1 回缺陷:chmod 回到静默 try/except pass", "md_cg/crypto.py",
245
+ ((_TIGHTEN_CALL, _SILENT),),
246
+ ("A05", "E01", "E03")),
247
+ # M2 过度收紧(失败即上抛)⇒ 受限平台上密钥生成被阻断:K01/A04 转红;
248
+ # 告警仍在(A05/A06 绿)——告警与阻断是两件事,本腿只钉后者。
249
+ ("M2 过度收紧:收敛失败即上抛(阻断密钥生成)", "md_cg/crypto.py",
250
+ ((_WARN_BLOCK, _RAISE),),
251
+ ("A04", "K01")),
252
+ # M3 半修(只修 master.key,_keys.json 仍无收敛)⇒ A07 与 E03 转红(两种待遇不一致)。
253
+ ("M3 半修:_keys.json 不收敛(凭据载体两样待遇)", "md_cg/crypto.py",
254
+ ((_KEYS_CALL, _KEYS_OFF),),
255
+ ("A07", "E03")),
256
+ )
257
+
258
+
259
+ def _mirror_build():
260
+ dst = tempfile.mkdtemp(prefix="iss326e_mut_")
261
+ for name in ("md_cg", "scripts", "compiler"):
262
+ src = os.path.join(_REPO, name)
263
+ if os.path.isdir(src):
264
+ shutil.copytree(src, os.path.join(dst, name),
265
+ ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
266
+ for name in sorted(os.listdir(_REPO)):
267
+ p = os.path.join(_REPO, name)
268
+ if os.path.isfile(p) and (name.endswith(".py")
269
+ or name in ("README.md", "pyproject.toml",
270
+ "package.json")):
271
+ shutil.copy2(p, os.path.join(dst, name))
272
+ return dst
273
+
274
+
275
+ def _apply_text(text, rel, pairs):
276
+ """按目标文件实际行尾折算锚点后逐条替换;任一锚点命中数 != 1 返回 (None, 原因)。"""
277
+ eol = (chr(13) + chr(10)) if (chr(13) + chr(10)) in text else chr(10)
278
+ for old, new in pairs:
279
+ o = old.replace(chr(10), eol)
280
+ n = new.replace(chr(10), eol)
281
+ if text.count(o) != 1:
282
+ return None, "锚点在 %s 里命中 %d 次" % (rel, text.count(o))
283
+ text = text.replace(o, n, 1)
284
+ return text, ""
285
+
286
+
287
+ def _run_in(tree):
288
+ env = dict(os.environ)
289
+ env["PYTHONPATH"] = tree
290
+ env["PYTHONUTF8"] = "1"
291
+ env["PYTHONDONTWRITEBYTECODE"] = "1"
292
+ for k in ("MDCG_ROOT", "MDCG_STATE_ROOT", "MDCG_AUX_ROOT",
293
+ "MDCG_DATA_ROOT", "MDCG_EXPORT_ROOT"):
294
+ env.pop(k, None)
295
+ pr = subprocess.run([sys.executable, "-X", "utf8", "-m",
296
+ "md_cg.test_issue326_key_perms"],
297
+ capture_output=True, text=True, encoding="utf-8",
298
+ errors="replace", cwd=tree, env=env, timeout=1800)
299
+ out = (pr.stdout or "") + (pr.stderr or "")
300
+ reds = [ln.split("FAIL ", 1)[1].strip()
301
+ for ln in out.splitlines() if ln.strip().startswith("FAIL ")]
302
+ return pr.returncode, reds, out
303
+
304
+
305
+ def _mutate():
306
+ print("!! 定点变异自证:逐条把权限收敛改回静默/过度收紧/半修形态,守卫必须按指定项转红")
307
+ tree = _mirror_build()
308
+ bad = []
309
+ try:
310
+ rc, reds, out = _run_in(tree)
311
+ print(" 未变异镜像基线:rc=%d 红项=%d(必须 rc=0 且 0 红)" % (rc, len(reds)))
312
+ if rc != 0 or reds:
313
+ bad.append("未变异镜像基线即红")
314
+ print(chr(10).join(out.splitlines()[-25:]))
315
+ for desc, rel, pairs, exp in _MUTATIONS:
316
+ p = os.path.join(tree, rel)
317
+ with open(p, encoding="utf-8", newline="") as f:
318
+ bak = f.read()
319
+ mut, why = _apply_text(bak, rel, pairs)
320
+ if mut is None:
321
+ bad.append("%s —— %s" % (desc, why))
322
+ print(" ANCHOR-MISS " + desc + " " + why)
323
+ continue
324
+ with open(p, "w", encoding="utf-8", newline="") as f:
325
+ f.write(mut)
326
+ for root, dd, ff in os.walk(tree):
327
+ if os.path.basename(root) == "__pycache__":
328
+ shutil.rmtree(root, ignore_errors=True)
329
+ rc2, reds2, out2 = _run_in(tree)
330
+ with open(p, "w", encoding="utf-8", newline="") as f:
331
+ f.write(bak)
332
+ hit = sorted({r.split(" ")[0] for r in reds2})
333
+ if rc2 != 0 and hit == sorted(exp):
334
+ print(" OK %s 红项=%d 指定命中=%s" % (desc, len(reds2), hit))
335
+ else:
336
+ bad.append(desc)
337
+ print(" MISMATCH %s 实际红项=%s 期望=%s rc=%d"
338
+ % (desc, hit, sorted(exp), rc2))
339
+ for r in reds2[:12]:
340
+ print(" FAIL " + r)
341
+ print("定点变异自证:%s(%d 条不合格)" % ("PASS" if not bad else "FAIL", len(bad)))
342
+ for b in bad:
343
+ print(" 不合格:" + b)
344
+ return len(bad)
345
+ finally:
346
+ shutil.rmtree(tree, ignore_errors=True)
347
+
348
+
349
+ def main():
350
+ _bad = _mutate() if "--mutate" in sys.argv else 0
351
+ return 1 if (FAILS or _bad) else 0
352
+
353
+
354
+ if __name__ == "__main__":
355
+ sys.exit(main())
@@ -0,0 +1,323 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:孪生编译器不得丢失「术曰」块内赋值——双链字节码等价性回归(issue #326-②)
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue326_twin_parser_parity [--mutate];被测面=md_cg/whitebox_kb/wisdom/core/parser.py 的 IDENTIFIER 分支 lookahead(对照 compiler/parser.py 的同款修复)
4
+ # 子功能:A 组=报告源码的双链等价(指令数 14、初始化赋值在、无「未编译语句类型」告警);K 组=非恒真对照(多词短语/裸标识符的**合并路径**不得被 lookahead 劫持、条件内赋值、混合样本、等价不是「两边都失败」);E 组=源码面(两链同款 lookahead)
5
+ # 执行:--mutate 时在镜像树里逐条把 lookahead 改回缺陷形态 / 过度收紧(无条件走 assign-or-call),守卫必须按指定项转红
6
+ # 验证方式:全部 PASS 即通过(退出码 0);--mutate 下每条变异的红项集合须与预期**逐项相符**
7
+ # 不适用条件:不判「多词短语合并在编译期仍报未编译语句类型」这一**既有**限制(两链一致、非本批);不覆盖名实校验/代码生成面;不判 pbc 序列化形态
8
+ """issue #326-② 守卫:孪生副本必须与 compiler/parser.py 产出**同一字节码**。
9
+
10
+ 病象(修前):孪生 `core/parser.py` 的 IDENTIFIER 分支**无条件**走 `_merge_identifiers()`,
11
+ 从不探视其后是否紧跟 `=` 或 `(`;而 `compiler/parser.py` 已于 2026-09-14 修复并定性为
12
+ 「静默错值,比崩溃更危险」。⇒ 同一中文源码在两条链上产出不同字节码(实测 14 vs 12,
13
+ 孪生缺初始化赋值,且**不报错**——只降级为一条 warning)。该修复此前**无任何测试守护**,
14
+ 这正是孪生漏回移长期未被发现的原因;本守卫即为该守护。
15
+
16
+ 「守卫必须能在变异态下跑完」(task-8/④ 的教训):本守卫的取数与解析全部经 `_try()`
17
+ 包装把异常折成可命名的返回值形态,绝不让变异态在夹具处崩栈中断(红得不可归因)。
18
+ """
19
+ from __future__ import annotations
20
+
21
+ import json
22
+ import os
23
+ import shutil
24
+ import subprocess
25
+ import sys
26
+ import tempfile
27
+
28
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
29
+
30
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
31
+ if _REPO not in sys.path:
32
+ sys.path.insert(0, _REPO)
33
+
34
+ FAILS = []
35
+
36
+
37
+ def _check(name, cond, detail=""):
38
+ if cond:
39
+ print(" PASS " + name)
40
+ else:
41
+ print(" FAIL " + name + " " + str(detail)[:220])
42
+ FAILS.append(name)
43
+
44
+
45
+ _TMP = tempfile.mkdtemp(prefix="iss326b_")
46
+ os.environ.update({"MDCG_ROOT": _TMP + "/brain", "MDCG_STATE_ROOT": _TMP + "/state",
47
+ "MDCG_AUX_ROOT": _TMP + "/auxstore",
48
+ "MDCG_DATA_ROOT": _TMP + "/datastore",
49
+ "MDCG_EXPORT_ROOT": _TMP, "MDCG_SUSTAIN": "0", "MDCG_SLEEP": "0"})
50
+
51
+ from compiler.compiler import compile_source as _ref_cs # noqa: E402
52
+ from md_cg.whitebox_kb.wisdom.core.compiler import compile_source as _twin_cs # noqa: E402
53
+
54
+ _NL = chr(10)
55
+
56
+
57
+ def _try(fn):
58
+ """调 fn:正常返回 ("", 结果);抛异常(含 BaseException)返回 (类型名, None)。"""
59
+ try:
60
+ return "", fn()
61
+ except BaseException as exc: # noqa: BLE001
62
+ return type(exc).__name__, None
63
+
64
+
65
+ def _norm(code):
66
+ """字节码归一成可比形态:[(op 名, arg 的确定性 JSON), ...];None → []。"""
67
+ out = []
68
+ for item in (code or []):
69
+ op, arg = item
70
+ try:
71
+ a = json.dumps(arg, ensure_ascii=False, default=str, sort_keys=True)
72
+ except (TypeError, ValueError):
73
+ a = repr(arg)
74
+ out.append((getattr(op, "name", str(op)), a))
75
+ return out
76
+
77
+
78
+ def _run(cs, src):
79
+ """编译一段源码:返回 (异常名, code, result)——异常折成可命名形态,绝不崩栈。"""
80
+ t, pair = _try(lambda: cs(src))
81
+ if t:
82
+ return t, None, {}
83
+ code, res = pair
84
+ return "", code, res
85
+
86
+
87
+ #: 报告逐字给的复现源码(issue #326-②)。
88
+ _SRC_REPORT = ("术曰:" + _NL + "1。计数 = 0;" + _NL
89
+ + "2。当 计数 小于 3 执行 计数 = 计数 + 1;" + _NL
90
+ + "3。止。" + _NL)
91
+
92
+ #: 等价性语料(每条都在两链上编译并逐条比对)。
93
+ _CORPUS = {
94
+ "report": _SRC_REPORT,
95
+ "assign": "术曰:" + _NL + "1。计数 = 0;" + _NL + "2。止。" + _NL,
96
+ "multiword": "术曰:" + _NL + "1。甲 乙 丙;" + _NL + "2。止。" + _NL,
97
+ "bare_ident": "术曰:" + _NL + "1。甲;" + _NL + "2。止。" + _NL,
98
+ "assign_in_if": ("术曰:" + _NL + "1。若 1 小于 2 则 计数 = 1;" + _NL
99
+ + "2。止。" + _NL),
100
+ "mixed": ("术曰:" + _NL + "1。甲 = 1;" + _NL + "2。当 甲 小于 3 执行 甲 = 甲 + 1;"
101
+ + _NL + "3。乙 丙 丁;" + _NL + "4。止。" + _NL),
102
+ }
103
+
104
+ print("== A 组:#326-② 正题——孪生链必须与 compiler/ 产出同一字节码 ==")
105
+ _te, _tcode, _tres = _run(_twin_cs, _SRC_REPORT)
106
+ _re, _rcode, _rres = _run(_ref_cs, _SRC_REPORT)
107
+ _tn, _rn = _norm(_tcode), _norm(_rcode)
108
+ _check("A01 孪生链编译成功且无异常(不引入新错误)",
109
+ _te == "" and _tres.get("ok") is True and _tres.get("errors") == [],
110
+ (_te, _tres.get("errors")))
111
+ _check("A02 报告读数:孪生链指令数 = 14(修前 12)", len(_tn) == 14, len(_tn))
112
+ _check("A03 报告读数:对照链接口数 = 14", len(_rn) == 14, len(_rn))
113
+ _check("A04 初始化赋值已回移(ENTER_SHUYUE 之后紧跟 PUSH_CONST + STORE_NAME)",
114
+ [n for n, _ in _tn[:3]] == ["ENTER_SHUYUE", "PUSH_CONST", "STORE_NAME"],
115
+ [n for n, _ in _tn[:3]])
116
+ _check("A05 修前那条告警消失(warnings 不含「未编译语句类型: IDENTIFIER」)",
117
+ not any("未编译语句类型" in str(w) for w in (_tres.get("warnings") or [])),
118
+ _tres.get("warnings"))
119
+ _check("A06 双链字节码**逐条等价**(op 名 + 归一化 arg)", _tn == _rn,
120
+ [n for n, _ in _tn][:6] + ["..."] + [n for n, _ in _rn][:6])
121
+ _check("A07 双链 warnings/errors 等值",
122
+ (_tres.get("warnings") or []) == (_rres.get("warnings") or [])
123
+ and (_tres.get("errors") or []) == (_rres.get("errors") or []),
124
+ (_tres.get("warnings"), _rres.get("warnings")))
125
+
126
+ print("== K 组:非恒真对照(lookahead 不得劫持合并路径) ==")
127
+ _bad = []
128
+ _n = 0
129
+ for _k, _src in sorted(_CORPUS.items()):
130
+ _n += 1
131
+ _a, _ac, _ares = _run(_twin_cs, _src)
132
+ _b, _bc, _bres = _run(_ref_cs, _src)
133
+ if _a == "" and _b == "" and _norm(_ac) == _norm(_bc):
134
+ continue
135
+ _bad.append((_k, _a, _b, len(_norm(_ac)), len(_norm(_bc))))
136
+ _check("K01 六条语料全部双链等价(%d/%d)" % (_n - len(_bad), _n), not _bad, _bad)
137
+ _mw_e, _mw_c, _mw_res = _run(_twin_cs, _CORPUS["multiword"])
138
+ _bare_e, _bare_c, _ = _run(_twin_cs, _CORPUS["bare_ident"])
139
+ _check("K02 多词短语语句仍走**合并**路径(不得被 lookahead 劫持成 assign/call)"
140
+ "——与对照链逐条相同且仍是「未编译语句类型」既有形态",
141
+ _mw_e == "" and _norm(_mw_c) == _norm(_run(_ref_cs, _CORPUS["multiword"])[1])
142
+ and any("IDENTIFIER" in str(w) for w in (_mw_res.get("warnings") or [])),
143
+ (_mw_e, _mw_res.get("warnings")))
144
+ _check("K03 裸标识符语句同样保持既有形态(不回退也不冒进)",
145
+ _bare_e == "" and _norm(_bare_c) == _norm(_run(_ref_cs, _CORPUS["bare_ident"])[1]),
146
+ _bare_e)
147
+ _assign_e, _assign_c, _ = _run(_twin_cs, _CORPUS["assign"])
148
+ _check("K04 赋值路径确实生效(孪生链含 STORE_NAME 且与对照链相同)",
149
+ _assign_e == "" and any(n == "STORE_NAME" for n, _ in _norm(_assign_c))
150
+ and _norm(_assign_c) == _norm(_run(_ref_cs, _CORPUS["assign"])[1]),
151
+ [n for n, _ in _norm(_assign_c)])
152
+ _if_e, _if_c, _ = _run(_twin_cs, _CORPUS["assign_in_if"])
153
+ _check("K05 条件内赋值也生效(分支语句不受本次回移影响)",
154
+ _if_e == "" and any(n == "STORE_NAME" for n, _ in _norm(_if_c))
155
+ and _norm(_if_c) == _norm(_run(_ref_cs, _CORPUS["assign_in_if"])[1]),
156
+ [n for n, _ in _norm(_if_c)])
157
+ _check("K06 等价判据不是「两边都失败」(对照链 ok 且指令非空)",
158
+ _rres.get("ok") is True and len(_rn) > 0 and len(_tn) > 0,
159
+ (_rres.get("ok"), len(_rn), len(_tn)))
160
+
161
+ print("== E 组:源码面(两链同款 lookahead) ==")
162
+
163
+
164
+ def _src(rel):
165
+ with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
166
+ return f.read()
167
+
168
+
169
+ _TWIN = "md_cg/whitebox_kb/wisdom/core/parser.py"
170
+ _REF = "compiler/parser.py"
171
+ _LOOK = "_nxt.type in (TokenType.EQUALS,"
172
+ _check("E01 孪生链 IDENTIFIER 分支已带 lookahead(与对照链同款形态)",
173
+ _LOOK in _src(_TWIN), "缺 lookahead")
174
+ _check("E02 对照链同款 lookahead 仍在(两链同形,防单边回退)",
175
+ _LOOK in _src(_REF), "对照链缺 lookahead")
176
+ _check("E03 孪生链仍保留合并腿(lookahead 未把 _merge_identifiers 顶掉)",
177
+ "_parse_assign_or_call()" in _src(_TWIN)
178
+ and "_merge_identifiers()" in _src(_TWIN), "")
179
+ _check("E04 孪生链 _peek_next 仍在(lookahead 的依赖件)",
180
+ "def _peek_next" in _src(_TWIN), "")
181
+
182
+ shutil.rmtree(_TMP, ignore_errors=True)
183
+ print("")
184
+ if FAILS:
185
+ print("issue #326-② 结果:%d 失败" % len(FAILS))
186
+ else:
187
+ print("issue #326-② 结果:全部通过")
188
+
189
+ # ---------------------------------------------------------------- 定点变异表
190
+ # 锚点跨行用 chr(10) 拼接;_apply_text 按目标文件**实际行尾**折算(孪生 parser 为 LF)。
191
+ _LOOKAHEAD = chr(10).join([
192
+ " _nxt = self._peek_next()",
193
+ " if _nxt is not None and _nxt.type in (TokenType.EQUALS,",
194
+ " TokenType.LPAREN):",
195
+ " return self._parse_assign_or_call()",
196
+ " merged = self._merge_identifiers()",
197
+ ])
198
+ _MERGE_ONLY = " merged = self._merge_identifiers()"
199
+ _ALWAYS_ASC = chr(10).join([
200
+ " _nxt = self._peek_next()",
201
+ " if _nxt is not None:",
202
+ " return self._parse_assign_or_call()",
203
+ " merged = self._merge_identifiers()",
204
+ ])
205
+
206
+ _MUTATIONS = (
207
+ # M1 回缺陷(孪生链原先无条件合并)⇒ 赋值腿再次丢失:指令数 12、初始化缺失、
208
+ # 告警重现、双链等价破裂;含赋值的语料(report/assign/assign_in_if/mixed)随之转红。
209
+ # E01(源码面 lookahead 消失)同步转红——回缺陷时「源码面」与「行为面」双证都亮。
210
+ # 恒绿项如实说明:K02/K03(纯合并语料)两态相同;**K05 实测不敏感**——条件内赋值
211
+ # 不经本 IDENTIFIER 分支的 lookahead,故本变异不改变它(不是漏测,是该腿与本变异无关)。
212
+ ("M1 回缺陷:孪生链无条件合并(丢块内赋值)",
213
+ "md_cg/whitebox_kb/wisdom/core/parser.py",
214
+ ((_LOOKAHEAD, _MERGE_ONLY),),
215
+ ("A02", "A04", "A05", "A06", "A07", "E01", "K01", "K04")),
216
+ # M2 过度收紧(下一个 token 只要存在就走 assign-or-call)⇒ **合并路径被劫持**:
217
+ # 多词短语语句不再与对照链等价(这正是 K 组守的方向),E01 源码面同步转红。
218
+ # 恒绿项如实说明:K03(裸标识符「甲;」)实测不敏感——该形态下 assign-or-call 与合并
219
+ # 产出同一字节码;K04/K05(含赋值的语料)两态皆走 assign ⇒ 恒绿(如实)。
220
+ ("M2 过度收紧:无条件走 assign-or-call(劫持合并路径)",
221
+ "md_cg/whitebox_kb/wisdom/core/parser.py",
222
+ ((_LOOKAHEAD, _ALWAYS_ASC),),
223
+ ("E01", "K01", "K02")),
224
+ )
225
+
226
+
227
+ def _mirror_build():
228
+ dst = tempfile.mkdtemp(prefix="iss326b_mut_")
229
+ for name in ("md_cg", "scripts", "compiler"):
230
+ src = os.path.join(_REPO, name)
231
+ if os.path.isdir(src):
232
+ shutil.copytree(src, os.path.join(dst, name),
233
+ ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
234
+ for name in sorted(os.listdir(_REPO)):
235
+ p = os.path.join(_REPO, name)
236
+ if os.path.isfile(p) and (name.endswith(".py")
237
+ or name in ("README.md", "pyproject.toml",
238
+ "package.json")):
239
+ shutil.copy2(p, os.path.join(dst, name))
240
+ return dst
241
+
242
+
243
+ def _apply_text(text, rel, pairs):
244
+ """按目标文件实际行尾折算锚点后逐条替换;任一锚点命中数 != 1 返回 (None, 原因)。"""
245
+ eol = (chr(13) + chr(10)) if (chr(13) + chr(10)) in text else chr(10)
246
+ for old, new in pairs:
247
+ o = old.replace(chr(10), eol)
248
+ n = new.replace(chr(10), eol)
249
+ if text.count(o) != 1:
250
+ return None, "锚点在 %s 里命中 %d 次" % (rel, text.count(o))
251
+ text = text.replace(o, n, 1)
252
+ return text, ""
253
+
254
+
255
+ def _run_in(tree):
256
+ env = dict(os.environ)
257
+ env["PYTHONPATH"] = tree
258
+ env["PYTHONUTF8"] = "1"
259
+ env["PYTHONDONTWRITEBYTECODE"] = "1"
260
+ for k in ("MDCG_ROOT", "MDCG_STATE_ROOT", "MDCG_AUX_ROOT",
261
+ "MDCG_DATA_ROOT", "MDCG_EXPORT_ROOT"):
262
+ env.pop(k, None)
263
+ pr = subprocess.run([sys.executable, "-X", "utf8", "-m",
264
+ "md_cg.test_issue326_twin_parser_parity"],
265
+ capture_output=True, text=True, encoding="utf-8",
266
+ errors="replace", cwd=tree, env=env, timeout=1800)
267
+ out = (pr.stdout or "") + (pr.stderr or "")
268
+ reds = [ln.split("FAIL ", 1)[1].strip()
269
+ for ln in out.splitlines() if ln.strip().startswith("FAIL ")]
270
+ return pr.returncode, reds, out
271
+
272
+
273
+ def _mutate():
274
+ print("!! 定点变异自证:逐条把 lookahead 改回缺陷/过度收紧形态,守卫必须按指定项转红")
275
+ tree = _mirror_build()
276
+ bad = []
277
+ try:
278
+ rc, reds, out = _run_in(tree)
279
+ print(" 未变异镜像基线:rc=%d 红项=%d(必须 rc=0 且 0 红)" % (rc, len(reds)))
280
+ if rc != 0 or reds:
281
+ bad.append("未变异镜像基线即红")
282
+ print(chr(10).join(out.splitlines()[-25:]))
283
+ for desc, rel, pairs, exp in _MUTATIONS:
284
+ p = os.path.join(tree, rel)
285
+ with open(p, encoding="utf-8", newline="") as f:
286
+ bak = f.read()
287
+ mut, why = _apply_text(bak, rel, pairs)
288
+ if mut is None:
289
+ bad.append("%s —— %s" % (desc, why))
290
+ print(" ANCHOR-MISS " + desc + " " + why)
291
+ continue
292
+ with open(p, "w", encoding="utf-8", newline="") as f:
293
+ f.write(mut)
294
+ for root, dd, ff in os.walk(tree):
295
+ if os.path.basename(root) == "__pycache__":
296
+ shutil.rmtree(root, ignore_errors=True)
297
+ rc2, reds2, out2 = _run_in(tree)
298
+ with open(p, "w", encoding="utf-8", newline="") as f:
299
+ f.write(bak)
300
+ hit = sorted({r.split(" ")[0] for r in reds2})
301
+ if rc2 != 0 and hit == sorted(exp):
302
+ print(" OK %s 红项=%d 指定命中=%s" % (desc, len(reds2), hit))
303
+ else:
304
+ bad.append(desc)
305
+ print(" MISMATCH %s 实际红项=%s 期望=%s rc=%d"
306
+ % (desc, hit, sorted(exp), rc2))
307
+ for r in reds2[:12]:
308
+ print(" FAIL " + r)
309
+ print("定点变异自证:%s(%d 条不合格)" % ("PASS" if not bad else "FAIL", len(bad)))
310
+ for b in bad:
311
+ print(" 不合格:" + b)
312
+ return len(bad)
313
+ finally:
314
+ shutil.rmtree(tree, ignore_errors=True)
315
+
316
+
317
+ def main():
318
+ _bad = _mutate() if "--mutate" in sys.argv else 0
319
+ return 1 if (FAILS or _bad) else 0
320
+
321
+
322
+ if __name__ == "__main__":
323
+ sys.exit(main())