Show more semantic errors when trying to run prebuilds without a project

Author: jankeromnes

components/dashboard/src/start/CreateWorkspace.tsx

@@ -207,6 +207,15 @@ export default class CreateWorkspace extends React.Component<CreateWorkspaceProp
                     phase = StartPhase.Stopped;
                     statusMessage = <UsageLimitReachedModal hints={this.state?.error?.data} />;
                     break;
+                case ErrorCodes.PROJECT_REQUIRED:
+                    statusMessage = (
+                        <p className="text-base text-gitpod-red w-96">
+                            <a className="gp-link" href="https://www.gitpod.io/docs/configure/projects">
+                                Learn more about projects
+                            </a>
+                        </p>
+                    );
+                    break;
                 default:
                     statusMessage = (
                         <p className="text-base text-gitpod-red w-96">

components/gitpod-protocol/src/messaging/error.ts

@@ -35,6 +35,9 @@ export namespace ErrorCodes {
     // 430 Repository not whitelisted (custom status code)
     export const REPOSITORY_NOT_WHITELISTED = 430;
 
+    // 440 Prebuilds now always require a project (custom status code)
+    export const PROJECT_REQUIRED = 440;
+
     // 450 Payment error
     export const PAYMENT_ERROR = 450;
 

components/server/ee/src/prebuilds/prebuild-manager.ts

@@ -35,6 +35,8 @@ import { StopWorkspacePolicy } from "@gitpod/ws-manager/lib";
 import { error } from "console";
 import { IncrementalPrebuildsService } from "./incremental-prebuilds-service";
 import { PrebuildRateLimiterConfig } from "../../../src/workspace/prebuild-rate-limiter";
+import { ResponseError } from "vscode-ws-jsonrpc";
+import { ErrorCodes } from "@gitpod/gitpod-protocol/lib/messaging/error";
 
 export class WorkspaceRunningError extends Error {
     constructor(msg: string, public instance: WorkspaceInstance) {
@@ -124,10 +126,11 @@ export class PrebuildManager {
 
         try {
             if (user.blocked) {
-                throw new Error(`Blocked users cannot start prebuilds (${user.name})`);
+                throw new ResponseError(ErrorCodes.USER_BLOCKED, `Blocked users cannot start prebuilds (${user.name})`);
             }
             if (!project) {
-                throw new Error(
+                throw new ResponseError(
+                    ErrorCodes.PROJECT_REQUIRED,
                     `Running prebuilds without a project is no longer supported. Please add '${cloneURL}' as a project in a Gitpod team.`,
                 );
             }

components/server/ee/src/prebuilds/start-prebuild-context-parser.ts

@@ -5,7 +5,9 @@
  */
 
 import { User, WorkspaceContext, ContextURL } from "@gitpod/gitpod-protocol";
+import { ErrorCodes } from "@gitpod/gitpod-protocol/lib/messaging/error";
 import { injectable } from "inversify";
+import { ResponseError } from "vscode-ws-jsonrpc";
 import { IPrefixContextParser } from "../../../src/workspace/context-parser";
 
 @injectable()
@@ -19,7 +21,8 @@ export class StartPrebuildContextParser implements IPrefixContextParser {
     }
 
     public async handle(user: User, prefix: string, context: WorkspaceContext): Promise<WorkspaceContext> {
-        throw new Error(
+        throw new ResponseError(
+            ErrorCodes.PROJECT_REQUIRED,
             `Running prebuilds without a project is no longer supported. Please add your repository as a project in a Gitpod team.`,
         );
     }