@furongjun1999/dsh-memory 0.8.0 → 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 -632
  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 -5417
  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_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. 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
  531. 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
  532. 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
  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_v2.0.md +0 -239
  534. 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
  535. 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
  536. 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
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. 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
  539. 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
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. 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
  543. 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
  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.1.md +0 -340
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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 -152
  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,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())