@furongjun1999/dsh-memory 0.9.6 → 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 (216) hide show
  1. package/data/policy.json +38 -38
  2. package/docs/discipline/templates/spec.txt.tmpl +1 -1
  3. package/dsh/cordis.yml.example +139 -139
  4. package/lib/hooks.d.ts +19 -0
  5. package/lib/hooks.js +29 -6
  6. package/lib/index.js +11 -2
  7. package/lib/lib/hook_audit.js +38 -2
  8. package/lib/lib/prompt_safety.js +14 -3
  9. package/lib/tools.d.ts +7 -0
  10. package/lib/tools.js +22 -1
  11. package/md_cg/_guard_kit.py +121 -121
  12. package/md_cg/anchor.py +114 -114
  13. package/md_cg/audit.py +15 -2
  14. package/md_cg/chain.py +3 -2
  15. package/md_cg/config_registry_guard.py +487 -487
  16. package/md_cg/conformance.py +747 -747
  17. package/md_cg/consolidate.py +1793 -1793
  18. package/md_cg/crypto.py +794 -794
  19. package/md_cg/hyperedge.py +262 -262
  20. package/md_cg/interface_schema.py +146 -146
  21. package/md_cg/lifecycle.py +426 -426
  22. package/md_cg/mdcos.py +12 -8
  23. package/md_cg/predict.py +1103 -1103
  24. package/md_cg/protect.py +654 -654
  25. package/md_cg/provenance.py +606 -606
  26. package/md_cg/queue_health.py +130 -130
  27. package/md_cg/refine.py +613 -613
  28. package/md_cg/retrieve.py +128 -128
  29. package/md_cg/revise.py +140 -140
  30. package/md_cg/rollback.py +657 -657
  31. package/md_cg/rollback_cli.py +124 -124
  32. package/md_cg/rotate.py +346 -346
  33. package/md_cg/routing.py +490 -490
  34. package/md_cg/self_surface.py +50 -50
  35. package/md_cg/semantic/canonical.py +144 -144
  36. package/md_cg/semantic/zh_en_atoms.py +141 -141
  37. package/md_cg/sources.py +1091 -1091
  38. package/md_cg/stg.py +3 -2
  39. package/md_cg/test_audit_rotate_parity.py +279 -279
  40. package/md_cg/test_autonomy_modes.py +2013 -2013
  41. package/md_cg/test_cn_recall_grams.py +206 -206
  42. package/md_cg/test_code_kind_forbidden.py +101 -0
  43. package/md_cg/test_condaccept.py +156 -156
  44. package/md_cg/test_condgate.py +141 -141
  45. package/md_cg/test_heartbeat_ledger.py +557 -557
  46. package/md_cg/test_i50e_readside_protection.py +658 -658
  47. package/md_cg/test_issue111_gate_order.py +76 -76
  48. package/md_cg/test_issue111_scoring_contract.py +86 -86
  49. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  50. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  51. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  52. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  53. package/md_cg/test_issue149_accel_default_face.py +248 -248
  54. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  55. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  56. package/md_cg/test_issue152_sealed_postings.py +309 -309
  57. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  58. package/md_cg/test_issue157b_index_remainder.py +344 -344
  59. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  60. package/md_cg/test_issue191_import_trust.py +382 -382
  61. package/md_cg/test_issue193_write_scope.py +378 -378
  62. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  63. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  64. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  65. package/md_cg/test_issue216_clash_routes.py +214 -214
  66. package/md_cg/test_issue217_slot_routes.py +248 -248
  67. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  68. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  69. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  70. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  71. package/md_cg/test_issue275_layer_param.py +250 -250
  72. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  73. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  74. package/md_cg/test_issue278_neg_window.py +294 -294
  75. package/md_cg/test_issue278_negative_layering.py +83 -83
  76. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  77. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  78. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  79. package/md_cg/test_issue303_design_boundaries.py +262 -262
  80. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  81. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  82. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  83. package/md_cg/test_issue322_node_write_lock.py +727 -727
  84. package/md_cg/test_issue324_write_size_fields.py +214 -214
  85. package/md_cg/test_issue325_audit_poison.py +229 -229
  86. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  87. package/md_cg/test_issue326_key_perms.py +355 -355
  88. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  89. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  90. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  91. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  92. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  93. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  94. package/md_cg/test_issue350_casefold_collision.py +235 -235
  95. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  96. package/md_cg/test_issue352_imgaudit.py +418 -418
  97. package/md_cg/test_issue352_pathsjson.py +537 -537
  98. package/md_cg/test_issue352_refindex.py +412 -412
  99. package/md_cg/test_issue352_rollback.py +604 -604
  100. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  101. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  102. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  103. package/md_cg/test_issue358_truncation_observable.py +247 -247
  104. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  105. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  106. package/md_cg/test_issue362_neg_condition.py +468 -468
  107. package/md_cg/test_issue363_lexical_idf.py +275 -275
  108. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  109. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  110. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  111. package/md_cg/test_issue378_protected_floor.py +310 -310
  112. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  113. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  114. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  115. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  116. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  117. package/md_cg/test_issue404_heal_receipt.py +389 -389
  118. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  119. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  120. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  121. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  122. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  123. package/md_cg/test_issue413_preimage_twin.py +339 -339
  124. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  125. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  126. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  127. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  128. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  129. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  130. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  131. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  132. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  133. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  134. package/md_cg/test_issue434_435_float_gate.py +90 -90
  135. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  136. package/md_cg/test_issue43_default_policy.py +874 -874
  137. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  138. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  139. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  140. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  141. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  142. package/md_cg/test_issue451_audit_actor.py +313 -313
  143. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  144. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  145. package/md_cg/test_issue466_basis_registry.py +469 -469
  146. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  147. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  148. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  149. package/md_cg/test_issue471_identity_readable.py +136 -136
  150. package/md_cg/test_issue472_audit_chain.py +90 -90
  151. package/md_cg/test_issue472_prune_ledger.py +105 -105
  152. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  153. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  154. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  155. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  156. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  157. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  158. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  159. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  160. package/md_cg/test_issue547_audit_durable.py +96 -96
  161. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  162. package/md_cg/test_issue559_refine_prefix.py +69 -69
  163. package/md_cg/test_issue562_retired_faces.py +150 -0
  164. package/md_cg/test_issue71_queue_backlog.py +376 -376
  165. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  166. package/md_cg/test_issue82_credential_rules.py +271 -271
  167. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  168. package/md_cg/test_issue93_remember_redaction.py +282 -282
  169. package/md_cg/test_logref.py +1141 -1141
  170. package/md_cg/test_md_access_parity.py +330 -330
  171. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  172. package/md_cg/test_mutation_residue.py +119 -119
  173. package/md_cg/test_mutation_rollback.py +835 -835
  174. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  175. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  176. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  177. package/md_cg/test_neg_tail_honesty.py +733 -733
  178. package/md_cg/test_p21_tokens.py +294 -294
  179. package/md_cg/test_p27_docindex.py +792 -792
  180. package/md_cg/test_p28_refcheck.py +1053 -1053
  181. package/md_cg/test_p2_six_elements.py +476 -476
  182. package/md_cg/test_p33_ccg_wiring.py +300 -300
  183. package/md_cg/test_p3_legacy_closure.py +438 -438
  184. package/md_cg/test_p40_refine_worklist.py +244 -244
  185. package/md_cg/test_p4_freshness.py +781 -781
  186. package/md_cg/test_p9c_dedup_hints.py +288 -288
  187. package/md_cg/test_policy_required_ccg.py +444 -444
  188. package/md_cg/test_retr_s5.py +312 -312
  189. package/md_cg/test_s1_ast_judge.py +109 -109
  190. package/md_cg/test_state_event_op.py +521 -521
  191. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  192. package/md_cg/test_sustain_bounded.py +652 -652
  193. package/md_cg/test_trust_edge_reachability.py +405 -405
  194. package/md_cg/test_w7_redlines.py +659 -659
  195. package/md_cg/test_write_return_shape.py +919 -919
  196. package/md_cg/test_writepipe.py +228 -228
  197. package/md_cg/trust.py +1114 -1114
  198. package/md_cg/twophase.py +303 -303
  199. package/md_cg/whitebox.py +536 -536
  200. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  201. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  202. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  203. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  204. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  205. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  206. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  207. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  208. package/md_cg/writepipe.py +1337 -1337
  209. package/package.json +3 -2
  210. package/scripts/workspace_index.py +328 -0
  211. package/src/hooks.ts +30 -6
  212. package/src/index.ts +14 -5
  213. package/src/lib/hook_audit.ts +282 -256
  214. package/src/lib/mdcg_client.ts +469 -469
  215. package/src/lib/prompt_safety.ts +17 -3
  216. package/src/tools.ts +23 -1
@@ -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())