@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. 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
  531. 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
  532. 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
  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_v2.0.md +0 -239
  534. 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
  535. 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
  536. 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
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. 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
  539. 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
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. 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
  543. 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
  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.1.md +0 -340
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,592 +1,727 @@
1
- # -*- coding: utf-8 -*-
2
- """独立元认知(Metacognition)——观察自身认知过程的二阶单元。
3
-
4
- 理论出处(本仓原文,非外部知识)
5
- ------------------------------
6
- · **情绪 = 信息差的二阶变化 d²D/dt²**(`docs/theory/智能的公理化基石.md` §十一,:412-510):
7
- 「情绪不是状态本身,而是状态变化的变化」。元认知正是对认知过程做
8
- 二阶观测的单元:一阶 = 检索结果好坏,二阶 = 认知状态在如何变化。
9
- · **情感 = 信任的二阶变化 d²T/dt²**(同文档 :469-508)。
10
- · **五大单元**(同文档 :540-556):反思单元=新 / 验证单元=稳。
11
- 元认知是这两条通道的**外部观察者**,自身不产出裁决。
12
- · **推论三 局部不可知**(同文档 :277-288):
13
- 「知道什么不知道,同样属于知识」——盲区地图是法定输出,不是失败记录。
14
- · **信任 P_trust / P_gap**(同文档 :393-408)。
15
- · **导航税**(`docs/theory/智能的认知过程.md`:84-86):维持认知过程一致性需要显式
16
- 状态记录——元认知就是付这笔税的单元。
17
-
18
- 独立性的三重含义(本模块的硬约束)
19
- --------------------------------
20
- 1. **不参与裁决**:只读留痕与索引,**不写** confidence / 资格 / 召回打分。
21
- 对齐 `consistency.py` L0 情绪通道纪律:「独立通道,不参与信任计算」。
22
- 2. **独立留痕**:`_metacognition.jsonl`(append-only,每条可审计)。
23
- 3. **独立入口**:`report` / `self_check` 可被 MCP / Agent 单独调用。
24
-
25
- 四个观测面
26
- ----------
27
- trace 信息差轨迹 D(t) → dD/dt(方向)→ d²D/dt²(情绪)
28
- calibration 自信校准:期望正确率 vs 实际验证通过率(过度自信/过度保守)
29
- blindspots 盲区地图:反复 BLINDSPOT 的查询邻域 + 未解问题
30
- trust P_gap(信息差置信)+ P_trust(验证稳定置信)+ d²T/dt²(情感)
31
-
32
- 诚实边界
33
- --------
34
- · 所有指标都是**留痕的聚合**,不是对「智能」的断言;样本不足返回
35
- `insufficient_data`,不编造数值。
36
- · 建议是**确定性模板**(非 LLM 生成),每条都带触发它的证据(可复核)。
37
- · 元认知**不修改事实层**——它只建议,执行权归调用方 / verify / forgetting。
38
- """
39
-
40
- from __future__ import annotations
41
-
42
- import os
43
- import time
44
- from collections import Counter
45
-
46
- from .fsutil import append_jsonl, read_jsonl
47
-
48
- LOG_FILE = "_metacognition.jsonl"
49
-
50
- # ---- 阈值(全部可审计、可调)----
51
- GAP_OVERCONFIDENT = 0.15 # 过度自信:期望 - 实际 > 此值
52
- GAP_UNDERCONFIDENT = -0.15 # 过度保守:期望 - 实际 < 此值
53
- BLINDSPOT_DENSE = 0.30 # 盲区密集:BLINDSPOT 占比 >= 此值
54
- D_LOW = 0.10 # P_gap:D_norm < 此值视为「信息差已收敛」
55
- MIN_SAMPLES = 5 # 样本不足 → insufficient_data
56
- D2_EMOTION = 0.05 # 二阶变化显著阈值
57
- BINS = ((0.0, 0.4), (0.4, 0.6), (0.6, 0.8), (0.8, 1.01))
58
-
59
-
60
- # --------------------------------------------------------------------------
61
- # 基础工具
62
- # --------------------------------------------------------------------------
63
-
64
- # 生效条件:形参 d2 与模块常量 D2_EMOTION 比较——d2 > D2_EMOTION 返回 "avoiding",d2 < -D2_EMOTION 返回 "approaching",其余(含 |d2| 不超过阈值)返回 "stable";
65
- def _emotion(d2: float) -> str:
66
- """情绪:d²D/dt² 的符号(智能论 §十一)。"""
67
- if d2 > D2_EMOTION:
68
- return "avoiding" # 信息差加速扩大
69
- if d2 < -D2_EMOTION:
70
- return "approaching" # 信息差加速收敛
71
- return "stable"
72
-
73
-
74
- # 生效条件:形参 q 经 str(q or "") 小写并仅保留字母数字字符得到 s 后,s[:n](n 默认 16,n 为 0 等使前缀为空的取值时前缀为空串)非空则返回该前缀,否则(q 为假值、无字母数字字符或 n 为 0)返回 "(empty)";
75
- def _key(q, n: int = 16) -> str:
76
- """查询归一化键(用于盲区聚合 / 相似匹配)。"""
77
- s = "".join(ch for ch in str(q or "").lower() if ch.isalnum())
78
- return s[:n] or "(empty)"
79
-
80
-
81
- # 生效条件:形参 s 经 str(s or "") 并剔除 strip() 为空的字符后长度为 0 时返回 set(),长度为 1 时返回 {s},长度 ≥2 时返回 {s[i:i+2] for i in range(len(s)-1)};
82
- def _bigrams(s) -> set:
83
- s = "".join(ch for ch in str(s or "") if ch.strip())
84
- if len(s) < 2:
85
- return {s} if s else set()
86
- return {s[i:i + 2] for i in range(len(s) - 1)}
87
-
88
-
89
- # 生效条件:形参 a、b 经 _bigrams 处理后任一结果为空集(如 a 或 b 为空、仅含空白字符)时返回 0.0,否则返回两集合交集大小除以并集大小;
90
- def _jaccard(a, b) -> float:
91
- A, B = _bigrams(a), _bigrams(b)
92
- if not A or not B:
93
- return 0.0
94
- return len(A & B) / len(A | B)
95
-
96
-
97
- # 生效条件:形参 rec 被复制并 setdefault("t", time.time()) 后,向 os.path.join(cg.root, LOG_FILE) 追加写入抛 OSError 时静默跳过,两类情形均返回补过 t 的 rec 副本;
98
- def _log(cg, rec: dict) -> dict:
99
- """独立留痕(append-only)。失败不阻塞主流程。"""
100
- rec = dict(rec)
101
- rec.setdefault("t", time.time())
102
- try:
103
- append_jsonl(os.path.join(cg.root, LOG_FILE), rec)
104
- except OSError:
105
- pass
106
- return rec
107
-
108
-
109
- # 生效条件:形参 cg 的 reflection_log 属性缺失或为假值时回落到 os.path.join(cg.root, "_reflection.jsonl"),返回该路径 read_jsonl 结果的 list;
110
- def _reflections(cg) -> list:
111
- path = getattr(cg, "reflection_log", "") or os.path.join(
112
- cg.root, "_reflection.jsonl")
113
- return list(read_jsonl(path))
114
-
115
-
116
- # 生效条件:形参 cg 的 index 属性缺失或为假值、或其 "nodes" 键缺失、或该键值为假值(如空 dict)时返回 {},否则返回该 "nodes" 值;
117
- def _nodes(cg) -> dict:
118
- return (getattr(cg, "index", None) or {}).get("nodes") or {}
119
-
120
-
121
- # 生效条件:形参 cg 的 get(nid) 为假值、或其结果缺 "frontmatter" 键、或该键值为假值时返回 {},否则返回该 node 的 frontmatter;
122
- def _fm(cg, nid) -> dict:
123
- node = cg.get(nid) or {}
124
- return node.get("frontmatter") or {}
125
-
126
-
127
- # --------------------------------------------------------------------------
128
- # 观测面 1:信息差轨迹(D / dD / d²D)
129
- # --------------------------------------------------------------------------
130
-
131
- # 生效条件:形参 cg 的反思留痕中不存在 d_curr 为 int/float 的记录时返回 ok=False/insufficient_data/n=0;否则按 window(默认 50,window 为假值 0 时取全部记录)截取尾部计算,返回 ok=True 及 d_current、d1、由 d1 与 ±0.01 判定的 trend(converging/diverging/flat)等字段;
132
- def trace(cg, window: int = 50) -> dict:
133
- """信息差轨迹:D(t) → dD/dt(方向)→ d²D/dt²(情绪)。
134
-
135
- 数据源:`_reflection.jsonl`(reflect() 的留痕),不新增计算负担。
136
- """
137
- recs = [r for r in _reflections(cg)
138
- if isinstance(r.get("d_curr"), (int, float))]
139
- if not recs:
140
- return {"ok": False, "reason": "insufficient_data", "n": 0,
141
- "note": "无反思留痕:先调用 reflect() 才有轨迹"}
142
- tail = recs[-int(window):] if window else recs
143
- ds = [float(r["d_curr"]) for r in tail]
144
- n = len(ds)
145
- d1 = (ds[-1] - ds[0]) / max(1, n - 1)
146
- d2 = float(tail[-1].get("d2") or 0.0)
147
- states = Counter()
148
- for r in tail:
149
- for k, v in (r.get("states") or {}).items():
150
- try:
151
- states[str(k)] += int(v or 0)
152
- except (TypeError, ValueError):
153
- continue
154
- total = sum(states.values()) or 1
155
- return {
156
- "ok": True, "n": n,
157
- "d_current": round(ds[-1], 4),
158
- "d_mean": round(sum(ds) / n, 4),
159
- "d_min": round(min(ds), 4),
160
- "d_max": round(max(ds), 4),
161
- "d1": round(d1, 4),
162
- "d2": round(d2, 4),
163
- "emotion": _emotion(d2),
164
- "trend": ("converging" if d1 < -0.01 else
165
- "diverging" if d1 > 0.01 else "flat"),
166
- "states": dict(states),
167
- "state_rates": {k: round(v / total, 4) for k, v in states.items()},
168
- "d_series": [round(x, 4) for x in ds[-20:]],
169
- }
170
-
171
-
172
- # --------------------------------------------------------------------------
173
- # 观测面 2:自信校准(期望正确率 vs 实际验证通过率)
174
- # --------------------------------------------------------------------------
175
-
176
- # 生效条件:形参 cg 的 index.nodes 中满足 evidence_count>0 且 frontmatter 的正例+负例>0 的节点计数 used,在 used >= int(max_scan)(默认 2000,max_scan 为 0 时立即 break 使 used=0)时截断——used 为 0 返回 ok=False/insufficient_data,否则按 used 与常量 MIN_SAMPLES、期望减实际的 gap 与 GAP_OVERCONFIDENT/GAP_UNDERCONFIDENT 判定 verdict(insufficient_data/overconfident/underconfident/calibrated);
177
- def calibration(cg, max_scan: int = 2000) -> dict:
178
- """自信校准:我说的可信吗?
179
-
180
- 期望正确率 = 节点 confidence 均值;
181
- 实际正确率 = Σ正例 / Σ(正例+负例)(来自 evidence_log 的聚合计数)。
182
- gap > 0 → 过度自信;gap < 0 → 过度保守。
183
- ECE = Σ(证据占比 × |桶内实际 - 桶内自信|)(期望校准误差)。
184
- """
185
- keys = [f"{lo:g}-{hi:g}" for lo, hi in BINS]
186
- buckets = {k: {"n": 0, "conf_sum": 0.0, "pos": 0, "neg": 0} for k in keys}
187
- exp_sum = 0.0
188
- used = 0
189
- total_pos = total_neg = 0
190
- for nid, e in _nodes(cg).items():
191
- if used >= int(max_scan):
192
- break
193
- if int(e.get("evidence_count") or 0) <= 0:
194
- continue
195
- fm = _fm(cg, nid)
196
- pos = int(fm.get("positive_evidence") or 0)
197
- neg = int(fm.get("negative_evidence") or 0)
198
- if pos + neg <= 0:
199
- continue
200
- conf = float(fm.get("confidence", 0.6))
201
- used += 1
202
- exp_sum += conf
203
- total_pos += pos
204
- total_neg += neg
205
- for lo, hi in BINS:
206
- if lo <= conf < hi:
207
- b = buckets[f"{lo:g}-{hi:g}"]
208
- b["n"] += 1
209
- b["conf_sum"] += conf
210
- b["pos"] += pos
211
- b["neg"] += neg
212
- break
213
- if used == 0:
214
- return {"ok": False, "reason": "insufficient_data", "n_nodes": 0,
215
- "note": "无带证据的节点:先 verify() 积累验证记录"}
216
- expected = exp_sum / used
217
- actual = total_pos / max(1, total_pos + total_neg)
218
- gap = expected - actual
219
- bins = []
220
- ece = 0.0
221
- total_ev = total_pos + total_neg
222
- for k in keys:
223
- b = buckets[k]
224
- if b["n"] == 0:
225
- continue
226
- n_ev = b["pos"] + b["neg"]
227
- conf_b = b["conf_sum"] / b["n"]
228
- acc_b = (b["pos"] / n_ev) if n_ev else None
229
- bins.append({"bin": k, "n_nodes": b["n"], "n_evidence": n_ev,
230
- "confidence": round(conf_b, 4),
231
- "accuracy": None if acc_b is None else round(acc_b, 4)})
232
- if n_ev and total_ev:
233
- ece += (n_ev / total_ev) * abs(conf_b - acc_b)
234
- if used < MIN_SAMPLES:
235
- verdict = "insufficient_data"
236
- elif gap > GAP_OVERCONFIDENT:
237
- verdict = "overconfident"
238
- elif gap < GAP_UNDERCONFIDENT:
239
- verdict = "underconfident"
240
- else:
241
- verdict = "calibrated"
242
- return {
243
- "ok": True, "n_nodes": used,
244
- "n_evidence": total_ev,
245
- "expected_accuracy": round(expected, 4),
246
- "actual_accuracy": round(actual, 4),
247
- "gap": round(gap, 4),
248
- "ece": round(ece, 4),
249
- "verdict": verdict,
250
- "bins": bins,
251
- }
252
-
253
-
254
- # --------------------------------------------------------------------------
255
- # 观测面 3:盲区地图(我知道我不知道什么)
256
- # --------------------------------------------------------------------------
257
-
258
- # 生效条件:形参 cg 的反思留痕按 window(默认 200,window 为 0 时切片 [0:] 取全部)截尾,聚合其中 BLINDSPOT/DEFER 计数非零且 query 非空的记录(计数转换失败则跳过该条);返回 ok=True,items 与 unresolved 各取前 int(limit)(limit 默认 20,limit 为 0 时两项均为空列表),unresolved_count 为未截断的完整计数;
259
- def blindspots(cg, limit: int = 20, window: int = 200) -> dict:
260
- """盲区地图:反复 BLINDSPOT / DEFER 的查询邻域 + 未解问题清单。
261
-
262
- 智能论推论三:盲区不是失败记录,是知识。因此按**邻域聚合**输出,
263
- 可直接驱动 unresolved 层建节点(补条件)。
264
- """
265
- recs = _reflections(cg)[-int(window):]
266
- agg = {}
267
- for r in recs:
268
- st = r.get("states") or {}
269
- try:
270
- bad = int(st.get("BLINDSPOT") or 0)
271
- defer = int(st.get("DEFER") or 0)
272
- except (TypeError, ValueError):
273
- continue
274
- if not bad and not defer:
275
- continue
276
- q = str(r.get("query") or "").strip()
277
- if not q:
278
- continue
279
- k = _key(q)
280
- a = agg.setdefault(k, {"query": q, "blindspot": 0, "defer": 0,
281
- "samples": 0, "last_t": 0.0})
282
- a["blindspot"] += bad
283
- a["defer"] += defer
284
- a["samples"] += 1
285
- a["last_t"] = max(a["last_t"], float(r.get("t") or 0.0))
286
- items = sorted(agg.values(),
287
- key=lambda x: (-x["blindspot"], -x["defer"], -x["last_t"]))
288
- unresolved = []
289
- for nid, e in _nodes(cg).items():
290
- if e.get("layer") == "unresolved":
291
- unresolved.append({"node_id": nid,
292
- "content": str((cg.get(nid) or {}).get("content") or "")[:200]})
293
- return {
294
- "ok": True,
295
- "n_queries": len(agg),
296
- "items": items[:int(limit)],
297
- "unresolved": unresolved[:int(limit)],
298
- "unresolved_count": len(unresolved),
299
- }
300
-
301
-
302
- # --------------------------------------------------------------------------
303
- # 观测面 4:信任(P_gap / P_trust / 情感)
304
- # --------------------------------------------------------------------------
305
-
306
- # 生效条件:形参 events 为假值(空容器)时返回 0.0,否则返回其中等于 "confirmed" 的元素个数除以 events 长度;
307
- def _rate(events) -> float:
308
- if not events:
309
- return 0.0
310
- return sum(1 for v in events if v == "confirmed") / len(events)
311
-
312
-
313
- # 生效条件:形参 cg 的反思留痕中 d_curr 为数值的序列按 window(默认 100,window 为 0 时切片 [0:] 取全部)截尾得 p_gap(截尾结果为空则为 None);取自 evidence_count>0 的节点的验证事件(扫描数受 int(max_scan) 上限、默认 2000,按 window 同样规则截尾)为空时返回 p_trust=None/emotion=None 分支,否则按三段 confirmed 通过率差返回 d1、d2、emotion 与 verdicts;
314
- def trust(cg, window: int = 100, max_scan: int = 2000) -> dict:
315
- """P_gap(信息差置信)+ P_trust(验证稳定置信)+ d²T/dt²(情感)。
316
-
317
- P_gap = 近期反思中 D_norm < D_LOW 的比例(信息差已收敛 = 有把握);
318
- P_trust = 近期验证事件中 confirmed 的占比(智能论 §十);
319
- d²T/dt² = 三段验证通过率差的二阶差分(情感 = 信任的二阶变化)。
320
- """
321
- recs = _reflections(cg)
322
- ds = [float(r["d_curr"]) for r in recs
323
- if isinstance(r.get("d_curr"), (int, float))]
324
- recent_d = ds[-int(window):]
325
- p_gap = (round(sum(1 for d in recent_d if d < D_LOW) / len(recent_d), 4)
326
- if recent_d else None)
327
-
328
- events = []
329
- used = 0
330
- for nid, e in _nodes(cg).items():
331
- if used >= int(max_scan):
332
- break
333
- if int(e.get("evidence_count") or 0) <= 0:
334
- continue
335
- used += 1
336
- for ev in (_fm(cg, nid).get("evidence_log") or []):
337
- if isinstance(ev, dict) and ev.get("verdict"):
338
- events.append((float(ev.get("t") or 0.0), str(ev["verdict"])))
339
- events.sort()
340
- tail = events[-int(window):] if window else events
341
- n = len(tail)
342
- if not n:
343
- return {"ok": True, "p_gap": p_gap, "p_trust": None,
344
- "emotion": None, "n_events": 0,
345
- "note": "无验证留痕:先 verify() 才有信任轨迹"}
346
- verdicts = [v for _, v in tail]
347
- p_trust = round(_rate(verdicts), 4)
348
- seg = max(1, n // 3)
349
- s1 = _rate(verdicts[:seg])
350
- s2 = _rate(verdicts[seg:2 * seg]) if n > seg else s1
351
- s3 = _rate(verdicts[2 * seg:]) if n > 2 * seg else s2
352
- d1 = s2 - s1
353
- d2 = (s3 - s2) - (s2 - s1)
354
- return {
355
- "ok": True,
356
- "p_gap": p_gap,
357
- "p_trust": p_trust,
358
- "d1": round(d1, 4),
359
- "d2": round(d2, 4),
360
- "emotion": _emotion(d2),
361
- "n_events": n,
362
- "verdicts": dict(Counter(verdicts)),
363
- }
364
-
365
-
366
- # --------------------------------------------------------------------------
367
- # 自报告:汇总 + 确定性建议
368
- # --------------------------------------------------------------------------
369
-
370
- # 生效条件:形参 tr.get("ok") 为假时产出 no_trace;否则按 tr["d2"] > D2_EMOTION 产出 diverging、state_rates["BLINDSPOT"] >= BLINDSPOT_DENSE 产出 blindspot_dense;再按 cal 的 verdict 为 overconfident/underconfident 与 bs.get("unresolved_count", 0) > 0 各自追加;全部未触发时返回单条 stable(形参 tt 在函数体内未被使用);
371
- def _advise(tr, cal, bs, tt) -> list:
372
- """确定性建议(非 LLM):每条都带触发它的证据,可复核。"""
373
- out = []
374
- if not tr.get("ok"):
375
- out.append({"code": "no_trace",
376
- "why": "无反思留痕,无法评估认知轨迹",
377
- "action": "先调用 reflect() 积累轨迹"})
378
- else:
379
- rates = tr.get("state_rates") or {}
380
- if tr["d2"] > D2_EMOTION:
381
- out.append({"code": "diverging",
382
- "why": f"信息差加速扩大 d²D/dt²={tr['d2']}(emotion={tr['emotion']})",
383
- "action": "回到最近一次 DEFER 的缺失条件,先补条件再扩张"})
384
- if float(rates.get("BLINDSPOT") or 0) >= BLINDSPOT_DENSE:
385
- out.append({"code": "blindspot_dense",
386
- "why": f"BLINDSPOT 占比 {rates.get('BLINDSPOT')} >= {BLINDSPOT_DENSE}",
387
- "action": "为高频盲区邻域建 unresolved 节点,驱动补条件"})
388
- verdict = cal.get("verdict")
389
- if verdict == "overconfident":
390
- out.append({"code": "overconfident",
391
- "why": (f"期望正确率 {cal['expected_accuracy']} > 实际 "
392
- f"{cal['actual_accuracy']}(gap {cal['gap']})"),
393
- "action": "对高 confidence 节点抽查复核;verify(weakened) 会触发降级"})
394
- elif verdict == "underconfident":
395
- out.append({"code": "underconfident",
396
- "why": (f"期望正确率 {cal['expected_accuracy']} < 实际 "
397
- f"{cal['actual_accuracy']}(gap {cal['gap']})"),
398
- "action": "自信偏低:可适度提升已验证节点的召回权重"})
399
- if bs.get("unresolved_count", 0) > 0:
400
- out.append({"code": "open_questions",
401
- "why": f"unresolved 层有 {bs['unresolved_count']} 个未解问题",
402
- "action": "按 blindspots.items 的顺序优先补条件"})
403
- if not out:
404
- out.append({"code": "stable",
405
- "why": "轨迹 / 校准 / 盲区 / 信任均在阈值内",
406
- "action": "维持当前策略"})
407
- return out
408
-
409
-
410
- # 生效条件:给定 cg 与透传给 trace 的 window(默认 50)时恒定返回 ok=True 且含 trace/calibration/blindspots/trust/advice 的 rec,并以 op="report" 写一条留痕后返回该 rec;
411
- def report(cg, window: int = 50) -> dict:
412
- """完整元认知报告(四观测面 + 确定性建议),并独立留痕。"""
413
- tr = trace(cg, window=window)
414
- cal = calibration(cg)
415
- bs = blindspots(cg)
416
- tt = trust(cg)
417
- advice = _advise(tr, cal, bs, tt)
418
- rec = {
419
- "ok": True,
420
- "trace": tr,
421
- "calibration": cal,
422
- "blindspots": bs,
423
- "trust": tt,
424
- "advice": advice,
425
- "independent": True,
426
- "note": "元认知只观察不改事实:confidence / 资格 / 召回打分均未被本模块修改",
427
- }
428
- _log(cg, {
429
- "op": "report",
430
- "n_reflections": tr.get("n"),
431
- "d_current": tr.get("d_current"),
432
- "emotion": tr.get("emotion"),
433
- "calibration_verdict": cal.get("verdict"),
434
- "gap": cal.get("gap"),
435
- "unresolved_count": bs.get("unresolved_count"),
436
- "p_trust": tt.get("p_trust"),
437
- "advice": [a["code"] for a in advice],
438
- })
439
- return rec
440
-
441
-
442
- # 生效条件:形参 query 经 str(query or "").strip() 为空(含 None、空串、纯空白)时返回 {'ok': False, 'reason': 'empty_query'};相似历史(_jaccard 得分 >= min_sim,默认 0.25,排序后取前 int(k),k 默认 5、k 为 0 时为空)为空时返回 ok=True/warning="no_prior";否则按 BLINDSPOT/DEFER/ACCEPT 计数与 max(1, n//2) 及 prior_d<0.5 判定,返回带 warning/recommendation 的 out;
443
- def self_check(cg, query: str, k: int = 5, min_sim: float = 0.25) -> dict:
444
- """元认知闸门:回答之前先自问「我对这件事的认知状态如何」。
445
-
446
- 不是检索,而是**对检索的预期**:历史相似查询的轨迹决定了这次该
447
- 直接答、先补条件、还是预先声明盲区。
448
- """
449
- q = str(query or "").strip()
450
- if not q:
451
- return {"ok": False, "reason": "empty_query"}
452
- sims = []
453
- for r in _reflections(cg):
454
- rq = str(r.get("query") or "")
455
- if not rq:
456
- continue
457
- s = _jaccard(q, rq)
458
- if s >= min_sim:
459
- sims.append((s, r))
460
- sims.sort(key=lambda x: (-x[0], -float(x[1].get("t") or 0)))
461
- sims = sims[:int(k)]
462
- hist = []
463
- bad = defer = acc = 0
464
- ds = []
465
- for s, r in sims:
466
- st = r.get("states") or {}
467
- b = int(st.get("BLINDSPOT") or 0)
468
- d = int(st.get("DEFER") or 0)
469
- a = int(st.get("ACCEPT") or 0)
470
- bad += b
471
- defer += d
472
- acc += a
473
- if isinstance(r.get("d_curr"), (int, float)):
474
- ds.append(float(r["d_curr"]))
475
- hist.append({"query": r.get("query"), "similarity": round(s, 4),
476
- "d_curr": r.get("d_curr"), "states": st,
477
- "t": r.get("t")})
478
- n = len(hist)
479
- if n == 0:
480
- rec = {"ok": True, "query": q, "prior_attempts": 0,
481
- "similar_history": [],
482
- "expected_confidence": None,
483
- "warning": "no_prior",
484
- "recommendation": "search_then_decide",
485
- "note": "无相似历史:按四态判定正常检索"}
486
- _log(cg, {"op": "self_check", "query": q, "prior_attempts": 0,
487
- "recommendation": rec["recommendation"]})
488
- return rec
489
- prior_d = sum(ds) / len(ds) if ds else None
490
- exp_conf = None if prior_d is None else round(max(0.0, 1.0 - prior_d), 4)
491
- warning = None
492
- if bad >= max(1, n // 2):
493
- warning = "blindspot_likely"
494
- rec_code = "declare_blindspot"
495
- elif defer >= max(1, n // 2):
496
- warning = "conditions_missing"
497
- rec_code = "defer_and_supply_conditions"
498
- elif acc >= max(1, n // 2) and (prior_d is None or prior_d < 0.5):
499
- rec_code = "answer"
500
- else:
501
- rec_code = "search_then_decide"
502
- out = {
503
- "ok": True, "query": q,
504
- "prior_attempts": n,
505
- "similar_history": hist,
506
- "prior_d": None if prior_d is None else round(prior_d, 4),
507
- "expected_confidence": exp_conf,
508
- "prior_blindspot": bad,
509
- "prior_defer": defer,
510
- "prior_accept": acc,
511
- "warning": warning,
512
- "recommendation": rec_code,
513
- }
514
- _log(cg, {"op": "self_check", "query": q, "prior_attempts": n,
515
- "prior_d": out["prior_d"], "warning": warning,
516
- "recommendation": rec_code})
517
- return out
518
-
519
-
520
- # --------------------------------------------------------------------------
521
- # 留痕查询 / 自描述
522
- # --------------------------------------------------------------------------
523
-
524
- # 生效条件:形参 limit(默认 100)为真时取 read_jsonl(os.path.join(cg.root, LOG_FILE)) 的尾部 int(limit) 条,limit 为 0 等假值时保留全部记录,返回 ok=True 与倒序的 records;
525
- def history(cg, limit: int = 100) -> dict:
526
- """元认知留痕(倒序,最新在前)。"""
527
- recs = list(read_jsonl(os.path.join(cg.root, LOG_FILE)))
528
- if limit:
529
- recs = recs[-int(limit):]
530
- return {"ok": True, "n": len(recs), "records": recs[::-1]}
531
-
532
-
533
- # 生效条件:给定 cg 时恒定返回含 n_reflections(tr.get("n", 0))、d_current、emotion、calibration、p_trust、p_gap 的 dict,字段分别取自对 trace(window=20)、calibration、trust(window=50) 的调用结果,缺键按其 .get 回落;
534
- def summary(cg) -> dict:
535
- """一句话元认知状态(供 health / OS 面板使用)。"""
536
- tr = trace(cg, window=20)
537
- cal = calibration(cg)
538
- tt = trust(cg, window=50)
539
- return {
540
- "n_reflections": tr.get("n", 0),
541
- "d_current": tr.get("d_current"),
542
- "emotion": tr.get("emotion"),
543
- "calibration": cal.get("verdict"),
544
- "p_trust": tt.get("p_trust"),
545
- "p_gap": tt.get("p_gap"),
546
- }
547
-
548
-
549
- # 生效条件:cg 必需、window 缺省 200;恒转调 d_meta.compute(cg, window=window) 并原样返回其 dict(三代理 + enabled/window/note),d_meta 导入或计算抛异常时返回 {"ok": False, "error": "类型名: 消息"}(不返回编造数值、不写任何状态);
550
- def d_meta_face(cg, window: int = 200) -> dict:
551
- """D_meta 观测面(边界压力向量):三代理各自 [0,1],**不合成单值**。
552
-
553
- 智能论3.4 §2.7.0 DEV-002/002a:`D_meta` ≠ `D_task`(不参与 `_compute_d`);
554
- 三代理分别观测「进入系统但未被消化」的事件,不是「世界真实未发生的事件」。
555
- 独立性:只读留痕与索引,不写 confidence / 资格 / 召回打分;`MDCG_D_META=0`
556
- 时三值恒 0.0 且 note 声明已回退(显式回退留痕,不是缺键)。
557
- """
558
- try:
559
- from . import d_meta
560
- return d_meta.compute(cg, window=window)
561
- except Exception as exc: # noqa: BLE001
562
- return {"ok": False, "error": "%s: %s" % (type(exc).__name__, exc)}
563
-
564
-
565
- # 生效条件:无入参且无分支,恒定返回含 module/role/theory/faces/constraints 及由模块常量 GAP_OVERCONFIDENT、GAP_UNDERCONFIDENT、BLINDSPOT_DENSE、D_LOW、MIN_SAMPLES 构成的 thresholds 的静态 dict;
566
- def catalog() -> dict:
567
- """自描述:元认知的观测面与独立性约束。"""
568
- return {
569
- "module": "metacognition",
570
- "role": "观察自身认知过程的二阶单元(不参与裁决)",
571
- "theory": {
572
- "emotion": "d²D/dt²(智能论 §十一)",
573
- "feeling": "d²T/dt²(同)",
574
- "units": "五大单元中的反思/验证之外部观察者(§十三)",
575
- "blindspot": "推论三:局部不可知,盲区即知识",
576
- "trust": "P_trust / P_gap(§十)",
577
- },
578
- "faces": ["trace", "calibration", "blindspots", "trust", "report",
579
- "self_check", "d_meta"],
580
- "constraints": [
581
- "只读留痕与索引,不写 confidence / 资格 / 召回打分",
582
- "独立留痕 _metacognition.jsonl(append-only)",
583
- "建议为确定性模板,非 LLM 生成,每条带证据",
584
- ],
585
- "thresholds": {
586
- "gap_overconfident": GAP_OVERCONFIDENT,
587
- "gap_underconfident": GAP_UNDERCONFIDENT,
588
- "blindspot_dense": BLINDSPOT_DENSE,
589
- "d_low": D_LOW,
590
- "min_samples": MIN_SAMPLES,
591
- },
1
+ # -*- coding: utf-8 -*-
2
+ """独立元认知(Metacognition)——观察自身认知过程的二阶单元。
3
+
4
+ 理论出处(本仓原文,非外部知识)
5
+ ------------------------------
6
+ · **情绪 = 信息差的二阶变化 d²D/dt²**(`docs/theory/智能的公理化基石.md` §十一,:412-510):
7
+ 「情绪不是状态本身,而是状态变化的变化」。元认知正是对认知过程做
8
+ 二阶观测的单元:一阶 = 检索结果好坏,二阶 = 认知状态在如何变化。
9
+ · **情感 = 信任的二阶变化 d²T/dt²**(同文档 :469-508)。
10
+ · **五大单元**(同文档 :540-556):反思单元=新 / 验证单元=稳。
11
+ 元认知是这两条通道的**外部观察者**,自身不产出裁决。
12
+ · **推论三 局部不可知**(同文档 :277-288):
13
+ 「知道什么不知道,同样属于知识」——盲区地图是法定输出,不是失败记录。
14
+ · **信任 P_trust / P_gap**(同文档 :393-408)。
15
+ · **导航税**(`docs/theory/智能的认知过程.md`:84-86):维持认知过程一致性需要显式
16
+ 状态记录——元认知就是付这笔税的单元。
17
+
18
+ 独立性的三重含义(本模块的硬约束)
19
+ --------------------------------
20
+ 1. **不参与裁决**:只读留痕与索引,**不写** confidence / 资格 / 召回打分。
21
+ 对齐 `consistency.py` L0 情绪通道纪律:「独立通道,不参与信任计算」。
22
+ 2. **独立留痕**:`_metacognition.jsonl`(append-only,每条可审计)。
23
+ 3. **独立入口**:`report` / `self_check` 可被 MCP / Agent 单独调用。
24
+
25
+ 四个观测面
26
+ ----------
27
+ trace 信息差轨迹 D(t) → dD/dt(方向)→ d²D/dt²(情绪)
28
+ calibration 自信校准:期望正确率 vs 实际验证通过率(过度自信/过度保守)
29
+ blindspots 盲区地图:反复 BLINDSPOT 的查询邻域 + 未解问题
30
+ trust P_gap(信息差置信)+ P_trust(验证稳定置信)+ d²T/dt²(情感)
31
+
32
+ 诚实边界
33
+ --------
34
+ · 所有指标都是**留痕的聚合**,不是对「智能」的断言;样本不足返回
35
+ `insufficient_data`,不编造数值。
36
+ · 建议是**确定性模板**(非 LLM 生成),每条都带触发它的证据(可复核)。
37
+ · 元认知**不修改事实层**——它只建议,执行权归调用方 / verify / forgetting。
38
+ """
39
+
40
+ from __future__ import annotations
41
+
42
+ import hashlib
43
+ import os
44
+ import time
45
+ from collections import Counter
46
+
47
+ from .fsutil import append_jsonl, read_jsonl
48
+ from .security import visible_to
49
+
50
+ LOG_FILE = "_metacognition.jsonl"
51
+
52
+ # ---- 阈值(全部可审计、可调)----
53
+ GAP_OVERCONFIDENT = 0.15 # 过度自信:期望 - 实际 > 此值
54
+ GAP_UNDERCONFIDENT = -0.15 # 过度保守:期望 - 实际 < 此值
55
+ BLINDSPOT_DENSE = 0.30 # 盲区密集:BLINDSPOT 占比 >= 此值
56
+ D_LOW = 0.10 # P_gap:D_norm < 此值视为「信息差已收敛」
57
+ MIN_SAMPLES = 5 # 样本不足 → insufficient_data
58
+ D2_EMOTION = 0.05 # 二阶变化显著阈值
59
+ BINS = ((0.0, 0.4), (0.4, 0.6), (0.6, 0.8), (0.8, 1.01))
60
+ #: issue #121(2026-10-11):越界 confidence 的**抽样可追**上限——返回体给计数 +
61
+ #: 最多这么多个被丢弃 id(全量列表会随库增长无界膨胀;计数面恒完整,故不静默)。
62
+ DROPPED_SAMPLE_MAX = 20
63
+
64
+
65
+ # --------------------------------------------------------------------------
66
+ # 基础工具
67
+ # --------------------------------------------------------------------------
68
+
69
+ # 生效条件:形参 d2 与模块常量 D2_EMOTION 比较——d2 > D2_EMOTION 返回 "avoiding",d2 < -D2_EMOTION 返回 "approaching",其余(含 |d2| 不超过阈值)返回 "stable";
70
+ def _emotion(d2: float) -> str:
71
+ """情绪:d²D/dt² 的符号(智能论 §十一)。"""
72
+ if d2 > D2_EMOTION:
73
+ return "avoiding" # 信息差加速扩大
74
+ if d2 < -D2_EMOTION:
75
+ return "approaching" # 信息差加速收敛
76
+ return "stable"
77
+
78
+
79
+ # 生效条件:形参 q 经 str(q or "") 小写并仅保留字母数字字符得到 s 后,s[:n](n 默认 16,n 为 0 等使前缀为空的取值时前缀为空串)非空则返回该前缀,否则(q 为假值、无字母数字字符或 n 为 0)返回 "(empty)";
80
+ def _key(q, n: int = 16) -> str:
81
+ """查询归一化键(用于盲区聚合 / 相似匹配)。"""
82
+ s = "".join(ch for ch in str(q or "").lower() if ch.isalnum())
83
+ return s[:n] or "(empty)"
84
+
85
+
86
+ # 生效条件:形参 s 经 str(s or "") 并剔除 strip() 为空的字符后长度为 0 时返回 set(),长度为 1 时返回 {s},长度 ≥2 时返回 {s[i:i+2] for i in range(len(s)-1)};
87
+ def _bigrams(s) -> set:
88
+ s = "".join(ch for ch in str(s or "") if ch.strip())
89
+ if len(s) < 2:
90
+ return {s} if s else set()
91
+ return {s[i:i + 2] for i in range(len(s) - 1)}
92
+
93
+
94
+ # 生效条件:形参 a、b 经 _bigrams 处理后任一结果为空集(如 a 或 b 为空、仅含空白字符)时返回 0.0,否则返回两集合交集大小除以并集大小;
95
+ def _jaccard(a, b) -> float:
96
+ A, B = _bigrams(a), _bigrams(b)
97
+ if not A or not B:
98
+ return 0.0
99
+ return len(A & B) / len(A | B)
100
+
101
+
102
+ # 生效条件:形参 s 经 str(s or "").encode("utf-8") 取 sha1 十六进制前 8 位返回(空串也有确定值);
103
+ def _digest(s) -> str:
104
+ """不可逆摘要(#445:台账不落查询原文,只落摘要)。
105
+
106
+ 与 `scrub.py` 的 payload-free 留痕同口径(sha1 前 8 位):审计面可判
107
+ 「两次是不是同一段查询」,但不持有原文。**不是**加密强度——短查询可被
108
+ 字典比对,故本摘要**只入台账**,读面(self_check/blindspots/history 的
109
+ 非授权读者)连摘要也不返回(只回 similarity/states/计数)。
110
+ """
111
+ return hashlib.sha1(str(s or "").encode("utf-8")).hexdigest()[:8]
112
+
113
+
114
+ # 生效条件:cg 无 principal 属性(纯 MdCGOS,无身份/密级模型)时返回 True;principal.can_admin 为真时返回 True(设计者=全局观测本职,与 consistency_history/_readable 同款豁免);否则记录自带 sensitivity 缺失/为空时返回 False(fail-closed:密级不可判即不可读,与 consistency_history「升级前无 sensitivity 键的旧记录一律去原文」同口径),sensitivity 为真值时要求 cg._readable 可调用并委派 security.visible_to(cg, rec)(= cg._readable:clearance × 密级 ∧ 会话绑定;**有 principal 却无判据载体 ⇒ 不可证可见 ⇒ False**,判据异常同样按不可见)。
115
+ def _can_read_record(cg, rec) -> bool:
116
+ """台账记录的读可见性**单点**(#445/#426-D)。
117
+
118
+ 台账(`_reflection.jsonl` / `_metacognition.jsonl`)的记录里没有节点
119
+ `path`,因此**不能**复用 `_readable` 的「密级缺失 → 回读盘面」分支;本
120
+ 函数只做三件事:无身份模型不设限、设计者豁免、其余按记录自带密级走
121
+ `security.visible_to`(复用既有单点,不另写一份 rank/会话判据)。
122
+
123
+ 为什么要自己再判一次 `callable`:`security.visible_to` 在**无钩子**时按
124
+ 「不设限」返回 True(那是给纯 MdCGOS 的口径);本函数走到这一步时已确认
125
+ **有** principal,此时「没有判据载体」不等于「无越权可言」,而是「不可证
126
+ 可见」——按 fail-closed 返回 False(与 `node_visible` 的缺席处置同向)。
127
+ """
128
+ p = getattr(cg, "principal", None)
129
+ if p is None:
130
+ return True # 无身份模型:无「越权」可言
131
+ if getattr(p, "can_admin", False):
132
+ return True
133
+ if not isinstance(rec, dict):
134
+ return False # 非对象行:密级不可判 ⇒ fail-closed
135
+ sens = str((rec or {}).get("sensitivity") or "").strip().lower()
136
+ if not sens:
137
+ return False # 密级不可判 ⇒ fail-closed(宁可少读)
138
+ if not callable(getattr(cg, "_readable", None)):
139
+ return False # 有身份模型但无判据载体 ⇒ 不可证可见
140
+ return visible_to(cg, rec)
141
+
142
+
143
+ # 生效条件:rec 为 dict/None;返回其副本,并把 query/query_digest/query_len 三键一并摘除后置 query_redacted=True(无 query 键时原样复制、不加标记);
144
+ def _redact_query(rec) -> dict:
145
+ """读面去原文:低权读者只回 similarity/states/计数,不回落原文(#445)。
146
+
147
+ `query_digest` 一并摘除:摘要虽不可逆,但对短查询构成**确认型旁路**
148
+ (猜一句、比一次摘要),故只在台账落盘、不在读面透出。
149
+ """
150
+ if not isinstance(rec, dict):
151
+ return rec # 非对象行原样(无可摘的键面)
152
+ out = dict(rec or {})
153
+ if "query" in out or "query_digest" in out or "query_len" in out:
154
+ out.pop("query", None)
155
+ out.pop("query_digest", None)
156
+ out.pop("query_len", None)
157
+ out["query_redacted"] = True
158
+ return out
159
+
160
+
161
+ # 生效条件:形参 rec 被复制并 setdefault("t", time.time()) 后,向 os.path.join(cg.root, LOG_FILE) 追加写入抛 OSError 时静默跳过,两类情形均返回补过 t 的 rec 副本;cg.principal 存在且 can_write 为假时**不写盘**(只算不留痕,#426-D D3:不可写身份不得持久追加台账);写入前把 query 原文换成 query_digest(sha1 前 8 位)+ query_len,台账不落原文(#445)。
162
+ def _log(cg, rec: dict) -> dict:
163
+ """独立留痕(append-only)。失败不阻塞主流程。"""
164
+ rec = dict(rec)
165
+ rec.setdefault("t", time.time())
166
+ # #445:台账只落「键名 + 不可逆摘要」,查询原文留在调用方上下文。
167
+ # 先摘再判写闸:本函数的返回值也不得携带原文(同一判据不因分支顺序漂移)。
168
+ if "query" in rec:
169
+ _q = rec.pop("query")
170
+ rec["query_digest"] = _digest(_q)
171
+ rec["query_len"] = len(str(_q or ""))
172
+ rec["query_redacted"] = True
173
+ # #426-D D3:无写权限的身份(无令牌访客等)不得经 self_check/report
174
+ # 持久追加台账——修前访客 10 次 self_check 把台账灌大 60KB。
175
+ _p = getattr(cg, "principal", None)
176
+ if _p is not None and not getattr(_p, "can_write", True):
177
+ return rec
178
+ try:
179
+ # #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
180
+ # 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
181
+ # (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
182
+ _ok = append_jsonl(os.path.join(cg.root, LOG_FILE), rec)
183
+ except OSError:
184
+ pass
185
+ return rec
186
+
187
+
188
+ # 生效条件:形参 cg 的 reflection_log 属性缺失或为假值时回落到 os.path.join(cg.root, "_reflection.jsonl"),返回该路径 read_jsonl 结果中**读可见**的记录 list——逐条经 _can_read_record(无身份模型/设计者不设限;其余读者:缺 sensitivity 键 fail-closed 剔除、有密级经 security.visible_to 判 clearance × 会话绑定);不可见记录**连计数都不进**(宁可少读);
189
+ def _reflections(cg) -> list:
190
+ """反思台账的**唯一读取点**(#445:可见性判据收在这里,不在各读面各写一份)。
191
+
192
+ 为什么把闸放在这里而不是各消费点:`_reflection.jsonl` 有**四个**读面——
193
+ `trace` / `trust`(纯数值)、`blindspots` / `self_check`(带 query 文本)、
194
+ `autonomy.proposals`(带 query 文本,经 `cg(op=insight, action=explore)`
195
+ 对 insight op 暴露)。修前只有前两者被逐面加过过滤,`autonomy` 直接读
196
+ `_reflections` 原样把原文放进 `proposals[].query`(复核实测 role=output
197
+ 可读回属主查询原文)。判据放在**读取单点**,新读面自动继承;各消费点
198
+ 不再各写一份(本仓反复栽过的「同一判据两份」形态)。
199
+
200
+ 口径:`reflect()` 写台账时**恒不带 sensitivity 键**(md_cg/mdcg.py:5364-5375),
201
+ 故对非设计者这是**全量 fail-closed**——低权读者读不到任何反思记录(含
202
+ trace/trust 的数值面)。这是刻意的「宁可少读」:记录密级不可判时,连
203
+ 「有几条、相似度多少」都是原文的派生信息(issue #445 已证模糊猜测可钓出
204
+ 原文)。设计者(can_admin)与纯 MdCGOS(无 principal)读数不变。
205
+ """
206
+ path = getattr(cg, "reflection_log", "") or os.path.join(
207
+ cg.root, "_reflection.jsonl")
208
+ return [r for r in read_jsonl(path) if _can_read_record(cg, r)]
209
+
210
+
211
+ # 生效条件:形参 cg 的 index 属性缺失或为假值、或其 "nodes" 键缺失、或该键值为假值(如空 dict)时返回 {},否则返回该 "nodes" 值;
212
+ def _nodes(cg) -> dict:
213
+ return (getattr(cg, "index", None) or {}).get("nodes") or {}
214
+
215
+
216
+ # 生效条件:形参 cg 的 get(nid) 为假值、或其结果缺 "frontmatter" 键、或该键值为假值时返回 {},否则返回该 node 的 frontmatter;
217
+ def _fm(cg, nid) -> dict:
218
+ node = cg.get(nid) or {}
219
+ return node.get("frontmatter") or {}
220
+
221
+
222
+ # --------------------------------------------------------------------------
223
+ # 观测面 1:信息差轨迹(D / dD / d²D)
224
+ # --------------------------------------------------------------------------
225
+
226
+ # 生效条件:形参 cg 的反思留痕中不存在 d_curr 为 int/float 的记录时返回 ok=False/insufficient_data/n=0;否则按 window(默认 50,window 为假值 0 时取全部记录)截取尾部计算,返回 ok=True 及 d_current、d1、由 d1 与 ±0.01 判定的 trend(converging/diverging/flat)等字段;
227
+ def trace(cg, window: int = 50) -> dict:
228
+ """信息差轨迹:D(t) → dD/dt(方向)→ d²D/dt²(情绪)。
229
+
230
+ 数据源:`_reflection.jsonl`(reflect() 的留痕),不新增计算负担。
231
+ """
232
+ recs = [r for r in _reflections(cg)
233
+ if isinstance(r.get("d_curr"), (int, float))]
234
+ if not recs:
235
+ return {"ok": False, "reason": "insufficient_data", "n": 0,
236
+ "note": "无反思留痕:先调用 reflect() 才有轨迹"}
237
+ tail = recs[-int(window):] if window else recs
238
+ ds = [float(r["d_curr"]) for r in tail]
239
+ n = len(ds)
240
+ d1 = (ds[-1] - ds[0]) / max(1, n - 1)
241
+ d2 = float(tail[-1].get("d2") or 0.0)
242
+ states = Counter()
243
+ for r in tail:
244
+ for k, v in (r.get("states") or {}).items():
245
+ try:
246
+ states[str(k)] += int(v or 0)
247
+ except (TypeError, ValueError):
248
+ continue
249
+ total = sum(states.values()) or 1
250
+ return {
251
+ "ok": True, "n": n,
252
+ "d_current": round(ds[-1], 4),
253
+ "d_mean": round(sum(ds) / n, 4),
254
+ "d_min": round(min(ds), 4),
255
+ "d_max": round(max(ds), 4),
256
+ "d1": round(d1, 4),
257
+ "d2": round(d2, 4),
258
+ "emotion": _emotion(d2),
259
+ "trend": ("converging" if d1 < -0.01 else
260
+ "diverging" if d1 > 0.01 else "flat"),
261
+ "states": dict(states),
262
+ "state_rates": {k: round(v / total, 4) for k, v in states.items()},
263
+ "d_series": [round(x, 4) for x in ds[-20:]],
264
+ }
265
+
266
+
267
+ # --------------------------------------------------------------------------
268
+ # 观测面 2:自信校准(期望正确率 vs 实际验证通过率)
269
+ # --------------------------------------------------------------------------
270
+
271
+ # 生效条件:形参 cg 的 index.nodes 中满足 evidence_count>0 且 frontmatter 的正例+负例>0 的节点计数 used,在 used >= int(max_scan)(默认 2000,max_scan 为 0 时立即 break 使 used=0)时截断——used 为 0 返回 ok=False/insufficient_data,否则按 used 与常量 MIN_SAMPLES、期望减实际的 gap 与 GAP_OVERCONFIDENT/GAP_UNDERCONFIDENT 判定 verdict(insufficient_data/overconfident/underconfident/calibrated);
272
+ def calibration(cg, max_scan: int = 2000) -> dict:
273
+ """自信校准:我说的可信吗?
274
+
275
+ 期望正确率 = 节点 confidence 均值;
276
+ 实际正确率 = Σ正例 / Σ(正例+负例)(来自 evidence_log 的聚合计数)。
277
+ gap > 0 → 过度自信;gap < 0 → 过度保守。
278
+ ECE = Σ(证据占比 × |桶内实际 - 桶内自信|)(期望校准误差)。
279
+ """
280
+ keys = [f"{lo:g}-{hi:g}" for lo, hi in BINS]
281
+ buckets = {k: {"n": 0, "conf_sum": 0.0, "pos": 0, "neg": 0} for k in keys}
282
+ exp_sum = 0.0
283
+ used = 0
284
+ total_pos = total_neg = 0
285
+ # issue #121(2026-10-11):**越界 confidence 不再静默丢弃**。
286
+ # 修前:conf 落在 BINS 覆盖域([0, 1.01))之外的节点照计 used/exp_sum/
287
+ # total_pos/total_neg(进分母),却因不落任何桶而对 ECE 分子零贡献 ⇒ ECE 被
288
+ # 系统性低估;且 n_nodes 与 Σbins.n_nodes 对不上而无人报。
289
+ # 现逐条记账并透出,**不变量**:n_nodes == Σbins.n_nodes + dropped。
290
+ # 口径不变:越界节点照旧进 used/exp_sum/总证据(分母口径一字不改),
291
+ # 只把「没进桶」这件事从静默变成可观测。
292
+ dropped_count = 0
293
+ dropped_ids = []
294
+ for nid, e in _nodes(cg).items():
295
+ if used >= int(max_scan):
296
+ break
297
+ if int(e.get("evidence_count") or 0) <= 0:
298
+ continue
299
+ fm = _fm(cg, nid)
300
+ pos = int(fm.get("positive_evidence") or 0)
301
+ neg = int(fm.get("negative_evidence") or 0)
302
+ if pos + neg <= 0:
303
+ continue
304
+ conf = float(fm.get("confidence", 0.6))
305
+ used += 1
306
+ exp_sum += conf
307
+ total_pos += pos
308
+ total_neg += neg
309
+ placed = False
310
+ for lo, hi in BINS:
311
+ if lo <= conf < hi:
312
+ b = buckets[f"{lo:g}-{hi:g}"]
313
+ b["n"] += 1
314
+ b["conf_sum"] += conf
315
+ b["pos"] += pos
316
+ b["neg"] += neg
317
+ placed = True
318
+ break
319
+ if not placed:
320
+ # 越界(conf < 0 或 conf >= BINS 覆盖上界 1.01):计 dropped 并抽样留 id。
321
+ # 注意判据是 lo <= conf < hi,上界 1.01 已把 conf==1.0 正常覆盖。
322
+ dropped_count += 1
323
+ if len(dropped_ids) < DROPPED_SAMPLE_MAX:
324
+ dropped_ids.append(nid)
325
+ if used == 0:
326
+ return {"ok": False, "reason": "insufficient_data", "n_nodes": 0,
327
+ "dropped": 0, "out_of_range": 0, "dropped_ids": [],
328
+ "dropped_ids_truncated": False,
329
+ "note": "无带证据的节点:先 verify() 积累验证记录"}
330
+ expected = exp_sum / used
331
+ actual = total_pos / max(1, total_pos + total_neg)
332
+ gap = expected - actual
333
+ bins = []
334
+ ece = 0.0
335
+ total_ev = total_pos + total_neg
336
+ for k in keys:
337
+ b = buckets[k]
338
+ if b["n"] == 0:
339
+ continue
340
+ n_ev = b["pos"] + b["neg"]
341
+ conf_b = b["conf_sum"] / b["n"]
342
+ acc_b = (b["pos"] / n_ev) if n_ev else None
343
+ bins.append({"bin": k, "n_nodes": b["n"], "n_evidence": n_ev,
344
+ "confidence": round(conf_b, 4),
345
+ "accuracy": None if acc_b is None else round(acc_b, 4)})
346
+ if n_ev and total_ev:
347
+ ece += (n_ev / total_ev) * abs(conf_b - acc_b)
348
+ if used < MIN_SAMPLES:
349
+ verdict = "insufficient_data"
350
+ elif gap > GAP_OVERCONFIDENT:
351
+ verdict = "overconfident"
352
+ elif gap < GAP_UNDERCONFIDENT:
353
+ verdict = "underconfident"
354
+ else:
355
+ verdict = "calibrated"
356
+ return {
357
+ "ok": True, "n_nodes": used,
358
+ # issue #121:可观测面——**越界丢弃**的计数与抽样 id(不静默)。
359
+ # dropped 是不变量的加数项(今日唯一丢因即越界;将来新增丢因须并入此数)。
360
+ "dropped": dropped_count,
361
+ "out_of_range": dropped_count,
362
+ "dropped_ids": list(dropped_ids),
363
+ "dropped_ids_truncated": dropped_count > len(dropped_ids),
364
+ "n_evidence": total_ev,
365
+ "expected_accuracy": round(expected, 4),
366
+ "actual_accuracy": round(actual, 4),
367
+ "gap": round(gap, 4),
368
+ "ece": round(ece, 4),
369
+ "verdict": verdict,
370
+ "bins": bins,
371
+ }
372
+
373
+
374
+ # --------------------------------------------------------------------------
375
+ # 观测面 3:盲区地图(我知道我不知道什么)
376
+ # --------------------------------------------------------------------------
377
+
378
+ # 生效条件:形参 cg 的反思留痕由 _reflections 给出(**已按读可见性过滤**——单点在读取面,本函数不另写第二份判据),再按 window(默认 200,window 为 0 时切片 [0:] 取全部)截尾,聚合其中 BLINDSPOT/DEFER 计数非零且 query 非空的记录(计数转换失败则跳过该条);返回 ok=True,items 与 unresolved 各取前 int(limit)(limit 默认 20,limit 为 0 时两项均为空列表),unresolved_count 为未截断的完整计数;
379
+ def blindspots(cg, limit: int = 20, window: int = 200) -> dict:
380
+ """盲区地图:反复 BLINDSPOT / DEFER 的查询邻域 + 未解问题清单。
381
+
382
+ 智能论推论三:盲区不是失败记录,是知识。因此按**邻域聚合**输出,
383
+ 可直接驱动 unresolved 层建节点(补条件)。
384
+
385
+ #445:items 里的 `query` 是调用方查询原文——可见性判据在 `_reflections`
386
+ (台账唯一读取点),不可见记录连计数都不进(宁可少读)。无身份模型
387
+ (纯 MdCGOS)与设计者不受限,既有调用方读数不变。
388
+ """
389
+ recs = _reflections(cg)[-int(window):]
390
+ agg = {}
391
+ for r in recs:
392
+ st = r.get("states") or {}
393
+ try:
394
+ bad = int(st.get("BLINDSPOT") or 0)
395
+ defer = int(st.get("DEFER") or 0)
396
+ except (TypeError, ValueError):
397
+ continue
398
+ if not bad and not defer:
399
+ continue
400
+ q = str(r.get("query") or "").strip()
401
+ if not q:
402
+ continue
403
+ k = _key(q)
404
+ a = agg.setdefault(k, {"query": q, "blindspot": 0, "defer": 0,
405
+ "samples": 0, "last_t": 0.0})
406
+ a["blindspot"] += bad
407
+ a["defer"] += defer
408
+ a["samples"] += 1
409
+ a["last_t"] = max(a["last_t"], float(r.get("t") or 0.0))
410
+ items = sorted(agg.values(),
411
+ key=lambda x: (-x["blindspot"], -x["defer"], -x["last_t"]))
412
+ unresolved = []
413
+ for nid, e in _nodes(cg).items():
414
+ if e.get("layer") == "unresolved":
415
+ unresolved.append({"node_id": nid,
416
+ "content": str((cg.get(nid) or {}).get("content") or "")[:200]})
417
+ return {
418
+ "ok": True,
419
+ "n_queries": len(agg),
420
+ "items": items[:int(limit)],
421
+ "unresolved": unresolved[:int(limit)],
422
+ "unresolved_count": len(unresolved),
423
+ }
424
+
425
+
426
+ # --------------------------------------------------------------------------
427
+ # 观测面 4:信任(P_gap / P_trust / 情感)
428
+ # --------------------------------------------------------------------------
429
+
430
+ # 生效条件:形参 events 为假值(空容器)时返回 0.0,否则返回其中等于 "confirmed" 的元素个数除以 events 长度;
431
+ def _rate(events) -> float:
432
+ if not events:
433
+ return 0.0
434
+ return sum(1 for v in events if v == "confirmed") / len(events)
435
+
436
+
437
+ # 生效条件:形参 cg 的反思留痕中 d_curr 为数值的序列按 window(默认 100,window 为 0 时切片 [0:] 取全部)截尾得 p_gap(截尾结果为空则为 None);取自 evidence_count>0 的节点的验证事件(扫描数受 int(max_scan) 上限、默认 2000,按 window 同样规则截尾)为空时返回 p_trust=None/emotion=None 分支,否则按三段 confirmed 通过率差返回 d1、d2、emotion 与 verdicts;
438
+ def trust(cg, window: int = 100, max_scan: int = 2000) -> dict:
439
+ """P_gap(信息差置信)+ P_trust(验证稳定置信)+ d²T/dt²(情感)。
440
+
441
+ P_gap = 近期反思中 D_norm < D_LOW 的比例(信息差已收敛 = 有把握);
442
+ P_trust = 近期验证事件中 confirmed 的占比(智能论 §十);
443
+ d²T/dt² = 三段验证通过率差的二阶差分(情感 = 信任的二阶变化)。
444
+ """
445
+ recs = _reflections(cg)
446
+ ds = [float(r["d_curr"]) for r in recs
447
+ if isinstance(r.get("d_curr"), (int, float))]
448
+ recent_d = ds[-int(window):]
449
+ p_gap = (round(sum(1 for d in recent_d if d < D_LOW) / len(recent_d), 4)
450
+ if recent_d else None)
451
+
452
+ events = []
453
+ used = 0
454
+ for nid, e in _nodes(cg).items():
455
+ if used >= int(max_scan):
456
+ break
457
+ if int(e.get("evidence_count") or 0) <= 0:
458
+ continue
459
+ used += 1
460
+ for ev in (_fm(cg, nid).get("evidence_log") or []):
461
+ if isinstance(ev, dict) and ev.get("verdict"):
462
+ events.append((float(ev.get("t") or 0.0), str(ev["verdict"])))
463
+ events.sort()
464
+ tail = events[-int(window):] if window else events
465
+ n = len(tail)
466
+ if not n:
467
+ return {"ok": True, "p_gap": p_gap, "p_trust": None,
468
+ "emotion": None, "n_events": 0,
469
+ "note": "无验证留痕:先 verify() 才有信任轨迹"}
470
+ verdicts = [v for _, v in tail]
471
+ p_trust = round(_rate(verdicts), 4)
472
+ seg = max(1, n // 3)
473
+ s1 = _rate(verdicts[:seg])
474
+ s2 = _rate(verdicts[seg:2 * seg]) if n > seg else s1
475
+ s3 = _rate(verdicts[2 * seg:]) if n > 2 * seg else s2
476
+ d1 = s2 - s1
477
+ d2 = (s3 - s2) - (s2 - s1)
478
+ return {
479
+ "ok": True,
480
+ "p_gap": p_gap,
481
+ "p_trust": p_trust,
482
+ "d1": round(d1, 4),
483
+ "d2": round(d2, 4),
484
+ "emotion": _emotion(d2),
485
+ "n_events": n,
486
+ "verdicts": dict(Counter(verdicts)),
487
+ }
488
+
489
+
490
+ # --------------------------------------------------------------------------
491
+ # 自报告:汇总 + 确定性建议
492
+ # --------------------------------------------------------------------------
493
+
494
+ # 生效条件:形参 tr.get("ok") 为假时产出 no_trace;否则按 tr["d2"] > D2_EMOTION 产出 diverging、state_rates["BLINDSPOT"] >= BLINDSPOT_DENSE 产出 blindspot_dense;再按 cal 的 verdict 为 overconfident/underconfident 与 bs.get("unresolved_count", 0) > 0 各自追加;全部未触发时返回单条 stable(形参 tt 在函数体内未被使用);
495
+ def _advise(tr, cal, bs, tt) -> list:
496
+ """确定性建议(非 LLM):每条都带触发它的证据,可复核。"""
497
+ out = []
498
+ if not tr.get("ok"):
499
+ out.append({"code": "no_trace",
500
+ "why": "无反思留痕,无法评估认知轨迹",
501
+ "action": "先调用 reflect() 积累轨迹"})
502
+ else:
503
+ rates = tr.get("state_rates") or {}
504
+ if tr["d2"] > D2_EMOTION:
505
+ out.append({"code": "diverging",
506
+ "why": f"信息差加速扩大 d²D/dt²={tr['d2']}(emotion={tr['emotion']})",
507
+ "action": "回到最近一次 DEFER 的缺失条件,先补条件再扩张"})
508
+ if float(rates.get("BLINDSPOT") or 0) >= BLINDSPOT_DENSE:
509
+ out.append({"code": "blindspot_dense",
510
+ "why": f"BLINDSPOT 占比 {rates.get('BLINDSPOT')} >= {BLINDSPOT_DENSE}",
511
+ "action": "为高频盲区邻域建 unresolved 节点,驱动补条件"})
512
+ verdict = cal.get("verdict")
513
+ if verdict == "overconfident":
514
+ out.append({"code": "overconfident",
515
+ "why": (f"期望正确率 {cal['expected_accuracy']} > 实际 "
516
+ f"{cal['actual_accuracy']}(gap {cal['gap']})"),
517
+ "action": "对高 confidence 节点抽查复核;verify(weakened) 会触发降级"})
518
+ elif verdict == "underconfident":
519
+ out.append({"code": "underconfident",
520
+ "why": (f"期望正确率 {cal['expected_accuracy']} < 实际 "
521
+ f"{cal['actual_accuracy']}(gap {cal['gap']})"),
522
+ "action": "自信偏低:可适度提升已验证节点的召回权重"})
523
+ if bs.get("unresolved_count", 0) > 0:
524
+ out.append({"code": "open_questions",
525
+ "why": f"unresolved 层有 {bs['unresolved_count']} 个未解问题",
526
+ "action": "按 blindspots.items 的顺序优先补条件"})
527
+ if not out:
528
+ out.append({"code": "stable",
529
+ "why": "轨迹 / 校准 / 盲区 / 信任均在阈值内",
530
+ "action": "维持当前策略"})
531
+ return out
532
+
533
+
534
+ # 生效条件:给定 cg 与透传给 trace 的 window(默认 50)时恒定返回 ok=True 且含 trace/calibration/blindspots/trust/advice 的 rec,并以 op="report" 写一条留痕后返回该 rec;
535
+ def report(cg, window: int = 50) -> dict:
536
+ """完整元认知报告(四观测面 + 确定性建议),并独立留痕。"""
537
+ tr = trace(cg, window=window)
538
+ cal = calibration(cg)
539
+ bs = blindspots(cg)
540
+ tt = trust(cg)
541
+ advice = _advise(tr, cal, bs, tt)
542
+ rec = {
543
+ "ok": True,
544
+ "trace": tr,
545
+ "calibration": cal,
546
+ "blindspots": bs,
547
+ "trust": tt,
548
+ "advice": advice,
549
+ "independent": True,
550
+ "note": "元认知只观察不改事实:confidence / 资格 / 召回打分均未被本模块修改",
551
+ }
552
+ _log(cg, {
553
+ "op": "report",
554
+ "n_reflections": tr.get("n"),
555
+ "d_current": tr.get("d_current"),
556
+ "emotion": tr.get("emotion"),
557
+ "calibration_verdict": cal.get("verdict"),
558
+ "gap": cal.get("gap"),
559
+ "unresolved_count": bs.get("unresolved_count"),
560
+ "p_trust": tt.get("p_trust"),
561
+ "advice": [a["code"] for a in advice],
562
+ })
563
+ return rec
564
+
565
+
566
+ # 生效条件:形参 query 经 str(query or "").strip() 为空(含 None、空串、纯空白)时返回 {'ok': False, 'reason': 'empty_query'};相似历史(_jaccard 得分 >= min_sim,默认 0.25,排序后取前 int(k),k 默认 5、k 为 0 时为空)为空时返回 ok=True/warning="no_prior";否则按 BLINDSPOT/DEFER/ACCEPT 计数与 max(1, n//2) 及 prior_d<0.5 判定,返回带 warning/recommendation 的 out;
567
+ def self_check(cg, query: str, k: int = 5, min_sim: float = 0.25) -> dict:
568
+ """元认知闸门:回答之前先自问「我对这件事的认知状态如何」。
569
+
570
+ 不是检索,而是**对检索的预期**:历史相似查询的轨迹决定了这次该
571
+ 直接答、先补条件、还是预先声明盲区。
572
+ """
573
+ q = str(query or "").strip()
574
+ if not q:
575
+ return {"ok": False, "reason": "empty_query"}
576
+ sims = []
577
+ for r in _reflections(cg):
578
+ rq = str(r.get("query") or "")
579
+ if not rq:
580
+ continue
581
+ s = _jaccard(q, rq)
582
+ if s >= min_sim:
583
+ sims.append((s, r))
584
+ sims.sort(key=lambda x: (-x[0], -float(x[1].get("t") or 0)))
585
+ sims = sims[:int(k)]
586
+ hist = []
587
+ bad = defer = acc = 0
588
+ ds = []
589
+ for s, r in sims:
590
+ st = r.get("states") or {}
591
+ b = int(st.get("BLINDSPOT") or 0)
592
+ d = int(st.get("DEFER") or 0)
593
+ a = int(st.get("ACCEPT") or 0)
594
+ bad += b
595
+ defer += d
596
+ acc += a
597
+ if isinstance(r.get("d_curr"), (int, float)):
598
+ ds.append(float(r["d_curr"]))
599
+ # #445:可见性判据在 `_reflections`(台账唯一读取点)——走到这里的
600
+ # 记录**都已通过** `_can_read_record`,故原文可原样回给读者;不可见
601
+ # 记录根本不进 sims(连 similarity/计数都不回:对短查询,相似度与
602
+ # 条数本身就是原文的派生信息,issue #445 已证模糊猜测可钓出全文)。
603
+ hist.append({"query": r.get("query"), "similarity": round(s, 4),
604
+ "d_curr": r.get("d_curr"), "states": st,
605
+ "t": r.get("t")})
606
+ n = len(hist)
607
+ if n == 0:
608
+ rec = {"ok": True, "query": q, "prior_attempts": 0,
609
+ "similar_history": [],
610
+ "expected_confidence": None,
611
+ "warning": "no_prior",
612
+ "recommendation": "search_then_decide",
613
+ "note": "无相似历史:按四态判定正常检索"}
614
+ _log(cg, {"op": "self_check", "query": q, "prior_attempts": 0,
615
+ "recommendation": rec["recommendation"]})
616
+ return rec
617
+ prior_d = sum(ds) / len(ds) if ds else None
618
+ exp_conf = None if prior_d is None else round(max(0.0, 1.0 - prior_d), 4)
619
+ warning = None
620
+ if bad >= max(1, n // 2):
621
+ warning = "blindspot_likely"
622
+ rec_code = "declare_blindspot"
623
+ elif defer >= max(1, n // 2):
624
+ warning = "conditions_missing"
625
+ rec_code = "defer_and_supply_conditions"
626
+ elif acc >= max(1, n // 2) and (prior_d is None or prior_d < 0.5):
627
+ rec_code = "answer"
628
+ else:
629
+ rec_code = "search_then_decide"
630
+ out = {
631
+ "ok": True, "query": q,
632
+ "prior_attempts": n,
633
+ "similar_history": hist,
634
+ "prior_d": None if prior_d is None else round(prior_d, 4),
635
+ "expected_confidence": exp_conf,
636
+ "prior_blindspot": bad,
637
+ "prior_defer": defer,
638
+ "prior_accept": acc,
639
+ "warning": warning,
640
+ "recommendation": rec_code,
641
+ }
642
+ _log(cg, {"op": "self_check", "query": q, "prior_attempts": n,
643
+ "prior_d": out["prior_d"], "warning": warning,
644
+ "recommendation": rec_code})
645
+ return out
646
+
647
+
648
+ # --------------------------------------------------------------------------
649
+ # 留痕查询 / 自描述
650
+ # --------------------------------------------------------------------------
651
+
652
+ # 生效条件:形参 limit(默认 100)为真时取 read_jsonl(os.path.join(cg.root, LOG_FILE)) 的尾部 int(limit) 条,limit 为 0 等假值时保留全部记录;逐条按 _can_read_record 过滤——可见记录原样返回,不可见记录经 _redact_query 去原文(query/query_digest/query_len 摘除并置 query_redacted=True);返回 ok=True 与倒序的 records;
653
+ def history(cg, limit: int = 100) -> dict:
654
+ """元认知留痕(倒序,最新在前)。
655
+
656
+ #426-D:`_metacognition.jsonl` 是全库共享台账,修前 history 整行倒序返回,
657
+ 无令牌访客可读到属主 self_check 的查询原文。现按读可见性单点
658
+ `_can_read_record` 过滤:无身份模型/设计者原样;其余读者对缺 sensitivity
659
+ 键(升级前旧记录)与超密级记录一律去原文。
660
+ """
661
+ recs = list(read_jsonl(os.path.join(cg.root, LOG_FILE)))
662
+ if limit:
663
+ recs = recs[-int(limit):]
664
+ recs = [r if _can_read_record(cg, r) else _redact_query(r) for r in recs]
665
+ return {"ok": True, "n": len(recs), "records": recs[::-1]}
666
+
667
+
668
+ # 生效条件:给定 cg 时恒定返回含 n_reflections(tr.get("n", 0))、d_current、emotion、calibration、p_trust、p_gap 的 dict,字段分别取自对 trace(window=20)、calibration、trust(window=50) 的调用结果,缺键按其 .get 回落;
669
+ def summary(cg) -> dict:
670
+ """一句话元认知状态(供 health / OS 面板使用)。"""
671
+ tr = trace(cg, window=20)
672
+ cal = calibration(cg)
673
+ tt = trust(cg, window=50)
674
+ return {
675
+ "n_reflections": tr.get("n", 0),
676
+ "d_current": tr.get("d_current"),
677
+ "emotion": tr.get("emotion"),
678
+ "calibration": cal.get("verdict"),
679
+ "p_trust": tt.get("p_trust"),
680
+ "p_gap": tt.get("p_gap"),
681
+ }
682
+
683
+
684
+ # 生效条件:cg 必需、window 缺省 200;恒转调 d_meta.compute(cg, window=window) 并原样返回其 dict(三代理 + enabled/window/note),d_meta 导入或计算抛异常时返回 {"ok": False, "error": "类型名: 消息"}(不返回编造数值、不写任何状态);
685
+ def d_meta_face(cg, window: int = 200) -> dict:
686
+ """D_meta 观测面(边界压力向量):三代理各自 [0,1],**不合成单值**。
687
+
688
+ 智能论3.4 §2.7.0 DEV-002/002a:`D_meta` ≠ `D_task`(不参与 `_compute_d`);
689
+ 三代理分别观测「进入系统但未被消化」的事件,不是「世界真实未发生的事件」。
690
+ 独立性:只读留痕与索引,不写 confidence / 资格 / 召回打分;`MDCG_D_META=0`
691
+ 时三值恒 0.0 且 note 声明已回退(显式回退留痕,不是缺键)。
692
+ """
693
+ try:
694
+ from . import d_meta
695
+ return d_meta.compute(cg, window=window)
696
+ except Exception as exc: # noqa: BLE001
697
+ return {"ok": False, "error": "%s: %s" % (type(exc).__name__, exc)}
698
+
699
+
700
+ # 生效条件:无入参且无分支,恒定返回含 module/role/theory/faces/constraints 及由模块常量 GAP_OVERCONFIDENT、GAP_UNDERCONFIDENT、BLINDSPOT_DENSE、D_LOW、MIN_SAMPLES 构成的 thresholds 的静态 dict;
701
+ def catalog() -> dict:
702
+ """自描述:元认知的观测面与独立性约束。"""
703
+ return {
704
+ "module": "metacognition",
705
+ "role": "观察自身认知过程的二阶单元(不参与裁决)",
706
+ "theory": {
707
+ "emotion": "d²D/dt²(智能论 §十一)",
708
+ "feeling": "d²T/dt²(同)",
709
+ "units": "五大单元中的反思/验证之外部观察者(§十三)",
710
+ "blindspot": "推论三:局部不可知,盲区即知识",
711
+ "trust": "P_trust / P_gap(§十)",
712
+ },
713
+ "faces": ["trace", "calibration", "blindspots", "trust", "report",
714
+ "self_check", "d_meta"],
715
+ "constraints": [
716
+ "只读留痕与索引,不写 confidence / 资格 / 召回打分",
717
+ "独立留痕 _metacognition.jsonl(append-only)",
718
+ "建议为确定性模板,非 LLM 生成,每条带证据",
719
+ ],
720
+ "thresholds": {
721
+ "gap_overconfident": GAP_OVERCONFIDENT,
722
+ "gap_underconfident": GAP_UNDERCONFIDENT,
723
+ "blindspot_dense": BLINDSPOT_DENSE,
724
+ "d_low": D_LOW,
725
+ "min_samples": MIN_SAMPLES,
726
+ },
592
727
  }