Adopt Dagger CI for docs build (Phase 2) #157

Merged

eblume merged 6 commits from dagger-phase2-docs into main 2026-02-11 16:33:17 -08:00

Conversation 0 Commits 6 Files changed 85 +272 -55

eblume commented 2026-02-11 16:29:32 -08:00

Owner

Copy link

Summary

Migrates the docs build pipeline to Dagger (Phase 2 of the Dagger CI adoption plan).

• Backfill date-modified frontmatter on all 80 docs — Dagger's --src=. excludes .git, so Quartz can't use git history for page dates. Frontmatter dates work with or without git.
• New docs-check-frontmatter mise task + pre-commit hook — validates all docs have title, tags, and date-modified
• New Dagger functions — build_changelog (towncrier in Python container) and build_docs (chains changelog → Quartz build in Node container, returns tarball)
• Simplified CI workflow — the ~44-line inline Quartz build (clone, npm ci, build, tar, cleanup) is replaced by dagger call build-docs. Changelog step remains local on the runner since towncrier needs to modify the host working tree for the git commit.

Design decisions

• Towncrier runs twice in CI: once inside Dagger (for the docs tarball) and once on the runner (for the git commit). This is intentional — Dagger's directory export is additive and can't delete the consumed changelog fragments from the host.
• Artifact hosting stays on Forgejo Releases (not migrated to Forgejo Packages as the plan doc originally suggested). That migration can happen independently.
• date-modified frontmatter preserved even though build_changelog installs git — the git there is only for towncrier's git add call, not for history. The local iteration story (dagger call build-docs --src=. --version=dev with uncommitted changes) depends on frontmatter dates.

Local iteration

dagger call build-docs --src=. --version=dev export --path=./docs-dev.tar.gz
tar tf docs-dev.tar.gz | head -20

Deployment and Testing

• dagger call build-docs --src=. --version=dev produces valid 1.1MB tarball (149 HTML pages)
• Pre-commit hooks pass (including new docs-check-frontmatter)
• Full workflow_dispatch run after merge

🤖 Generated with Claude Code

## Summary Migrates the docs build pipeline to Dagger (Phase 2 of the Dagger CI adoption plan). - **Backfill `date-modified` frontmatter** on all 80 docs — Dagger's `--src=.` excludes `.git`, so Quartz can't use git history for page dates. Frontmatter dates work with or without git. - **New `docs-check-frontmatter` mise task + pre-commit hook** — validates all docs have `title`, `tags`, and `date-modified` - **New Dagger functions** — `build_changelog` (towncrier in Python container) and `build_docs` (chains changelog → Quartz build in Node container, returns tarball) - **Simplified CI workflow** — the ~44-line inline Quartz build (clone, npm ci, build, tar, cleanup) is replaced by `dagger call build-docs`. Changelog step remains local on the runner since towncrier needs to modify the host working tree for the git commit. ### Design decisions - **Towncrier runs twice in CI**: once inside Dagger (for the docs tarball) and once on the runner (for the git commit). This is intentional — Dagger's directory export is additive and can't delete the consumed changelog fragments from the host. - **Artifact hosting stays on Forgejo Releases** (not migrated to Forgejo Packages as the plan doc originally suggested). That migration can happen independently. - **`date-modified` frontmatter** preserved even though `build_changelog` installs git — the git there is only for towncrier's `git add` call, not for history. The local iteration story (`dagger call build-docs --src=. --version=dev` with uncommitted changes) depends on frontmatter dates. ### Local iteration ```bash dagger call build-docs --src=. --version=dev export --path=./docs-dev.tar.gz tar tf docs-dev.tar.gz | head -20 ``` ## Deployment and Testing - [x] `dagger call build-docs --src=. --version=dev` produces valid 1.1MB tarball (149 HTML pages) - [x] Pre-commit hooks pass (including new `docs-check-frontmatter`) - [ ] Full `workflow_dispatch` run after merge 🤖 Generated with [Claude Code](https://claude.com/claude-code)

eblume added 6 commits 2026-02-11 16:29:32 -08:00

Backfill date-modified frontmatter on all docs ... 1c32e351f7

Dagger's --src=. excludes .git, so Quartz can't use git history for
page dates inside containers. Populate date-modified: YYYY-MM-DD in
frontmatter for all 80 doc articles so the frontmatter priority level
(highest in quartz.config.ts) works with or without git.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add docs-check-frontmatter mise task and pre-commit hook ... 5f060da2a8

Validates all docs have required frontmatter fields (title, tags,
date-modified). Follows the pattern of existing doc check tasks.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add build_changelog and build_docs Dagger functions ... 7a579fd97a

build_changelog runs towncrier in a Python container and returns the
modified source tree. build_docs chains build_changelog then builds
the Quartz site in a Node container, returning the docs tarball.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Replace inline docs build with Dagger call in CI workflow ... 83ceb491f3

The ~44-line inline Quartz build (clone, npm ci, build, tar, cleanup)
is replaced by a single `dagger call build-docs` invocation. Adds the
Dagger CLI bootstrap step (same pattern as build-container.yaml).

Changelog step remains local since towncrier needs to modify the host
working tree for the git commit (fragment deletion). Build order is
docs-first so Dagger sees fragments before local towncrier removes them.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Fix build_changelog: install git for towncrier staging ... 518e2ab737

Towncrier calls `git add` on the updated CHANGELOG.md. Install git and
run `git init` in the Python container to satisfy this requirement.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add changelog fragment and update Phase 2 status in plan doc ... d99153191a

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

eblume merged commit b197bd5f58 into main 2026-02-11 16:33:17 -08:00

eblume referenced this pull request from a commit 2026-02-11 16:33:19 -08:00

Adopt Dagger CI for docs build (Phase 2) (#157)

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

eblume/blumeops!157

No description provided.