@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
package/md_cg/rollback.py CHANGED
@@ -1,420 +1,657 @@
1
- # -*- coding: utf-8 -*-
2
- """三档自治 · 回滚原语通用化(设计 v0.2 §四/§十一 · 批次③)。
3
-
4
- 设计 §四「回滚原语(已有,需通用化)」四条在本文档与实现中的落点:
5
-
6
- 1. **受保护快照面推广为一切 C/D/B 动作**:`_protected_history/<id>/<时间戳>.md`
7
- + `_protected_audit.jsonl`(protect.py 面)**面复用、语义泛化**——执行桥
8
- 经 `preimage()` 在**执行时点**调 `protect.snapshot_preimage()` 拍前像;
9
- `protect.py` 的既有 `snapshot()` / `guard_*` 行为**一字不改**(守卫钉死)。
10
- 2. **软删(D)**:`trash/` + 删除清单的既有 `restore` 接进统一口径——
11
- `rollback_mutation` 的 D 分支调 `cg.restore(force=True)`;restore 走 add
12
- 全量重建,探针实测与原件有字节差(多 `sensitivity: null` 键),故其后按
13
- 前像**校准**(`calibrated` 读数如实返回,不假装 restore 本身逐字节)。
14
- 3. **合并(B)**:聚合行 `- 【聚合 …】`(`forgetting.AGG_MARK`)**定向剥离**
15
- (`strip_aggregate_lines`)回退到合并前正文;fm 全量取前像——
16
- merge_count/last_merge_at/importance/merge_sources/protected 等**不可逆**
17
- (`-0.05` 会被 `min(1.0,…)` 截断、last_merge_at 旧值无从得知),前像快照
18
- 是唯一诚实来源。
19
- 4. **分数类(E)**:不属本批(设计 §四 明文「分数类:各模块既有 rollback」)。
20
-
21
- 统一回滚入口 `rollback_mutation(cg, mutation, ...)`:输入=变更单的**执行时点
22
- 载荷**(执行桥补全后的 `mutation_executed` 形态;CLI 从 decisions.jsonl 的
23
- `rec["mutation"]` 读回),按动作类分派 C/B/D 三条原语,回滚后做**残留核对**
24
- (边/索引条目/聚合行三面与前像时点影响面逐位对拍)与**逐字节比对前像**读数。
25
-
26
- 边界(如实登记):
27
- · 前像=执行时点快照——提议时点**不拍**(设计 §四:从提议到 accept 之间目标
28
- 可能被第三方改动,回滚必须撤销本变更本身);执行记录里的 `before` 引用由
29
- 执行桥补全,故对**未执行**(reject/fail-closed/pending)的变更单,本模块
30
- fail-closed 拒绝回滚(`rollback_gap`,不允许凭空猜一个前像)。
31
- · 加密库(覆写 `_seal_content` 的实例)密文层不保证逐字节可复现(每次封装
32
- 熵不同)——`bytes_equal_preimage` 在非加密库上成立(探针实测);
33
- 加密库语义为「明文内容 + 结构可恢复」,读数如实返回。
34
- · `restore` 的 tombstone 检查保留语义:回滚是「确认该删除属于本变更」的
35
- 处置,故显式 `force=True` 且 `reason` 写入返回体,不静默绕过。
36
- """
37
- from __future__ import annotations
38
-
39
- import os
40
-
41
- from . import chain
42
- from . import forgetting as _forgetting
43
- from . import nodefile
44
- from . import protect
45
- from . import subgraph as _subgraph
46
- from . import trust
47
-
48
- __all__ = [
49
- "RollbackError", "PreimageError",
50
- "command_for", "preimage", "collect_impact", "read_preimage",
51
- "strip_aggregate_lines", "rollback_mutation",
52
- ]
53
-
54
- #: 影响面「索引条目」对拍键(`collect_impact` 采集、残留核对比对,同一份口径)。
55
- _INDEX_KEYS = ("present", "path", "layer", "importance", "merge_count",
56
- "protected", "tags")
57
- #: 需要前像/可回滚的动作类(设计 §一:B 合并 / C 改写 / D 删除)。
58
- _ROLLBACK_ACTIONS = ("B", "C", "D")
59
-
60
-
61
- class RollbackError(RuntimeError):
62
- """回滚无法执行(前像缺失/不可读、动作类未知等)——fail-closed。"""
63
-
64
- def __init__(self, code, message, **extra):
65
- super().__init__(message)
66
- self.code = code
67
- self.extra = extra
68
-
69
-
70
- class PreimageError(RuntimeError):
71
- """执行时点前像拍摄失败——执行桥据此 fail-closed(一切破坏性动作先留前像)。"""
72
-
73
-
74
- # 生效条件:pid 非空时返回 `python -X utf8 -m md_cg.rollback_cli --root "<root>" --pid <pid>` 形态的命令串(唯一构造点);pid 为空时抛 ValueError;
75
- def command_for(root, pid) -> str:
76
- """回滚命令串(**唯一构造点**,可执行——守卫实测演练同一条串)。
77
-
78
- 形态自定为 `md_cg.rollback_cli`:CLI 从 decisions.jsonl 读回该 pid 的
79
- 执行记录(`rec["mutation"]`,含执行时点前像/影响面/回滚命令),按动作类
80
- 分派统一回滚入口。root 用双引号包裹(路径可含空格)。
81
- """
82
- if not pid:
83
- raise ValueError("回滚命令缺 pid:无 pid 即无法定位执行记录——"
84
- "fail-closed 不构造命令串。")
85
- return ('python -X utf8 -m md_cg.rollback_cli --root "%s" --pid %s'
86
- % (root, pid))
87
-
88
-
89
- # 生效条件:action 归一后属 _ROLLBACK_ACTIONS 时——forgetting.prior_node 判目标不存在则返回 None(动作不会发生,由调用方走既有 target_missing/not_found 路径);目标在位于执行时点拍前像(protect.snapshot_preimage)并采集影响面与回滚命令,返回 {"before","impact","rollback"};拍摄失败(目标在位而快照未落)抛 PreimageError(fail-closed);action 不属 _ROLLBACK_ACTIONS 时返回 None;
90
- def preimage(cg, action, target, pid=None, reason=""):
91
- """执行时点前像(快照引用 + 影响面 + 回滚命令)——**唯一采集点**。
92
-
93
- 由执行桥(`mdcos._mutation_execute`)在动作原语落盘**之前**调用:
94
- 拍到的快照即「执行前一刻」的盘面(含提议之后、执行之前的第三方改动),
95
- 回滚据此撤销本变更本身(设计 §四:前像=执行时点,不是提议时点)。
96
-
97
- 返回 None 的两条路径(都=动作不会发生,无需留前像):
98
- · 动作类不属 B/C/D(未知动作类由执行桥的既有分支 fail-closed);
99
- · 目标节点不存在(既有原语会走 target_missing/not_found,执行桥的
100
- C 分支另有显式 target_missing 检查——本函数不抢它的错误形态)。
101
- """
102
- act = str(action or "").strip().upper()
103
- if act not in _ROLLBACK_ACTIONS:
104
- return None
105
- if _forgetting.prior_node(cg, target) is None:
106
- return None
107
- rel = protect.snapshot_preimage(cg, target, action=act, pid=pid,
108
- reason=reason)
109
- if rel is None:
110
- raise PreimageError(
111
- "执行时点前像拍摄失败(目标 %s 在位但快照未落盘)——"
112
- "一切破坏性动作先留前像(设计 §四/§六),本次 fail-closed 未执行。"
113
- % target)
114
- return {"before": rel,
115
- "impact": collect_impact(cg, target),
116
- "rollback": command_for(cg.root, pid)}
117
-
118
-
119
- # 生效条件:对任意 cg、node_id 均返回影响面读数 dict——{"edges": {"declared","children","parents"}, "index": {"present","path","layer","importance","merge_count","protected","tags"}, "agg_lines": [...]}(节点不可读时各面取空值/None,不抛);本函数只读,不产生副作用;
120
- def collect_impact(cg, node_id):
121
- """执行时点影响面读数(设计 §四:边 / 索引条目 / 聚合行)。
122
-
123
- 三个面都是**执行时点**(动作落盘前)的读数——回滚后由
124
- `rollback_mutation` 重采一次逐位对拍(残留核对:回滚后不得残留本变更
125
- 在任一面的痕迹)。采集走既有单点:`subgraph.children/parents_index`
126
- (声明式 ∪ 边式)、索引条目直读、聚合行按 `forgetting.AGG_MARK` 字面判。
127
- """
128
- try:
129
- node = cg.get(node_id)
130
- except Exception: # noqa: BLE001 —— 读面失败按空读数采
131
- node = None
132
- fm = (node or {}).get("frontmatter") or {}
133
- content = (node or {}).get("content") or ""
134
- entry = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(node_id) \
135
- or {}
136
- return {
137
- "edges": {
138
- "declared": list(fm.get("edges") or []),
139
- "children": _subgraph.children(cg, node_id),
140
- "parents": list(_subgraph.parents_index(cg).get(node_id) or []),
141
- },
142
- "index": {
143
- "present": bool(entry),
144
- "path": entry.get("path"),
145
- "layer": entry.get("layer"),
146
- "importance": entry.get("importance"),
147
- "merge_count": entry.get("merge_count"),
148
- "protected": bool(entry.get("protected")),
149
- "tags": list(entry.get("tags") or []),
150
- },
151
- # 聚合行行号(1 起):正文里字面含 AGG_MARK 的行——forgetting.aggregate_line
152
- # 生成的形态是 `- 【聚合 月-日 时:分】…`;宽判据(含标记即计)与回滚核对同源。
153
- "agg_lines": [i + 1 for i, l in enumerate(content.splitlines())
154
- if _forgetting.AGG_MARK in l],
155
- }
156
-
157
-
158
- # 生效条件:rel 指向的文件不存在时抛 RollbackError(code="preimage_missing");存在则读取并以 cg._open_content(node_id, fm, raw) 对称解封,返回 (fm, content)——content 为 None(无密钥/身份不符)时抛 RollbackError(code="preimage_unreadable");文件含坏字节(非 UTF-8)无法解析时同样抛 RollbackError(code="preimage_unreadable")(fail-closed,不裸抛 UnicodeDecodeError);
159
- def read_preimage(cg, node_id, rel):
160
- """读执行时点前像文件(**与 snapshot_preimage 对称**:写走 _write_node 封装、
161
- 读走 _open_content 解封)——返回 (fm, content)。
162
-
163
- 注意:快照文件以节点文件同款 nodefile 序列化落盘;加密库中其内容为密封
164
- 形态,必须经解封钩子读,直接 nodefile.loads 会把密文当明文再次封装
165
- (双重封装)。非加密库两钩子恒等(探针实测逐字节一致)。
166
-
167
- 文件含坏字节(非 UTF-8)无法解析时抛 RollbackError(code="preimage_unreadable")
168
- ——fail-closed,不裸抛 UnicodeDecodeError。
169
- """
170
- p = os.path.join(cg.root, str(rel).replace("/", os.sep))
171
- if not os.path.isfile(p):
172
- raise RollbackError("preimage_missing",
173
- "前像文件不存在:%s——变更单可能未执行(无前像)"
174
- "或快照被移走;fail-closed 不猜一个前像。" % rel)
175
- try:
176
- with open(p, encoding="utf-8") as f:
177
- fm, raw = nodefile.loads(f.read())
178
- except UnicodeDecodeError as exc:
179
- # 坏字节/非 UTF-8:fail-closed——绝不让 UnicodeDecodeError 裸抛逃逸
180
- raise RollbackError("preimage_unreadable",
181
- "前像文件坏字节 / 非 UTF-8 无法解析:%s(%s)——"
182
- "fail-closed 不回滚。" % (rel, exc))
183
- content = cg._open_content(node_id, fm, raw)
184
- if content is None:
185
- raise RollbackError("preimage_unreadable",
186
- "前像不可解封(无密钥/身份不符):%s。" % rel)
187
- return fm, content
188
-
189
-
190
- # 生效条件:content 以 reference 为前缀且其后追加段逐段为「\n + 含 AGG_MARK 的非空行」时,逐段剥掉该追加段返回 (reference + 剩余段, 被剥行列表);不以 reference 为前缀、追加段形态不符、或 reference 为空时原样返回 (content, [])——不猜、不做字符串手术;
191
- def strip_aggregate_lines(content, reference):
192
- """定向剥离(设计 §四:合并回滚)——把**合并追加的聚合行**从正文里剥掉。
193
-
194
- 为什么是「前缀 + 追加段」判据而不是全局扫行:合并原语(`forgetting.
195
- reinforce` / `writelimit.converge_into`)对正文是**追加式**的
196
- (`aggregate_line`:`new_body = body + "\\n" + line`),回滚的目标是回到
197
- 前像正文——精确、可判、不误伤正文里历史遗留的聚合行(它们在前像里就已
198
- 存在,属「合并前正文」的一部分,不该动)。非追加式形态(第三方改写等)
199
- 一律不手术:返回原 content 与空剥离表,由调用方按读数决策。
200
-
201
- 返回 `(new_content, removed)`;追加段完全剥净时 `new_content == reference`
202
- (正常回滚场景,逐字节)。判据与 `forgetting.aggregate_line` 同款字面
203
- (`AGG_MARK` 常量单点在 forgetting.py,不另写第二份)。
204
- """
205
- text = content or ""
206
- ref = reference or ""
207
- if not ref or not text.startswith(ref):
208
- return text, []
209
- tail = text[len(ref):]
210
- removed = []
211
- while tail.startswith("\n"):
212
- nl = tail.find("\n", 1)
213
- line = tail[1:] if nl < 0 else tail[1:nl]
214
- if not line.strip() or _forgetting.AGG_MARK not in line:
215
- break # 空行/非聚合行:停止(不越界手术)
216
- removed.append(line)
217
- tail = "" if nl < 0 else tail[nl:]
218
- # 收尾:追加段的**纯换行尾**(`nodefile.dumps:313` 给不以换行结尾的正文
219
- # 补过一个尾换行,读回时即多出——探针实测:合并后读回形态为
220
- # `前像 + "\n" + 聚合行 + "\n"`)在已剥过行时一并剥净,使正常场景逐字节
221
- # 回到前像;未剥过行(removed 为空)不动分毫。
222
- if removed and not tail.strip("\n"):
223
- tail = ""
224
- return ref + tail, removed
225
-
226
-
227
- # 生效条件:把 fm/content 以 _write_node 落盘到既有 path,随后按 _node_entry(与 _scan_nodes 同源)重算索引条目写入 index["nodes"] 与 _dirty(索引持久化靠 _dirty→flush→_index_log 重放),并失效 subgraph/chain/trust 三个反查缓存;本函数只被本模块的回滚分支调用;
228
- def _land(cg, node_id, path, fm, content):
229
- """回滚的**唯一落盘口**:写盘 + 索引重算 + 缓存失效(三步同口径)。
230
-
231
- 与 `mdcos.review_decide` merge 分支的定向 upsert 同款(`_node_entry`
232
- 与 `_scan_nodes` 同源,字段集零漂移);走 `_dirty`(**不走 `_stage`**
233
- ——它会虚增 bucket 计数,目标已在索引)。
234
- """
235
- cg._write_node(node_id, path, fm, content)
236
- layer = str(fm.get("layer") or "knowledge")
237
- try:
238
- e = cg._node_entry(path, layer, fm, content)
239
- except Exception: # noqa: BLE001 —— 重算失败不阻断回滚落盘
240
- e = None
241
- if e is not None:
242
- cg.index["nodes"][node_id] = e
243
- cg._dirty[node_id] = e
244
- _subgraph.invalidate_cache(cg)
245
- chain.invalidate_cache(cg)
246
- trust.invalidate_cache(cg)
247
-
248
-
249
- # 生效条件:node_id 的索引条目存在时返回其盘面绝对路径;不存在或条目无 path 时返回 None;
250
- def _disk_path(cg, node_id):
251
- e = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(node_id) or {}
252
- p = e.get("path")
253
- return os.path.join(cg.root, p) if p else None
254
-
255
-
256
- # 生效条件:对任意路径返回 bytes(不存在/不可读时返回 None——比对判据按 None 处理,不抛);
257
- def _bytes_of(path):
258
- if not path:
259
- return None
260
- try:
261
- with open(path, "rb") as f:
262
- return f.read()
263
- except OSError:
264
- return None
265
-
266
-
267
- # 生效条件:path 与 rel 都取到字节时返回两者逐字节相等的布尔;任一侧字节取不到时返回 False(不可证即不认——比对判据 fail-closed);
268
- def _bytes_equal(path, rel_path):
269
- a, b = _bytes_of(path), _bytes_of(rel_path)
270
- return a is not None and b is not None and a == b
271
-
272
-
273
- # 生效条件:C 改写回滚——索引中节点在位(不在位返回 ok False error target_missing)时把前像 (fm0,c0) 落到节点盘面 path(_land)+ flush,返回读数 dict;
274
- def _rollback_rewrite(cg, tgt, fm0, c0):
275
- path = _disk_path(cg, tgt)
276
- if path is None or _forgetting.prior_node(cg, tgt) is None:
277
- return {"ok": False, "error": "target_missing",
278
- "detail": "C 回滚:目标 %s 不在索引中——本变更之外还有变化,"
279
- "fail-closed 不猜落点(如属误删可先 restore)。" % tgt}
280
- _land(cg, tgt, path, fm0, c0)
281
- cg.flush()
282
- return {"ok": True, "restored_path": os.path.relpath(path, cg.root)
283
- .replace("\\", "/"), "method": "preimage"}
284
-
285
-
286
- # 生效条件:B 合并回滚——目标在位(不在位返回 ok False error target_missing)时先按 strip_aggregate_lines 剥离追加的聚合行,剥离结果与前像正文逐字节相等则正文取剥离结果、否则取前像正文(stripped_ok 如实记录),fm 全量取前像 (fm0),经 _land 落盘 + flush;返回读数 dict(removed_lines/stripped_ok/method);
287
- def _rollback_merge(cg, tgt, fm0, c0):
288
- cur = None
289
- try:
290
- cur = cg.get(tgt)
291
- except Exception: # noqa: BLE001
292
- cur = None
293
- if not cur:
294
- return {"ok": False, "error": "target_missing",
295
- "detail": "B 回滚:目标 %s 不可读——本变更之外还有变化,"
296
- "fail-closed 不猜落点。" % tgt}
297
- path = _disk_path(cg, tgt)
298
- if path is None:
299
- return {"ok": False, "error": "target_missing",
300
- "detail": "B 回滚:目标 %s 索引条目缺 path。" % tgt}
301
- c1 = cur.get("content") or ""
302
- stripped, removed = strip_aggregate_lines(c1, c0)
303
- stripped_ok = stripped == c0
304
- # 正文取剥离结果(正常场景逐字节==前像);剥离不精确(追加段含非聚合行等)
305
- # 时以快照正文为准——回滚的判据是「回到前像」,stripped_ok 如实记录。
306
- # fm 全量取前像:merge_count/last_merge_at/importance(+0.05 可被 1.0 截断)/
307
- # merge_sources/protected/lifecycle_state 等均不可逆,前像是唯一诚实来源。
308
- _land(cg, tgt, path, fm0, stripped if stripped_ok else c0)
309
- cg.flush()
310
- return {"ok": True, "restored_path": os.path.relpath(path, cg.root)
311
- .replace("\\", "/"),
312
- "method": "strip_aggregate_lines" if stripped_ok else "preimage",
313
- "stripped_ok": stripped_ok, "removed_lines": removed}
314
-
315
-
316
- # 生效条件:D 删除回滚——先调既有 cg.restore(tgt, force=True)(trash + 删除清单口径);restore 失败且(错误非 not_in_trash 或节点仍不在库)时返回 ok False(detail 带 restore 原返回体);restore 成功、或 not_in_trash 而节点已在库(此前已回滚过=幂等重放)时继续:按前像做逐字节校准(盘面与快照字节不等时经 _land 以 (fm0,c0) 重写,calibrated=True 如实记录——探针实测 restore 重建会多 sensitivity:null 键),返回读数 dict(replayed 标注重放);
317
- def _rollback_delete(cg, tgt, fm0, c0, rel):
318
- res = cg.restore(tgt, force=True)
319
- replayed = (not res.get("ok")) and res.get("error") == "not_in_trash" \
320
- and _forgetting.prior_node(cg, tgt) is not None
321
- if not res.get("ok") and not replayed:
322
- return {"ok": False, "error": res.get("error") or "restore_failed",
323
- "detail": {"restore": res},
324
- "hint": "D 回滚走既有 restore(trash + 删除清单)——失败即"
325
- "未恢复;如 trash 缺失可核对前像目录。"}
326
- path = _disk_path(cg, tgt)
327
- if path is None:
328
- return {"ok": False, "error": "target_missing",
329
- "detail": "D 回滚:restore 返回 ok 但索引无条目。"}
330
- pre_p = os.path.join(cg.root, str(rel).replace("/", os.sep))
331
- restore_bytes_equal = _bytes_equal(path, pre_p)
332
- calibrated = False
333
- if not restore_bytes_equal:
334
- # 校准(如实):restore 的 add 全量重建与快照存在字节差(实测 =
335
- # 多 `sensitivity: null` 键)——回滚的判据是「回到前像」,故以快照
336
- # 重写一次;`restore_bytes_equal=False` 读数保留,不假装 restore
337
- # 本身逐字节。
338
- _land(cg, tgt, path, fm0, c0)
339
- calibrated = True
340
- cg.flush()
341
- return {"ok": True, "restored_path": os.path.relpath(path, cg.root)
342
- .replace("\\", "/"),
343
- "method": "restore+preimage_calibration" if calibrated
344
- else "restore",
345
- "replayed": replayed,
346
- "calibrated": calibrated,
347
- "restore_bytes_equal": restore_bytes_equal}
348
-
349
-
350
- # 生效条件:before_impact 与 after 两个影响面 dict(缺面按空 dict)逐面返回对拍布尔——{"agg_lines_restored","edges_restored","index_restored"};
351
- def _residual(before_impact, after):
352
- bi = before_impact if isinstance(before_impact, dict) else {}
353
- return {
354
- "agg_lines_restored": (after.get("agg_lines") or [])
355
- == (bi.get("agg_lines") or []),
356
- "edges_restored": (after.get("edges") or {}) == (bi.get("edges") or {}),
357
- "index_restored": {k: (after.get("index") or {}).get(k)
358
- for k in _INDEX_KEYS}
359
- == {k: (bi.get("index") or {}).get(k)
360
- for k in _INDEX_KEYS},
361
- }
362
-
363
-
364
- # 生效条件:mutation 为 dict 且含非空 target 与 before(否则返回 ok False error mutation_missing/rollback_gap 带 hint);before 文件不可读按 RollbackError(code) 返回 ok False;动作类属 C/B/D 时按对应分支回滚,成功再重采影响面做残留对拍并做逐字节比对,返回 {"ok": True, "action","target","preimage","restored_path","bytes_equal_preimage","residual","method",...};动作类不属 C/B/D 时返回 ok False error rollback_action_unknown;本函数不抛(可预期错误一律返回体);
365
- def rollback_mutation(cg, mutation, reason="", actor=None):
366
- """统一回滚入口(设计 §四 四条:C/B/D 分派 + 残留核对 + 逐字节比对)。
367
-
368
- 输入=**执行时点载荷**(`autonomy_modes.mutation_executed` 形态,含
369
- action/target/before/impact/rollback);CLI 从 decisions.jsonl 的
370
- `rec["mutation"]` 读回。`reason`/`actor` 进返回体(审计由各分支的
371
- 落盘/restore 留痕承担,本模块不另写第二套台账)。
372
- """
373
- if not isinstance(mutation, dict):
374
- return {"ok": False, "error": "mutation_missing",
375
- "hint": "回滚入口需要变更单的执行时点载荷(dict)——"
376
- "decisions.jsonl 的 rec[\"mutation\"]。"}
377
- act = str(mutation.get("action") or "").strip().upper()
378
- tgt = str(mutation.get("target") or "").strip()
379
- rel = mutation.get("before")
380
- if not tgt:
381
- return {"ok": False, "error": "mutation_missing",
382
- "hint": "载荷缺 target——无法定位回滚对象。"}
383
- if not rel:
384
- return {"ok": False, "error": "rollback_gap",
385
- "hint": "载荷缺 before(执行时点前像引用):该变更单**未执行**"
386
- "(reject / fail-closed / pending)或执行记录不完整——"
387
- "fail-closed 不猜一个前像(前像必须来自执行时点)。"}
388
- if act not in _ROLLBACK_ACTIONS:
389
- return {"ok": False, "error": "rollback_action_unknown",
390
- "action": act or None,
391
- "hint": "回滚只覆盖 C 改写 / B 合并 / D 删除(设计 §四);"
392
- "动作类 %r 未定义回滚——fail-closed。" % (act or None)}
393
- try:
394
- fm0, c0 = read_preimage(cg, tgt, rel)
395
- except RollbackError as exc:
396
- return {"ok": False, "error": exc.code, "detail": str(exc),
397
- "action": act, "target": tgt, "preimage": rel}
398
- if act == "C":
399
- res = _rollback_rewrite(cg, tgt, fm0, c0)
400
- elif act == "B":
401
- res = _rollback_merge(cg, tgt, fm0, c0)
402
- else: # "D"
403
- res = _rollback_delete(cg, tgt, fm0, c0, rel)
404
- if not res.get("ok"):
405
- out = dict(res)
406
- out.update({"action": act, "target": tgt, "preimage": rel})
407
- return out
408
- # 残留核对(设计 §十一 红项面):重采影响面,与前像时点记录逐面对拍。
409
- after = collect_impact(cg, tgt)
410
- residual = _residual(mutation.get("impact"), after)
411
- # 逐字节比对前像(设计 §十一):盘面 vs 快照文件。
412
- pre_p = os.path.join(cg.root, str(rel).replace("/", os.sep))
413
- disk_p = _disk_path(cg, tgt)
414
- out = {"ok": True, "action": act, "target": tgt, "preimage": rel,
415
- "rollback_command": mutation.get("rollback") or "",
416
- "reason": str(reason or ""), "actor": actor,
417
- "bytes_equal_preimage": _bytes_equal(disk_p, pre_p),
418
- "residual": residual, "impact_after": after}
419
- out.update(res)
420
- return out
1
+ # -*- coding: utf-8 -*-
2
+ """三档自治 · 回滚原语通用化(设计 v0.2 §四/§十一 · 批次③)。
3
+
4
+ 设计 §四「回滚原语(已有,需通用化)」四条在本文档与实现中的落点:
5
+
6
+ 1. **受保护快照面推广为一切 C/D/B 动作**:`_protected_history/<id>/<时间戳>.md`
7
+ + `_protected_audit.jsonl`(protect.py 面)**面复用、语义泛化**——执行桥
8
+ 经 `preimage()` 在**执行时点**调 `protect.snapshot_preimage()` 拍前像;
9
+ `protect.py` 的既有 `snapshot()` / `guard_*` 行为**一字不改**(守卫钉死)。
10
+ 2. **软删(D)**:`trash/` + 删除清单的既有 `restore` 接进统一口径——
11
+ `rollback_mutation` 的 D 分支调 `cg.restore(force=True)`;restore 走 add
12
+ 全量重建,探针实测与原件有字节差(多 `sensitivity: null` 键),故其后按
13
+ 前像**校准**(`calibrated` 读数如实返回,不假装 restore 本身逐字节)。
14
+ 3. **合并(B)**:聚合行 `- 【聚合 …】`(`forgetting.AGG_MARK`)**定向剥离**
15
+ (`strip_aggregate_lines`)回退到合并前正文;fm 全量取前像——
16
+ merge_count/last_merge_at/importance/merge_sources/protected 等**不可逆**
17
+ (`-0.05` 会被 `min(1.0,…)` 截断、last_merge_at 旧值无从得知),前像快照
18
+ 是唯一诚实来源。
19
+ 4. **分数类(E)**:不属本批(设计 §四 明文「分数类:各模块既有 rollback」)。
20
+
21
+ 统一回滚入口 `rollback_mutation(cg, mutation, ...)`:输入=变更单的**执行时点
22
+ 载荷**(执行桥补全后的 `mutation_executed` 形态;CLI 从 decisions.jsonl 的
23
+ `rec["mutation"]` 读回),按动作类分派 C/B/D 三条原语,回滚后做**残留核对**
24
+ (边/索引条目/聚合行三面与前像时点影响面逐位对拍)与**逐字节比对前像**读数。
25
+
26
+ 边界(如实登记):
27
+ · 前像=执行时点快照——提议时点**不拍**(设计 §四:从提议到 accept 之间目标
28
+ 可能被第三方改动,回滚必须撤销本变更本身);执行记录里的 `before` 引用由
29
+ 执行桥补全,故对**未执行**(reject/fail-closed/pending)的变更单,本模块
30
+ fail-closed 拒绝回滚(`rollback_gap`,不允许凭空猜一个前像)。
31
+ · 加密库(覆写 `_seal_content` 的实例)密文层不保证逐字节可复现(每次封装
32
+ 熵不同)——`bytes_equal_preimage` 在非加密库上成立(探针实测);
33
+ 加密库语义为「明文内容 + 结构可恢复」,读数如实返回。
34
+ · `restore` 的 tombstone 检查保留语义:回滚是「确认该删除属于本变更」的
35
+ 处置,故显式 `force=True` 且 `reason` 写入返回体,不静默绕过。
36
+ """
37
+ from __future__ import annotations
38
+ import sys
39
+
40
+ import os
41
+ import time
42
+
43
+ from . import chain
44
+ from . import forgetting as _forgetting
45
+ from . import fsutil
46
+ from . import nodefile
47
+ from . import protect
48
+ from . import subgraph as _subgraph
49
+ from . import trust
50
+
51
+ __all__ = [
52
+ "RollbackError", "PreimageError",
53
+ "command_for", "preimage", "collect_impact", "read_preimage",
54
+ "strip_aggregate_lines", "rollback_mutation",
55
+ "node_fingerprint", "preimage_fingerprint",
56
+ ]
57
+
58
+ #: 影响面「索引条目」对拍键(`collect_impact` 采集、残留核对比对,同一份口径)。
59
+ _INDEX_KEYS = ("present", "path", "layer", "importance", "merge_count",
60
+ "protected", "tags")
61
+ #: 需要前像/可回滚的动作类(设计 §一:B 合并 / C 改写 / D 删除)。
62
+ _ROLLBACK_ACTIONS = ("B", "C", "D")
63
+ #: 盘面指纹取样的 frontmatter 键(**执行后像 / 前像 / 现盘面三侧同口径**)——
64
+ #: 只取判据相关的稳定键:内容哈希之外,「执行之后又被标保护 / 换层 / 重判验证态」
65
+ #: 同样属于「目标被动过」。刻意**不含** updated_at 之类每次落盘都变的键(否则
66
+ #: 「内容没变、只重写了一遍」会大面积误判成漂移,把合法回滚一并拒掉)。
67
+ _FINGERPRINT_FM_KEYS = ("immutable", "protection_reason", "layer", "sensitivity",
68
+ "verification_state", "lifecycle_state", "self_state",
69
+ "protected")
70
+ #: 回滚留痕的审计 op(`_audit.jsonl` 一行)——常量单点,守卫按同名常量取用。
71
+ ROLLBACK_AUDIT_OP = "rollback"
72
+
73
+
74
+ # 生效条件:node 为 cg.get 返回形态(None/非 dict/假值=目标不在盘)时返回 {"present": False};否则返回 {"present": True, "content_hash": nodefile.content_hash(content), "fm": {k: fm.get(k) for k in _FINGERPRINT_FM_KEYS}}(正文与 frontmatter 都取不到时按空串/空 dict 计,不抛);
75
+ def node_fingerprint(node):
76
+ """盘面指纹(正文内容哈希 + 判据相关 fm 键)——**唯一实现**。
77
+
78
+ 执行桥(`mdcos._mutation_execute`,执行落盘**之后**采「后像」)与回滚入口
79
+ (回滚**之前**采「现盘面」)共用同一份口径——两侧各写一份哈希/键表,
80
+ 漂移就会让闸门永远「匹配成功」而静默失效(同 `nodefile.content_hash`
81
+ 的纪律:全仓唯一实现)。
82
+ """
83
+ if not isinstance(node, dict) or not node:
84
+ return {"present": False}
85
+ fm = node.get("frontmatter") or {}
86
+ content = node.get("content") or ""
87
+ return {"present": True,
88
+ "content_hash": nodefile.content_hash(content),
89
+ "fm": {k: fm.get(k) for k in _FINGERPRINT_FM_KEYS}}
90
+
91
+
92
+ # 生效条件:fm/content 传入(缺省按空 dict/空串)时返回与 node_fingerprint 同形态的前像盘面指纹(present 恒 True、fm 只取 _FINGERPRINT_FM_KEYS 键);
93
+ def preimage_fingerprint(fm, content):
94
+ """前像盘面指纹——用于「现盘面是否**已经**等于前像」的幂等重放判定。"""
95
+ fm = fm or {}
96
+ return {"present": True,
97
+ "content_hash": nodefile.content_hash(content or ""),
98
+ "fm": {k: fm.get(k) for k in _FINGERPRINT_FM_KEYS}}
99
+
100
+
101
+ class RollbackError(RuntimeError):
102
+ """回滚无法执行(前像缺失/不可读、动作类未知等)——fail-closed。"""
103
+
104
+ def __init__(self, code, message, **extra):
105
+ super().__init__(message)
106
+ self.code = code
107
+ self.extra = extra
108
+
109
+
110
+ class PreimageError(RuntimeError):
111
+ """执行时点前像拍摄失败——执行桥据此 fail-closed(一切破坏性动作先留前像)。"""
112
+
113
+
114
+ # 生效条件:pid 非空时返回 `python -X utf8 -m md_cg.rollback_cli --root "<root>" --pid <pid>` 形态的命令串(唯一构造点);pid 为空时抛 ValueError;
115
+ def command_for(root, pid) -> str:
116
+ """回滚命令串(**唯一构造点**,可执行——守卫实测演练同一条串)。
117
+
118
+ 形态自定为 `md_cg.rollback_cli`:CLI 从 decisions.jsonl 读回该 pid 的
119
+ 执行记录(`rec["mutation"]`,含执行时点前像/影响面/回滚命令),按动作类
120
+ 分派统一回滚入口。root 用双引号包裹(路径可含空格)。
121
+ """
122
+ if not pid:
123
+ raise ValueError("回滚命令缺 pid:无 pid 即无法定位执行记录——"
124
+ "fail-closed 不构造命令串。")
125
+ return ('python -X utf8 -m md_cg.rollback_cli --root "%s" --pid %s'
126
+ % (root, pid))
127
+
128
+
129
+ # 生效条件:action 归一后属 _ROLLBACK_ACTIONS 时——forgetting.prior_node 判目标不存在则返回 None(动作不会发生,由调用方走既有 target_missing/not_found 路径);目标在位于执行时点拍前像(protect.snapshot_preimage)并采集影响面与回滚命令,返回 {"before","impact","rollback"};拍摄失败(目标在位而快照未落)抛 PreimageError(fail-closed);action 不属 _ROLLBACK_ACTIONS 时返回 None;
130
+ def preimage(cg, action, target, pid=None, reason=""):
131
+ """执行时点前像(快照引用 + 影响面 + 回滚命令)——**唯一采集点**。
132
+
133
+ 由执行桥(`mdcos._mutation_execute`)在动作原语落盘**之前**调用:
134
+ 拍到的快照即「执行前一刻」的盘面(含提议之后、执行之前的第三方改动),
135
+ 回滚据此撤销本变更本身(设计 §四:前像=执行时点,不是提议时点)。
136
+
137
+ 返回 None 的两条路径(都=动作不会发生,无需留前像):
138
+ · 动作类不属 B/C/D(未知动作类由执行桥的既有分支 fail-closed);
139
+ · 目标节点不存在(既有原语会走 target_missing/not_found,执行桥的
140
+ C 分支另有显式 target_missing 检查——本函数不抢它的错误形态)。
141
+ """
142
+ act = str(action or "").strip().upper()
143
+ if act not in _ROLLBACK_ACTIONS:
144
+ return None
145
+ if _forgetting.prior_node(cg, target) is None:
146
+ return None
147
+ rel = protect.snapshot_preimage(cg, target, action=act, pid=pid,
148
+ reason=reason)
149
+ if rel is None:
150
+ raise PreimageError(
151
+ "执行时点前像拍摄失败(目标 %s 在位但快照未落盘)——"
152
+ "一切破坏性动作先留前像(设计 §四/§六),本次 fail-closed 未执行。"
153
+ % target)
154
+ return {"before": rel,
155
+ "impact": collect_impact(cg, target),
156
+ "rollback": command_for(cg.root, pid)}
157
+
158
+
159
+ # 生效条件:对任意 cg、node_id 均返回影响面读数 dict——{"edges": {"declared","children","parents"}, "index": {"present","path","layer","importance","merge_count","protected","tags"}, "agg_lines": [...]}(节点不可读时各面取空值/None,不抛);本函数只读,不产生副作用;
160
+ def collect_impact(cg, node_id):
161
+ """执行时点影响面读数(设计 §四:边 / 索引条目 / 聚合行)。
162
+
163
+ 三个面都是**执行时点**(动作落盘前)的读数——回滚后由
164
+ `rollback_mutation` 重采一次逐位对拍(残留核对:回滚后不得残留本变更
165
+ 在任一面的痕迹)。采集走既有单点:`subgraph.children/parents_index`
166
+ (声明式 ∪ 边式)、索引条目直读、聚合行按 `forgetting.AGG_MARK` 字面判。
167
+ """
168
+ try:
169
+ node = cg.get(node_id)
170
+ except Exception: # noqa: BLE001 —— 读面失败按空读数采
171
+ node = None
172
+ fm = (node or {}).get("frontmatter") or {}
173
+ content = (node or {}).get("content") or ""
174
+ entry = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(node_id) \
175
+ or {}
176
+ return {
177
+ "edges": {
178
+ "declared": list(fm.get("edges") or []),
179
+ "children": _subgraph.children(cg, node_id),
180
+ "parents": list(_subgraph.parents_index(cg).get(node_id) or []),
181
+ },
182
+ "index": {
183
+ "present": bool(entry),
184
+ "path": entry.get("path"),
185
+ "layer": entry.get("layer"),
186
+ "importance": entry.get("importance"),
187
+ "merge_count": entry.get("merge_count"),
188
+ "protected": bool(entry.get("protected")),
189
+ "tags": list(entry.get("tags") or []),
190
+ },
191
+ # 聚合行行号(1 起):正文里字面含 AGG_MARK 的行——forgetting.aggregate_line
192
+ # 生成的形态是 `- 【聚合 月-日 时:分】…`;宽判据(含标记即计)与回滚核对同源。
193
+ "agg_lines": [i + 1 for i, l in enumerate(content.splitlines())
194
+ if _forgetting.AGG_MARK in l],
195
+ }
196
+
197
+
198
+ # 生效条件:rel 指向的文件不存在时抛 RollbackError(code="preimage_missing");存在则读取并以 cg._open_content(node_id, fm, raw) 对称解封,返回 (fm, content)——content 为 None(无密钥/身份不符)时抛 RollbackError(code="preimage_unreadable");文件含坏字节(非 UTF-8)无法解析时同样抛 RollbackError(code="preimage_unreadable")(fail-closed,不裸抛 UnicodeDecodeError);
199
+ def read_preimage(cg, node_id, rel):
200
+ """读执行时点前像文件(**与 snapshot_preimage 对称**:写走 _write_node 封装、
201
+ 读走 _open_content 解封)——返回 (fm, content)。
202
+
203
+ 注意:快照文件以节点文件同款 nodefile 序列化落盘;加密库中其内容为密封
204
+ 形态,必须经解封钩子读,直接 nodefile.loads 会把密文当明文再次封装
205
+ (双重封装)。非加密库两钩子恒等(探针实测逐字节一致)。
206
+
207
+ 文件含坏字节(非 UTF-8)无法解析时抛 RollbackError(code="preimage_unreadable")
208
+ ——fail-closed,不裸抛 UnicodeDecodeError。
209
+ """
210
+ p = os.path.join(cg.root, str(rel).replace("/", os.sep))
211
+ if not os.path.isfile(p):
212
+ raise RollbackError("preimage_missing",
213
+ "前像文件不存在:%s——变更单可能未执行(无前像)"
214
+ "或快照被移走;fail-closed 不猜一个前像。" % rel)
215
+ try:
216
+ with open(p, encoding="utf-8") as f:
217
+ fm, raw = nodefile.loads(f.read())
218
+ except UnicodeDecodeError as exc:
219
+ # 坏字节/非 UTF-8:fail-closed——绝不让 UnicodeDecodeError 裸抛逃逸
220
+ raise RollbackError("preimage_unreadable",
221
+ "前像文件坏字节 / 非 UTF-8 无法解析:%s(%s)——"
222
+ "fail-closed 不回滚。" % (rel, exc))
223
+ content = cg._open_content(node_id, fm, raw)
224
+ if content is None:
225
+ raise RollbackError("preimage_unreadable",
226
+ "前像不可解封(无密钥/身份不符):%s。" % rel)
227
+ return fm, content
228
+
229
+
230
+ # 生效条件:content 以 reference 为前缀且其后追加段逐段为「\n + 含 AGG_MARK 的非空行」时,逐段剥掉该追加段返回 (reference + 剩余段, 被剥行列表);不以 reference 为前缀、追加段形态不符、或 reference 为空时原样返回 (content, [])——不猜、不做字符串手术;
231
+ def strip_aggregate_lines(content, reference):
232
+ """定向剥离(设计 §四:合并回滚)——把**合并追加的聚合行**从正文里剥掉。
233
+
234
+ 为什么是「前缀 + 追加段」判据而不是全局扫行:合并原语(`forgetting.
235
+ reinforce` / `writelimit.converge_into`)对正文是**追加式**的
236
+ (`aggregate_line`:`new_body = body + "\\n" + line`),回滚的目标是回到
237
+ 前像正文——精确、可判、不误伤正文里历史遗留的聚合行(它们在前像里就已
238
+ 存在,属「合并前正文」的一部分,不该动)。非追加式形态(第三方改写等)
239
+ 一律不手术:返回原 content 与空剥离表,由调用方按读数决策。
240
+
241
+ 返回 `(new_content, removed)`;追加段完全剥净时 `new_content == reference`
242
+ (正常回滚场景,逐字节)。判据与 `forgetting.aggregate_line` 同款字面
243
+ (`AGG_MARK` 常量单点在 forgetting.py,不另写第二份)。
244
+ """
245
+ text = content or ""
246
+ ref = reference or ""
247
+ if not ref or not text.startswith(ref):
248
+ return text, []
249
+ tail = text[len(ref):]
250
+ removed = []
251
+ while tail.startswith("\n"):
252
+ nl = tail.find("\n", 1)
253
+ line = tail[1:] if nl < 0 else tail[1:nl]
254
+ if not line.strip() or _forgetting.AGG_MARK not in line:
255
+ break # 空行/非聚合行:停止(不越界手术)
256
+ removed.append(line)
257
+ tail = "" if nl < 0 else tail[nl:]
258
+ # 收尾:追加段的**纯换行尾**(`nodefile.dumps:313` 给不以换行结尾的正文
259
+ # 补过一个尾换行,读回时即多出——探针实测:合并后读回形态为
260
+ # `前像 + "\n" + 聚合行 + "\n"`)在已剥过行时一并剥净,使正常场景逐字节
261
+ # 回到前像;未剥过行(removed 为空)不动分毫。
262
+ if removed and not tail.strip("\n"):
263
+ tail = ""
264
+ return ref + tail, removed
265
+
266
+
267
+ # 生效条件:落盘前先过保护闸——protect.is_immutable(cg, node_id) 为真且 preimage_fm 未带同一保护位(immutable is True 或 layer ∈ PROTECTED_LAYERS)时,force 为假即返回拒绝体 dict(不写盘);随后尝试 protect.snapshot(cg, node_id) 把将被覆盖的当前版本留档(失败不阻断),再经 cg._write_node 落盘、按 _node_entry 重算索引条目写入 index["nodes"] 与 _dirty 并失效 subgraph/chain/trust 三个反查缓存,返回 None(落盘完成);本函数只被本模块的回滚分支调用;
268
+ def _land(cg, node_id, path, fm, content, preimage_fm=None, force=False,
269
+ actor=None):
270
+ """回滚的**唯一落盘口**:保护闸 + 前像快照 + 写盘 + 索引重算 + 缓存失效。
271
+
272
+ 与 `mdcos.review_decide` merge 分支的定向 upsert 同款(`_node_entry`
273
+ 与 `_scan_nodes` 同源,字段集零漂移);走 `_dirty`(**不走 `_stage`**
274
+ ——它会虚增 bucket 计数,目标已在索引)。
275
+
276
+ #352-A(2026-10-15):本口此前**三闸全无**——直接 `cg._write_node`,
277
+ 不走 `protect.guard_overwrite` / `guard_write`,不留 `protect.snapshot`
278
+ 前像副本,不写 `_audit`。后果:目标在执行之后被标 immutable 时,回滚
279
+ 照样覆写并把 immutable 标记一并清掉,且事后无从知道被覆盖的是哪一版。
280
+
281
+ 保护判据(**避免过度收紧**):只在「现盘面受保护 **而** 执行时点前像不带
282
+ 同一保护位」时拒绝——保护位是本变更**之后**加的,覆写会把它抹掉。若前像
283
+ 本身就带保护位(原节点本就 immutable / 在保护层),回滚只是把该保护位
284
+ 如实还原,属正常回滚,**不拦**(否则 D 删除回滚永远回不来受保护节点)。
285
+
286
+ 返回 None=落盘完成;返回 dict=拒绝体(`ok: False` + `error`),调用方
287
+ 据此 fail-closed 返回,绝不静默覆写。
288
+ """
289
+ try:
290
+ prot, why = protect.is_immutable(cg, node_id)
291
+ except Exception: # noqa: BLE001 —— 判定失败按不拦(读面异常不升级成拒服务)
292
+ prot, why = False, ""
293
+ if prot and not force:
294
+ _pre = preimage_fm or {}
295
+ _pre_prot = (_pre.get("immutable") is True
296
+ or str(_pre.get("layer") or "") in protect.PROTECTED_LAYERS)
297
+ if not _pre_prot:
298
+ return {"ok": False, "error": "protected_target",
299
+ "protection": why,
300
+ "detail": "回滚目标 %s 现受写保护(%s),而执行时点前像不带"
301
+ "该保护位——保护位是本变更**之后**加的,覆写会把它"
302
+ "一并清掉;fail-closed 未覆写(确认后加 --force)。"
303
+ % (node_id, why),
304
+ "hint": "如确需回滚:先解除保护(mdcg_protect 面)或对本单"
305
+ "显式 --force;二者都会留痕。"}
306
+ # 落盘前把**将被覆盖的当前版本**留档(protect 面既有单点,不另写第二套)。
307
+ try:
308
+ protect.snapshot(cg, node_id)
309
+ except Exception: # noqa: BLE001 —— 留档失败不阻断回滚本身
310
+ pass
311
+ cg._write_node(node_id, path, fm, content)
312
+ layer = str(fm.get("layer") or "knowledge")
313
+ try:
314
+ e = cg._node_entry(path, layer, fm, content)
315
+ except Exception: # noqa: BLE001 —— 重算失败不阻断回滚落盘
316
+ e = None
317
+ if e is not None:
318
+ cg.index["nodes"][node_id] = e
319
+ cg._dirty[node_id] = e
320
+ _subgraph.invalidate_cache(cg)
321
+ chain.invalidate_cache(cg)
322
+ trust.invalidate_cache(cg)
323
+
324
+
325
+ # 生效条件:node_id 的索引条目存在时返回其盘面绝对路径;不存在或条目无 path 时返回 None;
326
+ def _disk_path(cg, node_id):
327
+ e = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(node_id) or {}
328
+ p = e.get("path")
329
+ return os.path.join(cg.root, p) if p else None
330
+
331
+
332
+ # 生效条件:对任意路径返回 bytes(不存在/不可读时返回 None——比对判据按 None 处理,不抛);
333
+ def _bytes_of(path):
334
+ if not path:
335
+ return None
336
+ try:
337
+ with open(path, "rb") as f:
338
+ return f.read()
339
+ except OSError:
340
+ return None
341
+
342
+
343
+ # 生效条件:path 与 rel 都取到字节时返回两者逐字节相等的布尔;任一侧字节取不到时返回 False(不可证即不认——比对判据 fail-closed);
344
+ def _bytes_equal(path, rel_path):
345
+ a, b = _bytes_of(path), _bytes_of(rel_path)
346
+ return a is not None and b is not None and a == b
347
+
348
+
349
+ # 生效条件:C 改写回滚——索引中节点在位(不在位返回 ok False error target_missing)时把前像 (fm0,c0) 落到节点盘面 path(_land;保护闸拒绝即原样返回该拒绝体)+ flush,返回读数 dict;
350
+ def _rollback_rewrite(cg, tgt, fm0, c0, force=False, actor=None):
351
+ path = _disk_path(cg, tgt)
352
+ if path is None or _forgetting.prior_node(cg, tgt) is None:
353
+ return {"ok": False, "error": "target_missing",
354
+ "detail": "C 回滚:目标 %s 不在索引中——本变更之外还有变化,"
355
+ "fail-closed 不猜落点(如属误删可先 restore)。" % tgt}
356
+ refuse = _land(cg, tgt, path, fm0, c0, preimage_fm=fm0, force=force,
357
+ actor=actor)
358
+ if refuse is not None:
359
+ return refuse
360
+ cg.flush()
361
+ return {"ok": True, "restored_path": os.path.relpath(path, cg.root)
362
+ .replace("\\", "/"), "method": "preimage"}
363
+
364
+
365
+ # 生效条件:B 合并回滚——目标在位(不在位返回 ok False error target_missing)时先按 strip_aggregate_lines 剥离追加的聚合行,剥离结果与前像正文逐字节相等则正文取剥离结果、否则取前像正文(stripped_ok 如实记录),fm 全量取前像 (fm0),经 _land 落盘 + flush;返回读数 dict(removed_lines/stripped_ok/method);
366
+ def _rollback_merge(cg, tgt, fm0, c0, force=False, actor=None):
367
+ cur = None
368
+ try:
369
+ cur = cg.get(tgt)
370
+ except Exception: # noqa: BLE001
371
+ cur = None
372
+ if not cur:
373
+ return {"ok": False, "error": "target_missing",
374
+ "detail": "B 回滚:目标 %s 不可读——本变更之外还有变化,"
375
+ "fail-closed 不猜落点。" % tgt}
376
+ path = _disk_path(cg, tgt)
377
+ if path is None:
378
+ return {"ok": False, "error": "target_missing",
379
+ "detail": "B 回滚:目标 %s 索引条目缺 path。" % tgt}
380
+ c1 = cur.get("content") or ""
381
+ stripped, removed = strip_aggregate_lines(c1, c0)
382
+ stripped_ok = stripped == c0
383
+ # 正文取剥离结果(正常场景逐字节==前像);剥离不精确(追加段含非聚合行等)
384
+ # 时以快照正文为准——回滚的判据是「回到前像」,stripped_ok 如实记录。
385
+ # fm 全量取前像:merge_count/last_merge_at/importance(+0.05 可被 1.0 截断)/
386
+ # merge_sources/protected/lifecycle_state 等均不可逆,前像是唯一诚实来源。
387
+ refuse = _land(cg, tgt, path, fm0, stripped if stripped_ok else c0,
388
+ preimage_fm=fm0, force=force, actor=actor)
389
+ if refuse is not None:
390
+ return refuse
391
+ cg.flush()
392
+ return {"ok": True, "restored_path": os.path.relpath(path, cg.root)
393
+ .replace("\\", "/"),
394
+ "method": "strip_aggregate_lines" if stripped_ok else "preimage",
395
+ "stripped_ok": stripped_ok, "removed_lines": removed}
396
+
397
+
398
+ # 生效条件:D 删除回滚——先调既有 cg.restore(tgt, force=True)(trash + 删除清单口径);restore 失败且(错误非 not_in_trash 或节点仍不在库)时返回 ok False(detail 带 restore 原返回体);restore 成功、或 not_in_trash 而节点已在库(此前已回滚过=幂等重放)时继续:按前像做逐字节校准(盘面与快照字节不等时经 _land 以 (fm0,c0) 重写,calibrated=True 如实记录——探针实测 restore 重建会多 sensitivity:null 键),返回读数 dict(replayed 标注重放);
399
+ def _rollback_delete(cg, tgt, fm0, c0, rel, force=False, actor=None):
400
+ res = cg.restore(tgt, force=True)
401
+ replayed = (not res.get("ok")) and res.get("error") == "not_in_trash" \
402
+ and _forgetting.prior_node(cg, tgt) is not None
403
+ if not res.get("ok") and not replayed:
404
+ return {"ok": False, "error": res.get("error") or "restore_failed",
405
+ "detail": {"restore": res},
406
+ "hint": "D 回滚走既有 restore(trash + 删除清单)——失败即"
407
+ "未恢复;如 trash 缺失可核对前像目录。"}
408
+ path = _disk_path(cg, tgt)
409
+ if path is None:
410
+ return {"ok": False, "error": "target_missing",
411
+ "detail": "D 回滚:restore 返回 ok 但索引无条目。"}
412
+ pre_p = os.path.join(cg.root, str(rel).replace("/", os.sep))
413
+ restore_bytes_equal = _bytes_equal(path, pre_p)
414
+ calibrated = False
415
+ if not restore_bytes_equal:
416
+ # 校准(如实):restore 的 add 全量重建与快照存在字节差(实测 =
417
+ # 多 `sensitivity: null` 键)——回滚的判据是「回到前像」,故以快照
418
+ # 重写一次;`restore_bytes_equal=False` 读数保留,不假装 restore
419
+ # 本身逐字节。
420
+ refuse = _land(cg, tgt, path, fm0, c0, preimage_fm=fm0, force=force,
421
+ actor=actor)
422
+ if refuse is not None:
423
+ return refuse
424
+ calibrated = True
425
+ cg.flush()
426
+ return {"ok": True, "restored_path": os.path.relpath(path, cg.root)
427
+ .replace("\\", "/"),
428
+ "method": "restore+preimage_calibration" if calibrated
429
+ else "restore",
430
+ "replayed": replayed,
431
+ "calibrated": calibrated,
432
+ "restore_bytes_equal": restore_bytes_equal}
433
+
434
+
435
+ # 生效条件:before_impact 与 after 两个影响面 dict(缺面按空 dict)逐面返回对拍布尔——{"agg_lines_restored","edges_restored","index_restored"};
436
+ def _residual(before_impact, after):
437
+ bi = before_impact if isinstance(before_impact, dict) else {}
438
+ return {
439
+ "agg_lines_restored": (after.get("agg_lines") or [])
440
+ == (bi.get("agg_lines") or []),
441
+ "edges_restored": (after.get("edges") or {}) == (bi.get("edges") or {}),
442
+ "index_restored": {k: (after.get("index") or {}).get(k)
443
+ for k in _INDEX_KEYS}
444
+ == {k: (bi.get("index") or {}).get(k)
445
+ for k in _INDEX_KEYS},
446
+ }
447
+
448
+
449
+ # 生效条件:cg 为 None 或 cg.get 抛异常/返回假值时返回 None,否则返回 cg.get(node_id) 的结果(读面失败一律按「目标不可读」计,不抛);
450
+ def _node_of(cg, node_id):
451
+ if cg is None:
452
+ return None
453
+ try:
454
+ return cg.get(node_id)
455
+ except Exception: # noqa: BLE001
456
+ return None
457
+
458
+
459
+ # 生效条件:pid 为真且 cg.decisions() 可读时,返回本 pid 最后一条 decision=="accept" 记录**之后**、decision=="accept" 且 rec["mutation"]["target"] 等于 tgt 的记录 pid 列表(顺序同盘面);**取不到顺序(pid 为空 / 无该 pid / decisions 不可读)时返回 None**(=判据不可用,调用方据此不拦——不把「取不到证据」升级成拒绝);
460
+ def _later_executions(cg, tgt, pid):
461
+ """本单执行之后、同目标的 accept 执行记录(旧执行记录无 after_hash 时的兜底判据)。
462
+
463
+ decisions.jsonl 是 append-only,故「盘面顺序」即「时间顺序」——同一 pid 的
464
+ 最后一条 accept 之后出现的、target 相同的 accept 执行记录,就是「本单之后
465
+ 目标又被执行过一次」的证据面。
466
+ """
467
+ if not pid or cg is None:
468
+ return None
469
+ try:
470
+ rows = list(cg.decisions())
471
+ except Exception: # noqa: BLE001
472
+ return None
473
+ idx = None
474
+ for i, r in enumerate(rows):
475
+ if r.get("pid") == pid and r.get("decision") == "accept":
476
+ idx = i
477
+ if idx is None:
478
+ return None
479
+ out = []
480
+ for r in rows[idx + 1:]:
481
+ if r.get("decision") != "accept":
482
+ continue
483
+ mu = r.get("mutation")
484
+ if isinstance(mu, dict) and str(mu.get("target") or "") == tgt:
485
+ out.append(r.get("pid"))
486
+ return out
487
+
488
+
489
+ # 生效条件:对任意 cg/tgt/act/rel/res 都无条件返回布尔——先尝试 cg._audit("rollback", tgt, **meta)(MdCGOS 面,带 tenant/session/clearance 归因),失败或 cg 无 _audit 时退化为向 cg.root/_audit.jsonl 追加一行 {"t","op":"rollback","id","actor","action","pid","preimage","reason","method","bytes_equal_preimage"};两种情况都不抛(留痕失败不阻断已完成的回滚);
490
+ def _audit_rollback(cg, tgt, act, rel, res, actor=None, pid=None, reason=""):
491
+ """回滚留痕(`_audit.jsonl` 一行 op="rollback")——#352-A。
492
+
493
+ 改前本模块的 docstring 写「审计由各分支的落盘 / restore 留痕承担」,而
494
+ `_land` 这一支(C/B 以及 D 的校准路径)**一行审计都不写**:回滚是唯一
495
+ 不写台账的破坏性写口(步骤④准入读数第 3 条即为「R3 破坏可逆读数缺失」)。
496
+ 本函数是回滚留痕的**唯一落点**(op 常量集中在 `ROLLBACK_AUDIT_OP`)。
497
+ """
498
+ meta = {"action": act, "pid": pid, "preimage": rel,
499
+ "reason": str(reason or ""), "method": res.get("method"),
500
+ "bytes_equal_preimage": res.get("bytes_equal_preimage")}
501
+ fn = getattr(cg, "_audit", None)
502
+ if callable(fn):
503
+ try:
504
+ fn(ROLLBACK_AUDIT_OP, tgt, **meta)
505
+ return True
506
+ except Exception as e: # noqa: BLE001 —— 退化为直写
507
+ # #472 站点 2:**退化不再静默**(原为 `pass`)——写 stderr 留痕,并把本行标记为
508
+ # 「链外(已知退化)」,使 mdcos._audit_chain_verify 判为 known_degraded(**软信号**),
509
+ # **而非** unknown_foreign(后者是「有人插入」,安全要报)——**两者不得同一信号**。
510
+ try:
511
+ from .mdcos import AUDIT_KNOWN_DEGRADED as _KD
512
+ except Exception: # 循环导入等:退化为字面量
513
+ # ⚠️ **已登记的已知偏差**(issue #472,Lead 裁定「允许但必须登记」):
514
+ # 1) **这是回落副本、不是真源** —— 真源是 `mdcos.AUDIT_KNOWN_DEGRADED`;
515
+ # 2) **回落触发条件**:`from .mdcos import ...` 失败(循环导入等);
516
+ # 3) **已知漂移风险**:若有人只改 mdcos 侧的值,**回落到字面量的这条路径会静默
517
+ # 地用旧值** —— 这是「两份副本必然漂」在语言机制层的又一次落地。
518
+ # ⇒ 该偏差**已被腿钉住**:`md_cg/test_issue472_audit_chain.py` 的 C2 腿断言
519
+ # 「本回落字面量 == mdcos.AUDIT_KNOWN_DEGRADED 的真值」(AST 静态比对,
520
+ # 不需构造循环导入 ⇒ 可行)。
521
+ _KD = "AUDIT_KNOWN_DEGRADED"
522
+ sys.stderr.write("[rollback] cg._audit 不可用,退化直写(链外·已知退化):%s: %s"
523
+ % (type(e).__name__, e) + chr(10))
524
+ _degraded_mark = _KD
525
+ else:
526
+ _degraded_mark = None
527
+ rec = {"t": time.time(), "op": ROLLBACK_AUDIT_OP, "id": tgt,
528
+ "actor": actor}
529
+ if _degraded_mark:
530
+ rec["chain"] = _degraded_mark
531
+ rec.update(meta)
532
+ try:
533
+ fsutil.append_jsonl(os.path.join(cg.root, "_audit.jsonl"), rec)
534
+ return True
535
+ except Exception: # noqa: BLE001
536
+ return False
537
+
538
+
539
+ # 生效条件:mutation 为 dict 且含非空 target 与 before(否则返回 ok False error mutation_missing/rollback_gap 带 hint);before 文件不可读按 RollbackError(code) 返回 ok False;现盘面与执行后像不等且未显式 force 时返回 ok False error drifted_since_execute(现盘面已等于前像=幂等重放,放行);dry_run 为真时只返回读数不落盘;动作类属 C/B/D 时按对应分支回滚,成功再重采影响面做残留对拍、做逐字节比对并向 _audit.jsonl 写一行 op="rollback",返回 {"ok": True, "action","target","preimage","restored_path","bytes_equal_preimage","residual","method",...};动作类不属 C/B/D 时返回 ok False error rollback_action_unknown;本函数不抛(可预期错误一律返回体);
540
+ def rollback_mutation(cg, mutation, reason="", actor=None, force=False,
541
+ pid=None, dry_run=False):
542
+ """统一回滚入口(设计 §四 四条:C/B/D 分派 + 残留核对 + 逐字节比对)。
543
+
544
+ 输入=**执行时点载荷**(`autonomy_modes.mutation_executed` 形态,含
545
+ action/target/before/impact/rollback[/after_hash]);CLI 从 decisions.jsonl
546
+ 的 `rec["mutation"]` 读回。`reason`/`actor`/`pid` 进返回体与回滚留痕。
547
+
548
+ #352-A(2026-10-15)**漂移闸**(`drifted_since_execute`):回滚的语义是
549
+ 「撤销**本变更本身**、不抹第三方改动」(`autonomy_modes.mutation_payload`
550
+ :551-555 明文),而改前只处理了「提议→执行之间」的第三方改动(前像取执行
551
+ 时点),**没处理「执行→回滚之间」的改动**——回滚用执行时点前像**整体覆写**,
552
+ 执行之后写进去的正文(含另一张合并单追加的聚合行、删除后同 id 的重建、
553
+ 新增的 immutable 标记)一并消失,回执还报 `ok:True`。本闸的比较面:
554
+
555
+ · `after_hash`(执行桥在执行落盘**之后**采的「后像」指纹,
556
+ `md_cg/mdcos.py` 的 `_mutation_execute` 处补全)与现盘面指纹不等 ⇒ 拒;
557
+ · 旧执行记录(无 `after_hash`)⇒ 退化为扫 decisions.jsonl 同目标、本单
558
+ **之后**的 accept 执行记录,有则拒;顺序取不到(pid 未知)时不拦
559
+ (不把「取不到证据」升级成拒绝)。
560
+
561
+ **幂等重放豁免**:现盘面**已经等于前像**时直接放行——回滚本身已做过(或
562
+ 节点已处于前像状态),此时「覆写」是无操作,抹不掉任何东西。这条是既有
563
+ 守卫 Q/R/S 组的「回滚命令串二次演练(幂等重放,rc=0)」得以保持的判据。
564
+
565
+ `force=True` 跳过漂移闸与 `_land` 的保护闸(`rollback_cli --force`);
566
+ `dry_run=True` 只回报将被覆写的差异、不落盘。
567
+ """
568
+ if not isinstance(mutation, dict):
569
+ return {"ok": False, "error": "mutation_missing",
570
+ "hint": "回滚入口需要变更单的执行时点载荷(dict)——"
571
+ "decisions.jsonl 的 rec[\"mutation\"]。"}
572
+ act = str(mutation.get("action") or "").strip().upper()
573
+ tgt = str(mutation.get("target") or "").strip()
574
+ rel = mutation.get("before")
575
+ if not tgt:
576
+ return {"ok": False, "error": "mutation_missing",
577
+ "hint": "载荷缺 target——无法定位回滚对象。"}
578
+ if not rel:
579
+ return {"ok": False, "error": "rollback_gap",
580
+ "hint": "载荷缺 before(执行时点前像引用):该变更单**未执行**"
581
+ "(reject / fail-closed / pending)或执行记录不完整——"
582
+ "fail-closed 不猜一个前像(前像必须来自执行时点)。"}
583
+ if act not in _ROLLBACK_ACTIONS:
584
+ return {"ok": False, "error": "rollback_action_unknown",
585
+ "action": act or None,
586
+ "hint": "回滚只覆盖 C 改写 / B 合并 / D 删除(设计 §四);"
587
+ "动作类 %r 未定义回滚——fail-closed。" % (act or None)}
588
+ try:
589
+ fm0, c0 = read_preimage(cg, tgt, rel)
590
+ except RollbackError as exc:
591
+ return {"ok": False, "error": exc.code, "detail": str(exc),
592
+ "action": act, "target": tgt, "preimage": rel}
593
+ # ---- 漂移闸(#352-A):执行之后目标又被写过 ⇒ fail-closed,不整体覆写 ----
594
+ cur_fp = node_fingerprint(_node_of(cg, tgt))
595
+ pre_fp = preimage_fingerprint(fm0, c0)
596
+ drift = None
597
+ if cur_fp != pre_fp and not force: # 相等=幂等重放,放行(见 docstring)
598
+ want = mutation.get("after_hash")
599
+ if isinstance(want, dict):
600
+ if cur_fp != want:
601
+ drift = {"ok": False, "error": "drifted_since_execute",
602
+ "action": act, "target": tgt, "preimage": rel,
603
+ "current": cur_fp, "expected_after_execute": want,
604
+ "hint": "本单**执行之后**目标又被写过——回滚会用执行时点"
605
+ "前像整体覆写,把这些写入一并抹掉(设计 §四:"
606
+ "回滚只撤销本变更本身、不抹第三方改动)。"
607
+ "已 fail-closed 未覆写:先核对上面的 current / "
608
+ "expected_after_execute 差异,确需回滚加 --force。",
609
+ "reason": str(reason or ""), "actor": actor}
610
+ else:
611
+ later = _later_executions(cg, tgt, pid)
612
+ if later:
613
+ drift = {"ok": False, "error": "drifted_since_execute",
614
+ "action": act, "target": tgt, "preimage": rel,
615
+ "current": cur_fp, "later_executions": later,
616
+ "hint": "该执行记录无 after_hash(改前落盘)——按"
617
+ "decisions.jsonl 判据:本单之后同目标还有 accept "
618
+ "执行记录 %s,回滚会抹掉它们的写入;fail-closed "
619
+ "未覆写(确需回滚加 --force)。" % (later,),
620
+ "reason": str(reason or ""), "actor": actor}
621
+ if drift is not None:
622
+ if dry_run:
623
+ out = dict(drift, dry_run=True, would_apply=False)
624
+ return out
625
+ return drift
626
+ if dry_run:
627
+ return {"ok": True, "dry_run": True, "would_apply": True,
628
+ "action": act, "target": tgt, "preimage": rel,
629
+ "current": cur_fp, "preimage_state": pre_fp,
630
+ "expected_after_execute": mutation.get("after_hash"),
631
+ "reason": str(reason or ""), "actor": actor}
632
+ if act == "C":
633
+ res = _rollback_rewrite(cg, tgt, fm0, c0, force=force, actor=actor)
634
+ elif act == "B":
635
+ res = _rollback_merge(cg, tgt, fm0, c0, force=force, actor=actor)
636
+ else: # "D"
637
+ res = _rollback_delete(cg, tgt, fm0, c0, rel, force=force, actor=actor)
638
+ if not res.get("ok"):
639
+ out = dict(res)
640
+ out.update({"action": act, "target": tgt, "preimage": rel})
641
+ return out
642
+ # 残留核对(设计 §十一 红项面):重采影响面,与前像时点记录逐面对拍。
643
+ after = collect_impact(cg, tgt)
644
+ residual = _residual(mutation.get("impact"), after)
645
+ # 逐字节比对前像(设计 §十一):盘面 vs 快照文件。
646
+ pre_p = os.path.join(cg.root, str(rel).replace("/", os.sep))
647
+ disk_p = _disk_path(cg, tgt)
648
+ out = {"ok": True, "action": act, "target": tgt, "preimage": rel,
649
+ "rollback_command": mutation.get("rollback") or "",
650
+ "reason": str(reason or ""), "actor": actor, "pid": pid,
651
+ "bytes_equal_preimage": _bytes_equal(disk_p, pre_p),
652
+ "residual": residual, "impact_after": after}
653
+ out.update(res)
654
+ # 回滚留痕(#352-A):唯一不变更 _audit 的破坏性写口就此收口。
655
+ out["audited"] = _audit_rollback(cg, tgt, act, rel, out, actor=actor,
656
+ pid=pid, reason=reason)
657
+ return out