@team-agent/installer 0.5.127 → 0.6.0

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 (421) hide show
  1. package/README.md +15 -4
  2. package/README.zh.md +1 -1
  3. package/package.json +4 -8
  4. package/skills/team-agent/SKILL.md +41 -26
  5. package/skills/team-agent/command-coverage.json +170 -184
  6. package/skills/team-agent/docs/reference/team-agent-operator.md +66 -32
  7. package/skills/team-agent/references/recovery-runbook.md +1 -1
  8. package/skills/team-agent/references/team-agent-operator.md +66 -32
  9. package/templates/team_state.md +1 -1
  10. package/Cargo.lock +0 -1063
  11. package/Cargo.toml +0 -36
  12. package/crates/team-agent/Cargo.toml +0 -69
  13. package/crates/team-agent/src/app_server_test_support.rs +0 -258
  14. package/crates/team-agent/src/cli/adapters.rs +0 -1298
  15. package/crates/team-agent/src/cli/arguments.rs +0 -401
  16. package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
  17. package/crates/team-agent/src/cli/diagnose.rs +0 -1675
  18. package/crates/team-agent/src/cli/emit.rs +0 -2898
  19. package/crates/team-agent/src/cli/grok_slot.rs +0 -384
  20. package/crates/team-agent/src/cli/helpers.rs +0 -91
  21. package/crates/team-agent/src/cli/intent/runtime.rs +0 -1189
  22. package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -821
  23. package/crates/team-agent/src/cli/intent/tests.rs +0 -691
  24. package/crates/team-agent/src/cli/intent.rs +0 -664
  25. package/crates/team-agent/src/cli/leader.rs +0 -300
  26. package/crates/team-agent/src/cli/leader_prompt.rs +0 -261
  27. package/crates/team-agent/src/cli/leaders.rs +0 -418
  28. package/crates/team-agent/src/cli/mod.rs +0 -6528
  29. package/crates/team-agent/src/cli/models.rs +0 -449
  30. package/crates/team-agent/src/cli/named_address.rs +0 -1651
  31. package/crates/team-agent/src/cli/profile.rs +0 -342
  32. package/crates/team-agent/src/cli/route.rs +0 -212
  33. package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
  34. package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
  35. package/crates/team-agent/src/cli/send/persist.rs +0 -192
  36. package/crates/team-agent/src/cli/send/presentation.rs +0 -370
  37. package/crates/team-agent/src/cli/send/resolve.rs +0 -573
  38. package/crates/team-agent/src/cli/send.rs +0 -201
  39. package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
  40. package/crates/team-agent/src/cli/spec.rs +0 -159
  41. package/crates/team-agent/src/cli/status.rs +0 -280
  42. package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
  43. package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
  44. package/crates/team-agent/src/cli/status_port/brief.rs +0 -2043
  45. package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
  46. package/crates/team-agent/src/cli/status_port/format.rs +0 -146
  47. package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
  48. package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
  49. package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
  50. package/crates/team-agent/src/cli/status_port/store.rs +0 -416
  51. package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
  52. package/crates/team-agent/src/cli/status_port.rs +0 -92
  53. package/crates/team-agent/src/cli/tests/base.rs +0 -885
  54. package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
  55. package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
  56. package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -372
  57. package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
  58. package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
  59. package/crates/team-agent/src/cli/tests/mod.rs +0 -137
  60. package/crates/team-agent/src/cli/tests/named_address.rs +0 -760
  61. package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
  62. package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -481
  63. package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
  64. package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
  65. package/crates/team-agent/src/cli/tests/status_send.rs +0 -1091
  66. package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
  67. package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
  68. package/crates/team-agent/src/cli/triage.rs +0 -234
  69. package/crates/team-agent/src/cli/types.rs +0 -591
  70. package/crates/team-agent/src/codex_app_server.rs +0 -546
  71. package/crates/team-agent/src/communication_mode/mod.rs +0 -56
  72. package/crates/team-agent/src/compiler/tests.rs +0 -842
  73. package/crates/team-agent/src/compiler.rs +0 -691
  74. package/crates/team-agent/src/conpty/backend.rs +0 -829
  75. package/crates/team-agent/src/conpty/mod.rs +0 -33
  76. package/crates/team-agent/src/contract_runtime/backend.rs +0 -1610
  77. package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
  78. package/crates/team-agent/src/contract_runtime/config.rs +0 -354
  79. package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -56
  80. package/crates/team-agent/src/contract_runtime/discovery.rs +0 -438
  81. package/crates/team-agent/src/contract_runtime/fork.rs +0 -368
  82. package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
  83. package/crates/team-agent/src/contract_runtime/framework.rs +0 -350
  84. package/crates/team-agent/src/contract_runtime/mcp.rs +0 -399
  85. package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
  86. package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
  87. package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
  88. package/crates/team-agent/src/contract_runtime/registry.rs +0 -589
  89. package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
  90. package/crates/team-agent/src/coordinator/backoff.rs +0 -741
  91. package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
  92. package/crates/team-agent/src/coordinator/health.rs +0 -1185
  93. package/crates/team-agent/src/coordinator/mod.rs +0 -119
  94. package/crates/team-agent/src/coordinator/orphan.rs +0 -110
  95. package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
  96. package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
  97. package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
  98. package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
  99. package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
  100. package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
  101. package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
  102. package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
  103. package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
  104. package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
  105. package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
  106. package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -338
  107. package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
  108. package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
  109. package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
  110. package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -461
  111. package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
  112. package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
  113. package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
  114. package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
  115. package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
  116. package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
  117. package/crates/team-agent/src/coordinator/tick.rs +0 -3112
  118. package/crates/team-agent/src/coordinator/types.rs +0 -540
  119. package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
  120. package/crates/team-agent/src/db/message_store.rs +0 -1585
  121. package/crates/team-agent/src/db/migration.rs +0 -984
  122. package/crates/team-agent/src/db/mod.rs +0 -26
  123. package/crates/team-agent/src/db/schema.rs +0 -663
  124. package/crates/team-agent/src/diagnose/comms.rs +0 -242
  125. package/crates/team-agent/src/diagnose/mod.rs +0 -44
  126. package/crates/team-agent/src/diagnose/orphans.rs +0 -889
  127. package/crates/team-agent/src/event_log.rs +0 -502
  128. package/crates/team-agent/src/fake_worker.rs +0 -303
  129. package/crates/team-agent/src/kill_audit.rs +0 -106
  130. package/crates/team-agent/src/layout/manager.rs +0 -248
  131. package/crates/team-agent/src/layout/mod.rs +0 -36
  132. package/crates/team-agent/src/layout/overlay.rs +0 -134
  133. package/crates/team-agent/src/layout/placement.rs +0 -52
  134. package/crates/team-agent/src/layout/recovery.rs +0 -106
  135. package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
  136. package/crates/team-agent/src/layout/sessions.rs +0 -294
  137. package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
  138. package/crates/team-agent/src/layout/worker_env.rs +0 -721
  139. package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
  140. package/crates/team-agent/src/leader/helpers.rs +0 -178
  141. package/crates/team-agent/src/leader/incident.rs +0 -6
  142. package/crates/team-agent/src/leader/lease.rs +0 -3356
  143. package/crates/team-agent/src/leader/mod.rs +0 -104
  144. package/crates/team-agent/src/leader/owner_bind.rs +0 -400
  145. package/crates/team-agent/src/leader/prompt.rs +0 -905
  146. package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
  147. package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
  148. package/crates/team-agent/src/leader/rediscover.rs +0 -1192
  149. package/crates/team-agent/src/leader/registry.rs +0 -883
  150. package/crates/team-agent/src/leader/start.rs +0 -4500
  151. package/crates/team-agent/src/leader/takeover.rs +0 -65
  152. package/crates/team-agent/src/leader/tests/basics.rs +0 -337
  153. package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
  154. package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
  155. package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
  156. package/crates/team-agent/src/leader/tests/identity.rs +0 -465
  157. package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
  158. package/crates/team-agent/src/leader/tests/idle.rs +0 -113
  159. package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
  160. package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
  161. package/crates/team-agent/src/leader/tests/mod.rs +0 -106
  162. package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -267
  163. package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
  164. package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
  165. package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
  166. package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
  167. package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
  168. package/crates/team-agent/src/leader/types.rs +0 -534
  169. package/crates/team-agent/src/lib.rs +0 -145
  170. package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
  171. package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -848
  172. package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -393
  173. package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
  174. package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -178
  175. package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -82
  176. package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -63
  177. package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
  178. package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
  179. package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
  180. package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -152
  181. package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
  182. package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -629
  183. package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -226
  184. package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
  185. package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5176
  186. package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
  187. package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
  188. package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
  189. package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -450
  190. package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
  191. package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
  192. package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
  193. package/crates/team-agent/src/lifecycle/launch.rs +0 -534
  194. package/crates/team-agent/src/lifecycle/lock.rs +0 -350
  195. package/crates/team-agent/src/lifecycle/mod.rs +0 -79
  196. package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
  197. package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -757
  198. package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
  199. package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2198
  200. package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2052
  201. package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
  202. package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
  203. package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
  204. package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
  205. package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
  206. package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
  207. package/crates/team-agent/src/lifecycle/restart.rs +0 -223
  208. package/crates/team-agent/src/lifecycle/role_config.rs +0 -1205
  209. package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
  210. package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
  211. package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
  212. package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
  213. package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
  214. package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -135
  215. package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1415
  216. package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
  217. package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -396
  218. package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -418
  219. package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2039
  220. package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1298
  221. package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
  222. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
  223. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
  224. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -71
  225. package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
  226. package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
  227. package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -472
  228. package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
  229. package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
  230. package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
  231. package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3981
  232. package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
  233. package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
  234. package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
  235. package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
  236. package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
  237. package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
  238. package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -152
  239. package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -182
  240. package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -374
  241. package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -546
  242. package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -31
  243. package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -528
  244. package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -134
  245. package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -333
  246. package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
  247. package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
  248. package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
  249. package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
  250. package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
  251. package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
  252. package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
  253. package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
  254. package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
  255. package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
  256. package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
  257. package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
  258. package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -90
  259. package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
  260. package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
  261. package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
  262. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
  263. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
  264. package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
  265. package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
  266. package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -996
  267. package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -827
  268. package/crates/team-agent/src/lifecycle/tests.rs +0 -102
  269. package/crates/team-agent/src/lifecycle/types.rs +0 -861
  270. package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -370
  271. package/crates/team-agent/src/main.rs +0 -52
  272. package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
  273. package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
  274. package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
  275. package/crates/team-agent/src/mcp_server/mod.rs +0 -119
  276. package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
  277. package/crates/team-agent/src/mcp_server/readiness.rs +0 -546
  278. package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -369
  279. package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
  280. package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
  281. package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -168
  282. package/crates/team-agent/src/mcp_server/tests/send.rs +0 -388
  283. package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -343
  284. package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
  285. package/crates/team-agent/src/mcp_server/tests.rs +0 -43
  286. package/crates/team-agent/src/mcp_server/tools.rs +0 -1015
  287. package/crates/team-agent/src/mcp_server/types.rs +0 -396
  288. package/crates/team-agent/src/mcp_server/wire.rs +0 -867
  289. package/crates/team-agent/src/messaging/activity.rs +0 -461
  290. package/crates/team-agent/src/messaging/address.rs +0 -87
  291. package/crates/team-agent/src/messaging/delivery.rs +0 -3785
  292. package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
  293. package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
  294. package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
  295. package/crates/team-agent/src/messaging/helpers.rs +0 -354
  296. package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
  297. package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
  298. package/crates/team-agent/src/messaging/mod.rs +0 -166
  299. package/crates/team-agent/src/messaging/persist.rs +0 -377
  300. package/crates/team-agent/src/messaging/presentation.rs +0 -417
  301. package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
  302. package/crates/team-agent/src/messaging/results.rs +0 -1415
  303. package/crates/team-agent/src/messaging/scheduler.rs +0 -217
  304. package/crates/team-agent/src/messaging/selftest.rs +0 -315
  305. package/crates/team-agent/src/messaging/send.rs +0 -981
  306. package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
  307. package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -551
  308. package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
  309. package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
  310. package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
  311. package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
  312. package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
  313. package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3655
  314. package/crates/team-agent/src/messaging/tests/spine.rs +0 -837
  315. package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
  316. package/crates/team-agent/src/messaging/trust.rs +0 -215
  317. package/crates/team-agent/src/messaging/types.rs +0 -471
  318. package/crates/team-agent/src/messaging/wait.rs +0 -366
  319. package/crates/team-agent/src/messaging/watchers.rs +0 -916
  320. package/crates/team-agent/src/model/enums.rs +0 -356
  321. package/crates/team-agent/src/model/errors.rs +0 -18
  322. package/crates/team-agent/src/model/ids.rs +0 -165
  323. package/crates/team-agent/src/model/mod.rs +0 -29
  324. package/crates/team-agent/src/model/name_similarity.rs +0 -252
  325. package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
  326. package/crates/team-agent/src/model/paths.rs +0 -257
  327. package/crates/team-agent/src/model/routing.rs +0 -387
  328. package/crates/team-agent/src/model/spec.rs +0 -1184
  329. package/crates/team-agent/src/model/task_graph.rs +0 -321
  330. package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
  331. package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
  332. package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
  333. package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
  334. package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
  335. package/crates/team-agent/src/model/yaml/tests.rs +0 -188
  336. package/crates/team-agent/src/model/yaml.rs +0 -802
  337. package/crates/team-agent/src/os_probe.rs +0 -280
  338. package/crates/team-agent/src/packaging/install.rs +0 -219
  339. package/crates/team-agent/src/packaging/migrate.rs +0 -38
  340. package/crates/team-agent/src/packaging/mod.rs +0 -91
  341. package/crates/team-agent/src/packaging/repair.rs +0 -33
  342. package/crates/team-agent/src/packaging/tests.rs +0 -822
  343. package/crates/team-agent/src/packaging/types.rs +0 -417
  344. package/crates/team-agent/src/platform/argv.rs +0 -331
  345. package/crates/team-agent/src/platform/errors.rs +0 -104
  346. package/crates/team-agent/src/platform/file_lock.rs +0 -279
  347. package/crates/team-agent/src/platform/mod.rs +0 -5
  348. package/crates/team-agent/src/platform/process.rs +0 -545
  349. package/crates/team-agent/src/provider/adapter.rs +0 -898
  350. package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
  351. package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
  352. package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
  353. package/crates/team-agent/src/provider/adapters/mod.rs +0 -28
  354. package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
  355. package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
  356. package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
  357. package/crates/team-agent/src/provider/argv_route.rs +0 -405
  358. package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
  359. package/crates/team-agent/src/provider/classify.rs +0 -773
  360. package/crates/team-agent/src/provider/command_helpers.rs +0 -45
  361. package/crates/team-agent/src/provider/faults.rs +0 -165
  362. package/crates/team-agent/src/provider/helpers.rs +0 -52
  363. package/crates/team-agent/src/provider/mod.rs +0 -78
  364. package/crates/team-agent/src/provider/model_catalog.rs +0 -722
  365. package/crates/team-agent/src/provider/session/capture.rs +0 -2631
  366. package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -168
  367. package/crates/team-agent/src/provider/session/context_fork.rs +0 -264
  368. package/crates/team-agent/src/provider/session/mod.rs +0 -36
  369. package/crates/team-agent/src/provider/session/resume.rs +0 -269
  370. package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
  371. package/crates/team-agent/src/provider/session_scan/common.rs +0 -618
  372. package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
  373. package/crates/team-agent/src/provider/session_scan/pi.rs +0 -152
  374. package/crates/team-agent/src/provider/session_scan.rs +0 -61
  375. package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
  376. package/crates/team-agent/src/provider/submit_now.rs +0 -71
  377. package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
  378. package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
  379. package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
  380. package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
  381. package/crates/team-agent/src/provider/tests/adapter.rs +0 -354
  382. package/crates/team-agent/src/provider/tests/classify.rs +0 -201
  383. package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -26
  384. package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
  385. package/crates/team-agent/src/provider/tests/faults.rs +0 -200
  386. package/crates/team-agent/src/provider/tests/idle.rs +0 -140
  387. package/crates/team-agent/src/provider/tests/wire.rs +0 -213
  388. package/crates/team-agent/src/provider/tests.rs +0 -32
  389. package/crates/team-agent/src/provider/types.rs +0 -529
  390. package/crates/team-agent/src/provider/wire.rs +0 -406
  391. package/crates/team-agent/src/redaction.rs +0 -259
  392. package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
  393. package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
  394. package/crates/team-agent/src/state/identity.rs +0 -914
  395. package/crates/team-agent/src/state/identity_keys.rs +0 -132
  396. package/crates/team-agent/src/state/mod.rs +0 -74
  397. package/crates/team-agent/src/state/owner_gate.rs +0 -482
  398. package/crates/team-agent/src/state/ownership.rs +0 -563
  399. package/crates/team-agent/src/state/paths.rs +0 -395
  400. package/crates/team-agent/src/state/persist.rs +0 -3811
  401. package/crates/team-agent/src/state/projection.rs +0 -1508
  402. package/crates/team-agent/src/state/repository/intent.rs +0 -14
  403. package/crates/team-agent/src/state/repository/tests.rs +0 -184
  404. package/crates/team-agent/src/state/repository.rs +0 -866
  405. package/crates/team-agent/src/state/selector.rs +0 -160
  406. package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
  407. package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
  408. package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
  409. package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
  410. package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
  411. package/crates/team-agent/src/tmux_backend/tests.rs +0 -4254
  412. package/crates/team-agent/src/tmux_backend.rs +0 -4527
  413. package/crates/team-agent/src/topology.rs +0 -537
  414. package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
  415. package/crates/team-agent/src/transport/native_input.rs +0 -491
  416. package/crates/team-agent/src/transport/test_support.rs +0 -743
  417. package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
  418. package/crates/team-agent/src/transport/tests/mod.rs +0 -194
  419. package/crates/team-agent/src/transport/tests/wire.rs +0 -574
  420. package/crates/team-agent/src/transport.rs +0 -1655
  421. package/crates/team-agent/src/transport_factory.rs +0 -819
@@ -1,2198 +0,0 @@
1
- //! ---
2
- //! purpose: 单席位的起、停与重置,全部在 workspace 级生命周期锁下串行
3
- //! contract:
4
- //! provides:
5
- //! - name: start_agent
6
- //! what: 起或复活一席,按四象限定出 resume 或 fresh
7
- //! - name: stop_agent
8
- //! what: 停一席,按 pane、同角色残留 pane、窗口三级收敛并取排空证据
9
- //! - name: reset_agent
10
- //! what: 必须显式丢弃会话,停席后换血再起
11
- //! - name: start_agent_at_paths
12
- //! what: 起席的实体实现,owner 门、暂停判定、启动模式决策与落 state
13
- //! - name: drain_old_pane_and_pid
14
- //! what: 有界轮询等旧 pane 与旧进程消失,产出可核的证据载荷
15
- //! depends:
16
- //! - crate::lifecycle::lock
17
- //! - crate::lifecycle::restart::selection
18
- //! - crate::lifecycle::restart::remove
19
- //! - crate::lifecycle::restart::team_state
20
- //! - crate::lifecycle::launch
21
- //! - crate::state::projection
22
- //! - crate::state::persist
23
- //! - crate::platform::process
24
- //! - crate::lifecycle::profile_launch
25
- //! - crate::lifecycle::worker_command_context
26
- //! - crate::event_log::EventLog
27
- //! boundary:
28
- //! - 每个对外入口先取 workspace 级生命周期锁,本文件不做无锁写
29
- //! - owner 门先于未知席位报错,权限判定不被存在性判定绕过
30
- //! - reset 未显式丢弃会话时直接拒绝,不擅自换血
31
- //! - 排空是有界等待,等不到只如实记录,不无限阻塞
32
- //! maturity: wired
33
- //! ---
34
- use super::common::*;
35
- use super::selection::decide_start_mode;
36
- use super::team_state::write_team_state;
37
- use super::*;
38
- use crate::lifecycle::lock::{acquire_agent_lifecycle_lock, LifecycleLockRequest};
39
-
40
- /// CLI start is orthogonal to stop: refuse any live target before editing its role.
41
- /// Transport uncertainty is a refusal, not permission to spawn a duplicate.
42
- pub(crate) fn ensure_agent_not_running(
43
- state: &serde_json::Value,
44
- agent_id: &AgentId,
45
- transport: &dyn crate::transport::Transport,
46
- ) -> Result<(), LifecycleError> {
47
- let agent = state.get("agents").and_then(|agents| agents.get(agent_id.as_str()))
48
- .ok_or_else(|| LifecycleError::RequirementUnmet(format!("agent {agent_id} not found")))?;
49
- let session = state_session_name(state);
50
- let window = agent_window(agent, agent_id);
51
- let pane = agent.get("pane_id").and_then(serde_json::Value::as_str);
52
- let targets = transport.list_targets()
53
- .map_err(|error| LifecycleError::Transport(error.to_string()))?;
54
- let live = targets.iter().find(|target| {
55
- target.session == session
56
- && target.window_name.as_ref().is_some_and(|name| name.as_str() == window)
57
- && (pane == Some(target.pane_id.as_str())
58
- || !crate::lifecycle::launch::state_uses_adaptive_layout(state))
59
- && agent_pane_live_by_id(transport, &target.pane_id)
60
- });
61
- if let Some(target) = live {
62
- Err(LifecycleError::RequirementUnmet(format!(
63
- "agent {agent_id} is already running (duplicate / active cohort); use stop-agent first; cohort proof: session={} window={window} pane={}",
64
- session.as_str(), target.pane_id.as_str(),
65
- )))
66
- } else {
67
- Ok(())
68
- }
69
- }
70
-
71
- /// ---
72
- /// purpose: 起或复活一席的对外入口
73
- /// params:
74
- /// force: 窗口已存在时也重起
75
- /// open_display: 是否开显示
76
- /// allow_fresh: resume 依据缺失时允许改跑全新会话
77
- /// returns: Running、Noop 或 Paused
78
- /// errors: 选不到 team 返回 TeamSelect,owner 门不过返回 OwnerRefused,席位不存在返回 RequirementUnmet
79
- /// contract_id: lifecycle.start_agent.entry
80
- /// ---
81
- /// `start_agent(workspace, agent_id, force, open_display, allow_fresh, team)`
82
- /// (`lifecycle/start.py:72`)。`_runtime_lock("start-agent")` 下串行:resume-or-fresh
83
- /// 决策、resume 窗口退出回退 fresh、起后投递 pending message、起 coordinator。
84
- /// bug-085:`(session_id, rollout_path)` 四象限穷尽 match,缺 rollout 的 codex 仅在
85
- /// allow_fresh 时回退 fresh。
86
- pub fn start_agent(
87
- workspace: &Path,
88
- agent_id: &AgentId,
89
- force: bool,
90
- open_display: bool,
91
- allow_fresh: bool,
92
- team: Option<&str>,
93
- ) -> Result<StartAgentOutcome, LifecycleError> {
94
- let paths = lifecycle_paths(workspace, team)?;
95
- let canonical_team = paths.canonical_team(team).map(str::to_string);
96
- let team = canonical_team.as_deref();
97
- let _lock = acquire_agent_lifecycle_lock(LifecycleLockRequest {
98
- workspace: &paths.run_workspace,
99
- operation: "start-agent",
100
- team,
101
- agent_id: Some(agent_id),
102
- })?;
103
- let transport = paths.tmux_backend()?;
104
- start_agent_at_paths(
105
- &paths.run_workspace,
106
- &paths.spec_workspace,
107
- agent_id,
108
- force,
109
- open_display,
110
- allow_fresh,
111
- team,
112
- &transport,
113
- )
114
- }
115
-
116
- /// ---
117
- /// purpose: 带注入 transport 的起席入口;未指定 team 且解析失败时退回把入参 workspace 当作两个路径
118
- /// returns: Running、Noop 或 Paused
119
- /// errors: 指定了 team 而解析失败时透传该错误,其余同 start_agent
120
- /// contract_id: lifecycle.start_agent.entry
121
- /// ---
122
- /// `start_agent` with an injected transport — wires the single-worker resume/fresh spawn +
123
- /// start_coordinator (rt-host-a sweep: was a stub returning RequirementUnmet at the spawn boundary).
124
- #[allow(clippy::too_many_arguments)]
125
- pub(crate) fn start_agent_with_transport(
126
- workspace: &Path,
127
- agent_id: &AgentId,
128
- force: bool,
129
- open_display: bool,
130
- allow_fresh: bool,
131
- team: Option<&str>,
132
- transport: &dyn crate::transport::Transport,
133
- ) -> Result<StartAgentOutcome, LifecycleError> {
134
- let paths = match lifecycle_paths(workspace, team) {
135
- Ok(paths) => paths,
136
- Err(_) if team.is_none() => LifecyclePaths {
137
- run_workspace: workspace.to_path_buf(),
138
- spec_workspace: workspace.to_path_buf(),
139
- selected: None,
140
- },
141
- Err(error) => return Err(error),
142
- };
143
- let canonical_team = paths.canonical_team(team).map(str::to_string);
144
- let team = canonical_team.as_deref();
145
- let _lock = acquire_agent_lifecycle_lock(LifecycleLockRequest {
146
- workspace: &paths.run_workspace,
147
- operation: "start-agent",
148
- team,
149
- agent_id: Some(agent_id),
150
- })?;
151
- start_agent_at_paths(
152
- &paths.run_workspace,
153
- &paths.spec_workspace,
154
- agent_id,
155
- force,
156
- open_display,
157
- allow_fresh,
158
- team,
159
- transport,
160
- )
161
- }
162
-
163
- /// ---
164
- /// purpose: 起席的实体实现,读团队作用域 state、过 owner 门、定启动模式、spawn 并标记已起
165
- /// params:
166
- /// spec_workspace: spec 所在目录,用于补回席位的命令上下文
167
- /// open_display: 当前实现未直接使用,仅参与自适应布局判定
168
- /// returns: 席位暂停时直接返回 Paused,其余按启动模式返回 Running 或 Noop
169
- /// errors: 读 state 失败返回 StatePersist,owner 门不过返回 OwnerRefused,席位不存在返回 RequirementUnmet
170
- /// ---
171
- #[allow(clippy::too_many_arguments)]
172
- pub(crate) fn start_agent_at_paths(
173
- workspace: &Path,
174
- spec_workspace: &Path,
175
- agent_id: &AgentId,
176
- force: bool,
177
- open_display: bool,
178
- allow_fresh: bool,
179
- team: Option<&str>,
180
- transport: &dyn crate::transport::Transport,
181
- ) -> Result<StartAgentOutcome, LifecycleError> {
182
- let _ = open_display;
183
- let mut state = if team.is_some() {
184
- resolve_team_scoped_state_or_refuse(workspace, team)?
185
- } else {
186
- crate::state::persist::load_runtime_state(workspace)
187
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?
188
- };
189
- crate::lifecycle::launch::ensure_owner_allowed_for_state(&state, Some(agent_id))?;
190
- let raw_agent = state
191
- .get("agents")
192
- .and_then(|v| v.get(agent_id.as_str()))
193
- .ok_or_else(|| LifecycleError::RequirementUnmet(format!("agent {agent_id} not found")))?
194
- .clone();
195
- let agent = rehydrate_agent_command_context_from_spec(spec_workspace, agent_id, &raw_agent);
196
- if raw_agent
197
- .get("paused")
198
- .and_then(serde_json::Value::as_bool)
199
- .unwrap_or(false)
200
- {
201
- return Ok(StartAgentOutcome::Paused {
202
- agent_id: agent_id.clone(),
203
- });
204
- }
205
- let session_name = state_session_name(&state);
206
- let window = agent_window(&agent, agent_id);
207
- let adaptive_layout =
208
- open_display && crate::lifecycle::launch::state_uses_adaptive_layout(&state);
209
- if force && is_per_agent_window(&window, agent_id) {
210
- let expected_pane_id = raw_agent
211
- .get("pane_id")
212
- .and_then(serde_json::Value::as_str)
213
- .filter(|value| !value.is_empty());
214
- let target =
215
- SameRoleCohortTarget::new(agent_id, &window).with_expected_pane_id(expected_pane_id);
216
- if let Some(error) =
217
- same_role_cohort_pre_spawn_error(transport, &session_name, "start-agent", &[target])
218
- {
219
- return Err(LifecycleError::RequirementUnmet(error));
220
- }
221
- }
222
- // A persisted window name is only a topology hint. Once a pane binding is
223
- // recorded, the pane must be both physically live and owned by the
224
- // intended session/window; a foreign pane must never make start-agent
225
- // return Noop. A coordinator-provided pane_dead reason is also
226
- // authoritative when a backend cannot answer the exact-pane probe.
227
- let pane_marked_dead = raw_agent
228
- .get("stale_reason")
229
- .and_then(serde_json::Value::as_str)
230
- .is_some_and(|reason| matches!(reason, "pane_dead" | "both"));
231
- // A stale cached pane may still be recoverable without a spawn when the
232
- // intended per-agent window has exactly one live pane. The pane found by
233
- // this session/window lookup, not the cached id, is the binding that the
234
- // Noop path refreshes. A foreign pane with no intended window still falls
235
- // through to a real spawn.
236
- let noop_pane = if adaptive_layout {
237
- None
238
- } else {
239
- single_live_pane_for_window(transport, &session_name, &window)
240
- };
241
- let agent_live = if pane_marked_dead {
242
- false
243
- } else if adaptive_layout
244
- || raw_agent
245
- .get("pane_id")
246
- .and_then(serde_json::Value::as_str)
247
- .is_some_and(|pane| !pane.is_empty())
248
- {
249
- agent_pane_owned_and_live(transport, &raw_agent, &session_name, &window)
250
- || noop_pane.is_some()
251
- } else {
252
- window_exists(transport, &session_name, &window)
253
- };
254
- // 0.3.28 Step 9: E51 self-heal converted to topology assertion. After
255
- // Step 2 the leader lives in its own session (`team-agent-leader-*`),
256
- // so `agent.pane_id == leader_receiver.pane_id` is STRUCTURALLY
257
- // impossible. We keep the check as a runtime guard: if it ever fires,
258
- // emit a topology_invariant_violation event AND still force a fresh
259
- // spawn (defensive). The check itself remains a no-op on healthy
260
- // state — assert_topology_invariants from Step 1 catches the
261
- // upstream corruption.
262
- let noop_pane_conflict = noop_pane.as_ref().is_some_and(|pane| {
263
- pane_conflicts_with_pane_id(&state, agent_id, &raw_agent, pane.pane_id.as_str())
264
- });
265
- let has_collision = pane_conflicts_with_leader_or_other(&state, agent_id, &raw_agent)
266
- || noop_pane_conflict;
267
- if has_collision {
268
- eprintln!(
269
- "team_agent::layout pane_collision agent_id=`{agent_id}` \
270
- action=forcing_fresh_spawn \
271
- (the persisted or discovered pane is owned by another live seat)"
272
- );
273
- }
274
- let agent_live = agent_live && !has_collision;
275
- // 0.5.66 bypass 单源 §2.6 — dangerously_skip_permissions drift 挡板:
276
- // Noop 路径不 spawn,若声明面(角色 md / spec)与运行面(as-launched)不一致,
277
- // 拒 Noop 报明,防"改了 md 却以为生效、进程仍带旧 bypass 跑着"的暗门。
278
- let file_bypass = agent
279
- .get("dangerously_skip_permissions")
280
- .and_then(serde_json::Value::as_bool);
281
- let launched_bypass = raw_agent
282
- .get("as_launched_dangerously_skip_permissions")
283
- .and_then(serde_json::Value::as_bool);
284
- if !force && agent_live && check_bypass_drift(file_bypass, launched_bypass) {
285
- // 0.5.66 bypass 单源 §2.7:Noop drift 拒也写审计事件。
286
- let _ = crate::event_log::EventLog::new(workspace).write(
287
- "worker.spawn_dangerously_skip_permissions_drift_denied",
288
- serde_json::json!({
289
- "agent_id": agent_id.as_str(),
290
- "file_value": file_bypass,
291
- "launched_value": launched_bypass,
292
- "action": "noop_denied_require_remove_add_or_force",
293
- }),
294
- );
295
- return Err(LifecycleError::RequirementUnmet(format!(
296
- "dangerously_skip_permissions drift for agent {agent_id}: file={file_bypass:?} but running process launched with {launched_bypass:?}. \
297
- Run `remove-agent {agent_id}` then `add-agent {agent_id}` to apply, or `restart --force {agent_id}` to accept fresh spawn."
298
- )));
299
- }
300
- if !force && agent_live {
301
- let old_binding = pane_binding_snapshot(&raw_agent);
302
- let refreshed_binding = noop_pane.as_ref().map(pane_binding_from_live);
303
- mark_agent_running_noop(
304
- &mut state,
305
- agent_id,
306
- &session_name,
307
- &window,
308
- noop_pane.as_ref(),
309
- )?;
310
- state["agents"][agent_id.as_str()]["explicit_stop"] = serde_json::Value::Bool(false);
311
- let team_key = restart_projection_team_key(&state, team);
312
- save_restart_projected_state(workspace, &mut state, &team_key, &[agent_id.as_str()])?;
313
- if let Ok(spec) = load_team_spec(spec_workspace) {
314
- write_team_state(spec_workspace, &spec, &state)?;
315
- }
316
- replay_worker_target_missing_messages(workspace, agent_id, &team_key, &state, transport)?;
317
- let coordinator = start_coordinator_for_workspace(workspace, Some(&team_key))?;
318
- let coordinator_started = coordinator.ok;
319
- let target = format!("{}:{window}", session_name.as_str());
320
- if let Some(new_binding) = refreshed_binding.as_ref() {
321
- if old_binding.as_ref() != Some(new_binding) {
322
- write_agent_pane_binding_refreshed_event(
323
- workspace,
324
- agent_id,
325
- &session_name,
326
- &window,
327
- old_binding.as_ref(),
328
- new_binding,
329
- )?;
330
- }
331
- }
332
- write_start_agent_noop_event(workspace, agent_id, &target, coordinator_started)?;
333
- return Ok(StartAgentOutcome::Noop {
334
- env: AgentActionEnvelope {
335
- agent_id: agent_id.clone(),
336
- state_file: crate::state::persist::runtime_state_path(workspace),
337
- coordinator_started,
338
- },
339
- target,
340
- });
341
- }
342
- let provider = agent_provider(&agent);
343
- let session_id = agent_session_id(&agent);
344
- let rollout_path = agent_rollout_path(&agent);
345
- let resume_backing_exists = session_id
346
- .as_ref()
347
- .map(|session| {
348
- resume_backing_exists_for_agent(
349
- workspace,
350
- agent_id,
351
- &agent,
352
- provider,
353
- session,
354
- rollout_path.as_ref(),
355
- )
356
- })
357
- .unwrap_or(false);
358
- let start_mode = decide_start_mode(
359
- provider_wire(provider),
360
- session_id.as_ref(),
361
- rollout_path.as_ref(),
362
- resume_backing_exists,
363
- allow_fresh,
364
- );
365
- if matches!(start_mode, StartMode::Noop) {
366
- return Err(LifecycleError::RequirementUnmet(format!(
367
- "resume_not_ready: session backing store missing for agent {agent_id}; rerun with --allow-fresh to start fresh"
368
- )));
369
- }
370
- let spawn_session_id = if matches!(start_mode, StartMode::Resumed) {
371
- session_id.clone()
372
- } else {
373
- None
374
- };
375
- let into_existing_session =
376
- session_live_or_default(transport, &session_name, session_name_present(&state));
377
- let inherited_generation =
378
- crate::state::projection::session_generation(&state).map(str::to_string);
379
- let safety = crate::lifecycle::launch::effective_runtime_config_for_worker_spawn_json(
380
- &agent,
381
- provider,
382
- )?;
383
- let layout_placement = if adaptive_layout {
384
- crate::lifecycle::launch::adaptive_existing_placement_for_agent(
385
- &state,
386
- transport,
387
- &session_name,
388
- agent_id,
389
- )
390
- .or_else(|| {
391
- crate::lifecycle::launch::adaptive_placement_for_agent(
392
- &state,
393
- transport,
394
- &session_name,
395
- agent_id,
396
- )
397
- })
398
- } else {
399
- None
400
- };
401
- let spawn_window = layout_placement
402
- .as_ref()
403
- .map(|placement| placement.layout_window.as_str().to_string())
404
- .unwrap_or_else(|| window.clone());
405
- // Issue 2 (Round 3b gate review §6): pass the explicit team_key so the
406
- // worker MCP env carries it through restart-agent path too. The
407
- // `restart_projection_team_key` helper consolidates the same resolution
408
- // used for save_restart_projected_state below.
409
- let resolved_team_key = restart_projection_team_key(&state, team);
410
- let spawn = spawn_agent_window(
411
- workspace,
412
- &session_name,
413
- agent_id,
414
- &agent,
415
- spawn_session_id.as_ref(),
416
- into_existing_session,
417
- transport,
418
- Some(&safety),
419
- layout_placement.as_ref(),
420
- None,
421
- None,
422
- Some(resolved_team_key.as_str()),
423
- )?;
424
- if let Err(error) = verify_spawned_pane_matches_target(
425
- transport,
426
- &spawn.spawn.pane_id,
427
- &session_name,
428
- &spawn.spawn.window,
429
- ) {
430
- return Err(rollback_spawned_pane_keep_error(
431
- transport,
432
- &spawn.spawn.pane_id,
433
- error,
434
- ));
435
- }
436
- let actual_spawn_window = spawn.spawn.window.as_str().to_string();
437
- let spawned = (|| {
438
- mark_agent_started(
439
- &mut state,
440
- agent_id,
441
- &actual_spawn_window,
442
- &spawn,
443
- transport,
444
- &safety,
445
- start_mode,
446
- )?;
447
- let generation = if into_existing_session {
448
- inherited_generation.as_deref()
449
- } else {
450
- Some(spawn.spawned_at.as_str())
451
- };
452
- if let Some(generation) = generation {
453
- state["generation"] = serde_json::json!(generation);
454
- if !into_existing_session {
455
- transport
456
- .set_session_owner_with_generation(
457
- &session_name,
458
- workspace,
459
- &resolved_team_key,
460
- generation,
461
- )
462
- .map_err(|error| LifecycleError::Transport(error.to_string()))?;
463
- }
464
- }
465
- // 0.5.66 bypass 单源 §2.7:启动即带 bypass → 审计留痕。
466
- if safety.enabled {
467
- let state_agent = state
468
- .get("agents")
469
- .and_then(|v| v.get(agent_id.as_str()));
470
- let _ = crate::event_log::EventLog::new(workspace).write(
471
- "worker.spawn_dangerously_skip_permissions",
472
- serde_json::json!({
473
- "agent_id": agent_id.as_str(),
474
- "role": state_agent
475
- .and_then(|a| a.get("role"))
476
- .and_then(serde_json::Value::as_str)
477
- .unwrap_or_default(),
478
- "provider": state_agent
479
- .and_then(|a| a.get("provider"))
480
- .and_then(serde_json::Value::as_str)
481
- .unwrap_or_default(),
482
- "trigger": "start-agent",
483
- "spec_source_path": crate::lifecycle::launch::agent_id_spec_source_path(
484
- workspace, agent_id.as_str(),
485
- ),
486
- }),
487
- );
488
- }
489
- // **0.3.24 add-agent socket drift fix**: keep `state.tmux_endpoint` /
490
- // `state.tmux_socket` synchronized with the transport actually used for the
491
- // spawn. Without this, add-agent / fork-agent could spawn to a socket that
492
- // never gets persisted, and the next coordinator tick would re-resolve to
493
- // the workspace-hash socket and lose the new pane. Annotation runs inside
494
- // the same `save_restart_projected_state` window — no parallel "annotate
495
- // after spawn" race with coordinator and no double source of truth.
496
- crate::lifecycle::launch::annotate_runtime_tmux_endpoint(&mut state, transport, workspace);
497
- let team_key = restart_projection_team_key(&state, team);
498
- // 0.5.32 (`.team/artifacts/restart-resumed-stale-activity-locate.md` §5):
499
- // clear the matching `agent_health` observation on the new spawn cohort
500
- // so five-line status summary and status --json do not surface a stale
501
- // WORKING row from the pre-shutdown process. Best-effort: DB failure
502
- // must not fail the start-agent path.
503
- let _ = crate::db::agent_health_capture::clear_agent_health_observation(
504
- workspace, &team_key, agent_id,
505
- );
506
- let skip_capture_backfill = if matches!(
507
- start_mode,
508
- StartMode::Fresh | StartMode::FreshAfterMissingRollout
509
- ) {
510
- vec![agent_id.as_str()]
511
- } else {
512
- Vec::new()
513
- };
514
- persist_selected_receiver_session_name(&mut state, &session_name);
515
- save_restart_projected_state_with_capture_backfill_skip(
516
- workspace,
517
- &mut state,
518
- &team_key,
519
- &skip_capture_backfill,
520
- &[agent_id.as_str()],
521
- )?;
522
- write_start_agent_start_event(
523
- workspace,
524
- agent_id,
525
- &agent,
526
- &spawn.plan,
527
- provider,
528
- start_mode,
529
- &session_name,
530
- &actual_spawn_window,
531
- spawn_session_id.as_ref(),
532
- tmux_start_mode_for_spawn(&spawn, into_existing_session),
533
- )?;
534
- replay_worker_target_missing_messages(workspace, agent_id, &team_key, &state, transport)?;
535
- let coordinator = start_coordinator_for_workspace(workspace, Some(&team_key))?;
536
- let coordinator_started = coordinator.ok;
537
- Ok(StartAgentOutcome::Running {
538
- env: AgentActionEnvelope {
539
- agent_id: agent_id.clone(),
540
- state_file: crate::state::persist::runtime_state_path(workspace),
541
- coordinator_started,
542
- },
543
- start_mode,
544
- target: spawn.spawn.pane_id.as_str().to_string(),
545
- session_id,
546
- new_session_id: spawn.plan.expected_session_id.clone(),
547
- rollout_path,
548
- })
549
- })();
550
- match spawned {
551
- Ok(outcome) => Ok(outcome),
552
- Err(error) => Err(rollback_spawned_pane_keep_error(
553
- transport,
554
- &spawn.spawn.pane_id,
555
- error,
556
- )),
557
- }
558
- }
559
-
560
- fn rollback_spawned_pane_keep_error(
561
- transport: &dyn crate::transport::Transport,
562
- pane: &crate::transport::PaneId,
563
- error: LifecycleError,
564
- ) -> LifecycleError {
565
- match transport.kill_pane(pane) {
566
- Ok(()) => error,
567
- Err(rollback_error) => LifecycleError::Transport(format!(
568
- "{error}; failed to roll back spawned pane {}: {rollback_error}",
569
- pane.as_str()
570
- )),
571
- }
572
- }
573
-
574
- fn replay_worker_target_missing_messages(
575
- workspace: &Path,
576
- agent_id: &AgentId,
577
- team_key: &str,
578
- state: &serde_json::Value,
579
- transport: &dyn crate::transport::Transport,
580
- ) -> Result<(), LifecycleError> {
581
- let store = crate::message_store::MessageStore::open(workspace)
582
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
583
- let event_log = crate::event_log::EventLog::new(workspace);
584
- let ids = crate::messaging::delivery::requeue_worker_target_missing_messages(
585
- workspace,
586
- &store,
587
- &event_log,
588
- agent_id.as_str(),
589
- Some(team_key),
590
- )
591
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
592
- if !ids.is_empty() {
593
- crate::messaging::delivery::deliver_pending_messages(
594
- workspace, state, transport, &event_log,
595
- )
596
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
597
- }
598
- Ok(())
599
- }
600
-
601
- pub(super) fn verify_spawned_pane_matches_target(
602
- transport: &dyn crate::transport::Transport,
603
- pane: &crate::transport::PaneId,
604
- session: &crate::transport::SessionName,
605
- window: &crate::transport::WindowName,
606
- ) -> Result<(), LifecycleError> {
607
- let targets = transport
608
- .list_targets()
609
- .map_err(|e| LifecycleError::Transport(e.to_string()))?;
610
- let observed = targets.iter().find(|target| target.pane_id == *pane);
611
- let Some(observed) = observed else {
612
- return Err(LifecycleError::RequirementUnmet(format!(
613
- "start refused: spawned pane not addressable on transport socket (possible socket drift); window disappeared or spawned pane not owned by requested agent window; requested={}:{} pane={} observed=<missing>",
614
- session.as_str(),
615
- window.as_str(),
616
- pane.as_str()
617
- )));
618
- };
619
- let observed_window = observed
620
- .window_name
621
- .as_ref()
622
- .map(crate::transport::WindowName::as_str)
623
- .unwrap_or("<unknown>");
624
- if observed.session.as_str() != session.as_str() || observed_window != window.as_str() {
625
- return Err(LifecycleError::RequirementUnmet(format!(
626
- "start refused: spawned pane not owned by requested agent window; requested={}:{} pane={} observed={}:{}",
627
- session.as_str(),
628
- window.as_str(),
629
- pane.as_str(),
630
- observed.session.as_str(),
631
- observed_window
632
- )));
633
- }
634
- if matches!(
635
- transport.liveness(pane),
636
- Ok(crate::model::enums::PaneLiveness::Dead)
637
- ) {
638
- return Err(LifecycleError::RequirementUnmet(format!(
639
- "start refused: spawned pane not addressable on transport socket; pane is dead after spawn; requested={}:{} pane={}",
640
- session.as_str(),
641
- window.as_str(),
642
- pane.as_str()
643
- )));
644
- }
645
- Ok(())
646
- }
647
-
648
- #[derive(Debug, Clone, PartialEq, Eq)]
649
- struct PaneBindingSnapshot {
650
- pane_id: String,
651
- pane_pid: Option<u32>,
652
- }
653
-
654
- fn pane_binding_snapshot(agent: &serde_json::Value) -> Option<PaneBindingSnapshot> {
655
- let pane_id = agent
656
- .get("pane_id")
657
- .and_then(serde_json::Value::as_str)
658
- .filter(|pane| !pane.is_empty())?;
659
- Some(PaneBindingSnapshot {
660
- pane_id: pane_id.to_string(),
661
- pane_pid: agent
662
- .get("pane_pid")
663
- .and_then(serde_json::Value::as_u64)
664
- .map(|pid| pid as u32),
665
- })
666
- }
667
-
668
- fn pane_binding_from_live(pane: &crate::transport::PaneInfo) -> PaneBindingSnapshot {
669
- PaneBindingSnapshot {
670
- pane_id: pane.pane_id.as_str().to_string(),
671
- pane_pid: pane.pane_pid,
672
- }
673
- }
674
-
675
- fn single_live_pane_for_window(
676
- transport: &dyn crate::transport::Transport,
677
- session: &crate::transport::SessionName,
678
- window: &str,
679
- ) -> Option<crate::transport::PaneInfo> {
680
- let targets = transport.list_targets().ok()?;
681
- let mut matches = targets.into_iter().filter(|target| {
682
- target.session.as_str() == session.as_str()
683
- && target
684
- .window_name
685
- .as_ref()
686
- .is_some_and(|name| name.as_str() == window)
687
- });
688
- let pane = matches.next()?;
689
- if matches.next().is_some() {
690
- return None;
691
- }
692
- Some(pane)
693
- }
694
-
695
- fn write_agent_pane_binding_refreshed_event(
696
- workspace: &Path,
697
- agent_id: &AgentId,
698
- session: &crate::transport::SessionName,
699
- window: &str,
700
- old: Option<&PaneBindingSnapshot>,
701
- new: &PaneBindingSnapshot,
702
- ) -> Result<(), LifecycleError> {
703
- crate::event_log::EventLog::new(workspace)
704
- .write(
705
- "agent_pane_binding_refreshed",
706
- serde_json::json!({
707
- "agent_id": agent_id.as_str(),
708
- "session": session.as_str(),
709
- "window": window,
710
- "old_pane_id": old.map(|binding| binding.pane_id.as_str()),
711
- "old_pane_pid": old.and_then(|binding| binding.pane_pid),
712
- "pane_id": new.pane_id.as_str(),
713
- "pane_pid": new.pane_pid,
714
- }),
715
- )
716
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
717
- Ok(())
718
- }
719
-
720
- /// E51 (0.3.26 P0, restart self-heal): returns `true` when the agent's pane_id
721
- /// is the same as the leader_receiver/team_owner pane_id OR is owned by a
722
- /// different agent in the state. In both cases `start_agent` must NOT treat the
723
- /// pane as "this agent's live pane" (it should spawn fresh).
724
- fn pane_conflicts_with_leader_or_other(
725
- state: &serde_json::Value,
726
- agent_id: &crate::model::ids::AgentId,
727
- agent: &serde_json::Value,
728
- ) -> bool {
729
- let Some(pane_id) = agent
730
- .get("pane_id")
731
- .and_then(serde_json::Value::as_str)
732
- .filter(|s| !s.is_empty())
733
- else {
734
- return false;
735
- };
736
- pane_conflicts_with_pane_id(state, agent_id, agent, pane_id)
737
- }
738
-
739
- fn pane_conflicts_with_pane_id(
740
- state: &serde_json::Value,
741
- agent_id: &crate::model::ids::AgentId,
742
- agent: &serde_json::Value,
743
- pane_id: &str,
744
- ) -> bool {
745
- let state_socket = runtime_tmux_socket(state);
746
- let agent_socket = tmux_socket_field(agent).or(state_socket);
747
- // Check leader anchor.
748
- for key in ["leader_receiver", "team_owner"] {
749
- if state
750
- .get(key)
751
- .and_then(pane_socket_binding)
752
- .is_some_and(|leader| pane_conflicts_on_same_socket(pane_id, agent_socket, leader))
753
- {
754
- return true;
755
- }
756
- }
757
- // Check other agents.
758
- if let Some(agents) = state.get("agents").and_then(serde_json::Value::as_object) {
759
- for (id, other) in agents {
760
- if id == agent_id.as_str()
761
- || matches!(
762
- other.get("status").and_then(serde_json::Value::as_str),
763
- Some("stopped" | "paused" | "failed" | "removed")
764
- )
765
- {
766
- continue;
767
- }
768
- let other_socket = tmux_socket_field(other).or(state_socket);
769
- if other
770
- .get("pane_id")
771
- .and_then(serde_json::Value::as_str)
772
- .is_some_and(|op| {
773
- op == pane_id && !tmux_sockets_known_different(agent_socket, other_socket)
774
- })
775
- {
776
- return true;
777
- }
778
- }
779
- }
780
- false
781
- }
782
-
783
- #[derive(Clone, Copy)]
784
- struct PaneSocketBinding<'a> {
785
- pane_id: &'a str,
786
- tmux_socket: Option<&'a str>,
787
- }
788
-
789
- fn pane_conflicts_on_same_socket(
790
- pane_id: &str,
791
- agent_socket: Option<&str>,
792
- other: PaneSocketBinding<'_>,
793
- ) -> bool {
794
- other.pane_id == pane_id && !tmux_sockets_known_different(agent_socket, other.tmux_socket)
795
- }
796
-
797
- fn tmux_sockets_known_different(left: Option<&str>, right: Option<&str>) -> bool {
798
- let (Some(left), Some(right)) = (left, right) else {
799
- return false;
800
- };
801
- if left == right {
802
- return false;
803
- }
804
- std::path::Path::new(left).is_absolute() && std::path::Path::new(right).is_absolute()
805
- }
806
-
807
- fn runtime_tmux_socket(state: &serde_json::Value) -> Option<&str> {
808
- tmux_socket_field(state)
809
- }
810
-
811
- fn tmux_socket_field(value: &serde_json::Value) -> Option<&str> {
812
- value
813
- .get("tmux_endpoint")
814
- .or_else(|| value.get("tmux_socket"))
815
- .and_then(serde_json::Value::as_str)
816
- .filter(|value| !value.is_empty())
817
- }
818
-
819
- fn pane_socket_binding(value: &serde_json::Value) -> Option<PaneSocketBinding<'_>> {
820
- let pane_id = value
821
- .get("pane_id")
822
- .and_then(serde_json::Value::as_str)
823
- .filter(|s| !s.is_empty() && *s != "__team_agent_unbound__")?;
824
- Some(PaneSocketBinding {
825
- pane_id,
826
- tmux_socket: tmux_socket_field(value),
827
- })
828
- }
829
-
830
- fn agent_pane_owned_and_live(
831
- transport: &dyn crate::transport::Transport,
832
- agent: &serde_json::Value,
833
- expected_session: &crate::transport::SessionName,
834
- expected_window: &str,
835
- ) -> bool {
836
- let Some(pane) = agent
837
- .get("pane_id")
838
- .and_then(serde_json::Value::as_str)
839
- .filter(|pane| !pane.is_empty())
840
- .map(crate::transport::PaneId::new)
841
- else {
842
- return false;
843
- };
844
- let Ok(targets) = transport.list_targets() else {
845
- // Ownership is unknown when the topology snapshot fails. Preserve the
846
- // base liveness direction: only positive death evidence may authorize
847
- // a destructive respawn; otherwise fall back to the pane probe and
848
- // leave retry authority to the operator.
849
- return agent_pane_live_by_id(transport, &pane);
850
- };
851
- let owned = targets.iter().any(|target| {
852
- target.pane_id == pane
853
- && target.session.as_str() == expected_session.as_str()
854
- && target
855
- .window_name
856
- .as_ref()
857
- .is_some_and(|window| window.as_str() == expected_window)
858
- });
859
- owned && agent_pane_live_by_id(transport, &pane)
860
- }
861
-
862
- fn agent_pane_live_by_id(
863
- transport: &dyn crate::transport::Transport,
864
- pane: &crate::transport::PaneId,
865
- ) -> bool {
866
- match transport.has_pane(&pane) {
867
- Ok(Some(live)) => live,
868
- Ok(None) | Err(_) => !matches!(
869
- transport.liveness(&pane),
870
- Ok(crate::model::enums::PaneLiveness::Dead)
871
- ),
872
- }
873
- }
874
-
875
- /// 0.4.10+ reset duplicate-window fix (CR-approved, plan §1).
876
- ///
877
- /// Enumerate live panes whose `(session, window_name)` match the given pair.
878
- /// Used by `stop_agent_at_paths` (when the stored pane_id is stale/dead but a
879
- /// same-role window survives) and by the reset hard gate (to prove no
880
- /// duplicate window residue remains before `start_agent_at_paths`).
881
- ///
882
- /// `list_targets()` is a point-in-time tmux snapshot — duplicates ARE
883
- /// preserved in the result so callers can see the full set.
884
- ///
885
- /// Caller MUST also check `is_per_agent_window(window, agent_id)` before
886
- /// using this list to kill panes (plan §2 safety constraint): a shared
887
- /// layout window may host co-tenants.
888
- fn list_same_role_panes(
889
- transport: &dyn crate::transport::Transport,
890
- session: &crate::transport::SessionName,
891
- window: &str,
892
- ) -> Vec<crate::transport::PaneInfo> {
893
- transport
894
- .list_targets()
895
- .unwrap_or_default()
896
- .into_iter()
897
- .filter(|pane| {
898
- pane.session.as_str() == session.as_str()
899
- && pane.window_name.as_ref().map(WindowName::as_str) == Some(window)
900
- })
901
- .collect()
902
- }
903
-
904
- /// 0.4.10+ reset duplicate-window fix (plan §2 safety constraint).
905
- ///
906
- /// Returns true only when `window == agent_id`, i.e. the canonical
907
- /// per-agent window. Adaptive/shared layout windows (`workers`, `team`,
908
- /// or any layout window name produced by `is_adaptive_layout_window_pub`)
909
- /// MUST NOT be broad-killed by name — they may host co-tenants. The
910
- /// caller falls back to safer behavior (refuse stop, surface
911
- /// RequirementUnmet/transport error) when this returns false.
912
- fn is_per_agent_window(window: &str, agent_id: &AgentId) -> bool {
913
- is_per_agent_cohort_window(window, agent_id)
914
- }
915
-
916
- fn tmux_start_mode_for_spawn(
917
- spawn: &SpawnedAgentWindow,
918
- into_existing_session: bool,
919
- ) -> &'static str {
920
- if let Some(placement) = spawn.layout_placement.as_ref() {
921
- if placement.starts_window {
922
- if into_existing_session {
923
- "new-window"
924
- } else {
925
- "new-session"
926
- }
927
- } else {
928
- "split-window"
929
- }
930
- } else if into_existing_session {
931
- "new-window"
932
- } else {
933
- "new-session"
934
- }
935
- }
936
-
937
- // ═══════════════════════════════════════════════════════════════════════
938
- // 0.4.6 Stage 1: reset/start clean-boundary helpers
939
- // ═══════════════════════════════════════════════════════════════════════
940
-
941
- /// ---
942
- /// purpose: 有界轮询等待旧 pane 不可达且旧进程退出
943
- /// params:
944
- /// old_pane: 旧 pane,None 视作已死
945
- /// old_pid: 旧进程号,None 视作已退出
946
- /// returns: 证据载荷,含两者是否确认消失与实际等待毫秒数;到上限仍未消失也照实返回
947
- /// ---
948
- /// Bounded polling: wait for the old pane to become unreachable AND, when
949
- /// possible, for the old pane_pid to exit. Returns a JSON evidence blob
950
- /// recording the observed transition for events.
951
- pub(super) fn drain_old_pane_and_pid(
952
- transport: &dyn crate::transport::Transport,
953
- old_pane: Option<&crate::transport::PaneId>,
954
- old_pid: Option<u32>,
955
- ) -> serde_json::Value {
956
- const DRAIN_MAX_MS: u64 = 1500;
957
- const DRAIN_POLL_MS: u64 = 50;
958
- let start = std::time::Instant::now();
959
- let mut pane_dead = old_pane.is_none();
960
- let mut pid_dead = old_pid.is_none();
961
- while start.elapsed().as_millis() < DRAIN_MAX_MS as u128 {
962
- if !pane_dead {
963
- if let Some(pane) = old_pane {
964
- if !agent_pane_live_by_id(transport, pane) {
965
- pane_dead = true;
966
- }
967
- }
968
- }
969
- if !pid_dead {
970
- if let Some(pid) = old_pid {
971
- if !pid_is_alive(pid) {
972
- pid_dead = true;
973
- }
974
- }
975
- }
976
- if pane_dead && pid_dead {
977
- break;
978
- }
979
- std::thread::sleep(std::time::Duration::from_millis(DRAIN_POLL_MS));
980
- }
981
- serde_json::json!({
982
- "old_pane_id": old_pane.map(|p| p.as_str()),
983
- "old_pane_pid": old_pid,
984
- "old_pane_dead": pane_dead,
985
- "old_pid_dead": pid_dead,
986
- "drain_elapsed_ms": start.elapsed().as_millis() as u64,
987
- })
988
- }
989
-
990
- /// ---
991
- /// purpose: 尽力探测某进程号是否还活着
992
- /// returns: 由平台层给出的判定
993
- /// ---
994
- /// Best-effort liveness probe for a pid.
995
- ///
996
- /// 0.5.x Windows portability Batch 3: routes through
997
- /// `crate::platform::process::pid_is_alive`. Unix uses `kill(pid, 0)`
998
- /// with the `EPERM = Live` branch preserved byte-for-byte; Windows
999
- /// uses `OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION)` +
1000
- /// `GetExitCodeProcess` (STILL_ACTIVE = Live). The legacy non-Unix
1001
- /// `true` fallback (which broke drain by reporting every pid alive)
1002
- /// is gone.
1003
- pub(super) fn pid_is_alive(pid: u32) -> bool {
1004
- crate::platform::process::pid_is_alive(pid)
1005
- }
1006
-
1007
- /// ---
1008
- /// purpose: 从 state 里读该席位的 pane 进程号
1009
- /// returns: 存在且是无符号整数时返回它,否则 None
1010
- /// ---
1011
- /// Read state.agents[agent_id].pane_pid (u32) from the runtime state.
1012
- pub(super) fn state_pane_pid(state: &serde_json::Value, agent_id: &AgentId) -> Option<u32> {
1013
- state
1014
- .get("agents")
1015
- .and_then(|v| v.get(agent_id.as_str()))
1016
- .and_then(|v| v.get("pane_pid"))
1017
- .and_then(serde_json::Value::as_u64)
1018
- .map(|p| p as u32)
1019
- }
1020
-
1021
- /// ---
1022
- /// purpose: 算出该席位下一次的 spawn 世代号
1023
- /// returns: 当前值加一,缺失时按 0 起算;世代号用于把捕获与事件归因到本次进程
1024
- /// ---
1025
- /// Read + increment state.agents[agent_id].spawn_epoch. The epoch is a
1026
- /// monotonic counter persisted with the agent row that uniquely tags each
1027
- /// fresh-start / reset / restart cycle. Subsequent capture / event /
1028
- /// status logic dispatches on `(team_key, agent_id, spawn_epoch,
1029
- /// pane_pid, expected_session_id)` to avoid attributing a stale prior
1030
- /// fresh attempt to the current process.
1031
- pub(super) fn next_spawn_epoch(state: &serde_json::Value, agent_id: &AgentId) -> u64 {
1032
- let current = state
1033
- .get("agents")
1034
- .and_then(|v| v.get(agent_id.as_str()))
1035
- .and_then(|v| v.get("spawn_epoch"))
1036
- .and_then(serde_json::Value::as_u64)
1037
- .unwrap_or(0);
1038
- current.saturating_add(1)
1039
- }
1040
-
1041
- /// ---
1042
- /// purpose: 停一席的对外入口
1043
- /// returns: 停止报告
1044
- /// errors: 选不到 team 返回 TeamSelect,席位不存在返回 RequirementUnmet
1045
- /// contract_id: lifecycle.stop_agent.entry
1046
- /// ---
1047
- /// `stop_agent(workspace, agent_id, team)`(`lifecycle/operations.py:62`)。
1048
- /// owner-gate → kill window → **同时关显示** → 写 state。
1049
- pub fn stop_agent(
1050
- workspace: &Path,
1051
- agent_id: &AgentId,
1052
- team: Option<&str>,
1053
- ) -> Result<StopAgentReport, LifecycleError> {
1054
- let paths = lifecycle_paths(workspace, team)?;
1055
- let canonical_team = paths.canonical_team(team).map(str::to_string);
1056
- let team = canonical_team.as_deref();
1057
- let _lock = acquire_agent_lifecycle_lock(LifecycleLockRequest {
1058
- workspace: &paths.run_workspace,
1059
- operation: "stop-agent",
1060
- team,
1061
- agent_id: Some(agent_id),
1062
- })?;
1063
- let transport = paths.tmux_backend()?;
1064
- stop_agent_at_paths(
1065
- &paths.run_workspace,
1066
- &paths.spec_workspace,
1067
- agent_id,
1068
- team,
1069
- &transport,
1070
- )
1071
- }
1072
-
1073
- /// ---
1074
- /// purpose: 带注入 transport 的停席入口
1075
- /// returns: 停止报告
1076
- /// errors: 同 stop_agent
1077
- /// contract_id: lifecycle.stop_agent.entry
1078
- /// ---
1079
- pub(crate) fn stop_agent_with_transport(
1080
- workspace: &Path,
1081
- agent_id: &AgentId,
1082
- team: Option<&str>,
1083
- transport: &dyn crate::transport::Transport,
1084
- ) -> Result<StopAgentReport, LifecycleError> {
1085
- let paths = lifecycle_paths(workspace, team)?;
1086
- let canonical_team = paths.canonical_team(team).map(str::to_string);
1087
- let team = canonical_team.as_deref();
1088
- let _lock = acquire_agent_lifecycle_lock(LifecycleLockRequest {
1089
- workspace: &paths.run_workspace,
1090
- operation: "stop-agent",
1091
- team,
1092
- agent_id: Some(agent_id),
1093
- })?;
1094
- stop_agent_at_paths(
1095
- &paths.run_workspace,
1096
- &paths.spec_workspace,
1097
- agent_id,
1098
- team,
1099
- transport,
1100
- )
1101
- }
1102
-
1103
- /// ---
1104
- /// purpose: 停席的实体实现,解析席位、收敛杀 pane 与窗口、取排空证据后落 state
1105
- /// returns: 停止报告;注意报告里的显示已关闭字段恒为真,不反映实际关显示结果
1106
- /// errors: 席位解析不到实体返回 RequirementUnmet,写 state 失败返回 StatePersist
1107
- /// ---
1108
- pub(super) fn stop_agent_at_paths(
1109
- workspace: &Path,
1110
- spec_workspace: &Path,
1111
- agent_id: &AgentId,
1112
- team: Option<&str>,
1113
- transport: &dyn crate::transport::Transport,
1114
- ) -> Result<StopAgentReport, LifecycleError> {
1115
- // golden operations.py:64-66: resolve_team_scoped_state -> owner gate, BEFORE the unknown-worker raise.
1116
- let seat = super::remove::resolve_seat(workspace, spec_workspace, agent_id, team, transport)?;
1117
- if seat.consistency == super::remove::SeatConsistency::Absent {
1118
- return Err(unknown_worker(agent_id));
1119
- }
1120
- let mut state = seat.state;
1121
- let spec = seat.spec;
1122
- let state_agent = state.get("agents").and_then(|v| v.get(agent_id.as_str()));
1123
- // Persisted-only seats must remain stoppable. Build the minimal provider
1124
- // projection consumed by mark_agent_stopped instead of requiring a spec
1125
- // row that is precisely what recovery is repairing.
1126
- let fallback_agent = YamlValue::Map(vec![(
1127
- "provider".to_string(),
1128
- YamlValue::Str(
1129
- state_agent
1130
- .and_then(|agent| agent.get("provider"))
1131
- .and_then(|value| value.as_str())
1132
- .unwrap_or("codex")
1133
- .to_string(),
1134
- ),
1135
- )]);
1136
- let agent = find_spec_agent(&spec, agent_id).unwrap_or(&fallback_agent);
1137
- let session_name = seat.session;
1138
- let window = seat.window;
1139
- let pane_id = seat.physical.map(|pane| pane.pane_id).or_else(|| {
1140
- state
1141
- .get("agents")
1142
- .and_then(|agents| agents.get(agent_id.as_str()))
1143
- .and_then(|agent| agent.get("pane_id"))
1144
- .and_then(serde_json::Value::as_str)
1145
- .filter(|pane| !pane.is_empty())
1146
- .map(crate::transport::PaneId::new)
1147
- });
1148
- let target_str = pane_id
1149
- .as_ref()
1150
- .map(|pane| pane.as_str().to_string())
1151
- .unwrap_or_else(|| format!("{}:{window}", session_name.as_str()));
1152
- // 0.4.10+ reset duplicate-window fix (plan §2): stop must resolve a
1153
- // STALE stored pane_id to live same-role panes by `(session, window)`
1154
- // enumeration BEFORE concluding the worker is absent. Pre-fix logic
1155
- // returned stopped=false when pane_id was dead even if a residual
1156
- // duplicate window survived — that residue then collided with
1157
- // reset's unconditional start, producing the observed
1158
- // `stopped=false, started=true` duplicate-window pattern.
1159
- //
1160
- // Only the STALE-pane-id branch enumerates same-role panes. When
1161
- // pane_id was never set in state (legacy state shape, never observed
1162
- // a real spawn), the existing window-based fallback is preserved —
1163
- // the duplicate-window bug requires a stored-but-stale pane_id as
1164
- // the trigger.
1165
- let stored_pane_live = pane_id
1166
- .as_ref()
1167
- .map(|pane| agent_pane_live_by_id(transport, pane))
1168
- .unwrap_or(false);
1169
- let stored_pane_stale = pane_id.is_some() && !stored_pane_live;
1170
- let same_role_panes: Vec<crate::transport::PaneInfo> =
1171
- if stored_pane_stale && is_per_agent_window(&window, agent_id) {
1172
- list_same_role_panes(transport, &session_name, &window)
1173
- } else {
1174
- Vec::new()
1175
- };
1176
- let stopped = stored_pane_live
1177
- || !same_role_panes.is_empty()
1178
- || (pane_id.is_none() && window_exists(transport, &session_name, &window));
1179
- if stopped {
1180
- let stop_targets =
1181
- if let Some(pane) = pane_id.as_ref().filter(|_| stored_pane_live) {
1182
- vec![Target::Pane(pane.clone())]
1183
- } else if !same_role_panes.is_empty() {
1184
- same_role_panes
1185
- .iter()
1186
- .map(|pane| Target::Pane(pane.pane_id.clone()))
1187
- .collect()
1188
- } else {
1189
- vec![Target::SessionWindow {
1190
- session: session_name.clone(),
1191
- window: WindowName::new(&window),
1192
- }]
1193
- };
1194
- // Explicit kill-pane/kill-window ignores remain-on-exit on the worker.
1195
- // Preserve the last window BEFORE killing it, or the coordinator sees
1196
- // a missing session and stops while the seat is merely being stopped.
1197
- transport
1198
- .preserve_session_before_stop(&session_name, &stop_targets)
1199
- .map_err(|error| {
1200
- LifecycleError::Transport(format!(
1201
- "failed to preserve session before stopping agent {agent_id}: {error}"
1202
- ))
1203
- })?;
1204
- // golden operations.py:84-86: a non-zero kill-window raises
1205
- // RuntimeError(f"failed to stop agent {agent_id}: {proc.stderr.strip()}").
1206
- //
1207
- // 0.4.10+ kill resolution order (plan §2):
1208
- // 1. stored pane_id is live → kill it by pane_id.
1209
- // 2. stored pane_id is stale BUT same-role panes survive →
1210
- // kill each by pane_id (duplicate window names make
1211
- // kill-window -t session:window ambiguous).
1212
- // 3. no pane_id at all but window exists → kill_window as
1213
- // before (legacy compat for state without pane_id field).
1214
- let kill_result: Result<(), crate::transport::TransportError> =
1215
- if let Some(pane) = pane_id.as_ref().filter(|_| stored_pane_live) {
1216
- transport.kill_pane(pane)
1217
- } else if !same_role_panes.is_empty() {
1218
- let mut last_err: Option<crate::transport::TransportError> = None;
1219
- for residual in &same_role_panes {
1220
- if let Err(e) = transport.kill_pane(&residual.pane_id) {
1221
- last_err = Some(e);
1222
- }
1223
- }
1224
- last_err.map(Err).unwrap_or(Ok(()))
1225
- } else {
1226
- let target = Target::SessionWindow {
1227
- session: session_name.clone(),
1228
- window: WindowName::new(&window),
1229
- };
1230
- transport.kill_window(&target)
1231
- };
1232
- if let Err(e) = kill_result {
1233
- let stderr = match &e {
1234
- crate::transport::TransportError::Subprocess { stderr, .. } => {
1235
- stderr.trim().to_string()
1236
- }
1237
- other => other.to_string(),
1238
- };
1239
- let _ = write_stop_window_failed_event(workspace, agent_id, &target_str, &stderr);
1240
- return Err(LifecycleError::Transport(format!(
1241
- "failed to stop agent {agent_id}: {stderr}"
1242
- )));
1243
- }
1244
- // 0.4.6 Stage 1: drain-and-prove. The pre-fix path trusted `kill_pane`'s
1245
- // success return without waiting for the pane / pid to actually exit.
1246
- // This created a window where reset/start spawned a new worker while
1247
- // the old Claude process + tty + provider state were still alive,
1248
- // leading to the macmini "running but not capturable" failure mode.
1249
- //
1250
- // Poll bounded time for old pane to become unreachable. If it stays
1251
- // reachable after the budget, emit an event but do NOT block — the
1252
- // subsequent spawn boundary check (new pane_id != old pane_id) is
1253
- // the final safety net.
1254
- let drain_evidence = drain_old_pane_and_pid(
1255
- transport,
1256
- pane_id.as_ref(),
1257
- state_pane_pid(&state, agent_id),
1258
- );
1259
- let _ = write_stop_drain_event(workspace, agent_id, &target_str, &drain_evidence);
1260
- }
1261
- mark_agent_stopped(&mut state, agent_id, agent, &window)?;
1262
- state["agents"][agent_id.as_str()]["explicit_stop"] = serde_json::Value::Bool(true);
1263
- let team_key = restart_projection_team_key(&state, team);
1264
- // golden operations.py:95: save_team_scoped_state (team projection) — NOT a raw save, so a
1265
- // multi-team workspace keeps the other teams' persisted runtime state instead of being clobbered.
1266
- crate::state::repository::StateRepository::new(workspace).save(
1267
- crate::state::repository::StateWriteIntent::StopAgent {
1268
- team_key: &team_key,
1269
- agent_id: agent_id.as_str(),
1270
- },
1271
- &state,
1272
- )
1273
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1274
- // golden operations.py:96-99: snapshot (side-effect), then state_file = write_team_state path.
1275
- // Foundation-0 F0-2: legacy per-session snapshot dual-write retired
1276
- // (`.team/artifacts/foundation-0-slice-design.md` §§4-5). Root state
1277
- // remains the only save target on the stop path.
1278
- let state_file = write_team_state(spec_workspace, &spec, &state)?;
1279
- write_stop_complete_event(workspace, agent_id, &target_str, stopped)?;
1280
- Ok(StopAgentReport {
1281
- agent_id: agent_id.clone(),
1282
- target: target_str,
1283
- stopped,
1284
- display_closed: true,
1285
- state_file,
1286
- })
1287
- }
1288
-
1289
- /// ---
1290
- /// purpose: 取团队作用域的投影 state,把选择拒绝转成带原因的错误
1291
- /// params:
1292
- /// team: 目标团队,None 时按唯一性选
1293
- /// returns: 投影后的 state
1294
- /// errors: 目标歧义或选不出时返回 TeamSelect 并在消息里带原因与细节,读取失败返回 StatePersist
1295
- /// ---
1296
- /// golden `resolve_team_scoped_state` (state.py:243): returns the team-scoped projected state, or
1297
- /// surfaces the refusal dict (`team_target_ambiguous` / `team_target_unresolved`) as a typed error
1298
- /// BEFORE the owner gate / unknown-worker raise (operations.py:64-66). The lifecycle return types are
1299
- /// typed structs with no refusal-Value variant, so the observable refusal is carried in
1300
- /// `LifecycleError::TeamSelect`'s message (reason + error), which is the closest byte-faithful surface.
1301
- pub(super) fn resolve_team_scoped_state_or_refuse(
1302
- workspace: &Path,
1303
- team: Option<&str>,
1304
- ) -> Result<serde_json::Value, LifecycleError> {
1305
- let (state, refusal) = crate::state::projection::resolve_team_scoped_state(workspace, team)
1306
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1307
- if let Some(refusal) = refusal {
1308
- let reason = refusal
1309
- .get("reason")
1310
- .and_then(|v| v.as_str())
1311
- .unwrap_or("team_target_unresolved");
1312
- let detail = refusal
1313
- .get("error")
1314
- .or_else(|| refusal.get("message"))
1315
- .and_then(|v| v.as_str())
1316
- .unwrap_or("");
1317
- return Err(LifecycleError::TeamSelect(format!("{reason}: {detail}")));
1318
- }
1319
- state.ok_or_else(|| {
1320
- LifecycleError::StatePersist("resolve_team_scoped_state returned no state".to_string())
1321
- })
1322
- }
1323
-
1324
- pub(super) fn mark_agent_started(
1325
- state: &mut serde_json::Value,
1326
- agent_id: &AgentId,
1327
- window: &str,
1328
- spawn: &SpawnedAgentWindow,
1329
- transport: &dyn crate::transport::Transport,
1330
- safety: &DangerousApproval,
1331
- start_mode: StartMode,
1332
- ) -> Result<(), LifecycleError> {
1333
- let Some(agent) = state
1334
- .get_mut("agents")
1335
- .and_then(serde_json::Value::as_object_mut)
1336
- .and_then(|agents| agents.get_mut(agent_id.as_str()))
1337
- .and_then(serde_json::Value::as_object_mut)
1338
- else {
1339
- return Err(LifecycleError::StatePersist(format!(
1340
- "agent {} state is not an object",
1341
- agent_id
1342
- )));
1343
- };
1344
- // 0.5.32 (`.team/artifacts/restart-resumed-stale-activity-locate.md` §5):
1345
- // a successful new process cohort invalidates the per-agent
1346
- // turn/activity observation set. Do this before overwriting the
1347
- // lifecycle/topology fields so absence == UNKNOWN until the next
1348
- // coordinator tick or pane fallback produces a post-spawn observation.
1349
- clear_agent_runtime_activity_observation(agent);
1350
- // 0.5.66 bypass 单源 §2.6:fresh spawn 那一刻记录运行面 bypass 值,
1351
- // 供下一次 restart 的 Noop drift 挡板比较。
1352
- agent.insert(
1353
- "as_launched_dangerously_skip_permissions".to_string(),
1354
- serde_json::json!(safety.enabled),
1355
- );
1356
- // S1-CAPTURE-001 (0.4.8, CR M3 provider-agnostic): on a Fresh /
1357
- // FreshAfterMissingRollout start, the prior session's authoritative
1358
- // capture tuple MUST be cleared before persist_command_plan_state
1359
- // writes the new _pending_session_id. Otherwise old session_id +
1360
- // rollout_path coexist with new _pending_session_id and
1361
- // agent_session_complete returns true on the stale tuple — capture
1362
- // never re-binds to the new process, and any delivered token lands
1363
- // in the old transcript (the leader/unassigned mis-attribution seen
1364
- // in the gate evidence). This applies to all providers that resume:
1365
- // codex, claude, copilot. Reset_agent --discard-session already does
1366
- // this at common.rs:1144-1188; here we mirror it for start-agent /
1367
- // restart-agent fresh paths so the fresh-tuple invariant is global.
1368
- if matches!(
1369
- start_mode,
1370
- StartMode::Fresh | StartMode::FreshAfterMissingRollout
1371
- ) {
1372
- for field in [
1373
- "session_id",
1374
- "rollout_path",
1375
- "captured_at",
1376
- "captured_via",
1377
- "attribution_confidence",
1378
- "capture_state",
1379
- "attribution_ambiguous",
1380
- ] {
1381
- agent.remove(field);
1382
- }
1383
- }
1384
- agent.insert("status".to_string(), serde_json::json!("running"));
1385
- agent.insert("explicit_stop".to_string(), serde_json::Value::Bool(false));
1386
- agent.insert("agent_id".to_string(), serde_json::json!(agent_id.as_str()));
1387
- agent.insert("window".to_string(), serde_json::json!(window));
1388
- agent.insert(
1389
- "pane_id".to_string(),
1390
- serde_json::json!(spawn.spawn.pane_id.as_str()),
1391
- );
1392
- let pane_pid = spawn.spawn.child_pid.or_else(|| {
1393
- transport
1394
- .list_targets()
1395
- .unwrap_or_default()
1396
- .into_iter()
1397
- .find(|pane| pane.pane_id == spawn.spawn.pane_id)
1398
- .and_then(|pane| pane.pane_pid)
1399
- });
1400
- if let Some(pane_pid) = pane_pid {
1401
- agent.insert("pane_pid".to_string(), serde_json::json!(pane_pid));
1402
- } else {
1403
- agent.remove("pane_pid");
1404
- }
1405
- agent.insert(
1406
- "spawned_at".to_string(),
1407
- serde_json::json!(spawn.spawned_at.as_str()),
1408
- );
1409
- agent.insert(
1410
- "spawn_cwd".to_string(),
1411
- serde_json::json!(spawn.spawn_cwd.to_string_lossy().to_string()),
1412
- );
1413
- if let Some(path) = &spawn.mcp_config_path {
1414
- agent.insert("mcp_config".to_string(), serde_json::json!(path));
1415
- }
1416
- // 0.4.6 Stage 1+2: ensure spawn_epoch is present after every start.
1417
- // reset_agent_at_paths bumps it before start; non-reset starts
1418
- // initialise to 1 (or preserve existing) so capture/event paths can
1419
- // always dispatch on (team_key, agent_id, spawn_epoch, ...).
1420
- let preserved_epoch = agent
1421
- .get("spawn_epoch")
1422
- .and_then(serde_json::Value::as_u64)
1423
- .filter(|n| *n > 0);
1424
- agent.insert(
1425
- "spawn_epoch".to_string(),
1426
- serde_json::json!(preserved_epoch.unwrap_or(1)),
1427
- );
1428
- // Issue 2 (Round 3b gate review §6): persist the resolved owner_team_id
1429
- // so future restart/start cycles read it directly from the agent row.
1430
- if let Some(ref team_id) = spawn.owner_team_id {
1431
- if !team_id.is_empty() {
1432
- agent.insert("owner_team_id".to_string(), serde_json::json!(team_id));
1433
- }
1434
- }
1435
- crate::lifecycle::launch::persist_command_plan_state(agent, &spawn.plan, &spawn.profile_launch);
1436
- crate::lifecycle::launch::persist_effective_approval_policy(agent, safety);
1437
- if let Some(placement) = spawn.layout_placement.as_ref() {
1438
- agent.insert(
1439
- "layout_window".to_string(),
1440
- serde_json::json!(placement.layout_window.as_str()),
1441
- );
1442
- agent.insert(
1443
- "layout_index".to_string(),
1444
- serde_json::json!(placement.layout_index),
1445
- );
1446
- agent.insert(
1447
- "pane_index".to_string(),
1448
- serde_json::json!(placement.pane_index),
1449
- );
1450
- agent.insert(
1451
- "display".to_string(),
1452
- serde_json::json!({
1453
- "backend": "adaptive",
1454
- "status": "opened",
1455
- "window": placement.layout_window.as_str(),
1456
- "workspace_window": null,
1457
- "pane_id": spawn.spawn.pane_id.as_str(),
1458
- "pane_title": agent_id.as_str(),
1459
- "target": spawn.spawn.pane_id.as_str(),
1460
- "target_worker_session": spawn.spawn.session.as_str(),
1461
- "linked_session": null,
1462
- "leader_session": spawn.spawn.session.as_str(),
1463
- "display_session": null,
1464
- "fallback": null,
1465
- }),
1466
- );
1467
- }
1468
- agent.remove("startup_prompts");
1469
- agent.remove("startup_prompt_status");
1470
- agent.remove("startup_prompt_probe_epoch");
1471
- agent.remove("startup_prompt_probe_disabled_at");
1472
- Ok(())
1473
- }
1474
-
1475
- /// ---
1476
- /// purpose: 重置一席的对外入口
1477
- /// params:
1478
- /// discard_session: 必须为真,否则直接返回拒绝
1479
- /// returns: 重置结果,未显式丢弃会话时返回 Refused
1480
- /// errors: 选不到 team 返回 TeamSelect,其余透传实体实现
1481
- /// contract_id: lifecycle.reset_agent.entry
1482
- /// ---
1483
- /// `reset_agent(workspace, agent_id, discard_session, open_display, team)`
1484
- /// (`lifecycle/operations.py:102`)。discard + 重起;**未传 discard_session → 拒绝**。
1485
- pub fn reset_agent(
1486
- workspace: &Path,
1487
- agent_id: &AgentId,
1488
- discard_session: bool,
1489
- open_display: bool,
1490
- team: Option<&str>,
1491
- ) -> Result<ResetAgentOutcome, LifecycleError> {
1492
- if !discard_session {
1493
- return Ok(ResetAgentOutcome::Refused {
1494
- reason: ResetRefusal::DiscardSessionRequired,
1495
- });
1496
- }
1497
- let paths = lifecycle_paths(workspace, team)?;
1498
- let canonical_team = paths.canonical_team(team).map(str::to_string);
1499
- let team = canonical_team.as_deref();
1500
- let _lock = acquire_agent_lifecycle_lock(LifecycleLockRequest {
1501
- workspace: &paths.run_workspace,
1502
- operation: "reset-agent",
1503
- team,
1504
- agent_id: Some(agent_id),
1505
- })?;
1506
- let transport = paths.tmux_backend()?;
1507
- reset_agent_at_paths(
1508
- &paths.run_workspace,
1509
- &paths.spec_workspace,
1510
- agent_id,
1511
- discard_session,
1512
- open_display,
1513
- team,
1514
- &transport,
1515
- )
1516
- }
1517
-
1518
- /// ---
1519
- /// purpose: 带注入 transport 的重置入口
1520
- /// params:
1521
- /// discard_session: 必须为真,否则直接返回拒绝
1522
- /// returns: 重置结果
1523
- /// errors: 同 reset_agent
1524
- /// contract_id: lifecycle.reset_agent.entry
1525
- /// ---
1526
- pub(crate) fn reset_agent_with_transport(
1527
- workspace: &Path,
1528
- agent_id: &AgentId,
1529
- discard_session: bool,
1530
- open_display: bool,
1531
- team: Option<&str>,
1532
- transport: &dyn crate::transport::Transport,
1533
- ) -> Result<ResetAgentOutcome, LifecycleError> {
1534
- if !discard_session {
1535
- return Ok(ResetAgentOutcome::Refused {
1536
- reason: ResetRefusal::DiscardSessionRequired,
1537
- });
1538
- }
1539
- let paths = lifecycle_paths(workspace, team)?;
1540
- let canonical_team = paths.canonical_team(team).map(str::to_string);
1541
- let team = canonical_team.as_deref();
1542
- let _lock = acquire_agent_lifecycle_lock(LifecycleLockRequest {
1543
- workspace: &paths.run_workspace,
1544
- operation: "reset-agent",
1545
- team,
1546
- agent_id: Some(agent_id),
1547
- })?;
1548
- reset_agent_at_paths(
1549
- &paths.run_workspace,
1550
- &paths.spec_workspace,
1551
- agent_id,
1552
- discard_session,
1553
- open_display,
1554
- team,
1555
- transport,
1556
- )
1557
- }
1558
-
1559
- fn reset_agent_at_paths(
1560
- workspace: &Path,
1561
- spec_workspace: &Path,
1562
- agent_id: &AgentId,
1563
- discard_session: bool,
1564
- open_display: bool,
1565
- team: Option<&str>,
1566
- transport: &dyn crate::transport::Transport,
1567
- ) -> Result<ResetAgentOutcome, LifecycleError> {
1568
- if !discard_session {
1569
- return Ok(ResetAgentOutcome::Refused {
1570
- reason: ResetRefusal::DiscardSessionRequired,
1571
- });
1572
- }
1573
- // golden operations.py:105-110: team-scope resolve + owner gate BEFORE the nested stop.
1574
- let state_before_stop = resolve_team_scoped_state_or_refuse(workspace, team)?;
1575
- let discarded_session_id = state_before_stop
1576
- .get("agents")
1577
- .and_then(|v| v.get(agent_id.as_str()))
1578
- .and_then(|v| v.get("session_id"))
1579
- .and_then(|v| v.as_str())
1580
- .filter(|session| !session.is_empty())
1581
- .map(SessionId::new);
1582
- crate::lifecycle::launch::ensure_owner_allowed_for_state(&state_before_stop, Some(agent_id))?;
1583
- // Capture old pane_id / pane_pid / window BEFORE stop, so the hard gate
1584
- // below can prove the same prior instance is gone (or refuse start).
1585
- let old_pane_id_before = state_before_stop
1586
- .get("agents")
1587
- .and_then(|v| v.get(agent_id.as_str()))
1588
- .and_then(|v| v.get("pane_id"))
1589
- .and_then(|v| v.as_str())
1590
- .filter(|p| !p.is_empty())
1591
- .map(crate::transport::PaneId::new);
1592
- let old_pane_pid_before = state_pane_pid(&state_before_stop, agent_id);
1593
- let old_pane_live_before = old_pane_id_before
1594
- .as_ref()
1595
- .map(|pane| agent_pane_live_by_id(transport, pane))
1596
- .unwrap_or(false);
1597
- // CR C-2: take ONE pre-stop snapshot of the team session's panes so
1598
- // the gate below can compute "what survived stop" by set difference,
1599
- // not "what panes exist at all" (which would refuse legitimate
1600
- // reset flows where stop killed the pane and the post-stop snapshot
1601
- // includes that same pane id in a transport mock that does not
1602
- // reflect kill removal).
1603
- let pre_stop_window = state_before_stop
1604
- .get("agents")
1605
- .and_then(|v| v.get(agent_id.as_str()))
1606
- .and_then(|v| v.get("window"))
1607
- .and_then(|v| v.as_str())
1608
- .filter(|s| !s.is_empty())
1609
- .unwrap_or_else(|| agent_id.as_str())
1610
- .to_string();
1611
- let pre_stop_spec = load_team_spec(spec_workspace).ok();
1612
- let pre_stop_session = pre_stop_spec
1613
- .as_ref()
1614
- .map(|spec| state_session_name_from_spec(&state_before_stop, spec));
1615
- let pre_stop_pane_ids: std::collections::BTreeSet<String> =
1616
- if let Some(session) = pre_stop_session.as_ref() {
1617
- if is_per_agent_window(&pre_stop_window, agent_id) {
1618
- list_same_role_panes(transport, session, &pre_stop_window)
1619
- .into_iter()
1620
- .filter(|pane| {
1621
- if !old_pane_live_before {
1622
- return true;
1623
- }
1624
- let same_old_pane = old_pane_id_before
1625
- .as_ref()
1626
- .is_some_and(|old| pane.pane_id.as_str() == old.as_str());
1627
- let same_old_pid = old_pane_pid_before
1628
- .is_some_and(|old_pid| pane.pane_pid == Some(old_pid));
1629
- same_old_pane || same_old_pid
1630
- })
1631
- .map(|p| p.pane_id.as_str().to_string())
1632
- .collect()
1633
- } else {
1634
- std::collections::BTreeSet::new()
1635
- }
1636
- } else {
1637
- std::collections::BTreeSet::new()
1638
- };
1639
- let stop = stop_agent_at_paths(workspace, spec_workspace, agent_id, team, transport)?;
1640
-
1641
- // 0.4.10+ paused agent skip: a paused agent's start path returns
1642
- // StartAgentOutcome::Paused (no spawn). There is no duplicate-window
1643
- // hazard, so the gate is a no-op for paused agents.
1644
- let agent_is_paused = state_before_stop
1645
- .get("agents")
1646
- .and_then(|v| v.get(agent_id.as_str()))
1647
- .and_then(|v| v.get("paused"))
1648
- .and_then(|v| v.as_bool())
1649
- .unwrap_or(false);
1650
- // 0.4.10+ reset duplicate-window fix (plan §3): HARD GATE before start.
1651
- // After stop_agent_at_paths returns, prove the old instance is gone OR
1652
- // refuse to spawn. The pre-fix path unconditionally proceeded to
1653
- // discard/save/start even when stop returned stopped=false (stop's
1654
- // pane_id was stale), creating the observed duplicate-window pattern.
1655
- //
1656
- // Residue definition (correct: differential, not absolute):
1657
- // A pane is RESIDUE iff it appears in BOTH the pre-stop snapshot
1658
- // AND the post-stop snapshot. The pre-fix attempt used "any
1659
- // matching pane exists post-stop" which broke legitimate flows
1660
- // where the transport mock does not model kill_pane removal.
1661
- //
1662
- // Old pane id / pid checks:
1663
- // The OLD stored pane_id / pane_pid must be gone (not just
1664
- // reachable but actually killed). For real tmux this is the
1665
- // structural truth source; for mocks the differential approach
1666
- // above covers the post-stop visibility.
1667
- //
1668
- // CR C-5: gate is reset-specific; standalone stop-agent path keeps
1669
- // existing "already absent is ok" behavior.
1670
- //
1671
- // P0 cohort proof: every non-paused reset takes a post-stop
1672
- // same-role snapshot. Refuse only on tmux-visible residue; a
1673
- // standalone old-pane liveness probe can be stale in mocks and
1674
- // must not mask the later spawn ownership/window-disappeared
1675
- // verifier.
1676
- if !agent_is_paused {
1677
- let spec_for_gate = load_team_spec(spec_workspace)?;
1678
- let gate_state = resolve_team_scoped_state_or_refuse(workspace, team)?;
1679
- let session_name_gate = state_session_name_from_spec(&gate_state, &spec_for_gate);
1680
- let gate_window = gate_state
1681
- .get("agents")
1682
- .and_then(|v| v.get(agent_id.as_str()))
1683
- .and_then(|v| v.get("window"))
1684
- .and_then(|v| v.as_str())
1685
- .filter(|s| !s.is_empty())
1686
- .unwrap_or_else(|| agent_id.as_str())
1687
- .to_string();
1688
- // Take a SECOND snapshot post-stop and compute the differential.
1689
- // Only panes present in BOTH snapshots are residue (stop did not
1690
- // remove them).
1691
- let post_stop_panes: Vec<crate::transport::PaneInfo> =
1692
- if is_per_agent_window(&gate_window, agent_id) {
1693
- list_same_role_panes(transport, &session_name_gate, &gate_window)
1694
- } else {
1695
- Vec::new()
1696
- };
1697
- let remaining_panes: Vec<crate::transport::PaneInfo> = post_stop_panes
1698
- .into_iter()
1699
- .filter(|p| pre_stop_pane_ids.contains(p.pane_id.as_str()))
1700
- .collect();
1701
- // Pid-alone aliveness is secondary evidence and noisy under
1702
- // fixtures. Block only on tmux-visible same-role residue; record
1703
- // the old pid in the event for diagnostics.
1704
- if !remaining_panes.is_empty() {
1705
- let remaining_pane_ids: Vec<String> = remaining_panes
1706
- .iter()
1707
- .map(|p| p.pane_id.as_str().to_string())
1708
- .collect();
1709
- let old_pane_str = old_pane_id_before
1710
- .as_ref()
1711
- .map(|p| p.as_str().to_string())
1712
- .unwrap_or_default();
1713
- let old_pid_val = old_pane_pid_before.unwrap_or(0);
1714
- let _ = write_reset_stop_not_proven_event(
1715
- workspace,
1716
- agent_id,
1717
- &old_pane_str,
1718
- old_pid_val,
1719
- &remaining_pane_ids,
1720
- );
1721
- // CR C-1 N38 three-line error: error / action / log_hint.
1722
- let _ = stop; // silence unused on the refusal path
1723
- return Err(LifecycleError::RequirementUnmet(format!(
1724
- "reset refused: old agent instance still live for {agent_id}\n\
1725
- action: stop the worker manually with `team-agent stop-agent {agent_id} --team <team>` then retry reset, or kill the residual tmux panes [{ids}]\n\
1726
- log_hint: see reset_agent.stop_not_proven event (old_pane_id={old}, old_pane_pid={pid}, remaining_panes=[{ids}])",
1727
- agent_id = agent_id.as_str(),
1728
- ids = remaining_pane_ids.join(", "),
1729
- old = old_pane_str,
1730
- pid = old_pid_val,
1731
- )));
1732
- }
1733
- }
1734
-
1735
- let mut state = resolve_team_scoped_state_or_refuse(workspace, team)?;
1736
- let spec = load_team_spec(spec_workspace)?;
1737
- discard_agent_session_fields(&mut state, agent_id)?;
1738
- // 0.4.6 Stage 1: bump spawn_epoch on every reset. The new epoch is
1739
- // visible to subsequent capture/event/status paths so they can
1740
- // attribute observations to the current process cohort (not a stale
1741
- // prior fresh attempt).
1742
- let new_epoch = next_spawn_epoch(&state, agent_id);
1743
- if let Some(obj) = state
1744
- .get_mut("agents")
1745
- .and_then(serde_json::Value::as_object_mut)
1746
- .and_then(|agents| agents.get_mut(agent_id.as_str()))
1747
- .and_then(serde_json::Value::as_object_mut)
1748
- {
1749
- obj.insert("spawn_epoch".to_string(), serde_json::json!(new_epoch));
1750
- obj.insert("explicit_stop".to_string(), serde_json::Value::Bool(false));
1751
- }
1752
- let team_key = restart_projection_team_key(&state, team);
1753
- sync_restart_team_projections(&mut state, &team_key);
1754
- // golden operations.py (reset): save_team_scoped_state on the team projection — same multi-team
1755
- // preservation as stop, not a raw save_runtime_state.
1756
- crate::state::repository::StateRepository::new(workspace).save(
1757
- crate::state::repository::StateWriteIntent::ResetAgent {
1758
- team_key: &team_key,
1759
- agent_id: agent_id.as_str(),
1760
- discard_session,
1761
- },
1762
- &state,
1763
- )
1764
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1765
- // golden operations.py:125: write_team_state after the discard-save (the intermediate stopped snapshot).
1766
- write_team_state(spec_workspace, &spec, &state)?;
1767
- write_reset_tombstone_event(
1768
- workspace,
1769
- agent_id,
1770
- discarded_session_id
1771
- .as_ref()
1772
- .map(SessionId::as_str)
1773
- .unwrap_or(""),
1774
- )?;
1775
- let start = start_agent_at_paths(
1776
- workspace,
1777
- spec_workspace,
1778
- agent_id,
1779
- true,
1780
- open_display,
1781
- true,
1782
- team,
1783
- transport,
1784
- )?;
1785
- let started = matches!(start, StartAgentOutcome::Running { .. });
1786
- write_reset_complete_event(workspace, agent_id, stop.stopped, started)?;
1787
- let (capture_state, reset_proof, weak_reset_warning) =
1788
- reset_capture_proof(workspace, agent_id, discarded_session_id.as_ref());
1789
- match start {
1790
- StartAgentOutcome::Running {
1791
- env,
1792
- start_mode,
1793
- session_id,
1794
- new_session_id,
1795
- ..
1796
- } => {
1797
- let output_session_id = if matches!(
1798
- start_mode,
1799
- StartMode::Fresh | StartMode::FreshAfterMissingRollout
1800
- ) {
1801
- new_session_id.clone().or(session_id)
1802
- } else {
1803
- session_id
1804
- };
1805
- Ok(ResetAgentOutcome::Reset {
1806
- env,
1807
- start_mode,
1808
- discarded_session_id,
1809
- session_id: output_session_id,
1810
- new_session_id,
1811
- capture_state,
1812
- reset_proof,
1813
- weak_reset_warning,
1814
- })
1815
- }
1816
- StartAgentOutcome::Noop { env, .. } => Ok(ResetAgentOutcome::Reset {
1817
- env,
1818
- start_mode: StartMode::Noop,
1819
- discarded_session_id,
1820
- session_id: None,
1821
- new_session_id: None,
1822
- capture_state,
1823
- reset_proof,
1824
- weak_reset_warning,
1825
- }),
1826
- StartAgentOutcome::Paused { .. } => Ok(ResetAgentOutcome::Reset {
1827
- env: AgentActionEnvelope {
1828
- agent_id: agent_id.clone(),
1829
- state_file: crate::state::persist::runtime_state_path(workspace),
1830
- coordinator_started: false,
1831
- },
1832
- start_mode: StartMode::Noop,
1833
- discarded_session_id,
1834
- session_id: None,
1835
- new_session_id: None,
1836
- capture_state,
1837
- reset_proof,
1838
- weak_reset_warning,
1839
- }),
1840
- }
1841
- }
1842
-
1843
- fn reset_capture_proof(
1844
- workspace: &Path,
1845
- agent_id: &AgentId,
1846
- discarded_session_id: Option<&SessionId>,
1847
- ) -> (String, String, Option<String>) {
1848
- let state = crate::state::persist::load_runtime_state(workspace)
1849
- .unwrap_or_else(|_| serde_json::json!({}));
1850
- let agent = state
1851
- .get("agents")
1852
- .and_then(|agents| agents.get(agent_id.as_str()));
1853
- let capture_state = agent
1854
- .and_then(|agent| agent.get("capture_state"))
1855
- .and_then(serde_json::Value::as_str)
1856
- .filter(|value| !value.is_empty())
1857
- .or_else(|| {
1858
- agent
1859
- .and_then(|agent| agent.get("attribution_ambiguous"))
1860
- .and_then(serde_json::Value::as_bool)
1861
- .filter(|ambiguous| *ambiguous)
1862
- .map(|_| "attribution_ambiguous")
1863
- })
1864
- .or_else(|| {
1865
- let has_session = agent
1866
- .and_then(|agent| agent.get("session_id"))
1867
- .and_then(serde_json::Value::as_str)
1868
- .is_some_and(|value| !value.is_empty());
1869
- let has_rollout = agent
1870
- .and_then(|agent| agent.get("rollout_path"))
1871
- .and_then(serde_json::Value::as_str)
1872
- .is_some_and(|value| !value.is_empty());
1873
- (has_session && has_rollout).then_some("captured")
1874
- })
1875
- .unwrap_or("transcript_missing")
1876
- .to_string();
1877
- let weak = discarded_session_id.is_none()
1878
- || matches!(
1879
- capture_state.as_str(),
1880
- "transcript_missing" | "attribution_ambiguous"
1881
- );
1882
- let reset_proof = if weak { "weak" } else { "strong" }.to_string();
1883
- let weak_reset_warning = weak.then(|| {
1884
- format!(
1885
- "weak reset proof: capture_state={capture_state}; lifecycle restarted but attribution did not prove a fresh transcript"
1886
- )
1887
- });
1888
- (capture_state, reset_proof, weak_reset_warning)
1889
- }
1890
-
1891
- #[allow(clippy::too_many_arguments)]
1892
- fn write_start_agent_start_event(
1893
- workspace: &Path,
1894
- agent_id: &AgentId,
1895
- agent: &serde_json::Value,
1896
- spawn_plan: &crate::provider::CommandPlan,
1897
- provider: crate::provider::Provider,
1898
- start_mode: StartMode,
1899
- session_name: &SessionName,
1900
- window: &str,
1901
- session_id: Option<&SessionId>,
1902
- tmux_start_mode: &'static str,
1903
- ) -> Result<(), LifecycleError> {
1904
- crate::event_log::EventLog::new(workspace)
1905
- .write(
1906
- "start_agent.agent_start",
1907
- serde_json::json!({
1908
- "agent_id": agent_id.as_str(),
1909
- "provider": provider_wire(provider),
1910
- "start_mode": start_mode,
1911
- "session_id": session_id.map(|s| s.as_str()),
1912
- "session": session_name.as_str(),
1913
- "window": window,
1914
- "tmux_start_mode": tmux_start_mode,
1915
- "command": spawn_plan.argv,
1916
- "mcp_config": agent.get("mcp_config").cloned().unwrap_or(serde_json::Value::Null),
1917
- }),
1918
- )
1919
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1920
- Ok(())
1921
- }
1922
-
1923
- fn write_stop_complete_event(
1924
- workspace: &Path,
1925
- agent_id: &AgentId,
1926
- target: &str,
1927
- stopped: bool,
1928
- ) -> Result<(), LifecycleError> {
1929
- crate::event_log::EventLog::new(workspace)
1930
- .write(
1931
- "stop_agent.complete",
1932
- serde_json::json!({
1933
- "agent_id": agent_id.as_str(),
1934
- "target": target,
1935
- "stopped": stopped,
1936
- }),
1937
- )
1938
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1939
- Ok(())
1940
- }
1941
-
1942
- /// ---
1943
- /// purpose: 写一条停席排空证据事件
1944
- /// params:
1945
- /// target: 被停的目标描述
1946
- /// drain: 排空证据载荷,其字段被并进事件顶层
1947
- /// returns: 成功返回空值
1948
- /// errors: 事件写入失败时返回 StatePersist
1949
- /// ---
1950
- /// 0.4.6 Stage 1: drain evidence for the old pane+pid after stop. Fires
1951
- /// during reset/stop so operators can see whether the prior worker really
1952
- /// went away or stuck around inside the resp budget.
1953
- pub(super) fn write_stop_drain_event(
1954
- workspace: &Path,
1955
- agent_id: &AgentId,
1956
- target: &str,
1957
- drain: &serde_json::Value,
1958
- ) -> Result<(), LifecycleError> {
1959
- let mut payload = serde_json::Map::new();
1960
- payload.insert("agent_id".to_string(), serde_json::json!(agent_id.as_str()));
1961
- payload.insert("target".to_string(), serde_json::json!(target));
1962
- if let Some(obj) = drain.as_object() {
1963
- for (k, v) in obj {
1964
- payload.insert(k.clone(), v.clone());
1965
- }
1966
- }
1967
- crate::event_log::EventLog::new(workspace)
1968
- .write("stop_agent.drain", serde_json::Value::Object(payload))
1969
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1970
- Ok(())
1971
- }
1972
-
1973
- fn write_stop_window_failed_event(
1974
- workspace: &Path,
1975
- agent_id: &AgentId,
1976
- target: &str,
1977
- stderr: &str,
1978
- ) -> Result<(), LifecycleError> {
1979
- crate::event_log::EventLog::new(workspace)
1980
- .write(
1981
- "stop_agent.window_stop_failed",
1982
- serde_json::json!({
1983
- "agent_id": agent_id.as_str(),
1984
- "target": target,
1985
- "stderr": stderr,
1986
- }),
1987
- )
1988
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
1989
- Ok(())
1990
- }
1991
-
1992
- fn write_reset_tombstone_event(
1993
- workspace: &Path,
1994
- agent_id: &AgentId,
1995
- discarded_session_id: &str,
1996
- ) -> Result<(), LifecycleError> {
1997
- crate::event_log::EventLog::new(workspace)
1998
- .write(
1999
- "discard.session_tombstone",
2000
- serde_json::json!({
2001
- "agent_id": agent_id.as_str(),
2002
- "discarded_session_id": discarded_session_id,
2003
- }),
2004
- )
2005
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
2006
- Ok(())
2007
- }
2008
-
2009
- /// 0.4.10+ reset duplicate-window fix (plan §3): emit a structured event
2010
- /// when the reset hard gate refuses to start because the old instance is
2011
- /// proven still live (old pane id reachable, old pane pid alive, or
2012
- /// same-role panes remain in the team session).
2013
- fn write_reset_stop_not_proven_event(
2014
- workspace: &Path,
2015
- agent_id: &AgentId,
2016
- old_pane_id: &str,
2017
- old_pane_pid: u32,
2018
- remaining_panes: &[String],
2019
- ) -> Result<(), LifecycleError> {
2020
- crate::event_log::EventLog::new(workspace)
2021
- .write(
2022
- "reset_agent.stop_not_proven",
2023
- serde_json::json!({
2024
- "agent_id": agent_id.as_str(),
2025
- "old_pane_id": old_pane_id,
2026
- "old_pane_pid": old_pane_pid,
2027
- "remaining_panes": remaining_panes,
2028
- "action": "stop the worker manually then retry reset, or kill the residual tmux panes",
2029
- }),
2030
- )
2031
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
2032
- Ok(())
2033
- }
2034
-
2035
- fn write_reset_complete_event(
2036
- workspace: &Path,
2037
- agent_id: &AgentId,
2038
- stopped: bool,
2039
- started: bool,
2040
- ) -> Result<(), LifecycleError> {
2041
- crate::event_log::EventLog::new(workspace)
2042
- .write(
2043
- "reset_agent.complete",
2044
- serde_json::json!({
2045
- "agent_id": agent_id.as_str(),
2046
- "stopped": stopped,
2047
- "started": started,
2048
- }),
2049
- )
2050
- .map_err(|e| LifecycleError::StatePersist(e.to_string()))?;
2051
- Ok(())
2052
- }
2053
-
2054
- /// 0.5.66 bypass 单源 §2.6:声明面(file)与运行面(as-launched)是否 drift。
2055
- /// 缺 as-launched(从未 spawn)= 视为未启动,不 drift(首次 Noop 无进程可比)。
2056
- fn check_bypass_drift(file: Option<bool>, launched: Option<bool>) -> bool {
2057
- match (file, launched) {
2058
- (Some(file), Some(launched)) => file != launched,
2059
- _ => false,
2060
- }
2061
- }
2062
-
2063
- #[cfg(test)]
2064
-
2065
- #[cfg(test)]
2066
- mod tests {
2067
- use super::*;
2068
-
2069
- #[test]
2070
- fn e51_restart_allows_leader_same_pane_id_on_different_tmux_sockets() {
2071
- let state = serde_json::json!({
2072
- "tmux_endpoint": "/private/tmp/tmux-501/ta-worker",
2073
- "leader_receiver": {
2074
- "pane_id": "%0",
2075
- "tmux_socket": "/private/tmp/tmux-501/default"
2076
- },
2077
- "agents": {
2078
- "architect": {
2079
- "pane_id": "%0",
2080
- "tmux_socket": "/private/tmp/tmux-501/ta-worker"
2081
- }
2082
- }
2083
- });
2084
- let agent_id = AgentId::new("architect");
2085
- let agent = state["agents"]["architect"].clone();
2086
-
2087
- assert!(
2088
- !pane_conflicts_with_leader_or_other(&state, &agent_id, &agent),
2089
- "same pane id on different tmux sockets must not force a fresh restart"
2090
- );
2091
- }
2092
-
2093
- #[test]
2094
- fn e51_restart_keeps_leader_conflict_on_same_tmux_socket() {
2095
- let socket = "/private/tmp/tmux-501/default";
2096
- let state = serde_json::json!({
2097
- "tmux_endpoint": socket,
2098
- "leader_receiver": {
2099
- "pane_id": "%0",
2100
- "tmux_socket": socket
2101
- },
2102
- "agents": {
2103
- "architect": {
2104
- "pane_id": "%0",
2105
- "tmux_socket": socket
2106
- }
2107
- }
2108
- });
2109
- let agent_id = AgentId::new("architect");
2110
- let agent = state["agents"]["architect"].clone();
2111
-
2112
- assert!(
2113
- pane_conflicts_with_leader_or_other(&state, &agent_id, &agent),
2114
- "same pane id on the same tmux socket must keep the E51 guard"
2115
- );
2116
- }
2117
-
2118
- #[test]
2119
- fn e51_restart_allows_other_agent_same_pane_id_on_different_tmux_sockets() {
2120
- let state = serde_json::json!({
2121
- "tmux_endpoint": "/private/tmp/tmux-501/ta-worker",
2122
- "agents": {
2123
- "architect": {
2124
- "pane_id": "%0",
2125
- "tmux_socket": "/private/tmp/tmux-501/ta-worker"
2126
- },
2127
- "reviewer": {
2128
- "pane_id": "%0",
2129
- "tmux_socket": "/private/tmp/tmux-501/default"
2130
- }
2131
- }
2132
- });
2133
- let agent_id = AgentId::new("architect");
2134
- let agent = state["agents"]["architect"].clone();
2135
-
2136
- assert!(
2137
- !pane_conflicts_with_leader_or_other(&state, &agent_id, &agent),
2138
- "other-agent collision checks must also include tmux_socket"
2139
- );
2140
- }
2141
-
2142
- #[test]
2143
- fn e51_restart_rejects_discovered_peer_pane_for_stale_worker() {
2144
- let socket = "/private/tmp/tmux-501/ta-worker";
2145
- let state = serde_json::json!({
2146
- "tmux_endpoint": socket,
2147
- "agents": {
2148
- "worker": {"pane_id": "%1", "status": "running"},
2149
- "peer": {"pane_id": "%0", "status": "running"}
2150
- }
2151
- });
2152
- let agent_id = AgentId::new("worker");
2153
- let agent = state["agents"]["worker"].clone();
2154
-
2155
- assert!(
2156
- pane_conflicts_with_pane_id(&state, &agent_id, &agent, "%0"),
2157
- "a discovered live pane owned by a running peer must not be rebound"
2158
- );
2159
- }
2160
-
2161
- #[test]
2162
- fn e51_restart_ignores_stopped_peer_pane_residue() {
2163
- let socket = "/private/tmp/tmux-501/ta-worker";
2164
- let state = serde_json::json!({
2165
- "tmux_endpoint": socket,
2166
- "agents": {
2167
- "worker": {"pane_id": "%1", "status": "running"},
2168
- "peer": {"pane_id": "%0", "status": "stopped"}
2169
- }
2170
- });
2171
- let agent_id = AgentId::new("worker");
2172
- let agent = state["agents"]["worker"].clone();
2173
-
2174
- assert!(
2175
- !pane_conflicts_with_pane_id(&state, &agent_id, &agent, "%0"),
2176
- "stopped peer residue must not claim a pane for a live restart"
2177
- );
2178
- }
2179
-
2180
- // 0.5.66 bypass 单源 §4.1:Noop drift 检测——声明面与运行面不一致 → drift。
2181
- #[test]
2182
- fn test_restart_noop_denied_on_drift() {
2183
- // file=true, launched=false → drift(改了 md 升 bypass 但进程没带)。
2184
- assert!(check_bypass_drift(Some(true), Some(false)));
2185
- // file=false, launched=true → drift(改了 md 撤 bypass 但进程还带着)。
2186
- assert!(check_bypass_drift(Some(false), Some(true)));
2187
- }
2188
-
2189
- // 0.5.66 bypass 单源 §4.1:无 drift 或从未 spawn(as-launched 缺)→ 不拒。
2190
- #[test]
2191
- fn test_restart_fresh_spawn_after_drift_uses_file_value() {
2192
- assert!(!check_bypass_drift(Some(true), Some(true)));
2193
- assert!(!check_bypass_drift(Some(false), Some(false)));
2194
- // 从未 spawn:as-launched 缺失 → 不 drift(首次 Noop 无进程可比)。
2195
- assert!(!check_bypass_drift(Some(true), None));
2196
- assert!(!check_bypass_drift(None, None));
2197
- }
2198
- }