@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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