@furongjun1999/dsh-memory 0.8.1 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  529. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  530. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  531. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  533. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  534. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  537. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  541. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  542. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  543. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  544. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  545. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  546. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  547. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  548. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  549. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  550. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  551. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  552. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  553. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  554. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  558. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  559. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  562. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  563. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  564. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  565. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  566. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  567. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  568. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  569. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  570. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  571. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  572. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/md_cg/sources.py CHANGED
@@ -48,6 +48,15 @@ class Source:
48
48
 
49
49
  name = "source"
50
50
 
51
+ #: #466:**来源声明面**(本件新增)。外部内容经 ingest 落库时,基底/密级取自来源声明,
52
+ #: 不再由写入点硬编码——「同一份外部文本走不同链得到不同基底」的根因就是硬编码。
53
+ #: 基底缺省 `untrusted`:在 `nodefile.VERIFICATION_BASIS`(**可接受集**)内,
54
+ #: 但**不在** `forgetting.VERIFIED_BASES`(**已验**集)里,也不在理科/文科两档内——
55
+ #: 外部内容本就不应作为可信基底进入权威记忆。
56
+ #: 密级缺省 `internal`(**本件不降级**:降 public 会放宽外带面,与本件方向相反)。
57
+ default_basis = "untrusted"
58
+ default_sensitivity = "internal"
59
+
51
60
  # 生效条件:任何调用都直接 raise NotImplementedError(基类占位,无其它分支)。
52
61
  def events(self):
53
62
  raise NotImplementedError
@@ -68,6 +77,9 @@ class JsonlSource(Source):
68
77
  text_key —— 文本字段(默认 "text")
69
78
  """
70
79
 
80
+ default_basis = "untrusted" # #466:外部 JSONL 会话 ⇒ 未验基底
81
+ default_sensitivity = "internal"
82
+
71
83
  # 生效条件:传入 path;name 为假值(None/空串)时回落为 "jsonl:"+os.path.basename(path),t_key/role_key/text_key/default_role 原样存为属性(默认值 "time"/"role"/"text"/"user")。
72
84
  def __init__(self, path: str, name: str = None, t_key="time", role_key="role",
73
85
  text_key="text", default_role="user"):
@@ -140,6 +152,9 @@ class DSHSessionSource(Source):
140
152
  tool/result → role=tool-output
141
153
  """
142
154
 
155
+ default_basis = "untrusted" # #466:外部会话转录 ⇒ 未验基底
156
+ default_sensitivity = "internal"
157
+
143
158
  # 生效条件:传入 path 即成立,include_reasoning 原样存为属性(默认 False),name 固定为 "dsh:"+os.path.basename(os.path.dirname(path))。
144
159
  def __init__(self, path: str, include_reasoning: bool = False):
145
160
  self.path = path
@@ -289,6 +304,11 @@ class HiveJobsSource(Source):
289
304
 
290
305
  name = "hive_jobs"
291
306
 
307
+ #: #466:hive 任务面同为**外部**内容 ⇒ 基底缺省 untrusted;
308
+ #: 密级保持 internal **不变**(本件不带宽外带面),只是改为可声明。
309
+ default_basis = "untrusted"
310
+ default_sensitivity = "internal"
311
+
292
312
  def __init__(self, root: str, error_sensitivity: str = "private"):
293
313
  self.root = os.path.abspath(root)
294
314
  self.skipped = 0
@@ -519,20 +539,32 @@ class Ingestor:
519
539
  f"{ev.get('session')}:{ev.get('seq')}")[:10])
520
540
  if nid in self.cg.index["nodes"]:
521
541
  continue # 幂等
542
+ # #466(Lead 裁定):基底取自**来源声明**(事件级 basis 优先,否则源级
543
+ # default_basis)。取值主体是形参 `source`(= Source 实例)、**不是 `self`**:
544
+ # 本方法是 `Ingestor.ingest(self, source, …)`,Ingestor 只是**搬运者**、不该
545
+ # 自己声明基底。写 `self.default_basis` 会让 Ingestor 无此属性 ⇒ AttributeError,
546
+ # 且被下方 except Exception 吞成 denied 计数 ⇒ **外部内容静默不落库**
547
+ # (2026-10-15 回归事故根因)。
548
+ # ★两条通道**必须同源**:CCG 正文行的「验证方式:」与 fm 的
549
+ # verification_basis 共用**同一个 basis 变量**——正文声明可验、枚举说未验
550
+ # 会让同一节点自相矛盾(守卫 H01 钉这一点)。
551
+ basis = ev.get("basis") or source.default_basis
522
552
  body = ("# 功能名:会话事件\n"
523
553
  f"# 生效条件:检索「{str(ev.get('text'))[:20]}」\n"
524
554
  "# 子功能:记录会话事件\n"
525
555
  f"# 执行:{str(ev.get('text'))[:80]}\n"
526
- "# 验证方式:data(会话原始记录)\n"
556
+ f"# 验证方式:{basis}(会话原始记录)\n"
527
557
  "# 不适用条件:其它会话\n\n"
528
558
  f"{ev.get('text')}\n")
559
+
529
560
  try:
530
561
  self.cg.add(nid, body, layer=self.layer, role=ev.get("role"),
531
562
  tags=["session", key],
532
563
  # 事件级密级覆盖(M6 §5.5):error 事件建议 private
533
564
  # (失败细节可能含路径/配置),缺省回落源级默认
534
565
  sensitivity=ev.get("sensitivity") or self.sensitivity,
535
- verification_basis="data",
566
+ # #466:不再硬编码 "data"(外部内容不得自带权威基底)。
567
+ verification_basis=basis,
536
568
  condition_space={"observation_position": key,
537
569
  "observation_tool": "会话流",
538
570
  "time_window": [ev.get("t") or 0,
@@ -623,6 +655,176 @@ def dispatch_of(path: str):
623
655
  return INGEST_REGISTRY.get(os.path.splitext(path or "")[1].lower())
624
656
 
625
657
 
658
+ # --------------------------------------------------------------------------
659
+ # 库内路径闸(issue #425):库内节点文件 / 回收站 / 保护历史**不是外部文档**
660
+ # --------------------------------------------------------------------------
661
+ # 病象:`ingest dir path=<库根>` 或 `ingest file path=trash/<id>.md` 时,遍历把
662
+ # 各层节点文件、回收站、保护历史当外部 md 重新切成 doc_* 节点——
663
+ # · restricted 节点正文被抄进 internal 节点(无令牌访客可检索);
664
+ # · 已 forget+accept 删除的节点从 trash/ 复活成活节点。
665
+ # 根因(条件层):摄取链只判「path 非空」,不判「它是不是记忆库自己」;而 doc 节点
666
+ # 的密级判据(`docindex.sensitivity_for`)只看路径段,源节点 frontmatter 里的
667
+ # `sensitivity: restricted` 根本不参与 ⇒ 重索引必然降级。库内节点文件的密级真源
668
+ # 是节点 frontmatter(`cg.get` 面),**不是**路径——本链不读它,故这里 **fail-closed**:
669
+ # 库根本身、各层目录、trash/、_protected_history/、hippocampus/ 一律拒绝/剪枝,
670
+ # 不猜、不降级。库根下**普通子目录**仍可作为外部资料根(保留既有用法)。
671
+ # 姊妹判据:export 侧已有 `security.check_export_target`(#211),本闸是 ingest 侧对应的一道。
672
+
673
+ #: 库根下不得被 ingest 当外部文档的子树(相对库根首段)。
674
+ #: 层目录从 `mdcg.LAYERS` 取(唯一真源),不在此复制一份。
675
+ _LIBRARY_EXTRA_RESERVED = ("trash", "_protected_history", "hippocampus",
676
+ "_index_log", "export")
677
+
678
+
679
+ def library_reserved_dirs():
680
+ """库根下保留子树的首段名(层目录 + 回收站/保护历史/海马体等)。
681
+
682
+ 层目录**只从 `mdcg.LAYERS` 取**(唯一真源,不在此复制一份);取不到即
683
+ fail-closed 抛错——宁可本次摄取失败,也不静默放宽成「层目录可被当外部文档」。
684
+ """
685
+ from .mdcg import LAYERS as _LAYERS
686
+ return tuple(_LAYERS) + _LIBRARY_EXTRA_RESERVED
687
+
688
+
689
+ def library_rel(cg, path):
690
+ """path 相对记忆库根的路径(正斜杠);不在库内返回 None,等于库根返回 ""。
691
+
692
+ realpath + normcase 后比较:符号链接/大小写不改变「是否库内」的结论。
693
+ """
694
+ root = getattr(cg, "root", None)
695
+ if not root or not path or not str(path).strip():
696
+ return None
697
+ try:
698
+ lib = os.path.normcase(os.path.realpath(root))
699
+ real = os.path.normcase(os.path.realpath(os.path.expanduser(str(path))))
700
+ except (OSError, ValueError):
701
+ return None
702
+ if real == lib:
703
+ return ""
704
+ if real.startswith(lib.rstrip(os.sep) + os.sep):
705
+ return os.path.relpath(real, lib).replace("\\", "/")
706
+ return None
707
+
708
+
709
+ def library_reserved(cg, rel):
710
+ """相对库根的路径是否落在保留子树(含库根本身)——这些不是外部文档。"""
711
+ if rel is None:
712
+ return False
713
+ if rel == "":
714
+ return True
715
+ return rel.replace("\\", "/").split("/")[0] in library_reserved_dirs()
716
+
717
+
718
+ def library_skip_rel(cg, root):
719
+ """root 是库根**祖先**时,返回库根相对 root 的路径(遍历时整枝剪掉);否则 None。
720
+
721
+ issue #425 C7:`MDCG_INGEST_ROOT` 设成库根上级目录时,`dir` 空 path 会从上级
722
+ 开始 walk,把整个记忆库扫进来。剪枝比「逐文件判」便宜且不漏(层目录、trash、
723
+ _protected_history 都在库根之下)。
724
+ """
725
+ try:
726
+ lib = os.path.normcase(os.path.realpath(cg.root))
727
+ r = os.path.normcase(os.path.realpath(root))
728
+ except (OSError, ValueError):
729
+ return None
730
+ if lib == r:
731
+ return None
732
+ rel = os.path.relpath(lib, r).replace("\\", "/")
733
+ if rel == ".." or rel.startswith("../"):
734
+ return None
735
+ return rel
736
+
737
+
738
+ # 生效条件:cg 无 root 或 path 为空时返回 None(无路径参数不判);否则按 realpath 判——path 等于库根或落在库根保留子树(层目录/trash/_protected_history/hippocampus 等)内时返回 ok=False 的拒绝回执(error 点名 issue #425 与原因);库外或库根下普通子目录返回 None(放行)。
739
+ def library_ingest_guard(cg, path, what="ingest"):
740
+ """库内路径闸的**单点**判定(issue #425):返回拒绝回执或 None。"""
741
+ rel = library_rel(cg, path)
742
+ if not library_reserved(cg, rel):
743
+ return None
744
+ where = "记忆库根" if rel == "" else f"记忆库保留子树「{rel.split('/')[0]}」"
745
+ return {"ok": False, "path": path, "error": (
746
+ f"{what} 拒绝:{path} 落在{where}内——库内节点文件/回收站/保护历史"
747
+ f"**不是外部文档**(issue #425:重新索引会把 restricted 正文抄成 internal、"
748
+ f"把已删除节点复活)。外部资料请放在**库根之外**的根再摄取"
749
+ f"(设 MDCG_INGEST_ROOT);库内节点的维护/重建不走 ingest 面。")}
750
+
751
+
752
+ # --------------------------------------------------------------------------
753
+ # 来源密级继承(issue #452):判据面必须同时看**绝对路径**与相对路径的段
754
+ # --------------------------------------------------------------------------
755
+ # 病象:`docindex.index_dir` 产出的 item["path"] 是**相对被摄取根**的;而
756
+ # `refindex.add_items` 用 `docindex.sensitivity_for(it["path"])` 判密级。
757
+ # 当**摄取根本身就是敏感目录**(`ingest(path=<…>/private)`)时,`private` 这一段
758
+ # 正是 root 自身,被 relpath 抹掉 ⇒ 提示永远命中不了,敏感文档以 internal 落库,
759
+ # internal 档身份读得回其正文摘要。同一内容换成父目录摄取则正确判 private 并
760
+ # fail-closed——同一份文档、同一个写者,只因 path 参数不同而一紧一松。
761
+ #
762
+ # 根因(条件层):判据的**输入面**取错了路径(相对路径丢了根自身的段),
763
+ # 不是 sensitivity_for 的实现有问题。故修法:判据仍只有 `docindex.sensitivity_for`
764
+ # 一处,但喂给它的是**源文件的绝对路径**(绝对路径的段集合 ⊇ 相对路径的段集合,
765
+ # 只会更严、不会更松)。item["path"] 保持相对 root 不变——节点 id / doc_ref 的
766
+ # 稳定标识与回读口径不受影响(换 id 会动存量幂等,不在本条范围)。
767
+ def source_sensitivity(path, explicit=None):
768
+ """源文件密级判据的**唯一取值点**(issue #452):路径面取绝对路径。
769
+
770
+ 判据本体仍只有 `docindex.sensitivity_for` 一处;本函数只补两件事:
771
+ ① **路径面**喂绝对路径(绝对路径的段集合 ⊇ 相对路径,只会更严);
772
+ ② **来源声明面**(issue #425 修复建议 3):源文件 frontmatter 里若带
773
+ `sensitivity`,取「路径判据」与「来源声明」中**更严**的一档——
774
+ 否则把一份 restricted 节点文件复制到库外再摄取,密级就凭空降成
775
+ internal(「删掉的比留下的更泄露」同族)。缺键/值域非法时不猜,
776
+ 按路径判据(既有语义);库内节点文件由 `library_ingest_guard` 直接拒,
777
+ 走不到这里。
778
+ """
779
+ from . import docindex, nodefile
780
+ from .security import SENSITIVITY_ORDER
781
+ s, _basis = docindex.sensitivity_for(path, explicit)
782
+ cands = [s]
783
+ try:
784
+ with open(path, encoding="utf-8", errors="replace") as f:
785
+ fm, _content = nodefile.loads(f.read())
786
+ except (OSError, ValueError):
787
+ fm = {}
788
+ fm_s = fm.get("sensitivity") if isinstance(fm, dict) else None
789
+ if isinstance(fm_s, str) and fm_s in SENSITIVITY_ORDER:
790
+ cands.append(fm_s)
791
+ return max(cands, key=SENSITIVITY_ORDER.index)
792
+
793
+
794
+ def add_items_with_source_sensitivity(cg, items, *, kind, root, layer=None,
795
+ sensitivity=None, conflicts=None):
796
+ """按**来源文件**分组调 `refindex.add_items`,每组带该文件继承来的密级。
797
+
798
+ `refindex.add_items` 只接受一个批次级 `sensitivity`,而密级提示可能落在
799
+ **被摄取根自身**的名字上(#452)。故按 item["path"](相对 root 的源文件路径)
800
+ 分组,每组以 `source_sensitivity(join(root, rel), sensitivity)` 作为该组的
801
+ 密级——判据仍是 `docindex.sensitivity_for` 单点,只是输入面补上了绝对路径。
802
+ doc 之外(code_ref)不涉密级继承,保持原批次一次调用。
803
+ 返回 `(ids, sens_counts)`,与 `refindex.add_items` 同形。
804
+ """
805
+ from . import refindex
806
+ if kind != "doc_ref" or not items:
807
+ return refindex.add_items(cg, items, kind=kind, root=root, layer=layer,
808
+ sensitivity=sensitivity, conflicts=conflicts)
809
+ groups = {}
810
+ for it in items:
811
+ groups.setdefault(it.get("path") or "", []).append(it)
812
+ if len(groups) <= 1:
813
+ rel = next(iter(groups), "")
814
+ s = source_sensitivity(os.path.join(root, rel), sensitivity) if rel else sensitivity
815
+ return refindex.add_items(cg, items, kind=kind, root=root, layer=layer,
816
+ sensitivity=s, conflicts=conflicts)
817
+ ids, sens = [], {}
818
+ for rel, grp in groups.items():
819
+ s = source_sensitivity(os.path.join(root, rel), sensitivity)
820
+ _ids, _sens = refindex.add_items(cg, grp, kind=kind, root=root, layer=layer,
821
+ sensitivity=s, conflicts=conflicts)
822
+ ids.extend(_ids)
823
+ for k, v in (_sens or {}).items():
824
+ sens[k] = sens.get(k, 0) + v
825
+ return ids, sens
826
+
827
+
626
828
  # 生效条件:required 形参 cg 总被存入;可选形参 sensitivity 为假值(None/空串)时内部 Ingestor 的 sensitivity 回落模块级常量 SESSION_SENSITIVITY,为真值时用传入的 sensitivity。
627
829
  class FileDispatcher:
628
830
  """单一入口吃多种文件:按扩展名分派到会话流 / 文档 / 代码三条摄取链。"""
@@ -669,6 +871,12 @@ class FileDispatcher:
669
871
  "supported": sorted(INGEST_REGISTRY)}
670
872
  if not os.path.isfile(path):
671
873
  return {"ok": False, "path": path, "error": "文件不存在"}
874
+ # issue #425:库内节点文件 / trash/<id>.md / _protected_history 快照
875
+ # **不是外部文档**——单文件链同样过闸(否则一条 file 摄取即可把
876
+ # restricted 正文抄成 internal,或把已删除节点复活)。
877
+ _g = library_ingest_guard(self.cg, path, "ingest file")
878
+ if _g is not None:
879
+ return _g
672
880
  if kind == "session":
673
881
  return self.ingest_jsonl(path, dry_run=dry_run)
674
882
  return self._ingest_doc_or_code(path, kind, layer=layer,
@@ -694,19 +902,33 @@ class FileDispatcher:
694
902
  "ids": [mod.node_id(i) for i in items[:20]],
695
903
  "note": "预演:只抽取计数,未写盘"}
696
904
  ref_kind = "code_ref" if kind == "code" else "doc_ref"
697
- ids, sens = refindex.add_items(
905
+ _cf = [] # #352-E:同 id 已被另一个源根占用 ⇒ 不覆写
906
+ ids, sens = add_items_with_source_sensitivity(
698
907
  self.cg, items, kind=ref_kind,
699
908
  root=os.path.dirname(path) or ".", layer=layer,
700
- sensitivity=sensitivity)
701
- return {"ok": True, "kind": kind, "path": path, "items": len(items),
909
+ sensitivity=sensitivity, conflicts=_cf)
910
+ _out = {"ok": True, "kind": kind, "path": path, "items": len(items),
702
911
  "indexed": len(ids), "ids": ids[:20], "sensitivity": sens}
912
+ if _cf: # 冲突不静默(单文件链同样点名)
913
+ _out["conflict_count"] = len(_cf)
914
+ _out["conflicts"] = _cf[:20]
915
+ return _out
703
916
 
704
917
  # ---- 目录 ----
705
918
 
706
919
  # 生效条件:调用即 os.walk(root) 统计每个文件名经 dispatch_of 得到的 kind(无匹配记 "unsupported")并返回 dry_run 预演计数结果。
707
920
  def _dry_dir(self, root):
708
921
  counts = {}
709
- for _dp, _dn, fns in os.walk(root):
922
+ _lib_rel = library_skip_rel(self.cg, root) # issue #425 C7:库根整枝剪掉
923
+ for dp, dns, fns in os.walk(root):
924
+ rel_dir = os.path.relpath(dp, root).replace("\\", "/")
925
+ if rel_dir == ".":
926
+ rel_dir = ""
927
+ if _lib_rel is not None:
928
+ dns[:] = [d for d in dns
929
+ if ("%s/%s" % (rel_dir, d) if rel_dir else d) != _lib_rel
930
+ and not ("%s/%s" % (rel_dir, d) if rel_dir else d)
931
+ .startswith(_lib_rel + "/")]
710
932
  for name in fns:
711
933
  k = dispatch_of(name) or "unsupported"
712
934
  counts[k] = counts.get(k, 0) + 1
@@ -721,18 +943,35 @@ class FileDispatcher:
721
943
  from . import refindex
722
944
  if not os.path.isdir(root):
723
945
  return {"ok": False, "error": f"目录不存在:{root}"}
946
+ # issue #425:库根本身 / 层目录 / trash / _protected_history / hippocampus
947
+ # **不是外部文档**——直接拒绝(fail-closed),不猜扫描根。
948
+ _g = library_ingest_guard(self.cg, root, "ingest dir")
949
+ if _g is not None:
950
+ return _g
724
951
  if dry_run:
725
952
  return self._dry_dir(root)
953
+ # issue #425 C7:root 是库根**祖先**时整枝剪掉库根(与 SKIP_DIRS 同处生效)。
954
+ _lib_rel = library_skip_rel(self.cg, root)
955
+ _skip = [_lib_rel] if _lib_rel else None
726
956
  ledger = refindex.Ledger(self.cg.root)
727
957
  out = {"ok": True, "kind": "dir", "root": root, "chains": {}}
958
+ if _lib_rel:
959
+ out["library_pruned"] = [_lib_rel]
728
960
  for ref_kind, key in (("doc_ref", "doc"), ("code_ref", "code")):
729
961
  items, errors, stats = refindex.index_dir(
730
962
  root, kind=ref_kind, patterns=patterns, max_files=max_files,
731
963
  max_items=max_items, incremental=incremental, ledger=ledger,
732
- commit=False)
733
- ids, sens = refindex.add_items(self.cg, items, kind=ref_kind,
734
- root=root, layer=layer,
735
- sensitivity=sensitivity)
964
+ skip_dirs=_skip, commit=False)
965
+ _cf = [] # #352-E:同 id 已被另一个源根占用 ⇒ 不覆写
966
+ # issue #452:按来源文件继承密级(判据面补上绝对路径的段)。
967
+ ids, sens = add_items_with_source_sensitivity(
968
+ self.cg, items, kind=ref_kind,
969
+ root=root, layer=layer,
970
+ sensitivity=sensitivity,
971
+ conflicts=_cf)
972
+ for _c in _cf: # 冲突源文件的水位一并丢掉(否则下次增量跳过)
973
+ ledger.drop(_c.get("src")
974
+ or os.path.join(root, _c.get("path") or ""))
736
975
  # 写序(同 op=index_code/index_doc):节点先落盘,水位随后——
737
976
  # 中途被杀只会留下「节点新 + 水位旧」,下次增量重切,不会静默漏漂移。
738
977
  ledger.save()
@@ -743,9 +982,14 @@ class FileDispatcher:
743
982
  "skipped_unchanged": stats.get("skipped_unchanged", 0),
744
983
  "skipped_suffixes": stats.get("skipped_suffixes", []),
745
984
  "sensitivity": sens}
746
- # 会话流(.jsonl)逐个增量摄取
747
- jsons = sorted(glob.glob(os.path.join(root, "**", "*.jsonl"),
748
- recursive=True))[:max_files]
985
+ if _cf: # #352-E:冲突不静默
986
+ out["chains"][key]["conflict_count"] = len(_cf)
987
+ out["chains"][key]["conflicts"] = _cf[:20]
988
+ # 会话流(.jsonl)逐个增量摄取——库内台账/回收站下的 jsonl 同样不是
989
+ # 外部会话(issue #425:`hippocampus/*.jsonl` 等库内账本不得被当会话源)。
990
+ jsons = [p for p in sorted(glob.glob(os.path.join(root, "**", "*.jsonl"),
991
+ recursive=True))[:max_files]
992
+ if not library_reserved(self.cg, library_rel(self.cg, p))]
749
993
  ses = []
750
994
  for p in jsons:
751
995
  r = self.ingest_jsonl(p)
@@ -770,10 +1014,13 @@ class FileDispatcher:
770
1014
  return DSHSessionSource(path)
771
1015
  return JsonlSource(path)
772
1016
 
773
- # 生效条件:path 不是文件时返回 ok=False 的「文件不存在」;否则经 _auto_source(path) 选源后调 self.ingestor.ingest(src, dry_run=dry_run, max_events=max_events),并补上 ok=True/kind/path/source_class 后返回。
1017
+ # 生效条件:path 不是文件时返回 ok=False 的「文件不存在」;path 落在记忆库保留子树(层目录/trash/_protected_history/hippocampus 等)内时返回 ok=False 的库内路径拒绝(issue #425);否则经 _auto_source(path) 选源后调 self.ingestor.ingest(src, dry_run=dry_run, max_events=max_events),并补上 ok=True/kind/path/source_class 后返回。
774
1018
  def ingest_jsonl(self, path, dry_run=False, max_events=None):
775
1019
  if not os.path.isfile(path):
776
1020
  return {"ok": False, "error": f"文件不存在:{path}"}
1021
+ _g = library_ingest_guard(self.cg, path, "ingest jsonl")
1022
+ if _g is not None:
1023
+ return _g
777
1024
  src = self._auto_source(path)
778
1025
  res = self.ingestor.ingest(src, dry_run=dry_run, max_events=max_events)
779
1026
  res.update({"ok": True, "kind": "session", "path": path,
@@ -796,7 +1043,18 @@ def run(cg, action: str = "stat", **kw):
796
1043
  sensitivity=kw.get("sensitivity"),
797
1044
  dry_run=bool(kw.get("dry_run")))
798
1045
  if act == "dir":
799
- p = kw.get("path") or cg.root
1046
+ # issue #351(2026-10-16 DSH 端):空 path **不得**回落记忆库根。库根下是
1047
+ # 各层节点文件、trash/、_protected_history/,把它们当外部文档切成 doc_ref
1048
+ # 节点会 (a) 把 restricted 正文抄进 internal 节点(无令牌访客可检索)、
1049
+ # (b) 把已 forget 并 accept 删除的节点复活。缺省根改由调用方显式给 path
1050
+ # 或设 env MDCG_INGEST_ROOT(分派层已在白名单检查之前解析)——这里
1051
+ # fail-closed,不猜扫描根。
1052
+ p = kw.get("path")
1053
+ if not p:
1054
+ return {"ok": False, "error": (
1055
+ "dir 动作需要 path(或设 env MDCG_INGEST_ROOT)——不猜测扫描根"
1056
+ "(issue #351:缺省回落记忆库根会把 restricted/已删除节点"
1057
+ "重新索引成 internal 并可被访客检索)")}
800
1058
  return d.ingest_dir(p, layer=kw.get("layer"),
801
1059
  sensitivity=kw.get("sensitivity"),
802
1060
  patterns=kw.get("patterns"),
@@ -14,11 +14,18 @@
14
14
  落盘位置与 `_evolution` 台账/审计同级:`<root>/_state_events.jsonl`)。
15
15
  · **五元结构**:主体 subject / 槽位 slot / 旧值 old → 新值 new / 轮或序号
16
16
  seq / 出处 evidence(+ kind 五类变迁事件 + actor 断言者 + t 时间戳)。
17
+ · **判据单点**(#383,2026-10-14):`old`/`new` 的「空」= `None` **或空白字符串**,
18
+ 判据本体只此一处(`is_void`,源模块);投影侧 `state_slots._is_void` **直接绑定
19
+ 本函数**(同一对象,不另立一份),写入口对裸值经 `void_value` 走同一条腿。
20
+ `old` 与 `new` **同空**(含 `""`/全空白串)=空事件 ⇒ ValueError,且校验先于
21
+ 建目录/写盘 ⇒ **零落盘**。
17
22
 
18
23
  KINDS 五类对齐《角色扮演一致性锚调研 v0.1》§3.4「变迁事件」:
19
24
  迁移 migration / 撤回 retraction / 启用 enablement / 购买获得 acquisition /
20
25
  替换 replacement。「撤回」语义:old 有值而 new 为空(值作废、无新值);
21
26
  「启用」:old 空而 new 有值;「迁移/替换」:old 与 new 皆有值。
27
+ 「空」= `None` **或空白字符串**(判据单点 `is_void`);old 与 new **同空**=空事件
28
+ (既非启用也非撤回)⇒ `append` 拒收,不落任何台账行。
22
29
  分类本身不进判据(记账不判语义),只作检索面标签。
23
30
  """
24
31
  from __future__ import annotations
@@ -42,6 +49,26 @@ _BAD_ROW_SAMPLES = [] # 有界样本:(行号, 行首 80 字符, 异常类型
42
49
  _BAD_ROW_SAMPLE_CAP = 8
43
50
 
44
51
 
52
+ #: 调用方可控字段的**逐字段字节上限**(issue #443:无长度约束 ⇒ 审计/台账面 1:1 写入放大)。
53
+ #: 取 8192 B:单条状态事件是「一次变迁的记录」,不是正文载体;超限即视为调用方用错面。
54
+ #: 与 writepipe.oversize_response 同口径——**拒写而不是截断**(截断后的记录看起来像完整记录,
55
+ #: 实际丢了内容 ⇒ 比不记录更坏,与 #523 的「假绿」同族)。
56
+ _MAX_FIELD_BYTES = 8192
57
+
58
+
59
+ # 生效条件:name 为字段名、v 为待落盘值;v 的 UTF-8 编码长度不超过 _MAX_FIELD_BYTES 时原样返回,
60
+ # 超限时抛 ValueError(消息含字段名、实测字节、上限),**不截断、不静默丢弃**。
61
+ def _bounded(name, v):
62
+ if v is None:
63
+ return v
64
+ raw = v if isinstance(v, (bytes, bytearray)) else str(v).encode('utf-8')
65
+ n = len(raw)
66
+ if n > _MAX_FIELD_BYTES:
67
+ raise ValueError(
68
+ f'状态事件字段 {name} 超出上限:{n} B > {_MAX_FIELD_BYTES} B(issue #443;拒写不截断)')
69
+ return v
70
+
71
+
45
72
  def _note_bad_row(lineno: int, line: str, exc: Exception):
46
73
  global BAD_ROWS
47
74
  BAD_ROWS += 1
@@ -57,8 +84,31 @@ def ledger_path(cg) -> str:
57
84
  return os.path.join(cg.root, STATE_EVENTS_NAME)
58
85
 
59
86
 
87
+ # 生效条件:rec 为台账记录 dict——`rec.get("new")` 为 None,或为字符串且 `str.strip()` 后为空(含全空白串)时返回 True(撤回/值作废);其余(非 None 且非空白字符串,含数字 0、False、非空串)返回 False;入参非 dict 时按 `.get` 抛 AttributeError(台账读面保证为 dict,不吞错)。
88
+ def is_void(rec) -> bool:
89
+ """撤回判据(**全仓唯一单点**):`rec["new"]` 无值(None 或空白串)=值作废、无新值。
90
+
91
+ #375(2026-10-14)在投影侧把判据从 `new is None` 放宽为「**None 或空白字符串**」;
92
+ #383(2026-10-14)把这**同一条腿**上收到源模块,成为全仓唯一判据本体。入参是
93
+ **台账记录**(行形态)——投影侧 `state_slots._is_void` 绑定本函数(同一对象,
94
+ 不另立一份),写入口对裸值经 `void_value` 适配同一条腿。台账行与 `history`
95
+ 条目的 `old`/`new` **原值一字不改**(值作废只发生在投影回放里,见 `_replay`)。
96
+ """
97
+ v = rec.get("new")
98
+ if v is None:
99
+ return True
100
+ return isinstance(v, str) and not v.strip()
101
+
102
+
103
+ # 生效条件:v 为待判的**裸值**(写入口的 old/new)——包成记录后走同一单点 `is_void`:v 为 None 或空白字符串时返回 True,其余(含数字 0、False、非空串)返回 False;不复制判据、不改写 v。
104
+ def void_value(v) -> bool:
105
+ """写入口的值面适配:裸值 → 同一单点 `is_void`(**不另立第二份判据**)。"""
106
+ return is_void({"new": v})
107
+
108
+
60
109
  # 生效条件:subject 与 slot 去空白后必须非空(否则 ValueError);kind 非 None 时必须属于
61
- # KINDS(否则 ValueError);old 与 new 不得同时为 None(否则 ValueError);通过后在
110
+ # KINDS(否则 ValueError);old 与 new 不得同时为**空**(None 或空白串,判据单点
111
+ # `void_value`,否则 ValueError——校验先于任何建目录/写盘,故零落盘);通过后在
62
112
  # FileLock(ledger_path) 内以追加模式写一行 JSON(ensure_ascii=False,flush+fsync),
63
113
  # 返回落盘记录 dict(不改任何既有文件、不读改写、不截断)。
64
114
  def append(cg, subject, slot, old=None, new=None, kind=None, seq=None,
@@ -72,8 +122,16 @@ def append(cg, subject, slot, old=None, new=None, kind=None, seq=None,
72
122
  raise ValueError("状态事件必须声明槽位(slot)")
73
123
  if kind is not None and kind not in KINDS:
74
124
  raise ValueError(f"未知变迁事件类型:{kind}(允许:{KINDS})")
75
- if old is None and new is None:
125
+ if void_value(old) and void_value(new):
76
126
  raise ValueError("状态事件 old 与 new 不能同时为空(空事件无意义)")
127
+ # issue #443:调用方可控字段逐字段过闸(拒写)。subject/slot 已在上面 strip,仍过闸
128
+ # (strip 只减首尾空白,不约束长度)。old/new 是本次放大的主因(各 1MB ⇒ 单次 2MB)。
129
+ sub = _bounded('subject', sub)
130
+ sl = _bounded('slot', sl)
131
+ old = _bounded('old', old)
132
+ new = _bounded('new', new)
133
+ evidence = _bounded('evidence', evidence)
134
+ actor = _bounded('actor', actor)
77
135
  rec = {
78
136
  "t": time.time(),
79
137
  "subject": sub,
@@ -97,16 +155,17 @@ def append(cg, subject, slot, old=None, new=None, kind=None, seq=None,
97
155
  return rec
98
156
 
99
157
 
100
- # 生效条件:ledger_path 不存在时返回 [];存在时逐行 json.loads(空行跳过;非对象载荷或
158
+ # 生效条件:ledger_path 不存在时不产出记录;存在时逐行 json.loads(空行跳过;非对象载荷或
101
159
  # JSON 解析失败按坏行处置——计数+有界样本+stderr 告警后跳过,不中断读);subject/slot/kind
102
- # **非 None** 时按对应字段过滤(空串亦为合法过滤值,2026-10-05 复核口径钉正);limit 为
103
- # 真值时只保留最后 limit 条;返回记录列表(落盘序)。
104
- def read(cg, subject=None, slot=None, kind=None, limit=0) -> list:
105
- """读回(可按 subject/slot/kind 过滤;limit=0 不截断)。坏行跳过并记账。"""
160
+ # **非 None** 时按对应字段过滤(空串亦为合法过滤值);按落盘序 yield,须消费至尾部才完成全部坏行计数。
161
+ def iter_read(cg, subject=None, slot=None, kind=None):
162
+ """逐行读回;过滤、坏行告警与计数与 read 共用此单点。
163
+
164
+ 调用者须消费完迭代器,才会观察到文件后部的坏行。额外内存只含一行。
165
+ """
106
166
  p = ledger_path(cg)
107
- out = []
108
167
  if not os.path.exists(p):
109
- return out
168
+ return
110
169
  with open(p, encoding="utf-8", errors="replace") as f:
111
170
  for i, line in enumerate(f, 1):
112
171
  line = line.strip()
@@ -125,7 +184,13 @@ def read(cg, subject=None, slot=None, kind=None, limit=0) -> list:
125
184
  continue
126
185
  if kind is not None and rec.get("kind") != kind:
127
186
  continue
128
- out.append(rec)
187
+ yield rec
188
+
189
+
190
+ # 生效条件:完整消费 iter_read 后返回列表;limit 为真值时保持原有 out[-int(limit):] 切片语义,含负数;缺失账本返回 []。
191
+ def read(cg, subject=None, slot=None, kind=None, limit=0) -> list:
192
+ """读回(可按 subject/slot/kind 过滤;limit=0 不截断)。坏行跳过并记账。"""
193
+ out = list(iter_read(cg, subject=subject, slot=slot, kind=kind))
129
194
  if limit:
130
195
  out = out[-int(limit):]
131
196
  return out