@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/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}