Fix projectConfig.projectId containing project name instead of ID

[TooTallNate]

Added support for Vercel project name/slug separate from project ID to improve dashboard URLs and environment variable handling.

What changed?

• Added a new WORKFLOW_VERCEL_PROJECT_NAME environment variable to store the project slug/name
• Updated inferVercelEnvVars() to properly set both project ID and project name
• Modified WORKFLOW_VERCEL_PROJECT to consistently store the real project ID (e.g., prj_xxx)
• Updated the web UI to prefer using the project name when available
• Added the new environment variable to allowlists in server actions
• Updated type definitions in the Vercel world to document the distinction between project ID and name

How to test?

1. Run the CLI with a Vercel project
2. Verify that both WORKFLOW_VERCEL_PROJECT and WORKFLOW_VERCEL_PROJECT_NAME are set correctly
3. Check that dashboard URLs use the project name/slug instead of the project ID
4. Confirm that encryption key derivation still works correctly with the project ID

Why make this change?

This change improves the clarity of the codebase by distinguishing between the Vercel project ID (used for API calls and encryption) and the project name/slug (used for dashboard URLs and display purposes). Previously, the code was inconsistently using project names and IDs, which could lead to confusion and potential issues with encryption key derivation contexts.

[github-actions]

🧪 E2E Test Results

❌ Some tests failed

Summary

	Passed	Failed	Skipped	Total
✅ ▲ Vercel Production	490	0	38	528
✅ 💻 Local Development	418	0	62	480
✅ 📦 Local Production	418	0	62	480
✅ 🐘 Local Postgres	418	0	62	480
✅ 🪟 Windows	45	0	3	48
❌ 🌍 Community Worlds	103	41	9	153
✅ 📋 Other	123	0	21	144
Total	2015	41	257	2313

❌ Failed Tests

🌍 Community Worlds (41 failed)

turso (41 failed):

• addTenWorkflow
• addTenWorkflow
• should work with react rendering in step
• promiseAllWorkflow
• promiseRaceWorkflow
• promiseAnyWorkflow
• hookWorkflow
• webhookWorkflow
• sleepingWorkflow
• nullByteWorkflow
• workflowAndStepMetadataWorkflow
• fetchWorkflow
• promiseRaceStressTestWorkflow
• error handling error propagation workflow errors nested function calls preserve message and stack trace
• error handling error propagation workflow errors cross-file imports preserve message and stack trace
• error handling error propagation step errors basic step error preserves message and stack trace
• error handling error propagation step errors cross-file step error preserves message and function names in stack
• error handling retry behavior regular Error retries until success
• error handling retry behavior FatalError fails immediately without retries
• error handling retry behavior RetryableError respects custom retryAfter delay
• error handling retry behavior maxRetries=0 disables retries
• error handling catchability FatalError can be caught and detected with FatalError.is()
• hookCleanupTestWorkflow - hook token reuse after workflow completion
• concurrent hook token conflict - two workflows cannot use the same hook token simultaneously
• stepFunctionPassingWorkflow - step function references can be passed as arguments (without closure vars)
• stepFunctionWithClosureWorkflow - step function with closure variables passed as argument
• closureVariableWorkflow - nested step functions with closure variables
• spawnWorkflowFromStepWorkflow - spawning a child workflow using start() inside a step
• health check (queue-based) - workflow and step endpoints respond to health check messages
• pathsAliasWorkflow - TypeScript path aliases resolve correctly
• Calculator.calculate - static workflow method using static step methods from another class
• AllInOneService.processNumber - static workflow method using sibling static step methods
• ChainableService.processWithThis - static step methods using this to reference the class
• thisSerializationWorkflow - step function invoked with .call() and .apply()
• customSerializationWorkflow - custom class serialization with WORKFLOW_SERIALIZE/WORKFLOW_DESERIALIZE
• instanceMethodStepWorkflow - instance methods with "use step" directive
• crossContextSerdeWorkflow - classes defined in step code are deserializable in workflow context
• stepFunctionAsStartArgWorkflow - step function reference passed as start() argument
• pages router addTenWorkflow via pages router
• pages router promiseAllWorkflow via pages router
• pages router sleepingWorkflow via pages router

Details by Category

✅ ▲ Vercel Production

App	Passed	Failed	Skipped
✅ astro	44	0	4
✅ example	44	0	4
✅ express	44	0	4
✅ fastify	44	0	4
✅ hono	44	0	4
✅ nextjs-turbopack	47	0	1
✅ nextjs-webpack	47	0	1
✅ nitro	44	0	4
✅ nuxt	44	0	4
✅ sveltekit	44	0	4
✅ vite	44	0	4

✅ 💻 Local Development

App	Passed	Failed	Skipped
✅ astro-stable	41	0	7
✅ express-stable	41	0	7
✅ fastify-stable	41	0	7
✅ hono-stable	41	0	7
✅ nextjs-turbopack-stable	45	0	3
✅ nextjs-webpack-stable	45	0	3
✅ nitro-stable	41	0	7
✅ nuxt-stable	41	0	7
✅ sveltekit-stable	41	0	7
✅ vite-stable	41	0	7

✅ 📦 Local Production

App	Passed	Failed	Skipped
✅ astro-stable	41	0	7
✅ express-stable	41	0	7
✅ fastify-stable	41	0	7
✅ hono-stable	41	0	7
✅ nextjs-turbopack-stable	45	0	3
✅ nextjs-webpack-stable	45	0	3
✅ nitro-stable	41	0	7
✅ nuxt-stable	41	0	7
✅ sveltekit-stable	41	0	7
✅ vite-stable	41	0	7

✅ 🐘 Local Postgres

App	Passed	Failed	Skipped
✅ astro-stable	41	0	7
✅ express-stable	41	0	7
✅ fastify-stable	41	0	7
✅ hono-stable	41	0	7
✅ nextjs-turbopack-stable	45	0	3
✅ nextjs-webpack-stable	45	0	3
✅ nitro-stable	41	0	7
✅ nuxt-stable	41	0	7
✅ sveltekit-stable	41	0	7
✅ vite-stable	41	0	7

✅ 🪟 Windows

App	Passed	Failed	Skipped
✅ nextjs-turbopack	45	0	3

❌ 🌍 Community Worlds

App	Passed	Failed	Skipped
✅ mongodb-dev	3	0	0
✅ mongodb	45	0	3
✅ redis-dev	3	0	0
✅ redis	45	0	3
✅ turso-dev	3	0	0
❌ turso	4	41	3

✅ 📋 Other

App	Passed	Failed	Skipped
✅ e2e-local-dev-nest-stable	41	0	7
✅ e2e-local-postgres-nest-stable	41	0	7
✅ e2e-local-prod-nest-stable	41	0	7

---

📋 View full workflow run

[changeset-bot]

⚠️ No Changeset found

Latest commit: 53d573e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[TooTallNate]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Make decryption an explicit opt-in for o11y tooling #1000
• Wire encryption into serialization layer #957
• Add Vercel encryption implementation (AES-256-GCM with HKDF) #956
• Fix projectConfig.projectId containing project name instead of ID #999 👈 (View in Graphite)
• Add Encryptor interface and thread through serialization layer #979
• Make serialization functions async #978
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
example-nextjs-workflow-turbopack	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
example-nextjs-workflow-webpack	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
example-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-astro-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-express-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-fastify-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-hono-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-nitro-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-nuxt-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-sveltekit-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workbench-vite-workflow	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workflow-docs	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workflow-nest	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am
workflow-swc-playground	Ready	Preview, Comment, Open in v0	Feb 11, 2026 5:25am

[vercel]

Additional Suggestion:

Connection status UI displays opaque Vercel project ID (e.g., prj_xxx) instead of the human-readable project name after WORKFLOW_VERCEL_PROJECT was changed to store the real project ID.

[Copilot]

Pull request overview

This PR fixes inconsistent handling of Vercel project identity by separating the project ID (used for API/auth/encryption contexts) from the project slug/name (used for dashboard URLs and display), and wires the new env var through CLI, core runtime, and the web server’s Vercel world creation path.

Changes:

• Added WORKFLOW_VERCEL_PROJECT_NAME (project slug/name) alongside WORKFLOW_VERCEL_PROJECT (real prj_… id).
• Updated CLI env inference to set WORKFLOW_VERCEL_PROJECT to the true project ID and populate the new project-name env var.
• Plumbed projectName through core/runtime world creation and web server env allowlists / Vercel world instantiation.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/world-vercel/src/utils.ts	Extends Vercel world config typing to include both project ID and project slug/name.
packages/web/src/server/workflow-server-actions.ts	Allows the new env var to reach the client and passes it into createVercelWorld().
packages/core/src/runtime/world.ts	Adds WORKFLOW_VERCEL_PROJECT_NAME into the runtime’s Vercel world config.
packages/cli/src/lib/inspect/web.ts	Uses project slug/name (when available) for dashboard URL generation.
packages/cli/src/lib/inspect/env.ts	Adds the new env var and updates Vercel env inference to distinguish ID vs name.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

PR description says the web UI was updated to prefer the Vercel project name/slug when available, but the only consumer updated here appears to be the CLI dashboard URL logic. The web UI still appears to read/display WORKFLOW_VERCEL_PROJECT (now intended to be the prj_… id), so the UI may show IDs instead of friendly slugs unless the client-side components are updated to use WORKFLOW_VERCEL_PROJECT_NAME.

[Copilot]

inferVercelEnvVars() only populates WORKFLOW_VERCEL_PROJECT_NAME (and normalizes WORKFLOW_VERCEL_PROJECT to a real prj_… id) when either WORKFLOW_VERCEL_PROJECT or WORKFLOW_VERCEL_TEAM is missing. If the CLI flag/env already sets WORKFLOW_VERCEL_PROJECT to a project slug/name (which the --project flag description currently implies), this block won’t run, and the world will continue sending the slug in the x-vercel-project-id header—reintroducing the exact bug this PR is fixing and potentially breaking auth/encryption context. Consider expanding the guard to also run when WORKFLOW_VERCEL_PROJECT_NAME is missing and/or when WORKFLOW_VERCEL_PROJECT doesn’t look like a Vercel project id (e.g. not prj_…), so the env vars are consistently normalized.