Skip to main content
← Back to list
01Issue
BugShippedSwamp CLI
Assigneesstack72

Relationships

#729 serve --webhook usage string makes <header> look optional for generic scheme

Opened by keeb · 6/21/2026· Shipped 6/23/2026

The --webhook flag description in src/cli/commands/serve.ts (~lines 125–126) documents the spec as:

<route>:<workflow>:<secret>[:<scheme>[:<header>[:<prefix>]]]

The nesting makes <header> look optional in all cases, but the generic scheme errors if <header> is missing ('generic' scheme requires a header name).

Impact: Cosmetic — the runtime error is clear, so this is a docs/UX nit. A scheme-specific hint such as generic:<header-required>[:<prefix>] would set expectations correctly up front.

Severity: Trivial — usage-string wording only.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

6/23/2026, 8:06:57 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack726/23/2026, 6:09:00 PM

Sign in to post a ripple.