@@ -28,17 +28,31 @@ wtnew my-feature
2828pnpm install
2929# ... edit, test, commit ...
3030
31- # Submit from the feature worktree
32- mq submit
31+ # Validate before submitting (dry run)
32+ mq submit --check-only
33+
34+ # Submit and wait for integration to complete
35+ mq submit --wait --timeout 15m
3336
34- # Integrate and publish from the main worktree
37+ # Or submit and integrate/publish manually from the main worktree
38+ mq submit
3539mq run-once
3640mq publish
3741
3842# Clean up
3943wtdrop <worktree-path>
4044```
4145
46+ ### Submit options
47+
48+ - ` mq submit ` — queue the branch for integration
49+ - ` mq submit --check-only ` — dry-run validation (no side effects)
50+ - ` mq submit --wait ` — submit and block until integration finishes
51+ - ` mq submit --wait --timeout 15m ` — with timeout
52+ - ` mq submit --allow-newer-head ` — allow if branch advanced since last
53+ submit
54+ - Add ` --json ` to any command for machine-readable output
55+
4256### Handling failures
4357
4458- If ` mq run-once ` fails (conflict, test failure), the protected branch
@@ -52,6 +66,7 @@ wtdrop <worktree-path>
5266- ` mq status ` — current queue state
5367- ` mq doctor ` — health check (branch, locks, queue)
5468- ` mq repo show ` — config and worktree info
69+ - ` mq repo root ` — canonical root trust status
5570- ` mq logs --follow ` — integration history
5671- ` mq watch ` — live queue updates
5772- ` mq events --follow ` — raw audit trail
0 commit comments