@furongjun1999/dsh-memory 0.9.18 → 0.9.22

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