Class ProjectService

src/node/services/projectService.ts:370–1434

}

export class ProjectService {
  private readonly fileCompletionsCache = new Map<string, FileCompletionsCacheEntry>();
  private directoryPicker?: (initialPath?: string | null) => Promise<string | null>;
  private readonly sshPromptService: SshPromptService | undefined;
  private workspaceService?: WorkspaceRemover;

  constructor(
    private readonly config: Config,
    sshPromptService?: SshPromptService
  ) {
    this.sshPromptService = sshPromptService;
  }

  setWorkspaceService(workspaceService: WorkspaceRemover): void {
    this.workspaceService = workspaceService;
  }

  setDirectoryPicker(picker: (initialPath?: string | null) => Promise<string | null>) {
    this.directoryPicker = picker;
  }

  async pickDirectory(initialPath?: string | null): Promise<string | null> {
    if (!this.directoryPicker) return null;
    return this.directoryPicker(initialPath ?? null);
  }

  async create(
    projectPath: string
  ): Promise<Result<{ projectConfig: ProjectConfig; normalizedPath: string }>> {
    try {
      // Validate input
      if (!projectPath || projectPath.trim().length === 0) {
        return Err("Project path cannot be empty");
      }

      // Resolve the path:
      // - Bare names like "my-project" → ~/.mux/projects/my-project
      // - Paths with ~ → expand to home directory
      // - Absolute/relative paths → resolve normally
      const isBareProjectName =
        projectPath.length > 0 &&
        !projectPath.includes("/") &&
        !projectPath.includes("\\") &&
        !projectPath.startsWith("~");

      const config = this.config.loadConfigOrDefault();
      let normalizedPath: string;
      if (isBareProjectName) {
        // Bare project name - put in default projects directory
        const parentDir = resolveProjectParentDir(undefined, config.defaultProjectDir);
        normalizedPath = path.join(parentDir, projectPath);
      } else if (
        projectPath === "~" ||
        projectPath.startsWith("~/") ||
        projectPath.startsWith("~\\")
      ) {
        // Tilde expansion - uses expandTilde to respect MUX_ROOT for ~/.mux paths
        normalizedPath = path.resolve(expandTilde(projectPath));