@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,221 +1,312 @@
1
- # -*- coding: utf-8 -*-
2
- """状态槽位寄存器投影(L2「主体×谓词槽位」)——**事件是源、槽位是投影**。
3
-
4
- 设计稿:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md` §2/§3(P2 批)。
5
-
6
- 本模块是**投影,不是第二真源**:
7
- · 源=`md_cg/state_events.py` 的 append-only 台账 `<root>/_state_events.jsonl`;
8
- · 查询时**现算**——不落盘、不建缓存、不写任何盘面文件;
9
- · 台账追加一条,投影立刻随之变化(无缓存、无物化表 ⇒ 无第二真源、无漂移面);
10
- · 本模块**只读**台账(经 `state_events.read`;`append` 归 `state_events`)。
11
-
12
- 投影单元字段(设计稿 §3 表逐字):
13
- subject / slot / value / state(active|retired) / t_from / t_to /
14
- seq_from / seq_to / tier / alternatives / blindspots / history / event_count
15
-
16
- 回放规则(分组键 `(subject, slot)`,组内按 `state_events.read()` 的**落盘序**):
17
- · `value` 自 None 起:事件 `new` 非空 → `value=new`;`new` 空(撤回)→ `value=None`
18
- 且 `state=retired`;其后带值事件自然复活(事件序自然处理,无特判分支)。
19
- · `state`:**最后一个事件的形态**决定——`new` 空 → `'retired'`;否则 `'active'`。
20
- · 区间(取值一律用事件行的 `t` 落账时间戳,不另算时间):
21
- `t_from`/`seq_from` =**最后产生当前值**的那条事件的 `t`/`seq`(retired 态=
22
- 最后一个**有值**事件的);`t_to`/`seq_to` =**覆盖它的下一条事件**的 `t`/`seq`
23
- (不存在=None,即「未闭合/仍有效」);retired 态的覆盖者=撤回事件(闭合点
24
- =值作废时刻)。
25
- · `tier` =最后有值事件的顶层 `tier` 透传(`append(extra=…)` 会把 extra 并入行
26
- 顶层,故「extra.tier」与「行顶层 tier」是同一处);缺失(键不在或为 None)→
27
- `TIER_UNSPECIFIED`——**不编造**。
28
- · `alternatives` / `blindspots`:本批**结构在场、恒为空列表**——「同期未决值」与
29
- 「声明缺口」的判定口径**后置**(P1 事件行尚无该信号),**不得臆造填充**。
30
- · `history` =该槽位全部事件原样(每条=事件行的 `t/seq/old/new/kind/evidence/
31
- actor` 七字段,值不改写;缺键取 None);`history=False` 时**不带该键**。
32
-
33
- 撤回判据取 **payload**(`new` 为空)而不是 `kind` 标签:台账口径是「撤回=old 有值而
34
- new 为空」(`state_events` 模块头),且该模块明言「分类本身不进判据(记账不判语义)」
35
- ——两者一致时等价;冲突时以 payload 为准(不按标签改写数据)。判据单点=`_is_void`。
36
-
37
- 过滤与排序:`subject`/`slot` 为 None 不加过滤(该过滤**委托** `state_events.read`,
38
- 此处不写第二套条件解析);`include_retired=False` 剔除 `state=='retired'` 的单元;
39
- 结果按 `(subject, slot)` 字典序稳定排序。
40
-
41
- CLI(纯只读人工入口,**恒可用、无开关**):
42
- python -X utf8 -m md_cg.state_slots --status
43
- python -X utf8 -m md_cg.state_slots --subject 鲸娘 [--slot 住所]
44
- 数据根取 `MDCG_ROOT`(缺省走 `datapath.mdcg_root()`,与 `md_cg/sleep.py` 的
45
- `_main` 同形)。本面与 stg 的 `MDCG_STG_STATE` 开关**无关**:开关管的是 MCP 读面,
46
- CLI 是人工排查入口(只读、不改任何状态)。
47
-
48
- 不适用条件:本模块**不判语义**——「不是事实」的言语(玩笑/元层/回忆转述)之消歧
49
- 标记(`not_fact` 等)不在本批(P1 事件行无该信号);`alternatives`/`blindspots` 的
50
- 真值判定亦未落地(见上,恒空列表)。跨库/多租户合并不在此(单库=单台账)。
51
- """
52
- from __future__ import annotations
53
-
54
- import argparse
55
- import json
56
- import os
57
- import sys
58
-
59
- from . import state_events
60
-
61
- #: 缺档位占位(台账未带 `tier` 时如实标注,不编造档位)。
62
- TIER_UNSPECIFIED = "unspecified"
63
-
64
- #: `history` 条目**必在**字段(单元 schema 逐字;缺键取 None,不改写数据)。
65
- _HIST_FIELDS = ("t", "seq", "old", "new", "kind", "evidence", "actor")
66
-
67
-
68
- # 生效条件:rec 为台账记录 dict——`rec.get("new")` 为 None 时返回 True(撤回/值作废),非 None 时返回 False;入参非 dict 时按 `.get` 抛 AttributeError(台账读面保证为 dict,不吞错)。
69
- def _is_void(rec) -> bool:
70
- """撤回判据(单点):`new` 为空=值作废、无新值(口径见模块头)。"""
71
- return rec.get("new") is None
72
-
73
-
74
- # 生效条件:rec 为一条台账记录 dict 时,返回含 _HIST_FIELDS 七键(缺键取 None)的新 dict——字段集=单元 schema 的 history 条目逐字(不并入行内其余顶层键:新增键即「发明字段」,故限定枚举);值原样不改写、不改写入参。
75
- def _hist_item(rec) -> dict:
76
- """变迁史单条:单元 schema 的七字段原样(值不改写)。"""
77
- return {k: rec.get(k) for k in _HIST_FIELDS}
78
-
79
-
80
- # 生效条件:subject/slot 为分组键、recs 为同组记录(**非空**,落盘序)、history 为真值时——按模块头回放规则返回单元 dict(含 history 键);history 为假值时同一单元但不带 history 键;recs 为空时抛 IndexError(组由记录现场建成,恒非空,不吞错)。
81
- def _replay(subject, slot, recs, *, history=True) -> dict:
82
- """单组回放:现值 / 档位 / 区间 / 变迁史(规则逐条见模块头)。"""
83
- value = None
84
- last_valued = None # 最后**产生当前值**的事件下标(无则 None)
85
- for i, rec in enumerate(recs):
86
- if _is_void(rec):
87
- value = None # 撤回:值作废、无新值
88
- else:
89
- value = rec.get("new")
90
- last_valued = i
91
- last = recs[-1]
92
- retired = _is_void(last) # state:最后一个事件的形态决定
93
- if last_valued is None:
94
- # 全程无有值事件(孤立撤回):起端无可溯源 ⇒ None(不编造)。
95
- t_from, seq_from = None, None
96
- tier = TIER_UNSPECIFIED
97
- else:
98
- lv = recs[last_valued]
99
- t_from, seq_from = lv.get("t"), lv.get("seq")
100
- tier = lv.get("tier")
101
- if tier is None:
102
- tier = TIER_UNSPECIFIED
103
- # 覆盖者:retired 态=撤回事件(最后一条,闭合点=值作废时刻);否则=有值事件的
104
- # **下一条**事件(存在则闭合,不存在=None=未闭合);两者共用同一取舍。
105
- nxt = (len(recs) - 1) if retired else (
106
- None if last_valued is None else last_valued + 1)
107
- if nxt is not None and 0 <= nxt < len(recs):
108
- t_to, seq_to = recs[nxt].get("t"), recs[nxt].get("seq")
109
- else:
110
- t_to, seq_to = None, None
111
- unit = {"subject": subject, "slot": slot, "value": value,
112
- "state": "retired" if retired else "active",
113
- "t_from": t_from, "t_to": t_to,
114
- "seq_from": seq_from, "seq_to": seq_to,
115
- "tier": tier,
116
- # 结构在场、恒空:判定口径后置(模块头,不得臆造填充)。
117
- "alternatives": [], "blindspots": [],
118
- "event_count": len(recs)}
119
- if history:
120
- unit["history"] = [_hist_item(r) for r in recs]
121
- return unit
122
-
123
-
124
- # 生效条件:recs 为台账记录序列(落盘序,可空)时——按 (subject, slot) 分组(组序=首现序)后按 (str(subject), str(slot)) 字典序稳定排序,逐组经 _replay;include_retired 为假时剔除 state=='retired' 的单元,为真时全留;返回单元列表(recs 为空返回 []);history 透传 _replay(假时不带 history 键)。
125
- def _project(recs, *, include_retired=False, history=True) -> list:
126
- """记录序列 → 单元列表(project 与 status 共用的回放单点)。"""
127
- groups = {}
128
- for rec in recs:
129
- key = (rec.get("subject"), rec.get("slot"))
130
- groups.setdefault(key, []).append(rec)
131
- # 排序键经 str() 归一:台账是外部可写面(append-only),非字符串 subject/slot 会让
132
- # 裸元组比较抛 TypeError;字符串形态(正常)下与裸元组字典序逐位一致。
133
- out = []
134
- for key in sorted(groups, key=lambda k: (str(k[0]), str(k[1]))):
135
- unit = _replay(key[0], key[1], groups[key], history=history)
136
- if unit["state"] == "retired" and not include_retired:
137
- continue
138
- out.append(unit)
139
- return out
140
-
141
-
142
- # 生效条件:cg 可解析出 root(经 state_events.ledger_path)时——以 state_events.read(cg, subject=subject, slot=slot) 为源(subject/slot 非 None 才过滤,空串亦为合法过滤值)、现算回放,返回单元列表;include_retired=False 剔除 state=='retired' 的单元;history=False 时单元不带 history 键;台账缺失/为空返回 [](不报错)。**零落盘、零缓存**——同一调用序列中台账追加一条,下一次调用结果即变。
143
- def project(cg, subject=None, slot=None, include_retired=False,
144
- history=True) -> list:
145
- """槽位寄存器投影(查询时现算):list[dict](单元字段见模块头)。
146
-
147
- 纯读函数:不改台账、不写盘、不缓存;过滤委托 `state_events.read`(单点),
148
- 本模块不另写一套条件解析。
149
- """
150
- recs = state_events.read(cg, subject=subject, slot=slot)
151
- return _project(recs, include_retired=include_retired, history=history)
152
-
153
-
154
- # 生效条件:cg 可解析出 root 时——一次 state_events.read(cg) 后返回只读统计 dict:events(台账记录总数)/ subjects(去重 subject 数)/ slots(去重 slot 数)/ retired(回放后 state=='retired' 的单元数)/ bad_rows(state_events.BAD_ROWS 累计值,坏行采样与告警由该模块负责);台账缺失/为空时 events/subjects/slots/retired 皆 0。
155
- def status(cg) -> dict:
156
- """台账与投影的只读读数(不计语义、不改任何状态)。
157
-
158
- 只读一次台账后回放:`bad_rows` 的口径是「累计**跳过动作次数**」(同一坏行每次
159
- read 均计一次,见 `state_events`)——本函数每次调用只产生**一次** read。
160
- `slots` 为去重**槽位名**数(同一槽位名挂在多个主体下只算一次);
161
- `retired` 为回放后退役单元数(值已作废、未复活)。
162
- """
163
- recs = state_events.read(cg)
164
- units = _project(recs, include_retired=True, history=False)
165
- return {"events": len(recs),
166
- "subjects": len({r.get("subject") for r in recs}),
167
- "slots": len({r.get("slot") for r in recs}),
168
- "retired": sum(1 for u in units if u["state"] == "retired"),
169
- "bad_rows": state_events.BAD_ROWS}
170
-
171
-
172
- # 生效条件:root 给定且 md_cg.mdcos 可导入时返回该 root 上的 MdCGOS 实例(形态同 md_cg/sleep.py:_open_cg);导入失败抛原异常。
173
- def _open_cg(root: str):
174
- from .mdcos import MdCGOS
175
- return MdCGOS(root)
176
-
177
-
178
- # 生效条件:传入 argv(None 取 sys.argv)——--status 时打印 status(cg) 的 JSON 并返回 0;否则要求 --subject(可配 --slot)或 --slot 单用,打印 project(cg, subject, slot, include_retired, history) 的 JSON 并返回 0;两者皆缺时打印**全量投影**(含退役需显式 --include-retired)并返回 0;--root 缺省取 datapath.mdcg_root()(env MDCG_ROOT);argparse 对未知参数照常以 SystemExit(2) 退出(不吞)。
179
- def _main(argv=None) -> int:
180
- """只读人工入口:台账现状(--status)/ 槽位投影(--subject [--slot])。
181
-
182
- 本入口**恒可用**(不受 `MDCG_STG_STATE` 开关约束——那把开关管的是 MCP 读面);
183
- 全程只读:不 append、不落盘、不改任何状态。
184
- """
185
- ap = argparse.ArgumentParser(
186
- description="状态槽位投影(只读):台账现算,不落盘、不缓存")
187
- ap.add_argument("--root", default=None, help="数据根(缺省 mdcg_root())")
188
- ap.add_argument("--status", action="store_true",
189
- help="只打印台账/投影统计(events/subjects/slots/retired/bad_rows)")
190
- ap.add_argument("--subject", default=None, help="按主体过滤(省略=不过滤)")
191
- ap.add_argument("--slot", default=None, help="按槽位过滤(省略=不过滤)")
192
- ap.add_argument("--include-retired", dest="include_retired",
193
- action="store_true", help="含退役单元(缺省剔除)")
194
- ap.add_argument("--no-history", dest="history", action="store_false",
195
- help="不带变迁史(history 键省略)")
196
- a = ap.parse_args(argv)
197
- try:
198
- # 进程内调用(守卫/嵌入)会重定向 stdout:无 reconfigure 的流上跳过,
199
- # 不改变任何输出内容。
200
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
201
- except Exception: # noqa: BLE001
202
- pass
203
- root = os.path.abspath(a.root or _default_root())
204
- cg = _open_cg(root)
205
- if a.status:
206
- out = status(cg)
207
- else:
208
- out = project(cg, subject=a.subject, slot=a.slot,
209
- include_retired=a.include_retired, history=a.history)
210
- print(json.dumps(out, ensure_ascii=False, indent=2))
211
- return 0
212
-
213
-
214
- # 生效条件:无入参;返回 datapath.mdcg_root()(env MDCG_ROOT 非空时取该值,否则 paths.json/缺省),失败时抛原异常(不吞)。
215
- def _default_root() -> str:
216
- from .datapath import mdcg_root
217
- return mdcg_root()
218
-
219
-
220
- if __name__ == "__main__":
221
- sys.exit(_main())
1
+ # -*- coding: utf-8 -*-
2
+ """状态槽位寄存器投影(L2「主体×谓词槽位」)——**事件是源、槽位是投影**。
3
+
4
+ 设计稿:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md` §2/§3(P2 批)。
5
+
6
+ 本模块是**投影,不是第二真源**:
7
+ · 源=`md_cg/state_events.py` 的 append-only 台账 `<root>/_state_events.jsonl`;
8
+ · 查询时**现算**——不落盘、不建缓存、不写任何盘面文件;
9
+ · 台账追加一条,投影立刻随之变化(无缓存、无物化表 ⇒ 无第二真源、无漂移面);
10
+ · 本模块**只读**台账(经 `state_events.iter_read`;`append` 归 `state_events`)。
11
+
12
+ 投影单元字段(设计稿 §3 表逐字):
13
+ subject / slot / value / state(active|retired) / t_from / t_to /
14
+ seq_from / seq_to / tier / alternatives / blindspots / history / event_count
15
+
16
+ 回放规则(分组键 `(subject, slot)`,组内按 `state_events.read()` 的**落盘序**):
17
+ · `value` 自 None 起:事件 `new` 非空 → `value=new`;`new` 空(撤回)→ `value=None`
18
+ 且 `state=retired`;其后带值事件自然复活(事件序自然处理,无特判分支)。
19
+ 「空」= `None` **或空白字符串**(#375,2026-10-14;判据单点 `state_events.is_void`(#383:本体在源模块,本模块只绑定))。
20
+ · `state`:**最后一个事件的形态**决定——`new` 空 → `'retired'`;否则 `'active'`。
21
+ · 区间(取值一律用事件行的 `t` 落账时间戳,不另算时间):
22
+ `t_from`/`seq_from` =**最后产生当前值**的那条事件的 `t`/`seq`(retired 态=
23
+ 最后一个**有值**事件的);`t_to`/`seq_to` =**覆盖它的下一条事件**的 `t`/`seq`
24
+ (不存在=None,即「未闭合/仍有效」);retired 态的覆盖者=撤回事件(闭合点
25
+ =值作废时刻)。
26
+ · `tier` =最后有值事件的顶层 `tier` 透传(`append(extra=…)` 会把 extra 并入行
27
+ 顶层,故「extra.tier」与「行顶层 tier」是同一处);缺失(键不在或为 None)→
28
+ `TIER_UNSPECIFIED`——**不编造**。
29
+ · `alternatives` / `blindspots`:本批**结构在场、恒为空列表**——「同期未决值」与
30
+ 「声明缺口」的判定口径**后置**(P1 事件行尚无该信号),**不得臆造填充**。
31
+ · `history` =该槽位全部事件原样(每条=事件行的 `t/seq/old/new/kind/evidence/
32
+ actor` 七字段,值不改写;缺键取 None);`history=False` 时**不带该键**。
33
+
34
+ 撤回判据取 **payload**(`new` 为空)而不是 `kind` 标签:台账口径是「撤回=old 有值而
35
+ new 为空」(`state_events` 模块头),且该模块明言「分类本身不进判据(记账不判语义)」
36
+ ——两者一致时等价;冲突时以 payload 为准(不按标签改写数据)。判据单点=`state_events.is_void`(#383:本体在**源模块**,本模块只绑定不实现)。
37
+
38
+ 过滤与排序:`subject`/`slot` 为 None 不加过滤(该过滤**委托** `state_events.read`,
39
+ 此处不写第二套条件解析);`include_retired=False` 剔除 `state=='retired'` 的单元;
40
+ 结果按 `(subject, slot)` 字典序稳定排序。
41
+
42
+ CLI(纯只读人工入口,**恒可用、无开关**):
43
+ python -X utf8 -m md_cg.state_slots --status
44
+ python -X utf8 -m md_cg.state_slots --subject 鲸娘 [--slot 住所]
45
+ 数据根取 `MDCG_ROOT`(缺省走 `datapath.mdcg_root()`,与 `md_cg/sleep.py` 的
46
+ `_main` 同形)。本面与 stg 的 `MDCG_STG_STATE` 开关**无关**:开关管的是 MCP 读面,
47
+ CLI 是人工排查入口(只读、不改任何状态)。
48
+
49
+ 不适用条件:本模块**不判语义**——「不是事实」的言语(玩笑/元层/回忆转述)之消歧
50
+ 标记(`not_fact` 等)不在本批(P1 事件行无该信号);`alternatives`/`blindspots` 的
51
+ 真值判定亦未落地(见上,恒空列表)。跨库/多租户合并不在此(单库=单台账)。
52
+ """
53
+ from __future__ import annotations
54
+
55
+ import argparse
56
+ import json
57
+ import os
58
+ import sys
59
+
60
+ from . import state_events
61
+
62
+ #: 缺档位占位(台账未带 `tier` 时如实标注,不编造档位)。
63
+ TIER_UNSPECIFIED = "unspecified"
64
+
65
+ #: `history` 条目**必在**字段(单元 schema 逐字;缺键取 None,不改写数据)。
66
+ _HIST_FIELDS = ("t", "seq", "old", "new", "kind", "evidence", "actor")
67
+
68
+
69
+ # 生效条件:rec 为台账记录 dict——直接绑定**源模块**判据 `state_events.is_void`(同一函数对象):`rec.get("new")` 为 None,或为字符串且 `str.strip()` 后为空(含全空白串)时返回 True(撤回/值作废);其余(非 None 且非空白字符串,含数字 0、False、非空串)返回 False;入参非 dict 时按 `.get` 抛 AttributeError(台账读面保证为 dict,不吞错)。
70
+ #: 撤回判据**单点**(#375 口径 + #383 同源上收):本体在**源模块**
71
+ #: `state_events.is_void`(记录面,`None` ∪ 空白串)。本模块**只绑定、不实现**——
72
+ #: 「同一语义在两个落点各写一份判据」正是 #375(投影侧)与 #383(写入口侧)的同一
73
+ #: 病灶形态;绑定同一函数对象即结构性消除该形态。守卫
74
+ #: `md_cg/test_issue383_state_event_write_gate.py` 以 AST 面「全仓含两条腿的判据实现恰
75
+ #: 1 处」+「本模块里它是绑定不是 def」+运行时 `is` 同一性三条断言钉住。
76
+ _is_void = state_events.is_void
77
+
78
+
79
+ # 生效条件:rec 为一条台账记录 dict 时,返回含 _HIST_FIELDS 七键(缺键取 None)的新 dict——字段集=单元 schema 的 history 条目逐字(不并入行内其余顶层键:新增键即「发明字段」,故限定枚举);值原样不改写、不改写入参。
80
+ def _hist_item(rec) -> dict:
81
+ """变迁史单条:单元 schema 的七字段原样(值不改写)。"""
82
+ return {k: rec.get(k) for k in _HIST_FIELDS}
83
+
84
+
85
+ # 生效条件:subject/slot 为分组键、recs 为同组记录(**非空**,落盘序)、history 为真值时——按模块头回放规则返回单元 dict(含 history 键);history 为假值时同一单元但不带 history 键;recs 为空时抛 IndexError(组由记录现场建成,恒非空,不吞错)。
86
+ def _replay(subject, slot, recs, *, history=True) -> dict:
87
+ """单组回放:现值 / 档位 / 区间 / 变迁史(规则逐条见模块头)。"""
88
+ value = None
89
+ last_valued = None # 最后**产生当前值**的事件下标(无则 None)
90
+ for i, rec in enumerate(recs):
91
+ if _is_void(rec):
92
+ value = None # 撤回:值作废、无新值
93
+ else:
94
+ value = rec.get("new")
95
+ last_valued = i
96
+ last = recs[-1]
97
+ retired = _is_void(last) # state:最后一个事件的形态决定
98
+ if last_valued is None:
99
+ # 全程无有值事件(孤立撤回):起端无可溯源 ⇒ None(不编造)。
100
+ t_from, seq_from = None, None
101
+ tier = TIER_UNSPECIFIED
102
+ else:
103
+ lv = recs[last_valued]
104
+ t_from, seq_from = lv.get("t"), lv.get("seq")
105
+ tier = lv.get("tier")
106
+ if tier is None:
107
+ tier = TIER_UNSPECIFIED
108
+ # 覆盖者:retired 态=撤回事件(最后一条,闭合点=值作废时刻);否则=有值事件的
109
+ # **下一条**事件(存在则闭合,不存在=None=未闭合);两者共用同一取舍。
110
+ nxt = (len(recs) - 1) if retired else (
111
+ None if last_valued is None else last_valued + 1)
112
+ if nxt is not None and 0 <= nxt < len(recs):
113
+ t_to, seq_to = recs[nxt].get("t"), recs[nxt].get("seq")
114
+ else:
115
+ t_to, seq_to = None, None
116
+ unit = {"subject": subject, "slot": slot, "value": value,
117
+ "state": "retired" if retired else "active",
118
+ "t_from": t_from, "t_to": t_to,
119
+ "seq_from": seq_from, "seq_to": seq_to,
120
+ "tier": tier,
121
+ # 结构在场、恒空:判定口径后置(模块头,不得臆造填充)。
122
+ "alternatives": [], "blindspots": [],
123
+ "event_count": len(recs)}
124
+ if history:
125
+ unit["history"] = [_hist_item(r) for r in recs]
126
+ return unit
127
+
128
+
129
+ # 生效条件:recs 为落盘序记录(可迭代、可空)时——按 (subject, slot) 分组并稳定排序,经共享分页回放单点返回全量单元;history 为假时不带 history 键;不改写入参记录。
130
+ def _project(recs, *, include_retired=False, history=True) -> list:
131
+ """落盘序记录 → 全量投影;流式分组后逐组释放原始记录。"""
132
+ return _project_history_page(recs, include_retired=include_retired,
133
+ history=history)[1]
134
+
135
+
136
+ # 生效条件:完整消费落盘序 recs 后,按稳定字典序只构造 limit 条结果(None 为全量,负数归零);总数不受 limit 影响;被过滤和超额单元不构造 history。
137
+ def _project_history_page(recs, *, include_retired=False, history=True,
138
+ limit=None) -> tuple:
139
+ """一次扫描,分组后只为本页单元回放/构造历史,返回 (总数, 单元)。"""
140
+ groups = {}
141
+ for rec in recs:
142
+ key = (rec.get("subject"), rec.get("slot"))
143
+ groups.setdefault(key, []).append(rec)
144
+ # 排序键经 str() 归一:台账是外部可写面(append-only),非字符串 subject/slot 会让
145
+ # 裸元组比较抛 TypeError;字符串形态(正常)下与裸元组字典序逐位一致。
146
+ cap = None if limit is None else max(0, int(limit))
147
+ out, total = [], 0
148
+ for key in sorted(groups, key=lambda k: (str(k[0]), str(k[1]))):
149
+ rows = groups.pop(key)
150
+ if not include_retired and _is_void(rows[-1]):
151
+ continue
152
+ total += 1
153
+ if cap is None or len(out) < cap:
154
+ out.append(_replay(key[0], key[1], rows, history=history))
155
+ return total, out
156
+
157
+
158
+ # 生效条件:recs 为落盘序记录迭代器时,返回逐单元现值投影;include_retired 为假时剔除退役单元;每单元只留当前字段,零落盘零缓存。
159
+ def _project_current(recs, *, include_retired=False) -> list:
160
+ """不保留历史的全量投影(现值归约单点见下)。"""
161
+ return _project_current_page(recs, include_retired=include_retired)[1]
162
+
163
+
164
+ # 生效条件:完整消费 recs;每单元只存计数/最后有值起端/最终闭合端;返回 (总数, 前 limit 条投影),None 为全量,负数归零;不保留已撤回值正文。
165
+ def _project_current_page(recs, *, include_retired=False, limit=None) -> tuple:
166
+ """单遍现值投影:每个 (subject, slot) 只保留当前单元,空间随单元数增长。
167
+
168
+ 不保留事件正文或完整历史;不缓存、不写盘。撤回仍保留最后有值事件的
169
+ 起端与档位,连续撤回使用最后撤回的闭合端;后续有值事件自然复活。
170
+ """
171
+ groups = {}
172
+ for rec in recs:
173
+ key = (rec.get("subject"), rec.get("slot"))
174
+ group = groups.get(key)
175
+ if group is None:
176
+ # count, last valued event's four required fields, final retraction endpoints.
177
+ group = [0, None, None]
178
+ groups[key] = group
179
+ group[0] += 1
180
+ if _is_void(rec):
181
+ group[2] = (rec.get("t"), rec.get("seq"))
182
+ if group[1] is not None:
183
+ # Retraction preserves provenance, but its old value is not returned.
184
+ _, t_from, seq_from, tier = group[1]
185
+ group[1] = (None, t_from, seq_from, tier)
186
+ else:
187
+ group[1] = (rec.get("new"), rec.get("t"), rec.get("seq"), rec.get("tier"))
188
+ group[2] = None
189
+ cap = None if limit is None else max(0, int(limit))
190
+ out, total = [], 0
191
+ for key in sorted(groups, key=lambda k: (str(k[0]), str(k[1]))):
192
+ count, valued, closed = groups.pop(key)
193
+ retired = closed is not None
194
+ if retired and not include_retired:
195
+ continue
196
+ total += 1
197
+ if cap is not None and len(out) >= cap:
198
+ continue
199
+ value, t_from, seq_from, tier = valued if valued is not None else (
200
+ None, None, None, TIER_UNSPECIFIED)
201
+ t_to, seq_to = closed if retired else (None, None)
202
+ out.append({"subject": key[0], "slot": key[1],
203
+ "value": None if retired else value,
204
+ "state": "retired" if retired else "active",
205
+ "t_from": t_from, "t_to": t_to,
206
+ "seq_from": seq_from, "seq_to": seq_to,
207
+ "tier": TIER_UNSPECIFIED if tier is None else tier,
208
+ "alternatives": [], "blindspots": [], "event_count": count})
209
+ return total, out
210
+
211
+
212
+ # 生效条件:cg 可解析 root 时现算回放;history=False 单遍读取且不保留历史,history=True 返回原样七字段历史;subject/slot 非 None 才过滤;include_retired=False 剔除退役单元;缺失/空台账返回 []。零落盘零缓存,后续追加立即可见。
213
+ def project(cg, subject=None, slot=None, include_retired=False,
214
+ history=True) -> list:
215
+ """槽位寄存器投影(查询时现算):list[dict](单元字段见模块头)。
216
+
217
+ 纯读函数:不改台账、不写盘、不缓存;过滤委托 `state_events.iter_read`
218
+ (与 read 共用单点),本模块不另写一套条件解析。
219
+ """
220
+ return project_page(cg, subject=subject, slot=slot,
221
+ include_retired=include_retired, history=history,
222
+ limit=None)[1]
223
+
224
+
225
+ # 生效条件:参数与 project 同形;完整扫描同一台账一次后返回 (命中总数, 按原排序前 limit 条单元);None 返回全量,0/负数只计数;全量坏行诊断保留,零落盘零缓存。
226
+ def project_page(cg, subject=None, slot=None, include_retired=False,
227
+ history=True, limit=50) -> tuple:
228
+ """投影分页:总数精确;未返回的单元不构造结果或七字段历史。
229
+
230
+ 仍完整读一次台账。history=True 的分组保持全部原始事件,回放后即释放;
231
+ history=False 仅保留每个单元的当前元数据。limit 不截断事件读取。
232
+ """
233
+ recs = state_events.iter_read(cg, subject=subject, slot=slot)
234
+ if not history:
235
+ return _project_current_page(recs, include_retired=include_retired, limit=limit)
236
+ return _project_history_page(recs, include_retired=include_retired, limit=limit)
237
+
238
+
239
+ # 生效条件:cg 可解析 root 时——一次完整 iter_read 扫描后返回 events/subjects/slots/retired/bad_rows;每单元只留最后事件是否撤回,不保留历史;空台账计数皆 0,坏行计数与告警仍由 state_events 负责。
240
+ def status(cg) -> dict:
241
+ """台账与投影的只读读数(不计语义、不改任何状态)。
242
+
243
+ 只读一次台账后统计:`bad_rows` 的口径是「累计**跳过动作次数**」(同一坏行每次
244
+ read 均计一次,见 `state_events`)——本函数每次调用只产生**一次** read。
245
+ `slots` 为去重**槽位名**数(同一槽位名挂在多个主体下只算一次);
246
+ `retired` 为回放后退役单元数(值已作废、未复活)。
247
+ """
248
+ subjects, slots, retired_by_key = set(), set(), {}
249
+ events = 0
250
+ for rec in state_events.iter_read(cg):
251
+ subject, slot = rec.get("subject"), rec.get("slot")
252
+ subjects.add(subject)
253
+ slots.add(slot)
254
+ retired_by_key[(subject, slot)] = _is_void(rec)
255
+ events += 1
256
+ return {"events": events,
257
+ "subjects": len(subjects),
258
+ "slots": len(slots),
259
+ "retired": sum(retired_by_key.values()),
260
+ "bad_rows": state_events.BAD_ROWS}
261
+
262
+
263
+ # 生效条件:root 给定且 md_cg.mdcos 可导入时返回该 root 上的 MdCGOS 实例(形态同 md_cg/sleep.py:_open_cg);导入失败抛原异常。
264
+ def _open_cg(root: str):
265
+ from .mdcos import MdCGOS
266
+ return MdCGOS(root)
267
+
268
+
269
+ # 生效条件:传入 argv(None 取 sys.argv)——--status 时打印 status(cg) 的 JSON 并返回 0;否则要求 --subject(可配 --slot)或 --slot 单用,打印 project(cg, subject, slot, include_retired, history) 的 JSON 并返回 0;两者皆缺时打印**全量投影**(含退役需显式 --include-retired)并返回 0;--root 缺省取 datapath.mdcg_root()(env MDCG_ROOT);argparse 对未知参数照常以 SystemExit(2) 退出(不吞)。
270
+ def _main(argv=None) -> int:
271
+ """只读人工入口:台账现状(--status)/ 槽位投影(--subject [--slot])。
272
+
273
+ 本入口**恒可用**(不受 `MDCG_STG_STATE` 开关约束——那把开关管的是 MCP 读面);
274
+ 全程只读:不 append、不落盘、不改任何状态。
275
+ """
276
+ ap = argparse.ArgumentParser(
277
+ description="状态槽位投影(只读):台账现算,不落盘、不缓存")
278
+ ap.add_argument("--root", default=None, help="数据根(缺省 mdcg_root())")
279
+ ap.add_argument("--status", action="store_true",
280
+ help="只打印台账/投影统计(events/subjects/slots/retired/bad_rows)")
281
+ ap.add_argument("--subject", default=None, help="按主体过滤(省略=不过滤)")
282
+ ap.add_argument("--slot", default=None, help="按槽位过滤(省略=不过滤)")
283
+ ap.add_argument("--include-retired", dest="include_retired",
284
+ action="store_true", help="含退役单元(缺省剔除)")
285
+ ap.add_argument("--no-history", dest="history", action="store_false",
286
+ help="不带变迁史(history 键省略)")
287
+ a = ap.parse_args(argv)
288
+ try:
289
+ # 进程内调用(守卫/嵌入)会重定向 stdout:无 reconfigure 的流上跳过,
290
+ # 不改变任何输出内容。
291
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
292
+ except Exception: # noqa: BLE001
293
+ pass
294
+ root = os.path.abspath(a.root or _default_root())
295
+ cg = _open_cg(root)
296
+ if a.status:
297
+ out = status(cg)
298
+ else:
299
+ out = project(cg, subject=a.subject, slot=a.slot,
300
+ include_retired=a.include_retired, history=a.history)
301
+ print(json.dumps(out, ensure_ascii=False, indent=2))
302
+ return 0
303
+
304
+
305
+ # 生效条件:无入参;返回 datapath.mdcg_root()(env MDCG_ROOT 非空时取该值,否则 paths.json/缺省),失败时抛原异常(不吞)。
306
+ def _default_root() -> str:
307
+ from .datapath import mdcg_root
308
+ return mdcg_root()
309
+
310
+
311
+ if __name__ == "__main__":
312
+ sys.exit(_main())