@furongjun1999/dsh-memory 0.9.14 → 0.9.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1276) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/LICENSE +21 -21
  3. package/README.md +125 -2
  4. package/codebuddy/mcp.json +27 -27
  5. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -45
  6. package/dsh/dsh-web-start.bat +17 -17
  7. package/dsh/hive-mcp-probe.mjs +94 -94
  8. package/dsh/update-lingshu.bat +11 -11
  9. package/dsh/update-lingshu.ps1 +337 -337
  10. package/hive/README.md +705 -705
  11. package/hive/id_charset_blocks.txt +147 -147
  12. package/lib/client.js +18 -0
  13. package/lib/hooks.js +24 -12
  14. package/lib/index.js +3 -44
  15. package/lib/lib/console_web.mjs +96 -0
  16. package/lib/tools.d.ts +2 -2
  17. package/md_cg/__init__.py +7 -7
  18. package/md_cg/auditview.py +248 -248
  19. package/md_cg/backfill.py +1328 -1328
  20. package/md_cg/backfill_bigdomain.py +34 -34
  21. package/md_cg/backfill_bucket_zh.py +35 -35
  22. package/md_cg/bench6_arms.py +414 -414
  23. package/md_cg/bench6_common.py +230 -230
  24. package/md_cg/bench6_competitors.py +212 -212
  25. package/md_cg/bench_axis_domain.py +257 -257
  26. package/md_cg/bench_blind_comp.py +308 -308
  27. package/md_cg/bench_e2e_judge.py +534 -534
  28. package/md_cg/bench_e2e_locomo_qa.py +375 -375
  29. package/md_cg/bench_e2e_qa.py +256 -256
  30. package/md_cg/bench_en_atoms_public.py +230 -230
  31. package/md_cg/bench_governance.py +351 -351
  32. package/md_cg/bench_lme_zh.py +410 -410
  33. package/md_cg/bench_locomo.py +121 -121
  34. package/md_cg/bench_locomo_zh.py +460 -460
  35. package/md_cg/bench_locomo_zh_public.py +147 -147
  36. package/md_cg/bench_longmem.py +112 -112
  37. package/md_cg/bench_membench.py +632 -632
  38. package/md_cg/bench_p0.py +149 -149
  39. package/md_cg/bench_progressive.py +287 -287
  40. package/md_cg/bench_role_views.py +238 -238
  41. package/md_cg/bench_task_ab.py +243 -243
  42. package/md_cg/bench_task_ab_llm.py +408 -408
  43. package/md_cg/bench_unified_en.py +204 -204
  44. package/md_cg/bench_zh_mad.py +611 -611
  45. package/md_cg/blindspot_tickets.py +123 -123
  46. package/md_cg/census.py +133 -133
  47. package/md_cg/codeindex.py +531 -531
  48. package/md_cg/comment_gate.py +337 -337
  49. package/md_cg/cond_compose.py +190 -190
  50. package/md_cg/cond_facts.py +154 -154
  51. package/md_cg/cond_template.json +106 -106
  52. package/md_cg/condition_anchor.py +142 -142
  53. package/md_cg/config_registry_bulk.py +4 -0
  54. package/md_cg/corpus.py +110 -110
  55. package/md_cg/crosscheck.py +1098 -1098
  56. package/md_cg/d_meta.py +310 -310
  57. package/md_cg/docindex.py +496 -488
  58. package/md_cg/evolution.py +493 -493
  59. package/md_cg/freshness.py +21 -1
  60. package/md_cg/generation.py +409 -409
  61. package/md_cg/ghostref.py +130 -130
  62. package/md_cg/hotcache.py +5 -1
  63. package/md_cg/lexicon/RULES.md +32 -32
  64. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  65. package/md_cg/lexicon/build_standard_en.py +171 -171
  66. package/md_cg/lexicon/cedict_en_zh.json +28322 -28322
  67. package/md_cg/lexicon/char_atoms_clean.json +43813 -43813
  68. package/md_cg/lexicon/expand_en_zh.py +211 -211
  69. package/md_cg/lexicon/standard_en.json +1262 -1262
  70. package/md_cg/linkref.py +280 -280
  71. package/md_cg/mcp_server.py +9 -2
  72. package/md_cg/md_whitebox.py +345 -345
  73. package/md_cg/mdcg.py +196 -13
  74. package/md_cg/mdcos.py +124 -5
  75. package/md_cg/migrate.py +119 -119
  76. package/md_cg/migrate_aeis.py +221 -221
  77. package/md_cg/migrate_roleplay.py +293 -293
  78. package/md_cg/migrate_wisdom_graph.py +360 -360
  79. package/md_cg/mreview/__init__.py +25 -25
  80. package/md_cg/mreview/__main__.py +110 -110
  81. package/md_cg/mreview/bundle.py +178 -178
  82. package/md_cg/mreview/candidates.py +262 -262
  83. package/md_cg/mreview/govern.py +694 -694
  84. package/md_cg/mreview/locate.py +939 -939
  85. package/md_cg/mreview/pipeline.py +742 -742
  86. package/md_cg/mreview/rules/duplication.json +21 -21
  87. package/md_cg/mreview/rules/field_coverage.json +54 -54
  88. package/md_cg/mreview/rules/source_license.json +21 -21
  89. package/md_cg/mreview/rules/template_flow.json +21 -21
  90. package/md_cg/mreview/ruleset.py +252 -252
  91. package/md_cg/op_table.py +3 -2
  92. package/md_cg/progressive.py +123 -123
  93. package/md_cg/protect.py +29 -6
  94. package/md_cg/protocol/md_cg_gate.proto +33 -33
  95. package/md_cg/qmd_llm.py +334 -334
  96. package/md_cg/roleviews.py +89 -89
  97. package/md_cg/security.py +68 -5
  98. package/md_cg/selfreport.py +161 -161
  99. package/md_cg/semantic/REPRODUCE.md +170 -170
  100. package/md_cg/semantic/SCHEMA.md +33 -33
  101. package/md_cg/semantic/__init__.py +10 -10
  102. package/md_cg/semantic/atoms.json +7348 -7348
  103. package/md_cg/semantic/en_normalizer.py +364 -364
  104. package/md_cg/semantic/search_index.json +6199 -6199
  105. package/md_cg/session5.py +106 -106
  106. package/md_cg/srcindex.py +352 -352
  107. package/md_cg/statushdr.py +179 -179
  108. package/md_cg/tasks.py +26 -0
  109. package/md_cg/test_access_hints.py +147 -147
  110. package/md_cg/test_audit_rotate.py +270 -270
  111. package/md_cg/test_auditview.py +277 -277
  112. package/md_cg/test_autonomy.py +143 -143
  113. package/md_cg/test_autonomy_admission.py +1098 -1098
  114. package/md_cg/test_b1_auto_id_multiproc.py +284 -284
  115. package/md_cg/test_b1_foreign_read.py +244 -244
  116. package/md_cg/test_b1b2_write_face.py +424 -424
  117. package/md_cg/test_b2_sensitivity_landing.py +223 -223
  118. package/md_cg/test_b3_merge_keeps_content.py +583 -583
  119. package/md_cg/test_b4_shard_dir_selfheal.py +880 -843
  120. package/md_cg/test_b4_shard_dir_selfheal_guard.py +249 -238
  121. package/md_cg/test_bench_governance.py +102 -102
  122. package/md_cg/test_blindspot_tickets.py +166 -166
  123. package/md_cg/test_boundary_hit.py +410 -410
  124. package/md_cg/test_branch_discard_tombstone.py +136 -136
  125. package/md_cg/test_ccg_perturb.py +184 -184
  126. package/md_cg/test_ccgc.py +458 -458
  127. package/md_cg/test_census_prune.py +81 -81
  128. package/md_cg/test_chain_read_isolate.py +168 -168
  129. package/md_cg/test_codeindex.py +338 -338
  130. package/md_cg/test_coldverify_drain.py +127 -127
  131. package/md_cg/test_comment_gate.py +187 -187
  132. package/md_cg/test_cond_compose_anchors.py +76 -76
  133. package/md_cg/test_cond_match.py +165 -165
  134. package/md_cg/test_condition_anchor.py +81 -81
  135. package/md_cg/test_config_registry.py +55 -55
  136. package/md_cg/test_cons200_scan_selection.py +793 -793
  137. package/md_cg/test_corrupt_utf8_read_surfaces.py +451 -451
  138. package/md_cg/test_crypto_rotate.py +256 -256
  139. package/md_cg/test_csre_index_import_guard.py +161 -161
  140. package/md_cg/test_curiosity_budget.py +468 -468
  141. package/md_cg/test_d17_autostart_toolface.py +453 -453
  142. package/md_cg/test_d_meta.py +412 -412
  143. package/md_cg/test_datapath_root.py +199 -199
  144. package/md_cg/test_designer_token_coverage.py +184 -0
  145. package/md_cg/test_emit_negtail_cache.py +156 -156
  146. package/md_cg/test_export_default_collision.py +138 -138
  147. package/md_cg/test_gain_gate.py +223 -223
  148. package/md_cg/test_generation_guard.py +361 -361
  149. package/md_cg/test_ghostref.py +182 -182
  150. package/md_cg/test_goal_gen.py +355 -355
  151. package/md_cg/test_govern_directread.py +434 -434
  152. package/md_cg/test_health_scale.py +173 -173
  153. package/md_cg/test_heartbeat_ledger.py +563 -563
  154. package/md_cg/test_hive_ingest.py +285 -285
  155. package/md_cg/test_hot_cold.py +215 -215
  156. package/md_cg/test_hyperedge.py +245 -245
  157. package/md_cg/test_i50a_half_dup_defer.py +408 -408
  158. package/md_cg/test_i50b_defer_to_review_queue.py +545 -545
  159. package/md_cg/test_i50d_importance_source.py +531 -531
  160. package/md_cg/test_i50e_readside_protection.py +9 -3
  161. package/md_cg/test_identity_contract.py +329 -329
  162. package/md_cg/test_index_crossprocess_reload.py +316 -316
  163. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  164. package/md_cg/test_issue452_ingest_root_sensitivity.py +2 -0
  165. package/md_cg/test_issue52_scan_condition_first.py +677 -677
  166. package/md_cg/test_issue53_cipher_health_hash.py +385 -385
  167. package/md_cg/test_issue659_r26_batch3.py +38 -0
  168. package/md_cg/test_issue66_scrub_semantics.py +107 -107
  169. package/md_cg/test_issue672_optional_assets.py +49 -0
  170. package/md_cg/test_issue676_session_tasks_index_first.py +74 -0
  171. package/md_cg/test_issue677_async_index_flush.py +216 -0
  172. package/md_cg/test_issue677_dedupe_gate.py +67 -0
  173. package/md_cg/test_issue678_narrowed_hint.py +60 -0
  174. package/md_cg/test_issue67_scrub_control_pool.py +233 -233
  175. package/md_cg/test_issue69_audit_boundary.py +129 -129
  176. package/md_cg/test_issue73_doc_chapter_refs.py +326 -326
  177. package/md_cg/test_issue78_export_concurrency.py +334 -334
  178. package/md_cg/test_issue80_residual_flush.py +169 -169
  179. package/md_cg/test_issue84_portability.py +95 -95
  180. package/md_cg/test_issue85_export_overwrite.py +113 -113
  181. package/md_cg/test_issue86_runtime_revoke.py +110 -110
  182. package/md_cg/test_issue87_default_sensitivity_single.py +201 -201
  183. package/md_cg/test_issue88_conclusion_face.py +280 -280
  184. package/md_cg/test_issue89_zero_score.py +169 -169
  185. package/md_cg/test_issue91_verifier_timeout.py +528 -528
  186. package/md_cg/test_issue96_key_fallback.py +102 -102
  187. package/md_cg/test_issue98_tenant_root.py +104 -104
  188. package/md_cg/test_legacy_p3_node_id_type.py +375 -375
  189. package/md_cg/test_lifecycle.py +309 -309
  190. package/md_cg/test_lifecycle_retire_leak.py +498 -498
  191. package/md_cg/test_linkref.py +320 -320
  192. package/md_cg/test_links_concurrent_write.py +188 -188
  193. package/md_cg/test_lock.py +52 -52
  194. package/md_cg/test_m3_h9_bucket_health_protect_mark.py +301 -301
  195. package/md_cg/test_m3_h9_semantic_guard.py +525 -525
  196. package/md_cg/test_md_writepath.py +345 -345
  197. package/md_cg/test_merge_upsert.py +168 -168
  198. package/md_cg/test_mode_parity.py +23 -0
  199. package/md_cg/test_mr_m2.py +615 -599
  200. package/md_cg/test_mr_m3.py +710 -710
  201. package/md_cg/test_mr_m4.py +485 -485
  202. package/md_cg/test_n131_merge_gate.py +205 -205
  203. package/md_cg/test_n139_dek_provision_failclosed.py +185 -185
  204. package/md_cg/test_n176_link_trust.py +221 -221
  205. package/md_cg/test_n178_units_jobid_gate.py +212 -212
  206. package/md_cg/test_n184_keys_concurrent_provision.py +307 -307
  207. package/md_cg/test_n195_writepath_reload.py +283 -283
  208. package/md_cg/test_n196_stale_gate_skip.py +169 -169
  209. package/md_cg/test_n197_n208_write_face_gates.py +471 -471
  210. package/md_cg/test_n198_tokens_corrupt_failclosed.py +225 -225
  211. package/md_cg/test_n199_tokens_concurrent_write.py +378 -378
  212. package/md_cg/test_n201_proposal_visibility.py +382 -382
  213. package/md_cg/test_n202_session_notes_visibility.py +461 -461
  214. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +542 -542
  215. package/md_cg/test_n206_stdio_jsonrpc_type.py +403 -403
  216. package/md_cg/test_n212_n213_n224_generation_gates.py +519 -519
  217. package/md_cg/test_n214_n215_n221_n222_write_face_gates.py +570 -570
  218. package/md_cg/test_n225_nonobject_load.py +1110 -1110
  219. package/md_cg/test_n230_dirty_replay.py +18 -5
  220. package/md_cg/test_n238_body_text_parity.py +156 -156
  221. package/md_cg/test_n276_probe_hoist.py +199 -199
  222. package/md_cg/test_neg_condition_hits.py +333 -333
  223. package/md_cg/test_neg_coverage_budget.py +500 -500
  224. package/md_cg/test_none_id_write_guard.py +166 -166
  225. package/md_cg/test_opt_batch1_md_cg.py +451 -451
  226. package/md_cg/test_p0.py +264 -264
  227. package/md_cg/test_p1.py +316 -316
  228. package/md_cg/test_p10_identity.py +173 -173
  229. package/md_cg/test_p11_consistency.py +382 -382
  230. package/md_cg/test_p12_metacognition.py +212 -212
  231. package/md_cg/test_p13_encryption.py +241 -241
  232. package/md_cg/test_p14_root_fallback.py +373 -373
  233. package/md_cg/test_p14_sustain.py +249 -249
  234. package/md_cg/test_p15_scrub.py +280 -280
  235. package/md_cg/test_p16_self_state.py +301 -301
  236. package/md_cg/test_p17_predict.py +354 -354
  237. package/md_cg/test_p18_whitebox.py +171 -171
  238. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  239. package/md_cg/test_p1x_ref_root.py +197 -197
  240. package/md_cg/test_p2.py +216 -216
  241. package/md_cg/test_p20_evolution.py +315 -315
  242. package/md_cg/test_p22_theory.py +175 -175
  243. package/md_cg/test_p23_links.py +311 -311
  244. package/md_cg/test_p25_weights.py +156 -156
  245. package/md_cg/test_p26_refindex.py +433 -433
  246. package/md_cg/test_p29_session_ingest_export.py +360 -360
  247. package/md_cg/test_p30_maintain.py +361 -361
  248. package/md_cg/test_p31_insight.py +535 -535
  249. package/md_cg/test_p34_crosscheck.py +331 -331
  250. package/md_cg/test_p35_conditioned_claim.py +252 -252
  251. package/md_cg/test_p36_kp_align.py +230 -230
  252. package/md_cg/test_p37_condition_space.py +248 -248
  253. package/md_cg/test_p38_contextualize.py +273 -273
  254. package/md_cg/test_p39_vision_evidence.py +369 -369
  255. package/md_cg/test_p41_evolve_patrol.py +224 -224
  256. package/md_cg/test_p42_provenance.py +269 -269
  257. package/md_cg/test_p44_md_whitebox.py +231 -231
  258. package/md_cg/test_p45_session_identity.py +466 -466
  259. package/md_cg/test_p46_unit_scope.py +272 -272
  260. package/md_cg/test_p4_fuzzy.py +223 -223
  261. package/md_cg/test_p5_semantic.py +226 -226
  262. package/md_cg/test_p6_consolidate.py +822 -822
  263. package/md_cg/test_p7_goals_recent.py +202 -202
  264. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -124
  265. package/md_cg/test_p8_subgraph_chain.py +213 -213
  266. package/md_cg/test_p9_forget_protect.py +238 -238
  267. package/md_cg/test_preflight_failclosed.py +100 -100
  268. package/md_cg/test_progressive.py +146 -146
  269. package/md_cg/test_propose_tail_index.py +157 -157
  270. package/md_cg/test_protect_stats_parity.py +141 -0
  271. package/md_cg/test_protocol.py +272 -272
  272. package/md_cg/test_rank_parity_score_mode.py +522 -522
  273. package/md_cg/test_reach_keys.py +201 -201
  274. package/md_cg/test_read_clip.py +141 -141
  275. package/md_cg/test_read_face_input_gates.py +363 -363
  276. package/md_cg/test_read_face_semantics.py +492 -492
  277. package/md_cg/test_read_scope_b27.py +277 -277
  278. package/md_cg/test_readcache_default_on.py +168 -168
  279. package/md_cg/test_readcache_precise_inval.py +270 -270
  280. package/md_cg/test_recall_metadata.py +422 -422
  281. package/md_cg/test_reconcile_v0.py +294 -294
  282. package/md_cg/test_retr_s1.py +344 -344
  283. package/md_cg/test_retr_s1b.py +276 -276
  284. package/md_cg/test_retr_s3.py +194 -194
  285. package/md_cg/test_retr_s4.py +163 -163
  286. package/md_cg/test_retr_s6.py +157 -157
  287. package/md_cg/test_retr_s7.py +392 -392
  288. package/md_cg/test_retr_s8_time.py +369 -369
  289. package/md_cg/test_retr_s9_edges.py +286 -286
  290. package/md_cg/test_retr_score_once.py +220 -220
  291. package/md_cg/test_review_cli_attribution.py +181 -181
  292. package/md_cg/test_review_cli_visibility.py +235 -235
  293. package/md_cg/test_review_conformance.py +385 -385
  294. package/md_cg/test_review_dual_check.py +97 -0
  295. package/md_cg/test_review_onepass.py +170 -170
  296. package/md_cg/test_review_queue_batch.py +123 -123
  297. package/md_cg/test_review_queue_index.py +130 -130
  298. package/md_cg/test_role_views.py +354 -354
  299. package/md_cg/test_rrf_graph_seed_cache.py +154 -154
  300. package/md_cg/test_security_audit_v21.py +249 -249
  301. package/md_cg/test_sem_noise.py +242 -242
  302. package/md_cg/test_server_version.py +67 -67
  303. package/md_cg/test_session5_identity.py +93 -93
  304. package/md_cg/test_session_attribution_consistency.py +813 -813
  305. package/md_cg/test_session_identity_tristate.py +486 -486
  306. package/md_cg/test_session_isolation.py +168 -168
  307. package/md_cg/test_sleep.py +668 -668
  308. package/md_cg/test_sleep_gitlock.py +134 -134
  309. package/md_cg/test_snapshot_autoclose.py +187 -187
  310. package/md_cg/test_spatial_coords3d.py +292 -292
  311. package/md_cg/test_srcindex.py +171 -171
  312. package/md_cg/test_state_events.py +178 -178
  313. package/md_cg/test_state_slots.py +691 -691
  314. package/md_cg/test_subproc_encoding.py +192 -192
  315. package/md_cg/test_sustain_mutual.py +153 -153
  316. package/md_cg/test_tail_watermark_race.py +208 -208
  317. package/md_cg/test_tasks.py +409 -409
  318. package/md_cg/test_tenant_env_override_warn.py +152 -152
  319. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -151
  320. package/md_cg/test_time_core_lint.py +9 -0
  321. package/md_cg/test_token_lowercase_form.py +315 -315
  322. package/md_cg/test_transfer.py +180 -180
  323. package/md_cg/test_trust.py +361 -361
  324. package/md_cg/test_twophase.py +286 -286
  325. package/md_cg/test_ui_wiring_in_repo.py +113 -0
  326. package/md_cg/test_unify_default_off.py +701 -701
  327. package/md_cg/test_unify_scope.py +182 -182
  328. package/md_cg/test_units_poll.py +71 -71
  329. package/md_cg/test_v21r1_package_version.py +310 -310
  330. package/md_cg/test_validity_filter.py +280 -280
  331. package/md_cg/test_verify_answer.py +138 -138
  332. package/md_cg/test_verify_dirty_reconcile.py +157 -157
  333. package/md_cg/test_w5_path_fingerprint.py +381 -381
  334. package/md_cg/test_wisdom_md_store.py +292 -292
  335. package/md_cg/test_writegate_tiers.py +111 -0
  336. package/md_cg/test_writelimit.py +224 -224
  337. package/md_cg/test_writepipe.py +4 -2
  338. package/md_cg/tokens.py +114 -8
  339. package/md_cg/units.py +869 -869
  340. package/md_cg/version_anchor.py +160 -160
  341. package/md_cg/vision_evidence.py +667 -667
  342. package/md_cg/whitebox_kb/__init__.py +37 -37
  343. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  344. package/md_cg/whitebox_kb/aeis_core/api.py +1047 -1047
  345. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  346. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  347. package/md_cg/whitebox_kb/aeis_core/time_core.py +51 -51
  348. package/md_cg/whitebox_kb/engine.py +310 -310
  349. package/md_cg/whitebox_kb/seed_knowledge/__init__.py +2 -2
  350. package/md_cg/whitebox_kb/seed_knowledge/guardrail-charter.md +164 -164
  351. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/345/217/244/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  352. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/270/255/345/233/275/347/216/260/344/273/243/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  353. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/345/267/245/346/231/272/350/203/275/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  354. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/272/272/347/261/273/350/247/202/345/257/237/350/200/205/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +161 -161
  355. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/274/232/350/256/241/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  356. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//344/277/241/346/201/257/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +90 -90
  357. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/345/255/220/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  358. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/206/346/236/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  359. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  360. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  361. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  362. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +241 -241
  363. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +317 -317
  364. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +261 -261
  365. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  366. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  367. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/210/235/344/270/255/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  368. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/212/250/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  369. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1194 -1194
  370. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/226/345/267/245/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  371. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/214/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  372. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/206/345/217/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +278 -278
  373. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/216/237/345/255/220/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  374. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/217/244/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  375. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/223/262/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  376. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/233/272/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  377. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/237/346/234/250/345/267/245/347/250/213/345/237/272/347/241/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  378. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/234/260/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +154 -154
  379. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/215/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  380. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/226/345/233/275/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  381. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  382. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/346/200/235/346/224/277/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  383. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +201 -201
  384. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/247/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  385. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/344/275/223/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  386. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/244/251/346/226/207/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +131 -131
  387. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/217/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  388. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/256/236/345/217/230/345/207/275/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  389. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +333 -333
  390. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1124 -1124
  391. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  392. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  393. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/260/217/345/255/246/351/201/223/345/276/267/344/270/216/346/263/225/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  394. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/210/266/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +85 -85
  395. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/267/245/347/250/213/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +362 -362
  396. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/202/345/234/272/350/220/245/351/224/200/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +81 -81
  397. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/270/270/345/276/256/345/210/206/346/226/271/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +153 -153
  398. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/345/210/206/345/207/240/344/275/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  399. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  400. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/276/256/350/247/202/347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  401. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//345/277/203/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +119 -119
  402. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/203/205/346/204/237/346/203/205/347/273/252/344/273/277/347/234/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +186 -186
  403. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/212/275/350/261/241/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  404. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/213/223/346/211/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  405. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/223/215/344/275/234/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  406. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/224/277/346/262/273/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +234 -234
  407. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/200/274/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  408. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/227/347/224/265/350/267/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  409. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1166 -1166
  410. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +217 -217
  411. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/345/255/246/347/211/251/347/220/206/346/226/271/346/263/225/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  412. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/345/272/223/347/263/273/347/273/237/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  413. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/225/260/346/215/256/347/273/223/346/236/204/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  414. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/226/207/345/255/246/347/220/206/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  415. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/240/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +141 -141
  416. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/227/266/347/251/272/350/256/260/345/277/206/345/233/276/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +214 -214
  417. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/231/272/350/203/275/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  418. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/234/211/346/234/272/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  419. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/220/346/226/231/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  420. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/235/241/344/273/266/350/256/272/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +350 -350
  421. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/244/215/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  422. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/246/202/347/216/207/350/256/272/344/270/216/346/225/260/347/220/206/347/273/237/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +149 -149
  423. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/250/241/346/213/237/347/224/265/345/255/220/346/212/200/346/234/257/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  424. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//346/263/233/345/207/275/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  425. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/203/255/345/212/233/345/255/246/344/270/216/347/273/237/350/256/241/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  426. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +129 -129
  427. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/211/251/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1302 -1302
  428. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/216/260/344/273/243/346/261/211/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  429. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/220/206/350/256/272/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  430. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/346/200/201/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  431. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  432. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +1018 -1018
  433. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/237/347/220/206/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +93 -93
  434. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/345/212/250/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +125 -125
  435. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/224/265/350/267/257/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  436. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/244/276/344/274/232/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +111 -111
  437. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/250/213/345/272/217/350/256/276/350/256/241/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  438. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/227/346/263/225/350/256/276/350/256/241/344/270/216/345/210/206/346/236/220/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  439. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/256/241/347/220/206/345/255/246/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  440. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/272/277/346/200/247/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +133 -133
  441. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/206/350/203/236/347/224/237/347/211/251/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +121 -121
  442. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/217/346/265/216/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +169 -169
  443. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/223/346/236/204/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  444. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/273/274/345/220/210/302/267/347/273/264/345/237/272/347/273/274/350/277/260.md +184 -184
  445. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//347/274/226/350/257/221/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  446. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/207/252/346/210/221/346/204/217/350/257/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +270 -270
  447. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/247/221/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +698 -698
  448. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/273/204/346/210/220/345/216/237/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  449. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/256/241/347/256/227/346/234/272/347/275/221/347/273/234/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +109 -109
  450. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/257/255/350/250/200/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +226 -226
  451. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//350/275/257/344/273/266/345/267/245/347/250/213/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  452. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/201/227/344/274/240/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  453. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/217/345/255/220/345/212/233/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +137 -137
  454. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/207/221/350/236/215/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +89 -89
  455. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  456. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/216/206/345/217/262/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  457. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/345/234/260/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +97 -97
  458. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/200/235/346/203/263/346/224/277/346/262/273/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +117 -117
  459. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +341 -341
  460. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/211/251/347/220/206/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +365 -365
  461. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/347/224/237/347/211/251/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +269 -269
  462. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/213/261/350/257/255/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +113 -113
  463. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/344/270/255/350/257/255/346/226/207/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +105 -105
  464. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/345/210/206/345/255/220/345/214/226/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +101 -101
  465. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/344/273/243/346/225/260/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +157 -157
  466. package/md_cg/whitebox_kb/seed_knowledge/wisdom_cards//351/253/230/347/255/211/346/225/260/345/255/246/302/267/347/237/245/350/257/206/347/273/274/350/277/260.md +237 -237
  467. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  468. package/md_cg/whitebox_kb/wisdom/__init__.py +6 -6
  469. package/md_cg/whitebox_kb/wisdom/answer_spec_anchor.py +87 -87
  470. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  471. package/md_cg/whitebox_kb/wisdom/card_validator.py +223 -223
  472. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  473. package/md_cg/whitebox_kb/wisdom/chat.html +185 -185
  474. package/md_cg/whitebox_kb/wisdom/code_qa.py +119 -119
  475. package/md_cg/whitebox_kb/wisdom/code_route_bridge.py +90 -90
  476. package/md_cg/whitebox_kb/wisdom/code_test_runner.py +217 -217
  477. package/md_cg/whitebox_kb/wisdom/codegraph_white.py +312 -312
  478. package/md_cg/whitebox_kb/wisdom/compiler_compose.py +160 -160
  479. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  480. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  481. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  482. package/md_cg/whitebox_kb/wisdom/condition_vm.py +264 -264
  483. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  484. package/md_cg/whitebox_kb/wisdom/core/compiler.py +301 -301
  485. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  486. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  487. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  488. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  489. package/md_cg/whitebox_kb/wisdom/danmaku_bridge.py +141 -141
  490. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  491. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  492. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  493. package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md +52 -52
  494. package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md +54 -54
  495. package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md +34 -34
  496. package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md +71 -71
  497. package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md +47 -47
  498. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md +61 -61
  499. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  500. package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md +43 -43
  501. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/346/235/241/344/273/266/350/267/257/347/224/261/345/233/276_CCG/350/256/276/350/256/241.md +150 -150
  502. package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/350/257/255/344/271/211/346/235/241/344/273/266/345/215/217/350/256/256.md +650 -650
  503. package/md_cg/whitebox_kb/wisdom/docs//345/261/200/351/203/250/346/234/200/344/274/230/344/270/216/346/203/205/347/273/252/345/201/217/345/245/275_/347/220/206/350/256/272/345/267/245/347/250/213.md +97 -97
  504. package/md_cg/whitebox_kb/wisdom/docs//346/226/271/345/220/221/346/200/247/346/212/211/346/213/251_/350/207/252/344/270/276vs/350/207/252/350/277/255/344/273/243.md +81 -81
  505. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242AGI/346/236/266/346/236/204/346/216/242/347/264/242_/346/226/207/346/241/243/350/247/204/345/210/222.md +51 -51
  506. package/md_cg/whitebox_kb/wisdom/docs//347/201/265/346/236/242/346/217/222/344/273/266/345/210/206/347/261/273/345/210/206/346/236/220.md +67 -67
  507. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/346/234/254/345/234/260/346/240/241/351/252/214/345/231/250_ZeroLLM_Verifier.md +276 -276
  508. package/md_cg/whitebox_kb/wisdom/docs//347/231/275/347/256/261/350/207/252/344/270/276/347/254/254/345/205/255/351/230/266/346/256/265_/346/224/266/345/256/230/346/200/273/347/273/223.md +1207 -1207
  509. package/md_cg/whitebox_kb/wisdom/ds_compose.py +177 -177
  510. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  511. package/md_cg/whitebox_kb/wisdom/graph_qa.py +123 -123
  512. package/md_cg/whitebox_kb/wisdom/human_observer_knowledge.json +43 -43
  513. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  514. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -276
  515. package/md_cg/whitebox_kb/wisdom/merge_subgraph.py +178 -178
  516. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +314 -314
  517. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  518. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  519. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  520. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  521. package/md_cg/whitebox_kb/wisdom/role_compose.py +268 -268
  522. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  523. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  524. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  525. package/md_cg/whitebox_kb/wisdom/se_compose.py +137 -137
  526. package/md_cg/whitebox_kb/wisdom/snr_dashboard.py +219 -219
  527. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  528. package/md_cg/whitebox_kb/wisdom/spatial_closure.py +96 -96
  529. package/md_cg/whitebox_kb/wisdom/spatial_qa.py +182 -182
  530. package/md_cg/whitebox_kb/wisdom/status_terms.json +21 -21
  531. package/md_cg/whitebox_kb/wisdom/task_discipline.json +43 -43
  532. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  533. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  534. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  535. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  536. package/md_cg/whitebox_kb/wisdom/test_navigate_self_bootstrap.py +69 -69
  537. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  538. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  539. package/md_cg/whitebox_kb/wisdom/verify_answer.py +116 -116
  540. package/md_cg/whitebox_kb/wisdom/wisdom_book.py +2759 -2759
  541. package/md_cg/whitebox_kb/wisdom/wisdom_cloud.py +479 -479
  542. package/md_cg/whitebox_kb/wisdom/wisdom_ui.html +863 -863
  543. package/md_cg/writegate.py +146 -0
  544. package/md_cg/writepipe.py +85 -7
  545. package/package.json +20 -6
  546. package/scripts/workspace_index.py +1 -0
  547. package/skills/README.md +121 -121
  548. package/skills/plugin.json +54 -54
  549. package/skills/skills/designer-perspective/SKILL.md +158 -158
  550. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  551. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  552. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  553. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  554. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  555. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  556. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  557. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  558. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  559. package/skills/skills/lingshu-browser/units/browser-02898b15/SKILL.md +45 -45
  560. package/skills/skills/lingshu-browser/units/browser-03b04f98/SKILL.md +45 -45
  561. package/skills/skills/lingshu-browser/units/browser-0754386d/SKILL.md +45 -45
  562. package/skills/skills/lingshu-browser/units/browser-093c03ab/SKILL.md +45 -45
  563. package/skills/skills/lingshu-browser/units/browser-09e60b35/SKILL.md +45 -45
  564. package/skills/skills/lingshu-browser/units/browser-0ab4f2db/SKILL.md +45 -45
  565. package/skills/skills/lingshu-browser/units/browser-0c7f88d6/SKILL.md +45 -45
  566. package/skills/skills/lingshu-browser/units/browser-0f598430/SKILL.md +45 -45
  567. package/skills/skills/lingshu-browser/units/browser-0fd64fa5/SKILL.md +45 -45
  568. package/skills/skills/lingshu-browser/units/browser-17906c62/SKILL.md +45 -45
  569. package/skills/skills/lingshu-browser/units/browser-18f823e2/SKILL.md +45 -45
  570. package/skills/skills/lingshu-browser/units/browser-1bafe81c/SKILL.md +45 -45
  571. package/skills/skills/lingshu-browser/units/browser-1f9ab1f0/SKILL.md +45 -45
  572. package/skills/skills/lingshu-browser/units/browser-1fdb5852/SKILL.md +45 -45
  573. package/skills/skills/lingshu-browser/units/browser-21b0359c/SKILL.md +45 -45
  574. package/skills/skills/lingshu-browser/units/browser-22e8de36/SKILL.md +45 -45
  575. package/skills/skills/lingshu-browser/units/browser-24163519/SKILL.md +45 -45
  576. package/skills/skills/lingshu-browser/units/browser-2471a991/SKILL.md +45 -45
  577. package/skills/skills/lingshu-browser/units/browser-25afee4d/SKILL.md +45 -45
  578. package/skills/skills/lingshu-browser/units/browser-283a91bd/SKILL.md +45 -45
  579. package/skills/skills/lingshu-browser/units/browser-2895ff52/SKILL.md +45 -45
  580. package/skills/skills/lingshu-browser/units/browser-2cc1da58/SKILL.md +45 -45
  581. package/skills/skills/lingshu-browser/units/browser-3189fe6f/SKILL.md +45 -45
  582. package/skills/skills/lingshu-browser/units/browser-31f2b08f/SKILL.md +45 -45
  583. package/skills/skills/lingshu-browser/units/browser-37b8339e/SKILL.md +45 -45
  584. package/skills/skills/lingshu-browser/units/browser-396ec3a6/SKILL.md +45 -45
  585. package/skills/skills/lingshu-browser/units/browser-3df2f904/SKILL.md +45 -45
  586. package/skills/skills/lingshu-browser/units/browser-43154cec/SKILL.md +45 -45
  587. package/skills/skills/lingshu-browser/units/browser-434b74b8/SKILL.md +45 -45
  588. package/skills/skills/lingshu-browser/units/browser-440d4398/SKILL.md +45 -45
  589. package/skills/skills/lingshu-browser/units/browser-44d7f183/SKILL.md +45 -45
  590. package/skills/skills/lingshu-browser/units/browser-4d6c0788/SKILL.md +45 -45
  591. package/skills/skills/lingshu-browser/units/browser-50fecd89/SKILL.md +45 -45
  592. package/skills/skills/lingshu-browser/units/browser-555c0626/SKILL.md +45 -45
  593. package/skills/skills/lingshu-browser/units/browser-57312d24/SKILL.md +45 -45
  594. package/skills/skills/lingshu-browser/units/browser-59a0ada4/SKILL.md +45 -45
  595. package/skills/skills/lingshu-browser/units/browser-5a455aeb/SKILL.md +45 -45
  596. package/skills/skills/lingshu-browser/units/browser-5ae7623a/SKILL.md +45 -45
  597. package/skills/skills/lingshu-browser/units/browser-5dac60b6/SKILL.md +45 -45
  598. package/skills/skills/lingshu-browser/units/browser-5e5f1396/SKILL.md +45 -45
  599. package/skills/skills/lingshu-browser/units/browser-5ebb01dd/SKILL.md +45 -45
  600. package/skills/skills/lingshu-browser/units/browser-5f5453f9/SKILL.md +45 -45
  601. package/skills/skills/lingshu-browser/units/browser-5f90f58c/SKILL.md +45 -45
  602. package/skills/skills/lingshu-browser/units/browser-609362ee/SKILL.md +45 -45
  603. package/skills/skills/lingshu-browser/units/browser-60aefeeb/SKILL.md +45 -45
  604. package/skills/skills/lingshu-browser/units/browser-6636d49c/SKILL.md +45 -45
  605. package/skills/skills/lingshu-browser/units/browser-6cfcb6db/SKILL.md +45 -45
  606. package/skills/skills/lingshu-browser/units/browser-6e1c1158/SKILL.md +45 -45
  607. package/skills/skills/lingshu-browser/units/browser-7008e942/SKILL.md +45 -45
  608. package/skills/skills/lingshu-browser/units/browser-716cd26c/SKILL.md +45 -45
  609. package/skills/skills/lingshu-browser/units/browser-720ce1a1/SKILL.md +45 -45
  610. package/skills/skills/lingshu-browser/units/browser-77a97b43/SKILL.md +45 -45
  611. package/skills/skills/lingshu-browser/units/browser-7bb4871d/SKILL.md +45 -45
  612. package/skills/skills/lingshu-browser/units/browser-7be57bbe/SKILL.md +45 -45
  613. package/skills/skills/lingshu-browser/units/browser-7da433f3/SKILL.md +45 -45
  614. package/skills/skills/lingshu-browser/units/browser-7e96fe1d/SKILL.md +45 -45
  615. package/skills/skills/lingshu-browser/units/browser-7f9cefec/SKILL.md +45 -45
  616. package/skills/skills/lingshu-browser/units/browser-80224e71/SKILL.md +45 -45
  617. package/skills/skills/lingshu-browser/units/browser-81345ecd/SKILL.md +45 -45
  618. package/skills/skills/lingshu-browser/units/browser-822cfa44/SKILL.md +45 -45
  619. package/skills/skills/lingshu-browser/units/browser-853690c0/SKILL.md +45 -45
  620. package/skills/skills/lingshu-browser/units/browser-85553126/SKILL.md +45 -45
  621. package/skills/skills/lingshu-browser/units/browser-87b0ce80/SKILL.md +45 -45
  622. package/skills/skills/lingshu-browser/units/browser-900c4484/SKILL.md +45 -45
  623. package/skills/skills/lingshu-browser/units/browser-910405c4/SKILL.md +45 -45
  624. package/skills/skills/lingshu-browser/units/browser-95fd3c86/SKILL.md +45 -45
  625. package/skills/skills/lingshu-browser/units/browser-97a14ca3/SKILL.md +45 -45
  626. package/skills/skills/lingshu-browser/units/browser-9de10895/SKILL.md +45 -45
  627. package/skills/skills/lingshu-browser/units/browser-9e4914a7/SKILL.md +45 -45
  628. package/skills/skills/lingshu-browser/units/browser-a280ec64/SKILL.md +45 -45
  629. package/skills/skills/lingshu-browser/units/browser-a2d9b0b0/SKILL.md +45 -45
  630. package/skills/skills/lingshu-browser/units/browser-a372edeb/SKILL.md +45 -45
  631. package/skills/skills/lingshu-browser/units/browser-a4c793a4/SKILL.md +45 -45
  632. package/skills/skills/lingshu-browser/units/browser-a681d0c2/SKILL.md +45 -45
  633. package/skills/skills/lingshu-browser/units/browser-a7a2b0c1/SKILL.md +45 -45
  634. package/skills/skills/lingshu-browser/units/browser-a990e68e/SKILL.md +45 -45
  635. package/skills/skills/lingshu-browser/units/browser-aaac4eec/SKILL.md +45 -45
  636. package/skills/skills/lingshu-browser/units/browser-ae6586bb/SKILL.md +45 -45
  637. package/skills/skills/lingshu-browser/units/browser-afa4091f/SKILL.md +45 -45
  638. package/skills/skills/lingshu-browser/units/browser-b4c8cf65/SKILL.md +45 -45
  639. package/skills/skills/lingshu-browser/units/browser-b501767c/SKILL.md +45 -45
  640. package/skills/skills/lingshu-browser/units/browser-bcd4288d/SKILL.md +45 -45
  641. package/skills/skills/lingshu-browser/units/browser-bfad66a5/SKILL.md +45 -45
  642. package/skills/skills/lingshu-browser/units/browser-c45cbfe9/SKILL.md +45 -45
  643. package/skills/skills/lingshu-browser/units/browser-c4dd6078/SKILL.md +45 -45
  644. package/skills/skills/lingshu-browser/units/browser-c879eb0b/SKILL.md +45 -45
  645. package/skills/skills/lingshu-browser/units/browser-c92ac01b/SKILL.md +45 -45
  646. package/skills/skills/lingshu-browser/units/browser-cb179242/SKILL.md +45 -45
  647. package/skills/skills/lingshu-browser/units/browser-cc7d3d6d/SKILL.md +45 -45
  648. package/skills/skills/lingshu-browser/units/browser-cf3c47f0/SKILL.md +45 -45
  649. package/skills/skills/lingshu-browser/units/browser-cf9f812e/SKILL.md +45 -45
  650. package/skills/skills/lingshu-browser/units/browser-d462581c/SKILL.md +45 -45
  651. package/skills/skills/lingshu-browser/units/browser-d5fa0b7f/SKILL.md +45 -45
  652. package/skills/skills/lingshu-browser/units/browser-d72e225b/SKILL.md +45 -45
  653. package/skills/skills/lingshu-browser/units/browser-df1a919e/SKILL.md +45 -45
  654. package/skills/skills/lingshu-browser/units/browser-e84565c1/SKILL.md +45 -45
  655. package/skills/skills/lingshu-browser/units/browser-e947a564/SKILL.md +45 -45
  656. package/skills/skills/lingshu-browser/units/browser-ea9b2b8e/SKILL.md +45 -45
  657. package/skills/skills/lingshu-browser/units/browser-f5ffc6d9/SKILL.md +45 -45
  658. package/skills/skills/lingshu-browser/units/browser-f75a4418/SKILL.md +45 -45
  659. package/skills/skills/lingshu-browser/units/browser-f8f2966e/SKILL.md +45 -45
  660. package/skills/skills/lingshu-browser/units/browser-fa65fa2d/SKILL.md +45 -45
  661. package/skills/skills/lingshu-browser/units/browser-faac8812/SKILL.md +45 -45
  662. package/skills/skills/lingshu-browser/units/browser-ff94a671/SKILL.md +45 -45
  663. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  664. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  665. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  666. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  667. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  668. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  669. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  670. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  671. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  672. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  673. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  674. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  675. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  676. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  677. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  678. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  679. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  680. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  681. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  682. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  683. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  684. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  685. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  686. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  687. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  688. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  689. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  690. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  691. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  692. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  693. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  694. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  695. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  696. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  697. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  698. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  699. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  700. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  701. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  702. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  703. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  704. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  705. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  706. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  707. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  708. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  709. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  710. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  711. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  712. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  713. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  714. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  715. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  716. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  717. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  718. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  719. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  720. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  721. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  722. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  723. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  724. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  725. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  726. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  727. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  728. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  729. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  730. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  731. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  732. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  733. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  734. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  735. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  736. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  737. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  738. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  739. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  740. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  741. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  742. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  743. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  744. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  745. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  746. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  747. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  748. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  749. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  750. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  751. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  752. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  753. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  754. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  755. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  756. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  757. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  758. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  759. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  760. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  761. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  762. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  763. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  764. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  765. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  766. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  767. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  768. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  769. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  770. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  771. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  772. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  773. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  774. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  775. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  776. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  777. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  778. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  779. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  780. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  781. package/skills/skills/lingshu-graph/units/graph-04cd431b/SKILL.md +45 -45
  782. package/skills/skills/lingshu-graph/units/graph-06e2b1f2/SKILL.md +45 -45
  783. package/skills/skills/lingshu-graph/units/graph-0de12477/SKILL.md +45 -45
  784. package/skills/skills/lingshu-graph/units/graph-0e564e68/SKILL.md +45 -45
  785. package/skills/skills/lingshu-graph/units/graph-10d58a7b/SKILL.md +45 -45
  786. package/skills/skills/lingshu-graph/units/graph-12cd830a/SKILL.md +45 -45
  787. package/skills/skills/lingshu-graph/units/graph-185f2cd2/SKILL.md +45 -45
  788. package/skills/skills/lingshu-graph/units/graph-19a6a301/SKILL.md +45 -45
  789. package/skills/skills/lingshu-graph/units/graph-1b266557/SKILL.md +45 -45
  790. package/skills/skills/lingshu-graph/units/graph-1b707621/SKILL.md +45 -45
  791. package/skills/skills/lingshu-graph/units/graph-1d73b597/SKILL.md +45 -45
  792. package/skills/skills/lingshu-graph/units/graph-2041fa98/SKILL.md +45 -45
  793. package/skills/skills/lingshu-graph/units/graph-2461bc41/SKILL.md +45 -45
  794. package/skills/skills/lingshu-graph/units/graph-2465dff8/SKILL.md +45 -45
  795. package/skills/skills/lingshu-graph/units/graph-2508389f/SKILL.md +45 -45
  796. package/skills/skills/lingshu-graph/units/graph-276d554d/SKILL.md +45 -45
  797. package/skills/skills/lingshu-graph/units/graph-299f4a32/SKILL.md +45 -45
  798. package/skills/skills/lingshu-graph/units/graph-2d455cd8/SKILL.md +45 -45
  799. package/skills/skills/lingshu-graph/units/graph-2fddf701/SKILL.md +45 -45
  800. package/skills/skills/lingshu-graph/units/graph-33385442/SKILL.md +45 -45
  801. package/skills/skills/lingshu-graph/units/graph-34a1dba7/SKILL.md +45 -45
  802. package/skills/skills/lingshu-graph/units/graph-3721be1c/SKILL.md +45 -45
  803. package/skills/skills/lingshu-graph/units/graph-3755dbc9/SKILL.md +45 -45
  804. package/skills/skills/lingshu-graph/units/graph-37a45d4b/SKILL.md +45 -45
  805. package/skills/skills/lingshu-graph/units/graph-3a4a984c/SKILL.md +45 -45
  806. package/skills/skills/lingshu-graph/units/graph-3aa4c941/SKILL.md +45 -45
  807. package/skills/skills/lingshu-graph/units/graph-3b69a528/SKILL.md +45 -45
  808. package/skills/skills/lingshu-graph/units/graph-3bc2eb69/SKILL.md +45 -45
  809. package/skills/skills/lingshu-graph/units/graph-3d255ed4/SKILL.md +45 -45
  810. package/skills/skills/lingshu-graph/units/graph-3d34961d/SKILL.md +45 -45
  811. package/skills/skills/lingshu-graph/units/graph-3e18a380/SKILL.md +45 -45
  812. package/skills/skills/lingshu-graph/units/graph-3f920bf3/SKILL.md +45 -45
  813. package/skills/skills/lingshu-graph/units/graph-40b7bf61/SKILL.md +45 -45
  814. package/skills/skills/lingshu-graph/units/graph-42187d5d/SKILL.md +45 -45
  815. package/skills/skills/lingshu-graph/units/graph-4361c60e/SKILL.md +45 -45
  816. package/skills/skills/lingshu-graph/units/graph-44e56113/SKILL.md +45 -45
  817. package/skills/skills/lingshu-graph/units/graph-4b363727/SKILL.md +45 -45
  818. package/skills/skills/lingshu-graph/units/graph-52e6e216/SKILL.md +45 -45
  819. package/skills/skills/lingshu-graph/units/graph-53fbfef5/SKILL.md +45 -45
  820. package/skills/skills/lingshu-graph/units/graph-54ac2988/SKILL.md +45 -45
  821. package/skills/skills/lingshu-graph/units/graph-580dadcd/SKILL.md +45 -45
  822. package/skills/skills/lingshu-graph/units/graph-5ca34baa/SKILL.md +45 -45
  823. package/skills/skills/lingshu-graph/units/graph-5cb7fbdf/SKILL.md +45 -45
  824. package/skills/skills/lingshu-graph/units/graph-5f894c05/SKILL.md +45 -45
  825. package/skills/skills/lingshu-graph/units/graph-656e7bd4/SKILL.md +45 -45
  826. package/skills/skills/lingshu-graph/units/graph-6dc48231/SKILL.md +45 -45
  827. package/skills/skills/lingshu-graph/units/graph-7186924a/SKILL.md +45 -45
  828. package/skills/skills/lingshu-graph/units/graph-72ce5342/SKILL.md +45 -45
  829. package/skills/skills/lingshu-graph/units/graph-7376a24e/SKILL.md +45 -45
  830. package/skills/skills/lingshu-graph/units/graph-7412a7cb/SKILL.md +45 -45
  831. package/skills/skills/lingshu-graph/units/graph-7becedf0/SKILL.md +45 -45
  832. package/skills/skills/lingshu-graph/units/graph-7c38fbf3/SKILL.md +45 -45
  833. package/skills/skills/lingshu-graph/units/graph-7dc36de7/SKILL.md +45 -45
  834. package/skills/skills/lingshu-graph/units/graph-7fe49de7/SKILL.md +45 -45
  835. package/skills/skills/lingshu-graph/units/graph-80d82194/SKILL.md +45 -45
  836. package/skills/skills/lingshu-graph/units/graph-85bf101e/SKILL.md +45 -45
  837. package/skills/skills/lingshu-graph/units/graph-8650548b/SKILL.md +45 -45
  838. package/skills/skills/lingshu-graph/units/graph-86583b09/SKILL.md +45 -45
  839. package/skills/skills/lingshu-graph/units/graph-8727827c/SKILL.md +45 -45
  840. package/skills/skills/lingshu-graph/units/graph-873fb505/SKILL.md +45 -45
  841. package/skills/skills/lingshu-graph/units/graph-89b11de0/SKILL.md +45 -45
  842. package/skills/skills/lingshu-graph/units/graph-8d7b569b/SKILL.md +45 -45
  843. package/skills/skills/lingshu-graph/units/graph-8e920d5d/SKILL.md +45 -45
  844. package/skills/skills/lingshu-graph/units/graph-8eb38e3d/SKILL.md +45 -45
  845. package/skills/skills/lingshu-graph/units/graph-94582f69/SKILL.md +45 -45
  846. package/skills/skills/lingshu-graph/units/graph-947355f7/SKILL.md +45 -45
  847. package/skills/skills/lingshu-graph/units/graph-9507aff7/SKILL.md +45 -45
  848. package/skills/skills/lingshu-graph/units/graph-95b86a8b/SKILL.md +45 -45
  849. package/skills/skills/lingshu-graph/units/graph-96b85e1f/SKILL.md +45 -45
  850. package/skills/skills/lingshu-graph/units/graph-97b22f09/SKILL.md +45 -45
  851. package/skills/skills/lingshu-graph/units/graph-9833cfda/SKILL.md +45 -45
  852. package/skills/skills/lingshu-graph/units/graph-9aa8a3f4/SKILL.md +45 -45
  853. package/skills/skills/lingshu-graph/units/graph-9f6665c0/SKILL.md +45 -45
  854. package/skills/skills/lingshu-graph/units/graph-a125d282/SKILL.md +45 -45
  855. package/skills/skills/lingshu-graph/units/graph-a49ef4f0/SKILL.md +45 -45
  856. package/skills/skills/lingshu-graph/units/graph-a5cd04ae/SKILL.md +45 -45
  857. package/skills/skills/lingshu-graph/units/graph-add9a63b/SKILL.md +45 -45
  858. package/skills/skills/lingshu-graph/units/graph-b00e3dc7/SKILL.md +45 -45
  859. package/skills/skills/lingshu-graph/units/graph-b33a7662/SKILL.md +45 -45
  860. package/skills/skills/lingshu-graph/units/graph-b76d15ee/SKILL.md +45 -45
  861. package/skills/skills/lingshu-graph/units/graph-b77fa05a/SKILL.md +45 -45
  862. package/skills/skills/lingshu-graph/units/graph-b912fc3b/SKILL.md +45 -45
  863. package/skills/skills/lingshu-graph/units/graph-baf61b7c/SKILL.md +45 -45
  864. package/skills/skills/lingshu-graph/units/graph-c1d5687b/SKILL.md +45 -45
  865. package/skills/skills/lingshu-graph/units/graph-c407bbed/SKILL.md +45 -45
  866. package/skills/skills/lingshu-graph/units/graph-c4676460/SKILL.md +45 -45
  867. package/skills/skills/lingshu-graph/units/graph-c4a59d80/SKILL.md +45 -45
  868. package/skills/skills/lingshu-graph/units/graph-c5815621/SKILL.md +45 -45
  869. package/skills/skills/lingshu-graph/units/graph-ccad55f1/SKILL.md +45 -45
  870. package/skills/skills/lingshu-graph/units/graph-d0677ce1/SKILL.md +45 -45
  871. package/skills/skills/lingshu-graph/units/graph-d1289b39/SKILL.md +45 -45
  872. package/skills/skills/lingshu-graph/units/graph-d15f39b1/SKILL.md +45 -45
  873. package/skills/skills/lingshu-graph/units/graph-d40691ca/SKILL.md +45 -45
  874. package/skills/skills/lingshu-graph/units/graph-d43b387a/SKILL.md +45 -45
  875. package/skills/skills/lingshu-graph/units/graph-d4dd02f4/SKILL.md +45 -45
  876. package/skills/skills/lingshu-graph/units/graph-d724ea18/SKILL.md +45 -45
  877. package/skills/skills/lingshu-graph/units/graph-d74d36fd/SKILL.md +45 -45
  878. package/skills/skills/lingshu-graph/units/graph-d9d3934c/SKILL.md +45 -45
  879. package/skills/skills/lingshu-graph/units/graph-ddf563ff/SKILL.md +45 -45
  880. package/skills/skills/lingshu-graph/units/graph-de00894f/SKILL.md +45 -45
  881. package/skills/skills/lingshu-graph/units/graph-df1ebb63/SKILL.md +45 -45
  882. package/skills/skills/lingshu-graph/units/graph-e2905c20/SKILL.md +45 -45
  883. package/skills/skills/lingshu-graph/units/graph-e4f8cefd/SKILL.md +45 -45
  884. package/skills/skills/lingshu-graph/units/graph-ea3150e7/SKILL.md +45 -45
  885. package/skills/skills/lingshu-graph/units/graph-eb4ac7dd/SKILL.md +45 -45
  886. package/skills/skills/lingshu-graph/units/graph-ee9f6dfa/SKILL.md +45 -45
  887. package/skills/skills/lingshu-graph/units/graph-f055b2ea/SKILL.md +45 -45
  888. package/skills/skills/lingshu-graph/units/graph-f1891287/SKILL.md +45 -45
  889. package/skills/skills/lingshu-graph/units/graph-f1bb5aa1/SKILL.md +45 -45
  890. package/skills/skills/lingshu-graph/units/graph-f56fa220/SKILL.md +45 -45
  891. package/skills/skills/lingshu-graph/units/graph-f729034f/SKILL.md +45 -45
  892. package/skills/skills/lingshu-graph/units/graph-f748a63f/SKILL.md +45 -45
  893. package/skills/skills/lingshu-graph/units/graph-f8c4a59e/SKILL.md +45 -45
  894. package/skills/skills/lingshu-graph/units/graph-fca3d129/SKILL.md +45 -45
  895. package/skills/skills/lingshu-graph/units/graph-fd02d934/SKILL.md +45 -45
  896. package/skills/skills/lingshu-graph/units/graph-fd51ece9/SKILL.md +45 -45
  897. package/skills/skills/lingshu-graph/units/graph-fd6a81ab/SKILL.md +45 -45
  898. package/skills/skills/lingshu-net/SKILL.md +48 -48
  899. package/skills/skills/lingshu-net/units/net-02090d29/SKILL.md +45 -45
  900. package/skills/skills/lingshu-net/units/net-05937712/SKILL.md +45 -45
  901. package/skills/skills/lingshu-net/units/net-059d072f/SKILL.md +45 -45
  902. package/skills/skills/lingshu-net/units/net-080f6012/SKILL.md +45 -45
  903. package/skills/skills/lingshu-net/units/net-08a2fc88/SKILL.md +45 -45
  904. package/skills/skills/lingshu-net/units/net-0935edf1/SKILL.md +45 -45
  905. package/skills/skills/lingshu-net/units/net-0e7f91e4/SKILL.md +45 -45
  906. package/skills/skills/lingshu-net/units/net-0f2850e0/SKILL.md +45 -45
  907. package/skills/skills/lingshu-net/units/net-107ab486/SKILL.md +45 -45
  908. package/skills/skills/lingshu-net/units/net-111e79b0/SKILL.md +45 -45
  909. package/skills/skills/lingshu-net/units/net-126876c1/SKILL.md +45 -45
  910. package/skills/skills/lingshu-net/units/net-13eeb575/SKILL.md +45 -45
  911. package/skills/skills/lingshu-net/units/net-14102d54/SKILL.md +45 -45
  912. package/skills/skills/lingshu-net/units/net-14e9ad0d/SKILL.md +45 -45
  913. package/skills/skills/lingshu-net/units/net-184175d3/SKILL.md +45 -45
  914. package/skills/skills/lingshu-net/units/net-1da1c695/SKILL.md +45 -45
  915. package/skills/skills/lingshu-net/units/net-240a14ec/SKILL.md +45 -45
  916. package/skills/skills/lingshu-net/units/net-2784f98b/SKILL.md +45 -45
  917. package/skills/skills/lingshu-net/units/net-292ef917/SKILL.md +45 -45
  918. package/skills/skills/lingshu-net/units/net-3434e92f/SKILL.md +45 -45
  919. package/skills/skills/lingshu-net/units/net-35019e6b/SKILL.md +45 -45
  920. package/skills/skills/lingshu-net/units/net-3bbc6afb/SKILL.md +45 -45
  921. package/skills/skills/lingshu-net/units/net-3bdf9d9d/SKILL.md +45 -45
  922. package/skills/skills/lingshu-net/units/net-3dcb84d3/SKILL.md +45 -45
  923. package/skills/skills/lingshu-net/units/net-431cccf9/SKILL.md +45 -45
  924. package/skills/skills/lingshu-net/units/net-435a9f7f/SKILL.md +45 -45
  925. package/skills/skills/lingshu-net/units/net-4508101f/SKILL.md +45 -45
  926. package/skills/skills/lingshu-net/units/net-4585c9e7/SKILL.md +45 -45
  927. package/skills/skills/lingshu-net/units/net-479612a0/SKILL.md +45 -45
  928. package/skills/skills/lingshu-net/units/net-47a19838/SKILL.md +45 -45
  929. package/skills/skills/lingshu-net/units/net-4e36e1e3/SKILL.md +45 -45
  930. package/skills/skills/lingshu-net/units/net-509b8001/SKILL.md +45 -45
  931. package/skills/skills/lingshu-net/units/net-51930c5e/SKILL.md +45 -45
  932. package/skills/skills/lingshu-net/units/net-56dbd63f/SKILL.md +45 -45
  933. package/skills/skills/lingshu-net/units/net-57387462/SKILL.md +45 -45
  934. package/skills/skills/lingshu-net/units/net-5c115606/SKILL.md +45 -45
  935. package/skills/skills/lingshu-net/units/net-5d27f392/SKILL.md +45 -45
  936. package/skills/skills/lingshu-net/units/net-5f69c938/SKILL.md +45 -45
  937. package/skills/skills/lingshu-net/units/net-5fa6c13b/SKILL.md +45 -45
  938. package/skills/skills/lingshu-net/units/net-61580202/SKILL.md +45 -45
  939. package/skills/skills/lingshu-net/units/net-61926703/SKILL.md +45 -45
  940. package/skills/skills/lingshu-net/units/net-61f64fbc/SKILL.md +45 -45
  941. package/skills/skills/lingshu-net/units/net-6200f3b2/SKILL.md +45 -45
  942. package/skills/skills/lingshu-net/units/net-63c3eda3/SKILL.md +45 -45
  943. package/skills/skills/lingshu-net/units/net-66e6119b/SKILL.md +45 -45
  944. package/skills/skills/lingshu-net/units/net-68643014/SKILL.md +45 -45
  945. package/skills/skills/lingshu-net/units/net-686632aa/SKILL.md +45 -45
  946. package/skills/skills/lingshu-net/units/net-6967ff14/SKILL.md +45 -45
  947. package/skills/skills/lingshu-net/units/net-6996f499/SKILL.md +45 -45
  948. package/skills/skills/lingshu-net/units/net-6c3b02c2/SKILL.md +45 -45
  949. package/skills/skills/lingshu-net/units/net-6eb37f63/SKILL.md +45 -45
  950. package/skills/skills/lingshu-net/units/net-6f96c190/SKILL.md +45 -45
  951. package/skills/skills/lingshu-net/units/net-6fb27488/SKILL.md +45 -45
  952. package/skills/skills/lingshu-net/units/net-703559d0/SKILL.md +45 -45
  953. package/skills/skills/lingshu-net/units/net-706d2692/SKILL.md +45 -45
  954. package/skills/skills/lingshu-net/units/net-70a20e04/SKILL.md +45 -45
  955. package/skills/skills/lingshu-net/units/net-7376158c/SKILL.md +45 -45
  956. package/skills/skills/lingshu-net/units/net-74d647cb/SKILL.md +45 -45
  957. package/skills/skills/lingshu-net/units/net-74e8a576/SKILL.md +45 -45
  958. package/skills/skills/lingshu-net/units/net-7801c2c0/SKILL.md +45 -45
  959. package/skills/skills/lingshu-net/units/net-78cae54d/SKILL.md +45 -45
  960. package/skills/skills/lingshu-net/units/net-78ec0324/SKILL.md +45 -45
  961. package/skills/skills/lingshu-net/units/net-7998097c/SKILL.md +45 -45
  962. package/skills/skills/lingshu-net/units/net-7d81ae06/SKILL.md +45 -45
  963. package/skills/skills/lingshu-net/units/net-7eabbbc8/SKILL.md +45 -45
  964. package/skills/skills/lingshu-net/units/net-7ed4f2c5/SKILL.md +45 -45
  965. package/skills/skills/lingshu-net/units/net-80b56cd6/SKILL.md +45 -45
  966. package/skills/skills/lingshu-net/units/net-83447546/SKILL.md +45 -45
  967. package/skills/skills/lingshu-net/units/net-8361fe5b/SKILL.md +45 -45
  968. package/skills/skills/lingshu-net/units/net-85e3996c/SKILL.md +45 -45
  969. package/skills/skills/lingshu-net/units/net-8897d5cc/SKILL.md +45 -45
  970. package/skills/skills/lingshu-net/units/net-88ad93a6/SKILL.md +45 -45
  971. package/skills/skills/lingshu-net/units/net-8e6f359e/SKILL.md +45 -45
  972. package/skills/skills/lingshu-net/units/net-8edc4cdb/SKILL.md +45 -45
  973. package/skills/skills/lingshu-net/units/net-8f6169e9/SKILL.md +45 -45
  974. package/skills/skills/lingshu-net/units/net-91e00638/SKILL.md +45 -45
  975. package/skills/skills/lingshu-net/units/net-96c61a3c/SKILL.md +45 -45
  976. package/skills/skills/lingshu-net/units/net-99076a29/SKILL.md +45 -45
  977. package/skills/skills/lingshu-net/units/net-998f3641/SKILL.md +45 -45
  978. package/skills/skills/lingshu-net/units/net-a1d7228a/SKILL.md +45 -45
  979. package/skills/skills/lingshu-net/units/net-a74da501/SKILL.md +45 -45
  980. package/skills/skills/lingshu-net/units/net-ac57deb7/SKILL.md +45 -45
  981. package/skills/skills/lingshu-net/units/net-b22d2f2b/SKILL.md +45 -45
  982. package/skills/skills/lingshu-net/units/net-b2b29d8d/SKILL.md +45 -45
  983. package/skills/skills/lingshu-net/units/net-b2ddce5d/SKILL.md +45 -45
  984. package/skills/skills/lingshu-net/units/net-b4151e9a/SKILL.md +45 -45
  985. package/skills/skills/lingshu-net/units/net-b873d6f7/SKILL.md +45 -45
  986. package/skills/skills/lingshu-net/units/net-bd3d2d55/SKILL.md +45 -45
  987. package/skills/skills/lingshu-net/units/net-c2a3f019/SKILL.md +45 -45
  988. package/skills/skills/lingshu-net/units/net-c685b788/SKILL.md +45 -45
  989. package/skills/skills/lingshu-net/units/net-c6c1fd79/SKILL.md +45 -45
  990. package/skills/skills/lingshu-net/units/net-c74a1b5d/SKILL.md +45 -45
  991. package/skills/skills/lingshu-net/units/net-cdac702d/SKILL.md +45 -45
  992. package/skills/skills/lingshu-net/units/net-d12dff5c/SKILL.md +45 -45
  993. package/skills/skills/lingshu-net/units/net-d3747882/SKILL.md +45 -45
  994. package/skills/skills/lingshu-net/units/net-d5fefa59/SKILL.md +45 -45
  995. package/skills/skills/lingshu-net/units/net-d67ec725/SKILL.md +45 -45
  996. package/skills/skills/lingshu-net/units/net-d80c1c4c/SKILL.md +45 -45
  997. package/skills/skills/lingshu-net/units/net-d9cb43b0/SKILL.md +45 -45
  998. package/skills/skills/lingshu-net/units/net-da559517/SKILL.md +45 -45
  999. package/skills/skills/lingshu-net/units/net-db4f414e/SKILL.md +45 -45
  1000. package/skills/skills/lingshu-net/units/net-dc09d67c/SKILL.md +45 -45
  1001. package/skills/skills/lingshu-net/units/net-e2d185de/SKILL.md +45 -45
  1002. package/skills/skills/lingshu-net/units/net-e2fc73f8/SKILL.md +45 -45
  1003. package/skills/skills/lingshu-net/units/net-e33ef0c2/SKILL.md +45 -45
  1004. package/skills/skills/lingshu-net/units/net-e346863c/SKILL.md +45 -45
  1005. package/skills/skills/lingshu-net/units/net-e6b3389a/SKILL.md +45 -45
  1006. package/skills/skills/lingshu-net/units/net-e9758fc0/SKILL.md +45 -45
  1007. package/skills/skills/lingshu-net/units/net-e9a9747a/SKILL.md +45 -45
  1008. package/skills/skills/lingshu-net/units/net-ea14aab8/SKILL.md +45 -45
  1009. package/skills/skills/lingshu-net/units/net-eba92ac1/SKILL.md +45 -45
  1010. package/skills/skills/lingshu-net/units/net-f29d91d2/SKILL.md +45 -45
  1011. package/skills/skills/lingshu-net/units/net-f314dd0d/SKILL.md +45 -45
  1012. package/skills/skills/lingshu-net/units/net-f332b629/SKILL.md +45 -45
  1013. package/skills/skills/lingshu-net/units/net-f7df127c/SKILL.md +45 -45
  1014. package/skills/skills/lingshu-net/units/net-fb9d8f5d/SKILL.md +45 -45
  1015. package/skills/skills/lingshu-net/units/net-fdec2c86/SKILL.md +45 -45
  1016. package/skills/skills/lingshu-os/SKILL.md +64 -64
  1017. package/skills/skills/lingshu-os/units/os-0205cf9b/SKILL.md +45 -45
  1018. package/skills/skills/lingshu-os/units/os-027dc9be/SKILL.md +45 -45
  1019. package/skills/skills/lingshu-os/units/os-03c0d7d6/SKILL.md +45 -45
  1020. package/skills/skills/lingshu-os/units/os-040b5505/SKILL.md +45 -45
  1021. package/skills/skills/lingshu-os/units/os-06fa98ed/SKILL.md +45 -45
  1022. package/skills/skills/lingshu-os/units/os-0854291c/SKILL.md +45 -45
  1023. package/skills/skills/lingshu-os/units/os-0c7f14cb/SKILL.md +45 -45
  1024. package/skills/skills/lingshu-os/units/os-0d855af2/SKILL.md +45 -45
  1025. package/skills/skills/lingshu-os/units/os-0e87e997/SKILL.md +45 -45
  1026. package/skills/skills/lingshu-os/units/os-0f8ed882/SKILL.md +45 -45
  1027. package/skills/skills/lingshu-os/units/os-111ce1de/SKILL.md +45 -45
  1028. package/skills/skills/lingshu-os/units/os-1234eb00/SKILL.md +45 -45
  1029. package/skills/skills/lingshu-os/units/os-128f3820/SKILL.md +45 -45
  1030. package/skills/skills/lingshu-os/units/os-15796db5/SKILL.md +45 -45
  1031. package/skills/skills/lingshu-os/units/os-1898928a/SKILL.md +45 -45
  1032. package/skills/skills/lingshu-os/units/os-192b8ca9/SKILL.md +45 -45
  1033. package/skills/skills/lingshu-os/units/os-1d3bcf28/SKILL.md +45 -45
  1034. package/skills/skills/lingshu-os/units/os-1f224514/SKILL.md +45 -45
  1035. package/skills/skills/lingshu-os/units/os-26a4f86a/SKILL.md +45 -45
  1036. package/skills/skills/lingshu-os/units/os-29c96147/SKILL.md +45 -45
  1037. package/skills/skills/lingshu-os/units/os-2ea9a5ff/SKILL.md +45 -45
  1038. package/skills/skills/lingshu-os/units/os-300ef22c/SKILL.md +45 -45
  1039. package/skills/skills/lingshu-os/units/os-310dda5b/SKILL.md +45 -45
  1040. package/skills/skills/lingshu-os/units/os-313ef4ed/SKILL.md +45 -45
  1041. package/skills/skills/lingshu-os/units/os-329a2147/SKILL.md +45 -45
  1042. package/skills/skills/lingshu-os/units/os-34ad4b62/SKILL.md +45 -45
  1043. package/skills/skills/lingshu-os/units/os-350bc623/SKILL.md +45 -45
  1044. package/skills/skills/lingshu-os/units/os-35ee1a30/SKILL.md +45 -45
  1045. package/skills/skills/lingshu-os/units/os-3cd28220/SKILL.md +45 -45
  1046. package/skills/skills/lingshu-os/units/os-3d84e0c9/SKILL.md +45 -45
  1047. package/skills/skills/lingshu-os/units/os-3db42aac/SKILL.md +45 -45
  1048. package/skills/skills/lingshu-os/units/os-3e0aff42/SKILL.md +45 -45
  1049. package/skills/skills/lingshu-os/units/os-3e9405d2/SKILL.md +45 -45
  1050. package/skills/skills/lingshu-os/units/os-41d14544/SKILL.md +45 -45
  1051. package/skills/skills/lingshu-os/units/os-462f3ed4/SKILL.md +45 -45
  1052. package/skills/skills/lingshu-os/units/os-485833fa/SKILL.md +45 -45
  1053. package/skills/skills/lingshu-os/units/os-4a1cf781/SKILL.md +45 -45
  1054. package/skills/skills/lingshu-os/units/os-4bf77933/SKILL.md +45 -45
  1055. package/skills/skills/lingshu-os/units/os-4c14cec2/SKILL.md +45 -45
  1056. package/skills/skills/lingshu-os/units/os-4f05d577/SKILL.md +45 -45
  1057. package/skills/skills/lingshu-os/units/os-4f50ad0b/SKILL.md +45 -45
  1058. package/skills/skills/lingshu-os/units/os-509a4596/SKILL.md +45 -45
  1059. package/skills/skills/lingshu-os/units/os-512b1b6c/SKILL.md +45 -45
  1060. package/skills/skills/lingshu-os/units/os-5192621b/SKILL.md +45 -45
  1061. package/skills/skills/lingshu-os/units/os-55672763/SKILL.md +45 -45
  1062. package/skills/skills/lingshu-os/units/os-5582bce6/SKILL.md +45 -45
  1063. package/skills/skills/lingshu-os/units/os-5a096a1f/SKILL.md +45 -45
  1064. package/skills/skills/lingshu-os/units/os-5ca15108/SKILL.md +45 -45
  1065. package/skills/skills/lingshu-os/units/os-601663e1/SKILL.md +45 -45
  1066. package/skills/skills/lingshu-os/units/os-607f1963/SKILL.md +45 -45
  1067. package/skills/skills/lingshu-os/units/os-6158581b/SKILL.md +45 -45
  1068. package/skills/skills/lingshu-os/units/os-62f9278b/SKILL.md +45 -45
  1069. package/skills/skills/lingshu-os/units/os-63797b86/SKILL.md +45 -45
  1070. package/skills/skills/lingshu-os/units/os-6a1fe224/SKILL.md +45 -45
  1071. package/skills/skills/lingshu-os/units/os-6b0a68bf/SKILL.md +45 -45
  1072. package/skills/skills/lingshu-os/units/os-6e5cee67/SKILL.md +45 -45
  1073. package/skills/skills/lingshu-os/units/os-6fb1ff58/SKILL.md +45 -45
  1074. package/skills/skills/lingshu-os/units/os-71389592/SKILL.md +45 -45
  1075. package/skills/skills/lingshu-os/units/os-72e879a3/SKILL.md +45 -45
  1076. package/skills/skills/lingshu-os/units/os-7598748a/SKILL.md +45 -45
  1077. package/skills/skills/lingshu-os/units/os-80cc3283/SKILL.md +45 -45
  1078. package/skills/skills/lingshu-os/units/os-819f3093/SKILL.md +45 -45
  1079. package/skills/skills/lingshu-os/units/os-83670c2b/SKILL.md +45 -45
  1080. package/skills/skills/lingshu-os/units/os-878c18b3/SKILL.md +45 -45
  1081. package/skills/skills/lingshu-os/units/os-89ed7af1/SKILL.md +45 -45
  1082. package/skills/skills/lingshu-os/units/os-8cb7279d/SKILL.md +45 -45
  1083. package/skills/skills/lingshu-os/units/os-92276145/SKILL.md +45 -45
  1084. package/skills/skills/lingshu-os/units/os-955c4d66/SKILL.md +45 -45
  1085. package/skills/skills/lingshu-os/units/os-97aacf40/SKILL.md +45 -45
  1086. package/skills/skills/lingshu-os/units/os-9b6ed02c/SKILL.md +45 -45
  1087. package/skills/skills/lingshu-os/units/os-9c86a7a2/SKILL.md +45 -45
  1088. package/skills/skills/lingshu-os/units/os-a13ce4aa/SKILL.md +45 -45
  1089. package/skills/skills/lingshu-os/units/os-a568affe/SKILL.md +45 -45
  1090. package/skills/skills/lingshu-os/units/os-abd48f17/SKILL.md +45 -45
  1091. package/skills/skills/lingshu-os/units/os-b0416edc/SKILL.md +45 -45
  1092. package/skills/skills/lingshu-os/units/os-b6509cac/SKILL.md +45 -45
  1093. package/skills/skills/lingshu-os/units/os-b718657b/SKILL.md +45 -45
  1094. package/skills/skills/lingshu-os/units/os-b776ade1/SKILL.md +45 -45
  1095. package/skills/skills/lingshu-os/units/os-ba24fa08/SKILL.md +45 -45
  1096. package/skills/skills/lingshu-os/units/os-bd1fc177/SKILL.md +45 -45
  1097. package/skills/skills/lingshu-os/units/os-bda92711/SKILL.md +45 -45
  1098. package/skills/skills/lingshu-os/units/os-c0fa71bd/SKILL.md +45 -45
  1099. package/skills/skills/lingshu-os/units/os-c3d5cd44/SKILL.md +45 -45
  1100. package/skills/skills/lingshu-os/units/os-c6b6a763/SKILL.md +45 -45
  1101. package/skills/skills/lingshu-os/units/os-c7661eb1/SKILL.md +45 -45
  1102. package/skills/skills/lingshu-os/units/os-c76b5a43/SKILL.md +45 -45
  1103. package/skills/skills/lingshu-os/units/os-c7d35a30/SKILL.md +45 -45
  1104. package/skills/skills/lingshu-os/units/os-c980a25d/SKILL.md +45 -45
  1105. package/skills/skills/lingshu-os/units/os-c9f8df6e/SKILL.md +45 -45
  1106. package/skills/skills/lingshu-os/units/os-cc49ef2f/SKILL.md +45 -45
  1107. package/skills/skills/lingshu-os/units/os-cd9e686a/SKILL.md +45 -45
  1108. package/skills/skills/lingshu-os/units/os-cfa66a1b/SKILL.md +45 -45
  1109. package/skills/skills/lingshu-os/units/os-d237e500/SKILL.md +45 -45
  1110. package/skills/skills/lingshu-os/units/os-d39ef086/SKILL.md +45 -45
  1111. package/skills/skills/lingshu-os/units/os-d4f9e813/SKILL.md +45 -45
  1112. package/skills/skills/lingshu-os/units/os-d97915c0/SKILL.md +45 -45
  1113. package/skills/skills/lingshu-os/units/os-da0aadde/SKILL.md +45 -45
  1114. package/skills/skills/lingshu-os/units/os-da482caf/SKILL.md +45 -45
  1115. package/skills/skills/lingshu-os/units/os-dd4ff45e/SKILL.md +45 -45
  1116. package/skills/skills/lingshu-os/units/os-de0556c5/SKILL.md +45 -45
  1117. package/skills/skills/lingshu-os/units/os-e0ad3364/SKILL.md +45 -45
  1118. package/skills/skills/lingshu-os/units/os-e7612c68/SKILL.md +45 -45
  1119. package/skills/skills/lingshu-os/units/os-ea444e45/SKILL.md +45 -45
  1120. package/skills/skills/lingshu-os/units/os-ea6e7e0b/SKILL.md +45 -45
  1121. package/skills/skills/lingshu-os/units/os-ebc34d83/SKILL.md +45 -45
  1122. package/skills/skills/lingshu-os/units/os-ecbebbe3/SKILL.md +45 -45
  1123. package/skills/skills/lingshu-os/units/os-ecfceae7/SKILL.md +45 -45
  1124. package/skills/skills/lingshu-os/units/os-ed8de3a3/SKILL.md +45 -45
  1125. package/skills/skills/lingshu-os/units/os-f69c0b08/SKILL.md +45 -45
  1126. package/skills/skills/lingshu-os/units/os-f6ae6205/SKILL.md +45 -45
  1127. package/skills/skills/lingshu-os/units/os-f9bf8dd4/SKILL.md +45 -45
  1128. package/skills/skills/lingshu-os/units/os-fcdd828d/SKILL.md +45 -45
  1129. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  1130. package/skills/skills/lingshu-pylang/units/pylang-01b23f80/SKILL.md +45 -45
  1131. package/skills/skills/lingshu-pylang/units/pylang-074fd698/SKILL.md +45 -45
  1132. package/skills/skills/lingshu-pylang/units/pylang-0b490bb2/SKILL.md +45 -45
  1133. package/skills/skills/lingshu-pylang/units/pylang-0ca7f08b/SKILL.md +45 -45
  1134. package/skills/skills/lingshu-pylang/units/pylang-10ce3e91/SKILL.md +45 -45
  1135. package/skills/skills/lingshu-pylang/units/pylang-15f76c64/SKILL.md +45 -45
  1136. package/skills/skills/lingshu-pylang/units/pylang-1703046f/SKILL.md +45 -45
  1137. package/skills/skills/lingshu-pylang/units/pylang-1aa3e939/SKILL.md +45 -45
  1138. package/skills/skills/lingshu-pylang/units/pylang-1bed54cf/SKILL.md +45 -45
  1139. package/skills/skills/lingshu-pylang/units/pylang-1dd35612/SKILL.md +45 -45
  1140. package/skills/skills/lingshu-pylang/units/pylang-24273d7b/SKILL.md +45 -45
  1141. package/skills/skills/lingshu-pylang/units/pylang-2853f59f/SKILL.md +45 -45
  1142. package/skills/skills/lingshu-pylang/units/pylang-2a6bc16e/SKILL.md +45 -45
  1143. package/skills/skills/lingshu-pylang/units/pylang-2ae78997/SKILL.md +45 -45
  1144. package/skills/skills/lingshu-pylang/units/pylang-2bc88f4c/SKILL.md +45 -45
  1145. package/skills/skills/lingshu-pylang/units/pylang-31f5b8db/SKILL.md +45 -45
  1146. package/skills/skills/lingshu-pylang/units/pylang-36d178bc/SKILL.md +45 -45
  1147. package/skills/skills/lingshu-pylang/units/pylang-38600583/SKILL.md +45 -45
  1148. package/skills/skills/lingshu-pylang/units/pylang-38e8f9ff/SKILL.md +45 -45
  1149. package/skills/skills/lingshu-pylang/units/pylang-395085ca/SKILL.md +45 -45
  1150. package/skills/skills/lingshu-pylang/units/pylang-399b317e/SKILL.md +45 -45
  1151. package/skills/skills/lingshu-pylang/units/pylang-39c72c78/SKILL.md +45 -45
  1152. package/skills/skills/lingshu-pylang/units/pylang-3a659480/SKILL.md +45 -45
  1153. package/skills/skills/lingshu-pylang/units/pylang-482be62b/SKILL.md +45 -45
  1154. package/skills/skills/lingshu-pylang/units/pylang-486a1e94/SKILL.md +45 -45
  1155. package/skills/skills/lingshu-pylang/units/pylang-49026041/SKILL.md +45 -45
  1156. package/skills/skills/lingshu-pylang/units/pylang-4963b28a/SKILL.md +45 -45
  1157. package/skills/skills/lingshu-pylang/units/pylang-4af9140e/SKILL.md +45 -45
  1158. package/skills/skills/lingshu-pylang/units/pylang-4ca283f2/SKILL.md +45 -45
  1159. package/skills/skills/lingshu-pylang/units/pylang-4ddf31f3/SKILL.md +45 -45
  1160. package/skills/skills/lingshu-pylang/units/pylang-50614726/SKILL.md +45 -45
  1161. package/skills/skills/lingshu-pylang/units/pylang-5102c069/SKILL.md +45 -45
  1162. package/skills/skills/lingshu-pylang/units/pylang-521b1bf8/SKILL.md +45 -45
  1163. package/skills/skills/lingshu-pylang/units/pylang-5880b7a1/SKILL.md +45 -45
  1164. package/skills/skills/lingshu-pylang/units/pylang-61a9102d/SKILL.md +45 -45
  1165. package/skills/skills/lingshu-pylang/units/pylang-621123dd/SKILL.md +45 -45
  1166. package/skills/skills/lingshu-pylang/units/pylang-642cd625/SKILL.md +45 -45
  1167. package/skills/skills/lingshu-pylang/units/pylang-65ca79b7/SKILL.md +45 -45
  1168. package/skills/skills/lingshu-pylang/units/pylang-672df225/SKILL.md +45 -45
  1169. package/skills/skills/lingshu-pylang/units/pylang-67d3368e/SKILL.md +45 -45
  1170. package/skills/skills/lingshu-pylang/units/pylang-6be54340/SKILL.md +45 -45
  1171. package/skills/skills/lingshu-pylang/units/pylang-70b2006f/SKILL.md +45 -45
  1172. package/skills/skills/lingshu-pylang/units/pylang-70b215f1/SKILL.md +45 -45
  1173. package/skills/skills/lingshu-pylang/units/pylang-730c3fe4/SKILL.md +45 -45
  1174. package/skills/skills/lingshu-pylang/units/pylang-733c1286/SKILL.md +45 -45
  1175. package/skills/skills/lingshu-pylang/units/pylang-79845f4d/SKILL.md +45 -45
  1176. package/skills/skills/lingshu-pylang/units/pylang-7c4cc6f8/SKILL.md +45 -45
  1177. package/skills/skills/lingshu-pylang/units/pylang-7c7193ad/SKILL.md +45 -45
  1178. package/skills/skills/lingshu-pylang/units/pylang-7d86ab5d/SKILL.md +45 -45
  1179. package/skills/skills/lingshu-pylang/units/pylang-7df8ca78/SKILL.md +45 -45
  1180. package/skills/skills/lingshu-pylang/units/pylang-8182681d/SKILL.md +45 -45
  1181. package/skills/skills/lingshu-pylang/units/pylang-81ad40ee/SKILL.md +45 -45
  1182. package/skills/skills/lingshu-pylang/units/pylang-8283d7c0/SKILL.md +45 -45
  1183. package/skills/skills/lingshu-pylang/units/pylang-82b73f3d/SKILL.md +45 -45
  1184. package/skills/skills/lingshu-pylang/units/pylang-8404bbde/SKILL.md +45 -45
  1185. package/skills/skills/lingshu-pylang/units/pylang-8584040d/SKILL.md +45 -45
  1186. package/skills/skills/lingshu-pylang/units/pylang-85d8617b/SKILL.md +45 -45
  1187. package/skills/skills/lingshu-pylang/units/pylang-886935a3/SKILL.md +45 -45
  1188. package/skills/skills/lingshu-pylang/units/pylang-88ab2f96/SKILL.md +45 -45
  1189. package/skills/skills/lingshu-pylang/units/pylang-8b6f071e/SKILL.md +45 -45
  1190. package/skills/skills/lingshu-pylang/units/pylang-8d6ec58a/SKILL.md +45 -45
  1191. package/skills/skills/lingshu-pylang/units/pylang-8fe98252/SKILL.md +45 -45
  1192. package/skills/skills/lingshu-pylang/units/pylang-9018c39a/SKILL.md +45 -45
  1193. package/skills/skills/lingshu-pylang/units/pylang-91277748/SKILL.md +45 -45
  1194. package/skills/skills/lingshu-pylang/units/pylang-943b9dcb/SKILL.md +45 -45
  1195. package/skills/skills/lingshu-pylang/units/pylang-961e9e43/SKILL.md +45 -45
  1196. package/skills/skills/lingshu-pylang/units/pylang-962954d9/SKILL.md +45 -45
  1197. package/skills/skills/lingshu-pylang/units/pylang-9dbd8e2b/SKILL.md +45 -45
  1198. package/skills/skills/lingshu-pylang/units/pylang-a02eac31/SKILL.md +45 -45
  1199. package/skills/skills/lingshu-pylang/units/pylang-a4d3d7b1/SKILL.md +45 -45
  1200. package/skills/skills/lingshu-pylang/units/pylang-a7c3d0e2/SKILL.md +45 -45
  1201. package/skills/skills/lingshu-pylang/units/pylang-a88db70d/SKILL.md +45 -45
  1202. package/skills/skills/lingshu-pylang/units/pylang-ab7dddc2/SKILL.md +45 -45
  1203. package/skills/skills/lingshu-pylang/units/pylang-ac2a4b38/SKILL.md +45 -45
  1204. package/skills/skills/lingshu-pylang/units/pylang-afaf67c0/SKILL.md +45 -45
  1205. package/skills/skills/lingshu-pylang/units/pylang-b00660e6/SKILL.md +45 -45
  1206. package/skills/skills/lingshu-pylang/units/pylang-b4d7616d/SKILL.md +45 -45
  1207. package/skills/skills/lingshu-pylang/units/pylang-b67b1878/SKILL.md +45 -45
  1208. package/skills/skills/lingshu-pylang/units/pylang-b8040e1c/SKILL.md +45 -45
  1209. package/skills/skills/lingshu-pylang/units/pylang-b880c6c6/SKILL.md +45 -45
  1210. package/skills/skills/lingshu-pylang/units/pylang-b8d45f76/SKILL.md +45 -45
  1211. package/skills/skills/lingshu-pylang/units/pylang-ba956e52/SKILL.md +45 -45
  1212. package/skills/skills/lingshu-pylang/units/pylang-bb18b1f9/SKILL.md +45 -45
  1213. package/skills/skills/lingshu-pylang/units/pylang-bb46f3f2/SKILL.md +45 -45
  1214. package/skills/skills/lingshu-pylang/units/pylang-be55a094/SKILL.md +45 -45
  1215. package/skills/skills/lingshu-pylang/units/pylang-beb47b63/SKILL.md +45 -45
  1216. package/skills/skills/lingshu-pylang/units/pylang-c017681a/SKILL.md +45 -45
  1217. package/skills/skills/lingshu-pylang/units/pylang-c1317cd9/SKILL.md +45 -45
  1218. package/skills/skills/lingshu-pylang/units/pylang-c36fabf7/SKILL.md +45 -45
  1219. package/skills/skills/lingshu-pylang/units/pylang-c42465ec/SKILL.md +45 -45
  1220. package/skills/skills/lingshu-pylang/units/pylang-c5c76a12/SKILL.md +45 -45
  1221. package/skills/skills/lingshu-pylang/units/pylang-c910ad31/SKILL.md +45 -45
  1222. package/skills/skills/lingshu-pylang/units/pylang-ca9332cf/SKILL.md +45 -45
  1223. package/skills/skills/lingshu-pylang/units/pylang-cce90fa0/SKILL.md +45 -45
  1224. package/skills/skills/lingshu-pylang/units/pylang-cd4234a5/SKILL.md +45 -45
  1225. package/skills/skills/lingshu-pylang/units/pylang-cf0fca1c/SKILL.md +45 -45
  1226. package/skills/skills/lingshu-pylang/units/pylang-d2001e1f/SKILL.md +45 -45
  1227. package/skills/skills/lingshu-pylang/units/pylang-d616eb28/SKILL.md +45 -45
  1228. package/skills/skills/lingshu-pylang/units/pylang-d8962e66/SKILL.md +45 -45
  1229. package/skills/skills/lingshu-pylang/units/pylang-db6214cd/SKILL.md +45 -45
  1230. package/skills/skills/lingshu-pylang/units/pylang-dcde3040/SKILL.md +45 -45
  1231. package/skills/skills/lingshu-pylang/units/pylang-dfad3dba/SKILL.md +45 -45
  1232. package/skills/skills/lingshu-pylang/units/pylang-dfd5aac2/SKILL.md +45 -45
  1233. package/skills/skills/lingshu-pylang/units/pylang-e1aa3818/SKILL.md +45 -45
  1234. package/skills/skills/lingshu-pylang/units/pylang-e476915b/SKILL.md +45 -45
  1235. package/skills/skills/lingshu-pylang/units/pylang-e88e31fd/SKILL.md +45 -45
  1236. package/skills/skills/lingshu-pylang/units/pylang-ecd569d2/SKILL.md +45 -45
  1237. package/skills/skills/lingshu-pylang/units/pylang-ecf27e0c/SKILL.md +45 -45
  1238. package/skills/skills/lingshu-pylang/units/pylang-f124f0e6/SKILL.md +45 -45
  1239. package/skills/skills/lingshu-pylang/units/pylang-f127a8d1/SKILL.md +45 -45
  1240. package/skills/skills/lingshu-pylang/units/pylang-f2d6ec27/SKILL.md +45 -45
  1241. package/skills/skills/lingshu-pylang/units/pylang-f2f40090/SKILL.md +45 -45
  1242. package/skills/skills/lingshu-pylang/units/pylang-f4aa9e65/SKILL.md +45 -45
  1243. package/skills/skills/lingshu-pylang/units/pylang-f4f820d4/SKILL.md +45 -45
  1244. package/skills/skills/lingshu-pylang/units/pylang-f5b34833/SKILL.md +45 -45
  1245. package/skills/skills/lingshu-pylang/units/pylang-f6ebb66e/SKILL.md +45 -45
  1246. package/skills/skills/lingshu-pylang/units/pylang-f78bdcd7/SKILL.md +45 -45
  1247. package/skills/skills/lingshu-pylang/units/pylang-f92bc49b/SKILL.md +45 -45
  1248. package/skills/skills/lingshu-pylang/units/pylang-fd7595f0/SKILL.md +45 -45
  1249. package/skills/skills/lingshu-pylang/units/pylang-fda87aa1/SKILL.md +45 -45
  1250. package/src/hooks.ts +21 -12
  1251. package/src/index.ts +3 -0
  1252. package/src/lib/console_web.mjs +96 -0
  1253. package/src/lib/python_path.ts +71 -71
  1254. package/src/lib/session_state.ts +127 -127
  1255. package/src/lib/whitebox_llm.ts +311 -311
  1256. package/ui/minimal/LICENSE +21 -0
  1257. package/ui/minimal/install.ps1 +168 -0
  1258. package/ui/minimal/integrity.json +41 -0
  1259. package/ui/minimal/payload/build-ui.mjs +16 -0
  1260. package/ui/minimal/payload/lib/client.js +18 -0
  1261. package/ui/minimal/payload/lib/lib/console_web.mjs +96 -0
  1262. package/ui/minimal/payload/src/lib/console_web.mjs +96 -0
  1263. package/ui/minimal/payload/web/app.js +154 -0
  1264. package/ui/minimal/payload/web/client.js +14 -0
  1265. package/ui/minimal/payload/web/entry.js +1 -0
  1266. package/ui/minimal/payload/web/index.html +3 -0
  1267. package/ui/minimal/payload/web/style.css +3 -0
  1268. package/ui/minimal//344/275/277/347/224/250/350/257/264/346/230/216.md +60 -0
  1269. package/ui/minimal//345/215/270/350/275/275UI.cmd +6 -0
  1270. package/ui/minimal//345/256/211/350/243/205UI.cmd +6 -0
  1271. package/utf8_boot.py +237 -237
  1272. package/web/app.js +154 -0
  1273. package/web/client.js +14 -0
  1274. package/web/entry.js +1 -0
  1275. package/web/index.html +3 -0
  1276. package/web/style.css +3 -0
@@ -1,695 +1,695 @@
1
- # -*- coding: utf-8 -*-
2
- """记忆评审流水线 · 级 4:M4 落库治理(确定性部分 · rule 驱动 · 永不删除)。
3
-
4
- 真源:`docs/记忆评审系统_立项设计与施工交接_20260915.md` §3 第 4 级 + §6 验收 + §7 负面清单。
5
- 本模块只做**机械可裁决**的治理动作(回填等);LLM 语义类(合并 / 降权)不在其列——
6
- 那属 M2 建议 + designer 终裁,本轮不落地。
7
-
8
- **规则驱动,引擎不写死**:回填哪个字段、作用于哪些层,不写在本文件里,从 M1 规则库
9
- (`rules/*.json`,数据真源)读——`R-ROLE-MISSING` 的 `matcher.layer` 定作用域、
10
- `mechanical[check=field_absent].field` 定字段。改靶子 = 改数据,引擎冻结。
11
-
12
- **来源链(只搬运已声明证据)**:
13
-
14
- ① `tags` `role:<值>` 标签——显式成文声明;
15
- ② `map` `frontmatter.writer` → role 的**声明映射表**(`WRITER_ROLE_MAP`)。
16
- 当前**故意为空**:库内无任何成文映射能把 writer(`MDCG_ACTOR`:
17
- dsh-memory / codebuddy / zcode / designer-cli…)落到
18
- `mdcos.ALL_ROLES`;`scripts/review_cli.py` 的
19
- `Principal(role="designer")` 属**权限角色**(`tokens.ROLE_SPECS`),
20
- 与节点 role 是两套词汇,混填即污染域。故留空 + 通道保留,待终裁补表;
21
- ③ `layer_default` 层默认投影——真源 = `mdcos.MdCGOS.add` 成文语义「默认 role=None
22
- (知识)」,即缺省来源 = knowledge。该档是「隐含默认的显式化」,
23
- 断言强度高于 ①②,故单独分档上报(`by_source`);只认显式成文声明时
24
- 用 `sources=("tags","map")` 关掉它。
25
-
26
- **域封闭**:写入值必须 ∈ `mdcos.ALL_ROLES`;域外值一律不写,记 `*_out_of_domain` 且
27
- **停止降级**(显式声明了域外值 ≠ 无声明,回退到默认档会把待裁决冲突悄悄抹平)。
28
- `tool-output/command/edit` 属工作角色(`WORK_ROLES`,默认不参与正排,见
29
- `mdcos._candidates`)。故 ② `map` 档**显式拒绝**工作角色(命中即
30
- `map_role_is_work_role`,不降级)——映射表是本引擎的推断,把知识节点推成工作角色
31
- 等于亲手把它从默认召回里摘掉;① `tags` 档是**写入者成文声明**,予以尊重(治理层
32
- 不替作者改主意)。
33
-
34
- **五纪律**(对齐 `backfill`):不猜测(无来源 → `unfillable` + 原因分布,绝不编造)/
35
- 可预演(`role_plan` 只出报表,`role_apply` 写前重查,已有值计 `skipped_drift`)/
36
- 可留痕(`_govern.jsonl`:前后值 / 依据 / 来源档 / 批次 / 操作者 / 规则 id)/
37
- 可回滚(只在当前值 == 写入值时撤销,否则 `conflict`;原本无键 → 删键还原)/
38
- fail-closed(密文与不可读节点跳过,绝不解密回写;靶规则缺失抛错)。
39
- §7 负面清单:只写 frontmatter 一个字段,不动正文、永不删除。
40
- """
41
- from __future__ import annotations
42
-
43
- import argparse
44
- import json
45
- import os
46
- import sys
47
- import time
48
-
49
- from .. import crypto
50
- from ..backfill import _as_cg, _entry_id, _readable_guard, _sha
51
- from ..fsutil import append_jsonl, read_jsonl
52
- from ..mdcos import ALL_ROLES, WORK_ROLES
53
- from .ruleset import _as_rules, _blank
54
- from ..readcache import direct_read
55
-
56
- #: 留痕文件名(与 `backfill._backfill.jsonl` 分立:治理动作须能独立审计)
57
- GOVERN_LOG = "_govern.jsonl"
58
-
59
- #: 默认靶规则;`field_absent` 检查名(与 `ruleset.MECH_CHECKS` 同名)
60
- RULE_ROLE = "R-ROLE-MISSING"
61
- CHECK_FIELD_ABSENT = "field_absent"
62
-
63
- #: 来源档
64
- SOURCE_TAGS = "tags"
65
- SOURCE_MAP = "map"
66
- SOURCE_LAYER = "layer_default"
67
- ALL_SOURCES = (SOURCE_TAGS, SOURCE_MAP, SOURCE_LAYER)
68
- #: 默认只开「成文声明」两档;③ `layer_default` **必须显式开启**。
69
- #: 依据(2026-09-16 真实库实测):writer/tags 面无任何成文声明,故默认档在真实库上
70
- #: 产出 `targeted=0 / unfillable=11120`(原因逐一列出)——这是**诚实结论**,而不是
71
- #: 用 ③ 把指标刷绿:role"覆盖≥90%"若由常量填满即失去判据意义,且 ③ 会关掉 M1 的
72
- #: `field_absent`,使 M2 的 `role_inferable` 语义判定**永不发生**——「字段有值」冒充
73
- #: 「来源已知」。终裁开启前请先读 `LAYER_DEFAULT_WARNING`。
74
- DEFAULT_SOURCES = (SOURCE_TAGS, SOURCE_MAP)
75
-
76
- #: 开启 ③ `layer_default` 前**必读**的终裁提示(`role_plan`/CLI 在 `sources` 含 ③ 时透出)。
77
- #: 它填的是**常量**而非**来源**:`role_ratio_kn` 会立刻跳到 100%(层内几乎全是 knowledge),
78
- #: 但 ① M1 的 `R-ROLE-MISSING`(`field_absent`)随之永不命中——规则失去发现能力;
79
- #: ② M2 的 `role_inferable` 语义判定(LLM 从 writer/tags/正文判 role)永无输入——
80
- #: 即以「字段有值」冒充「来源已知」。③ 若 writer 有声明而库内无法映射(当前真实库
81
- #: 全部如此),本档会把该冲突抹平成「已治理」,掩盖待裁决项。
82
- LAYER_DEFAULT_WARNING = (
83
- "开启 layer_default 是把『来源未知』填成常量 knowledge:role 覆盖率立刻达标,"
84
- "但 M1 field_absent 与 M2 role_inferable 同时失效(字段有值冒充来源已知),"
85
- "并以层默认抹平 writer→role 待裁决冲突。须 designer 终裁、显式传 "
86
- "sources=tags,map,layer_default、留痕署名后方可使用。")
87
-
88
- #: 标签前缀:`role:<值>` 为成文 role 声明
89
- ROLE_TAG_PREFIX = "role:"
90
-
91
- #: `writer` → role 的**声明映射表**(见模块 docstring ②:当前故意为空)
92
- WRITER_ROLE_MAP: dict = {}
93
-
94
- #: 层默认投影表:真源 = `mdcos.MdCGOS.add` docstring「默认 role=None(知识)」。
95
- #: 只有层名本身就在 `ALL_ROLES` 里时才投影(knowledge 是唯一的一个)。
96
- LAYER_DEFAULT_ROLE = {"knowledge": "knowledge"}
97
-
98
- BASIS_TAG = "frontmatter.tags(role:<值> 显式声明)"
99
- BASIS_LAYER = "mdcos.MdCGOS.add 默认语义(role=None ⇒ knowledge)"
100
-
101
- REASON_NO_SOURCE = "no_source_declared"
102
- REASON_TAG_OOD = "tag_role_out_of_domain"
103
- REASON_MAP_OOD = "map_role_out_of_domain"
104
- REASON_MAP_WORK = "map_role_is_work_role"
105
- REASON_WRITER_NO_MAP = "writer_no_mapping"
106
-
107
- ACTION_ROLE = "role"
108
- ACTION_ROLE_ROLLBACK = "role_rollback"
109
- BATCH_DEFAULT = "m4-role"
110
-
111
- ACTIONS = ("role", "role_rollback", "role_history", "role_stats")
112
-
113
-
114
- # ---- 通用工具 ------------------------------------------------------------
115
-
116
- # 生效条件:传入 cg 即返回 os.path.join(cg.root, GOVERN_LOG),无分支。
117
- def _log_path(cg) -> str:
118
- return os.path.join(cg.root, GOVERN_LOG)
119
-
120
-
121
- # 生效条件:fm 为假值(None/{})时按 {} 处理,其 .get("tags") 为假值(None/空串/空列表)时回落 [],否则对该值逐项过滤,只保留 isinstance(t, str) 的元素。
122
- def _tags(fm: dict) -> list:
123
- return [t for t in ((fm or {}).get("tags") or []) if isinstance(t, str)]
124
-
125
-
126
- # 生效条件:detail 为假值(None/空串)时返回 kind,否则返回 "%s:%s" % (kind, detail)。
127
- def _reason_key(kind: str, detail: str = None) -> str:
128
- return kind if not detail else "%s:%s" % (kind, detail)
129
-
130
-
131
- # 生效条件:box 缺 key 时以 box.get(key, 0) 取 0 再加 1 写回 box[key];key 已存在(含值为非数值)时直接对现值 +1。
132
- def _bump(box: dict, key: str) -> None:
133
- box[key] = box.get(key, 0) + 1
134
-
135
-
136
- # ---- 靶子定位(rule 驱动)------------------------------------------------
137
-
138
- # 生效条件:rules/rules_dir 经 _as_rules 得到的列表中存在 id == rule_id 的项、且该项 matcher.layer 非空、mechanical 中存在 check == CHECK_FIELD_ABSENT 且 field 为真的项时,返回 {'rule_id','title','field','layers','severity','remedy','llm'};该项不存在或 layers/field 为空则抛 ValueError。
139
- def role_rule(*, rules=None, rules_dir=None, rule_id: str = RULE_ROLE) -> dict:
140
- """从 M1 规则库取「role 回填」靶规则 → `{field, layers, remedy, …}`。
141
-
142
- 规则库是靶子的**唯一真源**:缺规则 / 缺 `matcher.layer` / 缺
143
- `field_absent.field` 一律抛 ValueError(fail-closed)——规则消失不是
144
- 「没有要治理的东西」,而是治理靶子失效,必须显式红灯而非静默空跑。
145
- """
146
- rl = _as_rules(rules, rules_dir)
147
- hit = next((r for r in rl if r.get("id") == rule_id), None)
148
- if hit is None:
149
- raise ValueError("规则库无 %s(可用:%s)"
150
- % (rule_id, [r.get("id") for r in rl]))
151
- layers = list((hit.get("matcher") or {}).get("layer") or [])
152
- field = None
153
- for spec in hit.get("mechanical") or []:
154
- if spec.get("check") == CHECK_FIELD_ABSENT and spec.get("field"):
155
- field = spec["field"]
156
- break
157
- if not layers or not field:
158
- raise ValueError("规则 %s 未声明 matcher.layer / %s.field——无法定位回填靶"
159
- % (rule_id, CHECK_FIELD_ABSENT))
160
- return {"rule_id": rule_id, "title": hit.get("title"), "field": field,
161
- "layers": layers, "severity": hit.get("severity"),
162
- "remedy": hit.get("remedy"), "llm": list(hit.get("llm") or [])}
163
-
164
-
165
- # ---- 取值推导(唯一入口:只搬运已声明的证据)------------------------------
166
-
167
- # 生效条件:按 sources 逐档判定——含 SOURCE_TAGS 时取 fm 的 tags 内首个 ROLE_TAG_PREFIX 前缀标签,其值属 ALL_ROLES 则返回 (值, BASIS_TAG, SOURCE_TAGS, None),值域外则返回 (None,None,None, REASON_TAG_OOD 原因);tags 未定出时含 SOURCE_MAP 则以小写 writer 取 role_map 值,属 WORK_ROLES 返回 REASON_MAP_WORK 原因、属 ALL_ROLES 返回 (值,"WRITER_ROLE_MAP[writer]",SOURCE_MAP,None)、否则返回 REASON_MAP_OOD 原因(命中域外值即返回、不降级);再否且含 SOURCE_LAYER 且 LAYER_DEFAULT_ROLE 命中 e["layer"] 时返回 (值, BASIS_LAYER, SOURCE_LAYER, None);全部未命中则 writer 非空返回 REASON_WRITER_NO_MAP:writer,writer 为空返回 REASON_NO_SOURCE。
168
- def _candidate_role(e, fm, *, sources, role_map) -> tuple:
169
- """→ `(role, basis, source, reason)`:有来源则 reason=None;无来源则 role=None。
170
-
171
- 按声明强度优先:`tags`(成文)> `map`(声明表)> `layer_default`(隐含默认显式化)。
172
- 命中**域外值**时立即返回且**不降级**:显式声明了域外值 ≠ 无声明——继续回退到更弱的
173
- 来源会把一个待 designer 裁决的冲突悄悄抹平。
174
- """
175
- if SOURCE_TAGS in sources:
176
- for t in _tags(fm):
177
- if t.startswith(ROLE_TAG_PREFIX):
178
- v = t[len(ROLE_TAG_PREFIX):].strip().lower()
179
- if v in ALL_ROLES:
180
- return v, BASIS_TAG, SOURCE_TAGS, None
181
- return None, None, None, _reason_key(REASON_TAG_OOD, v or "空")
182
- if SOURCE_MAP in sources:
183
- w = str(fm.get("writer") or "").strip().lower()
184
- v = str((role_map or {}).get(w) or "").strip().lower() if w else ""
185
- if v:
186
- if v in WORK_ROLES:
187
- # 映射表是**我们的推断**:把 knowledge 层节点推成工作角色会让它在默认
188
- # 召回中被剔除(`_candidates` 默认排除 WORK_ROLES)——故意不做,红灯。
189
- return None, None, None, _reason_key(REASON_MAP_WORK, v)
190
- if v in ALL_ROLES:
191
- return v, "WRITER_ROLE_MAP[%s]" % w, SOURCE_MAP, None
192
- return None, None, None, _reason_key(REASON_MAP_OOD, v)
193
- if SOURCE_LAYER in sources:
194
- v = LAYER_DEFAULT_ROLE.get(str(e.get("layer") or ""))
195
- if v:
196
- return v, BASIS_LAYER, SOURCE_LAYER, None
197
- w = str(fm.get("writer") or "").strip()
198
- return None, None, None, (_reason_key(REASON_WRITER_NO_MAP, w) if w
199
- else REASON_NO_SOURCE)
200
-
201
-
202
- # 生效条件:按序判定——_readable_guard(cg, e) 为假返回 ("denied", None);direct_read(cg, e) 的 fm 为 None 返回 ("unreadable", None);crypto.is_encrypted(content) 为真返回 ("locked", None);fm.get("role") 非空白返回 ("present", None);否则 _candidate_role(e, fm, sources=sources, role_map=role_map) 的 role 为假返回 ("unfillable", {id,layer,reason,writer}),role 为真返回 ("", {id,layer,role,source,basis,before,had_key,writer})。
203
- def _classify(cg, e, nid, *, sources, role_map) -> tuple:
204
- """单条裁决 → `(skip_reason, item|gap)`;skip_reason 为空串表示可回填。"""
205
- if not _readable_guard(cg, e):
206
- return "denied", None
207
- fm, content = direct_read(cg, e)
208
- if fm is None:
209
- return "unreadable", None
210
- if crypto.is_encrypted(content):
211
- return "locked", None
212
- if not _blank(fm.get("role")):
213
- return "present", None
214
- role, basis, src, reason = _candidate_role(e, fm, sources=sources,
215
- role_map=role_map)
216
- if not role:
217
- return "unfillable", {"id": nid, "layer": e.get("layer"),
218
- "reason": reason, "writer": fm.get("writer")}
219
- return "", {"id": nid, "layer": e.get("layer"), "role": role, "source": src,
220
- "basis": basis, "before": fm.get("role"),
221
- "had_key": "role" in fm, "writer": fm.get("writer")}
222
-
223
-
224
- # 生效条件:want 由必填 layers 决定;layer 为真值时须属 layers 否则抛 ValueError,且命中后 want 收窄为 {layer};ids 为真值时只保留白名单内 nid、为假值(None/[])时不过滤;prefix 为真值时只保留 nid 以之开头者;仅 str(e.get("layer")) 属 want 的条目按 nid 升序进入返回列表。
225
- def _iter_scope(cg, *, layers, layer=None, prefix=None, ids=None) -> list:
226
- """按规则作用域遍历索引条目 → `[(nid, entry)]`(只读、nid 稳定序)。
227
-
228
- `layer` 收窄只能收窄到规则已声明的层内——跨层即抛错(同 `ruleset` 的
229
- 「执行时按同一条件过滤,绝不跨层套用」)。
230
- """
231
- want = set(layers)
232
- if layer:
233
- if layer not in want:
234
- raise ValueError("layer=%s 不在靶规则作用域 %s 内(绝不跨层套用)"
235
- % (layer, sorted(want)))
236
- want = {layer}
237
- idw = set(ids) if ids else None
238
- out = []
239
- for nid in sorted((cg.index.get("nodes") or {})):
240
- if idw is not None and nid not in idw:
241
- continue
242
- if prefix and not nid.startswith(prefix):
243
- continue
244
- e = cg.index["nodes"][nid]
245
- if str(e.get("layer")) not in want:
246
- continue
247
- out.append((nid, e))
248
- return out
249
-
250
-
251
- # ---- 预演 -----------------------------------------------------------------
252
-
253
- # 生效条件:以 x 经 _as_cg 得 cg 并先经 role_rule(rules,rules_dir,rule_id) 取规则(缺规则/缺 layer/缺 field 时该步抛 ValueError),role_map 非空时的条目以小写去空白键合并进 WRITER_ROLE_MAP 副本,再遍历 _iter_scope(cg, layers=rule["layers"], layer=layer, prefix=prefix, ids=ids) 逐条 _classify 后返回不写盘的 rep;每条 item 仅在 limit is None 或 len(rep["items"]) < limit 时追加(limit=0 时 items 为空但 targeted 仍累加),sample 为真且 planned_ids 非空时以 max(1, len(planned_ids)//int(sample)) 为步长取前 int(sample) 项。
254
- def role_plan(x, layer=None, limit=None, ids=None, prefix=None, *,
255
- sources=DEFAULT_SOURCES, role_map=None, rule_id=RULE_ROLE,
256
- rules=None, rules_dir=None, sample=0) -> dict:
257
- """预演:产出可回填清单 + 不可回填原因分布,**不写盘**。
258
-
259
- `sources` 见模块 docstring 的三档来源;`role_map` 覆盖 `WRITER_ROLE_MAP`
260
- (designer 终裁补声明表的入口,不改库)。
261
- """
262
- cg = _as_cg(x)
263
- rule = role_rule(rules=rules, rules_dir=rules_dir, rule_id=rule_id)
264
- rm = dict(WRITER_ROLE_MAP)
265
- rm.update({str(k).strip().lower(): v for k, v in (role_map or {}).items()})
266
- rep = {"root": cg.root, "dry_run": True, "action": ACTION_ROLE,
267
- "rule": rule, "sources": list(sources), "role_map": rm,
268
- "layer": layer, "prefix": prefix,
269
- "nodes_scanned": 0, "skipped_out_of_scope": 0,
270
- "skipped_locked": 0, "skipped_denied": 0, "skipped_unreadable": 0,
271
- "skipped_present": 0, "unfillable": 0, "unfillable_by_reason": {},
272
- "targeted": 0, "by_source": {}, "items": []}
273
- scope_layers = set(rule["layers"])
274
- idw = set(ids) if ids else None
275
- for nid in sorted((cg.index.get("nodes") or {})):
276
- if idw is not None and nid not in idw:
277
- continue
278
- if prefix and not str(nid).startswith(prefix):
279
- continue
280
- e = cg.index["nodes"][nid]
281
- if str(e.get("layer")) not in scope_layers:
282
- rep["skipped_out_of_scope"] += 1
283
- for nid, e in _iter_scope(cg, layers=rule["layers"], layer=layer,
284
- prefix=prefix, ids=ids):
285
- rep["nodes_scanned"] += 1
286
- skip, item = _classify(cg, e, nid, sources=sources, role_map=rm)
287
- if skip == "unfillable":
288
- rep["unfillable"] += 1
289
- # 原因键带明细(如 writer_no_mapping:dsh-memory)——聚合即得逐来源分布
290
- _bump(rep["unfillable_by_reason"], str(item["reason"]))
291
- continue
292
- if skip:
293
- rep["skipped_%s" % skip] = rep.get("skipped_%s" % skip, 0) + 1
294
- continue
295
- item["entry_id"] = _entry_id(ACTION_ROLE, nid)
296
- item["ref"] = e.get("ref")
297
- rep["targeted"] += 1
298
- _bump(rep["by_source"], item["source"])
299
- if limit is None or len(rep["items"]) < limit:
300
- rep["items"].append(item)
301
- rep["planned_ids"] = [i["id"] for i in rep["items"]]
302
- if sample and rep["planned_ids"]:
303
- step = max(1, len(rep["planned_ids"]) // int(sample))
304
- rep["sample"] = rep["planned_ids"][::step][:int(sample)]
305
- rep["rule_layers"] = sorted(scope_layers)
306
- return rep
307
-
308
-
309
- # ---- 执行 / 回滚 / 留痕 / 对照 -------------------------------------------
310
-
311
- # 生效条件:x 经 _as_cg,batch 为假值时回落 BATCH_DEFAULT;先调 role_plan 取 items,entry_ids 为真值时按 entry_id 收窄;逐项处理:索引无该节点或 _read 得 fm 为 None → skipped_missing,_readable_guard 为假 → skipped_denied,crypto.is_encrypted(content) 为真 → skipped_locked,fm["role"] 非空 → skipped_drift,否则写回 role 并 append_jsonl 留痕、written 递增;written 非零时 cg.rebuild_index(),返回含 plan_remaining 的 rep。
312
- def role_apply(x, ids=None, entry_ids=None, layer=None, limit=None,
313
- batch=BATCH_DEFAULT, sources=DEFAULT_SOURCES, role_map=None,
314
- rule_id=RULE_ROLE, rules=None, rules_dir=None, actor=None,
315
- prefix=None) -> dict:
316
- """执行回填:逐节点改写 md 的 role 字段,写 `_govern.jsonl` 留痕。
317
-
318
- 写前**重查**一次(预演 → 执行之间节点可能被改动):已有 role 值 → `skipped_drift`
319
- 一律不动;密文 / 不可读 → `skipped_locked` / `skipped_missing`,**绝不解密回写**。
320
- `ids` / `prefix` / `entry_ids` 三重收窄,`entry_ids` 优先(工单式精确执行)。
321
- """
322
- cg = _as_cg(x)
323
- batch = batch or BATCH_DEFAULT
324
- p = role_plan(cg, layer=layer, limit=limit, ids=ids, prefix=prefix,
325
- sources=sources, role_map=role_map, rule_id=rule_id,
326
- rules=rules, rules_dir=rules_dir)
327
- items = p["items"]
328
- if entry_ids:
329
- want = set(entry_ids)
330
- items = [i for i in items if i["entry_id"] in want]
331
- rep = {"root": cg.root, "dry_run": False, "action": ACTION_ROLE,
332
- "batch": batch, "actor": actor, "rule_id": rule_id,
333
- "field": p["rule"]["field"], "sources": list(sources),
334
- "planned": len(items), "written": 0, "by_source": {},
335
- "skipped_drift": 0, "skipped_locked": 0, "skipped_missing": 0,
336
- "skipped_denied": 0, "entry_ids": [],
337
- "unfillable": p["unfillable"],
338
- "unfillable_by_reason": p["unfillable_by_reason"]}
339
- for it in items:
340
- nid = it["id"]
341
- e = (cg.index.get("nodes") or {}).get(nid)
342
- if e is None:
343
- rep["skipped_missing"] += 1
344
- continue
345
- if not _readable_guard(cg, e):
346
- rep["skipped_denied"] += 1
347
- continue
348
- fm, content = direct_read(cg, e)
349
- if fm is None:
350
- rep["skipped_missing"] += 1
351
- continue
352
- if crypto.is_encrypted(content):
353
- rep["skipped_locked"] += 1
354
- continue
355
- if not _blank(fm.get("role")):
356
- rep["skipped_drift"] += 1
357
- continue
358
- fm_before = {"role": fm.get("role"), "had_key": "role" in fm}
359
- fm["role"] = it["role"]
360
- ts = time.time()
361
- cg._write_node(nid, os.path.join(cg.root, e["path"]), fm, content,
362
- durable=True)
363
- wid = _sha("%s|%s|%.6f" % (nid, batch, ts))
364
- append_jsonl(_log_path(cg), {
365
- "action": ACTION_ROLE, "ts": ts, "batch": batch, "actor": actor,
366
- "entry_id": it["entry_id"], "write_id": wid, "node": nid,
367
- "layer": e.get("layer"), "rule_id": rule_id, "field": "role",
368
- "value": it["role"], "source": it["source"], "basis": it["basis"],
369
- "writer": it.get("writer"), "fm_before": fm_before,
370
- "content_hash_after": _sha(content)})
371
- rep["written"] += 1
372
- _bump(rep["by_source"], it["source"])
373
- rep["entry_ids"].append(it["entry_id"])
374
- if rep["written"]:
375
- cg.rebuild_index()
376
- rep["plan_remaining"] = max(0, p["targeted"] - len(items))
377
- return rep
378
-
379
-
380
- # 生效条件:只处理 action == ACTION_ROLE 的留痕,且 batch 为真时要求 rec.get("batch") == batch(batch 为 None/假值时不按批次过滤)、entry_ids 为真时要求 rec.get("entry_id") ∈ set(entry_ids);rec 的 write_id 已在既有 ACTION_ROLE_ROLLBACK 记录中 → skipped_done,节点不在索引或 read 不到或加密 → missing,当前 fm.get("role") 为空白或与 rec.get("value") 不等 → conflict 不覆盖,相等时按 fm_before.get("had_key") 恢复 fm_before["role"] 或删除 role 键;reverted 非 0 时 cg.rebuild_index()。
381
- def role_rollback(x, batch=None, entry_ids=None, actor=None) -> dict:
382
- """按留痕反向应用:撤销 role 回填。
383
-
384
- **只在当前值仍等于当初写入值时**撤销;否则计 `conflict` 不覆盖(此后可能已有
385
- 人工修正 / 后续批次写入)。原本无该键 → 删键还原(不是写空串)。
386
- """
387
- cg = _as_cg(x)
388
- want = set(entry_ids) if entry_ids else None
389
- rep = {"root": cg.root, "action": ACTION_ROLE_ROLLBACK, "actor": actor,
390
- "batch": batch, "reverted": 0, "conflict": 0, "missing": 0,
391
- "skipped_done": 0, "entry_ids": []}
392
- log = list(read_jsonl(_log_path(cg)) or [])
393
- done = {r.get("write_id") for r in log
394
- if r.get("action") == ACTION_ROLE_ROLLBACK and r.get("write_id")}
395
- for rec in log:
396
- if rec.get("action") != ACTION_ROLE:
397
- continue
398
- if batch and rec.get("batch") != batch:
399
- continue
400
- if want is not None and rec.get("entry_id") not in want:
401
- continue
402
- wid = rec.get("write_id")
403
- if wid and wid in done:
404
- rep["skipped_done"] += 1
405
- continue
406
- nid = rec.get("node")
407
- e = (cg.index.get("nodes") or {}).get(nid)
408
- if e is None:
409
- rep["missing"] += 1
410
- continue
411
- fm, content = direct_read(cg, e)
412
- if fm is None or crypto.is_encrypted(content):
413
- rep["missing"] += 1
414
- continue
415
- if _blank(fm.get("role")) or str(fm.get("role")) != str(rec.get("value")):
416
- rep["conflict"] += 1
417
- continue
418
- before = rec.get("fm_before") or {}
419
- if before.get("had_key"):
420
- fm["role"] = before.get("role")
421
- else:
422
- fm.pop("role", None)
423
- cg._write_node(nid, os.path.join(cg.root, e["path"]), fm, content,
424
- durable=True)
425
- append_jsonl(_log_path(cg), {
426
- "action": ACTION_ROLE_ROLLBACK, "ts": time.time(), "actor": actor,
427
- "batch": rec.get("batch"), "entry_id": rec.get("entry_id"),
428
- "write_id": wid, "node": nid, "field": "role",
429
- "restored": before.get("role"),
430
- "had_key": bool(before.get("had_key")), "reason": "rollback"})
431
- rep["reverted"] += 1
432
- rep["entry_ids"].append(rec.get("entry_id"))
433
- if rep["reverted"]:
434
- cg.rebuild_index()
435
- return rep
436
-
437
-
438
- # 生效条件:action 为真时只保留 r.get("action") == action 的记录、batch 为真时只保留 r.get("batch") == batch 的记录,total/by_action 统计的是过滤后的 recs 全量;records 在 limit 为假值(0/None)时返回全部 recs,否则返回 recs[-int(limit):]。
439
- def history(x, limit=100, action=None, batch=None) -> dict:
440
- """读 `_govern.jsonl` 留痕(治理动作的可审计面)。"""
441
- cg = _as_cg(x)
442
- recs = [r for r in (read_jsonl(_log_path(cg)) or [])
443
- if (not action or r.get("action") == action)
444
- and (not batch or r.get("batch") == batch)]
445
- tail = recs[-int(limit):] if limit else recs
446
- by_action = {}
447
- for r in recs:
448
- _bump(by_action, str(r.get("action")))
449
- return {"root": cg.root, "action": "role_history", "total": len(recs),
450
- "by_action": by_action, "records": tail}
451
-
452
-
453
- # 生效条件:x 经 _as_cg 且 role_rule(rules=rules, rules_dir=rules_dir, rule_id=rule_id) 命中并声明了 matcher.layer 与 field_absent.field 时,返回以 conformance.load_index(cg.root) 的节点为口径的统计(by_layer 计全部节点、by_value 只计 role 非空白者、target_met 由 role_ratio_kn >= float(THRESHOLDS["role_coverage_min"]) 决定、gap_to_target 取 max(0.0, thr-kn));规则缺失或声明不全时在 role_rule 处抛 ValueError。
454
- def role_stats(x, *, rule_id=RULE_ROLE, rules=None, rules_dir=None) -> dict:
455
- """只读对照:role 覆盖率 + 取值分布(治理前后量化用)。
456
-
457
- 判据**不复刻**——直接复用 `conformance`(真源:`_coverage_metrics` 的
458
- knowledge 层口径 `role_ratio_kn` 与 `THRESHOLDS["role_coverage_min"]`),
459
- 本函数只补「逐层 / 逐值」分布,供 M4 复跑报告引用。
460
- """
461
- from .. import conformance as CONF # 延迟导入:读侧判据真源,按需加载
462
- cg = _as_cg(x)
463
- rule = role_rule(rules=rules, rules_dir=rules_dir, rule_id=rule_id)
464
- nodes = CONF.load_index(cg.root)
465
- cov = CONF._coverage_metrics(nodes)
466
- thr = float(CONF.THRESHOLDS["role_coverage_min"])
467
- by_layer, by_value = {}, {}
468
- for e in nodes.values():
469
- _bump(by_layer, str(e.get("layer")))
470
- if not _blank(e.get("role")):
471
- _bump(by_value, str(e.get("role")))
472
- kn = float(cov.get("role_ratio_kn") or 0.0)
473
- return {"root": cg.root, "action": "role_stats", "rule_id": rule_id,
474
- "layers": rule["layers"], "nodes": cov.get("nodes"),
475
- "knowledge": cov.get("knowledge"), "role_ratio": cov.get("role_ratio"),
476
- "role_ratio_kn": cov.get("role_ratio_kn"), "threshold": thr,
477
- "target_met": kn >= thr, "gap_to_target": max(0.0, thr - kn),
478
- "by_layer": by_layer, "by_value": by_value}
479
-
480
-
481
- # ---- 统一入口 ------------------------------------------------------------
482
-
483
- # 生效条件:action 不在 ACTIONS 内时抛 ValueError;action == ACTION_ROLE 时以 kw.pop("apply", False) 为真调用 role_apply(x, **kw)、为假(含缺该键)调用 role_plan(x, **kw);其余情况以 {ACTION_ROLE_ROLLBACK: role_rollback, "role_history": history, "role_stats": role_stats}[action] 取 fn 并返回 fn(x, **kw)。
484
- def run(x, action, **kw) -> dict:
485
- """`role`(`apply=True` 则执行)/ `role_rollback` / `role_history` / `role_stats`。"""
486
- if action not in ACTIONS:
487
- raise ValueError("未知 action=%s(可用:%s)" % (action, list(ACTIONS)))
488
- if action == ACTION_ROLE:
489
- if kw.pop("apply", False):
490
- return role_apply(x, **kw)
491
- return role_plan(x, **kw)
492
- fn = {ACTION_ROLE_ROLLBACK: role_rollback, "role_history": history,
493
- "role_stats": role_stats}[action]
494
- return fn(x, **kw)
495
-
496
-
497
- # ---- 命令行 --------------------------------------------------------------
498
- #
499
- # 形态约定:`--root` / `--rules-dir` / `--json` 均为**子命令参数**(`parents=[common]`),
500
- # 须写在子命令**之后**:`govern plan --root <root>`。写在子命令之前会被顶层解析器
501
- # 当作位置参数吃掉(`scripts/review_cli.py` 的同型坑,2026-09-15 实测更正)。
502
-
503
- # 生效条件:s 为假值(None/空串)时直接返回 DEFAULT_SOURCES;否则按 "," 切分并 strip 丢弃空段,任一段不在 ALL_SOURCES 内即抛 ValueError,切分后 vals 为空(如 s=",")也抛 ValueError,其余返回该非空元组。
504
- def _parse_sources(s) -> tuple:
505
- """CLI 侧来源档解析:逗号分隔,值域封闭(非法即抛,不静默降级)。"""
506
- if not s:
507
- return DEFAULT_SOURCES
508
- vals = tuple(v.strip() for v in str(s).split(",") if v.strip())
509
- bad = [v for v in vals if v not in ALL_SOURCES]
510
- if bad:
511
- raise ValueError("未知来源档 %s(可用:%s)" % (bad, list(ALL_SOURCES)))
512
- if not vals:
513
- raise ValueError("sources 为空(缺省即 %s)" % ",".join(DEFAULT_SOURCES))
514
- return vals
515
-
516
-
517
- # 生效条件:无参数,调用即返回 argparse.ArgumentParser(add_help=False),其中已含 --root(default=None)、--rules-dir(default=None)、--json(store_true) 三项,无分支。
518
- def _common_parser() -> argparse.ArgumentParser:
519
- ap = argparse.ArgumentParser(add_help=False)
520
- ap.add_argument("--root", default=None, help="真源根(缺省读环境变量 MDCG_ROOT)")
521
- ap.add_argument("--rules-dir", default=None, help="规则库目录(缺省 mreview/rules)")
522
- ap.add_argument("--json", action="store_true", help="输出 JSON(缺省人读摘要)")
523
- return ap
524
-
525
-
526
- # 生效条件:传入 p 即向它注册 --layer/--prefix/--ids/--limit(type=int)/--sources 五个参数,无分支且无返回值。
527
- def _add_scope_args(p) -> None:
528
- p.add_argument("--layer", help="收窄到该层(须在规则 matcher 层之内)")
529
- p.add_argument("--prefix", help="只处理该 id 前缀")
530
- p.add_argument("--ids", help="逗号分隔的节点 id 白名单")
531
- p.add_argument("--limit", type=int, help="本次最多处理条数")
532
- p.add_argument("--sources",
533
- help="来源档逗号分隔:tags,map[,layer_default](缺省 %s)"
534
- % ",".join(DEFAULT_SOURCES))
535
-
536
-
537
- # 生效条件:传入 a 后返回 {'layer': a.layer, 'prefix': a.prefix, 'limit': a.limit, 'ids': [...], 'sources': _parse_sources(a.sources), 'rules_dir': a.rules_dir},其中 ids 由 a.ids(为假值即 None/空串)按 "," 切分去空段、结果为空则回落 None,sources 由 a.sources 经 _parse_sources 解析(假值 → DEFAULT_SOURCES,非法值抛 ValueError)。
538
- def _scope_kw(a) -> dict:
539
- return {"layer": a.layer, "prefix": a.prefix, "limit": a.limit,
540
- "ids": [i.strip() for i in (a.ids or "").split(",") if i.strip()] or None,
541
- "sources": _parse_sources(a.sources), "rules_dir": a.rules_dir}
542
-
543
-
544
- # 生效条件:SOURCE_LAYER 在 sources 内时向 sys.stderr 打印 "警告:" + LAYER_DEFAULT_WARNING,否则不输出。
545
- def _warn_layer_default(sources) -> None:
546
- if SOURCE_LAYER in sources:
547
- print("警告:" + LAYER_DEFAULT_WARNING, file=sys.stderr)
548
-
549
-
550
- # 生效条件:传入 msg 即向 sys.stderr 打印该 msg 并返回 2,无分支。
551
- def _die(msg: str) -> int:
552
- print(msg, file=sys.stderr)
553
- return 2
554
-
555
-
556
- def main(argv=None) -> int:
557
- ap = argparse.ArgumentParser(
558
- prog="python -m md_cg.mreview.govern",
559
- description="记忆评审 M4 · 落库治理(确定性部分:rule 驱动 · 永不删除)")
560
- sub = ap.add_subparsers(dest="cmd")
561
- common = _common_parser()
562
-
563
- p = sub.add_parser("plan", parents=[common], help="预演(只出报表,不写盘)")
564
- _add_scope_args(p)
565
- p.add_argument("--sample", type=int, default=0, help="抽样条数(人工核对样板)")
566
-
567
- p = sub.add_parser("apply", parents=[common], help="执行回填(写盘 + 留痕 + 可回滚)")
568
- _add_scope_args(p)
569
- p.add_argument("--batch", default=BATCH_DEFAULT, help="批次名(留痕 / 回滚锚点)")
570
- p.add_argument("--actor", default=None, help="执行者署名(留痕)")
571
- p.add_argument("--entry-id", action="append", default=[],
572
- help="只执行该条目(可多次;工单式精确执行)")
573
- p.add_argument("--yes", action="store_true", help="显式确认写盘(缺省拒绝)")
574
-
575
- p = sub.add_parser("rollback", parents=[common], help="按留痕回滚")
576
- p.add_argument("--batch", default=None, help="只回滚该批次")
577
- p.add_argument("--entry-id", action="append", default=[], help="只回滚该条目(可多次)")
578
- p.add_argument("--actor", default=None, help="执行者署名(留痕)")
579
-
580
- p = sub.add_parser("history", parents=[common], help="读 `_govern.jsonl` 留痕")
581
- p.add_argument("--limit", type=int, default=100)
582
- p.add_argument("--batch", default=None)
583
- p.add_argument("--action", default=None)
584
-
585
- sub.add_parser("stats", parents=[common],
586
- help="覆盖率对照(复用 conformance 判据)")
587
-
588
- a = ap.parse_args(argv)
589
- if not a.cmd:
590
- # `--root` 是**子命令**参数(`parents=[common]`):无子命令时顶层 Namespace
591
- # 根本没有该属性——须先判 cmd 再取 root,否则 `govern` 裸跑即 AttributeError。
592
- ap.print_help()
593
- return 2
594
- root = a.root or os.environ.get("MDCG_ROOT")
595
- if not root:
596
- return _die("需要 --root 或环境变量 MDCG_ROOT(fail-closed)")
597
-
598
- if a.cmd == "plan":
599
- try:
600
- kw = _scope_kw(a)
601
- except ValueError as ex:
602
- return _die(str(ex))
603
- _warn_layer_default(kw["sources"])
604
- try:
605
- rep = role_plan(root, sample=a.sample, **kw)
606
- except ValueError as ex:
607
- return _die("预演失败:%s" % ex)
608
- if a.json:
609
- print(json.dumps(rep, ensure_ascii=False, indent=2))
610
- return 0
611
- print("[M4 预演·只读] root=%s" % rep["root"])
612
- print(" 靶规则 %s|层 %s|字段 %s|来源档 %s"
613
- % (rep["rule"]["rule_id"], ",".join(rep["rule_layers"]),
614
- rep["rule"]["field"], ",".join(rep["sources"])))
615
- print(" 扫描 %d|可回填 %d|不可回填 %d|域外 %d|已锁 %d|已有值 %d|无权限 %d"
616
- % (rep["nodes_scanned"], rep["targeted"], rep["unfillable"],
617
- rep["skipped_out_of_scope"], rep["skipped_locked"],
618
- rep["skipped_present"], rep["skipped_denied"]))
619
- for k, v in sorted(rep["by_source"].items()):
620
- print(" 来源 %-16s %d" % (k, v))
621
- for k, v in sorted(rep["unfillable_by_reason"].items(), key=lambda kv: -kv[1]):
622
- print(" 挡下 %-32s %d" % (k, v))
623
- if rep.get("sample"):
624
- print(" 抽样:%s" % ", ".join(rep["sample"]))
625
- return 0
626
-
627
- if a.cmd == "apply":
628
- if not a.yes:
629
- return _die("apply 会写盘:先跑 plan 核对清单,再以 --yes 显式确认(fail-closed)")
630
- try:
631
- kw = _scope_kw(a)
632
- except ValueError as ex:
633
- return _die(str(ex))
634
- _warn_layer_default(kw["sources"])
635
- try:
636
- rep = role_apply(root, batch=a.batch, actor=a.actor,
637
- entry_ids=list(a.entry_id) or None, **kw)
638
- except ValueError as ex:
639
- return _die("执行失败:%s" % ex)
640
- if a.json:
641
- print(json.dumps(rep, ensure_ascii=False, indent=2))
642
- return 0
643
- print("[M4 执行] batch=%s actor=%s" % (rep["batch"], rep["actor"]))
644
- print(" 写入 %d|漂移跳过 %d|密文跳过 %d|缺失 %d|无权限 %d|余量 %d"
645
- % (rep["written"], rep["skipped_drift"], rep["skipped_locked"],
646
- rep["skipped_missing"], rep["skipped_denied"], rep["plan_remaining"]))
647
- for k, v in sorted(rep["by_source"].items()):
648
- print(" 来源 %-16s %d" % (k, v))
649
- return 0
650
-
651
- if a.cmd == "rollback":
652
- if not a.batch and not a.entry_id:
653
- return _die("rollback 需要 --batch 或 --entry-id(防全量误回滚)")
654
- rep = role_rollback(root, batch=a.batch, actor=a.actor,
655
- entry_ids=list(a.entry_id) or None)
656
- if a.json:
657
- print(json.dumps(rep, ensure_ascii=False, indent=2))
658
- return 0
659
- print("[M4 回滚] batch=%s|还原 %d|冲突跳过 %d|缺失 %d|已回滚 %d"
660
- % (rep["batch"], rep["reverted"], rep["conflict"], rep["missing"],
661
- rep["skipped_done"]))
662
- return 0
663
-
664
- if a.cmd == "history":
665
- rep = history(root, limit=a.limit, action=a.action, batch=a.batch)
666
- if a.json:
667
- print(json.dumps(rep, ensure_ascii=False, indent=2))
668
- return 0
669
- print("[M4 留痕] 命中 %d 条|分布 %s" % (rep["total"], rep["by_action"]))
670
- for r in rep["records"]:
671
- print(" %-14s %-10s %-22s %s=%s"
672
- % (time.strftime("%m-%d %H:%M:%S", time.localtime(r.get("ts") or 0)),
673
- r.get("action"), str(r.get("node")), r.get("field"),
674
- r.get("value", r.get("restored"))))
675
- return 0
676
-
677
- try:
678
- rep = role_stats(root)
679
- except ValueError as ex:
680
- return _die("对照失败:%s" % ex)
681
- if a.json:
682
- print(json.dumps(rep, ensure_ascii=False, indent=2))
683
- return 0
684
- print("[M4 对照] root=%s 判据源=conformance" % rep["root"])
685
- print(" 节点 %s|knowledge %s|role 覆盖 %s|knowledge 层覆盖 %s(阈值 %.2f,%s)"
686
- % (rep["nodes"], rep["knowledge"], rep["role_ratio"],
687
- rep["role_ratio_kn"], rep["threshold"],
688
- "达标" if rep["target_met"] else "未达标,缺口 %.4f" % rep["gap_to_target"]))
689
- print(" 逐层 %s" % rep["by_layer"])
690
- print(" 逐值 %s" % rep["by_value"])
691
- return 0
692
-
693
-
694
- if __name__ == "__main__":
1
+ # -*- coding: utf-8 -*-
2
+ """记忆评审流水线 · 级 4:M4 落库治理(确定性部分 · rule 驱动 · 永不删除)。
3
+
4
+ 真源:`docs/记忆评审系统_立项设计与施工交接_20260915.md` §3 第 4 级 + §6 验收 + §7 负面清单。
5
+ 本模块只做**机械可裁决**的治理动作(回填等);LLM 语义类(合并 / 降权)不在其列——
6
+ 那属 M2 建议 + designer 终裁,本轮不落地。
7
+
8
+ **规则驱动,引擎不写死**:回填哪个字段、作用于哪些层,不写在本文件里,从 M1 规则库
9
+ (`rules/*.json`,数据真源)读——`R-ROLE-MISSING` 的 `matcher.layer` 定作用域、
10
+ `mechanical[check=field_absent].field` 定字段。改靶子 = 改数据,引擎冻结。
11
+
12
+ **来源链(只搬运已声明证据)**:
13
+
14
+ ① `tags` `role:<值>` 标签——显式成文声明;
15
+ ② `map` `frontmatter.writer` → role 的**声明映射表**(`WRITER_ROLE_MAP`)。
16
+ 当前**故意为空**:库内无任何成文映射能把 writer(`MDCG_ACTOR`:
17
+ dsh-memory / codebuddy / zcode / designer-cli…)落到
18
+ `mdcos.ALL_ROLES`;`scripts/review_cli.py` 的
19
+ `Principal(role="designer")` 属**权限角色**(`tokens.ROLE_SPECS`),
20
+ 与节点 role 是两套词汇,混填即污染域。故留空 + 通道保留,待终裁补表;
21
+ ③ `layer_default` 层默认投影——真源 = `mdcos.MdCGOS.add` 成文语义「默认 role=None
22
+ (知识)」,即缺省来源 = knowledge。该档是「隐含默认的显式化」,
23
+ 断言强度高于 ①②,故单独分档上报(`by_source`);只认显式成文声明时
24
+ 用 `sources=("tags","map")` 关掉它。
25
+
26
+ **域封闭**:写入值必须 ∈ `mdcos.ALL_ROLES`;域外值一律不写,记 `*_out_of_domain` 且
27
+ **停止降级**(显式声明了域外值 ≠ 无声明,回退到默认档会把待裁决冲突悄悄抹平)。
28
+ `tool-output/command/edit` 属工作角色(`WORK_ROLES`,默认不参与正排,见
29
+ `mdcos._candidates`)。故 ② `map` 档**显式拒绝**工作角色(命中即
30
+ `map_role_is_work_role`,不降级)——映射表是本引擎的推断,把知识节点推成工作角色
31
+ 等于亲手把它从默认召回里摘掉;① `tags` 档是**写入者成文声明**,予以尊重(治理层
32
+ 不替作者改主意)。
33
+
34
+ **五纪律**(对齐 `backfill`):不猜测(无来源 → `unfillable` + 原因分布,绝不编造)/
35
+ 可预演(`role_plan` 只出报表,`role_apply` 写前重查,已有值计 `skipped_drift`)/
36
+ 可留痕(`_govern.jsonl`:前后值 / 依据 / 来源档 / 批次 / 操作者 / 规则 id)/
37
+ 可回滚(只在当前值 == 写入值时撤销,否则 `conflict`;原本无键 → 删键还原)/
38
+ fail-closed(密文与不可读节点跳过,绝不解密回写;靶规则缺失抛错)。
39
+ §7 负面清单:只写 frontmatter 一个字段,不动正文、永不删除。
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import argparse
44
+ import json
45
+ import os
46
+ import sys
47
+ import time
48
+
49
+ from .. import crypto
50
+ from ..backfill import _as_cg, _entry_id, _readable_guard, _sha
51
+ from ..fsutil import append_jsonl, read_jsonl
52
+ from ..mdcos import ALL_ROLES, WORK_ROLES
53
+ from .ruleset import _as_rules, _blank
54
+ from ..readcache import direct_read
55
+
56
+ #: 留痕文件名(与 `backfill._backfill.jsonl` 分立:治理动作须能独立审计)
57
+ GOVERN_LOG = "_govern.jsonl"
58
+
59
+ #: 默认靶规则;`field_absent` 检查名(与 `ruleset.MECH_CHECKS` 同名)
60
+ RULE_ROLE = "R-ROLE-MISSING"
61
+ CHECK_FIELD_ABSENT = "field_absent"
62
+
63
+ #: 来源档
64
+ SOURCE_TAGS = "tags"
65
+ SOURCE_MAP = "map"
66
+ SOURCE_LAYER = "layer_default"
67
+ ALL_SOURCES = (SOURCE_TAGS, SOURCE_MAP, SOURCE_LAYER)
68
+ #: 默认只开「成文声明」两档;③ `layer_default` **必须显式开启**。
69
+ #: 依据(2026-09-16 真实库实测):writer/tags 面无任何成文声明,故默认档在真实库上
70
+ #: 产出 `targeted=0 / unfillable=11120`(原因逐一列出)——这是**诚实结论**,而不是
71
+ #: 用 ③ 把指标刷绿:role"覆盖≥90%"若由常量填满即失去判据意义,且 ③ 会关掉 M1 的
72
+ #: `field_absent`,使 M2 的 `role_inferable` 语义判定**永不发生**——「字段有值」冒充
73
+ #: 「来源已知」。终裁开启前请先读 `LAYER_DEFAULT_WARNING`。
74
+ DEFAULT_SOURCES = (SOURCE_TAGS, SOURCE_MAP)
75
+
76
+ #: 开启 ③ `layer_default` 前**必读**的终裁提示(`role_plan`/CLI 在 `sources` 含 ③ 时透出)。
77
+ #: 它填的是**常量**而非**来源**:`role_ratio_kn` 会立刻跳到 100%(层内几乎全是 knowledge),
78
+ #: 但 ① M1 的 `R-ROLE-MISSING`(`field_absent`)随之永不命中——规则失去发现能力;
79
+ #: ② M2 的 `role_inferable` 语义判定(LLM 从 writer/tags/正文判 role)永无输入——
80
+ #: 即以「字段有值」冒充「来源已知」。③ 若 writer 有声明而库内无法映射(当前真实库
81
+ #: 全部如此),本档会把该冲突抹平成「已治理」,掩盖待裁决项。
82
+ LAYER_DEFAULT_WARNING = (
83
+ "开启 layer_default 是把『来源未知』填成常量 knowledge:role 覆盖率立刻达标,"
84
+ "但 M1 field_absent 与 M2 role_inferable 同时失效(字段有值冒充来源已知),"
85
+ "并以层默认抹平 writer→role 待裁决冲突。须 designer 终裁、显式传 "
86
+ "sources=tags,map,layer_default、留痕署名后方可使用。")
87
+
88
+ #: 标签前缀:`role:<值>` 为成文 role 声明
89
+ ROLE_TAG_PREFIX = "role:"
90
+
91
+ #: `writer` → role 的**声明映射表**(见模块 docstring ②:当前故意为空)
92
+ WRITER_ROLE_MAP: dict = {}
93
+
94
+ #: 层默认投影表:真源 = `mdcos.MdCGOS.add` docstring「默认 role=None(知识)」。
95
+ #: 只有层名本身就在 `ALL_ROLES` 里时才投影(knowledge 是唯一的一个)。
96
+ LAYER_DEFAULT_ROLE = {"knowledge": "knowledge"}
97
+
98
+ BASIS_TAG = "frontmatter.tags(role:<值> 显式声明)"
99
+ BASIS_LAYER = "mdcos.MdCGOS.add 默认语义(role=None ⇒ knowledge)"
100
+
101
+ REASON_NO_SOURCE = "no_source_declared"
102
+ REASON_TAG_OOD = "tag_role_out_of_domain"
103
+ REASON_MAP_OOD = "map_role_out_of_domain"
104
+ REASON_MAP_WORK = "map_role_is_work_role"
105
+ REASON_WRITER_NO_MAP = "writer_no_mapping"
106
+
107
+ ACTION_ROLE = "role"
108
+ ACTION_ROLE_ROLLBACK = "role_rollback"
109
+ BATCH_DEFAULT = "m4-role"
110
+
111
+ ACTIONS = ("role", "role_rollback", "role_history", "role_stats")
112
+
113
+
114
+ # ---- 通用工具 ------------------------------------------------------------
115
+
116
+ # 生效条件:传入 cg 即返回 os.path.join(cg.root, GOVERN_LOG),无分支。
117
+ def _log_path(cg) -> str:
118
+ return os.path.join(cg.root, GOVERN_LOG)
119
+
120
+
121
+ # 生效条件:fm 为假值(None/{})时按 {} 处理,其 .get("tags") 为假值(None/空串/空列表)时回落 [],否则对该值逐项过滤,只保留 isinstance(t, str) 的元素。
122
+ def _tags(fm: dict) -> list:
123
+ return [t for t in ((fm or {}).get("tags") or []) if isinstance(t, str)]
124
+
125
+
126
+ # 生效条件:detail 为假值(None/空串)时返回 kind,否则返回 "%s:%s" % (kind, detail)。
127
+ def _reason_key(kind: str, detail: str = None) -> str:
128
+ return kind if not detail else "%s:%s" % (kind, detail)
129
+
130
+
131
+ # 生效条件:box 缺 key 时以 box.get(key, 0) 取 0 再加 1 写回 box[key];key 已存在(含值为非数值)时直接对现值 +1。
132
+ def _bump(box: dict, key: str) -> None:
133
+ box[key] = box.get(key, 0) + 1
134
+
135
+
136
+ # ---- 靶子定位(rule 驱动)------------------------------------------------
137
+
138
+ # 生效条件:rules/rules_dir 经 _as_rules 得到的列表中存在 id == rule_id 的项、且该项 matcher.layer 非空、mechanical 中存在 check == CHECK_FIELD_ABSENT 且 field 为真的项时,返回 {'rule_id','title','field','layers','severity','remedy','llm'};该项不存在或 layers/field 为空则抛 ValueError。
139
+ def role_rule(*, rules=None, rules_dir=None, rule_id: str = RULE_ROLE) -> dict:
140
+ """从 M1 规则库取「role 回填」靶规则 → `{field, layers, remedy, …}`。
141
+
142
+ 规则库是靶子的**唯一真源**:缺规则 / 缺 `matcher.layer` / 缺
143
+ `field_absent.field` 一律抛 ValueError(fail-closed)——规则消失不是
144
+ 「没有要治理的东西」,而是治理靶子失效,必须显式红灯而非静默空跑。
145
+ """
146
+ rl = _as_rules(rules, rules_dir)
147
+ hit = next((r for r in rl if r.get("id") == rule_id), None)
148
+ if hit is None:
149
+ raise ValueError("规则库无 %s(可用:%s)"
150
+ % (rule_id, [r.get("id") for r in rl]))
151
+ layers = list((hit.get("matcher") or {}).get("layer") or [])
152
+ field = None
153
+ for spec in hit.get("mechanical") or []:
154
+ if spec.get("check") == CHECK_FIELD_ABSENT and spec.get("field"):
155
+ field = spec["field"]
156
+ break
157
+ if not layers or not field:
158
+ raise ValueError("规则 %s 未声明 matcher.layer / %s.field——无法定位回填靶"
159
+ % (rule_id, CHECK_FIELD_ABSENT))
160
+ return {"rule_id": rule_id, "title": hit.get("title"), "field": field,
161
+ "layers": layers, "severity": hit.get("severity"),
162
+ "remedy": hit.get("remedy"), "llm": list(hit.get("llm") or [])}
163
+
164
+
165
+ # ---- 取值推导(唯一入口:只搬运已声明的证据)------------------------------
166
+
167
+ # 生效条件:按 sources 逐档判定——含 SOURCE_TAGS 时取 fm 的 tags 内首个 ROLE_TAG_PREFIX 前缀标签,其值属 ALL_ROLES 则返回 (值, BASIS_TAG, SOURCE_TAGS, None),值域外则返回 (None,None,None, REASON_TAG_OOD 原因);tags 未定出时含 SOURCE_MAP 则以小写 writer 取 role_map 值,属 WORK_ROLES 返回 REASON_MAP_WORK 原因、属 ALL_ROLES 返回 (值,"WRITER_ROLE_MAP[writer]",SOURCE_MAP,None)、否则返回 REASON_MAP_OOD 原因(命中域外值即返回、不降级);再否且含 SOURCE_LAYER 且 LAYER_DEFAULT_ROLE 命中 e["layer"] 时返回 (值, BASIS_LAYER, SOURCE_LAYER, None);全部未命中则 writer 非空返回 REASON_WRITER_NO_MAP:writer,writer 为空返回 REASON_NO_SOURCE。
168
+ def _candidate_role(e, fm, *, sources, role_map) -> tuple:
169
+ """→ `(role, basis, source, reason)`:有来源则 reason=None;无来源则 role=None。
170
+
171
+ 按声明强度优先:`tags`(成文)> `map`(声明表)> `layer_default`(隐含默认显式化)。
172
+ 命中**域外值**时立即返回且**不降级**:显式声明了域外值 ≠ 无声明——继续回退到更弱的
173
+ 来源会把一个待 designer 裁决的冲突悄悄抹平。
174
+ """
175
+ if SOURCE_TAGS in sources:
176
+ for t in _tags(fm):
177
+ if t.startswith(ROLE_TAG_PREFIX):
178
+ v = t[len(ROLE_TAG_PREFIX):].strip().lower()
179
+ if v in ALL_ROLES:
180
+ return v, BASIS_TAG, SOURCE_TAGS, None
181
+ return None, None, None, _reason_key(REASON_TAG_OOD, v or "空")
182
+ if SOURCE_MAP in sources:
183
+ w = str(fm.get("writer") or "").strip().lower()
184
+ v = str((role_map or {}).get(w) or "").strip().lower() if w else ""
185
+ if v:
186
+ if v in WORK_ROLES:
187
+ # 映射表是**我们的推断**:把 knowledge 层节点推成工作角色会让它在默认
188
+ # 召回中被剔除(`_candidates` 默认排除 WORK_ROLES)——故意不做,红灯。
189
+ return None, None, None, _reason_key(REASON_MAP_WORK, v)
190
+ if v in ALL_ROLES:
191
+ return v, "WRITER_ROLE_MAP[%s]" % w, SOURCE_MAP, None
192
+ return None, None, None, _reason_key(REASON_MAP_OOD, v)
193
+ if SOURCE_LAYER in sources:
194
+ v = LAYER_DEFAULT_ROLE.get(str(e.get("layer") or ""))
195
+ if v:
196
+ return v, BASIS_LAYER, SOURCE_LAYER, None
197
+ w = str(fm.get("writer") or "").strip()
198
+ return None, None, None, (_reason_key(REASON_WRITER_NO_MAP, w) if w
199
+ else REASON_NO_SOURCE)
200
+
201
+
202
+ # 生效条件:按序判定——_readable_guard(cg, e) 为假返回 ("denied", None);direct_read(cg, e) 的 fm 为 None 返回 ("unreadable", None);crypto.is_encrypted(content) 为真返回 ("locked", None);fm.get("role") 非空白返回 ("present", None);否则 _candidate_role(e, fm, sources=sources, role_map=role_map) 的 role 为假返回 ("unfillable", {id,layer,reason,writer}),role 为真返回 ("", {id,layer,role,source,basis,before,had_key,writer})。
203
+ def _classify(cg, e, nid, *, sources, role_map) -> tuple:
204
+ """单条裁决 → `(skip_reason, item|gap)`;skip_reason 为空串表示可回填。"""
205
+ if not _readable_guard(cg, e):
206
+ return "denied", None
207
+ fm, content = direct_read(cg, e)
208
+ if fm is None:
209
+ return "unreadable", None
210
+ if crypto.is_encrypted(content):
211
+ return "locked", None
212
+ if not _blank(fm.get("role")):
213
+ return "present", None
214
+ role, basis, src, reason = _candidate_role(e, fm, sources=sources,
215
+ role_map=role_map)
216
+ if not role:
217
+ return "unfillable", {"id": nid, "layer": e.get("layer"),
218
+ "reason": reason, "writer": fm.get("writer")}
219
+ return "", {"id": nid, "layer": e.get("layer"), "role": role, "source": src,
220
+ "basis": basis, "before": fm.get("role"),
221
+ "had_key": "role" in fm, "writer": fm.get("writer")}
222
+
223
+
224
+ # 生效条件:want 由必填 layers 决定;layer 为真值时须属 layers 否则抛 ValueError,且命中后 want 收窄为 {layer};ids 为真值时只保留白名单内 nid、为假值(None/[])时不过滤;prefix 为真值时只保留 nid 以之开头者;仅 str(e.get("layer")) 属 want 的条目按 nid 升序进入返回列表。
225
+ def _iter_scope(cg, *, layers, layer=None, prefix=None, ids=None) -> list:
226
+ """按规则作用域遍历索引条目 → `[(nid, entry)]`(只读、nid 稳定序)。
227
+
228
+ `layer` 收窄只能收窄到规则已声明的层内——跨层即抛错(同 `ruleset` 的
229
+ 「执行时按同一条件过滤,绝不跨层套用」)。
230
+ """
231
+ want = set(layers)
232
+ if layer:
233
+ if layer not in want:
234
+ raise ValueError("layer=%s 不在靶规则作用域 %s 内(绝不跨层套用)"
235
+ % (layer, sorted(want)))
236
+ want = {layer}
237
+ idw = set(ids) if ids else None
238
+ out = []
239
+ for nid in sorted((cg.index.get("nodes") or {})):
240
+ if idw is not None and nid not in idw:
241
+ continue
242
+ if prefix and not nid.startswith(prefix):
243
+ continue
244
+ e = cg.index["nodes"][nid]
245
+ if str(e.get("layer")) not in want:
246
+ continue
247
+ out.append((nid, e))
248
+ return out
249
+
250
+
251
+ # ---- 预演 -----------------------------------------------------------------
252
+
253
+ # 生效条件:以 x 经 _as_cg 得 cg 并先经 role_rule(rules,rules_dir,rule_id) 取规则(缺规则/缺 layer/缺 field 时该步抛 ValueError),role_map 非空时的条目以小写去空白键合并进 WRITER_ROLE_MAP 副本,再遍历 _iter_scope(cg, layers=rule["layers"], layer=layer, prefix=prefix, ids=ids) 逐条 _classify 后返回不写盘的 rep;每条 item 仅在 limit is None 或 len(rep["items"]) < limit 时追加(limit=0 时 items 为空但 targeted 仍累加),sample 为真且 planned_ids 非空时以 max(1, len(planned_ids)//int(sample)) 为步长取前 int(sample) 项。
254
+ def role_plan(x, layer=None, limit=None, ids=None, prefix=None, *,
255
+ sources=DEFAULT_SOURCES, role_map=None, rule_id=RULE_ROLE,
256
+ rules=None, rules_dir=None, sample=0) -> dict:
257
+ """预演:产出可回填清单 + 不可回填原因分布,**不写盘**。
258
+
259
+ `sources` 见模块 docstring 的三档来源;`role_map` 覆盖 `WRITER_ROLE_MAP`
260
+ (designer 终裁补声明表的入口,不改库)。
261
+ """
262
+ cg = _as_cg(x)
263
+ rule = role_rule(rules=rules, rules_dir=rules_dir, rule_id=rule_id)
264
+ rm = dict(WRITER_ROLE_MAP)
265
+ rm.update({str(k).strip().lower(): v for k, v in (role_map or {}).items()})
266
+ rep = {"root": cg.root, "dry_run": True, "action": ACTION_ROLE,
267
+ "rule": rule, "sources": list(sources), "role_map": rm,
268
+ "layer": layer, "prefix": prefix,
269
+ "nodes_scanned": 0, "skipped_out_of_scope": 0,
270
+ "skipped_locked": 0, "skipped_denied": 0, "skipped_unreadable": 0,
271
+ "skipped_present": 0, "unfillable": 0, "unfillable_by_reason": {},
272
+ "targeted": 0, "by_source": {}, "items": []}
273
+ scope_layers = set(rule["layers"])
274
+ idw = set(ids) if ids else None
275
+ for nid in sorted((cg.index.get("nodes") or {})):
276
+ if idw is not None and nid not in idw:
277
+ continue
278
+ if prefix and not str(nid).startswith(prefix):
279
+ continue
280
+ e = cg.index["nodes"][nid]
281
+ if str(e.get("layer")) not in scope_layers:
282
+ rep["skipped_out_of_scope"] += 1
283
+ for nid, e in _iter_scope(cg, layers=rule["layers"], layer=layer,
284
+ prefix=prefix, ids=ids):
285
+ rep["nodes_scanned"] += 1
286
+ skip, item = _classify(cg, e, nid, sources=sources, role_map=rm)
287
+ if skip == "unfillable":
288
+ rep["unfillable"] += 1
289
+ # 原因键带明细(如 writer_no_mapping:dsh-memory)——聚合即得逐来源分布
290
+ _bump(rep["unfillable_by_reason"], str(item["reason"]))
291
+ continue
292
+ if skip:
293
+ rep["skipped_%s" % skip] = rep.get("skipped_%s" % skip, 0) + 1
294
+ continue
295
+ item["entry_id"] = _entry_id(ACTION_ROLE, nid)
296
+ item["ref"] = e.get("ref")
297
+ rep["targeted"] += 1
298
+ _bump(rep["by_source"], item["source"])
299
+ if limit is None or len(rep["items"]) < limit:
300
+ rep["items"].append(item)
301
+ rep["planned_ids"] = [i["id"] for i in rep["items"]]
302
+ if sample and rep["planned_ids"]:
303
+ step = max(1, len(rep["planned_ids"]) // int(sample))
304
+ rep["sample"] = rep["planned_ids"][::step][:int(sample)]
305
+ rep["rule_layers"] = sorted(scope_layers)
306
+ return rep
307
+
308
+
309
+ # ---- 执行 / 回滚 / 留痕 / 对照 -------------------------------------------
310
+
311
+ # 生效条件:x 经 _as_cg,batch 为假值时回落 BATCH_DEFAULT;先调 role_plan 取 items,entry_ids 为真值时按 entry_id 收窄;逐项处理:索引无该节点或 _read 得 fm 为 None → skipped_missing,_readable_guard 为假 → skipped_denied,crypto.is_encrypted(content) 为真 → skipped_locked,fm["role"] 非空 → skipped_drift,否则写回 role 并 append_jsonl 留痕、written 递增;written 非零时 cg.rebuild_index(),返回含 plan_remaining 的 rep。
312
+ def role_apply(x, ids=None, entry_ids=None, layer=None, limit=None,
313
+ batch=BATCH_DEFAULT, sources=DEFAULT_SOURCES, role_map=None,
314
+ rule_id=RULE_ROLE, rules=None, rules_dir=None, actor=None,
315
+ prefix=None) -> dict:
316
+ """执行回填:逐节点改写 md 的 role 字段,写 `_govern.jsonl` 留痕。
317
+
318
+ 写前**重查**一次(预演 → 执行之间节点可能被改动):已有 role 值 → `skipped_drift`
319
+ 一律不动;密文 / 不可读 → `skipped_locked` / `skipped_missing`,**绝不解密回写**。
320
+ `ids` / `prefix` / `entry_ids` 三重收窄,`entry_ids` 优先(工单式精确执行)。
321
+ """
322
+ cg = _as_cg(x)
323
+ batch = batch or BATCH_DEFAULT
324
+ p = role_plan(cg, layer=layer, limit=limit, ids=ids, prefix=prefix,
325
+ sources=sources, role_map=role_map, rule_id=rule_id,
326
+ rules=rules, rules_dir=rules_dir)
327
+ items = p["items"]
328
+ if entry_ids:
329
+ want = set(entry_ids)
330
+ items = [i for i in items if i["entry_id"] in want]
331
+ rep = {"root": cg.root, "dry_run": False, "action": ACTION_ROLE,
332
+ "batch": batch, "actor": actor, "rule_id": rule_id,
333
+ "field": p["rule"]["field"], "sources": list(sources),
334
+ "planned": len(items), "written": 0, "by_source": {},
335
+ "skipped_drift": 0, "skipped_locked": 0, "skipped_missing": 0,
336
+ "skipped_denied": 0, "entry_ids": [],
337
+ "unfillable": p["unfillable"],
338
+ "unfillable_by_reason": p["unfillable_by_reason"]}
339
+ for it in items:
340
+ nid = it["id"]
341
+ e = (cg.index.get("nodes") or {}).get(nid)
342
+ if e is None:
343
+ rep["skipped_missing"] += 1
344
+ continue
345
+ if not _readable_guard(cg, e):
346
+ rep["skipped_denied"] += 1
347
+ continue
348
+ fm, content = direct_read(cg, e)
349
+ if fm is None:
350
+ rep["skipped_missing"] += 1
351
+ continue
352
+ if crypto.is_encrypted(content):
353
+ rep["skipped_locked"] += 1
354
+ continue
355
+ if not _blank(fm.get("role")):
356
+ rep["skipped_drift"] += 1
357
+ continue
358
+ fm_before = {"role": fm.get("role"), "had_key": "role" in fm}
359
+ fm["role"] = it["role"]
360
+ ts = time.time()
361
+ cg._write_node(nid, os.path.join(cg.root, e["path"]), fm, content,
362
+ durable=True)
363
+ wid = _sha("%s|%s|%.6f" % (nid, batch, ts))
364
+ append_jsonl(_log_path(cg), {
365
+ "action": ACTION_ROLE, "ts": ts, "batch": batch, "actor": actor,
366
+ "entry_id": it["entry_id"], "write_id": wid, "node": nid,
367
+ "layer": e.get("layer"), "rule_id": rule_id, "field": "role",
368
+ "value": it["role"], "source": it["source"], "basis": it["basis"],
369
+ "writer": it.get("writer"), "fm_before": fm_before,
370
+ "content_hash_after": _sha(content)})
371
+ rep["written"] += 1
372
+ _bump(rep["by_source"], it["source"])
373
+ rep["entry_ids"].append(it["entry_id"])
374
+ if rep["written"]:
375
+ cg.rebuild_index()
376
+ rep["plan_remaining"] = max(0, p["targeted"] - len(items))
377
+ return rep
378
+
379
+
380
+ # 生效条件:只处理 action == ACTION_ROLE 的留痕,且 batch 为真时要求 rec.get("batch") == batch(batch 为 None/假值时不按批次过滤)、entry_ids 为真时要求 rec.get("entry_id") ∈ set(entry_ids);rec 的 write_id 已在既有 ACTION_ROLE_ROLLBACK 记录中 → skipped_done,节点不在索引或 read 不到或加密 → missing,当前 fm.get("role") 为空白或与 rec.get("value") 不等 → conflict 不覆盖,相等时按 fm_before.get("had_key") 恢复 fm_before["role"] 或删除 role 键;reverted 非 0 时 cg.rebuild_index()。
381
+ def role_rollback(x, batch=None, entry_ids=None, actor=None) -> dict:
382
+ """按留痕反向应用:撤销 role 回填。
383
+
384
+ **只在当前值仍等于当初写入值时**撤销;否则计 `conflict` 不覆盖(此后可能已有
385
+ 人工修正 / 后续批次写入)。原本无该键 → 删键还原(不是写空串)。
386
+ """
387
+ cg = _as_cg(x)
388
+ want = set(entry_ids) if entry_ids else None
389
+ rep = {"root": cg.root, "action": ACTION_ROLE_ROLLBACK, "actor": actor,
390
+ "batch": batch, "reverted": 0, "conflict": 0, "missing": 0,
391
+ "skipped_done": 0, "entry_ids": []}
392
+ log = list(read_jsonl(_log_path(cg)) or [])
393
+ done = {r.get("write_id") for r in log
394
+ if r.get("action") == ACTION_ROLE_ROLLBACK and r.get("write_id")}
395
+ for rec in log:
396
+ if rec.get("action") != ACTION_ROLE:
397
+ continue
398
+ if batch and rec.get("batch") != batch:
399
+ continue
400
+ if want is not None and rec.get("entry_id") not in want:
401
+ continue
402
+ wid = rec.get("write_id")
403
+ if wid and wid in done:
404
+ rep["skipped_done"] += 1
405
+ continue
406
+ nid = rec.get("node")
407
+ e = (cg.index.get("nodes") or {}).get(nid)
408
+ if e is None:
409
+ rep["missing"] += 1
410
+ continue
411
+ fm, content = direct_read(cg, e)
412
+ if fm is None or crypto.is_encrypted(content):
413
+ rep["missing"] += 1
414
+ continue
415
+ if _blank(fm.get("role")) or str(fm.get("role")) != str(rec.get("value")):
416
+ rep["conflict"] += 1
417
+ continue
418
+ before = rec.get("fm_before") or {}
419
+ if before.get("had_key"):
420
+ fm["role"] = before.get("role")
421
+ else:
422
+ fm.pop("role", None)
423
+ cg._write_node(nid, os.path.join(cg.root, e["path"]), fm, content,
424
+ durable=True)
425
+ append_jsonl(_log_path(cg), {
426
+ "action": ACTION_ROLE_ROLLBACK, "ts": time.time(), "actor": actor,
427
+ "batch": rec.get("batch"), "entry_id": rec.get("entry_id"),
428
+ "write_id": wid, "node": nid, "field": "role",
429
+ "restored": before.get("role"),
430
+ "had_key": bool(before.get("had_key")), "reason": "rollback"})
431
+ rep["reverted"] += 1
432
+ rep["entry_ids"].append(rec.get("entry_id"))
433
+ if rep["reverted"]:
434
+ cg.rebuild_index()
435
+ return rep
436
+
437
+
438
+ # 生效条件:action 为真时只保留 r.get("action") == action 的记录、batch 为真时只保留 r.get("batch") == batch 的记录,total/by_action 统计的是过滤后的 recs 全量;records 在 limit 为假值(0/None)时返回全部 recs,否则返回 recs[-int(limit):]。
439
+ def history(x, limit=100, action=None, batch=None) -> dict:
440
+ """读 `_govern.jsonl` 留痕(治理动作的可审计面)。"""
441
+ cg = _as_cg(x)
442
+ recs = [r for r in (read_jsonl(_log_path(cg)) or [])
443
+ if (not action or r.get("action") == action)
444
+ and (not batch or r.get("batch") == batch)]
445
+ tail = recs[-int(limit):] if limit else recs
446
+ by_action = {}
447
+ for r in recs:
448
+ _bump(by_action, str(r.get("action")))
449
+ return {"root": cg.root, "action": "role_history", "total": len(recs),
450
+ "by_action": by_action, "records": tail}
451
+
452
+
453
+ # 生效条件:x 经 _as_cg 且 role_rule(rules=rules, rules_dir=rules_dir, rule_id=rule_id) 命中并声明了 matcher.layer 与 field_absent.field 时,返回以 conformance.load_index(cg.root) 的节点为口径的统计(by_layer 计全部节点、by_value 只计 role 非空白者、target_met 由 role_ratio_kn >= float(THRESHOLDS["role_coverage_min"]) 决定、gap_to_target 取 max(0.0, thr-kn));规则缺失或声明不全时在 role_rule 处抛 ValueError。
454
+ def role_stats(x, *, rule_id=RULE_ROLE, rules=None, rules_dir=None) -> dict:
455
+ """只读对照:role 覆盖率 + 取值分布(治理前后量化用)。
456
+
457
+ 判据**不复刻**——直接复用 `conformance`(真源:`_coverage_metrics` 的
458
+ knowledge 层口径 `role_ratio_kn` 与 `THRESHOLDS["role_coverage_min"]`),
459
+ 本函数只补「逐层 / 逐值」分布,供 M4 复跑报告引用。
460
+ """
461
+ from .. import conformance as CONF # 延迟导入:读侧判据真源,按需加载
462
+ cg = _as_cg(x)
463
+ rule = role_rule(rules=rules, rules_dir=rules_dir, rule_id=rule_id)
464
+ nodes = CONF.load_index(cg.root)
465
+ cov = CONF._coverage_metrics(nodes)
466
+ thr = float(CONF.THRESHOLDS["role_coverage_min"])
467
+ by_layer, by_value = {}, {}
468
+ for e in nodes.values():
469
+ _bump(by_layer, str(e.get("layer")))
470
+ if not _blank(e.get("role")):
471
+ _bump(by_value, str(e.get("role")))
472
+ kn = float(cov.get("role_ratio_kn") or 0.0)
473
+ return {"root": cg.root, "action": "role_stats", "rule_id": rule_id,
474
+ "layers": rule["layers"], "nodes": cov.get("nodes"),
475
+ "knowledge": cov.get("knowledge"), "role_ratio": cov.get("role_ratio"),
476
+ "role_ratio_kn": cov.get("role_ratio_kn"), "threshold": thr,
477
+ "target_met": kn >= thr, "gap_to_target": max(0.0, thr - kn),
478
+ "by_layer": by_layer, "by_value": by_value}
479
+
480
+
481
+ # ---- 统一入口 ------------------------------------------------------------
482
+
483
+ # 生效条件:action 不在 ACTIONS 内时抛 ValueError;action == ACTION_ROLE 时以 kw.pop("apply", False) 为真调用 role_apply(x, **kw)、为假(含缺该键)调用 role_plan(x, **kw);其余情况以 {ACTION_ROLE_ROLLBACK: role_rollback, "role_history": history, "role_stats": role_stats}[action] 取 fn 并返回 fn(x, **kw)。
484
+ def run(x, action, **kw) -> dict:
485
+ """`role`(`apply=True` 则执行)/ `role_rollback` / `role_history` / `role_stats`。"""
486
+ if action not in ACTIONS:
487
+ raise ValueError("未知 action=%s(可用:%s)" % (action, list(ACTIONS)))
488
+ if action == ACTION_ROLE:
489
+ if kw.pop("apply", False):
490
+ return role_apply(x, **kw)
491
+ return role_plan(x, **kw)
492
+ fn = {ACTION_ROLE_ROLLBACK: role_rollback, "role_history": history,
493
+ "role_stats": role_stats}[action]
494
+ return fn(x, **kw)
495
+
496
+
497
+ # ---- 命令行 --------------------------------------------------------------
498
+ #
499
+ # 形态约定:`--root` / `--rules-dir` / `--json` 均为**子命令参数**(`parents=[common]`),
500
+ # 须写在子命令**之后**:`govern plan --root <root>`。写在子命令之前会被顶层解析器
501
+ # 当作位置参数吃掉(`scripts/review_cli.py` 的同型坑,2026-09-15 实测更正)。
502
+
503
+ # 生效条件:s 为假值(None/空串)时直接返回 DEFAULT_SOURCES;否则按 "," 切分并 strip 丢弃空段,任一段不在 ALL_SOURCES 内即抛 ValueError,切分后 vals 为空(如 s=",")也抛 ValueError,其余返回该非空元组。
504
+ def _parse_sources(s) -> tuple:
505
+ """CLI 侧来源档解析:逗号分隔,值域封闭(非法即抛,不静默降级)。"""
506
+ if not s:
507
+ return DEFAULT_SOURCES
508
+ vals = tuple(v.strip() for v in str(s).split(",") if v.strip())
509
+ bad = [v for v in vals if v not in ALL_SOURCES]
510
+ if bad:
511
+ raise ValueError("未知来源档 %s(可用:%s)" % (bad, list(ALL_SOURCES)))
512
+ if not vals:
513
+ raise ValueError("sources 为空(缺省即 %s)" % ",".join(DEFAULT_SOURCES))
514
+ return vals
515
+
516
+
517
+ # 生效条件:无参数,调用即返回 argparse.ArgumentParser(add_help=False),其中已含 --root(default=None)、--rules-dir(default=None)、--json(store_true) 三项,无分支。
518
+ def _common_parser() -> argparse.ArgumentParser:
519
+ ap = argparse.ArgumentParser(add_help=False)
520
+ ap.add_argument("--root", default=None, help="真源根(缺省读环境变量 MDCG_ROOT)")
521
+ ap.add_argument("--rules-dir", default=None, help="规则库目录(缺省 mreview/rules)")
522
+ ap.add_argument("--json", action="store_true", help="输出 JSON(缺省人读摘要)")
523
+ return ap
524
+
525
+
526
+ # 生效条件:传入 p 即向它注册 --layer/--prefix/--ids/--limit(type=int)/--sources 五个参数,无分支且无返回值。
527
+ def _add_scope_args(p) -> None:
528
+ p.add_argument("--layer", help="收窄到该层(须在规则 matcher 层之内)")
529
+ p.add_argument("--prefix", help="只处理该 id 前缀")
530
+ p.add_argument("--ids", help="逗号分隔的节点 id 白名单")
531
+ p.add_argument("--limit", type=int, help="本次最多处理条数")
532
+ p.add_argument("--sources",
533
+ help="来源档逗号分隔:tags,map[,layer_default](缺省 %s)"
534
+ % ",".join(DEFAULT_SOURCES))
535
+
536
+
537
+ # 生效条件:传入 a 后返回 {'layer': a.layer, 'prefix': a.prefix, 'limit': a.limit, 'ids': [...], 'sources': _parse_sources(a.sources), 'rules_dir': a.rules_dir},其中 ids 由 a.ids(为假值即 None/空串)按 "," 切分去空段、结果为空则回落 None,sources 由 a.sources 经 _parse_sources 解析(假值 → DEFAULT_SOURCES,非法值抛 ValueError)。
538
+ def _scope_kw(a) -> dict:
539
+ return {"layer": a.layer, "prefix": a.prefix, "limit": a.limit,
540
+ "ids": [i.strip() for i in (a.ids or "").split(",") if i.strip()] or None,
541
+ "sources": _parse_sources(a.sources), "rules_dir": a.rules_dir}
542
+
543
+
544
+ # 生效条件:SOURCE_LAYER 在 sources 内时向 sys.stderr 打印 "警告:" + LAYER_DEFAULT_WARNING,否则不输出。
545
+ def _warn_layer_default(sources) -> None:
546
+ if SOURCE_LAYER in sources:
547
+ print("警告:" + LAYER_DEFAULT_WARNING, file=sys.stderr)
548
+
549
+
550
+ # 生效条件:传入 msg 即向 sys.stderr 打印该 msg 并返回 2,无分支。
551
+ def _die(msg: str) -> int:
552
+ print(msg, file=sys.stderr)
553
+ return 2
554
+
555
+
556
+ def main(argv=None) -> int:
557
+ ap = argparse.ArgumentParser(
558
+ prog="python -m md_cg.mreview.govern",
559
+ description="记忆评审 M4 · 落库治理(确定性部分:rule 驱动 · 永不删除)")
560
+ sub = ap.add_subparsers(dest="cmd")
561
+ common = _common_parser()
562
+
563
+ p = sub.add_parser("plan", parents=[common], help="预演(只出报表,不写盘)")
564
+ _add_scope_args(p)
565
+ p.add_argument("--sample", type=int, default=0, help="抽样条数(人工核对样板)")
566
+
567
+ p = sub.add_parser("apply", parents=[common], help="执行回填(写盘 + 留痕 + 可回滚)")
568
+ _add_scope_args(p)
569
+ p.add_argument("--batch", default=BATCH_DEFAULT, help="批次名(留痕 / 回滚锚点)")
570
+ p.add_argument("--actor", default=None, help="执行者署名(留痕)")
571
+ p.add_argument("--entry-id", action="append", default=[],
572
+ help="只执行该条目(可多次;工单式精确执行)")
573
+ p.add_argument("--yes", action="store_true", help="显式确认写盘(缺省拒绝)")
574
+
575
+ p = sub.add_parser("rollback", parents=[common], help="按留痕回滚")
576
+ p.add_argument("--batch", default=None, help="只回滚该批次")
577
+ p.add_argument("--entry-id", action="append", default=[], help="只回滚该条目(可多次)")
578
+ p.add_argument("--actor", default=None, help="执行者署名(留痕)")
579
+
580
+ p = sub.add_parser("history", parents=[common], help="读 `_govern.jsonl` 留痕")
581
+ p.add_argument("--limit", type=int, default=100)
582
+ p.add_argument("--batch", default=None)
583
+ p.add_argument("--action", default=None)
584
+
585
+ sub.add_parser("stats", parents=[common],
586
+ help="覆盖率对照(复用 conformance 判据)")
587
+
588
+ a = ap.parse_args(argv)
589
+ if not a.cmd:
590
+ # `--root` 是**子命令**参数(`parents=[common]`):无子命令时顶层 Namespace
591
+ # 根本没有该属性——须先判 cmd 再取 root,否则 `govern` 裸跑即 AttributeError。
592
+ ap.print_help()
593
+ return 2
594
+ root = a.root or os.environ.get("MDCG_ROOT")
595
+ if not root:
596
+ return _die("需要 --root 或环境变量 MDCG_ROOT(fail-closed)")
597
+
598
+ if a.cmd == "plan":
599
+ try:
600
+ kw = _scope_kw(a)
601
+ except ValueError as ex:
602
+ return _die(str(ex))
603
+ _warn_layer_default(kw["sources"])
604
+ try:
605
+ rep = role_plan(root, sample=a.sample, **kw)
606
+ except ValueError as ex:
607
+ return _die("预演失败:%s" % ex)
608
+ if a.json:
609
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
610
+ return 0
611
+ print("[M4 预演·只读] root=%s" % rep["root"])
612
+ print(" 靶规则 %s|层 %s|字段 %s|来源档 %s"
613
+ % (rep["rule"]["rule_id"], ",".join(rep["rule_layers"]),
614
+ rep["rule"]["field"], ",".join(rep["sources"])))
615
+ print(" 扫描 %d|可回填 %d|不可回填 %d|域外 %d|已锁 %d|已有值 %d|无权限 %d"
616
+ % (rep["nodes_scanned"], rep["targeted"], rep["unfillable"],
617
+ rep["skipped_out_of_scope"], rep["skipped_locked"],
618
+ rep["skipped_present"], rep["skipped_denied"]))
619
+ for k, v in sorted(rep["by_source"].items()):
620
+ print(" 来源 %-16s %d" % (k, v))
621
+ for k, v in sorted(rep["unfillable_by_reason"].items(), key=lambda kv: -kv[1]):
622
+ print(" 挡下 %-32s %d" % (k, v))
623
+ if rep.get("sample"):
624
+ print(" 抽样:%s" % ", ".join(rep["sample"]))
625
+ return 0
626
+
627
+ if a.cmd == "apply":
628
+ if not a.yes:
629
+ return _die("apply 会写盘:先跑 plan 核对清单,再以 --yes 显式确认(fail-closed)")
630
+ try:
631
+ kw = _scope_kw(a)
632
+ except ValueError as ex:
633
+ return _die(str(ex))
634
+ _warn_layer_default(kw["sources"])
635
+ try:
636
+ rep = role_apply(root, batch=a.batch, actor=a.actor,
637
+ entry_ids=list(a.entry_id) or None, **kw)
638
+ except ValueError as ex:
639
+ return _die("执行失败:%s" % ex)
640
+ if a.json:
641
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
642
+ return 0
643
+ print("[M4 执行] batch=%s actor=%s" % (rep["batch"], rep["actor"]))
644
+ print(" 写入 %d|漂移跳过 %d|密文跳过 %d|缺失 %d|无权限 %d|余量 %d"
645
+ % (rep["written"], rep["skipped_drift"], rep["skipped_locked"],
646
+ rep["skipped_missing"], rep["skipped_denied"], rep["plan_remaining"]))
647
+ for k, v in sorted(rep["by_source"].items()):
648
+ print(" 来源 %-16s %d" % (k, v))
649
+ return 0
650
+
651
+ if a.cmd == "rollback":
652
+ if not a.batch and not a.entry_id:
653
+ return _die("rollback 需要 --batch 或 --entry-id(防全量误回滚)")
654
+ rep = role_rollback(root, batch=a.batch, actor=a.actor,
655
+ entry_ids=list(a.entry_id) or None)
656
+ if a.json:
657
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
658
+ return 0
659
+ print("[M4 回滚] batch=%s|还原 %d|冲突跳过 %d|缺失 %d|已回滚 %d"
660
+ % (rep["batch"], rep["reverted"], rep["conflict"], rep["missing"],
661
+ rep["skipped_done"]))
662
+ return 0
663
+
664
+ if a.cmd == "history":
665
+ rep = history(root, limit=a.limit, action=a.action, batch=a.batch)
666
+ if a.json:
667
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
668
+ return 0
669
+ print("[M4 留痕] 命中 %d 条|分布 %s" % (rep["total"], rep["by_action"]))
670
+ for r in rep["records"]:
671
+ print(" %-14s %-10s %-22s %s=%s"
672
+ % (time.strftime("%m-%d %H:%M:%S", time.localtime(r.get("ts") or 0)),
673
+ r.get("action"), str(r.get("node")), r.get("field"),
674
+ r.get("value", r.get("restored"))))
675
+ return 0
676
+
677
+ try:
678
+ rep = role_stats(root)
679
+ except ValueError as ex:
680
+ return _die("对照失败:%s" % ex)
681
+ if a.json:
682
+ print(json.dumps(rep, ensure_ascii=False, indent=2))
683
+ return 0
684
+ print("[M4 对照] root=%s 判据源=conformance" % rep["root"])
685
+ print(" 节点 %s|knowledge %s|role 覆盖 %s|knowledge 层覆盖 %s(阈值 %.2f,%s)"
686
+ % (rep["nodes"], rep["knowledge"], rep["role_ratio"],
687
+ rep["role_ratio_kn"], rep["threshold"],
688
+ "达标" if rep["target_met"] else "未达标,缺口 %.4f" % rep["gap_to_target"]))
689
+ print(" 逐层 %s" % rep["by_layer"])
690
+ print(" 逐值 %s" % rep["by_value"])
691
+ return 0
692
+
693
+
694
+ if __name__ == "__main__":
695
695
  sys.exit(main())