@team-agent/installer 0.5.128 → 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 (436) hide show
  1. package/README.md +4 -4
  2. package/README.zh.md +1 -1
  3. package/package.json +4 -8
  4. package/skills/team-agent/SKILL.md +37 -20
  5. package/skills/team-agent/command-coverage.json +169 -183
  6. package/skills/team-agent/docs/reference/team-agent-operator.md +64 -30
  7. package/skills/team-agent/references/recovery-runbook.md +1 -1
  8. package/skills/team-agent/references/team-agent-operator.md +64 -30
  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 -1288
  15. package/crates/team-agent/src/cli/arguments.rs +0 -405
  16. package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
  17. package/crates/team-agent/src/cli/diagnose.rs +0 -1721
  18. package/crates/team-agent/src/cli/emit.rs +0 -2930
  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 -1216
  22. package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -912
  23. package/crates/team-agent/src/cli/intent/tests.rs +0 -689
  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 -6545
  29. package/crates/team-agent/src/cli/models.rs +0 -1206
  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/schedule.rs +0 -175
  34. package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
  35. package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
  36. package/crates/team-agent/src/cli/send/persist.rs +0 -156
  37. package/crates/team-agent/src/cli/send/presentation.rs +0 -370
  38. package/crates/team-agent/src/cli/send/resolve.rs +0 -573
  39. package/crates/team-agent/src/cli/send.rs +0 -199
  40. package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
  41. package/crates/team-agent/src/cli/spec.rs +0 -165
  42. package/crates/team-agent/src/cli/status.rs +0 -280
  43. package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
  44. package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
  45. package/crates/team-agent/src/cli/status_port/brief.rs +0 -1981
  46. package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
  47. package/crates/team-agent/src/cli/status_port/format.rs +0 -146
  48. package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
  49. package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
  50. package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
  51. package/crates/team-agent/src/cli/status_port/store.rs +0 -416
  52. package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
  53. package/crates/team-agent/src/cli/status_port.rs +0 -92
  54. package/crates/team-agent/src/cli/tests/base.rs +0 -885
  55. package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
  56. package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
  57. package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -322
  58. package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
  59. package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
  60. package/crates/team-agent/src/cli/tests/mod.rs +0 -137
  61. package/crates/team-agent/src/cli/tests/named_address.rs +0 -761
  62. package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
  63. package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -484
  64. package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
  65. package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
  66. package/crates/team-agent/src/cli/tests/status_send.rs +0 -888
  67. package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
  68. package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
  69. package/crates/team-agent/src/cli/triage.rs +0 -234
  70. package/crates/team-agent/src/cli/types.rs +0 -591
  71. package/crates/team-agent/src/codex_app_server.rs +0 -546
  72. package/crates/team-agent/src/communication_mode/mod.rs +0 -56
  73. package/crates/team-agent/src/compiler/tests.rs +0 -827
  74. package/crates/team-agent/src/compiler.rs +0 -890
  75. package/crates/team-agent/src/conpty/backend.rs +0 -829
  76. package/crates/team-agent/src/conpty/mod.rs +0 -33
  77. package/crates/team-agent/src/contract_runtime/backend.rs +0 -1744
  78. package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
  79. package/crates/team-agent/src/contract_runtime/config.rs +0 -364
  80. package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -76
  81. package/crates/team-agent/src/contract_runtime/discovery.rs +0 -449
  82. package/crates/team-agent/src/contract_runtime/fork.rs +0 -361
  83. package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
  84. package/crates/team-agent/src/contract_runtime/framework.rs +0 -367
  85. package/crates/team-agent/src/contract_runtime/mcp.rs +0 -394
  86. package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
  87. package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
  88. package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
  89. package/crates/team-agent/src/contract_runtime/registry.rs +0 -553
  90. package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
  91. package/crates/team-agent/src/coordinator/backoff.rs +0 -741
  92. package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
  93. package/crates/team-agent/src/coordinator/health.rs +0 -1185
  94. package/crates/team-agent/src/coordinator/mod.rs +0 -119
  95. package/crates/team-agent/src/coordinator/orphan.rs +0 -110
  96. package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
  97. package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
  98. package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
  99. package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
  100. package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
  101. package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
  102. package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
  103. package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
  104. package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
  105. package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
  106. package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
  107. package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -300
  108. package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
  109. package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
  110. package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
  111. package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -503
  112. package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
  113. package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
  114. package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
  115. package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
  116. package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
  117. package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
  118. package/crates/team-agent/src/coordinator/tick.rs +0 -3024
  119. package/crates/team-agent/src/coordinator/types.rs +0 -540
  120. package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
  121. package/crates/team-agent/src/db/message_store.rs +0 -1527
  122. package/crates/team-agent/src/db/migration.rs +0 -984
  123. package/crates/team-agent/src/db/mod.rs +0 -26
  124. package/crates/team-agent/src/db/schema.rs +0 -663
  125. package/crates/team-agent/src/diagnose/comms.rs +0 -242
  126. package/crates/team-agent/src/diagnose/mod.rs +0 -44
  127. package/crates/team-agent/src/diagnose/orphans.rs +0 -889
  128. package/crates/team-agent/src/direct_delivery.rs +0 -368
  129. package/crates/team-agent/src/event_log.rs +0 -502
  130. package/crates/team-agent/src/fake_worker.rs +0 -303
  131. package/crates/team-agent/src/inbox_store.rs +0 -169
  132. package/crates/team-agent/src/kill_audit.rs +0 -106
  133. package/crates/team-agent/src/layout/manager.rs +0 -248
  134. package/crates/team-agent/src/layout/mod.rs +0 -36
  135. package/crates/team-agent/src/layout/overlay.rs +0 -134
  136. package/crates/team-agent/src/layout/placement.rs +0 -52
  137. package/crates/team-agent/src/layout/recovery.rs +0 -106
  138. package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
  139. package/crates/team-agent/src/layout/sessions.rs +0 -294
  140. package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
  141. package/crates/team-agent/src/layout/worker_env.rs +0 -721
  142. package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
  143. package/crates/team-agent/src/leader/helpers.rs +0 -178
  144. package/crates/team-agent/src/leader/incident.rs +0 -6
  145. package/crates/team-agent/src/leader/lease.rs +0 -3356
  146. package/crates/team-agent/src/leader/mod.rs +0 -104
  147. package/crates/team-agent/src/leader/owner_bind.rs +0 -400
  148. package/crates/team-agent/src/leader/prompt.rs +0 -905
  149. package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
  150. package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
  151. package/crates/team-agent/src/leader/rediscover.rs +0 -1192
  152. package/crates/team-agent/src/leader/registry.rs +0 -888
  153. package/crates/team-agent/src/leader/start.rs +0 -4501
  154. package/crates/team-agent/src/leader/takeover.rs +0 -65
  155. package/crates/team-agent/src/leader/tests/basics.rs +0 -337
  156. package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
  157. package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
  158. package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
  159. package/crates/team-agent/src/leader/tests/identity.rs +0 -465
  160. package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
  161. package/crates/team-agent/src/leader/tests/idle.rs +0 -113
  162. package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
  163. package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
  164. package/crates/team-agent/src/leader/tests/mod.rs +0 -106
  165. package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -268
  166. package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
  167. package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
  168. package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
  169. package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
  170. package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
  171. package/crates/team-agent/src/leader/types.rs +0 -534
  172. package/crates/team-agent/src/lib.rs +0 -147
  173. package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
  174. package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -881
  175. package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -598
  176. package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
  177. package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -204
  178. package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -107
  179. package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -144
  180. package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
  181. package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
  182. package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
  183. package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -160
  184. package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
  185. package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -899
  186. package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -225
  187. package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
  188. package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5200
  189. package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
  190. package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
  191. package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
  192. package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -473
  193. package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
  194. package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
  195. package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
  196. package/crates/team-agent/src/lifecycle/launch.rs +0 -557
  197. package/crates/team-agent/src/lifecycle/lock.rs +0 -350
  198. package/crates/team-agent/src/lifecycle/mod.rs +0 -79
  199. package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
  200. package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -1067
  201. package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
  202. package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2199
  203. package/crates/team-agent/src/lifecycle/restart/avatar.rs +0 -1798
  204. package/crates/team-agent/src/lifecycle/restart/claude_fork.rs +0 -163
  205. package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2362
  206. package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
  207. package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
  208. package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
  209. package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
  210. package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
  211. package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
  212. package/crates/team-agent/src/lifecycle/restart.rs +0 -227
  213. package/crates/team-agent/src/lifecycle/role_config.rs +0 -1230
  214. package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
  215. package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
  216. package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
  217. package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
  218. package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
  219. package/crates/team-agent/src/lifecycle/tests/claude_compatible_config_red.rs +0 -325
  220. package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -447
  221. package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1638
  222. package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
  223. package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -770
  224. package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -419
  225. package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2035
  226. package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1327
  227. package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
  228. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
  229. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
  230. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -72
  231. package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
  232. package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
  233. package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -512
  234. package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
  235. package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
  236. package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
  237. package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3983
  238. package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
  239. package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
  240. package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
  241. package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
  242. package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
  243. package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
  244. package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -164
  245. package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -200
  246. package/crates/team-agent/src/lifecycle/tests/pi_compiler_red.rs +0 -210
  247. package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -527
  248. package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -1062
  249. package/crates/team-agent/src/lifecycle/tests/pi_fork_session_inheritance_red.rs +0 -1419
  250. package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -98
  251. package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -550
  252. package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -226
  253. package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -332
  254. package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
  255. package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
  256. package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
  257. package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
  258. package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
  259. package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
  260. package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
  261. package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
  262. package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
  263. package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
  264. package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
  265. package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
  266. package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -342
  267. package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
  268. package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
  269. package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
  270. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
  271. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
  272. package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
  273. package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
  274. package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -995
  275. package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -836
  276. package/crates/team-agent/src/lifecycle/tests.rs +0 -105
  277. package/crates/team-agent/src/lifecycle/types.rs +0 -877
  278. package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -363
  279. package/crates/team-agent/src/main.rs +0 -52
  280. package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
  281. package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
  282. package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
  283. package/crates/team-agent/src/mcp_server/mod.rs +0 -119
  284. package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
  285. package/crates/team-agent/src/mcp_server/readiness.rs +0 -527
  286. package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -348
  287. package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
  288. package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
  289. package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -158
  290. package/crates/team-agent/src/mcp_server/tests/send.rs +0 -353
  291. package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -341
  292. package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
  293. package/crates/team-agent/src/mcp_server/tests.rs +0 -43
  294. package/crates/team-agent/src/mcp_server/tools.rs +0 -889
  295. package/crates/team-agent/src/mcp_server/types.rs +0 -396
  296. package/crates/team-agent/src/mcp_server/wire.rs +0 -867
  297. package/crates/team-agent/src/messaging/activity.rs +0 -461
  298. package/crates/team-agent/src/messaging/address.rs +0 -87
  299. package/crates/team-agent/src/messaging/delivery.rs +0 -3727
  300. package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
  301. package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
  302. package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
  303. package/crates/team-agent/src/messaging/helpers.rs +0 -336
  304. package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
  305. package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
  306. package/crates/team-agent/src/messaging/mod.rs +0 -167
  307. package/crates/team-agent/src/messaging/persist.rs +0 -377
  308. package/crates/team-agent/src/messaging/presentation.rs +0 -417
  309. package/crates/team-agent/src/messaging/reminders.rs +0 -316
  310. package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
  311. package/crates/team-agent/src/messaging/results.rs +0 -1415
  312. package/crates/team-agent/src/messaging/scheduler.rs +0 -223
  313. package/crates/team-agent/src/messaging/selftest.rs +0 -315
  314. package/crates/team-agent/src/messaging/send.rs +0 -981
  315. package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
  316. package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -657
  317. package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
  318. package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
  319. package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
  320. package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
  321. package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
  322. package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3549
  323. package/crates/team-agent/src/messaging/tests/spine.rs +0 -853
  324. package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
  325. package/crates/team-agent/src/messaging/trust.rs +0 -215
  326. package/crates/team-agent/src/messaging/types.rs +0 -472
  327. package/crates/team-agent/src/messaging/wait.rs +0 -366
  328. package/crates/team-agent/src/messaging/watchers.rs +0 -916
  329. package/crates/team-agent/src/model/enums.rs +0 -356
  330. package/crates/team-agent/src/model/errors.rs +0 -18
  331. package/crates/team-agent/src/model/ids.rs +0 -165
  332. package/crates/team-agent/src/model/mod.rs +0 -29
  333. package/crates/team-agent/src/model/name_similarity.rs +0 -252
  334. package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
  335. package/crates/team-agent/src/model/paths.rs +0 -257
  336. package/crates/team-agent/src/model/routing.rs +0 -387
  337. package/crates/team-agent/src/model/spec.rs +0 -1184
  338. package/crates/team-agent/src/model/task_graph.rs +0 -321
  339. package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
  340. package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
  341. package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
  342. package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
  343. package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
  344. package/crates/team-agent/src/model/yaml/tests.rs +0 -188
  345. package/crates/team-agent/src/model/yaml.rs +0 -802
  346. package/crates/team-agent/src/os_probe.rs +0 -280
  347. package/crates/team-agent/src/packaging/install.rs +0 -219
  348. package/crates/team-agent/src/packaging/migrate.rs +0 -38
  349. package/crates/team-agent/src/packaging/mod.rs +0 -91
  350. package/crates/team-agent/src/packaging/repair.rs +0 -33
  351. package/crates/team-agent/src/packaging/tests.rs +0 -822
  352. package/crates/team-agent/src/packaging/types.rs +0 -417
  353. package/crates/team-agent/src/platform/argv.rs +0 -331
  354. package/crates/team-agent/src/platform/errors.rs +0 -104
  355. package/crates/team-agent/src/platform/file_lock.rs +0 -279
  356. package/crates/team-agent/src/platform/mod.rs +0 -5
  357. package/crates/team-agent/src/platform/process.rs +0 -545
  358. package/crates/team-agent/src/provider/adapter.rs +0 -1150
  359. package/crates/team-agent/src/provider/adapters/claude.rs +0 -78
  360. package/crates/team-agent/src/provider/adapters/claude_fork.rs +0 -131
  361. package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
  362. package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
  363. package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
  364. package/crates/team-agent/src/provider/adapters/mod.rs +0 -30
  365. package/crates/team-agent/src/provider/adapters/pi.rs +0 -106
  366. package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
  367. package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
  368. package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
  369. package/crates/team-agent/src/provider/argv_route.rs +0 -405
  370. package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
  371. package/crates/team-agent/src/provider/classify.rs +0 -708
  372. package/crates/team-agent/src/provider/command_helpers.rs +0 -45
  373. package/crates/team-agent/src/provider/faults.rs +0 -165
  374. package/crates/team-agent/src/provider/helpers.rs +0 -52
  375. package/crates/team-agent/src/provider/mod.rs +0 -78
  376. package/crates/team-agent/src/provider/model_catalog.rs +0 -910
  377. package/crates/team-agent/src/provider/session/capture.rs +0 -2731
  378. package/crates/team-agent/src/provider/session/context_fork/claude.rs +0 -123
  379. package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -172
  380. package/crates/team-agent/src/provider/session/context_fork.rs +0 -396
  381. package/crates/team-agent/src/provider/session/mod.rs +0 -36
  382. package/crates/team-agent/src/provider/session/resume.rs +0 -269
  383. package/crates/team-agent/src/provider/session_scan/claude.rs +0 -523
  384. package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
  385. package/crates/team-agent/src/provider/session_scan/common.rs +0 -654
  386. package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
  387. package/crates/team-agent/src/provider/session_scan/pi.rs +0 -185
  388. package/crates/team-agent/src/provider/session_scan.rs +0 -71
  389. package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
  390. package/crates/team-agent/src/provider/submit_now.rs +0 -71
  391. package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
  392. package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
  393. package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
  394. package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
  395. package/crates/team-agent/src/provider/tests/adapter.rs +0 -441
  396. package/crates/team-agent/src/provider/tests/classify.rs +0 -148
  397. package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -35
  398. package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
  399. package/crates/team-agent/src/provider/tests/faults.rs +0 -200
  400. package/crates/team-agent/src/provider/tests/idle.rs +0 -177
  401. package/crates/team-agent/src/provider/tests/wire.rs +0 -213
  402. package/crates/team-agent/src/provider/tests.rs +0 -32
  403. package/crates/team-agent/src/provider/types.rs +0 -529
  404. package/crates/team-agent/src/provider/wire.rs +0 -394
  405. package/crates/team-agent/src/redaction.rs +0 -259
  406. package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
  407. package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
  408. package/crates/team-agent/src/state/identity.rs +0 -914
  409. package/crates/team-agent/src/state/identity_keys.rs +0 -132
  410. package/crates/team-agent/src/state/mod.rs +0 -74
  411. package/crates/team-agent/src/state/owner_gate.rs +0 -482
  412. package/crates/team-agent/src/state/ownership.rs +0 -563
  413. package/crates/team-agent/src/state/paths.rs +0 -395
  414. package/crates/team-agent/src/state/persist.rs +0 -3811
  415. package/crates/team-agent/src/state/projection.rs +0 -1508
  416. package/crates/team-agent/src/state/repository/intent.rs +0 -14
  417. package/crates/team-agent/src/state/repository/tests.rs +0 -184
  418. package/crates/team-agent/src/state/repository.rs +0 -866
  419. package/crates/team-agent/src/state/selector.rs +0 -160
  420. package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
  421. package/crates/team-agent/src/test_support/models_timeout_fixture.rs +0 -144
  422. package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
  423. package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
  424. package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
  425. package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
  426. package/crates/team-agent/src/tmux_backend/tests.rs +0 -4103
  427. package/crates/team-agent/src/tmux_backend.rs +0 -4492
  428. package/crates/team-agent/src/topology.rs +0 -537
  429. package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
  430. package/crates/team-agent/src/transport/native_input.rs +0 -491
  431. package/crates/team-agent/src/transport/test_support.rs +0 -743
  432. package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
  433. package/crates/team-agent/src/transport/tests/mod.rs +0 -194
  434. package/crates/team-agent/src/transport/tests/wire.rs +0 -574
  435. package/crates/team-agent/src/transport.rs +0 -1655
  436. 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
- }