Project profiles: port from Quarto 1 (bd-fu16z22k)

[cscheid]

Summary

Ports Quarto 1's project profiles to Q2: activation via --profile / QUARTO_PROFILE, profile.default + profile.group, config overlays (_quarto-<name>.yml), local overrides (_quarto.yml.local), profile environment files (_environment-<name>), and conditional content (when-/unless- × format/profile/meta) — built greenfield as an AST transform. Where Q1 guesses silently, Q2 validates with span-carrying diagnostics.

Plan (design decisions, divergence table, per-phase records): claude-notes/plans/2026-08-10-project-profiles-port.md. Strand: bd-fu16z22k.

One phase per commit

Commit	Phase
ce502820	Phase 0 — activation resolution core (project_profile.rs, catalog codes Q-5-19..22)
117364cf	Phase 1 — _quarto-<name>.yml overlays + _quarto.yml.local, FileId/span discipline at every bind_config_source site
5da7208e	Phase 2 — --profile on render/get-config/publish, pass-1 cache-key inputs, subprocess QUARTO_PROFILE, -v echo
6e941e2e	Phase 3 — _environment-<profile> loading + dotenv QUARTO_PROFILE bootstrap (fills the seam PR #486 left)
e107ff20	Phase 4 — conditional content trio (new Q-2-42 diagnostics)
4e2eecfa	Phase 5 — docs pages, cross-runner smoke fixture, deferred-work strands

(9e0dc551 is a small process-docs change decided mid-session: commit-and-continue at clean phase boundaries.)

Design highlights

• Activation precedence (Q1 parity): --profile replaces QUARTO_PROFILE, which beats the _environment{,.local} bootstrap, which beats profile.default in _quarto.yml.local, then _quarto.yml; group expansion appends each group's first member after explicit selections. First-listed profile wins merge conflicts (consistent with the _environment-<p> layer order).
• No process-env mutation (policy from Load project _environment files (bd-environment-files-372u9qbs) #486): the resolved set travels as data on ProjectConfig.active_config_profiles; child processes (engines, render scripts) get the normalized list via Command::env unconditionally — the one deliberate exception to the real-env-wins rule — and {{< env QUARTO_PROFILE >}} special-cases it.
• Terminology guard: "profile" already means DocumentProfile (pass-1 summary) in q2; the new code consistently says project profiles / active_config_profiles, and the pass-1 cache key gained the project-profile inputs (PROFILE_KEY_VERSION → 2) so a profile switch can't serve stale pass-1 results.
• Strictness upgrades over Q1 (all silent there): Q-5-19 unknown active profile, Q-5-20 malformed profile: shape, Q-5-21 invalid names ([A-Za-z0-9][A-Za-z0-9._-]*, empty selections), Q-5-22 inert profile: keys, Q-2-42 condition-attribute typos. Behavioral divergences (array concat instead of union-dedup; comma-OR in condition values) are documented in the docs page's "Differences from Quarto 1".
• Deferred with strands: preview --profile flag threading (bd-pfgc273f; QUARTO_PROFILE=x q2 preview works today), metadata-files decision (bd-spb7mobo), Lua quarto.project.profile (bd-ip1lrgra), preview watch (bd-kzwt3xcu), gitignore scaffolding (bd-47hhbmaj).

Test plan

TDD red-first throughout; ~90 new tests: 41 resolution unit tests, 25 overlay integration tests, 35 binary-driven CLI/e2e tests (comma/repeated flags, precedence, diagnostics through the binary, env-file layering via {{< env >}} in rendered HTML, crossref renumbering under hidden floats), 11 conditional-content walker tests, cache-key domain-separation tests, a real-spawn script-env test, and a smoke-all fixture activated via profile.default so the native and WASM runners both exercise the stack.

E2E verified with real invocations (recorded in the plan): overlay title in rendered HTML, q2 get-config divergence with/without --profile, -v provenance echo, and a live jupyter kernel printing QUARTO_PROFILE=advanced,production.

Gates: cargo nextest run --workspace green (11,397 tests), full cargo xtask verify (WASM leg included) green, clippy/fmt/cargo xtask lint clean.

Incidental fixes: verbose_to_filter never matched the q2 bin crate's tracing targets; the tracing fmt layer wrote to stdout instead of stderr.

🤖 Generated with Claude Code

[posit-snyk-bot]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.