@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,337 +0,0 @@
1
- # 睡眠周期 · 运维前提与维护指南(v1.0)
2
-
3
- > **这一页回答一件事:开了睡眠周期之后,你的记忆库多了什么、在哪里、怎么维护、怎么关、怎么退。**
4
- > 依据:`docs/plans/睡眠与自迭代_功能优化设计_v0.4.md`(规格冻结版)§四 / §4.7。
5
- > 使用者裁定(2026-10-01,第三轮):「进行登记,让用户知道怎么维护记忆」。
6
-
7
- ---
8
-
9
- ## 一、睡眠周期是什么(一句话)
10
-
11
- 灵枢的**自迭代**(八步闭环的第 5 固化 / 6 记录 / 8 方向性自检)与**睡眠整理**合成一条周期引擎:在**睡眠时段**内,用**一个副本**做归纳 / 升层 / 巩固 / 权重与索引重建,完成后**周期性合并**回主库,并**留下修改历史**。
12
-
13
- **为什么用副本**:整理期间主库的**真源面**(八个层目录下的 `.md`)逐字节不变——长驻进程(serve / 蜂巢 / 会话)继续正常读写,整理结果只在合并那一刻以**受闸门约束**的方式落回。
14
-
15
- ---
16
-
17
- ## 二、版本库在哪里(唯一的"新增物")
18
-
19
- | 项 | 位置 | 说明 |
20
- |---|---|---|
21
- | **版本库(git 目录)** | `<state_root>/sleep/lib.git` | **在数据根之外**。用 `git --git-dir` 显式指定,**不在你的记忆库里放 `.git`** |
22
- | **影子工作树** | `<state_root>/sleep/shadow` | 整理实际发生的地方;每轮以 `git worktree` 建在分支 `sleep/<时间戳>` 上 |
23
- | **台账** | `<state_root>/sleep/` 下的轮次记录 | 每轮九步的逐步读数、语义差异集 Δ、冲突清单 |
24
-
25
- **版本库只覆盖真源面**:那八个层目录下的 `.md`。以下**结构性进不去**(用显式路径白名单而非 ignore 面保证):
26
- `_keys.json`(密钥信封)· `_access.log` · `_index.json` · `_index_log/` · `*.tmp`(临时件)· `*.lock`(锁件)。
27
- ⇒ **密钥与运行态从设计上就不可达**,不是"记得排除"。
28
-
29
- ---
30
-
31
- ## 三、维护动作(你要知道的四条)
32
-
33
- ### 1. 看历史
34
-
35
- ```bash
36
- git --git-dir=<state_root>/sleep/lib.git --work-tree=<root> log --oneline
37
- ```
38
-
39
- 一条睡眠周期 = **两个提交**:先是**内容提交**(语义重放落主库的那一刻,台账里记作 `round_commit`),随后是 `--no-ff` 的**合并提交**(只记拓扑,其树与内容提交同)。
40
-
41
- ### 2. 看某一轮改了什么
42
-
43
- ```bash
44
- git --git-dir=<state_root>/sleep/lib.git --work-tree=<root> show <round_commit>
45
- ```
46
-
47
- 逐节点的 before/after 另有 `_maintain.jsonl` 同族留痕(与权重重算共用一套)。
48
-
49
- ### 3. 回退(**只提供 `revert`**)
50
-
51
- ```bash
52
- git --git-dir=<state_root>/sleep/lib.git --work-tree=<root> revert <round_commit>
53
- ```
54
-
55
- **要 revert 的是该轮的「内容提交」**(台账 `phases.merge.round_commit`)——合并提交只是拓扑记录,对它 `revert -m 1` 对内容零影响(git 会报 nothing added to commit)。
56
-
57
- **裁定(第三轮):只给 `revert`,不提供 `reset --hard`。** 理由:`revert` 出一个**新提交**——历史不丢、可追、可再次审计;`reset --hard` 会抹掉历史,与「留下修改历史」的裁定相反。
58
- 回退是**显式发起**的动作,睡眠周期**永不自动回退**。
59
-
60
- ### 4. 冲突怎么处理
61
-
62
- 合并阶段若发现**主库与影子改了同一个 id**(或命中保护闸 / tombstone 闸 / 生命周期闸),该项**挂起**:**不自动解决**、**不写入主库**,出一个冲突清单等人处理(与蜂巢工作记忆 `hive/wm.py` 的既有裁决同款:冲突手交人工)。
63
-
64
- > 一句话:**git 只做记录者,准入由仓内既有闸门裁决**。所以「合并成功」不等于"git 没冲突",而是"过了语义四闸"。
65
-
66
- ### 5. 手动跑一轮(不等 tick)
67
-
68
- 手动入口是**同一条周期**的入口,不是旁路——它过的是同一套**四道门**:
69
-
70
- ```bash
71
- python -X utf8 -m md_cg.sleep --once # 立即一轮:过四道门并落台账
72
- python -X utf8 -m md_cg.sleep --once --dry-run # 只预览:跑盘点与四道门,不物化、不记账
73
- python -X utf8 -m md_cg.sleep --status # 只读:含 last_cycle(上一次为何没迭代)
74
- ```
75
-
76
- - `--once` 与常驻 tick 调的是同一个 `run_cycle`;**门没过就只记一条台账**,并显式打印
77
- 一行 `本轮未迭代原因:…`——**该行与台账同一文案源**(「门拦」/「物化未完成」/「幂等」
78
- 三类可辨,见 §九)。
79
- - `--dry-run` **只与 `--once` 同用**(单独使用直接报错并返回 2,不执行任何动作)。
80
- - `--status` 的 `last_cycle` 段给出最近一条台账记录的 `t` / `batch` / `round` /
81
- `candidates` / `skipped`、②③④ 的 skip 文案与 `phases.materialize` 摘要——
82
- **「上一次为什么没迭代」从 CLI 直接可看**,不必翻 `_sleep.jsonl`。
83
-
84
- ---
85
-
86
- ## 四、开关与可调项(全部可调)
87
-
88
- | env | 缺省 | 语义 |
89
- |---|---|---|
90
- | `MDCG_SLEEP` | `1`(开) | 睡眠周期总开关;设 `0` 即整条周期不再启动 |
91
- | `MDCG_SLEEP_INTERVAL` | `3600` | 周期(秒),缺省一小时一次 |
92
- | `MDCG_SLEEP_WINDOW` | `23:00-07:00` | **睡眠时段**(本地时间);**支持跨午夜**;留空 = 全时段;**窗口外只记账、不迭代** |
93
- | `MDCG_SLEEP_MERGE` | `auto` | 合并策略:`auto`(自动执行四阶段)/ `ask`(合并前询问)/ `never`(只留副本不合并)。**`auto` 下冲突仍挂起** |
94
- | `MDCG_SLEEP_GITDIR` | 空 | 覆盖版本库位置(缺省 `state_root()/sleep/lib.git`) |
95
- | `MDCG_SLEEP_SHADOW` | 空 | 覆盖影子工作树位置(缺省 `state_root()/sleep/shadow`) |
96
- | `MDCG_SLEEP_SCRUB_APPLY` | `0` | 第④步「去污染实改」的闸门;**缺省只盘点不落盘** |
97
- | `MDCG_TEMPORAL_GAMMA` | `ln2/30天` | 时间邻近度的衰减率(半衰期 30 天,与既有 `links.py` 同刻度);可调 |
98
- | `MDCG_CHAIN_TYPES` | 空 | **因果路沿哪些边类型扩散**(逗号分隔,大小写不敏感)。留空 = 缺省集 `causal,sequential,applies_to`。**这一项决定因果路在语料库上有没有东西可走**:从文档/叙事语料切出来的节点只有 `reference` 与父章节结构边,**没有 causal 边**,所以对这种库要显式设成 `MDCG_CHAIN_TYPES=reference,part_of`(或含 `sequential`)——否则因果路恒空。只接受 `chain.EDGE_WEIGHTS` 里已登记的类型,未登记形态会被剔除并回落缺省集 |
99
- | `MDCG_SUSTAIN` | `1` | 常驻自维持循环总开关(睡眠周期挂在它上面) |
100
-
101
- > **整条关掉**:`MDCG_SLEEP=0`;**连常驻循环一起关**:`MDCG_SUSTAIN=0`。
102
-
103
- > **调度前提(v1.1 补)**:睡眠周期**没有自己的进程**——它挂在常驻 `sustain` 循环的
104
- > **第六档 tick** 上(缺省 `MDCG_SLEEP_INTERVAL=3600` 秒一次);**进程不在就不跑**,
105
- > 也没有补跑机制(错过的 tick 不追)。跑一轮要过**四道门**:总开关
106
- > `MDCG_SLEEP` / `MDCG_SLEEP_MERGE=never` / 睡眠窗口 / 稳态候选数为 0。
107
- > 手动入口 `--once` 过的正是这同一套门(见 §三.5)。
108
-
109
- ---
110
-
111
- ## 五、自动的边界(哪些永不自动)
112
-
113
- | 动作 | 可自动 | 依据 |
114
- |---|---|---|
115
- | 归纳 / 升层 / 权重重算 / 索引重建 | ✅ | 确定性、可预演、可回滚;索引是派生物 |
116
- | 去污染**实改** | ⚠ 缺省关(`MDCG_SLEEP_SCRUB_APPLY=0`) | 在副本上可放行,合并前可复核 |
117
- | **任何依赖 LLM 的固化** | ❌ **永不自动** | 依赖 LLM 的动作交人工另批 |
118
- | **任何不可回滚的删除** | ❌ **永不自动** | 五环承诺:遗忘只能由显式 `cg(op=forget)` 发起 |
119
- | 方向性自检 | ✅ 只产**记录** | 理论纪律:自检结果**不自动触发修改** |
120
-
121
- **「合并前可复核」在缺省配置下由什么保证**:缺省 `MDCG_SLEEP_MERGE=auto` 会在**同一轮**内把已过闸的改动一并落主库,所以严格的「合并前人工看一眼」窗口只由 `MDCG_SLEEP_MERGE=ask` 提供。另外**去污染实改缺省就是关的**(`MDCG_SLEEP_SCRUB_APPLY=0`),所以缺省配置下最具侵入性的那一档根本不会落盘——要用它,请显式开启并配 `ask` 档。
122
-
123
- **窗口值写错了会怎样**:`MDCG_SLEEP_WINDOW` **留空**=全时段(这是唯一的显式全时段入口);**非法形态**(例如 `23:00-99:99`)按同表 `INTERVAL`/`MERGE` 的既有回落口径**回落缺省 `23:00-07:00`**——不会因为打错字而变成全天迭代。
124
-
125
- ---
126
-
127
- ## 六、健康读数(每轮都留)
128
-
129
- 每轮睡眠在台账里留:①盘点候选数 ②本轮语义差异集 Δ 的大小 ③过了四闸多少、挂起多少 ④是否空轮(候选 0 ⇒ 只记账不动手)⑤九步逐步读数(未接线的步骤显式标 `skipped`)。
130
-
131
- `cg(op=sustain, action=status)` 可看到最近几轮;命令行侧另有
132
- `python -X utf8 -m md_cg.sleep --status` 的 **`last_cycle`** 段(最近一条台账记录的
133
- `t`/`batch`/`round`/`candidates`/`skipped`、②③④ skip 文案、`phases.materialize` 摘要
134
- 与 `not_iterated_reason`)——**「上一次为何没迭代」不必翻台账文件**。
135
-
136
- ---
137
-
138
- ## 七、前提一句话总结
139
-
140
- > 睡眠周期会在 `<state_root>/sleep/lib.git` 建一个**只覆盖真源面**的版本库,用它做**副本迭代 + 周期合并**,合并准入走仓内既有语义闸门(不是 git 的文本合并),回退只给 `revert`,冲突挂起等人处理。**密钥与运行态结构性进不去这个版本库。**
141
-
142
- ---
143
-
144
- ## 八、P2 / P4 落地后的检索与权重变化(2026-10-01 · 发版披露)
145
-
146
- > 依据:`docs/plans/睡眠与自迭代_功能优化设计_v0.4.md` §5.1–§5.4 / §七。
147
- > **这一节是「默认检索读数变了」的对外说明**——改动前基线与改动后读数见
148
- > `scripts/p2p4_probe.py`(同一命令在改前 worktree 与改后工作区各跑一次)。
149
-
150
- ### 1. 六要素后两行进默认检索(§5.4)
151
-
152
- `# 验证方式`(后置条件词)与 `# 不适用条件`(拒绝域词)现在进**索引条目**
153
- (`postcondition_terms` / `rejection_terms`,与 `time_window` 同款「免读文件」扁指标量),
154
- 并进**默认检索路径**:
155
-
156
- - 问「**怎么验证的 / 用什么方法证明**」或查询词命中验证手段 ⇒ 召回声明了该手段的节点;
157
- - 问「**什么条件下不适用 / 何时不适用**」⇒ 召回**声明了拒绝域**的节点,结果卡带
158
- `boundary_hit` 标记(`meta.boundary` 里有独立计数);
159
- - **普通问句下拒绝域仍不作召回键**(反例命中只由资格判定处置)——灵敏度一字不动。
160
-
161
- **拒绝域双语义**:边界命中(`boundary_hit`)与资格 `REJECT` 是**两件事**,
162
- 分开计数、分开呈现;「问它什么时候不适用」不会把节点自己打成 REJECT。
163
-
164
- **口径提醒(务必知道)**:`mdcg_recall` 的缺省**融合口径是 `max`**(因因果路缺省进路),
165
- 这影响**所有**默认召回调用,**与库里有没有边无关**;要 `sum`(经典 RRF 求和)请显式传
166
- `fusion="sum"`。(这是设计稿 §6.2 的既定口径,本批**补披露**,行为未变。)
167
-
168
- ### 2. 权重刷新与衰减进主分数(§七)
169
-
170
- 检索分数现在是:`score ← score × cred_factor(γ, Δt) × refresh(访问计数)`。
171
-
172
- | env | 缺省 | 语义 |
173
- |---|---|---|
174
- | `MDCG_FRESHNESS` | `1`(开) | 刷新/衰减乘子总开关;**设 `0` 即回到改动前口径**(与既有部署逐位一致,是「可回退」的第一道闸) |
175
- | `MDCG_FRESHNESS_NOW` | 空 | 参照时刻(unix 秒)。**只为守卫/探针的确定性**;留空 = 系统时钟 |
176
- | `MDCG_TEMPORAL_GAMMA` | `ln2/30天` | 衰减率(与时间路同一读取点) |
177
-
178
- 三条必须知道的语义:
179
-
180
- 1. **老记忆会被降权**(这正是「召回被旧的历史记忆干扰」的处置):未被调用的记忆按
181
- `ln2/30 天` 半衰期衰减,下限 `0.001`(floor,不会归零到不可召回);被经常调用的
182
- 记忆按 AEIS `consolidate_cycle` 的既有门槛刷新(`access_count % 10 == 0` 且
183
- `last_access > 0` 才 +1%)。
184
- 2. **保护线不会被衰减穿过**:受保护节点(`importance ≥ 0.70`)的衰减乘子有下界
185
- `0.70 / importance` ⇒ `importance × 乘子 ≥ 0.70` 恒成立,节点不会因衰减
186
- **自动失去保护**。
187
- 3. **不可遗忘 ≠ 不可覆盖;降级不是删除**:`freshness.recalc(apply=True)` 只写
188
- `freshness_weight` 与 `freshness_state="degraded"` 标记,**从不删节点**;要跨层
189
- 降级走既有 `_move_layer`(内含 `protect.guard_move`,受保护节点需显式 `override`)。
190
-
191
- **粒度说明(本批的一处取舍)**:Δt 以**整日**为粒度(向下取整)。理由:γ 的单位本来
192
- 就是「天」;仓内有「同查询两轮结果逐位一致 / 可复算」的硬纪律,不量化则分数会随
193
- 系统时钟逐轮微变;量化后两侧(Python / Rust)在同一「天」桶上恒同值。量化损失上界 =
194
- γ × 1 天 ≈ 2.3%。
195
-
196
- **回滚(三件套,与权重重算同款)**:预演 `freshness.recalc(apply=False)` →
197
- 逐节点 before/after 落 `_maintain.jsonl`(`action="freshness"`)→
198
- 反向 `freshness.rollback(batch=...)`。AEIS 侧**没有**预演与回滚,这是移植时的净增。
199
-
200
- ### 3. 读侧语言面的已知边界(**不要**把对拍 10/10 当成已对齐)
201
-
202
- | 侧 | 缺省路集 | 说明 |
203
- |---|---|---|
204
- | Python | **6 路**:lexical / bucket / entity / graph / chain / temporal | 生产读面 |
205
- | Rust | **4 路**:lexical / bucket / entity / graph | 评测/嵌入读面,**尚未**实现 chain/temporal 与六要素后两行索引键 |
206
-
207
- `scripts/rank_parity.py` 现在仍报 10/10,**只因其语料无 edges / 无时间参数 /
208
- 无六要素后两行声明**(缺省差异在这类语料上不可观测)——它是「两侧同口径下逐位一致」
209
- 的证据,**不是**「两侧已对齐」的证据。P4 乘子的两侧逐位对拍另配了**有判别力**的夹具
210
- (同分不同龄的节点,见 `md_cg/test_p4_freshness.py` 的 G12)。
211
-
212
- ---
213
-
214
- ## 九、行为口径更新(v1.1 · issue #60/#61):**物化成功即迭代**
215
-
216
- > 这一节说明「读数与调度口径变了什么」。三条变更都能在台账与 CLI 上直接对拍。
217
-
218
- ### 1. 「物化成功」与「真源面未变」拆成两个读数
219
-
220
- 此前 `materialize()` 的 `ok` 把两件事混在一起:物化窗口内主库真源面被**别的写方**
221
- 改动过(活跃库里这是常态),`ok` 就是假,调用方据此**跳过整轮迭代**——越有料越不
222
- 整理(自我否决)。现在二者分开:
223
-
224
- | 读数 | 含义 |
225
- |---|---|
226
- | `phases.materialize.ok` | **物化动作是否成功**(影子挂上了没:不 busy、能独立开库) |
227
- | `phases.materialize.face_stable` | **主库真源面在物化窗口内是否逐字节未变**(= 原 `ok` 的真值) |
228
-
229
- ### 2. 物化成功即迭代;真源面漂移交**并发闸**(主库优先)
230
-
231
- `face_stable=False` **不再阻止**迭代。迭代期间主库被改动/新增的**同一 id**,由第 ③ 段
232
- 对账的**并发闸**(物化时记下的 `baseline_face` 水位)逐项判「**主库优先**」、挂起不
233
- 自动解决(同 §三.4)。`source_face_delta` 与 `baseline_face` 两个读数**原样保留**。
234
-
235
- ### 3. 台账 skip 文案分类,不再混成一句(v1.2 补「物化超时」一支)
236
-
237
- ②③④ 步的 `skipped` 现在明确区分「门拦」与「物化未完成」(CLI 的
238
- `last_cycle.not_iterated_reason` 与 `--once` 打印的那一行**同源**,即下表文案本身):
239
-
240
- | 台账文案 | 含义 |
241
- |---|---|
242
- | `窗口外(MDCG_SLEEP_WINDOW=…;只记账不迭代)`/`MDCG_SLEEP=0(总开关关)`/`MDCG_SLEEP_MERGE=never(只记账不迭代)`/`稳态:盘点候选数为 0(只记账不动手)` | **门拦**:按设计不动手 |
243
- | `物化未完成:根级锁被占(另一进程在周期内)`/`物化未完成:<error 摘要>` | **物化未完成**:想动手却没做成(取不到根级锁/影子未挂上) |
244
- | `本轮未迭代` | `ledger_steps` 的**缺省兜底**(`run_cycle` 的三条路径都显式给文案,不落这条) |
245
- | `物化超时:<error 摘要>` | **物化超时**(issue #63):git 子进程超时已被 kill——**操作没完成**,与「git 的裁决失败」分开(见 §十) |
246
-
247
- ---
248
-
249
- ## 十、常驻循环的卡死防护与观测(v1.2 · issue #63)
250
-
251
- > 这一节说明「循环卡住会怎样、怎么第一时间看出来、怎么处置」。三层无界
252
- > (时间 / 输入 / 观测)在本批一并收口,读数与处置全部落在**既有面**上。
253
-
254
- ### 1. 三层无界,三处消灭
255
-
256
- `SustainLoop._run()` 是**单线程串行六档**(心跳 → 自愈 → 自净 → 演化 → 整理 →
257
- 睡眠):任一档**无界阻塞**,整条循环停摆(issue #63 实测停 **9.5 小时**:六档
258
- 全停、`loop.state=dead`、心跳年龄无限增长)。三层根因与修法:
259
-
260
- | 层 | 根因(现场判据见 §十.4) | 修法 |
261
- |---|---|---|
262
- | ① 时间无界 | `sleep._git()` 调 git **无 `timeout=`**——子进程无界等待 | `timeout=_GIT_TIMEOUT_S`(**120s**,模块常量单点可调):超时即 kill |
263
- | ② 输入无界 | 同处**未指定 `stdin`** ⇒ 子进程**继承父进程 stdin**——DSH 常驻宿主的 **JSON-RPC 活管道**(不写入也不关闭) | `stdin=subprocess.DEVNULL`:读 stdin 的子进程立即 EOF(先例形态 `md_cg/run_tests.py:105`) |
264
- | ③ 观测无界 | tick 台账在 `run_cycle` **返回后**才写 ⇒ 卡住期间 `phases` 为空,外部读不到卡在哪档 | 六档进 / 出各刷**既有心跳戳**:`current_tick` / `last_tick_done` / `last_tick_error`,另给 `stale_tick` 告警 |
265
-
266
- **超时语义(可区分)**:git 超时抛 `SleepGitTimeout`(`SleepError` 子类),消息含
267
- 「git … 超时(120s)已被 kill」+ 命令名;它与 git 的 rc≠0 失败
268
- (`git … 失败: <stderr>`)是**两条**文案面。物化档的台账文案同样分两支:
269
- `物化超时:…` vs `物化未完成:…`(issue #60 的 mat_fail 文案族续)。
270
-
271
- ### 2. 读数:`cg(op=sustain, action=status)` 新增进度四字段
272
-
273
- | 字段 | 含义 | 读法 |
274
- |---|---|---|
275
- | `current_tick` | 此刻正在跑的档:`{name, started_at, pid}` + `running_s`(已运行秒数);空闲为 `null` | 卡住时这一条直接回答「卡在哪档、多久了」 |
276
- | `last_tick_done` | 上一档完成读数:`{name, t, ok}`(`ok=false` = 该档抛了异常) | 与 `last_tick_error` 配套看失败态 |
277
- | `last_tick_error` | 最近一次档内异常:`{name, t, error: 类名+摘要}`——**容忍 ≠ 静默**(六档异常一律记入此处;由**单点包装**实现,`_run` 的六档 try/except 形态逐字未改——既有守卫 `md_cg/test_sleep_p1.py` G3a 把它钉死) | 非 null 即至少有一档在报错 |
278
- | `stale_tick` | 告警:`current_tick` 年龄 > `max(2×该档 interval, 1800s)` 时给出 `{tick, age_s, limit_s, alert}`(alert 含档名与已运行时长) | 非 null = **疑似卡死** |
279
-
280
- 写点即**既有心跳戳**(`<net_dir>/heartbeat.<name>.stamp`)——不新增状态文件;
281
- 每档**进入时**就刷一次(卡住场景下「没有下一次写」是常态,所以必须在进入时
282
- 落盘),退出时清 `current_tick` 并记 `last_tick_done`。同进程读内存、跨进程
283
- 回落戳内字段。
284
-
285
- ### 3. 处置:`stale_tick` 报出来之后怎么办
286
-
287
- `stale_tick` **只告警、不杀线程**(线程不可安全强杀;强杀会留下半截写)。
288
- 处置 = **人工重启常驻进程**(宿主侧重启 serve / 重新拉起灵枢插件);重启后从
289
- 心跳戳与 `<state_root>/sleep/_sleep.jsonl` 台账接着看。
290
-
291
- **残留锁(有界自清,2026-10-06 落地)**:git 子进程被 kill 后可能留下 `index.lock`
292
- ——现由 `sleep._clear_git_lock` **有界**自清(三闸口径):①只碰本模块影子仓
293
- (单属仓,无第三方合法持锁面);②时机两处——`_git` 每次调用**前置巡检**清
294
- **超龄锁**(mtime ≥ 300s ≫ 全调用 120s 超时上界,即崩溃残留),超时 kill 后
295
- **force 清**当场残留(此刻仓内锁只可能来自被 kill 进程);③其余一律不动——
296
- 超时消息如实带「已自动清理 / 未动,若后续报 lock 请人工核删」处置读数。
297
- 清理动作记一行 `git_lock_cleared` 台账(含 age_s/force)。守卫
298
- `python -X utf8 -m md_cg.test_sleep_gitlock`(8 断言,含「新锁不误删」反向腿)。
299
-
300
- ### 4. issue #63 的现场判据(四条,引录)
301
-
302
- 1. **停摆形态**:六档全停(心跳 / 自愈 / 巡检 / 演化 / 整理 / 睡眠),
303
- `loop.state=dead`、心跳年龄无限增长——单线程串行的放大效应。
304
- 2. **时间无界**:`sleep._git()` 无 `timeout=`——子进程无界等待。
305
- 3. **输入无界(受控复现)**:父 stdin 为「活管道(不写入不关闭)」时,读 stdin
306
- 的子进程 **6 秒后仍悬挂(poll=None)**;`stdin=DEVNULL` 时 **0.02s 立即 EOF
307
- 返回**。
308
- 4. **观测无界**:tick 台账 / `phases` 在 `run_cycle` 返回后才写 ⇒ 卡住期间外部
309
- **无法知道卡在哪档**(`phases` 空)。
310
-
311
- ### 5. 同批加固面(常驻可达面之外)
312
-
313
- `md_cg/interop.py`(git add/commit)· `md_cg/audit.py`(test_cmd)·
314
- `md_cg/units.py`(tasklist)· `md_cg/bench_locomo_zh.py` / `md_cg/bench_zh_mad.py`
315
- (评测跑批,1800s)· `md_cg/bench_governance.py`(git rev-parse)统一补
316
- `timeout=` + `stdin=subprocess.DEVNULL`;`md_cg/whitebox.py` 的 Popen 是
317
- **长驻对话协议面**(stdin=PIPE 与后端持续对话),**不在加固面**(申报理由)。
318
-
319
- ### 6. 守卫
320
-
321
- `python -X utf8 -m md_cg.test_sustain_bounded`(T1 参数面 / T2 真超时有界 /
322
- T3 循环续走回归 / T4 进度面 / T5 审计面)+ `--mutate` 定点变异自证
323
- (删 `timeout=` / 删 `stdin=DEVNULL` / 删进入写点 / 删 `last_tick_error`
324
- 四条,每条必须转红;「红项」一律取**本轮自身**计数)+ `--mutate --null`
325
- 空转检出对照(new==old 的无害变异必须判 MISS——钉住「拿累计值当本轮红项」
326
- 一类判据失效通道)。
327
-
328
- ---
329
-
330
- ## 修订记录
331
-
332
- | 日期 | 要点 |
333
- |---|---|
334
- | 2026-10-06 | **v1.3**(退役/锁裁定批):残留锁**有界自清**落地(`_clear_git_lock` 三闸+`_git` 两时机:前置巡检清超龄、超时 kill 后 force 清;台账 `git_lock_cleared`;守卫 `md_cg.test_sleep_gitlock` 8 断言)——原「是否自动清理待裁(issue #63 台账)」收口 |
335
- | 2026-10-06 | **v1.2**(issue #63):常驻循环三层无界收口——①`sleep._git` 加 `timeout=120s` + `stdin=subprocess.DEVNULL`(超时抛 `SleepGitTimeout`,与 rc≠0 失败文案分开、物化超时另支文案)②六档进/出刷既有心跳戳(`current_tick` / `last_tick_done` / `last_tick_error`)+ `stale_tick` 告警(只上报不杀线程,处置=人工重启)③同批加固 interop / audit / units / bench×3(whitebox Popen 不在加固面)——见 §十 |
336
- | 2026-10-06 | **v1.1**(issue #60/#61):①物化 `ok` 拆为「物化成功」+ `face_stable` 读数,**物化成功即迭代**(真源面漂移交并发闸、主库优先)②新增手动入口 `--once` / `--once --dry-run`(零落盘预览)与 `--status` 的 `last_cycle` 读数 ③台账 skip 文案区分「门拦」与「物化未完成」——见 §三.5 / §四 / §六 / §九 |
337
- | 2026-10-01 | v1.0 首版:版本库位置 / 维护动作(看历史·看改动·只 revert 的回退·冲突挂起)/ 开关与自动边界 / P2·P4 发版披露(§一–§八) |
@@ -1,270 +0,0 @@
1
- # 认知图 · P0 收口 证据单(G2 索引接线 + G3 能力标签)v0.1
2
-
3
- > 来源:`docs/mdcg/认知图_索引与工程规范化_计划_v0.1.md` 的 R4/R5 前置项 —— **G2(文档/代码索引接线)** 与
4
- > **G3(能力标签注入)**;G1(生效条件口径接线到各前缀)已于上一批次闭合(`evo-20260910-152148-2b35`)。
5
- > 目标工程:**dsh-memory / md_cg(认知图 + 记忆 OS)**
6
- > 证据口径:源码级核对 + **真实库(`AEIS/data/mdcg`)复算** + 前后冻结基线对照(不采信估计值)
7
- > 时间:2026-09-10 | 真实库批次:索引全量 1 轮 + 增量 1 轮、`cap_v01`(回滚抽样 1 条 → `cap_v01_restore`)
8
- > 演化条目:`evo-20260910-155442-28f8`(口径对齐)、`evo-20260910-155442-7ccf`(cap 阈值裁定)
9
-
10
- ---
11
-
12
- ## 判定单
13
-
14
- ```
15
- 条件空间:观测位置=全局(设计者)、操作层在 md_cg 写入口之外(只经既有 op 调用)
16
- | 观测工具=真实库复算(_index.json / _refindex.json / _backfill.jsonl / 盘上 frontmatter) + 前后冻结基线
17
- | 时间窗口=2026-09-10 本次迭代
18
- | 存在约束=零新依赖(纯标准库) / md 单一真相源 / 不新增写入口 / 不改默认参数 / 预演先行
19
- 白箱三问:依据=每条给文件级或计数级证据(§三/§四/§五),未核实项显式标出(§九)
20
- | 条件=执行前已预演(cap_plan 只读)、已有基线冻结(before)、可复算(final)、可回滚(cap_rollback 实测)
21
- | 错后=若索引侧仍写单槽 observation_position,等于在刚清理过的污染源上重开入口:
22
- conditions_pending 预计由 145 涨到约 1951 → 「生效条件声明率」被自己灌水,待补台账失真
23
- 裁决:ACCEPT(G2 全量索引 + 口径对齐 + G3 阈值上调注入)
24
- / DEFER(全量索引节点需要的 cap 判定:单关键词档 5179 条命中整体 REJECT)
25
- / 待定项:(a) node_id 跨类同名归并 27 id/34 条;(b) 常驻服务内存视图陈旧;(c) 基线 P95 口径未固化
26
- 依据:条件证据见 §三~§六,非相似度
27
- 缺失维度:索引节点的「能力归属」——索引只产出「位置+结构」,不产出「这条属于哪个 op 的能力」
28
- (这正是 G3 要补的,也是 G4/G5/G6 的前置)
29
- 验证路径:口径对齐(§二) → 全量索引(§三) → 水位/幂等/巡检(§三) → cap 阈值裁定+注入+回滚(§四) → 指标对照(§五) → 副作用归因(§六)
30
- 关注信号:conditions_pending 是否被单槽灌水;召回面扩大后 GLOBAL_CAP 截断率;密级是否被索引降级
31
- ```
32
-
33
- ---
34
-
35
- ## 一、本轮范围与执行通道
36
-
37
- | 项 | 本轮 | 依据 |
38
- |---|---|---|
39
- | **G2** 索引接线(md_cg / src / docs 三大域) | ✅ 执行 | 计划 §六 R4/R5 的前置「先有索引」 |
40
- | **G3** 能力标签注入(`cap:<op>`) | ✅ 执行 | 计划 §四「索引节点缺能力归属」 |
41
- | G1 生效条件口径接线到各前缀 | ⏸ 已闭合 | 上一批次,见 `docs/mdcg/认知图_条件空间合成与生效条件口径_v0.1.md` |
42
- | G7 / G8 / G4 / G5 / G6 | ⬜ 不执行 | 登记待定(§八);G8 已裁定方案留作后续依据 |
43
-
44
- **执行通道(必须记录的环境事实)**:常驻 MCP 服务进程启动于当日改造**之前**,其内存模块缺 `CONDITION_SLOTS` / `condition_space_text`
45
- (调用即 `AttributeError`),且存在「水位先于节点落库被推进」的假成功(`_refindex.json` 记 `indexed=1403` 而知识层未增)。
46
- 故本轮**不杀进程**(会连带停掉 sustain 心跳),改用「同 principal(designer / `can_admin` / `clearance=secret`)+ 同
47
- `mcp_server.call_tool(cg,"cg",args)` 入口 + 新进程」驱动,`MDCG_SUSTAIN=0` 避免起第二心跳。
48
- → 该选择同时带来一处**观测工具失配**,已在 §6.2 归因。
49
-
50
- ---
51
-
52
- ## 二、改动清单(3 处实现 + 3 处断言)
53
-
54
- | 文件 | 改动 | 目的 |
55
- |---|---|---|
56
- | `md_cg/codeindex.py` | 新增 `condition_space(item)`:位置=源大域(`path` 首段)、方法=`compiler`(AST 精确)/弱提取(显式降级)、时间=全时窗哨兵、约束=「源文件 … 存在于本地仓且可读」;`render()` 的 `# 生效条件:` 行改调 `nodefile.condition_space_text(condition_space(item))`,替换「大域=…;检索…时」方言 | 口径对齐 |
57
- | `md_cg/docindex.py` | 同上:位置=`本地文档仓(大域=…)`、方法=文档提取、时间=全时窗、约束=「文档文件 … 存在且可读」 | 口径对齐 |
58
- | `md_cg/refindex.py` | `add_items()` 的 `condition_space` 由**单槽** `{"observation_position": 大域}` 改为复用 `codeindex/docindex.condition_space(it)`;新增 `_domain_of(it)`(`path` 首段 or `orphan`),`tags` 追加 `domain:<域>` | 口径对齐 + 路由域改由标签显式承担 |
59
- | `md_cg/test_p26_refindex.py` / `test_p27_docindex.py` / `test_p28_refcheck.py` | 断言同步:四槽齐备、`condition_space_text` 非空、正文=四槽合成、全时窗哨兵、弱提取降级、`frontmatter.condition_space == condition_space(item)`、`routing.route_key(...) == routing.normalize_domain(...)` | 守门 |
60
-
61
- **未改动**:`backfill.py`(`_condition_text` 已删单槽回退——保持为**独立校验口径**,避免「改完又用同一处校验」)、
62
- `mdcg.py` / `mdcos.py`(检索与写盘语义不动)、`nodefile.py`(唯一合成入口本体)。
63
- **未改默认参数**:`min_conf`/`max_files`/`max_items` 一律由调用参数传入。
64
-
65
- ---
66
-
67
- ## 三、G2 取证(全量索引三大域)
68
-
69
- ### 3.1 逐域索引结果
70
-
71
- | 大域 | op | 条目 | 文件 | truncated | errors | skipped_suffixes |
72
- |---|---|---|---|---|---|---|
73
- | `md_cg/` | `index_code` | 1403 | 88 | **false** | 0 | — |
74
- | `src/` | `index_code` | 111 | 8 | **false** | 0 | — |
75
- | `docs/` | `index_doc` | 333 | 20 | **false** | 0 | `.html`/`.jpg`/`.json`/`.png`/`.yml`(无提取器,显式列出) |
76
-
77
- 均为 `incremental=false` 首次全量;三域条目数远低于默认上限(`max_files=500` / `max_items=2000`),无截断。
78
-
79
- ### 3.2 落库与对账
80
-
81
- - 登记 1847 条 → **唯一节点 1813**(`code_` 1480 + `doc_` 333),差额来源见 §6.3。
82
- - `op=ref action=stat`:`schema=2`、`files=116`、`nodes=1847`。
83
- - `op=ref action=check`:`checked=1813`、`stale=0`、`dangling=0`、`unresolved=0`。
84
- - `op=info`:`total_nodes` 4526 → **6339**。
85
-
86
- ### 3.3 幂等(增量重跑)
87
-
88
- `incremental=true` 重跑一轮:`skipped_unchanged` 生效、`indexed` 不增、`node_id` 集合稳定(`codeindex.node_id`/`docindex.node_id`
89
- 为稳定短哈希,按 id 原子覆盖,不清目录)。水位键为**源文件绝对路径**(一份认知图可索引多个大域,按 `rel` 记会在同名文件上互相覆盖)。
90
-
91
- ### 3.4 口径守门的核心结论
92
-
93
- `conditions_pending` **保持 145**(`缺约束 7` + `缺载体/位置+方法+约束 138`),**未**如预演那样涨到约 1951。
94
- 即:1813 个新节点的四槽齐备率为 100%,未产生任何「单槽冒充生效条件」的待补条目。
95
- → 这是本轮唯一的实现改动(口径对齐)的**正面验收证据**:若不做 §二 的改动,全量索引会把约 1806 个单槽节点直接灌进库。
96
-
97
- ---
98
-
99
- ## 四、G3 取证(能力标签注入)
100
-
101
- ### 4.1 阈值裁定(执行前,只读预演)
102
-
103
- 预演(默认 `min_conf=0.5`)显示:规则表含「读 / 目标 / 一致性」等宽泛词,而 `confidence = 0.4 + 0.2×命中词数`,
104
- **仅命中 1 个词即达 0.6 会被注入**;其中「验证」一词因 CCG 正文必含 `# 验证方式:` 行而在索引节点上近乎全命中
105
- (预演命中 `cap:verify` 1630/1813)。
106
- 分层抽检回读正文:0.6 档样本为文档章节(词只出现在**被引用段落**),0.8/1.0 档样本落在真实承载模块
107
- (`_verdict` / `forgetting.summary` / `_ref_call`)。
108
- → 裁定(`designer-perspective` 四态):**单关键词命中一律不构成具备该能力的资格**;把 `min_conf` 上调为 **0.8**,
109
- **不改码、只传现成参数**。单关键词档 5179 条命中整体判为 **REJECT**。
110
-
111
- ### 4.2 注入结果(批次 `cap_v01`)
112
-
113
- | 指标 | 注入前 | 注入后 |
114
- |---|---|---|
115
- | `nodes_with_cap` | 1 | **369** |
116
- | `cap_tag_total` | 1 | **398** |
117
- | `distinct_caps` | 1 | **26** |
118
-
119
- Top:`cap:whitebox` 59、`cap:predict` 41、`cap:route` 37、`cap:session` 25、`cap:sustain` 22 …
120
- (`cap:verify` 由预演的 1630 收敛到 **14**——阈值上调的直接效果。)
121
- 只改 `frontmatter.tags`,**不动正文**;全程留痕于 `_backfill.jsonl`(`action=cap` / `batch=cap_v01`,369 条)。
122
-
123
- ### 4.3 回滚验证(抽样反证,非纸面承诺)
124
-
125
- | 步骤 | 实测 |
126
- |---|---|
127
- | `op=maintain action=cap_rollback batch=cap_v01 entry_ids=[ce8b4664e9ad]`(`cap:theory`) | `reverted=1` / `tags_removed=1` / `conflict=0` / `missing=0` |
128
- | 随即按新批次恢复 `action=cap, apply=true, batch=cap_v01_restore, min_conf=0.8` | `planned=1` / `written=1`(其余 368 条 `skipped_present` → 幂等) |
129
- | 复算 | `cap_tag_total` 398 → 397 → **398**,`nodes_with_cap` 369 保持一致 |
130
-
131
- `cap_rollback` 只移除**仍在 tags 里**的标签,防覆盖后续人工修改——因此它是安全的**部分回滚**,不是整表撤销。
132
-
133
- ---
134
-
135
- ## 五、验收指标对照(冻结基线 vs 收口后)
136
-
137
- | 指标 | 基线(G3 注入前,G2 已完成) | 收口后 | 判 |
138
- |---|---|---|---|
139
- | `total_nodes` | 6339 | 6339 | 不变(G3 只改 tags) |
140
- | `code_` / `doc_` | 1480 / 333 | 1480 / 333 | 不变 |
141
- | `ref`(schema/files/nodes) | 2 / 116 / 1847 | 2 / 116 / 1847 | 不变 |
142
- | `conditions_pending` | 145(缺约束 7 + 缺三槽 138) | **145**(同上) | **未被灌水** ✅ |
143
- | `nodes_with_cap` / `cap_tag_total` | 1 / 1 | **369 / 398** | G3 生效 ✅ |
144
- | `distinct_caps` | 1 | **26** | ✅ |
145
-
146
- > 说明:基线文件冻结于 **G2 已完成之后**,故它同时充当「G2 结果」与「G3 变化量」的参照;
147
- > G2 自身的基线是计划前状态:`total_nodes=4526`、`cap` 仅 1 条、`_refindex.json` 存在但 1813 节点未落库。
148
-
149
- ---
150
-
151
- ## 六、副作用与归因(显式登记,不静默)
152
-
153
- ### 6.1 召回面扩大(本轮最大代价,已知且有量化)
154
-
155
- | 口径 | 候选池 | LIKE 命中 P50 | P90 | **P95** | P99 | max | 均值 | 被 `GLOBAL_CAP=500` 截断 |
156
- |---|---|---|---|---|---|---|---|---|
157
- | 全量(含索引节点) | 6336 | 15 | 2348 | **2580** | 3437 | 5708 | 658.5 | **300/870(34.5%)** |
158
- | 剔除 `code_`/`doc_` | 4523 | 13 | 1343 | **1380** | 1759 | 3895 | 347.5 | **247/870(28.4%)** |
159
-
160
- **归因**:G2 的边际贡献 = P95 `1380 → 2580`(×1.87)、max `3895 → 5708`、截断率 `+6.1pp`(+53 条/870)。
161
- **但截断的主体(28.4%)在 G2 之前就已存在**——这不是本轮引入的问题,本轮只是把它放大了约 1/5。
162
- → 处置建议(不在本轮):索引节点应在**召回路由阶段**被降权或分池(`domain:` 标签已就位,可直接做域级路由),
163
- 而不是继续吃 `GLOBAL_CAP`。这是 G4/G5 的输入。
164
-
165
- ### 6.2 密级:**无降级**(观测工具失配,非事实变更)
166
-
167
- 盘上 `frontmatter`(真相源)复算:
168
-
169
- | 口径 | private | internal | 说明 |
170
- |---|---|---|---|
171
- | 索引前 | 4525 | 1 | — |
172
- | 索引后(盘上) | **4525** | **1814** | 旧节点 private 计数**完全不变**;新增 1813 全部 internal |
173
- | `_index.json` | 4525 | 1814 | 与盘上逐字一致 |
174
- | 层分布 | knowledge: private 4516 / internal 1814 | self: private 5 | anchor: private 4 | | 新节点全部落 knowledge |
175
-
176
- **归因**:曾有 `op=info` 报 `sensitivity_counts={"internal": 6339}`,即「private 全变 internal」。经复算判定为
177
- **常驻服务内存视图陈旧**(进程启动早于改造,`self.index` 为旧快照),**不是**密级降级:① 盘上 private 计数与索引前完全相同;
178
- ② `_index.json` 同口径复算一致;③ `mdcos._sensitivity_counts` 读取的正是 `index["nodes"][*]["sensitivity"]`,字段未丢。
179
- → 待定项:重启 MCP 服务以统一视图(§八)。
180
- 附:`body` 加密分布 `plain 6249 / enc 90`,未受本轮影响。
181
-
182
- ### 6.3 `node_id` 跨类同名归并(既有设计缺陷,本轮首次暴露)
183
-
184
- `codeindex.node_id(item) = sha1(path + "::" + name)` —— 键**不含父类名**,故同一文件内跨类同名方法被归并为同一 id。
185
- 实测:登记 1847 → 唯一 1813,**冗余 34 条 / 27 个 id**(占 1.8%),分布:
186
-
187
- | 源文件 | 冗余 | 已核实的同名 def |
188
- |---|---|---|
189
- | `md_cg/mdcos.py` | 12 | `__init__` `add` `_audit` `_candidates` `_neg_coverage` `search_rrf` … |
190
- | `md_cg/signer.py` | 4 | `sign`×3 `verify`×3 `describe`×3 `public`×2 |
191
- | `md_cg/sources.py` | 3 | `events`×3 `key`×3 `__init__`×4 |
192
- | `md_cg/sustain.py` / `whitebox.py` | 2 / 2 | `summary`、`ask`、`remember` … |
193
- | `md_cg/fsutil.py` / `security.py` / `test_p18_whitebox.py` / `src/index.ts` | 各 1 | `__init__` 等 |
194
-
195
- **影响有界**:后写入者胜(同 id 原子覆盖),`_refindex.json` 保留全部区间;`ref check` 全部 `ok`。
196
- **不本轮修**:改 id 键会破坏既有 id 稳定性与幂等,需单独立项(加 `parent` 入键 + 存量迁移,或同文件同名加序号后缀)。
197
-
198
- ---
199
-
200
- ## 七、回滚点
201
-
202
- | 对象 | 回滚方式 | 性质 |
203
- |---|---|---|
204
- | 代码(§二 的 3 处实现 + 3 处断言) | 反向应用 diff | 无损 |
205
- | cap 标签(398 条 / 369 节点) | `op=maintain action=cap_rollback batch=cap_v01` | **部分无损**:只移除仍在 tags 里的标签 |
206
- | 索引节点(1813 个 `code_`/`doc_`) | 按 id 删除 + 删 `_refindex.json` | **有损**:需重跑索引重建 |
207
- | 水位 `_refindex.json` | 直接删除即退化为全量索引 | 无损(纯派生物) |
208
-
209
- ---
210
-
211
- ## 八、待定项登记
212
-
213
- | # | 待定项 | 现状 | 建议动作 |
214
- |---|---|---|---|
215
- | 1 | **G7 / G8 / G4 / G5 / G6** | 未执行 | G8 已裁定:`op=link` 只对**新增节点**常态化建链、历史不回填;G4/G5/G6 待前置 |
216
- | 2 | `node_id` 跨类同名归并(27 id / 34 条) | 已定位成因(`path::name` 不含父类) | 单独立项,含存量迁移方案 |
217
- | 3 | 常驻 MCP 服务内存视图陈旧 | `op=info` 密级/cap 计数与盘上不一致 | 重启 MCP 服务(本轮为保 sustain 心跳未重启) |
218
- | 4 | 召回截断:34.5% 查询被 `GLOBAL_CAP` 截断 | 主体(28.4%)为存量问题 | 索引节点域级分池/降权,而非继续吃全局 cap |
219
- | 5 | 索引新鲜度未自动化 | 依赖手工重跑 | 上游变更后跑 `incremental` 重跑;可挂 `sustain.diagnose` 的 `ref_stale`(已接入) |
220
- | 6 | 基线 P95「89」口径未固化 | 无法同口径复现 | 见 §九-1 |
221
-
222
- ---
223
-
224
- ## 九、诚实边界
225
-
226
- 1. **「触发词命中 P95 基线 89」无法同口径复现**:benchmark 自带的 `--ablate pool` 口径跑在**合成库**(1000 节点)上,
227
- 实测中位 8 / max 366 / 截断 0/870,与真实库不同源。本轮真实库同口径(bench 同款查询集生成:`n=250, seed=7`,
228
- 池 = `cg._candidates()` 读出集)复算得 P95=2580(全量)/1380(剔除索引节点)。
229
- → 结论:§6.1 的**相对归因**(1380→2580、+6.1pp)可信;**绝对值与「89」不可直接比较**,因为基线口径未固化。
230
- 2. **索引是「可索引」,不是「可理解」**:`code_`/`doc_` 是确定性静态索引,不含语义蕴含;跨表述的
231
- 「这段代码实现了那段文档的意思」不解决(与「有意剔除神经嵌入」的既有裁定一致)。
232
- 3. **索引质量上限 = 源文件注释质量**:无 docstring/首段的符号只能索引到签名或标题。`docs/` 侧 `docs/` 下非 md
233
- 文件(`.html`/`.png`/`.yml` 等 5 类)**显式列出**而非静默丢弃,但它们确实未被索引。
234
- 4. **cap 标签是「词面证据的保守子集」,不是能力证明**:阈值上调只把「明显不合格」挡在门外;0.8 档仍可能有个别误标
235
- (规则表含宽泛词),故 `cap_rollback` 是必备出口。它**不构成**「该节点具备该 op 能力」的充分证据。
236
- 5. **§6.3 的 27 个 id 归并意味着**:对同名方法,认知图里只能查到**一个**(后写者),另一处的正文虽在 `_refindex.json`
237
- 有区间记录,但不在图里可检索。这是**已知覆盖缺口**,不是本轮回归。
238
- 6. **本轮无「dangling/unresolved=0」之外的漂移证据**:`ref check` 在索引完成的同一时刻测得,源文件此后若被改动,
239
- 需重跑才能判 `stale`。巡检只承诺「可检出」,不承诺「自动跟随」。
240
-
241
- ---
242
-
243
- ## 十、回归与留痕
244
-
245
- **回归(全部模块 `rc=0`)**:
246
-
247
- | 用例 | 结果 | 用例 | 结果 |
248
- |---|---|---|---|
249
- | `test_p21_tokens` | 31 / 0 | `test_p28_refcheck` | 45 / 0 |
250
- | `test_p26_refindex` | 55 / 0 | `test_p30_maintain` | 55 / 0 |
251
- | `test_p27_docindex` | 56 / 0 | `test_p32_backfill` | 58 / 0 |
252
- | `test_p33_ccg_wiring` | 58 / 0(全部通过) | `test_p37_condition_space` | 42 / 0 |
253
-
254
- **演化留痕**:`evo-20260910-155442-28f8`(索引产物的生效条件必须与唯一合成入口同源)、
255
- `evo-20260910-155442-7ccf`(词面命中不等于具备该能力,`min_conf` 上调为 0.8)。
256
-
257
- **派生产物**(均在仓库之外):
258
-
259
- ```
260
- AEIS/data/mdcg/
261
- ├── _refindex.json # G2 水位(schema=2、116 源文件、1847 条登记)
262
- ├── _backfill.jsonl # G3 批次留痕(+369 条 action=cap / batch=cap_v01)
263
- ├── _index.json # 6339 节点(+1813)
264
- ├── _evolution/ledger.md # 本轮 2 条演化条目
265
- └── knowledge/ # 新增 code_ 1480 / doc_ 333 节点
266
- ```
267
-
268
- ---
269
-
270
- *证据单生成:2026-09-10 · §三~§六 全部为真实库复算结果(非估计)· 未核实项已单列 §八/§九 · 一次性临时驱动脚本已清理*