@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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