@furongjun1999/dsh-memory 0.9.21 → 0.9.23

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