@furongjun1999/dsh-memory 0.9.14 → 0.9.16

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 (1281) hide show
  1. package/CHANGELOG.md +109 -0
  2. package/LICENSE +21 -21
  3. package/README.md +31 -2
  4. package/codebuddy/mcp.json +27 -27
  5. 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 -45
  6. package/dsh/dsh-web-start.bat +17 -17
  7. package/dsh/hive-mcp-probe.mjs +94 -94
  8. package/dsh/update-lingshu.bat +11 -11
  9. package/dsh/update-lingshu.ps1 +337 -337
  10. package/hive/README.md +705 -705
  11. package/hive/id_charset_blocks.txt +147 -147
  12. package/lib/client.js +18 -0
  13. package/lib/hooks.js +29 -12
  14. package/lib/index.js +3 -44
  15. package/lib/lib/console_web.mjs +104 -0
  16. package/lib/lib/hook_audit.d.ts +15 -0
  17. package/lib/lib/hook_audit.js +28 -0
  18. package/lib/tools.d.ts +2 -2
  19. package/md_cg/__init__.py +7 -7
  20. package/md_cg/auditview.py +248 -248
  21. package/md_cg/backfill.py +1328 -1328
  22. package/md_cg/backfill_bigdomain.py +34 -34
  23. package/md_cg/backfill_bucket_zh.py +35 -35
  24. package/md_cg/bench6_arms.py +414 -414
  25. package/md_cg/bench6_common.py +230 -230
  26. package/md_cg/bench6_competitors.py +212 -212
  27. package/md_cg/bench_axis_domain.py +257 -257
  28. package/md_cg/bench_blind_comp.py +308 -308
  29. package/md_cg/bench_e2e_judge.py +534 -534
  30. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  31. package/md_cg/bench_e2e_qa.py +256 -256
  32. package/md_cg/bench_en_atoms_public.py +230 -230
  33. package/md_cg/bench_governance.py +351 -351
  34. package/md_cg/bench_lme_zh.py +410 -410
  35. package/md_cg/bench_locomo.py +121 -121
  36. package/md_cg/bench_locomo_zh.py +460 -460
  37. package/md_cg/bench_locomo_zh_public.py +147 -147
  38. package/md_cg/bench_longmem.py +112 -112
  39. package/md_cg/bench_membench.py +632 -632
  40. package/md_cg/bench_p0.py +149 -149
  41. package/md_cg/bench_progressive.py +287 -287
  42. package/md_cg/bench_role_views.py +238 -238
  43. package/md_cg/bench_task_ab.py +243 -243
  44. package/md_cg/bench_task_ab_llm.py +408 -408
  45. package/md_cg/bench_unified_en.py +204 -204
  46. package/md_cg/bench_zh_mad.py +611 -611
  47. package/md_cg/blindspot_tickets.py +123 -123
  48. package/md_cg/census.py +133 -133
  49. package/md_cg/codeindex.py +531 -531
  50. package/md_cg/comment_gate.py +337 -337
  51. package/md_cg/cond_compose.py +190 -190
  52. package/md_cg/cond_facts.py +154 -154
  53. package/md_cg/cond_template.json +106 -106
  54. package/md_cg/condition_anchor.py +142 -142
  55. package/md_cg/config_registry.py +28 -0
  56. package/md_cg/config_registry_bulk.py +4 -0
  57. package/md_cg/corpus.py +110 -110
  58. package/md_cg/crosscheck.py +1098 -1098
  59. package/md_cg/d_meta.py +310 -310
  60. package/md_cg/docindex.py +496 -488
  61. package/md_cg/evolution.py +493 -493
  62. package/md_cg/freshness.py +21 -1
  63. package/md_cg/generation.py +409 -409
  64. package/md_cg/ghostref.py +130 -130
  65. package/md_cg/hotcache.py +5 -1
  66. package/md_cg/lexicon/RULES.md +32 -32
  67. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  68. package/md_cg/lexicon/build_standard_en.py +171 -171
  69. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  70. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  71. package/md_cg/lexicon/expand_en_zh.py +211 -211
  72. package/md_cg/lexicon/standard_en.json +1262 -1262
  73. package/md_cg/linkref.py +280 -280
  74. package/md_cg/mcp_server.py +9 -2
  75. package/md_cg/md_whitebox.py +345 -345
  76. package/md_cg/mdcg.py +206 -15
  77. package/md_cg/mdcos.py +124 -5
  78. package/md_cg/migrate.py +119 -119
  79. package/md_cg/migrate_aeis.py +221 -221
  80. package/md_cg/migrate_roleplay.py +293 -293
  81. package/md_cg/migrate_wisdom_graph.py +360 -360
  82. package/md_cg/mreview/__init__.py +25 -25
  83. package/md_cg/mreview/__main__.py +110 -110
  84. package/md_cg/mreview/bundle.py +178 -178
  85. package/md_cg/mreview/candidates.py +262 -262
  86. package/md_cg/mreview/govern.py +694 -694
  87. package/md_cg/mreview/locate.py +939 -939
  88. package/md_cg/mreview/pipeline.py +742 -742
  89. package/md_cg/mreview/rules/duplication.json +21 -21
  90. package/md_cg/mreview/rules/field_coverage.json +54 -54
  91. package/md_cg/mreview/rules/source_license.json +21 -21
  92. package/md_cg/mreview/rules/template_flow.json +21 -21
  93. package/md_cg/mreview/ruleset.py +252 -252
  94. package/md_cg/op_table.py +3 -2
  95. package/md_cg/progressive.py +123 -123
  96. package/md_cg/protect.py +29 -6
  97. package/md_cg/protocol/md_cg_gate.proto +33 -33
  98. package/md_cg/qmd_llm.py +334 -334
  99. package/md_cg/roleviews.py +89 -89
  100. package/md_cg/security.py +68 -5
  101. package/md_cg/selfreport.py +161 -161
  102. package/md_cg/semantic/REPRODUCE.md +170 -170
  103. package/md_cg/semantic/SCHEMA.md +33 -33
  104. package/md_cg/semantic/__init__.py +10 -10
  105. package/md_cg/semantic/atoms.json +7348 -7348
  106. package/md_cg/semantic/en_normalizer.py +364 -364
  107. package/md_cg/semantic/search_index.json +6199 -6199
  108. package/md_cg/session5.py +106 -106
  109. package/md_cg/srcindex.py +352 -352
  110. package/md_cg/statushdr.py +179 -179
  111. package/md_cg/tasks.py +26 -0
  112. package/md_cg/test_access_hints.py +147 -147
  113. package/md_cg/test_audit_rotate.py +270 -270
  114. package/md_cg/test_auditview.py +277 -277
  115. package/md_cg/test_autonomy.py +143 -143
  116. package/md_cg/test_autonomy_admission.py +1098 -1098
  117. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  118. package/md_cg/test_b1_foreign_read.py +244 -244
  119. package/md_cg/test_b1b2_write_face.py +424 -424
  120. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  121. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  122. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  123. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  124. package/md_cg/test_bench_governance.py +102 -102
  125. package/md_cg/test_blindspot_tickets.py +166 -166
  126. package/md_cg/test_boundary_hit.py +410 -410
  127. package/md_cg/test_branch_discard_tombstone.py +136 -136
  128. package/md_cg/test_ccg_perturb.py +184 -184
  129. package/md_cg/test_ccgc.py +458 -458
  130. package/md_cg/test_census_prune.py +81 -81
  131. package/md_cg/test_chain_read_isolate.py +168 -168
  132. package/md_cg/test_codeindex.py +338 -338
  133. package/md_cg/test_coldverify_drain.py +127 -127
  134. package/md_cg/test_comment_gate.py +187 -187
  135. package/md_cg/test_cond_compose_anchors.py +76 -76
  136. package/md_cg/test_cond_match.py +165 -165
  137. package/md_cg/test_condition_anchor.py +81 -81
  138. package/md_cg/test_config_registry.py +55 -55
  139. package/md_cg/test_config_registry_silent_fallback.py +90 -0
  140. package/md_cg/test_cons200_scan_selection.py +793 -793
  141. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  142. package/md_cg/test_crypto_rotate.py +256 -256
  143. package/md_cg/test_csre_index_import_guard.py +161 -161
  144. package/md_cg/test_curiosity_budget.py +468 -468
  145. package/md_cg/test_d17_autostart_toolface.py +453 -453
  146. package/md_cg/test_d_meta.py +412 -412
  147. package/md_cg/test_datapath_root.py +199 -199
  148. package/md_cg/test_designer_token_coverage.py +184 -0
  149. package/md_cg/test_emit_negtail_cache.py +156 -156
  150. package/md_cg/test_export_default_collision.py +138 -138
  151. package/md_cg/test_gain_gate.py +223 -223
  152. package/md_cg/test_generation_guard.py +361 -361
  153. package/md_cg/test_ghostref.py +182 -182
  154. package/md_cg/test_goal_gen.py +355 -355
  155. package/md_cg/test_govern_directread.py +434 -434
  156. package/md_cg/test_health_scale.py +173 -173
  157. package/md_cg/test_heartbeat_ledger.py +563 -563
  158. package/md_cg/test_hive_ingest.py +285 -285
  159. package/md_cg/test_hot_cold.py +215 -215
  160. package/md_cg/test_hyperedge.py +245 -245
  161. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  162. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  163. package/md_cg/test_i50d_importance_source.py +531 -531
  164. package/md_cg/test_i50e_readside_protection.py +9 -3
  165. package/md_cg/test_identity_contract.py +329 -329
  166. package/md_cg/test_index_crossprocess_reload.py +316 -316
  167. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  168. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  169. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  170. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  171. package/md_cg/test_issue659_r26_batch3.py +38 -0
  172. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  173. package/md_cg/test_issue672_optional_assets.py +49 -0
  174. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  175. package/md_cg/test_issue677_async_index_flush.py +216 -0
  176. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  177. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  178. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  179. package/md_cg/test_issue69_audit_boundary.py +129 -129
  180. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  181. package/md_cg/test_issue78_export_concurrency.py +334 -334
  182. package/md_cg/test_issue80_residual_flush.py +169 -169
  183. package/md_cg/test_issue84_portability.py +95 -95
  184. package/md_cg/test_issue85_export_overwrite.py +113 -113
  185. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  186. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  187. package/md_cg/test_issue88_conclusion_face.py +280 -280
  188. package/md_cg/test_issue89_zero_score.py +169 -169
  189. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  190. package/md_cg/test_issue96_key_fallback.py +102 -102
  191. package/md_cg/test_issue98_tenant_root.py +104 -104
  192. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  193. package/md_cg/test_lifecycle.py +309 -309
  194. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  195. package/md_cg/test_linkref.py +320 -320
  196. package/md_cg/test_links_concurrent_write.py +188 -188
  197. package/md_cg/test_lock.py +52 -52
  198. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  199. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  200. package/md_cg/test_md_writepath.py +345 -345
  201. package/md_cg/test_merge_upsert.py +168 -168
  202. package/md_cg/test_mode_parity.py +23 -0
  203. package/md_cg/test_mr_m2.py +615 -599
  204. package/md_cg/test_mr_m3.py +710 -710
  205. package/md_cg/test_mr_m4.py +485 -485
  206. package/md_cg/test_n131_merge_gate.py +205 -205
  207. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  208. package/md_cg/test_n176_link_trust.py +221 -221
  209. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  210. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  211. package/md_cg/test_n195_writepath_reload.py +283 -283
  212. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  213. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  214. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  215. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  216. package/md_cg/test_n201_proposal_visibility.py +382 -382
  217. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  218. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  219. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  220. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  221. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  222. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  223. package/md_cg/test_n230_dirty_replay.py +18 -5
  224. package/md_cg/test_n238_body_text_parity.py +156 -156
  225. package/md_cg/test_n276_probe_hoist.py +199 -199
  226. package/md_cg/test_neg_condition_hits.py +333 -333
  227. package/md_cg/test_neg_coverage_budget.py +500 -500
  228. package/md_cg/test_none_id_write_guard.py +166 -166
  229. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  230. package/md_cg/test_p0.py +264 -264
  231. package/md_cg/test_p1.py +316 -316
  232. package/md_cg/test_p10_identity.py +173 -173
  233. package/md_cg/test_p11_consistency.py +382 -382
  234. package/md_cg/test_p12_metacognition.py +212 -212
  235. package/md_cg/test_p13_encryption.py +241 -241
  236. package/md_cg/test_p14_root_fallback.py +373 -373
  237. package/md_cg/test_p14_sustain.py +249 -249
  238. package/md_cg/test_p15_scrub.py +280 -280
  239. package/md_cg/test_p16_self_state.py +301 -301
  240. package/md_cg/test_p17_predict.py +354 -354
  241. package/md_cg/test_p18_whitebox.py +171 -171
  242. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  243. package/md_cg/test_p1x_ref_root.py +197 -197
  244. package/md_cg/test_p2.py +216 -216
  245. package/md_cg/test_p20_evolution.py +315 -315
  246. package/md_cg/test_p22_theory.py +175 -175
  247. package/md_cg/test_p23_links.py +311 -311
  248. package/md_cg/test_p25_weights.py +156 -156
  249. package/md_cg/test_p26_refindex.py +433 -433
  250. package/md_cg/test_p29_session_ingest_export.py +360 -360
  251. package/md_cg/test_p30_maintain.py +361 -361
  252. package/md_cg/test_p31_insight.py +535 -535
  253. package/md_cg/test_p34_crosscheck.py +331 -331
  254. package/md_cg/test_p35_conditioned_claim.py +252 -252
  255. package/md_cg/test_p36_kp_align.py +230 -230
  256. package/md_cg/test_p37_condition_space.py +248 -248
  257. package/md_cg/test_p38_contextualize.py +273 -273
  258. package/md_cg/test_p39_vision_evidence.py +369 -369
  259. package/md_cg/test_p41_evolve_patrol.py +224 -224
  260. package/md_cg/test_p42_provenance.py +269 -269
  261. package/md_cg/test_p44_md_whitebox.py +231 -231
  262. package/md_cg/test_p45_session_identity.py +466 -466
  263. package/md_cg/test_p46_unit_scope.py +272 -272
  264. package/md_cg/test_p4_fuzzy.py +223 -223
  265. package/md_cg/test_p5_semantic.py +226 -226
  266. package/md_cg/test_p6_consolidate.py +822 -822
  267. package/md_cg/test_p7_goals_recent.py +202 -202
  268. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  269. package/md_cg/test_p8_subgraph_chain.py +213 -213
  270. package/md_cg/test_p9_forget_protect.py +238 -238
  271. package/md_cg/test_preflight_failclosed.py +100 -100
  272. package/md_cg/test_progressive.py +146 -146
  273. package/md_cg/test_propose_tail_index.py +157 -157
  274. package/md_cg/test_protect_stats_parity.py +141 -0
  275. package/md_cg/test_protocol.py +272 -272
  276. package/md_cg/test_rank_parity_score_mode.py +522 -522
  277. package/md_cg/test_reach_keys.py +201 -201
  278. package/md_cg/test_read_clip.py +141 -141
  279. package/md_cg/test_read_face_input_gates.py +363 -363
  280. package/md_cg/test_read_face_semantics.py +492 -492
  281. package/md_cg/test_read_scope_b27.py +277 -277
  282. package/md_cg/test_readcache_default_on.py +168 -168
  283. package/md_cg/test_readcache_precise_inval.py +270 -270
  284. package/md_cg/test_recall_metadata.py +422 -422
  285. package/md_cg/test_reconcile_v0.py +294 -294
  286. package/md_cg/test_retr_s1.py +344 -344
  287. package/md_cg/test_retr_s1b.py +276 -276
  288. package/md_cg/test_retr_s3.py +194 -194
  289. package/md_cg/test_retr_s4.py +163 -163
  290. package/md_cg/test_retr_s6.py +157 -157
  291. package/md_cg/test_retr_s7.py +392 -392
  292. package/md_cg/test_retr_s8_time.py +369 -369
  293. package/md_cg/test_retr_s9_edges.py +286 -286
  294. package/md_cg/test_retr_score_once.py +220 -220
  295. package/md_cg/test_review_cli_attribution.py +181 -181
  296. package/md_cg/test_review_cli_visibility.py +235 -235
  297. package/md_cg/test_review_conformance.py +385 -385
  298. package/md_cg/test_review_dual_check.py +97 -0
  299. package/md_cg/test_review_onepass.py +170 -170
  300. package/md_cg/test_review_queue_batch.py +123 -123
  301. package/md_cg/test_review_queue_index.py +130 -130
  302. package/md_cg/test_role_views.py +354 -354
  303. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  304. package/md_cg/test_security_audit_v21.py +249 -249
  305. package/md_cg/test_sem_noise.py +242 -242
  306. package/md_cg/test_server_version.py +67 -67
  307. package/md_cg/test_session5_identity.py +93 -93
  308. package/md_cg/test_session_attribution_consistency.py +813 -813
  309. package/md_cg/test_session_identity_tristate.py +486 -486
  310. package/md_cg/test_session_isolation.py +168 -168
  311. package/md_cg/test_sleep.py +668 -668
  312. package/md_cg/test_sleep_gitlock.py +134 -134
  313. package/md_cg/test_snapshot_autoclose.py +187 -187
  314. package/md_cg/test_spatial_coords3d.py +292 -292
  315. package/md_cg/test_srcindex.py +171 -171
  316. package/md_cg/test_state_events.py +178 -178
  317. package/md_cg/test_state_slots.py +691 -691
  318. package/md_cg/test_subproc_encoding.py +192 -192
  319. package/md_cg/test_sustain_mutual.py +153 -153
  320. package/md_cg/test_tail_watermark_race.py +208 -208
  321. package/md_cg/test_tasks.py +409 -409
  322. package/md_cg/test_tenant_env_override_warn.py +152 -152
  323. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  324. package/md_cg/test_time_core_lint.py +9 -0
  325. package/md_cg/test_token_lowercase_form.py +315 -315
  326. package/md_cg/test_transfer.py +180 -180
  327. package/md_cg/test_trust.py +361 -361
  328. package/md_cg/test_twophase.py +286 -286
  329. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  330. package/md_cg/test_unify_default_off.py +701 -701
  331. package/md_cg/test_unify_scope.py +182 -182
  332. package/md_cg/test_units_poll.py +71 -71
  333. package/md_cg/test_v21r1_package_version.py +310 -310
  334. package/md_cg/test_validity_filter.py +280 -280
  335. package/md_cg/test_verify_answer.py +138 -138
  336. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  337. package/md_cg/test_w5_path_fingerprint.py +381 -381
  338. package/md_cg/test_wisdom_md_store.py +292 -292
  339. package/md_cg/test_writegate_tiers.py +111 -0
  340. package/md_cg/test_writelimit.py +224 -224
  341. package/md_cg/test_writepipe.py +4 -2
  342. package/md_cg/tokens.py +114 -8
  343. package/md_cg/units.py +869 -869
  344. package/md_cg/version_anchor.py +160 -160
  345. package/md_cg/vision_evidence.py +667 -667
  346. package/md_cg/whitebox_kb/__init__.py +37 -37
  347. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  348. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  349. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  350. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  351. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  352. package/md_cg/whitebox_kb/engine.py +310 -310
  353. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  354. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  355. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/345/217/244/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  356. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/347/216/260/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  357. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/345/267/245/346/231/272/350/203/275/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  358. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/347/261/273/350/247/202/345/257/237/350/200/205/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +161 -161
  359. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/274/232/350/256/241/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  360. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/277/241/346/201/257/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +90 -90
  361. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/345/255/220/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  362. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/346/236/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  363. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  364. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  365. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  366. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  367. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +317 -317
  368. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +261 -261
  369. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  370. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  371. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  372. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/212/250/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  373. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1194 -1194
  374. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/267/245/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  375. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  376. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/206/345/217/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +278 -278
  377. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/237/345/255/220/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  378. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/217/244/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  379. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/223/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  380. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/233/272/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  381. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/237/346/234/250/345/267/245/347/250/213/345/237/272/347/241/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  382. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/260/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +154 -154
  383. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/215/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  384. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/226/345/233/275/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  385. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  386. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/346/200/235/346/224/277/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  387. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +201 -201
  388. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  389. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  390. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +131 -131
  391. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/217/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  392. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/236/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  393. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +333 -333
  394. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1124 -1124
  395. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  396. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  397. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  398. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/210/266/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  399. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +362 -362
  400. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/202/345/234/272/350/220/245/351/224/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +81 -81
  401. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/270/345/276/256/345/210/206/346/226/271/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +153 -153
  402. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/345/210/206/345/207/240/344/275/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  403. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  404. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  405. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/277/203/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +119 -119
  406. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/203/205/346/204/237/346/203/205/347/273/252/344/273/277/347/234/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +186 -186
  407. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/212/275/350/261/241/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  408. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/213/223/346/211/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  409. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/223/215/344/275/234/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  410. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/224/277/346/262/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +234 -234
  411. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/200/274/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  412. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/227/347/224/265/350/267/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  413. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1166 -1166
  414. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +217 -217
  415. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/347/211/251/347/220/206/346/226/271/346/263/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  416. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/345/272/223/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  417. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/347/273/223/346/236/204/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  418. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/226/207/345/255/246/347/220/206/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  419. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/240/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +141 -141
  420. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/266/347/251/272/350/256/260/345/277/206/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +214 -214
  421. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/231/272/350/203/275/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  422. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/234/211/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  423. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/220/346/226/231/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  424. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/241/344/273/266/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  425. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/244/215/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  426. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/246/202/347/216/207/350/256/272/344/270/216/346/225/260/347/220/206/347/273/237/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +149 -149
  427. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/250/241/346/213/237/347/224/265/345/255/220/346/212/200/346/234/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  428. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/263/233/345/207/275/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  429. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/203/255/345/212/233/345/255/246/344/270/216/347/273/237/350/256/241/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  430. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  431. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1302 -1302
  432. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/216/260/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  433. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/220/206/350/256/272/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  434. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/346/200/201/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  435. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  436. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1018 -1018
  437. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  438. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/345/212/250/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  439. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/350/267/257/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  440. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/244/276/344/274/232/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  441. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/250/213/345/272/217/350/256/276/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  442. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/227/346/263/225/350/256/276/350/256/241/344/270/216/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  443. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/241/347/220/206/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  444. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/272/277/346/200/247/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  445. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/206/350/203/236/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  446. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  447. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/223/346/236/204/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  448. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/274/345/220/210/302/267/347/273/264/345/237/272/347/273/274/350/277/260.md +184 -184
  449. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/274/226/350/257/221/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  450. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/207/252/346/210/221/346/204/217/350/257/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +270 -270
  451. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +698 -698
  452. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/273/204/346/210/220/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  453. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/275/221/347/273/234/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  454. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/257/255/350/250/200/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +226 -226
  455. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/275/257/344/273/266/345/267/245/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  456. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/201/227/344/274/240/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  457. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/217/345/255/220/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  458. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/221/350/236/215/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  459. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  460. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  461. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  462. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/200/235/346/203/263/346/224/277/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  463. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  464. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +365 -365
  465. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +269 -269
  466. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  467. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  468. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/345/210/206/345/255/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  469. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +157 -157
  470. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +237 -237
  471. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  472. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  473. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  474. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  475. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  476. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  477. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  478. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  479. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  480. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  481. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  482. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  483. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  484. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  485. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  486. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  487. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  488. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  489. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  490. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  491. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  492. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  493. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  494. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  495. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  496. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  497. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  498. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  499. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  500. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  501. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  502. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  503. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  504. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  505. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/346/235/241/344/273/266/350/267/257/347/224/261/345/233/276_CCG/350/256/276/350/256/241.md +150 -150
  506. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/350/257/255/344/271/211/346/235/241/344/273/266/345/215/217/350/256/256.md +650 -650
  507. package/md_cg/whitebox_kb/wisdom/docs//345/261/200/351/203/250/346/234/200/344/274/230/344/270/216/346/203/205/347/273/252/345/201/217/345/245/275_/347/220/206/350/256/272/345/267/245/347/250/213.md +97 -97
  508. package/md_cg/whitebox_kb/wisdom/docs//346/226/271/345/220/221/346/200/247/346/212/211/346/213/251_/350/207/252/344/270/276vs/350/207/252/350/277/255/344/273/243.md +81 -81
  509. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242AGI/346/236/266/346/236/204/346/216/242/347/264/242_/346/226/207/346/241/243/350/247/204/345/210/222.md +51 -51
  510. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242/346/217/222/344/273/266/345/210/206/347/261/273/345/210/206/346/236/220.md +67 -67
  511. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/346/234/254/345/234/260/346/240/241/351/252/214/345/231/250_ZeroLLM_Verifier.md +276 -276
  512. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/350/207/252/344/270/276/347/254/254/345/205/255/351/230/266/346/256/265_/346/224/266/345/256/230/346/200/273/347/273/223.md +1207 -1207
  513. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  514. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  515. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  516. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  517. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  518. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  519. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  520. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  521. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  522. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  523. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  524. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  525. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  526. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  527. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  528. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  529. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  530. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  531. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  532. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  533. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  534. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  535. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  536. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  537. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  538. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  539. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  540. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  541. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  542. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  543. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  544. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  545. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  546. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  547. package/md_cg/writegate.py +146 -0
  548. package/md_cg/writepipe.py +85 -7
  549. package/package.json +20 -6
  550. package/scripts/workspace_index.py +1 -0
  551. package/skills/README.md +121 -121
  552. package/skills/plugin.json +54 -54
  553. package/skills/skills/designer-perspective/SKILL.md +158 -158
  554. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  555. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  556. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  557. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  558. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  559. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  560. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  561. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  562. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  563. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  564. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  565. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  566. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  567. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  568. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  569. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  570. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  571. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  572. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  573. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  574. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  663. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  664. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  665. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  666. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  667. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  668. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  669. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  670. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  671. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  672. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  673. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  674. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  675. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  676. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  677. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  679. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  780. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  781. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  782. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  783. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  784. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  785. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  786. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  787. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  788. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  789. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  790. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  791. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  792. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  793. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  794. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  796. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  898. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  899. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  900. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  901. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  902. package/skills/skills/lingshu-net/SKILL.md +48 -48
  903. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  904. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  905. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  906. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  907. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  908. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  909. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  910. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  911. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  912. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  914. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1017. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1021. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1032. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1130. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1134. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1145. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1250. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1251. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1252. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1253. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1254. package/src/hooks.ts +26 -12
  1255. package/src/index.ts +3 -0
  1256. package/src/lib/console_web.mjs +104 -0
  1257. package/src/lib/hook_audit.ts +34 -1
  1258. package/src/lib/python_path.ts +71 -71
  1259. package/src/lib/session_state.ts +127 -127
  1260. package/src/lib/whitebox_llm.ts +311 -311
  1261. package/ui/minimal/LICENSE +21 -0
  1262. package/ui/minimal/install.ps1 +168 -0
  1263. package/ui/minimal/integrity.json +41 -0
  1264. package/ui/minimal/payload/build-ui.mjs +16 -0
  1265. package/ui/minimal/payload/lib/client.js +18 -0
  1266. package/ui/minimal/payload/lib/lib/console_web.mjs +104 -0
  1267. package/ui/minimal/payload/src/lib/console_web.mjs +104 -0
  1268. package/ui/minimal/payload/web/app.js +154 -0
  1269. package/ui/minimal/payload/web/client.js +14 -0
  1270. package/ui/minimal/payload/web/entry.js +1 -0
  1271. package/ui/minimal/payload/web/index.html +3 -0
  1272. package/ui/minimal/payload/web/style.css +3 -0
  1273. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1274. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1275. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1276. package/utf8_boot.py +237 -237
  1277. package/web/app.js +154 -0
  1278. package/web/client.js +14 -0
  1279. package/web/entry.js +1 -0
  1280. package/web/index.html +3 -0
  1281. package/web/style.css +3 -0
@@ -1,843 +1,880 @@
1
- # -*- coding: utf-8 -*-
2
- """md_cg · B4 守卫:索引分片目录不自愈(长驻进程内 `_index_log/` 被删后
3
- append 永抛 `FileNotFoundError`,且永不恢复)
4
-
5
- 缺陷(修复前,本守卫红态实抓:`probe_b4.py` 探针 + 本文件 A 组)
6
- ``ShardedLog`` 只在 ``__init__`` 里 ``makedirs(self.dir)``;``append`` 首次
7
- ``open(self.path, "a")`` 前**不复查目录**。生产形态是长驻进程(``MdCGSecure(
8
- root, principal, autoflush=1)``,``MdCG.flush`` 每批写完整批 ``close()`` 分片
9
- 句柄 ⇒ 下次 append 必经重开),于是:
10
-
11
- · 进程内存活期间 ``_index_log/`` 被删(外部清理脚本 / 误删 / 备份还原)后,
12
- 此后**每次** append 都在 ``open`` 处抛 ``FileNotFoundError [Errno 2]``;
13
- · 目录三次都不重建、``close()`` 抛同一异常、``_index.json`` 从未落成;
14
- · 正文 ``.md`` 已落盘(``mdcg.py`` 先写盘再标脏索引)而索引未更新——
15
- 索引静默落后于盘面,且**无任何失败信号以外的可观测痕迹**。
16
-
17
- 实测(2026-09-30,沙箱临时根,非在役库):
18
- · 修前:``add#2/#3/#4`` 三连抛 ``FileNotFoundError``,崩点 ``fsutil.py`` 的
19
- ``open``(原 564 行);``read_all`` 返回 ``[]``;``close()`` 抛同异常;
20
- ``_index.json`` 不存在。
21
- · 不自愈的必要条件是「**本进程已持有 ShardedLog 实例**」:``md_cg/mdcg.py``
22
- 仅在 ``self._log is None`` 时建实例;全新短命进程做同一操作时
23
- ``__init__`` 的 makedirs 生效、目录会被重建(反证,探针 P-4 已给)。
24
-
25
- 修复口径(**单点**:`fsutil.ensure_shard_dir` 是分片目录存在性的唯一实现,
26
- ``ShardedLog.__init__`` 与 ``ShardedLog.append`` 两处调用点都是委托、不做副本):
27
- ① ``append`` 首次打开分片前确保 ``self.dir`` 存在——缺失即重建,**路径照常**
28
- (仍是 ``self.path``,同一分片名,只补回目录这一层)。
29
- ② **容忍 ≠ 静默**(本仓 N225 已确立的判据):重建成功要可观测——模块级计数
30
- ``SHARD_DIR_REBUILDS`` + 有界样本 + stderr 汇总告警;**首建不记账**
31
- (``where="init"`` = 建库时目录本就不存在,那是正常路径;计入会淹没真事件)。
32
- ③ 重建**失败**(父目录只读 / 权限不足 / 有文件占着该路径)抛结构化
33
- ``ShardDirError``:可机读 ``code=E_SHARD_DIR_UNREBUILDABLE`` + 可操作
34
- ``hint`` + ``path``,且**仍是 ``OSError`` 子类**(既有 ``except OSError``
35
- 面的语义不漂移);失败**同样记账 + 告警**——异常可能被上层兜底吞掉
36
- (``MdCG.close`` 的 ``except (OSError, ValueError)``),痕迹不得只存在于
37
- 异常里。
38
- ④ ``read_all`` 既有语义**一字不改**:directory 不是目录 → 返回 ``[]``。
39
-
40
- 守卫构成(A 自愈面 / B 边界与既有语义 / C 重建失败的结构化 / D 生产链 /
41
- E MCP 出口端到端):
42
- A 6 条:删目录后 append 不抛 · 目录真被重建 · 删除后的记录真落进分片 ·
43
- 记账可断言(次数 + 样本)· stderr 告警可观测 · **路径照常**(分片名不换)
44
- B 5 条:read_all 缺目录 → ``[]`` 不抛(要求④)· read_all 路径是文件 → ``[]``
45
- 不抛 · 首建不记账(计数 0 + stderr 干净)· 目录在位时零记账零告警(不产生
46
- 噪声)· clear 缺目录 → 直接返回不抛(既有语义)
47
- C 9 条(有文件占着分片目录路径 ⇒ 重建必失败):抛 ``ShardDirError`` 而非裸
48
- ``FileNotFoundError`` · 仍是 ``OSError`` 子类 · ``code`` 可机读 · message
49
- 首字段含 ``[code]``(出口串里可机读)· ``hint`` 非空且含目录与处置 ·
50
- ``path`` 属性 · 失败也记账 · 失败也告警 · **打开面同口径**(append 重建失败
51
- 也抛同一结构化错误、``where=append`` 记账)
52
- D 5 条(长驻 ``MdCG`` 实例,autoflush=1):删 ``_index_log`` 后再 add 不抛 ·
53
- 节点索引可见且盘面 ``.md`` 一致 · 分片日志可重放(索引不落后于盘面)·
54
- 生产链自愈也记账 · 生产链自愈也告警
55
- E 4 条(`python -X utf8 -m md_cg.mcp_server` stdio 主循环 + 文件占住
56
- ``_index_log``):MCP 出口的 error 串含 ``E_SHARD_DIR_UNREBUILDABLE``(不是
57
- 裸 ``FileNotFoundError``)· 同一应答带可操作 ``hint`` · 错误之后进程仍应答
58
- 且 shutdown 后 rc=0 · 变异轮**注入自证**在场(fail-closed:注入失效不得被
59
- 读成「端到端面无判别力」)
60
-
61
- ``--branch-baseline`` 定点变异自证(与 ``test_n225_nonobject_load`` 同口径):
62
- 逐个关掉一处判据,守卫**必须转红**且红项**恰好**落在该判据负责的组、数量等于
63
- 表内预期;锚点漂移报 ``ANCHOR-MISS`` 并以**退出码 2** fail-closed 停手;基线源
64
- 是**工作区源码**(``inspect.getsource`` 取自当前已加载模块),绝不绑 git HEAD。
65
- ``--drop-fix`` 是「抽掉修复本体」的定点自证:只施加 M1(append 前不复查目录),
66
- 逐个打印转红的断言名与红项数,恢复后重跑并打印绿项数——「红→恢复→绿」三态
67
- 原样可见。
68
-
69
- **并行编辑边界(如实)**:D/E 组依赖 ``md_cg`` 包内 ``MdCG``/``mcp_server`` 在
70
- 树内**完整可用**;本轮是多分片并行修改同一工作区,若 ``mdcg.py`` 正处于中间态
71
- (类体被插断 ⇒ ``MdCG`` 缺 ``_write_node``),D/E 会整组红——那是**真红**(树
72
- 确实不可用),不是守卫自身的判别力问题;此时按「HEAD 基线树 + 本处 delta」的
73
- 隔离镜像跑本文件(见 FixReport)。
74
-
75
- 隔离纪律(与 ``test_n225_nonobject_load`` / ``test_n206_stdio_jsonrpc_type``
76
- 同款):env 剔净全部 MDCG_*/HIVE_* 注入面,只注入指向临时目录的
77
- ``MDCG_ROOT``/``MDCG_AUX_ROOT``/``MDCG_STATE_ROOT``/``MDCG_DATA_ROOT``/
78
- ``MDCG_TENANT_REGISTRY``(指向不存在的临时路径=空表回落)/``MDCG_SUSTAIN=0``/
79
- ``MDCG_LEGACY_ENV_AUTH=1``;全部合成库落在 ``tempfile.mkdtemp`` 下,跑完 rmtree。
80
- **绝不触在役活库、真实令牌库与真实 serve。**
81
-
82
- 运行:
83
- python -X utf8 -m md_cg.test_b4_shard_dir_selfheal
84
- python -X utf8 -m md_cg.test_b4_shard_dir_selfheal --branch-baseline
85
- python -X utf8 -m md_cg.test_b4_shard_dir_selfheal --drop-fix
86
- """
87
- from __future__ import annotations
88
-
89
- import contextlib
90
- import inspect
91
- import io
92
- import json
93
- import os
94
- import shutil
95
- import subprocess
96
- import sys
97
- import tempfile
98
- import textwrap
99
- from contextlib import redirect_stderr
100
-
101
- try:
102
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
103
- except AttributeError:
104
- pass
105
-
106
- from . import fsutil as F # noqa: E402
107
-
108
- PASS, FAIL = 0, 0
109
- FAILS = []
110
- _CURRENT = ["?"]
111
- _GROUP_FAILS = {}
112
- _TMP_ROOTS = []
113
- _LIVE = []
114
-
115
- # 六要素正文(写入闸要求的 text 形态;D/E 组的写入用它)
116
- BODY = ("# 功能名:B4 守卫合成节点\n# 生效条件:守卫运行期间\n# 子功能:占位\n"
117
- "# 执行:占位\n# 验证方式:test\n# 不适用条件:非守卫运行")
118
-
119
-
120
- # 生效条件:把 PASS/FAIL/失败名单/分组失败数全部清零并解除当前组名(每次完整跑套件前调用;--branch-baseline 每个变异轮都要一次干净基线)。
121
- def _reset_counters():
122
- global PASS, FAIL
123
- PASS = FAIL = 0
124
- del FAILS[:]
125
- _GROUP_FAILS.clear()
126
- _CURRENT[0] = "?"
127
-
128
-
129
- # 生效条件:group 为非空字符串时设为当前组名并在 _GROUP_FAILS 里开出该组条目(未开则记 0);重复调用同名组只是切换当前组,不清零已有计数。
130
- def begin(group: str):
131
- _CURRENT[0] = group
132
- _GROUP_FAILS.setdefault(group, 0)
133
-
134
-
135
- # 生效条件:cond 为真记一条通过并打印;为假把 FAIL 与当前组失败数各 +1、把 name 追加进 FAILS 并打印 detail(detail 为空则只打印名字)。
136
- def check(name, cond, detail=""):
137
- global PASS, FAIL
138
- if cond:
139
- PASS += 1
140
- print(" [ok] %s" % name)
141
- return True
142
- FAIL += 1
143
- _GROUP_FAILS[_CURRENT[0]] = _GROUP_FAILS.get(_CURRENT[0], 0) + 1
144
- FAILS.append(name)
145
- print(" [FAIL] %s %s" % (name, detail))
146
- return False
147
-
148
-
149
- # 生效条件:fn 为无参回调时调用它取条件值——回调抛异常即判红并把异常类型与消息写进 detail(**不中断整组**,保证「变异下红项数 == 该组断言数」这一精确口径成立);fn 正常返回则按返回值真假记账;detail 传 callable 时在同一保护下求值。
150
- def check_fn(name, fn, detail=""):
151
- if callable(detail):
152
- try:
153
- detail = detail()
154
- except Exception as exc: # noqa: BLE001
155
- detail = "detail 求值抛 %s: %s" % (type(exc).__name__, exc)
156
- try:
157
- cond = bool(fn())
158
- extra = detail
159
- except Exception as exc: # noqa: BLE001 —— 红态正是抛异常
160
- cond = False
161
- extra = "回调抛 %s: %s(%s)" % (type(exc).__name__, exc, detail)
162
- return check(name, cond, extra)
163
-
164
-
165
- # 生效条件:新建系统临时目录(prefix 前缀)并把路径登记进 _TMP_ROOTS,供本次运行收尾统一 rmtree;返回该路径。
166
- def _tmpdir(prefix: str) -> str:
167
- p = tempfile.mkdtemp(prefix=prefix)
168
- _TMP_ROOTS.append(p)
169
- return p
170
-
171
-
172
- # 生效条件:无入参,对 _TMP_ROOTS 里每个目录 rmtree(ignore_errors=True) 并清空清单、对 _LIVE 里每个认知图实例尝试 close()(异常吞掉,收尾不该再抛);收尾是幂等的。
173
- def _cleanup():
174
- for cg in _LIVE:
175
- try:
176
- cg.close()
177
- except Exception: # noqa: BLE001 —— 收尾路径不再抛
178
- pass
179
- del _LIVE[:]
180
- for p in _TMP_ROOTS:
181
- shutil.rmtree(p, ignore_errors=True)
182
- del _TMP_ROOTS[:]
183
-
184
-
185
- # ---------------- A/B/C 组 fixture(只碰 fsutil,不依赖 mdcg) ----------------
186
-
187
- # 生效条件:无入参时在临时目录建一个分片实例写入 a0、close(生产写点每批写完即 close 句柄)→ 记录分片名 → 重置记账 → rmtree 分片目录 → 以 redirect_stderr 捕获告警后追加 a1、close、追加 a2、close;返回上下文 dict(d / base / stats / stderr / err / ids / files / dir_after)。
188
- def _case_heal() -> dict:
189
- tmp = _tmpdir("mdcg_b4_heal_")
190
- d = os.path.join(tmp, "_index_log")
191
- ctx = {"d": d, "base": None, "stats": None, "stderr": "", "err": None,
192
- "ids": None, "files": None, "dir_after": None, "err0": None}
193
- lg = None
194
- try:
195
- lg = F.ShardedLog(d)
196
- lg.append({"id": "a0"})
197
- lg.close()
198
- ctx["base"] = os.path.basename(lg.path)
199
- F.reset_shard_dir_stats()
200
- shutil.rmtree(d)
201
- buf = io.StringIO()
202
- try:
203
- with redirect_stderr(buf):
204
- lg.append({"id": "a1"})
205
- lg.close()
206
- lg.append({"id": "a2"})
207
- lg.close()
208
- except Exception as exc: # noqa: BLE001 —— 修前此处即红
209
- ctx["err"] = exc
210
- ctx["stderr"] = buf.getvalue()
211
- ctx["stats"] = F.shard_dir_stats()
212
- ctx["dir_after"] = os.path.isdir(d)
213
- ctx["files"] = sorted(os.listdir(d)) if os.path.isdir(d) else None
214
- ctx["ids"] = [r.get("id") for r in F.ShardedLog.read_all(d)]
215
- except Exception as exc: # noqa: BLE001
216
- ctx["err0"] = exc
217
- return ctx
218
-
219
-
220
- # 生效条件:无入参时跑两段「重建必失败」场景——① 用**文件占住**分片目录路径后构造 ShardedLog(构造面):isdir 为假、makedirs 必抛 FileExistsError;② 先正常构造再 rmdir 目录、用文件占住同路径后 append(打开面):同一条单点判据、同一结构化错误;返回上下文 dict(d / err / stats / stderr / d2 / err_append / stats2 / stderr2 / err0)。
221
- def _case_fail() -> dict:
222
- tmp = _tmpdir("mdcg_b4_fail_")
223
- d = os.path.join(tmp, "_index_log")
224
- ctx = {"d": d, "err": None, "stats": None, "stderr": "", "d2": None,
225
- "err_append": None, "stats2": None, "stderr2": "", "err0": None}
226
- try:
227
- with open(d, "w", encoding="utf-8") as fh:
228
- fh.write("squat") # 有文件占着该路径 → 重建必失败
229
- F.reset_shard_dir_stats()
230
- buf = io.StringIO()
231
- try:
232
- with redirect_stderr(buf):
233
- F.ShardedLog(d) # 构造面(where="init")
234
- except Exception as exc: # noqa: BLE001 —— 期望结构化错误
235
- ctx["err"] = exc
236
- ctx["stderr"] = buf.getvalue()
237
- ctx["stats"] = F.shard_dir_stats()
238
-
239
- d2 = os.path.join(tmp, "_index_log_append")
240
- ctx["d2"] = d2
241
- lg = F.ShardedLog(d2) # 先正常建好
242
- os.rmdir(d2) # 再抽掉目录
243
- with open(d2, "w", encoding="utf-8") as fh:
244
- fh.write("squat")
245
- F.reset_shard_dir_stats()
246
- buf2 = io.StringIO()
247
- try:
248
- with redirect_stderr(buf2):
249
- lg.append({"id": "c1"}) # 打开面(where="append")
250
- except Exception as exc: # noqa: BLE001
251
- ctx["err_append"] = exc
252
- ctx["stderr2"] = buf2.getvalue()
253
- ctx["stats2"] = F.shard_dir_stats()
254
- except Exception as exc: # noqa: BLE001
255
- ctx["err0"] = exc
256
- return ctx
257
-
258
-
259
- # ---------------- D 生产链 fixture(长驻 MdCG 实例) ----------------
260
-
261
- # 生效条件:无入参时在临时根建 MdCG(root, autoflush=1) 长驻实例并写入 p0(此时分片目录已建成)→ 重置记账 → 以 redirect_stderr 捕获告警后 rmtree(_index_log) 并再写 p1/p2;返回上下文 dict(root / cg / log_dir / stats / stderr / nodes / ids / on_disk / err)。
262
- def _case_prod() -> dict:
263
- from .mdcg import MdCG
264
- tmp = _tmpdir("mdcg_b4_prod_")
265
- root = os.path.join(tmp, "cgroot")
266
- ctx = {"root": root, "cg": None, "log_dir": None, "stats": None,
267
- "stderr": "", "nodes": None, "ids": None, "on_disk": None,
268
- "err": None}
269
- try:
270
- cg = MdCG(root, autoflush=1)
271
- ctx["cg"] = cg
272
- _LIVE.append(cg)
273
- cg.add("b4_p0", BODY, layer="knowledge")
274
- log_dir = cg.index_log_dir
275
- ctx["log_dir"] = log_dir
276
- F.reset_shard_dir_stats()
277
- buf = io.StringIO()
278
- with redirect_stderr(buf):
279
- shutil.rmtree(log_dir)
280
- cg.add("b4_p1", BODY, layer="knowledge")
281
- cg.add("b4_p2", BODY, layer="knowledge")
282
- ctx["stderr"] = buf.getvalue()
283
- ctx["stats"] = F.shard_dir_stats()
284
- ctx["nodes"] = sorted(cg.index["nodes"])
285
- ctx["ids"] = [r.get("id") for r in F.ShardedLog.read_all(log_dir)]
286
- e = cg.index["nodes"].get("b4_p2") or {}
287
- ctx["on_disk"] = os.path.exists(os.path.join(root, e.get("path") or ""))
288
- except Exception as exc: # noqa: BLE001
289
- ctx["err"] = exc
290
- return ctx
291
-
292
-
293
- # ---------------- E stdio 端到端 fixture(MCP 出口) ----------------
294
-
295
- # 模拟宿主前先把「身份/路径/编码」注入面清干净——子进程只吃临时目录(与 N225/N206 同款)
296
- _DIRTY_KEYS = (
297
- "MDCG_TOKEN", "MDCG_TOKEN_FILE", "MDCG_MASTER_KEY", "MDCG_CLEARANCE",
298
- "MDCG_TENANT", "MDCG_TENANT_REGISTRY",
299
- "MDCG_CAN_ADMIN", "MDCG_CAN_WRITE", "MDCG_LEGACY_ENV_AUTH",
300
- "MDCG_LEGACY_ENV_ADMIN", "MDCG_SESSION", "DSH_SESSION_ID",
301
- "MDCG_HARNESS", "MDCG_UNIT", "MDCG_ROOT", "MDCG_STATE_ROOT",
302
- "MDCG_DATA_ROOT", "MDCG_AUX_ROOT", "MDCG_SUSTAIN", "MDCG_SUSTAIN_NAME",
303
- "MDCG_MCP_SURFACE", "MDCG_TOOL_FACE", "MDCG_ACTOR",
304
- "MDCG_VERIFIER_MODULES", "MDCG_HIVE_JOBS",
305
- "PYTHONUTF8", "PYTHONIOENCODING", "PYTHONLEGACYWINDOWSSTDIO",
306
- )
307
-
308
-
309
- # 生效条件:tmp 为本次隔离根时,返回剔净 _DIRTY_KEYS 后的 os.environ 副本再注入指向 tmp 的覆盖键(MDCG_ROOT / MDCG_TENANT_REGISTRY / MDCG_STATE_ROOT / MDCG_DATA_ROOT / MDCG_AUX_ROOT / MDCG_TOKEN_FILE / MDCG_MASTER_KEY / MDCG_SUSTAIN / MDCG_LEGACY_ENV_AUTH / MDCG_ACTOR)——子进程绝不读真实 ~/.mdcg、真实令牌库与真实密钥面。
310
- def _env(tmp: str) -> dict:
311
- env = {k: v for k, v in os.environ.items() if k not in _DIRTY_KEYS}
312
- env["MDCG_ROOT"] = os.path.join(tmp, "cgroot")
313
- env["MDCG_TENANT_REGISTRY"] = os.path.join(tmp, "_tenants_absent.json")
314
- env["MDCG_STATE_ROOT"] = os.path.join(tmp, "state")
315
- env["MDCG_DATA_ROOT"] = os.path.join(tmp, "data")
316
- env["MDCG_AUX_ROOT"] = os.path.join(tmp, "auxroot") # 不可取名 "aux"(设备名)
317
- env["MDCG_TOKEN_FILE"] = os.path.join(tmp, "tokens.json")
318
- env["MDCG_MASTER_KEY"] = "00" * 32 # 哑主密钥
319
- env["MDCG_SUSTAIN"] = "0" # 关常驻循环
320
- env["MDCG_LEGACY_ENV_AUTH"] = "1" # 既有豁免面:零令牌
321
- env["MDCG_ACTOR"] = "b4-guard"
322
- return env
323
-
324
-
325
- # 当前生效的变异(仅 --branch-baseline/--drop-fix 期间非 None):内存 patch 不跨
326
- # 进程,E 组走独立子进程 ⇒ 靠 sitecustomize 把同一处定点变异注入子进程,端到端
327
- # 面才有真正的判别力。注入以 stderr 标记自证,标记缺失即 E 组判红(fail-closed)。
328
- _MUTATION = [None]
329
-
330
- _SITECUSTOMIZE_SRC = '''# B4 守卫跨进程变异注入(临时件,随 tmp 目录一并回收)
331
- import os
332
- import sys
333
- import textwrap
334
- import inspect
335
- _repo = os.environ.get("B4_REPO") or ""
336
- if _repo and _repo not in sys.path:
337
- sys.path.insert(0, _repo)
338
- try:
339
- from md_cg import fsutil as _F
340
- _which = os.environ["B4_MUT_WHICH"]
341
- _fname = os.environ["B4_MUT_FUNC"]
342
- _old = os.environ["B4_MUT_OLD"]
343
- _new = os.environ["B4_MUT_NEW"]
344
- if _which == "fsutil":
345
- _holder, _raw = _F.ShardedLog, _F.ShardedLog.__dict__[_fname]
346
- else: # fsutil_mod:模块级函数
347
- _holder, _raw = _F, _F.__dict__[_fname]
348
- _src = inspect.getsource(getattr(_raw, "__func__", _raw))
349
- _src = textwrap.dedent(_src[_src.index("def %s(" % _fname):])
350
- # 真全局(vars(_F) 副本会让被测函数的 `global X; X += 1` 写进临时 dict,
351
- # 父进程断言读到的恒为 0 ⇒ 那是 patch 机制的假红,不是判据红)。
352
- _ns = _F.__dict__
353
- exec(compile(_src.replace(_old, _new), "b4_mut.py", "exec"), _ns)
354
- if _which == "fsutil":
355
- setattr(_holder, _fname, staticmethod(_ns[_fname]))
356
- else:
357
- setattr(_holder, _fname, _ns[_fname])
358
- sys.stderr.write("[b4-mut] injected %s.%s\\n" % (_which, _fname))
359
- except Exception as _e:
360
- sys.stderr.write("[b4-mut] inject FAILED: %r\\n" % (_e,))
361
- '''
362
-
363
-
364
- # 生效条件:lines 为待喂给 stdin 的字符串序列、tmp 为隔离根时,spawn `python -X utf8 -m md_cg.mcp_server`(cwd=包根、env=_env(tmp);变异轮另经 sitecustomize 注入)一次喂完并 communicate;超时则 kill 后取残余输出;随后删掉**本子进程自己**的自报戳;返回 (returncode, stdout, stderr)。
365
- def _talk(lines, tmp: str, timeout: int = 180):
366
- env = _env(tmp)
367
- mut = _MUTATION[0]
368
- if mut is not None:
369
- sc_dir = os.path.join(tmp, "_mutpath")
370
- os.makedirs(sc_dir, exist_ok=True)
371
- with open(os.path.join(sc_dir, "sitecustomize.py"), "w",
372
- encoding="utf-8") as f:
373
- f.write(_SITECUSTOMIZE_SRC)
374
- env["PYTHONPATH"] = sc_dir + os.pathsep + env.get("PYTHONPATH", "")
375
- env["B4_REPO"] = os.path.dirname(os.path.dirname(
376
- os.path.abspath(__file__)))
377
- env["B4_MUT_WHICH"] = mut["which"]
378
- env["B4_MUT_FUNC"] = mut["func"]
379
- env["B4_MUT_OLD"] = mut["old"]
380
- env["B4_MUT_NEW"] = mut["new"]
381
- proc = subprocess.Popen(
382
- [sys.executable, "-X", "utf8", "-m", "md_cg.mcp_server"],
383
- cwd=os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
384
- env=env, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
385
- stderr=subprocess.PIPE, text=True, encoding="utf-8", errors="replace")
386
- try:
387
- out, err = proc.communicate("\n".join(lines) + "\n", timeout=timeout)
388
- except subprocess.TimeoutExpired:
389
- proc.kill()
390
- out, err = proc.communicate()
391
- try:
392
- os.remove(os.path.join(tempfile.gettempdir(), "md_cg_servers",
393
- "%d.json" % proc.pid))
394
- except OSError:
395
- pass
396
- return proc.returncode, out or "", err or ""
397
-
398
-
399
- # 生效条件:rid/method 给定、params 为 None 时省略该键,否则原样写入;返回一行紧凑 JSON-RPC 请求文本。
400
- def _rpc(rid, method, params=None) -> str:
401
- msg = {"jsonrpc": "2.0", "id": rid, "method": method}
402
- if params is not None:
403
- msg["params"] = params
404
- return json.dumps(msg, ensure_ascii=False)
405
-
406
-
407
- # 生效条件:out 为 stdout 文本时逐行 strip、空行跳过,返回 [(原始行, 解析结果或 None)](解析失败记 None)。
408
- def _resp_lines(out: str):
409
- got = []
410
- for ln in out.splitlines():
411
- ln = ln.strip()
412
- if not ln:
413
- continue
414
- try:
415
- got.append((ln, json.loads(ln)))
416
- except ValueError:
417
- got.append((ln, None))
418
- return got
419
-
420
-
421
- # 生效条件:无入参时在临时根用**文件占住** `_index_log` 路径(重建必失败)→ 起 stdio 主循环喂 [initialize, mdcg_remember(b4_e1), tools/list, shutdown];返回上下文 dict(tmp / rc / out / err / by_id / tool_text / tool_obj / inject_ok / error)。
422
- def _case_stdio() -> dict:
423
- tmp = _tmpdir("mdcg_b4_stdio_")
424
- ctx = {"tmp": tmp, "rc": None, "out": "", "err": "", "by_id": {},
425
- "tool_text": "", "tool_obj": None, "inject_ok": True,
426
- "error": None}
427
- try:
428
- root = os.path.join(tmp, "cgroot")
429
- os.makedirs(root, exist_ok=True)
430
- with open(os.path.join(root, "_index_log"), "w",
431
- encoding="utf-8") as fh:
432
- fh.write("squat") # 目录路径被文件占住
433
- lines = [_rpc(1, "initialize"),
434
- _rpc(2, "tools/call",
435
- {"name": "mdcg_remember",
436
- "arguments": {"node_id": "b4_e1", "content": BODY}}),
437
- _rpc(3, "tools/list"), _rpc(4, "shutdown")]
438
- ctx["rc"], ctx["out"], ctx["err"] = _talk(lines, tmp)
439
- ctx["inject_ok"] = ("[b4-mut] injected" in ctx["err"]
440
- if _MUTATION[0] is not None else True)
441
- objs = [o for _raw, o in _resp_lines(ctx["out"])]
442
- ctx["by_id"] = {o.get("id"): o for o in objs if isinstance(o, dict)}
443
- call = ctx["by_id"].get(2) or {}
444
- content = (call.get("result") or {}).get("content") or []
445
- ctx["tool_text"] = content[0].get("text") if content else ""
446
- try:
447
- ctx["tool_obj"] = json.loads(ctx["tool_text"])
448
- except Exception: # noqa: BLE001 —— 非 JSON 也照实记录
449
- ctx["tool_obj"] = None
450
- except Exception as exc: # noqa: BLE001
451
- ctx["error"] = exc
452
- return ctx
453
-
454
-
455
- # ---------------- A 自愈面 ----------------
456
-
457
- # 生效条件:跑 A 组 6 条断言(append 不抛 / 目录被重建 / 删除后的记录真落进分片 / 记账可断言 / stderr 告警可观测 / 路径照常);ctx 由 _case_heal 产出,任一阶段抛异常时六条各自判红。
458
- def g_a():
459
- begin("A")
460
- ctx = _case_heal()
461
- check_fn("B4-A1·删目录后 append 不抛(修前为 FileNotFoundError)",
462
- lambda c=ctx: c["err"] is None and c["err0"] is None,
463
- "err=%r err0=%r" % (ctx["err"], ctx["err0"]))
464
- check_fn("B4-A2·分片目录被重建(isdir 为真)",
465
- lambda c=ctx: c["dir_after"] is True,
466
- "dir_after=%r" % (ctx["dir_after"],))
467
- check_fn("B4-A3·删除后的记录真落进分片(read_all 含 a1/a2)",
468
- lambda c=ctx: c["ids"] == ["a1", "a2"],
469
- "ids=%r" % (ctx["ids"],))
470
- check_fn("B4-A4·记账可断言(1 次重建 + 样本 where=append)",
471
- lambda c=ctx: c["stats"] is not None
472
- and c["stats"][0] == 1 and c["stats"][2] == 0
473
- and len(c["stats"][1]) == 1
474
- and c["stats"][1][0][1] == "append",
475
- "stats=%r" % (ctx["stats"],))
476
- check_fn("B4-A5·不静默(stderr 含「缺失」与目录名)",
477
- lambda c=ctx: "分片目录缺失" in c["stderr"]
478
- and "_index_log" in c["stderr"],
479
- "stderr=%r" % (ctx["stderr"][:200],))
480
- check_fn("B4-A6·路径照常(分片名与删前同名,不换名)",
481
- lambda c=ctx: c["files"] == [c["base"]],
482
- "files=%r base=%r" % (ctx["files"], ctx["base"]))
483
-
484
-
485
- # ---------------- B 边界与既有语义 ----------------
486
-
487
- # 生效条件:跑 B 组 5 条断言(read_all 缺目录 → [] / read_all 路径是文件 → [] / 首建不记账 / 目录在位零记账零告警 / clear 缺目录不抛),全部就地构造最小场景、不依赖 mdcg。
488
- def g_b():
489
- begin("B")
490
- tmp = _tmpdir("mdcg_b4_edge_")
491
- missing = os.path.join(tmp, "_index_log_absent")
492
- squat = os.path.join(tmp, "_index_log_squat")
493
- with open(squat, "w", encoding="utf-8") as fh:
494
- fh.write("squat")
495
-
496
- got_missing, err_missing = None, None
497
- try:
498
- got_missing = F.ShardedLog.read_all(missing)
499
- except Exception as exc: # noqa: BLE001
500
- err_missing = exc
501
- check_fn("B4-B1·read_all 缺目录 → [] 不抛(既有语义一字不改)",
502
- lambda: err_missing is None and got_missing == [],
503
- "got=%r err=%r" % (got_missing, err_missing))
504
-
505
- got_squat, err_squat = None, None
506
- try:
507
- got_squat = F.ShardedLog.read_all(squat)
508
- except Exception as exc: # noqa: BLE001
509
- err_squat = exc
510
- check_fn("B4-B2·read_all 路径是文件 → [] 不抛(非目录降级口径)",
511
- lambda: err_squat is None and got_squat == [],
512
- "got=%r err=%r" % (got_squat, err_squat))
513
-
514
- fresh = os.path.join(tmp, "_index_log_fresh")
515
- F.reset_shard_dir_stats()
516
- st = None
517
- buf = io.StringIO()
518
- with redirect_stderr(buf):
519
- lg = F.ShardedLog(fresh)
520
- lg.append({"id": "b_fresh"})
521
- lg.close()
522
- st = F.shard_dir_stats()
523
- check_fn("B4-B3·首建不记账(构造 + 首写:计数 0、stderr 干净)",
524
- lambda: st == (0, (), 0, ()) and buf.getvalue() == "",
525
- "stats=%r stderr=%r" % (st, buf.getvalue()[:120]))
526
-
527
- F.reset_shard_dir_stats()
528
- st2 = None
529
- buf2 = io.StringIO()
530
- with redirect_stderr(buf2):
531
- lg2 = F.ShardedLog(fresh) # 目录已存在
532
- lg2.append({"id": "b_exist"})
533
- lg2.close()
534
- st2 = F.shard_dir_stats()
535
- check_fn("B4-B4·目录在位时零记账零告警(不产生噪声)",
536
- lambda: st2 == (0, (), 0, ()) and buf2.getvalue() == ""
537
- and os.path.isdir(fresh),
538
- "stats=%r stderr=%r" % (st2, buf2.getvalue()[:120]))
539
-
540
- err_clear = None
541
- try:
542
- F.ShardedLog.clear(os.path.join(tmp, "_index_log_absent2"))
543
- except Exception as exc: # noqa: BLE001
544
- err_clear = exc
545
- check_fn("B4-B5·clear 缺目录 → 直接返回不抛(既有语义)",
546
- lambda: err_clear is None, "err=%r" % (err_clear,))
547
-
548
-
549
- # ---------------- C 重建失败的结构化 ----------------
550
-
551
- # 生效条件:跑 C 组 9 条断言(构造面:抛 ShardDirError 而非裸 FileNotFoundError / 仍是 OSError 子类 / code 可机读 / message 首字段含 [code] / hint 非空且含目录与处置 / path 属性 / 失败也记账 / 失败也告警;打开面:append 走同一条单点判据、同一结构化错误与 where=append 样本);ctx 由 _case_fail 产出。
552
- def g_c():
553
- begin("C")
554
- ctx = _case_fail()
555
- e = ctx["err"]
556
- check_fn("B4-C1·抛 ShardDirError(不是裸 FileNotFoundError)",
557
- lambda: isinstance(e, F.ShardDirError),
558
- "err=%r err0=%r" % (e, ctx["err0"]))
559
- check_fn("B4-C2·仍是 OSError 子类(既有 except OSError 面语义不变)",
560
- lambda: isinstance(e, OSError), "type=%s" % type(e).__name__)
561
- check_fn("B4-C3·code 可机读(== E_SHARD_DIR_UNREBUILDABLE)",
562
- lambda: getattr(e, "code", None) == F.SHARD_DIR_ERR_CODE,
563
- "code=%r" % (getattr(e, "code", None),))
564
- check_fn("B4-C4·message 首字段含 [code](MCP 出口 error 串里可机读)",
565
- lambda: ("[%s]" % F.SHARD_DIR_ERR_CODE) in str(e),
566
- "str=%r" % (str(e)[:160],))
567
- check_fn("B4-C5·hint 非空且含目录与处置(重开进程即可恢复索引)",
568
- lambda: bool(getattr(e, "hint", ""))
569
- and ctx["d"] in e.hint and "重开进程" in e.hint,
570
- "hint=%r" % (getattr(e, "hint", "")[:160],))
571
- check_fn("B4-C6·path 属性 == 分片目录(可机读定位)",
572
- lambda: getattr(e, "path", None) == ctx["d"],
573
- "path=%r d=%r" % (getattr(e, "path", None), ctx["d"]))
574
- check_fn("B4-C7·失败也记账(1 次失败 + 样本含 where 与异常类型名)",
575
- lambda: ctx["stats"] is not None and ctx["stats"][2] == 1
576
- and len(ctx["stats"][3]) == 1
577
- and ctx["stats"][3][0][1] == "init"
578
- and ctx["stats"][3][0][2] == "FileExistsError",
579
- "stats=%r" % (ctx["stats"],))
580
- check_fn("B4-C8·失败也告警(stderr 含「重建失败」与 code)",
581
- lambda: "重建失败" in ctx["stderr"]
582
- and F.SHARD_DIR_ERR_CODE in ctx["stderr"],
583
- "stderr=%r" % (ctx["stderr"][:200],))
584
- check_fn("B4-C9·打开面同口径:append 重建失败也抛结构化 + where=append 记账",
585
- lambda c=ctx: isinstance(c["err_append"], F.ShardDirError)
586
- and getattr(c["err_append"], "code", None) == F.SHARD_DIR_ERR_CODE
587
- and c["stats2"][2] == 1 and c["stats2"][3][0][1] == "append",
588
- "err=%r stats2=%r" % (ctx["err_append"], ctx["stats2"]))
589
-
590
-
591
- # ---------------- D 生产链(长驻 MdCG 实例) ----------------
592
-
593
- # 生效条件:跑 D 组 5 条断言(删 _index_log 后再 add 不抛 / 节点索引可见且盘面 .md 一致 / 分片日志可重放 / 生产链自愈也记账 / 生产链自愈也告警);ctx 由 _case_prod 产出,MdCG 不可用时五条各自判红。
594
- def g_d():
595
- begin("D")
596
- ctx = _case_prod()
597
- check_fn("B4-D1·生产链:删 _index_log 后再 add 不抛(修前为 FileNotFoundError)",
598
- lambda c=ctx: c["err"] is None, "err=%r" % (ctx["err"],))
599
- check_fn("B4-D2·删除后写入的节点索引可见且盘面 .md 存在(索引不落后于盘面)",
600
- lambda c=ctx: c["nodes"] is not None
601
- and {"b4_p0", "b4_p1", "b4_p2"} <= set(c["nodes"])
602
- and c["on_disk"] is True,
603
- "nodes=%r on_disk=%r" % (ctx["nodes"], ctx["on_disk"]))
604
- check_fn("B4-D3·分片日志可重放(read_all 含删除后写入的 p1/p2)",
605
- lambda c=ctx: c["ids"] is not None
606
- and {"b4_p1", "b4_p2"} <= set(c["ids"]),
607
- "ids=%r" % (ctx["ids"],))
608
- check_fn("B4-D4·生产链自愈也记账(1 次重建 + 样本 where=append)",
609
- lambda c=ctx: c["stats"] is not None and c["stats"][0] == 1
610
- and c["stats"][2] == 0 and len(c["stats"][1]) == 1
611
- and c["stats"][1][0][1] == "append",
612
- "stats=%r" % (ctx["stats"],))
613
- check_fn("B4-D5·生产链自愈也告警(stderr 含「缺失」与 _index_log)",
614
- lambda c=ctx: "分片目录缺失" in c["stderr"]
615
- and "_index_log" in c["stderr"],
616
- "stderr=%r" % (ctx["stderr"][:200],))
617
-
618
-
619
- # ---------------- E MCP 出口端到端 ----------------
620
-
621
- # 生效条件:跑 E 组 4 条断言(出口 error 串含 code / 出口带可操作 hint / 错误之后进程仍应答且 rc=0 / 变异轮注入自证在场);ctx 由 _case_stdio 产出。
622
- def g_e():
623
- begin("E")
624
- ctx = _case_stdio()
625
- obj = ctx["tool_obj"]
626
- check_fn("B4-E1·MCP 出口不裸抛:error 串含 E_SHARD_DIR_UNREBUILDABLE",
627
- lambda c=ctx: isinstance(c["tool_obj"], dict)
628
- and F.SHARD_DIR_ERR_CODE in (c["tool_obj"].get("error") or "")
629
- and "ShardDirError" in (c["tool_obj"].get("error") or ""),
630
- "tool_text=%r" % (ctx["tool_text"][:220],))
631
- check_fn("B4-E2·MCP 出口带可操作 hint(含「重开进程」处置)",
632
- lambda: isinstance(obj, dict)
633
- and "重开进程" in (obj.get("hint") or ""),
634
- "hint=%r" % ((obj or {}).get("hint") or "")[:160])
635
- check_fn("B4-E3·错误之后进程仍应答(tools/list 有 id=3 应答)且 rc=0",
636
- lambda c=ctx: c["rc"] == 0 and 3 in c["by_id"],
637
- "rc=%r ids=%r stderr=%r" % (ctx["rc"], sorted(ctx["by_id"]),
638
- ctx["err"][-200:]))
639
- check_fn("B4-E4·变异轮注入自证在场(fail-closed:注入失效即判红)",
640
- lambda c=ctx: c["inject_ok"] is True,
641
- "inject_ok=%r stderr=%r" % (ctx["inject_ok"], ctx["err"][-200:]))
642
-
643
-
644
- _GROUPS = (("A", g_a), ("B", g_b), ("C", g_c), ("D", g_d), ("E", g_e))
645
-
646
-
647
- # 生效条件:重算计数器后依次跑 A–E 五组(静默与否由 print 决定),返回 (总失败数, {组名: 失败数} 的副本);供正常模式与 --branch-baseline 的变异核验共用。
648
- def _run_groups():
649
- _reset_counters()
650
- for _name, fn in _GROUPS:
651
- fn()
652
- return FAIL, dict(_GROUP_FAILS)
653
-
654
-
655
- # ---------------- 定点变异自证 ----------------
656
-
657
- # 变异表:逐处关掉一个判据,守卫**必须转红**,且红项**恰好**落在该判据负责的
658
- # 组、数量等于表内预期(多一项少一项都报红)。表内数字是**实跑读数**(不是
659
- # 设计意图的估计),每条后面的「外溢面」注释说明该变异为什么牵连到别的组——
660
- # 红项数不是越小越好,而是必须与真实因果一致。基线源=**工作区源码**
661
- # (inspect.getsource 取自当前已加载模块),绝不绑 git HEAD。
662
- _MUTATIONS = (
663
- # ① 修复本体:append 首开前不复查目录(= 修前行为)。
664
- # 外溢面(如实登记,不掩盖):
665
- # · C9(append 面的结构化失败)——自愈调用被抽掉后 append 改由 open 抛裸
666
- # NotADirectoryError;
667
- # · D 全组 5 条——生产链 fixture 在第一次 add 就抛,后续读数(nodes /
668
- # read_all / 记账 / 告警)连带落空(修前实测就是这样:一次抛即整链停)。
669
- ("M1 抽掉修复本体(append 打开前不复查目录)",
670
- "fsutil", "append",
671
- 'ensure_shard_dir(self.dir, "append")', "pass",
672
- {"A": 6, "C": 1, "D": 5}),
673
- # ② 自愈静默:重建成功不记账(容忍 ≠ 静默的计数面)
674
- ("M2 自愈不记账(计数不累加)",
675
- "fsutil_mod", "note_shard_dir_rebuild",
676
- "SHARD_DIR_REBUILDS += 1", "pass",
677
- {"A": 1, "D": 1}),
678
- # ③ 自愈静默:重建成功不告警(stderr 面)
679
- ("M3 自愈不告警(stderr 静默)",
680
- "fsutil_mod", "note_shard_dir_rebuild",
681
- " sys.stderr.write(", " (lambda *a: None)(",
682
- {"A": 1, "D": 1}),
683
- # ④ 重建失败不记账不告警(痕迹只剩异常,被兜底吞掉即失明)。
684
- # 外溢面:C9 同轮转红(打开面复用同一记账函数)。
685
- ("M4 重建失败不记账不告警",
686
- "fsutil_mod", "ensure_shard_dir",
687
- "note_shard_dir_heal_failure(directory, where, exc)", "pass",
688
- {"C": 3}),
689
- # ⑤ 重建失败降级为裸 FileNotFoundError(③ 的反面:冒到出口)。
690
- # 外溢面:E1/E2(出口串里 code 与 hint 双失)——这正是本条要钉的死点。
691
- ("M5 重建失败降级为裸 FileNotFoundError",
692
- "fsutil_mod", "ensure_shard_dir",
693
- "note_shard_dir_heal_failure(directory, where, exc)",
694
- "raise FileNotFoundError(directory)",
695
- {"C": 8, "E": 2}),
696
- # ⑥ 口径过宽:首建也记账(把正常路径当病态事件,淹没真事件)
697
- ("M6 首建也记账(口径过宽)",
698
- "fsutil_mod", "note_shard_dir_rebuild",
699
- ' if where == "init":\n return', ' if False:\n return',
700
- {"B": 1}),
701
- # ⑦ 改掉 read_all「非目录 → []」语义(要求④ 的反面)。
702
- # 外溢面:D 全组 + E 全组——read_all 抛异常会打断 MdCG 装载链
703
- # (`_load_index` 在盘面无快照时经它重放),常驻服务连启动都过不去;
704
- # 这正是要求④「不许改 read_all 既有语义」的**因果理由**,不是偶然牵连。
705
- ("M7 read_all 非目录不再返回空列表",
706
- "fsutil", "read_all", " return []", " pass",
707
- {"B": 2, "D": 5, "E": 3}),
708
- )
709
-
710
-
711
- # 生效条件:which 为 "fsutil" 时从 ShardedLog 类、为 "fsutil_mod" 时从 fsutil 模块取 func_name 的源码文本;**从 `def <name>(` 行起截断再 dedent**(inspect.getsource 对本仓「顶格 `# 生效条件:` 注释 + 类内缩进 def」的排版会把注释一并带来,直接 dedent 会留下缩进 ⇒ IndentationError);函数缺失或无法取源时返回 None。
712
- def _func_src(which: str, func_name: str):
713
- try:
714
- if which == "fsutil":
715
- raw = F.ShardedLog.__dict__[func_name]
716
- else:
717
- raw = F.__dict__[func_name]
718
- fn = getattr(raw, "__func__", raw)
719
- src = inspect.getsource(fn)
720
- return textwrap.dedent(src[src.index("def %s(" % func_name):])
721
- except Exception: # noqa: BLE001 —— 取源失败按锚点漂移处理
722
- return None
723
-
724
-
725
- # 生效条件:which 为 "fsutil"/"fsutil_mod"、old 在 func_name 源码中时,把替换后的源码 exec 进 **fsutil 模块的真实命名空间**(`vars(F)` 而非副本——被测函数里的 `global X; X += 1` 必须落到模块真全局,副本会让计数写在临时 dict 里、守卫读到的恒为 0,那是 patch 机制的假红)并挂回目标(类属性或模块级名字;原为 staticmethod 者仍包 staticmethod),返回还原回调;old 不在源码中返回 None(调用方按 ANCHOR-MISS 处置,退出码 2)。
726
- def _patch(which: str, func_name: str, old: str, new: str):
727
- src = _func_src(which, func_name) # 取源必须在 exec 之前(exec 后原件被覆盖)
728
- if src is None or old not in src:
729
- return None
730
- holder = F.ShardedLog if which == "fsutil" else F
731
- orig = holder.__dict__[func_name] # ← 先存原件:exec 会就地覆盖目标名字
732
- ns = F.__dict__ # 真全局:global 语句必须落在被测模块命名空间
733
- exec(compile(src.replace(old, new), "b4_mut.py", "exec"), ns)
734
- if isinstance(orig, staticmethod):
735
- setattr(holder, func_name, staticmethod(ns[func_name]))
736
- else:
737
- setattr(holder, func_name, ns[func_name])
738
-
739
- def _restore():
740
- setattr(holder, func_name, orig)
741
- if holder is not F and ns.get(func_name) is not orig:
742
- ns.pop(func_name, None) # 类方法变异在模块面留下的同名残件
743
-
744
- return _restore
745
-
746
-
747
- # 生效条件:无入参时跑定点变异自证——先跑未变异基线(必须零失败),再逐个应用 _MUTATIONS:锚点缺失立即打印 ANCHOR-MISS 并返回 2(fail-closed,不再继续);变异后**逐一打印转红的断言名**与红项数,红项组与数量必须与预期完全一致,否则计入 bad;全部通过返回 0,存在不符返回 1。
748
- def _branch_baseline() -> int:
749
- print("!! 定点变异模式:逐处关掉判据,守卫应当转红且**恰好**命中预期组/项数\n")
750
- with contextlib.redirect_stdout(io.StringIO()):
751
- clean_fail, _clean_groups = _run_groups()
752
- print(" 未变异基线:失败=%d" % clean_fail)
753
- if clean_fail:
754
- print(" 基线即失败 → 定点变异自证无意义(先修基线)")
755
- return 1
756
- bad = []
757
- for label, which, fname, old, new, expect in _MUTATIONS:
758
- restore = _patch(which, fname, old, new)
759
- if restore is None:
760
- print(" ANCHOR-MISS %s —— 变异锚点漂移(实现改了却没同步本表;"
761
- "基线源=%s.%s)" % (label, which, fname))
762
- return 2 # fail-closed:锚点漂移不静默失效
763
- _MUTATION[0] = {"which": which, "func": fname, "old": old, "new": new}
764
- try:
765
- with contextlib.redirect_stdout(io.StringIO()):
766
- got_fail, got_groups = _run_groups()
767
- red_names = list(FAILS)
768
- finally:
769
- _MUTATION[0] = None
770
- restore()
771
- _cleanup() # 每轮清干净:临时根与活实例不跨轮累积
772
- hit = {g: n for g, n in got_groups.items() if n}
773
- print(" 关掉「%s」→ 红项=%d,命中组=%s" % (label, got_fail, hit))
774
- for nm in red_names:
775
- print(" [RED] %s" % nm)
776
- if hit == expect and got_fail == sum(expect.values()):
777
- print(" %s(与预期逐位一致)" % "OK")
778
- else:
779
- print(" MISMATCH 预期=%s/%d 实得=%s/%d"
780
- % (expect, sum(expect.values()), hit, got_fail))
781
- bad.append(label)
782
- return 0 if not bad else 1
783
-
784
-
785
- # 生效条件:无入参时只施加 M1(抽掉修复本体)——打印转红断言名与红项数、还原后重跑并打印绿项数(「红→恢复→绿」三态原地可见);锚点缺失返回 2,红项数与预期不符返回 1,两侧都符合返回 0。
786
- def _drop_fix() -> int:
787
- print("!! 抽掉修复本体:append 打开分片前不再复查目录(= 修前行为)\n")
788
- label, which, fname, old, new, expect = _MUTATIONS[0]
789
- print(" 变异:%s\n 锚点:%s.%s %r → %r\n" % (label, which, fname, old, new))
790
- restore = _patch(which, fname, old, new)
791
- if restore is None:
792
- print(" ANCHOR-MISS —— 锚点漂移,fail-closed(退出码 2)")
793
- return 2
794
- _MUTATION[0] = {"which": which, "func": fname, "old": old, "new": new}
795
- try:
796
- with contextlib.redirect_stdout(io.StringIO()):
797
- got_fail, got_groups = _run_groups()
798
- red_names = list(FAILS)
799
- finally:
800
- _MUTATION[0] = None
801
- restore()
802
- _cleanup()
803
- hit = {g: n for g, n in got_groups.items() if n}
804
- print(" 抽掉修复后:红项=%d 项,命中组=%s" % (got_fail, hit))
805
- for nm in red_names:
806
- print(" [RED] %s" % nm)
807
- with contextlib.redirect_stdout(io.StringIO()):
808
- back_fail, back_groups = _run_groups()
809
- back_hit = {g: n for g, n in back_groups.items() if n}
810
- print("\n 恢复修复后:红项=%d 项,命中组=%s(全绿 ⇒ 红态确由该改动引起)"
811
- % (back_fail, back_hit))
812
- ok_red = hit == expect and got_fail == sum(expect.values())
813
- ok_green = back_fail == 0
814
- print(" 判定:红态%s ;恢复%s"
815
- % ("符合预期(%s/%d)" % (expect, sum(expect.values())) if ok_red
816
- else "**与预期不符**(预期 %s/%d)" % (expect, sum(expect.values())),
817
- "转绿(0 失败)" if ok_green else "**仍未转绿(%d 失败)**"
818
- % back_fail))
819
- return 0 if (ok_red and ok_green) else 1
820
-
821
-
822
- # 生效条件:命令行含 --branch-baseline 时走定点变异自证(退出码 0/1/2);含 --drop-fix 时只抽掉修复本体跑「红→恢复→绿」(退出码 0/1/2);否则依次跑 A–E 五组打印逐条结果与汇总,全部通过返回 0、存在失败返回 1。
823
- def main() -> int:
824
- try:
825
- if "--branch-baseline" in sys.argv:
826
- return _branch_baseline()
827
- if "--drop-fix" in sys.argv:
828
- return _drop_fix()
829
- _reset_counters()
830
- for _name, fn in _GROUPS:
831
- fn()
832
- finally:
833
- _cleanup()
834
- print("\n" + "=" * 64)
835
- print("B4 分片目录自愈守卫:%d 通过,%d 失败" % (PASS, FAIL))
836
- if FAILS:
837
- for f in FAILS:
838
- print(" - %s" % f)
839
- return 0 if not FAILS else 1
840
-
841
-
842
- if __name__ == "__main__":
843
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · B4 守卫:索引分片目录不自愈(长驻进程内 `_index_log/` 被删后
3
+ append 永抛 `FileNotFoundError`,且永不恢复)
4
+
5
+ 缺陷(修复前,本守卫红态实抓:`probe_b4.py` 探针 + 本文件 A 组)
6
+ ``ShardedLog`` 只在 ``__init__`` 里 ``makedirs(self.dir)``;``append`` 首次
7
+ ``open(self.path, "a")`` 前**不复查目录**。生产形态是长驻进程(``MdCGSecure(
8
+ root, principal, autoflush=1)``,``MdCG.flush`` 每批写完整批 ``close()`` 分片
9
+ 句柄 ⇒ 下次 append 必经重开),于是:
10
+
11
+ · 进程内存活期间 ``_index_log/`` 被删(外部清理脚本 / 误删 / 备份还原)后,
12
+ 此后**每次** append 都在 ``open`` 处抛 ``FileNotFoundError [Errno 2]``;
13
+ · 目录三次都不重建、``close()`` 抛同一异常、``_index.json`` 从未落成;
14
+ · 正文 ``.md`` 已落盘(``mdcg.py`` 先写盘再标脏索引)而索引未更新——
15
+ 索引静默落后于盘面,且**无任何失败信号以外的可观测痕迹**。
16
+
17
+ 实测(2026-09-30,沙箱临时根,非在役库):
18
+ · 修前:``add#2/#3/#4`` 三连抛 ``FileNotFoundError``,崩点 ``fsutil.py`` 的
19
+ ``open``(原 564 行);``read_all`` 返回 ``[]``;``close()`` 抛同异常;
20
+ ``_index.json`` 不存在。
21
+ · 不自愈的必要条件是「**本进程已持有 ShardedLog 实例**」:``md_cg/mdcg.py``
22
+ 仅在 ``self._log is None`` 时建实例;全新短命进程做同一操作时
23
+ ``__init__`` 的 makedirs 生效、目录会被重建(反证,探针 P-4 已给)。
24
+
25
+ 修复口径(**单点**:`fsutil.ensure_shard_dir` 是分片目录存在性的唯一实现,
26
+ ``ShardedLog.__init__`` 与 ``ShardedLog.append`` 两处调用点都是委托、不做副本):
27
+ ① ``append`` 首次打开分片前确保 ``self.dir`` 存在——缺失即重建,**路径照常**
28
+ (仍是 ``self.path``,同一分片名,只补回目录这一层)。
29
+ ② **容忍 ≠ 静默**(本仓 N225 已确立的判据):重建成功要可观测——模块级计数
30
+ ``SHARD_DIR_REBUILDS`` + 有界样本 + stderr 汇总告警;**首建不记账**
31
+ (``where="init"`` = 建库时目录本就不存在,那是正常路径;计入会淹没真事件)。
32
+ ③ 重建**失败**(父目录只读 / 权限不足 / 有文件占着该路径)抛结构化
33
+ ``ShardDirError``:可机读 ``code=E_SHARD_DIR_UNREBUILDABLE`` + 可操作
34
+ ``hint`` + ``path``,且**仍是 ``OSError`` 子类**(既有 ``except OSError``
35
+ 面的语义不漂移);失败**同样记账 + 告警**——异常可能被上层兜底吞掉
36
+ (``MdCG.close`` 的 ``except (OSError, ValueError)``),痕迹不得只存在于
37
+ 异常里。
38
+ ④ ``read_all`` 既有语义**一字不改**:directory 不是目录 → 返回 ``[]``。
39
+
40
+ 守卫构成(A 自愈面 / B 边界与既有语义 / C 重建失败的结构化 / D 生产链 /
41
+ E MCP 出口端到端):
42
+ A 6 条:删目录后 append 不抛 · 目录真被重建 · 删除后的记录真落进分片 ·
43
+ 记账可断言(次数 + 样本)· stderr 告警可观测 · **路径照常**(分片名不换)
44
+ B 5 条:read_all 缺目录 → ``[]`` 不抛(要求④)· read_all 路径是文件 → ``[]``
45
+ 不抛 · 首建不记账(计数 0 + stderr 干净)· 目录在位时零记账零告警(不产生
46
+ 噪声)· clear 缺目录 → 直接返回不抛(既有语义)
47
+ C 9 条(有文件占着分片目录路径 ⇒ 重建必失败):抛 ``ShardDirError`` 而非裸
48
+ ``FileNotFoundError`` · 仍是 ``OSError`` 子类 · ``code`` 可机读 · message
49
+ 首字段含 ``[code]``(出口串里可机读)· ``hint`` 非空且含目录与处置 ·
50
+ ``path`` 属性 · 失败也记账 · 失败也告警 · **打开面同口径**(append 重建失败
51
+ 也抛同一结构化错误、``where=append`` 记账)
52
+ D 5 条(长驻 ``MdCG`` 实例,autoflush=1):删 ``_index_log`` 后再 add 不抛 ·
53
+ 节点索引可见且盘面 ``.md`` 一致 · 分片日志可重放(索引不落后于盘面)·
54
+ 生产链自愈也记账 · 生产链自愈也告警
55
+ E 4 条(`python -X utf8 -m md_cg.mcp_server` stdio 主循环 + 文件占住
56
+ ``_index_log``):MCP 出口的 error 串含 ``E_SHARD_DIR_UNREBUILDABLE``(不是
57
+ 裸 ``FileNotFoundError``)· 同一应答带可操作 ``hint`` · 错误之后进程仍应答
58
+ 且 shutdown 后 rc=0 · 变异轮**注入自证**在场(fail-closed:注入失效不得被
59
+ 读成「端到端面无判别力」)
60
+
61
+ **#677 P2 后的 E 组形态(契约变更,如实登记)**:写路径的索引落盘已异步化,
62
+ 故索引面的错误不再从**写应答**出(写应答必然 ok——节点已落盘、内存索引已同钩,
63
+ E3 就此断言);错误出口搬到显式同步落盘的 `cg(op=maintain, action=flush)`
64
+ (E1/E2 的断言对象)。E3 同时钉住「异步不回退写入」这个反向不变量——只留
65
+ 「写报错」的老形态会让异步退化成同步,只留「写成功」会让失败静默。
66
+
67
+ ``--branch-baseline`` 定点变异自证(与 ``test_n225_nonobject_load`` 同口径):
68
+ 逐个关掉一处判据,守卫**必须转红**且红项**恰好**落在该判据负责的组、数量等于
69
+ 表内预期;锚点漂移报 ``ANCHOR-MISS`` 并以**退出码 2** fail-closed 停手;基线源
70
+ 是**工作区源码**(``inspect.getsource`` 取自当前已加载模块),绝不绑 git HEAD。
71
+ ``--drop-fix`` 是「抽掉修复本体」的定点自证:只施加 M1(append 前不复查目录),
72
+ 逐个打印转红的断言名与红项数,恢复后重跑并打印绿项数——「红→恢复→绿」三态
73
+ 原样可见。
74
+
75
+ **并行编辑边界(如实)**:D/E 组依赖 ``md_cg`` 包内 ``MdCG``/``mcp_server`` 在
76
+ 树内**完整可用**;本轮是多分片并行修改同一工作区,若 ``mdcg.py`` 正处于中间态
77
+ (类体被插断 ⇒ ``MdCG`` 缺 ``_write_node``),D/E 会整组红——那是**真红**(树
78
+ 确实不可用),不是守卫自身的判别力问题;此时按「HEAD 基线树 + 本处 delta」的
79
+ 隔离镜像跑本文件(见 FixReport)。
80
+
81
+ 隔离纪律(与 ``test_n225_nonobject_load`` / ``test_n206_stdio_jsonrpc_type``
82
+ 同款):env 剔净全部 MDCG_*/HIVE_* 注入面,只注入指向临时目录的
83
+ ``MDCG_ROOT``/``MDCG_AUX_ROOT``/``MDCG_STATE_ROOT``/``MDCG_DATA_ROOT``/
84
+ ``MDCG_TENANT_REGISTRY``(指向不存在的临时路径=空表回落)/``MDCG_SUSTAIN=0``/
85
+ ``MDCG_LEGACY_ENV_AUTH=1``;全部合成库落在 ``tempfile.mkdtemp`` 下,跑完 rmtree。
86
+ **绝不触在役活库、真实令牌库与真实 serve。**
87
+
88
+ 运行:
89
+ python -X utf8 -m md_cg.test_b4_shard_dir_selfheal
90
+ python -X utf8 -m md_cg.test_b4_shard_dir_selfheal --branch-baseline
91
+ python -X utf8 -m md_cg.test_b4_shard_dir_selfheal --drop-fix
92
+ """
93
+ from __future__ import annotations
94
+
95
+ import contextlib
96
+ import inspect
97
+ import io
98
+ import json
99
+ import os
100
+ import shutil
101
+ import subprocess
102
+ import sys
103
+ import tempfile
104
+ import textwrap
105
+ from contextlib import redirect_stderr
106
+
107
+ try:
108
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
109
+ except AttributeError:
110
+ pass
111
+
112
+ from . import fsutil as F # noqa: E402
113
+
114
+ PASS, FAIL = 0, 0
115
+ FAILS = []
116
+ _CURRENT = ["?"]
117
+ _GROUP_FAILS = {}
118
+ _TMP_ROOTS = []
119
+ _LIVE = []
120
+
121
+ # 六要素正文(写入闸要求的 text 形态;D/E 组的写入用它)
122
+ BODY = ("# 功能名:B4 守卫合成节点\n# 生效条件:守卫运行期间\n# 子功能:占位\n"
123
+ "# 执行:占位\n# 验证方式:test\n# 不适用条件:非守卫运行")
124
+
125
+
126
+ # 生效条件:把 PASS/FAIL/失败名单/分组失败数全部清零并解除当前组名(每次完整跑套件前调用;--branch-baseline 每个变异轮都要一次干净基线)。
127
+ def _reset_counters():
128
+ global PASS, FAIL
129
+ PASS = FAIL = 0
130
+ del FAILS[:]
131
+ _GROUP_FAILS.clear()
132
+ _CURRENT[0] = "?"
133
+
134
+
135
+ # 生效条件:group 为非空字符串时设为当前组名并在 _GROUP_FAILS 里开出该组条目(未开则记 0);重复调用同名组只是切换当前组,不清零已有计数。
136
+ def begin(group: str):
137
+ _CURRENT[0] = group
138
+ _GROUP_FAILS.setdefault(group, 0)
139
+
140
+
141
+ # 生效条件:cond 为真记一条通过并打印;为假把 FAIL 与当前组失败数各 +1、把 name 追加进 FAILS 并打印 detail(detail 为空则只打印名字)。
142
+ def check(name, cond, detail=""):
143
+ global PASS, FAIL
144
+ if cond:
145
+ PASS += 1
146
+ print(" [ok] %s" % name)
147
+ return True
148
+ FAIL += 1
149
+ _GROUP_FAILS[_CURRENT[0]] = _GROUP_FAILS.get(_CURRENT[0], 0) + 1
150
+ FAILS.append(name)
151
+ print(" [FAIL] %s %s" % (name, detail))
152
+ return False
153
+
154
+
155
+ # 生效条件:fn 为无参回调时调用它取条件值——回调抛异常即判红并把异常类型与消息写进 detail(**不中断整组**,保证「变异下红项数 == 该组断言数」这一精确口径成立);fn 正常返回则按返回值真假记账;detail 传 callable 时在同一保护下求值。
156
+ def check_fn(name, fn, detail=""):
157
+ if callable(detail):
158
+ try:
159
+ detail = detail()
160
+ except Exception as exc: # noqa: BLE001
161
+ detail = "detail 求值抛 %s: %s" % (type(exc).__name__, exc)
162
+ try:
163
+ cond = bool(fn())
164
+ extra = detail
165
+ except Exception as exc: # noqa: BLE001 —— 红态正是抛异常
166
+ cond = False
167
+ extra = "回调抛 %s: %s(%s)" % (type(exc).__name__, exc, detail)
168
+ return check(name, cond, extra)
169
+
170
+
171
+ # 生效条件:新建系统临时目录(prefix 前缀)并把路径登记进 _TMP_ROOTS,供本次运行收尾统一 rmtree;返回该路径。
172
+ def _tmpdir(prefix: str) -> str:
173
+ p = tempfile.mkdtemp(prefix=prefix)
174
+ _TMP_ROOTS.append(p)
175
+ return p
176
+
177
+
178
+ # 生效条件:无入参,对 _TMP_ROOTS 里每个目录 rmtree(ignore_errors=True) 并清空清单、对 _LIVE 里每个认知图实例尝试 close()(异常吞掉,收尾不该再抛);收尾是幂等的。
179
+ def _cleanup():
180
+ for cg in _LIVE:
181
+ try:
182
+ cg.close()
183
+ except Exception: # noqa: BLE001 —— 收尾路径不再抛
184
+ pass
185
+ del _LIVE[:]
186
+ for p in _TMP_ROOTS:
187
+ shutil.rmtree(p, ignore_errors=True)
188
+ del _TMP_ROOTS[:]
189
+
190
+
191
+ # ---------------- A/B/C 组 fixture(只碰 fsutil,不依赖 mdcg) ----------------
192
+
193
+ # 生效条件:无入参时在临时目录建一个分片实例写入 a0、close(生产写点每批写完即 close 句柄)→ 记录分片名 → 重置记账 → rmtree 分片目录 → 以 redirect_stderr 捕获告警后追加 a1、close、追加 a2、close;返回上下文 dict(d / base / stats / stderr / err / ids / files / dir_after)。
194
+ def _case_heal() -> dict:
195
+ tmp = _tmpdir("mdcg_b4_heal_")
196
+ d = os.path.join(tmp, "_index_log")
197
+ ctx = {"d": d, "base": None, "stats": None, "stderr": "", "err": None,
198
+ "ids": None, "files": None, "dir_after": None, "err0": None}
199
+ lg = None
200
+ try:
201
+ lg = F.ShardedLog(d)
202
+ lg.append({"id": "a0"})
203
+ lg.close()
204
+ ctx["base"] = os.path.basename(lg.path)
205
+ F.reset_shard_dir_stats()
206
+ shutil.rmtree(d)
207
+ buf = io.StringIO()
208
+ try:
209
+ with redirect_stderr(buf):
210
+ lg.append({"id": "a1"})
211
+ lg.close()
212
+ lg.append({"id": "a2"})
213
+ lg.close()
214
+ except Exception as exc: # noqa: BLE001 —— 修前此处即红
215
+ ctx["err"] = exc
216
+ ctx["stderr"] = buf.getvalue()
217
+ ctx["stats"] = F.shard_dir_stats()
218
+ ctx["dir_after"] = os.path.isdir(d)
219
+ ctx["files"] = sorted(os.listdir(d)) if os.path.isdir(d) else None
220
+ ctx["ids"] = [r.get("id") for r in F.ShardedLog.read_all(d)]
221
+ except Exception as exc: # noqa: BLE001
222
+ ctx["err0"] = exc
223
+ return ctx
224
+
225
+
226
+ # 生效条件:无入参时跑两段「重建必失败」场景——① 用**文件占住**分片目录路径后构造 ShardedLog(构造面):isdir 为假、makedirs 必抛 FileExistsError;② 先正常构造再 rmdir 目录、用文件占住同路径后 append(打开面):同一条单点判据、同一结构化错误;返回上下文 dict(d / err / stats / stderr / d2 / err_append / stats2 / stderr2 / err0)。
227
+ def _case_fail() -> dict:
228
+ tmp = _tmpdir("mdcg_b4_fail_")
229
+ d = os.path.join(tmp, "_index_log")
230
+ ctx = {"d": d, "err": None, "stats": None, "stderr": "", "d2": None,
231
+ "err_append": None, "stats2": None, "stderr2": "", "err0": None}
232
+ try:
233
+ with open(d, "w", encoding="utf-8") as fh:
234
+ fh.write("squat") # 有文件占着该路径 → 重建必失败
235
+ F.reset_shard_dir_stats()
236
+ buf = io.StringIO()
237
+ try:
238
+ with redirect_stderr(buf):
239
+ F.ShardedLog(d) # 构造面(where="init")
240
+ except Exception as exc: # noqa: BLE001 —— 期望结构化错误
241
+ ctx["err"] = exc
242
+ ctx["stderr"] = buf.getvalue()
243
+ ctx["stats"] = F.shard_dir_stats()
244
+
245
+ d2 = os.path.join(tmp, "_index_log_append")
246
+ ctx["d2"] = d2
247
+ lg = F.ShardedLog(d2) # 先正常建好
248
+ os.rmdir(d2) # 再抽掉目录
249
+ with open(d2, "w", encoding="utf-8") as fh:
250
+ fh.write("squat")
251
+ F.reset_shard_dir_stats()
252
+ buf2 = io.StringIO()
253
+ try:
254
+ with redirect_stderr(buf2):
255
+ lg.append({"id": "c1"}) # 打开面(where="append")
256
+ except Exception as exc: # noqa: BLE001
257
+ ctx["err_append"] = exc
258
+ ctx["stderr2"] = buf2.getvalue()
259
+ ctx["stats2"] = F.shard_dir_stats()
260
+ except Exception as exc: # noqa: BLE001
261
+ ctx["err0"] = exc
262
+ return ctx
263
+
264
+
265
+ # ---------------- D 生产链 fixture(长驻 MdCG 实例) ----------------
266
+
267
+ # 生效条件:无入参时在临时根建 MdCG(root, autoflush=1) 长驻实例并写入 p0(此时分片目录已建成)→ 重置记账 → 以 redirect_stderr 捕获告警后 rmtree(_index_log) 并再写 p1/p2;返回上下文 dict(root / cg / log_dir / stats / stderr / nodes / ids / on_disk / err)。
268
+ def _case_prod() -> dict:
269
+ from .mdcg import MdCG
270
+ tmp = _tmpdir("mdcg_b4_prod_")
271
+ root = os.path.join(tmp, "cgroot")
272
+ ctx = {"root": root, "cg": None, "log_dir": None, "stats": None,
273
+ "stderr": "", "nodes": None, "ids": None, "on_disk": None,
274
+ "err": None}
275
+ try:
276
+ cg = MdCG(root, autoflush=1)
277
+ ctx["cg"] = cg
278
+ _LIVE.append(cg)
279
+ cg.add("b4_p0", BODY, layer="knowledge")
280
+ # issue #677 P2:写路径不再同步 flush ⇒ 分片目录由后台线程创建。
281
+ # 这里显式 flush() 拿到「目录已存在」的确定状态,再走「删目录 → 再写」的自愈面。
282
+ cg.flush()
283
+ log_dir = cg.index_log_dir
284
+ ctx["log_dir"] = log_dir
285
+ F.reset_shard_dir_stats()
286
+ buf = io.StringIO()
287
+ with redirect_stderr(buf):
288
+ shutil.rmtree(log_dir)
289
+ cg.add("b4_p1", BODY, layer="knowledge")
290
+ cg.add("b4_p2", BODY, layer="knowledge")
291
+ # issue #677 P2:索引落盘已异步化(写路径只保证内存索引 + 节点文件),
292
+ # 「append 期自愈 + 记账 + 告警」发生在 flush 里。这里显式 flush() 把那次
293
+ # 落盘拉回本线程与本 stderr 重定向块内——断言意图不变(自愈不抛、记账、
294
+ # 告警),只是不再依赖「add 内同步 flush」这个已改变的实现细节。
295
+ cg.flush()
296
+ ctx["stderr"] = buf.getvalue()
297
+ ctx["stats"] = F.shard_dir_stats()
298
+ ctx["nodes"] = sorted(cg.index["nodes"])
299
+ ctx["ids"] = [r.get("id") for r in F.ShardedLog.read_all(log_dir)]
300
+ e = cg.index["nodes"].get("b4_p2") or {}
301
+ ctx["on_disk"] = os.path.exists(os.path.join(root, e.get("path") or ""))
302
+ except Exception as exc: # noqa: BLE001
303
+ ctx["err"] = exc
304
+ return ctx
305
+
306
+
307
+ # ---------------- E stdio 端到端 fixture(MCP 出口) ----------------
308
+
309
+ # 模拟宿主前先把「身份/路径/编码」注入面清干净——子进程只吃临时目录(与 N225/N206 同款)
310
+ _DIRTY_KEYS = (
311
+ "MDCG_TOKEN", "MDCG_TOKEN_FILE", "MDCG_MASTER_KEY", "MDCG_CLEARANCE",
312
+ "MDCG_TENANT", "MDCG_TENANT_REGISTRY",
313
+ "MDCG_CAN_ADMIN", "MDCG_CAN_WRITE", "MDCG_LEGACY_ENV_AUTH",
314
+ "MDCG_LEGACY_ENV_ADMIN", "MDCG_SESSION", "DSH_SESSION_ID",
315
+ "MDCG_HARNESS", "MDCG_UNIT", "MDCG_ROOT", "MDCG_STATE_ROOT",
316
+ "MDCG_DATA_ROOT", "MDCG_AUX_ROOT", "MDCG_SUSTAIN", "MDCG_SUSTAIN_NAME",
317
+ "MDCG_MCP_SURFACE", "MDCG_TOOL_FACE", "MDCG_ACTOR",
318
+ "MDCG_VERIFIER_MODULES", "MDCG_HIVE_JOBS",
319
+ "PYTHONUTF8", "PYTHONIOENCODING", "PYTHONLEGACYWINDOWSSTDIO",
320
+ )
321
+
322
+
323
+ # 生效条件:tmp 为本次隔离根时,返回剔净 _DIRTY_KEYS 后的 os.environ 副本再注入指向 tmp 的覆盖键(MDCG_ROOT / MDCG_TENANT_REGISTRY / MDCG_STATE_ROOT / MDCG_DATA_ROOT / MDCG_AUX_ROOT / MDCG_TOKEN_FILE / MDCG_MASTER_KEY / MDCG_SUSTAIN / MDCG_LEGACY_ENV_AUTH / MDCG_ACTOR)——子进程绝不读真实 ~/.mdcg、真实令牌库与真实密钥面。
324
+ def _env(tmp: str) -> dict:
325
+ env = {k: v for k, v in os.environ.items() if k not in _DIRTY_KEYS}
326
+ env["MDCG_ROOT"] = os.path.join(tmp, "cgroot")
327
+ env["MDCG_TENANT_REGISTRY"] = os.path.join(tmp, "_tenants_absent.json")
328
+ env["MDCG_STATE_ROOT"] = os.path.join(tmp, "state")
329
+ env["MDCG_DATA_ROOT"] = os.path.join(tmp, "data")
330
+ env["MDCG_AUX_ROOT"] = os.path.join(tmp, "auxroot") # 不可取名 "aux"(设备名)
331
+ env["MDCG_TOKEN_FILE"] = os.path.join(tmp, "tokens.json")
332
+ env["MDCG_MASTER_KEY"] = "00" * 32 # 哑主密钥
333
+ env["MDCG_SUSTAIN"] = "0" # 关常驻循环
334
+ env["MDCG_LEGACY_ENV_AUTH"] = "1" # 既有豁免面:零令牌
335
+ env["MDCG_ACTOR"] = "b4-guard"
336
+ return env
337
+
338
+
339
+ # 当前生效的变异(仅 --branch-baseline/--drop-fix 期间非 None):内存 patch 不跨
340
+ # 进程,E 组走独立子进程 ⇒ 靠 sitecustomize 把同一处定点变异注入子进程,端到端
341
+ # 面才有真正的判别力。注入以 stderr 标记自证,标记缺失即 E 组判红(fail-closed)。
342
+ _MUTATION = [None]
343
+
344
+ _SITECUSTOMIZE_SRC = '''# B4 守卫跨进程变异注入(临时件,随 tmp 目录一并回收)
345
+ import os
346
+ import sys
347
+ import textwrap
348
+ import inspect
349
+ _repo = os.environ.get("B4_REPO") or ""
350
+ if _repo and _repo not in sys.path:
351
+ sys.path.insert(0, _repo)
352
+ try:
353
+ from md_cg import fsutil as _F
354
+ _which = os.environ["B4_MUT_WHICH"]
355
+ _fname = os.environ["B4_MUT_FUNC"]
356
+ _old = os.environ["B4_MUT_OLD"]
357
+ _new = os.environ["B4_MUT_NEW"]
358
+ if _which == "fsutil":
359
+ _holder, _raw = _F.ShardedLog, _F.ShardedLog.__dict__[_fname]
360
+ else: # fsutil_mod:模块级函数
361
+ _holder, _raw = _F, _F.__dict__[_fname]
362
+ _src = inspect.getsource(getattr(_raw, "__func__", _raw))
363
+ _src = textwrap.dedent(_src[_src.index("def %s(" % _fname):])
364
+ # 真全局(vars(_F) 副本会让被测函数的 `global X; X += 1` 写进临时 dict,
365
+ # 父进程断言读到的恒为 0 ⇒ 那是 patch 机制的假红,不是判据红)。
366
+ _ns = _F.__dict__
367
+ exec(compile(_src.replace(_old, _new), "b4_mut.py", "exec"), _ns)
368
+ if _which == "fsutil":
369
+ setattr(_holder, _fname, staticmethod(_ns[_fname]))
370
+ else:
371
+ setattr(_holder, _fname, _ns[_fname])
372
+ sys.stderr.write("[b4-mut] injected %s.%s\\n" % (_which, _fname))
373
+ except Exception as _e:
374
+ sys.stderr.write("[b4-mut] inject FAILED: %r\\n" % (_e,))
375
+ '''
376
+
377
+
378
+ # 生效条件:lines 为待喂给 stdin 的字符串序列、tmp 为隔离根时,spawn `python -X utf8 -m md_cg.mcp_server`(cwd=包根、env=_env(tmp);变异轮另经 sitecustomize 注入)一次喂完并 communicate;超时则 kill 后取残余输出;随后删掉**本子进程自己**的自报戳;返回 (returncode, stdout, stderr)。
379
+ def _talk(lines, tmp: str, timeout: int = 180):
380
+ env = _env(tmp)
381
+ mut = _MUTATION[0]
382
+ if mut is not None:
383
+ sc_dir = os.path.join(tmp, "_mutpath")
384
+ os.makedirs(sc_dir, exist_ok=True)
385
+ with open(os.path.join(sc_dir, "sitecustomize.py"), "w",
386
+ encoding="utf-8") as f:
387
+ f.write(_SITECUSTOMIZE_SRC)
388
+ env["PYTHONPATH"] = sc_dir + os.pathsep + env.get("PYTHONPATH", "")
389
+ env["B4_REPO"] = os.path.dirname(os.path.dirname(
390
+ os.path.abspath(__file__)))
391
+ env["B4_MUT_WHICH"] = mut["which"]
392
+ env["B4_MUT_FUNC"] = mut["func"]
393
+ env["B4_MUT_OLD"] = mut["old"]
394
+ env["B4_MUT_NEW"] = mut["new"]
395
+ proc = subprocess.Popen(
396
+ [sys.executable, "-X", "utf8", "-m", "md_cg.mcp_server"],
397
+ cwd=os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
398
+ env=env, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
399
+ stderr=subprocess.PIPE, text=True, encoding="utf-8", errors="replace")
400
+ try:
401
+ out, err = proc.communicate("\n".join(lines) + "\n", timeout=timeout)
402
+ except subprocess.TimeoutExpired:
403
+ proc.kill()
404
+ out, err = proc.communicate()
405
+ try:
406
+ os.remove(os.path.join(tempfile.gettempdir(), "md_cg_servers",
407
+ "%d.json" % proc.pid))
408
+ except OSError:
409
+ pass
410
+ return proc.returncode, out or "", err or ""
411
+
412
+
413
+ # 生效条件:rid/method 给定、params 为 None 时省略该键,否则原样写入;返回一行紧凑 JSON-RPC 请求文本。
414
+ def _rpc(rid, method, params=None) -> str:
415
+ msg = {"jsonrpc": "2.0", "id": rid, "method": method}
416
+ if params is not None:
417
+ msg["params"] = params
418
+ return json.dumps(msg, ensure_ascii=False)
419
+
420
+
421
+ # 生效条件:out 为 stdout 文本时逐行 strip、空行跳过,返回 [(原始行, 解析结果或 None)](解析失败记 None)。
422
+ def _resp_lines(out: str):
423
+ got = []
424
+ for ln in out.splitlines():
425
+ ln = ln.strip()
426
+ if not ln:
427
+ continue
428
+ try:
429
+ got.append((ln, json.loads(ln)))
430
+ except ValueError:
431
+ got.append((ln, None))
432
+ return got
433
+
434
+
435
+ # 生效条件:无入参时在临时根用**文件占住** `_index_log` 路径(重建必失败)→ 起 stdio 主循环喂 [initialize, mdcg_remember(b4_e1), tools/list, shutdown];返回上下文 dict(tmp / rc / out / err / by_id / tool_text / tool_obj / inject_ok / error)。
436
+ def _case_stdio() -> dict:
437
+ tmp = _tmpdir("mdcg_b4_stdio_")
438
+ ctx = {"tmp": tmp, "rc": None, "out": "", "err": "", "by_id": {},
439
+ "tool_text": "", "tool_obj": None, "inject_ok": True,
440
+ "error": None}
441
+ try:
442
+ root = os.path.join(tmp, "cgroot")
443
+ os.makedirs(root, exist_ok=True)
444
+ with open(os.path.join(root, "_index_log"), "w",
445
+ encoding="utf-8") as fh:
446
+ fh.write("squat") # 目录路径被文件占住
447
+ # issue #677 P2 后 E 组的形态(**契约变更,如实登记**):写路径的索引落盘
448
+ # 已异步化,故「分片目录重建失败」不再从**写应答**里出来——写应答此刻
449
+ # 必然是 ok(节点文件已落盘、内存索引已同钩)。索引面的错误仍在 MCP 出口
450
+ # 结构化暴露,但出口搬到了**显式同步落盘**的 cg(op=maintain, action=flush):
451
+ # id=2 证「异步写不被索引面失败回退」,id=3 证「错误不裸抛 + 带 hint」。
452
+ # 两条合起来才是异步化后的完整契约,抽掉任一条都会假绿。
453
+ lines = [_rpc(1, "initialize"),
454
+ _rpc(2, "tools/call",
455
+ {"name": "mdcg_remember",
456
+ "arguments": {"node_id": "b4_e1", "content": BODY}}),
457
+ _rpc(3, "tools/call",
458
+ {"name": "cg",
459
+ "arguments": {"op": "maintain", "action": "flush"}}),
460
+ _rpc(4, "tools/list"), _rpc(5, "shutdown")]
461
+ ctx["rc"], ctx["out"], ctx["err"] = _talk(lines, tmp)
462
+ ctx["inject_ok"] = ("[b4-mut] injected" in ctx["err"]
463
+ if _MUTATION[0] is not None else True)
464
+ objs = [o for _raw, o in _resp_lines(ctx["out"])]
465
+ ctx["by_id"] = {o.get("id"): o for o in objs if isinstance(o, dict)}
466
+ def _payload(rid):
467
+ call = ctx["by_id"].get(rid) or {}
468
+ content = (call.get("result") or {}).get("content") or []
469
+ txt = content[0].get("text") if content else ""
470
+ try:
471
+ return txt, (json.loads(txt) if txt else None)
472
+ except ValueError: # 非 JSON 也照实记录
473
+ return txt, None
474
+
475
+ # 写应答(异步契约:索引面失败不得回退写入)
476
+ ctx["write_text"], ctx["write_obj"] = _payload(2)
477
+ # 显式同步落盘的出口(索引面错误必须在这里结构化暴露)
478
+ ctx["tool_text"], ctx["tool_obj"] = _payload(3)
479
+ except Exception as exc: # noqa: BLE001
480
+ ctx["error"] = exc
481
+ return ctx
482
+
483
+
484
+ # ---------------- A 自愈面 ----------------
485
+
486
+ # 生效条件:跑 A 组 6 条断言(append 不抛 / 目录被重建 / 删除后的记录真落进分片 / 记账可断言 / stderr 告警可观测 / 路径照常);ctx 由 _case_heal 产出,任一阶段抛异常时六条各自判红。
487
+ def g_a():
488
+ begin("A")
489
+ ctx = _case_heal()
490
+ check_fn("B4-A1·删目录后 append 不抛(修前为 FileNotFoundError)",
491
+ lambda c=ctx: c["err"] is None and c["err0"] is None,
492
+ "err=%r err0=%r" % (ctx["err"], ctx["err0"]))
493
+ check_fn("B4-A2·分片目录被重建(isdir 为真)",
494
+ lambda c=ctx: c["dir_after"] is True,
495
+ "dir_after=%r" % (ctx["dir_after"],))
496
+ check_fn("B4-A3·删除后的记录真落进分片(read_all 含 a1/a2)",
497
+ lambda c=ctx: c["ids"] == ["a1", "a2"],
498
+ "ids=%r" % (ctx["ids"],))
499
+ check_fn("B4-A4·记账可断言(1 次重建 + 样本 where=append)",
500
+ lambda c=ctx: c["stats"] is not None
501
+ and c["stats"][0] == 1 and c["stats"][2] == 0
502
+ and len(c["stats"][1]) == 1
503
+ and c["stats"][1][0][1] == "append",
504
+ "stats=%r" % (ctx["stats"],))
505
+ check_fn("B4-A5·不静默(stderr 含「缺失」与目录名)",
506
+ lambda c=ctx: "分片目录缺失" in c["stderr"]
507
+ and "_index_log" in c["stderr"],
508
+ "stderr=%r" % (ctx["stderr"][:200],))
509
+ check_fn("B4-A6·路径照常(分片名与删前同名,不换名)",
510
+ lambda c=ctx: c["files"] == [c["base"]],
511
+ "files=%r base=%r" % (ctx["files"], ctx["base"]))
512
+
513
+
514
+ # ---------------- B 边界与既有语义 ----------------
515
+
516
+ # 生效条件:跑 B 组 5 条断言(read_all 缺目录 → [] / read_all 路径是文件 → [] / 首建不记账 / 目录在位零记账零告警 / clear 缺目录不抛),全部就地构造最小场景、不依赖 mdcg。
517
+ def g_b():
518
+ begin("B")
519
+ tmp = _tmpdir("mdcg_b4_edge_")
520
+ missing = os.path.join(tmp, "_index_log_absent")
521
+ squat = os.path.join(tmp, "_index_log_squat")
522
+ with open(squat, "w", encoding="utf-8") as fh:
523
+ fh.write("squat")
524
+
525
+ got_missing, err_missing = None, None
526
+ try:
527
+ got_missing = F.ShardedLog.read_all(missing)
528
+ except Exception as exc: # noqa: BLE001
529
+ err_missing = exc
530
+ check_fn("B4-B1·read_all 缺目录 → [] 不抛(既有语义一字不改)",
531
+ lambda: err_missing is None and got_missing == [],
532
+ "got=%r err=%r" % (got_missing, err_missing))
533
+
534
+ got_squat, err_squat = None, None
535
+ try:
536
+ got_squat = F.ShardedLog.read_all(squat)
537
+ except Exception as exc: # noqa: BLE001
538
+ err_squat = exc
539
+ check_fn("B4-B2·read_all 路径是文件 → [] 不抛(非目录降级口径)",
540
+ lambda: err_squat is None and got_squat == [],
541
+ "got=%r err=%r" % (got_squat, err_squat))
542
+
543
+ fresh = os.path.join(tmp, "_index_log_fresh")
544
+ F.reset_shard_dir_stats()
545
+ st = None
546
+ buf = io.StringIO()
547
+ with redirect_stderr(buf):
548
+ lg = F.ShardedLog(fresh)
549
+ lg.append({"id": "b_fresh"})
550
+ lg.close()
551
+ st = F.shard_dir_stats()
552
+ check_fn("B4-B3·首建不记账(构造 + 首写:计数 0、stderr 干净)",
553
+ lambda: st == (0, (), 0, ()) and buf.getvalue() == "",
554
+ "stats=%r stderr=%r" % (st, buf.getvalue()[:120]))
555
+
556
+ F.reset_shard_dir_stats()
557
+ st2 = None
558
+ buf2 = io.StringIO()
559
+ with redirect_stderr(buf2):
560
+ lg2 = F.ShardedLog(fresh) # 目录已存在
561
+ lg2.append({"id": "b_exist"})
562
+ lg2.close()
563
+ st2 = F.shard_dir_stats()
564
+ check_fn("B4-B4·目录在位时零记账零告警(不产生噪声)",
565
+ lambda: st2 == (0, (), 0, ()) and buf2.getvalue() == ""
566
+ and os.path.isdir(fresh),
567
+ "stats=%r stderr=%r" % (st2, buf2.getvalue()[:120]))
568
+
569
+ err_clear = None
570
+ try:
571
+ F.ShardedLog.clear(os.path.join(tmp, "_index_log_absent2"))
572
+ except Exception as exc: # noqa: BLE001
573
+ err_clear = exc
574
+ check_fn("B4-B5·clear 缺目录 → 直接返回不抛(既有语义)",
575
+ lambda: err_clear is None, "err=%r" % (err_clear,))
576
+
577
+
578
+ # ---------------- C 重建失败的结构化 ----------------
579
+
580
+ # 生效条件:跑 C 组 9 条断言(构造面:抛 ShardDirError 而非裸 FileNotFoundError / 仍是 OSError 子类 / code 可机读 / message 首字段含 [code] / hint 非空且含目录与处置 / path 属性 / 失败也记账 / 失败也告警;打开面:append 走同一条单点判据、同一结构化错误与 where=append 样本);ctx 由 _case_fail 产出。
581
+ def g_c():
582
+ begin("C")
583
+ ctx = _case_fail()
584
+ e = ctx["err"]
585
+ check_fn("B4-C1·抛 ShardDirError(不是裸 FileNotFoundError)",
586
+ lambda: isinstance(e, F.ShardDirError),
587
+ "err=%r err0=%r" % (e, ctx["err0"]))
588
+ check_fn("B4-C2·仍是 OSError 子类(既有 except OSError 面语义不变)",
589
+ lambda: isinstance(e, OSError), "type=%s" % type(e).__name__)
590
+ check_fn("B4-C3·code 可机读(== E_SHARD_DIR_UNREBUILDABLE)",
591
+ lambda: getattr(e, "code", None) == F.SHARD_DIR_ERR_CODE,
592
+ "code=%r" % (getattr(e, "code", None),))
593
+ check_fn("B4-C4·message 首字段含 [code](MCP 出口 error 串里可机读)",
594
+ lambda: ("[%s]" % F.SHARD_DIR_ERR_CODE) in str(e),
595
+ "str=%r" % (str(e)[:160],))
596
+ check_fn("B4-C5·hint 非空且含目录与处置(重开进程即可恢复索引)",
597
+ lambda: bool(getattr(e, "hint", ""))
598
+ and ctx["d"] in e.hint and "重开进程" in e.hint,
599
+ "hint=%r" % (getattr(e, "hint", "")[:160],))
600
+ check_fn("B4-C6·path 属性 == 分片目录(可机读定位)",
601
+ lambda: getattr(e, "path", None) == ctx["d"],
602
+ "path=%r d=%r" % (getattr(e, "path", None), ctx["d"]))
603
+ check_fn("B4-C7·失败也记账(1 次失败 + 样本含 where 与异常类型名)",
604
+ lambda: ctx["stats"] is not None and ctx["stats"][2] == 1
605
+ and len(ctx["stats"][3]) == 1
606
+ and ctx["stats"][3][0][1] == "init"
607
+ and ctx["stats"][3][0][2] == "FileExistsError",
608
+ "stats=%r" % (ctx["stats"],))
609
+ check_fn("B4-C8·失败也告警(stderr 含「重建失败」与 code)",
610
+ lambda: "重建失败" in ctx["stderr"]
611
+ and F.SHARD_DIR_ERR_CODE in ctx["stderr"],
612
+ "stderr=%r" % (ctx["stderr"][:200],))
613
+ check_fn("B4-C9·打开面同口径:append 重建失败也抛结构化 + where=append 记账",
614
+ lambda c=ctx: isinstance(c["err_append"], F.ShardDirError)
615
+ and getattr(c["err_append"], "code", None) == F.SHARD_DIR_ERR_CODE
616
+ and c["stats2"][2] == 1 and c["stats2"][3][0][1] == "append",
617
+ "err=%r stats2=%r" % (ctx["err_append"], ctx["stats2"]))
618
+
619
+
620
+ # ---------------- D 生产链(长驻 MdCG 实例) ----------------
621
+
622
+ # 生效条件:跑 D 组 5 条断言(删 _index_log 后再 add 不抛 / 节点索引可见且盘面 .md 一致 / 分片日志可重放 / 生产链自愈也记账 / 生产链自愈也告警);ctx 由 _case_prod 产出,MdCG 不可用时五条各自判红。
623
+ def g_d():
624
+ begin("D")
625
+ ctx = _case_prod()
626
+ check_fn("B4-D1·生产链:删 _index_log 后再 add 不抛(修前为 FileNotFoundError)",
627
+ lambda c=ctx: c["err"] is None, "err=%r" % (ctx["err"],))
628
+ check_fn("B4-D2·删除后写入的节点索引可见且盘面 .md 存在(索引不落后于盘面)",
629
+ lambda c=ctx: c["nodes"] is not None
630
+ and {"b4_p0", "b4_p1", "b4_p2"} <= set(c["nodes"])
631
+ and c["on_disk"] is True,
632
+ "nodes=%r on_disk=%r" % (ctx["nodes"], ctx["on_disk"]))
633
+ check_fn("B4-D3·分片日志可重放(read_all 含删除后写入的 p1/p2)",
634
+ lambda c=ctx: c["ids"] is not None
635
+ and {"b4_p1", "b4_p2"} <= set(c["ids"]),
636
+ "ids=%r" % (ctx["ids"],))
637
+ check_fn("B4-D4·生产链自愈也记账(1 次重建 + 样本 where=append)",
638
+ lambda c=ctx: c["stats"] is not None and c["stats"][0] == 1
639
+ and c["stats"][2] == 0 and len(c["stats"][1]) == 1
640
+ and c["stats"][1][0][1] == "append",
641
+ "stats=%r" % (ctx["stats"],))
642
+ check_fn("B4-D5·生产链自愈也告警(stderr 含「缺失」与 _index_log)",
643
+ lambda c=ctx: "分片目录缺失" in c["stderr"]
644
+ and "_index_log" in c["stderr"],
645
+ "stderr=%r" % (ctx["stderr"][:200],))
646
+
647
+
648
+ # ---------------- E MCP 出口端到端 ----------------
649
+
650
+ # 生效条件:跑 E 组 4 条断言(出口 error 串含 code / 出口带可操作 hint / 错误之后进程仍应答且 rc=0 / 变异轮注入自证在场);ctx 由 _case_stdio 产出。
651
+ def g_e():
652
+ begin("E")
653
+ ctx = _case_stdio()
654
+ obj = ctx["tool_obj"]
655
+ check_fn("B4-E1·MCP 出口不裸抛:error 串含 E_SHARD_DIR_UNREBUILDABLE",
656
+ lambda c=ctx: isinstance(c["tool_obj"], dict)
657
+ and F.SHARD_DIR_ERR_CODE in (c["tool_obj"].get("error") or "")
658
+ and "ShardDirError" in (c["tool_obj"].get("error") or ""),
659
+ "tool_text=%r" % (ctx["tool_text"][:220],))
660
+ check_fn("B4-E2·MCP 出口带可操作 hint(含「重开进程」处置)",
661
+ lambda: isinstance(obj, dict)
662
+ and "重开进程" in (obj.get("hint") or ""),
663
+ "hint=%r" % ((obj or {}).get("hint") or "")[:160])
664
+ # issue #677 P2 契约:索引面失败(分片目录重建不了)**不得回退写入**——节点
665
+ # 文件已落盘、内存索引已同钩,写应答必须是 ok;副作用(索引派生物落后于
666
+ # 盘面)由 id=3 的显式 flush 出口如实报出,由 E1/E2 断言。这一条与 E1/E2
667
+ # 互为反向:只留「写报错」的老形态会让异步化退化成同步,只留「写成功」
668
+ # 会让失败静默——两态必须同时被钉住。
669
+ check_fn("B4-E3·异步写不被索引面失败回退(写应答 ok)且错误后进程仍应答"
670
+ "(tools/list 有 id=4 应答)且 rc=0",
671
+ lambda c=ctx: c["rc"] == 0 and 4 in c["by_id"]
672
+ and (c["write_obj"] or {}).get("ok") is True,
673
+ "rc=%r ids=%r write=%r stderr=%r"
674
+ % (ctx["rc"], sorted(ctx["by_id"]),
675
+ (ctx["write_obj"] or {}), ctx["err"][-200:]))
676
+ check_fn("B4-E4·变异轮注入自证在场(fail-closed:注入失效即判红)",
677
+ lambda c=ctx: c["inject_ok"] is True,
678
+ "inject_ok=%r stderr=%r" % (ctx["inject_ok"], ctx["err"][-200:]))
679
+
680
+
681
+ _GROUPS = (("A", g_a), ("B", g_b), ("C", g_c), ("D", g_d), ("E", g_e))
682
+
683
+
684
+ # 生效条件:重算计数器后依次跑 A–E 五组(静默与否由 print 决定),返回 (总失败数, {组名: 失败数} 的副本);供正常模式与 --branch-baseline 的变异核验共用。
685
+ def _run_groups():
686
+ _reset_counters()
687
+ for _name, fn in _GROUPS:
688
+ fn()
689
+ return FAIL, dict(_GROUP_FAILS)
690
+
691
+
692
+ # ---------------- 定点变异自证 ----------------
693
+
694
+ # 变异表:逐处关掉一个判据,守卫**必须转红**,且红项**恰好**落在该判据负责的
695
+ # 组、数量等于表内预期(多一项少一项都报红)。表内数字是**实跑读数**(不是
696
+ # 设计意图的估计),每条后面的「外溢面」注释说明该变异为什么牵连到别的组——
697
+ # 红项数不是越小越好,而是必须与真实因果一致。基线源=**工作区源码**
698
+ # (inspect.getsource 取自当前已加载模块),绝不绑 git HEAD。
699
+ _MUTATIONS = (
700
+ # ① 修复本体:append 首开前不复查目录(= 修前行为)。
701
+ # 外溢面(如实登记,不掩盖):
702
+ # · C9(append 面的结构化失败)——自愈调用被抽掉后 append 改由 open 抛裸
703
+ # NotADirectoryError;
704
+ # · D 全组 5 条——生产链 fixture 在第一次 add 就抛,后续读数(nodes /
705
+ # read_all / 记账 / 告警)连带落空(修前实测就是这样:一次抛即整链停)。
706
+ ("M1 抽掉修复本体(append 打开前不复查目录)",
707
+ "fsutil", "append",
708
+ 'ensure_shard_dir(self.dir, "append")', "pass",
709
+ {"A": 6, "C": 1, "D": 5}),
710
+ # ② 自愈静默:重建成功不记账(容忍 ≠ 静默的计数面)
711
+ ("M2 自愈不记账(计数不累加)",
712
+ "fsutil_mod", "note_shard_dir_rebuild",
713
+ "SHARD_DIR_REBUILDS += 1", "pass",
714
+ {"A": 1, "D": 1}),
715
+ # ③ 自愈静默:重建成功不告警(stderr 面)
716
+ ("M3 自愈不告警(stderr 静默)",
717
+ "fsutil_mod", "note_shard_dir_rebuild",
718
+ " sys.stderr.write(", " (lambda *a: None)(",
719
+ {"A": 1, "D": 1}),
720
+ # ④ 重建失败不记账不告警(痕迹只剩异常,被兜底吞掉即失明)。
721
+ # 外溢面:C9 同轮转红(打开面复用同一记账函数)。
722
+ ("M4 重建失败不记账不告警",
723
+ "fsutil_mod", "ensure_shard_dir",
724
+ "note_shard_dir_heal_failure(directory, where, exc)", "pass",
725
+ {"C": 3}),
726
+ # ⑤ 重建失败降级为裸 FileNotFoundError(③ 的反面:冒到出口)。
727
+ # 外溢面:E1/E2(出口串里 code 与 hint 双失)——这正是本条要钉的死点。
728
+ ("M5 重建失败降级为裸 FileNotFoundError",
729
+ "fsutil_mod", "ensure_shard_dir",
730
+ "note_shard_dir_heal_failure(directory, where, exc)",
731
+ "raise FileNotFoundError(directory)",
732
+ {"C": 8, "E": 2}),
733
+ # ⑥ 口径过宽:首建也记账(把正常路径当病态事件,淹没真事件)
734
+ ("M6 首建也记账(口径过宽)",
735
+ "fsutil_mod", "note_shard_dir_rebuild",
736
+ ' if where == "init":\n return', ' if False:\n return',
737
+ {"B": 1}),
738
+ # ⑦ 改掉 read_all「非目录 → []」语义(要求④ 的反面)。
739
+ # 外溢面:D 全组 + E 全组——read_all 抛异常会打断 MdCG 装载链
740
+ # (`_load_index` 在盘面无快照时经它重放),常驻服务连启动都过不去;
741
+ # 这正是要求④「不许改 read_all 既有语义」的**因果理由**,不是偶然牵连。
742
+ ("M7 read_all 非目录不再返回空列表",
743
+ "fsutil", "read_all", " return []", " pass",
744
+ {"B": 2, "D": 5, "E": 3}),
745
+ )
746
+
747
+
748
+ # 生效条件:which 为 "fsutil" 时从 ShardedLog 类、为 "fsutil_mod" 时从 fsutil 模块取 func_name 的源码文本;**从 `def <name>(` 行起截断再 dedent**(inspect.getsource 对本仓「顶格 `# 生效条件:` 注释 + 类内缩进 def」的排版会把注释一并带来,直接 dedent 会留下缩进 ⇒ IndentationError);函数缺失或无法取源时返回 None。
749
+ def _func_src(which: str, func_name: str):
750
+ try:
751
+ if which == "fsutil":
752
+ raw = F.ShardedLog.__dict__[func_name]
753
+ else:
754
+ raw = F.__dict__[func_name]
755
+ fn = getattr(raw, "__func__", raw)
756
+ src = inspect.getsource(fn)
757
+ return textwrap.dedent(src[src.index("def %s(" % func_name):])
758
+ except Exception: # noqa: BLE001 —— 取源失败按锚点漂移处理
759
+ return None
760
+
761
+
762
+ # 生效条件:which 为 "fsutil"/"fsutil_mod"、old 在 func_name 源码中时,把替换后的源码 exec 进 **fsutil 模块的真实命名空间**(`vars(F)` 而非副本——被测函数里的 `global X; X += 1` 必须落到模块真全局,副本会让计数写在临时 dict 里、守卫读到的恒为 0,那是 patch 机制的假红)并挂回目标(类属性或模块级名字;原为 staticmethod 者仍包 staticmethod),返回还原回调;old 不在源码中返回 None(调用方按 ANCHOR-MISS 处置,退出码 2)。
763
+ def _patch(which: str, func_name: str, old: str, new: str):
764
+ src = _func_src(which, func_name) # 取源必须在 exec 之前(exec 后原件被覆盖)
765
+ if src is None or old not in src:
766
+ return None
767
+ holder = F.ShardedLog if which == "fsutil" else F
768
+ orig = holder.__dict__[func_name] # ← 先存原件:exec 会就地覆盖目标名字
769
+ ns = F.__dict__ # 真全局:global 语句必须落在被测模块命名空间
770
+ exec(compile(src.replace(old, new), "b4_mut.py", "exec"), ns)
771
+ if isinstance(orig, staticmethod):
772
+ setattr(holder, func_name, staticmethod(ns[func_name]))
773
+ else:
774
+ setattr(holder, func_name, ns[func_name])
775
+
776
+ def _restore():
777
+ setattr(holder, func_name, orig)
778
+ if holder is not F and ns.get(func_name) is not orig:
779
+ ns.pop(func_name, None) # 类方法变异在模块面留下的同名残件
780
+
781
+ return _restore
782
+
783
+
784
+ # 生效条件:无入参时跑定点变异自证——先跑未变异基线(必须零失败),再逐个应用 _MUTATIONS:锚点缺失立即打印 ANCHOR-MISS 并返回 2(fail-closed,不再继续);变异后**逐一打印转红的断言名**与红项数,红项组与数量必须与预期完全一致,否则计入 bad;全部通过返回 0,存在不符返回 1。
785
+ def _branch_baseline() -> int:
786
+ print("!! 定点变异模式:逐处关掉判据,守卫应当转红且**恰好**命中预期组/项数\n")
787
+ with contextlib.redirect_stdout(io.StringIO()):
788
+ clean_fail, _clean_groups = _run_groups()
789
+ print(" 未变异基线:失败=%d" % clean_fail)
790
+ if clean_fail:
791
+ print(" 基线即失败 → 定点变异自证无意义(先修基线)")
792
+ return 1
793
+ bad = []
794
+ for label, which, fname, old, new, expect in _MUTATIONS:
795
+ restore = _patch(which, fname, old, new)
796
+ if restore is None:
797
+ print(" ANCHOR-MISS %s —— 变异锚点漂移(实现改了却没同步本表;"
798
+ "基线源=%s.%s)" % (label, which, fname))
799
+ return 2 # fail-closed:锚点漂移不静默失效
800
+ _MUTATION[0] = {"which": which, "func": fname, "old": old, "new": new}
801
+ try:
802
+ with contextlib.redirect_stdout(io.StringIO()):
803
+ got_fail, got_groups = _run_groups()
804
+ red_names = list(FAILS)
805
+ finally:
806
+ _MUTATION[0] = None
807
+ restore()
808
+ _cleanup() # 每轮清干净:临时根与活实例不跨轮累积
809
+ hit = {g: n for g, n in got_groups.items() if n}
810
+ print(" 关掉「%s」→ 红项=%d,命中组=%s" % (label, got_fail, hit))
811
+ for nm in red_names:
812
+ print(" [RED] %s" % nm)
813
+ if hit == expect and got_fail == sum(expect.values()):
814
+ print(" %s(与预期逐位一致)" % "OK")
815
+ else:
816
+ print(" MISMATCH 预期=%s/%d 实得=%s/%d"
817
+ % (expect, sum(expect.values()), hit, got_fail))
818
+ bad.append(label)
819
+ return 0 if not bad else 1
820
+
821
+
822
+ # 生效条件:无入参时只施加 M1(抽掉修复本体)——打印转红断言名与红项数、还原后重跑并打印绿项数(「红→恢复→绿」三态原地可见);锚点缺失返回 2,红项数与预期不符返回 1,两侧都符合返回 0。
823
+ def _drop_fix() -> int:
824
+ print("!! 抽掉修复本体:append 打开分片前不再复查目录(= 修前行为)\n")
825
+ label, which, fname, old, new, expect = _MUTATIONS[0]
826
+ print(" 变异:%s\n 锚点:%s.%s %r → %r\n" % (label, which, fname, old, new))
827
+ restore = _patch(which, fname, old, new)
828
+ if restore is None:
829
+ print(" ANCHOR-MISS —— 锚点漂移,fail-closed(退出码 2)")
830
+ return 2
831
+ _MUTATION[0] = {"which": which, "func": fname, "old": old, "new": new}
832
+ try:
833
+ with contextlib.redirect_stdout(io.StringIO()):
834
+ got_fail, got_groups = _run_groups()
835
+ red_names = list(FAILS)
836
+ finally:
837
+ _MUTATION[0] = None
838
+ restore()
839
+ _cleanup()
840
+ hit = {g: n for g, n in got_groups.items() if n}
841
+ print(" 抽掉修复后:红项=%d 项,命中组=%s" % (got_fail, hit))
842
+ for nm in red_names:
843
+ print(" [RED] %s" % nm)
844
+ with contextlib.redirect_stdout(io.StringIO()):
845
+ back_fail, back_groups = _run_groups()
846
+ back_hit = {g: n for g, n in back_groups.items() if n}
847
+ print("\n 恢复修复后:红项=%d 项,命中组=%s(全绿 ⇒ 红态确由该改动引起)"
848
+ % (back_fail, back_hit))
849
+ ok_red = hit == expect and got_fail == sum(expect.values())
850
+ ok_green = back_fail == 0
851
+ print(" 判定:红态%s ;恢复%s"
852
+ % ("符合预期(%s/%d)" % (expect, sum(expect.values())) if ok_red
853
+ else "**与预期不符**(预期 %s/%d)" % (expect, sum(expect.values())),
854
+ "转绿(0 失败)" if ok_green else "**仍未转绿(%d 失败)**"
855
+ % back_fail))
856
+ return 0 if (ok_red and ok_green) else 1
857
+
858
+
859
+ # 生效条件:命令行含 --branch-baseline 时走定点变异自证(退出码 0/1/2);含 --drop-fix 时只抽掉修复本体跑「红→恢复→绿」(退出码 0/1/2);否则依次跑 A–E 五组打印逐条结果与汇总,全部通过返回 0、存在失败返回 1。
860
+ def main() -> int:
861
+ try:
862
+ if "--branch-baseline" in sys.argv:
863
+ return _branch_baseline()
864
+ if "--drop-fix" in sys.argv:
865
+ return _drop_fix()
866
+ _reset_counters()
867
+ for _name, fn in _GROUPS:
868
+ fn()
869
+ finally:
870
+ _cleanup()
871
+ print("\n" + "=" * 64)
872
+ print("B4 分片目录自愈守卫:%d 通过,%d 失败" % (PASS, FAIL))
873
+ if FAILS:
874
+ for f in FAILS:
875
+ print(" - %s" % f)
876
+ return 0 if not FAILS else 1
877
+
878
+
879
+ if __name__ == "__main__":
880
+ sys.exit(main())