@furongjun1999/dsh-memory 0.9.6 → 0.9.8

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 (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
@@ -1,124 +1,124 @@
1
- # -*- coding: utf-8 -*-
2
- """rollback_cli · 变更单回滚命令行(三档自治 · 设计 v0.2 §四「回滚原语四条」)。
3
-
4
- 用法(root 须与执行该变更单的部署一致:--root 或环境变量 MDCG_ROOT):
5
- python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid>
6
- python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid> --reason "..."
7
- python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid> --dry-run
8
- python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid> --force
9
-
10
- 本模块是**回滚命令串的载体**:变更单执行时点的 `rollback` 字段即指向本 CLI
11
- (`md_cg.rollback.command_for` 构造,随执行记录落 decisions.jsonl 的
12
- `rec["mutation"]["rollback"]`)。CLI 做的事:
13
-
14
- 1. 从 `<root>/hippocampus/decisions.jsonl` 读回该 pid 最后一条
15
- `decision="accept"` 的裁决记录,取其 `rec["mutation"]`(**执行时点载荷**
16
- ——动作类/目标/前像/影响面/回滚命令由执行桥补全);
17
- 2. 交统一回滚入口 `rollback.rollback_mutation` 按动作类分派:
18
- · C 改写 → 从执行时点前像恢复(含第三方改动的那个版本);
19
- · B 合并 → 聚合行定向剥离 + 前像 fm 恢复;
20
- · D 删除 → 既有 restore(trash + 删除清单口径)+ 前像校准;
21
- 3. 输出 JSON(stdout):`ok` + `bytes_equal_preimage`(逐字节比对前像读数)
22
- + `residual`(残留核对:边/索引条目/聚合行三面)。
23
-
24
- **#352-A(2026-10-15)两个新开关**(缺省行为一字不变):
25
- · `--dry-run`:只回报「将被覆写的差异」与漂移判定,**不落盘**——执行回滚的人
26
- 在动手前能看到这次回滚会抹掉什么;
27
- · `--force`:显式越过**漂移闸**(`drifted_since_execute`)与 `_land` 的
28
- 保护闸。改前这两道判据都不存在:执行之后的写入被静默覆写、immutable 目标
29
- 被覆写且标记被清掉,回执仍是 `ok:true`。改后二者都 fail-closed,只有显式
30
- `--force` 才放行(并把 force 写进返回体与回滚留痕)。
31
-
32
- 退出码:0 = 回滚完成(读数照实打印,含校准等如实字段);1 = 未回滚
33
- (错误体照实打印——绝不假装成功)。
34
-
35
- 边界(如实):本 CLI 不做裁决(回滚是执行记录的既有授权动作——它的执行时点
36
- 前像就是执行桥拍的);对**未执行**(reject / fail-closed / pending)的变更单,
37
- 统一入口以 `rollback_gap` fail-closed 拒绝(无前像即不猜)。
38
- """
39
- import argparse
40
- import json
41
- import os
42
- import sys
43
-
44
- try:
45
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
46
- except AttributeError:
47
- pass
48
-
49
- _HERE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
50
- if _HERE not in sys.path:
51
- sys.path.insert(0, _HERE)
52
-
53
- from md_cg import rollback as _rb # noqa: E402
54
- from md_cg.mdcos import MdCGOS # noqa: E402
55
-
56
-
57
- # 生效条件:args 的 root 属性为真值(含 getattr 缺省 None 时回落)否则回落 os.environ.get("MDCG_ROOT", ""),两者皆空串或该值经 os.path.isdir 判定不是目录时 sys.exit 退出,否则返回该 root;
58
- def _root(args):
59
- root = getattr(args, "root", None) or os.environ.get("MDCG_ROOT", "")
60
- if not root:
61
- sys.exit("错误:未指定存储根(--root 或环境变量 MDCG_ROOT)。\n"
62
- "root 必须与执行该变更单的部署一致——猜错会回滚到另一个库。")
63
- if not os.path.isdir(root):
64
- sys.exit("错误:root 不存在:%s" % root)
65
- return root
66
-
67
-
68
- # 生效条件:cg 与 pid 就绪时返回 decisions 记录中 pid 匹配、decision=="accept" 且 rec["mutation"] 为 dict 的最后一条记录;无匹配返回 None(调用方 fail-closed);
69
- def _mutation_record(cg, pid):
70
- """从裁决记录读回变更单的执行时点载荷(rec["mutation"])。"""
71
- picked = None
72
- for r in cg.decisions():
73
- if r.get("pid") != pid:
74
- continue
75
- if r.get("decision") != "accept":
76
- continue
77
- if isinstance(r.get("mutation"), dict):
78
- picked = r
79
- return picked
80
-
81
-
82
- # 生效条件:argv 为 None(默认)时由 argparse 解析 sys.argv、否则解析传入的 argv(--root/--pid 必填、--reason 可选),解析成功后取 root 构造 MdCGOS(root, autoflush=1),无匹配执行记录时打印 ok False error decision_not_found 并返回 1,否则调 rollback.rollback_mutation 打印其结果 JSON,按其 ok 真值返回 0、假值返回 1;finally 中执行 cg.close();
83
- def main(argv=None):
84
- ap = argparse.ArgumentParser(
85
- prog="python -m md_cg.rollback_cli",
86
- description="变更单回滚(设计 §四:从执行时点前像恢复)")
87
- ap.add_argument("--root", help="存储根目录(默认环境变量 MDCG_ROOT)")
88
- ap.add_argument("--pid", required=True, help="变更单的裁决 pid(accept 记录)")
89
- ap.add_argument("--reason", default="", help="回滚理由(进返回体)")
90
- ap.add_argument("--dry-run", dest="dry_run", action="store_true",
91
- help="只回报将被覆写的差异与漂移判定,不落盘(#352-A)")
92
- ap.add_argument("--force", action="store_true",
93
- help="越过漂移闸与保护闸(#352-A;显式承担抹掉执行之后"
94
- "写入的后果)")
95
- args = ap.parse_args(argv)
96
-
97
- cg = MdCGOS(_root(args), autoflush=1)
98
- try:
99
- rec = _mutation_record(cg, args.pid)
100
- if rec is None:
101
- out = {"ok": False, "error": "decision_not_found", "pid": args.pid,
102
- "hint": "decisions.jsonl 中无该 pid 的 accept 执行记录"
103
- "(或记录缺 mutation 载荷)——变更单未执行即无可"
104
- "回滚的前像(fail-closed,不猜)。"}
105
- print(json.dumps(out, ensure_ascii=False))
106
- return 1
107
- out = _rb.rollback_mutation(cg, rec["mutation"], reason=args.reason,
108
- actor="rollback-cli", pid=args.pid,
109
- force=args.force, dry_run=args.dry_run)
110
- print(json.dumps(out, ensure_ascii=False, default=str))
111
- # dry-run 是**只读预演**:即使判定「会拒绝」(漂移)也返回 0——它没有
112
- # 拒绝任何东西(什么都没做),把预演结果当退出码会让调用方以为回滚失败。
113
- if args.dry_run:
114
- return 0
115
- return 0 if out.get("ok") else 1
116
- finally:
117
- # 收尾(与 review_cli 同款):回滚落盘经 _dirty→flush→_index_log,
118
- # 不 close 则「节点在盘上但索引无条目」;库层另有 atexit 兜底,显式
119
- # 收尾才是正路。
120
- cg.close()
121
-
122
-
123
- if __name__ == "__main__":
124
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """rollback_cli · 变更单回滚命令行(三档自治 · 设计 v0.2 §四「回滚原语四条」)。
3
+
4
+ 用法(root 须与执行该变更单的部署一致:--root 或环境变量 MDCG_ROOT):
5
+ python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid>
6
+ python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid> --reason "..."
7
+ python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid> --dry-run
8
+ python -X utf8 -m md_cg.rollback_cli --root <root> --pid <pid> --force
9
+
10
+ 本模块是**回滚命令串的载体**:变更单执行时点的 `rollback` 字段即指向本 CLI
11
+ (`md_cg.rollback.command_for` 构造,随执行记录落 decisions.jsonl 的
12
+ `rec["mutation"]["rollback"]`)。CLI 做的事:
13
+
14
+ 1. 从 `<root>/hippocampus/decisions.jsonl` 读回该 pid 最后一条
15
+ `decision="accept"` 的裁决记录,取其 `rec["mutation"]`(**执行时点载荷**
16
+ ——动作类/目标/前像/影响面/回滚命令由执行桥补全);
17
+ 2. 交统一回滚入口 `rollback.rollback_mutation` 按动作类分派:
18
+ · C 改写 → 从执行时点前像恢复(含第三方改动的那个版本);
19
+ · B 合并 → 聚合行定向剥离 + 前像 fm 恢复;
20
+ · D 删除 → 既有 restore(trash + 删除清单口径)+ 前像校准;
21
+ 3. 输出 JSON(stdout):`ok` + `bytes_equal_preimage`(逐字节比对前像读数)
22
+ + `residual`(残留核对:边/索引条目/聚合行三面)。
23
+
24
+ **#352-A(2026-10-15)两个新开关**(缺省行为一字不变):
25
+ · `--dry-run`:只回报「将被覆写的差异」与漂移判定,**不落盘**——执行回滚的人
26
+ 在动手前能看到这次回滚会抹掉什么;
27
+ · `--force`:显式越过**漂移闸**(`drifted_since_execute`)与 `_land` 的
28
+ 保护闸。改前这两道判据都不存在:执行之后的写入被静默覆写、immutable 目标
29
+ 被覆写且标记被清掉,回执仍是 `ok:true`。改后二者都 fail-closed,只有显式
30
+ `--force` 才放行(并把 force 写进返回体与回滚留痕)。
31
+
32
+ 退出码:0 = 回滚完成(读数照实打印,含校准等如实字段);1 = 未回滚
33
+ (错误体照实打印——绝不假装成功)。
34
+
35
+ 边界(如实):本 CLI 不做裁决(回滚是执行记录的既有授权动作——它的执行时点
36
+ 前像就是执行桥拍的);对**未执行**(reject / fail-closed / pending)的变更单,
37
+ 统一入口以 `rollback_gap` fail-closed 拒绝(无前像即不猜)。
38
+ """
39
+ import argparse
40
+ import json
41
+ import os
42
+ import sys
43
+
44
+ try:
45
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
46
+ except AttributeError:
47
+ pass
48
+
49
+ _HERE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
50
+ if _HERE not in sys.path:
51
+ sys.path.insert(0, _HERE)
52
+
53
+ from md_cg import rollback as _rb # noqa: E402
54
+ from md_cg.mdcos import MdCGOS # noqa: E402
55
+
56
+
57
+ # 生效条件:args 的 root 属性为真值(含 getattr 缺省 None 时回落)否则回落 os.environ.get("MDCG_ROOT", ""),两者皆空串或该值经 os.path.isdir 判定不是目录时 sys.exit 退出,否则返回该 root;
58
+ def _root(args):
59
+ root = getattr(args, "root", None) or os.environ.get("MDCG_ROOT", "")
60
+ if not root:
61
+ sys.exit("错误:未指定存储根(--root 或环境变量 MDCG_ROOT)。\n"
62
+ "root 必须与执行该变更单的部署一致——猜错会回滚到另一个库。")
63
+ if not os.path.isdir(root):
64
+ sys.exit("错误:root 不存在:%s" % root)
65
+ return root
66
+
67
+
68
+ # 生效条件:cg 与 pid 就绪时返回 decisions 记录中 pid 匹配、decision=="accept" 且 rec["mutation"] 为 dict 的最后一条记录;无匹配返回 None(调用方 fail-closed);
69
+ def _mutation_record(cg, pid):
70
+ """从裁决记录读回变更单的执行时点载荷(rec["mutation"])。"""
71
+ picked = None
72
+ for r in cg.decisions():
73
+ if r.get("pid") != pid:
74
+ continue
75
+ if r.get("decision") != "accept":
76
+ continue
77
+ if isinstance(r.get("mutation"), dict):
78
+ picked = r
79
+ return picked
80
+
81
+
82
+ # 生效条件:argv 为 None(默认)时由 argparse 解析 sys.argv、否则解析传入的 argv(--root/--pid 必填、--reason 可选),解析成功后取 root 构造 MdCGOS(root, autoflush=1),无匹配执行记录时打印 ok False error decision_not_found 并返回 1,否则调 rollback.rollback_mutation 打印其结果 JSON,按其 ok 真值返回 0、假值返回 1;finally 中执行 cg.close();
83
+ def main(argv=None):
84
+ ap = argparse.ArgumentParser(
85
+ prog="python -m md_cg.rollback_cli",
86
+ description="变更单回滚(设计 §四:从执行时点前像恢复)")
87
+ ap.add_argument("--root", help="存储根目录(默认环境变量 MDCG_ROOT)")
88
+ ap.add_argument("--pid", required=True, help="变更单的裁决 pid(accept 记录)")
89
+ ap.add_argument("--reason", default="", help="回滚理由(进返回体)")
90
+ ap.add_argument("--dry-run", dest="dry_run", action="store_true",
91
+ help="只回报将被覆写的差异与漂移判定,不落盘(#352-A)")
92
+ ap.add_argument("--force", action="store_true",
93
+ help="越过漂移闸与保护闸(#352-A;显式承担抹掉执行之后"
94
+ "写入的后果)")
95
+ args = ap.parse_args(argv)
96
+
97
+ cg = MdCGOS(_root(args), autoflush=1)
98
+ try:
99
+ rec = _mutation_record(cg, args.pid)
100
+ if rec is None:
101
+ out = {"ok": False, "error": "decision_not_found", "pid": args.pid,
102
+ "hint": "decisions.jsonl 中无该 pid 的 accept 执行记录"
103
+ "(或记录缺 mutation 载荷)——变更单未执行即无可"
104
+ "回滚的前像(fail-closed,不猜)。"}
105
+ print(json.dumps(out, ensure_ascii=False))
106
+ return 1
107
+ out = _rb.rollback_mutation(cg, rec["mutation"], reason=args.reason,
108
+ actor="rollback-cli", pid=args.pid,
109
+ force=args.force, dry_run=args.dry_run)
110
+ print(json.dumps(out, ensure_ascii=False, default=str))
111
+ # dry-run 是**只读预演**:即使判定「会拒绝」(漂移)也返回 0——它没有
112
+ # 拒绝任何东西(什么都没做),把预演结果当退出码会让调用方以为回滚失败。
113
+ if args.dry_run:
114
+ return 0
115
+ return 0 if out.get("ok") else 1
116
+ finally:
117
+ # 收尾(与 review_cli 同款):回滚落盘经 _dirty→flush→_index_log,
118
+ # 不 close 则「节点在盘上但索引无条目」;库层另有 atexit 兜底,显式
119
+ # 收尾才是正路。
120
+ cg.close()
121
+
122
+
123
+ if __name__ == "__main__":
124
+ sys.exit(main())