@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,94 +0,0 @@
1
- # 认知图作为「记忆操作系统」· 现状评估与路线
2
-
3
- > 对象:`dsh-memory/md_cg/`(codebuddy 实现,基于《认知图_MD目录方案_v0.1》)
4
- > 目标:评估它离「记忆操作系统(memory OS)」还差什么,给出路线。
5
- > 2026-09-08 · dsh 端独立验证
6
-
7
- ---
8
-
9
- ## 一、现状盘点:md_cg 已经是什么
10
-
11
- ### 1.1 引擎 API 全景(`md_cg/mdcg.py`,643 行)
12
-
13
- | 能力 | 接口 |
14
- |---|---|
15
- | **分层** | 5 层 `anchor/structural/knowledge/contextual/self` + 2 类负记忆 `rejected/unresolved` |
16
- | **写** | `add()` · `add_rejected()` · `add_unresolved()` |
17
- | **读** | `get()` · `search(query, layer, k, context, judge=True)` → `(results, meta)` |
18
- | **资格** | `judge_qualification()` → 四态 ACCEPT/REJECT/DEFER/BLINDSPOT(与性能 tier 正交)|
19
- | **认知循环** | `reflect()`(信息差 D + d²D/dt²)· `verify()`(非对称可信度)· `flywheel_step()` |
20
- | **访问统计** | `record_access()` · `access_counts()` · `compact_access()`(append-only,检索只读)|
21
- | **生命周期** | `flush()` · `close()` · `compact_index()` · `rebuild_index()` · `health()` |
22
- | **辅助** | `expand_query_terms()` · `bigrams()` |
23
-
24
- ### 1.2 已验证(dsh 端实跑)
25
- - **P0 25/25**(回退阶梯/只读契约/索引重建/多进程零丢失/recall@10 92%)
26
- - **P1 37/37**(9 维白箱对齐:CCG 5 要素/验证基底/负记忆/四态/Top-1 90%/14 大域路由/信息差/飞轮/循环单元)
27
- - **数据规模**:`_md_cg_p1` = 3058 知识节点 + rejected 2 + unresolved 3 + `_index_log/` 9 分片 + `_reflection.jsonl` + `_access.log`
28
- - **烟雾测试**(本次):`add → get → search → judge(DEFER) → reflect(D=1.0,d2=0) → verify(0.6→0.65) → health(正确报退化)` 全通
29
-
30
- ### 1.3 节点形态
31
- ```
32
- knowledge/cond_<域>_<hash>/kp_xxx.md
33
- ---
34
- id / layer / modality / importance / confidence
35
- condition_space: {observation_position, observation_tool, time_window, existence_constraint}
36
- tags / spatial / temporal / edges / state_attributes(含 CCG comment 5 要素)
37
- ---
38
- 正文
39
- ```
40
- 索引 `_index.json` 是**纯派生物**(可删可重建,逐字节确定)。
41
-
42
- ---
43
-
44
- ## 二、OS 视角评估:差什么
45
-
46
- 把「记忆操作系统」拆成 OS 必备件,逐项对照:
47
-
48
- | OS 要件 | md_cg 现状 | 差距 |
49
- |---|---|---|
50
- | **文件系统**(持久化)| ✅ md 目录 + 原子写 + 跨进程锁 + 分片日志 | — |
51
- | **索引/目录服务** | ✅ 条件分区 + 可重建 `_index` | — |
52
- | **系统调用面**(对外 API)| ⚠️ Python 库(`MdCG` 类)| **无 MCP 工具面 / CLI / 守护进程**;无版本化契约 |
53
- | **进程与会话模型** | ⚠️ 有文件锁 | **无租户/会话/身份**;多 agent 并发语义未定义 |
54
- | **权限与安全** | ❌ | 无访问控制(对比 noema:sensitivity cap + tombstone + payload-free 审计)|
55
- | **设备驱动**(数据源)| ❌ | 未接 AEIS 记忆库 / DSH 会话 / 视觉语音产出 |
56
- | **调度与生命周期** | ✅ flush/close/compact/rebuild | 无常驻服务、心跳、自愈 |
57
- | **可观测** | ✅ health + `_reflection.jsonl` + `_access.log` | 无指标导出/告警/看板 |
58
- | **与既有系统关系** | ❌ | AEIS 主库仍是 sqlite(`aeis_memory.db` 59MB)——**两套记忆并存,未统一** |
59
-
60
- ---
61
-
62
- ## 三、关键判断
63
-
64
- **md_cg 目前是「引擎(engine)」,不是「操作系统(OS)」。**
65
-
66
- 三处结构性差距(按优先级):
67
-
68
- 1. **系统调用面缺失** —— 它是 Python 库,不是服务。要成为 OS,必须暴露**稳定的对外接口**(首选 MCP 工具面,因为灵枢本身就是 MCP 服务、DSH 与其他 agent 天然可调)。
69
- 2. **与灵枢/AEIS 未统一** —— 认知图(md_cg)与 AEIS 记忆(sqlite)**并行两套**。OS 的前提是**单一权威存储**。
70
- 3. **进程/权限模型缺失** —— 多 agent 并发写、租户隔离、访问控制都还没有(文件锁只解决了互斥,没解决"谁可以写什么")。
71
-
72
- > 另:md_cg 已从 `llm-adapter-poc/` 实验工作区提取到工作区顶层 `md_cg/`(2026-09-09),一次性脚本留在原目录待清理。
73
-
74
- ---
75
-
76
- ## 四、路线(引擎 → OS)
77
-
78
- | 阶段 | 做什么 | 验收 |
79
- |---|---|---|
80
- | **P1 接口** | md_cg → MCP 工具面(remember/recall/search/verify/reflect/health/forget);DSH 插件可直连 | MCP 客户端可调用;与现有 dsh-memory 工具面兼容 |
81
- | **P2 统一** | AEIS 现有记忆(`aeis_memory.db`)迁移到 md_cg | **全量字段等价**(非抽样)+ 幂等 + 可回滚;沿用本次知识库 md 迁移经验 |
82
- | **P3 进程** | 常驻服务 + 会话/租户 + 权限(参考 noema:tenant.lock / sensitivity cap / tombstone / payload-free 审计)| 多 agent 并发写零丢失;越权写入被拒 |
83
- | **P4 驱动** | 接入实际数据源(DSH 会话、视觉/语音产出)| 端到端:一次会话 → 记忆 → 条件路由召回 |
84
-
85
- ---
86
-
87
- ## 五、结论
88
-
89
- - **引擎层已经成熟**:五层 + 条件路由 + 资格四态 + 认知循环 + 负记忆 + 并发/只读契约,**P0/P1 全绿,3058 节点实战**。
90
- - **OS 层刚起步**:缺**系统调用面(MCP)**、**单一权威存储(与 AEIS 统一)**、**进程/权限模型**。
91
- - **最优先**:把 md_cg 暴露成 MCP 工具面 —— 这一步完成后,它才真正从"库"变成"可被多个 agent 共同依赖的操作系统"。
92
-
93
- ---
94
- *(评估基于 dsh 端独立实跑:P0 25/25、P1 37/37、烟雾测试全通、3058 节点数据核查。)*
@@ -1,281 +0,0 @@
1
- # md_cg · 记忆操作系统(Memory OS)· 实现与接入
2
-
3
- > 在 MdCG(P0/P1 已验证引擎)之上补齐「记忆操作系统」能力,并暴露为 MCP 服务。
4
- > 2026-09-09 · 全部经 dsh 端独立实跑验证
5
-
6
- ---
7
-
8
- ## 一、本次交付
9
-
10
- | 文件 | 职责 |
11
- |---|---|
12
- | `md_cg/mdcos.py` | **MdCGOS**:在 MdCG 上新增记忆 OS 能力(7 项 + 后续 P8–P11) |
13
- | `md_cg/mcp_server.py` | **MCP server**(stdio + JSON-RPC 2.0,协议 2024-11-05,零依赖);**默认只暴露 2 个认知基元 `cg`/`stg`**(`MDCG_MCP_SURFACE=full` 才另见 29 个细粒度工具,供兼容/调试)|
14
- | `md_cg/consistency.py` | **节点间自动冲突检测**(三级决策:情绪 → 反思 → 递归反思)· 冲突自动触发飞轮 · **已接入 `cg(op=write)` 写入前校验** |
15
- | `md_cg/test_p2.py` | P2 验收(7 项能力)**36/36** |
16
- | `md_cg/test_p2_mcp.py` | MCP 协议验收 **63/63** |
17
-
18
- 回归:**P0 25 · P1 37 · P2 36 · P2-MCP 63 · P3 33 · P4 44 · P5 36 · P6 72 · P7 36 ·
19
- P8 34 · P9 37 · P10 24 · P11 27 · P12 32 · P13 42 · P14 44 · P15 53 · P16 46 · P17 55 ·
20
- 并发锁 300/300 全绿(共 776 项)**。
21
-
22
- > **2026-09-10 增补(md_cg 唯一真源)**:白箱 LLM provider 下线、AEIS 降为**能力库**;
23
- > 新增 `md_cg/whitebox.py`(`cg(op=whitebox)` 显式调用白箱并验证其「编码 / 已有知识回答」能力,
24
- > P18 **20/20**)与 `md_cg/migrate_roleplay.py`(角色/转录/互维 → 认知图,P19 **13/13**)。
25
- > **功能 → 代码 全表见 [功能调用映射表_v0.1.md](功能调用映射表_v0.1.md)。**
26
-
27
- ---
28
-
29
- ## 二、七项能力(对标 deja-vu / dsh-noema)
30
-
31
- | # | 能力 | 接口 | 要点 |
32
- |---|---|---|---|
33
- | 1 | **Fix pairs 自动挖掘** | `mine_fix_pairs(events)` | 行为日志「错误→修复」→ **knowledge/ 可路由修复知识** + **rejected/ 负记忆**(此错不必深挖根因);幂等 |
34
- | 2 | **role 分层索引** | `add(role=...)` · `search(roles=, include_work=)` | 工具输出/命令/编辑(`tool-output/command/edit`)**默认不参与正排**,避免稀释召回 |
35
- | 3 | **RRF 并行多路召回** | `search_rrf(...)` | 词法 / 条件桶 / 实体 / 图扩展 四路并行 → Reciprocal Rank Fusion;结果带 **provenance**(可审计)|
36
- | 4 | **审核队列 edit/merge** | `propose` · `review_list` · `review_decide` | 海马体式 `hippocampus/inbox.jsonl` → `decisions.jsonl`;裁决 **accept / reject / edit / merge** |
37
- | 5 | **tombstone + 恢复检查** | `forget` · `restore` · `is_tombstoned` | 软删除入 `trash/` + `_deletions.jsonl` 删除清单;恢复时校验,须 `force` 才可强恢复 |
38
- | 6 | **payload-free 审计 + 分片轮转** | `_audit` · `audit_records` · `rotate_audit` · `audit_scale` | 每次变更只记 `{t,op,id,actor,payload_hash}`,**绝不记内容**;活动日志超 `AUDIT_ROTATE_BYTES` 即 `os.replace` 原子切分(分片数 ≤ `AUDIT_KEEP_SHARDS`)⇒ **单文件与总量都有上界**;读数走 O(1) 元数据口径(超大历史分片只给量级并标 `exact=False`)|
39
- | 7 | **budget-driven pack** | `recall(query, budget_tokens)` | 装到预算花完;**超大条目跳过而非停下**(继续尝试更小的)|
40
-
41
- 另:`health_os()` 在原有健康度上并入 OS 指标(role 分布 / 待审数 / 墓碑数 / 审计事件数 / 反思数);审计面另透出**轮转证据**:`audit_shards` / `audit_total_bytes` / `audit_total_events` / `audit_total_exact` / `audit_oversized`。
42
-
43
- ---
44
-
45
- ## 三、DSH 接入(MCP)
46
-
47
- ### 3.1 启动
48
-
49
- ```bash
50
- # 在仓库根目录启动:路径全部相对当前目录,无需改任何绝对路径
51
- MDCG_ROOT="data/mdcg" \
52
- MDCG_ACTOR="dsh" \
53
- PYTHONPATH="." \
54
- python -m md_cg.mcp_server
55
- ```
56
-
57
- ### 3.2 DSH 侧配置(cordis.yml / MCP client)
58
-
59
- ```yaml
60
- - id: mdcg
61
- name: mdcg-mcp # MCP server(stdio)
62
- config:
63
- command: python
64
- args: ["-m", "md_cg.mcp_server"]
65
- env:
66
- MDCG_ROOT: "data/mdcg" # 相对 DSH 进程 cwd;cwd 不稳定时改成绝对路径
67
- MDCG_ACTOR: "dsh"
68
- PYTHONPATH: "." # 需在仓库根目录启动 DSH,python 才能 import md_cg
69
- ```
70
-
71
- ### 3.3 工具面(默认 kernel:只暴露 `cg` / `stg` 两个认知基元)
72
-
73
- > **架构**:对外只提供**认知图**工具。`cg(op=route)` 按情境条件路由,返回知识 +
74
- > **建议能力名(不执行)**,由调用方用本地代码执行——「认知图只给能力名,执行权归调用方」。
75
- > 下列 29 个细粒度工具仅在 `MDCG_MCP_SURFACE=full` 时可见,供兼容/调试。
76
-
77
- ```
78
- 写:mdcg_remember(gated=true 走主动遗忘闸门;consistency=true 走冲突检测)·
79
- mdcg_rejected · mdcg_unresolved · mdcg_propose
80
- 读:mdcg_get · mdcg_search · mdcg_recall · mdcg_review_list · mdcg_review_records
81
- 认知:mdcg_reflect · mdcg_verify · mdcg_flywheel · mdcg_mine_fix_pairs ·
82
- mdcg_consistency(check/history/stats/catalog)·
83
- mdcg_metacognition(观测面/校准/盲区/信任/self_check)·
84
- mdcg_predict(routes/feedback/stats/catalog)·
85
- mdcg_causal(path/gate/chain/explain/catalog)
86
- 生命周期:mdcg_forget(override)· mdcg_restore · mdcg_review_decide
87
- 保护/遗忘:mdcg_protect(盘点/查询/标记/快照/历史)· mdcg_forgetting_history
88
- 身份识别:mdcg_identity(observe/anchor/trait/profile/positions/catalog)
89
- 自我状态:mdcg_self_state(snapshot/refresh/bootstrap/relate/relations/index/
90
- dimensions/audit/history/summary/catalog)
91
- 运维:mdcg_health · mdcg_whoami · mdcg_ingest · mdcg_watermarks · mdcg_service_info
92
- 能力库:mdcg_whitebox(ask/remember/verify_encoding/verify_existing/ping/report)
93
- ```
94
-
95
- 写保护:`self` / `anchor` 层与 `protected` 标记、`importance≥0.7` 的节点**不可遗忘**,
96
- 删除/降级需显式 `override=true`(自动快照 + `_protected_audit.jsonl` 留痕)。
97
-
98
- **白箱能力库**(`cg(op=whitebox)`,`md_cg/whitebox.py`,2026-09-10):
99
- 白箱 LLM provider 已下线(不再注册 `lingshu-whitebox`);白箱能力改由 md_cg 显式调用并留痕:
100
- `action=ask` 问答 · `remember` 编码 · `verify_encoding` 验证编码能力(口令→追问命中)·
101
- `verify_existing` 验证已有知识回答能力(`route=self` 且非空)· `ping` · `report`。
102
- 结论写回 `self` 层(`tags` 含 `whitebox:verify`)。详见
103
- [功能调用映射表_v0.1.md](功能调用映射表_v0.1.md) §3。
104
-
105
- **持续性自维持**(`cg(op=sustain)`,P14 `sustain.py`):
106
- 心跳戳(`~/.mdcg/sustain/heartbeat.<name>.stamp`,含 ts / pid / uptime / task_running)
107
- → 分级判定(2.5× / 3.5× 心跳间隔;**任务执行中阈值放宽**,长任务不被误判死亡)
108
- → 只读诊断(索引漂移 / 孤儿索引 / 陈旧临时文件 / 半截日志行 / 增量积压 / 缺密钥私有节点)
109
- → 自愈(只重建索引、清陈旧临时、补日志换行——**永不删节点**;缺密钥只报告不修)
110
- → 会话水位续接(`_sessions.json` 记 (last_t, last_seq, events),重启不重复摄取)。
111
- MCP 进程启动即自维持(`MDCG_SUSTAIN=0` 关闭;`MDCG_SUSTAIN_BEAT/HEAL` 调间隔)。
112
-
113
- 主动遗忘闸门(写入侧三问 → 四态):重复?→ `redundancy`;重要?→ `importance`;
114
- 惊奇?→ 自信息代理 `-log2(dup+ε)`(结构类比量,非香农熵)。裁决
115
- `ACCEPT / MERGE / DROP / DEFER` 全部写入 `_forgetting.jsonl`,可审计。
116
-
117
- 身份特征识别(取代单一「用户画像」):识别每个主体(`self` / `user` / `role` / `agent`)
118
- 的**身份锚点 + 位置效应 + 条件特征**。位置效应取自智能论 v3.4 §十三 五大单元
119
- (记录=全 / 反思=新 / 验证=稳 / 输出=通 / 维生=存),按行为证据投票推断,
120
- 返回 `confidence / votes / evidence_count`,可审计「为什么判成这个位置」。
121
- 扮演论三接口:`memory`(历史证据→知识层)/ `anchor`(身份锚点→self|anchor 层,
122
- 不可遗忘;`role` 不得进 self 层)/ `values`(条件特征→结构层,条件空间即触发时机)。
123
- 留痕 `_identity.jsonl`。
124
-
125
- 节点间自动冲突检测(信息写入前校验 · 三级决策):`md_cg/consistency.py`。
126
- **L0 情绪** = 信息差二阶变化 d²D/dt²(approaching / stable / avoiding;原文强制
127
- **独立通道,不参与信任/资格计算**,只做流程调度)→ **L1 反思** = 条件论「反题」
128
- 检测(自否定 / 违反纪律 / 条件互斥)→ 四态路由 **ACCEPT / REJECT / DEFER / BLINDSPOT**
129
- → **L2 递归反思**(沿关系链找「区分条件」,受**深度 / 节点数 / 循环 / 信息增益门槛**
130
- 约束,智能论 :273:「若递归没有减少候选空间,就不应继续搜索」)。
131
- 冲突**自动触发知识飞轮**(误差 → 补条件 → 结构更新,:725),落 `unresolved` 条目;
132
- 留痕 `_consistency.jsonl`,可审计「为什么冲突 / 为什么放行」。
133
- 写入侧:`mdcg_remember(consistency=true)` 默认校验,`on_conflict=reject|defer|record`。
134
- 诚实边界:**条件级(结构化)冲突检测,非语义蕴含证明**;无法建立比对路径时返回
135
- BLINDSPOT,不假装确定。
136
-
137
- ### 3.4 典型调用序列
138
-
139
- ```text
140
- 会话开始 → mdcg_recall(query=用户请求, budget_tokens=1200)
141
- 情景写入 → mdcg_remember(content, gated=true) # 三问→四态筛选
142
- 重要判断 → mdcg_search(query, context=当前情境) # 拿 state(四态)
143
- 踩坑/修好 → mdcg_mine_fix_pairs(events) # 自动沉淀负记忆 + 修复知识
144
- 新知识候选 → mdcg_propose(...) → 人工/agent 审核 → mdcg_review_decide
145
- 需要清理 → mdcg_forget(id, reason) → 审计可查
146
- 保护审计 → mdcg_protect(action=stats|check) / mdcg_forgetting_history
147
- ```
148
-
149
- ---
150
-
151
- ## 四、验证命令
152
-
153
- ```bash
154
- cd <dsh-memory 仓库根目录>
155
- set PYTHONPATH=.
156
- python -m md_cg.test_p0 # 25/25 引擎基线回归
157
- python -m md_cg.test_p1 # 37/37 白箱架构回归
158
- python -m md_cg.test_p2 # 36/36 七项 OS 能力
159
- python -m md_cg.test_p2_mcp # 63/63 MCP 协议端到端
160
- python -m md_cg.test_p3 # 33/33 权限 + 设备驱动
161
- python -m md_cg.test_p4_fuzzy # 44/44 模糊检索
162
- python -m md_cg.test_p5_semantic # 36/36 语义路
163
- python -m md_cg.test_p6_consolidate # 72/72 固化
164
- python -m md_cg.test_p7_goals_recent # 36/36 目标 / 近期
165
- python -m md_cg.test_p8_subgraph_chain # 34/34 子图 / 关系链
166
- python -m md_cg.test_p9_forget_protect # 37/37 主动遗忘 / 写保护
167
- python -m md_cg.test_p10_identity # 24/24 身份特征识别
168
- python -m md_cg.test_p11_consistency # 27/27 节点间冲突检测(三级决策)
169
- ```
170
-
171
- ---
172
-
173
- ## 五、与竞品对照(本次补齐后)
174
-
175
- | 维度 | deja-vu | dsh-noema | **灵枢 md_cg(本次后)** |
176
- |---|---|---|---|
177
- | 负记忆 | Fix pairs 自动挖掘 | rejected 候选 | **Fix pairs 自动挖掘 + rejected/unresolved** |
178
- | 召回融合 | BM25 + 双 tier | BM25+PageIndex+图 **RRF** | **四路 RRF + 条件路由 T0–T3** |
179
- | role 分层 | ✅ 工具输出/命令/编辑不参与 | — | **✅ 同** |
180
- | 审核 | — | inbox→decisions(含 edit/merge)| **✅ 含 edit/merge** |
181
- | 隐私 | 索引时 redact | 敏感度+墓碑+payload-free | **✅ tombstone + 恢复检查 + payload-free** |
182
- | 预算控制 | budgeted digest | budget-driven pack | **✅ 跳过超大** |
183
- | 系统调用面 | 单二进制 | MCP stdio | **✅ MCP stdio(默认 2 个认知基元 cg/stg)** |
184
- | 独有 | — | — | **条件路由 + 资格四态 + CCG 五要素 + 信息差 D/d²D + 飞轮 + 三级冲突检测(情绪/反思/递归反思)** |
185
-
186
- ---
187
-
188
- ## 六、#2 进程/权限(公开知识 / 私有记忆隔离)
189
-
190
- > **动机**:灵枢是开源仓库,而记忆很大一部分是私有内容。权限模型必须让
191
- > 「公开知识」与「私有记忆」在**物理**与**逻辑**两层隔离。
192
-
193
- `md_cg/security.py` + `MdCGSecure`(mdcos.py):
194
-
195
- | 机制 | 说明 |
196
- |---|---|
197
- | **Principal** | `tenant / actor / clearance / can_write / can_admin / session` |
198
- | **密级链** | `public < internal < private < secret` |
199
- | **读隔离** | `search / recall / get / search_rrf` 一致过滤:clearance 之上的节点**不可见即不存在** |
200
- | **写隔离** | 写入敏感度 > clearance → `AccessDenied`;`secret` 对 clearance<secret **写入即拒** |
201
- | **管理隔离** | `forget / restore / review_decide` 需 `can_admin` |
202
- | **租户注册表** | `~/.mdcg/_tenants.json`:tenant → `{root, clearance_cap}`;**公开根在仓库内,私有根在仓库外** |
203
- | **夹紧** | `principal_for(tenant)` 把调用方 clearance 夹到租户上限(不能越租户) |
204
- | **审计** | 每条审计带 `tenant / session / clearance`(可追溯到哪个会话做了什么) |
205
-
206
- **私有内容加密(`md_cg/crypto.py` + `MdCGSecure`)**:
207
-
208
- | 机制 | 说明 |
209
- |---|---|
210
- | **加密范围** | 仅 `private` / `secret` 节点正文加密;`public` / `internal` 保持明文(可正常全文检索) |
211
- | **算法** | ChaCha20-Poly1305(RFC 8439)纯标准库实现,延续「核心零外部依赖」约束 |
212
- | **密钥层级** | KEK(`MDCG_MASTER_KEY` → `~/.mdcg/master.key`,缺失自动生成、0600、**在仓库外**)→ 包裹 → DEK(每 `tenant\|actor` 一把,存 `_keys.json`) |
213
- | **身份一致性** | 节点 AAD = `mdcg-node\|v\|tenant\|actor\|node_id`:换身份 / 跨节点挪用 / 换 KEK 一律解密失败 |
214
- | **密钥即访问权** | fail-closed:无密钥不降级明文——读按「不可见」处理,写 `private`/`secret` 直接拒绝 |
215
- | **统一写盘口** | 所有节点写入经 `_write_node`(先封装再原子写),杜绝 `get()` 解密后的明文被回写降级 |
216
- | **密文不检索** | 密文不参与全文索引,无密钥者只能走元数据;固化时密文节点跳过(不二次加密) |
217
- | **审计** | `_crypto.jsonl` 只记事件与指纹(`kek_fp` / `id_fp`),不含载荷 |
218
-
219
- MCP 侧通过环境变量配置:
220
- ```yaml
221
- env:
222
- MDCG_ROOT: "D:/.../public-root" # 公开租户
223
- MDCG_TENANT: "public"
224
- MDCG_CLEARANCE: "public" # public < internal < private < secret
225
- MDCG_CAN_WRITE: "1"
226
- MDCG_CAN_ADMIN: "0" # 管理操作默认关闭
227
- ```
228
-
229
- ---
230
-
231
- ## 七、#3 设备驱动(会话流 → 记忆)
232
-
233
- `md_cg/sources.py`:
234
-
235
- | 组件 | 说明 |
236
- |---|---|
237
- | **Source** | 统一事件流 `{t, seq, role, text, session, cwd}` |
238
- | **JsonlSource** | 通用 JSONL(字段映射可配)|
239
- | **DSHSessionSource** | 读 `~/.dsh/sessions/**/session.jsonl[.zstd]`;映射 `user/message→user`、`assistant/message→assistant`(reasoning 默认丢弃)、`tool/call→command`、`tool/result→tool-output`;zstd 为**可选**依赖,缺失优雅降级 |
240
- | **Ingestor** | 增量摄取:**watermark**(`_sources.json`)+ `(session,seq)` 去重 + 幂等 + **自动 fix-pair 挖掘** |
241
- | **默认策略** | 会话落 `contextual` 层,**sensitivity=private**(不进公开根)|
242
-
243
- 实测:真实 DSH 会话 **3/3 可解析**;增量摄取幂等;权限不足时 `denied` 计数 + `hint` 报告(不静默)。
244
-
245
- MCP 工具:`mdcg_ingest`(`source=auto` 自动发现本机 DSH 会话)、`mdcg_watermarks`、`mdcg_whoami`。
246
-
247
- ---
248
-
249
- ## 八、验收总表
250
-
251
- | 套件 | 覆盖 | 结果 |
252
- |---|---|---|
253
- | `test_p0` | 引擎基线(分桶/回退阶梯/只读契约/并发) | **25/25** |
254
- | `test_p1` | 白箱架构 9 维 | **37/37** |
255
- | `test_p2` | 七项 OS 能力 | **36/36** |
256
- | `test_p2_mcp` | MCP 协议端到端(含权限/摄取/冲突拦截) | **63/63** |
257
- | `test_p3` | #2 权限 + #3 设备驱动 | **33/33** |
258
- | `test_p4_fuzzy` | 模糊检索 | **44/44** |
259
- | `test_p5_semantic` | 语义路 | **36/36** |
260
- | `test_p6_consolidate` | 固化 | **72/72** |
261
- | `test_p7_goals_recent` | 目标 / 近期记忆 | **36/36** |
262
- | `test_p8_subgraph_chain` | 子图 / 关系链 | **34/34** |
263
- | `test_p9_forget_protect` | 主动遗忘 / 写保护 | **37/37** |
264
- | `test_p10_identity` | 身份特征识别 | **24/24** |
265
- | `test_p11_consistency` | **节点间冲突检测(三级决策)** | **27/27** |
266
- | `test_p12_metacognition` | 元认知 / 反思回路 | **32/32** |
267
- | `test_p13_encryption` | 私有内容加密 / 身份一致性 | **42/42** |
268
- | `test_p14_sustain` | **持续性自维持(心跳 / 自愈 / 会话续接)** | **44/44** |
269
-
270
- ---
271
-
272
- ## 九、下一步(OS 化剩余项)
273
-
274
- 1. **单一权威存储**:AEIS 私有记忆迁移 —— **暂缓**(开源仓库不能承载私有内容;
275
- 须等私有租户根(仓库外)就绪后再做)。
276
- 2. ~~**常驻服务**:会话/心跳/自愈~~ —— **已完成(P14 `sustain.py`)**:
277
- 心跳戳 + 分级判定(任务中阈值放宽)→ 只读诊断 → 自愈(索引/临时文件/日志边界,
278
- **永不删节点**)→ 会话水位续接 → `SustainLoop` 常驻线程 + `cg(op=sustain)`。
279
- MCP 进程启动即自维持(`MDCG_SUSTAIN=0` 可关)。
280
- 3. **更多驱动**:视觉/语音产出接入(`sources.py` 已是可插拔,加 Source 即可)。
281
-
@@ -1,93 +0,0 @@
1
- ---
2
- name: 跨端验证与同步协议_v0.1
3
- overview: 主代理(designer/DSH)与验证端(zcode,在 4_ai 隔离副本)之间「请求验证 → 出回执 → 台账闭合」的机械协议;载体=蜂巢任务(spec/result 留痕)+ 本地 git 传输 + 灵枢任务实体台账。
4
- 状态: 生效(v0.1 · 2026-09-17)
5
- 关联: docs/mdcg/全库代码评审与条件化注释_计划_v0.1.md
6
- ---
7
-
8
- # 跨端验证与同步协议 v0.1
9
-
10
- ## 一、角色与职责(使用者裁决 2026-09-17)
11
-
12
- | 角色 | 实体 | 职责 | 权限 |
13
- |---|---|---|---|
14
- | **主代理** | DSH 端 designer(actor=dsh-memory) | 编排、改码、**持有任务台账**、判定验证是否闭合 | 须含 `task` op |
15
- | **验证端** | zcode(在 **4_ai 验证面** `<verify-face>/dsh-memory`) | 独立复算与反证,产出**回执** | **无权设 task**;只出回执,不改台账 |
16
-
17
- > 台账归属是硬边界:`task` 由主代理写。验证端若要表达结论,走**回执**(第三节),不写任务实体。
18
-
19
- ## 二、同步通道(不经网络,不触第 14 条)
20
-
21
- 1. 主代理在 2_ai/dsh-memory 提交(pathspec 部分提交)。
22
- 2. 验证端从主代理仓**直接 fetch**(本地路径即远端):
23
- `git -C "<verify-face>/dsh-memory" fetch "<main-repo>/dsh-memory" main`
24
- (**占位符**:本机真实路径不入公开文档——第 14 条;执行时按本机部署替换)
25
- 然后 `git checkout -B verify/<verify_id> FETCH_HEAD`(或 merge)到隔离分支。
26
- 3. **验证面 = 已提交状态**:工作区未提交的在途改动**一律不进入验证面**——这是把「我的脏工作区」与「被验证的产物」分开的关键。
27
- 4. 4_ai 的独立性即互斥保证:验证端不写 2_ai,主代理不写 4_ai;两侧测试副产物(如 _md_cg_p27/、verify_cache.json)互不干扰。
28
- 5. 需要对公众发布时,主代理才 `push origin main`,且**推送前必须过第 14 条双清单**。
29
-
30
- ## 三、握手格式(蜂巢任务即信道)
31
-
32
- **请求(主代理 → 验证端)**:一条 task 台账卡 + 交给验证端的 spec 模板。
33
-
34
- ```
35
- [VERIFY-REQ] verify_id=<verify_id> commit=<sha> repo=<verify-face>/dsh-memory
36
- acceptance=<逐条可判的验收判据>
37
- commands=<验证端将执行的确定性命令(argv 形式,零 LLM)>
38
- ```
39
-
40
- **回执(验证端 → 主代理)**:验证端用蜂巢 `submit --spec` 派发确定性任务,spec 的 `user_prompt` 以如下行**开头**,结论落在该任务 `result.json`:
41
-
42
- ```
43
- [VERIFY-RESULT] verify_id=<verify_id> commit=<sha> verdict=PASS|FAIL|PARTIAL
44
- evidence=<命令输出摘要 / 失败项清单 / 与基线的差异>
45
- ```
46
-
47
- > 为什么用蜂巢:第 17 条已强制「执行性任务经蜂巢派发」,spec/status/result 三件套天然留痕——于是**回执不需要额外机制**,它就是一条已留痕的任务。
48
-
49
- ## 四、机械判定:怎么知道「验证完了」
50
-
51
- 主代理侧一条**只读巡检**(L1 可直跑,须输出一行留痕):
52
-
53
- 1. 记水位 w:发起请求时刻 `hive/jobs` 的最大 `created_ts`。
54
- 2. 枚举 `created_ts > w` 的任务,筛出 `spec.json` 的 `user_prompt` 以 `[VERIFY-RESULT]` 开头者。
55
- **防自证**:本端(actor=dsh-memory)派发的任务一律不算,只认非本端派发的回执。
56
- 3. **判定为「验证已回」的充要条件**:存在 `[VERIFY-RESULT]` 任务,其 `verify_id` 与 `commit` 与请求**逐字一致**,且 `result.json` 已落盘。
57
- 4. 命中 → 主代理据此写台账:`task action=status`(通过迁 `done` 且 result 必填;不通过迁 `blocked` 并记缺失维度)。
58
- 5. 未命中 → 状态是「**未收到回执**」;措辞不得是不可判定的「等验证中」。
59
- 6. **基线采集位置(迭代二修补 · 经编外复核两轮修正)**:在**同一验证面**上取两个期望——**基线 commit 的期望 vs 候选 commit 的实测**;禁止从发起端工作区取任何期望值(发起端工作区结果只用于「发起端是否引入回归」的自测,不得写入验收判据)。
60
- > 复核指出的原文缺陷:「期望值与实测值同源采集」表述含糊、有**同义反复风险**,故改为按两个 commit 显式命名。
61
- > 引用回归结果时必须逐字附 **SUMMARY 原文 + 失败清单原文**,不得只报「全绿/几红」这类概括。
62
- > **计数口径(经验证端纠正)**:分母 = **通过数 + 失败数**,跳过**单列**——实证「84/85 通过,3 跳过」= 84 通过 + 1 失败 + 3 跳过;「86/90 通过」= 86 + 4。故「84+3」不构成矛盾。
63
- > 更正记录:本协议迭代一曾据误读断言「SUMMARY 计数不自洽」,该断言**错误**,已由验证端指出并在此更正——**引用回归结果前先核口径,不确定就只附原文**。
64
- > 归因(智能论三问协议 · `CommonTrustProtocol/docs/条件论失败分析协议.md`):首轮判据写死「期望 3 红」= 在**发起端工作区**观测、却声明适用于**验证面** → 失配维度 = **观测位置 + 条件边界**;机制缺的条件声明 = 「基线采集位置 = 验证面」。
65
- > 证据:回执 job `h1789634407680_445c` 在 4_ai 纯净树得 **85/85 零红**,而发起端脏树有 3 红(源于 20+ 项未提交在途改动,与提交产物无关)。
66
- > 附:本节判定已机械化实现于**主代理侧仓外运维件** `<main-ops-dir>/poll_verify_receipt.py`(**刻意不入公开仓**:内含本机绝对路径,触第 14 条)。
67
-
68
- 7. **判据面同一性(迭代四~七 → 收口后回填 · 主体侧独立复算确认)**:把「判据是否被改动」变成一件可机械比对的事——
69
- - **集合**:`md_cg/**/test_*.py` + `scripts/run_tests.py`(收口后 98 文件)
70
- - **算法**:`sha256(按仓库相对路径升序拼接各文件字节)`,取前 16 个十六进制字符
71
- - **取数**:`python -X utf8 scripts/criteria_fingerprint.py --commit <rev>`(git archive 抽树,只读**已提交状态**,不触碰工作区)
72
- - **实证**:`5a2778a` → `c5a3280201a4499f`(97 文件),与验证端回执**逐字一致**(算法由此反解确认);收口后 `main` → `217a3a1b7c5db309`(98 文件),与验证端冻结值一致。
73
- - **权限边界**:判据的冻结与推进由验证端持有;主体只做**复算与比对**,不得自行改判据或自认通过。
74
- 8. **收口后置断言(本轮缺陷修补 · 强制)**:以 plumbing(临时索引 + `commit-tree` + `update-ref`)合并后,必须 `git read-tree <新提交>` 同步真实索引,并断言 `git diff <合并提交> <新提交> -- <代码面>` 为空;收口后附 `criteria_fingerprint --commit main` 与验证端冻结值的比对。
75
- > 缺陷实证:未同步索引时,紧随其后的普通 `git commit` 以**合并前树**落盘,把合并内容**静默还原**(历史里 merge 提交仍在,故两端都易漏看)。本轮由第 7 项的指纹比对发现:`main` 曾为 96 文件 / `be5bfbb5d03b4d3d` ≠ 冻结 97 文件 / `c5a3280201a4499f`,修正提交 `a0dad20`。
76
- > 同批证据:冻结后 `main`(隔离抽树)全组回归 = **SUMMARY 116/116 通过、3 跳过**,`criteria_fingerprint = 217a3a1b7c5db309`。
77
- ## 五、TTL 与措辞纪律
78
-
79
- - 每条请求带 deadline(建议 24h)。
80
- - 到期未回:主代理在会话中**明确报告「未收到验证回执」**并给出水位与检索证据;不得暗示已通过。
81
- - 严禁把「我自己的自测通过」表述为「已验证」——自测是主代理自身的验证门禁,不是第三方验证。
82
-
83
- ## 六、不适用条件
84
-
85
- - 不适用于纯查询/无仓库改动的任务(无产物则无需交叉验证)。
86
- - 不替代第 5 条(主代理自身须先过断言/回归)与第 14 条(推送前双清单)。
87
- - 不授权验证端写台账、改 2_ai 工作区、或代主代理提交。
88
- - 4_ai 的 .venv 与依赖环境由验证端自持;主代理不假定两侧环境一致,差异须在回执 evidence 中显式声明。
89
-
90
- ## 七、待定项
91
-
92
- 1. 验证端两个令牌当前 ops_allow=[*](含 task),与「验证端无权设 task」冲突 → 是否收窄为「全 op 减 task」待使用者确认。
93
- 2. 主代理令牌放行 task 后,mdcg MCP 常驻进程需重启才生效;期间的直调兜底口径待固化。