Skip to content

chore(blueprint): regenerate web + pdf artifacts (5-month refresh)#127

Merged
cameronfreer merged 2 commits into
mainfrom
regen-blueprint-v1.3
May 27, 2026
Merged

chore(blueprint): regenerate web + pdf artifacts (5-month refresh)#127
cameronfreer merged 2 commits into
mainfrom
regen-blueprint-v1.3

Conversation

@cameronfreer

Copy link
Copy Markdown
Owner

Summary

The checked-in blueprint artifacts under blueprint/web/ and blueprint/print/print.pdf were last regenerated 2026-01-09 (commit 27cfbbc5, "fix(ci): Commit pre-built blueprint, simplify workflow to just deploy"); 5 months and ~120 PRs of content drift have accumulated since.

Re-ran leanblueprint pdf and leanblueprint web against the current blueprint/src/content.tex (which IS up-to-date — verified by python3 blueprint/check_blueprint.py).

What refreshed

File Δ
blueprint/print/print.pdf binary; 57,629 → 90,504 bytes
blueprint/web/dep_graph_document.html +1,099 / −5
blueprint/web/sect0004.html +1,743 / −50 (the big proofs section)
blueprint/web/sect0002.html +252 / −36
blueprint/web/sect0006.html +194 / −24
blueprint/web/sect0005.html +191 / −18
blueprint/web/index.html +118 / −7
blueprint/web/sect0003.html +73 / −8
blueprint/web/sect0001.html +63 / −10
Total 9 files, +3,576 / −315

The refresh picks up content added in PR #89 and follow-ups: the "Comparing the two endings" section, the new theorem splits, the promoted bridge lemmas, etc.

Not refreshed in this PR

Four import-graph artifacts under blueprint/web/ are produced by doc-gen4 (in the CI Deploy documentation workflow), not by leanblueprint, so they cannot be refreshed locally:

  • import_graph_colored.html
  • import_graph_colored.png
  • import_graph_colored.svg
  • import_graph_full_declarations.html

The last of these still mentions deleted declarations like contractable_map_single / contractable_map_pair / contractable_comp / map_coords_apply from PRs #120/#121. The live GitHub Pages deploy IS current (the Deploy documentation workflow runs doc-gen4 on every push to main), so the canonical view is fresh — only the checked-in mirror is stale. Worth a tracking issue.

Sanity checks

  • lake build — 3527/3527, 0 warnings
  • lake exe checkdecls blueprint/lean_decls — passes
  • python3 blueprint/check_blueprint.py — 52 cites / 52 labels / 50 refs/uses / 52 lean_decls, all consistent
  • 0 sorries

(blueprint/lean_decls itself was untouched — leanblueprint had stripped its trailing newline, which I restored.)

The checked-in blueprint artifacts under `blueprint/web/` and
`blueprint/print/print.pdf` were last regenerated 2026-01-09
(commit 27cfbbc, "fix(ci): Commit pre-built blueprint, simplify
workflow to just deploy"); 5 months and ~120 PRs of content drift have
accumulated since.

Re-ran `leanblueprint pdf` and `leanblueprint web` against the current
`blueprint/src/content.tex` (which IS up-to-date per
`python3 blueprint/check_blueprint.py`). The refreshed artifacts now
reflect content like:

* "Comparing the two endings" section, the new theorem splits, the
  promoted bridge lemmas, and other content added in PR #89 and
  follow-ups.
* sect0004.html alone gains ~1,800 lines (the big proofs section), and
  dep_graph_document.html gains ~1,100 lines.
* print.pdf grew from 57,629 → 90,504 bytes.

Net: 9 files, +3,576 / −315.

### Not refreshed in this PR

Four import-graph artifacts under `blueprint/web/` are produced by
**doc-gen4** (in the CI `Deploy documentation` workflow), not by
`leanblueprint`, so they cannot be refreshed locally:

* `import_graph_colored.html`
* `import_graph_colored.png`
* `import_graph_colored.svg`
* `import_graph_full_declarations.html`

The last of these still mentions deleted declarations like
`contractable_map_single` / `contractable_map_pair` / `contractable_comp`
/ `map_coords_apply` from PRs #120/#121. Tracking as a follow-up issue;
the live GitHub Pages site at the Pages deploy URL is the source of
truth for those four files and IS current via the CI workflow.

### Sanity checks

* `lake build` — 3527/3527, 0 warnings
* `lake exe checkdecls blueprint/lean_decls` — passes
* `python3 blueprint/check_blueprint.py` — 52 cites / 52 labels / 50 refs/uses / 52 lean_decls, consistent
* 0 sorries
`leanblueprint web` (via plasTeX) emits a fair amount of trailing
whitespace on the HTML it produces. The first commit on this branch
inherited that, so `git diff --check main...HEAD` flagged it as
whitespace error.

Strip with `sed -i -E 's/[[:space:]]+$//' blueprint/web/{index,sect0001
..sect0006,dep_graph_document}.html`. No visible HTML difference.

`python3 blueprint/check_blueprint.py` and `lake exe checkdecls
blueprint/lean_decls` still pass.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant