@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/branches.py CHANGED
@@ -1,328 +1,405 @@
1
- # -*- coding: utf-8 -*-
2
- """记忆演化分支(Pi 机制移植④,交接文档 §3④「记忆演化 fork」,P0)。
3
-
4
- pi:会话 = entry 树,任意历史节点可 fork;被放弃旁支由 branch_summary
5
- 归档定长摘要。灵枢映射(单一演化线 → 假设分支实验场):
6
-
7
- - fork:把主支节点复制成分支实验副本(fm.branch_id / branched_from),
8
- 副本 derived_from=[主支]、relation="split_from"——血缘单向可回溯;
9
- - 分支节点默认从主支检索隐身(_candidates 按 branch 过滤,一处生效
10
- 全链路穿透)——实验不污染主支(验收:召回主支时分支节点零命中);
11
- - merge:按 branched_from 溯源回写主支(derived_from=[分支 nid] 追加进
12
- 主支原链、relation="merged_from"),override 走快照——合并后链完整;
13
- - discard:校验 BRANCH_MARKS 必填 → 写教训节点(knowledge 层、可检索)
14
- → 分支文件移入冷区 _branches/<id>/(物理保留、索引摘除、永不删除)。
15
-
16
- 与 writepipe 同哲学:库层函数收 cg,权限闸保持库层强制——
17
- fork/merge 走 add 的 require_layer_write 自动覆盖;
18
- discard 改变库可见性,需 can_admin(principal.require_admin)。
19
- 生命周期事件走 _audit.jsonl(③ 两段式载体,零新日志格式)。
20
- """
21
-
22
- import os
23
- import re
24
- import uuid
25
-
26
- from .fsutil import publish
27
-
28
- #: discard 的 branch_summary 必填标记(复用 NEG_MEMORY_MARKS 的必填防呆模式:
29
- #: 「假设 + 结果 + 教训」缺一不收——放弃分支必须留下可复用的教训)。
30
- BRANCH_MARKS = ("分支假设", "实验结果", "教训")
31
-
32
- #: 分支文件冷区(LAYERS 之外,_scan_nodes 不扫——天然不进索引与检索)。
33
- COLD_DIR = "_branches"
34
-
35
- _BRANCH_RE = re.compile(r"^[a-z0-9][a-z0-9_-]{0,63}$")
36
-
37
-
38
- # 生效条件:调用 branch_tag(branch_id) 时,返回 "branch:" 拼接 str(branch_id or "").strip().lower()(branch_id 为假值时以空串参与拼接)。
39
- def branch_tag(branch_id: str) -> str:
40
- """分支节点的标注 tag(fork 时写入;branch_summary 也带它以便反查)。"""
41
- return "branch:" + str(branch_id or "").strip().lower()
42
-
43
-
44
- # 生效条件:调用 branch_node_id(orig, branch_id) 时,返回 orig 与 str(branch_id or "").strip().lower() 以 @ 拼接的字符串(branch_id 为假值时用空串)。
45
- def branch_node_id(orig: str, branch_id: str) -> str:
46
- """分支副本 id:`<主支nid>@<branch_id>`(@ 文件名合法、撞名不可能)。"""
47
- return "%s@%s" % (orig, str(branch_id or "").strip().lower())
48
-
49
-
50
- # 生效条件:调用 _audit(cg, op, **meta) 时,仅当 getattr(cg, "_audit", None) 不为 None 才用 op 等调用之,且该调用抛出的任何 Exception 被静默吞掉;否则直接返回。
51
- def _audit(cg, op: str, **meta) -> None:
52
- """生命周期留痕;审计失败绝不阻断主流程(G8 同哲学)。"""
53
- a = getattr(cg, "_audit", None)
54
- if a is None:
55
- return
56
- try:
57
- a(op, None, **meta)
58
- except Exception:
59
- pass
60
-
61
-
62
- # 生效条件:调用 _iter_branch_nodes(cg, branch_id) 时,返回 cg.index 的 "nodes" 字典(假值则视为空字典)中所有 v.get("branch_id") 等于 str(branch_id or "").strip().lower() 的 (k, v) 列表。
63
- def _iter_branch_nodes(cg, branch_id: str):
64
- bid = str(branch_id or "").strip().lower()
65
- return [(k, v) for k, v in list((cg.index.get("nodes") or {}).items())
66
- if v.get("branch_id") == bid]
67
-
68
-
69
- # 生效条件:调用 _fm_of(rec) 时,若 rec 为假值返回 {};否则返回 rec.get("frontmatter")(若该值真)或 rec 本身。
70
- def _fm_of(rec):
71
- """get 返回形态兼容:{'frontmatter': fm, 'content': c} 或平铺 fm。"""
72
- if not rec:
73
- return {}
74
- return rec.get("frontmatter") or rec
75
-
76
-
77
- # 生效条件:调用 fork(cg, node_ids, branch_id=None, note=None) 时,先将 node_ids 去空转字符串,为空则返回 {"ok": False, "error": ...};否则 branch_id 为 None 时生成 "br_"+uuid4().hex[:8],再 str(branch_id).strip().lower(),若不匹配模块常量 _BRANCH_RE 则返回错误;然后对每个 nid 跳过含 "@"、cg.get(nid) 为假值或 cg.get(branch_node_id(nid, branch_id)) 已存在者,其余经 cg.add 复制并记入 forked,最终返回 ok=bool(forked) 及 branch_id/tag/forked/skipped。
78
- def fork(cg, node_ids, branch_id=None, note=None) -> dict:
79
- """把主支节点复制成分支实验副本。
80
-
81
- 返回 {ok, branch_id, tag, forked:[{from,to}], skipped:[{id,why}]}。
82
- 幂等:同 (主支节点, branch_id) 的副本已存在则 skipped,不重复复制。
83
- """
84
- ids = [str(x).strip() for x in (node_ids or []) if str(x).strip()]
85
- if not ids:
86
- return {"ok": False, "error": "node_ids 为空(至少指定一个主支节点)"}
87
- if branch_id is None:
88
- branch_id = "br_" + uuid.uuid4().hex[:8]
89
- branch_id = str(branch_id).strip().lower()
90
- if not _BRANCH_RE.match(branch_id):
91
- return {"ok": False, "error": "branch_id 非法(%s):%r"
92
- % (_BRANCH_RE.pattern, branch_id)}
93
- forked, skipped = [], []
94
- for nid in ids:
95
- if "@" in nid:
96
- skipped.append({"id": nid, "why": "已是分支节点,不支持再 fork"})
97
- continue
98
- rec = cg.get(nid)
99
- if not rec:
100
- skipped.append({"id": nid, "why": "主支节点不存在或不可见"})
101
- continue
102
- fm = _fm_of(rec)
103
- bid = branch_node_id(nid, branch_id)
104
- if cg.get(bid):
105
- skipped.append({"id": nid, "why": "副本已存在:%s" % bid})
106
- continue
107
- cg.add(bid, rec.get("content") or "",
108
- layer=fm.get("layer") or "knowledge",
109
- role=fm.get("role"),
110
- tags=list(fm.get("tags") or []),
111
- condition_space=fm.get("condition_space"),
112
- importance=float(fm.get("importance", 0.5)),
113
- verification_basis=fm.get("verification_basis") or "test",
114
- # A1(2026-10-05,复核补):断言质量字段随副本携带(与
115
- # verification_basis 同族;缺省 None 时 add 不落键,零行为变化)。
116
- check_strength=fm.get("check_strength"),
117
- # A2(2026-10-05):幽灵引用标记随副本携带(正文属性——副本
118
- # 正文与主支一致则标记有效;缺省 None 不落键)。
119
- uncertain_refs=fm.get("uncertain_refs"),
120
- non_applicable_conditions=fm.get("non_applicable_conditions"),
121
- consistency=False,
122
- derived_from=[nid], relation="split_from",
123
- branch_id=branch_id, branched_from=nid, branch_note=note,
124
- actor="branch_fork")
125
- forked.append({"from": nid, "to": bid})
126
- _audit(cg, "branch_fork", branch_id=branch_id,
127
- forked=[f["to"] for f in forked])
128
- return {"ok": bool(forked), "branch_id": branch_id,
129
- "tag": branch_tag(branch_id), "forked": forked, "skipped": skipped}
130
-
131
-
132
- # 生效条件:调用 search(cg, query, branch_id, **kw) 时,以 branch=str(branch_id or "").strip().lower() 为参数转调 cg.search,并原样返回其结果。
133
- def search(cg, query: str, branch_id: str, **kw):
134
- """分支内检索:主支 + 本分支可见、其他分支隐身(_candidates branch 过滤)。"""
135
- return cg.search(query, branch=str(branch_id or "").strip().lower(), **kw)
136
-
137
-
138
- # 生效条件:当 node_id 经 str 转换并 strip 后含 '@'、cg.index['nodes'] 中存在该 id 且其 branch_id 非空、content 不是 dict 且不是 None 时返回 {'ok': True, 'node': nid, 'branch_id': ...},否则返回 {'ok': False, 'error': ...}。
139
- def rewrite(cg, node_id, content, tags=None, importance=None,
140
- actor="branch_rewrite", **extra) -> dict:
141
- """分支实验改写的**唯一正路**(防裸 add 丢分支归属)。
142
-
143
- 背景:add 是全量重建 fm——裸 add 改写分支节点而不重传 branch_id,
144
- 节点会在索引里退化成主支(实验内容直接泄漏进主支检索)。本帮手:
145
- - 只接受在册分支节点(含 @ 且 entry.branch_id 在册);
146
- - 归属与血缘(branch_id / branched_from / branch_note / derived_from /
147
- derived_relation)一律从旧 fm 继承,调用方**不可改**(extra 里
148
- 同名键静默剥离)——「分支上怎么改内容都行,改不了它是谁的实验」;
149
- - 层/条件空间/验证基底默认继承旧 fm(tags/importance 可显式覆盖);
150
- - override=True → 旧内容自动快照留痕(③ 快照机制,零新日志)。
151
- 写权限由 add 的 require_layer_write 库层强制,不在此重复设闸。
152
- """
153
- nid = str(node_id or "").strip()
154
- if "@" not in nid:
155
- return {"ok": False,
156
- "error": "非分支节点(须为 <主支>@<branch_id> 形态):%s" % nid}
157
- e = (cg.index.get("nodes") or {}).get(nid)
158
- if not e or not e.get("branch_id"):
159
- return {"ok": False, "error": "分支节点不存在或无分支归属:%s" % nid}
160
- rec = cg.get(nid)
161
- fm = _fm_of(rec)
162
- if isinstance(content, dict) or content is None:
163
- return {"ok": False, "error": "content 须为字符串"}
164
- for k in ("branch_id", "branched_from", "branch_note", "derived_from",
165
- "relation", "merged_from_branch", "override", "consistency",
166
- "uncertain_refs"):
167
- extra.pop(k, None) # 归属/血缘/写法闸/检测产物不可经 extra 篡改
168
- # A2(2026-10-05,复核 yellow-1 修):标记按**新正文**重算——本函数是
169
- # 「改正文的唯一正路」,携带旧标记会与正文脱节(干净正文带陈旧标记 /
170
- # 幽灵正文漏标,双向都错);与 mdcg.add「正文属性、按当次检测重算」
171
- # 的声明同口径。
172
- from . import ghostref as _ghostref
173
- _ur = _ghostref.find_ghost_phrases(
174
- str(content or ""), known=set((cg.index.get("nodes") or {}).keys()))
175
- cg.add(nid, str(content or ""),
176
- layer=fm.get("layer") or e.get("layer") or "knowledge",
177
- tags=list(tags if tags is not None else (fm.get("tags") or [])),
178
- importance=float(importance if importance is not None
179
- else (fm.get("importance") or 0.5)),
180
- condition_space=fm.get("condition_space"),
181
- verification_basis=fm.get("verification_basis") or "test",
182
- # A1(2026-10-05,复核补):断言质量字段随重写携带(同上)。
183
- check_strength=fm.get("check_strength"),
184
- # A2(2026-10-05):幽灵引用标记按新正文重算(见上)。
185
- uncertain_refs=_ur or None,
186
- non_applicable_conditions=fm.get("non_applicable_conditions"),
187
- override=True, consistency=False,
188
- derived_from=list(fm.get("derived_from") or []),
189
- relation=fm.get("derived_relation") or "split_from",
190
- branch_id=fm.get("branch_id") or e.get("branch_id"),
191
- branched_from=fm.get("branched_from") or e.get("branched_from"),
192
- branch_note=fm.get("branch_note"),
193
- actor=actor, **extra)
194
- _audit(cg, "branch_rewrite", branch_id=e.get("branch_id"), node=nid)
195
- return {"ok": True, "node": nid, "branch_id": e.get("branch_id")}
196
-
197
-
198
- # 生效条件:调用 merge(cg, branch_id, reason=None) 时,先取 bid=str(branch_id or "").strip().lower() 与 _iter_branch_nodes(cg, bid),若结果为空返回 {"ok": False, "error": ...};否则遍历每个分支节点,若其 branched_from 取不到主支节点则记 skipped,否则把分支内容用 cg.add 回写主支(override=True、derived_from 追加分支 nid、relation="merged_from" 等),最终返回 ok=bool(merged) 等。
199
- def merge(cg, branch_id, reason=None) -> dict:
200
- """把分支上的改写按 branched_from 溯源回写主支。
201
-
202
- - 主支内容 = 分支内容;层/tags/重要性继承主支(实验元数据不带回去);
203
- - 主支 derived_from 追加分支 nid(原链保留)、relation="merged_from";
204
- - override=True → 主支旧内容自动快照留痕;
205
- - 分支节点保留(merge 不自动删——显式两步、可逆、诚实)。
206
- """
207
- bid = str(branch_id or "").strip().lower()
208
- ents = _iter_branch_nodes(cg, bid)
209
- if not ents:
210
- return {"ok": False, "error": "分支不存在或无节点:%s" % bid}
211
- merged, skipped = [], []
212
- for nid, e in ents:
213
- orig = e.get("branched_from")
214
- rec = cg.get(orig) if orig else None
215
- if not rec:
216
- skipped.append({"id": nid, "why": "主支节点不存在:%s" % orig})
217
- continue
218
- src = cg.get(nid)
219
- old_fm = _fm_of(rec)
220
- src_fm = _fm_of(src)
221
- chain = list(old_fm.get("derived_from") or [])
222
- if nid not in chain:
223
- chain.append(nid)
224
- # A2(2026-10-05,复核 yellow-2① 修):主支正文 = 分支正文 ⇒ 标记按
225
- # 该正文重算(此前不携带 = 幽灵正文回写后无标记,方向与「宁标勿漏」
226
- # 相反;fork/rewrite 已接线,此处补齐同族)。
227
- from . import ghostref as _ghostref
228
- _mcontent = (src or {}).get("content") or ""
229
- _mur = _ghostref.find_ghost_phrases(
230
- _mcontent, known=set((cg.index.get("nodes") or {}).keys()))
231
- cg.add(orig, _mcontent,
232
- layer=old_fm.get("layer") or e.get("layer") or "knowledge",
233
- tags=list(old_fm.get("tags") or e.get("tags") or []),
234
- condition_space=src_fm.get("condition_space"),
235
- importance=float(old_fm.get("importance", 0.5)),
236
- verification_basis=old_fm.get("verification_basis") or "test",
237
- non_applicable_conditions=old_fm.get("non_applicable_conditions"),
238
- uncertain_refs=_mur or None,
239
- override=True, consistency=False,
240
- derived_from=chain, relation="merged_from",
241
- merged_from_branch=bid, actor="branch_merge")
242
- merged.append({"branch_node": nid, "target": orig})
243
- _audit(cg, "branch_merge", branch_id=bid,
244
- merged=[m["target"] for m in merged], reason=reason)
245
- return {"ok": bool(merged), "branch_id": bid, "merged": merged,
246
- "skipped": skipped,
247
- "hint": "分支节点保留:可 branch_search 继续实验,或 discard 冷归档"}
248
-
249
-
250
- # 生效条件:调用 discard(cg, branch_id, summary) 时,若 cg.principal 存在则先 require_admin("branch_discard");取 bid=str(branch_id or "").strip().lower(),若 summary 缺少模块常量 BRANCH_MARKS 中任一标记则返回错误,若 _iter_branch_nodes(cg, bid) 为空也返回错误;否则写 "branch_summary_"+bid 知识节点,把分支节点文件移入 COLD_DIR/bid 并从 cg.index["nodes"] 弹出,最后返回 ok=True 等。
251
- def discard(cg, branch_id, summary: str) -> dict:
252
- """放弃分支:校验教训必填 → 写 branch_summary 教训节点 → 分支冷归档。
253
-
254
- - summary 必须含 BRANCH_MARKS 三标记(缺一不收,防「无声放弃」);
255
- - 教训节点进 knowledge 层、tags 带 branch:<id>——可被正常检索召回;
256
- - 分支节点文件移入 _branches/<id>/(物理保留不违背永不删除,
257
- LAYERS 之外故 _scan_nodes 不再扫到——索引与主支检索天然干净);
258
- - 需 can_admin(改变库可见性属高危操作)。
259
- """
260
- p = getattr(cg, "principal", None)
261
- if p is not None:
262
- p.require_admin("branch_discard")
263
- bid = str(branch_id or "").strip().lower()
264
- missing = [m for m in BRANCH_MARKS if m not in (summary or "")]
265
- if missing:
266
- return {"ok": False, "error": "branch_summary 缺必填标记",
267
- "missing": missing, "required": list(BRANCH_MARKS)}
268
- ents = _iter_branch_nodes(cg, bid)
269
- if not ents:
270
- return {"ok": False, "error": "分支不存在或无节点:%s" % bid}
271
- body = summary if summary.lstrip().startswith("#") else \
272
- "# branch_summary:%s\n\n%s" % (bid, summary)
273
- sid = cg.add("branch_summary_%s" % bid, body, layer="knowledge",
274
- tags=["branch_summary", branch_tag(bid)],
275
- verification_basis="test", consistency=False,
276
- actor="branch_discard")
277
- cold = os.path.join(cg.root, COLD_DIR, bid)
278
- os.makedirs(cold, exist_ok=True)
279
- moved = 0
280
- for nid, e in ents:
281
- path = e.get("path")
282
- if path:
283
- src = os.path.join(cg.root, str(path).replace("/", os.sep))
284
- if os.path.exists(src):
285
- publish(src, os.path.join(cold, os.path.basename(src)))
286
- moved += 1
287
- # 摘索引必须**落盘**(写删除记录,forget 的口径——mdcos.py forget
288
- # 注释明载同构坑):只 pop 内存时,fork 阶段仍在 _dirty 的分支条目
289
- # 会被下面的 flush 作为 upsert 持久化进 _index_log;close 的 compact
290
- # 计数对账触发重扫后,_apply_log 把该 upsert 叠回干净扫描之上——
291
- # 幽灵条目连同目录指纹固化进 _index.json 快照,重开永久复活。
292
- # _unstage:pop 内存 + _dirty[nid]=None(tombstone)+ 立即 flush,
293
- # 重放按序 pop 掉 fork upsert(含 fork 后曾显式 flush 的时序)。
294
- unst = getattr(cg, "_unstage", None)
295
- if unst is not None:
296
- try:
297
- unst(nid)
298
- except Exception: # noqa: BLE001
299
- (cg.index.get("nodes") or {}).pop(nid, None)
300
- else:
301
- (cg.index.get("nodes") or {}).pop(nid, None)
302
- fl = getattr(cg, "flush", None)
303
- if fl is not None:
304
- try:
305
- fl()
306
- except Exception:
307
- pass
308
- _audit(cg, "branch_discard", branch_id=bid, moved=moved, summary_node=sid)
309
- return {"ok": True, "branch_id": bid, "moved": moved,
310
- "summary_node": sid, "cold_dir": "%s/%s" % (COLD_DIR, bid)}
311
-
312
-
313
- # 生效条件:调用 list_branches(cg) 时,遍历 cg.index 的 "nodes"(假值则空字典),仅对 e.get("branch_id") 为真值的节点按 bid 分组,收集节点 id 和 branched_from,返回 ok=True 与按 branch_id 排序的分组列表。
314
- def list_branches(cg) -> dict:
315
- """按 branch_id 聚合现存分支(节点清单 + 溯源主支)。"""
316
- groups = {}
317
- for nid, e in list((cg.index.get("nodes") or {}).items()):
318
- bid = e.get("branch_id")
319
- if not bid:
320
- continue
321
- g = groups.setdefault(bid, {"branch_id": bid, "tag": branch_tag(bid),
322
- "nodes": [], "branched_from": []})
323
- g["nodes"].append(nid)
324
- bf = e.get("branched_from")
325
- if bf and bf not in g["branched_from"]:
326
- g["branched_from"].append(bf)
327
- return {"ok": True,
1
+ # -*- coding: utf-8 -*-
2
+ """记忆演化分支(Pi 机制移植④,交接文档 §3④「记忆演化 fork」,P0)。
3
+
4
+ pi:会话 = entry 树,任意历史节点可 fork;被放弃旁支由 branch_summary
5
+ 归档定长摘要。灵枢映射(单一演化线 → 假设分支实验场):
6
+
7
+ - fork:把主支节点复制成分支实验副本(fm.branch_id / branched_from),
8
+ 副本 derived_from=[主支]、relation="split_from"——血缘单向可回溯;
9
+ - 分支节点默认从主支检索隐身(_candidates 按 branch 过滤,一处生效
10
+ 全链路穿透)——实验不污染主支(验收:召回主支时分支节点零命中);
11
+ - merge:按 branched_from 溯源回写主支(derived_from=[分支 nid] 追加进
12
+ 主支原链、relation="merged_from"),override 走快照——合并后链完整;
13
+ - discard:校验 BRANCH_MARKS 必填 → 写教训节点(knowledge 层、可检索)
14
+ → 分支文件移入冷区 _branches/<id>/(物理保留、索引摘除、永不删除)。
15
+
16
+ 与 writepipe 同哲学:库层函数收 cg,权限闸保持库层强制——
17
+ fork/merge 走 add 的 require_layer_write 自动覆盖;
18
+ discard 改变库可见性,需 can_admin(principal.require_admin)。
19
+ 生命周期事件走 _audit.jsonl(③ 两段式载体,零新日志格式)。
20
+ """
21
+
22
+ import os
23
+ import re
24
+ import uuid
25
+
26
+ from .fsutil import publish
27
+
28
+ #: discard 的 branch_summary 必填标记(复用 NEG_MEMORY_MARKS 的必填防呆模式:
29
+ #: 「假设 + 结果 + 教训」缺一不收——放弃分支必须留下可复用的教训)。
30
+ BRANCH_MARKS = ("分支假设", "实验结果", "教训")
31
+
32
+ #: 分支文件冷区(LAYERS 之外,_scan_nodes 不扫——天然不进索引与检索)。
33
+ COLD_DIR = "_branches"
34
+
35
+ _BRANCH_RE = re.compile(r"^[a-z0-9][a-z0-9_-]{0,63}$")
36
+
37
+
38
+ # 生效条件:调用 branch_tag(branch_id) 时,返回 "branch:" 拼接 str(branch_id or "").strip().lower()(branch_id 为假值时以空串参与拼接)。
39
+ def branch_tag(branch_id: str) -> str:
40
+ """分支节点的标注 tag(fork 时写入;branch_summary 也带它以便反查)。"""
41
+ return "branch:" + str(branch_id or "").strip().lower()
42
+
43
+
44
+ # 生效条件:调用 branch_node_id(orig, branch_id) 时,返回 orig 与 str(branch_id or "").strip().lower() 以 @ 拼接的字符串(branch_id 为假值时用空串)。
45
+ def branch_node_id(orig: str, branch_id: str) -> str:
46
+ """分支副本 id:`<主支nid>@<branch_id>`(@ 文件名合法、撞名不可能)。"""
47
+ return "%s@%s" % (orig, str(branch_id or "").strip().lower())
48
+
49
+
50
+ # 生效条件:调用 _audit(cg, op, **meta) 时,仅当 getattr(cg, "_audit", None) 不为 None 才用 op 等调用之,且该调用抛出的任何 Exception 被静默吞掉;否则直接返回。
51
+ def _audit(cg, op: str, **meta) -> None:
52
+ """生命周期留痕;审计失败绝不阻断主流程(G8 同哲学)。"""
53
+ a = getattr(cg, "_audit", None)
54
+ if a is None:
55
+ return
56
+ try:
57
+ a(op, None, **meta)
58
+ except Exception:
59
+ pass
60
+
61
+
62
+ # 生效条件:调用 _iter_branch_nodes(cg, branch_id) 时,返回 cg.index 的 "nodes" 字典(假值则视为空字典)中所有 v.get("branch_id") 等于 str(branch_id or "").strip().lower() 的 (k, v) 列表。
63
+ def _iter_branch_nodes(cg, branch_id: str):
64
+ bid = str(branch_id or "").strip().lower()
65
+ return [(k, v) for k, v in list((cg.index.get("nodes") or {}).items())
66
+ if v.get("branch_id") == bid]
67
+
68
+
69
+ # 生效条件:调用 _fm_of(rec) 时,若 rec 为假值返回 {};否则返回 rec.get("frontmatter")(若该值真)或 rec 本身。
70
+ def _fm_of(rec):
71
+ """get 返回形态兼容:{'frontmatter': fm, 'content': c} 或平铺 fm。"""
72
+ if not rec:
73
+ return {}
74
+ return rec.get("frontmatter") or rec
75
+
76
+
77
+ # 生效条件:调用 _inherit_sensitivity(cg, nid) 时,返回 subgraph.node_sensitivity(cg, nid)(索引快照优先、回退读文件 frontmatter;判不了返回 None)。
78
+ def _inherit_sensitivity(cg, nid):
79
+ """派生写(副本/改写/回写)应继承的密级 = 来源节点密级。
80
+
81
+ issue #243(本件):此前 fork/rewrite/merge 三处 cg.add 均不传 sensitivity,
82
+ MdCGSecure.add 把缺省归一为 DEFAULT_SENSITIVITY(internal)——声明 private
83
+ 的主支节点一旦 fork / 改写 / 合并,盘上就变成 internal **明文**
84
+ (crypto.ENCRYPTED_LEVELS 只含 private/secret),密级静默降级。
85
+ 读密级复用既有单点 subgraph.node_sensitivity(与 #164 派生节点密级同源),
86
+ 三处派生写共用本函数,避免各自复制一份判据。
87
+ 判不了(节点不可见 / 档位缺或非法)返回 None —— 三处调用点一律 fail-closed
88
+ 跳过或拒绝,**不把 None 直传 add**(那会被归一成 internal,等于把「判不了」
89
+ 当成「internal 明文」,与 #164「判不了不生成」口径相反)。
90
+ """
91
+ from . import subgraph as _subgraph
92
+ return _subgraph.node_sensitivity(cg, nid)
93
+
94
+
95
+ # 生效条件:调用 _fail_closed_on_unjudged(sens) 时,sens 为 None(档位缺 / 非法 / 节点不可见)返回 True,否则返回 False。
96
+ def _fail_closed_on_unjudged(sens) -> bool:
97
+ """判不了密级即 fail-closed —— 三处派生写共用的唯一判据点(issue #243)。
98
+
99
+ 返回 True 表示调用点必须跳过或拒绝,**不得**把 None 直传 cg.add:那会被
100
+ MdCGSecure.add 归一成 DEFAULT_SENSITIVITY=internal,等于把「判不了」当成
101
+ 「internal 明文」,与 #164「判不了不生成」口径相反。单点化同时让定点变异
102
+ 可自证:本函数恒 False 时,三处 fail-closed 断言必须变红并点名。
103
+ """
104
+ return sens is None
105
+
106
+
107
+ # 生效条件:调用 _merge_downgrades(main_sens, branch_sens) 时,返回 bool(security.merge_downgrades(main_sens, branch_sens))。
108
+ def _merge_downgrades(main_sens, branch_sens) -> bool:
109
+ """merge 回写是否会降密级 —— 复用 security.merge_downgrades 单点(issue #148)。"""
110
+ from .security import merge_downgrades as _md
111
+ return bool(_md(main_sens, branch_sens))
112
+
113
+
114
+ # 生效条件:调用 fork(cg, node_ids, branch_id=None, note=None) 时,先将 node_ids 去空转字符串,为空则返回 {"ok": False, "error": ...};否则 branch_id 为 None 时生成 "br_"+uuid4().hex[:8],再 str(branch_id).strip().lower(),若不匹配模块常量 _BRANCH_RE 则返回错误;然后对每个 nid 跳过含 "@"、cg.get(nid) 为假值或 cg.get(branch_node_id(nid, branch_id)) 已存在者,其余经 cg.add 复制并记入 forked,最终返回 ok=bool(forked) 及 branch_id/tag/forked/skipped。
115
+ def fork(cg, node_ids, branch_id=None, note=None) -> dict:
116
+ """把主支节点复制成分支实验副本。
117
+
118
+ 返回 {ok, branch_id, tag, forked:[{from,to}], skipped:[{id,why}]}。
119
+ 幂等:同 (主支节点, branch_id) 的副本已存在则 skipped,不重复复制。
120
+ """
121
+ ids = [str(x).strip() for x in (node_ids or []) if str(x).strip()]
122
+ if not ids:
123
+ return {"ok": False, "error": "node_ids 为空(至少指定一个主支节点)"}
124
+ if branch_id is None:
125
+ branch_id = "br_" + uuid.uuid4().hex[:8]
126
+ branch_id = str(branch_id).strip().lower()
127
+ if not _BRANCH_RE.match(branch_id):
128
+ return {"ok": False, "error": "branch_id 非法(%s):%r"
129
+ % (_BRANCH_RE.pattern, branch_id)}
130
+ forked, skipped = [], []
131
+ for nid in ids:
132
+ if "@" in nid:
133
+ skipped.append({"id": nid, "why": "已是分支节点,不支持再 fork"})
134
+ continue
135
+ rec = cg.get(nid)
136
+ if not rec:
137
+ skipped.append({"id": nid, "why": "主支节点不存在或不可见"})
138
+ continue
139
+ fm = _fm_of(rec)
140
+ bid = branch_node_id(nid, branch_id)
141
+ if cg.get(bid):
142
+ skipped.append({"id": nid, "why": "副本已存在:%s" % bid})
143
+ continue
144
+ # 密级随副本携带(issue #243):不传则 add 归一为 internal,声明
145
+ # private 的主支节点 fork 后即成 internal 明文(静默降级);判不了
146
+ # (缺/非法档位)fail-closed 不复制——与 #164「判不了不生成」同口径。
147
+ _sens = _inherit_sensitivity(cg, nid)
148
+ if _fail_closed_on_unjudged(_sens):
149
+ skipped.append({"id": nid, "why":
150
+ "来源密级判不了(缺/非法档位):fail-closed 不复制"
151
+ "(#164 同口径,subgraph.node_sensitivity 返回 None)"})
152
+ continue
153
+ cg.add(bid, rec.get("content") or "",
154
+ layer=fm.get("layer") or "knowledge",
155
+ role=fm.get("role"),
156
+ tags=list(fm.get("tags") or []),
157
+ condition_space=fm.get("condition_space"),
158
+ importance=float(fm.get("importance", 0.5)),
159
+ verification_basis=fm.get("verification_basis") or "test",
160
+ # A1(2026-10-05,复核补):断言质量字段随副本携带(与
161
+ # verification_basis 同族;缺省 None 时 add 不落键,零行为变化)。
162
+ check_strength=fm.get("check_strength"),
163
+ # A2(2026-10-05):幽灵引用标记随副本携带(正文属性——副本
164
+ # 正文与主支一致则标记有效;缺省 None 不落键)。
165
+ uncertain_refs=fm.get("uncertain_refs"),
166
+ non_applicable_conditions=fm.get("non_applicable_conditions"),
167
+ sensitivity=_sens,
168
+ consistency=False,
169
+ derived_from=[nid], relation="split_from",
170
+ branch_id=branch_id, branched_from=nid, branch_note=note,
171
+ actor="branch_fork")
172
+ forked.append({"from": nid, "to": bid})
173
+ _audit(cg, "branch_fork", branch_id=branch_id,
174
+ forked=[f["to"] for f in forked])
175
+ return {"ok": bool(forked), "branch_id": branch_id,
176
+ "tag": branch_tag(branch_id), "forked": forked, "skipped": skipped}
177
+
178
+
179
+ # 生效条件:调用 search(cg, query, branch_id, **kw) 时,以 branch=str(branch_id or "").strip().lower() 为参数转调 cg.search,并原样返回其结果。
180
+ def search(cg, query: str, branch_id: str, **kw):
181
+ """分支内检索:主支 + 本分支可见、其他分支隐身(_candidates branch 过滤)。"""
182
+ return cg.search(query, branch=str(branch_id or "").strip().lower(), **kw)
183
+
184
+
185
+ # 生效条件:当 node_id 经 str 转换并 strip 后含 '@'、cg.index['nodes'] 中存在该 id 且其 branch_id 非空、content 不是 dict 且不是 None 时返回 {'ok': True, 'node': nid, 'branch_id': ...},否则返回 {'ok': False, 'error': ...}。
186
+ def rewrite(cg, node_id, content, tags=None, importance=None,
187
+ actor="branch_rewrite", **extra) -> dict:
188
+ """分支实验改写的**唯一正路**(防裸 add 丢分支归属)。
189
+
190
+ 背景:add 是全量重建 fm——裸 add 改写分支节点而不重传 branch_id,
191
+ 节点会在索引里退化成主支(实验内容直接泄漏进主支检索)。本帮手:
192
+ - 只接受在册分支节点(含 @ 且 entry.branch_id 在册);
193
+ - 归属与血缘(branch_id / branched_from / branch_note / derived_from /
194
+ derived_relation)一律从旧 fm 继承,调用方**不可改**(extra 里
195
+ 同名键静默剥离)——「分支上怎么改内容都行,改不了它是谁的实验」;
196
+ - 层/条件空间/验证基底默认继承旧 fm(tags/importance 可显式覆盖);
197
+ - 密级(sensitivity)与归属/血缘同族,一律从旧 fm 继承,extra 里同名键
198
+ 静默剥离(issue #243:此前既漏继承,又允许调用方经 extra 直接改档——
199
+ 含把 private 分支改成 internal,两条路都通向静默降级);
200
+ - override=True → 旧内容自动快照留痕(③ 快照机制,零新日志)。
201
+ 写权限由 add 的 require_layer_write 库层强制,不在此重复设闸。
202
+ """
203
+ nid = str(node_id or "").strip()
204
+ if "@" not in nid:
205
+ return {"ok": False,
206
+ "error": "非分支节点(须为 <主支>@<branch_id> 形态):%s" % nid}
207
+ e = (cg.index.get("nodes") or {}).get(nid)
208
+ if not e or not e.get("branch_id"):
209
+ return {"ok": False, "error": "分支节点不存在或无分支归属:%s" % nid}
210
+ rec = cg.get(nid)
211
+ fm = _fm_of(rec)
212
+ if isinstance(content, dict) or content is None:
213
+ return {"ok": False, "error": "content 须为字符串"}
214
+ for k in ("branch_id", "branched_from", "branch_note", "derived_from",
215
+ "relation", "merged_from_branch", "override", "consistency",
216
+ "uncertain_refs", "sensitivity"):
217
+ extra.pop(k, None) # 归属/血缘/密级/写法闸/检测产物不可经 extra 篡改
218
+ # A2(2026-10-05,复核 yellow-1 修):标记按**新正文**重算——本函数是
219
+ # 「改正文的唯一正路」,携带旧标记会与正文脱节(干净正文带陈旧标记 /
220
+ # 幽灵正文漏标,双向都错);与 mdcg.add「正文属性、按当次检测重算」
221
+ # 的声明同口径。
222
+ from . import ghostref as _ghostref
223
+ _ur = _ghostref.find_ghost_phrases(
224
+ str(content or ""), known=set((cg.index.get("nodes") or {}).keys()))
225
+ _sens = _inherit_sensitivity(cg, nid)
226
+ if _fail_closed_on_unjudged(_sens):
227
+ return {"ok": False,
228
+ "error": "来源密级判不了(缺/非法档位):fail-closed 不改写"
229
+ "(#164 同口径,subgraph.node_sensitivity 返回 None)"}
230
+ cg.add(nid, str(content or ""),
231
+ layer=fm.get("layer") or e.get("layer") or "knowledge",
232
+ tags=list(tags if tags is not None else (fm.get("tags") or [])),
233
+ importance=float(importance if importance is not None
234
+ else (fm.get("importance") or 0.5)),
235
+ condition_space=fm.get("condition_space"),
236
+ verification_basis=fm.get("verification_basis") or "test",
237
+ # A1(2026-10-05,复核补):断言质量字段随重写携带(同上)。
238
+ check_strength=fm.get("check_strength"),
239
+ # A2(2026-10-05):幽灵引用标记按新正文重算(见上)。
240
+ uncertain_refs=_ur or None,
241
+ non_applicable_conditions=fm.get("non_applicable_conditions"),
242
+ sensitivity=_sens,
243
+ override=True, consistency=False,
244
+ derived_from=list(fm.get("derived_from") or []),
245
+ relation=fm.get("derived_relation") or "split_from",
246
+ branch_id=fm.get("branch_id") or e.get("branch_id"),
247
+ branched_from=fm.get("branched_from") or e.get("branched_from"),
248
+ branch_note=fm.get("branch_note"),
249
+ actor=actor, **extra)
250
+ _audit(cg, "branch_rewrite", branch_id=e.get("branch_id"), node=nid)
251
+ return {"ok": True, "node": nid, "branch_id": e.get("branch_id")}
252
+
253
+
254
+ # 生效条件:调用 merge(cg, branch_id, reason=None) 时,先取 bid=str(branch_id or "").strip().lower() 与 _iter_branch_nodes(cg, bid),若结果为空返回 {"ok": False, "error": ...};否则遍历每个分支节点,若其 branched_from 取不到主支节点则记 skipped,否则把分支内容用 cg.add 回写主支(override=True、derived_from 追加分支 nid、relation="merged_from" 等),最终返回 ok=bool(merged) 等。
255
+ def merge(cg, branch_id, reason=None) -> dict:
256
+ """把分支上的改写按 branched_from 溯源回写主支。
257
+
258
+ - 主支内容 = 分支内容;层/tags/重要性继承主支(实验元数据不带回去);
259
+ - 主支 derived_from 追加分支 nid(原链保留)、relation="merged_from";
260
+ - override=True → 主支旧内容自动快照留痕;
261
+ - 密级:回写沿用主支档;若分支档更高(写回即降密级)则跳过该节点,
262
+ fail-closed(security.merge_downgrades 单点,issue #148 同口径);
263
+ - 分支节点保留(merge 不自动删——显式两步、可逆、诚实)。
264
+ """
265
+ bid = str(branch_id or "").strip().lower()
266
+ ents = _iter_branch_nodes(cg, bid)
267
+ if not ents:
268
+ return {"ok": False, "error": "分支不存在或无节点:%s" % bid}
269
+ merged, skipped = [], []
270
+ for nid, e in ents:
271
+ orig = e.get("branched_from")
272
+ rec = cg.get(orig) if orig else None
273
+ if not rec:
274
+ skipped.append({"id": nid, "why": "主支节点不存在:%s" % orig})
275
+ continue
276
+ src = cg.get(nid)
277
+ old_fm = _fm_of(rec)
278
+ src_fm = _fm_of(src)
279
+ # 密级闸(issue #243):回写前先判会不会降密级——分支被升到更高档后
280
+ # 把正文写回低档主支,就是把 private 正文变成 internal 明文(静默降
281
+ # 级)。判据复用 security.merge_downgrades 单点(issue #148,writelimit
282
+ # 与 forgetting 同源),判为降密级即 fail-closed 不写盘。
283
+ _sens_main = _inherit_sensitivity(cg, orig)
284
+ _sens_src = _inherit_sensitivity(cg, nid)
285
+ if _fail_closed_on_unjudged(_sens_main) or _fail_closed_on_unjudged(_sens_src):
286
+ skipped.append({"id": nid, "why":
287
+ "密级判不了(缺/非法档位):fail-closed 不写盘"
288
+ "(#164 同口径,subgraph.node_sensitivity 返回 None)"})
289
+ continue
290
+ if _merge_downgrades(_sens_main, _sens_src):
291
+ skipped.append({"id": nid, "why":
292
+ "合并会降密级(分支 %s > 主支 %s):fail-closed 不写盘"
293
+ "(security.merge_downgrades 单点,issue #148)"
294
+ % (_sens_src, _sens_main)})
295
+ continue
296
+ chain = list(old_fm.get("derived_from") or [])
297
+ if nid not in chain:
298
+ chain.append(nid)
299
+ # A2(2026-10-05,复核 yellow-2① 修):主支正文 = 分支正文 ⇒ 标记按
300
+ # 该正文重算(此前不携带 = 幽灵正文回写后无标记,方向与「宁标勿漏」
301
+ # 相反;fork/rewrite 已接线,此处补齐同族)。
302
+ from . import ghostref as _ghostref
303
+ _mcontent = (src or {}).get("content") or ""
304
+ _mur = _ghostref.find_ghost_phrases(
305
+ _mcontent, known=set((cg.index.get("nodes") or {}).keys()))
306
+ cg.add(orig, _mcontent,
307
+ layer=old_fm.get("layer") or e.get("layer") or "knowledge",
308
+ tags=list(old_fm.get("tags") or e.get("tags") or []),
309
+ condition_space=src_fm.get("condition_space"),
310
+ importance=float(old_fm.get("importance", 0.5)),
311
+ verification_basis=old_fm.get("verification_basis") or "test",
312
+ non_applicable_conditions=old_fm.get("non_applicable_conditions"),
313
+ uncertain_refs=_mur or None,
314
+ # 密级沿用主支档(已过降密级闸,见上)。
315
+ sensitivity=_sens_main,
316
+ override=True, consistency=False,
317
+ derived_from=chain, relation="merged_from",
318
+ merged_from_branch=bid, actor="branch_merge")
319
+ merged.append({"branch_node": nid, "target": orig})
320
+ _audit(cg, "branch_merge", branch_id=bid,
321
+ merged=[m["target"] for m in merged], reason=reason)
322
+ return {"ok": bool(merged), "branch_id": bid, "merged": merged,
323
+ "skipped": skipped,
324
+ "hint": "分支节点保留:可 branch_search 继续实验,或 discard 冷归档"}
325
+
326
+
327
+ # 生效条件:调用 discard(cg, branch_id, summary) 时,若 cg.principal 存在则先 require_admin("branch_discard");取 bid=str(branch_id or "").strip().lower(),若 summary 缺少模块常量 BRANCH_MARKS 中任一标记则返回错误,若 _iter_branch_nodes(cg, bid) 为空也返回错误;否则写 "branch_summary_"+bid 知识节点,把分支节点文件移入 COLD_DIR/bid 并从 cg.index["nodes"] 弹出,最后返回 ok=True 等。
328
+ def discard(cg, branch_id, summary: str) -> dict:
329
+ """放弃分支:校验教训必填 → 写 branch_summary 教训节点 → 分支冷归档。
330
+
331
+ - summary 必须含 BRANCH_MARKS 三标记(缺一不收,防「无声放弃」);
332
+ - 教训节点进 knowledge 层、tags 带 branch:<id>——可被正常检索召回;
333
+ - 分支节点文件移入 _branches/<id>/(物理保留不违背永不删除,
334
+ LAYERS 之外故 _scan_nodes 不再扫到——索引与主支检索天然干净);
335
+ - 需 can_admin(改变库可见性属高危操作)。
336
+ """
337
+ p = getattr(cg, "principal", None)
338
+ if p is not None:
339
+ p.require_admin("branch_discard")
340
+ bid = str(branch_id or "").strip().lower()
341
+ missing = [m for m in BRANCH_MARKS if m not in (summary or "")]
342
+ if missing:
343
+ return {"ok": False, "error": "branch_summary 缺必填标记",
344
+ "missing": missing, "required": list(BRANCH_MARKS)}
345
+ ents = _iter_branch_nodes(cg, bid)
346
+ if not ents:
347
+ return {"ok": False, "error": "分支不存在或无节点:%s" % bid}
348
+ body = summary if summary.lstrip().startswith("#") else \
349
+ "# branch_summary:%s\n\n%s" % (bid, summary)
350
+ sid = cg.add("branch_summary_%s" % bid, body, layer="knowledge",
351
+ tags=["branch_summary", branch_tag(bid)],
352
+ verification_basis="test", consistency=False,
353
+ actor="branch_discard")
354
+ cold = os.path.join(cg.root, COLD_DIR, bid)
355
+ os.makedirs(cold, exist_ok=True)
356
+ moved = 0
357
+ for nid, e in ents:
358
+ path = e.get("path")
359
+ if path:
360
+ src = os.path.join(cg.root, str(path).replace("/", os.sep))
361
+ if os.path.exists(src):
362
+ publish(src, os.path.join(cold, os.path.basename(src)))
363
+ moved += 1
364
+ # 摘索引必须**落盘**(写删除记录,forget 的口径——mdcos.py forget
365
+ # 注释明载同构坑):只 pop 内存时,fork 阶段仍在 _dirty 的分支条目
366
+ # 会被下面的 flush 作为 upsert 持久化进 _index_log;close 的 compact
367
+ # 计数对账触发重扫后,_apply_log 把该 upsert 叠回干净扫描之上——
368
+ # 幽灵条目连同目录指纹固化进 _index.json 快照,重开永久复活。
369
+ # _unstage:pop 内存 + _dirty[nid]=None(tombstone)+ 立即 flush,
370
+ # 重放按序 pop 掉 fork upsert(含 fork 后曾显式 flush 的时序)。
371
+ unst = getattr(cg, "_unstage", None)
372
+ if unst is not None:
373
+ try:
374
+ unst(nid)
375
+ except Exception: # noqa: BLE001
376
+ (cg.index.get("nodes") or {}).pop(nid, None)
377
+ else:
378
+ (cg.index.get("nodes") or {}).pop(nid, None)
379
+ fl = getattr(cg, "flush", None)
380
+ if fl is not None:
381
+ try:
382
+ fl()
383
+ except Exception:
384
+ pass
385
+ _audit(cg, "branch_discard", branch_id=bid, moved=moved, summary_node=sid)
386
+ return {"ok": True, "branch_id": bid, "moved": moved,
387
+ "summary_node": sid, "cold_dir": "%s/%s" % (COLD_DIR, bid)}
388
+
389
+
390
+ # 生效条件:调用 list_branches(cg) 时,遍历 cg.index 的 "nodes"(假值则空字典),仅对 e.get("branch_id") 为真值的节点按 bid 分组,收集节点 id 和 branched_from,返回 ok=True 与按 branch_id 排序的分组列表。
391
+ def list_branches(cg) -> dict:
392
+ """按 branch_id 聚合现存分支(节点清单 + 溯源主支)。"""
393
+ groups = {}
394
+ for nid, e in list((cg.index.get("nodes") or {}).items()):
395
+ bid = e.get("branch_id")
396
+ if not bid:
397
+ continue
398
+ g = groups.setdefault(bid, {"branch_id": bid, "tag": branch_tag(bid),
399
+ "nodes": [], "branched_from": []})
400
+ g["nodes"].append(nid)
401
+ bf = e.get("branched_from")
402
+ if bf and bf not in g["branched_from"]:
403
+ g["branched_from"].append(bf)
404
+ return {"ok": True,
328
405
  "branches": sorted(groups.values(), key=lambda g: g["branch_id"])}