feat(scripts): Zola export build smoke check (REQ-138, #378)

[avrabe]

Closes #378 (the script half of REQ-138).

What

scripts/zola-export-smoke.sh is the end-to-end check the string-asserting unit tests can't give: it scaffolds a Zola site whose base_url is a sub-directory deploy (GitHub-Pages project-site style), runs rivet export --format zola --shortcodes into it, runs a real zola build, and fails if:

1. zola build errors (broken shortcode, dangling @/ internal link, missing taxonomy, …), or
2. any built-HTML href/src is an absolute /<prefix>/artifacts/… or /<prefix>/documents/… path that drops the deploy sub-path (the REQ-115/116/118 class).

"export succeeded" now provably implies "the site builds and its links resolve under a sub-directory." Skips cleanly (exit 0 + notice) when zola isn't installed, so it can gate on availability.

Verification (local, zola 0.22.1)

• Passes on current main (post-fix(export): Zola links survive a sub-directory deploy (REQ-115/116/118) #377): zola build OK, 1219 pages, 0 leaks.
• Detector proven to fire: on a crafted page it flags /rivet/artifacts/req-001/ and /rivet/documents/doc-x/ (2 leaks) while correctly ignoring a resolved full-URL link https://example.test/rivet-docs/rivet/artifacts/…. So it would have failed on the pre-fix(export): Zola links survive a sub-directory deploy (REQ-115/116/118) #377 export — it's not a no-op that always passes.
• rivet validate PASS; rivet docs check PASS.

Follow-up

Wiring this as a gated CI job needs a zola install step on the self-hosted runners (no existing zola-in-CI pattern to reuse); I deliberately didn't commit an unverifiable workflow change. The script is runnable in CI today via RIVET_BIN=… scripts/zola-export-smoke.sh once zola is on PATH.

Implements: REQ-138

🤖 Generated with Claude Code

[github-actions]

📐 Rivet artifact delta

Change	Count
Added	0
Removed	0
Modified	1
Downstream impacted (depth ≤ 5)	0

Graph

graph LR
  REQ_138["REQ-138"]:::modified
  classDef added fill:#d4edda,stroke:#28a745,color:#155724
  classDef removed fill:#f8d7da,stroke:#dc3545,color:#721c24
  classDef modified fill:#fff3cd,stroke:#ffc107,color:#856404
  classDef overflow fill:#e2e3e5,stroke:#6c757d,color:#495057,stroke-dasharray: 3 3

Loading

Modified

ID	Changes
REQ-138

📎 Full HTML dashboard attached as workflow artifact rivet-delta-pr-391 — download from the workflow run.

_{Posted by rivet-delta workflow. The graph shows only changed artifacts; open the HTML dashboard (above) for full context.}

[github-actions]

⚠️ Performance Alert ⚠️

Possible performance regression was detected for benchmark 'Rivet Criterion Benchmarks'.
Benchmark result of this commit is worse than the previous benchmark result exceeding threshold 1.20.

Benchmark suite	Current: 08e4228	Previous: 02b6893	Ratio
traceability_matrix/1000	60112 ns/iter (± 580)	44805 ns/iter (± 286)	1.34

This comment was automatically generated by workflow using github-action-benchmark.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!