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