Skip to content

build(deps): refresh docs tooling - #122

Merged
steipete merged 5 commits into
mainfrom
chore/refresh-docs-tooling
Aug 2, 2026
Merged

build(deps): refresh docs tooling#122
steipete merged 5 commits into
mainfrom
chore/refresh-docs-tooling

Conversation

@steipete

@steipete steipete commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • refresh the tracked Carapace skill mirror and upgrade the site to Carapace 0.6.1
  • update all current npm and workflow tooling dependencies, including Markdown-It 15 and actions/stale 11
  • normalize CSS Color 4 theme values before handing them to Mermaid's legacy color parser
  • add a safe workflow-dispatch dry-run mode for the stale action

Root cause

Carapace 0.6.1 promotes neutral theme roles to OKLCH. Mermaid 11's color parser rejects OKLCH strings, so every diagram silently fell back to the error state. The shell now resolves computed theme colors through the browser canvas and passes Mermaid compatible RGB/RGBA values while retaining Mermaid's strict security mode.

Proof

  • npm ci: 245 packages installed, zero vulnerabilities
  • npm test: 4/4 renderer tests passed
  • python3 .github/scripts/i18n/tests/test_i18n_scripts.py: 102/102 tests passed
  • actionlint: passed
  • npx wrangler@4.118.0 deploy --dry-run --config wrangler.toml: Worker bundle validated
  • npm run docs:build:r2:shell: 30,557 pages, 67,174 R2 objects
  • npm run docs:smoke:shell: passed
  • npm run docs:visual: passed in Chromium, including Mermaid, overlay, theme, mobile, and scroll behavior
  • served dist/docs-site locally and fetched /, /start/getting-started/, and /assets/docs-site.js with HTTP 200
  • branch-wide AutoReview: no accepted/actionable findings
  • npm audit: zero vulnerabilities; npm outdated: no remaining package updates

Queue reconciliation

This supersedes the narrower automation PRs #115, #118, #120, and #121. The commits from PRs 120 and 121 retain their original bot authorship.

github-actions Bot and others added 5 commits August 1, 2026 20:30
Bumps [@openclaw/carapace](https://github.com/openclaw/carapace) from v0.2.0 to v0.6.1.
- [Release notes](https://github.com/openclaw/carapace/releases)
- [Changelog](https://github.com/openclaw/carapace/blob/main/CHANGELOG.md)
- [Commits](openclaw/carapace@eca4570...6c64d6b)

---
updated-dependencies:
- dependency-name: "@openclaw/carapace"
  dependency-version: 6c64d6b67edf169c32a452ce8ccdbec65a75bab3
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
@steipete
steipete requested a review from a team as a code owner August 2, 2026 03:54
@steipete

steipete commented Aug 2, 2026

Copy link
Copy Markdown
Contributor Author

Exact-head proof for e960dfeaa9323581b15fe155d907ef2232171311:

  • npm ci: 245 packages installed; npm audit reports zero vulnerabilities; npm outdated reports no remaining package updates.
  • npm test: 4/4 passed.
  • python3 .github/scripts/i18n/tests/test_i18n_scripts.py: 102/102 passed.
  • actionlint: passed.
  • npx wrangler@4.118.0 deploy --dry-run --config wrangler.toml: Worker bundle validated with the expected R2 binding.
  • npm run docs:build:r2:shell: built 30,557 pages and prepared 67,174 R2 objects.
  • npm run docs:smoke:shell: passed.
  • npm run docs:visual: passed in Playwright Chromium, including Mermaid rendering, diagram overlays, theme switching, mobile layout, and navigation behavior.
  • Served dist/docs-site locally; /, /start/getting-started/, and /assets/docs-site.js returned HTTP 200.
  • actions/stale 11 safe dry run passed: https://github.com/openclaw/docs/actions/runs/30731434233
  • Branch-wide AutoReview reported no accepted/actionable findings.
  • Public model-identifier audit: PASS; the diff contains no model IDs.

The Carapace update initially reproduced the hosted Mermaid failure from PR 121. Root cause: Mermaid's legacy color parser rejects the OKLCH theme values introduced by Carapace 0.6.1. The final head normalizes computed colors to RGB/RGBA at the Mermaid integration boundary, and the full browser suite now passes.

@steipete

steipete commented Aug 2, 2026

Copy link
Copy Markdown
Contributor Author

Landed via rebase merge at 3c22817e3bde90138e5597bd7b945dc707eabdf3.

Exact-head proof before landing: hosted Docs Code CI and both CodeQL jobs passed; npm test passed 4/4; translation-control tests passed 102/102; Wrangler dry-run, the 30,557-page R2 shell build, static smoke, Playwright visual smoke, safe actions/stale 11 dry-run, local HTTP fetches, and branch-wide AutoReview all passed. No caveats or proof waivers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant