@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
@@ -1,624 +1,652 @@
1
- # -*- coding: utf-8 -*-
2
- """常驻循环卡死防护与观测守卫(issue #63)。
3
-
4
- 背景(外部 issue #63 三条根因,全部本文件钉死):
5
-
6
- ① `sleep._git()` **无 timeout=**——子进程无界等待(实测停 9.5 小时);
7
- ② 同处**未指定 stdin** ⇒ 子进程继承父进程 stdin(DSH 常驻宿主的
8
- JSON-RPC 活管道)——活管道下读 stdin 的子进程永不 EOF;
9
- ③ tick 台账在 `run_cycle` **返回后**才写 ⇒ 卡住期间外部无法知道卡在哪档
10
- (`phases` 空)。
11
-
12
- 修法的可判据面:
13
-
14
- T1 参数面——`sleep._git` 调 `subprocess.run` 必带
15
- `timeout=_GIT_TIMEOUT_S` 与 `stdin=subprocess.DEVNULL`(捕获 kwargs 判据);
16
- 旁证(机理复现,等价形态):活管道(PIPE 不写不关)下读 stdin 的子进程
17
- 悬挂;DEVNULL 下 0.02s 级立即 EOF 返回。旁证二:真挂起子进程 + 同形态
18
- timeout → 真 `TimeoutExpired` 且有界(本机 Python 超时机制在位)。
19
- T2 真超时——替身按 `subprocess.run(timeout=)` 契约行事(跑满一个 timeout
20
- 后抛 `TimeoutExpired`):`_git_ok` 抛 `SleepError`(`SleepGitTimeout`),
21
- 消息含「超时」「已被 kill」与命令名,耗时 **≈ timeout(有界)**;
22
- 并钉「可区分」:rc≠0 走「失败」文案、与超时文案分开。
23
- T3 循环续走回归——某档 tick 抛异常 → `_run` 不中断(该档下一轮照常,
24
- 其它档不受影响)——既有能力回归。
25
- T4 进度面——tick 入口写 `current_tick`(且**进入即刷既有心跳戳**)/ 出口清
26
- 并记 `last_tick_done`;失败档记 `last_tick_error`(容忍≠静默);`status`
27
- 展示三字段;构造过期 `current_tick` → `status` 报 `stale_tick`
28
- (含档名与已运行时长;负对照:未超不报)。
29
- T5 审计断言——interop / audit / units / bench×3 / sleep 的 `subprocess.run`
30
- 调用(AST 参数面)带 timeout 与 `stdin=DEVNULL`;whitebox 的 Popen
31
- 保持协议面原形态(stdin=PIPE,**不在加固面**)。
32
-
33
- 运行:python -X utf8 -m md_cg.test_sustain_bounded
34
- python -X utf8 -m md_cg.test_sustain_bounded --mutate # 变异自证
35
- python -X utf8 -m md_cg.test_sustain_bounded --mutate --list # 只列变异表
36
- python -X utf8 -m md_cg.test_sustain_bounded --mutate --null # 空转检出对照
37
-
38
- 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红;
39
- 2 = ANCHOR-MISS(变异锚点在当前源码里找不到——实现改了却没同步本表)。
40
-
41
- **红项口径(复核打回修复,2026-10-06)**:每条变异的「自身红项」= 该条运行
42
- 前后 `_FAIL` 长度差——**不得**拿 `len(_FAIL)` 当本轮红项(累计值恒非空,
43
- 会让「判据空转」检测失效、空转变异被静默放行);红项行**全量**打印且与
44
- 自身红项数**账实相符**(不符按失败判)。该缺陷类别由 `--mutate --null`
45
- (new==old 的无害变异必须被判 MISS)钉住。
46
-
47
- **基线纪律**:不以 git HEAD 为基线源——「改动前形态」由在当前工作区源码上做
48
- **定点文本变异**(`_MUTATIONS`)复现,锚点漂移即退出码 2。
49
- """
50
- from __future__ import annotations
51
-
52
- import ast
53
- import contextlib
54
- import io
55
- import os
56
- import shutil
57
- import subprocess
58
- import sys
59
- import tempfile
60
- import time
61
- import types
62
-
63
- from . import sleep as SL
64
- from . import sustain as SUS
65
-
66
- _PASS = []
67
- _FAIL = []
68
- _SRC = {}
69
- _TMP = tempfile.mkdtemp(prefix="mdcg_bounded_")
70
- _SAVED = {}
71
- _REAL_SL = SL
72
- _REAL_SUS = SUS
73
-
74
- _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
75
-
76
- #: T5 的审计面:这些文件里的 `subprocess.run` 调用必须带 timeout 与
77
- #: stdin=DEVNULL(issue #63 同批加固);whitebox 的 Popen 单列(不在加固面)。
78
- _AUDIT_RUN_FILES = ("md_cg/sleep.py", "md_cg/interop.py", "md_cg/audit.py",
79
- "md_cg/units.py", "md_cg/bench_locomo_zh.py",
80
- "md_cg/bench_zh_mad.py", "md_cg/bench_governance.py")
81
- #: 不在加固面的既有正确形态(免误伤):whitebox 的 Popen 是**长驻对话协议面**
82
- #: (stdin=PIPE 与后端持续对话,给 DEVNULL 会改变协议语义)。
83
- _WHITEBOX_REL = "md_cg/whitebox.py"
84
-
85
-
86
- def ok(cond, msg, extra=""):
87
- (_PASS if cond else _FAIL).append(msg)
88
- print((" PASS " if cond else " FAIL ") + msg
89
- + ((" ← " + str(extra)) if (extra and not cond) else ""))
90
-
91
-
92
- def _rel_text(rel: str) -> str:
93
- if rel in _SRC:
94
- return _SRC[rel]
95
- with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
96
- return f.read()
97
-
98
-
99
- def _sandbox_env():
100
- for k in ("MDCG_ROOT", "MDCG_AUX_ROOT", "MDCG_STATE_ROOT",
101
- "MDCG_SUSTAIN_DIR", "MDCG_SUSTAIN", "MDCG_SLEEP_GITDIR",
102
- "MDCG_SLEEP_SHADOW"):
103
- _SAVED[k] = os.environ.get(k)
104
- os.environ.pop(k, None)
105
- os.environ["MDCG_SUSTAIN_DIR"] = os.path.join(_TMP, "sustain")
106
- os.environ["MDCG_ROOT"] = os.path.join(_TMP, "data")
107
-
108
-
109
- def _restore_env():
110
- for k, v in _SAVED.items():
111
- if v is None:
112
- os.environ.pop(k, None)
113
- else:
114
- os.environ[k] = v
115
-
116
-
117
- class _FakeCG:
118
- """最小 cg 替身:SustainLoop 只消费 .root(写戳 / 会话账本读点)。"""
119
-
120
- def __init__(self, root):
121
- self.root = root
122
-
123
-
124
- def _new_loop(**kw):
125
- root = os.path.join(_TMP, "data")
126
- os.makedirs(root, exist_ok=True)
127
- d = os.path.join(_TMP, "sustain")
128
- os.makedirs(d, exist_ok=True)
129
- kw.setdefault("name", "md_cg_bounded")
130
- kw.setdefault("auto_sleep", True)
131
- kw.setdefault("sleep_merge", "auto")
132
- kw.setdefault("sleep_window", "")
133
- kw.setdefault("sleep_scrub_apply", False)
134
- return SUS.SustainLoop(_FakeCG(root), d=d, **kw)
135
-
136
-
137
- # ---------------------------------------------------------------- T1
138
- def t1():
139
- print("== T1 参数面:_git 必带 timeout=_GIT_TIMEOUT_S 与 stdin=DEVNULL ==")
140
- S = globals()["SL"]
141
- real_run = subprocess.run
142
- calls = []
143
-
144
- def fake(argv, **kw):
145
- calls.append((list(argv), dict(kw)))
146
- return subprocess.CompletedProcess(argv, 0, stdout="", stderr="")
147
-
148
- subprocess.run = fake
149
- try:
150
- S._git("<G>", "<root>", "status", "--short")
151
- finally:
152
- subprocess.run = real_run
153
- ok(len(calls) == 1, "T1 前置:_git 恰调 subprocess.run 一次", calls)
154
- if calls:
155
- argv, kw = calls[0]
156
- # 回显面**剔除 env**(含本机敏感变量,纪律第 9 条:敏感信息隔离)
157
- safe = {k: v for k, v in kw.items() if k != "env"}
158
- ok(argv[:3] == ["git", "--git-dir=<G>", "--work-tree=<root>"],
159
- "T1a argv 显式 --git-dir / --work-tree(唯一出口形态不变)", argv)
160
- ok(kw.get("timeout") == S._GIT_TIMEOUT_S
161
- and isinstance(kw.get("timeout"), (int, float)),
162
- "T1b **_git 必带 timeout=_GIT_TIMEOUT_S**(%r)——无界等待被闸住"
163
- % (kw.get("timeout"),), safe)
164
- ok(kw.get("stdin") is subprocess.DEVNULL,
165
- "T1c **_git 必带 stdin=subprocess.DEVNULL**——不继承父进程 stdin"
166
- "(常驻宿主下是 JSON-RPC 活管道)", safe)
167
- ok(kw.get("shell") is False and kw.get("capture_output") is True,
168
- "T1d 既有形态保持(shell=False + capture_output=True)", safe)
169
- ok((kw.get("env") or {}).get("PYTHONUTF8") == "1",
170
- "T1e env 带 PYTHONUTF8=1(既有形态保持;不回显 env 内容)")
171
-
172
- # 机理旁证(等价形态):活管道 ⇒ 读 stdin 的子进程悬挂;DEVNULL ⇒ 立即 EOF
173
- code = "import sys\nsys.stdin.read()\nprint('EOF-OK')\n"
174
- p = subprocess.Popen([sys.executable, "-c", code], stdin=subprocess.PIPE,
175
- stdout=subprocess.PIPE, stderr=subprocess.PIPE,
176
- text=True, encoding="utf-8", errors="replace")
177
- try:
178
- time.sleep(0.6)
179
- hung = p.poll() is None
180
- finally:
181
- p.kill()
182
- with contextlib.suppress(Exception):
183
- p.communicate(timeout=5)
184
- ok(hung, "T1f 机理旁证:**活管道**(PIPE 不写不关)下读 stdin 的子进程"
185
- "悬挂(poll=None;DSH JSON-RPC 管道的等价形态)")
186
- t0 = time.time()
187
- r = subprocess.run([sys.executable, "-c", code], stdin=subprocess.DEVNULL,
188
- capture_output=True, text=True, encoding="utf-8",
189
- errors="replace", timeout=15)
190
- dt = time.time() - t0
191
- ok(r.returncode == 0 and "EOF-OK" in (r.stdout or ""),
192
- "T1g 机理旁证:**stdin=DEVNULL** 下同一子进程立即 EOF 返回"
193
- "(%.2fs)" % dt, (r.returncode, r.stdout, r.stderr))
194
- t0 = time.time()
195
- timed_out = False
196
- try:
197
- subprocess.run([sys.executable, "-c", "import time; time.sleep(30)"],
198
- stdin=subprocess.DEVNULL, capture_output=True,
199
- timeout=0.5)
200
- except subprocess.TimeoutExpired:
201
- timed_out = True
202
- dt = time.time() - t0
203
- ok(timed_out and dt < 5.0,
204
- "T1h 机理旁证:真子进程 + timeout → 真 TimeoutExpired 且有界"
205
- "(%.2fs)——本机 timeout 机制在位" % dt)
206
-
207
-
208
- # ---------------------------------------------------------------- T2
209
- def t2():
210
- print("== T2 真超时:SleepError + 耗时≈timeout(有界)+ 消息含「超时」 ==")
211
- S = globals()["SL"]
212
- g = S._git.__globals__
213
- real_run = subprocess.run
214
- real_tmo = g["_GIT_TIMEOUT_S"]
215
- calls = []
216
-
217
- def fake(argv, **kw):
218
- """按 `subprocess.run(timeout=)` 契约行事:跑满一个 timeout 后 kill 抛出。
219
-
220
- 无 timeout(旧形态)⇒ 跑满 2s 才返回(无界等待的等价模拟——T1b/T2a
221
- 会在该形态下转红)。
222
- """
223
- calls.append((list(argv), dict(kw)))
224
- tmo = kw.get("timeout")
225
- if tmo is None:
226
- time.sleep(2.0)
227
- return subprocess.CompletedProcess(argv, 0, stdout="", stderr="")
228
- time.sleep(float(tmo))
229
- raise subprocess.TimeoutExpired(cmd=argv, timeout=float(tmo))
230
-
231
- g["_GIT_TIMEOUT_S"] = 0.3 # 测试用短 timeout(模块单点可调)
232
- subprocess.run = fake
233
- t0 = time.time()
234
- raised = None
235
- try:
236
- try:
237
- S._git_ok("<G>", "<root>", "status")
238
- except S.SleepError as e:
239
- raised = e
240
- finally:
241
- subprocess.run = real_run
242
- g["_GIT_TIMEOUT_S"] = real_tmo
243
- dt = time.time() - t0
244
- ok(raised is not None and isinstance(raised, S.SleepGitTimeout),
245
- "T2a 超时**不吞**:_git/_git_ok 抛 SleepError(SleepGitTimeout)", raised)
246
- ok(raised is not None and "超时" in str(raised),
247
- "T2b 消息含「超时」", str(raised))
248
- ok(raised is not None and "已被 kill" in str(raised),
249
- "T2c 消息含「已被 kill」(kill 语义明示)", str(raised))
250
- ok(raised is not None and "status" in str(raised),
251
- "T2d 消息含命令名", str(raised))
252
- ok(raised is not None and "index.lock" in str(raised),
253
- "T2e 消息含残留锁人工核删指引(不自动删)", str(raised))
254
- ok(raised is not None and dt <= 0.3 * 3,
255
- "T2f **耗时有界**(≈timeout:%.2fs ≤ 3×0.3s)——不是无界等待" % dt, dt)
256
-
257
- # 可区分(issue #63):rc≠0 的失败走「失败」文案,与超时面分开
258
- def fake_fail(argv, **kw):
259
- return subprocess.CompletedProcess(argv, 1, stdout="",
260
- stderr="fatal: boom")
261
-
262
- subprocess.run = fake_fail
263
- raised2 = None
264
- try:
265
- try:
266
- S._git_ok("<G>", "<root>", "status")
267
- except S.SleepError as e2:
268
- raised2 = e2
269
- finally:
270
- subprocess.run = real_run
271
- ok(raised2 is not None and "失败" in str(raised2)
272
- and "超时" not in str(raised2),
273
- "T2g **可区分**:rc≠0 走「失败」文案、不含「超时」(两条失败面分开)",
274
- str(raised2))
275
-
276
-
277
- # ---------------------------------------------------------------- T3
278
- def t3():
279
- print("== T3 循环续走回归:某档抛异常 → _run 不中断(下一轮照常)==")
280
- lp = _new_loop(beat_interval=30.0, heal_interval=0.15, scrub_interval=0.3,
281
- evolve_interval=60.0, tidy_interval=60.0,
282
- sleep_interval=60.0)
283
- log = []
284
-
285
- def bad():
286
- log.append(("heal", time.time()))
287
- raise RuntimeError("t3-fail-once")
288
-
289
- def good():
290
- log.append(("scrub", time.time()))
291
-
292
- lp._tick_heal = bad
293
- lp._tick_scrub = good
294
- lp._tick_evolve = lambda: log.append(("evolve", time.time()))
295
- lp._tick_tidy = lambda: log.append(("tidy", time.time()))
296
- lp._tick_sleep = lambda: log.append(("sleep", time.time()))
297
- lp.start()
298
- try:
299
- time.sleep(1.1)
300
- finally:
301
- lp.stop()
302
- n_heal = sum(1 for t, _ in log if t == "heal")
303
- n_scrub = sum(1 for t, _ in log if t == "scrub")
304
- ok(n_heal >= 2,
305
- "T3a 某档 tick 抛异常后**不中断**:该档下一轮照常调度(heal×%d)"
306
- % n_heal, log)
307
- ok(n_scrub >= 1,
308
- "T3b 其它档不受影响(scrub×%d)" % n_scrub, log)
309
- ok(lp.last_tick_error is not None
310
- and lp.last_tick_error.get("name") == "heal"
311
- and "RuntimeError: t3-fail-once" in lp.last_tick_error.get("error", ""),
312
- "T3c 异常**不再全静默**:last_tick_error 记 {档名, 类名+摘要}",
313
- lp.last_tick_error)
314
- ok(lp.last_tick_done is not None and lp.last_tick_done.get("ok") is False,
315
- "T3d last_tick_done 记 ok=False(失败档)", lp.last_tick_done)
316
-
317
-
318
- # ---------------------------------------------------------------- T4
319
- def t4():
320
- print("== T4 进度面:current_tick / last_tick_done / last_tick_error / "
321
- "stale_tick ==")
322
- lp = _new_loop()
323
- seen = {}
324
-
325
- def fn():
326
- seen["mem"] = lp.current_tick
327
- seen["stamp"] = SUS.read_stamp(lp.name, lp.d)
328
-
329
- lp._wrap_tick("scrub", fn)()
330
- ct = seen.get("mem") or {}
331
- ok(ct.get("name") == "scrub" and "started_at" in ct
332
- and ct.get("pid") == os.getpid(),
333
- "T4a tick 入口写 current_tick={name, started_at, pid}", ct)
334
- ok(((seen.get("stamp") or {}).get("current_tick") or {}).get("name")
335
- == "scrub",
336
- "T4a2 **进入档即刷既有状态面**(心跳戳里读得到 current_tick——"
337
- "卡住场景下也读得到)", seen.get("stamp"))
338
- ok(lp.current_tick is None,
339
- "T4b tick 出口清 current_tick", lp.current_tick)
340
- ok(lp.last_tick_done is not None
341
- and lp.last_tick_done.get("name") == "scrub"
342
- and lp.last_tick_done.get("ok") is True
343
- and "t" in lp.last_tick_done,
344
- "T4b2 tick 出口记 last_tick_done={name, t, ok}", lp.last_tick_done)
345
-
346
- lp._wrap_tick("heal", lambda: (_ for _ in ()).throw(ValueError("t4-e")))()
347
- ok(lp.last_tick_error is not None
348
- and lp.last_tick_error.get("name") == "heal"
349
- and "ValueError: t4-e" in lp.last_tick_error.get("error", ""),
350
- "T4c 失败档记 last_tick_error(类名+摘要)", lp.last_tick_error)
351
- ok(lp.last_tick_done is not None and lp.last_tick_done.get("ok") is False,
352
- "T4c2 失败档 last_tick_done.ok=False", lp.last_tick_done)
353
-
354
- st = lp.status()
355
- ok("current_tick" in st and "last_tick_done" in st
356
- and "last_tick_error" in st,
357
- "T4d status 输出含进度三字段(cg(op=sustain,action=status) 同源)",
358
- sorted(st))
359
- ok(st["last_tick_done"]["name"] == "heal"
360
- and st["last_tick_done"]["ok"] is False,
361
- "T4d2 status 的 last_tick_done 反映最近一档(失败态可见)", st["last_tick_done"])
362
-
363
- lp.current_tick = {"name": "sleep", "started_at": time.time() - 9000.0,
364
- "pid": os.getpid()}
365
- st2 = lp.status()
366
- ok(bool(st2["stale_tick"]) and st2["stale_tick"].get("tick") == "sleep",
367
- "T4e 过期 current_tick → status 报 stale_tick(档名=sleep)",
368
- st2["stale_tick"])
369
- ok(bool(st2["stale_tick"])
370
- and "sleep" in st2["stale_tick"].get("alert", "")
371
- and "9000" in st2["stale_tick"].get("alert", ""),
372
- "T4e2 stale_tick.alert 含档名与已运行时长", st2["stale_tick"])
373
- ok(st2["current_tick"].get("running_s") >= 9000,
374
- "T4e3 current_tick 附已运行秒数 running_s", st2["current_tick"])
375
- lp.current_tick = {"name": "sleep", "started_at": time.time() - 10.0,
376
- "pid": os.getpid()}
377
- ok(lp.status()["stale_tick"] is None,
378
- "T4f 负对照:未超阈值不报 stale_tick(不误报)")
379
- # 跨进程回落:内存清空后仍能从既有状态面读到(写点是戳,不是内存独有)
380
- lp.last_tick_done = None
381
- st3 = lp.status()
382
- ok(st3["last_tick_done"] is not None,
383
- "T4g 跨进程回落:内存清空后 last_tick_done 仍可从戳读到",
384
- st3["last_tick_done"])
385
-
386
-
387
- # ---------------------------------------------------------------- T5
388
- def t5():
389
- print("== T5 审计断言:加固面 subprocess.run 带 timeout+DEVNULL;"
390
- "whitebox Popen 保持协议面 ==")
391
-
392
- def run_calls(rel):
393
- tree = ast.parse(_rel_text(rel))
394
- out = []
395
- for node in ast.walk(tree):
396
- if (isinstance(node, ast.Call)
397
- and isinstance(node.func, ast.Attribute)
398
- and node.func.attr == "run"
399
- and isinstance(node.func.value, ast.Name)
400
- and node.func.value.id == "subprocess"):
401
- out.append(node)
402
- return out
403
-
404
- def has_kw(node, key, devnull=False):
405
- for kw in node.keywords:
406
- if kw.arg != key:
407
- continue
408
- if not devnull:
409
- return True
410
- v = kw.value
411
- return (isinstance(v, ast.Attribute) and v.attr == "DEVNULL"
412
- and isinstance(v.value, ast.Name)
413
- and v.value.id == "subprocess")
414
- return False
415
-
416
- for rel in _AUDIT_RUN_FILES:
417
- nodes = run_calls(rel)
418
- ok(len(nodes) >= 1, "T5 前置:%s 内有 subprocess.run 调用(%d 处)"
419
- % (rel, len(nodes)))
420
- for i, node in enumerate(nodes, 1):
421
- ok(has_kw(node, "timeout"),
422
- "T5a %s:%d subprocess.run 带 timeout=" % (rel, node.lineno))
423
- ok(has_kw(node, "stdin", devnull=True),
424
- "T5b %s:%d subprocess.run 带 stdin=subprocess.DEVNULL"
425
- % (rel, node.lineno))
426
-
427
- # whitebox:长驻对话协议面(stdin=PIPE)——**不在加固面**,保持原形态
428
- tree = ast.parse(_rel_text(_WHITEBOX_REL))
429
- popens = [n for n in ast.walk(tree)
430
- if isinstance(n, ast.Call)
431
- and isinstance(n.func, ast.Attribute)
432
- and n.func.attr == "Popen"
433
- and isinstance(n.func.value, ast.Name)
434
- and n.func.value.id == "subprocess"]
435
- ok(len(popens) >= 1, "T5c 前置:whitebox.py 内有 subprocess.Popen(%d 处)"
436
- % len(popens))
437
- for node in popens:
438
- stdin_kw = next((kw for kw in node.keywords if kw.arg == "stdin"), None)
439
- ok(stdin_kw is not None
440
- and isinstance(stdin_kw.value, ast.Attribute)
441
- and stdin_kw.value.attr == "PIPE",
442
- "T5d whitebox Popen 保持协议面原形态(stdin=PIPE,不加固)"
443
- "(%s:%d)" % (_WHITEBOX_REL, node.lineno))
444
-
445
-
446
- # ---------------------------------------------------------------- 变异表
447
- # 锚点 = (名字, rel, old, new)。每次变异必须让套件**转红**:
448
- # M1 主修删 timeout=(_git 退回无界等待)→ T1b / T2a 红
449
- # M2 主修删 stdin=DEVNULL(子进程继承活管道 stdin)→ T1c 红
450
- # M3 进度面删「进入写点」→ T4a / T4a2 红
451
- # M4 六档 except 删 last_tick_error 记录(退回全静默)→ T3c / T4c 红
452
- _MUTATIONS = (
453
- ("删 timeout=(_git 退回无界等待)", "md_cg/sleep.py",
454
- " env=env, shell=False,\n"
455
- " timeout=_GIT_TIMEOUT_S,\n"
456
- " stdin=subprocess.DEVNULL)",
457
- " env=env, shell=False,\n"
458
- " stdin=subprocess.DEVNULL)"),
459
- ("删 stdin=DEVNULL(继承活管道 stdin)", "md_cg/sleep.py",
460
- " env=env, shell=False,\n"
461
- " timeout=_GIT_TIMEOUT_S,\n"
462
- " stdin=subprocess.DEVNULL)",
463
- " env=env, shell=False,\n"
464
- " timeout=_GIT_TIMEOUT_S)"),
465
- ("删进度面进入写点(卡住读不到档)", "md_cg/sustain.py",
466
- ' self.current_tick = {"name": name, "started_at": time.time(),\n'
467
- ' "pid": os.getpid()}\n'
468
- ' self._flush_progress()\n',
469
- ""),
470
- ("删失败档 last_tick_error(退回全静默)", "md_cg/sustain.py",
471
- " except Exception as e: # noqa: BLE001\n"
472
- " ok_ = False\n"
473
- " self.last_tick_error = {\"name\": name, \"t\": time.time(),\n"
474
- " \"error\": \"%s: %s\" % (type(e).__name__,\n"
475
- " str(e)[:200])}\n",
476
- " except Exception: # noqa: BLE001\n"
477
- " ok_ = False\n"),
478
- )
479
-
480
- #: 空转检出对照(meta 自证,`--mutate --null`):new==old 的「无害变异」——
481
- #: 行为零变化、自身红项必须为 0 且被判 MISS。若哪天「本轮红项」判定口径
482
- #: 退化为累计计数(累计恒非空),本对照立即转 FAIL(钉住的正是复核打回
483
- #: 实证过的那条假阳性通道)。锚点取 `_git` 调用里一行行为零变化的文本。
484
- _NULL_MUTATION = ("空转对照(new==old,行为零变化)", "md_cg/sleep.py",
485
- " env=env, shell=False,\n",
486
- " env=env, shell=False,\n")
487
-
488
-
489
- def _exec_module(name: str, rel: str, text: str):
490
- ns = {"__name__": name, "__package__": "md_cg",
491
- "__file__": os.path.join(_REPO, rel)}
492
- exec(compile(text, rel, "exec"), ns) # noqa: S102 —— 基线自证用
493
- m = types.ModuleType(name)
494
- m.__dict__.update(ns)
495
- return m
496
-
497
-
498
- def _run_groups() -> int:
499
- for fn in (t1, t2, t3, t4, t5):
500
- try:
501
- fn()
502
- except Exception as e: # noqa: BLE001
503
- ok(False, "%s 组抛异常:%s: %s" % (fn.__name__, type(e).__name__, e))
504
- return len(_FAIL)
505
-
506
-
507
- def _mutate_once(name: str, rel: str, old: str, new: str):
508
- """跑一条变异并返回**本轮自身**读数 (reds_self, reds_lines, detail)。
509
-
510
- 红项口径(复核打回修复,2026-10-06):`_FAIL` 是**全局累计**列表,
511
- 故「本轮红项」必须取**调用前后长度差**——直接拿 `len(_FAIL)` 当本轮
512
- 红项会让「判据空转」检测失效(累计值恒非空 ⇒ 空转变异也会被记成
513
- 「红」并放行)。本轮自身红项还须与输出里 FAIL 行数**账实相符**。
514
- """
515
- src = _rel_text(rel)
516
- if old not in src:
517
- return None, [], "ANCHOR-MISS:锚点在 %s 源码里找不到(实现改了却没同步" \
518
- "本表)" % rel
519
- base = len(_FAIL) # 本轮起点:只数本轮自身的红项
520
- _SRC[rel] = src.replace(old, new, 1)
521
- try:
522
- mut = _exec_module("md_cg._bounded_mut", rel, _SRC[rel])
523
- if rel == "md_cg/sleep.py":
524
- globals()["SL"] = mut
525
- else:
526
- globals()["SUS"] = mut
527
- with contextlib.redirect_stdout(buf := io.StringIO()):
528
- _run_groups()
529
- detail = buf.getvalue()
530
- finally:
531
- globals()["SL"] = _REAL_SL
532
- globals()["SUS"] = _REAL_SUS
533
- _SRC.pop(rel, None)
534
- reds = len(_FAIL) - base # **本轮自身**红项数
535
- reds_lines = [l for l in detail.splitlines()
536
- if l.strip().startswith("FAIL ")]
537
- return reds, reds_lines, detail
538
-
539
-
540
- def _mutate_mode(list_only: bool = False) -> int:
541
- print("!! 定点变异自证:逐条把机制改回「改动前/错误」形态,套件必须转红"
542
- "(红项 = 本轮自身,非法用全局累计值)\n")
543
- if list_only:
544
- for name, rel, _o, _n in _MUTATIONS:
545
- print(" %-38s [%s]" % (name, rel))
546
- return 0
547
- anchor_miss, bad = [], []
548
- base0 = len(_FAIL)
549
- with contextlib.redirect_stdout(io.StringIO()):
550
- _run_groups()
551
- clean = len(_FAIL) - base0
552
- print(" 未变异基线:失败=%d(必须为 0)" % clean)
553
- if clean:
554
- bad.append("未变异基线即失败")
555
-
556
- for name, rel, old, new in _MUTATIONS:
557
- reds, reds_lines, detail = _mutate_once(name, rel, old, new)
558
- if reds is None:
559
- print(" ANCHOR-MISS %s —— %s" % (name, detail))
560
- anchor_miss.append(name)
561
- continue
562
- verdict = "红" if reds else "**仍全绿 = 该判据空转**"
563
- print(" %s %-38s 自身红项=%d(本轮;基线=%d) %s"
564
- % ("OK " if reds else "MISS ", name, reds, clean, verdict))
565
- for l in reds_lines: # **全量**打印(回报即读数,不截断)
566
- print(" " + l.strip()[5:])
567
- if len(reds_lines) != reds:
568
- # 账实不符 = 计数面自身有缺陷——按失败判(fail-closed)
569
- print(" !账实不符:FAIL 行数=%d ≠ 自身红项=%d——计数面缺陷"
570
- % (len(reds_lines), reds))
571
- bad.append(name + "(账实不符)")
572
- if not reds:
573
- bad.append(name)
574
-
575
- if anchor_miss:
576
- print("\nANCHOR-MISS:%s" % "、".join(anchor_miss))
577
- print("退出码 2(fail-closed):变异表锚点漂移即判失败,不得静默跳过")
578
- return 2
579
- print("\n定点变异自证:%s"
580
- % ("PASS(每处机制都有一条断言把它钉死)" if not bad
581
- else "FAIL —— " + "、".join(bad)))
582
- return 0 if not bad else 1
583
-
584
-
585
- def _null_mode() -> int:
586
- """空转检出对照(meta 自证):new==old 的「无害变异」必须被判 MISS。
587
-
588
- 钉住的缺陷类别(复核打回实证):若「本轮红项」误用全局累计值(累计恒
589
- 非空),空转变异会被记成「红」并放行——`--mutate` 的 fail-closed 承诺
590
- (「变异未按预期转红 = 退出码 1」)随之失效。本对照即钉住该检出能力。
591
- """
592
- print("!! 空转检出对照:一条 new==old 的「无害变异」——必须被判 MISS"
593
- "(不得凭任何累计值蒙混)\n")
594
- name, rel, old, new = _NULL_MUTATION
595
- reds, reds_lines, detail = _mutate_once(name, rel, old, new)
596
- if reds is None:
597
- print(" ANCHOR-MISS %s —— %s" % (name, detail))
598
- return 2
599
- detected = reds == 0 and not reds_lines
600
- print(" 变异=%s 自身红项=%d(本轮) FAIL 行数=%d ⇒ %s"
601
- % (name, reds, len(reds_lines),
602
- "MISS(如期检出空转,判定有效)" if detected
603
- else "红(**空转漏检 = 判据失效**,fail-closed 不成立)"))
604
- print("空转检出对照:%s" % ("PASS" if detected else "FAIL"))
605
- return 0 if detected else 1
606
-
607
-
608
- def main() -> int:
609
- _sandbox_env()
610
- try:
611
- if "--mutate" in sys.argv:
612
- if "--null" in sys.argv:
613
- return _null_mode()
614
- return _mutate_mode("--list" in sys.argv)
615
- n = _run_groups()
616
- print("\nSUMMARY: 常驻卡死防护守卫:%d 通过,%d 失败" % (len(_PASS), n))
617
- return 0 if not n else 1
618
- finally:
619
- _restore_env()
620
- shutil.rmtree(_TMP, ignore_errors=True)
621
-
622
-
623
- if __name__ == "__main__":
624
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """常驻循环卡死防护与观测守卫(issue #63)。
3
+
4
+ 背景(外部 issue #63 三条根因,全部本文件钉死):
5
+
6
+ ① `sleep._git()` **无 timeout=**——子进程无界等待(实测停 9.5 小时);
7
+ ② 同处**未指定 stdin** ⇒ 子进程继承父进程 stdin(DSH 常驻宿主的
8
+ JSON-RPC 活管道)——活管道下读 stdin 的子进程永不 EOF;
9
+ ③ tick 台账在 `run_cycle` **返回后**才写 ⇒ 卡住期间外部无法知道卡在哪档
10
+ (`phases` 空)。
11
+
12
+ 修法的可判据面:
13
+
14
+ T1 参数面——`sleep._git` 调 `subprocess.run` 必带
15
+ `timeout=_GIT_TIMEOUT_S` 与 `stdin=subprocess.DEVNULL`(捕获 kwargs 判据);
16
+ 旁证(机理复现,等价形态):活管道(PIPE 不写不关)下读 stdin 的子进程
17
+ 悬挂;DEVNULL 下 0.02s 级立即 EOF 返回。旁证二:真挂起子进程 + 同形态
18
+ timeout → 真 `TimeoutExpired` 且有界(本机 Python 超时机制在位)。
19
+ T2 真超时——替身按 `subprocess.run(timeout=)` 契约行事(跑满一个 timeout
20
+ 后抛 `TimeoutExpired`):`_git_ok` 抛 `SleepError`(`SleepGitTimeout`),
21
+ 消息含「超时」「已被 kill」与命令名,耗时 **≈ timeout(有界)**;
22
+ 并钉「可区分」:rc≠0 走「失败」文案、与超时文案分开。
23
+ T3 循环续走回归——某档 tick 抛异常 → `_run` 不中断(该档下一轮照常,
24
+ 其它档不受影响)——既有能力回归。
25
+ T4 进度面——tick 入口写 `current_tick`(且**进入即刷既有心跳戳**)/ 出口清
26
+ 并记 `last_tick_done`;失败档记 `last_tick_error`(容忍≠静默);`status`
27
+ 展示三字段;构造过期 `current_tick` → `status` 报 `stale_tick`
28
+ (含档名与已运行时长;负对照:未超不报)。
29
+ T5 审计断言——interop / audit / units / bench×3 / sleep 的 `subprocess.run`
30
+ 调用(AST 参数面)带 timeout 与 `stdin=DEVNULL`;whitebox 的 Popen
31
+ 保持协议面原形态(stdin=PIPE,**不在加固面**)。
32
+
33
+ 运行:python -X utf8 -m md_cg.test_sustain_bounded
34
+ python -X utf8 -m md_cg.test_sustain_bounded --mutate # 变异自证
35
+ python -X utf8 -m md_cg.test_sustain_bounded --mutate --list # 只列变异表
36
+ python -X utf8 -m md_cg.test_sustain_bounded --mutate --null # 空转检出对照
37
+
38
+ 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红;
39
+ 2 = ANCHOR-MISS(变异锚点在当前源码里找不到——实现改了却没同步本表)。
40
+
41
+ **红项口径(复核打回修复,2026-10-06)**:每条变异的「自身红项」= 该条运行
42
+ 前后 `_FAIL` 长度差——**不得**拿 `len(_FAIL)` 当本轮红项(累计值恒非空,
43
+ 会让「判据空转」检测失效、空转变异被静默放行);红项行**全量**打印且与
44
+ 自身红项数**账实相符**(不符按失败判)。该缺陷类别由 `--mutate --null`
45
+ (new==old 的无害变异必须被判 MISS)钉住。
46
+
47
+ **基线纪律**:不以 git HEAD 为基线源——「改动前形态」由在当前工作区源码上做
48
+ **定点文本变异**(`_MUTATIONS`)复现,锚点漂移即退出码 2。
49
+ """
50
+ from __future__ import annotations
51
+
52
+ import ast
53
+ import contextlib
54
+ import io
55
+ import os
56
+ import shutil
57
+ import subprocess
58
+ import sys
59
+ import tempfile
60
+ import time
61
+ import types
62
+
63
+ from . import sleep as SL
64
+ from . import sustain as SUS
65
+
66
+ _PASS = []
67
+ _FAIL = []
68
+ _SRC = {}
69
+ _TMP = tempfile.mkdtemp(prefix="mdcg_bounded_")
70
+ _SAVED = {}
71
+ _REAL_SL = SL
72
+ _REAL_SUS = SUS
73
+
74
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
75
+
76
+ #: T5 的审计面:这些文件里的 `subprocess.run` 调用必须带 timeout 与
77
+ #: stdin=DEVNULL(issue #63 同批加固);whitebox 的 Popen 单列(不在加固面)。
78
+ _AUDIT_RUN_FILES = ("md_cg/sleep.py", "md_cg/interop.py", "md_cg/audit.py",
79
+ "md_cg/units.py", "md_cg/bench_locomo_zh.py",
80
+ "md_cg/bench_zh_mad.py", "md_cg/bench_governance.py")
81
+ #: 不在加固面的既有正确形态(免误伤):whitebox 的 Popen 是**长驻对话协议面**
82
+ #: (stdin=PIPE 与后端持续对话,给 DEVNULL 会改变协议语义)。
83
+ _WHITEBOX_REL = "md_cg/whitebox.py"
84
+
85
+
86
+ def ok(cond, msg, extra=""):
87
+ (_PASS if cond else _FAIL).append(msg)
88
+ print((" PASS " if cond else " FAIL ") + msg
89
+ + ((" ← " + str(extra)) if (extra and not cond) else ""))
90
+
91
+
92
+ def _rel_text(rel: str) -> str:
93
+ if rel in _SRC:
94
+ return _SRC[rel]
95
+ with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
96
+ return f.read()
97
+
98
+
99
+ def _sandbox_env():
100
+ for k in ("MDCG_ROOT", "MDCG_AUX_ROOT", "MDCG_STATE_ROOT",
101
+ "MDCG_SUSTAIN_DIR", "MDCG_SUSTAIN", "MDCG_SLEEP_GITDIR",
102
+ "MDCG_SLEEP_SHADOW"):
103
+ _SAVED[k] = os.environ.get(k)
104
+ os.environ.pop(k, None)
105
+ os.environ["MDCG_SUSTAIN_DIR"] = os.path.join(_TMP, "sustain")
106
+ os.environ["MDCG_ROOT"] = os.path.join(_TMP, "data")
107
+
108
+
109
+ def _restore_env():
110
+ for k, v in _SAVED.items():
111
+ if v is None:
112
+ os.environ.pop(k, None)
113
+ else:
114
+ os.environ[k] = v
115
+
116
+
117
+ class _FakeCG:
118
+ """最小 cg 替身:SustainLoop 只消费 .root(写戳 / 会话账本读点)。"""
119
+
120
+ def __init__(self, root):
121
+ self.root = root
122
+
123
+
124
+ def _new_loop(**kw):
125
+ root = os.path.join(_TMP, "data")
126
+ os.makedirs(root, exist_ok=True)
127
+ d = os.path.join(_TMP, "sustain")
128
+ os.makedirs(d, exist_ok=True)
129
+ kw.setdefault("name", "md_cg_bounded")
130
+ kw.setdefault("auto_sleep", True)
131
+ kw.setdefault("sleep_merge", "auto")
132
+ kw.setdefault("sleep_window", "")
133
+ kw.setdefault("sleep_scrub_apply", False)
134
+ return SUS.SustainLoop(_FakeCG(root), d=d, **kw)
135
+
136
+
137
+ # ---------------------------------------------------------------- T1
138
+ def t1():
139
+ print("== T1 参数面:_git 必带 timeout=_GIT_TIMEOUT_S 与 stdin=DEVNULL ==")
140
+ S = globals()["SL"]
141
+ real_run = subprocess.run
142
+ calls = []
143
+
144
+ def fake(argv, **kw):
145
+ calls.append((list(argv), dict(kw)))
146
+ return subprocess.CompletedProcess(argv, 0, stdout="", stderr="")
147
+
148
+ subprocess.run = fake
149
+ try:
150
+ S._git("<G>", "<root>", "status", "--short")
151
+ finally:
152
+ subprocess.run = real_run
153
+ ok(len(calls) == 1, "T1 前置:_git 恰调 subprocess.run 一次", calls)
154
+ if calls:
155
+ argv, kw = calls[0]
156
+ # 回显面**剔除 env**(含本机敏感变量,纪律第 9 条:敏感信息隔离)
157
+ safe = {k: v for k, v in kw.items() if k != "env"}
158
+ ok(argv[:3] == ["git", "--git-dir=<G>", "--work-tree=<root>"],
159
+ "T1a argv 显式 --git-dir / --work-tree(唯一出口形态不变)", argv)
160
+ ok(kw.get("timeout") == S._GIT_TIMEOUT_S
161
+ and isinstance(kw.get("timeout"), (int, float)),
162
+ "T1b **_git 必带 timeout=_GIT_TIMEOUT_S**(%r)——无界等待被闸住"
163
+ % (kw.get("timeout"),), safe)
164
+ ok(kw.get("stdin") is subprocess.DEVNULL,
165
+ "T1c **_git 必带 stdin=subprocess.DEVNULL**——不继承父进程 stdin"
166
+ "(常驻宿主下是 JSON-RPC 活管道)", safe)
167
+ ok(kw.get("shell") is False and kw.get("capture_output") is True,
168
+ "T1d 既有形态保持(shell=False + capture_output=True)", safe)
169
+ ok((kw.get("env") or {}).get("PYTHONUTF8") == "1",
170
+ "T1e env 带 PYTHONUTF8=1(既有形态保持;不回显 env 内容)")
171
+
172
+ # 机理旁证(等价形态):活管道 ⇒ 读 stdin 的子进程悬挂;DEVNULL ⇒ 立即 EOF
173
+ code = "import sys\nsys.stdin.read()\nprint('EOF-OK')\n"
174
+ p = subprocess.Popen([sys.executable, "-c", code], stdin=subprocess.PIPE,
175
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE,
176
+ text=True, encoding="utf-8", errors="replace")
177
+ try:
178
+ time.sleep(0.6)
179
+ hung = p.poll() is None
180
+ finally:
181
+ p.kill()
182
+ with contextlib.suppress(Exception):
183
+ p.communicate(timeout=5)
184
+ ok(hung, "T1f 机理旁证:**活管道**(PIPE 不写不关)下读 stdin 的子进程"
185
+ "悬挂(poll=None;DSH JSON-RPC 管道的等价形态)")
186
+ t0 = time.time()
187
+ r = subprocess.run([sys.executable, "-c", code], stdin=subprocess.DEVNULL,
188
+ capture_output=True, text=True, encoding="utf-8",
189
+ errors="replace", timeout=15)
190
+ dt = time.time() - t0
191
+ ok(r.returncode == 0 and "EOF-OK" in (r.stdout or ""),
192
+ "T1g 机理旁证:**stdin=DEVNULL** 下同一子进程立即 EOF 返回"
193
+ "(%.2fs)" % dt, (r.returncode, r.stdout, r.stderr))
194
+ t0 = time.time()
195
+ timed_out = False
196
+ try:
197
+ subprocess.run([sys.executable, "-c", "import time; time.sleep(30)"],
198
+ stdin=subprocess.DEVNULL, capture_output=True,
199
+ timeout=0.5)
200
+ except subprocess.TimeoutExpired:
201
+ timed_out = True
202
+ dt = time.time() - t0
203
+ ok(timed_out and dt < 5.0,
204
+ "T1h 机理旁证:真子进程 + timeout → 真 TimeoutExpired 且有界"
205
+ "(%.2fs)——本机 timeout 机制在位" % dt)
206
+
207
+
208
+ # ---------------------------------------------------------------- T2
209
+ def t2():
210
+ print("== T2 真超时:SleepError + 耗时≈timeout(有界)+ 消息含「超时」 ==")
211
+ S = globals()["SL"]
212
+ g = S._git.__globals__
213
+ real_run = subprocess.run
214
+ real_tmo = g["_GIT_TIMEOUT_S"]
215
+ calls = []
216
+
217
+ def fake(argv, **kw):
218
+ """按 `subprocess.run(timeout=)` 契约行事:跑满一个 timeout 后 kill 抛出。
219
+
220
+ 无 timeout(旧形态)⇒ 跑满 2s 才返回(无界等待的等价模拟——T1b/T2a
221
+ 会在该形态下转红)。
222
+ """
223
+ calls.append((list(argv), dict(kw)))
224
+ tmo = kw.get("timeout")
225
+ if tmo is None:
226
+ time.sleep(2.0)
227
+ return subprocess.CompletedProcess(argv, 0, stdout="", stderr="")
228
+ time.sleep(float(tmo))
229
+ raise subprocess.TimeoutExpired(cmd=argv, timeout=float(tmo))
230
+
231
+ g["_GIT_TIMEOUT_S"] = 0.3 # 测试用短 timeout(模块单点可调)
232
+ subprocess.run = fake
233
+ t0 = time.time()
234
+ raised = None
235
+ try:
236
+ try:
237
+ S._git_ok("<G>", "<root>", "status")
238
+ except S.SleepError as e:
239
+ raised = e
240
+ finally:
241
+ subprocess.run = real_run
242
+ g["_GIT_TIMEOUT_S"] = real_tmo
243
+ dt = time.time() - t0
244
+ ok(raised is not None and isinstance(raised, S.SleepGitTimeout),
245
+ "T2a 超时**不吞**:_git/_git_ok 抛 SleepError(SleepGitTimeout)", raised)
246
+ ok(raised is not None and "超时" in str(raised),
247
+ "T2b 消息含「超时」", str(raised))
248
+ ok(raised is not None and "已被 kill" in str(raised),
249
+ "T2c 消息含「已被 kill」(kill 语义明示)", str(raised))
250
+ ok(raised is not None and "status" in str(raised),
251
+ "T2d 消息含命令名", str(raised))
252
+ ok(raised is not None and "index.lock" in str(raised),
253
+ "T2e 消息含残留锁人工核删指引(不自动删)", str(raised))
254
+ ok(raised is not None and dt <= 0.3 * 3,
255
+ "T2f **耗时有界**(≈timeout:%.2fs ≤ 3×0.3s)——不是无界等待" % dt, dt)
256
+
257
+ # 可区分(issue #63):rc≠0 的失败走「失败」文案,与超时面分开
258
+ def fake_fail(argv, **kw):
259
+ return subprocess.CompletedProcess(argv, 1, stdout="",
260
+ stderr="fatal: boom")
261
+
262
+ subprocess.run = fake_fail
263
+ raised2 = None
264
+ try:
265
+ try:
266
+ S._git_ok("<G>", "<root>", "status")
267
+ except S.SleepError as e2:
268
+ raised2 = e2
269
+ finally:
270
+ subprocess.run = real_run
271
+ ok(raised2 is not None and "失败" in str(raised2)
272
+ and "超时" not in str(raised2),
273
+ "T2g **可区分**:rc≠0 走「失败」文案、不含「超时」(两条失败面分开)",
274
+ str(raised2))
275
+
276
+
277
+ # ---------------------------------------------------------------- T3
278
+ def t3():
279
+ print("== T3 循环续走回归:某档抛异常 → _run 不中断(下一轮照常)==")
280
+ lp = _new_loop(beat_interval=30.0, heal_interval=0.15, scrub_interval=0.3,
281
+ evolve_interval=60.0, tidy_interval=60.0,
282
+ sleep_interval=60.0)
283
+ log = []
284
+
285
+ def bad():
286
+ log.append(("heal", time.time()))
287
+ raise RuntimeError("t3-fail-once")
288
+
289
+ def good():
290
+ log.append(("scrub", time.time()))
291
+
292
+ lp._tick_heal = bad
293
+ lp._tick_scrub = good
294
+ lp._tick_evolve = lambda: log.append(("evolve", time.time()))
295
+ lp._tick_tidy = lambda: log.append(("tidy", time.time()))
296
+ lp._tick_sleep = lambda: log.append(("sleep", time.time()))
297
+ lp.start()
298
+ try:
299
+ time.sleep(1.1)
300
+ finally:
301
+ lp.stop()
302
+ n_heal = sum(1 for t, _ in log if t == "heal")
303
+ n_scrub = sum(1 for t, _ in log if t == "scrub")
304
+ ok(n_heal >= 2,
305
+ "T3a 某档 tick 抛异常后**不中断**:该档下一轮照常调度(heal×%d)"
306
+ % n_heal, log)
307
+ ok(n_scrub >= 1,
308
+ "T3b 其它档不受影响(scrub×%d)" % n_scrub, log)
309
+ ok(lp.last_tick_error is not None
310
+ and lp.last_tick_error.get("name") == "heal"
311
+ and "RuntimeError: t3-fail-once" in lp.last_tick_error.get("error", ""),
312
+ "T3c 异常**不再全静默**:last_tick_error 记 {档名, 类名+摘要}",
313
+ lp.last_tick_error)
314
+ # issue #213 Q9(2026-10-13 DSH 端):原 T3d 断言「最近一档 == 失败档」,
315
+ # 即 last_tick_done.get("ok") is False——该断言**结构性竞态**,不是负载敏感。
316
+ # 机理:_run 是**单线程顺序**执行(beat→heal→scrub→evolve→tidy→sleep,
317
+ # 固定次序,同一轮内逐个判到期)。heal(0.15s) 与 scrub(0.3s) 同轮到期时,
318
+ # **scrub 必然在 heal 之后写 last_tick_done**,把 heal 的 ok=False 覆盖成
319
+ # ok=True。故最后一档是 heal 还是 scrub,只取决于 stop() 落在哪——
320
+ # 实测扫 14 个 stop 时刻,**6 个失败**(0.5/0.6/0.9/1.0/1.3/1.4s)。
321
+ # 更正原判读:「残留的 scrub 任务抢先落 ok=True」不成立——**没有第二个任务**,
322
+ # 循环里各档就是同一线程按序跑的;错的不是执行体,是断言把「最后一档必为
323
+ # heal」当成了不变式,而循环从不保证这一点。
324
+ # 改法:钉**可从日志交叉核验**的不变式——last_tick_done 必须等于日志里最后
325
+ # 跑过的那一档,且 ok 必须与该档真实结局一致(heal 必失败、scrub 必成功)。
326
+ # 判别力不降反升:错配 / 漏记 / ok 翻转都会转红;且不再依赖 stop 时刻。
327
+ _last_name = log[-1][0] if log else None
328
+ _ltd = lp.last_tick_done
329
+ ok(_ltd is not None and _ltd.get("name") == _last_name,
330
+ "T3d last_tick_done 与最后跑过的一档一致(%s)" % _last_name, _ltd)
331
+ ok(_ltd is not None and _ltd.get("ok") is (_last_name != "heal"),
332
+ "T3d2 ok 与该档真实结局一致(heal 必失败 ⇒ ok=False)", _ltd)
333
+ # 失败档「不静默」的**无条件**判据(不依赖调度次序):直接驱动一档必失败的
334
+ # wrapped tick,出口必须落 ok=False——原 T3d 想钉的就是这条,此处确定性钉死。
335
+ lp._wrap_ticks()
336
+ def _boom():
337
+ raise RuntimeError("t3-direct")
338
+ lp._wrap_tick("heal", _boom)()
339
+ ok(lp.last_tick_done is not None
340
+ and lp.last_tick_done.get("name") == "heal"
341
+ and lp.last_tick_done.get("ok") is False,
342
+ "T3d3 失败档出口必记 ok=False(确定性:直接驱动,不依赖调度)",
343
+ lp.last_tick_done)
344
+
345
+
346
+ # ---------------------------------------------------------------- T4
347
+ def t4():
348
+ print("== T4 进度面:current_tick / last_tick_done / last_tick_error / "
349
+ "stale_tick ==")
350
+ lp = _new_loop()
351
+ seen = {}
352
+
353
+ def fn():
354
+ seen["mem"] = lp.current_tick
355
+ seen["stamp"] = SUS.read_stamp(lp.name, lp.d)
356
+
357
+ lp._wrap_tick("scrub", fn)()
358
+ ct = seen.get("mem") or {}
359
+ ok(ct.get("name") == "scrub" and "started_at" in ct
360
+ and ct.get("pid") == os.getpid(),
361
+ "T4a tick 入口写 current_tick={name, started_at, pid}", ct)
362
+ ok(((seen.get("stamp") or {}).get("current_tick") or {}).get("name")
363
+ == "scrub",
364
+ "T4a2 **进入档即刷既有状态面**(心跳戳里读得到 current_tick——"
365
+ "卡住场景下也读得到)", seen.get("stamp"))
366
+ ok(lp.current_tick is None,
367
+ "T4b tick 出口清 current_tick", lp.current_tick)
368
+ ok(lp.last_tick_done is not None
369
+ and lp.last_tick_done.get("name") == "scrub"
370
+ and lp.last_tick_done.get("ok") is True
371
+ and "t" in lp.last_tick_done,
372
+ "T4b2 tick 出口记 last_tick_done={name, t, ok}", lp.last_tick_done)
373
+
374
+ lp._wrap_tick("heal", lambda: (_ for _ in ()).throw(ValueError("t4-e")))()
375
+ ok(lp.last_tick_error is not None
376
+ and lp.last_tick_error.get("name") == "heal"
377
+ and "ValueError: t4-e" in lp.last_tick_error.get("error", ""),
378
+ "T4c 失败档记 last_tick_error(类名+摘要)", lp.last_tick_error)
379
+ ok(lp.last_tick_done is not None and lp.last_tick_done.get("ok") is False,
380
+ "T4c2 失败档 last_tick_done.ok=False", lp.last_tick_done)
381
+
382
+ st = lp.status()
383
+ ok("current_tick" in st and "last_tick_done" in st
384
+ and "last_tick_error" in st,
385
+ "T4d status 输出含进度三字段(cg(op=sustain,action=status) 同源)",
386
+ sorted(st))
387
+ ok(st["last_tick_done"]["name"] == "heal"
388
+ and st["last_tick_done"]["ok"] is False,
389
+ "T4d2 status 的 last_tick_done 反映最近一档(失败态可见)", st["last_tick_done"])
390
+
391
+ lp.current_tick = {"name": "sleep", "started_at": time.time() - 9000.0,
392
+ "pid": os.getpid()}
393
+ st2 = lp.status()
394
+ ok(bool(st2["stale_tick"]) and st2["stale_tick"].get("tick") == "sleep",
395
+ "T4e 过期 current_tick → status 报 stale_tick(档名=sleep)",
396
+ st2["stale_tick"])
397
+ ok(bool(st2["stale_tick"])
398
+ and "sleep" in st2["stale_tick"].get("alert", "")
399
+ and "9000" in st2["stale_tick"].get("alert", ""),
400
+ "T4e2 stale_tick.alert 含档名与已运行时长", st2["stale_tick"])
401
+ ok(st2["current_tick"].get("running_s") >= 9000,
402
+ "T4e3 current_tick 附已运行秒数 running_s", st2["current_tick"])
403
+ lp.current_tick = {"name": "sleep", "started_at": time.time() - 10.0,
404
+ "pid": os.getpid()}
405
+ ok(lp.status()["stale_tick"] is None,
406
+ "T4f 负对照:未超阈值不报 stale_tick(不误报)")
407
+ # 跨进程回落:内存清空后仍能从既有状态面读到(写点是戳,不是内存独有)
408
+ lp.last_tick_done = None
409
+ st3 = lp.status()
410
+ ok(st3["last_tick_done"] is not None,
411
+ "T4g 跨进程回落:内存清空后 last_tick_done 仍可从戳读到",
412
+ st3["last_tick_done"])
413
+
414
+
415
+ # ---------------------------------------------------------------- T5
416
+ def t5():
417
+ print("== T5 审计断言:加固面 subprocess.run 带 timeout+DEVNULL;"
418
+ "whitebox Popen 保持协议面 ==")
419
+
420
+ def run_calls(rel):
421
+ tree = ast.parse(_rel_text(rel))
422
+ out = []
423
+ for node in ast.walk(tree):
424
+ if (isinstance(node, ast.Call)
425
+ and isinstance(node.func, ast.Attribute)
426
+ and node.func.attr == "run"
427
+ and isinstance(node.func.value, ast.Name)
428
+ and node.func.value.id == "subprocess"):
429
+ out.append(node)
430
+ return out
431
+
432
+ def has_kw(node, key, devnull=False):
433
+ for kw in node.keywords:
434
+ if kw.arg != key:
435
+ continue
436
+ if not devnull:
437
+ return True
438
+ v = kw.value
439
+ return (isinstance(v, ast.Attribute) and v.attr == "DEVNULL"
440
+ and isinstance(v.value, ast.Name)
441
+ and v.value.id == "subprocess")
442
+ return False
443
+
444
+ for rel in _AUDIT_RUN_FILES:
445
+ nodes = run_calls(rel)
446
+ ok(len(nodes) >= 1, "T5 前置:%s 内有 subprocess.run 调用(%d 处)"
447
+ % (rel, len(nodes)))
448
+ for i, node in enumerate(nodes, 1):
449
+ ok(has_kw(node, "timeout"),
450
+ "T5a %s:%d subprocess.run 带 timeout=" % (rel, node.lineno))
451
+ ok(has_kw(node, "stdin", devnull=True),
452
+ "T5b %s:%d subprocess.run 带 stdin=subprocess.DEVNULL"
453
+ % (rel, node.lineno))
454
+
455
+ # whitebox:长驻对话协议面(stdin=PIPE)——**不在加固面**,保持原形态
456
+ tree = ast.parse(_rel_text(_WHITEBOX_REL))
457
+ popens = [n for n in ast.walk(tree)
458
+ if isinstance(n, ast.Call)
459
+ and isinstance(n.func, ast.Attribute)
460
+ and n.func.attr == "Popen"
461
+ and isinstance(n.func.value, ast.Name)
462
+ and n.func.value.id == "subprocess"]
463
+ ok(len(popens) >= 1, "T5c 前置:whitebox.py 内有 subprocess.Popen(%d 处)"
464
+ % len(popens))
465
+ for node in popens:
466
+ stdin_kw = next((kw for kw in node.keywords if kw.arg == "stdin"), None)
467
+ ok(stdin_kw is not None
468
+ and isinstance(stdin_kw.value, ast.Attribute)
469
+ and stdin_kw.value.attr == "PIPE",
470
+ "T5d whitebox Popen 保持协议面原形态(stdin=PIPE,不加固)"
471
+ "(%s:%d)" % (_WHITEBOX_REL, node.lineno))
472
+
473
+
474
+ # ---------------------------------------------------------------- 变异表
475
+ # 锚点 = (名字, rel, old, new)。每次变异必须让套件**转红**:
476
+ # M1 主修删 timeout=(_git 退回无界等待)→ T1b / T2a 红
477
+ # M2 主修删 stdin=DEVNULL(子进程继承活管道 stdin)→ T1c 红
478
+ # M3 进度面删「进入写点」→ T4a / T4a2 红
479
+ # M4 六档 except 删 last_tick_error 记录(退回全静默)→ T3c / T4c 红
480
+ _MUTATIONS = (
481
+ ("删 timeout=(_git 退回无界等待)", "md_cg/sleep.py",
482
+ " env=env, shell=False,\n"
483
+ " timeout=_GIT_TIMEOUT_S,\n"
484
+ " stdin=subprocess.DEVNULL)",
485
+ " env=env, shell=False,\n"
486
+ " stdin=subprocess.DEVNULL)"),
487
+ ("删 stdin=DEVNULL(继承活管道 stdin)", "md_cg/sleep.py",
488
+ " env=env, shell=False,\n"
489
+ " timeout=_GIT_TIMEOUT_S,\n"
490
+ " stdin=subprocess.DEVNULL)",
491
+ " env=env, shell=False,\n"
492
+ " timeout=_GIT_TIMEOUT_S)"),
493
+ ("删进度面进入写点(卡住读不到档)", "md_cg/sustain.py",
494
+ ' self.current_tick = {"name": name, "started_at": time.time(),\n'
495
+ ' "pid": os.getpid()}\n'
496
+ ' self._flush_progress()\n',
497
+ ""),
498
+ ("删失败档 last_tick_error(退回全静默)", "md_cg/sustain.py",
499
+ " except Exception as e: # noqa: BLE001\n"
500
+ " ok_ = False\n"
501
+ " self.last_tick_error = {\"name\": name, \"t\": time.time(),\n"
502
+ " \"error\": \"%s: %s\" % (type(e).__name__,\n"
503
+ " str(e)[:200])}\n",
504
+ " except Exception: # noqa: BLE001\n"
505
+ " ok_ = False\n"),
506
+ )
507
+
508
+ #: 空转检出对照(meta 自证,`--mutate --null`):new==old 的「无害变异」——
509
+ #: 行为零变化、自身红项必须为 0 且被判 MISS。若哪天「本轮红项」判定口径
510
+ #: 退化为累计计数(累计恒非空),本对照立即转 FAIL(钉住的正是复核打回
511
+ #: 实证过的那条假阳性通道)。锚点取 `_git` 调用里一行行为零变化的文本。
512
+ _NULL_MUTATION = ("空转对照(new==old,行为零变化)", "md_cg/sleep.py",
513
+ " env=env, shell=False,\n",
514
+ " env=env, shell=False,\n")
515
+
516
+
517
+ def _exec_module(name: str, rel: str, text: str):
518
+ ns = {"__name__": name, "__package__": "md_cg",
519
+ "__file__": os.path.join(_REPO, rel)}
520
+ exec(compile(text, rel, "exec"), ns) # noqa: S102 —— 基线自证用
521
+ m = types.ModuleType(name)
522
+ m.__dict__.update(ns)
523
+ return m
524
+
525
+
526
+ def _run_groups() -> int:
527
+ for fn in (t1, t2, t3, t4, t5):
528
+ try:
529
+ fn()
530
+ except Exception as e: # noqa: BLE001
531
+ ok(False, "%s 组抛异常:%s: %s" % (fn.__name__, type(e).__name__, e))
532
+ return len(_FAIL)
533
+
534
+
535
+ def _mutate_once(name: str, rel: str, old: str, new: str):
536
+ """跑一条变异并返回**本轮自身**读数 (reds_self, reds_lines, detail)。
537
+
538
+ 红项口径(复核打回修复,2026-10-06):`_FAIL` 是**全局累计**列表,
539
+ 故「本轮红项」必须取**调用前后长度差**——直接拿 `len(_FAIL)` 当本轮
540
+ 红项会让「判据空转」检测失效(累计值恒非空 ⇒ 空转变异也会被记成
541
+ 「红」并放行)。本轮自身红项还须与输出里 FAIL 行数**账实相符**。
542
+ """
543
+ src = _rel_text(rel)
544
+ if old not in src:
545
+ return None, [], "ANCHOR-MISS:锚点在 %s 源码里找不到(实现改了却没同步" \
546
+ "本表)" % rel
547
+ base = len(_FAIL) # 本轮起点:只数本轮自身的红项
548
+ _SRC[rel] = src.replace(old, new, 1)
549
+ try:
550
+ mut = _exec_module("md_cg._bounded_mut", rel, _SRC[rel])
551
+ if rel == "md_cg/sleep.py":
552
+ globals()["SL"] = mut
553
+ else:
554
+ globals()["SUS"] = mut
555
+ with contextlib.redirect_stdout(buf := io.StringIO()):
556
+ _run_groups()
557
+ detail = buf.getvalue()
558
+ finally:
559
+ globals()["SL"] = _REAL_SL
560
+ globals()["SUS"] = _REAL_SUS
561
+ _SRC.pop(rel, None)
562
+ reds = len(_FAIL) - base # **本轮自身**红项数
563
+ reds_lines = [l for l in detail.splitlines()
564
+ if l.strip().startswith("FAIL ")]
565
+ return reds, reds_lines, detail
566
+
567
+
568
+ def _mutate_mode(list_only: bool = False) -> int:
569
+ print("!! 定点变异自证:逐条把机制改回「改动前/错误」形态,套件必须转红"
570
+ "(红项 = 本轮自身,非法用全局累计值)\n")
571
+ if list_only:
572
+ for name, rel, _o, _n in _MUTATIONS:
573
+ print(" %-38s [%s]" % (name, rel))
574
+ return 0
575
+ anchor_miss, bad = [], []
576
+ base0 = len(_FAIL)
577
+ with contextlib.redirect_stdout(io.StringIO()):
578
+ _run_groups()
579
+ clean = len(_FAIL) - base0
580
+ print(" 未变异基线:失败=%d(必须为 0)" % clean)
581
+ if clean:
582
+ bad.append("未变异基线即失败")
583
+
584
+ for name, rel, old, new in _MUTATIONS:
585
+ reds, reds_lines, detail = _mutate_once(name, rel, old, new)
586
+ if reds is None:
587
+ print(" ANCHOR-MISS %s —— %s" % (name, detail))
588
+ anchor_miss.append(name)
589
+ continue
590
+ verdict = "红" if reds else "**仍全绿 = 该判据空转**"
591
+ print(" %s %-38s 自身红项=%d(本轮;基线=%d) %s"
592
+ % ("OK " if reds else "MISS ", name, reds, clean, verdict))
593
+ for l in reds_lines: # **全量**打印(回报即读数,不截断)
594
+ print(" " + l.strip()[5:])
595
+ if len(reds_lines) != reds:
596
+ # 账实不符 = 计数面自身有缺陷——按失败判(fail-closed)
597
+ print(" !账实不符:FAIL 行数=%d ≠ 自身红项=%d——计数面缺陷"
598
+ % (len(reds_lines), reds))
599
+ bad.append(name + "(账实不符)")
600
+ if not reds:
601
+ bad.append(name)
602
+
603
+ if anchor_miss:
604
+ print("\nANCHOR-MISS:%s" % "、".join(anchor_miss))
605
+ print("退出码 2(fail-closed):变异表锚点漂移即判失败,不得静默跳过")
606
+ return 2
607
+ print("\n定点变异自证:%s"
608
+ % ("PASS(每处机制都有一条断言把它钉死)" if not bad
609
+ else "FAIL —— " + "、".join(bad)))
610
+ return 0 if not bad else 1
611
+
612
+
613
+ def _null_mode() -> int:
614
+ """空转检出对照(meta 自证):new==old 的「无害变异」必须被判 MISS。
615
+
616
+ 钉住的缺陷类别(复核打回实证):若「本轮红项」误用全局累计值(累计恒
617
+ 非空),空转变异会被记成「红」并放行——`--mutate` 的 fail-closed 承诺
618
+ (「变异未按预期转红 = 退出码 1」)随之失效。本对照即钉住该检出能力。
619
+ """
620
+ print("!! 空转检出对照:一条 new==old 的「无害变异」——必须被判 MISS"
621
+ "(不得凭任何累计值蒙混)\n")
622
+ name, rel, old, new = _NULL_MUTATION
623
+ reds, reds_lines, detail = _mutate_once(name, rel, old, new)
624
+ if reds is None:
625
+ print(" ANCHOR-MISS %s —— %s" % (name, detail))
626
+ return 2
627
+ detected = reds == 0 and not reds_lines
628
+ print(" 变异=%s 自身红项=%d(本轮) FAIL 行数=%d ⇒ %s"
629
+ % (name, reds, len(reds_lines),
630
+ "MISS(如期检出空转,判定有效)" if detected
631
+ else "红(**空转漏检 = 判据失效**,fail-closed 不成立)"))
632
+ print("空转检出对照:%s" % ("PASS" if detected else "FAIL"))
633
+ return 0 if detected else 1
634
+
635
+
636
+ def main() -> int:
637
+ _sandbox_env()
638
+ try:
639
+ if "--mutate" in sys.argv:
640
+ if "--null" in sys.argv:
641
+ return _null_mode()
642
+ return _mutate_mode("--list" in sys.argv)
643
+ n = _run_groups()
644
+ print("\nSUMMARY: 常驻卡死防护守卫:%d 通过,%d 失败" % (len(_PASS), n))
645
+ return 0 if not n else 1
646
+ finally:
647
+ _restore_env()
648
+ shutil.rmtree(_TMP, ignore_errors=True)
649
+
650
+
651
+ if __name__ == "__main__":
652
+ sys.exit(main())