@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  531. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  535. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  539. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  543. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  547. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  548. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  549. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  550. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  551. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  552. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  553. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  554. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  559. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  563. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  564. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  565. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  566. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  567. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  568. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  569. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  570. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  571. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  572. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,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())