@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,346 +1,427 @@
1
- # -*- coding: utf-8 -*-
2
- """md_cg · 节点显式生命周期状态机(可学习优点 ②·显式状态机)
3
-
4
- 出处(pi):
5
- 运行操作 = 13 个**叶子显式状态机**(`session/types.ts:315-329`),drive 循环按
6
- `at` 分发;一轮无任何进展即抛 `SessionInvariantError`(`drive.ts:101-104`)
7
- ——非法迁移在**结构上不可能**,而不是靠调用方自觉。
8
-
9
- 灵枢现状(本模块要收口的四处散落状态):
10
- · `writelimit._demote` 用 **tag** `tidy:converged` 记「同构聚合已定型」
11
- · `forgetting.reinforce` 用 **importance** 升降记「强化 / 弱化」
12
- · `protect` 用 **fm.protected** 记「不可遗忘」
13
- · `_evolution/ledger.md` 记账本
14
- 四种载体各说各话:谁都能把已定型节点再降一次权、把归档节点悄悄覆写成新的,
15
- 而**没有任何地方校验「这一步迁移合不合法」**。
16
-
17
- 本模块是该问题的唯一真源:状态集 `STATES` + 合法迁移表 `TRANSITIONS` + 单点裁决
18
- `check()` + 单点推进 `set_state()`。口径:
19
-
20
- · 状态落 **frontmatter.lifecycle_state**(节点 md 是唯一真源);索引快照带同名字
21
- 段 →「免读文件可查」(`_index.json` 即可回答「这节点什么状态」)。
22
- **为何不叫 `state`**(对交接文档建议集的偏离,取证理由):`state` 在 md_cg 内
23
- 已被**裁决四态**(ACCEPT/REJECT/DEFER/BLINDSPOT)占用——`audit._verdict` 的返
24
- 回体、`judge_qualification()` 的返回、`mdcos.search` 结果项、检索结果条目的
25
- `entry["state"]` 全都用它。若生命周期也叫 `state`,则同一外层结构里
26
- `entry["state"]`(裁决)与 `entry["frontmatter"]["state"]`(生命周期)并存,
27
- 人类与 agent 读面必生歧义;本仓既有 `self_state` 即为同一动机的先例。
28
- 故取 `lifecycle_state`:语义自明、零歧义。
29
- · 存量节点**缺 state 即视为 active**(`state_of` 的缺省),故不回填也能工作;
30
- `backfill()` 提供一次性回填(幂等、可 dry-run)。
31
- · **受保护节点豁免降级**:`protected`/`immutable` 节点不接受降级迁移,需
32
- `override=True` 显式放行——「保护 = 不可遗忘」在状态层的落点。
33
- · 非法迁移**拒绝**(负路由):`check()` 返回 `(ok, code, reason)`,`set_state()`
34
- 返回 `ok=False` + 机器可读 `error` 而不抛;写路径要硬拒用 `require_transition()`。
35
- · 永不删除:`archived` 只是状态,节点文件仍在(可逆、可审计)。
36
- · 幂等:同状态迁移是 no-op(不写盘、不留痕)——重复发起不会把历史刷爆。
37
-
38
- 状态语义(建议集,逐级降级 / 逐级回升):
39
- active 正常:参与检索与写入面
40
- converged 已定型:同构聚合的成员(writelimit tidy 的落点)
41
- demoted 已降权:importance 被下调(forgetting 弱化的落点)
42
- archived 已归档:不再参与默认检索,但文件保留、可显式恢复
43
- """
44
- from __future__ import annotations
45
-
46
- import os
47
- import time
48
-
49
- from .fsutil import append_jsonl
50
-
51
- #: 状态全集。顺序即「降级方向」:active → converged → demoted → archived。
52
- STATES = ("active", "converged", "demoted", "archived")
53
- #: frontmatter 字段名(索引快照同名透出)。刻意避开 `state`——见模块 docstring
54
- #: 「为何不叫 state」:该名已被裁决四态占用,同名会让读面产生歧义。
55
- STATE_FIELD = "lifecycle_state"
56
- #: 迁移留痕字段(frontmatter 侧历史,滚动保留最近 HISTORY_KEEP 条)
57
- HISTORY_FIELD = "state_history"
58
- HISTORY_KEEP = 20
59
- #: 状态迁移审计(append-only,与 _forgetting.jsonl / _maintain.jsonl 同风格)
60
- AUDIT_FILE = "_lifecycle.jsonl"
61
-
62
- #: 降级序位(用于「受保护豁免降级」的判定)
63
- _RANK = {"active": 0, "converged": 1, "demoted": 2, "archived": 3}
64
-
65
- #: 合法迁移表——**逐级降级、逐级回升**,不跳级:
66
- #: active ⇄ converged 定型 / 定型撤销
67
- #: active → demoted 直接弱化(forgetting 降权)
68
- #: converged → demoted 定型后再弱化
69
- #: demoted ⇄ active 被强化回升 / 再弱化
70
- #: demoted → archived 归档
71
- #: archived → active 显式恢复
72
- #: 刻意不收录的(即拒绝的):active→archived(跳级归档)、archived→converged /
73
- #: archived→demoted(跳级回落)、converged→archived(跳级归档)。
74
- TRANSITIONS = frozenset({
75
- ("active", "converged"),
76
- ("active", "demoted"),
77
- ("converged", "active"),
78
- ("converged", "demoted"),
79
- ("demoted", "active"),
80
- ("demoted", "archived"),
81
- ("archived", "active"),
82
- })
83
-
84
-
85
- # 生效条件:以 src、dst、code、reason 四个实参构造时,父类 ValueError 消息由 f-string 拼成「非法状态迁移 src→dst(code):reason」,并把四个值分别存为同名属性。
86
- class TransitionError(ValueError):
87
- """非法生命周期迁移(写路径用 `require_transition` 直接抛这个)。"""
88
-
89
- # 生效条件:接收 src、dst、code、reason 四个实参,调用 super().__init__ 传入 f"非法状态迁移 {src}→{dst}({code}):{reason}",并将四者依次赋给 self.src、self.dst、self.code、self.reason。
90
- def __init__(self, src, dst, code, reason):
91
- super().__init__(f"非法状态迁移 {src}→{dst}({code}):{reason}")
92
- self.src, self.dst, self.code, self.reason = src, dst, code, reason
93
-
94
-
95
- # ---------------------------------------------------------------- 纯函数裁决
96
-
97
- # 生效条件:fm 非 dict 直接返回 "active";fm 为 dict 时取 fm.get(STATE_FIELD),该值属于 STATES 则原样返回,缺键或值不在 STATES 均返回 "active"。
98
- def state_of(fm) -> str:
99
- """frontmatter → 状态;缺字段或未知值 → "active"(存量兼容,不猜测)。"""
100
- if not isinstance(fm, dict):
101
- return "active"
102
- s = fm.get(STATE_FIELD)
103
- return s if s in STATES else "active"
104
-
105
-
106
- # 生效条件:入参 e 为索引条目(或同形 frontmatter 副本)时返回 state_of(e) == "archived" 的布尔结果;缺 STATE_FIELD 或取值不在 STATES 时 state_of 回落 "active" ⇒ 返回 False。
107
- def is_archived(e) -> bool:
108
- """默认检索剔除面=本函数(判据单点)。
109
-
110
- `archived` 的语义(模块 docstring :42)是「不再参与**默认检索**」——本函数是该
111
- 宣称的**唯一判据**,全部消费点共同引用(判据单点,多个消费点):
112
-
113
- · cg 检索面:`MdCGOS._candidates`(mdcos.py)——`MdCGSecure._candidates` 经
114
- `super()` 覆盖叠加读可见性,故全部**检索类** cg 读 op(search / search_rrf /
115
- recall / route…)都经它;
116
- · stg 扫描面:`stg._scan_one`(stg.py,`_scan` 的逐条实现单点)——timeline /
117
- anchors / consistency 三 op 的候选面同点覆盖(`relation` 面是显式 id 直读,
118
- `state_chain` 走 append-only 台账,两者不经扫描面);
119
- · 会话续接注入面:`MdCGOS.session_recall`(mdcos.py)的四个取数段——会话要点
120
- `_session_notes`、活跃目标 `goals`、任务台账 `tasks`、未解问题 `unresolved`
121
- (`goals`/`tasks` 经 `_retired_by_id` 按 id 回查索引后交本判据)。该 op 是
122
- 「装配续接包注入上下文/回给调用方」的注入面,与检索面同属「退役即不再默认
123
- 回出」;它自持取数面(不经 `_candidates`),故单点接线(独立复核 2026-10-06
124
- 两轮实测:接线前 archived 要点摘要、未解问题正文、**活跃目标与任务卡**均经
125
- 该 op 照旧回出;`recent` 段是事件窗口、`self_state` 是只读快照卡,不含节点
126
- 条目,不涉退役)。
127
-
128
- **fail-open**(缺键/非法值 → active):存量节点不回填也照常参与检索
129
- (存量零迁移、不误剔);「不误剔」的另一半是**只剔 archived**——
130
- converged / demoted 是**降权轴**,仍参与默认检索。
131
-
132
- 不适用条件(**不**消费本函数,故 archived 期间照常可达):显式 id 直读
133
- (`cg.get`)、审计面(`op=audit`)、工程台账的**显式管理查询面**
134
- (`cg(op=goal, action=list)` / `cg(op=task, action=list)`;注意与消费面之别——
135
- 会话续接注入包内的对应段已按上表剔除,两者不冲突)、负记忆层
136
- (rejected / unresolved 的覆盖标记面)、统计面(health / whoami / conformance)
137
- ——「退役不删除、可显式恢复」的承诺要求它们在 archived 期间照常可达。
138
- 边界(已知未覆盖面,另立裁定):基类 `MdCG.search`、`chain.adjacency` 拓扑面、
139
- `subgraph.children_index/parents_index` 结构面、rust 检索内核。
140
- """
141
- return state_of(e) == "archived"
142
-
143
-
144
- # 生效条件:按 _RANK.get(dst, 0) > _RANK.get(src, 0) 判定,src 或 dst 不在 _RANK 键中时该侧按 0 参与比较。
145
- def is_downgrade(src: str, dst: str) -> bool:
146
- """是否向「更低」的状态迁移(active < converged < demoted < archived)。"""
147
- return _RANK.get(dst, 0) > _RANK.get(src, 0)
148
-
149
-
150
- # 生效条件:src 不在 STATES 时先替换为 "active";dst 不在 STATES 返回 False;替换后 src == dst 返回 True;否则返回 (src, dst) in TRANSITIONS 的布尔值。
151
- def can_transition(src, dst) -> bool:
152
- """迁移是否合法(含幂等;未知 src 按 active 处理)。"""
153
- src = src if src in STATES else "active"
154
- if dst not in STATES:
155
- return False
156
- if src == dst:
157
- return True # 幂等:同状态是 no-op
158
- return (src, dst) in TRANSITIONS
159
-
160
-
161
- # 生效条件:src 不在 STATES 时替换为 "active";dst 不在 STATES 返回 (False, 'unknown_state', ...);src == dst 返回 (True, 'noop', ...);(src, dst) 不在 TRANSITIONS 返回 (False, 'illegal_transition', ...);is_downgrade(src, dst) 且 protected 为真且 override 为假时返回 (False, 'protected', ...);其余返回 (True, 'ok', f'{src}→{dst} 合法')。
162
- def check(src, dst, protected: bool = False, override: bool = False):
163
- """迁移合法性裁决 → `(ok, code, reason)`。**唯一裁决点**(纯函数,无 IO)。
164
-
165
- code 取值:`ok` / `noop`(同状态,不写盘)/ `unknown_state` /
166
- `illegal_transition` / `protected`。
167
- """
168
- src = src if src in STATES else "active"
169
- if dst not in STATES:
170
- return False, "unknown_state", f"未知状态 {dst!r}(允许:{STATES})"
171
- if src == dst:
172
- return True, "noop", "状态未变(幂等,不写盘)"
173
- if (src, dst) not in TRANSITIONS:
174
- legal = "、".join(f"{a}→{b}" for a, b in sorted(TRANSITIONS))
175
- return False, "illegal_transition", (
176
- f"{src}→{dst} 不在合法迁移表内(允许:{legal})——"
177
- "降级与回升都须逐级,跨级迁移一律拒绝")
178
- if is_downgrade(src, dst) and protected and not override:
179
- return False, "protected", (
180
- f"受保护节点不接受降级迁移 {src}→{dst}(保护 = 不可遗忘);"
181
- "确需降级请显式 override=True")
182
- return True, "ok", f"{src}→{dst} 合法"
183
-
184
-
185
- # 生效条件:以 src、dst、protected、override 调 check 后,ok 为真时返回其 code,ok 为假时抛 TransitionError,抛出时 src 参数在 STATES 中则原样、否则替换为 "active",dst、code、why 按源码透传。
186
- def require_transition(src, dst, protected: bool = False, override: bool = False):
187
- """合法则返回 code,非法则抛 `TransitionError`(写路径的硬拒入口)。"""
188
- ok, code, why = check(src, dst, protected=protected, override=override)
189
- if not ok:
190
- raise TransitionError(src if src in STATES else "active", dst, code, why)
191
- return code
192
-
193
-
194
- # 生效条件:src 取 state_of(fm),prot 取 bool(fm.get("protected") or fm.get("immutable"));check 返回 ok 假或 code == "noop" 时原样返回 (ok, code, why) 且不改 fm;否则把 dst 写入 fm[STATE_FIELD],并把含 at/from/to/reason/actor 的新条目追加到由 fm.get(HISTORY_FIELD) or [] 复制的列表、截取末 HISTORY_KEEP 条写回 fm[HISTORY_FIELD],返回 (True, code, why)。
195
- def stamp(fm: dict, dst: str, reason: str = None, actor: str = None,
196
- override: bool = False):
197
- """在给定 frontmatter 上**就地**推进状态(无 IO)→ `(ok, code, why)`。
198
-
199
- 与 `set_state()` 共用同一裁决点(`check`),供**需与其他字段同批落盘**的收
200
- 口点使用——`writelimit` 的降权要一次写盘改 tags/importance/状态,`forgetting`
201
- 的强化同理;否则状态得单独再写一次盘(同一节点两倍 IO)。
202
- 合法且非幂等时写入 `STATE_FIELD` 并追加 `HISTORY_FIELD`;失败/幂等不动 fm。
203
- """
204
- src = state_of(fm)
205
- prot = bool(fm.get("protected") or fm.get("immutable"))
206
- ok, code, why = check(src, dst, protected=prot, override=override)
207
- if not ok or code == "noop":
208
- return ok, code, why
209
- fm[STATE_FIELD] = dst
210
- hist = list(fm.get(HISTORY_FIELD) or [])
211
- hist.append({"at": time.time(), "from": src, "to": dst,
212
- "reason": reason, "actor": actor})
213
- fm[HISTORY_FIELD] = hist[-HISTORY_KEEP:]
214
- return True, code, why
215
-
216
-
217
- # ---------------------------------------------------------------- 索引同步
218
-
219
- # 生效条件:cg.index 非 dict 时静默 return;index 的 "nodes" 中查不到 node_id 时 return;否则把 fm.get(STATE_FIELD)(缺键即 None)写入该条目,cg._dirty 为 dict 时记入该条目并调用可调用的 cg.flush。
220
- def _sync_index(cg, node_id, fm) -> None:
221
- """把 state 同步进索引快照(免读文件可查);无索引实现时静默跳过。
222
-
223
- 只同步 `state` 一个键:迁移历史已在 frontmatter 与 `_lifecycle.jsonl` 留痕,
224
- 放进索引会让快照无谓膨胀。
225
- """
226
- idx = getattr(cg, "index", None)
227
- if not isinstance(idx, dict):
228
- return
229
- e = (idx.get("nodes") or {}).get(node_id)
230
- if e is None:
231
- return
232
- e[STATE_FIELD] = fm.get(STATE_FIELD)
233
- dirty = getattr(cg, "_dirty", None)
234
- if isinstance(dirty, dict):
235
- dirty[node_id] = e
236
- flush = getattr(cg, "flush", None)
237
- if callable(flush):
238
- flush()
239
-
240
-
241
- # ---------------------------------------------------------------- 推进 / 回填
242
-
243
- # 生效条件:cg.get(node_id) 为假值返回 {'ok': False, 'error': 'node_not_found', ...};否则以 state_of(fm) 作 src 调 stamp——stamp 不 ok 返回 ok=False + error=code,code == "noop" 返回 ok=True + changed=False;其余情况(合法且真迁移,即**资格面已过**)先经 autonomy_modes.e_gate() 档位判定(补强批次 v1.2·E 面接线,位置=写盘之前):非 ALLOW(plan 档无计划)即经 forbidden_result() fail-closed 早退(ok=False、error=autonomy_forbidden、零写盘、零审计行),ALLOW(confirm/full)才取 fm[HISTORY_FIELD][-1]["at"] 后写盘、_sync_index 并追加审计 JSONL(append_jsonl 抛异常被吞掉),返回 ok=True + changed=True。
244
- def set_state(cg, node_id: str, dst: str, reason: str = None,
245
- actor: str = None, override: bool = False) -> dict:
246
- """推进一个节点的生命周期状态(**唯一推进入口**)。
247
-
248
- 非法迁移不走异常而是返回 `{"ok": False, "error": <code>, ...}`(负路由:
249
- 调用方自行决定降级处理;要硬拒请用 `require_transition`)。幂等迁移返回
250
- `changed=False` 且不写盘。返回体始终带 `from` / `to` / `code` 便于审计。
251
-
252
- **档位闸(补强批次 v1.2·E 面接线)**:合法且真迁移(`stamp` 已过=资格面
253
- 已过)之后、写盘之前,先经 `autonomy_modes.e_gate()`(设计 §三 plan 档
254
- E「须命中计划步骤」)——plan 档无计划 ⇒ fail-closed 早退(
255
- `ok=False`/`error="autonomy_forbidden"`/带 hint、零写盘、零审计行);
256
- confirm/full ⇒ ALLOW、**原链原样**(逐位不变)。非法迁移与 noop 由
257
- `stamp` 先行裁决、各回各的 code(档位**不参与**资格判定)。
258
- """
259
- node = cg.get(node_id)
260
- if not node:
261
- return {"ok": False, "error": "node_not_found", "node_id": node_id}
262
- fm = dict(node.get("frontmatter") or {})
263
- src = state_of(fm)
264
- ok, code, why = stamp(fm, dst, reason=reason, actor=actor, override=override)
265
- base = {"node_id": node_id, "from": src, "to": dst, "code": code}
266
- if not ok:
267
- return {**base, "ok": False, "error": code, "reason": why}
268
- if code == "noop":
269
- return {**base, "ok": True, "changed": False, "reason": why}
270
- # 三档自治(补强批次 v1.2·E 面接线,设计 §三 plan 档 E「须命中计划步骤」):
271
- # 位置=资格面(`stamp` 的合法性/保护裁决)之后、写盘之前——非法迁移与 noop
272
- # 已在上方各回各的 code,档位不参与资格判定;confirm/full ⇒ ALLOW 原链原样。
273
- from . import autonomy_modes as _am
274
- _dec = _am.e_gate()
275
- if _dec["decision"] != _am.ALLOW:
276
- out = _am.forbidden_result(_dec, node_id=node_id, changed=False)
277
- out.update({"from": src, "to": dst, "code": "autonomy_forbidden"})
278
- return out
279
- at = fm[HISTORY_FIELD][-1]["at"]
280
- cg._write_node(node_id, os.path.join(cg.root, node["path"]), fm,
281
- node.get("content") or "")
282
- _sync_index(cg, node_id, fm)
283
- # 退役接线(2026-10-06):状态迁移改变 `is_archived` 读数 ⇒ 依赖该判据的
284
- # 邻接缓存(`chain.adjacency` 的 skip_archived 过滤)必须**同点作废**——
285
- # 此前只有本地写路径(add/_stage 尾三连)清缓存,set_state 后旧缓存会让
286
- # 退役节点继续沿因果链/图面扩散(本批探针实证:归档后 causal_chain 仍含
287
- # 目标)。懒导入避免模块环;`invalidate_cache` 内部自吞异常,不阻断推进。
288
- from . import chain as _chain
289
- _chain.invalidate_cache(cg)
290
- try:
291
- append_jsonl(os.path.join(cg.root, AUDIT_FILE), {
292
- "t": at, "action": "set_state", "node_id": node_id,
293
- "from": src, "to": dst, "reason": reason, "actor": actor,
294
- "override": bool(override)})
295
- except Exception: # 审计失败不阻断状态推进
296
- pass
297
- return {**base, "ok": True, "changed": True, "reason": why, "at": at}
298
-
299
-
300
- # 生效条件:nodes 取 (cg.index or {}).get("nodes") or {},遍历中缺 STATE_FIELD 或该值不在 STATES 的 nid 计入 missing(累计数达 limit 即 break,limit <= 0 时立即 break 使 missing 为空),apply 假值只返回 dry_run=True 的盘点结果(**不接档位闸**——零写盘面照旧),apply 为真时先经 autonomy_modes.e_gate() 档位判定(补强批次 v1.2·E 面接线,位置=盘点资格面之后、写盘之前):非 ALLOW(plan 档无计划)即经 forbidden_result() fail-closed 早退(零写盘、backfilled=0),ALLOW(confirm/full)才对每个 missing 中 cg.get 取不到的记入 failed、取到的把 state_of(fm) 显式写回 fm[STATE_FIELD] 并写盘与 _sync_index 后记入 done,返回 dry_run=False 的结果。
301
- def backfill(cg, apply: bool = False, limit: int = 5000) -> dict:
302
- """存量回填:把缺 `state` 的节点显式补成 `active`(幂等)。
303
-
304
- 缺字段本就按 active 解释(`state_of`),故回填**不是让功能工作的前提**,
305
- 而是把「缺省」变成「显式」——索引/审计里从此可直接读到状态。
306
- `apply=False`(默认)只盘点。写不动(文件取不回)的节点进 `failed` 如实上报。
307
-
308
- **档位闸(补强批次 v1.2·E 面接线)**:`apply=True` 的**写盘前**先经
309
- `autonomy_modes.e_gate()`(设计 §三 plan 档 E「须命中计划步骤」)——plan 档
310
- 无计划 ⇒ fail-closed 早退(零写盘、`backfilled=0`);confirm/full ⇒ ALLOW、
311
- 原链原样。`apply=False`(盘点)不接闸。
312
- """
313
- nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
314
- missing = []
315
- for nid, e in list(nodes.items()):
316
- if len(missing) >= limit:
317
- break
318
- if (e or {}).get(STATE_FIELD) in STATES:
319
- continue
320
- missing.append(nid)
321
- missing.sort()
322
- if not apply:
323
- return {"ok": True, "dry_run": True, "scanned": len(nodes),
324
- "missing": len(missing), "planned": missing[:50]}
325
- # 三档自治(补强批次 v1.2·E 面接线):E 类动作**写盘前**的档位判定单点
326
- # (同 `set_state` 口径)——盘点(资格面)已完成、任何盘面写入之前。
327
- from . import autonomy_modes as _am
328
- _dec = _am.e_gate()
329
- if _dec["decision"] != _am.ALLOW:
330
- return _am.forbidden_result(_dec, dry_run=False, scanned=len(nodes),
331
- missing=len(missing), backfilled=0)
332
- done, failed = [], []
333
- for nid in missing:
334
- node = cg.get(nid)
335
- if not node:
336
- failed.append(nid)
337
- continue
338
- fm = dict(node.get("frontmatter") or {})
339
- fm[STATE_FIELD] = state_of(fm) # 缺省 active → 显式落盘
340
- cg._write_node(nid, os.path.join(cg.root, node["path"]), fm,
341
- node.get("content") or "")
342
- _sync_index(cg, nid, fm)
343
- done.append(nid)
344
- return {"ok": True, "dry_run": False, "scanned": len(nodes),
345
- "missing": len(missing), "backfilled": len(done),
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · 节点显式生命周期状态机(可学习优点 ②·显式状态机)
3
+
4
+ 出处(pi):
5
+ 运行操作 = 13 个**叶子显式状态机**(`session/types.ts:315-329`),drive 循环按
6
+ `at` 分发;一轮无任何进展即抛 `SessionInvariantError`(`drive.ts:101-104`)
7
+ ——非法迁移在**结构上不可能**,而不是靠调用方自觉。
8
+
9
+ 灵枢现状(本模块要收口的四处散落状态):
10
+ · `writelimit._demote` 用 **tag** `tidy:converged` 记「同构聚合已定型」
11
+ · `forgetting.reinforce` 用 **importance** 升降记「强化 / 弱化」
12
+ · `protect` 用 **fm.protected** 记「不可遗忘」
13
+ · `_evolution/ledger.md` 记账本
14
+ 四种载体各说各话:谁都能把已定型节点再降一次权、把归档节点悄悄覆写成新的,
15
+ 而**没有任何地方校验「这一步迁移合不合法」**。
16
+
17
+ 本模块是该问题的唯一真源:状态集 `STATES` + 合法迁移表 `TRANSITIONS` + 单点裁决
18
+ `check()` + 单点推进 `set_state()`。口径:
19
+
20
+ · 状态落 **frontmatter.lifecycle_state**(节点 md 是唯一真源);索引快照带同名字
21
+ 段 →「免读文件可查」(`_index.json` 即可回答「这节点什么状态」)。
22
+ **为何不叫 `state`**(对交接文档建议集的偏离,取证理由):`state` 在 md_cg 内
23
+ 已被**裁决四态**(ACCEPT/REJECT/DEFER/BLINDSPOT)占用——`audit._verdict` 的返
24
+ 回体、`judge_qualification()` 的返回、`mdcos.search` 结果项、检索结果条目的
25
+ `entry["state"]` 全都用它。若生命周期也叫 `state`,则同一外层结构里
26
+ `entry["state"]`(裁决)与 `entry["frontmatter"]["state"]`(生命周期)并存,
27
+ 人类与 agent 读面必生歧义;本仓既有 `self_state` 即为同一动机的先例。
28
+ 故取 `lifecycle_state`:语义自明、零歧义。
29
+ · 存量节点**缺 state 即视为 active**(`state_of` 的缺省),故不回填也能工作;
30
+ `backfill()` 提供一次性回填(幂等、可 dry-run)。
31
+ · **受保护节点豁免降级**:`protected`/`immutable` 节点不接受降级迁移,需
32
+ `override=True` 显式放行——「保护 = 不可遗忘」在状态层的落点。
33
+ #377(2026-10-14):判据改为**共用** `protect.is_protected`(∪ 原显式两位)
34
+ ——层保护(layer ∈ {self, anchor})与按分保护同样不受降级,`override=True`
35
+ 与 immutable 位两条既有通路逐位不变。
36
+ · 非法迁移**拒绝**(负路由):`check()` 返回 `(ok, code, reason)`,`set_state()`
37
+ 返回 `ok=False` + 机器可读 `error` 而不抛;写路径要硬拒用 `require_transition()`。
38
+ · 永不删除:`archived` 只是状态,节点文件仍在(可逆、可审计)。
39
+ · 幂等:同状态迁移是 no-op(不写盘、不留痕)——重复发起不会把历史刷爆。
40
+
41
+ 状态语义(建议集,逐级降级 / 逐级回升):
42
+ active 正常:参与检索与写入面
43
+ converged 已定型:同构聚合的成员(writelimit tidy 的落点)
44
+ demoted 已降权:importance 被下调(forgetting 弱化的落点)
45
+ archived 已归档:不再参与默认检索,但文件保留、可显式恢复
46
+ """
47
+ from __future__ import annotations
48
+
49
+ import os
50
+ import time
51
+
52
+ from . import protect
53
+ from .fsutil import append_jsonl
54
+
55
+ #: 状态全集。顺序即「降级方向」:active → converged → demoted → superseded → archived。
56
+ #:
57
+ #: superseded(2026-10-18 新增,使用者裁定方案 A):**被新版本取代的旧版本**。
58
+ #: 背景:revise 在内容寻址下必产新节点,旧版本若留 active 会污染检索面并撞 V4 同槽
59
+ #: 冲突;直接 archived 又违反「禁止跳级」。故单列一档,语义是「有新版、旧版退出默认
60
+ #: 检索面但保留可读可恢复」——与 archived(主动归档、不再需要)区分开。
61
+ STATES = ("active", "converged", "demoted", "superseded", "archived")
62
+ #: frontmatter 字段名(索引快照同名透出)。刻意避开 `state`——见模块 docstring
63
+ #: 「为何不叫 state」:该名已被裁决四态占用,同名会让读面产生歧义。
64
+ STATE_FIELD = "lifecycle_state"
65
+ #: 迁移留痕字段(frontmatter 侧历史,滚动保留最近 HISTORY_KEEP 条)
66
+ HISTORY_FIELD = "state_history"
67
+ HISTORY_KEEP = 20
68
+ #: 状态迁移审计(append-only,与 _forgetting.jsonl / _maintain.jsonl 同风格)
69
+ AUDIT_FILE = "_lifecycle.jsonl"
70
+
71
+ #: 降级序位(用于「受保护豁免降级」的判定)
72
+ _RANK = {"active": 0, "converged": 1, "demoted": 2, "superseded": 3, "archived": 4}
73
+
74
+ #: 合法迁移表——**逐级降级、逐级回升**,不跳级:
75
+ #: active ⇄ converged 定型 / 定型撤销
76
+ #: active → demoted 直接弱化(forgetting 降权)
77
+ #: converged → demoted 定型后再弱化
78
+ #: demoted ⇄ active 被强化回升 / 再弱化
79
+ #: demoted → archived 归档
80
+ #: archived → active 显式恢复
81
+ #: 刻意不收录的(即拒绝的):active→archived(跳级归档)、archived→converged /
82
+ #: archived→demoted(跳级回落)、converged→archived(跳级归档)。
83
+ TRANSITIONS = frozenset({
84
+ ("active", "converged"),
85
+ ("active", "demoted"),
86
+ ("converged", "active"),
87
+ ("converged", "demoted"),
88
+ ("demoted", "active"),
89
+ ("demoted", "archived"),
90
+ ("archived", "active"),
91
+ # ---- superseded(2026-10-18):修订取代 ----
92
+ # 任何在用状态都可被新版取代——取代不必先降权(与 active→demoted 同一先例)。
93
+ ("active", "superseded"),
94
+ ("converged", "superseded"),
95
+ ("demoted", "superseded"),
96
+ # 撤销取代(回滚到旧版本)/ 进一步归档
97
+ ("superseded", "active"),
98
+ ("superseded", "archived"),
99
+ # 刻意不收录:superseded→converged / superseded→demoted(不应回到降权轴——
100
+ # 被取代是「版本关系」,与「重要性弱化」是两个维度,混回降权轴会丢失取代语义)
101
+ })
102
+
103
+
104
+ # 生效条件:以 src、dst、code、reason 四个实参构造时,父类 ValueError 消息由 f-string 拼成「非法状态迁移 src→dst(code):reason」,并把四个值分别存为同名属性。
105
+ class TransitionError(ValueError):
106
+ """非法生命周期迁移(写路径用 `require_transition` 直接抛这个)。"""
107
+
108
+ # 生效条件:接收 src、dst、code、reason 四个实参,调用 super().__init__ 传入 f"非法状态迁移 {src}→{dst}({code}):{reason}",并将四者依次赋给 self.src、self.dst、self.code、self.reason。
109
+ def __init__(self, src, dst, code, reason):
110
+ super().__init__(f"非法状态迁移 {src}→{dst}({code}):{reason}")
111
+ self.src, self.dst, self.code, self.reason = src, dst, code, reason
112
+
113
+
114
+ # ---------------------------------------------------------------- 纯函数裁决
115
+
116
+ # 生效条件:fm 非 dict 直接返回 "active";fm 为 dict 时取 fm.get(STATE_FIELD),该值属于 STATES 则原样返回,缺键或值不在 STATES 均返回 "active"。
117
+ def state_of(fm) -> str:
118
+ """frontmatter → 状态;缺字段或未知值 → "active"(存量兼容,不猜测)。"""
119
+ if not isinstance(fm, dict):
120
+ return "active"
121
+ s = fm.get(STATE_FIELD)
122
+ return s if s in STATES else "active"
123
+
124
+
125
+ # 生效条件:入参 e 为索引条目(或同形 frontmatter 副本)时返回 state_of(e) == "archived" 的布尔结果;缺 STATE_FIELD 或取值不在 STATES 时 state_of 回落 "active" ⇒ 返回 False。
126
+ def is_archived(e) -> bool:
127
+ """默认检索剔除面=本函数(判据单点)。
128
+
129
+ `archived` 的语义(模块 docstring :42)是「不再参与**默认检索**」——本函数是该
130
+ 宣称的**唯一判据**,全部消费点共同引用(判据单点,多个消费点):
131
+
132
+ · cg 检索面:`MdCGOS._candidates`(mdcos.py)——`MdCGSecure._candidates` 经
133
+ `super()` 覆盖叠加读可见性,故全部**检索类** cg 读 op(search / search_rrf /
134
+ recall / route…)都经它;
135
+ · stg 扫描面:`stg._scan_one`(stg.py,`_scan` 的逐条实现单点)——timeline /
136
+ anchors / consistency 三 op 的候选面同点覆盖(`relation` 面是显式 id 直读,
137
+ `state_chain` 走 append-only 台账,两者不经扫描面);
138
+ · 会话续接注入面:`MdCGOS.session_recall`(mdcos.py)的四个取数段——会话要点
139
+ `_session_notes`、活跃目标 `goals`、任务台账 `tasks`、未解问题 `unresolved`
140
+ (`goals`/`tasks` 经 `_retired_by_id` 按 id 回查索引后交本判据)。该 op 是
141
+ 「装配续接包注入上下文/回给调用方」的注入面,与检索面同属「退役即不再默认
142
+ 回出」;它自持取数面(不经 `_candidates`),故单点接线(独立复核 2026-10-06
143
+ 两轮实测:接线前 archived 要点摘要、未解问题正文、**活跃目标与任务卡**均经
144
+ 该 op 照旧回出;`recent` 段是事件窗口、`self_state` 是只读快照卡,不含节点
145
+ 条目,不涉退役)。
146
+
147
+ **fail-open**(缺键/非法值 → active):存量节点不回填也照常参与检索
148
+ (存量零迁移、不误剔);「不误剔」的另一半是**只剔 archived**——
149
+ converged / demoted 是**降权轴**,仍参与默认检索。
150
+
151
+ 不适用条件(**不**消费本函数,故 archived 期间照常可达):显式 id 直读
152
+ (`cg.get`)、审计面(`op=audit`)、工程台账的**显式管理查询面**
153
+ (`cg(op=goal, action=list)` / `cg(op=task, action=list)`;注意与消费面之别——
154
+ 会话续接注入包内的对应段已按上表剔除,两者不冲突)、负记忆层
155
+ (rejected / unresolved 的覆盖标记面)、统计面(health / whoami / conformance)
156
+ ——「退役不删除、可显式恢复」的承诺要求它们在 archived 期间照常可达。
157
+ 边界(已知未覆盖面,另立裁定):基类 `MdCG.search`、`chain.adjacency` 拓扑面、
158
+ `subgraph.children_index/parents_index` 结构面、rust 检索内核。
159
+ """
160
+ return state_of(e) == "archived"
161
+
162
+
163
+ # 生效条件:入参 e 为索引条目(或同形 frontmatter 副本)时,state_of(e) 为 archived 或 superseded 即返回 True;缺键/非法值回落 active ⇒ False。
164
+ def is_retired(e) -> bool:
165
+ """**已退出默认检索面**的判据单点(archived ∪ superseded)。
166
+
167
+ 为什么单列而不改 is_archived(2026-10-18,方案 A 配套):
168
+ · is_archived 的名字与语义是「归档」,被多个消费点按字面引用;把 superseded
169
+ 塞进去会让「归档」与「被取代」两个不同理由共用一个名字,正是本仓反复吃过的
170
+ 「同一语义两份实现 / 一名多义」形态。
171
+ · 故保留 is_archived 原义(仅 archived),新增本函数表达「退役面」的并集;
172
+ 检索面/续接注入面改用本函数,显式管理查询面仍按 archived 单独判。
173
+
174
+ 边界:superseded 与 archived 一样——**退役不删除**,cg.get 照常可读、
175
+ 可显式恢复到 active(见 TRANSITIONS)。
176
+ """
177
+ return state_of(e) in ("archived", "superseded")
178
+
179
+
180
+ # 生效条件:按 _RANK.get(dst, 0) > _RANK.get(src, 0) 判定,src 或 dst 不在 _RANK 键中时该侧按 0 参与比较。
181
+ def is_downgrade(src: str, dst: str) -> bool:
182
+ """是否向「更低」的状态迁移(active < converged < demoted < archived)。"""
183
+ return _RANK.get(dst, 0) > _RANK.get(src, 0)
184
+
185
+
186
+ # 生效条件:src 不在 STATES 时先替换为 "active";dst 不在 STATES 返回 False;替换后 src == dst 返回 True;否则返回 (src, dst) in TRANSITIONS 的布尔值。
187
+ def can_transition(src, dst) -> bool:
188
+ """迁移是否合法(含幂等;未知 src 按 active 处理)。"""
189
+ src = src if src in STATES else "active"
190
+ if dst not in STATES:
191
+ return False
192
+ if src == dst:
193
+ return True # 幂等:同状态是 no-op
194
+ return (src, dst) in TRANSITIONS
195
+
196
+
197
+ # 生效条件:src 不在 STATES 时替换为 "active";dst 不在 STATES 返回 (False, 'unknown_state', ...);src == dst 返回 (True, 'noop', ...);(src, dst) 不在 TRANSITIONS 返回 (False, 'illegal_transition', ...);is_downgrade(src, dst) 且 protected 为真且 override 为假时返回 (False, 'protected', ...);其余返回 (True, 'ok', f'{src}→{dst} 合法')。
198
+ def check(src, dst, protected: bool = False, override: bool = False):
199
+ """迁移合法性裁决 → `(ok, code, reason)`。**唯一裁决点**(纯函数,无 IO)。
200
+
201
+ code 取值:`ok` / `noop`(同状态,不写盘)/ `unknown_state` /
202
+ `illegal_transition` / `protected`。
203
+ """
204
+ src = src if src in STATES else "active"
205
+ if dst not in STATES:
206
+ return False, "unknown_state", f"未知状态 {dst!r}(允许:{STATES})"
207
+ if src == dst:
208
+ return True, "noop", "状态未变(幂等,不写盘)"
209
+ if (src, dst) not in TRANSITIONS:
210
+ legal = "、".join(f"{a}→{b}" for a, b in sorted(TRANSITIONS))
211
+ return False, "illegal_transition", (
212
+ f"{src}→{dst} 不在合法迁移表内(允许:{legal})——"
213
+ "降级与回升都须逐级,跨级迁移一律拒绝")
214
+ if is_downgrade(src, dst) and protected and not override:
215
+ return False, "protected", (
216
+ f"受保护节点不接受降级迁移 {src}→{dst}(保护 = 不可遗忘);"
217
+ "确需降级请显式 override=True")
218
+ return True, "ok", f"{src}→{dst} 合法"
219
+
220
+
221
+ # 生效条件:以 src、dst、protected、override 调 check 后,ok 为真时返回其 code,ok 为假时抛 TransitionError,抛出时 src 参数在 STATES 中则原样、否则替换为 "active",dst、code、why 按源码透传。
222
+ def require_transition(src, dst, protected: bool = False, override: bool = False):
223
+ """合法则返回 code,非法则抛 `TransitionError`(写路径的硬拒入口)。"""
224
+ ok, code, why = check(src, dst, protected=protected, override=override)
225
+ if not ok:
226
+ raise TransitionError(src if src in STATES else "active", dst, code, why)
227
+ return code
228
+
229
+
230
+ # 生效条件:src 取 state_of(fm),prot 取 bool(fm.get("protected") or fm.get("immutable"));check 返回 ok 假或 code == "noop" 时原样返回 (ok, code, why) 且不改 fm;否则把 dst 写入 fm[STATE_FIELD],并把含 at/from/to/reason/actor 的新条目追加到由 fm.get(HISTORY_FIELD) or [] 复制的列表、截取末 HISTORY_KEEP 条写回 fm[HISTORY_FIELD],返回 (True, code, why)。
231
+ #: 裸 frontmatter 探针的假 node_id(`protect.is_protected` 的 `(cg, node_id)` 形态所需;
232
+ #: 真实节点 id 来自文件名/显式声明,不含 NUL ⇒ 与既有索引键不可能相撞)。
233
+ _FM_PROBE_ID = "\x00fm-probe"
234
+
235
+
236
+ class _FmProbe:
237
+ """裸 frontmatter → `protect.is_protected` 所需的 `(cg, node_id)` 形态(**零规则载体**)。
238
+
239
+ #377(2026-10-14):本模块的降级判据此前只读 `fm["protected"]` / `fm["immutable"]`
240
+ 两位,漏了 `protect.is_protected` 的**层保护**(layer ∈ {self, anchor})与**按分保护**
241
+ ——anchor/self 层节点可被无痕降级。本类**不复制任何判据**——规则单点仍是
242
+ `protect.is_protected`——只把调用方手里已有的 frontmatter 摆成该判据所需的
243
+ 索引快照形态(唯一索引条目=该映射本身)。刻意**不提供** `_maybe_reload_index`
244
+ (`protect._fm` 的探活分支取不到即跳过)且 `get()` 恒返回 None(门控字段回退
245
+ 读文件的分支在此无文件可读、**不抛异常**)⇒ 判定 100% 基于传入映射:
246
+ 零 IO、零副作用(`stamp` 是就地改 fm 的纯函数面)。
247
+ """
248
+
249
+ __slots__ = ("index",)
250
+
251
+ def __init__(self, fm):
252
+ self.index = {"nodes": {_FM_PROBE_ID: fm if isinstance(fm, dict) else {}}}
253
+
254
+ def get(self, node_id=None): # protect._fm 的回退分支:探针无文件可读
255
+ return None
256
+
257
+
258
+ def _is_protected_fm(fm) -> tuple:
259
+ """裸 frontmatter 的「不可遗忘」判定 → `(是否受保护, 原因)`。
260
+
261
+ 判据单点=**`protect.is_protected`**(层保护 self/anchor ∪ 显式 protected 位 ∪
262
+ 按分保护 ≥0.70 且来源缺省/hint);本函数只负责把它喂给判据,不自带任何规则。
263
+ """
264
+ return protect.is_protected_entry(fm) # #431 批:_FmProbe 副本收口到条目口径单点
265
+
266
+
267
+ def stamp(fm: dict, dst: str, reason: str = None, actor: str = None,
268
+ override: bool = False):
269
+ """在给定 frontmatter 上**就地**推进状态(无 IO)→ `(ok, code, why)`。
270
+
271
+ 与 `set_state()` 共用同一裁决点(`check`),供**需与其他字段同批落盘**的收
272
+ 口点使用——`writelimit` 的降权要一次写盘改 tags/importance/状态,`forgetting`
273
+ 的强化同理;否则状态得单独再写一次盘(同一节点两倍 IO)。
274
+ 合法且非幂等时写入 `STATE_FIELD` 并追加 `HISTORY_FIELD`;失败/幂等不动 fm。
275
+ """
276
+ src = state_of(fm)
277
+ # #377(2026-10-14):原判据只读 fm 的**显式两位**(protected / immutable),
278
+ # 漏了 `protect.is_protected` 的**层保护**(layer ∈ {self, anchor})与**按分保护**
279
+ # ——anchor/self 层节点可被无痕降级。改为「显式两位 ∪ is_protected」:
280
+ # **超集**,原判据一字不减(immutable 位照旧、override=True 照旧短路到 check 的
281
+ # override 分支)⇒ 既有判定与 override 通路逐位不变;判据本体仍是 protect 的单点,
282
+ # 不在本模块复制一份。
283
+ prot = bool(fm.get("protected") or fm.get("immutable")) \
284
+ or _is_protected_fm(fm)[0]
285
+ ok, code, why = check(src, dst, protected=prot, override=override)
286
+ if not ok or code == "noop":
287
+ return ok, code, why
288
+ fm[STATE_FIELD] = dst
289
+ hist = list(fm.get(HISTORY_FIELD) or [])
290
+ hist.append({"at": time.time(), "from": src, "to": dst,
291
+ "reason": reason, "actor": actor})
292
+ fm[HISTORY_FIELD] = hist[-HISTORY_KEEP:]
293
+ return True, code, why
294
+
295
+
296
+ # ---------------------------------------------------------------- 索引同步
297
+
298
+ # 生效条件:cg.index 非 dict 时静默 return;index 的 "nodes" 中查不到 node_id 时 return;否则把 fm.get(STATE_FIELD)(缺键即 None)写入该条目,cg._dirty 为 dict 时记入该条目并调用可调用的 cg.flush。
299
+ def _sync_index(cg, node_id, fm) -> None:
300
+ """把 state 同步进索引快照(免读文件可查);无索引实现时静默跳过。
301
+
302
+ 只同步 `state` 一个键:迁移历史已在 frontmatter 与 `_lifecycle.jsonl` 留痕,
303
+ 放进索引会让快照无谓膨胀。
304
+ """
305
+ idx = getattr(cg, "index", None)
306
+ if not isinstance(idx, dict):
307
+ return
308
+ e = (idx.get("nodes") or {}).get(node_id)
309
+ if e is None:
310
+ return
311
+ e[STATE_FIELD] = fm.get(STATE_FIELD)
312
+ dirty = getattr(cg, "_dirty", None)
313
+ if isinstance(dirty, dict):
314
+ dirty[node_id] = e
315
+ flush = getattr(cg, "flush", None)
316
+ if callable(flush):
317
+ flush()
318
+
319
+
320
+ # ---------------------------------------------------------------- 推进 / 回填
321
+
322
+ # 生效条件:cg.get(node_id) 为假值返回 {'ok': False, 'error': 'node_not_found', ...};否则以 state_of(fm) 作 src 调 stamp——stamp 不 ok 返回 ok=False + error=code,code == "noop" 返回 ok=True + changed=False;其余情况(合法且真迁移,即**资格面已过**)先经 autonomy_modes.e_gate() 档位判定(补强批次 v1.2·E 面接线,位置=写盘之前):非 ALLOW(plan 档无计划)即经 forbidden_result() fail-closed 早退(ok=False、error=autonomy_forbidden、零写盘、零审计行),ALLOW(confirm/full)才取 fm[HISTORY_FIELD][-1]["at"] 后写盘、_sync_index 并追加审计 JSONL(append_jsonl 抛异常被吞掉),返回 ok=True + changed=True。
323
+ def set_state(cg, node_id: str, dst: str, reason: str = None,
324
+ actor: str = None, override: bool = False) -> dict:
325
+ """推进一个节点的生命周期状态(**唯一推进入口**)。
326
+
327
+ 非法迁移不走异常而是返回 `{"ok": False, "error": <code>, ...}`(负路由:
328
+ 调用方自行决定降级处理;要硬拒请用 `require_transition`)。幂等迁移返回
329
+ `changed=False` 且不写盘。返回体始终带 `from` / `to` / `code` 便于审计。
330
+
331
+ **档位闸(补强批次 v1.2·E 面接线)**:合法且真迁移(`stamp` 已过=资格面
332
+ 已过)之后、写盘之前,先经 `autonomy_modes.e_gate()`(设计 §三 plan 档
333
+ E「须命中计划步骤」)——plan 档无计划 ⇒ fail-closed 早退(
334
+ `ok=False`/`error="autonomy_forbidden"`/带 hint、零写盘、零审计行);
335
+ confirm/full ⇒ ALLOW、**原链原样**(逐位不变)。非法迁移与 noop 由
336
+ `stamp` 先行裁决、各回各的 code(档位**不参与**资格判定)。
337
+ """
338
+ node = cg.get(node_id)
339
+ if not node:
340
+ return {"ok": False, "error": "node_not_found", "node_id": node_id}
341
+ fm = dict(node.get("frontmatter") or {})
342
+ src = state_of(fm)
343
+ ok, code, why = stamp(fm, dst, reason=reason, actor=actor, override=override)
344
+ base = {"node_id": node_id, "from": src, "to": dst, "code": code}
345
+ if not ok:
346
+ return {**base, "ok": False, "error": code, "reason": why}
347
+ if code == "noop":
348
+ return {**base, "ok": True, "changed": False, "reason": why}
349
+ # 三档自治(补强批次 v1.2·E 面接线,设计 §三 plan 档 E「须命中计划步骤」):
350
+ # 位置=资格面(`stamp` 的合法性/保护裁决)之后、写盘之前——非法迁移与 noop
351
+ # 已在上方各回各的 code,档位不参与资格判定;confirm/full ⇒ ALLOW 原链原样。
352
+ from . import autonomy_modes as _am
353
+ _dec = _am.e_gate()
354
+ if _dec["decision"] != _am.ALLOW:
355
+ out = _am.forbidden_result(_dec, node_id=node_id, changed=False)
356
+ out.update({"from": src, "to": dst, "code": "autonomy_forbidden"})
357
+ return out
358
+ at = fm[HISTORY_FIELD][-1]["at"]
359
+ cg._write_node(node_id, os.path.join(cg.root, node["path"]), fm,
360
+ node.get("content") or "")
361
+ _sync_index(cg, node_id, fm)
362
+ # 退役接线(2026-10-06):状态迁移改变 `is_archived` 读数 ⇒ 依赖该判据的
363
+ # 邻接缓存(`chain.adjacency` 的 skip_archived 过滤)必须**同点作废**——
364
+ # 此前只有本地写路径(add/_stage 尾三连)清缓存,set_state 后旧缓存会让
365
+ # 退役节点继续沿因果链/图面扩散(本批探针实证:归档后 causal_chain 仍含
366
+ # 目标)。懒导入避免模块环;`invalidate_cache` 内部自吞异常,不阻断推进。
367
+ from . import chain as _chain
368
+ _chain.invalidate_cache(cg)
369
+ try:
370
+ # issue #547:`_lifecycle.jsonl` 是审计台账(状态迁移留痕),按 #549 的口径
371
+ # 走 durable=True(原为缺省 + `except: pass`,丢行静默)。
372
+ append_jsonl(os.path.join(cg.root, AUDIT_FILE), {
373
+ "t": at, "action": "set_state", "node_id": node_id,
374
+ "from": src, "to": dst, "reason": reason, "actor": actor,
375
+ "override": bool(override)}, durable=True)
376
+ except Exception: # 审计失败不阻断状态推进
377
+ pass
378
+ return {**base, "ok": True, "changed": True, "reason": why, "at": at}
379
+
380
+
381
+ # 生效条件:nodes 取 (cg.index or {}).get("nodes") or {},遍历中缺 STATE_FIELD 或该值不在 STATES 的 nid 计入 missing(累计数达 limit 即 break,limit <= 0 时立即 break 使 missing 为空),apply 假值只返回 dry_run=True 的盘点结果(**不接档位闸**——零写盘面照旧),apply 为真时先经 autonomy_modes.e_gate() 档位判定(补强批次 v1.2·E 面接线,位置=盘点资格面之后、写盘之前):非 ALLOW(plan 档无计划)即经 forbidden_result() fail-closed 早退(零写盘、backfilled=0),ALLOW(confirm/full)才对每个 missing 中 cg.get 取不到的记入 failed、取到的把 state_of(fm) 显式写回 fm[STATE_FIELD] 并写盘与 _sync_index 后记入 done,返回 dry_run=False 的结果。
382
+ def backfill(cg, apply: bool = False, limit: int = 5000) -> dict:
383
+ """存量回填:把缺 `state` 的节点显式补成 `active`(幂等)。
384
+
385
+ 缺字段本就按 active 解释(`state_of`),故回填**不是让功能工作的前提**,
386
+ 而是把「缺省」变成「显式」——索引/审计里从此可直接读到状态。
387
+ `apply=False`(默认)只盘点。写不动(文件取不回)的节点进 `failed` 如实上报。
388
+
389
+ **档位闸(补强批次 v1.2·E 面接线)**:`apply=True` 的**写盘前**先经
390
+ `autonomy_modes.e_gate()`(设计 §三 plan 档 E「须命中计划步骤」)——plan 档
391
+ 无计划 ⇒ fail-closed 早退(零写盘、`backfilled=0`);confirm/full ⇒ ALLOW、
392
+ 原链原样。`apply=False`(盘点)不接闸。
393
+ """
394
+ nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
395
+ missing = []
396
+ for nid, e in list(nodes.items()):
397
+ if len(missing) >= limit:
398
+ break
399
+ if (e or {}).get(STATE_FIELD) in STATES:
400
+ continue
401
+ missing.append(nid)
402
+ missing.sort()
403
+ if not apply:
404
+ return {"ok": True, "dry_run": True, "scanned": len(nodes),
405
+ "missing": len(missing), "planned": missing[:50]}
406
+ # 三档自治(补强批次 v1.2·E 面接线):E 类动作**写盘前**的档位判定单点
407
+ # (同 `set_state` 口径)——盘点(资格面)已完成、任何盘面写入之前。
408
+ from . import autonomy_modes as _am
409
+ _dec = _am.e_gate()
410
+ if _dec["decision"] != _am.ALLOW:
411
+ return _am.forbidden_result(_dec, dry_run=False, scanned=len(nodes),
412
+ missing=len(missing), backfilled=0)
413
+ done, failed = [], []
414
+ for nid in missing:
415
+ node = cg.get(nid)
416
+ if not node:
417
+ failed.append(nid)
418
+ continue
419
+ fm = dict(node.get("frontmatter") or {})
420
+ fm[STATE_FIELD] = state_of(fm) # 缺省 active → 显式落盘
421
+ cg._write_node(nid, os.path.join(cg.root, node["path"]), fm,
422
+ node.get("content") or "")
423
+ _sync_index(cg, nid, fm)
424
+ done.append(nid)
425
+ return {"ok": True, "dry_run": False, "scanned": len(nodes),
426
+ "missing": len(missing), "backfilled": len(done),
346
427
  "planned": done[:50], "failed": failed[:20]}