Method remove

src/node/services/projectService.ts:935–1114

(projectPath: string, force = false)

  }

  async remove(projectPath: string, force = false): Promise<Result<void, ProjectRemoveError>> {
    try {
      const normalizedPath = stripTrailingSlashes(projectPath);
      let config = this.config.loadConfigOrDefault();
      let projectConfig = config.projects.get(normalizedPath);

      if (!projectConfig) {
        return Err({ type: "project_not_found" as const });
      }

      if (projectConfig.parentProjectPath) {
        const parentProject = config.projects.get(projectConfig.parentProjectPath);
        if (parentProject) {
          for (const workspace of parentProject.workspaces) {
            if (workspace.subProjectPath === normalizedPath) {
              workspace.subProjectPath = undefined;
            }
          }
        }
        try {
          await this.config.updateProjectSecrets(normalizedPath, []);
        } catch (error) {
          log.error(`Failed to clean up secrets for sub-project ${normalizedPath}:`, error);
        }
        config.projects.delete(normalizedPath);
        await this.config.saveConfig(config);
        return Ok(undefined);
      }

      // Self-healing: purge workspace entries whose backing directories no longer exist.
      // This handles the case where a user manually deleted workspace dirs from ~/.mux/src/.
      // Only check local/worktree runtimes — remote runtimes (SSH, Docker, devcontainer)
      // have paths on the remote host that won't exist locally.
      const localRuntimeTypes = new Set(["local", "worktree"]);
      const survivingWorkspaces = [];
      for (const ws of projectConfig.workspaces) {
        const runtimeType = ws.runtimeConfig?.type;
        const isLocal = runtimeType == null || localRuntimeTypes.has(runtimeType);
        if (!isLocal) {
          survivingWorkspaces.push(ws);
          continue;
        }
        try {
          await fsPromises.access(ws.path);
          survivingWorkspaces.push(ws);
        } catch (err: unknown) {
          // Only prune when the directory is truly gone (ENOENT/ENOTDIR).
          // Other errors (EACCES, transient I/O) mean the path may still exist.
          const code = (err as NodeJS.ErrnoException).code;
          if (code === "ENOENT" || code === "ENOTDIR") {
            log.info(`Pruning stale workspace entry (directory missing): ${ws.path}`);
          } else {
            log.warn(
              `Keeping workspace entry despite access error (${code ?? "unknown"}): ${ws.path}`
            );
            survivingWorkspaces.push(ws);
          }
        }