@wevion/cli 1.0.3881 → 1.0.3892

package/openapi.json

@@ -31005,6 +31005,9 @@
                         "is_internal": {
                           "type": "boolean"
                         },
+                        "marketing_excluded": {
+                          "type": "boolean"
+                        },
                         "cohort_exclusion_reasons": {
                           "type": "array",
                           "items": {
@@ -32081,6 +32084,9 @@
                         "is_internal": {
                           "type": "boolean"
                         },
+                        "marketing_excluded": {
+                          "type": "boolean"
+                        },
                         "cohort_exclusion_reasons": {
                           "type": "array",
                           "items": {
@@ -33000,6 +33006,9 @@
                         "is_internal": {
                           "type": "boolean"
                         },
+                        "marketing_excluded": {
+                          "type": "boolean"
+                        },
                         "cohort_exclusion_reasons": {
                           "type": "array",
                           "items": {
@@ -252029,12 +252038,34 @@
                                     "click_query": {
                                       "type": "integer"
                                     },
+                                    "ctr_sito_bp": {
+                                      "description": "Site CTR of the latest day Google measured, in basis points. Null = not measured; absent in v1.",
+                                      "anyOf": [
+                                        {
+                                          "type": "integer"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ]
+                                    },
                                     "impression_query": {
                                       "type": "integer"
                                     },
                                     "pagine_nominate": {
                                       "type": "integer"
                                     },
+                                    "posizione_sito_centesimi": {
+                                      "description": "Site average position of the latest day Google measured, in hundredths. Null = not measured; absent in v1.",
+                                      "anyOf": [
+                                        {
+                                          "type": "integer"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ]
+                                    },
                                     "query_nominate": {
                                       "type": "integer"
                                     },
@@ -252438,12 +252469,34 @@
                                     "click_query": {
                                       "type": "integer"
                                     },
+                                    "ctr_sito_bp": {
+                                      "description": "Site CTR of the latest day Google measured, in basis points. Null = not measured; absent in v1.",
+                                      "anyOf": [
+                                        {
+                                          "type": "integer"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ]
+                                    },
                                     "impression_query": {
                                       "type": "integer"
                                     },
                                     "pagine_nominate": {
                                       "type": "integer"
                                     },
+                                    "posizione_sito_centesimi": {
+                                      "description": "Site average position of the latest day Google measured, in hundredths. Null = not measured; absent in v1.",
+                                      "anyOf": [
+                                        {
+                                          "type": "integer"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ]
+                                    },
                                     "query_nominate": {
                                       "type": "integer"
                                     },
@@ -253463,7 +253516,8 @@
                     "copertura",
                     "finestra",
                     "pagine_in_calo",
-                    "query"
+                    "query",
+                    "trend"
                   ],
                   "properties": {
                     "copertura": {
@@ -253638,6 +253692,7 @@
                             "type": "object",
                             "required": [
                               "clicks",
+                              "ctr_ultima",
                               "impressions",
                               "posizione_settimana",
                               "posizione_ultima",
@@ -253648,11 +253703,22 @@
                               "clicks": {
                                 "type": "integer"
                               },
+                              "ctr_ultima": {
+                                "description": "Google's `ctr` (fraction 0-1) for the SAME week as `posizione_ultima` — NOT an average of the window and NOT derived from clicks/impressions: CTR does not average.",
+                                "anyOf": [
+                                  {
+                                    "type": "number"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
                               "impressions": {
                                 "type": "integer"
                               },
                               "posizione_settimana": {
-                                "description": "The week `posizione_ultima` was measured on. A position without its period is not a datum.",
+                                "description": "The week `posizione_ultima` and `ctr_ultima` were measured on. A metric without its period is not a datum.",
                                 "type": "string"
                               },
                               "posizione_ultima": {
@@ -253681,6 +253747,62 @@
                           "type": "boolean"
                         }
                       }
+                    },
+                    "trend": {
+                      "description": "The site weekly trend over the same window: clicks/impressions summed per week, position/CTR from the named day (never an average). One row per week, oldest first.",
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "type": "object",
+                        "required": [
+                          "clicks",
+                          "ctr",
+                          "giorno_nominato",
+                          "impressions",
+                          "posizione",
+                          "settimana"
+                        ],
+                        "properties": {
+                          "clicks": {
+                            "description": "Sum of the site daily clicks in this week.",
+                            "type": "integer"
+                          },
+                          "ctr": {
+                            "description": "Google's site `ctr` (fraction 0-1) for `giorno_nominato` — NOT an average of the week's days and NOT clicks/impressions.",
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "giorno_nominato": {
+                            "description": "The most recent day of the week that carries `posizione`/`ctr`. A metric without its period is not a datum.",
+                            "type": "string"
+                          },
+                          "impressions": {
+                            "description": "Sum of the site daily impressions in this week.",
+                            "type": "integer"
+                          },
+                          "posizione": {
+                            "description": "Google's site `avg_position` for `giorno_nominato` — the named day's value, never an average.",
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "settimana": {
+                            "description": "The Monday (ISO) of the week.",
+                            "type": "string"
+                          }
+                        }
+                      }
                     }
                   }
                 }
@@ -270310,6 +270432,289 @@
         }
       }
     },
+    "/api/v1/seo/sites/{siteId}/interventions/{interventionId}/withdraw": {
+      "post": {
+        "operationId": "withdrawSeoIntervention",
+        "summary": "Withdraw a published intervention (R-I2)",
+        "tags": [
+          "seo"
+        ],
+        "description": "R-I2 — moves a `published` intervention to the terminal state `rolled_back`, the writer that was missing while the state was read in six places and written in zero. It keeps `published_url`/`published_at` so the timeline can say «it was published there, then withdrawn». Only a `published` intervention can be withdrawn; a second call, an absent one, or another team's finds nothing (404), which is also the idempotency. ⚠️ This does NOT remove the page from the customer site: the automated CMS rollback is L7 and has no write adapter yet, and for a manually-exported page the site is the customer's — the withdrawal in our records must be paired with an instruction to take it down, a surface downstream of this writer.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "properties": {
+                  "motivo": {
+                    "description": "Why the intervention is being withdrawn. Recorded in the log for the audit trail; optional.",
+                    "maxLength": 500,
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "interventionId",
+            "required": true,
+            "description": "The intervention whose history is read."
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "siteId",
+            "required": true,
+            "description": "The SEO site the intervention must belong to."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "esito",
+                    "ritirato_il",
+                    "stato"
+                  ],
+                  "properties": {
+                    "esito": {
+                      "type": "string",
+                      "enum": [
+                        "ritirato"
+                      ]
+                    },
+                    "ritirato_il": {
+                      "format": "date-time",
+                      "type": "string"
+                    },
+                    "stato": {
+                      "description": "The intervention state after the withdrawal: terminal.",
+                      "type": "string",
+                      "enum": [
+                        "rolled_back"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "The request was rejected before it read anything (schema, or an unresolvable scope).",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "The request was rejected before it read anything (schema, or an unresolvable scope).",
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "description": "The request was refused; `code` says why.",
+                      "type": "object",
+                      "required": [
+                        "error",
+                        "code"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "description": "The request was refused by the framework layer (schema validation or role floor).",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "The caller may not read this intervention: the role floor, or another workspace.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "The caller may not read this intervention: the role floor, or another workspace.",
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "description": "The request was refused; `code` says why.",
+                      "type": "object",
+                      "required": [
+                        "error",
+                        "code"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "description": "The request was refused by the framework layer (schema validation or role floor).",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "The request was refused; `code` says why.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The request was refused; `code` says why.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "The request was refused; `code` says why.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The request was refused; `code` says why.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "The request was refused; `code` says why.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The request was refused; `code` says why.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/seo/sites/{siteId}/onboarding": {
       "get": {
         "operationId": "getSeoOnboarding",
@@ -270347,6 +270752,7 @@
                   "required": [
                     "passi",
                     "passo_corrente",
+                    "piano_bloccato_da",
                     "piano_puo_partire",
                     "profilo",
                     "regime_confermato",
@@ -270513,8 +270919,28 @@
                         }
                       ]
                     },
+                    "piano_bloccato_da": {
+                      "description": "Why the plan cannot start, when it cannot; null when it can. `settore_escluso` is surfaced HERE, in onboarding, not only downstream at generation (B8/R-I3): an excluded sector that completes the onboarding must not read that the plan can start. The downstream generation gates stay as defence in depth.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "passi_incompleti"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "settore_escluso"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "piano_puo_partire": {
-                      "description": "F14.4 — the plan does not start until the expectations tick is there. It is a prerequisite, not one of the four confirmations.",
+                      "description": "F14.4 — the plan starts only when all six steps are done AND the confirmed regime admits generation. An excluded sector keeps it false; `piano_bloccato_da` says which of the two is missing.",
                       "type": "boolean"
                     },
                     "profilo": {
@@ -271636,6 +272062,7 @@
                   "required": [
                     "passi",
                     "passo_corrente",
+                    "piano_bloccato_da",
                     "piano_puo_partire",
                     "profilo",
                     "regime_confermato",
@@ -271802,8 +272229,28 @@
                         }
                       ]
                     },
+                    "piano_bloccato_da": {
+                      "description": "Why the plan cannot start, when it cannot; null when it can. `settore_escluso` is surfaced HERE, in onboarding, not only downstream at generation (B8/R-I3): an excluded sector that completes the onboarding must not read that the plan can start. The downstream generation gates stay as defence in depth.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "passi_incompleti"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "settore_escluso"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "piano_puo_partire": {
-                      "description": "F14.4 — the plan does not start until the expectations tick is there. It is a prerequisite, not one of the four confirmations.",
+                      "description": "F14.4 — the plan starts only when all six steps are done AND the confirmed regime admits generation. An excluded sector keeps it false; `piano_bloccato_da` says which of the two is missing.",
                       "type": "boolean"
                     },
                     "profilo": {
@@ -272792,6 +273239,7 @@
                   "required": [
                     "passi",
                     "passo_corrente",
+                    "piano_bloccato_da",
                     "piano_puo_partire",
                     "profilo",
                     "regime_confermato",
@@ -272958,8 +273406,28 @@
                         }
                       ]
                     },
+                    "piano_bloccato_da": {
+                      "description": "Why the plan cannot start, when it cannot; null when it can. `settore_escluso` is surfaced HERE, in onboarding, not only downstream at generation (B8/R-I3): an excluded sector that completes the onboarding must not read that the plan can start. The downstream generation gates stay as defence in depth.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "passi_incompleti"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "settore_escluso"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "piano_puo_partire": {
-                      "description": "F14.4 — the plan does not start until the expectations tick is there. It is a prerequisite, not one of the four confirmations.",
+                      "description": "F14.4 — the plan starts only when all six steps are done AND the confirmed regime admits generation. An excluded sector keeps it false; `piano_bloccato_da` says which of the two is missing.",
                       "type": "boolean"
                     },
                     "profilo": {
@@ -276402,6 +276870,7 @@
                           "gate",
                           "in_coda_da",
                           "page_type",
+                          "revisione",
                           "sempre_da_guardare",
                           "target_ref",
                           "version_number",
@@ -276731,6 +277200,33 @@
                               }
                             ]
                           },
+                          "revisione": {
+                            "description": "The human-review reason: the mechanical findings with which the quality cycle ran out of retries (C4.9) and delivered the piece anyway. `null` for a piece that passed clean. It is the WHY the approver needs before asking for a change.",
+                            "anyOf": [
+                              {
+                                "type": "null"
+                              },
+                              {
+                                "additionalProperties": false,
+                                "type": "object",
+                                "required": [
+                                  "iterazioni",
+                                  "rilievi"
+                                ],
+                                "properties": {
+                                  "iterazioni": {
+                                    "type": "integer"
+                                  },
+                                  "rilievi": {
+                                    "type": "array",
+                                    "items": {
+                                      "type": "string"
+                                    }
+                                  }
+                                }
+                              }
+                            ]
+                          },
                           "sempre_da_guardare": {
                             "description": "This row is in the sample whatever its size: its review can never be relaxed.",
                             "type": "boolean"
@@ -278308,6 +278804,12 @@
                                                         "enum": [
                                                           "query_nominate_da_google"
                                                         ]
+                                                      },
+                                                      {
+                                                        "type": "string",
+                                                        "enum": [
+                                                          "giorno_nominato_da_google"
+                                                        ]
                                                       }
                                                     ]
                                                   },
@@ -278382,6 +278884,7 @@
                                           "required": [
                                             "attesa",
                                             "confronto",
+                                            "formato",
                                             "metrica",
                                             "natura",
                                             "numero"
@@ -278481,6 +278984,29 @@
                                                 }
                                               ]
                                             },
+                                            "formato": {
+                                              "description": "How the number reads: plain count, CTR in basis points, or a decimal rank position.",
+                                              "anyOf": [
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "numero"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "percentuale_bp"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "posizione"
+                                                  ]
+                                                }
+                                              ]
+                                            },
                                             "metrica": {
                                               "description": "Closed vocabulary: every metric has a source in the module.",
                                               "anyOf": [
@@ -278549,6 +279075,18 @@
                                                   "enum": [
                                                     "click"
                                                   ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "posizione_media_sito"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "ctr_sito"
+                                                  ]
                                                 }
                                               ]
                                             },
@@ -278607,6 +279145,12 @@
                                                           "enum": [
                                                             "query_nominate_da_google"
                                                           ]
+                                                        },
+                                                        {
+                                                          "type": "string",
+                                                          "enum": [
+                                                            "giorno_nominato_da_google"
+                                                          ]
                                                         }
                                                       ]
                                                     },
@@ -278722,6 +279266,7 @@
                                           "required": [
                                             "attesa",
                                             "confronto",
+                                            "formato",
                                             "metrica",
                                             "natura",
                                             "numero"
@@ -278821,6 +279366,29 @@
                                                 }
                                               ]
                                             },
+                                            "formato": {
+                                              "description": "How the number reads: plain count, CTR in basis points, or a decimal rank position.",
+                                              "anyOf": [
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "numero"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "percentuale_bp"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "posizione"
+                                                  ]
+                                                }
+                                              ]
+                                            },
                                             "metrica": {
                                               "description": "Closed vocabulary: every metric has a source in the module.",
                                               "anyOf": [
@@ -278889,6 +279457,18 @@
                                                   "enum": [
                                                     "click"
                                                   ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "posizione_media_sito"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "ctr_sito"
+                                                  ]
                                                 }
                                               ]
                                             },
@@ -278947,6 +279527,12 @@
                                                           "enum": [
                                                             "query_nominate_da_google"
                                                           ]
+                                                        },
+                                                        {
+                                                          "type": "string",
+                                                          "enum": [
+                                                            "giorno_nominato_da_google"
+                                                          ]
                                                         }
                                                       ]
                                                     },
@@ -285110,12 +285696,30 @@
                   "additionalProperties": false,
                   "type": "object",
                   "required": [
+                    "fila_ordinamento",
                     "righe",
                     "troncato"
                   ],
                   "properties": {
+                    "fila_ordinamento": {
+                      "description": "How the queue is ordered: `qualita_first` (default) puts the arbiter-estimated impact (`priorita`) first, then market volume, then age — the best data-driven proposals lead the queue; `brief_first` is the historical order, market volume then age, which brings the brief keywords back to the front.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "qualita_first"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "brief_first"
+                          ]
+                        }
+                      ]
+                    },
                     "righe": {
-                      "description": "The queue in the REAL picking order: most searched first, oldest first among equals. The same order the dispatcher uses, so what the client reads as \"next\" is what the engine will take next.",
+                      "description": "The queue in the REAL picking order the option above selects. The same order the dispatcher uses, so what the client reads as \"next\" is what the engine will take next.",
                       "type": "array",
                       "items": {
                         "additionalProperties": false,
@@ -285124,9 +285728,14 @@
                           "created_at",
                           "fonte",
                           "id",
+                          "intento",
+                          "keyword_primaria",
+                          "keyword_secondarie",
                           "stato",
+                          "priorita",
                           "tema",
-                          "volume_ricerca"
+                          "volume_ricerca",
+                          "competizione_indice"
                         ],
                         "properties": {
                           "created_at": {
@@ -285160,6 +285769,61 @@
                             "format": "uuid",
                             "type": "string"
                           },
+                          "intento": {
+                            "description": "The search intent, or `null` when the topic has not been classified yet.",
+                            "anyOf": [
+                              {
+                                "description": "The search intent behind the topic, one of the four the industry labels: `commerciale`, `informativo`, `navigazionale`, `transazionale`. The same four the portfolio mix uses. `null` until it is classified.",
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "commerciale"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "informativo"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "navigazionale"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "transazionale"
+                                    ]
+                                  }
+                                ]
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "keyword_primaria": {
+                            "description": "The query the article targets. `null` only on old rows; for topics seeded today it equals `tema`, because a topic that declares no keyword targets its own theme.",
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "keyword_secondarie": {
+                            "description": "The secondary/related keywords to cover in the body. An empty array when there are none, never null.",
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
                           "stato": {
                             "description": "DERIVED, never stored: `in_fila` waits to be picked, `in_lavoro` is bound to a production slot, `coperto` has been written, `scartato` was dropped by the client. There is no `stato` column — the database refused one, and the reason is in the migration.",
                             "anyOf": [
@@ -285189,13 +285853,37 @@
                               }
                             ]
                           },
+                          "priorita": {
+                            "description": "The impact the arbiter estimated for this topic (expected clicks/month), SEPARATE from `volume_ricerca` (market volume). `null` for brief/manual topics and for proposals whose impact is not estimable: in `qualita_first` they queue NULLS LAST, ordered among themselves by volume.",
+                            "anyOf": [
+                              {
+                                "type": "integer"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
                           "tema": {
                             "type": "string"
                           },
                           "volume_ricerca": {
-                            "description": "Monthly search volume when we know it. Almost always `null` today: filling it means calling the Keyword Planner, which is a later unit. A topic with no volume is still workable — it just queues by age.",
+                            "description": "Monthly search volume when we know it. `null` until the SEO_TOPIC_ENRICH worker writes it from the Keyword Planner, or when the GOOGLE_ADS_* env is missing. A topic with no volume is still workable — it just queues by age.",
+                            "anyOf": [
+                              {
+                                "type": "integer"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "competizione_indice": {
+                            "description": "The Keyword Planner competition index 0-100 (0 = open field, 100 = most contested), ALONGSIDE `volume_ricerca` — a different dimension of a topic's value (difficulty, not market size). `null` until the SEO_TOPIC_ENRICH worker writes it, or when the GOOGLE_ADS_* env is missing.",
                             "anyOf": [
                               {
+                                "minimum": 0,
+                                "maximum": 100,
                                 "type": "integer"
                               },
                               {
@@ -285972,6 +286660,292 @@
         }
       }
     },
+    "/api/v1/seo/sites/{siteId}/topics/ordinamento": {
+      "patch": {
+        "operationId": "setSeoTopicQueueOrder",
+        "summary": "Choose how the topic queue is ordered",
+        "tags": [
+          "seo"
+        ],
+        "description": "Sets the per-site queue option: `qualita_first` (default) leads with the arbiter-estimated impact (`priorita`), then market volume, then age — the best data-driven proposals guide the queue; `brief_first` is the historical order (market volume, then age), which brings the brief keywords back to the front. The same option drives both what the client reads as \"next\" and what the dispatcher picks. Answers `SEO_SITE_NOT_FOUND` when the site is not in this workspace.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "fila_ordinamento"
+                ],
+                "properties": {
+                  "fila_ordinamento": {
+                    "description": "How the queue is ordered: `qualita_first` (default) puts the arbiter-estimated impact (`priorita`) first, then market volume, then age — the best data-driven proposals lead the queue; `brief_first` is the historical order, market volume then age, which brings the brief keywords back to the front.",
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "qualita_first"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "brief_first"
+                        ]
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "siteId",
+            "required": true,
+            "description": "The SEO site whose topic queue is read or changed."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "fila_ordinamento"
+                  ],
+                  "properties": {
+                    "fila_ordinamento": {
+                      "description": "How the queue is ordered: `qualita_first` (default) puts the arbiter-estimated impact (`priorita`) first, then market volume, then age — the best data-driven proposals lead the queue; `brief_first` is the historical order, market volume then age, which brings the brief keywords back to the front.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "qualita_first"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "brief_first"
+                          ]
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "The request was rejected before it changed anything (schema, or an unresolvable scope).",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "The request was rejected before it changed anything (schema, or an unresolvable scope).",
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "description": "The request was refused; `code` says why.",
+                      "type": "object",
+                      "required": [
+                        "error",
+                        "code"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "description": "The request was refused by the framework layer (schema validation or role floor).",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "The caller may not perform this operation: the role floor, or a site of another workspace.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "The caller may not perform this operation: the role floor, or a site of another workspace.",
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "description": "The request was refused; `code` says why.",
+                      "type": "object",
+                      "required": [
+                        "error",
+                        "code"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "description": "The request was refused by the framework layer (schema validation or role floor).",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "The request was refused; `code` says why.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The request was refused; `code` says why.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "The request was refused; `code` says why.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The request was refused; `code` says why.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "The request was refused; `code` says why.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The request was refused; `code` says why.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "Stable machine-readable reason. `FEATURE_DISABLED` on 503.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/business-users": {
       "get": {
         "operationId": "getApiV1BusinessUsers",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wevion/cli",
-  "version": "1.0.3881",
+  "version": "1.0.3892",
   "description": "Wevion API command-line interface — generated from the public OpenAPI spec",
   "type": "module",
   "bin": {