Method remove

app/src/API/Handlers/WorkspacesHandler.cpp:800–847

* @brief Deletes a workspace. No-op if id not found. */

 * @brief Deletes a workspace. No-op if id not found.
 */
API::CommandResponse API::Handlers::WorkspacesHandler::remove(const QString& id,
                                                              const QJsonObject& params)
{
  if (!inProjectFileMode())
    return CommandResponse::makeError(
      id, ErrorCode::InvalidParam, QStringLiteral("Workspace mutations require ProjectFile mode"));

  if (!params.contains(QStringLiteral("id")))
    return CommandResponse::makeError(
      id, ErrorCode::MissingParam, QStringLiteral("Missing required parameter: id"));

  const bool isDryRun = params.value(QStringLiteral("dryRun")).toBool(false);

  auto& pm = DataModel::ProjectModel::instance();
  if (!pm.customizeWorkspaces())
    return CommandResponse::makeError(
      id,
      ErrorCode::InvalidParam,
      QStringLiteral("customizeWorkspaces is off; call project.workspaces.customize.set first"));

  const int wid = params.value(QStringLiteral("id")).toInt();

  const auto& workspaces = pm.activeWorkspaces();
  const auto it          = findWorkspace(workspaces, wid);
  if (it == workspaces.end())
    return CommandResponse::makeError(
      id, ErrorCode::InvalidParam, QStringLiteral("Workspace not found: %1").arg(wid));

  QJsonObject deleted;
  deleted[QStringLiteral("id")]          = it->workspaceId;
  deleted[QStringLiteral("title")]       = it->title;
  deleted[QStringLiteral("widgetCount")] = static_cast<int>(it->widgetRefs.size());

  if (!isDryRun)
    pm.deleteWorkspace(wid);

  QJsonObject result;
  if (isDryRun) {
    result[QStringLiteral("dryRun")] = true;
    result[QStringLiteral("warning")] =
      QStringLiteral("DRY RUN: workspace not deleted. Re-call without dryRun:true to commit.");
  }

  result[QStringLiteral("id")]        = wid;
  result[QStringLiteral("deleted")]   = !isDryRun;
  result[QStringLiteral("workspace")] = deleted;
  return CommandResponse::makeSuccess(id, result);
}

/**
 * @brief Wipes every workspace in one shot. Leaves customize mode on with an empty list.