Method createProject

backend/src/project/project.service.ts:161–223

(
    input: CreateProjectInput,
    userId: string,
  )

      // after the first has landed.
      const project = await queueForUser(userId, async () => {
        await this.assertUnderQuota(userId);
        return this.reserveProject(input, userId);
      });

      // handle project name generation if needed (this is the only sync operation we need)
      let projectName = input.projectName;
      if (!projectName || projectName === '') {
        this.logger.debug(
          'Project name not provided in input, generating project name',
        );

        const result = await generateText({
          model: modelFor(input.model || DEFAULT_MODEL),
          // A title is a handful of tokens. Left unset the SDK asks for the
          // model's full output window — 64k for Sonnet — which providers
          // reserve credit against and reject outright on a small balance.
          maxOutputTokens: 64,
          // ai@7 rejects role:'system' inside `messages`; instructions is the
          // replacement, and the old shape threw before reaching the model.
          instructions:
            'You are a specialized project name generator. Create a concise, descriptive project title (max 20 words) based on the description. Respond ONLY with the project name, no explanation.',
          prompt: `Generate a project name for: ${input.description}`,
        });

        projectName = result.text.trim();
        this.logger.debug(`Generated project name: ${projectName}`);
      }

      // Create chat with proper title
      const defaultChat = await this.chatService.createChatWithMessage(userId, {
        title: projectName || 'New Project Chat',
        message: input.description,
        model: input.model,
      });

      // The row already exists (reserved above, under the quota queue); this
      // names it and materialises its working directory.
      project.projectName = projectName;
      this.createProjectInBackground(input, project, defaultChat);

      // Return chat immediately so user can start interacting
      return defaultChat;
    } catch (error) {
      this.logger.error(
        `Error in createProject: ${error.message}`,
        error.stack,
      );
      throw new InternalServerErrorException('Error creating the project.');
    }
  }

  /**
   * Claim the user's quota slot by saving the row, before anything slow.
   *
   * Split out of the background task so the count that authorises it and the
   * row that consumes it happen in the same queued turn — see the comment at
   * the call site. Named unnamed: the title comes from a model call that
   * must not hold the queue.