@furongjun1999/dsh-memory 0.9.14 → 0.9.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1276) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/LICENSE +21 -21
  3. package/README.md +125 -2
  4. package/codebuddy/mcp.json +27 -27
  5. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -45
  6. package/dsh/dsh-web-start.bat +17 -17
  7. package/dsh/hive-mcp-probe.mjs +94 -94
  8. package/dsh/update-lingshu.bat +11 -11
  9. package/dsh/update-lingshu.ps1 +337 -337
  10. package/hive/README.md +705 -705
  11. package/hive/id_charset_blocks.txt +147 -147
  12. package/lib/client.js +18 -0
  13. package/lib/hooks.js +24 -12
  14. package/lib/index.js +3 -44
  15. package/lib/lib/console_web.mjs +96 -0
  16. package/lib/tools.d.ts +2 -2
  17. package/md_cg/__init__.py +7 -7
  18. package/md_cg/auditview.py +248 -248
  19. package/md_cg/backfill.py +1328 -1328
  20. package/md_cg/backfill_bigdomain.py +34 -34
  21. package/md_cg/backfill_bucket_zh.py +35 -35
  22. package/md_cg/bench6_arms.py +414 -414
  23. package/md_cg/bench6_common.py +230 -230
  24. package/md_cg/bench6_competitors.py +212 -212
  25. package/md_cg/bench_axis_domain.py +257 -257
  26. package/md_cg/bench_blind_comp.py +308 -308
  27. package/md_cg/bench_e2e_judge.py +534 -534
  28. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  29. package/md_cg/bench_e2e_qa.py +256 -256
  30. package/md_cg/bench_en_atoms_public.py +230 -230
  31. package/md_cg/bench_governance.py +351 -351
  32. package/md_cg/bench_lme_zh.py +410 -410
  33. package/md_cg/bench_locomo.py +121 -121
  34. package/md_cg/bench_locomo_zh.py +460 -460
  35. package/md_cg/bench_locomo_zh_public.py +147 -147
  36. package/md_cg/bench_longmem.py +112 -112
  37. package/md_cg/bench_membench.py +632 -632
  38. package/md_cg/bench_p0.py +149 -149
  39. package/md_cg/bench_progressive.py +287 -287
  40. package/md_cg/bench_role_views.py +238 -238
  41. package/md_cg/bench_task_ab.py +243 -243
  42. package/md_cg/bench_task_ab_llm.py +408 -408
  43. package/md_cg/bench_unified_en.py +204 -204
  44. package/md_cg/bench_zh_mad.py +611 -611
  45. package/md_cg/blindspot_tickets.py +123 -123
  46. package/md_cg/census.py +133 -133
  47. package/md_cg/codeindex.py +531 -531
  48. package/md_cg/comment_gate.py +337 -337
  49. package/md_cg/cond_compose.py +190 -190
  50. package/md_cg/cond_facts.py +154 -154
  51. package/md_cg/cond_template.json +106 -106
  52. package/md_cg/condition_anchor.py +142 -142
  53. package/md_cg/config_registry_bulk.py +4 -0
  54. package/md_cg/corpus.py +110 -110
  55. package/md_cg/crosscheck.py +1098 -1098
  56. package/md_cg/d_meta.py +310 -310
  57. package/md_cg/docindex.py +496 -488
  58. package/md_cg/evolution.py +493 -493
  59. package/md_cg/freshness.py +21 -1
  60. package/md_cg/generation.py +409 -409
  61. package/md_cg/ghostref.py +130 -130
  62. package/md_cg/hotcache.py +5 -1
  63. package/md_cg/lexicon/RULES.md +32 -32
  64. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  65. package/md_cg/lexicon/build_standard_en.py +171 -171
  66. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  67. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  68. package/md_cg/lexicon/expand_en_zh.py +211 -211
  69. package/md_cg/lexicon/standard_en.json +1262 -1262
  70. package/md_cg/linkref.py +280 -280
  71. package/md_cg/mcp_server.py +9 -2
  72. package/md_cg/md_whitebox.py +345 -345
  73. package/md_cg/mdcg.py +196 -13
  74. package/md_cg/mdcos.py +124 -5
  75. package/md_cg/migrate.py +119 -119
  76. package/md_cg/migrate_aeis.py +221 -221
  77. package/md_cg/migrate_roleplay.py +293 -293
  78. package/md_cg/migrate_wisdom_graph.py +360 -360
  79. package/md_cg/mreview/__init__.py +25 -25
  80. package/md_cg/mreview/__main__.py +110 -110
  81. package/md_cg/mreview/bundle.py +178 -178
  82. package/md_cg/mreview/candidates.py +262 -262
  83. package/md_cg/mreview/govern.py +694 -694
  84. package/md_cg/mreview/locate.py +939 -939
  85. package/md_cg/mreview/pipeline.py +742 -742
  86. package/md_cg/mreview/rules/duplication.json +21 -21
  87. package/md_cg/mreview/rules/field_coverage.json +54 -54
  88. package/md_cg/mreview/rules/source_license.json +21 -21
  89. package/md_cg/mreview/rules/template_flow.json +21 -21
  90. package/md_cg/mreview/ruleset.py +252 -252
  91. package/md_cg/op_table.py +3 -2
  92. package/md_cg/progressive.py +123 -123
  93. package/md_cg/protect.py +29 -6
  94. package/md_cg/protocol/md_cg_gate.proto +33 -33
  95. package/md_cg/qmd_llm.py +334 -334
  96. package/md_cg/roleviews.py +89 -89
  97. package/md_cg/security.py +68 -5
  98. package/md_cg/selfreport.py +161 -161
  99. package/md_cg/semantic/REPRODUCE.md +170 -170
  100. package/md_cg/semantic/SCHEMA.md +33 -33
  101. package/md_cg/semantic/__init__.py +10 -10
  102. package/md_cg/semantic/atoms.json +7348 -7348
  103. package/md_cg/semantic/en_normalizer.py +364 -364
  104. package/md_cg/semantic/search_index.json +6199 -6199
  105. package/md_cg/session5.py +106 -106
  106. package/md_cg/srcindex.py +352 -352
  107. package/md_cg/statushdr.py +179 -179
  108. package/md_cg/tasks.py +26 -0
  109. package/md_cg/test_access_hints.py +147 -147
  110. package/md_cg/test_audit_rotate.py +270 -270
  111. package/md_cg/test_auditview.py +277 -277
  112. package/md_cg/test_autonomy.py +143 -143
  113. package/md_cg/test_autonomy_admission.py +1098 -1098
  114. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  115. package/md_cg/test_b1_foreign_read.py +244 -244
  116. package/md_cg/test_b1b2_write_face.py +424 -424
  117. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  118. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  119. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  120. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  121. package/md_cg/test_bench_governance.py +102 -102
  122. package/md_cg/test_blindspot_tickets.py +166 -166
  123. package/md_cg/test_boundary_hit.py +410 -410
  124. package/md_cg/test_branch_discard_tombstone.py +136 -136
  125. package/md_cg/test_ccg_perturb.py +184 -184
  126. package/md_cg/test_ccgc.py +458 -458
  127. package/md_cg/test_census_prune.py +81 -81
  128. package/md_cg/test_chain_read_isolate.py +168 -168
  129. package/md_cg/test_codeindex.py +338 -338
  130. package/md_cg/test_coldverify_drain.py +127 -127
  131. package/md_cg/test_comment_gate.py +187 -187
  132. package/md_cg/test_cond_compose_anchors.py +76 -76
  133. package/md_cg/test_cond_match.py +165 -165
  134. package/md_cg/test_condition_anchor.py +81 -81
  135. package/md_cg/test_config_registry.py +55 -55
  136. package/md_cg/test_cons200_scan_selection.py +793 -793
  137. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  138. package/md_cg/test_crypto_rotate.py +256 -256
  139. package/md_cg/test_csre_index_import_guard.py +161 -161
  140. package/md_cg/test_curiosity_budget.py +468 -468
  141. package/md_cg/test_d17_autostart_toolface.py +453 -453
  142. package/md_cg/test_d_meta.py +412 -412
  143. package/md_cg/test_datapath_root.py +199 -199
  144. package/md_cg/test_designer_token_coverage.py +184 -0
  145. package/md_cg/test_emit_negtail_cache.py +156 -156
  146. package/md_cg/test_export_default_collision.py +138 -138
  147. package/md_cg/test_gain_gate.py +223 -223
  148. package/md_cg/test_generation_guard.py +361 -361
  149. package/md_cg/test_ghostref.py +182 -182
  150. package/md_cg/test_goal_gen.py +355 -355
  151. package/md_cg/test_govern_directread.py +434 -434
  152. package/md_cg/test_health_scale.py +173 -173
  153. package/md_cg/test_heartbeat_ledger.py +563 -563
  154. package/md_cg/test_hive_ingest.py +285 -285
  155. package/md_cg/test_hot_cold.py +215 -215
  156. package/md_cg/test_hyperedge.py +245 -245
  157. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  158. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  159. package/md_cg/test_i50d_importance_source.py +531 -531
  160. package/md_cg/test_i50e_readside_protection.py +9 -3
  161. package/md_cg/test_identity_contract.py +329 -329
  162. package/md_cg/test_index_crossprocess_reload.py +316 -316
  163. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  164. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  165. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  166. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  167. package/md_cg/test_issue659_r26_batch3.py +38 -0
  168. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  169. package/md_cg/test_issue672_optional_assets.py +49 -0
  170. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  171. package/md_cg/test_issue677_async_index_flush.py +216 -0
  172. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  173. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  174. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  175. package/md_cg/test_issue69_audit_boundary.py +129 -129
  176. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  177. package/md_cg/test_issue78_export_concurrency.py +334 -334
  178. package/md_cg/test_issue80_residual_flush.py +169 -169
  179. package/md_cg/test_issue84_portability.py +95 -95
  180. package/md_cg/test_issue85_export_overwrite.py +113 -113
  181. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  182. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  183. package/md_cg/test_issue88_conclusion_face.py +280 -280
  184. package/md_cg/test_issue89_zero_score.py +169 -169
  185. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  186. package/md_cg/test_issue96_key_fallback.py +102 -102
  187. package/md_cg/test_issue98_tenant_root.py +104 -104
  188. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  189. package/md_cg/test_lifecycle.py +309 -309
  190. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  191. package/md_cg/test_linkref.py +320 -320
  192. package/md_cg/test_links_concurrent_write.py +188 -188
  193. package/md_cg/test_lock.py +52 -52
  194. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  195. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  196. package/md_cg/test_md_writepath.py +345 -345
  197. package/md_cg/test_merge_upsert.py +168 -168
  198. package/md_cg/test_mode_parity.py +23 -0
  199. package/md_cg/test_mr_m2.py +615 -599
  200. package/md_cg/test_mr_m3.py +710 -710
  201. package/md_cg/test_mr_m4.py +485 -485
  202. package/md_cg/test_n131_merge_gate.py +205 -205
  203. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  204. package/md_cg/test_n176_link_trust.py +221 -221
  205. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  206. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  207. package/md_cg/test_n195_writepath_reload.py +283 -283
  208. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  209. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  210. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  211. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  212. package/md_cg/test_n201_proposal_visibility.py +382 -382
  213. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  214. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  215. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  216. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  217. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  218. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  219. package/md_cg/test_n230_dirty_replay.py +18 -5
  220. package/md_cg/test_n238_body_text_parity.py +156 -156
  221. package/md_cg/test_n276_probe_hoist.py +199 -199
  222. package/md_cg/test_neg_condition_hits.py +333 -333
  223. package/md_cg/test_neg_coverage_budget.py +500 -500
  224. package/md_cg/test_none_id_write_guard.py +166 -166
  225. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  226. package/md_cg/test_p0.py +264 -264
  227. package/md_cg/test_p1.py +316 -316
  228. package/md_cg/test_p10_identity.py +173 -173
  229. package/md_cg/test_p11_consistency.py +382 -382
  230. package/md_cg/test_p12_metacognition.py +212 -212
  231. package/md_cg/test_p13_encryption.py +241 -241
  232. package/md_cg/test_p14_root_fallback.py +373 -373
  233. package/md_cg/test_p14_sustain.py +249 -249
  234. package/md_cg/test_p15_scrub.py +280 -280
  235. package/md_cg/test_p16_self_state.py +301 -301
  236. package/md_cg/test_p17_predict.py +354 -354
  237. package/md_cg/test_p18_whitebox.py +171 -171
  238. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  239. package/md_cg/test_p1x_ref_root.py +197 -197
  240. package/md_cg/test_p2.py +216 -216
  241. package/md_cg/test_p20_evolution.py +315 -315
  242. package/md_cg/test_p22_theory.py +175 -175
  243. package/md_cg/test_p23_links.py +311 -311
  244. package/md_cg/test_p25_weights.py +156 -156
  245. package/md_cg/test_p26_refindex.py +433 -433
  246. package/md_cg/test_p29_session_ingest_export.py +360 -360
  247. package/md_cg/test_p30_maintain.py +361 -361
  248. package/md_cg/test_p31_insight.py +535 -535
  249. package/md_cg/test_p34_crosscheck.py +331 -331
  250. package/md_cg/test_p35_conditioned_claim.py +252 -252
  251. package/md_cg/test_p36_kp_align.py +230 -230
  252. package/md_cg/test_p37_condition_space.py +248 -248
  253. package/md_cg/test_p38_contextualize.py +273 -273
  254. package/md_cg/test_p39_vision_evidence.py +369 -369
  255. package/md_cg/test_p41_evolve_patrol.py +224 -224
  256. package/md_cg/test_p42_provenance.py +269 -269
  257. package/md_cg/test_p44_md_whitebox.py +231 -231
  258. package/md_cg/test_p45_session_identity.py +466 -466
  259. package/md_cg/test_p46_unit_scope.py +272 -272
  260. package/md_cg/test_p4_fuzzy.py +223 -223
  261. package/md_cg/test_p5_semantic.py +226 -226
  262. package/md_cg/test_p6_consolidate.py +822 -822
  263. package/md_cg/test_p7_goals_recent.py +202 -202
  264. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  265. package/md_cg/test_p8_subgraph_chain.py +213 -213
  266. package/md_cg/test_p9_forget_protect.py +238 -238
  267. package/md_cg/test_preflight_failclosed.py +100 -100
  268. package/md_cg/test_progressive.py +146 -146
  269. package/md_cg/test_propose_tail_index.py +157 -157
  270. package/md_cg/test_protect_stats_parity.py +141 -0
  271. package/md_cg/test_protocol.py +272 -272
  272. package/md_cg/test_rank_parity_score_mode.py +522 -522
  273. package/md_cg/test_reach_keys.py +201 -201
  274. package/md_cg/test_read_clip.py +141 -141
  275. package/md_cg/test_read_face_input_gates.py +363 -363
  276. package/md_cg/test_read_face_semantics.py +492 -492
  277. package/md_cg/test_read_scope_b27.py +277 -277
  278. package/md_cg/test_readcache_default_on.py +168 -168
  279. package/md_cg/test_readcache_precise_inval.py +270 -270
  280. package/md_cg/test_recall_metadata.py +422 -422
  281. package/md_cg/test_reconcile_v0.py +294 -294
  282. package/md_cg/test_retr_s1.py +344 -344
  283. package/md_cg/test_retr_s1b.py +276 -276
  284. package/md_cg/test_retr_s3.py +194 -194
  285. package/md_cg/test_retr_s4.py +163 -163
  286. package/md_cg/test_retr_s6.py +157 -157
  287. package/md_cg/test_retr_s7.py +392 -392
  288. package/md_cg/test_retr_s8_time.py +369 -369
  289. package/md_cg/test_retr_s9_edges.py +286 -286
  290. package/md_cg/test_retr_score_once.py +220 -220
  291. package/md_cg/test_review_cli_attribution.py +181 -181
  292. package/md_cg/test_review_cli_visibility.py +235 -235
  293. package/md_cg/test_review_conformance.py +385 -385
  294. package/md_cg/test_review_dual_check.py +97 -0
  295. package/md_cg/test_review_onepass.py +170 -170
  296. package/md_cg/test_review_queue_batch.py +123 -123
  297. package/md_cg/test_review_queue_index.py +130 -130
  298. package/md_cg/test_role_views.py +354 -354
  299. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  300. package/md_cg/test_security_audit_v21.py +249 -249
  301. package/md_cg/test_sem_noise.py +242 -242
  302. package/md_cg/test_server_version.py +67 -67
  303. package/md_cg/test_session5_identity.py +93 -93
  304. package/md_cg/test_session_attribution_consistency.py +813 -813
  305. package/md_cg/test_session_identity_tristate.py +486 -486
  306. package/md_cg/test_session_isolation.py +168 -168
  307. package/md_cg/test_sleep.py +668 -668
  308. package/md_cg/test_sleep_gitlock.py +134 -134
  309. package/md_cg/test_snapshot_autoclose.py +187 -187
  310. package/md_cg/test_spatial_coords3d.py +292 -292
  311. package/md_cg/test_srcindex.py +171 -171
  312. package/md_cg/test_state_events.py +178 -178
  313. package/md_cg/test_state_slots.py +691 -691
  314. package/md_cg/test_subproc_encoding.py +192 -192
  315. package/md_cg/test_sustain_mutual.py +153 -153
  316. package/md_cg/test_tail_watermark_race.py +208 -208
  317. package/md_cg/test_tasks.py +409 -409
  318. package/md_cg/test_tenant_env_override_warn.py +152 -152
  319. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  320. package/md_cg/test_time_core_lint.py +9 -0
  321. package/md_cg/test_token_lowercase_form.py +315 -315
  322. package/md_cg/test_transfer.py +180 -180
  323. package/md_cg/test_trust.py +361 -361
  324. package/md_cg/test_twophase.py +286 -286
  325. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  326. package/md_cg/test_unify_default_off.py +701 -701
  327. package/md_cg/test_unify_scope.py +182 -182
  328. package/md_cg/test_units_poll.py +71 -71
  329. package/md_cg/test_v21r1_package_version.py +310 -310
  330. package/md_cg/test_validity_filter.py +280 -280
  331. package/md_cg/test_verify_answer.py +138 -138
  332. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  333. package/md_cg/test_w5_path_fingerprint.py +381 -381
  334. package/md_cg/test_wisdom_md_store.py +292 -292
  335. package/md_cg/test_writegate_tiers.py +111 -0
  336. package/md_cg/test_writelimit.py +224 -224
  337. package/md_cg/test_writepipe.py +4 -2
  338. package/md_cg/tokens.py +114 -8
  339. package/md_cg/units.py +869 -869
  340. package/md_cg/version_anchor.py +160 -160
  341. package/md_cg/vision_evidence.py +667 -667
  342. package/md_cg/whitebox_kb/__init__.py +37 -37
  343. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  344. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  345. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  346. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  347. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  348. package/md_cg/whitebox_kb/engine.py +310 -310
  349. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  350. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  351. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/345/217/244/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  352. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/347/216/260/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  353. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/345/267/245/346/231/272/350/203/275/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  354. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/347/261/273/350/247/202/345/257/237/350/200/205/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +161 -161
  355. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/274/232/350/256/241/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  356. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/277/241/346/201/257/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +90 -90
  357. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/345/255/220/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  358. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/346/236/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  359. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  360. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  361. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  362. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  363. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +317 -317
  364. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +261 -261
  365. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  366. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  367. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  368. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/212/250/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  369. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1194 -1194
  370. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/267/245/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  371. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  372. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/206/345/217/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +278 -278
  373. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/237/345/255/220/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  374. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/217/244/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  375. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/223/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  376. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/233/272/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  377. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/237/346/234/250/345/267/245/347/250/213/345/237/272/347/241/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  378. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/260/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +154 -154
  379. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/215/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  380. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/226/345/233/275/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  381. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  382. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/346/200/235/346/224/277/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  383. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +201 -201
  384. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  385. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  386. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +131 -131
  387. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/217/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  388. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/236/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  389. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +333 -333
  390. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1124 -1124
  391. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  392. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  393. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  394. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/210/266/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  395. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +362 -362
  396. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/202/345/234/272/350/220/245/351/224/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +81 -81
  397. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/270/345/276/256/345/210/206/346/226/271/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +153 -153
  398. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/345/210/206/345/207/240/344/275/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  399. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  400. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  401. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/277/203/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +119 -119
  402. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/203/205/346/204/237/346/203/205/347/273/252/344/273/277/347/234/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +186 -186
  403. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/212/275/350/261/241/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  404. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/213/223/346/211/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  405. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/223/215/344/275/234/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  406. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/224/277/346/262/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +234 -234
  407. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/200/274/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  408. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/227/347/224/265/350/267/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  409. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1166 -1166
  410. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +217 -217
  411. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/347/211/251/347/220/206/346/226/271/346/263/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  412. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/345/272/223/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  413. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/347/273/223/346/236/204/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  414. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/226/207/345/255/246/347/220/206/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  415. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/240/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +141 -141
  416. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/266/347/251/272/350/256/260/345/277/206/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +214 -214
  417. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/231/272/350/203/275/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  418. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/234/211/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  419. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/220/346/226/231/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  420. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/241/344/273/266/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  421. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/244/215/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  422. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/246/202/347/216/207/350/256/272/344/270/216/346/225/260/347/220/206/347/273/237/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +149 -149
  423. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/250/241/346/213/237/347/224/265/345/255/220/346/212/200/346/234/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  424. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/263/233/345/207/275/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  425. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/203/255/345/212/233/345/255/246/344/270/216/347/273/237/350/256/241/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  426. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  427. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1302 -1302
  428. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/216/260/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  429. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/220/206/350/256/272/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  430. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/346/200/201/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  431. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  432. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1018 -1018
  433. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  434. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/345/212/250/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  435. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/350/267/257/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  436. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/244/276/344/274/232/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  437. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/250/213/345/272/217/350/256/276/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  438. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/227/346/263/225/350/256/276/350/256/241/344/270/216/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  439. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/241/347/220/206/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  440. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/272/277/346/200/247/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  441. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/206/350/203/236/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  442. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  443. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/223/346/236/204/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  444. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/274/345/220/210/302/267/347/273/264/345/237/272/347/273/274/350/277/260.md +184 -184
  445. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/274/226/350/257/221/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  446. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/207/252/346/210/221/346/204/217/350/257/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +270 -270
  447. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +698 -698
  448. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/273/204/346/210/220/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  449. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/275/221/347/273/234/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  450. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/257/255/350/250/200/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +226 -226
  451. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/275/257/344/273/266/345/267/245/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  452. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/201/227/344/274/240/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  453. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/217/345/255/220/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  454. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/221/350/236/215/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  455. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  456. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  457. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  458. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/200/235/346/203/263/346/224/277/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  459. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  460. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +365 -365
  461. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +269 -269
  462. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  463. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  464. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/345/210/206/345/255/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  465. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +157 -157
  466. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +237 -237
  467. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  468. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  469. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  470. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  471. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  472. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  473. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  474. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  475. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  476. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  477. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  478. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  479. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  480. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  481. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  482. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  483. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  484. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  485. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  486. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  487. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  488. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  489. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  490. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  491. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  492. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  493. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  494. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  495. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  496. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  497. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  498. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  499. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  500. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  501. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/346/235/241/344/273/266/350/267/257/347/224/261/345/233/276_CCG/350/256/276/350/256/241.md +150 -150
  502. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/350/257/255/344/271/211/346/235/241/344/273/266/345/215/217/350/256/256.md +650 -650
  503. package/md_cg/whitebox_kb/wisdom/docs//345/261/200/351/203/250/346/234/200/344/274/230/344/270/216/346/203/205/347/273/252/345/201/217/345/245/275_/347/220/206/350/256/272/345/267/245/347/250/213.md +97 -97
  504. package/md_cg/whitebox_kb/wisdom/docs//346/226/271/345/220/221/346/200/247/346/212/211/346/213/251_/350/207/252/344/270/276vs/350/207/252/350/277/255/344/273/243.md +81 -81
  505. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242AGI/346/236/266/346/236/204/346/216/242/347/264/242_/346/226/207/346/241/243/350/247/204/345/210/222.md +51 -51
  506. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242/346/217/222/344/273/266/345/210/206/347/261/273/345/210/206/346/236/220.md +67 -67
  507. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/346/234/254/345/234/260/346/240/241/351/252/214/345/231/250_ZeroLLM_Verifier.md +276 -276
  508. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/350/207/252/344/270/276/347/254/254/345/205/255/351/230/266/346/256/265_/346/224/266/345/256/230/346/200/273/347/273/223.md +1207 -1207
  509. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  510. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  511. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  512. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  513. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  514. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  515. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  516. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  517. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  518. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  519. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  520. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  521. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  522. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  523. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  524. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  525. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  526. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  527. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  528. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  529. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  530. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  531. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  532. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  533. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  534. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  535. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  536. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  537. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  538. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  539. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  540. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  541. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  542. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  543. package/md_cg/writegate.py +146 -0
  544. package/md_cg/writepipe.py +85 -7
  545. package/package.json +20 -6
  546. package/scripts/workspace_index.py +1 -0
  547. package/skills/README.md +121 -121
  548. package/skills/plugin.json +54 -54
  549. package/skills/skills/designer-perspective/SKILL.md +158 -158
  550. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  551. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  552. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  553. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  554. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  555. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  556. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  557. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  558. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  559. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  560. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  561. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  562. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  563. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  564. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  565. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  566. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  567. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  568. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  569. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  570. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  571. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  572. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  573. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  574. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  663. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  664. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  665. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  666. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  667. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  668. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  669. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  670. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  671. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  672. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  673. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  674. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  675. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  676. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  677. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  679. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  780. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  781. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  782. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  783. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  784. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  785. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  786. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  787. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  788. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  789. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  790. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  791. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  792. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  793. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  794. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  796. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  898. package/skills/skills/lingshu-net/SKILL.md +48 -48
  899. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  900. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  901. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  902. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  903. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  904. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  905. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  906. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  907. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  908. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  909. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  910. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  911. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  912. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  914. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1017. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1021. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1032. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1130. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1134. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1145. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1250. package/src/hooks.ts +21 -12
  1251. package/src/index.ts +3 -0
  1252. package/src/lib/console_web.mjs +96 -0
  1253. package/src/lib/python_path.ts +71 -71
  1254. package/src/lib/session_state.ts +127 -127
  1255. package/src/lib/whitebox_llm.ts +311 -311
  1256. package/ui/minimal/LICENSE +21 -0
  1257. package/ui/minimal/install.ps1 +168 -0
  1258. package/ui/minimal/integrity.json +41 -0
  1259. package/ui/minimal/payload/build-ui.mjs +16 -0
  1260. package/ui/minimal/payload/lib/client.js +18 -0
  1261. package/ui/minimal/payload/lib/lib/console_web.mjs +96 -0
  1262. package/ui/minimal/payload/src/lib/console_web.mjs +96 -0
  1263. package/ui/minimal/payload/web/app.js +154 -0
  1264. package/ui/minimal/payload/web/client.js +14 -0
  1265. package/ui/minimal/payload/web/entry.js +1 -0
  1266. package/ui/minimal/payload/web/index.html +3 -0
  1267. package/ui/minimal/payload/web/style.css +3 -0
  1268. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1269. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1270. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1271. package/utf8_boot.py +237 -237
  1272. package/web/app.js +154 -0
  1273. package/web/client.js +14 -0
  1274. package/web/entry.js +1 -0
  1275. package/web/index.html +3 -0
  1276. package/web/style.css +3 -0
package/md_cg/units.py CHANGED
@@ -1,870 +1,870 @@
1
- # -*- coding: utf-8 -*-
2
- """units.py · 复核单元接线层:蜂巢优先 → 提示配置 → harness 端子代理降级。
3
-
4
- 定位(与 audit.py 同一条架构约束):**能力不在认知图内**。本模块不做智能判定,
5
- 只做三件事:选通道(probe/plan)→ 派发请求(submit/wait/run)→ 记账(_units.jsonl)。
6
-
7
- 使用者裁定(2026-09-16,第 17 条精神):编译器(ccgc)的复核**优先使用蜂巢的
8
- 反思单元 / 验证单元**(reflect / verify,与 crosscheck.REFLECT_UNIT/VERIFY_UNIT 同值,
9
- 不新造角色名);蜂巢不可用 → **提示使用者配置**(给出可照做的构建/启动/环境变量命令);
10
- 或经显式 allow_degrade=True 降级到 **harness 端子代理**(宿主 agent 派发,裁决经
11
- crosscheck 同款 verdicts 通道回填)。理由:使用者的复核是昂贵的——重活交给可并行的
12
- 外部单元,agent 本体只做编排与记账。
13
-
14
- 蜂巢契约(真源 hive/README.md + hive/hive_mcp/mcp_server.py;**复制契约不 import**,
15
- 保持 md_cg 对 hive 零依赖,与 ccgc「同款语义就地实现防 import 环」惯例一致):
16
- jobs 目录 = $HIVE_JOBS_DIR | <repo>/hive/jobs
17
- serve 判活 = **三层**:jobs/_serve.json 的 ts(毫秒)距今 < FRESH_S(15s)
18
- ∧ pid 存活 ∧ 该 pid 是本程序
19
- (同 hive/serve_start.serve_alive;四路口径由
20
- hive/test_serve_entry.py 机械守卫)
21
- job 目录 = jobs/<job_id>/{spec.json,status.json,result.json,kill}
22
- job_id = 本模块自造旧形态 h<java_ms>_<uuid6>(`_job_id`,**不是** `_submit` 同款);
23
- hive 提交面自 id 契约 v2(B8)起为四槽 h_<身份>_<任务>_<单元>_<编号>,由
24
- Rust 侧 `hive alloc-id` 分配——两形态都过 job.rs::valid_job_id(存量零迁移)
25
- id 字符判据 = **区块白名单**:唯一真源 hive/id_charset_blocks.txt 的区间并集
26
- ([`_valid_job_id`];本模块**读这份数据文件**、不 import hive,
27
- 与 job.rs / mcp_server.py 三处共读同一份 ⇒ 不查任何 Unicode 属性库,
28
- 两侧版本差结构性不可能)。本闸**有意保留**两处放宽(既有对外契约):
29
- 不要求 h 前缀、允许 `-`;拒收面(零宽/双向控制/控制字符/路径成分/尾点/
30
- 首尾空白/Windows 保留设备名)逐条显式断,不靠「白名单外顺带拒」。
31
- result.json = {"ok":true,"content":...} | {"ok":false,"error":...}
32
- 终态 = done | error | timeout | killed
33
- 拉起 serve = <repo>/hive/target/release/hive serve --jobs <jobs>(detached)
34
-
35
- 边界(诚实声明,不猜测):
36
- · 本模块**不产生裁决**,只搬运;裁决由外部单元负责。
37
- · 契约漂移:hive 侧协议若变更,本模块以「无 result / 超时」如实失败,不假装成功。
38
- · 默认**不自动拉起 serve**(使用者裁定:不可用即提示配置);autostart=True 才拉起。
39
- """
40
- from __future__ import annotations
41
-
42
- import json
43
- import os
44
- import re
45
- import subprocess
46
- import time
47
- import uuid
48
-
49
- HIVE, SUBAGENT, CONFIGURE = "hive", "subagent", "configure"
50
- STATES = (HIVE, SUBAGENT, CONFIGURE)
51
-
52
- REFLECT, VERIFY = "reflect", "verify" # 同 crosscheck.REFLECT_UNIT/VERIFY_UNIT
53
- ROLES = (REFLECT, VERIFY)
54
-
55
- SERVE_FILE, SPEC_FILE = "_serve.json", "spec.json"
56
- STATUS_FILE, RESULT_FILE, KILL_FILE = "status.json", "result.json", "kill"
57
- LOG_NAME = "_units.jsonl"
58
- TERMINAL_STATES = ("done", "error", "timeout", "killed")
59
- #: serve 心跳新鲜窗口(秒)。**须与 hive/serve_start.FRESH_S 同值**——本模块
60
- #: 只持有「判活的第 4 处实现」(复制契约不 import hive),阈值/判据结构若与
61
- #: 权威漂移,会在通道选择面复现 v13 的「假存活」病类(v14 缺陷 E:
62
- #: 旧值 5.0 vs 权威 15,serve 崩溃后 ≤5s 窗口内判「存活」→ 选 hive 通道 →
63
- #: 提交的 job 永远无人处理)。守卫:hive/test_serve_entry.py。
64
- FRESH_S, DEFAULT_TIMEOUT_S, DEFAULT_POLL_S = 15.0, 120, 1.0
65
- #: 复核委派的 completion 预算。**必须对齐统一默认(文档:最大输出 200000)**——
66
- #: 该模型 reasoning 与正文**共享 completion 预算**,小预算会把正文吃光并静默返回空正文:
67
- #: 实测 2048 → reasoning 2048 / content 空;16384 → 时好时坏;200000 → 正常出裁决。
68
- DEFAULT_MAX_TOKENS = 200000
69
-
70
- ENV_JOBS_DIR, ENV_EXE = "HIVE_JOBS_DIR", "HIVE_EXE"
71
- ENV_MODEL, ENV_API_KEY = "MDCG_UNIT_MODEL", "HIVE_API_KEY"
72
-
73
- ACCEPT, REJECT, DEFER, BLINDSPOT = "ACCEPT", "REJECT", "DEFER", "BLINDSPOT"
74
- _VERDICT_MAP = {
75
- "accept": ACCEPT, "accepted": ACCEPT, "keep": ACCEPT, "pass": ACCEPT,
76
- "ok": ACCEPT, "approve": ACCEPT,
77
- "drop": REJECT, "reject": REJECT, "rejected": REJECT, "deny": REJECT, "fail": REJECT,
78
- "defer": DEFER, "deferred": DEFER, "unsure": DEFER, "unclear": DEFER, "skip": DEFER,
79
- "blindspot": BLINDSPOT, "blind": BLINDSPOT,
80
- }
81
-
82
-
83
- # 生效条件:无入参,恒返回模块 `__file__` 绝对路径上溯两级的目录(md_cg 的上一级),与 cwd 无关。
84
- def repo_root() -> str:
85
- """仓库根(md_cg 的上一级);不用 cwd——cwd 由宿主决定,不可作判据。"""
86
- return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
87
-
88
-
89
- # 生效条件:explicit 为真值时 d=explicit;explicit 为空串等假值而 ENV_JOBS_DIR 有真值时 d=该环境变量;两者皆假值时 d=repo_root()/hive/jobs;最终返回 os.path.abspath(d)。
90
- def jobs_dir(explicit: str = "") -> str:
91
- d = explicit or os.environ.get(ENV_JOBS_DIR) or os.path.join(repo_root(), "hive", "jobs")
92
- return os.path.abspath(d)
93
-
94
-
95
- # 生效条件:ENV_EXE 有真值时原样返回该值;ENV_EXE 缺失或为空串时返回 repo_root()/hive/target/release/ 下按 os.name=="nt" 取 hive.exe、否则取 hive 的拼接路径。
96
- def exe_path() -> str:
97
- exe = os.environ.get(ENV_EXE)
98
- if exe:
99
- return exe
100
- return os.path.join(repo_root(), "hive", "target", "release",
101
- "hive.exe" if os.name == "nt" else "hive")
102
-
103
-
104
- # 生效条件:explicit 为真值时取 explicit,否则取 ENV_MODEL,两者皆假值时按空串,返回该结果 strip() 后的字符串(可为空串)。
105
- def model_name(explicit: str = "") -> str:
106
- """复核模型(LLM 委托型执行器的 spec.model 必填)。"""
107
- return (explicit or os.environ.get(ENV_MODEL) or "").strip()
108
-
109
-
110
- # 生效条件:pid 为 int 且大于 0 时(否则 False),os.name 为 "nt" 时返回 _tasklist_row(pid) 是否非 None,非 "nt" 时 os.kill(pid, 0) 不抛 OSError 返回 True、抛 OSError 返回 False。
111
- def pid_alive(pid) -> bool:
112
- """该 pid **号**是否存在(Windows tasklist 精确列比对 / unix `kill -0`)。
113
-
114
- 只回答「这个号有没有进程」——**不足以判定「serve 还在跑」**(见
115
- `pid_is_self_program`)。实现与 hive/serve_start.pid_alive 同口径。
116
- """
117
- if not isinstance(pid, int) or pid <= 0:
118
- return False
119
- if os.name == "nt":
120
- return _tasklist_row(pid) is not None
121
- try:
122
- os.kill(pid, 0)
123
- return True
124
- except OSError:
125
- return False
126
-
127
-
128
- # 生效条件:对传入 pid 执行 tasklist /FO CSV 后,在其 stdout 中遇到的第一个按 '","' 切分、列数≥2 且第 2 列 strip 再 strip('"') 后等于 str(pid) 的行即返回 [映像名, pid 字符串],无此行或 subprocess.run 抛 OSError 时返回 None。
129
- def _tasklist_row(pid):
130
- """Windows:查该 pid 的 tasklist 行 → [映像名, pid 字符串];查不到返回 None。
131
-
132
- 按列精确比对,**不用子串包含**——子串会让 pid=441 被 4410 命中(假存活)。
133
- """
134
- try:
135
- # 显式 utf-8 + replace:只消费 ASCII 的 pid 列,但**不依赖 locale**——
136
- # locale 口径与「后代写 UTF-8」不一致时读线程会崩(见 test_subproc_encoding.py)。
137
- # P2-16(批次 30):timeout=10——tasklist 挂起曾永久阻塞判活路径。
138
- # stdin=subprocess.DEVNULL(issue #63 同批加固):不指定 stdin 时子进程
139
- # 继承父进程 stdin(常驻宿主下是 JSON-RPC 活管道)——判活路径不得因
140
- # 子进程读 stdin 而悬挂;形态对齐 `md_cg/run_tests.py:105`。
141
- r = subprocess.run(["tasklist", "/FI", f"PID eq {pid}", "/NH", "/FO", "CSV"],
142
- capture_output=True, text=True, stdin=subprocess.DEVNULL,
143
- encoding="utf-8", errors="replace", timeout=10)
144
- except (OSError, subprocess.SubprocessError):
145
- return None
146
- for line in (r.stdout or "").splitlines():
147
- cols = line.split('","')
148
- if len(cols) >= 2 and cols[1].strip().strip('"') == str(pid):
149
- return [cols[0].strip().strip('"'), cols[1].strip().strip('"')]
150
- return None
151
-
152
-
153
- # 生效条件:exe_path() 的 basename 小写非空且 pid 为 int 大于 0 时(否则 False),"nt" 下要求 _tasklist_row(pid) 非空且映像名小写等于该 basename,非 "nt" 下要求 /proc/<pid>/cmdline 首个 b"\x00" 前 token 的 basename 小写等于它(读取抛 OSError 则 False)。
154
- def pid_is_self_program(pid) -> bool:
155
- """该 pid 是否**就是本程序**(同映像名)——pid 号会被无关进程复用。
156
-
157
- 与 hive/serve_start.pid_is_self_program 同口径(复制契约)。零依赖边界:
158
- 拿不到映像名返回 False(宁可放行启动,也不误报「已有 serve 在跑」)。
159
- """
160
- want = os.path.basename(exe_path()).lower()
161
- if not want or not isinstance(pid, int) or pid <= 0:
162
- return False
163
- if os.name == "nt":
164
- row = _tasklist_row(pid)
165
- return bool(row) and row[0].lower() == want
166
- try:
167
- with open(f"/proc/{pid}/cmdline", "rb") as f:
168
- first = f.read().split(b"\x00")[0]
169
- except OSError:
170
- return False
171
- return os.path.basename(first.decode("utf-8", "replace")).lower() == want
172
-
173
-
174
- # 生效条件:以 jobs_dir(jobs) 下的 SERVE_FILE 为心跳路径——该路径不被 isfile 命中时返回 exists/alive 均 False 的未启动 reason;命中但 open/json.load 抛 OSError 或 ValueError 时返回不可读 reason;解析成功后按**三层判据**(age < fresh_s ∧ pid_alive(pid) ∧ pid_is_self_program(pid))定 alive,回填 age_s/pid/raw 与逐层明细及失败原因。
175
- def serve_state(jobs: str = "", fresh_s: float = FRESH_S) -> dict:
176
- """serve 判活:**三层**(心跳新鲜 ∧ pid 存活 ∧ 该 pid 是本程序)。
177
-
178
- 与 `hive/serve_start.serve_alive` 同口径(同值 FRESH_S=15s、同三层判据)。
179
- v14 缺陷 E:旧实现只判 ts 新鲜度且阈值 5s——双漂移,serve 崩溃后
180
- ≤5s 内判「存活」会让 `probe()` 选 hive 通道(提交的 job 永远无人处理),
181
- 这正是 v13「假存活」病类从守卫面搬到了**通道选择面**。
182
- """
183
- jd = jobs_dir(jobs)
184
- p = os.path.join(jd, SERVE_FILE)
185
- out = {"jobs_dir": jd, "heartbeat": p, "exists": os.path.isfile(p),
186
- "alive": False, "age_s": None, "pid": None, "reason": ""}
187
- if not out["exists"]:
188
- out["reason"] = "未见 _serve.json 心跳(serve 未启动或 jobs 目录不对)"
189
- return out
190
- try:
191
- with open(p, encoding="utf-8") as f:
192
- hb = json.load(f)
193
- except (OSError, ValueError) as exc:
194
- out["reason"] = "心跳不可读:%s: %s" % (type(exc).__name__, exc)
195
- return out
196
- age = time.time() - ((hb.get("ts") or 0) / 1000.0)
197
- pid = hb.get("pid")
198
- fresh_ok = age < float(fresh_s)
199
- pid_ok = pid_alive(pid)
200
- ident_ok = pid_is_self_program(pid)
201
- out.update({"age_s": round(age, 3), "pid": pid, "raw": hb,
202
- "fresh": bool(fresh_ok), "pid_alive": bool(pid_ok),
203
- "pid_is_self_program": bool(ident_ok)})
204
- out["alive"] = bool(fresh_ok and pid_ok and ident_ok)
205
- if out["alive"]:
206
- out["reason"] = ""
207
- elif not fresh_ok:
208
- out["reason"] = "心跳过期 %.1fs(阈值 %ss)——serve 可能已退出" % (age, fresh_s)
209
- elif not pid_ok:
210
- out["reason"] = "心跳新鲜但 pid=%s 已不存在——serve 已退出" % (pid,)
211
- else:
212
- out["reason"] = ("心跳新鲜且 pid=%s 存活,但该 pid 不属于本程序"
213
- "(非 %s)——pid 号被无关进程复用"
214
- % (pid, os.path.basename(exe_path())))
215
- return out
216
-
217
-
218
- # 生效条件:jobs 仅经 jobs_dir(jobs) 用于填充指引里的 jobs 路径;reason 为假值时文案首行取“serve 未存活”,否则取 reason 原文;返回模板固定嵌入 exe_path() 的目录与路径、ENV_API_KEY、ENV_MODEL、jd、jd 下的 SERVE_FILE 与 int(FRESH_S)。
219
- def setup_hint(jobs: str = "", reason: str = "") -> str:
220
- """不可用时给使用者看的**配置指引**(含降级指引)——提示即责任,须可照着做。"""
221
- jd = jobs_dir(jobs)
222
- return ("蜂巢不可用:%s\n"
223
- " [A 配置蜂巢(推荐,第 17 条)]\n"
224
- " 1) cd %s && cargo build --release\n"
225
- " 2) set %s=<LLM密钥>\n 3) set %s=<复核模型名>\n"
226
- " 4) 启动:%s serve --jobs \"%s\"(或 hive_spawn 自动拉起)\n"
227
- " 判活判据:%s 的 ts 距今 < %ss\n"
228
- " [B 降级 harness 端子代理]\n"
229
- " 重发本请求并带 allow_degrade=true:本模块返回复核请求包(prompt),\n"
230
- " 由宿主子代理执行后经 verdicts 回填裁决。"
231
- % (reason or "serve 未存活", os.path.dirname(exe_path()), ENV_API_KEY,
232
- ENV_MODEL, exe_path(), jd, os.path.join(jd, SERVE_FILE), int(FRESH_S)))
233
-
234
-
235
- # 生效条件:先取 st=serve_state(jobs, fresh_s) 与 mdl=model_name(model);st["alive"] 为真且 mdl 非空时返回 state=HIVE;否则 allow_degrade 为真时返回 state=SUBAGENT 且 channel 取 channel 或 "harness-subagent";否则返回 state=CONFIGURE、transport=None 并附 setup_hint(jobs, why)。
236
- def probe(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
237
- allow_degrade: bool = False, channel: str = "") -> dict:
238
- """三级能力探测:hive(可派发)→ configure(提示配置)→ subagent(显式降级)。
239
-
240
- 判据只认**心跳 + 模型名**两项硬前提;缺任一即如实降级,绝不用相似度
241
- (如「hive 目录存在」)冒充可用(资格由条件证据裁决,不由相似度裁决)。
242
- """
243
- st = serve_state(jobs, fresh_s)
244
- mdl = model_name(model)
245
- if st["alive"] and mdl:
246
- return {"state": HIVE, "transport": HIVE, "model": mdl, "jobs_dir": st["jobs_dir"],
247
- "serve": st, "channel": "", "hint": ""}
248
- why = st["reason"] if not st["alive"] else "serve 存活但未配置复核模型(%s)" % ENV_MODEL
249
- if allow_degrade:
250
- return {"state": SUBAGENT, "transport": SUBAGENT, "model": mdl,
251
- "jobs_dir": st["jobs_dir"], "serve": st,
252
- "channel": channel or "harness-subagent",
253
- "hint": "已按 allow_degrade 降级到 harness 端子代理:请把 prompt 交给宿主子代理,"
254
- "裁决经 verdicts 回填(蜂巢不可用原因:%s)" % why}
255
- return {"state": CONFIGURE, "transport": None, "model": mdl,
256
- "jobs_dir": st["jobs_dir"], "serve": st, "channel": "",
257
- "hint": setup_hint(jobs, why)}
258
-
259
-
260
- # 生效条件:state/transport/model/jobs_dir/serve/channel/hint 全部直接取自 probe(jobs, model, fresh_s, allow_degrade, channel) 的对应键,本函数不另做判活或模型判断,仅在 chain 文案中固定引用 int(FRESH_S) 与 ENV_MODEL。
261
- def plan(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
262
- allow_degrade: bool = False, channel: str = "") -> dict:
263
- """优先级链自描述(供 cg op=ccg action=units 与审计查看)。"""
264
- p = probe(jobs, model, fresh_s, allow_degrade, channel)
265
- return {"state": p["state"], "transport": p["transport"], "model": p["model"],
266
- "jobs_dir": p["jobs_dir"], "serve": p["serve"], "channel": p["channel"],
267
- "chain": [
268
- {"order": 1, "transport": HIVE, "action": "派发 reflect/verify 单元并等待 result.json",
269
- "when": ("jobs/_serve.json 心跳 < %ss 且(%s 已配置 **或调用方显式传 model**)"
270
- % (int(FRESH_S), ENV_MODEL))},
271
- {"order": 2, "transport": CONFIGURE, "action": "返回配置指引(不自动拉起、不假装通过)",
272
- "when": "蜂巢不可用"},
273
- {"order": 3, "transport": SUBAGENT, "action": "返回复核请求包,由 harness 端子代理执行并回填",
274
- "when": "调用方显式 allow_degrade=True"},
275
- ],
276
- "hint": p["hint"]}
277
-
278
-
279
- # ---------------------------------------------------------------- 派发与收取
280
-
281
- # 生效条件:无入参,恒返回 "h"+int(time.time()*1000)+"_"+uuid.uuid4().hex 前 6 位组成的字符串。
282
- def _job_id() -> str:
283
- """本地 id 生成(旧形态 `h<毫秒>_<uuid 前 6 位>`):serve 侧按 'h' 前缀识别任务目录。
284
-
285
- 诚实边界(id 契约 v2 · C2 同类措辞订正):**本函数已不是 `_submit` 的同款实现**
286
- ——`hive/hive_mcp/mcp_server.py::_submit` 自 B8 起调 Rust 侧 `hive alloc-id` 分配
287
- `h_<身份>_<任务>_<单元>_<编号>`,**不再自造 id**;本模块是 md_cg 的复核派发面,
288
- **不在 B8 点名的改动面**(契约只列 CLI / MCP 提交面 / orch 透传),故保留旧形态。
289
- 旧形态 id 在新契约下**仍然合法**(存量零迁移:`job.rs::valid_job_id` 收),故此处
290
- 不闯闸、不破坏 serve 领取;但它绕过了分配器的独占创建与五单元闭集 ⇒ 与「分配器
291
- 唯一实现在 Rust 侧」(契约 §五 裁决 3)不齐,宜单独裁决(牵动 md_cg 派发/等待链
292
- 语义与其守卫 `md_cg/test_units_poll.py`,不在本批「只论证订正」的范围内)。
293
- """
294
- return "h%d_%s" % (int(time.time() * 1000), uuid.uuid4().hex[:6])
295
-
296
-
297
- # ------------------------------------------------ id 字符判据(区块白名单 · 唯一真源)
298
-
299
- #: 区块表数据文件(**唯一真源**,与 `hive/src/job.rs` / `hive/hive_mcp/mcp_server.py`
300
- #: **共读同一份数据**;本模块**读数据文件**而不是 import hive ⇒ 不破零依赖家法)。
301
- _CHARSET_BLOCKS_REL = "hive/id_charset_blocks.txt"
302
- _MAX_CP = 0x10FFFF
303
-
304
-
305
- # 生效条件:text 为表文件全文时返回区间列表 [(起, 止)]——**唯一解析配方**(与 Rust
306
- # `job.rs::parse_id_charset_blocks`、`mcp_server._parse_charset_blocks` 同一条,不许各写
307
- # 一套):每行取 `#` 之前部分后 strip;空行跳过;余下 split('-') 两段 int(x, 16)。
308
- # 任一行不合形态 / 越界 / 逆序 / 未归并到最小 / 空表 → 抛 ValueError(fail-closed:
309
- # 绝不静默跳过坏行——跳过一行的表是另一张表,三处读者随即不同判)。
310
- def _parse_charset_blocks(text: str) -> list:
311
- """区块表解析(唯一配方)。"""
312
- out: list = []
313
- for lineno, line in enumerate(text.split("\n"), 1):
314
- body = line.split("#", 1)[0].strip()
315
- if not body:
316
- continue
317
- parts = body.split("-")
318
- if len(parts) != 2:
319
- raise ValueError("区块表第 %d 行不是 LO-HI 形态:%r" % (lineno, line))
320
- lo, hi = int(parts[0], 16), int(parts[1], 16)
321
- if not (0 <= lo <= hi <= _MAX_CP):
322
- raise ValueError("区块表第 %d 行区间非法:%r" % (lineno, line))
323
- if out and lo <= out[-1][1] + 1:
324
- raise ValueError("区块表第 %d 行未归并到最小(相邻/相交/乱序):%r"
325
- % (lineno, line))
326
- out.append((lo, hi))
327
- if not out:
328
- raise ValueError("区块表解析出空区间集(fail-closed:空表绝不放行)")
329
- return out
330
-
331
-
332
- # 生效条件:无入参,返回 (区间表, 错误说明)——文件可读且解析通过 → (tuple 区间表, None);
333
- # 表缺失 / 不可读 / 解析失败 → ((), 原因)。后两者让判据 fail-closed(对一切字符 False)。
334
- def _load_charset_blocks() -> tuple:
335
- """**模块导入时读一次**(不做每调用 I/O);路径基准 = 本文件上溯两级(= 仓根)。"""
336
- path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
337
- "hive", "id_charset_blocks.txt")
338
- try:
339
- with open(path, encoding="utf-8") as fh:
340
- text = fh.read()
341
- except OSError as exc:
342
- return (), "%s 不可读:%s" % (_CHARSET_BLOCKS_REL, exc)
343
- try:
344
- return tuple(_parse_charset_blocks(text)), None
345
- except ValueError as exc:
346
- return (), "%s 解析失败:%s" % (_CHARSET_BLOCKS_REL, exc)
347
-
348
-
349
- #: 判据数据(模块导入时求值一次):区间表 + 读取/解析错误(错误非 None ⇒ 判据一律 False)。
350
- CHARSET_BLOCKS, CHARSET_BLOCKS_ERROR = _load_charset_blocks()
351
-
352
-
353
- # 生效条件:c 为单字符且其码点落在区间表内 → True;表缺失 / 坏行 / 空表 → False
354
- # (fail-closed:绝不放行)。
355
- def _charset_member(c: str) -> bool:
356
- u = ord(c)
357
- return any(lo <= u <= hi for lo, hi in CHARSET_BLOCKS)
358
-
359
-
360
- # Windows 保留设备名(B4 拒收项;与 `job.rs::RESERVED_DEVICE_NAMES`、
361
- # `mcp_server.RESERVED_DEVICE_NAMES` 逐项同集——md_cg 只复制这 22 个常量,**还是读数据
362
- # 而不是 import hive**)。Win32 对**单个路径分量**做设备名解析且**忽略扩展名**
363
- # (`CON.txt` 与 `CON` 同指设备),故比对的是「首个 `.` 之前」部分;比对**ASCII 大小写
364
- # 不敏感**(不用 str.upper():它的 Unicode 折叠面比 Rust 的 eq_ignore_ascii_case 宽,
365
- # 会让两侧分叉)。
366
- RESERVED_DEVICE_NAMES = (
367
- "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6",
368
- "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6",
369
- "LPT7", "LPT8", "LPT9",
370
- )
371
- _ASCII_UPPER = str.maketrans("abcdefghijklmnopqrstuvwxyz",
372
- "ABCDEFGHIJKLMNOPQRSTUVWXYZ")
373
-
374
-
375
- # 生效条件:s 的「首个 `.` 之前」部分与任一保留设备名 **ASCII 大小写不敏感**相等 → True
376
- # (含 `CON.txt` 这类带扩展名形态)——与 rust `job::is_reserved_device_name` 同判。
377
- def _is_reserved_device_name(s: str) -> bool:
378
- base = s.split(".")[0].translate(_ASCII_UPPER)
379
- return base in RESERVED_DEVICE_NAMES
380
-
381
-
382
- # 生效条件:jid 为 str、长度 1..128、strip() 前后无差异(首尾无空白)、首尾字符都不是
383
- # "."(拒 "."/".."/"..." 与 Win32 会剥尾点的 "abc." 形态)、逐字符过显式拒收集合后落在
384
- # **区块白名单**([`_charset_member`],唯一真源 `hive/id_charset_blocks.txt`,与 hive 两侧
385
- # 共读同一份数据)或属结构字符 `_` `-` `.`,且整 id 与其按 `_` 分段的任一段都不是
386
- # Windows 保留设备名、且按 `_` 分段的**任一段都不等于** `.` 或 `..`(c7 段级)时返回 True,
387
- # 否则 False。
388
- def _valid_job_id(jid) -> bool:
389
- r"""job_id 结构闸(N178,2026-09-28;2026-09-30 字符集判据换面为**区块白名单**)。
390
-
391
- 同族家法:`hive/hive_mcp/mcp_server.py::_valid_job_id`、
392
- `hive/src/job.rs::valid_job_id`(三处**共读同一份区块表**,不是三套常量)。
393
- 本闸**保留**的既有放宽(都是既有对外契约,**不得**为「同口径」收紧):
394
- · **不要求 "h" 前缀**——`md_cg/test_units_poll.py` 的 "j_empty"/"j_good"/
395
- "j_fail" 是本模块对外契约(poll 面向任意宿主派发器写出的 job 目录),前缀
396
- 收紧会误杀;
397
- · 允许 `-`(hive 侧拒它:不在区块表内、也不是它的结构字符);
398
- · 长度上限 128、首尾无空白、首尾非点(拒 "."/".."/"..." 与 "x." 尾点形态)
399
- 一并保留。
400
- 非 str 一律拒(**不** str() 归一:与 legacy P3 同纪律,未校验的强制转换会把对象
401
- 形态洗成合法路径成分)。
402
- 字符类判据 = **区块白名单**(与 hive 两侧同源)——白名单外的一切字符一律拒。
403
- 放宽带来的静默风险**逐条显式挡住**(c9:「isalpha」类判据下 Cf/Cc 天然不入,但
404
- **不能靠这个**):零宽 U+200B..U+200F/U+2060/U+FEFF、双向控制
405
- U+202A..U+202E/U+2066..U+2069、控制字符(C0/DEL/C1)**逐条显式判**;`/` `\` `:`
406
- 与 NUL 同样显式拒(路径成分:相对父段 "../outside"、分隔符、盘符/ADS、绝对路径
407
- 会被 os.path.join 吸附);Windows 保留设备名(CON/PRN/AUX/NUL/COM1..9/LPT1..9,
408
- 含 `CON.txt` 带扩展名形态与 ASCII 大小写变体)**整 id 与按 `_` 分段的任一段**逐名
409
- 显式拒——旧 ASCII 白名单下 `CON` 这类全字母 id 是**放行**的,故这是本闸换面时
410
- **收紧**的那一面(与 hive 两侧同集同判,语料 80-84 行逐例钉死)。
411
- 表缺失 / 坏表 ⇒ 判据一律 False(fail-closed,绝不放行)。
412
- 本闸本批**新增收紧**(c7,2026-09-30):按 `_` 分段的**任一段**等于 `.` 或 `..` 即拒
413
- ——整串口径下 `h_.._x` / `h_a_.._b` 是被收的;段级是面向重构的纵深加固(段可能被当
414
- 父目录段用),与 hive 两侧同判。范围只加这一条:空段(`h__x`)等形态不动。
415
- """
416
- if not isinstance(jid, str) or not jid or len(jid) > 128:
417
- return False
418
- if jid != jid.strip():
419
- return False
420
- if jid[0] == "." or jid[-1] == ".":
421
- return False
422
- for c in jid:
423
- u = ord(c)
424
- if u <= 0x1F or 0x7F <= u <= 0x9F or c in "/\\:":
425
- return False # 控制字符(C0/DEL/C1,含 NUL)与路径成分(显式判,c9)
426
- if "\u200b" <= c <= "\u200f" or c in ("\u2060", "\ufeff"):
427
- return False # 零宽/不可见注入载体(显式判,c9)
428
- if "\u202a" <= c <= "\u202e" or "\u2066" <= c <= "\u2069":
429
- return False # 双向控制(显式判,c9)
430
- if c in "_.-":
431
- continue # 结构字符:槽分隔符 / 点(首尾点已在上方拒)/ 既有放宽的 `-`
432
- if not _charset_member(c):
433
- return False
434
- # Windows 保留设备名(显式判,c7/c9):整 id(首个 `.` 之前部分,Win32 忽略扩展名)
435
- # 与按 `_` 分段的**任一段**(Win32 的设备名解析是按路径分量做的)——与
436
- # `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` 同集同判。
437
- if _is_reserved_device_name(jid):
438
- return False
439
- if any(_is_reserved_device_name(seg) for seg in jid.split("_")):
440
- return False
441
- # 「. / ..」的**段级**判据(c7,2026-09-30 加固):按 `_` 分段,任一段等于 `.` 或 `..`
442
- # 即拒——与 `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` **三处同判**。
443
- # 段级而非整串(本面原有的「首尾非点」只挡整串与尾点形态):id 的段可能被宿主当
444
- # **目录名**或**父目录段**用(契约 §四.4「目录可作它的父段」)。现场定性:`h_.._x` /
445
- # `h_a_.._b` 这类「含 `..` 段但不以点结尾」的 id 拼出的路径停在池内、不构成穿越 ⇒
446
- # 面向重构的纵深加固。范围**只加这一条**:不拒空段(`h__x`)等未被裁定的形态。
447
- if any(seg in (".", "..") for seg in jid.split("_")):
448
- return False
449
- return True
450
-
451
-
452
- # 生效条件:无入参,返回 job_id 非法的结构化拒绝 dict(ok=False、state="invalid_job_id"、terminal=False、job_dir/content/status 均为 None、error 含非法 id 与本闸口径),字段集与 poll 的返回同构。
453
- def _bad_job_id(job_id, *, where: str) -> dict:
454
- """非法 job_id 的统一拒答(poll/wait/submit 同构,便于调用方机械判别)。"""
455
- return {"job_id": job_id, "job_dir": None, "state": "invalid_job_id",
456
- "terminal": False, "ok": False, "content": None, "status": None,
457
- "error": ("job_id 非法:%r(%s)——job_id 须为**单个路径分量**:区块白名单"
458
- "(hive/id_charset_blocks.txt)内的字母/数字,或结构字符 `_` `-` `.`;"
459
- "首尾非点,不含 / \\ : 与控制/零宽/双向控制字符/NUL,"
460
- "且整 id 与按 `_` 分段的任一段都不得是 Windows 保留设备名"
461
- "(CON/PRN/AUX/NUL/COM1..9/LPT1..9,含 CON.txt 形态)"
462
- "(N178:拒 ../victim 型越池读 result.json、"
463
- "拒任意目录建目录写 spec.json)" % (job_id, where))}
464
-
465
-
466
- # 生效条件:cg.root 与 cg.cg.root 都取不到真值时不写、直接返回 None;取到 root 时向 root/LOG_NAME 追加一行 rec(副本,setdefault ts)的 JSON,写入抛 OSError 时被吞掉静默返回 None。
467
- def _log(cg, rec: dict) -> None:
468
- """留痕 _units.jsonl(对齐 _crosscheck.jsonl / _backfill.jsonl 纪律)。"""
469
- root = getattr(cg, "root", None) or getattr(getattr(cg, "cg", None), "root", None)
470
- if not root:
471
- return
472
- try:
473
- rec = dict(rec)
474
- rec.setdefault("ts", int(time.time() * 1000))
475
- with open(os.path.join(str(root), LOG_NAME), "a", encoding="utf-8") as f:
476
- f.write(json.dumps(rec, ensure_ascii=False) + "\n")
477
- except OSError:
478
- pass
479
-
480
-
481
- # 生效条件:role 不在 ROLES 时返回 ok=False 的未知角色 error;否则 model_name(model) 为空时返回 ok=False 的未配置复核模型;否则 str(prompt or "").strip() 为空时返回 ok=False 的 prompt 为空;否则落盘前先过 _valid_job_id 结构闸(未过返回 ok=False 的 job_id 非法,**不建目录不写文件**——N178:job_id 来源一旦不是 _job_id(),join 后就是「任意目录 + 生成名」的建目录/写文件原语);闸过则在 jobs_dir(jobs)/job_id 下写 spec.json 与 status.json(context_files 为真、temperature 非 None、extra 为真时才并入 spec),OSError 时返回 ok=False 的写入失败,全部成功返回 ok=True 与 job_id/job_dir/spec/model。
482
- def submit(*, prompt: str, role: str = REFLECT, model: str = "", system_prompt: str = "",
483
- context_files=None, timeout_s: int = DEFAULT_TIMEOUT_S,
484
- max_tokens: int = DEFAULT_MAX_TOKENS, temperature=None, jobs: str = "",
485
- actor: str = "", extra: dict = None, cg=None) -> dict:
486
- """写一条 LLM 委托型 job(spec.json + status.json,形态同 _submit);只写文件不起进程。"""
487
- if role not in ROLES:
488
- return {"ok": False, "error": "未知复核角色:%r(可选 %s)" % (role, list(ROLES))}
489
- mdl = model_name(model)
490
- if not mdl:
491
- return {"ok": False, "error": "未配置复核模型:请设 %s 或显式传 model" % ENV_MODEL}
492
- if not str(prompt or "").strip():
493
- return {"ok": False, "error": "prompt 为空"}
494
- jd, job_id = jobs_dir(jobs), _job_id()
495
- # N178(2026-09-28):**落盘前**过闸——makedirs 之后再过就等于已经建了目录。
496
- if not _valid_job_id(job_id):
497
- return {"ok": False, "job_dir": None, "job_id": job_id,
498
- "error": _bad_job_id(job_id, where="submit 落点")["error"]}
499
- d = os.path.join(jd, job_id)
500
- spec = {"model": mdl, "user_prompt": str(prompt), "system_prompt": str(system_prompt or ""),
501
- "timeout_s": int(timeout_s), "max_tokens": int(max_tokens),
502
- "role": role, "unit_role": role}
503
- if context_files:
504
- spec["context_files"] = list(context_files)
505
- if temperature is not None:
506
- spec["temperature"] = temperature
507
- if extra:
508
- spec.update(extra)
509
- try:
510
- os.makedirs(d, exist_ok=True)
511
- with open(os.path.join(d, SPEC_FILE), "w", encoding="utf-8") as f:
512
- json.dump(spec, f, ensure_ascii=False)
513
- with open(os.path.join(d, STATUS_FILE), "w", encoding="utf-8") as f:
514
- json.dump({"job_id": job_id, "state": "pending",
515
- "created_ts": int(time.time() * 1000), "started_ts": None,
516
- "heartbeat_ts": None, "elapsed_s": 0.0, "timeout_s": int(timeout_s),
517
- "model": mdl, "pid": None, "error": None}, f, ensure_ascii=False)
518
- except OSError as exc:
519
- return {"ok": False, "job_dir": d,
520
- "error": "job 写入失败:%s: %s" % (type(exc).__name__, exc)}
521
- _log(cg, {"action": "submit", "job_id": job_id, "role": role, "model": mdl,
522
- "timeout_s": int(timeout_s), "actor": actor, "prompt_head": str(prompt)[:200]})
523
- return {"ok": True, "job_id": job_id, "job_dir": d, "spec": spec,
524
- "unit_role": role, "model": mdl}
525
-
526
-
527
- # 生效条件:job_id 先过 _valid_job_id 结构闸(未过返回 state="invalid_job_id" 的结构化拒绝,**不触盘**——N178:修前 "../victim" 会被 join 成池外目录并读出其 result.json 全文);闸过时 jobs_dir(jobs)/job_id 不是目录返回 state=missing、terminal=False 的目录不存在 error;是目录时读 STATUS_FILE(读失败则 status 置 None)并用其 state 覆盖 state/terminal(state 属 TERMINAL_STATES 才 terminal=True);RESULT_FILE 被 isfile 命中则 terminal=True、state=st or "done",解析抛 OSError/ValueError 时提前返回该 error;解析为 dict 时取 ok/content/error/usage/model,且 ok 为真而 content 去空白为空时把 ok 改 False 并写空正文 error,解析为非 dict 时 ok=True 且 content 为原值。
528
- def poll(job_id: str, jobs: str = "") -> dict:
529
- """读 job 终态视图:**以 result.json 出现为终态主判据**,status.json 仅作辅助。"""
530
- # N178(2026-09-28):调用方给的 job_id 是路径成分,**先过闸再 join**。
531
- # 修前此处无闸,且 `str(job_id or "")` 还会把非 str 洗成合法成分。
532
- if not _valid_job_id(job_id):
533
- return _bad_job_id(job_id, where="poll 池路径成分")
534
- d = os.path.join(jobs_dir(jobs), job_id)
535
- out = {"job_id": job_id, "job_dir": d, "state": "missing", "terminal": False,
536
- "ok": False, "content": None, "error": None, "status": None}
537
- if not os.path.isdir(d):
538
- out["error"] = "job 目录不存在:%s" % d
539
- return out
540
- sp = os.path.join(d, STATUS_FILE)
541
- if os.path.isfile(sp):
542
- try:
543
- with open(sp, encoding="utf-8") as f:
544
- out["status"] = json.load(f)
545
- except (OSError, ValueError):
546
- out["status"] = None
547
- st = (out["status"] or {}).get("state")
548
- if st:
549
- out.update({"state": st, "terminal": st in TERMINAL_STATES})
550
- rp = os.path.join(d, RESULT_FILE)
551
- if os.path.isfile(rp):
552
- out["state"] = st or "done"
553
- out["terminal"] = True
554
- try:
555
- with open(rp, encoding="utf-8") as f:
556
- res = json.load(f)
557
- except (OSError, ValueError) as exc:
558
- out["error"] = "result.json 不可读:%s" % type(exc).__name__
559
- return out
560
- if isinstance(res, dict):
561
- out["ok"] = bool(res.get("ok"))
562
- out["content"] = res.get("content")
563
- out["error"] = res.get("error") or out["error"]
564
- out["usage"] = res.get("usage")
565
- out["model"] = res.get("model")
566
- # 空正文**不得报成功**:reasoning 与正文共享 completion 预算,预算不足时
567
- # job 仍自称 ok 但 content 为空 → 若不拦,会被误读成「复核单元无答复」
568
- # (假死锁)。run() 早已有同等校验,此处补齐,消除两处口径不一致。
569
- if out["ok"] and not str(out["content"] or "").strip():
570
- out["ok"] = False
571
- out["error"] = ("空正文:job 自称 ok 但 content 为空(多为 reasoning 吃尽"
572
- "完成预算;提高 max_tokens,勿把预算不足当通道不可用)")
573
- else:
574
- out["ok"], out["content"] = True, res
575
- return out
576
-
577
-
578
- # 生效条件:job_id 未过 _valid_job_id 结构闸时**立即**返回 poll 的同一拒绝结构(N178:否则非法 id 会空转满 timeout_s 才超时返回——拒绝不该以等待为代价);闸过时循环 poll(job_id, jobs),结果 terminal 为真即补 waited_s 后返回;否则 time.time()-t0 >= float(timeout_s) 时返回 terminal=False、timeout=True 与超时 error;两者皆不满足则 sleep(float(poll_s)) 后重试(timeout_s=0 时首次 poll 非终态即超时返回)。
579
- def wait(job_id: str, *, jobs: str = "", timeout_s: float = DEFAULT_TIMEOUT_S,
580
- poll_s: float = DEFAULT_POLL_S) -> dict:
581
- """阻塞等终态;超时如实返回(不假装成功、不强杀 job)。"""
582
- if not _valid_job_id(job_id):
583
- # N178(2026-09-28):fail-fast——复用 poll 的拒绝结构,绝不进轮询。
584
- return poll(job_id, jobs)
585
- t0 = time.time()
586
- while True:
587
- cur = poll(job_id, jobs)
588
- if cur.get("terminal"):
589
- cur["waited_s"] = round(time.time() - t0, 3)
590
- return cur
591
- if (time.time() - t0) >= float(timeout_s):
592
- cur.update({"terminal": False, "timeout": True, "waited_s": round(time.time() - t0, 3),
593
- "error": "等待超时 %.0fs(job 仍在 %s)" % (float(timeout_s),
594
- cur.get("state"))})
595
- return cur
596
- time.sleep(float(poll_s))
597
-
598
-
599
- # 生效条件:submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw) 的 ok 为假时返回 stage="submit" 的失败 dict(含 **sub);ok 为真时 wait(sub["job_id"], jobs=kw.get("jobs",""), timeout_s=wait_s),补 stage="wait"/job_id/unit_role/model,并把 ok 改为 res 的 ok 与 content 同时为真。
600
- def run(*, prompt: str, role: str = REFLECT, cg=None, actor: str = "",
601
- wait_s: float = DEFAULT_TIMEOUT_S, **kw) -> dict:
602
- """submit + wait 组合(阻塞式复核,MCP action=review 主路径)。"""
603
- sub = submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw)
604
- if not sub.get("ok"):
605
- return {"ok": False, "stage": "submit", "error": sub.get("error"), **sub}
606
- res = wait(sub["job_id"], jobs=kw.get("jobs", ""), timeout_s=wait_s)
607
- res.update({"stage": "wait", "job_id": sub["job_id"], "unit_role": role,
608
- "model": sub.get("model")})
609
- res["ok"] = bool(res.get("ok")) and bool(res.get("content"))
610
- return res
611
-
612
-
613
- # ---------------------------------------------------------------- 裁决解析与搬运
614
-
615
- _FENCE_RE = re.compile(r"```(?:json)?\s*(.+?)\s*```", re.S)
616
-
617
-
618
- # 生效条件:raw 是 dict/list 时原样返回;否则取 str(raw or "").strip(),为空串(含 0/False/None 等假值)返回 None;否则依次尝试 _FENCE_RE 第 1 组、整段文本、首个 "{" 到末个 "}" 及首个 "[" 到末个 "]" 的切片,返回首个能 json.loads 成 dict 或 list 的候选;全部失败返回 None。
619
- def _json_of(raw):
620
- """从单元输出抽第一个 JSON 对象/数组(容忍 ```json 围栏与前后噪声)。"""
621
- if isinstance(raw, (dict, list)):
622
- return raw
623
- text = str(raw or "").strip()
624
- if not text:
625
- return None
626
- cands = []
627
- m = _FENCE_RE.search(text)
628
- if m:
629
- cands.append(m.group(1))
630
- cands.append(text)
631
- for opener, closer in (("{", "}"), ("[", "]")):
632
- i, j = text.find(opener), text.rfind(closer)
633
- if 0 <= i < j:
634
- cands.append(text[i:j + 1])
635
- for c in cands:
636
- try:
637
- v = json.loads(c)
638
- except ValueError:
639
- continue
640
- if isinstance(v, (dict, list)):
641
- return v
642
- return None
643
-
644
-
645
- # 生效条件:data=_json_of(raw) 为 list 时取 data[0](仅当它是 dict,否则 None);非 dict 时返回 verdict=DEFER、parsed=False;dict 时 word 取 verdict/decision/state/result 中首个真值后 strip().lower(),_VERDICT_MAP.get(word) 为 None 时返回 DEFER、parsed=True 并带 corr 与 reason,命中时返回该裁决及 reason、slot_corrections(取自 slot_corrections/corrections,非 dict 则置 {})、checks、raw 前 500 字符。
646
- def verdict_of(raw) -> dict:
647
- """单元输出 → 裁决四态;解析不出 → DEFER(不猜测、不当通过)。"""
648
- data = _json_of(raw)
649
- if isinstance(data, list):
650
- data = data[0] if data and isinstance(data[0], dict) else None
651
- if not isinstance(data, dict):
652
- return {"verdict": DEFER, "reason": "单元输出无法解析为裁决 JSON",
653
- "slot_corrections": {}, "raw": str(raw)[:500], "parsed": False}
654
- word = str(data.get("verdict") or data.get("decision") or data.get("state")
655
- or data.get("result") or "").strip().lower()
656
- reason = str(data.get("reason") or data.get("why") or data.get("detail") or "").strip()
657
- corr = data.get("slot_corrections") or data.get("corrections") or {}
658
- corr = corr if isinstance(corr, dict) else {}
659
- got = _VERDICT_MAP.get(word)
660
- if got is None:
661
- return {"verdict": DEFER, "slot_corrections": corr, "parsed": True, "raw": str(raw)[:500],
662
- "reason": "单元未给出可识别的裁决(%r)%s" % (word, (":" + reason) if reason else "")}
663
- return {"verdict": got, "reason": reason, "slot_corrections": corr,
664
- "checks": data.get("checks"), "raw": str(raw)[:500], "parsed": True}
665
-
666
-
667
- # 生效条件:state==HIVE 时返回 "hive:<role>:<job_id 或 'unknown'>";state==SUBAGENT 时返回 "subagent:<role>:<channel 或 'harness'>";其余 state 返回空串。
668
- def transport_name(state: str, role: str, job_id: str = "", channel: str = "") -> str:
669
- """裁决来源标识:**结构上不可能等于编译者**,保证 A 裁定「不得自证」不被误伤。"""
670
- if state == HIVE:
671
- return "hive:%s:%s" % (role, job_id or "unknown")
672
- if state == SUBAGENT:
673
- return "subagent:%s:%s" % (role, channel or "harness")
674
- return ""
675
-
676
-
677
- # 生效条件:unit 为假值时按 {} 处理;verdict=unit.get("verdict") or DEFER,verifier=transport_name(state, role, job_id, channel),evidence 取 unit 的 reason,为空则退回 str(unit["raw"])[:300],job_id 为真时再追加“(job=<job_id>)”;仅当 unit 的 slot_corrections 为真才带该键,仅当 compiled_by 与 verifier 皆非空且相等才置 self_verify=True。
678
- def to_attest_args(unit: dict, *, state: str = "", role: str = REFLECT, job_id: str = "",
679
- channel: str = "", compiled_by: str = "") -> dict:
680
- """单元裁决 → ccgc.attest(...) 入参(纯函数,离线可测)。
681
-
682
- 诚实边界:只做搬运与命名;裁决正确性由外部单元负责,本模块不为其背书。
683
- """
684
- unit = unit or {}
685
- verdict = unit.get("verdict") or DEFER
686
- verifier = transport_name(state, role, job_id, channel)
687
- evidence = str(unit.get("reason") or "")
688
- if unit.get("raw") and not evidence:
689
- evidence = str(unit["raw"])[:300]
690
- if job_id:
691
- evidence = "%s(job=%s)" % (evidence, job_id)
692
- args = {"verdict": verdict, "verifier": verifier, "evidence": evidence}
693
- if unit.get("slot_corrections"):
694
- args["slot_corrections"] = unit["slot_corrections"]
695
- if compiled_by and verifier and verifier == compiled_by:
696
- args["self_verify"] = True
697
- return args
698
-
699
-
700
- # ---------------------------------------------------------------- 复核请求包
701
-
702
- _REFLECT_TPL = """你是认知图记忆节点的**反思单元**(reflect)。下面是一份由 ccgc 编译出的
703
- CCG 六要素候选(功能名/生效条件/子功能/执行/验证方式/不适用条件)。请逐项反思:
704
-
705
- 1) 六要素是否齐备,是否都能在「对话记录」里找到字面依据;
706
- 2) 「生效条件」四槽(场景/时窗/对象/前置)是否与实际适用范围一致,有无过度泛化;
707
- 3) 「不适用条件」(拒绝域)是否漏掉了明显该拒的情形;
708
- 4) 若有问题,给出**最小修正**(只改该字段,不重写)。
709
-
710
- 编译产物(JSON):
711
- {digest}
712
-
713
- 原始对话记录(真源,引用必须出自此处):
714
- {dialog}
715
-
716
- 只输出一个 JSON 对象,不要任何解释文字:
717
- {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}},
718
- "checks":[{{"element":"功能名","ok":true,"note":""}}]}}"""
719
-
720
- _VERIFY_TPL = """你是独立**验证单元**(verify)。对下面这份 CCG 六要素候选与反思单元的结论
721
- 逐条复核:来源是否真实可追溯、结论是否被对话记录支持、修正是否越权(不得新增事实)。
722
-
723
- **你只能否决或存疑,不得新增主张、不得改写事实**(可给出 slot_corrections 修正已有槽位)。
724
-
725
- 候选(JSON):
726
- {digest}
727
-
728
- 反思单元结论:
729
- {reflect_rows}
730
-
731
- 对话记录(真源):
732
- {dialog}
733
-
734
- 只输出一个 JSON 对象:
735
- {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}}}}"""
736
-
737
-
738
- # 生效条件:digest is None 时返回 "{}";digest 是 str 时原样返回;否则先试 to_dict/as_dict 可调用方法并 json.dumps 其返回值(抛异常即跳出改走后续分支);是 dict 时 json.dumps(digest);其余取 vars(digest) 中不以 "_" 开头的属性 json.dumps(default=str)。
739
- def _digest_of(digest) -> str:
740
- if digest is None:
741
- return "{}"
742
- if isinstance(digest, str):
743
- return digest
744
- for attr in ("to_dict", "as_dict"):
745
- fn = getattr(digest, attr, None)
746
- if callable(fn):
747
- try:
748
- return json.dumps(fn(), ensure_ascii=False, indent=1)
749
- except Exception: # noqa: BLE001
750
- break
751
- if isinstance(digest, dict):
752
- return json.dumps(digest, ensure_ascii=False, indent=1)
753
- return json.dumps({k: v for k, v in vars(digest).items() if not k.startswith("_")},
754
- ensure_ascii=False, indent=1, default=str)
755
-
756
-
757
- # 生效条件:role==VERIFY 选 _VERIFY_TPL,否则选 _REFLECT_TPL;reflect_rows 是 str 时直接作为 rows,否则 json.dumps(reflect_rows or [], ensure_ascii=False, indent=1);最终返回 tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000], reflect_rows=rows[:3000])。
758
- def prompt_for(role: str, digest=None, *, dialog: str = "", reflect_rows="") -> str:
759
- """按角色生成复核请求包正文(reflect/verify 共用一处模板真源)。"""
760
- tpl = _VERIFY_TPL if role == VERIFY else _REFLECT_TPL
761
- rows = reflect_rows if isinstance(reflect_rows, str) else json.dumps(
762
- reflect_rows or [], ensure_ascii=False, indent=1)
763
- return tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000],
764
- reflect_rows=rows[:3000])
765
-
766
-
767
- # 生效条件:text 取 prompt 真值或 prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows);pr=probe(jobs, model, allow_degrade=allow_degrade, channel=channel) 为 SUBAGENT 时原样返回未派发的 SUBAGENT 包、为 CONFIGURE 时返回未派发的 CONFIGURE 包;为 HIVE 时若 autostart 为真且 serve_state(jobs) 非 alive 先 autostart_serve(jobs),再 submit(...),submit 失败回 CONFIGURE 且把 error 拼进 hint,成功则给出 job_id,blocking=False 直接返回;blocking=True 时 wait(sub["job_id"], jobs=jobs, timeout_s=wait_s),res.ok 为假则 unit 记 DEFER 并附未产出有效结果的 hint,为真则 unit=verdict_of(res.get("content")),随后填 transport/attest/result_ok/waited_s 并 _log。
768
- def review(*, prompt: str = "", role: str = REFLECT, digest=None, dialog: str = "",
769
- reflect_rows="", node_id: str = "", jobs: str = "", model: str = "",
770
- timeout_s: int = DEFAULT_TIMEOUT_S, allow_degrade: bool = False,
771
- channel: str = "", wait_s: float = DEFAULT_TIMEOUT_S, blocking: bool = True,
772
- cg=None, actor: str = "", autostart: bool = False) -> dict:
773
- """复核主入口:**蜂巢优先 → 提示配置 → 端子代理降级**(三态各自如实返回)。
774
-
775
- 返回统一形态:{state, role, node_id, transport, unit, attest, prompt, job_id, hint}
776
- - state=hive :已派发;blocking=True 时等终态并给出 unit/attest;否则只给 job_id
777
- - state=configure:**未派发**,hint 为配置指引(使用者裁定:不可用即提示配置)
778
- - state=subagent :**未派发**,返回 prompt 包供宿主子代理执行并回填
779
- """
780
- text = prompt or prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows)
781
- pr = probe(jobs, model, allow_degrade=allow_degrade, channel=channel)
782
- base = {"role": role, "node_id": node_id, "prompt": text,
783
- "transport": None, "unit": None, "attest": None,
784
- "job_id": None, "hint": pr.get("hint") or "", "channel": pr.get("channel") or "",
785
- "degrade": {"channel": channel or "harness-subagent",
786
- "how": "宿主子代理执行 prompt → 裁决经 verdicts 回填 attest"}}
787
- if pr["state"] == SUBAGENT:
788
- return {"state": SUBAGENT, **base,
789
- "degrade": {"available": True, "channel": channel or "harness-subagent",
790
- "how": "把 prompt 交给宿主子代理,取其 JSON 裁决后调 "
791
- "cg(op=ccg, action=attest, verdict=<accept|drop|defer>, "
792
- "verifier=subagent:<role>:<channel>)"}}
793
- if pr["state"] == CONFIGURE:
794
- return {"state": CONFIGURE, **base,
795
- "degrade": {"available": True, "channel": channel or "harness-subagent",
796
- "how": "① 按 hint 配置蜂巢后重试;② 或带 allow_degrade=true 降级子代理"}}
797
- if autostart and not serve_state(jobs)["alive"]:
798
- pr["autostart"] = autostart_serve(jobs)
799
- sub = submit(prompt=text, role=role, jobs=jobs, model=model, timeout_s=timeout_s,
800
- cg=cg, actor=actor)
801
- if not sub.get("ok"):
802
- return {"state": CONFIGURE, **base, "hint": (pr.get("hint") or "") + "\n" + str(sub.get("error"))}
803
- out = {"state": HIVE, **base, "job_id": sub["job_id"], "unit_role": role,
804
- "model": sub.get("model")}
805
- if not blocking:
806
- return out
807
- res = wait(sub["job_id"], jobs=jobs, timeout_s=wait_s)
808
- unit = verdict_of(res.get("content")) if res.get("ok") else {
809
- "verdict": DEFER, "reason": res.get("error") or "单元未返回可用结果",
810
- "slot_corrections": {}, "parsed": False}
811
- out["unit"] = unit
812
- out["transport"] = transport_name(HIVE, role, sub["job_id"])
813
- out["attest"] = to_attest_args(unit, state=HIVE, role=role, job_id=sub["job_id"])
814
- out["result_ok"] = bool(res.get("ok"))
815
- out["waited_s"] = res.get("waited_s")
816
- if not res.get("ok"):
817
- out["hint"] = "蜂巢 job 未产出有效结果:%s(裁决按 DEFER 处理,未假装通过)" % res.get("error")
818
- _log(cg, {"action": "review", "job_id": sub["job_id"], "role": role,
819
- "node_id": node_id, "actor": actor, "unit_verdict": unit.get("verdict"),
820
- "result_ok": bool(res.get("ok"))})
821
- return out
822
-
823
-
824
- # ---------------------------------------------------------------- serve 拉起(显式)
825
-
826
- # 生效条件:serve_state(jobs_dir(jobs)) 已 alive 时返回 started=False 的“serve 存活”;否则 exe_path() 未被 isfile 命中时返回 started=False 并提示先 cargo build --release;否则以 detached/新会话 Popen 拉起 exe serve --jobs jd 并把 stdout/stderr 写入 jd/_serve.log,Popen 抛 OSError 时返回 started=False 的拉起失败;拉起后在 float(wait_s) 内轮询到 alive 返回 started=True 的“serve 已拉起”,轮询超时仍返回 started=True 但标注心跳未就绪。
827
- def autostart_serve(jobs: str = "", wait_s: float = 5.0) -> dict:
828
- """**显式**拉起 serve(默认不启用;使用者裁定:不可用即提示配置)。
829
-
830
- 形态同 hive_mcp._ensure_serve:detached + 独立日志,不阻塞调用方。
831
- """
832
- jd = jobs_dir(jobs)
833
- if serve_state(jd)["alive"]:
834
- return {"started": False, "note": "serve 存活"}
835
- exe = exe_path()
836
- if not os.path.isfile(exe):
837
- return {"started": False, "note": "未找到可执行文件 %s——先 cargo build --release" % exe}
838
- kwargs = {}
839
- if os.name == "nt":
840
- kwargs["creationflags"] = subprocess.DETACHED_PROCESS | subprocess.CREATE_NO_WINDOW
841
- else:
842
- kwargs["start_new_session"] = True
843
- try:
844
- os.makedirs(jd, exist_ok=True)
845
- with open(os.path.join(jd, "_serve.log"), "ab") as logf:
846
- subprocess.Popen([exe, "serve", "--jobs", jd], stdout=logf, stderr=logf,
847
- stdin=subprocess.DEVNULL, **kwargs)
848
- except OSError as exc:
849
- return {"started": False, "note": "拉起失败:%s: %s" % (type(exc).__name__, exc)}
850
- t0 = time.time()
851
- while time.time() - t0 < float(wait_s):
852
- if serve_state(jd)["alive"]:
853
- return {"started": True, "note": "serve 已拉起"}
854
- time.sleep(0.1)
855
- return {"started": True, "note": "serve 已拉起(心跳未就绪,稍后自愈)"}
856
-
857
-
858
- # 生效条件:返回 dict 的 ok=p["state"]==HIVE,其中 p=plan(jobs)(model/fresh_s/allow_degrade/channel 全走默认),state/serve_alive/serve_age_s/chain/hint/model 取自该 p;jobs_dir 取 jobs_dir(jobs),exe_found 与 exe_path 取 exe_path() 是否被 isfile 命中,model_set=bool(model_name())(无参,读 ENV_MODEL),api_key_set=bool(os.environ.get(ENV_API_KEY)),env 记录 ENV_JOBS_DIR 与 ENV_MODEL 的原值。
859
- def doctor(jobs: str = "") -> dict:
860
- """能力体检(形态对齐 hive_doctor):判活 + exe + 模型 + 优先级链。"""
861
- jd = jobs_dir(jobs)
862
- p = plan(jobs)
863
- return {"ok": p["state"] == HIVE, "state": p["state"], "jobs_dir": jd,
864
- "serve_alive": p["serve"]["alive"], "serve_age_s": p["serve"]["age_s"],
865
- "exe_found": os.path.isfile(exe_path()), "exe_path": exe_path(),
866
- "model_set": bool(model_name()), "model": p["model"],
867
- "api_key_set": bool(os.environ.get(ENV_API_KEY)),
868
- "env": {"HIVE_JOBS_DIR": os.environ.get(ENV_JOBS_DIR, ""),
869
- "MDCG_UNIT_MODEL": os.environ.get(ENV_MODEL, "")},
1
+ # -*- coding: utf-8 -*-
2
+ """units.py · 复核单元接线层:蜂巢优先 → 提示配置 → harness 端子代理降级。
3
+
4
+ 定位(与 audit.py 同一条架构约束):**能力不在认知图内**。本模块不做智能判定,
5
+ 只做三件事:选通道(probe/plan)→ 派发请求(submit/wait/run)→ 记账(_units.jsonl)。
6
+
7
+ 使用者裁定(2026-09-16,第 17 条精神):编译器(ccgc)的复核**优先使用蜂巢的
8
+ 反思单元 / 验证单元**(reflect / verify,与 crosscheck.REFLECT_UNIT/VERIFY_UNIT 同值,
9
+ 不新造角色名);蜂巢不可用 → **提示使用者配置**(给出可照做的构建/启动/环境变量命令);
10
+ 或经显式 allow_degrade=True 降级到 **harness 端子代理**(宿主 agent 派发,裁决经
11
+ crosscheck 同款 verdicts 通道回填)。理由:使用者的复核是昂贵的——重活交给可并行的
12
+ 外部单元,agent 本体只做编排与记账。
13
+
14
+ 蜂巢契约(真源 hive/README.md + hive/hive_mcp/mcp_server.py;**复制契约不 import**,
15
+ 保持 md_cg 对 hive 零依赖,与 ccgc「同款语义就地实现防 import 环」惯例一致):
16
+ jobs 目录 = $HIVE_JOBS_DIR | <repo>/hive/jobs
17
+ serve 判活 = **三层**:jobs/_serve.json 的 ts(毫秒)距今 < FRESH_S(15s)
18
+ ∧ pid 存活 ∧ 该 pid 是本程序
19
+ (同 hive/serve_start.serve_alive;四路口径由
20
+ hive/test_serve_entry.py 机械守卫)
21
+ job 目录 = jobs/<job_id>/{spec.json,status.json,result.json,kill}
22
+ job_id = 本模块自造旧形态 h<java_ms>_<uuid6>(`_job_id`,**不是** `_submit` 同款);
23
+ hive 提交面自 id 契约 v2(B8)起为四槽 h_<身份>_<任务>_<单元>_<编号>,由
24
+ Rust 侧 `hive alloc-id` 分配——两形态都过 job.rs::valid_job_id(存量零迁移)
25
+ id 字符判据 = **区块白名单**:唯一真源 hive/id_charset_blocks.txt 的区间并集
26
+ ([`_valid_job_id`];本模块**读这份数据文件**、不 import hive,
27
+ 与 job.rs / mcp_server.py 三处共读同一份 ⇒ 不查任何 Unicode 属性库,
28
+ 两侧版本差结构性不可能)。本闸**有意保留**两处放宽(既有对外契约):
29
+ 不要求 h 前缀、允许 `-`;拒收面(零宽/双向控制/控制字符/路径成分/尾点/
30
+ 首尾空白/Windows 保留设备名)逐条显式断,不靠「白名单外顺带拒」。
31
+ result.json = {"ok":true,"content":...} | {"ok":false,"error":...}
32
+ 终态 = done | error | timeout | killed
33
+ 拉起 serve = <repo>/hive/target/release/hive serve --jobs <jobs>(detached)
34
+
35
+ 边界(诚实声明,不猜测):
36
+ · 本模块**不产生裁决**,只搬运;裁决由外部单元负责。
37
+ · 契约漂移:hive 侧协议若变更,本模块以「无 result / 超时」如实失败,不假装成功。
38
+ · 默认**不自动拉起 serve**(使用者裁定:不可用即提示配置);autostart=True 才拉起。
39
+ """
40
+ from __future__ import annotations
41
+
42
+ import json
43
+ import os
44
+ import re
45
+ import subprocess
46
+ import time
47
+ import uuid
48
+
49
+ HIVE, SUBAGENT, CONFIGURE = "hive", "subagent", "configure"
50
+ STATES = (HIVE, SUBAGENT, CONFIGURE)
51
+
52
+ REFLECT, VERIFY = "reflect", "verify" # 同 crosscheck.REFLECT_UNIT/VERIFY_UNIT
53
+ ROLES = (REFLECT, VERIFY)
54
+
55
+ SERVE_FILE, SPEC_FILE = "_serve.json", "spec.json"
56
+ STATUS_FILE, RESULT_FILE, KILL_FILE = "status.json", "result.json", "kill"
57
+ LOG_NAME = "_units.jsonl"
58
+ TERMINAL_STATES = ("done", "error", "timeout", "killed")
59
+ #: serve 心跳新鲜窗口(秒)。**须与 hive/serve_start.FRESH_S 同值**——本模块
60
+ #: 只持有「判活的第 4 处实现」(复制契约不 import hive),阈值/判据结构若与
61
+ #: 权威漂移,会在通道选择面复现 v13 的「假存活」病类(v14 缺陷 E:
62
+ #: 旧值 5.0 vs 权威 15,serve 崩溃后 ≤5s 窗口内判「存活」→ 选 hive 通道 →
63
+ #: 提交的 job 永远无人处理)。守卫:hive/test_serve_entry.py。
64
+ FRESH_S, DEFAULT_TIMEOUT_S, DEFAULT_POLL_S = 15.0, 120, 1.0
65
+ #: 复核委派的 completion 预算。**必须对齐统一默认(文档:最大输出 200000)**——
66
+ #: 该模型 reasoning 与正文**共享 completion 预算**,小预算会把正文吃光并静默返回空正文:
67
+ #: 实测 2048 → reasoning 2048 / content 空;16384 → 时好时坏;200000 → 正常出裁决。
68
+ DEFAULT_MAX_TOKENS = 200000
69
+
70
+ ENV_JOBS_DIR, ENV_EXE = "HIVE_JOBS_DIR", "HIVE_EXE"
71
+ ENV_MODEL, ENV_API_KEY = "MDCG_UNIT_MODEL", "HIVE_API_KEY"
72
+
73
+ ACCEPT, REJECT, DEFER, BLINDSPOT = "ACCEPT", "REJECT", "DEFER", "BLINDSPOT"
74
+ _VERDICT_MAP = {
75
+ "accept": ACCEPT, "accepted": ACCEPT, "keep": ACCEPT, "pass": ACCEPT,
76
+ "ok": ACCEPT, "approve": ACCEPT,
77
+ "drop": REJECT, "reject": REJECT, "rejected": REJECT, "deny": REJECT, "fail": REJECT,
78
+ "defer": DEFER, "deferred": DEFER, "unsure": DEFER, "unclear": DEFER, "skip": DEFER,
79
+ "blindspot": BLINDSPOT, "blind": BLINDSPOT,
80
+ }
81
+
82
+
83
+ # 生效条件:无入参,恒返回模块 `__file__` 绝对路径上溯两级的目录(md_cg 的上一级),与 cwd 无关。
84
+ def repo_root() -> str:
85
+ """仓库根(md_cg 的上一级);不用 cwd——cwd 由宿主决定,不可作判据。"""
86
+ return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
87
+
88
+
89
+ # 生效条件:explicit 为真值时 d=explicit;explicit 为空串等假值而 ENV_JOBS_DIR 有真值时 d=该环境变量;两者皆假值时 d=repo_root()/hive/jobs;最终返回 os.path.abspath(d)。
90
+ def jobs_dir(explicit: str = "") -> str:
91
+ d = explicit or os.environ.get(ENV_JOBS_DIR) or os.path.join(repo_root(), "hive", "jobs")
92
+ return os.path.abspath(d)
93
+
94
+
95
+ # 生效条件:ENV_EXE 有真值时原样返回该值;ENV_EXE 缺失或为空串时返回 repo_root()/hive/target/release/ 下按 os.name=="nt" 取 hive.exe、否则取 hive 的拼接路径。
96
+ def exe_path() -> str:
97
+ exe = os.environ.get(ENV_EXE)
98
+ if exe:
99
+ return exe
100
+ return os.path.join(repo_root(), "hive", "target", "release",
101
+ "hive.exe" if os.name == "nt" else "hive")
102
+
103
+
104
+ # 生效条件:explicit 为真值时取 explicit,否则取 ENV_MODEL,两者皆假值时按空串,返回该结果 strip() 后的字符串(可为空串)。
105
+ def model_name(explicit: str = "") -> str:
106
+ """复核模型(LLM 委托型执行器的 spec.model 必填)。"""
107
+ return (explicit or os.environ.get(ENV_MODEL) or "").strip()
108
+
109
+
110
+ # 生效条件:pid 为 int 且大于 0 时(否则 False),os.name 为 "nt" 时返回 _tasklist_row(pid) 是否非 None,非 "nt" 时 os.kill(pid, 0) 不抛 OSError 返回 True、抛 OSError 返回 False。
111
+ def pid_alive(pid) -> bool:
112
+ """该 pid **号**是否存在(Windows tasklist 精确列比对 / unix `kill -0`)。
113
+
114
+ 只回答「这个号有没有进程」——**不足以判定「serve 还在跑」**(见
115
+ `pid_is_self_program`)。实现与 hive/serve_start.pid_alive 同口径。
116
+ """
117
+ if not isinstance(pid, int) or pid <= 0:
118
+ return False
119
+ if os.name == "nt":
120
+ return _tasklist_row(pid) is not None
121
+ try:
122
+ os.kill(pid, 0)
123
+ return True
124
+ except OSError:
125
+ return False
126
+
127
+
128
+ # 生效条件:对传入 pid 执行 tasklist /FO CSV 后,在其 stdout 中遇到的第一个按 '","' 切分、列数≥2 且第 2 列 strip 再 strip('"') 后等于 str(pid) 的行即返回 [映像名, pid 字符串],无此行或 subprocess.run 抛 OSError 时返回 None。
129
+ def _tasklist_row(pid):
130
+ """Windows:查该 pid 的 tasklist 行 → [映像名, pid 字符串];查不到返回 None。
131
+
132
+ 按列精确比对,**不用子串包含**——子串会让 pid=441 被 4410 命中(假存活)。
133
+ """
134
+ try:
135
+ # 显式 utf-8 + replace:只消费 ASCII 的 pid 列,但**不依赖 locale**——
136
+ # locale 口径与「后代写 UTF-8」不一致时读线程会崩(见 test_subproc_encoding.py)。
137
+ # P2-16(批次 30):timeout=10——tasklist 挂起曾永久阻塞判活路径。
138
+ # stdin=subprocess.DEVNULL(issue #63 同批加固):不指定 stdin 时子进程
139
+ # 继承父进程 stdin(常驻宿主下是 JSON-RPC 活管道)——判活路径不得因
140
+ # 子进程读 stdin 而悬挂;形态对齐 `md_cg/run_tests.py:105`。
141
+ r = subprocess.run(["tasklist", "/FI", f"PID eq {pid}", "/NH", "/FO", "CSV"],
142
+ capture_output=True, text=True, stdin=subprocess.DEVNULL,
143
+ encoding="utf-8", errors="replace", timeout=10)
144
+ except (OSError, subprocess.SubprocessError):
145
+ return None
146
+ for line in (r.stdout or "").splitlines():
147
+ cols = line.split('","')
148
+ if len(cols) >= 2 and cols[1].strip().strip('"') == str(pid):
149
+ return [cols[0].strip().strip('"'), cols[1].strip().strip('"')]
150
+ return None
151
+
152
+
153
+ # 生效条件:exe_path() 的 basename 小写非空且 pid 为 int 大于 0 时(否则 False),"nt" 下要求 _tasklist_row(pid) 非空且映像名小写等于该 basename,非 "nt" 下要求 /proc/<pid>/cmdline 首个 b"\x00" 前 token 的 basename 小写等于它(读取抛 OSError 则 False)。
154
+ def pid_is_self_program(pid) -> bool:
155
+ """该 pid 是否**就是本程序**(同映像名)——pid 号会被无关进程复用。
156
+
157
+ 与 hive/serve_start.pid_is_self_program 同口径(复制契约)。零依赖边界:
158
+ 拿不到映像名返回 False(宁可放行启动,也不误报「已有 serve 在跑」)。
159
+ """
160
+ want = os.path.basename(exe_path()).lower()
161
+ if not want or not isinstance(pid, int) or pid <= 0:
162
+ return False
163
+ if os.name == "nt":
164
+ row = _tasklist_row(pid)
165
+ return bool(row) and row[0].lower() == want
166
+ try:
167
+ with open(f"/proc/{pid}/cmdline", "rb") as f:
168
+ first = f.read().split(b"\x00")[0]
169
+ except OSError:
170
+ return False
171
+ return os.path.basename(first.decode("utf-8", "replace")).lower() == want
172
+
173
+
174
+ # 生效条件:以 jobs_dir(jobs) 下的 SERVE_FILE 为心跳路径——该路径不被 isfile 命中时返回 exists/alive 均 False 的未启动 reason;命中但 open/json.load 抛 OSError 或 ValueError 时返回不可读 reason;解析成功后按**三层判据**(age < fresh_s ∧ pid_alive(pid) ∧ pid_is_self_program(pid))定 alive,回填 age_s/pid/raw 与逐层明细及失败原因。
175
+ def serve_state(jobs: str = "", fresh_s: float = FRESH_S) -> dict:
176
+ """serve 判活:**三层**(心跳新鲜 ∧ pid 存活 ∧ 该 pid 是本程序)。
177
+
178
+ 与 `hive/serve_start.serve_alive` 同口径(同值 FRESH_S=15s、同三层判据)。
179
+ v14 缺陷 E:旧实现只判 ts 新鲜度且阈值 5s——双漂移,serve 崩溃后
180
+ ≤5s 内判「存活」会让 `probe()` 选 hive 通道(提交的 job 永远无人处理),
181
+ 这正是 v13「假存活」病类从守卫面搬到了**通道选择面**。
182
+ """
183
+ jd = jobs_dir(jobs)
184
+ p = os.path.join(jd, SERVE_FILE)
185
+ out = {"jobs_dir": jd, "heartbeat": p, "exists": os.path.isfile(p),
186
+ "alive": False, "age_s": None, "pid": None, "reason": ""}
187
+ if not out["exists"]:
188
+ out["reason"] = "未见 _serve.json 心跳(serve 未启动或 jobs 目录不对)"
189
+ return out
190
+ try:
191
+ with open(p, encoding="utf-8") as f:
192
+ hb = json.load(f)
193
+ except (OSError, ValueError) as exc:
194
+ out["reason"] = "心跳不可读:%s: %s" % (type(exc).__name__, exc)
195
+ return out
196
+ age = time.time() - ((hb.get("ts") or 0) / 1000.0)
197
+ pid = hb.get("pid")
198
+ fresh_ok = age < float(fresh_s)
199
+ pid_ok = pid_alive(pid)
200
+ ident_ok = pid_is_self_program(pid)
201
+ out.update({"age_s": round(age, 3), "pid": pid, "raw": hb,
202
+ "fresh": bool(fresh_ok), "pid_alive": bool(pid_ok),
203
+ "pid_is_self_program": bool(ident_ok)})
204
+ out["alive"] = bool(fresh_ok and pid_ok and ident_ok)
205
+ if out["alive"]:
206
+ out["reason"] = ""
207
+ elif not fresh_ok:
208
+ out["reason"] = "心跳过期 %.1fs(阈值 %ss)——serve 可能已退出" % (age, fresh_s)
209
+ elif not pid_ok:
210
+ out["reason"] = "心跳新鲜但 pid=%s 已不存在——serve 已退出" % (pid,)
211
+ else:
212
+ out["reason"] = ("心跳新鲜且 pid=%s 存活,但该 pid 不属于本程序"
213
+ "(非 %s)——pid 号被无关进程复用"
214
+ % (pid, os.path.basename(exe_path())))
215
+ return out
216
+
217
+
218
+ # 生效条件:jobs 仅经 jobs_dir(jobs) 用于填充指引里的 jobs 路径;reason 为假值时文案首行取“serve 未存活”,否则取 reason 原文;返回模板固定嵌入 exe_path() 的目录与路径、ENV_API_KEY、ENV_MODEL、jd、jd 下的 SERVE_FILE 与 int(FRESH_S)。
219
+ def setup_hint(jobs: str = "", reason: str = "") -> str:
220
+ """不可用时给使用者看的**配置指引**(含降级指引)——提示即责任,须可照着做。"""
221
+ jd = jobs_dir(jobs)
222
+ return ("蜂巢不可用:%s\n"
223
+ " [A 配置蜂巢(推荐,第 17 条)]\n"
224
+ " 1) cd %s && cargo build --release\n"
225
+ " 2) set %s=<LLM密钥>\n 3) set %s=<复核模型名>\n"
226
+ " 4) 启动:%s serve --jobs \"%s\"(或 hive_spawn 自动拉起)\n"
227
+ " 判活判据:%s 的 ts 距今 < %ss\n"
228
+ " [B 降级 harness 端子代理]\n"
229
+ " 重发本请求并带 allow_degrade=true:本模块返回复核请求包(prompt),\n"
230
+ " 由宿主子代理执行后经 verdicts 回填裁决。"
231
+ % (reason or "serve 未存活", os.path.dirname(exe_path()), ENV_API_KEY,
232
+ ENV_MODEL, exe_path(), jd, os.path.join(jd, SERVE_FILE), int(FRESH_S)))
233
+
234
+
235
+ # 生效条件:先取 st=serve_state(jobs, fresh_s) 与 mdl=model_name(model);st["alive"] 为真且 mdl 非空时返回 state=HIVE;否则 allow_degrade 为真时返回 state=SUBAGENT 且 channel 取 channel 或 "harness-subagent";否则返回 state=CONFIGURE、transport=None 并附 setup_hint(jobs, why)。
236
+ def probe(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
237
+ allow_degrade: bool = False, channel: str = "") -> dict:
238
+ """三级能力探测:hive(可派发)→ configure(提示配置)→ subagent(显式降级)。
239
+
240
+ 判据只认**心跳 + 模型名**两项硬前提;缺任一即如实降级,绝不用相似度
241
+ (如「hive 目录存在」)冒充可用(资格由条件证据裁决,不由相似度裁决)。
242
+ """
243
+ st = serve_state(jobs, fresh_s)
244
+ mdl = model_name(model)
245
+ if st["alive"] and mdl:
246
+ return {"state": HIVE, "transport": HIVE, "model": mdl, "jobs_dir": st["jobs_dir"],
247
+ "serve": st, "channel": "", "hint": ""}
248
+ why = st["reason"] if not st["alive"] else "serve 存活但未配置复核模型(%s)" % ENV_MODEL
249
+ if allow_degrade:
250
+ return {"state": SUBAGENT, "transport": SUBAGENT, "model": mdl,
251
+ "jobs_dir": st["jobs_dir"], "serve": st,
252
+ "channel": channel or "harness-subagent",
253
+ "hint": "已按 allow_degrade 降级到 harness 端子代理:请把 prompt 交给宿主子代理,"
254
+ "裁决经 verdicts 回填(蜂巢不可用原因:%s)" % why}
255
+ return {"state": CONFIGURE, "transport": None, "model": mdl,
256
+ "jobs_dir": st["jobs_dir"], "serve": st, "channel": "",
257
+ "hint": setup_hint(jobs, why)}
258
+
259
+
260
+ # 生效条件:state/transport/model/jobs_dir/serve/channel/hint 全部直接取自 probe(jobs, model, fresh_s, allow_degrade, channel) 的对应键,本函数不另做判活或模型判断,仅在 chain 文案中固定引用 int(FRESH_S) 与 ENV_MODEL。
261
+ def plan(jobs: str = "", model: str = "", fresh_s: float = FRESH_S,
262
+ allow_degrade: bool = False, channel: str = "") -> dict:
263
+ """优先级链自描述(供 cg op=ccg action=units 与审计查看)。"""
264
+ p = probe(jobs, model, fresh_s, allow_degrade, channel)
265
+ return {"state": p["state"], "transport": p["transport"], "model": p["model"],
266
+ "jobs_dir": p["jobs_dir"], "serve": p["serve"], "channel": p["channel"],
267
+ "chain": [
268
+ {"order": 1, "transport": HIVE, "action": "派发 reflect/verify 单元并等待 result.json",
269
+ "when": ("jobs/_serve.json 心跳 < %ss 且(%s 已配置 **或调用方显式传 model**)"
270
+ % (int(FRESH_S), ENV_MODEL))},
271
+ {"order": 2, "transport": CONFIGURE, "action": "返回配置指引(不自动拉起、不假装通过)",
272
+ "when": "蜂巢不可用"},
273
+ {"order": 3, "transport": SUBAGENT, "action": "返回复核请求包,由 harness 端子代理执行并回填",
274
+ "when": "调用方显式 allow_degrade=True"},
275
+ ],
276
+ "hint": p["hint"]}
277
+
278
+
279
+ # ---------------------------------------------------------------- 派发与收取
280
+
281
+ # 生效条件:无入参,恒返回 "h"+int(time.time()*1000)+"_"+uuid.uuid4().hex 前 6 位组成的字符串。
282
+ def _job_id() -> str:
283
+ """本地 id 生成(旧形态 `h<毫秒>_<uuid 前 6 位>`):serve 侧按 'h' 前缀识别任务目录。
284
+
285
+ 诚实边界(id 契约 v2 · C2 同类措辞订正):**本函数已不是 `_submit` 的同款实现**
286
+ ——`hive/hive_mcp/mcp_server.py::_submit` 自 B8 起调 Rust 侧 `hive alloc-id` 分配
287
+ `h_<身份>_<任务>_<单元>_<编号>`,**不再自造 id**;本模块是 md_cg 的复核派发面,
288
+ **不在 B8 点名的改动面**(契约只列 CLI / MCP 提交面 / orch 透传),故保留旧形态。
289
+ 旧形态 id 在新契约下**仍然合法**(存量零迁移:`job.rs::valid_job_id` 收),故此处
290
+ 不闯闸、不破坏 serve 领取;但它绕过了分配器的独占创建与五单元闭集 ⇒ 与「分配器
291
+ 唯一实现在 Rust 侧」(契约 §五 裁决 3)不齐,宜单独裁决(牵动 md_cg 派发/等待链
292
+ 语义与其守卫 `md_cg/test_units_poll.py`,不在本批「只论证订正」的范围内)。
293
+ """
294
+ return "h%d_%s" % (int(time.time() * 1000), uuid.uuid4().hex[:6])
295
+
296
+
297
+ # ------------------------------------------------ id 字符判据(区块白名单 · 唯一真源)
298
+
299
+ #: 区块表数据文件(**唯一真源**,与 `hive/src/job.rs` / `hive/hive_mcp/mcp_server.py`
300
+ #: **共读同一份数据**;本模块**读数据文件**而不是 import hive ⇒ 不破零依赖家法)。
301
+ _CHARSET_BLOCKS_REL = "hive/id_charset_blocks.txt"
302
+ _MAX_CP = 0x10FFFF
303
+
304
+
305
+ # 生效条件:text 为表文件全文时返回区间列表 [(起, 止)]——**唯一解析配方**(与 Rust
306
+ # `job.rs::parse_id_charset_blocks`、`mcp_server._parse_charset_blocks` 同一条,不许各写
307
+ # 一套):每行取 `#` 之前部分后 strip;空行跳过;余下 split('-') 两段 int(x, 16)。
308
+ # 任一行不合形态 / 越界 / 逆序 / 未归并到最小 / 空表 → 抛 ValueError(fail-closed:
309
+ # 绝不静默跳过坏行——跳过一行的表是另一张表,三处读者随即不同判)。
310
+ def _parse_charset_blocks(text: str) -> list:
311
+ """区块表解析(唯一配方)。"""
312
+ out: list = []
313
+ for lineno, line in enumerate(text.split("\n"), 1):
314
+ body = line.split("#", 1)[0].strip()
315
+ if not body:
316
+ continue
317
+ parts = body.split("-")
318
+ if len(parts) != 2:
319
+ raise ValueError("区块表第 %d 行不是 LO-HI 形态:%r" % (lineno, line))
320
+ lo, hi = int(parts[0], 16), int(parts[1], 16)
321
+ if not (0 <= lo <= hi <= _MAX_CP):
322
+ raise ValueError("区块表第 %d 行区间非法:%r" % (lineno, line))
323
+ if out and lo <= out[-1][1] + 1:
324
+ raise ValueError("区块表第 %d 行未归并到最小(相邻/相交/乱序):%r"
325
+ % (lineno, line))
326
+ out.append((lo, hi))
327
+ if not out:
328
+ raise ValueError("区块表解析出空区间集(fail-closed:空表绝不放行)")
329
+ return out
330
+
331
+
332
+ # 生效条件:无入参,返回 (区间表, 错误说明)——文件可读且解析通过 → (tuple 区间表, None);
333
+ # 表缺失 / 不可读 / 解析失败 → ((), 原因)。后两者让判据 fail-closed(对一切字符 False)。
334
+ def _load_charset_blocks() -> tuple:
335
+ """**模块导入时读一次**(不做每调用 I/O);路径基准 = 本文件上溯两级(= 仓根)。"""
336
+ path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
337
+ "hive", "id_charset_blocks.txt")
338
+ try:
339
+ with open(path, encoding="utf-8") as fh:
340
+ text = fh.read()
341
+ except OSError as exc:
342
+ return (), "%s 不可读:%s" % (_CHARSET_BLOCKS_REL, exc)
343
+ try:
344
+ return tuple(_parse_charset_blocks(text)), None
345
+ except ValueError as exc:
346
+ return (), "%s 解析失败:%s" % (_CHARSET_BLOCKS_REL, exc)
347
+
348
+
349
+ #: 判据数据(模块导入时求值一次):区间表 + 读取/解析错误(错误非 None ⇒ 判据一律 False)。
350
+ CHARSET_BLOCKS, CHARSET_BLOCKS_ERROR = _load_charset_blocks()
351
+
352
+
353
+ # 生效条件:c 为单字符且其码点落在区间表内 → True;表缺失 / 坏行 / 空表 → False
354
+ # (fail-closed:绝不放行)。
355
+ def _charset_member(c: str) -> bool:
356
+ u = ord(c)
357
+ return any(lo <= u <= hi for lo, hi in CHARSET_BLOCKS)
358
+
359
+
360
+ # Windows 保留设备名(B4 拒收项;与 `job.rs::RESERVED_DEVICE_NAMES`、
361
+ # `mcp_server.RESERVED_DEVICE_NAMES` 逐项同集——md_cg 只复制这 22 个常量,**还是读数据
362
+ # 而不是 import hive**)。Win32 对**单个路径分量**做设备名解析且**忽略扩展名**
363
+ # (`CON.txt` 与 `CON` 同指设备),故比对的是「首个 `.` 之前」部分;比对**ASCII 大小写
364
+ # 不敏感**(不用 str.upper():它的 Unicode 折叠面比 Rust 的 eq_ignore_ascii_case 宽,
365
+ # 会让两侧分叉)。
366
+ RESERVED_DEVICE_NAMES = (
367
+ "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6",
368
+ "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6",
369
+ "LPT7", "LPT8", "LPT9",
370
+ )
371
+ _ASCII_UPPER = str.maketrans("abcdefghijklmnopqrstuvwxyz",
372
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZ")
373
+
374
+
375
+ # 生效条件:s 的「首个 `.` 之前」部分与任一保留设备名 **ASCII 大小写不敏感**相等 → True
376
+ # (含 `CON.txt` 这类带扩展名形态)——与 rust `job::is_reserved_device_name` 同判。
377
+ def _is_reserved_device_name(s: str) -> bool:
378
+ base = s.split(".")[0].translate(_ASCII_UPPER)
379
+ return base in RESERVED_DEVICE_NAMES
380
+
381
+
382
+ # 生效条件:jid 为 str、长度 1..128、strip() 前后无差异(首尾无空白)、首尾字符都不是
383
+ # "."(拒 "."/".."/"..." 与 Win32 会剥尾点的 "abc." 形态)、逐字符过显式拒收集合后落在
384
+ # **区块白名单**([`_charset_member`],唯一真源 `hive/id_charset_blocks.txt`,与 hive 两侧
385
+ # 共读同一份数据)或属结构字符 `_` `-` `.`,且整 id 与其按 `_` 分段的任一段都不是
386
+ # Windows 保留设备名、且按 `_` 分段的**任一段都不等于** `.` 或 `..`(c7 段级)时返回 True,
387
+ # 否则 False。
388
+ def _valid_job_id(jid) -> bool:
389
+ r"""job_id 结构闸(N178,2026-09-28;2026-09-30 字符集判据换面为**区块白名单**)。
390
+
391
+ 同族家法:`hive/hive_mcp/mcp_server.py::_valid_job_id`、
392
+ `hive/src/job.rs::valid_job_id`(三处**共读同一份区块表**,不是三套常量)。
393
+ 本闸**保留**的既有放宽(都是既有对外契约,**不得**为「同口径」收紧):
394
+ · **不要求 "h" 前缀**——`md_cg/test_units_poll.py` 的 "j_empty"/"j_good"/
395
+ "j_fail" 是本模块对外契约(poll 面向任意宿主派发器写出的 job 目录),前缀
396
+ 收紧会误杀;
397
+ · 允许 `-`(hive 侧拒它:不在区块表内、也不是它的结构字符);
398
+ · 长度上限 128、首尾无空白、首尾非点(拒 "."/".."/"..." 与 "x." 尾点形态)
399
+ 一并保留。
400
+ 非 str 一律拒(**不** str() 归一:与 legacy P3 同纪律,未校验的强制转换会把对象
401
+ 形态洗成合法路径成分)。
402
+ 字符类判据 = **区块白名单**(与 hive 两侧同源)——白名单外的一切字符一律拒。
403
+ 放宽带来的静默风险**逐条显式挡住**(c9:「isalpha」类判据下 Cf/Cc 天然不入,但
404
+ **不能靠这个**):零宽 U+200B..U+200F/U+2060/U+FEFF、双向控制
405
+ U+202A..U+202E/U+2066..U+2069、控制字符(C0/DEL/C1)**逐条显式判**;`/` `\` `:`
406
+ 与 NUL 同样显式拒(路径成分:相对父段 "../outside"、分隔符、盘符/ADS、绝对路径
407
+ 会被 os.path.join 吸附);Windows 保留设备名(CON/PRN/AUX/NUL/COM1..9/LPT1..9,
408
+ 含 `CON.txt` 带扩展名形态与 ASCII 大小写变体)**整 id 与按 `_` 分段的任一段**逐名
409
+ 显式拒——旧 ASCII 白名单下 `CON` 这类全字母 id 是**放行**的,故这是本闸换面时
410
+ **收紧**的那一面(与 hive 两侧同集同判,语料 80-84 行逐例钉死)。
411
+ 表缺失 / 坏表 ⇒ 判据一律 False(fail-closed,绝不放行)。
412
+ 本闸本批**新增收紧**(c7,2026-09-30):按 `_` 分段的**任一段**等于 `.` 或 `..` 即拒
413
+ ——整串口径下 `h_.._x` / `h_a_.._b` 是被收的;段级是面向重构的纵深加固(段可能被当
414
+ 父目录段用),与 hive 两侧同判。范围只加这一条:空段(`h__x`)等形态不动。
415
+ """
416
+ if not isinstance(jid, str) or not jid or len(jid) > 128:
417
+ return False
418
+ if jid != jid.strip():
419
+ return False
420
+ if jid[0] == "." or jid[-1] == ".":
421
+ return False
422
+ for c in jid:
423
+ u = ord(c)
424
+ if u <= 0x1F or 0x7F <= u <= 0x9F or c in "/\\:":
425
+ return False # 控制字符(C0/DEL/C1,含 NUL)与路径成分(显式判,c9)
426
+ if "\u200b" <= c <= "\u200f" or c in ("\u2060", "\ufeff"):
427
+ return False # 零宽/不可见注入载体(显式判,c9)
428
+ if "\u202a" <= c <= "\u202e" or "\u2066" <= c <= "\u2069":
429
+ return False # 双向控制(显式判,c9)
430
+ if c in "_.-":
431
+ continue # 结构字符:槽分隔符 / 点(首尾点已在上方拒)/ 既有放宽的 `-`
432
+ if not _charset_member(c):
433
+ return False
434
+ # Windows 保留设备名(显式判,c7/c9):整 id(首个 `.` 之前部分,Win32 忽略扩展名)
435
+ # 与按 `_` 分段的**任一段**(Win32 的设备名解析是按路径分量做的)——与
436
+ # `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` 同集同判。
437
+ if _is_reserved_device_name(jid):
438
+ return False
439
+ if any(_is_reserved_device_name(seg) for seg in jid.split("_")):
440
+ return False
441
+ # 「. / ..」的**段级**判据(c7,2026-09-30 加固):按 `_` 分段,任一段等于 `.` 或 `..`
442
+ # 即拒——与 `job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` **三处同判**。
443
+ # 段级而非整串(本面原有的「首尾非点」只挡整串与尾点形态):id 的段可能被宿主当
444
+ # **目录名**或**父目录段**用(契约 §四.4「目录可作它的父段」)。现场定性:`h_.._x` /
445
+ # `h_a_.._b` 这类「含 `..` 段但不以点结尾」的 id 拼出的路径停在池内、不构成穿越 ⇒
446
+ # 面向重构的纵深加固。范围**只加这一条**:不拒空段(`h__x`)等未被裁定的形态。
447
+ if any(seg in (".", "..") for seg in jid.split("_")):
448
+ return False
449
+ return True
450
+
451
+
452
+ # 生效条件:无入参,返回 job_id 非法的结构化拒绝 dict(ok=False、state="invalid_job_id"、terminal=False、job_dir/content/status 均为 None、error 含非法 id 与本闸口径),字段集与 poll 的返回同构。
453
+ def _bad_job_id(job_id, *, where: str) -> dict:
454
+ """非法 job_id 的统一拒答(poll/wait/submit 同构,便于调用方机械判别)。"""
455
+ return {"job_id": job_id, "job_dir": None, "state": "invalid_job_id",
456
+ "terminal": False, "ok": False, "content": None, "status": None,
457
+ "error": ("job_id 非法:%r(%s)——job_id 须为**单个路径分量**:区块白名单"
458
+ "(hive/id_charset_blocks.txt)内的字母/数字,或结构字符 `_` `-` `.`;"
459
+ "首尾非点,不含 / \\ : 与控制/零宽/双向控制字符/NUL,"
460
+ "且整 id 与按 `_` 分段的任一段都不得是 Windows 保留设备名"
461
+ "(CON/PRN/AUX/NUL/COM1..9/LPT1..9,含 CON.txt 形态)"
462
+ "(N178:拒 ../victim 型越池读 result.json、"
463
+ "拒任意目录建目录写 spec.json)" % (job_id, where))}
464
+
465
+
466
+ # 生效条件:cg.root 与 cg.cg.root 都取不到真值时不写、直接返回 None;取到 root 时向 root/LOG_NAME 追加一行 rec(副本,setdefault ts)的 JSON,写入抛 OSError 时被吞掉静默返回 None。
467
+ def _log(cg, rec: dict) -> None:
468
+ """留痕 _units.jsonl(对齐 _crosscheck.jsonl / _backfill.jsonl 纪律)。"""
469
+ root = getattr(cg, "root", None) or getattr(getattr(cg, "cg", None), "root", None)
470
+ if not root:
471
+ return
472
+ try:
473
+ rec = dict(rec)
474
+ rec.setdefault("ts", int(time.time() * 1000))
475
+ with open(os.path.join(str(root), LOG_NAME), "a", encoding="utf-8") as f:
476
+ f.write(json.dumps(rec, ensure_ascii=False) + "\n")
477
+ except OSError:
478
+ pass
479
+
480
+
481
+ # 生效条件:role 不在 ROLES 时返回 ok=False 的未知角色 error;否则 model_name(model) 为空时返回 ok=False 的未配置复核模型;否则 str(prompt or "").strip() 为空时返回 ok=False 的 prompt 为空;否则落盘前先过 _valid_job_id 结构闸(未过返回 ok=False 的 job_id 非法,**不建目录不写文件**——N178:job_id 来源一旦不是 _job_id(),join 后就是「任意目录 + 生成名」的建目录/写文件原语);闸过则在 jobs_dir(jobs)/job_id 下写 spec.json 与 status.json(context_files 为真、temperature 非 None、extra 为真时才并入 spec),OSError 时返回 ok=False 的写入失败,全部成功返回 ok=True 与 job_id/job_dir/spec/model。
482
+ def submit(*, prompt: str, role: str = REFLECT, model: str = "", system_prompt: str = "",
483
+ context_files=None, timeout_s: int = DEFAULT_TIMEOUT_S,
484
+ max_tokens: int = DEFAULT_MAX_TOKENS, temperature=None, jobs: str = "",
485
+ actor: str = "", extra: dict = None, cg=None) -> dict:
486
+ """写一条 LLM 委托型 job(spec.json + status.json,形态同 _submit);只写文件不起进程。"""
487
+ if role not in ROLES:
488
+ return {"ok": False, "error": "未知复核角色:%r(可选 %s)" % (role, list(ROLES))}
489
+ mdl = model_name(model)
490
+ if not mdl:
491
+ return {"ok": False, "error": "未配置复核模型:请设 %s 或显式传 model" % ENV_MODEL}
492
+ if not str(prompt or "").strip():
493
+ return {"ok": False, "error": "prompt 为空"}
494
+ jd, job_id = jobs_dir(jobs), _job_id()
495
+ # N178(2026-09-28):**落盘前**过闸——makedirs 之后再过就等于已经建了目录。
496
+ if not _valid_job_id(job_id):
497
+ return {"ok": False, "job_dir": None, "job_id": job_id,
498
+ "error": _bad_job_id(job_id, where="submit 落点")["error"]}
499
+ d = os.path.join(jd, job_id)
500
+ spec = {"model": mdl, "user_prompt": str(prompt), "system_prompt": str(system_prompt or ""),
501
+ "timeout_s": int(timeout_s), "max_tokens": int(max_tokens),
502
+ "role": role, "unit_role": role}
503
+ if context_files:
504
+ spec["context_files"] = list(context_files)
505
+ if temperature is not None:
506
+ spec["temperature"] = temperature
507
+ if extra:
508
+ spec.update(extra)
509
+ try:
510
+ os.makedirs(d, exist_ok=True)
511
+ with open(os.path.join(d, SPEC_FILE), "w", encoding="utf-8") as f:
512
+ json.dump(spec, f, ensure_ascii=False)
513
+ with open(os.path.join(d, STATUS_FILE), "w", encoding="utf-8") as f:
514
+ json.dump({"job_id": job_id, "state": "pending",
515
+ "created_ts": int(time.time() * 1000), "started_ts": None,
516
+ "heartbeat_ts": None, "elapsed_s": 0.0, "timeout_s": int(timeout_s),
517
+ "model": mdl, "pid": None, "error": None}, f, ensure_ascii=False)
518
+ except OSError as exc:
519
+ return {"ok": False, "job_dir": d,
520
+ "error": "job 写入失败:%s: %s" % (type(exc).__name__, exc)}
521
+ _log(cg, {"action": "submit", "job_id": job_id, "role": role, "model": mdl,
522
+ "timeout_s": int(timeout_s), "actor": actor, "prompt_head": str(prompt)[:200]})
523
+ return {"ok": True, "job_id": job_id, "job_dir": d, "spec": spec,
524
+ "unit_role": role, "model": mdl}
525
+
526
+
527
+ # 生效条件:job_id 先过 _valid_job_id 结构闸(未过返回 state="invalid_job_id" 的结构化拒绝,**不触盘**——N178:修前 "../victim" 会被 join 成池外目录并读出其 result.json 全文);闸过时 jobs_dir(jobs)/job_id 不是目录返回 state=missing、terminal=False 的目录不存在 error;是目录时读 STATUS_FILE(读失败则 status 置 None)并用其 state 覆盖 state/terminal(state 属 TERMINAL_STATES 才 terminal=True);RESULT_FILE 被 isfile 命中则 terminal=True、state=st or "done",解析抛 OSError/ValueError 时提前返回该 error;解析为 dict 时取 ok/content/error/usage/model,且 ok 为真而 content 去空白为空时把 ok 改 False 并写空正文 error,解析为非 dict 时 ok=True 且 content 为原值。
528
+ def poll(job_id: str, jobs: str = "") -> dict:
529
+ """读 job 终态视图:**以 result.json 出现为终态主判据**,status.json 仅作辅助。"""
530
+ # N178(2026-09-28):调用方给的 job_id 是路径成分,**先过闸再 join**。
531
+ # 修前此处无闸,且 `str(job_id or "")` 还会把非 str 洗成合法成分。
532
+ if not _valid_job_id(job_id):
533
+ return _bad_job_id(job_id, where="poll 池路径成分")
534
+ d = os.path.join(jobs_dir(jobs), job_id)
535
+ out = {"job_id": job_id, "job_dir": d, "state": "missing", "terminal": False,
536
+ "ok": False, "content": None, "error": None, "status": None}
537
+ if not os.path.isdir(d):
538
+ out["error"] = "job 目录不存在:%s" % d
539
+ return out
540
+ sp = os.path.join(d, STATUS_FILE)
541
+ if os.path.isfile(sp):
542
+ try:
543
+ with open(sp, encoding="utf-8") as f:
544
+ out["status"] = json.load(f)
545
+ except (OSError, ValueError):
546
+ out["status"] = None
547
+ st = (out["status"] or {}).get("state")
548
+ if st:
549
+ out.update({"state": st, "terminal": st in TERMINAL_STATES})
550
+ rp = os.path.join(d, RESULT_FILE)
551
+ if os.path.isfile(rp):
552
+ out["state"] = st or "done"
553
+ out["terminal"] = True
554
+ try:
555
+ with open(rp, encoding="utf-8") as f:
556
+ res = json.load(f)
557
+ except (OSError, ValueError) as exc:
558
+ out["error"] = "result.json 不可读:%s" % type(exc).__name__
559
+ return out
560
+ if isinstance(res, dict):
561
+ out["ok"] = bool(res.get("ok"))
562
+ out["content"] = res.get("content")
563
+ out["error"] = res.get("error") or out["error"]
564
+ out["usage"] = res.get("usage")
565
+ out["model"] = res.get("model")
566
+ # 空正文**不得报成功**:reasoning 与正文共享 completion 预算,预算不足时
567
+ # job 仍自称 ok 但 content 为空 → 若不拦,会被误读成「复核单元无答复」
568
+ # (假死锁)。run() 早已有同等校验,此处补齐,消除两处口径不一致。
569
+ if out["ok"] and not str(out["content"] or "").strip():
570
+ out["ok"] = False
571
+ out["error"] = ("空正文:job 自称 ok 但 content 为空(多为 reasoning 吃尽"
572
+ "完成预算;提高 max_tokens,勿把预算不足当通道不可用)")
573
+ else:
574
+ out["ok"], out["content"] = True, res
575
+ return out
576
+
577
+
578
+ # 生效条件:job_id 未过 _valid_job_id 结构闸时**立即**返回 poll 的同一拒绝结构(N178:否则非法 id 会空转满 timeout_s 才超时返回——拒绝不该以等待为代价);闸过时循环 poll(job_id, jobs),结果 terminal 为真即补 waited_s 后返回;否则 time.time()-t0 >= float(timeout_s) 时返回 terminal=False、timeout=True 与超时 error;两者皆不满足则 sleep(float(poll_s)) 后重试(timeout_s=0 时首次 poll 非终态即超时返回)。
579
+ def wait(job_id: str, *, jobs: str = "", timeout_s: float = DEFAULT_TIMEOUT_S,
580
+ poll_s: float = DEFAULT_POLL_S) -> dict:
581
+ """阻塞等终态;超时如实返回(不假装成功、不强杀 job)。"""
582
+ if not _valid_job_id(job_id):
583
+ # N178(2026-09-28):fail-fast——复用 poll 的拒绝结构,绝不进轮询。
584
+ return poll(job_id, jobs)
585
+ t0 = time.time()
586
+ while True:
587
+ cur = poll(job_id, jobs)
588
+ if cur.get("terminal"):
589
+ cur["waited_s"] = round(time.time() - t0, 3)
590
+ return cur
591
+ if (time.time() - t0) >= float(timeout_s):
592
+ cur.update({"terminal": False, "timeout": True, "waited_s": round(time.time() - t0, 3),
593
+ "error": "等待超时 %.0fs(job 仍在 %s)" % (float(timeout_s),
594
+ cur.get("state"))})
595
+ return cur
596
+ time.sleep(float(poll_s))
597
+
598
+
599
+ # 生效条件:submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw) 的 ok 为假时返回 stage="submit" 的失败 dict(含 **sub);ok 为真时 wait(sub["job_id"], jobs=kw.get("jobs",""), timeout_s=wait_s),补 stage="wait"/job_id/unit_role/model,并把 ok 改为 res 的 ok 与 content 同时为真。
600
+ def run(*, prompt: str, role: str = REFLECT, cg=None, actor: str = "",
601
+ wait_s: float = DEFAULT_TIMEOUT_S, **kw) -> dict:
602
+ """submit + wait 组合(阻塞式复核,MCP action=review 主路径)。"""
603
+ sub = submit(prompt=prompt, role=role, cg=cg, actor=actor, **kw)
604
+ if not sub.get("ok"):
605
+ return {"ok": False, "stage": "submit", "error": sub.get("error"), **sub}
606
+ res = wait(sub["job_id"], jobs=kw.get("jobs", ""), timeout_s=wait_s)
607
+ res.update({"stage": "wait", "job_id": sub["job_id"], "unit_role": role,
608
+ "model": sub.get("model")})
609
+ res["ok"] = bool(res.get("ok")) and bool(res.get("content"))
610
+ return res
611
+
612
+
613
+ # ---------------------------------------------------------------- 裁决解析与搬运
614
+
615
+ _FENCE_RE = re.compile(r"```(?:json)?\s*(.+?)\s*```", re.S)
616
+
617
+
618
+ # 生效条件:raw 是 dict/list 时原样返回;否则取 str(raw or "").strip(),为空串(含 0/False/None 等假值)返回 None;否则依次尝试 _FENCE_RE 第 1 组、整段文本、首个 "{" 到末个 "}" 及首个 "[" 到末个 "]" 的切片,返回首个能 json.loads 成 dict 或 list 的候选;全部失败返回 None。
619
+ def _json_of(raw):
620
+ """从单元输出抽第一个 JSON 对象/数组(容忍 ```json 围栏与前后噪声)。"""
621
+ if isinstance(raw, (dict, list)):
622
+ return raw
623
+ text = str(raw or "").strip()
624
+ if not text:
625
+ return None
626
+ cands = []
627
+ m = _FENCE_RE.search(text)
628
+ if m:
629
+ cands.append(m.group(1))
630
+ cands.append(text)
631
+ for opener, closer in (("{", "}"), ("[", "]")):
632
+ i, j = text.find(opener), text.rfind(closer)
633
+ if 0 <= i < j:
634
+ cands.append(text[i:j + 1])
635
+ for c in cands:
636
+ try:
637
+ v = json.loads(c)
638
+ except ValueError:
639
+ continue
640
+ if isinstance(v, (dict, list)):
641
+ return v
642
+ return None
643
+
644
+
645
+ # 生效条件:data=_json_of(raw) 为 list 时取 data[0](仅当它是 dict,否则 None);非 dict 时返回 verdict=DEFER、parsed=False;dict 时 word 取 verdict/decision/state/result 中首个真值后 strip().lower(),_VERDICT_MAP.get(word) 为 None 时返回 DEFER、parsed=True 并带 corr 与 reason,命中时返回该裁决及 reason、slot_corrections(取自 slot_corrections/corrections,非 dict 则置 {})、checks、raw 前 500 字符。
646
+ def verdict_of(raw) -> dict:
647
+ """单元输出 → 裁决四态;解析不出 → DEFER(不猜测、不当通过)。"""
648
+ data = _json_of(raw)
649
+ if isinstance(data, list):
650
+ data = data[0] if data and isinstance(data[0], dict) else None
651
+ if not isinstance(data, dict):
652
+ return {"verdict": DEFER, "reason": "单元输出无法解析为裁决 JSON",
653
+ "slot_corrections": {}, "raw": str(raw)[:500], "parsed": False}
654
+ word = str(data.get("verdict") or data.get("decision") or data.get("state")
655
+ or data.get("result") or "").strip().lower()
656
+ reason = str(data.get("reason") or data.get("why") or data.get("detail") or "").strip()
657
+ corr = data.get("slot_corrections") or data.get("corrections") or {}
658
+ corr = corr if isinstance(corr, dict) else {}
659
+ got = _VERDICT_MAP.get(word)
660
+ if got is None:
661
+ return {"verdict": DEFER, "slot_corrections": corr, "parsed": True, "raw": str(raw)[:500],
662
+ "reason": "单元未给出可识别的裁决(%r)%s" % (word, (":" + reason) if reason else "")}
663
+ return {"verdict": got, "reason": reason, "slot_corrections": corr,
664
+ "checks": data.get("checks"), "raw": str(raw)[:500], "parsed": True}
665
+
666
+
667
+ # 生效条件:state==HIVE 时返回 "hive:<role>:<job_id 或 'unknown'>";state==SUBAGENT 时返回 "subagent:<role>:<channel 或 'harness'>";其余 state 返回空串。
668
+ def transport_name(state: str, role: str, job_id: str = "", channel: str = "") -> str:
669
+ """裁决来源标识:**结构上不可能等于编译者**,保证 A 裁定「不得自证」不被误伤。"""
670
+ if state == HIVE:
671
+ return "hive:%s:%s" % (role, job_id or "unknown")
672
+ if state == SUBAGENT:
673
+ return "subagent:%s:%s" % (role, channel or "harness")
674
+ return ""
675
+
676
+
677
+ # 生效条件:unit 为假值时按 {} 处理;verdict=unit.get("verdict") or DEFER,verifier=transport_name(state, role, job_id, channel),evidence 取 unit 的 reason,为空则退回 str(unit["raw"])[:300],job_id 为真时再追加“(job=<job_id>)”;仅当 unit 的 slot_corrections 为真才带该键,仅当 compiled_by 与 verifier 皆非空且相等才置 self_verify=True。
678
+ def to_attest_args(unit: dict, *, state: str = "", role: str = REFLECT, job_id: str = "",
679
+ channel: str = "", compiled_by: str = "") -> dict:
680
+ """单元裁决 → ccgc.attest(...) 入参(纯函数,离线可测)。
681
+
682
+ 诚实边界:只做搬运与命名;裁决正确性由外部单元负责,本模块不为其背书。
683
+ """
684
+ unit = unit or {}
685
+ verdict = unit.get("verdict") or DEFER
686
+ verifier = transport_name(state, role, job_id, channel)
687
+ evidence = str(unit.get("reason") or "")
688
+ if unit.get("raw") and not evidence:
689
+ evidence = str(unit["raw"])[:300]
690
+ if job_id:
691
+ evidence = "%s(job=%s)" % (evidence, job_id)
692
+ args = {"verdict": verdict, "verifier": verifier, "evidence": evidence}
693
+ if unit.get("slot_corrections"):
694
+ args["slot_corrections"] = unit["slot_corrections"]
695
+ if compiled_by and verifier and verifier == compiled_by:
696
+ args["self_verify"] = True
697
+ return args
698
+
699
+
700
+ # ---------------------------------------------------------------- 复核请求包
701
+
702
+ _REFLECT_TPL = """你是认知图记忆节点的**反思单元**(reflect)。下面是一份由 ccgc 编译出的
703
+ CCG 六要素候选(功能名/生效条件/子功能/执行/验证方式/不适用条件)。请逐项反思:
704
+
705
+ 1) 六要素是否齐备,是否都能在「对话记录」里找到字面依据;
706
+ 2) 「生效条件」四槽(场景/时窗/对象/前置)是否与实际适用范围一致,有无过度泛化;
707
+ 3) 「不适用条件」(拒绝域)是否漏掉了明显该拒的情形;
708
+ 4) 若有问题,给出**最小修正**(只改该字段,不重写)。
709
+
710
+ 编译产物(JSON):
711
+ {digest}
712
+
713
+ 原始对话记录(真源,引用必须出自此处):
714
+ {dialog}
715
+
716
+ 只输出一个 JSON 对象,不要任何解释文字:
717
+ {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}},
718
+ "checks":[{{"element":"功能名","ok":true,"note":""}}]}}"""
719
+
720
+ _VERIFY_TPL = """你是独立**验证单元**(verify)。对下面这份 CCG 六要素候选与反思单元的结论
721
+ 逐条复核:来源是否真实可追溯、结论是否被对话记录支持、修正是否越权(不得新增事实)。
722
+
723
+ **你只能否决或存疑,不得新增主张、不得改写事实**(可给出 slot_corrections 修正已有槽位)。
724
+
725
+ 候选(JSON):
726
+ {digest}
727
+
728
+ 反思单元结论:
729
+ {reflect_rows}
730
+
731
+ 对话记录(真源):
732
+ {dialog}
733
+
734
+ 只输出一个 JSON 对象:
735
+ {{"verdict":"accept|drop|defer","reason":"一句话依据","slot_corrections":{{}}}}"""
736
+
737
+
738
+ # 生效条件:digest is None 时返回 "{}";digest 是 str 时原样返回;否则先试 to_dict/as_dict 可调用方法并 json.dumps 其返回值(抛异常即跳出改走后续分支);是 dict 时 json.dumps(digest);其余取 vars(digest) 中不以 "_" 开头的属性 json.dumps(default=str)。
739
+ def _digest_of(digest) -> str:
740
+ if digest is None:
741
+ return "{}"
742
+ if isinstance(digest, str):
743
+ return digest
744
+ for attr in ("to_dict", "as_dict"):
745
+ fn = getattr(digest, attr, None)
746
+ if callable(fn):
747
+ try:
748
+ return json.dumps(fn(), ensure_ascii=False, indent=1)
749
+ except Exception: # noqa: BLE001
750
+ break
751
+ if isinstance(digest, dict):
752
+ return json.dumps(digest, ensure_ascii=False, indent=1)
753
+ return json.dumps({k: v for k, v in vars(digest).items() if not k.startswith("_")},
754
+ ensure_ascii=False, indent=1, default=str)
755
+
756
+
757
+ # 生效条件:role==VERIFY 选 _VERIFY_TPL,否则选 _REFLECT_TPL;reflect_rows 是 str 时直接作为 rows,否则 json.dumps(reflect_rows or [], ensure_ascii=False, indent=1);最终返回 tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000], reflect_rows=rows[:3000])。
758
+ def prompt_for(role: str, digest=None, *, dialog: str = "", reflect_rows="") -> str:
759
+ """按角色生成复核请求包正文(reflect/verify 共用一处模板真源)。"""
760
+ tpl = _VERIFY_TPL if role == VERIFY else _REFLECT_TPL
761
+ rows = reflect_rows if isinstance(reflect_rows, str) else json.dumps(
762
+ reflect_rows or [], ensure_ascii=False, indent=1)
763
+ return tpl.format(digest=_digest_of(digest), dialog=str(dialog or "(未提供)")[:6000],
764
+ reflect_rows=rows[:3000])
765
+
766
+
767
+ # 生效条件:text 取 prompt 真值或 prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows);pr=probe(jobs, model, allow_degrade=allow_degrade, channel=channel) 为 SUBAGENT 时原样返回未派发的 SUBAGENT 包、为 CONFIGURE 时返回未派发的 CONFIGURE 包;为 HIVE 时若 autostart 为真且 serve_state(jobs) 非 alive 先 autostart_serve(jobs),再 submit(...),submit 失败回 CONFIGURE 且把 error 拼进 hint,成功则给出 job_id,blocking=False 直接返回;blocking=True 时 wait(sub["job_id"], jobs=jobs, timeout_s=wait_s),res.ok 为假则 unit 记 DEFER 并附未产出有效结果的 hint,为真则 unit=verdict_of(res.get("content")),随后填 transport/attest/result_ok/waited_s 并 _log。
768
+ def review(*, prompt: str = "", role: str = REFLECT, digest=None, dialog: str = "",
769
+ reflect_rows="", node_id: str = "", jobs: str = "", model: str = "",
770
+ timeout_s: int = DEFAULT_TIMEOUT_S, allow_degrade: bool = False,
771
+ channel: str = "", wait_s: float = DEFAULT_TIMEOUT_S, blocking: bool = True,
772
+ cg=None, actor: str = "", autostart: bool = False) -> dict:
773
+ """复核主入口:**蜂巢优先 → 提示配置 → 端子代理降级**(三态各自如实返回)。
774
+
775
+ 返回统一形态:{state, role, node_id, transport, unit, attest, prompt, job_id, hint}
776
+ - state=hive :已派发;blocking=True 时等终态并给出 unit/attest;否则只给 job_id
777
+ - state=configure:**未派发**,hint 为配置指引(使用者裁定:不可用即提示配置)
778
+ - state=subagent :**未派发**,返回 prompt 包供宿主子代理执行并回填
779
+ """
780
+ text = prompt or prompt_for(role, digest, dialog=dialog, reflect_rows=reflect_rows)
781
+ pr = probe(jobs, model, allow_degrade=allow_degrade, channel=channel)
782
+ base = {"role": role, "node_id": node_id, "prompt": text,
783
+ "transport": None, "unit": None, "attest": None,
784
+ "job_id": None, "hint": pr.get("hint") or "", "channel": pr.get("channel") or "",
785
+ "degrade": {"channel": channel or "harness-subagent",
786
+ "how": "宿主子代理执行 prompt → 裁决经 verdicts 回填 attest"}}
787
+ if pr["state"] == SUBAGENT:
788
+ return {"state": SUBAGENT, **base,
789
+ "degrade": {"available": True, "channel": channel or "harness-subagent",
790
+ "how": "把 prompt 交给宿主子代理,取其 JSON 裁决后调 "
791
+ "cg(op=ccg, action=attest, verdict=<accept|drop|defer>, "
792
+ "verifier=subagent:<role>:<channel>)"}}
793
+ if pr["state"] == CONFIGURE:
794
+ return {"state": CONFIGURE, **base,
795
+ "degrade": {"available": True, "channel": channel or "harness-subagent",
796
+ "how": "① 按 hint 配置蜂巢后重试;② 或带 allow_degrade=true 降级子代理"}}
797
+ if autostart and not serve_state(jobs)["alive"]:
798
+ pr["autostart"] = autostart_serve(jobs)
799
+ sub = submit(prompt=text, role=role, jobs=jobs, model=model, timeout_s=timeout_s,
800
+ cg=cg, actor=actor)
801
+ if not sub.get("ok"):
802
+ return {"state": CONFIGURE, **base, "hint": (pr.get("hint") or "") + "\n" + str(sub.get("error"))}
803
+ out = {"state": HIVE, **base, "job_id": sub["job_id"], "unit_role": role,
804
+ "model": sub.get("model")}
805
+ if not blocking:
806
+ return out
807
+ res = wait(sub["job_id"], jobs=jobs, timeout_s=wait_s)
808
+ unit = verdict_of(res.get("content")) if res.get("ok") else {
809
+ "verdict": DEFER, "reason": res.get("error") or "单元未返回可用结果",
810
+ "slot_corrections": {}, "parsed": False}
811
+ out["unit"] = unit
812
+ out["transport"] = transport_name(HIVE, role, sub["job_id"])
813
+ out["attest"] = to_attest_args(unit, state=HIVE, role=role, job_id=sub["job_id"])
814
+ out["result_ok"] = bool(res.get("ok"))
815
+ out["waited_s"] = res.get("waited_s")
816
+ if not res.get("ok"):
817
+ out["hint"] = "蜂巢 job 未产出有效结果:%s(裁决按 DEFER 处理,未假装通过)" % res.get("error")
818
+ _log(cg, {"action": "review", "job_id": sub["job_id"], "role": role,
819
+ "node_id": node_id, "actor": actor, "unit_verdict": unit.get("verdict"),
820
+ "result_ok": bool(res.get("ok"))})
821
+ return out
822
+
823
+
824
+ # ---------------------------------------------------------------- serve 拉起(显式)
825
+
826
+ # 生效条件:serve_state(jobs_dir(jobs)) 已 alive 时返回 started=False 的“serve 存活”;否则 exe_path() 未被 isfile 命中时返回 started=False 并提示先 cargo build --release;否则以 detached/新会话 Popen 拉起 exe serve --jobs jd 并把 stdout/stderr 写入 jd/_serve.log,Popen 抛 OSError 时返回 started=False 的拉起失败;拉起后在 float(wait_s) 内轮询到 alive 返回 started=True 的“serve 已拉起”,轮询超时仍返回 started=True 但标注心跳未就绪。
827
+ def autostart_serve(jobs: str = "", wait_s: float = 5.0) -> dict:
828
+ """**显式**拉起 serve(默认不启用;使用者裁定:不可用即提示配置)。
829
+
830
+ 形态同 hive_mcp._ensure_serve:detached + 独立日志,不阻塞调用方。
831
+ """
832
+ jd = jobs_dir(jobs)
833
+ if serve_state(jd)["alive"]:
834
+ return {"started": False, "note": "serve 存活"}
835
+ exe = exe_path()
836
+ if not os.path.isfile(exe):
837
+ return {"started": False, "note": "未找到可执行文件 %s——先 cargo build --release" % exe}
838
+ kwargs = {}
839
+ if os.name == "nt":
840
+ kwargs["creationflags"] = subprocess.DETACHED_PROCESS | subprocess.CREATE_NO_WINDOW
841
+ else:
842
+ kwargs["start_new_session"] = True
843
+ try:
844
+ os.makedirs(jd, exist_ok=True)
845
+ with open(os.path.join(jd, "_serve.log"), "ab") as logf:
846
+ subprocess.Popen([exe, "serve", "--jobs", jd], stdout=logf, stderr=logf,
847
+ stdin=subprocess.DEVNULL, **kwargs)
848
+ except OSError as exc:
849
+ return {"started": False, "note": "拉起失败:%s: %s" % (type(exc).__name__, exc)}
850
+ t0 = time.time()
851
+ while time.time() - t0 < float(wait_s):
852
+ if serve_state(jd)["alive"]:
853
+ return {"started": True, "note": "serve 已拉起"}
854
+ time.sleep(0.1)
855
+ return {"started": True, "note": "serve 已拉起(心跳未就绪,稍后自愈)"}
856
+
857
+
858
+ # 生效条件:返回 dict 的 ok=p["state"]==HIVE,其中 p=plan(jobs)(model/fresh_s/allow_degrade/channel 全走默认),state/serve_alive/serve_age_s/chain/hint/model 取自该 p;jobs_dir 取 jobs_dir(jobs),exe_found 与 exe_path 取 exe_path() 是否被 isfile 命中,model_set=bool(model_name())(无参,读 ENV_MODEL),api_key_set=bool(os.environ.get(ENV_API_KEY)),env 记录 ENV_JOBS_DIR 与 ENV_MODEL 的原值。
859
+ def doctor(jobs: str = "") -> dict:
860
+ """能力体检(形态对齐 hive_doctor):判活 + exe + 模型 + 优先级链。"""
861
+ jd = jobs_dir(jobs)
862
+ p = plan(jobs)
863
+ return {"ok": p["state"] == HIVE, "state": p["state"], "jobs_dir": jd,
864
+ "serve_alive": p["serve"]["alive"], "serve_age_s": p["serve"]["age_s"],
865
+ "exe_found": os.path.isfile(exe_path()), "exe_path": exe_path(),
866
+ "model_set": bool(model_name()), "model": p["model"],
867
+ "api_key_set": bool(os.environ.get(ENV_API_KEY)),
868
+ "env": {"HIVE_JOBS_DIR": os.environ.get(ENV_JOBS_DIR, ""),
869
+ "MDCG_UNIT_MODEL": os.environ.get(ENV_MODEL, "")},
870
870
  "chain": p["chain"], "hint": p["hint"]}