@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  531. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  535. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  539. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  543. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  547. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  548. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  549. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  550. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  551. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  552. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  553. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  554. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  559. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  563. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  564. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  565. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  566. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  567. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  568. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  569. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  570. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  571. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  572. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,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 路线)与白箱路线对比,择优或互补。