@furongjun1999/dsh-memory 0.8.0 → 0.9.6

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 (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. 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.md +179 -0
  8. 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 -0
  9. 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_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  531. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  535. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  539. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  543. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  547. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  548. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  549. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  550. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  551. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  552. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  553. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  554. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  559. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  563. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  564. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  565. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  566. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  567. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  568. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  569. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  570. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  571. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  572. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. 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 +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,261 +1,274 @@
1
- # -*- coding: utf-8 -*-
2
- """工具面渐进披露(pi ① 上下文经济学 · 灵枢落地)。
3
-
4
- 【为什么】
5
- MCP 工具的 op 参数空间全量 schema 常驻调用方上下文:kernel 暴露面(cg+stg)
6
- 达 ~20k 字符,其中 cg 一个工具就有 169 个参数——绝大多数是「长尾 op 专属参数的
7
- 解释文字」,只在少数场景才需要,却每次会话都要付费注入。
8
-
9
- pi 的做法(`system-prompt.ts:82-84` 工具只以一行 snippet 常驻系统提示,完整描述
10
- 只进 API tools 字段;`skills.ts:355-383` 索引常驻、正文按需 read)证明:
11
- **常驻面只需「我知道它存在、且知道怎么问」**,完整语义按需取回即可。
12
-
13
- 【怎么做 · 信息零丢失】
14
- 本模块**不改 schema 真源**(`mcp_server.KERNEL_TOOLS` / `TOOLS` 仍是完整定义),
15
- 只做运行时**投影**:
16
- · 工具 description → `TOOL_BRIEFS` 一行职责(缺省回退首句);
17
- · 参数 description → 短提示:通用参数保留首段(≤30 字符)、op 专属参数压到
18
- ≤16 字符,枚举型参数保留**完整值集**(值集是调用契约,不可省);
19
- · 顺带剔除 `_req`(`_p()` 写的内部标记,本不该出现在对外 schema)。
20
- 被投影掉的原文既不复制也不搬运——`cg(op=help, query=…)` 直接从真源渲染,
21
- 故不存在第二真源、无漂移面,信息守恒是结构性的而非靠人工维护。
22
-
23
- 【守卫】`md_cg/test_tool_face.py` 机械断言:注入面 ≥50% 削减 + 工具名/参数名/
24
- required/类型/枚举值集逐位不变 + 每个被投影掉的参数描述都能由 op=help 无损取回。
25
-
26
- 【关闭】`MDCG_TOOL_FACE=full` 返回完整真源(调试/兼容)。
27
- """
28
- from __future__ import annotations
29
-
30
- import os
31
- import re
32
-
33
- FULL_ENV = "MDCG_TOOL_FACE"
34
-
35
- # --------------------------------------------------------------------------
36
- # 一行职责(唯一手写面:必须由人写,不能机械生成)
37
- # --------------------------------------------------------------------------
38
- CG_HELP_HINT = '完整 op/参数语义:cg(op="help", query="<op 名 | 参数名 | 工具名>")'
39
-
40
- TOOL_BRIEFS = {
41
- "cg": "灵枢认知图唯一入口(34 op:写/读/审/护/演化/元认知/预测/白箱/验证态 status/"
42
- "三元组反查 edges…)。" + CG_HELP_HINT,
43
- "stg": "语义时空图 4 op:relation|timeline|anchors|consistency。" + CG_HELP_HINT,
44
- "mdcg_remember": "写入记忆节点(gated=true 走主动遗忘闸门;正文建议含 CCG 五要素)。",
45
- "mdcg_recall": "按 token 预算召回记忆包(RRF 多路融合,可开模糊/条件语义路与查询扩展)。",
46
- "mdcg_search": "精确检索(T0–T3 阶梯 + 四态资格判定)。",
47
- "mdcg_get": "按 id 读取单个节点(frontmatter + content)。",
48
- "mdcg_reflect": "记录信息差 D(t,C) 与二阶 d²D/dt²(写 _reflection.jsonl)。",
49
- "mdcg_verify": "节点外部裁决 confirmed/weakened/falsified(falsified 入负记忆)。",
50
- "mdcg_flywheel": "误差(预期 vs 实际)转为 unresolved 条目,驱动补条件。",
51
- "mdcg_mine_fix_pairs": "从行为日志挖掘「错误→修复」对(产修复知识 + 负记忆)。",
52
- "mdcg_rejected": "写入负记忆(被证伪假设),同内容幂等。",
53
- "mdcg_unresolved": "写入未解问题(驱动主动探索)。",
54
- "mdcg_propose": "候选记忆入审核队列(海马体 inbox)。",
55
- "mdcg_review_list": "列出待审核候选(红队打回者带 needs_reapproval;需 review op)。",
56
- "mdcg_review_decide": "审核裁决 accept|reject|edit|merge(redteam 打回需再审批)。",
57
- "mdcg_review_records": "裁决记录审计(可复核 record_hash 一致性)。",
58
- "mdcg_forget": "软删除(tombstone → trash/,受保护节点需 override)。",
59
- "mdcg_protect": "写保护:stats|check|mark|snapshot|history|forgetting(需 protect op;mark 还需 admin)。",
60
- "mdcg_forgetting_history": "主动遗忘裁决留痕(四态 + 三问判据;需 protect op)。",
61
- "mdcg_identity": "身份特征识别(self/user/role/agent 的锚点、位置效应、条件特征)。",
62
- "mdcg_consistency": "节点间冲突检测(L0 情绪 → L1 反思 → L2 递归反思;可投飞轮)。",
63
- "mdcg_metacognition": "独立元认知(情绪/校准/盲区/信任四面;只读留痕)。",
64
- "mdcg_self_state": "自我状态层(薄自我 + 富索引:状态卡单例 + 关系节点)。",
65
- "mdcg_predict": "生成式预测(候选未来;过滤门 + 四维评分 + 命中反馈校准)。",
66
- "mdcg_causal": "因果推理(causal 边 = 条件依赖;path|gate|chain|explain)。",
67
- "mdcg_evolution": "演化账本(每次修改 = 补一条缺失条件;可 rollback 留痕;需 evolution op)。",
68
- "mdcg_restore": "恢复被 forget 的节点(在删除清单中且未 force 则拒绝)。",
69
- "mdcg_health": "健康度(分桶健康 + CCG 完整度 + 验证基底覆盖 + OS 指标)。",
70
- "mdcg_whoami": "身份与权限(tenant/actor/clearance/可见节点/可读密级)。",
71
- "mdcg_ingest": "设备驱动:从会话文件增量摄取事件(fix-pair 挖掘 + watermark 去重)。",
72
- "mdcg_watermarks": "各事件源的摄取水位(增量摄取状态,可审计)。",
73
- "mdcg_whitebox": "白箱能力库调用与能力验证(ask|remember|verify_*|ping|report)。",
74
- "mdcg_service_info": "服务信息(身份/版本/根目录/节点统计/工具数/权限)。",
75
- }
76
-
77
- # --------------------------------------------------------------------------
78
- # 投影规则
79
- # --------------------------------------------------------------------------
80
- _ENUM_RE = re.compile(r"[A-Za-z_][\w\-]*(?:\|[A-Za-z_][\w\-]*)+")
81
- _OP_SEC_RE = re.compile(r"op=([a-z_]+):(.+?)(?=op=[a-z_]+:|$)", re.S)
82
-
83
- GENERIC_LIMIT = 24 # 通用参数(k/limit/tags/importance…)保留首段长度
84
- OP_SPECIFIC_LIMIT = 12 # op 专属参数(长尾)压缩长度;超此长度整体外置
85
- ENUM_PLACEHOLDER = "取值随 op 变化,完整枚举见 op=help"
86
-
87
- # 高频参数:无论描述是否带 op 前缀,都按「通用」处理(保留短提示)
88
- # ——这些是每次调用都可能要传的旋钮,让 agent 靠 schema 就能用起来。
89
- GENERIC_PARAMS = frozenset({
90
- "op", "action", "query", "content", "node_id", "k", "limit", "intent",
91
- "tags", "importance", "layer", "pid", "reason", "force", "dry_run",
92
- "session", "note", "evidence", "verdict", "decision", "content_kind",
93
- "budget_tokens", "text", "path", "role", "subject",
94
- })
95
-
96
-
97
- # 生效条件:desc 为 None/空串等假值时按 `desc or ""` 回落空串、`_OP_SEC_RE.finditer` 无匹配而返回空 dict;否则以每个匹配的组 1 为键、组 2 去首尾空白并去掉结尾「;/;」后为值填入并返回。
98
- def op_sections(desc):
99
- """从工具 description 里切出 {op: 段落}(机械切分,无损)。"""
100
- out = {}
101
- for m in _OP_SEC_RE.finditer(desc or ""):
102
- out[m.group(1)] = m.group(2).strip().rstrip(";;")
103
- return out
104
-
105
-
106
- # 生效条件:tools 为空时可迭代但无元素、返回空 set;否则遍历每个工具,并入其 `t.get("description") or ""` 经 op_sections 得到的键,以及其 `(t.get("inputSchema") or {}).get("properties") or {}` 中名为 op/action 的属性 description(缺省 "")里 `_ENUM_RE` 匹配串按 "|" 拆出的词,返回并集 vocab。
107
- def op_vocab(tools):
108
- """全量 op 词汇表(用于判定「这是 op 专属参数的描述」)。"""
109
- vocab = set()
110
- for t in tools:
111
- vocab |= set(op_sections(t.get("description") or ""))
112
- props = (t.get("inputSchema") or {}).get("properties") or {}
113
- for key, spec in props.items():
114
- if key in ("op", "action"):
115
- d = spec.get("description") or ""
116
- for m in _ENUM_RE.finditer(d):
117
- vocab |= set(m.group(0).split("|"))
118
- return vocab
119
-
120
-
121
- # 生效条件:head=(desc or "")[:prefix_len](desc 假值即空串、prefix_len 默认 18),当 vocab 中存在长度 ≥3 且作为子串出现在 head 中的元素时返回 True,否则(含 vocab 为空)返回 False。
122
- def _is_op_specific(desc, vocab, prefix_len=18):
123
- head = (desc or "")[:prefix_len]
124
- return any(len(o) >= 3 and o in head for o in vocab)
125
-
126
-
127
- # 生效条件:desc 为假值返回 None;否则空白归一化后按 _ENUM_RE 结果分派——恰 1 组返回该组、多于 1 组返回 ENUM_PLACEHOLDER、0 组时若 op_specific 为真则 d 长度 ≤OP_SPECIFIC_LIMIT 原样返回否则 None,若 op_specific 为假则 d 长度 >GENERIC_LIMIT 时返回 d[:GENERIC_LIMIT].rstrip()+"…"、否则原样返回 d。
128
- def short_desc(desc, vocab, op_specific=False):
129
- """投影一条参数描述。
130
-
131
- 返回 None 表示「整体外置」——该参数(长尾 op 专属)的描述不进常驻面,
132
- 由 ``cg(op=help, query="<参数名>")`` 按需取回。
133
- """
134
- if not desc:
135
- return None
136
- d = " ".join(str(desc).split())
137
- groups = _ENUM_RE.findall(d)
138
- if len(groups) == 1:
139
- return groups[0]
140
- if len(groups) > 1:
141
- return ENUM_PLACEHOLDER
142
- if op_specific:
143
- # 长尾参数:短的原样留(信息本就少),长的一句话整体外置。
144
- return d if len(d) <= OP_SPECIFIC_LIMIT else None
145
- if len(d) > GENERIC_LIMIT:
146
- return d[:GENERIC_LIMIT].rstrip() + "…"
147
- return d
148
-
149
-
150
- # 生效条件:tool 的 "inputSchema" 键存在且值为真时原样返回该值;键缺失或值为 None/{} 等假值时按 `or {}` 回落返回空 dict。
151
- def _schema_of(tool):
152
- return tool.get("inputSchema") or {}
153
-
154
-
155
- # 生效条件:tool 须含 "name" 键(缺失即 KeyError),desc=`tool.get("description") or ""`、isch=`_schema_of(tool)`;逐条属性去掉 "_req" 键后,若其 description 为真则按「key 在 GENERIC_PARAMS 或 `not _is_op_specific(d, vocab)`」判为 generic,再经 short_desc 投影——非空则替换 description、空则弹出该 description 键;返回 name 与 `TOOL_BRIEFS.get(name) or _first_sentence(desc,140)` 的 description,inputSchema 的 type 取 `isch.get("type") or "object"`,仅当 required 非空时才带 "required"。
156
- def slim_tool(tool, vocab):
157
- """投影单个工具(不修改入参)。"""
158
- name = tool["name"]
159
- desc = tool.get("description") or ""
160
- isch = _schema_of(tool)
161
- req = list(isch.get("required") or [])
162
- props = isch.get("properties") or {}
163
- new_props = {}
164
- for key, spec in props.items():
165
- clean = {k: v for k, v in spec.items() if k != "_req"}
166
- d = clean.get("description")
167
- if d:
168
- generic = key in GENERIC_PARAMS or not _is_op_specific(d, vocab)
169
- short = short_desc(d, vocab, op_specific=not generic)
170
- if short:
171
- clean["description"] = short
172
- else:
173
- clean.pop("description", None)
174
- new_props[key] = clean
175
- out_schema = {"type": isch.get("type") or "object", "properties": new_props}
176
- if req:
177
- out_schema["required"] = req
178
- return {"name": name, "description": TOOL_BRIEFS.get(name) or _first_sentence(desc, 140),
179
- "inputSchema": out_schema}
180
-
181
-
182
- # 生效条件:d=折叠 (desc or "") 空白,按 "。"、";"、";" 顺序取各字符在 d 中 `find` 的首次出现位置 i,遇到首个满足 0<i<=limit 者即返回 d[:i+1];三个字符的首次位置均不满足时,len(d)>limit 返回 d[:limit].rstrip()+"…",否则原样返回 d(limit=0 时无 i 满足,d 非空则返回 "…")。
183
- def _first_sentence(desc, limit):
184
- d = " ".join((desc or "").split())
185
- for ch in ("。", ";", ";"):
186
- i = d.find(ch)
187
- if 0 < i <= limit:
188
- return d[:i + 1]
189
- return (d[:limit].rstrip() + "…") if len(d) > limit else d
190
-
191
-
192
- # 生效条件:环境变量 FULL_ENV 取值 `(os.environ.get(FULL_ENV) or "").strip().lower()=="full"`(未设或设为空串均不成立)时原样返回入参 tools;否则以 tools 算出 vocab 并返回 `[slim_tool(t, vocab) for t in tools]`(tools 为空则返回空列表)。
193
- def slim_tools(tools):
194
- """投影整个工具面。MDCG_TOOL_FACE=full 时原样返回(调试/兼容)。"""
195
- if (os.environ.get(FULL_ENV) or "").strip().lower() == "full":
196
- return tools
197
- vocab = op_vocab(tools)
198
- return [slim_tool(t, vocab) for t in tools]
199
-
200
-
201
- # --------------------------------------------------------------------------
202
- # 按需披露:cg(op=help, query=…)
203
- # --------------------------------------------------------------------------
204
- # 生效条件:取 `_schema_of(tool)` 的 properties,仅保留 description(缺省 "")满足 `_is_op_specific(desc, {op})` 的属性,每项记为 name/type/required(k in required)/desc,返回该列表的 `out[:limit]` 切片(limit 默认 40,limit=0 得空列表,负值从尾部削减)。
205
- def _params_for(tool, op, limit=40):
206
- isch = _schema_of(tool)
207
- props = isch.get("properties") or {}
208
- req = set(isch.get("required") or [])
209
- vocab = {op}
210
- out = [{"name": k, "type": v.get("type"), "required": k in req,
211
- "desc": v.get("description") or ""}
212
- for k, v in props.items()
213
- if _is_op_specific(v.get("description") or "", vocab)]
214
- return out[:limit]
215
-
216
-
217
- # 生效条件:tools 用于建 `by_name={t["name"]: t}`(某工具缺 "name" 即 KeyError),q=(query or "").strip()——q 为空串返回 {"ok":True,"tool_index":[每工具 name 与 `TOOL_BRIEFS.get(name) or _first_sentence(desc,120)`],"usage":...};q 等于某工具名时返回该工具的 description/ops(op_sections 键排序)/params/required;否则逐工具收集「q 出现在 op 段落键中」与「pname==q 或 len(q)>=4 且 pname 以 q 开头」两类命中(不互斥、可同时追加),全部工具遍历后无命中返回 {"ok":False,"error",...,"hint",...},有命中返回 {"ok":True,"query":q,"hits":hits[:max(1, limit)]}(limit≤1 时按 1 条截取)。
218
- def help_text(tools, query=None, limit=40):
219
- """从**完整真源**按需渲染说明——被投影掉的原文在此无损取回。"""
220
- q = (query or "").strip()
221
- by_name = {t["name"]: t for t in tools}
222
- if not q:
223
- return {"ok": True,
224
- "tool_index": [{"name": t["name"],
225
- "brief": TOOL_BRIEFS.get(t["name"])
226
- or _first_sentence(t.get("description") or "", 120)}
227
- for t in tools],
228
- "usage": 'query 取 op 名 / 参数名 / 工具名,例如 '
229
- 'cg(op="help", query="write")'}
230
- if q in by_name:
231
- t = by_name[q]
232
- isch = _schema_of(t)
233
- props = isch.get("properties") or {}
234
- req = list(isch.get("required") or [])
235
- return {"ok": True, "tool": t["name"],
236
- "description": t.get("description") or "",
237
- "ops": sorted(op_sections(t.get("description") or "")),
238
- "params": [{"name": k, "type": v.get("type"),
239
- "required": k in req,
240
- "desc": v.get("description") or ""}
241
- for k, v in props.items()],
242
- "required": req}
243
- hits = []
244
- for t in tools:
245
- isch = _schema_of(t)
246
- props = isch.get("properties") or {}
247
- req = set(isch.get("required") or [])
248
- secs = op_sections(t.get("description") or "")
249
- if q in secs:
250
- hits.append({"tool": t["name"], "op": q, "doc": secs[q],
251
- "params": _params_for(t, q, limit)})
252
- # 不短路:op 名与参数名同名时(如 goal/ref/consistency),两者都要能取回。
253
- for pname, spec in props.items():
254
- if pname == q or (len(q) >= 4 and pname.startswith(q)):
255
- hits.append({"tool": t["name"], "param": pname,
256
- "type": spec.get("type"), "required": pname in req,
257
- "desc": spec.get("description") or ""})
258
- if not hits:
259
- return {"ok": False, "error": f"未找到 op / 参数 / 工具:{q}",
260
- "hint": "cg(op=help) 不带 query 可列出全部工具与一行职责"}
1
+ # -*- coding: utf-8 -*-
2
+ """工具面渐进披露(pi ① 上下文经济学 · 灵枢落地)。
3
+
4
+ 【为什么】
5
+ MCP 工具的 op 参数空间全量 schema 常驻调用方上下文:kernel 暴露面(cg+stg)
6
+ 达 ~20k 字符,其中 cg 一个工具的参数面就占绝大部分——绝大多数是「长尾 op 专属
7
+ 参数的解释文字」,只在少数场景才需要,却每次会话都要付费注入。
8
+ (此处**不写死参数个数**:修前写的「169 个参数」早已陈旧,与 schema 实况不符。)
9
+
10
+ pi 的做法(`system-prompt.ts:82-84` 工具只以一行 snippet 常驻系统提示,完整描述
11
+ 只进 API tools 字段;`skills.ts:355-383` 索引常驻、正文按需 read)证明:
12
+ **常驻面只需「我知道它存在、且知道怎么问」**,完整语义按需取回即可。
13
+
14
+ 【怎么做 · 信息零丢失】
15
+ 本模块**不改 schema 真源**(`mcp_server.KERNEL_TOOLS` / `TOOLS` 仍是完整定义),
16
+ 只做运行时**投影**:
17
+ · 工具 description → `TOOL_BRIEFS` 一行职责(缺省回退首句);
18
+ · 参数 description → 短提示:通用参数保留首段(≤30 字符)、op 专属参数压到
19
+ ≤16 字符,枚举型参数保留**完整值集**(值集是调用契约,不可省);
20
+ · 顺带剔除 `_req`(`_p()` 写的内部标记,本不该出现在对外 schema)。
21
+ 被投影掉的原文既不复制也不搬运——`cg(op=help, query=…)` 直接从真源渲染,
22
+ 故不存在第二真源、无漂移面,信息守恒是结构性的而非靠人工维护。
23
+
24
+ 【守卫】`md_cg/test_tool_face.py` 机械断言:注入面 ≥50% 削减 + 工具名/参数名/
25
+ required/类型/枚举值集逐位不变 + 每个被投影掉的参数描述都能由 op=help 无损取回。
26
+
27
+ 【关闭】`MDCG_TOOL_FACE=full` 返回完整真源(调试/兼容)。
28
+ """
29
+ from __future__ import annotations
30
+
31
+ import os
32
+ import re
33
+
34
+ from . import op_table as _ot
35
+
36
+ FULL_ENV = "MDCG_TOOL_FACE"
37
+
38
+ # --------------------------------------------------------------------------
39
+ # 一行职责(唯一手写面:必须由人写,不能机械生成)
40
+ # --------------------------------------------------------------------------
41
+ CG_HELP_HINT = '完整 op/参数语义:cg(op="help", query="<op 名 | 参数名 | 工具名>")'
42
+
43
+
44
+ # 生效条件:无入参;返回 cg 的一行职责(op 计数由 `md_cg/op_table.py` 的
45
+ # `_OP_TABLE` **动态**派生,不再写死数字——issue #133 + #140:修前这里写死的
46
+ # 计数早已陈旧(与枚举串/段落/dispatch 三方互不对账)。
47
+ def cg_brief() -> str:
48
+ return ("灵枢认知图唯一入口(%d op:写/读/审/护/演化/元认知/预测/白箱/验证态 status/"
49
+ "三元组反查 edges…)。" % len(_ot.op_names())) + CG_HELP_HINT
50
+
51
+
52
+ TOOL_BRIEFS = {
53
+ "cg": cg_brief(),
54
+ # stg 的 op 计数同样由单点表派生(issue #133 + #140)。
55
+ "stg": ("语义时空图 %d op:%s。" % (len(_ot.stg_ops()), "|".join(_ot.stg_ops()))
56
+ + CG_HELP_HINT),
57
+ "mdcg_remember": "写入记忆节点(gated=true 走主动遗忘闸门;正文建议含 CCG 五要素)。",
58
+ "mdcg_recall": "按 token 预算召回记忆包(RRF 多路融合,可开模糊/条件语义路与查询扩展)。",
59
+ "mdcg_search": "精确检索(T0–T3 阶梯 + 四态资格判定)。",
60
+ "mdcg_get": "按 id 读取单个节点(frontmatter + content)。",
61
+ "mdcg_reflect": "记录信息差 D(t,C) 与二阶 d²D/dt²(写 _reflection.jsonl)。",
62
+ "mdcg_verify": "节点外部裁决 confirmed/weakened/falsified(falsified 入负记忆)。",
63
+ "mdcg_flywheel": "误差(预期 vs 实际)转为 unresolved 条目,驱动补条件。",
64
+ "mdcg_mine_fix_pairs": "从行为日志挖掘「错误→修复」对(产修复知识 + 负记忆)。",
65
+ "mdcg_rejected": "写入负记忆(被证伪假设),同内容幂等。",
66
+ "mdcg_unresolved": "写入未解问题(驱动主动探索)。",
67
+ "mdcg_propose": "候选记忆入审核队列(海马体 inbox)。",
68
+ "mdcg_review_list": "列出待审核候选(红队打回者带 needs_reapproval;需 review op)。",
69
+ "mdcg_review_decide": "审核裁决 accept|reject|edit|merge(redteam 打回需再审批)。",
70
+ "mdcg_review_records": "裁决记录审计(可复核 record_hash 一致性)。",
71
+ "mdcg_forget": "软删除(tombstone → trash/,受保护节点需 override)。",
72
+ "mdcg_protect": "写保护:stats|check|mark|snapshot|history|forgetting(需 protect op;mark 还需 admin)。",
73
+ "mdcg_forgetting_history": "主动遗忘裁决留痕(四态 + 三问判据;需 protect op)。",
74
+ "mdcg_identity": "身份特征识别(self/user/role/agent 的锚点、位置效应、条件特征)。",
75
+ "mdcg_consistency": "节点间冲突检测(L0 情绪 → L1 反思 → L2 递归反思;可投飞轮)。",
76
+ "mdcg_metacognition": "独立元认知(情绪/校准/盲区/信任四面;只读留痕)。",
77
+ "mdcg_self_state": "自我状态层(薄自我 + 富索引:状态卡单例 + 关系节点)。",
78
+ "mdcg_predict": "生成式预测(候选未来;过滤门 + 四维评分 + 命中反馈校准)。",
79
+ "mdcg_causal": "因果推理(causal 边 = 条件依赖;path|gate|chain|explain)。",
80
+ "mdcg_evolution": "演化账本(每次修改 = 补一条缺失条件;可 rollback 留痕;需 evolution op)。",
81
+ "mdcg_restore": "恢复被 forget 的节点(在删除清单中且未 force 则拒绝)。",
82
+ "mdcg_health": "健康度(分桶健康 + CCG 完整度 + 验证基底覆盖 + OS 指标)。",
83
+ "mdcg_whoami": "身份与权限(tenant/actor/clearance/可见节点/可读密级)。",
84
+ "mdcg_ingest": "设备驱动:从会话文件增量摄取事件(fix-pair 挖掘 + watermark 去重)。",
85
+ "mdcg_watermarks": "各事件源的摄取水位(增量摄取状态,可审计)。",
86
+ "mdcg_whitebox": "白箱能力库调用与能力验证(ask|remember|verify_*|ping|report)。",
87
+ "mdcg_service_info": "服务信息(身份/版本/根目录/节点统计/工具数/权限)。",
88
+ }
89
+
90
+ # --------------------------------------------------------------------------
91
+ # 投影规则
92
+ # --------------------------------------------------------------------------
93
+ _ENUM_RE = re.compile(r"[A-Za-z_][\w\-]*(?:\|[A-Za-z_][\w\-]*)+")
94
+ _OP_SEC_RE = re.compile(r"op=([a-z_]+):(.+?)(?=op=[a-z_]+:|$)", re.S)
95
+
96
+ GENERIC_LIMIT = 24 # 通用参数(k/limit/tags/importance…)保留首段长度
97
+ OP_SPECIFIC_LIMIT = 12 # op 专属参数(长尾)压缩长度;超此长度整体外置
98
+ ENUM_PLACEHOLDER = "取值随 op 变化,完整枚举见 op=help"
99
+
100
+ # 高频参数:无论描述是否带 op 前缀,都按「通用」处理(保留短提示)
101
+ # ——这些是每次调用都可能要传的旋钮,让 agent 靠 schema 就能用起来。
102
+ GENERIC_PARAMS = frozenset({
103
+ "op", "action", "query", "content", "node_id", "k", "limit", "intent",
104
+ "tags", "importance", "layer", "pid", "reason", "force", "dry_run",
105
+ "session", "note", "evidence", "verdict", "decision", "content_kind",
106
+ "budget_tokens", "text", "path", "role", "subject",
107
+ })
108
+
109
+
110
+ # 生效条件:desc 为 None/空串等假值时按 `desc or ""` 回落空串、`_OP_SEC_RE.finditer` 无匹配而返回空 dict;否则以每个匹配的组 1 为键、组 2 去首尾空白并去掉结尾「;/;」后为值填入并返回。
111
+ def op_sections(desc):
112
+ """从工具 description 里切出 {op: 段落}(机械切分,无损)。"""
113
+ out = {}
114
+ for m in _OP_SEC_RE.finditer(desc or ""):
115
+ out[m.group(1)] = m.group(2).strip().rstrip(";;")
116
+ return out
117
+
118
+
119
+ # 生效条件:tools 为空时可迭代但无元素、返回空 set;否则遍历每个工具,并入其 `t.get("description") or ""` 经 op_sections 得到的键,以及其 `(t.get("inputSchema") or {}).get("properties") or {}` 中名为 op/action 的属性 description(缺省 "")里 `_ENUM_RE` 匹配串按 "|" 拆出的词,返回并集 vocab。
120
+ def op_vocab(tools):
121
+ """全量 op 词汇表(用于判定「这是 op 专属参数的描述」)。"""
122
+ vocab = set()
123
+ for t in tools:
124
+ vocab |= set(op_sections(t.get("description") or ""))
125
+ props = (t.get("inputSchema") or {}).get("properties") or {}
126
+ for key, spec in props.items():
127
+ if key in ("op", "action"):
128
+ d = spec.get("description") or ""
129
+ for m in _ENUM_RE.finditer(d):
130
+ vocab |= set(m.group(0).split("|"))
131
+ return vocab
132
+
133
+
134
+ # 生效条件:head=(desc or "")[:prefix_len](desc 假值即空串、prefix_len 默认 18),当 vocab 中存在长度 ≥3 且作为子串出现在 head 中的元素时返回 True,否则(含 vocab 为空)返回 False。
135
+ def _is_op_specific(desc, vocab, prefix_len=18):
136
+ head = (desc or "")[:prefix_len]
137
+ return any(len(o) >= 3 and o in head for o in vocab)
138
+
139
+
140
+ # 生效条件:desc 为假值返回 None;否则空白归一化后按 _ENUM_RE 结果分派——恰 1 组返回该组、多于 1 组返回 ENUM_PLACEHOLDER、0 组时若 op_specific 为真则 d 长度 ≤OP_SPECIFIC_LIMIT 原样返回否则 None,若 op_specific 为假则 d 长度 >GENERIC_LIMIT 时返回 d[:GENERIC_LIMIT].rstrip()+"…"、否则原样返回 d。
141
+ def short_desc(desc, vocab, op_specific=False):
142
+ """投影一条参数描述。
143
+
144
+ 返回 None 表示「整体外置」——该参数(长尾 op 专属)的描述不进常驻面,
145
+ 由 ``cg(op=help, query="<参数名>")`` 按需取回。
146
+ """
147
+ if not desc:
148
+ return None
149
+ d = " ".join(str(desc).split())
150
+ groups = _ENUM_RE.findall(d)
151
+ if len(groups) == 1:
152
+ return groups[0]
153
+ if len(groups) > 1:
154
+ return ENUM_PLACEHOLDER
155
+ if op_specific:
156
+ # 长尾参数:短的原样留(信息本就少),长的一句话整体外置。
157
+ return d if len(d) <= OP_SPECIFIC_LIMIT else None
158
+ if len(d) > GENERIC_LIMIT:
159
+ return d[:GENERIC_LIMIT].rstrip() + "…"
160
+ return d
161
+
162
+
163
+ # 生效条件:tool 的 "inputSchema" 键存在且值为真时原样返回该值;键缺失或值为 None/{} 等假值时按 `or {}` 回落返回空 dict。
164
+ def _schema_of(tool):
165
+ return tool.get("inputSchema") or {}
166
+
167
+
168
+ # 生效条件:tool 须含 "name" 键(缺失即 KeyError),desc=`tool.get("description") or ""`、isch=`_schema_of(tool)`;逐条属性去掉 "_req" 键后,若其 description 为真则按「key 在 GENERIC_PARAMS 或 `not _is_op_specific(d, vocab)`」判为 generic,再经 short_desc 投影——非空则替换 description、空则弹出该 description 键;返回 name 与 `TOOL_BRIEFS.get(name) or _first_sentence(desc,140)` 的 description,inputSchema 的 type 取 `isch.get("type") or "object"`,仅当 required 非空时才带 "required"。
169
+ def slim_tool(tool, vocab):
170
+ """投影单个工具(不修改入参)。"""
171
+ name = tool["name"]
172
+ desc = tool.get("description") or ""
173
+ isch = _schema_of(tool)
174
+ req = list(isch.get("required") or [])
175
+ props = isch.get("properties") or {}
176
+ new_props = {}
177
+ for key, spec in props.items():
178
+ clean = {k: v for k, v in spec.items() if k != "_req"}
179
+ d = clean.get("description")
180
+ if d:
181
+ generic = key in GENERIC_PARAMS or not _is_op_specific(d, vocab)
182
+ short = short_desc(d, vocab, op_specific=not generic)
183
+ if short:
184
+ clean["description"] = short
185
+ else:
186
+ clean.pop("description", None)
187
+ new_props[key] = clean
188
+ out_schema = {"type": isch.get("type") or "object", "properties": new_props}
189
+ if req:
190
+ out_schema["required"] = req
191
+ return {"name": name, "description": TOOL_BRIEFS.get(name) or _first_sentence(desc, 140),
192
+ "inputSchema": out_schema}
193
+
194
+
195
+ # 生效条件:d=折叠 (desc or "") 空白,按 "。"、";"、";" 顺序取各字符在 d 中 `find` 的首次出现位置 i,遇到首个满足 0<i<=limit 者即返回 d[:i+1];三个字符的首次位置均不满足时,len(d)>limit 返回 d[:limit].rstrip()+"…",否则原样返回 d(limit=0 时无 i 满足,d 非空则返回 "…")。
196
+ def _first_sentence(desc, limit):
197
+ d = " ".join((desc or "").split())
198
+ for ch in ("。", ";", ";"):
199
+ i = d.find(ch)
200
+ if 0 < i <= limit:
201
+ return d[:i + 1]
202
+ return (d[:limit].rstrip() + "…") if len(d) > limit else d
203
+
204
+
205
+ # 生效条件:环境变量 FULL_ENV 取值 `(os.environ.get(FULL_ENV) or "").strip().lower()=="full"`(未设或设为空串均不成立)时原样返回入参 tools;否则以 tools 算出 vocab 并返回 `[slim_tool(t, vocab) for t in tools]`(tools 为空则返回空列表)。
206
+ def slim_tools(tools):
207
+ """投影整个工具面。MDCG_TOOL_FACE=full 时原样返回(调试/兼容)。"""
208
+ if (os.environ.get(FULL_ENV) or "").strip().lower() == "full":
209
+ return tools
210
+ vocab = op_vocab(tools)
211
+ return [slim_tool(t, vocab) for t in tools]
212
+
213
+
214
+ # --------------------------------------------------------------------------
215
+ # 按需披露:cg(op=help, query=…)
216
+ # --------------------------------------------------------------------------
217
+ # 生效条件:取 `_schema_of(tool)` 的 properties,仅保留 description(缺省 "")满足 `_is_op_specific(desc, {op})` 的属性,每项记为 name/type/required(k in required)/desc,返回该列表的 `out[:limit]` 切片(limit 默认 40,limit=0 得空列表,负值从尾部削减)。
218
+ def _params_for(tool, op, limit=40):
219
+ isch = _schema_of(tool)
220
+ props = isch.get("properties") or {}
221
+ req = set(isch.get("required") or [])
222
+ vocab = {op}
223
+ out = [{"name": k, "type": v.get("type"), "required": k in req,
224
+ "desc": v.get("description") or ""}
225
+ for k, v in props.items()
226
+ if _is_op_specific(v.get("description") or "", vocab)]
227
+ return out[:limit]
228
+
229
+
230
+ # 生效条件:tools 用于建 `by_name={t["name"]: t}`(某工具缺 "name" 即 KeyError),q=(query or "").strip()——q 为空串返回 {"ok":True,"tool_index":[每工具 name 与 `TOOL_BRIEFS.get(name) or _first_sentence(desc,120)`],"usage":...};q 等于某工具名时返回该工具的 description/ops(op_sections 键排序)/params/required;否则逐工具收集「q 出现在 op 段落键中」与「pname==q 或 len(q)>=4 且 pname 以 q 开头」两类命中(不互斥、可同时追加),全部工具遍历后无命中返回 {"ok":False,"error",...,"hint",...},有命中返回 {"ok":True,"query":q,"hits":hits[:max(1, limit)]}(limit≤1 时按 1 条截取)。
231
+ def help_text(tools, query=None, limit=40):
232
+ """从**完整真源**按需渲染说明——被投影掉的原文在此无损取回。"""
233
+ q = (query or "").strip()
234
+ by_name = {t["name"]: t for t in tools}
235
+ if not q:
236
+ return {"ok": True,
237
+ "tool_index": [{"name": t["name"],
238
+ "brief": TOOL_BRIEFS.get(t["name"])
239
+ or _first_sentence(t.get("description") or "", 120)}
240
+ for t in tools],
241
+ "usage": 'query 取 op 名 / 参数名 / 工具名,例如 '
242
+ 'cg(op="help", query="write")'}
243
+ if q in by_name:
244
+ t = by_name[q]
245
+ isch = _schema_of(t)
246
+ props = isch.get("properties") or {}
247
+ req = list(isch.get("required") or [])
248
+ return {"ok": True, "tool": t["name"],
249
+ "description": t.get("description") or "",
250
+ "ops": sorted(op_sections(t.get("description") or "")),
251
+ "params": [{"name": k, "type": v.get("type"),
252
+ "required": k in req,
253
+ "desc": v.get("description") or ""}
254
+ for k, v in props.items()],
255
+ "required": req}
256
+ hits = []
257
+ for t in tools:
258
+ isch = _schema_of(t)
259
+ props = isch.get("properties") or {}
260
+ req = set(isch.get("required") or [])
261
+ secs = op_sections(t.get("description") or "")
262
+ if q in secs:
263
+ hits.append({"tool": t["name"], "op": q, "doc": secs[q],
264
+ "params": _params_for(t, q, limit)})
265
+ # 不短路:op 名与参数名同名时(如 goal/ref/consistency),两者都要能取回。
266
+ for pname, spec in props.items():
267
+ if pname == q or (len(q) >= 4 and pname.startswith(q)):
268
+ hits.append({"tool": t["name"], "param": pname,
269
+ "type": spec.get("type"), "required": pname in req,
270
+ "desc": spec.get("description") or ""})
271
+ if not hits:
272
+ return {"ok": False, "error": f"未找到 op / 参数 / 工具:{q}",
273
+ "hint": "cg(op=help) 不带 query 可列出全部工具与一行职责"}
261
274
  return {"ok": True, "query": q, "hits": hits[:max(1, limit)]}