@team-agent/installer 0.5.72 → 0.5.74

package/skills/team-agent/references/team-agent-operator.md

@@ -96,6 +96,8 @@ EOF
 team-agent quick-start .team/current
 ```
 
+That copy-paste role is Codex-specific. Provider tool categories are not portable: Pi roles must contain `mcp_team` and may use only `fs_read`, `fs_list`, `fs_write`, and `execute_bash`; do not carry `provider_builtin`, `git_diff`, or `network` into a Pi role. `team-agent compile`/`validate` rejects an unsupported Pi category before quick-start persists runtime state, and the error names the category to remove.
+
 YAML lists must be block style. Use `tools:\n  - fs_read`; do not use `tools: [fs_read, mcp_team]`.
 
 Display choices (set `display_backend:` in `TEAM.md` to opt in):
@@ -122,9 +124,11 @@ team-agent claim-leader --help
 Observed (exit 0):
 
 ```text
-usage: team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json]
+usage: team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json] [--detail]
 ```
 
+Default JSON for `quick-start`, `restart`, and `claim-leader` is compact: `ok`, `status`/`reason`, next action, attach/send. `quick-start` keeps a short `readiness` object with `all_workers_spawned`. Pass `--detail` for internal receiver/topology/coordinator diagnostics.
+
 Run `claim-leader` only from the **leader** pane. From a worker pane it refuses and prints a structured `action` (see Failure Rules).
 
 ## Provider Capability Matrix
@@ -264,7 +268,7 @@ team-agent shutdown --help
 Observed (all exit 0):
 
 ```text
-usage: team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json]
+usage: team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json] [--detail]
 usage: team-agent add-agent AGENT --role-file FILE [--force] [--workspace WORKSPACE] [--team TEAM] [--no-display] [--json]
 usage: team-agent shutdown [--workspace WORKSPACE] [--team TEAM] [--keep-logs] [--json]
 ```
@@ -480,6 +484,7 @@ team-agent approvals <agent_id>
 team-agent approvals [coder]
 team-agent attach-leader
 team-agent claim-leader
+team-agent claim-leader --detail
 team-agent claude
 team-agent clone-agent <source> --as <new>
 team-agent codex
@@ -501,12 +506,14 @@ team-agent quick-start ./roles --team-id alpha
 team-agent quick-start .team/alpha
 team-agent quick-start .team/current
 team-agent quick-start <dir>
+team-agent quick-start --json --detail
 team-agent remove-agent <agent> --workspace . --confirm
 team-agent reset-agent <agent> --discard-session
 team-agent restart
 team-agent restart .
 team-agent restart . --allow-fresh
 team-agent restart . --team <session_name_or_team_name>
+team-agent restart --json --detail
 team-agent send --task task_initial "Start"
 team-agent send --watch-result
 team-agent send --watch-result coder "Do the bounded task"