@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,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
  """返回统计信息。"""