@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
@@ -1,743 +1,743 @@
1
- # -*- coding: utf-8 -*-
2
- """记忆评审流水线 · 级 4 蜂巢并发对接(spec 构造/投递/收卷)+ 级 5 意见落库治理。
3
-
4
- 真源:docs/记忆评审系统_立项设计与施工交接_20260915.md §5(spec/result 契约)
5
- §7(反面清单:评审不直接改知识层 / 意见必过 verify 令牌 / 不确定 DEFER)
6
-
7
- 五级分工:级 1-3(M1)=候选→捆包→规则装配,产出 (pkg, asm) 对;
8
- 级 4(本模块)=每对 → hive spec → submit → poll 收卷(真并发、文件协议留痕);
9
- 级 5(本模块)=意见格式校验 → verify 令牌过 writepipe 六道闸落 contextual。
10
-
11
- 纪律是结构性的,不靠自觉:
12
- · 评审不改知识层:落库层固定 contextual,verify 令牌 layers_allow 不含 knowledge
13
- ——库层 require_layer_write 拦截,任何拦截器都绕不过(§7 反面清单第 1 条)。
14
- · 自验禁止:产出意见者(reflect)与落库裁决者(verify)不得同一 actor,判据
15
- 复用 crosscheck.detect_self_verify(不另造判据,保持真源单一)。
16
- · 不确定即 DEFER:解析失败/格式越界一律不落库(Precision over noise)。
17
- · 零写入面:worker 只读 spec/context、只写自己的 result.json;认知图写入只发生在
18
- 收卷后的 apply_opinions(本模块,走 writepipe 通道)。
19
-
20
- 运行:python -m md_cg.mreview.pipeline --help
21
- """
22
- from __future__ import annotations
23
-
24
- import json
25
- import os
26
- import re
27
- import subprocess
28
- import tempfile
29
- import time
30
- import uuid
31
-
32
- from .. import crosscheck as CC
33
- from .. import tokens as TK
34
- from .. import writepipe as WP
35
- from ..security import AccessDenied, Principal
36
- from . import candidates as CD
37
- from . import bundle as BD
38
- from . import ruleset as RS
39
-
40
- __all__ = [
41
- "VERDICTS", "OPINION_LAYER", "DEFAULT_MODEL", "TERMINAL_STATES",
42
- "hive_exe", "build_packages", "build_prompt", "build_spec", "dump_context",
43
- "submit", "submit_many", "poll", "wait_jobs", "read_result", "collect",
44
- "parse_opinions", "validate_opinion", "validate_opinions",
45
- "verifier_principal", "opinion_doc", "apply_opinions", "run_package",
46
- "run_batch", "main",
47
- ]
48
-
49
- # ---- 常量 ----------------------------------------------------------------
50
-
51
- VERDICTS = ("ACCEPT", "DEFER", "REJECT", "BLINDSPOT") # 意见四态(资格裁决同源)
52
- OPINION_LAYER = "contextual" # verify 令牌 layers_allow=rejected/contextual
53
- OPINION_BASIS = "measurement" # 意见的验证基底:确定性规则命中 + 复核
54
- TERMINAL_STATES = ("done", "error", "timeout", "killed")
55
- DEFAULT_MODEL = "glm-4-flash"
56
- _ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
57
-
58
- SYSTEM_PROMPT = """你是记忆评审流水线中的【验证单元】。
59
-
60
- 职责边界(违反即无效):
61
- 1. 只对给定节点清单逐条裁决,不得引入清单外的节点。
62
- 2. 只输出意见,不改写任何记忆——你没有写入通道,也不需要。
63
- 3. 不确定就 DEFER(硬纪律):宁可漏判,不可错判。
64
- 4. 只有拿得出证据时才 REJECT;说不出证据就 DEFER。
65
- 5. ACCEPT 表示「已确认适用」,不是「没发现问题」——正条件无法确认时用 DEFER。
66
-
67
- 四态语义:
68
- - ACCEPT 已确认适用
69
- - DEFER 条件不足/无法确认(默认落点)
70
- - REJECT 有据否定(冲突/来源许可不足/重复且劣于既有)
71
- - BLINDSPOT 当前观测位置看不见(不是"不知道",是"这个位置判断不了")
72
-
73
- 输出契约(严格 JSON,无额外文字、无 markdown 围栏):
74
- {"verdicts": [{"node_id": "...", "verdict": "ACCEPT|DEFER|REJECT|BLINDSPOT",
75
- "reason": "一句话理由", "evidence": "证据(REJECT 必填)"}],
76
- "summary": "整包一句话结论"}
77
- 清单中每个节点都要有一条裁决,一条不多一条不少。"""
78
-
79
-
80
- # ---- 级 4-A · spec 构造 ---------------------------------------------------
81
-
82
- # 生效条件:exe 为真值时返回 str(exe),否则 HIVE_EXE 经 (os.environ.get("HIVE_EXE") or "").strip() 后非空则返回该值,否则按 os.name 返回 os.path.join(_ROOT, "hive", "target", "release", "hive.exe" 或 "hive");
83
- def hive_exe(exe=None) -> str:
84
- """蜂巢可执行文件:显式参数 > HIVE_EXE > 仓内 release 构建。"""
85
- if exe:
86
- return str(exe)
87
- env = (os.environ.get("HIVE_EXE") or "").strip()
88
- if env:
89
- return env
90
- name = "hive.exe" if os.name == "nt" else "hive"
91
- return os.path.join(_ROOT, "hive", "target", "release", name)
92
-
93
-
94
- # 生效条件:name 为假值(None/""/0/False 等)时以 "pkg" 为输入,否则 str(name),结果经 re.sub(r"[^0-9A-Za-z_.\-]", "_", ...) 替换并截取前 120 字符;
95
- def _safe(name) -> str:
96
- return re.sub(r"[^0-9A-Za-z_.\-]", "_", str(name or "pkg"))[:120]
97
-
98
-
99
- # 生效条件:path 与 obj 给定后,若 os.path.dirname(path) 非空则 os.makedirs 该目录,随后以 UTF-8、ensure_ascii=False、indent=2 将 obj 写入 path 并返回 path;
100
- def _dump_json(path: str, obj) -> str:
101
- d = os.path.dirname(path)
102
- if d:
103
- os.makedirs(d, exist_ok=True)
104
- with open(path, "w", encoding="utf-8") as f:
105
- json.dump(obj, f, ensure_ascii=False, indent=2)
106
- return path
107
-
108
-
109
- _ENTRY_KEYS = ("ref", "node_id", "proposal_id", "origin", "layer", "tags", "role",
110
- "importance", "evidence_count", "verification_basis",
111
- "lifecycle_state", "content_hash", "issue_kinds", "evidence",
112
- "excerpt")
113
-
114
-
115
- # 生效条件:pkg/asm/workdir 给定,base 取 _safe(pkg.get("bundle_id"))(bundle_id 假值→"pkg"),entries 取 pkg.get("entries") or [] 的前 int(entry_limit) 项且仅保留 _ENTRY_KEYS,写出 workdir/base.bundle.json 与 workdir/base.rules.json(asm 原样),返回这两个 join(workdir,...) 路径(workdir 相对时不保证绝对);
116
- def dump_context(pkg: dict, asm: dict, workdir: str, *, entry_limit=64) -> list:
117
- """包 + 规则装配 → context 文件(**绝对路径**,工人执行期内有效)。
118
-
119
- 相对路径的解析基准是 spec.workdir,跨进程易错;绝对路径无歧义。
120
- """
121
- os.makedirs(workdir, exist_ok=True)
122
- base = _safe(pkg.get("bundle_id"))
123
- bp = os.path.join(workdir, base + ".bundle.json")
124
- rp = os.path.join(workdir, base + ".rules.json")
125
- ents = [{k: e.get(k) for k in _ENTRY_KEYS}
126
- for e in (pkg.get("entries") or [])[:int(entry_limit)]]
127
- _dump_json(bp, {"bundle_id": pkg.get("bundle_id"),
128
- "group_kind": pkg.get("group_kind"),
129
- "group_key": pkg.get("group_key"),
130
- "size": pkg.get("size"), "entries": ents})
131
- _dump_json(rp, asm)
132
- return [bp, rp]
133
-
134
-
135
- # 生效条件:pkg/asm 给定,节点清单标题恒输出、节点项取 pkg.get("entries") or [];机械命中取 asm.get("mechanical") or [],非空列前 int(max_mech) 条否则输出「无」,llm 取 asm.get("llm") or [] 非空列前 40 条;返回 join(L);
136
- def build_prompt(pkg: dict, asm: dict, *, max_mech=120) -> str:
137
- """user_prompt:节点清单 + 机械命中 + 待检问题 + 输出要求。"""
138
- ents = pkg.get("entries") or []
139
- L = ["【待评包】bundle_id=%s group=%s/%s 节点数=%d"
140
- % (pkg.get("bundle_id"), pkg.get("group_kind"),
141
- pkg.get("group_key"), len(ents)), ""]
142
- L.append("【节点清单】(仅可裁决以下节点)")
143
- for i, e in enumerate(ents, 1):
144
- frag = (e.get("excerpt") or "").strip().replace("\n", " ")[:220]
145
- L.append("%d) node_id=%s layer=%s basis=%s tags=%s"
146
- % (i, e.get("node_id"), e.get("layer"),
147
- e.get("verification_basis"),
148
- ",".join(e.get("tags") or []) or "-"))
149
- L.append(" 正文摘录:%s" % (frag or "(无正文/正文缺失)"))
150
- if e.get("issue_kinds"):
151
- L.append(" 机械初筛命中:%s" % ",".join(e["issue_kinds"]))
152
- L.append("")
153
- mech = asm.get("mechanical") or []
154
- if mech:
155
- L.append("【确定性规则命中】共 %d 条(机械层已给出,只需判断其语义后果)"
156
- % len(mech))
157
- for m in mech[:int(max_mech)]:
158
- L.append("- [%s] %s :: %s"
159
- % (m.get("issue_kind"), m.get("ref") or m.get("node_id"),
160
- str(m.get("detail") or m.get("message") or "")[:160]))
161
- else:
162
- L.append("【确定性规则命中】无(本包未触发任何机械规则)")
163
- L.append("")
164
- llm = asm.get("llm") or []
165
- if llm:
166
- L.append("【待你判断的问题】逐项判断,并在 reason 中体现结论:")
167
- for q in llm[:40]:
168
- L.append("- (规则 %s / 检查 %s) %s"
169
- % (q.get("rule_id"), q.get("check"), q.get("question")))
170
- L.append("")
171
- L.append("【输出】严格按 system 中的 JSON 契约,对每个 node_id 给出一条裁决。")
172
- return "\n".join(L)
173
-
174
-
175
- # 生效条件:pkg/asm 给定,model 按 model or os.environ.get('HIVE_MODEL') or DEFAULT_MODEL 取值(空串/假值均回落),context_files 按 list(context_files or []),timeout_s 转 int、temperature 转 float、max_tokens 转 int,node_ids 取 pkg.entries 中 node_id 真值的 str,返回含 meta 的 spec 字典;
176
- def build_spec(pkg: dict, asm: dict, *, context_files=None, model=None,
177
- timeout_s=600, temperature=0.0, max_tokens=4096) -> dict:
178
- """(pkg, asm) → hive spec(文件协议的可投递单元)。"""
179
- nids = [str(e.get("node_id")) for e in (pkg.get("entries") or [])
180
- if e.get("node_id")]
181
- return {"model": model or os.environ.get("HIVE_MODEL") or DEFAULT_MODEL,
182
- "system_prompt": SYSTEM_PROMPT,
183
- "user_prompt": build_prompt(pkg, asm),
184
- "context_files": list(context_files or []),
185
- "timeout_s": int(timeout_s),
186
- "temperature": float(temperature),
187
- "max_tokens": int(max_tokens),
188
- # 归因元信息(hive 忽略;收卷侧用于配对与审计)
189
- "meta": {"bundle_id": pkg.get("bundle_id"),
190
- "group_kind": pkg.get("group_kind"),
191
- "group_key": pkg.get("group_key"),
192
- "size": pkg.get("size"), "node_ids": nids}}
193
-
194
-
195
- # 生效条件:当模块级常量 CD.SOURCES 可用时,sources 为假值则回落 CD.SOURCES,调用 CD.generate 生成候选,再经 BD.bundle(c.get('candidates') or [], nodes, root, max_per_bundle) 与 RS.assemble_all(b, rules_dir) 组装,最终将 bundles 与 packages 按 zip 配对返回。
196
- def build_packages(*, root=None, sources=None, limit=None, nodes=None,
197
- max_per_bundle=50, rules_dir=None, now=None) -> dict:
198
- """级 1-3 串联:候选 → 捆包 → 规则装配,产出配对的 (pkg, asm) 列表。"""
199
- c = CD.generate(root, sources=sources or CD.SOURCES, nodes=nodes, limit=limit,
200
- with_report=False, now=now)
201
- b = BD.bundle(c.get("candidates") or [], nodes=nodes, root=root,
202
- max_per_bundle=max_per_bundle)
203
- a = RS.assemble_all(b, rules_dir=rules_dir)
204
- pairs = []
205
- for pkg, asm in zip(b.get("bundles") or [], a.get("packages") or []):
206
- pairs.append((pkg, asm))
207
- return {"candidates": c, "bundles": b, "assembled": a, "pairs": pairs}
208
-
209
-
210
- # ---- 级 4-B · 投递 / 收卷 -------------------------------------------------
211
-
212
- # 生效条件:argv 给定,环境变量副本强制 PYTHONUTF8="1",env 真值时用其 str 值更新,随后 subprocess.run(argv, capture_output=True, text=True, encoding="utf-8", errors="replace", env=e, timeout=timeout, cwd=cwd, input=stdin_text, shell=False);
213
- def _run(argv, *, env=None, timeout=120, cwd=None, stdin_text=None):
214
- """统一子进程入口:argv 列表 + 显式 UTF-8 + PYTHONUTF8=1,不经 shell(第15条)。"""
215
- e = dict(os.environ)
216
- e["PYTHONUTF8"] = "1"
217
- if env:
218
- e.update({k: str(v) for k, v in env.items()})
219
- return subprocess.run(argv, capture_output=True, text=True, encoding="utf-8",
220
- errors="replace", env=e, timeout=timeout, cwd=cwd,
221
- input=stdin_text, shell=False)
222
-
223
-
224
- # 生效条件:text 为假值时 (text or "").strip().splitlines() 为空、循环不执行并返回 None;否则从末尾行向前找以 "{" 开头且 json.loads 成功且 isinstance(obj, dict) 的行返回该 dict,未找到返回 None;
225
- def _last_json(text: str):
226
- """stdout 逐行解析取最后一个 JSON 对象(容忍前导日志行)。"""
227
- for line in reversed((text or "").strip().splitlines()):
228
- s = line.strip()
229
- if not s.startswith("{"):
230
- continue
231
- try:
232
- obj = json.loads(s)
233
- except ValueError:
234
- continue
235
- if isinstance(obj, dict):
236
- return obj
237
- return None
238
-
239
-
240
- # id 契约 v2(B8):`hive submit` 的四槽**必填**(身份/任务/单元显式声明,编号由 Rust
241
- # 分配器独占创建给出)——缺任一 CLI 即显式报错退出(不许静默推导/空串兜底)。
242
- # 评审流水线作为**提交方**在此声明自己的三槽(这不是「推导」:是本提交者的固定身份);
243
- # 调用方 env 里已显式给定的同名键优先(B8 的 env 兜底口径),故部署侧可覆盖。
244
- _SUBMIT_SLOT_ENV = {
245
- "HIVE_JOB_IDENTITY": "灵枢评审",
246
- "HIVE_JOB_TASK": "记忆评审M2",
247
- "HIVE_JOB_UNIT": "验证单元",
248
- }
249
-
250
-
251
- # 生效条件:exe/jobs_dir/spec 给定,创建 jobs_dir 并在临时目录写 spec.json 后执行 [exe,"submit","--spec",sp,"--jobs",jobs_dir];returncode 非 0 返回 ok False + error,否则 _last_json(p.stdout) 为假(含 None/空 dict)返回 ok False「submit 输出非 JSON」,否则 d.setdefault("ok", True) 后返回 d;
252
- def submit(exe: str, jobs_dir: str, spec: dict, *, timeout=120) -> dict:
253
- """投递单包 spec → {"ok":True,"job_id":...};失败返回 ok=False + error。"""
254
- os.makedirs(jobs_dir, exist_ok=True)
255
- slots = {k: v for k, v in _SUBMIT_SLOT_ENV.items()
256
- if not (os.environ.get(k) or "").strip()}
257
- with tempfile.TemporaryDirectory(prefix="mrev_spec_") as td:
258
- sp = _dump_json(os.path.join(td, "spec.json"), spec)
259
- p = _run([exe, "submit", "--spec", sp, "--jobs", jobs_dir],
260
- timeout=timeout, env=slots)
261
- if p.returncode != 0:
262
- return {"ok": False, "returncode": p.returncode,
263
- "error": (p.stderr or p.stdout or "").strip()[:800]}
264
- d = _last_json(p.stdout)
265
- if not d:
266
- return {"ok": False, "error": "submit 输出非 JSON",
267
- "stdout": (p.stdout or "")[:800]}
268
- d.setdefault("ok", True)
269
- return d
270
-
271
-
272
- # 生效条件:specs 为可迭代列表时逐项调用 submit(exe, jobs_dir, s, timeout=timeout) 并返回等长列表;specs 为空则返回空列表;
273
- def submit_many(exe: str, jobs_dir: str, specs: list, *, timeout=120) -> list:
274
- """批量投递(hive 侧并发消费;本函数逐条投递并保序配对)。"""
275
- return [submit(exe, jobs_dir, s, timeout=timeout) for s in specs]
276
-
277
-
278
- # 生效条件:exe/jobs_dir 给定,job_id 为真值时 argv 追加 str(job_id),假值(None/"")时仅列全部;运行后 returncode 非 0 返回 ok False + error,否则 _last_json(p.stdout) 为真值(非空 dict)时返回该 dict,为假值时返回 ok False「poll 输出非 JSON」;
279
- def poll(exe: str, jobs_dir: str, job_id=None, *, timeout=120) -> dict:
280
- """查询 job 状态(不传 job_id = 列出全部)。"""
281
- argv = [exe, "poll"]
282
- if job_id:
283
- argv.append(str(job_id))
284
- argv += ["--jobs", jobs_dir]
285
- p = _run(argv, timeout=timeout)
286
- if p.returncode != 0:
287
- return {"ok": False, "returncode": p.returncode,
288
- "error": (p.stderr or p.stdout or "").strip()[:800]}
289
- d = _last_json(p.stdout)
290
- return d or {"ok": False, "error": "poll 输出非 JSON",
291
- "stdout": (p.stdout or "")[:800]}
292
-
293
-
294
- # 生效条件:j.get("job_id") 为真值时返回该值,否则返回 j.get("id")(若 id 为 0/""/False 则原样返回该假值,若 id 缺失返回 None);
295
- def _job_id(j: dict):
296
- return j.get("job_id") or j.get("id")
297
-
298
-
299
- # 生效条件:j.get("state") 为真值时返回 str(state);否则 j.get("status") 为 dict 时返回 str(status.get("state") or "");否则返回 str(status or "");
300
- def _job_state(j: dict) -> str:
301
- """state 读取兼容两种形态(扁平 / status 嵌套);仅供轮询判终态。"""
302
- s = j.get("state")
303
- if s:
304
- return str(s)
305
- st = j.get("status")
306
- if isinstance(st, dict):
307
- return str(st.get("state") or "")
308
- return str(st or "")
309
-
310
-
311
- # 生效条件:exe/jobs_dir 给定,job_ids 真值集合限观测;循环 poll 直到 pending 为空且(want 为 None 或 want <= 已观测)返回 ok=not failed,若 pending 非空或 want 未全观测且到 max(1.0,float(timeout_s)) 截止则返回 ok False + error,每次间隔 sleep(max(0.05,float(interval_s)));
312
- def wait_jobs(exe: str, jobs_dir: str, job_ids=None, *, timeout_s=900,
313
- interval_s=1.0, on_tick=None) -> dict:
314
- """轮询至全部终态(或超时)→ done/failed/pending 三分类 + 原始快照。"""
315
- want = set(str(x) for x in (job_ids or [])) or None
316
- deadline = time.time() + max(1.0, float(timeout_s))
317
- last = {}
318
- while True:
319
- r = poll(exe, jobs_dir)
320
- states = {}
321
- for j in (r.get("jobs") or []):
322
- jid = _job_id(j)
323
- if jid is None:
324
- continue
325
- jid = str(jid)
326
- if want is not None and jid not in want:
327
- continue
328
- states[jid] = _job_state(j) or "pending"
329
- last[jid] = j
330
- done = sorted(k for k, v in states.items() if v == "done")
331
- failed = sorted(k for k, v in states.items()
332
- if v in TERMINAL_STATES and v != "done")
333
- pending = sorted(k for k, v in states.items() if v not in TERMINAL_STATES)
334
- if on_tick:
335
- on_tick({"states": dict(states), "done": len(done),
336
- "pending": len(pending), "failed": len(failed)})
337
- if not pending:
338
- if want is None or want <= set(states):
339
- return {"ok": not failed, "done": done, "failed": failed,
340
- "pending": [], "states": states, "jobs": last}
341
- if time.time() >= deadline:
342
- miss = sorted(want - set(states))
343
- return {"ok": False, "done": done, "failed": failed,
344
- "pending": miss, "states": states, "jobs": last,
345
- "error": "未在超时内观测到 job:%s" % ",".join(miss)}
346
- if time.time() >= deadline:
347
- return {"ok": False, "done": done, "failed": failed,
348
- "pending": pending, "states": states, "jobs": last,
349
- "error": "等待终态超时(%ss)" % timeout_s}
350
- time.sleep(max(0.05, float(interval_s)))
351
-
352
-
353
- # 生效条件:jobs_dir/job_id 给定,join(jobs_dir,str(job_id),"result.json") 路径缺失时返回 ok False「result.json 不存在」,读取时 OSError/ValueError 返回 ok False「读取失败」,json 对象非 dict 返回 ok False「result 非对象」,否则返回该 dict;
354
- def read_result(jobs_dir: str, job_id: str) -> dict:
355
- """读工人产出(job 目录的 result.json)。"""
356
- p = os.path.join(jobs_dir, str(job_id), "result.json")
357
- if not os.path.isfile(p):
358
- return {"ok": False, "error": "result.json 不存在:%s" % p}
359
- try:
360
- with open(p, encoding="utf-8") as f:
361
- obj = json.load(f)
362
- except (OSError, ValueError) as exc:
363
- return {"ok": False, "error": "result.json 读取失败:%s" % exc}
364
- return obj if isinstance(obj, dict) else {"ok": False, "error": "result 非对象"}
365
-
366
-
367
- # 生效条件:jobs_dir/job_ids 给定,job_ids 为假值(None/[])时返回空 dict,否则返回 {str(j): read_result(jobs_dir, j) for j in job_ids};
368
- def collect(jobs_dir: str, job_ids) -> dict:
369
- """按 job_id 收卷(读 result.json),返回 {job_id: result} 保序映射。"""
370
- return {str(j): read_result(jobs_dir, j) for j in (job_ids or [])}
371
-
372
-
373
- # ---- 级 5-A · 意见解析与格式校验(校验率 100% 是验收口径)-----------------
374
-
375
- # 生效条件:text 去空格后为空返回 None;否则先 try json.loads(整体),成功返回;否则找 ```(?:json)?...``` 围栏内 json.loads 成功返回;否则取 s.find("{") 与 s.rfind("}") 且 0<=i<k 的切片 json.loads 成功返回;均失败返回 None;
376
- def _extract_json(text: str):
377
- """从模型文本抽 JSON 对象:整体 → ```围栏``` → 首尾大括号切片。"""
378
- s = (text or "").strip()
379
- if not s:
380
- return None
381
- try:
382
- return json.loads(s)
383
- except ValueError:
384
- pass
385
- m = re.search(r"```(?:json)?\s*(.+?)```", s, re.S)
386
- if m:
387
- try:
388
- return json.loads(m.group(1).strip())
389
- except ValueError:
390
- pass
391
- i, k = s.find("{"), s.rfind("}")
392
- if 0 <= i < k:
393
- try:
394
- return json.loads(s[i:k + 1])
395
- except ValueError:
396
- pass
397
- return None
398
-
399
-
400
- # 生效条件:result 非 dict 返回 ok False;result.get("error") 真值返回 ok False「工人报错」;v=result.get("verdicts"),v is None 时从 result.get("content") or "" 经 _extract_json 取 dict,非 dict 返回 ok False,否则 v=obj.get("verdicts") 且 summary=obj.get("summary") or summary;v 非 list 返回 ok False;否则返回 ok True、verdicts=v、summary=str(summary);
401
- def parse_opinions(result: dict) -> dict:
402
- """result.json → {"ok":True,"verdicts":[...],"summary":...}。
403
-
404
- 两形态都能收:
405
- · 执行器直写 {"ok":true,"verdicts":[...],"summary":...}
406
- · LLM 文本 {"ok":true,"content":"{...JSON...}"}(exec.py 默认形态)
407
- """
408
- if not isinstance(result, dict):
409
- return {"ok": False, "error": "result 非对象"}
410
- if result.get("error"):
411
- return {"ok": False, "error": "工人报错:%s" % result["error"]}
412
- v = result.get("verdicts")
413
- summary = result.get("summary") or ""
414
- if v is None:
415
- obj = _extract_json(result.get("content") or "")
416
- if not isinstance(obj, dict):
417
- return {"ok": False, "error": "未能从 content 中解析 JSON 意见块"}
418
- v = obj.get("verdicts")
419
- summary = obj.get("summary") or summary
420
- if not isinstance(v, list):
421
- return {"ok": False, "error": "verdicts 非数组(got %s)" % type(v).__name__}
422
- return {"ok": True, "verdicts": v, "summary": str(summary)}
423
-
424
-
425
- # 生效条件:v 经 str(v or "").strip().upper() 得 s,若 s 在模块级 VERDICTS 中则返回 s,否则返回 None;
426
- def _norm_verdict(v):
427
- s = str(v or "").strip().upper()
428
- return s if s in VERDICTS else None
429
-
430
-
431
- # 生效条件:op 非 dict 返回「意见非对象」;nid 为空返回「缺 node_id」;node_ids 非 None 且 nid 不在其中返回越界错误;_norm_verdict(op.get("verdict")) 为 None 返回「verdict 越界」;reason 去空格空返回「缺 reason」;vd=="REJECT" 且 evidence 去空格空返回「REJECT 缺 evidence」;否则返回 None;
432
- def validate_opinion(op, node_ids=None):
433
- """单条意见格式校验:合法返回 None,非法返回错误串。"""
434
- if not isinstance(op, dict):
435
- return "意见非对象"
436
- nid = str(op.get("node_id") or "").strip()
437
- if not nid:
438
- return "缺 node_id"
439
- if node_ids is not None and nid not in node_ids:
440
- return "node_id 不属于本包:%s" % nid
441
- vd = _norm_verdict(op.get("verdict"))
442
- if vd is None:
443
- return "verdict 越界:%r" % (op.get("verdict"),)
444
- if not str(op.get("reason") or "").strip():
445
- return "缺 reason"
446
- if vd == "REJECT" and not str(op.get("evidence") or "").strip():
447
- return "REJECT 缺 evidence(有据才拒)"
448
- return None
449
-
450
-
451
- # 生效条件:verdicts 为假值(None/[])时 total=0、rate=1.0、ok=False;否则逐条 validate_opinion,无效记入 invalid,有效项复制并写入 _norm_verdict(op.get("verdict")),最后返回 total、valid、invalid、rate=len(valid)/total、ok=bool(valid) and not invalid;
452
- def validate_opinions(verdicts, node_ids=None) -> dict:
453
- """批量校验:valid/invalid 明细 + 通过率(用于 100% 口径断言)。"""
454
- total = len(verdicts or [])
455
- valid, invalid = [], []
456
- for i, op in enumerate(verdicts or []):
457
- err = validate_opinion(op, node_ids)
458
- if err:
459
- invalid.append({"index": i, "error": err,
460
- "node_id": (op.get("node_id")
461
- if isinstance(op, dict) else None)})
462
- continue
463
- op = dict(op)
464
- op["verdict"] = _norm_verdict(op.get("verdict"))
465
- valid.append(op)
466
- rate = 1.0 if total == 0 else len(valid) / float(total)
467
- return {"total": total, "valid": valid, "invalid": invalid,
468
- "pass_rate": rate, "ok": bool(valid) and not invalid}
469
-
470
-
471
- # ---- 级 5-B · 落库(verify 令牌 + writepipe 六道闸;不自造通道)-----------
472
-
473
- # 生效条件:当 actor 给出时,从 TK.role_spec('verify') 读取 clearance_cap/can_write/can_admin/layers_allow 构造 Principal;session 为假值时生成 'mrev_' + uuid 前 12 位;layers_allow 为假值时回落 spec.get('layers_allow') 或 [];ops_allow 原样传入。
474
- def verifier_principal(*, actor="mreview-verifier", session=None,
475
- layers_allow=None, ops_allow=None) -> Principal:
476
- """验证单元 Principal——角色规格取自 tokens 真源(避免手写漂移)。"""
477
- spec = TK.role_spec("verify")
478
- return Principal(actor=actor, clearance=spec.get("clearance_cap") or "internal",
479
- can_write=bool(spec.get("can_write")),
480
- can_admin=bool(spec.get("can_admin")),
481
- role="verify", unit="verify",
482
- session=session or ("mrev_" + uuid.uuid4().hex[:12]),
483
- layers_allow=list(layers_allow or spec.get("layers_allow") or []),
484
- ops_allow=ops_allow, auth_mode="mreview")
485
-
486
-
487
- # 生效条件:pkg、opinions、reviewer 给定时恒返回 "\n".join(L);summary 为真值才追加「整包结论」行,invalid 为真值才追加「【未落库条目】」行,二者取默认 "" / None 时不追加;
488
- def opinion_doc(pkg: dict, opinions: list, *, reviewer: str, summary="",
489
- invalid=None) -> str:
490
- """评审意见节点正文(核心修改四要素:内容/原因/位置/验证)。"""
491
- cnt = {k: 0 for k in VERDICTS}
492
- for o in opinions:
493
- cnt[_norm_verdict(o.get("verdict")) or "?"] = \
494
- cnt.get(_norm_verdict(o.get("verdict")) or "?", 0) + 1
495
- dist = " / ".join("%s %d" % (k, cnt.get(k, 0)) for k in VERDICTS)
496
- L = ["# 记忆评审意见 · 包 %s(%s/%s,%d 节点)"
497
- % (pkg.get("bundle_id"), pkg.get("group_kind"), pkg.get("group_key"),
498
- len(pkg.get("entries") or [])),
499
- "来源:级 4 蜂巢并发评审(评审者=%s)" % reviewer,
500
- "裁决分布:%s" % dist]
501
- if summary:
502
- L.append("整包结论:%s" % summary)
503
- L.append("")
504
- for o in opinions:
505
- seg = "- [%s] %s:%s" % (_norm_verdict(o.get("verdict")) or "?",
506
- o.get("node_id"),
507
- str(o.get("reason") or "").strip())
508
- ev = str(o.get("evidence") or "").strip()
509
- if ev:
510
- seg += "(证据:%s)" % ev[:300]
511
- L.append(seg)
512
- if invalid:
513
- L.append("")
514
- L.append("【未落库条目】%s" % json.dumps(invalid, ensure_ascii=False))
515
- L.append("")
516
- L.append("【内容】级 4 并发评审对包 %s 的逐节点裁决意见。" % pkg.get("bundle_id"))
517
- L.append("【原因】机械层已过滤确定性缺陷,语义判断留给验证单元;意见落 contextual "
518
- "供治理层决策——评审不改知识层。")
519
- L.append("【位置】源包 group=%s/%s(%d 节点)。"
520
- % (pkg.get("group_kind"), pkg.get("group_key"),
521
- len(pkg.get("entries") or [])))
522
- L.append("【验证】机械规则命中 %d 条;意见格式校验 %d/%d 通过(越界条目已剔除)。"
523
- % (len((pkg.get("_asm") or {}).get("mechanical") or []),
524
- len(opinions), len(opinions) + len(invalid or [])))
525
- return "\n".join(L)
526
-
527
-
528
- # 生效条件:cg/pkg/opinions/reviewer/applier 给定,CC.detect_self_verify 判 reviewer 与 applier 同一→refused self_verify_disallowed;opinions 为空→ok True skipped no_opinions;dry_run 真→ok True committed False;否则 (pipe or WP.default_pipeline()).execute,AccessDenied→refused layer_denied,其他异常→write_error,成功→ok 取 out.ok、committed 取 out.committed、moved_to 取 out.moved_to、deferred=bool(out.moved_to) and not out.committed;
529
- def apply_opinions(cg, pkg: dict, opinions: list, *, reviewer, applier,
530
- dry_run=False, pipe=None, layer=OPINION_LAYER,
531
- importance=0.4, tags=None, node_id=None,
532
- summary="", invalid=None) -> dict:
533
- """落库单包意见(级 5 唯一的写入口)。
534
-
535
- 顺序(任一环不过即不落库):
536
- 1 自验违例检测(评审者 ≠ 落库裁决者,判据复用 crosscheck)
537
- 2 意见非空(全 DEFER 且空 → 不写,零噪声)
538
- 3 verify 令牌 + writepipe 六道闸 + 库层 require_layer_write
539
- 4 合规规则库(部署侧 MDCG_POLICY_FILE)——audit 的 text 验证器在**无规则**
540
- 时恒 DEFER(audit._rule_check「无规则不能假装合规」),意见将转审核队列
541
- (`moved_to="review_queue"`)而非落盘。这是设计行为不是故障:本函数把
542
- 去向如实透出为 `moved_to` / `deferred`,**不把「入队」报成「落库」**。
543
- """
544
- rows = [{"unit": CC.REFLECT_UNIT, "actor": str(reviewer or "")},
545
- {"unit": CC.VERIFY_UNIT, "actor": str(applier or "")}]
546
- if CC.detect_self_verify(rows):
547
- return {"ok": False, "committed": False, "refused": True,
548
- "reason": "self_verify_disallowed",
549
- "detail": "评审者与落库裁决者为同一执行者(%s)——自验被拒(§7)"
550
- % reviewer}
551
- if not opinions:
552
- return {"ok": True, "committed": False, "skipped": True,
553
- "reason": "no_opinions(无有效意见,零噪声不落库)"}
554
- nid = node_id or ("mr_opinion_" + _safe(pkg.get("bundle_id")))
555
- doc = opinion_doc(pkg, opinions, reviewer=str(reviewer), summary=summary,
556
- invalid=invalid)
557
- if dry_run:
558
- return {"ok": True, "committed": False, "dry_run": True, "node_id": nid,
559
- "doc_len": len(doc)}
560
- a = {"node_id": nid, "content": doc, "layer": layer,
561
- "tags": list(tags or ["cap:记忆评审", "mreview", "opinion",
562
- "bundle:" + _safe(pkg.get("bundle_id"))]),
563
- "importance": float(importance), "verification_basis": OPINION_BASIS,
564
- "content_kind": "text",
565
- # 意见是评审产物(contextual),不参与知识层冲突判定:冲突闸若命中会
566
- # 把意见当冲突源转入审核队列(语义不符),故显式跳过(闸层可关,
567
- # 库层 require_layer_write 不可关——评审不改知识层的结构约束仍在)。
568
- "consistency": False}
569
- try:
570
- out = (pipe or WP.default_pipeline()).execute(cg, a)
571
- except AccessDenied as exc:
572
- # 结构性拒绝(如 layer=knowledge 越出 verify 令牌的 layers_allow):
573
- # 如实上报为拒写,不吞异常也不改写写入语义(§7 反面清单第 1 条)。
574
- return {"ok": False, "committed": False, "refused": True,
575
- "reason": "layer_denied", "node_id": nid, "layer": layer,
576
- "detail": "%s: %s" % (type(exc).__name__, exc)}
577
- except Exception as exc: # noqa: BLE001
578
- return {"ok": False, "committed": False, "refused": False,
579
- "reason": "write_error", "node_id": nid, "layer": layer,
580
- "detail": "%s: %s" % (type(exc).__name__, exc)}
581
- return {"ok": bool(out.get("ok")), "committed": bool(out.get("committed")),
582
- "moved_to": out.get("moved_to"),
583
- # 「改了去向但没落盘」(如合规/冲突闸转审核队列、gated 的 DROP/DEFER)
584
- # 与「落盘」是两种结局:分开报,调用方不必读 response 才能分辨。
585
- "deferred": bool(out.get("moved_to")) and not out.get("committed"),
586
- "node_id": nid, "layer": layer, "response": out,
587
- "doc_len": len(doc)}
588
-
589
-
590
- # ---- 编排 ----------------------------------------------------------------
591
-
592
- # 生效条件:pkg/asm/cg 给定,exe=hive_exe(exe),jobs_dir/ctx_dir 假值回落到 tempfile.gettempdir() 下路径;dump_context 后 build_spec、submit,若 submit 无 ok 或无 _job_id 返回 stage submit;wait_jobs 后若 failed 或 done 空返回 stage wait;read_result+parse_opinions 失败返回 stage parse;否则 validate_opinions 并 apply_opinions,返回 ok=app.ok 及计数;
593
- def run_package(*, pkg, asm, cg, exe=None, jobs_dir=None, ctx_dir=None,
594
- reviewer="mreview-worker", applier="mreview-applier",
595
- model=None, timeout_s=900, interval_s=1.0, dry_run=False,
596
- keep_jobs=True) -> dict:
597
- """单包全链路:dump context → submit → wait → parse → validate → apply。"""
598
- exe = hive_exe(exe)
599
- jobs_dir = jobs_dir or os.path.join(tempfile.gettempdir(), "mrev_jobs")
600
- ctx_dir = ctx_dir or os.path.join(tempfile.gettempdir(), "mrev_ctx")
601
- ctx_files = dump_context(pkg, asm, ctx_dir)
602
- spec = build_spec(pkg, asm, context_files=ctx_files, model=model,
603
- timeout_s=timeout_s)
604
- sub = submit(exe, jobs_dir, spec)
605
- if not sub.get("ok") or not _job_id(sub):
606
- return {"ok": False, "stage": "submit", "error": sub.get("error"),
607
- "submit": sub, "bundle_id": pkg.get("bundle_id")}
608
- jid = str(_job_id(sub))
609
- w = wait_jobs(exe, jobs_dir, [jid], timeout_s=timeout_s,
610
- interval_s=interval_s)
611
- if w.get("failed") or not w.get("done"):
612
- return {"ok": False, "stage": "wait", "job_id": jid, "wait": w,
613
- "bundle_id": pkg.get("bundle_id")}
614
- res = read_result(jobs_dir, jid)
615
- parsed = parse_opinions(res)
616
- if not parsed.get("ok"):
617
- return {"ok": False, "stage": "parse", "job_id": jid, "error":
618
- parsed.get("error"), "bundle_id": pkg.get("bundle_id")}
619
- nids = {str(e.get("node_id")) for e in (pkg.get("entries") or [])
620
- if e.get("node_id")}
621
- val = validate_opinions(parsed["verdicts"], nids or None)
622
- pkg2 = dict(pkg, _asm=asm)
623
- app = apply_opinions(cg, pkg2, val["valid"], reviewer=reviewer,
624
- applier=applier, dry_run=dry_run,
625
- summary=parsed.get("summary"), invalid=val["invalid"])
626
- return {"ok": bool(app.get("ok")), "bundle_id": pkg.get("bundle_id"),
627
- "job_id": jid, "opinions": len(parsed["verdicts"]),
628
- "valid": len(val["valid"]), "invalid": len(val["invalid"]),
629
- "pass_rate": val["pass_rate"], "deferred": bool(app.get("deferred")),
630
- "apply": app, "stages": {"submit": True, "wait": True, "parse": True}}
631
-
632
-
633
- # 生效条件:pairs/cg 给定,先对每对 pkg,asm 执行 dump_context/build_spec/submit,收集 ok 且有 job_id 的 jids;wait_jobs 后逐 jid 若 state!="done" 记 stage wait,否则 read_result/parse_opinions/validate_opinions/apply_opinions 并累计;返回 ok=all(results.ok) and bool(results) 及聚合计数;
634
- def run_batch(*, pairs, cg, exe=None, jobs_dir=None, ctx_dir=None,
635
- reviewer="mreview-worker", applier="mreview-applier", model=None,
636
- timeout_s=1800, interval_s=1.0, dry_run=False, on_tick=None) -> dict:
637
- """批量并发:先全投递(hive worker 池并发消费),再统一等候,再逐包落库。
638
-
639
- 并发发生在**投递之后**——本函数投递不阻塞,故 N 包的墙钟≈最慢一包。
640
- """
641
- exe = hive_exe(exe)
642
- jobs_dir = jobs_dir or os.path.join(tempfile.gettempdir(), "mrev_jobs")
643
- ctx_dir = ctx_dir or os.path.join(tempfile.gettempdir(), "mrev_ctx")
644
- os.makedirs(jobs_dir, exist_ok=True)
645
- staged, posted, jids = [], [], []
646
- for pkg, asm in pairs:
647
- ctx_files = dump_context(pkg, asm, ctx_dir)
648
- spec = build_spec(pkg, asm, context_files=ctx_files, model=model,
649
- timeout_s=timeout_s)
650
- sub = submit(exe, jobs_dir, spec)
651
- staged.append({"bundle_id": pkg.get("bundle_id"), "pkg": pkg,
652
- "asm": asm, "submit": sub})
653
- if sub.get("ok") and _job_id(sub):
654
- jid = str(_job_id(sub))
655
- jids.append(jid)
656
- posted.append(staged[-1])
657
- w = wait_jobs(exe, jobs_dir, jids, timeout_s=timeout_s,
658
- interval_s=interval_s, on_tick=on_tick)
659
- by_jid = {}
660
- for i, s in enumerate(staged):
661
- if s["submit"].get("ok") and _job_id(s["submit"]):
662
- by_jid[str(_job_id(s["submit"]))] = s
663
- results, ok_n, valid_n, invalid_n, applied_n, deferred_n = [], 0, 0, 0, 0, 0
664
- for jid in jids:
665
- s = by_jid.get(jid) or {}
666
- pkg, asm = s.get("pkg") or {}, s.get("asm") or {}
667
- state = (w.get("states") or {}).get(jid)
668
- if state != "done":
669
- results.append({"ok": False, "bundle_id": pkg.get("bundle_id"),
670
- "job_id": jid, "stage": "wait", "state": state})
671
- continue
672
- res = read_result(jobs_dir, jid)
673
- parsed = parse_opinions(res)
674
- if not parsed.get("ok"):
675
- results.append({"ok": False, "bundle_id": pkg.get("bundle_id"),
676
- "job_id": jid, "stage": "parse",
677
- "error": parsed.get("error")})
678
- continue
679
- nids = {str(e.get("node_id")) for e in (pkg.get("entries") or [])
680
- if e.get("node_id")}
681
- val = validate_opinions(parsed["verdicts"], nids or None)
682
- app = apply_opinions(cg, dict(pkg, _asm=asm), val["valid"],
683
- reviewer=reviewer, applier=applier,
684
- dry_run=dry_run, summary=parsed.get("summary"),
685
- invalid=val["invalid"])
686
- ok_n += 1
687
- valid_n += len(val["valid"])
688
- invalid_n += len(val["invalid"])
689
- applied_n += 1 if app.get("committed") else 0
690
- deferred_n += 1 if app.get("deferred") else 0
691
- results.append({"ok": bool(app.get("ok")),
692
- "bundle_id": pkg.get("bundle_id"), "job_id": jid,
693
- "opinions": len(parsed["verdicts"]),
694
- "valid": len(val["valid"]), "invalid": len(val["invalid"]),
695
- "pass_rate": val["pass_rate"],
696
- "deferred": bool(app.get("deferred")), "apply": app})
697
- total_op = valid_n + invalid_n
698
- return {"ok": all(r.get("ok") for r in results) and bool(results),
699
- "jobs": len(jids), "submitted": len(posted),
700
- "done": len(w.get("done") or []), "failed": w.get("failed") or [],
701
- "packages": len(results), "opinions": total_op,
702
- "valid": valid_n, "invalid": invalid_n,
703
- "pass_rate": (1.0 if total_op == 0 else valid_n / float(total_op)),
704
- "committed": applied_n, "deferred": deferred_n,
705
- "results": results, "wait": w}
706
-
707
-
708
- # ---- CLI -----------------------------------------------------------------
709
-
710
- # 生效条件:当 argv 给出时,argparse 解析命令行;root 取 a.root 或 os.environ.get('MDCG_ROOT'),若 root 为假值则 SystemExit;否则用 verifier_principal(actor=a.applier) 构造 MdCGSecure,build_packages(root=root, limit=None) 得到 pairs,按 a.packages(假值 0 则取全部)切片,run_batch 以 dry_run=(a.dry_run or not a.apply) 运行,打印 JSON 报告,返回 0(rep['ok'] 为真)或 1。
711
- def main(argv=None): # pragma: no cover
712
- import argparse
713
- ap = argparse.ArgumentParser(prog="python -m md_cg.mreview.pipeline",
714
- description="记忆评审 级4 蜂巢并发 + 级5 落库")
715
- ap.add_argument("--root", default=None, help="认知图根(缺省 MDCG_ROOT)")
716
- ap.add_argument("--packages", type=int, default=10, help="试跑包数(0=全部)")
717
- ap.add_argument("--jobs", default=None, help="hive jobs 目录(隔离生产)")
718
- ap.add_argument("--ctx", default=None, help="context 文件目录")
719
- ap.add_argument("--hive", default=None, help="hive 可执行文件")
720
- ap.add_argument("--model", default=None, help="模型名")
721
- ap.add_argument("--timeout", type=float, default=1800.0)
722
- ap.add_argument("--reviewer", default="mreview-worker")
723
- ap.add_argument("--applier", default="mreview-applier")
724
- ap.add_argument("--dry-run", action="store_true", help="只校验不落库")
725
- ap.add_argument("--apply", action="store_true", help="实际落库(缺省不写)")
726
- a = ap.parse_args(argv)
727
- from .. import mdcos
728
- root = a.root or os.environ.get("MDCG_ROOT")
729
- if not root:
730
- raise SystemExit("缺少 --root 或 MDCG_ROOT(拒绝在未知根上运行)")
731
- cg = mdcos.MdCGSecure(root, principal=verifier_principal(actor=a.applier))
732
- built = build_packages(root=root, limit=None)
733
- pairs = built["pairs"][:a.packages] if a.packages else built["pairs"]
734
- rep = run_batch(pairs=pairs, cg=cg, exe=a.hive, jobs_dir=a.jobs,
735
- ctx_dir=a.ctx, reviewer=a.reviewer, applier=a.applier,
736
- model=a.model, timeout_s=a.timeout,
737
- dry_run=(a.dry_run or not a.apply))
738
- print(json.dumps(rep, ensure_ascii=False, indent=2))
739
- return 0 if rep.get("ok") else 1
740
-
741
-
742
- if __name__ == "__main__": # pragma: no cover
1
+ # -*- coding: utf-8 -*-
2
+ """记忆评审流水线 · 级 4 蜂巢并发对接(spec 构造/投递/收卷)+ 级 5 意见落库治理。
3
+
4
+ 真源:docs/记忆评审系统_立项设计与施工交接_20260915.md §5(spec/result 契约)
5
+ §7(反面清单:评审不直接改知识层 / 意见必过 verify 令牌 / 不确定 DEFER)
6
+
7
+ 五级分工:级 1-3(M1)=候选→捆包→规则装配,产出 (pkg, asm) 对;
8
+ 级 4(本模块)=每对 → hive spec → submit → poll 收卷(真并发、文件协议留痕);
9
+ 级 5(本模块)=意见格式校验 → verify 令牌过 writepipe 六道闸落 contextual。
10
+
11
+ 纪律是结构性的,不靠自觉:
12
+ · 评审不改知识层:落库层固定 contextual,verify 令牌 layers_allow 不含 knowledge
13
+ ——库层 require_layer_write 拦截,任何拦截器都绕不过(§7 反面清单第 1 条)。
14
+ · 自验禁止:产出意见者(reflect)与落库裁决者(verify)不得同一 actor,判据
15
+ 复用 crosscheck.detect_self_verify(不另造判据,保持真源单一)。
16
+ · 不确定即 DEFER:解析失败/格式越界一律不落库(Precision over noise)。
17
+ · 零写入面:worker 只读 spec/context、只写自己的 result.json;认知图写入只发生在
18
+ 收卷后的 apply_opinions(本模块,走 writepipe 通道)。
19
+
20
+ 运行:python -m md_cg.mreview.pipeline --help
21
+ """
22
+ from __future__ import annotations
23
+
24
+ import json
25
+ import os
26
+ import re
27
+ import subprocess
28
+ import tempfile
29
+ import time
30
+ import uuid
31
+
32
+ from .. import crosscheck as CC
33
+ from .. import tokens as TK
34
+ from .. import writepipe as WP
35
+ from ..security import AccessDenied, Principal
36
+ from . import candidates as CD
37
+ from . import bundle as BD
38
+ from . import ruleset as RS
39
+
40
+ __all__ = [
41
+ "VERDICTS", "OPINION_LAYER", "DEFAULT_MODEL", "TERMINAL_STATES",
42
+ "hive_exe", "build_packages", "build_prompt", "build_spec", "dump_context",
43
+ "submit", "submit_many", "poll", "wait_jobs", "read_result", "collect",
44
+ "parse_opinions", "validate_opinion", "validate_opinions",
45
+ "verifier_principal", "opinion_doc", "apply_opinions", "run_package",
46
+ "run_batch", "main",
47
+ ]
48
+
49
+ # ---- 常量 ----------------------------------------------------------------
50
+
51
+ VERDICTS = ("ACCEPT", "DEFER", "REJECT", "BLINDSPOT") # 意见四态(资格裁决同源)
52
+ OPINION_LAYER = "contextual" # verify 令牌 layers_allow=rejected/contextual
53
+ OPINION_BASIS = "measurement" # 意见的验证基底:确定性规则命中 + 复核
54
+ TERMINAL_STATES = ("done", "error", "timeout", "killed")
55
+ DEFAULT_MODEL = "glm-4-flash"
56
+ _ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
57
+
58
+ SYSTEM_PROMPT = """你是记忆评审流水线中的【验证单元】。
59
+
60
+ 职责边界(违反即无效):
61
+ 1. 只对给定节点清单逐条裁决,不得引入清单外的节点。
62
+ 2. 只输出意见,不改写任何记忆——你没有写入通道,也不需要。
63
+ 3. 不确定就 DEFER(硬纪律):宁可漏判,不可错判。
64
+ 4. 只有拿得出证据时才 REJECT;说不出证据就 DEFER。
65
+ 5. ACCEPT 表示「已确认适用」,不是「没发现问题」——正条件无法确认时用 DEFER。
66
+
67
+ 四态语义:
68
+ - ACCEPT 已确认适用
69
+ - DEFER 条件不足/无法确认(默认落点)
70
+ - REJECT 有据否定(冲突/来源许可不足/重复且劣于既有)
71
+ - BLINDSPOT 当前观测位置看不见(不是"不知道",是"这个位置判断不了")
72
+
73
+ 输出契约(严格 JSON,无额外文字、无 markdown 围栏):
74
+ {"verdicts": [{"node_id": "...", "verdict": "ACCEPT|DEFER|REJECT|BLINDSPOT",
75
+ "reason": "一句话理由", "evidence": "证据(REJECT 必填)"}],
76
+ "summary": "整包一句话结论"}
77
+ 清单中每个节点都要有一条裁决,一条不多一条不少。"""
78
+
79
+
80
+ # ---- 级 4-A · spec 构造 ---------------------------------------------------
81
+
82
+ # 生效条件:exe 为真值时返回 str(exe),否则 HIVE_EXE 经 (os.environ.get("HIVE_EXE") or "").strip() 后非空则返回该值,否则按 os.name 返回 os.path.join(_ROOT, "hive", "target", "release", "hive.exe" 或 "hive");
83
+ def hive_exe(exe=None) -> str:
84
+ """蜂巢可执行文件:显式参数 > HIVE_EXE > 仓内 release 构建。"""
85
+ if exe:
86
+ return str(exe)
87
+ env = (os.environ.get("HIVE_EXE") or "").strip()
88
+ if env:
89
+ return env
90
+ name = "hive.exe" if os.name == "nt" else "hive"
91
+ return os.path.join(_ROOT, "hive", "target", "release", name)
92
+
93
+
94
+ # 生效条件:name 为假值(None/""/0/False 等)时以 "pkg" 为输入,否则 str(name),结果经 re.sub(r"[^0-9A-Za-z_.\-]", "_", ...) 替换并截取前 120 字符;
95
+ def _safe(name) -> str:
96
+ return re.sub(r"[^0-9A-Za-z_.\-]", "_", str(name or "pkg"))[:120]
97
+
98
+
99
+ # 生效条件:path 与 obj 给定后,若 os.path.dirname(path) 非空则 os.makedirs 该目录,随后以 UTF-8、ensure_ascii=False、indent=2 将 obj 写入 path 并返回 path;
100
+ def _dump_json(path: str, obj) -> str:
101
+ d = os.path.dirname(path)
102
+ if d:
103
+ os.makedirs(d, exist_ok=True)
104
+ with open(path, "w", encoding="utf-8") as f:
105
+ json.dump(obj, f, ensure_ascii=False, indent=2)
106
+ return path
107
+
108
+
109
+ _ENTRY_KEYS = ("ref", "node_id", "proposal_id", "origin", "layer", "tags", "role",
110
+ "importance", "evidence_count", "verification_basis",
111
+ "lifecycle_state", "content_hash", "issue_kinds", "evidence",
112
+ "excerpt")
113
+
114
+
115
+ # 生效条件:pkg/asm/workdir 给定,base 取 _safe(pkg.get("bundle_id"))(bundle_id 假值→"pkg"),entries 取 pkg.get("entries") or [] 的前 int(entry_limit) 项且仅保留 _ENTRY_KEYS,写出 workdir/base.bundle.json 与 workdir/base.rules.json(asm 原样),返回这两个 join(workdir,...) 路径(workdir 相对时不保证绝对);
116
+ def dump_context(pkg: dict, asm: dict, workdir: str, *, entry_limit=64) -> list:
117
+ """包 + 规则装配 → context 文件(**绝对路径**,工人执行期内有效)。
118
+
119
+ 相对路径的解析基准是 spec.workdir,跨进程易错;绝对路径无歧义。
120
+ """
121
+ os.makedirs(workdir, exist_ok=True)
122
+ base = _safe(pkg.get("bundle_id"))
123
+ bp = os.path.join(workdir, base + ".bundle.json")
124
+ rp = os.path.join(workdir, base + ".rules.json")
125
+ ents = [{k: e.get(k) for k in _ENTRY_KEYS}
126
+ for e in (pkg.get("entries") or [])[:int(entry_limit)]]
127
+ _dump_json(bp, {"bundle_id": pkg.get("bundle_id"),
128
+ "group_kind": pkg.get("group_kind"),
129
+ "group_key": pkg.get("group_key"),
130
+ "size": pkg.get("size"), "entries": ents})
131
+ _dump_json(rp, asm)
132
+ return [bp, rp]
133
+
134
+
135
+ # 生效条件:pkg/asm 给定,节点清单标题恒输出、节点项取 pkg.get("entries") or [];机械命中取 asm.get("mechanical") or [],非空列前 int(max_mech) 条否则输出「无」,llm 取 asm.get("llm") or [] 非空列前 40 条;返回 join(L);
136
+ def build_prompt(pkg: dict, asm: dict, *, max_mech=120) -> str:
137
+ """user_prompt:节点清单 + 机械命中 + 待检问题 + 输出要求。"""
138
+ ents = pkg.get("entries") or []
139
+ L = ["【待评包】bundle_id=%s group=%s/%s 节点数=%d"
140
+ % (pkg.get("bundle_id"), pkg.get("group_kind"),
141
+ pkg.get("group_key"), len(ents)), ""]
142
+ L.append("【节点清单】(仅可裁决以下节点)")
143
+ for i, e in enumerate(ents, 1):
144
+ frag = (e.get("excerpt") or "").strip().replace("\n", " ")[:220]
145
+ L.append("%d) node_id=%s layer=%s basis=%s tags=%s"
146
+ % (i, e.get("node_id"), e.get("layer"),
147
+ e.get("verification_basis"),
148
+ ",".join(e.get("tags") or []) or "-"))
149
+ L.append(" 正文摘录:%s" % (frag or "(无正文/正文缺失)"))
150
+ if e.get("issue_kinds"):
151
+ L.append(" 机械初筛命中:%s" % ",".join(e["issue_kinds"]))
152
+ L.append("")
153
+ mech = asm.get("mechanical") or []
154
+ if mech:
155
+ L.append("【确定性规则命中】共 %d 条(机械层已给出,只需判断其语义后果)"
156
+ % len(mech))
157
+ for m in mech[:int(max_mech)]:
158
+ L.append("- [%s] %s :: %s"
159
+ % (m.get("issue_kind"), m.get("ref") or m.get("node_id"),
160
+ str(m.get("detail") or m.get("message") or "")[:160]))
161
+ else:
162
+ L.append("【确定性规则命中】无(本包未触发任何机械规则)")
163
+ L.append("")
164
+ llm = asm.get("llm") or []
165
+ if llm:
166
+ L.append("【待你判断的问题】逐项判断,并在 reason 中体现结论:")
167
+ for q in llm[:40]:
168
+ L.append("- (规则 %s / 检查 %s) %s"
169
+ % (q.get("rule_id"), q.get("check"), q.get("question")))
170
+ L.append("")
171
+ L.append("【输出】严格按 system 中的 JSON 契约,对每个 node_id 给出一条裁决。")
172
+ return "\n".join(L)
173
+
174
+
175
+ # 生效条件:pkg/asm 给定,model 按 model or os.environ.get('HIVE_MODEL') or DEFAULT_MODEL 取值(空串/假值均回落),context_files 按 list(context_files or []),timeout_s 转 int、temperature 转 float、max_tokens 转 int,node_ids 取 pkg.entries 中 node_id 真值的 str,返回含 meta 的 spec 字典;
176
+ def build_spec(pkg: dict, asm: dict, *, context_files=None, model=None,
177
+ timeout_s=600, temperature=0.0, max_tokens=4096) -> dict:
178
+ """(pkg, asm) → hive spec(文件协议的可投递单元)。"""
179
+ nids = [str(e.get("node_id")) for e in (pkg.get("entries") or [])
180
+ if e.get("node_id")]
181
+ return {"model": model or os.environ.get("HIVE_MODEL") or DEFAULT_MODEL,
182
+ "system_prompt": SYSTEM_PROMPT,
183
+ "user_prompt": build_prompt(pkg, asm),
184
+ "context_files": list(context_files or []),
185
+ "timeout_s": int(timeout_s),
186
+ "temperature": float(temperature),
187
+ "max_tokens": int(max_tokens),
188
+ # 归因元信息(hive 忽略;收卷侧用于配对与审计)
189
+ "meta": {"bundle_id": pkg.get("bundle_id"),
190
+ "group_kind": pkg.get("group_kind"),
191
+ "group_key": pkg.get("group_key"),
192
+ "size": pkg.get("size"), "node_ids": nids}}
193
+
194
+
195
+ # 生效条件:当模块级常量 CD.SOURCES 可用时,sources 为假值则回落 CD.SOURCES,调用 CD.generate 生成候选,再经 BD.bundle(c.get('candidates') or [], nodes, root, max_per_bundle) 与 RS.assemble_all(b, rules_dir) 组装,最终将 bundles 与 packages 按 zip 配对返回。
196
+ def build_packages(*, root=None, sources=None, limit=None, nodes=None,
197
+ max_per_bundle=50, rules_dir=None, now=None) -> dict:
198
+ """级 1-3 串联:候选 → 捆包 → 规则装配,产出配对的 (pkg, asm) 列表。"""
199
+ c = CD.generate(root, sources=sources or CD.SOURCES, nodes=nodes, limit=limit,
200
+ with_report=False, now=now)
201
+ b = BD.bundle(c.get("candidates") or [], nodes=nodes, root=root,
202
+ max_per_bundle=max_per_bundle)
203
+ a = RS.assemble_all(b, rules_dir=rules_dir)
204
+ pairs = []
205
+ for pkg, asm in zip(b.get("bundles") or [], a.get("packages") or []):
206
+ pairs.append((pkg, asm))
207
+ return {"candidates": c, "bundles": b, "assembled": a, "pairs": pairs}
208
+
209
+
210
+ # ---- 级 4-B · 投递 / 收卷 -------------------------------------------------
211
+
212
+ # 生效条件:argv 给定,环境变量副本强制 PYTHONUTF8="1",env 真值时用其 str 值更新,随后 subprocess.run(argv, capture_output=True, text=True, encoding="utf-8", errors="replace", env=e, timeout=timeout, cwd=cwd, input=stdin_text, shell=False);
213
+ def _run(argv, *, env=None, timeout=120, cwd=None, stdin_text=None):
214
+ """统一子进程入口:argv 列表 + 显式 UTF-8 + PYTHONUTF8=1,不经 shell(第15条)。"""
215
+ e = dict(os.environ)
216
+ e["PYTHONUTF8"] = "1"
217
+ if env:
218
+ e.update({k: str(v) for k, v in env.items()})
219
+ return subprocess.run(argv, capture_output=True, text=True, encoding="utf-8",
220
+ errors="replace", env=e, timeout=timeout, cwd=cwd,
221
+ input=stdin_text, shell=False)
222
+
223
+
224
+ # 生效条件:text 为假值时 (text or "").strip().splitlines() 为空、循环不执行并返回 None;否则从末尾行向前找以 "{" 开头且 json.loads 成功且 isinstance(obj, dict) 的行返回该 dict,未找到返回 None;
225
+ def _last_json(text: str):
226
+ """stdout 逐行解析取最后一个 JSON 对象(容忍前导日志行)。"""
227
+ for line in reversed((text or "").strip().splitlines()):
228
+ s = line.strip()
229
+ if not s.startswith("{"):
230
+ continue
231
+ try:
232
+ obj = json.loads(s)
233
+ except ValueError:
234
+ continue
235
+ if isinstance(obj, dict):
236
+ return obj
237
+ return None
238
+
239
+
240
+ # id 契约 v2(B8):`hive submit` 的四槽**必填**(身份/任务/单元显式声明,编号由 Rust
241
+ # 分配器独占创建给出)——缺任一 CLI 即显式报错退出(不许静默推导/空串兜底)。
242
+ # 评审流水线作为**提交方**在此声明自己的三槽(这不是「推导」:是本提交者的固定身份);
243
+ # 调用方 env 里已显式给定的同名键优先(B8 的 env 兜底口径),故部署侧可覆盖。
244
+ _SUBMIT_SLOT_ENV = {
245
+ "HIVE_JOB_IDENTITY": "灵枢评审",
246
+ "HIVE_JOB_TASK": "记忆评审M2",
247
+ "HIVE_JOB_UNIT": "验证单元",
248
+ }
249
+
250
+
251
+ # 生效条件:exe/jobs_dir/spec 给定,创建 jobs_dir 并在临时目录写 spec.json 后执行 [exe,"submit","--spec",sp,"--jobs",jobs_dir];returncode 非 0 返回 ok False + error,否则 _last_json(p.stdout) 为假(含 None/空 dict)返回 ok False「submit 输出非 JSON」,否则 d.setdefault("ok", True) 后返回 d;
252
+ def submit(exe: str, jobs_dir: str, spec: dict, *, timeout=120) -> dict:
253
+ """投递单包 spec → {"ok":True,"job_id":...};失败返回 ok=False + error。"""
254
+ os.makedirs(jobs_dir, exist_ok=True)
255
+ slots = {k: v for k, v in _SUBMIT_SLOT_ENV.items()
256
+ if not (os.environ.get(k) or "").strip()}
257
+ with tempfile.TemporaryDirectory(prefix="mrev_spec_") as td:
258
+ sp = _dump_json(os.path.join(td, "spec.json"), spec)
259
+ p = _run([exe, "submit", "--spec", sp, "--jobs", jobs_dir],
260
+ timeout=timeout, env=slots)
261
+ if p.returncode != 0:
262
+ return {"ok": False, "returncode": p.returncode,
263
+ "error": (p.stderr or p.stdout or "").strip()[:800]}
264
+ d = _last_json(p.stdout)
265
+ if not d:
266
+ return {"ok": False, "error": "submit 输出非 JSON",
267
+ "stdout": (p.stdout or "")[:800]}
268
+ d.setdefault("ok", True)
269
+ return d
270
+
271
+
272
+ # 生效条件:specs 为可迭代列表时逐项调用 submit(exe, jobs_dir, s, timeout=timeout) 并返回等长列表;specs 为空则返回空列表;
273
+ def submit_many(exe: str, jobs_dir: str, specs: list, *, timeout=120) -> list:
274
+ """批量投递(hive 侧并发消费;本函数逐条投递并保序配对)。"""
275
+ return [submit(exe, jobs_dir, s, timeout=timeout) for s in specs]
276
+
277
+
278
+ # 生效条件:exe/jobs_dir 给定,job_id 为真值时 argv 追加 str(job_id),假值(None/"")时仅列全部;运行后 returncode 非 0 返回 ok False + error,否则 _last_json(p.stdout) 为真值(非空 dict)时返回该 dict,为假值时返回 ok False「poll 输出非 JSON」;
279
+ def poll(exe: str, jobs_dir: str, job_id=None, *, timeout=120) -> dict:
280
+ """查询 job 状态(不传 job_id = 列出全部)。"""
281
+ argv = [exe, "poll"]
282
+ if job_id:
283
+ argv.append(str(job_id))
284
+ argv += ["--jobs", jobs_dir]
285
+ p = _run(argv, timeout=timeout)
286
+ if p.returncode != 0:
287
+ return {"ok": False, "returncode": p.returncode,
288
+ "error": (p.stderr or p.stdout or "").strip()[:800]}
289
+ d = _last_json(p.stdout)
290
+ return d or {"ok": False, "error": "poll 输出非 JSON",
291
+ "stdout": (p.stdout or "")[:800]}
292
+
293
+
294
+ # 生效条件:j.get("job_id") 为真值时返回该值,否则返回 j.get("id")(若 id 为 0/""/False 则原样返回该假值,若 id 缺失返回 None);
295
+ def _job_id(j: dict):
296
+ return j.get("job_id") or j.get("id")
297
+
298
+
299
+ # 生效条件:j.get("state") 为真值时返回 str(state);否则 j.get("status") 为 dict 时返回 str(status.get("state") or "");否则返回 str(status or "");
300
+ def _job_state(j: dict) -> str:
301
+ """state 读取兼容两种形态(扁平 / status 嵌套);仅供轮询判终态。"""
302
+ s = j.get("state")
303
+ if s:
304
+ return str(s)
305
+ st = j.get("status")
306
+ if isinstance(st, dict):
307
+ return str(st.get("state") or "")
308
+ return str(st or "")
309
+
310
+
311
+ # 生效条件:exe/jobs_dir 给定,job_ids 真值集合限观测;循环 poll 直到 pending 为空且(want 为 None 或 want <= 已观测)返回 ok=not failed,若 pending 非空或 want 未全观测且到 max(1.0,float(timeout_s)) 截止则返回 ok False + error,每次间隔 sleep(max(0.05,float(interval_s)));
312
+ def wait_jobs(exe: str, jobs_dir: str, job_ids=None, *, timeout_s=900,
313
+ interval_s=1.0, on_tick=None) -> dict:
314
+ """轮询至全部终态(或超时)→ done/failed/pending 三分类 + 原始快照。"""
315
+ want = set(str(x) for x in (job_ids or [])) or None
316
+ deadline = time.time() + max(1.0, float(timeout_s))
317
+ last = {}
318
+ while True:
319
+ r = poll(exe, jobs_dir)
320
+ states = {}
321
+ for j in (r.get("jobs") or []):
322
+ jid = _job_id(j)
323
+ if jid is None:
324
+ continue
325
+ jid = str(jid)
326
+ if want is not None and jid not in want:
327
+ continue
328
+ states[jid] = _job_state(j) or "pending"
329
+ last[jid] = j
330
+ done = sorted(k for k, v in states.items() if v == "done")
331
+ failed = sorted(k for k, v in states.items()
332
+ if v in TERMINAL_STATES and v != "done")
333
+ pending = sorted(k for k, v in states.items() if v not in TERMINAL_STATES)
334
+ if on_tick:
335
+ on_tick({"states": dict(states), "done": len(done),
336
+ "pending": len(pending), "failed": len(failed)})
337
+ if not pending:
338
+ if want is None or want <= set(states):
339
+ return {"ok": not failed, "done": done, "failed": failed,
340
+ "pending": [], "states": states, "jobs": last}
341
+ if time.time() >= deadline:
342
+ miss = sorted(want - set(states))
343
+ return {"ok": False, "done": done, "failed": failed,
344
+ "pending": miss, "states": states, "jobs": last,
345
+ "error": "未在超时内观测到 job:%s" % ",".join(miss)}
346
+ if time.time() >= deadline:
347
+ return {"ok": False, "done": done, "failed": failed,
348
+ "pending": pending, "states": states, "jobs": last,
349
+ "error": "等待终态超时(%ss)" % timeout_s}
350
+ time.sleep(max(0.05, float(interval_s)))
351
+
352
+
353
+ # 生效条件:jobs_dir/job_id 给定,join(jobs_dir,str(job_id),"result.json") 路径缺失时返回 ok False「result.json 不存在」,读取时 OSError/ValueError 返回 ok False「读取失败」,json 对象非 dict 返回 ok False「result 非对象」,否则返回该 dict;
354
+ def read_result(jobs_dir: str, job_id: str) -> dict:
355
+ """读工人产出(job 目录的 result.json)。"""
356
+ p = os.path.join(jobs_dir, str(job_id), "result.json")
357
+ if not os.path.isfile(p):
358
+ return {"ok": False, "error": "result.json 不存在:%s" % p}
359
+ try:
360
+ with open(p, encoding="utf-8") as f:
361
+ obj = json.load(f)
362
+ except (OSError, ValueError) as exc:
363
+ return {"ok": False, "error": "result.json 读取失败:%s" % exc}
364
+ return obj if isinstance(obj, dict) else {"ok": False, "error": "result 非对象"}
365
+
366
+
367
+ # 生效条件:jobs_dir/job_ids 给定,job_ids 为假值(None/[])时返回空 dict,否则返回 {str(j): read_result(jobs_dir, j) for j in job_ids};
368
+ def collect(jobs_dir: str, job_ids) -> dict:
369
+ """按 job_id 收卷(读 result.json),返回 {job_id: result} 保序映射。"""
370
+ return {str(j): read_result(jobs_dir, j) for j in (job_ids or [])}
371
+
372
+
373
+ # ---- 级 5-A · 意见解析与格式校验(校验率 100% 是验收口径)-----------------
374
+
375
+ # 生效条件:text 去空格后为空返回 None;否则先 try json.loads(整体),成功返回;否则找 ```(?:json)?...``` 围栏内 json.loads 成功返回;否则取 s.find("{") 与 s.rfind("}") 且 0<=i<k 的切片 json.loads 成功返回;均失败返回 None;
376
+ def _extract_json(text: str):
377
+ """从模型文本抽 JSON 对象:整体 → ```围栏``` → 首尾大括号切片。"""
378
+ s = (text or "").strip()
379
+ if not s:
380
+ return None
381
+ try:
382
+ return json.loads(s)
383
+ except ValueError:
384
+ pass
385
+ m = re.search(r"```(?:json)?\s*(.+?)```", s, re.S)
386
+ if m:
387
+ try:
388
+ return json.loads(m.group(1).strip())
389
+ except ValueError:
390
+ pass
391
+ i, k = s.find("{"), s.rfind("}")
392
+ if 0 <= i < k:
393
+ try:
394
+ return json.loads(s[i:k + 1])
395
+ except ValueError:
396
+ pass
397
+ return None
398
+
399
+
400
+ # 生效条件:result 非 dict 返回 ok False;result.get("error") 真值返回 ok False「工人报错」;v=result.get("verdicts"),v is None 时从 result.get("content") or "" 经 _extract_json 取 dict,非 dict 返回 ok False,否则 v=obj.get("verdicts") 且 summary=obj.get("summary") or summary;v 非 list 返回 ok False;否则返回 ok True、verdicts=v、summary=str(summary);
401
+ def parse_opinions(result: dict) -> dict:
402
+ """result.json → {"ok":True,"verdicts":[...],"summary":...}。
403
+
404
+ 两形态都能收:
405
+ · 执行器直写 {"ok":true,"verdicts":[...],"summary":...}
406
+ · LLM 文本 {"ok":true,"content":"{...JSON...}"}(exec.py 默认形态)
407
+ """
408
+ if not isinstance(result, dict):
409
+ return {"ok": False, "error": "result 非对象"}
410
+ if result.get("error"):
411
+ return {"ok": False, "error": "工人报错:%s" % result["error"]}
412
+ v = result.get("verdicts")
413
+ summary = result.get("summary") or ""
414
+ if v is None:
415
+ obj = _extract_json(result.get("content") or "")
416
+ if not isinstance(obj, dict):
417
+ return {"ok": False, "error": "未能从 content 中解析 JSON 意见块"}
418
+ v = obj.get("verdicts")
419
+ summary = obj.get("summary") or summary
420
+ if not isinstance(v, list):
421
+ return {"ok": False, "error": "verdicts 非数组(got %s)" % type(v).__name__}
422
+ return {"ok": True, "verdicts": v, "summary": str(summary)}
423
+
424
+
425
+ # 生效条件:v 经 str(v or "").strip().upper() 得 s,若 s 在模块级 VERDICTS 中则返回 s,否则返回 None;
426
+ def _norm_verdict(v):
427
+ s = str(v or "").strip().upper()
428
+ return s if s in VERDICTS else None
429
+
430
+
431
+ # 生效条件:op 非 dict 返回「意见非对象」;nid 为空返回「缺 node_id」;node_ids 非 None 且 nid 不在其中返回越界错误;_norm_verdict(op.get("verdict")) 为 None 返回「verdict 越界」;reason 去空格空返回「缺 reason」;vd=="REJECT" 且 evidence 去空格空返回「REJECT 缺 evidence」;否则返回 None;
432
+ def validate_opinion(op, node_ids=None):
433
+ """单条意见格式校验:合法返回 None,非法返回错误串。"""
434
+ if not isinstance(op, dict):
435
+ return "意见非对象"
436
+ nid = str(op.get("node_id") or "").strip()
437
+ if not nid:
438
+ return "缺 node_id"
439
+ if node_ids is not None and nid not in node_ids:
440
+ return "node_id 不属于本包:%s" % nid
441
+ vd = _norm_verdict(op.get("verdict"))
442
+ if vd is None:
443
+ return "verdict 越界:%r" % (op.get("verdict"),)
444
+ if not str(op.get("reason") or "").strip():
445
+ return "缺 reason"
446
+ if vd == "REJECT" and not str(op.get("evidence") or "").strip():
447
+ return "REJECT 缺 evidence(有据才拒)"
448
+ return None
449
+
450
+
451
+ # 生效条件:verdicts 为假值(None/[])时 total=0、rate=1.0、ok=False;否则逐条 validate_opinion,无效记入 invalid,有效项复制并写入 _norm_verdict(op.get("verdict")),最后返回 total、valid、invalid、rate=len(valid)/total、ok=bool(valid) and not invalid;
452
+ def validate_opinions(verdicts, node_ids=None) -> dict:
453
+ """批量校验:valid/invalid 明细 + 通过率(用于 100% 口径断言)。"""
454
+ total = len(verdicts or [])
455
+ valid, invalid = [], []
456
+ for i, op in enumerate(verdicts or []):
457
+ err = validate_opinion(op, node_ids)
458
+ if err:
459
+ invalid.append({"index": i, "error": err,
460
+ "node_id": (op.get("node_id")
461
+ if isinstance(op, dict) else None)})
462
+ continue
463
+ op = dict(op)
464
+ op["verdict"] = _norm_verdict(op.get("verdict"))
465
+ valid.append(op)
466
+ rate = 1.0 if total == 0 else len(valid) / float(total)
467
+ return {"total": total, "valid": valid, "invalid": invalid,
468
+ "pass_rate": rate, "ok": bool(valid) and not invalid}
469
+
470
+
471
+ # ---- 级 5-B · 落库(verify 令牌 + writepipe 六道闸;不自造通道)-----------
472
+
473
+ # 生效条件:当 actor 给出时,从 TK.role_spec('verify') 读取 clearance_cap/can_write/can_admin/layers_allow 构造 Principal;session 为假值时生成 'mrev_' + uuid 前 12 位;layers_allow 为假值时回落 spec.get('layers_allow') 或 [];ops_allow 原样传入。
474
+ def verifier_principal(*, actor="mreview-verifier", session=None,
475
+ layers_allow=None, ops_allow=None) -> Principal:
476
+ """验证单元 Principal——角色规格取自 tokens 真源(避免手写漂移)。"""
477
+ spec = TK.role_spec("verify")
478
+ return Principal(actor=actor, clearance=spec.get("clearance_cap") or "internal",
479
+ can_write=bool(spec.get("can_write")),
480
+ can_admin=bool(spec.get("can_admin")),
481
+ role="verify", unit="verify",
482
+ session=session or ("mrev_" + uuid.uuid4().hex[:12]),
483
+ layers_allow=list(layers_allow or spec.get("layers_allow") or []),
484
+ ops_allow=ops_allow, auth_mode="mreview")
485
+
486
+
487
+ # 生效条件:pkg、opinions、reviewer 给定时恒返回 "\n".join(L);summary 为真值才追加「整包结论」行,invalid 为真值才追加「【未落库条目】」行,二者取默认 "" / None 时不追加;
488
+ def opinion_doc(pkg: dict, opinions: list, *, reviewer: str, summary="",
489
+ invalid=None) -> str:
490
+ """评审意见节点正文(核心修改四要素:内容/原因/位置/验证)。"""
491
+ cnt = {k: 0 for k in VERDICTS}
492
+ for o in opinions:
493
+ cnt[_norm_verdict(o.get("verdict")) or "?"] = \
494
+ cnt.get(_norm_verdict(o.get("verdict")) or "?", 0) + 1
495
+ dist = " / ".join("%s %d" % (k, cnt.get(k, 0)) for k in VERDICTS)
496
+ L = ["# 记忆评审意见 · 包 %s(%s/%s,%d 节点)"
497
+ % (pkg.get("bundle_id"), pkg.get("group_kind"), pkg.get("group_key"),
498
+ len(pkg.get("entries") or [])),
499
+ "来源:级 4 蜂巢并发评审(评审者=%s)" % reviewer,
500
+ "裁决分布:%s" % dist]
501
+ if summary:
502
+ L.append("整包结论:%s" % summary)
503
+ L.append("")
504
+ for o in opinions:
505
+ seg = "- [%s] %s:%s" % (_norm_verdict(o.get("verdict")) or "?",
506
+ o.get("node_id"),
507
+ str(o.get("reason") or "").strip())
508
+ ev = str(o.get("evidence") or "").strip()
509
+ if ev:
510
+ seg += "(证据:%s)" % ev[:300]
511
+ L.append(seg)
512
+ if invalid:
513
+ L.append("")
514
+ L.append("【未落库条目】%s" % json.dumps(invalid, ensure_ascii=False))
515
+ L.append("")
516
+ L.append("【内容】级 4 并发评审对包 %s 的逐节点裁决意见。" % pkg.get("bundle_id"))
517
+ L.append("【原因】机械层已过滤确定性缺陷,语义判断留给验证单元;意见落 contextual "
518
+ "供治理层决策——评审不改知识层。")
519
+ L.append("【位置】源包 group=%s/%s(%d 节点)。"
520
+ % (pkg.get("group_kind"), pkg.get("group_key"),
521
+ len(pkg.get("entries") or [])))
522
+ L.append("【验证】机械规则命中 %d 条;意见格式校验 %d/%d 通过(越界条目已剔除)。"
523
+ % (len((pkg.get("_asm") or {}).get("mechanical") or []),
524
+ len(opinions), len(opinions) + len(invalid or [])))
525
+ return "\n".join(L)
526
+
527
+
528
+ # 生效条件:cg/pkg/opinions/reviewer/applier 给定,CC.detect_self_verify 判 reviewer 与 applier 同一→refused self_verify_disallowed;opinions 为空→ok True skipped no_opinions;dry_run 真→ok True committed False;否则 (pipe or WP.default_pipeline()).execute,AccessDenied→refused layer_denied,其他异常→write_error,成功→ok 取 out.ok、committed 取 out.committed、moved_to 取 out.moved_to、deferred=bool(out.moved_to) and not out.committed;
529
+ def apply_opinions(cg, pkg: dict, opinions: list, *, reviewer, applier,
530
+ dry_run=False, pipe=None, layer=OPINION_LAYER,
531
+ importance=0.4, tags=None, node_id=None,
532
+ summary="", invalid=None) -> dict:
533
+ """落库单包意见(级 5 唯一的写入口)。
534
+
535
+ 顺序(任一环不过即不落库):
536
+ 1 自验违例检测(评审者 ≠ 落库裁决者,判据复用 crosscheck)
537
+ 2 意见非空(全 DEFER 且空 → 不写,零噪声)
538
+ 3 verify 令牌 + writepipe 六道闸 + 库层 require_layer_write
539
+ 4 合规规则库(部署侧 MDCG_POLICY_FILE)——audit 的 text 验证器在**无规则**
540
+ 时恒 DEFER(audit._rule_check「无规则不能假装合规」),意见将转审核队列
541
+ (`moved_to="review_queue"`)而非落盘。这是设计行为不是故障:本函数把
542
+ 去向如实透出为 `moved_to` / `deferred`,**不把「入队」报成「落库」**。
543
+ """
544
+ rows = [{"unit": CC.REFLECT_UNIT, "actor": str(reviewer or "")},
545
+ {"unit": CC.VERIFY_UNIT, "actor": str(applier or "")}]
546
+ if CC.detect_self_verify(rows):
547
+ return {"ok": False, "committed": False, "refused": True,
548
+ "reason": "self_verify_disallowed",
549
+ "detail": "评审者与落库裁决者为同一执行者(%s)——自验被拒(§7)"
550
+ % reviewer}
551
+ if not opinions:
552
+ return {"ok": True, "committed": False, "skipped": True,
553
+ "reason": "no_opinions(无有效意见,零噪声不落库)"}
554
+ nid = node_id or ("mr_opinion_" + _safe(pkg.get("bundle_id")))
555
+ doc = opinion_doc(pkg, opinions, reviewer=str(reviewer), summary=summary,
556
+ invalid=invalid)
557
+ if dry_run:
558
+ return {"ok": True, "committed": False, "dry_run": True, "node_id": nid,
559
+ "doc_len": len(doc)}
560
+ a = {"node_id": nid, "content": doc, "layer": layer,
561
+ "tags": list(tags or ["cap:记忆评审", "mreview", "opinion",
562
+ "bundle:" + _safe(pkg.get("bundle_id"))]),
563
+ "importance": float(importance), "verification_basis": OPINION_BASIS,
564
+ "content_kind": "text",
565
+ # 意见是评审产物(contextual),不参与知识层冲突判定:冲突闸若命中会
566
+ # 把意见当冲突源转入审核队列(语义不符),故显式跳过(闸层可关,
567
+ # 库层 require_layer_write 不可关——评审不改知识层的结构约束仍在)。
568
+ "consistency": False}
569
+ try:
570
+ out = (pipe or WP.default_pipeline()).execute(cg, a)
571
+ except AccessDenied as exc:
572
+ # 结构性拒绝(如 layer=knowledge 越出 verify 令牌的 layers_allow):
573
+ # 如实上报为拒写,不吞异常也不改写写入语义(§7 反面清单第 1 条)。
574
+ return {"ok": False, "committed": False, "refused": True,
575
+ "reason": "layer_denied", "node_id": nid, "layer": layer,
576
+ "detail": "%s: %s" % (type(exc).__name__, exc)}
577
+ except Exception as exc: # noqa: BLE001
578
+ return {"ok": False, "committed": False, "refused": False,
579
+ "reason": "write_error", "node_id": nid, "layer": layer,
580
+ "detail": "%s: %s" % (type(exc).__name__, exc)}
581
+ return {"ok": bool(out.get("ok")), "committed": bool(out.get("committed")),
582
+ "moved_to": out.get("moved_to"),
583
+ # 「改了去向但没落盘」(如合规/冲突闸转审核队列、gated 的 DROP/DEFER)
584
+ # 与「落盘」是两种结局:分开报,调用方不必读 response 才能分辨。
585
+ "deferred": bool(out.get("moved_to")) and not out.get("committed"),
586
+ "node_id": nid, "layer": layer, "response": out,
587
+ "doc_len": len(doc)}
588
+
589
+
590
+ # ---- 编排 ----------------------------------------------------------------
591
+
592
+ # 生效条件:pkg/asm/cg 给定,exe=hive_exe(exe),jobs_dir/ctx_dir 假值回落到 tempfile.gettempdir() 下路径;dump_context 后 build_spec、submit,若 submit 无 ok 或无 _job_id 返回 stage submit;wait_jobs 后若 failed 或 done 空返回 stage wait;read_result+parse_opinions 失败返回 stage parse;否则 validate_opinions 并 apply_opinions,返回 ok=app.ok 及计数;
593
+ def run_package(*, pkg, asm, cg, exe=None, jobs_dir=None, ctx_dir=None,
594
+ reviewer="mreview-worker", applier="mreview-applier",
595
+ model=None, timeout_s=900, interval_s=1.0, dry_run=False,
596
+ keep_jobs=True) -> dict:
597
+ """单包全链路:dump context → submit → wait → parse → validate → apply。"""
598
+ exe = hive_exe(exe)
599
+ jobs_dir = jobs_dir or os.path.join(tempfile.gettempdir(), "mrev_jobs")
600
+ ctx_dir = ctx_dir or os.path.join(tempfile.gettempdir(), "mrev_ctx")
601
+ ctx_files = dump_context(pkg, asm, ctx_dir)
602
+ spec = build_spec(pkg, asm, context_files=ctx_files, model=model,
603
+ timeout_s=timeout_s)
604
+ sub = submit(exe, jobs_dir, spec)
605
+ if not sub.get("ok") or not _job_id(sub):
606
+ return {"ok": False, "stage": "submit", "error": sub.get("error"),
607
+ "submit": sub, "bundle_id": pkg.get("bundle_id")}
608
+ jid = str(_job_id(sub))
609
+ w = wait_jobs(exe, jobs_dir, [jid], timeout_s=timeout_s,
610
+ interval_s=interval_s)
611
+ if w.get("failed") or not w.get("done"):
612
+ return {"ok": False, "stage": "wait", "job_id": jid, "wait": w,
613
+ "bundle_id": pkg.get("bundle_id")}
614
+ res = read_result(jobs_dir, jid)
615
+ parsed = parse_opinions(res)
616
+ if not parsed.get("ok"):
617
+ return {"ok": False, "stage": "parse", "job_id": jid, "error":
618
+ parsed.get("error"), "bundle_id": pkg.get("bundle_id")}
619
+ nids = {str(e.get("node_id")) for e in (pkg.get("entries") or [])
620
+ if e.get("node_id")}
621
+ val = validate_opinions(parsed["verdicts"], nids or None)
622
+ pkg2 = dict(pkg, _asm=asm)
623
+ app = apply_opinions(cg, pkg2, val["valid"], reviewer=reviewer,
624
+ applier=applier, dry_run=dry_run,
625
+ summary=parsed.get("summary"), invalid=val["invalid"])
626
+ return {"ok": bool(app.get("ok")), "bundle_id": pkg.get("bundle_id"),
627
+ "job_id": jid, "opinions": len(parsed["verdicts"]),
628
+ "valid": len(val["valid"]), "invalid": len(val["invalid"]),
629
+ "pass_rate": val["pass_rate"], "deferred": bool(app.get("deferred")),
630
+ "apply": app, "stages": {"submit": True, "wait": True, "parse": True}}
631
+
632
+
633
+ # 生效条件:pairs/cg 给定,先对每对 pkg,asm 执行 dump_context/build_spec/submit,收集 ok 且有 job_id 的 jids;wait_jobs 后逐 jid 若 state!="done" 记 stage wait,否则 read_result/parse_opinions/validate_opinions/apply_opinions 并累计;返回 ok=all(results.ok) and bool(results) 及聚合计数;
634
+ def run_batch(*, pairs, cg, exe=None, jobs_dir=None, ctx_dir=None,
635
+ reviewer="mreview-worker", applier="mreview-applier", model=None,
636
+ timeout_s=1800, interval_s=1.0, dry_run=False, on_tick=None) -> dict:
637
+ """批量并发:先全投递(hive worker 池并发消费),再统一等候,再逐包落库。
638
+
639
+ 并发发生在**投递之后**——本函数投递不阻塞,故 N 包的墙钟≈最慢一包。
640
+ """
641
+ exe = hive_exe(exe)
642
+ jobs_dir = jobs_dir or os.path.join(tempfile.gettempdir(), "mrev_jobs")
643
+ ctx_dir = ctx_dir or os.path.join(tempfile.gettempdir(), "mrev_ctx")
644
+ os.makedirs(jobs_dir, exist_ok=True)
645
+ staged, posted, jids = [], [], []
646
+ for pkg, asm in pairs:
647
+ ctx_files = dump_context(pkg, asm, ctx_dir)
648
+ spec = build_spec(pkg, asm, context_files=ctx_files, model=model,
649
+ timeout_s=timeout_s)
650
+ sub = submit(exe, jobs_dir, spec)
651
+ staged.append({"bundle_id": pkg.get("bundle_id"), "pkg": pkg,
652
+ "asm": asm, "submit": sub})
653
+ if sub.get("ok") and _job_id(sub):
654
+ jid = str(_job_id(sub))
655
+ jids.append(jid)
656
+ posted.append(staged[-1])
657
+ w = wait_jobs(exe, jobs_dir, jids, timeout_s=timeout_s,
658
+ interval_s=interval_s, on_tick=on_tick)
659
+ by_jid = {}
660
+ for i, s in enumerate(staged):
661
+ if s["submit"].get("ok") and _job_id(s["submit"]):
662
+ by_jid[str(_job_id(s["submit"]))] = s
663
+ results, ok_n, valid_n, invalid_n, applied_n, deferred_n = [], 0, 0, 0, 0, 0
664
+ for jid in jids:
665
+ s = by_jid.get(jid) or {}
666
+ pkg, asm = s.get("pkg") or {}, s.get("asm") or {}
667
+ state = (w.get("states") or {}).get(jid)
668
+ if state != "done":
669
+ results.append({"ok": False, "bundle_id": pkg.get("bundle_id"),
670
+ "job_id": jid, "stage": "wait", "state": state})
671
+ continue
672
+ res = read_result(jobs_dir, jid)
673
+ parsed = parse_opinions(res)
674
+ if not parsed.get("ok"):
675
+ results.append({"ok": False, "bundle_id": pkg.get("bundle_id"),
676
+ "job_id": jid, "stage": "parse",
677
+ "error": parsed.get("error")})
678
+ continue
679
+ nids = {str(e.get("node_id")) for e in (pkg.get("entries") or [])
680
+ if e.get("node_id")}
681
+ val = validate_opinions(parsed["verdicts"], nids or None)
682
+ app = apply_opinions(cg, dict(pkg, _asm=asm), val["valid"],
683
+ reviewer=reviewer, applier=applier,
684
+ dry_run=dry_run, summary=parsed.get("summary"),
685
+ invalid=val["invalid"])
686
+ ok_n += 1
687
+ valid_n += len(val["valid"])
688
+ invalid_n += len(val["invalid"])
689
+ applied_n += 1 if app.get("committed") else 0
690
+ deferred_n += 1 if app.get("deferred") else 0
691
+ results.append({"ok": bool(app.get("ok")),
692
+ "bundle_id": pkg.get("bundle_id"), "job_id": jid,
693
+ "opinions": len(parsed["verdicts"]),
694
+ "valid": len(val["valid"]), "invalid": len(val["invalid"]),
695
+ "pass_rate": val["pass_rate"],
696
+ "deferred": bool(app.get("deferred")), "apply": app})
697
+ total_op = valid_n + invalid_n
698
+ return {"ok": all(r.get("ok") for r in results) and bool(results),
699
+ "jobs": len(jids), "submitted": len(posted),
700
+ "done": len(w.get("done") or []), "failed": w.get("failed") or [],
701
+ "packages": len(results), "opinions": total_op,
702
+ "valid": valid_n, "invalid": invalid_n,
703
+ "pass_rate": (1.0 if total_op == 0 else valid_n / float(total_op)),
704
+ "committed": applied_n, "deferred": deferred_n,
705
+ "results": results, "wait": w}
706
+
707
+
708
+ # ---- CLI -----------------------------------------------------------------
709
+
710
+ # 生效条件:当 argv 给出时,argparse 解析命令行;root 取 a.root 或 os.environ.get('MDCG_ROOT'),若 root 为假值则 SystemExit;否则用 verifier_principal(actor=a.applier) 构造 MdCGSecure,build_packages(root=root, limit=None) 得到 pairs,按 a.packages(假值 0 则取全部)切片,run_batch 以 dry_run=(a.dry_run or not a.apply) 运行,打印 JSON 报告,返回 0(rep['ok'] 为真)或 1。
711
+ def main(argv=None): # pragma: no cover
712
+ import argparse
713
+ ap = argparse.ArgumentParser(prog="python -m md_cg.mreview.pipeline",
714
+ description="记忆评审 级4 蜂巢并发 + 级5 落库")
715
+ ap.add_argument("--root", default=None, help="认知图根(缺省 MDCG_ROOT)")
716
+ ap.add_argument("--packages", type=int, default=10, help="试跑包数(0=全部)")
717
+ ap.add_argument("--jobs", default=None, help="hive jobs 目录(隔离生产)")
718
+ ap.add_argument("--ctx", default=None, help="context 文件目录")
719
+ ap.add_argument("--hive", default=None, help="hive 可执行文件")
720
+ ap.add_argument("--model", default=None, help="模型名")
721
+ ap.add_argument("--timeout", type=float, default=1800.0)
722
+ ap.add_argument("--reviewer", default="mreview-worker")
723
+ ap.add_argument("--applier", default="mreview-applier")
724
+ ap.add_argument("--dry-run", action="store_true", help="只校验不落库")
725
+ ap.add_argument("--apply", action="store_true", help="实际落库(缺省不写)")
726
+ a = ap.parse_args(argv)
727
+ from .. import mdcos
728
+ root = a.root or os.environ.get("MDCG_ROOT")
729
+ if not root:
730
+ raise SystemExit("缺少 --root 或 MDCG_ROOT(拒绝在未知根上运行)")
731
+ cg = mdcos.MdCGSecure(root, principal=verifier_principal(actor=a.applier))
732
+ built = build_packages(root=root, limit=None)
733
+ pairs = built["pairs"][:a.packages] if a.packages else built["pairs"]
734
+ rep = run_batch(pairs=pairs, cg=cg, exe=a.hive, jobs_dir=a.jobs,
735
+ ctx_dir=a.ctx, reviewer=a.reviewer, applier=a.applier,
736
+ model=a.model, timeout_s=a.timeout,
737
+ dry_run=(a.dry_run or not a.apply))
738
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
739
+ return 0 if rep.get("ok") else 1
740
+
741
+
742
+ if __name__ == "__main__": # pragma: no cover
743
743
  raise SystemExit(main())