@furongjun1999/dsh-memory 0.9.14 → 0.9.16

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