fix: add runner metadata version handling to release script

[NathanFlurry]

Summary

Update the release script to handle RivetKit version updates in example package.json files. This ensures that version bumps are consistently applied across the repository, preventing stale versions in examples.

Changes

• Add support for updating @rivetkit/* and rivetkit dependencies in examples/**/package.json
• Introduce optional file matching for patterns that may not exist in all release scenarios
• Fix path handling by renaming conflicting path import to pathModule
• Reset regex lastIndex before test/replace operations to prevent state-related bugs
• Add development warning in CLAUDE.md to ensure version updates are tracked in the script

Type of change

• Bug fix (non-breaking change which fixes an issue)

Testing

The changes have been reviewed against the codebase to ensure compatibility with the existing release workflow.

[railway-app]

🚅 Deployed to the rivet-pr-4371 environment in rivet-frontend

Service	Status	Web	Updated (UTC)
website	✅ Success (View Logs)	Web	Mar 6, 2026 at 8:52 am
frontend-inspector	✅ Success (View Logs)	Web	Mar 6, 2026 at 8:48 am
frontend-cloud	✅ Success (View Logs)	Web	Mar 6, 2026 at 8:48 am
mcp-hub	✅ Success (View Logs)	Web	Mar 6, 2026 at 8:48 am
ladle	❌ Build Failed (View Logs)	Web	Mar 6, 2026 at 8:48 am

[claude]

PR Review

Overall this is a solid bug fix. A few things to call out.

Path resolution fix - The original code passed relative glob paths directly to fs.readFile/fs.writeFile without joining with opts.root, meaning file reads/writes would resolve relative to the process CWD rather than the repo root. The fix is correct.

Regex lastIndex reset - Using .test() then .replace() on a stateful global regex without resetting lastIndex is a known footgun. The double-reset pattern is correct.

path import renamed to pathModule - The loop variable shadowed the imported path module. The rename eliminates the ambiguity cleanly.

Potential Issue: Regex Does Not Match Wildcard Versions - Per CLAUDE.md, examples should use * as the version for RivetKit dependencies. The new pattern only matches semver strings like ^1.2.3 or 1.2.3-beta.1 and will not match * wildcards that examples currently use. If the intent is to pin examples to semver versions during release, the regex should also cover * and workspace:* patterns. If the intent is specifically to only update already-pinned semver versions, a clarifying comment would help.

Minor Nit - The outer assert(paths.length > 0) still fires regardless of required. If no examples/**/package.json files existed at all, the release script would fail even with required: false. Probably fine in practice but worth noting.

CLAUDE.md Addition - The new development warning is useful and well-placed.

[pkg-pr-new]

More templates

• actor-actions
• actor-actions-vercel
• ai-agent
• ai-agent-vercel
• example-ai-and-user-generated-actors-freestyle
• chat-room
• chat-room-vercel
• example-cloudflare-workers
• example-cloudflare-workers-hono
• collaborative-document
• collaborative-document-vercel
• cross-actor-actions
• cross-actor-actions-vercel
• example-cursors
• example-cursors-raw-websocket
• example-cursors-raw-websocket-vercel
• example-cursors-vercel
• custom-serverless
• example-elysia
• example-experimental-durable-streams-ai-agent
• example-experimental-durable-streams-ai-agent-vercel
• geo-distributed-database
• geo-distributed-database-vercel
• hello-world
• hello-world-vercel
• example-hono
• hono-react
• hono-react-vercel
• example-kitchen-sink
• example-kitchen-sink-vercel
• multi-region-vercel
• multiplayer-game
• example-multiplayer-game-patterns
• example-multiplayer-game-patterns-vercel
• multiplayer-game-vercel
• native-websockets
• native-websockets-vercel
• next-js
• per-tenant-database
• per-tenant-database-vercel
• example-raw-fetch-handler
• example-raw-fetch-handler-vercel
• example-raw-websocket-handler
• example-raw-websocket-handler-proxy
• example-raw-websocket-handler-proxy-vercel
• example-raw-websocket-handler-vercel
• example-react
• example-react-vercel
• sandbox
• sandbox-coding-agent
• sandbox-coding-agent-vercel
• sandbox-vercel
• scheduling
• scheduling-vercel
• example-sqlite-drizzle
• example-sqlite-raw
• state
• state-vercel
• example-stream
• example-stream-vercel
• example-trpc

@rivetkit/virtual-websocket

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/virtual-websocket@4371

@rivetkit/cloudflare-workers

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/cloudflare-workers@4371

@rivetkit/framework-base

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/framework-base@4371

@rivetkit/next-js

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/next-js@4371

@rivetkit/react

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/react@4371

rivetkit

pnpm add https://pkg.pr.new/rivet-dev/rivet/rivetkit@4371

@rivetkit/sql-loader

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sql-loader@4371

@rivetkit/sqlite-vfs

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sqlite-vfs@4371

@rivetkit/traces

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/traces@4371

@rivetkit/workflow-engine

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/workflow-engine@4371

@rivetkit/engine-runner

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner@4371

@rivetkit/engine-runner-protocol

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner-protocol@4371

commit: ff63571