@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
package/md_cg/insight.py CHANGED
@@ -1,522 +1,541 @@
1
- # -*- coding: utf-8 -*-
2
- """洞察条件层(P2 · insight):洞见事件四件套。
3
-
4
- 对齐 `docs/mdcg/tool_table_v0.3.0.md`(insight_record / insight_verify /
5
- insight_report / insight_window)与 `docs/mdcg/灵枢82工具_功能整理与迁移映射_v0.1.md`
6
- §五 P2 缺口。
7
-
8
- 四件套
9
- ------
10
- - ``record`` 记录一条洞见事件 + C1–C8 条件快照(state=pending)
11
- - ``verify`` 用 V1/V2/V3 外部证据裁决 → verified / falsified;verified 重要度保底 0.9
12
- - ``report`` CER 条件有效洞见率 + 2×SE 显著性 + 层状态 reliable/watch/degraded
13
- - ``window`` 开窗条件:C1 ≥ 0.6 ∧ 跨域 ∧ 低压力
14
-
15
- 诚实边界(写进返回值,不靠调用方自觉)
16
- --------------------------------------
17
- - 本层只做**结构性记账与统计**,不产生洞见正文——正文必须由调用方给出,
18
- 缺失即报错,绝不臆造;
19
- - 窗口开 ≠ 洞见有效:``window`` 只回答「条件是否具备」,有效性一律交由
20
- ``verify`` 的外部证据说话;
21
- - 样本不足时 ``report`` 显式返回 ``insufficient`` 并**不给结论**(宁可不说)。
22
-
23
- 零第三方依赖。
24
- """
25
- from __future__ import annotations
26
-
27
- import hashlib
28
- import math
29
- import os
30
- import time
31
-
32
- from . import protect
33
- from .fsutil import append_jsonl
34
-
35
- INSIGHT_LOG = "_insight.jsonl"
36
- INSIGHT_LAYER = "contextual" # 条件层:低阶情境记录,不承担事实断言
37
- TAG_EVENT = "insight_event"
38
- TAG_VERIFIED = "insight_verified"
39
- TAG_FALSIFIED = "insight_falsified"
40
-
41
- STATE_PENDING = "pending"
42
- STATE_VERIFIED = "verified"
43
- STATE_FALSIFIED = "falsified"
44
-
45
- C1_WINDOW_MIN = 0.6 # C1 可检索度开窗门槛
46
- V1_MIN_EVIDENCE = 3 # V1(可检索/被引用)需 ≥3 条才成立
47
- IMPORTANCE_FLOOR = 0.9 # verified 后的重要度保底(对齐工具表)
48
- CER_MIN_SAMPLES = 20 # 样本 < 20 不判定层状态
49
-
50
- PRESSURES = ("low", "medium", "high")
51
- TONES = ("neutral", "curious", "defensive", "urgent")
52
-
53
- # C1–C8 条件快照字段(顺序即编号,便于审计对读)
54
- CONDITION_KEYS = ("retrievability", "outside_observer", "cross_domain",
55
- "premise_questioned", "pressure", "continuity_turns",
56
- "externalized", "tone")
57
- V_TYPES = ("v1", "v2", "v3")
58
- V_LABELS = {"v1": "可检索/被引用", "v2": "实践重复", "v3": "外部确证"}
59
-
60
-
61
- # ---------------------------------------------------------------- 基础
62
-
63
- # 生效条件:cg 可提供 root 时返回 os.path.join(cg.root, INSIGHT_LOG)。
64
- def log_path(cg):
65
- return os.path.join(cg.root, INSIGHT_LOG)
66
-
67
-
68
- # 生效条件:向 log_path(cg) 追加 JSONL 的调用若抛任何异常都会被 except Exception 吞掉,无论成败最终都返回 rec。
69
- def _append(cg, rec):
70
- """留痕(best-effort):审计不该反过来打断主流程。"""
71
- try:
72
- append_jsonl(log_path(cg), rec)
73
- except Exception: # noqa: BLE001
74
- pass
75
- return rec
76
-
77
-
78
- # 生效条件:getattr(cg,"index",None) 或其 "nodes" 为 None/假值时返回空列表,否则返回 nodes 中 (e or {}).get("tags") or [] 含 TAG_EVENT 的节点 id 列表。
79
- def _events(cg):
80
- """全部洞见事件节点 id(按 index 层标签粗筛,避免全量读盘)。"""
81
- nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
82
- return [nid for nid, e in list(nodes.items())
83
- if TAG_EVENT in ((e or {}).get("tags") or [])]
84
-
85
-
86
- # 生效条件:cg 具备 get,node_id 经 str(node_id or "").strip() 后非空(0/空串等假值回落空串即返回 None)、cg.get(nid) 返回真值节点、且该节点 frontmatter 的 tags(缺键或假值时按 [] 计)包含 TAG_EVENT 时返回该节点,否则返回 None。
87
- def _read_event(cg, node_id):
88
- """读洞见事件节点;非事件节点(标签不符)返回 None。"""
89
- nid = str(node_id or "").strip()
90
- if not nid:
91
- return None
92
- try:
93
- node = cg.get(nid)
94
- except Exception: # noqa: BLE001
95
- return None
96
- if not node:
97
- return None
98
- fm = node.get("frontmatter") or {}
99
- if TAG_EVENT not in (fm.get("tags") or []):
100
- return None
101
- return node
102
-
103
-
104
- # ---------------------------------------------------------------- 条件快照
105
-
106
- # 生效条件:conditions 为 None/假值时按空 dict 处理且 missing 登记 CONDITION_KEYS 中不在其中的键;retrievability 由 raw.get("retrievability",0.0) or 0.0 转 float(失败落 0.0)并截断到 [0,1],pressure/tone 不在 PRESSURES/TONES 白名单(含空串回落 "medium"/"neutral")时落 "medium"/"neutral",cross_domain 为字符串时包成单元素列表再排序去重,continuity_turns 经 int(raw.get(...) or 0)(失败落 0)取 max(0,·)。
107
- def normalize(conditions=None):
108
- """C1–C8 归一化;**缺失项显式登记**而不是静默补默认值。"""
109
- raw = dict(conditions or {})
110
- missing = [k for k in CONDITION_KEYS if k not in raw]
111
- out = {}
112
- try:
113
- c1 = float(raw.get("retrievability", 0.0) or 0.0)
114
- except (TypeError, ValueError):
115
- c1 = 0.0
116
- out["retrievability"] = min(1.0, max(0.0, c1))
117
- out["outside_observer"] = bool(raw.get("outside_observer", False))
118
- cd = raw.get("cross_domain") or []
119
- if isinstance(cd, str):
120
- cd = [cd]
121
- out["cross_domain"] = sorted({str(x) for x in cd})
122
- out["premise_questioned"] = bool(raw.get("premise_questioned", False))
123
- pr = str(raw.get("pressure") or "medium").strip().lower()
124
- out["pressure"] = pr if pr in PRESSURES else "medium"
125
- try:
126
- out["continuity_turns"] = max(0, int(raw.get("continuity_turns") or 0))
127
- except (TypeError, ValueError):
128
- out["continuity_turns"] = 0
129
- out["externalized"] = bool(raw.get("externalized", False))
130
- tn = str(raw.get("tone") or "neutral").strip().lower()
131
- out["tone"] = tn if tn in TONES else "neutral"
132
- return {"conditions": out, "missing": missing}
133
-
134
-
135
- # 生效条件:conditions 经 normalize 后,retrievability ≥ C1_WINDOW_MIN、cross_domain 非空、pressure == "low" 三者同时成立时 open 为 True 且 blocked_by 为空,否则 blocked_by 列出未通过的闸门键名。
136
- def window(conditions=None):
137
- """开窗判定:C1 ≥ 0.6 ∧ 跨域(≥1 个域)∧ 低压力。
138
-
139
- 返回逐闸门结果与阻塞项,便于调用方知道「差在哪」,而不是只拿到一个 bool。
140
- """
141
- n = normalize(conditions)
142
- c = n["conditions"]
143
- gates = {
144
- "c1_retrievable": c["retrievability"] >= C1_WINDOW_MIN,
145
- "cross_domain": bool(c["cross_domain"]),
146
- "low_pressure": c["pressure"] == "low",
147
- }
148
- blocked = [k for k, ok in gates.items() if not ok]
149
- return {"open": not blocked, "gates": gates, "blocked_by": blocked,
150
- "c1": c["retrievability"], "c1_min": C1_WINDOW_MIN,
151
- "conditions": c, "missing": n["missing"],
152
- "note": "开窗仅表示「条件具备」;是否有效一律由 verify 的外部证据裁决"}
153
-
154
-
155
- # 生效条件:任意 statement(假值按 "" 计)与 ts(None/0 等假值时回落 time.time())下恒返回 "ins_%d_%s",其中时间数字为 int(ts or time.time())、哈希为 str(statement or "").encode("utf-8") 的 sha1 前 8 位。
156
- def event_id(statement, ts=None):
157
- return "ins_%d_%s" % (int(ts or time.time()),
158
- hashlib.sha1(str(statement or "").encode("utf-8")).hexdigest()[:8])
159
-
160
-
161
- # ---------------------------------------------------------------- record
162
-
163
- # 生效条件:cg 具备 add/_append,statement 经 str(statement or "").strip() 为空时抛 ValueError;非空时以 str(node_id or event_id(statement)).strip() 为 nid(node_id 假值时回落到 event_id(statement)),_read_event 命中已有事件则返回 duplicate=True/existed_before=True 且 state 取该节点 frontmatter 的 insight_state,未命中则以 STATE_PENDING 写入新节点并返回 duplicate=False/existed_before=False,返回中的 window 来自 window(conditions)。
164
- def record(cg, statement=None, conditions=None, category="", source="",
165
- tags=None, importance=0.5, node_id=None, actor=None, **extra):
166
- """记录一条洞见事件(pending)+ C1–C8 条件快照。
167
-
168
- ``statement`` 必填:洞见正文由调用方给出,本层不臆造;缺正文直接报错。
169
- 幂等:同一正文派生同一 id,重复调用不重复写盘。
170
- """
171
- statement = str(statement or "").strip()
172
- if not statement:
173
- raise ValueError("insight record 需要 statement:洞见正文由调用方给出,本层不臆造")
174
- w = window(conditions)
175
- nid = str(node_id or event_id(statement)).strip()
176
- existing = _read_event(cg, nid)
177
- if existing:
178
- fm = existing.get("frontmatter") or {}
179
- _append(cg, {"action": "record", "node_id": nid, "duplicate": True,
180
- "actor": actor, "ts": time.time()})
181
- return {"ok": True, "action": "record", "node_id": nid,
182
- "state": fm.get("insight_state"), "window": w,
183
- "existed_before": True, "duplicate": True,
184
- "note": "同正文事件已存在,未重复写入(幂等)"}
185
- tg = [TAG_EVENT] + [str(t) for t in (tags or [])]
186
- if category:
187
- tg.append("insight_cat:%s" % category)
188
- body = statement if statement.endswith("\n") else statement + "\n"
189
- fm_extra = {
190
- "insight_state": STATE_PENDING,
191
- "insight_category": category,
192
- "insight_source": source,
193
- "insight_conditions": w["conditions"],
194
- "insight_missing": w["missing"],
195
- "insight_window_open": bool(w["open"]),
196
- "insight_statement": statement,
197
- "insight_evidence": [],
198
- "insight_history": [],
199
- }
200
- fm_extra.update(extra)
201
- cg.add(nid, body, layer=INSIGHT_LAYER, tags=tg,
202
- importance=float(importance), actor=actor, **fm_extra)
203
- _append(cg, {"action": "record", "node_id": nid, "category": category,
204
- "source": source, "window_open": w["open"],
205
- "blocked_by": w["blocked_by"], "missing": w["missing"],
206
- "actor": actor, "ts": time.time()})
207
- return {"ok": True, "action": "record", "node_id": nid, "state": STATE_PENDING,
208
- "window": w, "existed_before": False, "duplicate": False,
209
- "note": "已记录为 pending;有效性待 verify 的外部证据裁决"}
210
-
211
-
212
- # ---------------------------------------------------------------- verify
213
-
214
- # 生效条件:evidence 为 str/dict 时先包成单元素列表、为 None 或假值时按 [] 遍历;每个 dict 项 type 经 str(...).strip().lower() 属 V_TYPES 才保留否则回落 "v1",ref 取 item.get("ref") 或 item.get("source") 或 ""、note 取 item.get("note") 或 "",非 dict 项一律记为 {"type":"v1","ref":str(item),"note":""};v_types 中仅 strip().lower() 后属 V_TYPES 的项追加空 ref/note 条目,最终返回 out。
215
- def _normalize_evidence(evidence=None, v_types=None):
216
- """证据归一化:接受 ``["ref", ...]`` / ``[{"type","ref","note"}]`` / ``v_types``。"""
217
- ev = evidence
218
- if isinstance(ev, (str, dict)):
219
- ev = [ev]
220
- out = []
221
- for item in (ev or []):
222
- if isinstance(item, dict):
223
- t = str(item.get("type") or "").strip().lower()
224
- out.append({"type": t if t in V_TYPES else "v1",
225
- "ref": str(item.get("ref") or item.get("source") or ""),
226
- "note": str(item.get("note") or "")})
227
- else:
228
- out.append({"type": "v1", "ref": str(item), "note": ""})
229
- for t in (v_types or []):
230
- t = str(t).strip().lower()
231
- if t in V_TYPES:
232
- out.append({"type": t, "ref": "", "note": ""})
233
- return out
234
-
235
-
236
- # 生效条件:_read_event(cg,node_id) 取不到事件节点、或 verdict 经 str(verdict or "").strip().lower() 后非空且不是 verified/falsified 时抛 ValueError;verdict 为 None 或空白时按 v3 → v2 → v1 条数 ≥ V1_MIN_EVIDENCE 的顺序定 verified,有证据但不达门槛或无证据则保持 STATE_PENDING 并附 reason;显式 verdict 直接采信,verified 分支重要度保底 IMPORTANCE_FLOOR 并置保护位,falsified 分支打 TAG_FALSIFIED;裁决分支落盘前经 protect.guard_overwrite(层闸 + 保护闸),写盘后同步内存索引条目并**标脏**(cg._dirty[node_id]=ent,推进读缓存代际与索引增量日志)。
237
- def verify(cg, node_id=None, evidence=None, v_types=None, verdict=None,
238
- actor=None, note=""):
239
- """用 V1/V2/V3 外部证据裁决洞见事件。
240
-
241
- 判定规则(先声明后判定,避免「有证据就算过」):
242
- · 显式 ``verdict``(verified/falsified)→ 直接采信(证伪只能由此路径产生);
243
- · V3 外部确证 或 V2 实践重复 → verified;
244
- · V1 可检索/被引用 需 **≥ V1_MIN_EVIDENCE 条** 才成立;
245
- · 其余(无证据 / V1 不足)→ **保持 pending 并给出原因**,不判定。
246
- verified 后:重要度保底 0.9(``IMPORTANCE_FLOOR``)并置保护位。
247
- 裁决分支落盘前过 ``protect.guard_overwrite``(层闸 + 保护闸),写盘后同步
248
- 内存索引条目并**标脏**(``cg._dirty[node_id]``,C-1)——否则读缓存默认开时
249
- 同进程「verify 后读」拿旧 insight_state/tags/importance。
250
- """
251
- node = _read_event(cg, node_id)
252
- if not node:
253
- raise ValueError("不是有效的洞见事件节点:%r" % (node_id,))
254
- fm = dict(node.get("frontmatter") or {})
255
- ev = _normalize_evidence(evidence, v_types)
256
- kinds = {e["type"] for e in ev}
257
- explicit = str(verdict or "").strip().lower() or None
258
- if explicit is not None and explicit not in (STATE_VERIFIED, STATE_FALSIFIED):
259
- raise ValueError("verdict 只能是 verified / falsified / None:%r" % (verdict,))
260
-
261
- final, reason = explicit, ""
262
- if final is None:
263
- if "v3" in kinds:
264
- final, reason = STATE_VERIFIED, "V3 外部确证"
265
- elif "v2" in kinds:
266
- final, reason = STATE_VERIFIED, "V2 实践重复"
267
- elif sum(1 for e in ev if e["type"] == "v1") >= V1_MIN_EVIDENCE:
268
- final, reason = STATE_VERIFIED, "V1 可检索/被引用 ≥ %d 条" % V1_MIN_EVIDENCE
269
- elif ev:
270
- reason = ("仅 V1 证据且不足 %d 条:不判定,保持 pending"
271
- % V1_MIN_EVIDENCE)
272
- else:
273
- reason = "无外部证据:不判定,保持 pending(窗口开不等于有效)"
274
- if final is None:
275
- _append(cg, {"action": "verify", "node_id": node_id, "state": STATE_PENDING,
276
- "decided": False, "reason": reason, "evidence": ev,
277
- "actor": actor, "ts": time.time()})
278
- return {"ok": True, "action": "verify", "node_id": node_id,
279
- "state": STATE_PENDING, "decided": False, "reason": reason,
280
- "evidence": ev, "importance": fm.get("importance"),
281
- "note": "未达判定门槛,保持 pending"}
282
-
283
- hist = list(fm.get("insight_history") or [])
284
- hist.append({"ts": time.time(), "from": fm.get("insight_state"),
285
- "to": final, "reason": reason or "显式裁决",
286
- "actor": actor, "note": note})
287
- fm["insight_state"] = final
288
- fm["insight_evidence"] = list(fm.get("insight_evidence") or []) + ev
289
- fm["insight_history"] = hist
290
- fm["insight_reason"] = reason or "显式裁决"
291
- tg = [t for t in (fm.get("tags") or []) if t not in (TAG_VERIFIED, TAG_FALSIFIED)]
292
- if final == STATE_VERIFIED:
293
- tg.append(TAG_VERIFIED)
294
- fm["importance"] = max(float(fm.get("importance") or 0.0), IMPORTANCE_FLOOR)
295
- fm["protected"] = True
296
- fm["protection_reason"] = "insight_verified"
297
- fm["verification_basis"] = "data"
298
- else:
299
- tg.append(TAG_FALSIFIED)
300
- fm["tags"] = tg
301
- # N197(2026-09-28):本面是**既有节点的覆写**——原先直调 `cg._write_node`,
302
- # 既无 `principal.require_layer_write` 亦无 `protect.guard_write`,与同一身份
303
- # 对同层 `add` 的待遇相反(add 被 AccessDenied,这里照样落盘):越层腿
304
- # (sustain layers=('self',) verify 他人的 contextual 事件)+ 保护腿
305
- # (self/anchor/immutable 节点被无痕覆写、无快照无审计)都由这一处补闸收口。
306
- # 层与敏感度取**本节点已读到的 frontmatter 真值**(不靠索引缺字段时的回落)。
307
- protect.guard_overwrite(cg, node_id, layer=fm.get("layer"),
308
- sensitivity=fm.get("sensitivity"), actor=actor)
309
- cg._write_node(node_id, os.path.join(cg.root, node["path"]), fm,
310
- node.get("content") or "")
311
- ent = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(node_id)
312
- if isinstance(ent, dict):
313
- ent["importance"] = fm.get("importance")
314
- ent["tags"] = list(tg)
315
- ent["insight_state"] = final
316
- # 标脏(N133 修复,对照先例 md_cg/mdcg.py 的 update_tags / verify 直写
317
- # 分支 `self._dirty[node_id] = e`):只改内存 entry 时读缓存(默认开)
318
- # 的 path_gen 不推进 ⇒ `_fresh` 继续判旧 fm 新鲜,同进程「verify 后读」
319
- # 拿到旧 insight_state/tags/importance;标脏同时让本写进
320
- # `_dirty → flush → _index_log` 重放。**不下沉进 `_write_node`**(该口
321
- # 另有「只对账索引不落盘」的调用方,下沉会凭空产生写入代际与自重载)。
322
- _dirty = getattr(cg, "_dirty", None)
323
- if isinstance(_dirty, dict):
324
- _dirty[node_id] = ent
325
- _append(cg, {"action": "verify", "node_id": node_id, "state": final,
326
- "decided": True, "reason": reason or "显式裁决",
327
- "evidence": ev, "importance": fm.get("importance"),
328
- "actor": actor, "ts": time.time()})
329
- return {"ok": True, "action": "verify", "node_id": node_id, "state": final,
330
- "decided": True, "reason": reason or "显式裁决", "evidence": ev,
331
- "evidence_count": len(fm["insight_evidence"]),
332
- "importance": fm.get("importance"),
333
- "protected": bool(fm.get("protected")),
334
- "note": "verified 后重要度保底 %s 并置保护位" % IMPORTANCE_FLOOR}
335
-
336
-
337
- # ---------------------------------------------------------------- list / report
338
-
339
- # 生效条件:state 为真值时只保留 insight_state 与之相等的项(state 为 None/空串等假值则不过滤),limit 为 0 等假值时返回按 created_at 排序后的全部列表,limit 为真值时返回 out[-int(limit):]——limit 为负时该切片等价于 out[|limit|:],即去掉排序后前 |limit| 条而非取前 |limit| 条。
340
- def list_events(cg, state=None, limit=0):
341
- out = []
342
- for nid in _events(cg):
343
- node = _read_event(cg, nid)
344
- if not node:
345
- continue
346
- fm = node.get("frontmatter") or {}
347
- st = fm.get("insight_state")
348
- if state and st != state:
349
- continue
350
- out.append({"node_id": nid, "state": st,
351
- "category": fm.get("insight_category"),
352
- "importance": fm.get("importance"),
353
- "window_open": bool(fm.get("insight_window_open")),
354
- "created_at": fm.get("created_at"),
355
- "evidence_count": len(fm.get("insight_evidence") or []),
356
- "reason": fm.get("insight_reason")})
357
- out.sort(key=lambda x: x.get("created_at") or 0)
358
- return out[-int(limit):] if limit else out
359
-
360
-
361
- # 生效条件:now 为 None/0 等假值时取 time.time(),window_days 为真值时按 now - window_days*86400 过滤 created_at;已裁决数 verified+falsified < CER_MIN_SAMPLES 时直接返回 cer/se/two_se/significant 为 None、layer_state="insufficient" 的结果,否则按 p=verified/denom 算出 se 与 significant,significant 为假时 p<0.3 取 degraded、否则 watch,significant 为真时 p≥0.5 取 reliable、否则 watch。
362
- def report(cg, window_days=None, now=None):
363
- """CER 条件有效洞见率报告(样本不足不判定)。
364
-
365
- CER = verified /(verified + falsified);显著性带宽 = 2×SE,
366
- SE = sqrt(p(1-p)/n)。层状态:reliable / watch / degraded / insufficient。
367
- """
368
- now = float(now or time.time())
369
- events = list_events(cg)
370
- if window_days:
371
- lo = now - float(window_days) * 86400.0
372
- events = [e for e in events if (e.get("created_at") or 0) >= lo]
373
- n = len(events)
374
- verified = sum(1 for e in events if e["state"] == STATE_VERIFIED)
375
- falsified = sum(1 for e in events if e["state"] == STATE_FALSIFIED)
376
- pending = sum(1 for e in events if e["state"] == STATE_PENDING)
377
- open_windows = sum(1 for e in events if e["window_open"])
378
- denom = verified + falsified
379
- out = {"ok": True, "action": "report", "op": "insight",
380
- "window_days": window_days, "recorded": n,
381
- "verified": verified, "falsified": falsified, "pending": pending,
382
- "decided": denom, "window_open_count": open_windows,
383
- "window_open_rate": (round(open_windows / n, 4) if n else None),
384
- "sample_min": CER_MIN_SAMPLES, "cer": None, "se": None, "two_se": None,
385
- "significant": None, "layer_state": "insufficient", "note": ""}
386
- if denom < CER_MIN_SAMPLES:
387
- out["note"] = ("样本不足(已裁决 %d < %d):按纪律不判定层状态,"
388
- "避免小样本过拟合" % (denom, CER_MIN_SAMPLES))
389
- return out
390
- p = verified / denom
391
- se = math.sqrt(max(0.0, p * (1.0 - p)) / denom)
392
- out.update({"cer": round(p, 4), "se": round(se, 4),
393
- "two_se": round(2 * se, 4), "significant": bool(p > 2 * se)})
394
- if not out["significant"]:
395
- out["layer_state"] = "degraded" if p < 0.3 else "watch"
396
- else:
397
- out["layer_state"] = "reliable" if p >= 0.5 else "watch"
398
- out["note"] = ("CER = 已验证 /(已验证 + 已证伪);2×SE 为显著性带宽;"
399
- "reliable/watch/degraded 只描述条件层有效性趋势,不构成结论")
400
- return out
401
-
402
-
403
- # ---------------------------------------------------------------- outlook
404
-
405
- # 生效条件:entry 为假值或 (entry or {}).get("layer") 为假值时返回 "unknown",否则返回该 layer 值的 str 形式。
406
- def _layer_of(entry):
407
- return str((entry or {}).get("layer") or "unknown")
408
-
409
-
410
- # 生效条件:values 为空/假值时返回 min/p50/p90/max 全为 None 的字典,否则对 sorted(values) 取 0.0/0.5/0.9/1.0 位置的值并各自 round(·,4)。
411
- def _quartiles(values):
412
- if not values:
413
- return {"min": None, "p50": None, "p90": None, "max": None}
414
- vs = sorted(values)
415
- # 生效条件:给定 f 与闭包列表 vs,取下标 i = min(len(vs)-1, max(0, int(round(f*(len(vs)-1)))))(f 越界被夹到两端)并返回 round(vs[i], 4);vs 为空时 min 得到 -1 的取值行为源码未做校验。
416
- def _q(f):
417
- i = min(len(vs) - 1, max(0, int(round(f * (len(vs) - 1)))))
418
- return round(vs[i], 4)
419
- return {"min": _q(0.0), "p50": _q(0.5), "p90": _q(0.9), "max": _q(1.0)}
420
-
421
-
422
- # 生效条件:cg.index(取不到或假值时 nodes 为空、total=0 使 protected_rate 与 growth 回落 None)与 now(假值时回落 time.time())决定 d1,float(recent_days) 参与 lo_recent 计算,window_days 透传 report 得 d2;suggestions 依序在 basis["unset"] 非零、hi_imp_unprotected 非空、no_neg 非零、pending>=3、layers["unresolved"] 非零、contextual>max(3, knowledge)、rep["layer_state"]=="insufficient" 时各自追加一条,high_importance_unprotected 取排序后前 sample_limit 项(sample_limit=0 时为空列表)。
423
- def outlook(cg, window_days=None, sample_limit=8, recent_days=7, now=None):
424
- """结构洞察:D1 结构判断 + D2 盲区与趋势建议(只读)。
425
-
426
- D1 —— 关于**自身记忆结构**的判断:分层分布、重要度分位、保护率、验证基底
427
- 分布、条件缺口(缺不适用条件)比例、近期增长。
428
- D2 —— 盲区与趋势建议:洞见层 CER 报告、未裁决堆积、unresolved/无锚点盲区、
429
- 以及**可执行的下一步建议**(带证据与建议调用)。
430
-
431
- 诚实边界:本函数只做**结构描述与差距定位**,不判有效性、不替调用方下结论;
432
- 样本不足或指标缺失时返回 None / 显式缺口,而不是编一个数。
433
- """
434
- now = float(now or time.time())
435
- nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
436
- total = len(nodes)
437
- layers, basis = {}, {}
438
- imps, protected, no_neg, recent = [], 0, 0, 0
439
- lo_recent = now - float(recent_days) * 86400.0
440
- hi_imp_unprotected = []
441
- for nid, e in list(nodes.items()):
442
- e = e or {}
443
- layers[_layer_of(e)] = layers.get(_layer_of(e), 0) + 1
444
- b = str(e.get("verification_basis") or "unset")
445
- basis[b] = basis.get(b, 0) + 1
446
- try:
447
- iv = float(e.get("importance") or 0.0)
448
- except (TypeError, ValueError):
449
- iv = 0.0
450
- imps.append(iv)
451
- if e.get("protected"):
452
- protected += 1
453
- elif iv >= IMPORTANCE_FLOOR:
454
- hi_imp_unprotected.append(nid)
455
- if not e.get("has_neg_conditions"):
456
- no_neg += 1
457
- ca = e.get("created_at")
458
- if ca and float(ca) >= lo_recent:
459
- recent += 1
460
-
461
- events = list_events(cg)
462
- pending = sum(1 for x in events if x["state"] == STATE_PENDING)
463
- rep = report(cg, window_days=window_days, now=now)
464
-
465
- d1 = {
466
- "total": total,
467
- "layers": dict(sorted(layers.items(), key=lambda kv: (-kv[1], kv[0]))),
468
- "importance": _quartiles(imps),
469
- "protected": protected,
470
- "protected_rate": (round(protected / total, 4) if total else None),
471
- "verification_basis": dict(sorted(basis.items(), key=lambda kv: (-kv[1], kv[0]))),
472
- "missing_non_applicable": no_neg,
473
- "missing_non_applicable_rate": (round(no_neg / total, 4) if total else None),
474
- "recent_%dd" % int(recent_days): recent,
475
- "growth_%dd" % int(recent_days): (round(recent / total, 4) if total else None),
476
- }
477
- d2 = {
478
- "insight": {"recorded": rep["recorded"], "pending": rep["pending"],
479
- "verified": rep["verified"], "falsified": rep["falsified"],
480
- "cer": rep["cer"], "two_se": rep["two_se"],
481
- "layer_state": rep["layer_state"], "sample_min": rep["sample_min"]},
482
- "unresolved_nodes": layers.get("unresolved", 0),
483
- "high_importance_unprotected": sorted(hi_imp_unprotected)[:sample_limit],
484
- }
485
-
486
- suggestions = []
487
- if basis.get("unset", 0):
488
- suggestions.append({"priority": "P0", "action": "补验证基底",
489
- "evidence": "%d 个节点 verification_basis 缺失" % basis["unset"],
490
- "call": 'cg(op="maintain", action="importance", apply=true)'})
491
- if hi_imp_unprotected:
492
- suggestions.append({"priority": "P0", "action": "给高重要度节点补保护/裁决",
493
- "evidence": "%d 个高重要度节点未保护" % len(hi_imp_unprotected),
494
- "call": 'cg(op="insight", action="verify", node_id=..., evidence=[...])'})
495
- if no_neg:
496
- suggestions.append({"priority": "P1", "action": "补不适用条件(提升可判定性)",
497
- "evidence": "%d 个节点缺不适用条件" % no_neg,
498
- "call": 'cg(op="maintain", action="importance", apply=true)'})
499
- if pending >= 3:
500
- suggestions.append({"priority": "P1", "action": "给堆积的洞见补外部证据",
501
- "evidence": "%d 条 pending 洞见未裁决" % pending,
502
- "call": 'cg(op="insight", action="list", state="pending")'})
503
- if layers.get("unresolved"):
504
- suggestions.append({"priority": "P1", "action": "把未决查询转入盲区学习闭环",
505
- "evidence": "%d 条 unresolved" % layers["unresolved"],
506
- "call": 'cg(op="insight", action="learn", apply=true)'})
507
- if layers.get("contextual", 0) > max(3, layers.get("knowledge", 0)):
508
- suggestions.append({"priority": "P2", "action": "归纳情境记忆为概念层",
509
- "evidence": "contextual %d > knowledge %d"
510
- % (layers.get("contextual", 0),
511
- layers.get("knowledge", 0)),
512
- "call": 'cg(op="consolidate", action="induce", apply=true)'})
513
- if rep["layer_state"] == "insufficient":
514
- suggestions.append({"priority": "P2", "action": "积累洞见样本后再判层状态",
515
- "evidence": "已裁决 %d < %d" % (rep["decided"], rep["sample_min"]),
516
- "call": 'cg(op="insight", action="report")'})
517
-
518
- return {"ok": True, "action": "outlook", "op": "insight",
519
- "d1": d1, "d2": d2, "suggestions": suggestions,
520
- "generated_at": now,
521
- "note": ("结构描述与差距定位,不判有效性;suggestions 按优先级给出,"
1
+ # -*- coding: utf-8 -*-
2
+ """洞察条件层(P2 · insight):洞见事件四件套。
3
+
4
+ 对齐 `docs/mdcg/tool_table_v0.3.0.md`(insight_record / insight_verify /
5
+ insight_report / insight_window)与 `docs/mdcg/灵枢82工具_功能整理与迁移映射_v0.1.md`
6
+ §五 P2 缺口。
7
+
8
+ 四件套
9
+ ------
10
+ - ``record`` 记录一条洞见事件 + C1–C8 条件快照(state=pending)
11
+ - ``verify`` 用 V1/V2/V3 外部证据裁决 → verified / falsified;verified 重要度保底 0.9
12
+ - ``report`` CER 条件有效洞见率 + 2×SE 显著性 + 层状态 reliable/watch/degraded
13
+ - ``window`` 开窗条件:C1 ≥ 0.6 ∧ 跨域 ∧ 低压力
14
+
15
+ 诚实边界(写进返回值,不靠调用方自觉)
16
+ --------------------------------------
17
+ - 本层只做**结构性记账与统计**,不产生洞见正文——正文必须由调用方给出,
18
+ 缺失即报错,绝不臆造;
19
+ - 窗口开 ≠ 洞见有效:``window`` 只回答「条件是否具备」,有效性一律交由
20
+ ``verify`` 的外部证据说话;
21
+ - 样本不足时 ``report`` 显式返回 ``insufficient`` 并**不给结论**(宁可不说)。
22
+
23
+ 零第三方依赖。
24
+ """
25
+ from __future__ import annotations
26
+
27
+ import hashlib
28
+ import math
29
+ import os
30
+ import time
31
+
32
+ from . import protect
33
+ from . import fsutil
34
+ from .fsutil import append_jsonl
35
+
36
+ INSIGHT_LOG = "_insight.jsonl"
37
+ INSIGHT_LAYER = "contextual" # 条件层:低阶情境记录,不承担事实断言
38
+ TAG_EVENT = "insight_event"
39
+ TAG_VERIFIED = "insight_verified"
40
+ TAG_FALSIFIED = "insight_falsified"
41
+
42
+ STATE_PENDING = "pending"
43
+ STATE_VERIFIED = "verified"
44
+ STATE_FALSIFIED = "falsified"
45
+
46
+ C1_WINDOW_MIN = 0.6 # C1 可检索度开窗门槛
47
+ V1_MIN_EVIDENCE = 3 # V1(可检索/被引用)需 ≥3 条才成立
48
+ #: verified 后的重要度**保底**(对齐工具表)。
49
+ #: ★ 与「高重要度」保护门槛是**两个语义**:后者是全仓单点 `protect.AUTO_PROTECT_IMPORTANCE`=0.70。
50
+ #: 共用过一个常量名 `IMPORTANCE_FLOOR`(#433:改一个会改两个)⇒ 本批拆名归位。
51
+ VERIFY_IMPORTANCE_FLOOR = 0.9
52
+ CER_MIN_SAMPLES = 20 # 样本 < 20 不判定层状态
53
+
54
+ PRESSURES = ("low", "medium", "high")
55
+ TONES = ("neutral", "curious", "defensive", "urgent")
56
+
57
+ # C1–C8 条件快照字段(顺序即编号,便于审计对读)
58
+ CONDITION_KEYS = ("retrievability", "outside_observer", "cross_domain",
59
+ "premise_questioned", "pressure", "continuity_turns",
60
+ "externalized", "tone")
61
+ V_TYPES = ("v1", "v2", "v3")
62
+ V_LABELS = {"v1": "可检索/被引用", "v2": "实践重复", "v3": "外部确证"}
63
+
64
+
65
+ # ---------------------------------------------------------------- 基础
66
+
67
+ # 生效条件:cg 可提供 root 时返回 os.path.join(cg.root, INSIGHT_LOG)。
68
+ def log_path(cg):
69
+ return os.path.join(cg.root, INSIGHT_LOG)
70
+
71
+
72
+ # 生效条件:向 log_path(cg) 追加 JSONL 的调用若抛任何异常都会被 except Exception 吞掉,无论成败最终都返回 rec。
73
+ def _append(cg, rec):
74
+ """留痕(best-effort):审计不该反过来打断主流程。"""
75
+ # issue #443:调用方可控字段可无限长 ⇒ 单条记录先过总字节闸;超限跳过写入
76
+ # 并记失败(不抛——本函数是 best-effort 审计路径,抛错会被下面 except 吞掉)。
77
+ if not fsutil.bounded_record(rec):
78
+ fsutil._note_append_failure(log_path(cg), ValueError("record_too_large: issue #443"))
79
+ return rec
80
+ try:
81
+ fsutil.append_jsonl_ledger(log_path(cg), rec)
82
+ except Exception: # noqa: BLE001
83
+ pass
84
+ return rec
85
+
86
+
87
+ # 生效条件:getattr(cg,"index",None) 或其 "nodes" 为 None/假值时返回空列表,否则返回 nodes 中 (e or {}).get("tags") or [] 含 TAG_EVENT 的节点 id 列表。
88
+ def _events(cg):
89
+ """全部洞见事件节点 id(按 index 层标签粗筛,避免全量读盘)。"""
90
+ nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
91
+ return [nid for nid, e in list(nodes.items())
92
+ if TAG_EVENT in ((e or {}).get("tags") or [])]
93
+
94
+
95
+ # 生效条件:cg 具备 get,node_id 经 str(node_id or "").strip() 后非空(0/空串等假值回落空串即返回 None)、cg.get(nid) 返回真值节点、且该节点 frontmatter 的 tags(缺键或假值时按 [] 计)包含 TAG_EVENT 时返回该节点,否则返回 None。
96
+ def _read_event(cg, node_id):
97
+ """读洞见事件节点;非事件节点(标签不符)返回 None。"""
98
+ nid = str(node_id or "").strip()
99
+ if not nid:
100
+ return None
101
+ try:
102
+ node = cg.get(nid)
103
+ except Exception: # noqa: BLE001
104
+ return None
105
+ if not node:
106
+ return None
107
+ fm = node.get("frontmatter") or {}
108
+ if TAG_EVENT not in (fm.get("tags") or []):
109
+ return None
110
+ return node
111
+
112
+
113
+ # ---------------------------------------------------------------- 条件快照
114
+
115
+ # 生效条件:conditions 为 None/假值时按空 dict 处理且 missing 登记 CONDITION_KEYS 中不在其中的键;retrievability 由 raw.get("retrievability",0.0) or 0.0 转 float(失败落 0.0)并截断到 [0,1],pressure/tone 不在 PRESSURES/TONES 白名单(含空串回落 "medium"/"neutral")时落 "medium"/"neutral",cross_domain 为字符串时包成单元素列表再排序去重,continuity_turns 经 int(raw.get(...) or 0)(失败落 0)取 max(0,·)。
116
+ def normalize(conditions=None):
117
+ """C1–C8 归一化;**缺失项显式登记**而不是静默补默认值。"""
118
+ raw = dict(conditions or {})
119
+ missing = [k for k in CONDITION_KEYS if k not in raw]
120
+ out = {}
121
+ try:
122
+ c1 = float(raw.get("retrievability", 0.0) or 0.0)
123
+ except (TypeError, ValueError):
124
+ c1 = 0.0
125
+ out["retrievability"] = min(1.0, max(0.0, c1))
126
+ out["outside_observer"] = bool(raw.get("outside_observer", False))
127
+ cd = raw.get("cross_domain") or []
128
+ if isinstance(cd, str):
129
+ cd = [cd]
130
+ out["cross_domain"] = sorted({str(x) for x in cd})
131
+ out["premise_questioned"] = bool(raw.get("premise_questioned", False))
132
+ pr = str(raw.get("pressure") or "medium").strip().lower()
133
+ out["pressure"] = pr if pr in PRESSURES else "medium"
134
+ try:
135
+ out["continuity_turns"] = max(0, int(raw.get("continuity_turns") or 0))
136
+ except (TypeError, ValueError):
137
+ out["continuity_turns"] = 0
138
+ out["externalized"] = bool(raw.get("externalized", False))
139
+ tn = str(raw.get("tone") or "neutral").strip().lower()
140
+ out["tone"] = tn if tn in TONES else "neutral"
141
+ return {"conditions": out, "missing": missing}
142
+
143
+
144
+ # 生效条件:conditions 经 normalize 后,retrievability ≥ C1_WINDOW_MIN、cross_domain 非空、pressure == "low" 三者同时成立时 open 为 True 且 blocked_by 为空,否则 blocked_by 列出未通过的闸门键名。
145
+ def window(conditions=None):
146
+ """开窗判定:C1 ≥ 0.6 ∧ 跨域(≥1 个域)∧ 低压力。
147
+
148
+ 返回逐闸门结果与阻塞项,便于调用方知道「差在哪」,而不是只拿到一个 bool。
149
+ """
150
+ n = normalize(conditions)
151
+ c = n["conditions"]
152
+ gates = {
153
+ "c1_retrievable": c["retrievability"] >= C1_WINDOW_MIN,
154
+ "cross_domain": bool(c["cross_domain"]),
155
+ "low_pressure": c["pressure"] == "low",
156
+ }
157
+ blocked = [k for k, ok in gates.items() if not ok]
158
+ return {"open": not blocked, "gates": gates, "blocked_by": blocked,
159
+ "c1": c["retrievability"], "c1_min": C1_WINDOW_MIN,
160
+ "conditions": c, "missing": n["missing"],
161
+ "note": "开窗仅表示「条件具备」;是否有效一律由 verify 的外部证据裁决"}
162
+
163
+
164
+ # 生效条件:任意 statement(假值按 "" 计)与 ts(None/0 等假值时回落 time.time())下恒返回 "ins_%d_%s",其中时间数字为 int(ts or time.time())、哈希为 str(statement or "").encode("utf-8") 的 sha1 前 8 位。
165
+ def event_id(statement, ts=None):
166
+ return "ins_%d_%s" % (int(ts or time.time()),
167
+ hashlib.sha1(str(statement or "").encode("utf-8")).hexdigest()[:8])
168
+
169
+
170
+ # ---------------------------------------------------------------- record
171
+
172
+ # 生效条件:cg 具备 add/_append,statement 经 str(statement or "").strip() 为空时抛 ValueError;非空时以 str(node_id or event_id(statement)).strip() 为 nid(node_id 假值时回落到 event_id(statement)),_read_event 命中已有事件则返回 duplicate=True/existed_before=True 且 state 取该节点 frontmatter 的 insight_state,未命中则以 STATE_PENDING 写入新节点并返回 duplicate=False/existed_before=False,返回中的 window 来自 window(conditions)。
173
+ def record(cg, statement=None, conditions=None, category="", source="",
174
+ tags=None, importance=0.5, node_id=None, actor=None, **extra):
175
+ """记录一条洞见事件(pending)+ C1–C8 条件快照。
176
+
177
+ ``statement`` 必填:洞见正文由调用方给出,本层不臆造;缺正文直接报错。
178
+ 幂等:同一正文派生同一 id,重复调用不重复写盘。
179
+ """
180
+ statement = str(statement or "").strip()
181
+ if not statement:
182
+ raise ValueError("insight record 需要 statement:洞见正文由调用方给出,本层不臆造")
183
+ w = window(conditions)
184
+ nid = str(node_id or event_id(statement)).strip()
185
+ existing = _read_event(cg, nid)
186
+ if existing:
187
+ fm = existing.get("frontmatter") or {}
188
+ _append(cg, {"action": "record", "node_id": nid, "duplicate": True,
189
+ "actor": actor, "ts": time.time()})
190
+ return {"ok": True, "action": "record", "node_id": nid,
191
+ "state": fm.get("insight_state"), "window": w,
192
+ "existed_before": True, "duplicate": True,
193
+ "note": "同正文事件已存在,未重复写入(幂等)"}
194
+ tg = [TAG_EVENT] + [str(t) for t in (tags or [])]
195
+ if category:
196
+ tg.append("insight_cat:%s" % category)
197
+ body = statement if statement.endswith("\n") else statement + "\n"
198
+ fm_extra = {
199
+ "insight_state": STATE_PENDING,
200
+ "insight_category": category,
201
+ "insight_source": source,
202
+ "insight_conditions": w["conditions"],
203
+ "insight_missing": w["missing"],
204
+ "insight_window_open": bool(w["open"]),
205
+ "insight_statement": statement,
206
+ "insight_evidence": [],
207
+ "insight_history": [],
208
+ }
209
+ fm_extra.update(extra)
210
+ cg.add(nid, body, layer=INSIGHT_LAYER, tags=tg,
211
+ importance=float(importance), actor=actor, **fm_extra)
212
+ _append(cg, {"action": "record", "node_id": nid, "category": category,
213
+ "source": source, "window_open": w["open"],
214
+ "blocked_by": w["blocked_by"], "missing": w["missing"],
215
+ "actor": actor, "ts": time.time()})
216
+ return {"ok": True, "action": "record", "node_id": nid, "state": STATE_PENDING,
217
+ "window": w, "existed_before": False, "duplicate": False,
218
+ "note": "已记录为 pending;有效性待 verify 的外部证据裁决"}
219
+
220
+
221
+ # ---------------------------------------------------------------- verify
222
+
223
+ # 生效条件:evidence 为 str/dict 时先包成单元素列表、为 None 或假值时按 [] 遍历;每个 dict 项 type 经 str(...).strip().lower() 属 V_TYPES 才保留否则回落 "v1",ref 取 item.get("ref") 或 item.get("source") 或 ""、note 取 item.get("note") 或 "",非 dict 项一律记为 {"type":"v1","ref":str(item),"note":""};v_types 中仅 strip().lower() 后属 V_TYPES 的项追加空 ref/note 条目,最终返回 out。
224
+ def _normalize_evidence(evidence=None, v_types=None):
225
+ """证据归一化:接受 ``["ref", ...]`` / ``[{"type","ref","note"}]`` / ``v_types``。"""
226
+ ev = evidence
227
+ if isinstance(ev, (str, dict)):
228
+ ev = [ev]
229
+ out = []
230
+ for item in (ev or []):
231
+ if isinstance(item, dict):
232
+ t = str(item.get("type") or "").strip().lower()
233
+ out.append({"type": t if t in V_TYPES else "v1",
234
+ "ref": str(item.get("ref") or item.get("source") or ""),
235
+ "note": str(item.get("note") or "")})
236
+ else:
237
+ out.append({"type": "v1", "ref": str(item), "note": ""})
238
+ for t in (v_types or []):
239
+ t = str(t).strip().lower()
240
+ if t in V_TYPES:
241
+ out.append({"type": t, "ref": "", "note": ""})
242
+ return out
243
+
244
+
245
+ # 生效条件:_read_event(cg,node_id) 取不到事件节点、或 verdict 经 str(verdict or "").strip().lower() 后非空且不是 verified/falsified 时抛 ValueError;verdict 为 None 或空白时按 v3 → v2 → v1 条数 ≥ V1_MIN_EVIDENCE 的顺序定 verified,有证据但不达门槛或无证据则保持 STATE_PENDING 并附 reason;显式 verdict 直接采信,verified 分支重要度保底 VERIFY_IMPORTANCE_FLOOR 并置保护位,falsified 分支打 TAG_FALSIFIED;裁决分支落盘前经 protect.guard_overwrite(层闸 + 保护闸),写盘后同步内存索引条目并**标脏**(cg._dirty[node_id]=ent,推进读缓存代际与索引增量日志)。
246
+ def verify(cg, node_id=None, evidence=None, v_types=None, verdict=None,
247
+ actor=None, note=""):
248
+ """用 V1/V2/V3 外部证据裁决洞见事件。
249
+
250
+ 判定规则(先声明后判定,避免「有证据就算过」):
251
+ · 显式 ``verdict``(verified/falsified)→ 直接采信(证伪只能由此路径产生);
252
+ · V3 外部确证 或 V2 实践重复 → verified;
253
+ · V1 可检索/被引用 需 **≥ V1_MIN_EVIDENCE 条** 才成立;
254
+ · 其余(无证据 / V1 不足)→ **保持 pending 并给出原因**,不判定。
255
+ verified 后:重要度保底 0.9(``VERIFY_IMPORTANCE_FLOOR``)并置保护位。
256
+ 裁决分支落盘前过 ``protect.guard_overwrite``(层闸 + 保护闸),写盘后同步
257
+ 内存索引条目并**标脏**(``cg._dirty[node_id]``,C-1)——否则读缓存默认开时
258
+ 同进程「verify 后读」拿旧 insight_state/tags/importance。
259
+ """
260
+ node = _read_event(cg, node_id)
261
+ if not node:
262
+ raise ValueError("不是有效的洞见事件节点:%r" % (node_id,))
263
+ fm = dict(node.get("frontmatter") or {})
264
+ ev = _normalize_evidence(evidence, v_types)
265
+ kinds = {e["type"] for e in ev}
266
+ explicit = str(verdict or "").strip().lower() or None
267
+ if explicit is not None and explicit not in (STATE_VERIFIED, STATE_FALSIFIED):
268
+ raise ValueError("verdict 只能是 verified / falsified / None:%r" % (verdict,))
269
+
270
+ final, reason = explicit, ""
271
+ if final is None:
272
+ if "v3" in kinds:
273
+ final, reason = STATE_VERIFIED, "V3 外部确证"
274
+ elif "v2" in kinds:
275
+ final, reason = STATE_VERIFIED, "V2 实践重复"
276
+ elif sum(1 for e in ev if e["type"] == "v1") >= V1_MIN_EVIDENCE:
277
+ final, reason = STATE_VERIFIED, "V1 可检索/被引用 ≥ %d 条" % V1_MIN_EVIDENCE
278
+ elif ev:
279
+ reason = ("仅 V1 证据且不足 %d 条:不判定,保持 pending"
280
+ % V1_MIN_EVIDENCE)
281
+ else:
282
+ reason = "无外部证据:不判定,保持 pending(窗口开不等于有效)"
283
+ if final is None:
284
+ _append(cg, {"action": "verify", "node_id": node_id, "state": STATE_PENDING,
285
+ "decided": False, "reason": reason, "evidence": ev,
286
+ "actor": actor, "ts": time.time()})
287
+ return {"ok": True, "action": "verify", "node_id": node_id,
288
+ "state": STATE_PENDING, "decided": False, "reason": reason,
289
+ "evidence": ev, "importance": fm.get("importance"),
290
+ "note": "未达判定门槛,保持 pending"}
291
+
292
+ hist = list(fm.get("insight_history") or [])
293
+ hist.append({"ts": time.time(), "from": fm.get("insight_state"),
294
+ "to": final, "reason": reason or "显式裁决",
295
+ "actor": actor, "note": note})
296
+ fm["insight_state"] = final
297
+ fm["insight_evidence"] = list(fm.get("insight_evidence") or []) + ev
298
+ fm["insight_history"] = hist
299
+ fm["insight_reason"] = reason or "显式裁决"
300
+ tg = [t for t in (fm.get("tags") or []) if t not in (TAG_VERIFIED, TAG_FALSIFIED)]
301
+ if final == STATE_VERIFIED:
302
+ tg.append(TAG_VERIFIED)
303
+ fm["importance"] = max(float(fm.get("importance") or 0.0), VERIFY_IMPORTANCE_FLOOR)
304
+ fm["protected"] = True
305
+ fm["protection_reason"] = "insight_verified"
306
+ fm["verification_basis"] = "data"
307
+ else:
308
+ tg.append(TAG_FALSIFIED)
309
+ fm["tags"] = tg
310
+ # N197(2026-09-28):本面是**既有节点的覆写**——原先直调 `cg._write_node`,
311
+ # 既无 `principal.require_layer_write` 亦无 `protect.guard_write`,与同一身份
312
+ # 对同层 `add` 的待遇相反(add 被 AccessDenied,这里照样落盘):越层腿
313
+ # (sustain layers=('self',) verify 他人的 contextual 事件)+ 保护腿
314
+ # (self/anchor/immutable 节点被无痕覆写、无快照无审计)都由这一处补闸收口。
315
+ # 层与敏感度取**本节点已读到的 frontmatter 真值**(不靠索引缺字段时的回落)。
316
+ _disk = os.path.join(cg.root, node["path"])
317
+ _content = node.get("content") or ""
318
+ protect.guard_overwrite(cg, node_id, layer=fm.get("layer"),
319
+ sensitivity=fm.get("sensitivity"), actor=actor)
320
+ cg._write_node(node_id, _disk, fm, _content)
321
+ _ent = cg._node_entry(_disk, fm.get("layer"), fm, _content)
322
+ # 写点专有键:真源不含它,重建后叠加(不是「凭记忆补几键」)。
323
+ _ent["insight_state"] = final
324
+ # 落库走 `cg._stage`——索引条目写入的**单点**(`_dirty` + `_set_index_entry`
325
+ # 的桶计数与 stg 同钩)。旧形态手写两处(ent + _dirty),两处必然漂开;N133
326
+ # 当年的标脏诉求(读缓存 path_gen 不推进 ⇒ 同进程「verify 后读」拿旧值)由
327
+ # `_stage` 一并满足。
328
+ # **不下沉进 `_write_node`**(该口另有「只对账索引不落盘」的调用方,下沉会
329
+ # 凭空产生写入代际与自重载)。
330
+ cg._stage(node_id, _ent)
331
+ # issue #416(2026-10-16 DSH 端):索引条目**由真源重建**,不再手写键子集。
332
+ # 旧形态只补 importance/tags/insight_state 三键,而 fm 刚写下的
333
+ # protected=True / protection_reason="insight_verified"(:295-296)**没有**
334
+ # 同步进条目 ⇒ `protect._fm` 对**非受保护层**不回退读文件(N213 逐字:恒落
335
+ # 三键 ⇒ 「缺键」判据恒假 ⇒ 100% 信任索引)⇒ 条目里的 None 被当「未标记」
336
+ # 采信 ⇒ 盘面写着 protected: true 的节点判 (False, ''),`cg.forget` 无需
337
+ # override 即软删(零前像、零保护审计行),且跨重启存活(走快照+日志)。
338
+ # **真源 = MdCG._node_entry**(自述「_scan_nodes 与定向 upsert 共用的唯一
339
+ # 真源」)——由它重建整条 entry,真源将来加键本写点**自动跟上**;手写子集
340
+ # 无论补成 3 键还是 4 键,都只是「下一次漏」的形态(#192 同款教训)。
341
+ _append(cg, {"action": "verify", "node_id": node_id, "state": final,
342
+ "decided": True, "reason": reason or "显式裁决",
343
+ "evidence": ev, "importance": fm.get("importance"),
344
+ "actor": actor, "ts": time.time()})
345
+ return {"ok": True, "action": "verify", "node_id": node_id, "state": final,
346
+ "decided": True, "reason": reason or "显式裁决", "evidence": ev,
347
+ "evidence_count": len(fm["insight_evidence"]),
348
+ "importance": fm.get("importance"),
349
+ "protected": bool(fm.get("protected")),
350
+ "note": "verified 后重要度保底 %s 并置保护位" % VERIFY_IMPORTANCE_FLOOR}
351
+
352
+
353
+ # ---------------------------------------------------------------- list / report
354
+
355
+ # 生效条件:state 为真值时只保留 insight_state 与之相等的项(state 为 None/空串等假值则不过滤),limit 为 0 等假值时返回按 created_at 排序后的全部列表,limit 为真值时返回 out[-int(limit):]——limit 为负时该切片等价于 out[|limit|:],即去掉排序后前 |limit| 条而非取前 |limit| 条。
356
+ def list_events(cg, state=None, limit=0):
357
+ out = []
358
+ for nid in _events(cg):
359
+ node = _read_event(cg, nid)
360
+ if not node:
361
+ continue
362
+ fm = node.get("frontmatter") or {}
363
+ st = fm.get("insight_state")
364
+ if state and st != state:
365
+ continue
366
+ out.append({"node_id": nid, "state": st,
367
+ "category": fm.get("insight_category"),
368
+ "importance": fm.get("importance"),
369
+ "window_open": bool(fm.get("insight_window_open")),
370
+ "created_at": fm.get("created_at"),
371
+ "evidence_count": len(fm.get("insight_evidence") or []),
372
+ "reason": fm.get("insight_reason")})
373
+ out.sort(key=lambda x: x.get("created_at") or 0)
374
+ return out[-int(limit):] if limit else out
375
+
376
+
377
+ # 生效条件:now 为 None/0 等假值时取 time.time(),window_days 为真值时按 now - window_days*86400 过滤 created_at;已裁决数 verified+falsified < CER_MIN_SAMPLES 时直接返回 cer/se/two_se/significant 为 None、layer_state="insufficient" 的结果,否则按 p=verified/denom 算出 se 与 significant,significant 为假时 p<0.3 取 degraded、否则 watch,significant 为真时 p≥0.5 取 reliable、否则 watch。
378
+ def report(cg, window_days=None, now=None):
379
+ """CER 条件有效洞见率报告(样本不足不判定)。
380
+
381
+ CER = verified /(verified + falsified);显著性带宽 = 2×SE,
382
+ SE = sqrt(p(1-p)/n)。层状态:reliable / watch / degraded / insufficient。
383
+ """
384
+ now = float(now or time.time())
385
+ events = list_events(cg)
386
+ if window_days:
387
+ lo = now - float(window_days) * 86400.0
388
+ events = [e for e in events if (e.get("created_at") or 0) >= lo]
389
+ n = len(events)
390
+ verified = sum(1 for e in events if e["state"] == STATE_VERIFIED)
391
+ falsified = sum(1 for e in events if e["state"] == STATE_FALSIFIED)
392
+ pending = sum(1 for e in events if e["state"] == STATE_PENDING)
393
+ open_windows = sum(1 for e in events if e["window_open"])
394
+ denom = verified + falsified
395
+ out = {"ok": True, "action": "report", "op": "insight",
396
+ "window_days": window_days, "recorded": n,
397
+ "verified": verified, "falsified": falsified, "pending": pending,
398
+ "decided": denom, "window_open_count": open_windows,
399
+ "window_open_rate": (round(open_windows / n, 4) if n else None),
400
+ "sample_min": CER_MIN_SAMPLES, "cer": None, "se": None, "two_se": None,
401
+ "significant": None, "layer_state": "insufficient", "note": ""}
402
+ if denom < CER_MIN_SAMPLES:
403
+ out["note"] = ("样本不足(已裁决 %d < %d):按纪律不判定层状态,"
404
+ "避免小样本过拟合" % (denom, CER_MIN_SAMPLES))
405
+ return out
406
+ p = verified / denom
407
+ se = math.sqrt(max(0.0, p * (1.0 - p)) / denom)
408
+ out.update({"cer": round(p, 4), "se": round(se, 4),
409
+ "two_se": round(2 * se, 4), "significant": bool(p > 2 * se)})
410
+ if not out["significant"]:
411
+ out["layer_state"] = "degraded" if p < 0.3 else "watch"
412
+ else:
413
+ out["layer_state"] = "reliable" if p >= 0.5 else "watch"
414
+ out["note"] = ("CER = 已验证 /(已验证 + 已证伪);2×SE 为显著性带宽;"
415
+ "reliable/watch/degraded 只描述条件层有效性趋势,不构成结论")
416
+ return out
417
+
418
+
419
+ # ---------------------------------------------------------------- outlook
420
+
421
+ # 生效条件:entry 为假值或 (entry or {}).get("layer") 为假值时返回 "unknown",否则返回该 layer 值的 str 形式。
422
+ def _layer_of(entry):
423
+ return str((entry or {}).get("layer") or "unknown")
424
+
425
+
426
+ # 生效条件:values 为空/假值时返回 min/p50/p90/max 全为 None 的字典,否则对 sorted(values) 取 0.0/0.5/0.9/1.0 位置的值并各自 round(·,4)。
427
+ def _quartiles(values):
428
+ if not values:
429
+ return {"min": None, "p50": None, "p90": None, "max": None}
430
+ vs = sorted(values)
431
+ # 生效条件:给定 f 与闭包列表 vs,取下标 i = min(len(vs)-1, max(0, int(round(f*(len(vs)-1)))))(f 越界被夹到两端)并返回 round(vs[i], 4);vs 为空时 min 得到 -1 的取值行为源码未做校验。
432
+ def _q(f):
433
+ i = min(len(vs) - 1, max(0, int(round(f * (len(vs) - 1)))))
434
+ return round(vs[i], 4)
435
+ return {"min": _q(0.0), "p50": _q(0.5), "p90": _q(0.9), "max": _q(1.0)}
436
+
437
+
438
+ # 生效条件:cg.index(取不到或假值时 nodes 为空、total=0 使 protected_rate 与 growth 回落 None)与 now(假值时回落 time.time())决定 d1,float(recent_days) 参与 lo_recent 计算,window_days 透传 report 得 d2;suggestions 依序在 basis["unset"] 非零、hi_imp_unprotected 非空、no_neg 非零、pending>=3、layers["unresolved"] 非零、contextual>max(3, knowledge)、rep["layer_state"]=="insufficient" 时各自追加一条,high_importance_unprotected 取排序后前 sample_limit 项(sample_limit=0 时为空列表)。
439
+ def outlook(cg, window_days=None, sample_limit=8, recent_days=7, now=None):
440
+ """结构洞察:D1 结构判断 + D2 盲区与趋势建议(只读)。
441
+
442
+ D1 —— 关于**自身记忆结构**的判断:分层分布、重要度分位、保护率、验证基底
443
+ 分布、条件缺口(缺不适用条件)比例、近期增长。
444
+ D2 —— 盲区与趋势建议:洞见层 CER 报告、未裁决堆积、unresolved/无锚点盲区、
445
+ 以及**可执行的下一步建议**(带证据与建议调用)。
446
+
447
+ 诚实边界:本函数只做**结构描述与差距定位**,不判有效性、不替调用方下结论;
448
+ 样本不足或指标缺失时返回 None / 显式缺口,而不是编一个数。
449
+ """
450
+ now = float(now or time.time())
451
+ nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
452
+ total = len(nodes)
453
+ layers, basis = {}, {}
454
+ imps, protected, no_neg, recent = [], 0, 0, 0
455
+ lo_recent = now - float(recent_days) * 86400.0
456
+ hi_imp_unprotected = []
457
+ for nid, e in list(nodes.items()):
458
+ e = e or {}
459
+ layers[_layer_of(e)] = layers.get(_layer_of(e), 0) + 1
460
+ b = str(e.get("verification_basis") or "unset")
461
+ basis[b] = basis.get(b, 0) + 1
462
+ try:
463
+ iv = float(e.get("importance") or 0.0)
464
+ except (TypeError, ValueError):
465
+ iv = 0.0
466
+ imps.append(iv)
467
+ # #433:① `d1.protected` 此前只认 `protected` 位(窄:漏层保护与按分保护)⇒ 走条目口径单点;
468
+ # ② 「高重要度」门槛改引全仓单点 protect.AUTO_PROTECT_IMPORTANCE(0.70),
469
+ # **不再用私有 0.9**(那会把 [0.70,0.90) 的受保护节点漏掉)。
470
+ if protect.is_protected_entry(e or {})[0]:
471
+ protected += 1
472
+ elif iv >= protect.AUTO_PROTECT_IMPORTANCE:
473
+ hi_imp_unprotected.append(nid)
474
+ if not e.get("has_neg_conditions"):
475
+ no_neg += 1
476
+ ca = e.get("created_at")
477
+ if ca and float(ca) >= lo_recent:
478
+ recent += 1
479
+
480
+ events = list_events(cg)
481
+ pending = sum(1 for x in events if x["state"] == STATE_PENDING)
482
+ rep = report(cg, window_days=window_days, now=now)
483
+
484
+ d1 = {
485
+ "total": total,
486
+ "layers": dict(sorted(layers.items(), key=lambda kv: (-kv[1], kv[0]))),
487
+ "importance": _quartiles(imps),
488
+ "protected": protected,
489
+ "protected_rate": (round(protected / total, 4) if total else None),
490
+ "verification_basis": dict(sorted(basis.items(), key=lambda kv: (-kv[1], kv[0]))),
491
+ "missing_non_applicable": no_neg,
492
+ "missing_non_applicable_rate": (round(no_neg / total, 4) if total else None),
493
+ "recent_%dd" % int(recent_days): recent,
494
+ "growth_%dd" % int(recent_days): (round(recent / total, 4) if total else None),
495
+ }
496
+ d2 = {
497
+ "insight": {"recorded": rep["recorded"], "pending": rep["pending"],
498
+ "verified": rep["verified"], "falsified": rep["falsified"],
499
+ "cer": rep["cer"], "two_se": rep["two_se"],
500
+ "layer_state": rep["layer_state"], "sample_min": rep["sample_min"]},
501
+ "unresolved_nodes": layers.get("unresolved", 0),
502
+ "high_importance_unprotected": sorted(hi_imp_unprotected)[:sample_limit],
503
+ }
504
+
505
+ suggestions = []
506
+ if basis.get("unset", 0):
507
+ suggestions.append({"priority": "P0", "action": "补验证基底",
508
+ "evidence": "%d 个节点 verification_basis 缺失" % basis["unset"],
509
+ "call": 'cg(op="maintain", action="importance", apply=true)'})
510
+ if hi_imp_unprotected:
511
+ suggestions.append({"priority": "P0", "action": "给高重要度节点补保护/裁决",
512
+ "evidence": "%d 个高重要度节点未保护" % len(hi_imp_unprotected),
513
+ "call": 'cg(op="insight", action="verify", node_id=..., evidence=[...])'})
514
+ if no_neg:
515
+ suggestions.append({"priority": "P1", "action": "补不适用条件(提升可判定性)",
516
+ "evidence": "%d 个节点缺不适用条件" % no_neg,
517
+ "call": 'cg(op="maintain", action="importance", apply=true)'})
518
+ if pending >= 3:
519
+ suggestions.append({"priority": "P1", "action": "给堆积的洞见补外部证据",
520
+ "evidence": "%d 条 pending 洞见未裁决" % pending,
521
+ "call": 'cg(op="insight", action="list", state="pending")'})
522
+ if layers.get("unresolved"):
523
+ suggestions.append({"priority": "P1", "action": "把未决查询转入盲区学习闭环",
524
+ "evidence": "%d 条 unresolved" % layers["unresolved"],
525
+ "call": 'cg(op="insight", action="learn", apply=true)'})
526
+ if layers.get("contextual", 0) > max(3, layers.get("knowledge", 0)):
527
+ suggestions.append({"priority": "P2", "action": "归纳情境记忆为概念层",
528
+ "evidence": "contextual %d > knowledge %d"
529
+ % (layers.get("contextual", 0),
530
+ layers.get("knowledge", 0)),
531
+ "call": 'cg(op="consolidate", action="induce", apply=true)'})
532
+ if rep["layer_state"] == "insufficient":
533
+ suggestions.append({"priority": "P2", "action": "积累洞见样本后再判层状态",
534
+ "evidence": "已裁决 %d < %d" % (rep["decided"], rep["sample_min"]),
535
+ "call": 'cg(op="insight", action="report")'})
536
+
537
+ return {"ok": True, "action": "outlook", "op": "insight",
538
+ "d1": d1, "d2": d2, "suggestions": suggestions,
539
+ "generated_at": now,
540
+ "note": ("结构描述与差距定位,不判有效性;suggestions 按优先级给出,"
522
541
  "需调用方自行执行并核对")}