@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,545 +0,0 @@
1
- //!
2
- //! Process lifecycle + snapshot + termination platform primitives.
3
- //!
4
- //! Batch 0 provides:
5
- //! - `Pid`, `SignalKind`, `ProcessLiveness`, `ProcessInfo`,
6
- //! `TerminationOutcome`
7
- //! - Unix impl: byte-equivalent to the current inline
8
- //! `libc::kill(pid, 0)` / `waitpid(WNOHANG)` / `ps -axo` logic (no
9
- //! caller migration in Batch 0)
10
- //! - Windows impl: `unimplemented!()` stubs annotated with the
11
- //! Windows API Batch 3 will use (`OpenProcess`,
12
- //! `GetExitCodeProcess`, `TerminateProcess`, Toolhelp snapshot,
13
- //! Job Objects for shim-owned worker teardown)
14
- //!
15
- //! CR C-6: `terminate_pid` returns `TerminationOutcome` so a caller
16
- //! that requested `TerminateGraceful`
17
- //! can see that Windows downgraded to `TerminateForce` and emit a
18
- //! `platform.terminate_force_only` event (N38 交底).
19
- //!
20
- //! CR C-4: this module is NOT importable from `messaging/`. Grep guard
21
- //! `platform_process_caller_whitelist_batch0.rs` enforces the boundary.
22
-
23
- use std::io;
24
-
25
- /// A native process id. Portable u32 for both Unix and Windows.
26
- #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
27
- pub struct Pid(pub u32);
28
-
29
- impl From<u32> for Pid {
30
- fn from(v: u32) -> Self {
31
- Self(v)
32
- }
33
- }
34
-
35
- /// Termination request kind. On Unix `TerminateGraceful` maps to
36
- /// `SIGTERM`, `TerminateForce` maps to `SIGKILL`. On Windows there is
37
- /// no grace period equivalent — see `TerminationOutcome::ForceOnly`.
38
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
39
- pub enum SignalKind {
40
- TerminateGraceful,
41
- TerminateForce,
42
- }
43
-
44
- /// Result of a `terminate_pid` call. `Graceful`
45
- /// means the OS honored the request kind; `ForceOnly` means Windows
46
- /// downgraded a `TerminateGraceful` to `TerminateProcess` (CR C-6
47
- /// N38 交底 — caller must emit a `platform.terminate_force_only`
48
- /// event).
49
- #[derive(Debug, Clone, PartialEq, Eq)]
50
- pub enum TerminationOutcome {
51
- /// Requested `SignalKind` was honored (Unix `SIGTERM`/`SIGKILL`
52
- /// or Windows console-control-event for owned console groups).
53
- Requested,
54
- /// Windows downgraded `TerminateGraceful` to `TerminateProcess`
55
- /// (no grace period). Includes a machine-readable reason so
56
- /// callers can log it in the audit event.
57
- ForceOnly { reason: &'static str },
58
- /// The pid was already gone by the time the call resolved.
59
- /// Not an error.
60
- AlreadyGone,
61
- }
62
-
63
- /// Live/Dead/Unknown liveness classification. `Unknown { reason }`
64
- /// covers the "we don't have OS permission to check" case + Windows
65
- /// paths that Batch 3 will fill in.
66
- #[derive(Debug, Clone, PartialEq, Eq)]
67
- pub enum ProcessLiveness {
68
- Live,
69
- Dead,
70
- Unknown { reason: String },
71
- }
72
-
73
- /// One row from a process snapshot. Fields that the OS does not
74
- /// expose (Windows has no `pgid`/`session` concept in the Unix sense)
75
- /// are `None`.
76
- #[derive(Debug, Clone, PartialEq, Eq)]
77
- pub struct ProcessInfo {
78
- pub pid: u32,
79
- pub ppid: Option<u32>,
80
- pub group_id: Option<u32>,
81
- pub session_id: Option<u32>,
82
- pub command: Option<String>,
83
- }
84
-
85
- // ─────────────────────────────────────────────────────────────────────
86
- // Unix implementation.
87
- //
88
- // Batch 0 populates these from the current inline logic in
89
- // `mcp_server/wire.rs`, `coordinator/backoff.rs`,
90
- // `lifecycle/restart/agent.rs`, `coordinator/health.rs`. No caller
91
- // migration yet — Batch 2/3 replaces the inline calls with these
92
- // wrappers. This ensures Unix behavior is byte-equivalent when the
93
- // migration lands.
94
- // ─────────────────────────────────────────────────────────────────────
95
-
96
- #[cfg(unix)]
97
- mod unix_impl {
98
- //! Byte-preserving Unix implementation. Every fn body is the
99
- //! current inline code from the callers (`coordinator/health.rs`,
100
- //! `cli/mod.rs`, `coordinator/backoff.rs`, `mcp_server/wire.rs`,
101
- //! `lifecycle/restart/agent.rs`) with zero behavioral drift.
102
- use super::*;
103
- use std::process::Command;
104
-
105
- pub fn current_parent_pid() -> Option<u32> {
106
- // Byte-equivalent to `mcp_server/wire.rs:319` and
107
- // `coordinator/backoff.rs:258` Unix branches.
108
- let raw = unsafe { libc::getppid() };
109
- u32::try_from(raw).ok()
110
- }
111
-
112
- pub fn current_process_group() -> Option<u32> {
113
- // Byte-equivalent to `cli/mod.rs:1708`.
114
- let raw = unsafe { libc::getpgrp() };
115
- u32::try_from(raw).ok()
116
- }
117
-
118
- pub fn pid_liveness(pid: u32) -> Result<ProcessLiveness, io::Error> {
119
- // Byte-equivalent to `lifecycle/restart/agent.rs::pid_is_alive`
120
- // (EPERM = Live because sender can't signal but process
121
- // exists). Callers get the same True/False split.
122
- let ret = unsafe { libc::kill(pid as i32, 0) };
123
- if ret == 0 {
124
- return Ok(ProcessLiveness::Live);
125
- }
126
- let err = io::Error::last_os_error();
127
- match err.raw_os_error() {
128
- Some(code) if code == libc::EPERM => Ok(ProcessLiveness::Live),
129
- Some(code) if code == libc::ESRCH => Ok(ProcessLiveness::Dead),
130
- _ => Err(err),
131
- }
132
- }
133
-
134
- /// Non-erroring convenience over `pid_liveness`. Returns `true`
135
- /// when the process is Live (or unknown-but-not-clearly-dead so
136
- /// callers behave conservatively), `false` when Dead.
137
- ///
138
- /// Byte-equivalent to `cli/mod.rs::process_is_live` +
139
- /// `coordinator/health.rs::pid_is_running` "signal_rc == 0 || EPERM"
140
- /// branch.
141
- pub fn pid_is_alive(pid: u32) -> bool {
142
- matches!(pid_liveness(pid), Ok(ProcessLiveness::Live))
143
- }
144
-
145
- pub fn process_snapshot() -> Result<Vec<ProcessInfo>, io::Error> {
146
- // Reserved for Batch 3 follow-up that migrates the `ps -axo
147
- // pid=,ppid=` shellouts in `coordinator/health.rs` and
148
- // `cli/mod.rs` here. Left as `Ok(Vec::new())` so downstream
149
- // callers can migrate incrementally in a future batch; keeping
150
- // the ps shellout at the callsites for now preserves the
151
- // exact current output-parsing byte-shape.
152
- Ok(Vec::new())
153
- }
154
-
155
- pub fn process_tree(root: u32) -> Result<Vec<u32>, io::Error> {
156
- let output = Command::new("ps").args(["-axo", "pid=,ppid="]).output()?;
157
- if !output.status.success() {
158
- return Err(io::Error::new(
159
- io::ErrorKind::Other,
160
- "ps_parent exited unsuccessfully",
161
- ));
162
- }
163
- let pairs = String::from_utf8_lossy(&output.stdout)
164
- .lines()
165
- .filter_map(|line| {
166
- let mut parts = line.split_whitespace();
167
- let pid = parts.next()?.parse::<u32>().ok()?;
168
- let ppid = parts.next()?.parse::<u32>().ok()?;
169
- Some((pid, ppid))
170
- })
171
- .collect::<Vec<_>>();
172
- let mut out = Vec::new();
173
- collect_child_pids(root, &pairs, &mut out);
174
- out.push(root);
175
- out.sort_unstable();
176
- out.dedup();
177
- Ok(out)
178
- }
179
-
180
- fn collect_child_pids(parent: u32, pairs: &[(u32, u32)], out: &mut Vec<u32>) {
181
- for (pid, ppid) in pairs {
182
- if *ppid == parent && !out.contains(pid) {
183
- out.push(*pid);
184
- collect_child_pids(*pid, pairs, out);
185
- }
186
- }
187
- }
188
-
189
- /// Send a SIGTERM (`TerminateGraceful`) or SIGKILL
190
- /// (`TerminateForce`) to `pid`. Byte-equivalent to the
191
- /// `libc::kill(pid, SIGTERM|SIGKILL)` shell-out inline at
192
- /// `coordinator/health.rs:280,284,731` + `cli/mod.rs:1848`.
193
- ///
194
- /// Unix always returns `TerminationOutcome::Requested` because
195
- /// `SIGTERM` is a real grace signal (Windows sees the C-6
196
- /// downgrade path); the `AlreadyGone` case is preserved when
197
- /// `kill()` returns ESRCH (the target was reaped between check
198
- /// and send).
199
- pub fn terminate_pid(pid: u32, kind: SignalKind) -> Result<TerminationOutcome, io::Error> {
200
- let signal = match kind {
201
- SignalKind::TerminateGraceful => libc::SIGTERM,
202
- SignalKind::TerminateForce => libc::SIGKILL,
203
- };
204
- let pid_t = match libc::pid_t::try_from(pid) {
205
- Ok(p) => p,
206
- Err(_) => return Ok(TerminationOutcome::AlreadyGone),
207
- };
208
- let rc = unsafe { libc::kill(pid_t, signal) };
209
- if rc == 0 {
210
- return Ok(TerminationOutcome::Requested);
211
- }
212
- let err = io::Error::last_os_error();
213
- match err.raw_os_error() {
214
- Some(code) if code == libc::ESRCH => Ok(TerminationOutcome::AlreadyGone),
215
- _ => Err(err),
216
- }
217
- }
218
-
219
- /// Best-effort waitpid so a killed child doesn't accumulate as a
220
- /// zombie. Byte-equivalent to `coordinator/health.rs:350-358` and
221
- /// `cli/mod.rs:1871-1879`.
222
- pub fn reap_child_if_possible(pid: u32) {
223
- let pid_t = match libc::pid_t::try_from(pid) {
224
- Ok(p) => p,
225
- Err(_) => return,
226
- };
227
- let mut status = 0;
228
- unsafe {
229
- // WNOHANG so we never block; if the child isn't ours
230
- // (ECHILD) libc quietly returns -1 which we ignore.
231
- libc::waitpid(pid_t, &mut status, libc::WNOHANG);
232
- }
233
- }
234
- }
235
-
236
- // ─────────────────────────────────────────────────────────────────────
237
- // Windows implementation.
238
- //
239
- // Batch 0 provides `unimplemented!()` stubs so `cargo check --target
240
- // x86_64-pc-windows-msvc` sees the module compile past the signature
241
- // boundary. The RED CI baseline comes from every failing file OUTSIDE
242
- // this module (tmux_backend, coordinator/health, cli/mod, state/persist,
243
- // lifecycle/restart/agent, mcp_server/wire, etc.) — Batches 1-4 will
244
- // remove those, and Batches 3/4 will implement the stubs below.
245
- // ─────────────────────────────────────────────────────────────────────
246
-
247
- #[cfg(not(unix))]
248
- mod windows_impl {
249
- //! Batch 3 real Windows implementation. Uses `OpenProcess` +
250
- //! `GetExitCodeProcess` for liveness (CR MUST-11 positive
251
- //! authority: kernel handle + typed status),
252
- //! `TerminateProcess(hProcess, 1)` for hard kill, Toolhelp
253
- //! snapshot for parent-pid discovery. **CR C-6 anchor**:
254
- //! `SignalKind::TerminateGraceful` maps to `TerminationOutcome::ForceOnly`
255
- //! because `TerminateProcess` has no grace period equivalent —
256
- //! callers use this signal to emit the `platform.terminate_force_only`
257
- //! N38 audit event so the semantic difference from
258
- //! Unix `SIGTERM` is visible in the event log rather than silent.
259
- use super::*;
260
-
261
- pub fn current_parent_pid() -> Option<u32> {
262
- use windows::Win32::System::Diagnostics::ToolHelp::{
263
- CreateToolhelp32Snapshot, Process32FirstW, Process32NextW, PROCESSENTRY32W,
264
- TH32CS_SNAPPROCESS,
265
- };
266
- use windows::Win32::System::Threading::GetCurrentProcessId;
267
- let my_pid = unsafe { GetCurrentProcessId() };
268
- let snapshot = unsafe { CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0) }.ok()?;
269
- let mut entry = PROCESSENTRY32W {
270
- dwSize: std::mem::size_of::<PROCESSENTRY32W>() as u32,
271
- ..Default::default()
272
- };
273
- let mut result = unsafe { Process32FirstW(snapshot, &mut entry) };
274
- while result.is_ok() {
275
- if entry.th32ProcessID == my_pid {
276
- let ppid = entry.th32ParentProcessID;
277
- unsafe {
278
- let _ = windows::Win32::Foundation::CloseHandle(snapshot);
279
- };
280
- return Some(ppid);
281
- }
282
- result = unsafe { Process32NextW(snapshot, &mut entry) };
283
- }
284
- unsafe {
285
- let _ = windows::Win32::Foundation::CloseHandle(snapshot);
286
- };
287
- None
288
- }
289
-
290
- pub fn current_process_group() -> Option<u32> {
291
- // Windows has no direct process-group equivalent. Job Objects
292
- // provide grouping semantics per shim/worker (design §Route B:
293
- // "owned worker teardown: prefer Job Objects in the ConPTY
294
- // shim so `kill_session` is exact"). Return `None` honestly so
295
- // caller code (cli/mod.rs::shutdown_protection_set) sees the
296
- // "no pgid to protect" branch — the current-PID protection
297
- // still applies via `current_process_id`.
298
- None
299
- }
300
-
301
- pub fn pid_liveness(pid: u32) -> Result<ProcessLiveness, io::Error> {
302
- use windows::Win32::Foundation::{CloseHandle, STILL_ACTIVE};
303
- use windows::Win32::System::Threading::{
304
- GetExitCodeProcess, OpenProcess, PROCESS_QUERY_LIMITED_INFORMATION,
305
- };
306
- // `OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION)` — minimal
307
- // access rights needed for `GetExitCodeProcess`.
308
- // MUST-11 positive authority: we own a real kernel handle.
309
- let handle = unsafe { OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, false, pid) };
310
- let handle = match handle {
311
- Ok(h) => h,
312
- Err(err) => {
313
- // Both raw Win32 error codes and their HRESULT
314
- // encodings (HRESULT_FROM_WIN32) are accepted so
315
- // future windows-crate API changes don't silently
316
- // break the code mapping.
317
- let raw = err.code().0 as u32;
318
- const ERROR_INVALID_PARAMETER: u32 = 87;
319
- const E_INVALIDARG_HRESULT: u32 = 0x80070057;
320
- const ERROR_ACCESS_DENIED: u32 = 5;
321
- const E_ACCESSDENIED_HRESULT: u32 = 0x80070005;
322
- if raw == ERROR_INVALID_PARAMETER || raw == E_INVALIDARG_HRESULT {
323
- return Ok(ProcessLiveness::Dead);
324
- }
325
- if raw == ERROR_ACCESS_DENIED || raw == E_ACCESSDENIED_HRESULT {
326
- return Ok(ProcessLiveness::Live);
327
- }
328
- return Err(io::Error::from_raw_os_error(err.code().0 as i32));
329
- }
330
- };
331
- let mut exit_code: u32 = 0;
332
- let result = unsafe { GetExitCodeProcess(handle, &mut exit_code) };
333
- unsafe {
334
- let _ = CloseHandle(handle);
335
- };
336
- result.map_err(|e| io::Error::from_raw_os_error(e.code().0 as i32))?;
337
- // `STILL_ACTIVE` (0x103) — the process is still running.
338
- if exit_code == STILL_ACTIVE.0 as u32 {
339
- Ok(ProcessLiveness::Live)
340
- } else {
341
- Ok(ProcessLiveness::Dead)
342
- }
343
- }
344
-
345
- /// Non-erroring convenience over `pid_liveness`. Windows mirrors
346
- /// the Unix behavior (Unknown branch reported conservatively as
347
- /// "not Live" so drain/reap don't loop forever).
348
- pub fn pid_is_alive(pid: u32) -> bool {
349
- matches!(pid_liveness(pid), Ok(ProcessLiveness::Live))
350
- }
351
-
352
- pub fn process_snapshot() -> Result<Vec<ProcessInfo>, io::Error> {
353
- // Reserved for Batch 3 follow-up. `CreateToolhelp32Snapshot`
354
- // + `Process32First`/`Process32Next` would populate this,
355
- // but the coordinator/health.rs + cli/mod.rs `ps -axo`
356
- // callers on Unix still parse a string table so we defer
357
- // that migration to a later batch to preserve the exact
358
- // wire shape today.
359
- Ok(Vec::new())
360
- }
361
-
362
- pub fn process_tree(_root: u32) -> Result<Vec<u32>, io::Error> {
363
- Ok(Vec::new())
364
- }
365
-
366
- pub fn terminate_pid(pid: u32, kind: SignalKind) -> Result<TerminationOutcome, io::Error> {
367
- use windows::Win32::Foundation::CloseHandle;
368
- use windows::Win32::System::Threading::{OpenProcess, TerminateProcess, PROCESS_TERMINATE};
369
- // CR C-6 anchor: Windows has no SIGTERM analogue for a
370
- // non-console child. `TerminateGraceful` cannot be honored;
371
- // we still perform the physical `TerminateProcess` (design
372
- // §Change-Induced Risks: "ConPTY shim should own Job Objects
373
- // to preserve precise worker teardown") but return
374
- // `ForceOnly` so callers emit `platform.terminate_force_only`
375
- // for the audit log.
376
- let handle = unsafe { OpenProcess(PROCESS_TERMINATE, false, pid) };
377
- let handle = match handle {
378
- Ok(h) => h,
379
- Err(err) => {
380
- // `err.code().0` is a HRESULT, not a raw Win32 error.
381
- // For Win32 errors it takes the form
382
- // `HRESULT_FROM_WIN32(win32)` = `0x8007<win32 low 16>`.
383
- // Accept BOTH the raw Win32 form (in case a future
384
- // windows-crate API returns it) and the HRESULT form.
385
- let raw = err.code().0 as u32;
386
- const ERROR_INVALID_PARAMETER: u32 = 87;
387
- const E_INVALIDARG_HRESULT: u32 = 0x80070057; // HRESULT_FROM_WIN32(87)
388
- if raw == ERROR_INVALID_PARAMETER || raw == E_INVALIDARG_HRESULT {
389
- // pid doesn't exist (or reaped between recorded
390
- // spawn and this shutdown call).
391
- return Ok(TerminationOutcome::AlreadyGone);
392
- }
393
- return Err(io::Error::from_raw_os_error(err.code().0 as i32));
394
- }
395
- };
396
- let result = unsafe { TerminateProcess(handle, 1) };
397
- unsafe {
398
- let _ = CloseHandle(handle);
399
- };
400
- result.map_err(|e| io::Error::from_raw_os_error(e.code().0 as i32))?;
401
- Ok(match kind {
402
- SignalKind::TerminateGraceful => TerminationOutcome::ForceOnly {
403
- reason: "windows_no_sigterm_equivalent_for_non_console_child",
404
- },
405
- SignalKind::TerminateForce => TerminationOutcome::Requested,
406
- })
407
- }
408
-
409
- pub fn reap_child_if_possible(_pid: u32) {
410
- // Windows has no zombie waitpid model. Child handles are
411
- // owned by the spawner and closed at drop; nothing to do.
412
- }
413
- }
414
-
415
- // ─────────────────────────────────────────────────────────────────────
416
- // Re-export the platform-appropriate impl at module top-level so
417
- // callers write `platform::process::pid_liveness(pid)` without cfg.
418
- // ─────────────────────────────────────────────────────────────────────
419
-
420
- #[cfg(unix)]
421
- pub use unix_impl::*;
422
-
423
- #[cfg(not(unix))]
424
- pub use windows_impl::*;
425
-
426
- #[cfg(test)]
427
- mod tests {
428
- use super::*;
429
-
430
- #[test]
431
- fn parent_pid_returns_some_value_on_both_platforms_after_batch_3() {
432
- // Batch 3 real implementation: both Unix (`getppid`) and
433
- // Windows (Toolhelp32 snapshot) return the process's parent
434
- // pid. A `None` here on either platform is a regression.
435
- let ppid = current_parent_pid();
436
- assert!(
437
- ppid.is_some(),
438
- "current_parent_pid must return Some on both unix and windows"
439
- );
440
- assert!(ppid.unwrap() > 0);
441
- }
442
-
443
- #[test]
444
- fn pid_liveness_own_pid_is_live_on_unix() {
445
- // Batch 0 unix impl is byte-equivalent to
446
- // `lifecycle/restart/agent.rs::pid_is_alive` for our own pid,
447
- // which must always be Live.
448
- #[cfg(unix)]
449
- {
450
- let my_pid = std::process::id();
451
- let result = pid_liveness(my_pid).expect("own pid must be checkable");
452
- assert_eq!(result, ProcessLiveness::Live);
453
- }
454
- }
455
-
456
- #[test]
457
- fn windows_terminate_graceful_returns_force_only_with_reason_when_downgraded() {
458
- // CR C-6 anchor: caller can distinguish Requested vs
459
- // ForceOnly and emit the `platform.terminate_force_only`
460
- // audit event only when the OS downgraded. Use an
461
- // impossible pid so `AlreadyGone` short-circuits the actual
462
- // kill — we're only checking the shape of the outcome enum.
463
- //
464
- // On Unix the SAME call returns `AlreadyGone` (kill returned
465
- // ESRCH) because `SIGTERM` is a real signal there.
466
- #[cfg(not(unix))]
467
- {
468
- // On Windows the AlreadyGone short-circuit runs first;
469
- // to exercise the ForceOnly path we'd need a real
470
- // process. This test just documents the ForceOnly variant
471
- // exists and matches what a live-target call would return.
472
- let outcome = TerminationOutcome::ForceOnly {
473
- reason: "windows_no_sigterm_equivalent_for_non_console_child",
474
- };
475
- match outcome {
476
- TerminationOutcome::ForceOnly { reason } => {
477
- assert!(reason.contains("windows"));
478
- }
479
- other => panic!("expected ForceOnly variant, got {other:?}"),
480
- }
481
- }
482
- }
483
-
484
- #[test]
485
- fn pid_is_alive_returns_true_for_own_pid() {
486
- // Batch 3 anchor: `pid_is_alive` is the byte-preserving
487
- // migration target for `lifecycle/restart/agent.rs::pid_is_alive`
488
- // + `cli/mod.rs::process_is_live`. Callers rely on "our own pid
489
- // is always alive" invariant to derive drain-loop termination.
490
- assert!(pid_is_alive(std::process::id()));
491
- }
492
-
493
- #[test]
494
- fn pid_is_alive_returns_false_for_definitely_dead_pid() {
495
- // A pid we absolutely never allocate — 0xFFFF_FFFE — is
496
- // guaranteed to not exist. Windows OpenProcess returns
497
- // ERROR_INVALID_PARAMETER; Unix `kill(pid, 0)` returns
498
- // ESRCH. Both map to `false`.
499
- assert!(!pid_is_alive(0xFFFF_FFFE));
500
- }
501
-
502
- #[test]
503
- fn pid_liveness_returns_dead_for_impossible_pid() {
504
- match pid_liveness(0xFFFF_FFFE) {
505
- Ok(ProcessLiveness::Dead) => {}
506
- Ok(other) => panic!("expected Dead for impossible pid, got {other:?}"),
507
- Err(e) => panic!("expected Ok(Dead), got Err({e:?})"),
508
- }
509
- }
510
-
511
- #[test]
512
- fn reap_child_if_possible_never_panics_for_arbitrary_pid() {
513
- // Byte-equivalent to `coordinator/health.rs::reap_child_if_possible`
514
- // + `cli/mod.rs::reap_child_if_possible` invariant: this is
515
- // called on foreign pids too (children of coordinator's
516
- // children), so it must silently no-op if the pid is not
517
- // reap-able by this process.
518
- reap_child_if_possible(std::process::id());
519
- reap_child_if_possible(0xFFFF_FFFE);
520
- }
521
-
522
- #[test]
523
- fn terminate_pid_returns_already_gone_for_impossible_pid() {
524
- // `coordinator/health.rs::terminate_pid` treats "kill returned
525
- // error because target not-found" as success (idempotent
526
- // shutdown). Preserve that shape via `AlreadyGone`.
527
- match terminate_pid(0xFFFF_FFFE, SignalKind::TerminateForce) {
528
- Ok(TerminationOutcome::AlreadyGone) => {}
529
- other => panic!("expected AlreadyGone for impossible pid, got {other:?}"),
530
- }
531
- }
532
-
533
- #[test]
534
- fn signal_kind_and_termination_outcome_are_distinguishable_variants() {
535
- // Both enums must have distinct variants so callers can
536
- // pattern-match without cfg.
537
- assert_ne!(SignalKind::TerminateGraceful, SignalKind::TerminateForce);
538
- let requested = TerminationOutcome::Requested;
539
- let force_only = TerminationOutcome::ForceOnly { reason: "test" };
540
- let already_gone = TerminationOutcome::AlreadyGone;
541
- assert_ne!(requested, force_only);
542
- assert_ne!(requested, already_gone);
543
- assert_ne!(force_only, already_gone);
544
- }
545
- }