Method workspacePlan

app/src/API/Handlers/AssistantHandler.cpp:254–294

* @brief Plan a workspace: list compatible (group, widgetType) options for tile placement. */

 * @brief Plan a workspace: list compatible (group, widgetType) options for tile placement.
 */
API::CommandResponse API::Handlers::AssistantHandler::workspacePlan(const QString& id,
                                                                    const QJsonObject& params)
{
  const auto wsResp = workspaceResolve(QStringLiteral("inner"), params);
  if (!wsResp.success)
    return rewrap(id, wsResp);

  const auto groupListResp =
    forward(QStringLiteral("project.group.list"), QStringLiteral("inner"), QJsonObject());
  if (!groupListResp.success)
    return rewrap(id, groupListResp);

  QString widgetFilterSlug;
  if (params.contains(QStringLiteral("widgetType"))) {
    const auto v = params.value(QStringLiteral("widgetType"));
    if (v.isString())
      widgetFilterSlug = v.toString();
    else
      widgetFilterSlug = API::EnumLabels::dashboardWidgetSlug(v.toInt());
  }

  const auto groups = groupsFromListResponse(groupListResp);
  const auto rows   = buildPlanRows(groups, widgetFilterSlug);

  QJsonObject result;
  result[QStringLiteral("workspace")] = wsResp.result.value(QStringLiteral("workspace"));
  result[QStringLiteral("options")]   = rows;
  result[QStringLiteral("count")]     = rows.size();
  if (!widgetFilterSlug.isEmpty())
    result[QStringLiteral("widgetType")] = widgetFilterSlug;

  if (rows.isEmpty() && !widgetFilterSlug.isEmpty())
    result[QStringLiteral("hint")] =
      QStringLiteral(
        "No group currently exposes widgetType '%1'. Flip the matching dataset option "
        "(project.dataset.setOptions / .setOption / .update {graph|fft|led|waterfall}) "
        "on a dataset in the target group, then re-plan.")
        .arg(widgetFilterSlug);

  return CommandResponse::makeSuccess(id, result);
}

//--------------------------------------------------------------------------------------------------
// assistant.script.dryRun / assistant.script.apply: kind-routed