Fix the docs deploy: a colon in a test name breaks artifact upload

[TonsOfFun]

docs.activeagents.ai has not deployed since Aug 14. Every Deploy VitePress site to Pages run on main has failed since #360 — five in a row, including the merge of #364, so the site is still serving pre-delegation content and the SolidAgent section isn't live.

What's wrong

The site builds fine. build-current then dies on the upload:

##[error] The path for one of the files in artifact is not valid:
/parts/examples/delegation-examples-test.rb-test-budgets-layer:-the-agent-wide-ceiling-and-the-per-delegation-limit.html
Contains the following character:  Colon :

doc_example_output names its output file after the test method. test "budgets layer: the agent-wide ceiling and the per-delegation limit" keeps its colon through dasherize, VitePress renders a page at that path, and actions/upload-artifact refuses the characters NTFS can't store (" : < > | * ? \r \n). One bad name rejects the entire artifact, deploy skips, and nothing ships.

The build-versioned (0.6.3) job passes throughout, which is why the run looks half-healthy.

Fix

Sanitize in the helper, not by renaming the test:

DOC_EXAMPLE_UNSAFE_CHARACTERS = /["*:<>?|\r\n]/

def doc_example_filename_safe(name)
  name.to_s.gsub(DOC_EXAMPLE_UNSAFE_CHARACTERS, "-")
end

Renaming the one test would unbreak today and break again the next time someone writes a colon in a test name — and the failure message points at an artifact path, not at the test that produced it. The single @include referencing the old filename moves with it.

Also: the "no status" integration badge

integration.yml was only reachable through workflow_call from ci.yml, and GitHub attributes a called run to the caller — so it had no runs of its own and its README badge read no status no matter how often the suite passed. It now triggers itself on main, and ci.yml calls it for pull requests only: one combined check per PR, and a badge that reflects main.

Testing

• Regenerated every doc example and scanned: no filename under docs/parts/examples/ contains a rejected character
• npm run docs:build clean; find docs/.vitepress/dist -name '*[":<>?|*]*' returns 0 — the exact condition that failed
• bin/rubocop clean (460 files)

The proof this works is the deploy run on merge, since the failure only reproduces inside upload-artifact.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NGn2NzpzFZT4JGKBdFMpxh

---

Generated by Claude Code