@furongjun1999/dsh-memory 0.8.1 → 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 -659
  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 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +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_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  572. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/hive/README.md ADDED
@@ -0,0 +1,705 @@
1
+ # ⬢ hive · 灵枢蜂巢(多智能体并发引擎)
2
+
3
+ > 蜂群多智能体的 **Rust 并发调度面**:大脑出题(spec),蜂巢并发执行(worker 池),
4
+ > 文件协议交付(result.json)。纯 std 零第三方依赖(D-005),调度生命周期全在 rust——
5
+ > worker 池、心跳、超时强杀、kill 通道、崩溃恢复;HTTPS/LLM 调用委托零依赖 Python
6
+ > 执行器子进程(urllib 走系统证书)。
7
+
8
+ ## 状态:逐步稳定中(欢迎反馈)
9
+
10
+ 蜂巢是灵枢五件套里**最新的一层**。调度生命周期已闭环——worker 池、`claimed.lock` 原子领取、
11
+ 心跳、超时强杀、kill 通道、崩溃恢复(`claimed` 重投 / `running` 诚实标 error)——并有回归验证
12
+ (`cargo test` + MCP 冒烟)覆盖。但**并发、超时、崩溃恢复这类路径,只有在真实任务与真实机器上
13
+ 跑得足够多才会真正稳定**:本层会持续迭代,接口(文件协议 + spec 字段)保持稳定,内部行为按
14
+ 真实反馈打磨。
15
+
16
+ 因此**特别欢迎下载试用后反馈**——拉起失败、任务卡住、心跳异常、平台差异、kill 不生效、
17
+ 超时判定偏差等**失败路径**,比「我这边跑通了」有价值得多。请开
18
+ [Issue](https://github.com/FuRongJun-1999/dsh-memory/issues) 并附 `hive doctor` 输出
19
+ (serve 存活 / 任务状态统计 / env 检查),能显著缩短定位时间。
20
+
21
+ ## 迭代状态:**实测迭代期**(2026-09-22 起)
22
+
23
+ 蜂巢于 2026-09-22 曾转「迭代中的产品」暂停常规派发;同日使用者裁定**进入实测迭代**:
24
+ 蜂巢不稳定,边实测边修——主代理(编排/裁决)+ 蜂巢 worker(子代理)协作迭代。
25
+ **迭代纪律**:每批修改 = 一个 git 提交点,验证(测试/门禁/探针)绿才推进、红即 revert;
26
+ 每批留反思(偏差归因)与验证结论。工程真源:`蜂巢记忆架构设计.md`(外部设计稿,M1–M7,
27
+ P0 可开工)+ `docs/hive/蜂巢设计_理论对齐_v0.1.md`(理论锚点与裁决)。
28
+
29
+ **迭代批次记录(2026-09-23)**:批次 4-7 = M6 事件源/暴露口/事件级密级 + mine_fix_pairs
30
+ 系统纪律化 + rerun_on_recover 逃生门 + 工具层回读拦截 + M6 真实库实跑(98 事件落盘);
31
+ 批次 8a = **经验回路全链首次真实升层**(fix_25734ee75277,阶段 1 首证达成)+ 两摄取缺陷
32
+ 修复;批次 8b = **判据面重定义**(三承重测试迁 `hive/tests/judgment_surface.rs`,
33
+ 判据面/候选面物理分离成立 + `scripts/judgment_manifest.py` 清单 hash 工具——互验
34
+ 本体 A3 的前置缺口收口);批次 9 = **flush×compact/rebuild 临界区互斥**(9·12 多写者
35
+ 病灶防治,能红双态实证);批次 10-11 = **互验本体切片①②**(§7.1-7.3 身份心跳/
36
+ A1A2A3/verdict 脱敏门禁 + §7.4 派发/执行/入库原语,`hive/verify_runner.py`);
37
+ 批次 12 = **CCG 六要素注释补齐**(rust 侧非测试 fn 66/66 接口层全覆盖 + orch/
38
+ verify_runner 差额——注释真源=批次 4-11 认知图机制记忆,递归自我改进实测:知识→
39
+ 代码文档化路径)。
40
+
41
+ **三条流程纪律(可核断言,2026-09-23 从 issue #24 复盘蒸馏)**:
42
+
43
+ 1. **先查后写**:任何单元施工前,工作记录必须列出「已查文档清单」——该单元的
44
+ 理论条款(智能论 3.x 带行号)+ 单元设计文档 + 仓内既有实测记录。无清单不开工。
45
+ *教训*:`consolidate.py` 用 `max_tokens=1200` 硬编码时,仓内已有实测记录
46
+ (`bench_lme_zh.py:113`,2026-09-11:「deepseek-flash 与 deepseek-v4-pro 都是
47
+ 推理模型」)未被查找接入——知识在仓内,开发流程没强制接。
48
+ 2. **独立复审**:交付前必须有一次独立于作者的复审(另一实例或专门 review pass),
49
+ 提交信息记录复审要点。*教训*:issue #24 三连缺陷(硬编码默认值 / 无 CLI+env
50
+ 口子 / 不检查 `finish_reason=="length"`)全是复审面一眼可抓项,却由外部
51
+ 使用者首发——发布链路只有测试没有复审。
52
+ 3. **误差归因闭环**:同一错误信号(DEFER / parse_failed / rejected…)**累计 ≥2 次
53
+ 即触发理论归因**(回智能论/设计文档找条件层误差,写归因记录),不允许停留为
54
+ reasons 统计噪音。*教训*:`parse_failed` 在认知图固化轮次早已多次出现,
55
+ 无人归因,直到外部 issue #24 才钉死根因——观测面有数据,闭环缺一环。
56
+
57
+ ### 迭代项 1(已修):执行任务时弹终端
58
+
59
+ - **现象**:每经蜂巢跑一个任务就弹出一个终端窗口,打断使用者正在做的事。
60
+ - **根因**:`serve` 由 `serve_start.py` 以 `DETACHED_PROCESS` 拉起(**自身无控制台**),
61
+ 而它 spawn 的 `python.exe` / `tasklist.exe` 都是 console 子系统程序;Windows 在
62
+ 「父进程无控制台 **且** 子进程未声明 `CREATE_NO_WINDOW` / `DETACHED_PROCESS`」时
63
+ 会为子进程**新建一个可见的控制台窗口**。全仓仅两处裸 spawn
64
+ (`src/exec.rs::spawn_executor`、`src/main.rs::tasklist_row`),两处都缺该 flag。
65
+ - **修复**:`src/exec.rs` 新增 `hide_window(&mut Command)`(Windows 设
66
+ `CREATE_NO_WINDOW = 0x0800_0000`,其余平台 no-op),两处 spawn 统一走它。
67
+ - **验证**:`cargo test` 22/22(lib 17 + main 5)零回归;端到端探针跑在真实执行器链内,
68
+ 报告 `HWND=0 VISIBLE=False`(探针:`test_console_window.py`,含复验命令)。
69
+ - **诚实边界**:未做「修复前主动复现」(避免再次弹窗打扰使用者);根因依据 = 使用者现场报告
70
+ + 源码取证(全仓仅此两处 spawn,均缺 flag)+ Windows 文档语义。
71
+
72
+ ## 架构
73
+
74
+ ```text
75
+ 调用方(agent / MCP 宿主)
76
+ │ hive_spawn / hive submit(spec.json)
77
+ ▼
78
+ hive serve(rust 纯 std,常驻)
79
+ │ 主循环扫描 jobs/ → 占在飞名额(≤ workers,H-7)→ claimed.lock 原子领取 → worker 池并发
80
+ │ 1s 轮询:退出 / kill 标志 / 超时 → child.kill()
81
+ ▼
82
+ 执行器(可替换子进程,serve 级配置 HIVE_EXEC_PY)
83
+ │ 确定性任务 → exec_cmd.py:跑 command(零 LLM / 不涉网络)
84
+ │ LLM 任务 → exec.py:调 OpenAI 兼容 chat/completions(GLM 同形)
85
+ │ 编排任务 → orch.py:spec.orchestrate 真值 → 拆子任务 / 卡片收口(见「任务编排」)
86
+ │ 统一契约:读 spec.json → 写 result.json
87
+ ▼
88
+ result.json(error 字段区分成败,幂等终态)
89
+ ```
90
+
91
+ 分工原则:**rust 管并发与生命周期,python 管协议与 LLM**。TLS 无第三方库在纯 std
92
+ rust 不可行,故 HTTPS 放执行器;执行器是可替换子进程——换 curl / 其它 SDK 宿主时,
93
+ 保持「读 spec.json、写 result.json」契约即可。
94
+
95
+ ## 快速开始
96
+
97
+ ```bash
98
+ # 构建(零第三方依赖,无 cargo install 之外的任何安装)
99
+ cd hive && cargo build --release
100
+
101
+ # ⚠ cargo 不在 PATH 时(Windows 常见:rustup 装完未重启终端 / 未加 PATH)用绝对路径:
102
+ # "%USERPROFILE%\.cargo\bin\cargo.exe" build --release --manifest-path hive/Cargo.toml
103
+ # CreateProcess 不自动补 .exe 后缀,故须写全 cargo.exe(只写 cargo 会 WinError 2)。
104
+ # 本机实证:shutil.which('cargo') 为 None,但 ~/.cargo/bin 工具链完整(cargo/rustc/rustup 齐备)。
105
+
106
+ # 配置密钥(三角色分离,见「密钥三角色」节的对照表)
107
+ # ① 模型(网关)密钥 = 普通配置,serve 启动时并入 env 并**默认继承给执行器**(LLM 任务靠它)
108
+ set HIVE_API_KEY=你的模型密钥
109
+ # ② 身份令牌 / 锚密钥(独立、**不进执行器**)——只跑编排任务才需要;spec.orchestrate 真值任务条件重注
110
+ # set HIVE_ORCH_TOKEN_FILE=<orch.token 路径>
111
+ # ③ 子代理覆盖(**可选**)——子任务要用另一套模型凭据时才设,缺省继承上面的主密钥
112
+ # set HIVE_SUBAGENT_API_KEY=子代理密钥 & set HIVE_SUBAGENT_API_BASE=子代理 base
113
+ # 本部署不跑 LLM(只跑确定性任务)时显式声明,免被启动前置校验拦下:set HIVE_LLM_DISABLED=1
114
+
115
+ # 起 serve——**唯一推荐正路**:serve_start.py 读本地配置注入 env(key 不落命令行历史)
116
+ # 配置文件:hive/config.local.json(已 gitignore;值支持 直值 | {"env":"系统变量名"} | {"file":"key文件路径"})
117
+ # 首次使用请复制入库模板 hive/config.local.example.json 改名后改值(模板本身不入 gitignore,随仓分发)
118
+ # 推荐形态:HIVE_API_KEY 引系统变量(如 DEEPSEEK_API_KEY),HIVE_WEB_SEARCH_KEY 引 key 文件
119
+ # 启动前只读核对三角色来源与掩码值(绝不出明文):python serve_start.py --show-config
120
+ # 缺模型密钥且未声明 HIVE_LLM_DISABLED 时启动前置校验会拒绝拉起并点名该配哪个键(不静默起一个必报错的 serve)
121
+ python serve_start.py # 拉起(已在跑则拒绝);--stop 停止;--restart 重启;--rebuild 重编译并重启;--status 查看心跳与任务统计(附配置摘要);--show-config 只读查看三角色配置摘要
122
+ # ⚠ 重启/重编译(含 --restart/--rebuild)必须由 **serve 进程树外**执行:主代理 CLI 直跑,
123
+ # 或 MCP `hive_restart` 工具(MCP 进程是宿主拉起的,独立于 serve 树,重启 serve 不会自杀)。
124
+ # 经蜂巢任务派发跑 restart 仍会自毁:worker 属 serve 进程树,stop 杀 serve 即杀自己
125
+ # → 任务中断、新 serve 未必起、无 result 留痕。(本机实证 2026-09-22:pid 8596→24288)
126
+ # ⚠ rust 改动后用 --rebuild(stop→cargo build→start 原子序):serve 在跑时 hive.exe 被
127
+ # Windows 锁定,直接 build 报 os error 5——--restart 中间插不进 build,会「重启了旧二进制」。
128
+ # --rebuild 在 build 失败时保持停止态(fail-closed:宁可停着,不让旧二进制假活)。
129
+ # cargo 定位顺序:HIVE_CARGO env > ~/.cargo/bin > PATH(PATH 常缺 cargo)。
130
+
131
+ # 手动起 serve(**不读 config.local.json**,env 需自行带全;同一 jobs 目录至多一个 serve)
132
+ # ⚠ 直起 hive.exe serve 而未显式设 HIVE_EXEC_PY 时,执行器回退 exec.py(llm_only)——
133
+ # spec 的 command / commands / orchestrate 会失败(确定性执行需 exec_cmd.py)。
134
+ # 确需手动起:先 set HIVE_EXEC_PY=<仓>/hive/exec_cmd.py,或直接用上一行的 serve_start.py。
135
+ target\release\hive.exe serve # 已有 serve 在跑会被拒绝;--force 可强起(迁机 / 心跳残留时用)
136
+
137
+ # 提交任务(stdin JSON)——模型名须与 HIVE_API_BASE 配对(见 spec 字段表)
138
+ # ⚠ id 契约 v2(四槽必填):--identity / --task / --unit 缺任一即**显式报错**退出 1
139
+ # (不许静默推导;编号槽由分配器给出,无需入参)。单元槽取**蜂巢五单元闭集**:
140
+ # 记录单元 / 反思单元 / 验证单元 / 输出单元 / 维生系统
141
+ # (英文键 record/reflect/verify/output/sustain 亦可,落 id 一律中文名)。
142
+ # env 兜底:HIVE_JOB_IDENTITY / HIVE_JOB_TASK / HIVE_JOB_UNIT。
143
+ # 落盘 id 形态:h_<身份>_<任务>_<单元>_<编号>(编号 4 位定宽;用满 9999 显式报错,不加宽不回绕)。
144
+ echo {"model":"deepseek-flash","user_prompt":"总结这份文档","context_files":["README.md"]} | target\release\hive.exe submit - --identity zcode端 --task 灵枢迭代 --unit 反思单元
145
+
146
+ # 只取 id(不写 spec/status):**分配即创建目录**(独占创建即分配),打印 {"ok":true,"job_id":…,"dir":…}
147
+ target\release\hive.exe alloc-id --identity zcode端 --task 灵枢迭代 --unit 反思单元
148
+
149
+ # 查状态 / 强杀 / 体检
150
+ target\release\hive.exe poll
151
+ target\release\hive.exe kill <job_id>
152
+ target\release\hive.exe doctor
153
+ # 坏 status 的显式处置(H-3):归类 → 隔离 → 可回退;status.json 本体逐字节不被动。
154
+ target\release\hive.exe doctor # task_states 出 corrupt 类别 + corrupt_jobs 明细(不再压进 unknown)
155
+ target\release\hive.exe doctor --quarantine # 把「当下 status.json 不可解析」的任务整体移入 jobs/_quarantine/
156
+ target\release\hive.exe doctor --unquarantine # 隔离件原路退回池内(可回退)
157
+ ```
158
+
159
+ ### MCP 接入(推荐宿主直连)
160
+
161
+ `hive/hive_mcp/mcp_server.py` 提供五工具(手写 stdio JSON-RPC,形态对齐
162
+ `md_cg/mcp_server.py`):
163
+
164
+ | 工具 | 用途 |
165
+ |---|---|
166
+ | `hive_spawn` | 提交 LLM 任务(**入参白名单** + spec 结构校验 fail fast),返回 job_id;**id 契约 v2:`identity` / `task` / `unit` 三参数必填**(id = `h_<身份>_<任务>_<单元>_<编号>`,编号由 Rust 侧分配器独占创建给出;单元槽取蜂巢五单元闭集);支持 `depends_on`(依赖门禁:写入前过格式 + 存在性两道闸,与 CLI 同判据,见「spec 字段」);确定性/编排任务走 CLI(见「确定性执行」「任务编排」) |
167
+ | `hive_poll` | 无 id = 全部摘要(content 截 800 字);带 id = 单查全文;`handoff_ready=true` = 子代理满上下文交回,待主代理裁决续跑 |
168
+ | `hive_kill` | 写 kill 标志,worker ≤1s 内强杀 |
169
+ | `hive_restart` | 重启 serve(stop→start 原子序,复用 `serve_start.restart`):改 serve 级配置或 rust 重新 build 后使改动生效;stop 失败绝不 start(防双实例)。重启中断 claimed/running 任务,重启后由 recover_orphans 收尸 |
170
+ | `hive_doctor` | serve 存活 / 任务状态统计 / env 检查(status 三态分类:`corrupt`=不可解析单列类别 + `corrupt_jobs` 明细;`no_status`=提交竞态窗口;`quarantined`=已隔离件清单) |
171
+
172
+ 首次 spawn 自动以 detached 方式拉起 serve(Windows
173
+ `DETACHED_PROCESS|CREATE_NO_WINDOW`)。**执行器是 serve 级配置**:
174
+ `HIVE_EXEC_PY` / `HIVE_JOBS_DIR` 在 serve 启动时读取,改动后须重启 serve 才生效。
175
+
176
+ **统一子代理默认**(缺省即注入 spec,调用方显式传值优先):`reasoning_effort=high`、
177
+ `context_budget_tokens=200000`、`timeout_s=600`(10 分钟);spawn 返回体 `spec_defaults`
178
+ 回显实际生效值便于核对。
179
+
180
+ **serve env 的真实来源 = `config.local.json`**(**仅当经 `serve_start.py` 拉起时**)。serve 的
181
+ env 在启动时固化,子进程无法反查——故 `hive_doctor` 从**serve 自报的心跳**读执行器资格
182
+ (`exec_py` / `exec_mode` / `exec_source`,**权威**),另有 `serve_env_source`(config 期望值)
183
+ 与 `mcp_process_env`(仅诊断,用它判必得错位结论)两组参考值。
184
+
185
+ **两条拉起路径的 env 口径并不相同**(此为实测缺陷,勿混同):
186
+
187
+ - `python hive/serve_start.py` / MCP 首次 spawn → 读 `config.local.json` 注入 ⇒ 与配置一致
188
+ (且启动前有前置校验:无可用模型密钥且未声明 `HIVE_LLM_DISABLED` 真值即拒绝拉起);
189
+ - 裸 `hive.exe serve` → **不读任何配置**,只认进程 env ⇒ `HIVE_EXEC_PY` 等常缺失,
190
+ 执行器回退 `exec.py`(llm_only),确定性执行不可用(serve 启动时 stderr 会告警;
191
+ 模型密钥 `HIVE_API_KEY` 也只在 shell 里显式设过才在——**这条路径没有 serve_start 的前置
192
+ 校验**,缺键不是拒绝启动而是每个 LLM 任务各自报「模型密钥未设置」类错误,错误里点名该
193
+ 配哪个 env 键)。
194
+
195
+ 判定「当前 serve 能不能跑确定性任务」的唯一可靠办法:看 doctor 的 `exec_mode`
196
+ (`exec_source=serve_heartbeat` 时即 serve 自报值),或直接提交一个带 `command` 的探针任务。
197
+
198
+ ### 各 harness 注册(通用接入)
199
+
200
+ 蜂巢对宿主是**标准 MCP server(stdio)**,各端只需在自己的 MCP 客户端配置里加一条 server
201
+ 条目——**不需要改 hive 代码**:
202
+
203
+ ```json
204
+ {
205
+ "mcpServers": {
206
+ "hive": {
207
+ "command": "python",
208
+ "args": ["-m", "hive.hive_mcp.mcp_server"],
209
+ "env": { "PYTHONPATH": "<本机 dsh-memory 仓库绝对路径>" }
210
+ }
211
+ }
212
+ }
213
+ ```
214
+
215
+ TOML 形态(Codex CLI):
216
+
217
+ ```toml
218
+ [mcp_servers.hive]
219
+ command = "python"
220
+ args = ["-m", "hive.hive_mcp.mcp_server"]
221
+ startup_timeout_sec = 120
222
+
223
+ [mcp_servers.hive.env]
224
+ PYTHONPATH = "<本机 dsh-memory 仓库绝对路径>"
225
+ ```
226
+
227
+ **只需 `PYTHONPATH`**:jobs 目录、`config.local.json`、`hive.exe` 一律由该路径下的 `hive/`
228
+ 推导(`HIVE_JOBS_DIR` / `HIVE_EXE` / `HIVE_CONFIG` 可覆盖)。`config.local.json` **不入库**
229
+ (含密钥),首次使用请复制同目录的入库模板 `config.local.example.json` 改名后改值。
230
+ 注意:这段 env 只作用于
231
+ **MCP 进程自身**(用于定位路径);**serve 的运行 env 由 `config.local.json` 决定**,
232
+ 与客户端配置里写了什么无关——两者不是一回事,不要互相推断。
233
+
234
+ 仓内已含该条目的模板(照抄即可):
235
+
236
+ | harness | 模板 | 客户端配置落点 |
237
+ |---|---|---|
238
+ | CodeBuddy / ZCode | [`../codebuddy/mcp.json`](../codebuddy/mcp.json) | CodeBuddy 用户级 `mcp.json`(ZCode 同构,仅 `MDCG_ACTOR` 不同) |
239
+ | Claude Code | [`../claude/mcp.json.example`](../claude/mcp.json.example) | 项目级 `.mcp.json`(或 `claude mcp add`) |
240
+ | Codex CLI | [`../codex/config.toml.example`](../codex/config.toml.example) | `~/.codex/config.toml` |
241
+ | Claude / Codex 插件 | 插件内 `mcp.json.example` / `config.toml.example` | 同上(随插件分发) |
242
+ | DSH | —— | **形态不同**:本端是插件内建桥(TS 侧 spawn + 工具注册),非原生 MCP 客户端;当前兜底 = CLI `hive submit` |
243
+
244
+ **「通用并发」的落地语义**:池与 serve 由 `PYTHONPATH` 推导 ⇒ **多个 harness 指向同一仓库
245
+ 即共享同一并发池与同一个 serve 进程**(谁派的任务都进同一队列、由同一 worker 池消费)。
246
+ 要让某端用独立池(高优 / 隔离实验),给它加 `HIVE_JOBS_DIR`(+ 独立 `HIVE_CONFIG`)——
247
+ 不同 jobs 目录 = 不同 serve 实例,互不干扰。
248
+
249
+ **两条必读边界**:
250
+
251
+ 1. **`workdir` 取 MCP 进程 cwd**(MCP 面不接受 `workdir` 入参)⇒ 各端启动 MCP 进程的工作
252
+ 目录即 `context_files` 相对路径的基准;喂上下文请用**绝对路径**,或确认该端 cwd。
253
+ 2. **确定性执行与编排不在 MCP 面**(`command` / `commands` / `orchestrate` / `workdir` 四键
254
+ 只走 CLI)⇒ 跑测试 / 脚本 / 批量命令请用 `hive.exe submit --spec <spec.json>`(执行器
255
+ `exec_cmd.py`,零 LLM);MCP 面传入会被 fail fast 拒绝(不静默丢弃)。
256
+ ⚠ **submit 只认 `--spec <file>` 或 stdin 的 `-`**:位置参数会被忽略并转而读**空 stdin**,
257
+ 表现为 exitCode 1 且**无任何输出**(易误判成 serve 故障,实为参数形态问题)。
258
+ ⚠ **未传 `workdir` 时,命令的 cwd 是 worker 侧的 job 目录**(`hive/jobs/<job_id>/`),**不是** submit 时的 shell cwd;`workdir` 既作 `context_files` 相对基准,也作命令执行 cwd。⇒ 命令里的脚本/数据一律用**绝对路径**,或显式传 `workdir`。(实测:用相对路径脚本会 `can't open file` → exit=2;命令回显的 `cwd` 字段可直接核对。)
259
+
260
+ ### 任务上下文管理(谁负责哪一段)
261
+
262
+ 蜂巢把「任务上下文」拆成四段,各有明确归属——主代理据此裁决,而不是把上下文一股脑塞进一次调用:
263
+
264
+ | 段 | 承载 | 说明 |
265
+ |---|---|---|
266
+ | 注入 | `hive_spawn` 的 `context_files`(+ `system_prompt` / `user_prompt`) | 逐个读入为 `<context path="...">` 块拼在 prompt 前;读取失败写错误块不中断 |
267
+ | 预算 | `context_budget_tokens`(MCP 面默认 200000)+ `context_strict` | 达预算**默认交回续跑**(写进展卡 + `need_continue`);`context_strict=true` 才恢复「超预算即 error」 |
268
+ | 交接 | `hive_poll` 的 `handoff_ready` + 进展卡 `progress.jsonl` | `handoff_ready=true` = 子代理满上下文交回;主代理读卡后裁决**续跑**(新 spawn 带卡)或**收口** |
269
+ | 观察 | `hive_poll`(无 id = 全部摘要 / 带 id = 单查全文) | 主代理只做编排:派发 → 观察 → 裁决,不把子任务上下文搬进自己的窗口 |
270
+
271
+ ## spec 字段
272
+
273
+ | 字段 | 必填 | 说明 |
274
+ |---|---|---|
275
+ | `model` | 是 | 模型名,缺失即拒。**须与 `HIVE_API_BASE` 配对**:deepseek base(`api.deepseek.com`)→ `deepseek-flash` / `deepseek-v4-pro`;智谱 base → `glm-5.3-flash`。错配在 API 侧 400(实测:deepseek base 传 `glm-5.3-flash` → `supported API model names are deepseek-flash, deepseek-v4-pro`) |
276
+ | `user_prompt` | 是 | 非空(trim 后),内容保留原样不 trim |
277
+ | `system_prompt` | 否 | system 消息 |
278
+ | `context_files` | 否 | 文件列表,逐个读入以 `<context path="...">` 块拼在 prompt 前;读取失败写错误块不中断 |
279
+ | `workdir` | 否 | context 相对路径基准(默认进程 cwd) |
280
+ | `timeout_s` | 否 | 5..=3600,rust 侧默认 300,**MCP 面注入默认 600**(10min);超时 rust 侧强杀并标 `timeout` |
281
+ | `reasoning_effort` | 否 | 思考强度 `low`\|`medium`\|`high`(rust 侧白名单校验);**MCP 面默认 `high`** |
282
+ | `context_budget_tokens` | 否 | 输入 token 预算(执行器保守估算);达预算默认**交回续跑**(写进展卡 + `need_continue`,见下节);**MCP 面默认 200000** |
283
+ | `context_strict` | 否 | `true` 恢复旧行为(超预算即 `error` 终止,不交回);缺省 = 交回续跑 |
284
+ | `thinking` | 否 | 思考开关透传(如 `{"type":"enabled"}`) |
285
+ | `max_tokens` / `temperature` | 否 | 透传 API |
286
+ | `tools` | 否 | 工具白名单,子集 `["lingshu_cg","web_search","read_file"]`;非空即启用 agent loop(function calling 循环),缺省 = 单发调用(历史行为逐位不变) |
287
+ | `max_tool_rounds` | 否 | 工具轮上限,默认 5;达到后强制终答(不带 tools 再发一次) |
288
+ | `mdcg_root` | 否 | lingshu_cg 的认知图根兜底(env `MDCG_ROOT` 优先);如任务级隔离用临时图 |
289
+ | `web_search_backend` | 否 | web_search 后端兜底(env `HIVE_WEB_SEARCH` 优先):`zhipu` / `duckduckgo` |
290
+ | `depends_on` | 否 | **依赖门禁(I-1)**:上游任务 job_id 列表——全 `done` 才被领取;任一上游终态非 `done`(`error`/`timeout`/`killed`/`needs_review`)→ 本任务直接 `error`(失败传播)。提交侧两道闸:**格式**(`h` 开头且不含路径成分,`spec.rs` 走 `job::valid_job_id`)与**存在性**(`jobs/<dep>` 必须是目录,`main.rs`)。调度侧判据在 `scheduler.rs::deps_gate`。三维都支持:CLI `hive submit`、MCP `hive_spawn`(写入 spec 前同两闸,不过闸 fail-closed 拒绝)、`orch.py::spawn_subtask`(透传 + 同闸)。无环性由**存在性闸**结构性保证:提交时只能引用**已存在**的任务目录(引用不到提交时尚不存在的任务,自引用亦不可能)——**不是**由 id 的时间序保证(旧形态 id 恰好也带时间戳,契约 v2 的语义四槽 id 不再有此性质,故论证不得依赖它) |
291
+ | `orchestrate` | 否 | 编排形态:真值(`true` 或 `{"max_subtasks": N}`)→ 由 `orch.py` 接管(见「任务编排」)。多态转发须 `HIVE_EXEC_PY` 指向 `exec_cmd.py`;子任务上限默认 8 |
292
+ | `use_subagent_llm` | 否 | **布尔开关**(只开关、不含值):真值 = 本次任务的模型密钥/base 走「子代理覆盖」——env `HIVE_SUBAGENT_API_KEY`(base 走 env `HIVE_SUBAGENT_API_BASE`,其缺省回落 `HIVE_API_BASE`);缺省/假值 = 主配置(env `HIVE_API_KEY` / `HIVE_API_BASE`)。**密钥与地址一律只从 serve env 读**,写进 spec 也不生效(结构上无凭据外发面);开关真值但子代理 env 为空时安全回落主键(子代理密钥缺失时 base 一并回落主配置——半套配置等于跨网关错配)。`orch.py` 派发子任务时按 serve env 自动写入 |
293
+
294
+ **面差异(先看清再传参)**:上表是 **spec.json 字段表**(CLI `hive submit` 的全集)。
295
+ MCP 面的 `hive_spawn` **只接受其中 19 键**(含 id 契约 v2 的三槽参数 `identity`/`task`/`unit`——
296
+ 它们是**提交面参数**、不落 spec;见下方「任务标识(id 契约 v2)」)——除 `workdir`(本面强制取 MCP 进程 cwd)、
297
+ `orchestrate` 与 `use_subagent_llm`(执行器侧配置开关,由编排面或 CLI 写)外的全部,
298
+ `command` / `commands` 亦不在其列。这五个键**只走 CLI**(见下节);
299
+ MCP 面传入会被**显式拒绝**(fail fast 并指路 CLI),不再静默丢弃——静默丢弃的后果是
300
+ 「以为在跑确定性任务、实际走了 LLM 路径烧 token」。白名单与 `hive_spawn` 的 schema
301
+ 同集,由 `hive/hive_mcp/smoke_test.py` 断言守卫。
302
+
303
+ ### 任务标识(id 契约 v2)
304
+
305
+ 真源:[全中文编码与蜂巢任务标识契约 v2.0](../docs/plans/全中文编码与蜂巢任务标识契约_v2.0.md)。
306
+ 形态 `h_<身份>_<任务>_<单元>_<编号>`(例 `h_zcode端_灵枢迭代_反思单元_0001`):
307
+
308
+ | 槽 | 必填 | 来源 | 说明 |
309
+ |---|---|---|---|
310
+ | 身份 | **是** | 提交面显式声明 | `--identity` / env `HIVE_JOB_IDENTITY` / MCP `identity`;不许静默推导 |
311
+ | 任务 | **是** | 同上 | `--task` / `HIVE_JOB_TASK` / MCP `task` |
312
+ | 单元 | **是** | 同上 | `--unit` / `HIVE_JOB_UNIT` / MCP `unit`;取五单元**闭集**(词表有既有真源 `md_cg/identity.py::POSITIONS`,守卫同源断言钉死) |
313
+ | 编号 | 分配得出 | Rust 侧分配器 | 该 (身份,任务,单元) 前缀下的序号,**4 位定宽**;**独占创建即分配**(`fs::create_dir`,AlreadyExists 才 +1 重试)⇒ 碰撞结构上不可能;用满 9999 **显式报错**(不加宽、不回绕) |
314
+
315
+ - **分配器唯一实现在 Rust 侧**(`hive/src/job.rs::alloc_job_id`):CLI `hive alloc-id` 暴露它,
316
+ MCP / 编排面**调它取 id**,不自持第二份(旧 `h{毫秒}_{uuid6}` 形态已退场;
317
+ `HIVE_EXE` 不可用即显式报错,不静默降级)。
318
+ - **编排面透传**:`orch.py::spawn_subtask` 的三槽「显式传值 > 编排者 spec 的同名键
319
+ `identity`/`task`/`unit`」;两处都缺即**显式报错**(不兜底造 id)。故要让子任务按职能
320
+ 归单元,可在编排者 spec 里带上这三键,或在 `spawn_subtask` 里逐次显式指定。
321
+ - **字符集闸**(与 MCP 面**共读同一份数据**,不是两套常量):白名单 = `hive/id_charset_blocks.txt`
322
+ 的**区间并集**(Rust 侧 `include_str!` 编译期嵌入 + 首次使用惰性解析,纯 std;表由
323
+ `scripts/gen_id_charset_blocks.py` 生成、可重跑、`--check` 判陈化),另收两个**结构字符**
324
+ `_`(槽分隔符)与 `.`(非尾点、非单独);拒收路径成分(`/` `\` `:`、单独的 `.`/`..`)、
325
+ 首尾空白、尾点、控制/零宽/双向控制字符、Windows 保留设备名(含 `CON.txt` 形态),
326
+ 以及**白名单外的一切字符**——含会归一化改写的形态(CJK 兼容表意 / 全角 / 带圈 /
327
+ 数学字母 / 组合标记等):**不做静默归一化**,收下即说明已是 NFC 形态(表内每码点
328
+ 都由生成器筛过 NFC 稳定)。
329
+ **判据不查任何 Unicode 属性库**(不用 `is_alphanumeric`,也不做 NFC 计算)⇒ 与 Python
330
+ 面的属性表版本差**结构性不可能**;表缺失 / 解析出空区间集 ⇒ 判据一律 false
331
+ (**fail-closed**,绝不放行)。
332
+ 跨语言逐例同判由 `hive/id_contract_corpus_v2.txt` 的对照语料钉死。
333
+ - **存量零迁移**:旧形态 `h<13位毫秒>_<4位hex>`(含 `h1_a`、裸 `h`)**仍然合法**、
334
+ 仍被 `list_jobs` 收、仍可 poll/kill。
335
+ - **排序口径**:id 不再含时间 ⇒ 一切「按时间序」的语义(FIFO 领取 / 最老者去重 /
336
+ 汇总遍历)走 `status.created_ts` 真值单点(Rust `job::list_jobs_by_created`、
337
+ Python `_list_jobs_by_created`);`list_jobs` 本身仍是名升序(存量调用点依赖)。
338
+ - 守卫:`hive/test_id_contract_v2.py`(四槽必填两路实跑 / 分配 / 字符集闸两侧同判 /
339
+ 三入口拒收 / 五单元同源 / 排序真值 / 存量共存 / 定点变异自证)。字符集闸的**零分歧**
340
+ 面由三条断言承载:Rust 侧「判据 ≡ 表」全码点遍历(`job.rs` 单测)、Python 侧同一遍历,
341
+ 二者合起来即两侧接受集逐码点相同;**第三处读者**(`md_cg/units.py`)的同一遍历与
342
+ 「同表同拒」由本守卫 C8e/C8f/C8h 另钉(深层 md_cg 面见
343
+ `hive/test_mdcg_units_charset_parity.py`)。`--branch-baseline` 定点变异自证含 12 处
344
+ 变异(数据面表删/加区间、解析失败改 fail-open、md_cg 退回 ASCII 白名单、临时 crate
345
+ 副本表文件删段等)+ 1 处假阳性对照,红项集与退出码逐项实测写死。
346
+
347
+ spec 在 submit 时做存在性校验(context 文件必须已存在,fail fast 防任务白跑)。
348
+
349
+ > **注(id 契约 v2)**:`identity` / `task` / `unit` **不是 spec 字段**——它们是**提交面参数**
350
+ > (CLI 旗标或 env、MCP 入参),只喂给 id 分配器,**不写进 spec.json**。唯一的例外读法是
351
+ > 编排面:`orch.py` 从**编排者 spec 的同名键**读它们作为子任务三槽的缺省(「spec 带则透传,
352
+ > 缺则报错」),故编排者 spec 里带上这三键即可让 `spawn_subtask` 免传(详见「任务标识」节)。
353
+
354
+ ## 任务生命周期与崩溃恢复
355
+
356
+ ```text
357
+ pending → claimed → running → done | error | timeout | killed
358
+ ```
359
+
360
+ - **原子领取**:worker 以 `create_new` 写 `claimed.lock`,多 serve / 多 worker 竞争
361
+ 只有一个成功,无需外层锁。
362
+ - **领取上界(H-7)**:主循环**先占在飞名额再 claim**(名额容量 = `HIVE_WORKERS`),
363
+ 满员即本拍不再领取——不变量:任一时刻处于 `claimed`/`running` 的任务数 **≤ workers**。
364
+ 旧版一拍把池内全部 pending 都 claim 进无界 mpsc 队列,池外只能看到一片 `claimed`
365
+ 却分不出「在跑」与「排在队里干等」(且 claimed 态无 pid/心跳,kill 也够不着);
366
+ 现在超额任务老实留在 `pending`(一等公民:可 kill、可隔离、可改判据),worker 完成后
367
+ 释放名额下一拍继续领——drain 吞吐不变,队列深度有界。
368
+ - **心跳**:worker 周期性刷新 `status.json` 的 heartbeat;serve 侧 `_serve.json`
369
+ 心跳供 doctor 判活——**三层判据缺一不可**:心跳新鲜(`FRESH_MS`)**且** pid 存活
370
+ **且** 该 pid 确实是本程序(同映像名)。第三层是 2026-09-17 补的:pid 号会被无关
371
+ 进程复用,只判「号是否存在」会让一个残留 pid 冒充 serve 而误挡启动(且文案会把
372
+ 运维引向一个并不存在的 serve)。
373
+ - **超时强杀**:超过 `timeout_s` → `child.kill()` → 终态 `timeout`。
374
+ - **kill 通道**:`kill` 标志文件,worker 1s 轮询粒度检测后强杀(诚实边界:非即时信号)。
375
+ - **崩溃恢复**:serve 重启时 `recover_orphans`——`claimed` 重新投递、`running` 标
376
+ `error`(结果未知,绝不假装 done)。
377
+ - **坏 status(H-3)**:`status.json` 不可解析**不再被当成半成品无限等待**。serve 启动
378
+ 即 stderr 点名告警,周期扫描按拍计数,连续 10 拍(约 4s)仍不可解析则落**独立标记**
379
+ `status.corrupt.json`(**绝不改写 `status.json` 本体**——那是任务本体,坏字节原样留着
380
+ 当诊断证据);`hive doctor` 把它算作独立类别 `corrupt` 并附 `corrupt_jobs` 明细;
381
+ `hive doctor --quarantine` 可把该任务整体移出池(`jobs/_quarantine/`,可
382
+ `--unquarantine` 原路退回)。**不做自动终态化**:那等于把坏文件静默吞掉,正是本
383
+ 缺陷的反面;终局处置权留给显式隔离与人工。
384
+
385
+ ## 文件协议(接口即目录)
386
+
387
+ ```text
388
+ jobs/
389
+ _serve.json # serve 心跳(pid/ts/workers/exec_py/exec_mode)
390
+ _quarantine/ # 坏 status 隔离保留区(H-3;doctor --quarantine 移入,
391
+ # 非 h 前缀故对领取面/统计面不可见;可 --unquarantine 退回)
392
+ <job_id>/
393
+ spec.json # 任务规格(submit 时写入)
394
+ status.json # 状态(先写 status 后写 spec = 就绪信号)
395
+ status.corrupt.json # 坏 status 标记(H-3;serve 连续 N 拍解析失败后落的**旁证**,
396
+ # 不是任务本体——status.json 坏也照原样留着)
397
+ result.json # 结果(error 字段区分成败;终态判据)
398
+ claimed.lock # 原子领取锁(create_new)
399
+ kill # kill 标志(存在即请求强杀)
400
+ progress.jsonl # 进展卡(工具轮/终答/交回逐条留痕,见下节)
401
+ claimed/ log.txt # 运行态
402
+ ```
403
+
404
+ 任何语言都能按此协议提交与消费——文件协议即接口,不绑定 MCP 或 CLI。
405
+
406
+ ## 执行器契约
407
+
408
+ `exec.py`(零第三方依赖):`argv[1] = job 目录`,读 `spec.json` 写 `result.json`:
409
+
410
+ ```json
411
+ {"ok": true, "content": "...", "usage": {...}, "model": "...",
412
+ "tool_trace": [...], "tool_rounds": 2, "duration_s": ...}
413
+ {"ok": false, "error": "...", "tool_trace": [...], ...}
414
+ ```
415
+
416
+ `tool_trace` 每轮记录 `{round, tool, args, ok, brief, result}`(审计可回放);
417
+ API 错误收敛为 `ok:false` 但已发生的 trace 保留。
418
+
419
+ ### 工具面(agent loop)
420
+
421
+ `spec.tools` 白名单启用后按 OpenAI function calling 循环:模型回 tool_calls →
422
+ 执行器执行 → tool 消息回喂 → 循环至终答;轮次耗尽强制终答(`forced_final: true`)。
423
+ 工具结果回喂前截断(4000 字符)防上下文爆炸;上下文预算逐轮校验,超限诚实终止。
424
+
425
+ **读写不对称(2026-09-19 裁定)**:**读放开、写严格**——`read_file` 只读、默认全路径
426
+ 开放(部署可用 `HIVE_READ_ROOTS` 收窄);执行器的**唯一写路径**是 `lingshu_cg op=write`
427
+ (recorder 令牌 + 校验闸门 DEFER/REJECT)。`read_file` 的 schema 内**没有任何写参数**,
428
+ 结构上不可能落盘改状态。
429
+
430
+ | 工具 | 说明 |
431
+ |---|---|
432
+ | `lingshu_cg` | 灵枢认知图(`op=route\|read\|write` 白名单,复用 MCP 面同一 dispatch)。权限硬编码 recorder(`can_admin=false`,spec 无法提权)——写入过校验闸门:DEFER 入审核队列 / REJECT 负记忆是设计行为,裁决权留给设计者。会话隔离 `session=hive_job_<id>`。write 的 `verification_basis` 前置校验合法枚举(防自由文本卡死审核队列)。 |
433
+ | `web_search` | 网页搜索。`zhipu` 后端走 `/web_search` 端点(`HIVE_WEB_SEARCH_BASE` 缺省智谱官方,与 `HIVE_API_BASE` 解耦——后者常为 LLM 中转网关、无搜索路由;`HIVE_WEB_SEARCH_KEY` 缺省回落 `HIVE_API_KEY`);`duckduckgo` 零 key 兜底。 |
434
+ | `read_file` | 读本地文件/目录(**只读**:不落盘、不改状态)。目录给清单(子目录优先,超 `READ_DIR_MAX=300` 截断);文本给行窗分页(`offset`/`limit`/`max_chars`,默认 2000 行 / 60000 字符,窗口满标 `truncated`,大文件行总数记 `null` 不假装精确);图像只给类型+尺寸、二进制只给类型+字节数(`content=null`,不猜内容);非 UTF-8 按替换处计数并在 `note` 标存疑。相对路径基准 = `workdir`(缺省进程 cwd);`HIVE_READ_ROOTS` 非空时越界即拒读(错误里带回 `roots`)。 |
435
+
436
+ 退出码 0 成功 / 2 规格错 / 3 API 错误。rust 侧以 result.json 的 error 字段定终态
437
+ (done / error),执行器崩溃由超时兜底。env:模型密钥是**普通配置**,随 serve env 默认
438
+ 继承给执行器——`HIVE_API_KEY`(模型网关密钥,缺即 fail 且错误里点名该配哪个键)、
439
+ `HIVE_API_BASE`(默认 `https://open.bigmodel.cn/api/paas/v4`);spec 开关
440
+ `use_subagent_llm` 真值时改读 `HIVE_SUBAGENT_API_KEY` 与 `HIVE_SUBAGENT_API_BASE`
441
+ (后者缺省回落 `HIVE_API_BASE`)。**身份令牌 / 锚密钥不在本 env 里**(见「密钥三角色」)。
442
+
443
+ ## 满上下文换人续跑(handoff)
444
+
445
+ **问题**:长任务跑着跑着把 200k 预算吃满——旧行为是整个任务判失败,已完成的几十轮
446
+ 工具调用随实例一起丢。**机制**:达预算时执行器**不失败**,而是写进展卡 + 交回:
447
+
448
+ ```json
449
+ {"ok": true, "content": "【交回续跑】…", "completed": false,
450
+ "need_continue": true, "tool_rounds": 12,
451
+ "handoff": {"reason": "context_budget", "est_tokens": 210000,
452
+ "budget_tokens": 200000, "rounds_done": 12,
453
+ "progress_file": "progress.jsonl", "auto_continue": false}}
454
+ ```
455
+
456
+ `ok:true` + `completed:false` 并存,是为了诚实区分「本次执行正常收口」与「任务已完成」——
457
+ 交回不是错误,实例退休而状态留在盘上(状态在库里,不在实例里)。
458
+
459
+ | 观测面 | 交接信号 |
460
+ |---|---|
461
+ | `hive poll`(rust) | `completed` / `need_continue` / `handoff_ready`(派生,一眼判)/ `handoff` / `tool_rounds`;旧 result 缺失字段透传 Null,不伪造 false |
462
+ | `hive_poll`(MCP) | result.json 原样透传 + 同口径 `handoff_ready` |
463
+ | 进展卡 | `jobs/<id>/progress.jsonl`:`start` / `tool` / `final` / `handoff` / `error` 逐条(含 `ts`、`round`、证据) |
464
+
465
+ 读进展卡(主代理侧,`hive/wm.py`):
466
+
467
+ ```cmd
468
+ python hive\wm.py progress --job hive\jobs\<id> :: 运行中/未快照
469
+ python hive\wm.py progress --wm <WM> --job-id <id> :: 已快照(两级查找:工作区 → task/<id> 分支)
470
+ ```
471
+
472
+ **已快照来源走两级查找**:`snapshot` 提交后 HEAD 归还 `main`,产物只存在于
473
+ `task/<job_id>` 分支——直读工作区必然落空,故先看工作区,落空再
474
+ `git show task/<ID>:jobs/<ID>/progress.jsonl`(返回体 `source`/`ref` 标明读取出处)。
475
+
476
+ **续跑编排(主代理裁决,执行器不自动续跑——`auto_continue` 恒 false)**:
477
+
478
+ 1. `poll` 见 `handoff_ready=true` → 读 `handoff` 卡与进展卡;
479
+ 2. 决定续跑 → 以「同 `system_prompt` + 进展摘要最小充分注入 + 剩余目标」`hive_spawn`
480
+ 新 job(同 `session` 读回记忆面);
481
+ 3. 不续跑 → 收尾:清理工作记忆临时进展态 + 结果蒸馏归档(`hive/wm.py snapshot`
482
+ 入库产物;结论写灵枢记忆)。
483
+
484
+ **边界(诚实)**:预算是**保守估算**(文本 4:1 字符折算,图像按 1200 tokens/张计入),
485
+ 估算偏高会提前交回——收窄任务或调大 `context_budget_tokens`。`context_strict=true`
486
+ 恢复旧 fail fast(超预算即 `error`)。进展卡是观测/交接通道:写失败只记 `log.txt`,
487
+ 不终杀任务。
488
+
489
+ ## 确定性执行(exec_cmd.py · 零 LLM)
490
+
491
+ **第 17 条「确定性执行 = 自定义 worker」的落地形态**:`hive/exec_cmd.py` 与 `exec.py`
492
+ 契约完全一致(`argv[1] = job 目录`,读 `spec.json` 写 `result.json`),但不调 LLM——
493
+ 把 spec 里的命令当任务跑。`HIVE_EXEC_PY` 指向它时,**一个 serve 同时承载两类任务**:
494
+ spec 带 `command` / `commands` → 跑命令;不带 → 转发给同目录 `exec.py`(LLM 委托,
495
+ 行为逐位不变)。不指向它时全链路零变动。
496
+
497
+ | 字段 | 说明 |
498
+ |---|---|
499
+ | `command` | 单条命令,**只收 argv 数组**(如 `["python","-m","pytest","-q"]`);字符串形态一律拒(不经 shell,规避转义 / GBK 陷阱) |
500
+ | `commands` | 多步串行:`[{"command":[...],"cwd":...,"label":...}, ...]` |
501
+ | `cwd` | 工作目录(缺省 spec.workdir → job 目录) |
502
+ | `env` | 附加环境变量(覆盖继承值);执行器强制补 `PYTHONUTF8=1` |
503
+ | `fail_fast` | 默认 true:任一步非 0 即停,不再跑后续步 |
504
+ | `timeout_step_s` | 单步超时(缺省 spec.timeout_s → 600);rust 侧另有硬超时兜底 |
505
+ | `expect_files` | 执行后断言存在(相对 cwd),缺失即 error |
506
+ | `expect_stdout_contains` | 各步 stdout 合并文本须含**全部**给定子串,缺一即 error |
507
+
508
+ 订阅约定:`model` 写 `"cmd"`、`user_prompt` 写任务标签——仅为过 rust 侧必填校验,
509
+ 本执行器不发任何网络请求。单步完整输出落 `step_<i>_stdout/stderr.txt`,`result.json`
510
+ 只留 head(4000 字符)防爆炸。退出码 0 成功 / 2 规格错 / 3 执行错。
511
+
512
+ ```json
513
+ {"model":"cmd","user_prompt":"回归套件","cwd":"<仓根>","env":{"PYTHONPATH":"<仓根>"},
514
+ "commands":[{"command":["python","-m","md_cg.test_cond_match"],"label":"cond_match"}],
515
+ "expect_stdout_contains":["0 failed"]}
516
+ ```
517
+
518
+ > 实测边界:包内测试脚本含相对导入(`from .mdcg import …`),直跑
519
+ > `python md_cg/test_cond_match.py` 会报 `attempted relative import with no known
520
+ > parent package`——须以 `-m md_cg.test_xxx` 形式运行,且 cwd / PYTHONPATH 指向仓根。
521
+
522
+ ## 任务编排(orch.py · 主代理只做编排)
523
+
524
+ **问题**:单代理跑大任务时,主实例把上下文全花在「自己干活」上——拆解、执行、收口混在
525
+ 一个预算窗口里,边做边忘。**机制**:`orch.py` 让主实例只当**编排者**——拆子任务派出去、
526
+ 看卡片、收口结论;子任务在蜂巢 worker 池并发跑,各自独立上下文。
527
+
528
+ 与既有件的分工(避免重复建设):
529
+
530
+ | 件 | 管什么 | 与本层关系 |
531
+ |---|---|---|
532
+ | `exec.py` | 单代理执行器(LLM 委托 + 工具循环) | **复用**:同一 agent loop、同一 spec / result 契约 |
533
+ | `exec_cmd.py` | 多态转发层 | `spec.orchestrate` 真值 → 转发本层(否则 `exec.py`) |
534
+ | `md_cg/units.py` | ccgc 复核通道(reflect / verify 专用 role 面) | 不复用——编排面是任意子任务 |
535
+ | `test/orchestrator_memory.py` | **记忆层**并发(卡片提交 / 收口 / 裁决) | 正交:它管「记忆节点并发写不打架」,本层管「任务怎么拆」 |
536
+
537
+ ### 编排三工具(不外传子代理)
538
+
539
+ | 工具 | 说明 |
540
+ |---|---|
541
+ | `spawn_subtask` | 派发子任务(**毫秒即返,不阻塞**)。子任务 prompt 必须自足——子代理看不到编排者上下文,也不能再派发。可选 `depends_on`(上游子任务 job_id 列表,透传 + 同两道闸:全 `done` 才被领取,不过闸即拒) |
542
+ | `poll_subtasks` | 看进度与卡片;不传 `job_ids` = 本编排者派发的全部 |
543
+ | `read_full` | 按需拉取**本编排者派发的**子任务的 `result.json` 全文(默认上限 20000 字符,超出给头 + 指针) |
544
+
545
+ **卡片回流(省编排者上下文)**:`poll_subtasks` 默认只给 `content_head` 200 字 +
546
+ `tool_trace` 尾部 6 条(`tool_calls` 全量仍可审计)+ `result_path` + `hint` 指路
547
+ `read_full`;`full=true` 或 `read_full(job_id)` 才拿全文。
548
+
549
+ ### 权限(收窄派生令牌,真源 = `md_cg/tokens.py` 的 `ORCH_*`)
550
+
551
+ | 能 / 不能 | 说明 |
552
+ |---|---|
553
+ | **能** 裁决子代理冲突 | `op=review` 在清单内(库层走 `require_admin`,故派生令牌 `can_admin=True`——能力所求,非越权) |
554
+ | **不能** 动地基 | 层白名单不含核心层 `anchor` / `self` |
555
+ | **不能** 删除 / 提权 | `forget` / `identity` / `protect` / `delegate` / `maintain` / `consolidate` 均不在清单 |
556
+ | **不能** 自验派生 | 派生令牌结构上 `delegable=False`(二次 `derive` 被库层拒) |
557
+ | 派生**只收窄** | `derive` 与父令牌 ops / layers 求交,不放大 |
558
+
559
+ **fail-closed(硬纪律,不降级)**:令牌缺失 / 无效 → 立即写 `result.json`
560
+ (`error_code=orch_token_unavailable`)并退出,**绝不**降级为默认 recorder 身份继续跑。
561
+ 理由(第 4 条):静默降级 = 权限意图落空且不可见——模型每轮裁决都失败,但 job 仍以
562
+ `done` 结束,使用者看到一次「成功」的编排,实际从未裁决过任何冲突。
563
+
564
+ ### 结构性护栏(不靠约定)
565
+
566
+ - **防无限递归**:子 spec 由**白名单键**构造,`orchestrate` 不可能出现;子代理 `tools`
567
+ 只能是 `lingshu_cg` / `web_search` / `read_file` 的子集(编排三工具不外传)——两条独立防线。
568
+ - **越权读拒绝**:`read_full` 只允许读本编排者派发的子任务。
569
+ - **上限诚实**:子任务数达 `max_subtasks`(默认 8)即报错,不静默丢弃、不静默排队。
570
+ - **换人续跑不重复派发(能力边界如实标注)**:子任务清单落编排者自己的 job 目录
571
+ (`_children.json`),**同机**接管者读回清单即不重复派发。
572
+ 边界:该文件**不在** `wm.py` 快照白名单内(白名单 = `spec.json` / `result.json` /
573
+ `log.txt` / `progress.jsonl` / `--artifacts`)——跨 worktree / 跨机经工作记忆接管时
574
+ 清单**不回传**,接管者只能从 `progress.jsonl` 的 `spawn_subtask` 条目得知**派发过几个**、
575
+ 拿不到完整清单,此时会重复派发。跨机续跑须显式 `wm.py snapshot --artifacts _children.json`
576
+ 纳入(落 `artifacts/_children.json`,非 job 根)。
577
+
578
+ ### 启用
579
+
580
+ ```cmd
581
+ :: ① 签发编排器令牌(父令牌须为 designer 且可派生)
582
+ python -m md_cg.tokens issue --role designer :: 若无 designer 令牌
583
+ python -m md_cg.tokens orch --token-file-in <designer.token> --out <orch.token>
584
+
585
+ :: ② 注入 serve 环境(serve 级,改后须重启 serve)
586
+ set HIVE_ORCH_TOKEN_FILE=<orch.token>
587
+ set HIVE_EXEC_PY=<仓>\hive\exec_cmd.py :: 多态转发:按 spec.orchestrate 分流
588
+ ```
589
+
590
+ ```json
591
+ {"model":"deepseek-flash","user_prompt":"查清这仓测试失败原因并给修复方案",
592
+ "orchestrate":{"max_subtasks":4}}
593
+ ```
594
+
595
+ 子任务跑在同一个 serve 的 worker 池里——编排者只负责派发与收口,不参与执行。
596
+
597
+ **身份令牌的到达面(重要)**:上面注入的令牌是 **serve 级 env**,但 serve 派发任务时
598
+ **默认把身份两键从子进程 env 里剥掉**——普通 LLM / 确定性任务的执行器拿不到令牌(它接触
599
+ 不可信 LLM 内容最多,持令牌即可自签合法结果锚 / 以编排者身份落库)。唯一例外是
600
+ `spec.orchestrate` 真值任务:执行器 = `orch.py` 编排器,靠令牌派生收窄身份,故 serve 对
601
+ 这类任务**条件重注** `HIVE_ORCH_TOKEN` / `HIVE_ORCH_TOKEN_FILE`。推论:serve env 里没有身份
602
+ 令牌时,编排任务会在 `orch.py` 的 `load_principal` 处 **fail-closed**(写
603
+ `error_code=orch_token_unavailable` 并退出,不降级为默认身份);而普通 LLM / 确定性任务
604
+ 不受影响。锚密钥链同源两键(见「环境变量」),两键皆缺 = 锚判据不启用(`--show-config`
605
+ 会给提示)。
606
+
607
+ **子任务换模型凭据(可选)**:子代理要与主配置不同的模型密钥/base 时,往 serve env 加
608
+ `HIVE_SUBAGENT_API_KEY`(+ 可选的 `HIVE_SUBAGENT_API_BASE`,缺省回落 `HIVE_API_BASE`)。
609
+ `orch.py` 派发子任务时只往子 spec 写布尔开关 `use_subagent_llm`——**密钥值与地址不进 spec**,
610
+ 只从 serve env 读(防凭据随 spec 外发)。不设这两键 = 子任务继承主配置,行为与从前一致。
611
+
612
+ ## 环境变量
613
+
614
+ | 变量 | 默认 | 说明 |
615
+ |---|---|---|
616
+ | `HIVE_API_KEY` | 无 | **模型(网关)密钥**——普通配置,serve 启动时并入 env 并**默认继承给执行器**(LLM 任务靠它调 `chat/completions`)。与 `HIVE_API_BASE` 配对(见「spec 字段」的模型名配对)。缺失时:经 `serve_start.py` 拉起 → 启动前置校验拒绝并点名该配哪个键(除非声明 `HIVE_LLM_DISABLED`);裸 `hive.exe serve` → 任务级报未设置。**不再作锚密钥兜底**(锚链只认下面两个身份键) |
617
+ | `HIVE_API_BASE` | GLM 开放平台 | OpenAI 兼容 base url(LLM 通道);与 `HIVE_API_KEY` 同属普通配置,同样继承给执行器。未设 = 回落 `https://open.bigmodel.cn/api/paas/v4`;子代理面可用 `HIVE_SUBAGENT_API_BASE` 覆盖 |
618
+ | `HIVE_JOBS_DIR` | `<exe>/../../jobs` | 任务根目录(**同一 jobs 目录至多一个 serve**:CLI 与 MCP 均有单实例守卫,判活为三层——心跳新鲜 + pid 存活 + pid 身份;守卫认为在跑时会拦启动,确认无 serve 在跑(如心跳残留)请加 `--force`) |
619
+ | `HIVE_EXEC_PY` | `<exe>/../../exec.py` | 执行器路径(serve 级,**启动时固化并写入心跳**)。指向 `hive/exec_cmd.py` 可让同一 serve 兼跑确定性任务与编排任务(多态转发);**未设时回退默认 `exec.py`(llm_only)——确定性执行不可用**:serve 启动时 stderr 告警、doctor 的 `exec_mode` 显示 `llm_only` |
620
+ | `HIVE_ORCH_TOKEN` | 无 | **身份令牌**:编排器派生令牌明文(`python -m md_cg.tokens orch` 签发);与下行二选一,**缺失时编排任务 fail-closed**(`orch.py` 不降级为默认身份)。**不进执行器 env**——serve 派发时默认剥离,唯一例外是 `spec.orchestrate` 真值任务条件重注(另兼任锚密钥链首环,见下行) |
621
+ | `HIVE_ORCH_TOKEN_FILE` | 无 | 同上,令牌文件路径(避免明文进环境变量 / 命令行历史)。**同一个键兼任结果完整性锚密钥链一环**:锚密钥解析(Rust `hive/src/keyres.rs`,与 MCP 提交面 `hive/hive_mcp/mcp_server.py::_result_anchor_key` 声明同链)按 `HIVE_ORCH_TOKEN` → `HIVE_ORCH_TOKEN_FILE` 取首个非空;**两键皆缺 = 锚判据整体不启用**(行为=旧产物判据,安全方向降级;`--show-config` / `--status` 会给出提示) |
622
+ | `HIVE_SUBAGENT_API_KEY` | 无 | **可选**子代理覆盖:非空时 `orch.py` 派发的子任务带 `use_subagent_llm=true`,其模型密钥取本键;不设或为空 = 子任务继承 `HIVE_API_KEY`(安全回落,不炸也不缺)。密钥值只从 serve env 读,**不进 spec** |
623
+ | `HIVE_SUBAGENT_API_BASE` | 回落 `HIVE_API_BASE` | **可选**子代理 base(仅 `use_subagent_llm` 真值时生效)。子代理密钥缺失时本键一并回落主配置——避免「子代理 base + 主密钥」的半套配置跨网关错配 |
624
+ | `HIVE_LLM_DISABLED` | 无 | 显式声明**本部署不跑 LLM**(真值 = 去空白后非空且小写不在 `{"0","false","no"}`)——只跑确定性任务(`exec_cmd.py`)的部署用它放行 `serve_start.py` 的「无可用模型密钥」前置校验;声明后启动结果里回带提示 |
625
+ | `HIVE_WORKERS` | 4 | worker 池大小 |
626
+ | `HIVE_PYTHON` | 探测:`python3` 优先、无则 `python` | 执行器解释器(**显式设置压倒探测**)。缺省不是写死名字而是**试跑探测**首个可运行者——名字在 PATH 上不等于能跑(Windows 的 `python3.exe` 常是 Store 别名桩,实测退出码 49);两候选均不可跑时取首候选名,让拉起失败可见。本键是解释器**唯一决策点**,`scheduler.rs` 的指纹计算亦经此(防第二套决策) |
627
+ | `MDCG_ROOT` | 无 | lingshu_cg 认知图根(serve 级;任务级可用 `spec.mdcg_root` 兜底) |
628
+ | `MDCG_HOME` | 执行器父目录 | md_cg 包所在仓根(同仓分发零配置) |
629
+ | `HIVE_WEB_SEARCH` | `zhipu` | 搜索后端:`zhipu` / `duckduckgo` |
630
+ | `HIVE_WEB_SEARCH_BASE` | 智谱官方 `/api/paas/v4` | zhipu 搜索端点 base(与 `HIVE_API_BASE` 解耦) |
631
+ | `HIVE_WEB_SEARCH_KEY` | 回落 `HIVE_API_KEY` | 搜索密钥(key 与 LLM base 不配对时独立设置)。**回落语义不变**:搜索面与模型面共用一个键源,与子代理覆盖无关 |
632
+ | `HIVE_READ_ROOTS` | 无(= 读放开) | `read_file` 可读根白名单(`os.pathsep` 切分,支持多根,逐项 `expanduser+realpath`)。**未设置或全空 = 读放开**(缺省全路径开放);设为至少一个真实目录即收窄,越界即拒读;只影响 `read_file`,不影响 `lingshu_cg`(认知图用自己的 root) |
633
+
634
+ ### 密钥三角色(谁进执行器、谁是锚)
635
+
636
+ | 角色 | 键 | 到达执行器 env? | 说明 |
637
+ |---|---|---|---|
638
+ | 模型(网关)密钥 | `HIVE_API_KEY` / `HIVE_API_BASE` | **是**(默认继承) | 普通配置:执行器调模型所必需,故随 serve env 继承 |
639
+ | 子代理覆盖 | `HIVE_SUBAGENT_API_KEY` / `HIVE_SUBAGENT_API_BASE` | 是(同上) | **可选**:只切换子任务用哪套模型凭据;spec 仅承载布尔开关 |
640
+ | 身份令牌 / 锚密钥 | `HIVE_ORCH_TOKEN` / `HIVE_ORCH_TOKEN_FILE` | **否** | 身份面凭据:serve 派发时默认剥离,仅 `spec.orchestrate` 真值任务条件重注。执行器是接触不可信 LLM 内容最多的进程,env 继承会把身份令牌扩散给它及其任意孙进程(拿到即可对任意任务自签合法结果锚、或以编排者身份落库) |
641
+
642
+ 一条命令看全(只读,不改运行态):
643
+
644
+ ```cmd
645
+ python serve_start.py --show-config :: 逐键:来源(直值 / env:名字 / file:路径)· 掩码值 · 角色 · 是否到达执行器 + problems + 结论
646
+ python serve_start.py --status :: 心跳与任务统计 + 同一份配置摘要
647
+ ```
648
+
649
+ 掩码是**单点函数**:只给「前缀少量 + 长度 + sha256 前 8 位指纹」,**绝不输出完整值**
650
+ (`--show-config` 的口径就是「能核对面、看不到秘密」)。它读 `config.local.json` 与进程 env
651
+ 的**合并面**(config 胜出 env,与 serve 实际启动 env 同口径)。
652
+
653
+ **启动前置校验**(`serve_start.start`,语义与 `--restart` / `--rebuild` 共用):合并环境
654
+ 无可用模型密钥(`HIVE_API_KEY` 空/缺)**且**未声明 `HIVE_LLM_DISABLED` 真值 → 返回
655
+ `ok:false` 的明确错误并点名该配哪个键(或声明 `HIVE_LLM_DISABLED`)——不静默拉起一个所有
656
+ LLM 任务都要报错的 serve。声明 `HIVE_LLM_DISABLED` 后放行,结果里回带提示。
657
+
658
+ ## 验证
659
+
660
+ - `cargo test`:22 项全绿(lib 17 + main 5;lib 含 3 个真子进程端到端:done / 超时强杀 /
661
+ kill 通道,FAKE_EXEC 假执行器注入,不依赖网络与密钥;main 含 4 项 `result_summary`
662
+ 交接字段单测与 1 项存活判据身份层单测——无关进程不得被判成 serve)。
663
+ - `python hive/test_serve_entry.py`:38 项全绿(serve 入口口径守卫——存活窗口单一常量源、
664
+ 单实例守卫三层判据、执行器资格由 serve 自报心跳承载、推荐入口唯一、假存活端到端复现
665
+ 四种心跳形态)。**干净克隆可直接跑**(配置载体 local 优先、缺失退回入库模板
666
+ `config.local.example.json`)。
667
+ - `python hive/hive_mcp/smoke_test.py`:13 项全过(MCP 协议面 / spawn 结构校验 /
668
+ serve 自动拉起端到端 / kill 通道,全程统一 env 注入假执行器)。
669
+ - `python hive/test_exec_tools.py`:62 项全绿(工具注册表 / lingshu_cg 真库层 /
670
+ web_search 假 urlopen / **read_file 只读面**(读写不对称 / 白名单收窄 / 行窗分页 /
671
+ 非文本诚实面)/ agent loop / 预算交回 / 图像护栏 / 提示词真源重建)。
672
+ - `python hive/test_exec_cmd.py`:9 例全绿(确定性执行器——argv 校验 / 多步 fail_fast /
673
+ cwd 缺失 / expect_files / expect_stdout_contains / 单步超时强杀 / LLM 委托转发)。
674
+ - `python hive/test_wm_progress.py`:44 项全绿(工作记忆进展面——跨面契约 / 快照白名单 /
675
+ job 与已快照两源读取 / 分支态两级查找 / CLI 单行 JSON / 坏行诚实降级)。
676
+ - `python hive/test_orch.py`:74 项全绿(编排器——权限收窄面 / 三工具护栏与结构性防递归 /
677
+ 卡片截断与按需拉取 / `exec.py` 两个扩展口默认零变更 / `exec_cmd.py` 转发档 /
678
+ `main()` 装配与令牌缺失 fail-closed)。
679
+ - `python hive/test_llm_key_resolution.py`:22 项全绿(模型密钥解析守卫——无密钥时错误可诊断且
680
+ 零明文 / 只有主键时用主键 / `use_subagent_llm` 真值且有子代理键时用子代理配置 / 开关真值但
681
+ 子代理键缺时安全回落主键 / 子代理 base 覆盖与回落 / 工具路同源 / `orch._spawn` 只把布尔开关
682
+ 写进子 spec(无键值、无 env 名、无地址)/ 诊断与产物文案零明文)。
683
+ - `python hive/test_serve_show_config.py`:全绿(运维展示面守卫——掩码零明文 / 角色与
684
+ 执行器可达性判定 / 三来源形态如实 / 缺模型密钥时 `start` 返回 `ok:false` 且可诊断 /
685
+ 声明 `HIVE_LLM_DISABLED` 后放行并回带提示 / 既有 stop·restart·单实例守卫语义未动)。
686
+ - `python scripts/run_tests.py hive`:蜂巢组整体回归入口。
687
+ - 端到端四路径实测(2026-09-16,真 serve):确定性成功 → `done`;命令 exit≠0 → `error`
688
+ (error=失败步标签);断言未命中 → `error`(error=`输出未命中预期子串:…`);
689
+ LLM 委托 → `done`(`deepseek-flash` / effort=high / 200k / 600s,content=`HIVE_UNIFIED_OK`)。
690
+ - `cargo build --release`:0 warning。
691
+ - 数据文件(status.json / result.json / _serve.json)经 tmp+fsync+rename
692
+ 原子替换落盘:并发读者不会读到截断空窗口(避免「空输入」parse 失败)。
693
+
694
+ ## 设计边界(诚实)
695
+
696
+ - TLS 不进 rust:纯 std 无第三方库不可行,HTTPS 全在执行器(D-005 的结构性取舍,
697
+ 不是遗留缺陷)。
698
+ - kill 与超时的检测粒度 = 1s 轮询,非信号级即时。
699
+ - doctor 判活 = 三层(心跳新鲜 + pid 存活 + **pid 身份**:Windows tasklist 映像名列 /
700
+ unix `/proc/<pid>/cmdline`)。身份层在零依赖边界下可能取不到映像名——此时**保守判假**
701
+ (宁可放行一次启动,也不误报「已有 serve 在跑」把运维引向不存在的进程)。
702
+ - 单实例守卫的「在跑」判定**不构成授权**:`--force` 是显式豁免出口,用于确认无 serve
703
+ 在跑(如心跳残留)的情形。
704
+ - 归属是归因不参与调度:任务无身份隔离,共享 jobs 目录的调用方互见(与灵枢记忆
705
+ 「归属归因」同构的多任务版)。