@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
@@ -135,15 +135,17 @@ def _run(tmp):
135
135
  "content": "PASSED SKIPME",
136
136
  "layer": "knowledge"})
137
137
  _check("移除即恢复(核心文件零改动)", out.get("committed") is True, repr(out))
138
- # 默认 before 链含 linkref→ghostref→deps→audit→consistency→gated→autonomy
138
+ # 默认 before 链含 linkref→ghostref→deps→condspace→audit→consistency→gated→autonomy
139
+ # (condspace = 条件空间闸,2026-10-18 memory-gate 批次插在 deps 之后:缺条件
140
+ # 空间的写入当场打回作者,须早于 audit 留痕与 gated 档位判定)
139
141
  # (2026-09-19 deps 闸门新增;2026-10-05 A2 幽灵引用闸插 linkref 之后——
140
142
  # 消费 ctx["linkref_targets"] 免重解析、永不短路;2026-10-02 三档自治
141
143
  # 批次② 档位闸**恒在链尾**——档位判定必须晚于全部既有资格闸,见
142
144
  # writepipe._gate_autonomy docstring。断言意图不变:默认链的注册表与执行序
143
145
  # = 这一串。)
144
146
  _check("单例默认链", singleton.names()["before"]
145
- == ["linkref", "ghostref", "deps", "audit", "consistency", "gated",
146
- "autonomy"],
147
+ == ["linkref", "ghostref", "deps", "condspace", "audit", "consistency",
148
+ "gated", "autonomy"],
147
149
  repr(singleton.names()))
148
150
  _check("单例默认after链", singleton.names()["after"]
149
151
  == ["linkref", "trust"],
@@ -0,0 +1,534 @@
1
+ # -*- coding: utf-8 -*-
2
+ """timeanchor · 相对时间锚定(`MDCG_TIME_ANCHOR=1` 开启;缺省关闭,关闭时零调用)。
3
+
4
+ # 功能名:把正文里的相对/显式时间表达,以观测时刻为参照归一成**事件区间**(派生、可审计)
5
+ # 生效条件:MDCG_TIME_ANCHOR=="1";写入侧仅在节点**无显式 temporal**、非加密密级、规则能解析时落派生字段;查询侧仅在问句含规则表内的日期写法时启用
6
+ # 子功能:①规则表(英文/中文相对表达 + 带年份绝对日期)②derive:正文 → 派生字段 ③parse_query:问句 → 区间 ④node_interval:节点 → 事件区间(显式 temporal > 派生 > 观测当日)
7
+ # 执行:被 md_cg/mdcg.py::MdCG.add(写入侧)与 md_cg/mdcos.py::MdCGOS.search_rrf(查询侧)调用;本模块纯函数、只用标准库
8
+ # 验证方式:md_cg/test_time_anchor.py(守卫 + 定点变异);md_cg/bench_timeanchor.py(LoCoMo 复现)
9
+ # 不适用条件:规则表外的写法(「国庆前后」「上上周」)不解析;时长推理(「多久」)不做;观测时刻不是说话时刻(批量导入统一写成导入时间)时参照日错位
10
+
11
+ ## 为什么有这个文件
12
+
13
+ 对话记忆里事件时间几乎总是相对写法——「昨天」「上周二」「last weekend」「two years
14
+ ago」。节点只记了**观测时刻**(`created_at`,即说这句话的时刻),没有**事件时刻**。于是
15
+ 「2023年5月7日 Caroline 做了什么」这类按日期点名的问句,字面检索与时间算子都落空:
16
+ 证据写的是 *yesterday*,观测时刻是 5 月 8 日。
17
+
18
+ ## 口径(逐条钉死)
19
+
20
+ * **派生字段** `temporal_anchor`(`DERIVED_FIELD`)落 frontmatter,形如
21
+ `{"start": "2023-05-07", "end": "2023-05-07", "rule": "en.yesterday",
22
+ "span": [12, 21], "ref": "2023-05-08", "v": 1}`——
23
+ 闭区间(ISO 日期串)、命中规则 id、命中位置(字符偏移,**不抄原文**,避免把正文片段
24
+ 复制进明文 frontmatter)、参照日、口径版本。
25
+ * **不覆盖用户显式写的 `temporal`**:显式 `temporal` 存在即不派生;派生字段也**不并入**
26
+ `trust.time_window_of` 的任何轴(不改既有时间算子语义——只被本特性的查询侧读取)。
27
+ * **解析不了就不写、不猜**:正文没有规则表内的时间表达 → 不落字段。查询侧对这类节点按
28
+ 「观测当日」处理(与「只按时间戳」同口径,且在排序上排在显式/派生区间之后)。
29
+ * **参照日时区**:`created_at` 是 UNIX 秒,按 `MDCG_TIME_ANCHOR_TZ`(相对 UTC 的小时数,
30
+ 缺省 0)换算成日历日;非法值回落 0。
31
+ * **多条命中**取文本中最靠前者(「day before yesterday」先于其中的 yesterday;同位置按表序)。
32
+ * 带年份的绝对日期(`_ABS`)优先于相对表达(`RULES`)。
33
+
34
+ ## 约定(不是事实,见设计文档「可信边界」)
35
+
36
+ 「上周 / last week」取参照日前 7 天的滚动窗口而非日历周;「this weekend」按说话星期推断
37
+ 过去或将来;缺年份的「5月7日」取不晚于参照日的最近一次;「for N years」按「N 年前」取区间。
38
+ """
39
+ from __future__ import annotations
40
+
41
+ import datetime as _dt
42
+ import os
43
+ import re
44
+ from typing import Callable, List, Optional, Sequence, Tuple
45
+
46
+ #: 总开关(缺省关)。登记:hotcache._ENV_SWITCHES + config_registry_bulk.ENV_CATEGORY_ROWS。
47
+ FLAG = "MDCG_TIME_ANCHOR"
48
+ #: 参照日时区(相对 UTC 的小时数,缺省 0)。同上登记。
49
+ TZ_FLAG = "MDCG_TIME_ANCHOR_TZ"
50
+ #: 派生字段名(frontmatter 键)。
51
+ DERIVED_FIELD = "temporal_anchor"
52
+ #: 用户显式事件时刻字段(与 trust.OBSERVED_TIME_FIELD 同名;此处不 import trust 免循环)。
53
+ EXPLICIT_FIELD = "temporal"
54
+ #: 派生口径版本:规则语义变了就加一,存量节点可据此判陈旧。
55
+ DERIVE_VERSION = 1
56
+
57
+ Interval = Tuple[_dt.date, _dt.date]
58
+ _D = _dt.date
59
+ _TD = _dt.timedelta
60
+
61
+
62
+ # 生效条件:environ(缺省 os.environ)里 FLAG 去空白后恰为 "1" 时返回 True,其余(缺失/空串/"0"/"true")一律 False。
63
+ def enabled(environ=None) -> bool:
64
+ """总开关的唯一读取点(与 MDCG_RANK_CREDIBILITY 同款:只认字面 "1")。"""
65
+ return (environ or os.environ).get(FLAG, "").strip() == "1"
66
+
67
+
68
+ # 生效条件:environ(缺省 os.environ)里 TZ_FLAG 可被 float() 解析且落在 [-14, 14] 时返回该值,缺失/非法/越界一律回落 0.0(不抛)。
69
+ def tz_hours(environ=None) -> float:
70
+ raw = (environ or os.environ).get(TZ_FLAG, "")
71
+ try:
72
+ h = float(raw) if str(raw).strip() else 0.0
73
+ except (TypeError, ValueError):
74
+ return 0.0
75
+ return h if -14.0 <= h <= 14.0 else 0.0
76
+
77
+
78
+ # 生效条件:ts 可被 float() 解析为有限 UNIX 秒时,返回按 tz_hours() 偏移后的公历日;None/非法/溢出返回 None(不猜)。
79
+ def ts_to_date(ts, environ=None) -> Optional[_dt.date]:
80
+ if ts is None or isinstance(ts, bool):
81
+ return None
82
+ try:
83
+ sec = float(ts) + 3600.0 * tz_hours(environ)
84
+ return (_dt.datetime(1970, 1, 1) + _TD(seconds=sec)).date()
85
+ except (OverflowError, ValueError, TypeError):
86
+ return None
87
+
88
+
89
+ # ---------------------------------------------------------------- 日历工具
90
+ # 生效条件:1<=m<=12 时返回该月首末日闭区间;否则抛 ValueError(由 _first 吞掉判「不可解析」)。
91
+ def month_iv(y: int, m: int) -> Interval:
92
+ s = _D(y, m, 1)
93
+ e = (_D(y + 1, 1, 1) if m == 12 else _D(y, m + 1, 1)) - _TD(1)
94
+ return (s, e)
95
+
96
+
97
+ # 生效条件:y 在 date 合法年份内时返回该年 1/1~12/31。
98
+ def year_iv(y: int) -> Interval:
99
+ return (_D(y, 1, 1), _D(y, 12, 31))
100
+
101
+
102
+ # 生效条件:d 为日期、n 为整数月偏移时返回偏移后的 (年, 月)。
103
+ def shift_month(d: _dt.date, n: int) -> Tuple[int, int]:
104
+ m = d.month - 1 + n
105
+ return d.year + m // 12, m % 12 + 1
106
+
107
+
108
+ # 生效条件:返回 d 之前 7 天的滚动窗口 [d-7, d-1](约定:不是日历周)。
109
+ def week_before(d: _dt.date) -> Interval:
110
+ return (d - _TD(7), d - _TD(1))
111
+
112
+
113
+ # 生效条件:返回严格早于 d 所在周的最近一个周末(周六、周日);d 为周六/周日时取上一周末。
114
+ def weekend_before(d: _dt.date) -> Interval:
115
+ wd = d.weekday()
116
+ sat = d - _TD(8) if wd == 6 else d - _TD(7) if wd == 5 else d - _TD(wd + 2)
117
+ return (sat, sat + _TD(1))
118
+
119
+
120
+ # 生效条件:周一、周二说「这个周末」取刚过去的周末;周六日取当周;周三至周五取即将到来的(约定)。
121
+ def this_weekend(d: _dt.date) -> Interval:
122
+ wd = d.weekday()
123
+ if wd <= 1:
124
+ return weekend_before(d)
125
+ sat = d - _TD(wd - 5) if wd >= 5 else d + _TD(5 - wd)
126
+ return (sat, sat + _TD(1))
127
+
128
+
129
+ # 生效条件:返回 d 的下一个日历周的周六、周日。
130
+ def next_weekend(d: _dt.date) -> Interval:
131
+ sat = d - _TD(d.weekday()) + _TD(12)
132
+ return (sat, sat + _TD(1))
133
+
134
+
135
+ # 生效条件:返回严格早于 d 的最近一个星期 w(0=周一);d 本身是星期 w 时取 7 天前(`or 7` 承重)。
136
+ def last_wd(d: _dt.date, w: int) -> Interval:
137
+ x = d - _TD((d.weekday() - w) % 7 or 7)
138
+ return (x, x)
139
+
140
+
141
+ # 生效条件:返回严格晚于 d 的最近一个星期 w;d 本身是星期 w 时取 7 天后。
142
+ def next_wd(d: _dt.date, w: int) -> Interval:
143
+ x = d + _TD((w - d.weekday()) % 7 or 7)
144
+ return (x, x)
145
+
146
+
147
+ # 生效条件:unit ∈ {day, week, month, year};day→点、week→以 d-7n 为中心 ±3 天、month→该月、year→该年。
148
+ def ago(d: _dt.date, n: int, unit: str) -> Interval:
149
+ if unit == "day":
150
+ x = d - _TD(n)
151
+ return (x, x)
152
+ if unit == "week":
153
+ x = d - _TD(7 * n)
154
+ return (x - _TD(3), x + _TD(3))
155
+ if unit == "month":
156
+ return month_iv(*shift_month(d, -n))
157
+ return year_iv(d.year - n)
158
+
159
+
160
+ _SEASON_ALIAS = {"autumn": "fall", "春": "spring", "夏": "summer", "秋": "fall", "冬": "winter"}
161
+
162
+
163
+ # 生效条件:s 为季节名(英文或「春夏秋冬」);n=-1 取 d 之前最近一个已结束的该季节,n=0 取 d 所在年的该季节;北半球气象季节(约定)。
164
+ def season_iv(d: _dt.date, s: str, n: int) -> Interval:
165
+ s = _SEASON_ALIAS.get(s, s)
166
+ rng = {"spring": (3, 5), "summer": (6, 8), "fall": (9, 11)}
167
+ if s == "winter":
168
+ y = d.year if (n == 0 or d.month >= 3) else d.year - 1
169
+ return (_D(y - 1, 12, 1), month_iv(y, 2)[1])
170
+ a, b = rng[s]
171
+ y = d.year
172
+ if n < 0 and d.month <= b:
173
+ y -= 1
174
+ return (_D(y, a, 1), month_iv(y, b)[1])
175
+
176
+
177
+ # 生效条件:m 为 1..12;返回不晚于 d 的最近一次该月。
178
+ def month_recent(d: _dt.date, m: int) -> Interval:
179
+ return month_iv(d.year if m <= d.month else d.year - 1, m)
180
+
181
+
182
+ # 生效条件:(m, day) 构成合法日期时返回不晚于 d 的最近一次该日;非法日期返回 None。
183
+ def day_recent(d: _dt.date, m: int, day: int) -> Optional[Interval]:
184
+ for y in (d.year, d.year - 1):
185
+ try:
186
+ x = _D(y, m, day)
187
+ except ValueError:
188
+ return None
189
+ if x <= d:
190
+ return (x, x)
191
+ return None
192
+
193
+
194
+ # 生效条件:1<=n<=31;n 不晚于 d.day 取本月第 n 日,否则取上月第 n 日;日期非法返回 None。
195
+ def nth_day(d: _dt.date, n: int) -> Optional[Interval]:
196
+ if not 1 <= n <= 31:
197
+ return None
198
+ try:
199
+ x = _D(d.year, d.month, n) if n <= d.day else _D(*shift_month(d, -1), n)
200
+ except ValueError:
201
+ return None
202
+ return (x, x)
203
+
204
+
205
+ # 生效条件:(y, m, d) 构成合法日期时返回该点区间,否则 None。
206
+ def _point(y: int, m: int, d: int) -> Optional[Interval]:
207
+ try:
208
+ x = _D(y, m, d)
209
+ except ValueError:
210
+ return None
211
+ return (x, x)
212
+
213
+
214
+ # ---------------------------------------------------------------- 数词
215
+ _EN_MON = ["january", "february", "march", "april", "may", "june", "july", "august",
216
+ "september", "october", "november", "december"]
217
+ MON = {m: i + 1 for i, m in enumerate(_EN_MON)}
218
+ MON.update({m[:3]: i + 1 for i, m in enumerate(_EN_MON)})
219
+ MON["sept"] = 9
220
+ _MONP = (r"(january|february|march|april|may|june|july|august|september|october|november"
221
+ r"|december|jan|feb|mar|apr|jun|jul|aug|sept?|oct|nov|dec)")
222
+ _EN_WD = {w: i for i, w in enumerate(["monday", "tuesday", "wednesday", "thursday", "friday",
223
+ "saturday", "sunday"])}
224
+ _EN_WD.update({"mon": 0, "tue": 1, "tues": 1, "wed": 2, "thu": 3, "thur": 3, "thurs": 3,
225
+ "fri": 4, "sat": 5, "sun": 6})
226
+ _WDP = r"(monday|tuesday|wednesday|thursday|friday|saturday|sunday|mon|tues?|wed|thu(?:rs?)?|fri|sat|sun)"
227
+ _EN_NUM = {"a": 1, "an": 1, "one": 1, "two": 2, "three": 3, "four": 4, "five": 5, "six": 6,
228
+ "seven": 7, "eight": 8, "nine": 9, "ten": 10, "couple of": 2, "few": 3, "several": 3}
229
+ _ENNP = r"(\d+|a|an|one|two|three|four|five|six|seven|eight|nine|ten|couple of|few|several)"
230
+ _UNIT_EN = r"(day|week|month|year)s?"
231
+
232
+ _CN_DIG = {"零": 0, "〇": 0, "一": 1, "二": 2, "两": 2, "三": 3, "四": 4, "五": 5, "六": 6,
233
+ "七": 7, "八": 8, "九": 9}
234
+ _CNNP = r"([0-9]{1,4}|[零〇一二两三四五六七八九十百]{1,5}|几)"
235
+ _CN_WD = {"一": 0, "二": 1, "三": 2, "四": 3, "五": 4, "六": 5, "日": 6, "天": 6}
236
+ _CN_UNIT = {"天": "day", "日": "day", "周": "week", "星期": "week", "礼拜": "week",
237
+ "个月": "month", "月": "month", "年": "year"}
238
+
239
+
240
+ # 生效条件:s 为阿拉伯数字串或「零〇一二两三四五六七八九十百」组合时返回其整数值;「几」按 3(约定);含其它字符或值为 0 返回 None。
241
+ def cn_num(s: str) -> Optional[int]:
242
+ if s.isdigit():
243
+ return int(s) or None
244
+ if s == "几":
245
+ return 3
246
+ total, cur = 0, None
247
+ for ch in s:
248
+ if ch in _CN_DIG:
249
+ cur = _CN_DIG[ch]
250
+ elif ch in "十百":
251
+ total += (1 if cur is None else cur) * (10 if ch == "十" else 100)
252
+ cur = None
253
+ else:
254
+ return None
255
+ total += cur or 0
256
+ return total or None
257
+
258
+
259
+ # 生效条件:s 为 _EN_NUM 的键或数字串时返回整数,否则抛 ValueError(由 _first 吞掉)。
260
+ def _en_n(s: str) -> int:
261
+ return _EN_NUM.get(s.lower()) or int(s)
262
+
263
+
264
+ def _r(p, flags=re.I):
265
+ return re.compile(p, flags)
266
+
267
+
268
+ # 生效条件:n 为假值(None/0)时返回 None;否则调 f(n)。
269
+ def _if_n(n, f):
270
+ return f(n) if n else None
271
+
272
+
273
+ # ---------------------------------------------------------------- 规则表
274
+ #: 每条:(规则 id, 编译正则, 构造函数(m, ref_date) → 区间或 None)。
275
+ #: id 落进派生字段的 `rule`,审计时可直接指认是哪一条规则给的区间。
276
+ Rule = Tuple[str, "re.Pattern", Callable]
277
+
278
+ RULES: List[Rule] = [
279
+ # ---- 英文(23 条)
280
+ ("en.day_before_yesterday", _r(r"\bday before yesterday\b"), lambda m, d: (d - _TD(2),) * 2),
281
+ ("en.yesterday", _r(r"\byesterday\b|\blast night\b"), lambda m, d: (d - _TD(1),) * 2),
282
+ ("en.tomorrow", _r(r"\btomorrow\b"), lambda m, d: (d + _TD(1),) * 2),
283
+ ("en.last_weekend", _r(r"\b(?:last|past|this past) weekend\b"), lambda m, d: weekend_before(d)),
284
+ ("en.this_weekend", _r(r"\bthis weekend\b"), lambda m, d: this_weekend(d)),
285
+ ("en.last_week", _r(r"\b(?:last|past) week\b|\ba week ago\b"), lambda m, d: week_before(d)),
286
+ ("en.next_week", _r(r"\bnext week\b"), lambda m, d: (d + _TD(1), d + _TD(7))),
287
+ ("en.next_month", _r(r"\bnext month\b"), lambda m, d: month_iv(*shift_month(d, 1))),
288
+ ("en.last_month", _r(r"\blast month\b|\ba month ago\b"), lambda m, d: month_iv(*shift_month(d, -1))),
289
+ ("en.this_month", _r(r"\bthis month\b"), lambda m, d: month_iv(d.year, d.month)),
290
+ ("en.month_last_year", _r(_MONP + r" last year\b"),
291
+ lambda m, d: month_iv(d.year - 1, MON[m.group(1).lower()])),
292
+ ("en.last_year", _r(r"\blast year\b|\ba year ago\b"), lambda m, d: year_iv(d.year - 1)),
293
+ ("en.this_year", _r(r"\bthis year\b"), lambda m, d: year_iv(d.year)),
294
+ ("en.next_year", _r(r"\bnext year\b"), lambda m, d: year_iv(d.year + 1)),
295
+ ("en.last_season", _r(r"\blast (summer|winter|spring|fall|autumn)\b"),
296
+ lambda m, d: season_iv(d, m.group(1).lower(), -1)),
297
+ ("en.n_units_ago", _r(r"\b" + _ENNP + r" " + _UNIT_EN + r" ago\b"),
298
+ lambda m, d: ago(d, _en_n(m.group(1)), m.group(2).lower())),
299
+ ("en.for_n_units", _r(r"\bfor (?:about |almost |over |nearly )?" + _ENNP + r" " + _UNIT_EN + r"\b"),
300
+ lambda m, d: ago(d, _en_n(m.group(1)), m.group(2).lower())),
301
+ ("en.next_weekday", _r(r"\bnext " + _WDP + r"\b"), lambda m, d: next_wd(d, _EN_WD[m.group(1).lower()])),
302
+ ("en.last_weekday", _r(r"\b(?:last|on|this|this past) " + _WDP + r"\b"),
303
+ lambda m, d: last_wd(d, _EN_WD[m.group(1).lower()])),
304
+ # 刻意不含 may:「in may」与情态动词 may 同形,误判代价高于漏判
305
+ ("en.in_month", _r(r"\b(?:in|this|last) (january|february|march|april|june|july|august"
306
+ r"|september|october|november|december)\b"),
307
+ lambda m, d: month_recent(d, MON[m.group(1).lower()])),
308
+ ("en.on_nth", _r(r"\bon the (\d{1,2})(?:st|nd|rd|th)\b"), lambda m, d: nth_day(d, int(m.group(1)))),
309
+ ("en.in_year", _r(r"\bin (19\d\d|20\d\d)\b"), lambda m, d: year_iv(int(m.group(1)))),
310
+ ("en.today", _r(r"\btoday\b|\btonight\b|\bthis (?:morning|afternoon|evening)\b"), lambda m, d: (d, d)),
311
+ # ---- 中文(27 条)
312
+ ("zh.大前天", _r(r"大前天"), lambda m, d: (d - _TD(3),) * 2),
313
+ ("zh.前天", _r(r"前天"), lambda m, d: (d - _TD(2),) * 2),
314
+ ("zh.昨天", _r(r"昨天|昨晚|昨日|昨儿"), lambda m, d: (d - _TD(1),) * 2),
315
+ ("zh.大后天", _r(r"大后天"), lambda m, d: (d + _TD(3),) * 2),
316
+ ("zh.后天", _r(r"后天"), lambda m, d: (d + _TD(2),) * 2),
317
+ ("zh.明天", _r(r"明天|明晚|明早|明日"), lambda m, d: (d + _TD(1),) * 2),
318
+ ("zh.今天", _r(r"今天|今晚|今早|今日|今儿"), lambda m, d: (d, d)),
319
+ ("zh.上周X", _r(r"(?:上|上个)(?:周|星期|礼拜)([一二三四五六日天末])"),
320
+ lambda m, d: weekend_before(d) if m.group(1) == "末" else last_wd(d, _CN_WD[m.group(1)])),
321
+ ("zh.下周X", _r(r"(?:下|下个)(?:周|星期|礼拜)([一二三四五六日天末])"),
322
+ lambda m, d: next_weekend(d) if m.group(1) == "末"
323
+ else next_wd(d + _TD(6 - d.weekday()), _CN_WD[m.group(1)])),
324
+ ("zh.这周X", _r(r"(?:这|这个|本)(?:周|星期|礼拜)([一二三四五六日天末])"),
325
+ lambda m, d: this_weekend(d) if m.group(1) == "末"
326
+ else (lambda x: (x, x))(d - _TD(d.weekday()) + _TD(_CN_WD[m.group(1)]))),
327
+ ("zh.周X", _r(r"(?<![上下这本个])(?:周|星期|礼拜)([一二三四五六日天])"),
328
+ lambda m, d: last_wd(d, _CN_WD[m.group(1)])),
329
+ ("zh.周末", _r(r"周末"), lambda m, d: this_weekend(d)),
330
+ ("zh.上周", _r(r"(?:上|上个)(?:周|星期|礼拜)"), lambda m, d: week_before(d)),
331
+ ("zh.下周", _r(r"(?:下|下个)(?:周|星期|礼拜)"), lambda m, d: (d + _TD(1), d + _TD(7))),
332
+ ("zh.上月", _r(r"上(?:个)?月"), lambda m, d: month_iv(*shift_month(d, -1))),
333
+ ("zh.下月", _r(r"下(?:个)?月"), lambda m, d: month_iv(*shift_month(d, 1))),
334
+ ("zh.本月", _r(r"(?:这|这个|本)月"), lambda m, d: month_iv(d.year, d.month)),
335
+ ("zh.去年季节", _r(r"去年(?:的)?([春夏秋冬])(?:天|季)"),
336
+ lambda m, d: season_iv(_D(d.year - 1, 12, 31), m.group(1), 0)),
337
+ ("zh.去年X月", _r(r"去年([0-9]{1,2}|[一二三四五六七八九十]{1,3})月"),
338
+ lambda m, d: _if_n(cn_num(m.group(1)), lambda n: month_iv(d.year - 1, n) if n <= 12 else None)),
339
+ ("zh.前年", _r(r"前年"), lambda m, d: year_iv(d.year - 2)),
340
+ ("zh.去年", _r(r"去年"), lambda m, d: year_iv(d.year - 1)),
341
+ ("zh.今年", _r(r"今年"), lambda m, d: year_iv(d.year)),
342
+ ("zh.明年", _r(r"明年"), lambda m, d: year_iv(d.year + 1)),
343
+ ("zh.前几天", _r(r"前几天|几天前|前些天|这几天"), lambda m, d: (d - _TD(7), d - _TD(1))),
344
+ ("zh.N单位前", _r(_CNNP + r"\s*(天|日|周|星期|礼拜|个月|年)(?:以)?前"),
345
+ lambda m, d: _if_n(cn_num(m.group(1)), lambda n: ago(d, n, _CN_UNIT[m.group(2)]))),
346
+ ("zh.X月X日", _r(r"(?<![0-9年])([0-9]{1,2}|[一二三四五六七八九十]{1,3})月"
347
+ r"([0-9]{1,2}|[一二三四五六七八九十]{1,3})(?:日|号)"),
348
+ lambda m, d: (lambda a, b: day_recent(d, a, b) if a and b and a <= 12 else None)(
349
+ cn_num(m.group(1)), cn_num(m.group(2)))),
350
+ ("zh.X号", _r(r"(?<![上下这本个0-9年月])([0-9]{1,2})号"), lambda m, d: nth_day(d, int(m.group(1)))),
351
+ ]
352
+
353
+ #: 带年份的绝对日期(8 条):写入与查询共用,优先级高于 RULES。构造函数只吃 m。
354
+ ABS_RULES: List[Rule] = [
355
+ ("abs.ymd_dash", _r(r"(?<!\d)((?:19|20)\d\d)-(\d{1,2})-(\d{1,2})(?!\d)"),
356
+ lambda m: _point(int(m.group(1)), int(m.group(2)), int(m.group(3)))),
357
+ ("abs.ymd_zh", _r(r"((?:19|20)\d\d)\s*年\s*(\d{1,2})\s*月\s*(\d{1,2})\s*[日号]"),
358
+ lambda m: _point(int(m.group(1)), int(m.group(2)), int(m.group(3)))),
359
+ ("abs.dmy_en", _r(r"\b(\d{1,2})(?:st|nd|rd|th)? " + _MONP + r",? ((?:19|20)\d\d)\b"),
360
+ lambda m: _point(int(m.group(3)), MON[m.group(2).lower()], int(m.group(1)))),
361
+ ("abs.mdy_en", _r(r"\b" + _MONP + r" (\d{1,2})(?:st|nd|rd|th)?,? ((?:19|20)\d\d)\b"),
362
+ lambda m: _point(int(m.group(3)), MON[m.group(1).lower()], int(m.group(2)))),
363
+ ("abs.ym_dash", _r(r"(?<!\d)((?:19|20)\d\d)-(\d{1,2})(?![\d-])"),
364
+ lambda m: month_iv(int(m.group(1)), int(m.group(2))) if 1 <= int(m.group(2)) <= 12 else None),
365
+ ("abs.ym_zh", _r(r"((?:19|20)\d\d)\s*年\s*(\d{1,2})\s*月"),
366
+ lambda m: month_iv(int(m.group(1)), int(m.group(2))) if 1 <= int(m.group(2)) <= 12 else None),
367
+ ("abs.my_en", _r(r"\b" + _MONP + r",? ((?:19|20)\d\d)\b"),
368
+ lambda m: month_iv(int(m.group(2)), MON[m.group(1).lower()])),
369
+ ("abs.y_zh", _r(r"((?:19|20)\d\d)\s*年"), lambda m: year_iv(int(m.group(1)))),
370
+ ]
371
+
372
+ #: **污染声明**(见设计文档):lingshu 版开发时看过一次含 test 的失败样例后加的 6 族规则。
373
+ #: 只供基准报「去掉这 6 族」的下界用(`bench_timeanchor.py --minus-posthoc`),运行时不读。
374
+ POST_HOC_RULE_IDS = frozenset({"en.on_nth", "en.in_year", "en.for_n_units",
375
+ "en.month_last_year", "en.this_month", "en.this_year"})
376
+
377
+
378
+ # 生效条件:rules 为 (id, pattern, fn) 序列;对每条取 text 中首个命中并调 fn(m, *args),fn 抛 ValueError/KeyError/TypeError/OverflowError 或返回假值视为不可解析;返回命中位置最靠前(同位置取表序在前)者的 (区间, 规则 id, (start, end)),全无命中返回 None。
379
+ def _first(rules: Sequence[Rule], text: str, *args):
380
+ best = None
381
+ for rid, pat, f in rules:
382
+ m = pat.search(text)
383
+ if m is None:
384
+ continue
385
+ try:
386
+ iv = f(m, *args)
387
+ except (ValueError, KeyError, TypeError, OverflowError):
388
+ iv = None
389
+ if iv and (best is None or m.start() < best[2][0]):
390
+ best = (iv, rid, (m.start(), m.end()))
391
+ return best
392
+
393
+
394
+ # 生效条件:text 非空且 ref 为日期时,先认带年份的绝对日期(ABS_RULES),再认相对表达(RULES,以 ref 为参照);都没有返回 None。返回 (区间, 规则 id, 命中位置)。
395
+ def resolve_detail(text: str, ref: Optional[_dt.date], rules: Sequence[Rule] = None,
396
+ abs_rules: Sequence[Rule] = None):
397
+ if not text or ref is None:
398
+ return None
399
+ return (_first(ABS_RULES if abs_rules is None else abs_rules, text)
400
+ or _first(RULES if rules is None else rules, text, ref))
401
+
402
+
403
+ # 生效条件:同 resolve_detail,只返回区间 (d0, d1) 或 None。
404
+ def resolve(text: str, ref: Optional[_dt.date]) -> Optional[Interval]:
405
+ r = resolve_detail(text, ref)
406
+ return r[0] if r else None
407
+
408
+
409
+ # 生效条件:q 非空时先认绝对日期,再以 ref(缺省 = 当前时刻按 tz_hours() 折算的日期)为参照认相对表达;都没有返回 None。返回 (区间, 规则 id)。
410
+ def parse_query_detail(q: str, ref: Optional[_dt.date] = None):
411
+ if not q:
412
+ return None
413
+ hit = _first(ABS_RULES, q)
414
+ if hit is None:
415
+ if ref is None:
416
+ import time as _time
417
+ ref = ts_to_date(_time.time())
418
+ hit = _first(RULES, q, ref)
419
+ return (hit[0], hit[1]) if hit else None
420
+
421
+
422
+ # 生效条件:同 parse_query_detail,只返回区间或 None。
423
+ def parse_query(q: str, ref: Optional[_dt.date] = None) -> Optional[Interval]:
424
+ r = parse_query_detail(q, ref)
425
+ return r[0] if r else None
426
+
427
+
428
+ # 生效条件:content 为正文、observed_ts 为观测时刻(UNIX 秒)时;参照日不可得或规则全不命中返回 None(不写、不猜);否则返回派生字段 dict(start/end ISO 日期串、rule、span、ref、v),**不含正文片段**。
429
+ def derive(content: str, observed_ts, rules: Sequence[Rule] = None) -> Optional[dict]:
430
+ ref = ts_to_date(observed_ts)
431
+ if ref is None or not isinstance(content, str) or not content:
432
+ return None
433
+ hit = resolve_detail(content, ref, rules=rules)
434
+ if hit is None:
435
+ return None
436
+ (d0, d1), rid, (s, e) = hit
437
+ if d1 < d0:
438
+ return None
439
+ return {"start": d0.isoformat(), "end": d1.isoformat(), "rule": rid,
440
+ "span": [s, e], "ref": ref.isoformat(), "v": DERIVE_VERSION}
441
+
442
+
443
+ # 生效条件:fm 为写入前的 frontmatter(已含 created_at/sensitivity/temporal 等);开关关、fm 已有显式 temporal(非 None)、fm 已有 DERIVED_FIELD、或密级属 encrypted_levels(缺省 = crypto.ENCRYPTED_LEVELS)时**不动 fm** 返回 None;否则 derive 成功即写 fm[DERIVED_FIELD] 并返回该 dict,失败返回 None。
444
+ def apply_on_write(fm: dict, content: str, encrypted_levels=None) -> Optional[dict]:
445
+ """写入侧钩子(`MdCG.add` 调用):显式 temporal 永远优先,派生只补缺。"""
446
+ if not enabled() or not isinstance(fm, dict):
447
+ return None
448
+ if fm.get(EXPLICIT_FIELD) is not None or fm.get(DERIVED_FIELD) is not None:
449
+ return None
450
+ # 加密密级:正文在盘上是密文,派生区间却是明文 frontmatter —— 等于把正文里的日期
451
+ # 信息漏到明文面。宁可不派生(查询侧对它按观测当日处理)。
452
+ if encrypted_levels is None:
453
+ from .crypto import ENCRYPTED_LEVELS as encrypted_levels # 懒导入:密级真源
454
+ if fm.get("sensitivity") in set(encrypted_levels):
455
+ return None
456
+ d = derive(content, fm.get("created_at"))
457
+ if d is not None:
458
+ fm[DERIVED_FIELD] = d
459
+ return d
460
+
461
+
462
+ # 生效条件:s 为 ISO 日期串(YYYY-MM-DD)时返回 date,否则 None。
463
+ def _iso(s) -> Optional[_dt.date]:
464
+ try:
465
+ return _D.fromisoformat(str(s)[:10])
466
+ except (TypeError, ValueError):
467
+ return None
468
+
469
+
470
+ _EXPLICIT_DATE_RE = re.compile(r"^\s*(\d{4})[-/](\d{1,2})[-/](\d{1,2})(?![0-9])")
471
+
472
+
473
+ # 生效条件:t 为显式 temporal 原值。字符串以 YYYY-MM-DD(或 / 分隔)开头 → 直接取字面日期(墙上日历日,与主机时区无关);
474
+ # 数值/纯数字串 → 视为 UNIX 秒,经 parse_ts 归一后按 ts_to_date(MDCG_TIME_ANCHOR_TZ)折算,与 created_at 同口径;
475
+ # 其余或不可解析 → None。不把字符串日期经 trust.parse_time(time.mktime,主机本地时区)转成秒再按 UTC 渲染回来——那条往返在非 UTC 主机上会把日期整体偏一天。
476
+ def explicit_date(t, parse_ts=None) -> Optional[_dt.date]:
477
+ if t is None or isinstance(t, bool):
478
+ return None
479
+ if isinstance(t, str):
480
+ m = _EXPLICIT_DATE_RE.match(t)
481
+ if m:
482
+ try:
483
+ return _D(int(m.group(1)), int(m.group(2)), int(m.group(3)))
484
+ except ValueError:
485
+ return None
486
+ try:
487
+ float(t.strip())
488
+ except ValueError:
489
+ return None
490
+ if parse_ts is None:
491
+ return None
492
+ try:
493
+ ts = parse_ts(t)
494
+ except Exception: # noqa: BLE001
495
+ ts = None
496
+ return ts_to_date(ts)
497
+
498
+
499
+ #: node_interval 的来源等级(越小越具体;查询侧排序第一键)。
500
+ SRC_EXPLICIT, SRC_DERIVED, SRC_OBSERVED = 0, 1, 2
501
+
502
+
503
+ # 生效条件:fm 为节点 frontmatter(或含同名键的索引条目);parse_ts 为把显式 temporal 解析成 UNIX 秒的函数(传 trust.parse_time,免循环 import)。显式 temporal 可解析 → (当日, 当日, SRC_EXPLICIT);否则派生字段两端可解析且 start<=end → (start, end, SRC_DERIVED);否则 created_at 可折算 → (当日, 当日, SRC_OBSERVED);都不行返回 None。
504
+ def node_interval(fm, parse_ts=None):
505
+ if not isinstance(fm, dict):
506
+ return None
507
+ t = fm.get(EXPLICIT_FIELD)
508
+ d = explicit_date(t, parse_ts)
509
+ if d is not None:
510
+ return (d, d, SRC_EXPLICIT)
511
+ a = fm.get(DERIVED_FIELD)
512
+ if isinstance(a, dict):
513
+ d0, d1 = _iso(a.get("start")), _iso(a.get("end"))
514
+ if d0 is not None and d1 is not None and d0 <= d1:
515
+ return (d0, d1, SRC_DERIVED)
516
+ try:
517
+ ca = float(fm.get("created_at") or 0.0)
518
+ except (TypeError, ValueError):
519
+ ca = 0.0
520
+ d = ts_to_date(ca) if ca > 0 else None
521
+ if d is not None:
522
+ return (d, d, SRC_OBSERVED)
523
+ return None
524
+
525
+
526
+ # 生效条件:两个闭区间有公共日时返回 True。
527
+ def overlaps(a0: _dt.date, a1: _dt.date, b0: _dt.date, b1: _dt.date) -> bool:
528
+ return a0 <= b1 and b0 <= a1
529
+
530
+
531
+ # 生效条件:src 为 node_interval 的来源等级、width_days 为区间宽度(天,>=0)时返回 (0,1] 的确定性分数:来源越具体、区间越窄分越高(显式/派生 = 1/(1+w),观测当日推定再 ×0.5)。
532
+ def anchor_score(src: int, width_days: int) -> float:
533
+ base = 1.0 / (1.0 + max(0, int(width_days)))
534
+ return round(base * (0.5 if src == SRC_OBSERVED else 1.0), 6)
package/md_cg/tokens.py CHANGED
@@ -465,14 +465,72 @@ def parse_token(token: str):
465
465
  # 签发 / 校验 / 派生 / 吊销
466
466
  # --------------------------------------------------------------------------
467
467
 
468
- # 生效条件:role 经 normalize_role+role_spec(未知角色抛 TokenError),clearance 为假值时取 spec["clearance_cap"] 再经 _clamp_level 收窄到该 cap,layers_allow/ops_allow 经 _narrow 与 spec 默认求交,actor 为假值时取 role,delegable is None 时取 spec["delegable"]、否则按所传值取 bool,ttl 为真值时 expires_at=now+float(ttl)、为假值(None/0)时 None,随后在 _store_lock(path) 临界区内把记录写入 token_file(path)(N199:读-改-写无锁会被并发写者用陈旧快照整份覆盖)并返回含明文 token 的字典。
468
+ # 生效条件:无入参;恒返回是否显式放行首启自举的布尔值——环境变量 MDCG_ALLOW_ROOT_ISSUE 去空白转小写后属 {"1","true","yes","on"} 即真,其余(未设/空串/"0"/"false" 等)为假。
469
+ def _allow_root_issue_env() -> bool:
470
+ """`MDCG_ALLOW_ROOT_ISSUE` 是否显式打开(issue #543 的显式自举开关)。"""
471
+ return (os.environ.get("MDCG_ALLOW_ROOT_ISSUE", "") or "").strip().lower() \
472
+ in ("1", "true", "yes", "on")
473
+
474
+
475
+ # 生效条件:spec["can_admin"] 为假时直接返回(非管理级角色不受本闸约束);为真时——allow_bootstrap 显式为真、或环境开关打开、或 authorized_by 具 can_admin 时放行;否则读 _load(path) 的 tokens 映射,为空(空库首启)时放行自举;非空时抛 TokenError(含既定凭据数与两条放行方式指路)。
476
+ def _authorize_issue(role: str, spec: dict, *, path=None,
477
+ authorized_by=None, allow_bootstrap=None) -> None:
478
+ """签发**授权闸**(issue #543):管理级角色不得被「谁都能签」。
479
+
480
+ 判据顺序(任一满足即放行):
481
+ ① 非管理级角色(`can_admin` 为假)—— 本闸只管最高权;
482
+ ② `allow_bootstrap=True` 显式传入(供测试/初始化路径显式表态);
483
+ ③ `MDCG_ALLOW_ROOT_ISSUE` 环境开关打开(运维显式放行);
484
+ ④ `authorized_by` 是一个**既有管理级 Principal**(委派,推荐路径);
485
+ ⑤ **凭据库为空** —— 全新安装的首启自举,保留既有体验。
486
+
487
+ fail-closed:库**非空**且以上皆不满足 ⇒ 拒绝(不给「换个空目录就能自铸」留门)。
488
+ """
489
+ if not spec.get("can_admin"):
490
+ return
491
+ if allow_bootstrap is True:
492
+ return
493
+ if _allow_root_issue_env():
494
+ return
495
+ if authorized_by is not None and getattr(authorized_by, "can_admin", False):
496
+ return
497
+ existing = (_load(path).get("tokens") or {})
498
+ if not existing:
499
+ return # 空库首启自举(既有体验)
500
+ raise TokenError(
501
+ "拒绝签发管理级令牌(role=%s):凭据库非空(已有 %d 条),"
502
+ "而本次签发未出示既有管理级凭据。三条放行方式:"
503
+ "① 由既有 designer 令牌经 tokens derive --role %s 派生;"
504
+ "② 显式设 MDCG_ALLOW_ROOT_ISSUE=1(运维放行);"
505
+ "③ 全新安装(凭据库为空)时本闸自动放行。"
506
+ "(issue #543:签发此前无授权门,叠加 MDCG_AUX_ROOT 可换库 ⇒ 自铸最高权身份)"
507
+ % (role, len(existing), role))
508
+
509
+
510
+ # 生效条件:role 经 normalize_role+role_spec(未知角色抛 TokenError),clearance 为假值时取 spec["clearance_cap"] 再经 _clamp_level 收窄到该 cap,layers_allow/ops_allow 经 _narrow 与 spec 默认求交,actor 为假值时取 role,delegable is None 时取 spec["delegable"]、否则按所传值取 bool,ttl 为真值时 expires_at=now+float(ttl)、为假值(None/0)时 None;**先过 _authorize_issue() 授权闸**(issue #543:管理级角色在**凭据库非空**时须由既有管理级凭据委派或显式开关 MDCG_ALLOW_ROOT_ISSUE=1;空库首启允许自举),随后在 _store_lock(path) 临界区内把记录写入 token_file(path)(N199:读-改-写无锁会被并发写者用陈旧快照整份覆盖)并返回含明文 token 的字典。
469
511
  def issue(role: str, actor: str = None, clearance: str = None,
470
512
  tenant: str = "default", ttl: float = None, label: str = "",
471
513
  issued_by: str = "root", parent: str = None, delegable: bool = None,
472
- layers_allow=None, ops_allow=None, path: str = None):
473
- """签发一枚令牌。明文 token 只在返回值里出现一次,不落盘。"""
514
+ layers_allow=None, ops_allow=None, path: str = None,
515
+ _authorized_by=None, _allow_bootstrap=None):
516
+ """签发一枚令牌。明文 token 只在返回值里出现一次,不落盘。
517
+
518
+ issue #543(安全性):签发动作此前**没有任何授权门** —— 只要求目标目录可写,
519
+ 不校验调用者身份、也不看是否已有更高权凭据。叠加「凭据库位置由
520
+ `MDCG_AUX_ROOT` 决定」(datapath.aux_root),构成提权原语:
521
+ **换一个空目录 + 设一个环境变量 = 拿到 designer 全权身份**
522
+ (实测可写入 anchor/self 受保护层)。故补 `_authorize_issue()` 授权闸。
523
+
524
+ 兼容性(刻意保守,避免破坏文档化的首启流程):
525
+ · **空库首启允许自举**最高角色(全新安装的既有体验不变);
526
+ · **库非空**时要再签 `can_admin` 角色,必须能出示既有管理级凭据
527
+ (`_authorized_by` 传 Principal)、或显式设 `MDCG_ALLOW_ROOT_ISSUE=1`;
528
+ · 非管理级角色(recorder 等)**不受影响**。
529
+ """
474
530
  role = normalize_role(role)
475
531
  spec = role_spec(role)
532
+ _authorize_issue(role, spec, path=path, authorized_by=_authorized_by,
533
+ allow_bootstrap=_allow_bootstrap)
476
534
  clearance = _clamp_level(clearance or spec["clearance_cap"],
477
535
  spec["clearance_cap"])
478
536
  layers = _narrow(layers_allow, spec["layers_allow"])
@@ -652,7 +710,7 @@ def derive(parent_token: str, role: str, actor: str = None, ttl: float = None,
652
710
  "expires_at": rec["expires_at"]}
653
711
 
654
712
 
655
- # 生效条件:normalize_role(unit) 结果不在 POSITION_ROLES 时抛 TokenError;否则返回 Principal:unit/role=u、can_admin 恒 False、clearance=_clamp_level(spec["clearance_cap"], p.clearance)、can_write=bool(spec["can_write"]) and bool(p.can_write)、layers_allow/ops_allow=_narrow(spec 对应值, p 对应值),tenant/actor/session/harness/token_id/parent/expires_at/auth_mode/theory 等沿用 p。
713
+ # 生效条件:normalize_role(unit) 结果不在 POSITION_ROLES 时抛 TokenError;否则返回 Principal:unit/role=u、can_admin 恒 False、clearance=_clamp_level(spec["clearance_cap"], p.clearance)、can_write=bool(spec["can_write"]) and bool(p.can_write)、layers_allow/ops_allow=_narrow(spec 对应值, p 对应值),tenant/actor/session/harness/token_id/parent/expires_at/auth_mode/theory 等沿用 p,session_auto 来源标记同款传导(getattr(p, "session_auto", False))。
656
714
  def narrowed_principal(p: Principal, unit: str) -> Principal:
657
715
  """按「单元」收窄 principal 权限(**请求级**身份,只能变小不能变大)。
658
716
 
@@ -676,7 +734,7 @@ def narrowed_principal(p: Principal, unit: str) -> Principal:
676
734
  if u not in POSITION_ROLES:
677
735
  raise TokenError(f"未知单元:{unit!r}(可选 {list(POSITION_ROLES)})")
678
736
  spec = role_spec(u)
679
- return Principal(
737
+ q = Principal(
680
738
  tenant=p.tenant, actor=p.actor, session=p.session, harness=p.harness,
681
739
  unit=u, role=u,
682
740
  clearance=_clamp_level(spec["clearance_cap"], p.clearance),
@@ -687,6 +745,11 @@ def narrowed_principal(p: Principal, unit: str) -> Principal:
687
745
  token_id=p.token_id, parent=p.parent, expires_at=p.expires_at,
688
746
  auth_mode=p.auth_mode,
689
747
  theory_ok=p.theory_ok, theory_version=p.theory_version)
748
+ # 2026-10-07 三态:session 值被**复制**(非空)不等于「声明来源」——来源
749
+ # 标记必须原样传导,否则写归因三态收口(MdCGSecure._attributed_session)
750
+ # 会把 owner 的进程自动随机误判为声明值放行(身份收窄不改归因来源)。
751
+ q.session_auto = getattr(p, "session_auto", False)
752
+ return q
690
753
 
691
754
 
692
755
  # 生效条件:先以 _store_lock(path) 取令牌库跨进程写锁(超时抛 TokenError),再在临界区内执行 _revoke_locked(token_id, path) 并返回其结果。