063-land-verbs
The land verbs wait for, arm, push and restack a pull request, and land status orders what is left
Amends spec 006's command surface; its four write verbs act under the F-02 narrowing of 2026-10-27 and never inside a run attempt (D-5). Six verbs act on a pull request's way to the default branch through the operator's gh: `land wait` blocks until a named event, `land arm` enables auto-merge only for a head the AI review passed on a pull request based on the default branch, `land push` pushes a signed head with a lease after disarming, `land restack` moves a stacked pull request onto its new base and regenerates only declared generated paths, and `land status` orders the open pull requests by their next action, and `land cancel-superseded` cancels runs no open pull request needs. The adopter's values (default branch, stack caps, generated paths and their regenerators, pre-push checks) come from a `landing` block in the project declaration; a value no layer supplies is refused, never defaulted. Only `land arm` arms, and nothing here approves, merges or re-runs.
Read the full pinned specification ↗Relationships
depends on
amends
Claimed units
- establishes
{ "kind": "directory", "path": "crates/statecraft-land/" } - extends
{ "nature": "additive", "spec": "002-environment-lifecycle", "unit": { "kind": "directory", "path": "crates/statecraft-environment/" } } - extends
{ "nature": "additive", "spec": "002-environment-lifecycle", "unit": { "kind": "directory", "path": "crates/statecraft-home/" } } - extends
{ "nature": "additive", "spec": "006-command-surface", "unit": { "kind": "directory", "path": "crates/statecraft-cli/" } }
Source headings
- 063: The land verbs
- 1. Purpose
- 2. Territory
- 3. Behavior
- 3.1 The landing policy
- 3.2 `land wait`
- 3.3 `land arm`
- 3.4 `land push`
- 3.5 `land restack`
- 3.6 `land status`
- 3.7 `land cancel-superseded`
- 3.8 Exit codes
- 3.9 Never inside a run attempt
- 4. Out of scope
- 5. Observable negative cases
- 6. Delivery
- 7. Resolved decisions
- Implementation record
- Verification
Frozen anchors
No frozen anchors declared.