@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
package/md_cg/whitebox.py CHANGED
@@ -1,528 +1,537 @@
1
- # -*- coding: utf-8 -*-
2
- """md_cg · 白箱能力调用与验证(显式调用层)。
3
-
4
- 架构定位(2026-09-10 修订)
5
- --------------------------
6
- · md_cg = 记忆操作系统 / **唯一真源**:负责记忆的写、读、裁决、留痕。
7
- · 白箱知识库 = **随主仓自带**(`md_cg/whitebox_kb/`,原理论仓 `aeis/wisdom`
8
- 等内迁):不再需要外部 `aeis` 包,也不再需要跨库调用。
9
- · AEIS = **身体 / 世界模型库**:本层不再依赖它(自带内核中 vision / body /
10
- world_model 等均为方法内惰性导入,缺失即自动降级)。
11
-
12
- 为什么单独成层
13
- --------------
14
- 白箱需要一个可审计的调用入口。本模块是「md_cg 调用白箱」的**唯一显式入口**:
15
- · 调用方式:**进程内**直调自带引擎(默认,见 `LocalWhiteboxClient`);
16
- 仅当显式设置 `MDCG_WHITEBOX_CMD` / `MDCG_WHITEBOX_ARGS` 时,
17
- 才回退外部 MCP stdio 子进程(legacy 路径)。
18
- · 调用结果:验证结论写回认知图(self 层,tags 含 `whitebox:verify`),可追溯。
19
-
20
- 显式调用映射(详见 docs/mdcg/功能调用映射表_v0.1.md)
21
- ------------------------------------------------
22
- 功能 → 代码 → MCP
23
- 白箱问答 → md_cg.whitebox.ask → cg(op=whitebox, action=ask)
24
- 白箱编码 → md_cg.whitebox.remember → cg(op=whitebox, action=remember)
25
- 验证编码能力 → md_cg.whitebox.verify_encoding → cg(op=whitebox, action=verify_encoding)
26
- 验证已有知识回答能力 → md_cg.whitebox.verify_existing → cg(op=whitebox, action=verify_existing)
27
- 白箱能力验证报告 → md_cg.whitebox.report → cg(op=whitebox, action=report)
28
- 白箱连通性探测 → md_cg.whitebox.ping → cg(op=whitebox, action=ping)
29
-
30
- 环境变量
31
- --------
32
- WHITEBOX_DB / MDCG_WHITEBOX_DB 白箱图库路径
33
- (默认 MDCG_ROOT/data/whitebox/graph.db;
34
- 独立运行时落 ~/.md_cg/whitebox/graph.db,
35
- 首次以随包云库为底 + 卡源播种)
36
- MDCG_WHITEBOX_CMD 外部白箱启动命令(设置后走 legacy 子进程路径)
37
- MDCG_WHITEBOX_ARGS 外部白箱启动参数(同上,默认 "-m aeis.mcp.server")
38
- MDCG_WHITEBOX_TIMEOUT 子进程单次调用超时秒数(默认 60)
39
- """
40
-
41
- from __future__ import annotations
42
-
43
- import json
44
- import os
45
- import queue
46
- import subprocess
47
- import sys
48
- import threading
49
- import time
50
-
51
- PROTOCOL_VERSION = "2024-11-05"
52
- CLIENT_NAME = "md_cg-whitebox"
53
- VERIFY_TAG = "whitebox:verify"
54
-
55
- #: 已有知识回答能力的默认探针(白箱应能从自身知识库直接作答)。
56
- DEFAULT_KNOWLEDGE_PROBES = [
57
- "你是谁?请用一句话介绍你自己。",
58
- "什么是条件论?",
59
- ]
60
-
61
-
62
- # --------------------------------------------------------------------------
63
- # 启动命令
64
- # --------------------------------------------------------------------------
65
-
66
- # 生效条件:无必需形参;exe 取 MDCG_WHITEBOX_CMD,该值为假时取 sys.executable、再为假时取 "python",args 取 MDCG_WHITEBOX_ARGS.split()(该值为真时)否则 ["-m","aeis.mcp.server"],返回 [exe]+args。
67
- def _launch_cmd():
68
- """外部白箱 MCP server 启动命令(legacy 路径,需显式配置)。
69
-
70
- 主仓自带白箱知识库后,本路径**不再默认启用**(见 `WhiteboxClient` 工厂)。
71
- 默认参数 `-m aeis.mcp.server` 仅为兼容既有部署保留。
72
- """
73
- exe = os.environ.get("MDCG_WHITEBOX_CMD") or sys.executable or "python"
74
- raw = os.environ.get("MDCG_WHITEBOX_ARGS")
75
- args = raw.split() if raw else ["-m", "aeis.mcp.server"]
76
- return [exe] + args
77
-
78
-
79
- # --------------------------------------------------------------------------
80
- # 白箱 MCP stdio 客户端(零第三方依赖)
81
- # --------------------------------------------------------------------------
82
-
83
- # 生效条件:类无自定义 __init__(无必需构造形参);实例化后仅当子类覆写 call 时 ask/remember 才走通,否则 call 抛 NotImplementedError。
84
- class _WhiteboxApi:
85
- """白箱业务接口(`ask` / `remember`)。
86
-
87
- 两种载体共享同一实现,保证行为**按构造方式一致**(验证结论不受载体影响):
88
- · `LocalWhiteboxClient` —— 进程内直调自带引擎(默认)
89
- · `_SubprocessWhiteboxClient` —— MCP stdio 子进程(legacy,显式配置时)
90
- """
91
-
92
- # 生效条件:以 required 形参 name 与 args 调用该抽象方法时无条件抛出 NotImplementedError,不产生任何返回。
93
- def call(self, name, args):
94
- """调用白箱工具,返回 {isError, text, data}。"""
95
- raise NotImplementedError
96
-
97
- # 生效条件:给定 required 形参 message(session_id 省略时取默认 "md_cg-whitebox-verify")即转调 self.call("wisdom_chat", {...}),按返回 r 组装 {ok: not r["isError"], route: _extract_route(data), reply: _extract_reply(data, r.get("text")), raw},其中 data 由 r.get("data") or {} 得到(data 缺失或为假值时为 {}),故 raw 恒取该 data、不回落到 r.get("text")。
98
- def ask(self, message, session_id="md_cg-whitebox-verify"):
99
- """白箱问答(wisdom_chat)。返回归一化的 {ok, route, reply, raw}。"""
100
- r = self.call("wisdom_chat", {"message": message, "session_id": session_id})
101
- data = r.get("data") or {}
102
- return {"ok": not r["isError"],
103
- "route": _extract_route(data),
104
- "reply": _extract_reply(data, r.get("text")),
105
- "raw": data if data is not None else r.get("text")}
106
-
107
- # 生效条件:给定 required 形参 content(importance 省略时取 0.9 并 float() 转换;tags 为 None/[]/"" 等假值时按 tags or ["md_cg","whitebox-probe"] 回落为 list(["md_cg","whitebox-probe"]))即转调 self.call("remember", {...}),返回 {ok: not r["isError"], raw: r.get("data") or r.get("text")}。
108
- def remember(self, content, importance=0.9, tags=None):
109
- """白箱编码(remember):把一条知识交给白箱写入其记忆库。"""
110
- r = self.call("remember", {"content": content,
111
- "importance": float(importance),
112
- "tags": list(tags or ["md_cg", "whitebox-probe"])})
113
- return {"ok": not r["isError"], "raw": r.get("data") or r.get("text")}
114
-
115
-
116
- # 生效条件:以假值 cmd(None/空序列)构造时 self.cmd 取 _launch_cmd(),真值 cmd 时取 list(cmd);timeout 与 MDCG_WHITEBOX_TIMEOUT 环境变量都取假值时 self.timeout 为 float(60.0),否则取其中首个真值;env 为真值时按 str(v) 合并进 os.environ 副本,假值时 self.env 仅为 os.environ 副本。
117
- class _SubprocessWhiteboxClient(_WhiteboxApi):
118
- """外部白箱 MCP stdio 客户端(legacy 路径,需显式配置才启用)。
119
-
120
- 只做一件事:把 md_cg 的显式调用翻译成 MCP `tools/call`。
121
- 进程懒启动、调用串行化、超时即杀(下次调用自动重启)。
122
- """
123
-
124
- # 生效条件:cmd 为真值时 self.cmd=list(cmd),否则回落 _launch_cmd();timeout 为真值则直接用,否则回落 os.environ.get("MDCG_WHITEBOX_TIMEOUT"),再否则 60.0;env 为真值时其键值经 str() 合并进 os.environ 副本。
125
- def __init__(self, cmd=None, env=None, timeout=None):
126
- self.cmd = list(cmd) if cmd else _launch_cmd()
127
- self.timeout = float(timeout or os.environ.get("MDCG_WHITEBOX_TIMEOUT") or 60.0)
128
- self.env = dict(os.environ)
129
- if env:
130
- self.env.update({k: str(v) for k, v in env.items()})
131
- self.proc = None
132
- self._q = queue.Queue()
133
- self._next_id = 1
134
- self._lock = threading.Lock()
135
-
136
- # -- 生命周期 ---------------------------------------------------------
137
- # 生效条件:当 self.proc 非 None 且 self.proc.poll() 为 None 时直接返回 self;否则启动 self.cmd 子进程并以模块级常量 PROTOCOL_VERSION 与 CLIENT_NAME 发 initialize 请求和 notifications/initialized 通知后返回 self。
138
- def start(self):
139
- if self.proc is not None and self.proc.poll() is None:
140
- return self
141
- self.proc = subprocess.Popen(
142
- self.cmd,
143
- stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
144
- text=True, encoding="utf-8", errors="replace", bufsize=1, env=self.env)
145
- threading.Thread(target=self._reader, daemon=True).start()
146
- self._request("initialize", {
147
- "protocolVersion": PROTOCOL_VERSION,
148
- "capabilities": {},
149
- "clientInfo": {"name": CLIENT_NAME, "version": "0.1.0"},
150
- })
151
- self._notify("notifications/initialized", {})
152
- return self
153
-
154
- # 生效条件:幂等、可重复调用;self.proc 为 None 时直接返回;否则先关 stdin 再 terminate 并 wait(timeout=3),超时或异常则 kill 兜底;无返回值、不抛异常;
155
- def close(self):
156
- proc, self.proc = self.proc, None
157
- if proc is None:
158
- return
159
- try:
160
- if proc.stdin:
161
- proc.stdin.close()
162
- except Exception:
163
- pass
164
- try:
165
- proc.terminate()
166
- proc.wait(timeout=3)
167
- except Exception:
168
- try:
169
- proc.kill()
170
- except Exception:
171
- pass
172
-
173
- # -- 内部 IO ----------------------------------------------------------
174
- # 生效条件:self.proc 为 None 或 proc.stdout 为 None 时直接返回;否则逐行 strip 后跳过空行,非空行 json.loads 成功则放入 self._q,抛 ValueError 则跳过该行。
175
- def _reader(self):
176
- stream = self.proc.stdout if self.proc else None
177
- if stream is None:
178
- return
179
- for line in stream:
180
- line = line.strip()
181
- if not line:
182
- continue
183
- try:
184
- self._q.put(json.loads(line))
185
- except ValueError:
186
- continue
187
-
188
- # 生效条件:给定 required 形参 payload 时,若 self.proc is None 或 self.proc.poll() is not None 则抛 RuntimeError("白箱进程未运行(启动失败或已退出)"),否则把 json.dumps(payload, ensure_ascii=False) + "\n" 写入 self.proc.stdin 并 flush,无返回。
189
- def _write(self, payload):
190
- if self.proc is None or self.proc.poll() is not None:
191
- raise RuntimeError("白箱进程未运行(启动失败或已退出)")
192
- self.proc.stdin.write(json.dumps(payload, ensure_ascii=False) + "\n")
193
- self.proc.stdin.flush()
194
-
195
- # 生效条件:给定 required 形参 method 与 params 时,以 {"jsonrpc": "2.0", "method": method, "params": params}(无 id)调用 self._write,自身无返回。
196
- def _notify(self, method, params):
197
- self._write({"jsonrpc": "2.0", "method": method, "params": params})
198
-
199
- # 生效条件:给定 required 形参 method 与 params 时在 self._lock 内取自增 id 并写入请求,随后循环取 self._q:remain <= 0 或 queue.Empty 时先 self.close() 再抛 TimeoutError,msg.get("id") 不等于 rid 时 continue,msg.get("error") 为真时抛 RuntimeError,id 匹配且无 error 时返回 msg.get("result")(缺 "result" 键返回 None)。
200
- def _request(self, method, params):
201
- with self._lock:
202
- rid = self._next_id
203
- self._next_id += 1
204
- self._write({"jsonrpc": "2.0", "id": rid, "method": method,
205
- "params": params})
206
- deadline = time.time() + self.timeout
207
- while True:
208
- remain = deadline - time.time()
209
- if remain <= 0:
210
- self.close()
211
- raise TimeoutError(f"白箱调用超时({self.timeout}s):{method}")
212
- try:
213
- msg = self._q.get(timeout=remain)
214
- except queue.Empty:
215
- self.close()
216
- raise TimeoutError(f"白箱调用超时({self.timeout}s):{method}")
217
- if msg.get("id") != rid:
218
- continue
219
- if msg.get("error"):
220
- raise RuntimeError(f"白箱返回错误:{msg['error']}")
221
- return msg.get("result")
222
-
223
- # -- 业务接口 ---------------------------------------------------------
224
- # 生效条件:给定 required 形参 name 与 args(args 为假值时按 {"name": name, "arguments": args or {}} 发空字典)即以 "tools/call" 发请求,把结果 content 中 type=="text" 的块文本拼接后 json.loads,失败(ValueError/TypeError)则 data=None,返回 {"isError": bool((result or {}).get("isError")), "text": text, "data": data}。
225
- def call(self, name, args):
226
- """调用白箱 MCP 工具,返回 {isError, text, data}。"""
227
- result = self._request("tools/call", {"name": name, "arguments": args or {}})
228
- text = ""
229
- for block in (result or {}).get("content", []) or []:
230
- if isinstance(block, dict) and block.get("type") == "text":
231
- text += block.get("text") or ""
232
- try:
233
- data = json.loads(text)
234
- except (ValueError, TypeError):
235
- data = None
236
- return {"isError": bool((result or {}).get("isError")),
237
- "text": text, "data": data}
238
-
239
- # --------------------------------------------------------------------------
240
- # 进程内白箱客户端(默认路径)+ 客户端工厂
241
- # --------------------------------------------------------------------------
242
-
243
- class LocalWhiteboxClient(_WhiteboxApi):
244
- """白箱**进程内**客户端(默认载体)。
245
-
246
- 白箱知识库已随主仓自带(`md_cg/whitebox_kb/`),直接调用其引擎:
247
- 无子进程、无 MCP、无理论仓依赖。接口与子进程版完全一致,
248
- 故 `ask / remember / ping / verify_*` 及其留痕逻辑无需任何改动。
249
- """
250
-
251
- # 生效条件:db_path 为 None 时由引擎按默认路径取库;_ignored 吞掉子进程版遗留形参以保持接口同形;构造只记录路径、不加载引擎(延迟到 self.engine 首次访问);
252
- def __init__(self, db_path=None, **_ignored):
253
- self.db_path = db_path
254
- self._engine = None
255
-
256
- @property
257
- # 生效条件:self._engine 为 None 时调用 _load_get_engine()(db_path=self.db_path) 创建并缓存后返回它,非 None 时直接返回缓存实例。
258
- def engine(self):
259
- if self._engine is None:
260
- self._engine = _load_get_engine()(db_path=self.db_path)
261
- return self._engine
262
-
263
- # -- 生命周期(与子进程版语义对齐:start 即确保可用,失败即抛) --------
264
- # 生效条件:先取 self.engine(首次访问才真正加载知识库)并调 service_info() 以确认可服务,不可用即抛;成功后返回 self,可重复调用;
265
- def start(self):
266
- _ = self.engine.service_info()
267
- return self
268
-
269
- # 生效条件:幂等;self._engine 为 None 时直接返回,否则关闭引擎并置 None(只释放句柄,不删除落盘数据);
270
- def close(self):
271
- if self._engine is not None:
272
- self._engine.close()
273
- self._engine = None
274
-
275
- # -- 业务接口 ---------------------------------------------------------
276
- # 生效条件:给定 required 形参 name 与 args 时直接转调 self.engine.call_tool(name, args) 并返回其结果,不做任何形参改写或校验。
277
- def call(self, name, args):
278
- """调用白箱工具,返回 {isError, text, data}(形状对齐 MCP)。"""
279
- return self.engine.call_tool(name, args)
280
-
281
-
282
- # 生效条件:无必需形参;包内 from .whitebox_kb.engine import get_engine 成功时返回它,ImportError 时改为 from whitebox_kb.engine import get_engine 并返回。
283
- def _load_get_engine():
284
- """兼容两种导入方式(包内 / 平铺)。"""
285
- try:
286
- from .whitebox_kb.engine import get_engine
287
- except ImportError: # pragma: no cover - 平铺运行场景
288
- from whitebox_kb.engine import get_engine
289
- return get_engine
290
-
291
-
292
- # 生效条件:cmd 或 env 为真,或 MDCG_WHITEBOX_CMD / MDCG_WHITEBOX_ARGS 为真时返回 _SubprocessWhiteboxClient(cmd=cmd, env=env, timeout=timeout),否则返回 LocalWhiteboxClient(db_path=db_path)。
293
- def WhiteboxClient(cmd=None, env=None, timeout=None, db_path=None):
294
- """白箱客户端工厂。
295
-
296
- 默认返回 `LocalWhiteboxClient`(进程内 · 随仓自带知识库)。
297
- 仅当显式给出 `cmd` / `env`,或设置了 `MDCG_WHITEBOX_CMD` /
298
- `MDCG_WHITEBOX_ARGS` 时,才返回 legacy 的外部 MCP 子进程客户端。
299
- """
300
- if cmd or env or os.environ.get("MDCG_WHITEBOX_CMD") \
301
- or os.environ.get("MDCG_WHITEBOX_ARGS"):
302
- return _SubprocessWhiteboxClient(cmd=cmd, env=env, timeout=timeout)
303
- return LocalWhiteboxClient(db_path=db_path)
304
-
305
-
306
- # --------------------------------------------------------------------------
307
- # 结果归一化
308
- # --------------------------------------------------------------------------
309
-
310
- # 生效条件:data 为 dict 时按 route、mode、path 顺序取首个非空 str 值返回,否则(含 data 非 dict、三键均无或均为空/非 str)返回 ""。
311
- def _extract_route(data):
312
- if isinstance(data, dict):
313
- for key in ("route", "mode", "path"):
314
- val = data.get(key)
315
- if isinstance(val, str) and val:
316
- return val
317
- return ""
318
-
319
-
320
- # 生效条件:data 为 dict 时先按 reply/answer/text/response/content/message 取首个 strip 后非空的 str 返回,再对 result、data 两键的 dict 值递归取非空结果,均无则返回 fallback or ""。
321
- def _extract_reply(data, fallback=""):
322
- if isinstance(data, dict):
323
- for key in ("reply", "answer", "text", "response", "content", "message"):
324
- val = data.get(key)
325
- if isinstance(val, str) and val.strip():
326
- return val
327
- for key in ("result", "data"):
328
- val = data.get(key)
329
- if isinstance(val, dict):
330
- nested = _extract_reply(val, "")
331
- if nested:
332
- return nested
333
- return fallback or ""
334
-
335
-
336
- # --------------------------------------------------------------------------
337
- # 验证:编码能力 / 已有知识回答能力
338
- # --------------------------------------------------------------------------
339
-
340
- # 生效条件:client 为 None 时自建 WhiteboxClient() 并在 finally 关闭;marker、fact、question 为假值时分别用带毫秒时间戳的默认口令、默认事实、默认追问,cg 仅传给 _record(cg 为 None 则 node_id 为 None,不自建 client),异常时返回 ok=False 并同样 _record。
341
- def verify_encoding(cg=None, client=None, marker=None, fact=None,
342
- question=None, session_id="md_cg-whitebox-verify"):
343
- """验证白箱「编码能力」。
344
-
345
- 步骤:remember 一条带唯一口令的事实 → 追问口令 → 命中即通过。
346
- """
347
- own = client is None
348
- cli = client or WhiteboxClient()
349
- marker = marker or ("白箱探针" + str(int(time.time() * 1000)))
350
- fact = fact or f"md_cg 白箱编码验证:本次口令是 {marker},请记住。"
351
- question = question or "请只回答刚才记住的口令本身,不要解释。"
352
- try:
353
- cli.start()
354
- enc = cli.remember(fact, importance=0.95, tags=["md_cg", "whitebox-probe"])
355
- ans = cli.ask(question, session_id=session_id)
356
- hit = marker in (ans.get("reply") or "")
357
- out = {"kind": "encoding", "ok": bool(enc["ok"] and hit),
358
- "marker": marker, "encoded": bool(enc["ok"]),
359
- "recalled": hit, "route": ans.get("route"),
360
- "reply": (ans.get("reply") or "")[:300]}
361
- out["node_id"] = _record(cg, "encoding", out["ok"], out)
362
- return out
363
- except Exception as exc: # 白箱不可用:如实记录失败,不抛断调用方
364
- out = {"kind": "encoding", "ok": False, "marker": marker,
365
- "error": f"{type(exc).__name__}: {exc}"}
366
- out["node_id"] = _record(cg, "encoding", False, out)
367
- return out
368
- finally:
369
- if own:
370
- cli.close()
371
-
372
-
373
- # 生效条件:client 为 None 时自建 WhiteboxClient() 并在 finally 关闭;questions 为假值(None 或空)时用 DEFAULT_KNOWLEDGE_PROBES,逐问后仅当至少一问 reply 非空且 route 为 self 或 self_fallback 时 ok=True,异常返回 ok=False。
374
- def verify_existing(cg=None, client=None, questions=None,
375
- session_id="md_cg-whitebox-verify"):
376
- """验证白箱「已有知识回答能力」。
377
-
378
- 步骤:问白箱本应已知的问题 → route=self 且回答非空即通过(至少一问命中)。
379
- """
380
- own = client is None
381
- cli = client or WhiteboxClient()
382
- questions = list(questions or DEFAULT_KNOWLEDGE_PROBES)
383
- try:
384
- cli.start()
385
- probes = []
386
- for q in questions:
387
- ans = cli.ask(q, session_id=session_id)
388
- route = ans.get("route") or ""
389
- reply = ans.get("reply") or ""
390
- probes.append({"question": q, "route": route,
391
- "answered": bool(reply.strip()),
392
- "self_route": route in ("self", "self_fallback"),
393
- "reply": reply[:300]})
394
- ok = any(p["answered"] and p["self_route"] for p in probes)
395
- out = {"kind": "existing_knowledge", "ok": ok, "probes": probes}
396
- out["node_id"] = _record(cg, "existing_knowledge", ok, out)
397
- return out
398
- except Exception as exc:
399
- out = {"kind": "existing_knowledge", "ok": False,
400
- "error": f"{type(exc).__name__}: {exc}"}
401
- out["node_id"] = _record(cg, "existing_knowledge", False, out)
402
- return out
403
- finally:
404
- if own:
405
- cli.close()
406
-
407
-
408
- # 生效条件:client 为 None 时自建 WhiteboxClient() 并在 finally 关闭;依次对 service_info、mdcg_service_info、info 调用 call,首个 isError 为假即返回 ok=True 与该 tool/info,全部不可用返回 ok=False,start 或整体异常返回 ok=False。
409
- def ping(client=None, session_id="md_cg-whitebox-ping"):
410
- """白箱连通性探测:调 service_info(或 info)判断能力库是否在线。"""
411
- own = client is None
412
- cli = client or WhiteboxClient()
413
- try:
414
- cli.start()
415
- for name in ("service_info", "mdcg_service_info", "info"):
416
- try:
417
- r = cli.call(name, {})
418
- if not r["isError"]:
419
- return {"ok": True, "tool": name,
420
- "info": r.get("data") or r.get("text")}
421
- except Exception:
422
- continue
423
- return {"ok": False, "error": "白箱在线但未找到 service_info/info 工具"}
424
- except Exception as exc:
425
- return {"ok": False, "error": f"{type(exc).__name__}: {exc}"}
426
- finally:
427
- if own:
428
- cli.close()
429
-
430
-
431
- # 生效条件:client 为 None 时以 WhiteboxClient(timeout=kw.get("timeout")) 自建并在 finally 关闭;随后 cli.start() 并返回 cli.ask(message, session_id=session_id)。
432
- def ask(message, session_id="md_cg-whitebox-verify", client=None, **kw):
433
- """显式调用白箱回答一个问题。"""
434
- own = client is None
435
- cli = client or WhiteboxClient(timeout=kw.get("timeout"))
436
- try:
437
- cli.start()
438
- return cli.ask(message, session_id=session_id)
439
- finally:
440
- if own:
441
- cli.close()
442
-
443
-
444
- # 生效条件:client 为 None 时以 WhiteboxClient(timeout=kw.get("timeout")) 自建并在 finally 关闭;随后 cli.start() 并返回 cli.remember(content, importance=importance, tags=tags)。
445
- def remember(content, importance=0.9, tags=None, client=None, **kw):
446
- """显式调用白箱编码一条知识。"""
447
- own = client is None
448
- cli = client or WhiteboxClient(timeout=kw.get("timeout"))
449
- try:
450
- cli.start()
451
- return cli.remember(content, importance=importance, tags=tags)
452
- finally:
453
- if own:
454
- cli.close()
455
-
456
-
457
- # --------------------------------------------------------------------------
458
- # 留痕与报告
459
- # --------------------------------------------------------------------------
460
-
461
- # 生效条件:cg 为 None 时返回 None;否则以 whitebox_verify_{kind}_{毫秒时间戳} 为 id 调 cg.add 写入 self 层,成功返回该 nid,cg.add 抛异常时返回 None。
462
- def _record(cg, kind, ok, payload):
463
- """把验证结论写入认知图(self 层)。失败不阻断验证本身。"""
464
- if cg is None:
465
- return None
466
- nid = f"whitebox_verify_{kind}_{int(time.time() * 1000)}"
467
- body = json.dumps(payload, ensure_ascii=False, default=str)[:1800]
468
- try:
469
- cg.add(nid, f"[白箱能力验证·{kind}] ok={ok} {body}",
470
- layer="self", tags=[VERIFY_TAG, f"whitebox:{kind}"],
471
- importance=0.6, verification_basis="test",
472
- consistency=False)
473
- return nid
474
- except Exception:
475
- return None
476
-
477
-
478
- # 生效条件:cg 为 None 时返回 {'ok': False, 'error': '需要 cg 实例'};否则以 k=int(limit or 20)(limit 为 0/空串/None 时 k 变 20)调 cg.search("白箱能力验证", layer="self", record=False),只保留 tags 中任一以 "whitebox:" 开头的项并返回 count 与 items。
479
- def report(cg=None, limit=20):
480
- """汇总最近的「白箱能力验证」留痕。"""
481
- if cg is None:
482
- return {"ok": False, "error": "需要 cg 实例"}
483
- res, _meta = cg.search("白箱能力验证", layer="self",
484
- k=int(limit or 20), record=False)
485
- items = []
486
- for node, score, _q in res:
487
- fm = node.get("frontmatter") or {}
488
- tags = fm.get("tags") or []
489
- if not any(isinstance(t, str) and t.startswith("whitebox:") for t in tags):
490
- continue
491
- items.append({"id": node.get("id"), "score": score, "tags": tags,
492
- "content": (node.get("content") or "")[:800]})
493
- return {"ok": True, "count": len(items), "items": items}
494
-
495
-
496
- # --------------------------------------------------------------------------
497
- # MCP 统一入口(由 mcp_server._whitebox_call 调用)
498
- # --------------------------------------------------------------------------
499
-
500
- # 生效条件:action=(args.action or "ping") 小写后,ask/chat/query 走 ask(question/message/query 均假则传 ""),remember/encode/write 走 remember 且 importance=float(a.get("importance", 0.9)),verify_encoding/encoding 走 verify_encoding,verify_existing/existing/knowledge 走 verify_existing(questions 取 a.questions 或 a.question 单元素列表),report/history 走 report(limit=int(a.get("limit") or 20)),ping/status/info 走 ping(),其余抛 ValueError。
501
- def dispatch(cg, args):
502
- """cg(op=whitebox) 的分发:action=ask|remember|verify_encoding|verify_existing|ping|report。"""
503
- a = args or {}
504
- action = (a.get("action") or "ping").strip().lower()
505
- if action in ("ask", "chat", "query"):
506
- return ask(a.get("question") or a.get("message") or a.get("query") or "",
507
- session_id=a.get("session_id") or "md_cg-whitebox-verify")
508
- if action in ("remember", "encode", "write"):
509
- return remember(a.get("content") or a.get("text") or "",
510
- importance=float(a.get("importance", 0.9)),
511
- tags=a.get("tags"))
512
- if action in ("verify_encoding", "encoding"):
513
- return verify_encoding(cg, marker=a.get("marker"), fact=a.get("fact"),
514
- question=a.get("question"),
515
- session_id=a.get("session_id") or "md_cg-whitebox-verify")
516
- if action in ("verify_existing", "existing", "knowledge"):
517
- qs = a.get("questions") or ([a["question"]] if a.get("question") else None)
518
- return verify_existing(cg, questions=qs,
519
- session_id=a.get("session_id") or "md_cg-whitebox-verify")
520
- if action in ("report", "history"):
521
- return report(cg, limit=int(a.get("limit") or 20))
522
- if action in ("ping", "status", "info"):
523
- return ping()
524
- raise ValueError(f"whitebox 未知 action:{action}")
525
-
526
-
527
- if __name__ == "__main__": # 手动自检:python -m md_cg.whitebox
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · 白箱能力调用与验证(显式调用层)。
3
+
4
+ 架构定位(2026-09-10 修订)
5
+ --------------------------
6
+ · md_cg = 记忆操作系统 / **唯一真源**:负责记忆的写、读、裁决、留痕。
7
+ · 白箱知识库 = **随主仓自带**(`md_cg/whitebox_kb/`,原理论仓 `aeis/wisdom`
8
+ 等内迁):不再需要外部 `aeis` 包,也不再需要跨库调用。
9
+ · AEIS = **身体 / 世界模型库**:本层不再依赖它(自带内核中 vision / body /
10
+ world_model 等均为方法内惰性导入,缺失即自动降级)。
11
+
12
+ 为什么单独成层
13
+ --------------
14
+ 白箱需要一个可审计的调用入口。本模块是「md_cg 调用白箱」的**唯一显式入口**:
15
+ · 调用方式:**进程内**直调自带引擎(默认,见 `LocalWhiteboxClient`);
16
+ 仅当显式设置 `MDCG_WHITEBOX_CMD` / `MDCG_WHITEBOX_ARGS` 时,
17
+ 才回退外部 MCP stdio 子进程(legacy 路径)。
18
+ · 调用结果:验证结论写回认知图(self 层,tags 含 `whitebox:verify`),可追溯。
19
+
20
+ 显式调用映射(详见 docs/mdcg/功能调用映射表_v0.1.md)
21
+ ------------------------------------------------
22
+ 功能 → 代码 → MCP
23
+ 白箱问答 → md_cg.whitebox.ask → cg(op=whitebox, action=ask)
24
+ 白箱编码 → md_cg.whitebox.remember → cg(op=whitebox, action=remember)
25
+ 验证编码能力 → md_cg.whitebox.verify_encoding → cg(op=whitebox, action=verify_encoding)
26
+ 验证已有知识回答能力 → md_cg.whitebox.verify_existing → cg(op=whitebox, action=verify_existing)
27
+ 白箱能力验证报告 → md_cg.whitebox.report → cg(op=whitebox, action=report)
28
+ 白箱连通性探测 → md_cg.whitebox.ping → cg(op=whitebox, action=ping)
29
+
30
+ 环境变量
31
+ --------
32
+ WHITEBOX_DB / MDCG_WHITEBOX_DB 白箱图库路径
33
+ (默认 MDCG_ROOT/data/whitebox/graph.db;
34
+ 独立运行时落 ~/.md_cg/whitebox/graph.db,
35
+ 首次以随包云库为底 + 卡源播种)
36
+ MDCG_WHITEBOX_CMD 外部白箱启动命令(设置后走 legacy 子进程路径)
37
+ MDCG_WHITEBOX_ARGS 外部白箱启动参数(同上,默认 "-m aeis.mcp.server")
38
+ MDCG_WHITEBOX_TIMEOUT 子进程单次调用超时秒数(默认 60)
39
+ """
40
+
41
+ from __future__ import annotations
42
+
43
+ import json
44
+ import os
45
+ import queue
46
+ import subprocess
47
+ import sys
48
+ import threading
49
+ import time
50
+
51
+ PROTOCOL_VERSION = "2024-11-05"
52
+ CLIENT_NAME = "md_cg-whitebox"
53
+ VERIFY_TAG = "whitebox:verify"
54
+
55
+ #: 已有知识回答能力的默认探针(白箱应能从自身知识库直接作答)。
56
+ DEFAULT_KNOWLEDGE_PROBES = [
57
+ "你是谁?请用一句话介绍你自己。",
58
+ "什么是条件论?",
59
+ ]
60
+
61
+
62
+ # --------------------------------------------------------------------------
63
+ # 启动命令
64
+ # --------------------------------------------------------------------------
65
+
66
+ # 生效条件:无必需形参;exe 取 MDCG_WHITEBOX_CMD,该值为假时取 sys.executable、再为假时取 "python",args 取 MDCG_WHITEBOX_ARGS.split()(该值为真时)否则 ["-m","aeis.mcp.server"],返回 [exe]+args。
67
+ def _launch_cmd():
68
+ """外部白箱 MCP server 启动命令(legacy 路径,需显式配置)。
69
+
70
+ 主仓自带白箱知识库后,本路径**不再默认启用**(见 `WhiteboxClient` 工厂)。
71
+ 默认参数 `-m aeis.mcp.server` 仅为兼容既有部署保留。
72
+ """
73
+ exe = os.environ.get("MDCG_WHITEBOX_CMD") or sys.executable or "python"
74
+ raw = os.environ.get("MDCG_WHITEBOX_ARGS")
75
+ args = raw.split() if raw else ["-m", "aeis.mcp.server"]
76
+ return [exe] + args
77
+
78
+
79
+ # --------------------------------------------------------------------------
80
+ # 白箱 MCP stdio 客户端(零第三方依赖)
81
+ # --------------------------------------------------------------------------
82
+
83
+ # 生效条件:类无自定义 __init__(无必需构造形参);实例化后仅当子类覆写 call 时 ask/remember 才走通,否则 call 抛 NotImplementedError。
84
+ class _WhiteboxApi:
85
+ """白箱业务接口(`ask` / `remember`)。
86
+
87
+ 两种载体共享同一实现,保证行为**按构造方式一致**(验证结论不受载体影响):
88
+ · `LocalWhiteboxClient` —— 进程内直调自带引擎(默认)
89
+ · `_SubprocessWhiteboxClient` —— MCP stdio 子进程(legacy,显式配置时)
90
+ """
91
+
92
+ # 生效条件:以 required 形参 name 与 args 调用该抽象方法时无条件抛出 NotImplementedError,不产生任何返回。
93
+ def call(self, name, args):
94
+ """调用白箱工具,返回 {isError, text, data}。"""
95
+ raise NotImplementedError
96
+
97
+ # 生效条件:给定 required 形参 message(session_id 省略时取默认 "md_cg-whitebox-verify")即转调 self.call("wisdom_chat", {...}),按返回 r 组装 {ok: not r["isError"], route: _extract_route(data), reply: _extract_reply(data, r.get("text")), raw},其中 data 由 r.get("data") or {} 得到(data 缺失或为假值时为 {}),故 raw 恒取该 data、不回落到 r.get("text")。
98
+ def ask(self, message, session_id="md_cg-whitebox-verify"):
99
+ """白箱问答(wisdom_chat)。返回归一化的 {ok, route, reply, raw}。"""
100
+ r = self.call("wisdom_chat", {"message": message, "session_id": session_id})
101
+ data = r.get("data") or {}
102
+ return {"ok": not r["isError"],
103
+ "route": _extract_route(data),
104
+ "reply": _extract_reply(data, r.get("text")),
105
+ "raw": data if data is not None else r.get("text")}
106
+
107
+ # 生效条件:给定 required 形参 content(importance 省略时取 0.9 并 float() 转换;tags 为 None/[]/"" 等假值时按 tags or ["md_cg","whitebox-probe"] 回落为 list(["md_cg","whitebox-probe"]))即转调 self.call("remember", {...}),返回 {ok: not r["isError"], raw: r.get("data") or r.get("text")}。
108
+ def remember(self, content, importance=0.9, tags=None):
109
+ """白箱编码(remember):把一条知识交给白箱写入其记忆库。"""
110
+ r = self.call("remember", {"content": content,
111
+ "importance": float(importance),
112
+ "tags": list(tags or ["md_cg", "whitebox-probe"])})
113
+ return {"ok": not r["isError"], "raw": r.get("data") or r.get("text")}
114
+
115
+
116
+ # 生效条件:以假值 cmd(None/空序列)构造时 self.cmd 取 _launch_cmd(),真值 cmd 时取 list(cmd);timeout 与 MDCG_WHITEBOX_TIMEOUT 环境变量都取假值时 self.timeout 为 float(60.0),否则取其中首个真值;env 为真值时按 str(v) 合并进 os.environ 副本,假值时 self.env 仅为 os.environ 副本。
117
+ class _SubprocessWhiteboxClient(_WhiteboxApi):
118
+ """外部白箱 MCP stdio 客户端(legacy 路径,需显式配置才启用)。
119
+
120
+ 只做一件事:把 md_cg 的显式调用翻译成 MCP `tools/call`。
121
+ 进程懒启动、调用串行化、超时即杀(下次调用自动重启)。
122
+ """
123
+
124
+ # 生效条件:cmd 为真值时 self.cmd=list(cmd),否则回落 _launch_cmd();timeout 为真值则直接用,否则回落 os.environ.get("MDCG_WHITEBOX_TIMEOUT"),再否则 60.0;env 为真值时其键值经 str() 合并进 os.environ 副本。
125
+ def __init__(self, cmd=None, env=None, timeout=None):
126
+ self.cmd = list(cmd) if cmd else _launch_cmd()
127
+ self.timeout = float(timeout or os.environ.get("MDCG_WHITEBOX_TIMEOUT") or 60.0)
128
+ self.env = dict(os.environ)
129
+ if env:
130
+ self.env.update({k: str(v) for k, v in env.items()})
131
+ self.proc = None
132
+ self._q = queue.Queue()
133
+ self._next_id = 1
134
+ self._lock = threading.Lock()
135
+
136
+ # -- 生命周期 ---------------------------------------------------------
137
+ # 生效条件:当 self.proc 非 None 且 self.proc.poll() 为 None 时直接返回 self;否则启动 self.cmd 子进程并以模块级常量 PROTOCOL_VERSION 与 CLIENT_NAME 发 initialize 请求和 notifications/initialized 通知后返回 self。
138
+ def start(self):
139
+ if self.proc is not None and self.proc.poll() is None:
140
+ return self
141
+ self.proc = subprocess.Popen(
142
+ self.cmd,
143
+ stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
144
+ text=True, encoding="utf-8", errors="replace", bufsize=1, env=self.env)
145
+ threading.Thread(target=self._reader, daemon=True).start()
146
+ self._request("initialize", {
147
+ "protocolVersion": PROTOCOL_VERSION,
148
+ "capabilities": {},
149
+ "clientInfo": {"name": CLIENT_NAME, "version": "0.1.0"},
150
+ })
151
+ self._notify("notifications/initialized", {})
152
+ return self
153
+
154
+ # 生效条件:幂等、可重复调用;self.proc 为 None 时直接返回;否则先关 stdin 再 terminate 并 wait(timeout=3),超时或异常则 kill 兜底;无返回值、不抛异常;
155
+ def close(self):
156
+ proc, self.proc = self.proc, None
157
+ if proc is None:
158
+ return
159
+ try:
160
+ if proc.stdin:
161
+ proc.stdin.close()
162
+ except Exception:
163
+ pass
164
+ try:
165
+ proc.terminate()
166
+ proc.wait(timeout=3)
167
+ except Exception:
168
+ try:
169
+ proc.kill()
170
+ except Exception:
171
+ pass
172
+
173
+ # -- 内部 IO ----------------------------------------------------------
174
+ # 生效条件:self.proc 为 None 或 proc.stdout 为 None 时直接返回;否则逐行 strip 后跳过空行,非空行 json.loads 成功则放入 self._q,抛 ValueError 则跳过该行。
175
+ def _reader(self):
176
+ stream = self.proc.stdout if self.proc else None
177
+ if stream is None:
178
+ return
179
+ for line in stream:
180
+ line = line.strip()
181
+ if not line:
182
+ continue
183
+ try:
184
+ self._q.put(json.loads(line))
185
+ except ValueError:
186
+ continue
187
+
188
+ # 生效条件:给定 required 形参 payload 时,若 self.proc is None 或 self.proc.poll() is not None 则抛 RuntimeError("白箱进程未运行(启动失败或已退出)"),否则把 json.dumps(payload, ensure_ascii=False) + "\n" 写入 self.proc.stdin 并 flush,无返回。
189
+ def _write(self, payload):
190
+ if self.proc is None or self.proc.poll() is not None:
191
+ raise RuntimeError("白箱进程未运行(启动失败或已退出)")
192
+ self.proc.stdin.write(json.dumps(payload, ensure_ascii=False) + "\n")
193
+ self.proc.stdin.flush()
194
+
195
+ # 生效条件:给定 required 形参 method 与 params 时,以 {"jsonrpc": "2.0", "method": method, "params": params}(无 id)调用 self._write,自身无返回。
196
+ def _notify(self, method, params):
197
+ self._write({"jsonrpc": "2.0", "method": method, "params": params})
198
+
199
+ # 生效条件:给定 required 形参 method 与 params 时在 self._lock 内取自增 id 并写入请求,随后循环取 self._q:remain <= 0 或 queue.Empty 时先 self.close() 再抛 TimeoutError,msg.get("id") 不等于 rid 时 continue,msg.get("error") 为真时抛 RuntimeError,id 匹配且无 error 时返回 msg.get("result")(缺 "result" 键返回 None)。
200
+ def _request(self, method, params):
201
+ with self._lock:
202
+ rid = self._next_id
203
+ self._next_id += 1
204
+ self._write({"jsonrpc": "2.0", "id": rid, "method": method,
205
+ "params": params})
206
+ deadline = time.time() + self.timeout
207
+ while True:
208
+ remain = deadline - time.time()
209
+ if remain <= 0:
210
+ self.close()
211
+ raise TimeoutError(f"白箱调用超时({self.timeout}s):{method}")
212
+ try:
213
+ msg = self._q.get(timeout=remain)
214
+ except queue.Empty:
215
+ self.close()
216
+ raise TimeoutError(f"白箱调用超时({self.timeout}s):{method}")
217
+ if msg.get("id") != rid:
218
+ continue
219
+ if msg.get("error"):
220
+ raise RuntimeError(f"白箱返回错误:{msg['error']}")
221
+ return msg.get("result")
222
+
223
+ # -- 业务接口 ---------------------------------------------------------
224
+ # 生效条件:给定 required 形参 name 与 args(args 为假值时按 {"name": name, "arguments": args or {}} 发空字典)即以 "tools/call" 发请求,把结果 content 中 type=="text" 的块文本拼接后 json.loads,失败(ValueError/TypeError)则 data=None,返回 {"isError": bool((result or {}).get("isError")), "text": text, "data": data}。
225
+ def call(self, name, args):
226
+ """调用白箱 MCP 工具,返回 {isError, text, data}。"""
227
+ result = self._request("tools/call", {"name": name, "arguments": args or {}})
228
+ text = ""
229
+ for block in (result or {}).get("content", []) or []:
230
+ if isinstance(block, dict) and block.get("type") == "text":
231
+ text += block.get("text") or ""
232
+ try:
233
+ data = json.loads(text)
234
+ except (ValueError, TypeError):
235
+ data = None
236
+ return {"isError": bool((result or {}).get("isError")),
237
+ "text": text, "data": data}
238
+
239
+ # --------------------------------------------------------------------------
240
+ # 进程内白箱客户端(默认路径)+ 客户端工厂
241
+ # --------------------------------------------------------------------------
242
+
243
+ class LocalWhiteboxClient(_WhiteboxApi):
244
+ """白箱**进程内**客户端(默认载体)。
245
+
246
+ 白箱知识库已随主仓自带(`md_cg/whitebox_kb/`),直接调用其引擎:
247
+ 无子进程、无 MCP、无理论仓依赖。接口与子进程版完全一致,
248
+ 故 `ask / remember / ping / verify_*` 及其留痕逻辑无需任何改动。
249
+ """
250
+
251
+ # 生效条件:db_path 为 None 时由引擎按默认路径取库;_ignored 吞掉子进程版遗留形参以保持接口同形;构造只记录路径、不加载引擎(延迟到 self.engine 首次访问);
252
+ def __init__(self, db_path=None, **_ignored):
253
+ self.db_path = db_path
254
+ self._engine = None
255
+
256
+ @property
257
+ # 生效条件:self._engine 为 None 时调用 _load_get_engine()(db_path=self.db_path) 创建并缓存后返回它,非 None 时直接返回缓存实例。
258
+ def engine(self):
259
+ if self._engine is None:
260
+ self._engine = _load_get_engine()(db_path=self.db_path)
261
+ return self._engine
262
+
263
+ # -- 生命周期(与子进程版语义对齐:start 即确保可用,失败即抛) --------
264
+ # 生效条件:先取 self.engine(首次访问才真正加载知识库)并调 service_info() 以确认可服务,不可用即抛;成功后返回 self,可重复调用;
265
+ def start(self):
266
+ _ = self.engine.service_info()
267
+ return self
268
+
269
+ # 生效条件:幂等;self._engine 为 None 时直接返回,否则关闭引擎并置 None(只释放句柄,不删除落盘数据);
270
+ def close(self):
271
+ if self._engine is not None:
272
+ self._engine.close()
273
+ self._engine = None
274
+
275
+ # -- 业务接口 ---------------------------------------------------------
276
+ # 生效条件:给定 required 形参 name 与 args 时直接转调 self.engine.call_tool(name, args) 并返回其结果,不做任何形参改写或校验。
277
+ def call(self, name, args):
278
+ """调用白箱工具,返回 {isError, text, data}(形状对齐 MCP)。"""
279
+ return self.engine.call_tool(name, args)
280
+
281
+
282
+ # 生效条件:无必需形参;包内 from .whitebox_kb.engine import get_engine 成功时返回它,ImportError 时改为 from whitebox_kb.engine import get_engine 并返回。
283
+ def _load_get_engine():
284
+ """兼容两种导入方式(包内 / 平铺)。"""
285
+ try:
286
+ from .whitebox_kb.engine import get_engine
287
+ except ImportError: # pragma: no cover - 平铺运行场景
288
+ from whitebox_kb.engine import get_engine
289
+ return get_engine
290
+
291
+
292
+ # 生效条件:cmd 或 env 为真,或 MDCG_WHITEBOX_CMD / MDCG_WHITEBOX_ARGS 为真时返回 _SubprocessWhiteboxClient(cmd=cmd, env=env, timeout=timeout),否则返回 LocalWhiteboxClient(db_path=db_path)。
293
+ def WhiteboxClient(cmd=None, env=None, timeout=None, db_path=None):
294
+ """白箱客户端工厂。
295
+
296
+ 默认返回 `LocalWhiteboxClient`(进程内 · 随仓自带知识库)。
297
+ 仅当显式给出 `cmd` / `env`,或设置了 `MDCG_WHITEBOX_CMD` /
298
+ `MDCG_WHITEBOX_ARGS` 时,才返回 legacy 的外部 MCP 子进程客户端。
299
+ """
300
+ if cmd or env or os.environ.get("MDCG_WHITEBOX_CMD") \
301
+ or os.environ.get("MDCG_WHITEBOX_ARGS"):
302
+ return _SubprocessWhiteboxClient(cmd=cmd, env=env, timeout=timeout)
303
+ return LocalWhiteboxClient(db_path=db_path)
304
+
305
+
306
+ # --------------------------------------------------------------------------
307
+ # 结果归一化
308
+ # --------------------------------------------------------------------------
309
+
310
+ # 生效条件:data 为 dict 时按 route、mode、path 顺序取首个非空 str 值返回,否则(含 data 非 dict、三键均无或均为空/非 str)返回 ""。
311
+ def _extract_route(data):
312
+ if isinstance(data, dict):
313
+ for key in ("route", "mode", "path"):
314
+ val = data.get(key)
315
+ if isinstance(val, str) and val:
316
+ return val
317
+ return ""
318
+
319
+
320
+ # 生效条件:data 为 dict 时先按 reply/answer/text/response/content/message 取首个 strip 后非空的 str 返回,再对 result、data 两键的 dict 值递归取非空结果,均无则返回 fallback or ""。
321
+ def _extract_reply(data, fallback=""):
322
+ if isinstance(data, dict):
323
+ for key in ("reply", "answer", "text", "response", "content", "message"):
324
+ val = data.get(key)
325
+ if isinstance(val, str) and val.strip():
326
+ return val
327
+ for key in ("result", "data"):
328
+ val = data.get(key)
329
+ if isinstance(val, dict):
330
+ nested = _extract_reply(val, "")
331
+ if nested:
332
+ return nested
333
+ return fallback or ""
334
+
335
+
336
+ # --------------------------------------------------------------------------
337
+ # 验证:编码能力 / 已有知识回答能力
338
+ # --------------------------------------------------------------------------
339
+
340
+ # 生效条件:client 为 None 时自建 WhiteboxClient() 并在 finally 关闭;marker、fact、question 为假值时分别用带毫秒时间戳的默认口令、默认事实、默认追问,cg 仅传给 _record(cg 为 None 则 node_id 为 None,不自建 client),异常时返回 ok=False 并同样 _record。
341
+ def verify_encoding(cg=None, client=None, marker=None, fact=None,
342
+ question=None, session_id="md_cg-whitebox-verify"):
343
+ """验证白箱「编码能力」。
344
+
345
+ 步骤:remember 一条带唯一口令的事实 → 追问口令 → 命中即通过。
346
+ """
347
+ own = client is None
348
+ cli = client or WhiteboxClient()
349
+ marker = marker or ("白箱探针" + str(int(time.time() * 1000)))
350
+ fact = fact or f"md_cg 白箱编码验证:本次口令是 {marker},请记住。"
351
+ question = question or "请只回答刚才记住的口令本身,不要解释。"
352
+ try:
353
+ cli.start()
354
+ enc = cli.remember(fact, importance=0.95, tags=["md_cg", "whitebox-probe"])
355
+ ans = cli.ask(question, session_id=session_id)
356
+ hit = marker in (ans.get("reply") or "")
357
+ out = {"kind": "encoding", "ok": bool(enc["ok"] and hit),
358
+ "marker": marker, "encoded": bool(enc["ok"]),
359
+ "recalled": hit, "route": ans.get("route"),
360
+ "reply": (ans.get("reply") or "")[:300]}
361
+ out["node_id"] = _record(cg, "encoding", out["ok"], out)
362
+ return out
363
+ except Exception as exc: # 白箱不可用:如实记录失败,不抛断调用方
364
+ out = {"kind": "encoding", "ok": False, "marker": marker,
365
+ "error": f"{type(exc).__name__}: {exc}"}
366
+ out["node_id"] = _record(cg, "encoding", False, out)
367
+ return out
368
+ finally:
369
+ if own:
370
+ cli.close()
371
+
372
+
373
+ # 生效条件:client 为 None 时自建 WhiteboxClient() 并在 finally 关闭;questions 为假值(None 或空)时用 DEFAULT_KNOWLEDGE_PROBES,逐问后仅当至少一问 reply 非空且 route 为 self 或 self_fallback 时 ok=True,异常返回 ok=False。
374
+ def verify_existing(cg=None, client=None, questions=None,
375
+ session_id="md_cg-whitebox-verify"):
376
+ """验证白箱「已有知识回答能力」。
377
+
378
+ 步骤:问白箱本应已知的问题 → route=self 且回答非空即通过(至少一问命中)。
379
+ """
380
+ own = client is None
381
+ cli = client or WhiteboxClient()
382
+ questions = list(questions or DEFAULT_KNOWLEDGE_PROBES)
383
+ try:
384
+ cli.start()
385
+ probes = []
386
+ for q in questions:
387
+ ans = cli.ask(q, session_id=session_id)
388
+ route = ans.get("route") or ""
389
+ reply = ans.get("reply") or ""
390
+ probes.append({"question": q, "route": route,
391
+ "answered": bool(reply.strip()),
392
+ "self_route": route in ("self", "self_fallback"),
393
+ "reply": reply[:300]})
394
+ ok = any(p["answered"] and p["self_route"] for p in probes)
395
+ out = {"kind": "existing_knowledge", "ok": ok, "probes": probes}
396
+ out["node_id"] = _record(cg, "existing_knowledge", ok, out)
397
+ return out
398
+ except Exception as exc:
399
+ out = {"kind": "existing_knowledge", "ok": False,
400
+ "error": f"{type(exc).__name__}: {exc}"}
401
+ out["node_id"] = _record(cg, "existing_knowledge", False, out)
402
+ return out
403
+ finally:
404
+ if own:
405
+ cli.close()
406
+
407
+
408
+ # 生效条件:client 为 None 时自建 WhiteboxClient() 并在 finally 关闭;依次对 service_info、mdcg_service_info、info 调用 call,首个 isError 为假即返回 ok=True 与该 tool/info,全部不可用返回 ok=False,start 或整体异常返回 ok=False。
409
+ def ping(client=None, session_id="md_cg-whitebox-ping"):
410
+ """白箱连通性探测:调 service_info(或 info)判断能力库是否在线。"""
411
+ own = client is None
412
+ cli = client or WhiteboxClient()
413
+ try:
414
+ cli.start()
415
+ for name in ("service_info", "mdcg_service_info", "info"):
416
+ try:
417
+ r = cli.call(name, {})
418
+ if not r["isError"]:
419
+ return {"ok": True, "tool": name,
420
+ "info": r.get("data") or r.get("text")}
421
+ except Exception:
422
+ continue
423
+ return {"ok": False, "error": "白箱在线但未找到 service_info/info 工具"}
424
+ except Exception as exc:
425
+ return {"ok": False, "error": f"{type(exc).__name__}: {exc}"}
426
+ finally:
427
+ if own:
428
+ cli.close()
429
+
430
+
431
+ # 生效条件:client 为 None 时以 WhiteboxClient(timeout=kw.get("timeout")) 自建并在 finally 关闭;随后 cli.start() 并返回 cli.ask(message, session_id=session_id)。
432
+ def ask(message, session_id="md_cg-whitebox-verify", client=None, **kw):
433
+ """显式调用白箱回答一个问题。"""
434
+ own = client is None
435
+ cli = client or WhiteboxClient(timeout=kw.get("timeout"))
436
+ try:
437
+ cli.start()
438
+ return cli.ask(message, session_id=session_id)
439
+ finally:
440
+ if own:
441
+ cli.close()
442
+
443
+
444
+ # 生效条件:client 为 None 时以 WhiteboxClient(timeout=kw.get("timeout")) 自建并在 finally 关闭;随后 cli.start() 并返回 cli.remember(content, importance=importance, tags=tags)。
445
+ def remember(content, importance=0.9, tags=None, client=None, **kw):
446
+ """显式调用白箱编码一条知识。"""
447
+ own = client is None
448
+ cli = client or WhiteboxClient(timeout=kw.get("timeout"))
449
+ try:
450
+ cli.start()
451
+ return cli.remember(content, importance=importance, tags=tags)
452
+ finally:
453
+ if own:
454
+ cli.close()
455
+
456
+
457
+ # --------------------------------------------------------------------------
458
+ # 留痕与报告
459
+ # --------------------------------------------------------------------------
460
+
461
+ # 生效条件:cg 为 None 时返回 None;否则以 whitebox_verify_{kind}_{毫秒时间戳} 为 id 调 cg.add 写入 self 层,成功返回该 nid,cg.add 抛异常时返回 None。
462
+ def _record(cg, kind, ok, payload):
463
+ """把验证结论写入认知图(self 层)。失败不阻断验证本身。"""
464
+ if cg is None:
465
+ return None
466
+ nid = f"whitebox_verify_{kind}_{int(time.time() * 1000)}"
467
+ body = json.dumps(payload, ensure_ascii=False, default=str)[:1800]
468
+ try:
469
+ # 2026-10-18:补条件空间四维——此前只有 time_window(autofill),
470
+ # 三条 whitebox_verify_* 因此判 legacy_blindspot。
471
+ # 同样是"自述产生过程"而非内容推断:它确实是系统自验、用该验证器、
472
+ # 在"验证已执行且库可写"的前提下产生的记录。
473
+ cg.add(nid, f"[白箱能力验证·{kind}] ok={ok} {body}",
474
+ layer="self", tags=[VERIFY_TAG, f"whitebox:{kind}"],
475
+ condition_space={
476
+ "observation_position": "self:lingshu",
477
+ "observation_tool": "whitebox.verify_%s" % kind,
478
+ "existence_constraint": "库内可写且验证已执行",
479
+ },
480
+ importance=0.6, verification_basis="test",
481
+ consistency=False)
482
+ return nid
483
+ except Exception:
484
+ return None
485
+
486
+
487
+ # 生效条件:cg 为 None 时返回 {'ok': False, 'error': '需要 cg 实例'};否则以 k=int(limit or 20)(limit 为 0/空串/None 时 k 变 20)调 cg.search("白箱能力验证", layer="self", record=False),只保留 tags 中任一以 "whitebox:" 开头的项并返回 count 与 items。
488
+ def report(cg=None, limit=20):
489
+ """汇总最近的「白箱能力验证」留痕。"""
490
+ if cg is None:
491
+ return {"ok": False, "error": "需要 cg 实例"}
492
+ res, _meta = cg.search("白箱能力验证", layer="self",
493
+ k=int(limit or 20), record=False)
494
+ items = []
495
+ for node, score, _q in res:
496
+ fm = node.get("frontmatter") or {}
497
+ tags = fm.get("tags") or []
498
+ if not any(isinstance(t, str) and t.startswith("whitebox:") for t in tags):
499
+ continue
500
+ items.append({"id": node.get("id"), "score": score, "tags": tags,
501
+ "content": (node.get("content") or "")[:800]})
502
+ return {"ok": True, "count": len(items), "items": items}
503
+
504
+
505
+ # --------------------------------------------------------------------------
506
+ # MCP 统一入口(由 mcp_server._whitebox_call 调用)
507
+ # --------------------------------------------------------------------------
508
+
509
+ # 生效条件:action=(args.action or "ping") 小写后,ask/chat/query 走 ask(question/message/query 均假则传 ""),remember/encode/write 走 remember 且 importance=float(a.get("importance", 0.9)),verify_encoding/encoding 走 verify_encoding,verify_existing/existing/knowledge 走 verify_existing(questions 取 a.questions 或 a.question 单元素列表),report/history 走 report(limit=int(a.get("limit") or 20)),ping/status/info 走 ping(),其余抛 ValueError。
510
+ def dispatch(cg, args):
511
+ """cg(op=whitebox) 的分发:action=ask|remember|verify_encoding|verify_existing|ping|report。"""
512
+ a = args or {}
513
+ action = (a.get("action") or "ping").strip().lower()
514
+ if action in ("ask", "chat", "query"):
515
+ return ask(a.get("question") or a.get("message") or a.get("query") or "",
516
+ session_id=a.get("session_id") or "md_cg-whitebox-verify")
517
+ if action in ("remember", "encode", "write"):
518
+ return remember(a.get("content") or a.get("text") or "",
519
+ importance=float(a.get("importance", 0.9)),
520
+ tags=a.get("tags"))
521
+ if action in ("verify_encoding", "encoding"):
522
+ return verify_encoding(cg, marker=a.get("marker"), fact=a.get("fact"),
523
+ question=a.get("question"),
524
+ session_id=a.get("session_id") or "md_cg-whitebox-verify")
525
+ if action in ("verify_existing", "existing", "knowledge"):
526
+ qs = a.get("questions") or ([a["question"]] if a.get("question") else None)
527
+ return verify_existing(cg, questions=qs,
528
+ session_id=a.get("session_id") or "md_cg-whitebox-verify")
529
+ if action in ("report", "history"):
530
+ return report(cg, limit=int(a.get("limit") or 20))
531
+ if action in ("ping", "status", "info"):
532
+ return ping()
533
+ raise ValueError(f"whitebox 未知 action:{action}")
534
+
535
+
536
+ if __name__ == "__main__": # 手动自检:python -m md_cg.whitebox
528
537
  print(json.dumps(ping(), ensure_ascii=False, indent=2))