@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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