| name | maestro-session-manage |
| disable-model-invocation | true |
| description | Manage a v3 Session — inspect status/resume-view, review knowledge candidates, complete, archive/unarchive |
| argument-hint | [--session <session_id>] [--complete|--archive|--unarchive|--knowledge] [-y] [--skip-knowledge] |
| allowed-tools | ["Bash","Edit","Glob","Grep","Read","Write","followup_task","interrupt_agent","list_agents","request_user_input","send_message","spawn_agent","spawn_agents_on_csv","wait_agent"] |
| session-mode | run |
| contract | {"discovery":"self-described","consumes":[],"produces":[]} |
| version | 0.5.83 |
<required_reading>
@/.maestro/workflows/run-mode.md
@/.maestro/workflows/codex-run-mode.md
</required_reading>
If any required file above was not expanded into context by the host, or its content is no longer in context, Read it explicitly before executing any step.
Manage the lifecycle of a v3 Session (`session/3.0`) through its read-only projections, knowledge governance, and explicit lifecycle transitions.
Session completion (maestro session complete) is part of the default Run loop — Ralph S_DONE, the orchestrator run loop, and Companion all execute it when the chain turns terminal. This command is the management surface: inspection, knowledge candidate review/promotion, and the explicit transitions the default loop does not perform (--complete for manual pipelines, --archive/--unarchive for optional freezing).
Run completion already stages accepted decisions, locked constraints, and explicit maestro knowledge stage entries. This command reviews those receipts; it does not re-extract the same artifacts or write project knowledge through a second path.
$ARGUMENTS -- optional session ID and action flags.
Actions (first match wins; default = inspect):
| Flag | Effect |
|---|
| (none) | Inspect: session status + session resume-view projection |
--complete | Readiness check → knowledge reconciliation → fenced maestro session complete → DAG progression |
--archive | Fenced maestro session archive (only from completed/failed; optional freeze) |
--unarchive | Fenced maestro session unarchive (only from archived; returns to open) |
--knowledge | Knowledge review/promotion only — no lifecycle mutation |
Shared flags:
| Flag | Effect | Default |
|---|
--session <id> | Target session (slug or full ID) |
```
=== SESSION {ACTION RESULT} ===
Session: {session_id}
Action: {inspect|complete|archive|unarchive|knowledge}
Status: {open|completed|archived|failed} (orchestration_revision {n})
Knowledge: {promoted_count} promoted, {pending_count} pending, {review_required_count} review required, {suppressed_count} suppressed
Next dep-ready: {next_slug or "none (DAG complete)" or "n/a"}
--- STATUS ---
Status: DONE
```
