@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/md_cg/sustain.py CHANGED
@@ -58,7 +58,8 @@ import time
58
58
 
59
59
  from . import crypto
60
60
  from .datapath import aux_root
61
- from .fsutil import append_jsonl, atomic_write, ends_mid_line
61
+ from .fsutil import (FileLock, append_jsonl, atomic_write, count_jsonl,
62
+ ends_mid_line, publish, read_jsonl)
62
63
  from .mdcg import LAYERS
63
64
 
64
65
  STAMP_VERSION = 1
@@ -241,6 +242,354 @@ def peers(d: str = None):
241
242
  return out
242
243
 
243
244
 
245
+ # --------------------------------------------------------------------------
246
+ # 心跳台账(append-only · 有界分片轮转)—— 让「连续 N 周期无断」可严格测得
247
+ #
248
+ # 缺口(答卷 `docs/plans/灵枢1.0_最小智能系统实存答卷_v1.1.md` §八 分诊第 4 项 ·
249
+ # **甲类能力缺口**):`_sustain.jsonl` 是 heal **动作**台账(有动作才写,平静期与
250
+ # 停摆期不可区分),心跳戳是**覆盖式单点**(无历史序列)——故「连续 N 周期无断」
251
+ # 在现数据结构下**不可严格测得**(取证见 `docs/eval/W7v11_结构面局限取证_v0.1.md`
252
+ # §丁)。
253
+ #
254
+ # 本台账补此缺口:**每个心跳周期追加一行**(append-only、只追加不改写历史行),
255
+ # 配合 **分片轮转 + 保留片数上限**(有界,形态照抄 `_audit.jsonl` 轮转)与
256
+ # **节流探测**(把 stat 写入税摊到 1/N),并由只读统计
257
+ # `heartbeat_ledger_stats()` 直接算出「最长连续无断区间 / 断点数 / 最近一次周期
258
+ # 时刻」。位置与 `_sustain.jsonl` **同域**(库根 `<root>/_heartbeat.jsonl`)。
259
+ #
260
+ # **零判定变更**(硬边界):本台账只新增写入与只读统计,不改变任何既有读面——
261
+ # `beat()` 的返回、心跳戳字段、`_sustain.jsonl` 既有记录、`judge()`/`heal()` 的
262
+ # 返回均逐位不变(守卫 `md_cg/test_heartbeat_ledger.py` L1 钉死)。
263
+ #
264
+ # **写点边界**:只有**常驻循环**的 `SustainLoop.beat()` 记台账(那才是「心跳
265
+ # 周期」);`write_stamp` 的其它调用点不记——进度面刷新 `_flush_progress` 非心跳
266
+ # 周期(进/出六档各刷一次,会把「停摆」稀释),MCP 手动 `action=beat` 非循环
267
+ # 自证(人可手动补戳,不能当「循环活着」的证据)。故台账是**循环自证面**。
268
+ # --------------------------------------------------------------------------
269
+
270
+ HEARTBEAT_LOG = "_heartbeat.jsonl" # 活动台账(与 _sustain.jsonl 同域:库根)
271
+ HEARTBEAT_ARCHIVE = "_heartbeat_archive" # 分片归档目录(不在 LAYERS,不参与节点索引)
272
+ HEARTBEAT_INDEX = "_index.json" # 归档索引:分片 bytes/events 缓存(稳态 O(1))
273
+ HEARTBEAT_ROTATE_BYTES = 4 << 20 # 活动台账轮转阈值(≤0 关闭轮转=退回无上界)
274
+ HEARTBEAT_KEEP_SHARDS = 4 # 归档分片保留数(≤0 不淘汰;淘汰必留痕)
275
+ HEARTBEAT_PROBE_EVERY = 8 # 每 N 次写入探测一次大小(把写入税摊到 1/N)
276
+ HEARTBEAT_ENV = "MDCG_HEARTBEAT_LEDGER" # 开关(缺省开;"0"/"false"/"False" 关)
277
+ #: 相邻心跳周期间隔 ≤ 该阈值即视为「连续」;缺省 2× 心跳间隔(600s)= 1200s。
278
+ HEARTBEAT_GAP_THRESHOLD = 2.0 * DEFAULT_BEAT_INTERVAL
279
+ #: 轮转自述行与心跳周期行的区分标记(统计只取 kind=="beat",轮转痕不进时间序列)。
280
+ HB_KIND_BEAT = "beat"
281
+ HB_KIND_ROTATE = "rotate"
282
+ #: D2:非 beat 业务档的台账行 kind——失败档**必须在台账可见**(不被
283
+ #: `heartbeat_ledger_stats` 按 kind==HB_KIND_BEAT 的过滤吞掉)。
284
+ #: #376(2026-10-14)已接线:beat 与 tick 两档的失败行(ok 为假)统一进
285
+ #: `heartbeat_ledger_stats` 的 failed/failures 失败读数。
286
+ HB_KIND_TICK = "tick"
287
+ #: #376:失败明细保留条数(`failures` 只带**最近**这几条——读数有界)。
288
+ FAILURES_KEEP = 5
289
+
290
+ #: root → 已写次数(进程内;仅用于节流探测步长。跨进程各自计数,不影响正确性
291
+ #: ——多写者共享同一活动文件时,任一方到点都会做一次 stat,只是探测得更密)。
292
+ _HB_WRITES: dict = {}
293
+
294
+
295
+ # 生效条件:environ 缺省取 os.environ,读 HEARTBEAT_ENV 键,其 str() 值不在 AUTO_OFF_VALUES 中即返回 True(缺键回落 "1"=开);否则 False。
296
+ def heartbeat_ledger_enabled(environ=None) -> bool:
297
+ """心跳台账开关(缺省**开**):`MDCG_HEARTBEAT_LEDGER` ∈ 关断字面量即关。"""
298
+ env = os.environ if environ is None else environ
299
+ return str(env.get(HEARTBEAT_ENV, "1")) not in AUTO_OFF_VALUES
300
+
301
+
302
+ #: D1 解耦开关:**缺省关**("0")——既有单线程基线(六档顺序)逐位不变。
303
+ BEAT_THREAD_ENV = "MDCG_SUSTAIN_BEAT_THREAD"
304
+
305
+
306
+ # 生效条件:environ 缺省取 os.environ,读 BEAT_THREAD_ENV 键,其 str() 值不在 AUTO_OFF_VALUES 中即返回 True(缺键回落 "0"=关);否则 False。
307
+ def beat_thread_enabled(environ=None) -> bool:
308
+ """心跳独立线程开关(缺省**关**):`MDCG_SUSTAIN_BEAT_THREAD` ∈ 关断字面量即关。
309
+
310
+ 开启后 `start()` 额外起一条 daemon 线程专用 beat:业务档阻塞时心跳仍推进
311
+ (判活面与被判活对象不再共用执行体,D1)。缺省关 ⇒ 既有行为逐位不变。
312
+ """
313
+ env = os.environ if environ is None else environ
314
+ return str(env.get(BEAT_THREAD_ENV, "0")) not in AUTO_OFF_VALUES
315
+
316
+
317
+ # 生效条件:给定库根 root,返回 root/HEARTBEAT_LOG 的拼接路径。
318
+ def heartbeat_path(root: str) -> str:
319
+ return os.path.join(root, HEARTBEAT_LOG)
320
+
321
+
322
+ # 生效条件:给定库根 root,返回 root/HEARTBEAT_ARCHIVE 的拼接路径。
323
+ # 生效条件:root 给定时返回 root/SUSTAIN_LOG 的绝对路径(与 heartbeat_path 同形)。
324
+ # issue #547:落点路径的**单点 getter** —— 此前 sustain.py 内有两处直接拼
325
+ # os.path.join(root, SUSTAIN_LOG);与 heartbeat_path 对齐后产品代码只经 getter 取路径。
326
+ def sustain_log_path(root: str) -> str:
327
+ """sustain 台账路径(单点)。"""
328
+ return os.path.join(root, SUSTAIN_LOG)
329
+
330
+
331
+ def heartbeat_archive_dir(root: str) -> str:
332
+ return os.path.join(root, HEARTBEAT_ARCHIVE)
333
+
334
+
335
+ # 生效条件:t 为数值时间戳时返回 "%Y-%m-%dT%H:%M:%S" 本地时间字符串。
336
+ def _iso(t) -> str:
337
+ return time.strftime("%Y-%m-%dT%H:%M:%S", time.localtime(float(t)))
338
+
339
+
340
+ # 生效条件:root/HEARTBEAT_ARCHIVE 可列目录时返回其中以 "_heartbeat." 开头、".jsonl" 结尾的名字升序列表(序号零填充 ⇒ 字典序==时间序);listdir 抛 OSError 时返回 []。
341
+ def _hb_shards(root: str):
342
+ try:
343
+ names = os.listdir(heartbeat_archive_dir(root))
344
+ except OSError:
345
+ return []
346
+ return sorted(n for n in names
347
+ if n.startswith("_heartbeat.") and n.endswith(".jsonl"))
348
+
349
+
350
+ # 生效条件:遍历 _hb_shards(root) 中 "_heartbeat.<n>.jsonl" 形式取 int(n) 最大值 top(解析失败 continue、无可解析项 top=0),返回 top+1。
351
+ def _hb_next_seq(root: str) -> int:
352
+ top = 0
353
+ for n in _hb_shards(root):
354
+ try:
355
+ top = max(top, int(n[len("_heartbeat."):-len(".jsonl")]))
356
+ except ValueError:
357
+ continue
358
+ return top + 1
359
+
360
+
361
+ # 生效条件:读 root/HEARTBEAT_ARCHIVE/HEARTBEAT_INDEX(json);不可读/损坏/非 dict 时回落 {},只保留 value 为 dict 的项。
362
+ def _hb_load_index(root: str) -> dict:
363
+ try:
364
+ with open(os.path.join(heartbeat_archive_dir(root), HEARTBEAT_INDEX),
365
+ "r", encoding="utf-8") as f:
366
+ data = json.load(f)
367
+ if isinstance(data, dict):
368
+ return {k: v for k, v in data.items() if isinstance(v, dict)}
369
+ except (OSError, ValueError):
370
+ pass
371
+ return {}
372
+
373
+
374
+ # 生效条件:把 idx 以 JSON(ensure_ascii=False, indent=1, sort_keys=True)原子写入 root/HEARTBEAT_ARCHIVE/HEARTBEAT_INDEX;OSError 被吞掉。
375
+ def _hb_save_index(root: str, idx: dict):
376
+ try:
377
+ os.makedirs(heartbeat_archive_dir(root), exist_ok=True)
378
+ atomic_write(os.path.join(heartbeat_archive_dir(root), HEARTBEAT_INDEX),
379
+ json.dumps(idx, ensure_ascii=False, indent=1, sort_keys=True))
380
+ except OSError:
381
+ pass
382
+
383
+
384
+ # 生效条件:HEARTBEAT_ROTATE_BYTES <= 0 时直接返回(轮转关闭);否则 root 写计数自增,未到 HEARTBEAT_PROBE_EVERY 倍数即返回;到倍数且活动台账 size ≥ 阈值时调用 rotate_heartbeat(root)。
385
+ def _hb_rotate_if_needed(root: str):
386
+ """写前闸门:活动台账达阈值即切分(把 stat 摊到 1/HEARTBEAT_PROBE_EVERY)。"""
387
+ limit = HEARTBEAT_ROTATE_BYTES
388
+ if limit <= 0:
389
+ return
390
+ n = _HB_WRITES.get(root, 0) + 1
391
+ _HB_WRITES[root] = n
392
+ if n % HEARTBEAT_PROBE_EVERY:
393
+ return
394
+ try:
395
+ if os.path.getsize(heartbeat_path(root)) < limit:
396
+ return
397
+ except OSError:
398
+ return
399
+ rotate_heartbeat(root)
400
+
401
+
402
+ # 生效条件:在 FileLock(root/_heartbeat.rotate.lock) 下,若活动台账 size ≥ HEARTBEAT_ROTATE_BYTES 则 publish 为 HEARTBEAT_ARCHIVE/_heartbeat.%06d.jsonl,登记索引、淘汰越限分片,并在新活动台账追加一条 kind="rotate" 自述行后返回 {"shard","bytes","events","pruned"};size 不足、getsize OSError 或 rename 失败时返回 None。
403
+ def rotate_heartbeat(root: str, reason: str = "size"):
404
+ """把活动心跳台账切分为归档分片(publish 原子 rename,不重写一个字节)。
405
+
406
+ 语义边界(诚实面):
407
+ · 分片内容与轮转前**逐行一致**(rename 不动字节);轮转前记录序列是轮转后
408
+ (跨分片按时间序合并)序列的**前缀**——append-only 指「分片内只追加」,
409
+ 分片封存后不再改写;
410
+ · 并发由 FileLock + 「rename 前复检大小 / 失败即返回 None」兜住;
411
+ · 保留策略只淘汰**分片**,且淘汰名单写进新台账的 rotate 自述行(不静默丢证据)。
412
+ """
413
+ path = heartbeat_path(root)
414
+ with FileLock(os.path.join(root, "_heartbeat.rotate.lock"), timeout=5.0):
415
+ try:
416
+ size = os.path.getsize(path)
417
+ except OSError:
418
+ return None
419
+ if size < HEARTBEAT_ROTATE_BYTES:
420
+ return None # 已被并发写者轮转
421
+ arc = heartbeat_archive_dir(root)
422
+ os.makedirs(arc, exist_ok=True)
423
+ name = "_heartbeat.%06d.jsonl" % _hb_next_seq(root)
424
+ try:
425
+ publish(path, os.path.join(arc, name))
426
+ except OSError:
427
+ return None # 抢输(文件已被移走)→ 让位,不报错
428
+ events = count_jsonl(os.path.join(arc, name))
429
+ idx = _hb_load_index(root)
430
+ idx[name] = {"bytes": size, "events": events,
431
+ "t": round(time.time(), 3), "reason": reason}
432
+ _hb_save_index(root, idx)
433
+ pruned = _hb_prune_shards(root)
434
+ _HB_WRITES[root] = 0
435
+ row = {"t": time.time(), "name": "_rotate", "pid": os.getpid(),
436
+ "kind": HB_KIND_ROTATE, "ok": True, "shard": name,
437
+ "bytes": size, "events": events, "pruned": pruned, "reason": reason}
438
+ try: # 自述留痕:轮转本身可审计
439
+ # #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
440
+ # 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
441
+ # (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
442
+ _ok = append_jsonl(path, row)
443
+ except OSError:
444
+ pass
445
+ return {"shard": name, "bytes": size, "events": events, "pruned": pruned}
446
+
447
+
448
+ # 生效条件:HEARTBEAT_KEEP_SHARDS <= 0 时返回 [](不淘汰);否则保留最近 keep 个分片,越限的逐个 os.remove 并从索引 pop(OSError 则 continue),最后保存索引并返回被淘汰分片名列表。
449
+ def _hb_prune_shards(root: str):
450
+ """保留最近 HEARTBEAT_KEEP_SHARDS 个分片、淘汰更旧的(≤0 表示不淘汰)。"""
451
+ keep = HEARTBEAT_KEEP_SHARDS
452
+ if keep <= 0:
453
+ return []
454
+ shards = _hb_shards(root)
455
+ gone = shards[:-keep] if len(shards) > keep else []
456
+ if not gone:
457
+ return []
458
+ idx = _hb_load_index(root)
459
+ for n in gone:
460
+ try:
461
+ os.remove(os.path.join(heartbeat_archive_dir(root), n))
462
+ except OSError:
463
+ continue # 删不掉就留着:不假装已淘汰
464
+ idx.pop(n, None)
465
+ _hb_save_index(root, idx)
466
+ return gone
467
+
468
+
469
+ # 生效条件:开关关(heartbeat_ledger_enabled() 为假)时返回 None 且不写盘;否则先经 _hb_rotate_if_needed(root) 有界闸门,再向 root/HEARTBEAT_LOG 追加一行 {"t","name","pid","kind":"beat","ok"(,"error")},返回该行;任何写入异常被吞掉并返回 None(心跳不可因台账而中断)。
470
+ def record_heartbeat(root: str, name: str, *, ok: bool = True, error=None,
471
+ t=None, pid=None, extra=None,
472
+ kind: str = HB_KIND_BEAT) -> dict:
473
+ """追加一条**心跳周期**记录(append-only)——「连续 N 周期无断」的原始证据。
474
+
475
+ 字段(至少):`t`(时间戳)+`name`(周期名)+`pid`+`ok`(该周期结果);
476
+ 失败时附 `error`(摘要,截 200)。写路径 best-effort:开关关 / 任何异常都
477
+ 返回 None 且不外溢(与心跳写戳同纪律)。
478
+ """
479
+ if not heartbeat_ledger_enabled():
480
+ return None
481
+ row = {"t": float(t) if t is not None else time.time(),
482
+ "name": name, "pid": os.getpid() if pid is None else pid,
483
+ "kind": kind, "ok": bool(ok)}
484
+ if error is not None:
485
+ row["error"] = str(error)[:200]
486
+ if extra:
487
+ row.update(extra)
488
+ try:
489
+ _hb_rotate_if_needed(root)
490
+ append_jsonl(heartbeat_path(root), row)
491
+ except Exception: # noqa: BLE001 —— 台账永不拖垮心跳
492
+ return None
493
+ return row
494
+
495
+
496
+ # 生效条件:按 _hb_shards(root)(时间序,旧片在前)再活动台账的顺序流式产出各 JSONL 记录(read_jsonl 自动跳过坏行);文件/目录缺失即跳过。
497
+ def _hb_records(root: str):
498
+ arc = heartbeat_archive_dir(root)
499
+ for n in _hb_shards(root):
500
+ for r in read_jsonl(os.path.join(arc, n)):
501
+ yield r
502
+ for r in read_jsonl(heartbeat_path(root)):
503
+ yield r
504
+
505
+
506
+ # 生效条件:只读统计 root 下 kind∈{beat,tick} 的记录(name 非 None 时按周期名过滤)——成功 beat 的 t 序列以相邻 t 间隔 > threshold_s 为断点;失败行(beat/tick 的 ok 为假)只进失败读数、不进时间序列;返回 {n, threshold_s, shards, file, failed, failures, absent, span_s, span_iso, last_iso, last_age_s, segments, longest_s, longest_iso, count_in_longest, breaks, breaks_top};该过滤名下一条记录都没有时 absent=True 且各时序读数 None(只有失败行时 absent=False、n=0、failed=该档失败行数、failures=最近 FAILURES_KEEP 条明细)。
507
+ def heartbeat_ledger_stats(root: str, *, name: str = None,
508
+ threshold_s: float = HEARTBEAT_GAP_THRESHOLD) -> dict:
509
+ """只读统计:**最长连续无断区间 / 断点数 / 最近一次周期时刻**(+失败读数)。
510
+
511
+ 用途=闭合答卷 §八 分诊第 4 项的「不可严格测得」——`_sustain.jsonl`(heal 动作
512
+ 台账)与心跳戳(覆盖式单点)都答不了,本台账答得了。**只读**:不写、不轮转。
513
+ 有界台账(分片 ≤ 保留片数 × 轮转阈值)使该读数代价有界。
514
+
515
+ #376(2026-10-14):时间序列**只纳入成功的 beat**——原实现按 `kind=="beat"`
516
+ 取数,把 `ok=False` 的心跳也折成时间戳计入,于是「连续 N 周期无断」被失败行
517
+ 刷长、业务档失败行则被 kind 过滤**整个丢弃**(两类表现同一根因)。修后:失败
518
+ 的 beat 与业务档 tick 进**独立失败读数** `failed`(失败行数)与 `failures`
519
+ (最近 `FAILURES_KEEP` 条明细,落账序)。**不改写入路径 / 调度 / 配置 / 告警**
520
+ (本函数只读);**全成功台账的原有读数逐位不变**(n/threshold_s/shards/file/
521
+ absent/span_*/last_*/segments/longest_*/count_in_longest/breaks* 一律照旧,
522
+ 两个失败字段是纯增量)。`absent` 口径随之钉为「该过滤名下**一条记录都没有**」:
523
+ 只有失败行的档位是 absent=False + n=0 + failed=k(那正是必须可见的形态),
524
+ 空台账仍 absent=True。
525
+ """
526
+ def _num(x): # t 可取数判据(bool 不算数,沿用原口径)
527
+ return isinstance(x, (int, float)) and not isinstance(x, bool)
528
+
529
+ ts, failed, failures = [], 0, []
530
+ for r in _hb_records(root):
531
+ if not isinstance(r, dict):
532
+ continue
533
+ _kind = r.get("kind")
534
+ if _kind not in (HB_KIND_BEAT, HB_KIND_TICK):
535
+ continue # 轮转自述行等非周期行不进统计(原口径)
536
+ if name is not None and r.get("name") != name:
537
+ continue
538
+ if not r.get("ok", True):
539
+ # #376:失败行(beat 与 tick 同列)——契约见 HB_KIND_TICK 注释。
540
+ # **不进**时间序列:失败周期不是「无断」的证据。
541
+ failed += 1
542
+ _t = r.get("t")
543
+ failures.append({"t": float(_t) if _num(_t) else None,
544
+ "iso": _iso(_t) if _num(_t) else None,
545
+ "name": r.get("name"), "kind": _kind,
546
+ "error": r.get("error")})
547
+ continue
548
+ if _kind != HB_KIND_BEAT:
549
+ continue # 成功业务档不进心跳时间序列(原口径)
550
+ v = r.get("t")
551
+ if _num(v):
552
+ ts.append(float(v))
553
+ ts.sort()
554
+ # 失败明细按**落账序**取最近 FAILURES_KEEP 条(_hb_records 恒为时间序流)。
555
+ out = {"n": len(ts), "threshold_s": float(threshold_s),
556
+ "shards": len(_hb_shards(root)), "file": HEARTBEAT_LOG,
557
+ "failed": failed, "failures": failures[-FAILURES_KEEP:]}
558
+ if not ts:
559
+ # absent=该过滤名下**一条记录都没有**(既无成功 beat 也无失败行)。
560
+ # 只有失败行时 absent=False:那种台账恰恰是必须看得见的一种形态。
561
+ out.update({"absent": failed == 0, "segments": 0, "longest_s": None,
562
+ "longest_iso": None, "count_in_longest": 0,
563
+ "breaks": 0, "breaks_top": [], "span_s": None,
564
+ "span_iso": None, "last_iso": None, "last_age_s": None})
565
+ return out
566
+ runs, breaks = [], []
567
+ start = prev = ts[0]
568
+ for t in ts[1:]:
569
+ if t - prev > threshold_s:
570
+ runs.append((start, prev))
571
+ breaks.append({"at_iso": _iso(prev), "next_iso": _iso(t),
572
+ "gap_s": round(t - prev, 1)})
573
+ start = t
574
+ prev = t
575
+ runs.append((start, prev))
576
+ best = max(runs, key=lambda r: r[1] - r[0])
577
+ out.update({
578
+ "absent": False,
579
+ "span_s": round(ts[-1] - ts[0], 1),
580
+ "span_iso": "%s → %s" % (_iso(ts[0]), _iso(ts[-1])),
581
+ "last_iso": _iso(ts[-1]),
582
+ "last_age_s": round(max(0.0, time.time() - ts[-1]), 1),
583
+ "segments": len(runs),
584
+ "longest_s": round(best[1] - best[0], 1),
585
+ "longest_iso": "%s → %s" % (_iso(best[0]), _iso(best[1])),
586
+ "count_in_longest": sum(1 for t in ts if best[0] <= t <= best[1]),
587
+ "breaks": len(breaks),
588
+ "breaks_top": sorted(breaks, key=lambda b: -b["gap_s"])[:5],
589
+ })
590
+ return out
591
+
592
+
244
593
  # --------------------------------------------------------------------------
245
594
  # 互维闭环(P-T-110 最小投影 · #30)
246
595
  # --------------------------------------------------------------------------
@@ -294,7 +643,7 @@ def _last_mutual_restart(root: str, peer: str) -> float:
294
643
  """_sustain.jsonl 里该对端最近一次互维拉起时间(无 → 0.0,审计即状态)。"""
295
644
  last = 0.0
296
645
  try:
297
- with open(os.path.join(root, SUSTAIN_LOG), encoding="utf-8") as f:
646
+ with open(sustain_log_path(root), encoding="utf-8") as f:
298
647
  for line in f:
299
648
  try:
300
649
  r = json.loads(line)
@@ -451,7 +800,7 @@ def _index_log_shards(root: str):
451
800
  return [f for f in os.listdir(d) if f.endswith(".log")]
452
801
 
453
802
 
454
- # 生效条件:cg 具备 crypto_status 且其返回 unlocked 为假时,返回 cg.index['nodes'] 中 sensitivity 属 crypto.ENCRYPTED_LEVELS 的条目数;属性缺失、调用异常或已解锁时返回 0。
803
+ # 生效条件:cg 具备 crypto_status 且其返回 unlocked 为假时,返回 cg.index['nodes'] 中 sensitivity 经 crypto.is_encrypted_level 判为加密档的条目数;属性缺失、调用异常或已解锁时返回 0。
455
804
  def _locked_nodes(cg) -> int:
456
805
  """加密引擎在「未解锁」状态下被隔离的私有节点数(缺密钥 = 权限事实)。"""
457
806
  if not hasattr(cg, "crypto_status"):
@@ -468,7 +817,7 @@ def _locked_nodes(cg) -> int:
468
817
  # during iteration')(N138,FI-M04)。list() 拷贝在 C 层一次完成(迭代期间
469
818
  # 不释放 GIL),故快照自身原子;判据与结果逐位不变(只换取用方式)。
470
819
  return sum(1 for e in list(nodes.values())
471
- if (e.get("sensitivity") or "") in crypto.ENCRYPTED_LEVELS)
820
+ if crypto.is_encrypted_level(e.get("sensitivity")))
472
821
 
473
822
 
474
823
  # --------------------------------------------------------------------------
@@ -707,7 +1056,7 @@ def _seal_half_line(path: str):
707
1056
 
708
1057
  # 生效条件:root/op/action 必填,向 root/SUSTAIN_LOG(模块常量)追加一行含 t/op/action/detail(截断 200)/pid 的 JSONL,无返回值。
709
1058
  def _audit(root: str, op: str, action: str, detail: str = ""):
710
- append_jsonl(os.path.join(root, SUSTAIN_LOG),
1059
+ append_jsonl(sustain_log_path(root),
711
1060
  {"t": time.time(), "op": op, "action": action,
712
1061
  "detail": str(detail)[:200], "pid": os.getpid()})
713
1062
 
@@ -822,14 +1171,21 @@ def heal(cg, *, name: str = "md_cg", dry_run: bool = False,
822
1171
  except Exception as e: # 自愈失败不能拖垮进程
823
1172
  actions.append({"code": code, "detail": detail, "applied": True,
824
1173
  "ok": False, "error": f"{type(e).__name__}: {e}"})
1174
+ # #404:台账是**外部可见读数**,必须与事实一致——失败时把「清理 N 个…」改写成
1175
+ # 带结果的形态再落账,否则 `_audit` 会照写一行「已清理 N 个」的假账(issue 期望 #2)。
1176
+ # 只改 detail(不动 applied/ok 语义)。
1177
+ detail = "%s → 失败:%s: %s" % (detail, type(e).__name__, e)
825
1178
  else:
826
1179
  # `fn()` 跑完 ≠ 修好:返回 dict 且 ok is False(或 truncated)时
827
1180
  # 如实记 ok=False——「重建失败」绝不能被记成 ok=True。
828
1181
  bad = _bad_result(res)
829
1182
  row = {"code": code, "detail": detail, "applied": True, "ok": not bad}
830
1183
  if isinstance(res, dict):
1184
+ # #404:白名单是**回执的判据面**——诚实计数(removed/planned)必须进得来,
1185
+ # 否则「删了几个」到不了外部读数(本件首版就被自己的守卫抓到这一点)。
831
1186
  brief = {k: res[k] for k in ("ok", "indexed", "files", "truncated",
832
- "roots_missing", "errors")
1187
+ "roots_missing", "errors",
1188
+ "removed", "planned")
833
1189
  if k in res}
834
1190
  if isinstance(brief.get("errors"), list):
835
1191
  brief["errors"] = brief["errors"][:1]
@@ -870,13 +1226,27 @@ def heal(cg, *, name: str = "md_cg", dry_run: bool = False,
870
1226
  if "stale_temps" in codes:
871
1227
  paths = _list_stale_temps(root, stale_temp_age)
872
1228
 
873
- # 生效条件:对闭包变量 paths 中每个路径尝试 os.remove(p),单个路径的 OSError 被吞掉后继续处理后续路径;
1229
+ # 生效条件:对闭包变量 paths 逐个 os.remove 并按**实际结果**返回 {"ok","removed","planned","errors"}——单条失败记入 errors 后继续;paths 非空而**一个都没删掉**时抛 OSError(让 act 如实记 ok=False,不假装成功);paths 为空时返回 ok=True/removed=0(无事可做不是失败)。
874
1230
  def _sweep():
1231
+ # #404(2026-10-16)根因:原实现 `except OSError: pass` 吞掉失败、且返回 None ⇒
1232
+ # act 的 `_bad_result(None)` 为假 ⇒ 回执 `applied=True/ok=True`,`_audit` 同时照写
1233
+ # 「清理 N 个陈旧临时文件」——**回执与台账都与事实相反**(同函数内 seal_half_lines
1234
+ # 不吞异常,本处是唯一把失败吞成成功的动作,与「绝不假装成功」正面对撞)。
1235
+ # 修法:按实际结果回报 + 全失败即抛(fail-loud);**不改 act 的 applied 语义**——
1236
+ # 沿用仓内既有口径(scrub.py 的 #411 修法:applied=动作跑过、ok=按事实判)。
1237
+ done, failed = 0, []
875
1238
  for p in paths:
876
1239
  try:
877
1240
  os.remove(p)
878
- except OSError:
879
- pass
1241
+ except OSError as e:
1242
+ failed.append("%s: %s" % (os.path.basename(p), e))
1243
+ else:
1244
+ done += 1
1245
+ if paths and done == 0:
1246
+ raise OSError("陈旧临时件一个都没删掉(%d/%d):%s"
1247
+ % (done, len(paths), ";".join(failed[:3])))
1248
+ return {"ok": not failed, "removed": done, "planned": len(paths),
1249
+ "errors": failed[:3]}
880
1250
  act("sweep_temps", f"清理 {len(paths)} 个陈旧临时文件", _sweep)
881
1251
  if "half_line_logs" in codes:
882
1252
  paths = _half_line_logs(root)
@@ -1082,6 +1452,9 @@ class SustainLoop:
1082
1452
  self.heals = []
1083
1453
  self.last_scrub = None
1084
1454
  self.scrubs = []
1455
+ # 自净轮次(issue #66):`_tick_scrub` 每轮自增,用作抽样 seed 的
1456
+ # 轮次分量——固定 seed 会让每轮样本逐字相同(抽样面冻结)。
1457
+ self.scrub_round = 0
1085
1458
  self.last_evolve = None
1086
1459
  self.evolves = []
1087
1460
  self.last_tidy = None
@@ -1097,22 +1470,33 @@ class SustainLoop:
1097
1470
  self._ticks_wrapped = False # 六档进度面包装的幂等标记
1098
1471
  self._started_at = None
1099
1472
  self._th = None
1473
+ self._beat_th = None # D1:独立心跳线程(缺省关)
1100
1474
  self._stop = threading.Event()
1101
1475
  self._lock = threading.Lock()
1102
1476
 
1103
1477
  # ---- 心跳 ----
1104
1478
 
1105
- # 生效条件:task_running 非 None 时先置 self.task_running=bool(task_running),再 write_stamp(self.name, self.d, task_running=self.task_running, root=self.cg.root, uptime=... if self._started_at else 0.0, **进度三字段),beats 自增并记 last_beat=rec["ts"],返回该 rec;
1479
+ # 生效条件:task_running 非 None 时先置 self.task_running=bool(task_running),再 write_stamp(self.name, self.d, task_running=self.task_running, root=self.cg.root, uptime=... if self._started_at else 0.0, **进度三字段);写戳抛异常时先 record_heartbeat(ok=False, error=摘要) 再原样抛出;写戳成功则 beats 自增、记 last_beat=rec["ts"]、record_heartbeat(ok=True, t=rec["ts"]),返回该 rec;
1106
1480
  def beat(self, task_running: bool = None) -> dict:
1107
1481
  if task_running is not None:
1108
1482
  self.task_running = bool(task_running)
1109
- rec = write_stamp(
1110
- self.name, self.d, task_running=self.task_running, root=self.cg.root,
1111
- uptime=round(time.time() - self._started_at, 3)
1112
- if self._started_at else 0.0,
1113
- **self._progress_fields()) # 进度面随心跳同落(单点状态面)
1483
+ try:
1484
+ rec = write_stamp(
1485
+ self.name, self.d, task_running=self.task_running, root=self.cg.root,
1486
+ uptime=round(time.time() - self._started_at, 3)
1487
+ if self._started_at else 0.0,
1488
+ **self._progress_fields()) # 进度面随心跳同落(单点状态面)
1489
+ except Exception as e: # noqa: BLE001
1490
+ # 写戳失败:台账如实记 error 摘要(「容忍≠静默」),随后**原样抛出**
1491
+ # ——既有行为不变(写戳失败 beat 亦失败,只是现在多一条错误留痕)。
1492
+ record_heartbeat(self.cg.root, self.name, ok=False,
1493
+ error="%s: %s" % (type(e).__name__, e))
1494
+ raise
1114
1495
  self.beats += 1
1115
1496
  self.last_beat = rec["ts"]
1497
+ # 心跳周期台账(append-only,缺省开):写戳成功后再追加一行。**不改返回、
1498
+ # 不改戳**(零判定变更,守卫 L1)——t 取戳的 ts,使台账与戳同源。
1499
+ record_heartbeat(self.cg.root, self.name, ok=True, t=rec["ts"])
1116
1500
  return rec
1117
1501
 
1118
1502
  # ---- 活体进度面(issue #63)----
@@ -1187,6 +1571,13 @@ class SustainLoop:
1187
1571
  fn(*a, **kw)
1188
1572
  except Exception as e: # noqa: BLE001
1189
1573
  ok_ = False
1574
+ if name != "beat":
1575
+ # D2:失败档**必须在台账可见**——非 beat 业务档每轮失败追加
1576
+ # 一条 kind="tick" 行(beat 自身失败已由 beat() 记 ok=False)。
1577
+ record_heartbeat(self.cg.root, name, ok=False,
1578
+ error="%s: %s" % (type(e).__name__,
1579
+ str(e)[:200]),
1580
+ kind=HB_KIND_TICK)
1190
1581
  self.last_tick_error = {"name": name, "t": time.time(),
1191
1582
  "error": "%s: %s" % (type(e).__name__,
1192
1583
  str(e)[:200])}
@@ -1234,6 +1625,12 @@ class SustainLoop:
1234
1625
  self._th = threading.Thread(target=self._run, name="mdcg-sustain",
1235
1626
  daemon=True)
1236
1627
  self._th.start()
1628
+ if beat_thread_enabled():
1629
+ # D1:心跳独立线程(缺省关)——业务档阻塞时心跳仍推进。
1630
+ self._beat_th = threading.Thread(target=self._beat_loop,
1631
+ name="mdcg-sustain-beat",
1632
+ daemon=True)
1633
+ self._beat_th.start()
1237
1634
  return self
1238
1635
 
1239
1636
  # 生效条件:调用时置 _stop 事件,self._th 非 None 时 join(timeout)(默认 3.0)后置为 None,随后 clear_stamp(self.name, self.d),返回 self;
@@ -1242,12 +1639,24 @@ class SustainLoop:
1242
1639
  if self._th is not None:
1243
1640
  self._th.join(timeout)
1244
1641
  self._th = None
1642
+ bt = getattr(self, "_beat_th", None)
1643
+ if bt is not None:
1644
+ bt.join(timeout) # _stop 已置位 ⇒ 心跳线程即刻退出
1645
+ self._beat_th = None
1245
1646
  clear_stamp(self.name, self.d)
1246
1647
  return self
1247
1648
 
1248
1649
  # 生效条件:self._stop 未置位期间轮询(**先调 _wrap_ticks 给六档包上进度面,幂等**),按 beat_interval/heal_interval/scrub_interval/evolve_interval/tidy_interval/**sleep_interval(第六档)** 到期分别执行 beat 与 _tick_heal/_tick_scrub/_tick_evolve/_tick_tidy/_tick_sleep(六档调用形态与既有五档逐字同构:try/except 吞异常 + `_stop.wait(_POLL)` 收尾;进/出读数与异常记录由包装单点提供——issue #63);
1249
1650
  def _run(self):
1250
1651
  self._wrap_ticks() # issue #63:六档包上进度面(幂等,形态不变)
1652
+ # issue #207 T1(2026-10-13 DSH 端):beat 的**调度源**在开启独立心跳线程后
1653
+ # 应当**转移**而不是**叠加**。原实现下 start() 起了 _beat_loop 线程,
1654
+ # 而本循环仍在按 beat_interval 调 beat() —— 两路叠加,心跳与台账行数按
1655
+ # 倍率翻倍(实测 OFF=30 / ON=59 @0.2s),且 status()["beats"] 这一对外
1656
+ # 读数随之失真(uptime/beats 被外部用来推「转过多少轮」)。
1657
+ # 本函数自己的 docstring 写的就是「唯一改动的是 beat 的**调度源**」——
1658
+ # 是转移语义。缺省关时本标志恒为 True,既有单线程基线逐位不变。
1659
+ own_beat = not beat_thread_enabled()
1251
1660
  next_beat = time.time() + self.beat_interval
1252
1661
  next_heal = time.time() + self.heal_interval
1253
1662
  next_scrub = time.time() + self.scrub_interval
@@ -1256,7 +1665,7 @@ class SustainLoop:
1256
1665
  next_sleep = time.time() + self.sleep_interval
1257
1666
  while not self._stop.is_set():
1258
1667
  now = time.time()
1259
- if now >= next_beat:
1668
+ if own_beat and now >= next_beat:
1260
1669
  try:
1261
1670
  self.beat()
1262
1671
  except Exception:
@@ -1294,6 +1703,22 @@ class SustainLoop:
1294
1703
  next_sleep = now + self.sleep_interval
1295
1704
  self._stop.wait(_POLL)
1296
1705
 
1706
+ # ---- D1:心跳独立线程(缺省关)----
1707
+
1708
+ # 生效条件:由 start() 在 beat_thread_enabled() 为真时起一条 daemon 线程执行;循环里每 beat_interval 调一次 self.beat(),异常吞掉(心跳失败不拖垮常驻),_stop 置位即退出。
1709
+ def _beat_loop(self):
1710
+ """独立心跳线程体(D1):与业务档**不共用执行体**——业务档阻塞时心跳仍推进。
1711
+
1712
+ 唯一改动的是 beat 的**调度源**(多一条线程),复用既有 `beat()`(写戳 +
1713
+ 台账,纯追加、无共享可变状态);缺省关时本线程不启动,既有单线程基线
1714
+ 逐位不变。线程退出由 `_stop` 事件驱动(`stop()` 置位后 wait 立即返回)。
1715
+ """
1716
+ while not self._stop.wait(self.beat_interval):
1717
+ try:
1718
+ self.beat()
1719
+ except Exception: # noqa: BLE001
1720
+ pass # 心跳失败不中断常驻
1721
+
1297
1722
  # 生效条件:以 apply=self.auto_tidy 调 writelimit.tidy_contextual(self.cg, actor="sustain_tidy"),把 t/scanned/groups/members/applied_count/auto_tidy 记入 self.last_tidy 与 tidys(仅保留最近 20 条),随后调 _tick_conformance();auto_tidy 为假时只盘点不落盘;
1298
1723
  def _tick_tidy(self):
1299
1724
  """整理巡检(contextual 流水治理·读侧):同构组聚合 + 成员降权。
@@ -1393,19 +1818,33 @@ class SustainLoop:
1393
1818
  self.evolves.append(rec)
1394
1819
  self.evolves = self.evolves[-20:]
1395
1820
 
1396
- # 生效条件:以 dry_run=not self.auto_scrub 调 scrub.sweep(self.cg),把 t/ok/n_issues/n_high_medium/applied/dry_run 记入 last_scrub 与 scrubs(保留最近 20 条);auto_scrub=False(默认)时 dry_run=True 只读巡检;
1821
+ # 生效条件:self.scrub_round 自增后以 seed=f"sustain:{self.scrub_round}"、dry_run=not self.auto_scrub 调 scrub.sweep(self.cg),把 t/ok/n_issues/n_high_medium/applied/already_handled/planned_dry_run/checked_breakdown/seed/dry_run 记入 last_scrub 与 scrubs(保留最近 20 条);auto_scrub=False(默认)时 dry_run=True 只读巡检;
1397
1822
  def _tick_scrub(self):
1398
1823
  """记忆自净:抽查 → 联想 → 去污染 → 校准偏差。
1399
1824
 
1400
1825
  `auto_scrub=False`(默认)时只做只读巡检并记账,不动任何节点;
1401
1826
  开启后才执行去污染(仍只做可逆动作、永不删节点)。
1827
+
1828
+ 抽样轮转(issue #66):seed 按**轮次**派生(`scrub_round` 每 tick
1829
+ 自增)——固定 seed=0 会让每轮样本逐字相同(抽样面冻结,「老面孔」
1830
+ 长期占用名额);库层 `scrub.sample` 的缺省 seed=0 不变(显式调用的
1831
+ 可复现性不受影响)。
1402
1832
  """
1403
1833
  from . import scrub
1404
- rep = scrub.sweep(self.cg, dry_run=not self.auto_scrub)
1834
+ self.scrub_round += 1
1835
+ seed = f"sustain:{self.scrub_round}"
1836
+ rep = scrub.sweep(self.cg, dry_run=not self.auto_scrub, seed=seed)
1837
+ dec = rep["decontaminate"]
1405
1838
  rec = {"t": rep["t"], "ok": rep["ok"],
1406
1839
  "n_issues": rep["audit"]["n_issues"],
1407
1840
  "n_high_medium": rep["n_high_medium"],
1408
- "applied": rep["decontaminate"]["applied"],
1841
+ "applied": dec["applied"],
1842
+ # 覆盖账(issue #66):轮读数可区分「旧面孔(名单命中跳过)」
1843
+ # 与「本轮检查」(dry_run 轮是常驻默认下唯一的账)。
1844
+ "already_handled": dec["already_handled"],
1845
+ "planned_dry_run": dec["planned_dry_run"],
1846
+ "checked_breakdown": dec["checked_breakdown"],
1847
+ "seed": seed,
1409
1848
  "dry_run": rep["dry_run"]}
1410
1849
  self.last_scrub = rec
1411
1850
  with self._lock: