@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,1298 +0,0 @@
1
- //!
2
- //! cli · adapters — 每子命令的薄壳 `cmd_*`(commands.py)。委派 status/lifecycle/diagnose/
3
- //! leader/messaging port,把委派结果包成 [`CmdResult`]。含逻辑的:`cmd_status`(三态互斥)、
4
- //! `cmd_doctor`(gate/comms/fix-schema/cleanup-orphans 分派)。
5
-
6
- use super::*;
7
-
8
- /// `cmd_quick_start`(`commands.py:18`)。`--json` 或 `!ok` → 整 dict;否则 `result["summary"]`。
9
- pub fn cmd_quick_start(args: &QuickStartArgs) -> Result<CmdResult, CliError> {
10
- #[cfg(unix)]
11
- crate::contract_runtime::config::read_team(args)
12
- .map_err(|error| CliError::Runtime(error.to_string()))?;
13
- let mut value = lifecycle_port::quick_start(
14
- &args.workspace,
15
- &args.agents_dir,
16
- args.name.as_deref(),
17
- args.team_id.as_deref(),
18
- args.yes,
19
- args.backend.as_deref(),
20
- )?;
21
- if let Some(result) = quick_start_config_guidance(&mut value, args) {
22
- return Ok(result);
23
- }
24
- append_send_guidance(&mut value, &args.workspace, args.team_id.as_deref());
25
- finish_quick_start(value, args)
26
- }
27
-
28
- fn finish_quick_start(mut value: Value, args: &QuickStartArgs) -> Result<CmdResult, CliError> {
29
- let readiness = value.get("readiness").and_then(Value::as_object);
30
- let all_resumable_have_session = readiness
31
- .and_then(|readiness| readiness.get("all_resumable_have_session"))
32
- .and_then(Value::as_bool)
33
- .unwrap_or(true);
34
- let session_capture_incomplete = readiness
35
- .and_then(|readiness| readiness.get("session_capture_incomplete"))
36
- .and_then(Value::as_bool)
37
- .unwrap_or(!all_resumable_have_session);
38
- let readiness_ready = readiness
39
- .and_then(|readiness| readiness.get("ready"))
40
- .and_then(Value::as_bool)
41
- .unwrap_or(true);
42
- let status = value
43
- .get("status")
44
- .and_then(Value::as_str)
45
- .map(str::to_string);
46
- if !args.detail && value.get("ok").and_then(Value::as_bool) != Some(false) {
47
- lifecycle_port::compact_quick_start_value(&mut value);
48
- }
49
- if args.json
50
- || value.get("ok").and_then(Value::as_bool) == Some(false)
51
- || session_capture_incomplete
52
- || !readiness_ready
53
- {
54
- let mut result = CmdResult::from_json(value, args.json);
55
- if status.as_deref() == Some("pending_tool_load") {
56
- result.exit = ExitCode::Ok;
57
- }
58
- if !args.json {
59
- if let CmdOutput::Json(value) = &result.output {
60
- // Typed refusals often have no `error`. Preserve the complete
61
- // report instead of replacing its reason/actions with a guess.
62
- let safe = crate::redaction::redact_external_value(value);
63
- result.output = CmdOutput::Human(format!(
64
- "quick-start report:\n{}",
65
- serde_json::to_string_pretty(&safe)?
66
- ));
67
- }
68
- }
69
- Ok(result)
70
- } else {
71
- // E13:happy 人类路径必须带 attach_commands(json 路径 cli/mod.rs:1775 已有)。
72
- Ok(CmdResult::human(&quickstart_human(&value)))
73
- }
74
- }
75
-
76
- // Project only an actual compiler rejection; never reject a valid lifecycle fallback.
77
- fn quick_start_config_guidance(value: &mut Value, args: &QuickStartArgs) -> Option<CmdResult> {
78
- if value.get("ok").and_then(Value::as_bool) != Some(false) {
79
- return None;
80
- }
81
- let error = value.get("error")?.as_str()?;
82
- let compile = error.strip_prefix("spec compile failed: ")?;
83
- let detail = compile
84
- .strip_prefix("validation error: ")
85
- .unwrap_or(compile);
86
- let team_path = args.agents_dir.join("TEAM.md");
87
- let agents_path = args.agents_dir.join("agents");
88
- let missing_team = detail == format!("{}: missing TEAM.md", team_path.display())
89
- && team_path.try_exists().ok() == Some(false);
90
- let missing_roles = detail == format!("{}: missing agents directory", agents_path.display())
91
- || detail == format!("{}: no role docs found", agents_path.display());
92
- let missing_field = detail.split_once(": ").is_some_and(|(path, reason)| {
93
- Path::new(path).parent() == Some(agents_path.as_path())
94
- && (reason.contains("missing required field") || reason.contains("is required"))
95
- });
96
- if !missing_team && !(team_path.is_file() && (missing_roles || missing_field)) {
97
- return None;
98
- }
99
- let role_path = agents_path.join("worker.md");
100
- let mut retry = format!(
101
- "team-agent quick-start {} --workspace {}",
102
- shell_quote(&args.agents_dir.to_string_lossy()),
103
- shell_quote(&args.workspace.to_string_lossy())
104
- );
105
- if let Some(team) = args.team_id.as_deref() {
106
- retry.push_str(&format!(" --team {}", shell_quote(team)));
107
- }
108
- if let Some(name) = args.name.as_deref() {
109
- retry.push_str(&format!(" --name {}", shell_quote(name)));
110
- }
111
- if let Some(backend) = args.backend.as_deref() {
112
- retry.push_str(&format!(" --backend {}", shell_quote(backend)));
113
- }
114
- if args.yes {
115
- retry.push_str(" --yes");
116
- }
117
- if args.detail {
118
- retry.push_str(" --detail");
119
- }
120
- if args.json {
121
- retry.push_str(" --json");
122
- }
123
- let explanation = if missing_team {
124
- format!("Team configuration is missing: {}. No workers were started. Create the two files below; this command did not write them. Error: {error}", team_path.display())
125
- } else {
126
- format!("Worker configuration is incomplete: {detail}. Add the role directory or required fields. The examples below do not overwrite existing files. Error: {error}")
127
- };
128
- let next = format!("Check that Pi is installed and signed in; verify the model with team-agent models --provider pi.\nRun team-agent pi, then execute this command in that leader's tool context:\n{retry}");
129
- let mut templates =
130
- vec![serde_json::json!({"path": role_path, "content": super::emit::WORKER_TEMPLATE})];
131
- let mut human = explanation.clone();
132
- if missing_team {
133
- templates.insert(
134
- 0,
135
- serde_json::json!({"path": team_path, "content": super::emit::TEAM_TEMPLATE}),
136
- );
137
- human.push_str(&format!(
138
- "\n\n{}:\n{}",
139
- team_path.display(),
140
- super::emit::TEAM_TEMPLATE
141
- ));
142
- }
143
- human.push_str(&format!(
144
- "\n\n{}:\n{}\nNext steps:\n{next}",
145
- role_path.display(),
146
- super::emit::WORKER_TEMPLATE
147
- ));
148
- value["action"] = serde_json::json!(explanation);
149
- value["next_actions"] =
150
- serde_json::json!(["team-agent models --provider pi", "team-agent pi", retry]);
151
- value["templates"] = serde_json::json!(templates);
152
- if args.json {
153
- Some(CmdResult::from_json(value.clone(), true))
154
- } else {
155
- let mut result = CmdResult::human(&human);
156
- result.exit = ExitCode::Error;
157
- Some(result)
158
- }
159
- }
160
-
161
- /// E13:quick-start "team 起了" 人类输出 = summary + attach 块。所有成功出口共用(别每分支手拷)。
162
- /// attach_commands 缺/空 → 只 summary(向后兼容)。
163
- fn quickstart_human(value: &Value) -> String {
164
- let summary = value
165
- .get("summary")
166
- .and_then(Value::as_str)
167
- .unwrap_or("Team started.");
168
- let attach: Vec<&str> = value
169
- .get("attach_commands")
170
- .and_then(Value::as_array)
171
- .map(|items| items.iter().filter_map(Value::as_str).collect())
172
- .unwrap_or_default();
173
- let sends: Vec<&str> = value
174
- .get("send_commands")
175
- .and_then(Value::as_array)
176
- .map(|items| items.iter().filter_map(Value::as_str).collect())
177
- .unwrap_or_default();
178
- let mut out = String::from(summary);
179
- if !attach.is_empty() {
180
- out.push_str("\n\nConnect to the team:");
181
- for cmd in attach {
182
- out.push_str("\n ");
183
- out.push_str(cmd);
184
- }
185
- }
186
- if !sends.is_empty() {
187
- out.push_str("\n\nSend a task (replace the example message):");
188
- for cmd in sends {
189
- out.push_str("\n ");
190
- out.push_str(cmd);
191
- }
192
- }
193
- append_reminder(out, crate::cli::QUICK_START_REMINDER)
194
- }
195
-
196
- pub(crate) fn append_send_guidance(value: &mut Value, workspace: &Path, team: Option<&str>) {
197
- let existing = value.get("summary").and_then(Value::as_str) == Some("existing runtime");
198
- if value.get("ok").and_then(Value::as_bool) != Some(true) && !existing {
199
- return;
200
- }
201
- let team = value
202
- .get("team")
203
- .and_then(Value::as_str)
204
- .filter(|team| !team.is_empty())
205
- .map(str::to_string)
206
- .or_else(|| team.map(str::to_string));
207
- let team = team.as_deref();
208
- let agents = value
209
- .get("agent_ids")
210
- .and_then(Value::as_array)
211
- .cloned()
212
- .unwrap_or_default();
213
- let commands: Vec<Value> = agents
214
- .iter()
215
- .filter_map(Value::as_str)
216
- .filter_map(|agent| send_command(agent, workspace, team).map(Value::String))
217
- .collect();
218
- if !commands.is_empty() {
219
- if let Some(object) = value.as_object_mut() {
220
- object.insert("send_commands".to_string(), Value::Array(commands));
221
- }
222
- }
223
- }
224
-
225
- #[cfg(test)]
226
- pub(crate) fn split_shell_argv(command: &str) -> Vec<String> {
227
- let mut argv = Vec::new();
228
- let mut current = String::new();
229
- let mut chars = command.chars().peekable();
230
- let mut quote: Option<char> = None;
231
- while let Some(ch) = chars.next() {
232
- match (quote, ch) {
233
- (None, '\'') | (None, '"') => quote = Some(ch),
234
- (Some(q), c) if c == q => quote = None,
235
- (None, c) if c.is_whitespace() => {
236
- if !current.is_empty() {
237
- argv.push(std::mem::take(&mut current));
238
- }
239
- }
240
- (_, c) => current.push(c),
241
- }
242
- }
243
- if !current.is_empty() {
244
- argv.push(current);
245
- }
246
- argv
247
- }
248
-
249
- pub(crate) fn send_command(agent: &str, workspace: &Path, team: Option<&str>) -> Option<String> {
250
- let workspace = workspace.to_str()?;
251
- let mut command = format!(
252
- "team-agent send {} {} --workspace {}",
253
- shell_quote(agent),
254
- shell_quote("Complete the task and reply to the leader."),
255
- shell_quote(workspace)
256
- );
257
- if let Some(team) = team {
258
- command.push_str(" --team ");
259
- command.push_str(&shell_quote(team));
260
- }
261
- Some(command)
262
- }
263
-
264
- pub(crate) fn shell_quote(value: &str) -> String {
265
- if value.bytes().all(|byte| {
266
- byte.is_ascii_alphanumeric() || matches!(byte, b'/' | b'.' | b'_' | b'-' | b':')
267
- }) {
268
- value.to_string()
269
- } else {
270
- format!("'{}'", value.replace('\'', "'\\''"))
271
- }
272
- }
273
-
274
- fn append_reminder(text: String, reminder: &str) -> String {
275
- if text.is_empty() {
276
- reminder.to_string()
277
- } else {
278
- format!("{text}\n{reminder}")
279
- }
280
- }
281
-
282
- /// `cmd_status`(`commands.py:90`)。CLI status 统一为只读九字段 brief;
283
- /// `--json` 与人读路径共享 native tmux/process projection;`--summary`/`--detail` 保留参数兼容性但不暴露诊断。
284
- #[cfg(test)]
285
- pub(crate) fn cmd_status(args: &StatusArgs) -> Result<CmdResult, CliError> {
286
- cmd_status_for_team(args, args.team.as_deref())
287
- }
288
-
289
- pub fn cmd_status_for_team(args: &StatusArgs, team: Option<&str>) -> Result<CmdResult, CliError> {
290
- if args.summary && args.json {
291
- return Err(CliError::Runtime(
292
- "--summary and --json are mutually exclusive".to_string(),
293
- ));
294
- }
295
- if args.summary && args.agent.is_some() {
296
- return Err(CliError::Runtime(
297
- "status --summary does not accept an agent argument".to_string(),
298
- ));
299
- }
300
- // S4QR-001 (0.4.8): selected-team ambiguity gate. status is a selected-team
301
- // command: when the workspace has 2+ alive teams and no --team was passed,
302
- // refuse instead of silently defaulting to the active team. Uses the
303
- // read-only CommandScope helper so the gate cannot migrate/write state.
304
- if team.is_none() {
305
- let scope = crate::state::paths::CommandScope::resolve_readonly(&args.workspace, None);
306
- if scope.is_ambiguous() {
307
- let candidates: Vec<String> = scope.candidates().to_vec();
308
- let message = format!(
309
- "status: workspace has multiple alive teams ({}); pass `--team <key>` to choose one",
310
- candidates.join(", ")
311
- );
312
- return Err(CliError::Usage(message));
313
- }
314
- }
315
- let selected = crate::state::selector::resolve_active_team_readonly(
316
- &args.workspace,
317
- team,
318
- crate::state::selector::SelectorMode::RuntimeOnly,
319
- )?;
320
- if let Some(agent) = args.agent.as_deref() {
321
- if !status_port::registered_agent_exists(&selected.state, agent) {
322
- return Err(CliError::Runtime(format!("unknown agent id: {agent}")));
323
- }
324
- }
325
- // Status brief is deliberately independent of the legacy RuntimeSnapshot:
326
- // it performs one native tmux/process sample and exposes exactly nine
327
- // fields. `--summary` and `--detail` remain parser-compatible but do not
328
- // re-enable history, runtime diagnostics, or reminder text.
329
- if args.json {
330
- return Ok(CmdResult::from_json(
331
- status_port::status_brief_scoped(
332
- &selected.run_workspace,
333
- &selected.state,
334
- args.agent.as_deref(),
335
- ),
336
- true,
337
- ));
338
- }
339
- Ok(CmdResult::human(status_port::format_status_brief(
340
- &selected.run_workspace,
341
- &selected.state,
342
- args.agent.as_deref(),
343
- )))
344
- }
345
-
346
- pub fn cmd_wait(args: &WaitArgs) -> Result<CmdResult, CliError> {
347
- let result = messaging::wait_for_result(&args.workspace, &args.task_id)?;
348
- Ok(CmdResult::from_json(result.to_json(), args.json))
349
- }
350
-
351
- /// `cmd_approvals`(`commands.py:112`)。
352
- pub fn cmd_approvals(args: &ApprovalsArgs) -> Result<CmdResult, CliError> {
353
- let selected = crate::state::selector::resolve_active_team(
354
- &args.workspace,
355
- args.team.as_deref(),
356
- crate::state::selector::SelectorMode::RuntimeOnly,
357
- )
358
- .map_err(|e| CliError::Runtime(e.to_string()))?;
359
- let value = status_port::approvals_scoped(
360
- &selected.run_workspace,
361
- &selected.state,
362
- args.agent.as_deref(),
363
- args.json,
364
- )?;
365
- if args.json {
366
- Ok(CmdResult::from_json(value, true))
367
- } else {
368
- Ok(CmdResult::human(status_port::format_approvals(&value)))
369
- }
370
- }
371
-
372
- /// `cmd_inbox`(`commands.py:137`)。
373
- pub fn cmd_inbox(args: &InboxArgs) -> Result<CmdResult, CliError> {
374
- let selected = crate::state::selector::resolve_active_team(
375
- &args.workspace,
376
- args.team.as_deref(),
377
- crate::state::selector::SelectorMode::RuntimeOnly,
378
- )
379
- .map_err(|e| CliError::Runtime(e.to_string()))?;
380
- let value = status_port::inbox(
381
- &selected.run_workspace,
382
- &args.agent,
383
- args.limit,
384
- Some(&selected.team_key),
385
- )?;
386
- if args.json {
387
- Ok(CmdResult::from_json(value, true))
388
- } else {
389
- Ok(CmdResult::human(format_inbox_human(&args.agent, &value)))
390
- }
391
- }
392
-
393
- const INBOX_LINE_LIMIT_BYTES: usize = 160;
394
-
395
- fn clean_inbox_field(value: &str) -> String {
396
- value.chars().filter(|ch| !ch.is_control()).collect()
397
- }
398
-
399
- fn truncate_inbox_line(line: &str) -> String {
400
- if line.len() <= INBOX_LINE_LIMIT_BYTES {
401
- return line.to_string();
402
- }
403
- let budget = INBOX_LINE_LIMIT_BYTES.saturating_sub("…".len());
404
- let mut end = 0;
405
- for (index, ch) in line.char_indices() {
406
- let next = index + ch.len_utf8();
407
- if next > budget {
408
- break;
409
- }
410
- end = next;
411
- }
412
- format!("{}…", &line[..end])
413
- }
414
-
415
- fn format_inbox_human(agent: &str, value: &Value) -> String {
416
- let messages = value
417
- .get("messages")
418
- .and_then(Value::as_array)
419
- .cloned()
420
- .unwrap_or_default();
421
- if messages.is_empty() {
422
- return format!("{agent}: no messages");
423
- }
424
- messages
425
- .iter()
426
- .map(|message| {
427
- let id = clean_inbox_field(
428
- message
429
- .get("message_id")
430
- .and_then(Value::as_str)
431
- .unwrap_or("-"),
432
- );
433
- let sender =
434
- clean_inbox_field(message.get("sender").and_then(Value::as_str).unwrap_or("-"));
435
- let recipient = clean_inbox_field(
436
- message
437
- .get("recipient")
438
- .and_then(Value::as_str)
439
- .unwrap_or("-"),
440
- );
441
- let status =
442
- clean_inbox_field(message.get("status").and_then(Value::as_str).unwrap_or("-"));
443
- let time = clean_inbox_field(
444
- message
445
- .get("created_at")
446
- .and_then(Value::as_str)
447
- .unwrap_or("-"),
448
- );
449
- let summary =
450
- clean_inbox_field(message.get("summary").and_then(Value::as_str).unwrap_or(""));
451
- truncate_inbox_line(&format!(
452
- "[{id}] [{sender} -> {recipient}] [{status}] [{time}] [{summary}]"
453
- ))
454
- })
455
- .collect::<Vec<_>>()
456
- .join("\n")
457
- }
458
-
459
- /// `cmd_takeover`(`commands.py:152`)。
460
- pub fn cmd_takeover(args: &TakeoverArgs) -> Result<CmdResult, CliError> {
461
- Ok(CmdResult::from_json(
462
- leader_port::takeover(&args.workspace, args.team.as_deref(), args.confirm)?,
463
- args.json,
464
- ))
465
- }
466
-
467
- /// `cmd_claim_leader`(`commands.py:156`)。
468
- pub fn cmd_claim_leader(args: &ClaimLeaderArgs) -> Result<CmdResult, CliError> {
469
- let mut value = leader_port::claim_leader(&args.workspace, args.team.as_deref(), args.confirm)?;
470
- if !args.detail {
471
- leader_port::compact_lease_value(&mut value);
472
- }
473
- Ok(CmdResult::from_json(value, args.json))
474
- }
475
-
476
- /// `cmd_shutdown`(`commands.py:340`)。
477
- pub fn cmd_shutdown(args: &ShutdownArgs) -> Result<CmdResult, CliError> {
478
- Ok(CmdResult::from_json(
479
- lifecycle_port::shutdown(&args.workspace, args.keep_logs, args.team.as_deref())?,
480
- args.json,
481
- ))
482
- }
483
-
484
- /// `cmd_restart`(`commands.py:344`)。
485
- pub fn cmd_restart(args: &RestartArgs) -> Result<CmdResult, CliError> {
486
- let mut value = lifecycle_port::restart(
487
- &args.workspace,
488
- args.allow_fresh,
489
- args.team.as_deref(),
490
- args.session_converge_deadline_ms,
491
- )?;
492
- if !args.detail {
493
- lifecycle_port::compact_restart_value(&mut value);
494
- }
495
- Ok(CmdResult::from_json(value, args.json))
496
- }
497
-
498
- /// `cmd_start_agent`(`commands.py:348`)。
499
- pub fn cmd_start_agent(args: &StartAgentArgs) -> Result<CmdResult, CliError> {
500
- let mut value = lifecycle_port::start_agent(
501
- &args.workspace,
502
- &args.agent,
503
- args.force,
504
- args.allow_fresh,
505
- args.team.as_deref(),
506
- &args.role_config,
507
- )?;
508
- if value.get("agent_ids").is_none() {
509
- if let Some(object) = value.as_object_mut() {
510
- object.insert("agent_ids".to_string(), json!([args.agent.as_str()]));
511
- }
512
- }
513
- append_send_guidance(&mut value, &args.workspace, args.team.as_deref());
514
- Ok(CmdResult::from_json(value, args.json))
515
- }
516
-
517
- /// `cmd_stop_agent`(`commands.py:359`)。
518
- pub fn cmd_stop_agent(args: &StopAgentArgs) -> Result<CmdResult, CliError> {
519
- Ok(CmdResult::from_json(
520
- lifecycle_port::stop_agent(&args.workspace, &args.agent, args.team.as_deref())?,
521
- args.json,
522
- ))
523
- }
524
-
525
- /// `cmd_reset_agent`(`commands.py:363`)。
526
- pub fn cmd_reset_agent(args: &ResetAgentArgs) -> Result<CmdResult, CliError> {
527
- Ok(CmdResult::from_json(
528
- lifecycle_port::reset_agent(
529
- &args.workspace,
530
- &args.agent,
531
- args.discard_session,
532
- args.team.as_deref(),
533
- )?,
534
- args.json,
535
- ))
536
- }
537
-
538
- /// `cmd_add_agent`(`commands.py:373`)。
539
- pub fn cmd_add_agent(args: &AddAgentArgs) -> Result<CmdResult, CliError> {
540
- let mut value = lifecycle_port::add_agent(
541
- &args.workspace,
542
- &args.agent,
543
- &args.role_file,
544
- args.team.as_deref(),
545
- args.force,
546
- &args.role_config,
547
- )?;
548
- if value.get("agent_ids").is_none() {
549
- if let Some(object) = value.as_object_mut() {
550
- object.insert("agent_ids".to_string(), json!([args.agent.as_str()]));
551
- }
552
- }
553
- append_send_guidance(&mut value, &args.workspace, args.team.as_deref());
554
- Ok(CmdResult::from_json(value, args.json))
555
- }
556
-
557
- /// `cmd_fork_agent`(`commands.py:383`)。
558
- pub fn cmd_fork_agent(args: &ForkAgentArgs) -> Result<CmdResult, CliError> {
559
- Ok(CmdResult::from_json(
560
- lifecycle_port::fork_agent(
561
- &args.workspace,
562
- &args.source_agent,
563
- &args.as_agent,
564
- args.label.as_deref(),
565
- args.team.as_deref(),
566
- )?,
567
- args.json,
568
- ))
569
- }
570
-
571
- pub fn cmd_clone_agent(args: &CloneAgentArgs) -> Result<CmdResult, CliError> {
572
- Ok(CmdResult::from_json(
573
- lifecycle_port::clone_agent(
574
- &args.workspace,
575
- &args.source_agent,
576
- &args.as_agent,
577
- args.label.as_deref(),
578
- args.team.as_deref(),
579
- )?,
580
- args.json,
581
- ))
582
- }
583
-
584
- /// `cmd_remove_agent`(`commands.py:394`)。
585
- pub fn cmd_remove_agent(args: &RemoveAgentArgs) -> Result<CmdResult, CliError> {
586
- Ok(CmdResult::from_json(
587
- lifecycle_port::remove_agent(
588
- &args.workspace,
589
- &args.agent,
590
- args.from_spec,
591
- args.confirm,
592
- args.force,
593
- args.team.as_deref(),
594
- )?,
595
- args.json,
596
- ))
597
- }
598
-
599
- /// `doctor` is the single health/diagnostic pipeline.
600
- pub fn cmd_doctor(args: &DoctorArgs) -> Result<CmdResult, CliError> {
601
- if let Some(DoctorGate::Unknown(raw)) = &args.gate {
602
- let value = json!({
603
- "ok": false,
604
- "issues": ["unknown_gate"],
605
- "suggested_repairs": [{"action": "use --gate orphans or --gate comms", "issue": "unknown_gate"}],
606
- "status": "unknown_gate",
607
- "gate": raw,
608
- });
609
- return Ok(crate::cli::triage::report(value, args.json, "doctor"));
610
- }
611
- if args.fix && args.gate.is_none() {
612
- let value = json!({
613
- "ok": false,
614
- "error": "--fix requires --gate",
615
- "issues": ["fix_requires_gate"],
616
- "suggested_repairs": [{"issue": "fix_requires_gate", "action": "add --gate orphans|comms"}],
617
- });
618
- return Ok(crate::cli::triage::report(value, args.json, "doctor"));
619
- }
620
-
621
- let explicit_comms = args.comms || matches!(args.gate, Some(DoctorGate::Comms));
622
- let default_report =
623
- !explicit_comms && args.gate.is_none() && !args.cleanup_orphans && !args.fix_schema;
624
- let mut value = if explicit_comms {
625
- crate::diagnose::comms::doctor_comms_json(
626
- &args.workspace,
627
- args.team.as_deref(),
628
- Some("comms"),
629
- )?
630
- } else if matches!(args.gate, Some(DoctorGate::Orphans)) {
631
- crate::diagnose::orphans::orphan_gate_json(&args.workspace, args.fix, args.confirm)?
632
- } else if args.cleanup_orphans {
633
- crate::diagnose::orphans::cleanup_orphans_json(&args.workspace, args.confirm)?
634
- } else if args.fix_schema {
635
- diagnose_port::fix_schema(&args.workspace)?
636
- } else {
637
- let value = diagnose_port::doctor(&args.workspace, args.spec.as_deref())?;
638
- unified_default_doctor_report(args, value)
639
- };
640
-
641
- if explicit_comms {
642
- if let Some(object) = value.as_object_mut() {
643
- // The comms probe uses a random run id internally for its disposable
644
- // fixture; the public doctor/diagnose report must be alias-stable.
645
- object.insert("run_id".to_string(), Value::String("doctor".to_string()));
646
- }
647
- }
648
- if !default_report {
649
- finalize_doctor_report(&mut value, false);
650
- }
651
- let result = crate::cli::triage::report(value, args.json, "doctor");
652
- Ok(result)
653
- }
654
-
655
- fn unified_default_doctor_report(args: &DoctorArgs, mut value: Value) -> Value {
656
- let team_key = args
657
- .team
658
- .as_deref()
659
- .filter(|team| !team.is_empty())
660
- .unwrap_or("current");
661
- let requested_workspace = args.workspace.to_string_lossy().to_string();
662
- let mut runtime = json!({
663
- "status": "not_present",
664
- "workspace": requested_workspace,
665
- "run_workspace": Value::Null,
666
- "team_key": team_key,
667
- "session_name": Value::Null,
668
- "leader_receiver": Value::Null,
669
- "agent_count": 0,
670
- "message_count": 0,
671
- "result_count": 0,
672
- });
673
- // Resolve explicit selectors and nested team directories before deciding
674
- // that runtime inspection is inapplicable.
675
- let selected = crate::state::selector::resolve_active_team_readonly(
676
- &args.workspace,
677
- args.team.as_deref(),
678
- crate::state::selector::SelectorMode::RuntimeOnly,
679
- );
680
- let run_workspace = selected
681
- .as_ref()
682
- .map(|selected| selected.run_workspace.clone())
683
- .unwrap_or_else(|_| {
684
- crate::model::paths::canonical_run_workspace(&args.workspace)
685
- .unwrap_or_else(|_| args.workspace.clone())
686
- });
687
- let runtime_present = selected.as_ref().is_ok_and(|selected| {
688
- crate::cli::diagnose::workspace_has_existing_team_runtime(
689
- &selected.run_workspace,
690
- &selected.team_key,
691
- )
692
- });
693
- let db_present = crate::model::paths::runtime_dir(&run_workspace)
694
- .join("team.db")
695
- .exists();
696
- // One read-only observation supplies both issue classification and details.
697
- // A physical database must be checked even before state.json is created.
698
- let health = (runtime_present || db_present).then(|| {
699
- crate::coordinator::coordinator_health_read_only(&crate::coordinator::WorkspacePath::new(
700
- run_workspace.clone(),
701
- ))
702
- });
703
- match selected {
704
- Ok(selected) => {
705
- if let Some(health) = health.as_ref().filter(|_| runtime_present) {
706
- let state = selected.state;
707
- let backend: Box<dyn crate::transport::Transport> =
708
- match crate::transport_factory::resolve_read_only_transport(
709
- &selected.run_workspace,
710
- Some(&state),
711
- crate::transport_factory::TransportPurpose::Diagnose,
712
- ) {
713
- Ok(resolved) => resolved.backend,
714
- Err(_) => Box::new(crate::tmux_backend::TmuxBackend::for_workspace(
715
- &selected.run_workspace,
716
- )),
717
- };
718
- let (issues, repairs) = crate::cli::diagnose::diagnose_runtime_for_workspace(
719
- &selected.run_workspace,
720
- &state,
721
- backend.as_ref(),
722
- Some(selected.team_key.as_str()),
723
- health,
724
- );
725
- merge_report_array(&mut value, "issues", &issues);
726
- merge_report_array(&mut value, "suggested_repairs", &repairs);
727
- let brief = crate::cli::status_port::status_brief_scoped(
728
- &selected.run_workspace, &state, None,
729
- );
730
- let observations = brief["nodes"].as_array().into_iter().flatten()
731
- .filter(|node| node.get("observation_reason").is_some()).cloned().collect::<Vec<_>>();
732
- let run_workspace = selected.run_workspace.to_string_lossy().to_string();
733
- runtime = json!({
734
- "status": "present",
735
- "workspace": args.workspace.to_string_lossy().to_string(),
736
- "run_workspace": run_workspace,
737
- "team_key": selected.team_key,
738
- "session_name": state.get("session_name").cloned().unwrap_or(Value::Null),
739
- "leader_receiver": state.get("leader_receiver").cloned().unwrap_or(Value::Null),
740
- "agent_count": state.get("agents").and_then(Value::as_object).map_or(0, serde_json::Map::len),
741
- "observations": observations,
742
- "message_count": count_dir_entries(&selected.run_workspace.join(".team").join("messages")),
743
- "result_count": count_dir_entries(&selected.run_workspace.join(".team").join("results")),
744
- });
745
- }
746
- }
747
- Err(error) => {
748
- runtime["status"] = Value::String("unresolved".to_string());
749
- runtime["observation_reason"] = json!("runtime_selection_failed");
750
- runtime["next_action"] = json!(format!(
751
- "team-agent status --workspace {} --team {} --json; verify the intended workspace/team selector before lifecycle changes",
752
- shell_quote(&requested_workspace), shell_quote(team_key),
753
- ));
754
- append_issue_repair(
755
- &mut value,
756
- "runtime_selection_failed",
757
- format!("unable to select runtime team: {error}"),
758
- );
759
- }
760
- }
761
- if let Some(health) = health {
762
- if db_present && !health.schema.ok {
763
- append_issue_repair(
764
- &mut value,
765
- "coordinator_schema_incompatible",
766
- "team-agent doctor --fix-schema --json".to_string(),
767
- );
768
- }
769
- value["coordinator"] = diagnose_port::coordinator_health_value(health);
770
- }
771
- if let Some(object) = value.as_object_mut() {
772
- object.insert("runtime".to_string(), runtime);
773
- object.insert(
774
- "event_log".to_string(),
775
- Value::String(
776
- run_workspace
777
- .join(".team")
778
- .join("logs")
779
- .join("events.jsonl")
780
- .to_string_lossy()
781
- .to_string(),
782
- ),
783
- );
784
- }
785
- finalize_doctor_report(&mut value, true);
786
- value
787
- }
788
-
789
- fn merge_report_array(report: &mut Value, key: &str, incoming: &Value) {
790
- let Some(items) = incoming.as_array() else {
791
- return;
792
- };
793
- let Some(object) = report.as_object_mut() else {
794
- return;
795
- };
796
- let target = object
797
- .entry(key.to_string())
798
- .or_insert_with(|| Value::Array(Vec::new()));
799
- if !target.is_array() {
800
- *target = Value::Array(Vec::new());
801
- }
802
- let target = target
803
- .as_array_mut()
804
- .expect("report array normalized before merge");
805
- for item in items {
806
- let identity = report_item_identity(item);
807
- if !target
808
- .iter()
809
- .any(|existing| report_item_identity(existing) == identity)
810
- {
811
- target.push(item.clone());
812
- }
813
- }
814
- }
815
-
816
- fn report_item_identity(item: &Value) -> String {
817
- if let Some(text) = item.as_str() {
818
- return text.to_string();
819
- }
820
- let primary = ["id", "code", "issue", "action", "reason", "message"]
821
- .iter()
822
- .find_map(|key| item.get(*key).and_then(Value::as_str));
823
- let scope = ["workspace", "team", "agent", "path", "rule"]
824
- .iter()
825
- .filter_map(|key| item.get(*key).and_then(Value::as_str))
826
- .collect::<Vec<_>>();
827
- let line = item.get("line").and_then(Value::as_u64);
828
- if primary.is_some() || !scope.is_empty() || line.is_some() {
829
- if scope.is_empty() && line.is_none() {
830
- return primary.unwrap_or("object").to_string();
831
- }
832
- return format!(
833
- "{}|{}|{}",
834
- primary.unwrap_or("object"),
835
- scope.join("|"),
836
- line.map_or_else(String::new, |line| line.to_string())
837
- );
838
- }
839
- item.to_string()
840
- }
841
-
842
- fn append_issue_repair(report: &mut Value, issue: &str, repair: String) {
843
- merge_report_array(report, "issues", &json!([issue]));
844
- merge_report_array(
845
- report,
846
- "suggested_repairs",
847
- &json!([{"issue": issue, "action": repair}]),
848
- );
849
- }
850
-
851
- fn finalize_doctor_report(report: &mut Value, default_report: bool) {
852
- let Some(object) = report.as_object_mut() else {
853
- *report = json!({
854
- "ok": false,
855
- "issues": ["invalid_doctor_report"],
856
- "suggested_repairs": [{"issue": "invalid_doctor_report"}],
857
- });
858
- return;
859
- };
860
- let runtime_status = object
861
- .get("runtime")
862
- .and_then(|runtime| runtime.get("status"))
863
- .and_then(Value::as_str)
864
- .unwrap_or("not_run")
865
- .to_string();
866
- let mut issues = object
867
- .remove("issues")
868
- .and_then(|value| value.as_array().cloned())
869
- .unwrap_or_default();
870
- let mut repairs = object
871
- .remove("suggested_repairs")
872
- .and_then(|value| value.as_array().cloned())
873
- .unwrap_or_default();
874
- let mut add = |issue: Value, repair: Option<Value>| {
875
- if !issues
876
- .iter()
877
- .any(|existing| report_item_identity(existing) == report_item_identity(&issue))
878
- {
879
- issues.push(issue);
880
- }
881
- if let Some(repair) = repair {
882
- if !repairs
883
- .iter()
884
- .any(|existing| report_item_identity(existing) == report_item_identity(&repair))
885
- {
886
- repairs.push(repair);
887
- }
888
- }
889
- };
890
-
891
- if !default_report && object.get("ok").and_then(Value::as_bool) == Some(false) {
892
- let status = object
893
- .get("status")
894
- .and_then(Value::as_str)
895
- .or_else(|| object.get("reason").and_then(Value::as_str))
896
- .unwrap_or("doctor_failed");
897
- let issue = if status == "failed" {
898
- object.get("gate").and_then(Value::as_str).map_or_else(
899
- || "doctor_failed".to_string(),
900
- |gate| format!("{gate}_failed"),
901
- )
902
- } else if status.ends_with("_failed") || status == "refused" {
903
- status.to_string()
904
- } else {
905
- format!("{status}_failed")
906
- };
907
- let repair = object
908
- .get("action")
909
- .or_else(|| object.get("next_action"))
910
- .or_else(|| object.get("reason"))
911
- .cloned();
912
- add(
913
- Value::String(issue),
914
- repair.map(|value| json!({"action": value})),
915
- );
916
- }
917
- if object
918
- .get("workspace")
919
- .and_then(Value::as_str)
920
- .is_some_and(|workspace| !std::path::Path::new(workspace).is_dir())
921
- {
922
- add(
923
- json!("invalid_workspace"),
924
- Some(json!({"issue": "invalid_workspace", "action": "use an existing workspace"})),
925
- );
926
- }
927
- if let Some(profile) = object.get("profile_smoke") {
928
- if profile.get("ok").and_then(Value::as_bool) == Some(false)
929
- && profile.get("status").and_then(Value::as_str) != Some("legacy_team_invalid")
930
- {
931
- add(
932
- json!("profile_smoke_failed"),
933
- profile
934
- .get("next_action")
935
- .cloned()
936
- .map(|action| json!({"issue": "profile_smoke_failed", "action": action})),
937
- );
938
- }
939
- }
940
- if let Some(grok) = object.get("grok_slot") {
941
- if grok.get("readable").and_then(Value::as_bool) == Some(false)
942
- || grok.get("consistent").and_then(Value::as_bool) == Some(false)
943
- {
944
- add(
945
- json!("grok_slot_mismatch"),
946
- grok.get("reason")
947
- .cloned()
948
- .map(|reason| json!({"issue": "grok_slot_mismatch", "action": reason})),
949
- );
950
- }
951
- }
952
- if let Some(findings) = object
953
- .get("secret_scan")
954
- .and_then(|scan| scan.get("findings"))
955
- .and_then(Value::as_array)
956
- {
957
- for finding in findings {
958
- let Some(finding_object) = finding.as_object() else {
959
- continue;
960
- };
961
- let Some(rule) = finding_object.get("rule").and_then(Value::as_str) else {
962
- continue;
963
- };
964
- let path = finding_object
965
- .get("path")
966
- .and_then(Value::as_str)
967
- .unwrap_or("unknown");
968
- let line = finding_object
969
- .get("line")
970
- .and_then(Value::as_u64)
971
- .unwrap_or(0);
972
- let issue = json!({
973
- "id": "secret_scan_finding",
974
- "rule": rule,
975
- "path": path,
976
- "line": line,
977
- });
978
- add(
979
- issue,
980
- Some(json!({
981
- "issue": "secret_scan_finding",
982
- "rule": rule,
983
- "path": path,
984
- "line": line,
985
- "action": format!("remove secret finding at {path}:{line}"),
986
- })),
987
- );
988
- }
989
- }
990
- if runtime_status == "unresolved" {
991
- add(
992
- json!("runtime_selection_failed"),
993
- Some(
994
- json!({"issue": "runtime_selection_failed", "action": "select an existing Team runtime"}),
995
- ),
996
- );
997
- }
998
- if runtime_status == "present"
999
- && object
1000
- .get("coordinator")
1001
- .and_then(|coordinator| coordinator.get("ok"))
1002
- .and_then(Value::as_bool)
1003
- == Some(false)
1004
- {
1005
- let reason = object
1006
- .get("coordinator")
1007
- .and_then(|coordinator| coordinator.get("metadata_mismatch_reason"))
1008
- .cloned()
1009
- .unwrap_or_else(|| json!("coordinator unavailable"));
1010
- add(
1011
- json!("coordinator_unavailable"),
1012
- Some(json!({"issue": "coordinator_unavailable", "action": reason})),
1013
- );
1014
- }
1015
- object.insert("issues".to_string(), Value::Array(issues.clone()));
1016
- object.insert("suggested_repairs".to_string(), Value::Array(repairs));
1017
- object.insert("ok".to_string(), Value::Bool(issues.is_empty()));
1018
- }
1019
-
1020
- #[cfg(test)]
1021
- mod tests {
1022
- #![allow(clippy::unwrap_used, clippy::panic)]
1023
-
1024
- use super::{
1025
- append_send_guidance, finish_quick_start, format_inbox_human, quickstart_human,
1026
- send_command, split_shell_argv,
1027
- };
1028
- use crate::cli::{CmdOutput, ExitCode, QuickStartArgs};
1029
- use serde_json::{json, Value};
1030
- use std::path::{Path, PathBuf};
1031
-
1032
- #[test]
1033
- fn inbox_human_output_sanitizes_controls_and_caps_each_line() {
1034
- let value = json!({
1035
- "messages": [{
1036
- "message_id": "msg-\u{001b}[31m".repeat(20),
1037
- "sender": "sender\t\u{001b}[2J".repeat(20),
1038
- "recipient": "worker".repeat(20),
1039
- "status": "delivered",
1040
- "created_at": "2026-09-19T00:00:00Z",
1041
- "summary": "中".repeat(120)
1042
- }]
1043
- });
1044
- let output = format_inbox_human("worker", &value);
1045
- for line in output.lines() {
1046
- assert!(line.len() <= 160, "line is {} bytes: {line:?}", line.len());
1047
- assert!(
1048
- !line.chars().any(char::is_control),
1049
- "controls leaked: {line:?}"
1050
- );
1051
- }
1052
- }
1053
-
1054
- // E13:happy 人类输出必须带 attach 块(此前 else 分支只打 summary 丢 attach_commands)。
1055
- #[test]
1056
- fn e13_quickstart_human_includes_attach_commands() {
1057
- let value = json!({
1058
- "summary": "team started",
1059
- "attach_commands": [
1060
- "tmux -S /tmp/ta-x attach -t team-y:w1",
1061
- "tmux -S /tmp/ta-x attach -t team-y:w2",
1062
- ],
1063
- });
1064
- let out = quickstart_human(&value);
1065
- assert!(
1066
- out.contains("team started"),
1067
- "must show startup summary; got {out}"
1068
- );
1069
- assert!(
1070
- out.contains("Connect to the team:"),
1071
- "must render attach block; got {out}"
1072
- );
1073
- assert!(
1074
- out.contains("team-y:w1") && out.contains("team-y:w2"),
1075
- "must list each attach cmd; got {out}"
1076
- );
1077
- assert!(
1078
- out.ends_with(crate::cli::QUICK_START_REMINDER),
1079
- "must append harness reminder; got {out}"
1080
- );
1081
- }
1082
-
1083
- #[test]
1084
- fn reminders_only_recommend_supported_result_commands() {
1085
- let reminder = crate::cli::QUICK_START_REMINDER;
1086
- assert!(reminder.contains("team-agent status"));
1087
- assert!(reminder.contains("team-agent inbox"));
1088
- for text in [
1089
- reminder,
1090
- crate::cli::STATUS_REMINDER,
1091
- crate::cli::SEND_REMINDER,
1092
- &quickstart_human(&json!({"summary": "team started"})),
1093
- ] {
1094
- for hidden in ["collect", "team-agent results", "team-agent wait"] {
1095
- assert!(
1096
- !text.contains(hidden),
1097
- "private/removed CLI command leaked: {text}"
1098
- );
1099
- }
1100
- }
1101
- }
1102
-
1103
- #[test]
1104
- fn e13_quickstart_human_summary_only_when_no_attach() {
1105
- let value = json!({"summary": "quick-start complete"});
1106
- assert_eq!(
1107
- quickstart_human(&value),
1108
- format!("quick-start complete\n{}", crate::cli::QUICK_START_REMINDER)
1109
- );
1110
- // 空数组也只显示人类摘要与下一步,不凭空编造连接方式。
1111
- let value2 = json!({"summary": "s", "attach_commands": []});
1112
- assert_eq!(
1113
- quickstart_human(&value2),
1114
- format!("s\n{}", crate::cli::QUICK_START_REMINDER)
1115
- );
1116
- }
1117
-
1118
- #[test]
1119
- fn send_command_message_is_one_argv_token() {
1120
- let command = send_command(
1121
- "worker name; echo unsafe",
1122
- Path::new("/tmp/my workspace"),
1123
- Some("team-a"),
1124
- )
1125
- .unwrap();
1126
- let argv = split_shell_argv(&command);
1127
- assert_eq!(
1128
- argv,
1129
- [
1130
- "team-agent",
1131
- "send",
1132
- "worker name; echo unsafe",
1133
- "Complete the task and reply to the leader.",
1134
- "--workspace",
1135
- "/tmp/my workspace",
1136
- "--team",
1137
- "team-a"
1138
- ]
1139
- );
1140
- }
1141
-
1142
- #[test]
1143
- fn send_guidance_is_copyable_and_preserves_explicit_scope() {
1144
- let command = send_command(
1145
- "worker name; echo unsafe",
1146
- Path::new("/tmp/my workspace"),
1147
- Some("team-a"),
1148
- )
1149
- .unwrap();
1150
- assert_eq!(
1151
- command,
1152
- "team-agent send 'worker name; echo unsafe' 'Complete the task and reply to the leader.' --workspace '/tmp/my workspace' --team team-a"
1153
- );
1154
- }
1155
-
1156
- #[cfg(unix)]
1157
- #[test]
1158
- fn non_utf8_workspace_fails_closed_without_send_guidance() {
1159
- use std::ffi::OsString;
1160
- use std::os::unix::ffi::OsStringExt;
1161
-
1162
- let workspace = PathBuf::from(OsString::from_vec(b"/tmp/workspace-\xff".to_vec()));
1163
- assert!(send_command("worker", &workspace, None).is_none());
1164
- let mut value = json!({"ok": true, "agent_ids": ["worker"]});
1165
- append_send_guidance(&mut value, &workspace, None);
1166
- assert!(value.get("send_commands").is_none());
1167
- }
1168
-
1169
- #[test]
1170
- fn quick_start_guidance_lists_every_known_agent_without_guessing() {
1171
- let mut value = json!({"ok": true, "agent_ids": ["sol", "luna"]});
1172
- append_send_guidance(&mut value, Path::new("/tmp/ws"), Some("team"));
1173
- let commands = value
1174
- .get("send_commands")
1175
- .and_then(|v| v.as_array())
1176
- .unwrap();
1177
- assert_eq!(commands.len(), 2);
1178
- assert!(commands[0].as_str().unwrap().contains("send sol"));
1179
- assert!(commands[1].as_str().unwrap().contains("send luna"));
1180
- }
1181
-
1182
- #[test]
1183
- fn error_results_do_not_get_send_guidance() {
1184
- let mut value = json!({"ok": false, "agent_ids": ["worker"]});
1185
- append_send_guidance(&mut value, Path::new("/tmp/ws"), None);
1186
- assert!(value.get("send_commands").is_none());
1187
- }
1188
-
1189
- #[test]
1190
- fn existing_runtime_gets_canonical_send_guidance() {
1191
- let mut value = json!({
1192
- "ok": false,
1193
- "summary": "existing runtime",
1194
- "agent_ids": ["worker"]
1195
- });
1196
- append_send_guidance(&mut value, Path::new("/tmp/ws"), Some("team-a"));
1197
- let command = value
1198
- .pointer("/send_commands/0")
1199
- .and_then(Value::as_str)
1200
- .unwrap();
1201
- assert!(command.contains("send worker"));
1202
- assert!(command.contains("--team team-a"));
1203
- assert_eq!(
1204
- split_shell_argv(command),
1205
- [
1206
- "team-agent",
1207
- "send",
1208
- "worker",
1209
- "Complete the task and reply to the leader.",
1210
- "--workspace",
1211
- "/tmp/ws",
1212
- "--team",
1213
- "team-a",
1214
- ]
1215
- );
1216
- }
1217
-
1218
- fn quick_start_args(as_json: bool) -> QuickStartArgs {
1219
- QuickStartArgs {
1220
- workspace: PathBuf::from("/tmp/first-launch"),
1221
- agents_dir: PathBuf::from("/tmp/first-launch/.team/current"),
1222
- name: None,
1223
- team_id: None,
1224
- yes: true,
1225
- json: as_json,
1226
- detail: false,
1227
- backend: None,
1228
- }
1229
- }
1230
-
1231
- #[test]
1232
- fn quick_start_human_preserves_typed_refusals_without_error_field() {
1233
- for status in [
1234
- "existing_runtime",
1235
- "preflight_blocked",
1236
- "leader_binding_refused",
1237
- ] {
1238
- let value = json!({
1239
- "ok": false,
1240
- "status": status,
1241
- "reason": "the exact underlying refusal",
1242
- "summary": "creation refused",
1243
- "blockers": [{"stage": "identity", "reason": "owner mismatch"}],
1244
- "next_actions": ["team-agent restart --workspace /tmp/first-launch --team current"],
1245
- "state_path": "/tmp/first-launch/.team/runtime/state.json",
1246
- "readiness": {"reason": "underlying readiness evidence"}
1247
- });
1248
- let result = finish_quick_start(value.clone(), &quick_start_args(false)).unwrap();
1249
- assert_eq!(result.exit, ExitCode::Error);
1250
- let CmdOutput::Human(text) = result.output else {
1251
- panic!("expected human report")
1252
- };
1253
- let rendered: Value =
1254
- serde_json::from_str(text.strip_prefix("quick-start report:\n").unwrap()).unwrap();
1255
- assert_eq!(rendered, value, "human projection lost fields for {status}");
1256
- assert!(
1257
- !text.contains("team-agent doctor"),
1258
- "must not replace actual actions"
1259
- );
1260
- let json_result = finish_quick_start(value.clone(), &quick_start_args(true)).unwrap();
1261
- assert_eq!(json_result.exit, ExitCode::Error);
1262
- assert_eq!(json_result.output, CmdOutput::Json(value));
1263
- }
1264
- }
1265
-
1266
- #[test]
1267
- fn quick_start_human_preserves_original_error_and_actions() {
1268
- let value = json!({
1269
- "ok": false,
1270
- "error": "database initialization failed at /tmp/first-launch/.team/team.db: permission denied",
1271
- "action": "repair directory permissions",
1272
- "next_actions": ["inspect the exact database path"]
1273
- });
1274
- let result = finish_quick_start(value.clone(), &quick_start_args(false)).unwrap();
1275
- assert_eq!(result.exit, ExitCode::Error);
1276
- let CmdOutput::Human(text) = result.output else {
1277
- panic!("expected human report")
1278
- };
1279
- let rendered: Value =
1280
- serde_json::from_str(text.strip_prefix("quick-start report:\n").unwrap()).unwrap();
1281
- assert_eq!(rendered, value);
1282
- }
1283
-
1284
- #[test]
1285
- fn pending_tool_load_is_not_reported_as_failed_team_creation() {
1286
- for as_json in [false, true] {
1287
- let value = json!({
1288
- "ok": true,
1289
- "status": "pending_tool_load",
1290
- "summary": "Team started; worker tool loading is not yet verified",
1291
- "readiness": {"ready": false},
1292
- "next_actions": ["send a task and wait for the actual reply"]
1293
- });
1294
- let result = finish_quick_start(value, &quick_start_args(as_json)).unwrap();
1295
- assert_eq!(result.exit, ExitCode::Ok);
1296
- }
1297
- }
1298
- }