Files
sm-seo-plugin/operations.go
Jakub Zych aa0c3bcacf feat: management API and an MCP tool per SEO admin operation
- /_seo/api/v1 routes for the effective SEO of a URL with sources and
  owner, URL rules, redirects (loops refused with redirect_loop), the
  404 log actions, robots.txt and its tester, settings and history
- the CMS-data issue report: missing and duplicate titles and
  descriptions, rules over records, redirect chains, canonicals to
  noindex or redirected addresses, noindex addresses robots.txt blocks
- 24 MCP tools on those routes (backend guard, golem15.seo.manage)
- AdminOperations maps every admin operation to its tool;
  TestEveryAdminOperationHasTool and TestMCPReadToolsAreGET guard drift
- robots.txt writes go through classes.SaveRobots from the admin too
2026-10-27 12:17:36 +01:00

96 lines
4.2 KiB
Go

package seo
import "git.golem15.com/golem15/sm-seo-plugin/controllers"
// The kinds of an admin operation (AdminOperation.Kind). Record, bulk and
// widget actions add ":" and the action's name.
const (
// OpList is a controller's list.
OpList = "list"
// OpShow is a record's form or preview, or a singleton's form.
OpShow = "show"
// OpCreate is the create form's save (toolbar create).
OpCreate = "create"
// OpUpdate is the update form's save, or a singleton's save.
OpUpdate = "update"
// OpDelete is the form's and the list toolbar's delete.
OpDelete = "delete"
// OpExtensionSave is a form extension's save on the controller.
OpExtensionSave = "extension_save"
// OpUpload is a field type's upload.
OpUpload = "upload"
// OpRecordAction is a record action ("record_action:<name>").
OpRecordAction = "record_action"
// OpBulkAction is a bulk action ("bulk_action:<name>").
OpBulkAction = "bulk_action"
// OpWidgetAction is a widget action ("widget_action:<name>").
OpWidgetAction = "widget_action"
)
// ContentController stands for the form of every content type the SEO tab
// is added to (D-91): the operations of the tab are the same on all.
const ContentController = "*"
// AdminOperation is one operation of the SEO admin and the MCP tool that
// performs it (D-10): the controller, the kind of operation and the tool
// name without the seo_ prefix.
type AdminOperation struct {
Controller string
Kind string
Tool string
}
// AdminOperations maps every operation of the SEO admin to its MCP tool
// (D-10, SC-4). TestEveryAdminOperationHasTool derives the operations from
// the controllers, their configs, actions and form extensions, and fails
// when one is missing here, when a tool named here does not exist, or when
// a tool is not bound to a registered route.
var AdminOperations = []AdminOperation{
// The SEO tab of every content type.
{ContentController, OpShow, "get_url_seo"},
{ContentController, OpExtensionSave, "set_url_seo"},
{ContentController, OpWidgetAction + ":seo_snippet", "get_url_seo"},
// The social image is set by URL through MCP (uploads are no tool).
{ContentController, OpUpload, "set_url_seo"},
// SEO settings and the per-type tabs.
{controllers.SettingsControllerID, OpShow, "show_settings"},
{controllers.SettingsControllerID, OpUpdate, "update_settings"},
{controllers.SettingsControllerID, OpExtensionSave, "update_settings"},
// Redirects.
{controllers.RedirectsControllerID, OpList, "list_redirects"},
{controllers.RedirectsControllerID, OpShow, "show_redirect"},
{controllers.RedirectsControllerID, OpCreate, "create_redirect"},
{controllers.RedirectsControllerID, OpUpdate, "update_redirect"},
{controllers.RedirectsControllerID, OpDelete, "delete_redirect"},
{controllers.RedirectsControllerID, OpExtensionSave, "update_redirect"},
// 404 log.
{controllers.NotFoundControllerID, OpList, "list_not_found"},
{controllers.NotFoundControllerID, OpShow, "list_not_found"},
{controllers.NotFoundControllerID, OpDelete, "delete_not_found"},
{controllers.NotFoundControllerID, OpRecordAction + ":" + controllers.NotFoundActionRedirect, "redirect_not_found"},
{controllers.NotFoundControllerID, OpRecordAction + ":" + controllers.NotFoundActionGone, "gone_not_found"},
{controllers.NotFoundControllerID, OpBulkAction + ":" + controllers.NotFoundActionGone, "gone_not_found"},
// URL rules.
{controllers.RulesControllerID, OpList, "list_rules"},
{controllers.RulesControllerID, OpShow, "show_rule"},
{controllers.RulesControllerID, OpCreate, "create_rule"},
{controllers.RulesControllerID, OpUpdate, "update_rule"},
{controllers.RulesControllerID, OpDelete, "delete_rule"},
{controllers.RulesControllerID, OpExtensionSave, "update_rule"},
{controllers.RulesControllerID, OpWidgetAction + ":seo_snippet", "get_url_seo"},
// robots.txt and AI bots.
{controllers.RobotsControllerID, OpShow, "show_robots"},
{controllers.RobotsControllerID, OpUpdate, "update_robots"},
{controllers.RobotsControllerID, OpExtensionSave, "update_robots"},
{controllers.RobotsControllerID, OpWidgetAction + ":" + RobotsTestAction, "test_robots"},
// History.
{controllers.HistoryControllerID, OpList, "list_history"},
{controllers.HistoryControllerID, OpShow, "show_history"},
}