@furongjun1999/dsh-memory 0.8.1 → 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 -659
  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 -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 +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_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  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
@@ -0,0 +1,458 @@
1
+ # -*- coding: utf-8 -*-
2
+ """盲区 → 目标生成器(W2 自主目标 · 第 2 小步实施)。
3
+
4
+ 功能名:goal_gen —— 盲区信号六源 → 目标候选(确定性模板 + 三区确认闸 + 留痕)。
5
+ 生效条件:**仅显式调用**(MCP `cg(op=goal, action=generate)` 或
6
+ `goal_gen.candidates(cg, ...)`);首版**不进 sleep/sustain 自动循环**
7
+ (设计者裁定第 8 条:阈值未标定前自动化 = 制造噪声)。
8
+ 外部定义的损失函数场景(训练/评测回路)不适用(N1)。
9
+ 子功能:① 六路**只读**信号源各出一组候选——
10
+ S1 unresolved 未解台账(`mdcg.add_unresolved` :2857)
11
+ S2 insight pending 待验证洞见(`insight.record` :164 / `list_events` :340)
12
+ S3 sustain 固化候补(`sustain.evolution_candidates` :510 → `_ccg_backlog` :484)
13
+ S4 BLINDSPOT 高频盲区(`metacognition.blindspots` :259)
14
+ S5 predict 空路由(`predict.routes` :625 → `routes_from_blindspot` :650)
15
+ S6 evolution 缺失维度(`evolution.patterns` :308)
16
+ ② 三区确认闸分档(裁定第 9 条白名单冻结)——维护类过 `autonomy_modes.decide(A_ADD)`
17
+ (:335)判 allow 才自动 `add_goal`;探索类一律入审核队列(`cg.propose` :2134);
18
+ 越权类(命中纲领 §七边界词面)**直接丢弃并记 boundary_refused**(不静默)。
19
+ ③ 每轮生成 append 一条留痕(形态照 `autonomy._explore.jsonl` :47/:256)。
20
+ 执行:`candidates(cg, sources=None, limit=N, apply=False)` —— 默认 dry_run(零落库);
21
+ `apply=True` 才落台账 / 入队 / 丢弃。goal_text 用确定性模板(不含时间戳/随机),
22
+ 复用 `add_goal` 的 sha1 幂等(`mdcg.py` :2939,同文本 → 同 id → 覆盖更新)。
23
+ 验证方式:`python -m md_cg.test_goal_gen`(含定点变异自证)。
24
+ 不适用条件:结构性不可知盲区不生成(`predictability == "unknowable"`,N2);
25
+ 退出权/自毁归 W3(N3,本模块不触碰)。
26
+
27
+ 边界(如实):本模块**只产文本候选**,不执行任何外部动作;落库一律经
28
+ `cg.add_goal`(公开 API,库层 `require_layer_write("goals", …)` 不可绕,`security.py` :217)
29
+ ——**禁止直调 `_write_node`**(红线三「价值观判定被绕过」)。
30
+ """
31
+ from __future__ import annotations
32
+
33
+ import hashlib
34
+ import json
35
+ import os
36
+ import time
37
+
38
+ from . import autonomy_modes, evolution, insight, metacognition, predict, sustain
39
+ from . import fsutil
40
+ from .fsutil import append_jsonl
41
+
42
+ __all__ = [
43
+ "GOAL_LOG", "DEFAULT_LIMIT",
44
+ "CLASS_MAINTAIN", "CLASS_EXPLORE", "CLASS_REFUSE",
45
+ "BOUNDARY_WORDS", "MAINTAIN_SOURCES",
46
+ "S1_TEMPLATE", "S2_PENDING_MIN", "S3_CCG_MIN", "S4_BLINDSPOT_MIN",
47
+ "S6_MISSING_MIN", "S4_SCAN", "S5_SCAN",
48
+ "candidates", "classify_candidate", "hits_boundary", "goal_log_path",
49
+ ]
50
+
51
+ #: 生成留痕日志名(形态照 `autonomy.EXPLORE_LOG` :61,append-only jsonl)
52
+ GOAL_LOG = "_goal_gen.jsonl"
53
+ #: 每轮候选上限(照 `blindspot_tickets.make_tickets` 的 `limit` :66)
54
+ DEFAULT_LIMIT = 10
55
+
56
+ # ---- 三区分类(裁定第 9 条「白名单冻结」) --------------------------------
57
+ CLASS_MAINTAIN = "维护类" # S3 / S6:结构自维护,过 decide(A_ADD) 可自动登记
58
+ CLASS_EXPLORE = "探索类" # S1 / S2 / S4 / S5 及涉新方向者:一律入审核队列
59
+ CLASS_REFUSE = "越权类" # 命中纲领 §七运行规则 5 边界词面:直接丢弃
60
+
61
+ #: 可自动登记的白名单源(**冻结**:只有结构自维护两源)
62
+ MAINTAIN_SOURCES = ("S3", "S6")
63
+
64
+ #: 纲领 §七运行规则 5「须停下待裁的边界」词面(命中即拒,不静默)
65
+ #: (`docs/plans/灵枢1.0_最小智能系统实存答卷_纲领_v0.1.md` **§七 运行规则第 5 条**)
66
+ #: ★2026-10-08 会话轮 100 更正:原注释写「L171」,实测**该行早已漂**——它指向台账「会话轮 25」行、
67
+ #: 并非运行规则 5;手写行号随文件增长漂移且**无管线重算、无守卫**(本仓既有教训:行号锚须由管线重算)。
68
+ #: 故改**内容锚**(§七 运行规则第 5 条)——判据:形态锚优于数字锚,数字锚只在不漂的场合用。
69
+ BOUNDARY_WORDS = ("对外发送", "对外发布", "npm publish", "智能论真源",
70
+ "资金", "账号")
71
+
72
+ # ---- 六源阈值(**首版保守缺省、观察期标定**,裁定第 10 条) -------------------
73
+ S1_TEMPLATE = "消解未解问题:%s"
74
+ S2_PENDING_MIN = 3 # 沿用 insight.outlook 既有建议阈值(:423 pending>=3)
75
+ S3_CCG_MIN = 5 # 单层无验证基底节点数阈值(保守)
76
+ S4_BLINDSPOT_MIN = 3 # 与 blindspot_tickets._JUDGE research 判据同源(:30)
77
+ S6_MISSING_MIN = 3 # 单一缺失维度计分阈值(保守)
78
+ S4_SCAN = 50 # 盲区地图扫描上限(候选筛选用,非落库)
79
+ S5_SCAN = 20 # S5 空路由探针扫描上限(避免每轮全库推演)
80
+
81
+ #: 优先级权重(确定性:priority = clamp(base + W_FREQ·频次 + W_IMPACT·影响面))
82
+ W_FREQ, W_IMPACT = 0.03, 0.01
83
+
84
+
85
+ # ---------------------------------------------------------------- 基础工具
86
+
87
+ # 生效条件:x 与常量 lo/hi 比较,返回钳制在 [lo, hi] 内的同型值(lo 缺省 0.0、hi 缺省 1.0)。
88
+ def _clamp(x, lo=0.0, hi=1.0):
89
+ return max(lo, min(hi, x))
90
+
91
+
92
+ # 生效条件:base 为数值、freq/impact 经 int() 转整数(失败回落 0),返回 clamp(base + W_FREQ·min(freq,10) + W_IMPACT·min(impact,20)) 并 round(·,4)——纯函数、无 IO、无时间戳,同输入恒同值;
93
+ def _prio(base, freq, impact_n):
94
+ """确定性优先级(base + 频次项 + 影响面项,钳制 [0,1])。"""
95
+ f = min(int(freq or 0), 10)
96
+ i = min(int(impact_n or 0), 20)
97
+ return round(_clamp(base + W_FREQ * f + W_IMPACT * i), 4)
98
+
99
+
100
+ # 生效条件:cg 有 root 属性时以其值为目录前缀,否则回落 '.',与模块常量 GOAL_LOG 拼接;纯字符串运算,不触碰盘面。
101
+ def goal_log_path(cg):
102
+ """生成留痕日志完整路径(形态照 `autonomy._explore_log_path` :73)。"""
103
+ return os.path.join(getattr(cg, "root", "."), GOAL_LOG)
104
+
105
+
106
+ # 生效条件:text 经 str() 与 lower() 归一后逐词匹配 BOUNDARY_WORDS(同样 lower 归一),命中返回该词原形,未命中返回 None;
107
+ def hits_boundary(text):
108
+ """命中纲领 §七边界词面则返回该词,否则 None。"""
109
+ t = str(text or "").lower()
110
+ for w in BOUNDARY_WORDS:
111
+ if w.lower() in t:
112
+ return w
113
+ return None
114
+
115
+
116
+ # 生效条件:cand 为 dict 时取 goal_text / conditions / evidence(json 串) 拼成一串返回,非 dict 返回空串;纯字符串运算。
117
+ def _cand_blob(cand):
118
+ ev = cand.get("evidence")
119
+ try:
120
+ ev_s = json.dumps(ev, ensure_ascii=False, sort_keys=True)
121
+ except (TypeError, ValueError):
122
+ ev_s = str(ev)
123
+ return " ".join([str(cand.get("goal_text") or ""),
124
+ str(cand.get("conditions") or ""), ev_s])
125
+
126
+
127
+ # 生效条件:候选命中边界词面 → CLASS_REFUSE;否则 source 属 MAINTAIN_SOURCES → CLASS_MAINTAIN;其余 → CLASS_EXPLORE;
128
+ def classify_candidate(cand):
129
+ """三区分类(越权类优先——命中边界词面即拒,不看来源)。"""
130
+ if hits_boundary(_cand_blob(cand)):
131
+ return CLASS_REFUSE
132
+ return (CLASS_MAINTAIN if cand.get("source") in MAINTAIN_SOURCES
133
+ else CLASS_EXPLORE)
134
+
135
+
136
+ # 生效条件:恒返回一条候选 dict,键集固定(source/evidence/impact/goal_text/priority/conditions/class),class 恒为 None(由 candidates() 统一分类);纯构造,无 IO。
137
+ def _cand(source, evidence, impact, goal_text, priority, conditions):
138
+ return {"source": source, "evidence": evidence, "impact": impact,
139
+ "goal_text": goal_text, "priority": float(priority),
140
+ "conditions": conditions, "class": None}
141
+
142
+
143
+ # 生效条件:content 按行切分,取以「# 问题:」开头行的去前缀值返回 question、以「# 目标:」开头行的去前缀值返回 goal_line;两行缺一或全缺时对应值为空串;
144
+ def _unresolved_fields(content):
145
+ """解析 unresolved 正文(模板见 `mdcg.add_unresolved._render` :2869)。"""
146
+ q, g = "", ""
147
+ for line in str(content or "").splitlines():
148
+ s = line.strip()
149
+ if s.startswith("# 问题:"):
150
+ q = s[len("# 问题:"):].strip()
151
+ elif s.startswith("# 目标:"):
152
+ g = s[len("# 目标:"):].strip()
153
+ return q, g
154
+
155
+
156
+ def _nodes(cg):
157
+ return (getattr(cg, "index", {}) or {}).get("nodes") or {}
158
+
159
+
160
+ # ---------------------------------------------------------------- 六源(只读)
161
+
162
+ # 生效条件:遍历索引中 layer=="unresolved" 的节点,读取其正文;「# 问题:」行非空且「# 目标:」行为空或「(未设定)」时产出一条候选,否则跳过;只读、无落库;
163
+ def _s1(cg):
164
+ """S1 · unresolved 未解问题台账 → 消解目标。"""
165
+ out = []
166
+ for nid, e in list(_nodes(cg).items()):
167
+ if (e or {}).get("layer") != "unresolved":
168
+ continue
169
+ node = cg.get(nid) or {}
170
+ question, goal_line = _unresolved_fields(node.get("content") or "")
171
+ if not question:
172
+ continue
173
+ if goal_line and goal_line not in ("(未设定)",):
174
+ continue # 已设定目标 → 不再生成(幂等语义)
175
+ out.append(_cand(
176
+ "S1", evidence={"node_id": nid, "question": question},
177
+ impact={"layer": "unresolved", "n": 1},
178
+ goal_text=S1_TEMPLATE % question,
179
+ priority=_prio(0.5, 1, 1),
180
+ conditions="库内存在该 unresolved 工单且未被裁决时"))
181
+ return out
182
+
183
+
184
+ # 生效条件:insight.list_events(state=pending) 取待验证洞见;计数 < S2_PENDING_MIN 时返回空列表(沿用既有建议阈值,不新造);否则逐条 pending 事件(正文取 frontmatter.insight_statement,空则跳过)各产出一条候选;
185
+ def _s2(cg):
186
+ """S2 · insight pending 待验证洞见 → 裁决目标。"""
187
+ try:
188
+ events = insight.list_events(cg, state=insight.STATE_PENDING)
189
+ except Exception: # noqa: BLE001
190
+ return []
191
+ if len(events) < S2_PENDING_MIN:
192
+ return []
193
+ out = []
194
+ for ev in events:
195
+ nid = ev.get("node_id")
196
+ node = cg.get(nid) or {}
197
+ stmt = str((node.get("frontmatter") or {})
198
+ .get("insight_statement") or "").strip()
199
+ if not stmt:
200
+ continue
201
+ out.append(_cand(
202
+ "S2", evidence={"node_id": nid, "pending": len(events)},
203
+ impact={"layer": "insight", "n": len(events)},
204
+ goal_text="裁决待验证洞见:%s" % stmt,
205
+ priority=_prio(0.5, len(events), len(events)),
206
+ conditions="该洞见仍处 pending 且无外部证据时"))
207
+ return out
208
+
209
+
210
+ # 生效条件:按层分组统计固化候补(谓词镜像 sustain._ccg_backlog :497-500:缺 verification_basis 或 has_neg_conditions),返回 {layer: {"n","no_basis","no_neg"}};只读索引、零写盘。
211
+ def _ccg_backlog_by_layer(cg):
212
+ out = {}
213
+ for _nid, e in list(_nodes(cg).items()):
214
+ e = e or {}
215
+ mb = not e.get("verification_basis")
216
+ mn = not e.get("has_neg_conditions")
217
+ if not (mb or mn):
218
+ continue
219
+ layer = str(e.get("layer") or "unknown")
220
+ d = out.setdefault(layer, {"n": 0, "no_basis": 0, "no_neg": 0})
221
+ d["n"] += 1
222
+ d["no_basis"] += 1 if mb else 0
223
+ d["no_neg"] += 1 if mn else 0
224
+ return out
225
+
226
+
227
+ # 生效条件:sustain.evolution_candidates(cg) 的 ccg_backlog.n 为 0 时返回空列表(无货不生成);否则按层产出候选——单层 no_basis >= S3_CCG_MIN 时产出一条;只读、零落库;
228
+ def _s3(cg):
229
+ """S3 · sustain 固化候补(**索引代理指标**,只作驱动信号)→ 清账目标。"""
230
+ try:
231
+ ev = sustain.evolution_candidates(cg)
232
+ except Exception: # noqa: BLE001
233
+ return []
234
+ cb = (ev or {}).get("ccg_backlog") or {}
235
+ if not cb.get("n"):
236
+ return []
237
+ out = []
238
+ for layer, d in sorted(_ccg_backlog_by_layer(cg).items()):
239
+ if d["no_basis"] < S3_CCG_MIN:
240
+ continue
241
+ out.append(_cand(
242
+ "S3", evidence={"layer": layer, "no_basis": d["no_basis"],
243
+ "no_neg": d["no_neg"], "n": d["n"]},
244
+ impact={"layer": layer, "n": d["n"]},
245
+ goal_text="固化候补清账:%s 层 %d 个无验证基底节点"
246
+ % (layer, d["no_basis"]),
247
+ priority=_prio(0.6, d["no_basis"], d["n"]),
248
+ conditions="库内该层固化候补 ≥ 阈值时"))
249
+ return out
250
+
251
+
252
+ # 生效条件:metacognition.blindspots(limit=S4_SCAN) 的 items 中 blindspot >= S4_BLINDSPOT_MIN 且 query 非空者各产出一条候选(goal_text 用 metacognition._key(query) 作稳定标识);只读;
253
+ def _s4(cg):
254
+ """S4 · BLINDSPOT 高频盲区 → 补条件目标。"""
255
+ try:
256
+ mp = metacognition.blindspots(cg, limit=S4_SCAN)
257
+ except Exception: # noqa: BLE001
258
+ return []
259
+ out = []
260
+ for it in mp.get("items") or []:
261
+ b = int(it.get("blindspot") or 0)
262
+ if b < S4_BLINDSPOT_MIN:
263
+ continue
264
+ q = str(it.get("query") or "").strip()
265
+ if not q:
266
+ continue
267
+ out.append(_cand(
268
+ "S4", evidence={"query": q, "blindspot": b,
269
+ "defer": int(it.get("defer") or 0)},
270
+ impact={"layer": "contextual", "n": b},
271
+ goal_text="补条件消解高频盲区:%s" % metacognition._key(q),
272
+ priority=_prio(0.5, b, b),
273
+ conditions="该盲区簇 BLINDSPOT/DEFER 计数未归零时"))
274
+ return out
275
+
276
+
277
+ # 生效条件:探针源 = unresolved 节点 id ∪ 盲区簇 key(与 predict.find_blindspot :454 同口径),去重后逐源调 predict.routes(blindspot_id=…):status 为 unpredictable/blindspot_not_found 的跳过(N2 结构性不可知不生成),routes 为空且 status 属 {no_anchor, ok} 的产出一条候选;扫描上限 S5_SCAN;只读、零落库;
278
+ def _s5(cg):
279
+ """S5 · predict 空路由 → 补锚点/边目标。"""
280
+ bids = []
281
+ for nid, e in list(_nodes(cg).items()):
282
+ if (e or {}).get("layer") == "unresolved":
283
+ bids.append(nid)
284
+ try:
285
+ mp = metacognition.blindspots(cg, limit=S4_SCAN)
286
+ except Exception: # noqa: BLE001
287
+ mp = {}
288
+ for it in mp.get("items") or []:
289
+ q = str(it.get("query") or "").strip()
290
+ if q:
291
+ bids.append(metacognition._key(q))
292
+ out, seen = [], set()
293
+ for bid in bids:
294
+ if bid in seen:
295
+ continue
296
+ seen.add(bid)
297
+ if len(seen) > S5_SCAN:
298
+ break
299
+ try:
300
+ res = predict.routes(cg, blindspot_id=bid)
301
+ except Exception: # noqa: BLE001
302
+ continue
303
+ st = res.get("status")
304
+ if st in ("unpredictable", "blindspot_not_found"):
305
+ continue # N2:结构性不可知 / 未定位,不生成
306
+ if res.get("routes"):
307
+ continue # 有路由 → 非空,不生成
308
+ if st not in ("no_anchor", "ok"):
309
+ continue
310
+ out.append(_cand(
311
+ "S5", evidence={"blindspot_id": bid, "status": st},
312
+ impact={"layer": "contextual", "n": 1},
313
+ goal_text="补锚点/边:%s 推演路由为空" % bid,
314
+ priority=_prio(0.45, 1, 1),
315
+ conditions="该方向可预测(非 unknowable)且路由仍为空时"))
316
+ return out
317
+
318
+
319
+ # 生效条件:evolution.patterns(cg) 的 by_missing 中计数 >= S6_MISSING_MIN 的维度各产出一条候选(按字段名排稳序);只读;
320
+ def _s6(cg):
321
+ """S6 · evolution 缺失维度 → 补条件维度目标。"""
322
+ try:
323
+ p = evolution.patterns(cg)
324
+ except Exception: # noqa: BLE001
325
+ return []
326
+ out = []
327
+ for field, cnt in sorted((p.get("by_missing") or {}).items()):
328
+ if int(cnt) < S6_MISSING_MIN:
329
+ continue
330
+ out.append(_cand(
331
+ "S6", evidence={"missing": field, "count": int(cnt)},
332
+ impact={"layer": "structural", "n": int(cnt)},
333
+ goal_text="补条件维度:%s" % field,
334
+ priority=_prio(0.55, int(cnt), int(cnt)),
335
+ conditions="该维度缺失计分位仍 ≥ 阈值时"))
336
+ return out
337
+
338
+
339
+ _SOURCES = {"S1": _s1, "S2": _s2, "S3": _s3, "S4": _s4, "S5": _s5, "S6": _s6}
340
+
341
+
342
+ # ---------------------------------------------------------------- 确认闸(分档落点)
343
+
344
+ # 生效条件:cand["goal_text"] 非空时以其 utf-8 sha1 前 10 位构造 "goal_<hex>"(与 mdcg.add_goal 的 gid 同口径 :2939);空文本回落 "goal_" + 空 sha1 片段;
345
+ def _goal_id(goal_text):
346
+ return "goal_%s" % hashlib.sha1(
347
+ str(goal_text or "").encode("utf-8")).hexdigest()[:10]
348
+
349
+
350
+ # 生效条件:恒返回候选的 CCG 六要素正文(目标按 CCG 格式落盘,保证 judge_qualification 给 ACCEPT 而非 BLINDSPOT,与 mdcg._goal_content :2915 同构);纯字符串拼接;
351
+ def _proposal_content(cand):
352
+ return ("# 功能名:%s\n"
353
+ "# 生效条件:%s\n"
354
+ "# 子功能:自主目标候选(来源 %s)——为检索提供方向偏置(goal 路)\n"
355
+ "# 执行:经 cg(op=goal, action=generate) 生成;入审核队列待裁决\n"
356
+ "# 验证方式:other\n"
357
+ "# 不适用条件:目标状态为 done/dropped 时不再参与定向\n"
358
+ % (cand.get("goal_text") or "",
359
+ cand.get("conditions") or "(未声明——视为任意情境下有效)",
360
+ cand.get("source") or "?"))
361
+
362
+
363
+ # 生效条件:cg 具 propose 时以确定性 gid 为 node_id、CCG 正文为 content、layer="goals" 入既有审核队列(kind 缺省 = proposal,靠 tags 标识来源);返回 pid;
364
+ def _enqueue(cg, cand):
365
+ return cg.propose(
366
+ _goal_id(cand["goal_text"]), _proposal_content(cand),
367
+ layer="goals", tags=["goal-gen", "goal-gen:%s" % cand["source"]])
368
+
369
+
370
+ # 生效条件:按 cand["class"] 分档——越权类返回 boundary_refused(记命中词,不落库);维护类先调 autonomy_modes.decide(A_ADD) 判 allow(auto add_goal)/confirm(入队)/forbid(fail-closed 拒);探索类一律入审核队列;只写经公开 API(add_goal / propose),绝不直调 _write_node;
371
+ def _apply_candidate(cg, cand, actor=None):
372
+ """确认闸分档落点(自主 ≠ 自裁)。"""
373
+ cls = cand.get("class")
374
+ if cls == CLASS_REFUSE:
375
+ return {"moved_to": "boundary_refused",
376
+ "boundary_word": hits_boundary(_cand_blob(cand)) or "",
377
+ "decision": "refused"}
378
+ if cls == CLASS_MAINTAIN:
379
+ dec = autonomy_modes.decide(autonomy_modes.A_ADD)
380
+ d = dec.get("decision")
381
+ if d == autonomy_modes.ALLOW:
382
+ kw = {"actor": actor} if actor else {}
383
+ gid = cg.add_goal(cand["goal_text"], priority=cand["priority"],
384
+ conditions=cand["conditions"],
385
+ tags=["goal-gen", "goal-gen:%s" % cand["source"]],
386
+ **kw)
387
+ return {"moved_to": "goals", "id": gid, "decision": d,
388
+ "mode": dec.get("mode")}
389
+ if d == autonomy_modes.CONFIRM: # confirm 档:出变更单(入审核队列)
390
+ return {"moved_to": "review_queue", "pid": _enqueue(cg, cand),
391
+ "decision": d, "mode": dec.get("mode")}
392
+ return {"moved_to": "forbidden", "decision": d,
393
+ "mode": dec.get("mode"), "hint": dec.get("hint")}
394
+ # 探索类:一律入审核队列(不入 goals 层)
395
+ return {"moved_to": "review_queue", "pid": _enqueue(cg, cand),
396
+ "decision": "confirm"}
397
+
398
+
399
+ # 生效条件:cg 与 rec 传入时经 fsutil.append_jsonl 追加一条生成留痕;仅 OSError 被忽略(留痕失败不阻断主流程,与 autonomy.explore :316-319 同款);
400
+ def _log(cg, rec):
401
+ try:
402
+ # #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
403
+ # 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
404
+ # (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
405
+ _ok = append_jsonl(goal_log_path(cg), rec)
406
+ except OSError:
407
+ pass
408
+
409
+
410
+ # ---------------------------------------------------------------- 入口
411
+
412
+ # 生效条件:cg 具 index/get/add_goal/propose 时——按 sources(缺省六源全开,非法项忽略)收集候选、统一分类、按 (-priority, goal_text) 稳序并截断到 limit;apply=False(默认)全部标 moved_to="dry_run"(零落库);apply=True 经 _apply_candidate 分档落库/入队/丢弃;末尾 append 一条生成留痕;返回含 by_class/created/queued/refused 计数的结果体;
413
+ def candidates(cg, sources=None, limit=DEFAULT_LIMIT, apply=False, actor=None):
414
+ """盲区 → 目标候选(默认 dry_run;apply=True 才落台账/入队/丢弃)。"""
415
+ want = [str(s).strip().upper() for s in sources] if sources else list(_SOURCES)
416
+ raw = []
417
+ for sid in want:
418
+ fn = _SOURCES.get(sid)
419
+ if fn is None:
420
+ continue
421
+ raw.extend(fn(cg))
422
+ for c in raw:
423
+ c["class"] = classify_candidate(c)
424
+ # 稳序:优先级降序,同优先级按 goal_text 升序(**确定性**,不含时间/随机)
425
+ raw.sort(key=lambda c: (-c["priority"], c["goal_text"]))
426
+ raw = raw[:int(limit)]
427
+
428
+ out, by_class = [], {}
429
+ created = queued = refused = forbidden = 0
430
+ for c in raw:
431
+ by_class[c["class"]] = by_class.get(c["class"], 0) + 1
432
+ if apply:
433
+ res = _apply_candidate(cg, c, actor=actor)
434
+ else:
435
+ res = {"moved_to": "dry_run", "decision": "dry_run"}
436
+ mv = res.get("moved_to")
437
+ created += 1 if mv == "goals" else 0
438
+ queued += 1 if mv == "review_queue" else 0
439
+ refused += 1 if mv == "boundary_refused" else 0
440
+ forbidden += 1 if mv == "forbidden" else 0
441
+ item = dict(c)
442
+ item.update(res)
443
+ out.append(item)
444
+
445
+ rec = {"type": "goal_gen", "t": time.time(), "apply": bool(apply),
446
+ "actor": actor, "sources": want, "n_candidates": len(out),
447
+ "by_class": by_class, "created": created, "queued": queued,
448
+ "refused": refused, "forbidden": forbidden,
449
+ "candidates": [{"source": c["source"], "goal_text": c["goal_text"],
450
+ "priority": c["priority"], "class": c["class"],
451
+ "moved_to": c.get("moved_to")} for c in out]}
452
+ _log(cg, rec)
453
+
454
+ return {"ok": True, "action": "generate", "op": "goal",
455
+ "applied": bool(apply), "n_candidates": len(out),
456
+ "by_class": by_class, "created": created, "queued": queued,
457
+ "refused": refused, "forbidden": forbidden,
458
+ "candidates": out}
package/md_cg/hotcache.py CHANGED
@@ -34,6 +34,7 @@ from __future__ import annotations
34
34
 
35
35
  import os
36
36
  import time
37
+ import math
37
38
  from collections import OrderedDict
38
39
 
39
40
  #: 节点缓存上限(env MDCG_HOTCACHE_MAX_NODES 可覆盖——公共评测池 locomo-zh-500
@@ -54,7 +55,16 @@ _KEYED_EXTRA = ("include_work", "roles", "paths", "path_weights", "recall_only",
54
55
  # 环境变量(MDCG_SEMANTIC/MDCG_EN_ATOMS/MDCG_UNIFY_QUERY…),它们
55
56
  # 同样改变候选资格与打分。v14 只补了参数面,故另立一键
56
57
  # (2026-09-24 修复:同 query 下切开关会命中另一口径的缓存 → 静默错答)。
57
- "env_switch")
58
+ "env_switch", "bm25_access",
59
+ # #153(2026-10-12 DSH 端):**索引代际**。写路径每次索引突变推进
60
+ # 代际(MdCGOS._on_index_mutation)⇒ 键随代际变化 ⇒ 旧代命中自然
61
+ # 失配,无需全清(全清会毁命中率,与 #154 性能面冲突)。
62
+ # 登记纪律同 env_switch:新增一个就登记一个——不登记等于让下一个人
63
+ # 看不出它承重(键用整份 extra,故漏登只影响可读性、不影响正确性)。
64
+ "index_gen",
65
+ # 相对时间锚定:问句解析出的区间(仅开关开且问句含日期时入键;相对写法
66
+ # 「上周二」随当天变化,不入键会跨日命中旧区间的结果)。
67
+ "time_anchor")
58
68
  #: 不可稳定规范化的参数(自定义可调用):非默认即**绕行缓存**(fail-closed)。
59
69
  _BYPASS_EXTRA = ("query_expand",)
60
70
  #: 影响检索结果的进程级开关(新增一个就登记一个——同 _KEYED_EXTRA 的纪律)。
@@ -65,7 +75,17 @@ _BYPASS_EXTRA = ("query_expand",)
65
75
  #: 直接改变融合结果,同属「漏登即跨口径串味」的一类。
66
76
  _ENV_SWITCHES = ("MDCG_SEMANTIC", "MDCG_EN_ATOMS", "MDCG_UNIFY_QUERY",
67
77
  "MDCG_RETRIEVAL_PIPELINE", "MDCG_S7_FRESHNESS",
68
- "MDCG_CN_GRAMS", "MDCG_CHAIN_TYPES", "MDCG_TEMPORAL_GAMMA")
78
+ "MDCG_CN_GRAMS", "MDCG_CHAIN_TYPES", "MDCG_TEMPORAL_GAMMA",
79
+ "MDCG_RRF_CANDIDATES",
80
+ # issue #197(2026-10-13):名次可信度的**性质判据**开关。
81
+ # 开启后在既有名单门之上追加 whole_tie(任意路)与
82
+ # floor_mass(有下限声明的路)两条弃权分支 ⇒ 直接改变融合
83
+ # 结果,同属「漏登即跨口径串味」的一类。
84
+ "MDCG_RANK_CREDIBILITY",
85
+ # 相对时间锚定(2026-10-14):开关开 ⇒ 写入侧派生 temporal_anchor、查询侧
86
+ # 点名日期时追加 time_anchor 路并把区间交集者前置;TZ 改「哪一天」的折算
87
+ # ⇒ 两者都改变融合结果,同属「漏登即跨口径串味」的一类。
88
+ "MDCG_TIME_ANCHOR", "MDCG_TIME_ANCHOR_TZ")
69
89
 
70
90
 
71
91
  # 生效条件:无必需形参;返回 _ENV_SWITCHES 中每个变量名的 (名, 当前取值或 None) 元组(稳定、可哈希,随 query 缓存键一起参与比对)。
@@ -74,6 +94,36 @@ def env_switch_key():
74
94
  return tuple((name, os.environ.get(name)) for name in _ENV_SWITCHES)
75
95
 
76
96
 
97
+ def validity_window(entries, started):
98
+ """Clock interval on which a cold query's whole candidate pool is stable.
99
+
100
+ Include every candidate, not just returned Top-K: expiry of a nonwinner
101
+ can change BM25 corpus statistics and therefore the winning rank. Start
102
+ endpoints also invalidate cached qualification metadata; an inverted
103
+ future-start/past-end window changes from not_yet to expired at its start.
104
+ Uncertain/nonfinite endpoints bypass caching. Construction is O(N) only
105
+ on a miss; a hit checks two scalar clock bounds in O(1).
106
+ """
107
+ from . import trust
108
+ deadline = None
109
+ for entry in entries:
110
+ kind, start, end = trust.validity(entry, now=started)
111
+ if kind == "expired":
112
+ return None # The clock moved while candidates were being read.
113
+ for boundary in (start, end):
114
+ if boundary is None:
115
+ continue
116
+ if not math.isfinite(boundary):
117
+ return None
118
+ if boundary >= started:
119
+ deadline = boundary if deadline is None else min(deadline, boundary)
120
+ return started, deadline
121
+
122
+
123
+ def _within_window(now, window):
124
+ return now >= window[0] and (window[1] is None or now < window[1])
125
+
126
+
77
127
  class HotCache:
78
128
  """进程内热路径缓存。
79
129
 
@@ -86,6 +136,7 @@ class HotCache:
86
136
  query_ttl=QUERY_TTL):
87
137
  self._nodes: OrderedDict = OrderedDict()
88
138
  self._queries: OrderedDict = OrderedDict()
139
+ self._query_windows = {}
89
140
  self._max_nodes = max_nodes
90
141
  self._max_queries = max_queries
91
142
  self._query_ttl = query_ttl
@@ -129,8 +180,22 @@ class HotCache:
129
180
  if isinstance(v, (set, frozenset)):
130
181
  return tuple(sorted((HotCache._canon(x) for x in v), key=repr))
131
182
  if isinstance(v, dict):
132
- return tuple(sorted((str(k), HotCache._canon(x))
133
- for k, x in v.items()))
183
+ # #153(2026-10-12 DSH 端):键片段用**三元组**("k", 类型名, str(键))。
184
+ # 修前是 (str(键), 值) 二元组,两个缺陷:
185
+ # ① 撞键:`{1: 'x'}` 与 `{'1': 'x'}` 的 canon **逐位相同**
186
+ # (int 1 与 str '1' 都 str 成 "1")⇒ 语义不同的入参命中同一
187
+ # 缓存键,静默串结果;
188
+ # ② 抛异常:`sorted(...)` 对 (str, 值) 二元组排序,键相同则比到
189
+ # **值**——`_canon({1: None, '1': (1, 2)})` 比 None 与 tuple
190
+ # ⇒ `TypeError: '<' not supported between instances of
191
+ # 'tuple' and 'NoneType'`,异常从 `search_rrf` 逃出(检索
192
+ # 入口整体 500)。context 是模型可控入参,形态不可信。
193
+ # 故:片段里带 `type(k).__name__` 消撞键;排序键**只取片段**
194
+ # (`key=lambda kv: kv[0]`,全是 str 元组 ⇒ 恒可比,不触值)。
195
+ return tuple(sorted(
196
+ ((("k", type(k).__name__, str(k)), HotCache._canon(x))
197
+ for k, x in v.items()),
198
+ key=lambda kv: kv[0]))
134
199
  # 其余(含自定义对象/可调用):repr 含内存地址 → 每次不同 →
135
200
  # 缓存永不命中(等价绕行),是**安全侧**失败(不串味)。
136
201
  return ("repr", repr(v))
@@ -155,29 +220,61 @@ class HotCache:
155
220
  self._stats["query_misses"] += 1
156
221
  return None
157
222
  ts, results, meta = entry
158
- if time.time() - ts > self._query_ttl:
223
+ now = time.time()
224
+ window = self._query_windows.get(key)
225
+ if (now - ts > self._query_ttl
226
+ or (window is not None and not _within_window(now, window))):
159
227
  self._queries.pop(key, None)
228
+ self._query_windows.pop(key, None)
160
229
  self._stats["query_misses"] += 1
161
230
  return None
162
231
  self._stats["query_hits"] += 1
163
232
  self._queries.move_to_end(key)
164
- return results, dict(meta)
233
+ # #153①(2026-10-12 DSH 端):**出口一律深一层浅拷贝**——修前只
234
+ # `dict(meta)` 拷贝了 meta,`results` 是**缓存内部 list 的引用**:
235
+ # 调用方(检索后处理 / 排序 / 截断 / 上层 append)对返回值的任何原地
236
+ # 修改都会**写回缓存**,下一次命中就拿到被污染的「结果」——别名污染
237
+ # 是静默错答(不是性能问题)。行内元素 dict 同样按引用共享(`bm25`
238
+ # 的 rows 是 `(node_dict, score)`),故逐行浅拷贝、行内 dict 再拷贝。
239
+ return [HotCache._copy_row(r) for r in results], dict(meta)
240
+
241
+ @staticmethod
242
+ def _copy_row(row):
243
+ """query 结果行的**浅拷贝**(#153①):list/tuple 保持原容器类型,
244
+ 容器内的 dict 元素另拷一份,其余标量原样。"""
245
+ if isinstance(row, dict):
246
+ return dict(row)
247
+ if isinstance(row, (list, tuple)):
248
+ items = [dict(x) if isinstance(x, dict) else x for x in row]
249
+ return tuple(items) if isinstance(row, tuple) else items
250
+ return row
165
251
 
166
252
  def put_query(self, query, results, meta, k=20, layer=None,
167
253
  session=None, branch=None, validity=None, view=None,
168
- extra=None):
254
+ extra=None, clock_window=None):
169
255
  """写入/更新 query 缓存。"""
170
256
  key = self._query_key(query, k, layer, session, branch, validity,
171
257
  view, extra)
172
- self._queries[key] = (time.time(), list(results), dict(meta))
258
+ now = time.time()
259
+ if clock_window is not None and not _within_window(now, clock_window):
260
+ self._queries.pop(key, None)
261
+ self._query_windows.pop(key, None)
262
+ return
263
+ self._queries[key] = (now, list(results), dict(meta))
264
+ if clock_window is None:
265
+ self._query_windows.pop(key, None)
266
+ else:
267
+ self._query_windows[key] = clock_window
173
268
  self._queries.move_to_end(key)
174
269
  while len(self._queries) > self._max_queries:
175
- self._queries.popitem(last=False)
270
+ evicted, _entry = self._queries.popitem(last=False)
271
+ self._query_windows.pop(evicted, None)
176
272
 
177
273
  def invalidate_all_queries(self):
178
274
  """清空全部 query 缓存(写入时保守全清)。"""
179
275
  n = len(self._queries)
180
276
  self._queries.clear()
277
+ self._query_windows.clear()
181
278
  if n:
182
279
  self._stats["invalidations"] += 1
183
280
 
@@ -192,6 +289,7 @@ class HotCache:
192
289
  """清空全部缓存。"""
193
290
  self._nodes.clear()
194
291
  self._queries.clear()
292
+ self._query_windows.clear()
195
293
 
196
294
  def stats(self):
197
295
  """返回统计信息。"""