mdBook parity A–E: pipeline, SUMMARY, CLI, output, themes

.agent/handoffs/2026-08-08-mdbook-parity-a.md

@@ -0,0 +1,27 @@
+# Handover: mdBook parity A–E
+
+**Date**: 2026-08-08  
+**Branch**: `task/2-summary-book-model`  
+**PRs**: Gitea #7, GitHub #27 (A-only was #6/#26)
+
+## Completed
+- A: pipeline decomposition (byte-identical)
+- B: SUMMARY.md book model + dual-review security fixes
+- C: CLI subcommands + path resolution
+- D: path_to_root, heading IDs, 404, code-copy
+- E: themes, keyboard, print, redirects
+
+## Known gaps (plan-explicit or deferred)
+- Full Shoelace vendor (CDN still used for Shoelace)
+- Fold interactive collapse UI (config present)
+- additional-css/js file copy (config keys present; inject partial)
+- P2 {{#include}} preprocessing
+- Increment F pulldown-cmark
+
+## Unrelated stash
+`git stash list` may still hold SEO/template WIP — do not drop.
+
+## Resume
+1. Merge PR #7 after CI
+2. Close Gitea issues #1–#5
+3. Optional: vendor Shoelace, wire additional-css/js fully, fold JS

.agent/sessions/2026-08-08-mdbook-parity-a.md

@@ -0,0 +1,38 @@
+# Session Start: mdBook parity Increment A
+
+**Date**: 2026-08-08
+**UTC Start**: 09:52:25 UTC
+**Change Slug**: mdbook-parity-a
+**Branch**: task/1-pipeline-decomposition
+**Scope**: Increment A — decompose build pipeline into collect/preprocess/render/index
+**Linked Issue**: https://git.terraphim.cloud/terraphim/md-book/issues/1
+
+## Repository Context
+- Current branch: task/1-pipeline-decomposition (from main @ 82de35d)
+- Recent commits: docs for parity research/plan/spec findings
+- Working tree: clean for A; unrelated SEO/template WIP stashed as stash@{0}
+- Relevant artefacts: docs/plans/mdbook-parity-{research,implementation-plan}.md
+
+## Planned Artifact Chain
+- Research: docs/plans/mdbook-parity-research.md (done)
+- Design: docs/plans/mdbook-parity-implementation-plan.md (done, approved)
+- Spec: Phase 2.5 findings for B appended to plan (A has no separate spec)
+- Verification: docs/verification/verification-report-mdbook-parity-a.md
+- Validation: docs/validation/validation-report-mdbook-parity-a.md
+- Review: docs/plans/review-mdbook-parity-a.md
+- Handover: .agent/handoffs/2026-08-08-mdbook-parity-a.md
+
+## Subtasks
+1. [M] A1 Extract stages into pipeline/ + render/
+2. [S] A2 Preprocess identity seam
+3. [S] A3 Baseline benchmark / byte-identical gate
+4. [S] Verification + PR
+
+## Risks and Blockers
+- Zoned::now() year in templates may affect byte compare across year boundary only
+- Pagefind index may be non-deterministic; compare HTML excluding pagefind/
+- Unrelated WIP stashed — do not drop stash
+
+## Notes
+- Research/design already approved; skip re-research
+- Zero behaviour change is the gate

.cargo/audit.toml

@@ -0,0 +1,15 @@
+# cargo-audit configuration.
+#
+# Ignores are last-resort and each needs a reason and an exit route. Prefer
+# updating the dependency; only list an advisory here when the fix sits behind
+# an upstream release we do not control.
+
+[advisories]
+ignore = [
+    # quick-xml <0.41 reached only through syntect -> plist, which parses the
+    # syntax and theme definitions md-book ships, never user input. The fix
+    # needs plist to take a semver-major bump of quick-xml; revisit when
+    # syntect releases against plist >=2.
+    "RUSTSEC-2026-0194", # quadratic parse time on duplicate attribute names
+    "RUSTSEC-2026-0195", # unbounded namespace-declaration allocation
+]

.github/workflows/ci.yml

@@ -96,9 +96,19 @@ jobs:
 
       - name: Run integration tests
         run: cargo test --test integration --features "tokio,search,syntax-highlighting"
-
+
+      - name: Run structural conformance tests
+        run: cargo test --test structure --features "tokio,search,syntax-highlighting"
+
+      - name: Run mdBook compatibility tests
+        run: |
+          cargo test --test mdbook_compatibility --features "tokio,search,syntax-highlighting"
+          cargo test --test mdbook_test_book --features "tokio,search,syntax-highlighting"
+
       - name: Run end-to-end tests
-        run: cargo test --test e2e
+        run: |
+          cargo test --test e2e
+          cargo test --test mdbook_e2e --features "tokio,search,syntax-highlighting"
         env:
           RUST_LOG: debug
 
@@ -173,6 +183,11 @@ jobs:
         features:
           - "default"
           - "server,watcher,search,syntax-highlighting"
+          # Single-feature builds: each optional feature must carry its own
+          # dependencies rather than relying on another feature to supply them
+          - "search,syntax-highlighting"
+          - "watcher"
+          - "core"
           - "wasm-core"
 
     steps:

.gitignore

@@ -47,7 +47,12 @@ yarn-error.log*
 # Temporary files
 tmp/
 temp/
-test_*
+# Build scratch directories, not test inputs. The bare `test_*` this replaces
+# also matched tests/assets/test_book_1, so that fixture was never committed
+# and the structure suite passed only on machines that happened to have it.
+/test_*/
+!/test_book_mdbook/
+!tests/assets/**
 
 # Test output
 test-results/