Method cleanup

app/src/API/Handlers/WorkspacesHandler.cpp:1329–1384

* @brief Reports or removes orphaned workspace widget refs. */

 * @brief Reports or removes orphaned workspace widget refs.
 */
API::CommandResponse API::Handlers::WorkspacesHandler::cleanup(const QString& id,
                                                               const QJsonObject& params)
{
  const bool dryRun = params.value(QStringLiteral("dryRun")).toBool(false);
  if (!dryRun && !inProjectFileMode())
    return CommandResponse::makeError(
      id, ErrorCode::InvalidParam, QStringLiteral("Workspace mutations require ProjectFile mode"));

  auto& pm           = DataModel::ProjectModel::instance();
  const auto& wsList = pm.editorWorkspaces();
  const auto lookup  = DataModel::ProjectEditor::buildResolvedWidgetLookup(pm);

  const bool filtered = params.contains(QStringLiteral("workspaceId"));
  const int onlyWid   = filtered ? params.value(QStringLiteral("workspaceId")).toInt() : -1;

  QJsonArray removedRefs;
  for (const auto& ws : wsList) {
    if (filtered && ws.workspaceId != onlyWid)
      continue;

    for (const auto& ref : ws.widgetRefs) {
      const auto key = DataModel::ProjectEditor::workspaceWidgetKey(
        ref.widgetType, ref.groupUniqueId, ref.relativeIndex);
      if (lookup.contains(key))
        continue;

      QJsonObject entry;
      entry[QStringLiteral("workspaceId")] = ws.workspaceId;
      entry[QStringLiteral("widgetType")]  = ref.widgetType;
      entry[QStringLiteral("widgetTypeSlug")] =
        API::EnumLabels::dashboardWidgetSlug(ref.widgetType);
      entry[QStringLiteral("groupId")]       = ref.groupUniqueId;
      entry[QStringLiteral("relativeIndex")] = ref.relativeIndex;
      entry[QStringLiteral("widgetId")] =
        widgetIdFor(ws.workspaceId, ref.widgetType, ref.groupUniqueId, ref.relativeIndex);
      removedRefs.append(entry);
    }
  }

  int removed = 0;
  if (!dryRun && !removedRefs.isEmpty()) {
    QSet<qint64> validKeys;
    validKeys.reserve(lookup.size());
    for (auto it = lookup.constBegin(); it != lookup.constEnd(); ++it)
      validKeys.insert(it.key());

    removed = pm.cleanupWorkspaceWidgetRefs(validKeys);
  }

  QJsonObject result;
  result[QStringLiteral("ok")]          = true;
  result[QStringLiteral("dryRun")]      = dryRun;
  result[QStringLiteral("removed")]     = dryRun ? removedRefs.size() : removed;
  result[QStringLiteral("removedRefs")] = removedRefs;
  return CommandResponse::makeSuccess(id, result);
}

/**