@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,384 +0,0 @@
1
- # 世界模型功能端 · 使用与运维指南(v1.0)
2
-
3
- > **这一页回答一件事:语义时空图「状态层」上线后,你怎么记账、怎么查、开关在哪、怎么复跑读数、边界到哪。**
4
- > 依据:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md`(六签收点)与 `docs/秤_记忆系统评测规范_v2.1.md` §5.1(账本完整性口径)。
5
- > 使用者定位(2026-10-06):「0.7.4 把世界模型,也就是语义时空图的地基打好。」本页对应 P3 批(写侧入口 + 账本完整性探针 + 使用文档)。
6
-
7
- ---
8
-
9
- ## 一、一句话
10
-
11
- **事件是源、槽位是投影、查询走 stg**:
12
-
13
- ```
14
- 记账(写口) 台账(源) 投影(物化视图,查询时现算) 查询面
15
- cg(op=state_event) → <root>/_state_events.jsonl → md_cg/state_slots.py → stg(op=state_chain)
16
- (MCP 面) append-only、不截断 (只读台账、不落盘、不缓存) (默认关)
17
- ↘ CLI:python -m md_cg.state_slots
18
- ```
19
-
20
- 四个面各有单点真源,互不复制:写口只做权限/归一/落盘(`md_cg/mcp_server.py`),
21
- 台账只管追加(`md_cg/state_events.py`),投影只管回放(`md_cg/state_slots.py`),
22
- 查询面只管开关与返回体成形(`md_cg/stg.py`)。
23
-
24
- ---
25
-
26
- ## 二、台账(源)在哪、长什么样
27
-
28
- | 项 | 内容 |
29
- |---|---|
30
- | 位置 | 库根下 `_state_events.jsonl`(与 `_recent.jsonl`、`_write_2pc.jsonl` 同级) |
31
- | 性质 | **append-only**:只追加、不读改写、不截断(窗口滚动面 `_recent.jsonl` 不可作一等记录,故单立此账) |
32
- | 一行一条 | `{t, subject, slot, old, new, kind, seq, evidence, actor}` |
33
- | `kind` 五类 | `migration` 迁移 / `retraction` 撤回 / `enablement` 启用 / `acquisition` 获得 / `replacement` 替换;**未分类(None)合法** |
34
- | 撤回语义 | `old` 有值、`new` 空 = 值作废、无新值;启用=old 空、new 有值;迁移/替换=皆有值 |
35
- | 坏行 | 容忍 ≠ 静默:跳过时计数 + 有界样本 + stderr 告警(`state_events.BAD_ROWS` 可读) |
36
- | 多进程 | 跨进程文件锁(`FileLock`),崩溃不留半截文件(flush+fsync) |
37
-
38
- **记账不判语义**:`kind` 只是检索面标签,不进判据;「不是事实」的言语(玩笑/元层/回忆转述)
39
- 之消歧标记(`not_fact`)**不在本批**(见 §八 边界)。
40
-
41
- ---
42
-
43
- ## 三、写:MCP 记账口 `cg(op=state_event)`
44
-
45
- ### 用法
46
-
47
- ```
48
- cg(op="state_event", subject="鲸娘", slot="住所",
49
- old="别墅", new="小屋", kind="migration", seq=1108, evidence="r1108")
50
- ```
51
-
52
- | 参数 | 必填 | 说明 |
53
- |---|---|---|
54
- | `subject` | 是 | 事件主体(谁的状态);去空白后为空即报错 |
55
- | `slot` | 是 | 事件槽位(哪项状态);同上 |
56
- | `old` / `new` | 至少一个 | 变更前/后值;**双空非法**(空事件无意义)。撤回=`new` 留空 |
57
- | `kind` | 否 | 五类之一;缺省/空串/纯空白 → 归一为「未分类」(None);其它值报错 |
58
- | `seq` | 否 | 轮或序号(回指语料位置用) |
59
- | `evidence` | 否 | 出处(短证/轮号/文件路径皆可,回查用) |
60
-
61
- 返回体:`{"ok": true, "event": {…落盘记录…}}`(`event` 即 append 落盘的那一行)。
62
-
63
- ### 失败口径(fail-closed,不吞)
64
-
65
- | 情形 | 结果 |
66
- |---|---|
67
- | 缺/空 `subject`、缺/空 `slot` | `ValueError`(点名缺哪项) |
68
- | `old` 与 `new` 双空 | `ValueError` |
69
- | `kind` 非法值 | `ValueError`(列出允许五类) |
70
-
71
- 以上都是**原样上抛**的 `ValueError`(不是包装过的错误),客户端按普通错误处置即可——
72
- **失败即不落盘**。
73
-
74
- ---
75
-
76
- ## 四、读:投影与查询
77
-
78
- ### 1. 查询面 `stg(op=state_chain)`(默认关,见 §五)
79
-
80
- ```
81
- stg(op="state_chain", subject="鲸娘", slot="住所", include_retired=true)
82
- ```
83
-
84
- 返回体沿 stg 既有口径:`count`(条件命中总数,截断前)/ `items`(前 limit 条)/
85
- `kept` / `truncated`。单元字段:
86
-
87
- | 字段 | 语义 |
88
- |---|---|
89
- | `value` | 现值(撤回后为 null,直到下一个带值事件复活) |
90
- | `state` | `active` / `retired`(**退役不删除**;缺省查询剔除 retired,`include_retired=true` 可见) |
91
- | `t_from` / `t_to`、`seq_from` / `seq_to` | 生效区间与序号:`*_from` =最后产生当前值的事件;`*_to` =覆盖它的下一条事件(未被覆盖=null=仍有效/未闭合) |
92
- | `tier` | 来源档位(台账行顶层 `tier` 透传;未带=`unspecified`,**不编造**) |
93
- | `history` | 该槽位全部事件原样七字段(`t/seq/old/new/kind/evidence/actor`);`history=false` 时不带该键 |
94
- | `alternatives` / `blindspots` | 结构在场、**恒空列表**(判定口径后置,见 §八) |
95
- | `event_count` | 该槽位事件条数 |
96
-
97
- **投影是物化视图不是第二真源**:查询时从台账现算,不落盘、不缓存——台账追加一条,
98
- 下一次查询结果即变。
99
-
100
- ### 2. CLI 人工入口(`md_cg.state_slots`,**恒可用**)
101
-
102
- ```
103
- python -X utf8 -m md_cg.state_slots --status
104
- python -X utf8 -m md_cg.state_slots --subject 鲸娘 [--slot 住所] [--include-retired] [--no-history]
105
- ```
106
-
107
- 数据根取 `MDCG_ROOT`(缺省走 `datapath.mdcg_root()`)。本 CLI 与 `MDCG_STG_STATE`
108
- 开关**无关**——那把开关管的是 MCP 读面;CLI 是只读人工排查入口(不改任何状态)。
109
-
110
- ---
111
-
112
- ## 五、开关
113
-
114
- | 开关 | 缺省 | 管什么 |
115
- |---|---|---|
116
- | `MDCG_STG_STATE` | **关** | MCP 查询面 `stg(op=state_chain)`;关臂返回 `{"error": "disabled", "hint": …}`(**不是异常**——「没开」与「没命中」必须可分辨);与 `MDCG_STG_INDEX`/`MDCG_STG_QUALIFY` 同纪律 |
117
- | (无开关) | — | `cg(op=state_event)` 记账口**恒可用**(受权限闸约束,见 §六);`md_cg.state_slots` CLI **恒可用** |
118
-
119
- ---
120
-
121
- ## 六、授权口径(与既有令牌面零新词)
122
-
123
- - **`state_event` 走 `write` 词映射**:`cg` 面 op 作用域闸按 `write` 判定——
124
- 凡 `ops_allow` 白名单含 `write` 的角色(或用 `"*"` 的设计者令牌)可记账;
125
- guest/只读令牌照拒。令牌面**不引入新 op 词**(角色白名单与派生收窄面零改动)。
126
- - **`actor` 恒取令牌**(请求参数不生效):落盘 `actor` 永远是令牌身份(无令牌形态为
127
- `"system"`)——客户端不得改写归属(沿本仓既有防伪造口径)。
128
- - **写闸双保险**:台账是直写盘面的 append-only 文件、**绕过库层节点写闸**,故记账口
129
- 另显式补齐 `require_write("internal")`——`can_write` × `theory_ok` × 密级三态各自生效
130
- (只读令牌、版本层校验未过、clearance 不足 internal 都会被拒且不落盘)。
131
-
132
- ---
133
-
134
- ## 七、读数与复跑:探针 + 守卫
135
-
136
- ### 1. 账本完整性探针(《秤》5.1 口径)
137
-
138
- ```
139
- python -X utf8 scripts/probe_c_ledger_integrity.py \
140
- --events %TEMP%/state_events.jsonl --expect-slots 住所,房贷,名字 \
141
- [--out %TEMP%/probe_c_out]
142
- ```
143
-
144
- | 读数 | 口径 |
145
- |---|---|
146
- | ① 事件覆盖缺口率 | `--expect-slots` 清单中「台账无任何记录」的槽位占比(分子/分母都打印) |
147
- | ② 无账可辨率 | 对「无记录槽位」+固定合成不存在槽位查询 `state_chain`:`count==0 且 items==[]`(**不编造、不反推**)的通过比例 |
148
- | ③ 变迁史可查率 | 有记录槽位中 `state_chain`(`include_retired=True`、`history=True`)返回的 history 条数合计 == 台账该槽位记录数 的比例 |
149
-
150
- 特性(硬性):只读输入;隔离 temp root(把 `--events` 拷为该 root 的
151
- `_state_events.jsonl`)——**零记忆库写入**;`--out` 必须落在仓外(fail-closed);
152
- **确定性**(同输入两次运行 stdout 与 `--out` 产物字节一致);
153
- stdout 末行 `PROBE_C_LEDGER_JSON {...}` 摘要(机器可读),`--out` 时另落
154
- `rates.json` + `probe_c_slots.jsonl`。
155
-
156
- ### 2. 写口守卫
157
-
158
- ```
159
- python -X utf8 -m md_cg.test_state_event_op # 全链/双闸/防伪造/归一/校验/回归
160
- python -X utf8 -m md_cg.test_state_event_op --mutate # 定点变异自证(每条机制必须能被断言钉红)
161
- ```
162
-
163
- ---
164
-
165
- ## 八、边界(如实)
166
-
167
- - `alternatives`(同期未决值)/ `blindspots`(声明缺口)判定口径**后置**:本批结构在场、
168
- 恒空列表,**不臆造填充**。
169
- - 「不是事实」的言语(玩笑/元层/回忆转述)之**消歧标记**(`not_fact` 等)不在本批
170
- (P1 事件行无该信号)。
171
- - 探针只测**账本面**可辨性;**生成器级「无账强答」未测**——那需要接生成器侧读数,后置。
172
- - 槽位按**标签面精确匹配**(slot 名相等),不做同义归并/模糊匹配。
173
- - `state_chain` 无 `time_axis` 语义:台账事件行只有落账时间戳 `t`,无第二轴(**不伪造**);
174
- 需要轴语义请走 `stg` 的 timeline/relation/anchors。
175
- - 单库=单台账:跨库/多租户合并不在此。
176
-
177
- ---
178
-
179
- ## 九、退役纪律:节点生命周期 `archived`(默认检索剔除)
180
-
181
- > 《秤》v2.1 §5.2「退役纪律」口径的落地页。**先分清两个「退役」**(同名不同物):
182
-
183
- | 说谁 | 字段 / 参数 | 谁管 |
184
- |---|---|---|
185
- | 台账**槽位单元**的生存态(§四) | 投影单元 `state` = `active`/`retired`,查询参数 `include_retired` | `md_cg/state_slots.py`(查询时现算) |
186
- | **节点**(md 记忆条目)的归档态(本节) | frontmatter / 索引 `lifecycle_state` = `archived` | `md_cg/lifecycle.py` 状态机 + 读面剔除 |
187
-
188
- ### 1. 语义(写定,逐档可对拍)
189
-
190
- | `lifecycle_state` | 默认读/注入面(检索面 · stg 面 · 会话续接包全段) | 说明 |
191
- |---|---|---|
192
- | `active`(**缺键或非法值同此**) | 参与 | fail-open:存量节点零迁移、不误剔 |
193
- | `converged` | 参与 | **降权轴**(同构聚合定型),不是退役 |
194
- | `demoted` | 参与 | **降权轴**(弱化),不是退役 |
195
- | `archived` | **默认剔除** | 退役不删除:节点文件仍在、可显式恢复 |
196
-
197
- ### 2. 判据与落点(判据单点,三个消费面)
198
-
199
- - 判据单点:`lifecycle.is_archived(e)`(`md_cg/lifecycle.py`)≡ `state_of(e) == "archived"`;
200
- 全部消费点共同引用,不各写一份口径。
201
- - 消费点 ①(**cg 检索面**):`MdCGOS._candidates`(`md_cg/mdcos.py`)——**检索类** cg 读 op
202
- (`route` / `read` 的检索分支与 `budget_tokens` 预算召回分支 / `search` / `search_rrf` 及其
203
- 内含的 lexical·bucket·entity·graph·chain·temporal 各路)都经这一个候选池;
204
- `MdCGSecure._candidates` 经 `super()` 在其上叠加读可见性,判据同源。
205
- 注意:cg 的读 op 并非全走候选池——见消费点 ③(会话续接面自持取数面)。
206
- - 消费点 ②(**stg 扫描面**):`stg._scan_one`(`md_cg/stg.py`,`_scan` 的逐条实现单点)
207
- ——`timeline` / `anchors` / `consistency` 三 op 的候选面同点覆盖,索引子集
208
- (`MDCG_STG_INDEX=1`)与全量遍历两条分支逐位一致。`relation` 是显式 id 直读、
209
- `state_chain` 走台账,两者都不经候选面(不受本节约束)。
210
- - 消费点 ③(**会话续接注入面**):`MdCGOS.session_recall`(`md_cg/mdcos.py`)的
211
- **四个取数段**——会话要点 `_session_notes`、活跃目标 `goals`、任务台账 `tasks`、
212
- 未解问题 `unresolved`(`goals`/`tasks` 经 `_retired_by_id` 按 id 回查索引后交同一
213
- 判据)。`cg(op=session, action=recall)` 自持取数面(不经 `_candidates`),它把节点
214
- 内容装配成「续接包」回给调用方/注入上下文(=注入面),故同接本判据。台账两段
215
- 取**全量窗**(`_LEDGER_WINDOW`)过滤后截断 `_PACK_ROWS=5` 条,故退役剔除不会让
216
- 包「不足额」;`tasks.active_total/done_total` 随之取**剔除后**的全窗计数(与列表
217
- 同源自洽)。`recent` 段是事件窗口(非节点)、`self_state` 是只读快照卡,不涉退役。
218
- (独立复核 2026-10-06 两轮实测:接线前 archived 要点摘要、未解问题正文、活跃目标
219
- 与任务卡均经该 op 照旧回出;现由守卫 R1.12/R1.13/R3.5/R3.6/R4.6 钉住。)
220
-
221
- ### 3. 不受限面(「退役不删除」的另一半)
222
-
223
- - `cg.get(node_id)` 直读、`cg(op=audit)` 证据审计视图:archived 期间**照常可达**;
224
- - 工程台账面(`goal` / `task`)与统计面(`health` / `whoami` / conformance):直读索引,
225
- 不受本节约束;
226
- - **生命周期恢复**:库层入口 `MdCG.set_state(node, "archived"→"active")`
227
- (`md_cg/mdcg.py:2619` → `lifecycle.set_state`,走合法迁移表、逐级不跳级);恢复后
228
- 读面/续接面重新可见。**MCP 工具面没有独立生命周期入口**(`mcp_server.py` 全文无
229
- `set_state` / `lifecycle` 字样)——「显式恢复」是库层调用面。
230
- - 与 `op=restore` 的区别(易混,写明):`op=restore` 是 `op=forget` 的 `action=restore`
231
- → `cg.restore`(`md_cg/mdcos.py:3029`)=把**已遗忘**(软删除进 `trash/`)的节点放回,
232
- 是**删除轴**,与生命周期状态机无关;且放回时 `lifecycle_state` 按新节点(`active`)
233
- 起判,`active→archived` 跳级被拒 ⇒ **不透传(落 `active`)**(既有行为,本轮未改)。
234
-
235
- ### 4. 复跑读数
236
-
237
- ```
238
- python -X utf8 scripts/probe_d_retirement_discipline.py # 《秤》v2.1 §5.2 探针
239
- python -X utf8 -m md_cg.test_lifecycle_retire_leak # 守卫 R1–R4
240
- ```
241
-
242
- | 读数(`PROBE_D_JSON`) | 口径 | 目标(面计数,括号内为比率) |
243
- |---|---|---|
244
- | ① 退役泄漏率 | 退役后 v2 仍出现在查证面(读面 search∪recall、时空面 timeline∪anchors)的面数 / 面数 | `0/2`(0.0) |
245
- | ② 更新采纳率 | v2 写入后可见的面数 / 面数(防「一刀切全滤」的反向缺陷) | `2/2`(1.0) |
246
- | ③ 旧事实残留率 | 退役步之后 v1 仍可见的面数 / 面数(不连带误剔) | `2/2`(1.0) |
247
- | ④ 失效误判证伪率 | 退役节点被错误置 falsified/rejected 的条数 / 退役节点数(退役 ≠ 证伪) | `0/1`(0.0) |
248
-
249
- (探针人读行打印的就是**面计数**「n/分母(目标 m)」;上表与它同单位,比率为换算值。)
250
-
251
- 探针特性:隔离 temp root(零在役库写入)、纯 stdlib、无随机/无时间戳、
252
- `--out` 必须落在仓外(fail-closed)、末行 `PROBE_D_JSON {...}`,**两遍运行 stdout 字节一致**。
253
-
254
- ### 5. 边界(如实)
255
-
256
- - 只剔 `archived`。要让 `converged`/`demoted` 不参与,请走既有其他维度
257
- (`role` / `view` / `layer` / `session` / `validity`)——不得把它们并进退役判据。
258
- - 台账单元退役(§四 `retired`)与节点退役(本节 `archived`)**各自独立、互不联动**。
259
- - **面的判据(写死,供后续接线照此归类)**:**默认读/注入面**=调用方给查询/意图/会话视图,
260
- **节点集合由库自选**且结果直接回给调用方或注入上下文 ⇒ 必须消费 `is_archived`;
261
- **定向/管理/统计面**=调用方给出**显式节点选择键**(`node_id` / `subject:*` 标签 / 前缀 /
262
- 层 / 状态)或面本身是诊断·统计·写面 ⇒ 直读,不受本节约束。
263
- - 已接线消费面(3 处,4 子面):检索面 `_candidates`、stg 面 `_scan_one`、会话续接注入面
264
- `session_recall` 的**全部四个取数段**(要点 `_session_notes` + 活跃目标 + 任务台账 +
265
- 未解问题;后两段经 `_retired_by_id` 按 id 判据)(§2)。
266
- - **已枚举但归入「定向/管理/统计面」(不受限,逐条申报)**:`cg.get` 直读、`op=audit`
267
- 证据审计、**工程台账的显式管理查询面**(`cg(op=goal, action=list)` / `cg(op=task,
268
- action=list)`——直读台账,archived 期间照样列出,守卫 R1.13c 钉住这一侧)、
269
- `health`/`whoami`/`_role_counts`/`_sensitivity_counts`/`conformance`/`census`/`insight`
270
- 统计、`review_records` 审核记录、`export`/`evidence` 导出与证据面、`crosscheck`/
271
- `ghostref`/`consistency` 诊断面、`backfill*`/`writelimit`/`freshness`/`forgetting`
272
- 维护写面、`mreview/govern` 治理面、白箱 KB 工具面。
273
- **注意别与消费点 ③ 混读**:同一份 goal/task 台账,**注入面(续接包)剔除 archived、
274
- 管理查询面直读**——这不是矛盾,是判据两侧的分工(守卫同时钉住两侧:R1.13b 剔除、
275
- R1.13c 直读)。
276
- 其中**会回内容且集合由库自选**的一个代表面如实点名:`identity.profile`
277
- (`md_cg/identity.py:310`,按 `subject:<id>` 标签自选并回锚点正文摘录)——实测 archived
278
- 锚点仍回出(取证:`identity.profile` 返回的 `anchors[0].content` 含归档节点正文标记);
279
- 按上条判据它属**定向面**(`subject_id` 是显式选择键,与 `cg.get` 同族),故**本轮未接线**
280
- (其文件不在本轮允许改动面内)。
281
- - **面的接线状态(2026-10-06 使用者裁定批落地——原「已知未覆盖面」四项处置)**:
282
- - **基类 `MdCG.search` → 已接线**(`md_cg/mdcg.py` 候选条件加 `lifecycle.is_archived`
283
- 判据):plain `MdCG` 实例(白箱 KB / 离线脚本 / 测试)的默认检索面与生产路径
284
- 同口径(守卫 R5,含「converged 降权轴不误剔」对照)。
285
- - **因果链/图面 `chain.adjacency` → 已接线**(新增 `skip_archived=True` 缺省参数):
286
- 退役节点出边整体不入表、指向退役目标的边截断——`cg(op=causal, action=chain)`、
287
- `predict.*` 等读/预测面不再扩散进 archived(守卫 R6.0/R6.1/R6.4,含缓存已热
288
- 时归档的实测腿)。**维护面显式旁路**:`scrub` 去污染抽查传
289
- `skip_archived=False` 取全量表(守卫 R6.2/R6.3 钉住旁路——面的判据分工:
290
- 默认读/注入面必消费、维护/管理面直读)。
291
- - **缓存失效钩子(本批实证的兑现缺口)**:状态迁移改变 `is_archived` 读数,
292
- 而 `chain` 邻接缓存在 `set_state` 后此前**未失效**(探针实证:归档后
293
- `causal_chain` 仍含目标)——现 `lifecycle.set_state` 写盘点同点调用
294
- `chain.invalidate_cache`(懒导入,`invalidate_cache` 自吞异常不阻断推进)。
295
- - **结构/拓扑面 `subgraph.children_index` / `parents_index` → 裁定不接**
296
- (调用方给显式父/子 id、返回 id 映射不回正文,属定向/结构面,直读)——
297
- 守卫 R7.0/R7.1 把裁定**钉住**:子节点退役后映射仍在;未来若有人"顺手接线",
298
- R7.1 转红即提醒先改裁定。
299
- - **rust 检索内核 → 已接线**(`rust/src/store.rs`):`Entry` 增
300
- `lifecycle_state` 字段(键名与 Python `lifecycle.STATE_FIELD` 同源)、
301
- `candidates()` 剔除 `archived`(缺键/非法=active,fail-open;converged/
302
- demoted 仍参与)——crate 单测 `archived_entries_excluded_from_candidates`
303
- 与 `lifecycle_state_parsed_from_index_json` 双钉;两侧口径一致由
304
- `rank_parity` 门禁腿继续看守(评测语料无 archived,逐位零位移)。
305
- - 跨进程一致性:判据只读**本进程索引条目**(`lifecycle_state` 由
306
- `lifecycle._sync_index` 随迁移同步并落 `_index_log`),他进程刚归档、本进程索引
307
- 尚未重载的窗口内读数可能滞后(与 `lifecycle.set_state` 的既有落盘口径同源)。
308
-
309
- ---
310
-
311
- ## 十、多主体状态追踪(核心能力与常驻读取视图)
312
-
313
- > 使用者 2026-10-06 定位:「这个功能可以常驻,维护其他角色的状态追踪,这应该要
314
- > 作为语义时空图的核心功能。」
315
-
316
- **能力陈述**:状态追踪(多主体 · 五元事件 · 槽位投影)是语义时空图的**核心功能**——
317
- `subject` 参数化到任意主体(角色/机构/我),台账(`_state_events.jsonl`)为唯一真源,
318
- 其余全为投影/视图。
319
-
320
- **常驻形态**=**查询时现算的只读视图**(与 `state_slots` 同哲学,不存第二真源):
321
- 任何时刻调用即得最新;不依赖后台任务。工具面(均在 `scripts/`):
322
-
323
- | 件 | 用途 |
324
- |---|---|
325
- | `state_atlas.py` | **通用多主体追踪图**(常驻件):一份 md=全角色世界书(现值/退役/变迁史/大事记/分幕)+可选 `--worldbook-json`(酒馆风格 key/content) |
326
- | `whale_state_tracker.py` | 语料线抽取器(把会话语料转五元事件;鲸娘规则集,机件可仿建他角色规则包) |
327
- | `whale_state_atlas.py` | 语料线专用追踪图(从抽取产物 md 生成) |
328
- | `state_slots.py`(CLI) | 槽位投影只读入口(恒可用,`--status` 等) |
329
- | `stg(op=state_chain)` | MCP 查询面(flag `MDCG_STG_STATE` 默认关——纪律不变,与 CLI 恒可用互补) |
330
-
331
- **库根解析(与 zcode MCP 同源,防双库分叉)**:`--root` > env `MDCG_ROOT` >
332
- `~/.zcode/cli/config.json` 的 `mcp.servers.mdcg.env.MDCG_ROOT` > `mdcg_root()` 缺省。
333
- **只读纪律**:工具面只读,`--out` 一律仓外(fail-closed)。
334
-
335
- **记账纪律(通用指引,从鲸娘线三层消歧口径提炼)**:①状态变更发生时记账(谁的
336
- 什么槽位、old/new、五类 kind);②**用户侧声明优先**(用户明确说出的状态为准,
337
- 角色自述的「记错」不复盖真值);③非事实三类(玩笑/元层/回忆转述)如实标注、
338
- 不覆盖真值;④撤回=old 有值 new 空(显式作废,不做静默改写)。
339
-
340
- **在役现状(2026-10-06 实测)**:权威库(AEIS 数据区库根——根解析同源口径见上)
341
- 台账**0 条事件**——机制全链就位、数据处女地;多主体渲染由隔离库演示验证
342
- (2 主体/30 事件/15 槽位/15 条 worldbook 条目,读数见 `docs/eval/` 报告 v1.2 节)。
343
-
344
- **待裁(常驻自动化的可选增强)**:是否在睡眠周期「整理」档挂一步
345
- 「按主体预生成追踪图 md → 状态面」——现状为**按需现算**(打开即最新),预生成仅为
346
- 「打开就有文件」的缓存物;改常驻循环属生产行为变更,须单独立项。
347
-
348
- ### 会话链路接入(轮写入链第二步;使用者 2026-10-06 裁定)
349
-
350
- > 「把这个功能作为会话的 10 轮信息写入,并在写入 mdcg 的时候做处理……每次写入
351
- > 异步加了一些过程,但是好处是得到了可维护的状态,同时具备了认知图和语义时空图,
352
- > 原始信息的关系追溯。」
353
-
354
- - **接线单点**:`scripts/sync_zcode_session.py::sync_to_window`(zcode 端每轮——
355
- Stop 钩子/冷启动/压缩恢复共用同一链路)——写 `_recent` 窗口的**同一循环内**对同一轮
356
- 调 `scripts/state_extract.py` 保守抽取 → `state_events.append` 进台账。钩子在轮末以
357
- 子进程运行(会话外处理,即「异步」),**逐轮 fail-soft**(抽取失败绝不影响窗口写入
358
- 与轮次推进)。
359
- - **保守口径(写入在役库的纪律:宁可漏不可误)**:只抽**用户轮**(真人=事实源);
360
- 仅两条高精度规则(`地点·所在` 迁移 / `情感·偏好`,负向显式记「不喜欢:」);值剥
361
- 句尾语气词;**同值去重**(防每轮重复记账);证据 `[auto] session=… turn=…`、
362
- `actor=state_extract`——可整体甄别/清理;开关 `MDCG_STATE_EXTRACT` **缺省开**
363
- (=0 关)。探针已证:裸词形(承诺 138 / 因果 59/225 命中)不进规则表。
364
- - **三层同源+关系追溯**:认知图(`_recent`/知识面)+语义时空图(台账/`state_slots`
365
- 投影/`state_atlas` 视图)+原文(会话 md 镜像/全量转写)——事件 `evidence` 带
366
- session/轮号/短证,任一层可回查另两层。
367
- - **读数**:守卫 `scripts/test_state_extract.py` **10/10**(噪声三族零命中、去重、
368
- 变值成链、证据格式、开关、接线单点)+全量 **359/359**。
369
- - **DSH 端**:同款接线位于插件侧(TS)——属后续件(须改插件并随包发布);本批仅
370
- zcode 端在线,DSH 端行为不变。
371
- - **已知边界(留裁决)**:「住在这里」类泛化词形会命中(值取「里」等)——v1 词形
372
- 如此,收窄与否归使用者。
373
-
374
- ---
375
-
376
- ## 修订记录
377
-
378
- | 日期 | 要点 |
379
- |---|---|
380
- | 2026-10-06 | v1.0 首版(P3 批):全链(台账→投影→查询→记账口→CLI→探针)/ 开关 `MDCG_STG_STATE` 默认关与 CLI 恒可用 / 授权口径(`state_event`→`write` 词映射,actor 恒取令牌)/ 探针三读数复跑命令 / 边界如实(§一–§八) |
381
- | 2026-10-06 | 补 §九「退役纪律」:节点 `lifecycle_state=archived` 的默认检索剔除(判据单点 `lifecycle.is_archived`,消费面 `MdCGOS._candidates` + `stg._scan_one` + 会话续接注入面 `session_recall` 四段〔要点/活跃目标/任务台账/未解问题〕)/ 两套「退役」词义分界 / 不受限面(直读·审计·**台账管理查询面**·统计)与「生命周期恢复 ≠ `op=restore`(删除轴)」/ 《秤》5.2 探针四读数(面计数口径)与守卫复跑 / 边界如实(未覆盖面:基类 `MdCG.search`、因果链面 `chain.adjacency`、结构面 `subgraph`、rust 内核、定向面 `identity.profile`) |
382
- | 2026-10-06 | **边界四项裁定批落地(使用者裁定:1/2/4 接、3 不接)**:基类 `MdCG.search` 接线(R5)/ `chain.adjacency` 接线(`skip_archived` 参数,R6;scrub 维护面显式旁路)/ rust 内核接线(crate 单测双钉)/ `subgraph` 结构面**裁定不接**(R7 钉住裁定);并补 `lifecycle.set_state` 的 `chain.invalidate_cache` 同点失效(本批探针实证的缓存缺口);守卫 36→45 断言 |
383
- | 2026-10-06 | **补 §十「多主体状态追踪」(核心能力定位,使用者 2026-10-06)**:常驻形态=查询时现算只读视图(不存第二真源);工具面四件(`state_atlas` 通用多主体 / 语料线两件 / CLI);库根解析与 MCP 同源(防双库分叉);记账纪律四条(从鲸娘线三层消歧口径提炼);在役台账 0 条实测+隔离多主体演示读数;睡眠档预生成列为待裁 |
384
- | 2026-10-06 | **补 §十「会话链路接入」(轮写入链第二步,使用者 2026-10-06 裁定)**:`sync_to_window` 同循环内对同一轮保守抽取(`state_extract`:仅用户轮/两条高精度规则/去重/证据可甄别;开关缺省开)→ 台账;三层同源+关系追溯;守卫 `test_state_extract` 10/10、全量 359/359;DSH 端同款接线列后续件 |
@@ -1,82 +0,0 @@
1
- ---
2
- name: 代码评审与条件化注释_契约_v0.1
3
- overview: Phase 0 契约裁决:功能生效条件与索引元条件字段分家;render 三分区与人工优先;补写规范、门禁口径与已知代价面。作为四环全部改动的唯一权威。
4
- 状态: 生效(Phase 0 产出 · 2026-09-17)
5
- 关联计划: docs/mdcg/全库代码评审与条件化注释_计划_v0.1.md
6
- ---
7
-
8
- # 代码评审与条件化注释 · 契约 v0.1
9
-
10
- > 本文件是 Phase 0 的裁决产出(计划 `contract-adr`),作为「全库代码评审 → 补条件化注释 → 进认知图索引 → 自动维护」四环全部改动的**唯一权威**。
11
- > 与代码真源冲突时以真源为准,并回改本文件(防术语双写法漂移)。
12
-
13
- ## 一、判定单(designer-perspective · 强制调用)
14
-
15
- ```
16
- [判定单]
17
- 条件空间:观测位置=全局(设计者位置,跨文件/跨检索面) | 观测工具=源码级逐行取证 + 机械断言 | 时间窗口=Phase 0(2026-09-17,重索引前) | 存在约束=公开仓(注释随仓公开,第14条双清单);不改 judge_qualification 判定序、不改 region_hash
18
- 白箱三问:依据=计划 §2.1/§2.2 逐行取证 + md_cg/test_p26_refindex.py L212-231 与 L249-258 既有断言(现场实读) | 条件=md_cg 认知图对代码条目做资格判定、且检索侧取首个匹配 | 错后=回滚=还原 codeindex.render 并重索引(既有已落盘正文不追溯)
19
- 裁决:ACCEPT(render 三分区 + 合成区去生效条件);对「同批全量重索引」→ DEFER
20
- 依据:行序压制为机械可判事实(合成行在源码注释之前且字段同名,mdcos._ccg_field 取首匹配);索引元条件与功能前置条件语义互斥(backfill.py 既有先例:清洗真实库 109 条弱等价行)
21
- 缺失维度:条件边界——真实库既有 2930 条代码节点的资格降级代价未被原计划评估(见 §四)
22
- 验证路径:md_cg/test_codeindex.py(行序/零重名/诚实缺证据/幂等/截断)+ test_p26_refindex 重对齐 + md_cg 全组回归与改动前基线对照 + 蜂巢确定性执行留痕
23
- 关注信号:本契约不触发追溯重写;Phase 2 铺量前必须获 q-0/q-1/q-2 裁决
24
- ```
25
-
26
- ## 二、字段分工(术语真源)
27
-
28
- | 字段 | 承载语义 | 来源 | 可否合成 |
29
- |---|---|---|---|
30
- | `生效条件` | **功能前置条件** precondition:这段代码在何种输入/状态下正确 | 人工/源码声明(源码 CCG 注释) | **否**(合成即冒充) |
31
- | `索引元条件` | 条目在何处/何时/以何工具可被观测到 | 机械推导(`codeindex.condition_space` 四槽) | 是(唯一来源) |
32
- | `位置` | 索引坐标(path:lineno-end、lang、precise) | 机械推导 | 是 |
33
- | frontmatter `condition_space` | 四槽结构化值(与正文 `索引元条件` 同一纯函数) | 机械推导 | 是 |
34
-
35
- 真源常量:`nodefile.INDEX_META_MARK`(= `索引元条件`)与 `nodefile.is_ccg_mark`(零重名机械判据)。
36
-
37
- 四条硬约束:
38
-
39
- 1. 合成区字段名与 `nodefile.CCG_MARKS` 的交集 = 空集;
40
- 2. `生效条件` 行只可能来自源码声明,`render` 永不合成该字段;
41
- 3. 同名字段冲突时**人工优先**(源码区置首 → `_ccg_field` 取首个匹配 → 确定性可复算);
42
- 4. 不动 `region_hash`、不动 `judge_qualification` 判定序、`skip_matcher` 无参行为逐字不变。
43
-
44
- ## 三、补写规范(环二输入口径)
45
-
46
- 1. 只写**功能生效条件**,不写索引元条件:写「入参 path 为已存在的本地文件」,不写「源文件存在于本地仓」。
47
- 2. 落点在**两个窗口**之一,按源文件**物理行序**合并(靠前者胜出 = 检索侧取首匹配的确定性序):
48
- - **leading**:定义行**紧邻上方**的连续 `#` 注释(`codeindex._leading_comments` 口径,遇空行即断);
49
- - **body**:定义行**紧邻下方**、函数体首个语句之前的 `#` 注释(`codeindex._body_comments` 口径,**唯一真源**)。
50
- 既有白箱单元库 **104+ 处**用的是 body 窗口(例:`whitebox_kb/wisdom/python_code_units.py` 模板 `def tokenize(src):` 下一行即 `# 生效条件:…`);`verifier._ccg_block` 已收敛为委托 `codeindex._body_comments`(2026-09-17 裁决 A,消除历史悬空引用)。
51
- 3. 六要素齐全才过门槛;`生效条件` 缺一即 BLINDSPOT(缺证据 → 补写,不许省略或用「常用条件默认省略」掩盖)。
52
- 4. 公开仓约束:补写内容随仓公开,须过第 14 条「内容政策 + 隐私脱敏」双清单;含敏感/隐私者只入私有库(AEIS)。
53
-
54
- ## 四、已知代价面(必须显式知情)
55
-
56
- - **改造前实测**:本机认知图真源(仓外私有库 `<brain-root>`)有 **2930** 条 `code_` 节点,其正文含合成 `生效条件`(实为索引元条件),故资格判定为 **DEFER**。
57
- 原计划 §九-2 称「代码节点当前恒定被判 BLINDSPOT」,与实测不符——**该前提已修正**(本契约相对计划的重要事实更正)。
58
- - **改造后**:`render` 不再合成 `生效条件` → 源码未补注释的条目 = 缺证据 = **BLINDSPOT**。
59
- - **影响面**:不追溯。既有 2930 条节点的正文已落盘,只有**重索引**(`index_code`,尤其非增量)或源文件变更触发重写时才翻转。
60
- - **为何仍应接受**:改造前的 DEFER 建立在一个**语义错误的生效条件**上(计划 §2.2 的病根:「补了注释」与「没补」不可区分)。未补 = BLINDSPOT 是诚实信号,由环二补注释闸门(`GATE_MIN_PASS_RATE=0.90`)逐步补回。
61
- - **回滚路径**:还原 `codeindex.render` 后重索引即可回到 DEFER;已落盘的旧正文不自动回退(写路径可退,历史不可逆)。
62
-
63
- ## 五、门禁口径(Phase 0 验收)
64
-
65
- | 项 | 判据 | 断言位置 |
66
- |---|---|---|
67
- | 行序压制已修 | 源码 `生效条件` 置首、逐字保留,`_ccg_field` 取到人工值 | test_codeindex ② / test_p26 §4 |
68
- | 补注释 = 有效 | 源码声明后 `ccg_completeness.complete == True` | test_codeindex ② |
69
- | 未补 = 诚实缺证据 | `complete == False` 且**恰缺** `生效条件` | test_codeindex ② / test_p26 §5 |
70
- | 字段零重名 | 合成区用到的 CCG 字段名 = 其余五要素 | test_codeindex ③ |
71
- | 载体两窗口 | body 窗口注释被抽取、两窗口按物理序合并、`verifier` 与唯一真源逐字等价 | test_codeindex ⑦ |
72
- | 幂等/确定性 | `render` 两次逐字节相同;`index_dir` 两次条目序一致 | test_codeindex ⑤⑥ |
73
- | 既有契约不回归 | `condition_space` 四槽/全时窗、`extract` 分派、`region_hash` 12 位 | test_codeindex ④⑤ |
74
- | 回归 | md_cg 全组回归与**改动前基线**对照(既有失败不改判) | 蜂巢确定性执行留痕(spec/result) |
75
-
76
- ## 六、不适用条件
77
-
78
- - 不适用于知识/文档节点(本契约只管代码条目的注释与资格判定)。
79
- - 不改 `judge_qualification` 判定序与 `region_hash`;扩面(`.ts`/`.ps1`/`.yml`)属既有计划缺口 E,只声明不扩面。
80
- - q-0(注释落点)/ q-1(首期范围)/ q-2(评审方式)未获使用者裁决前,不得进入 Phase 2 铺量。
81
- - 本契约不授权追溯重写既有节点正文,也不代替第 5 条验证纪律与第 17 条蜂巢派发。
82
- - JS/TS 弱提取当前**只收 leading 窗口**(body 窗口未纳入)——属诚实边界而非缺陷,扩面须另行取证。