@furongjun1999/dsh-memory 0.9.21 → 0.9.22

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