Fix projectConfig.projectId containing project name instead of ID (vercel#999)

* Fix projectConfig.projectId containing project name instead of ID

* add changeset

* Address review: fix changeset description, normalize slug-based project IDs, add clarifying comments

Author: TooTallNate

.changeset/fix-project-config.md

@@ -0,0 +1,8 @@
+---
+"@workflow/cli": patch
+"@workflow/core": patch
+"@workflow/web": patch
+"@workflow/world-vercel": patch
+---
+
+Separate project ID and project name into distinct env vars (WORKFLOW_VERCEL_PROJECT and WORKFLOW_VERCEL_PROJECT_NAME)

packages/cli/src/lib/inspect/env.ts

@@ -40,6 +40,7 @@ export const getEnvVars = (): Record<string, string> => {
     WORKFLOW_VERCEL_ENV: env.WORKFLOW_VERCEL_ENV || '',
     WORKFLOW_VERCEL_AUTH_TOKEN: env.WORKFLOW_VERCEL_AUTH_TOKEN || '',
     WORKFLOW_VERCEL_PROJECT: env.WORKFLOW_VERCEL_PROJECT || '',
+    WORKFLOW_VERCEL_PROJECT_NAME: env.WORKFLOW_VERCEL_PROJECT_NAME || '',
     WORKFLOW_VERCEL_TEAM: env.WORKFLOW_VERCEL_TEAM || '',
     WORKFLOW_LOCAL_UI: env.WORKFLOW_LOCAL_UI || '',
     PORT: env.PORT || '',
@@ -184,13 +185,27 @@ export const inferVercelProjectAndTeam = async () => {
 export const inferVercelEnvVars = async () => {
   const envVars = getEnvVars();
 
-  if (!envVars.WORKFLOW_VERCEL_PROJECT || !envVars.WORKFLOW_VERCEL_TEAM) {
+  // Infer project/team from .vercel folder when:
+  // - WORKFLOW_VERCEL_PROJECT or WORKFLOW_VERCEL_TEAM is missing, OR
+  // - WORKFLOW_VERCEL_PROJECT is set but doesn't look like a real project ID
+  //   (e.g., user passed a slug via --project flag), OR
+  // - WORKFLOW_VERCEL_PROJECT_NAME is missing (need to populate the slug)
+  const needsInference =
+    !envVars.WORKFLOW_VERCEL_PROJECT ||
+    !envVars.WORKFLOW_VERCEL_TEAM ||
+    !envVars.WORKFLOW_VERCEL_PROJECT_NAME ||
+    !envVars.WORKFLOW_VERCEL_PROJECT.startsWith('prj_');
+
+  if (needsInference) {
     logger.debug('Inferring vercel project and team from .vercel folder');
     const inferredProject = await inferVercelProjectAndTeam();
     if (inferredProject) {
       const { projectId, projectName, teamId } = inferredProject;
-      envVars.WORKFLOW_VERCEL_PROJECT = projectName || projectId;
-      envVars.WORKFLOW_VERCEL_TEAM = teamId;
+      // WORKFLOW_VERCEL_PROJECT is the real project ID (e.g., prj_xxx)
+      envVars.WORKFLOW_VERCEL_PROJECT = projectId;
+      // WORKFLOW_VERCEL_PROJECT_NAME is the project slug (e.g., my-app)
+      envVars.WORKFLOW_VERCEL_PROJECT_NAME = projectName || projectId;
+      envVars.WORKFLOW_VERCEL_TEAM = envVars.WORKFLOW_VERCEL_TEAM || teamId;
       writeEnvVars(envVars);
     } else {
       logger.warn(

packages/cli/src/lib/inspect/web.ts

@@ -98,7 +98,8 @@ export async function launchWebUI(
     envVars.WORKFLOW_TARGET_WORLD
   );
   const teamSlug = envVars.WORKFLOW_VERCEL_TEAM;
-  const projectName = envVars.WORKFLOW_VERCEL_PROJECT;
+  const projectName =
+    envVars.WORKFLOW_VERCEL_PROJECT_NAME || envVars.WORKFLOW_VERCEL_PROJECT;
 
   // Check if user wants local UI via flag or environment variable
   const useLocalUi = flags.localUi;

packages/core/src/runtime/world.ts

@@ -35,7 +35,8 @@ export const createWorld = (): World => {
       token: process.env.WORKFLOW_VERCEL_AUTH_TOKEN,
       projectConfig: {
         environment: process.env.WORKFLOW_VERCEL_ENV,
-        projectId: process.env.WORKFLOW_VERCEL_PROJECT,
+        projectId: process.env.WORKFLOW_VERCEL_PROJECT, // real ID (prj_xxx)
+        projectName: process.env.WORKFLOW_VERCEL_PROJECT_NAME, // slug (my-app)
         teamId: process.env.WORKFLOW_VERCEL_TEAM,
       },
     });

packages/web/app/server/workflow-server-actions.server.ts

@@ -205,13 +205,15 @@ const WORLD_ENV_ALLOWLIST_BY_TARGET_WORLD: Record<string, string[]> = {
     'WORKFLOW_VERCEL_ENV',
     'WORKFLOW_VERCEL_TEAM',
     'WORKFLOW_VERCEL_PROJECT',
+    'WORKFLOW_VERCEL_PROJECT_NAME',
     'WORKFLOW_VERCEL_AUTH_TOKEN',
   ],
   '@workflow/world-vercel': [
     'WORKFLOW_TARGET_WORLD',
     'WORKFLOW_VERCEL_ENV',
     'WORKFLOW_VERCEL_TEAM',
     'WORKFLOW_VERCEL_PROJECT',
+    'WORKFLOW_VERCEL_PROJECT_NAME',
     'WORKFLOW_VERCEL_AUTH_TOKEN',
   ],
 
@@ -432,6 +434,9 @@ async function getWorldFromEnv(userEnvMap: EnvMap): Promise<World> {
         projectId:
           userEnvMap.WORKFLOW_VERCEL_PROJECT ||
           process.env.WORKFLOW_VERCEL_PROJECT,
+        projectName:
+          userEnvMap.WORKFLOW_VERCEL_PROJECT_NAME ||
+          process.env.WORKFLOW_VERCEL_PROJECT_NAME,
         teamId:
           userEnvMap.WORKFLOW_VERCEL_TEAM || process.env.WORKFLOW_VERCEL_TEAM,
       },

packages/world-vercel/src/utils.ts

@@ -34,7 +34,10 @@ export interface APIConfig {
   token?: string;
   headers?: RequestInit['headers'];
   projectConfig?: {
+    /** The real Vercel project ID (e.g., prj_xxx) */
     projectId?: string;
+    /** The project name/slug (e.g., my-app), used for dashboard URLs */
+    projectName?: string;
     teamId?: string;
     environment?: string;
   };