Integrate publication pipeline and design updates - #2
Merged
Conversation
Filigree: sdag-b87481cbbc
Implement the Semantic Defects Design System (claude.ai/design) tokens in docs/stylesheets/extra.css and reference-site/assets/_custom.scss: slate #2A323D structural chrome, cobalt #2E5BE3/#7FA8FF accent family, grain + blueprint-grid textures on dark chrome and hero (gradient retired), true slate dark-mode surfaces, gold #F0C75E for Medium/Partial, and semantic green #2F9E60 reserved for Low/Good/Core. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
There was a problem hiding this comment.
Pull request overview
Integrates an updated Typst/Pandoc publication pipeline (with PDF/UA-1 tagging and reproducibility checks) into the unified site workflow, while also applying the refreshed slate/cobalt design tokens across the legacy surfaces and keeping the published v0.3.0 content/metadata intact.
Changes:
- Adds a canonical
build-all.shentrypoint plus CI workflow to rebuild and verify the full tagged PDF suite, including stricter artifact checks. - Updates the Typst template and Pandoc Typst wrappers to improve PDF/UA semantics (running headers, link underlines, table/figure semantics, metadata).
- Refreshes MkDocs/Hugo theme tokens (slate/cobalt + texture overlays) and updates chapter/table content formatting for the new pipeline.
Reviewed changes
Copilot reviewed 22 out of 33 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| source/pdf/template.typ | Updates Typst publication template (palette, header/footer semantics, links, tables, code blocks) and adds running metadata fields. |
| source/pdf/README.md | Documents the PDF publication toolchain, accessibility contract, and build commands. |
| source/pdf/pandoc-typst-lite.typ | Extends pandoc template metadata plumbing (description/running title/version) and refreshes title page layout. |
| source/pdf/pandoc-typst-community.typ | Extends pandoc template metadata plumbing and updates cover/document-control/ToC semantics for tagged PDFs. |
| source/pdf/metadata-wardline-community.yaml | Adds description/running-title/document-type and introduces source-date-epoch for reproducible builds. |
| source/pdf/metadata-suite-map.yaml | Adds description/running-title/document-type and introduces source-date-epoch for reproducible builds. |
| source/pdf/metadata-reviewing-ai-generated-code.yaml | Adds description/running-title/document-type and introduces source-date-epoch for reproducible builds. |
| source/pdf/metadata-governing-ai-generated-code.yaml | Adds description/running-title/document-type and introduces source-date-epoch for reproducible builds. |
| source/pdf/metadata-community.yaml | Adds description/running-title/document-type and introduces source-date-epoch for reproducible builds. |
| source/pdf/build-wardline-community.sh | Switches Wardline build to chapter aggregation, asset retention, heading normalization, and passes metadata into PDF compilation. |
| source/pdf/build-lite.sh | Improves temp file handling, fixes a cross-doc link to point at the PDF artifact, and passes metadata into PDF compilation. |
| source/pdf/build-community.sh | Switches community build to chapter aggregation and passes metadata into PDF compilation. |
| source/pdf/build-common.sh | Tightens Mermaid handling (SVG + alt text), post-processes Pandoc Typst output for tagged PDF semantics, and enforces reproducible timestamps. |
| source/pdf/build-all.sh | Adds a single “build/verify/publish/check” entrypoint for all five PDFs and validates outputs via Poppler tooling. |
| source/pdf/.gitignore | Updates ignore rules to retain generated Mermaid assets locally while keeping them out of Git. |
| source/chapters/wardline-01-04-the-trust-lattice.md | Adjusts table cell formatting for better rendering/layout (line breaks inside cells). |
| source/chapters/sdag-14-appendix-a-taxonomy.md | Reworks table annotations/notes formatting for the taxonomy appendix. |
| source/chapters/sdag-06-stride.md | Moves traditional STRIDE footnote references to improve structure/flow. |
| reference-site/assets/_custom.scss | Applies slate/cobalt refresh and adds textured chrome + focus-visible styling for the reference site. |
| README.md | Adds documentation for rebuilding/verifying the PDF suite and links to the pipeline guide. |
| docs/stylesheets/extra.css | Applies slate/cobalt refresh, textured chrome, and updated hero/banner/link styling for MkDocs Material. |
| .gitignore | Ensures new PDF build entrypoints/docs are tracked despite broader source/pdf/* ignore patterns. |
| .github/workflows/documents.yml | Adds CI workflow to verify PDF publications on PRs and main. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| echo "[error] Required command not found: $command_name" >&2 | ||
| exit 1 | ||
| fi | ||
| actual=$("$command_name" --version 2>&1 | head -n 1 | grep -oE '[0-9]+(\.[0-9]+){1,2}' | head -n 1) |
Comment on lines
+53
to
+56
| echo "Checking publication toolchain..." | ||
| require_tool pandoc 3.2 | ||
| require_tool typst 0.14.0 | ||
| require_tool mmdc 11.0.0 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
mainValidation
./source/pdf/build-all.sh --checkmkdocs build --stricthugo build --minifynpm run buildnpm run test:e2enpm run build:previewnpm audit --audit-level=high