Skip to content

docs: upgrade Vellum to 0.3.0 - #131

Merged
Tom Tang (qwerzl) merged 1 commit into
mainfrom
agent/upgrade-vellum-0.3
Aug 5, 2026
Merged

docs: upgrade Vellum to 0.3.0#131
Tom Tang (qwerzl) merged 1 commit into
mainfrom
agent/upgrade-vellum-0.3

Conversation

@qwerzl

@qwerzl Tom Tang (qwerzl) commented Aug 5, 2026

Copy link
Copy Markdown
Member

Summary

  • upgrade all Vellum packages from 0.2.4 to 0.3.0
  • enable the new cell filter and TypeString.oneline support for Markdown-table-safe SDK types
  • explicitly preserve Vellum 0.2's non-strict rendering behavior during the migration

Why

Vellum 0.3 replaces repeated table escaping chains with the profile-aware cell filter. The Eve integration page can therefore render its SDK-extracted option types with {{ option.type | cell | safe }} instead of maintaining five string replacements.

Compatibility

Vellum 0.3 enables strict Nunjucks rendering by default. The current synced Spectrum templates include a reference to an authoring symbol that is present on Spectrum main but not in the published spectrum-ts@12.0.0 package indexed by the aggregator. This PR sets strict: false explicitly to preserve the existing build behavior while gaining the additive table-cell helpers. Strict rendering can be enabled separately after the synced sources and published packages are aligned.

Validation

  • pnpm install --frozen-lockfile
  • pnpm docs:generate (662 symbols extracted, 85 templates rendered)
  • isolated strict Vellum render of the local Eve integration page using cell (458 symbols extracted, two templates rendered)
  • pnpm lint
  • pnpm typecheck:docs
  • git diff --check

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.


Note

Low Risk
Dependency and docs-build config only; no runtime app logic. The explicit strict: false reduces risk of broken doc generation during the minor upgrade.

Overview
Bumps all @vellum-docs/* dev dependencies from 0.2.4 to 0.3.0 (with matching pnpm-lock.yaml updates, including new CLI transitives such as chokidar).

Updates vellum.config.ts to instantiate NunjucksEngine({ strict: false }) so doc generation keeps the prior non-strict Nunjucks behavior while on 0.3, which turns strict rendering on by default.

Reviewed by Cursor Bugbot for commit 0291cb1. Bugbot is set up for automated code reviews on this repo. Configure here.

Summary by CodeRabbit

  • Chores
    • Updated development tooling to the latest 0.3.0 release.
  • Bug Fixes
    • Preserved existing template rendering behavior by allowing undefined template values during the transition to stricter template validation.

@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ee2ddb48-5bfc-45ef-89e3-9ebfaa77d399

📥 Commits

Reviewing files that changed from the base of the PR and between ecc00e5 and 0291cb1.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (2)
  • package.json
  • vellum.config.ts

Disabled knowledge base sources:

  • Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.


📝 Walkthrough

Walkthrough

The project updates five @vellum-docs development dependencies to ^0.3.0. Nunjucks now uses strict: false to preserve version 0.2 template behavior.

Changes

Vellum Docs upgrade

Layer / File(s) Summary
Update Vellum Docs dependencies
package.json
Five @vellum-docs development dependencies now use ^0.3.0.
Preserve Nunjucks compatibility
vellum.config.ts
NunjucksEngine now uses strict: false, with a comment documenting the compatibility behavior.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: lingjueya

Poem

A rabbit bumps the docs with care,
Vellum grows a newer pair.
Nunjucks keeps its gentle ways,
Through templates, builds, and days.
Hop, hop—compatibility stays!

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/upgrade-vellum-0.3

Comment @coderabbitai help to get the list of available commands.

@qwerzl
Tom Tang (qwerzl) marked this pull request as ready for review August 5, 2026 20:51
Copilot AI review requested due to automatic review settings August 5, 2026 20:51
@qwerzl
Tom Tang (qwerzl) merged commit 05d34fa into main Aug 5, 2026
5 of 6 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

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.

2 participants