log-tail-qa

Assert regex patterns in log streams within bounded timeouts.

33|5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/kylesnowschwartz/ralph-ban --skill log-tail-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log-tail-qa
Source: https://github.com/kylesnowschwartz/ralph-ban/tree/main/skills/log-tail-qa
Command: npx skills add https://github.com/kylesnowschwartz/ralph-ban --skill log-tail-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires timeout, grep, awk, stat, tail, jq.

What problem does it solve?

Verifying that an asynchronous system actually emitted a specific log line (and doing so reliably) is hard, because the log may already contain historical entries, may buffer output, may rotate, or may stop growing without the expected event.

Core Features & Use Cases

  • Bounded log waiting: Tails a log with a configurable timeout and fails deterministically instead of waiting forever.
  • History vs tail semantics: Chooses include/exclude behaviour so the check correctly matches either “already happened” or “must happen after this starts”.
  • Occurrence counting: Supports asserting N occurrences using line-based accumulation rather than first-match-only grep patterns.
  • No-progress fail-fast: Detects when the log file stops growing across polls and rejects early when the system appears stuck or writes elsewhere.
  • Evidence capture for audits: Saves the matched lines, surrounding context, and verdict details into the oracle evidence directory.

Quick Start

Use the log-tail-qa skill to verify that a regex pattern appears in the target log within a bounded time window and capture the matching lines plus tail context for audit evidence.

Frequently Asked Questions about log-tail-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify that a specific log line appears in a file within a bounded time window?

To verify log line appearance within a bounded time, you can tail a log file with a configurable timeout, asserting a regex pattern matches deterministically instead of waiting forever. This captures matched lines and tail context for an auditable verdict.

What is the best way to test asynchronous CLI behavior using log output?

Testing asynchronous CLI behavior using log output involves asserting that a streamed log source contains a regex pattern within a bounded time window. This applies oracle-driven TUI and CLI verification scenarios where card state transitions depend on log emission.

How do I detect if a log file stops growing during asynchronous testing?

To detect if a log file stops growing during asynchronous testing, you can use a no-progress fail-fast mechanism that polls the log across intervals. It rejects early and fails deterministically when the system appears stuck or writes elsewhere.

Can I assert that a regex pattern matches exactly N times in a log file?

Yes, you can assert that a regex pattern matches exactly N times in a log file by using line-based accumulation for occurrence counting. This supports asserting N matches rather than relying on first-match-only grep patterns.

Does log tail verification work with container streams and captured stdout?

Log tail verification works with container streams, captured stdout/stderr, file tails, and journal streams. It handles history-vs-tail semantics to correctly match entries that already happened or must happen after verification starts.

How do I save matched log lines and context for an auditable test verdict?

To save matched log lines and context for an auditable test verdict, you can capture evidence into an oracle evidence directory. This persists matched lines, surrounding context, and verdict details for later review.