@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
@@ -39,9 +39,147 @@ write 的六道闸(audit 校验 / consistency 冲突 / review 审核 / gated
39
39
  覆盖不经本链的写入路径)。根因取证见 `_commit_visibility` 文档串。
40
40
  """
41
41
 
42
- from . import twophase, trust
42
+ # #142②(2026-10-12 DSH 端):尝试账本的模块级依赖 —— 记账点要用 os / sys / time 与
43
+ # fsutil.append_jsonl(追加原语,不另写第二份)。
44
+ import os
45
+ import sys
46
+ import time
47
+
48
+ from . import protect, twophase, trust
49
+ from .fsutil import append_jsonl, node_write_lock
50
+
51
+ __all__ = ["WritePipeline", "default_pipeline", "oversize_response",
52
+ "attempt_history"]
53
+
54
+
55
+ #: #142②(2026-10-12 DSH 端)· **写入尝试账本**(issue §3.3(e) 方案 1「另立一本账」)。
56
+ #: 被修的面:`_write_2pc.jsonl` 只覆盖「闸门全放行」与 gated 两条**真实落盘**路径,
57
+ #: 闸门短路出口(审核 REJECT / 入队 DEFER / 超限)在两段式账本上**零覆盖** ⇒
58
+ #: 「一次写入到底发生了什么」在短路面上无从回答。
59
+ #: 为什么**不**把短路补进 `_write_2pc.jsonl`(两条在役守卫各钉一条,改任一侧即红):
60
+ #: · `md_cg/test_twophase.py` ⑧2「未落盘的分支不产生 intent」——补进去即 34/1;
61
+ #: · `md_cg/test_write_return_shape.py::g_142_halt_2pc`「短路出口 2pc delta == 0」。
62
+ #: ⇒ 两本账各记各的:两段式(崩溃一致性)零漂移,尝试账本(出口可观测性)新增覆盖。
63
+ ATTEMPT_BASENAME = "_write_attempts"
64
+ #: 活动账本文件名(落在 cg.root 下,随记忆库一起备份/迁移)。
65
+ ATTEMPT_LOG_FILE = ATTEMPT_BASENAME + ".jsonl"
66
+ #: 归档分片目录(轮转=本账**有界性**的来源)。
67
+ ATTEMPT_ARCHIVE_DIR = "_write_attempts_archive"
68
+ #: 轮转阈值(字节)的 env 名与默认值:默认与审计面同口径 64 MiB,<=0 表示不轮转。
69
+ ATTEMPT_ROTATE_ENV = "MDCG_WRITE_ATTEMPT_ROTATE_BYTES"
70
+ ATTEMPT_ROTATE_DEFAULT = 64 << 20
71
+ #: outcome 三态(issue §3.3(e) 方案 1 的取值集)。与两段式四态**不同源**:
72
+ #: 本账回答「这次尝试停在哪个出口」,不回答「落盘是否完成」。
73
+ ATTEMPT_COMMITTED = "committed"
74
+ ATTEMPT_SHORT_CIRCUIT = "short_circuit"
75
+ ATTEMPT_ERROR = "error"
76
+
77
+ #: #212 缺口 3(2026-10-13 DSH 端):尝试账本的**总开关**。此前本账常开——
78
+ #: 运行时显式设 MDCG_WRITE_ATTEMPT_LEDGER=0,账本仍写一行(该 env 名全仓 0 命中,
79
+ #: 确实无效),且四个记账调用点全无条件 ⇒ 每次写入无条件付这笔开销(实测落盘
80
+ #: 1,013.3 B/次、短路 303.2 B/次)。
81
+ #: 缺省**开**:本账是**留痕面**(不改裁决/排序/资格),与 _audit.jsonl /
82
+ #: _write_2pc.jsonl 同口径;「默认关」纪律的适用对象是**行为性改动**(会改变
83
+ #: 裁决结果的那类,如 MDCG_PROPOSAL_EMOTION)。停用只停留痕,**不改写入语义**。
84
+ ATTEMPT_LEDGER_ENV = "MDCG_WRITE_ATTEMPT_LEDGER"
85
+ #: 有效缺省(G2 锚点符号,见 md_cg/config_registry_bulk.py 的登记行)。
86
+ ATTEMPT_LEDGER_DEFAULT = True
87
+
88
+ # 生效条件:env ATTEMPT_LEDGER_ENV 未设或为空白时返回 ATTEMPT_LEDGER_DEFAULT(True);
89
+ # 取值去空白并 lower 后属 0/false/no/off 时返回 False;其余取值一律 True。
90
+ def _attempt_ledger_enabled() -> bool:
91
+ """尝试账本总开关(缺省开,仅显式关闭值停用)。"""
92
+ raw = os.environ.get(ATTEMPT_LEDGER_ENV)
93
+ if raw is None or not str(raw).strip():
94
+ return bool(ATTEMPT_LEDGER_DEFAULT)
95
+ return str(raw).strip().lower() not in ("0", "false", "no", "off")
96
+
97
+
98
+ # 生效条件:env ATTEMPT_ROTATE_ENV 缺席或为空白时返回 ATTEMPT_ROTATE_DEFAULT;为可解析整数时返回该整数(<=0 表示不轮转);不可解析时回落 ATTEMPT_ROTATE_DEFAULT,配置坏值不导致丢账;
99
+ def _attempt_rotate_bytes() -> int:
100
+ """尝试账本的轮转阈值(字节)——env 可调,缺省与审计面同口径。"""
101
+ raw = os.environ.get(ATTEMPT_ROTATE_ENV)
102
+ if raw is None or not str(raw).strip():
103
+ return ATTEMPT_ROTATE_DEFAULT
104
+ try:
105
+ return int(str(raw).strip())
106
+ except (TypeError, ValueError):
107
+ return ATTEMPT_ROTATE_DEFAULT
108
+
109
+
110
+ # 生效条件:ATTEMPT_LEDGER_ENV 未停用(缺省开)时;按 outcome 组装一行尝试记录(t/outcome/id/resp_id + 非 None 的 content_kind/layer/halted_by/error/rotate_error),阈值>0 且活动账本已达阈值时先经 Rotator.rotate 切分活动账本、再 append_jsonl 追加;轮转失败**不丢账**(本行照记并如实留 rotate_error);**自身绝不外抛**——out 是 dict 时写 out["attempt_ledger_error"]、否则写 stderr(不静默、不改写写入语义);
111
+ def _append_attempt(cg, nid, a, outcome, halted_by=None, out=None, error=None):
112
+ """#142② 尝试账本的**唯一写入点**:把一次写入尝试的出口如实落一行(append-only)。
113
+
114
+ 两个 id 都在场(本字段集是本批的判据面,改一处即红):
115
+ · `id` —— **请求 id**(`ctx["nid"]`)。四个出口一律同源,故同一请求
116
+ 无论停在哪条出口,账本行都用同一个键可循;
117
+ · `resp_id` —— **调用方看到的响应 id**(`out["id"]`)。落盘 / 入队(DEFER)/
118
+ 超限三出口与请求 id 相同;`_gate_audit` 的 REJECT 出口则**不同** —— 那里
119
+ 响应 id 是「负记忆记录 id」(`cg.add_rejected` 自铸,是调用方取回该记录的
120
+ 句柄,既有响应契约、本批不改)。只记请求 id 会让该出口的账本行**无法与
121
+ 调用方记录 join**;故两个都留,且不做合并。
122
+
123
+ 为什么收敛成单点:四处出口(超限 / 闸门短路 / 执行器异常 / 落盘成功)各写各的
124
+ 会让「字段集 + 轮转接线」随出口漂移。为什么失败不外抛:写入内容已落盘(或已被
125
+ 闸门正常拒绝),记账故障不得把「写入成功」改写成「写入失败」诱使调用方重试 ——
126
+ 与本模块 `_commit_visibility` 同口径:如实标记、不静默、不改写语义。
127
+ """
128
+ if not _attempt_ledger_enabled():
129
+ return
130
+ try:
131
+ ck = a.get("content_kind")
132
+ lyr = a.get("layer")
133
+ rec = {"t": time.time(), "outcome": outcome, "id": nid,
134
+ "resp_id": out.get("id") if isinstance(out, dict) else None,
135
+ "content_kind": ck.strip() if isinstance(ck, str) and ck.strip() else None,
136
+ "layer": lyr if isinstance(lyr, str) and lyr else None,
137
+ "halted_by": halted_by, "error": error}
138
+ rb = _attempt_rotate_bytes()
139
+ if rb > 0:
140
+ active = os.path.join(cg.root, ATTEMPT_LOG_FILE)
141
+ try:
142
+ full = os.path.getsize(active) >= rb
143
+ except OSError:
144
+ full = False
145
+ if full:
146
+ # 复用共享件、不自造分片名(撞 test_audit_rotate_parity ③d)。
147
+ # 不用 maybe_rotate:本处无跨调用实例(writes 计数每次归零),
148
+ # Rotator.rotate 自带「size < rotate_bytes 即早退」,口径更严。
149
+ try:
150
+ from .rotate import Rotator
151
+ Rotator(cg.root, ATTEMPT_BASENAME, ATTEMPT_ARCHIVE_DIR,
152
+ rotate_bytes=rb).rotate()
153
+ except Exception as exc: # noqa: BLE001
154
+ # 轮转失败**不丢账**:本行照记,失败如实带在行里(不静默)。
155
+ rec["rotate_error"] = "%s: %s" % (type(exc).__name__, exc)
156
+ rec = {k: v for k, v in rec.items() if v is not None}
157
+ append_jsonl(os.path.join(cg.root, ATTEMPT_LOG_FILE), rec)
158
+ except Exception as exc: # noqa: BLE001
159
+ # 记账故障不改写写入语义,也不静默 —— 与 _commit_visibility 同口径。
160
+ if isinstance(out, dict):
161
+ out["attempt_ledger_error"] = "%s: %s" % (type(exc).__name__, exc)
162
+ else:
163
+ print("[writepipe] 尝试账本记账失败(写入语义未受影响):%s: %s"
164
+ % (type(exc).__name__, exc), file=sys.stderr)
165
+
166
+
167
+ # 生效条件:cg 可解析出 root 时,返回尝试账本的记录(**归档感知**:先按时间序读全部
168
+ # 归档分片,再读活动文件),limit 为真时只取尾部 limit 条;文件不可读时按空计。
169
+ def attempt_history(cg, limit=100):
170
+ """尝试账本的读面(issue #212 缺口 4,2026-10-13 DSH 端)。
171
+
172
+ 为什么必须有它:本账此前**只有写面、没有任何读面**(全仓对 _write_attempts
173
+ 的引用只有写入点与注释)。而轮转把活动文件整份 publish 进归档目录 ⇒
174
+ **只读活动文件的读面在轮转后看到的是空历史**(不是「最近 N 个分片」,是全部
175
+ 消失)。本函数走 Rotator.read_records,故「轮转与否」对调用方透明;被淘汰的
176
+ 只是超出 keep_shards 的旧分片(有界保留=设计),不是全部历史。
177
+ """
178
+ from .rotate import Rotator
179
+ return Rotator(cg.root, ATTEMPT_BASENAME, ATTEMPT_ARCHIVE_DIR,
180
+ rotate_bytes=_attempt_rotate_bytes()).read_records(limit=limit)
181
+
43
182
 
44
- __all__ = ["WritePipeline", "default_pipeline"]
45
183
 
46
184
 
47
185
  # 生效条件:调用即对 cg 执行 flush()(无脏数据时为 no-op),且仅当该调用抛异常而 out 是 dict 时在 out 写入 "flush_error",异常本身不外抛;
@@ -67,6 +205,115 @@ def _commit_visibility(cg, out):
67
205
  out["flush_error"] = "%s: %s" % (type(exc).__name__, exc)
68
206
 
69
207
 
208
+ # issue #82.3:写入硬上限(全 content_kind 统一)。
209
+ MAX_WRITE_BYTES = 1048576 # 1 MiB
210
+
211
+ # 生效条件:a['content'] 的 UTF-8 字节数 > MAX_WRITE_BYTES,或**其余字段**的 UTF-8 序列化
212
+ # 总字节 > MAX_WRITE_BYTES(issue #324),或 a['node_id'] 不满足既有 1..128 契约
213
+ # (mdcg._NODE_ID_RE,延迟 import 复用同一真源)时,返回超限出口响应体(protocol 形态
214
+ # gate_hard_reject:WRITE_TRIO + gate/field/error/verdict/hint);否则返回 None。
215
+ def _utf8_len(v):
216
+ """v 的 UTF-8 字节数(str 直量;其余按 JSON 序列化量;不可序列化记 0)。"""
217
+ if isinstance(v, str):
218
+ return len(v.encode("utf-8"))
219
+ try:
220
+ import json as _json
221
+ return len(_json.dumps(v, ensure_ascii=False, default=str).encode("utf-8"))
222
+ except Exception: # noqa: BLE001 —— 量不出来不当作超限
223
+ return 0
224
+
225
+
226
+ def _oversize_body(nid, a, n, limit, field, error=None, hint=None, reason="size"):
227
+ """写入硬上限的唯一响应体构造点(#82.3 统一形态;#324 起带 field;
228
+ #355 起可覆写 error/hint——类型面拒收的文案与「超上限」不同)。"""
229
+ _f = field or "content"
230
+ _what = ("正文" if _f == "content" else "入参字段 " + _f)
231
+ return {"ok": False, "id": nid, "committed": False,
232
+ "gate": "writelimit_size",
233
+ "error": (error or ("content 超过写入硬上限(issue #82.3)"
234
+ if _f == "content" else
235
+ "入参字段 " + _f + " 超过写入硬上限(issue #324)")),
236
+ "bytes": n, "limit": limit, "field": _f,
237
+ "verdict": {"state": "REJECT",
238
+ "kind": (a.get("content_kind") or "text"),
239
+ "evidence": ("%s %d 字节 > 上限 %d" % (_f, n, limit)
240
+ if reason == "size" else
241
+ "%s 不匹配字符类契约(issue #545:非尺寸问题,%d 字节 <= 上限 %d)"
242
+ % (_f, n, limit))},
243
+ "hint": (hint or ("写入被拒(硬上限,不是工具故障):%s %d 字节 > 上限 %d 字节。"
244
+ "本上限全 content_kind 统一(issue #82.3),重试同样结果——"
245
+ "请缩短后重写。" % (_what, n, limit)))}
246
+
247
+
248
+ def oversize_response(nid, a):
249
+ """写入硬上限的**唯一构造点**(issue #212 缺口 1,2026-10-13 DSH 端)。
250
+
251
+ 缺陷现场:动词面(本模块 execute 入口)判这道闸、工具面(mcp_server 的
252
+ mdcg_remember)**完全不判** ⇒ 同一内容两条通路结论相反——走 cg(op=write)
253
+ 被硬拒(gate='writelimit_size'),走 mdcg_remember 却 committed=True 落盘
254
+ (实测 1,048,677 字节)。根因不是「判据写错」,而是「判据 + 字段集」被写了
255
+ 两份、只有动词面那份被接线。本函数把判据与响应体收敛成**一份实现**,两个
256
+ 调用点只传 (nid, a),故两面读数逐键相等(守卫 W2a 断言这一点)。
257
+
258
+ 位置口径与动词面一致:按**原始入参**判,不打码后再判——打码只减不增,
259
+ 故本闸不会因打码而漏放。
260
+ """
261
+ a = a or {}
262
+ c = a.get("content")
263
+ # issue #355(2026-10-16 DSH 端):content 非 str 时修前两条字节判据都漏——
264
+ # isinstance 直取 0、下面的总字节循环又把 content 排除在外 ⇒ 大体积 dict/list
265
+ # 过闸后击穿库层裸异常(.split),且尝试账本零痕迹。此处非 str 且非 None
266
+ # 直接结构化拒收(field=content,error 点名类型),不再等库层抛裸异常。
267
+ if c is not None and not isinstance(c, str):
268
+ return _oversize_body(
269
+ nid, a, _utf8_len(c), MAX_WRITE_BYTES, "content",
270
+ error="content 须为字符串(issue #355):收到 " + type(c).__name__,
271
+ hint="写入被拒(入参类型,不是工具故障):content 须为字符串,收到 "
272
+ + type(c).__name__ + "。请改为字符串后重写。")
273
+ n = _utf8_len(c) if c is not None else 0
274
+ if n > MAX_WRITE_BYTES:
275
+ return _oversize_body(nid, a, n, MAX_WRITE_BYTES, "content")
276
+ # issue #324(2026-10-15 DSH 端):判据此前只量 content——其余字段完全不受
277
+ # 约束(实测超长 node_id 单次落盘 4,994,888 B;_write_attempts.jsonl 还是无上限
278
+ # 增长账本 ⇒ 磁盘耗尽型 DoS)。此处补齐两面,不新增常量、只复用既有真源:
279
+ # ① 其余字段的 UTF-8 序列化总字节 > MAX_WRITE_BYTES 即拒;
280
+ # ② node_id 复用 mdcg._NODE_ID_RE 与 1..128 契约(既有唯一真源,延迟 import
281
+ # 防环——写面比库层早加载)。二者都只是提前拦住 add() 本就会拒的入参,
282
+ # 不改任何合法调用的受理结论。
283
+ worst_k, worst_b, total = None, 0, 0
284
+ for _k, _v in a.items():
285
+ if _k == "content":
286
+ continue
287
+ _b = _utf8_len(_v)
288
+ total += _b
289
+ if _b > worst_b:
290
+ worst_k, worst_b = _k, _b
291
+ if total > MAX_WRITE_BYTES:
292
+ return _oversize_body(nid, a, total, MAX_WRITE_BYTES, worst_k)
293
+ _nv = a.get("node_id")
294
+ if isinstance(_nv, str) and _nv:
295
+ try:
296
+ from .mdcg import _NODE_ID_RE as _RE # 延迟 import 防环;复用同一真源
297
+ except Exception: # noqa: BLE001 —— 不可用则不新增闸
298
+ _RE = None
299
+ # issue #545:尺寸与字符类是**两个不同的拒绝理由**,此前合成一个 or 后统一报
300
+ # 「字节 > 上限」,于是字符类违规被报成 `31 字节 > 上限 128` 这种可被读者
301
+ # 验算为假的命题,且 hint 指向错误修法(「请缩短」而缩了仍拒)。此处拆开:
302
+ # 尺寸走 size 口径,字符类走 charset 口径(不编造算术命题)。
303
+ if _RE is not None:
304
+ _nb = len(_nv.encode("utf-8"))
305
+ if len(_nv) > 128 or _nb > 128:
306
+ return _oversize_body(nid, a, _nb, 128, "node_id")
307
+ if not _RE.match(_nv):
308
+ return _oversize_body(
309
+ nid, a, _nb, 128, "node_id", reason="charset",
310
+ error=("入参字段 node_id 不匹配字符类契约(issue #545):只允许 "
311
+ "字母/数字/下划线/点/@/中文/逗号/连字符,收到 " + repr(_nv[:40])),
312
+ hint=("写入被拒(入参字符类,不是工具故障、也不是长度问题):node_id "
313
+ "只允许字母/数字/下划线/点/@/中文/逗号/连字符,斜杠等字符会被拒。请改字符后重写。"))
314
+ return None
315
+
316
+
70
317
  class WritePipeline:
71
318
  """写入拦截器链(实例级;default_pipeline() 提供进程级默认单例)。"""
72
319
 
@@ -127,18 +374,83 @@ class WritePipeline:
127
374
  形态逐字节一致);链尾执行器产生落盘响应,after 链只观测不改写。
128
375
  """
129
376
  a = a or {}
377
+ # ---- issue #82.2(2026-10-09 DSH 端实施):work_wip 属过程件,
378
+ # 缺省不得进 knowledge 层(否则分桶/条件路由被过程件稀释)。
379
+ # 单点规范化:仅当未显式给 layer 且 content_kind==work_wip 时改路由到
380
+ # contextual;各分支既有的 layer-or-knowledge 兜底不动(仍服务其余 kind)。
381
+ if not a.get("layer") and (a.get("content_kind") or "").strip() == "work_wip":
382
+ a = dict(a)
383
+ a["layer"] = "contextual"
384
+ # #142①(2026-10-12 DSH 端):id 的铸造**前移到本闸之前**——超限出口同受
385
+ # WRITE_TRIO 铁律约束(protocol.py:59「任一形态必含 ok/id/committed」,
386
+ # 客户端据此判定是否落盘);且 id 必须与 ctx 同源,否则同一请求两条出口
387
+ # 报不同 id。铸造的唯一实现仍是 mdcg.mint_auto_id(见下方 B1),此处只提前
388
+ # 调用,不另写判据。
389
+ from .mdcg import mint_auto_id
390
+ _nid = a.get("node_id") or mint_auto_id(cg)
391
+ # ---- issue #82.3(同批):写入硬上限(全 kind 统一)。
392
+ # 判据:存量最大 463KB、P999=17KB ⇒ 1 MiB 约 60 倍余量、零存量阻断。
393
+ # 超限如实报(当前大小 + 上限),不截断、不静默。
394
+ # #142①:返回体补齐 id/committed(三键铁律)+ gate/hint,命中协议声明
395
+ # 形态 gate_hard_reject(protocol.VERB_SPECS["write"]["shapes"])——
396
+ # 此前该出口只有 ok/bytes/error/limit/verdict,三键缺二、不属任何声明形态。
397
+ # #212 缺口 1(2026-10-13 DSH 端):超限判据与响应体**收敛到唯一构造点**
398
+ # oversize_response——工具面此前完全不过这道闸,根因是「判据 + 字段集」
399
+ # 各写一份、只有本面被接线。本处改为调用同一份实现,两个面因此逐键相等。
400
+ # 响应体逐字节不变(仍命中协议形态 gate_hard_reject);AST 判据覆盖不丢:
401
+ # 含 gate 的字典字面量 return 落在 oversize_response 内,仍在本文件扫描面内。
402
+ _over = oversize_response(_nid, a)
403
+ if _over is not None:
404
+ # #142②:超限出口也是「一次尝试的出口」——落一行尝试账本再原样返回。
405
+ _append_attempt(cg, _nid, a, ATTEMPT_SHORT_CIRCUIT,
406
+ halted_by="writelimit_size", out=_over)
407
+ return _over
130
408
  # B1(2026-09-30):自动 id 的铸造**只有一份实现**(mdcg.mint_auto_id)
131
409
  # ——原先此处 `"mem_" + 毫秒` 与 mcp_server 的 mdcg_remember 分支各写一份,
132
410
  # 同毫秒自动写入铸出同一 id,被 add 的 upsert 语义静默顶替(无失败信号)。
133
411
  # 本处只委托,不复制判据。
134
- from .mdcg import mint_auto_id
135
- ctx = {"cg": cg, "a": a,
136
- "nid": a.get("node_id") or mint_auto_id(cg),
137
- "verdict": None, "cvd": None}
412
+ ctx = {"cg": cg, "a": a, "nid": _nid, "verdict": None, "cvd": None}
413
+ # ★ issue #322(P0,多实例共根):**同一 node_id 的整条写链**必须在同一把
414
+ # **跨进程**锁内——`_gate_autonomy` 的存在性判定、`_gate_gated` 的遗忘闸、
415
+ # 链尾 `cg.add` 的保护闸/落盘、以及出口的 `_commit_visibility`(flush)
416
+ # 此前全在锁外:两个进程都判「不存在」⇒ 都按新增落盘、后写整份盖前写,
417
+ # 两边回执 committed:true 而输的那份正文在 root 里消失;anchor/knowledge
418
+ # 同 id 并发时两份文件并存,保护闸在两侧都看不到对方(绕过 anchor)。
419
+ # 锁粒度按 node_id(不同 id 互不阻塞,写面是 S2/S4 瓶颈);不得用进程内锁
420
+ # 冒充——多实例共享 root 时写者本来就是不同进程(fsutil.node_write_lock 走
421
+ # OS 级 FileLock,同线程重入按深度计数,见其文档串)。
422
+ with node_write_lock(cg, _nid):
423
+ return self._run_chain(ctx, a)
424
+
425
+ # 生效条件:ctx 已就绪(cg/a/nid 三键齐)时按注册序跑 before 链——任一非 None 即记
426
+ # halted_by、写尝试账本、提交可见性并短路返回;全放行则先落两段式意图、跑链尾执行器
427
+ # (异常记 STATUS_ERROR 后原样重抛)、记 committed、跑 after 链并提交可见性后返回。
428
+ # 调用方(execute)必须已持有该 node_id 的跨进程写锁(#322)——本函数自身不再加锁,
429
+ # 否则「链内 add」会与外层锁形成第二份口径。
430
+ def _run_chain(self, ctx, a):
431
+ cg = ctx["cg"] # #322:链体从 execute 移出后,cg 经 ctx 取(同一实例)
138
432
  for name, fn in self._before:
139
433
  out = fn(ctx)
140
434
  if out is not None:
141
435
  ctx["halted_by"] = name
436
+ # #142②(2026-10-12 DSH 端)**未采纳**:原拟在短路出口补两段式账
437
+ # (修前只覆盖「全放行」与 gated 两段),使 abort 也可对账。
438
+ # 实测该改法与既有**已被守卫钉死**的不变量冲突:
439
+ # md_cg/test_twophase.py:9/⑧2「未落盘的分支(闸门拒绝 / 入队)
440
+ # 不产生 intent——没打算写就不记账」。改后 test_twophase 34/1(⑧2 红),
441
+ # 而该守卫文件不在本件写面(task-35:写面仅 writepipe.py + 本批守卫)
442
+ # ⇒ 按纪律**回退改动、把口径冲突上报**,不在本件单方面改语义。
443
+ # 详见 _team/writepipe/report.md ① ②与「需裁定」段。
444
+ # #142②【选项丙,2026-10-12 DSH 端】:上面「未采纳」的是**把短路
445
+ # 写进 _write_2pc.jsonl**——⑧2 不变量 + test_twophase 34/0 证明那条
446
+ # 改法必须回退。本批改走 issue §3.3(e) 方案 1:**另立**
447
+ # _write_attempts.jsonl,短路出口由此可观测,而两段式账本零漂移
448
+ # (test_write_return_shape::g_142_halt_2pc 的 delta==0 一字不动)。
449
+ # 响应 id 与请求 id 不同源时(如 _gate_audit 的 REJECT 出口:响应 id
450
+ # 是**负记忆记录 id**,即调用方取回该记录的句柄),账本仍两个 id 都留:
451
+ # id=请求 id(ctx 同源、四出口一致)、resp_id=调用方看到的 id(可 join)。
452
+ _append_attempt(cg, ctx["nid"], a, ATTEMPT_SHORT_CIRCUIT,
453
+ halted_by=name, out=out)
142
454
  _commit_visibility(cg, out)
143
455
  return out
144
456
  # ③ 两段式:闸门**全部放行**(确认要写)→ 先落意图,再执行落盘,
@@ -154,10 +466,20 @@ class WritePipeline:
154
466
  # 异常照抛不吞(两段式只记账,不改写既有错误语义)。
155
467
  twophase.commit(cg, tok, status=twophase.STATUS_ERROR,
156
468
  reason=type(exc).__name__)
469
+ # #142②:执行器抛异常也是「一次尝试的出口」——先如实落一行再原样重抛,
470
+ # 不改既有错误语义(_append_attempt 自身不外抛;该出口无响应体,
471
+ # 故只有 id、无 resp_id)。
472
+ _append_attempt(cg, ctx["nid"], a, ATTEMPT_ERROR,
473
+ error=type(exc).__name__)
157
474
  raise
158
475
  ctx["out"] = out
159
476
  twophase.commit(cg, tok, status=twophase.STATUS_COMMITTED,
160
477
  reason="executor_ok")
478
+ # #142②:落盘成功也记一行(尝试账本回答「这次写入停在哪个出口」,
479
+ # 三态齐全才可对账;两段式账本照旧零漂移)。记账调用落在**语句边界**上
480
+ # ——上一版把锚点截在 `twophase.commit(...` 那一行、语句还没闭合就追加,
481
+ # 整份文件因此解析失败(last round: invalid syntax, line 320)。
482
+ _append_attempt(cg, ctx["nid"], a, ATTEMPT_COMMITTED, out=out)
161
483
  for _name, fn in self._after:
162
484
  fn(ctx, out)
163
485
  _commit_visibility(cg, out)
@@ -213,14 +535,22 @@ def _gate_audit(ctx):
213
535
  rules, source, perr = audit.resolve_rulebook()
214
536
  ctx["policy"] = {"source": source}
215
537
  if perr is not None:
538
+ # 协议 gate_short_circuit 需 verdict:策略不可用 ⇒ 校验根本没跑,故 None
539
+ # (不编造裁决;键必在场,客户端据此知道「本次无裁决结论」)
216
540
  return {"ok": False, "id": ctx["nid"], "committed": False,
217
- "moved_to": "policy_unavailable",
541
+ "moved_to": "policy_unavailable", "verdict": None,
218
542
  "policy": {"source": source}, "error": perr,
219
543
  "hint": "写入被拒(fail-closed):策略不可用——%s。%s"
220
544
  % (perr["reason"], perr["hint"])}
545
+ # 条件空间/标签/层随载荷下传(第3步先决条件,2026-10-24):
546
+ # 此前 payload 只有 content/action/sensitivity/topic,验收器**根本看不到**
547
+ # condition_space,于是「按条件空间验收」在设计上就无法实现——不是验收器没写,
548
+ # 是它拿不到原料。四键均为只读附加字段,既有验证器只用 content,多传无害。
221
549
  payload = {"content": a.get("content", ""), "action": a.get("action"),
222
550
  "sensitivity": a.get("sensitivity"),
223
- "topic": a.get("query") or a.get("intent")}
551
+ "topic": a.get("query") or a.get("intent"),
552
+ "condition_space": a.get("condition_space"),
553
+ "tags": a.get("tags"), "layer": a.get("layer")}
224
554
  if (a.get("content_kind") or "").strip() == "hyperedge":
225
555
  # 超边验证器(回放比对)需要锚与结构键:fm 键平铺在 a 顶层,
226
556
  # 经 hyperedge.audit_payload 装配三键载荷(缺锚由验证器 fail-closed)。
@@ -245,10 +575,32 @@ def _gate_audit(ctx):
245
575
  tags = a.get("tags")
246
576
  if isinstance(tags, (list, tuple)):
247
577
  tags = [audit.redact_forbidden(t) if isinstance(t, str) else t for t in tags]
578
+ # issue #214:调用方**声明的密级**必须原样透传——与同函数的 DEFER 出口
579
+ # (:423-427,#186 已修)和 ACCEPT 落盘面(:766-773,B2 已修)同口径。
580
+ # 此前不传 ⇒ MdCGSecure.add_rejected 取 DEFAULT_SENSITIVITY=internal,
581
+ # 声明 private 的正文前 200 字以**明文**写进 rejected/rej_*.md,无令牌
582
+ # 访客经 stg(op=timeline) / cg(op=read, node_id) / mdcg_get 三处可读;
583
+ # 回执还写着「本条未入库」,写入方不会察觉。
584
+ # 未声明(None)时行为不变:仍按 internal(#87 已裁的缺省)。
585
+ # issue #557 R5(#294 T4 残余,2026-10-19 复跑):未声明密级时**继承被改写
586
+ # 节点**的密级,与 #297/#439 同口径。此前 None 原样下传,而
587
+ # `add_rejected` 是对**新铸的 `rej_*` id** 调 `_write_sensitivity`——该 id
588
+ # 下没有旧节点 ⇒ 回落 internal ⇒ 一份 private 正文的 200 字头以明文落进
589
+ # `rejected/`,无令牌访客 `mdcg_get` 可读(报告实测 T4)。判不了(无该钩子/
590
+ # 读闸拒绝)时保持旧行为(None ⇒ internal),不把「继承失败」升级成拒绝。
591
+ _sens_r5 = a.get("sensitivity")
592
+ if _sens_r5 is None:
593
+ _ws = getattr(cg, "_write_sensitivity", None)
594
+ if callable(_ws):
595
+ try:
596
+ _sens_r5 = _ws(ctx.get("nid"), None)
597
+ except Exception: # noqa: BLE001 —— 继承不了按未声明
598
+ _sens_r5 = None
248
599
  rid = cg.add_rejected(audit.redact_forbidden(a.get("content") or "")[:200],
249
600
  verdict["evidence"],
250
601
  verification_basis=verdict.get("basis") or "test",
251
- tags=tags)
602
+ tags=tags,
603
+ sensitivity=_sens_r5)
252
604
  return {"ok": False, "id": rid, "committed": False,
253
605
  "moved_to": "rejected", "verdict": verdict,
254
606
  "hint": _reject_hint(verdict)}
@@ -299,7 +651,13 @@ def _gate_consistency(ctx):
299
651
  else "knowledge"),
300
652
  condition_space=a.get("condition_space"),
301
653
  non_applicable_conditions=a.get("non_applicable_conditions"),
302
- tags=a.get("tags"), exclude=ctx["nid"], auto_flywheel=True)
654
+ tags=a.get("tags"), exclude=ctx["nid"], auto_flywheel=True,
655
+ # issue #193:写入面把写入层当成了比对范围——contextual 写入因此
656
+ # 看不到 knowledge 的同条件结论槽矛盾。
657
+ write_scope=True,
658
+ # issue #294:cg(op=write) 入口同样要透传声明密级(缺了这条,
659
+ # 冲突闸 → 飞轮那条出口对动词面照旧泄明文)。
660
+ sensitivity=a.get("sensitivity"))
303
661
  ctx["cvd"] = cvd
304
662
  v = cvd.get("verdict")
305
663
  # issue #26(2026-09-23):BLINDSPOT ≠ REJECT——冲突闸的 BLINDSPOT 唯一出口
@@ -347,7 +705,136 @@ def _gate_consistency(ctx):
347
705
  return out
348
706
 
349
707
 
350
- # 生效条件:ctx["a"] 的 gated 为假值时返 None 放行;为真值时按 cg.remember_gated(a.get("sensitivity") 一并透传——同一漏传族,B2)返回的 verdict 落两段式账,且仅 verdict 为 ACCEPT 时 ok/committed 为 True,verdict 为 MERGE 时记 committed 并置 moved_to="merged_into:"+merged_into,verdict 为 DROP/DEFER 时记 aborted 且 moved_to 为其小写值;
708
+ # ---------------------------------------------------------------- 写链实参真源(#414)
709
+ # 「同一入口、两条出口、两张实参表」是本族的形态:cg(op=write) 有两条**真实落盘**
710
+ # 出口——_gate_gated(gated=true,主动遗忘闸自己落盘)与 _executor(链尾直连)——
711
+ # 两张表各写一遍,于是**同一份声明在一条出口落盘、在另一条静默丢弃**。本仓已在同
712
+ # 一族上修过三次(B2 sensitivity / #186 session / A1 check_strength),第四次
713
+ # (#414)补齐后仍会复发,故本批把两张表收成**一份真源**:
714
+ # · _write_values(ctx) —— 语义键 → 落盘值的**唯一取值点**(两出口都只许调它);
715
+ # · _OUTLET_PARAMS —— 语义键 → 两出口各自的**形参名**;
716
+ # · _OUTLET_ONLY —— 值为 None 的格(该出口无此形参)必须在此登记理由。
717
+ # 守卫 md_cg/test_issue414_write_args_parity.py 用 **AST 抽取两处调用的实参名**,
718
+ # 与 _OUTLET_PARAMS 做全表**双向**断言:漏传 / 新增未登记 / 登记了却没有 —— 三者都红。
719
+ #
720
+ # ★importance vs importance_hint 的等价性判定(#414 报告把 importance 列进差集,
721
+ # 本端实测**不成立**,故它不进漏传集):
722
+ # · **拼写等价成立**(callee 面证据):mdcos.remember_gated 里
723
+ # hint = kw.pop("importance_hint", kw.get("importance")) ⇒ 二者是同一语义键的
724
+ # 两个拼写,importance_hint 优先。
725
+ # · **落盘值不等价(设计差异,不是缺陷)**:gated 面的 importance 经
726
+ # forgetting.assess 裁决(issue50-d:落盘 importance 恒=裁决 imp["score"],
727
+ # 并落 importance_source="hint"|"heuristic");直连面按**声明值**落、缺省 0.5。
728
+ # ⇒ 本表把两者作为**两条语义键**分别归属出口,并**禁止**后来者「看到两个值不同就
729
+ # 顺手补齐」——补齐会把 gated 面的裁决语义拆掉(守卫有一条专门断言钉住这点)。
730
+ def _write_values(ctx) -> dict:
731
+ """语义键 → 落盘值:写链两出口的**唯一取值点**(#414)。
732
+
733
+ 只在这里读 a / ctx;出口侧只做「形参名映射」(_outlet_kwargs),不再各自
734
+ a.get(...)——「同一份声明两条出口两张表」正是本族的根因形态。
735
+ """
736
+ a = ctx["a"]
737
+ _imp = a.get("importance")
738
+ _hint = a.get("importance_hint")
739
+ if _hint is None and _imp is not None:
740
+ _hint = float(_imp)
741
+ return {
742
+ # B2(2026-09-30):密级透传。不透传则声明 private 的正文以明文 + fm
743
+ # internal 落盘(纯漏传,非设计取舍);**不得**在此自行 _seal_content
744
+ # (会绕过 fm 与 _write_node 的单一密封点)。
745
+ "sensitivity": a.get("sensitivity"),
746
+ # 出口专有(见 _OUTLET_ONLY):gated 面传给 writelimit 记账用。
747
+ "role": a.get("role"),
748
+ "tags": a.get("tags"),
749
+ "condition_space": a.get("condition_space"),
750
+ "verification_basis": (a.get("verification_basis")
751
+ or (ctx.get("verdict") or {}).get("basis")),
752
+ "non_applicable_conditions": a.get("non_applicable_conditions"),
753
+ # gated 专有:**hint 语义**(None = 未声明 ⇒ 交 forgetting 启发式裁决)。
754
+ "importance_hint": _hint,
755
+ # direct 专有:**声明值语义**(None = 未声明 ⇒ 缺省 0.5,与 add 缺省同口径;
756
+ # 显式 0/0.0 等合法 falsy 数值照传)。与上一条**不等价**,理由见文件头注释。
757
+ "importance": 0.5 if _imp is None else float(_imp),
758
+ "override": bool(a.get("override")),
759
+ "consistency": False,
760
+ "derived_from": _split_ids(a.get("derived_from")),
761
+ "relation": a.get("relation"),
762
+ # —— 以下 7 项为 #414 本批补齐(此前只有 _executor 侧有;remember_gated 的
763
+ # **kw 原样转发给 add,故「add 侧已支持」不等于「写链已透传」):
764
+ # issue #186:显式声明优先(与 mdcos.propose 的单点同口径);漏传会让同一份
765
+ # 显式声明在两条路上落成两个不同的 fm.session。
766
+ "session": a.get("session"),
767
+ # 可验证记忆单元:依赖边(缺失 ⇒ 上游被证伪时本节点不被判受影响,传播断裂)。
768
+ "depends_on": trust.as_deps(a.get("depends_on")),
769
+ # 双时间轴(缺失 ⇒ scrub 的 expired 判据失效:该过期的不判过期、该生效的无起点)。
770
+ "valid_from": a.get("valid_from"),
771
+ "valid_until": a.get("valid_until"),
772
+ # 信任态声明(缺省被 add 写成 unverified —— 方向保守,但同样是声明被静默改写)。
773
+ "verification_state": a.get("verification_state"),
774
+ # A1(2026-10-05):检验强度透传(此前 add 层已支持、写链实参表漏传)。
775
+ "check_strength": a.get("check_strength"),
776
+ # A2 幽灵引用标记(正文属性:每次写入按当次检测重算,不继承)。
777
+ # 取值面在 ctx(由 _gate_ghostref 写入,链序上早于本闸与执行器)——
778
+ # 故两出口都能取到同一个值,不是「gated 面取不到」。
779
+ "uncertain_refs": ctx.get("ghost_phrases") or None,
780
+ }
781
+
782
+
783
+ #: 语义键 → (gated 出口形参名, direct 出口形参名)。None = 该出口**无此形参**,
784
+ #: 必须在 _OUTLET_ONLY 登记理由(守卫对该 None 面做**双向**核对)。
785
+ _OUTLET_PARAMS = (
786
+ ("sensitivity", "sensitivity", "sensitivity"),
787
+ ("role", "role", None),
788
+ ("tags", "tags", "tags"),
789
+ ("condition_space", "condition_space", "condition_space"),
790
+ ("verification_basis", "verification_basis", "verification_basis"),
791
+ ("non_applicable_conditions", "non_applicable_conditions",
792
+ "non_applicable_conditions"),
793
+ ("importance_hint", "importance_hint", None),
794
+ ("importance", None, "importance"),
795
+ ("override", "override", "override"),
796
+ ("consistency", "consistency", "consistency"),
797
+ ("derived_from", "derived_from", "derived_from"),
798
+ ("relation", "relation", "relation"),
799
+ ("session", "session", "session"),
800
+ ("depends_on", "depends_on", "depends_on"),
801
+ ("valid_from", "valid_from", "valid_from"),
802
+ ("valid_until", "valid_until", "valid_until"),
803
+ ("verification_state", "verification_state", "verification_state"),
804
+ ("check_strength", "check_strength", "check_strength"),
805
+ ("uncertain_refs", "uncertain_refs", "uncertain_refs"),
806
+ )
807
+
808
+ #: 值为 None 的格(=该出口无此形参)的**登记理由**。守卫双向核对:
809
+ #: ① 每个 None 格必须在此有登记(新增 None 格不登记即红);
810
+ #: ② 每条登记必须对应一个真实 None 格(补上/删格后不撤登记即红)——
811
+ #: 只有单向登记会退化成「登记一次永久免死」。
812
+ _OUTLET_ONLY = {
813
+ ("role", "direct"): (
814
+ "MdCG.add 无 role 形参(role 由 frontmatter 承载);gated 面传它是给 "
815
+ "writelimit 记账用(remember_gated 只 kw.get 不 pop,故它同时随 **kw 进 add)。"
816
+ "属**出口专有**,不是漏传——不得「补齐」。"),
817
+ ("importance_hint", "direct"): (
818
+ "直连面走 importance(声明值语义),不用 hint 语义。两名在 callee 面等价"
819
+ "(remember_gated 的 kw.pop 双拼写),但**缺省语义不同**:"
820
+ "hint=None 交启发式裁决 / importance=None 落 0.5。"
821
+ "不得因「两个值可能不同」而把 gated 面也改成 importance。"),
822
+ ("importance", "gated"): (
823
+ "gated 面走 importance_hint(上一条的镜像);理由同。"),
824
+ }
825
+
826
+
827
+ # 生效条件:outlet 为 "gated"/"direct" 时,按 _OUTLET_PARAMS 把 _write_values(ctx) 映射为该出口的形参 dict(形参名为 None 的格跳过,其理由见 _OUTLET_ONLY);其余 outlet 值抛 ValueError(出口名拼错即编程错误,不做静默回落,避免「以为选了口」而实际落空);
828
+ def _outlet_kwargs(outlet: str, ctx) -> dict:
829
+ """按真源表把语义键映射为**该出口**的形参 dict(#414 单点)。"""
830
+ if outlet not in ("gated", "direct"):
831
+ raise ValueError("未知写链出口:%r(只认 'gated' / 'direct')" % (outlet,))
832
+ idx = 1 if outlet == "gated" else 2
833
+ vals = _write_values(ctx)
834
+ return {p[idx]: vals[p[0]] for p in _OUTLET_PARAMS if p[idx] is not None}
835
+
836
+
837
+ # 生效条件:ctx["a"] 的 gated 为假值时返 None 放行;为真值时以 _write_values(ctx) 的单点取值经 _outlet_kwargs("gated", ctx) 展开为形参调 cg.remember_gated(...)(#414:两出口共用一张真源表),返回的 verdict 落两段式账,且仅 verdict 为 ACCEPT 时 ok/committed 为 True,verdict 为 MERGE 时记 committed 并置 moved_to="merged_into:"+merged_into,verdict 为 DROP/DEFER 时记 aborted 且 moved_to 为其小写值;
351
838
  def _gate_gated(ctx):
352
839
  """主动遗忘闸(gated=true 时启用):writelimit 限流 + forgetting 三问四态。
353
840
 
@@ -358,29 +845,19 @@ def _gate_gated(ctx):
358
845
  cg = ctx["cg"]
359
846
  if not a.get("gated"):
360
847
  return None
361
- hint = a.get("importance_hint")
362
- if hint is None and a.get("importance") is not None:
363
- hint = float(a["importance"])
848
+ # #414:hint 的取值(含 importance 回落)已收进 _write_values 单点。
364
849
  # ③ 两段式:本闸是**替代执行路径**(自己落盘),意图必须由它先记——
365
850
  # 若等 execute 在链后统一记,intent 会晚于本闸内部的写盘,「先行持久化」
366
851
  # 就不成立了。落盘前的窗口因此仍然被账本覆盖。
367
852
  tok = twophase.begin(cg, ctx["nid"], a.get("content", ""),
368
853
  layer=a.get("layer") or "contextual",
369
854
  actor="writepipe:gated")
855
+ # #414:gated 面同理——实参表由 _OUTLET_PARAMS 单点生成(remember_gated 只
856
+ # pop 走 importance_hint/gated/override/consistency/on_conflict,其余 **kw
857
+ # 原样转发给 add ⇒ 本表补的 7 项在 add 侧本就支持,无需改 mdcos.py)。
370
858
  res = cg.remember_gated(
371
859
  ctx["nid"], a.get("content", ""), layer=a.get("layer") or "contextual",
372
- # B2(2026-09-30):同一漏传族——gated 分支也是**落盘路径**
373
- # (remember_gated → add),不透传则声明 private 在此静默降级 internal。
374
- sensitivity=a.get("sensitivity"),
375
- role=a.get("role"), tags=a.get("tags"),
376
- condition_space=a.get("condition_space"),
377
- verification_basis=(a.get("verification_basis")
378
- or (ctx.get("verdict") or {}).get("basis")),
379
- non_applicable_conditions=a.get("non_applicable_conditions"),
380
- importance_hint=hint, override=bool(a.get("override")),
381
- consistency=False,
382
- derived_from=_split_ids(a.get("derived_from")),
383
- relation=a.get("relation"))
860
+ **_outlet_kwargs("gated", ctx))
384
861
  v = res.get("verdict")
385
862
  committed = v == "ACCEPT"
386
863
  # 结局如实记:ACCEPT=落盘完成;MERGE=内容并入既有节点(不再以本次内容成
@@ -501,7 +978,13 @@ def _gate_deps(ctx):
501
978
  "若该行只是描述本单元内部构成(自述),去掉 "
502
979
  + nodefile.DEP_REF_MARK + " 引用或改填「无」即可。"
503
980
  "本闸是契约闸门的正常行为,不是工具故障。")}
504
- known = set((getattr(cg, "index", None) or {}).get("nodes") or {})
981
+ # #415(2026-10-16):判「依赖目标是否存在」**必须先探活**——原实现裸读
982
+ # `set((getattr(cg, "index", None) or {}).get("nodes") or {})`,判前无 `_maybe_reload_index`
983
+ # ⇒ 他进程(serve 常驻 / 另一实例)刚建的依赖目标在陈旧条目里查不到 ⇒ **合法写入被硬拒**
984
+ # (E051)。与 #403「陈旧 ⇒ 误放行覆写」同族、后果相反。
985
+ # 判据单点:`protect.known_nodes(cg)`(与 `protect._entry` 同形:一次代际探活 + 返回同一
986
+ # 数据面),不再在本闸内自写一份裸读。
987
+ known = protect.known_nodes(cg)
505
988
  missing = [d for d in deps if d not in known]
506
989
  if missing:
507
990
  return {"ok": False, "id": ctx["nid"], "committed": False,
@@ -566,7 +1049,44 @@ def _hyperedge_extra(a):
566
1049
  return {k: a[k] for k in _he.EXTRA_FM_KEYS if a.get(k) is not None}
567
1050
 
568
1051
 
569
- # 生效条件:由链尾以含 cg 与 a 的 ctx 调用即无条件执行 cg.add 落盘(a.get("sensitivity") 一并透传——落盘面丢字段=上游声明静默失效,B2)并返回 ok=True/committed=True,ctx["cvd"] 非 None 时附加 consistency 字段;落盘前另取「同内容已存在」与「覆写既有同 id 节点」两个读数(P-9b ⑥),命中即在返回体附 dup_of/dup_ratio/dup_compared/dup_hint 与 overwrite_of/overwrite_ratio——**只加提示,不改落盘行为、不改 verdict**;
1052
+ #: #492 观测读数调用计数:把「有没有算」从耗时读数变成可断言的整数。
1053
+ #: 缺省写入恒不增;显式开启(a["include_dup_readout"] 为真)时每次 +1。
1054
+ #: 仅供守卫/诊断(守卫据此断言「缺省不算」),不参与任何判定、不落盘。
1055
+ READOUT_CALLS = 0
1056
+
1057
+
1058
+ def readout_calls():
1059
+ """返回进程内累计的观测读数计算次数(#492;守卫用,零副作用)。"""
1060
+ return READOUT_CALLS
1061
+
1062
+
1063
+ # 生效条件:仅由 `_executor` 在 a["include_dup_readout"] 为真时调用;
1064
+ # 不适用条件:本函数不参与落盘与 verdict(返回值只填返回体的提示字段)。
1065
+ def _dup_readout(cg, a, nid):
1066
+ """#492:两组纯观测读数(prior/self_coverage + redundancy)的**唯一计算入口**。
1067
+
1068
+ 子功能:取「覆写既有同 id 节点」读数(forgetting.prior_node + self_coverage)
1069
+ 与「同内容已存在」读数(forgetting.redundancy),复用 forgetting 既有实现,
1070
+ 不另写一份重复度算法。必须在 `cg.add` **之前**调用(add 后索引必有 nid:
1071
+ 覆写判据恒真、覆盖度恒 1.0)。
1072
+ 执行:调用即 `READOUT_CALLS += 1`(成本可观测),随后三次 forgetting 调用。
1073
+ 验证方式:`md_cg.test_issue492_dup_readout_opt_in`(A/E 组)+ `readout_calls()`
1074
+ 在缺省写入上的增量为 0。
1075
+ """
1076
+ global READOUT_CALLS
1077
+ from . import forgetting as _forgetting
1078
+ READOUT_CALLS += 1
1079
+ _content = a.get("content", "")
1080
+ prior = _forgetting.prior_node(cg, nid)
1081
+ cov = (_forgetting.self_coverage(cg, prior, _content)
1082
+ if prior is not None else None)
1083
+ dup = _forgetting.redundancy(cg, _content,
1084
+ layer=a.get("layer") or "knowledge",
1085
+ exclude=nid)
1086
+ return prior, cov, dup
1087
+
1088
+
1089
+ # 生效条件:由链尾以含 cg 与 a 的 ctx 调用即无条件执行 cg.add 落盘(a.get("sensitivity") 一并透传——落盘面丢字段=上游声明静默失效,B2)并返回 ok=True/committed=True,ctx["cvd"] 非 None 时附加 consistency 字段;**仅当 a["include_dup_readout"] 为真**时,落盘前另取「同内容已存在」与「覆写既有同 id 节点」两个读数(P-9b ⑥,计算入口 `_dup_readout`),命中即在返回体附 dup_of/dup_ratio/dup_compared/dup_hint 与 overwrite_of/overwrite_ratio——**只加提示,不改落盘行为、不改 verdict**;缺省路径(含 hooks 自动记忆)不付该成本,两族键不出现;
570
1090
  def _executor(ctx):
571
1091
  """链尾执行器(常驻不可卸载):cg.add 直写落盘。
572
1092
 
@@ -575,56 +1095,39 @@ def _executor(ctx):
575
1095
  """
576
1096
  a = ctx["a"]
577
1097
  cg = ctx["cg"]
578
- # importance 显式 null(JSON null→None)时 get 的缺省值不生效,直接
579
- # float(None) 抛 TypeError 崩主写路径——回退默认 0.5(与 add 缺省同口径);
580
- # 0 / 0.0 等合法 falsy 数值照传(_gate_gated :304 已是同款 None 判定)。
581
- _imp = a.get("importance")
1098
+ # importance 的 None 判定(含 0/0.0 等合法 falsy 照传)已收进
1099
+ # _write_values 单点——与 gated 面同一处取值,不再各写一遍。
582
1100
  # ⑥(P-9b):本执行器是**直写落盘点**之一(另一处 = mcp_server 的
583
1101
  # mdcg_remember 非 gated 分支)。直写不去重是文档化现状(writelimit.py
584
1102
  # 模块头注 :9-12:限流/同构聚合只作用 contextual 层,knowledge 等手动纪律
585
1103
  # 写入不受限)——故**不改落盘行为、不改 verdict**,只在返回体补
586
1104
  # 「同内容已存在」(dup_of/dup_ratio)与「本次是覆写」(overwrite_of/
587
- # overwrite_ratio)两个读数。判据复用 forgetting 的同一实现
1105
+ # overwrite_ratio)两个读数(**#492 起缺省不算**:须 a["include_dup_readout"]
1106
+ # 为真;缺省路径这两族键不出现)。判据复用 forgetting 的同一实现
588
1107
  # (redundancy/prior_node/self_coverage);两个读数都必须在 cg.add **之前**
589
1108
  # 取(add 后索引必有 nid:覆写判据恒真、覆盖度恒 1.0)。
590
1109
  from . import forgetting as _forgetting
591
1110
  _content = a.get("content", "")
592
- _prior = _forgetting.prior_node(cg, ctx["nid"])
593
- _prior_cov = (_forgetting.self_coverage(cg, _prior, _content)
594
- if _prior is not None else None)
595
- _dup = _forgetting.redundancy(cg, _content,
596
- layer=a.get("layer") or "knowledge",
597
- exclude=ctx["nid"])
598
- cg.add(ctx["nid"], _content,
599
- # B2(2026-09-30):密级透传。此前本实参表**缺 sensitivity**,而
600
- # 同文件 _gate_audit 的 payload(:219)带着它交给审核闸——两面口径
601
- # 分叉:审核闸按调用方声明的密级判,落盘闸按 DEFAULT_SENSITIVITY
602
- # 回落 internal,声明 private 的正文以明文 + fm internal 落盘
603
- # (纯漏传,非设计取舍)。透传即修好,**不得**在此自行 _seal_content
604
- # (会绕过 fm 与 _write_node 的单一密封点)。
605
- sensitivity=a.get("sensitivity"),
606
- layer=a.get("layer") or "knowledge",
607
- tags=a.get("tags"), condition_space=a.get("condition_space"),
608
- importance=0.5 if _imp is None else float(_imp),
609
- verification_basis=a.get("verification_basis")
610
- or (ctx.get("verdict") or {}).get("basis"),
611
- non_applicable_conditions=a.get("non_applicable_conditions"),
612
- override=bool(a.get("override")), consistency=False,
613
- derived_from=_split_ids(a.get("derived_from")),
614
- relation=a.get("relation"),
615
- # 可验证记忆单元(裁定 D):依赖/双时间轴/验证态随写入落 fm。
616
- # 透传而非丢弃——落盘面丢字段=上游声明静默失效(比报错难发现)。
617
- depends_on=trust.as_deps(a.get("depends_on")),
618
- valid_from=a.get("valid_from"), valid_until=a.get("valid_until"),
619
- verification_state=a.get("verification_state"),
620
- # A1 补接(2026-10-05,路线 C 动工时经 audit 现值面发现):检验强度
621
- # 透传。此前 add 层已支持该形参,但**写链实参表漏传**——经 MCP
622
- # op=write 声明 check_strength 一律静默丢弃(与 B2 sensitivity 漏传
623
- # 同族:上游声明、落盘面丢字段,比报错难发现)。
624
- check_strength=a.get("check_strength"),
625
- # A2 幽灵引用标记(正文属性:每次写入按当次检测重算,不继承——
626
- # 与 check_strength 的声明继承相反;缺省 None 不落键)。
627
- uncertain_refs=ctx.get("ghost_phrases") or None,
1111
+ # ★ issue #492:两组读数(overwrite_of / dup_of 族)**默认不算** —— 它们是纯观测提示,
1112
+ # 而 `forgetting.redundancy` 在 4000 节点库上中位 **12.24 ms**(占写入链净开销 89%),
1113
+ # 而 `src/hooks.ts` 的 `memorize()`(:597-616)**从不消费** `dup_of`/`overwrite_of`。
1114
+ # ⇒ 改为**显式开启**:`a.get("include_dup_readout")` 为真才算(缺省跳过)。**不是删功能**。
1115
+ # ★ 不变式(由 test_issue492 的 A 组钉住):**跳过观测不得影响落盘与 verdict**。
1116
+ # ★ 形态变更(已在提交信息与回帖显式声明):缺省路径上 `dup_of`/`overwrite_of` 由「有值」变「缺键」。
1117
+ # ★ 成本不变量(#492):缺省路径上**一次都不调用** `_dup_readout`——守卫据
1118
+ # `readout_calls()` 的增量断言「没算」,而不是只断言 6 个键不出现(后者
1119
+ # 无法区分「没算」与「算完再藏」,成本回归会漏过)。
1120
+ _want_readout = bool(a.get("include_dup_readout"))
1121
+ _prior = _prior_cov = _dup = None
1122
+ if _want_readout:
1123
+ _prior, _prior_cov, _dup = _dup_readout(cg, a, ctx["nid"])
1124
+ # #414:与 _gate_gated 共用同一张真源表(_OUTLET_PARAMS)——本出口的形参名
1125
+ # 由该表给出,取值为 _write_values(ctx) 单点。逐键语义(密级/session/依赖/
1126
+ # 双时间轴/验证态/检验强度/幽灵标记)见 _write_values 内的注释。
1127
+ cg.add(ctx["nid"], _content, layer=a.get("layer") or "knowledge",
1128
+ **_outlet_kwargs("direct", ctx),
1129
+ # 超边写入的 fm 扩展键(content_kind=hyperedge 时非 None 者)——
1130
+ # 出口专有,登记见守卫(与 7 项漏传的处置不同,理由在汇报里)。
628
1131
  **_hyperedge_extra(a))
629
1132
  out = {"ok": True, "id": ctx["nid"], "committed": True,
630
1133
  "verdict": ctx["verdict"]}
@@ -650,10 +1153,10 @@ def _executor(ctx):
650
1153
  "时间轴);请核对两条时间轴:若引用意图成立可忽略,若是回填/转写"
651
1154
  "产生的时序错觉,请修正 valid_from。")
652
1155
  # ⑥:直写提示(不改落盘行为、不改 verdict;见本函数开头注释)
653
- if _prior is not None:
1156
+ if _want_readout and _prior is not None:
654
1157
  out["overwrite_of"] = _prior
655
1158
  out["overwrite_ratio"] = _prior_cov
656
- if _dup["with"] and _dup["max"] >= _forgetting.DUP_MERGE:
1159
+ if _want_readout and _dup and _dup["with"] and _dup["max"] >= _forgetting.DUP_MERGE:
657
1160
  out["dup_of"] = _dup["with"]
658
1161
  out["dup_ratio"] = round(_dup["max"], 4)
659
1162
  out["dup_compared"] = _dup["compared"]
@@ -745,11 +1248,13 @@ def _gate_autonomy(ctx):
745
1248
  pr = _am.propose_mutation(cg, action, nid, payload=pay,
746
1249
  layer=a.get("layer") or "knowledge",
747
1250
  sensitivity=a.get("sensitivity"), info=True)
748
- return {"ok": True, "id": nid, "pid": pr["pid"], "committed": False,
749
- "moved_to": "review_queue", "autonomy": _aut, "mutation": pay,
750
- "verdict": ctx.get("verdict"),
751
- "hint": ("%s 本次未落盘:变更单已入审核队列(pid=%s,目标 %s)。"
752
- % (dec["hint"], pr["pid"], nid))}
1251
+ # issue #426-A:入队回执透出 dedup 归因。
1252
+ return _am.apply_dedup(
1253
+ {"ok": True, "id": nid, "pid": pr["pid"], "committed": False,
1254
+ "moved_to": "review_queue", "autonomy": _aut, "mutation": pay,
1255
+ "verdict": ctx.get("verdict"),
1256
+ "hint": ("%s 本次未落盘:变更单已入审核队列(pid=%s,目标 %s)。"
1257
+ % (dec["hint"], pr["pid"], nid))}, pr)
753
1258
 
754
1259
 
755
1260
  # 生效条件:value 传入即无条件延迟导入并转调 mcp_server._split_ids 后原样返回其结果(本符号无自身分支);
@@ -804,6 +1309,12 @@ def install_default_gates(pipe):
804
1309
  # 短语层标记;回指是现实写作常态,拒收会把正常记忆挡在门外)。
805
1310
  pipe.register_before("ghostref", _gate_ghostref, position=1)
806
1311
  pipe.register_before("deps", _gate_deps)
1312
+ # 条件空间闸(统一架构 v1.1 §2.4 / §9.1):字段域规范化 + 可观测性。
1313
+ # 默认 observe(放行并记读数),MDCG_CONDGATE=off|observe|enforce 三档。
1314
+ # 置于 audit 之前:条件空间是**字段域**(同 deps),先规范化,后续闸与落盘看到同一份值;
1315
+ # 它不做内容裁决(裁决归 audit),只碰 condition_space 一个键。
1316
+ from . import condgate
1317
+ pipe.register_before("condspace", condgate.before_hook())
807
1318
  pipe.register_before("audit", _gate_audit)
808
1319
  pipe.register_before("consistency", _gate_consistency)
809
1320
  pipe.register_before("gated", _gate_gated)