@furongjun1999/dsh-memory 0.8.1 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -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 +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/md_cg/refine.py CHANGED
@@ -39,7 +39,10 @@ from .mdcos import MdCGOS
39
39
  REFINE_LOG = "_refine.jsonl"
40
40
 
41
41
  #: 抽检对象 id 前缀(P37 派生记忆)
42
- PREFIX_DEFAULT = "node_"
42
+ # issue #559:默认**不过滤**(空前缀 = 全库抽样)。
43
+ # 此前是 "node_",而本仓默认铸出的 id 是 mem_* ⇒ 默认参数下抽样池恒为 0 且不报错(静默空池);
44
+ # 不把默认绑死在任何一代前缀上,对混有 node_/mem_ 两代 id 的历史库同样安全。
45
+ PREFIX_DEFAULT = ""
43
46
  #: 裁定单条件 A 规定的抽检条数
44
47
  SAMPLE_N = 20
45
48
  #: 抽样种子:同 seed ⇒ 同样本(可复算、可复核)
@@ -156,12 +159,18 @@ def sample_ids(cg, n=None, seed=None, prefix=None) -> tuple:
156
159
  """
157
160
  n = SAMPLE_N if n is None else int(n)
158
161
  seed = seed or SAMPLE_SEED
162
+ explicit = bool(prefix)
159
163
  prefix = prefix or PREFIX_DEFAULT
160
164
  pool, protected = _pool(cg, prefix)
165
+ fallback = False
166
+ if not pool and not explicit:
167
+ # 调用方没显式给前缀、而默认前缀又抽不到东西:wgid 全量回落并显式标注(#559:不静默给空池)
168
+ pool, protected = _pool(cg, "")
169
+ fallback = True
161
170
  fam = {}
162
171
  for nid in pool:
163
172
  fam.setdefault(_family(cg, nid), []).append(nid)
164
- meta = {"prefix": prefix, "seed": seed, "requested": int(n),
173
+ meta = {"prefix": prefix, "seed": seed, "requested": int(n), "prefix_fallback": fallback,
165
174
  "pool": len(pool), "skipped_protected": protected,
166
175
  "families": len(fam), "sampled": 0, "strata": {}}
167
176
  if not pool or n <= 0:
@@ -557,7 +566,7 @@ def _main(argv=None) -> int:
557
566
  ap.add_argument("root", help="认知图库根")
558
567
  ap.add_argument("--n", type=int, default=SAMPLE_N, help="抽检条数(默认 20)")
559
568
  ap.add_argument("--seed", default=SAMPLE_SEED, help="抽样种子(同 seed 同样本)")
560
- ap.add_argument("--prefix", default=PREFIX_DEFAULT, help="id 前缀(默认 node_)")
569
+ ap.add_argument("--prefix", default=PREFIX_DEFAULT, help="id 前缀(默认空 = 不过滤,全库抽样;给出则只抽以该前缀开头的 id)")
561
570
  ap.add_argument("--min-jaccard", type=float, default=None)
562
571
  ap.add_argument("--min-cluster", type=int, default=None)
563
572
  ap.add_argument("--preview", action="store_true", help="只出预演(不出工单正文)")
@@ -0,0 +1,128 @@
1
+ # -*- coding: utf-8 -*-
2
+ """取(retrieve)—— 四动作之一,返回**定型信封**(Envelope)。
3
+
4
+ 为什么要这层(外部 issue #5 第 15 条):
5
+ 既有检索面 cg.search 返回 (results, meta),是内部检索包的形状;「可复跑」要求
6
+ 接口形状本身可判,故另立定型入口,把检索包规范化成 Envelope。
7
+
8
+ **不改既有 search 路径**:search 被几十处调用,改它的返回形状是破坏性变更。
9
+ 本模块只做适配,新调用方用新入口,老调用方一字不动。
10
+
11
+ Envelope 字段(schema 见 interface_schema.ENVELOPE):
12
+
13
+ items[] 条目:node_id / content / condition_space / qualification /
14
+ lifecycle_state / content_kind
15
+ completeness bool 本次检索是否覆盖了候选全集(false 时不得进入零命中路径)
16
+ hit_count int 命中数;**非 success 时恒 null**(I1)
17
+ snapshot_id str 索引快照标识(跨快照比较必须显式声明)
18
+ operation_status success | partial | timeout | unavailable | operation_error
19
+
20
+ 两条必须守的纪律:
21
+ * **I1**:非 success 时 hit_count 必须为 null——不能让人把「故障」读成「没有」。
22
+ * **条件空间如实**:索引条目不含 condition_space(见 condgate.qualify 的说明),
23
+ 故本模块对**每条命中**回查一次 frontmatter(k 条,代价可接受),
24
+ 以给出准确的 qualification,而不是拿索引的空字段糊弄。
25
+ 这也是 gap_cs_not_indexed 在「取」这一层的局部解法——全量索引改造另议。
26
+ """
27
+
28
+ import time
29
+
30
+ from . import condgate, lifecycle
31
+
32
+ __all__ = ["retrieve", "ENVELOPE_FIELDS"]
33
+
34
+ ENVELOPE_FIELDS = ("items", "completeness", "hit_count", "snapshot_id",
35
+ "operation_status")
36
+
37
+
38
+ def _snapshot_id(cg):
39
+ """索引快照标识 = 节点数 + 索引文件 mtime。
40
+
41
+ 首版读 cg._index_mtime(该属性不存在)→ 恒得 0,于是所有快照都叫 snap-N-0,
42
+ **跨快照比较失去意义**(而 snapshot_id 的全部用途就是显式声明版本差异)。
43
+ 改为直接取索引文件 mtime;取不到(如内存库)则回落 0 并如实反映。
44
+ """
45
+ import os as _os
46
+ idx = getattr(cg, "index", None) or {}
47
+ n = len((idx.get("nodes") or {}))
48
+ path = getattr(cg, "index_path", None)
49
+ mtime = 0
50
+ if path:
51
+ try:
52
+ mtime = int(_os.path.getmtime(str(path)))
53
+ except OSError:
54
+ mtime = 0
55
+ return "snap-%d-%d" % (n, mtime)
56
+
57
+
58
+ def retrieve(cg, query, k=10, layer=None, session=None,
59
+ condition_space=None, snapshot_id=None):
60
+ """检索并返回定型 Envelope。失败也返回 Envelope(带 operation_status),不抛。"""
61
+ q = (query or "").strip()
62
+ if not q:
63
+ return {"items": [], "completeness": True, "hit_count": 0,
64
+ "snapshot_id": snapshot_id or _snapshot_id(cg),
65
+ "operation_status": "success", "reason": "empty_query"}
66
+
67
+ try:
68
+ res = cg.search(q, k=k, layer=layer, session=session)
69
+ hits, meta = res if isinstance(res, tuple) and len(res) == 2 else (res, {})
70
+ except Exception as exc: # noqa: BLE001 —— 失败要如实成形态
71
+ return {"items": [], "completeness": False, "hit_count": None,
72
+ "snapshot_id": snapshot_id or _snapshot_id(cg),
73
+ "operation_status": "operation_error",
74
+ "error": "%s: %s" % (type(exc).__name__, exc)}
75
+
76
+ items = []
77
+ for h in (hits or []):
78
+ node = h[0] if isinstance(h, (list, tuple)) and h else h
79
+ if not isinstance(node, dict):
80
+ continue
81
+ nid = node.get("id")
82
+ # 回查 frontmatter:索引里没有 condition_space,只能从节点本体取
83
+ fm = {}
84
+ try:
85
+ got = cg.get(nid) if nid else None
86
+ fm = (got or {}).get("frontmatter") or {}
87
+ except Exception: # noqa: BLE001
88
+ fm = {}
89
+ full = node.get("content") or ""
90
+ items.append({
91
+ "node_id": nid,
92
+ "content": full[:400],
93
+ # I17 / I16(2026-10-18):投影不得自称权威——截断必须显式声明。
94
+ # 不声明的话,读者会把 400 字当成原文全文,这正是「投影冒充原文」。
95
+ "content_truncated": len(full) > 400,
96
+ "content_full_len": len(full),
97
+ "condition_space": fm.get("condition_space"),
98
+ "qualification": condgate.qualify(fm),
99
+ "lifecycle_state": lifecycle.state_of(fm),
100
+ "content_kind": node.get("content_kind") or fm.get("content_kind"),
101
+ })
102
+
103
+ scanned = meta.get("scanned")
104
+ completeness = bool(meta.get("completeness", True)) if isinstance(meta, dict) else True
105
+ status = "success"
106
+ if isinstance(meta, dict) and meta.get("tier") is None and not items:
107
+ status = "success" # 真空结果仍是 success
108
+ elif isinstance(meta, dict) and meta.get("partial"):
109
+ status = "partial"
110
+ completeness = False
111
+
112
+ # I2(2026-10-18):completeness=False 时**不得断言「没有」**。
113
+ # 零命中 + 不完整,若报 hit_count=0,调用方会读成「查了,确实没有」——
114
+ # 而实际是「没查全」。故此时 hit_count 必须为 null(与 I1 同一精神:
115
+ # 不确定的结论不能伪装成确定)。有命中时仍给数量,由 completeness 标注覆盖面。
116
+ hit_count = len(items)
117
+ if not completeness and hit_count == 0:
118
+ hit_count = None
119
+
120
+ return {
121
+ "items": items,
122
+ "completeness": completeness,
123
+ "hit_count": hit_count, # 仅 success/partial 且完整时有意义
124
+ "snapshot_id": snapshot_id or _snapshot_id(cg),
125
+ "operation_status": status,
126
+ "scanned": scanned,
127
+ "tier": (meta or {}).get("tier") if isinstance(meta, dict) else None,
128
+ }
@@ -35,11 +35,12 @@ C 覆写落盘、D 软删),reject = 原样留痕不执行;edit/merge/noop
35
35
 
36
36
  裁决留痕:decisions.jsonl + 审计 md 节点(由 review_decide 内部完成)。
37
37
 
38
- 落盘归因(P1 修复,2026-09-26,DSH 端在役实测回告):
39
- · 会话:--session(各子命令通用)缺省取环境变量 MDCG_SESSION,仍无则维持
40
- 现状随机会话并 stderr 告警一行。同一批裁决传同一 session,落盘节点的
41
- frontmatter.session 才稳定一致(此前每次随机 sess_<uuid12>,同批 5 节点
42
- 5 个会话 id)。
38
+ 落盘归因(P1 修复,2026-09-26,DSH 端在役实测回告;2026-10-07 三态收口):
39
+ · 会话:--session(各子命令通用)缺省取环境变量 MDCG_SESSION,仍无则落
40
+ **'unattributed'**(写归因三态第三态,MdCGSecure._attributed_session 单点;
41
+ 不再使用随机会话 id)并 stderr 告警一行。同一批裁决传同一 session,落盘
42
+ 节点的 frontmatter.session 才稳定一致(原实录为每次随机 sess_<uuid12>,
43
+ 同批 5 节点 5 个会话 id——三态收口后消除)。
43
44
  · 写入者:accept/edit 落盘节点的 frontmatter.writer 保留**提案原始写入者**
44
45
  (propose 时库端快照的 actor,如 dsh-memory);裁决者身份不丢失,记入
45
46
  frontmatter.reviewer(designer-cli)。
@@ -51,6 +52,7 @@ C 覆写落盘、D 软删),reject = 原样留痕不执行;edit/merge/noop
51
52
  否则两侧归因对不上。
52
53
  """
53
54
  import argparse
55
+ import time
54
56
  import json
55
57
  import os
56
58
  import sys
@@ -65,6 +67,9 @@ if _HERE not in sys.path:
65
67
  sys.path.insert(0, _HERE)
66
68
 
67
69
  from md_cg.mdcos import MdCGSecure # noqa: E402
70
+ # #69 契约面(本批唯一动作):正文/摘要的取数**单点**——本 CLI 不再自写一份截断逻辑,
71
+ # 将来契约若从甲改乙/丙,只改 mdcos 里那两个函数,CLI 自动跟随。
72
+ from md_cg.mdcos import pending_digest # noqa: E402
68
73
  from md_cg.security import Principal # noqa: E402
69
74
 
70
75
 
@@ -81,22 +86,24 @@ def _root(args):
81
86
 
82
87
  # 生效条件:args 的 session 属性为真值(含 getattr 缺省 None 回落)或环境变量 MDCG_SESSION 去空白后非空时返回该值(前者优先),两者皆无返回 None。
83
88
  def _session_of(args):
84
- """裁决会话归属:--session > 环境变量 MDCG_SESSION > None(随机 + 告警)。"""
89
+ """裁决会话归属:--session > 环境变量 MDCG_SESSION > None(落 unattributed + 告警)。"""
85
90
  s = str(getattr(args, "session", None)
86
91
  or os.environ.get("MDCG_SESSION", "") or "").strip()
87
92
  return s or None
88
93
 
89
94
 
90
- # 生效条件:args 就绪时先经 _session_of 取裁决会话归属,取到 None 时向 stderr 告警一行(缺省随机会话、同批裁决请传同一 --session)后维持现状;随后构造写死权限的 Principal(actor="designer-cli", clearance="secret", can_write=True, can_admin=True, role="designer", auth_mode="local-cli", session=<上述归属>),再以 _root(args) 取到的存储根返回 MdCGSecure(root, principal=p, autoflush=1)。
95
+ # 生效条件:args 就绪时先经 _session_of 取裁决会话归属,取到 None 时向 stderr 告警一行(缺省归属 unattributed、同批裁决请传同一 --session)后维持现状;随后构造写死权限的 Principal(actor="designer-cli", clearance="secret", can_write=True, can_admin=True, role="designer", auth_mode="local-cli", session=<上述归属>),再以 _root(args) 取到的存储根返回 MdCGSecure(root, principal=p, autoflush=1)。
91
96
  def _cg(args):
92
97
  session = _session_of(args)
93
98
  if session is None:
94
- # P1 归因(2026-09-26,DSH 端在役实测):缺省随机会话会让同一批裁决
95
- # 得到互不相同的落盘归属(5 节点 5 个 sess_* 实录)。不拒绝、告警一行
96
- # 后维持现状(向后兼容);要稳定归属请显式传同一 --session。
99
+ # P1 归因(2026-09-26 取证;2026-10-07 设计者「会话身份三态」裁定收口):
100
+ # 缺省不再落进程随机 sess_* ——写入归属经 MdCGSecure._attributed_session
101
+ # 三态解析落 'unattributed'(显式、可辨认;原实录「5 节点 5 个随机
102
+ # sess_*」由此消除)。同一批裁决要稳定归属仍请显式传同一 --session。
103
+ # 告警保留一行:缺省归属表达的是「无声明」,不是真实会话。
97
104
  sys.stderr.write("警告:未指定 --session / 环境变量 MDCG_SESSION,"
98
- "本次裁决落盘使用随机会话 id——同一批裁决请传同一 "
99
- "--session 以稳定归属。\n")
105
+ "本次裁决落盘会话归属为 unattributed(不再使用随机会话 id)"
106
+ "——同一批裁决请传同一 --session 以稳定归属。\n")
100
107
  p = Principal(actor="designer-cli", clearance="secret",
101
108
  can_write=True, can_admin=True, role="designer",
102
109
  auth_mode="local-cli", session=session)
@@ -115,8 +122,9 @@ def _cg(args):
115
122
 
116
123
  # 生效条件:rec 支持 .get 时,取 rec.get("content") 为假值则取 rec.get("statement")、再为假值则取空串,把其中的换行替换为空格,并按 width(缺省 66)切片后仅当 len(text) > width 才追加 "…",返回该字符串。
117
124
  def _brief(rec, width=66):
118
- text = (rec.get("content") or rec.get("statement") or "").replace("\n", " ")
119
- return text[:width] + ("…" if len(text) > width else "")
125
+ # #69 单点委派(2026-10-16):取正文/statement、换行压平、截断加省略号——实现只在
126
+ # `mdcos.pending_digest` 一处;本函数保留为既有调用方的兼容入口(输出逐位不变)。
127
+ return pending_digest(rec, width)
120
128
 
121
129
 
122
130
  # 生效条件:rec 支持 .get 且其 kind 为 "mutation" 时返回「变更单(动作名→目标)」标签,其余(含缺键 = 存量提案)返回「提案」;本函数只读,不产生任何副作用;
@@ -140,24 +148,153 @@ def _kind_label(rec):
140
148
  return "变更单(%s%s)" % (name, ("→ " + str(tgt)) if tgt else "")
141
149
 
142
150
 
151
+ # ---- issue #71(2026-10-09 DSH 端):待审队列的**单向索引**与**分级** ----
152
+ # 索引由 cg.review_list() **单向派生**(inbox -> 索引),可随时重建;
153
+ # **只放摘要(首行截 80 字)与元数据,不放正文**——正文留在 inbox(#69 甲:内部可追溯)。
154
+ INDEX_REL = ("hippocampus", "inbox.index.json")
155
+ SUMMARY_MAX = 80
156
+
157
+
158
+ def _index_path(root):
159
+ return os.path.join(root, *INDEX_REL)
160
+
161
+
162
+ def _build_index(cg):
163
+ """从 review_list() 派生索引条目(单向、可重建、不含正文)。"""
164
+ items = []
165
+ for r in (cg.review_list() or []):
166
+ items.append({
167
+ "pid": r.get("pid"),
168
+ "kind": _kind_label(r),
169
+ "verdict": r.get("status"),
170
+ "layer": r.get("layer"),
171
+ "tags": list(r.get("tags") or []),
172
+ "round": r.get("round") or 0,
173
+ "created_at": (r.get("created_at")
174
+ or r.get("t") or None),
175
+ "summary": (_brief(r, SUMMARY_MAX) or ""),
176
+ })
177
+ return items
178
+
179
+
180
+ def _age_days(item, now=None):
181
+ """积压龄(天);无时间戳返回 None。"""
182
+ ts = item.get("created_at")
183
+ if ts is None:
184
+ return None
185
+ try:
186
+ return max(0.0, ((now or time.time()) - float(ts)) / 86400.0)
187
+ except (TypeError, ValueError):
188
+ return None
189
+
190
+
191
+ def _filter_sort(items, args):
192
+ """按 list 的分级参数过滤与排序(默认 age:最久未裁决优先)。"""
193
+ out_ = list(items)
194
+ q = (getattr(args, "query", None) or "").strip().lower()
195
+ if q:
196
+ out_ = [x for x in out_ if q in json.dumps(x, ensure_ascii=False).lower()]
197
+ tag = (getattr(args, "tag", None) or "").strip()
198
+ if tag:
199
+ out_ = [x for x in out_ if tag in (x.get("tags") or [])]
200
+ kind = (getattr(args, "kind", None) or "").strip()
201
+ if kind:
202
+ out_ = [x for x in out_ if str(x.get("kind") or "").startswith(kind)]
203
+ older = getattr(args, "older_than", None)
204
+ if older is not None:
205
+ out_ = [x for x in out_ if (_age_days(x) or 0.0) >= float(older)]
206
+ sort = (getattr(args, "sort", None) or "age")
207
+ if sort == "kind":
208
+ out_.sort(key=lambda x: (str(x.get("kind") or ""), str(x.get("pid") or "")))
209
+ else:
210
+ out_.sort(key=lambda x: -( _age_days(x) or 0.0))
211
+ return out_
212
+
213
+
214
+ # issue #71(2026-10-09 DSH 端):批量处置的**安全红线**——只接受**显式 pid**,
215
+ # 且形态严格(prop_ + 十六进制)。**禁止通配/正则/tag 直批**:那等于把质量闸
216
+ # 改成「自动通过」,与 policy 的必需六要素精神冲突。
217
+ _PID_RE = __import__("re").compile(r"^prop_[0-9a-f]{6,}$")
218
+
219
+
220
+ def _load_pids(path):
221
+ """读取「一行一个显式 pid」的批量清单;含非法形态即整体拒绝(返回 None)。"""
222
+ try:
223
+ raw = open(path, encoding="utf-8", errors="replace").read()
224
+ except OSError as exc:
225
+ sys.stderr.write("无法读取 --pids-file:%s" % exc + chr(10))
226
+ return None
227
+ ids, bad = [], []
228
+ for line in raw.splitlines():
229
+ tok = line.strip()
230
+ if not tok or tok.startswith("#"):
231
+ continue
232
+ if not _PID_RE.match(tok):
233
+ bad.append(tok)
234
+ else:
235
+ ids.append(tok)
236
+ if bad:
237
+ sys.stderr.write(
238
+ "拒绝执行:--pids-file 含非显式 pid 形态(禁通配/正则/tag):%r"
239
+ "。请只写一行一个的显式 pid(形如 prop_1a2b3c4d)。" % bad[:5])
240
+ return None
241
+ if not ids:
242
+ sys.stderr.write("--pids-file 里没有任何显式 pid。" + chr(10))
243
+ return None
244
+ return ids
245
+
246
+
143
247
  # 生效条件:cg 与 args 就绪时按 args.cmd 分派——"list" 时 cg.review_list() 为空则打印空队列并返回 0、非空则逐条打印(tags 取真值拼接、layer/round 为假值显示 "?"/0)后返回 0;"rounds" 时打印 cg.review_rounds(args.pid) 并返回 0;"stats" 时打印 cg.review_stats() 的记录数/提案数/待审数/已关闭数与动作分布(含 noop 计数)并返回 0;"edit" 时以 args.content 加真值 args.tags(按逗号分割并剔除空项)/args.layer 组成 edits 调 cg.review_decide;其余 cmd(含 noop)以 getattr(args, "into", None) 与 args.reason 调 cg.review_decide;后两类再按 out.get("ok") 为真返回 0,否则打印 out 并返回 1。
144
248
  def _execute(cg, args):
145
249
  """按子命令执行裁决(cg 的生命周期由 main 统一收尾)。"""
146
250
  if args.cmd == "list":
147
- pend = cg.review_list()
148
- if not pend:
149
- print("审核队列为空(0 条待审)。")
251
+ items = _build_index(cg)
252
+ # 索引落盘(单向派生自 inbox;每次 list 都刷新,保证与队列一致)
253
+ idx_written = None
254
+ try:
255
+ ip = _index_path(_root(args))
256
+ os.makedirs(os.path.dirname(ip), exist_ok=True)
257
+ with open(ip, "w", encoding="utf-8") as f:
258
+ json.dump({"generated_at": time.time(),
259
+ "count": len(items),
260
+ "items": items}, f, ensure_ascii=False, indent=1)
261
+ idx_written = ip
262
+ except OSError:
263
+ idx_written = None
264
+ rows = _filter_sort(items, args)
265
+ if getattr(args, "rebuild_index", False) and idx_written:
266
+ print("索引已重建:%s(%d 条)" % (idx_written, len(items)))
267
+ if not rows:
268
+ print("没有符合条件的待审条目(队列共 %d 条)。" % len(items))
150
269
  return 0
151
- print("待审 %d 条:" % len(pend))
152
- for r in pend:
270
+ gb = (getattr(args, "group_by", None) or "").strip()
271
+ print("待审 %d 条:" % len(rows))
272
+ last_group = None
273
+ for r in rows:
274
+ if gb:
275
+ g = str(r.get(gb) or "?")
276
+ if g != last_group:
277
+ print(" == %s ==" % g)
278
+ last_group = g
153
279
  tags = (", tags=" + ",".join(r.get("tags") or [])) if r.get("tags") else ""
154
- print(" [%s] %s · %s · %s 层%s · round=%s\n %s" % (
155
- r.get("pid"), r.get("status"), _kind_label(r),
280
+ age = _age_days(r)
281
+ age_s = ("%.1f 天" % age) if age is not None else "?"
282
+ print(" [%s] %s · %s · %s 层%s · round=%s · 积压 %s\n %s" % (
283
+ r.get("pid"), r.get("verdict"), r.get("kind"),
156
284
  r.get("layer") or "?",
157
- tags, r.get("round") or 0, _brief(r)))
285
+ tags, r.get("round") or 0, age_s,
286
+ str(r.get("summary") or "")))
158
287
  print('\n裁决示例:python -m md_cg.review_cli accept <pid> --reason "实跑测试证据"')
159
288
  return 0
160
289
 
290
+ if args.cmd in ("accept", "reject", "noop"):
291
+ pf = getattr(args, "pids_file", None)
292
+ if pf:
293
+ return _batch_decide(cg, args, pf)
294
+ if not getattr(args, "pid", None):
295
+ sys.stderr.write("需要 <pid> 或 --pids-file(两者给其一)。" + chr(10))
296
+ return 1
297
+
161
298
  if args.cmd == "rounds":
162
299
  print(json.dumps(cg.review_rounds(args.pid), ensure_ascii=False, indent=1))
163
300
  return 0
@@ -194,6 +331,31 @@ def _execute(cg, args):
194
331
  return 1
195
332
 
196
333
 
334
+ def _batch_decide(cg, args, pids_file):
335
+ """批量裁决(issue #71):**先预览、再执行**两段式。"""
336
+ ids = _load_pids(pids_file)
337
+ if ids is None:
338
+ return 1
339
+ if not getattr(args, "apply", False):
340
+ print("DRY-RUN:将处置 %d 条(未落盘)。确认后加 --apply。" % len(ids))
341
+ pend = {r.get("pid"): r for r in (cg.review_list() or [])}
342
+ for pid in ids:
343
+ r = pend.get(pid)
344
+ note = "(不在待审队列)" if r is None else _brief(r)
345
+ print(" [%s] %s" % (pid, note))
346
+ return 0
347
+ rc, done = 0, 0
348
+ for pid in ids:
349
+ out = cg.review_decide(pid, args.cmd, reason=args.reason)
350
+ if out.get("ok"):
351
+ done += 1
352
+ else:
353
+ rc = 1
354
+ print(" %s 未生效:%s" % (pid, json.dumps(out, ensure_ascii=False)))
355
+ print("批量裁决完成:%d/%d 条生效。" % (done, len(ids)))
356
+ return rc
357
+
358
+
197
359
  # 生效条件:argv 为 None(默认)时由 argparse 解析 sys.argv、否则解析传入的 argv(子命令 dest="cmd" 为 required,已注册 list/accept/reject/edit/merge/rounds 并带 --root 等参数),解析成功后构造 cg=_cg(args) 并返回 _execute(cg, args),finally 中执行 cg.close()。
198
360
  def main(argv=None):
199
361
  ap = argparse.ArgumentParser(
@@ -203,17 +365,33 @@ def main(argv=None):
203
365
  common.add_argument("--root", help="存储根目录(默认环境变量 MDCG_ROOT)")
204
366
  common.add_argument("--session", default=None,
205
367
  help="裁决会话 id(落盘归属 frontmatter.session;缺省取"
206
- "环境变量 MDCG_SESSION,仍无则随机会话并 stderr 告警。"
207
- "同一批裁决传同一值即得同一归属)")
368
+ "环境变量 MDCG_SESSION,仍无则落 'unattributed' 并 "
369
+ "stderr 告警。同一批裁决传同一值即得同一归属)")
208
370
  sub = ap.add_subparsers(dest="cmd", required=True)
209
371
 
210
- sub.add_parser("list", help="列出待审条目", parents=[common])
372
+ sl = sub.add_parser("list", help="列出待审条目(含分级)", parents=[common])
373
+ sl.add_argument("--query", default=None, help="按关键词过滤(匹配索引条目字段)")
374
+ sl.add_argument("--tag", default=None, help="按 tag 过滤")
375
+ sl.add_argument("--kind", default=None, help="按类型前缀过滤(提案/变更单)")
376
+ sl.add_argument("--older-than", dest="older_than", type=float, default=None,
377
+ help="只列积压龄 >= N 天的条目")
378
+ sl.add_argument("--group-by", dest="group_by", default=None,
379
+ help="分组显示(kind/verdict)")
380
+ sl.add_argument("--sort", default="age",
381
+ help="排序:age(默认,最久未裁决优先)/kind")
382
+ sl.add_argument("--rebuild-index", dest="rebuild_index", action="store_true",
383
+ help="重建索引文件(单向派生自 inbox)")
211
384
  sub.add_parser("stats", help="裁决动作统计(含 noop)", parents=[common])
212
385
  for name, help_ in (("accept", "按原样写入落盘"),
213
386
  ("reject", "丢弃(只记裁决)"),
214
387
  ("noop", "已评估、判定不改变现有记忆(只留痕)")):
215
388
  s = sub.add_parser(name, help=help_, parents=[common])
216
- s.add_argument("pid")
389
+ # issue #71:pid 由必填改可选(批量为 --pids-file),两者须给其一。
390
+ s.add_argument("pid", nargs="?", default=None)
391
+ s.add_argument("--pids-file", default=None,
392
+ help="批量:一行一个显式 pid(禁通配/正则/tag)")
393
+ s.add_argument("--apply", action="store_true",
394
+ help="批量:确认执行(缺省为 dry-run 只预览)")
217
395
  s.add_argument("--reason", default="", help="裁决理由(进留痕)")
218
396
  s = sub.add_parser("edit", help="修订后写入", parents=[common])
219
397
  s.add_argument("pid")
@@ -0,0 +1,140 @@
1
+ # -*- coding: utf-8 -*-
2
+ """修订与回滚(revise / rollback)——四动作里此前完全缺失的那一条。
3
+
4
+ 背景(外部 issue #5 第 8/11 条,2026-10-18):
5
+ revise 在文档里早有签名,但**代码全仓 0 命中**;superseded 档已随方案 A 落地,
6
+ 本模块把「产生新版本、旧版转 superseded、可回滚」这三件事接起来。
7
+
8
+ 三条设计纪律:
9
+
10
+ 1. **先写新、再改旧**。新版本必须真正落盘成功,才允许把旧版本标为 superseded;
11
+ 否则会出现「旧版被取代、新版不存在」的悬空状态。任何一步失败都不动旧节点。
12
+ 2. **CAS 防并发覆盖**。调用方可传 expect_state;与当前状态不符即 DEFER 让调用方
13
+ 重读,而不是覆盖别人的修改(issue #5 第 11 条:state_from 天然可作 CAS 前置)。
14
+ 3. **回滚不删任何东西**。rollback 只做状态互换:旧版 superseded→active,
15
+ 新版 active→superseded。不归档、不删除——因为 active→archived 是跳级(被
16
+ TRANSITIONS 拒绝),而「互换取代关系」既可逆又符合状态机。
17
+ """
18
+
19
+ import time
20
+
21
+ from . import lifecycle
22
+
23
+ __all__ = ["revise", "rollback"]
24
+
25
+ #: 回滚令牌的最小形状(写进返回体,可持久化)
26
+ TOKEN_KEYS = ("old_id", "old_state", "new_id", "new_state", "ts")
27
+
28
+
29
+ def _state_of_node(cg, node_id):
30
+ """取节点当前生命周期状态。
31
+
32
+ 实测(2026-10-18):cg.get() 返回 {id, content, frontmatter, path},
33
+ lifecycle_state 在 frontmatter 里,**不在顶层**。首版把整个 dict 当 fm,
34
+ state_of 读不到键就 fail-open 成 active——于是 set_state 明明成功、
35
+ 读回却是 active,conformance 直接红。
36
+
37
+ 这是同一类错误的第二次(前一次是 cg.search 返回 (res, meta) 而非 res):
38
+ **不要假设接口返回结构,先实测。**
39
+ """
40
+ node = cg.get(node_id)
41
+ if node is None:
42
+ return None
43
+ if isinstance(node, dict):
44
+ fm = node.get("frontmatter") or node
45
+ elif isinstance(node, (list, tuple)) and node:
46
+ fm = node[0]
47
+ else:
48
+ fm = node
49
+ return lifecycle.state_of(fm)
50
+
51
+
52
+ def _write_new(cg, content, layer, tags, condition_space):
53
+ """走正常写入链(含形式完备闸),返回 disp 结构。"""
54
+ from .mcp_server import _cg_dispatch
55
+ a = {"op": "write", "content": content, "content_kind": "work_done",
56
+ "layer": layer or "knowledge", "tags": tags or ["revise"]}
57
+ if condition_space:
58
+ a["condition_space"] = condition_space
59
+ r = _cg_dispatch(cg, a)
60
+ return r if isinstance(r, dict) else {}
61
+
62
+
63
+ def revise(cg, old_id, new_content, expect_state=None, reason="修订",
64
+ layer=None, tags=None, condition_space=None):
65
+ """产生新版本并把旧版本标为 superseded。
66
+
67
+ 返回:
68
+ {"verdict": "ACCEPT"|"REJECT"|"DEFER", "state_from", "state_to",
69
+ "new_id", "rollback_token", "reason"}
70
+ """
71
+ old_state = _state_of_node(cg, old_id)
72
+ if old_state is None:
73
+ return {"verdict": "REJECT", "reason": "旧节点不存在:%s" % old_id,
74
+ "state_from": None, "state_to": None, "new_id": None,
75
+ "rollback_token": None}
76
+
77
+ # CAS:并发前置条件
78
+ if expect_state is not None and str(expect_state) != old_state:
79
+ return {"verdict": "DEFER", "state_from": old_state, "state_to": old_state,
80
+ "new_id": None, "rollback_token": None,
81
+ "reason": "CAS 不符:期望 %s,实际 %s(请重读后再修订)"
82
+ % (expect_state, old_state)}
83
+
84
+ if old_state in ("archived", "superseded"):
85
+ return {"verdict": "REJECT", "state_from": old_state, "state_to": old_state,
86
+ "new_id": None, "rollback_token": None,
87
+ "reason": "已退役版本不可再被修订(%s)" % old_state}
88
+
89
+ # ① 先写新版——失败则完全不动旧节点
90
+ disp = _write_new(cg, new_content, layer, tags, condition_space)
91
+ verdict = (disp.get("verdict") or {}).get("state")
92
+ if not disp.get("committed") or verdict != "ACCEPT":
93
+ return {"verdict": verdict or "REJECT", "state_from": old_state,
94
+ "state_to": old_state, "new_id": None, "rollback_token": None,
95
+ "reason": "新版未落盘,旧版保持不动",
96
+ "new_verdict": disp.get("verdict")}
97
+
98
+ new_id = disp.get("id")
99
+
100
+ # ② 再改旧版——此时新版已确认存在
101
+ lifecycle.set_state(cg, old_id, "superseded",
102
+ reason="%s(被 %s 取代)" % (reason, new_id))
103
+ new_state = _state_of_node(cg, old_id)
104
+
105
+ token = {"old_id": old_id, "old_state": old_state, "new_id": new_id,
106
+ "new_state": "active", "ts": time.time()}
107
+ return {"verdict": "ACCEPT", "state_from": old_state, "state_to": new_state,
108
+ "new_id": new_id, "rollback_token": token, "reason": reason}
109
+
110
+
111
+ def rollback(cg, token, reason="回滚"):
112
+ """撤销一次修订:旧版复活、新版转为被取代。**不删除任何节点。**
113
+
114
+ 不用「新版→archived」的理由:active→archived 是跳级(TRANSITIONS 拒绝);
115
+ 互换取代关系既可逆,又正确表达了「回滚后谁是当前版本」。
116
+ """
117
+ if not isinstance(token, dict) or not token.get("old_id") or not token.get("new_id"):
118
+ return {"verdict": "REJECT", "reason": "回滚令牌不完整"}
119
+
120
+ old_id, new_id = token["old_id"], token["new_id"]
121
+ st_old = _state_of_node(cg, old_id)
122
+ st_new = _state_of_node(cg, new_id)
123
+ if st_old is None or st_new is None:
124
+ return {"verdict": "REJECT", "reason": "令牌指向的节点不存在",
125
+ "state_old": st_old, "state_new": st_new}
126
+
127
+ if st_old != "superseded":
128
+ return {"verdict": "DEFER", "reason": "旧版当前不在 superseded(%s),拒绝回滚" % st_old,
129
+ "state_old": st_old, "state_new": st_new}
130
+
131
+ # 互换:旧版复活、新版被取代
132
+ lifecycle.set_state(cg, old_id, "active", reason="%s:恢复旧版" % reason)
133
+ if st_new == "active":
134
+ lifecycle.set_state(cg, new_id, "superseded",
135
+ reason="%s:新版转为被取代" % reason)
136
+
137
+ return {"verdict": "ACCEPT",
138
+ "state_old_after": _state_of_node(cg, old_id),
139
+ "state_new_after": _state_of_node(cg, new_id),
140
+ "reason": reason}