@furongjun1999/dsh-memory 0.8.1 → 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 -659
  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 -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 +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_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  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,176 +0,0 @@
1
- # 鲸娘七类状态追踪 v1.0——人物/地点/时间/事件/因果/物品/情感
2
-
3
- > 使用者 2026-10-06 指令:「按照理论和现有功能将人物,地点,时间,事件,因果,物品,情感等状态进行追踪。」
4
- > 前置=鲸娘语料预处理第一步(思考块剥离+双身份分流,件 `scripts/whale_corpus_prep.py`)。
5
- > 本件:`scripts/whale_state_tracker.py`(v7),**单点复用** P1 抽取器 v4 的机件与被复核规则。
6
-
7
- ---
8
-
9
- ## 一、理论依据(纪律 1:先查理论)
10
-
11
- | 来源 | 借用的口径 |
12
- |---|---|
13
- | 《AI 故事创作的状态维护调研 v0.1》 | **八维度**(情节/人物/心理/环境/世界/时间/地点/物品)与状态寄存器 schema——本件按使用者给定的七类取法落地 |
14
- | 《角色扮演一致性锚调研 v0.1》 | **四问审计法**;更新语义三分——**不变式**(永不改)/ **可覆盖**(新值替换旧值)/ **追加**(只增不改) |
15
- | P1 抽取器 v4(三率已复核) | 切块/引用块剥离/证据短证/五元事件机件与 11 个槽位规则(**单点复用,不复制第二份**) |
16
-
17
- ## 二、七类编目(真实语料读数)
18
-
19
- **输入**:鲸娘主语料(1546 轮段);**输出**:26 条五元事件(`state_events_v7.jsonl`)+编目(`v7_catalog.json`)。
20
-
21
- | 类别 | 事件 | 槽位 | 更新语义(挂账口径) |
22
- |---|---|---|---|
23
- | 人物 | 7 | 记忆特性×2、名字×1、外貌规格(体型)×2、日记制度×2 | 不变式为主(名字=可覆盖+撤回) |
24
- | 地点 | 2 | 住所×1、店铺规模×1 | 可覆盖(迁移) |
25
- | 时间 | 1 | 时节×1 | 追加(背景事实) |
26
- | 事件 | — | **台账行族=26 条**(每条五元事件即事件记录,seq=时间轴;不重复建槽) | 追加 |
27
- | 因果 | — | 0 独立槽位(v1 **以证据链 quotes/seq 承载**——见 §四噪声依据) | 追加 |
28
- | 物品 | 9 | 宝物清单×4、房贷×3、菜品与菜单×2 | 可覆盖+追加 |
29
- | 情感 | 7 | 关系阶段×5、早安吻与早安咬×2 | 可覆盖(关系);追加(互动) |
30
-
31
- **未分类=0**(fail-visible 设计:任何未入映射的槽位会显式列出,本跑为空)。
32
-
33
- **v7 新增规则(仅一条,词形基于探针实测)**:`时间·时节`——首现「夏天|夏日」
34
- (探针:盛夏 0 命中;夏天/夏日 5 命中,首现轮 394)。
35
-
36
- ## 三、端到端验证(现有功能全链,隔离库)
37
-
38
- 抽取 → **MCP `cg(op=state_event)`** → 台账 → `state_slots` 投影 → `stg(op=state_chain)` 查询:
39
-
40
- ```
41
- 写入 26/26 条;投影槽位数 12(隔离根为临时目录,已清理)
42
- 鲸鱼小姐·住所 = '海边的大房子(海景别墅)'(active)
43
- 鲸鱼小姐·名字 = None(retired) ← 撤回事件正确退役
44
- 鲸鱼小姐·房贷 = None(retired) ← 用户侧声明玩笑后作废
45
- 鲸鱼小姐·关系阶段 = '合伙人/老板娘(开店)'(active)
46
- …
47
- ```
48
-
49
- 零在役库写入(`--feed` 走临时隔离根;`--feed-root` 显式给出才保留供复核)。
50
-
51
- ## 四、边界与如实声明
52
-
53
- - **「承诺」类不做独立抽取**:词形 `答应|说好了|约定|拉钩` 全篇 **138 命中**——口语高频,
54
- 独立抽槽必产噪声;v1 如实不做(候选读数存档,留待更专门的方法)。
55
- - **「因果」类不做裸词形抽取**:`为了` 59 命中 / `因为` 225 命中,同为口语高频;
56
- v1 以**证据链**(每条事件的 quotes 轮号+seq 时间轴)承载因果可查性——
57
- 完整因果图属后续(可接 `cg(op=causal)` 边面,另立)。
58
- - **「事件」类不建独立槽位**:每条五元事件本身就是事件记录(锚分类学的「追加类锚」),
59
- 重复建槽=第二真源,明确不做。
60
- - 类别编目**不改 v4 槽位名**(与 P1 三率读数同源,零重命名零漂移)。
61
- - 「时节」属背景事实类(非争议状态),首现轮来自角色侧叙述亦采——与 v4「用户侧=事实源」
62
- 的政策面(争议状态)不同层,已注明。
63
-
64
- ## 五、复跑命令(中性占位)
65
-
66
- ```bash
67
- # 七类编目(只读语料、输出仓外)
68
- python -X utf8 scripts/whale_state_tracker.py --corpus <语料.md> --out <仓外目录>
69
-
70
- # 端到端(MCP 全链,隔离临时根)
71
- python -X utf8 scripts/whale_state_tracker.py --corpus <语料.md> --out <仓外目录> --feed
72
- ```
73
-
74
- ---
75
-
76
- ## 六(v1.1 增补)· 状态追踪图:世界书 + 大事记 + 分幕大纲
77
-
78
- 使用者 2026-10-06:「整理出完整的状态追踪图……可以追溯故事的完整发展脉络和内容变化。
79
- 类似酒馆世界书或者是小说故事的大纲。」
80
-
81
- **件** `scripts/whale_state_atlas.py`——一份 md 三视图同源(现有功能单点复用:事件经
82
- 库层 `state_events.append` 落台账 → `state_slots.project(include_retired=True,
83
- history=True)` 投影出具**权威**现值/退役/变迁史;幕末快照按事件序现算):
84
-
85
- 1. **世界书条目**(按七类分节):每个槽位一张卡——**现值**/状态(active|retired)/
86
- **变迁史**(old→new、五类 kind、发生时点轮号、≤30 字证据短证可回原文核对)——
87
- 即「酒馆世界书条目」的可追溯版(带变更链,而非静态设定)。
88
- 2. **大事记时间线**:全部状态事件按序一行一条(轮号|类别|槽位|变更|类型)。
89
- 3. **分幕大纲**:幕界=事件间隔机械聚类(gap ≥ 60 轮)+**单事件幕并入后幕**(机械
90
- 规则,避免碎读)——本语料实测 **5 幕**:轮 136–613(定身份/背景/记忆澄清)、
91
- 687–1040(宝物入账/搭档)、1108–1245(搬迁/规格修正/房贷撤回)、1308–1413
92
- (开店/新菜)、1475–1534(日记制度/晨间仪式/扩张);每幕含事件清单+
93
- **幕末状态快照**(该时点各槽位现值)——「每章末世界长什么样」。
94
-
95
- **实测读数**:26 事件 → 12 槽位卡;md 7,447 字;产物落私域(`--out` 仓外 fail-closed)。
96
-
97
- **如实边界**:本图是**状态骨架**(状态事件轴),非全量情节摘要(无情节抽取器);
98
- 分幕为机械聚类非情节判断;证据短证 ≤30 字、含轮号。**可选后续**:导出酒馆格式
99
- worldbook JSON(key=槽位/实体触发词 + content=现值与变迁——待规格确认后做)。
100
-
101
- ```bash
102
- # 状态追踪图(读 v7 事件 → md;输出必须仓外)
103
- python -X utf8 scripts/whale_state_atlas.py --events <state_events_v7.jsonl> \
104
- --out <仓外 .md 路径> [--act-gap 60]
105
- ```
106
-
107
- ---
108
-
109
- ## 七(v1.2 增补)· 通用常驻件:多主体状态追踪(核心能力定位)
110
-
111
- 使用者 2026-10-06 定位:「这个功能可以常驻,维护其他角色的状态追踪,这应该要作为
112
- 语义时空图的核心功能。」
113
-
114
- **交付** `scripts/state_atlas.py`——**通用多主体**追踪图(与语料线两件并列):
115
-
116
- - **常驻形态=查询时现算只读视图**(与 `state_slots` 同哲学,不存第二真源):任何时刻
117
- 调用即得最新;台账为唯一真源。**不依赖后台任务**。
118
- - **多主体**:`--subject` 单取,缺省把库中**全部主体**各出一节(一份 md=全角色世界书);
119
- 类别缺省按槽位「·」前缀推断,可 `--cat-map` 传映射表(鲸娘七类表即一例)。
120
- - **三视图同款**(世界书卡/大事记/分幕)+ 可选 `--worldbook-json`(酒馆风格
121
- `[{keys, content, subject}]`)。
122
- - **库根解析与 zcode MCP 同源**(`--root`>env>`~/.zcode` 配置>缺省;复用一个 resolve
123
- 单点)——**防双库分叉**的接线实测:不带 `--root` 运行时解析到权威库根(曾抓出过
124
- 缺省根指向 C 盘遗留库的分叉缺陷,本件不再踩)。
125
- - 只读;`--out` 一律仓外(fail-closed)。
126
-
127
- **实测读数**:
128
-
129
- | 项 | 读数 |
130
- |---|---|
131
- | 多主体演示(隔离库:鲸娘真语料 26 条+合成第二角色 4 条,合成条已在演示脚本标注) | **2 主体 / 30 事件 / 15 槽位 / md 7,783 字 / worldbook 15 条** |
132
- | 权威在役库实测(只读) | 台账 **0 条事件**、0 主体——机制全链就位、数据处女地;空库优雅退(171 字纯头) |
133
- | 根解析同源 | 不带 `--root` 实跑解析到权威库根 ✓ |
134
-
135
- **记账纪律(通用指引,从本语料线三层消歧口径提炼)**:状态变更发生时记账;用户侧
136
- 声明优先;非事实三类(玩笑/元层/回忆转述)如实标注不复盖;撤回=old 有值 new 空。
137
-
138
- **待裁(常驻自动化增强)**:是否在睡眠周期「整理」档挂「按主体预生成追踪图 md →
139
- 状态面」——现状按需现算已满足「打开即最新」,预生成仅为「打开就有文件」的缓存物;
140
- 改常驻循环属生产行为变更,须单独立项。
141
-
142
- ```bash
143
- # 通用多主体追踪图(任意库、任意主体;输出必须仓外)
144
- python -X utf8 scripts/state_atlas.py [--root <库根>] [--subject <主体>] \
145
- --out <仓外 .md> [--acts] [--worldbook-json <仓外 .json>]
146
- ```
147
-
148
- ---
149
-
150
- ## 八(v1.3 增补)· 会话链路接入:轮写入链第二步(使用者 2026-10-06 裁定)
151
-
152
- > 「把这个功能作为会话的 10 轮信息写入,并在写入 mdcg 的时候做处理……每次写入
153
- > 异步加了一些过程,但是好处是得到了可维护的状态……原始信息的关系追溯。」
154
-
155
- **件** `scripts/state_extract.py`+`sync_zcode_session.py` 接线(每轮写入链第二步):
156
-
157
- - **接线**:`sync_to_window`(zcode 端每轮——Stop 钩子/冷启动/压缩恢复共用)在写
158
- `_recent` 窗口的**同一循环内**,对同一轮调保守抽取 → `state_events.append` 进台账。
159
- 钩子轮末子进程运行=会话外处理(「异步」);**逐轮 fail-soft**,抽取失败绝不影响
160
- 窗口写入。
161
- - **保守口径**:只抽用户轮(真人=事实源);仅两条高精度规则(`地点·所在` 迁移 /
162
- `情感·偏好`,负向显式记「不喜欢:」);值剥句尾语气词;同值去重;证据
163
- `[auto] session=… turn=…`+`actor=state_extract`(可整体甄别/清理);开关
164
- `MDCG_STATE_EXTRACT` **缺省开**(=0 关)。
165
- - **三层同源**:认知图(`_recent`/知识面)+语义时空图(台账/投影/`state_atlas`)+
166
- 原文(会话 md 镜像/全量转写),evidence 互指——关系可追溯。
167
- - **读数**:守卫 `scripts/test_state_extract.py` **10/10**(噪声三族「在看不抽/计划
168
- 不抽/助手轮不抽」零命中、去重、变值成链 old→new、证据格式、开关、接线单点);
169
- 全量 **359/359**。
170
- - **DSH 端**:同款接线在插件侧(TS),属后续件(须改插件并随包发布);本批仅
171
- zcode 端在线。
172
- - **已知边界(留裁决)**:「住在这里」类泛化词形会命中,收窄与否归使用者。
173
-
174
- ---
175
-
176
- *v1.3 · 2026-10-06 · 编排侧编制;v1.0 规则与端到端+v1.1 状态追踪图+v1.2 通用常驻件+v1.3 会话链路接入(轮写入链第二步)*
@@ -1,385 +0,0 @@
1
- # 主代理 + 子代理的记忆架构设计
2
-
3
- > 目标:主代理保持全局认知,子代理处理细节任务,**主代理上下文不因细节回流而爆掉**,且跨会话不失忆。
4
- > 宿主:灵枢 / DSH 生态 · 全局认知=任务状态与决策链 · 回流=结构化卡片+主代理裁决+证据链
5
- > 设计日期:2026-09-14 · 所有机制均经实测验证(见文末"实测清单")
6
-
7
- ---
8
-
9
- ## 一、先讲清这个问题的本质
10
-
11
- 你的需求翻译成一句话是:
12
-
13
- > **让"上下文"从"会话内存"变成"可寻址的外部状态"。**
14
-
15
- 现在大多数 Agent 的做法是:所有细节都堆在一条会话里,靠窗口容量硬扛早晚爆掉。你要的是——
16
-
17
- ```
18
- 错误做法: [主] ──── 细节1 ──── 细节2 ──── 细节3 ──→ 爆
19
- 正确做法: [主] ─┬─→ [子A] ──→ 卡片A ─┐
20
- ├─→ [子B] ──→ 卡片B ─┼─→ [主] 只读卡片+全局态
21
- └─→ [子C] ──→ 卡片C ─┘ 细节在库里,按需取
22
- ```
23
-
24
- **关键分界线**:细节**不回流到主代理的上下文**,只回流到**记忆库**;主代理读的是**索引卡**,不是**正文**。
25
-
26
- 我用灵枢实测确认了这条分界线是可行的:200 条子代理产出、预算 1200 tokens 时,主代理只读到 **25 条、实耗 1170 tokens**(97.5% 利用率),其余 25 条被明确放进 `skipped`。**这不是"尽量少读",是硬性截断。**
27
-
28
- ---
29
-
30
- ## 二、三层记忆结构(这是整个设计的地基)
31
-
32
- ```
33
- ┌────────────────────────────────────────────────────────┐
34
- │ L0 · 全局态(主代理独占,session=main) │
35
- │ 内容:任务目标 / 当前阶段 / 已完成 / 待决 / 决策与理由 │
36
- │ 特征:条数少(<30)、importance 高(≥0.9)、极高频读写 │
37
- │ 预算:每次召回 800-1200 tokens │
38
- └────────────────────────────────────────────────────────┘
39
- ▲ derived_from 溯源
40
- ┌────────────────────────────────────────────────────────┐
41
- │ L1 · 卡片层(子代理产出,session=subXXX) │
42
- │ 内容:固定 5 栏卡片(见第三节),不是原始输出 │
43
- │ 特征:条数多(每个子任务 1-3 条)、importance 0.6-0.7 │
44
- │ 预算:主代理默认不读;按 task 号定向取 │
45
- └────────────────────────────────────────────────────────┘
46
- ▲ derived_from 溯源
47
- ┌────────────────────────────────────────────────────────┐
48
- │ L2 · 细节层(子代理过程产物,session=subXXX, contextual) │
49
- │ 内容:改了什么文件、跑了什么命令、完整输出、中间推理 │
50
- │ 特征:量最大、生命周期最短、几乎不主动召回 │
51
- │ 预算:主代理只在"需要追问"时按 id 精确取单条 │
52
- └────────────────────────────────────────────────────────┘
53
- ```
54
-
55
- **实测支撑**:`session` 过滤是**硬隔离**。我建了 `main` 1 条 + `subA/B/C` 各 5 条,实测:
56
-
57
- | 过滤条件 | 返回 |
58
- |---|---|
59
- | `session=None` | 16 条(全部) |
60
- | `session="main"` | **1 条**(只有全局态)|
61
- | `session="subA"` | **5 条**(只有 subA)|
62
-
63
- 这意味主代理可以用 `session="main"` 保证自己**永远只看到全局态**,无论子代理往库里写了多少东西。
64
-
65
- ---
66
-
67
- ## 三、子代理卡片规范(回流的最小单元)
68
-
69
- 子代理**必须**产出这张卡。它是"细节"和"全局认知"之间唯一的接口。
70
-
71
- ```markdown
72
- # 功能名:<任务域,结构化短名,如"缓存后端选型">
73
- # 子功能:<子任务名,如"Redis 使用决策">
74
- # 生效条件:<空格分隔的关键词串!如"缓存选型 决策">
75
-
76
- 结论:<做了什么、结论是什么——注意:这行不带 #>
77
-
78
- 证据:<可验证锚点,如"f1.py:120-145"、"pytest 12 passed">
79
-
80
- 影响面:<改了什么/谁会被影响>
81
-
82
- 未决项:<需要主代理裁决的;没有就写"无">
83
- ```
84
-
85
- ### ⚠️ 三条硬性格式要求(都是实测踩出来的,违反则冲突检测失效)
86
-
87
- 我在实现参考代码时**连续踩了三个坑**,每一个都会导致"两条明显矛盾的信息被静默放过"。这三条不是风格偏好:
88
-
89
- | # | 规则 | 违反的后果(实测) |
90
- |---|---|---|
91
- | **1** | `# 功能名` / `# 子功能` / `# 生效条件` **必须带 `#`** | 缺则检测器返回 `ACCEPT(无冲突)`——因为它靠这三个字段判"是否同一件事" |
92
- | **2** | `# 生效条件` 必须是**空格分隔的关键词串**(`缓存选型 决策`),**不能是句子**(`缓存选型决策时`) | 句子把词面覆盖率稀释到阈值 `0.75` 以下 → **漏检**。我实测:`缓存选型 决策` 覆盖率 **1.0** 触发 `DEFER`;改成 `缓存选型决策时` 直接 `ACCEPT` |
93
- | **3** | `结论:/证据:/影响面:/未决项:` 四行**必须不带 `#`** | 系统的结论比对用的是「**去掉所有 `#` 声明行后的正文**」。若结论也带 `#`,正文被清空 → 检测器认为"两条卡片结论完全相同"(实测 `conclusion_overlap=1.0`,需 `<0.95` 才报分歧)→ **漏检** |
94
-
95
- **第 3 条最反直觉**:我最初把卡片设计成全部字段带 `#`(看起来更整齐),结果两条"选择 Redis" vs "放弃 Redis"的卡片被判为**无冲突**。原因是 `_body_text()` 把 `# 字段:值` 行全部剔除,正文变成空字符串,空 vs 空的覆盖率是 1.0。
96
-
97
- > **一句话记住**:**声明用 `#`,结论不带 `#`。**
98
-
99
- ### 为什么是这几栏——不是拍脑袋
100
-
101
- | 栏 | 作用 | 实测依据 |
102
- |---|---|---|
103
- | `# 功能名` / `# 子功能` | **判"是不是同一件事"** | 缺这两栏,`slot_overlap` 无法计算,同条件冲突**测不出来** |
104
- | `# 生效条件` | **判"在什么条件下"** | 缺这一栏,检测器返回 `BLINDSPOT`:"既有节点均未声明条件:无法建立比对路径" |
105
- | 结论正文 | 供冲突比对"取值是否不同" | 实测两卡片 `conclusion_overlap=0.0` 时正确触发分歧告警 |
106
- | 未决项 | 主代理的**待办输入** | 这是子代理向主代理"提问"的唯一正规通道 |
107
-
108
- ---
109
-
110
- ## 四、四阶段工作流
111
-
112
- ### 阶段 1:主代理开工前——锚定全局态
113
-
114
- ```
115
- 1. mdcg_recall(query="当前任务目标", session="main", budget_tokens=1200, goal=<当前目标>)
116
- → 拿到 L0 全部内容(实测:session 过滤保证只拿全局态)
117
-
118
- 2. 若返回空(新会话)→ 用 cg(op=write) 写 L0 首条:
119
- # 功能名:<项目名>任务状态
120
- # 生效条件:本任务进行期间
121
- 结论:目标=...;阶段=...;已完成=...;待决=...
122
- ```
123
-
124
- **这一步就解决了"跨会话丢状态"** ——因为 L0 是落盘的 md 文件,不是会话内存。
125
-
126
- ### 阶段 2:派发子任务——给子代理"最小充分上下文"
127
-
128
- 给子代理的 prompt 里**只放**:
129
- - 它要做什么(任务描述)
130
- - **它需要的部分全局态**(不是全部!从 L0 里挑相关的)
131
- - 卡片规范(第三节的模板,原样贴)
132
- - 它的 `session` 标识(如 `subA`)
133
- - 它**必须**调用的写入指令
134
-
135
- **关键:不要让子代理自己去 recall 全局态。** 由主代理裁剪后直接注入——因为主代理才知道"这个子任务需要知道什么"。这既省子代理的预算,也避免它被无关全局信息干扰。
136
-
137
- ### 阶段 3:子代理执行——产出卡片 + 细节分层落盘
138
-
139
- 子代理完成后,**两次写入**(这是分层的落点):
140
-
141
- ```
142
- 写入1(卡片,主代理会读):
143
- cg(op=write, content=<第三节模板>, layer="knowledge",
144
- session="subA", importance=0.7,
145
- verification_basis="other",
146
- derived_from=["<L0的节点id>"])
147
-
148
- 写入2(细节,主代理默认不读):
149
- cg(op=write, content=<完整过程/命令/输出>, layer="contextual",
150
- session="subA", importance=0.4,
151
- derived_from=["<卡片节点id>"])
152
- ```
153
-
154
- **实测要点(这三条都是真金白银踩出来的)**:
155
- - `session` 必须作为**顶层参数**传(走 `**extra` → `fm.update(extra)`)。我第一次用 `extra={"session":...}` 嵌套写法失败了,`session` 字段落成 `None`、过滤失效——**这是个真实踩坑点**。
156
- - `verification_basis` 只接受这几个值:`compiler / test / measurement / formal_proof / data / textbook / public_kb / other`。写 `user_request` 会**直接抛异常**。
157
- - `derived_from` 是**真实存在的溯源字段**,实测能反查(我靠它成功列出某任务的全部子代理产出)。这就是你要的证据链。
158
- - ⚠️ **节点 ID 必须带序号**:若只用毫秒时间戳,同一毫秒内的两个子代理会生成相同 ID,**后一个 `.md` 会覆盖前一个**(我实测撞过一次,两条卡片只剩一条)。
159
-
160
- ### 阶段 4:主代理收口——只读卡片 + 裁决冲突
161
-
162
- ```
163
- 1. 定向取卡片(不读细节):
164
- mdcg_recall(query="<子任务名>", session="subA", budget_tokens=600, k=5)
165
-
166
- 2. 若子代理写了冲突信息 → 它在队列里等你裁决:
167
- cg(op=review, pid=<pid>, decision=accept|reject|edit|merge, reason=<理由>)
168
-
169
- 3. 把结论合并进 L0:
170
- cg(op=write, content=<更新后的全局态>, session="main",
171
- derived_from=["<各子代理卡片id>"])
172
-
173
- 4. 【可选】细节确实需要追问时,按 id 精确取单条:
174
- mdcg_search(query="...", layer="contextual", session="subA", k=1)
175
- ```
176
-
177
- ---
178
-
179
- ## 五、冲突裁决:这套设计最值钱的部分
180
-
181
- 你选了"结构化卡片 + 主代理裁决 + 证据链"。我实测了这条路径**完全跑得通**,且比预想的好:
182
-
183
- ### 实测:冲突被准确识别并交给你裁决
184
-
185
- 我写两条同域信息(旧:"选择 Redis";新:"放弃 Redis,改本地内存"),补上正确结构字段后:
186
-
187
- ```
188
- verdict : DEFER
189
- reason : 同条件空间下结论槽取值不一致:需裁决是更正还是分支
190
- conflicts[0] : type=same_condition_divergence
191
- detail="适用条件与结论槽均重合但取值不同:
192
- 可能是更正(应覆盖旧值)或分歧(应补区分条件)"
193
- same_condition=1.0, slot_overlap=1.0, conclusion_overlap=0.4523
194
- ```
195
-
196
- **注意它给的不是"冲突了",而是"是更正还是分歧?"——这正是主代理该回答的问题。**
197
-
198
- ### 实测:裁决闭环 + 审计留痕
199
-
200
- ```
201
- 入队 : prop_482fa75a6100
202
- 裁决 : review_decide(pid, "accept", reason="主代理确认:这是对旧决策的更正")
203
- 结果 : {"ok": true, "node_id": "new",
204
- "record_node_id": "rev_482fa75a6100_r1",
205
- "record_hash": "1a77d65540e9526de12e0249ae5c2d9cd191f9fd"}
206
- ```
207
-
208
- **每次裁决都生成一条带哈希的审核记录**——这是可直接被审计的决策链,比任何"我判断过了"的口头声明都硬。
209
-
210
- ### 实测:这条路径的边界(必须知道)
211
-
212
- | 情形 | 判定 | 我要提醒你的 |
213
- |---|---|---|
214
- | 自相矛盾(生效条件与不适用条件冲突) | **REJECT** 硬拦 | 最可靠,直接拒绝 |
215
- | 同条件+同槽位+异取值 | **DEFER** 交裁决 | 需要卡片规范配合,**这是主战场** |
216
- | 条件互斥 | **DEFER** | 需补区分条件 |
217
- | 条件部分覆盖 | **DEFER** | — |
218
- | 节点都没声明条件 | **BLINDSPOT** | **不假装确定**——所以卡片规范是硬要求 |
219
- | 卡片全字段带 `#`(我的初版设计) | **ACCEPT(漏检!)** | ⚠️ 正文被清空,两条矛盾卡片被判"结论相同" |
220
- | 生效条件写成句子而非关键词串 | **ACCEPT(漏检!)** | ⚠️ 覆盖率被稀释到阈值 0.75 以下 |
221
-
222
- ### 实测对照:同一组矛盾,两种模板的判定差异
223
-
224
- ```
225
- ❌ 漏检 ACCEPT | 全字段带 # 、条件写成"缓存选型决策时"
226
- ✅ 检出 DEFER | 声明带 # 、结论不带 # 、条件为"缓存选型 决策"
227
- same_cond=1.0 slot=1.0 concl=0.0
228
- ```
229
-
230
- **诚实结论**:这套冲突检测**不是万能的**——它只在"结构化声明"的范围内有效。这也是为什么第三节的卡片规范是**强制**而非可选:**你不按格式写,系统就真的看不见冲突。**
231
-
232
- ---
233
-
234
- ## 六、防爆的三道闸门
235
-
236
- 你的核心诉求是"避免超过上下文"。我实测了三道闸门,全部有效:
237
-
238
- ### 闸门 1:`budget_tokens` 硬截断(主力)
239
-
240
- 实测 200 条子代理产出:
241
-
242
- | 预算 | 纳入 | 跳过 | 实耗 | 利用率 |
243
- |---:|---:|---:|---:|---:|
244
- | 300 | 6 | 44 | 270 | 90.0% |
245
- | 800 | 17 | 33 | 786 | 98.2% |
246
- | 1200 | 25 | 25 | 1170 | 97.5% |
247
- | 2000 | 42 | 8 | 1986 | 99.3% |
248
-
249
- **利用率 97-99%,说明预算是被用足的、不是浪费的**;溢出的条目进 `skipped` 而不是被硬塞。这是最可靠的防爆手段。
250
-
251
- ### 闸门 2:`session` 隔离(结构性)
252
-
253
- 主代理用 `session="main"` 时,**物理上拿不到**子代理的细节(实测只返回 1 条)。这条不依赖预算计算,是结构保证。
254
-
255
- ### 闸门 3:分层 `layer`(语义性)
256
-
257
- `layer="contextual"` 的细节层默认不参与主代理召回,只在显式指定时取。
258
-
259
- **三闸门的关系**:闸门 2 挡"不该看的",闸门 3 挡"不该默认看的",闸门 1 挡"看不过来的"。**三个互补,不冗余。**
260
-
261
- ---
262
-
263
- ## 七、跨会话不失忆(你的隐含需求)
264
-
265
- 你的表述是"避免超过上下文导致的 ai 失忆"——真正的失忆有两类,这套设计都覆盖:
266
-
267
- | 失忆类型 | 原因 | 本设计的解法 |
268
- |---|---|---|
269
- | **会话内失忆** | 上下文被细节挤爆 | 三闸门:细节不回流,主代理只读卡片 |
270
- | **跨会话失忆** | 会话结束,内存清空 | L0 落盘为 md 文件,新会话 `recall(session="main")` 直接恢复 |
271
-
272
- **实测**:L0 就是磁盘上的 `.md` 文件,用任何编辑器都能打开审阅。这是"真源是文档"的好处——**你可以人工检查和修改全局认知**,不依赖任何工具。
273
-
274
- ---
275
-
276
- ## 八、需要你自己决定的三个参数
277
-
278
- 我不替你定这三个,因为它们取决于你的任务特征:
279
-
280
- | 参数 | 建议起点 | 取决于 |
281
- |---|---|---|
282
- | L0 的 `budget_tokens` | 1200 | 全局态复杂度。任务链越长、决策越多,越高 |
283
- | 卡片层 `importance` | 0.7 | 0.7 会触发自动保护(实测:`≥0.7` 自动打 `protected` 标记,不可遗忘) |
284
- | 细节层保留策略 | 定期 `cg(op=scrub)` | 细节层会持续膨胀,需要主动清理 |
285
-
286
- **第三点特别提醒**:L2 细节层是**只增不减**的,长期运行必然膨胀。建议在每完成一个大任务后调 `cg(op=scrub)` 或 `cg(op=forget)` 清理已归档的细节。这是这套架构里**唯一需要主动运维**的地方。
287
-
288
- ---
289
-
290
- ## 九、一句话总结设计
291
-
292
- > **主代理管"状态",子代理管"细节";细节落库不落上下文,状态读卡片不读正文;
293
- > 冲突交给结构检测发现、交给主代理裁决、交给哈希留痕。**
294
-
295
- 三个关键动作,缺一不可:
296
- 1. **子代理按格式出卡**(否则冲突检测失效——实测漏检)
297
- 2. **`session` 硬隔离**(否则主代理迟早被细节淹没)
298
- 3. **`derived_from` 建溯源**(否则事后追不回"这结论从哪来")
299
-
300
- ---
301
-
302
- ## 附:实测清单(本文所有数字均为实机复现)
303
-
304
- | 验证项 | 方法 | 结果 |
305
- |---|---|---|
306
- | 预算硬截断 | 200 节点 + 6 档预算 | ✅ 利用率 90-99%,溢出进 `skipped` |
307
- | session 隔离 | main + 3×sub 交叉过滤 | ✅ `main`→1 条,`subA`→5 条,完全隔离 |
308
- | 溯源链 | `derived_from` 反查 | ✅ 可列出某任务全部子代理产出 |
309
- | 同条件异值检出(修正后模板) | CCG 槽位 + 生效条件 | ✅ `DEFER`,含 `slot_overlap=1.0` / `conclusion_overlap=0.0` |
310
- | **同条件异值漏检(初版模板)** | 同内容、全字段带 `#` + 条件写句子 | ⚠️ **`ACCEPT`(真实盲区)** |
311
- | 裁决闭环 | `propose` → `review_decide` | ✅ `ok=true` + `record_hash` 审计留痕 |
312
- | 自否定硬拦 | 生效条件与不适用条件冲突 | ✅ `REJECT` |
313
- | `verification_basis` 白名单 | 尝试 `user_request` | ⚠️ 抛异常,须用 `other` 等合法值 |
314
- | `session` 传入姿势 | `extra={"session":x}` vs 顶层 | ⚠️ **嵌套写法静默失败**,必须顶层 |
315
- | 节点 ID 唯一性 | 同毫秒两次写入 | ⚠️ **ID 相同会互相覆盖**,须带序号 |
316
- | 参考实现端到端 | `orchestrator_memory.py selftest()` | ✅ 四阶段全通,含待裁决检出与证据链反查 |
317
-
318
- ### 独立复现报告(2026-09-14 · dsh-memory 主会话 · 27/27 全绿)
319
-
320
- > 复现脚本:`docs/experiments/orch_mem_verify/verify_orch.py`(临时库零污染,可重跑)。不采信上文自述,逐项独立复现的结论:
321
-
322
- | 项 | 文档声称 | 独立实测 | 裁决 |
323
- |---|---|---|---|
324
- | session 硬隔离 | None=16 / main=1 / subA=5 | 完全一致 | ✅ 复现 |
325
- | 预算硬截断 | 利用率 90-99% | 四档均 98.0%,溢出全进 `skipped` | ✅ 复现 |
326
- | 修正模板检出 | `DEFER` | `DEFER`(same_cond=1.0 slot=1.0 concl=0.6975) | ✅ 复现 |
327
- | **初版全带`#`漏检** | **`ACCEPT`(漏检)** | **`DEFER`(检出)** | ⚠️ **不复现,见下** |
328
- | 条件句子化漏检 | `ACCEPT`(漏检) | `ACCEPT`(漏检) | ✅ 复现 |
329
- | 裁决闭环 | ok + record_hash | ok=True + hash | ✅ 复现 |
330
- | ID 撞车覆盖 | 后写覆盖前写 | 成立;且 0.7 只触发「不可遗忘」不触发「不可覆盖」→ 同 ID 静默覆盖 | ✅ 复现 |
331
- | 溯源 / 白名单 / 嵌套坑 / protected / 细节不泄漏 | — | 全部一致 | ✅ 复现 |
332
-
333
- **「第三坑」结论修正**:`consistency.py` 结论比对带空正文兜底(`concl = _cov(...) if tw_content else 0.0`)——任一侧正文为空时 `concl` 恒 `0.0 < 0.95`,**恒报分歧而非判重复**。当前版本对「全字段带 `#`」是 fail-closed(检出但结论取值信息丢失),不是静默漏检。三条硬要求的理由据此分层:第 1/2 条(声明带 `#`、条件关键词串)是**防漏检**硬要求(句子化漏检实测复现);第 3 条(结论不带 `#`)的真实代价是**比对退化 → 无效 DEFER 增多**,而非漏检。
334
-
335
- **其他修正**:参考实现 `selftest` 内注释「session=main 应为 3」实为 2(1 锚定 + 1 合并);`orchestrator_memory.py` 实际位于 `test/`;文首所述 png 未随文档交付。
336
-
337
- ### 多进程并行实验(2026-09-14 · Windows spawn + WSL2 fork 双端对照 · 双端 12/12 全绿)
338
-
339
- > 脚本:`docs/experiments/orch_mem_parallel/parallel_test.py`(gitignored 可重跑)。N 个**真进程**各自持有独立 `OrcMemory` 实例写同一 root:A 组 8 进程 × 3 卡(条件唯一)测完整性,B 组 4 进程同条件不同结论测并行冲突检测。
340
-
341
- | 项 | 实测(双端一致) |
342
- |---|---|
343
- | 完整性 | 24 卡 + 24 细节零丢失零损坏,ID 唯一无撞车,收口 24/24,终态 index=57 |
344
- | 三层隔离 | L2 细节零泄漏进 main 召回;三层统计精确一致 |
345
- | 并行冲突检出 | 子进程侧 0/4 DEFER(时序敏感)→ **收口检查点 4/4 全检出**(V12) |
346
- | 原子写 | 临时文件零残留;无挂死进程 |
347
- | 吞吐 | Linux fork 1 ms/卡 vs Windows spawn 7 ms/卡(约 7×) |
348
-
349
- **发现一(生命周期约定,参考实现已补 API)**:index 是进程内快照(`__init__` 加载一次)。子进程写完必须 `close()`(把未达 autoflush 阈值的脏索引 flush 进本进程独占分片,否则「在盘上但不可见」);主代理收口前必须 `refresh()`(重载快照+回放全部分片,否则 `collect_cards` 只见自己 init 时的旧世界——实测不 refresh 时 collect 0/24)。`orchestrator_memory.py` 已新增这两个方法;`md_cg` 的分片+OS 锁架构本身零改动、零丢失。
350
-
351
- **发现二(并行冲突检测盲区→已补全)**:每个子进程的 `check_consistency` 只见实例 init 时的 index,**看不到并行者 init 之后写入的卡**(B 组 0/4 DEFER;偶发检出是 spawn 慢启动恰逢回放到已落盘分片)——并行提交绕过跨进程冲突检测。**缓解已落地**:主代理收口检查点 `final_check()`(refresh 后逐卡重查,exclude 自身;只报告不落库,处置走裁决通路),V12 实证 B 组 4 卡全检出、A 组唯一条件卡零误报,双端一致。串行形态不受影响。
352
-
353
- ### 收口检查点与证据链(参考 J-Space Cognition Suite SV1)
354
-
355
- J-Space(github.com/Tiger3807861189/J-Space-Cognition-Suite)的核心是一条证据链:源文件—地图—断言—检查点—报告,地图挂 SHA-256 防陈旧;「相同重试无新证据不算恢复」;测试只证明覆盖的已实现行为,不宣称普适增益。其五环节在 `orchestrator_memory.py` 的映射(取其实质,不引入其控制面):
356
-
357
- | J-Space 环节 | OrcMemory 对应 |
358
- |---|---|
359
- | 源文件 | L2 细节在盘(drill_down 唯一读入口) |
360
- | 地图 | index(refresh 后的全库快照) |
361
- | 断言 | 卡片结论(L1,条件+结论+证据槽) |
362
- | 检查点 | `final_check()`:收口全库一致性复查,并行冲突在此无条件检出 |
363
- | 报告 | `closeout()`:stats+未决项+检出+指纹;fingerprint=卡 ID 清单 SHA-256 前缀,同批复验指纹必须一致,卡集变化即指纹变化——防报告陈旧 |
364
-
365
- 未决项(卡片「未决项:」槽)经 `closeout` 透出后可落 L5(`add_unresolved`),对应 J-Space 的 unknowns 带 settled_by——未解问题驱动下一轮探索。
366
-
367
- **独立复核并非缺口——本仓已有结构形态**(智能论 v3.4 §十三 五大单元,与 J-Space xhigh 的编排形态互补):
368
-
369
- | 独立复核环节 | J-Space xhigh(编排形态:不同 agent 实例隔离上下文) | 本仓(结构形态:权限权职分离,`identity.POSITIONS` 同源) |
370
- |---|---|---|
371
- | 防自验 | 独立子代理复核,root 独立核验 | 验证单元 `layers_allow=['rejected','contextual']`——写 knowledge 直接 `AccessDenied`,「自己写、自己验」在结构上不成立 |
372
- | 反思 | 子代理两轮实质 pass | 反思单元 `reflect`:信息差 D(t,C) 与 d²D/dt²(`_reflection.jsonl`) |
373
- | 终裁复核 | root verdict | 维生系统:`heal` 只写 self 层,调度 `reflect_fn`/`verify_fn` 双签固化(consolidate 两道复核);中断权阶梯「维生>验证>用户>实例」;权限面终裁归 designer(`review_decide` require_admin) |
374
- | 复核盲区 | root 核验兜底 | 收口检查点 `final_check()`——写侧逐进程快照检测必然有时序盲区,复核后置到全量可见处(本轮 V12 闭环) |
375
-
376
- 两种形态防的是同一件事(写入者自裁自决):编排形态靠上下文物理隔离,结构形态靠角色写权限互斥——`md_cg` 的权限模型在结构上使「验证单元不得改事实层」可机器强制(`test_p21_tokens` 有断言防漂移),不依赖编排纪律自觉。
377
-
378
- ### 交付物
379
-
380
- | 文件 | 内容 |
381
- |---|---|
382
- | `docs/mdcg/主代理子代理记忆架构设计.md` | 本文档:架构、规范、工作流、边界 |
383
- | `test/orchestrator_memory.py` | 可运行参考实现(含 `selftest()`,封装 L0/L1/L2 三层与裁决闭环,实测位置在 `test/`,非仓根;含多进程生命周期 `close()`/`refresh()`、收口检查点 `final_check()` 与证据链报告 `closeout()`) |
384
- | `docs/experiments/orch_mem_verify/verify_orch.py` | 独立复现实测脚本(27 断言,gitignored 可重跑产物) |
385
- | `docs/experiments/orch_mem_parallel/parallel_test.py` | 多进程并行实验脚本(12 断言双端对照,gitignored 可重跑产物) |