@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  531. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  535. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  539. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  543. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  547. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  548. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  549. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  550. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  551. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  552. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  553. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  554. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  559. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  563. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  564. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  565. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  566. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  567. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  568. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  569. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  570. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  571. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  572. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/md_cg/identity.py CHANGED
@@ -1,391 +1,573 @@
1
- # -*- coding: utf-8 -*-
2
- """身份特征识别(Identity Traits)——不止「用户画像」,而是「主体身份 × 位置效应 × 条件特征」。
3
-
4
- 理论出处
5
- --------
6
- · 智能论 v3.4 §十三「五大单元」·位置效应(`docs/theory/智能的公理化基石.md:540-556`):
7
-
8
- 单元 位置效应 核心职责
9
- 记录单元 全 保存观测、过程、结果和误差
10
- 反思单元 新 发现差异、遗漏条件和新路径
11
- 验证单元 稳 判断规则、执行结果和结构是否有效
12
- 输出单元 通 与外部系统协作并表达边界
13
- 维生系统 存 维护存在、预算、回滚和整体结构
14
-
15
- 「位置效应」= 主体处在系统什么位置,就承担什么职责、表现出什么特征。
16
- 所以「画像」不该只刻画用户,而应识别**每个主体的身份锚点 + 位置 + 特征**,
17
- 其中也包括智能体自身(self)。
18
-
19
- · 扮演论 v3.3(`README.md:231-271`、`docs/mdcg/tool_table_v0.3.0.md:86-92`):
20
- 智能即扮演;角色卡 = 条件空间声明起点;三接口 =
21
- memory(历史 → 知识层)/
22
- anchor(自我锚点 → SELF 层,不可遗忘)/
23
- values(特化价值观 → STRUCTURE 层,带条件空间,条件空间即触发时机)。
24
- 边界:角色人设 ≠ 灵枢自身锚点(后者在 self 层,需设计者验证)。
25
-
26
- 模型
27
- ----
28
- subject = {subject_id, kind, position, anchor, traits}
29
- subject_id : "self:lingshu" / "user:alice" / "role:whale" / "agent:coder"
30
- kind : self | user | role | agent
31
- position : record | reflect | verify | output | sustain | unknown
32
- anchor : 身份锚点(不可遗忘;kind≠self 一律落 anchor 层)
33
- traits : 条件触发的特征条目(条件空间 = 触发时机,带重要度)
34
-
35
- 诚实边界
36
- --------
37
- · position 是**推断**(`infer_position` 按行为证据投票),返回 confidence / votes /
38
- 证据数,可审计「为什么判成这个位置」,不是事实断言。
39
- · 平票时 position 取 `POSITION_ORDER` 中的首个并置 `tie` 字段提示歧义,不假装唯一。
40
- · 复用 `protect` 写保护:self/anchor 层锚点不可遗忘;
41
- `role` 主体的锚点不得写入 self 层(扮演论边界)。
42
- """
43
-
44
- import hashlib
45
- import json
46
- import os
47
- import time
48
-
49
- from .fsutil import append_jsonl
50
-
51
- # 主体类型(扮演论:self=智能体自身 / role=扮演角色 / user=协作者 / agent=其他智能体)
52
- SUBJECT_KIND = ("self", "user", "role", "agent")
53
-
54
- # 位置效应(智能论 v3.4 §十三 五大单元):顺序即平票裁决优先级
55
- POSITIONS = {
56
- "record": {"unit": "记录单元", "effect": "全",
57
- "duty": "保存观测、过程、结果和误差"},
58
- "reflect": {"unit": "反思单元", "effect": "新",
59
- "duty": "发现差异、遗漏条件和新的路径"},
60
- "verify": {"unit": "验证单元", "effect": "稳",
61
- "duty": "判断规则、执行结果和结构是否有效"},
62
- "output": {"unit": "输出单元", "effect": "通",
63
- "duty": "与外部系统协作并表达边界"},
64
- "sustain": {"unit": "维生系统", "effect": "存",
65
- "duty": "维护存在、预算、回滚和整体结构"},
66
- }
67
- POSITION_ORDER = tuple(POSITIONS)
68
-
69
- # 扮演论三接口 → 落层
70
- INTERFACES = {
71
- "memory": {"layer": "knowledge",
72
- "meaning": "历史经验 / 交互证据 → 知识层"},
73
- "anchor": {"layer": "self|anchor",
74
- "meaning": "身份锚点 → 自我层(self) / 锚点层(其他主体),不可遗忘"},
75
- "values": {"layer": "structural",
76
- "meaning": "特化特征 / 价值观 → 结构层,条件空间即触发时机"},
77
- }
78
-
79
- PROFILE_PREFIX = "identity_"
80
- AUDIT_FILE = "_identity.jsonl"
81
-
82
- TAG_ANCHOR = "identity_anchor"
83
- TAG_TRAIT = "identity_trait"
84
- TAG_OBS = "identity_observation"
85
-
86
- # 位置投票的标签证据(每条都能追溯到五大单元职责)
87
- _POSITION_TAGS = {
88
- "reflect": {"reflect", "candidate", "hypothesis", "反题", "遗漏条件"},
89
- "verify": {"verify", "verdict", "裁决", "验证"},
90
- "output": {"output", "表达", "协作"},
91
- "sustain": {"goal", "budget", "rollback", "health", "维生"},
92
- }
93
-
94
-
95
- # 生效条件:subject_id 为假值(None/空串)时 s 为空串、无 ":" 可切,返回 ("user","");否则 strip 后含 ":" 则按首个冒号切成 kind/name,kind 经 strip().lower() 后不在 SUBJECT_KIND 即改记 "user",不含 ":" 时整串作为 name 归 "user"。
96
- def split_subject(subject_id):
97
- """`"self:lingshu"` → `("self", "lingshu")`;无前缀按 `user` 处理。"""
98
- s = (subject_id or "").strip()
99
- if ":" in s:
100
- kind, name = s.split(":", 1)
101
- kind = kind.strip().lower()
102
- if kind not in SUBJECT_KIND:
103
- kind = "user"
104
- return kind, name.strip()
105
- return "user", s
106
-
107
-
108
- # 生效条件:对 str(s) 的每个字符,isalnum() 为真或字符属于 "_-" 时原样保留,其余一律替换为 "_"(s 为 None/非字符串时按 str(s) 结果逐字符处理)。
109
- def _slug(s):
110
- return "".join(ch if (ch.isalnum() or ch in "_-") else "_" for ch in str(s))
111
-
112
-
113
- # 生效条件:subject_id 经 split_subject 与 _slug 处理后,按 PROFILE_PREFIX + kind + "_" + name 拼出档案节点 id。
114
- def subject_node_id(subject_id):
115
- """主体的档案节点 id(锚点载体):`identity_<kind>_<name>`。"""
116
- kind, name = split_subject(subject_id)
117
- return f"{PROFILE_PREFIX}{_slug(kind)}_{_slug(name)}"
118
-
119
-
120
- # 生效条件:给定 prefix 与 subject_id(seed 缺省为空串且原样参与哈希,不做回落)即返回 f"{PROFILE_PREFIX}{prefix}_{_slug(subject_id)}_{sha256(f'{subject_id}|{seed}|{time.time()}')前10位}"——prefix 只参与结果拼接、不参与哈希,因哈希含 time.time() 故每次调用返回的后缀都不同。
121
- def _nid(prefix, subject_id, seed=""):
122
- h = hashlib.sha256(f"{subject_id}|{seed}|{time.time()}".encode("utf-8"))
123
- return f"{PROFILE_PREFIX}{prefix}_{_slug(subject_id)}_{h.hexdigest()[:10]}"
124
-
125
-
126
- # 生效条件:rec 先被 dict(rec) 拷贝,仅当拷贝中缺 "ts" 键时补 time.time(),随后写入 cg.root 下 AUDIT_FILE 指向的 jsonl;写盘抛 OSError 时静默跳过并返回 None。
127
- def log(cg, rec):
128
- rec = dict(rec)
129
- rec.setdefault("ts", time.time())
130
- try:
131
- append_jsonl(os.path.join(cg.root, AUDIT_FILE), rec)
132
- except OSError:
133
- pass
134
-
135
-
136
- # 生效条件:cg.root 下 AUDIT_FILE 路径缺失或打开即抛 OSError 时返回空列表;否则逐行解析非空 JSON(json.loads 抛 ValueError 的行跳过),读取中途抛 OSError 时返回已解析的部分 out,正常返回 out[-int(limit or 100):],其中 limit 为 0/空串等假值时按 100 取值;
137
- def history(cg, limit=100):
138
- p = os.path.join(cg.root, AUDIT_FILE)
139
- out = []
140
- if not os.path.exists(p):
141
- return out
142
- try:
143
- with open(p, "r", encoding="utf-8") as f:
144
- for line in f:
145
- line = line.strip()
146
- if not line:
147
- continue
148
- try:
149
- out.append(json.loads(line))
150
- except ValueError:
151
- continue
152
- except OSError:
153
- return out
154
- return out[-int(limit or 100):]
155
-
156
-
157
- # --------------------------------------------------------------------------
158
- # 扮演论三接口:memory / anchor / values
159
- # --------------------------------------------------------------------------
160
-
161
- # 生效条件:subject_id 定 kind 默认值,kind 参数为真值时覆盖之;node_id 为假值时用 _nid("obs", subject_id, text[:32])(含 time.time())生成;标签为 list(tags or []) 追加 subject:<subject_id>、TAG_OBS、kind:<k>,evidence 为真值时再追加一条 evidence:<evidence>;condition_space 以 dict(condition_space or {}) 为底并 setdefault subject/kind;落层用 layer 真值否则 "knowledge",role 为真值时随 extra 传 role;返回 {"ok": True, "node_id", "subject_id", "kind"}。
162
- def observe(cg, subject_id, text, *, kind=None, role=None, layer=None, tags=None,
163
- condition_space=None, importance=0.5, verification_basis=None,
164
- evidence=None, node_id=None, override=False):
165
- """memory 接口:记录一条关于主体的**行为证据**(用于位置推断)。
166
-
167
- 写入知识层,自动带 `subject:<id>` 标签,使 `infer_position` 定位到该主体。
168
- role 兼作来源证据:user=外部协作、command/tool-output=内部执行。
169
- """
170
- k, _ = split_subject(subject_id)
171
- k = (kind or k).strip().lower()
172
- nid = node_id or _nid("obs", subject_id, text[:32])
173
- tg = list(tags or []) + [f"subject:{subject_id}", TAG_OBS, f"kind:{k}"]
174
- if evidence:
175
- tg.append(f"evidence:{evidence}")
176
- cs = dict(condition_space or {})
177
- cs.setdefault("subject", subject_id)
178
- cs.setdefault("kind", k)
179
- extra = {"role": role} if role else {}
180
- cg.add(nid, text, layer=layer or "knowledge", tags=tg, condition_space=cs,
181
- importance=importance, verification_basis=verification_basis,
182
- override=override, **extra)
183
- log(cg, {"op": "observe", "subject": subject_id, "node_id": nid, "role": role,
184
- "layer": layer or "knowledge"})
185
- return {"ok": True, "node_id": nid, "subject_id": subject_id, "kind": k}
186
-
187
-
188
- # 生效条件:kind 参数为真值时覆盖 split_subject(subject_id) 得到的类型,k 不在 SUBJECT_KIND 时抛 ValueError;k 为 "self" 落 "self" 层、其余落 "anchor" 层,但 requested_layer 等于 "self" 且 k 不为 "self" 时抛 ValueError(不写盘);节点 id 取自 subject_node_id(subject_id),返回含 layer 与 protected True。
189
- def set_anchor(cg, subject_id, text, *, kind=None, condition_space=None,
190
- importance=0.9, override=False, requested_layer=None):
191
- """anchor 接口:写入身份锚点(不可遗忘)。
192
-
193
- 落层规则(扮演论边界):
194
- · kind=self → self 层(智能体自身的自我锚点,需设计者验证)
195
- · 其他 kind → anchor 层(角色/用户锚点,仍不可遗忘)
196
- requested_layer="self" 但 kind≠self → 拒绝(角色人设 ≠ 灵枢自身锚点)。
197
- """
198
- k, _ = split_subject(subject_id)
199
- k = (kind or k).strip().lower()
200
- if k not in SUBJECT_KIND:
201
- raise ValueError(f"未知主体类型:{k}(允许:{SUBJECT_KIND})")
202
- if requested_layer == "self" and k != "self":
203
- raise ValueError(
204
- "扮演论边界:角色/用户锚点不得写入 self 层"
205
- "(self 层是灵枢自身锚点,需设计者验证)")
206
- layer = "self" if k == "self" else "anchor"
207
- nid = subject_node_id(subject_id)
208
- cs = dict(condition_space or {})
209
- cs.setdefault("subject", subject_id)
210
- cs.setdefault("kind", k)
211
- tg = [f"subject:{subject_id}", TAG_ANCHOR, f"kind:{k}"]
212
- cg.add(nid, text, layer=layer, tags=tg, condition_space=cs,
213
- importance=importance, verification_basis="data", override=override)
214
- log(cg, {"op": "anchor", "subject": subject_id, "node_id": nid,
215
- "kind": k, "layer": layer, "override": bool(override)})
216
- return {"ok": True, "node_id": nid, "subject_id": subject_id, "kind": k,
217
- "layer": layer, "protected": True}
218
-
219
-
220
- # 生效条件:kind 参数为真值时覆盖 split_subject(subject_id) 得到的类型;node_id 为假值时用 _nid("trait", subject_id, trait[:24]) 生成;落层硬编码为 "structural";position 为真值时追加 position:<position> 标签;verification_basis 缺省为 "data",importance 缺省 0.6;返回 layer 为 "structural" 与所用 condition_space。
221
- def add_trait(cg, subject_id, trait, *, condition_space=None, importance=0.6,
222
- position=None, kind=None, verification_basis="data",
223
- override=False, node_id=None):
224
- """values 接口:写入条件触发的特征/特化价值观。
225
-
226
- 落 STRUCTURE 层;`condition_space` 即触发时机(扮演论:条件空间 = 触发条件)。
227
- """
228
- k, _ = split_subject(subject_id)
229
- k = (kind or k).strip().lower()
230
- nid = node_id or _nid("trait", subject_id, trait[:24])
231
- cs = dict(condition_space or {})
232
- cs.setdefault("subject", subject_id)
233
- cs.setdefault("kind", k)
234
- tg = [f"subject:{subject_id}", TAG_TRAIT, f"kind:{k}"]
235
- if position:
236
- tg.append(f"position:{position}")
237
- cg.add(nid, trait, layer="structural", tags=tg, condition_space=cs,
238
- importance=importance, verification_basis=verification_basis,
239
- override=override)
240
- log(cg, {"op": "trait", "subject": subject_id, "node_id": nid,
241
- "position": position})
242
- return {"ok": True, "node_id": nid, "subject_id": subject_id, "kind": k,
243
- "layer": "structural", "condition_space": cs}
244
-
245
-
246
- # --------------------------------------------------------------------------
247
- # 位置效应推断(智能论 v3.4 §十三)
248
- # --------------------------------------------------------------------------
249
-
250
- # 生效条件:tags 先转为 set(tags or []) 后并列判定——role 属于 ("command","tool-output") 或 layer 等于 "contextual" 则加 "record";tags 与 _POSITION_TAGS 各项标记集有交集则加对应 pos;ev_pos 或 ev_neg 为真值则加 "verify";role 属于 ("user","assistant") 或 tags 中任一字符串以 "cap:" 开头则加 "output";layer 等于 "goals" 则加 "sustain";返回该并集。
251
- def _votes(role, layer, tags, vb, ev_pos, ev_neg):
252
- """把一条行为证据映射到位置效应候选(可多面)。规则可审计、可扩展。"""
253
- tags = set(tags or [])
254
- v = set()
255
- if role in ("command", "tool-output") or layer == "contextual":
256
- v.add("record")
257
- for pos, marks in _POSITION_TAGS.items():
258
- if tags & marks:
259
- v.add(pos)
260
- if ev_pos or ev_neg:
261
- v.add("verify")
262
- if role in ("user", "assistant") or any(
263
- isinstance(t, str) and t.startswith("cap:") for t in tags):
264
- v.add("output")
265
- if layer == "goals":
266
- v.add("sustain")
267
- return v
268
-
269
-
270
- # 生效条件:遍历 cg.index.get("nodes")(缺键或值为假时取空 dict,此时必然返回 position=unknown、confidence=0.0、votes={}),仅统计标签含 "subject:<subject_id>" 且不含 TAG_ANCHOR/TAG_TRAIT 的节点,票由 _votes 得出;无任何票时返回 unknown/0.0/{};有票时 winners 为 POSITION_ORDER 中票数等于最高票的位置,position 取 winners[0],confidence=round(top/total, 3),多赢家时以 tie 列出。
271
- def infer_position(cg, subject_id):
272
- """按该主体的行为证据投票推断位置效应(带 confidence / votes,可审计)。
273
-
274
- 只统计带 `subject:<id>` 标签、且**非档案节点**(锚点/特征)的证据节点,
275
- 避免档案自证。返回 position=unknown 表示证据不足。
276
- """
277
- tag = f"subject:{subject_id}"
278
- nodes = cg.index.get("nodes") or {}
279
- votes, n = {}, 0
280
- for nid, e in list(nodes.items()):
281
- tg = set(e.get("tags") or [])
282
- if tag not in tg or (tg & {TAG_ANCHOR, TAG_TRAIT}):
283
- continue
284
- node = cg.get(nid) or {}
285
- fm = node.get("frontmatter") or {}
286
- n += 1
287
- for pos in _votes(fm.get("role"), e.get("layer"), e.get("tags"),
288
- e.get("verification_basis"), fm.get("positive_evidence"),
289
- fm.get("negative_evidence")):
290
- votes[pos] = votes.get(pos, 0) + 1
291
- if not votes:
292
- return {"position": "unknown", "confidence": 0.0, "votes": {},
293
- "evidence_count": n, "tie": []}
294
- top = max(votes.values())
295
- winners = [p for p in POSITION_ORDER if votes.get(p) == top]
296
- total = sum(votes.values())
297
- return {"position": winners[0], "confidence": round(top / total, 3),
298
- "votes": votes, "evidence_count": n,
299
- "tie": winners if len(winners) > 1 else []}
300
-
301
-
302
- # 生效条件:pos 取自 POSITIONS,缺键时以空 dict 兜底,故未知 pos 返回 {"position": pos, "unit": None, "effect": None, "duty": None}。
303
- def _position_view(pos):
304
- meta = POSITIONS.get(pos) or {}
305
- return {"position": pos, "unit": meta.get("unit"),
306
- "effect": meta.get("effect"), "duty": meta.get("duty")}
307
-
308
-
309
- # 生效条件:仅遍历标签含 "subject:<subject_id>" 的节点,其中带 TAG_ANCHOR 者进 anchors,否则(elif)带 TAG_TRAIT 者进 traits——两标签同时存在时只进 anchors、不进 traits;anchor 取 anchors[0] 或 None;位置相关字段来自 infer_position(cg, subject_id)。
310
- def profile(cg, subject_id):
311
- """主体画像 = 身份锚点 + 位置效应 + 条件特征(取代单一「用户画像」)。"""
312
- k, name = split_subject(subject_id)
313
- tag = f"subject:{subject_id}"
314
- nodes = cg.index.get("nodes") or {}
315
- anchors, traits = [], []
316
- for nid, e in list(nodes.items()):
317
- tg = set(e.get("tags") or [])
318
- if tag not in tg:
319
- continue
320
- node = cg.get(nid) or {}
321
- fm = node.get("frontmatter") or {}
322
- if TAG_ANCHOR in tg:
323
- anchors.append({"node_id": nid, "layer": e.get("layer"),
324
- "content": (node.get("content") or "")[:400]})
325
- elif TAG_TRAIT in tg:
326
- traits.append({"node_id": nid, "layer": e.get("layer"),
327
- "content": (node.get("content") or "")[:200],
328
- "condition_space": fm.get("condition_space"),
329
- "importance": fm.get("importance")})
330
- pos = infer_position(cg, subject_id)
331
- out = {"subject_id": subject_id, "kind": k, "name": name,
332
- "anchor": anchors[0] if anchors else None, "anchors": anchors,
333
- "traits": traits, "traits_count": len(traits)}
334
- out.update(_position_view(pos["position"]))
335
- out.update({"position_confidence": pos["confidence"], "votes": pos["votes"],
336
- "evidence_count": pos["evidence_count"], "tie": pos["tie"]})
337
- return out
338
-
339
-
340
- # 生效条件:counts 按每个以 "subject:" 开头的字符串标签出现次数累加(即标签次数,不是节点数),按 (-次数, sid) 排序后逐个 sid 调 infer_position;limit 为 0/None/空串等使 `limit and int(limit) > 0` 为假时返回全量 out,仅当 limit 为真值且 int(limit) > 0 时返回前 int(limit) 项。
341
- def positions(cg, limit=0):
342
- """所有主体的位置效应分布(OS 视角:谁在记录/反思/验证/输出/维生)。"""
343
- nodes = cg.index.get("nodes") or {}
344
- counts = {}
345
- for _nid_, e in list(nodes.items()):
346
- for t in (e.get("tags") or []):
347
- if isinstance(t, str) and t.startswith("subject:"):
348
- sid = t[len("subject:"):]
349
- counts[sid] = counts.get(sid, 0) + 1
350
- out = []
351
- for sid, cnt in sorted(counts.items(), key=lambda kv: (-kv[1], kv[0])):
352
- p = infer_position(cg, sid)
353
- out.append({"subject_id": sid, "kind": split_subject(sid)[0],
354
- "nodes": cnt, "position": p["position"],
355
- "confidence": p["confidence"], "evidence_count": p["evidence_count"]})
356
- return out[:int(limit)] if limit and int(limit) > 0 else out
357
-
358
-
359
- # 生效条件:cg.root/AUDIT_FILE 不存在时返回 0;否则逐行统计 strip() 后非空的行数,读取途中抛 OSError 时返回已累计的 n。
360
- def _audit_count(cg):
361
- p = os.path.join(cg.root, AUDIT_FILE)
362
- if not os.path.exists(p):
363
- return 0
364
- n = 0
365
- try:
366
- with open(p, "r", encoding="utf-8") as f:
367
- for line in f:
368
- if line.strip():
369
- n += 1
370
- except OSError:
371
- return n
372
- return n
373
-
374
-
375
- # 生效条件:以 positions(cg)(limit 缺省 0,返回全量)得主体列表并按各自 position 聚合计数,与 _audit_count(cg) 一并返回 subjects/by_position/audit_records。
376
- def summary(cg):
377
- """身份面汇总:主体数 + 位置分布(供 health / 运维审计,流式计数不载全量)。"""
378
- ps = positions(cg)
379
- dist = {}
380
- for s in ps:
381
- dist[s["position"]] = dist.get(s["position"], 0) + 1
382
- return {"subjects": len(ps), "by_position": dist,
383
- "audit_records": _audit_count(cg)}
384
-
385
-
386
- # 生效条件:无入参,恒返回 POSITION_ORDER 中每个 p 的 POSITIONS[p] 副本、INTERFACES 各值副本以及 list(SUBJECT_KIND)。
387
- def catalog():
388
- """自描述:位置效应表 + 三接口(供 MCP / 文档对照协议验证)。"""
389
- return {"positions": {p: dict(POSITIONS[p]) for p in POSITION_ORDER},
390
- "interfaces": {k: dict(v) for k, v in INTERFACES.items()},
391
- "kinds": list(SUBJECT_KIND)}
1
+ # -*- coding: utf-8 -*-
2
+ """身份特征识别(Identity Traits)——不止「用户画像」,而是「主体身份 × 位置效应 × 条件特征」。
3
+
4
+ 理论出处
5
+ --------
6
+ · 智能论 v3.4 §十三「五大单元」·位置效应(`docs/theory/智能的公理化基石.md:540-556`):
7
+
8
+ 单元 位置效应 核心职责
9
+ 记录单元 全 保存观测、过程、结果和误差
10
+ 反思单元 新 发现差异、遗漏条件和新路径
11
+ 验证单元 稳 判断规则、执行结果和结构是否有效
12
+ 输出单元 通 与外部系统协作并表达边界
13
+ 维生系统 存 维护存在、预算、回滚和整体结构
14
+
15
+ 「位置效应」= 主体处在系统什么位置,就承担什么职责、表现出什么特征。
16
+ 所以「画像」不该只刻画用户,而应识别**每个主体的身份锚点 + 位置 + 特征**,
17
+ 其中也包括智能体自身(self)。
18
+
19
+ · 扮演论 v3.3(`README.md:231-271`、`docs/mdcg/tool_table_v0.3.0.md:86-92`):
20
+ 智能即扮演;角色卡 = 条件空间声明起点;三接口 =
21
+ memory(历史 → 知识层)/
22
+ anchor(自我锚点 → SELF 层,不可遗忘)/
23
+ values(特化价值观 → STRUCTURE 层,带条件空间,条件空间即触发时机)。
24
+ 边界:角色人设 ≠ 灵枢自身锚点(后者在 self 层,需设计者验证)。
25
+
26
+ 模型
27
+ ----
28
+ subject = {subject_id, kind, position, anchor, traits}
29
+ subject_id : "self:lingshu" / "user:alice" / "role:whale" / "agent:coder"
30
+ kind : self | user | role | agent
31
+ position : record | reflect | verify | output | sustain | unknown
32
+ anchor : 身份锚点(不可遗忘;kind≠self 一律落 anchor 层)
33
+ traits : 条件触发的特征条目(条件空间 = 触发时机,带重要度)
34
+
35
+ 诚实边界
36
+ --------
37
+ · position 是**推断**(`infer_position` 按行为证据投票),返回 confidence / votes /
38
+ 证据数,可审计「为什么判成这个位置」,不是事实断言。
39
+ · 平票时 position 取 `POSITION_ORDER` 中的首个并置 `tie` 字段提示歧义,不假装唯一。
40
+ · 存在契约记录(`set_contract`,智能论 §1.6.5/§3.2.1):结构化**引用**载体,
41
+ 落 anchor 层(不可遗忘+不可覆盖),四字段+`status_hash`+引用锚 `doc_ref`
42
+ 指向真源区间——不复制承诺原文;发出权属设计者位置(写入面走 admin 闸)。
43
+ · 复用 `protect` 写保护:self/anchor 层锚点不可遗忘;
44
+ `role` 主体的锚点不得写入 self 层(扮演论边界)。
45
+ """
46
+
47
+ import hashlib
48
+ import json
49
+ import os
50
+ import time
51
+
52
+ from . import fsutil
53
+ from .fsutil import append_jsonl
54
+
55
+ # 主体类型(扮演论:self=智能体自身 / role=扮演角色 / user=协作者 / agent=其他智能体)
56
+ SUBJECT_KIND = ("self", "user", "role", "agent")
57
+
58
+ # 位置效应(智能论 v3.4 §十三 五大单元):顺序即平票裁决优先级
59
+ POSITIONS = {
60
+ "record": {"unit": "记录单元", "effect": "全",
61
+ "duty": "保存观测、过程、结果和误差"},
62
+ "reflect": {"unit": "反思单元", "effect": "新",
63
+ "duty": "发现差异、遗漏条件和新的路径"},
64
+ "verify": {"unit": "验证单元", "effect": "稳",
65
+ "duty": "判断规则、执行结果和结构是否有效"},
66
+ "output": {"unit": "输出单元", "effect": "通",
67
+ "duty": "与外部系统协作并表达边界"},
68
+ "sustain": {"unit": "维生系统", "effect": "存",
69
+ "duty": "维护存在、预算、回滚和整体结构"},
70
+ }
71
+ POSITION_ORDER = tuple(POSITIONS)
72
+
73
+ # 扮演论三接口 → 落层
74
+ INTERFACES = {
75
+ "memory": {"layer": "knowledge",
76
+ "meaning": "历史经验 / 交互证据 → 知识层"},
77
+ "anchor": {"layer": "self|anchor",
78
+ "meaning": "身份锚点 → 自我层(self) / 锚点层(其他主体),不可遗忘"},
79
+ "values": {"layer": "structural",
80
+ "meaning": "特化特征 / 价值观 → 结构层,条件空间即触发时机"},
81
+ }
82
+
83
+ PROFILE_PREFIX = "identity_"
84
+ AUDIT_FILE = "_identity.jsonl"
85
+
86
+ TAG_ANCHOR = "identity_anchor"
87
+ TAG_TRAIT = "identity_trait"
88
+ OP_TOOL = "identity.observe/anchor/trait"
89
+
90
+ TAG_OBS = "identity_observation"
91
+ TAG_CONTRACT = "identity_contract"
92
+
93
+ # 存在契约记录的哈希字段集(§3.2.1 四字段「授予方/接收方/时间戳/状态摘要」+
94
+ # 锚定标识)——`status_hash` = 本字段集规范化后 sha256 前 16 位(唯一实现见
95
+ # `contract_status_hash`)。HASH 管校验、序号管身份(定稿第 4 条双轨)。
96
+ CONTRACT_HASH_FIELDS = ("contract_id", "grantor", "grantee", "timestamp",
97
+ "status_summary")
98
+
99
+ # 位置投票的标签证据(每条都能追溯到五大单元职责)
100
+ _POSITION_TAGS = {
101
+ "reflect": {"reflect", "candidate", "hypothesis", "反题", "遗漏条件"},
102
+ "verify": {"verify", "verdict", "裁决", "验证"},
103
+ "output": {"output", "表达", "协作"},
104
+ "sustain": {"goal", "budget", "rollback", "health", "维生"},
105
+ }
106
+
107
+
108
+ # 生效条件:subject_id 为假值(None/空串)时 s 为空串、无 ":" 可切,返回 ("user","");否则 strip 后含 ":" 则按首个冒号切成 kind/name,kind 经 strip().lower() 后不在 SUBJECT_KIND 即改记 "user",不含 ":" 时整串作为 name 归 "user"。
109
+ def split_subject(subject_id):
110
+ """`"self:lingshu"` → `("self", "lingshu")`;无前缀按 `user` 处理。"""
111
+ s = (subject_id or "").strip()
112
+ if ":" in s:
113
+ kind, name = s.split(":", 1)
114
+ kind = kind.strip().lower()
115
+ if kind not in SUBJECT_KIND:
116
+ kind = "user"
117
+ return kind, name.strip()
118
+ return "user", s
119
+
120
+
121
+ # 生效条件:对 str(s) 的每个字符,isalnum() 为真或字符属于 "_-" 时原样保留,其余一律替换为 "_"(s 为 None/非字符串时按 str(s) 结果逐字符处理)。
122
+ def _slug(s):
123
+ return "".join(ch if (ch.isalnum() or ch in "_-") else "_" for ch in str(s))
124
+
125
+
126
+ # 生效条件:subject_id 经 split_subject 与 _slug 处理后,按 PROFILE_PREFIX + kind + "_" + name 拼出档案节点 id。
127
+ def subject_node_id(subject_id):
128
+ """主体的档案节点 id(锚点载体):`identity_<kind>_<name>`。"""
129
+ kind, name = split_subject(subject_id)
130
+ return f"{PROFILE_PREFIX}{_slug(kind)}_{_slug(name)}"
131
+
132
+
133
+ # 生效条件:给定 prefix 与 subject_id(seed 缺省为空串且原样参与哈希,不做回落)即返回 f"{PROFILE_PREFIX}{prefix}_{_slug(subject_id)}_{sha256(f'{subject_id}|{seed}|{time.time()}')前10位}"——prefix 只参与结果拼接、不参与哈希,因哈希含 time.time() 故每次调用返回的后缀都不同。
134
+ def _nid(prefix, subject_id, seed=""):
135
+ h = hashlib.sha256(f"{subject_id}|{seed}|{time.time()}".encode("utf-8"))
136
+ return f"{PROFILE_PREFIX}{prefix}_{_slug(subject_id)}_{h.hexdigest()[:10]}"
137
+
138
+
139
+ # 生效条件:rec 先被 dict(rec) 拷贝,仅当拷贝中缺 "ts" 键时补 time.time(),随后写入 cg.root 下 AUDIT_FILE 指向的 jsonl;写盘抛 OSError 时静默跳过并返回 None。
140
+ def log(cg, rec):
141
+ rec = dict(rec)
142
+ rec.setdefault("ts", time.time())
143
+ try:
144
+ # #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
145
+ # 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
146
+ # (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
147
+ # issue #443:调用方可控字段可无限长 ⇒ 单条记录先过总字节闸(超限跳过写并留痕)。
148
+ if not fsutil.bounded_record(rec):
149
+ fsutil._note_append_failure(os.path.join(cg.root, AUDIT_FILE),
150
+ ValueError("record_too_large: issue #443"))
151
+ return
152
+ _ok = fsutil.append_jsonl_ledger(os.path.join(cg.root, AUDIT_FILE), rec)
153
+ except OSError:
154
+ pass
155
+
156
+
157
+ # 生效条件:cg.root 下 AUDIT_FILE 路径缺失或打开即抛 OSError 时返回空列表;否则逐行解析非空 JSON(json.loads 抛 ValueError 的行跳过),读取中途抛 OSError 时返回已解析的部分 out,正常返回 out[-int(limit or 100):],其中 limit 为 0/空串等假值时按 100 取值;
158
+ def history(cg, limit=100):
159
+ """身份操作留痕(**读写配对**)。
160
+
161
+ 2026-10-18:写面已迁到**本进程独占分片**(`fsutil.append_jsonl_ledger`,文件名
162
+ `<stem>.<pid>.jsonl`),读面却仍只 open 旧单文件 `_identity.jsonl` ⇒ 命中恒空
163
+ (实测 `test_p10_identity` 的「身份操作留痕可查 []」)。改用成对的
164
+ `fsutil.read_jsonl_ledger`:它同时读旧单文件与全部分片,历史不断代
165
+ ——这正是 `afad11b3` 回退「五件台账迁移」时所指的「写读必须配对」。
166
+ """
167
+ out = fsutil.read_jsonl_ledger(os.path.join(cg.root, AUDIT_FILE))
168
+ return out[-int(limit or 100):]
169
+
170
+
171
+ # --------------------------------------------------------------------------
172
+ # 扮演论三接口:memory / anchor / values
173
+ # --------------------------------------------------------------------------
174
+
175
+ # 生效条件:subject_id 定 kind 默认值,kind 参数为真值时覆盖之;node_id 为假值时用 _nid("obs", subject_id, text[:32])(含 time.time())生成;标签为 list(tags or []) 追加 subject:<subject_id>、TAG_OBS、kind:<k>,evidence 为真值时再追加一条 evidence:<evidence>;condition_space 以 dict(condition_space or {}) 为底并 setdefault subject/kind;落层用 layer 真值否则 "knowledge",role 为真值时随 extra 传 role;返回 {"ok": True, "node_id", "subject_id", "kind"}。
176
+ def observe(cg, subject_id, text, *, kind=None, role=None, layer=None, tags=None,
177
+ condition_space=None, importance=0.5, verification_basis=None,
178
+ evidence=None, node_id=None, sensitivity=None, override=False):
179
+ """memory 接口:记录一条关于主体的**行为证据**(用于位置推断)。
180
+
181
+ 写入知识层,自动带 `subject:<id>` 标签,使 `infer_position` 定位到该主体。
182
+ role 兼作来源证据:user=外部协作、command/tool-output=内部执行。
183
+ """
184
+ k, _ = split_subject(subject_id)
185
+ k = (kind or k).strip().lower()
186
+ nid = node_id or _nid("obs", subject_id, text[:32])
187
+ tg = list(tags or []) + [f"subject:{subject_id}", TAG_OBS, f"kind:{k}"]
188
+ if evidence:
189
+ tg.append(f"evidence:{evidence}")
190
+ cs = dict(condition_space or {})
191
+ # 2026-10-18:subject/kind **不是四维之一**,此前把它们塞进 condition_space,
192
+ # 把真正的四维挤掉了——实测 identity_self_lingshu 因此判 legacy_blindspot。
193
+ # 二者在 tags 里已有(subject:xxx / kind:xxx),此处保留只为不破坏既有读取方,
194
+ # 另补齐四维(产生过程自述,非内容推断)。
195
+ cs.setdefault("subject", subject_id)
196
+ cs.setdefault("kind", k)
197
+ cs.setdefault("observation_position", "identity:" + str(subject_id))
198
+ cs.setdefault("observation_tool", "identity.observe")
199
+ cs.setdefault("existence_constraint", "身份观测面可写")
200
+ extra = {"role": role} if role else {}
201
+ # issue #258:sensitivity 透传(缺省 None ⇒ 行为逐位不变,既有调用方零变更)。
202
+ # 此前该形参**不存在** ⇒ 跨节点证据包导入时密级被静默回落到缺省 internal。
203
+ if sensitivity is not None:
204
+ extra["sensitivity"] = sensitivity
205
+ cg.add(nid, text, layer=layer or "knowledge", tags=tg, condition_space=cs,
206
+ importance=importance, verification_basis=verification_basis,
207
+ override=override, **extra)
208
+ log(cg, {"op": "observe", "subject": subject_id, "node_id": nid, "role": role,
209
+ "layer": layer or "knowledge"})
210
+ return {"ok": True, "node_id": nid, "subject_id": subject_id, "kind": k}
211
+
212
+
213
+ # 生效条件:kind 参数为真值时覆盖 split_subject(subject_id) 得到的类型,k 不在 SUBJECT_KIND 时抛 ValueError;k 为 "self" 落 "self" 层、其余落 "anchor" 层,但 requested_layer 等于 "self" 且 k 不为 "self" 时抛 ValueError(不写盘);节点 id 取自 subject_node_id(subject_id),返回含 layer 与 protected True。
214
+ def set_anchor(cg, subject_id, text, *, kind=None, condition_space=None,
215
+ importance=0.9, override=False, requested_layer=None,
216
+ sensitivity=None):
217
+ """anchor 接口:写入身份锚点(不可遗忘)。
218
+
219
+ 落层规则(扮演论边界):
220
+ · kind=self → self 层(智能体自身的自我锚点,需设计者验证)
221
+ · 其他 kind → anchor 层(角色/用户锚点,仍不可遗忘)
222
+ requested_layer="self" 但 kind≠self → 拒绝(角色人设 ≠ 灵枢自身锚点)。
223
+ """
224
+ k, _ = split_subject(subject_id)
225
+ k = (kind or k).strip().lower()
226
+ if k not in SUBJECT_KIND:
227
+ raise ValueError(f"未知主体类型:{k}(允许:{SUBJECT_KIND})")
228
+ if requested_layer == "self" and k != "self":
229
+ raise ValueError(
230
+ "扮演论边界:角色/用户锚点不得写入 self 层"
231
+ "(self 层是灵枢自身锚点,需设计者验证)")
232
+ layer = "self" if k == "self" else "anchor"
233
+ nid = subject_node_id(subject_id)
234
+ cs = dict(condition_space or {})
235
+ cs.setdefault("subject", subject_id)
236
+ cs.setdefault("kind", k)
237
+ # 2026-10-18:补四维(subject/kind 非四维,见 observe 处说明)
238
+ cs.setdefault("observation_position", "identity:" + str(subject_id))
239
+ cs.setdefault("observation_tool", OP_TOOL)
240
+ cs.setdefault("existence_constraint", "身份面可写")
241
+ tg = [f"subject:{subject_id}", TAG_ANCHOR, f"kind:{k}"]
242
+ cg.add(nid, text, layer=layer, tags=tg, condition_space=cs,
243
+ importance=importance, verification_basis="data", override=override,
244
+ **({"sensitivity": sensitivity} if sensitivity else {}))
245
+ log(cg, {"op": "anchor", "subject": subject_id, "node_id": nid,
246
+ "kind": k, "layer": layer, "override": bool(override)})
247
+ return {"ok": True, "node_id": nid, "subject_id": subject_id, "kind": k,
248
+ "layer": layer, "protected": True}
249
+
250
+
251
+ # 生效条件:kind 参数为真值时覆盖 split_subject(subject_id) 得到的类型;node_id 为假值时用 _nid("trait", subject_id, trait[:24]) 生成;落层硬编码为 "structural";position 为真值时追加 position:<position> 标签;verification_basis 缺省为 "data",importance 缺省 0.6;返回 layer 为 "structural" 与所用 condition_space。
252
+ def add_trait(cg, subject_id, trait, *, condition_space=None, importance=0.6,
253
+ position=None, kind=None, verification_basis="data",
254
+ override=False, node_id=None, sensitivity=None):
255
+ """values 接口:写入条件触发的特征/特化价值观。
256
+
257
+ 落 STRUCTURE 层;`condition_space` 即触发时机(扮演论:条件空间 = 触发条件)。
258
+ """
259
+ k, _ = split_subject(subject_id)
260
+ k = (kind or k).strip().lower()
261
+ nid = node_id or _nid("trait", subject_id, trait[:24])
262
+ cs = dict(condition_space or {})
263
+ cs.setdefault("subject", subject_id)
264
+ cs.setdefault("kind", k)
265
+ # 2026-10-18:补四维(subject/kind 非四维,见 observe 处说明)
266
+ cs.setdefault("observation_position", "identity:" + str(subject_id))
267
+ cs.setdefault("observation_tool", OP_TOOL)
268
+ cs.setdefault("existence_constraint", "身份面可写")
269
+ tg = [f"subject:{subject_id}", TAG_TRAIT, f"kind:{k}"]
270
+ if position:
271
+ tg.append(f"position:{position}")
272
+ cg.add(nid, trait, layer="structural", tags=tg, condition_space=cs,
273
+ importance=importance, verification_basis=verification_basis,
274
+ override=override,
275
+ **({"sensitivity": sensitivity} if sensitivity else {}))
276
+ log(cg, {"op": "trait", "subject": subject_id, "node_id": nid,
277
+ "position": position})
278
+ return {"ok": True, "node_id": nid, "subject_id": subject_id, "kind": k,
279
+ "layer": "structural", "condition_space": cs}
280
+
281
+
282
+ # --------------------------------------------------------------------------
283
+ # 存在契约记录(智能论 §1.6.5「协定式自我赋予」/ §3.2.1「结构锚定记录」)
284
+ #
285
+ # 载体=结构化**引用**而非内容复制(设计者定稿二原则):四字段逐字对齐 §3.2.1
286
+ # (contract_id/grantor/grantee/timestamp/status_summary)+一条与既有 `doc_ref`
287
+ # 同构的引用锚指向 `docs/theory/智能论3.4.md` §1.6.5/§3.2.1 区间(复用
288
+ # probe_ref/read_ref/region_hash 校验,**不复制承诺原文**)。
289
+ # 落 **anchor 层**(不可遗忘+不可覆盖,无 `self_state` 豁免,定稿第 2 条);
290
+ # `status_hash`=四字段规范化后哈希,供记录侧校验(§3.2.1「可独立校验」)。
291
+ # 生成者=设计者位置(写入面走 admin 闸,见 mcp_server._identity_call,定稿第 9 条);
292
+ # 显式非自动——契约是主体间事件,不由任何自动链路产出(定稿「显式非自动」)。
293
+ # --------------------------------------------------------------------------
294
+
295
+ # 生效条件:contract_id 为假值(None/空串)时 _slug('') 得空串、strip('_') 后仍为空,返回前缀拼接的空尾串 "identity_contract_";否则返回 f"{PROFILE_PREFIX}contract_{_slug(contract_id).strip('_')}"(_slug 把非 alnum 且非 _- 的字符换成 _、再去掉首尾下划线,故 "#ANCHOR-DS-001" → "identity_contract_ANCHOR-DS-001")。
296
+ def contract_node_id(contract_id):
297
+ """契约记录的节点 id:`identity_contract_<slug>`(单契约单节点,同 id 幂等)。"""
298
+ return f"{PROFILE_PREFIX}contract_{_slug(contract_id).strip('_')}"
299
+
300
+
301
+ # 生效条件:fields 为假值(None/{})时按 {} 处理,按 CONTRACT_HASH_FIELDS 顺序取键(缺键得 None),json.dumps(sort_keys=True, ensure_ascii=False, separators=(",", ":")) 规范化后取 UTF-8 字节的 sha256 十六进制前 16 位并返回。
302
+ def contract_status_hash(fields):
303
+ """四字段(+锚定标识)规范化后哈希——`status_hash` 的唯一实现(记录侧校验)。"""
304
+ f = fields or {}
305
+ payload = json.dumps({k: f.get(k) for k in CONTRACT_HASH_FIELDS},
306
+ sort_keys=True, ensure_ascii=False,
307
+ separators=(",", ":"))
308
+ return hashlib.sha256(payload.encode("utf-8")).hexdigest()[:16]
309
+
310
+
311
+ # 生效条件:cid/gtor/gtee/ts 各自 strip 后为空(summ 不限、可为空串)时抛 ValueError;否则落 anchor 层,节点 id 取 contract_node_id(cid),fm 带 contract_id 原形/grantor/grantee/timestamp/status_summary/status_hash(=contract_status_hash(五字段))、doc_ref(真值时 dict 化)与 condition_ref/state_ref(真值时),标签 [TAG_CONTRACT, "subject:<gtee>"]、条件空间 {subject: gtee, contract_id: cid}、verification_basis="data"、importance 缺省 1.0;覆写同 id 既有节点(anchor 层不可覆盖)需 override=True,否则由 cg.add→protect.guard_write 抛 ProtectionError;落盘后写 _identity.jsonl,返回含 node_id/layer="anchor"/protected/immutable True/status_hash/fields 的 dict。
312
+ def set_contract(cg, contract_id, *, grantor, grantee, timestamp,
313
+ status_summary, doc_ref=None, condition_ref=None,
314
+ state_ref=None, importance=1.0, override=False):
315
+ """写入一条存在契约记录(§3.2.1 结构锚定记录 → anchor 层,不可篡改)。
316
+
317
+ 与 `set_anchor` 同侧:发出方是设计者(他者)→ non-self 锚点落 anchor 层。
318
+ 四字段逐字对齐 §3.2.1;`doc_ref` 为指向真源区间的**引用锚**(不复制原文)。
319
+ `status_hash` 供记录侧校验「字段未被改动」(§3.2.1「可独立校验」)。
320
+ 可选引用型字段 `condition_ref` / `state_ref` 承载 §1.6.5 结构含义第三条的
321
+ 「条件空间 / 那一刻运行状态」——**只存引用**(节点 id / 台账),不复制内容
322
+ (定稿第 1 条:三项齐备与裁定二两全)。
323
+ 显式非自动——契约是主体间事件,不由任何自动链路产出。
324
+ """
325
+ cid = str(contract_id or "").strip()
326
+ gtor = str(grantor or "").strip()
327
+ gtee = str(grantee or "").strip()
328
+ ts = str(timestamp or "").strip()
329
+ summ = str(status_summary or "")
330
+ if not cid:
331
+ raise ValueError("contract_id 不得为空(§3.2.1 锚定标识,保留 #ANCHOR- 原形)")
332
+ if not gtor:
333
+ raise ValueError("grantor 不得为空(§3.2.1 授予方=设计者位置标识)")
334
+ if not gtee:
335
+ raise ValueError("grantee 不得为空(§3.2.1 接收方=协议实例标识)")
336
+ if not ts:
337
+ raise ValueError("timestamp 不得为空(§3.2.1 时间戳=结构事件的时间)")
338
+ nid = contract_node_id(cid)
339
+ fields = {"contract_id": cid, "grantor": gtor, "grantee": gtee,
340
+ "timestamp": ts, "status_summary": summ}
341
+ sh = contract_status_hash(fields)
342
+ extra = dict(fields)
343
+ extra["status_hash"] = sh
344
+ if doc_ref:
345
+ extra["doc_ref"] = dict(doc_ref)
346
+ if condition_ref:
347
+ extra["condition_ref"] = condition_ref
348
+ if state_ref:
349
+ extra["state_ref"] = state_ref
350
+ tg = [TAG_CONTRACT, f"subject:{gtee}"]
351
+ cs = {"subject": gtee, "contract_id": cid}
352
+ text = (f"存在契约 {cid}:授予方 {gtor} → 接收方 {gtee};时间戳 {ts}。\n"
353
+ f"状态摘要:{summ}\n"
354
+ f"(结构化**引用**载体——承诺原文不复制;引用锚见 doc_ref,"
355
+ f"回读用 probe_ref/read_ref;status_hash={sh} 供记录侧校验。)")
356
+ cg.add(nid, text, layer="anchor", tags=tg, condition_space=cs,
357
+ importance=importance, verification_basis="data", override=override,
358
+ **extra)
359
+ log(cg, {"op": "contract", "contract_id": cid, "node_id": nid,
360
+ "grantee": gtee, "override": bool(override)})
361
+ return {"ok": True, "node_id": nid, "contract_id": cid, "layer": "anchor",
362
+ "protected": True, "immutable": True, "status_hash": sh,
363
+ "fields": dict(fields), "doc_ref": extra.get("doc_ref")}
364
+
365
+
366
+ # 生效条件:cg.get(contract_node_id(contract_id)) 返回假值(None/{})时返回 {"ok": False, contract_id, node_id, error};否则取 frontmatter 拼五字段原值、status_hash、status_hash_match(=status_hash 与按五字段重算的 contract_status_hash 相等)、doc_ref/condition_ref/state_ref/tags,返回含 ok=True 的 dict。
367
+ def contract(cg, contract_id):
368
+ """按 contract_id 取单条契约记录(只读;含 status_hash 自校验读数)。"""
369
+ nid = contract_node_id(contract_id)
370
+ node = cg.get(nid)
371
+ if not node:
372
+ return {"ok": False, "contract_id": str(contract_id or ""),
373
+ "node_id": nid, "error": "未找到契约记录"}
374
+ fm = node.get("frontmatter") or {}
375
+ fields = {k: fm.get(k) for k in CONTRACT_HASH_FIELDS}
376
+ sh = fm.get("status_hash")
377
+ return {"ok": True, "node_id": nid, "layer": fm.get("layer"),
378
+ **fields, "status_hash": sh,
379
+ "status_hash_match": sh == contract_status_hash(fields),
380
+ "doc_ref": fm.get("doc_ref"),
381
+ "condition_ref": fm.get("condition_ref"),
382
+ "state_ref": fm.get("state_ref"), "tags": fm.get("tags")}
383
+
384
+
385
+ # 生效条件:遍历 cg.index.get("nodes")(缺键/假值时取 {})中 tags 含 TAG_CONTRACT 的节点,subject 为真值时再要求 tags 含 f"subject:{subject}";对每个命中节点取 frontmatter 拼五字段+status_hash+status_hash_match+doc_ref,按 (timestamp 字符串, node_id) 升序排序,返回 {"contracts": [...], "count": n}。
386
+ def contracts(cg, subject=None):
387
+ """契约记录反查(只读):全部,或按接收方 `subject:<grantee>` 过滤。"""
388
+ nodes = cg.index.get("nodes") or {}
389
+ out = []
390
+ for nid, e in list(nodes.items()):
391
+ tg = set(e.get("tags") or [])
392
+ if TAG_CONTRACT not in tg:
393
+ continue
394
+ if subject and f"subject:{subject}" not in tg:
395
+ continue
396
+ node = cg.get(nid)
397
+ fm = (node or {}).get("frontmatter") or {}
398
+ fields = {k: fm.get(k) for k in CONTRACT_HASH_FIELDS}
399
+ out.append({"node_id": nid, "layer": e.get("layer"), **fields,
400
+ "status_hash": fm.get("status_hash"),
401
+ "status_hash_match": fm.get("status_hash")
402
+ == contract_status_hash(fields),
403
+ "doc_ref": fm.get("doc_ref")})
404
+ out.sort(key=lambda r: (str(r.get("timestamp") or ""), r["node_id"]))
405
+ return {"contracts": out, "count": len(out)}
406
+
407
+
408
+ # --------------------------------------------------------------------------
409
+ # 位置效应推断(智能论 v3.4 §十三)
410
+ # --------------------------------------------------------------------------
411
+
412
+ # 生效条件:tags 先转为 set(tags or []) 后并列判定——role 属于 ("command","tool-output") 或 layer 等于 "contextual" 则加 "record";tags 与 _POSITION_TAGS 各项标记集有交集则加对应 pos;ev_pos 或 ev_neg 为真值则加 "verify";role 属于 ("user","assistant") 或 tags 中任一字符串以 "cap:" 开头则加 "output";layer 等于 "goals" 则加 "sustain";返回该并集。
413
+ def _votes(role, layer, tags, vb, ev_pos, ev_neg):
414
+ """把一条行为证据映射到位置效应候选(可多面)。规则可审计、可扩展。"""
415
+ tags = set(tags or [])
416
+ v = set()
417
+ if role in ("command", "tool-output") or layer == "contextual":
418
+ v.add("record")
419
+ for pos, marks in _POSITION_TAGS.items():
420
+ if tags & marks:
421
+ v.add(pos)
422
+ if ev_pos or ev_neg:
423
+ v.add("verify")
424
+ if role in ("user", "assistant") or any(
425
+ isinstance(t, str) and t.startswith("cap:") for t in tags):
426
+ v.add("output")
427
+ if layer == "goals":
428
+ v.add("sustain")
429
+ return v
430
+
431
+
432
+ # 生效条件:遍历 cg.index.get("nodes")(缺键或值为假时取空 dict,此时必然返回 position=unknown、confidence=0.0、votes={}),仅统计标签含 "subject:<subject_id>" 且不含 TAG_ANCHOR/TAG_TRAIT 的节点,票由 _votes 得出;无任何票时返回 unknown/0.0/{};有票时 winners 为 POSITION_ORDER 中票数等于最高票的位置,position 取 winners[0],confidence=round(top/total, 3),多赢家时以 tie 列出。
433
+ def infer_position(cg, subject_id):
434
+ """按该主体的行为证据投票推断位置效应(带 confidence / votes,可审计)。
435
+
436
+ 只统计带 `subject:<id>` 标签、且**非档案节点**(锚点/特征)的证据节点,
437
+ 避免档案自证。返回 position=unknown 表示证据不足。
438
+ """
439
+ tag = f"subject:{subject_id}"
440
+ nodes = cg.index.get("nodes") or {}
441
+ votes, n = {}, 0
442
+ for nid, e in list(nodes.items()):
443
+ tg = set(e.get("tags") or [])
444
+ if tag not in tg or (tg & {TAG_ANCHOR, TAG_TRAIT}):
445
+ continue
446
+ node = cg.get(nid) or {}
447
+ # issue #471((b) 的精确定位):本函数**已经**经 `cg.get`(`get` 面上有 `_readable`),
448
+ # 所以**正文拿不到**;但 `n += 1` 在取到空节点时**仍会执行** => 泄漏的不是内容,而是
449
+ # **计数(evidence_count)** —— 低权读者可由「某主体有多少条证据」推断其存在与活跃度。
450
+ # 故:**不可见 ⇒ 空 ⇒ 不得计入**(不是再套一层闸,而是「空即跳过」)。
451
+ if not node:
452
+ continue
453
+ fm = node.get("frontmatter") or {}
454
+ n += 1
455
+ for pos in _votes(fm.get("role"), e.get("layer"), e.get("tags"),
456
+ e.get("verification_basis"), fm.get("positive_evidence"),
457
+ fm.get("negative_evidence")):
458
+ votes[pos] = votes.get(pos, 0) + 1
459
+ if not votes:
460
+ return {"position": "unknown", "confidence": 0.0, "votes": {},
461
+ "evidence_count": n, "tie": []}
462
+ top = max(votes.values())
463
+ winners = [p for p in POSITION_ORDER if votes.get(p) == top]
464
+ total = sum(votes.values())
465
+ return {"position": winners[0], "confidence": round(top / total, 3),
466
+ "votes": votes, "evidence_count": n,
467
+ "tie": winners if len(winners) > 1 else []}
468
+
469
+
470
+ # 生效条件:pos 取自 POSITIONS,缺键时以空 dict 兜底,故未知 pos 返回 {"position": pos, "unit": None, "effect": None, "duty": None}。
471
+ def _position_view(pos):
472
+ meta = POSITIONS.get(pos) or {}
473
+ return {"position": pos, "unit": meta.get("unit"),
474
+ "effect": meta.get("effect"), "duty": meta.get("duty")}
475
+
476
+
477
+ # 生效条件:仅遍历标签含 "subject:<subject_id>" 的节点,其中带 TAG_ANCHOR 者进 anchors,否则(elif)带 TAG_TRAIT 者进 traits——两标签同时存在时只进 anchors、不进 traits;anchor 取 anchors[0] 或 None;位置相关字段来自 infer_position(cg, subject_id)。
478
+ def profile(cg, subject_id):
479
+ """主体画像 = 身份锚点 + 位置效应 + 条件特征(取代单一「用户画像」)。"""
480
+ k, name = split_subject(subject_id)
481
+ tag = f"subject:{subject_id}"
482
+ nodes = cg.index.get("nodes") or {}
483
+ anchors, traits = [], []
484
+ for nid, e in list(nodes.items()):
485
+ tg = set(e.get("tags") or [])
486
+ if tag not in tg:
487
+ continue
488
+ node = cg.get(nid) or {}
489
+ # issue #471((c1)):与 (b) 同款「**空即跳过**」——`cg.get` 已过 `_readable`,
490
+ # 不可见 ⇒ 空 ⇒ **不得进 anchors/traits**(否则 `content[:400]`/`content[:200]`
491
+ # 会把 **private 节点正文片段**吐给低权读者 —— 这是本件最重的一项泄漏)。
492
+ # ★(c2) 本件不做并已登记:profile 的**锚点/指针面**未加闸,因 `_identity_ref`
493
+ # (self_state.py:344) 无读者身份参数、无法区分自我调用与外部调用 —— 属**独立设计问题**。
494
+ if not node:
495
+ continue
496
+ fm = node.get("frontmatter") or {}
497
+ if TAG_ANCHOR in tg:
498
+ anchors.append({"node_id": nid, "layer": e.get("layer"),
499
+ "content": (node.get("content") or "")[:400]})
500
+ elif TAG_TRAIT in tg:
501
+ traits.append({"node_id": nid, "layer": e.get("layer"),
502
+ "content": (node.get("content") or "")[:200],
503
+ "condition_space": fm.get("condition_space"),
504
+ "importance": fm.get("importance")})
505
+ pos = infer_position(cg, subject_id)
506
+ out = {"subject_id": subject_id, "kind": k, "name": name,
507
+ "anchor": anchors[0] if anchors else None, "anchors": anchors,
508
+ "traits": traits, "traits_count": len(traits)}
509
+ out.update(_position_view(pos["position"]))
510
+ out.update({"position_confidence": pos["confidence"], "votes": pos["votes"],
511
+ "evidence_count": pos["evidence_count"], "tie": pos["tie"]})
512
+ return out
513
+
514
+
515
+ # 生效条件:counts 按每个以 "subject:" 开头的字符串标签出现次数累加(即标签次数,不是节点数),按 (-次数, sid) 排序后逐个 sid 调 infer_position;limit 为 0/None/空串等使 `limit and int(limit) > 0` 为假时返回全量 out,仅当 limit 为真值且 int(limit) > 0 时返回前 int(limit) 项。
516
+ def positions(cg, limit=0):
517
+ """所有主体的位置效应分布(OS 视角:谁在记录/反思/验证/输出/维生)。"""
518
+ nodes = cg.index.get("nodes") or {}
519
+ # issue #471:**fail-soft 可见性闸** —— 照抄 `rollback.py:501` 的既有先例(getattr + callable)。
520
+ # ★**纯 MdCGOS 无 `_readable` ⇒ 不过滤(fail-soft)**:这是**有意选择、不是疏漏**。
521
+ # 理由:**同一函数在两种 cg 类型下语义不同**,而 `_readable` 只在 `MdCGSecure` 面上存在
522
+ # —— 这本身就是「**同名不同面**」,故在此显式登记。
523
+ _rd = getattr(cg, "_readable", None)
524
+ counts = {}
525
+ for _nid_, e in list(nodes.items()):
526
+ if callable(_rd) and not _rd(e):
527
+ continue # 不可见节点不参与主体枚举(#471 主影响面)
528
+ for t in (e.get("tags") or []):
529
+ if isinstance(t, str) and t.startswith("subject:"):
530
+ sid = t[len("subject:"):]
531
+ counts[sid] = counts.get(sid, 0) + 1
532
+ out = []
533
+ for sid, cnt in sorted(counts.items(), key=lambda kv: (-kv[1], kv[0])):
534
+ p = infer_position(cg, sid)
535
+ out.append({"subject_id": sid, "kind": split_subject(sid)[0],
536
+ "nodes": cnt, "position": p["position"],
537
+ "confidence": p["confidence"], "evidence_count": p["evidence_count"]})
538
+ return out[:int(limit)] if limit and int(limit) > 0 else out
539
+
540
+
541
+ # 生效条件:cg.root/AUDIT_FILE 不存在时返回 0;否则逐行统计 strip() 后非空的行数,读取途中抛 OSError 时返回已累计的 n。
542
+ def _audit_count(cg):
543
+ p = os.path.join(cg.root, AUDIT_FILE)
544
+ if not os.path.exists(p):
545
+ return 0
546
+ n = 0
547
+ try:
548
+ with open(p, "r", encoding="utf-8") as f:
549
+ for line in f:
550
+ if line.strip():
551
+ n += 1
552
+ except OSError:
553
+ return n
554
+ return n
555
+
556
+
557
+ # 生效条件:以 positions(cg)(limit 缺省 0,返回全量)得主体列表并按各自 position 聚合计数,与 _audit_count(cg) 一并返回 subjects/by_position/audit_records。
558
+ def summary(cg):
559
+ """身份面汇总:主体数 + 位置分布(供 health / 运维审计,流式计数不载全量)。"""
560
+ ps = positions(cg)
561
+ dist = {}
562
+ for s in ps:
563
+ dist[s["position"]] = dist.get(s["position"], 0) + 1
564
+ return {"subjects": len(ps), "by_position": dist,
565
+ "audit_records": _audit_count(cg)}
566
+
567
+
568
+ # 生效条件:无入参,恒返回 POSITION_ORDER 中每个 p 的 POSITIONS[p] 副本、INTERFACES 各值副本以及 list(SUBJECT_KIND)。
569
+ def catalog():
570
+ """自描述:位置效应表 + 三接口(供 MCP / 文档对照协议验证)。"""
571
+ return {"positions": {p: dict(POSITIONS[p]) for p in POSITION_ORDER},
572
+ "interfaces": {k: dict(v) for k, v in INTERFACES.items()},
573
+ "kinds": list(SUBJECT_KIND)}