@guanlin4924/devflow-pi 0.1.94 → 0.1.96

package/plugins/devflow-quality/runtime/playwright/devflow-test-dsl-v1.schema.json

@@ -0,0 +1,872 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:devflow:schema:devflow-test-dsl:v1",
+  "title": "devflow-test-dsl/v1",
+  "description": "Deterministic per-TC execution description interpreted by the Devflow Playwright Runtime. Pure data: no code, shell, module loading, file access, model calls, xpath, or ai_only strategies. Built-in variables: execution_id, namespace.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "tc_id",
+    "tc_sha256",
+    "name",
+    "variables",
+    "data",
+    "steps"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "devflow-test-dsl/v1"
+    },
+    "tc_id": {
+      "$ref": "#/$defs/tcId"
+    },
+    "tc_sha256": {
+      "$ref": "#/$defs/sha256"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "variables": {
+      "type": "object",
+      "maxProperties": 128,
+      "additionalProperties": false,
+      "patternProperties": {
+        "^[A-Za-z_][A-Za-z0-9_]{0,63}$": {
+          "$ref": "#/$defs/variable"
+        }
+      }
+    },
+    "data": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "namespace",
+        "setup",
+        "cleanup"
+      ],
+      "properties": {
+        "namespace": {
+          "$ref": "#/$defs/text"
+        },
+        "owner": {
+          "$ref": "#/$defs/text"
+        },
+        "accounts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/text"
+          },
+          "maxItems": 32
+        },
+        "repeatable": {
+          "type": "boolean"
+        },
+        "setup": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/$defs/apiStep"
+          }
+        },
+        "cleanup": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/$defs/apiStep"
+          }
+        }
+      }
+    },
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 200,
+      "items": {
+        "$ref": "#/$defs/step"
+      }
+    }
+  },
+  "$defs": {
+    "tcId": {
+      "type": "string",
+      "pattern": "^TC-[0-9]{4,}$"
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "stepId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+    },
+    "varName": {
+      "type": "string",
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$"
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096,
+      "description": "Literal text; may reference variables as ${name}."
+    },
+    "timeoutMs": {
+      "type": "integer",
+      "minimum": 100,
+      "maximum": 600000
+    },
+    "indexList": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "integer",
+        "minimum": 1
+      }
+    },
+    "covers": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "description": "1-based indexes into the frozen TC preconditions/steps arrays; oracle=true only on assertion steps.",
+      "properties": {
+        "preconditions": {
+          "$ref": "#/$defs/indexList"
+        },
+        "steps": {
+          "$ref": "#/$defs/indexList"
+        },
+        "oracle": {
+          "type": "boolean"
+        }
+      }
+    },
+    "exactFlag": {
+      "type": "boolean"
+    },
+    "target": {
+      "description": "Exactly one locator form. Strict: more than one match fails the step. XPath is not supported.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "testid"
+          ],
+          "properties": {
+            "testid": {
+              "$ref": "#/$defs/text"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "role",
+            "name"
+          ],
+          "properties": {
+            "role": {
+              "type": "string",
+              "pattern": "^[a-z]+$"
+            },
+            "name": {
+              "$ref": "#/$defs/text"
+            },
+            "exact": {
+              "$ref": "#/$defs/exactFlag"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "label"
+          ],
+          "properties": {
+            "label": {
+              "$ref": "#/$defs/text"
+            },
+            "exact": {
+              "$ref": "#/$defs/exactFlag"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "placeholder"
+          ],
+          "properties": {
+            "placeholder": {
+              "$ref": "#/$defs/text"
+            },
+            "exact": {
+              "$ref": "#/$defs/exactFlag"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "text"
+          ],
+          "properties": {
+            "text": {
+              "$ref": "#/$defs/text"
+            },
+            "exact": {
+              "$ref": "#/$defs/exactFlag"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "css"
+          ],
+          "properties": {
+            "css": {
+              "$ref": "#/$defs/text"
+            }
+          }
+        }
+      ]
+    },
+    "match": {
+      "enum": [
+        "exact",
+        "contains"
+      ]
+    },
+    "scalar": {
+      "type": [
+        "string",
+        "number",
+        "boolean"
+      ]
+    },
+    "jsonPointer": {
+      "type": "string",
+      "pattern": "^(/([^~/]|~[01])*)*$",
+      "maxLength": 1024
+    },
+    "apiAssertion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "pointer",
+        "op"
+      ],
+      "description": "JSON body assertion. exists/not_exists take no value; other ops require value.",
+      "properties": {
+        "pointer": {
+          "$ref": "#/$defs/jsonPointer"
+        },
+        "op": {
+          "enum": [
+            "equals",
+            "not_equals",
+            "contains",
+            "exists",
+            "not_exists"
+          ]
+        },
+        "value": {}
+      }
+    },
+    "apiStep": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "method",
+        "url"
+      ],
+      "description": "Request through the page BrowserContext request (shared cookies). A url starting with '/' resolves against the profile api_base_url (or base_url); absolute URLs must match an api_origins entry. Redirects are not followed automatically. No retry unless declared.",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "api"
+        },
+        "action": {
+          "const": "request"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "method": {
+          "enum": [
+            "GET",
+            "POST",
+            "PUT",
+            "PATCH",
+            "DELETE"
+          ]
+        },
+        "url": {
+          "$ref": "#/$defs/text"
+        },
+        "headers": {
+          "type": "object",
+          "maxProperties": 64,
+          "patternProperties": {
+            "^[A-Za-z0-9-]{1,128}$": {
+              "$ref": "#/$defs/text"
+            }
+          },
+          "additionalProperties": false
+        },
+        "query": {
+          "type": "object",
+          "maxProperties": 64,
+          "patternProperties": {
+            "^[^\\u0000-\\u001f]{1,256}$": {
+              "$ref": "#/$defs/scalar"
+            }
+          },
+          "additionalProperties": false
+        },
+        "json": {
+          "description": "JSON request body; string leaves may reference ${name}."
+        },
+        "expect_status": {
+          "type": "integer",
+          "minimum": 100,
+          "maximum": 599
+        },
+        "assertions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/$defs/apiAssertion"
+          }
+        },
+        "extract": {
+          "type": "object",
+          "maxProperties": 64,
+          "additionalProperties": false,
+          "patternProperties": {
+            "^[A-Za-z_][A-Za-z0-9_]{0,63}$": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "pointer"
+              ],
+              "properties": {
+                "pointer": {
+                  "$ref": "#/$defs/jsonPointer"
+                },
+                "sensitive": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        },
+        "retry": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "max_attempts",
+            "on"
+          ],
+          "description": "Only transport failures may be retried; POST/PATCH additionally require idempotent=true.",
+          "properties": {
+            "max_attempts": {
+              "type": "integer",
+              "minimum": 2,
+              "maximum": 5
+            },
+            "on": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "enum": [
+                  "connection_error",
+                  "timeout",
+                  "rate_limited"
+                ]
+              }
+            }
+          }
+        },
+        "idempotent": {
+          "type": "boolean"
+        }
+      }
+    },
+    "uiGoto": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "url"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "goto"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "url": {
+          "$ref": "#/$defs/text"
+        }
+      },
+      "description": "Navigate; a url starting with '/' resolves against the profile base_url."
+    },
+    "uiClick": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "click"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        }
+      }
+    },
+    "uiFill": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target",
+        "value"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "fill"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        },
+        "value": {
+          "type": "string",
+          "maxLength": 4096
+        }
+      }
+    },
+    "uiSelect": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target",
+        "value"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "select"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        },
+        "value": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/text"
+            },
+            {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "$ref": "#/$defs/text"
+              }
+            }
+          ]
+        }
+      }
+    },
+    "uiCheck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "check"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        }
+      }
+    },
+    "uiUncheck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "uncheck"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        }
+      }
+    },
+    "uiWaitFor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target",
+        "state"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "wait_for"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        },
+        "state": {
+          "enum": [
+            "visible",
+            "hidden",
+            "attached",
+            "detached"
+          ]
+        }
+      },
+      "description": "Condition wait only; fixed sleeps are not expressible."
+    },
+    "uiAssertVisible": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "assert_visible"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        }
+      }
+    },
+    "uiAssertText": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "target",
+        "match",
+        "expected"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "assert_text"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        },
+        "match": {
+          "$ref": "#/$defs/match"
+        },
+        "expected": {
+          "$ref": "#/$defs/text"
+        },
+        "normalize_whitespace": {
+          "type": "boolean"
+        },
+        "case_sensitive": {
+          "type": "boolean"
+        }
+      },
+      "description": "normalize_whitespace defaults to true, case_sensitive defaults to true."
+    },
+    "uiAssertUrl": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action",
+        "match",
+        "expected"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "assert_url"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "match": {
+          "$ref": "#/$defs/match"
+        },
+        "expected": {
+          "$ref": "#/$defs/text"
+        }
+      }
+    },
+    "uiScreenshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "driver",
+        "action"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/stepId"
+        },
+        "driver": {
+          "const": "ui"
+        },
+        "action": {
+          "const": "screenshot"
+        },
+        "covers": {
+          "$ref": "#/$defs/covers"
+        },
+        "timeout_ms": {
+          "$ref": "#/$defs/timeoutMs"
+        },
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_-]{1,64}$"
+        },
+        "full_page": {
+          "type": "boolean"
+        }
+      }
+    },
+    "step": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/uiGoto"
+        },
+        {
+          "$ref": "#/$defs/uiClick"
+        },
+        {
+          "$ref": "#/$defs/uiFill"
+        },
+        {
+          "$ref": "#/$defs/uiSelect"
+        },
+        {
+          "$ref": "#/$defs/uiCheck"
+        },
+        {
+          "$ref": "#/$defs/uiUncheck"
+        },
+        {
+          "$ref": "#/$defs/uiWaitFor"
+        },
+        {
+          "$ref": "#/$defs/uiAssertVisible"
+        },
+        {
+          "$ref": "#/$defs/uiAssertText"
+        },
+        {
+          "$ref": "#/$defs/uiAssertUrl"
+        },
+        {
+          "$ref": "#/$defs/uiScreenshot"
+        },
+        {
+          "$ref": "#/$defs/apiStep"
+        }
+      ]
+    },
+    "variable": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "value"
+          ],
+          "properties": {
+            "value": {
+              "$ref": "#/$defs/scalar"
+            },
+            "sensitive": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "secret"
+          ],
+          "description": "Resolved at run time from the environment profile secret_env key; always sensitive.",
+          "properties": {
+            "secret": {
+              "type": "string",
+              "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$"
+            }
+          }
+        }
+      ]
+    }
+  }
+}