Skip to content

Commit 908ca39

Browse files
docs(agents): add submit --wait, --check-only, and --json flags
Update mainline workflow docs with latest mq features: submit dry-run, wait mode, allow-newer-head, repo root trust, and --json for machine-readable output. Co-authored-by: Andrew <andrewxhill@gmail.com>
1 parent d520975 commit 908ca39

1 file changed

Lines changed: 18 additions & 3 deletions

File tree

AGENTS.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,17 +28,31 @@ wtnew my-feature
2828
pnpm 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
3539
mq run-once
3640
mq publish
3741
3842
# Clean up
3943
wtdrop <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

Comments
 (0)