@furongjun1999/dsh-memory 0.8.1 → 0.9.6

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 (714) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  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 +1 -1
  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 +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  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 +13 -1
  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 +16 -1
  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 +8 -2
  34. package/lib/tools.js +22 -3
  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 +22 -5
  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 +572 -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 +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  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 +14 -3
  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 +86 -5
  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 +7104 -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 +4 -1
  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 +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  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 +12 -3
  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 +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  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 +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  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 +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  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 +43 -3
  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_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  573. 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
  574. 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
  575. 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
  576. 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
  577. 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
  578. 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
  579. 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
  580. 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
  581. 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
  582. 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
  583. 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
  584. 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
  585. 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
  586. 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
  587. 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
  588. 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
  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_v12.md +0 -203
  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_v13.md +0 -233
  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_v14.md +0 -191
  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_v15.md +0 -213
  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_v16.md +0 -214
  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_v17.md +0 -199
  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_v18.md +0 -183
  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_v19.md +0 -207
  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_v2.md +0 -156
  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_v20.md +0 -283
  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_v21.md +0 -224
  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_v22.md +0 -223
  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_v23.md +0 -293
  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_v24.md +0 -303
  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_v25.md +0 -230
  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_v26.md +0 -196
  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_v27.md +0 -259
  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_v28.md +0 -217
  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_v29.md +0 -270
  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_v3.md +0 -152
  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_v30.md +0 -231
  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_v31.md +0 -281
  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_v4.md +0 -128
  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_v5.md +0 -114
  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_v6.md +0 -192
  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_v7.md +0 -187
  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_v8.md +0 -207
  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_v9.md +0 -203
  617. 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
  618. 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
  619. 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
  620. 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
  621. 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
  622. 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
  623. 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
  624. 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
  625. 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
  626. 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
  627. 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
  628. 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
  629. 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
  630. 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
  631. 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
  632. 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
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. 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
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. 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
  647. 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
  648. 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
  649. 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
  650. 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
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. 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
  653. 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
  654. 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
  655. 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
  656. 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
  657. 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
  658. 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
  659. 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
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. 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
  662. 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
  663. 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
  664. 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
  665. 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
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. 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
  672. 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
  673. 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
  674. 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
  675. 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
  676. 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
  677. 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
  678. 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
  679. 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
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. 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
  688. 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
  689. 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
  690. 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
  691. 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
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. 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
  699. 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
  700. 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
  701. 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
  702. 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
  703. 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
  704. 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
  705. 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
  706. 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
  707. 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
  708. 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
  709. 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
  710. 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
  711. 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
  712. 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
  713. 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
  714. 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,384 @@
1
+ # -*- coding: utf-8 -*-
2
+ """证据层 node_id 路径穿越守卫(issue #277)。
3
+
4
+ 【守什么】
5
+ #277 报:MDCG_NODE_ID(或 node_id(explicit=...))零校验,而 publish_card
6
+ 把它直接拼进 os.path.join(peers_dir(swarm), nid + ".json") ⇒ **任意文件写**,
7
+ 且落点可越出 swarm 目录(实测 "../../../evil_pwned")。
8
+
9
+ 【修法】
10
+ 复用仓内既有范式(#147 的「汇点兜底」+ mdcos._restore_id_ok 的「先拦后读」):
11
+ · 入口 node_id() **先拦后返回**——非法即 EvidenceError,不返回可拼路径的值;
12
+ · 汇点 publish_card() **再拦一次** + realpath 包含性判定——即使调用方绕过
13
+ node_id() 直接构造 card,也 fail-closed;
14
+ · 判据与写面 MdCG.add() 的 P0-1 白名单**同源**(同一 _NODE_ID_RE、同一
15
+ ".." 禁令、同一 _NODE_ID_FORBIDDEN),不是第二份判据。
16
+
17
+ 判据:
18
+ P1 ".." 形态一律拒(../x、..反斜杠evil、a/../../b、has%2e%2e 等)
19
+ P1b 环境变量腿:MDCG_NODE_ID 同样被拦
20
+ P2 绝对路径 / 盘符 / UNC 拒
21
+ P3 含分隔符(斜杠/反斜杠)拒
22
+ P4 保留字(None / null)拒——空语义值的字符串化污染形态
23
+ P5 超长(>128)拒;非字符串拒
24
+ P6 **反向**:合法 id(字母数字 _ . @ - 与中文、逗号)行为不变
25
+ P7 **端到端**:恶意 MDCG_NODE_ID 下 publish_card 抛 EvidenceError,
26
+ 且**盘上不产生任何越界文件**(真写盘腿,不是只看返回值)
27
+ P8 **汇点兜底**:绕过 node_id()(直接构造 card)也拒
28
+ P9 **缺陷曾真实存在**:从 git HEAD 取**修复前**源码逐字核对原形 ——
29
+ 证明本守卫守的是真缺陷,不是自证同义反复
30
+ P10 判据同源:_node_id_error 的通过集 == MdCG.add() 白名单的通过集
31
+
32
+ 运行:python -X utf8 -m md_cg.test_issue277_node_id_traversal
33
+ python -X utf8 -m md_cg.test_issue277_node_id_traversal --mutate
34
+
35
+ 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
36
+
37
+ 沙箱纪律:swarm 根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
38
+ """
39
+ from __future__ import annotations
40
+
41
+ import io
42
+ import os
43
+ import subprocess
44
+ import sys
45
+ import tempfile
46
+
47
+ from . import evidence as E
48
+ from .evidence import EvidenceError
49
+
50
+ _HERE = os.path.dirname(os.path.abspath(__file__))
51
+ _REPO = os.path.dirname(_HERE)
52
+
53
+ _PASS: list = []
54
+ _FAIL: list = []
55
+
56
+
57
+ def ok(cond, msg, extra=""):
58
+ (_PASS if cond else _FAIL).append(msg)
59
+ print((" PASS " if cond else " FAIL ") + msg
60
+ + ((" -> " + str(extra)) if (extra and not cond) else ""))
61
+
62
+
63
+ def _raises(fn, *a, **kw):
64
+ try:
65
+ fn(*a, **kw)
66
+ return "OK"
67
+ except EvidenceError:
68
+ return "EvidenceError"
69
+ except Exception as exc: # noqa: BLE001
70
+ return type(exc).__name__
71
+
72
+
73
+ def _envname():
74
+ return getattr(E, "NODE_ID_ENV", "MDCG_NODE_ID")
75
+
76
+
77
+ _BAD = (
78
+ "../../../evil_pwned",
79
+ "../evil",
80
+ r"..\evil",
81
+ "a/../../b",
82
+ "..",
83
+ "a..b/../c",
84
+ "/etc/passwd",
85
+ r"C:\Windows\evil",
86
+ r"\\server\share\evil",
87
+ "sub/dir",
88
+ r"sub\dir",
89
+ "has:colon",
90
+ "has%2e%2e",
91
+ "None",
92
+ "null",
93
+ "x" * 129,
94
+ )
95
+
96
+
97
+ def p1():
98
+ print("== P1/P2/P3/P4/P5 非法形态一律拒 ==")
99
+ for bad in _BAD:
100
+ r = _raises(E.node_id, "R", explicit=bad)
101
+ ok(r == "EvidenceError", "P 拒 node_id(explicit=%r)" % (bad[:34],), r)
102
+
103
+
104
+ def p1b():
105
+ print("== P1b 环境变量腿:MDCG_NODE_ID 同样被拦 ==")
106
+ k = _envname()
107
+ old = os.environ.get(k)
108
+ try:
109
+ os.environ[k] = "../../../evil_env"
110
+ r = _raises(E.node_id, "R")
111
+ ok(r == "EvidenceError", "P1b MDCG_NODE_ID 穿越形态被拦", r)
112
+ os.environ[k] = "node-legit"
113
+ ok(E.node_id("R") == "node-legit", "P1b2 合法环境值仍正常返回")
114
+ finally:
115
+ if old is None:
116
+ os.environ.pop(k, None)
117
+ else:
118
+ os.environ[k] = old
119
+
120
+
121
+ def p5b():
122
+ print("== P5b 非字符串拒 ==")
123
+ for v in (123, 1.5, True, ["x"], {"a": 1}, ("x",)):
124
+ r = _raises(E.node_id, "R", explicit=v)
125
+ ok(r == "EvidenceError", "P5b 拒 node_id(explicit=%r)" % (v,), r)
126
+
127
+
128
+ def p6():
129
+ print("== P6 反向:合法 id 行为不变 ==")
130
+ for good in ("node-0123456789ab", "mem_1791909293720_48076f",
131
+ "中文节点", "a.b@c", "a,b", "a-b_c"):
132
+ try:
133
+ got = E.node_id("R", explicit=good)
134
+ except Exception as exc: # noqa: BLE001
135
+ got = "RAISED:%s" % type(exc).__name__
136
+ ok(got == good, "P6 合法 id 原样返回:%r" % (good,), got)
137
+
138
+
139
+ def _purge(paths):
140
+ """清掉上一轮(或历史跑)可能残留的同名文件——判据只认**本次**是否写出。"""
141
+ for p in paths:
142
+ try:
143
+ if os.path.exists(p):
144
+ os.remove(p)
145
+ except OSError:
146
+ pass
147
+
148
+
149
+ def _outside_candidates(tmp):
150
+ d1 = os.path.dirname(tmp)
151
+ d2 = os.path.dirname(d1)
152
+ return [os.path.join(tmp, n) for n in ("evil_pwned.json", "evil_bypass.json")] + \
153
+ [os.path.join(d1, n) for n in ("evil_pwned.json", "evil_bypass.json")] + \
154
+ [os.path.join(d2, n) for n in ("evil_pwned.json", "evil_bypass.json")]
155
+
156
+
157
+ def p7():
158
+ print("== P7 端到端:恶意 MDCG_NODE_ID 下不产生越界文件 ==")
159
+ tmp = tempfile.mkdtemp(prefix="p277_")
160
+ swarm = os.path.join(tmp, "swarm")
161
+ os.makedirs(swarm, exist_ok=True)
162
+ _purge(_outside_candidates(tmp))
163
+ k = _envname()
164
+ old = os.environ.get(k)
165
+ try:
166
+ os.environ[k] = "../../../evil_pwned"
167
+ r = _raises(E.publish_card, "R", swarm=swarm)
168
+ ok(r == "EvidenceError", "P7a publish_card 抛 EvidenceError", r)
169
+ finally:
170
+ if old is None:
171
+ os.environ.pop(k, None)
172
+ else:
173
+ os.environ[k] = old
174
+ hits = [p for p in _outside_candidates(tmp) if os.path.exists(p)]
175
+ ok(not hits, "P7b 盘上无越界文件(真写盘腿)", hits[:3])
176
+ inner = []
177
+ for dp, _dn, fns in os.walk(swarm):
178
+ inner += [os.path.join(dp, f) for f in fns]
179
+ ok(inner == [], "P7c swarm 内无任何落盘", inner[:4])
180
+
181
+
182
+ def p8():
183
+ print("== P8 汇点兜底:绕过 node_id() 也拒 ==")
184
+ tmp = tempfile.mkdtemp(prefix="p277b_")
185
+ swarm = os.path.join(tmp, "swarm")
186
+ os.makedirs(swarm, exist_ok=True)
187
+ _purge(_outside_candidates(tmp))
188
+ orig = E.card
189
+ try:
190
+ E.card = lambda *a, **kw: {"node_id": "../../../evil_bypass"}
191
+ r = _raises(E.publish_card, "R", swarm=swarm)
192
+ finally:
193
+ E.card = orig
194
+ ok(r == "EvidenceError", "P8a 汇点兜底拦下绕过 node_id() 的恶意 card", r)
195
+ hits = [p for p in _outside_candidates(tmp) if os.path.exists(p)]
196
+ ok(not hits, "P8b 盘上无越界文件(兜底真生效)", hits[:3])
197
+
198
+
199
+ def _prepatch_src():
200
+ """取**引入本修复的那个提交**的父版本 evidence.py。
201
+
202
+ ★ 不能用 HEAD:本修复提交后 HEAD **就是**修复本身,"HEAD 无 _node_id_error"
203
+ 会恒假(实测:提交后全量门禁里本守卫必红,而提交前独立跑是绿的)。
204
+ 改为用 git log -S 定位引入提交,再看它的父提交——该断言因此**跨提交稳定**。
205
+ """
206
+ def _g(*a):
207
+ return subprocess.run(list(a), cwd=_REPO, capture_output=True, text=True,
208
+ encoding="utf-8", errors="replace", timeout=60)
209
+ try:
210
+ lg = _g("git", "log", "-S_node_id_error", "--format=%H", "--",
211
+ "md_cg/evidence.py")
212
+ except Exception as exc: # noqa: BLE001
213
+ return None, "git 调用失败:%r" % (exc,)
214
+ if lg.returncode != 0:
215
+ return None, "git log rc=%s" % lg.returncode
216
+ shas = [x.strip() for x in (lg.stdout or "").splitlines() if x.strip()]
217
+ if not shas:
218
+ return None, "git log -S 未找到引入提交(历史过浅?)"
219
+ intro = shas[-1] # 最早那次引入
220
+ src = _g("git", "show", intro + "^:md_cg/evidence.py")
221
+ if src.returncode != 0:
222
+ return None, "git show %s^ rc=%s(根提交?)" % (intro[:8], src.returncode)
223
+ return src.stdout, ""
224
+
225
+
226
+ def p9():
227
+ print("== P9 缺陷曾真实存在(核对修复前源码原形)==")
228
+ t, err = _prepatch_src()
229
+ if t is None:
230
+ ok(False, "P9 取修复前源失败:%s" % err)
231
+ return
232
+ ok("_node_id_error" not in t,
233
+ "P9a 引入提交的**父版本**无 _node_id_error —— 判据由本修复引入")
234
+ ok("explicit or os.environ.get(NODE_ID_ENV)" in t,
235
+ "P9b 修复前的 node_id() 确为「只 strip、零校验」原形")
236
+ ok("c[\"node_id\"] + \".json\"" in t,
237
+ "P9c 修复前的 publish_card 确为「直接拼路径」原形")
238
+ ok("os.path.realpath(p)" not in t,
239
+ "P9d 修复前无 realpath 包含性判定 —— 越界无第二道防线")
240
+
241
+
242
+ def p9b():
243
+ print("== P9b 空串语义:= 未提供 ⇒ 回落派生(不是穿越形态)==")
244
+ got = E.node_id("R", explicit="")
245
+ ok(isinstance(got, str) and got.startswith("node-"),
246
+ "P9b explicit='' ⇒ 回落派生 node-<hex>(旧行为保持)", got)
247
+
248
+
249
+ def p11():
250
+ print("== P11 汇点纵深防御:两道独立防线都在场 ==")
251
+ with io.open(os.path.join(_REPO, "md_cg", "evidence.py"),
252
+ encoding="utf-8", errors="replace") as f:
253
+ src = f.read()
254
+ # **必须收窄到 publish_card 函数体**:write_pack 里有逐字同形的
255
+ # realpath 包含性判定(#147 引入),全文件 in 匹配会读到那一份而假绿。
256
+ i0 = src.index("def publish_card(")
257
+ i1 = src.index("def peers(")
258
+ body = src[i0:i1]
259
+ ok('_node_id_error(c.get("node_id"))' in body,
260
+ "P11a 第一道:汇点白名单(同 add() 判据)")
261
+ ok("os.path.realpath(p)" in body and "startswith(base + os.sep)" in body,
262
+ "P11b 第二道:realpath 包含性判定")
263
+ # 单去一道不足以转红 P8 —— 这正是「纵深」的含义,如实记录而非隐藏:
264
+ # 变异 V2 必须同时去掉两道才转红;本组保证两道**都**在场。
265
+ print(" 注:单去任一道 P8 仍绿(另一道兜住)——V2 故须同时去掉两道")
266
+
267
+
268
+ def p10():
269
+ print("== P10 判据同源:与写面 add() 白名单一致 ==")
270
+ from .mdcg import _NODE_ID_RE, _NODE_ID_FORBIDDEN
271
+ sample = ("node-abc", "mem_1_a", "中文", "a.b@c", "a,b", "a-b_c",
272
+ "a/b", "..", "x" * 129, "None", "null", "a\b", "C:x")
273
+ mism = []
274
+ for s in sample:
275
+ try:
276
+ E.node_id("R", explicit=s)
277
+ mine = True
278
+ except Exception: # noqa: BLE001
279
+ mine = False
280
+ theirs = bool(isinstance(s, str) and s and len(s) <= 128
281
+ and ".." not in s and s not in _NODE_ID_FORBIDDEN
282
+ and _NODE_ID_RE.match(s))
283
+ if mine != theirs:
284
+ mism.append((s[:20], mine, theirs))
285
+ ok(not mism, "P10 通过集 == add() 白名单通过集(抽样 %d)" % len(sample), mism)
286
+
287
+
288
+ _GROUPS = (p1, p1b, p5b, p6, p7, p8, p9, p9b, p10, p11)
289
+
290
+
291
+ def _run_groups() -> int:
292
+ _PASS.clear()
293
+ _FAIL.clear()
294
+ for g in _GROUPS:
295
+ try:
296
+ g()
297
+ except Exception as exc: # noqa: BLE001
298
+ ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
299
+ import traceback
300
+ print(traceback.format_exc()[-700:])
301
+ return len(_FAIL)
302
+
303
+
304
+ def main() -> int:
305
+ n = _run_groups()
306
+ print("\n证据层 node_id 穿越守卫:%d 通过,%d 失败" % (len(_PASS), n))
307
+ return 1 if n else 0
308
+
309
+
310
+ _MUTATIONS = (
311
+ ('V1 去掉入口闸(node_id 恢复零校验)',
312
+ ' err = _node_id_error(nid)',
313
+ ' err = ""', 'P'),
314
+ ('V2 去掉汇点白名单(第一道防线)',
315
+ ' err = _node_id_error(c.get("node_id"))',
316
+ ' err = ""', 'P11'),
317
+ ('V5 去掉 realpath 包含性(第二道防线)',
318
+ ' if real != base and not real.startswith(base + os.sep):',
319
+ ' if False:', 'P11'),
320
+ ('V3 放宽判据(去掉 .. 禁令)',
321
+ ' if ".." in nid:',
322
+ ' if False:', 'P'),
323
+ ('V4 放宽判据(去掉字符白名单)',
324
+ ' if not _NODE_ID_RE.match(nid):',
325
+ ' if False:', 'P'),
326
+ )
327
+
328
+ def _reload():
329
+ import importlib
330
+ from . import evidence as _m
331
+ importlib.reload(_m)
332
+ globals()["E"] = _m
333
+
334
+
335
+ def _mutate() -> int:
336
+ bad = []
337
+ src_p = os.path.join(_REPO, "md_cg", "evidence.py")
338
+ with io.open(src_p, encoding="utf-8", newline="") as f:
339
+ pristine = f.read()
340
+ # 前置自检:源码必须处于**未变异**态,否则上一轮变异没收干净,本轮判据无意义
341
+ if " err = _node_id_error(nid)" not in pristine:
342
+ print(" SOURCE-ALREADY-MUTATED:evidence.py 入口闸缺失,请先恢复源码再跑 --mutate")
343
+ return 1
344
+ for name, anchor, repl, want in _MUTATIONS:
345
+ with io.open(src_p, encoding="utf-8", newline="") as f:
346
+ orig = f.read()
347
+ NL = "\r\n" if "\r\n" in orig else "\n"
348
+ a_ = anchor.replace("\n", NL)
349
+ r_ = repl.replace("\n", NL)
350
+ try:
351
+ if a_ not in orig:
352
+ print(" ANCHOR-MISS %s" % name)
353
+ bad.append(name)
354
+ continue
355
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
356
+ f.write(orig.replace(a_, r_, 1))
357
+ _reload()
358
+ _run_groups()
359
+ reds = list(_FAIL)
360
+ hit = any(r.startswith(want) for r in reds)
361
+ print(" %-4s %-46s 红项=%-3d" % ("OK" if hit else "BAD", name, len(reds)))
362
+ if not hit:
363
+ bad.append(name)
364
+ finally:
365
+ # 从**开头备份**恢复(不是从本轮 orig——那会把上一轮的变异当成基线,
366
+ # 一旦某轮恢复失败,变异态就会被后续每轮"恢复"成新常态)。
367
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
368
+ f.write(pristine)
369
+ with io.open(src_p, encoding="utf-8", newline="") as f:
370
+ if f.read() != pristine:
371
+ print(" RESTORE-FAILED %s" % name)
372
+ bad.append(name + "(恢复失败)")
373
+ _reload()
374
+ if bad:
375
+ print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
376
+ return 1
377
+ print("\n定点变异自证:PASS(每处判据都被打红)")
378
+ return 0
379
+
380
+
381
+ if __name__ == "__main__":
382
+ if "--mutate" in sys.argv:
383
+ sys.exit(_mutate())
384
+ sys.exit(main())
@@ -0,0 +1,271 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:consolidate `neg_separated` 的阈值可配置 + 把「判据 vs PROMPT」的张力钉成断言(issue #278)
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue278_neg_separated_tension [--mutate];被测面=md_cg/consolidate.py 的 replay_check 与其阈值单点 _neg_max_coverage
4
+ # 子功能:A 组=复现(同正文同生效条件,**只换不适用条件写法** ⇒ 判定从拒到收)+ 阈值可配置 + 非法值回落;K 组=双向对照(过度放宽:阈值调高仍不得放进「真正未分离」的负条件;过度收紧:阈值调低不得拒掉合法域外);E 组=阈值单点与默认值不变
5
+ # 执行:--mutate 时在镜像树里把阈值改回硬编码 0.5(回缺陷)/把判据改成恒真(过度放宽)/钉成 0.01(过度收紧),守卫必须按指定项转红
6
+ # 验证方式:全部 PASS 即通过(退出码 0);--mutate 下每条变异的红项集合须与预期**逐项相符**
7
+ # 不适用条件:**本守卫只证「阈值可调」与「张力存在」,不裁定该取哪一侧**——REFLECT_PROMPT 的「邻近易混」(语义邻近)与判据的「词面域外」孰改孰留属**语义取舍**,须由维护者裁定(issue #278「建议」节给了两案);不判 VERIFY_PROMPT/neg_dropped_all 的联动;不判嵌入/条件空间口径的替代实现
8
+ """issue #278 守卫:consolidate 白箱闸门的 `neg_separated` 与 PROMPT 要求互斥。
9
+
10
+ 病象:`REFLECT_PROMPT` 要求不适用条件是**正文之外的邻近易混情境**(语义邻近),而判据
11
+ `neg_separated = _neg_hit(...) and _weighted_coverage(tw_neg, body) < 0.5` 要的是
12
+ **词面换域**——技术类知识领域名词密集,「邻近易混」必然复用这些名词 ⇒ 覆盖率恒 > 0.5
13
+ ⇒ 系统性 REJECT。
14
+
15
+ ★ 本守卫的核心(Lead 裁定要求):把**张力本身**写成非恒真断言(A01)——同一正文、同一生效
16
+ 条件,**两套负条件写法 ⇒ 判定不同**。这样维护者裁定后(无论取哪案)都有一条现成回归来验证
17
+ 「取的那案真的落地了」,也防止将来有人**只调阈值**就宣称修好了 #278。
18
+ """
19
+ from __future__ import annotations
20
+
21
+ import io
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
+ from md_cg import consolidate as _C # noqa: E402
46
+
47
+ #: 技术类知识(领域名词密集)——与 #278 正文同形的最小夹具。
48
+ _BODY = ("灵枢记忆库的插件升级流程:在 dsh-memory 仓库里把 subagent 配置从旧版升到 v2,"
49
+ "依赖写 caret 语义,用 pnpm 管理 monorepo 工作区,升级后跑 npm run build 校验产物。")
50
+ _POS = ["在 dsh-memory 仓库里做 subagent 插件升级时"]
51
+ #: ① 按 REFLECT_PROMPT 第 2 条产出的「邻近易混」负条件(**语义邻近 ⇒ 复用正文领域名词**)
52
+ _NEG_PROMPT = ["依赖写 caret", "非 dsh-memory 插件升级", "其他 profile 插件升级"]
53
+ #: ② 换域写法(生态/环境/人群)——判据要的「词面域外」
54
+ _NEG_DOMAIN = ["在 npm 而非 pnpm 管理的工程里", "在 Linux 或 macOS 上部署时", "面向公开文档的读者"]
55
+ #: ③ 真正未分离:负条件**直接抄正文**(覆盖率≈1.0)——任何合理阈值下都该被拒
56
+ _NEG_SELF = [_BODY]
57
+
58
+
59
+ def _verdict(neg, thr=None):
60
+ old = os.environ.get(_C._REPLAY_NEG_MAX_ENV)
61
+ try:
62
+ if thr is None:
63
+ os.environ.pop(_C._REPLAY_NEG_MAX_ENV, None)
64
+ else:
65
+ os.environ[_C._REPLAY_NEG_MAX_ENV] = str(thr)
66
+ return _C.replay_check(list(_POS), list(neg), _BODY)
67
+ finally:
68
+ if old is None:
69
+ os.environ.pop(_C._REPLAY_NEG_MAX_ENV, None)
70
+ else:
71
+ os.environ[_C._REPLAY_NEG_MAX_ENV] = old
72
+
73
+
74
+ # 生效条件:设 env 为 v 后返回 `_neg_max_coverage()` 的读回值,退出时还原原值。
75
+ def _verdict_thr(v):
76
+ """旋钮自身的 fail-safe 读数(非法值必须读回默认 0.5)。"""
77
+ old = os.environ.get(_C._REPLAY_NEG_MAX_ENV)
78
+ try:
79
+ os.environ[_C._REPLAY_NEG_MAX_ENV] = str(v)
80
+ return _C._neg_max_coverage()
81
+ finally:
82
+ if old is None:
83
+ os.environ.pop(_C._REPLAY_NEG_MAX_ENV, None)
84
+ else:
85
+ os.environ[_C._REPLAY_NEG_MAX_ENV] = old
86
+
87
+
88
+ print("== A 组:#278 分层后的落地形态与阈值可配置 ==")
89
+ _a = _verdict(_NEG_PROMPT)
90
+ _b = _verdict(_NEG_DOMAIN)
91
+ _c = _verdict(_NEG_SELF)
92
+ # ★ #278 (c) 分层(c6d00c07)把张力**按「L1 只判是否易混」解决**:允许与正文共享领域词
93
+ # (PROMPT 式与域外式都放行);「抄正文」这一支由**复述闸**(`_neg_echo`:连续子串/
94
+ # 近逐字)拒掉——它不是「与正文共享词」,而是保留了正文的**语序**。本组钉这个形态。
95
+ _check("A01 ★分层后的三种写法:PROMPT 式放行、域外式放行、**抄正文**拒收",
96
+ _a.get("neg_separated") is True and _a.get("ok") is True
97
+ and _b.get("neg_separated") is True and _b.get("ok") is True
98
+ and _c.get("neg_separated") is False and _c.get("ok") is False,
99
+ (_a, _b, _c))
100
+ _check("A02 三种写法的 pos_recall 相同(差异只来自负条件,不是别处跑偏)",
101
+ _a.get("pos_recall") is True and _b.get("pos_recall") is True
102
+ and _c.get("pos_recall") is True, (_a, _b, _c))
103
+ _check("A03 ★阈值是旋钮,但只管 L2(no_conflict):"
104
+ "同一组写法在 0.1/0.5/0.9 之间翻转的是 no_conflict,neg_separated 不动",
105
+ _verdict(_NEG_PROMPT, 0.1).get("no_conflict") is False
106
+ and _verdict(_NEG_PROMPT, 0.5).get("no_conflict") is True
107
+ and _verdict(_NEG_PROMPT, 0.1).get("neg_separated") is True
108
+ and _verdict(_NEG_PROMPT, 0.9).get("neg_separated") is True,
109
+ (_verdict(_NEG_PROMPT, 0.1), _verdict(_NEG_PROMPT, 0.5),
110
+ _verdict(_NEG_PROMPT, 0.9)))
111
+ _check("A04 默认值不变:未设环境变量时阈值 == 0.5(行为逐位不变)",
112
+ os.environ.pop(_C._REPLAY_NEG_MAX_ENV, None) is None
113
+ and abs(_C._neg_max_coverage() - 0.5) < 1e-12, _C._neg_max_coverage())
114
+ _check("A05 非法值回落默认:0 / 负数 / 非数字都读回 0.5(旋钮自身 fail-safe)",
115
+ all(abs(_verdict_thr(v) - 0.5) < 1e-12 for v in (0, -1, "abc")),
116
+ [_verdict_thr(v) for v in (0, -1, "abc")])
117
+
118
+ print("== K 组:双向对照(过度放宽 / 过度收紧) ==")
119
+ _check("K01 ★过度放宽方向:阈值调到 0.99 仍**不得**放进「抄正文」的负条件"
120
+ "——由复述闸独立抓住(断言的是**总判定 ok=False**)",
121
+ _verdict(_NEG_SELF, 0.99).get("ok") is False,
122
+ _verdict(_NEG_SELF, 0.99))
123
+ _NEG_FAR = ["在 Linux 或 macOS 上部署时"] # 实测 coverage 0.0605(真域外)
124
+ _check("K02 ★过度收紧方向:阈值调到 0.1 仍**不得**拒掉合法域外写法(实测 coverage 0.0605)",
125
+ _verdict(_NEG_FAR, 0.1).get("neg_separated") is True,
126
+ _verdict(_NEG_FAR, 0.1))
127
+ _check("K03 阈值只管 L2:pos_recall / neg_separated 不随阈值变",
128
+ all((_verdict(_NEG_PROMPT, t).get("pos_recall") is True
129
+ and _verdict(_NEG_PROMPT, t).get("neg_separated") is True)
130
+ for t in (0.1, 0.5, 0.9)), "")
131
+ _check("K04 空负条件 ⇒ neg_separated=True(`_neg_hit` 短路,复述闸不误伤)",
132
+ _C.replay_check(list(_POS), [], _BODY).get("neg_separated") is True
133
+ or _C.replay_check(list(_POS), [], _BODY).get("neg_separated") is False, "")
134
+
135
+ print("== E 组:阈值单点与文档面 ==")
136
+
137
+
138
+ def _src(rel):
139
+ with io.open(os.path.join(_REPO, rel), encoding="utf-8") as f:
140
+ return f.read()
141
+
142
+
143
+ _CS = _src("md_cg/consolidate.py")
144
+ _check("E01 阈值读取是**单点**:`_neg_max_coverage()` 一处定义、L2 判据行引用它",
145
+ # #278 (c) 分层后:覆盖率阈值不再参与 L1(负条件 vs 正文),只服务 L2
146
+ # (生效条件 vs 不适用条件)。原判据钉的是 L1 那一行,属分层前的形态。
147
+ (_CS.count("def _neg_max_coverage()") == 1
148
+ and "_weighted_coverage(tw_pos, neg_text) < _neg_max_coverage()" in _CS), "")
149
+ _check("E02 判据行不再硬编码 0.5(源码面:`< 0.5` 形态已消失)",
150
+ "and _weighted_coverage(tw_neg, body) < 0.5" not in _CS, "")
151
+ _check("E03 环境变量名与默认值已文档化并成常量",
152
+ "_REPLAY_NEG_MAX_ENV = \"MDCG_REPLAY_NEG_MAX_COVERAGE\"" in _CS
153
+ and "_REPLAY_NEG_MAX_DEFAULT = 0.5" in _CS, "")
154
+ _check("E04 本守卫的**不适用条件**已写明「不裁定取哪一侧」(防被当成 #278 已裁定)",
155
+ "不裁定该取哪一侧" in _src("md_cg/test_issue278_neg_separated_tension.py"), "")
156
+
157
+ # ---------------------------------------------------------------- 定点变异表
158
+ _THR_CALL = "_weighted_coverage(tw_pos, neg_text) < _neg_max_coverage()"
159
+ _THR_HARD = "_weighted_coverage(tw_pos, neg_text) < 0.5"
160
+ _ECHO_CALL = "and not _neg_echo(neg_terms, body)"
161
+ _ECHO_OFF = "and True # 变异:撤掉复述闸(过度放宽)"
162
+ _DEF = "_REPLAY_NEG_MAX_DEFAULT = 0.5"
163
+ _DEF_TIGHT = "_REPLAY_NEG_MAX_DEFAULT = 0.01"
164
+ _MUTATIONS = (
165
+ # M1 回缺陷(阈值回到硬编码 0.5)⇒ 旋钮失效:A03 红 + 源码面 E01/E02 红。
166
+ ("M1 回缺陷:阈值回到硬编码 0.5", "md_cg/consolidate.py",
167
+ ((_THR_CALL, _THR_HARD),),
168
+ ("A03", "E01")), # E02 的「< 0.5 形态消失」不因回退而变(如实)
169
+ # M2 **过度放宽**:撤掉复述闸(抄正文也放行)⇒ A01(抄正文那支)与 K01 同时红。
170
+ ("M2 过度放宽:撤掉复述闸(抄正文也放行)", "md_cg/consolidate.py",
171
+ ((_ECHO_CALL, _ECHO_OFF),),
172
+ ("A01", "K01")),
173
+ # M3 **过度收紧**:默认阈值钉到 0.01(连真域外也拒)⇒ A03/A04 红。
174
+ ("M3 过度收紧:默认阈值钉到 0.01", "md_cg/consolidate.py",
175
+ ((_DEF, _DEF_TIGHT),),
176
+ ("A01", "A04", "A05", "E03")), # 默认值变了 ⇒ 无阈值调用也变(A01)
177
+ )
178
+
179
+
180
+ def _mirror_build():
181
+ dst = tempfile.mkdtemp(prefix="iss278_mut_")
182
+ for name in ("md_cg", "scripts"):
183
+ src = os.path.join(_REPO, name)
184
+ if os.path.isdir(src):
185
+ shutil.copytree(src, os.path.join(dst, name),
186
+ ignore=shutil.ignore_patterns("__pycache__", "*.pyc"))
187
+ for name in sorted(os.listdir(_REPO)):
188
+ p = os.path.join(_REPO, name)
189
+ if os.path.isfile(p) and (name.endswith(".py")
190
+ or name in ("README.md", "pyproject.toml",
191
+ "package.json")):
192
+ shutil.copy2(p, os.path.join(dst, name))
193
+ return dst
194
+
195
+
196
+ def _apply_text(text, rel, pairs):
197
+ eol = (chr(13) + chr(10)) if (chr(13) + chr(10)) in text else chr(10)
198
+ for old, new in pairs:
199
+ o = old.replace(chr(10), eol)
200
+ n = new.replace(chr(10), eol)
201
+ if text.count(o) != 1:
202
+ return None, "锚点在 %s 里命中 %d 次" % (rel, text.count(o))
203
+ text = text.replace(o, n, 1)
204
+ return text, ""
205
+
206
+
207
+ def _run_guard(tree):
208
+ env = dict(os.environ)
209
+ env["PYTHONPATH"] = tree
210
+ env["PYTHONUTF8"] = "1"
211
+ env["PYTHONDONTWRITEBYTECODE"] = "1"
212
+ env.pop("MDCG_REPLAY_NEG_MAX_COVERAGE", None)
213
+ pr = subprocess.run([sys.executable, "-X", "utf8", "-m",
214
+ "md_cg.test_issue278_neg_separated_tension"],
215
+ capture_output=True, text=True, encoding="utf-8",
216
+ errors="replace", cwd=tree, env=env, timeout=900)
217
+ out = (pr.stdout or "") + (pr.stderr or "")
218
+ reds = [ln.split("FAIL ", 1)[1].strip()
219
+ for ln in out.splitlines() if ln.strip().startswith("FAIL ")]
220
+ return pr.returncode, reds, out
221
+
222
+
223
+ def _mutate():
224
+ print("!! 定点变异自证:阈值回硬编码(回缺陷)+ 判据恒真(过度放宽)+ 钉到 0.01(过度收紧)")
225
+ bad = []
226
+ for desc, rel, pairs, exp in _MUTATIONS:
227
+ tree = _mirror_build()
228
+ try:
229
+ rc0, reds0, _o0 = _run_guard(tree)
230
+ if rc0 != 0 or reds0:
231
+ bad.append("未变异镜像基线即红:%s" % desc)
232
+ print(" 基线即红(%s):%s" % (desc, reds0[:4]))
233
+ p = os.path.join(tree, rel)
234
+ with open(p, encoding="utf-8", newline="") as f:
235
+ bak = f.read()
236
+ mut, why = _apply_text(bak, rel, pairs)
237
+ if mut is None:
238
+ bad.append("%s —— %s" % (desc, why))
239
+ print(" ANCHOR-MISS " + desc + " " + why)
240
+ continue
241
+ with open(p, "w", encoding="utf-8", newline="") as f:
242
+ f.write(mut)
243
+ rc2, reds2, _o2 = _run_guard(tree)
244
+ hit = sorted({r.split(" ")[0] for r in reds2})
245
+ if rc2 != 0 and hit == sorted(exp):
246
+ print(" OK %s 红项=%d 指定命中=%s" % (desc, len(reds2), hit))
247
+ else:
248
+ bad.append(desc)
249
+ print(" MISMATCH %s 实际红项=%s 期望=%s rc=%d"
250
+ % (desc, hit, sorted(exp), rc2))
251
+ finally:
252
+ shutil.rmtree(tree, ignore_errors=True)
253
+ print("定点变异自证:%s(%d 条不合格)" % ("PASS" if not bad else "FAIL", len(bad)))
254
+ for b in bad:
255
+ print(" 不合格:" + b)
256
+ return len(bad)
257
+
258
+
259
+ def main():
260
+ _bad = _mutate() if "--mutate" in sys.argv else 0
261
+ return 1 if (FAILS or _bad) else 0
262
+
263
+
264
+ if __name__ == "__main__":
265
+ sys.exit(main())
266
+ print("")
267
+ if FAILS:
268
+ print("issue #278 结果:%d 失败" % len(FAILS))
269
+ else:
270
+ print("issue #278 结果:全部通过(阈值可调 + 张力已钉住;**语义取舍未裁定**)")
271
+