Skip to main content
← Back to list
01Issue
FeatureShippedSwamp ClubPublic
Assigneesstack72

Relationships

#1853 Docs: document --filter flag on workflow history search

Opened by stack72 · 8/26/2026· Shipped 8/27/2026

What changed

PR #2269 added a --filter flag to swamp workflow history search that accepts a CEL expression over run metadata.

Pages to update in swamp-club/swamp-club

content/manual/reference/workflows.md

Add --filter to the workflow history search section:

  • Flag: --filter <expression> — filter results with a CEL expression
  • Available fields: workflowName, status, startedAt, completedAt, duration, inputs.*, tags.*, instanceId, triggerSource, failedStep, failureReason
  • Duration is in milliseconds (double); timestamps are ISO 8601 strings (lexicographic comparison works)
  • Missing map keys return false (don't crash)
  • Examples:
    swamp workflow history search --filter 'inputs.commit == "b3ff3a8a"'
    swamp workflow history search --filter 'status == "failed"'
    swamp workflow history search verify-reviews --filter 'inputs.branch == "main"'
    swamp workflow history search --filter 'duration > 60000'

content/manual/reference/cel-expressions.md

Add workflow history filtering as a new context where CEL expressions are used. Note the same complexity limits as grant conditions (1024 char max, AST depth 24, comprehension nesting 2, cost budget 500).


Automoved by swampadmin from https://github.com/swamp-club/swamp/issues/2270

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 4 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

8/27/2026, 12:35:46 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack728/27/2026, 12:20:05 AM

Sign in to post a ripple.