[build-tools] Add eas/posthog_wait_for_query workflow function

[gwdp]

Why

Gate an EAS workflow on any PostHog condition you can express in HogQL, not just a numeric threshold. Wait until a query is true before continuing. Sibling to wait_for_metric for when the condition is a string match, a compound expression, or anything operator/threshold can't say.

How

Adds eas/posthog_wait_for_query. Polls a HogQL query that returns a single boolean, until it's true, every interval_seconds (default 30) for up to timeout_seconds (default 600). The query is the condition, so PostHog does the comparison instead of us reimplementing it.

Same shape as the metric gate: no ignore_error (timing out fails the step), network/429/5xx retry until the deadline, auth and query errors fail right away. Shares the query transport with wait_for_metric.

Test Plan

CI passes. Ran it live against coin-flip: query_true continues right away and query_timeout fails on timeout as intended. Test workflow below (true, timeout, and a string-condition job).

Test workflow

name: PostHog wait-for-query test

jobs:
  query_true:
    steps:
      - uses: eas/posthog_wait_for_query
        with:
          query: select count() >= 0 from events

  query_timeout:
    steps:
      - uses: eas/posthog_wait_for_query
        with:
          query: select count() < 0 from events
          interval_seconds: 5
          timeout_seconds: 20

  query_string_condition:
    steps:
      - uses: eas/posthog_wait_for_query
        with:
          query: select count() > 0 from events where event = 'coin_flipped'
          interval_seconds: 5
          timeout_seconds: 20

[linear-code]

ENG-21551

[gwdp]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• [build-tools] Add eas/posthog_wait_for_query workflow function #3949 👈 (View in Graphite)
• [build-tools] Add eas/posthog_annotation workflow function #3948
• [build-tools] Add eas/posthog_upload_sourcemaps workflow function #3947
• [build-tools] Add eas/posthog_wait_for_metric workflow function #3945
• [build-tools] Add eas/posthog_flag_rollout workflow function #3944
• [build-tools] Add eas/posthog_capture_event workflow function #3934
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 59.65%. Comparing base (a437436) to head (150dc15).

Additional details and impacted files

@@                          Coverage Diff                          @@
##           gwdp/eng-21551-posthog-annotation    #3949      +/-   ##
=====================================================================
+ Coverage                              59.62%   59.65%   +0.04%     
=====================================================================
  Files                                    943      944       +1     
  Lines                                  41467    41503      +36     
  Branches                                8729     8734       +5     
=====================================================================
+ Hits                                   24719    24755      +36     
  Misses                                 16654    16654              
  Partials                                  94       94              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

✅ Thank you for adding the changelog entry!

[github-actions]

Subscribed to pull request

File Patterns	Mentions
**/*	@douglowder

Generated by CodeMention

Warning: The preamble and epilogue options in commentConfiguration are deprecated. Use template instead.