Merge pull request #510 from Automattic/feature/issue-508-editor-actions

Add generic editor action command

Author: chubes4

package.json

@@ -70,6 +70,7 @@
     "browser-actions-artifact-smoke": "tsx scripts/browser-actions-artifact-smoke.ts",
     "browser-html-capture-smoke": "tsx scripts/browser-html-capture-smoke.ts",
     "editor-open-artifact-smoke": "tsx scripts/editor-open-artifact-smoke.ts",
+    "editor-actions-artifact-smoke": "tsx scripts/editor-actions-artifact-smoke.ts",
     "browser-review-bridge-smoke": "tsx scripts/browser-review-bridge-smoke.ts",
     "browser-interaction-script-validation-smoke": "tsx scripts/browser-interaction-script-validation-smoke.ts",
     "preview-port-smoke": "tsx scripts/preview-port-smoke.ts",

packages/cli/src/recipe-validation.ts

@@ -616,6 +616,43 @@ async function validateRecipeStepArgs(step: WorkspaceRecipe["workflow"]["steps"]
     return
   }
 
+  if (step.command === "wordpress.editor-actions") {
+    const stepsJson = recipeStepArgValue(step.args ?? [], "steps-json")
+    if (!stepsJson) {
+      addIssue("missing-steps", `${path}.args`, "wordpress.editor-actions requires steps-json=<array>.")
+    }
+
+    if (stepsJson && !stepsJson.startsWith("@")) {
+      let parsed: unknown
+      try {
+        parsed = JSON.parse(stepsJson)
+      } catch (error) {
+        addIssue("invalid-steps-json", `${path}.args`, `wordpress.editor-actions steps-json must be valid JSON: ${error instanceof Error ? error.message : String(error)}`)
+        parsed = undefined
+      }
+      if (parsed !== undefined && !Array.isArray(parsed)) {
+        addIssue("invalid-steps-json", `${path}.args`, "wordpress.editor-actions steps-json must be a JSON array.")
+      }
+    }
+
+    for (const name of ["wait-timeout", "step-timeout", "timeout"] as const) {
+      const value = recipeStepArgValue(step.args ?? [], name)
+      if (value && /^\d+(?:\.\d+)?(?:ms|s)$/.test(value) === false) {
+        addIssue("invalid-duration", `${path}.args`, `wordpress.editor-actions ${name} must look like 500ms or 2s.`)
+      }
+    }
+
+    const capture = recipeStepArgValue(step.args ?? [], "capture")
+    if (capture) {
+      for (const item of capture.split(",").map((value) => value.trim()).filter(Boolean)) {
+        if (!["steps", "console", "errors", "html", "screenshot", "editor-state"].includes(item)) {
+          addIssue("invalid-capture", `${path}.args`, `wordpress.editor-actions capture does not support: ${item}`)
+        }
+      }
+    }
+    return
+  }
+
   if (step.command === "wordpress.ability") {
     if (!recipeStepArgValue(step.args ?? [], "name")?.trim()) {
       addIssue("missing-ability-name", `${path}.args`, "wordpress.ability requires name=<ability-name>.")

packages/runtime-core/src/command-registry.ts

@@ -226,6 +226,26 @@ export const commandRegistry = [
     recipe: true,
     handler: { kind: "playground", method: "runEditorOpen" },
   },
+  {
+    id: "wordpress.editor-actions",
+    description: "Open a generic WordPress block editor target, run a bounded editor action script, and capture replayable mutation evidence artifacts.",
+    acceptedArgs: [
+      { name: "target", description: "Editor target to open; defaults to post-new.", format: "post-new|site" },
+      { name: "post-id", description: "Existing post ID to open in the post editor.", format: "positive integer" },
+      { name: "post-type", description: "Post type for post-new or post-id targets; defaults to post.", format: "post type slug" },
+      { name: "url", description: "Explicit editor path or absolute URL to open instead of resolving a target.", format: "path or URL" },
+      { name: "steps-json", description: "Ordered editor action script: open, insertBlock, selectBlock, and inspectState.", required: true, format: "JSON array (inline or @<path>)" },
+      { name: "wait-selector", description: "Selector that marks the editor as ready; defaults to the block editor shell.", format: "CSS selector" },
+      { name: "wait-timeout", description: "Timeout for navigation and editor-ready waits.", format: "duration, e.g. 15s or 500ms" },
+      { name: "step-timeout", description: "Per-action timeout applied to each editor action step.", format: "duration, e.g. 15s or 500ms" },
+      { name: "timeout", description: "Total-script timeout bounding the whole editor action run.", format: "duration, e.g. 30s or 1500ms" },
+      { name: "capture", description: "Comma-separated artifacts to capture after actions.", format: "steps,console,errors,html,screenshot,editor-state" },
+    ],
+    outputShape: "JSON summary plus files/browser/editor-action-steps.jsonl, editor-action-summary.json, editor-action-state.json, and optional console/errors/html/screenshot artifacts.",
+    policyRequirement: "Runtime policy commands must include wordpress.editor-actions.",
+    recipe: true,
+    handler: { kind: "playground", method: "runEditorActions" },
+  },
   {
     id: "wordpress.browser-actions.evaluate",
     description: "Policy capability gating arbitrary page-side JavaScript (the evaluate step) inside wordpress.browser-actions. Non-JS interaction steps do not require this capability.",