sahit-sai ci-logbook
Purpose
Turn raw CI or workflow logs into a concise incident-style brief with the first real errors up front.
Runbook
- Collect one or more local CI log files or paste log text through stdin.
- Run
scripts/summarize.pyto extract error counts, warning counts, traceback markers, and representative lines. - Review the first-failure excerpts before proposing reruns or fixes; the goal is diagnosis, not blind retries.
- Share either the JSON payload or markdown summary with the operator.
Stop conditions
- Abort if the logs are incomplete or obviously truncated before the failure point.
- Abort before recommending destructive cleanup or credential rotation from log text alone.
- Abort if the current variant cannot access the required local log files.
Output format
- Per-file counts for errors, warnings, failures, and traceback markers
- First high-signal excerpts with line numbers
- A short next-actions section
Example invocations
python3 skills/ci-logbook/scripts/summarize.py .github/logs/build.log --markdowncat build.log | python3 skills/ci-logbook/scripts/summarize.py -