From f7a64c7ad05813bdcac4029719e5166693e3b33e Mon Sep 17 00:00:00 2001 From: Tor Colvin Date: Fri, 21 Aug 2026 15:33:19 -0400 Subject: [PATCH] CBG-5715: attach the compaction phase enum to phase, not dry_run MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The `mark`/`sweep`/`cleanup` enum was indented one property too far down, so it constrained `dry_run` (a `bool` in Go, previously also documented as a string) while `phase` — the field that actually carries those values — was documented as an unconstrained string. Move the enum onto `phase`, document each value, and correct `dry_run` to boolean. Co-Authored-By: Claude Opus 5 (1M context) --- docs/api/components/schemas.yaml | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/api/components/schemas.yaml b/docs/api/components/schemas.yaml index 3a39115505..8f246c709d 100644 --- a/docs/api/components/schemas.yaml +++ b/docs/api/components/schemas.yaml @@ -2206,14 +2206,18 @@ Compact-status: For failed processes, this indicates the phase at which a compact_id restart will commence (where relevant). type: string - dry_run: - description: | - **Applicable to attachment compaction only** - type: string enum: - mark - sweep - cleanup + x-enumDescriptions: + mark: Scanning documents to find attachments still in use. + sweep: Deleting attachments that are no longer used. + cleanup: Finishing up and clearing temporary compaction data. + dry_run: + description: | + **Applicable to attachment compaction only** + type: boolean required: - status - start_time