@furongjun1999/dsh-memory 0.9.14 → 0.9.15

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 (1276) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/LICENSE +21 -21
  3. package/README.md +125 -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 +24 -12
  14. package/lib/index.js +3 -44
  15. package/lib/lib/console_web.mjs +96 -0
  16. package/lib/tools.d.ts +2 -2
  17. package/md_cg/__init__.py +7 -7
  18. package/md_cg/auditview.py +248 -248
  19. package/md_cg/backfill.py +1328 -1328
  20. package/md_cg/backfill_bigdomain.py +34 -34
  21. package/md_cg/backfill_bucket_zh.py +35 -35
  22. package/md_cg/bench6_arms.py +414 -414
  23. package/md_cg/bench6_common.py +230 -230
  24. package/md_cg/bench6_competitors.py +212 -212
  25. package/md_cg/bench_axis_domain.py +257 -257
  26. package/md_cg/bench_blind_comp.py +308 -308
  27. package/md_cg/bench_e2e_judge.py +534 -534
  28. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  29. package/md_cg/bench_e2e_qa.py +256 -256
  30. package/md_cg/bench_en_atoms_public.py +230 -230
  31. package/md_cg/bench_governance.py +351 -351
  32. package/md_cg/bench_lme_zh.py +410 -410
  33. package/md_cg/bench_locomo.py +121 -121
  34. package/md_cg/bench_locomo_zh.py +460 -460
  35. package/md_cg/bench_locomo_zh_public.py +147 -147
  36. package/md_cg/bench_longmem.py +112 -112
  37. package/md_cg/bench_membench.py +632 -632
  38. package/md_cg/bench_p0.py +149 -149
  39. package/md_cg/bench_progressive.py +287 -287
  40. package/md_cg/bench_role_views.py +238 -238
  41. package/md_cg/bench_task_ab.py +243 -243
  42. package/md_cg/bench_task_ab_llm.py +408 -408
  43. package/md_cg/bench_unified_en.py +204 -204
  44. package/md_cg/bench_zh_mad.py +611 -611
  45. package/md_cg/blindspot_tickets.py +123 -123
  46. package/md_cg/census.py +133 -133
  47. package/md_cg/codeindex.py +531 -531
  48. package/md_cg/comment_gate.py +337 -337
  49. package/md_cg/cond_compose.py +190 -190
  50. package/md_cg/cond_facts.py +154 -154
  51. package/md_cg/cond_template.json +106 -106
  52. package/md_cg/condition_anchor.py +142 -142
  53. package/md_cg/config_registry_bulk.py +4 -0
  54. package/md_cg/corpus.py +110 -110
  55. package/md_cg/crosscheck.py +1098 -1098
  56. package/md_cg/d_meta.py +310 -310
  57. package/md_cg/docindex.py +496 -488
  58. package/md_cg/evolution.py +493 -493
  59. package/md_cg/freshness.py +21 -1
  60. package/md_cg/generation.py +409 -409
  61. package/md_cg/ghostref.py +130 -130
  62. package/md_cg/hotcache.py +5 -1
  63. package/md_cg/lexicon/RULES.md +32 -32
  64. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  65. package/md_cg/lexicon/build_standard_en.py +171 -171
  66. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  67. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  68. package/md_cg/lexicon/expand_en_zh.py +211 -211
  69. package/md_cg/lexicon/standard_en.json +1262 -1262
  70. package/md_cg/linkref.py +280 -280
  71. package/md_cg/mcp_server.py +9 -2
  72. package/md_cg/md_whitebox.py +345 -345
  73. package/md_cg/mdcg.py +196 -13
  74. package/md_cg/mdcos.py +124 -5
  75. package/md_cg/migrate.py +119 -119
  76. package/md_cg/migrate_aeis.py +221 -221
  77. package/md_cg/migrate_roleplay.py +293 -293
  78. package/md_cg/migrate_wisdom_graph.py +360 -360
  79. package/md_cg/mreview/__init__.py +25 -25
  80. package/md_cg/mreview/__main__.py +110 -110
  81. package/md_cg/mreview/bundle.py +178 -178
  82. package/md_cg/mreview/candidates.py +262 -262
  83. package/md_cg/mreview/govern.py +694 -694
  84. package/md_cg/mreview/locate.py +939 -939
  85. package/md_cg/mreview/pipeline.py +742 -742
  86. package/md_cg/mreview/rules/duplication.json +21 -21
  87. package/md_cg/mreview/rules/field_coverage.json +54 -54
  88. package/md_cg/mreview/rules/source_license.json +21 -21
  89. package/md_cg/mreview/rules/template_flow.json +21 -21
  90. package/md_cg/mreview/ruleset.py +252 -252
  91. package/md_cg/op_table.py +3 -2
  92. package/md_cg/progressive.py +123 -123
  93. package/md_cg/protect.py +29 -6
  94. package/md_cg/protocol/md_cg_gate.proto +33 -33
  95. package/md_cg/qmd_llm.py +334 -334
  96. package/md_cg/roleviews.py +89 -89
  97. package/md_cg/security.py +68 -5
  98. package/md_cg/selfreport.py +161 -161
  99. package/md_cg/semantic/REPRODUCE.md +170 -170
  100. package/md_cg/semantic/SCHEMA.md +33 -33
  101. package/md_cg/semantic/__init__.py +10 -10
  102. package/md_cg/semantic/atoms.json +7348 -7348
  103. package/md_cg/semantic/en_normalizer.py +364 -364
  104. package/md_cg/semantic/search_index.json +6199 -6199
  105. package/md_cg/session5.py +106 -106
  106. package/md_cg/srcindex.py +352 -352
  107. package/md_cg/statushdr.py +179 -179
  108. package/md_cg/tasks.py +26 -0
  109. package/md_cg/test_access_hints.py +147 -147
  110. package/md_cg/test_audit_rotate.py +270 -270
  111. package/md_cg/test_auditview.py +277 -277
  112. package/md_cg/test_autonomy.py +143 -143
  113. package/md_cg/test_autonomy_admission.py +1098 -1098
  114. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  115. package/md_cg/test_b1_foreign_read.py +244 -244
  116. package/md_cg/test_b1b2_write_face.py +424 -424
  117. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  118. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  119. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  120. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  121. package/md_cg/test_bench_governance.py +102 -102
  122. package/md_cg/test_blindspot_tickets.py +166 -166
  123. package/md_cg/test_boundary_hit.py +410 -410
  124. package/md_cg/test_branch_discard_tombstone.py +136 -136
  125. package/md_cg/test_ccg_perturb.py +184 -184
  126. package/md_cg/test_ccgc.py +458 -458
  127. package/md_cg/test_census_prune.py +81 -81
  128. package/md_cg/test_chain_read_isolate.py +168 -168
  129. package/md_cg/test_codeindex.py +338 -338
  130. package/md_cg/test_coldverify_drain.py +127 -127
  131. package/md_cg/test_comment_gate.py +187 -187
  132. package/md_cg/test_cond_compose_anchors.py +76 -76
  133. package/md_cg/test_cond_match.py +165 -165
  134. package/md_cg/test_condition_anchor.py +81 -81
  135. package/md_cg/test_config_registry.py +55 -55
  136. package/md_cg/test_cons200_scan_selection.py +793 -793
  137. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  138. package/md_cg/test_crypto_rotate.py +256 -256
  139. package/md_cg/test_csre_index_import_guard.py +161 -161
  140. package/md_cg/test_curiosity_budget.py +468 -468
  141. package/md_cg/test_d17_autostart_toolface.py +453 -453
  142. package/md_cg/test_d_meta.py +412 -412
  143. package/md_cg/test_datapath_root.py +199 -199
  144. package/md_cg/test_designer_token_coverage.py +184 -0
  145. package/md_cg/test_emit_negtail_cache.py +156 -156
  146. package/md_cg/test_export_default_collision.py +138 -138
  147. package/md_cg/test_gain_gate.py +223 -223
  148. package/md_cg/test_generation_guard.py +361 -361
  149. package/md_cg/test_ghostref.py +182 -182
  150. package/md_cg/test_goal_gen.py +355 -355
  151. package/md_cg/test_govern_directread.py +434 -434
  152. package/md_cg/test_health_scale.py +173 -173
  153. package/md_cg/test_heartbeat_ledger.py +563 -563
  154. package/md_cg/test_hive_ingest.py +285 -285
  155. package/md_cg/test_hot_cold.py +215 -215
  156. package/md_cg/test_hyperedge.py +245 -245
  157. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  158. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  159. package/md_cg/test_i50d_importance_source.py +531 -531
  160. package/md_cg/test_i50e_readside_protection.py +9 -3
  161. package/md_cg/test_identity_contract.py +329 -329
  162. package/md_cg/test_index_crossprocess_reload.py +316 -316
  163. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  164. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  165. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  166. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  167. package/md_cg/test_issue659_r26_batch3.py +38 -0
  168. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  169. package/md_cg/test_issue672_optional_assets.py +49 -0
  170. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  171. package/md_cg/test_issue677_async_index_flush.py +216 -0
  172. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  173. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  174. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  175. package/md_cg/test_issue69_audit_boundary.py +129 -129
  176. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  177. package/md_cg/test_issue78_export_concurrency.py +334 -334
  178. package/md_cg/test_issue80_residual_flush.py +169 -169
  179. package/md_cg/test_issue84_portability.py +95 -95
  180. package/md_cg/test_issue85_export_overwrite.py +113 -113
  181. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  182. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  183. package/md_cg/test_issue88_conclusion_face.py +280 -280
  184. package/md_cg/test_issue89_zero_score.py +169 -169
  185. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  186. package/md_cg/test_issue96_key_fallback.py +102 -102
  187. package/md_cg/test_issue98_tenant_root.py +104 -104
  188. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  189. package/md_cg/test_lifecycle.py +309 -309
  190. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  191. package/md_cg/test_linkref.py +320 -320
  192. package/md_cg/test_links_concurrent_write.py +188 -188
  193. package/md_cg/test_lock.py +52 -52
  194. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  195. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  196. package/md_cg/test_md_writepath.py +345 -345
  197. package/md_cg/test_merge_upsert.py +168 -168
  198. package/md_cg/test_mode_parity.py +23 -0
  199. package/md_cg/test_mr_m2.py +615 -599
  200. package/md_cg/test_mr_m3.py +710 -710
  201. package/md_cg/test_mr_m4.py +485 -485
  202. package/md_cg/test_n131_merge_gate.py +205 -205
  203. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  204. package/md_cg/test_n176_link_trust.py +221 -221
  205. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  206. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  207. package/md_cg/test_n195_writepath_reload.py +283 -283
  208. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  209. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  210. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  211. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  212. package/md_cg/test_n201_proposal_visibility.py +382 -382
  213. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  214. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  215. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  216. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  217. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  218. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  219. package/md_cg/test_n230_dirty_replay.py +18 -5
  220. package/md_cg/test_n238_body_text_parity.py +156 -156
  221. package/md_cg/test_n276_probe_hoist.py +199 -199
  222. package/md_cg/test_neg_condition_hits.py +333 -333
  223. package/md_cg/test_neg_coverage_budget.py +500 -500
  224. package/md_cg/test_none_id_write_guard.py +166 -166
  225. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  226. package/md_cg/test_p0.py +264 -264
  227. package/md_cg/test_p1.py +316 -316
  228. package/md_cg/test_p10_identity.py +173 -173
  229. package/md_cg/test_p11_consistency.py +382 -382
  230. package/md_cg/test_p12_metacognition.py +212 -212
  231. package/md_cg/test_p13_encryption.py +241 -241
  232. package/md_cg/test_p14_root_fallback.py +373 -373
  233. package/md_cg/test_p14_sustain.py +249 -249
  234. package/md_cg/test_p15_scrub.py +280 -280
  235. package/md_cg/test_p16_self_state.py +301 -301
  236. package/md_cg/test_p17_predict.py +354 -354
  237. package/md_cg/test_p18_whitebox.py +171 -171
  238. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  239. package/md_cg/test_p1x_ref_root.py +197 -197
  240. package/md_cg/test_p2.py +216 -216
  241. package/md_cg/test_p20_evolution.py +315 -315
  242. package/md_cg/test_p22_theory.py +175 -175
  243. package/md_cg/test_p23_links.py +311 -311
  244. package/md_cg/test_p25_weights.py +156 -156
  245. package/md_cg/test_p26_refindex.py +433 -433
  246. package/md_cg/test_p29_session_ingest_export.py +360 -360
  247. package/md_cg/test_p30_maintain.py +361 -361
  248. package/md_cg/test_p31_insight.py +535 -535
  249. package/md_cg/test_p34_crosscheck.py +331 -331
  250. package/md_cg/test_p35_conditioned_claim.py +252 -252
  251. package/md_cg/test_p36_kp_align.py +230 -230
  252. package/md_cg/test_p37_condition_space.py +248 -248
  253. package/md_cg/test_p38_contextualize.py +273 -273
  254. package/md_cg/test_p39_vision_evidence.py +369 -369
  255. package/md_cg/test_p41_evolve_patrol.py +224 -224
  256. package/md_cg/test_p42_provenance.py +269 -269
  257. package/md_cg/test_p44_md_whitebox.py +231 -231
  258. package/md_cg/test_p45_session_identity.py +466 -466
  259. package/md_cg/test_p46_unit_scope.py +272 -272
  260. package/md_cg/test_p4_fuzzy.py +223 -223
  261. package/md_cg/test_p5_semantic.py +226 -226
  262. package/md_cg/test_p6_consolidate.py +822 -822
  263. package/md_cg/test_p7_goals_recent.py +202 -202
  264. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  265. package/md_cg/test_p8_subgraph_chain.py +213 -213
  266. package/md_cg/test_p9_forget_protect.py +238 -238
  267. package/md_cg/test_preflight_failclosed.py +100 -100
  268. package/md_cg/test_progressive.py +146 -146
  269. package/md_cg/test_propose_tail_index.py +157 -157
  270. package/md_cg/test_protect_stats_parity.py +141 -0
  271. package/md_cg/test_protocol.py +272 -272
  272. package/md_cg/test_rank_parity_score_mode.py +522 -522
  273. package/md_cg/test_reach_keys.py +201 -201
  274. package/md_cg/test_read_clip.py +141 -141
  275. package/md_cg/test_read_face_input_gates.py +363 -363
  276. package/md_cg/test_read_face_semantics.py +492 -492
  277. package/md_cg/test_read_scope_b27.py +277 -277
  278. package/md_cg/test_readcache_default_on.py +168 -168
  279. package/md_cg/test_readcache_precise_inval.py +270 -270
  280. package/md_cg/test_recall_metadata.py +422 -422
  281. package/md_cg/test_reconcile_v0.py +294 -294
  282. package/md_cg/test_retr_s1.py +344 -344
  283. package/md_cg/test_retr_s1b.py +276 -276
  284. package/md_cg/test_retr_s3.py +194 -194
  285. package/md_cg/test_retr_s4.py +163 -163
  286. package/md_cg/test_retr_s6.py +157 -157
  287. package/md_cg/test_retr_s7.py +392 -392
  288. package/md_cg/test_retr_s8_time.py +369 -369
  289. package/md_cg/test_retr_s9_edges.py +286 -286
  290. package/md_cg/test_retr_score_once.py +220 -220
  291. package/md_cg/test_review_cli_attribution.py +181 -181
  292. package/md_cg/test_review_cli_visibility.py +235 -235
  293. package/md_cg/test_review_conformance.py +385 -385
  294. package/md_cg/test_review_dual_check.py +97 -0
  295. package/md_cg/test_review_onepass.py +170 -170
  296. package/md_cg/test_review_queue_batch.py +123 -123
  297. package/md_cg/test_review_queue_index.py +130 -130
  298. package/md_cg/test_role_views.py +354 -354
  299. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  300. package/md_cg/test_security_audit_v21.py +249 -249
  301. package/md_cg/test_sem_noise.py +242 -242
  302. package/md_cg/test_server_version.py +67 -67
  303. package/md_cg/test_session5_identity.py +93 -93
  304. package/md_cg/test_session_attribution_consistency.py +813 -813
  305. package/md_cg/test_session_identity_tristate.py +486 -486
  306. package/md_cg/test_session_isolation.py +168 -168
  307. package/md_cg/test_sleep.py +668 -668
  308. package/md_cg/test_sleep_gitlock.py +134 -134
  309. package/md_cg/test_snapshot_autoclose.py +187 -187
  310. package/md_cg/test_spatial_coords3d.py +292 -292
  311. package/md_cg/test_srcindex.py +171 -171
  312. package/md_cg/test_state_events.py +178 -178
  313. package/md_cg/test_state_slots.py +691 -691
  314. package/md_cg/test_subproc_encoding.py +192 -192
  315. package/md_cg/test_sustain_mutual.py +153 -153
  316. package/md_cg/test_tail_watermark_race.py +208 -208
  317. package/md_cg/test_tasks.py +409 -409
  318. package/md_cg/test_tenant_env_override_warn.py +152 -152
  319. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  320. package/md_cg/test_time_core_lint.py +9 -0
  321. package/md_cg/test_token_lowercase_form.py +315 -315
  322. package/md_cg/test_transfer.py +180 -180
  323. package/md_cg/test_trust.py +361 -361
  324. package/md_cg/test_twophase.py +286 -286
  325. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  326. package/md_cg/test_unify_default_off.py +701 -701
  327. package/md_cg/test_unify_scope.py +182 -182
  328. package/md_cg/test_units_poll.py +71 -71
  329. package/md_cg/test_v21r1_package_version.py +310 -310
  330. package/md_cg/test_validity_filter.py +280 -280
  331. package/md_cg/test_verify_answer.py +138 -138
  332. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  333. package/md_cg/test_w5_path_fingerprint.py +381 -381
  334. package/md_cg/test_wisdom_md_store.py +292 -292
  335. package/md_cg/test_writegate_tiers.py +111 -0
  336. package/md_cg/test_writelimit.py +224 -224
  337. package/md_cg/test_writepipe.py +4 -2
  338. package/md_cg/tokens.py +114 -8
  339. package/md_cg/units.py +869 -869
  340. package/md_cg/version_anchor.py +160 -160
  341. package/md_cg/vision_evidence.py +667 -667
  342. package/md_cg/whitebox_kb/__init__.py +37 -37
  343. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  344. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  345. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  346. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  347. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  348. package/md_cg/whitebox_kb/engine.py +310 -310
  349. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  350. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  351. 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
  352. 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
  353. 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
  354. 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
  355. 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
  356. 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
  357. 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
  358. 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
  359. 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
  360. 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
  361. 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
  362. 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
  363. 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
  364. 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
  365. 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
  366. 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
  367. 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
  368. 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
  369. 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
  370. 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
  371. 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
  372. 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
  373. 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
  374. 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
  375. 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
  376. 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
  377. 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
  378. 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
  379. 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
  380. 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
  381. 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
  382. 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
  383. 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
  384. 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
  385. 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
  386. 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
  387. 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
  388. 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
  389. 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
  390. 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
  391. 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
  392. 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
  393. 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
  394. 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
  395. 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
  396. 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
  397. 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
  398. 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
  399. 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
  400. 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
  401. 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
  402. 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
  403. 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
  404. 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
  405. 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
  406. 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
  407. 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
  408. 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
  409. 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
  410. 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
  411. 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
  412. 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
  413. 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
  414. 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
  415. 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
  416. 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
  417. 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
  418. 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
  419. 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
  420. 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
  421. 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
  422. 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
  423. 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
  424. 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
  425. 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
  426. 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
  427. 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
  428. 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
  429. 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
  430. 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
  431. 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
  432. 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
  433. 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
  434. 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
  435. 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
  436. 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
  437. 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
  438. 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
  439. 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
  440. 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
  441. 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
  442. 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
  443. 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
  444. 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
  445. 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
  446. 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
  447. 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
  448. 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
  449. 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
  450. 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
  451. 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
  452. 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
  453. 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
  454. 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
  455. 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
  456. 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
  457. 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
  458. 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
  459. 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
  460. 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
  461. 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
  462. 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
  463. 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
  464. 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
  465. 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
  466. 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
  467. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  468. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  469. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  470. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  471. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  472. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  473. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  474. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  475. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  476. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  477. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  478. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  479. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  480. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  481. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  482. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  483. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  484. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  485. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  486. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  487. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  488. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  489. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  490. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  491. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  492. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  493. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  494. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  495. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  496. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  497. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  498. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  499. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  500. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  501. 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
  502. 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
  503. 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
  504. 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
  505. 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
  506. 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
  507. 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
  508. 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
  509. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  510. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  511. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  512. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  513. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  514. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  515. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  516. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  517. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  518. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  519. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  520. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  521. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  522. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  523. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  524. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  525. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  526. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  527. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  528. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  529. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  530. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  531. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  532. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  533. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  534. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  535. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  536. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  537. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  538. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  539. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  540. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  541. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  542. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  543. package/md_cg/writegate.py +146 -0
  544. package/md_cg/writepipe.py +85 -7
  545. package/package.json +20 -6
  546. package/scripts/workspace_index.py +1 -0
  547. package/skills/README.md +121 -121
  548. package/skills/plugin.json +54 -54
  549. package/skills/skills/designer-perspective/SKILL.md +158 -158
  550. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  551. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  552. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  553. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  554. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  555. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  556. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  557. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  558. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  559. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  560. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  561. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  562. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  563. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  564. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  565. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  566. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  567. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  568. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  569. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  570. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  571. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  572. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  573. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  574. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  663. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  664. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  665. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  666. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  667. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  668. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  669. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  670. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  671. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  672. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  673. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  674. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  675. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  676. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  677. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  679. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  780. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  781. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  782. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  783. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  784. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  785. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  786. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  787. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  788. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  789. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  790. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  791. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  792. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  793. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  794. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  796. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  898. package/skills/skills/lingshu-net/SKILL.md +48 -48
  899. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  900. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  901. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  902. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  903. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  904. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  905. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  906. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  907. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  908. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  909. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  910. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  911. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  912. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  914. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1017. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1021. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1032. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1130. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1134. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1145. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1250. package/src/hooks.ts +21 -12
  1251. package/src/index.ts +3 -0
  1252. package/src/lib/console_web.mjs +96 -0
  1253. package/src/lib/python_path.ts +71 -71
  1254. package/src/lib/session_state.ts +127 -127
  1255. package/src/lib/whitebox_llm.ts +311 -311
  1256. package/ui/minimal/LICENSE +21 -0
  1257. package/ui/minimal/install.ps1 +168 -0
  1258. package/ui/minimal/integrity.json +41 -0
  1259. package/ui/minimal/payload/build-ui.mjs +16 -0
  1260. package/ui/minimal/payload/lib/client.js +18 -0
  1261. package/ui/minimal/payload/lib/lib/console_web.mjs +96 -0
  1262. package/ui/minimal/payload/src/lib/console_web.mjs +96 -0
  1263. package/ui/minimal/payload/web/app.js +154 -0
  1264. package/ui/minimal/payload/web/client.js +14 -0
  1265. package/ui/minimal/payload/web/entry.js +1 -0
  1266. package/ui/minimal/payload/web/index.html +3 -0
  1267. package/ui/minimal/payload/web/style.css +3 -0
  1268. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1269. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1270. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1271. package/utf8_boot.py +237 -237
  1272. package/web/app.js +154 -0
  1273. package/web/client.js +14 -0
  1274. package/web/entry.js +1 -0
  1275. package/web/index.html +3 -0
  1276. 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())