Method create

src/node/services/workspaceService.ts:3023–3326

(
    projectPath: string,
    branchName: string | undefined,
    trunkBranch: string | undefined,
    title?: string,
    runtimeConfig?: RuntimeConfig,
    subProjectPath?: string,
    pendingAutoTitle?: boolean,
    tags?: Record<string, string>
  )

  }

  async create(
    projectPath: string,
    branchName: string | undefined,
    trunkBranch: string | undefined,
    title?: string,
    runtimeConfig?: RuntimeConfig,
    subProjectPath?: string,
    pendingAutoTitle?: boolean,
    tags?: Record<string, string>
  ): Promise<Result<{ metadata: FrontendWorkspaceMetadata }>> {
    if (tags != null) {
      for (const [tagKey, tagValue] of Object.entries(tags)) {
        assert(tagKey.trim().length > 0, "Workspace tag keys must be non-empty");
        assert(typeof tagValue === "string", "Workspace tag values must be strings");
      }
    }
    const configSnapshot = this.config.loadConfigOrDefault();
    const requestedProjectPath = stripTrailingSlashes(projectPath);
    const requestedProjectConfig = configSnapshot.projects.get(requestedProjectPath);
    const owningProjectPath = requestedProjectConfig?.parentProjectPath ?? requestedProjectPath;
    const effectiveSubProjectPath = requestedProjectConfig?.parentProjectPath
      ? requestedProjectPath
      : subProjectPath;
    const projectConfig = configSnapshot.projects.get(owningProjectPath);

    if (
      effectiveSubProjectPath &&
      configSnapshot.projects.get(effectiveSubProjectPath)?.parentProjectPath !== owningProjectPath
    ) {
      return Err(`Sub-project not found under parent: ${effectiveSubProjectPath}`);
    }

    // Trust gate: block workspace creation for untrusted projects.
    // The frontend shows a confirmation dialog before reaching here,
    // but this guards secondary paths (slash commands, forking). Sub-projects
    // share their parent's checkout, so trust is owned by that parent project.
    if (!projectConfig?.trusted) {
      return Err(
        "This project must be trusted before creating workspaces. Trust the project in Settings → Security, or create a workspace from the project page."
      );
    }

    // Auto-generate a branch name when the caller omits one (used by /new to
    // mirror /fork's seamless creation flow). Mirrors fork's auto-naming: scan
    // existing workspace names AND local git branches so numbering is stable.
    // Branches/worktrees are owned by the parent project, so always read from
    // owningProjectPath even when a sub-project initiated creation.
    let resolvedBranchName: string;
    if (branchName == null) {
      const existingNamesSet = new Set<string>();
      for (const entry of projectConfig.workspaces ?? []) {
        if (typeof entry.name === "string") {
          existingNamesSet.add(entry.name);
        }
      }
      try {
        for (const localBranch of await listLocalBranches(owningProjectPath)) {
          existingNamesSet.add(localBranch);