# gz patch release(1) -- GHI-driven patch release ceremony

## SYNOPSIS

```
gz patch release [--dry-run] [--json] [--full]
```

## DESCRIPTION

Execute the GHI-driven patch release ceremony. Discovers two release
qualifiers since the last tag — behavior-level GHIs (cross-validated by
runtime label AND source diff) and foundation-ADR closeouts (Gate-5
`validated` receipts in the ledger) — bumps the patch version, and writes
a dual-format release manifest. With `--full`, also drafts release notes,
commits, pushes behind lint/test gates, and creates the GitHub release.

Both qualifiers carry equal weight: per the hexagonal port/adapter
doctrine, foundation ADRs (ports) ship code surfaces just as feature ADRs
(adapters) do, so a foundation closeout is a release-worthy event in its
own right.

## OPTIONS

`--dry-run`
:   Show planned actions without executing.

`--json`
:   Emit machine-readable JSON to stdout.

`--full`
:   Execute the full ceremony in one transaction: bump, draft release notes, commit, push (with lint/test gates), and create the GitHub release.

## EXIT CODES

| Code | Meaning |
|------|---------|
| 0 | Success (or dry-run preview) |
| 1 | User/config error |
| 2 | System/IO error |
| 3 | Policy breach |

## EXAMPLES

Preview what the patch release would do:

```bash
uv run gz patch release --dry-run
```

```
Patch Release Discovery (dry run)
  Latest tag: v0.26.5 (2026-05-17T17:32:41-05:00)
  Version: 0.26.5 -> 0.26.6 (proposed)
  GHIs discovered: 17
  Foundation closeouts: 1

  #483    kind-invariance: 10 legacy foundation ADRs ...   qualified
  ...

Foundation-ADR closeouts
  ADR-0.0.36-universal-obpi-attestation        validated  (2026-05-18)
```

Machine-readable output:

```bash
uv run gz patch release --json
```

## SEE ALSO

`gz closeout`(1)
