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