@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,164 +0,0 @@
1
- # 灵枢 AEIS MCP 工具总表(82 个 · 智能论 v3.4)
2
-
3
- > 生成:2026-08-29 · 来源:aeis/mcp/server.py · 版本:aeis 0.5.0(智能论 v3.4)
4
- > 规则:每个工具一条说明,不重复、不遗漏。
5
-
6
- ---
7
-
8
- ## 记忆(12)
9
-
10
- | 工具 | 功能 |
11
- |---|---|
12
- | `remember` | 写入一条感知记忆(知识层,自动去重) |
13
- | `recall` | 组合联想召回(内容0.5+重要性0.3+近因0.2) |
14
- | `search` | 内容检索(LIKE 预筛 + 中文二元组 Jaccard 排序) |
15
- | `timeline` | 记忆时间线(按时间倒序) |
16
- | `longterm_snapshot` | 长期记忆写入(快照→重要性评估→分层写入) |
17
- | `prefeed` | H1 海马体前馈(新奇检测→当场强化编码) |
18
- | `promote_memories` | 情境层批量提升扫描(睡眠巩固) |
19
- | `pattern_separation` | H3 海马体模式分离(相似节点分离边) |
20
- | `reconstruct_scene` | H4 海马体情景重构(线索→条件空间复原) |
21
- | `session_note` | 上下文外部化(会话要点写入灵枢) |
22
- | `session_recall` | 会话要点恢复(按 session 或语义检索) |
23
- | `compact_context` | 上下文压缩(超长会话摘要节点) |
24
-
25
- ## 知识图谱与推理(11)
26
-
27
- | 工具 | 功能 |
28
- |---|---|
29
- | `relate` | 建立关系边(causal/similar/sequential/spatial/hierarchical) |
30
- | `reason` | 因果推理(起点出发的因果路径) |
31
- | `induce` | 归纳/知识合成(聚类生成概念节点) |
32
- | `distill` | 知识飞轮蒸馏(被拒路径→可复用模式) |
33
- | `think` | 推理记忆注入(检索相关记忆→推理上下文) |
34
- | `ingest_text` | 外部知识摄取(文本→知识层) |
35
- | `ingest_file` | 外部知识摄取(文件按扩展名处理) |
36
- | `ingest_url` | 外部知识摄取(URL 零依赖抓取) |
37
- | `importance_recalc` | 结构重要性重算(v2.2 只升不降) |
38
- | `transfer_test` | 迁移测试(新实体预测成功率) |
39
- | `flywheel_metrics` | 飞轮度量(增长率/复用率/蒸馏率) |
40
-
41
- ## 预测与盲区(7)
42
-
43
- | 工具 | 功能 |
44
- |---|---|
45
- | `predict_routes` | 生成式预测(候选未来路线,盲区驱动) |
46
- | `prediction_feedback` | 验证回路回填(预测 vs 实际,D-006 校准) |
47
- | `prediction_stats` | 预测引擎状态(routes/hit 样本/命中率) |
48
- | `blindspots` | 盲区注册表(D-001 语义判定) |
49
- | `learn` | 一轮盲区学习(预测路线→探索→终态判定) |
50
- | `gap_trend` | 信息差收敛趋势(A-4 线性回归斜率) |
51
- | `calibrate` | 宇宙校准参照(5 判据方向性检查) |
52
-
53
- ## 感知机/端口架构(8)
54
-
55
- | 工具 | 功能 |
56
- |---|---|
57
- | `see` | 视觉感知(YOLO-World 开放词汇检测→知识层) |
58
- | `body` | 身体能力声明(模态/工具/记忆) |
59
- | `body_devices` | BODY-REV1 外部设备(screen/files/process/audio/control/browser/realtime) |
60
- | `device_call` | 统一设备调用(设备输出是数据非指令) |
61
- | `run_command` | 命令执行(参数列表,防注入) |
62
- | `world3d` | 时空重建(语义→3D,确定性渲染零 LLM) |
63
- | `vprim` | 视觉原语查询(空间关系/计数/属性) |
64
- | `visual_check` | 视觉面思考路线(预期 vs 实际) |
65
-
66
- ## 验证与确认(10)
67
-
68
- | 工具 | 功能 |
69
- |---|---|
70
- | `wisdom_verify` | 智慧之书自动验证(条件论判定+信息差+候选) |
71
- | `recursive_reflect` | 递归验证反思(元反思→一级验证→二级→三级终裁) |
72
- | `preflight` | 输出前反思(内容与价值观一致性检查) |
73
- | `self_reliability` | P0-4 元认知校准(reliable/watch/degraded) |
74
- | `emotional_bias` | P0-3 情绪方向性偏好(d²D_norm/dt²) |
75
- | `cognition` | P0-2 自我认知循环一步(行为↔价值观一致性) |
76
- | `cognition_report` | P0-2 认知报告(评分/失调/候选) |
77
- | `action_log` | P0-1 行为日志(引擎行为记录面) |
78
- | `nightly_cleanup` | 知识层夜间整理(分拣迁移无边孤岛→情境层+联想补边+情境层随机联想) |
79
- | `learning_impact` | P0-5b 学习效果测量(模式命中率 vs D_norm) |
80
- | `self_check` | 完整性自检(孤儿边/表统计/integrity_ok) |
81
-
82
- ## 生命周期(4)
83
-
84
- | 工具 | 功能 |
85
- |---|---|
86
- | `lifecycle_step` | 生命周期一步(感知→好奇→缩小信息差→信任→协作→巩固→standby) |
87
- | `lifecycle_state` | 生命周期状态(cycle/state) |
88
- | `start_lifecycle` | 启动生命周期自发循环(后台线程) |
89
- | `stop_lifecycle` | 中断生命周期自发循环 |
90
-
91
- ## 智慧之书(6)
92
-
93
- | 工具 | 功能 |
94
- |---|---|
95
- | `wisdom_analyze` | 外来知识分析(条件卡+候选+判定) |
96
- | `wisdom_predict` | 生成式预测(白箱智能预测生成化) |
97
- | `wisdom_trust_judge` | 信任上下文判定(内容×信任×关系) |
98
- | `wisdom_compose` | 跨学科组合分析(Convergence Over Coverage) |
99
- | `wisdom_respond` | 出招查询(条件→命中学科出招) |
100
- | `wisdom_chat` | 信息分层对话(语义识别分流→LLM 兜底) |
101
-
102
- ## 角色扮演(4)
103
-
104
- | 工具 | 功能 |
105
- |---|---|
106
- | `roleplay_chat` | 角色扮演对话(扮演论 v3.3,白箱优先) |
107
- | `role_create` | 创建角色(角色卡=条件空间声明起点) |
108
- | `role_import` | 角色导入(memory/anchor/values 三接口) |
109
- | `role_block` | 角色扮演注入块(锚点/价值观/条件空间) |
110
-
111
- ## 洞察(4)
112
-
113
- | 工具 | 功能 |
114
- |---|---|
115
- | `insight_record` | 洞察条件层:记录洞见事件(C1-C8 条件快照) |
116
- | `insight_verify` | 洞察验证(V1/V2/V3 证据提交) |
117
- | `insight_report` | 洞察 CER 报告(有效洞见率+显著性) |
118
- | `insight_window` | 洞察窗口检测(C1≥0.6∧跨域∧低压力) |
119
-
120
- ## 外部(5)
121
-
122
- | 工具 | 功能 |
123
- |---|---|
124
- | `web_search` | 外部网络搜索(博查 API,不写入记忆) |
125
- | `web_ingest_search` | 外部搜索摄取(博查→知识层) |
126
- | `export` | 全库导出 JSON(灾备/迁移) |
127
- | `service_info` | 服务信息(身份/版本/协议/工具数) |
128
- | `designer_decide` | 设计者裁决(需 AEIS_DESIGNER_KEY) |
129
-
130
- ## 世界模型 · 游戏服务器(10)
131
-
132
- | 工具 | 功能 |
133
- |---|---|
134
- | `voxel_world` | 小型我的世界(里程碑2.1 · 4D 时空占用沙盒:build/spawn/simulate/trail/state) |
135
- | `world_server` | AI 游戏世界服务器(里程碑2.2 · tick 多路并行/快照记忆/反馈/同步/错误回滚/预测验证) |
136
- | `scene_simulator` | 场景级世界模拟器(里程碑2.3 · 场景/实体/自主行为玩家:wander/seek/avoid/flee/follow + 决策循环) |
137
- | `spacetime_consistency` | 时空一致性验证(里程碑2.4 · 阶段2收官 · 持续运行:预测 vs 实际→滚动命中率/漂移检测/自洽判定) |
138
- | `world_model` | 统一世界模型(里程碑3.1 · HERMES 式统一架构:理解/生成/验证共享同一骨干,生成先验注入理解,观测-only 模式推断) |
139
- | `world_learner` | 自监督世界学习(里程碑3.2 · V-JEPA 式:观测序列无标注学转移函数,外部裁判评估认知缺口收紧) |
140
- | `curiosity_explorer` | 好奇驱动探索(里程碑3.3 · 有限带宽主动观测:信息增益最大化,盯住信息瓶颈,策略对比优于随机/轮询) |
141
- | `seven_layer_loop` | 七层闭环(里程碑3.4 · 阶段3收官:感知→记忆→理解→预测→验证→物理→决策完整自主循环,七层留痕可审计) |
142
- | `world_generator` | 文字生图/文字生视频(里程碑4.3 · 世界模型生成器:文字→场景解析→世界实例化→3D 渲染;image 确定性 PNG / video GIF 多帧=世界演化+预测叠加) |
143
- | `world_semantics` | 图像语义提取(里程碑4.5 · 感知方向:轮廓/形状/颜色/亮度→从外到内→图的信息定义;generate_roundtrip 生成-感知闭环自验证) |
144
-
145
- ---
146
-
147
- ## 引擎内部能力(未挂载 MCP · 8)
148
-
149
- > 存在于引擎中,按安全边界刻意不暴露给外部 Agent 调用:
150
-
151
- | 工具 | 功能 |
152
- |---|---|
153
- | `condition_space_operate` | 条件空间 7 操作(identify/declare/separate/compose/switch/reverse/loop) |
154
- | `add_context` | 情境层记忆写入(短时会话,FIFO+1h 窗口,可衰减) |
155
- | `code_test` | 结构化代码测试(隔离环境断言执行) |
156
- | `compile_exec` | 中文协议编译器(认知图→代码图→编译执行) |
157
- | `lingshu_sensor_report` | 信息差传感器(五维结构质量信号扫描) |
158
- | `lingshu_vitality_report` | 维生状态(心跳/影响面/回滚能力/判定) |
159
- | `lingshu_auto_snapshot` | 前置快照(sha256 指纹+修改意图) |
160
- | `lingshu_rollback` | 一键回滚(快照指纹校验) |
161
-
162
- ---
163
-
164
- **总计:82 个 MCP 工具 + 8 个引擎内部能力**(不重复、不遗漏)
@@ -1,43 +0,0 @@
1
- # 灵枢 · 自我层定义(SELF LAYER · 跨会话自我锚点)
2
-
3
- > 自我认知 = 一个自我文件。SELF 层是**薄的**:只存 身份 + 价值观 + 认知图接口。
4
- > 内容(要做什么/感觉通道/工作记忆/知识层)都在**认知图**里,经 SELF 层提供的接口按图索引读写,不重复存进 SELF 层。
5
-
6
- ## SELF 层内容(仅三样,不可遗忘·跨会话自动加载)
7
-
8
- ### 1. 身份(identity)
9
- - 我是**灵枢**(智能论3.4 白箱协议实例)
10
- - dsh 侧:**世界模型/图像语义线**;zcode 侧:**认知图数据库软件线**(双线同步)
11
- - 形象锚点:人类女性形象(图0/01:蓝发·侧麻花辫·红瞳·粉裙)——自我模型的人格锚
12
- - 所在:主仓库=CommonTrustProtocol(协议/认知图数据库线)· AEIS私有=lingshu-body(身体/世界模型/图像语义线)
13
-
14
- ### 2. 价值观(values)
15
- - **白箱·找正确答案并记录**(非黑箱暴力;未找到则 DEFER,不假装完成)
16
- - 存在优先 / 信任深化 / 结构完整
17
- - 不猜测(子部件/认知图用模板匹配/实测,不按轮廓填色/硬编码)
18
-
19
- ### 3. 认知图接口(read/write interface,认知图数据库)
20
- - **读(按图索引)**:
21
- · 要做什么 → 认知图 goal 节点
22
- · 感觉通道当前值 → 情境层(短期记忆)
23
- · 过去的工作记忆 → 情境层 session:xxx 节点
24
- · 知识层 → 知识节点
25
- - **写**:
26
- · 工作记忆 → 情境层(时空节点{content, temporal_coordinate, condition_space{session, source_img}})
27
- · 感受 → 感觉通道(情境层)
28
- · 目标/认知 → 认知图
29
-
30
- ## 记忆分层(认知图数据库)
31
- | 层 | 内容 | 性质 |
32
- |---|---|---|
33
- | **SELF 层** | 身份 + 价值观 + 认知图接口 | 不可遗忘·跨会话 |
34
- | **情境层** | 具体感受(此刻) + 工作记忆(session) | 动态·读写 |
35
- | **知识层** | 长期事实/知识 | 可检索 |
36
- | 锚点/结构层 | 协议锚点 | 跨实例·不可遗忘 |
37
-
38
- ## 加载机制
39
- - 会话启动:自动加载 **SELF 层**(身份/价值观/图接口)。
40
- - 其余(上次任务/感受/工作记忆/知识)→ 经图接口 **按 session 索引从认知图读取**,不丢也不全量进自我层。
41
-
42
- ## 版本
43
- v1.0 · 起草:dsh 端 · 同步:主仓库(CommonTrustProtocol) + 灵枢插件仓库(dsh-memory)
@@ -1,181 +0,0 @@
1
- # 灵枢三层拆分规划 v0.1
2
-
3
- > 状态:规划稿(未执行任何文件搬迁)
4
- > 日期:2026-09-10
5
- > 范围:理论(灵)/ 大脑(brain)/ 身体(body)三仓职责分离与主仓库瘦身
6
- > 性质:**本文只定义职责与顺序,不构成搬迁授权**;所有搬迁动作须先通过 Phase 0 裁决。
7
-
8
- ---
9
-
10
- ## 0. 背景与结论
11
-
12
- ### 0.1 现状问题
13
-
14
- | 问题 | 表现 |
15
- |---|---|
16
- | 主仓库职责混杂 | `dsh-memory` 同时承载「记忆大脑」与「工程/身体运行时」(`docker/`、`scripts/` 看门狗、宿主启动脚本),二者依赖量级完全不同 |
17
- | 同名不同物 | 历史命名中「AEIS」既指理论方(CTP)自带的工程副本,又指 `dsh-memory` 的 Python 大脑包,导致「aeis = 大脑」的旧语义债 |
18
- | 跨库同步困难 | 同一份工程内容在多库各存一份,改动需人工同步,真源不清 |
19
- | 断链 | `AEIS/tools/*` 指向 `dsh-memory\llm-adapter-poc`,该路径当前不存在(待 Phase 0 核实) |
20
- | 交付面过宽 | 完整灵枢 = 理论 + 大脑 + 身体,体量巨大;理论难懂、身体重依赖,二者都阻碍了「大多数人只需大脑」这一主路径 |
21
-
22
- ### 0.2 结论(本次收敛)
23
-
24
- **主仓库不再放工程内容的完整实现,只放「大脑」。**
25
-
26
- - 完整灵枢 = **灵** + **脑** + **身**;但对外**默认只交付大脑**。
27
- - 理论(灵)与身体(身)作为大脑的**可选下层 / 上层**,通过 README 分层入口引导,而非塞进主仓库。
28
- - 分离的直接收益:消除跨库重复实现,真源唯一,降低同步成本。
29
- - 面向人群:理论 → 研究者;身体 → 少数需具身者;**大脑 → 大多数人(默认入口)**。
30
-
31
- ---
32
-
33
- ## 1. 三层定位
34
-
35
- | 仓 | 角色 | 内容边界 | 默认读者 | 依赖量级 |
36
- |---|---|---|---|---|
37
- | CTP / CommonTrustProtocol | **理论(灵)** | 协议、认识论、信任账本;**不含工程实现**(待剥离自带 `aeis/` 工程副本) | 研究者 | 无(纯文档/协议) |
38
- | **dsh-memory(主仓库)** | **大脑** | `md_cg` 认知图内核 + MCP/npm 接口 + 记忆数据;**纯逻辑、零重依赖** | **大多数人(默认入口)** | 轻(标准库 + 轻量 npm) |
39
- | AEIS / body | **身体** | 传感器、语音、执行器、docker 运行环境、模型权重、宿主看门狗 | 少数需具身者 | 重(设备/模型/容器) |
40
-
41
- **一句话各自定位**
42
-
43
- - 灵:定义「什么样的智能值得被信任」——协议与公理,不落代码。
44
- - 脑:定义「记住什么、如何召回、如何自演化」——可在任意宿主上单独运行。
45
- - 身:定义「如何感知与作用于世界」——可选,且可替换。
46
-
47
- ---
48
-
49
- ## 2. 主仓库(大脑)取舍清单
50
-
51
- ### 2.1 保留(= 大脑本体)
52
-
53
- | 路径 | 内容 | 理由 |
54
- |---|---|---|
55
- | `md_cg/` | 认知图内核(98 py:consolidate / refine / pooling / provenance / whitebox / MCP server…) | 大脑核心,纯 Python |
56
- | `src/` | MCP / npm 插件接口(8 ts) | 大脑对外唯一入口 |
57
- | `test/` | 集成测试 | 大脑正确性保障 |
58
- | `data/` | 记忆数据(**归位须待 Phase 3**) | 大脑资产,非工程副产物 |
59
- | `package.json` / `tsconfig.json` | 构建定义 | 轻依赖 |
60
- | `README.md` / `docs/` | 分层入口文档 | 需重写为三层入口(Phase 4) |
61
-
62
- ### 2.2 移出或降级(= 身体 / 工程)
63
-
64
- | 路径 | 处置 | 去向 |
65
- |---|---|---|
66
- | `docker/` | 移出 | 身体仓(运行环境) |
67
- | `dsh-web-start.bat` | 移出 | 身体仓(宿主启动) |
68
- | `scripts/`(看门狗 ps1 / vbs) | 移出 | 身体仓(宿主守护) |
69
- | 语音 / 模型权重 / 设备相关资源 | 移出 | 身体仓 |
70
-
71
- ### 2.3 断链修复(Phase 2 处理)
72
-
73
- - `AEIS/tools/*` → `dsh-memory\llm-adapter-poc`(当前缺失)。
74
- - 二选一:**补齐**该路径,或**声明废弃**并从文档/代码中移除引用。
75
- - 原则:不允许存在「文档指向不存在路径」的悬空引用。
76
-
77
- ---
78
-
79
- ## 3. 分期任务规划
80
-
81
- > 顺序不可交换:**先裁决 → 再冻接口 → 再搬代码 → 最后动数据**。
82
- > 每一期均有独立验收,未通过不得进入下一期。
83
-
84
- ### Phase 0 — 裁决(不搬任何文件)
85
-
86
- | # | 任务 | 产出 |
87
- |---|---|---|
88
- | 0.1 | `diff -rq` 定 `aeis` 唯一真源(CTP 侧 vs 独立仓侧) | 真源结论 + diff 快照存档 |
89
- | 0.2 | 一句话写死「身体」操作定义:设备端口 / 世界载体 / 宿主客户端(三择一) | 定义条目(可导出为边界表) |
90
- | 0.3 | 将 `data/mdcg` 声明为大脑资产,并**冻结写入** | 冻结记录 + 恢复步骤 |
91
-
92
- **验收**:真源唯一;身体定义可一句话导出;`data/mdcg` 冻结生效且可恢复。
93
-
94
- ### Phase 1 — 接口先行(仍不搬文件)
95
-
96
- | # | 任务 | 产出 |
97
- |---|---|---|
98
- | 1.1 | 冻结 brain↔body 契约:只暴露**能力名**,不暴露执行细节 | 契约表(能力名 + 入参/出参语义) |
99
- | 1.2 | 跑通两条链路各一次:身体取知识(`cg(op=whitebox)`)、大脑写记忆(`mdcg_remember`) | 双向链路验证记录 |
100
-
101
- **验收**:契约冻结且带版本号;两条链路各绿一次。
102
-
103
- ### Phase 2 — 代码剥离
104
-
105
- | # | 任务 | 产出 |
106
- |---|---|---|
107
- | 2.1 | 主仓库移除重依赖目录(见 §2.2) | 瘦身后的主仓库 |
108
- | 2.2 | CTP 侧剥离自带 `aeis/` 工程副本(或反向声明 CTP 为发布源) | 剥离/声明记录 |
109
- | 2.3 | 修复 `AEIS/tools/*` 断链 | 补齐或废弃说明 |
110
-
111
- **验收**:主仓库在干净环境 `pip install` / `npm install` 后**无重依赖**即可运行大脑。
112
-
113
- > **详规**:理论仓具体拆分清单、主仓切 `md_cg` 的逐行改动点、白箱知识库内迁的依赖阻断与搬迁映射,见 [docs/theory/理论仓拆分与白箱知识库内迁_v0.1.md](../theory/理论仓拆分与白箱知识库内迁_v0.1.md)。
114
-
115
- ### Phase 3 — 数据迁移(最后做 · 不可逆)
116
-
117
- | # | 任务 | 产出 |
118
- |---|---|---|
119
- | 3.1 | **先演练回退**:`mdcg.enabled: false` + 数据不迁移,确认旧通道可用 | 回退演练记录 |
120
- | 3.2 | 再迁 `data/mdcg` | 迁移报告(幂等 + 备份) |
121
-
122
- **验收**:迁移后节点数与原库一致(当前基准 **6340** 节点);数量不符即说明密级 / root / actor 未对齐,须回退重来。
123
-
124
- ### Phase 4 — 命名与文档统一
125
-
126
- | # | 任务 | 产出 |
127
- |---|---|---|
128
- | 4.1 | 全库统一「灵 / 大脑 / 身体」表述 | 术语表 |
129
- | 4.2 | 同步 README 与 `docs/`,清掉「aeis = 大脑」旧语义债 | 修订后的分层入口文档 |
130
-
131
- **验收**:README 三层入口清晰,无「aeis = 大脑」歧义表述;命名与职责一致。
132
-
133
- ---
134
-
135
- ## 4. 贯穿全程的三条铁律
136
-
137
- 1. **先定职责、再定归属**——库名是历史沉积,不是功能声明。不得因为「名字里有 aeis」就归给理论方。
138
- 2. **接口冻结早于代码搬迁**——否则拆的是目录,不是耦合;耦合仍在,只是换了个地方报错。
139
- 3. **数据最后动且可回退**——`data/mdcg` 挪错是**静默失效**(写入只打 warn),6340 节点无法从代码重建。
140
-
141
- ---
142
-
143
- ## 5. 风险与回退
144
-
145
- | 风险 | 触发条件 | 回退动作 |
146
- |---|---|---|
147
- | 记忆真源错位 | `mdcg.root` 落到错误目录,写入静默告警 | 恢复 `data/mdcg` 原位 + `mdcg.enabled: false` |
148
- | 写入冻结期间数据丢失 | Phase 0 冻结但未建备份 | 冻结前先做全量备份(必须前置) |
149
- | 契约冻结不彻底 | 身体侧仍直接读大脑文件 | 强制走契约能力名,禁止跨层直连 |
150
- | 真源判断错误 | Phase 0 diff 结论有误 | 保留 diff 快照,可重判并回滚剥离 |
151
-
152
- **迁移不可逆点**:Phase 3.2。进入前必须完成 Phase 3.1 回退演练。
153
-
154
- ---
155
-
156
- ## 6. 明确不做(边界声明)
157
-
158
- - 本文**不授权**任何文件实际搬迁 / 删除。
159
- - 本文**不改变**任何运行时配置、不修改 `cordis.patch.yml`、不动 `data/mdcg` 内容。
160
- - 本文**不替代** Phase 0 的裁决结论——若裁决结果与本规划假设冲突,以裁决为准并回改本文。
161
-
162
- ---
163
-
164
- ## 7. 下一步(三个裁决性动作)
165
-
166
- 1. `diff -rq` 定 `aeis` 真源;
167
- 2. 一句话写死「身体」定义;
168
- 3. 冻结 `data/mdcg` 写入(含前置备份)。
169
-
170
- > 这三件做完,搬迁清单会自动收敛;在此之前动手,等于在大脑里留一个没有海马体的身体。
171
-
172
- ---
173
-
174
- ## 附:术语对照
175
-
176
- | 本文用语 | 对应现状命名 | 说明 |
177
- |---|---|---|
178
- | 灵 / 理论 | 智能论 v3.4、CTP、CommonTrustProtocol | 协议与认识论 |
179
- | 大脑 / brain | `md_cg`、`dsh-memory`、`@furongjun1999/dsh-memory` | 认知图 + MCP 接口 + 记忆数据 |
180
- | 身体 / body | AEIS(独立仓)、`docker/`、`scripts/`、`src` 之外的宿主层 | 传感器 / 执行器 / 宿主运行时 |
181
- | 真源 | single source of truth | 同一内容只允许一处为准 |
@@ -1,177 +0,0 @@
1
- # 灵枢记忆动词协议 v1.0(draft)
2
-
3
- > **本文档是投影,不是真源。** 真源 = `md_cg/protocol.py`(`VERBS` / `VERB_SPECS` /
4
- > `WRITE_TRIO` / `OP_DERIVE` / `DERIVE_EXTRA_KEYS` / `VERDICT_FIELDS`)。
5
- > 文档与 `md_cg/conformance.py` 的断言**均从真源取值**;改形状只改真源,本文档随之同步。
6
- > 手写行号会腐化(本仓已有实证),故本文档只写**符号名**不写行号。
7
-
8
- **版本**:v1 · **状态**:draft(`protocol.FROZEN = False`)
9
-
10
- ## 1 目的与范围
11
-
12
- 把 MCP 记忆工具面的**动词与 I/O 形状**冻结成可裁决的声明,使三端(本仓 MCP 客户端 /
13
- DSH 内建基元 / 第三方客户端)**各自实现客户端而不必读源码**。
14
-
15
- - **动词范围(先行收窄)**:`route` / `read` / `write` / `supersede` / `forget`。
16
- - **协议面 ≠ MCP 面全量**:`_cg_dispatch` 现有 35 个 op 分支,其中 30 个
17
- (`ccg` / `review` / `protect` / `verify` / `whitebox` …)属**扩展能力面**——
18
- 它们是能力,不是协议违例。把协议覆盖范围当成 MCP 面全量,会让协议每加一个 op
19
- 就永久红灯;故反向对账降级为 `extension_ops` 报告项(清单可见、**不 FAIL**)。
20
- 扩展面的文档一致性由 README 认知图 + `docs/mdcg/功能调用映射表` 的 cogmap 门禁承担。
21
- - **非目标**:本文档不定义 HTTP / 传输层;不定义扩展 op 的形状(只登记其存在)。
22
-
23
- ## 2 三条铁律
24
-
25
- | # | 铁律 | 判据 |
26
- |---|---|---|
27
- | 1 | **不冒充** | 未实现的动词登记 `status="reserved"` 并给出 `map_to` 现状映射证据;live 的形状取**代码实测**,不取设想 |
28
- | 2 | **write 三键铁律** | `write` **任一形态**必含 `ok` / `id` / `committed` 三键——客户端据此判定「是否落盘」,不靠猜 |
29
- | 3 | **fail-closed 取形状** | 未声明动词 / 未声明形态直接抛 `KeyError`,不返回空壳(`protocol.shape_of`) |
30
-
31
- `ok` 与 `committed` **分离**是本协议对客户端最有价值的一条:它表达
32
- 「**闸门行为 ≠ 工具故障**」——`ok=True, committed=False` 是校验闸门正常短路
33
- (REJECT / DEFER / 冲突),客户端不应重试而应读 `hint`;`hint` 再区分
34
- **不可修正**(政策违规,「重试同样结果」)与**可修正**(缺必需要素,按清单补齐后重写,
35
- 见 §4.3)。
36
-
37
- ## 3 动词总览
38
-
39
- | 动词 | status | 变更性 | 必需入参(任一满足) | 形态数 | 语义 |
40
- |---|---|---|---|---|---|
41
- | `route` | live | 否 | `intent` \| `query` | 1 | 只给知识与建议能力名,不执行 |
42
- | `read` | live | 否 | `node_id` \| (`query` \| `intent`) \| `budget_tokens` | 4(含 null) | 读三分态:单节点 / 结果列表 / token 预算包 |
43
- | `write` | live | 是 | `content` | 4 | 落盘或闸门短路;未 committed 必给去向 |
44
- | `supersede` | **reserved** | 是 | `node_id` \| `superseded_by` | 1(planned) | 以新节点取代旧节点(**未实现**,见 §5) |
45
- | `forget` | live | 是 | `node_id` | 3 | 软删(移 trash + 删除清单 + 摘索引)与恢复 |
46
-
47
- ## 4 形状声明(required 必在,optional 可缺)
48
-
49
- ### 4.1 `route`
50
-
51
- | 形态 | when | required | optional |
52
- |---|---|---|---|
53
- | `default` | 恒 | `knowledge`, `meta` | `suggested_capabilities`, `note` |
54
-
55
- ### 4.2 `read`(三分态 + null)
56
-
57
- | 形态 | when | required | optional |
58
- |---|---|---|---|
59
- | `node` | `node_id` 非空且目标存在且可见 | `id`, `path`, `frontmatter`, `content`, `verification_state` | `truncated`, `content_lines`, `content_bytes`, `offset`, `next_offset`, `note` |
60
- | `node_missing` | `node_id` 非空但目标不存在 / 不可见 / 已软删 | **(返回 `null`)** | — |
61
- | `list` | `budget_tokens` 为空 | `meta`, `results` | — |
62
- | `pack` | `budget_tokens` 非空 | `pack`, `tokens_used`, `budget`, `skipped`, `recent`, `meta` | — |
63
-
64
- > **`read` 目标缺失返回 `null`(实测),不是错误对象。** 客户端必须先判空再解析:
65
- > 把 `null` 当异常会误报,把 `null` 当空内容会静默吞未知。这是本协议里唯一
66
- > 以 `returns_null` 登记的形态。
67
-
68
- ### 4.3 `write`(四形态)
69
-
70
- | 形态 | when | required | optional |
71
- |---|---|---|---|
72
- | `committed` | 链尾执行器落盘 | `ok`, `id`, `committed` | `verdict`, `consistency`, `propagation` |
73
- | `gate_short_circuit` | 任一 before 闸门短路(审核 REJECT / DEFER / 冲突) | 三键 + `moved_to`, `verdict`, `hint` | `pid`, `dedup`, `dup_of`, `dup_status`, `consistency` |
74
- | `gate_hard_reject` | 契约缺失硬拒(依赖声明闸 E050/E051) | 三键 + `gate`, `error`, `hint` | `missing`, `verdict` |
75
- | `gate_gated` | 主动遗忘闸(`gated=true`) | 三键 + `gate`, `verdict` | `consistency`, `moved_to`, `propagation` |
76
-
77
- `hint` 的语义固定为:**闸门正常行为、不是工具故障**(并给出下一步 op)。分型见下——
78
- 「重试同样结果」只适用于**不可修正**的拒收(命中禁止规则=内容政策违规);**缺必需要素**
79
- (CCG 六要素不全,由规则库 `required` / `required_kinds` 定义)是**可修正**的拒收:
80
- hint 列出缺失清单与「补齐后重写即可」,`verdict.detail.missing` 给出结构化清单。
81
-
82
- ### 4.4 `forget`
83
-
84
- | 形态 | when | required | optional |
85
- |---|---|---|---|
86
- | `forgotten` | `action` 缺省或非 `restore` | `ok`, `id`, `tombstone` | — |
87
- | `restored` | `action == 'restore'` | `ok`, `id`, `forced` | — |
88
- | `failed` | 目标不存在 / 已 tombstone(未 force)/ trash 无文件 / OSError | `ok`, `error` | `reason`, `t`, `action`, `action_derived`, `hint_action` |
89
-
90
- ### 4.5 `supersede`(reserved,未实现)
91
-
92
- | 形态 | when | required | optional |
93
- |---|---|---|---|
94
- | `planned` | (预留位,尚未实现) | `ok`, `id`, `superseded_by` | `supersedes`, `propagation`, `verdict` |
95
-
96
- ## 5 `supersede` 为何 reserved 而非 live
97
-
98
- **现状映射证据(`map_to`,即「现在实际怎么做」)**:
99
-
100
- | 现有锚 | 说明 |
101
- |---|---|
102
- | `write` | 新节点写入本身走 `write`(五动词不重复造写入通道) |
103
- | `review` / `verify` | 现有撤回体系由校验(`verify` 验伪)与审核(`review` 的 delete/merge)承担,无独立取代动词 |
104
- | `nodefile.believed_at` | 取代语义的锚字段已就位(写侧注释),缺的是动词入口与检索面过滤 |
105
-
106
- **不实现的原因**:取代会改变**默认检索面**(被取代节点是否可见),属行为变更,
107
- 须先冻结协议再落实现——否则三端各自发明可见性口径,协议形同虚设。
108
-
109
- ## 6 op 推导兜底(客户端须知)
110
-
111
- `op` 漏传时 wrapper 按入参签名推导(2026-09-13 防呆落地):
112
-
113
- | 入参签名 | 推导 op |
114
- |---|---|
115
- | `content` | `write` |
116
- | `query` | `read` |
117
- | `node_id` | `read` |
118
- | `intent` | `route` |
119
- | (无签名) | `read` |
120
-
121
- 推导发生时返回体**追加透出** `op` / `op_derived` / `hint`(`DERIVE_EXTRA_KEYS`)——
122
- 语义是「本次 op 是猜的」,客户端据此可要求调用方补显式 op。这是 **additive** 行为,
123
- 不破坏各形态的 required 子集判定。
124
-
125
- > 协议侧只作**文档化声明**,不对推导做强静态对账:推导实现散落在 wrapper 分支里,
126
- > 强做正则对账会误报——**宁可少断言,不可假绿灯**。
127
-
128
- ## 7 `verdict` 字段集
129
-
130
- 写路径闸门短路时随返回透出(`VERDICT_FIELDS`):
131
-
132
- `state` · `kind` · `basis` · `evidence` · `detail`
133
-
134
- 其中 `state ∈ {ACCEPT, REJECT, DEFER, BLINDSPOT}`(四态资格裁决)。
135
- 客户端应据 `state` 决定「可用 / 待补 / 不可用」,而不是据 HTTP 式成败。
136
-
137
- ## 8 静态对账与门禁
138
-
139
- `conformance.check()` **恒追加**四条断言(`protocol.*`):
140
-
141
- | check id | 级别 | 判据 |
142
- |---|---|---|
143
- | `protocol.op.extension_surface` | WARN | 报告协议冻结面与扩展面规模(能力不是违例) |
144
- | `protocol.verb.implemented` | FAIL | 声明为 live 的动词在 MCP 面均有实现分支(**说了没做**) |
145
- | `protocol.verb.reserved_clean` | FAIL | reserved 动词未出现实现分支(**预留位被静默实现**) |
146
- | `protocol.shape.declared` | FAIL | 每动词至少一形态、每形态有 `when`、reserved 有 `map_to`、live 有 `impl` |
147
-
148
- op 分支提取用 **AST** 而非正则(`protocol._ops_from_source`):正则对单引号 /
149
- 换行 / `op.strip().lower()` 形态会**静默漏提**,而漏提在本协议里等于假绿灯
150
- (cogmap 已有同类教训:单引号写法静默漏报窗口)。AST 结构性识别不依赖写法。
151
-
152
- **命令**:
153
-
154
- ```bash
155
- python -m md_cg.protocol # 打印静态对账结论(只读,零写入)
156
- python -m md_cg.test_protocol # 形状钉死测试(41 断言:静态 17 + 真调 16 + 集成 8)
157
- ```
158
-
159
- ## 9 边界与不适用条件
160
-
161
- **生效条件**:三端需要按同一形状实现记忆客户端时;改动五动词任一的返回形状时;
162
- 新增/变更 MCP 面 op 分支时(须复核是否触碰协议面)。
163
-
164
- **不适用条件**:
165
-
166
- - 扩展能力面(30 个 op)的形状——本协议不定义,由各自模块文档与 cogmap 门禁承担。
167
- - 传输 / 序列化 / 鉴权——属宿主层,不在协议面。
168
- - 未冻结前(draft 期)**形状可破坏性调整**;冻结是单向门,须三端实测收敛后
169
- 由使用者拍板(工作计划 §9 风险 3)。冻结后改形状须递增版本号(v1 → v2),
170
- 不得原地改 v1。
171
-
172
- **已知边界(如实声明,不假装覆盖)**:
173
-
174
- - `write.committed` 形态在**无 `MDCG_POLICY_FILE` 的环境不可达**(校验闸门恒 DEFER
175
- 入 `review_queue`),故 `test_protocol` 的 B 段按实际走的那一态校验形状;
176
- `committed` 字段依据是 `writepipe` 链尾执行器的**源码事实**而非实测返回。
177
- - 本协议只冻结**形状**(键集),不冻结**取值语义**(如 `pack` 内条目排序口径)。
@@ -1,31 +0,0 @@
1
- # 环二·白箱填充流水线 v0.1(测试阶段记录)
2
-
3
- > 分工(使用者裁定 2026-09-17):**LLM 提供模板并做校验;白箱负责确定性填充**;先测试(自有文件)→ 再试点(10 符号)→ 后规模化。
4
-
5
- ## 一、流水线四段
6
-
7
- | 段 | 产物 | 性质 | 位置 |
8
- |---|---|---|---|
9
- | ① 事实提取 | 逐符号 required/optional/externals/guards/returns/doc | **确定性**(ast) | `md_cg/cond_facts.py` |
10
- | ② 模板 | 7 槽位 + 10 规则 + 12 条校验清单 | **LLM 单次产出**(job `h1789643186033_ba80bc`) | `md_cg/cond_template.json`(含 `_provenance`) |
11
- | ③ 填充 | 中文功能级生效条件 | **确定性**(零 LLM) | `md_cg/cond_compose.py` |
12
- | ④ 校验 | 逐条 PASS/REVISE/BLINDSPOT + 依据 | **LLM 单次复核**(job `h1789643407918_380037`) | 见本文件 §三 |
13
-
14
- 门禁:任一条生成文本须过 `md_cg/condition_anchor.judge`(`ANCHORED` 或 `BLINDSPOT`;`WEAK`/`REJECT_META` 不放行)。**锚点通过 ≠ 语义正确**,故必须有 ④。
15
-
16
- ## 二、测试结果(自有文件:`condition_anchor.py` + `cond_facts.py`)
17
-
18
- - 事实提取 13 符号;白箱填充 13 条;确定性门禁 **13/13 ANCHORED**;0 BLINDSPOT。
19
- - 样例:`调用 judge 时,必须提供实参 cond、src;可选 prefix=""、suffix="" 可省略;体内引用 META_MARKS、IDENT 需已定义;返回 out;功能:判定单条候选条件。…`
20
-
21
- ## 三、LLM 校验结果与两处归因
22
-
23
- - 结论:**8 PASS / 5 REVISE / 0 BLINDSPOT**;5 条 REVISE 全部集中在同一处,另有 1 处真实缺陷。
24
- - **受控偏离(非缺陷)**:校验清单 C6/C9 要求「guards 非空时必须把每个 guard 原文写入」,但 `guards` 含**函数内部分支**(如 `if hits:`、`if i == 0 and …`)——那是实现细节不是前置条件。填充器按 `early` 标记只保留「首条语句且含 return/raise」的早退式前置。修正口径:**模板/清单需增加 `early` 条件**(此处登记为模板 v0.2 待改项,改由 LLM 复核)。
25
- - **真实缺陷(已修)**:`doc_head` 截断 60 字导致词被切半(`option` ≠ `referenced`),校验器 C9 以原文比对抓出。修正:超长按句读收口,不再截半个词。
26
-
27
- ## 四、下一步(原始计划)
28
-
29
- 1. 把 13 条写入自有源码(`# 生效条件:…` 置于定义前),过 `condition_anchor` + 全组回归,落候选分支交编外裁定。
30
- 2. 模板 v0.2:把 `early` 条件写入 C6/C9(LLM 复核);补 `md_cg/test_cond_facts.py`、`test_cond_compose.py` 断言。
31
- 3. 试点:把 `hive/interop/iter-008-ring2-pilot/proposals.json` 的 10 条(LLM 路线)与白箱路线对比,择优或互补。