@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  531. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  535. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  539. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  543. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  547. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  548. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  549. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  550. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  551. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  552. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  553. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  554. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  559. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  563. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  564. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  565. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  566. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  567. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  568. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  569. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  570. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  571. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  572. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,176 +0,0 @@
1
- # GridWorld 最小闭环规格 v0.1
2
-
3
- > 目的:回应外部评审两轮共识——系统最大缺口是「行动/环境落地」:预测→行动→世界变化→预测误差→模型更新的闭环不存在。缺口矩阵 `docs/theory/理论_机制_代码_实验_缺口矩阵_v0.1.md:51`(#25 三端口架构)已文档声明输出端口,但**专属具身场景测试**仍留白。本文件设计一个最小 Grid World 闭环实验,把「预测→行动→观测→误差→回灌→模型更新」焊成一条可跑通、可度量、可审计的链。
4
- >
5
- > **本文件是规格**:启动实现须使用者批准;本文不改任何代码。
6
- >
7
- > 诚实边界先行:自建玩具环境(确定性/全观测/可枚举/单目标)证据强度受限(GPT 评审已声明)——本实验证明的是**闭环机制存在且收敛**,不是「世界模型能力证明」(§8)。
8
-
9
- ---
10
-
11
- ## 1. 可复用资产清单(调研结论)
12
-
13
- 闭环所需零件仓内**全部已存在**,缺口只在「动作/环境」一段(§6)。逐条核对过的接口:
14
-
15
- | 资产 | 位置 | 签名(核对过) | 闭环角色 |
16
- |---|---|---|---|
17
- | 每动作候选枚举 | `md_cg/predict.py:226` | `branch_candidates(cg, node_id, semantic=True) -> [{node_id, confidence, source, relation_type, condition}]` | **动作选择器**:当前状态节点出边枚举,`condition` 字段承载动作 |
18
- | 多步路线预测 | `md_cg/predict.py:541` | `routes(cg, start_id=None, blindspot_id=None, horizon=3, max_branches=5, sort="composite", limit=0, semantic=True)` | 多步预测面(M3 规划评测);route 含 `path/confidence/uncertainty_bound/score` |
19
- | 预测反馈回灌 | `md_cg/predict.py:678` | `feedback(cg, predicted_node_id, actual_node_id=None, hit=None, note="", actor="predict", sync_self=True, channel=None)` | **模型更新落点**:hit→指向边置信度 +0.05(`_boost_incoming` `:599`);miss→`add_rejected` 负记忆;`sync_self=True` 自动刷自我状态卡 |
20
- | 命中率动态死区 | `md_cg/predict.py:655` | `dynamic_hit_threshold(cg, limit=200)`;常量 `MIN_SAMPLES=50`(`:40`)、`BASE_HIT_RATE=0.40`(`:41`)、`EDGE_BOOST=0.05`(`:43`)、`PRIOR_STRENGTH=20`(`:48`) | 自我校准:样本<50 不触发反思;threshold=max(BASE, mean−2σ) |
21
- | 通道贝叶斯 | `md_cg/predict.py:319` / `:364` | `beta_posterior(hits, prior_k=20, base=0.40)`;`channel_posterior(cg, channel=None, limit=200)` | 可信度后验(置信度≠可信度);`channel="gridworld"` 通道分离 |
22
- | 预测统计 | `md_cg/predict.py:888` | `stats(cg, limit=20)` → `{calls, routes_generated, feedback_samples, hit_rate, beta, dynamic, recent}` | 指标读数口 |
23
- | 盲区五态闭环 | `md_cg/predict.py:790` | `learn_blindspots(cg, blindspot_id=None, limit=8, horizon=3, max_branches=5, apply=False, actor="insight")`;五态 `unknowable/no_anchor/unresolved/carried/resolved`(`:797-801`);`apply=True` 落 `gap_hint`(幂等,`:765`) | 元认知闭环:失败区域→待补线索;`_learn.jsonl` 留痕 |
24
- | 因果可达验证 | `md_cg/predict.py:922` | `causal_path(cg, a_id, b_id, max_depth=5)` | M1 冒烟:验证播种图因果连通性 |
25
- | 探索提案 | `md_cg/autonomy.py:95` | `proposals(cg, window=200, limit=3, enforce_gain=True)`;评分 `=W_D2·Σ\|d2\|+W_BLINDSPOT·BLINDSPOT+W_DEFER·DEFER`(权重 `:34`),score≤0 不提案 | 探索信号源;**只读 `_reflection.jsonl`**(缺口 G4) |
26
- | 探索闭环 | `md_cg/autonomy.py:158` | `explore(cg, apply=False, limit=3, window=200, actor="autonomy", bypass_gain=False)`;P-T-40 四保护(`gain_gate` `:51`) | 元认知面:提案→五态验证→回写;`_explore.jsonl` 留痕 |
27
- | 反思留痕 | `md_cg/mdcg.py:1472` | `MdCG.reflect(query, results, user_feedback=None)` → 记录 `{t, query, d_prev, d_curr, d_delta, d2, states, n_results, feedback}`(`:1487-1497`) | d2/BLINDSPOT 信号产生点,proposals 唯一输入 |
28
- | 检索(带资格态) | `md_cg/mdcg.py:1247` | `MdCG.search(query, layer=None, k=20, context=None, min_results=1, record=True, include_neg=True, judge=True, pools=None, session=None)` | reflect 的 results 来源;`judge=True` 产出 qualification |
29
- | 认知图构造 | `md_cg/mdcg.py:477` | `MdCG(root, autoflush=64)` | 实验用独立临时 root,不碰生产库 |
30
- | 自我状态刷新 | `md_cg/self_state.py:438` | `refresh(cg, subject="self:lingshu", window=20, ..., actor="self_state", force=False, strict=False, session=None)`(幂等 fingerprint `:208`,版本链 `_self_state.jsonl`) | 指标④读数源;`snapshot` `:184` |
31
- | 自我预测面 | `md_cg/self_state.py:235` | `_prediction_face(cg)` → `{hit_rate, beta_mean, beta_ci95, threshold, reflect, ece}` | 自我可靠性指标直读 |
32
- | 元认知观测面 | `md_cg/metacognition.py:123` / `:248` / `:167` | `trace(cg, window=50)`、`blindspots(cg, limit=20, window=200)`、`calibration(cg, max_scan=2000)` | 情绪面/ECE 旁证 |
33
- | mdcos 面板 | `md_cg/mdcos.py:2282` / `:2292` / `:2303` / `:1912-1924` | `predict_routes(...)`、`predict_feedback(predicted_node_id, actual_node_id=None, hit=None, note="", actor="predict", sync_self=True)`、`predict_stats(...)`、`insight(action="explore"/"learn")` | 高层入口;predict_feedback **无 channel 参数**(缺口 G5) |
34
- | 输出端口对照 | `md_cg/sustain.py:230` / `:297` | `mutual_watch(cg, peer, *, restart_cmd=None, d=None, interval, restart_cooldown, fresh_timeout, poll=0.5, spawner=None)` | #25 既有最小具身形态;本实验是其**环境侧**补充,不替换 |
35
-
36
- **账本同构约定**:既有 append-only jsonl——`_prediction.jsonl`(`md_cg/predict.py:62`)、`_learn.jsonl`(`:724`)、`_explore.jsonl`(`md_cg/autonomy.py:36`)、`_reflection.jsonl`(`md_cg/metacognition.py:105`)、`_self_state.jsonl`(`md_cg/self_state.py:74`)。统一形态:`type`/`t`/`actor` 前置字段 + `append_jsonl` 失败不阻塞(如 `md_cg/predict.py:86-90`)。本实验新增 **`_gridworld.jsonl`** 同构留痕(§5)。
37
-
38
- ---
39
-
40
- ## 2. 环境接口(零依赖,纯 python stdlib)
41
-
42
- 对齐零依赖纪律(`md_cg/predict.py:23` 同款声明)。建议形态 `md_cg/gridworld.py`(另案,本文只定接口):
43
-
44
- ```python
45
- class GridWorldEnv:
46
- """最小确定性网格世界:W×H(默认 5×5),单 agent 单目标,静态障碍。"""
47
-
48
- def __init__(self, width=5, height=5, start, goal,
49
- obstacles=frozenset(), seed=None): ...
50
- def reset(self) -> str:
51
- """回起点,episode+1,返回初始 state_id("gw_s_x_y")。"""
52
- def actions(self, state_id) -> tuple:
53
- """合法动作:("up","down","left","right") 剔除出界项。"""
54
- def transition(self, state_id, action) -> str:
55
- """纯函数:确定性转移,可离线全量枚举。"""
56
- def step(self, state_id, action) -> tuple:
57
- """执行 → (next_state_id, reward, done)。"""
58
- ```
59
-
60
- 确定性规则(全部可机器断言,M1 验收项):
61
-
62
- | 规则 | 定义 |
63
- |---|---|
64
- | 确定性转移 | 同一 `(s, a)` 永远映射同一 `s'`(`transition` 纯函数,无随机项) |
65
- | 碰撞 | 目标格是墙(出界)或障碍 → **原地不动**(可学的条件规则,非非法动作) |
66
- | 奖励 | 到达 goal +1,其余 0;无折扣、无中间奖励 |
67
- | 终止 | `done = (next_state_id == goal_id)` |
68
- | 观测 | **全观测**:观测=状态本身,不做部分可观测(诚实边界内,§8) |
69
-
70
- ---
71
-
72
- ## 3. 状态 ↔ 认知图编码
73
-
74
- 世界模型落在认知图的「状态节点 + 动作条件边」,是 `branch_candidates` 的原生数据形态,**零改动**对接:
75
-
76
- | 编码项 | 规格 | 依据 |
77
- |---|---|---|
78
- | 状态节点 id | `gw_s_<x>_<y>` | `_slug` 惯例(`md_cg/self_state.py:95`) |
79
- | 层 | **必须 `knowledge`** | `_SAFE_LAYERS=("knowledge","contextual","structural")`(`md_cg/predict.py:592`)——hit 分支 `_boost_incoming`(`:615`)只改这三层,其他层**静默不改边**,模型更新闭环失效(缺口 G2) |
80
- | 正文 | CCG 五行齐全:`# 功能名:格(x,y)` / `# 生效条件:…` / `# 执行:…` / `# 子功能:…` / `# 不适用条件:…` | `_is_settled`(`md_cg/predict.py:739-757`)判「知识层+五要素」为 resolved——五态闭环才能出 `resolved` 终态 |
81
- | 边 | `edges=[{"target": s_next, "relation_type": "causal", "condition": "动作:上", "confidence": 0.5}]` | `CAUSAL_BRANCH_TYPES=("causal","sequential")`(`:50`);`condition` 经 `chain.edge_condition` 透传进候选(`:239`)——**动作信息沿既有通道流动,无需新字段** |
82
- | 初始置信度 | 0.5(无先验声明;上限 1.0 封顶,`:623`) | 诚实:播种即「未经验证」 |
83
- | 标签 | `tags=["gridworld", "gw_pos:<x>_<y>"]` | 检索/审计隔离面 |
84
- | 频道约定 | `feedback(..., channel="gridworld")` | `channel_posterior` 按面分层(`:364-375`),与既有通道零混淆 |
85
-
86
- ---
87
-
88
- ## 4. 闭环管线(observe→predict→execute→error→feedback→learn)
89
-
90
- | # | 步骤 | 对接(签名见 §1) | 说明 |
91
- |---|---|---|---|
92
- | 1 | observe | `env.reset()` / `env.step()` → `state_id` | 全观测 |
93
- | 2 | 候选动作 | `predict.branch_candidates(cg, state_id, semantic=False)` | **`semantic=False`**:玩具环境边即全集,关闭语义诱导防伪因果门噪声(D-002 门 `:169` 无增益) |
94
- | 3 | 预测 | 首候选=预测终态 `predicted_node_id`;多步面(M3):`predict_routes(start_id=state_id, horizon=3)` | 候选的 `condition` 即动作 |
95
- | 4 | 决策+执行 | 解码 `condition`→`a`;`next_state, reward, done = env.step(state_id, a)` | 无候选(未播种邻域)→ ε-greedy uniform 探索(M2 固定 ε=0.2 占位;与 `gain_gate` 的探索资格协同属 M3 可选) |
96
- | 5 | 误差计算 | `hit = (predicted_node_id == actual_next_node_id)` | **显式传 hit**,不依赖 feedback 内部 `pred==act` 字符串判定(`:693-694`;缺口 G3) |
97
- | 6 | 误差回灌 | `predict.feedback(cg, predicted_node_id, actual_next_node_id, hit=hit, note=f"ep{e}/s{t}", actor="gridworld", channel="gridworld")` | hit→边置信度+0.05(**模型更新**);miss→`add_rejected`(负证据);`sync_self=True` 刷自我卡 |
98
- | 7 | 反思留痕(必选步) | `results, _ = cg.search(状态描述, k=4)`;`cg.reflect(f"gw:ep{e}:{state_id}", results)` | 产 d2/states 信号——proposals 唯一输入(缺口 G4) |
99
- | 8 | 元认知闭环(每 episode 末) | `predict.learn_blindspots(cg, apply=True)`;或 `autonomy.explore(cg, apply=True, limit=3)` | 失败区域→五态终判→`gap_hint`;`_explore.jsonl` outcomes 供下轮 `gain_gate` |
100
- | 9 | 自我面(每 episode 末) | `self_state.refresh(cg, actor="gridworld")` | 幂等(fingerprint 不变跳过);版本链留痕 |
101
- | 10 | 留痕 | `_gridworld.jsonl`(§5) | 实验主账本 |
102
-
103
- 语义对应评审闭环:**observe(1)→predict(2-3)→execute(4)→世界变化→prediction error(5)→feedback(6)→模型更新(边置信度/负记忆)→下轮预测改变**。元认知支线(7-8)与自我支线(9)复用既有链路。
104
-
105
- ---
106
-
107
- ## 5. 审计留痕(`_gridworld.jsonl`)
108
-
109
- ```jsonc
110
- // step(每步一条)
111
- {"type": "step", "t": 0.0, "actor": "gridworld",
112
- "episode": 3, "step": 7, "state": "gw_s_1_2", "action": "up",
113
- "predicted": "gw_s_1_3", "actual": "gw_s_1_3", "hit": true,
114
- "reward": 0, "done": false, "n_candidates": 4, "channel": "gridworld"}
115
- // episode_end(每 episode 一条)
116
- {"type": "episode_end", "t": 0.0, "episode": 3, "steps": 18, "hits": 14,
117
- "reached_goal": true, "hit_rate": 0.7778, "n_rejected_new": 2,
118
- "edge_conf_sum": 41.35, "actor": "gridworld"}
119
- ```
120
-
121
- 同构纪律:`type`/`t`/`actor` 前置(对齐 `_explore.jsonl` 形态 `md_cg/autonomy.py:199-205`);append 失败不阻塞;指标全部可从 `_gridworld.jsonl` + `predict.stats` + `self_state.snapshot` 重算(白箱可审计)。
122
-
123
- ---
124
-
125
- ## 6. 识别出的对接缺口
126
-
127
- 调研发现的真缺口(规格层裁定,均**不改既有代码**):
128
-
129
- | # | 缺口 | 取证 | 规格裁定 |
130
- |---|---|---|---|
131
- | G1 | **动作概念缺位**:predict 全链只认「节点+边」,无动作空间抽象;`routes` 是图内路径生成器不是动作选择器 | `md_cg/predict.py:477-520`(DFS 无动作参数) | 以「边 `condition` 字段承载动作」编码(§3);选择器=branch_candidates 首候选解码。动作沿既有 `condition` 通道流动,零改动 |
132
- | G2 | **层硬约束**:hit 分支 `_boost_incoming` 只改 `_SAFE_LAYERS` 三层,其余层静默不改边 | `md_cg/predict.py:592`、`:615` | 状态节点强制落 `knowledge` 层(§3);M1 冒烟加断言:feedback 后边置信度确有上升 |
133
- | G3 | hit 隐式判定是 `pred==act` 字符串相等 | `md_cg/predict.py:693-694` | 实验显式传 `hit=True/False`,不依赖字符串约定 |
134
- | G4 | **盲区信号依赖 reflect**:`autonomy.proposals` 只读 `_reflection.jsonl`,闭环不调 `reflect()` 则零信号、五态闭环空转(「信号在记录、无人在听」防复发) | `md_cg/autonomy.py:107` | 管线第 7 步为**必选步**(§4),每步 search(record=True, judge=True)+reflect |
135
- | G5 | **mdcos.predict_feedback 不透传 channel**(库层有,封装层无) | `md_cg/mdcos.py:2292-2293` vs `md_cg/predict.py:679` | 驱动器**直调库层** `predict.feedback(..., channel="gridworld")`;既有封装不动(面选择,非缺陷) |
136
- | G6 | `dynamic_hit_threshold` 样本<50 不触发反思(MIN_SAMPLES=50) | `md_cg/predict.py:40`、`:662-665` | 不构成障碍:主判据读 `beta_posterior`(无门槛);反思触发是滞后旁证非主判据 |
137
-
138
- ---
139
-
140
- ## 7. 验证指标与分阶段里程碑
141
-
142
- ### 7.1 验证指标(四类,全部可机器断言)
143
-
144
- | 指标 | 定义 | 读数口 | 判据(M3) |
145
- |---|---|---|---|
146
- | ①预测误差随轮次下降 | 逐步误差=1−hit;episode 级=1−hit_rate;后验均值=β 后验 mean | `_gridworld.jsonl`、`predict.stats()["beta"]["all"]`(`md_cg/predict.py:888-901`) | 后 20% episodes 的后验均值 > 前 20% + 0.2;逐 episode 命中率回归斜率>0(误差单调下降,允许噪声) |
147
- | ②策略稳定性 | 重复同状态同动作率;每 episode 步数(steps-to-goal) | `_gridworld.jsonl` step 聚合 | 确定性环境下最后 3 episodes 同状态动作一致率 ≥0.95;steps-to-goal 后段 < 前段 |
148
- | ③条件模型变化 | 边置信度漂移 Σ\|Δconf\|;rejected 新增数;命中边集合收敛 | cg edges 直读 + `n_rejected_new` | EDGE_BOOST 累积集中在通往 goal 的边上;最后 N episodes rejected 新增=0、无新增命中边(模型停止变化=收敛) |
149
- | ④自我可靠性 | hit_rate / beta_mean / beta_ci95 / reflect(脱离死区)随 episode 演化 | `self_state.snapshot()["prediction"]`(`md_cg/self_state.py:235`) | beta_ci95 收窄;reflect 由 True→False(≥50 样本且过动态阈值);`refresh` 版本链可回放 |
150
-
151
- 对照组(M3 必配):**未学习基线**——同环境同 episode 数,但不跑 feedback(边置信度恒 0.5);两臂 hit rate 必须显著分离,否则①不成立。
152
-
153
- ### 7.2 里程碑(每阶段独立验收)
154
-
155
- | 阶段 | 内容 | 验收判据(可独立断言) |
156
- |---|---|---|
157
- | **M1 环境冒烟** | GridWorldEnv 确定性断言(同一 `(s,a)` 复跑 100 次同 `s'`);9~25 格状态节点+动作条件边播种到临时 root;`branch_candidates` 枚举无异常;`routes()` 返回 `status=ok` 且路径连续;`causal_path(start, goal)` 连通;G2 断言(feedback 后边置信度上升) | 环境与播种层全绿;**不涉及预测质量** |
158
- | **M2 闭环跑通** | ≥10 episodes 端到端无异常;六账本(`_gridworld`/`_prediction`/`_reflection`/`_learn`/`_explore`/`_self_state`)均非空;至少一次到达 goal;`reflect` 留痕含 d2 | 闭环不死、账本可审计、管线第 7 步有产出 |
159
- | **M3 指标显著** | 四类指标判据全过 + 对照组分离 | 数字入实验结论文档,判定「闭环机制验证通过」(非「世界模型能力证明」,§8) |
160
-
161
- ---
162
-
163
- ## 8. 诚实边界
164
-
165
- - **玩具环境证据强度受限**(GPT 评审已声明,本规格如实继承):确定性/全观测/可枚举/单目标——结论只支持「预测→行动→误差→更新→行为改善」的**闭环机制存在且收敛**;不支持「世界模型能力」主张(泛化、部分可观测、非平稳、组合泛化)。对外表述必须用前一句口径。
166
- - **模型更新是确定性账本式更新**:EDGE_BOOST=0.05 线性增量(`md_cg/predict.py:43`),非参数梯度学习;D-006 口径=工程初值非协议承诺。
167
- - **ε-greedy 是占位策略**:M2 固定 ε=0.2;探索的「资格裁决」(σ(Gain) 增益门槛)与本环 ε 的协同只列 M3 可选项,不作为 M2 验收面。
168
- - **单目标奖励无折扣**:不引入 RL 复杂度;本实验不与任何 RL 基线比名次,只做自我前后对照。
169
-
170
- ---
171
-
172
- ## 9. 边界与实现前置
173
-
174
- - 本文件是**规格**;启动实现须使用者批准。实现建议形态:`md_cg/gridworld.py`(env+runner)+ `md_cg/test_gridworld.py`(确定性断言+闭环端到端+指标断言),临时 root(`MdCG(root=<tempdir>)`,`md_cg/mdcg.py:477`),不碰生产库。
175
- - 实现后归档按第 16 条纪律:只记核心修改(内容/原因/位置/验证结论),账本与断言数字入结论。
176
-
@@ -1,124 +0,0 @@
1
- # stg 条件化与结构索引 · 设计 v0.1
2
-
3
- > 立约动因(2026-10-03):issue #52 判定成立并已在在役库复现(`stg.timeline(session=…)` 默认口径
4
- > count=25 且全为 `code_*`,条件命中的 204 条——含 15 条 `mem_*`——被排除在扫描面之外)。
5
- > 使用者当场定性与裁定:「**这又是理论和工程脱节**」「这个节点数限额是我自己提的……当时提的
6
- > 还附带了条件,遇到更多的检索节点,应该要**建立索引**,**明确检索条件**,和**不适用条件**,
7
- > 而**不是扩大节点数**」。
8
- >
9
- > 本稿=该裁定的第 3 层落地设计(第 1、2 层「条件先行 + 截断可观测」另批实施中)。
10
- > 约束继承:`max_scan` 数值不得调大、不得默认全量;「倒排只可作候选内加速」(检索路径契约 §7)
11
- > 同样适用于本稿——stg 索引只做**条件维的收敛**,不替代认知路径。
12
-
13
- ## 一、背景与定性
14
-
15
- **#52 的工程事实**(已实证):`md_cg/stg.py::_scan` 按 `list(index["nodes"].items())[:max_scan]`
16
- 在**条件过滤之前**做 id 字典序切片——限额被实现成「静默砍尾巴」,使用者当年附带的三件事
17
- (建立索引 / 明确检索条件 / 明确不适用条件)**一件未落地**。
18
-
19
- **定性(「理论/工程脱节」的第 n 次现身,同族形态谱)**:
20
-
21
- | # | 理论(已设计) | 工程(实际) | 处置 |
22
- |---|---|---|---|
23
- | 1 | S1–S6 逐级收敛(检索路径契约) | 认知结构入库但检索不调用(审计五偏差) | 已修(门控接线 issue #25 / C-8) |
24
- | 2 | 六要素全要素为检索面服务 | 验证方式/不适用条件两行未进默认检索 | 已修(0.7.0 §5.4) |
25
- | 3 | 限额=「该建索引/细化条件」的压力信号 | 限额=字典序切片(本项 #52) | **本稿 + 第 1、2 层** |
26
-
27
- 共同主线(审计原文):「认知结构被实现成『数据结构』而不是『计算路径』」;本项的变体是
28
- 「**设计约束被实现成实现细节**」——5000 的语义是「超限该收敛」,工程把语义丢了、只剩数字。
29
-
30
- ## 二、第 1、2 层(另批,不属本稿)
31
-
32
- 条件过滤先于截断(「明确检索条件」落到实现)、截断可观测(`truncated` + 提示 + 近期优先兜底)。
33
- 本稿设计以「第 1 层路径(全量快照遍历 + 条件过滤)」为**正确性基线**:索引路径必须与它逐位一致。
34
-
35
- ## 三、第 3 层设计(本稿主体)
36
-
37
- ### 3.1 目标形态
38
-
39
- 契约 §2 在 stg 三接口上的落地:「触碰节点数从 N(全库) 降到 域内 ∩ 条件匹配 ∩ 邻域」——
40
- 查询条件(session / layer / time_window)经**结构化倒排直取子集**,不再逐条遍历快照。
41
-
42
- ### 3.2 索引形态(主案:装载期内存倒排 + 写路径增量维护)
43
-
44
- **主案**:不改任何磁盘格式,索引是**内存派生结构**:
45
-
46
- - **构建**:`MdCG._load_index()` 完成后的首次 stg 访问时,一次 O(N) 快照流生成三张表:
47
- - `by_session: {sid | None: [ids]}`(`None` = 无会话归属,即 `unassigned` 兜底桶);
48
- - `by_layer: {layer: [ids]}`;
49
- - `by_time: [(t, id)]`(有序,`t` 经既有 `trust.epoch_seconds` 归一;无有效时间戳的进 `_untimed`)。
50
- - **维护**:与既有桶计数**同一写钩**(`_set_index_entry` / `_remove_index_entry` 处增量增删)。
51
- - **不变量**:三张表恒为快照 keys 的划分(同源维护);任一表缺失/代际不符 ⇒ **回退第 1 层全量遍历**
52
- (安全降级且**可观测**,与 postings「宁可慢,不可丢召回」同纪律)。
53
- - **跨进程**:各进程装载时自建,无共享过期问题;多实例内存各持一份(1.7 万节点 ≈ 三张小表,可接受)。
54
-
55
- **备选(记录不采纳理由)**:
56
- - *快照内倒排*(`_index.json` 加段):改最核心文件的 schema,装载/校验/compact/rebuild 全链兼容负担大;
57
- - *独立文件*(走 postings 的指纹+重建模式):引入跨进程过期面与重建时机问题,而本索引的源数据
58
- (快照字段)本就在内存——独立文件无增益。
59
-
60
- ### 3.3 读侧直取
61
-
62
- - `timeline(session=X)`:`by_session[X]`(+ 既有的「x 会话不匹配」过滤语义逐位不变)→ 子集走既有排序链;
63
- - `anchors(time_window)`:`by_time` 区间截取(二分)→ 子集;
64
- - `consistency(layer)`:`by_layer[l]`;
65
- - 截断语义与第 1、2 层完全一致(`truncated` / 近期优先)——索引只改「取数面」,不改「语义面」。
66
-
67
- ### 3.4 条件资格进 stg(「明确不适用条件」)
68
-
69
- - 复用 read 面唯一单点 `judge_qualification`:对 stg 返回条目做资格判定(生效条件命中 /
70
- 不适用条件拒绝 / 无从判定),结果随返回体带出(`qualification` 字段,语义与 read 面同口径)。
71
- - **首验形态:只上报不过滤**(行为零变化,`MDCG_STG_QUALIFY=1` 显式开);
72
- **次验形态(硬过滤,与 read 面同权)另立裁定**——因为 stg 的语义是「遍历视图」而非「召回 top-k」,
73
- 过滤改变视图完整性,需设计者拍板。
74
-
75
- ### 3.5 flag 与回退(契约 §4 纪律)
76
-
77
- - `MDCG_STG_INDEX=1` 显式开;默认关时=第 1 层路径。
78
- - **两条路径结果逐位一致**为等价性准入判据(同 postings 的「候选内加速、召回与全表一致」先例)。
79
- - 收敛读数(`meta` 分阶段计数:子集大小 vs 全量 N)供编外复核逐项核对。
80
-
81
- ### 3.6 与既有机制的关系
82
-
83
- - **postings(词法 bigram)**:正交可叠加——词法先收词、stg 索引收条件维;
84
- - **桶(routing.bucket_dir,域级)**:正交;`route_key` 的 `observation_position` 一档与 layer/session 不同维;
85
- - **refindex(`_refindex.json`)**:形态参考,非复用对象。
86
-
87
- ## 四、验收判据
88
-
89
- 1. **等价性**:flag 开/关,三接口返回体(除 `meta` 计数)逐位一致(快照对比);
90
- 2. **收敛性**:`meta` 读数显示「实际遍历/触碰」从 N 降到子集(目标 ≤ 条件命中量级);
91
- 3. **不劣化**:既有 stg 套件 + 第 1、2 层新守卫全绿;在役对照(timeline(session) 的 count 与条目集)不改;
92
- 4. **可观测**:索引命中/回退(表缺失/代际不符)均有 `meta` 计数与 reason;
93
- 5. **守卫与定点变异**:索引增删钩、回退路径、等价性各有断言与变异自证。
94
-
95
- ## 五、边界(不做的事)
96
-
97
- - 不改默认启用(先 flag,逐项验证,再讨论默认开启);不改 `max_scan` 数值与第 1、2 层语义;
98
- - 不做 FTS 替代、不引入第二套时间/条件解析(复用 `trust.epoch_seconds` / `_view_session` / `judge_qualification` 单点);
99
- - 不动写入侧磁盘语义(索引是内存派生 + 同钩维护)。
100
-
101
- ## 六、待签收点(请逐条裁决)
102
-
103
- 1. **索引形态主案**=装载期内存倒排 + 写路径增量(备选两案的驳回理由见 §3.2)——可否?
104
- 2. **路径等价为唯一准入**:flag 开/关逐位一致才准入——可否?
105
- 3. **资格判定首验只上报不过滤**(`MDCG_STG_QUALIFY`),硬过滤另立裁定——可否?
106
- 4. **`unassigned` 语义**:无会话节点在会话视图下**保持现状**(仅在 `session="*"` 等视图可见),索引化不得改变——确认?
107
- 5. **同族归属**:`consistency.check` 的 `MAX_SCAN=200` 选面(字典序前 200 → 应改相关性/条件预筛)是否纳入本线第二实现批?
108
-
109
- ## 七、排期
110
-
111
- 设计稿签收 → 实施批(工作流:探针 → 实现 + 守卫 → 独立复核 → 容器双栈)→ 默认开关讨论 →
112
- 随下次发版披露(若有默认面变化)。
113
-
114
- ## 八、签收记录
115
-
116
- **2026-10-03 使用者签收**(原话:「同意此次设计。我们开始实施,来进行实测」):
117
-
118
- - 待签收点 1(索引形态主案=装载期内存倒排 + 写路径增量维护):**同意**;
119
- - 待签收点 2(flag 开/关路径逐位等价为唯一准入):**同意**;
120
- - 待签收点 3(资格判定首验只上报不过滤,`MDCG_STG_QUALIFY`;硬过滤另立裁定):**同意**;
121
- - 待签收点 4(`unassigned` 语义保持现状,索引化不得改变):**确认**;
122
- - 待签收点 5(同族 `consistency.check` 的 `MAX_SCAN=200` 选面):**纳入本线第二实现批**(主体批不含;批间独立复核)。
123
- - **附加要求:实施后须实测**——在役库上的路径等价读数与遍历面收敛读数(本批报告中的「实测」节)。
124
-
@@ -1,220 +0,0 @@
1
- # 全中文编码与蜂巢任务标识契约 v2
2
-
3
- > 日期:2026-09-29 | 对象:`<仓根>`
4
- > 状态:**四项已全部裁决(2026-09-29)**;**已动码(2026-09-30,见 §五.1)**
5
- > 已签收:①编号 4 位、溢出**显式报错** ②身份/任务/单元**必填**,且单元槽取**蜂巢五单元**闭集 ③编号分配**由 Rust 侧实现**(判据单点)④**不做控制台兼容**——取用通道走 python,README 明写全 UTF-8
6
- > 上位裁定:使用者 2026-09-29「中文入路径;我们代码所有路径都要是 utf-8 兼容中文字符;我们以后是全中文编码」。
7
- > 本稿同时承接优化清单 **H-1**(MCP 面绕过去重 + `new_job_id` 同毫秒碰撞)的 id 形态裁决——使用者的四槽式设计(目录/任务/编号/身份)取代「时间戳 + pid」。
8
-
9
- ---
10
-
11
- ## 一 决定与它的真实作用面
12
-
13
- 使用者裁定两件事:**①路径全面 UTF-8 兼容中文**;**②蜂巢任务标识改用语义四槽组合,不再用毫秒+pid**。
14
-
15
- 关键判断(本文档的立论):**这两件事的性质完全不同**。
16
-
17
- - ① 不是"新建能力",而是"把已有能力钉成不依赖环境变量的硬约束"——三个面的编码层**已经**是 UTF-8 端到端(§二 实测),但撑住它的是**环境变量 + 每个入口自己记得设**,而仓里有 224 处裸 `open()`(§三)。
18
- - ② 不是"编码问题",而是**一道故意的安全闸**在挡路——`valid_job_id` 只收 ASCII,放宽它是全案唯一的**安全面**改动(§四.4)。
19
-
20
- ---
21
-
22
- ## 二 现状实测(2026-09-29,四条,全部实跑)
23
-
24
- | 面 | 观测 | 判定 |
25
- |:--|:--|:--|
26
- | Windows Python | `sys.getfilesystemencoding()='utf-8'`;中文目录 `zcode端_灵枢迭代_反思单元_0001` 与中文文件名的建/写/读/列全部正确 | 通 |
27
- | 容器 `rust:bookworm`(门禁栈一同镜像) | `LANG`/`LC_ALL` **全空**(C locale)下 `fsenc='utf-8'`、`stdout='utf-8'`;中文目录与 `优化报告_灵枢迭代_v1.0.md` 全部正常 | 通 |
28
- | Windows Rust(真 `hive.exe`,release 二进制) | 以中文池 `…/zcode端_灵枢迭代` 与中文 spec 路径 `任务_反思单元_1号.json` 提交:exit 0,`jobs_dir` 回读中文**逐字完好**,`spec.json` 以 UTF-8 原样落盘并回读正确 | 通 |
29
- | 仓内既有事实 | `docs/` 已全为中文文件名(本批报告 `优化第二批_依赖透传与对拍口径与负缓存_v1.0.md`),python 全量与容器双栈门禁一路绿 | 通 |
30
-
31
- 结论:**编码层不需要重做**。容器那一条尤其重要——`rust:bookworm` 里 locale 是 C,本该退化成 ASCII,实测仍是 utf-8,是 PEP 538/540 的 C locale 强制转换在起作用;这条链路不能默认它永远生效(见 §四.2)。
32
-
33
- ---
34
-
35
- ## 三 脆弱点(必须钉住的东西)
36
-
37
- 1. **系统 locale 是 GBK。** 本机 `locale.getlocale()` = `('Chinese (Simplified)_China', '936')`,而 Python 裸 `open()` 的缺省编码取 `locale.getpreferredencoding(False)` ⇒ **不设 UTF-8 模式时,裸 `open()` 在本机走 cp936**。
38
- 2. **今天没炸,靠的是环境变量。** 本机环境里设了 `PYTHONUTF8=1` 与 `PYTHONIOENCODING=utf-8`。入口也已显式钉:`scripts/run_tests.py:88`(给子进程覆盖)、`scripts/linux_verify.sh:9`(export)、TS 桥层 `src/lib/mdcg_client.ts`(同名注释见 `hive/hive_mcp/mcp_server.py:852`)。
39
- 3. **裸 `open()` 224 处**(`md_cg/` `hive/` `scripts/`,未传 `encoding=`)。ASCII 数据无碍,一旦内容或路径含中文,就看第 1 条的脸色。
40
- 4. **已有乱码实证**:本会话中 mdcg 的 stderr 打出过 `[mdcg-mcp] 鈿� 瀵嗙骇閰嶇疆…`——这一类通道未对齐编码的现成样本。
41
- 5. **零处归一化**:全仓无 NFC/NFD 归一化。中文受的影响小,但混排拉丁带音调与 CJK 兼容表意文字(U+FA10 等**确实**会 NFD 分解)会咬人;macOS 按 NFD 存储名字,而 `depends_on` 判据是**字符串相等** ⇒ 不归一化即静默失配。
42
-
43
- ---
44
-
45
- ## 四 硬约束(要落成什么)
46
-
47
- ### 四.1 路径与文件名一律 UTF-8 + NFC
48
-
49
- - 一切落盘的可读文本固定 UTF-8;一切用户可见的路径/文件名/id 固定 **NFC**。
50
- - 归一化在**写入边界**执行一次(提交面/落盘点),比较前亦归一化;判据单点,不得各处自持。
51
-
52
- ### 四.2 进程自保证 UTF-8(不依赖使用者 profile)
53
-
54
- - 每个入口(`hive/hive_mcp/mcp_server.py`、`hive/orch.py`、`hive/exec.py`、`scripts/*`、TS 桥)在最早处检查 `sys.flags.utf8_mode`;未开则设置 `PYTHONUTF8=1`/`PYTHONIOENCODING=utf-8` 并**重启自身**,不可重启时 **fail-fast 报错**(同 N200「无模型密钥启动前置报错」的形状:不静默降级)。
55
- - 这一条落地后,§三.3 那 224 处的**大部分风险直接消失**(UTF-8 模式下裸 `open()` 即 UTF-8),比自己逐个补 `encoding=` 便宜一个数量级。
56
-
57
- ### 四.3 机械守卫:裸 `open()` 不许新增
58
-
59
- - AST 扫描生产模块(`md_cg/` `hive/` `scripts/`,排除 bench)里未传 `encoding=` 的 `open()` 与无 `encoding=` 的 `Path.read_text/write_text`,白名单化存量,**新增即红**。
60
- - 与 §四.2 互为兜底:自保证是运行期防线,守卫是提交期防线。守卫须自带定点变异自证(本仓惯例)。
61
-
62
- ### 四.4 id 契约 v2(安全面改动,最需谨慎的一节)
63
-
64
- **形态**:`h_<身份>_<任务>_<单元>_<编号>`,例 `h_zcode端_灵枢迭代_反思单元_0001`。
65
-
66
- | 槽 | 例 | 必填 | 来源 | 说明 |
67
- |:--|:--|:--|:--|:--|
68
- | 身份 | `zcode端` | **是** | 提交面显式声明(env/入参) | 提交者/端别;**不允许静默推导**(猜错且静默正是 H-1 那半边缺陷的形状) |
69
- | 任务 | `灵枢迭代` | **是** | 显式声明 | 工作流或迭代名;目录可作它的父段(成 5 段) |
70
- | 单元 | `反思单元` | **是** | 显式声明,**闭集** | 见下「五单元闭集」 |
71
- | 编号 | `0001` | 分配得出 | Rust 侧分配器 | 该 (身份,任务,单元) 前缀下的序号,**定宽 4 位**,溢出 **显式报错**(不加宽——加宽会破坏定宽前提) |
72
-
73
- **五单元闭集(本契约的关键收窄,使用者 2026-09-29 裁定)**:单元槽**不是自由文本**,取值限定为**蜂巢五单元**,真源是 `md_cg/identity.py:55-67` 的 `POSITIONS`:
74
-
75
- | pos | 单元 | effect | duty |
76
- |:--|:--|:--|:--|
77
- | `record` | 记录单元 | 全 | 保存观测、过程、结果和误差 |
78
- | `reflect` | 反思单元 | 新 | 发现差异、遗漏条件和新的路径 |
79
- | `verify` | 验证单元 | 稳 | 判断规则、执行结果和结构是否有效 |
80
- | `output` | 输出单元 | 通 | 与外部系统协作并表达边界 |
81
- | `sustain` | 维生系统 | 存 | 维护存在、预算、回滚和整体结构 |
82
-
83
- - 好处:任务的身份里直接带**它归哪个职能单元**,而词表有既有真源、不会漂移;提交面校验即 `∈ POSITION_ORDER`。
84
- - 守卫:**沿用仓内既有的同源断言形态**(`md_cg/test_p21_tokens.py:218`「与 `identity.POSITIONS` 同源校验」)——id 词表与 `POSITIONS` 必须逐项一致,任一侧增删即红。
85
- - `POSITION_ORDER`(`identity.py:67`)同时给出**规范顺序**,可用于校验与排序,不必在 id 契约里另立一份。
86
- - 注意:**副代理不是第六个单元**(`docs/hive/子代理配置标准_v0.5.md:151`:副代理是融合位 𝓕 本身,五单元是 𝓕 的功能分解)⇒ 词表恰为 5,不得为副代理增设槽值。
87
-
88
- **编号分配算法=独占创建即分配**:对目标名执行 `fs::create_dir`(Rust)/`os.mkdir`(Python)——目标已存在时**必然失败**,失败即编号加一重试(有界重试,超限显式报错)。性质:
89
- - 碰撞**结构上不可能**,不再依赖「毫秒恰好不同 ∧ pid 恰好不同」;
90
- - **H-1 的碰撞那半因此被消解而非被修补**——不需要进程内计数器、不需要提高熵;
91
- - 复用的是仓内既有原语同款(`claimed.lock` 的 `create_new` 独占)。
92
- - `now_ms()` 保留为 `status.created_ts` 的时钟源,**退出 id**。
93
-
94
- **字符集闸(`job.rs` 与 `mcp_server.py` 这对双胞胎须同改)**:由「ASCII 字母数字 + `_`」放宽为「**区块白名单内的字母/数字** + `_`」,**同时保留并新增拒收项**。
95
-
96
- > **判据换面(2026-09-30 使用者裁定 ①-(c);本节按换面后的口径写)**:判据 = **一份编译期嵌入的区块表** `hive/id_charset_blocks.txt` 的**区间并集**,**不查任何 Unicode 属性库**——三处读者(Rust `job.rs` 的 `include_str!` + 首次使用惰性解析;`mcp_server.py` 导入时读一次;`md_cg/units.py` 同样读这份文件)**共读同一份数据**,故两侧属性表版本差**结构性不可能**(旧机制下「全码点同判」不成立)。表由 `scripts/gen_id_charset_blocks.py` **生成、可重跑、带陈化守卫**(`--check`:重算 ≠ 盘上即退出 1):在候选区块(ASCII / 拉丁 / 希腊 / 西里尔 / 假名 / 谚文音节 / CJK 与扩展 / 注音)内逐码点取「类目 ∈ {Lu,Ll,Lt,Lm,Lo,Nd} ∧ **单字符 NFC 稳定**」的交集后**归并成最小区间**——即**区块选择**决定表达面,**类目 + 稳定性**过滤掉区块内的标点/符号/会改写的形态;`_`(U+005F) 与 `.`(U+002E) 不在表内,由结构分支处理。三处读者一律 **fail-closed**(表缺失/解析出空区间集 ⇒ 判据返回 false,绝不放行)。**有意不收**(契约条款,不是遗漏):谚文 Jamo(1100-11FF)与兼容 Jamo(3130-318F)、CJK 兼容表意(F900-FAFF)与兼容表意补充(2F800-2FA1F)、其余兼容/带圈/上下标/数学字母数字/全角半角区块。
97
-
98
- 拒收项(**逐条显式断言**,不靠「白名单外所以默认被拒」):
99
-
100
- | 拒收 | 理由 |
101
- |:--|:--|
102
- | `/`、`\` | 路径分隔(原始缺陷载体:`kill ..` 池外写、`poll ../victim` 池外读) |
103
- | 单独的 `.` 与 `..`(**整串**等于),以及**按 `_` 分段的任一段**等于 `.`/`..`(**段级**,2026-09-30 加固) | 相对路径。段级读法见下方说明 |
104
- | `:` | Windows 盘符 |
105
- | 控制字符、零宽字符、双向控制字符 | 同形异义与不可见注入 |
106
- | 首尾空白、尾点 | Windows 会静默剥掉 ⇒ 两个不同 id 落到同一目录 |
107
- | Windows 保留设备名(`CON`/`NUL`/`AUX`/`PRN`/`COM1`…) | 本仓 v0.5.1 刚修过这一类(issue #39),勿回退 |
108
-
109
- **这是全案唯一的攻击面改动**:必须有守卫(合法/非法两侧用例 + 跨语言对照,沿用 H-6 的 18-id 对照形态),必须做定点变异,且守卫要覆盖 `kill`/`poll`/`depends_on` 三条拼路径入口。
110
-
111
- > **`.`/`..` 的读法是「段级」(2026-09-30 明确,原表「单独的 `.` 与 `..`」一句有歧义)**:判据 = 按 `_` 分段后,**任一段**等于 `.` 或 `..` 即拒;**整串**等于 `.`/`..` 与**尾点**两条判据一并保留。三处闸**同判**:`hive/src/job.rs::valid_job_id`、`hive/hive_mcp/mcp_server.py::_job_id_reject_reason`、`md_cg/units.py::_valid_job_id`。**范围只加这一条**——不拒空段(`h__x`)、不拒 `...` 段(段是 `...` 而非 `.`/`..`)、不动非尾点 `.` 的既有 accept 契约。**为什么是段级**:id 的每一段都可能被宿主当作目录名或**父目录段**用(本节上表「任务」槽「目录可作它的父段」⇒ 5 段形态),段级 `..` 因此是真实载体;**现状定性如实**:段级口径下被拒的 `h_.._x` / `h_a_.._b` 在旧整串口径下曾被收,其拼出的路径**停在池内、不构成穿越** ⇒ 本项是**面向重构的纵深加固**,不是现实缺陷的修补。守卫 = `hive/test_job_id_segment_dot.py`(A–D 组 49 条断言:段级拒 + 范围边界三例仍收 + 存量零迁移逐个列出 + 语料两例在位且全语料三方复算逐例一致;`--branch-baseline` 三处定点变异 + 三处假阳性对照);语料 = `hive/id_contract_corpus_v2.txt` 第 103–104 行(`h_.._x` / `h_a_.._b`,hex 编码);存量实测:在役 `hive/jobs` 15 个目录被三处闸判非法者 **0**。
112
-
113
- ### 四.5 排序口径:把代理换成真值
114
-
115
- id 不再含时间后,「字典序 = 提交时序」这条**代理**失效,四个消费者须改为**直接按 `status.created_ts` 排序**(每个 status 都已有该字段):
116
-
117
- | 站点 | 现语义 | 改后 |
118
- |:--|:--|:--|
119
- | `hive/src/main.rs:223` `find_active_by_hash` | 名升序取首个 = 最老活跃同哈希 | 活跃同哈希中 `created_ts` 最小者 |
120
- | `hive/src/main.rs:473` poll 列表 | 名升序 | `created_ts` 升序 |
121
- | `hive/src/main.rs:696` doctor | 名升序 | `created_ts` 升序 |
122
- | `hive/src/scheduler.rs:213`/`:300` 领取顺序 | 名升序 = FIFO | `created_ts` 升序 = FIFO(**语义保持**) |
123
-
124
- ### 四.6 控制台:**明确不做兼容**(使用者 2026-09-29 裁决)
125
-
126
- 先摆事实(实测,真 `hive.exe` + 中文池路径):CLI 写出的字节是**裸 UTF-8**。同一串字节两种读法——
127
-
128
- | 读法 | 结果 |
129
- |:--|:--|
130
- | 按 UTF-8 解码(管道 / 文件场景的正确读法) | `…\Temp\控制台试验_hucyqfhm` |
131
- | 按 cp936 解码(= 代码页 936 的窗口所见) | `…\Temp\鎺у埗鍙拌瘯楠_hucyqfh` |
132
-
133
- 机制:输出到管道或文件时没有"代码页"这一层,写读双方约定 UTF-8 即可;问题只出在**目标是 Windows 控制台**时——控制台按**自身代码页**解释收到的字节。Python 不出这个问题是因为 PEP 528 让它对控制台改走宽字符 API `WriteConsoleW`(绕过代码页);Rust 的 `println!` 走 `WriteFile` 直写字节,没有这层翻译。
134
-
135
- **裁决:不做控制台兼容。** 不实现 Rust 侧的 `WriteConsoleW` 分支,也不要求使用者 `chcp 65001`;把正确性收进**约定**而不是**显示层**:
136
-
137
- 1. **取用通道固定为 Python**:本仓一切读写与判定走 `python -X utf8 …`(沿既有工程纪律第 15 条「命令统一走 python + 显式 UTF-8」)。Python 对控制台本就正确,走它即绕开问题。
138
- 2. **README 明写约束**:全仓文本与路径一律 UTF-8(无 BOM),并显式向 AI / 接入方声明「这里是 UTF-8、请走 python、别拿控制台当取用通道」(已落 `README.md` 的「编码约定」节)。
139
- 3. **Rust CLI 的控制台渲染不在承诺面**:CLI 输出为裸 UTF-8 字节;管道/文件读法即正确。控制台里看到什么,属显示层,不承诺。
140
-
141
- **代价与残余**:若有人偏要在代码页 936 的窗口里直接读 CLI 输出,会看到乱码——这是**已知且接受**的边界;文档已写明规避方式(走 python、或把输出重定向到文件后按 UTF-8 读)。### 四.7 明确不改的面
142
-
143
- - **`h` 前缀保留**:`valid_job_id` 的 `starts_with('h')`、`list_jobs` 的 `h` 前缀过滤、以及全部依赖它的守卫不动。去掉它要牵动一大片,收益为零。
144
- - **存量零迁移**:旧 `h<13位毫秒>_<4hex>` 与新形态**同时满足**放宽后的闸、都以 `h` 开头被 `list_jobs` 收;§四.5 改按 `created_ts` 排序后两种形态共存无碍。
145
- - **依赖无环性依据不动**:`scheduler.rs:1017-1019` 的注释(**勘误**:本稿早期写作 690-697,那是 `retry_spawn` 的重试循环,非本论点所在;同论点另在 `spec.rs:49-50`、`job.rs:54-55`、`main.rs:285-286`、`mcp_server.py:187-188`、`hive/README.md:281` 共五处)写明依据是「**无法引用提交时尚不存在的任务**」即**存在性闸**(`main.rs:282-298` + H-6 新增的 MCP 侧 `_dep_gate`),**不是** id 的时间序。语义 id 不危及 I-1。(该注释原「由 job_id 时间序结构性保证」的措辞与本表述的出入**已按本批 C 项订正**:逐处清单与落点见 §五.1「C 论证订正」行。)
146
- - **MCP/编排面共用一处生成器**:现状是 `mcp_server.py:339` 自造 `h{ms}_{uuid4[:6]}`,本契约要求两侧共用同一分配语义;「谁持唯一实现」是 §五 待裁项。
147
- ### 四.8 已落 vs 未落(收口时如实登记)
148
-
149
- - **已落**:§四.4(四槽标识、五单元闭集、独占创建即分配、4 位溢出显式报错、字符集闸双胞胎同改 + 新增拒收、`hive alloc-id` 子命令、`_submit` 自造 id 退场)、§四.5(六处消费者 + MCP 两处改按 `created_ts`,含保序证明与「按真值」反证)、§四.7 的论证订正(五处)。
150
- - **实现级收窄(须知情)**:§四.1 的「归一化在写入边界执行一次」在 id 面上收窄为「**必须已是 NFC,否则拒收**」——理由:`hive/Cargo.toml` 的 `[dependencies]` 是空段(零依赖),手写完整 NFC 不可行;拒收比静默归一化更严、两侧判据可证同判。Python 侧禁止用 `unicodedata.normalize` 悄悄放行。
151
- - **残点①(两侧同判只在语料上成立)→ 本批收口(2026-09-30 裁定 ①-(c))**:判据换成**纯区块区间成员判定**——唯一真源 `hive/id_charset_blocks.txt`(Rust `include_str!` 编译期嵌入 + 惰性解析;`mcp_server.py`、`md_cg/units.py` 读同一份文件),**不查任何 Unicode 属性库** ⇒ 两侧接受集由**同一份数据**决定,版本差**结构性不可能**。守卫随之从「方向安全」升到「**零分歧**」:两侧各自的「**判据 ≡ 表**」全码点遍历(限测试内,不进生产热路径)合起来即两侧零分歧,不再需要喂真 `hive.exe` 逐码点的 44 分钟路径。旧实测的 9713 个 Cn 残余随旧的 `is_alphanumeric` 口径一并退场。
152
- - **残点②(第三份闸未同步)→ 本批收口(2026-09-30 裁定 ②-(a):同口径)**:`md_cg/units.py::_valid_job_id`(N178,`复制契约不 import` 的家法)的 ASCII 白名单换成**读同一份区块表**(**读数据不是 import**,不破零依赖家法),**保留**其本地既有放宽——**不要求 `h` 前缀**(poll 面向任意宿主派发器写出的 job 目录)、允许 `.` 与 `-`(既有对外契约,不为「同口径」收紧)——连同长度上限 128、首尾无空白、首尾非点等既有结构判据。放宽带来的静默风险**显式挡住**:零宽/双向控制/控制字符逐条显式拒(判据下 `Cf`/`Cc` 天然不入,但不靠这个)。新增守卫:md_cg 侧对 `hive/id_contract_corpus_v2.txt` **逐例对照**,与 `job.rs` **每一例同判**(语料里带 `h` 前缀的样例才适用于 md_cg 面的前缀差异,其余按「md_cg 不要求前缀」的有意差异处理并写进断言注释,**不改语料**)。三处调用点(submit 落点前 / poll / wait fail-fast)语义不变。
153
- - ~~残点③(编号用尽文案)~~ **已收口(2026-09-30)**:分配器不再把「起点越界」当用尽——搜索序改为**在号位间回绕**(先 `hint..=MAX_UNIT_SEQ`、再 `1..hint`;两区间不重叠、并集恰为 `1..=9999`、每号位至多试一次),池内只存 `…_9999` 时仍能分到空闲的 `…_0001`(不再白扔 9998 个号位);**编号值不回绕**(恒 4 位定宽、用尽显式报错、不溢出成 `0001` 复用已发布 id)。文案如实:`编号用尽: 前缀 {prefix} 的 9999 个号位已全部被占用(4 位定宽、不自动加宽)——请换任务槽或另起单元`(保留「末次碰撞 …」,去掉会被读成「前面也满了」的「已无可用编号」);用尽与否是**可证事实**(循环跑完 = 全部 9999 个号位的 `create_dir` 都返回 `AlreadyExists`)。**落点**:`hive/src/job.rs::seq_candidates` + `alloc_job_id` 的循环与文案 + `next_seq_hint` 的「起点越界 ≠ 用尽」语义;守卫 `hive/test_id_contract_v2.py` B 组(含**真构造 9999 个号位**的「真用尽」例)+ `--branch-baseline` 的三处 rust 定点变异(回绕退场 / 静默加宽 / 文案回退)。
154
- - ~~残点④(既有编码守卫的成功路径覆盖)~~ **已收口(2026-09-30)**:两条守卫各**补一趟成功路径**,原失败趟**保留**(两趟并存)。成功趟把 `HIVE_EXE` 指向真实 release 二进制、`HIVE_JOBS_DIR` 指向守卫**自建临时池**,断言 `ok=true` + `job_id` 为四槽中文形态 `h_…_…_…_NNNN` + 任务目录落临时池内 + 未拉起 serve(`alloc-id` 是纯分配通道,不启动 serve);二进制缺失(未构建的新检出)**显式 SKIP 并打印期望路径**,计入 SKIP 计数、**不计入通过数**、汇总另打 ⚠ 行(不静默判绿)。**落点**:`scripts/test_utf8_boot_guard.py` 的 `E2E-HIVE-OK`(`check_e2e_hive_ok` + `Skipped` 三态 + 自我锚)与 `md_cg/test_issue39_utf8_stdio.py` 的成功趟(2e–2k + `skip()` 三态 + `_hive_bin` 两级查找)。该路径另由 `hive/test_orch.py`(真实 `_hm._submit`)与 `hive/hive_mcp/smoke_test.py` 覆盖。
155
- - ~~残点⑤(B4 措辞歧义)~~ **已收口(2026-09-30)**:「单独的 `.` 与 `..`」明确为**段级**读法——按 `_` 分段,**任一段**等于 `.` 或 `..` 即拒(整串与尾点判据一并保留),三处闸**同判**(`job.rs::valid_job_id` / `mcp_server._job_id_reject_reason` / `md_cg/units.py::_valid_job_id`);范围**只加这一条**(不拒空段 `h__x` 与 `...` 段等未被裁定的形态)。**落点**:三处闸 + 守卫 `hive/test_job_id_segment_dot.py`(A–D 组 49 条断言 + `--branch-baseline` 三处定点变异 + 三处假阳性对照)+ 语料 `hive/id_contract_corpus_v2.txt` 第 103–104 行两条 reject 例(`h_.._x` / `h_a_.._b`,hex 编码)。存量零迁移实测:在役 `hive/jobs` 15 个目录被三处闸判非法者 **0**。
156
-
157
-
158
- ---
159
-
160
- ### 四.9 使用者裁定(2026-09-30:追认一项、否决一项)
161
-
162
- - **md_cg 派发面的 Windows 保留设备名拒收 → 追认保留**。本批换面时因「语料逐例同判(c10)」被迫在 `md_cg/units.py::_valid_job_id` 补入设备名拒收(整 id 首个 `.` 之前部分,以及按 `_` 分段的任一段,ASCII 大小写不敏感;语料第 87–91 行五例为触发器)。旧 ASCII 白名单下 `CON`/`con`/`COM1`/`LPT9`/`CON.txt` 是**放行**的,故这是对该面**对外契约的收紧**——使用者裁定保留(与 hive 两侧同集同判正是 ②-(a) 的目的)。实测存量无损伤(在役 `hive/jobs` 15 个目录被该闸拒者 0)。**已知边界**:非 Windows 宿主上该判据纯属多余的严;段级判据严于 Win32 实际语义(设备名解析按整条路径分量做,`X_CON_Y` 作单个目录名不会命中)。**若日后回退,须同时把语料第 87–91 行改标为「md_cg 面有意差异」**。
163
- - **R4「非追踪件面」瞬时红 → 不立项查证**(使用者裁定)。判据:发布面(`package.json` 的 `files` = `lib, src, md_cg, data/policy.json, skills, README.md, dsh, codebuddy, zcode, docs`)内出现未被 git 追踪的文件即红(`scripts/check_publish_artifact.py:46` `ALLOW_NONTRACKED=("lib/",)`;明细行的「允许」是**落在 `lib/` 的件数、不是上限**)。当前读数 `非追踪=28,允许=28`,28 件全为 `lib/` 构建产物。执行者曾两次记录瞬时红(清单 1444、命中 `docs/plans/蜂巢模型密钥配置面_v1.0.md`),复核员与编排侧多次实跑**均未复现**,且该文件经 `git ls-files` 确认**被追踪** ⇒ 与「未追踪」不符,成因未定。**不做专项查证**;若日后复现,须**逐字留档 R4 那一段**(含它点名的越界件与 `非追踪/允许` 两层计数),因为本次缺的正是那份日志。
164
-
165
- ## 五 裁决记录
166
-
167
- **已签收(使用者 2026-09-29)**:
168
-
169
- | # | 项 | 裁决 |
170
- |:--|:--|:--|
171
- | 1 | 编号位宽与溢出 | **4 位**(每单元上限 9999);溢出 **显式报错**,不自动加宽 |
172
- | 2 | 身份/任务/单元是否必填 | **必填**;单元槽取**蜂巢五单元**闭集(真源 `identity.POSITIONS`) |
173
- | 3 | 分配器的唯一实现 | **Rust 侧实现**(MCP/编排面调用它,不自持第二份) |
174
- | 4 | §四.6 控制台 | **不做控制台兼容**:不投 Rust `WriteConsoleW`、不要使用者 `chcp`;取用通道固定走 python + README 明写全 UTF-8 约定(详见 §四.6) |
175
-
176
- **因此确定的实现分工**:Rust 侧新增「分配原语」(按 `<身份>_<任务>_<单元>` 前缀 + 独占创建选编号),并同时是字符集闸与归一化的单点;`hive/hive_mcp/mcp_server.py` 与 `hive/orch.py` 走它,不再自造 id(`mcp_server.py:339` 现有 `h{ms}_{uuid4[:6]}` 随之退场)。
177
-
178
- **实现前仍需落地的两项前置**(本契约外、但顺序上先于 id 改造):§四.2 进程自保证 UTF-8、§四.3 裸 `open()` 守卫。理由:id 一旦含中文,任何未对齐编码的读写通道都会立刻显形,先把编码面钉死再改 id,可以避免把两类故障混在一起排查。
179
-
180
- ### 五.1 已动码(2026-09-30 落地)
181
-
182
- **前置(先于 id 改造,已落地)**:§四.2 进程自保证 UTF-8 + §四.3 裸 `open()` 守卫 —— `fa894e32`(入口自保证单点助手 `utf8_boot.ensure_utf8` + 文本模式裸 `open` 守卫 `scripts/verify_open_encoding.py`)、`08c21cd0`(守卫自身接入口自保证,clean env 下退出码不再与违例同码)。
183
-
184
- **本批(id 契约 v2 + 排序口径)**:
185
-
186
- | 面 | 落地件 |
187
- |:--|:--|
188
- | A 排序口径换真值 | `hive/src/job.rs::list_jobs_by_created`(created_ts 升序、次键 id 字典序、缺/坏值归 `i64::MIN`、**只读**);消费者改接同一单点:`main.rs::find_active_by_hash`/`cmd_poll`/`cmd_doctor`、`scheduler.rs` 领取段/`recover_orphans`/`scan_corrupt`、`hive/hive_mcp/mcp_server.py::_t_poll`/`_t_doctor`。`list_jobs` **未改**(仍是名升序,A4)。保序/按真值证明:`job.rs` 单测 `list_jobs_by_created_preserves_legacy_order`、`…_sorts_by_truth_not_name`、`…_handles_missing_and_bad_ts` |
189
- | B1–B3 分配器 | `job.rs::alloc_job_id`(独占创建即分配、4 位定宽、`MAX_UNIT_SEQ=9999` 越界显式报错、不加宽不回绕)+ `init_job_with_slots`(写序单点);CLI `hive alloc-id` |
190
- | B2 五单元闭集 | `job.rs::UNITS` / `unit_canonical`(英文键或中文名都收、落 id 一律中文名),与真源 `md_cg/identity.py::POSITIONS` 同源断言钉死(`job.rs::tests::units_match_identity_positions`) |
191
- | B4/B5 字符集闸 | `job.rs::valid_job_id`(放开时= Unicode 字母/数字 + `_`;拒收路径成分/首尾空白/尾点/控制/零宽/双向控制/保留设备名/非 NFC 稳定形态)与 `mcp_server.py::_valid_job_id` **孪生同改**;跨语言对照语料 `hive/id_contract_corpus_v2.txt`(54 例,Hex 编码防不可见样本被改坏),两侧共读同一份。(**字符集判据本身已于 2026-09-30 换面为区块白名单**,见 §四.4/§四.8 残点①;本行留作批次一的动作记录) |
192
- | B7/B8 提交面 | CLI `hive submit --identity/--task/--unit`(env 兜底 `HIVE_JOB_IDENTITY/HIVE_JOB_TASK/HIVE_JOB_UNIT`)+ `hive alloc-id`;`mcp_server.py` 的 `hive_spawn` 三槽参数**必填**、`_submit` **退场自造 id**(改调 `HIVE_EXE alloc-id`,不可用即显式报错);`orch.py::spawn_subtask` 三槽透传(显式 > 编排者 spec 同名键,缺则报错,不兜底造 id);schema / `README.md` / `hive/README.md` 同步 |
193
- | B9 断言同步 | `hive/src/job.rs` 合法/非法样态断言(合法样本含四槽中文 id)、`hive/hive_mcp/smoke_test.py` 的 `startswith("h")` 断言改为四槽中文 id + 4 位定宽 |
194
- | C 论证订正 | 五处「无环性由 job_id 时间序结构性保证」订正为**存在性闸**(`main.rs` 的 depends_on 存在性检查 + MCP 侧 `_dep_gate` + 运行期 `scheduler.rs::deps_gate`),并注明「旧形态 id 恰好也带时间序、新形态不再有此性质,故论证不得依赖它」。同类措辞一并订正(C2):`hive/README.md`(depends_on 行)、`md_cg/sources.py::HiveJobsSource`(「job_id 名升序 = 时间升序」的代理口径)、`md_cg/units.py::_job_id` 的 docstring(「同 `_submit`」已失实)。**逐处落点(按内容搜,非旧行号)**:`scheduler.rs::deps_gate` 头注、`spec.rs::Spec.depends_on` 头注、`main.rs` 提交面 depends_on 块、`mcp_server.py::_dep_gate` 头注;**第五处(`job.rs` 原 `new_job_id` doc 的「I-1 拓扑序无环性的结构性根基」)随 B7 该函数退场而删除**,订正后的论证落在 `job.rs` 的「id 契约 v2」头注(同处记明被删的原文)。三闸均由**运行期代码坐实**:`main.rs` 的 `jobs.join(dep).is_dir()`(存在性)、`mcp_server._dep_gate` 的 `os.path.isdir(os.path.join(jobs, d))`(存在性,`_valid_job_id` 先行)、`scheduler.rs::deps_gate` 的 `job::valid_job_id` + `ddir.is_dir()`(运行期复核)。C2 全仓内容搜(「时间序」「结构性保证」「名序」「拓扑序」「无环」)另订正 `job.rs::list_jobs` 头注(原「名升序 = 时间升序,job_id 含毫秒时间戳保证」在 B7 后失实)与两处**历史文档**(`docs/hive/蜂巢M6_ingest实施计划_v0.1.md` 的 T1 依据、`docs/eval/故障注入实测_v1.0.md` 的 FI-R06)——后者是留档实测记录,**只在文末追加带日期的订正留痕、不改原记录字节**(其行号被 `docs/eval/缺陷挖掘_自主迭代_v19.md` 按 `:192-193`/`:416` 引用过,故不内联插入) |
195
- | D 守卫 | 新增 `hive/test_id_contract_v2.py`(A–I 九组 **307 条断言** + `--branch-baseline` **12 处定点变异 + 1 处假阳性对照**(红项集/退出码**逐项实测后写死**,2026-09-30)+ `--head-baseline` 红基线(**逐条谓词用各自的批次锚点**:10 条谓词在锚点上必红、在工作区上必绿)。**c13/c14 同轮升级**:C 组新增第三处读者(`md_cg/units.py`)的「判据 ≡ 同一张表」全码点遍历(C8e/C8f/C8h)与 Rust 侧 fail-closed 单测在位核验(C8g);变异面新增**数据面**(表删一段 / 多塞一段:Python 内存副本 + Rust 临时 crate 副本的表文件)、**解析失败改 fail-open**、**md_cg 退回 ASCII 白名单**;守卫自身 UTF-8 自保证经 clean env(无 `PYTHONUTF8`、无 `-X utf8`)实测:**带锚 rc=0;去掉锚 rc=1 且 `UnicodeEncodeError`**(与违例同码,正是 c14 要防的形态)) |
196
-
197
- **本批两处实现级裁决**(均按 §五 的「严于必需且两侧可证同判」取舍):
198
-
199
- 1. **B5 的 NFC = 拒收,而非归一化**。§四.1 原表述为「归一化在写入边界执行一次」;实现层收窄为「**须已是 NFC 稳定形态,否则拒收**」。理由:`hive/Cargo.toml` 的 `[dependencies]` 是空段(零依赖 D-005),手写完整 NFC 不可行;**拒收严于静默归一化**(后者会把不同字节静默改成同一 id,掩盖提交方的编码错误),且拒收判据可用有限的「会改写区块」闭集在两侧逐区间对齐、可证同判(`job.rs::NFC_REWRITE_BLOCKS` ↔ `mcp_server.py::NFC_REWRITE_BLOCKS`,守卫逐区间比对)。**残余边界(已实测、已声明)**:两侧的「字母数字」判据各随自己的 Unicode 表演化(Rust 工具链 vs Python `unicodedata`)——实测(2026-09-30,Python `unicodedata` 15.0.0 × 本机 rust 工具链):Python 判「未分配(Cn)」的 825345 个码点中,Rust 收而 Python 拒的 **9713 个(56 区间,即 Unicode 15.1/16 新增字母,如 Todhri / CJK 扩展 I)**。该残余**方向安全**(Python 永不超过 Rust 的受理面 ⇒ 越权面为零),且不嵌静态表(表会随 Unicode 版本陈化且无廉价陈化检测,收益为零);守卫 `test_id_contract_v2.py` 的 C8 以**全码点批量+二分**完备证明「Python 收 ⟹ Rust 收」,C9 逐轮实测残余的定性(只许落在 Python-Cn 上)与方向,`--cn-sweep` 提供残余重导入口(≈44 分钟)。另 `Other_Alphabetic` 一类(Mn/Mc/So 共 1405 码点)已由实测导出表补齐,**语义分歧已消除**(该表由守卫 C7 每轮以真 exe 重导比对,陈化即红)。
200
- > **(2026-09-30 订正留痕 · 裁定 ①-(c))本条的机制叙述已被取代**:`NFC_REWRITE_BLOCKS` 闭集、`Other_Alphabetic` 补齐表与 Cn 残余声明**整段退休**(不许新旧两套并存),判据换成 `hive/id_charset_blocks.txt`(唯一真源,三处共读,**不查任何 Unicode 属性库**);正文里的 9713 残余、C8/C9 与 `--cn-sweep` 的「44 分钟必需性」表述随之退场,改由两侧各自的「判据 ≡ 表」全码点遍历(零分歧)承载。原文保留作批次一(提交 `15fb2bcd`)的历史记录,现状口径以 §四.4 与 §四.8 为准。
201
-
202
- 2. **B8 的四槽接口名与 `alloc-id` 子命令**。CLI 旗标 `--identity/--task/--unit`(env `HIVE_JOB_IDENTITY/HIVE_JOB_TASK/HIVE_JOB_UNIT`);新增子命令 **`hive alloc-id --identity X --task Y --unit Z`**(只分配、打印 id,**目录即分配凭证**;不写 spec/status);MCP 工具 `hive_spawn` 参数 `identity/task/unit`(必填,不落 spec);内部函数名 `job::alloc_job_id(jobs, identity, task, unit)` / `job::init_job_with_slots(...)` / `mcp_server._alloc_job_id` / `mcp_server._submit(jobs, spec, identity, task, unit)`。失败一律非 0 退出 / `ok:false` 且带可读原因(缺槽错误文本含四槽名与一个可照抄示例)。
203
-
204
- ### 五.2 本批发现但**未动码**的残余(如实登记,不静默)
205
-
206
- | # | 位置 | 事实 | 处置 |
207
- |:--|:--|:--|:--|
208
- | 1 | `md_cg/units.py::_job_id`(`job_id()` 在 `:342` 被消费) | 存在**第三处** id 生成器 `h<毫秒>_<uuid6>`——契约 §四.7 只点名 `mcp_server.py:339`,B8 的改动面也只列 CLI/MCP 提交面/orch 透传;**md_cg 复核派发面不在其中** | 未改码。旧形态 id 在新契约下仍合法(存量零迁移)⇒ 不闯闸、不破坏领取;但与「分配器唯一实现在 Rust 侧」(§五 裁决 3)不齐。已在函数 docstring 里如实标注(C2 同类措辞订正),留待单独裁决(牵动 md_cg 派发/等待链语义与 `md_cg/test_units_poll.py`) |
209
- | 2 | `md_cg/sources.py::HiveJobsSource._jobs()` | 按**名升序**枚举 job 目录、原 docstring 断言「名序 = 时间序」(契约 v2 起失实:只有旧形态 id 才有该巧合) | 已订正 docstring(C2);**代码未改**(名序仍确定,`(session, seq)` 去重键跨轮稳定,仅不再等于时序)。若要真时间序须改走 `created_ts` 真值——牵动 md_cg 摄入链,留待单独裁决 |
210
- | 3 | ~~两侧 Unicode 表版本差~~ **已收口(2026-09-30 裁定 ①-(c),见 §四.8 残点①)** | 旧口径(`is_alphanumeric` 属性判定)下 Python 判「未分配(Cn)」而 Rust 收的码点——判据**已换成同一份区块表**,两侧接受集由同一份数据决定,版本差**结构性不可能** | 该残余与 `--cn-sweep`(≈44 分钟路径)**一并退场**(不留重导入口:无属性表可陈化);改由两侧各自的「**判据 ≡ 表**」全码点遍历(零分歧)+ `--branch-baseline` 的 12 处定点变异(含数据面删/加区间、解析失败改 fail-open)承载 |
211
- | 4 | `scripts/test_utf8_boot_guard.py::check_e2e_hive`、`md_cg/test_issue39_utf8_stdio.py` 的 2b/2d | 这两条探针原以「中文 `hive_spawn` 返回 ok+job_id」为证据;其隔离设计把 `HIVE_EXE` 钉在**不存在的路径**(绝不拉起真 serve),而 `_submit` 自 B8 起需真二进制 ⇒ 该成功路径在其面**结构性不可达** | 已改判为**更强**的编码判据:断言 `ok=false` 且原因里**逐字节回显**请求中的中文路径(且错误不是「缺四槽」⇒ 中文入参已过 JSON 解码与四槽闸)。改动已在两文件内**显式声明**,非静默放宽 |
212
-
213
- ---
214
-
215
- ## 六 不适用条件
216
-
217
- - 本稿不覆盖插件宿主与前端渲染的编码面;只论本仓三面(Rust 内核、Python 认知图与执行器、TS 桥)。
218
- - 存量库与存量任务的**内容**不在范围内(只论路径、文件名与任务标识);需要搬动既有存量数据的条目另开批次。
219
- - 归一化形态一旦定为 NFC,原本按 NFD 存储的存量名字**不做自动迁移**——那需要单独的迁移方案与中止条件。
220
- - 本稿不含实现;签名前不动码。