@furongjun1999/dsh-memory 0.8.0 → 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 -632
  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 -5417
  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_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. 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
  531. 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
  532. 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
  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_v2.0.md +0 -239
  534. 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
  535. 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
  536. 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
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. 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
  539. 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
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. 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
  543. 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
  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.1.md +0 -340
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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 -152
  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/logref.py CHANGED
@@ -1,327 +1,332 @@
1
- # -*- coding: utf-8 -*-
2
- """md_cg · 日志真源桥(P1):认知图 ref 节点 ↔ DSH 日志真源 / 确定性转写。
3
-
4
- 真源身份与区间表的**唯一实现**在 `srcindex`(`session_src_id` / `log_units`)——
5
- 本模块只做桥与读路径:把 `refindex` 的 ref 协议接到「日志真源 + 转写区间」上。
6
- md_cg 侧**零路径常量、零 scripts 依赖**:转写根由调用方(scripts 侧)注入,
7
- 单点仍在 `scripts/dsh_log_index.py:138/:514-516`;服务态因此不可能「自己决定
8
- 把转写写到哪」(P2 的再生**不在服务态做**,见 `read_index_node`)。
9
-
10
- 两层回读(方案 v0.3 §2、§9 裁定①):
11
- 区间层 `refindex.read_ref(doc_ref)` → 转写文件行区间
12
- 真源身份层 `srcindex.read_unit(src_unit(ref))` → zstd 日志本体(whole 粒度)
13
-
14
- 生效条件:ref 为 `refindex` 写出的 doc_ref(含 path/root/hash),且 root(转写根)
15
- 由调用方注入;`probe_src` 另需 `doc_ref.src` 且在 `MDCG_INGEST_ROOT` 白名单内。
16
- 不适用条件:无 doc_ref 的节点(非索引节点);`src.path` 为空(`--src-path hash`
17
- 降级)时无法探测真源——`probe_src` 如实返回 unresolved,不猜。
18
- """
19
- from __future__ import annotations
20
-
21
- import os
22
-
23
- from . import refindex, srcindex
24
-
25
- #: 落库判据的两个状态名(`node_state` 的 state;其余状态见 docstring)
26
- WRITE_STATES = ("new", "overwrite")
27
- KIND = "doc_ref"
28
-
29
-
30
- # 生效条件:path/workspace/session_id 为任意值(缺省按空串处理);返回
31
- # "<workspace>/<session_id>/<session_id>.md"("/" 分隔,与 doc_ref.path 同形)。
32
- def default_rel_of(workspace: str, session_id: str) -> str:
33
- ws = (workspace or "").strip("/\\")
34
- sid = (session_id or "").strip("/\\")
35
- return "/".join(p for p in (ws, sid, sid + ".md") if p)
36
-
37
-
38
- # 生效条件:无入参副作用;返回 doc_ref → srcindex whole 单位的 dict(真源身份层回读入参)。
39
- def src_unit(ref: dict) -> dict:
40
- """doc_ref → `srcindex` 的 whole 单位(真源身份层的回读入参,纯函数)。"""
41
- src = (ref or {}).get("src")
42
- src = src if isinstance(src, dict) else {}
43
- return {"src": src, "span": {"unit": "whole"},
44
- "span_hash": src.get("file_hash")}
45
-
46
-
47
- # 生效条件:ref 为 dict(其余按 {} 处理);verify 取 "hash"(缺省,实核 sha256)或其它值
48
- # (只做 size/mtime 快路径)。返回 status ∈ ok/stale/unverified/dangling/unresolved/denied
49
- # 与 ok/hash_verified 布尔;无 src 子键或 src.path 为空时返回 unresolved(不抛 KeyError)。
50
- def probe_src(ref: dict, *, verify: str = "hash") -> dict:
51
- """探测真源(zstd 日志)状态——**与 ref 回读挂同一条根白名单闸**。
52
-
53
- 为什么必须挂闸:frontmatter 是写入侧可塞的内容(`mdcg.py:1709 fm.update(extra)`),
54
- 于是 `doc_ref.src.path` 与 `doc_ref.path` 一样是模型可控输入;本函数直接 stat
55
- 并按需整读该文件。故走 `security.check_path_root(..., "MDCG_INGEST_ROOT", "src")`
56
- ——与 `mcp_server.py:2939-2942` 给 ref 回读挂的是同一条闸(未配置=放开、
57
- 配置=realpath 落根内否则拒,fail-closed)。
58
-
59
- `verify="hash"`(缺省)时**必须**核 sha256 才算 ok:只对 (size, mtime) 相同只能
60
- 给 `unverified`(fail-closed,巡检视为 not-ok)——否则「同长度同时间戳的替换」
61
- 会静默通过。`hash_verified` 布尔用来区分「核过的 ok」与「没核的 ok」。
62
- """
63
- ref = ref or {}
64
- src = ref.get("src")
65
- src = src if isinstance(src, dict) else None
66
- path = (src or {}).get("path") or ""
67
- base = {"src": src, "path": path, "verify": verify,
68
- "ok": False, "hash_verified": False}
69
- if not src:
70
- return {**base, "status": "unresolved",
71
- "error": "该 ref 无 src 子键(不是日志真源索引节点),无法探测真源"}
72
- if not path:
73
- return {**base, "status": "unresolved",
74
- "error": "src.path 为空(--src-path hash 降级:真源路径未落库)"
75
- ",无法探测——不猜"}
76
- if not os.path.isabs(path):
77
- return {**base, "status": "unresolved",
78
- "error": "src.path 是相对路径(--src-path rel 降级:dir 未落库),"
79
- "无绝对根可解析——不猜"}
80
- from .security import check_path_root
81
- try:
82
- check_path_root(path, "MDCG_INGEST_ROOT", "src")
83
- except PermissionError as exc: # 拒读即 not-ok,绝不降级放行
84
- return {**base, "status": "denied", "error": str(exc)[:300]}
85
- if not os.path.isfile(path):
86
- return {**base, "status": "dangling", "abspath": path,
87
- "error": "真源不存在(索引已悬空):%s" % path}
88
- expect = src.get("file_hash")
89
- if verify == "hash":
90
- if not expect:
91
- return {**base, "status": "unverified", "abspath": path,
92
- "error": "src.file_hash 缺失,无法核 hash(fail-closed:不计 ok)"}
93
- # 整文件回读走 **P0 的唯一实现**(`srcindex.read_unit(whole)`)——不在这里
94
- # 再写一份 sha256:与区域哈希同一条教训,两处算法会让「核过了」永远为真。
95
- u = srcindex.read_unit(src_unit(ref))
96
- if not u.get("ok"):
97
- return {**base, "abspath": path, "status": "dangling",
98
- "error": str(u.get("error"))[:200]}
99
- match = bool(u.get("hash_match"))
100
- return {**base, "abspath": path, "bytes": u.get("bytes"),
101
- "hash": u.get("hash"), "hash_expected": expect,
102
- "hash_match": match, "hash_verified": match,
103
- "ok": match, "status": "ok" if match else "stale"}
104
- try:
105
- st = os.stat(path)
106
- except OSError as exc:
107
- return {**base, "status": "dangling", "abspath": path, "error": str(exc)[:200]}
108
- same = (src.get("size") == st.st_size
109
- and abs(float(src.get("mtime") or 0.0) - st.st_mtime) < 1e-6)
110
- if same:
111
- return {**base, "abspath": path, "status": "unverified",
112
- "error": "仅 (size, mtime) 相同、未核 hash ⇒ 不计 ok(fail-closed)"}
113
- return {**base, "abspath": path, "status": "stale",
114
- "size": st.st_size, "mtime": st.st_mtime}
115
-
116
-
117
- # 生效条件:it 为 docindex 口径条目、kind 默认 "doc_ref";返回 {id, state, ...},
118
- # state ∈ new/unchanged/overwrite/blocked(blocked 带 error 原因)。
119
- def node_state(cg, it: dict, *, kind: str = KIND) -> dict:
120
- """单条条目的落库判据:**读节点自己的 doc_ref**,不读水位台账。
121
-
122
- 判据 = `hash` 与 `lineno/end` **全等**才算已索引。为什么不看 id:
123
- `docindex.node_id` 是 `path#heading_path` 寻址(docindex.py:294-299),
124
- 同标题换正文时 **id 不变而 hash 变**——「id 撞即跳」会把漂移判成已索引、
125
- 静默放过(N203 的静默正是这么来的)。
126
- 为什么不看 `Ledger` 水位:水位在活库根、且记的 rel 与改写后的
127
- `doc_ref.path` 不同源(refindex.py:302-317),开它就等于引一条会误判的
128
- 快路径;真源增量改由节点自描述的 `doc_ref.src.file_hash` 承担。
129
- """
130
- nid = refindex.node_id_of(it, kind)
131
- nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
132
- if nid not in nodes:
133
- return {"id": nid, "state": "new"}
134
- try:
135
- node = cg.get(nid)
136
- except Exception as exc: # 读隔离/保护抛错 → 拦下,不越权覆写
137
- return {"id": nid, "state": "blocked", "error": ("cg.get 抛错:%s" % exc)[:200]}
138
- if not node:
139
- return {"id": nid, "state": "blocked",
140
- "error": "索引有条目但 cg.get 读不回(密级/保护)——fail-closed,不覆写"}
141
- _k, ref = refindex.ref_of(node)
142
- if not isinstance(ref, dict) or not ref:
143
- # refindex.ref_of 对无 doc_ref 的节点返回 ('', None):覆写并**计数**(不静默)
144
- return {"id": nid, "state": "overwrite", "reason": "no_ref"}
145
- same = (ref.get("hash") == it.get("hash")
146
- and _int(ref.get("lineno")) == _int(it.get("lineno"))
147
- and _int(ref.get("end")) == _int(it.get("end")))
148
- if same:
149
- return {"id": nid, "state": "unchanged"}
150
- return {"id": nid, "state": "overwrite", "reason": "hash_or_span",
151
- "was": {"hash": ref.get("hash"), "lineno": _int(ref.get("lineno")),
152
- "end": _int(ref.get("end"))},
153
- "now": {"hash": it.get("hash"), "lineno": _int(it.get("lineno")),
154
- "end": _int(it.get("end"))}}
155
-
156
-
157
- # 生效条件:v 可转 int 时返回该 int,否则返回 -1(行位缺失/非法一律判不等,不抛)。
158
- def _int(v) -> int:
159
- try:
160
- return int(v)
161
- except (TypeError, ValueError):
162
- return -1
163
-
164
-
165
- # 生效条件:items 为 docindex 口径条目序列、transcript_root 为转写根、src 为日志真源身份;
166
- # 返回 {new/overwritten/unchanged/blocked 计数, ids, rows, sens, encrypted};
167
- # dry_run 为真时只判定不写库。
168
- def write_session(cg, items, *, transcript_root: str, src: dict, session: str,
169
- workspace: str, session_uuid: str, kind: str = KIND,
170
- rel_of=None, dry_run: bool = False) -> dict:
171
- """把一个会话的转写区间条目落库(真源身份挂在 `doc_ref.src`)。
172
-
173
- · `items` 的 `path` 一律改写成 `rel_of(workspace, session_uuid)`——即转写文件
174
- **相对转写根**的真实位置(`<ws>/<sid>/<sid>.md`),`doc_ref.root` = 转写根:
175
- 这样 `read_ref(doc_ref)` 的 `join(root, path)` 才落在转写上。裸文件名口径
176
- 在「同 sid 跨工作区」时会撞 id 且回读指错文件,故缺省即改写。
177
- · 逐条先过 `node_state`:`blocked` 的**不写**(fail-closed,原因透出),
178
- 其余(new / overwrite)交给 `refindex.add_items`(落盘细节与生产同源)。
179
- · 密级**跟源**:`docindex.sensitivity_for(src["path"], None)` —— 真源路径判,
180
- 只可能更严;落在加密档的条数单独计数(`encrypted`)由调用方告警:v1.0 曾
181
- 误标 private 触发加密致检索零命中,静默复现是不可接受的。
182
- 不改调用方传入的 `items`(内部逐条复制)。
183
- """
184
- if kind != KIND:
185
- raise ValueError("logref 只服务日志转写(kind=%r)" % KIND)
186
- rel_of = rel_of or default_rel_of
187
- rel = rel_of(workspace, session_uuid)
188
- plan, keep = [], []
189
- for it in items or []:
190
- it2 = dict(it)
191
- it2["path"] = rel
192
- st = node_state(cg, it2, kind=kind)
193
- plan.append(st)
194
- if st["state"] in WRITE_STATES:
195
- keep.append(it2)
196
- sens, _why = _docindex().sensitivity_for((src or {}).get("path") or "", None)
197
- enc = _encrypted_levels()
198
- rows = [{"id": st["id"], "state": st["state"], "reason": st.get("reason"),
199
- "heading_path": (it.get("heading_path") or []),
200
- "lineno": _int(it.get("lineno")), "end": _int(it.get("end")),
201
- "hash": it.get("hash")}
202
- for it, st in zip(items or [], plan)]
203
- out = {
204
- "transcript_root": transcript_root, "rel": rel,
205
- "items": len(items or []),
206
- "new": [st["id"] for st in plan if st["state"] == "new"],
207
- "overwritten": [st["id"] for st in plan if st["state"] == "overwrite"],
208
- "overwritten_no_ref": len([st for st in plan
209
- if st.get("reason") == "no_ref"]),
210
- "unchanged": [st["id"] for st in plan if st["state"] == "unchanged"],
211
- "blocked": [{"id": st["id"], "error": st.get("error")}
212
- for st in plan if st["state"] == "blocked"],
213
- "rows": rows, "sensitivity": sens, "sens": {}, "src_sensitivity": sens,
214
- "encrypted": 0, "dry_run": bool(dry_run),
215
- }
216
- if dry_run or not keep:
217
- return out
218
-
219
- def _extra(it):
220
- return {"tags": ["dsh-log", "logsrc", "regenerable"]
221
- + ([f"ws:{workspace}"] if workspace else []),
222
- "attrs": {"session": session, "workspace": workspace,
223
- "dsh_session_uuid": session_uuid}}
224
-
225
- ids, sens_counts = refindex.add_items(
226
- cg, keep, kind=kind, root=transcript_root, sensitivity=sens,
227
- src_of=lambda it: src, extra_of=_extra)
228
- out["sens"] = sens_counts
229
- out["written"] = ids
230
- out["encrypted"] = sum(c for s, c in sens_counts.items() if s in enc)
231
- return out
232
-
233
-
234
- # 生效条件:无入参副作用;返回 docindex 模块(局部 import,避免模块级循环)。
235
- def _docindex():
236
- from . import docindex
237
- return docindex
238
-
239
-
240
- # 生效条件:无入参副作用;返回 at-rest 加密档位元组(crypto.ENCRYPTED_LEVELS)。
241
- def _encrypted_levels() -> tuple:
242
- from . import crypto
243
- return tuple(crypto.ENCRYPTED_LEVELS)
244
-
245
-
246
- # 生效条件:node 为 cg.get 取回的节点 dict(其余按无 ref 处理);with_src 缺省 False。
247
- # 返回 {ok, status, text/hash_match, src_verified, ...};真源块仅在 with_src 为真时给出。
248
- def read_index_node(node, *, with_src: bool = False, verify: str = "hash") -> dict:
249
- """节点 → 两层回读结果(区间层恒做,真源身份层按 `with_src` 显式开)。
250
-
251
- `with_src` 缺省 **False**:默认不 stat/哈希真源——每次检索命中都整读一遍大
252
- zstd 是不可能的代价。返回里恒带 `src_verified: false` 明示「本次未看真源」,
253
- 免得调用方把「没核」读成「核过且 ok」(与 `probe_src` 的 unverified 同源纪律)。
254
-
255
- 状态机(转写层):`ok` / `stale`(转写被重生成或源续写致内容变)⇒ **原样返回
256
- stale + 建议重跑落库,不自动覆写**;`dangling`(转写被系统清理)⇒ 返回
257
- `rematerialize` 指路离线工具——**服务态不做再生**(mcp_server 进程零写临时目录)。
258
- """
259
- kind, ref = refindex.ref_of(node)
260
- if not ref:
261
- return {"ok": False, "error": "该节点没有 code_ref/doc_ref(不是索引节点)"}
262
- out = refindex.read_ref(ref, ref_kind=kind)
263
- # read_ref 的非 ok 只有 dangling/unresolved/error,且**仅 dangling** 置 stale=True
264
- # (refindex.py:474-478)——故用 stale 位区分 dangling 与 unresolved,不猜。
265
- if out.get("ok"):
266
- out["status"] = "stale" if out.get("stale") else "ok"
267
- else:
268
- out["status"] = "dangling" if out.get("stale") else "unresolved"
269
- out["node_ref_kind"] = kind
270
- out["span_status"] = out["status"]
271
- out["src_verified"] = False
272
- if out["status"] == "stale":
273
- out["suggested_action"] = ("重跑落库(区间哈希已变:转写被重生成或日志续写);"
274
- "本函数不自动覆写")
275
- elif out["status"] == "dangling":
276
- out["rematerialize"] = "scripts/_mdcg_reindex_dshlogs.py --repair 1"
277
- out["note"] = ("服务态不写临时目录(不自动再生转写);回读落到转写文件行区间,"
278
- "转写缺失时用上述离线工具再生")
279
- if with_src:
280
- out["src"] = probe_src(ref, verify=verify)
281
- out["src_verified"] = bool((out["src"] or {}).get("hash_verified"))
282
- else:
283
- out["src_note"] = "本次未看真源(with_src=False):默认不 stat/哈希 zstd 日志"
284
- return out
285
-
286
-
287
- # 生效条件:cg 的节点带 doc_ref 且 ref['src']['file_hash'] 存在时按会话 src 水位判
288
- # 「是否需要重切」;返回 {sessions: {sid: {file_hash, changed, n}}}(纯只读)。
289
- def session_src_state(cg, *, tag: str = "logsrc") -> dict:
290
- """按**会话级 src 水位**报每条日志会话的真源哈希现状(P1 的增量口径)。
291
-
292
- 为什么不用 `refindex` 的 `ledger` 增量:`Ledger` 只在活库根开 `_refindex.json`,
293
- 且记的 rel 与改写后的 `doc_ref.path` 不同源(见 `node_state` docstring)。
294
- 日志一路的增量判据改由**节点自描述的 `doc_ref.src.file_hash`** 承担——
295
- 「某会话每个节点的 src 哈希都与当前真源相同」即无需 re-parse。
296
- """
297
- nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
298
- out = {}
299
- for nid, e in list(nodes.items()):
300
- if tag not in ((e or {}).get("tags") or []):
301
- continue
302
- try:
303
- node = cg.get(nid)
304
- except Exception:
305
- continue
306
- if not node:
307
- continue
308
- _k, ref = refindex.ref_of(node)
309
- src = (ref or {}).get("src") if isinstance(ref, dict) else None
310
- if not isinstance(src, dict):
311
- continue
312
- ws = src.get("workspace") or ""
313
- sid = src.get("session_uuid") or ""
314
- key = f"{ws}/{sid}"
315
- row = out.setdefault(key, {"file_hash": src.get("file_hash"), "n": 0,
316
- "path": src.get("path")})
317
- row["n"] += 1
318
- if row["file_hash"] != src.get("file_hash"):
319
- row["file_hash"] = None # 同会话内哈希不一致:不判「未变」
320
- for row in out.values():
321
- row["changed"] = None
322
- if row.get("path"):
323
- try:
324
- row["changed"] = (row["file_hash"] != srcindex.file_hash(row["path"]))
325
- except OSError:
326
- row["changed"] = True
327
- return {"sessions": out}
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · 日志真源桥(P1):认知图 ref 节点 ↔ DSH 日志真源 / 确定性转写。
3
+
4
+ 真源身份与区间表的**唯一实现**在 `srcindex`(`session_src_id` / `log_units`)——
5
+ 本模块只做桥与读路径:把 `refindex` 的 ref 协议接到「日志真源 + 转写区间」上。
6
+ md_cg 侧**零路径常量、零 scripts 依赖**:转写根由调用方(scripts 侧)注入,
7
+ 单点仍在 `scripts/dsh_log_index.py:138/:514-516`;服务态因此不可能「自己决定
8
+ 把转写写到哪」(P2 的再生**不在服务态做**,见 `read_index_node`)。
9
+
10
+ 两层回读(方案 v0.3 §2、§9 裁定①):
11
+ 区间层 `refindex.read_ref(doc_ref)` → 转写文件行区间
12
+ 真源身份层 `srcindex.read_unit(src_unit(ref))` → zstd 日志本体(whole 粒度)
13
+
14
+ 生效条件:ref 为 `refindex` 写出的 doc_ref(含 path/root/hash),且 root(转写根)
15
+ 由调用方注入;`probe_src` 另需 `doc_ref.src` 且在 `MDCG_INGEST_ROOT` 白名单内。
16
+ 不适用条件:无 doc_ref 的节点(非索引节点);`src.path` 为空(`--src-path hash`
17
+ 降级)时无法探测真源——`probe_src` 如实返回 unresolved,不猜。
18
+ """
19
+ from __future__ import annotations
20
+
21
+ import os
22
+
23
+ from . import refindex, srcindex
24
+
25
+ #: 落库判据的两个状态名(`node_state` 的 state;其余状态见 docstring)
26
+ WRITE_STATES = ("new", "overwrite")
27
+ KIND = "doc_ref"
28
+
29
+
30
+ # 生效条件:path/workspace/session_id 为任意值(缺省按空串处理);返回
31
+ # "<workspace>/<session_id>/<session_id>.md"("/" 分隔,与 doc_ref.path 同形)。
32
+ def default_rel_of(workspace: str, session_id: str) -> str:
33
+ ws = (workspace or "").strip("/\\")
34
+ sid = (session_id or "").strip("/\\")
35
+ return "/".join(p for p in (ws, sid, sid + ".md") if p)
36
+
37
+
38
+ # 生效条件:无入参副作用;返回 doc_ref → srcindex whole 单位的 dict(真源身份层回读入参)。
39
+ def src_unit(ref: dict) -> dict:
40
+ """doc_ref → `srcindex` 的 whole 单位(真源身份层的回读入参,纯函数)。"""
41
+ src = (ref or {}).get("src")
42
+ src = src if isinstance(src, dict) else {}
43
+ return {"src": src, "span": {"unit": "whole"},
44
+ "span_hash": src.get("file_hash")}
45
+
46
+
47
+ # 生效条件:ref 为 dict(其余按 {} 处理);verify 取 "hash"(缺省,实核 sha256)或其它值
48
+ # (只做 size/mtime 快路径)。返回 status ∈ ok/stale/unverified/dangling/unresolved/denied
49
+ # 与 ok/hash_verified 布尔;无 src 子键或 src.path 为空时返回 unresolved(不抛 KeyError)。
50
+ def probe_src(ref: dict, *, verify: str = "hash") -> dict:
51
+ """探测真源(zstd 日志)状态——**与 ref 回读挂同一条根白名单闸**。
52
+
53
+ 为什么必须挂闸:frontmatter 是写入侧可塞的内容(`mdcg.py:1709 fm.update(extra)`),
54
+ 于是 `doc_ref.src.path` 与 `doc_ref.path` 一样是模型可控输入;本函数直接 stat
55
+ 并按需整读该文件。故走 `security.check_path_root(..., "MDCG_INGEST_ROOT", "src")`
56
+ ——与 `mcp_server.py:2939-2942` 给 ref 回读挂的是同一条闸(未配置=放开、
57
+ 配置=realpath 落根内否则拒,fail-closed)。
58
+
59
+ `verify="hash"`(缺省)时**必须**核 sha256 才算 ok:只对 (size, mtime) 相同只能
60
+ 给 `unverified`(fail-closed,巡检视为 not-ok)——否则「同长度同时间戳的替换」
61
+ 会静默通过。`hash_verified` 布尔用来区分「核过的 ok」与「没核的 ok」。
62
+ """
63
+ ref = ref or {}
64
+ src = ref.get("src")
65
+ src = src if isinstance(src, dict) else None
66
+ path = (src or {}).get("path") or ""
67
+ base = {"src": src, "path": path, "verify": verify,
68
+ "ok": False, "hash_verified": False}
69
+ if not src:
70
+ return {**base, "status": "unresolved",
71
+ "error": "该 ref 无 src 子键(不是日志真源索引节点),无法探测真源"}
72
+ if not path:
73
+ return {**base, "status": "unresolved",
74
+ "error": "src.path 为空(--src-path hash 降级:真源路径未落库)"
75
+ ",无法探测——不猜"}
76
+ if not os.path.isabs(path):
77
+ return {**base, "status": "unresolved",
78
+ "error": "src.path 是相对路径(--src-path rel 降级:dir 未落库),"
79
+ "无绝对根可解析——不猜"}
80
+ from .security import check_path_root
81
+ try:
82
+ check_path_root(path, "MDCG_INGEST_ROOT", "src")
83
+ except PermissionError as exc: # 拒读即 not-ok,绝不降级放行
84
+ return {**base, "status": "denied", "error": str(exc)[:300]}
85
+ if not os.path.isfile(path):
86
+ return {**base, "status": "dangling", "abspath": path,
87
+ "error": "真源不存在(索引已悬空):%s" % path}
88
+ expect = src.get("file_hash")
89
+ if verify == "hash":
90
+ if not expect:
91
+ return {**base, "status": "unverified", "abspath": path,
92
+ "error": "src.file_hash 缺失,无法核 hash(fail-closed:不计 ok)"}
93
+ # 整文件回读走 **P0 的唯一实现**(`srcindex.read_unit(whole)`)——不在这里
94
+ # 再写一份 sha256:与区域哈希同一条教训,两处算法会让「核过了」永远为真。
95
+ u = srcindex.read_unit(src_unit(ref))
96
+ if not u.get("ok"):
97
+ return {**base, "abspath": path, "status": "dangling",
98
+ "error": str(u.get("error"))[:200]}
99
+ match = bool(u.get("hash_match"))
100
+ return {**base, "abspath": path, "bytes": u.get("bytes"),
101
+ "hash": u.get("hash"), "hash_expected": expect,
102
+ "hash_match": match, "hash_verified": match,
103
+ "ok": match, "status": "ok" if match else "stale"}
104
+ try:
105
+ st = os.stat(path)
106
+ except OSError as exc:
107
+ return {**base, "status": "dangling", "abspath": path, "error": str(exc)[:200]}
108
+ same = (src.get("size") == st.st_size
109
+ and abs(float(src.get("mtime") or 0.0) - st.st_mtime) < 1e-6)
110
+ if same:
111
+ return {**base, "abspath": path, "status": "unverified",
112
+ "error": "仅 (size, mtime) 相同、未核 hash ⇒ 不计 ok(fail-closed)"}
113
+ return {**base, "abspath": path, "status": "stale",
114
+ "size": st.st_size, "mtime": st.st_mtime}
115
+
116
+
117
+ # 生效条件:it 为 docindex 口径条目、kind 默认 "doc_ref";返回 {id, state, ...},
118
+ # state ∈ new/unchanged/overwrite/blocked(blocked 带 error 原因)。
119
+ def node_state(cg, it: dict, *, kind: str = KIND) -> dict:
120
+ """单条条目的落库判据:**读节点自己的 doc_ref**,不读水位台账。
121
+
122
+ 判据 = `hash` 与 `lineno/end` **全等**才算已索引。为什么不看 id:
123
+ `docindex.node_id` 是 `path#heading_path` 寻址(docindex.py:294-299),
124
+ 同标题换正文时 **id 不变而 hash 变**——「id 撞即跳」会把漂移判成已索引、
125
+ 静默放过(N203 的静默正是这么来的)。
126
+ 为什么不看 `Ledger` 水位:水位在活库根、且记的 rel 与改写后的
127
+ `doc_ref.path` 不同源(refindex.py:302-317),开它就等于引一条会误判的
128
+ 快路径;真源增量改由节点自描述的 `doc_ref.src.file_hash` 承担。
129
+ """
130
+ nid = refindex.node_id_of(it, kind)
131
+ nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
132
+ if nid not in nodes:
133
+ return {"id": nid, "state": "new"}
134
+ try:
135
+ node = cg.get(nid)
136
+ except Exception as exc: # 读隔离/保护抛错 → 拦下,不越权覆写
137
+ return {"id": nid, "state": "blocked", "error": ("cg.get 抛错:%s" % exc)[:200]}
138
+ if not node:
139
+ return {"id": nid, "state": "blocked",
140
+ "error": "索引有条目但 cg.get 读不回(密级/保护)——fail-closed,不覆写"}
141
+ _k, ref = refindex.ref_of(node)
142
+ if not isinstance(ref, dict) or not ref:
143
+ # refindex.ref_of 对无 doc_ref 的节点返回 ('', None):覆写并**计数**(不静默)
144
+ return {"id": nid, "state": "overwrite", "reason": "no_ref"}
145
+ same = (ref.get("hash") == it.get("hash")
146
+ and _int(ref.get("lineno")) == _int(it.get("lineno"))
147
+ and _int(ref.get("end")) == _int(it.get("end")))
148
+ if same:
149
+ return {"id": nid, "state": "unchanged"}
150
+ return {"id": nid, "state": "overwrite", "reason": "hash_or_span",
151
+ "was": {"hash": ref.get("hash"), "lineno": _int(ref.get("lineno")),
152
+ "end": _int(ref.get("end"))},
153
+ "now": {"hash": it.get("hash"), "lineno": _int(it.get("lineno")),
154
+ "end": _int(it.get("end"))}}
155
+
156
+
157
+ # 生效条件:v 可转 int 时返回该 int,否则返回 -1(行位缺失/非法一律判不等,不抛)。
158
+ def _int(v) -> int:
159
+ try:
160
+ return int(v)
161
+ except (TypeError, ValueError):
162
+ return -1
163
+
164
+
165
+ # 生效条件:items 为 docindex 口径条目序列、transcript_root 为转写根、src 为日志真源身份;
166
+ # 返回 {new/overwritten/unchanged/blocked 计数, ids, rows, sens, encrypted};
167
+ # dry_run 为真时只判定不写库。
168
+ def write_session(cg, items, *, transcript_root: str, src: dict, session: str,
169
+ workspace: str, session_uuid: str, kind: str = KIND,
170
+ rel_of=None, dry_run: bool = False) -> dict:
171
+ """把一个会话的转写区间条目落库(真源身份挂在 `doc_ref.src`)。
172
+
173
+ · `items` 的 `path` 一律改写成 `rel_of(workspace, session_uuid)`——即转写文件
174
+ **相对转写根**的真实位置(`<ws>/<sid>/<sid>.md`),`doc_ref.root` = 转写根:
175
+ 这样 `read_ref(doc_ref)` 的 `join(root, path)` 才落在转写上。裸文件名口径
176
+ 在「同 sid 跨工作区」时会撞 id 且回读指错文件,故缺省即改写。
177
+ · 逐条先过 `node_state`:`blocked` 的**不写**(fail-closed,原因透出),
178
+ 其余(new / overwrite)交给 `refindex.add_items`(落盘细节与生产同源)。
179
+ · 密级**跟源**:`docindex.sensitivity_for(src["path"], None)` —— 真源路径判,
180
+ 只可能更严;落在加密档的条数单独计数(`encrypted`)由调用方告警:v1.0 曾
181
+ 误标 private 触发加密致检索零命中,静默复现是不可接受的。
182
+ 不改调用方传入的 `items`(内部逐条复制)。
183
+ """
184
+ if kind != KIND:
185
+ raise ValueError("logref 只服务日志转写(kind=%r)" % KIND)
186
+ rel_of = rel_of or default_rel_of
187
+ rel = rel_of(workspace, session_uuid)
188
+ plan, keep = [], []
189
+ for it in items or []:
190
+ it2 = dict(it)
191
+ it2["path"] = rel
192
+ st = node_state(cg, it2, kind=kind)
193
+ plan.append(st)
194
+ if st["state"] in WRITE_STATES:
195
+ keep.append(it2)
196
+ sens, _why = _docindex().sensitivity_for((src or {}).get("path") or "", None)
197
+ rows = [{"id": st["id"], "state": st["state"], "reason": st.get("reason"),
198
+ "heading_path": (it.get("heading_path") or []),
199
+ "lineno": _int(it.get("lineno")), "end": _int(it.get("end")),
200
+ "hash": it.get("hash")}
201
+ for it, st in zip(items or [], plan)]
202
+ out = {
203
+ "transcript_root": transcript_root, "rel": rel,
204
+ "items": len(items or []),
205
+ "new": [st["id"] for st in plan if st["state"] == "new"],
206
+ "overwritten": [st["id"] for st in plan if st["state"] == "overwrite"],
207
+ "overwritten_no_ref": len([st for st in plan
208
+ if st.get("reason") == "no_ref"]),
209
+ "unchanged": [st["id"] for st in plan if st["state"] == "unchanged"],
210
+ "blocked": [{"id": st["id"], "error": st.get("error")}
211
+ for st in plan if st["state"] == "blocked"],
212
+ "rows": rows, "sensitivity": sens, "sens": {}, "src_sensitivity": sens,
213
+ "encrypted": 0, "dry_run": bool(dry_run),
214
+ }
215
+ if dry_run or not keep:
216
+ return out
217
+
218
+ def _extra(it):
219
+ return {"tags": ["dsh-log", "logsrc", "regenerable"]
220
+ + ([f"ws:{workspace}"] if workspace else []),
221
+ "attrs": {"session": session, "workspace": workspace,
222
+ "dsh_session_uuid": session_uuid}}
223
+
224
+ ids, sens_counts = refindex.add_items(
225
+ cg, keep, kind=kind, root=transcript_root, sensitivity=sens,
226
+ src_of=lambda it: src, extra_of=_extra)
227
+ out["sens"] = sens_counts
228
+ out["written"] = ids
229
+ out["encrypted"] = sum(c for s, c in sens_counts.items() if _is_enc(s))
230
+ return out
231
+
232
+
233
+ # 生效条件:无入参副作用;返回 docindex 模块(局部 import,避免模块级循环)。
234
+ def _docindex():
235
+ from . import docindex
236
+ return docindex
237
+
238
+
239
+ # 生效条件:无入参副作用;返回 at-rest 加密档位元组(crypto.ENCRYPTED_LEVELS)。
240
+ def _encrypted_levels() -> tuple:
241
+ from . import crypto
242
+ return tuple(crypto.ENCRYPTED_LEVELS)
243
+
244
+
245
+ # 生效条件:level 经 crypto.is_encrypted_level 判为加密档时返回 True(全仓唯一谓词)。
246
+ def _is_enc(level) -> bool:
247
+ from . import crypto
248
+ return crypto.is_encrypted_level(level)
249
+
250
+
251
+ # 生效条件:node 为 cg.get 取回的节点 dict(其余按无 ref 处理);with_src 缺省 False。
252
+ # 返回 {ok, status, text/hash_match, src_verified, ...};真源块仅在 with_src 为真时给出。
253
+ def read_index_node(node, *, with_src: bool = False, verify: str = "hash") -> dict:
254
+ """节点 → 两层回读结果(区间层恒做,真源身份层按 `with_src` 显式开)。
255
+
256
+ `with_src` 缺省 **False**:默认不 stat/哈希真源——每次检索命中都整读一遍大
257
+ zstd 是不可能的代价。返回里恒带 `src_verified: false` 明示「本次未看真源」,
258
+ 免得调用方把「没核」读成「核过且 ok」(与 `probe_src` 的 unverified 同源纪律)。
259
+
260
+ 状态机(转写层):`ok` / `stale`(转写被重生成或源续写致内容变)⇒ **原样返回
261
+ stale + 建议重跑落库,不自动覆写**;`dangling`(转写被系统清理)⇒ 返回
262
+ `rematerialize` 指路离线工具——**服务态不做再生**(mcp_server 进程零写临时目录)。
263
+ """
264
+ kind, ref = refindex.ref_of(node)
265
+ if not ref:
266
+ return {"ok": False, "error": "该节点没有 code_ref/doc_ref(不是索引节点)"}
267
+ out = refindex.read_ref(ref, ref_kind=kind)
268
+ # read_ref 的非 ok 只有 dangling/unresolved/error,且**仅 dangling** 置 stale=True
269
+ # (refindex.py:474-478)——故用 stale 位区分 dangling 与 unresolved,不猜。
270
+ if out.get("ok"):
271
+ out["status"] = "stale" if out.get("stale") else "ok"
272
+ else:
273
+ out["status"] = "dangling" if out.get("stale") else "unresolved"
274
+ out["node_ref_kind"] = kind
275
+ out["span_status"] = out["status"]
276
+ out["src_verified"] = False
277
+ if out["status"] == "stale":
278
+ out["suggested_action"] = ("重跑落库(区间哈希已变:转写被重生成或日志续写);"
279
+ "本函数不自动覆写")
280
+ elif out["status"] == "dangling":
281
+ out["rematerialize"] = "scripts/_mdcg_reindex_dshlogs.py --repair 1"
282
+ out["note"] = ("服务态不写临时目录(不自动再生转写);回读落到转写文件行区间,"
283
+ "转写缺失时用上述离线工具再生")
284
+ if with_src:
285
+ out["src"] = probe_src(ref, verify=verify)
286
+ out["src_verified"] = bool((out["src"] or {}).get("hash_verified"))
287
+ else:
288
+ out["src_note"] = "本次未看真源(with_src=False):默认不 stat/哈希 zstd 日志"
289
+ return out
290
+
291
+
292
+ # 生效条件:cg 的节点带 doc_ref 且 ref['src']['file_hash'] 存在时按会话 src 水位判
293
+ # 「是否需要重切」;返回 {sessions: {sid: {file_hash, changed, n}}}(纯只读)。
294
+ def session_src_state(cg, *, tag: str = "logsrc") -> dict:
295
+ """按**会话级 src 水位**报每条日志会话的真源哈希现状(P1 的增量口径)。
296
+
297
+ 为什么不用 `refindex` 的 `ledger` 增量:`Ledger` 只在活库根开 `_refindex.json`,
298
+ 且记的 rel 与改写后的 `doc_ref.path` 不同源(见 `node_state` docstring)。
299
+ 日志一路的增量判据改由**节点自描述的 `doc_ref.src.file_hash`** 承担——
300
+ 「某会话每个节点的 src 哈希都与当前真源相同」即无需 re-parse。
301
+ """
302
+ nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
303
+ out = {}
304
+ for nid, e in list(nodes.items()):
305
+ if tag not in ((e or {}).get("tags") or []):
306
+ continue
307
+ try:
308
+ node = cg.get(nid)
309
+ except Exception:
310
+ continue
311
+ if not node:
312
+ continue
313
+ _k, ref = refindex.ref_of(node)
314
+ src = (ref or {}).get("src") if isinstance(ref, dict) else None
315
+ if not isinstance(src, dict):
316
+ continue
317
+ ws = src.get("workspace") or ""
318
+ sid = src.get("session_uuid") or ""
319
+ key = f"{ws}/{sid}"
320
+ row = out.setdefault(key, {"file_hash": src.get("file_hash"), "n": 0,
321
+ "path": src.get("path")})
322
+ row["n"] += 1
323
+ if row["file_hash"] != src.get("file_hash"):
324
+ row["file_hash"] = None # 同会话内哈希不一致:不判「未变」
325
+ for row in out.values():
326
+ row["changed"] = None
327
+ if row.get("path"):
328
+ try:
329
+ row["changed"] = (row["file_hash"] != srcindex.file_hash(row["path"]))
330
+ except OSError:
331
+ row["changed"] = True
332
+ return {"sessions": out}