@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/md_cg/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"])}