@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,806 @@
1
+ # -*- coding: utf-8 -*-
2
+ """整理巡检幂等守卫(issue #190)。
3
+
4
+ 【守什么】
5
+ #190 报:MCP 常驻循环缺省每 6h 调 writelimit.tidy_contextual(apply=True),而它
6
+ **不认已整理过的成员**——同一组同模板 contextual 记忆每轮都被再列一遍,保留节点
7
+ 正文再追加一段「# 整理聚合」、merge_count 再加一遍,成员再降权一次
8
+ (0.6→0.3→0.15→0.1)、文件再重写一次。带「# 功能名:X」标题的组会一直这样下去,
9
+ 保留节点正文线性增长无上限;无标题短记忆则每轮把一个已收敛成员提升成新的保留节点
10
+ 再追加一遍,直到组里不足 3 条。
11
+
12
+ 复核成立(改前实测,逐字读数见 delivery-20261013/PR190/repro_before.txt,
13
+ 源 sha256 9cd14ea40d7c21d048306d01fa20aa77f56dbea7ead61a50148f7482f10f1090):
14
+ 直造存量同构组(A 无标题短记忆×5 + B 带标题长正文×5,均 importance=0.6)连跑
15
+ 3 轮 apply=True ⇒
16
+ round1 applied_count=8 变化文件=10 A keep 26→224B merge_count 0→4
17
+ round2 applied_count=7 变化文件=9 B keep 1397→2039B merge_count 4→8
18
+ round3 applied_count=6 变化文件=8 B keep 2039→2681B merge_count 8→12
19
+ 成员 importance 0.6→0.3→0.15→0.1(每轮再降一次)
20
+
21
+ 病灶:tidy_contextual 的分组循环只看 layer=="contextual" + template_signature
22
+ 非空,**没有任何「这节点已整理过」的判据**;已打 tidy:converged / 已置
23
+ lifecycle_state="converged" 的成员下一轮照旧入组、照旧 _demote、照旧被写进保留
24
+ 节点的成员清单。
25
+
26
+ 修法(writelimit.py,最小改动;不新增字段、不改既有键与语义):
27
+ ① 模块级真源常量 TIDY_TAG = "tidy:converged",_demote 改用它(带引号字面量
28
+ 全文件只剩定义处 1 处);
29
+ ② 新增纯函数 _already_tidied(e):tags 含 TIDY_TAG 或
30
+ frontmatter[lifecycle.STATE_FIELD]=="converged" 即为已整理——两者都是修复前
31
+ 就已落盘的既有标记,故历史存量天然被认账,无需迁移;
32
+ ③ tidy_contextual 扫描阶段命中即 continue(不进组、不降权、不重写保留节点);
33
+ ④ 返回 dict 新增键 already_tidied(跳过计数),其余键与语义不变
34
+ (sustain._tick_tidy 消费的 t/scanned/groups/members/applied_count 全在)。
35
+ 改后实测(逐字读数见 repro_after.txt,源 sha256
36
+ 65558eedaca089c354f29c534a42477268f4f4c1deda41f4547d7d3c2d8d5f2f):round1 同改前;
37
+ round2/3 planned=[]、applied=[]、applied_count 缺省、**cg.root 全树 0 个文件变化**、
38
+ A/B keep 与成员 importance/merge_count 逐字节冻结、节点总数恒 10。
39
+
40
+ 判据:
41
+ S1 结构:TIDY_TAG 单一真源(带引号字面量恰好 1 处)、_already_tidied 纯函数且
42
+ 缺字段不抛、无新增第三方依赖、docstring 写明幂等口径与新键。
43
+ S2 ★ 判别力锚:从 git 取**修复前**的 writelimit.py(git log -S 定位引入提交取
44
+ 父版本;未提交时回落 HEAD;再逐版本回落「首个不含 _already_tidied 的版本」),
45
+ 在同一夹具上连跑 3 轮 ⇒ 改前**确实不幂等**(第 2/3 轮仍有 applied、文件仍在
46
+ 变)。取不到修复前源 ⇒ ANCHOR-MISS,退出码 2。
47
+ S3 ★ 幂等核心:连跑 3 轮 apply=True ⇒ 第 2/3 轮 planned=[]/applied=[]/
48
+ applied_count 缺省或 0、**cg.root 全树逐字节不变**、groups==0、
49
+ already_tidied==8、scanned==10。
50
+ S4 第 1 轮确实整理且此后有界:保留节点正文含「整理聚合」与成员 id,读数与改前
51
+ 第 1 轮一致(A 224B/9 行/merge_count=4,B 1397B/10 行/4),第 2/3 轮不再变。
52
+ S5 成员降权一次性 + 契约 + 下限:0.6→0.3、tags 含 tidy:converged、
53
+ lifecycle_state=="converged";第 2/3 轮不再降;0.05 的成员落 0.1(max 下限)。
54
+ S6 存量兼容 + 永不删除:预置「只有 tag」「只有 state」两种历史存量 ⇒ 不报错、
55
+ 不再整理、文件逐字节不变、importance 不再减半;两轮后节点 id 集合不变。
56
+ S7 dry-run 零落盘:未整理夹具上 apply=False ⇒ planned 非空、applied 空、盘上
57
+ 逐字节不变;整理完再 dry ⇒ groups==0、already_tidied==8、盘上仍不变。
58
+ S8 公开契约:apply/dry 返回键 ⊇ 改前键集(apply 路径新增键只有
59
+ already_tidied);SustainLoop._tick_tidy 真实调用两次不抛,第 1 次落盘、
60
+ 第 2 次零落盘(常驻循环消费面兼容)。
61
+ S9 min_group 与 protected:2 条同模板不 planned;protected 成员不降权、tags
62
+ 不变、不计入 applied_count。
63
+ S10 不过度冻结:整理完后再到 3 条同模板新节点 ⇒ 仍会被整理(并入既有保留节点
64
+ wl_b0、converged==3、merge_count 4→7),且并入后再次整理仍零落盘。
65
+
66
+ 运行:python -X utf8 -m md_cg.test_issue190_tidy_idempotent
67
+ python -X utf8 -m md_cg.test_issue190_tidy_idempotent --mutate
68
+ """
69
+ from __future__ import annotations
70
+
71
+ import hashlib
72
+ import importlib
73
+ import importlib.util
74
+ import io
75
+ import os
76
+ import re
77
+ import subprocess
78
+ import sys
79
+ import tempfile
80
+ import traceback
81
+
82
+ _TMP = tempfile.mkdtemp(prefix="i190g_")
83
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
84
+ if _REPO not in sys.path:
85
+ sys.path.insert(0, _REPO)
86
+
87
+ if hasattr(sys.stdout, "reconfigure"):
88
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
89
+
90
+ from md_cg import autonomy_modes # noqa: E402
91
+
92
+ # 夹具隔离(同 test_writelimit 的口径):本守卫考的是读侧整理幂等,不是自治档位;
93
+ # 显式置 full 档,让 remember_gated 的写入行为回到「动作直落」。
94
+ os.environ[autonomy_modes.AUTONOMY_ENV_KEYS["mode"]] = "full"
95
+
96
+ from md_cg import lifecycle, writelimit # noqa: E402
97
+ from md_cg.mdcos import MdCGOS # noqa: E402
98
+
99
+ WL = os.path.join(_REPO, "md_cg", "writelimit.py")
100
+ PREFIX_MOD = "md_cg._writelimit_prefix190"
101
+
102
+ # 改前(修复前)tidy_contextual 返回 dict 的键集——从 repro_before.txt 逐字抄来,
103
+ # 用作「公开契约不破」的比对基准。
104
+ ORIG_APPLY_KEYS = ("t", "actor", "scanned", "groups", "members", "apply",
105
+ "planned", "applied", "applied_count")
106
+ ORIG_DRY_KEYS = ("t", "actor", "scanned", "groups", "members", "apply",
107
+ "planned", "applied")
108
+
109
+ _OK = 0
110
+ _BAD = []
111
+ _SEEN = set()
112
+ _N = [0]
113
+ _ANCHOR_MISS = []
114
+ _PREFIX_INFO = []
115
+
116
+
117
+ def _check(cid, cond, detail=""):
118
+ global _OK
119
+ # 判据 id = 首段("S3.2 ★ 第 2/3 轮..." → "S3.2"),_GROUPS 按 id 前缀核对是否
120
+ # 真的执行过(防断言组提前中断/静默跳过)。
121
+ cid = cid.split()[0]
122
+ _SEEN.add(cid)
123
+ if cond:
124
+ _OK += 1
125
+ print(" ok %s" % cid)
126
+ else:
127
+ _BAD.append(cid)
128
+ print(" FAIL %s %s" % (cid, detail))
129
+
130
+
131
+ # ---------------------------------------------------------------- 夹具与读数
132
+
133
+ def _mkcg(tag):
134
+ _N[0] += 1
135
+ root = os.path.join(_TMP, "%s_%d" % (tag, _N[0]))
136
+ os.makedirs(root, exist_ok=True)
137
+ return MdCGOS(root)
138
+
139
+
140
+ def _seed(cg, prefix, n, titled, importance=0.6, imps=None,
141
+ tmpl="巡检批次%d收官记忆"):
142
+ """直造存量同构组(照 test_writelimit H 节口径:gated=False 直写)。
143
+
144
+ importance 缺省 0.6:<0.7 避开 add 的自动保护位——protected 成员会被 tidy
145
+ 跳过,读不到降权读数(实测 importance=0.9 落 protected=True)。
146
+ """
147
+ ids = []
148
+ for i in range(n):
149
+ nid = "%s%d" % (prefix, i)
150
+ body = tmpl % i
151
+ content = ("# 功能名:%s\n" % body + "正文段落" * 60) if titled else body
152
+ imp = importance if imps is None else imps[i]
153
+ cg.remember_gated(nid, content, layer="contextual", gated=False,
154
+ importance=imp)
155
+ ids.append(nid)
156
+ return ids
157
+
158
+
159
+ def _scenario_ab(tag):
160
+ """存量同构组:A 无标题短记忆×5 + B 带标题长正文×5(均 importance=0.6)。"""
161
+ cg = _mkcg(tag)
162
+ a = _seed(cg, "wl_a", 5, False)
163
+ # B 组标题体与复现脚本逐字一致("# 功能名:批次N收官记忆"),故第 1 轮保留节点
164
+ # 读数与 repro_before/after.txt 的 1397B/10 行/merge_count=4 可比对。
165
+ b = _seed(cg, "wl_b", 5, True, tmpl="批次%d收官记忆")
166
+ return cg, a, b
167
+
168
+
169
+ def _files(cg):
170
+ """节点文件 sha256(只算 index 里的节点文件)。"""
171
+ out = {}
172
+ for nid, e in list(cg.index["nodes"].items()):
173
+ p = os.path.join(cg.root, e["path"])
174
+ try:
175
+ out[nid] = hashlib.sha256(open(p, "rb").read()).hexdigest()
176
+ except OSError as exc:
177
+ out[nid] = "ERR:%s" % exc
178
+ return out
179
+
180
+
181
+ def _tree(cg):
182
+ """cg.root 下**全部**文件的 sha256(含索引/日志/锁文件)。"""
183
+ out = {}
184
+ for dirpath, _dirs, fns in os.walk(cg.root):
185
+ for fn in fns:
186
+ p = os.path.join(dirpath, fn)
187
+ rel = os.path.relpath(p, cg.root).replace("\\", "/")
188
+ try:
189
+ out[rel] = hashlib.sha256(open(p, "rb").read()).hexdigest()
190
+ except OSError as exc:
191
+ out[rel] = "ERR:%s" % exc
192
+ return out
193
+
194
+
195
+ def _diff(before, after):
196
+ return sorted(k for k in set(list(before) + list(after))
197
+ if before.get(k) != after.get(k))
198
+
199
+
200
+ def _snap(cg, nid):
201
+ e = cg.get(nid) or {}
202
+ fm = e.get("frontmatter") or {}
203
+ body = e.get("content") or ""
204
+ return {"bytes": len(body.encode("utf-8")),
205
+ "lines": body.count("\n") + 1,
206
+ "merge_count": int(fm.get("merge_count") or 0),
207
+ "importance": fm.get("importance"),
208
+ "state": fm.get(lifecycle.STATE_FIELD),
209
+ "tags": list(fm.get("tags") or [])}
210
+
211
+
212
+ def _patch(cg, nid, **fields):
213
+ """就地把节点的 frontmatter 字段改掉(用于注入历史存量标记)。"""
214
+ e = cg.get(nid) or {}
215
+ fm = dict(e.get("frontmatter") or {})
216
+ fm.update(fields)
217
+ cg._write_node(nid, os.path.join(cg.root, e["path"]), fm,
218
+ e.get("content") or "")
219
+ entry = cg.index["nodes"].get(nid)
220
+ if entry is not None:
221
+ entry.update({"tags": fm.get("tags"),
222
+ "importance": fm.get("importance"),
223
+ lifecycle.STATE_FIELD: fm.get(lifecycle.STATE_FIELD)})
224
+
225
+
226
+ def _read_wl():
227
+ with io.open(WL, encoding="utf-8", newline="") as f:
228
+ return f.read()
229
+
230
+
231
+ # ---------------------------------------------------------------- S1 结构
232
+
233
+ def s1():
234
+ print("== S1 结构:单一真源 / 纯函数 / 无新依赖 / docstring ==")
235
+ src = _read_wl()
236
+ _check('S1.1 模块级真源常量 TIDY_TAG == "tidy:converged"',
237
+ getattr(writelimit, "TIDY_TAG", None) == "tidy:converged",
238
+ repr(getattr(writelimit, "TIDY_TAG", None)))
239
+ n_lit = src.count('"tidy:converged"')
240
+ _check("S1.2 带引号字面量全文件恰好 1 处(_demote 与判据都走常量)",
241
+ n_lit == 1, "count=%d" % n_lit)
242
+
243
+ fn = getattr(writelimit, "_already_tidied", None)
244
+ cases = [({}, False),
245
+ ({"frontmatter": None}, False),
246
+ ({"frontmatter": {"tags": None}}, False),
247
+ ({"frontmatter": {"tags": ["tidy:converged"]}}, True),
248
+ ({"frontmatter": {"lifecycle_state": "converged"}}, True),
249
+ ({"frontmatter": {"lifecycle_state": "active", "tags": []}}, False)]
250
+ ok = callable(fn)
251
+ detail = []
252
+ if not ok:
253
+ detail.append("_already_tidied 缺失或不可调用")
254
+ else:
255
+ for e, want in cases:
256
+ try:
257
+ got = bool(fn(e))
258
+ except Exception as exc: # noqa: BLE001
259
+ got = "EXC:%s" % exc
260
+ if got is not want:
261
+ ok = False
262
+ detail.append("%r→%r(期望%r)" % (e, got, want))
263
+ _check("S1.3 _already_tidied 纯函数且语义正确(缺 frontmatter/tags 不抛)",
264
+ ok, ";".join(detail))
265
+
266
+ mods = set(re.findall(r"^(?:import|from)\s+([A-Za-z_][\w.]*)", src, re.M))
267
+ allowed = {"__future__", "hashlib", "json", "os", "re", "time",
268
+ "lifecycle", "protect", "fsutil"}
269
+ _check("S1.4 无新增第三方依赖(顶层 import 全在既有白名单内)",
270
+ mods <= allowed, "多出=%s" % sorted(mods - allowed))
271
+
272
+ doc = writelimit.tidy_contextual.__doc__ or ""
273
+ mdoc = writelimit.__doc__ or ""
274
+ _check("S1.5 docstring 写明幂等口径与新键 already_tidied(模块级 + 函数级)",
275
+ "幂等" in doc and "already_tidied" in doc
276
+ and "幂等" in mdoc and "already_tidied" in mdoc)
277
+
278
+
279
+ # ---------------------------------------------------------------- S2 判别力锚
280
+
281
+ def _git(*args):
282
+ try:
283
+ p = subprocess.run(("git",) + args, cwd=_REPO, stdout=subprocess.PIPE,
284
+ stderr=subprocess.PIPE, timeout=60)
285
+ return p.returncode, p.stdout
286
+ except Exception: # noqa: BLE001
287
+ return 1, b""
288
+
289
+
290
+ def _prefix_source():
291
+ """取修复前的 md_cg/writelimit.py 源码,返回 (text, rev) 或 (None, None)。"""
292
+ f = "md_cg/writelimit.py"
293
+ revs = []
294
+ rc, out = _git("log", "-S", "_already_tidied", "--format=%H", "--", f)
295
+ if rc == 0:
296
+ hits = [x for x in out.decode("utf-8", "replace").split() if x]
297
+ if hits:
298
+ rc2, out2 = _git("rev-parse", hits[0] + "^")
299
+ if rc2 == 0:
300
+ revs.append(out2.decode("utf-8", "replace").strip())
301
+ rc, out = _git("log", "--format=%H", "--", f)
302
+ if rc == 0:
303
+ revs += [x for x in out.decode("utf-8", "replace").split() if x]
304
+ revs.append("HEAD")
305
+ for rev in revs:
306
+ if not rev:
307
+ continue
308
+ rc, blob = _git("show", "%s:%s" % (rev, f))
309
+ # 逐版本回落:只要该版本里没有 _already_tidied,它就是「修复前」。
310
+ if rc == 0 and blob and b"_already_tidied" not in blob:
311
+ return blob.decode("utf-8"), rev
312
+ return None, None
313
+
314
+
315
+ def _load_src_as_module(text, modname):
316
+ """把一段 writelimit.py 源码按包内子模块加载(相对 import 走 md_cg 包)。"""
317
+ path = os.path.join(_TMP, modname.rsplit(".", 1)[-1] + ".py")
318
+ with io.open(path, "w", encoding="utf-8", newline="") as f:
319
+ f.write(text)
320
+ spec = importlib.util.spec_from_file_location(modname, path)
321
+ mod = importlib.util.module_from_spec(spec)
322
+ sys.modules[modname] = mod
323
+ spec.loader.exec_module(mod)
324
+ return mod
325
+
326
+
327
+ def s2():
328
+ print("== S2 判别力锚:修复前源在同一夹具上确实不幂等 ==")
329
+ src, rev = _prefix_source()
330
+ if not src:
331
+ print(" ANCHOR-MISS S2.1 取不到修复前的 md_cg/writelimit.py(git 不可用?)")
332
+ _ANCHOR_MISS.append("S2")
333
+ _check("S2.1 取到修复前源(git)", False, "ANCHOR-MISS")
334
+ return
335
+ sha = hashlib.sha256(src.encode("utf-8")).hexdigest()
336
+ _PREFIX_INFO.append("修复前源 rev=%s sha256=%s" % (rev, sha))
337
+ print(" 修复前源 rev=%s sha256=%s" % (rev, sha))
338
+ _check("S2.1 取到修复前源(git %s,且确实不含幂等判据)" % rev[:8],
339
+ "_already_tidied" not in src and "TIDY_TAG" not in src)
340
+ mod = _load_src_as_module(src, PREFIX_MOD)
341
+ cg, A, B = _scenario_ab("s2")
342
+ f0 = _files(cg)
343
+ r1 = mod.tidy_contextual(cg, apply=True, min_group=3)
344
+ f1 = _files(cg)
345
+ r2 = mod.tidy_contextual(cg, apply=True, min_group=3)
346
+ f2 = _files(cg)
347
+ r3 = mod.tidy_contextual(cg, apply=True, min_group=3)
348
+ f3 = _files(cg)
349
+ _check("S2.2 改前第 1 轮确实整理(applied_count==8、10 个节点文件全变)",
350
+ r1.get("applied_count") == 8 and len(_diff(f0, f1)) == 10,
351
+ "applied_count=%s diff=%d" % (r1.get("applied_count"),
352
+ len(_diff(f0, f1))))
353
+ _check("S2.3 ★ 改前第 2 轮仍在写(applied 非空且文件变化)",
354
+ bool(r2.get("applied")) and bool(_diff(f1, f2)),
355
+ "applied=%s diff=%d" % (r2.get("applied"), len(_diff(f1, f2))))
356
+ _check("S2.4 ★ 改前第 3 轮仍在写(applied 非空且文件变化)",
357
+ bool(r3.get("applied")) and bool(_diff(f2, f3)),
358
+ "applied=%s diff=%d" % (r3.get("applied"), len(_diff(f2, f3))))
359
+ _check("S2.5 改前第 3 轮保留节点正文比第 1 轮长(无上限增长)",
360
+ _snap(cg, B[0])["bytes"] > 1397,
361
+ "B keep bytes=%d" % _snap(cg, B[0])["bytes"])
362
+
363
+
364
+ # ---------------------------------------------------------------- S3 幂等核心
365
+
366
+ def s3():
367
+ print("== S3 幂等核心:第 2/3 轮零落盘 ==")
368
+ cg, A, B = _scenario_ab("s3")
369
+ files0, tree0 = _files(cg), _tree(cg)
370
+ r1 = writelimit.tidy_contextual(cg, apply=True, min_group=3)
371
+ files1, tree1 = _files(cg), _tree(cg)
372
+ r2 = writelimit.tidy_contextual(cg, apply=True, min_group=3)
373
+ files2, tree2 = _files(cg), _tree(cg)
374
+ r3 = writelimit.tidy_contextual(cg, apply=True, min_group=3)
375
+ files3, tree3 = _files(cg), _tree(cg)
376
+ _check("S3.0 第 1 轮确实整理(applied_count==8、10 个节点文件全变)",
377
+ r1.get("applied_count") == 8 and len(_diff(files0, files1)) == 10,
378
+ "applied_count=%s diff=%d" % (r1.get("applied_count"),
379
+ len(_diff(files0, files1))))
380
+ _check("S3.1 第 2/3 轮 planned 为空且 applied 为空",
381
+ r2.get("planned") == [] and r2.get("applied") == []
382
+ and r3.get("planned") == [] and r3.get("applied") == [],
383
+ "r2=%s r3=%s" % (r2.get("applied"), r3.get("applied")))
384
+ _check("S3.2 ★ 第 2/3 轮 cg.root 全树逐字节不变(%d 个文件)" % len(tree1),
385
+ tree1 == tree2 and tree2 == tree3,
386
+ "r2 变=%s r3 变=%s" % (_diff(tree1, tree2), _diff(tree2, tree3)))
387
+ _check("S3.3 第 2/3 轮 groups==0、already_tidied==8、scanned==10",
388
+ (r2.get("groups"), r2.get("already_tidied"), r2.get("scanned"))
389
+ == (0, 8, 10)
390
+ and (r3.get("groups"), r3.get("already_tidied"), r3.get("scanned"))
391
+ == (0, 8, 10),
392
+ "r2=%s/%s/%s r3=%s/%s/%s" % (r2.get("groups"),
393
+ r2.get("already_tidied"),
394
+ r2.get("scanned"), r3.get("groups"),
395
+ r3.get("already_tidied"),
396
+ r3.get("scanned")))
397
+ _check("S3.4 第 2/3 轮 applied_count 缺省或 0(sustain 用 .get(...,0) 读)",
398
+ r2.get("applied_count", 0) == 0 and r3.get("applied_count", 0) == 0,
399
+ "%s/%s" % (r2.get("applied_count"), r3.get("applied_count")))
400
+
401
+
402
+ # ---------------------------------------------------------------- S4 保留节点有界
403
+
404
+ def s4():
405
+ print("== S4 保留节点有界:正文与 merge_count 第 2/3 轮不再增长 ==")
406
+ cg, A, B = _scenario_ab("s4")
407
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
408
+ body_a = (cg.get(A[0]) or {}).get("content") or ""
409
+ body_b = (cg.get(B[0]) or {}).get("content") or ""
410
+ ka1, kb1 = _snap(cg, A[0]), _snap(cg, B[0])
411
+ _check("S4.1 第 1 轮保留节点收编成员清单(含「整理聚合」与成员 id)",
412
+ "整理聚合" in body_a and "wl_a1" in body_a
413
+ and "整理聚合" in body_b and "wl_b1" in body_b)
414
+ _check("S4.2 第 1 轮读数与改前一致(A 224B/9 行/4;B 1397B/10 行/4)",
415
+ (ka1["bytes"], ka1["lines"], ka1["merge_count"]) == (224, 9, 4)
416
+ and (kb1["bytes"], kb1["lines"], kb1["merge_count"]) == (1397, 10, 4),
417
+ "A=%s B=%s" % (ka1, kb1))
418
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
419
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
420
+ ka3, kb3 = _snap(cg, A[0]), _snap(cg, B[0])
421
+ _check("S4.3 ★ 第 2/3 轮后保留节点 bytes/lines/merge_count 逐字不变",
422
+ ka3 == ka1 and kb3 == kb1, "A=%s B=%s" % (ka3, kb3))
423
+
424
+
425
+ # ---------------------------------------------------------------- S5 降权一次性
426
+
427
+ def s5():
428
+ print("== S5 成员降权一次性 + 契约 + 下限 ==")
429
+ cg, A, B = _scenario_ab("s5")
430
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
431
+ m1 = [_snap(cg, x) for x in A[1:]]
432
+ _check("S5.1 第 1 轮成员 0.6→0.3 + tags 含 tidy:converged + state==converged",
433
+ all(x["importance"] == 0.3 and "tidy:converged" in x["tags"]
434
+ and x["state"] == "converged" for x in m1), str(m1))
435
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
436
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
437
+ m3 = [_snap(cg, x) for x in A[1:]]
438
+ _check("S5.2 ★ 第 2/3 轮不再降权(仍 0.3,不是 0.15/0.1)",
439
+ all(x["importance"] == 0.3 for x in m3),
440
+ str([x["importance"] for x in m3]))
441
+
442
+ cg2 = _mkcg("s5floor")
443
+ ids = _seed(cg2, "wl_f", 3, False, importance=0.05)
444
+ pre = _snap(cg2, ids[1])["importance"]
445
+ writelimit.tidy_contextual(cg2, apply=True, min_group=3)
446
+ f = [_snap(cg2, x)["importance"] for x in ids[1:]]
447
+ _check("S5.3 importance 下限 0.1(0.05×0.5=0.025 → 0.1)",
448
+ pre == 0.05 and all(x == 0.1 for x in f), "pre=%s post=%s" % (pre, f))
449
+
450
+
451
+ # ---------------------------------------------------------------- S6 存量兼容
452
+
453
+ def s6():
454
+ print("== S6 存量兼容 + 永不删除 ==")
455
+ cg = _mkcg("s6")
456
+ u = _seed(cg, "wl_u", 3, False) # 未整理组
457
+ h1 = _seed(cg, "wl_h", 3, False, tmpl="历史批次%d收官记忆")
458
+ h2 = _seed(cg, "wl_hx", 3, True, tmpl="旧标题批次%d收官记忆")
459
+ # 注入修复前就已落盘的历史标记(模拟老库存量)
460
+ for nid in h1:
461
+ _patch(cg, nid, tags=["tidy:converged"], importance=0.3)
462
+ for nid in h2:
463
+ _patch(cg, nid, tags=[], importance=0.3,
464
+ **{lifecycle.STATE_FIELD: "converged"})
465
+ ids0 = set(cg.index["nodes"])
466
+ hfiles0 = {nid: _files(cg)[nid] for nid in h1 + h2}
467
+ hsnap0 = {nid: _snap(cg, nid) for nid in h1 + h2}
468
+ r1 = writelimit.tidy_contextual(cg, apply=True, min_group=3)
469
+ hfiles1 = {nid: _files(cg)[nid] for nid in h1 + h2}
470
+ hsnap1 = {nid: _snap(cg, nid) for nid in h1 + h2}
471
+ _check("S6.1 历史存量被认账:只整理未整理组(groups==1、already_tidied==6)",
472
+ r1.get("groups") == 1 and r1.get("already_tidied") == 6,
473
+ "groups=%s already_tidied=%s" % (r1.get("groups"),
474
+ r1.get("already_tidied")))
475
+ _check("S6.2 ★ 历史存量不再整理:文件逐字节不变、importance 不再减半",
476
+ hfiles0 == hfiles1 and hsnap0 == hsnap1
477
+ and all(_snap(cg, n)["importance"] == 0.3 for n in h1 + h2),
478
+ "变=%s" % _diff(hfiles0, hfiles1))
479
+ body_u = (cg.get(u[0]) or {}).get("content") or ""
480
+ _check("S6.3 未整理组照常整理(applied_count>=2、keep 收编清单)",
481
+ r1.get("applied_count", 0) >= 2 and "整理聚合" in body_u,
482
+ "applied_count=%s" % r1.get("applied_count"))
483
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
484
+ _check("S6.4 永不删除:两轮后节点 id 集合与初始完全一致(%d 个)"
485
+ % len(ids0), set(cg.index["nodes"]) == ids0,
486
+ "差集=%s" % sorted(ids0 ^ set(cg.index["nodes"])))
487
+
488
+
489
+ # ---------------------------------------------------------------- S7 dry-run
490
+
491
+ def s7():
492
+ print("== S7 dry-run 零落盘 ==")
493
+ cg, A, B = _scenario_ab("s7")
494
+ t0 = _tree(cg)
495
+ dry = writelimit.tidy_contextual(cg, apply=False)
496
+ t1 = _tree(cg)
497
+ _check("S7.1 ★ apply=False 只盘点不动盘(planned 非空、applied 空、全树不变)",
498
+ bool(dry.get("planned")) and dry.get("applied") == []
499
+ and dry.get("groups") == 2 and t0 == t1, "变=%s" % _diff(t0, t1))
500
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
501
+ t2 = _tree(cg)
502
+ dry2 = writelimit.tidy_contextual(cg, apply=False)
503
+ t3 = _tree(cg)
504
+ _check("S7.2 ★ 整理后 dry:groups==0、already_tidied==8、全树仍不变",
505
+ dry2.get("groups") == 0 and dry2.get("already_tidied") == 8
506
+ and t2 == t3,
507
+ "groups=%s already_tidied=%s 变=%s"
508
+ % (dry2.get("groups"), dry2.get("already_tidied"), _diff(t2, t3)))
509
+
510
+
511
+ # ---------------------------------------------------------------- S8 公开契约
512
+
513
+ def s8():
514
+ print("== S8 公开契约:返回键 + sustain 消费面 ==")
515
+ cg, A, B = _scenario_ab("s8")
516
+ dry = writelimit.tidy_contextual(cg, apply=False)
517
+ out = writelimit.tidy_contextual(cg, apply=True, min_group=3)
518
+ _check("S8.1a dry 返回键 ⊇ 改前 dry 键集", all(k in dry for k in ORIG_DRY_KEYS),
519
+ "缺=%s" % [k for k in ORIG_DRY_KEYS if k not in dry])
520
+ # 键集与 already_tidied 语义各用**独立**夹具:若共用上面这个 cg,前一次调用的
521
+ # 副作用会串味(例如「dry 也落盘」这类变异会把与它无关的键集判据一起打红,
522
+ # 变成语义纠缠)。独立夹具让每条判据只测它自己声明的东西。
523
+ cg_k = _mkcg("s8keys")
524
+ _seed(cg_k, "wl_c", 5, False)
525
+ out_k = writelimit.tidy_contextual(cg_k, apply=True, min_group=3)
526
+ _check("S8.1b apply 返回键 ⊇ 改前 apply 键集",
527
+ all(k in out_k for k in ORIG_APPLY_KEYS),
528
+ "缺=%s" % [k for k in ORIG_APPLY_KEYS if k not in out_k])
529
+ _check("S8.1c apply 路径新增键只有 already_tidied",
530
+ set(out_k) - set(ORIG_APPLY_KEYS) == {"already_tidied"},
531
+ "多出=%s" % sorted(set(out_k) - set(ORIG_APPLY_KEYS)))
532
+ cg_d = _mkcg("s8dry")
533
+ _seed(cg_d, "wl_d", 5, False)
534
+ dry0 = writelimit.tidy_contextual(cg_d, apply=False)
535
+ cg_s, A_s, B_s = _scenario_ab("s8skip")
536
+ w1 = writelimit.tidy_contextual(cg_s, apply=True, min_group=3)
537
+ w2 = writelimit.tidy_contextual(cg_s, apply=True, min_group=3)
538
+ _check("S8.1d already_tidied 语义=跳过计数(未整理 0、整理后 8)",
539
+ dry0.get("already_tidied") == 0 and w1.get("already_tidied") == 0
540
+ and w2.get("already_tidied") == 8,
541
+ "dry0=%s w1=%s w2=%s" % (dry0.get("already_tidied"),
542
+ w1.get("already_tidied"),
543
+ w2.get("already_tidied")))
544
+
545
+ from md_cg.sustain import SustainLoop # noqa: E402
546
+ cg2, A2, B2 = _scenario_ab("s8b")
547
+ lp = SustainLoop(cg2, name="i190g", auto_tidy=True, tidy_interval=111.0,
548
+ d=os.path.join(cg2.root, "_sustain"))
549
+ lp._tick_tidy()
550
+ rec = lp.last_tidy or {}
551
+ _check("S8.2 SustainLoop._tick_tidy 第 1 次不抛、last_tidy 键齐全(消费面兼容)",
552
+ rec.get("applied_count") == 8 and rec.get("groups") == 2
553
+ and rec.get("members") == 8 and rec.get("scanned") == 10
554
+ and len(lp.tidys) == 1, str(rec))
555
+ lp._tick_tidy()
556
+ rec2 = lp.last_tidy or {}
557
+ _check("S8.3 ★ 常驻循环第 2 次 _tick_tidy 零落盘(applied_count==0、groups==0)",
558
+ rec2.get("applied_count") == 0 and rec2.get("groups") == 0
559
+ and len(lp.tidys) == 2, str(rec2))
560
+ lp.stop()
561
+
562
+
563
+ # ---------------------------------------------------------------- S9 min_group/protected
564
+
565
+ def s9():
566
+ print("== S9 min_group 与 protected 跳过 ==")
567
+ cg = _mkcg("s9two")
568
+ _seed(cg, "wl_two", 2, False)
569
+ t0 = _tree(cg)
570
+ r = writelimit.tidy_contextual(cg, apply=True, min_group=3)
571
+ t1 = _tree(cg)
572
+ _check("S9.1 min_group=3:2 条同模板不 planned、零落盘",
573
+ r.get("groups") == 0 and r.get("applied") == [] and t0 == t1,
574
+ "groups=%s 变=%s" % (r.get("groups"), _diff(t0, t1)))
575
+
576
+ cg2 = _mkcg("s9prot")
577
+ ids = _seed(cg2, "wl_k", 3, False, imps=[0.6, 0.6, 0.8])
578
+ prot = _snap(cg2, ids[2])
579
+ _check("S9.0 夹具前置:importance=0.8 落 protected=True",
580
+ prot["importance"] == 0.8 and prot["tags"] == []
581
+ and (cg2.get(ids[2]) or {}).get("frontmatter", {}).get("protected")
582
+ is True, str(prot))
583
+ r2 = writelimit.tidy_contextual(cg2, apply=True, min_group=3)
584
+ prot2 = _snap(cg2, ids[2])
585
+ _check("S9.2 protected 成员不降权、tags 不变、不计入 applied_count",
586
+ prot2 == prot and r2.get("applied_count") == 1
587
+ and _snap(cg2, ids[1])["importance"] == 0.3,
588
+ "prot=%s applied_count=%s" % (prot2, r2.get("applied_count")))
589
+
590
+
591
+ # ---------------------------------------------------------------- S10 不过度冻结
592
+
593
+ def s10():
594
+ print("== S10 不过度冻结:整理后再到 3 条同模板新节点仍会被整理 ==")
595
+ cg, A, B = _scenario_ab("s10")
596
+ writelimit.tidy_contextual(cg, apply=True, min_group=3)
597
+ b0 = _snap(cg, B[0])
598
+ new = _seed(cg, "wl_n", 3, True, tmpl="批次%d收官记忆")
599
+ r2 = writelimit.tidy_contextual(cg, apply=True, min_group=3)
600
+ b1 = _snap(cg, B[0])
601
+ # 新到的 3 条与 B 组同模板 ⇒ 并入**既有**保留节点 wl_b0(它仍是该签名组里
602
+ # 最早的活跃节点),而不是另立 keep——这是「新成员照常整理」的判据;
603
+ # 同时它必须只被扩写一次,之后再次整理零落盘(不因新成员回到每轮重写)。
604
+ _check("S10.1 ★ 新到 3 条同模板节点仍被整理(groups==1、并入既有 keep wl_b0、converged==3)",
605
+ r2.get("groups") == 1
606
+ and [(a["keep"], a["converged"]) for a in r2.get("applied") or []]
607
+ == [("wl_b0", 3)],
608
+ "groups=%s applied=%s" % (r2.get("groups"), r2.get("applied")))
609
+ _check("S10.2 ★ 既有保留节点只被扩写一次(bytes/lines 增、merge_count 4→7)",
610
+ b1["bytes"] > b0["bytes"] and b1["lines"] > b0["lines"]
611
+ and b1["merge_count"] == 7, "%s → %s" % (b0, b1))
612
+ _check("S10.3 三条新成员被降权(0.6→0.3)",
613
+ all(_snap(cg, x)["importance"] == 0.3 for x in new),
614
+ "new=%s" % [_snap(cg, x)["importance"] for x in new])
615
+ t2 = _tree(cg)
616
+ r3 = writelimit.tidy_contextual(cg, apply=True, min_group=3)
617
+ t3 = _tree(cg)
618
+ _check("S10.4 ★ 并入新成员后再次整理仍零落盘(planned/applied 空、全树不变)",
619
+ r3.get("planned") == [] and r3.get("applied") == [] and t2 == t3,
620
+ "applied=%s 变=%s" % (r3.get("applied"), _diff(t2, t3)))
621
+
622
+
623
+ _GROUPS = (
624
+ (s1, ("S1.1", "S1.2", "S1.3", "S1.4", "S1.5")),
625
+ (s2, ("S2.1", "S2.2", "S2.3", "S2.4", "S2.5")),
626
+ (s3, ("S3.0", "S3.1", "S3.2", "S3.3", "S3.4")),
627
+ (s4, ("S4.1", "S4.2", "S4.3")),
628
+ (s5, ("S5.1", "S5.2", "S5.3")),
629
+ (s6, ("S6.1", "S6.2", "S6.3", "S6.4")),
630
+ (s7, ("S7.1", "S7.2")),
631
+ (s8, ("S8.1a", "S8.1b", "S8.1c", "S8.1d", "S8.2", "S8.3")),
632
+ (s9, ("S9.0", "S9.1", "S9.2")),
633
+ (s10, ("S10.1", "S10.2", "S10.3", "S10.4")),
634
+ )
635
+
636
+
637
+ def _run_groups():
638
+ global _OK
639
+ _OK = 0
640
+ _BAD.clear()
641
+ _SEEN.clear()
642
+ for g, ids in _GROUPS:
643
+ try:
644
+ g()
645
+ except Exception as exc: # noqa: BLE001
646
+ print(" 断言组 %s 抛异常:%s" % (g.__name__, exc))
647
+ print(traceback.format_exc()[-600:])
648
+ for cid in ids:
649
+ if cid not in _SEEN:
650
+ _SEEN.add(cid)
651
+ _BAD.append(cid)
652
+ print(" FAIL %s 未执行(断言组提前中断/静默跳过)" % cid)
653
+ return len(_BAD)
654
+
655
+
656
+ def main():
657
+ print("整理巡检幂等守卫(issue #190)")
658
+ print("writelimit.py sha256=%s" % hashlib.sha256(
659
+ open(WL, "rb").read()).hexdigest())
660
+ for line in _PREFIX_INFO:
661
+ print(line)
662
+ n = _run_groups()
663
+ print()
664
+ if _ANCHOR_MISS:
665
+ print("ANCHOR-MISS:%s(取不到修复前源,判别力无法自证)"
666
+ % "、".join(_ANCHOR_MISS))
667
+ print("整理巡检幂等守卫(issue #190):通过 %d / 失败 %d" % (_OK, n))
668
+ if _ANCHOR_MISS:
669
+ return 2
670
+ return 1 if n else 0
671
+
672
+
673
+ # ---------------------------------------------------------------- 定点变异自证
674
+
675
+ _MUTATIONS = (
676
+ ("V1 幂等判据被短路(#190 病象回归)",
677
+ " if _already_tidied(e):\n",
678
+ " if _already_tidied(e) and False:\n",
679
+ # 期望红项=幂等判据失效的全部下游读数:第 2/3 轮仍在写(S3.*)、保留节点
680
+ # 继续增长(S4.3)、成员继续降权(S5.2)、历史存量不被认账(S6.1/S6.2)、
681
+ # 整理后 dry 仍报组(S7.2)、跳过计数恒 0(S8.1d)、常驻循环第 2 次仍落盘
682
+ # (S8.3)、新成员并入时整组重并(S10.1/S10.2/S10.4)。S10.3 仍绿(降权本身
683
+ # 没坏),S3.0/S4.2/S5.1/S5.3/S9.* 仍绿(第 1 轮行为与跳过面无关)。
684
+ ("S3.1", "S3.2", "S3.3", "S3.4", "S4.3", "S5.2", "S6.1", "S6.2",
685
+ "S7.2", "S8.1d", "S8.3", "S10.1", "S10.2", "S10.4")),
686
+ ("V2 成员不再打 tidy:converged tag",
687
+ " if TIDY_TAG not in tags:\n tags.append(TIDY_TAG)\n",
688
+ " if False:\n tags.append(TIDY_TAG)\n",
689
+ ("S5.1",)),
690
+ ("V3 单一真源退化(_demote 内改用字面量)",
691
+ " if TIDY_TAG not in tags:\n tags.append(TIDY_TAG)\n",
692
+ ' if "tidy:converged" not in tags:\n'
693
+ ' tags.append("tidy:converged")\n',
694
+ ("S1.2",)),
695
+ ("V4 dry-run 也落盘(apply 判据被摘)",
696
+ " if not apply or not planned:\n",
697
+ " if not planned:\n",
698
+ ("S7.1",)),
699
+ ("V5 降权丢掉 0.1 下限",
700
+ 'round(max(0.1, float(fm.get("importance", 0.5)',
701
+ 'round(max(0.0, float(fm.get("importance", 0.5)',
702
+ ("S5.3",)),
703
+ ("V6 protected/immutable 成员不再跳过",
704
+ ' if mfm.get("protected") or mfm.get("immutable"):\n',
705
+ " if False:\n",
706
+ ("S9.2",)),
707
+ )
708
+
709
+
710
+ def _reload():
711
+ import md_cg.writelimit as _w
712
+ # 变异若与上一版**等长**且落在同一个 mtime 秒内,Python 会按
713
+ # (mtime_seconds, size) 判定 __pycache__ 里的 .pyc「仍然有效」,reload 于是
714
+ # 加载陈旧字节码(实测 V5:max(0.1,→max(0.0, 等长,S5.3 假绿)。故先删缓存
715
+ # 再 reload,并用 _live_ok() 事后核对变异确实进了内存。
716
+ try:
717
+ cache = importlib.util.cache_from_source(_w.__file__)
718
+ if os.path.exists(cache):
719
+ os.remove(cache)
720
+ except Exception: # noqa: BLE001
721
+ pass
722
+ importlib.invalidate_caches()
723
+ importlib.reload(_w)
724
+ globals()["writelimit"] = _w
725
+
726
+
727
+ def _live_ok():
728
+ """内存里的 writelimit 是否就是盘上那份变异源码编译出来的(防空转变异)。"""
729
+ src = _read_wl()
730
+ ns = {"__name__": "md_cg._i190live", "__package__": "md_cg", "__file__": WL}
731
+ try:
732
+ exec(compile(src, WL, "exec"), ns) # noqa: S102
733
+ except Exception as exc: # noqa: BLE001
734
+ return "COMPILE-FAIL:%s" % exc
735
+ for name, obj in ns.items():
736
+ cur = getattr(writelimit, name, None)
737
+ if callable(obj) and callable(cur) \
738
+ and getattr(obj, "__code__", None) is not None \
739
+ and getattr(cur, "__code__", None) is not None \
740
+ and obj.__code__.co_code != cur.__code__.co_code:
741
+ return "STALE:%s" % name
742
+ return ""
743
+
744
+
745
+ def _mutate():
746
+ bad = []
747
+ with io.open(WL, encoding="utf-8", newline="") as f:
748
+ pristine = f.read()
749
+ if "_already_tidied" not in pristine:
750
+ print(" SOURCE-ALREADY-MUTATED:writelimit.py 缺 _already_tidied")
751
+ return 1
752
+ for name, anchor, repl, want in _MUTATIONS:
753
+ with io.open(WL, encoding="utf-8", newline="") as f:
754
+ orig = f.read()
755
+ NL = "\r\n" if "\r\n" in orig else "\n"
756
+ a_ = anchor.replace("\n", NL)
757
+ r_ = repl.replace("\n", NL)
758
+ try:
759
+ if a_ not in orig:
760
+ print(" ANCHOR-MISS %s" % name)
761
+ _ANCHOR_MISS.append(name)
762
+ bad.append(name)
763
+ continue
764
+ with io.open(WL, "w", encoding="utf-8", newline="") as f:
765
+ f.write(orig.replace(a_, r_, 1))
766
+ _reload()
767
+ stale = _live_ok()
768
+ if stale:
769
+ print(" LIVE-CHECK-FAIL %s:%s(变异未进入内存,本次读数不可信)"
770
+ % (name, stale))
771
+ bad.append(name)
772
+ continue
773
+ _run_groups()
774
+ reds = sorted(set(_BAD))
775
+ want_s = sorted(set(want))
776
+ ok = reds == want_s
777
+ print(" 变异 %s" % name)
778
+ print(" 期望红项=%s" % (",".join(want_s) or "(无)"))
779
+ print(" 实测红项=%s" % (",".join(reds) or "(无)"))
780
+ print(" %s" % ("OK 恰好命中" if ok else "BAD 红项集合不符"))
781
+ if not ok:
782
+ bad.append(name)
783
+ finally:
784
+ with io.open(WL, "w", encoding="utf-8", newline="") as f:
785
+ f.write(pristine)
786
+ with io.open(WL, encoding="utf-8", newline="") as f:
787
+ if f.read() != pristine:
788
+ print(" RESTORE-FAILED %s" % name)
789
+ bad.append(name + "(恢复失败)")
790
+ _reload()
791
+ if bad:
792
+ print()
793
+ print("定点变异自证:FAIL -- %s" % "、".join(bad))
794
+ if _ANCHOR_MISS:
795
+ print("ANCHOR-MISS:%s" % "、".join(_ANCHOR_MISS))
796
+ return 2
797
+ return 1
798
+ print()
799
+ print("定点变异自证:PASS(每条变异恰好打红期望判据集合)")
800
+ return 0
801
+
802
+
803
+ if __name__ == "__main__":
804
+ if "--mutate" in sys.argv:
805
+ sys.exit(_mutate())
806
+ sys.exit(main())