Method remove

src/node/services/workspaceService.ts:3721–4194

(workspaceId: string, force = false)

  }

  async remove(workspaceId: string, force = false): Promise<Result<void>> {
    // Idempotent: if already removing, return success to prevent race conditions
    if (this.removingWorkspaces.has(workspaceId)) {
      return Ok(undefined);
    }
    this.removingWorkspaces.add(workspaceId);

    // If this workspace is mid-init, cancel the fire-and-forget init work (postCreateSetup,
    // sync/checkout, .mux/init hook, etc.) so removal doesn't leave orphaned background work.
    const initAbortController = this.initAbortControllers.get(workspaceId);
    if (initAbortController) {
      initAbortController.abort();
      this.initAbortControllers.delete(workspaceId);
    }

    const persistedWorkspace = this.config.findWorkspace(workspaceId);

    // Try to remove from runtime (filesystem)
    try {
      if (!force) {
        const config = this.config.loadConfigOrDefault();
        const taskSettings = normalizeTaskSettings(config.taskSettings);
        if (
          taskSettings.preserveSubagentsUntilArchive &&
          this.taskService?.hasCompletedDescendants?.(workspaceId)
        ) {
          const persistedWorkspaceEntry = findWorkspaceEntry(config, workspaceId);
          const isArchived =
            persistedWorkspaceEntry != null &&
            isWorkspaceArchived(
              persistedWorkspaceEntry.workspace.archivedAt,
              persistedWorkspaceEntry.workspace.unarchivedAt
            );

          // Keep the whole parentWorkspaceId chain intact while completed descendants still exist.
          // Unarchived ancestors must be archived first so descendant cleanup can safely walk that lineage.
          if (!isArchived) {
            return Err(
              "This workspace has preserved completed sub-agent workspaces. Archive the workspace first to trigger cleanup, then try removing it."
            );
          }

          // Archived parents can still retain completed descendants while cleanup waits on
          // prerequisites like pending patch artifacts. Keep removal blocked until that cleanup
          // finishes so descendants do not lose the archived ancestor that makes them eligible.
          return Err(
            "This workspace still has completed sub-agent workspaces pending cleanup. Wait for cleanup to finish, or force-remove the workspace."
          );
        }
      }

      // Stop any active stream before deleting metadata/config to avoid tool calls racing with removal.
      //
      // IMPORTANT: AIService forwards "stream-abort" asynchronously after partial cleanup. If we roll up
      // session timing (or delete session files) immediately after stopStream(), we can race the final
      // abort timing write.
      const wasStreaming = this.aiService.isStreaming(workspaceId);
      const streamStoppedEvent: Promise<"abort" | "end" | undefined> | undefined = wasStreaming