leanprover / leanprover/lean4

feat: `lake build --summary` flag to print build outcome table

Open
#13,316 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

changelog-lake P-medium
Dominant language
Lean
Stars
9.2k
Forks
990
Avg merge
1d 17h
Merged PRs (30d)
175

Description

When building large projects, it would be useful to have a lake build --summary flag that prints a summary table at the end of the build, including:

  • Number of files built successfully
  • Number of files built successfully but with info and/or warnings
  • For each file with an error, the number of downstream jobs that were not run as a result

This gives a quick at-a-glance picture of build health, especially useful for large projects where errors early in the dependency graph can cascade and block many downstream modules.

Example output (illustrative):

Build summary:
  ✔ 142 succeeded
  ⚠   3 succeeded with warnings
  ✖   2 failed
    Mathlib.Topology.Basic (blocked 27 downstream jobs)
    Mathlib.Order.Filter.Basic (blocked 14 downstream jobs)

🤖 Prepared with Claude Code

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the lake build entry point and trace how build jobs record successes, warnings, errors, and downstream jobs that are skipped. Define the summary table and its blocked-job counts, then verify the --summary output against builds containing successes, warnings, and dependency failures.

Written by the indexing model from the issue text.

Assessment

Domain
build-system, cli
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.