063-land-verbs

The land verbs wait for, arm, push and restack a pull request, and land status orders what is left

Lifecycle approvedImplementation completeVerification unknownQualification unknown

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

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

  1. 063: The land verbs
  2. 1. Purpose
  3. 2. Territory
  4. 3. Behavior
  5. 3.1 The landing policy
  6. 3.2 `land wait`
  7. 3.3 `land arm`
  8. 3.4 `land push`
  9. 3.5 `land restack`
  10. 3.6 `land status`
  11. 3.7 `land cancel-superseded`
  12. 3.8 Exit codes
  13. 3.9 Never inside a run attempt
  14. 4. Out of scope
  15. 5. Observable negative cases
  16. 6. Delivery
  17. 7. Resolved decisions
  18. Implementation record
  19. Verification

Frozen anchors

No frozen anchors declared.