Keeping GitHub Actions reruns in an attempt ledger

说明与用途

gha‑rerun‑ledger CLI 通过避免重复计数重跑作业，准确聚合 GitHub Actions 的作业时间，并提供离线重放的快照。

问题

GitHub Actions reruns can duplicate successful jobs from earlier attempts, leading to inflated time and cost estimates when aggregating run data.

结果

The tool accurately reports elapsed job times for failed and successful attempts (163 s and 102 s in the demo) without double‑counting carried jobs, and provides an offline replayable snapshot.

工作流

• 1. Run the CLI to walk attempts in order and assign each job ID to its first observed attempt.
• 2. For each subsequent attempt, check that the job name, execution owner, conclusion, timestamps, labels, and steps match the first record.
• 3. If any record conflicts, fail the report.
• 4. Sum job times only after a complete sequence of attempts and pages is collected.
• 5. Separate viewed jobs from owned jobs so carried rows remain visible without double‑counting elapsed time.
• 6. Generate a ledger row for every attempt, including empty attempts.
• 7. Report skipped jobs, missing or reversed intervals, inferred owners, and runs above the attempt cap in coverage counts or warnings.
• 8. Optionally save a schema‑version‑1 JSON snapshot of the run and job API responses for offline replay.
• 9. Replay the snapshot with the CLI using --input to validate without GitHub access.

证据

I built gha-rerun-ledger for a narrow task: inspect the attempts behind recent completed GitHub Actions runs, then keep enough metadata to replay the report offline.

来源

A workflow rerun can show successful jobs that carried over from an earlier attempt. Counting every row in every attempt would count that work more than once.

来源

The CLI walks attempts in order and assigns each job ID to its first observed attempt. If a later page returns that ID again, the report checks that the name, execution owner, conclusion, timestamps, labels, and steps agree.

来源

The report separates viewed jobs from owned jobs, so a carried row stays visible without adding its elapsed interval twice.

来源

Job time is the difference between the job start and completion timestamps. Parallel jobs add together. Step intervals are ranked separately and are not added to job time.

来源

A live scan uses GET requests through GitHub CLI and can save a schema version 1 JSON snapshot.

来源

Try the labeled synthetic demo with: npx --yes github:Arthur031221/gha-rerun-ledger --demo

来源