@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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 (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  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 +139 -139
  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 +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  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 +51 -3
  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 +28 -2
  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 +15 -2
  34. package/lib/tools.js +44 -4
  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 +37 -7
  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 +573 -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 +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  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 +262 -251
  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 +426 -345
  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 +7108 -5440
  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 +1103 -1100
  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 +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  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 +613 -604
  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 +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  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 +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  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 +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  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 +2013 -1973
  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_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. 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
  532. 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
  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_v1.0.md +0 -299
  534. 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
  535. 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
  536. 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
  537. 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
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. 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
  540. 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
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. 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
  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.0.md +0 -223
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  573. 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
  574. 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 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. 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
  577. 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
  578. 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
  579. 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
  580. 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
  581. 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
  582. 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
  583. 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
  584. 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
  585. 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
  586. 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
  587. 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
  588. 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
  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_v1.md +0 -156
  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_v10.md +0 -210
  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_v11.md +0 -227
  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_v12.md +0 -203
  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_v13.md +0 -233
  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_v14.md +0 -191
  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_v15.md +0 -213
  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_v16.md +0 -214
  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_v17.md +0 -199
  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_v18.md +0 -183
  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_v19.md +0 -207
  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_v2.md +0 -156
  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_v20.md +0 -283
  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_v21.md +0 -224
  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_v22.md +0 -223
  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_v23.md +0 -293
  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_v24.md +0 -303
  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_v25.md +0 -230
  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_v26.md +0 -196
  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_v27.md +0 -259
  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_v28.md +0 -217
  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_v29.md +0 -270
  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_v3.md +0 -152
  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_v30.md +0 -231
  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_v31.md +0 -281
  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_v4.md +0 -128
  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_v5.md +0 -114
  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_v6.md +0 -192
  617. 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
  618. 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
  619. 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
  620. 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
  621. 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
  622. 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
  623. 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
  624. 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
  625. 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
  626. 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
  627. 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
  628. 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
  629. 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
  630. 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
  631. 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
  632. 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
  633. 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
  634. 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
  635. 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
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. 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
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. 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
  650. 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
  651. 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
  652. 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
  653. 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
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. 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
  656. 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
  657. 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
  658. 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
  659. 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
  660. 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
  661. 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
  662. 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
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. 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
  665. 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
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. 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
  672. 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
  673. 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
  674. 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
  675. 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
  676. 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
  677. 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
  678. 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
  679. 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
  680. 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
  681. 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
  682. 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
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. 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
  691. 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
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. 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
  698. 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
  699. 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
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. 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
  702. 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
  703. 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
  704. 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
  705. 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
  706. 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
  707. 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
  708. 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
  709. 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
  710. 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
  711. 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
  712. 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
  713. 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
  714. 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
  715. 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
  716. 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
  717. 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)]}