@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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