@furongjun1999/dsh-memory 0.9.21 → 0.9.23

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